powerlines 0.23.2 → 0.23.4

package/dist/lib/{config-BoGlIhnH.d.cts → config-DTSdCZsw.d.cts}

@@ -19,891 +19,912 @@ import { PackageJson } from '@stryke/types/package-json';
 import { Worker } from 'jest-worker';
 import { Jiti } from 'jiti';
 import MagicString, { SourceMap } from 'magic-string';
-import { ParserOptions, ParseResult } from 'oxc-parser';
 import { Range } from 'semver';
 import { TransformResult as TransformResult$1, ExternalIdResult, HookFilter, UnpluginOptions, UnpluginContext, UnpluginMessage, UnpluginBuildContext } from 'unplugin';
+import { PathLike, StatSyncOptions, Stats, RmDirOptions, RmOptions, Mode, MakeDirectoryOptions as MakeDirectoryOptions$1, PathOrFileDescriptor, WriteFileOptions as WriteFileOptions$1 } from 'node:fs';
 import { ArrayValues } from '@stryke/types/array';
 import { P as ParsedTypeScriptConfig, T as TSConfig } from './tsconfig-Bz-CiFqD.cjs';
-import { PrimitiveJsonValue } from '@stryke/json/types';
-import { PathLike, StatSyncOptions, Stats, RmDirOptions, RmOptions, Mode, MakeDirectoryOptions as MakeDirectoryOptions$1, PathOrFileDescriptor, WriteFileOptions as WriteFileOptions$1 } from 'node:fs';
 
