nuxt/framework
### [`v3.0.0-rc.12`](https://togithub.com/nuxt/framework/releases/tag/v3.0.0-rc.12)
[Compare Source](https://togithub.com/nuxt/framework/compare/v3.0.0-rc.11...v3.0.0-rc.12)
> [**💬 Release Discussion**](https://togithub.com/nuxt/framework/discussions/8296)
#### 🚀 How to Upgrade
> **Note**
> Make sure to recreate the lock file in the project in case of any issues after the upgrade.
- **Automated:** `npx nuxi@latest upgrade --force`
- **Manual:** Bump `nuxt` dependency to `3.0.0-rc.12` and then use `npx nuxi@latest cleanup` to cleanup any local caches
#### ⭐ What is New?
##### 📍 Route Rules
RC.12 comes with the first public beta for route rules and hybrid rendering support. Using route rules you can define rules for a group of nuxt routes, change rendering mode or assign a cache strategy based on route! Nuxt server will automatically register corresponding middleware and wrap routes with cache handlers using Nitro caching layer. Whenever possible, route rules will be automatically applied to the deployment platform's native rules (currently Netlify and Vercel are supported).
👉 See docs for [examples and more info](https://v3.nuxtjs.org/guide/concepts/rendering/#route-rules).
##### ⚗️ Nitropack 0.6
Nitropack upgraded to 0.6 ([Release Notes](https://togithub.com/unjs/nitro/releases/tag/v0.6.0)) and h3 upgraded to 0.8 ([Release Notes](https://togithub.com/unjs/h3/releases/tag/v0.8.0))
**⚠️ Breaking changes:** Using `defineEventHandler()` or `eventHandler()` is now required. If you were previously using a Node.js middleware with `(req, res, next?)` syntax you need to wrap them with `fromNodeMiddleware()` to convert it into an h3 handler.
##### 👦 `useHead` updates
This release brings a brand-new version of `@vueuse/head` with some significant performance improvements and bug fixes. Check out [https://github.com/nuxt/framework/pull/8000](https://togithub.com/nuxt/framework/pull/8000) for more details, but in particular:
- Fully-typed usage of `useHead`
- No more flickering when transitioning between routes
- Support *ordering* of head metadata
- Faster head hydration and deduping
**⚠️ Breaking changes:** The shortcuts `viewport` and `charset` can only be used within `nuxt.config` and not within `useHead` directly. For more information on how to update, see [https://github.com/nuxt/framework/pull/8000](https://togithub.com/nuxt/framework/pull/8000).
##### ⚡ Page Meta
New router options `validate` and `redirect` are now supported directly in `definePageMeta` - so you can perform additional validation for dynamic routes, or implement route redirects directly within pages.
```ts
definePageMeta({
// redirect: '/admin',
validate: async (route) => {
const nuxtApp = useNuxtApp()
// Check if the id is made up of digits
return /^\d+$/.test(params.id)
}
})
```
##### 🌅 Early Hints
Nuxt's node server renderer will now respond with 103 Early Hints before the server renders the app, meaning that you should see a decreased TTFB and earlier resource loading in a [supported environment](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/103#browser_compatibility) - which at the moment is Chrome with your Nuxt app served over HTTPS with newer than HTTP/1.1.
##### 📖 Nuxt 3 Docs
Nuxt's documentation is now written with Nuxt 3's new theming system and the latest Docus and Content module versions. Check it out at https://v3.nuxtjs.org! Expect more coming soon!
#### Changelog
[compare changes](https://togithub.com/nuxt/framework/compare/v3.0.0-rc.11...release/3.0.0.rc.12)
##### 🚀 Enhancements
- **nuxt:** Support `redirect` within page metadata ([#7746](https://togithub.com/nuxt/framework/pull/7746))
- **cli:** Support `--dotenv` for `dev`, `build` and `preview` commands ([#7660](https://togithub.com/nuxt/framework/pull/7660))
- **nuxt:** Allow configuring plugins directory ([#7981](https://togithub.com/nuxt/framework/pull/7981))
- **nuxt:** Add default slot to `` ([#7128](https://togithub.com/nuxt/framework/pull/7128))
- **pages:** Add `validate` hook for `definePageMeta` ([#7870](https://togithub.com/nuxt/framework/pull/7870))
- **nuxt:** Refresh override for data fetching composables ([#7864](https://togithub.com/nuxt/framework/pull/7864))
- **schema, nuxt:** Allow user-configurable `serverDir` ([#7868](https://togithub.com/nuxt/framework/pull/7868))
- **nuxt:** Parse html to treeshake client-only components ([#7527](https://togithub.com/nuxt/framework/pull/7527))
- **nuxt:** Wrap `#components` client exports with createClientOnly ([#7412](https://togithub.com/nuxt/framework/pull/7412))
- **nuxt:** Add `ssr: false` route rule to enable SPA mode ([#7938](https://togithub.com/nuxt/framework/pull/7938))
- **nuxt:** Migrate to latest `@vueuse/head` ([#8000](https://togithub.com/nuxt/framework/pull/8000))
- **nuxt:** ⚠️ Add `` to `#components` ([#8145](https://togithub.com/nuxt/framework/pull/8145))
- **nuxt:** Add hook debug mode ([#7690](https://togithub.com/nuxt/framework/pull/7690))
- **cli:** Add `nuxi build-module` command ([#7610](https://togithub.com/nuxt/framework/pull/7610))
- **schema:** Add experimental `routesRules` shortcut ([#7954](https://togithub.com/nuxt/framework/pull/7954))
- **kit:** Support plugin array for `addVitePlugin` and `addWebpackPlugin` ([#8270](https://togithub.com/nuxt/framework/pull/8270))
##### 🔥 Performance
- **nitro:** Respond with early hints in node-based environments ([#7893](https://togithub.com/nuxt/framework/pull/7893))
- **nuxt:** ⚠️ Use component loader to add meta components ([#8167](https://togithub.com/nuxt/framework/pull/8167))
- **nuxt:** Remove `vue-router` dependency from minimal app ([#8188](https://togithub.com/nuxt/framework/pull/8188))
- **nuxt:** Improve link prefetching ([#8225](https://togithub.com/nuxt/framework/pull/8225))
##### 🩹 Fixes
- **nuxt:** Export and auto-import `clearNuxtData` ([#7710](https://togithub.com/nuxt/framework/pull/7710))
- **test-utils:** Support vitest v0.20.x ([#7712](https://togithub.com/nuxt/framework/pull/7712))
- **cli:** Include `workspaceDir` in tsconfig include ([#7726](https://togithub.com/nuxt/framework/pull/7726))
- **cli:** Stub `defineNuxtConfig` for `nuxi info` ([#7728](https://togithub.com/nuxt/framework/pull/7728))
- **nuxt:** Do not warn for non-existent default layout ([#7748](https://togithub.com/nuxt/framework/pull/7748))
- **nuxt:** Respect immediate option in `useFetch` ([#7720](https://togithub.com/nuxt/framework/pull/7720))
- **nuxt:** Respect `baseURL` when rendering payload path ([#7809](https://togithub.com/nuxt/framework/pull/7809))
- **nuxt:** Don't disable scripts in dev mode with experimental `noScripts` ([#7745](https://togithub.com/nuxt/framework/pull/7745))
- Downgrade Node.js `^16.11.0` requirement to `^16.10.0` ([#7865](https://togithub.com/nuxt/framework/pull/7865))
- **nuxt:** Handle schema types for relative module paths ([#7946](https://togithub.com/nuxt/framework/pull/7946))
- **vite:** Add type-checker to client build for `ssr: false` ([#7930](https://togithub.com/nuxt/framework/pull/7930))
- **nuxt:** Allow auto-import component with same filename ([#7713](https://togithub.com/nuxt/framework/pull/7713))
- **test-utils:** Respect `setupTimeout` ([#7866](https://togithub.com/nuxt/framework/pull/7866))
- **nuxt:** Fix lazy import of `.client` components ([#7422](https://togithub.com/nuxt/framework/pull/7422))
- **nuxt:** Remove fragment from `createClientOnly` ([#7774](https://togithub.com/nuxt/framework/pull/7774))
- **head:** Allow using the default slot for script content like noscript ([#7858](https://togithub.com/nuxt/framework/pull/7858))
- **nuxt:** Don't prerender `index.html` with a server ([#7831](https://togithub.com/nuxt/framework/pull/7831))
- **docs:** Link to api config reference ([#8038](https://togithub.com/nuxt/framework/pull/8038))
- **docs:** Link to installation section ([#8040](https://togithub.com/nuxt/framework/pull/8040))
- **nuxt:** Page hydration and double load ([#7940](https://togithub.com/nuxt/framework/pull/7940))
- **schema:** Declare `untyped` dependency ([#8064](https://togithub.com/nuxt/framework/pull/8064))
- **nuxt:** Use correct cache and add baseURL to payload ([#7984](https://togithub.com/nuxt/framework/pull/7984))
- **cli:** Replace `lazyHandle` with `defineLazyHandler` ([#8049](https://togithub.com/nuxt/framework/pull/8049))
- **schema:** Evaluate environment variables when resolving values ([#8079](https://togithub.com/nuxt/framework/pull/8079))
- **vite:** Prevent overlap between vite assets and app routes ([#7989](https://togithub.com/nuxt/framework/pull/7989))
- **nuxt:** Don't inline styles for per-request `ssr: false` ([#8106](https://togithub.com/nuxt/framework/pull/8106))
- **nuxt:** ⚠️ `refresh` to override previous requests by default ([#8190](https://togithub.com/nuxt/framework/pull/8190))
- **nuxt:** Enable router when `app/router.options.ts` file is present ([#8193](https://togithub.com/nuxt/framework/pull/8193))
- **kit:** Log module id to the console when import fails ([#8198](https://togithub.com/nuxt/framework/pull/8198))
- **nuxt:** Avoid head dom update on same route click ([#8206](https://togithub.com/nuxt/framework/pull/8206))
- **webpack:** Add global to new line ([#8226](https://togithub.com/nuxt/framework/pull/8226))
- **schema:** RouteRules config ([#8252](https://togithub.com/nuxt/framework/pull/8252))
- **cli:** Don't include`workspaceDir` in tsconfig by default ([#8256](https://togithub.com/nuxt/framework/pull/8256))
- **nuxt:** Avoid preloading external routes ([#8255](https://togithub.com/nuxt/framework/pull/8255))
- **nuxt:** Allow disabling early hints ([#8264](https://togithub.com/nuxt/framework/pull/8264))
- **nuxt:** Lazy-load entry CSS ([#8278](https://togithub.com/nuxt/framework/pull/8278))
- **nuxt:** Ignore cache rules for middleware and errors ([#8291](https://togithub.com/nuxt/framework/pull/8291))
##### 💅 Refactors
- **nuxt:** Use `unref` in `layout.ts` ([#7818](https://togithub.com/nuxt/framework/pull/7818))
- **nuxt:** Use `unref` in `fetch.ts` ([#7813](https://togithub.com/nuxt/framework/pull/7813))
- **nuxt:** Deprecate ` Githubissues.
Githubissues is a development platform for aggregating issues.
This PR contains the following updates:
^3.0.0-rc.11->^3.0.0-rc.123.0.0-rc.11->3.0.0-rc.123.0.0-rc.12-27752119.1477d37->3.0.0-rc.13-27769897.0f2ef5dRelease Notes
nuxt/framework
### [`v3.0.0-rc.12`](https://togithub.com/nuxt/framework/releases/tag/v3.0.0-rc.12) [Compare Source](https://togithub.com/nuxt/framework/compare/v3.0.0-rc.11...v3.0.0-rc.12) > [**💬 Release Discussion**](https://togithub.com/nuxt/framework/discussions/8296) #### 🚀 How to Upgrade > **Note** > Make sure to recreate the lock file in the project in case of any issues after the upgrade. - **Automated:** `npx nuxi@latest upgrade --force` - **Manual:** Bump `nuxt` dependency to `3.0.0-rc.12` and then use `npx nuxi@latest cleanup` to cleanup any local caches #### ⭐ What is New? ##### 📍 Route Rules RC.12 comes with the first public beta for route rules and hybrid rendering support. Using route rules you can define rules for a group of nuxt routes, change rendering mode or assign a cache strategy based on route! Nuxt server will automatically register corresponding middleware and wrap routes with cache handlers using Nitro caching layer. Whenever possible, route rules will be automatically applied to the deployment platform's native rules (currently Netlify and Vercel are supported). 👉 See docs for [examples and more info](https://v3.nuxtjs.org/guide/concepts/rendering/#route-rules). ##### ⚗️ Nitropack 0.6 Nitropack upgraded to 0.6 ([Release Notes](https://togithub.com/unjs/nitro/releases/tag/v0.6.0)) and h3 upgraded to 0.8 ([Release Notes](https://togithub.com/unjs/h3/releases/tag/v0.8.0)) **⚠️ Breaking changes:** Using `defineEventHandler()` or `eventHandler()` is now required. If you were previously using a Node.js middleware with `(req, res, next?)` syntax you need to wrap them with `fromNodeMiddleware()` to convert it into an h3 handler. ##### 👦 `useHead` updates This release brings a brand-new version of `@vueuse/head` with some significant performance improvements and bug fixes. Check out [https://github.com/nuxt/framework/pull/8000](https://togithub.com/nuxt/framework/pull/8000) for more details, but in particular: - Fully-typed usage of `useHead` - No more flickering when transitioning between routes - Support *ordering* of head metadata - Faster head hydration and deduping **⚠️ Breaking changes:** The shortcuts `viewport` and `charset` can only be used within `nuxt.config` and not within `useHead` directly. For more information on how to update, see [https://github.com/nuxt/framework/pull/8000](https://togithub.com/nuxt/framework/pull/8000). ##### ⚡ Page Meta New router options `validate` and `redirect` are now supported directly in `definePageMeta` - so you can perform additional validation for dynamic routes, or implement route redirects directly within pages. ```ts definePageMeta({ // redirect: '/admin', validate: async (route) => { const nuxtApp = useNuxtApp() // Check if the id is made up of digits return /^\d+$/.test(params.id) } }) ``` ##### 🌅 Early Hints Nuxt's node server renderer will now respond with 103 Early Hints before the server renders the app, meaning that you should see a decreased TTFB and earlier resource loading in a [supported environment](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/103#browser_compatibility) - which at the moment is Chrome with your Nuxt app served over HTTPS with newer than HTTP/1.1. ##### 📖 Nuxt 3 Docs Nuxt's documentation is now written with Nuxt 3's new theming system and the latest Docus and Content module versions. Check it out at https://v3.nuxtjs.org! Expect more coming soon!
#### Changelog [compare changes](https://togithub.com/nuxt/framework/compare/v3.0.0-rc.11...release/3.0.0.rc.12) ##### 🚀 Enhancements - **nuxt:** Support `redirect` within page metadata ([#7746](https://togithub.com/nuxt/framework/pull/7746)) - **cli:** Support `--dotenv` for `dev`, `build` and `preview` commands ([#7660](https://togithub.com/nuxt/framework/pull/7660)) - **nuxt:** Allow configuring plugins directory ([#7981](https://togithub.com/nuxt/framework/pull/7981)) - **nuxt:** Add default slot to `