nuxt/nuxt (@nuxt/kit)
### [`v3.13.0`](https://togithub.com/nuxt/nuxt/releases/tag/v3.13.0)
[Compare Source](https://togithub.com/nuxt/nuxt/compare/v3.12.4...v3.13.0)
##### 👀 Highlights
I'm pretty excited about this release - we've ported some features we had planned for Nuxt v4 back to v3, as well as a raft of bug fixes and performance improvements - as usual.
Here are a few of things I'm most excited about.
##### 🏘️ Route Groups
We now support naming directories with parentheses/brackets to organise your routes without affecting the path.
For example:
```bash [Directory structure]
-| pages/
---| index.vue
---| (marketing)/
-----| about.vue
-----| contact.vue
```
This will produce `/`, `/about` and `/contact` pages in your app. The `marketing` group is ignored for purposes of your URL structure.
Read more in [the original PR](https://togithub.com/nuxt/nuxt/pull/28276).
##### 🏝️ Islands and Head Metadata
It's now possible for server component islands to manipulate the head, such as by adding SEO metadata when rendering.
Read more in [#27987](https://togithub.com/nuxt/nuxt/pull/27987).
##### 🪝 Custom Prefetch Triggers
We now support custom prefetch triggers for `NuxtLink` ([#27846](https://togithub.com/nuxt/nuxt/pull/27846)).
For example:
```vue [pages/index.vue]
This will prefetch when hovered or when it gains focus
This will prefetch when hovered/focus - or when it becomes visible
```
It's also possible to enable/disable these globally for your app and override them per link.
For example:
```ts [nuxt.config.ts]
export default defineNuxtConfig({
experimental: {
defaults: {
nuxtLink: {
prefetch: true,
prefetchOn: { visibility: false, interaction: true }
}
}
}
})
```
##### 🗺️ Better Server Source Maps
When running with `node --enable-source-maps`, you may have noticed that the source maps for the Vue files in your server build pointed to the Vite build output (something like `.nuxt/dist/server/_nuxt/index-O15BBwZ3.js`).
Now, even after your Nitro build, your server source maps will reference your original source files ([#28521](https://togithub.com/nuxt/nuxt/pull/28521)).
Note that one of the easiest ways of improving your build performance is to turn off source maps if you aren't using them, which you can do easily in your `nuxt.config`:
```ts [nuxt.config.ts]
export default defineNuxtConfig({
sourcemap: {
server: false,
client: true,
},
})
```
##### 🎁 New Features for Module Authors
In the run-up to Nuxt v4, we're working on adding some key functionality for module authors, including a new `isNuxtMajorVersion` utility where required ([#27579](https://togithub.com/nuxt/nuxt/pull/27579)) and better inferred typing for merged module options using the new `defineNuxtModule().with()` method ([#27520](https://togithub.com/nuxt/nuxt/pull/27520)).
##### ✨ Improved Dev Warnings
We no longer warn when using data fetching composables in middleware ([#28604](https://togithub.com/nuxt/nuxt/pull/28604)) and we warn when user components' names begin with Lazy ([#27838](https://togithub.com/nuxt/nuxt/pull/27838)).
##### 🚨 Vue TypeScript Changes
For a while, in the Vue ecosystem, we've been augmenting `@vue/runtime-core` to add custom properties and more to `vue`. However, this inadvertently breaks the types for projects that augment `vue` - which is now the officially recommended in the docs way to augment these interfaces (for example, [ComponentCustomProperties](https://vuejs.org/api/utility-types.html#componentcustomproperties), [GlobalComponents](https://vuejs.org/guide/extras/web-components.html#web-components-and-typescript) and [so on](https://vuejs.org/guide/typescript/options-api.html#augmenting-global-properties)).
This means *all* libraries must update their code (or it will break the types of libraries that augment `vue` instead).
We've updated our types in Nuxt along these lines but you may experience issues with the latest `vue-router` when used with libraries which haven't yet done so.
Please create an issue with a reproduction - I'll happily help create a PR to resolve in the upstream library in question. Or you may be able to work around the issue by creating a `declarations.d.ts` in the root of your project with the following code ([credit]()):
```ts [declarations.d.ts]
import type {
ComponentCustomOptions as _ComponentCustomOptions,
ComponentCustomProperties as _ComponentCustomProperties,
} from 'vue';
declare module '@vue/runtime-core' {
interface ComponentCustomProperties extends _ComponentCustomProperties {}
interface ComponentCustomOptions extends _ComponentCustomOptions {}
}
```
##### ✅ Upgrading
As usual, our recommendation for upgrading is to run:
```sh
npx nuxi@latest upgrade --force
```
This will refresh your lockfile as well, and ensures that you pull in updates from other dependencies that Nuxt relies on, particularly in the unjs ecosystem.
##### 👉 Changelog
[compare changes](https://togithub.com/nuxt/nuxt/compare/v3.12.4...v3.13.0)
##### 🚀 Enhancements
- **nuxt:** Await custom `routes` function in `router.options` ([#27644](https://togithub.com/nuxt/nuxt/pull/27644))
- **kit:** Add new `isNuxtMajorVersion` compatibility util ([#27579](https://togithub.com/nuxt/nuxt/pull/27579))
- **kit,schema:** Add `.with` for better module options types ([#27520](https://togithub.com/nuxt/nuxt/pull/27520))
- **nuxt:** Warn when user components' names begin with `Lazy` ([#27838](https://togithub.com/nuxt/nuxt/pull/27838))
- **nuxt:** Allow specifying app id when creating a nuxt app ([#28392](https://togithub.com/nuxt/nuxt/pull/28392))
- **nuxt:** Custom enable/disable hooks for `usePreviewMode` ([#28371](https://togithub.com/nuxt/nuxt/pull/28371))
- **kit:** Add `prepend` option to `addRouteMiddleware` ([#28496](https://togithub.com/nuxt/nuxt/pull/28496))
- **nuxt:** Allow organising pages within route groups ([#28276](https://togithub.com/nuxt/nuxt/pull/28276))
- **vite:** Preserve vite sourcemaps for nitro build ([#28521](https://togithub.com/nuxt/nuxt/pull/28521))
- **nuxt:** Allow defining triggers for prefetching links ([#27846](https://togithub.com/nuxt/nuxt/pull/27846))
- **nuxt:** Namespace `__NUXT__` when using multi-app ([#27263](https://togithub.com/nuxt/nuxt/pull/27263))
- **nuxt:** Allow server islands to manipulate head ([#27987](https://togithub.com/nuxt/nuxt/pull/27987))
##### 🔥 Performance
- **nuxt:** Call cookie `decode` function only for named cookie ([#28215](https://togithub.com/nuxt/nuxt/pull/28215))
- **nuxt:** Avoid making client-only component setup async ([#28334](https://togithub.com/nuxt/nuxt/pull/28334))
- **nuxt:** Avoid multiple calls to `getCachedData` ([#28472](https://togithub.com/nuxt/nuxt/pull/28472))
##### 🩹 Fixes
- **nuxt:** Don't warn for `definePageMeta` in client-only pages ([#28246](https://togithub.com/nuxt/nuxt/pull/28246))
- **kit:** Include module `dist/runtime/` in tsconfig includes ([#28237](https://togithub.com/nuxt/nuxt/pull/28237))
- **schema:** Support absolute/relative paths for `assetsDir` ([59f0099f4](https://togithub.com/nuxt/nuxt/commit/59f0099f4))
- **schema:** Do not override user `serverDir` ([#28249](https://togithub.com/nuxt/nuxt/pull/28249))
- **schema:** Use new options syntax for `vite-plugin-vue` ([#28307](https://togithub.com/nuxt/nuxt/pull/28307))
- **schema:** Export new module return types ([c0ad8db93](https://togithub.com/nuxt/nuxt/commit/c0ad8db93))
- **kit:** Add missing type import ([1a60b4541](https://togithub.com/nuxt/nuxt/commit/1a60b4541))
- **vite,webpack:** Handle local postcss plugins ([#28481](https://togithub.com/nuxt/nuxt/pull/28481))
- **nuxt:** Handle `scroll-padding-top: auto` in scrollBehavior ([#28320](https://togithub.com/nuxt/nuxt/pull/28320))
- **nuxt:** Ensure `runtimeConfig.public` is reactive on client ([#28443](https://togithub.com/nuxt/nuxt/pull/28443))
- **nuxt:** Update renamed stub composables from `nuxt/scripts` ([#28449](https://togithub.com/nuxt/nuxt/pull/28449))
- **nuxt:** Augment `@vue/runtime-core` and `@vue/runtime-dom` ([#28446](https://togithub.com/nuxt/nuxt/pull/28446))
- **nuxt:** Scan jsx pages for page metadata ([#28479](https://togithub.com/nuxt/nuxt/pull/28479))
- **nuxt:** Handle plugin type extensions more correctly ([#28480](https://togithub.com/nuxt/nuxt/pull/28480))
- **vite:** Respect `baseURL` for public assets in dev ([#28482](https://togithub.com/nuxt/nuxt/pull/28482))
- **vite:** Add transformation result to log for parse errors ([#28508](https://togithub.com/nuxt/nuxt/pull/28508))
- **vite:** Include module symbols in generated code ([#28509](https://togithub.com/nuxt/nuxt/pull/28509))
- **nuxt:** Add reason when aborting request in `useFetch` ([#28517](https://togithub.com/nuxt/nuxt/pull/28517))
- **nuxt:** Only augment `vue`, not sub-packages ([#28542](https://togithub.com/nuxt/nuxt/pull/28542))
- **nuxt:** Avoid stripping js extensions in plugin injections ([#28593](https://togithub.com/nuxt/nuxt/pull/28593))
- **nuxt:** Preserve route-specific metadata on `route.meta` ([#28441](https://togithub.com/nuxt/nuxt/pull/28441))
- **nuxt:** Don't warn when data fetching in middleware ([#28604](https://togithub.com/nuxt/nuxt/pull/28604))
- **nuxt:** Extract route rules/page meta in 2+ script blocks ([#28625](https://togithub.com/nuxt/nuxt/pull/28625))
- **nuxt:** Allow customising status code in `validate` method ([#28612](https://togithub.com/nuxt/nuxt/pull/28612))
- **nuxt:** Do not provide default `prefetchOn` prop ([#28630](https://togithub.com/nuxt/nuxt/pull/28630))
- **nuxt:** Revert back to object syntax for island head ([#28656](https://togithub.com/nuxt/nuxt/pull/28656))
##### 📖 Documentation
- Fix issue in cookie passing example ([#28223](https://togithub.com/nuxt/nuxt/pull/28223))
- Fix note in layers usage chapter ([#28236](https://togithub.com/nuxt/nuxt/pull/28236))
- Fix spaces ([#28233](https://togithub.com/nuxt/nuxt/pull/28233))
- Add `vue` lang to sample code ([#28247](https://togithub.com/nuxt/nuxt/pull/28247))
- Use `splitSetCookieString` from `cookie-es` ([29f95ae0d](https://togithub.com/nuxt/nuxt/commit/29f95ae0d))
- Use `headers.getSetCookie` ([45c6df9a4](https://togithub.com/nuxt/nuxt/commit/45c6df9a4))
- Fix codemod command typos ([#28279](https://togithub.com/nuxt/nuxt/pull/28279))
- `bunx` -> `bun x` ([#28277](https://togithub.com/nuxt/nuxt/pull/28277))
- Add missing comma to example ([#28300](https://togithub.com/nuxt/nuxt/pull/28300))
- Add language to example schema codeblock ([#28294](https://togithub.com/nuxt/nuxt/pull/28294))
- Update link to RuntimeNuxtHooks ([#28336](https://togithub.com/nuxt/nuxt/pull/28336))
- Update links to social media ([cd5195047](https://togithub.com/nuxt/nuxt/commit/cd5195047))
- Setup host property and usage example ([#28331](https://togithub.com/nuxt/nuxt/pull/28331))
- Fix TypeScript errors for examples ([#28403](https://togithub.com/nuxt/nuxt/pull/28403))
- Improve readability of link to mdn ([#28327](https://togithub.com/nuxt/nuxt/pull/28327))
- Use ts for create-error example ([#28411](https://togithub.com/nuxt/nuxt/pull/28411))
- Alias links in jsdoc `@see` blocks ([#28270](https://togithub.com/nuxt/nuxt/pull/28270))
- Link to vue test utils docs for `mountSuspended` ([#28463](https://togithub.com/nuxt/nuxt/pull/28463))
- Remove vue-tsc major version constraint ([#28484](https://togithub.com/nuxt/nuxt/pull/28484))
- Recommend '#teleports' target instead of 'body' ([#28489](https://togithub.com/nuxt/nuxt/pull/28489))
- Correct custom routing link ([#28497](https://togithub.com/nuxt/nuxt/pull/28497))
- Improve typing of default exports ([#28520](https://togithub.com/nuxt/nuxt/pull/28520))
- Fix `options` type in custom useFetch recipe ([#28389](https://togithub.com/nuxt/nuxt/pull/28389))
- Update useRuntimeConfig source path ([#28553](https://togithub.com/nuxt/nuxt/pull/28553))
- Add line-breaks to tips in Module Author Guide ([#28587](https://togithub.com/nuxt/nuxt/pull/28587))
- Update nuxt scripts status ([#28629](https://togithub.com/nuxt/nuxt/pull/28629))
##### 🏡 Chore
- **schema:** Fix typo ([#28377](https://togithub.com/nuxt/nuxt/pull/28377))
- **nuxt:** Use router code reference permalink ([#28356](https://togithub.com/nuxt/nuxt/pull/28356))
- **nuxt:** Remove unnecessary await ([#28407](https://togithub.com/nuxt/nuxt/pull/28407))
- Upgrade vue in a separate pr ([#28414](https://togithub.com/nuxt/nuxt/pull/28414))
- Update docs typecheck command ([49de5f731](https://togithub.com/nuxt/nuxt/commit/49de5f731))
- Lint ([cab9e5c35](https://togithub.com/nuxt/nuxt/commit/cab9e5c35))
- Fix some typos in comments ([#28501](https://togithub.com/nuxt/nuxt/pull/28501))
##### ✅ Tests
- Disable `pageTransition` in client-only page ([#27839](https://togithub.com/nuxt/nuxt/pull/27839))
- Ignore `SharedComponent` in server head ([510f3e28f](https://togithub.com/nuxt/nuxt/commit/510f3e28f))
- Update bundle size ([3ecb95a7c](https://togithub.com/nuxt/nuxt/commit/3ecb95a7c))
##### 🤖 CI
- Add reproduire-sur-stackblitz workflow ([#28531](https://togithub.com/nuxt/nuxt/pull/28531))
##### ❤️ Contributors
- Daniel Roe ([@danielroe](https://togithub.com/danielroe))
- Julien Huang ([@huang-julien](https://togithub.com/huang-julien))
- Maxime Pauvert ([@maximepvrt](https://togithub.com/maximepvrt))
- felix-dolderer ([@felix-dolderer](https://togithub.com/felix-dolderer))
- Nicolas Payot ([@nicolaspayot](https://togithub.com/nicolaspayot))
- Kewin Szlezingier ([@kewinzaq1](https://togithub.com/kewinzaq1))
- Vasily Kuzin ([@ExEr7um](https://togithub.com/ExEr7um))
- xjccc ([@xjccc](https://togithub.com/xjccc))
- Martin André ([@Martichou](https://togithub.com/Martichou))
- Mike Laumann Bellika ([@MikeBellika](https://togithub.com/MikeBellika))
- Typed SIGTERM ([@typed-sigterm](https://togithub.com/typed-sigterm))
- Horu ([@HigherOrderLogic](https://togithub.com/HigherOrderLogic))
- Son Tran ([@trandaison](https://togithub.com/trandaison))
- rubyisrust ([@rubyisrust](https://togithub.com/rubyisrust))
- Matej Černý ([@CernyMatej](https://togithub.com/CernyMatej))
- Riley Ho ([@rileychh](https://togithub.com/rileychh))
- Adam DeHaven ([@adamdehaven](https://togithub.com/adamdehaven))
- Potter ([@yxw007](https://togithub.com/yxw007))
- Martin Masevski ([@Archetipo95](https://togithub.com/Archetipo95))
- BoogieBen. ([@boogie-ben](https://togithub.com/boogie-ben))
- Tobias Diez ([@tobiasdiez](https://togithub.com/tobiasdiez))
- Michael Brevard ([@GalacticHypernova](https://togithub.com/GalacticHypernova))
- Damian Głowala ([@DamianGlowala](https://togithub.com/DamianGlowala))
- Lucie ([@lihbr](https://togithub.com/lihbr))
- Yasser Lahbibi ([@yassilah](https://togithub.com/yassilah))
- Sébastien Chopin ([@atinux](https://togithub.com/atinux))
- [@beer](https://togithub.com/beer) ([@iiio2](https://togithub.com/iiio2))
- AuroraTea ([@AuroraTea](https://togithub.com/AuroraTea))
- Bobbie Goede ([@BobbieGoede](https://togithub.com/BobbieGoede))
- Alexander Lichter ([@manniL](https://togithub.com/manniL))
- nuxt-studio\[bot] ([@nuxt-studio](https://togithub.com/nuxt-studio)\[bot])
- Vaci ([@vacijj](https://togithub.com/vacijj))
- FELIPE COSTA DE OLIVEIRA ([@FelipeO16](https://togithub.com/FelipeO16))
- 一纸忘忧 ([@ikxin](https://togithub.com/ikxin))
- Meo ([@miaobuao](https://togithub.com/miaobuao))
- Mohab Sameh ([@mohab-sameh](https://togithub.com/mohab-sameh))
- Quentin Macq ([@quentinmcq](https://togithub.com/quentinmcq))
- Johan Krijt ([@johankrijt](https://togithub.com/johankrijt))
### [`v3.12.4`](https://togithub.com/nuxt/nuxt/releases/tag/v3.12.4)
[Compare Source](https://togithub.com/nuxt/nuxt/compare/v3.12.3...v3.12.4)
> 3.12.4 is the next regularly scheduled patch release.
#### 👉 Changelog
[compare changes](https://togithub.com/nuxt/nuxt/compare/v3.12.3...v3.12.4)
##### 🔥 Performance
- **vite:** Start warmups after nitro build ([#27963](https://togithub.com/nuxt/nuxt/pull/27963))
- **vite:** Avoid extra resolve call for `resolveId` in layers ([#27971](https://togithub.com/nuxt/nuxt/pull/27971))
- **kit,nuxt,schema,vite,webpack:** Use explicit exports ([#27998](https://togithub.com/nuxt/nuxt/pull/27998))
##### 🩹 Fixes
- **schema:** Resolve public alias correctly ([#27975](https://togithub.com/nuxt/nuxt/pull/27975))
- **nuxt:** Omit rendering payload prefetch when `noScripts` ([#27972](https://togithub.com/nuxt/nuxt/pull/27972))
- **nuxt:** Add `/` as fallback if page can't be identified ([e6109b226](https://togithub.com/nuxt/nuxt/commit/e6109b226))
- **ui-templates:** Validate templates with `html-validate` ([#28024](https://togithub.com/nuxt/nuxt/pull/28024))
- **schema:** Don't constrain postcss plugin options ([#28045](https://togithub.com/nuxt/nuxt/pull/28045))
- **kit:** Remove exports from v4 branch ([5c8312e9b](https://togithub.com/nuxt/nuxt/commit/5c8312e9b))
- **nuxt:** Use `unhead` key for ad-hoc module options ([#28088](https://togithub.com/nuxt/nuxt/pull/28088))
- **nuxt:** Use native vue-router composables ([#28114](https://togithub.com/nuxt/nuxt/pull/28114))
- **kit:** Ensure `getNuxtVersion` returns `string` ([#28125](https://togithub.com/nuxt/nuxt/pull/28125))
- **nuxt:** Always prerender at least one page with crawler ([#28131](https://togithub.com/nuxt/nuxt/pull/28131))
- **nuxt:** Consider doc `scroll-padding-top` in scrollBehavior ([#28083](https://togithub.com/nuxt/nuxt/pull/28083))
- **nuxt:** Only warn when `useAsyncData` returns undefined ([#28154](https://togithub.com/nuxt/nuxt/pull/28154))
- **nuxt:** Revert change to `getCachedData` null response ([d10cea11b](https://togithub.com/nuxt/nuxt/commit/d10cea11b))
- **schema:** Don't use `app/` as `srcDir` if it doesn't exist ([#28176](https://togithub.com/nuxt/nuxt/pull/28176))
- **kit:** Normalise `serverDir` within layers using v4 compat ([#28177](https://togithub.com/nuxt/nuxt/pull/28177))
- **nuxt:** Allow `getCachedData` to return undefined ([#28187](https://togithub.com/nuxt/nuxt/pull/28187))
- **nuxt:** Use `addEventListener` to register cookie store listener ([#28193](https://togithub.com/nuxt/nuxt/pull/28193))
- **nuxt:** Merge route meta properties with scanned meta ([#28170](https://togithub.com/nuxt/nuxt/pull/28170))
- **nuxt:** Prevent duplicate `set-cookie` headers ([#28211](https://togithub.com/nuxt/nuxt/pull/28211))
##### 💅 Refactors
- **schema,vite,webpack:** Rework `postcss` module loading ([#27946](https://togithub.com/nuxt/nuxt/pull/27946))
- **nuxt:** Remove `_registeredComponents` from ssrContext ([#27819](https://togithub.com/nuxt/nuxt/pull/27819))
- **nuxt:** Use `errx` to handle dev log traces ([#28027](https://togithub.com/nuxt/nuxt/pull/28027))
##### 📖 Documentation
- Fix link ([83bd4fde9](https://togithub.com/nuxt/nuxt/commit/83bd4fde9))
- Fix Cloudflare spelling ([#27989](https://togithub.com/nuxt/nuxt/pull/27989))
- Update example to use `nuxtApp.runWithContext` ([#28000](https://togithub.com/nuxt/nuxt/pull/28000))
- Remove deprecated `pending` variable from data fetching docs ([#28011](https://togithub.com/nuxt/nuxt/pull/28011))
- Clarify xrsp danger ([#28053](https://togithub.com/nuxt/nuxt/pull/28053))
- Deprecate pending and emphasis undefined ([#28113](https://togithub.com/nuxt/nuxt/pull/28113))
- Update phrasing in route announcer ([#28108](https://togithub.com/nuxt/nuxt/pull/28108))
- Use code groups for install commands in module guide ([#28094](https://togithub.com/nuxt/nuxt/pull/28094))
- Capitalize text ([#28056](https://togithub.com/nuxt/nuxt/pull/28056))
- Mention content in upgrade guide v4 folder structure ([#28090](https://togithub.com/nuxt/nuxt/pull/28090))
- Remove a resolved issue from view transition docs ([#28091](https://togithub.com/nuxt/nuxt/pull/28091))
- Clarify navigateTo is not for nitro routes ([#28092](https://togithub.com/nuxt/nuxt/pull/28092))
- Warn about nested islands ([#28062](https://togithub.com/nuxt/nuxt/pull/28062))
- Add info about `layers/` directory ([#28128](https://togithub.com/nuxt/nuxt/pull/28128))
- Codemods for migrating to Nuxt 4 ([#28072](https://togithub.com/nuxt/nuxt/pull/28072))
##### ✅ Tests
- Add `typeCheck` test in minimal build ([#28166](https://togithub.com/nuxt/nuxt/pull/28166))
##### 🤖 CI
- Run prepare step before linting docs ([f8fbefb42](https://togithub.com/nuxt/nuxt/commit/f8fbefb42))
- Run prepare step before linting docs ([d629b82b3](https://togithub.com/nuxt/nuxt/commit/d629b82b3))
##### ❤️ Contributors
- Daniel Roe ([@danielroe](https://togithub.com/danielroe))
- arshcodemod ([@arshcodemod](https://togithub.com/arshcodemod))
- xjccc ([@xjccc](https://togithub.com/xjccc))
- Julien Huang ([@huang-julien](https://togithub.com/huang-julien))
- BoogieBen ([@boogie-ben](https://togithub.com/boogie-ben))
- Santiago A ([@santiagoaloi](https://togithub.com/santiagoaloi))
- Bobbie Goede ([@BobbieGoede](https://togithub.com/BobbieGoede))
- John Tanzer ([@moshetanzer](https://togithub.com/moshetanzer))
- Thomas ([@ThomasWT](https://togithub.com/ThomasWT))
- [@beer](https://togithub.com/beer) ([@iiio2](https://togithub.com/iiio2))
- Dominic ([@rexhent](https://togithub.com/rexhent))
- Alex Liu ([@Mini-ghost](https://togithub.com/Mini-ghost))
- Florian Metz ([@Timeraa](https://togithub.com/Timeraa))
- Liran Tal ([@lirantal](https://togithub.com/lirantal))
- Daniel Kelly ([@danielkellyio](https://togithub.com/danielkellyio))
- Daniel Flanagan ([@FlantasticDan](https://togithub.com/FlantasticDan))
- 山吹色御守 ([@KazariEX](https://togithub.com/KazariEX))
- izzy goldman ([@izzygld](https://togithub.com/izzygld))
- Anthony Fu ([@antfu](https://togithub.com/antfu))
### [`v3.12.3`](https://togithub.com/nuxt/nuxt/releases/tag/v3.12.3)
[Compare Source](https://togithub.com/nuxt/nuxt/compare/v3.12.2...v3.12.3)
> 3.12.3 is the next regularly scheduled patch release.
#### 👉 Changelog
[compare changes](https://togithub.com/nuxt/nuxt/compare/v3.12.2...v3.12.3)
##### 🔥 Performance
- **nuxt,vite:** Use native fs utils rather than `fs-extra` ([#27787](https://togithub.com/nuxt/nuxt/pull/27787))
- **schema:** Use `chokidar` when a custom `srcDir` is provided ([#27871](https://togithub.com/nuxt/nuxt/pull/27871))
- **nuxt:** Ensure `prefetchComponents` is treeshaken on server ([#27905](https://togithub.com/nuxt/nuxt/pull/27905))
##### 🩹 Fixes
- **nuxt:** Flag async data promise as cancelled only if defined ([#27690](https://togithub.com/nuxt/nuxt/pull/27690))
- **schema:** Handle backwards compat for `dir.app` ([0c73cb734](https://togithub.com/nuxt/nuxt/commit/0c73cb734))
- **nuxt:** Support hoisting types of subpath imports ([#27720](https://togithub.com/nuxt/nuxt/pull/27720))
- **nuxt:** Resolve routes when `navigateTo` called with `open` ([#27742](https://togithub.com/nuxt/nuxt/pull/27742))
- **nuxt:** Handle subpaths more correctly ([d7402a799](https://togithub.com/nuxt/nuxt/commit/d7402a799))
- **nuxt:** Delay navigation until user input is acknowledged ([#27743](https://togithub.com/nuxt/nuxt/pull/27743))
- **nuxt:** Resolve aliases used in nitro plugin paths ([#27741](https://togithub.com/nuxt/nuxt/pull/27741))
- **schema:** Do not use full path assets/public aliases ([d0518650f](https://togithub.com/nuxt/nuxt/commit/d0518650f))
- **nuxt:** Defer registering inp handler until nuxt is mounted ([866a5319a](https://togithub.com/nuxt/nuxt/commit/866a5319a))
- **nuxt:** Add `refresh` type in server component refs ([#27778](https://togithub.com/nuxt/nuxt/pull/27778))
- **nuxt:** Extract all-literal page meta ([#27821](https://togithub.com/nuxt/nuxt/pull/27821))
- **kit:** Handle loading nuxt 4+ ([cf251bd48](https://togithub.com/nuxt/nuxt/commit/cf251bd48))
- **nuxt:** Handle external links to named route objects ([#27829](https://togithub.com/nuxt/nuxt/pull/27829))
- **nuxt:** Use URL to encode redirected URLs ([#27822](https://togithub.com/nuxt/nuxt/pull/27822))
- **nuxt:** Don't use app version when verifying nuxt deps ([#27864](https://togithub.com/nuxt/nuxt/pull/27864))
- **nuxt:** Prompt to set compatibility date with latest nitro ([#27893](https://togithub.com/nuxt/nuxt/pull/27893))
- **nuxt:** Add `#vue-router` alias for backwards compat ([#27896](https://togithub.com/nuxt/nuxt/pull/27896))
- **nuxt:** Move app augments to core `nuxt` types ([#27900](https://togithub.com/nuxt/nuxt/pull/27900))
- **nuxt:** Pass augmented pages to child paths ([ecb35d3a2](https://togithub.com/nuxt/nuxt/commit/ecb35d3a2))
- **nuxt:** Use pascal name when loading server component ([#27928](https://togithub.com/nuxt/nuxt/pull/27928))
- **nuxt:** Improve async data warning ([#27874](https://togithub.com/nuxt/nuxt/pull/27874), [#27934](https://togithub.com/nuxt/nuxt/pull/27934))
- **nuxt:** Allow configuring server components in modules ([#27936](https://togithub.com/nuxt/nuxt/pull/27936))
- **vite:** Omit css `?raw` from head when in dev mode ([#27940](https://togithub.com/nuxt/nuxt/pull/27940))
- **kit,nuxt:** Ensure webworker types are available ([4cab71d66](https://togithub.com/nuxt/nuxt/commit/4cab71d66))
- **nuxt:** Seed crawler when prerendering pages ([#27955](https://togithub.com/nuxt/nuxt/pull/27955))
- **vite:** Fix type issue with legacy dev bundler ([f9fa1a3e9](https://togithub.com/nuxt/nuxt/commit/f9fa1a3e9))
- **nuxt:** Improve dx around compatibility date prompt ([#27965](https://togithub.com/nuxt/nuxt/pull/27965))
##### 💅 Refactors
- **kit,nuxt:** Use `performance.now` to measure time ([d14f7ec46](https://togithub.com/nuxt/nuxt/commit/d14f7ec46))
##### 📖 Documentation
- Add referral query variable to Vue School Links ([#27670](https://togithub.com/nuxt/nuxt/pull/27670))
- Fix variable name ([#27675](https://togithub.com/nuxt/nuxt/pull/27675))
- Clarify how transitions are configured globally ([#27679](https://togithub.com/nuxt/nuxt/pull/27679))
- Remove outdated recommendation ([#27691](https://togithub.com/nuxt/nuxt/pull/27691))
- Add `refreshCookie` on `useCookie` doc page ([#27744](https://togithub.com/nuxt/nuxt/pull/27744))
- Sync changes from `main` branch ([e7fbc9f81](https://togithub.com/nuxt/nuxt/commit/e7fbc9f81))
- Remove outdated tip ([#27773](https://togithub.com/nuxt/nuxt/pull/27773))
- Warn about awaiting `useFetch`/`AsyncData` in wrappers ([#27785](https://togithub.com/nuxt/nuxt/pull/27785))
- Update some code groups with package manager examples ([#27791](https://togithub.com/nuxt/nuxt/pull/27791))
- Hint to use runtime config ([#27859](https://togithub.com/nuxt/nuxt/pull/27859))
- Use internal link ([#27883](https://togithub.com/nuxt/nuxt/pull/27883))
- Update links to `vue-router` docs ([#27895](https://togithub.com/nuxt/nuxt/pull/27895))
- Use internal link ([#27894](https://togithub.com/nuxt/nuxt/pull/27894))
- Remove warning about type checking ([#27911](https://togithub.com/nuxt/nuxt/pull/27911))
- `compatibilityVersion` is available in the latest release ([#27919](https://togithub.com/nuxt/nuxt/pull/27919))
- Update roadmap + readme ([748bc751d](https://togithub.com/nuxt/nuxt/commit/748bc751d))
- Update `Nuxt 3` -> `Nuxt` or `Nuxt 3+` ([3c16c890c](https://togithub.com/nuxt/nuxt/commit/3c16c890c))
- Update reference to nightly release for testing nuxt 4 ([5d2dc9714](https://togithub.com/nuxt/nuxt/commit/5d2dc9714))
- Remove duplicate server-side notice in runtime config ([#27929](https://togithub.com/nuxt/nuxt/pull/27929))
- Warn about ref unwrapping when auto-importing `ref`s ([#27933](https://togithub.com/nuxt/nuxt/pull/27933))
- Mention layers in directory guide ([c222fe7aa](https://togithub.com/nuxt/nuxt/commit/c222fe7aa))
##### 🏡 Chore
- Use absolute urls for sources to assets in readme ([5ef305cec](https://togithub.com/nuxt/nuxt/commit/5ef305cec))
- Use relative links and update in build script ([7dd15186e](https://togithub.com/nuxt/nuxt/commit/7dd15186e))
- Use backup file extension ([a42a3869b](https://togithub.com/nuxt/nuxt/commit/a42a3869b))
- Allow changelogs with breaking changes ([e11587189](https://togithub.com/nuxt/nuxt/commit/e11587189))
- Allow major bumps ([dea0b86c7](https://togithub.com/nuxt/nuxt/commit/dea0b86c7))
- Add `4x` tag for v4 nightly releases ([9d5dd5494](https://togithub.com/nuxt/nuxt/commit/9d5dd5494))
- **vite:** Restore utils required for `dev-bundler` ([e3448fa0d](https://togithub.com/nuxt/nuxt/commit/e3448fa0d))
- Remove nitro/h3 from renovate, and reenable vitejs/vue ([9037b0d2c](https://togithub.com/nuxt/nuxt/commit/9037b0d2c))
- Improve type safety with indexed access ([#27626](https://togithub.com/nuxt/nuxt/pull/27626))
- Add [@danielroe](https://togithub.com/danielroe) to code owners ([7fa957729](https://togithub.com/nuxt/nuxt/commit/7fa957729))
- Remove renovate configuration from `2.x` branch ([8003cf72f](https://togithub.com/nuxt/nuxt/commit/8003cf72f))
- Remove issue template for 2.x ([9f9fb9251](https://togithub.com/nuxt/nuxt/commit/9f9fb9251))
- Remove unused variable ([f07969d88](https://togithub.com/nuxt/nuxt/commit/f07969d88))
##### ✅ Tests
- **schema:** Normalize snapshot paths for windows ([#27654](https://togithub.com/nuxt/nuxt/pull/27654))
- **nuxt:** Normalize paths for windows ([#27653](https://togithub.com/nuxt/nuxt/pull/27653))
- Bump timeout for node-compat test ([228b8b889](https://togithub.com/nuxt/nuxt/commit/228b8b889))
- Slightly improve test reliability ([#27811](https://togithub.com/nuxt/nuxt/pull/27811))
##### 🤖 CI
- Update changelog from 3.x branch updates ([2b6967fbb](https://togithub.com/nuxt/nuxt/commit/2b6967fbb))
- Add 3x tag instead ([c0ef279f2](https://togithub.com/nuxt/nuxt/commit/c0ef279f2))
- Run workflows against 3.x branch as well ([31255a14d](https://togithub.com/nuxt/nuxt/commit/31255a14d))
- Use correct SHA calculation for release-pr action ([#27604](https://togithub.com/nuxt/nuxt/pull/27604))
- Resolve bash syntax error ([#27789](https://togithub.com/nuxt/nuxt/pull/27789))
- Only run scorecards against `main` branch ([7abd982f8](https://togithub.com/nuxt/nuxt/commit/7abd982f8))
- Raise renovate prs against 3.x branch too ([f176c150a](https://togithub.com/nuxt/nuxt/commit/f176c150a))
- Ignore `@vitejs/plugin-vue` again ([56660cbdd](https://togithub.com/nuxt/nuxt/commit/56660cbdd))
- Prevent more than one release from occurring at same time ([71705550f](https://togithub.com/nuxt/nuxt/commit/71705550f))
- Don't run changelog update on 2.x branch ([1be639364](https://togithub.com/nuxt/nuxt/commit/1be639364))
##### ❤️ Contributors
- Daniel Roe ([@danielroe](https://togithub.com/danielroe))
- Typed SIGTERM ([@typed-sigterm](https://togithub.com/typed-sigterm))
- Seno ([@s-en-o](https://togithub.com/s-en-o))
- Julien Huang ([@huang-julien](https://togithub.com/huang-julien))
- Michael Brevard ([@GalacticHypernova](https://togithub.com/GalacticHypernova))
- Ryota Watanabe ([@wattanx](https://togithub.com/wattanx))
- Martin Masevski ([@Archetipo95](https://togithub.com/Archetipo95))
- Alex Liu ([@Mini-ghost](https://togithub.com/Mini-ghost))
- Bochkarev Ivan ([@Ibochkarev](https://togithub.com/Ibochkarev))
- Alexander Lichter ([@manniL](https://togithub.com/manniL))
- Dominic ([@rexhent](https://togithub.com/rexhent))
- Aviv Keller ([@RedYetiDev](https://togithub.com/RedYetiDev))
- Maxime Pauvert ([@maximepvrt](https://togithub.com/maximepvrt))
- Daniel Kelly ([@danielkellyio](https://togithub.com/danielkellyio))
- Damian Głowala ([@DamianGlowala](https://togithub.com/DamianGlowala))
- Idorenyin Udoh ([@idorenyinudoh](https://togithub.com/idorenyinudoh))
nuxt/test-utils (@nuxt/test-utils)
### [`v3.14.1`](https://togithub.com/nuxt/test-utils/blob/HEAD/CHANGELOG.md#v3141)
[Compare Source](https://togithub.com/nuxt/test-utils/compare/v3.14.0...v3.14.1)
[compare changes](https://togithub.com/nuxt/test-utils/compare/v3.14.0...v3.14.1)
##### 🩹 Fixes
- **e2e,config:** Provide fallback `compatibilityDate` ([8e01e3f7f](https://togithub.com/nuxt/test-utils/commit/8e01e3f7f))
- **module:** Don't include type-check plugin in resolved `vitest` plugins ([#911](https://togithub.com/nuxt/test-utils/pull/911))
##### 📖 Documentation
- Provide intellisense hints for setup properties ([#906](https://togithub.com/nuxt/test-utils/pull/906))
##### 🏡 Chore
- Dedupe vitest ([6e36b5471](https://togithub.com/nuxt/test-utils/commit/6e36b5471))
- Ignore upgrading dependencies for stubbed libs ([4329c4ddc](https://togithub.com/nuxt/test-utils/commit/4329c4ddc))
##### ❤️ Contributors
- Daniel Roe ([@danielroe](http://github.com/danielroe))
- Valentin Brajon ([@vbrajon](http://github.com/vbrajon))
- Adam DeHaven ([@adamdehaven](http://github.com/adamdehaven))
### [`v3.14.0`](https://togithub.com/nuxt/test-utils/blob/HEAD/CHANGELOG.md#v3140)
[Compare Source](https://togithub.com/nuxt/test-utils/compare/v3.13.1...v3.14.0)
[compare changes](https://togithub.com/nuxt/test-utils/compare/v3.13.1...v3.14.0)
##### 🚀 Enhancements
- **runtime-utils:** Expose setup result from `renderSuspended` ([#852](https://togithub.com/nuxt/test-utils/pull/852))
- **e2e:** Allow overwriting env variables in `setup` ([#903](https://togithub.com/nuxt/test-utils/pull/903))
- **e2e:** Allow running e2e tests against existing server ([#803](https://togithub.com/nuxt/test-utils/pull/803))
- **e2e:** Allow updating env in context before `setup` runs ([#812](https://togithub.com/nuxt/test-utils/pull/812))
##### 🩹 Fixes
- **runtime-utils:** Ts-ignore `#build/` import until nuxt v3.12 release ([66b23ae6](https://togithub.com/nuxt/test-utils/commit/66b23ae6))
- **runtime-utils:** Allow `setProps` to replace an array ([#877](https://togithub.com/nuxt/test-utils/pull/877))
##### 🏡 Chore
- Ignore ts-ignores for now ([ac2d9fbb](https://togithub.com/nuxt/test-utils/commit/ac2d9fbb))
- Add [@danielroe](https://togithub.com/danielroe) to code owners ([76f65b3b](https://togithub.com/nuxt/test-utils/commit/76f65b3b))
- Remove ts-ignore now that we're upgraded ([16827f7f](https://togithub.com/nuxt/test-utils/commit/16827f7f))
##### ✅ Tests
- Bump timeout in windows browser spec ([73e2c716](https://togithub.com/nuxt/test-utils/commit/73e2c716))
##### ❤️ Contributors
- Jessé Correia Lins ([@linspw](http://github.com/linspw))
- Tobias Diez
- Mark Brockhoff ([@markbrockhoff](http://github.com/markbrockhoff))
- Daniel Roe ([@danielroe](http://github.com/danielroe))
- MaruyamaTomoki ([@tomoki1207](http://github.com/tomoki1207))
- Joao Vitor Alves
Configuration
📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
👻 Immortal: This PR will be recreated if closed unmerged. Get config help if that's undesired.
[ ] If you want to rebase/retry this PR, check this box
This PR contains the following updates:
^3.12.2->^3.13.0^3.12.2->^3.13.0^3.13.1->^3.14.1^3.12.2->^3.13.0Release Notes
nuxt/nuxt (@nuxt/kit)
### [`v3.13.0`](https://togithub.com/nuxt/nuxt/releases/tag/v3.13.0) [Compare Source](https://togithub.com/nuxt/nuxt/compare/v3.12.4...v3.13.0) ##### 👀 Highlights I'm pretty excited about this release - we've ported some features we had planned for Nuxt v4 back to v3, as well as a raft of bug fixes and performance improvements - as usual. Here are a few of things I'm most excited about. ##### 🏘️ Route Groups We now support naming directories with parentheses/brackets to organise your routes without affecting the path. For example: ```bash [Directory structure] -| pages/ ---| index.vue ---| (marketing)/ -----| about.vue -----| contact.vue ``` This will produce `/`, `/about` and `/contact` pages in your app. The `marketing` group is ignored for purposes of your URL structure. Read more in [the original PR](https://togithub.com/nuxt/nuxt/pull/28276). ##### 🏝️ Islands and Head Metadata It's now possible for server component islands to manipulate the head, such as by adding SEO metadata when rendering. Read more in [#27987](https://togithub.com/nuxt/nuxt/pull/27987). ##### 🪝 Custom Prefetch Triggers We now support custom prefetch triggers for `NuxtLink` ([#27846](https://togithub.com/nuxt/nuxt/pull/27846)). For example: ```vue [pages/index.vue]nuxt/test-utils (@nuxt/test-utils)
### [`v3.14.1`](https://togithub.com/nuxt/test-utils/blob/HEAD/CHANGELOG.md#v3141) [Compare Source](https://togithub.com/nuxt/test-utils/compare/v3.14.0...v3.14.1) [compare changes](https://togithub.com/nuxt/test-utils/compare/v3.14.0...v3.14.1) ##### 🩹 Fixes - **e2e,config:** Provide fallback `compatibilityDate` ([8e01e3f7f](https://togithub.com/nuxt/test-utils/commit/8e01e3f7f)) - **module:** Don't include type-check plugin in resolved `vitest` plugins ([#911](https://togithub.com/nuxt/test-utils/pull/911)) ##### 📖 Documentation - Provide intellisense hints for setup properties ([#906](https://togithub.com/nuxt/test-utils/pull/906)) ##### 🏡 Chore - Dedupe vitest ([6e36b5471](https://togithub.com/nuxt/test-utils/commit/6e36b5471)) - Ignore upgrading dependencies for stubbed libs ([4329c4ddc](https://togithub.com/nuxt/test-utils/commit/4329c4ddc)) ##### ❤️ Contributors - Daniel Roe ([@danielroe](http://github.com/danielroe)) - Valentin Brajon ([@vbrajon](http://github.com/vbrajon)) - Adam DeHaven ([@adamdehaven](http://github.com/adamdehaven)) ### [`v3.14.0`](https://togithub.com/nuxt/test-utils/blob/HEAD/CHANGELOG.md#v3140) [Compare Source](https://togithub.com/nuxt/test-utils/compare/v3.13.1...v3.14.0) [compare changes](https://togithub.com/nuxt/test-utils/compare/v3.13.1...v3.14.0) ##### 🚀 Enhancements - **runtime-utils:** Expose setup result from `renderSuspended` ([#852](https://togithub.com/nuxt/test-utils/pull/852)) - **e2e:** Allow overwriting env variables in `setup` ([#903](https://togithub.com/nuxt/test-utils/pull/903)) - **e2e:** Allow running e2e tests against existing server ([#803](https://togithub.com/nuxt/test-utils/pull/803)) - **e2e:** Allow updating env in context before `setup` runs ([#812](https://togithub.com/nuxt/test-utils/pull/812)) ##### 🩹 Fixes - **runtime-utils:** Ts-ignore `#build/` import until nuxt v3.12 release ([66b23ae6](https://togithub.com/nuxt/test-utils/commit/66b23ae6)) - **runtime-utils:** Allow `setProps` to replace an array ([#877](https://togithub.com/nuxt/test-utils/pull/877)) ##### 🏡 Chore - Ignore ts-ignores for now ([ac2d9fbb](https://togithub.com/nuxt/test-utils/commit/ac2d9fbb)) - Add [@danielroe](https://togithub.com/danielroe) to code owners ([76f65b3b](https://togithub.com/nuxt/test-utils/commit/76f65b3b)) - Remove ts-ignore now that we're upgraded ([16827f7f](https://togithub.com/nuxt/test-utils/commit/16827f7f)) ##### ✅ Tests - Bump timeout in windows browser spec ([73e2c716](https://togithub.com/nuxt/test-utils/commit/73e2c716)) ##### ❤️ Contributors - Jessé Correia Lins ([@linspw](http://github.com/linspw)) - Tobias DiezConfiguration
📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
👻 Immortal: This PR will be recreated if closed unmerged. Get config help if that's undesired.
This PR was generated by Mend Renovate. View the repository job log.