vite 8.2.2 → 8.3.0-beta.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,36 +1,37 @@
1
1
  /// <reference types="node" />
2
2
  import { t as ModuleRunnerTransport } from "./chunks/moduleRunnerTransport.js";
3
- import { ConnectedPayload, CustomPayload, CustomPayload as hmrPayload_CustomPayload, ErrorPayload, FullReloadPayload, HMRPayload, HotPayload, HotPayload as hmrPayload_HotPayload, PrunePayload, Update, UpdatePayload } from "#types/hmrPayload";
4
3
  import { CustomEventMap, InferCustomEventPayload, InferCustomEventPayload as hmrPayload_InferCustomEventPayload, InvalidatePayload } from "#types/customEvent";
4
+ import { ConnectedPayload, CustomPayload, CustomPayload as hmrPayload_CustomPayload, ErrorPayload, FullReloadPayload, HMRPayload, HotPayload, HotPayload as hmrPayload_HotPayload, PrunePayload, Update, UpdatePayload } from "#types/hmrPayload";
5
5
  import * as Rolldown from "rolldown";
6
6
  import { CustomPluginOptions, ExistingRawSourceMap, FunctionPluginHooks, ImportKind, InputOption, InputOptions, LoadResult, MinimalPluginContext, ModuleFormat, ModuleInfo, ModuleType, ModuleTypeFilter, ObjectHook, OutputBundle, OutputChunk, OutputOptions, PartialResolvedId, PluginContext, PluginContextMeta, ResolveIdResult, RolldownOptions, RolldownOutput, RolldownWatcher, RollupError, RollupLog, SourceDescription, SourceMap, SourceMapInput, TransformPluginContext, VERSION as rolldownVersion, WatcherOptions } from "rolldown";
7
7
  import { parseAst as parseAst$1, parseAstAsync as parseAstAsync$1 } from "rolldown/parseAst";
8
8
  import * as Rollup from "#types/internal/rollupTypeCompat";
9
9
  import { esmExternalRequirePlugin } from "rolldown/plugins";
10
10
  import { ESTree, MinifyOptions, MinifyResult, ParseResult, ParserOptions, TransformOptions as rolldown_utils_TransformOptions, TransformResult as rolldown_utils_TransformResult, Visitor, VisitorObject, minify, minifySync, parse, parseSync } from "rolldown/utils";
11
+ import { DepsOptimizerEsbuildOptions, EsbuildTarget, EsbuildTransformOptions, EsbuildTransformOptions as esbuildOptions_EsbuildTransformOptions, EsbuildTransformResult } from "#types/internal/esbuildOptions";
12
+ import { ChunkMetadata, CustomPluginOptionsVite } from "#types/metadata";
11
13
  import * as http from "node:http";
12
14
  import { Agent, ClientRequest, ClientRequestArgs, OutgoingHttpHeaders, ServerResponse } from "node:http";
13
15
  import { Http2SecureServer } from "node:http2";
14
- import * as fs from "node:fs";
15
16
  import { EventEmitter } from "node:events";
17
+ import * as fs from "node:fs";
16
18
  import { Server as HttpsServer, ServerOptions as HttpsServerOptions } from "node:https";
17
19
  import * as net from "node:net";
18
20
  import { Duplex, DuplexOptions, Stream } from "node:stream";
19
21
  import { FetchFunction, FetchFunctionOptions, FetchResult, FetchResult as moduleRunner_FetchResult, ModuleEvaluator, ModuleRunner, ModuleRunnerHmr, ModuleRunnerOptions } from "vite/module-runner";
20
- import { DepsOptimizerEsbuildOptions, EsbuildTarget, EsbuildTransformOptions, EsbuildTransformOptions as esbuildOptions_EsbuildTransformOptions, EsbuildTransformResult } from "#types/internal/esbuildOptions";
21
22
  import { SecureContextOptions } from "node:tls";
22
23
  import { URL as url_URL } from "node:url";
23
24
  import { ZlibOptions } from "node:zlib";
24
- import { ChunkMetadata, CustomPluginOptionsVite } from "#types/metadata";
25
+ import { DevWatchOptions } from "rolldown/experimental";
25
26
  import { Terser, TerserMinifyOptions } from "#types/internal/terserOptions";
26
27
  import * as PostCSS from "postcss";
27
28
  import { ProcessOptions, Processor, Transformer } from "postcss";
28
- import { LightningCSSOptions, LightningCSSOptions as lightningcssOptions_LightningCSSOptions } from "#types/internal/lightningcssOptions";
29
29
  import { LessPreprocessorBaseOptions, SassModernPreprocessBaseOptions, StylusPreprocessorBaseOptions } from "#types/internal/cssPreprocessorOptions";
30
+ import { LightningCSSOptions, LightningCSSOptions as lightningcssOptions_LightningCSSOptions } from "#types/internal/lightningcssOptions";
30
31
  import { withFilter } from "rolldown/filter";
31
32
  import { GeneralImportGlobOptions, ImportGlobFunction, ImportGlobOptions, KnownAsTypeMap, KnownQueryTypeMap } from "#types/importGlob";
32
33
  //#endregion
33
- //#region ../../node_modules/.pnpm/@vitejs+devtools@0.4.12_crossws@0.4.10_srvx@0.12.5_typescript@6.0.3_vite@packages+vite/node_modules/@vitejs/devtools/dist/cli-commands.d.ts
34
+ //#region ../../node_modules/.pnpm/@vitejs+devtools@0.5.1_@devframes+json-render@0.9.7_srvx@0.12.7_vite@packages+vite/node_modules/@vitejs/devtools/dist/cli-commands.d.ts
34
35
  //#region src/node/cli-commands.d.ts
