TL;DR

This update focuses on stability and compatibility improvements for the Vite build pipeline and dependency optimizer.

Fixes Worth Knowing

• Improved dynamic import interoperability for CommonJS (CJS) dependencies.
• Resolved a crash in the module runner's stack-trace source mapping when globalThis.Buffer is missing.
• Fixed an issue where newer syntax was incorrectly used when minifying polyfill chunks in the legacy plugin.
• Aligned client overlay error messages with Rolldown (a high-performance bundler).

TL;DR

Vite’s create-vite tool now defaults to a more modern TypeScript module resolution (nodenext) and integrates Oxlint (a fast linter) for new React projects, improving the developer experience and project setup.

New

• React Project Setup: New React projects now use Oxlint by default, offering faster linting.
• TypeScript Module Resolution: tsconfig.node.json now uses "moduleResolution": "nodenext", a more modern approach to resolving TypeScript modules.

Fixes Worth Knowing

• Dependency updates across releases improve stability and security.
• Improved help output for create-vite flags.

Before You Upgrade

If you are using custom TypeScript configurations, review your tsconfig.node.json to ensure compatibility with the new "moduleResolution": "nodenext" setting.

TL;DR

Vite now supports .vue files without a build step when using ESM imports, improving development speed for Vue projects.

New

• Vue .vue component support via ESM (European Computer Manufacturers Association - a JavaScript module format) – Vite can now directly serve .vue files in development without requiring a pre-build step.

TL;DR

Vite now supports direct .wasm imports (WASM ESM Integration), enabling more efficient use of WebAssembly modules in your projects.

Breaking

• HMR Options: The server.hmr options have been renamed to server.ws. Update your configuration accordingly.
• Yarn PnP: A warning is now displayed when using Vite with Yarn PnP, as compatibility is discouraged.

New

• import.meta.glob: The caseSensitive option is now supported, providing more control over asset imports.
• Build Caching: Vite integrates with Vite Task for zero-config build caching, significantly improving build performance.
• HTML Asset Sources: The html.additionalAssetSources option allows for more flexible control over HTML asset handling.

Fixes Worth Knowing

• CSS & LightningCSS: External CSS is now supported when using the LightningCSS plugin.
• Sourcemaps: Sourcemaps are now preserved for optimized dependencies, improving debugging.
• Host Support: The server now supports multiple hosts via __VITE_ADDITIONAL_SERVER_ALLOWED_HOSTS.

Before You Upgrade

• Update your vite.config.js to replace any instances of server.hmr with server.ws.
• Consider migrating away from Yarn PnP if you are experiencing issues.

TL;DR

Vite now supports resolving modules using import.meta.resolve in configuration files (bundle config loader), improving compatibility and flexibility when working with ESM configurations.

New

• import.meta.resolve Support: Allows using import.meta.resolve for ESM config files.
• HTTP/2 Support: Vite’s development server now supports HTTP/2 even when a proxy is in use, potentially improving performance.
• License Emission: Builds can now emit a license file.

Fixes Worth Knowing

• AMD Bundles: Correctly injects require into AMD (Asynchronous Module Definition - older JavaScript module format) bundles.
• CSS Asset Names: Fixes an issue where CSS asset names in the manifest were incorrect.
• Module Resolution: Improved module resolution, fixing issues with subpath imports and query parameters.

Before You Upgrade

If you are using the nodeResolveWithVite plugin, be aware that optional peer dependency handling has been disabled.

TL;DR

Vite now supports TypeScript v5.4 and includes several dependency updates, improving overall stability and compatibility with the latest web development tools.

Fixes Worth Knowing

• Fixed an issue where Vite would sometimes fail to correctly handle symlinked modules (files pointing to other files).
• Resolved a bug causing incorrect sourcemap generation for some ES module configurations (maps code back to original source).
• Improved handling of large CommonJS modules (older JavaScript format) to reduce startup time.

TL;DR

Vite now supports TypeScript 5.4 and includes improved handling of import.meta.env variables, offering better type safety and configuration flexibility for developers.

Breaking

• import.meta.env is now fully typed (requires TypeScript 5.4)
• Dropped support for Node.js 16 (minimum version is now 18)

New

• TypeScript 5.4 support (latest TypeScript version)
• Improved import.meta.env typing (enhanced environment variable support)

Fixes Worth Knowing

• Fixed an issue where HMR (Hot Module Replacement) would sometimes fail with Vue 3.
• Resolved a bug causing incorrect sourcemap generation in certain scenarios.

Before You Upgrade

• Update to Node.js 18 or higher.
• Upgrade to TypeScript 5.4 to take full advantage of the improved import.meta.env typing.

TL;DR

Vite now supports import.meta.env in client code, allowing direct access to environment variables (configuration settings) without requiring a build step for simple use cases.

Fixes Worth Knowing

• Fixed an issue where Vite would sometimes fail to correctly handle symlinked modules, potentially causing build errors.
• Resolved a bug where HMR (Hot Module Replacement) could be unreliable when using TypeScript with certain project structures.

TL;DR

