powerlines 0.23.2 → 0.23.4

package/dist/plugin-utils/{context-D1I2JQgs.d.ts → context-DRFZE3XI.d.ts}

@@ -2,7 +2,6 @@ import { EnvPaths } from '@stryke/env/get-env-paths';
 import { NonUndefined, MaybePromise, FunctionLike, DeepPartial as DeepPartial$1 } from '@stryke/types/base';
 import { PackageJson } from '@stryke/types/package-json';
 import { Jiti } from 'jiti';
-import { ParserOptions, ParseResult } from 'oxc-parser';
 import { Range } from 'semver';
 import { TransformResult, ExternalIdResult, HookFilter, UnpluginOptions, UnpluginContext, UnpluginBuildContext, UnpluginMessage } from 'unplugin';
 import { Format } from '@storm-software/build-tools/types';
@@ -11,10 +10,9 @@ import { StormWorkspaceConfig } from '@storm-software/config/types';
 import { TypeDefinition, TypeDefinitionParameter } from '@stryke/types/configuration';
 import { AssetGlob } from '@stryke/types/file';
 import { ResolvedPreviewOptions, PreviewOptions } from 'vite';
+import { PathLike, StatSyncOptions, Stats, RmDirOptions, RmOptions, Mode, MakeDirectoryOptions as MakeDirectoryOptions$1, PathOrFileDescriptor, WriteFileOptions as WriteFileOptions$1 } from 'node:fs';
 import { TsConfigJson, CompilerOptions } from '@stryke/types/tsconfig';
 import ts from 'typescript';
-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';
 import { ArrayValues } from '@stryke/types/array';
 
 type UnpluginBuildVariant = "rollup" | "webpack" | "rspack" | "vite" | "esbuild" | "farm" | "unloader" | "rolldown";
@@ -154,746 +152,769 @@ interface BuildConfig {
 }
 type BuildResolvedConfig = Omit<BuildConfig, "override">;
 
