Update nuxtjs monorepo to v3.18.1

[renovate]

This PR contains the following updates:

Package	Change	Age	Confidence
@nuxt/kit (source)	3.0.0 -> 3.18.1
@nuxt/schema (source)	3.0.0 -> 3.18.1
nuxt (source)	3.0.0 -> 3.18.1

---

Release Notes

nuxt/nuxt (@​nuxt/kit)

v3.18.1

Compare Source

3.18.1 is a regularly scheduled patch release.

👉 Changelog

compare changes

🔥 Performance

• kit: Get absolute path from tinyglobby in resolveFiles (#​32846)

🩹 Fixes

• nuxt: Do not throw undefined error variable (#​32807)
• vite: Include tsconfig references during typeCheck (#​32835)
• nuxt: Add sourcemap path transformation for client builds (#​32313)
• nuxt: Add warning for lazy-hydration missing prefix (#​32832)
• nuxt: Trigger call once navigation even when no suspense (#​32827)
• webpack: Handle null result from webpack call (65aa17158)
• kit,nuxt: Use reverseResolveAlias for better errors (#​32853)

📖 Documentation

• Update nightly version references (#​32776)
• Improve explanation of global middleware (#​32855)

🏡 Chore

• Update reproduction help text links (#​32803)
• Update pnpm ignored build scripts (#​32849)
• Improve internal types (f271c66c4)

✅ Tests

• Move tests for defineNuxtComponent out of e2e test (#​32848)

🤖 CI

• Move nightly releases into different concurrency group (26f9baa6a)

❤️ Contributors

• RDistinct (@​RDistinct)
• Daniel Roe (@​danielroe)
• Oskar Lebuda (@​OskarLebuda)
• Peter Budai (@​peterbud)
• Matej Černý (@​cernymatej)
• Damian Głowala (@​DamianGlowala)
• Bobbie Goede (@​BobbieGoede)
• Robin (@​OrbisK)
• Bobby (@​xanzhu)

v3.18.0

Compare Source

3.18.0 is the next minor release.

👀 Highlights

A huge thank you to everyone who's been a part of this release, which is mostly about backporting features + bugfixes from Nuxt v4.

Over the next six months, we'll continue backporting compatible v4 features and bug fixes, so please keep the feedback coming! ❤️

🧪 Lazy Hydration Macros

Building on the delayed hydration support from v3.16, we now support lazy hydration macros (#​31192)! These provide a more ergonomic way to control component hydration:

<script setup lang="ts">
const LazyHydrationMyComponent = defineLazyHydrationComponent(
  'visible',
  () => import('./components/MyComponent.vue')
)
</script>
<template>
  <div>
    <!-- 
      Hydration will be triggered when
      the element(s) is 100px away from entering the viewport.
    -->
    <LazyHydrationMyComponent :hydrate-on-visible="{ rootMargin: '100px' }" />
  </div>
</template>

These macros make it possible to use Nuxt's lazy hydration utilities alongside explicit component imports.

♿️ Accessibility Improvements

We've enhanced accessibility by including <NuxtRouteAnnouncer> in the built-in app.vue (#​32621). This means page changes will be announced to screen readers, making navigation more accessible for users with visual impairments. (This only applies if you do not have an app.vue in your project. If you do, please keep <NuxtRouteAnnouncer> in your app.vue!)

🛠️ Enhanced Development Experience

Chrome DevTools Workspace Integration

We've added Chrome DevTools workspace integration (#​32084), allowing you to edit your Nuxt source files directly from Chrome DevTools. This creates a better debugging experience where changes made in DevTools are reflected in your actual source files.

Better Component Type Safety

Component type safety has been improved with:

• Typed slots for <ClientOnly> and <DevOnly> (#​32707) - better IntelliSense and error checking
• Exported <NuxtTime> prop types (#​32547) - easier to extend and customize

New Auto-Import: onWatcherCleanup

The onWatcherCleanup function from vue is now available as an auto-import (#​32396), making it easier to clean up watchers and prevent memory leaks:

const { data } = useAsyncData('users', fetchUsers)

watch(data, (newData) => {
  const interval = setInterval(() => {
    // Some periodic task
  }, 1000)
  
  // Clean up when the watcher is stopped
  onWatcherCleanup(() => {
    clearInterval(interval)
  })
})

📊 Observability Enhancements

Page routes are now exposed to Nitro for observability (#​32617), enabling better monitoring and analytics integration with supported platforms. This allows observability tools to track page-level metrics more effectively.

🔧 Module Development Improvements

Module authors get several quality-of-life improvements:

Simplified Server Imports

The addServerImports kit utility now supports single imports (#​32289), making it easier to add individual server utilities:

// Before: had to wrap in array
addServerImports([{ from: 'my-package', name: 'myUtility' }])

// Now: can pass directly
addServerImports({ from: 'my-package', name: 'myUtility' })

TypeScript Configuration

Modules can now add to typescript.hoist (#​32601), giving them more control over TypeScript configuration and type generation.

⚡️ Performance Improvements

We've made several performance optimizations:

• Improved Vite-node communication via internal socket (#​32417) for faster development builds
• Migration to oxc-walker (#​32250) and oxc for onPrehydrate transforms (#​32045) for faster code transformations

🐛 Bug Fixes

This release also includes several important fixes:

• Improved data fetching: When computed keys change, old data is now properly retained (#​32616)
• Better scroll behavior: scrollBehaviorType is now only used for hash scrolling (#​32622)
• Fixed directory aliases: Added trailing slashes to some directory aliases for better consistency (#​32755)

✅ Upgrading

As usual, our recommendation for upgrading is to run:

npx nuxi@latest upgrade --dedupe

This refreshes your lockfile and pulls in all the latest dependencies that Nuxt relies on, especially from the unjs ecosystem.

👉 Changelog

compare changes

🚀 Enhancements

• nuxt: Expose page routes to nitro for o11y (#​32617)
• nuxt: Export <NuxtTime> prop types (#​32547)
• nuxt: Add integration with chrome devtools workspaces (#​32084)
• kit: Support single import in addServerImports (#​32289)
• nuxt: Add onWatcherCleanup to imports presets (#​32396)
• nuxt: Add route announcer to default app.vue (#​32621)
• nuxt: Support lazy hydration macros (#​31192)

🔥 Performance

• vite: Communicate with vite-node via internal socket (#​32417)
• kit: Update env expansion regex to match nitro (#​30766)

🩹 Fixes

• nuxt: Allow modules to add to typescript.hoist (#​32601)
• nuxt: Retain old data when computed key changes (#​32616)
• nuxt: Only use scrollBehaviorType for hash scrolling (#​32622)
• nuxt: Add missing async (fd312af03)
• nuxt: Fix transform/minify types + bump oxc-transform (d2ba19963)
• nuxt: Provide typed slots for <ClientOnly> and <DevOnly> (#​32707)
• kit,nuxt,schema: Add trailing slash to some dir aliases (#​32755)
• nuxt: Include source base url for remote islands (#​32772)
• vite: Use vite node server to transform requests (#​32791)
• kit: Use mlly to parse module paths (#​32386)
• nuxt: Execute all plugins after error rendering error.vue (#​32744)

💅 Refactors

• nuxt: Migrate to oxc-walker (#​32250)
• nuxt,schema: Use oxc for onPrehydrate transform (#​32045)
• nuxt: Pass file language directly to parser options (#​32665)
• nuxt: Use direct import of installNuxtModule (228e3585e)

📖 Documentation

• Pass v3 template to create nuxt examples (03182202f)
• Add reference to useNuxtData in data fetching composable pages (#​32589)
• Document the --modules flag in the init command (#​32599)
• Added new Shared folder to the example of v4 folder structure (#​32630)
• Improve grammar (#​32640)
• Typos (#​32567)
• Fix abbreviation (#​32613)
• Reference noUncheckedIndexedAccess rule change in v4 guide (#​32643)
• Fix links to Nitro docs (#​32691)
• Add best practices section (#​31609)
• Correct alias for local fonts in styling guide (#​32680)
• Update nuxt.new links to v4 (#​32639)
• Set correct default value for deep option in usefetch (#​32724)
• Fix link to issue (ca03f533f)
• Add AI-assisted contribution guidelines (#​32725)
• Update Nuxt installation command to use npm create nuxt@latest (#​32726)
• Hydration best practice (#​32746)
• Add example for module .with() (#​32757)
• Replace dead Vue Router docs links (#​32779)

🏡 Chore

• Handle missing commit details (0af98763d)
• Update reproduction links for bug-report template (#​32722)
• Update unbuild and use absolute path in dev stubs (#​32759)

✅ Tests

• Also assert status (4b4b224f7)
• Ignore vue module.exports export (ac8b02d09)
• Extend timeout when waiting for hydration (49c01ba81)
• Benchmark minimal fixture instead (#​31174)
• Add minimal pages fixture (#​30457)
• Bump bundle size (bafa953c3)

🤖 CI

• Trigger website redeploy on main branch (#​32695)
• Release pkg.pr.new for main/3.x branches as well (ca4f0b1da)
• Apply 3x tag to latest v3 release (5e8dfc150)

❤️ Contributors

• Daniel Roe (@​danielroe)
• Bobbie Goede (@​BobbieGoede)
• Damian Głowala (@​DamianGlowala)
• Dog (@​dgxo)
• Julien Huang (@​huang-julien)
• Yauheni Vasiukevich (@​EvgenyWas)
• Alex Liu (@​Mini-ghost)
• Robin (@​OrbisK)
• Mateleo (@​Mateleo)
• Stephen Jason Wang (@​stephenjason89)
• Maurits Meester (@​mmeester)
• Igor Kononenko (@​igorexa34314)
• Alex (@​hywax)
• Matej Černý (@​cernymatej)
• Alexander Lichter (@​TheAlexLichter)
• Hashim Kalam (@​hashimkalam)
• Alois Sečkár (@​AloisSeckar)
• Haythem Frikha (@​Flamenate)
• abeer0 (@​iiio2)
• Thomas (@​ThomasWT)
• Connor Pearson (@​cjpearson)
• dwood-csi (@​dwood-csi)

v3.17.7

Compare Source

3.17.7 is the last patch release before v3.18.

✅ Upgrading

Our recommendation for upgrading is to run:

npx nuxt upgrade --dedupe

This will deduplicate your lockfile as well, and help ensure that you pull in updates from other dependencies that Nuxt relies on, particularly in the unjs ecosystem.

👉 Changelog

compare changes

🩹 Fixes

• nuxt: Safe-guard extraPageMetaExtractionKeys (#​32510)
• nuxt: Expose loadBuilder error cause (8f13ce3c2)
• vite: Handle resolving string vite input (#​32527)
• nuxt: Wrap only server components with island generic (#​32540)
• vite: Ignore when client entry cannot be resolved (19a292f34)
• nuxt: Normalize segment catchall pattern before checking for parent (#​32413)
• nuxt: Update warning message to warn against null values (c1b83eab5)
• nuxt: Ensure semver.satisfies returns true for pre-release versions (#​32574)
• nuxt: Scroll to anchor if present when changing page without saved position (#​32376)
• nuxt: Handle execute being passed to watch` (#​32591)

📖 Documentation

• Update fetch types (#​32522)
• Clarify that runtime env variables must start with NUXT_ (#​32223)
• Fix key change behavior in useAsyncData and useFetch migration (#​32560)
• Change return type of async data from undefined to null in v3 docs (#​32562)
• Add section on custom hooks for Nuxt modules (#​32586)
• Provide async keyword (#​32587)
• Move augmenting hook types in hooks page (#​32595)
• Add section about module loading order (#​32597)

✅ Tests

• Reenable skipped unit tests (8fc9b9ee9)
• Update test snapshot for generateTypes (c0855439d)
• Improve page scanning test stability (84b96f3de)
• Pass timeZone in to <NuxtTime> test (#​32558)
• Add more useAsyncData + useFetch tests (#​32585)
• Avoid hard-coding async-data keys (bfca95118)

❤️ Contributors

• Daniel Roe (@​danielroe)
• Julien Huang (@​huang-julien)
• abeer0 (@​iiio2)
• Bobbie Goede (@​BobbieGoede)
• Damian Głowala (@​DamianGlowala)
• Nestor Vera (@​hacknug)
• Ezra Ashenafi (@​Eazash)
• Mike Laumann Bellika (@​MikeBellika)
• Maxime Pauvert (@​maximepvrt)
• Chriest Yu (@​jcppman)
• Andrei Hudalla (@​paranoidPhantom)
• Sigrid Huemer (@​s1gr1d)
• xjccc (@​xjccc)

v3.17.6

Compare Source

3.17.6 is a regularly scheduled patch release.

✅ Upgrading

Our recommendation for upgrading is to run:

npx nuxt upgrade --dedupe

This will deduplicate your lockfile as well, and help ensure that you pull in updates from other dependencies that Nuxt relies on, particularly in the unjs ecosystem.

👉 Changelog

compare changes

🔥 Performance

• nuxt: Decrease if checks when prerendering (#​32455)

🩹 Fixes

• nuxt: Generate correct types for async data defaults based on nuxt.config (#​32324)
• nuxt: Reload at base URL in nuxt:chunk-reload-immediate (#​32382)
• nuxt: Use rollup to calculate island component filenames (#​32421)
• nuxt: Append set-cookie headers in error handler (#​32483)
• nuxt: Ensure asyncData runs if changing key while fetcher is running (#​32466)
• nuxt: Handle pure hash link clicks with navigateTo (#​32393)
• nuxt: Skip external <NuxtLink>'s custom on click handler (#​32499)
• nuxt: Update component loader regexp for minified code (#​32298)
• nuxt: Allow camelCase for lazy hydration attributes (#​32297)
• nuxt: Respect inheritAttrs: false in createClientOnly fn (#​32323)
• kit: Do not double-urlify file urls when resolving schema (#​32354)
• nuxt: Align scroll behavior with page transition completion (#​32239)
• nuxt: Set output.generatedCode.symbols for nitro build (#​32358)
• nuxt: Lazily access runtimeConfig (#​32428)

💅 Refactors

• vite: Migrate plugins internally to vite environments (#​32461)

📖 Documentation

• Clarify where logging tag is displayed (#​32440)
• Remove kit playground auto-import note (#​32415)
• Remove webstorm warning (#​32513)
• Migrate to h3js (#​32243)
• Update the fetch clear function description (#​32287)
• defineNuxtPlugin function documentation (#​32328)
• Mention that <NuxtLink> encodes query params (#​32361)
• Enhance documentation for Nuxt composables (#​32218)
• Adjust wording to reduce confusion in lifecycle section (#​32503)
• Improve useCookie example (367b85405)
• Capitalise title (#​32426)
• Mention bun.lock for lockfile (#​32427)

🏡 Chore

• Update stackblitz reproduction link (6ab5bac66)
• Update copilot instructions (220439055)
• Rename deprecated vitest workspace to projects (#​32388)
• Remove space in URL in comment (#​32394)
• Allow setting TAG on commandline (d387e07a3)

✅ Tests

• nuxt: Add case for key only changes with immediate: false (#​32473)
• Separate nuxt legacy runtime tests (#​32481)

🤖 CI

• Set correct base branch label (#​32325)

❤️ Contributors

• Mihailo Bursac (@​djixadin)
• Daniel Roe (@​danielroe)
• abeer0 (@​iiio2)
• 翠 (@​sapphi-red)
• Robin (@​OrbisK)
• Alex Liu (@​Mini-ghost)
• Damian Głowala (@​DamianGlowala)
• Julien Huang (@​huang-julien)
• Ibrahimm (@​Ibra-cesar)
• Peter Budai (@​peterbud)
• Ali Soueidan (@​lazercaveman)
• Vachmara (@​vachmara)
• xjccc (@​xjccc)
• Paul Melero (@​paulmelero)
• David Stack (@​davidstackio)

v3.17.5

Compare Source

3.17.5 is a regularly scheduled patch release.

✅ Upgrading

Our recommendation for upgrading is to run:

npx nuxt upgrade --dedupe

This will deduplicate your lockfile as well, and help ensure that you pull in updates from other dependencies that Nuxt relies on, particularly in the unjs ecosystem.

👉 Changelog

compare changes

🔥 Performance

• nuxt: Replace remaining instance of globby (#​31688)

🩹 Fixes

• nuxt: Export useScriptRybbitAnalytics from script stubs (d275ae1a0)
• nuxt: Remove unneeded pattern from regexp (2954c092c)
• nuxt: Ensure appConfig sources are not duplicated (#​32216)
• nuxt: Wrap slot with h() in ClientOnly (#​30664)
• kit: Ensure template filename uses safe patterns (4372b24dd)
• nuxt: Access asyncData state from nuxt app instance (#​32232)
• nuxt: Make patterns relative to srcDir in buildCache (#​32260)
• nuxt: Return non-existent route component in RouteProvider (#​32266)
• nuxt: Use single asyncData watcher (#​32247)
• vite: Use arrow functions in dynamic imports (#​32285)
• webpack: Use plugin for rollup-compatible dynamic imports (#​32281)

📖 Documentation

• Update addRouteMiddleware path in example (#​32171)
• Narrow link to just middleware (#​32203)
• Use optional chaining in error example (#​32214)
• Give example of using --env-file (29f6392cd)
• Recommend nuxt command consistently (#​32237)
• Fix typos (#​30413)
• Add props to special metadata (#​29708)
• Fix wrong alert with warning in /guide/pages (#​32270)
• Update upgrade guide + roadmap (0040ee5e7)

📦 Build

• nuxt: Ensure cache is typed (33df20d17)

🏡 Chore

• Upgrade webpack dependencies separately (444d60936)
• Apply lint fixes (221ce99eb)
• Add missing dependency (720170dea)

✅ Tests

• Add regression test for useAsyncData + transition (29f7c8cb4)
• Ensure builder tests run sequentially (defa32829)

❤️ Contributors

• Daniel Roe (@​danielroe)
• Julien Huang (@​huang-julien)
• Hugo Richard (@​HugoRCD)
• mxmxmmgg (@​mxmxmmgg)
• xjccc (@​xjccc)
• Horu (@​HigherOrderLogic)
• Baptiste Leproux (@​larbish)
• Phojie Rengel (@​phojie)
• duolaameng (@​1411430556)
• David Stack (@​davidstackio)

v3.17.4

Compare Source

3.17.4 is a regularly-scheduled patch release.

✅ Upgrading

Our recommendation for upgrading is to run:

npx nuxi@latest upgrade --dedupe

This will deduplicate your lockfile as well, and help ensure that you pull in updates from other dependencies that Nuxt relies on, particularly in the unjs ecosystem.

👉 Changelog

compare changes

🔥 Performance

• nuxt: Use Set for circular dep plugin (#​32110)
• Refactor Array.includes checks to use Sets (#​32133)
• nuxt: Use shallowRef for primitive values (#​32152)
• nuxt: Skip route rules processing for empty child array (#​32166)
• nuxt: Use Intl.Collator instead of localeCompare (#​32167)

🩹 Fixes

• nuxt: Do not await lazy asyncData inside <ClientOnly> (#​32101)
• nuxt: Respect cachedData with multiple asyncData calls (#​32099)
• nuxt: Clear async data after a tick (#​32096)
• nuxt: Support reactive keys in useLazyAsyncData (#​32092)
• rspack: Use ts-checker-rspack-plugin (#​32115)
• nuxt: Clear previous head in island-renderer (#​32100)
• nuxt: Handle virtual files prefixed with / (#​32129)
• schema: Remove nitro options from DeepPartial (#​31990)
• nuxt: Ensure legacy async data remains reactive (#​32134)
• nuxt: Pass attrs down to single child of <ClientOnly> (#​32131)
• nuxt: Fix merge conflicts (7044450d4)
• nuxt: Clone vnode when passing attrs down to client-only (b3acf0c78)
• vite: Do not replace global with globalThis (#​32130)
• nuxt: Suppress client-side errors by crawlers (#​32137)
• nuxt: Use fresh route when <NuxtLayout> first renders (#​24673)
• nuxt: Add additional logging when skipping error page for bot (68c270083)
• nuxt: Add watch paths outside srcDir to parcel strategy (#​32139)

📖 Documentation

• Use emphasis instead of quotes (#​32078)
• Update useNuxtData default return to undefined (#​32054)
• Capitalise headings (#​32095)
• Prefix imports.dirs with alias (0dbf314d9)
• Mention node v20 is minimum requirement for nuxt setup (#​32148)
• Use more descriptive link text (d0b1b9d35)

🏡 Chore

• Remove unneeded JSdoc comments (#​32090)
• Use vitest workspaces for tests (#​32121)

✅ Tests

• Add universal routing tests + clean up output (64178b6f4)
• nuxt: Add unit tests for watch strategies (#​32138)
• Resolve watch path (8fb562c04)
• Use fake timers instead of setTimeout mock (#​32142)

🤖 CI

• Rename workflow (835098fcb)
• Skip codeql event on merge_group events (46c259664)

❤️ Contributors

• John Tanzer (@​moshetanzer)
• Daniel Roe (@​danielroe)
• Robin (@​OrbisK)
• @​beer (@​iiio2)
• Julien Huang (@​huang-julien)
• हिमांशु (@​CodeMan62)
• Norbiros (@​Norbiros)
• watsonhaw5566 (@​watsonhaw5566)
• xjccc (@​xjccc)

v3.17.3

Compare Source

3.17.3 is a regularly-scheduled patch release.

✅ Upgrading

Our recommendation for upgrading is to run:

npx nuxi@latest upgrade --dedupe

This will deduplicate your lockfile as well, and help ensure that you pull in updates from other dependencies that Nuxt relies on, particularly in the unjs ecosystem.

👉 Changelog

compare changes

🔥 Performance

• nuxt: Pre-calculate extension glob before app resolution (#​32052)
• nuxt: Improve islands client components chunks (#​32015)

🩹 Fixes

• nuxt: Preload async layouts (#​32002)
• nuxt: Handle File within FormData (#​32013)
• schema: Respect user-provided ignore patterns (#​32020)
• nuxt: Allow loading virtual files with query params (#​32022)
• nuxt: Don't use reactive key for useFetch with watch: false (#​32019)
• nuxt: Do not clear data if custom getCachedData is provided (#​32003)
• nuxt: Provide nuxtApp for asyncData functions run on server (#​32038)
• vite: Strip queries when skipping vite transform middleware (#​32041)
• nuxt: Sort hash sources and files (#​32048)
• nuxt: Do not suppress chunk import error (#​32064)

💅 Refactors

• nuxt: Directly access initialised asyncData (e779d6cd5)

📖 Documentation

• Fix module initialization command for pnpm (#​32024)
• Provide nuxt installation guide with deno (#​32029)
• Add codeblock closing tag (#​32043)
• Tweak nuxt doc (#​32063)
• Add space between sentences (#​32069)

🤖 CI

• Convert bug/enhancement labels to issue types (3ff743fe0)
• Update payload for issue types (791e5f443)

❤️ Contributors

• Ryota Watanabe (@​wattanx)
• Julien Huang (@​huang-julien)
• John Tanzer (@​moshetanzer)
• @​beer (@​iiio2)
• Daniel Roe (@​danielroe)
• xjccc (@​xjccc)
• Max (@​onmax)

v3.17.2

Compare Source

3.17.2 is a regularly-scheduled patch release.

✅ Upgrading

Our recommendation for upgrading is to run:

npx nuxi@latest upgrade --dedupe

This will deduplicate your lockfile as well, and help ensure that you pull in updates from other dependencies that Nuxt relies on, particularly in the unjs ecosystem.

👉 Changelog

compare changes

🔥 Performance

• nuxt: Tree-shake router's handleHotUpdate in production (#​31971)

🩹 Fixes

• nuxt: Ensure asyncData is initialised before effects run (#​31946)
• nuxt: Skip view transition if user agent provides one before defining transition (#​31945)
• nuxt: Improve hashing for complex body in useFetch (#​31963)
• nuxt: Immediately call asyncData within client-only components (#​31964)
• nuxt: Don't render errors if event is already handled (#​31966)
• nuxt: Track whether need to reinit asyncData separately from deps (#​31965)
• nuxt: Preserve params/meta/matched with universal router (#​31950)
• nuxt: Respect scroll behavior set by scrollToTop (#​31914)
• nuxt: Load live data from vfs even if a file exists in buildDir (#​31969)
• nuxt: Short circuit middleware when validate returns false (#​31967)
• nuxt: Ensure useAsyncData reactive to key changes when immediate: false (#​31987)
• nuxt: Resolve real paths imported into virtual files (0bb07f129)
• webpack: Broaden WarningFilter type (2a79dbd68)
• schema: Broaden warningIgnoreFilters (a62e808ac)

📖 Documentation

• Add missing article (#​31952)
• Improve @nuxt/kit documentation (#​31793)
• Fix type issues in twoslash blocks (85ab105b8)
• Add events page (#​31977)

🏡 Chore

• Update approved builds (02b33cc58)
• Sort package keys (06aabc548)

✅ Tests

• Update bundle size snapshot (e03d44b47)
• Update bundle size (7f75f5ea5)
• Update bundle size again (e8a244bfc)
• Use asyncDataDefaults.value (91568c5da)

🤖 CI

• Run docs workflow against pull requests (08f968903)
• Run tests against node v20 (3c97d3493)

❤️ Contributors

• Daniel Roe (@​danielroe)
• Alex Liu (@​Mini-ghost)
• Martins Zeltins (@​martinszeltins)
• Ivan Martianov (@​ivansky)
• Lorenzo Fiamingo (@​lorenzofiamingo)
• James (@​Koshux)

v3.17.1

Compare Source

3.17.1 is the next patch release.

✅ Upgrading

Our recommendation for upgrading is to run:

npx nuxi@latest upgrade --dedupe

This will deduplicate your lockfile as well, and help ensure that you pull in updates from other dependencies that Nuxt relies on, particularly in the unjs ecosystem.

👉 Changelog

compare changes

🩹 Fixes

• nuxt: Check if match exists with new unplugin filter (#​31929)
• nuxt: Reinitialise stale async data (#​31940)
• nuxt: Skip view transition if user agent is providing one (#​31938)
• nuxt: Trigger execute when non-immediate fetch key changes (#​31941)
• nuxt: Don't redirect when route has trailing slash (#​31902)
• ui-templates: Use escapeHTML from vue (8e4b8d62f)
• schema: Add @vue/shared dependency (7d445c963)

📦 Build

• Copy README/LICENSE from repo root (8e287d556)

🏡 Chore

• Update docs version (db5ad4a8f)
• Add docs directory to publish scripts (d3bcad632)

✅ Tests

• Update snapshots (a197d1087)

❤️ Contributors

• Daniel Roe (@​danielroe)
• Pooya Parsa (@​pi0)
• Kyohei Sonokawa (@​kyohei-23)
• Lorenzo Fiamingo (@​lorenzofiamingo)

v3.17.0

Compare Source

👀 Highlights

This release brings a major reworking of the async data layer, a new built-in component, better warnings, and performance improvements!

📊 Data Fetching Improvements

A major reorganization of Nuxt's data fetching layer brings significant improvements to useAsyncData and useFetch.

Although we have aimed to maintain backward compatibility and put breaking changes behind the experimental.granularCachedData flag (disabled by default), we recommend testing your application thoroughly after upgrading. You can also disable experimental.purgeCachedData to revert to the previous behavior if you are relying on cached data being available indefinitely after components using useAsyncData are unmounted.

👉 Read the the original PR for full details (#​31373), but here are a few highlights.

Consistent Data Across Components

All calls to useAsyncData or useFetch with the same key now share the underlying refs, ensuring consistency across your application:

<!-- ComponentA.vue -->
<script setup>
const { data: users, pending } = useAsyncData('users', fetchUsers)
</script>

<!-- ComponentB.vue -->
<script setup>
// This will reference the same data state as ComponentA
const { data: users, status } = useAsyncData('users', fetchUsers)
// When either component refreshes the data, both will update consistently
</script>

This solves various issues where components could have inconsistent data states.

Reactive Keys

You can now use computed refs, plain refs, or getter functions as keys:

const userId = ref('123')
const { data: user } = useAsyncData(
  computed(() => `user-${userId.value}`),
  () => fetchUser(userId.value)
)

// Changing the userId will automatically trigger a new data fetch
// and clean up the old data if no other components are using it
userId.value = '456'

Optimized Data Refetching

Multiple components watching the same data source will now trigger only a single data fetch when dependencies change:

// In multiple components:
const { data } = useAsyncData(
  'users', 
  () => $fetch(`/api/users?page=${route.query.page}`),
  { watch: [() => route.query.page] }
)

// When route.query.page changes, only one fetch operation will occur
// All components using this key will update simultaneously

🎭 Built-In Nuxt Components

<NuxtTime> - A new component for safe time display

We've added a new <NuxtTime> component for SSR-safe time display, which resolves hydration mismatches when working with dates (#​31876):

<template>
  <NuxtTime :datetime="Date.now()" />
</template>

The component accepts multiple time formats and gracefully handles both client and server rendering.

Enhanced <NuxtErrorBoundary>

The <NuxtErrorBoundary> component has been converted to a Single File Component and now exposes error and clearError from the component - as well as in the error slot types, giving you greater ability to handle errors in your templates and via useTemplateRef (#​31847):

<NuxtErrorBoundary @&#8203;error="handleError">
  <template #error="{ error, clearError }">
    <div>
      <p>{{ error.message }}</p>
      <button @&#8203;click="clearError">Try again</button>
    </div>
  </template>
  
  <!-- Content that might error -->
  <MyComponent />
</NuxtErrorBoundary>

🔗 Router Improvements

<NuxtLink> now accepts a trailingSlash prop, giving you more control over URL formatting (#​31820):

<NuxtLink to="/about" trailing-slash>About</NuxtLink>
<!-- Will render <a href="/about/"> -->

🔄 Loading Indicator Customization

You can now customize the loading indicator with new props directly on the component (#​31532):

• hideDelay: Controls how long to wait before hiding the loading bar
• resetDelay: Controls how long to wait before resetting loading indicator state

<template>
  <NuxtLoadingIndicator :hide-delay="500" :reset-delay="300" />
</template>

📚 Documentation as a Package

The Nuxt documentation is now available as an npm package! You can install @nuxt/docs to access the raw markdown and YAML content used to build the documentation website (#​31353).

💻 Developer Experience Improvements

We've added several warnings to help catch common mistakes:

• Warning when server components don't have a root element #​31365
• Warning when using the reserved runtimeConfig.app namespace #​31774
• Warning when core auto-import presets are overridden #​29971
• Error when definePageMeta is used more than once in a file #​31634

🔌 Enhanced Module Development

Module authors will be happy to know:

• A new experimental.enforceModuleCompatibility allows Nuxt to throw an error when a module is loaded that isn't compatible with it (#​31657). It will be enabled by default in Nuxt v4.
• You can now automatically register every component exported via named exports from a file with addComponentExports #​27155

🔥 Performance Improvements

Several performance improvements have been made:

• Switched to tinyglobby for faster file globbing #​31668
• Excluded .data directory from type-checking for faster builds #​31738
• Improved tree-shaking by hoisting the purgeCachedData check #​31785

✅ Upgrading

Our recommendation for upgrading is to run:

npx nuxi@latest upgrade --dedupe

This refreshes your lockfile and pulls in all the latest dependencies that Nuxt relies on, especially from the unjs ecosystem.

👉 Changelog

compare changes

🚀 Enhancements

• nuxt: Accept hideDelay and resetDelay props for loading indicator (#​31532)
• nuxt: Warn server components need root element (#​31365)
• docs: Publish raw markdown/yaml docs as @nuxt/docs (#​31353)
• kit,nuxt: Pass dotenv values from loadNuxtConfig to nitro (#​31680)
• nuxt,vite: Support disabling scripts in dev mode (#​31724)
• nuxt: Warn if user uses reserved runtimeConfig.app namespace (#​31774)
• kit,schema: Allow throwing error if modules aren't compatible (#​31657)
• nuxt: Extract middleware when scanning page metadata (#​30708)
• nuxt: Warn if core auto-import presets are overridden (#​29971)
• nuxt: Scan named exports with addComponentExports (#​27155)
• nuxt: Convert <NuxtErrorBoundary> to SFC + expose error/clearError (#​31847)
• nuxt: Add <NuxtTime> component for ssr-safe time display ([#​31876](https://redirect.github.com/nuxt/nuxt/pull/31876

---

Configuration

📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 Automerge: Enabled.

♻ Rebasing: Whenever PR is behind base branch, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about these updates again.

---

• If you want to rebase/retry this PR, check this box

---

This PR was generated by Mend Renovate. View the repository job log.