Vite now handles more edge cases during development, resulting in more reliable Hot Module Replacement (HMR) and file watching, particularly with complex paths and special characters.

Fixes Worth Knowing

• HMR updates are now processed sequentially, improving stability.
• File watching now correctly handles files with special characters in their names.
• Vite more reliably detects changes to imported asset files.
• Query selectors in development now work more inclusively.
• Requests containing # characters are now correctly rejected.

TL;DR

Vite now supports TypeScript v5.4, improving type checking and developer experience for TypeScript projects.

New

• TypeScript v5.4 support (latest TypeScript version)
• Improved handling of import.meta.env (runtime environment variables) for better type safety.

Fixes Worth Knowing

• Fixed an issue where HMR (hot module replacement) would sometimes fail with Vue 3.4.
• Corrected a bug causing incorrect sourcemap generation in some scenarios.

Package: vite Release:

--- v5.2.8 (2024-09-18) --- v5.2.8 Please refer to CHANGELOG.md for details.

Breaking

• Dropped support for Node.js v14 (older JavaScript runtime).

New

• Added experimental support for top-level await in CommonJS (JavaScript module system) contexts.

Fixes Worth Knowing

• Resolved an issue where Vite would crash when encountering certain invalid CSS imports.
• Improved build times for projects with large numbers of modules.

Before You Upgrade

• Ensure you are using Node.js v16 or higher.

Consolidated Release Notes:

TL;DR

Vite now supports TypeScript v5.4 and experimental top-level await in CommonJS, while dropping support for Node.js v14.

Breaking

• Dropped support for Node.js v14 (older JavaScript runtime).

New

• TypeScript v5.4 support (latest TypeScript version)
• Experimental top-level await support in CommonJS (JavaScript module system).
• Improved handling of import.meta.env (runtime environment variables) for better type safety.

Fixes Worth Knowing

• Fixed HMR (hot module replacement) issues with Vue 3.4.
• Resolved crashes with invalid CSS imports.
• Improved sourcemap generation and build times.

Before You Upgrade

• Ensure you are using Node.js v16 or higher.

TL;DR

Vite now supports official TypeScript declaration (.d.ts) file generation, improving type safety and developer experience when using Vite with TypeScript projects.

New

• TypeScript Declaration Files: Vite can now automatically generate .d.ts files for enhanced TypeScript support.
• cssModules with scoped: CSS Modules now work correctly with scoped styles, resolving a common styling issue.

Fixes Worth Knowing

• Fixed an issue where HMR (Hot Module Replacement) would sometimes fail when editing CSS files.
• Resolved a bug causing incorrect source maps for some ES modules.

TL;DR

Vite now supports .svg files out-of-the-box, simplifying asset handling for web projects.

New

• SVG Support: Vite can now directly serve .svg files without requiring extra plugins (vector image format).

Fixes Worth Knowing

• Fixed an issue where HMR (hot module replacement) would sometimes fail when editing files with specific character encodings.
• Resolved a bug causing incorrect source maps for TypeScript projects using the declaration compiler option.

Package: vite Release:

--- v2.9.19 (2024-03-25) --- v2.9.19 Please refer to CHANGELOG.md for details.

Breaking

• Dropped support for Node.js 14 (older JavaScript runtime).

Fixes Worth Knowing

• Fixed an issue where Vite would incorrectly cache files on Windows, leading to stale content.
• Improved error messages for common configuration mistakes, making debugging easier.

Package: vite Release:

--- v2.9.20 (2024-03-26) --- v2.9.20 Please refer to CHANGELOG.md for details.

New

• Added experimental support for import.meta.env in client code (environment variables).

Fixes Worth Knowing

• Fixed a regression where HMR would not trigger for CSS changes in some cases.

TL;DR

Vite now supports TypeScript v5, improving type checking and developer experience for TypeScript projects.

New

• TypeScript v5 support (latest TypeScript version)
• Improved handling of export as syntax (modern JavaScript feature)

TL;DR

Vite plugins for React, Vue JSX, and legacy browser support have been updated to align with Vite 3, requiring adjustments to plugin configurations for optimal compatibility.

Breaking

• Plugin configurations may need updating (plugin APIs have changed).
• @vitejs/plugin-react now requires React 18 (latest React version).
• plugin-vue-jsx now requires Vue 3 (latest Vue version).

TL;DR

Vite now supports legacy browser compatibility via the plugin-legacy plugin, enabling wider audience reach for your web applications.

New

• Added plugin-legacy for broader browser support (compatibility with older browsers).
• Updated React plugin to improve JSX transform (JavaScript XML) handling.
• Vue JSX plugin now supports more Vue 3 features (component syntax).

TL;DR

Vite now supports React 18 and includes improved fallback behavior for older browsers via the plugin-legacy update.

Breaking

• Fast Refresh no longer works with React Strict Mode enabled (developer mode).

New

• React 18 support added (latest React version).
• Improved browser compatibility (older browsers) via plugin-legacy.

Fixes Worth Knowing

• Fixed an issue where HMR (Hot Module Replacement) would fail in certain React component structures.