Vue.Js Core Updates & Release Notes

Bug Fixes

• compiler-core: avoid crash on CDATA at the document root (#14916) (0ea17e2)
• compiler-core: prefix dynamic keys on v-memo elements (#14922) (68e978e), closes #14920
• compiler-sfc: handle vue-ignore on leading intersection/union type (#14950) (0dcd225), closes #12254
• compiler-sfc: respect var hoisting in props destructure (48ad452)
• reactivity: preserve watch callback return value when wrapped for once: true (#14902) (450a8a8)
• runtime-core: add dev warning for silent catch in compat mode and fix test description typo (#14891) (db3e117)
• runtime-core: force model update when reverted before sync (#14897) (7f76378), closes #13524
• runtime-core: skip async component callbacks after unmount (#14911) (5300ead)
• transition: avoid move transition for hidden v-show group children (#14895) (c11f6ee), closes #14894
• watch: trigger immediate callback for empty sources (#14914) (1f2ca7e), closes #14898

Bug Fixes

• compiler-core: avoid double processing v-for keys with v-memo (#14861) (34a0ded), closes #14859
• compiler-sfc: resolve top-level exports from files registered as global types (#14805) (3d077f2), closes nuxt/nuxt#33694
• runtime-core: avoid repeated hydration mismatch checks (#14857) (170fc95), closes #14855
• runtime-core: skip idle persisted transition hooks in keep-alive moves (#14865) (80fc139), closes #14031
• server-renderer: propagate sync errors from ssrRenderSuspense (#14804) (4760997), closes nuxt/nuxt#28162
• teleport: skip child unmount when pending mount discarded (#14876) (#14877) (584beb1)

Performance Improvements

• reactivity: skip type checks for cached proxies (#14860) (5734fe9)
• runtime-dom: optimize array event handler dispatch (#14828) (bb18dc8)
• server-renderer: avoid materializing iterables in ssrRenderList (#14821) (1b7a2cc)

Bug Fixes

• compiler-sfc: infer Vue ref wrapper types when source is unresolvable (#14758) (7f46fd4), closes #14729
• compiler-sfc: preserve hash hrefs on <image> elements (#14756) (090b2e3)
• compiler-sfc: resolve type re-exports inside declare global (#14766) (acfffe3)
• reactivity: prevent orphan effect when created in a stopped scope (#14778) (c8e2d4a), closes #14777
• runtime-core: avoid symbol coercion during props validation (#8539) (23d4fb5), closes #8487
• suspense: avoid DOM leak with out-in transition in v-if fragment (#14762) (9667e0d), closes #14761

Bug Fixes

• compiler-sfc: handle nested :deep in selector pseudos (#14725) (bb9d265), closes #14724
• reactivity: unlink effect scopes on out-of-order off (#14734) (e7659be), closes #14733
• runtime-dom: preserve textarea resize dimensions (#14747) (11fb2fd), closes #14741
• teleport: don't move teleport children if not mounted (#14702) (6a61f44), closes #14701
• transition: preserve placeholder for conditional explicit default slots (#14748) (45990ce), closes #14727

Bug Fixes

• runtime-core: prevent currentInstance leak into sibling render during async setup re-entry (#14668) (f166353), closes #14667
• teleport: handle updates before deferred mount (#14642) (32b44f1), closes #14640
• types: allow customRef to have different getter/setter types (#14639) (e20ddb0)
• types: use private branding for shallowReactive (#14641) (302c47a), closes #14638 #14493

Reverts

• Revert "fix(server-renderer): cleanup component effect scopes after SSR render" (#14674) (219d83b), closes #14674 #14669

Bug Fixes

• compiler-sfc: allow Node.js subpath imports patterns in asset urls (#13045) (95c3356), closes #9919
• compiler-sfc: support template literal as defineModel name (#14622) (bd7eef0), closes #14621
• reactivity: normalize toRef property keys before dep lookup + improve types (#14625) (1bb28d0), closes #12427 #12431
• runtime-core: invalidate detached v-for memo vnodes after unmount (#14624) (560def4), closes #12708 #12710
• runtime-core: preserve nullish event handlers in mergeProps (#14550) (5725222)
• runtime-core: prevent merging model listener when value is null or undefined (#14629) (b39e032)
• runtime-dom: defer teleport mount/update until suspense resolves (#8619) (88ed045), closes #8603
• runtime-dom: handle activeElement check in Shadow DOM for v-model (#14196) (959ded2)
• server-renderer: cleanup component effect scopes after SSR render (#14548) (862f11e)
• suspense: avoid unmount activeBranch twice if wrapped in transition (#9392) (908c6ad), closes #7966
• suspense: update suspense vnode's el during branch self-update (#12922) (a2c1700), closes #12920
• transition: skip enter guard while hmr updating (#14611) (be0a2f1), closes #14608
• types: prevent shallowReactive marker from leaking into value unions (#14493) (3b561db), closes #14490

Bug Fixes

• compat: add entities to @vue/compat deps to fix CJS edge cases (#12514) (e725a67), closes #10609

• custom-element: ensure child component styles are injected in correct order before parent styles (#13374) (1398bf8), closes #13029

• custom-element: properly locate parent when slotted in shadow dom (#12480) (f06c81a), closes #12479

• custom-element: should properly patch as props for vue custom elements (#12409) (740983e), closes #12408

• reactivity: avoid duplicate raw/proxy entries in Set.add (#14545) (d943612)

• reactivity: fix reduce on reactive arrays to preserve reactivity (#12737) (16ef165), closes #12735

• reactivity: handle Set with initial reactive values edge case (#12393) (5dc27ca), closes #8647

• runtime-core: warn about negative number in v-for (#12308) (9438cc5)

• ssr: prevent watch from firing after async setup await (#14547) (6cda71d), closes #14546

• types: make generics with runtime props in defineComponent work (fix #11374) (#13119) (cea3cf7), closes #13763

• types: narrow useAttrs class/style typing for TSX (#14492) (bbb8977), closes #14489

Bug Fixes

• runtime-core: prevent instance leak in withAsyncContext (#14445) (702284f), closes nuxt/nuxt#33644

• server-renderer: render className as escaped string (#14469) (da6690c)

• transition: prevent enter if leave is in progress (#14443) (df059f8), closes #12091 #12133

Bug Fixes

• transition: avoid unexpected cancelled parameter in transition done callback (#14391) (6798853)
• compiler-sfc: add resolution trying for .mts/.cts files (#14402) (c09d41f), closes vuejs/router#2611
• compiler-sfc: no params were generated when using withDefaults (#12823) (b0a1f05), closes #12822
• reactivity: add __v_skip flag to EffectScope to prevent reactive conversion (#14359) (48b7552), closes #14357
• runtime-core: avoid retaining el on cached text vnodes during static traversal (#14419) (4ace79a), closes #14134
• runtime-core: prevent child component updates when style remains unchanged (#12825) (57866b5), closes #12826
• runtime-core: properly handle async component update before resolve (#11619) (e71c26c), closes #11617
• runtime-dom: handle null/undefined handler in withModifiers (#14362) (261de54), closes #14361
• teleport: properly handling disabled teleport target anchor (#14417) (d7bcd85), closes #14412
• transition-group: correct move translation under scale via element rect (#14360) (0243a79), closes #14356
• useTemplateRef: don't update setup ref for useTemplateRef key (#12756) (fc40ca0), closes #12749

Bug Fixes

• compile-sfc: correctly handle variable shadowing in for loop for defineProps destructuring. (#14296) (6a1bb50), closes #14294
• compiler-sfc: handle indexed access types in declare global blocks (#14260) (e4091fe), closes #14236
• compiler-sfc: use correct scope when resolving indexed access types from external files (#14297) (f0f0a21), closes #14292
• reactivity: collection iteration should inherit iterator instance methods (#12644) (3c8b2fc), closes #12615
• runtime-core: skip patching reserved props for custom elements (#14275) (19cc7e2), closes #14274
• server-renderer: use ssrRenderClass helper for className attribute (#14327) (a4708f3)
• ssr: handle v-bind modifiers during render attrs (#14263) (c2f5964), closes #14262

Bug Fixes

• compiler-core: correctly handle ts type assertions in expressions (#13397) (e6544ac), closes #13395
• compiler-core: fix v-bind shorthand handling for in-DOM templates (#13933) (b3cca26), closes #13930
• compiler-sfc: resolve numeric literals and template literals without expressions as static property key (#13998) (75d44c7)
• compiler-ssr: textarea with v-text directive SSR (#13975) (006a0c1)
• compiler: using guard instead of non-nullish assertion (#13982) (dcc6f36)
• custom-element: batch custom element prop patching (#13478) (c13e674), closes #12619
• custom-element: optimize slot retrieval to avoid duplicates (#13961) (84ca349), closes #13955
• hydration: avoid mismatch during hydrate text with newlines in interpolation (#9232) (6cbdf78), closes #9229
• runtime-core: pass props and children to loadingComponent (#13997) (40c4b2a)
• runtime-dom: ensure iframe sandbox is handled as an attribute to prevent unintended behavior (#13950) (5689884), closes #13946
• suspense: clear placeholder and fallback el after resolve to enable GC (#13928) (f411c66)
• transition-group: use offsetLeft and offsetTop instead of getBoundingClientRect to avoid transform scale affect animation (#6108) (dc4dd59), closes #6105
• v-model: handle number modifier on change (#13959) (8fbe48f), closes #13958

Bug Fixes

• compiler-core: identifiers in switch-case should not be inferred as references (#13923) (5953c9f)
• compiler-dom: nodes with v-once shouldn't be stringified (#13878) (95c1975)
• compiler-sfc: add support for @vue-ignore in runtime type resolution (#13906) (ba7f7f9)
• compiler-sfc: enhance inferRuntimeType to support TSMappedType with indexed access (#13848) (e388f1a), closes #13847
• compiler-sfc: ensure css custom properties do not start with a digit (#13870) (9c27951)
• compiler-sfc: ensure props bindings register before compiling template (#13922) (abd5638), closes #13920
• compiler-ssr: ensure v-show has a higher priority in SSR (#12171) (836b829), closes #12162
• custom-element: properly mount multiple Teleports in custom element component w/ shadowRoot false (#13900) (5e1e791), closes #13899
• custom-element: set prop runs pending mutations before disconnect (#13897) (c4a88cd), closes #13315
• custom-element: use PatchFlags.BAIL for slot when props are present (#13907) (5358bca), closes #13904
• reactivity: respect readonly during ref unwrapping (#13905) (aba7fed), closes #13903
• reactivity: update iterator to check for completion instead of value presence (#13761) (2078f8b)
• runtime-core: simplify block-tracking disabling in h helper (#13841) (75220c7)
• transition-group: run forceReflow on the correct document (fix #13849) (#13853) (1be5ddf)
• types: more precise types for Events and added missing definitions (#9675) (8bb8fb2)
• types: set dom stub type to never instead of {} (#13915) (8620a61), closes #11564
• types: widen directive arg type from string to any (#13758) (4b71706), closes #13757

Features

• custom-element: allow specifying additional options for shadowRoot in custom elements (#12965) (47e628d), closes #12964

Reverts

• Revert "fix(hmr): prevent VUE_HMR_RUNTIME from being overwritten by vue runtime in 3rd-party libraries" (#13925) (6b68f72), closes #13925

Bug Fixes

• compiler-core: force dynamic slots when slot referencing scope vars (#9427) (99d54b2), closes #9380
• compiler-sfc: check lang before attempt to compile script (#13508) (55922ff), closes #8368
• compiler-sfc: support ${configDir} in paths for TypeScript 5.5+ (#13491) (8696e34), closes #13484
• compiler-sfc: support global augments with named exports (#13789) (35da3c6)
• custom-element: prevent defineCustomElement from mutating the options object (#13791) (e322436)
• hmr: prevent __VUE_HMR_RUNTIME__ from being overwritten by vue runtime in 3rd-party libraries (#13817) (1392734), closes vitejs/vite-plugin-vue#644
• hmr: prevent update unmounting component during HMR reload (#13815) (ef20b86), closes vitejs/vite-plugin-vue#599
• runtime-core: disable tracking block in h function (#8213) (8f6b505), closes #6913
• runtime-core: use separate emits caches for components and mixins (#11661) (15fc75f)
• Suspence: handle Suspense + KeepAlive HMR updating edge case (#13076) (5d75a17), closes #13075
• Teleport: hydrate disabled Teleport with undefined target (#11235) (00978f7), closes #11230
• templateRef: prevent unnecessary set ref on dynamic ref change or component unmount (#12642) (93ba107), closes #12639
• watch: use maximum depth for duplicates (#13434) (f2699a5)

Performance Improvements

• improve regexp performance with non-capturing groups (#13567) (1e8b65a)