vite 6.0.0-alpha.17 → 6.0.0-alpha.19

package/dist/node/index.d.ts

@@ -1,10 +1,10 @@
 /// <reference types="node" />
-import { PluginHooks, RollupError, SourceMap, ModuleInfo, PartialResolvedId, RollupOptions, WatcherOptions, InputOption, ModuleFormat, RollupOutput, RollupWatcher, InputOptions, CustomPluginOptions, SourceDescription, LoadResult, SourceMapInput, ExistingRawSourceMap, OutputBundle, OutputChunk, ObjectHook, ResolveIdResult, GetManualChunk } from 'rollup';
+import { PluginHooks, RollupError, SourceMap, ModuleInfo, PartialResolvedId, RollupOptions, WatcherOptions, InputOption, ModuleFormat, RollupOutput, RollupWatcher, MinimalPluginContext, InputOptions, CustomPluginOptions, LoadResult, SourceDescription, SourceMapInput, ExistingRawSourceMap, OutputBundle, OutputChunk, ObjectHook, ResolveIdResult, GetManualChunk } from 'rollup';
 import * as rollup from 'rollup';
 export { rollup as Rollup };
 export { parseAst, parseAstAsync } from 'rollup/parseAst';
 import * as http from 'node:http';
-import { OutgoingHttpHeaders, Server, ClientRequestArgs, IncomingMessage, ClientRequest, Agent, ServerResponse } from 'node:http';
+import { OutgoingHttpHeaders, ClientRequestArgs, IncomingMessage, ClientRequest, Agent, Server, ServerResponse } from 'node:http';
 import { Http2SecureServer } from 'node:http2';
 import * as fs from 'node:fs';
 import * as events from 'node:events';
@@ -15,12 +15,12 @@ import * as url from 'node:url';
 import { URL } from 'node:url';
 import * as stream from 'node:stream';
 import { Duplex, DuplexOptions } from 'node:stream';
-import { FetchResult, ModuleRunnerOptions, ModuleRunnerHMRConnection, ModuleRunnerHmr, ModuleEvaluator, ModuleRunner } from 'vite/module-runner';
+import { FetchResult, FetchFunctionOptions, ModuleRunnerOptions, ModuleRunnerHMRConnection, ModuleRunnerHmr, ModuleEvaluator, ModuleRunner } from 'vite/module-runner';
 export { FetchFunction, FetchResult } from 'vite/module-runner';
 import { BuildOptions as esbuild_BuildOptions, TransformOptions as esbuild_TransformOptions, TransformResult as esbuild_TransformResult } from 'esbuild';
 export { TransformOptions as EsbuildTransformOptions, version as esbuildVersion } from 'esbuild';
 import { HotPayload, CustomPayload } from '../../types/hotPayload.js';
-export { ConnectedPayload, CustomPayload, ErrorPayload, FullReloadPayload, HotPayload, PrunePayload, Update, UpdatePayload } from '../../types/hotPayload.js';
+export { ConnectedPayload, CustomPayload, ErrorPayload, FullReloadPayload, HMRPayload, HotPayload, PrunePayload, Update, UpdatePayload } from '../../types/hotPayload.js';
 import { InferCustomEventPayload } from '../../types/customEvent.js';
 export { CustomEventMap, InferCustomEventPayload, InvalidatePayload } from '../../types/customEvent.js';
 import { SecureContextOptions } from 'node:tls';
