Nuxt Files

3.20.2 is the next patch release.

✅ Upgrading

Our recommendation for upgrading is to run:

:::sh
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)