芝麻web文件管理V1.00
编辑当前文件:/home/rejoandoctor/medicine.joruridoctor.com/node_modules/vite/dist/node/index.d.ts
///
import { PluginHooks, RollupError, SourceMap, ModuleInfo, PartialResolvedId, RollupOptions, InputOption, ModuleFormat, WatcherOptions, RollupOutput, RollupWatcher, InputOptions, CustomPluginOptions, LoadResult, SourceDescription, PluginContextMeta, RollupLog, OutputBundle, OutputChunk, ObjectHook, ResolveIdResult, ExistingRawSourceMap, SourceMapInput, GetManualChunk } from 'rollup'; import * as rollup from 'rollup'; export { rollup as Rollup }; export { parseAst, parseAstAsync } from 'rollup/parseAst'; import * as http from 'node:http'; import { OutgoingHttpHeaders, ClientRequestArgs, IncomingMessage, ClientRequest, Agent, Server, ServerResponse } from 'node:http'; import { Http2SecureServer } from 'node:http2'; import * as fs from 'node:fs'; import * as events from 'node:events'; import { EventEmitter } from 'node:events'; import { ServerOptions as HttpsServerOptions, Server as HttpsServer } from 'node:https'; import * as net from 'node:net'; import * as url from 'node:url'; import { URL } from 'node:url'; import * as stream from 'node:stream'; import { Duplex, DuplexOptions } from 'node:stream'; import { FetchFunctionOptions, FetchResult, ModuleRunnerOptions, ModuleRunnerHmr, ModuleEvaluator, ModuleRunner } from 'vite/module-runner'; export { FetchFunction, FetchResult } from 'vite/module-runner'; import { BuildOptions as esbuild_BuildOptions, TransformOptions as esbuild_TransformOptions, TransformResult as esbuild_TransformResult } from 'esbuild'; export { TransformOptions as EsbuildTransformOptions, version as esbuildVersion } from 'esbuild'; import { HotPayload, CustomPayload } from '../../types/hmrPayload.js'; export { ConnectedPayload, CustomPayload, ErrorPayload, FullReloadPayload, HMRPayload, HotPayload, PrunePayload, Update, UpdatePayload } from '../../types/hmrPayload.js'; import { InferCustomEventPayload } from '../../types/customEvent.js'; export { CustomEventMap, InferCustomEventPayload, InvalidatePayload } from '../../types/customEvent.js'; import { SecureContextOptions } from 'node:tls'; import { ZlibOptions } from 'node:zlib'; import * as PostCSS from 'postcss'; import { LightningCSSOptions } from '../../types/internal/lightningcssOptions.js'; export { LightningCSSOptions } from '../../types/internal/lightningcssOptions.js'; import { SassLegacyPreprocessBaseOptions, SassModernPreprocessBaseOptions, LessPreprocessorBaseOptions, StylusPreprocessorBaseOptions } from '../../types/internal/cssPreprocessorOptions.js'; import { M as ModuleRunnerTransport } from './moduleRunnerTransport.d-CXw_Ws6P.js'; export { GeneralImportGlobOptions, ImportGlobFunction, ImportGlobOptions, KnownAsTypeMap } from '../../types/importGlob.js'; export { ChunkMetadata } from '../../types/metadata.js'; interface Alias { find: string | RegExp replacement: string /** * Instructs the plugin to use an alternative resolving algorithm, * rather than the Rollup's resolver. * @default null */ customResolver?: ResolverFunction | ResolverObject | null } type MapToFunction
= T extends Function ? T : never type ResolverFunction = MapToFunction
interface ResolverObject { buildStart?: PluginHooks['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 } type AnymatchFn = (testString: string) => boolean type AnymatchPattern = string | RegExp | AnymatchFn type AnymatchMatcher = AnymatchPattern | AnymatchPattern[] // Inlined to avoid extra dependency (chokidar is bundled in the published build) 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 } // Inlined to avoid extra dependency // MIT Licensed https://github.com/DefinitelyTyped/DefinitelyTyped/blob/master/LICENSE 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 } } // Inlined to avoid extra dependency // MIT Licensed https://github.com/DefinitelyTyped/DefinitelyTyped/blob/master/LICENSE declare namespace HttpProxy { export type ProxyTarget = ProxyTargetUrl | ProxyTargetDetailed export type ProxyTargetUrl = string | Partial
export interface ProxyTargetDetailed { host: string port: number protocol?: string | undefined hostname?: string | undefined socketPath?: string | undefined key?: string | undefined passphrase?: string | undefined pfx?: Buffer | string | undefined cert?: string | undefined ca?: string | undefined ciphers?: string | undefined secureProtocol?: string | undefined } export type ErrorCallback = ( err: Error, req: http.IncomingMessage, res: http.ServerResponse, target?: ProxyTargetUrl, ) => void export class Server extends events.EventEmitter { /** * Creates the proxy server with specified options. * @param options - Config object passed to the proxy */ constructor(options?: ServerOptions) /** * Used for proxying regular HTTP(S) requests * @param req - Client request. * @param res - Client response. * @param options - Additional options. * @param callback - Error callback. */ web( req: http.IncomingMessage, res: http.ServerResponse, options?: ServerOptions, callback?: ErrorCallback, ): void /** * Used for proxying regular HTTP(S) requests * @param req - Client request. * @param socket - Client socket. * @param head - Client head. * @param options - Additional options. * @param callback - Error callback. */ ws( req: http.IncomingMessage, socket: unknown, head: unknown, options?: ServerOptions, callback?: ErrorCallback, ): void /** * A function that wraps the object in a webserver, for your convenience * @param port - Port to listen on */ listen(port: number): Server /** * A function that closes the inner webserver and stops listening on given port */ close(callback?: () => void): void /** * 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): Server /** * 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): Server /** * 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): Server addListener(event: string, listener: () => void): this on(event: string, listener: () => void): this on(event: 'error', listener: ErrorCallback): this on( event: 'start', listener: ( req: http.IncomingMessage, res: http.ServerResponse, target: ProxyTargetUrl, ) => void, ): this on( event: 'proxyReq', listener: ( proxyReq: http.ClientRequest, req: http.IncomingMessage, res: http.ServerResponse, options: ServerOptions, ) => void, ): this on( event: 'proxyRes', listener: ( proxyRes: http.IncomingMessage, req: http.IncomingMessage, res: http.ServerResponse, ) => void, ): this on( event: 'proxyReqWs', listener: ( proxyReq: http.ClientRequest, req: http.IncomingMessage, socket: net.Socket, options: ServerOptions, head: any, ) => void, ): this on( event: 'econnreset', listener: ( err: Error, req: http.IncomingMessage, res: http.ServerResponse, target: ProxyTargetUrl, ) => void, ): this on( event: 'end', listener: ( req: http.IncomingMessage, res: http.ServerResponse, proxyRes: http.IncomingMessage, ) => void, ): this on( event: 'close', listener: ( proxyRes: http.IncomingMessage, proxySocket: net.Socket, proxyHead: any, ) => void, ): this once(event: string, listener: () => void): this removeListener(event: string, listener: () => void): this removeAllListeners(event?: string): this getMaxListeners(): number setMaxListeners(n: number): this listeners(event: string): Array<() => void> emit(event: string, ...args: any[]): boolean listenerCount(type: string): number } export interface ServerOptions { /** URL string to be parsed with the url module. */ target?: ProxyTarget | undefined /** URL string to be parsed with the url module. */ forward?: ProxyTargetUrl | undefined /** 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 | undefined /** Adds x- forward headers. */ xfwd?: boolean | undefined /** Verify SSL certificate. */ secure?: boolean | undefined /** Explicitly specify if we are proxying to another proxy. */ toProxy?: boolean | undefined /** Specify whether you want to prepend the target's path to the proxy path. */ prependPath?: boolean | undefined /** Specify whether you want to ignore the proxy path of the incoming request. */ ignorePath?: boolean | undefined /** Local interface string to bind for outgoing connections. */ localAddress?: string | undefined /** Changes the origin of the host header to the target URL. */ changeOrigin?: boolean | undefined /** specify whether you want to keep letter case of response header key */ preserveHeaderKeyCase?: boolean | undefined /** Basic authentication i.e. 'user:password' to compute an Authorization header. */ auth?: string | undefined /** Rewrites the location hostname on (301 / 302 / 307 / 308) redirects, Default: null. */ hostRewrite?: string | undefined /** Rewrites the location host/ port on (301 / 302 / 307 / 308) redirects based on requested host/ port.Default: false. */ autoRewrite?: boolean | undefined /** Rewrites the location protocol on (301 / 302 / 307 / 308) redirects to 'http' or 'https'.Default: null. */ protocolRewrite?: string | undefined /** rewrites domain of set-cookie headers. */ cookieDomainRewrite?: | false | string | { [oldDomain: string]: string } | undefined /** rewrites path of set-cookie headers. Default: false */ cookiePathRewrite?: | false | string | { [oldPath: string]: string } | undefined /** object with extra headers to be added to target requests. */ headers?: { [header: string]: string } | undefined /** Timeout (in milliseconds) when proxy receives no response from target. Default: 120000 (2 minutes) */ proxyTimeout?: number | undefined /** Timeout (in milliseconds) for incoming requests */ timeout?: number | undefined /** Specify whether you want to follow redirects. Default: false */ followRedirects?: boolean | undefined /** 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 | undefined /** Buffer */ buffer?: stream.Stream | undefined } } interface ProxyOptions extends HttpProxy.ServerOptions { /** * rewrite path */ rewrite?: (path: string) => string; /** * configure the proxy server (e.g. listen to events) */ configure?: (proxy: HttpProxy.Server, options: ProxyOptions) => void; /** * webpack-dev-server style bypass function */ bypass?: (req: http.IncomingMessage, /** undefined for WebSocket upgrade requests */ 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; } 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; 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`](https://github.com/http-party/node-http-proxy). * Full options [here](https://github.com/http-party/node-http-proxy#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)[]; type RequiredExceptFor
= Pick
& Required
>; 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: void, 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
; 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
; }; declare class PartialEnvironment { name: string; getTopLevelConfig(): ResolvedConfig; config: ResolvedConfig & ResolvedEnvironmentOptions; /** * @deprecated use environment.config instead **/ get options(): ResolvedEnvironmentOptions; logger: Logger; constructor(name: string, topLevelConfig: ResolvedConfig, options?: ResolvedEnvironmentOptions); } declare class BaseEnvironment extends PartialEnvironment { get plugins(): 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"` specfically. It's * a placeholder for more possible environment types. */ declare class UnknownEnvironment extends BaseEnvironment { mode: "unknown"; } declare class ScanEnvironment extends BaseEnvironment { mode: "scan"; get pluginContainer(): EnvironmentPluginContainer; init(): Promise
; } 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 */ esbuildOptions?: 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 * @experimental */ 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; } type DepOptimizationOptions = DepOptimizationConfig & { /** * By default, Vite will crawl your `index.html` to detect dependencies that * need to be pre-bundled. If `build.rollupOptions.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
; } 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
; interface TransformResult { code: string; map: SourceMap | { mappings: ''; } | null; ssr?: boolean; etag?: string; deps?: string[]; dynamicDeps?: string[]; } interface TransformOptions { /** * @deprecated inferred from environment */ ssr?: boolean; } 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'; 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, ): 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, ): 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; } 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'; 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, ): 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'; interface HmrOptions { protocol?: string; host?: string; port?: number; clientPort?: number; path?: string; timeout?: number; overlay?: boolean; server?: HttpServer; } interface HotUpdateOptions { type: 'create' | 'update' | 'delete'; file: string; timestamp: number; modules: Array
; read: () => string | Promise
; server: ViteDevServer; /** * @deprecated use this.environment in the hotUpdate hook instead **/ environment: DevEnvironment; } interface HmrContext { file: string; timestamp: number; modules: Array
; read: () => string | Promise
; server: ViteDevServer; } interface HotChannelClient { send(payload: HotPayload): void; } /** @deprecated use `HotChannelClient` instead */ type HMRBroadcasterClient = HotChannelClient; type HotChannelListener
= (data: InferCustomEventPayload
, client: HotChannelClient) => void; interface HotChannel
{ /** * Broadcast events to all clients */ send?(payload: 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; } /** @deprecated use `HotChannel` instead */ type HMRChannel = HotChannel; interface NormalizedHotChannelClient { /** * Send event to the client */ send(payload: HotPayload): void; /** * Send custom event */ send(event: string, payload?: CustomPayload['data']): void; } interface NormalizedHotChannel
{ /** * Broadcast events to all clients */ send(payload: 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; on(event: 'connection', listener: () => void): void; /** * Unregister event listener */ off(event: string, listener: Function): void; handleInvoke(payload: 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
; /** @deprecated use `ServerHotChannel` instead */ type ServerHMRChannel = ServerHotChannel; declare function createServerHotChannel(): ServerHotChannel; /** @deprecated use `environment.hot` instead */ interface HotBroadcaster extends NormalizedHotChannel { readonly channels: NormalizedHotChannel[]; /** * A noop. * @deprecated */ addChannel(channel: HotChannel): HotBroadcaster; close(): Promise
; } /** @deprecated use `environment.hot` instead */ type HMRBroadcaster = HotBroadcaster; // Modified and inlined to avoid extra dependency // Source: https://github.com/DefinitelyTyped/DefinitelyTyped/blob/master/types/ws/index.d.ts declare const WebSocketAlias: typeof WebSocket interface WebSocketAlias extends WebSocket {} // 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, options?: WebSocket.ClientOptions | ClientRequestArgs, ) constructor( address: string | 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: 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: 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: 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: 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: 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: 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: 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: 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: 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: IncomingMessage) => void, ): this removeListener( event: string | symbol, listener: (...args: any[]) => void, ): this } 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: 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: 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?: Server | HttpsServer | undefined verifyClient?: | VerifyClientCallbackAsync | VerifyClientCallbackSync | undefined handleProtocols?: ( protocols: Set
, request: 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: IncomingMessage, socket: Duplex, upgradeHead: Buffer, callback: (client: T, request: IncomingMessage) => void, ): void shouldHandle(request: IncomingMessage): boolean | Promise
// Events on( event: 'connection', cb: (this: Server
, socket: T, request: IncomingMessage) => void, ): this on(event: 'error', cb: (this: Server
, error: Error) => void): this on( event: 'headers', cb: ( this: Server
, headers: string[], request: 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: IncomingMessage) => void, ): this once(event: 'error', cb: (this: Server
, error: Error) => void): this once( event: 'headers', cb: ( this: Server
, headers: string[], request: 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: IncomingMessage) => void, ): this off(event: 'error', cb: (this: Server
, error: Error) => void): this off( event: 'headers', cb: ( this: Server
, headers: string[], request: 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: IncomingMessage) => void, ): this addListener(event: 'error', cb: (err: Error) => void): this addListener( event: 'headers', cb: (headers: string[], request: 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: 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 } type WebSocketCustomListener
= (data: T, client: WebSocketClient, invoke?: 'send' | `send:${string}`) => 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; } 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; 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
; fetchModule(id: string, importer?: string, options?: FetchFunctionOptions): Promise
; reloadModule(module: EnvironmentModuleNode): Promise
; transformRequest(url: string): Promise
; warmupRequest(url: string): Promise
; 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
; } 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 } 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)[] /** * By default, the plugin quits the build process when it encounters an error. If you set this option to true, it will throw a warning instead and leave the code untouched. * @default false */ warnOnError?: boolean } // Modified and inlined to avoid extra dependency // Source: https://github.com/terser/terser/blob/master/tools/terser.d.ts // BSD Licensed https://github.com/terser/terser/blob/master/LICENSE declare namespace Terser { export type ECMA = 5 | 2015 | 2016 | 2017 | 2018 | 2019 | 2020 export type ConsoleProperty = keyof typeof console type DropConsoleOption = boolean | ConsoleProperty[] export interface ParseOptions { bare_returns?: boolean /** @deprecated legacy option. Currently, all supported EcmaScript is valid to parse. */ ecma?: ECMA html5_comments?: boolean shebang?: boolean } export interface CompressOptions { arguments?: boolean arrows?: boolean booleans_as_integers?: boolean booleans?: boolean collapse_vars?: boolean comparisons?: boolean computed_props?: boolean conditionals?: boolean dead_code?: boolean defaults?: boolean directives?: boolean drop_console?: DropConsoleOption drop_debugger?: boolean ecma?: ECMA evaluate?: boolean expression?: boolean global_defs?: object hoist_funs?: boolean hoist_props?: boolean hoist_vars?: boolean ie8?: boolean if_return?: boolean inline?: boolean | InlineFunctions join_vars?: boolean keep_classnames?: boolean | RegExp keep_fargs?: boolean keep_fnames?: boolean | RegExp keep_infinity?: boolean loops?: boolean module?: boolean negate_iife?: boolean passes?: number properties?: boolean pure_funcs?: string[] pure_new?: boolean pure_getters?: boolean | 'strict' reduce_funcs?: boolean reduce_vars?: boolean sequences?: boolean | number side_effects?: boolean switches?: boolean toplevel?: boolean top_retain?: null | string | string[] | RegExp typeofs?: boolean unsafe_arrows?: boolean unsafe?: boolean unsafe_comps?: boolean unsafe_Function?: boolean unsafe_math?: boolean unsafe_symbols?: boolean unsafe_methods?: boolean unsafe_proto?: boolean unsafe_regexp?: boolean unsafe_undefined?: boolean unused?: boolean } export enum InlineFunctions { Disabled = 0, SimpleFunctions = 1, WithArguments = 2, WithArgumentsAndVariables = 3, } export interface MangleOptions { eval?: boolean keep_classnames?: boolean | RegExp keep_fnames?: boolean | RegExp module?: boolean nth_identifier?: SimpleIdentifierMangler | WeightedIdentifierMangler properties?: boolean | ManglePropertiesOptions reserved?: string[] safari10?: boolean toplevel?: boolean } /** * An identifier mangler for which the output is invariant with respect to the source code. */ export interface SimpleIdentifierMangler { /** * Obtains the nth most favored (usually shortest) identifier to rename a variable to. * The mangler will increment n and retry until the return value is not in use in scope, and is not a reserved word. * This function is expected to be stable; Evaluating get(n) === get(n) should always return true. * @param n The ordinal of the identifier. */ get(n: number): string } /** * An identifier mangler that leverages character frequency analysis to determine identifier precedence. */ export interface WeightedIdentifierMangler extends SimpleIdentifierMangler { /** * Modifies the internal weighting of the input characters by the specified delta. * Will be invoked on the entire printed AST, and then deduct mangleable identifiers. * @param chars The characters to modify the weighting of. * @param delta The numeric weight to add to the characters. */ consider(chars: string, delta: number): number /** * Resets character weights. */ reset(): void /** * Sorts identifiers by character frequency, in preparation for calls to get(n). */ sort(): void } export interface ManglePropertiesOptions { builtins?: boolean debug?: boolean keep_quoted?: boolean | 'strict' nth_identifier?: SimpleIdentifierMangler | WeightedIdentifierMangler regex?: RegExp | string reserved?: string[] } export interface FormatOptions { ascii_only?: boolean /** @deprecated Not implemented anymore */ beautify?: boolean braces?: boolean comments?: | boolean | 'all' | 'some' | RegExp | (( node: any, comment: { value: string type: 'comment1' | 'comment2' | 'comment3' | 'comment4' pos: number line: number col: number }, ) => boolean) ecma?: ECMA ie8?: boolean keep_numbers?: boolean indent_level?: number indent_start?: number inline_script?: boolean keep_quoted_props?: boolean max_line_len?: number | false preamble?: string preserve_annotations?: boolean quote_keys?: boolean quote_style?: OutputQuoteStyle safari10?: boolean semicolons?: boolean shebang?: boolean shorthand?: boolean source_map?: SourceMapOptions webkit?: boolean width?: number wrap_iife?: boolean wrap_func_args?: boolean } export enum OutputQuoteStyle { PreferDouble = 0, AlwaysSingle = 1, AlwaysDouble = 2, AlwaysOriginal = 3, } export interface MinifyOptions { compress?: boolean | CompressOptions ecma?: ECMA enclose?: boolean | string ie8?: boolean keep_classnames?: boolean | RegExp keep_fnames?: boolean | RegExp mangle?: boolean | MangleOptions module?: boolean nameCache?: object format?: FormatOptions /** @deprecated */ output?: FormatOptions parse?: ParseOptions safari10?: boolean sourceMap?: boolean | SourceMapOptions toplevel?: boolean } export interface MinifyOutput { code?: string map?: object | string decoded_map?: object | null } export interface SourceMapOptions { /** Source map object, 'inline' or source map file content */ content?: object | string includeSources?: boolean filename?: string root?: string asObject?: boolean url?: string | 'inline' } } interface TerserOptions extends Terser.MinifyOptions { /** * 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; } 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; } 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; /** @deprecated */ isFromTsImporter?: boolean; scan?: boolean; /** * @deprecated environment.config are used instead */ ssrConfig?: SSROptions; } interface InternalResolveOptions extends Required
, ResolvePluginOptions { } /** 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
; }; } 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: 'modules' - transpile targeting browsers that natively support * dynamic es module imports and `import.meta` * (Chrome 87+, Firefox 78+, Safari 14+, Edge 88+). * * 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 'modules' */ target?: 'modules' | esbuild_TransformOptions['target'] | 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?: esbuild_TransformOptions['target'] | false; /** * Override CSS minification specifically instead of defaulting to `build.minify`, * so you can configure minification for JS and CSS separately. * @default 'esbuild' */ cssMinify?: boolean | 'esbuild' | 'lightningcss'; /** * 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 'terser' or 'esbuild'. * @default 'esbuild' */ minify?: boolean | '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; /** * Will be merged with internal rollup options. * https://rollupjs.org/configuration-options/ */ rollupOptions?: RollupOptions; /** * Options to pass on to `@rollup/plugin-commonjs` */ 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/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 * `rollupOptions.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' | 'system'; 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"; constructor(name: string, config: ResolvedConfig, setup?: { options?: EnvironmentOptions; }); init(): Promise
; } interface ViteBuilder { environments: Record
; config: ResolvedConfig; buildApp(): Promise
; build(environment: BuildEnvironment): 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 Environment = DevEnvironment | BuildEnvironment | 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; type SkipInformation = { id: string; importer: string | undefined; plugin: Plugin; called?: boolean; }; declare class EnvironmentPluginContainer { environment: Environment; plugins: Plugin[]; watcher?: FSWatcher | undefined; private _pluginContextMap; private _resolvedRollupOptions?; private _processesing; private _seenResolves; private _moduleNodeToLoadAddedImports; getSortedPluginHooks: PluginHookUtils['getSortedPluginHooks']; getSortedPlugins: PluginHookUtils['getSortedPlugins']; moduleGraph: EnvironmentModuleGraph | undefined; watchFiles: Set
; minimalContext: MinimalPluginContext; private _started; private _buildStartPromise; private _closed; private _updateModuleLoadAddedImports; private _getAddedImports; getModuleInfo(id: string): ModuleInfo | null; private handleHookPromise; get options(): InputOptions; resolveRollupOptions(): Promise
; private _getPluginContext; private hookParallel; buildStart(_options?: InputOptions): Promise
; resolveId(rawId: string, importer?: string | undefined, options?: { 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']; }): Promise<{ code: string; map: SourceMap | { mappings: ''; } | null; }>; watchChange(id: string, change: { event: 'create' | 'update' | 'delete'; }): Promise
; close(): Promise
; } declare class MinimalPluginContext implements rollup.MinimalPluginContext { meta: PluginContextMeta; environment: Environment; constructor(meta: PluginContextMeta, environment: Environment); 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 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
; } interface ServerOptions extends CommonServerOptions { /** * Configure HMR-specific options (port, host, path & protocol) */ hmr?: HmrOptions | boolean; /** * Do not start the websocket connection. * @experimental */ ws?: false; /** * Warm-up files to transform and cache the results in advance. This improves the * initial page load during server starts and prevents transform waterfalls. */ 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 all * environments. This option enables per-environment buildStart and buildEnd hooks. * @default false * @experimental */ perEnvironmentStartEndDuringDev?: 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
; } interface ResolvedServerOptions extends Omit
, 'fs' | 'middlewareMode' | 'sourcemapIgnoreList'> { fs: Required
; middlewareMode: NonNullable
; sourcemapIgnoreList: Exclude
; } 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}', '**\/.git/**'] */ deny?: string[]; } type ServerHook = (this: void, 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; /** * web socket server with `send(payload)` method */ ws: WebSocketServer; /** * HMR broadcaster that can be used to send custom HMR messages to the client * * Always sends a message to at least a WebSocket client. Any third party can * add a channel to the broadcaster to process messages */ hot: HotBroadcaster; /** * Rollup plugin container that can run plugin hooks on a given file */ 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): Promise
; interface HtmlTagDescriptor { tag: string; 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: void, html: string, ctx: IndexHtmlTransformContext) => IndexHtmlTransformResult | void | Promise
; type IndexHtmlTransform = IndexHtmlTransformHook | { order?: 'pre' | 'post' | null; /** * @deprecated renamed to `order` */ enforce?: 'pre' | 'post'; /** * @deprecated renamed to `handler` */ transform: IndexHtmlTransformHook; } | { order?: 'pre' | 'post' | null; /** * @deprecated renamed to `order` */ enforce?: 'pre' | 'post'; handler: IndexHtmlTransformHook; }; /** * 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 HotUpdatePluginContext { environment: DevEnvironment; } interface PluginContext extends rollup.PluginContext, PluginContextExtension { } interface ResolveIdPluginContext extends rollup.PluginContext, PluginContextExtension { } interface TransformPluginContext extends rollup.TransformPluginContext, PluginContextExtension { } declare module 'rollup' { interface MinimalPluginContext extends PluginContextExtension { } } /** * 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 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 rollup.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: HotUpdatePluginContext, options: HotUpdateOptions) => Array
| void | Promise
| void>>; /** * extend hooks with ssr flag */ resolveId?: ObjectHook<(this: ResolveIdPluginContext, source: string, importer: string | undefined, options: { attributes: Record
; custom?: CustomPluginOptions; ssr?: boolean; isEntry: boolean; }) => Promise
| ResolveIdResult>; load?: ObjectHook<(this: PluginContext, id: string, options?: { ssr?: boolean; }) => Promise
| LoadResult>; transform?: ObjectHook<(this: TransformPluginContext, code: string, id: string, options?: { ssr?: boolean; }) => Promise
| rollup.TransformResult>; /** * 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; /** * 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: void, 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: void, 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: void, 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?: vite.ServerContext (only present during serve) * - bundle?: rollup.OutputBundle (only present during build) * * 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; /** * 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: void, ctx: HmrContext) => Array
| void | Promise
| 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; 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. This is incompatible with the use of preprocessors. * * @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 0 * @experimental */ preprocessorMaxWorkers?: number | true; postcss?: string | (PostCSS.ProcessOptions & { plugins?: PostCSS.AcceptedPlugin[]; }); /** * Enables css sourcemaps during dev * @default false * @experimental */ devSourcemap?: boolean; /** * @experimental */ lightningcss?: 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; }; 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; } & (({ api: 'legacy'; } & SassLegacyPreprocessBaseOptions) | ({ api?: 'modern' | 'modern-compiler'; } & SassModernPreprocessBaseOptions)); type LessPreprocessorOptions = { additionalData?: PreprocessorAdditionalData; } & LessPreprocessorBaseOptions; type StylusPreprocessorOptions = { additionalData?: PreprocessorAdditionalData; } & StylusPreprocessorBaseOptions; interface ESBuildOptions extends esbuild_TransformOptions { 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?: esbuild_TransformOptions, inMap?: object, config?: ResolvedConfig, watcher?: FSWatcher): Promise
; 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'; } 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 [] */ externalConditions?: string[]; mainFields?: string[]; }; } interface ResolvedSSROptions extends SSROptions { target: SSRTarget; optimizeDeps: SsrDepOptimizationConfig; } 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 true for the client environment and false 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; } 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; }; 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. */ esbuild?: ESBuildOptions | 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; /** * 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; /** * 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; /** * 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 * rollup worker bundling process. */ plugins?: () => PluginOption[]; /** * Rollup options to build worker bundle */ rollupOptions?: 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; } 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; } interface FutureOptions { removePluginHookHandleHotUpdate?: 'warn'; removePluginHookSsrArgument?: 'warn'; removeServerModuleGraph?: 'warn'; removeServerHot?: 'warn'; removeServerTransformRequest?: 'warn'; removeSsrLoadModule?: 'warn'; } interface ExperimentalOptions { /** * Append fake `&lang.(ext)` when queries are specified, to preserve the file extension for following plugins to process. * * @experimental * @default false */ importGlobRestoreExtension?: boolean; /** * Allow finegrain control over assets and public files paths * * @experimental */ renderBuiltUrl?: RenderBuiltAssetUrl; /** * Enables support of HMR partial accept via `import.meta.hot.acceptExports`. * * @experimental * @default false */ hmrPartialAccept?: boolean; /** * Skips SSR transform to make it easier to use Vite with Node ESM loaders. * @warning Enabling this will break normal operation of Vite's SSR in development mode. * * @experimental * @default false */ skipSsrTransform?: boolean; } interface LegacyOptions { /** * In Vite 4, SSR-externalized modules (modules not bundled and loaded by Node.js at runtime) * are implicitly proxied in dev to automatically handle `default` and `__esModule` access. * However, this does not correctly reflect how it works in the Node.js runtime, causing * inconsistencies between dev and prod. * * In Vite 5, the proxy is removed so dev and prod are consistent, but if you still require * the old behaviour, you can enable this option. If so, please leave your feedback at * https://github.com/vitejs/vite/discussions/14697. */ proxySsrExternalModules?: boolean; /** * In Vite 6.0.8 and below, WebSocket server was able to connect from any web pages. However, * that could be exploited by a malicious web page. * * In Vite 6.0.9+, the WebSocket server now requires a token to connect from a web page. * But this may break some plugins and frameworks that connects to the WebSocket server * on their own. Enabling this option will make Vite skip the token check. * * **We do not recommend enabling this option unless you are sure that you are fine with * that security weakness.** */ skipWebSocketTokenCheck?: boolean; } interface ResolvedWorkerOptions { format: 'es' | 'iife'; plugins: (bundleChain: string[]) => Promise
; rollupOptions: RollupOptions; } interface InlineConfig extends UserConfig { configFile?: string | false; /** @experimental */ configLoader?: 'bundle' | 'runner' | 'native'; envFile?: false; forceOptimizeDeps?: boolean; } interface ResolvedConfig extends Readonly
& { configFile: string | undefined; configFileDependencies: string[]; inlineConfig: InlineConfig; root: string; base: string; publicDir: string; cacheDir: string; command: 'build' | 'serve'; mode: string; isWorker: boolean; isProduction: boolean; envDir: string; env: Record
; resolve: Required
& { alias: Alias[]; }; plugins: readonly Plugin[]; css: ResolvedCSSOptions; json: Required
; esbuild: ESBuildOptions | false; server: ResolvedServerOptions; dev: ResolvedDevEnvironmentOptions; /** @experimental */ builder: ResolvedBuilderOptions | undefined; build: ResolvedBuildOptions; preview: ResolvedPreviewOptions; ssr: ResolvedSSROptions; assetsInclude: (file: string) => boolean; logger: Logger; createResolver: (options?: Partial
) => ResolveFn; optimizeDeps: DepOptimizationOptions; worker: ResolvedWorkerOptions; appType: AppType; experimental: ExperimentalOptions; environments: Record
; /** * The token to connect to the WebSocket server from browsers. * * We recommend using `import.meta.hot` rather than connecting * to the WebSocket server directly. * If you have a usecase that requires connecting to the WebSocket * server, please create an issue so that we can discuss. * * @deprecated */ webSocketToken: string; } & PluginHookUtils> { } interface PluginHookUtils { getSortedPlugins:
(hookName: K) => PluginWithRequiredHook
[]; getSortedPluginHooks:
(hookName: K) => NonNullable
>[]; } type ResolveFn = (id: string, importer?: string, aliasOnly?: boolean, ssr?: boolean) => Promise
; declare function resolveConfig(inlineConfig: InlineConfig, command: 'build' | 'serve', defaultMode?: string, defaultNodeEnv?: string, isPreview?: boolean, ): Promise
; declare function sortUserPlugins(plugins: (Plugin | Plugin[])[] | undefined): [Plugin[], Plugin[], Plugin[]]; declare function loadConfigFromFile(configEnv: ConfigEnv, configFile?: string, configRoot?: string, logLevel?: LogLevel, customLogger?: Logger, configLoader?: 'bundle' | 'runner' | 'native'): Promise<{ path: string; config: UserConfig; dependencies: string[]; } | null>; 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; declare function buildErrorMessage(err: RollupError, args?: string[], includeStack?: boolean): string; /** * @experimental */ interface ServerModuleRunnerOptions extends Omit
{ /** * Disable HMR or configure HMR logger. */ hmr?: false | { logger?: ModuleRunnerHmr['logger']; }; /** * Provide a custom module evaluator. This controls how the code is executed. */ evaluator?: ModuleEvaluator; } declare const createServerModuleRunnerTransport: (options: { channel: NormalizedServerHotChannel; }) => ModuleRunnerTransport; /** * Create an instance of the Vite SSR runtime that support HMR. * @experimental */ declare function createServerModuleRunner(environment: DevEnvironment, options?: ServerModuleRunnerOptions): ModuleRunner; declare function createRunnableDevEnvironment(name: string, config: ResolvedConfig, context?: RunnableDevEnvironmentContext): RunnableDevEnvironment; interface RunnableDevEnvironmentContext extends Omit