@nuxt/docs-nightly 5.0.0-29558704.e2fc73c4 → 5.0.0-29558810.f465ca09

package/1.getting-started/18.upgrade.md

@@ -349,6 +349,38 @@ If you define redirect route rules, the property name has changed:
 - **Runtime hooks**: `nitroApp.hooks.hook('beforeResponse', ...)` and `nitroApp.hooks.hook('afterResponse', ...)` have been replaced by `nitroApp.hooks.hook('response', ...)`.
 - **`getRouteRules()` from `nitro/app`**: On the server, the Nitro helper changed from `getRouteRules(event)` to `getRouteRules(method, pathname)`, which returns `{ routeRules }`.
 
+### Removal of `experimental.externalVue`
+
+🚦 **Impact Level**: Minimal
+
+#### What Changed
+
+The `experimental.externalVue` option has been removed. Vue compiler dependencies (`@babel/parser`, `@vue/compiler-core`, `@vue/compiler-dom`, `@vue/compiler-ssr`, `estree-walker`) are now always replaced with mock proxies in the server bundle when `vue.runtimeCompiler` is not enabled.
+
+#### Reasons for Change
+
+With the migration to Nitro v3, all dependencies are bundled into the server output by default (unlike Nitro v2, which externalized `node_modules`). The `externalVue` option was originally designed to keep Vue as an external dependency, which was needed to avoid multiple copies of Vue from being bundled, but since Nitro v3 bundles everything regardless, the option became a no-op.
+
+Vue's server builds include the full compiler toolchain, pulling `@babel/parser` (465KB) and other compiler packages into the server bundle unnecessarily. These compiler packages are only needed when `vue.runtimeCompiler` is enabled for runtime template compilation.
+
+By always mocking these compiler dependencies, the default server bundle size is reduced by approximately 860KB (~59%).
+
+#### Migration Steps
+
+If you previously set `experimental.externalVue` explicitly, you should now remove it.
+
+```diff
+  export default defineNuxtConfig({
+    experimental: {
+-     externalVue: false,
+    },
+  })
+```
+
+::note
+If you use `vue.runtimeCompiler: true`, the real compiler packages are still included as before.
+::
+
 ### Removal of Legacy `_renderResponse` Support
 
 🚦 **Impact Level**: Minimal

package/3.guide/6.going-further/1.experimental-features.md

@@ -69,24 +69,6 @@ export default defineNuxtConfig({
 })
 ```
 
-## externalVue
-
-Externalizes `vue`, `@vue/*` and `vue-router` when building.
-
-This flag is enabled by default, but you can disable this feature:
-
-```ts twoslash [nuxt.config.ts]
-export default defineNuxtConfig({
-  experimental: {
-    externalVue: false,
-  },
-})
-```
-
-::warning
-This feature will likely be removed in a near future.
-::
-
 ## extractAsyncDataHandlers
 
 Extracts handler functions from `useAsyncData` and `useLazyAsyncData` calls into separate chunks for improved code splitting and caching efficiency.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nuxt/docs-nightly",
-  "version": "5.0.0-29558704.e2fc73c4",
+  "version": "5.0.0-29558810.f465ca09",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/nuxt/nuxt.git",