-declare const SUPPORTED_COMMANDS: readonly ["new", "clean", "prepare", "lint", "test", "build", "docs", "deploy", "finalize"];
-type CommandType = ArrayValues<typeof SUPPORTED_COMMANDS>;
-
-interface ResolvedEntryTypeDefinition extends TypeDefinition {
+declare const __VFS_PATCH__ = "__VFS_PATCH__";
+declare const __VFS_REVERT__ = "__VFS_REVERT__";
+type OutputModeType = "fs" | "virtual";
+interface VirtualFileMetadata {
     /**
-     * The user provided entry point in the source code
+     * The identifier for the file data.
      */
-    input: TypeDefinition;
+    id: string;
     /**
-     * An optional name to use in the package export during the build process
+     * The timestamp of the virtual file.
      */
-    output?: string;
-}
-type EnvironmentResolvedConfig = Omit<EnvironmentConfig, "consumer" | "mode" | "ssr" | "preview"> & Required<Pick<EnvironmentConfig, "consumer" | "mode" | "ssr">> & {
+    timestamp: number;
     /**
-     * The name of the environment
+     * The type of the file.
+     *
+     * @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.
      */
-    name: string;
+    type: string;
     /**
-     * Configuration options for the preview server
+     * The output mode of the file.
      */
-    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">> & {
+    mode: string;
     /**
-     * The configuration options that were provided inline to the Powerlines CLI.
+     * Additional metadata associated with the file.
      */
-    inlineConfig: InlineConfig<TUserConfig>;
+    properties: Record<string, string>;
+}
+interface VirtualFileData {
     /**
-     * The original configuration options that were provided by the user to the Powerlines process.
+     * The identifier for the file data.
      */
-    userConfig: TUserConfig;
+    id?: string;
     /**
-     * A string identifier for the Powerlines command being executed.
+     * The contents of the virtual file.
      */
-    command: NonUndefined<InlineConfig<TUserConfig>["command"]>;
+    code: string;
     /**
-     * The root directory of the project's source code
+     * The type of the file.
      *
-     * @defaultValue "\{projectRoot\}/src"
+     * @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.
+     * - `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.
      */
-    sourceRoot: NonUndefined<TUserConfig["sourceRoot"]>;
+    type?: string;
     /**
-     * The root directory of the project.
+     * The output mode of the file.
      */
-    projectRoot: NonUndefined<TUserConfig["root"]>;
+    mode?: string;
     /**
-     * The type of project being built.
+     * Additional metadata associated with the file.
      */
-    projectType: NonUndefined<TUserConfig["type"]>;
+    properties?: Record<string, string>;
+}
+interface VirtualFile extends Required<VirtualFileData>, VirtualFileMetadata {
     /**
-     * The output configuration options to use for the build process
+     * An additional name for the file.
      */
-    output: OutputResolvedConfig;
+    path: string;
     /**
-     * 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}.
+     * The timestamp of the virtual file.
      */
-    build: Omit<TUserConfig["build"], "override"> & Required<Pick<Required<TUserConfig["build"]>, "override">>;
+    timestamp: number;
+}
+interface ResolveFSOptions {
+    mode?: OutputModeType;
+}
+type MakeDirectoryOptions = (Mode | MakeDirectoryOptions$1) & ResolveFSOptions;
+interface PowerlinesWriteFileOptions extends ResolveFSOptions {
     /**
-     * The log level to use for the Powerlines processes.
+     * Should the file skip formatting before being written?
      *
-     * @defaultValue "info"
+     * @defaultValue false
      */
-    logLevel: "error" | "warn" | "info" | "debug" | "trace" | null;
-};
-
-interface PluginHookObject<THookFunction extends FunctionLike, TFilter extends keyof HookFilter = never> {
+    skipFormat?: boolean;
+}
+type NodeWriteFileOptions = WriteFileOptions$1;
+type WriteFileOptions = NodeWriteFileOptions | PowerlinesWriteFileOptions;
+type WriteFileData = string | NodeJS.ArrayBufferView | VirtualFileData;
+interface ResolvePathOptions extends ResolveFSOptions {
     /**
-     * The order in which the plugin should be applied.
+     * Should the resolved path include the file extension?
+     *
+     * @defaultValue true
      */
-    order?: "pre" | "post" | null | undefined;
+    withExtension?: boolean;
     /**
-     * A filter to determine when the hook should be called.
+     * The paths to search for the file.
      */
-    filter?: Pick<HookFilter, TFilter>;
+    paths?: string[];
     /**
-     * The hook function to be called.
+     * The type of the path to resolve.
      */
-    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;
+    pathType?: "file" | "directory";
 }
-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>> {
+interface VirtualFileSystemInterface {
     /**
-     * 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
-     *
-     * @param this - The build context.
-     * @param config - The partial configuration object to be modified.
-     * @returns A promise that resolves to a partial configuration object.
+     * Patches the File System to include the virtual file system (VFS) contents.
      */
-    config: (this: UnresolvedContext<TContext["config"]>) => MaybePromise<ConfigResult<TContext>>;
+    [__VFS_PATCH__]: () => void;
     /**
-     * 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
-     *
-     * @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.
+     * Reverts the virtual file system (VFS) to its previous state.
      */
-    configEnvironment: (this: TContext, name: string, environment: EnvironmentConfig) => MaybePromise<Partial<EnvironmentResolvedConfig> | undefined | null>;
+    [__VFS_REVERT__]: () => void;
     /**
-     * A hook that is called when the plugin is resolved.
-     *
-     * @see https://vitejs.dev/guide/api-plugin#configresolved
-     *
-     * @param this - The build context.
-     * @returns A promise that resolves when the hook is complete.
+     * The underlying file metadata.
      */
-    configResolved: (this: TContext) => MaybePromise<void>;
+    metadata: Record<string, VirtualFileMetadata | undefined>;
     /**
-     * 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 this - The build context.
-     * @param code - The source code to generate types for.
-     * @returns A promise that resolves when the hook is complete.
+     * A map of module ids to their file paths.
      */
-    generateTypes: (this: TContext, code: string) => MaybePromise<GenerateTypesResult | string | undefined | null>;
+    ids: Record<string, string>;
     /**
-     * A hook that is called at the start of the build process.
+     * Check if a path or id corresponds to a virtual file **(does not actually exists on disk)**.
      *
-     * @param this - The build context and unplugin build context.
-     * @returns A promise that resolves when the hook is complete.
+     * @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)**.
      */
-    buildStart: (this: BuildPluginContext<TContext["config"]> & TContext) => MaybePromise<void>;
+    isVirtual: (pathOrId: string, options?: ResolvePathOptions) => boolean;
     /**
-     * A hook that is called at the end of the build process.
+     * Check if a path or id corresponds to a file written to the file system **(actually exists on disk)**.
      *
-     * @param this - The build context and unplugin build context.
-     * @returns A promise that resolves when the hook is complete.
+     * @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)**.
      */
-    buildEnd: (this: BuildPluginContext<TContext["config"]> & TContext) => MaybePromise<void>;
+    isPhysical: (pathOrId: string, options?: ResolvePathOptions) => boolean;
     /**
-     * A hook that is called to transform the source code.
+     * Checks if a file exists 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 of the file to check.
+     * @returns `true` if the file exists, otherwise `false`.
      */
-    transform: (this: BuildPluginContext<TContext["config"]> & TContext, code: string, id: string) => MaybePromise<TransformResult>;
+    isFile: (path: string) => boolean;
     /**
-     * A hook that is called to load the source code.
+     * Checks if a directory exists 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 of the directory to check.
+     * @returns `true` if the directory exists, otherwise `false`.
      */
-    load: (this: BuildPluginContext<TContext["config"]> & TContext, id: string) => MaybePromise<TransformResult>;
+    isDirectory: (path: string) => boolean;
     /**
-     * A hook that is called to resolve the identifier of the source code.
+     * Checks if a file exists 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 pathOrId - The path or id of the file.
+     * @returns `true` if the file exists, otherwise `false`.
      */
-    resolveId: (this: BuildPluginContext<TContext["config"]> & TContext, id: string, importer: string | undefined, options: {
-        isEntry: boolean;
-    }) => MaybePromise<string | ExternalIdResult | null | undefined>;
+    existsSync: (pathOrId: string) => boolean;
     /**
-     * A hook that is called to write the bundle to disk.
+     * Gets the metadata of a file in the virtual file system (VFS).
      *
-     * @param this - The build context.
-     * @returns A promise that resolves when the hook is complete.
+     * @param pathOrId - The path or id of the file.
+     * @returns The metadata of the file if it exists, otherwise undefined.
      */
-    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]>;
-} & {
+    getMetadata: (pathOrId: PathLike) => VirtualFileMetadata | undefined;
     /**
-     * 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.
+     * @param options - Optional parameters for getting the stats.
+     * @returns The stats of the file if it exists, otherwise undefined.
      */
-    config: PluginHook<(this: UnresolvedContext<TContext["config"]>) => MaybePromise<ConfigResult<TContext>>> | ConfigResult<TContext>;
+    lstat: (pathOrId: string, options?: StatSyncOptions & {
+        bigint?: false | undefined;
+        throwIfNoEntry: false;
+    }) => Promise<Stats>;
     /**
-     * A hook that is called to transform the source code.
+     * Gets the stats of a file 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 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.
      */
-    transform: PluginHook<(this: BuildPluginContext<TContext["config"]> & TContext, code: string, id: string) => MaybePromise<TransformResult>, "code" | "id">;
+    lstatSync: (pathOrId: string, options?: StatSyncOptions & {
+        bigint?: false | undefined;
+        throwIfNoEntry: false;
+    }) => Stats | undefined;
     /**
-     * A hook that is called to load the source code.
+     * Gets the stats of a file 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 pathOrId - The path or id of the file.
+     * @returns The stats of the file if it exists, otherwise false.
      */
-    load: PluginHook<(this: BuildPluginContext<TContext["config"]> & TContext, id: string) => MaybePromise<TransformResult>, "id">;
+    stat: (pathOrId: string, options?: StatSyncOptions & {
+        bigint?: false | undefined;
+        throwIfNoEntry: false;
+    }) => Promise<Stats>;
     /**
-     * A hook that is called to resolve the identifier of the source code.
+     * Gets the stats of a file 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 pathOrId - The path or id of the file.
+     * @returns The stats of the file if it exists, otherwise false.
      */
-    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> {
+    statSync: (pathOrId: string, options?: StatSyncOptions & {
+        bigint?: false | undefined;
+        throwIfNoEntry: false;
+    }) => Stats | undefined;
     /**
-     * The name of the plugin, for use in deduplication, error messages and logs.
+     * 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.
      */
-    name: string;
+    readdirSync: (path: string, options?: {
+        encoding: BufferEncoding | null;
+        withFileTypes?: false | undefined;
+        recursive?: boolean | undefined;
+    } | BufferEncoding) => string[];
     /**
-     * Enforce plugin invocation tier similar to webpack loaders. Hooks ordering is still subject to the `order` property in the hook object.
+     * Lists files in a given path.
      *
-     * @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 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.
+     */
+    readdir: (path: string, options?: {
+        encoding: BufferEncoding | null;
+        withFileTypes?: false | undefined;
+        recursive?: boolean | undefined;
+    } | BufferEncoding) => Promise<string[]>;
+    /**
+     * Removes a file or symbolic link in the virtual file system (VFS).
      *
-     * @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 path - The path to the file to remove.
+     * @returns A promise that resolves when the file is removed.
      */
-    enforce?: "pre" | "post";
+    unlinkSync: (path: PathLike, options?: ResolveFSOptions) => void;
     /**
-     * A function to determine if two plugins are the same and can be de-duplicated.
+     * Asynchronously removes a file or symbolic link in the virtual file system (VFS).
      *
-     * @remarks
-     * If this is not provided, plugins are de-duplicated by comparing their names.
+     * @param path - The path to the file to remove.
+     * @returns A promise that resolves when the file is removed.
+     */
+    unlink: (path: string, options?: ResolveFSOptions) => Promise<void>;
+    /**
+     * Removes a directory in the virtual file system (VFS).
      *
-     * @param other - The other plugin to compare against.
-     * @returns `true` if the two plugins are the same, `false` otherwise.
+     * @param path - The path to create the directory at.
+     * @param options - Options for creating the directory.
      */
-    dedupe?: false | ((other: Plugin<any>) => boolean);
+    rmdirSync: (path: PathLike, options?: RmDirOptions & ResolveFSOptions) => any;
     /**
-     * A list of pre-requisite plugins that must be loaded before this plugin can be used.
+     * Removes a directory in the virtual file system (VFS).
+     *
+     * @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.
      */
-    dependsOn?: PluginConfig<any>[];
+    rmdir: (path: PathLike, options?: RmDirOptions & ResolveFSOptions) => Promise<void>;
     /**
-     * Define environments where this plugin should be active. By default, the plugin is active in all environments.
+     * Removes a file or directory in the virtual file system (VFS).
      *
-     * @param environment - The environment to check.
-     * @returns `true` if the plugin should be active in the specified environment, `false` otherwise.
+     * @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.
      */
-    applyToEnvironment?: (environment: EnvironmentResolvedConfig) => MaybePromise<boolean | Plugin<any>>;
-}
-
-type ReflectionMode = "default" | "explicit" | "never";
-type RawReflectionMode = ReflectionMode | "" | boolean | string | string[] | undefined;
-/**
- * Defines the level of reflection to be used during the transpilation process.
- *
- * @remarks
- * The level determines how much extra data is captured in the byte code for each type. This can be one of the following values:
- * - `minimal` - Only the essential type information is captured.
- * - `normal` - Additional type information is captured, including some contextual data.
- * - `verbose` - All available type information is captured, including detailed contextual data.
- */
-type ReflectionLevel = "minimal" | "normal" | "verbose";
-interface DeepkitOptions {
+    rm: (path: PathLike, options?: RmOptions & ResolveFSOptions) => Promise<void>;
     /**
-     * Either true to activate reflection for all files compiled using this tsconfig,
-     * or a list of globs/file paths relative to this tsconfig.json.
-     * Globs/file paths can be prefixed with a ! to exclude them.
+     * Synchronously removes a file or directory in the virtual file system (VFS).
+     *
+     * @param path - The path to the file or directory to remove.
+     * @param options - Options for removing the file or directory.
      */
-    reflection?: RawReflectionMode;
+    rmSync: (path: PathLike, options?: RmOptions & ResolveFSOptions) => void;
     /**
-     * Defines the level of reflection to be used during the transpilation process.
+     * Creates a directory in the virtual file system (VFS).
      *
-     * @remarks
-     * The level determines how much extra data is captured in the byte code for each type. This can be one of the following values:
-     * - `minimal` - Only the essential type information is captured.
-     * - `normal` - Additional type information is captured, including some contextual data.
-     * - `verbose` - All available type information is captured, including detailed contextual data.
+     * @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.
      */
-    reflectionLevel?: ReflectionLevel;
-}
-type TSCompilerOptions = CompilerOptions & DeepkitOptions;
-/**
- * The TypeScript compiler configuration.
- *
- * @see https://www.typescriptlang.org/docs/handbook/tsconfig-json.html
- */
-interface TSConfig extends Omit<TsConfigJson, "reflection"> {
+    mkdirSync: (path: PathLike, options?: MakeDirectoryOptions) => string | undefined;
     /**
-     * Either true to activate reflection for all files compiled using this tsconfig,
-     * or a list of globs/file paths relative to this tsconfig.json.
-     * Globs/file paths can be prefixed with a ! to exclude them.
+     * Creates a directory in the virtual file system (VFS).
+     *
+     * @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.
      */
-    reflection?: RawReflectionMode;
+    mkdir: (path: PathLike, options?: MakeDirectoryOptions) => Promise<string | undefined>;
     /**
-     * Defines the level of reflection to be used during the transpilation process.
+     * Reads a file from the virtual file system (VFS).
      *
-     * @remarks
-     * The level determines how much extra data is captured in the byte code for each type. This can be one of the following values:
-     * - `minimal` - Only the essential type information is captured.
-     * - `normal` - Additional type information is captured, including some contextual data.
-     * - `verbose` - All available type information is captured, including detailed contextual data.
+     * @param pathOrId - The path or id of the file.
+     * @returns The contents of the file if it exists, otherwise undefined.
      */
-    reflectionLevel?: ReflectionLevel;
+    readFile: (pathOrId: string) => Promise<string | undefined>;
     /**
-     * Instructs the TypeScript compiler how to compile `.ts` files.
+     * Reads a file from the virtual file system (VFS).
+     *
+     * @param pathOrId - The path or id of the file.
      */
-    compilerOptions?: TSCompilerOptions;
-}
-type ParsedTypeScriptConfig = ts.ParsedCommandLine & {
-    originalTsconfigJson: TsConfigJson;
-    tsconfigJson: TSConfig;
-    tsconfigFilePath: string;
-};
-
-declare const __VFS_PATCH__ = "__VFS_PATCH__";
-declare const __VFS_REVERT__ = "__VFS_REVERT__";
-type OutputModeType = "fs" | "virtual";
-interface VirtualFile {
+    readFileSync: (pathOrId: string) => string | undefined;
     /**
-     * The unique identifier for the virtual file.
+     * Writes a file to the virtual file system (VFS).
      *
-     * @remarks
-     * If no specific id is provided, it defaults to the file's {@link path}.
+     * @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.
      */
-    id: string;
+    writeFile: (path: PathOrFileDescriptor, data?: WriteFileData, options?: WriteFileOptions) => Promise<void>;
     /**
-     * Additional metadata associated with the virtual file.
+     * Writes a file to the virtual file system (VFS).
+     *
+     * @param path - The path to the file.
+     * @param data - The contents of the file.
+     * @param options - Optional parameters for writing the file.
      */
-    details: Record<string, PrimitiveJsonValue>;
+    writeFileSync: (path: PathOrFileDescriptor, data?: WriteFileData, options?: WriteFileOptions) => void;
     /**
-     * The variant of the file.
+     * Moves a file from one path to another in the virtual file system (VFS).
      *
-     * @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.
+     * @param srcPath - The source path to move
+     * @param destPath - The destination path to move to
      */
-    variant: string;
+    move: (srcPath: string, destPath: string) => Promise<void>;
     /**
-     * The output mode of the file.
+     * Synchronously moves a file from one path to another in the virtual file system (VFS).
      *
-     * @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`).
+     * @param srcPath - The source path to move
+     * @param destPath - The destination path to move to
      */
-    mode: OutputModeType;
+    moveSync: (srcPath: string, destPath: string) => void;
     /**
-     * A virtual (or actual) path to the file in the file system.
+     * 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
      */
-    path: string;
+    copy: (srcPath: string, destPath: string) => Promise<void>;
     /**
-     * The contents of the file.
+     * Synchronously copies a file from one path to another in the virtual file system (VFS).
+     *
+     * @param srcPath - The source path to copy
+     * @param destPath - The destination path to copy to
      */
-    code: string | NodeJS.ArrayBufferView;
-}
-interface VirtualFileMetadata {
+    copySync: (srcPath: string, destPath: string) => void;
     /**
-     * The identifier for the file data.
+     * 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)
      */
-    id: string;
+    glob: (pattern: string | string[]) => Promise<string[]>;
     /**
-     * The variant of the file.
+     * 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)
      */
-    variant: string;
+    globSync: (pattern: string | string[]) => string[];
     /**
-     * The output mode of the file.
+     * 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.
+     * @param options - Optional parameters for resolving the path.
+     * @returns The resolved path of the file if it exists, otherwise false.
      */
-    mode: string;
+    resolve: (pathOrId: string, options?: ResolvePathOptions) => string | false;
     /**
-     * Additional metadata associated with the file.
+     * Formats a path to match the virtual file system (VFS) structure.
+     *
+     * @param path - The path to format.
+     * @returns The formatted path.
      */
-    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 {
+    formatPath: (path: string) => string;
     /**
-     * Should the resolved path include the file extension?
+     * Resolves a path or id to a file path in the virtual file system.
      *
-     * @defaultValue true
+     * @param pathOrId - The path or id of the file to resolve.
+     * @returns The resolved path of the file if it exists, otherwise false.
      */
-    withExtension?: boolean;
+    realpathSync: (pathOrId: string) => string;
     /**
-     * The paths to search for the file.
+     * Disposes of the virtual file system (VFS), writes any virtual file changes to disk, and releases any associated resources.
      */
-    paths?: string[];
+    dispose: () => Promise<void>;
+}
+
+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 type of the path to resolve.
+     * The user provided entry point in the source code
      */
-    type?: "file" | "directory";
+    input: TypeDefinition;
+    /**
+     * An optional name to use in the package export during the build process
+     */
+    output?: string;
 }
-interface VirtualFileSystemInterface {
+type EnvironmentResolvedConfig = Omit<EnvironmentConfig, "consumer" | "mode" | "ssr" | "preview"> & Required<Pick<EnvironmentConfig, "consumer" | "mode" | "ssr">> & {
     /**
-     * Patches the File System to include the virtual file system (VFS) contents.
+     * The name of the environment
      */
-    [__VFS_PATCH__]: () => void;
+    name: string;
     /**
-     * Reverts the virtual file system (VFS) to its previous state.
+     * Configuration options for the preview server
      */
-    [__VFS_REVERT__]: () => void;
+    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">> & {
     /**
-     * The underlying file metadata.
+     * The configuration options that were provided inline to the Powerlines CLI.
      */
-    metadata: Record<string, VirtualFileMetadata | undefined>;
+    inlineConfig: InlineConfig<TUserConfig>;
     /**
-     * A map of module ids to their file paths.
+     * The original configuration options that were provided by the user to the Powerlines process.
      */
-    ids: Record<string, string>;
+    userConfig: TUserConfig;
     /**
-     * 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)**.
+     * A string identifier for the Powerlines command being executed.
      */
-    isVirtual: (pathOrId: string, options?: ResolvePathOptions) => boolean;
+    command: NonUndefined<InlineConfig<TUserConfig>["command"]>;
     /**
-     * Check if a path or id corresponds to a file written to the file system **(actually exists on disk)**.
+     * The root directory of the project's source code
      *
-     * @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)**.
+     * @defaultValue "\{projectRoot\}/src"
      */
-    isPhysical: (pathOrId: string, options?: ResolvePathOptions) => boolean;
+    sourceRoot: NonUndefined<TUserConfig["sourceRoot"]>;
     /**
-     * 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 root directory of the project.
      */
-    isFile: (path: string) => boolean;
+    projectRoot: NonUndefined<TUserConfig["root"]>;
     /**
-     * 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 type of project being built.
      */
-    isDirectory: (path: string) => boolean;
+    projectType: NonUndefined<TUserConfig["type"]>;
     /**
-     * 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`.
+     * The output configuration options to use for the build process
      */
-    existsSync: (pathOrId: string) => boolean;
+    output: OutputResolvedConfig;
     /**
-     * Gets the metadata 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 metadata of the file if it exists, otherwise undefined.
+     * @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}.
      */
-    getMetadata: (pathOrId: PathLike) => VirtualFileMetadata | undefined;
+    build: Omit<TUserConfig["build"], "override"> & Required<Pick<Required<TUserConfig["build"]>, "override">>;
     /**
-     * Gets the stats of a file in the virtual file system (VFS).
+     * The log level to use for the Powerlines processes.
      *
-     * @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.
+     * @defaultValue "info"
      */
-    lstat: (pathOrId: string, options?: StatSyncOptions & {
-        bigint?: false | undefined;
-        throwIfNoEntry: false;
-    }) => Promise<Stats>;
+    logLevel: "error" | "warn" | "info" | "debug" | "trace" | null;
+};
+
+interface PluginHookObject<THookFunction extends FunctionLike, TFilter extends keyof HookFilter = never> {
     /**
-     * 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 order in which the plugin should be applied.
      */
-    lstatSync: (pathOrId: string, options?: StatSyncOptions & {
-        bigint?: false | undefined;
-        throwIfNoEntry: false;
-    }) => Stats | undefined;
+    order?: "pre" | "post" | null | undefined;
     /**
-     * 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.
+     * A filter to determine when the hook should be called.
      */
-    stat: (pathOrId: string, options?: StatSyncOptions & {
-        bigint?: false | undefined;
-        throwIfNoEntry: false;
-    }) => Promise<Stats>;
+    filter?: Pick<HookFilter, TFilter>;
     /**
-     * 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 hook function to be called.
      */
-    statSync: (pathOrId: string, options?: StatSyncOptions & {
-        bigint?: false | undefined;
-        throwIfNoEntry: false;
-    }) => Stats | undefined;
+    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>> {
     /**
-     * Lists files in a given path.
+     * A function that returns configuration options to be merged with the build context's options.
      *
-     * @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.
+     * @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.
      */
-    readdirSync: (path: string, options?: {
-        encoding: BufferEncoding | null;
-        withFileTypes?: false | undefined;
-        recursive?: boolean | undefined;
-    } | BufferEncoding) => string[];
+    config: (this: UnresolvedContext<TContext["config"]>) => MaybePromise<ConfigResult<TContext>>;
     /**
-     * Lists files in a given path.
+     * 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 list files from.
-     * @param options - Options for listing files, such as encoding and recursion.
-     * @returns An array of file names in the specified path.
+     * @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.
      */
-    readdir: (path: string, options?: {
-        encoding: BufferEncoding | null;
-        withFileTypes?: false | undefined;
-        recursive?: boolean | undefined;
-    } | BufferEncoding) => Promise<string[]>;
+    configEnvironment: (this: TContext, name: string, environment: EnvironmentConfig) => MaybePromise<Partial<EnvironmentResolvedConfig> | undefined | null>;
     /**
-     * Removes a file or symbolic link in the virtual file system (VFS).
+     * A hook that is called when the plugin is resolved.
      *
-     * @param path - The path to the file to remove.
-     * @returns A promise that resolves when the file 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.
      */
-    unlinkSync: (path: PathLike, options?: ResolveFSOptions) => void;
+    configResolved: (this: TContext) => MaybePromise<void>;
     /**
-     * Asynchronously removes a file or symbolic link 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 to remove.
-     * @returns A promise that resolves when the file is removed.
+     * @param this - The build context.
+     * @param code - The source code to generate types for.
+     * @returns A promise that resolves when the hook is complete.
      */
-    unlink: (path: string, options?: ResolveFSOptions) => Promise<void>;
+    generateTypes: (this: TContext, code: string) => MaybePromise<GenerateTypesResult | string | undefined | null>;
     /**
-     * Removes 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.
+     * @param this - The build context and unplugin build context.
+     * @returns A promise that resolves when the hook is complete.
      */
-    rmdirSync: (path: PathLike, options?: RmDirOptions & ResolveFSOptions) => any;
+    buildStart: (this: BuildPluginContext<TContext["config"]> & TContext) => MaybePromise<void>;
     /**
-     * Removes 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.
      */
-    rmdir: (path: PathLike, options?: RmDirOptions & ResolveFSOptions) => Promise<void>;
+    buildEnd: (this: BuildPluginContext<TContext["config"]> & TContext) => MaybePromise<void>;
     /**
-     * Removes a file or directory in the virtual file system (VFS).
+     * A hook that is called to transform the source code.
      *
-     * @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.
+     * @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.
      */
-    rm: (path: PathLike, options?: RmOptions & ResolveFSOptions) => Promise<void>;
+    transform: (this: BuildPluginContext<TContext["config"]> & TContext, code: string, id: string) => MaybePromise<TransformResult>;
     /**
-     * Synchronously removes a file or directory in the virtual file system (VFS).
+     * A hook that is called to load the source code.
      *
-     * @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, unplugin build context, and unplugin context.
+     * @param id - The identifier of the source code.
+     * @returns A promise that resolves when the hook is complete.
      */
-    rmSync: (path: PathLike, options?: RmOptions & ResolveFSOptions) => void;
+    load: (this: BuildPluginContext<TContext["config"]> & TContext, id: string) => MaybePromise<TransformResult>;
     /**
-     * Creates a directory in the virtual file system (VFS).
+     * A hook that is called to resolve the identifier of the source code.
      *
-     * @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, 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.
      */
-    mkdirSync: (path: PathLike, options?: MakeDirectoryOptions) => string | undefined;
+    resolveId: (this: BuildPluginContext<TContext["config"]> & TContext, id: string, importer: string | undefined, options: {
+        isEntry: boolean;
+    }) => MaybePromise<string | ExternalIdResult | null | undefined>;
     /**
-     * Creates a directory in the virtual file system (VFS).
+     * A hook that is called to write the bundle to disk.
      *
-     * @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.
+     * @returns A promise that resolves when the hook is complete.
      */
-    mkdir: (path: PathLike, options?: MakeDirectoryOptions) => Promise<string | undefined>;
+    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]>;
+} & {
     /**
-     * Reads a file from the virtual file system (VFS).
+     * A function that returns configuration options to be merged with the build context's options.
      *
-     * @param pathOrId - The path or id of the file.
-     * @returns The contents of the file if it exists, otherwise undefined.
+     * @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.
      */
-    readFile: (pathOrId: string) => Promise<string | undefined>;
+    config: PluginHook<(this: UnresolvedContext<TContext["config"]>) => MaybePromise<ConfigResult<TContext>>> | ConfigResult<TContext>;
     /**
-     * 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.
+     * @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.
      */
-    readFileSync: (pathOrId: string) => string | undefined;
+    transform: PluginHook<(this: BuildPluginContext<TContext["config"]> & TContext, code: string, id: string) => MaybePromise<TransformResult>, "code" | "id">;
     /**
-     * Writes a file to the virtual file system (VFS).
+     * A hook that is called to load 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.
+     * @returns A promise that resolves when the hook is complete.
      */
-    writeFile: (path: PathOrFileDescriptor, data?: WriteFileData, options?: WriteFileOptions) => Promise<void>;
+    load: PluginHook<(this: BuildPluginContext<TContext["config"]> & TContext, id: string) => MaybePromise<TransformResult>, "id">;
     /**
-     * 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.
+     * @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.
      */
-    writeFileSync: (path: PathOrFileDescriptor, data?: WriteFileData, options?: WriteFileOptions) => void;
+    resolveId: PluginHook<(this: BuildPluginContext<TContext["config"]> & TContext, id: string, importer: string | undefined, options: {
+        isEntry: boolean;
+    }) => MaybePromise<string | ExternalIdResult | null | undefined>, "id">;
     /**
-     * Moves a file from one path to another in the virtual file system (VFS).
+     * An API object that can be used for inter-plugin communication.
      *
-     * @param srcPath - The source path to move
-     * @param destPath - The destination path to move to
+     * @see https://rollupjs.org/plugin-development/#direct-plugin-communication
      */
-    move: (srcPath: string, destPath: string) => Promise<void>;
+    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 moves a file from one path to another in the virtual file system (VFS).
-     *
-     * @param srcPath - The source path to move
-     * @param destPath - The destination path to move to
+     * The name of the plugin, for use in deduplication, error messages and logs.
      */
-    moveSync: (srcPath: string, destPath: string) => void;
+    name: string;
     /**
-     * Copies a file from one path to another in the virtual file system (VFS).
+     * Enforce plugin invocation tier similar to webpack loaders. Hooks ordering is still subject to the `order` property in the hook object.
      *
-     * @param srcPath - The source path to copy
-     * @param destPath - The destination path to copy to
+     * @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
      */
-    copy: (srcPath: string, destPath: string) => Promise<void>;
+    enforce?: "pre" | "post";
     /**
-     * Synchronously copies a file from one path to another in the virtual file system (VFS).
+     * A function to determine if two plugins are the same and can be de-duplicated.
      *
-     * @param srcPath - The source path to copy
-     * @param destPath - The destination path to copy to
+     * @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.
      */
-    copySync: (srcPath: string, destPath: string) => void;
+    dedupe?: false | ((other: Plugin<any>) => boolean);
     /**
-     * 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)
+     * A list of pre-requisite plugins that must be loaded before this plugin can be used.
      */
-    glob: (pattern: string | string[]) => Promise<string[]>;
+    dependsOn?: PluginConfig<any>[];
     /**
-     * Synchronously glob files in the virtual file system (VFS) based on the provided pattern(s).
+     * Define environments where this plugin should be active. By default, the plugin is active in all environments.
      *
-     * @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)
+     * @param environment - The environment to check.
+     * @returns `true` if the plugin should be active in the specified environment, `false` otherwise.
      */
-    globSync: (pattern: string | string[]) => string[];
+    applyToEnvironment?: (environment: EnvironmentResolvedConfig) => MaybePromise<boolean | Plugin<any>>;
+}
+
+type ReflectionMode = "default" | "explicit" | "never";
+type RawReflectionMode = ReflectionMode | "" | boolean | string | string[] | undefined;
+/**
+ * Defines the level of reflection to be used during the transpilation process.
+ *
+ * @remarks
+ * The level determines how much extra data is captured in the byte code for each type. This can be one of the following values:
+ * - `minimal` - Only the essential type information is captured.
+ * - `normal` - Additional type information is captured, including some contextual data.
+ * - `verbose` - All available type information is captured, including detailed contextual data.
+ */
+type ReflectionLevel = "minimal" | "normal" | "verbose";
+interface DeepkitOptions {
     /**
-     * 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.
-     * @param options - Optional parameters for resolving the path.
-     * @returns The resolved path of the file if it exists, otherwise false.
+     * Either true to activate reflection for all files compiled using this tsconfig,
+     * or a list of globs/file paths relative to this tsconfig.json.
+     * Globs/file paths can be prefixed with a ! to exclude them.
      */
-    resolve: (pathOrId: string, options?: ResolvePathOptions) => string | false;
+    reflection?: RawReflectionMode;
     /**
-     * Formats a path to match the virtual file system (VFS) structure.
+     * Defines the level of reflection to be used during the transpilation process.
      *
-     * @param path - The path to format.
-     * @returns The formatted path.
+     * @remarks
+     * The level determines how much extra data is captured in the byte code for each type. This can be one of the following values:
+     * - `minimal` - Only the essential type information is captured.
+     * - `normal` - Additional type information is captured, including some contextual data.
+     * - `verbose` - All available type information is captured, including detailed contextual data.
      */
-    formatPath: (path: string) => string;
+    reflectionLevel?: ReflectionLevel;
+}
+type TSCompilerOptions = CompilerOptions & DeepkitOptions;
+/**
+ * The TypeScript compiler configuration.
+ *
+ * @see https://www.typescriptlang.org/docs/handbook/tsconfig-json.html
+ */
+interface TSConfig extends Omit<TsConfigJson, "reflection"> {
     /**
-     * Resolves a path or id to a file path in the virtual file system.
+     * Either true to activate reflection for all files compiled using this tsconfig,
+     * or a list of globs/file paths relative to this tsconfig.json.
+     * Globs/file paths can be prefixed with a ! to exclude them.
+     */
+    reflection?: RawReflectionMode;
+    /**
+     * Defines the level of reflection to be used during the transpilation process.
      *
-     * @param pathOrId - The path or id of the file to resolve.
-     * @returns The resolved path of the file if it exists, otherwise false.
+     * @remarks
+     * The level determines how much extra data is captured in the byte code for each type. This can be one of the following values:
+     * - `minimal` - Only the essential type information is captured.
+     * - `normal` - Additional type information is captured, including some contextual data.
+     * - `verbose` - All available type information is captured, including detailed contextual data.
      */
-    realpathSync: (pathOrId: string) => string;
+    reflectionLevel?: ReflectionLevel;
     /**
-     * Disposes of the virtual file system (VFS), writes any virtual file changes to disk, and releases any associated resources.
+     * Instructs the TypeScript compiler how to compile `.ts` files.
      */
-    dispose: () => Promise<void>;
+    compilerOptions?: TSCompilerOptions;
 }
+type ParsedTypeScriptConfig = ts.ParsedCommandLine & {
+    originalTsconfigJson: TsConfigJson;
+    tsconfigJson: TSConfig;
+    tsconfigFilePath: string;
+};
 
 type LogFn = (type: LogLevelLabel, ...args: string[]) => void;
 /**
@@ -1371,7 +1392,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
      *
@@ -1379,11 +1400,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
      */