-type UnpluginBuildVariant = "rollup" | "webpack" | "rspack" | "vite" | "esbuild" | "farm" | "unloader" | "rolldown";
-type BuildVariant = UnpluginBuildVariant | "tsup" | "unbuild";
-type InferUnpluginVariant<TBuildVariant extends BuildVariant> = TBuildVariant extends "tsup" ? "esbuild" : TBuildVariant extends "unbuild" ? "rollup" : TBuildVariant;
-interface BuildConfig {
+declare const __VFS_PATCH__ = "__VFS_PATCH__";
+declare const __VFS_REVERT__ = "__VFS_REVERT__";
+type OutputModeType = "fs" | "virtual";
+interface VirtualFileMetadata {
     /**
-     * The platform to build the project for
-     *
-     * @defaultValue "neutral"
+     * The identifier for the file data.
      */
-    platform?: "node" | "browser" | "neutral";
+    id: string;
     /**
-     * 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']
-     * }
-     * ```
+     * The timestamp of the virtual file.
      */
-    polyfill?: string[];
+    timestamp: number;
     /**
-     * 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.
+     * The type of the file.
      *
-     * @defaultValue `['browser', 'module', 'jsnext:main', 'jsnext']`
-     */
-    mainFields?: string[];
-    /**
-     * Array of strings indicating what conditions should be used for module resolution.
+     * @remarks
+     * This string represents the purpose/function of the file in the virtual file system. A potential list of variants includes:
+     * - `builtin`: Indicates that the file is a built-in module provided by the system.
+     * - `entry`: Indicates that the file is an entry point for execution.
+     * - `normal`: Indicates that the file is a standard file without any special role.
      */
-    conditions?: string[];
+    type: string;
     /**
-     * Array of strings indicating what file extensions should be used for module resolution.
-     *
-     * @defaultValue `['.mjs', '.js', '.mts', '.ts', '.jsx', '.tsx', '.json']`
+     * The output mode of the file.
      */
-    extensions?: string[];
+    mode: 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.
+     * Additional metadata associated with the file.
      */
-    dedupe?: string[];
+    properties: Record<string, string>;
+}
+interface VirtualFileData {
     /**
-     * Array of strings or regular expressions that indicate what modules are builtin for the environment.
+     * The identifier for the file data.
      */
-    builtins?: (string | RegExp)[];
+    id?: string;
     /**
-     * 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
+     * The contents of the virtual file.
      */
-    define?: Record<string, any>;
+    code: string;
     /**
-     * Global variables that will have import statements injected where necessary
+     * The type of the file.
      *
      * @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
+     * This string represents the purpose/function of the file in the virtual file system. A potential list of variants includes:
+     * - `builtin`: Indicates that the file is a built-in module provided by the system.
+     * - `entry`: Indicates that the file is an entry point for execution.
+     * - `chunk`: Indicates that the file is a code chunk, typically used in code-splitting scenarios.
+     * - `prebuilt-chunk`: Indicates that the file is a prebuilt code chunk.
+     * - `asset`: Indicates that the file is a static asset, such as an image or stylesheet.
+     * - `normal`: Indicates that the file is a standard file without any special role.
      */
-    inject?: Record<string, string | string[]>;
+    type?: string;
     /**
-     * The alias mappings to use for module resolution during the build process.
-     *
-     * @remarks
-     * This option allows you to define custom path aliases for modules, which can be useful for simplifying imports and managing dependencies.
-     *
-     * @example
-     * ```ts
-     * {
-     *   alias: {
-     *     "@utils": "./src/utils",
-     *     "@components": "./src/components"
-     *   }
-     * }
-     * ```
-     *
-     * @see https://github.com/rollup/plugins/tree/master/packages/alias
+     * The output mode of the file.
      */
-    alias?: Record<string, string> | Array<{
-        find: string | RegExp;
-        replacement: string;
-    }>;
+    mode?: string;
     /**
-     * A list of modules that should not be bundled, even if they are external dependencies.
-     *
-     * @remarks
-     * This option is useful for excluding specific modules from the bundle, such as Node.js built-in modules or other libraries that should not be bundled.
+     * Additional metadata associated with the file.
      */
-    external?: (string | RegExp)[];
+    properties?: Record<string, string>;
+}
+interface VirtualFile extends Required<VirtualFileData>, VirtualFileMetadata {
     /**
-     * A list of modules that should always be bundled, even if they are external dependencies.
+     * An additional name for the file.
      */
-    noExternal?: (string | RegExp)[];
+    path: string;
     /**
-     * Should the Powerlines CLI processes skip bundling the `node_modules` directory?
+     * The timestamp of the virtual file.
      */
-    skipNodeModulesBundle?: boolean;
+    timestamp: number;
+}
+interface ResolveFSOptions {
+    mode?: OutputModeType;
+}
+type MakeDirectoryOptions = (Mode | MakeDirectoryOptions$1) & ResolveFSOptions;
+interface PowerlinesWriteFileOptions extends ResolveFSOptions {
     /**
-     * An optional set of override options to apply to the selected build variant.
+     * Should the file skip formatting before being written?
      *
-     * @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.
+     * @defaultValue false
      */
-    override?: Record<string, any>;
+    skipFormat?: boolean;
 }
-type BuildResolvedConfig = Omit<BuildConfig, "override">;
-type ESBuildBuildConfig = Omit<BuildOptions, "entryPoints" | "sourceRoot" | "platform" | "outdir" | "env" | "assets" | "external" | "inject" | "tsconfig" | "tsconfigRaw" | "logLevel"> & BuildConfig;
-type ESBuildResolvedBuildConfig = Omit<BuildOptions, "inject"> & BuildResolvedConfig;
-type ViteBuildConfig = Omit<UserConfig$1, "entry" | "entryPoints" | "tsconfig" | "tsconfigRaw" | "environments" | "output"> & BuildConfig;
-type ViteResolvedBuildConfig = UserConfig$1 & BuildResolvedConfig;
-type WebpackBuildConfig = Omit<Configuration, "name" | "entry" | "entryPoints" | "tsconfig" | "tsconfigRaw"> & BuildConfig;
-type WebpackResolvedBuildConfig = Configuration & BuildResolvedConfig;
-type RspackBuildConfig = Omit<Configuration$1, "name" | "entry" | "entryPoints" | "tsconfig" | "tsconfigRaw"> & BuildConfig;
-type RspackResolvedBuildConfig = Configuration$1 & BuildResolvedConfig;
-type RollupBuildOutputConfig = Omit<OutputOptions, "dir" | "format">;
-type RollupBuildConfig = Omit<RollupOptions, "entry" | "external" | "input" | "output" | "logLevel"> & {
-    output: RollupBuildOutputConfig | RollupBuildOutputConfig[];
-} & BuildConfig;
-type RollupResolvedBuildConfig = RollupOptions & BuildResolvedConfig;
-type RolldownBuildOutputConfig = Omit<RolldownOutput, "dir" | "format">;
-type RolldownBuildConfig = Omit<RolldownOptions, "input" | "external" | "tsconfig" | "logLevel" | "output"> & {
-    output: RolldownBuildOutputConfig | RolldownBuildOutputConfig[];
-} & BuildConfig;
-type RolldownResolvedBuildConfig = RolldownOptions & BuildResolvedConfig;
-type TsupBuildConfig = Partial<Omit<BuildOptions$1, "userOptions" | "tsconfig" | "tsconfigRaw" | "assets" | "outputPath" | "mode" | "format" | "platform" | "projectRoot" | "env" | "entry" | "entryPoints" | "external" | "noExternal" | "skipNodeModulesBundle">> & BuildConfig;
-type TsupResolvedBuildConfig = BuildOptions$1 & BuildResolvedConfig;
-type UnbuildBuildConfig = Partial<Omit<UnbuildOptions, "tsconfig" | "tsconfigRaw" | "assets" | "outputPath" | "mode" | "format" | "platform" | "projectRoot" | "env" | "entry" | "entryPoints">> & BuildConfig;
-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;
-
-declare const SUPPORTED_COMMANDS: readonly ["new", "clean", "prepare", "lint", "test", "build", "docs", "deploy", "finalize"];
-type CommandType = ArrayValues<typeof SUPPORTED_COMMANDS>;
-
-interface ResolvedEntryTypeDefinition extends TypeDefinition {
+type NodeWriteFileOptions = WriteFileOptions$1;
+type WriteFileOptions = NodeWriteFileOptions | PowerlinesWriteFileOptions;
+type WriteFileData = string | NodeJS.ArrayBufferView | VirtualFileData;
+interface ResolvePathOptions extends ResolveFSOptions {
     /**
-     * The user provided entry point in the source code
+     * Should the resolved path include the file extension?
+     *
+     * @defaultValue true
      */
-    input: TypeDefinition;
+    withExtension?: boolean;
     /**
-     * An optional name to use in the package export during the build process
+     * The paths to search for the file.
      */
-    output?: string;
-}
-type EnvironmentResolvedConfig = Omit<EnvironmentConfig, "consumer" | "mode" | "ssr" | "preview"> & Required<Pick<EnvironmentConfig, "consumer" | "mode" | "ssr">> & {
+    paths?: string[];
     /**
-     * The name of the environment
+     * The type of the path to resolve.
      */
-    name: string;
+    pathType?: "file" | "directory";
+}
+interface VirtualFileSystemInterface {
     /**
-     * Configuration options for the preview server
+     * Patches the File System to include the virtual file system (VFS) contents.
      */
-    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" | "test" | "build" | "transform" | "deploy" | "variant" | "type" | "output" | "logLevel" | "framework"> & Required<Pick<TUserConfig, "name" | "title" | "plugins" | "mode" | "environments" | "tsconfig" | "lint" | "test" | "build" | "transform" | "deploy" | "framework">> & {
+    [__VFS_PATCH__]: () => void;
     /**
-     * The configuration options that were provided inline to the Powerlines CLI.
+     * Reverts the virtual file system (VFS) to its previous state.
      */
-    inlineConfig: InlineConfig<TUserConfig>;
+    [__VFS_REVERT__]: () => void;
     /**
-     * The original configuration options that were provided by the user to the Powerlines process.
+     * The underlying file metadata.
      */
-    userConfig: TUserConfig;
+    metadata: Record<string, VirtualFileMetadata | undefined>;
     /**
-     * A string identifier for the Powerlines command being executed.
+     * A map of module ids to their file paths.
      */
-    command: NonUndefined<InlineConfig<TUserConfig>["command"]>;
+    ids: Record<string, string>;
     /**
-     * The root directory of the project's source code
+     * Check if a path or id corresponds to a virtual file **(does not actually exists on disk)**.
      *
-     * @defaultValue "\{projectRoot\}/src"
+     * @param pathOrId - The path or id to check.
+     * @param options - Optional parameters for resolving the path.
+     * @returns Whether the path or id corresponds to a virtual file **(does not actually exists on disk)**.
      */
-    sourceRoot: NonUndefined<TUserConfig["sourceRoot"]>;
+    isVirtual: (pathOrId: string, options?: ResolvePathOptions) => boolean;
     /**
-     * The root directory of the project.
+     * Check if a path or id corresponds to a file written to the file system **(actually exists on disk)**.
+     *
+     * @param pathOrId - The path or id to check.
+     * @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)**.
      */
-    projectRoot: NonUndefined<TUserConfig["root"]>;
+    isPhysical: (pathOrId: string, options?: ResolvePathOptions) => boolean;
     /**
-     * The type of project being built.
+     * Checks if a file exists in the virtual file system (VFS).
+     *
+     * @param path - The path of the file to check.
+     * @returns `true` if the file exists, otherwise `false`.
      */
-    projectType: NonUndefined<TUserConfig["type"]>;
+    isFile: (path: string) => boolean;
     /**
-     * The output configuration options to use for the build process
+     * Checks if a directory exists in the virtual file system (VFS).
+     *
+     * @param path - The path of the directory to check.
+     * @returns `true` if the directory exists, otherwise `false`.
      */
-    output: OutputResolvedConfig;
+    isDirectory: (path: string) => boolean;
     /**
-     * Configuration provided to build processes
+     * Checks if a file exists in the virtual file system (VFS).
      *
-     * @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}.
+     * @param pathOrId - The path or id of the file.
+     * @returns `true` if the file exists, otherwise `false`.
      */
-    build: Omit<TUserConfig["build"], "override"> & Required<Pick<Required<TUserConfig["build"]>, "override">>;
+    existsSync: (pathOrId: string) => boolean;
     /**
-     * The log level to use for the Powerlines processes.
+     * Gets the metadata of a file in the virtual file system (VFS).
      *
-     * @defaultValue "info"
+     * @param pathOrId - The path or id of the file.
+     * @returns The metadata of the file if it exists, otherwise undefined.
      */
-    logLevel: "error" | "warn" | "info" | "debug" | "trace" | 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;
-
-interface PluginHookObject<THookFunction extends FunctionLike, TFilter extends keyof HookFilter = never> {
+    getMetadata: (pathOrId: PathLike) => VirtualFileMetadata | undefined;
     /**
-     * The order in which the plugin should be applied.
+     * Gets the stats of a file in the virtual file system (VFS).
+     *
+     * @param pathOrId - The path or id of the file.
+     * @param options - Optional parameters for getting the stats.
+     * @returns The stats of the file if it exists, otherwise undefined.
      */
-    order?: "pre" | "post" | null | undefined;
+    lstat: (pathOrId: string, options?: StatSyncOptions & {
+        bigint?: false | undefined;
+        throwIfNoEntry: false;
+    }) => Promise<Stats>;
     /**
-     * A filter to determine when the hook should be called.
+     * Gets the stats of a file in the virtual file system (VFS).
+     *
+     * @param pathOrId - The path or id of the file.
+     * @param options - Optional parameters for getting the stats.
+     * @returns The stats of the file if it exists, otherwise undefined.
      */
-    filter?: Pick<HookFilter, TFilter>;
+    lstatSync: (pathOrId: string, options?: StatSyncOptions & {
+        bigint?: false | undefined;
+        throwIfNoEntry: false;
+    }) => Stats | undefined;
     /**
-     * The hook function to be called.
+     * Gets the stats of a file in the virtual file system (VFS).
+     *
+     * @param pathOrId - The path or id of the file.
+     * @returns The stats of the file if it exists, otherwise false.
      */
-    handler: THookFunction;
-}
-type PluginHook<THookFunction extends FunctionLike, TFilter extends keyof HookFilter = never> = THookFunction | PluginHookObject<THookFunction, TFilter>;
-/**
- * A result returned by the plugin from the `generateTypes` hook that describes the declaration types output file.
- */
-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>> {
+    stat: (pathOrId: string, options?: StatSyncOptions & {
+        bigint?: false | undefined;
+        throwIfNoEntry: false;
+    }) => Promise<Stats>;
     /**
-     * A function that returns configuration options to be merged with the build context's options.
-     *
-     * @remarks
-     * Modify config before it's resolved. The hook can either mutate {@link Context.config} on the passed-in context directly, or return a partial config object that will be deeply merged into existing config.
-     *
-     * @warning User plugins are resolved before running this hook so injecting other plugins inside the config hook will have no effect. If you want to add plugins, consider doing so in the {@link Plugin.dependsOn} property instead.
-     *
-     * @see https://vitejs.dev/guide/api-plugin#config
+     * Gets the stats of a file in the virtual file system (VFS).
      *
-     * @param this - The build context.
-     * @param config - The partial configuration object to be modified.
-     * @returns A promise that resolves to a partial configuration object.
+     * @param pathOrId - The path or id of the file.
+     * @returns The stats of the file if it exists, otherwise false.
      */
-    config: (this: UnresolvedContext<TContext["config"]>) => MaybePromise<ConfigResult<TContext>>;
+    statSync: (pathOrId: string, options?: StatSyncOptions & {
+        bigint?: false | undefined;
+        throwIfNoEntry: false;
+    }) => Stats | undefined;
     /**
-     * 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.
-     *
-     * @remarks
-     * This hook is called for each environment with a partially resolved environment config that already accounts for the default environment config values set at the root level. If plugins need to modify the config of a given environment, they should do it in this hook instead of the config hook. Leaving the config hook only for modifying the root default environment config.
-     *
-     * @see https://vitejs.dev/guide/api-plugin#configenvironment
+     * Lists files in a given path.
      *
-     * @param this - The build context.
-     * @param name - The name of the environment being configured.
-     * @param environment - The Vite-like environment object containing information about the current build environment.
-     * @returns A promise that resolves when the hook is complete.
+     * @param path - The path to list files from.
+     * @param options - Options for listing files, such as encoding and recursion.
+     * @returns An array of file names in the specified path.
      */
-    configEnvironment: (this: TContext, name: string, environment: EnvironmentConfig) => MaybePromise<Partial<EnvironmentResolvedConfig> | undefined | null>;
+    readdirSync: (path: string, options?: {
+        encoding: BufferEncoding | null;
+        withFileTypes?: false | undefined;
+        recursive?: boolean | undefined;
+    } | BufferEncoding) => string[];
     /**
-     * A hook that is called when the plugin is resolved.
-     *
-     * @see https://vitejs.dev/guide/api-plugin#configresolved
+     * Lists files in a given path.
      *
-     * @param this - The build context.
-     * @returns A promise that resolves when the hook is complete.
+     * @param path - The path to list files from.
+     * @param options - Options for listing files, such as encoding and recursion.
+     * @returns An array of file names in the specified path.
      */
-    configResolved: (this: TContext) => MaybePromise<void>;
+    readdir: (path: string, options?: {
+        encoding: BufferEncoding | null;
+        withFileTypes?: false | undefined;
+        recursive?: boolean | undefined;
+    } | BufferEncoding) => Promise<string[]>;
     /**
-     * A hook that is called to overwrite the generated declaration types file (.d.ts). The generated type definitions should describe the built-in modules/logic added during the `prepare` task.
+     * Removes a file or symbolic link in the virtual file system (VFS).
      *
-     * @param this - The build context.
-     * @param code - The source code to generate types for.
-     * @returns A promise that resolves when the hook is complete.
+     * @param path - The path to the file to remove.
+     * @returns A promise that resolves when the file is removed.
      */
-    generateTypes: (this: TContext, code: string) => MaybePromise<GenerateTypesResult | string | undefined | null>;
+    unlinkSync: (path: PathLike, options?: ResolveFSOptions) => void;
     /**
-     * A hook that is called at the start of the build process.
+     * Asynchronously removes a file or symbolic link in the virtual file system (VFS).
      *
-     * @param this - The build context and unplugin build context.
-     * @returns A promise that resolves when the hook is complete.
+     * @param path - The path to the file to remove.
+     * @returns A promise that resolves when the file is removed.
      */
-    buildStart: (this: BuildPluginContext<TContext["config"]> & TContext) => MaybePromise<void>;
+    unlink: (path: string, options?: ResolveFSOptions) => Promise<void>;
     /**
-     * A hook that is called at the end of the build process.
+     * Removes a directory in the virtual file system (VFS).
      *
-     * @param this - The build context and unplugin build context.
-     * @returns A promise that resolves when the hook is complete.
+     * @param path - The path to create the directory at.
+     * @param options - Options for creating the directory.
      */
-    buildEnd: (this: BuildPluginContext<TContext["config"]> & TContext) => MaybePromise<void>;
+    rmdirSync: (path: PathLike, options?: RmDirOptions & ResolveFSOptions) => any;
     /**
-     * A hook that is called to transform the source code.
+     * Removes a directory in the virtual file system (VFS).
      *
-     * @param this - The build context, unplugin build context, and unplugin context.
-     * @param code - The source code to transform.
-     * @param id - The identifier of the source code.
-     * @returns A promise that resolves when the hook is complete.
+     * @param path - The path to create the directory at.
+     * @param options - Options for creating the directory.
+     * @returns A promise that resolves to the path of the created directory, or undefined if the directory could not be created.
      */
-    transform: (this: BuildPluginContext<TContext["config"]> & TContext, code: string, id: string) => MaybePromise<TransformResult$1>;
+    rmdir: (path: PathLike, options?: RmDirOptions & ResolveFSOptions) => Promise<void>;
     /**
-     * A hook that is called to load the source code.
+     * Removes a file or directory in the virtual file system (VFS).
      *
-     * @param this - The build context, unplugin build context, and unplugin context.
-     * @param id - The identifier of the source code.
-     * @returns A promise that resolves when the hook is complete.
+     * @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.
      */
-    load: (this: BuildPluginContext<TContext["config"]> & TContext, id: string) => MaybePromise<TransformResult$1>;
+    rm: (path: PathLike, options?: RmOptions & ResolveFSOptions) => Promise<void>;
     /**
-     * A hook that is called to resolve the identifier of the source code.
+     * Synchronously removes a file or directory in the virtual file system (VFS).
      *
-     * @param this - The build context, unplugin build context, and unplugin context.
-     * @param id - The identifier of the source code.
-     * @param importer - The importer of the source code.
-     * @param options - The options for resolving the identifier.
-     * @returns A promise that resolves when the hook is complete.
+     * @param path - The path to the file or directory to remove.
+     * @param options - Options for removing the file or directory.
      */
-    resolveId: (this: BuildPluginContext<TContext["config"]> & TContext, id: string, importer: string | undefined, options: {
-        isEntry: boolean;
-    }) => MaybePromise<string | ExternalIdResult | null | undefined>;
+    rmSync: (path: PathLike, options?: RmOptions & ResolveFSOptions) => void;
     /**
-     * A hook that is called to write the bundle to disk.
+     * Creates a directory in the virtual file system (VFS).
      *
-     * @param this - The build context.
-     * @returns A promise that resolves when the hook is complete.
+     * @param path - The path to create the directory at.
+     * @param options - Options for creating the directory.
+     * @returns A promise that resolves to the path of the created directory, or undefined if the directory could not be created.
      */
-    writeBundle: (this: TContext) => MaybePromise<void>;
-}
-type BuildPlugin<TContext extends PluginContext = PluginContext, TBuildVariant extends UnpluginBuildVariant = UnpluginBuildVariant, TOptions extends Required<UnpluginOptions>[TBuildVariant] = Required<UnpluginOptions>[TBuildVariant]> = {
-    [TKey in keyof TOptions]: TOptions[TKey] extends FunctionLike ? (this: ThisParameterType<TOptions[TKey]> & TContext, ...args: Parameters<TOptions[TKey]>) => ReturnType<TOptions[TKey]> | MaybePromise<ReturnType<TOptions[TKey]>> : TOptions[TKey];
-};
-type ExternalPluginHookFunctionsVariant<TContext extends PluginContext = PluginContext, TBuildVariant extends UnpluginBuildVariant = UnpluginBuildVariant> = {
-    [TKey in keyof BuildPlugin<TContext, TBuildVariant> & string as `${TBuildVariant}:${TKey}`]: BuildPlugin<TContext, TBuildVariant>[TKey];
-};
-type ExternalPluginHookFunctions<TContext extends PluginContext> = ExternalPluginHookFunctionsVariant<TContext, "vite"> & ExternalPluginHookFunctionsVariant<TContext, "esbuild"> & ExternalPluginHookFunctionsVariant<TContext, "rolldown"> & ExternalPluginHookFunctionsVariant<TContext, "rollup"> & ExternalPluginHookFunctionsVariant<TContext, "webpack"> & ExternalPluginHookFunctionsVariant<TContext, "rspack"> & ExternalPluginHookFunctionsVariant<TContext, "farm">;
-type PluginHookFunctions<TContext extends PluginContext = PluginContext> = BasePluginHookFunctions<TContext> & ExternalPluginHookFunctions<TContext>;
-type PluginHooks<TContext extends PluginContext = PluginContext> = {
-    [TKey in keyof BasePluginHookFunctions<TContext>]: PluginHook<BasePluginHookFunctions<TContext>[TKey]>;
-} & {
+    mkdirSync: (path: PathLike, options?: MakeDirectoryOptions) => string | undefined;
     /**
-     * A function that returns configuration options to be merged with the build context's options.
+     * Creates a directory in the virtual file system (VFS).
      *
-     * @remarks
-     * Modify config before it's resolved. The hook can either mutate {@link Context.config} on the passed-in context directly, or return a partial config object that will be deeply merged into existing config.
+     * @param path - The path to create the directory at.
+     * @param options - Options for creating the directory.
+     * @returns A promise that resolves to the path of the created directory, or undefined if the directory could not be created.
+     */
+    mkdir: (path: PathLike, options?: MakeDirectoryOptions) => Promise<string | undefined>;
+    /**
+     * Reads a file from the virtual file system (VFS).
      *
-     * @warning User plugins are resolved before running this hook so injecting other plugins inside the config hook will have no effect. If you want to add plugins, consider doing so in the {@link Plugin.dependsOn} property instead.
+     * @param pathOrId - The path or id of the file.
+     * @returns The contents of the file if it exists, otherwise undefined.
+     */
+    readFile: (pathOrId: string) => Promise<string | undefined>;
+    /**
+     * Reads a file from the virtual file system (VFS).
      *
-     * @see https://vitejs.dev/guide/api-plugin#config
+     * @param pathOrId - The path or id of the file.
+     */
+    readFileSync: (pathOrId: string) => string | undefined;
+    /**
+     * Writes a file to the virtual file system (VFS).
      *
-     * @param this - The build context.
-     * @param config - The partial configuration object to be modified.
-     * @returns A promise that resolves to a partial configuration object.
+     * @param path - The path to the file.
+     * @param data - The contents of the file.
+     * @param options - Optional parameters for writing the file.
+     * @returns A promise that resolves when the file is written.
      */
-    config: PluginHook<(this: UnresolvedContext<TContext["config"]>) => MaybePromise<ConfigResult<TContext>>> | ConfigResult<TContext>;
+    writeFile: (path: PathOrFileDescriptor, data?: WriteFileData, options?: WriteFileOptions) => Promise<void>;
     /**
-     * A hook that is called to transform the source code.
+     * Writes a file to the virtual file system (VFS).
      *
-     * @param this - The build context, unplugin build context, and unplugin context.
-     * @param code - The source code to transform.
-     * @param id - The identifier of the source code.
-     * @returns A promise that resolves when the hook is complete.
+     * @param path - The path to the file.
+     * @param data - The contents of the file.
+     * @param options - Optional parameters for writing the file.
      */
-    transform: PluginHook<(this: BuildPluginContext<TContext["config"]> & TContext, code: string, id: string) => MaybePromise<TransformResult$1>, "code" | "id">;
+    writeFileSync: (path: PathOrFileDescriptor, data?: WriteFileData, options?: WriteFileOptions) => void;
     /**
-     * A hook that is called to load the source code.
+     * Moves a file from one path to another in the virtual file system (VFS).
      *
-     * @param this - The build context, unplugin build context, and unplugin context.
-     * @param id - The identifier of the source code.
-     * @returns A promise that resolves when the hook is complete.
+     * @param srcPath - The source path to move
+     * @param destPath - The destination path to move to
      */
-    load: PluginHook<(this: BuildPluginContext<TContext["config"]> & TContext, id: string) => MaybePromise<TransformResult$1>, "id">;
+    move: (srcPath: string, destPath: string) => Promise<void>;
     /**
-     * A hook that is called to resolve the identifier of the source code.
+     * Synchronously moves a file from one path to another in the virtual file system (VFS).
      *
-     * @param this - The build context, unplugin build context, and unplugin context.
-     * @param id - The identifier of the source code.
-     * @param importer - The importer of the source code.
-     * @param options - The options for resolving the identifier.
-     * @returns A promise that resolves when the hook is complete.
+     * @param srcPath - The source path to move
+     * @param destPath - The destination path to move to
      */
-    resolveId: PluginHook<(this: BuildPluginContext<TContext["config"]> & TContext, id: string, importer: string | undefined, options: {
-        isEntry: boolean;
-    }) => MaybePromise<string | ExternalIdResult | null | undefined>, "id">;
-};
-type PluginBuildPlugins<TContext extends PluginContext = PluginContext> = {
-    [TBuildVariant in UnpluginBuildVariant]?: BuildPlugin<TContext, TBuildVariant>;
-};
-interface Plugin<in out TContext extends PluginContext<ResolvedConfig> = PluginContext<ResolvedConfig>> extends Partial<PluginHooks<TContext>>, PluginBuildPlugins<TContext> {
+    moveSync: (srcPath: string, destPath: string) => void;
     /**
-     * The name of the plugin, for use in deduplication, error messages and logs.
+     * 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
      */
-    name: string;
+    copy: (srcPath: string, destPath: string) => Promise<void>;
     /**
-     * Enforce plugin invocation tier similar to webpack loaders. Hooks ordering is still subject to the `order` property in the hook object.
+     * Synchronously copies a file from one path to another in the virtual file system (VFS).
      *
-     * @remarks
-     * The Plugin invocation order is as follows:
-     * - `enforce: 'pre'` plugins
-     * - `order: 'pre'` plugin hooks
-     * - any other plugins (normal)
-     * - `order: 'post'` plugin hooks
-     * - `enforce: 'post'` plugins
+     * @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).
      *
-     * @see https://vitejs.dev/guide/api-plugin.html#plugin-ordering
-     * @see https://rollupjs.org/plugin-development/#build-hooks
-     * @see https://webpack.js.org/concepts/loaders/#enforce---pre-and-post
-     * @see https://esbuild.github.io/plugins/#concepts
+     * @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)
      */
-    enforce?: "pre" | "post";
+    glob: (pattern: string | string[]) => Promise<string[]>;
     /**
-     * A function to determine if two plugins are the same and can be de-duplicated.
+     * Synchronously glob files in the virtual file system (VFS) based on the provided pattern(s).
      *
-     * @remarks
-     * If this is not provided, plugins are de-duplicated by comparing their names.
+     * @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.
      *
-     * @param other - The other plugin to compare against.
-     * @returns `true` if the two plugins are the same, `false` otherwise.
+     * @param pathOrId - The path or id of the file to resolve.
+     * @param options - Optional parameters for resolving the path.
+     * @returns The resolved path of the file if it exists, otherwise false.
      */
-    dedupe?: false | ((other: Plugin<any>) => boolean);
+    resolve: (pathOrId: string, options?: ResolvePathOptions) => string | false;
     /**
-     * A list of pre-requisite plugins that must be loaded before this plugin can be used.
+     * Formats a path to match the virtual file system (VFS) structure.
+     *
+     * @param path - The path to format.
+     * @returns The formatted path.
      */
-    dependsOn?: PluginConfig<any>[];
+    formatPath: (path: string) => string;
     /**
-     * Define environments where this plugin should be active. By default, the plugin is active in all environments.
+     * Resolves a path or id to a file path in the virtual file system.
      *
-     * @param environment - The environment to check.
-     * @returns `true` if the plugin should be active in the specified environment, `false` otherwise.
+     * @param pathOrId - The path or id of the file to resolve.
+     * @returns The resolved path of the file if it exists, otherwise false.
      */
-    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];
+    realpathSync: (pathOrId: string) => string;
+    /**
+     * Disposes of the virtual file system (VFS), writes any virtual file changes to disk, and releases any associated resources.
+     */
+    dispose: () => Promise<void>;
 }
-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_PATCH__ = "__VFS_PATCH__";
-declare const __VFS_REVERT__ = "__VFS_REVERT__";
-type OutputModeType = "fs" | "virtual";
-interface VirtualFile {
+type UnpluginBuildVariant = "rollup" | "webpack" | "rspack" | "vite" | "esbuild" | "farm" | "unloader" | "rolldown";
+type BuildVariant = UnpluginBuildVariant | "tsup" | "unbuild";
+type InferUnpluginVariant<TBuildVariant extends BuildVariant> = TBuildVariant extends "tsup" ? "esbuild" : TBuildVariant extends "unbuild" ? "rollup" : TBuildVariant;
+interface BuildConfig {
     /**
-     * The unique identifier for the virtual file.
+     * The platform to build the project for
      *
-     * @remarks
-     * If no specific id is provided, it defaults to the file's {@link path}.
-     */
-    id: string;
-    /**
-     * Additional metadata associated with the virtual file.
+     * @defaultValue "neutral"
      */
-    details: Record<string, PrimitiveJsonValue>;
+    platform?: "node" | "browser" | "neutral";
     /**
-     * The variant of the file.
+     * Array of strings indicating the polyfills to include for the build.
      *
      * @remarks
-     * This string represents the purpose/function of the file in the virtual file system. A potential list of variants includes:
-     * - `builtin`: Indicates that the file is a built-in module provided by the system.
-     * - `entry`: Indicates that the file is an entry point for execution.
-     * - `normal`: Indicates that the file is a standard file without any special role.
+     * 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']
+     * }
+     * ```
      */
-    variant: string;
+    polyfill?: string[];
     /**
-     * The output mode of the file.
+     * 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.
      *
-     * @remarks
-     * This indicates whether the file is intended to be written to the actual file system (`fs`) or kept in the virtual file system (`virtual`).
+     * @defaultValue `['browser', 'module', 'jsnext:main', 'jsnext']`
      */
-    mode: OutputModeType;
+    mainFields?: string[];
     /**
-     * A virtual (or actual) path to the file in the file system.
+     * Array of strings indicating what conditions should be used for module resolution.
      */
-    path: string;
+    conditions?: string[];
     /**
-     * The contents of the file.
+     * Array of strings indicating what file extensions should be used for module resolution.
+     *
+     * @defaultValue `['.mjs', '.js', '.mts', '.ts', '.jsx', '.tsx', '.json']`
      */
-    code: string | NodeJS.ArrayBufferView;
-}
-interface VirtualFileMetadata {
+    extensions?: string[];
     /**
-     * The identifier for the file data.
+     * 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.
      */
-    id: string;
+    dedupe?: string[];
     /**
-     * The variant of the file.
+     * Array of strings or regular expressions that indicate what modules are builtin for the environment.
      */
-    variant: string;
+    builtins?: (string | RegExp)[];
     /**
-     * The output mode of the file.
+     * 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
      */
-    mode: string;
+    define?: Record<string, any>;
     /**
-     * Additional metadata associated with the file.
+     * 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
      */
-    properties: Record<string, string>;
-}
-interface ResolveFSOptions {
-    mode?: OutputModeType;
-}
-type MakeDirectoryOptions = (Mode | MakeDirectoryOptions$1) & ResolveFSOptions;
-interface PowerlinesWriteFileOptions extends ResolveFSOptions {
-    skipFormat?: boolean;
-}
-type NodeWriteFileOptions = WriteFileOptions$1;
-type WriteFileOptions = NodeWriteFileOptions | PowerlinesWriteFileOptions;
-type PowerLinesWriteFileData = Partial<Omit<VirtualFile, "path" | "mode" | "code">> & Pick<VirtualFile, "code">;
-type WriteFileData = string | NodeJS.ArrayBufferView | PowerLinesWriteFileData;
-interface ResolvePathOptions extends ResolveFSOptions {
+    inject?: Record<string, string | string[]>;
     /**
-     * Should the resolved path include the file extension?
+     * The alias mappings to use for module resolution during the build process.
      *
-     * @defaultValue true
+     * @remarks
+     * This option allows you to define custom path aliases for modules, which can be useful for simplifying imports and managing dependencies.
+     *
+     * @example
+     * ```ts
+     * {
+     *   alias: {
+     *     "@utils": "./src/utils",
+     *     "@components": "./src/components"
+     *   }
+     * }
+     * ```
+     *
+     * @see https://github.com/rollup/plugins/tree/master/packages/alias
      */
-    withExtension?: boolean;
+    alias?: Record<string, string> | Array<{
+        find: string | RegExp;
+        replacement: string;
+    }>;
     /**
-     * The paths to search for the file.
+     * A list of modules that should not be bundled, even if they are external dependencies.
+     *
+     * @remarks
+     * This option is useful for excluding specific modules from the bundle, such as Node.js built-in modules or other libraries that should not be bundled.
      */
-    paths?: string[];
+    external?: (string | RegExp)[];
     /**
-     * The type of the path to resolve.
+     * A list of modules that should always be bundled, even if they are external dependencies.
      */
-    type?: "file" | "directory";
-}
-interface VirtualFileSystemInterface {
+    noExternal?: (string | RegExp)[];
     /**
-     * Patches the File System to include the virtual file system (VFS) contents.
+     * Should the Powerlines CLI processes skip bundling the `node_modules` directory?
      */
-    [__VFS_PATCH__]: () => void;
+    skipNodeModulesBundle?: boolean;
     /**
-     * Reverts the virtual file system (VFS) to its previous state.
+     * 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.
      */
-    [__VFS_REVERT__]: () => void;
+    override?: Record<string, any>;
+}
+type BuildResolvedConfig = Omit<BuildConfig, "override">;
+type ESBuildBuildConfig = Omit<BuildOptions, "entryPoints" | "sourceRoot" | "platform" | "outdir" | "env" | "assets" | "external" | "inject" | "tsconfig" | "tsconfigRaw" | "logLevel"> & BuildConfig;
+type ESBuildResolvedBuildConfig = Omit<BuildOptions, "inject"> & BuildResolvedConfig;
+type ViteBuildConfig = Omit<UserConfig$1, "entry" | "entryPoints" | "tsconfig" | "tsconfigRaw" | "environments" | "output"> & BuildConfig;
+type ViteResolvedBuildConfig = UserConfig$1 & BuildResolvedConfig;
+type WebpackBuildConfig = Omit<Configuration, "name" | "entry" | "entryPoints" | "tsconfig" | "tsconfigRaw"> & BuildConfig;
+type WebpackResolvedBuildConfig = Configuration & BuildResolvedConfig;
+type RspackBuildConfig = Omit<Configuration$1, "name" | "entry" | "entryPoints" | "tsconfig" | "tsconfigRaw"> & BuildConfig;
+type RspackResolvedBuildConfig = Configuration$1 & BuildResolvedConfig;
+type RollupBuildOutputConfig = Omit<OutputOptions, "dir" | "format">;
+type RollupBuildConfig = Omit<RollupOptions, "entry" | "external" | "input" | "output" | "logLevel"> & {
+    output: RollupBuildOutputConfig | RollupBuildOutputConfig[];
+} & BuildConfig;
+type RollupResolvedBuildConfig = RollupOptions & BuildResolvedConfig;
+type RolldownBuildOutputConfig = Omit<RolldownOutput, "dir" | "format">;
+type RolldownBuildConfig = Omit<RolldownOptions, "input" | "external" | "tsconfig" | "logLevel" | "output"> & {
+    output: RolldownBuildOutputConfig | RolldownBuildOutputConfig[];
+} & BuildConfig;
+type RolldownResolvedBuildConfig = RolldownOptions & BuildResolvedConfig;
+type TsupBuildConfig = Partial<Omit<BuildOptions$1, "userOptions" | "tsconfig" | "tsconfigRaw" | "assets" | "outputPath" | "mode" | "format" | "platform" | "projectRoot" | "env" | "entry" | "entryPoints" | "external" | "noExternal" | "skipNodeModulesBundle">> & BuildConfig;
+type TsupResolvedBuildConfig = BuildOptions$1 & BuildResolvedConfig;
+type UnbuildBuildConfig = Partial<Omit<UnbuildOptions, "tsconfig" | "tsconfigRaw" | "assets" | "outputPath" | "mode" | "format" | "platform" | "projectRoot" | "env" | "entry" | "entryPoints">> & BuildConfig;
+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;
+
+declare const SUPPORTED_COMMANDS: readonly ["new", "clean", "prepare", "lint", "test", "build", "docs", "deploy", "finalize"];
+type CommandType = ArrayValues<typeof SUPPORTED_COMMANDS>;
+
+interface ResolvedEntryTypeDefinition extends TypeDefinition {
     /**
-     * The underlying file metadata.
+     * The user provided entry point in the source code
      */
-    metadata: Record<string, VirtualFileMetadata | undefined>;
+    input: TypeDefinition;
     /**
-     * A map of module ids to their file paths.
+     * An optional name to use in the package export during the build process
      */
-    ids: Record<string, string>;
+    output?: string;
+}
+type EnvironmentResolvedConfig = Omit<EnvironmentConfig, "consumer" | "mode" | "ssr" | "preview"> & Required<Pick<EnvironmentConfig, "consumer" | "mode" | "ssr">> & {
     /**
-     * Check if a path or id corresponds to a virtual file **(does not actually exists on disk)**.
-     *
-     * @param pathOrId - The path or id to check.
-     * @param options - Optional parameters for resolving the path.
-     * @returns Whether the path or id corresponds to a virtual file **(does not actually exists on disk)**.
+     * The name of the environment
      */
-    isVirtual: (pathOrId: string, options?: ResolvePathOptions) => boolean;
+    name: string;
     /**
-     * Check if a path or id corresponds to a file written to the file system **(actually exists on disk)**.
-     *
-     * @param pathOrId - The path or id to check.
-     * @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)**.
+     * Configuration options for the preview server
      */
-    isPhysical: (pathOrId: string, options?: ResolvePathOptions) => boolean;
+    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" | "test" | "build" | "transform" | "deploy" | "variant" | "type" | "output" | "logLevel" | "framework"> & Required<Pick<TUserConfig, "name" | "title" | "plugins" | "mode" | "environments" | "tsconfig" | "lint" | "test" | "build" | "transform" | "deploy" | "framework">> & {
     /**
-     * Checks if a file exists in the virtual file system (VFS).
-     *
-     * @param path - The path of the file to check.
-     * @returns `true` if the file exists, otherwise `false`.
+     * The configuration options that were provided inline to the Powerlines CLI.
      */
-    isFile: (path: string) => boolean;
+    inlineConfig: InlineConfig<TUserConfig>;
     /**
-     * Checks if a directory exists in the virtual file system (VFS).
-     *
-     * @param path - The path of the directory to check.
-     * @returns `true` if the directory exists, otherwise `false`.
+     * The original configuration options that were provided by the user to the Powerlines process.
      */
-    isDirectory: (path: string) => boolean;
+    userConfig: TUserConfig;
     /**
-     * Checks if a file exists in the virtual file system (VFS).
-     *
-     * @param pathOrId - The path or id of the file.
-     * @returns `true` if the file exists, otherwise `false`.
+     * A string identifier for the Powerlines command being executed.
      */
-    existsSync: (pathOrId: string) => boolean;
+    command: NonUndefined<InlineConfig<TUserConfig>["command"]>;
     /**
-     * Gets the metadata of a file in the virtual file system (VFS).
+     * The root directory of the project's source code
      *
-     * @param pathOrId - The path or id of the file.
-     * @returns The metadata of the file if it exists, otherwise undefined.
+     * @defaultValue "\{projectRoot\}/src"
      */
-    getMetadata: (pathOrId: PathLike) => VirtualFileMetadata | undefined;
+    sourceRoot: NonUndefined<TUserConfig["sourceRoot"]>;
     /**
-     * Gets the stats of a file in the virtual file system (VFS).
-     *
-     * @param pathOrId - The path or id of the file.
-     * @param options - Optional parameters for getting the stats.
-     * @returns The stats of the file if it exists, otherwise undefined.
+     * The root directory of the project.
      */
-    lstat: (pathOrId: string, options?: StatSyncOptions & {
-        bigint?: false | undefined;
-        throwIfNoEntry: false;
-    }) => Promise<Stats>;
+    projectRoot: NonUndefined<TUserConfig["root"]>;
     /**
-     * Gets the stats of a file in the virtual file system (VFS).
-     *
-     * @param pathOrId - The path or id of the file.
-     * @param options - Optional parameters for getting the stats.
-     * @returns The stats of the file if it exists, otherwise undefined.
+     * The type of project being built.
      */
-    lstatSync: (pathOrId: string, options?: StatSyncOptions & {
-        bigint?: false | undefined;
-        throwIfNoEntry: false;
-    }) => Stats | undefined;
+    projectType: NonUndefined<TUserConfig["type"]>;
     /**
-     * Gets the stats of a file in the virtual file system (VFS).
-     *
-     * @param pathOrId - The path or id of the file.
-     * @returns The stats of the file if it exists, otherwise false.
+     * The output configuration options to use for the build process
      */
-    stat: (pathOrId: string, options?: StatSyncOptions & {
-        bigint?: false | undefined;
-        throwIfNoEntry: false;
-    }) => Promise<Stats>;
+    output: OutputResolvedConfig;
     /**
-     * Gets the stats of a file in the virtual file system (VFS).
+     * Configuration provided to build processes
      *
-     * @param pathOrId - The path or id of the file.
-     * @returns The stats of the file if it exists, otherwise false.
+     * @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}.
      */
-    statSync: (pathOrId: string, options?: StatSyncOptions & {
-        bigint?: false | undefined;
-        throwIfNoEntry: false;
-    }) => Stats | undefined;
+    build: Omit<TUserConfig["build"], "override"> & Required<Pick<Required<TUserConfig["build"]>, "override">>;
     /**
-     * Lists files in a given path.
+     * The log level to use for the Powerlines processes.
      *
-     * @param path - The path to list files from.
-     * @param options - Options for listing files, such as encoding and recursion.
-     * @returns An array of file names in the specified path.
+     * @defaultValue "info"
      */
-    readdirSync: (path: string, options?: {
-        encoding: BufferEncoding | null;
-        withFileTypes?: false | undefined;
-        recursive?: boolean | undefined;
-    } | BufferEncoding) => string[];
+    logLevel: "error" | "warn" | "info" | "debug" | "trace" | 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;
+
+interface PluginHookObject<THookFunction extends FunctionLike, TFilter extends keyof HookFilter = never> {
     /**
-     * Lists files in a given path.
-     *
-     * @param path - The path to list files from.
-     * @param options - Options for listing files, such as encoding and recursion.
-     * @returns An array of file names in the specified path.
+     * The order in which the plugin should be applied.
      */
-    readdir: (path: string, options?: {
-        encoding: BufferEncoding | null;
-        withFileTypes?: false | undefined;
-        recursive?: boolean | undefined;
-    } | BufferEncoding) => Promise<string[]>;
+    order?: "pre" | "post" | null | undefined;
     /**
-     * Removes a file or symbolic link in the virtual file system (VFS).
-     *
-     * @param path - The path to the file to remove.
-     * @returns A promise that resolves when the file is removed.
+     * A filter to determine when the hook should be called.
      */
-    unlinkSync: (path: PathLike, options?: ResolveFSOptions) => void;
+    filter?: Pick<HookFilter, TFilter>;
     /**
-     * Asynchronously removes a file or symbolic link in the virtual file system (VFS).
-     *
-     * @param path - The path to the file to remove.
-     * @returns A promise that resolves when the file is removed.
+     * The hook function to be called.
      */
-    unlink: (path: string, options?: ResolveFSOptions) => Promise<void>;
+    handler: THookFunction;
+}
+type PluginHook<THookFunction extends FunctionLike, TFilter extends keyof HookFilter = never> = THookFunction | PluginHookObject<THookFunction, TFilter>;
+/**
+ * A result returned by the plugin from the `generateTypes` hook that describes the declaration types output file.
+ */
+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>> {
     /**
-     * Removes a directory in the virtual file system (VFS).
+     * A function that returns configuration options to be merged with the build context's options.
+     *
+     * @remarks
+     * Modify config before it's resolved. The hook can either mutate {@link Context.config} on the passed-in context directly, or return a partial config object that will be deeply merged into existing config.
+     *
+     * @warning User plugins are resolved before running this hook so injecting other plugins inside the config hook will have no effect. If you want to add plugins, consider doing so in the {@link Plugin.dependsOn} property instead.
      *
-     * @param path - The path to create the directory at.
-     * @param options - Options for creating the directory.
+     * @see https://vitejs.dev/guide/api-plugin#config
+     *
+     * @param this - The build context.
+     * @param config - The partial configuration object to be modified.
+     * @returns A promise that resolves to a partial configuration object.
      */
-    rmdirSync: (path: PathLike, options?: RmDirOptions & ResolveFSOptions) => any;
+    config: (this: UnresolvedContext<TContext["config"]>) => MaybePromise<ConfigResult<TContext>>;
     /**
-     * Removes a directory in the virtual file system (VFS).
+     * 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.
      *
-     * @param path - The path to create the directory at.
-     * @param options - Options for creating the directory.
-     * @returns A promise that resolves to the path of the created directory, or undefined if the directory could not be created.
+     * @remarks
+     * This hook is called for each environment with a partially resolved environment config that already accounts for the default environment config values set at the root level. If plugins need to modify the config of a given environment, they should do it in this hook instead of the config hook. Leaving the config hook only for modifying the root default environment config.
+     *
+     * @see https://vitejs.dev/guide/api-plugin#configenvironment
+     *
+     * @param this - The build context.
+     * @param name - The name of the environment being configured.
+     * @param environment - The Vite-like environment object containing information about the current build environment.
+     * @returns A promise that resolves when the hook is complete.
      */
-    rmdir: (path: PathLike, options?: RmDirOptions & ResolveFSOptions) => Promise<void>;
+    configEnvironment: (this: TContext, name: string, environment: EnvironmentConfig) => MaybePromise<Partial<EnvironmentResolvedConfig> | undefined | null>;
     /**
-     * Removes a file or directory in the virtual file system (VFS).
+     * A hook that is called when the plugin is resolved.
      *
-     * @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.
+     * @see https://vitejs.dev/guide/api-plugin#configresolved
+     *
+     * @param this - The build context.
+     * @returns A promise that resolves when the hook is complete.
      */
-    rm: (path: PathLike, options?: RmOptions & ResolveFSOptions) => Promise<void>;
+    configResolved: (this: TContext) => MaybePromise<void>;
     /**
-     * Synchronously removes a file or directory in the virtual file system (VFS).
+     * A hook that is called to overwrite the generated declaration types file (.d.ts). The generated type definitions should describe the built-in modules/logic added during the `prepare` task.
      *
-     * @param path - The path to the file or directory to remove.
-     * @param options - Options for removing the file or directory.
+     * @param this - The build context.
+     * @param code - The source code to generate types for.
+     * @returns A promise that resolves when the hook is complete.
      */
-    rmSync: (path: PathLike, options?: RmOptions & ResolveFSOptions) => void;
+    generateTypes: (this: TContext, code: string) => MaybePromise<GenerateTypesResult | string | undefined | null>;
     /**
-     * Creates a directory in the virtual file system (VFS).
+     * A hook that is called at the start of the build process.
      *
-     * @param path - The path to create the directory at.
-     * @param options - Options for creating the directory.
-     * @returns A promise that resolves to the path of the created directory, or undefined if the directory could not be created.
+     * @param this - The build context and unplugin build context.
+     * @returns A promise that resolves when the hook is complete.
      */
-    mkdirSync: (path: PathLike, options?: MakeDirectoryOptions) => string | undefined;
+    buildStart: (this: BuildPluginContext<TContext["config"]> & TContext) => MaybePromise<void>;
     /**
-     * Creates a directory in the virtual file system (VFS).
+     * A hook that is called at the end of the build process.
      *
-     * @param path - The path to create the directory at.
-     * @param options - Options for creating the directory.
-     * @returns A promise that resolves to the path of the created directory, or undefined if the directory could not be created.
+     * @param this - The build context and unplugin build context.
+     * @returns A promise that resolves when the hook is complete.
      */
-    mkdir: (path: PathLike, options?: MakeDirectoryOptions) => Promise<string | undefined>;
+    buildEnd: (this: BuildPluginContext<TContext["config"]> & TContext) => MaybePromise<void>;
     /**
-     * Reads a file from the virtual file system (VFS).
+     * A hook that is called to transform the source code.
      *
-     * @param pathOrId - The path or id of the file.
-     * @returns The contents of the file if it exists, otherwise undefined.
+     * @param this - The build context, unplugin build context, and unplugin context.
+     * @param code - The source code to transform.
+     * @param id - The identifier of the source code.
+     * @returns A promise that resolves when the hook is complete.
      */
-    readFile: (pathOrId: string) => Promise<string | undefined>;
+    transform: (this: BuildPluginContext<TContext["config"]> & TContext, code: string, id: string) => MaybePromise<TransformResult$1>;
     /**
-     * Reads a file from the virtual file system (VFS).
+     * A hook that is called to load the source code.
      *
-     * @param pathOrId - The path or id of the file.
+     * @param this - The build context, unplugin build context, and unplugin context.
+     * @param id - The identifier of the source code.
+     * @returns A promise that resolves when the hook is complete.
      */
-    readFileSync: (pathOrId: string) => string | undefined;
+    load: (this: BuildPluginContext<TContext["config"]> & TContext, id: string) => MaybePromise<TransformResult$1>;
     /**
-     * Writes a file to the virtual file system (VFS).
+     * A hook that is called to resolve the identifier of the source code.
      *
-     * @param path - The path to the file.
-     * @param data - The contents of the file.
-     * @param options - Optional parameters for writing the file.
-     * @returns A promise that resolves when the file is written.
+     * @param this - The build context, unplugin build context, and unplugin context.
+     * @param id - The identifier of the source code.
+     * @param importer - The importer of the source code.
+     * @param options - The options for resolving the identifier.
+     * @returns A promise that resolves when the hook is complete.
      */
-    writeFile: (path: PathOrFileDescriptor, data?: WriteFileData, options?: WriteFileOptions) => Promise<void>;
+    resolveId: (this: BuildPluginContext<TContext["config"]> & TContext, id: string, importer: string | undefined, options: {
+        isEntry: boolean;
+    }) => MaybePromise<string | ExternalIdResult | null | undefined>;
     /**
-     * Writes a file to the virtual file system (VFS).
+     * A hook that is called to write the bundle to disk.
      *
-     * @param path - The path to the file.
-     * @param data - The contents of the file.
-     * @param options - Optional parameters for writing the file.
+     * @param this - The build context.
+     * @returns A promise that resolves when the hook is complete.
      */
-    writeFileSync: (path: PathOrFileDescriptor, data?: WriteFileData, options?: WriteFileOptions) => void;
+    writeBundle: (this: TContext) => MaybePromise<void>;
+}
+type BuildPlugin<TContext extends PluginContext = PluginContext, TBuildVariant extends UnpluginBuildVariant = UnpluginBuildVariant, TOptions extends Required<UnpluginOptions>[TBuildVariant] = Required<UnpluginOptions>[TBuildVariant]> = {
+    [TKey in keyof TOptions]: TOptions[TKey] extends FunctionLike ? (this: ThisParameterType<TOptions[TKey]> & TContext, ...args: Parameters<TOptions[TKey]>) => ReturnType<TOptions[TKey]> | MaybePromise<ReturnType<TOptions[TKey]>> : TOptions[TKey];
+};
+type ExternalPluginHookFunctionsVariant<TContext extends PluginContext = PluginContext, TBuildVariant extends UnpluginBuildVariant = UnpluginBuildVariant> = {
+    [TKey in keyof BuildPlugin<TContext, TBuildVariant> & string as `${TBuildVariant}:${TKey}`]: BuildPlugin<TContext, TBuildVariant>[TKey];
+};
+type ExternalPluginHookFunctions<TContext extends PluginContext> = ExternalPluginHookFunctionsVariant<TContext, "vite"> & ExternalPluginHookFunctionsVariant<TContext, "esbuild"> & ExternalPluginHookFunctionsVariant<TContext, "rolldown"> & ExternalPluginHookFunctionsVariant<TContext, "rollup"> & ExternalPluginHookFunctionsVariant<TContext, "webpack"> & ExternalPluginHookFunctionsVariant<TContext, "rspack"> & ExternalPluginHookFunctionsVariant<TContext, "farm">;
+type PluginHookFunctions<TContext extends PluginContext = PluginContext> = BasePluginHookFunctions<TContext> & ExternalPluginHookFunctions<TContext>;
+type PluginHooks<TContext extends PluginContext = PluginContext> = {
+    [TKey in keyof BasePluginHookFunctions<TContext>]: PluginHook<BasePluginHookFunctions<TContext>[TKey]>;
+} & {
     /**
-     * Moves a file from one path to another in the virtual file system (VFS).
+     * A function that returns configuration options to be merged with the build context's options.
      *
-     * @param srcPath - The source path to move
-     * @param destPath - The destination path to move to
+     * @remarks
+     * Modify config before it's resolved. The hook can either mutate {@link Context.config} on the passed-in context directly, or return a partial config object that will be deeply merged into existing config.
+     *
+     * @warning User plugins are resolved before running this hook so injecting other plugins inside the config hook will have no effect. If you want to add plugins, consider doing so in the {@link Plugin.dependsOn} property instead.
+     *
+     * @see https://vitejs.dev/guide/api-plugin#config
+     *
+     * @param this - The build context.
+     * @param config - The partial configuration object to be modified.
+     * @returns A promise that resolves to a partial configuration object.
      */
-    move: (srcPath: string, destPath: string) => Promise<void>;
+    config: PluginHook<(this: UnresolvedContext<TContext["config"]>) => MaybePromise<ConfigResult<TContext>>> | ConfigResult<TContext>;
     /**
-     * Synchronously moves a file from one path to another in the virtual file system (VFS).
+     * A hook that is called to transform the source code.
      *
-     * @param srcPath - The source path to move
-     * @param destPath - The destination path to move to
+     * @param this - The build context, unplugin build context, and unplugin context.
+     * @param code - The source code to transform.
+     * @param id - The identifier of the source code.
+     * @returns A promise that resolves when the hook is complete.
      */
-    moveSync: (srcPath: string, destPath: string) => void;
+    transform: PluginHook<(this: BuildPluginContext<TContext["config"]> & TContext, code: string, id: string) => MaybePromise<TransformResult$1>, "code" | "id">;
     /**
-     * Copies a file from one path to another in the virtual file system (VFS).
+     * A hook that is called to load the source code.
      *
-     * @param srcPath - The source path to copy
-     * @param destPath - The destination path to copy to
+     * @param this - The build context, unplugin build context, and unplugin context.
+     * @param id - The identifier of the source code.
+     * @returns A promise that resolves when the hook is complete.
      */
-    copy: (srcPath: string, destPath: string) => Promise<void>;
+    load: PluginHook<(this: BuildPluginContext<TContext["config"]> & TContext, id: string) => MaybePromise<TransformResult$1>, "id">;
     /**
-     * Synchronously copies a file from one path to another in the virtual file system (VFS).
+     * A hook that is called to resolve the identifier of the source code.
      *
-     * @param srcPath - The source path to copy
-     * @param destPath - The destination path to copy to
+     * @param this - The build context, unplugin build context, and unplugin context.
+     * @param id - The identifier of the source code.
+     * @param importer - The importer of the source code.
+     * @param options - The options for resolving the identifier.
+     * @returns A promise that resolves when the hook is complete.
      */
-    copySync: (srcPath: string, destPath: string) => void;
+    resolveId: PluginHook<(this: BuildPluginContext<TContext["config"]> & TContext, id: string, importer: string | undefined, options: {
+        isEntry: boolean;
+    }) => MaybePromise<string | ExternalIdResult | null | undefined>, "id">;
     /**
-     * Glob files in the virtual file system (VFS) based on the provided pattern(s).
+     * An API object that can be used for inter-plugin communication.
      *
-     * @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)
+     * @see https://rollupjs.org/plugin-development/#direct-plugin-communication
      */
-    glob: (pattern: string | string[]) => Promise<string[]>;
+    api?: Record<string, any>;
+};
+type PluginBuildPlugins<TContext extends PluginContext = PluginContext> = {
+    [TBuildVariant in UnpluginBuildVariant]?: BuildPlugin<TContext, TBuildVariant>;
+};
+interface Plugin<in out TContext extends PluginContext<ResolvedConfig> = PluginContext<ResolvedConfig>> extends Partial<PluginHooks<TContext>>, PluginBuildPlugins<TContext> {
     /**
-     * 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)
+     * The name of the plugin, for use in deduplication, error messages and logs.
      */
-    globSync: (pattern: string | string[]) => string[];
+    name: string;
     /**
-     * Resolves a path or id to a file path in the virtual file system.
+     * Enforce plugin invocation tier similar to webpack loaders. Hooks ordering is still subject to the `order` property in the hook object.
      *
-     * @param pathOrId - The path or id of the file to resolve.
-     * @param options - Optional parameters for resolving the path.
-     * @returns The resolved path of the file if it exists, otherwise false.
+     * @remarks
+     * The Plugin invocation order is as follows:
+     * - `enforce: 'pre'` plugins
+     * - `order: 'pre'` plugin hooks
+     * - any other plugins (normal)
+     * - `order: 'post'` plugin hooks
+     * - `enforce: 'post'` plugins
+     *
+     * @see https://vitejs.dev/guide/api-plugin.html#plugin-ordering
+     * @see https://rollupjs.org/plugin-development/#build-hooks
+     * @see https://webpack.js.org/concepts/loaders/#enforce---pre-and-post
+     * @see https://esbuild.github.io/plugins/#concepts
      */
-    resolve: (pathOrId: string, options?: ResolvePathOptions) => string | false;
+    enforce?: "pre" | "post";
     /**
-     * Formats a path to match the virtual file system (VFS) structure.
+     * A function to determine if two plugins are the same and can be de-duplicated.
      *
-     * @param path - The path to format.
-     * @returns The formatted path.
+     * @remarks
+     * If this is not provided, plugins are de-duplicated by comparing their names.
+     *
+     * @param other - The other plugin to compare against.
+     * @returns `true` if the two plugins are the same, `false` otherwise.
      */
-    formatPath: (path: string) => string;
+    dedupe?: false | ((other: Plugin<any>) => boolean);
     /**
-     * Resolves a path or id to a file path in the virtual file system.
-     *
-     * @param pathOrId - The path or id of the file to resolve.
-     * @returns The resolved path of the file if it exists, otherwise false.
+     * A list of pre-requisite plugins that must be loaded before this plugin can be used.
      */
-    realpathSync: (pathOrId: string) => string;
+    dependsOn?: PluginConfig<any>[];
     /**
-     * Disposes of the virtual file system (VFS), writes any virtual file changes to disk, and releases any associated resources.
+     * Define environments where this plugin should be active. By default, the plugin is active in all environments.
+     *
+     * @param environment - The environment to check.
+     * @returns `true` if the plugin should be active in the specified environment, `false` otherwise.
      */
-    dispose: () => Promise<void>;
+    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>>;
 
 type WorkerProcess<TExposedMethods extends ReadonlyArray<string>> = {
     [K in TExposedMethods[number]]: (data: any) => Promise<any>;
@@ -1114,7 +1135,7 @@ interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedCon
      * @param path - An optional path to write the builtin file to
      * @param options - Options for writing the file
      */
-    writeBuiltin: (code: string, id: string, path?: string, options?: PowerlinesWriteFileOptions) => Promise<void>;
+    emitBuiltin: (code: string, id: string, path?: string, options?: PowerlinesWriteFileOptions) => Promise<void>;
     /**
      * Resolves a entry virtual file and writes it to the VFS if it does not already exist
      *
@@ -1122,11 +1143,7 @@ interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedCon
      * @param path - An optional path to write the entry file to
      * @param options - Options for writing the file
      */
-    writeEntry: (code: string, path: string, options?: PowerlinesWriteFileOptions) => Promise<void>;
-    /**
-     * Parses the source code and returns a {@link ParseResult} object.
-     */
-    parse: (code: string, id: string, options?: ParserOptions | null) => Promise<ParseResult>;
+    emitEntry: (code: string, path: string, options?: PowerlinesWriteFileOptions) => Promise<void>;
     /**
      * A function to update the context fields using a new user configuration options
      */
@@ -1634,4 +1651,4 @@ type DeployInlineConfig<TUserConfig extends UserConfig = UserConfig> = InlineCon
     command: "deploy";
 };
 
-export { type APIContext as A, type BuildVariant as B, type Context as C, type PrepareInlineConfig as D, type ESBuildResolvedBuildConfig as E, type CleanInlineConfig as F, type BuildInlineConfig as G, type HookKeys as H, type InferHookParameters as I, type LintInlineConfig as J, type DocsInlineConfig as K, type LogFn as L, type MakeDirectoryOptions as M, type NewInlineConfig as N, type DeployInlineConfig as O, type PowerlinesCommand as P, type ResolvePathOptions as R, type SelectHooksOptions as S, type TsupBuildConfig as T, type UnbuildBuildConfig as U, type VirtualFileSystemInterface as V, type WriteFileData as W, __VFS_PATCH__ as _, type VirtualFileMetadata as a, type ResolveFSOptions as b, type WriteFileOptions as c, __VFS_REVERT__ as d, type WorkspaceConfig as e, type ParsedUserConfig as f, type ResolvedEntryTypeDefinition as g, type RolldownResolvedBuildConfig as h, type RollupResolvedBuildConfig as i, type TsupResolvedBuildConfig as j, type ViteResolvedBuildConfig as k, type PluginContext as l, type SourceFile as m, type MetaInfo as n, type TransformResult as o, type WorkerProcess as p, type ResolvedConfig as q, type EnvironmentContext as r, type InferHookReturnType as s, type UnbuildResolvedBuildConfig as t, type InferUnpluginVariant as u, type BuildPlugin as v, type InferResolvedConfig as w, type UnpluginBuildVariant as x, type InferUserConfig as y, type InitialUserConfig as z };
+export { type InferResolvedConfig as $, type APIContext as A, type InferHookReturnType as B, type Context as C, type SourceFile as D, type ESBuildResolvedBuildConfig as E, type TransformResult as F, type WorkerProcess as G, type HooksList as H, type InitialUserConfig as I, type PrepareInlineConfig as J, type CleanInlineConfig as K, type LogFn as L, type MakeDirectoryOptions as M, type NewInlineConfig as N, type BuildInlineConfig as O, type PowerlinesCommand as P, type LintInlineConfig as Q, type ResolvePathOptions as R, type SelectHooksOptions as S, type TsupBuildConfig as T, type UnbuildBuildConfig as U, type VirtualFileSystemInterface as V, type WriteFileData as W, type DocsInlineConfig as X, type DeployInlineConfig as Y, type UnpluginBuildVariant as Z, __VFS_PATCH__ as _, type VirtualFileMetadata as a, type InferUnpluginVariant as a0, type BuildPlugin as a1, type InferUserConfig as a2, type ResolveFSOptions as b, type WriteFileOptions as c, __VFS_REVERT__ as d, type WorkspaceConfig as e, type ParsedUserConfig as f, type ResolvedEntryTypeDefinition as g, type RolldownResolvedBuildConfig as h, type RollupResolvedBuildConfig as i, type TsupResolvedBuildConfig as j, type UnbuildResolvedBuildConfig as k, type ViteResolvedBuildConfig as l, type ResolvedConfig as m, type EnvironmentContext as n, type Plugin as o, type PluginContext as p, type EnvironmentResolvedConfig as q, type EnvironmentContextPlugin as r, type HookKeys as s, type InferHookHandler as t, type MetaInfo as u, type Resolver as v, type VirtualFile as w, type PowerlinesWriteFileOptions as x, type InitContextOptions as y, type InferHookParameters as z };