/// import { t as ModuleRunnerTransport } from "./chunks/moduleRunnerTransport.js"; import { ConnectedPayload, CustomPayload, CustomPayload as hmrPayload_CustomPayload, ErrorPayload, FullReloadPayload, HMRPayload, HotPayload, HotPayload as hmrPayload_HotPayload, PrunePayload, Update, UpdatePayload } from "#types/hmrPayload"; import { CustomEventMap, InferCustomEventPayload, InferCustomEventPayload as hmrPayload_InferCustomEventPayload, InvalidatePayload } from "#types/customEvent"; import * as Rolldown from "rolldown"; import { CustomPluginOptions, ExistingRawSourceMap, FunctionPluginHooks, ImportKind, InputOption, InputOptions, LoadResult, MinimalPluginContext, ModuleFormat, ModuleInfo, ModuleType, ModuleTypeFilter, ObjectHook, OutputBundle, OutputChunk, OutputOptions, PartialResolvedId, PluginContext, PluginContextMeta, ResolveIdResult, RolldownOptions, RolldownOutput, RolldownWatcher, RollupError, RollupLog, SourceDescription, SourceMap, SourceMapInput, TransformPluginContext, VERSION as rolldownVersion, WatcherOptions } from "rolldown"; import { parseAst as parseAst$1, parseAstAsync as parseAstAsync$1 } from "rolldown/parseAst"; import * as Rollup from "#types/internal/rollupTypeCompat"; import { esmExternalRequirePlugin } from "rolldown/plugins"; import { ESTree, MinifyOptions, MinifyResult, ParseResult, ParserOptions, TransformOptions as rolldown_utils_TransformOptions, TransformResult as rolldown_utils_TransformResult, Visitor, VisitorObject, minify, minifySync, parse, parseSync } from "rolldown/utils"; import * as http from "node:http"; import { Agent, ClientRequest, ClientRequestArgs, OutgoingHttpHeaders, ServerResponse } from "node:http"; import { Http2SecureServer } from "node:http2"; import * as fs from "node:fs"; import { EventEmitter } from "node:events"; import { Server as HttpsServer, ServerOptions as HttpsServerOptions } from "node:https"; import * as net from "node:net"; import { Duplex, DuplexOptions, Stream } from "node:stream"; import { FetchFunction, FetchFunctionOptions, FetchResult, FetchResult as moduleRunner_FetchResult, ModuleEvaluator, ModuleRunner, ModuleRunnerHmr, ModuleRunnerOptions } from "vite/module-runner"; import { DepsOptimizerEsbuildOptions, EsbuildTarget, EsbuildTransformOptions, EsbuildTransformOptions as esbuildOptions_EsbuildTransformOptions, EsbuildTransformResult } from "#types/internal/esbuildOptions"; import { SecureContextOptions } from "node:tls"; import { URL as url_URL } from "node:url"; import { ZlibOptions } from "node:zlib"; import { ChunkMetadata, CustomPluginOptionsVite } from "#types/metadata"; import { Terser, TerserMinifyOptions } from "#types/internal/terserOptions"; import * as PostCSS from "postcss"; import { LightningCSSOptions, LightningCSSOptions as lightningcssOptions_LightningCSSOptions } from "#types/internal/lightningcssOptions"; import { LessPreprocessorBaseOptions, SassModernPreprocessBaseOptions, StylusPreprocessorBaseOptions } from "#types/internal/cssPreprocessorOptions"; import { withFilter } from "rolldown/filter"; import { GeneralImportGlobOptions, ImportGlobFunction, ImportGlobOptions, KnownAsTypeMap, KnownQueryTypeMap } from "#types/importGlob"; //#region \0rolldown/runtime.js //#endregion //#region ../../node_modules/.pnpm/@vitejs+devtools@0.3.3_typescript@6.0.3_vite@packages+vite/node_modules/@vitejs/devtools/dist/cli-commands.d.ts //#region src/node/cli-commands.d.ts interface StartOptions { root?: string; config?: string; host: string; port?: string | number; open?: boolean; } //#endregion //#region ../../node_modules/.pnpm/@vitejs+devtools@0.3.3_typescript@6.0.3_vite@packages+vite/node_modules/@vitejs/devtools/dist/config.d.ts //#region src/node/config.d.ts interface DevToolsConfig extends Partial { enabled: boolean; /** * Vite environments to enable DevTools for. Defaults to all environments. */ environments?: string[]; /** * Disable client authentication. * * Beware that if you disable client authentication, * any browsers can connect to the devtools and access to your server and filesystem. * (including other devices, if you open server `host` option to LAN or WAN) * * @default true */ clientAuth?: boolean; /** * Pre-configured auth tokens that are automatically trusted. * * Clients connecting with an auth token matching one of these * will be auto-approved without a terminal prompt. */ clientAuthTokens?: string[]; } interface ResolvedDevToolsConfig { config: Omit & { host: string; }; enabled: boolean; } //#endregion //#region src/types/alias.d.ts interface Alias { find: string | RegExp; replacement: string; /** * Instructs the plugin to use an alternative resolving algorithm, * rather than the Rollup's resolver. * @default null * @deprecated Use a custom plugin with resolveId hook and `enforce: 'pre'` instead */ customResolver?: ResolverFunction | ResolverObject | null; } type MapToFunction = T extends Function ? T : never; type ResolverFunction = MapToFunction; interface ResolverObject { buildStart?: FunctionPluginHooks['buildStart']; resolveId: ResolverFunction; } /** * Specifies an `Object`, or an `Array` of `Object`, * which defines aliases used to replace values in `import` or `require` statements. * With either format, the order of the entries is important, * in that the first defined rules are applied first. * * This is passed to \@rollup/plugin-alias as the "entries" field * https://github.com/rollup/plugins/tree/master/packages/alias#entries */ type AliasOptions = readonly Alias[] | { [find: string]: string; }; //#endregion //#region src/types/anymatch.d.ts type AnymatchFn = (testString: string) => boolean; type AnymatchPattern = string | RegExp | AnymatchFn; type AnymatchMatcher = AnymatchPattern | AnymatchPattern[]; //#endregion //#region src/types/chokidar.d.ts declare class FSWatcher extends EventEmitter implements fs.FSWatcher { options: WatchOptions; /** * Constructs a new FSWatcher instance with optional WatchOptions parameter. */ constructor(options?: WatchOptions); /** * When called, requests that the Node.js event loop not exit so long as the fs.FSWatcher is active. * Calling watcher.ref() multiple times will have no effect. */ ref(): this; /** * When called, the active fs.FSWatcher object will not require the Node.js event loop to remain active. * If there is no other activity keeping the event loop running, the process may exit before the fs.FSWatcher object's callback is invoked. * Calling watcher.unref() multiple times will have no effect. */ unref(): this; /** * Add files, directories, or glob patterns for tracking. Takes an array of strings or just one * string. */ add(paths: string | ReadonlyArray): this; /** * Stop watching files, directories, or glob patterns. Takes an array of strings or just one * string. */ unwatch(paths: string | ReadonlyArray): this; /** * Returns an object representing all the paths on the file system being watched by this * `FSWatcher` instance. The object's keys are all the directories (using absolute paths unless * the `cwd` option was used), and the values are arrays of the names of the items contained in * each directory. */ getWatched(): { [directory: string]: string[]; }; /** * Removes all listeners from watched files. */ close(): Promise; on(event: 'add' | 'addDir' | 'change', listener: (path: string, stats?: fs.Stats) => void): this; on(event: 'all', listener: (eventName: 'add' | 'addDir' | 'change' | 'unlink' | 'unlinkDir', path: string, stats?: fs.Stats) => void): this; /** * Error occurred */ on(event: 'error', listener: (error: Error) => void): this; /** * Exposes the native Node `fs.FSWatcher events` */ on(event: 'raw', listener: (eventName: string, path: string, details: any) => void): this; /** * Fires when the initial scan is complete */ on(event: 'ready', listener: () => void): this; on(event: 'unlink' | 'unlinkDir', listener: (path: string) => void): this; on(event: string, listener: (...args: any[]) => void): this; } interface WatchOptions { /** * Indicates whether the process should continue to run as long as files are being watched. If * set to `false` when using `fsevents` to watch, no more events will be emitted after `ready`, * even if the process continues to run. */ persistent?: boolean; /** * ([anymatch](https://github.com/micromatch/anymatch)-compatible definition) Defines files/paths to * be ignored. The whole relative or absolute path is tested, not just filename. If a function * with two arguments is provided, it gets called twice per path - once with a single argument * (the path), second time with two arguments (the path and the * [`fs.Stats`](https://nodejs.org/api/fs.html#fs_class_fs_stats) object of that path). */ ignored?: AnymatchMatcher; /** * If set to `false` then `add`/`addDir` events are also emitted for matching paths while * instantiating the watching as chokidar discovers these file paths (before the `ready` event). */ ignoreInitial?: boolean; /** * When `false`, only the symlinks themselves will be watched for changes instead of following * the link references and bubbling events through the link's path. */ followSymlinks?: boolean; /** * The base directory from which watch `paths` are to be derived. Paths emitted with events will * be relative to this. */ cwd?: string; /** * If set to true then the strings passed to .watch() and .add() are treated as literal path * names, even if they look like globs. * * @default false */ disableGlobbing?: boolean; /** * Whether to use fs.watchFile (backed by polling), or fs.watch. If polling leads to high CPU * utilization, consider setting this to `false`. It is typically necessary to **set this to * `true` to successfully watch files over a network**, and it may be necessary to successfully * watch files in other non-standard situations. Setting to `true` explicitly on OS X overrides * the `useFsEvents` default. */ usePolling?: boolean; /** * Whether to use the `fsevents` watching interface if available. When set to `true` explicitly * and `fsevents` is available this supersedes the `usePolling` setting. When set to `false` on * OS X, `usePolling: true` becomes the default. */ useFsEvents?: boolean; /** * If relying upon the [`fs.Stats`](https://nodejs.org/api/fs.html#fs_class_fs_stats) object that * may get passed with `add`, `addDir`, and `change` events, set this to `true` to ensure it is * provided even in cases where it wasn't already available from the underlying watch events. */ alwaysStat?: boolean; /** * If set, limits how many levels of subdirectories will be traversed. */ depth?: number; /** * Interval of file system polling. */ interval?: number; /** * Interval of file system polling for binary files. ([see list of binary extensions](https://gi * thub.com/sindresorhus/binary-extensions/blob/master/binary-extensions.json)) */ binaryInterval?: number; /** * Indicates whether to watch files that don't have read permissions if possible. If watching * fails due to `EPERM` or `EACCES` with this set to `true`, the errors will be suppressed * silently. */ ignorePermissionErrors?: boolean; /** * `true` if `useFsEvents` and `usePolling` are `false`. Automatically filters out artifacts * that occur when using editors that use "atomic writes" instead of writing directly to the * source file. If a file is re-added within 100 ms of being deleted, Chokidar emits a `change` * event rather than `unlink` then `add`. If the default of 100 ms does not work well for you, * you can override it by setting `atomic` to a custom value, in milliseconds. */ atomic?: boolean | number; /** * can be set to an object in order to adjust timing params: */ awaitWriteFinish?: AwaitWriteFinishOptions | boolean; } interface AwaitWriteFinishOptions { /** * Amount of time in milliseconds for a file size to remain constant before emitting its event. */ stabilityThreshold?: number; /** * File size polling interval. */ pollInterval?: number; } //#endregion //#region src/types/connect.d.ts declare namespace Connect { export type ServerHandle = HandleFunction | http.Server; export class IncomingMessage extends http.IncomingMessage { originalUrl?: http.IncomingMessage['url'] | undefined; } export type NextFunction = (err?: any) => void; export type SimpleHandleFunction = (req: IncomingMessage, res: http.ServerResponse) => void; export type NextHandleFunction = (req: IncomingMessage, res: http.ServerResponse, next: NextFunction) => void; export type ErrorHandleFunction = (err: any, req: IncomingMessage, res: http.ServerResponse, next: NextFunction) => void; export type HandleFunction = SimpleHandleFunction | NextHandleFunction | ErrorHandleFunction; export interface ServerStackItem { route: string; handle: ServerHandle; } export interface Server extends NodeJS.EventEmitter { (req: http.IncomingMessage, res: http.ServerResponse, next?: Function): void; route: string; stack: ServerStackItem[]; /** * Utilize the given middleware `handle` to the given `route`, * defaulting to _/_. This "route" is the mount-point for the * middleware, when given a value other than _/_ the middleware * is only effective when that segment is present in the request's * pathname. * * For example if we were to mount a function at _/admin_, it would * be invoked on _/admin_, and _/admin/settings_, however it would * not be invoked for _/_, or _/posts_. */ use(fn: NextHandleFunction): Server; use(fn: HandleFunction): Server; use(route: string, fn: NextHandleFunction): Server; use(route: string, fn: HandleFunction): Server; /** * Handle server requests, punting them down * the middleware stack. */ handle(req: http.IncomingMessage, res: http.ServerResponse, next: Function): void; /** * Listen for connections. * * This method takes the same arguments * as node's `http.Server#listen()`. * * HTTP and HTTPS: * * If you run your application both as HTTP * and HTTPS you may wrap them individually, * since your Connect "server" is really just * a JavaScript `Function`. * * var connect = require('connect') * , http = require('http') * , https = require('https'); * * var app = connect(); * * http.createServer(app).listen(80); * https.createServer(options, app).listen(443); */ listen(port: number, hostname?: string, backlog?: number, callback?: Function): http.Server; listen(port: number, hostname?: string, callback?: Function): http.Server; listen(path: string, callback?: Function): http.Server; listen(handle: any, listeningListener?: Function): http.Server; } } //#endregion //#region ../../node_modules/.pnpm/http-proxy-3@1.23.3_ms@2.1.3/node_modules/http-proxy-3/dist/lib/http-proxy/index.d.ts interface ProxyTargetDetailed { host: string; port: number; protocol?: string; hostname?: string; socketPath?: string; key?: string; passphrase?: string; pfx?: Buffer | string; cert?: string; ca?: string; ciphers?: string; secureProtocol?: string; } type ProxyType = "ws" | "web"; type ProxyTarget = ProxyTargetUrl | ProxyTargetDetailed; type ProxyTargetUrl = URL | string | { port: number; host: string; protocol?: string; }; type NormalizeProxyTarget = Exclude | URL; interface ServerOptions$3 { /** URL string to be parsed with the url module. */ target?: ProxyTarget; /** URL string to be parsed with the url module or a URL object. */ forward?: ProxyTargetUrl; /** Object to be passed to http(s).request. */ agent?: any; /** Object to be passed to https.createServer(). */ ssl?: any; /** If you want to proxy websockets. */ ws?: boolean; /** Adds x- forward headers. */ xfwd?: boolean; /** Verify SSL certificate. */ secure?: boolean; /** Explicitly specify if we are proxying to another proxy. */ toProxy?: boolean; /** Specify whether you want to prepend the target's path to the proxy path. */ prependPath?: boolean; /** Specify whether you want to ignore the proxy path of the incoming request. */ ignorePath?: boolean; /** Local interface string to bind for outgoing connections. */ localAddress?: string; /** Changes the origin of the host header to the target URL. */ changeOrigin?: boolean; /** specify whether you want to keep letter case of response header key */ preserveHeaderKeyCase?: boolean; /** Basic authentication i.e. 'user:password' to compute an Authorization header. */ auth?: string; /** Rewrites the location hostname on (301 / 302 / 307 / 308) redirects, Default: null. */ hostRewrite?: string; /** Rewrites the location host/ port on (301 / 302 / 307 / 308) redirects based on requested host/ port.Default: false. */ autoRewrite?: boolean; /** Rewrites the location protocol on (301 / 302 / 307 / 308) redirects to 'http' or 'https'.Default: null. */ protocolRewrite?: string; /** rewrites domain of set-cookie headers. */ cookieDomainRewrite?: false | string | { [oldDomain: string]: string; }; /** rewrites path of set-cookie headers. Default: false */ cookiePathRewrite?: false | string | { [oldPath: string]: string; }; /** object with extra headers to be added to target requests. */ headers?: { [header: string]: string | string[] | undefined; }; /** Timeout (in milliseconds) when proxy receives no response from target. Default: 120000 (2 minutes) */ proxyTimeout?: number; /** Timeout (in milliseconds) for incoming requests */ timeout?: number; /** Specify whether you want to follow redirects. Default: false */ followRedirects?: boolean; /** If set to true, none of the webOutgoing passes are called and it's your responsibility to appropriately return the response by listening and acting on the proxyRes event */ selfHandleResponse?: boolean; /** Buffer */ buffer?: Stream; /** Explicitly set the method type of the ProxyReq */ method?: string; /** * Optionally override the trusted CA certificates. * This is passed to https.request. */ ca?: string; /** Optional fetch implementation to use instead of global fetch, use this to activate fetch-based proxying, * for example to proxy HTTP/2 requests */ fetch?: typeof fetch; /** Optional configuration object for fetch-based proxy requests. * Use this to customize fetch request and response handling. * For custom fetch implementations, use the `fetch` property.*/ fetchOptions?: FetchOptions; } interface FetchOptions { /** Fetch request options */ requestOptions?: RequestInit; /** Called before making the fetch request */ onBeforeRequest?: (requestOptions: RequestInit, req: http.IncomingMessage, res: http.ServerResponse, options: NormalizedServerOptions) => void | Promise; /** Called after receiving the fetch response */ onAfterResponse?: (response: Response, req: http.IncomingMessage, res: http.ServerResponse, options: NormalizedServerOptions) => void | Promise; } interface NormalizedServerOptions extends ServerOptions$3 { target?: NormalizeProxyTarget; forward?: NormalizeProxyTarget; } type ErrorCallback = (err: TError, req: InstanceType, res: InstanceType | net.Socket, target?: ProxyTargetUrl) => void; type ProxyServerEventMap = { error: Parameters>; start: [req: InstanceType, res: InstanceType, target: ProxyTargetUrl]; open: [socket: net.Socket]; proxyReq: [proxyReq: http.ClientRequest, req: InstanceType, res: InstanceType, options: ServerOptions$3, socket: net.Socket]; proxyRes: [proxyRes: InstanceType, req: InstanceType, res: InstanceType]; proxyReqWs: [proxyReq: http.ClientRequest, req: InstanceType, socket: net.Socket, options: ServerOptions$3, head: any]; econnreset: [err: Error, req: InstanceType, res: InstanceType, target: ProxyTargetUrl]; end: [req: InstanceType, res: InstanceType, proxyRes: InstanceType]; close: [proxyRes: InstanceType, proxySocket: net.Socket, proxyHead: any]; }; type ProxyMethodArgs = { ws: [req: InstanceType, socket: any, head: any, ...args: [options?: ServerOptions$3, callback?: ErrorCallback] | [callback?: ErrorCallback]]; web: [req: InstanceType, res: InstanceType, ...args: [options: ServerOptions$3, callback?: ErrorCallback] | [callback?: ErrorCallback]]; }; type PassFunctions = { ws: (req: InstanceType, socket: net.Socket, options: NormalizedServerOptions, head: Buffer | undefined, server: ProxyServer, cb?: ErrorCallback) => unknown; web: (req: InstanceType, res: InstanceType, options: NormalizedServerOptions, head: Buffer | undefined, server: ProxyServer, cb?: ErrorCallback) => unknown; }; declare class ProxyServer extends EventEmitter> { /** * Used for proxying WS(S) requests * @param req - Client request. * @param socket - Client socket. * @param head - Client head. * @param options - Additional options. */ readonly ws: (...args: ProxyMethodArgs["ws"]) => void; /** * Used for proxying regular HTTP(S) requests * @param req - Client request. * @param res - Client response. * @param options - Additional options. */ readonly web: (...args: ProxyMethodArgs["web"]) => void; private options; private webPasses; private wsPasses; private _server?; /** * Creates the proxy server with specified options. * @param options - Config object passed to the proxy */ constructor(options?: ServerOptions$3); /** * Creates the proxy server with specified options. * @param options Config object passed to the proxy * @returns Proxy object with handlers for `ws` and `web` requests */ static createProxyServer(options?: ServerOptions$3): ProxyServer; /** * Creates the proxy server with specified options. * @param options Config object passed to the proxy * @returns Proxy object with handlers for `ws` and `web` requests */ static createServer(options?: ServerOptions$3): ProxyServer; /** * Creates the proxy server with specified options. * @param options Config object passed to the proxy * @returns Proxy object with handlers for `ws` and `web` requests */ static createProxy(options?: ServerOptions$3): ProxyServer; createRightProxy: (type: PT) => Function; onError: (err: TError) => void; /** * A function that wraps the object in a webserver, for your convenience * @param port - Port to listen on * @param hostname - The hostname to listen on */ listen: (port: number, hostname?: string) => this; address: () => string | net.AddressInfo | null | undefined; /** * A function that closes the inner webserver and stops listening on given port */ close: (cb?: Function) => void; before: (type: PT, passName: string, cb: PassFunctions[PT]) => void; after: (type: PT, passName: string, cb: PassFunctions[PT]) => void; } //#endregion //#region ../../node_modules/.pnpm/http-proxy-3@1.23.3_ms@2.1.3/node_modules/http-proxy-3/dist/lib/http-proxy/passes/ws-incoming.d.ts declare function numOpenSockets(): number; declare namespace index_d_exports { export { ErrorCallback, ProxyServer, ProxyTarget, ProxyTargetUrl, ServerOptions$3 as ServerOptions, createProxyServer as createProxy, createProxyServer, createProxyServer as createServer, ProxyServer as default, numOpenSockets }; } /** * Creates the proxy server. * * Examples: * * httpProxy.createProxyServer({ .. }, 8000) * // => '{ web: [Function], ws: [Function] ... }' * * @param {Object} Options Config object passed to the proxy * * @return {Object} Proxy Proxy object with handlers for `ws` and `web` requests * * @api public */ declare function createProxyServer(options?: ServerOptions$3): ProxyServer; //#endregion //#region src/node/server/middlewares/proxy.d.ts interface ProxyOptions extends ServerOptions$3 { /** * rewrite path */ rewrite?: (path: string) => string; /** * configure the proxy server (e.g. listen to events) */ configure?: (proxy: ProxyServer, options: ProxyOptions) => void; /** * webpack-dev-server style bypass function */ bypass?: (req: http.IncomingMessage, res: http.ServerResponse | undefined, options: ProxyOptions) => void | null | undefined | false | string | Promise; /** * rewrite the Origin header of a WebSocket request to match 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; } //#endregion //#region src/node/logger.d.ts type LogType = "error" | "warn" | "info"; type LogLevel = LogType | "silent"; interface Logger { info(msg: string, options?: LogOptions): void; warn(msg: string, options?: LogOptions): void; warnOnce(msg: string, options?: LogOptions): void; error(msg: string, options?: LogErrorOptions): void; clearScreen(type: LogType): void; hasErrorLogged(error: Error | RollupError): boolean; hasWarned: boolean; } interface LogOptions { clear?: boolean; timestamp?: boolean; environment?: string; } interface LogErrorOptions extends LogOptions { error?: Error | RollupError | null; } interface LoggerOptions { prefix?: string; allowClearScreen?: boolean; customLogger?: Logger; console?: Console; } declare function createLogger(level?: LogLevel, options?: LoggerOptions): Logger; //#endregion //#region src/node/http.d.ts interface CommonServerOptions { /** * Specify server port. Note if the port is already being used, Vite will * automatically try the next available port so this may not be the actual * port the server ends up listening on. */ port?: number; /** * If enabled, vite will exit if specified port is already in use */ strictPort?: boolean; /** * Specify which IP addresses the server should listen on. * Set to 0.0.0.0 to listen on all addresses, including LAN and public addresses. */ host?: string | boolean; /** * The hostnames that Vite is allowed to respond to. * `localhost` and subdomains under `.localhost` and all IP addresses are allowed by default. * When using HTTPS, this check is skipped. * * If a string starts with `.`, it will allow that hostname without the `.` and all subdomains under the hostname. * For example, `.example.com` will allow `example.com`, `foo.example.com`, and `foo.bar.example.com`. * * If set to `true`, the server is allowed to respond to requests for any hosts. * This is not recommended as it will be vulnerable to DNS rebinding attacks. */ allowedHosts?: string[] | true; /** * Enable TLS + HTTP/2. * Note: this downgrades to TLS only when the proxy option is also used. */ https?: HttpsServerOptions; /** * Open browser window on startup */ open?: boolean | string; /** * Configure custom proxy rules for the dev server. Expects an object * of `{ key: options }` pairs. * Uses [`http-proxy-3`](https://github.com/sagemathinc/http-proxy-3). * Full options [here](https://github.com/sagemathinc/http-proxy-3#options). * * Example `vite.config.js`: * ``` js * module.exports = { * proxy: { * // string shorthand: /foo -> http://localhost:4567/foo * '/foo': 'http://localhost:4567', * // with options * '/api': { * target: 'http://jsonplaceholder.typicode.com', * changeOrigin: true, * rewrite: path => path.replace(/^\/api/, '') * } * } * } * ``` */ proxy?: Record; /** * Configure CORS for the dev server. * Uses https://github.com/expressjs/cors. * * When enabling this option, **we recommend setting a specific value * rather than `true`** to avoid exposing the source code to untrusted origins. * * Set to `true` to allow all methods from any origin, or configure separately * using an object. * * @default false */ cors?: CorsOptions | boolean; /** * Specify server response headers. */ headers?: OutgoingHttpHeaders; } /** * https://github.com/expressjs/cors#configuration-options */ interface CorsOptions { /** * Configures the Access-Control-Allow-Origin CORS header. * * **We recommend setting a specific value rather than * `true`** to avoid exposing the source code to untrusted origins. */ origin?: CorsOrigin | ((origin: string | undefined, cb: (err: Error, origins: CorsOrigin) => void) => void); methods?: string | string[]; allowedHeaders?: string | string[]; exposedHeaders?: string | string[]; credentials?: boolean; maxAge?: number; preflightContinue?: boolean; optionsSuccessStatus?: number; } type CorsOrigin = boolean | string | RegExp | (string | RegExp)[]; //#endregion //#region src/shared/forwardConsole.d.ts type ForwardConsoleLogLevel = "error" | "warn" | "info" | "log" | "debug" | (string & {}); interface ForwardConsoleOptions { unhandledErrors?: boolean; logLevels?: ForwardConsoleLogLevel[]; } interface ResolvedForwardConsoleOptions { enabled: boolean; unhandledErrors: boolean; logLevels: ForwardConsoleLogLevel[]; } //#endregion //#region src/node/typeUtils.d.ts type RequiredExceptFor = Pick & Required>; //#endregion //#region src/node/preview.d.ts interface PreviewOptions extends CommonServerOptions {} interface ResolvedPreviewOptions extends RequiredExceptFor {} interface PreviewServer { /** * The resolved vite config object */ config: ResolvedConfig; /** * Stop the server. */ close(): Promise; /** * A connect app instance. * - Can be used to attach custom middlewares to the preview server. * - Can also be used as the handler function of a custom http server * or as a middleware in any connect-style Node.js frameworks * * https://github.com/senchalabs/connect#use-middleware */ middlewares: Connect.Server; /** * native Node http server instance */ httpServer: HttpServer; /** * The resolved urls Vite prints on the CLI (URL-encoded). Returns `null` * if the server is not listening on any port. */ resolvedUrls: ResolvedServerUrls | null; /** * Print server urls */ printUrls(): void; /** * Bind CLI shortcuts */ bindCLIShortcuts(options?: BindCLIShortcutsOptions): void; } type PreviewServerHook = (this: MinimalPluginContextWithoutEnvironment, server: PreviewServer) => (() => void) | void | Promise<(() => void) | void>; /** * Starts the Vite server in preview mode, to simulate a production deployment */ declare function preview(inlineConfig?: InlineConfig): Promise; //#endregion //#region src/node/shortcuts.d.ts type BindCLIShortcutsOptions = { /** * Print a one-line shortcuts "help" hint to the terminal */ print?: boolean; /** * Custom shortcuts to run when a key is pressed. These shortcuts take priority * over the default shortcuts if they have the same keys (except the `h` key). * To disable a default shortcut, define the same key but with `action: undefined`. */ customShortcuts?: CLIShortcut[]; }; type CLIShortcut = { key: string; description: string; action?(server: Server): void | Promise; }; //#endregion //#region src/node/baseEnvironment.d.ts declare class PartialEnvironment { name: string; getTopLevelConfig(): ResolvedConfig; config: ResolvedConfig & ResolvedEnvironmentOptions; logger: Logger; constructor(name: string, topLevelConfig: ResolvedConfig, options?: ResolvedEnvironmentOptions); } declare class BaseEnvironment extends PartialEnvironment { get plugins(): readonly Plugin[]; constructor(name: string, config: ResolvedConfig, options?: ResolvedEnvironmentOptions); } /** * This class discourages users from inversely checking the `mode` * to determine the type of environment, e.g. * * ```js * const isDev = environment.mode !== 'build' // bad * const isDev = environment.mode === 'dev' // good * ``` * * You should also not check against `"unknown"` specifically. It's * a placeholder for more possible environment types. */ declare class UnknownEnvironment extends BaseEnvironment { mode: "unknown"; } //#endregion //#region src/node/optimizer/scan.d.ts declare class ScanEnvironment extends BaseEnvironment { mode: "scan"; get pluginContainer(): EnvironmentPluginContainer; init(): Promise; } //#endregion //#region src/node/optimizer/index.d.ts type ExportsData = { hasModuleSyntax: boolean; exports: readonly string[]; jsxLoader?: boolean; }; interface DepsOptimizer { init: () => Promise; metadata: DepOptimizationMetadata; scanProcessing?: Promise; registerMissingImport: (id: string, resolved: string) => OptimizedDepInfo; run: () => void; isOptimizedDepFile: (id: string) => boolean; isOptimizedDepUrl: (url: string) => boolean; getOptimizedDepId: (depInfo: OptimizedDepInfo) => string; close: () => Promise; options: DepOptimizationOptions; } interface DepOptimizationConfig { /** * Force optimize listed dependencies (must be resolvable import paths, * cannot be globs). */ include?: string[]; /** * Do not optimize these dependencies (must be resolvable import paths, * cannot be globs). */ exclude?: string[]; /** * Forces ESM interop when importing these dependencies. Some legacy * packages advertise themselves as ESM but use `require` internally * @experimental */ needsInterop?: string[]; /** * Options to pass to esbuild during the dep scanning and optimization * * Certain options are omitted since changing them would not be compatible * with Vite's dep optimization. * * - `external` is also omitted, use Vite's `optimizeDeps.exclude` option * - `plugins` are merged with Vite's dep plugin * * https://esbuild.github.io/api * * @deprecated Use `rolldownOptions` instead. */ esbuildOptions?: DepsOptimizerEsbuildOptions; /** * @deprecated Use `rolldownOptions` instead. */ rollupOptions?: Omit & { output?: Omit; }; /** * Options to pass to rolldown during the dep scanning and optimization * * Certain options are omitted since changing them would not be compatible * with Vite's dep optimization. * * - `plugins` are merged with Vite's dep plugin */ rolldownOptions?: Omit & { output?: Omit; }; /** * List of file extensions that can be optimized. A corresponding esbuild * plugin must exist to handle the specific extension. * * By default, Vite can optimize `.mjs`, `.js`, `.ts`, and `.mts` files. This option * allows specifying additional extensions. * * @experimental */ extensions?: string[]; /** * Deps optimization during build was removed in Vite 5.1. This option is * now redundant and will be removed in a future version. Switch to using * `optimizeDeps.noDiscovery` and an empty or undefined `optimizeDeps.include`. * true or 'dev' disables the optimizer, false or 'build' leaves it enabled. * @default 'build' * @deprecated * @experimental */ disabled?: boolean | "build" | "dev"; /** * Automatic dependency discovery. When `noDiscovery` is true, only dependencies * listed in `include` will be optimized. The scanner isn't run for cold start * in this case. CJS-only dependencies must be present in `include` during dev. * @default false */ noDiscovery?: boolean; /** * When enabled, it will hold the first optimized deps results until all static * imports are crawled on cold start. This avoids the need for full-page reloads * when new dependencies are discovered and they trigger the generation of new * common chunks. If all dependencies are found by the scanner plus the explicitly * defined ones in `include`, it is better to disable this option to let the * browser process more requests in parallel. * @default true * @experimental */ holdUntilCrawlEnd?: boolean; /** * When enabled, Vite will not throw an error when an outdated optimized * dependency is requested. Enabling this option may cause a single module * to have a multiple reference. * @default false * @experimental */ ignoreOutdatedRequests?: boolean; } type DepOptimizationOptions = DepOptimizationConfig & { /** * By default, Vite will crawl your `index.html` to detect dependencies that * need to be pre-bundled. If `build.rolldownOptions.input` is specified, Vite * will crawl those entry points instead. * * If neither of these fit your needs, you can specify custom entries using * this option - the value should be a tinyglobby pattern or array of patterns * (https://github.com/SuperchupuDev/tinyglobby) that are relative from * vite project root. This will overwrite default entries inference. */ entries?: string | string[]; /** * Force dep pre-optimization regardless of whether deps have changed. * @experimental */ force?: boolean; }; interface OptimizedDepInfo { id: string; file: string; src?: string; needsInterop?: boolean; browserHash?: string; fileHash?: string; /** * During optimization, ids can still be resolved to their final location * but the bundles may not yet be saved to disk */ processing?: Promise; /** * ExportData cache, discovered deps will parse the src entry to get exports * data used both to define if interop is needed and when pre-bundling */ exportsData?: Promise; isDynamicEntry?: boolean; } interface DepOptimizationMetadata { /** * The main hash is determined by user config and dependency lockfiles. * This is checked on server startup to avoid unnecessary re-bundles. */ hash: string; /** * This hash is determined by dependency lockfiles. * This is checked on server startup to avoid unnecessary re-bundles. */ lockfileHash: string; /** * This hash is determined by user config. * This is checked on server startup to avoid unnecessary re-bundles. */ configHash: string; /** * The browser hash is determined by the main hash plus additional dependencies * discovered at runtime. This is used to invalidate browser requests to * optimized deps. */ browserHash: string; /** * Metadata for each already optimized dependency */ optimized: Record; /** * Metadata for non-entry optimized chunks and dynamic imports */ chunks: Record; /** * Metadata for each newly discovered dependency after processing */ discovered: Record; /** * OptimizedDepInfo list */ depInfoList: OptimizedDepInfo[]; } /** * Scan and optimize dependencies within a project. * Used by Vite CLI when running `vite optimize`. * * @deprecated the optimization process runs automatically and does not need to be called */ declare function optimizeDeps(config: ResolvedConfig, force?: boolean | undefined, asCommand?: boolean): Promise; //#endregion //#region src/node/server/transformRequest.d.ts interface TransformResult { code: string; map: SourceMap | { mappings: ""; } | null; ssr?: boolean; etag?: string; deps?: string[]; dynamicDeps?: string[]; } interface TransformOptions { /** * @deprecated inferred from environment */ ssr?: boolean; } //#endregion //#region src/node/server/moduleGraph.d.ts declare class EnvironmentModuleNode { environment: string; /** * Public served url path, starts with / */ url: string; /** * Resolved file system path + query */ id: string | null; file: string | null; type: "js" | "css" | "asset"; info?: ModuleInfo; meta?: Record; importers: Set; importedModules: Set; acceptedHmrDeps: Set; acceptedHmrExports: Set | null; importedBindings: Map> | null; isSelfAccepting?: boolean; transformResult: TransformResult | null; ssrModule: Record | null; ssrError: Error | null; lastHMRTimestamp: number; lastInvalidationTimestamp: number; /** * @param setIsSelfAccepting - set `false` to set `isSelfAccepting` later. e.g. #7870 */ constructor(url: string, environment: string, setIsSelfAccepting?: boolean); } type ResolvedUrl = [url: string, resolvedId: string, meta: object | null | undefined]; declare class EnvironmentModuleGraph { environment: string; urlToModuleMap: Map; idToModuleMap: Map; etagToModuleMap: Map; fileToModulesMap: Map>; constructor(environment: string, resolveId: (url: string) => Promise); getModuleByUrl(rawUrl: string): Promise; getModuleById(id: string): EnvironmentModuleNode | undefined; getModulesByFile(file: string): Set | undefined; onFileChange(file: string): void; onFileDelete(file: string): void; invalidateModule(mod: EnvironmentModuleNode, seen?: Set, timestamp?: number, isHmr?: boolean, softInvalidate?: boolean): void; invalidateAll(): void; /** * Update the module graph based on a module's updated imports information * If there are dependencies that no longer have any importers, they are * returned as a Set. * * @param staticImportedUrls Subset of `importedModules` where they're statically imported in code. * This is only used for soft invalidations so `undefined` is fine but may cause more runtime processing. */ updateModuleInfo(mod: EnvironmentModuleNode, importedModules: Set, importedBindings: Map> | null, acceptedModules: Set, acceptedExports: Set | null, isSelfAccepting: boolean, staticImportedUrls?: Set): Promise | undefined>; ensureEntryFromUrl(rawUrl: string, setIsSelfAccepting?: boolean): Promise; createFileOnlyEntry(file: string): EnvironmentModuleNode; resolveUrl(url: string): Promise; updateModuleTransformResult(mod: EnvironmentModuleNode, result: TransformResult | null): void; getModuleByEtag(etag: string): EnvironmentModuleNode | undefined; } //#endregion //#region src/node/server/mixedModuleGraph.d.ts declare class ModuleNode { _moduleGraph: ModuleGraph; _clientModule: EnvironmentModuleNode | undefined; _ssrModule: EnvironmentModuleNode | undefined; constructor(moduleGraph: ModuleGraph, clientModule?: EnvironmentModuleNode, ssrModule?: EnvironmentModuleNode); _get(prop: T): EnvironmentModuleNode[T]; _set(prop: T, value: EnvironmentModuleNode[T]): void; _wrapModuleSet(prop: ModuleSetNames, module: EnvironmentModuleNode | undefined): Set; _getModuleSetUnion(prop: "importedModules" | "importers"): Set; _getModuleInfoUnion(prop: "info"): ModuleInfo | undefined; _getModuleObjectUnion(prop: "meta"): Record | undefined; get url(): string; set url(value: string); get id(): string | null; set id(value: string | null); get file(): string | null; set file(value: string | null); get type(): "js" | "css" | "asset"; get info(): ModuleInfo | undefined; get meta(): Record | undefined; get importers(): Set; get clientImportedModules(): Set; get ssrImportedModules(): Set; get importedModules(): Set; get acceptedHmrDeps(): Set; get acceptedHmrExports(): Set | null; get importedBindings(): Map> | null; get isSelfAccepting(): boolean | undefined; get transformResult(): TransformResult | null; set transformResult(value: TransformResult | null); get ssrTransformResult(): TransformResult | null; set ssrTransformResult(value: TransformResult | null); get ssrModule(): Record | null; get ssrError(): Error | null; get lastHMRTimestamp(): number; set lastHMRTimestamp(value: number); get lastInvalidationTimestamp(): number; get invalidationState(): TransformResult | "HARD_INVALIDATED" | undefined; get ssrInvalidationState(): TransformResult | "HARD_INVALIDATED" | undefined; } declare class ModuleGraph { urlToModuleMap: Map; idToModuleMap: Map; etagToModuleMap: Map; fileToModulesMap: Map>; private moduleNodeCache; constructor(moduleGraphs: { client: () => EnvironmentModuleGraph; ssr: () => EnvironmentModuleGraph; }); getModuleById(id: string): ModuleNode | undefined; getModuleByUrl(url: string, _ssr?: boolean): Promise; getModulesByFile(file: string): Set | undefined; onFileChange(file: string): void; onFileDelete(file: string): void; invalidateModule(mod: ModuleNode, seen?: Set, timestamp?: number, isHmr?: boolean, softInvalidate?: boolean): void; invalidateAll(): void; ensureEntryFromUrl(rawUrl: string, ssr?: boolean, setIsSelfAccepting?: boolean): Promise; createFileOnlyEntry(file: string): ModuleNode; resolveUrl(url: string, ssr?: boolean): Promise; updateModuleTransformResult(mod: ModuleNode, result: TransformResult | null, ssr?: boolean): void; getModuleByEtag(etag: string): ModuleNode | undefined; getBackwardCompatibleBrowserModuleNode(clientModule: EnvironmentModuleNode): ModuleNode; getBackwardCompatibleServerModuleNode(ssrModule: EnvironmentModuleNode): ModuleNode; getBackwardCompatibleModuleNode(mod: EnvironmentModuleNode): ModuleNode; getBackwardCompatibleModuleNodeDual(clientModule?: EnvironmentModuleNode, ssrModule?: EnvironmentModuleNode): ModuleNode; } type ModuleSetNames = "acceptedHmrDeps" | "importedModules"; //#endregion //#region src/node/server/hmr.d.ts interface WsOptions { protocol?: string; host?: string; port?: number; clientPort?: number; path?: string; timeout?: number; server?: HttpServer; } interface HmrOptions { /** * @deprecated Use `server.ws.protocol` instead. */ protocol?: string; /** * @deprecated Use `server.ws.host` instead. */ host?: string; /** * @deprecated Use `server.ws.port` instead. */ port?: number; /** * @deprecated Use `server.ws.clientPort` instead. */ clientPort?: number; /** * @deprecated Use `server.ws.path` instead. */ path?: string; /** * @deprecated Use `server.ws.timeout` instead. */ timeout?: number; overlay?: boolean; /** * @deprecated Use `server.ws.server` instead. */ server?: HttpServer; } interface HotUpdateOptions { type: "create" | "update" | "delete"; file: string; timestamp: number; modules: Array; read: () => string | Promise; server: ViteDevServer; } interface HmrContext { file: string; timestamp: number; modules: Array; read: () => string | Promise; server: ViteDevServer; } interface HotChannelClient { send(payload: hmrPayload_HotPayload): void; } type HotChannelListener = (data: InferCustomEventPayload, client: HotChannelClient) => void; interface HotChannel { /** * When true, the fs access check is skipped in fetchModule. * Set this for transports that is not exposed over the network. */ skipFsCheck?: boolean; /** * Broadcast events to all clients */ send?(payload: hmrPayload_HotPayload): void; /** * Handle custom event emitted by `import.meta.hot.send` */ on?(event: T, listener: HotChannelListener): void; on?(event: "connection", listener: () => void): void; /** * Unregister event listener */ off?(event: string, listener: Function): void; /** * Start listening for messages */ listen?(): void; /** * Disconnect all clients, called when server is closed or restarted. */ close?(): Promise | void; api?: Api; } interface NormalizedHotChannelClient { /** * Send event to the client */ send(payload: hmrPayload_HotPayload): void; /** * Send custom event */ send(event: string, payload?: hmrPayload_CustomPayload["data"]): void; } interface NormalizedHotChannel { /** * Broadcast events to all clients */ send(payload: hmrPayload_HotPayload): void; /** * Send custom event */ send(event: T, payload?: InferCustomEventPayload): void; /** * Handle custom event emitted by `import.meta.hot.send` */ on(event: T, listener: (data: InferCustomEventPayload, client: NormalizedHotChannelClient) => void): void; /** * @deprecated use `vite:client:connect` event instead */ on(event: "connection", listener: () => void): void; /** * Unregister event listener */ off(event: string, listener: Function): void; handleInvoke(payload: hmrPayload_HotPayload): Promise<{ result: any; } | { error: any; }>; /** * Start listening for messages */ listen(): void; /** * Disconnect all clients, called when server is closed or restarted. */ close(): Promise | void; api?: Api; } type ServerHotChannelApi = { innerEmitter: EventEmitter; outsideEmitter: EventEmitter; }; type ServerHotChannel = HotChannel; type NormalizedServerHotChannel = NormalizedHotChannel; declare function createServerHotChannel(): ServerHotChannel; //#endregion //#region src/types/ws.d.ts // WebSocket socket. declare class WebSocket extends EventEmitter { /** The connection is not yet open. */ static readonly CONNECTING: 0; /** The connection is open and ready to communicate. */ static readonly OPEN: 1; /** The connection is in the process of closing. */ static readonly CLOSING: 2; /** The connection is closed. */ static readonly CLOSED: 3; binaryType: 'nodebuffer' | 'arraybuffer' | 'fragments'; readonly bufferedAmount: number; readonly extensions: string; /** Indicates whether the websocket is paused */ readonly isPaused: boolean; readonly protocol: string; /** The current state of the connection */ readonly readyState: typeof WebSocket.CONNECTING | typeof WebSocket.OPEN | typeof WebSocket.CLOSING | typeof WebSocket.CLOSED; readonly url: string; /** The connection is not yet open. */ readonly CONNECTING: 0; /** The connection is open and ready to communicate. */ readonly OPEN: 1; /** The connection is in the process of closing. */ readonly CLOSING: 2; /** The connection is closed. */ readonly CLOSED: 3; onopen: ((event: WebSocket.Event) => void) | null; onerror: ((event: WebSocket.ErrorEvent) => void) | null; onclose: ((event: WebSocket.CloseEvent) => void) | null; onmessage: ((event: WebSocket.MessageEvent) => void) | null; constructor(address: null); constructor(address: string | url_URL, options?: WebSocket.ClientOptions | ClientRequestArgs); constructor(address: string | url_URL, protocols?: string | string[], options?: WebSocket.ClientOptions | ClientRequestArgs); close(code?: number, data?: string | Buffer): void; ping(data?: any, mask?: boolean, cb?: (err: Error) => void): void; pong(data?: any, mask?: boolean, cb?: (err: Error) => void): void; send(data: any, cb?: (err?: Error) => void): void; send(data: any, options: { mask?: boolean | undefined; binary?: boolean | undefined; compress?: boolean | undefined; fin?: boolean | undefined; }, cb?: (err?: Error) => void): void; terminate(): void; /** * Pause the websocket causing it to stop emitting events. Some events can still be * emitted after this is called, until all buffered data is consumed. This method * is a noop if the ready state is `CONNECTING` or `CLOSED`. */ pause(): void; /** * Make a paused socket resume emitting events. This method is a noop if the ready * state is `CONNECTING` or `CLOSED`. */ resume(): void; // HTML5 WebSocket events addEventListener(method: 'message', cb: (event: WebSocket.MessageEvent) => void, options?: WebSocket.EventListenerOptions): void; addEventListener(method: 'close', cb: (event: WebSocket.CloseEvent) => void, options?: WebSocket.EventListenerOptions): void; addEventListener(method: 'error', cb: (event: WebSocket.ErrorEvent) => void, options?: WebSocket.EventListenerOptions): void; addEventListener(method: 'open', cb: (event: WebSocket.Event) => void, options?: WebSocket.EventListenerOptions): void; removeEventListener(method: 'message', cb: (event: WebSocket.MessageEvent) => void): void; removeEventListener(method: 'close', cb: (event: WebSocket.CloseEvent) => void): void; removeEventListener(method: 'error', cb: (event: WebSocket.ErrorEvent) => void): void; removeEventListener(method: 'open', cb: (event: WebSocket.Event) => void): void; // Events on(event: 'close', listener: (this: WebSocket, code: number, reason: Buffer) => void): this; on(event: 'error', listener: (this: WebSocket, err: Error) => void): this; on(event: 'upgrade', listener: (this: WebSocket, request: http.IncomingMessage) => void): this; on(event: 'message', listener: (this: WebSocket, data: WebSocket.RawData, isBinary: boolean) => void): this; on(event: 'open', listener: (this: WebSocket) => void): this; on(event: 'ping' | 'pong', listener: (this: WebSocket, data: Buffer) => void): this; on(event: 'unexpected-response', listener: (this: WebSocket, request: ClientRequest, response: http.IncomingMessage) => void): this; on(event: string | symbol, listener: (this: WebSocket, ...args: any[]) => void): this; once(event: 'close', listener: (this: WebSocket, code: number, reason: Buffer) => void): this; once(event: 'error', listener: (this: WebSocket, err: Error) => void): this; once(event: 'upgrade', listener: (this: WebSocket, request: http.IncomingMessage) => void): this; once(event: 'message', listener: (this: WebSocket, data: WebSocket.RawData, isBinary: boolean) => void): this; once(event: 'open', listener: (this: WebSocket) => void): this; once(event: 'ping' | 'pong', listener: (this: WebSocket, data: Buffer) => void): this; once(event: 'unexpected-response', listener: (this: WebSocket, request: ClientRequest, response: http.IncomingMessage) => void): this; once(event: string | symbol, listener: (this: WebSocket, ...args: any[]) => void): this; off(event: 'close', listener: (this: WebSocket, code: number, reason: Buffer) => void): this; off(event: 'error', listener: (this: WebSocket, err: Error) => void): this; off(event: 'upgrade', listener: (this: WebSocket, request: http.IncomingMessage) => void): this; off(event: 'message', listener: (this: WebSocket, data: WebSocket.RawData, isBinary: boolean) => void): this; off(event: 'open', listener: (this: WebSocket) => void): this; off(event: 'ping' | 'pong', listener: (this: WebSocket, data: Buffer) => void): this; off(event: 'unexpected-response', listener: (this: WebSocket, request: ClientRequest, response: http.IncomingMessage) => void): this; off(event: string | symbol, listener: (this: WebSocket, ...args: any[]) => void): this; addListener(event: 'close', listener: (code: number, reason: Buffer) => void): this; addListener(event: 'error', listener: (err: Error) => void): this; addListener(event: 'upgrade', listener: (request: http.IncomingMessage) => void): this; addListener(event: 'message', listener: (data: WebSocket.RawData, isBinary: boolean) => void): this; addListener(event: 'open', listener: () => void): this; addListener(event: 'ping' | 'pong', listener: (data: Buffer) => void): this; addListener(event: 'unexpected-response', listener: (request: ClientRequest, response: http.IncomingMessage) => void): this; addListener(event: string | symbol, listener: (...args: any[]) => void): this; removeListener(event: 'close', listener: (code: number, reason: Buffer) => void): this; removeListener(event: 'error', listener: (err: Error) => void): this; removeListener(event: 'upgrade', listener: (request: http.IncomingMessage) => void): this; removeListener(event: 'message', listener: (data: WebSocket.RawData, isBinary: boolean) => void): this; removeListener(event: 'open', listener: () => void): this; removeListener(event: 'ping' | 'pong', listener: (data: Buffer) => void): this; removeListener(event: 'unexpected-response', listener: (request: ClientRequest, response: http.IncomingMessage) => void): this; removeListener(event: string | symbol, listener: (...args: any[]) => void): this; } declare const WebSocketAlias: typeof WebSocket; interface WebSocketAlias extends WebSocket {} declare namespace WebSocket { /** * Data represents the raw message payload received over the WebSocket. */ type RawData = Buffer | ArrayBuffer | Buffer[]; /** * Data represents the message payload received over the WebSocket. */ type Data = string | Buffer | ArrayBuffer | Buffer[]; /** * CertMeta represents the accepted types for certificate & key data. */ type CertMeta = string | string[] | Buffer | Buffer[]; /** * VerifyClientCallbackSync is a synchronous callback used to inspect the * incoming message. The return value (boolean) of the function determines * whether or not to accept the handshake. */ type VerifyClientCallbackSync = (info: { origin: string; secure: boolean; req: http.IncomingMessage; }) => boolean; /** * VerifyClientCallbackAsync is an asynchronous callback used to inspect the * incoming message. The return value (boolean) of the function determines * whether or not to accept the handshake. */ type VerifyClientCallbackAsync = (info: { origin: string; secure: boolean; req: http.IncomingMessage; }, callback: (res: boolean, code?: number, message?: string, headers?: OutgoingHttpHeaders) => void) => void; interface ClientOptions extends SecureContextOptions { protocol?: string | undefined; followRedirects?: boolean | undefined; generateMask?(mask: Buffer): void; handshakeTimeout?: number | undefined; maxRedirects?: number | undefined; perMessageDeflate?: boolean | PerMessageDeflateOptions | undefined; localAddress?: string | undefined; protocolVersion?: number | undefined; headers?: { [key: string]: string; } | undefined; origin?: string | undefined; agent?: Agent | undefined; host?: string | undefined; family?: number | undefined; checkServerIdentity?(servername: string, cert: CertMeta): boolean; rejectUnauthorized?: boolean | undefined; maxPayload?: number | undefined; skipUTF8Validation?: boolean | undefined; } interface PerMessageDeflateOptions { serverNoContextTakeover?: boolean | undefined; clientNoContextTakeover?: boolean | undefined; serverMaxWindowBits?: number | undefined; clientMaxWindowBits?: number | undefined; zlibDeflateOptions?: { flush?: number | undefined; finishFlush?: number | undefined; chunkSize?: number | undefined; windowBits?: number | undefined; level?: number | undefined; memLevel?: number | undefined; strategy?: number | undefined; dictionary?: Buffer | Buffer[] | DataView | undefined; info?: boolean | undefined; } | undefined; zlibInflateOptions?: ZlibOptions | undefined; threshold?: number | undefined; concurrencyLimit?: number | undefined; } interface Event { type: string; target: WebSocket; } interface ErrorEvent { error: any; message: string; type: string; target: WebSocket; } interface CloseEvent { wasClean: boolean; code: number; reason: string; type: string; target: WebSocket; } interface MessageEvent { data: Data; type: string; target: WebSocket; } interface EventListenerOptions { once?: boolean | undefined; } interface ServerOptions { host?: string | undefined; port?: number | undefined; backlog?: number | undefined; server?: http.Server | HttpsServer | undefined; verifyClient?: VerifyClientCallbackAsync | VerifyClientCallbackSync | undefined; handleProtocols?: (protocols: Set, request: http.IncomingMessage) => string | false; path?: string | undefined; noServer?: boolean | undefined; clientTracking?: boolean | undefined; perMessageDeflate?: boolean | PerMessageDeflateOptions | undefined; maxPayload?: number | undefined; skipUTF8Validation?: boolean | undefined; WebSocket?: typeof WebSocket.WebSocket | undefined; } interface AddressInfo { address: string; family: string; port: number; } // WebSocket Server class Server extends EventEmitter { options: ServerOptions; path: string; clients: Set; constructor(options?: ServerOptions, callback?: () => void); address(): AddressInfo | string; close(cb?: (err?: Error) => void): void; handleUpgrade(request: http.IncomingMessage, socket: Duplex, upgradeHead: Buffer, callback: (client: T, request: http.IncomingMessage) => void): void; shouldHandle(request: http.IncomingMessage): boolean | Promise; // Events on(event: 'connection', cb: (this: Server, socket: T, request: http.IncomingMessage) => void): this; on(event: 'error', cb: (this: Server, error: Error) => void): this; on(event: 'headers', cb: (this: Server, headers: string[], request: http.IncomingMessage) => void): this; on(event: 'close' | 'listening', cb: (this: Server) => void): this; on(event: string | symbol, listener: (this: Server, ...args: any[]) => void): this; once(event: 'connection', cb: (this: Server, socket: T, request: http.IncomingMessage) => void): this; once(event: 'error', cb: (this: Server, error: Error) => void): this; once(event: 'headers', cb: (this: Server, headers: string[], request: http.IncomingMessage) => void): this; once(event: 'close' | 'listening', cb: (this: Server) => void): this; once(event: string | symbol, listener: (this: Server, ...args: any[]) => void): this; off(event: 'connection', cb: (this: Server, socket: T, request: http.IncomingMessage) => void): this; off(event: 'error', cb: (this: Server, error: Error) => void): this; off(event: 'headers', cb: (this: Server, headers: string[], request: http.IncomingMessage) => void): this; off(event: 'close' | 'listening', cb: (this: Server) => void): this; off(event: string | symbol, listener: (this: Server, ...args: any[]) => void): this; addListener(event: 'connection', cb: (client: T, request: http.IncomingMessage) => void): this; addListener(event: 'error', cb: (err: Error) => void): this; addListener(event: 'headers', cb: (headers: string[], request: http.IncomingMessage) => void): this; addListener(event: 'close' | 'listening', cb: () => void): this; addListener(event: string | symbol, listener: (...args: any[]) => void): this; removeListener(event: 'connection', cb: (client: T) => void): this; removeListener(event: 'error', cb: (err: Error) => void): this; removeListener(event: 'headers', cb: (headers: string[], request: http.IncomingMessage) => void): this; removeListener(event: 'close' | 'listening', cb: () => void): this; removeListener(event: string | symbol, listener: (...args: any[]) => void): this; } const WebSocketServer: typeof Server; interface WebSocketServer extends Server {} const WebSocket: typeof WebSocketAlias; interface WebSocket extends WebSocketAlias {} // WebSocket stream function createWebSocketStream(websocket: WebSocket, options?: DuplexOptions): Duplex; } // export = WebSocket //#endregion //#region src/node/server/ws.d.ts type WebSocketCustomListener = (data: T, client: WebSocketClient) => void; declare const isWebSocketServer: unique symbol; interface WebSocketServer extends NormalizedHotChannel { /** * Handle custom event emitted by `import.meta.hot.send` */ on: WebSocket.Server["on"] & { (event: T, listener: WebSocketCustomListener>): void; }; /** * Unregister event listener. */ off: WebSocket.Server["off"] & { (event: string, listener: Function): void; }; /** * Listen on port and host */ listen(): void; /** * Disconnect all clients and terminate the server. */ close(): Promise; [isWebSocketServer]: true; /** * Get all connected clients. */ clients: Set; } interface WebSocketClient extends NormalizedHotChannelClient { /** * The raw WebSocket instance * @advanced */ socket: WebSocket; } //#endregion //#region src/node/server/bundledDev.d.ts type MemoryFile = { source: string | Uint8Array; etag?: string; }; declare class MemoryFiles { private files; get size(): number; get(file: string): MemoryFile | undefined; set(file: string, content: MemoryFile | (() => MemoryFile)): void; has(file: string): boolean; clear(): void; } declare class BundledDev { private environment; private _devEngine; private initialBuildCompleted; private clients; private invalidateCalledModules; private debouncedFullReload; private fullReloadPending; private lastBuildError; memoryFiles: MemoryFiles; constructor(environment: DevEnvironment); private get devEngine(); listen(): Promise; private waitForInitialBuildFinish; invalidateModule(m: { path: string; message?: string; firstInvalidatedBy: string; }, client: NormalizedHotChannelClient): Promise; triggerBundleRegenerationIfStale(): Promise; triggerLazyBundling(moduleId: string | null, clientId: string | null): Promise; close(): Promise; private getRolldownOptions; private handleHmrOutput; } //#endregion //#region src/node/server/environment.d.ts interface DevEnvironmentContext { hot: boolean; transport?: HotChannel | WebSocketServer; options?: EnvironmentOptions; remoteRunner?: { inlineSourceMap?: boolean; }; depsOptimizer?: DepsOptimizer; } declare class DevEnvironment extends BaseEnvironment { mode: "dev"; moduleGraph: EnvironmentModuleGraph; depsOptimizer?: DepsOptimizer; get pluginContainer(): EnvironmentPluginContainer; /** * Hot channel for this environment. If not provided or disabled, * it will be a noop channel that does nothing. * * @example * environment.hot.send({ type: 'full-reload' }) */ hot: NormalizedHotChannel; bundledDev?: BundledDev; constructor(name: string, config: ResolvedConfig, context: DevEnvironmentContext); init(options?: { watcher?: FSWatcher; /** * the previous instance used for the environment with the same name * * when using, the consumer should check if it's an instance generated from the same class or factory function */ previousInstance?: DevEnvironment; }): Promise; /** * When the dev server is restarted, the methods are called in the following order: * - new instance `init` * - previous instance `close` * - new instance `listen` */ listen(server: ViteDevServer): Promise; /** * Called by the module runner to retrieve information about the specified * module. Internally calls `transformRequest` and wraps the result in the * format that the module runner understands. * This method is not meant to be called manually. */ fetchModule(id: string, importer?: string, options?: FetchFunctionOptions): Promise; reloadModule(module: EnvironmentModuleNode): Promise; transformRequest(url: string): Promise; warmupRequest(url: string): Promise; protected invalidateModule(m: { path: string; message?: string; firstInvalidatedBy: string; }, _client: NormalizedHotChannelClient): void; close(): Promise; /** * Calling `await environment.waitForRequestsIdle(id)` will wait until all static imports * are processed after the first transformRequest call. 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 */ waitForRequestsIdle(ignoredId?: string): Promise; } //#endregion //#region src/types/commonjs.d.ts interface RollupCommonJSOptions { /** * A minimatch pattern, or array of patterns, which specifies the files in * the build the plugin should operate on. By default, all files with * extension `".cjs"` or those in `extensions` are included, but you can * narrow this list by only including specific files. These files will be * analyzed and transpiled if either the analysis does not find ES module * specific statements or `transformMixedEsModules` is `true`. * @default undefined */ include?: string | RegExp | readonly (string | RegExp)[]; /** * A minimatch pattern, or array of patterns, which specifies the files in * the build the plugin should _ignore_. By default, all files with * extensions other than those in `extensions` or `".cjs"` are ignored, but you * can exclude additional files. See also the `include` option. * @default undefined */ exclude?: string | RegExp | readonly (string | RegExp)[]; /** * For extensionless imports, search for extensions other than .js in the * order specified. Note that you need to make sure that non-JavaScript files * are transpiled by another plugin first. * @default [ '.js' ] */ extensions?: ReadonlyArray; /** * If true then uses of `global` won't be dealt with by this plugin * @default false */ ignoreGlobal?: boolean; /** * If false, skips source map generation for CommonJS modules. This will * improve performance. * @default true */ sourceMap?: boolean; /** * Some `require` calls cannot be resolved statically to be translated to * imports. * When this option is set to `false`, the generated code will either * directly throw an error when such a call is encountered or, when * `dynamicRequireTargets` is used, when such a call cannot be resolved with a * configured dynamic require target. * Setting this option to `true` will instead leave the `require` call in the * code or use it as a fallback for `dynamicRequireTargets`. * @default false */ ignoreDynamicRequires?: boolean; /** * Instructs the plugin whether to enable mixed module transformations. This * is useful in scenarios with modules that contain a mix of ES `import` * statements and CommonJS `require` expressions. Set to `true` if `require` * calls should be transformed to imports in mixed modules, or `false` if the * `require` expressions should survive the transformation. The latter can be * important if the code contains environment detection, or you are coding * for an environment with special treatment for `require` calls such as * ElectronJS. See also the `ignore` option. * @default false */ transformMixedEsModules?: boolean; /** * By default, this plugin will try to hoist `require` statements as imports * to the top of each file. While this works well for many code bases and * allows for very efficient ESM output, it does not perfectly capture * CommonJS semantics as the order of side effects like log statements may * change. But it is especially problematic when there are circular `require` * calls between CommonJS modules as those often rely on the lazy execution of * nested `require` calls. * * Setting this option to `true` will wrap all CommonJS files in functions * which are executed when they are required for the first time, preserving * NodeJS semantics. Note that this can have an impact on the size and * performance of the generated code. * * The default value of `"auto"` will only wrap CommonJS files when they are * part of a CommonJS dependency cycle, e.g. an index file that is required by * many of its dependencies. All other CommonJS files are hoisted. This is the * recommended setting for most code bases. * * `false` will entirely prevent wrapping and hoist all files. This may still * work depending on the nature of cyclic dependencies but will often cause * problems. * * You can also provide a minimatch pattern, or array of patterns, to only * specify a subset of files which should be wrapped in functions for proper * `require` semantics. * * `"debug"` works like `"auto"` but after bundling, it will display a warning * containing a list of ids that have been wrapped which can be used as * minimatch pattern for fine-tuning. * @default "auto" */ strictRequires?: boolean | string | RegExp | readonly (string | RegExp)[]; /** * Sometimes you have to leave require statements unconverted. Pass an array * containing the IDs or a `id => boolean` function. * @default [] */ ignore?: ReadonlyArray | ((id: string) => boolean); /** * In most cases, where `require` calls are inside a `try-catch` clause, * they should be left unconverted as it requires an optional dependency * that may or may not be installed beside the rolled up package. * Due to the conversion of `require` to a static `import` - the call is * hoisted to the top of the file, outside the `try-catch` clause. * * - `true`: Default. All `require` calls inside a `try` will be left unconverted. * - `false`: All `require` calls inside a `try` will be converted as if the * `try-catch` clause is not there. * - `remove`: Remove all `require` calls from inside any `try` block. * - `string[]`: Pass an array containing the IDs to left unconverted. * - `((id: string) => boolean|'remove')`: Pass a function that controls * individual IDs. * * @default true */ ignoreTryCatch?: boolean | 'remove' | ReadonlyArray | ((id: string) => boolean | 'remove'); /** * Controls how to render imports from external dependencies. By default, * this plugin assumes that all external dependencies are CommonJS. This * means they are rendered as default imports to be compatible with e.g. * NodeJS where ES modules can only import a default export from a CommonJS * dependency. * * If you set `esmExternals` to `true`, this plugin assumes that all * external dependencies are ES modules and respect the * `requireReturnsDefault` option. If that option is not set, they will be * rendered as namespace imports. * * You can also supply an array of ids to be treated as ES modules, or a * function that will be passed each external id to determine whether it is * an ES module. * @default false */ esmExternals?: boolean | ReadonlyArray | ((id: string) => boolean); /** * Controls what is returned when requiring an ES module from a CommonJS file. * When using the `esmExternals` option, this will also apply to external * modules. By default, this plugin will render those imports as namespace * imports i.e. * * ```js * // input * const foo = require('foo'); * * // output * import * as foo from 'foo'; * ``` * * However, there are some situations where this may not be desired. * For these situations, you can change Rollup's behaviour either globally or * per module. To change it globally, set the `requireReturnsDefault` option * to one of the following values: * * - `false`: This is the default, requiring an ES module returns its * namespace. This is the only option that will also add a marker * `__esModule: true` to the namespace to support interop patterns in * CommonJS modules that are transpiled ES modules. * - `"namespace"`: Like `false`, requiring an ES module returns its * namespace, but the plugin does not add the `__esModule` marker and thus * creates more efficient code. For external dependencies when using * `esmExternals: true`, no additional interop code is generated. * - `"auto"`: This is complementary to how `output.exports: "auto"` works in * Rollup: If a module has a default export and no named exports, requiring * that module returns the default export. In all other cases, the namespace * is returned. For external dependencies when using `esmExternals: true`, a * corresponding interop helper is added. * - `"preferred"`: If a module has a default export, requiring that module * always returns the default export, no matter whether additional named * exports exist. This is similar to how previous versions of this plugin * worked. Again for external dependencies when using `esmExternals: true`, * an interop helper is added. * - `true`: This will always try to return the default export on require * without checking if it actually exists. This can throw at build time if * there is no default export. This is how external dependencies are handled * when `esmExternals` is not used. The advantage over the other options is * that, like `false`, this does not add an interop helper for external * dependencies, keeping the code lean. * * To change this for individual modules, you can supply a function for * `requireReturnsDefault` instead. This function will then be called once for * each required ES module or external dependency with the corresponding id * and allows you to return different values for different modules. * @default false */ requireReturnsDefault?: boolean | 'auto' | 'preferred' | 'namespace' | ((id: string) => boolean | 'auto' | 'preferred' | 'namespace'); /** * @default "auto" */ defaultIsModuleExports?: boolean | 'auto' | ((id: string) => boolean | 'auto'); /** * Some modules contain dynamic `require` calls, or require modules that * contain circular dependencies, which are not handled well by static * imports. Including those modules as `dynamicRequireTargets` will simulate a * CommonJS (NodeJS-like) environment for them with support for dynamic * dependencies. It also enables `strictRequires` for those modules. * * Note: In extreme cases, this feature may result in some paths being * rendered as absolute in the final bundle. The plugin tries to avoid * exposing paths from the local machine, but if you are `dynamicRequirePaths` * with paths that are far away from your project's folder, that may require * replacing strings like `"/Users/John/Desktop/foo-project/"` -\> `"/"`. */ dynamicRequireTargets?: string | ReadonlyArray; /** * To avoid long paths when using the `dynamicRequireTargets` option, you can use this option to specify a directory * that is a common parent for all files that use dynamic require statements. Using a directory higher up such as `/` * may lead to unnecessarily long paths in the generated code and may expose directory names on your machine like your * home directory name. By default, it uses the current working directory. */ dynamicRequireRoot?: string; } //#endregion //#region src/types/dynamicImportVars.d.ts interface RollupDynamicImportVarsOptions { /** * Files to include in this plugin (default all). * @default [] */ include?: string | RegExp | (string | RegExp)[]; /** * Files to exclude in this plugin (default none). * @default [] */ exclude?: string | RegExp | (string | RegExp)[]; /** * @deprecated This option is no-op and will be removed in future versions. */ warnOnError?: boolean; } //#endregion //#region src/node/plugins/terser.d.ts interface TerserOptions extends TerserMinifyOptions { /** * Vite-specific option to specify the max number of workers to spawn * when minifying files with terser. * * @default number of CPUs minus 1 */ maxWorkers?: number; } //#endregion //#region src/node/plugins/resolve.d.ts interface EnvironmentResolveOptions { /** * @default ['browser', 'module', 'jsnext:main', 'jsnext'] */ mainFields?: string[]; conditions?: string[]; externalConditions?: string[]; /** * @default ['.mjs', '.js', '.mts', '.ts', '.jsx', '.tsx', '.json'] */ extensions?: string[]; dedupe?: string[]; /** * Prevent listed dependencies from being externalized and will get bundled in build. * Only works in server environments for now. Previously this was `ssr.noExternal`. * @experimental */ noExternal?: string | RegExp | (string | RegExp)[] | true; /** * Externalize the given dependencies and their transitive dependencies. * Only works in server environments for now. Previously this was `ssr.external`. * @experimental */ external?: string[] | true; /** * Array of strings or regular expressions that indicate what modules are builtin for the environment. */ builtins?: (string | RegExp)[]; } interface ResolveOptions extends EnvironmentResolveOptions { /** * @default false */ preserveSymlinks?: boolean; /** * Enable tsconfig paths resolution * * @default false * @experimental */ tsconfigPaths?: boolean; } interface ResolvePluginOptions { root: string; isBuild: boolean; isProduction: boolean; packageCache?: PackageCache; /** * src code mode also attempts the following: * - resolving /xxx as URLs * - resolving bare imports from optimized deps */ asSrc?: boolean; tryIndex?: boolean; tryPrefix?: string; preferRelative?: boolean; isRequire?: boolean; scan?: boolean; /** * Enable when `legacy.inconsistentCjsInterop` is true. See that option for more details. */ legacyInconsistentCjsInterop?: boolean; } interface InternalResolveOptions extends Required, ResolvePluginOptions {} //#endregion //#region src/node/packages.d.ts /** Cache for package.json resolution and package.json contents */ type PackageCache = Map; interface PackageData { dir: string; hasSideEffects: (id: string) => boolean | "no-treeshake" | null; setResolvedCache: (key: string, entry: string, options: InternalResolveOptions) => void; getResolvedCache: (key: string, options: InternalResolveOptions) => string | undefined; data: { [field: string]: any; name: string; type: string; version: string; main: string; module: string; browser: string | Record; exports: string | Record | string[]; imports: Record; dependencies: Record; }; } //#endregion //#region src/node/plugins/license.d.ts interface LicenseOptions { /** * The output file name of the license file relative to the output directory. * Specify a path that ends with `.json` to output the raw JSON metadata. * * @default '.vite/license.md' */ fileName: string; } //#endregion //#region src/node/build.d.ts interface BuildEnvironmentOptions { /** * Compatibility transform target. The transform is performed with esbuild * and the lowest supported target is es2015. Note this only handles * syntax transformation and does not cover polyfills * * Default: 'baseline-widely-available' - transpile targeting browsers that * are included in the Baseline Widely Available on 2026-01-01. * (Chrome 111+, Edge 111+, Firefox 114+, Safari 16.4+). * * Another special value is 'esnext' - which only performs minimal transpiling * (for minification compat). * * For custom targets, see https://esbuild.github.io/api/#target and * https://esbuild.github.io/content-types/#javascript for more details. * @default 'baseline-widely-available' */ target?: "baseline-widely-available" | EsbuildTarget | false; /** * whether to inject module preload polyfill. * Note: does not apply to library mode. * @default true * @deprecated use `modulePreload.polyfill` instead */ polyfillModulePreload?: boolean; /** * Configure module preload * Note: does not apply to library mode. * @default true */ modulePreload?: boolean | ModulePreloadOptions; /** * Directory relative from `root` where build output will be placed. If the * directory exists, it will be removed before the build. * @default 'dist' */ outDir?: string; /** * Directory relative from `outDir` where the built js/css/image assets will * be placed. * @default 'assets' */ assetsDir?: string; /** * Static asset files smaller than this number (in bytes) will be inlined as * base64 strings. If a callback is passed, a boolean can be returned to opt-in * or opt-out of inlining. If nothing is returned the default logic applies. * * Default limit is `4096` (4 KiB). Set to `0` to disable. * @default 4096 */ assetsInlineLimit?: number | ((filePath: string, content: Buffer) => boolean | undefined); /** * Whether to code-split CSS. When enabled, CSS in async chunks will be * inlined as strings in the chunk and inserted via dynamically created * style tags when the chunk is loaded. * @default true */ cssCodeSplit?: boolean; /** * An optional separate target for CSS minification. * As esbuild only supports configuring targets to mainstream * browsers, users may need this option when they are targeting * a niche browser that comes with most modern JavaScript features * but has poor CSS support, e.g. Android WeChat WebView, which * doesn't support the #RGBA syntax. * @default target */ cssTarget?: EsbuildTarget | false; /** * Override CSS minification specifically instead of defaulting to `build.minify`, * so you can configure minification for JS and CSS separately. * @default 'lightningcss' */ cssMinify?: boolean | "lightningcss" | "esbuild"; /** * If `true`, a separate sourcemap file will be created. If 'inline', the * sourcemap will be appended to the resulting output file as data URI. * 'hidden' works like `true` except that the corresponding sourcemap * comments in the bundled files are suppressed. * @default false */ sourcemap?: boolean | "inline" | "hidden"; /** * Set to `false` to disable minification, or specify the minifier to use. * Available options are 'oxc' or 'terser' or 'esbuild'. * @default 'oxc' */ minify?: boolean | "oxc" | "terser" | "esbuild"; /** * Options for terser * https://terser.org/docs/api-reference#minify-options * * In addition, you can also pass a `maxWorkers: number` option to specify the * max number of workers to spawn. Defaults to the number of CPUs minus 1. */ terserOptions?: TerserOptions; /** * Whether to use import maps feature to optimize chunk caching efficiency. * @default false * @experimental */ chunkImportMap?: boolean; /** * Alias to `rolldownOptions` * @deprecated Use `rolldownOptions` instead. */ rollupOptions?: RolldownOptions; /** * Will be merged with internal rolldown options. * https://rolldown.rs/reference/Interface.RolldownOptions */ rolldownOptions?: RolldownOptions; /** * Options to pass on to `@rollup/plugin-commonjs` * @deprecated This option is no-op and will be removed in future versions. */ commonjsOptions?: RollupCommonJSOptions; /** * Options to pass on to `@rollup/plugin-dynamic-import-vars` */ dynamicImportVarsOptions?: RollupDynamicImportVarsOptions; /** * Whether to write bundle to disk * @default true */ write?: boolean; /** * Empty outDir on write. * @default true when outDir is a sub directory of project root */ emptyOutDir?: boolean | null; /** * Copy the public directory to outDir on write. * @default true */ copyPublicDir?: boolean; /** * Whether to emit a `.vite/license.md` file that includes all bundled dependencies' * licenses. Pass an object to customize the output file name. * @default false */ license?: boolean | LicenseOptions; /** * Whether to emit a .vite/manifest.json in the output dir to map hash-less filenames * to their hashed versions. Useful when you want to generate your own HTML * instead of using the one generated by Vite. * * Example: * * ```json * { * "main.js": { * "file": "main.68fe3fad.js", * "css": "main.e6b63442.css", * "imports": [...], * "dynamicImports": [...] * } * } * ``` * @default false */ manifest?: boolean | string; /** * Build in library mode. The value should be the global name of the lib in * UMD mode. This will produce esm + cjs + umd bundle formats with default * configurations that are suitable for distributing libraries. * @default false */ lib?: LibraryOptions | false; /** * Produce SSR oriented build. Note this requires specifying SSR entry via * `rolldownOptions.input`. * @default false */ ssr?: boolean | string; /** * Generate SSR manifest for determining style links and asset preload * directives in production. * @default false */ ssrManifest?: boolean | string; /** * Emit assets during SSR. * @default false */ ssrEmitAssets?: boolean; /** * Emit assets during build. Frameworks can set environments.ssr.build.emitAssets * By default, it is true for the client and false for other environments. */ emitAssets?: boolean; /** * Set to false to disable reporting compressed chunk sizes. * Can slightly improve build speed. * @default true */ reportCompressedSize?: boolean; /** * Adjust chunk size warning limit (in kB). * @default 500 */ chunkSizeWarningLimit?: number; /** * Rollup watch options * https://rollupjs.org/configuration-options/#watch * @default null */ watch?: WatcherOptions | null; /** * create the Build Environment instance */ createEnvironment?: (name: string, config: ResolvedConfig) => Promise | BuildEnvironment; } type BuildOptions = BuildEnvironmentOptions; interface LibraryOptions { /** * Path of library entry */ entry: InputOption; /** * The name of the exposed global variable. Required when the `formats` option includes * `umd` or `iife` */ name?: string; /** * Output bundle formats * @default ['es', 'umd'] */ formats?: LibraryFormats[]; /** * The name of the package file output. The default file name is the name option * of the project package.json. It can also be defined as a function taking the * format as an argument. */ fileName?: string | ((format: ModuleFormat, entryName: string) => string); /** * The name of the CSS file output if the library imports CSS. Defaults to the * same value as `build.lib.fileName` if it's set a string, otherwise it falls * back to the name option of the project package.json. */ cssFileName?: string; } type LibraryFormats = "es" | "cjs" | "umd" | "iife"; interface ModulePreloadOptions { /** * Whether to inject a module preload polyfill. * Note: does not apply to library mode. * @default true */ polyfill?: boolean; /** * Resolve the list of dependencies to preload for a given dynamic import * @experimental */ resolveDependencies?: ResolveModulePreloadDependenciesFn; } interface ResolvedModulePreloadOptions { polyfill: boolean; resolveDependencies?: ResolveModulePreloadDependenciesFn; } type ResolveModulePreloadDependenciesFn = (filename: string, deps: string[], context: { hostId: string; hostType: "html" | "js"; }) => string[]; interface ResolvedBuildEnvironmentOptions extends Required> { modulePreload: false | ResolvedModulePreloadOptions; } interface ResolvedBuildOptions extends Required> { modulePreload: false | ResolvedModulePreloadOptions; } /** * Bundles a single environment for production. * Returns a Promise containing the build result. */ declare function build(inlineConfig?: InlineConfig): Promise; type RenderBuiltAssetUrl = (filename: string, type: { type: "asset" | "public"; hostId: string; hostType: "js" | "css" | "html"; ssr: boolean; }) => string | { relative?: boolean; runtime?: string; } | undefined; declare class BuildEnvironment extends BaseEnvironment { mode: "build"; isBuilt: boolean; constructor(name: string, config: ResolvedConfig, setup?: { options?: EnvironmentOptions; }); init(): Promise; } interface ViteBuilder { environments: Record; config: ResolvedConfig; buildApp(): Promise; build(environment: BuildEnvironment): Promise; runDevTools(): Promise; } interface BuilderOptions { /** * Whether to share the config instance among environments to align with the behavior of dev server. * * @default false * @experimental */ sharedConfigBuild?: boolean; /** * Whether to share the plugin instances among environments to align with the behavior of dev server. * * @default false * @experimental */ sharedPlugins?: boolean; buildApp?: (builder: ViteBuilder) => Promise; } type ResolvedBuilderOptions = Required; /** * Creates a ViteBuilder to orchestrate building multiple environments. * @experimental */ declare function createBuilder(inlineConfig?: InlineConfig, useLegacyBuilder?: null | boolean): Promise; type BuildAppHook = (this: MinimalPluginContextWithoutEnvironment, builder: ViteBuilder) => Promise; //#endregion //#region src/node/environment.d.ts type Environment = DevEnvironment | BuildEnvironment | ScanEnvironment | UnknownEnvironment; /** * 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 * * @experimental */ declare function perEnvironmentState(initial: (environment: Environment) => State): (context: PluginContext) => State; //#endregion //#region src/node/server/pluginContainer.d.ts type SkipInformation = { id: string; importer: string | undefined; plugin: Plugin; called?: boolean; }; declare class EnvironmentPluginContainer { private _pluginContextMap; private _resolvedRolldownOptions?; private _processesing; private _seenResolves; private _moduleNodeToLoadAddedImports; getSortedPluginHooks: PluginHookUtils["getSortedPluginHooks"]; getSortedPlugins: PluginHookUtils["getSortedPlugins"]; moduleGraph: EnvironmentModuleGraph | undefined; watchFiles: Set; minimalContext: MinimalPluginContext$1; private _started; private _buildStartPromise; private _closed; private _updateModuleLoadAddedImports; private _getAddedImports; getModuleInfo(id: string): ModuleInfo | null; private handleHookPromise; get options(): InputOptions; resolveRolldownOptions(): Promise; private _getPluginContext; private hookParallel; buildStart(_options?: InputOptions): Promise; resolveId(rawId: string, importer?: string | undefined, options?: { kind?: ImportKind; attributes?: Record; custom?: CustomPluginOptions; /** @deprecated use `skipCalls` instead */ skip?: Set; skipCalls?: readonly SkipInformation[]; isEntry?: boolean; }): Promise; load(id: string): Promise; transform(code: string, id: string, options?: { inMap?: SourceDescription["map"]; moduleType?: string; }): Promise<{ code: string; map: SourceMap | { mappings: ""; } | null; moduleType?: ModuleType; }>; watchChange(id: string, change: { event: "create" | "update" | "delete"; }): Promise; close(): Promise; } declare class BasicMinimalPluginContext { meta: Meta; private _logger; constructor(meta: Meta, _logger: Logger); get pluginName(): string; debug(rawLog: string | RollupLog | (() => string | RollupLog)): void; info(rawLog: string | RollupLog | (() => string | RollupLog)): void; warn(rawLog: string | RollupLog | (() => string | RollupLog)): void; error(e: string | RollupError): never; private _normalizeRawLog; } declare class MinimalPluginContext$1 extends BasicMinimalPluginContext implements MinimalPluginContext { environment: T; constructor(meta: PluginContextMeta, environment: T); } declare class PluginContainer { private environments; constructor(environments: Record); private _getEnvironment; private _getPluginContainer; getModuleInfo(id: string): ModuleInfo | null; get options(): InputOptions; buildStart(_options?: InputOptions): Promise; watchChange(id: string, change: { event: "create" | "update" | "delete"; }): Promise; resolveId(rawId: string, importer?: string, options?: { attributes?: Record; custom?: CustomPluginOptions; /** @deprecated use `skipCalls` instead */ skip?: Set; skipCalls?: readonly SkipInformation[]; ssr?: boolean; isEntry?: boolean; }): Promise; load(id: string, options?: { ssr?: boolean; }): Promise; transform(code: string, id: string, options?: { ssr?: boolean; environment?: Environment; inMap?: SourceDescription["map"]; }): Promise<{ code: string; map: SourceMap | { mappings: ""; } | null; }>; close(): Promise; } /** * server.pluginContainer compatibility * * The default environment is in buildStart, buildEnd, watchChange, and closeBundle hooks, * which are called once for all environments, or when no environment is passed in other hooks. * The ssrEnvironment is needed for backward compatibility when the ssr flag is passed without * an environment. The defaultEnvironment in the main pluginContainer in the server should be * the client environment for backward compatibility. **/ //#endregion //#region src/node/server/index.d.ts interface ServerOptions$1 extends CommonServerOptions { /** * Configure HMR-specific options (port, host, path & protocol) */ hmr?: HmrOptions | boolean; /** * Configure WebSocket connection options. * Set to `false` to disable the WebSocket server and connection. */ ws?: WsOptions | 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. */ warmup?: { /** * The files to be transformed and used on the client-side. Supports glob patterns. */ clientFiles?: string[]; /** * The files to be transformed and used in SSR. Supports glob patterns. */ ssrFiles?: string[]; }; /** * chokidar watch options or null to disable FS watching * https://github.com/paulmillr/chokidar/tree/3.6.0#api */ watch?: WatchOptions | null; /** * Create Vite dev server to be used as a middleware in an existing server * @default false */ middlewareMode?: boolean | { /** * Parent server instance to attach to * * This is needed to proxy WebSocket connections to the parent server. */ server: HttpServer; }; /** * Options for files served via '/\@fs/'. */ fs?: FileSystemServeOptions; /** * Origin for the generated asset URLs. * * @example `http://127.0.0.1:8080` */ origin?: string; /** * Pre-transform known direct imports * @default true */ preTransformRequests?: boolean; /** * Whether or not to ignore-list source files in the dev server sourcemap, used to populate * the [`x_google_ignoreList` source map extension](https://developer.chrome.com/blog/devtools-better-angular-debugging/#the-x_google_ignorelist-source-map-extension). * * 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. */ sourcemapIgnoreList?: false | ((sourcePath: string, sourcemapPath: string) => boolean); /** * Backward compatibility. The buildStart and buildEnd hooks were called only once for * the client environment. This option enables per-environment buildStart and buildEnd hooks. * @default false * @experimental */ perEnvironmentStartEndDuringDev?: boolean; /** * Backward compatibility. The watchChange hook was called only once for the client environment. * This option enables per-environment watchChange hooks. * @default false * @experimental */ perEnvironmentWatchChangeDuringDev?: boolean; /** * Run HMR tasks, by default the HMR propagation is done in parallel for all environments * @experimental */ hotUpdateEnvironments?: (server: ViteDevServer, hmr: (environment: DevEnvironment) => Promise) => Promise; forwardConsole?: boolean | ForwardConsoleOptions; } interface ResolvedServerOptions extends Omit, "fs" | "middlewareMode" | "sourcemapIgnoreList" | "forwardConsole"> { fs: Required; middlewareMode: NonNullable; sourcemapIgnoreList: Exclude; forwardConsole: ResolvedForwardConsoleOptions; } interface FileSystemServeOptions { /** * Strictly restrict file accessing outside of allowing paths. * * Set to `false` to disable the warning * * @default true */ strict?: boolean; /** * Restrict accessing files outside the allowed directories. * * Accepts absolute path or a path relative to project root. * Will try to search up for workspace root by default. */ allow?: string[]; /** * Restrict accessing files that matches the patterns. * * This will have higher priority than `allow`. * picomatch patterns are supported. * * @default ['.env', '.env.*', '*.{crt,pem,key,p12,pfx,cer,der}', '.npmrc', '.yarnrc.yml', '**\/.git/**'] */ deny?: string[]; } type ServerHook = (this: MinimalPluginContextWithoutEnvironment, server: ViteDevServer) => (() => void) | void | Promise<(() => void) | void>; type HttpServer = http.Server | Http2SecureServer; interface ViteDevServer { /** * The resolved vite config object */ config: ResolvedConfig; /** * A connect app instance. * - Can be used to attach custom middlewares to the dev server. * - Can also be used as the handler function of a custom http server * or as a middleware in any connect-style Node.js frameworks * * https://github.com/senchalabs/connect#use-middleware */ middlewares: Connect.Server; /** * native Node http server instance * will be null in middleware mode */ httpServer: HttpServer | null; /** * Chokidar watcher instance. If `config.server.watch` is set to `null`, * it will not watch any files and calling `add` or `unwatch` will have no effect. * https://github.com/paulmillr/chokidar/tree/3.6.0#api */ watcher: FSWatcher; /** * WebSocket server with `send(payload)` method */ ws: WebSocketServer; /** * An alias to `server.environments.client.hot`. * If you want to interact with all environments, loop over `server.environments`. */ hot: NormalizedHotChannel; /** * Rollup plugin container that can run plugin hooks on a given file */ pluginContainer: PluginContainer; /** * Module execution environments attached to the Vite server. */ environments: Record<"client" | "ssr" | (string & {}), DevEnvironment>; /** * Module graph that tracks the import relationships, url to file mapping * and hmr state. */ moduleGraph: ModuleGraph; /** * The resolved urls Vite prints on the CLI (URL-encoded). Returns `null` * in middleware mode or if the server is not listening on any port. */ resolvedUrls: ResolvedServerUrls | null; /** * Programmatically resolve, load and transform a URL and get the result * without going through the http request pipeline. */ transformRequest(url: string, options?: TransformOptions): Promise; /** * 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. */ warmupRequest(url: string, options?: TransformOptions): Promise; /** * Apply vite built-in HTML transforms and any plugin HTML transforms. */ transformIndexHtml(url: string, html: string, originalUrl?: string): Promise; /** * Transform module code into SSR format. */ ssrTransform(code: string, inMap: SourceMap | { mappings: ""; } | null, url: string, originalCode?: string): Promise; /** * Load a given URL as an instantiated module for SSR. */ ssrLoadModule(url: string, opts?: { fixStacktrace?: boolean; }): Promise>; /** * Returns a fixed version of the given stack */ ssrRewriteStacktrace(stack: string): string; /** * Mutates the given SSR error by rewriting the stacktrace */ ssrFixStacktrace(e: Error): void; /** * Triggers HMR for a module in the module graph. You can use the `server.moduleGraph` * API to retrieve the module to be reloaded. If `hmr` is false, this is a no-op. */ reloadModule(module: ModuleNode): Promise; /** * Start the server. */ listen(port?: number, isRestart?: boolean): Promise; /** * Stop the server. */ close(): Promise; /** * Print server urls */ printUrls(): void; /** * Bind CLI shortcuts */ bindCLIShortcuts(options?: BindCLIShortcutsOptions): void; /** * Restart the server. * * @param forceOptimize - force the optimizer to re-bundle, same as --force cli flag */ restart(forceOptimize?: boolean): Promise; /** * Open browser */ openBrowser(): void; /** * Calling `await server.waitForRequestsIdle(id)` will wait until all static imports * 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. */ waitForRequestsIdle: (ignoredId?: string) => Promise; } interface ResolvedServerUrls { local: string[]; network: string[]; } declare function createServer(inlineConfig?: InlineConfig | ResolvedConfig): Promise; //#endregion //#region src/node/plugins/html.d.ts interface HtmlTagDescriptor { tag: string; /** * attribute values will be escaped automatically if needed */ attrs?: Record; children?: string | HtmlTagDescriptor[]; /** * default: 'head-prepend' */ injectTo?: "head" | "body" | "head-prepend" | "body-prepend"; } type IndexHtmlTransformResult = string | HtmlTagDescriptor[] | { html: string; tags: HtmlTagDescriptor[]; }; interface IndexHtmlTransformContext { /** * public path when served */ path: string; /** * filename on disk */ filename: string; server?: ViteDevServer; bundle?: OutputBundle; chunk?: OutputChunk; originalUrl?: string; } type IndexHtmlTransformHook = (this: MinimalPluginContextWithoutEnvironment, html: string, ctx: IndexHtmlTransformContext) => IndexHtmlTransformResult | void | Promise; type IndexHtmlTransform = IndexHtmlTransformHook | { order?: "pre" | "post" | null; handler: IndexHtmlTransformHook; }; //#endregion //#region src/node/plugins/pluginFilter.d.ts type StringFilter = Value | Array | { include?: Value | Array; exclude?: Value | Array; }; //#endregion //#region src/node/plugin.d.ts /** * Vite plugins extends the Rollup plugin interface with a few extra * vite-specific options. A valid vite plugin is also a valid Rollup plugin. * On the contrary, a Rollup plugin may or may NOT be a valid vite universal * plugin, since some Rollup features do not make sense in an unbundled * dev server context. That said, as long as a rollup plugin doesn't have strong * coupling between its bundle phase and output phase hooks then it should * just work (that means, most of them). * * By default, the plugins are run during both serve and build. When a plugin * is applied during serve, it will only run **non output plugin hooks** (see * rollup type definition of {@link rollup#PluginHooks}). You can think of the * dev server as only running `const bundle = rollup.rollup()` but never calling * `bundle.generate()`. * * A plugin that expects to have different behavior depending on serve/build can * export a factory function that receives the command being run via options. * * If a plugin should be applied only for server or build, a function format * config file can be used to conditional determine the plugins to use. * * The current environment can be accessed from the context for the all non-global * hooks (it is not available in config, configResolved, configureServer, etc). * It can be a dev, build, or scan environment. * Plugins can use this.environment.mode === 'dev' to guard for dev specific APIs. */ interface PluginContextExtension { /** * Vite-specific environment instance */ environment: Environment; } interface PluginContextMetaExtension { viteVersion: string; } interface ConfigPluginContext extends Omit { meta: Omit; } interface MinimalPluginContextWithoutEnvironment extends Omit {} declare module "rolldown" { interface MinimalPluginContext extends PluginContextExtension {} interface PluginContextMeta extends PluginContextMetaExtension {} } /** * There are two types of plugins in Vite. App plugins and environment plugins. * Environment Plugins are defined by a constructor function that will be called * once per each environment allowing users to have completely different plugins * for each of them. The constructor gets the resolved environment after the server * and builder has already been created simplifying config access and cache * management for environment specific plugins. * Environment Plugins are closer to regular rollup plugins. They can't define * app level hooks (like config, configResolved, configureServer, etc). */ interface Plugin extends Rolldown.Plugin { /** * Perform custom handling of HMR updates. * 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. * e.g. for a Vue SFC, we can narrow down the part to update by comparing * the descriptors. * * - The hook can also return an empty array and then perform custom updates * 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: MinimalPluginContext & { environment: DevEnvironment; }, options: HotUpdateOptions) => Array | void | Promise | void>>; /** * extend hooks with ssr flag */ resolveId?: ObjectHook<(this: PluginContext, source: string, importer: string | undefined, options: { kind?: ImportKind; custom?: CustomPluginOptions; ssr?: boolean | undefined; isEntry: boolean; }) => Promise | ResolveIdResult, { filter?: { id?: StringFilter; }; }>; load?: ObjectHook<(this: PluginContext, id: string, options?: { ssr?: boolean | undefined; }) => Promise | LoadResult, { filter?: { id?: StringFilter; }; }>; transform?: ObjectHook<(this: TransformPluginContext, code: string, id: string, options?: { moduleType: ModuleType; ssr?: boolean | undefined; }) => Promise | Rolldown.TransformResult, { filter?: { id?: StringFilter; code?: StringFilter; moduleType?: ModuleTypeFilter; }; }>; /** * Opt-in this plugin into the shared plugins pipeline. * For backward-compatibility, plugins are re-recreated for each environment * during `vite build --app` * We have an opt-in per plugin, and a general `builder.sharedPlugins` * In a future major, we'll flip the default to be shared by default * @experimental */ sharedDuringBuild?: boolean; /** * Opt-in this plugin into per-environment buildStart and buildEnd during dev. * For backward-compatibility, the buildStart hook is called only once during * dev, for the client environment. Plugins can opt-in to be called * per-environment, aligning with the build hook behavior. * @experimental */ perEnvironmentStartEndDuringDev?: boolean; /** * Opt-in this plugin into per-environment watchChange during dev. * For backward-compatibility, the watchChange hook is called only once during * dev, for the client environment. Plugins can opt-in to be called * per-environment, aligning with the watchChange hook behavior. * @experimental */ perEnvironmentWatchChangeDuringDev?: boolean; /** * Enforce plugin invocation tier similar to webpack loaders. Hooks ordering * is still subject to the `order` property in the hook object. * * Plugin invocation order: * - alias resolution * - `enforce: 'pre'` plugins * - vite core plugins * - normal plugins * - vite build plugins * - `enforce: 'post'` plugins * - vite build post plugins */ enforce?: "pre" | "post"; /** * Apply the plugin only for serve or build, or on certain conditions. */ apply?: "serve" | "build" | ((this: void, config: UserConfig, env: ConfigEnv) => boolean); /** * Define environments where this plugin should be active * By default, the plugin is active in all environments * @experimental */ applyToEnvironment?: (environment: PartialEnvironment) => boolean | Promise | PluginOption; /** * Modify vite config before it's resolved. The hook can either mutate the * passed-in config directly, or return a partial config object that will be * deeply merged into existing config. * * Note: User plugins are resolved before running this hook so injecting other * plugins inside the `config` hook will have no effect. */ config?: ObjectHook<(this: ConfigPluginContext, config: UserConfig, env: ConfigEnv) => Omit | null | void | Promise | null | 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. * 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. */ configEnvironment?: ObjectHook<(this: ConfigPluginContext, name: string, config: EnvironmentOptions, env: ConfigEnv & { /** * Whether this environment is SSR environment and `ssr.target` is set to `'webworker'`. * Only intended to be used for backward compatibility. */ isSsrTargetWebworker?: boolean; }) => EnvironmentOptions | null | void | Promise>; /** * Use this hook to read and store the final resolved vite config. */ configResolved?: ObjectHook<(this: MinimalPluginContextWithoutEnvironment, config: ResolvedConfig) => void | Promise>; /** * Configure the vite server. The hook receives the {@link ViteDevServer} * instance. This can also be used to store a reference to the server * for use in other hooks. * * The hooks will be called before internal middlewares are applied. A hook * can return a post hook that will be called after internal middlewares * are applied. Hook can be async functions and will be called in series. */ configureServer?: ObjectHook; /** * Configure the preview server. The hook receives the {@link PreviewServer} * instance. This can also be used to store a reference to the server * for use in other hooks. * * The hooks are called before other middlewares are applied. A hook can * return a post hook that will be called after other middlewares are * applied. Hooks can be async functions and will be called in series. */ configurePreviewServer?: ObjectHook; /** * Transform index.html. * The hook receives the following arguments: * * - html: string * - ctx: IndexHtmlTransformContext, which contains: * - path: public path when served * - filename: filename on disk * - server?: ViteDevServer (only present during serve) * - bundle?: rollup.OutputBundle (only present during build) * - chunk?: rollup.OutputChunk * - originalUrl?: string * * It can either return a transformed string, or a list of html tag * descriptors that will be injected into the `` or ``. * * By default the transform is applied **after** vite's internal html * transform. If you need to apply the transform before vite, use an object: * `{ order: 'pre', handler: hook }` */ transformIndexHtml?: IndexHtmlTransform; /** * Build Environments * * @experimental */ buildApp?: ObjectHook; /** * 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. * * - The hook can return a filtered list of modules to narrow down the update. * e.g. for a Vue SFC, we can narrow down the part to update by comparing * the descriptors. * * - The hook can also return an empty array and then perform custom updates * by sending a custom hmr payload via server.ws.send(). * * - If the hook doesn't return a value, the hmr update will be performed as * normal. */ handleHotUpdate?: ObjectHook<(this: MinimalPluginContextWithoutEnvironment, ctx: HmrContext) => Array | void | Promise | void>>; /** * This hook is not supported by Rolldown yet. But the type is declared for compatibility. * * @deprecated This hook is **not** deprecated. It is marked as deprecated just to make it clear that this hook is currently a no-op. */ shouldTransformCachedModule?: ObjectHook<(this: PluginContext, options: { code: string; id: string; meta: CustomPluginOptions; moduleSideEffects: boolean | "no-treeshake"; }) => boolean | null | void>; } type HookHandler = T extends ObjectHook ? H : T; type PluginWithRequiredHook = Plugin & { [P in K]: NonNullable }; type Thenable = T | Promise; type FalsyPlugin = false | null | undefined; type PluginOption = Thenable; /** * @experimental */ declare function perEnvironmentPlugin(name: string, applyToEnvironment: (environment: PartialEnvironment) => boolean | Promise | PluginOption): Plugin; //#endregion //#region src/node/idResolver.d.ts type ResolveIdFn = (environment: PartialEnvironment, id: string, importer?: string, aliasOnly?: boolean) => Promise; /** * Create an internal resolver to be used in special scenarios, e.g. * optimizer and handling css @imports */ declare function createIdResolver(config: ResolvedConfig, options?: Partial): ResolveIdFn; //#endregion //#region src/node/plugins/css.d.ts interface CSSOptions { /** * Using lightningcss is an experimental option to handle CSS modules, * assets and imports via Lightning CSS. It requires to install it as a * peer dependency. * * @default 'postcss' * @experimental */ transformer?: "postcss" | "lightningcss"; /** * https://github.com/css-modules/postcss-modules */ modules?: CSSModulesOptions | false; /** * Options for preprocessors. * * In addition to options specific to each processors, Vite supports `additionalData` option. * The `additionalData` option can be used to inject extra code for each style content. */ preprocessorOptions?: { scss?: SassPreprocessorOptions; sass?: SassPreprocessorOptions; less?: LessPreprocessorOptions; styl?: StylusPreprocessorOptions; stylus?: StylusPreprocessorOptions; }; /** * If this option is set, preprocessors will run in workers when possible. * `true` means the number of CPUs minus 1. * * @default true */ preprocessorMaxWorkers?: number | true; postcss?: string | (PostCSS.ProcessOptions & { plugins?: PostCSS.AcceptedPlugin[]; }); /** * Enables css sourcemaps during dev * @default false * @experimental */ devSourcemap?: boolean; /** * @experimental */ lightningcss?: lightningcssOptions_LightningCSSOptions; } interface CSSModulesOptions { getJSON?: (cssFileName: string, json: Record, outputFileName: string) => void; scopeBehaviour?: "global" | "local"; globalModulePaths?: RegExp[]; exportGlobals?: boolean; generateScopedName?: string | ((name: string, filename: string, css: string) => string); hashPrefix?: string; /** * default: undefined */ localsConvention?: "camelCase" | "camelCaseOnly" | "dashes" | "dashesOnly" | ((originalClassName: string, generatedClassName: string, inputFile: string) => string); } type ResolvedCSSOptions = Omit & Required> & { lightningcss?: lightningcssOptions_LightningCSSOptions; }; interface PreprocessCSSResult { code: string; map?: SourceMapInput; modules?: Record; deps?: Set; } /** * @experimental */ declare function preprocessCSS(code: string, filename: string, config: ResolvedConfig): Promise; declare function formatPostcssSourceMap(rawMap: ExistingRawSourceMap, file: string): Promise; type PreprocessorAdditionalDataResult = string | { content: string; map?: ExistingRawSourceMap; }; type PreprocessorAdditionalData = string | ((source: string, filename: string) => PreprocessorAdditionalDataResult | Promise); type SassPreprocessorOptions = { additionalData?: PreprocessorAdditionalData; } & SassModernPreprocessBaseOptions; type LessPreprocessorOptions = { additionalData?: PreprocessorAdditionalData; } & LessPreprocessorBaseOptions; type StylusPreprocessorOptions = { additionalData?: PreprocessorAdditionalData; } & StylusPreprocessorBaseOptions; //#endregion //#region src/node/plugins/esbuild.d.ts interface ESBuildOptions extends esbuildOptions_EsbuildTransformOptions { include?: string | RegExp | ReadonlyArray; exclude?: string | RegExp | ReadonlyArray; jsxInject?: string; /** * This option is not respected. Use `build.minify` instead. */ minify?: never; } type ESBuildTransformResult = Omit & { map: SourceMap; }; declare function transformWithEsbuild(code: string, filename: string, options?: esbuildOptions_EsbuildTransformOptions, inMap?: object, config?: ResolvedConfig, watcher?: FSWatcher, ignoreEsbuildWarning?: boolean): Promise; //#endregion //#region src/node/plugins/json.d.ts interface JsonOptions { /** * Generate a named export for every property of the JSON object * @default true */ namedExports?: boolean; /** * Generate performant output as JSON.parse("stringified"). * * When set to 'auto', the data will be stringified only if the data is bigger than 10kB. * @default 'auto' */ stringify?: boolean | "auto"; } //#endregion //#region src/node/assetSource.d.ts /** * Defines which attributes of an HTML element should be treated as asset sources. * Used in `html.additionalAssetSources` configuration. */ interface HtmlAssetSource { /** * Attributes that contain a single asset URL. * @example ['src', 'data-src-dark'] */ srcAttributes?: string[]; /** * Attributes that contain srcset-format URLs. * @example ['srcset', 'imagesrcset'] */ srcsetAttributes?: string[]; /** * Called before handling an attribute to determine if it should be processed. */ filter?: (data: HtmlAssetSourceFilterData) => boolean; } interface HtmlAssetSourceFilterData { key: string; value: string; attributes: Record; } //#endregion //#region src/node/ssr/index.d.ts type SSRTarget = "node" | "webworker"; type SsrDepOptimizationConfig = DepOptimizationConfig; interface SSROptions { noExternal?: string | RegExp | (string | RegExp)[] | true; external?: string[] | true; /** * Define the target for the ssr build. The browser field in package.json * is ignored for node but used if webworker is the target * This option will be removed in a future major version * @default 'node' */ target?: SSRTarget; /** * Control over which dependencies are optimized during SSR and esbuild options * During build: * no external CJS dependencies are optimized by default * During dev: * explicit no external CJS dependencies are optimized by default * @experimental */ optimizeDeps?: SsrDepOptimizationConfig; resolve?: { /** * Conditions that are used in the plugin pipeline. The default value is the root config's `resolve.conditions`. * * Use this to override the default ssr conditions for the ssr build. * * @default rootConfig.resolve.conditions */ conditions?: string[]; /** * Conditions that are used during ssr import (including `ssrLoadModule`) of externalized dependencies. * * @default ['node', 'module-sync'] */ externalConditions?: string[]; mainFields?: string[]; }; } interface ResolvedSSROptions extends SSROptions { target: SSRTarget; optimizeDeps: SsrDepOptimizationConfig; } //#endregion //#region src/node/plugins/oxc.d.ts interface OxcOptions extends Omit { include?: string | RegExp | ReadonlyArray; exclude?: string | RegExp | ReadonlyArray; jsxInject?: string; jsxRefreshInclude?: string | RegExp | ReadonlyArray; jsxRefreshExclude?: string | RegExp | ReadonlyArray; } declare function transformWithOxc(code: string, filename: string, options?: rolldown_utils_TransformOptions, inMap?: object, config?: ResolvedConfig, watcher?: FSWatcher): Promise>; //#endregion //#region src/node/config.d.ts interface ConfigEnv { /** * 'serve': during dev (`vite` command) * 'build': when building for production (`vite build` command) */ command: "build" | "serve"; mode: string; isSsrBuild?: boolean; isPreview?: boolean; } /** * spa: include SPA fallback middleware and configure sirv with `single: true` in preview * * mpa: only include non-SPA HTML middlewares * * custom: don't include HTML middlewares */ type AppType = "spa" | "mpa" | "custom"; type UserConfigFnObject = (env: ConfigEnv) => UserConfig; type UserConfigFnPromise = (env: ConfigEnv) => Promise; type UserConfigFn = (env: ConfigEnv) => UserConfig | Promise; type UserConfigExport = UserConfig | Promise | UserConfigFnObject | UserConfigFnPromise | UserConfigFn; /** * Type helper to make it easier to use vite.config.ts * accepts a direct {@link UserConfig} object, or a function that returns it. * The function receives a {@link ConfigEnv} object. */ declare function defineConfig(config: UserConfig): UserConfig; declare function defineConfig(config: Promise): Promise; declare function defineConfig(config: UserConfigFnObject): UserConfigFnObject; declare function defineConfig(config: UserConfigFnPromise): UserConfigFnPromise; declare function defineConfig(config: UserConfigFn): UserConfigFn; declare function defineConfig(config: UserConfigExport): UserConfigExport; interface CreateDevEnvironmentContext { ws: WebSocketServer; } interface DevEnvironmentOptions { /** * Files to be pre-transformed. Supports glob patterns. */ warmup?: string[]; /** * Pre-transform known direct imports * defaults to true for the client environment, false for the rest */ preTransformRequests?: boolean; /** * Enables sourcemaps during dev * @default { js: true } * @experimental */ sourcemap?: boolean | { js?: boolean; css?: boolean; }; /** * Whether or not to ignore-list source files in the dev server sourcemap, used to populate * the [`x_google_ignoreList` source map extension](https://developer.chrome.com/blog/devtools-better-angular-debugging/#the-x_google_ignorelist-source-map-extension). * * 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. */ sourcemapIgnoreList?: false | ((sourcePath: string, sourcemapPath: string) => boolean); /** * create the Dev Environment instance */ createEnvironment?: (name: string, config: ResolvedConfig, context: CreateDevEnvironmentContext) => Promise | DevEnvironment; /** * For environments that support a full-reload, like the client, we can short-circuit when * restarting the server throwing early to stop processing current files. We avoided this for * SSR requests. Maybe this is no longer needed. * @experimental */ recoverable?: boolean; /** * For environments associated with a module runner. * By default, it is false for the client environment and true for non-client environments. * This option can also be used instead of the removed config.experimental.skipSsrTransform. */ moduleRunnerTransform?: boolean; } type ResolvedDevEnvironmentOptions = Omit, "sourcemapIgnoreList"> & { sourcemapIgnoreList: Exclude; }; type AllResolveOptions = ResolveOptions & { alias?: AliasOptions; }; interface SharedEnvironmentOptions { /** * Define global variable replacements. * Entries will be defined on `window` during dev and replaced during build. */ define?: Record; /** * 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"; /** * If true, `process.env` referenced in code will be preserved as-is and evaluated in runtime. * Otherwise, it is statically replaced as an empty object. */ keepProcessEnv?: boolean; /** * Optimize deps config */ optimizeDeps?: DepOptimizationOptions; /** * Whether this environment produces a bundled output. * * During `build`, this defaults to `true` for every environment. * During `serve`, this defaults to `true` only for the client environment * when `experimental.bundledDev` is enabled, and `false` otherwise. * Setting this explicitly on an environment always overrides the default. * * @experimental */ isBundled?: boolean; } interface EnvironmentOptions extends SharedEnvironmentOptions { /** * Dev specific options */ dev?: DevEnvironmentOptions; /** * Build specific options */ build?: BuildEnvironmentOptions; } type ResolvedResolveOptions = Required; type ResolvedEnvironmentOptions = { define?: Record; resolve: ResolvedResolveOptions; consumer: "client" | "server"; keepProcessEnv?: boolean; optimizeDeps: DepOptimizationOptions; dev: ResolvedDevEnvironmentOptions; build: ResolvedBuildEnvironmentOptions; isBundled: boolean; plugins: readonly Plugin[]; }; type DefaultEnvironmentOptions = Omit & { resolve?: AllResolveOptions; }; interface UserConfig extends DefaultEnvironmentOptions { /** * Project root directory. Can be an absolute path, or a path relative from * the location of the config file itself. * @default process.cwd() */ root?: string; /** * Base public path when served in development or production. * @default '/' */ base?: string; /** * Directory to serve as plain static assets. Files in this directory are * served and copied to build dist dir as-is without transform. The value * can be either an absolute file system path or a path relative to project root. * * Set to `false` or an empty string to disable copied static assets to build dist dir. * @default 'public' */ publicDir?: string | false; /** * Directory to save cache files. Files in this directory are pre-bundled * deps or some other cache files that generated by vite, which can improve * the performance. You can use `--force` flag or manually delete the directory * to regenerate the cache files. The value can be either an absolute file * system path or a path relative to project root. * Default to `.vite` when no `package.json` is detected. * @default 'node_modules/.vite' */ cacheDir?: string; /** * Explicitly set a mode to run in. This will override the default mode for * each command, and can be overridden by the command line --mode option. */ mode?: string; /** * Array of vite plugins to use. */ plugins?: PluginOption[]; /** * HTML related options */ html?: HTMLOptions; /** * CSS related options (preprocessors and CSS modules) */ css?: CSSOptions; /** * JSON loading options */ json?: JsonOptions; /** * Transform options to pass to esbuild. * Or set to `false` to disable esbuild. * * @deprecated Use `oxc` option instead. */ esbuild?: ESBuildOptions | false; /** * Transform options to pass to Oxc. * Or set to `false` to disable Oxc. */ oxc?: OxcOptions | false; /** * Specify additional picomatch patterns to be treated as static assets. */ assetsInclude?: string | RegExp | (string | RegExp)[]; /** * Builder specific options * @experimental */ builder?: BuilderOptions; /** * Server specific options, e.g. host, port, https... */ server?: ServerOptions$1; /** * Preview specific options, e.g. host, port, https... */ preview?: PreviewOptions; /** * Experimental features * * Features under this field could change in the future and might NOT follow semver. * Please be careful and always pin Vite's version when using them. * @experimental */ experimental?: ExperimentalOptions; /** * Options to opt-in to future behavior */ future?: FutureOptions | "warn"; /** * Legacy options * * Features under this field only follow semver for patches, they could be removed in a * future minor version. Please always pin Vite's version to a minor when using them. */ legacy?: LegacyOptions; /** * Log level. * @default 'info' */ logLevel?: LogLevel; /** * Custom logger. */ customLogger?: Logger; /** * @default true */ clearScreen?: boolean; /** * Environment files directory. Can be an absolute path, or a path relative from * root. * @default root */ envDir?: string | false; /** * Env variables starts with `envPrefix` will be exposed to your client source code via import.meta.env. * @default 'VITE_' */ envPrefix?: string | string[]; /** * Worker bundle options */ worker?: { /** * Output format for worker bundle * @default 'iife' */ format?: "es" | "iife"; /** * Vite plugins that apply to worker bundle. The plugins returned by this function * should be new instances every time it is called, because they are used for each * rolldown worker bundling process. */ plugins?: () => PluginOption[]; /** * Alias to `rolldownOptions`. * @deprecated Use `rolldownOptions` instead. */ rollupOptions?: Omit; /** * Rolldown options to build worker bundle */ rolldownOptions?: Omit; }; /** * Dep optimization options */ optimizeDeps?: DepOptimizationOptions; /** * SSR specific options * We could make SSROptions be a EnvironmentOptions if we can abstract * external/noExternal for environments in general. */ ssr?: SSROptions; /** * Environment overrides */ environments?: Record; /** * Whether your application is a Single Page Application (SPA), * a Multi-Page Application (MPA), or Custom Application (SSR * and frameworks with custom HTML handling) * @default 'spa' */ appType?: AppType; /** * Enable devtools integration. Ensure that `@vitejs/devtools` is installed as a dependency. * This feature is currently supported only in build mode. * @experimental * @default false */ devtools?: boolean | DevToolsConfig; } interface HTMLOptions { /** * A nonce value placeholder that will be used when generating script/style tags. * * Make sure that this placeholder will be replaced with a unique value for each request by the server. */ cspNonce?: string; /** * Define additional HTML elements and attributes to be treated as asset sources. * This extends the built-in list that includes standard elements like ``, `