@nuxt/docs-nightly 4.5.1-29744085.ef319e7f → 4.5.1-29746779.3590eee2

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

@@ -64,6 +64,7 @@ When you set your `future.compatibilityVersion` to `5`, defaults throughout your
 - **Non-async `callHook`**: [`callHook` may return `void`](/docs/4.x/getting-started/upgrade#non-async-callhook) instead of always returning a `Promise`
 - **Comment node placeholders**: Client-only components use [comment nodes instead of `<div>`](/docs/4.x/getting-started/upgrade#client-only-comment-placeholders) as SSR placeholders, fixing a scoped styles hydration issue
 - **Stricter side-effect imports**: The generated `tsconfig.json` enables [`noUncheckedSideEffectImports`](/docs/4.x/getting-started/upgrade#stricter-side-effect-imports) to match the TypeScript 7 default
+- **Vue Options API disabled**: The [Options API is compiled out of the client bundle](/docs/4.x/getting-started/upgrade#vue-options-api-disabled-by-default) to reduce its size
 - Other Nuxt 5 improvements and changes as they become available
 
 ::note
@@ -309,6 +310,34 @@ export default defineNuxtConfig({
 ```
 ::
 
+### Vue Options API Disabled by Default
+
+🚦 **Impact Level**: Minimal
+
+#### What Changed
+
+With `compatibilityVersion: 5`, Nuxt sets Vue's [`__VUE_OPTIONS_API__`](https://vuejs.org/api/compile-time-flags#VUE_OPTIONS_API) feature flag to `false`, which compiles Vue's Options API runtime out of the client bundle.
+
+#### Reasons for Change
+
+The Options API runtime ships in every client bundle even though most Nuxt applications are written with the Composition API and `<script setup>`. Dropping it shrinks the client bundle (around 6 kB minified / 2 kB gzipped on a minimal app).
+
+#### Migration Steps
+
+If any of your components (or a dependency's components) use the Options API (`export default { data() {}, methods: {}, ... }`), re-enable it in your `nuxt.config`:
+
+```ts twoslash [nuxt.config.ts]
+export default defineNuxtConfig({
+  vue: {
+    optionsApi: true,
+  },
+})
+```
+
+::note
+`defineNuxtComponent` is unaffected: its `asyncData` and `head` options are handled through `setup()` rather than the Vue Options API, so it works regardless of this flag.
+::
+
 ## Migrating to Nuxt 4
 
 Nuxt 4 includes significant improvements and changes. This guide will help you migrate your existing Nuxt 3 application to Nuxt 4.

package/4.api/3.utils/define-route-rules.md

@@ -43,7 +43,10 @@ When running [`nuxt build`](/docs/4.x/api/commands/build), the home page will be
 ## Notes
 
 - A rule defined in `~/pages/foo/bar.vue` will be applied to `/foo/bar` requests.
-- A rule in `~/pages/foo/[id].vue` will be applied to `/foo/**` requests.
+- A rule in `~/pages/foo/[id].vue` will be applied to `/foo/*` requests.
+- A rule in a page with a finite set of alternatives, such as a custom `path` of `/:locale(en|fr)/about`, will generate one rule per alternative (`/en/about` and `/fr/about`).
+
+If a page path cannot be converted to an equivalent route rule pattern (for example, a param with a regular expression like `/:id(\d+)`, a partial segment like `/prefix-:id`, or a repeatable param like `/:slug+`), the rules for that page are **not** applied and Nuxt warns during build. In that case, define the rules explicitly in `nitro.routeRules` in your `nuxt.config`.
 
 For more control, such as if you are using a custom `path` or `alias` set in the page's [`definePageMeta`](/docs/4.x/api/utils/define-page-meta), you should set `routeRules` directly within your `nuxt.config`.
 

package/4.api/6.nuxt-config.md

@@ -107,6 +107,28 @@ This can also be set at runtime by setting the NUXT_APP_BASE_URL environment var
 NUXT_APP_BASE_URL=/prefix/ node .output/server/index.mjs
 ```
 
+::note
+Relative paths (like `./`) are not supported directly in `nuxt.config.ts` due to Nitro limitations. For static hosting with relative asset paths, use one of these approaches:
+
+```bash
+# Option 1: Environment variable at build time
+NUXT_APP_BASE_URL=./ npm run generate
+```
+
+```ts
+// Option 2: Nitro runtime config
+export default defineNuxtConfig({
+  nitro: {
+    runtimeConfig: {
+      app: {
+        baseURL: './',
+      },
+    },
+  },
+})
+```
+::
+
 ### `buildAssetsDir`
 
 The folder name for the built site assets, relative to `baseURL` (or `cdnURL` if set). This is set at build time and should not be customized at runtime.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nuxt/docs-nightly",
-  "version": "4.5.1-29744085.ef319e7f",
+  "version": "4.5.1-29746779.3590eee2",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/nuxt/nuxt.git",