repository·main·Indexed 13 days ago
https://github.com/vuejs/coreA progressive JavaScript framework for building user interfaces, focusing on the view layer and a reactive data model. This documentation covers core internals, distribution files for CDN and bundlers, feature flags for tree-shaking, and development tools like the SFC Playground and Template Explorer. Includes technical details for version 3.5.41 and legacy 3.0.x changes.
In version 3.2.25, several improvements were made to the experimental reactivity transform:
$-shorthands for all ref-creating APIs.@vue/ref-transform to @vue/reactivity-transform.3.4.0-beta.1, defineModel was updated to support local mutation by default. The local option has been removed because the macro now assumes the model can be mutated locally to trigger updates.<script setup> was updated to automatically restore the current instance context after await statements. This ensures that subsequent code in an async setup function correctly identifies the component instance, preventing issues with lifecycle hooks or other instance-dependent APIs.on followed by an uppercase letter or a non-letter character are considered event listeners in runtime-dom.defineModel macro was updated to force a local update even when the setter results in the same emitted value. Additionally, in runtime-core, the system will no longer emit an event when a defineModel ref is set with the same value it already holds.3.0.0-rc.1, the type system was updated to deny unknown attributes on components by default. This improves type safety by ensuring that only valid, declared props and attributes are passed to components.computed property is detected to be self-triggering. This helps prevent infinite loops or unexpected reactivity cycles caused by a computed property modifying its own dependencies.The dts-test package is used to ensure that exported TypeScript types remain consistent and as expected. It supports two modes of validation:
tsconfig.json, package imports are aliased to their src directories. This allows IDEs and the pnpm check script to validate types directly against the source code.tsc using packages-private/dts-test/tsconfig.test.json, packages are resolved using standard node resolution. This validates types against the actual built .d.ts files. This mode requires that types are built first using pnpm build-dts.3.0.0-rc.5, template auto ref unwrapping is applied shallowly. This means unwrapping only occurs at the root level of the object, rather than recursively through all nested properties. If you rely on deep unwrapping in templates, you may need to adjust your data structures or access patterns.In version 3.0.0-alpha.8, the attribute fallthrough behavior was updated. Implicit fallthrough now only applies by default to a specific whitelist of attributes:
classstylea11y attributesdata-* attributesFallthrough is applied regardless of whether the component has a single root node.
3.0.0-beta.6, internal APIs are excluded from the official type declarations (.d.ts files). This ensures that consumers only interact with the stable, public API surface and prevents accidental usage of internal implementation details.In version 3.0.0-alpha.8, the behavior for objects returned from setup() was reverted to ensure usability.
Objects returned from setup() are implicitly wrapped with reactive() to allow for deep ref unwrapping. This ensures that plain objects containing refs (common in composition functions) will have their refs automatically unwrapped when accessed in templates, maintaining the "no .value in template" intuition.
If you need to prevent a value from being reactive, use markNonReactive.