chore(deps): update nuxt core (minor)

[renovate]

This PR contains the following updates:

Package	Change	Age	Adoption	Passing	Confidence
@nuxt/kit (source)	^3.2.0 -> ^3.14.0
@nuxt/test-utils	3.2.0 -> 3.14.4

---

Release Notes

nuxt/nuxt (@​nuxt/kit)

v3.14.0

Compare Source

v3.13.2

Compare Source

3.13.2 is the next regularly scheduled patch release.

✅ Upgrading

As usual, our recommendation for upgrading is to run:

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

🔥 Performance

• nuxt: Remove interop default for dynamic components (#​28912)

🩹 Fixes

• nuxt: Fix ssr log querySelector (#​28864)
• schema: Enable propsDestructure by default (#​28830)
• nuxt: Ensure injected route has enumerable keys (#​28841)
• nuxt: Don't override vue instance with legacy asyncData (#​28842)
• nuxt: Render server errors with ssr: false (#​28834)
• nuxt: Resolve full component paths (#​28843)
• nuxt: Improve accuracy of module resolution conditions (#​28846)
• nuxt: Log more context of prerendering errors (#​28895)
• nuxt: Enable injectAtEnd to reduce circular auto-imports (#​28822)
• nuxt: Ensure we process files in buildDir for unimport (#​28899)
• nuxt: Do not accept attrs on <NuxtErrorBoundary> (#​28901)
• nuxt,schema: Accept any module in inline modules array (#​28922)
• nuxt: Fall back to original component filePath (#​28925)
• nuxt: Make runWithContext generic (#​28926)
• nuxt: Set inheritAttrs: false for fragment components (#​28939)
• nuxt: Use case-insensitive regexp for <script> blocks (4fd24381c)
• nuxt: Ensure component imports are injected last (#​28944)
• nuxt: Catch chunk errors directly in navigation (820908696)
• nuxt: Add missing isNuxtMajorVersion export (#​29016)
• nuxt: Correct type for useError (#​28996)

💅 Refactors

• nuxt: Use vite:preloadError event (#​28862)

📖 Documentation

• Add known limitations for app.config.ts (#​28875)
• Typo fixed missing closing angle bracket (#​28880)
• Update useFetch troubleshooting section (#​28918)
• Capitalize text (#​28972)
• Fix typo (#​28983)
• Add clarity to useFetch parameter signature (#​28993)
• Remove confusing reference to 'SPA' (#​28991)

🏡 Chore

• Use consola to log out compatibility info (#​28854)
• vite: Use correct type import (3f508d521)
• Enable noUncheckedSideEffectImports (#​28903)
• Add pending triage to blank issues (#​28923)
• Correct comment style (c4181b5a2)
• Fix typos (462380d45)
• Refresh lockfile, use htmlnano + pin workflow deps (#​28946)
• Pin dep + workflow by hash (4d81334c9)
• ui-templates: Use class-selector (043329f52)

✅ Tests

• Collect bundle sizes in parallel (1ce81069d)
• Add regression test for using route in template (#​28967)
• Convert set to array (6ee3b3adc)
• Switch inline snapshot to object comparison (ae5135363)

🤖 CI

• Access issue number from payload (8e4585c14)
• Configure codeql to ignore tests (d5f98a757)
• Add default permissions for workflows (3ede01cd4)
• Scan source files with codeql (#​28943)
• Skip setting up node before codeql scan (c4d7c92e9)

❤️ Contributors

• Daniel Roe (@​danielroe)
• Artem Maslov (@​Twocram)
• Paulo Ricardo Severo (@​prsevero)
• Nishant Aanjaney Jalan (@​cybercoder-naj)
• @​beer (@​iiio2)
• Julien Huang (@​huang-julien)
• Liran Tal (@​lirantal)
• Anthony Fu (@​antfu)
• Osama Abdallah Essa Haikal (@​OsamaHaikal)

v3.13.1

Compare Source

3.13.1 is the next regularly scheduled patch release.

👀 Highlights

Although this is a patch release, there are two features I'd love to draw your attention to.

1. 🆔 useId now uses a built-in Vue composable for stable ids between server + client! https://github.com/nuxt/nuxt/pull/28285
2. 🔥 a new experimental.buildCache feature now allows for quicker app rebuilds https://github.com/nuxt/nuxt/pull/28726

As always, feedback is appreciated 🙏 ❤️

✅ Upgrading

As usual, our recommendation for upgrading is to run:

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

🔥 Performance

• nuxt: Cache vue app build outputs (#​28726)
• nuxt: Use ServerPlaceholder for ssr client components (#​28563)
• nuxt: Use reducer array + handle modified proto (#​28768)

🩹 Fixes

• schema: Resolve user-provided serverDir relative to root (#​28700)
• nuxt: Handle mismatching declaration/plugin extensions (#​28709)
• nuxt: Do not accept arbitrary strings for MiddlewareKey (#​28676)
• nuxt: Do not pass listeners to custom NuxtLink (#​28738)
• nuxt: Generate basic jsdoc for module config entry (#​27689)
• nuxt: Augment NuxtOptions as well as config (#​28747)
• nuxt: Improve error logging in import protections (#​28753)
• nuxt: Handle deleted cookies from CookieStore events (#​28760)
• nuxt: Allow updating appConfig with non-iterable objects (#​28773)
• nuxt: Improve isNuxtError type inference (#​28814)

💅 Refactors

• nuxt: Update to vue v3.5 + native useId (#​28285)

📖 Documentation

• Fix typo (#​28724)
• Update broken/redirected links (#​28739)
• Capitalize text (#​28734)
• Updated line number for nuxt build-time hooks (#​28746)
• Add missing query returned value from useRoute() (#​28743)
• Persist package manager choice in code blocks (#​28514)
• Fix postcss codeblock typo (#​28801)
• Include --frozen-lockfile when installing dependencies (#​28794)

🏡 Chore

• Use tinyexec internally (#​28684)
• Use tinyglobby internally (#​28686)
• Trim tag (#​28687)
• Fix ci typo (#​28721)
• Tidying workflows + add sherif workflow (#​28793)
• Ignore eslint warnings about console logging (#​28795)

✅ Tests

• Update bundle size (99df4c222)

❤️ Contributors

• Gianluca Di Francesco (@​gianlucadifrancesco)
• Daniel Roe (@​danielroe)
• Joaquín Sánchez (@​userquin)
• Heb (@​Hebilicious)
• Eckhardt (Kaizen) Dreyer (@​Eckhardt-D)
• Gustav Odinger (@​gustavwilliam)
• Julien Huang (@​huang-julien)
• Ismail Sabet (@​ismailsabet)
• Max (@​onmax)
• Anthony Fu (@​antfu)
• @​beer (@​iiio2)
• riskrole (@​riskrole)
• Thimo Sietsma (@​th1m0)

v3.13.0

Compare Source

👀 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:

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

🏝️ 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.

🪝 Custom Prefetch Triggers

We now support custom prefetch triggers for NuxtLink (#​27846).

For example:

<template>
  <div>
    <NuxtLink prefetch-on="interaction">
      This will prefetch when hovered or when it gains focus
    </NuxtLink>
    <!-- note that you probably don't want both enabled! -->
    <NuxtLink :prefetch-on="{ visibility: true, interaction: true }">
      This will prefetch when hovered/focus - or when it becomes visible
    </NuxtLink>
  </div>
</template>

It's also possible to enable/disable these globally for your app and override them per link.

For example:

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).

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:

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) and better inferred typing for merged module options using the new defineNuxtModule().with() method (#​27520).

✨ Improved Dev Warnings

We no longer warn when using data fetching composables in middleware (#​28604) and we warn when user components' names begin with Lazy (#​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, GlobalComponents and so on).

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

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:

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

🚀 Enhancements

• nuxt: Await custom routes function in router.options (#​27644)
• kit: Add new isNuxtMajorVersion compatibility util (#​27579)
• kit,schema: Add .with for better module options types (#​27520)
• nuxt: Warn when user components' names begin with Lazy (#​27838)
• nuxt: Allow specifying app id when creating a nuxt app (#​28392)
• nuxt: Custom enable/disable hooks for usePreviewMode (#​28371)
• kit: Add prepend option to addRouteMiddleware (#​28496)
• nuxt: Allow organising pages within route groups (#​28276)
• vite: Preserve vite sourcemaps for nitro build (#​28521)
• nuxt: Allow defining triggers for prefetching links (#​27846)
• nuxt: Namespace __NUXT__ when using multi-app (#​27263)
• nuxt: Allow server islands to manipulate head (#​27987)

🔥 Performance

• nuxt: Call cookie decode function only for named cookie (#​28215)
• nuxt: Avoid making client-only component setup async (#​28334)
• nuxt: Avoid multiple calls to getCachedData (#​28472)

🩹 Fixes

• nuxt: Don't warn for definePageMeta in client-only pages (#​28246)
• kit: Include module dist/runtime/ in tsconfig includes (#​28237)
• schema: Support absolute/relative paths for assetsDir (59f0099f4)
• schema: Do not override user serverDir (#​28249)
• schema: Use new options syntax for vite-plugin-vue (#​28307)
• schema: Export new module return types (c0ad8db93)
• kit: Add missing type import (1a60b4541)
• vite,webpack: Handle local postcss plugins (#​28481)
• nuxt: Handle scroll-padding-top: auto in scrollBehavior (#​28320)
• nuxt: Ensure runtimeConfig.public is reactive on client (#​28443)
• nuxt: Update renamed stub composables from nuxt/scripts (#​28449)
• nuxt: Augment @vue/runtime-core and @vue/runtime-dom (#​28446)
• nuxt: Scan jsx pages for page metadata (#​28479)
• nuxt: Handle plugin type extensions more correctly (#​28480)
• vite: Respect baseURL for public assets in dev (#​28482)
• vite: Add transformation result to log for parse errors (#​28508)
• vite: Include module symbols in generated code (#​28509)
• nuxt: Add reason when aborting request in useFetch (#​28517)
• nuxt: Only augment vue, not sub-packages (#​28542)
• nuxt: Avoid stripping js extensions in plugin injections (#​28593)
• nuxt: Preserve route-specific metadata on route.meta (#​28441)
• nuxt: Don't warn when data fetching in middleware (#​28604)
• nuxt: Extract route rules/page meta in 2+ script blocks (#​28625)
• nuxt: Allow customising status code in validate method (#​28612)
• nuxt: Do not provide default prefetchOn prop (#​28630)
• nuxt: Revert back to object syntax for island head (#​28656)

📖 Documentation

• Fix issue in cookie passing example (#​28223)
• Fix note in layers usage chapter (#​28236)
• Fix spaces (#​28233)
• Add vue lang to sample code (#​28247)
• Use splitSetCookieString from cookie-es (29f95ae0d)
• Use headers.getSetCookie (45c6df9a4)
• Fix codemod command typos (#​28279)
• bunx -> bun x (#​28277)
• Add missing comma to example (#​28300)
• Add language to example schema codeblock (#​28294)
• Update link to RuntimeNuxtHooks (#​28336)
• Update links to social media (cd5195047)
• Setup host property and usage example (#​28331)
• Fix TypeScript errors for examples (#​28403)
• Improve readability of link to mdn (#​28327)
• Use ts for create-error example (#​28411)
• Alias links in jsdoc @see blocks (#​28270)
• Link to vue test utils docs for mountSuspended (#​28463)
• Remove vue-tsc major version constraint (#​28484)
• Recommend '#teleports' target instead of 'body' (#​28489)
• Correct custom routing link (#​28497)
• Improve typing of default exports (#​28520)
• Fix options type in custom useFetch recipe (#​28389)
• Update useRuntimeConfig source path (#​28553)
• Add line-breaks to tips in Module Author Guide (#​28587)
• Update nuxt scripts status (#​28629)

🏡 Chore

• schema: Fix typo (#​28377)
• nuxt: Use router code reference permalink (#​28356)
• nuxt: Remove unnecessary await (#​28407)
• Upgrade vue in a separate pr (#​28414)
• Update docs typecheck command (49de5f731)
• Lint (cab9e5c35)
• Fix some typos in comments (#​28501)

✅ Tests

• Disable pageTransition in client-only page (#​27839)
• Ignore SharedComponent in server head (510f3e28f)
• Update bundle size (3ecb95a7c)

🤖 CI

• Add reproduire-sur-stackblitz workflow (#​28531)

❤️ Contributors

• Daniel Roe (@​danielroe)
• Julien Huang (@​huang-julien)
• Maxime Pauvert (@​maximepvrt)
• felix-dolderer (@​felix-dolderer)
• Nicolas Payot (@​nicolaspayot)
• Kewin Szlezingier (@​kewinzaq1)
• Vasily Kuzin (@​ExEr7um)
• xjccc (@​xjccc)
• Martin André (@​Martichou)
• Mike Laumann Bellika (@​MikeBellika)
• Typed SIGTERM (@​typed-sigterm)
• Horu (@​HigherOrderLogic)
• Son Tran (@​trandaison)
• rubyisrust (@​rubyisrust)
• Matej Černý (@​CernyMatej)
• Riley Ho (@​rileychh)
• Adam DeHaven (@​adamdehaven)
• Potter (@​yxw007)
• Martin Masevski (@​Archetipo95)
• BoogieBen. (@​boogie-ben)
• Tobias Diez (@​tobiasdiez)
• Michael Brevard (@​GalacticHypernova)
• Damian Głowala (@​DamianGlowala)
• Lucie (@​lihbr)
• Yasser Lahbibi (@​yassilah)
• Sébastien Chopin (@​atinux)
• @​beer (@​iiio2)
• AuroraTea (@​AuroraTea)
• Bobbie Goede (@​BobbieGoede)
• Alexander Lichter (@​manniL)
• nuxt-studio[bot] (@​nuxt-studio[bot])
• Vaci (@​vacijj)
• FELIPE COSTA DE OLIVEIRA (@​FelipeO16)
• 一纸忘忧 (@​ikxin)
• Meo (@​miaobuao)
• Mohab Sameh (@​mohab-sameh)
• Quentin Macq (@​quentinmcq)
• Johan Krijt (@​johankrijt)

v3.12.4

Compare Source

3.12.4 is the next regularly scheduled patch release.

👉 Changelog

compare changes

🔥 Performance

• vite: Start warmups after nitro build (#​27963)
• vite: Avoid extra resolve call for resolveId in layers (#​27971)
• kit,nuxt,schema,vite,webpack: Use explicit exports (#​27998)

🩹 Fixes

• schema: Resolve public alias correctly (#​27975)
• nuxt: Omit rendering payload prefetch when noScripts (#​27972)
• nuxt: Add / as fallback if page can't be identified (e6109b226)
• ui-templates: Validate templates with html-validate (#​28024)
• schema: Don't constrain postcss plugin options (#​28045)
• kit: Remove exports from v4 branch (5c8312e9b)
• nuxt: Use unhead key for ad-hoc module options (#​28088)
• nuxt: Use native vue-router composables (#​28114)
• kit: Ensure getNuxtVersion returns string (#​28125)
• nuxt: Always prerender at least one page with crawler (#​28131)
• nuxt: Consider doc scroll-padding-top in scrollBehavior (#​28083)
• nuxt: Only warn when useAsyncData returns undefined (#​28154)
• nuxt: Revert change to getCachedData null response (d10cea11b)
• schema: Don't use app/ as srcDir if it doesn't exist (#​28176)
• kit: Normalise serverDir within layers using v4 compat (#​28177)
• nuxt: Allow getCachedData to return undefined (#​28187)
• nuxt: Use addEventListener to register cookie store listener (#​28193)
• nuxt: Merge route meta properties with scanned meta (#​28170)
• nuxt: Prevent duplicate set-cookie headers (#​28211)

💅 Refactors

• schema,vite,webpack: Rework postcss module loading (#​27946)
• nuxt: Remove _registeredComponents from ssrContext (#​27819)
• nuxt: Use errx to handle dev log traces (#​28027)

📖 Documentation

• Fix link (83bd4fde9)
• Fix Cloudflare spelling (#​27989)
• Update example to use nuxtApp.runWithContext (#​28000)
• Remove deprecated pending variable from data fetching docs (#​28011)
• Clarify xrsp danger (#​28053)
• Deprecate pending and emphasis undefined (#​28113)
• Update phrasing in route announcer (#​28108)
• Use code groups for install commands in module guide (#​28094)
• Capitalize text (#​28056)
• Mention content in upgrade guide v4 folder structure (#​28090)
• Remove a resolved issue from view transition docs (#​28091)
• Clarify navigateTo is not for nitro routes (#​28092)
• Warn about nested islands (#​28062)
• Add info about layers/ directory (#​28128)
• Codemods for migrating to Nuxt 4 (#​28072)

✅ Tests

• Add typeCheck test in minimal build (#​28166)

🤖 CI

• Run prepare step before linting docs (f8fbefb42)
• Run prepare step before linting docs (d629b82b3)

❤️ Contributors

• Daniel Roe (@​danielroe)
• arshcodemod (@​arshcodemod)
• xjccc (@​xjccc)
• Julien Huang (@​huang-julien)
• BoogieBen (@​boogie-ben)
• Santiago A (@​santiagoaloi)
• Bobbie Goede (@​BobbieGoede)
• John Tanzer (@​moshetanzer)
• Thomas (@​ThomasWT)
• @​beer (@​iiio2)
• Dominic (@​rexhent)
• Alex Liu (@​Mini-ghost)
• Florian Metz (@​Timeraa)
• Liran Tal (@​lirantal)
• Daniel Kelly (@​danielkellyio)
• Daniel Flanagan (@​FlantasticDan)
• 山吹色御守 (@​KazariEX)
• izzy goldman (@​izzygld)
• Anthony Fu (@​antfu)

v3.12.3

Compare Source

3.12.3 is the next regularly scheduled patch release.

👉 Changelog

compare changes

🔥 Performance

• nuxt,vite: Use native fs utils rather than fs-extra (#​27787)
• schema: Use chokidar when a custom srcDir is provided (#​27871)
• nuxt: Ensure prefetchComponents is treeshaken on server (#​27905)

🩹 Fixes

• nuxt: Flag async data promise as cancelled only if defined (#​27690)
• schema: Handle backwards compat for dir.app (0c73cb734)
• nuxt: Support hoisting types of subpath imports (#​27720)
• nuxt: Resolve routes when navigateTo called with open (#​27742)
• nuxt: Handle subpaths more correctly (d7402a799)
• nuxt: Delay navigation until user input is acknowledged (#​27743)
• nuxt: Resolve aliases used in nitro plugin paths (#​27741)
• schema: Do not use full path assets/public aliases (d0518650f)
• nuxt: Defer registering inp handler until nuxt is mounted (866a5319a)
• nuxt: Add refresh type in server component refs (#​27778)
• nuxt: Extract all-literal page meta (#​27821)
• kit: Handle loading nuxt 4+ (cf251bd48)
• nuxt: Handle external links to named route objects (#​27829)
• nuxt: Use URL to encode redirected URLs (#​27822)
• nuxt: Don't use app version when verifying nuxt deps (#​27864)
• nuxt: Prompt to set compatibility date with latest nitro (#​27893)
• nuxt: Add #vue-router alias for backwards compat (#​27896)
• nuxt: Move app augments to core nuxt types (#​27900)
• nuxt: Pass augmented pages to child paths (ecb35d3a2)
• nuxt: Use pascal name when loading server component (#​27928)
• nuxt: Improve async data warning (#​27874, #​27934)
• nuxt: Allow configuring server components in modules (#​27936)
• vite: Omit css ?raw from head when in dev mode (#​27940)
• kit,nuxt: Ensure webworker types are available (4cab71d66)
• nuxt: Seed crawler when prerendering pages (#​27955)
• vite: Fix type issue with legacy dev bundler (f9fa1a3e9)
• nuxt: Improve dx around compatibility date prompt (#​27965)

💅 Refactors

• kit,nuxt: Use performance.now to measure time (d14f7ec46)

📖 Documentation

• Add referral query variable to Vue School Links (#​27670)
• Fix variable name (#​27675)
• Clarify how transitions are configured globally (#​27679)
• Remove outdated recommendation (#​27691)
• Add refreshCookie on useCookie doc page (#​27744)
• Sync changes from main branch (e7fbc9f81)
• Remove outdated tip (#​27773)
• Warn about awaiting useFetch/AsyncData in wrappers (#​27785)
• Update some code groups with package manager examples (#​27791)
• Hint to use runtime config (#​27859)
• Use internal link (#​27883)
• Update links to vue-router docs (#​27895)
• Use internal link (#​27894)
• Remove warning about type checking (#​27911)
• compatibilityVersion is available in the latest release (#​27919)
• Update roadmap + readme (748bc751d)
• Update Nuxt 3 -> Nuxt or Nuxt 3+ (3c16c890c)
• Update reference to nightly release for testing nuxt 4 (5d2dc9714)
• Remove duplicate server-side notice in runtime config (#​27929)
• Warn about ref unwrapping when auto-importing refs (#​27933)
• Mention layers in directory guide (c222fe7aa)

🏡 Chore

• Use absolute urls for sources to assets in readme (5ef305cec)
• Use relative links and update in build script (7dd15186e)
• Use backup file extension (a42a3869b)
• Allow changelogs with breaking changes (e11587189)
• Allow major bumps (dea0b86c7)
• Add 4x tag for v4 nightly releases (9d5dd5494)
• vite: Restore utils required for dev-bundler (e3448fa0d)
• Remove nitro/h3 from renovate, and reenable vitejs/vue (9037b0d2c)
• Improve type safety with indexed access (#​27626)
• Add @​danielroe to code owners (7fa957729)
• Remove renovate configuration from 2.x branch (8003cf72f)
• Remove issue template for 2.x (9f9fb9251)
• Remove unused variable (f07969d88)

✅ Tests

• schema: Normalize snapshot paths for windows (#​27654)
• nuxt: Normalize paths for windows (#​27653)
• Bump timeout for node-compat test (228b8b889)
• Slightly improve test reliability (#​27811)

🤖 CI

• Update changelog from 3.x branch updates (2b6967fbb)
• Add 3x tag instead (c0ef279f2)
• Run workflows against 3.x branch as well (31255a14d)
• Use correct SHA calculation for release-pr action (#​27604)
• Resolve bash syntax error (#​27789)
• Only run scorecards against main branch (7abd982f8)
• Raise renovate prs against 3.x branch too (f176c150a)
• Ignore @vitejs/plugin-vue again (56660cbdd)
• Prevent more than one release from occurring at same time (71705550f)
• Don't run changelog update on 2.x branch (1be639364)

❤️ Contributors

• Daniel Roe (@​danielroe)
• Typed SIGTERM (@​typed-sigterm)
• Seno (@​s-en-o)
• Julien Huang (@​huang-julien)
• Michael Brevard (@​GalacticHypernova)
• Ryota Watanabe (@​wattanx)
• Martin Masevski (@​Archetipo95)
• Alex Liu (@​Mini-ghost)
• Bochkarev Ivan (@​Ibochkarev)
• Alexander Lichter (@​manniL)
• Dominic (@​rexhent)
• Aviv Keller (@​RedYetiDev)
• Maxime Pauvert (@​maximepvrt)
• Daniel Kelly (@​danielkellyio)
• Damian Głowala (@​DamianGlowala)
• Idorenyin Udoh (@​idorenyinudoh)

v3.12.2

Compare Source

3.12.2 is the a regularly scheduled patch release.

✅ Upgrading

As usual, our recommendation for upgrading is to run:

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

🔥 Performance

• kit: Deduplicate layers before resolving config (#​27582)
• webpack: Decrease assets map iterations (d929cd4ef)
• kit: Various performance improvements (#​27600)
• vite: Various performance improvements (#​27601)
• nuxt: Don't wait for key deps check (#​27638)

🩹 Fixes

• nuxt: Call onNuxtReady callback without arguments (#​27428)
• schema: Don't narrow head string types to literals (#​27540)
• schema: app/ dir backwards compatibility (#​27529)
• nuxt: Manually assign payload reactivity when ssr: false (#​27542)
• nuxt: Only log warning once per runtimeConfig key (9e56b60c6)
• nuxt: Overwrite #app/defaults rather than augmenting (#​27567)
• nuxt: Export useRouteAnnouncer (#​27562)
• nuxt: Remove backticks around runtimeConfig warning log (#​27549)
• nuxt: Close top-level watcher on nuxt 'close' (#​27571)
• nuxt: Handle tsx code when extracting pageMeta/routeRules (#​27583)
• nuxt: Handle more edge cases with external/custom links (#​27487)
• nuxt: Preserve route metadata assigned outside page (#​27587)
• nuxt: Use portal to sync nitro/nuxt runtimeConfig + routeRules (#​27596)
• nuxt,schema: Add types for _installedModules (e4bfea642)
• nuxt: Include build-time pages in prerender routes (#​27569)
• nuxt: Warn when async data doesn't return a value (#​27599)
• nuxt: Replace deprecated app.rootId with app.rootAttrs.id (#​27630)
• nuxt: Add mergeProps import in islands transform (#​27622)
• nuxt: Reset cookie timeoutLength after expiration (#​27632)
• nuxt: Add missing island uid for selective client components (#​27633)
• schema,vite: Respect vite.cacheDir if defined (#​27628)
• nuxt: Unregister hooks the moment close is called (#​27637)
• nuxt: Add missing script stubs (#​27640)
• nuxt: Only inject root path in prerender (44cada95a)
• nuxt: Reduce usage of cjs utilities (#​27642)
• nuxt: Add / even if pages module isn't enabled (dabcb5ecc)

📖 Documentation

• Add warning about bridge migration with head (#​27575)
• Update compatibility example (4b28d2628)
• Document new clear() function added in 3.11 (#​27615)
• String vs object errors + accessing data of server-thrown errors (#​27398)
• Correct Cloudflare deployment recommendations (#​27641)

🏡 Chore

• Add extra types for empty array definitions (02945b9fa)
• Remove stub types file for webpack-virtual-modules (58dd7f3a6)
• Lint (cb77ddc30)

✅ Tests

• Add type test for nuxt module resolved types (115fc2d18)

🤖 CI

• Improve generated changelog (d20266961)

❤️ Contributors

• Daniel Roe (@​danielroe)
• Julien Huang (@​huang-julien)
• Alexandru Ungureanu (@​unguul)
• Josh Dean (@​jdbdnz)
• Yusuf Mansur Özer (@​ymansurozer)
• Matteo Rigoni (@​Rigo-m)
• Leo Osa (@​leoosa)
• Levi (Nguyễn Lương Huy) (@​huynl-96)
• David Nahodyl (@​Smef)
• Michael Brevard (@​GalacticHypernova)
• garthreckers (@​garthreckers)
• Valerii Strilets (@​letstri)
• Okuto Oyama (@​yamanoku)
• Harlan Wilton (@​harlan-zw)

v3.12.1

Compare Source

3.12.1 is a hotfix release to address a typo in the nuxt/script stub auto-imports.

👉 Changelog

compare changes

🩹 Fixes

• nuxt: Update registry list for @nuxt/scripts (0252000d7)

💅 Refactors

• schema: Use CompatibilityDateSpec (#​27521)

📖 Documentation

• Update more references to v3.12 (1d2eee00d)
• Mention 3.12 for testing nuxt 4 (#​27525)

🏡 Chore

• Fix release script (7777f0564)
• Lint (24b8533e7)
• Bump nuxi dependency (#​27526)

✅ Tests

• Update scrolling test (52b85a886)

❤️ Contributors

• Daniel Roe (@​danielroe)
• Pooya Parsa (@​pi0)
• Alexander Lichter (@​manniL)

v3.12.0

Compare Source

👀 Highlights

We're on the road to the release of Nuxt 4, but we've not held back in Nuxt v3.12. A huge thank you to the 75+ Nuxt contributors and community members who have been part of this release. ❤️

---

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 is behind base branch, 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 was generated by Mend Renovate. View the repository job log.