35
36
  interface StartOptions {
36
37
  root?: string;
@@ -40,7 +41,7 @@ interface StartOptions {
40
41
  open?: boolean;
41
42
  }
42
43
  //#endregion
43
- //#region ../../node_modules/.pnpm/@vitejs+devtools@0.4.12_crossws@0.4.10_srvx@0.12.5_typescript@6.0.3_vite@packages+vite/node_modules/@vitejs/devtools/dist/config.d.ts
44
+ //#region ../../node_modules/.pnpm/@vitejs+devtools@0.5.1_@devframes+json-render@0.9.7_srvx@0.12.7_vite@packages+vite/node_modules/@vitejs/devtools/dist/config.d.ts
44
45
  //#region src/node/config.d.ts
45
46
  interface DevToolsConfig extends Partial<StartOptions> {
46
47
  enabled: boolean;
@@ -114,148 +115,409 @@ type AliasOptions = readonly Alias[] | {
114
115
  [find: string]: string;
115
116
  };
116
117
  //#endregion
117
- //#region src/types/anymatch.d.ts
118
- type AnymatchFn = (testString: string) => boolean;
119
- type AnymatchPattern = string | RegExp | AnymatchFn;
120
- type AnymatchMatcher = AnymatchPattern | AnymatchPattern[];
121
- //#endregion
122
- //#region src/types/chokidar.d.ts
123
- declare class FSWatcher extends EventEmitter implements fs.FSWatcher {
124
- options: WatchOptions;
125
- /**
126
- * Constructs a new FSWatcher instance with optional WatchOptions parameter.
127
- */
128
- constructor(options?: WatchOptions);
129
- /**
130
- * When called, requests that the Node.js event loop not exit so long as the fs.FSWatcher is active.
131
- * Calling watcher.ref() multiple times will have no effect.
132
- */
133
- ref(): this;
134
- /**
135
- * When called, the active fs.FSWatcher object will not require the Node.js event loop to remain active.
136
- * If there is no other activity keeping the event loop running, the process may exit before the fs.FSWatcher object's callback is invoked.
137
- * Calling watcher.unref() multiple times will have no effect.
138
- */
139
- unref(): this;
140
- /**
141
- * Add files, directories, or glob patterns for tracking. Takes an array of strings or just one
142
- * string.
143
- */
144
- add(paths: string | ReadonlyArray<string>): this;
145
- /**
146
- * Stop watching files, directories, or glob patterns. Takes an array of strings or just one
147
- * string.
148
- */
149
- unwatch(paths: string | ReadonlyArray<string>): this;
150
- /**
151
- * Returns an object representing all the paths on the file system being watched by this
152
- * `FSWatcher` instance. The object's keys are all the directories (using absolute paths unless
153
- * the `cwd` option was used), and the values are arrays of the names of the items contained in
154
- * each directory.
155
- */
156
- getWatched(): {
157
- [directory: string]: string[];
158
- };
159
- /**
160
- * Removes all listeners from watched files.
161
- */
162
- close(): Promise<void>;
163
- on(event: 'add' | 'addDir' | 'change', listener: (path: string, stats?: fs.Stats) => void): this;
164
- on(event: 'all', listener: (eventName: 'add' | 'addDir' | 'change' | 'unlink' | 'unlinkDir', path: string, stats?: fs.Stats) => void): this;
118
+ //#region src/node/assetSource.d.ts
119
+ /**
120
+ * Defines which attributes of an HTML element should be treated as asset sources.
121
+ * Used in `html.additionalAssetSources` configuration.
122
+ */
123
+ interface HtmlAssetSource {
165
124
  /**
166
- * Error occurred
125
+ * Attributes that contain a single asset URL.
126
+ * @example ['src', 'data-src-dark']
167
127
  */
168
- on(event: 'error', listener: (error: Error) => void): this;
128
+ srcAttributes?: string[];
169
129
  /**
170
- * Exposes the native Node `fs.FSWatcher events`
130
+ * Attributes that contain srcset-format URLs.
131
+ * @example ['srcset', 'imagesrcset']
171
132
  */
172
- on(event: 'raw', listener: (eventName: string, path: string, details: any) => void): this;
133
+ srcsetAttributes?: string[];
173
134
  /**
174
- * Fires when the initial scan is complete
135
+ * Called before handling an attribute to determine if it should be processed.
175
136
  */
176
- on(event: 'ready', listener: () => void): this;
177
- on(event: 'unlink' | 'unlinkDir', listener: (path: string) => void): this;
178
- on(event: string, listener: (...args: any[]) => void): this;
137
+ filter?: (data: HtmlAssetSourceFilterData) => boolean;
179
138
  }
180
- interface WatchOptions {
181
- /**
182
- * Indicates whether the process should continue to run as long as files are being watched. If
183
- * set to `false` when using `fsevents` to watch, no more events will be emitted after `ready`,
184
- * even if the process continues to run.
185
- */
186
- persistent?: boolean;
187
- /**
188
- * ([anymatch](https://github.com/micromatch/anymatch)-compatible definition) Defines files/paths to
189
- * be ignored. The whole relative or absolute path is tested, not just filename. If a function
190
- * with two arguments is provided, it gets called twice per path - once with a single argument
191
- * (the path), second time with two arguments (the path and the
192
- * [`fs.Stats`](https://nodejs.org/api/fs.html#fs_class_fs_stats) object of that path).
193
- */
194
- ignored?: AnymatchMatcher;
139
+ interface HtmlAssetSourceFilterData {
140
+ key: string;
141
+ value: string;
142
+ attributes: Record<string, string>;
143
+ }
144
+ //#endregion
145
+ //#region src/types/commonjs.d.ts
146
+
147
+ interface RollupCommonJSOptions {
195
148
  /**
196
- * If set to `false` then `add`/`addDir` events are also emitted for matching paths while
197
- * instantiating the watching as chokidar discovers these file paths (before the `ready` event).
149
+ * A minimatch pattern, or array of patterns, which specifies the files in
150
+ * the build the plugin should operate on. By default, all files with
151
+ * extension `".cjs"` or those in `extensions` are included, but you can
152
+ * narrow this list by only including specific files. These files will be
153
+ * analyzed and transpiled if either the analysis does not find ES module
154
+ * specific statements or `transformMixedEsModules` is `true`.
155
+ * @default undefined
198
156
  */
199
- ignoreInitial?: boolean;
157
+ include?: string | RegExp | readonly (string | RegExp)[];
200
158
  /**
201
- * When `false`, only the symlinks themselves will be watched for changes instead of following
202
- * the link references and bubbling events through the link's path.
159
+ * A minimatch pattern, or array of patterns, which specifies the files in
160
+ * the build the plugin should _ignore_. By default, all files with
161
+ * extensions other than those in `extensions` or `".cjs"` are ignored, but you
162
+ * can exclude additional files. See also the `include` option.
163
+ * @default undefined
203
164
  */
204
- followSymlinks?: boolean;
165
+ exclude?: string | RegExp | readonly (string | RegExp)[];
205
166
  /**
206
- * The base directory from which watch `paths` are to be derived. Paths emitted with events will
207
- * be relative to this.
167
+ * For extensionless imports, search for extensions other than .js in the
168
+ * order specified. Note that you need to make sure that non-JavaScript files
169
+ * are transpiled by another plugin first.
170
+ * @default [ '.js' ]
208
171
  */
209
- cwd?: string;
172
+ extensions?: ReadonlyArray<string>;
210
173
  /**
211
- * If set to true then the strings passed to .watch() and .add() are treated as literal path
212
- * names, even if they look like globs.
213
- *
174
+ * If true then uses of `global` won't be dealt with by this plugin
214
175
  * @default false
215
176
  */
216
- disableGlobbing?: boolean;
177
+ ignoreGlobal?: boolean;
217
178
  /**
218
- * Whether to use fs.watchFile (backed by polling), or fs.watch. If polling leads to high CPU
219
- * utilization, consider setting this to `false`. It is typically necessary to **set this to
220
- * `true` to successfully watch files over a network**, and it may be necessary to successfully
221
- * watch files in other non-standard situations. Setting to `true` explicitly on OS X overrides
222
- * the `useFsEvents` default.
179
+ * If false, skips source map generation for CommonJS modules. This will
180
+ * improve performance.
181
+ * @default true
223
182
  */
224
- usePolling?: boolean;
183
+ sourceMap?: boolean;
225
184
  /**
226
- * Whether to use the `fsevents` watching interface if available. When set to `true` explicitly
227
- * and `fsevents` is available this supersedes the `usePolling` setting. When set to `false` on
228
- * OS X, `usePolling: true` becomes the default.
185
+ * Some `require` calls cannot be resolved statically to be translated to
186
+ * imports.
187
+ * When this option is set to `false`, the generated code will either
188
+ * directly throw an error when such a call is encountered or, when
189
+ * `dynamicRequireTargets` is used, when such a call cannot be resolved with a
190
+ * configured dynamic require target.
191
+ * Setting this option to `true` will instead leave the `require` call in the
192
+ * code or use it as a fallback for `dynamicRequireTargets`.
193
+ * @default false
229
194
  */
230
- useFsEvents?: boolean;
195
+ ignoreDynamicRequires?: boolean;
231
196
  /**
232
- * If relying upon the [`fs.Stats`](https://nodejs.org/api/fs.html#fs_class_fs_stats) object that
233
- * may get passed with `add`, `addDir`, and `change` events, set this to `true` to ensure it is
234
- * provided even in cases where it wasn't already available from the underlying watch events.
197
+ * Instructs the plugin whether to enable mixed module transformations. This
198
+ * is useful in scenarios with modules that contain a mix of ES `import`
199
+ * statements and CommonJS `require` expressions. Set to `true` if `require`
200
+ * calls should be transformed to imports in mixed modules, or `false` if the
201
+ * `require` expressions should survive the transformation. The latter can be
202
+ * important if the code contains environment detection, or you are coding
203
+ * for an environment with special treatment for `require` calls such as
204
+ * ElectronJS. See also the `ignore` option.
205
+ * @default false
235
206
  */
236
- alwaysStat?: boolean;
207
+ transformMixedEsModules?: boolean;
237
208
  /**
238
- * If set, limits how many levels of subdirectories will be traversed.
209
+ * By default, this plugin will try to hoist `require` statements as imports
210
+ * to the top of each file. While this works well for many code bases and
211
+ * allows for very efficient ESM output, it does not perfectly capture
212
+ * CommonJS semantics as the order of side effects like log statements may
213
+ * change. But it is especially problematic when there are circular `require`
214
+ * calls between CommonJS modules as those often rely on the lazy execution of
215
+ * nested `require` calls.
216
+ *
217
+ * Setting this option to `true` will wrap all CommonJS files in functions
218
+ * which are executed when they are required for the first time, preserving
219
+ * NodeJS semantics. Note that this can have an impact on the size and
220
+ * performance of the generated code.
221
+ *
222
+ * The default value of `"auto"` will only wrap CommonJS files when they are
223
+ * part of a CommonJS dependency cycle, e.g. an index file that is required by
224
+ * many of its dependencies. All other CommonJS files are hoisted. This is the
225
+ * recommended setting for most code bases.
226
+ *
227
+ * `false` will entirely prevent wrapping and hoist all files. This may still
228
+ * work depending on the nature of cyclic dependencies but will often cause
229
+ * problems.
230
+ *
231
+ * You can also provide a minimatch pattern, or array of patterns, to only
232
+ * specify a subset of files which should be wrapped in functions for proper
233
+ * `require` semantics.
234
+ *
235
+ * `"debug"` works like `"auto"` but after bundling, it will display a warning
236
+ * containing a list of ids that have been wrapped which can be used as
237
+ * minimatch pattern for fine-tuning.
238
+ * @default "auto"
239
239
  */
240
- depth?: number;
240
+ strictRequires?: boolean | string | RegExp | readonly (string | RegExp)[];
241
241
  /**
242
- * Interval of file system polling.
242
+ * Sometimes you have to leave require statements unconverted. Pass an array
243
+ * containing the IDs or a `id => boolean` function.
244
+ * @default []
243
245
  */
244
- interval?: number;
246
+ ignore?: ReadonlyArray<string> | ((id: string) => boolean);
245
247
  /**
246
- * Interval of file system polling for binary files. ([see list of binary extensions](https://gi
247
- * thub.com/sindresorhus/binary-extensions/blob/master/binary-extensions.json))
248
+ * In most cases, where `require` calls are inside a `try-catch` clause,
249
+ * they should be left unconverted as it requires an optional dependency
250
+ * that may or may not be installed beside the rolled up package.
251
+ * Due to the conversion of `require` to a static `import` - the call is
252
+ * hoisted to the top of the file, outside the `try-catch` clause.
253
+ *
254
+ * - `true`: Default. All `require` calls inside a `try` will be left unconverted.
255
+ * - `false`: All `require` calls inside a `try` will be converted as if the
256
+ * `try-catch` clause is not there.
257
+ * - `remove`: Remove all `require` calls from inside any `try` block.
258
+ * - `string[]`: Pass an array containing the IDs to left unconverted.
259
+ * - `((id: string) => boolean|'remove')`: Pass a function that controls
260
+ * individual IDs.
261
+ *
262
+ * @default true
248
263
  */
249
- binaryInterval?: number;
264
+ ignoreTryCatch?: boolean | 'remove' | ReadonlyArray<string> | ((id: string) => boolean | 'remove');
250
265
  /**
251
- * Indicates whether to watch files that don't have read permissions if possible. If watching
252
- * fails due to `EPERM` or `EACCES` with this set to `true`, the errors will be suppressed
253
- * silently.
266
+ * Controls how to render imports from external dependencies. By default,
267
+ * this plugin assumes that all external dependencies are CommonJS. This
268
+ * means they are rendered as default imports to be compatible with e.g.
269
+ * NodeJS where ES modules can only import a default export from a CommonJS
270
+ * dependency.
271
+ *
272
+ * If you set `esmExternals` to `true`, this plugin assumes that all
273
+ * external dependencies are ES modules and respect the
274
+ * `requireReturnsDefault` option. If that option is not set, they will be
275
+ * rendered as namespace imports.
276
+ *
277
+ * You can also supply an array of ids to be treated as ES modules, or a
278
+ * function that will be passed each external id to determine whether it is
279
+ * an ES module.
280
+ * @default false
254
281
  */
255
- ignorePermissionErrors?: boolean;
282
+ esmExternals?: boolean | ReadonlyArray<string> | ((id: string) => boolean);
256
283
  /**
257
- * `true` if `useFsEvents` and `usePolling` are `false`. Automatically filters out artifacts
258
- * that occur when using editors that use "atomic writes" instead of writing directly to the
284
+ * Controls what is returned when requiring an ES module from a CommonJS file.
285
+ * When using the `esmExternals` option, this will also apply to external
286
+ * modules. By default, this plugin will render those imports as namespace
287
+ * imports i.e.
288
+ *
289
+ * ```js
290
+ * // input
291
+ * const foo = require('foo');
292
+ *
293
+ * // output
294
+ * import * as foo from 'foo';
295
+ * ```
296
+ *
297
+ * However, there are some situations where this may not be desired.
298
+ * For these situations, you can change Rollup's behaviour either globally or
299
+ * per module. To change it globally, set the `requireReturnsDefault` option
300
+ * to one of the following values:
301
+ *
302
+ * - `false`: This is the default, requiring an ES module returns its
303
+ * namespace. This is the only option that will also add a marker
304
+ * `__esModule: true` to the namespace to support interop patterns in
305
+ * CommonJS modules that are transpiled ES modules.
306
+ * - `"namespace"`: Like `false`, requiring an ES module returns its
307
+ * namespace, but the plugin does not add the `__esModule` marker and thus
308
+ * creates more efficient code. For external dependencies when using
309
+ * `esmExternals: true`, no additional interop code is generated.
310
+ * - `"auto"`: This is complementary to how `output.exports: "auto"` works in
311
+ * Rollup: If a module has a default export and no named exports, requiring
312
+ * that module returns the default export. In all other cases, the namespace
313
+ * is returned. For external dependencies when using `esmExternals: true`, a
314
+ * corresponding interop helper is added.
315
+ * - `"preferred"`: If a module has a default export, requiring that module
316
+ * always returns the default export, no matter whether additional named
317
+ * exports exist. This is similar to how previous versions of this plugin
318
+ * worked. Again for external dependencies when using `esmExternals: true`,
319
+ * an interop helper is added.
320
+ * - `true`: This will always try to return the default export on require
321
+ * without checking if it actually exists. This can throw at build time if
322
+ * there is no default export. This is how external dependencies are handled
323
+ * when `esmExternals` is not used. The advantage over the other options is
324
+ * that, like `false`, this does not add an interop helper for external
325
+ * dependencies, keeping the code lean.
326
+ *
327
+ * To change this for individual modules, you can supply a function for
328
+ * `requireReturnsDefault` instead. This function will then be called once for
329
+ * each required ES module or external dependency with the corresponding id
330
+ * and allows you to return different values for different modules.
331
+ * @default false
332
+ */
333
+ requireReturnsDefault?: boolean | 'auto' | 'preferred' | 'namespace' | ((id: string) => boolean | 'auto' | 'preferred' | 'namespace');
334
+ /**
335
+ * @default "auto"
336
+ */
337
+ defaultIsModuleExports?: boolean | 'auto' | ((id: string) => boolean | 'auto');
338
+ /**
339
+ * Some modules contain dynamic `require` calls, or require modules that
340
+ * contain circular dependencies, which are not handled well by static
341
+ * imports. Including those modules as `dynamicRequireTargets` will simulate a
342
+ * CommonJS (NodeJS-like) environment for them with support for dynamic
343
+ * dependencies. It also enables `strictRequires` for those modules.
344
+ *
345
+ * Note: In extreme cases, this feature may result in some paths being
346
+ * rendered as absolute in the final bundle. The plugin tries to avoid
347
+ * exposing paths from the local machine, but if you are `dynamicRequirePaths`
348
+ * with paths that are far away from your project's folder, that may require
349
+ * replacing strings like `"/Users/John/Desktop/foo-project/"` -\> `"/"`.
350
+ */
351
+ dynamicRequireTargets?: string | ReadonlyArray<string>;
352
+ /**
353
+ * To avoid long paths when using the `dynamicRequireTargets` option, you can use this option to specify a directory
354
+ * that is a common parent for all files that use dynamic require statements. Using a directory higher up such as `/`
355
+ * may lead to unnecessarily long paths in the generated code and may expose directory names on your machine like your
356
+ * home directory name. By default, it uses the current working directory.
357
+ */
358
+ dynamicRequireRoot?: string;
359
+ }
360
+ //#endregion
361
+ //#region src/types/dynamicImportVars.d.ts
362
+ interface RollupDynamicImportVarsOptions {
363
+ /**
364
+ * Files to include in this plugin (default all).
365
+ * @default []
366
+ */
367
+ include?: string | RegExp | (string | RegExp)[];
368
+ /**
369
+ * Files to exclude in this plugin (default none).
370
+ * @default []
371
+ */
372
+ exclude?: string | RegExp | (string | RegExp)[];
373
+ /**
374
+ * @deprecated This option is no-op and will be removed in future versions.
375
+ */
376
+ warnOnError?: boolean;
377
+ }
378
+ //#endregion
379
+ //#region src/types/anymatch.d.ts
380
+ type AnymatchFn = (testString: string) => boolean;
381
+ type AnymatchPattern = string | RegExp | AnymatchFn;
382
+ type AnymatchMatcher = AnymatchPattern | AnymatchPattern[];
383
+ //#endregion
384
+ //#region src/types/chokidar.d.ts
385
+ declare class FSWatcher extends EventEmitter implements fs.FSWatcher {
386
+ options: WatchOptions;
387
+ /**
388
+ * Constructs a new FSWatcher instance with optional WatchOptions parameter.
389
+ */
390
+ constructor(options?: WatchOptions);
391
+ /**
392
+ * When called, requests that the Node.js event loop not exit so long as the fs.FSWatcher is active.
393
+ * Calling watcher.ref() multiple times will have no effect.
394
+ */
395
+ ref(): this;
396
+ /**
397
+ * When called, the active fs.FSWatcher object will not require the Node.js event loop to remain active.
398
+ * If there is no other activity keeping the event loop running, the process may exit before the fs.FSWatcher object's callback is invoked.
399
+ * Calling watcher.unref() multiple times will have no effect.
400
+ */
401
+ unref(): this;
402
+ /**
403
+ * Add files, directories, or glob patterns for tracking. Takes an array of strings or just one
404
+ * string.
405
+ */
406
+ add(paths: string | ReadonlyArray<string>): this;
407
+ /**
408
+ * Stop watching files, directories, or glob patterns. Takes an array of strings or just one
409
+ * string.
410
+ */
411
+ unwatch(paths: string | ReadonlyArray<string>): this;
412
+ /**
413
+ * Returns an object representing all the paths on the file system being watched by this
414
+ * `FSWatcher` instance. The object's keys are all the directories (using absolute paths unless
415
+ * the `cwd` option was used), and the values are arrays of the names of the items contained in
416
+ * each directory.
417
+ */
418
+ getWatched(): {
419
+ [directory: string]: string[];
420
+ };
421
+ /**
422
+ * Removes all listeners from watched files.
423
+ */
424
+ close(): Promise<void>;
425
+ on(event: 'add' | 'addDir' | 'change', listener: (path: string, stats?: fs.Stats) => void): this;
426
+ on(event: 'all', listener: (eventName: 'add' | 'addDir' | 'change' | 'unlink' | 'unlinkDir', path: string, stats?: fs.Stats) => void): this;
427
+ /**
428
+ * Error occurred
429
+ */
430
+ on(event: 'error', listener: (error: Error) => void): this;
431
+ /**
432
+ * Exposes the native Node `fs.FSWatcher events`
433
+ */
434
+ on(event: 'raw', listener: (eventName: string, path: string, details: any) => void): this;
435
+ /**
436
+ * Fires when the initial scan is complete
437
+ */
438
+ on(event: 'ready', listener: () => void): this;
439
+ on(event: 'unlink' | 'unlinkDir', listener: (path: string) => void): this;
440
+ on(event: string, listener: (...args: any[]) => void): this;
441
+ }
442
+ interface WatchOptions {
443
+ /**
444
+ * Indicates whether the process should continue to run as long as files are being watched. If
445
+ * set to `false` when using `fsevents` to watch, no more events will be emitted after `ready`,
446
+ * even if the process continues to run.
447
+ */
448
+ persistent?: boolean;
449
+ /**
450
+ * ([anymatch](https://github.com/micromatch/anymatch)-compatible definition) Defines files/paths to
451
+ * be ignored. The whole relative or absolute path is tested, not just filename. If a function
452
+ * with two arguments is provided, it gets called twice per path - once with a single argument
453
+ * (the path), second time with two arguments (the path and the
454
+ * [`fs.Stats`](https://nodejs.org/api/fs.html#fs_class_fs_stats) object of that path).
455
+ */
456
+ ignored?: AnymatchMatcher;
457
+ /**
458
+ * If set to `false` then `add`/`addDir` events are also emitted for matching paths while
459
+ * instantiating the watching as chokidar discovers these file paths (before the `ready` event).
460
+ */
461
+ ignoreInitial?: boolean;
462
+ /**
463
+ * When `false`, only the symlinks themselves will be watched for changes instead of following
464
+ * the link references and bubbling events through the link's path.
465
+ */
466
+ followSymlinks?: boolean;
467
+ /**
468
+ * The base directory from which watch `paths` are to be derived. Paths emitted with events will
469
+ * be relative to this.
470
+ */
471
+ cwd?: string;
472
+ /**
473
+ * If set to true then the strings passed to .watch() and .add() are treated as literal path
474
+ * names, even if they look like globs.
475
+ *
476
+ * @default false
477
+ */
478
+ disableGlobbing?: boolean;
479
+ /**
480
+ * Whether to use fs.watchFile (backed by polling), or fs.watch. If polling leads to high CPU
481
+ * utilization, consider setting this to `false`. It is typically necessary to **set this to
482
+ * `true` to successfully watch files over a network**, and it may be necessary to successfully
483
+ * watch files in other non-standard situations. Setting to `true` explicitly on OS X overrides
484
+ * the `useFsEvents` default.
485
+ */
486
+ usePolling?: boolean;
487
+ /**
488
+ * Whether to use the `fsevents` watching interface if available. When set to `true` explicitly
489
+ * and `fsevents` is available this supersedes the `usePolling` setting. When set to `false` on
490
+ * OS X, `usePolling: true` becomes the default.
491
+ */
492
+ useFsEvents?: boolean;
493
+ /**
494
+ * If relying upon the [`fs.Stats`](https://nodejs.org/api/fs.html#fs_class_fs_stats) object that
495
+ * may get passed with `add`, `addDir`, and `change` events, set this to `true` to ensure it is
496
+ * provided even in cases where it wasn't already available from the underlying watch events.
497
+ */
498
+ alwaysStat?: boolean;
499
+ /**
500
+ * If set, limits how many levels of subdirectories will be traversed.
501
+ */
502
+ depth?: number;
503
+ /**
504
+ * Interval of file system polling.
505
+ */
506
+ interval?: number;
507
+ /**
508
+ * Interval of file system polling for binary files. ([see list of binary extensions](https://gi
509
+ * thub.com/sindresorhus/binary-extensions/blob/master/binary-extensions.json))
510
+ */
511
+ binaryInterval?: number;
512
+ /**
513
+ * Indicates whether to watch files that don't have read permissions if possible. If watching
514
+ * fails due to `EPERM` or `EACCES` with this set to `true`, the errors will be suppressed
515
+ * silently.
516
+ */
517
+ ignorePermissionErrors?: boolean;
518
+ /**
519
+ * `true` if `useFsEvents` and `usePolling` are `false`. Automatically filters out artifacts
520
+ * that occur when using editors that use "atomic writes" instead of writing directly to the
259
521
  * source file. If a file is re-added within 100 ms of being deleted, Chokidar emits a `change`
260
522
  * event rather than `unlink` then `add`. If the default of 100 ms does not work well for you,
261
523
  * you can override it by setting `atomic` to a custom value, in milliseconds.
@@ -345,6 +607,18 @@ declare namespace Connect {
345
607
  }
346
608
  }
347
609
  //#endregion
610
+ //#region src/shared/forwardConsole.d.ts
611
+ type ForwardConsoleLogLevel = "error" | "warn" | "info" | "log" | "debug" | (string & {});
612
+ interface ForwardConsoleOptions {
613
+ unhandledErrors?: boolean;
614
+ logLevels?: ForwardConsoleLogLevel[];
615
+ }
616
+ interface ResolvedForwardConsoleOptions {
617
+ enabled: boolean;
618
+ unhandledErrors: boolean;
619
+ logLevels: ForwardConsoleLogLevel[];
620
+ }
621
+ //#endregion
348
622
  //#region ../../node_modules/.pnpm/http-proxy-3@1.23.3_ms@2.1.3/node_modules/http-proxy-3/dist/lib/http-proxy/index.d.ts
349
623
  interface ProxyTargetDetailed {
350
624
  host: string;
@@ -576,34 +850,6 @@ interface ProxyOptions extends ServerOptions$3 {
576
850
  rewriteWsOrigin?: boolean | undefined;
577
851
  }
578
852
  //#endregion
579
- //#region src/node/logger.d.ts
580
- type LogType = "error" | "warn" | "info";
581
- type LogLevel = LogType | "silent";
582
- interface Logger {
583
- info(msg: string, options?: LogOptions): void;
584
- warn(msg: string, options?: LogOptions): void;
585
- warnOnce(msg: string, options?: LogOptions): void;
586
- error(msg: string, options?: LogErrorOptions): void;
587
- clearScreen(type: LogType): void;
588
- hasErrorLogged(error: Error | RollupError): boolean;
589
- hasWarned: boolean;
590
- }
591
- interface LogOptions {
592
- clear?: boolean;
593
- timestamp?: boolean;
594
- environment?: string;
595
- }
596
- interface LogErrorOptions extends LogOptions {
597
- error?: Error | RollupError | null;
598
- }
599
- interface LoggerOptions {
600
- prefix?: string;
601
- allowClearScreen?: boolean;
602
- customLogger?: Logger;
603
- console?: Console;
604
- }
605
- export declare function createLogger(level?: LogLevel, options?: LoggerOptions): Logger;
606
- //#endregion
607
853
  //#region src/node/http.d.ts
608
854
  interface CommonServerOptions {
609
855
  /**
@@ -704,120 +950,6 @@ interface CorsOptions {
704
950
  }
705
951
  type CorsOrigin = boolean | string | RegExp | (string | RegExp)[];
706
952
  //#endregion
707
- //#region src/shared/forwardConsole.d.ts
708
- type ForwardConsoleLogLevel = "error" | "warn" | "info" | "log" | "debug" | (string & {});
709
- interface ForwardConsoleOptions {
710
- unhandledErrors?: boolean;
711
- logLevels?: ForwardConsoleLogLevel[];
712
- }
713
- interface ResolvedForwardConsoleOptions {
714
- enabled: boolean;
715
- unhandledErrors: boolean;
716
- logLevels: ForwardConsoleLogLevel[];
717
- }
718
- //#endregion
719
- //#region src/node/typeUtils.d.ts
720
- type RequiredExceptFor<T, K extends keyof T> = Pick<T, K> & Required<Omit<T, K>>;
721
- //#endregion
722
- //#region src/node/preview.d.ts
723
- interface PreviewOptions extends CommonServerOptions {}
724
- interface ResolvedPreviewOptions extends RequiredExceptFor<PreviewOptions, "host" | "https" | "proxy"> {}
725
- interface PreviewServer {
726
- /**
727
- * The resolved vite config object
728
- */
729
- config: ResolvedConfig;
730
- /**
731
- * Stop the server.
732
- */
733
- close(): Promise<void>;
734
- /**
735
- * A connect app instance.
736
- * - Can be used to attach custom middlewares to the preview server.
737
- * - Can also be used as the handler function of a custom http server
738
- * or as a middleware in any connect-style Node.js frameworks
739
- *
740
- * https://github.com/senchalabs/connect#use-middleware
741
- */
742
- middlewares: Connect.Server;
743
- /**
744
- * native Node http server instance
745
- */
746
- httpServer: HttpServer;
747
- /**
748
- * The resolved urls Vite prints on the CLI (URL-encoded). Returns `null`
749
- * if the server is not listening on any port.
750
- */
751
- resolvedUrls: ResolvedServerUrls | null;
752
- /**
753
- * Print server urls
754
- */
755
- printUrls(): void;
756
- /**
757
- * Bind CLI shortcuts
758
- */
759
- bindCLIShortcuts(options?: BindCLIShortcutsOptions<PreviewServer>): void;
760
- }
761
- type PreviewServerHook = (this: MinimalPluginContextWithoutEnvironment, server: PreviewServer) => (() => void) | void | Promise<(() => void) | void>;
762
- /**
763
- * Starts the Vite server in preview mode, to simulate a production deployment
764
- */
765
- export declare function preview(inlineConfig?: InlineConfig): Promise<PreviewServer>;
766
- //#endregion
767
- //#region src/node/shortcuts.d.ts
768
- type BindCLIShortcutsOptions<Server = ViteDevServer | PreviewServer> = {
769
- /**
770
- * Print a one-line shortcuts "help" hint to the terminal
771
- */
772
- print?: boolean;
773
- /**
774
- * Custom shortcuts to run when a key is pressed. These shortcuts take priority
775
- * over the default shortcuts if they have the same keys (except the `h` key).
776
- * To disable a default shortcut, define the same key but with `action: undefined`.
777
- */
778
- customShortcuts?: CLIShortcut<Server>[];
779
- };
780
- type CLIShortcut<Server = ViteDevServer | PreviewServer> = {
781
- key: string;
782
- description: string;
783
- action?(server: Server): void | Promise<void>;
784
- };
785
- //#endregion
786
- //#region src/node/baseEnvironment.d.ts
787
- declare class PartialEnvironment {
788
- name: string;
789
- getTopLevelConfig(): ResolvedConfig;
790
- config: ResolvedConfig & ResolvedEnvironmentOptions;
791
- logger: Logger;
792
- constructor(name: string, topLevelConfig: ResolvedConfig, options?: ResolvedEnvironmentOptions);
793
- }
794
- declare class BaseEnvironment extends PartialEnvironment {
795
- get plugins(): readonly Plugin[];
796
- constructor(name: string, config: ResolvedConfig, options?: ResolvedEnvironmentOptions);
797
- }
798
- /**
799
- * This class discourages users from inversely checking the `mode`
800
- * to determine the type of environment, e.g.
801
- *
802
- * ```js
803
- * const isDev = environment.mode !== 'build' // bad
804
- * const isDev = environment.mode === 'dev' // good
805
- * ```
806
- *
807
- * You should also not check against `"unknown"` specifically. It's
808
- * a placeholder for more possible environment types.
809
- */
810
- declare class UnknownEnvironment extends BaseEnvironment {
811
- mode: "unknown";
812
- }
813
- //#endregion
814
- //#region src/node/optimizer/scan.d.ts
815
- declare class ScanEnvironment extends BaseEnvironment {
816
- mode: "scan";
817
- get pluginContainer(): EnvironmentPluginContainer;
818
- init(): Promise<void>;
819
- }
820
- //#endregion
821
953
  //#region src/node/optimizer/index.d.ts
822
954
  type ExportsData = {
823
955
  hasModuleSyntax: boolean;
@@ -1015,6 +1147,58 @@ interface DepOptimizationMetadata {
1015
1147
  */
1016
1148
  export declare function optimizeDeps(config: ResolvedConfig, force?: boolean | undefined, asCommand?: boolean): Promise<DepOptimizationMetadata>;
1017
1149
  //#endregion
1150
+ //#region src/node/server/bundledDev.d.ts
1151
+ type MemoryFile = {
1152
+ source: string | Uint8Array;
1153
+ etag?: string;
1154
+ };
1155
+ declare class MemoryFiles {
1156
+ private files;
1157
+ get size(): number;
1158
+ get(file: string): MemoryFile | undefined;
1159
+ set(file: string, content: MemoryFile | (() => MemoryFile)): void;
1160
+ has(file: string): boolean;
1161
+ clear(): void;
1162
+ }
1163
+ declare class BundledDev {
1164
+ private environment;
1165
+ private _devEngine;
1166
+ private viteRuntime?;
1167
+ private initialBuildCompleted;
1168
+ private _closed;
1169
+ private clients;
1170
+ private debouncedFullReload;
1171
+ private fullReloadPending;
1172
+ private reloadNeededClientIds;
1173
+ private debouncedReloadNeededFlush;
1174
+ private lastBuildError;
1175
+ memoryFiles: MemoryFiles;
1176
+ constructor(environment: DevEnvironment);
1177
+ private get devEngine();
1178
+ private pendingPayloadFilenames;
1179
+ get hasBuildOutput(): boolean;
1180
+ listen(): Promise<void>;
1181
+ private waitForInitialBuildFinish;
1182
+ private ensureOutputAndFlushReloadNeeded;
1183
+ triggerBundleRegenerationIfStale(): Promise<boolean>;
1184
+ triggerLazyBundling(moduleId: string | null, clientId: string | null): Promise<{
1185
+ code: string;
1186
+ filename: string;
1187
+ } | undefined>;
1188
+ /**
1189
+ * Called by the serving middlewares when the response for a payload completed.
1190
+ * Only delivered payloads are recorded on the server's per-client ship map, so
1191
+ * later chunks may omit a module only if the payload carrying it was delivered.
1192
+ *
1193
+ * Note: the payload filename is unique across all clients.
1194
+ */
1195
+ markPayloadDelivered(filename: string): void;
1196
+ close(): Promise<void>;
1197
+ private storeOutputFiles;
1198
+ private getRolldownOptions;
1199
+ private handleHmrOutput;
1200
+ }
1201
+ //#endregion
1018
1202
  //#region src/node/server/transformRequest.d.ts
1019
1203
  interface TransformResult {
1020
1204
  code: string;
@@ -1308,75 +1492,183 @@ type ServerHotChannel = HotChannel<ServerHotChannelApi>;
1308
1492
  type NormalizedServerHotChannel = NormalizedHotChannel<ServerHotChannelApi>;
1309
1493
  export declare function createServerHotChannel(): ServerHotChannel;
1310
1494
  //#endregion
1311
- //#region src/types/ws.d.ts
1312
- // WebSocket socket.
1313
- declare class WebSocket extends EventEmitter {
1314
- /** The connection is not yet open. */
1315
- static readonly CONNECTING: 0;
1316
- /** The connection is open and ready to communicate. */
1317
- static readonly OPEN: 1;
1318
- /** The connection is in the process of closing. */
1319
- static readonly CLOSING: 2;
1320
- /** The connection is closed. */
1321
- static readonly CLOSED: 3;
1322
- binaryType: 'nodebuffer' | 'arraybuffer' | 'fragments';
1323
- readonly bufferedAmount: number;
1324
- readonly extensions: string;
1325
- /** Indicates whether the websocket is paused */
1326
- readonly isPaused: boolean;
1327
- readonly protocol: string;
1328
- /** The current state of the connection */
1329
- readonly readyState: typeof WebSocket.CONNECTING | typeof WebSocket.OPEN | typeof WebSocket.CLOSING | typeof WebSocket.CLOSED;
1330
- readonly url: string;
1331
- /** The connection is not yet open. */
1332
- readonly CONNECTING: 0;
1333
- /** The connection is open and ready to communicate. */
1334
- readonly OPEN: 1;
1335
- /** The connection is in the process of closing. */
1336
- readonly CLOSING: 2;
1337
- /** The connection is closed. */
1338
- readonly CLOSED: 3;
1339
- onopen: ((event: WebSocket.Event) => void) | null;
1340
- onerror: ((event: WebSocket.ErrorEvent) => void) | null;
1341
- onclose: ((event: WebSocket.CloseEvent) => void) | null;
1342
- onmessage: ((event: WebSocket.MessageEvent) => void) | null;
1343
- constructor(address: null);
1344
- constructor(address: string | url_URL, options?: WebSocket.ClientOptions | ClientRequestArgs);
1345
- constructor(address: string | url_URL, protocols?: string | string[], options?: WebSocket.ClientOptions | ClientRequestArgs);
1346
- close(code?: number, data?: string | Buffer): void;
1347
- ping(data?: any, mask?: boolean, cb?: (err: Error) => void): void;
1348
- pong(data?: any, mask?: boolean, cb?: (err: Error) => void): void;
1349
- send(data: any, cb?: (err?: Error) => void): void;
1350
- send(data: any, options: {
1351
- mask?: boolean | undefined;
1352
- binary?: boolean | undefined;
1353
- compress?: boolean | undefined;
1354
- fin?: boolean | undefined;
1355
- }, cb?: (err?: Error) => void): void;
1356
- terminate(): void;
1357
- /**
1358
- * Pause the websocket causing it to stop emitting events. Some events can still be
1359
- * emitted after this is called, until all buffered data is consumed. This method
1360
- * is a noop if the ready state is `CONNECTING` or `CLOSED`.
1361
- */
1362
- pause(): void;
1363
- /**
1364
- * Make a paused socket resume emitting events. This method is a noop if the ready
1365
- * state is `CONNECTING` or `CLOSED`.
1366
- */
1367
- resume(): void;
1368
- // HTML5 WebSocket events
1369
- addEventListener(method: 'message', cb: (event: WebSocket.MessageEvent) => void, options?: WebSocket.EventListenerOptions): void;
1370
- addEventListener(method: 'close', cb: (event: WebSocket.CloseEvent) => void, options?: WebSocket.EventListenerOptions): void;
1371
- addEventListener(method: 'error', cb: (event: WebSocket.ErrorEvent) => void, options?: WebSocket.EventListenerOptions): void;
1372
- addEventListener(method: 'open', cb: (event: WebSocket.Event) => void, options?: WebSocket.EventListenerOptions): void;
1373
- removeEventListener(method: 'message', cb: (event: WebSocket.MessageEvent) => void): void;
1374
- removeEventListener(method: 'close', cb: (event: WebSocket.CloseEvent) => void): void;
1375
- removeEventListener(method: 'error', cb: (event: WebSocket.ErrorEvent) => void): void;
1376
- removeEventListener(method: 'open', cb: (event: WebSocket.Event) => void): void;
1377
- // Events
1378
- on(event: 'close', listener: (this: WebSocket, code: number, reason: Buffer) => void): this;
1379
- on(event: 'error', listener: (this: WebSocket, err: Error) => void): this;
1495
+ //#region src/node/server/pluginContainer.d.ts
1496
+ type SkipInformation = {
1497
+ id: string;
1498
+ importer: string | undefined;
1499
+ plugin: Plugin;
1500
+ called?: boolean;
1501
+ };
1502
+ declare class EnvironmentPluginContainer<Env extends Environment = Environment> {
1503
+ private _pluginContextMap;
1504
+ private _resolvedRolldownOptions?;
1505
+ private _processesing;
1506
+ private _seenResolves;
1507
+ private _moduleNodeToLoadAddedImports;
1508
+ getSortedPluginHooks: PluginHookUtils["getSortedPluginHooks"];
1509
+ getSortedPlugins: PluginHookUtils["getSortedPlugins"];
1510
+ moduleGraph: EnvironmentModuleGraph | undefined;
1511
+ watchFiles: Set<string>;
1512
+ minimalContext: MinimalPluginContext$1<Env>;
1513
+ private _started;
1514
+ private _buildStartPromise;
1515
+ private _closed;
1516
+ private _updateModuleLoadAddedImports;
1517
+ private _getAddedImports;
1518
+ getModuleInfo(id: string): ModuleInfo | null;
1519
+ private handleHookPromise;
1520
+ get options(): InputOptions;
1521
+ resolveRolldownOptions(): Promise<InputOptions>;
1522
+ private _getPluginContext;
1523
+ private hookParallel;
1524
+ buildStart(_options?: InputOptions): Promise<void>;
1525
+ resolveId(rawId: string, importer?: string | undefined, options?: {
1526
+ kind?: ImportKind;
1527
+ attributes?: Record<string, string>;
1528
+ custom?: CustomPluginOptions;
1529
+ /** @deprecated use `skipCalls` instead */
1530
+ skip?: Set<Plugin>;
1531
+ skipCalls?: readonly SkipInformation[];
1532
+
1533
+ isEntry?: boolean;
1534
+ }): Promise<PartialResolvedId | null>;
1535
+ load(id: string): Promise<LoadResult | null>;
1536
+ transform(code: string, id: string, options?: {
1537
+ inMap?: SourceDescription["map"];
1538
+ moduleType?: string;
1539
+ }): Promise<{
1540
+ code: string;
1541
+ map: SourceMap | {
1542
+ mappings: "";
1543
+ } | null;
1544
+ moduleType?: ModuleType;
1545
+ }>;
1546
+ watchChange(id: string, change: {
1547
+ event: "create" | "update" | "delete";
1548
+ }): Promise<void>;
1549
+ close(): Promise<void>;
1550
+ }
1551
+ declare class BasicMinimalPluginContext<Meta = PluginContextMeta> {
1552
+ meta: Meta;
1553
+ private _logger;
1554
+ constructor(meta: Meta, _logger: Logger);
1555
+ get pluginName(): string;
1556
+ debug(rawLog: string | RollupLog | (() => string | RollupLog)): void;
1557
+ info(rawLog: string | RollupLog | (() => string | RollupLog)): void;
1558
+ warn(rawLog: string | RollupLog | (() => string | RollupLog)): void;
1559
+ error(e: string | RollupError): never;
1560
+ private _normalizeRawLog;
1561
+ }
1562
+ declare class MinimalPluginContext$1<T extends Environment = Environment> extends BasicMinimalPluginContext implements MinimalPluginContext {
1563
+ environment: T;
1564
+ constructor(meta: PluginContextMeta, environment: T);
1565
+ }
1566
+ declare class PluginContainer {
1567
+ private environments;
1568
+ constructor(environments: Record<string, Environment>);
1569
+ private _getEnvironment;
1570
+ private _getPluginContainer;
1571
+ getModuleInfo(id: string): ModuleInfo | null;
1572
+ get options(): InputOptions;
1573
+ buildStart(_options?: InputOptions): Promise<void>;
1574
+ watchChange(id: string, change: {
1575
+ event: "create" | "update" | "delete";
1576
+ }): Promise<void>;
1577
+ resolveId(rawId: string, importer?: string, options?: {
1578
+ attributes?: Record<string, string>;
1579
+ custom?: CustomPluginOptions;
1580
+ /** @deprecated use `skipCalls` instead */
1581
+ skip?: Set<Plugin>;
1582
+ skipCalls?: readonly SkipInformation[];
1583
+ ssr?: boolean;
1584
+
1585
+ isEntry?: boolean;
1586
+ }): Promise<PartialResolvedId | null>;
1587
+ load(id: string, options?: {
1588
+ ssr?: boolean;
1589
+ }): Promise<LoadResult | null>;
1590
+ transform(code: string, id: string, options?: {
1591
+ ssr?: boolean;
1592
+ environment?: Environment;
1593
+ inMap?: SourceDescription["map"];
1594
+ }): Promise<{
1595
+ code: string;
1596
+ map: SourceMap | {
1597
+ mappings: "";
1598
+ } | null;
1599
+ }>;
1600
+ close(): Promise<void>;
1601
+ }
1602
+ //#endregion
1603
+ //#region src/types/ws.d.ts
1604
+ // WebSocket socket.
1605
+ declare class WebSocket extends EventEmitter {
1606
+ /** The connection is not yet open. */
1607
+ static readonly CONNECTING: 0;
1608
+ /** The connection is open and ready to communicate. */
1609
+ static readonly OPEN: 1;
1610
+ /** The connection is in the process of closing. */
1611
+ static readonly CLOSING: 2;
1612
+ /** The connection is closed. */
1613
+ static readonly CLOSED: 3;
1614
+ binaryType: 'nodebuffer' | 'arraybuffer' | 'fragments';
1615
+ readonly bufferedAmount: number;
1616
+ readonly extensions: string;
1617
+ /** Indicates whether the websocket is paused */
1618
+ readonly isPaused: boolean;
1619
+ readonly protocol: string;
1620
+ /** The current state of the connection */
1621
+ readonly readyState: typeof WebSocket.CONNECTING | typeof WebSocket.OPEN | typeof WebSocket.CLOSING | typeof WebSocket.CLOSED;
1622
+ readonly url: string;
1623
+ /** The connection is not yet open. */
1624
+ readonly CONNECTING: 0;
1625
+ /** The connection is open and ready to communicate. */
1626
+ readonly OPEN: 1;
1627
+ /** The connection is in the process of closing. */
1628
+ readonly CLOSING: 2;
1629
+ /** The connection is closed. */
1630
+ readonly CLOSED: 3;
1631
+ onopen: ((event: WebSocket.Event) => void) | null;
1632
+ onerror: ((event: WebSocket.ErrorEvent) => void) | null;
1633
+ onclose: ((event: WebSocket.CloseEvent) => void) | null;
1634
+ onmessage: ((event: WebSocket.MessageEvent) => void) | null;
1635
+ constructor(address: null);
1636
+ constructor(address: string | url_URL, options?: WebSocket.ClientOptions | ClientRequestArgs);
1637
+ constructor(address: string | url_URL, protocols?: string | string[], options?: WebSocket.ClientOptions | ClientRequestArgs);
1638
+ close(code?: number, data?: string | Buffer): void;
1639
+ ping(data?: any, mask?: boolean, cb?: (err: Error) => void): void;
1640
+ pong(data?: any, mask?: boolean, cb?: (err: Error) => void): void;
1641
+ send(data: any, cb?: (err?: Error) => void): void;
1642
+ send(data: any, options: {
1643
+ mask?: boolean | undefined;
1644
+ binary?: boolean | undefined;
1645
+ compress?: boolean | undefined;
1646
+ fin?: boolean | undefined;
1647
+ }, cb?: (err?: Error) => void): void;
1648
+ terminate(): void;
1649
+ /**
1650
+ * Pause the websocket causing it to stop emitting events. Some events can still be
1651
+ * emitted after this is called, until all buffered data is consumed. This method
1652
+ * is a noop if the ready state is `CONNECTING` or `CLOSED`.
1653
+ */
1654
+ pause(): void;
1655
+ /**
1656
+ * Make a paused socket resume emitting events. This method is a noop if the ready
1657
+ * state is `CONNECTING` or `CLOSED`.
1658
+ */
1659
+ resume(): void;
1660
+ // HTML5 WebSocket events
1661
+ addEventListener(method: 'message', cb: (event: WebSocket.MessageEvent) => void, options?: WebSocket.EventListenerOptions): void;
1662
+ addEventListener(method: 'close', cb: (event: WebSocket.CloseEvent) => void, options?: WebSocket.EventListenerOptions): void;
1663
+ addEventListener(method: 'error', cb: (event: WebSocket.ErrorEvent) => void, options?: WebSocket.EventListenerOptions): void;
1664
+ addEventListener(method: 'open', cb: (event: WebSocket.Event) => void, options?: WebSocket.EventListenerOptions): void;
1665
+ removeEventListener(method: 'message', cb: (event: WebSocket.MessageEvent) => void): void;
1666
+ removeEventListener(method: 'close', cb: (event: WebSocket.CloseEvent) => void): void;
1667
+ removeEventListener(method: 'error', cb: (event: WebSocket.ErrorEvent) => void): void;
1668
+ removeEventListener(method: 'open', cb: (event: WebSocket.Event) => void): void;
1669
+ // Events
1670
+ on(event: 'close', listener: (this: WebSocket, code: number, reason: Buffer) => void): this;
1671
+ on(event: 'error', listener: (this: WebSocket, err: Error) => void): this;
1380
1672
  on(event: 'upgrade', listener: (this: WebSocket, request: http.IncomingMessage) => void): this;
1381
1673
  on(event: 'message', listener: (this: WebSocket, data: WebSocket.RawData, isBinary: boolean) => void): this;
1382
1674
  on(event: 'open', listener: (this: WebSocket) => void): this;
@@ -1620,58 +1912,6 @@ interface WebSocketClient extends NormalizedHotChannelClient {
1620
1912
  socket: WebSocket;
1621
1913
  }
1622
1914
  //#endregion
1623
- //#region src/node/server/bundledDev.d.ts
1624
- type MemoryFile = {
1625
- source: string | Uint8Array;
1626
- etag?: string;
1627
- };
1628
- declare class MemoryFiles {
1629
- private files;
1630
- get size(): number;
1631
- get(file: string): MemoryFile | undefined;
1632
- set(file: string, content: MemoryFile | (() => MemoryFile)): void;
1633
- has(file: string): boolean;
1634
- clear(): void;
1635
- }
1636
- declare class BundledDev {
1637
- private environment;
1638
- private _devEngine;
1639
- private viteRuntime?;
1640
- private initialBuildCompleted;
1641
- private _closed;
1642
- private clients;
1643
- private debouncedFullReload;
1644
- private fullReloadPending;
1645
- private reloadNeededClientIds;
1646
- private debouncedReloadNeededFlush;
1647
- private lastBuildError;
1648
- memoryFiles: MemoryFiles;
1649
- constructor(environment: DevEnvironment);
1650
- private get devEngine();
1651
- private pendingPayloadFilenames;
1652
- get hasBuildOutput(): boolean;
1653
- listen(): Promise<void>;
1654
- private waitForInitialBuildFinish;
1655
- private ensureOutputAndFlushReloadNeeded;
1656
- triggerBundleRegenerationIfStale(): Promise<boolean>;
1657
- triggerLazyBundling(moduleId: string | null, clientId: string | null): Promise<{
1658
- code: string;
1659
- filename: string;
1660
- } | undefined>;
1661
- /**
1662
- * Called by the serving middlewares when the response for a payload completed.
1663
- * Only delivered payloads are recorded on the server's per-client ship map, so
1664
- * later chunks may omit a module only if the payload carrying it was delivered.
1665
- *
1666
- * Note: the payload filename is unique across all clients.
1667
- */
1668
- markPayloadDelivered(filename: string): void;
1669
- close(): Promise<void>;
1670
- private storeOutputFiles;
1671
- private getRolldownOptions;
1672
- private handleHmrOutput;
1673
- }
1674
- //#endregion
1675
1915
  //#region src/node/server/environment.d.ts
1676
1916
  interface DevEnvironmentContext {
1677
1917
  hot: boolean;
@@ -1740,799 +1980,427 @@ export declare class DevEnvironment extends BaseEnvironment {
1740
1980
  waitForRequestsIdle(ignoredId?: string): Promise<void>;
1741
1981
  }
1742
1982
  //#endregion
1743
- //#region src/types/commonjs.d.ts
1744
-
1745
- interface RollupCommonJSOptions {
1983
+ //#region src/node/optimizer/scan.d.ts
1984
+ declare class ScanEnvironment extends BaseEnvironment {
1985
+ mode: "scan";
1986
+ get pluginContainer(): EnvironmentPluginContainer;
1987
+ init(): Promise<void>;
1988
+ }
1989
+ //#endregion
1990
+ //#region src/node/environment.d.ts
1991
+ type Environment = DevEnvironment | BuildEnvironment | ScanEnvironment | UnknownEnvironment;
1992
+ /**
1993
+ * Creates a function that hides the complexities of a WeakMap with an initial value
1994
+ * to implement object metadata. Used by plugins to implement cross hooks per
1995
+ * environment metadata
1996
+ *
1997
+ * @experimental
1998
+ */
1999
+ export declare function perEnvironmentState<State>(initial: (environment: Environment) => State): (context: PluginContext) => State;
2000
+ //#endregion
2001
+ //#region src/node/plugins/html.d.ts
2002
+ interface HtmlTagDescriptor {
2003
+ tag: string;
1746
2004
  /**
1747
- * A minimatch pattern, or array of patterns, which specifies the files in
1748
- * the build the plugin should operate on. By default, all files with
1749
- * extension `".cjs"` or those in `extensions` are included, but you can
1750
- * narrow this list by only including specific files. These files will be
1751
- * analyzed and transpiled if either the analysis does not find ES module
1752
- * specific statements or `transformMixedEsModules` is `true`.
1753
- * @default undefined
1754
- */
1755
- include?: string | RegExp | readonly (string | RegExp)[];
1756
- /**
1757
- * A minimatch pattern, or array of patterns, which specifies the files in
1758
- * the build the plugin should _ignore_. By default, all files with
1759
- * extensions other than those in `extensions` or `".cjs"` are ignored, but you
1760
- * can exclude additional files. See also the `include` option.
1761
- * @default undefined
1762
- */
1763
- exclude?: string | RegExp | readonly (string | RegExp)[];
1764
- /**
1765
- * For extensionless imports, search for extensions other than .js in the
1766
- * order specified. Note that you need to make sure that non-JavaScript files
1767
- * are transpiled by another plugin first.
1768
- * @default [ '.js' ]
2005
+ * attribute values will be escaped automatically if needed
1769
2006
  */
1770
- extensions?: ReadonlyArray<string>;
2007
+ attrs?: Record<string, string | boolean | undefined>;
2008
+ children?: string | HtmlTagDescriptor[];
1771
2009
  /**
1772
- * If true then uses of `global` won't be dealt with by this plugin
1773
- * @default false
2010
+ * default: 'head-prepend'
1774
2011
  */
1775
- ignoreGlobal?: boolean;
2012
+ injectTo?: "head" | "body" | "head-prepend" | "body-prepend";
2013
+ }
2014
+ type IndexHtmlTransformResult = string | HtmlTagDescriptor[] | {
2015
+ html: string;
2016
+ tags: HtmlTagDescriptor[];
2017
+ };
2018
+ interface IndexHtmlTransformContext {
1776
2019
  /**
1777
- * If false, skips source map generation for CommonJS modules. This will
1778
- * improve performance.
1779
- * @default true
2020
+ * public path when served
1780
2021
  */
1781
- sourceMap?: boolean;
2022
+ path: string;
1782
2023
  /**
1783
- * Some `require` calls cannot be resolved statically to be translated to
1784
- * imports.
1785
- * When this option is set to `false`, the generated code will either
1786
- * directly throw an error when such a call is encountered or, when
1787
- * `dynamicRequireTargets` is used, when such a call cannot be resolved with a
1788
- * configured dynamic require target.
1789
- * Setting this option to `true` will instead leave the `require` call in the
1790
- * code or use it as a fallback for `dynamicRequireTargets`.
1791
- * @default false
2024
+ * filename on disk
1792
2025
  */
1793
- ignoreDynamicRequires?: boolean;
2026
+ filename: string;
2027
+ server?: ViteDevServer;
2028
+ bundle?: OutputBundle;
2029
+ chunk?: OutputChunk;
2030
+ originalUrl?: string;
2031
+ }
2032
+ type IndexHtmlTransformHook = (this: MinimalPluginContextWithoutEnvironment, html: string, ctx: IndexHtmlTransformContext) => IndexHtmlTransformResult | void | Promise<IndexHtmlTransformResult | void>;
2033
+ type IndexHtmlTransform = IndexHtmlTransformHook | {
2034
+ order?: "pre" | "post" | null;
2035
+ handler: IndexHtmlTransformHook;
2036
+ };
2037
+ //#endregion
2038
+ //#region src/node/plugins/pluginFilter.d.ts
2039
+ type StringFilter<Value = string | RegExp> = Value | Array<Value> | {
2040
+ include?: Value | Array<Value>;
2041
+ exclude?: Value | Array<Value>;
2042
+ };
2043
+ //#endregion
2044
+ //#region src/node/shortcuts.d.ts
2045
+ type BindCLIShortcutsOptions<Server = ViteDevServer | PreviewServer> = {
1794
2046
  /**
1795
- * Instructs the plugin whether to enable mixed module transformations. This
1796
- * is useful in scenarios with modules that contain a mix of ES `import`
1797
- * statements and CommonJS `require` expressions. Set to `true` if `require`
1798
- * calls should be transformed to imports in mixed modules, or `false` if the
1799
- * `require` expressions should survive the transformation. The latter can be
1800
- * important if the code contains environment detection, or you are coding
1801
- * for an environment with special treatment for `require` calls such as
1802
- * ElectronJS. See also the `ignore` option.
1803
- * @default false
2047
+ * Print a one-line shortcuts "help" hint to the terminal
1804
2048
  */
1805
- transformMixedEsModules?: boolean;
2049
+ print?: boolean;
1806
2050
  /**
1807
- * By default, this plugin will try to hoist `require` statements as imports
1808
- * to the top of each file. While this works well for many code bases and
1809
- * allows for very efficient ESM output, it does not perfectly capture
1810
- * CommonJS semantics as the order of side effects like log statements may
1811
- * change. But it is especially problematic when there are circular `require`
1812
- * calls between CommonJS modules as those often rely on the lazy execution of
1813
- * nested `require` calls.
1814
- *
1815
- * Setting this option to `true` will wrap all CommonJS files in functions
1816
- * which are executed when they are required for the first time, preserving
1817
- * NodeJS semantics. Note that this can have an impact on the size and
1818
- * performance of the generated code.
1819
- *
1820
- * The default value of `"auto"` will only wrap CommonJS files when they are
1821
- * part of a CommonJS dependency cycle, e.g. an index file that is required by
1822
- * many of its dependencies. All other CommonJS files are hoisted. This is the
1823
- * recommended setting for most code bases.
1824
- *
1825
- * `false` will entirely prevent wrapping and hoist all files. This may still
1826
- * work depending on the nature of cyclic dependencies but will often cause
1827
- * problems.
1828
- *
1829
- * You can also provide a minimatch pattern, or array of patterns, to only
1830
- * specify a subset of files which should be wrapped in functions for proper
1831
- * `require` semantics.
1832
- *
1833
- * `"debug"` works like `"auto"` but after bundling, it will display a warning
1834
- * containing a list of ids that have been wrapped which can be used as
1835
- * minimatch pattern for fine-tuning.
1836
- * @default "auto"
2051
+ * Custom shortcuts to run when a key is pressed. These shortcuts take priority
2052
+ * over the default shortcuts if they have the same keys (except the `h` key).
2053
+ * To disable a default shortcut, define the same key but with `action: undefined`.
1837
2054
  */
1838
- strictRequires?: boolean | string | RegExp | readonly (string | RegExp)[];
2055
+ customShortcuts?: CLIShortcut<Server>[];
2056
+ };
2057
+ type CLIShortcut<Server = ViteDevServer | PreviewServer> = {
2058
+ key: string;
2059
+ description: string;
2060
+ action?(server: Server): void | Promise<void>;
2061
+ };
2062
+ //#endregion
2063
+ //#region src/node/typeUtils.d.ts
2064
+ type RequiredExceptFor<T, K extends keyof T> = Pick<T, K> & Required<Omit<T, K>>;
2065
+ //#endregion
2066
+ //#region src/node/preview.d.ts
2067
+ interface PreviewOptions extends CommonServerOptions {}
2068
+ interface ResolvedPreviewOptions extends RequiredExceptFor<PreviewOptions, "host" | "https" | "proxy"> {}
2069
+ interface PreviewServer {
1839
2070
  /**
1840
- * Sometimes you have to leave require statements unconverted. Pass an array
1841
- * containing the IDs or a `id => boolean` function.
1842
- * @default []
2071
+ * The resolved vite config object
1843
2072
  */
1844
- ignore?: ReadonlyArray<string> | ((id: string) => boolean);
2073
+ config: ResolvedConfig;
1845
2074
  /**
1846
- * In most cases, where `require` calls are inside a `try-catch` clause,
1847
- * they should be left unconverted as it requires an optional dependency
1848
- * that may or may not be installed beside the rolled up package.
1849
- * Due to the conversion of `require` to a static `import` - the call is
1850
- * hoisted to the top of the file, outside the `try-catch` clause.
1851
- *
1852
- * - `true`: Default. All `require` calls inside a `try` will be left unconverted.
1853
- * - `false`: All `require` calls inside a `try` will be converted as if the
1854
- * `try-catch` clause is not there.
1855
- * - `remove`: Remove all `require` calls from inside any `try` block.
1856
- * - `string[]`: Pass an array containing the IDs to left unconverted.
1857
- * - `((id: string) => boolean|'remove')`: Pass a function that controls
1858
- * individual IDs.
1859
- *
1860
- * @default true
2075
+ * Stop the server.
1861
2076
  */
1862
- ignoreTryCatch?: boolean | 'remove' | ReadonlyArray<string> | ((id: string) => boolean | 'remove');
2077
+ close(): Promise<void>;
1863
2078
  /**
1864
- * Controls how to render imports from external dependencies. By default,
1865
- * this plugin assumes that all external dependencies are CommonJS. This
1866
- * means they are rendered as default imports to be compatible with e.g.
1867
- * NodeJS where ES modules can only import a default export from a CommonJS
1868
- * dependency.
1869
- *
1870
- * If you set `esmExternals` to `true`, this plugin assumes that all
1871
- * external dependencies are ES modules and respect the
1872
- * `requireReturnsDefault` option. If that option is not set, they will be
1873
- * rendered as namespace imports.
2079
+ * A connect app instance.
2080
+ * - Can be used to attach custom middlewares to the preview server.
2081
+ * - Can also be used as the handler function of a custom http server
2082
+ * or as a middleware in any connect-style Node.js frameworks
1874
2083
  *
1875
- * You can also supply an array of ids to be treated as ES modules, or a
1876
- * function that will be passed each external id to determine whether it is
1877
- * an ES module.
1878
- * @default false
2084
+ * https://github.com/senchalabs/connect#use-middleware
1879
2085
  */
1880
- esmExternals?: boolean | ReadonlyArray<string> | ((id: string) => boolean);
2086
+ middlewares: Connect.Server;
1881
2087
  /**
1882
- * Controls what is returned when requiring an ES module from a CommonJS file.
1883
- * When using the `esmExternals` option, this will also apply to external
1884
- * modules. By default, this plugin will render those imports as namespace
1885
- * imports i.e.
1886
- *
1887
- * ```js
1888
- * // input
1889
- * const foo = require('foo');
1890
- *
1891
- * // output
1892
- * import * as foo from 'foo';
1893
- * ```
1894
- *
1895
- * However, there are some situations where this may not be desired.
1896
- * For these situations, you can change Rollup's behaviour either globally or
1897
- * per module. To change it globally, set the `requireReturnsDefault` option
1898
- * to one of the following values:
1899
- *
1900
- * - `false`: This is the default, requiring an ES module returns its
1901
- * namespace. This is the only option that will also add a marker
1902
- * `__esModule: true` to the namespace to support interop patterns in
1903
- * CommonJS modules that are transpiled ES modules.
1904
- * - `"namespace"`: Like `false`, requiring an ES module returns its
1905
- * namespace, but the plugin does not add the `__esModule` marker and thus
1906
- * creates more efficient code. For external dependencies when using
1907
- * `esmExternals: true`, no additional interop code is generated.
1908
- * - `"auto"`: This is complementary to how `output.exports: "auto"` works in
1909
- * Rollup: If a module has a default export and no named exports, requiring
1910
- * that module returns the default export. In all other cases, the namespace
1911
- * is returned. For external dependencies when using `esmExternals: true`, a
1912
- * corresponding interop helper is added.
1913
- * - `"preferred"`: If a module has a default export, requiring that module
1914
- * always returns the default export, no matter whether additional named
1915
- * exports exist. This is similar to how previous versions of this plugin
1916
- * worked. Again for external dependencies when using `esmExternals: true`,
1917
- * an interop helper is added.
1918
- * - `true`: This will always try to return the default export on require
1919
- * without checking if it actually exists. This can throw at build time if
1920
- * there is no default export. This is how external dependencies are handled
1921
- * when `esmExternals` is not used. The advantage over the other options is
1922
- * that, like `false`, this does not add an interop helper for external
1923
- * dependencies, keeping the code lean.
1924
- *
1925
- * To change this for individual modules, you can supply a function for
1926
- * `requireReturnsDefault` instead. This function will then be called once for
1927
- * each required ES module or external dependency with the corresponding id
1928
- * and allows you to return different values for different modules.
1929
- * @default false
2088
+ * native Node http server instance
1930
2089
  */
1931
- requireReturnsDefault?: boolean | 'auto' | 'preferred' | 'namespace' | ((id: string) => boolean | 'auto' | 'preferred' | 'namespace');
2090
+ httpServer: HttpServer;
1932
2091
  /**
1933
- * @default "auto"
2092
+ * The resolved urls Vite prints on the CLI (URL-encoded). Returns `null`
2093
+ * if the server is not listening on any port.
1934
2094
  */
1935
- defaultIsModuleExports?: boolean | 'auto' | ((id: string) => boolean | 'auto');
2095
+ resolvedUrls: ResolvedServerUrls | null;
1936
2096
  /**
1937
- * Some modules contain dynamic `require` calls, or require modules that
1938
- * contain circular dependencies, which are not handled well by static
1939
- * imports. Including those modules as `dynamicRequireTargets` will simulate a
1940
- * CommonJS (NodeJS-like) environment for them with support for dynamic
1941
- * dependencies. It also enables `strictRequires` for those modules.
1942
- *
1943
- * Note: In extreme cases, this feature may result in some paths being
1944
- * rendered as absolute in the final bundle. The plugin tries to avoid
1945
- * exposing paths from the local machine, but if you are `dynamicRequirePaths`
1946
- * with paths that are far away from your project's folder, that may require
1947
- * replacing strings like `"/Users/John/Desktop/foo-project/"` -\> `"/"`.
2097
+ * Print server urls
1948
2098
  */
1949
- dynamicRequireTargets?: string | ReadonlyArray<string>;
2099
+ printUrls(): void;
1950
2100
  /**
1951
- * To avoid long paths when using the `dynamicRequireTargets` option, you can use this option to specify a directory
1952
- * that is a common parent for all files that use dynamic require statements. Using a directory higher up such as `/`
1953
- * may lead to unnecessarily long paths in the generated code and may expose directory names on your machine like your
1954
- * home directory name. By default, it uses the current working directory.
2101
+ * Bind CLI shortcuts
1955
2102
  */
1956
- dynamicRequireRoot?: string;
2103
+ bindCLIShortcuts(options?: BindCLIShortcutsOptions<PreviewServer>): void;
1957
2104
  }
1958
- //#endregion
1959
- //#region src/types/dynamicImportVars.d.ts
1960
- interface RollupDynamicImportVarsOptions {
1961
- /**
1962
- * Files to include in this plugin (default all).
1963
- * @default []
1964
- */
1965
- include?: string | RegExp | (string | RegExp)[];
1966
- /**
1967
- * Files to exclude in this plugin (default none).
1968
- * @default []
1969
- */
1970
- exclude?: string | RegExp | (string | RegExp)[];
2105
+ type PreviewServerHook = (this: MinimalPluginContextWithoutEnvironment, server: PreviewServer) => (() => void) | void | Promise<(() => void) | void>;
2106
+ type ClosePreviewServerHook = (this: MinimalPluginContextWithoutEnvironment) => void | Promise<void>;
2107
+ /**
2108
+ * Starts the Vite server in preview mode, to simulate a production deployment
2109
+ */
2110
+ export declare function preview(inlineConfig?: InlineConfig): Promise<PreviewServer>;
2111
+ //#endregion
2112
+ //#region src/node/plugin.d.ts
2113
+ /**
2114
+ * Vite plugins extends the Rollup plugin interface with a few extra
2115
+ * vite-specific options. A valid vite plugin is also a valid Rollup plugin.
2116
+ * On the contrary, a Rollup plugin may or may NOT be a valid vite universal
2117
+ * plugin, since some Rollup features do not make sense in an unbundled
2118
+ * dev server context. That said, as long as a rollup plugin doesn't have strong
2119
+ * coupling between its bundle phase and output phase hooks then it should
2120
+ * just work (that means, most of them).
2121
+ *
2122
+ * By default, the plugins are run during both serve and build. When a plugin
2123
+ * is applied during serve, it will only run **non output plugin hooks** (see
2124
+ * rollup type definition of {@link rollup#PluginHooks}). You can think of the
2125
+ * dev server as only running `const bundle = rollup.rollup()` but never calling
2126
+ * `bundle.generate()`.
2127
+ *
2128
+ * A plugin that expects to have different behavior depending on serve/build can
2129
+ * export a factory function that receives the command being run via options.
2130
+ *
2131
+ * If a plugin should be applied only for server or build, a function format
2132
+ * config file can be used to conditional determine the plugins to use.
2133
+ *
2134
+ * The current environment can be accessed from the context for the all non-global
2135
+ * hooks (it is not available in config, configResolved, configureServer, etc).
2136
+ * It can be a dev, build, or scan environment.
2137
+ * Plugins can use this.environment.mode === 'dev' to guard for dev specific APIs.
2138
+ */
2139
+ interface PluginContextExtension {
1971
2140
  /**
1972
- * @deprecated This option is no-op and will be removed in future versions.
2141
+ * Vite-specific environment instance
1973
2142
  */
1974
- warnOnError?: boolean;
2143
+ environment: Environment;
1975
2144
  }
1976
- //#endregion
1977
- //#region src/node/plugins/terser.d.ts
1978
- interface TerserOptions extends TerserMinifyOptions {
2145
+ interface PluginContextMetaExtension {
2146
+ viteVersion: string;
2147
+ }
2148
+ interface ConfigPluginContext extends Omit<MinimalPluginContext, "meta" | "environment"> {
2149
+ meta: Omit<PluginContextMeta, "watchMode">;
2150
+ }
2151
+ interface MinimalPluginContextWithoutEnvironment extends Omit<MinimalPluginContext, "environment"> {}
2152
+ declare module "rolldown" {
2153
+ interface MinimalPluginContext extends PluginContextExtension {}
2154
+ interface PluginContextMeta extends PluginContextMetaExtension {}
2155
+ }
2156
+ /**
2157
+ * There are two types of plugins in Vite. App plugins and environment plugins.
2158
+ * Environment Plugins are defined by a constructor function that will be called
2159
+ * once per each environment allowing users to have completely different plugins
2160
+ * for each of them. The constructor gets the resolved environment after the server
2161
+ * and builder has already been created simplifying config access and cache
2162
+ * management for environment specific plugins.
2163
+ * Environment Plugins are closer to regular rollup plugins. They can't define
2164
+ * app level hooks (like config, configResolved, configureServer, etc).
2165
+ */
2166
+ interface Plugin<A = any> extends Rolldown.Plugin<A> {
1979
2167
  /**
1980
- * Vite-specific option to specify the max number of workers to spawn
1981
- * when minifying files with terser.
2168
+ * Perform custom handling of HMR updates.
2169
+ * The handler receives an options containing changed filename, timestamp, a
2170
+ * list of modules affected by the file change, and the dev server instance.
1982
2171
  *
1983
- * @default number of CPUs minus 1
2172
+ * - The hook can return a filtered list of modules to narrow down the update.
2173
+ * e.g. for a Vue SFC, we can narrow down the part to update by comparing
2174
+ * the descriptors.
2175
+ *
2176
+ * - The hook can also return an empty array and then perform custom updates
2177
+ * by sending a custom hmr payload via environment.hot.send().
2178
+ *
2179
+ * - If the hook doesn't return a value, the hmr update will be performed as
2180
+ * normal.
1984
2181
  */
1985
- maxWorkers?: number;
1986
- }
1987
- //#endregion
1988
- //#region src/node/plugins/resolve.d.ts
1989
- interface EnvironmentResolveOptions {
2182
+ hotUpdate?: ObjectHook<(this: MinimalPluginContext & {
2183
+ environment: DevEnvironment;
2184
+ }, options: HotUpdateOptions) => Array<EnvironmentModuleNode> | void | Promise<Array<EnvironmentModuleNode> | void>>;
1990
2185
  /**
1991
- * @default ['browser', 'module', 'jsnext:main', 'jsnext']
2186
+ * extend hooks with ssr flag
1992
2187
  */
1993
- mainFields?: string[];
1994
- conditions?: string[];
1995
- externalConditions?: string[];
2188
+ resolveId?: ObjectHook<(this: PluginContext, source: string, importer: string | undefined, options: {
2189
+ kind?: ImportKind;
2190
+ custom?: CustomPluginOptions;
2191
+ ssr?: boolean | undefined;
2192
+
2193
+ isEntry: boolean;
2194
+ }) => Promise<ResolveIdResult> | ResolveIdResult, {
2195
+ filter?: {
2196
+ id?: StringFilter<RegExp>;
2197
+ };
2198
+ }>;
2199
+ load?: ObjectHook<(this: PluginContext, id: string, options?: {
2200
+ ssr?: boolean | undefined;
2201
+ }) => Promise<LoadResult> | LoadResult, {
2202
+ filter?: {
2203
+ id?: StringFilter;
2204
+ };
2205
+ }>;
2206
+ transform?: ObjectHook<(this: TransformPluginContext, code: string, id: string, options?: {
2207
+ moduleType: ModuleType;
2208
+ ssr?: boolean | undefined;
2209
+ }) => Promise<Rolldown.TransformResult> | Rolldown.TransformResult, {
2210
+ filter?: {
2211
+ id?: StringFilter;
2212
+ code?: StringFilter;
2213
+ moduleType?: ModuleTypeFilter;
2214
+ };
2215
+ }>;
1996
2216
  /**
1997
- * @default ['.mjs', '.js', '.mts', '.ts', '.jsx', '.tsx', '.json']
2217
+ * Opt-in this plugin into the shared plugins pipeline.
2218
+ * For backward-compatibility, plugins are re-recreated for each environment
2219
+ * during `vite build --app`
2220
+ * We have an opt-in per plugin, and a general `builder.sharedPlugins`
2221
+ * In a future major, we'll flip the default to be shared by default
2222
+ * @experimental
1998
2223
  */
1999
- extensions?: string[];
2000
- dedupe?: string[];
2224
+ sharedDuringBuild?: boolean;
2001
2225
  /**
2002
- * Prevent listed dependencies from being externalized and will get bundled in build.
2003
- * Only works in server environments for now. Previously this was `ssr.noExternal`.
2226
+ * Opt-in this plugin into per-environment buildStart and buildEnd during dev.
2227
+ * For backward-compatibility, the buildStart hook is called only once during
2228
+ * dev, for the client environment. Plugins can opt-in to be called
2229
+ * per-environment, aligning with the build hook behavior.
2004
2230
  * @experimental
2005
2231
  */
2006
- noExternal?: string | RegExp | (string | RegExp)[] | true;
2232
+ perEnvironmentStartEndDuringDev?: boolean;
2007
2233
  /**
2008
- * Externalize the given dependencies and their transitive dependencies.
2009
- * Only works in server environments for now. Previously this was `ssr.external`.
2234
+ * Opt-in this plugin into per-environment watchChange during dev.
2235
+ * For backward-compatibility, the watchChange hook is called only once during
2236
+ * dev, for the client environment. Plugins can opt-in to be called
2237
+ * per-environment, aligning with the watchChange hook behavior.
2010
2238
  * @experimental
2011
2239
  */
2012
- external?: string[] | true;
2240
+ perEnvironmentWatchChangeDuringDev?: boolean;
2013
2241
  /**
2014
- * Array of strings or regular expressions that indicate what modules are builtin for the environment.
2242
+ * Enforce plugin invocation tier similar to webpack loaders. Hooks ordering
2243
+ * is still subject to the `order` property in the hook object.
2244
+ *
2245
+ * Plugin invocation order:
2246
+ * - alias resolution
2247
+ * - `enforce: 'pre'` plugins
2248
+ * - vite core plugins
2249
+ * - normal plugins
2250
+ * - vite build plugins
2251
+ * - `enforce: 'post'` plugins
2252
+ * - vite build post plugins
2015
2253
  */
2016
- builtins?: (string | RegExp)[];
2017
- }
2018
- interface ResolveOptions extends EnvironmentResolveOptions {
2254
+ enforce?: "pre" | "post";
2019
2255
  /**
2020
- * @default false
2256
+ * Apply the plugin only for serve or build, or on certain conditions.
2021
2257
  */
2022
- preserveSymlinks?: boolean;
2258
+ apply?: "serve" | "build" | ((this: void, config: UserConfig, env: ConfigEnv) => boolean);
2023
2259
  /**
2024
- * Enable tsconfig paths resolution
2025
- *
2026
- * @default false
2260
+ * Define environments where this plugin should be active
2261
+ * By default, the plugin is active in all environments
2262
+ * @experimental
2027
2263
  */
2028
- tsconfigPaths?: boolean;
2029
- }
2030
- interface ResolvePluginOptions {
2031
- root: string;
2032
- isBuild: boolean;
2033
- isProduction: boolean;
2034
- packageCache?: PackageCache;
2264
+ applyToEnvironment?: (environment: PartialEnvironment) => boolean | Promise<boolean> | PluginOption;
2035
2265
  /**
2036
- * src code mode also attempts the following:
2037
- * - resolving /xxx as URLs
2038
- * - resolving bare imports from optimized deps
2266
+ * Modify vite config before it's resolved. The hook can either mutate the
2267
+ * passed-in config directly, or return a partial config object that will be
2268
+ * deeply merged into existing config.
2269
+ *
2270
+ * Note: User plugins are resolved before running this hook so injecting other
2271
+ * plugins inside the `config` hook will have no effect.
2039
2272
  */
2040
- asSrc?: boolean;
2041
- tryIndex?: boolean;
2042
- tryPrefix?: string;
2043
- preferRelative?: boolean;
2044
- isRequire?: boolean;
2045
- scan?: boolean;
2273
+ config?: ObjectHook<(this: ConfigPluginContext, config: UserConfig, env: ConfigEnv) => Omit<UserConfig, "plugins"> | null | void | Promise<Omit<UserConfig, "plugins"> | null | void>>;
2046
2274
  /**
2047
- * Enable when `legacy.inconsistentCjsInterop` is true. See that option for more details.
2275
+ * Modify environment configs before it's resolved. The hook can either mutate the
2276
+ * passed-in environment config directly, or return a partial config object that will be
2277
+ * deeply merged into existing config.
2278
+ * This hook is called for each environment with a partially resolved environment config
2279
+ * that already accounts for the default environment config values set at the root level.
2280
+ * If plugins need to modify the config of a given environment, they should do it in this
2281
+ * hook instead of the config hook. Leaving the config hook only for modifying the root
2282
+ * default environment config.
2048
2283
  */
2049
- legacyInconsistentCjsInterop?: boolean;
2050
- }
2051
- interface InternalResolveOptions extends Required<ResolveOptions>, ResolvePluginOptions {}
2052
- //#endregion
2053
- //#region src/node/packages.d.ts
2054
- /** Cache for package.json resolution and package.json contents */
2055
- type PackageCache = Map<string, PackageData>;
2056
- interface PackageData {
2057
- dir: string;
2058
- hasSideEffects: (id: string) => boolean | "no-treeshake" | null;
2059
- setResolvedCache: (key: string, entry: string, options: InternalResolveOptions) => void;
2060
- getResolvedCache: (key: string, options: InternalResolveOptions) => string | undefined;
2061
- data: {
2062
- [field: string]: any;
2063
- name: string;
2064
- type: string;
2065
- version: string;
2066
- main: string;
2067
- module: string;
2068
- browser: string | Record<string, string | false>;
2069
- exports: string | Record<string, any> | string[];
2070
- imports: Record<string, any>;
2071
- dependencies: Record<string, string>;
2072
- };
2073
- }
2074
- //#endregion
2075
- //#region src/node/plugins/license.d.ts
2076
- interface LicenseOptions {
2284
+ configEnvironment?: ObjectHook<(this: ConfigPluginContext, name: string, config: EnvironmentOptions, env: ConfigEnv & {
2285
+ /**
2286
+ * Whether this environment is SSR environment and `ssr.target` is set to `'webworker'`.
2287
+ * Only intended to be used for backward compatibility.
2288
+ */
2289
+ isSsrTargetWebworker?: boolean;
2290
+ }) => EnvironmentOptions | null | void | Promise<EnvironmentOptions | null | void>>;
2077
2291
  /**
2078
- * The output file name of the license file relative to the output directory.
2079
- * Specify a path that ends with `.json` to output the raw JSON metadata.
2080
- *
2081
- * @default '.vite/license.md'
2292
+ * Use this hook to read and store the final resolved vite config.
2082
2293
  */
2083
- fileName: string;
2084
- }
2085
- //#endregion
2086
- //#region src/node/build.d.ts
2087
- interface BuildEnvironmentOptions {
2294
+ configResolved?: ObjectHook<(this: MinimalPluginContextWithoutEnvironment, config: ResolvedConfig) => void | Promise<void>>;
2088
2295
  /**
2089
- * Compatibility transform target. The transform is performed with esbuild
2090
- * and the lowest supported target is es2015. Note this only handles
2091
- * syntax transformation and does not cover polyfills
2092
- *
2093
- * Default: 'baseline-widely-available' - transpile targeting browsers that
2094
- * are included in the Baseline Widely Available on 2026-01-01.
2095
- * (Chrome 111+, Edge 111+, Firefox 114+, Safari 16.4+).
2096
- *
2097
- * Another special value is 'esnext' - which only performs minimal transpiling
2098
- * (for minification compat).
2296
+ * Configure the vite server. The hook receives the {@link ViteDevServer}
2297
+ * instance. This can also be used to store a reference to the server
2298
+ * for use in other hooks.
2099
2299
  *
2100
- * For custom targets, see https://esbuild.github.io/api/#target and
2101
- * https://esbuild.github.io/content-types/#javascript for more details.
2102
- * @default 'baseline-widely-available'
2103
- */
2104
- target?: "baseline-widely-available" | EsbuildTarget | false;
2105
- /**
2106
- * whether to inject module preload polyfill.
2107
- * Note: does not apply to library mode.
2108
- * @default true
2109
- * @deprecated use `modulePreload.polyfill` instead
2110
- */
2111
- polyfillModulePreload?: boolean;
2112
- /**
2113
- * Configure module preload
2114
- * Note: does not apply to library mode.
2115
- * @default true
2116
- */
2117
- modulePreload?: boolean | ModulePreloadOptions;
2118
- /**
2119
- * Directory relative from `root` where build output will be placed. If the
2120
- * directory exists, it will be removed before the build.
2121
- * @default 'dist'
2122
- */
2123
- outDir?: string;
2124
- /**
2125
- * Directory relative from `outDir` where the built js/css/image assets will
2126
- * be placed.
2127
- * @default 'assets'
2300
+ * The hooks will be called before internal middlewares are applied. A hook
2301
+ * can return a post hook that will be called after internal middlewares
2302
+ * are applied. Hook can be async functions and will be called in series.
2128
2303
  */
2129
- assetsDir?: string;
2304
+ configureServer?: ObjectHook<ServerHook>;
2130
2305
  /**
2131
- * Static asset files smaller than this number (in bytes) will be inlined as
2132
- * base64 strings. If a callback is passed, a boolean can be returned to opt-in
2133
- * or opt-out of inlining. If nothing is returned the default logic applies.
2306
+ * Configure the preview server. The hook receives the {@link PreviewServer}
2307
+ * instance. This can also be used to store a reference to the server
2308
+ * for use in other hooks.
2134
2309
  *
2135
- * Default limit is `4096` (4 KiB). Set to `0` to disable.
2136
- * @default 4096
2137
- */
2138
- assetsInlineLimit?: number | ((filePath: string, content: Buffer) => boolean | undefined);
2139
- /**
2140
- * Whether to code-split CSS. When enabled, CSS in async chunks will be
2141
- * inlined as strings in the chunk and inserted via dynamically created
2142
- * style tags when the chunk is loaded.
2143
- * @default true
2144
- */
2145
- cssCodeSplit?: boolean;
2146
- /**
2147
- * An optional separate target for CSS minification.
2148
- * As esbuild only supports configuring targets to mainstream
2149
- * browsers, users may need this option when they are targeting
2150
- * a niche browser that comes with most modern JavaScript features
2151
- * but has poor CSS support, e.g. Android WeChat WebView, which
2152
- * doesn't support the #RGBA syntax.
2153
- * When `build.cssMinify` is `lightningcss` (the default), this
2154
- * option takes precedence over `css.lightningcss.targets` for the
2155
- * minification step.
2156
- * @default target
2157
- */
2158
- cssTarget?: EsbuildTarget | false;
2159
- /**
2160
- * Override CSS minification specifically instead of defaulting to `build.minify`,
2161
- * so you can configure minification for JS and CSS separately.
2162
- * @default 'lightningcss', but false if build.minify is disabled for client build
2163
- */
2164
- cssMinify?: boolean | "lightningcss" | "esbuild";
2165
- /**
2166
- * If `true`, a separate sourcemap file will be created. If 'inline', the
2167
- * sourcemap will be appended to the resulting output file as data URI.
2168
- * 'hidden' works like `true` except that the corresponding sourcemap
2169
- * comments in the bundled files are suppressed.
2170
- * @default false
2171
- */
2172
- sourcemap?: boolean | "inline" | "hidden";
2173
- /**
2174
- * Set to `false` to disable minification, or specify the minifier to use.
2175
- * Available options are 'oxc' or 'terser' or 'esbuild'.
2176
- * @default 'oxc' for client build, false for SSR build
2310
+ * The hooks are called before other middlewares are applied. A hook can
2311
+ * return a post hook that will be called after other middlewares are
2312
+ * applied. Hooks can be async functions and will be called in series.
2177
2313
  */
2178
- minify?: boolean | "oxc" | "terser" | "esbuild";
2314
+ configurePreviewServer?: ObjectHook<PreviewServerHook>;
2179
2315
  /**
2180
- * Options for terser
2181
- * https://terser.org/docs/api-reference#minify-options
2316
+ * Run logic when the server is restarted or closed. The hook receives a
2317
+ * `reason` that is `'restart'` when the server is restarting and `'close'`
2318
+ * when it is closing.
2182
2319
  *
2183
- * In addition, you can also pass a `maxWorkers: number` option to specify the
2184
- * max number of workers to spawn. Defaults to the number of CPUs minus 1.
2320
+ * The hooks are called after the server is torn down. Hooks can be async
2321
+ * functions and will be called in parallel.
2185
2322
  */
2186
- terserOptions?: TerserOptions;
2323
+ closeServer?: ObjectHook<CloseServerHook>;
2187
2324
  /**
2188
- * Whether to use import maps feature to optimize chunk caching efficiency.
2189
- * @default false
2190
- * @experimental
2325
+ * Same as `closeServer` but for the preview server. The preview server never
2326
+ * restarts, so no `reason` is provided.
2191
2327
  */
2192
- chunkImportMap?: boolean;
2328
+ closePreviewServer?: ObjectHook<ClosePreviewServerHook>;
2193
2329
  /**
2194
- * Alias to `rolldownOptions`
2195
- * @deprecated Use `rolldownOptions` instead.
2196
- */
2197
- rollupOptions?: RolldownOptions;
2198
- /**
2199
- * Will be merged with internal rolldown options.
2200
- * https://rolldown.rs/reference/Interface.RolldownOptions
2201
- */
2202
- rolldownOptions?: RolldownOptions;
2203
- /**
2204
- * Options to pass on to `@rollup/plugin-commonjs`
2205
- * @deprecated This option is no-op and will be removed in future versions.
2206
- */
2207
- commonjsOptions?: RollupCommonJSOptions;
2208
- /**
2209
- * Options to pass on to `@rollup/plugin-dynamic-import-vars`
2210
- */
2211
- dynamicImportVarsOptions?: RollupDynamicImportVarsOptions;
2212
- /**
2213
- * Whether to write bundle to disk
2214
- * @default true
2215
- */
2216
- write?: boolean;
2217
- /**
2218
- * Empty outDir on write.
2219
- * @default true when outDir is a sub directory of project root
2220
- */
2221
- emptyOutDir?: boolean | null;
2222
- /**
2223
- * Copy the public directory to outDir on write.
2224
- * @default true
2225
- */
2226
- copyPublicDir?: boolean;
2227
- /**
2228
- * Whether to emit a `.vite/license.md` file that includes all bundled dependencies'
2229
- * licenses. Pass an object to customize the output file name.
2230
- * @default false
2231
- */
2232
- license?: boolean | LicenseOptions;
2233
- /**
2234
- * Whether to emit a .vite/manifest.json in the output dir to map hash-less filenames
2235
- * to their hashed versions. Useful when you want to generate your own HTML
2236
- * instead of using the one generated by Vite.
2330
+ * Transform index.html.
2331
+ * The hook receives the following arguments:
2237
2332
  *
2238
- * Example:
2333
+ * - html: string
2334
+ * - ctx: IndexHtmlTransformContext, which contains:
2335
+ * - path: public path when served
2336
+ * - filename: filename on disk
2337
+ * - server?: ViteDevServer (only present during serve)
2338
+ * - bundle?: rollup.OutputBundle (only present during build)
2339
+ * - chunk?: rollup.OutputChunk
2340
+ * - originalUrl?: string
2239
2341
  *
2240
- * ```json
2241
- * {
2242
- * "main.js": {
2243
- * "file": "main.68fe3fad.js",
2244
- * "css": "main.e6b63442.css",
2245
- * "imports": [...],
2246
- * "dynamicImports": [...]
2247
- * }
2248
- * }
2249
- * ```
2250
- * @default false
2251
- */
2252
- manifest?: boolean | string;
2253
- /**
2254
- * Build in library mode. The value should be the global name of the lib in
2255
- * UMD mode. This will produce esm + cjs + umd bundle formats with default
2256
- * configurations that are suitable for distributing libraries.
2257
- * @default false
2258
- */
2259
- lib?: LibraryOptions | false;
2260
- /**
2261
- * Produce SSR oriented build. Note this requires specifying SSR entry via
2262
- * `rolldownOptions.input`.
2263
- * @default false
2264
- */
2265
- ssr?: boolean | string;
2266
- /**
2267
- * Generate SSR manifest for determining style links and asset preload
2268
- * directives in production.
2269
- * @default false
2270
- */
2271
- ssrManifest?: boolean | string;
2272
- /**
2273
- * Emit assets during SSR.
2274
- * @default false
2275
- */
2276
- ssrEmitAssets?: boolean;
2277
- /**
2278
- * Emit assets during build. Frameworks can set environments.ssr.build.emitAssets
2279
- * By default, it is true for the client and false for other environments.
2280
- */
2281
- emitAssets?: boolean;
2282
- /**
2283
- * Set to false to disable reporting compressed chunk sizes.
2284
- * Can slightly improve build speed.
2285
- * @default true
2286
- */
2287
- reportCompressedSize?: boolean;
2288
- /**
2289
- * Adjust chunk size warning limit (in kB).
2290
- * @default 500
2291
- */
2292
- chunkSizeWarningLimit?: number;
2293
- /**
2294
- * Rollup watch options
2295
- * https://rollupjs.org/configuration-options/#watch
2296
- * @default null
2297
- */
2298
- watch?: WatcherOptions | null;
2299
- /**
2300
- * create the Build Environment instance
2301
- */
2302
- createEnvironment?: (name: string, config: ResolvedConfig) => Promise<BuildEnvironment> | BuildEnvironment;
2303
- }
2304
- type BuildOptions = BuildEnvironmentOptions;
2305
- interface LibraryOptions {
2306
- /**
2307
- * Path of library entry.
2308
- * Defaults to the top-level `input` option when omitted.
2309
- */
2310
- entry?: InputOption;
2311
- /**
2312
- * The name of the exposed global variable. Required when the `formats` option includes
2313
- * `umd` or `iife`
2314
- */
2315
- name?: string;
2316
- /**
2317
- * Output bundle formats. Defaults to `['es', 'umd']` for a single entry, or
2318
- * `['es', 'cjs']` for multiple entries (`umd` and `iife` do not support
2319
- * multiple entries).
2320
- * @default ['es', 'umd']
2321
- */
2322
- formats?: LibraryFormats[];
2323
- /**
2324
- * The name of the package file output. The default file name is the name option
2325
- * of the project package.json. It can also be defined as a function taking the
2326
- * format as an argument.
2327
- */
2328
- fileName?: string | ((format: ModuleFormat, entryName: string) => string);
2329
- /**
2330
- * The name of the CSS file output if the library imports CSS. Defaults to the
2331
- * same value as `build.lib.fileName` if it's set a string, otherwise it falls
2332
- * back to the name option of the project package.json.
2333
- */
2334
- cssFileName?: string;
2335
- }
2336
- type LibraryFormats = "es" | "cjs" | "umd" | "iife";
2337
- interface ModulePreloadOptions {
2338
- /**
2339
- * Whether to inject a module preload polyfill.
2340
- * Note: does not apply to library mode.
2341
- * @default true
2342
+ * It can either return a transformed string, or a list of html tag
2343
+ * descriptors that will be injected into the `<head>` or `<body>`.
2344
+ *
2345
+ * By default the transform is applied **after** vite's internal html
2346
+ * transform. If you need to apply the transform before vite, use an object:
2347
+ * `{ order: 'pre', handler: hook }`
2342
2348
  */
2343
- polyfill?: boolean;
2349
+ transformIndexHtml?: IndexHtmlTransform;
2344
2350
  /**
2345
- * Resolve the list of dependencies to preload for a given dynamic import
2351
+ * Build Environments
2352
+ *
2346
2353
  * @experimental
2347
2354
  */
2348
- resolveDependencies?: ResolveModulePreloadDependenciesFn;
2349
- }
2350
- interface ResolvedModulePreloadOptions {
2351
- polyfill: boolean;
2352
- resolveDependencies?: ResolveModulePreloadDependenciesFn;
2353
- }
2354
- type ResolveModulePreloadDependenciesFn = (filename: string, deps: string[], context: {
2355
- hostId: string;
2356
- hostType: "html" | "js";
2357
- }) => string[];
2358
- interface ResolvedBuildEnvironmentOptions extends Required<Omit<BuildEnvironmentOptions, "polyfillModulePreload">> {
2359
- modulePreload: false | ResolvedModulePreloadOptions;
2360
- }
2361
- interface ResolvedBuildOptions extends Required<Omit<BuildOptions, "polyfillModulePreload">> {
2362
- modulePreload: false | ResolvedModulePreloadOptions;
2363
- }
2364
- /**
2365
- * Bundles a single environment for production.
2366
- * Returns a Promise containing the build result.
2367
- */
2368
- export declare function build(inlineConfig?: InlineConfig): Promise<RolldownOutput | RolldownOutput[] | RolldownWatcher>;
2369
- type RenderBuiltAssetUrl = (filename: string, type: {
2370
- type: "asset" | "public";
2371
- hostId: string;
2372
- hostType: "js" | "css" | "html";
2373
- ssr: boolean;
2374
- }) => string | {
2375
- relative?: boolean;
2376
- runtime?: string;
2377
- } | undefined;
2378
- export declare class BuildEnvironment extends BaseEnvironment {
2379
- mode: "build";
2380
- isBuilt: boolean;
2381
- constructor(name: string, config: ResolvedConfig, setup?: {
2382
- options?: EnvironmentOptions;
2383
- });
2384
- init(): Promise<void>;
2385
- }
2386
- interface ViteBuilder {
2387
- environments: Record<string, BuildEnvironment>;
2388
- config: ResolvedConfig;
2389
- buildApp(): Promise<void>;
2390
- build(environment: BuildEnvironment): Promise<RolldownOutput | RolldownOutput[] | RolldownWatcher>;
2391
- runDevTools(): Promise<void>;
2392
- }
2393
- interface BuilderOptions {
2355
+ buildApp?: ObjectHook<BuildAppHook>;
2394
2356
  /**
2395
- * Whether to share the config instance among environments to align with the behavior of dev server.
2357
+ * Perform custom handling of HMR updates.
2358
+ * The handler receives a context containing changed filename, timestamp, a
2359
+ * list of modules affected by the file change, and the dev server instance.
2396
2360
  *
2397
- * @default false
2398
- * @experimental
2361
+ * - The hook can return a filtered list of modules to narrow down the update.
2362
+ * e.g. for a Vue SFC, we can narrow down the part to update by comparing
2363
+ * the descriptors.
2364
+ *
2365
+ * - The hook can also return an empty array and then perform custom updates
2366
+ * by sending a custom hmr payload via server.ws.send().
2367
+ *
2368
+ * - If the hook doesn't return a value, the hmr update will be performed as
2369
+ * normal.
2399
2370
  */
2400
- sharedConfigBuild?: boolean;
2371
+ handleHotUpdate?: ObjectHook<(this: MinimalPluginContextWithoutEnvironment, ctx: HmrContext) => Array<ModuleNode> | void | Promise<Array<ModuleNode> | void>>;
2401
2372
  /**
2402
- * Whether to share the plugin instances among environments to align with the behavior of dev server.
2373
+ * This hook is not supported by Rolldown yet. But the type is declared for compatibility.
2403
2374
  *
2404
- * @default false
2405
- * @experimental
2375
+ * @deprecated This hook is **not** deprecated. It is marked as deprecated just to make it clear that this hook is currently a no-op.
2406
2376
  */
2407
- sharedPlugins?: boolean;
2408
- buildApp?: (builder: ViteBuilder) => Promise<void>;
2409
- }
2410
- type ResolvedBuilderOptions = Required<BuilderOptions>;
2411
- /**
2412
- * Creates a ViteBuilder to orchestrate building multiple environments.
2413
- * @experimental
2414
- */
2415
- export declare function createBuilder(inlineConfig?: InlineConfig, useLegacyBuilder?: null | boolean): Promise<ViteBuilder>;
2416
- type BuildAppHook = (this: MinimalPluginContextWithoutEnvironment, builder: ViteBuilder) => Promise<void>;
2417
- //#endregion
2418
- //#region src/node/environment.d.ts
2419
- type Environment = DevEnvironment | BuildEnvironment | ScanEnvironment | UnknownEnvironment;
2420
- /**
2421
- * Creates a function that hides the complexities of a WeakMap with an initial value
2422
- * to implement object metadata. Used by plugins to implement cross hooks per
2423
- * environment metadata
2424
- *
2425
- * @experimental
2426
- */
2427
- export declare function perEnvironmentState<State>(initial: (environment: Environment) => State): (context: PluginContext) => State;
2428
- //#endregion
2429
- //#region src/node/server/pluginContainer.d.ts
2430
- type SkipInformation = {
2431
- id: string;
2432
- importer: string | undefined;
2433
- plugin: Plugin;
2434
- called?: boolean;
2435
- };
2436
- declare class EnvironmentPluginContainer<Env extends Environment = Environment> {
2437
- private _pluginContextMap;
2438
- private _resolvedRolldownOptions?;
2439
- private _processesing;
2440
- private _seenResolves;
2441
- private _moduleNodeToLoadAddedImports;
2442
- getSortedPluginHooks: PluginHookUtils["getSortedPluginHooks"];
2443
- getSortedPlugins: PluginHookUtils["getSortedPlugins"];
2444
- moduleGraph: EnvironmentModuleGraph | undefined;
2445
- watchFiles: Set<string>;
2446
- minimalContext: MinimalPluginContext$1<Env>;
2447
- private _started;
2448
- private _buildStartPromise;
2449
- private _closed;
2450
- private _updateModuleLoadAddedImports;
2451
- private _getAddedImports;
2452
- getModuleInfo(id: string): ModuleInfo | null;
2453
- private handleHookPromise;
2454
- get options(): InputOptions;
2455
- resolveRolldownOptions(): Promise<InputOptions>;
2456
- private _getPluginContext;
2457
- private hookParallel;
2458
- buildStart(_options?: InputOptions): Promise<void>;
2459
- resolveId(rawId: string, importer?: string | undefined, options?: {
2460
- kind?: ImportKind;
2461
- attributes?: Record<string, string>;
2462
- custom?: CustomPluginOptions;
2463
- /** @deprecated use `skipCalls` instead */
2464
- skip?: Set<Plugin>;
2465
- skipCalls?: readonly SkipInformation[];
2466
-
2467
- isEntry?: boolean;
2468
- }): Promise<PartialResolvedId | null>;
2469
- load(id: string): Promise<LoadResult | null>;
2470
- transform(code: string, id: string, options?: {
2471
- inMap?: SourceDescription["map"];
2472
- moduleType?: string;
2473
- }): Promise<{
2474
- code: string;
2475
- map: SourceMap | {
2476
- mappings: "";
2477
- } | null;
2478
- moduleType?: ModuleType;
2479
- }>;
2480
- watchChange(id: string, change: {
2481
- event: "create" | "update" | "delete";
2482
- }): Promise<void>;
2483
- close(): Promise<void>;
2484
- }
2485
- declare class BasicMinimalPluginContext<Meta = PluginContextMeta> {
2486
- meta: Meta;
2487
- private _logger;
2488
- constructor(meta: Meta, _logger: Logger);
2489
- get pluginName(): string;
2490
- debug(rawLog: string | RollupLog | (() => string | RollupLog)): void;
2491
- info(rawLog: string | RollupLog | (() => string | RollupLog)): void;
2492
- warn(rawLog: string | RollupLog | (() => string | RollupLog)): void;
2493
- error(e: string | RollupError): never;
2494
- private _normalizeRawLog;
2495
- }
2496
- declare class MinimalPluginContext$1<T extends Environment = Environment> extends BasicMinimalPluginContext implements MinimalPluginContext {
2497
- environment: T;
2498
- constructor(meta: PluginContextMeta, environment: T);
2499
- }
2500
- declare class PluginContainer {
2501
- private environments;
2502
- constructor(environments: Record<string, Environment>);
2503
- private _getEnvironment;
2504
- private _getPluginContainer;
2505
- getModuleInfo(id: string): ModuleInfo | null;
2506
- get options(): InputOptions;
2507
- buildStart(_options?: InputOptions): Promise<void>;
2508
- watchChange(id: string, change: {
2509
- event: "create" | "update" | "delete";
2510
- }): Promise<void>;
2511
- resolveId(rawId: string, importer?: string, options?: {
2512
- attributes?: Record<string, string>;
2513
- custom?: CustomPluginOptions;
2514
- /** @deprecated use `skipCalls` instead */
2515
- skip?: Set<Plugin>;
2516
- skipCalls?: readonly SkipInformation[];
2517
- ssr?: boolean;
2518
-
2519
- isEntry?: boolean;
2520
- }): Promise<PartialResolvedId | null>;
2521
- load(id: string, options?: {
2522
- ssr?: boolean;
2523
- }): Promise<LoadResult | null>;
2524
- transform(code: string, id: string, options?: {
2525
- ssr?: boolean;
2526
- environment?: Environment;
2527
- inMap?: SourceDescription["map"];
2528
- }): Promise<{
2377
+ shouldTransformCachedModule?: ObjectHook<(this: PluginContext, options: {
2529
2378
  code: string;
2530
- map: SourceMap | {
2531
- mappings: "";
2532
- } | null;
2533
- }>;
2534
- close(): Promise<void>;
2379
+ id: string;
2380
+ meta: CustomPluginOptions;
2381
+ moduleSideEffects: boolean | "no-treeshake";
2382
+ }) => boolean | null | void>;
2535
2383
  }
2384
+ type HookHandler<T> = T extends ObjectHook<infer H> ? H : T;
2385
+ type PluginWithRequiredHook<K extends keyof Plugin> = Plugin & { [P in K]: NonNullable<Plugin[P]>; };
2386
+ type Thenable<T> = T | Promise<T>;
2387
+ type FalsyPlugin = false | null | undefined;
2388
+ type PluginOption = Thenable<Plugin | {
2389
+ name: string;
2390
+ } | FalsyPlugin | PluginOption[]>;
2391
+ /**
2392
+ * @experimental
2393
+ */
2394
+ export declare function perEnvironmentPlugin(name: string, applyToEnvironment: (environment: PartialEnvironment) => boolean | Promise<boolean> | PluginOption): Plugin;
2395
+ //#endregion
2396
+ //#region src/node/watch.d.ts
2397
+ /**
2398
+ * Watch options for the dev server. Accepts both chokidar options and Rolldown
2399
+ * watch options. The chokidar options are used by the chokidar watcher, while
2400
+ * the Rolldown options are used by the Rolldown file watcher when bundled dev
2401
+ * mode is enabled.
2402
+ */
2403
+ type ServerWatchOptions = WatchOptions & Omit<DevWatchOptions, "enabled" | "skipWrite">;
2536
2404
  //#endregion
2537
2405
  //#region src/node/server/index.d.ts
2538
2406
  interface ServerOptions$1 extends CommonServerOptions {
@@ -2560,10 +2428,14 @@ interface ServerOptions$1 extends CommonServerOptions {
2560
2428
  ssrFiles?: string[];
2561
2429
  };
2562
2430
  /**
2563
- * chokidar watch options or null to disable FS watching
2564
- * https://github.com/paulmillr/chokidar/tree/3.6.0#api
2431
+ * File system watcher options, or null to disable FS watching.
2432
+ *
2433
+ * Accepts chokidar options
2434
+ * (https://github.com/paulmillr/chokidar/tree/3.6.0#api), which are used by
2435
+ * the chokidar watcher, and Rolldown watch options, which are used by the
2436
+ * Rolldown file watcher when bundled dev mode is enabled.
2565
2437
  */
2566
- watch?: WatchOptions | null;
2438
+ watch?: ServerWatchOptions | null;
2567
2439
  /**
2568
2440
  * Create Vite dev server to be used as a middleware in an existing server
2569
2441
  * @default false
@@ -2608,504 +2480,697 @@ interface ServerOptions$1 extends CommonServerOptions {
2608
2480
  */
2609
2481
  perEnvironmentStartEndDuringDev?: boolean;
2610
2482
  /**
2611
- * Backward compatibility. The watchChange hook was called only once for the client environment.
2612
- * This option enables per-environment watchChange hooks.
2613
- * @default false
2614
- * @experimental
2483
+ * Backward compatibility. The watchChange hook was called only once for the client environment.
2484
+ * This option enables per-environment watchChange hooks.
2485
+ * @default false
2486
+ * @experimental
2487
+ */
2488
+ perEnvironmentWatchChangeDuringDev?: boolean;
2489
+ /**
2490
+ * Run HMR tasks, by default the HMR propagation is done in parallel for all environments
2491
+ * @experimental
2492
+ */
2493
+ hotUpdateEnvironments?: (server: ViteDevServer, hmr: (environment: DevEnvironment) => Promise<void>) => Promise<void>;
2494
+ forwardConsole?: boolean | ForwardConsoleOptions;
2495
+ }
2496
+ interface ResolvedServerOptions extends Omit<RequiredExceptFor<ServerOptions$1, "host" | "https" | "proxy" | "hmr" | "ws" | "watch" | "origin" | "hotUpdateEnvironments">, "fs" | "middlewareMode" | "sourcemapIgnoreList" | "forwardConsole"> {
2497
+ fs: Required<FileSystemServeOptions>;
2498
+ middlewareMode: NonNullable<ServerOptions$1["middlewareMode"]>;
2499
+ sourcemapIgnoreList: Exclude<ServerOptions$1["sourcemapIgnoreList"], false | undefined>;
2500
+ forwardConsole: ResolvedForwardConsoleOptions;
2501
+ }
2502
+ interface FileSystemServeOptions {
2503
+ /**
2504
+ * Strictly restrict file accessing outside of allowing paths.
2505
+ *
2506
+ * Set to `false` to disable the warning
2507
+ *
2508
+ * @default true
2509
+ */
2510
+ strict?: boolean;
2511
+ /**
2512
+ * Restrict accessing files outside the allowed directories.
2513
+ *
2514
+ * Accepts absolute path or a path relative to project root.
2515
+ * Will try to search up for workspace root by default.
2516
+ */
2517
+ allow?: string[];
2518
+ /**
2519
+ * Restrict accessing files that matches the patterns.
2520
+ *
2521
+ * This will have higher priority than `allow`.
2522
+ * picomatch patterns are supported.
2523
+ *
2524
+ * @default ['.env', '.env.*', '*.{crt,pem,key,p12,pfx,cer,der}', '.npmrc', '.yarnrc.yml', '**\/.git/**']
2525
+ */
2526
+ deny?: string[];
2527
+ }
2528
+ type ServerHook = (this: MinimalPluginContextWithoutEnvironment, server: ViteDevServer) => (() => void) | void | Promise<(() => void) | void>;
2529
+ interface CloseServerHookContext {
2530
+ /**
2531
+ * Whether the server is being restarted (e.g. a config change or
2532
+ * `server.restart()`) or closed (e.g. the `q` shortcut, SIGTERM, stdin
2533
+ * ending, or `server.close()`).
2534
+ */
2535
+ reason: "restart" | "close";
2536
+ }
2537
+ type CloseServerHook = (this: MinimalPluginContextWithoutEnvironment, context: CloseServerHookContext) => void | Promise<void>;
2538
+ type HttpServer = http.Server | Http2SecureServer;
2539
+ interface ViteDevServer {
2540
+ /**
2541
+ * The resolved vite config object
2542
+ */
2543
+ config: ResolvedConfig;
2544
+ /**
2545
+ * A connect app instance.
2546
+ * - Can be used to attach custom middlewares to the dev server.
2547
+ * - Can also be used as the handler function of a custom http server
2548
+ * or as a middleware in any connect-style Node.js frameworks
2549
+ *
2550
+ * https://github.com/senchalabs/connect#use-middleware
2551
+ */
2552
+ middlewares: Connect.Server;
2553
+ /**
2554
+ * native Node http server instance
2555
+ * will be null in middleware mode
2556
+ */
2557
+ httpServer: HttpServer | null;
2558
+ /**
2559
+ * Chokidar watcher instance. If `config.server.watch` is set to `null`,
2560
+ * it will not watch any files and calling `add` or `unwatch` will have no effect.
2561
+ * https://github.com/paulmillr/chokidar/tree/3.6.0#api
2562
+ */
2563
+ watcher: FSWatcher;
2564
+ /**
2565
+ * WebSocket server with `send(payload)` method
2566
+ */
2567
+ ws: WebSocketServer;
2568
+ /**
2569
+ * An alias to `server.environments.client.hot`.
2570
+ * If you want to interact with all environments, loop over `server.environments`.
2571
+ */
2572
+ hot: NormalizedHotChannel;
2573
+ /**
2574
+ * Rollup plugin container that can run plugin hooks on a given file
2575
+ */
2576
+ pluginContainer: PluginContainer;
2577
+ /**
2578
+ * Module execution environments attached to the Vite server.
2579
+ */
2580
+ environments: Record<"client" | "ssr" | (string & {}), DevEnvironment>;
2581
+ /**
2582
+ * Module graph that tracks the import relationships, url to file mapping
2583
+ * and hmr state.
2584
+ */
2585
+ moduleGraph: ModuleGraph;
2586
+ /**
2587
+ * The resolved urls Vite prints on the CLI (URL-encoded). Returns `null`
2588
+ * in middleware mode or if the server is not listening on any port.
2589
+ */
2590
+ resolvedUrls: ResolvedServerUrls | null;
2591
+ /**
2592
+ * Programmatically resolve, load and transform a URL and get the result
2593
+ * without going through the http request pipeline.
2594
+ */
2595
+ transformRequest(url: string, options?: TransformOptions): Promise<TransformResult | null>;
2596
+ /**
2597
+ * Same as `transformRequest` but only warm up the URLs so the next request
2598
+ * will already be cached. The function will never throw as it handles and
2599
+ * reports errors internally.
2600
+ */
2601
+ warmupRequest(url: string, options?: TransformOptions): Promise<void>;
2602
+ /**
2603
+ * Apply vite built-in HTML transforms and any plugin HTML transforms.
2604
+ */
2605
+ transformIndexHtml(url: string, html: string, originalUrl?: string): Promise<string>;
2606
+ /**
2607
+ * Transform module code into SSR format.
2608
+ */
2609
+ ssrTransform(code: string, inMap: SourceMap | {
2610
+ mappings: "";
2611
+ } | null, url: string, originalCode?: string): Promise<TransformResult | null>;
2612
+ /**
2613
+ * Load a given URL as an instantiated module for SSR.
2614
+ */
2615
+ ssrLoadModule(url: string, opts?: {
2616
+ fixStacktrace?: boolean;
2617
+ }): Promise<Record<string, any>>;
2618
+ /**
2619
+ * Returns a fixed version of the given stack
2620
+ */
2621
+ ssrRewriteStacktrace(stack: string): string;
2622
+ /**
2623
+ * Mutates the given SSR error by rewriting the stacktrace
2624
+ */
2625
+ ssrFixStacktrace(e: Error): void;
2626
+ /**
2627
+ * Triggers HMR for a module in the module graph. You can use the `server.moduleGraph`
2628
+ * API to retrieve the module to be reloaded. If `hmr` is false, this is a no-op.
2629
+ */
2630
+ reloadModule(module: ModuleNode): Promise<void>;
2631
+ /**
2632
+ * Start the server.
2633
+ */
2634
+ listen(port?: number, isRestart?: boolean): Promise<ViteDevServer>;
2635
+ /**
2636
+ * Stop the server.
2637
+ */
2638
+ close(): Promise<void>;
2639
+ /**
2640
+ * Print server urls
2641
+ */
2642
+ printUrls(): void;
2643
+ /**
2644
+ * Bind CLI shortcuts
2645
+ */
2646
+ bindCLIShortcuts(options?: BindCLIShortcutsOptions<ViteDevServer>): void;
2647
+ /**
2648
+ * Restart the server.
2649
+ *
2650
+ * @param forceOptimize - force the optimizer to re-bundle, same as --force cli flag
2651
+ */
2652
+ restart(forceOptimize?: boolean): Promise<void>;
2653
+ /**
2654
+ * Open browser
2655
+ */
2656
+ openBrowser(): void;
2657
+ /**
2658
+ * Calling `await server.waitForRequestsIdle(id)` will wait until all static imports
2659
+ * are processed. If called from a load or transform plugin hook, the id needs to be
2660
+ * passed as a parameter to avoid deadlocks. Calling this function after the first
2661
+ * static imports section of the module graph has been processed will resolve immediately.
2662
+ */
2663
+ waitForRequestsIdle: (ignoredId?: string) => Promise<void>;
2664
+ }
2665
+ interface ResolvedServerUrls {
2666
+ local: string[];
2667
+ network: string[];
2668
+ /**
2669
+ * Names of the network interface that each {@link ResolvedServerUrls.network}
2670
+ * URL is bound to, in the same order as `network`. An entry is `undefined`
2671
+ * when the interface name is not known, for example when an explicit `host`
2672
+ * is set.
2673
+ */
2674
+ networkInterfaceNames?: (string | undefined)[];
2675
+ }
2676
+ export declare function createServer(inlineConfig?: InlineConfig | ResolvedConfig): Promise<ViteDevServer>;
2677
+ //#endregion
2678
+ //#region src/node/logger.d.ts
2679
+ type LogType = "error" | "warn" | "info";
2680
+ type LogLevel = LogType | "silent";
2681
+ interface Logger {
2682
+ info(msg: string, options?: LogOptions): void;
2683
+ warn(msg: string, options?: LogOptions): void;
2684
+ warnOnce(msg: string, options?: LogOptions): void;
2685
+ error(msg: string, options?: LogErrorOptions): void;
2686
+ clearScreen(type: LogType): void;
2687
+ hasErrorLogged(error: Error | RollupError): boolean;
2688
+ hasWarned: boolean;
2689
+ }
2690
+ interface LogOptions {
2691
+ clear?: boolean;
2692
+ timestamp?: boolean;
2693
+ environment?: string;
2694
+ }
2695
+ interface LogErrorOptions extends LogOptions {
2696
+ error?: Error | RollupError | null;
2697
+ }
2698
+ interface LoggerOptions {
2699
+ prefix?: string;
2700
+ allowClearScreen?: boolean;
2701
+ customLogger?: Logger;
2702
+ console?: Console;
2703
+ }
2704
+ export declare function createLogger(level?: LogLevel, options?: LoggerOptions): Logger;
2705
+ //#endregion
2706
+ //#region src/node/baseEnvironment.d.ts
2707
+ declare class PartialEnvironment {
2708
+ name: string;
2709
+ getTopLevelConfig(): ResolvedConfig;
2710
+ config: ResolvedConfig & ResolvedEnvironmentOptions;
2711
+ logger: Logger;
2712
+ constructor(name: string, topLevelConfig: ResolvedConfig, options?: ResolvedEnvironmentOptions);
2713
+ }
2714
+ declare class BaseEnvironment extends PartialEnvironment {
2715
+ get plugins(): readonly Plugin[];
2716
+ constructor(name: string, config: ResolvedConfig, options?: ResolvedEnvironmentOptions);
2717
+ }
2718
+ /**
2719
+ * This class discourages users from inversely checking the `mode`
2720
+ * to determine the type of environment, e.g.
2721
+ *
2722
+ * ```js
2723
+ * const isDev = environment.mode !== 'build' // bad
2724
+ * const isDev = environment.mode === 'dev' // good
2725
+ * ```
2726
+ *
2727
+ * You should also not check against `"unknown"` specifically. It's
2728
+ * a placeholder for more possible environment types.
2729
+ */
2730
+ declare class UnknownEnvironment extends BaseEnvironment {
2731
+ mode: "unknown";
2732
+ }
2733
+ //#endregion
2734
+ //#region src/node/plugins/resolve.d.ts
2735
+ interface EnvironmentResolveOptions {
2736
+ /**
2737
+ * @default ['browser', 'module', 'jsnext:main', 'jsnext']
2615
2738
  */
2616
- perEnvironmentWatchChangeDuringDev?: boolean;
2739
+ mainFields?: string[];
2740
+ conditions?: string[];
2741
+ externalConditions?: string[];
2617
2742
  /**
2618
- * Run HMR tasks, by default the HMR propagation is done in parallel for all environments
2619
- * @experimental
2743
+ * @default ['.mjs', '.js', '.mts', '.ts', '.jsx', '.tsx', '.json']
2620
2744
  */
2621
- hotUpdateEnvironments?: (server: ViteDevServer, hmr: (environment: DevEnvironment) => Promise<void>) => Promise<void>;
2622
- forwardConsole?: boolean | ForwardConsoleOptions;
2623
- }
2624
- interface ResolvedServerOptions extends Omit<RequiredExceptFor<ServerOptions$1, "host" | "https" | "proxy" | "hmr" | "ws" | "watch" | "origin" | "hotUpdateEnvironments">, "fs" | "middlewareMode" | "sourcemapIgnoreList" | "forwardConsole"> {
2625
- fs: Required<FileSystemServeOptions>;
2626
- middlewareMode: NonNullable<ServerOptions$1["middlewareMode"]>;
2627
- sourcemapIgnoreList: Exclude<ServerOptions$1["sourcemapIgnoreList"], false | undefined>;
2628
- forwardConsole: ResolvedForwardConsoleOptions;
2629
- }
2630
- interface FileSystemServeOptions {
2745
+ extensions?: string[];
2746
+ dedupe?: string[];
2631
2747
  /**
2632
- * Strictly restrict file accessing outside of allowing paths.
2633
- *
2634
- * Set to `false` to disable the warning
2635
- *
2636
- * @default true
2748
+ * Prevent listed dependencies from being externalized and will get bundled in build.
2749
+ * Only works in server environments for now. Previously this was `ssr.noExternal`.
2750
+ * @experimental
2637
2751
  */
2638
- strict?: boolean;
2752
+ noExternal?: string | RegExp | (string | RegExp)[] | true;
2639
2753
  /**
2640
- * Restrict accessing files outside the allowed directories.
2641
- *
2642
- * Accepts absolute path or a path relative to project root.
2643
- * Will try to search up for workspace root by default.
2754
+ * Externalize the given dependencies and their transitive dependencies.
2755
+ * Only works in server environments for now. Previously this was `ssr.external`.
2756
+ * @experimental
2644
2757
  */
2645
- allow?: string[];
2758
+ external?: string[] | true;
2646
2759
  /**
2647
- * Restrict accessing files that matches the patterns.
2648
- *
2649
- * This will have higher priority than `allow`.
2650
- * picomatch patterns are supported.
2651
- *
2652
- * @default ['.env', '.env.*', '*.{crt,pem,key,p12,pfx,cer,der}', '.npmrc', '.yarnrc.yml', '**\/.git/**']
2760
+ * Array of strings or regular expressions that indicate what modules are builtin for the environment.
2653
2761
  */
2654
- deny?: string[];
2762
+ builtins?: (string | RegExp)[];
2655
2763
  }
2656
- type ServerHook = (this: MinimalPluginContextWithoutEnvironment, server: ViteDevServer) => (() => void) | void | Promise<(() => void) | void>;
2657
- type HttpServer = http.Server | Http2SecureServer;
2658
- interface ViteDevServer {
2764
+ interface ResolveOptions extends EnvironmentResolveOptions {
2659
2765
  /**
2660
- * The resolved vite config object
2766
+ * @default false
2661
2767
  */
2662
- config: ResolvedConfig;
2768
+ preserveSymlinks?: boolean;
2663
2769
  /**
2664
- * A connect app instance.
2665
- * - Can be used to attach custom middlewares to the dev server.
2666
- * - Can also be used as the handler function of a custom http server
2667
- * or as a middleware in any connect-style Node.js frameworks
2770
+ * Enable tsconfig paths resolution
2668
2771
  *
2669
- * https://github.com/senchalabs/connect#use-middleware
2670
- */
2671
- middlewares: Connect.Server;
2672
- /**
2673
- * native Node http server instance
2674
- * will be null in middleware mode
2675
- */
2676
- httpServer: HttpServer | null;
2677
- /**
2678
- * Chokidar watcher instance. If `config.server.watch` is set to `null`,
2679
- * it will not watch any files and calling `add` or `unwatch` will have no effect.
2680
- * https://github.com/paulmillr/chokidar/tree/3.6.0#api
2681
- */
2682
- watcher: FSWatcher;
2683
- /**
2684
- * WebSocket server with `send(payload)` method
2685
- */
2686
- ws: WebSocketServer;
2687
- /**
2688
- * An alias to `server.environments.client.hot`.
2689
- * If you want to interact with all environments, loop over `server.environments`.
2772
+ * @default false
2690
2773
  */
2691
- hot: NormalizedHotChannel;
2774
+ tsconfigPaths?: boolean;
2775
+ }
2776
+ interface ResolvePluginOptions {
2777
+ root: string;
2778
+ isBuild: boolean;
2779
+ isProduction: boolean;
2780
+ packageCache?: PackageCache;
2692
2781
  /**
2693
- * Rollup plugin container that can run plugin hooks on a given file
2782
+ * src code mode also attempts the following:
2783
+ * - resolving /xxx as URLs
2784
+ * - resolving bare imports from optimized deps
2694
2785
  */
2695
- pluginContainer: PluginContainer;
2786
+ asSrc?: boolean;
2787
+ tryIndex?: boolean;
2788
+ tryPrefix?: string;
2789
+ preferRelative?: boolean;
2790
+ isRequire?: boolean;
2791
+ scan?: boolean;
2696
2792
  /**
2697
- * Module execution environments attached to the Vite server.
2793
+ * Enable when `legacy.inconsistentCjsInterop` is true. See that option for more details.
2698
2794
  */
2699
- environments: Record<"client" | "ssr" | (string & {}), DevEnvironment>;
2795
+ legacyInconsistentCjsInterop?: boolean;
2796
+ }
2797
+ interface InternalResolveOptions extends Required<ResolveOptions>, ResolvePluginOptions {}
2798
+ //#endregion
2799
+ //#region src/node/packages.d.ts
2800
+ /** Cache for package.json resolution and package.json contents */
2801
+ type PackageCache = Map<string, PackageData>;
2802
+ interface PackageData {
2803
+ dir: string;
2804
+ hasSideEffects: (id: string) => boolean | "no-treeshake" | null;
2805
+ setResolvedCache: (key: string, entry: string, options: InternalResolveOptions) => void;
2806
+ getResolvedCache: (key: string, options: InternalResolveOptions) => string | undefined;
2807
+ data: {
2808
+ [field: string]: any;
2809
+ name: string;
2810
+ type: string;
2811
+ version: string;
2812
+ main: string;
2813
+ module: string;
2814
+ browser: string | Record<string, string | false>;
2815
+ exports: string | Record<string, any> | string[];
2816
+ imports: Record<string, any>;
2817
+ dependencies: Record<string, string>;
2818
+ };
2819
+ }
2820
+ //#endregion
2821
+ //#region src/node/plugins/license.d.ts
2822
+ interface LicenseOptions {
2700
2823
  /**
2701
- * Module graph that tracks the import relationships, url to file mapping
2702
- * and hmr state.
2824
+ * The output file name of the license file relative to the output directory.
2825
+ * Specify a path that ends with `.json` to output the raw JSON metadata.
2826
+ *
2827
+ * @default '.vite/license.md'
2703
2828
  */
2704
- moduleGraph: ModuleGraph;
2829
+ fileName: string;
2830
+ }
2831
+ //#endregion
2832
+ //#region src/node/plugins/terser.d.ts
2833
+ interface TerserOptions extends TerserMinifyOptions {
2705
2834
  /**
2706
- * The resolved urls Vite prints on the CLI (URL-encoded). Returns `null`
2707
- * in middleware mode or if the server is not listening on any port.
2835
+ * Vite-specific option to specify the max number of workers to spawn
2836
+ * when minifying files with terser.
2837
+ *
2838
+ * @default number of CPUs minus 1
2708
2839
  */
2709
- resolvedUrls: ResolvedServerUrls | null;
2840
+ maxWorkers?: number;
2841
+ }
2842
+ //#endregion
2843
+ //#region src/node/build.d.ts
2844
+ interface BuildEnvironmentOptions {
2710
2845
  /**
2711
- * Programmatically resolve, load and transform a URL and get the result
2712
- * without going through the http request pipeline.
2846
+ * Compatibility transform target. The transform is performed with esbuild
2847
+ * and the lowest supported target is es2015. Note this only handles
2848
+ * syntax transformation and does not cover polyfills
2849
+ *
2850
+ * Default: 'baseline-widely-available' - transpile targeting browsers that
2851
+ * are included in the Baseline Widely Available on 2026-01-01.
2852
+ * (Chrome 111+, Edge 111+, Firefox 114+, Safari 16.4+).
2853
+ *
2854
+ * Another special value is 'esnext' - which only performs minimal transpiling
2855
+ * (for minification compat).
2856
+ *
2857
+ * For custom targets, see https://esbuild.github.io/api/#target and
2858
+ * https://esbuild.github.io/content-types/#javascript for more details.
2859
+ * @default 'baseline-widely-available'
2713
2860
  */
2714
- transformRequest(url: string, options?: TransformOptions): Promise<TransformResult | null>;
2861
+ target?: "baseline-widely-available" | EsbuildTarget | false;
2715
2862
  /**
2716
- * Same as `transformRequest` but only warm up the URLs so the next request
2717
- * will already be cached. The function will never throw as it handles and
2718
- * reports errors internally.
2863
+ * whether to inject module preload polyfill.
2864
+ * Note: does not apply to library mode.
2865
+ * @default true
2866
+ * @deprecated use `modulePreload.polyfill` instead
2719
2867
  */
2720
- warmupRequest(url: string, options?: TransformOptions): Promise<void>;
2868
+ polyfillModulePreload?: boolean;
2721
2869
  /**
2722
- * Apply vite built-in HTML transforms and any plugin HTML transforms.
2870
+ * Configure module preload
2871
+ * Note: does not apply to library mode.
2872
+ * @default true
2723
2873
  */
2724
- transformIndexHtml(url: string, html: string, originalUrl?: string): Promise<string>;
2874
+ modulePreload?: boolean | ModulePreloadOptions;
2725
2875
  /**
2726
- * Transform module code into SSR format.
2876
+ * Directory relative from `root` where build output will be placed. If the
2877
+ * directory exists, it will be removed before the build.
2878
+ * @default 'dist'
2727
2879
  */
2728
- ssrTransform(code: string, inMap: SourceMap | {
2729
- mappings: "";
2730
- } | null, url: string, originalCode?: string): Promise<TransformResult | null>;
2880
+ outDir?: string;
2731
2881
  /**
2732
- * Load a given URL as an instantiated module for SSR.
2882
+ * Directory relative from `outDir` where the built js/css/image assets will
2883
+ * be placed.
2884
+ * @default 'assets'
2733
2885
  */
2734
- ssrLoadModule(url: string, opts?: {
2735
- fixStacktrace?: boolean;
2736
- }): Promise<Record<string, any>>;
2886
+ assetsDir?: string;
2737
2887
  /**
2738
- * Returns a fixed version of the given stack
2888
+ * Static asset files smaller than this number (in bytes) will be inlined as
2889
+ * base64 strings. If a callback is passed, a boolean can be returned to opt-in
2890
+ * or opt-out of inlining. If nothing is returned the default logic applies.
2891
+ *
2892
+ * Default limit is `4096` (4 KiB). Set to `0` to disable.
2893
+ * @default 4096
2739
2894
  */
2740
- ssrRewriteStacktrace(stack: string): string;
2895
+ assetsInlineLimit?: number | ((filePath: string, content: Buffer) => boolean | undefined);
2741
2896
  /**
2742
- * Mutates the given SSR error by rewriting the stacktrace
2897
+ * Whether to code-split CSS. When enabled, CSS in async chunks will be
2898
+ * inlined as strings in the chunk and inserted via dynamically created
2899
+ * style tags when the chunk is loaded.
2900
+ * @default true
2743
2901
  */
2744
- ssrFixStacktrace(e: Error): void;
2902
+ cssCodeSplit?: boolean;
2745
2903
  /**
2746
- * Triggers HMR for a module in the module graph. You can use the `server.moduleGraph`
2747
- * API to retrieve the module to be reloaded. If `hmr` is false, this is a no-op.
2904
+ * An optional separate target for CSS minification.
2905
+ * As esbuild only supports configuring targets to mainstream
2906
+ * browsers, users may need this option when they are targeting
2907
+ * a niche browser that comes with most modern JavaScript features
2908
+ * but has poor CSS support, e.g. Android WeChat WebView, which
2909
+ * doesn't support the #RGBA syntax.
2910
+ * When `build.cssMinify` is `lightningcss` (the default), this
2911
+ * option takes precedence over `css.lightningcss.targets` for the
2912
+ * minification step.
2913
+ * @default target
2748
2914
  */
2749
- reloadModule(module: ModuleNode): Promise<void>;
2915
+ cssTarget?: EsbuildTarget | false;
2750
2916
  /**
2751
- * Start the server.
2917
+ * Override CSS minification specifically instead of defaulting to `build.minify`,
2918
+ * so you can configure minification for JS and CSS separately.
2919
+ * @default 'lightningcss', but false if build.minify is disabled for client build
2752
2920
  */
2753
- listen(port?: number, isRestart?: boolean): Promise<ViteDevServer>;
2921
+ cssMinify?: boolean | "lightningcss" | "esbuild";
2754
2922
  /**
2755
- * Stop the server.
2923
+ * If `true`, a separate sourcemap file will be created. If 'inline', the
2924
+ * sourcemap will be appended to the resulting output file as data URI.
2925
+ * 'hidden' works like `true` except that the corresponding sourcemap
2926
+ * comments in the bundled files are suppressed.
2927
+ * @default false
2756
2928
  */
2757
- close(): Promise<void>;
2929
+ sourcemap?: boolean | "inline" | "hidden";
2758
2930
  /**
2759
- * Print server urls
2931
+ * Set to `false` to disable minification, or specify the minifier to use.
2932
+ * Available options are 'oxc' or 'terser' or 'esbuild'.
2933
+ * @default 'oxc' for client build, false for SSR build
2760
2934
  */
2761
- printUrls(): void;
2935
+ minify?: boolean | "oxc" | "terser" | "esbuild";
2762
2936
  /**
2763
- * Bind CLI shortcuts
2937
+ * Options for terser
2938
+ * https://terser.org/docs/api-reference#minify-options
2939
+ *
2940
+ * In addition, you can also pass a `maxWorkers: number` option to specify the
2941
+ * max number of workers to spawn. Defaults to the number of CPUs minus 1.
2764
2942
  */
2765
- bindCLIShortcuts(options?: BindCLIShortcutsOptions<ViteDevServer>): void;
2943
+ terserOptions?: TerserOptions;
2766
2944
  /**
2767
- * Restart the server.
2768
- *
2769
- * @param forceOptimize - force the optimizer to re-bundle, same as --force cli flag
2945
+ * Whether to use import maps feature to optimize chunk caching efficiency.
2946
+ * @default false
2947
+ * @experimental
2770
2948
  */
2771
- restart(forceOptimize?: boolean): Promise<void>;
2949
+ chunkImportMap?: boolean;
2772
2950
  /**
2773
- * Open browser
2951
+ * Alias to `rolldownOptions`
2952
+ * @deprecated Use `rolldownOptions` instead.
2774
2953
  */
2775
- openBrowser(): void;
2954
+ rollupOptions?: RolldownOptions;
2776
2955
  /**
2777
- * Calling `await server.waitForRequestsIdle(id)` will wait until all static imports
2778
- * are processed. If called from a load or transform plugin hook, the id needs to be
2779
- * passed as a parameter to avoid deadlocks. Calling this function after the first
2780
- * static imports section of the module graph has been processed will resolve immediately.
2956
+ * Will be merged with internal rolldown options.
2957
+ * https://rolldown.rs/reference/Interface.RolldownOptions
2781
2958
  */
2782
- waitForRequestsIdle: (ignoredId?: string) => Promise<void>;
2783
- }
2784
- interface ResolvedServerUrls {
2785
- local: string[];
2786
- network: string[];
2959
+ rolldownOptions?: RolldownOptions;
2787
2960
  /**
2788
- * Names of the network interface that each {@link ResolvedServerUrls.network}
2789
- * URL is bound to, in the same order as `network`. An entry is `undefined`
2790
- * when the interface name is not known, for example when an explicit `host`
2791
- * is set.
2961
+ * Options to pass on to `@rollup/plugin-commonjs`
2962
+ * @deprecated This option is no-op and will be removed in future versions.
2792
2963
  */
2793
- networkInterfaceNames?: (string | undefined)[];
2794
- }
2795
- export declare function createServer(inlineConfig?: InlineConfig | ResolvedConfig): Promise<ViteDevServer>;
2796
- //#endregion
2797
- //#region src/node/plugins/html.d.ts
2798
- interface HtmlTagDescriptor {
2799
- tag: string;
2964
+ commonjsOptions?: RollupCommonJSOptions;
2800
2965
  /**
2801
- * attribute values will be escaped automatically if needed
2966
+ * Options to pass on to `@rollup/plugin-dynamic-import-vars`
2802
2967
  */
2803
- attrs?: Record<string, string | boolean | undefined>;
2804
- children?: string | HtmlTagDescriptor[];
2968
+ dynamicImportVarsOptions?: RollupDynamicImportVarsOptions;
2805
2969
  /**
2806
- * default: 'head-prepend'
2970
+ * Whether to write bundle to disk
2971
+ * @default true
2807
2972
  */
2808
- injectTo?: "head" | "body" | "head-prepend" | "body-prepend";
2809
- }
2810
- type IndexHtmlTransformResult = string | HtmlTagDescriptor[] | {
2811
- html: string;
2812
- tags: HtmlTagDescriptor[];
2813
- };
2814
- interface IndexHtmlTransformContext {
2973
+ write?: boolean;
2815
2974
  /**
2816
- * public path when served
2975
+ * Empty outDir on write.
2976
+ * @default true when outDir is a sub directory of project root
2817
2977
  */
2818
- path: string;
2978
+ emptyOutDir?: boolean | null;
2819
2979
  /**
2820
- * filename on disk
2980
+ * Copy the public directory to outDir on write.
2981
+ * @default true
2821
2982
  */
2822
- filename: string;
2823
- server?: ViteDevServer;
2824
- bundle?: OutputBundle;
2825
- chunk?: OutputChunk;
2826
- originalUrl?: string;
2827
- }
2828
- type IndexHtmlTransformHook = (this: MinimalPluginContextWithoutEnvironment, html: string, ctx: IndexHtmlTransformContext) => IndexHtmlTransformResult | void | Promise<IndexHtmlTransformResult | void>;
2829
- type IndexHtmlTransform = IndexHtmlTransformHook | {
2830
- order?: "pre" | "post" | null;
2831
- handler: IndexHtmlTransformHook;
2832
- };
2833
- //#endregion
2834
- //#region src/node/plugins/pluginFilter.d.ts
2835
- type StringFilter<Value = string | RegExp> = Value | Array<Value> | {
2836
- include?: Value | Array<Value>;
2837
- exclude?: Value | Array<Value>;
2838
- };
2839
- //#endregion
2840
- //#region src/node/plugin.d.ts
2841
- /**
2842
- * Vite plugins extends the Rollup plugin interface with a few extra
2843
- * vite-specific options. A valid vite plugin is also a valid Rollup plugin.
2844
- * On the contrary, a Rollup plugin may or may NOT be a valid vite universal
2845
- * plugin, since some Rollup features do not make sense in an unbundled
2846
- * dev server context. That said, as long as a rollup plugin doesn't have strong
2847
- * coupling between its bundle phase and output phase hooks then it should
2848
- * just work (that means, most of them).
2849
- *
2850
- * By default, the plugins are run during both serve and build. When a plugin
2851
- * is applied during serve, it will only run **non output plugin hooks** (see
2852
- * rollup type definition of {@link rollup#PluginHooks}). You can think of the
2853
- * dev server as only running `const bundle = rollup.rollup()` but never calling
2854
- * `bundle.generate()`.
2855
- *
2856
- * A plugin that expects to have different behavior depending on serve/build can
2857
- * export a factory function that receives the command being run via options.
2858
- *
2859
- * If a plugin should be applied only for server or build, a function format
2860
- * config file can be used to conditional determine the plugins to use.
2861
- *
2862
- * The current environment can be accessed from the context for the all non-global
2863
- * hooks (it is not available in config, configResolved, configureServer, etc).
2864
- * It can be a dev, build, or scan environment.
2865
- * Plugins can use this.environment.mode === 'dev' to guard for dev specific APIs.
2866
- */
2867
- interface PluginContextExtension {
2983
+ copyPublicDir?: boolean;
2868
2984
  /**
2869
- * Vite-specific environment instance
2985
+ * Whether to emit a `.vite/license.md` file that includes all bundled dependencies'
2986
+ * licenses. Pass an object to customize the output file name.
2987
+ * @default false
2870
2988
  */
2871
- environment: Environment;
2872
- }
2873
- interface PluginContextMetaExtension {
2874
- viteVersion: string;
2875
- }
2876
- interface ConfigPluginContext extends Omit<MinimalPluginContext, "meta" | "environment"> {
2877
- meta: Omit<PluginContextMeta, "watchMode">;
2878
- }
2879
- interface MinimalPluginContextWithoutEnvironment extends Omit<MinimalPluginContext, "environment"> {}
2880
- declare module "rolldown" {
2881
- interface MinimalPluginContext extends PluginContextExtension {}
2882
- interface PluginContextMeta extends PluginContextMetaExtension {}
2883
- }
2884
- /**
2885
- * There are two types of plugins in Vite. App plugins and environment plugins.
2886
- * Environment Plugins are defined by a constructor function that will be called
2887
- * once per each environment allowing users to have completely different plugins
2888
- * for each of them. The constructor gets the resolved environment after the server
2889
- * and builder has already been created simplifying config access and cache
2890
- * management for environment specific plugins.
2891
- * Environment Plugins are closer to regular rollup plugins. They can't define
2892
- * app level hooks (like config, configResolved, configureServer, etc).
2893
- */
2894
- interface Plugin<A = any> extends Rolldown.Plugin<A> {
2989
+ license?: boolean | LicenseOptions;
2895
2990
  /**
2896
- * Perform custom handling of HMR updates.
2897
- * The handler receives an options containing changed filename, timestamp, a
2898
- * list of modules affected by the file change, and the dev server instance.
2899
- *
2900
- * - The hook can return a filtered list of modules to narrow down the update.
2901
- * e.g. for a Vue SFC, we can narrow down the part to update by comparing
2902
- * the descriptors.
2991
+ * Whether to emit a .vite/manifest.json in the output dir to map hash-less filenames
2992
+ * to their hashed versions. Useful when you want to generate your own HTML
2993
+ * instead of using the one generated by Vite.
2903
2994
  *
2904
- * - The hook can also return an empty array and then perform custom updates
2905
- * by sending a custom hmr payload via environment.hot.send().
2995
+ * Example:
2906
2996
  *
2907
- * - If the hook doesn't return a value, the hmr update will be performed as
2908
- * normal.
2997
+ * ```json
2998
+ * {
2999
+ * "main.js": {
3000
+ * "file": "main.68fe3fad.js",
3001
+ * "css": "main.e6b63442.css",
3002
+ * "imports": [...],
3003
+ * "dynamicImports": [...]
3004
+ * }
3005
+ * }
3006
+ * ```
3007
+ * @default false
2909
3008
  */
2910
- hotUpdate?: ObjectHook<(this: MinimalPluginContext & {
2911
- environment: DevEnvironment;
2912
- }, options: HotUpdateOptions) => Array<EnvironmentModuleNode> | void | Promise<Array<EnvironmentModuleNode> | void>>;
3009
+ manifest?: boolean | string;
2913
3010
  /**
2914
- * extend hooks with ssr flag
3011
+ * Build in library mode. The value should be the global name of the lib in
3012
+ * UMD mode. This will produce esm + cjs + umd bundle formats with default
3013
+ * configurations that are suitable for distributing libraries.
3014
+ * @default false
2915
3015
  */
2916
- resolveId?: ObjectHook<(this: PluginContext, source: string, importer: string | undefined, options: {
2917
- kind?: ImportKind;
2918
- custom?: CustomPluginOptions;
2919
- ssr?: boolean | undefined;
2920
-
2921
- isEntry: boolean;
2922
- }) => Promise<ResolveIdResult> | ResolveIdResult, {
2923
- filter?: {
2924
- id?: StringFilter<RegExp>;
2925
- };
2926
- }>;
2927
- load?: ObjectHook<(this: PluginContext, id: string, options?: {
2928
- ssr?: boolean | undefined;
2929
- }) => Promise<LoadResult> | LoadResult, {
2930
- filter?: {
2931
- id?: StringFilter;
2932
- };
2933
- }>;
2934
- transform?: ObjectHook<(this: TransformPluginContext, code: string, id: string, options?: {
2935
- moduleType: ModuleType;
2936
- ssr?: boolean | undefined;
2937
- }) => Promise<Rolldown.TransformResult> | Rolldown.TransformResult, {
2938
- filter?: {
2939
- id?: StringFilter;
2940
- code?: StringFilter;
2941
- moduleType?: ModuleTypeFilter;
2942
- };
2943
- }>;
3016
+ lib?: LibraryOptions | false;
2944
3017
  /**
2945
- * Opt-in this plugin into the shared plugins pipeline.
2946
- * For backward-compatibility, plugins are re-recreated for each environment
2947
- * during `vite build --app`
2948
- * We have an opt-in per plugin, and a general `builder.sharedPlugins`
2949
- * In a future major, we'll flip the default to be shared by default
2950
- * @experimental
3018
+ * Produce SSR oriented build. Note this requires specifying SSR entry via
3019
+ * `rolldownOptions.input`.
3020
+ * @default false
2951
3021
  */
2952
- sharedDuringBuild?: boolean;
3022
+ ssr?: boolean | string;
2953
3023
  /**
2954
- * Opt-in this plugin into per-environment buildStart and buildEnd during dev.
2955
- * For backward-compatibility, the buildStart hook is called only once during
2956
- * dev, for the client environment. Plugins can opt-in to be called
2957
- * per-environment, aligning with the build hook behavior.
2958
- * @experimental
3024
+ * Generate SSR manifest for determining style links and asset preload
3025
+ * directives in production.
3026
+ * @default false
2959
3027
  */
2960
- perEnvironmentStartEndDuringDev?: boolean;
3028
+ ssrManifest?: boolean | string;
2961
3029
  /**
2962
- * Opt-in this plugin into per-environment watchChange during dev.
2963
- * For backward-compatibility, the watchChange hook is called only once during
2964
- * dev, for the client environment. Plugins can opt-in to be called
2965
- * per-environment, aligning with the watchChange hook behavior.
2966
- * @experimental
3030
+ * Emit assets during SSR.
3031
+ * @default false
3032
+ */
3033
+ ssrEmitAssets?: boolean;
3034
+ /**
3035
+ * Emit assets during build. Frameworks can set environments.ssr.build.emitAssets
3036
+ * By default, it is true for the client and false for other environments.
3037
+ */
3038
+ emitAssets?: boolean;
3039
+ /**
3040
+ * Set to false to disable reporting compressed chunk sizes.
3041
+ * Can slightly improve build speed.
3042
+ * @default true
2967
3043
  */
2968
- perEnvironmentWatchChangeDuringDev?: boolean;
3044
+ reportCompressedSize?: boolean;
2969
3045
  /**
2970
- * Enforce plugin invocation tier similar to webpack loaders. Hooks ordering
2971
- * is still subject to the `order` property in the hook object.
2972
- *
2973
- * Plugin invocation order:
2974
- * - alias resolution
2975
- * - `enforce: 'pre'` plugins
2976
- * - vite core plugins
2977
- * - normal plugins
2978
- * - vite build plugins
2979
- * - `enforce: 'post'` plugins
2980
- * - vite build post plugins
3046
+ * Adjust chunk size warning limit (in kB).
3047
+ * @default 500
2981
3048
  */
2982
- enforce?: "pre" | "post";
3049
+ chunkSizeWarningLimit?: number;
2983
3050
  /**
2984
- * Apply the plugin only for serve or build, or on certain conditions.
3051
+ * Rollup watch options
3052
+ * https://rollupjs.org/configuration-options/#watch
3053
+ * @default null
2985
3054
  */
2986
- apply?: "serve" | "build" | ((this: void, config: UserConfig, env: ConfigEnv) => boolean);
3055
+ watch?: WatcherOptions | null;
2987
3056
  /**
2988
- * Define environments where this plugin should be active
2989
- * By default, the plugin is active in all environments
2990
- * @experimental
3057
+ * create the Build Environment instance
2991
3058
  */
2992
- applyToEnvironment?: (environment: PartialEnvironment) => boolean | Promise<boolean> | PluginOption;
3059
+ createEnvironment?: (name: string, config: ResolvedConfig) => Promise<BuildEnvironment> | BuildEnvironment;
3060
+ }
3061
+ type BuildOptions = BuildEnvironmentOptions;
3062
+ interface LibraryOptions {
2993
3063
  /**
2994
- * Modify vite config before it's resolved. The hook can either mutate the
2995
- * passed-in config directly, or return a partial config object that will be
2996
- * deeply merged into existing config.
2997
- *
2998
- * Note: User plugins are resolved before running this hook so injecting other
2999
- * plugins inside the `config` hook will have no effect.
3064
+ * Path of library entry.
3065
+ * Defaults to the top-level `input` option when omitted.
3000
3066
  */
3001
- config?: ObjectHook<(this: ConfigPluginContext, config: UserConfig, env: ConfigEnv) => Omit<UserConfig, "plugins"> | null | void | Promise<Omit<UserConfig, "plugins"> | null | void>>;
3067
+ entry?: InputOption;
3002
3068
  /**
3003
- * Modify environment configs before it's resolved. The hook can either mutate the
3004
- * passed-in environment config directly, or return a partial config object that will be
3005
- * deeply merged into existing config.
3006
- * This hook is called for each environment with a partially resolved environment config
3007
- * that already accounts for the default environment config values set at the root level.
3008
- * If plugins need to modify the config of a given environment, they should do it in this
3009
- * hook instead of the config hook. Leaving the config hook only for modifying the root
3010
- * default environment config.
3069
+ * The name of the exposed global variable. Required when the `formats` option includes
3070
+ * `umd` or `iife`
3011
3071
  */
3012
- configEnvironment?: ObjectHook<(this: ConfigPluginContext, name: string, config: EnvironmentOptions, env: ConfigEnv & {
3013
- /**
3014
- * Whether this environment is SSR environment and `ssr.target` is set to `'webworker'`.
3015
- * Only intended to be used for backward compatibility.
3016
- */
3017
- isSsrTargetWebworker?: boolean;
3018
- }) => EnvironmentOptions | null | void | Promise<EnvironmentOptions | null | void>>;
3072
+ name?: string;
3019
3073
  /**
3020
- * Use this hook to read and store the final resolved vite config.
3074
+ * Output bundle formats. Defaults to `['es', 'umd']` for a single entry, or
3075
+ * `['es', 'cjs']` for multiple entries (`umd` and `iife` do not support
3076
+ * multiple entries).
3077
+ * @default ['es', 'umd']
3021
3078
  */
3022
- configResolved?: ObjectHook<(this: MinimalPluginContextWithoutEnvironment, config: ResolvedConfig) => void | Promise<void>>;
3079
+ formats?: LibraryFormats[];
3023
3080
  /**
3024
- * Configure the vite server. The hook receives the {@link ViteDevServer}
3025
- * instance. This can also be used to store a reference to the server
3026
- * for use in other hooks.
3027
- *
3028
- * The hooks will be called before internal middlewares are applied. A hook
3029
- * can return a post hook that will be called after internal middlewares
3030
- * are applied. Hook can be async functions and will be called in series.
3081
+ * The name of the package file output. The default file name is the name option
3082
+ * of the project package.json. It can also be defined as a function taking the
3083
+ * format as an argument.
3031
3084
  */
3032
- configureServer?: ObjectHook<ServerHook>;
3085
+ fileName?: string | ((format: ModuleFormat, entryName: string) => string);
3033
3086
  /**
3034
- * Configure the preview server. The hook receives the {@link PreviewServer}
3035
- * instance. This can also be used to store a reference to the server
3036
- * for use in other hooks.
3037
- *
3038
- * The hooks are called before other middlewares are applied. A hook can
3039
- * return a post hook that will be called after other middlewares are
3040
- * applied. Hooks can be async functions and will be called in series.
3087
+ * The name of the CSS file output if the library imports CSS. Defaults to the
3088
+ * same value as `build.lib.fileName` if it's set a string, otherwise it falls
3089
+ * back to the name option of the project package.json.
3041
3090
  */
3042
- configurePreviewServer?: ObjectHook<PreviewServerHook>;
3091
+ cssFileName?: string;
3092
+ }
3093
+ type LibraryFormats = "es" | "cjs" | "umd" | "iife";
3094
+ interface ModulePreloadOptions {
3043
3095
  /**
3044
- * Transform index.html.
3045
- * The hook receives the following arguments:
3046
- *
3047
- * - html: string
3048
- * - ctx: IndexHtmlTransformContext, which contains:
3049
- * - path: public path when served
3050
- * - filename: filename on disk
3051
- * - server?: ViteDevServer (only present during serve)
3052
- * - bundle?: rollup.OutputBundle (only present during build)
3053
- * - chunk?: rollup.OutputChunk
3054
- * - originalUrl?: string
3055
- *
3056
- * It can either return a transformed string, or a list of html tag
3057
- * descriptors that will be injected into the `<head>` or `<body>`.
3058
- *
3059
- * By default the transform is applied **after** vite's internal html
3060
- * transform. If you need to apply the transform before vite, use an object:
3061
- * `{ order: 'pre', handler: hook }`
3096
+ * Whether to inject a module preload polyfill.
3097
+ * Note: does not apply to library mode.
3098
+ * @default true
3062
3099
  */
3063
- transformIndexHtml?: IndexHtmlTransform;
3100
+ polyfill?: boolean;
3064
3101
  /**
3065
- * Build Environments
3066
- *
3102
+ * Resolve the list of dependencies to preload for a given dynamic import
3067
3103
  * @experimental
3068
3104
  */
3069
- buildApp?: ObjectHook<BuildAppHook>;
3105
+ resolveDependencies?: ResolveModulePreloadDependenciesFn;
3106
+ }
3107
+ interface ResolvedModulePreloadOptions {
3108
+ polyfill: boolean;
3109
+ resolveDependencies?: ResolveModulePreloadDependenciesFn;
3110
+ }
3111
+ type ResolveModulePreloadDependenciesFn = (filename: string, deps: string[], context: {
3112
+ hostId: string;
3113
+ hostType: "html" | "js";
3114
+ }) => string[];
3115
+ interface ResolvedBuildEnvironmentOptions extends Required<Omit<BuildEnvironmentOptions, "polyfillModulePreload">> {
3116
+ modulePreload: false | ResolvedModulePreloadOptions;
3117
+ }
3118
+ interface ResolvedBuildOptions extends Required<Omit<BuildOptions, "polyfillModulePreload">> {
3119
+ modulePreload: false | ResolvedModulePreloadOptions;
3120
+ }
3121
+ /**
3122
+ * Bundles a single environment for production.
3123
+ * Returns a Promise containing the build result.
3124
+ */
3125
+ export declare function build(inlineConfig?: InlineConfig): Promise<RolldownOutput | RolldownOutput[] | RolldownWatcher>;
3126
+ type RenderBuiltAssetUrl = (filename: string, type: {
3127
+ type: "asset" | "public";
3128
+ hostId: string;
3129
+ hostType: "js" | "css" | "html";
3130
+ ssr: boolean;
3131
+ }) => string | {
3132
+ relative?: boolean;
3133
+ runtime?: string;
3134
+ } | undefined;
3135
+ export declare class BuildEnvironment extends BaseEnvironment {
3136
+ mode: "build";
3137
+ isBuilt: boolean;
3138
+ constructor(name: string, config: ResolvedConfig, setup?: {
3139
+ options?: EnvironmentOptions;
3140
+ });
3141
+ init(): Promise<void>;
3142
+ }
3143
+ interface ViteBuilder {
3144
+ environments: Record<string, BuildEnvironment>;
3145
+ config: ResolvedConfig;
3146
+ buildApp(): Promise<void>;
3147
+ build(environment: BuildEnvironment): Promise<RolldownOutput | RolldownOutput[] | RolldownWatcher>;
3148
+ runDevTools(): Promise<void>;
3149
+ }
3150
+ interface BuilderOptions {
3070
3151
  /**
3071
- * Perform custom handling of HMR updates.
3072
- * The handler receives a context containing changed filename, timestamp, a
3073
- * list of modules affected by the file change, and the dev server instance.
3074
- *
3075
- * - The hook can return a filtered list of modules to narrow down the update.
3076
- * e.g. for a Vue SFC, we can narrow down the part to update by comparing
3077
- * the descriptors.
3078
- *
3079
- * - The hook can also return an empty array and then perform custom updates
3080
- * by sending a custom hmr payload via server.ws.send().
3152
+ * Whether to share the config instance among environments to align with the behavior of dev server.
3081
3153
  *
3082
- * - If the hook doesn't return a value, the hmr update will be performed as
3083
- * normal.
3154
+ * @default false
3155
+ * @experimental
3084
3156
  */
3085
- handleHotUpdate?: ObjectHook<(this: MinimalPluginContextWithoutEnvironment, ctx: HmrContext) => Array<ModuleNode> | void | Promise<Array<ModuleNode> | void>>;
3157
+ sharedConfigBuild?: boolean;
3086
3158
  /**
3087
- * This hook is not supported by Rolldown yet. But the type is declared for compatibility.
3159
+ * Whether to share the plugin instances among environments to align with the behavior of dev server.
3088
3160
  *
3089
- * @deprecated This hook is **not** deprecated. It is marked as deprecated just to make it clear that this hook is currently a no-op.
3161
+ * @default false
3162
+ * @experimental
3090
3163
  */
3091
- shouldTransformCachedModule?: ObjectHook<(this: PluginContext, options: {
3092
- code: string;
3093
- id: string;
3094
- meta: CustomPluginOptions;
3095
- moduleSideEffects: boolean | "no-treeshake";
3096
- }) => boolean | null | void>;
3164
+ sharedPlugins?: boolean;
3165
+ buildApp?: (builder: ViteBuilder) => Promise<void>;
3097
3166
  }
3098
- type HookHandler<T> = T extends ObjectHook<infer H> ? H : T;
3099
- type PluginWithRequiredHook<K extends keyof Plugin> = Plugin & { [P in K]: NonNullable<Plugin[P]>; };
3100
- type Thenable<T> = T | Promise<T>;
3101
- type FalsyPlugin = false | null | undefined;
3102
- type PluginOption = Thenable<Plugin | {
3103
- name: string;
3104
- } | FalsyPlugin | PluginOption[]>;
3167
+ type ResolvedBuilderOptions = Required<BuilderOptions>;
3105
3168
  /**
3169
+ * Creates a ViteBuilder to orchestrate building multiple environments.
3106
3170
  * @experimental
3107
3171
  */
3108
- export declare function perEnvironmentPlugin(name: string, applyToEnvironment: (environment: PartialEnvironment) => boolean | Promise<boolean> | PluginOption): Plugin;
3172
+ export declare function createBuilder(inlineConfig?: InlineConfig, useLegacyBuilder?: null | boolean): Promise<ViteBuilder>;
3173
+ type BuildAppHook = (this: MinimalPluginContextWithoutEnvironment, builder: ViteBuilder) => Promise<void>;
3109
3174
  //#endregion
3110
3175
  //#region src/node/idResolver.d.ts
3111
3176
  type ResolveIdFn = (environment: PartialEnvironment, id: string, importer?: string, aliasOnly?: boolean) => Promise<string | undefined>;
@@ -3115,7 +3180,7 @@ type ResolveIdFn = (environment: PartialEnvironment, id: string, importer?: stri
3115
3180
  */
3116
3181
  export declare function createIdResolver(config: ResolvedConfig, options?: Partial<InternalResolveOptions>): ResolveIdFn;
3117
3182
  //#endregion
3118
- //#region ../../node_modules/.pnpm/postcss-load-config@6.0.1_jiti@2.7.0_postcss@8.5.26_tsx@4.23.12_yaml@2.9.0/node_modules/postcss-load-config/src/index.d.ts
3183
+ //#region ../../node_modules/.pnpm/postcss-load-config@6.0.1_jiti@2.7.0_postcss@8.5.26_tsx@4.23.13_yaml@2.9.0/node_modules/postcss-load-config/src/index.d.ts
3119
3184
  type ConfigPlugin = Transformer | PostCSS.Plugin | Processor;
3120
3185
  interface Config {
3121
3186
  parser?: string | ProcessOptions['parser'] | false;
@@ -3248,32 +3313,15 @@ interface JsonOptions {
3248
3313
  stringify?: boolean | "auto";
3249
3314
  }
3250
3315
  //#endregion
3251
- //#region src/node/assetSource.d.ts
3252
- /**
3253
- * Defines which attributes of an HTML element should be treated as asset sources.
3254
- * Used in `html.additionalAssetSources` configuration.
3255
- */
3256
- interface HtmlAssetSource {
3257
- /**
3258
- * Attributes that contain a single asset URL.
3259
- * @example ['src', 'data-src-dark']
3260
- */
3261
- srcAttributes?: string[];
3262
- /**
3263
- * Attributes that contain srcset-format URLs.
3264
- * @example ['srcset', 'imagesrcset']
3265
- */
3266
- srcsetAttributes?: string[];
3267
- /**
3268
- * Called before handling an attribute to determine if it should be processed.
3269
- */
3270
- filter?: (data: HtmlAssetSourceFilterData) => boolean;
3271
- }
3272
- interface HtmlAssetSourceFilterData {
3273
- key: string;
3274
- value: string;
3275
- attributes: Record<string, string>;
3316
+ //#region src/node/plugins/oxc.d.ts
3317
+ interface OxcOptions extends Omit<rolldown_utils_TransformOptions, "cwd" | "sourceType" | "lang" | "sourcemap" | "helpers" | "inject" | "tsconfig" | "inputMap"> {
3318
+ include?: string | RegExp | ReadonlyArray<string | RegExp>;
3319
+ exclude?: string | RegExp | ReadonlyArray<string | RegExp>;
3320
+ jsxInject?: string;
3321
+ jsxRefreshInclude?: string | RegExp | ReadonlyArray<string | RegExp>;
3322
+ jsxRefreshExclude?: string | RegExp | ReadonlyArray<string | RegExp>;
3276
3323
  }
3324
+ export declare function transformWithOxc(code: string, filename: string, options?: rolldown_utils_TransformOptions, inMap?: object, config?: ResolvedConfig, watcher?: FSWatcher): Promise<Omit<rolldown_utils_TransformResult, "errors">>;
3277
3325
  //#endregion
3278
3326
  //#region src/node/ssr/index.d.ts
3279
3327
  type SSRTarget = "node" | "webworker";
@@ -3320,16 +3368,6 @@ interface ResolvedSSROptions extends SSROptions {
3320
3368
  optimizeDeps: SsrDepOptimizationConfig;
3321
3369
  }
3322
3370
  //#endregion
3323
- //#region src/node/plugins/oxc.d.ts
3324
- interface OxcOptions extends Omit<rolldown_utils_TransformOptions, "cwd" | "sourceType" | "lang" | "sourcemap" | "helpers" | "inject" | "tsconfig" | "inputMap"> {
3325
- include?: string | RegExp | ReadonlyArray<string | RegExp>;
3326
- exclude?: string | RegExp | ReadonlyArray<string | RegExp>;
3327
- jsxInject?: string;
3328
- jsxRefreshInclude?: string | RegExp | ReadonlyArray<string | RegExp>;
3329
- jsxRefreshExclude?: string | RegExp | ReadonlyArray<string | RegExp>;
3330
- }
3331
- export declare function transformWithOxc(code: string, filename: string, options?: rolldown_utils_TransformOptions, inMap?: object, config?: ResolvedConfig, watcher?: FSWatcher): Promise<Omit<rolldown_utils_TransformResult, "errors">>;
3332
- //#endregion
3333
3371
  //#region src/node/config.d.ts
3334
3372
  interface ConfigEnv {
3335
3373
  /**
@@ -3494,6 +3532,11 @@ interface UserConfig extends DefaultEnvironmentOptions {
3494
3532
  * @default process.cwd()
3495
3533
  */
3496
3534
  root?: string;
3535
+ /**
3536
+ * Path to the TypeScript configuration file. Relative paths are resolved
3537
+ * from the project root.
3538
+ */
3539
+ tsconfig?: string;
3497
3540
  /**
3498
3541
  * Base public path when served in development or production.
3499
3542
  * @default '/'
@@ -4066,4 +4109,4 @@ export declare const parseAst: typeof parseAst$1;
4066
4109
  export declare const parseAstAsync: typeof parseAstAsync$1;
4067
4110
  export declare const esbuildVersion = "0.25.0";
4068
4111
  //#endregion
4069
- export { type Alias, type AliasOptions, type AnymatchFn, type AnymatchPattern, type AppType, type BindCLIShortcutsOptions, type BuildAppHook, type BuildEnvironmentOptions, type BuildOptions, type BuilderOptions, type CLIShortcut, type CSSModulesOptions, type CSSOptions, type ChunkMetadata, type CommonServerOptions, type ConfigEnv, type ConfigPluginContext, type Connect, type ConnectedPayload, type CorsOptions, type CorsOrigin, type CustomEventMap, type CustomPayload, type CustomPluginOptionsVite, type DepOptimizationConfig, type DepOptimizationMetadata, type DepOptimizationOptions, type DevEnvironmentContext, type DevEnvironmentOptions, type ESBuildOptions, type ESTree, type Environment, type EnvironmentModuleGraph, type EnvironmentModuleNode, type EnvironmentOptions, type ErrorPayload, type EsbuildTransformOptions, type ExperimentalOptions, type ExportsData, type FSWatcher, type FetchFunction, type FetchModuleOptions, type FetchResult, type FetchableDevEnvironment, type FetchableDevEnvironmentContext, type FileSystemServeOptions, type FilterPattern, type FullReloadPayload, type GeneralImportGlobOptions, type HMRPayload, type HTMLOptions, type HmrContext, type HmrOptions, type HookHandler, type HotChannel, type HotChannelClient, type HotChannelListener, type HotPayload, type HotUpdateOptions, type HtmlAssetSource, type HtmlTagDescriptor, type index_d_exports as HttpProxy, type HttpServer, type ImportGlobFunction, type ImportGlobOptions, type IndexHtmlTransform, type IndexHtmlTransformContext, type IndexHtmlTransformHook, type IndexHtmlTransformResult, type InferCustomEventPayload, type InlineConfig, type InternalResolveOptions, type InvalidatePayload, type JsonOptions, type KnownAsTypeMap, type KnownQueryTypeMap, type LegacyOptions, type LessPreprocessorOptions, type LibraryFormats, type LibraryOptions, type LightningCSSOptions, type LogErrorOptions, type LogLevel, type LogOptions, type LogType, type Logger, type LoggerOptions, type Manifest, type ManifestChunk, type MapToFunction, type AnymatchMatcher as Matcher, type MinifyOptions, type MinifyResult, type MinimalPluginContextWithoutEnvironment, type ModuleGraph, type ModuleNode, type ModulePreloadOptions, type ModuleRunnerTransformOptions, type NormalizedHotChannel, type NormalizedHotChannelClient, type NormalizedServerHotChannel, type OptimizedDepInfo, type OxcOptions, type ParseResult, type ParserOptions, type Plugin, type PluginContainer, type PluginHookUtils, type PluginOption, type Config as PostcssUserConfig, type PreprocessCSSResult, type PreviewOptions, type PreviewServer, type PreviewServerHook, type ProxyOptions, type PrunePayload, type RenderBuiltAssetUrl, type ResolveFn, type ResolveModulePreloadDependenciesFn, type ResolveOptions, type ResolvedBuildEnvironmentOptions, type ResolvedBuildOptions, type ResolvedCSSOptions, type ResolvedConfig, type ResolvedDevEnvironmentOptions, type ResolvedModulePreloadOptions, type ResolvedPreviewOptions, type ResolvedSSROptions, type ResolvedServerOptions, type ResolvedServerUrls, type ResolvedUrl, type ResolvedWorkerOptions, type ResolverFunction, type ResolverObject, type Rolldown, type Rollup, type RollupCommonJSOptions, type RollupDynamicImportVarsOptions, type RunnableDevEnvironment, type RunnableDevEnvironmentContext, type SSROptions, type SSRTarget, type SassPreprocessorOptions, type SendOptions, type ServerHook, type ServerHotChannel, type ServerModuleRunnerOptions, type ServerOptions$1 as ServerOptions, type SkipInformation, type SsrDepOptimizationConfig, type StylusPreprocessorOptions, type Terser, type TerserOptions, type TransformOptions, type TransformResult, type Update, type UpdatePayload, type UserConfig, type UserConfigExport, type UserConfigFn, type UserConfigFnObject, type UserConfigFnPromise, Visitor, type VisitorObject, type ViteBuilder, type ViteDevServer, type WatchOptions, type WebSocket, type WebSocketAlias, type WebSocketClient, type WebSocketCustomListener, type WebSocketServer, type WsOptions, DEFAULT_CLIENT_CONDITIONS as defaultClientConditions, DEFAULT_CLIENT_MAIN_FIELDS as defaultClientMainFields, DEFAULT_EXTERNAL_CONDITIONS as defaultExternalConditions, DEFAULT_SERVER_CONDITIONS as defaultServerConditions, DEFAULT_SERVER_MAIN_FIELDS as defaultServerMainFields, esmExternalRequirePlugin, minify, minifySync, ssrTransform as moduleRunnerTransform, parse, parseSync, rolldownVersion, VERSION as version, withFilter };
4112
+ export { type Alias, type AliasOptions, type AnymatchFn, type AnymatchPattern, type AppType, type BindCLIShortcutsOptions, type BuildAppHook, type BuildEnvironmentOptions, type BuildOptions, type BuilderOptions, type CLIShortcut, type CSSModulesOptions, type CSSOptions, type ChunkMetadata, type CommonServerOptions, type ConfigEnv, type ConfigPluginContext, type Connect, type ConnectedPayload, type CorsOptions, type CorsOrigin, type CustomEventMap, type CustomPayload, type CustomPluginOptionsVite, type DepOptimizationConfig, type DepOptimizationMetadata, type DepOptimizationOptions, type DevEnvironmentContext, type DevEnvironmentOptions, type ESBuildOptions, type ESTree, type Environment, type EnvironmentModuleGraph, type EnvironmentModuleNode, type EnvironmentOptions, type ErrorPayload, type EsbuildTransformOptions, type ExperimentalOptions, type ExportsData, type FSWatcher, type FetchFunction, type FetchModuleOptions, type FetchResult, type FetchableDevEnvironment, type FetchableDevEnvironmentContext, type FileSystemServeOptions, type FilterPattern, type FullReloadPayload, type GeneralImportGlobOptions, type HMRPayload, type HTMLOptions, type HmrContext, type HmrOptions, type HookHandler, type HotChannel, type HotChannelClient, type HotChannelListener, type HotPayload, type HotUpdateOptions, type HtmlAssetSource, type HtmlTagDescriptor, type index_d_exports as HttpProxy, type HttpServer, type ImportGlobFunction, type ImportGlobOptions, type IndexHtmlTransform, type IndexHtmlTransformContext, type IndexHtmlTransformHook, type IndexHtmlTransformResult, type InferCustomEventPayload, type InlineConfig, type InternalResolveOptions, type InvalidatePayload, type JsonOptions, type KnownAsTypeMap, type KnownQueryTypeMap, type LegacyOptions, type LessPreprocessorOptions, type LibraryFormats, type LibraryOptions, type LightningCSSOptions, type LogErrorOptions, type LogLevel, type LogOptions, type LogType, type Logger, type LoggerOptions, type Manifest, type ManifestChunk, type MapToFunction, type AnymatchMatcher as Matcher, type MinifyOptions, type MinifyResult, type MinimalPluginContextWithoutEnvironment, type ModuleGraph, type ModuleNode, type ModulePreloadOptions, type ModuleRunnerTransformOptions, type NormalizedHotChannel, type NormalizedHotChannelClient, type NormalizedServerHotChannel, type OptimizedDepInfo, type OxcOptions, type ParseResult, type ParserOptions, type Plugin, type PluginContainer, type PluginHookUtils, type PluginOption, type Config as PostcssUserConfig, type PreprocessCSSResult, type PreviewOptions, type PreviewServer, type PreviewServerHook, type ProxyOptions, type PrunePayload, type RenderBuiltAssetUrl, type ResolveFn, type ResolveModulePreloadDependenciesFn, type ResolveOptions, type ResolvedBuildEnvironmentOptions, type ResolvedBuildOptions, type ResolvedCSSOptions, type ResolvedConfig, type ResolvedDevEnvironmentOptions, type ResolvedModulePreloadOptions, type ResolvedPreviewOptions, type ResolvedSSROptions, type ResolvedServerOptions, type ResolvedServerUrls, type ResolvedUrl, type ResolvedWorkerOptions, type ResolverFunction, type ResolverObject, type Rolldown, type Rollup, type RollupCommonJSOptions, type RollupDynamicImportVarsOptions, type RunnableDevEnvironment, type RunnableDevEnvironmentContext, type SSROptions, type SSRTarget, type SassPreprocessorOptions, type SendOptions, type ServerHook, type ServerHotChannel, type ServerModuleRunnerOptions, type ServerOptions$1 as ServerOptions, type ServerWatchOptions, type SkipInformation, type SsrDepOptimizationConfig, type StylusPreprocessorOptions, type Terser, type TerserOptions, type TransformOptions, type TransformResult, type Update, type UpdatePayload, type UserConfig, type UserConfigExport, type UserConfigFn, type UserConfigFnObject, type UserConfigFnPromise, Visitor, type VisitorObject, type ViteBuilder, type ViteDevServer, type WatchOptions, type WebSocket, type WebSocketAlias, type WebSocketClient, type WebSocketCustomListener, type WebSocketServer, type WsOptions, DEFAULT_CLIENT_CONDITIONS as defaultClientConditions, DEFAULT_CLIENT_MAIN_FIELDS as defaultClientMainFields, DEFAULT_EXTERNAL_CONDITIONS as defaultExternalConditions, DEFAULT_SERVER_CONDITIONS as defaultServerConditions, DEFAULT_SERVER_MAIN_FIELDS as defaultServerMainFields, esmExternalRequirePlugin, minify, minifySync, ssrTransform as moduleRunnerTransform, parse, parseSync, rolldownVersion, VERSION as version, withFilter };