@@ -412,6 +412,7 @@ declare namespace HttpProxy {
      * @param req - Client request.
      * @param res - Client response.
      * @param options - Additional options.
+     * @param callback - Error callback.
      */
     web(
       req: http.IncomingMessage,
@@ -426,6 +427,7 @@ declare namespace HttpProxy {
      * @param socket - Client socket.
      * @param head - Client head.
      * @param options - Additional options.
+     * @param callback - Error callback.
      */
     ws(
       req: http.IncomingMessage,
@@ -616,6 +618,12 @@ interface ProxyOptions extends HttpProxy.ServerOptions {
      * webpack-dev-server style bypass function
      */
     bypass?: (req: http.IncomingMessage, res: http.ServerResponse, options: ProxyOptions) => void | null | undefined | false | string;
+    /**
+     * rewrite the Origin header of a WebSocket request to match the the target
+     *
+     * **Exercise caution as rewriting the Origin can leave the proxying open to [CSRF attacks](https://owasp.org/www-community/attacks/csrf).**
+     */
+    rewriteWsOrigin?: boolean | undefined;
 }
 
 type LogType = 'error' | 'warn' | 'info';
@@ -785,10 +793,15 @@ type CLIShortcut<Server = ViteDevServer | PreviewServer> = {
 
 declare class PartialEnvironment {
     name: string;
-    config: ResolvedConfig;
-    options: ResolvedEnvironmentOptions;
+    getTopLevelConfig(): ResolvedConfig;
+    config: ResolvedConfig & ResolvedEnvironmentOptions;
+    /**
+     * @deprecated use environment.config instead
+     **/
+    get options(): ResolvedEnvironmentOptions;
+    _options: ResolvedEnvironmentOptions;
     logger: Logger;
-    constructor(name: string, config: ResolvedConfig, options?: ResolvedEnvironmentOptions);
+    constructor(name: string, topLevelConfig: ResolvedConfig, options?: ResolvedEnvironmentOptions);
 }
 declare class BaseEnvironment extends PartialEnvironment {
     get plugins(): Plugin[];
@@ -803,6 +816,7 @@ declare class FutureCompatEnvironment extends BaseEnvironment {
 }
 
 interface FetchModuleOptions {
+    cached?: boolean;
     inlineSourceMap?: boolean;
     processSourceMap?<T extends NonNullable<TransformResult['map']>>(map: T): T;
 }
@@ -997,7 +1011,7 @@ interface TransformResult {
 }
 interface TransformOptions {
     /**
-     * @deprecated infered from environment
+     * @deprecated inferred from environment
      */
     ssr?: boolean;
     /**
@@ -1074,7 +1088,7 @@ declare class EnvironmentModuleGraph {
 }
 
 /**
- * Backward compatible ModuleNode and ModuleGraph with mixed nodes from both the client and ssr enviornments
+ * Backward compatible ModuleNode and ModuleGraph with mixed nodes from both the client and ssr environments
  * It would be good to take the types names for the new EnvironmentModuleNode and EnvironmentModuleGraph but we can't
  * do that at this point without breaking to much code in the ecosystem.
  * We are going to deprecate these types and we can try to use them back in the future.
@@ -1122,30 +1136,18 @@ declare class ModuleGraph {
         client: () => EnvironmentModuleGraph;
         ssr: () => EnvironmentModuleGraph;
     });
-    /** @deprecated */
     getModuleById(id: string): ModuleNode | undefined;
-    /** @deprecated */
     getModuleByUrl(url: string, ssr?: boolean): Promise<ModuleNode | undefined>;
-    /** @deprecated */
     getModulesByFile(file: string): Set<ModuleNode> | undefined;
-    /** @deprecated */
     onFileChange(file: string): void;
-    /** @deprecated */
     onFileDelete(file: string): void;
-    /** @deprecated */
     invalidateModule(mod: ModuleNode, seen?: Set<ModuleNode>, timestamp?: number, isHmr?: boolean, 
     ): void;
-    /** @deprecated */
     invalidateAll(): void;
-    /** @deprecated */
     ensureEntryFromUrl(rawUrl: string, ssr?: boolean, setIsSelfAccepting?: boolean): Promise<ModuleNode>;
-    /** @deprecated */
     createFileOnlyEntry(file: string): ModuleNode;
-    /** @deprecated */
     resolveUrl(url: string, ssr?: boolean): Promise<ResolvedUrl>;
-    /** @deprecated */
     updateModuleTransformResult(mod: ModuleNode, result: TransformResult | null, ssr?: boolean): void;
-    /** @deprecated */
     getModuleByEtag(etag: string): ModuleNode | undefined;
     getBackwardCompatibleBrowserModuleNode(clientModule: EnvironmentModuleNode): ModuleNode;
     getBackwardCompatibleServerModuleNode(ssrModule: EnvironmentModuleNode): ModuleNode;
@@ -1162,21 +1164,20 @@ interface HmrOptions {
     path?: string;
     timeout?: number;
     overlay?: boolean;
-    server?: Server;
+    server?: HttpServer;
 }
-interface HotUpdateContext {
+interface HotUpdateOptions {
     type: 'create' | 'update' | 'delete';
     file: string;
     timestamp: number;
     modules: Array<EnvironmentModuleNode>;
     read: () => string | Promise<string>;
     server: ViteDevServer;
+    /**
+     * @deprecated use this.environment in the hotUpdate hook instead
+     **/
     environment: DevEnvironment;
 }
-/**
- * @deprecated
- * Used by handleHotUpdate for backward compatibility with mixed client and ssr moduleGraph
- **/
 interface HmrContext {
     file: string;
     timestamp: number;
@@ -1194,6 +1195,8 @@ interface HotChannelClient {
      */
     send(event: string, payload?: CustomPayload['data']): void;
 }
+/** @deprecated use `HotChannelClient` instead */
+type HMRBroadcasterClient = HotChannelClient;
 interface HotChannel {
     /**
      * Broadcast events to all clients
@@ -1221,12 +1224,28 @@ interface HotChannel {
      */
     close(): void;
 }
+/** @deprecated use `HotChannel` instead */
+type HMRChannel = HotChannel;
 interface ServerHotChannel extends HotChannel {
     api: {
         innerEmitter: EventEmitter;
         outsideEmitter: EventEmitter;
     };
 }
+/** @deprecated use `ServerHotChannel` instead */
+type ServerHMRChannel = ServerHotChannel;
+/** @deprecated use `environment.hot` instead */
+interface HotBroadcaster extends HotChannel {
+    readonly channels: HotChannel[];
+    /**
+     * A noop.
+     * @deprecated
+     */
+    addChannel(channel: HotChannel): HotBroadcaster;
+    close(): Promise<unknown[]>;
+}
+/** @deprecated use `environment.hot` instead */
+type HMRBroadcaster = HotBroadcaster;
 
 declare class RemoteEnvironmentTransport {
     private readonly options;
@@ -1262,7 +1281,7 @@ declare class DevEnvironment extends BaseEnvironment {
     hot: HotChannel;
     constructor(name: string, config: ResolvedConfig, setup: DevEnvironmentSetup);
     init(): Promise<void>;
-    fetchModule(id: string, importer?: string): Promise<FetchResult>;
+    fetchModule(id: string, importer?: string, options?: FetchFunctionOptions): Promise<FetchResult>;
     transformRequest(url: string): Promise<TransformResult | null>;
     warmupRequest(url: string): Promise<void>;
     close(): Promise<void>;
@@ -1526,6 +1545,9 @@ interface RollupDynamicImportVarsOptions {
 declare namespace Terser {
   export type ECMA = 5 | 2015 | 2016 | 2017 | 2018 | 2019 | 2020
 
+  export type ConsoleProperty = keyof typeof console
+  type DropConsoleOption = boolean | ConsoleProperty[]
+
   export interface ParseOptions {
     bare_returns?: boolean
     /** @deprecated legacy option. Currently, all supported EcmaScript is valid to parse. */
@@ -1546,7 +1568,7 @@ declare namespace Terser {
     dead_code?: boolean
     defaults?: boolean
     directives?: boolean
-    drop_console?: boolean
+    drop_console?: DropConsoleOption
     drop_debugger?: boolean
     ecma?: ECMA
     evaluate?: boolean
@@ -1569,6 +1591,7 @@ declare namespace Terser {
     passes?: number
     properties?: boolean
     pure_funcs?: string[]
+    pure_new?: boolean
     pure_getters?: boolean | 'strict'
     reduce_funcs?: boolean
     reduce_vars?: boolean
@@ -1618,7 +1641,7 @@ declare namespace Terser {
      * Obtains the nth most favored (usually shortest) identifier to rename a variable to.
      * The mangler will increment n and retry until the return value is not in use in scope, and is not a reserved word.
      * This function is expected to be stable; Evaluating get(n) === get(n) should always return true.
-     * @param n - The ordinal of the identifier.
+     * @param n The ordinal of the identifier.
      */
     get(n: number): string
   }
@@ -1630,8 +1653,8 @@ declare namespace Terser {
     /**
      * Modifies the internal weighting of the input characters by the specified delta.
      * Will be invoked on the entire printed AST, and then deduct mangleable identifiers.
-     * @param chars - The characters to modify the weighting of.
-     * @param delta - The numeric weight to add to the characters.
+     * @param chars The characters to modify the weighting of.
+     * @param delta The numeric weight to add to the characters.
      */
     consider(chars: string, delta: number): number
     /**
@@ -1714,7 +1737,7 @@ declare namespace Terser {
     module?: boolean
     nameCache?: object
     format?: FormatOptions
-    /** @deprecated deprecated */
+    /** @deprecated */
     output?: FormatOptions
     parse?: ParseOptions
     safari10?: boolean
@@ -1734,6 +1757,7 @@ declare namespace Terser {
     includeSources?: boolean
     filename?: string
     root?: string
+    asObject?: boolean
     url?: string | 'inline'
   }
 }
@@ -1929,7 +1953,6 @@ interface BuildEnvironmentOptions {
     /**
      * Emit assets during SSR.
      * @default false
-     * @deprecated use emitAssets
      */
     ssrEmitAssets?: boolean;
     /**
@@ -1992,7 +2015,7 @@ interface LibraryOptions {
      */
     fileName?: string | ((format: ModuleFormat, entryName: string) => string);
 }
-type LibraryFormats = 'es' | 'cjs' | 'umd' | 'iife';
+type LibraryFormats = 'es' | 'cjs' | 'umd' | 'iife' | 'system';
 interface ModulePreloadOptions {
     /**
      * Whether to inject a module preload polyfill.
@@ -2058,20 +2081,36 @@ declare function createBuilder(inlineConfig?: InlineConfig): Promise<ViteBuilder
 
 type Environment = DevEnvironment | BuildEnvironment | ScanEnvironment | FutureCompatEnvironment;
 
-/**
- * This file is refactored into TypeScript based on
- * https://github.com/preactjs/wmr/blob/main/packages/wmr/src/lib/rollup-plugin-container.js
- */
-
-interface EnvironmentPluginContainer {
-    options: InputOptions;
-    buildStart(options: InputOptions): Promise<void>;
-    resolveId(id: string, importer: string | undefined, options?: {
+declare class EnvironmentPluginContainer {
+    environment: Environment;
+    plugins: Plugin[];
+    watcher?: FSWatcher | undefined;
+    private _pluginContextMap;
+    private _resolvedRollupOptions?;
+    private _processesing;
+    private _seenResolves;
+    private _moduleNodeToLoadAddedImports;
+    getSortedPluginHooks: PluginHookUtils['getSortedPluginHooks'];
+    getSortedPlugins: PluginHookUtils['getSortedPlugins'];
+    moduleGraph: EnvironmentModuleGraph | undefined;
+    watchFiles: Set<string>;
+    minimalContext: MinimalPluginContext;
+    private _closed;
+    private _updateModuleLoadAddedImports;
+    private _getAddedImports;
+    private handleHookPromise;
+    get options(): InputOptions;
+    resolveRollupOptions(): Promise<InputOptions>;
+    private _getPluginContext;
+    private hookParallel;
+    buildStart(_options?: InputOptions): Promise<void>;
+    resolveId(rawId: string, importer?: string | undefined, options?: {
         attributes?: Record<string, string>;
         custom?: CustomPluginOptions;
         skip?: Set<Plugin>;
         isEntry?: boolean;
     }): Promise<PartialResolvedId | null>;
+    load(id: string, options?: {}): Promise<LoadResult | null>;
     transform(code: string, id: string, options?: {
         inMap?: SourceDescription['map'];
     }): Promise<{
@@ -2080,38 +2119,39 @@ interface EnvironmentPluginContainer {
             mappings: '';
         } | null;
     }>;
-    load(id: string, options?: {}): Promise<LoadResult | null>;
     watchChange(id: string, change: {
         event: 'create' | 'update' | 'delete';
     }): Promise<void>;
     close(): Promise<void>;
 }
-interface PluginContainer {
-    options: InputOptions;
-    buildStart(options: InputOptions): Promise<void>;
-    resolveId(id: string, importer?: string, options?: {
+declare class PluginContainer {
+    private environments;
+    constructor(environments: Record<string, Environment>);
+    private _getEnvironment;
+    private _getPluginContainer;
+    get options(): InputOptions;
+    buildStart(_options?: InputOptions): Promise<void>;
+    resolveId(rawId: string, importer?: string, options?: {
         attributes?: Record<string, string>;
         custom?: CustomPluginOptions;
         skip?: Set<Plugin>;
         ssr?: boolean;
-        environment?: Environment;
         isEntry?: boolean;
     }): Promise<PartialResolvedId | null>;
+    load(id: string, options?: {
+        ssr?: boolean;
+    }): Promise<LoadResult | null>;
     transform(code: string, id: string, options?: {
-        inMap?: SourceDescription['map'];
         ssr?: boolean;
         environment?: Environment;
+        inMap?: SourceDescription['map'];
     }): Promise<{
         code: string;
         map: SourceMap | {
             mappings: '';
         } | null;
     }>;
-    load(id: string, options?: {
-        ssr?: boolean;
-        environment?: Environment;
-    }): Promise<LoadResult | null>;
-    watchChange(id: string, change: {
+    watchChange(_id: string, _change: {
         event: 'create' | 'update' | 'delete';
     }): Promise<void>;
     close(): Promise<void>;
@@ -2691,10 +2731,14 @@ interface ServerOptions extends CommonServerOptions {
      * Configure HMR-specific options (port, host, path & protocol)
      */
     hmr?: HmrOptions | boolean;
+    /**
+     * Do not start the websocket connection.
+     * @experimental
+     */
+    ws?: false;
     /**
      * Warm-up files to transform and cache the results in advance. This improves the
      * initial page load during server starts and prevents transform waterfalls.
-     * @deprecated use dev.warmup / environment.ssr.dev.warmup
      */
     warmup?: {
         /**
@@ -2721,7 +2765,7 @@ interface ServerOptions extends CommonServerOptions {
          *
          * This is needed to proxy WebSocket connections to the parent server.
          */
-        server: http.Server;
+        server: HttpServer;
     };
     /**
      * Options for files served via '/\@fs/'.
@@ -2736,7 +2780,6 @@ interface ServerOptions extends CommonServerOptions {
     /**
      * Pre-transform known direct imports
      * @default true
-     * @deprecated use dev.preTransformRequests
      */
     preTransformRequests?: boolean;
     /**
@@ -2746,7 +2789,6 @@ interface ServerOptions extends CommonServerOptions {
      * By default, it excludes all paths containing `node_modules`. You can pass `false` to
      * disable this behavior, or, for full control, a function that takes the source path and
      * sourcemap path and returns whether to ignore the source path.
-     * @deprecated use dev.sourcemapIgnoreList
      */
     sourcemapIgnoreList?: false | ((sourcePath: string, sourcemapPath: string) => boolean);
     /**
@@ -2821,12 +2863,17 @@ interface ViteDevServer {
     watcher: FSWatcher;
     /**
      * web socket server with `send(payload)` method
-     * @deprecated use `environment.hot` instead
      */
     ws: WebSocketServer;
+    /**
+     * HMR broadcaster that can be used to send custom HMR messages to the client
+     *
+     * Always sends a message to at least a WebSocket client. Any third party can
+     * add a channel to the broadcaster to process messages
+     */
+    hot: HotBroadcaster;
     /**
      * Rollup plugin container that can run plugin hooks on a given file
-     * @deprecated use `environment.pluginContainer` instead
      */
     pluginContainer: PluginContainer;
     /**
@@ -2836,7 +2883,6 @@ interface ViteDevServer {
     /**
      * Module graph that tracks the import relationships, url to file mapping
      * and hmr state.
-     * @deprecated use `environment.moduleGraph` instead
      */
     moduleGraph: ModuleGraph;
     /**
@@ -2847,14 +2893,12 @@ interface ViteDevServer {
     /**
      * Programmatically resolve, load and transform a URL and get the result
      * without going through the http request pipeline.
-     * @deprecated use environment.transformRequest
      */
     transformRequest(url: string, options?: TransformOptions): Promise<TransformResult | null>;
     /**
      * Same as `transformRequest` but only warm up the URLs so the next request
      * will already be cached. The function will never throw as it handles and
      * reports errors internally.
-     * @deprecated use environment.warmupRequest
      */
     warmupRequest(url: string, options?: TransformOptions): Promise<void>;
     /**
@@ -2923,8 +2967,6 @@ interface ViteDevServer {
      * are processed. If called from a load or transform plugin hook, the id needs to be
      * passed as a parameter to avoid deadlocks. Calling this function after the first
      * static imports section of the module graph has been processed will resolve immediately.
-     * @experimental
-     * @deprecated use environment.waitForRequestsIdle()
      */
     waitForRequestsIdle: (ignoredId?: string) => Promise<void>;
 }
@@ -3007,7 +3049,7 @@ interface ResolvePluginOptions {
     scan?: boolean;
     ssrOptimizeCheck?: boolean;
     /**
-     * @deprecated environment.options are used instead
+     * @deprecated environment.config are used instead
      */
     ssrConfig?: SSROptions;
 }
@@ -3066,6 +3108,7 @@ type LightningCSSOptions = {
   pseudoClasses?: PseudoClasses
   unusedSymbols?: string[]
   cssModules?: CSSModulesConfig
+  errorRecovery?: boolean
 }
 
 interface CSSOptions {
@@ -3104,7 +3147,6 @@ interface CSSOptions {
      * Enables css sourcemaps during dev
      * @default false
      * @experimental
-     * @deprecated use dev.sourcemap instead
      */
     devSourcemap?: boolean;
     /**
@@ -3218,7 +3260,13 @@ type IndexHtmlTransform = IndexHtmlTransformHook | {
  * check if they have access to dev specific APIs.
  */
 interface PluginContextExtension {
-    environment?: Environment;
+    /**
+     * Vite-specific environment instance
+     */
+    environment: Environment;
+}
+interface HotUpdatePluginContext {
+    environment: DevEnvironment;
 }
 interface PluginContext extends rollup.PluginContext, PluginContextExtension {
 }
@@ -3243,7 +3291,7 @@ declare module 'rollup' {
 interface Plugin<A = any> extends rollup.Plugin<A> {
     /**
      * Perform custom handling of HMR updates.
-     * The handler receives a context containing changed filename, timestamp, a
+     * The handler receives an options containing changed filename, timestamp, a
      * list of modules affected by the file change, and the dev server instance.
      *
      * - The hook can return a filtered list of modules to narrow down the update.
@@ -3251,34 +3299,25 @@ interface Plugin<A = any> extends rollup.Plugin<A> {
      *   the descriptors.
      *
      * - The hook can also return an empty array and then perform custom updates
-     *   by sending a custom hmr payload via server.hot.send().
+     *   by sending a custom hmr payload via environment.hot.send().
      *
      * - If the hook doesn't return a value, the hmr update will be performed as
      *   normal.
      */
-    hotUpdate?: ObjectHook<(this: void, ctx: HotUpdateContext) => Array<EnvironmentModuleNode> | void | Promise<Array<EnvironmentModuleNode> | void>>;
+    hotUpdate?: ObjectHook<(this: HotUpdatePluginContext, options: HotUpdateOptions) => Array<EnvironmentModuleNode> | void | Promise<Array<EnvironmentModuleNode> | void>>;
     /**
      * extend hooks with ssr flag
      */
     resolveId?: ObjectHook<(this: ResolveIdPluginContext, source: string, importer: string | undefined, options: {
         attributes: Record<string, string>;
         custom?: CustomPluginOptions;
-        /**
-         * @deprecated use this.environment
-         */
         ssr?: boolean;
         isEntry: boolean;
     }) => Promise<ResolveIdResult> | ResolveIdResult>;
     load?: ObjectHook<(this: PluginContext, id: string, options?: {
-        /**
-         * @deprecated use this.environment
-         */
         ssr?: boolean;
     }) => Promise<LoadResult> | LoadResult>;
     transform?: ObjectHook<(this: TransformPluginContext, code: string, id: string, options?: {
-        /**
-         * @deprecated use this.environment
-         */
         ssr?: boolean;
     }) => Promise<rollup.TransformResult> | rollup.TransformResult>;
     /**
@@ -3374,7 +3413,6 @@ interface Plugin<A = any> extends rollup.Plugin<A> {
      */
     transformIndexHtml?: IndexHtmlTransform;
     /**
-     * @deprecated
      * Perform custom handling of HMR updates.
      * The handler receives a context containing changed filename, timestamp, a
      * list of modules affected by the file change, and the dev server instance.
@@ -3415,17 +3453,8 @@ interface JsonOptions {
 
 type SSRTarget = 'node' | 'webworker';
 type SsrDepOptimizationConfig = DepOptimizationConfig;
-/**
- * @deprecated use environments.ssr
- */
 interface SSROptions {
-    /**
-     * @deprecated use environment.resolve.noExternal
-     */
     noExternal?: string | RegExp | (string | RegExp)[] | true;
-    /**
-     * @deprecated use environment.resolve.external
-     */
     external?: string[] | true;
     /**
      * Define the target for the ssr build. The browser field in package.json
@@ -3438,7 +3467,6 @@ interface SSROptions {
      * }
      *
      * @default 'node'
-     * @deprecated use environment.webCompatible
      */
     target?: SSRTarget;
     /**
@@ -3448,12 +3476,8 @@ interface SSROptions {
      * During dev:
      *   explicit no external CJS dependencies are optimized by default
      * @experimental
-     * @deprecated
      */
     optimizeDeps?: SsrDepOptimizationConfig;
-    /**
-     * @deprecated
-     */
     resolve?: {
         /**
          * Conditions that are used in the plugin pipeline. The default value is the root config's `resolve.conditions`.
@@ -3461,14 +3485,12 @@ interface SSROptions {
          * Use this to override the default ssr conditions for the ssr build.
          *
          * @default rootConfig.resolve.conditions
-         * @deprecated
          */
         conditions?: string[];
         /**
          * Conditions that are used during ssr import (including `ssrLoadModule`) of externalized dependencies.
          *
          * @default []
-         * @deprecated
          */
         externalConditions?: string[];
     };
@@ -3478,6 +3500,15 @@ interface ResolvedSSROptions extends SSROptions {
     optimizeDeps: SsrDepOptimizationConfig;
 }
 
+interface FutureDeprecationWarningsOptions {
+    pluginHookHandleHotUpdate?: boolean;
+    pluginHookSsrArgument?: boolean;
+    serverModuleGraph?: boolean;
+    serverHot?: boolean;
+    serverTransformRequest?: boolean;
+    ssrLoadModule?: boolean;
+}
+
 interface ConfigEnv {
     /**
      * 'serve': during dev (`vite` command)
@@ -3570,6 +3601,11 @@ interface SharedEnvironmentOptions {
      * Configure resolver
      */
     resolve?: EnvironmentResolveOptions;
+    /**
+     * Define if this environment is used for Server Side Rendering
+     * @default 'server' if it isn't the client environment
+     */
+    consumer?: 'client' | 'server';
     /**
      * Runtime Compatibility
      * Temporal options, we should remove these in favor of fine-grained control
@@ -3597,13 +3633,14 @@ interface EnvironmentOptions extends SharedEnvironmentOptions {
 type ResolvedEnvironmentResolveOptions = Required<EnvironmentResolveOptions>;
 type ResolvedEnvironmentOptions = {
     resolve: ResolvedEnvironmentResolveOptions;
+    consumer: 'client' | 'server';
     nodeCompatible: boolean;
     webCompatible: boolean;
     injectInvalidationTimestamp: boolean;
     dev: ResolvedDevEnvironmentOptions;
     build: ResolvedBuildEnvironmentOptions;
 };
-type DefaultEnvironmentOptions = Omit<EnvironmentOptions, 'build' | 'nodeCompatible' | 'webCompatible'> & {
+type DefaultEnvironmentOptions = Omit<EnvironmentOptions, 'build' | 'consumer' | 'nodeCompatible' | 'webCompatible' | 'injectInvalidationTimestamp'> & {
     build?: BuildOptions;
 };
 interface UserConfig extends DefaultEnvironmentOptions {
@@ -3692,6 +3729,10 @@ interface UserConfig extends DefaultEnvironmentOptions {
      * @experimental
      */
     experimental?: ExperimentalOptions;
+    /**
+     * Options to opt-in to future behavior
+     */
+    future?: FutureOptions;
     /**
      * Legacy options
      *
@@ -3773,6 +3814,14 @@ interface HTMLOptions {
      */
     cspNonce?: string;
 }
+interface FutureOptions {
+    /**
+     * Emit warning messages for deprecated/will-deprecated features at runtime.
+     *
+     * Setting to `true` to enable all warnings
+     */
+    deprecationWarnings?: boolean | FutureDeprecationWarningsOptions;
+}
 interface ExperimentalOptions {
     /**
      * Append fake `&lang.(ext)` when queries are specified, to preserve the file extension for following plugins to process.
@@ -3876,6 +3925,13 @@ declare function loadConfigFromFile(configEnv: ConfigEnv, configFile?: string, c
     dependencies: string[];
 } | null>;
 
+type ResolveIdFn = (environment: PartialEnvironment, id: string, importer?: string, aliasOnly?: boolean) => Promise<string | undefined>;
+/**
+ * Create an internal resolver to be used in special scenarios, e.g.
+ * optimizer and handling css @imports
+ */
+declare function createIdResolver(config: ResolvedConfig, options: Partial<InternalResolveOptions>): ResolveIdFn;
+
 declare function buildErrorMessage(err: RollupError, args?: string[], includeStack?: boolean): string;
 
 declare function createNodeDevEnvironment(name: string, config: ResolvedConfig, options: DevEnvironmentSetup): DevEnvironment;
@@ -3959,12 +4015,6 @@ declare const rollupVersion: string;
 declare function normalizePath(id: string): string;
 declare function mergeConfig<D extends Record<string, any>, O extends Record<string, any>>(defaults: D extends Function ? never : D, overrides: O extends Function ? never : O, isRoot?: boolean): Record<string, any>;
 declare function mergeAlias(a?: AliasOptions, b?: AliasOptions): AliasOptions | undefined;
-/**
- * Creates a function that hides the complexities of a WeakMap with an initial value
- * to implement object metadata. Used by plugins to implement cross hooks per
- * environment metadata
- */
-declare function createWeakData<Key extends object | symbol, Data>(initial: (key: Key) => Data): (key: Key) => Data;
 
 interface SendOptions {
     etag?: string;
@@ -3983,7 +4033,6 @@ declare function searchForWorkspaceRoot(current: string, root?: string): string;
 
 /**
  * Check if the url is allowed to be served, via the `server.fs` config.
- * @deprecated use isFileLoadingAllowed
  */
 declare function isFileServingAllowed(url: string, server: ViteDevServer): boolean;
 declare function isFileLoadingAllowed(config: ResolvedConfig, filePath: string): boolean;
@@ -4004,4 +4053,4 @@ interface ManifestChunk {
     dynamicImports?: string[];
 }
 
-export { type Alias, type AliasOptions, type AnymatchFn, type AnymatchPattern, type AppType, type AwaitWriteFinishOptions, type BindCLIShortcutsOptions, BuildEnvironment, type BuildEnvironmentOptions, type BuildOptions, type BuilderOptions, type CLIShortcut, type CSSModulesOptions, type CSSOptions, type CommonServerOptions, type ConfigEnv, Connect, type CorsOptions, type CorsOrigin, type DepOptimizationConfig, type DepOptimizationMetadata, type DepOptimizationOptions, DevEnvironment, type DevEnvironmentOptions, type DevEnvironmentSetup, type ESBuildOptions, type ESBuildTransformResult, type Environment, EnvironmentModuleGraph, EnvironmentModuleNode, type ExperimentalOptions, type ExportsData, FSWatcher, type FetchModuleOptions, type FileSystemServeOptions, type FilterPattern, type HTMLOptions, type HmrContext, type HmrOptions, type HookHandler, type HotChannel, type HotChannelClient, type HotUpdateContext, type HtmlTagDescriptor, HttpProxy, type IndexHtmlTransform, type IndexHtmlTransformContext, type IndexHtmlTransformHook, type IndexHtmlTransformResult, type InlineConfig, type InternalResolveOptions, type JsonOptions, type LegacyOptions, type LibraryFormats, type LibraryOptions, type LightningCSSOptions, type LogErrorOptions, type LogLevel, type LogOptions, type LogType, type Logger, type LoggerOptions, type Manifest, type ManifestChunk, type MapToFunction, type AnymatchMatcher as Matcher, ModuleGraph, ModuleNode, type ModulePreloadOptions, type ModuleRunnerTransformOptions, type OptimizedDepInfo, type Plugin, type PluginContainer, type PluginHookUtils, type PluginOption, type PreprocessCSSResult, type PreviewOptions, type PreviewServer, type PreviewServerHook, type ProxyOptions, RemoteEnvironmentTransport, type RenderBuiltAssetUrl, type ResolveFn, type ResolveModulePreloadDependenciesFn, type ResolveOptions, type ResolvedBuildEnvironmentOptions, type ResolvedBuildOptions, type ResolvedCSSOptions, type ResolvedConfig, type ResolvedDevEnvironmentOptions, type ResolvedModulePreloadOptions, type ResolvedPreviewOptions, type ResolvedSSROptions, type ResolvedServerOptions, type ResolvedServerUrls, type ResolvedUrl, type ResolvedWorkerOptions, type ResolverFunction, type ResolverObject, type RollupCommonJSOptions, type RollupDynamicImportVarsOptions, type SSROptions, type SSRTarget, type SendOptions, ServerHMRConnector, type ServerHook, type ServerHotChannel, type ServerModuleRunnerOptions, type ServerOptions, SplitVendorChunkCache, type SsrDepOptimizationConfig, Terser, type TerserOptions, type TransformOptions, type TransformResult, type UserConfig, type UserConfigExport, type UserConfigFn, type UserConfigFnObject, type UserConfigFnPromise, type ViteBuilder, type ViteDevServer, type WatchOptions, WebSocket, WebSocketAlias, type WebSocketClient, type WebSocketCustomListener, WebSocketServer, build, buildErrorMessage, createBuilder, createFilter, createLogger, createNodeDevEnvironment, createServer, createServerModuleRunner, createWeakData, defineConfig, fetchModule, formatPostcssSourceMap, isCSSRequest, isFileLoadingAllowed, isFileServingAllowed, loadConfigFromFile, loadEnv, mergeAlias, mergeConfig, ssrTransform as moduleRunnerTransform, normalizePath, optimizeDeps, preprocessCSS, preview, resolveConfig, resolveEnvPrefix, rollupVersion, searchForWorkspaceRoot, send, sortUserPlugins, splitVendorChunk, splitVendorChunkPlugin, transformWithEsbuild, VERSION as version };
+export { type Alias, type AliasOptions, type AnymatchFn, type AnymatchPattern, type AppType, type AwaitWriteFinishOptions, type BindCLIShortcutsOptions, BuildEnvironment, type BuildEnvironmentOptions, type BuildOptions, type BuilderOptions, type CLIShortcut, type CSSModulesOptions, type CSSOptions, type CommonServerOptions, type ConfigEnv, Connect, type CorsOptions, type CorsOrigin, type DepOptimizationConfig, type DepOptimizationMetadata, type DepOptimizationOptions, DevEnvironment, type DevEnvironmentOptions, type DevEnvironmentSetup, type ESBuildOptions, type ESBuildTransformResult, type Environment, EnvironmentModuleGraph, EnvironmentModuleNode, type ExperimentalOptions, type ExportsData, FSWatcher, type FetchModuleOptions, type FileSystemServeOptions, type FilterPattern, type HMRBroadcaster, type HMRBroadcasterClient, type HMRChannel, type HTMLOptions, type HmrContext, type HmrOptions, type HookHandler, type HotChannel, type HotChannelClient, type HotUpdateOptions, type HtmlTagDescriptor, HttpProxy, type HttpServer, type IndexHtmlTransform, type IndexHtmlTransformContext, type IndexHtmlTransformHook, type IndexHtmlTransformResult, type InlineConfig, type InternalResolveOptions, type JsonOptions, type LegacyOptions, type LibraryFormats, type LibraryOptions, type LightningCSSOptions, type LogErrorOptions, type LogLevel, type LogOptions, type LogType, type Logger, type LoggerOptions, type Manifest, type ManifestChunk, type MapToFunction, type AnymatchMatcher as Matcher, ModuleGraph, ModuleNode, type ModulePreloadOptions, type ModuleRunnerTransformOptions, type OptimizedDepInfo, type Plugin, PluginContainer, type PluginHookUtils, type PluginOption, type PreprocessCSSResult, type PreviewOptions, type PreviewServer, type PreviewServerHook, type ProxyOptions, RemoteEnvironmentTransport, type RenderBuiltAssetUrl, type ResolveFn, type ResolveModulePreloadDependenciesFn, type ResolveOptions, type ResolvedBuildEnvironmentOptions, type ResolvedBuildOptions, type ResolvedCSSOptions, type ResolvedConfig, type ResolvedDevEnvironmentOptions, type ResolvedModulePreloadOptions, type ResolvedPreviewOptions, type ResolvedSSROptions, type ResolvedServerOptions, type ResolvedServerUrls, type ResolvedUrl, type ResolvedWorkerOptions, type ResolverFunction, type ResolverObject, type RollupCommonJSOptions, type RollupDynamicImportVarsOptions, type SSROptions, type SSRTarget, type SendOptions, type ServerHMRChannel, ServerHMRConnector, type ServerHook, type ServerHotChannel, type ServerModuleRunnerOptions, type ServerOptions, SplitVendorChunkCache, type SsrDepOptimizationConfig, Terser, type TerserOptions, type TransformOptions, type TransformResult, type UserConfig, type UserConfigExport, type UserConfigFn, type UserConfigFnObject, type UserConfigFnPromise, type ViteBuilder, type ViteDevServer, type WatchOptions, WebSocket, WebSocketAlias, type WebSocketClient, type WebSocketCustomListener, WebSocketServer, build, buildErrorMessage, createBuilder, createFilter, createIdResolver, createLogger, createNodeDevEnvironment, createServer, createServerModuleRunner, defineConfig, fetchModule, formatPostcssSourceMap, isCSSRequest, isFileLoadingAllowed, isFileServingAllowed, loadConfigFromFile, loadEnv, mergeAlias, mergeConfig, ssrTransform as moduleRunnerTransform, normalizePath, optimizeDeps, preprocessCSS, preview, resolveConfig, resolveEnvPrefix, rollupVersion, searchForWorkspaceRoot, send, sortUserPlugins, splitVendorChunk, splitVendorChunkPlugin, transformWithEsbuild, VERSION as version };