Update dependency nuxt to v3.20.2

[renovate]

Note: This PR body was truncated due to platform limits.

This PR contains the following updates:

Package	Change	Age	Confidence
nuxt (source)	3.11.2 -> 3.20.2

---

Release Notes

nuxt/nuxt (nuxt)

v3.20.2

Compare Source

3.20.2 is the next patch release.

✅ Upgrading

Our recommendation for upgrading is to run:

npx nuxt upgrade --dedupe --channel=v3

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.

[!NOTE]
This will only work if you already have a version of @nuxt/cli which has the --channel flag. If this does not work, you can instead run npx nuxi@latest for the initial upgrade.

👉 Changelog

compare changes

🩹 Fixes

• nitro: Do not show pretty error handler when testing (cc75ce409)
• nuxt: Generate valid references for component declaration items (#​33388)
• nuxt: Sync internal route before calling page:finish hook (#​33707)
• nitro: Ensure html is a string before injecting error handler (6f51a25e9)
• nitro: Include layer server directories in tsconfig.server.json (#​33510)
• nuxt: Ensure deduped async data executions return latest promise (#​33740)
• kit,nuxt: Type + respect moduleDependencies by meta name (#​33774)
• nuxt,schema: Ignore .d.vue.ts declarations (9a6a770ab)
• kit,nuxt: Protect against resolved nuxt module subpath (#​33767)
• nuxt: Re-execute callOnce during HMR (#​33810)
• nuxt: Resolve watch callback after reactive key change in useAsyncData (#​33802)
• nuxt: Escape HTML in development error page stack trace (#​33820)
• kit: Do not add resolved rootDir to cached layer config (#​33779)
• kit,schema: Add moduleDependencies -> installModule (#​33689)

💅 Refactors

• nuxt: Improve type safety within callOnce function (#​33825)

📖 Documentation

• Split directory structure and re-order guides (v3) (#​33690)
• Fix link (016ef66e3)
• Add hints release (#​33701)
• Fix link to vitest globals config (#​33702)
• Fix 404 link (5543b7cf7)
• Text consistency (#​33709)
• Type error as non-optional prop (#​33763)

🏡 Chore

• Update pnpm to 10.21 and enable trust policy (1cb55efc0)
• Revert pnpm trust policy and restore provenance action (103ae1351)
• Update markdownlint config to ignore mdc issues (d4933e26e)
• Pin to single version of unstorage (619956e7f)

✅ Tests

• Add patchProp and nodeOps to excluded Vue helpers (#​33754)
• Use fake timers for watch params test (58607fbea)
• Update test for v3 defaults (daa002638)

🤖 CI

• Add --pnpm flag to correctly publish prerelease (#​33688)
• Update action lint config (#​33710)

❤️ Contributors

• Daniel Roe (@​danielroe)
• Alexander Lichter (@​TheAlexLichter)
• Florian Heuberger (@​Flo0806)
• Konstantin Telyakov (@​kTelyakov)
• abeer0 (@​iiio2)
• Julien Huang (@​huang-julien)
• Robin (@​OrbisK)
• Dheeraj Joshi (@​dheeraj3587)
• Edwin Samodra (@​edwinsamodra)
• edison (@​edison1105)
• 山吹色御守 (@​KazariEX)
• Sébastien Chopin (@​atinux)
• pierreoa (@​pierreoa)
• Maxime Pauvert (@​maximepvrt)

v3.20.1

Compare Source

v3.20.0

Compare Source

3.20.0 is the next minor 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

🚀 Enhancements

• nuxt: Allow specifying component declarationPath (#​33419)
• kit: Add extensions option for resolveModule (#​33328)
• nuxt: Add abortController option to useAsyncData (#​32531)
• nuxt: Display youch error page w/ user error page in dev (#​33359)
• nuxt: Experimental typescript plugin support (#​33314)
• nuxt,schema: Extract asyncData handlers to chunks (#​33131)
• kit: Add setGlobalHead utility (#​33512)
• kit,vite: Allow enabling vite environment api (#​33492)

🔥 Performance

• nuxt: Precompute renderer dependencies at build time (#​33361)
• kit,schema: Remove some unnecessary dependencies (bdf34c263)

🩹 Fixes

• nuxt: Preserve hash with redirecting based on routeRules (#​33222)
• kit: Safely cleanup loadNuxtConfig in concurrent calls (#​33420)
• nuxt: Allow object-format href in <NuxtLink> (b97ae2f70)
• nuxt: Remove mergeModels from auto imports (#​33344)
• nuxt: Add back shortPath property (#​33384)
• nuxt: Do not allow native attrs to shadow nuxt link props (0981990a7)
• nuxt: Remove declarationPath from component dirs (e384ba3cb)
• nuxt: Preserve root route in isPrerendered check (#​33476)
• nuxt: Exempt webpack vfs from pkg lookup (4df1e8275)
• nitro: Exempt nightly release from import protections (272d9abbe)
• webpack,rspack: Preserve prerender + nitro flags in server builds (#​33503)
• nuxt: Support component auto-imports as arguments of h() (#​33509)
• vite: Prevent assignment for rolldown's replacement plugin (#​33526)
• nuxt: Use sha256 hash for prerender cache keys (#​33505)
• nuxt: Add NuxtTime relative time numeric prop (#​33552)
• nuxt: Add NuxtTime relative time relativeStyle prop (#​33557)
• nuxt: Handle arrays in app config correctly during HMR (#​33555)

💅 Refactors

• Remove obsolete shortPath property (#​33384)
• kit: Extract trace utilities (ddaedfa51)
• nuxt,vite,webpack: Allow builders to augment types (#​33427)
• schema: Deprecate extend, extendConfig, and configResolved hooks (932a80dc6)
• nitro,nuxt: Extract @nuxt/nitro-server package (#​33462)
• nuxt: Use RouteLocationNormalizedLoadedGeneric internally (aa211fb4f)
• vite: Make vite plugins environment-compatible (#​33445)

📖 Documentation

• Add nuxt module addServerPlugin note (#​33409)
• Remove deprecated node version (#​33411)
• Update declarationPath in addComponent (#​33380)
• Add some notes/deprecations for vite hooks (2c6912d2f)
• Fix incorrect ESM module field info (#​33451)
• Recommend getLayerDirectories() instead of nuxt.options._layers (#​33484)
• Add docs for moduleDependencies (#​33499)
• Pin codemod to v0.18.7 for migration recipe (#​33522)

🏡 Chore

• Migrate gitpod to ona (#​33159)
• Use native node to run test:prepare (cbad63c02)
• Do not use native node to run test:prepare (672c09423)
• Update valid semantic scopes (4ca29168b)
• Ignore nitro templates (ec59aceeb)
• Remove vue-demi from ignoredBuiltDependencies (#​33494)
• Update vscode url (#​33360)
• Correct jsdoc location for function used as parameters (#​33507)
• Remove code comment (#​33515)
• Patch changelogen for large numbers of commits (b6530b5b6)
• Filter out commits before last tag when constructing changelog (257049712)
• Ignore @rollup/plugin-commonjs (c2bd323b8)
• Pin @rollup/plugin-commonjs (a524522ea)

✅ Tests

• Update runtime test to use asyncDataDefaults.errorValue (b6f1c9b0d)
• Refactor suite to use common matrix utils (#​33483)
• Update typed router test (c55db2854)

🤖 CI

• Publish @nuxt/nitro-server on pkg-pr-new (d37ef17b0)
• Remove nitro-server publish until v4.2 is released (e34c2f52f)
• For now, use tag push to trigger release (0705b835f)

❤️ Contributors

• Daniel Roe (@​danielroe)
• 山吹色御守 (@​KazariEX)
• Matej Černý (@​cernymatej)
• Trung Dang (@​NamesMT)
• 纸鹿/Zhilu (@​L33Z22L11)
• Florian Heuberger (@​Flo0806)
• Alexander Lichter (@​TheAlexLichter)
• Julien Huang (@​huang-julien)
• abeer0 (@​iiio2)
• Max (@​onmax)
• Octavio Araiza (@​8ctavio)
• Bobbie Goede (@​BobbieGoede)
• DipakHalkude (@​DipakHalkude)
• Aleksander Błaszkiewicz (@​ablaszkiewicz)

v3.19.3

Compare Source

3.19.3 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

• vite: Use rolldown's replace plugin when applicable (#​33258)

🩹 Fixes

• nuxt: Make lazy component types compatible with h (#​33046)
• vite: Deduplicate inlined server style chunks (#​33308)
• nuxt: Support head option on useHead (#​33318)
• nuxt: Do not relativise importmap if cdnURL is set (#​33333)
• nuxt: Resolve aliases in imports.dirs (#​33334)
• nuxt: Add missing element/vnode props for <NuxtLink> (#​33335)
• nuxt: Do not generate server placeholder components (#​33345)
• nuxt: Dedupe generated component names (#​33346)
• webpack: Test watch instance before closing it (3314bc9a1)
• nuxt: Correctly handle island rendering error (#​33302)
• nuxt: Support v-slot:fallback longform syntax in <DevOnly> (#​33368)
• nuxt: Support typeFrom when generating auto-import type templates (#​33373)
• nuxt: Don't trigger scroll when changing trailing slash (#​33358)
• nuxt: Add stubs for new scripts from @nuxt/scripts (057ade490)
• nuxt: Prevent duplicate execution on key change in useAsyncData (#​33325)
• nuxt: Make middleware _path property configurable for HMR (#​33379)
• nuxt: Handle non-immediate useAsyncData with different key on ssr (#​33341)

💅 Refactors

• nuxt: Improve implementation of error composables (#​33234)
• nuxt: Resolve path of typed-router.d.ts early for consistency (#​33285)
• nuxt: Place filename into componentsIslandsTemplate definition (#​33394)
• nuxt,vite: Use environment-api compatible plugins (#​33403)

📖 Documentation

• Update usage instructions for Windows users (#​33284)
• Remove d suffix in example (#​33298)
• Move directory structure to top-level (#​33299)
• Add 3.x prefix to all internal links (0fef864d6)
• Add information about useFetch reactivity (#​33317)
• Lint code samples within docs (#​33271)
• Note prepare command NODE_ENV behavior (#​33330)
• Update nuxt command pages (#​33336)

🏡 Chore

• Update bundle size test (15334d0c1)
• Temporarily disable link to github sponsors (53b02251f)
• Update markdownlint ignore (557656e54)
• Migrate pnpm settings out of .npmrc (101682a6b)
• Ignore errors from npmjs (d56790347)
• nuxt: Align global components indent (#​33340)
• Remove tea.yaml (8b2188848)
• Remove todo comment as resolved (#​33389)
• Downgrade nitropack in vite (3419f3414)

✅ Tests

• nuxt: Set locale to en for nuxt-time tests (#​33343)
• Double gotoPath timeout in CI (9d336cc76)

🤖 CI

• Add provenance action to check for downgrades in provenance (18ab6e5fa)
• Pass commit sha when triggering ecosystem ci (7b2949a3c)

❤️ Contributors

• Daniel Roe (@​danielroe)
• 山吹色御守 (@​KazariEX)
• Julien Huang (@​huang-julien)
• Florian Heuberger (@​Flo0806)
• Ondrej Brendy (@​bandiasek)
• Octavio Araiza (@​8ctavio)
• Alex Liu (@​Mini-ghost)
• Bobbie Goede (@​BobbieGoede)
• abeer0 (@​iiio2)
• Harlan Wilton (@​harlan-zw)
• Alexander Lichter (@​TheAlexLichter)
• Sébastien Chopin (@​atinux)
• Ben Hong (@​bencodezen)
• Huseyn Guliyev (@​husayt)

v3.19.2

Compare Source

3.19.2 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

• kit: Do not normalise templates in loop if dst is present (#​33200)
• nuxt: Remove watcher from hydrate-when lazy hydration strategy (#​33199)
• nuxt,schema: Normalise components + directories more efficiently (#​33207)
• kit,nuxt: Reduce unnecessary iteration in nuxt code (#​33212)
• nuxt: Skip running lazy hydration transform with filter (#​33213)

🩹 Fixes

• schema: Add pkg-types to dependencies (a6e5dd756)
• nuxt: Ignore errors when treeshaking composables within other composables (e3e42ac77)
• nuxt: Do not tree-shake composables within other composables (#​33153)
• kit: Ensure module dependencies are typed correctly (ea16d182a)
• nuxt: Prevent Infinity backgroundSize in loading indicator (#​33211)
• nuxt: Remove unused enabled from components dir options (#​32844)
• nuxt: Sync watch request in useAsyncData (#​33192)
• nuxt: Move key imports logic after all modules run (#​33214)

📖 Documentation

• Update language on bridge head migration (32e76f609)

🏡 Chore

• nuxt: Unpin tinyglobby (1811db080)

❤️ Contributors

• Daniel Roe (@​danielroe)
• Adrien Foulon (@​Tofandel)
• Matej Černý (@​cernymatej)
• Антон Стасюк (@​11Alone11)
• wuiyang (@​wuiyang)

v3.19.1

Compare Source

v3.19.1 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

🩹 Fixes

• nuxt: Correct relative path of auto imported components (#​33122)
• nuxt: Prefer accessing globalThis over window (#​33125)
• nuxt: Migrate to AST-aware tree-shaking + route injection (#​33128)
• nuxt: Ignore #components import mapping inside packages that use it internally (#​33049)
• vite: Remove explicit vite-node configuration of deps.inline (#​33133)
• nuxt: Include trace in dev-time useRoute usage warning (#​33039)
• nuxt: Print route middleware path in warning (#​33136)
• nuxt: Include core auto-imports from imports:sources in override warning (#​33050)
• nuxt: Render relative importmap entry path if required (#​33146)

📖 Documentation

• Add documentation for module lifecycle hooks (#​33115)
• Add -- to bun create command (ab6aa8ee5)
• Add JSDoc for navigateTo (#​21442)

🏡 Chore

• Correct rou3 github url (#​33130)
• Include .ts extension (2c905f864)

✅ Tests

• Bump bundle size (15564deb9)
• Remove app/ prefix for tree-shaken composables (06ea91705)

🤖 CI

• Remove default discord reactions from thread (more noise than it's worth) (2e3c91e0c)
• Rewrite release workflow in ts + support multiple tags (478c64342)
• Pass correct flag (a954f383f)
• Pass tag via env variable (dcfc82688)
• Drop 4x tags from releases (e3aa50d11)

❤️ Contributors

• Daniel Roe (@​danielroe)
• Matej Černý (@​cernymatej)
• Bobbie Goede (@​BobbieGoede)
• Octavio Araiza (@​8ctavio)
• Michael Brevard (@​GalacticHypernova)
• abeer0 (@​iiio2)
• 山吹色御守 (@​KazariEX)

v3.19.0

Compare Source

👀 Highlights

Please see the release notes for Nuxt v4.1 for full details on the features and fixes in Nuxt v3.19.

✅ Upgrading

As usual, our recommendation for upgrading is to run:

npx nuxt upgrade --dedupe

This will refresh your lockfile and pull in all the latest dependencies that Nuxt relies on, especially from the unjs ecosystem.

👉 Changelog

compare changes

🚀 Enhancements

• kit: Add ignore option to resolveFiles (#​32858)
• kit: Add onInstall and onUpgrade module hooks (#​32397)
• nuxt,vite: Add experimental support for rolldown-vite (#​31812)
• nuxt: Extract defineRouteRules to page rules property (#​32897)
• nuxt,vite: Use importmap to increase chunk stability (#​33075)
• nuxt: Lazy hydration macros without auto-imports (#​33037)
• kit,nuxt,schema: Allow modules to specify dependencies (#​33063)
• kit,nuxt: Add getLayerDirectories util and refactor to use it (#​33098)

🔥 Performance

• nuxt: Clear inline route rules cache when pages change (#​32877)
• nuxt: Stop watching app manifest once a change has been detected (#​32880)

🩹 Fixes

• nuxt: Handle satisfies in page augmentation (#​32902)
• nuxt: Type response in useFetch hooks (#​32891)
• nuxt: Add TS parenthesis and as expression for page meta extraction (#​32914)
• nuxt: Use correct unit thresholds for relative time (#​32893)
• nuxt: Handle uncached current build manifests (#​32913)
• kit: Resolve directories in resolvePath and normalize file extensions (#​32857)
• schema,vite: Bump requestTimeout + allow configuration (#​32874)
• nuxt: Deep merge extracted route meta (#​32887)
• nuxt: Do not expose app components until fully resolved (#​32993)
• kit: Only exclude node_modules/ if no custom srcDir (#​32987)
• nuxt: Compare final matched routes when syncing route object (#​32899)
• nuxt: Make vue server warnings much less verbose in dev mode (#​33018)
• schema: Allow disabling cssnano/autoprefixer postcss plugins (#​33016)
• kit: Ensure local layers are prioritised alphabetically (#​33030)
• kit,nuxt: Expose global types to vue compiler (#​33026)
• nuxt: Support config type inference for defineNuxtModule().with() (#​33081)
• nuxt: Search for colliding names in route children (31a9282c2)
• nuxt: Delete nuxtApp._runningTransition on resolve (#​33025)
• nuxt: Add validation for nuxt island reviver key (#​33069)
• kit: Prioritise local layers over extended layers (ae8b0d2b8)
• kit: Address merge conflict (89ccbbebb)
• kit: Do not resolve public dir aliases (5d87d3a80)

💅 Refactors

• nuxt: Simplify page segment parsing (#​32901)
• nuxt: Remove unnecessary async/await in afterEach (#​32999)
• vite: Simplify inline chunk iteration (9ea90fc33)
• kit,nuxt,ui-templates,vite: Address deprecations + improve regexp perf (#​33093)

📖 Documentation

• Add a section about augmenting types with TS project references (#​32843)
• Switch example to use vitest projects (#​32863)
• Update testing setupTimeout and add teardownTimeout (#​32868)
• Add middleware to layers guide (fa516d440)
• Add documentation for --nightly command (#​32907)
• Update package information in roadmap section (#​32881)
• Add more info about nuxt spa loader element attributes (#​32871)
• Correct filename in example (#​33000)
• Add more information about using useRoute and accessing route in middleware (#​33004)
• Avoid variable shadowing in locale example (#​33031)

🏡 Chore

• Remove stray test file (42fd247a4)
• Ignore webpagetest.org when scanning links (cb18f4960)
• Add type: 'module' in playground (#​33099)

✅ Tests

• Add failing test for link component duplication (#​32792)
• Simplify module hook tests (#​32950)
• Refactor stubbing of import.meta.dev (#​33023)
• Use findWorkspaceDir rather than relative paths to repo root (c4c3ada96)
• Improve router test for global transitions (7e6a6fc35)
• Use expect.poll (f4354203a)
• Use expect.poll instead of expectWithPolling (15ca5be95)
• Use vi.waitUntil instead of custom retry logic (4c8c13090)
• Update test for app creation (9a3b44515)
• Update bundle size snapshot (76988ce97)

🤖 CI

• Remove double set of tests for docs prs (14c006ac4)
• Add workflow for discord team discussion threads (f14854fc3)
• Fix some syntax issues with discord + github integrations (c059f7cd1)
• Use token for adding issue to project (51661bac3)
• Use discord bot to create thread automatically (37f9eb27b)
• Only use discord bot (38ce2dcbb)
• Update format of discord message (0047b3059)
• Try bolding entire line (6e9f40eb9)
• Oops (8b044cad2)
• Add delay after adding each reaction (37b7e2108)
• Use last lts node version for testing (98719c065)
• Try npm trusted publisher (ea33502c3)
• Use npm trusted publisher for main releases (31a55437f)
• Change wording (#​32979)
• Add github ai moderator (#​33077)

❤️ Contributors

• Daniel Roe (@​danielroe)
• abeer0 (@​iiio2)
• Julien Huang (@​huang-julien)
• kyumoon (@​kyumoon)
• Alexander Lichter (@​TheAlexLichter)
• Bobbie Goede (@​BobbieGoede)
• mustafa60x (@​mustafa60x)
• Matej Černý (@​cernymatej)
• Alex Liu (@​Mini-ghost)
• Amitav Chris Mostafa (@​semibroiled)
• Romain Hamel (@​romhml)
• Jacky Lam (@​jackylamhk)
• Mukund Shah (@​mukundshah)
• Luke Nelson (@​luc122c)
• letianpailove (@​letianpailove)
• Erwan Jugand (@​erwanjugand)
• Alexander (@​TheColorman)
• Ryota Watanabe (@​wattanx)
• Yizack Rangel (@​Yizack)

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.

---

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.

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

---

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

---

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

[netlify]

❌ Deploy Preview for anohi-no-tweet failed.

Name	Link
🔨 Latest commit	ec02708
🔍 Latest deploy log	https://app.netlify.com/projects/anohi-no-tweet/deploys/69386f424de7ed0007840a8d