CHANGELOG.md

3.5.2 (2024-09-05)

Bug Fixes

• reactivity: make toRaw work on proxies created by proxyRef (46c3ab1)
• reactivity: pass oldValue to computed getter (#11813) (98864a7), closes #11812
• reactivity: prevent endless recursion in computed getters (#11797) (716275d)
• reactivity: self-referencing computed should refresh (e84c4a6), closes /github.com/vuejs/core/pull/11797#issuecomment-2330738633
• scheduler: prevent duplicate jobs being queued (#11826) (df56cc5), closes #11712 #11807
• suspense: avoid updating anchor if activeBranch has not been rendered to the actual container (#11818) (3c0d531), closes #11806
• Transition: handle KeepAlive child unmount in Transition out-in mode (#11778) (3116553), closes #11775
• types: add HTMLDialogElement missing close event (#11811) (3634f7a)
• types: added name attribute support to details tag (#11823) (c74176e), closes #11821
• types: fix defineComponent props inference when setup() has explicit annotation (fca20a3), closes #11803
• useTemplateRef: properly fix readonly warning in dev and ensure prod behavior consistency (9b7797d), closes #11808 #11816 #11810

Features

• compiler-core: parse modifiers as expression to provide location data (#11819) (3f13203)

3.5.1 (2024-09-04)

Bug Fixes

• build: improve built-in components treeshakability (4eee630)
• reactivity: handle non-array arguments in reactive concat method (#11794) (475977a), closes #11792
• Transition: avoid applying transition hooks on comment vnode (#11788) (51912f8), closes #11782
• types: avoid using intersection type in Readonly<...> to fix JSDoc emit (#11799) (7518bc1)
• useTemplateRef: fix readonly warning when useTemplateRef has same variable name as template ref (bc63df0), closes #11795 #11802 #11804

3.5.0 (2024-09-03)

Aggregated Features List for 3.5 (alpha to stable)

Reactivity

• reactivity: Refactor reactivity system to use version counting and doubly-linked list tracking (#10397) (05eb4e0)
• reactivity: Optimize array tracking (#9511) (70196a4)
• compiler-sfc: enable reactive props destructure by default (d2dac0e)
• reactivity: onEffectCleanup API (2cc5615), closes #10173
• reactivity: add failSilently argument for onScopeDispose (9a936aa)
• reactivity/watch: base watch, getCurrentWatcher, and onWatcherCleanup (#9927) (205e5b5)
• reactivity/watch: add pause/resume for ReactiveEffect, EffectScope, and WatchHandle (#9651) (267093c)
• watch: support passing number to deep option to control the watch depth (#9572) (22f7d96)
• types: export MultiWatchSources type (#9563) (998dca5)
• types: allow computed getter and setter types to be unrelated (#11472) (a01675e), closes #7271

SSR

• runtime-core: useId() and app.config.idPrefix (#11404) (73ef156)
• hydration: lazy hydration strategies for async components (#11458) (d14a11c)
• hydration: support suppressing hydration mismatch via data-allow-mismatch (94fb2b8)

Custom Element

• custom-element: useHost() helper (775103a)
• custom-element: useShadowRoot() helper (5a1a89b), closes #6113 #8195
• custom-element: expose this.$host in Options API (1ef8f46)
• custom-element: inject child components styles to custom element shadow root (#11517) (56c76a8), closes #4662 #7941 #7942
• custom-element: support configurable app instance in defineCustomElement (6758c3c), closes #4356 #4635
• custom-element: support css :host selector by applying css vars on host element (#8830) (03a9ea2), closes #8826
• custom-element: support emit with options (e181bff), closes #7605
• custom-element: support expose on customElement (#6256) (af838c1), closes #5540
• custom-element: support nonce option for injected style tags (bb4a02a), closes #6530
• custom-element: support passing custom-element-specific options via 2nd argument of defineCustomElement (60a88a2)
• custom-element: support shadowRoot: false in defineCustomElement() (37d2ce5), closes #4314 #4404

Teleport

• teleport: support deferred Teleport (#11387) (59a3e88), closes #2015 #11386
• teleport/transition: support directly nesting Teleport inside Transition (#6548) (0e6e3c7), closes #5836

Misc

• runtime-core: useTemplateRef() (3ba70e4)
• runtime-core: add app.onUnmount() for registering cleanup functions (#4619) (582a3a3), closes #4516
• runtime-core: add app.config.throwUnhandledErrorInProduction (f476b7f), closes #7876
• runtime-dom: Trusted Types compatibility (#10844) (6d4eb94)
• compiler-core: support Symbol global in template expressions (#9069) (a501a85)
• types: export more emit related types (#11017) (189573d)

• types: add loading prop to iframe (#11767) (d86fe0e)

Internals

• reactivity: store value cache on CustomRefs impls (#11539) (e044b6e)
• types: provide internal options for directly using user types in language tools (#10801) (75c8cf6)
• types: provide internal options for using refs type in language tools (#11492) (5ffd1a8)

Bug Fixes

• compiler-sfc: fix import usage check for kebab-case same name shorthand binding (0f7c0e5), closes #11745 #11754
• cssVars: correctly escape double quotes in SSR (#11784) (7b5b6e0), closes #11779
• deps: update dependency postcss to ^8.4.44 (#11774) (cb843e0)
• hydration: escape css var name to avoid mismatch (#11739) (ca12e77), closes #11735
• hydration: handle text nodes with 0 during hydration (#11772) (c756da2), closes #11771
• reactivity: correctly handle method calls on user-extended arrays (#11760) (9817c80), closes #11759
• runtime-dom: avoid unnecessary prop patch for checkbox (#11657) (c3ce9fe), closes #11647
• runtime-dom: prevent unnecessary DOM update from v-model (#11656) (b1be9bd), closes #11647
• server-renderer: Fix call to serverPrefetch in server renderer with an async setup (#10893) (6039e25)
• server-renderer: render className during SSR (#11722) (52cdb0f)
• types/defineModel: allow getter and setter types to be unrelated (#11699) (fe07f70), closes #11697

3.5.0-rc.1 (2024-08-29)

Bug Fixes

• compiler-sfc: skip circular tsconfig project reference (#11680) (9c4c2e5), closes #11382
• custom-element: handle keys set on custom elements (#11655) (f1d1831), closes #11641
• deps: update dependency monaco-editor to ^0.51.0 (#11713) (434f8a9)
• keep-alive: reset keep alive flag when the component is removed from include (#11718) (29c321b), closes #11717
• reactivity: avoid infinite recursion when mutating ref wrapped in reactive (313e4bf), closes #11696
• reactivity: ensure watcher with once: true are properly removed from effect scope (#11665) (fbc0c42)
• runtime-dom: setting innerHTML when patching props should go through trusted types (d875de5)
• types: GlobalDirective / GlobalComponents should not be records (42e8df6)

3.5.0-beta.3 (2024-08-20)

Bug Fixes

• reactivity: extended methods respect reactive (#11629) (9de1d10), closes #11628
• runtime-core: correct type inference for PascalCase emits (#11579) (d7d0371), closes vuejs/language-tools#4269
• runtime-core: ensure suspense content inherit scopeId (#10652) (ac2a410), closes #5148
• runtime-core: pre jobs without an id should run first (#7746) (b332f80)
• ssr: apply ssr props to the the fallback vnode-based branch in ssr (#7247) (98b83e8), closes #6123
• types/custom-element: defineCustomElement with required props (#11578) (5e0f6d5)
• types: strip non-prop default values from return type of withDefaults (#9998) (44973bb), closes #9899
• watch: handle errors in computed used as watch source (#11626) (8bcaad4), closes #11624

Features

• reactivity: base watch, getCurrentWatcher, and onWatcherCleanup (#9927) (205e5b5)

Performance Improvements

• runtime-core: use apply to avoid spreading. (#5985) (bb6babc)

3.5.0-beta.2 (2024-08-15)

Bug Fixes

• build: revert entities to 4.5 to avoid runtime resolution errors (e9e0815), closes #11603
• compiler-core: use ast-based check for function expressions when possible (5861229), closes #11615
• compiler-sfc: fix prefixIdentifier default value (3d6f015)
• compiler-sfc: handle keyof operator with index object (#11581) (fe00815)
• custom-element: keep instance.isCE for backwards compat (e19fc27)
• deps: update dependency postcss to ^8.4.41 (#11585) (4c4e12a)
• keep-alive: ensure include/exclude regexp work with global flag (#11595) (3653bc0)
• reactivity: ensure extended method arguments are not lost (#11574) (4085def), closes #11570
• reactivity: sync watch should be executed correctly (#11589) (3bda3e8), closes #11577
• types/computed: ensure type safety for WritableComputedRef (#11608) (5cf5a16)
• types: add fallback stub for DOM types when DOM lib is absent (#11598) (fee6697)

Features

• deprecated: remove deprecated parseExpressions option (#11597) (4e7d5db)

3.5.0-beta.1 (2024-08-08)

Bug Fixes

• custom-element: delay mounting of custom elements with async parent (37ccb9b), closes #8127 #9341 #9351 #9351
• custom-element: delete prop on attribute removal (506c4c5), closes #11276
• custom-element: ignore scoped id (7f2c505)
• custom-element: reflect prop default value on custom element (63689ed), closes #9006 #10537
• custom-element: support early-set domProps for async custom elements (a07e7bf), closes #11081 #11082
• types/custome-element: defineCustomElement props inference with array emits (#11384) (e94b01b), closes #11353
• types: allow using InjectionKey as valid property key (321d807), closes #5089

Features

• custom-element: expose this.$host in Options API (1ef8f46)
• custom-element: inject child components styles to custom element shadow root (#11517) (56c76a8), closes #4662 #7941 #7942
• custom-element: support configurable app instance in defineCustomElement (6758c3c), closes #4356 #4635
• custom-element: support css :host selector by applying css vars on host element (#8830) (03a9ea2), closes #8826
• custom-element: support emit with options (e181bff), closes #7605
• custom-element: support for expose on customElement (#6256) (af838c1), closes #5540
• custom-element: support nonce option for injected style tags (bb4a02a), closes #6530
• custom-element: support passing custom-element-specific options via 2nd argument of defineCustomElement (60a88a2)
• custom-element: support shadowRoot: false in defineCustomElement() (37d2ce5), closes #4314 #4404
• custom-element: useHost() helper (775103a)
• custom-element: useShadowRoot() helper (5a1a89b), closes #6113 #8195
• hydration: allow fine tuning of lazy hydration strategy triggers (#11530) (261c8b1)
• reactivity/watch: add pause/resume for ReactiveEffect, EffectScope, and WatchHandle (#9651) (267093c)
• reactivity: store value cache on CustomRefs impls (#11539) (e044b6e)
• runtime-dom: Trusted Types compatibility (#10844) (6d4eb94)
• support specifying allowed keys via generic argument in useTemplateRef() (1fbfa69)
• types: allow computed getter and setter types to be unrelated (#11472) (a01675e), closes #7271
• types: export MultiWatchSources type (#9563) (998dca5)
• types: provide internal options for using refs type in language tools (#11492) (5ffd1a8)
• watch: support passing number to deep option to control the watch depth (#9572) (22f7d96)

3.5.0-alpha.5 (2024-07-31)

Features

• hydration: support suppressing hydration mismatch via data-allow-mismatch (94fb2b8)
• lazy hydration strategies for async components (#11458) (d14a11c)

3.5.0-alpha.4 (2024-07-24)

Bug Fixes

• suspense/hydration: fix hydration timing of async component inside suspense (1b8e197), closes #6638
• useId: properly mark async boundary for already resolved async component (cd28172)

3.5.0-alpha.3 (2024-07-19)

Bug Fixes

• build: enable SSR branches in esm-browser builds (b14cd9a)
• compiler-core: change node hoisting to caching per instance (#11067) (cd0ea0d), closes #5256 #9219 #10959
• compiler-sfc: should properly walk desutructured props when reactive destructure is not enabled (0fd6193), closes #11325
• types: respect props with default on instance type when using __typeProps (96e4738)

Features

• runtime-core: useTemplateRef() (3ba70e4)
• runtime-core: useId() and app.config.idPrefix (#11404) (73ef156)
• runtime-core: add app.config.throwUnhandledErrorInProduction (f476b7f), closes #7876
• teleport: support deferred Teleport (#11387) (59a3e88), closes #2015 #11386
• compiler-core: support Symbol global in template expressions (#9069) (a501a85)
• types: export more emit related types (#11017) (189573d)

3.5.0-alpha.2 (2024-05-04)

Bug Fixes

• types: fix app.component() typing with inline defineComponent (908f70a), closes #10843
• types: fix compat with generated types that rely on CreateComponentPublicInstance (c146186), closes #10842
• types: props in defineOptions type should be optional (124c4ca), closes #10841

Features

• runtime-core: add app.onUnmount() for registering cleanup functions (#4619) (582a3a3), closes #4516

3.5.0-alpha.1 (2024-04-29)

Bug Fixes

• reactivity: fix call sequence of ontrigger in effect (#10501) (28841fe)

Features

• compiler-sfc: enable reactive props destructure by default (d2dac0e)
• reactivity: onEffectCleanup API (2cc5615), closes #10173
• reactivity: add failSilently argument for onScopeDispose (9a936aa)
• transition: support directly nesting Teleport inside Transition (#6548) (0e6e3c7), closes #5836
• types: provide internal options for directly using user types in language tools (#10801) (75c8cf6)

Performance Improvements

• reactivity: optimize array tracking (#9511) (70196a4), closes #4318

Previous Changelogs

3.4.x (2023-10-28 - 2024-08-15)

See 3.4 changelog

3.3.x (2023-02-05 - 2023-12-29)

See 3.3 changelog

3.2.x (2021-07-16 - 2023-02-02)

See 3.2 changelog

3.1.x (2021-05-08 - 2021-07-16)

See 3.1 changelog

3.0.x (2019-12-20 - 2021-04-01)

See 3.0 changelog