@vue/compat 3.5.0-alpha.4 → 3.5.0-beta.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +80 -80
- package/dist/vue-compat.d.ts +2 -2
- package/dist/vue.cjs.js +4187 -3687
- package/dist/vue.cjs.prod.js +3489 -3039
- package/dist/vue.esm-browser.js +4152 -3662
- package/dist/vue.esm-browser.prod.js +6 -6
- package/dist/vue.esm-bundler.js +4183 -3693
- package/dist/vue.global.js +4116 -3632
- package/dist/vue.global.prod.js +6 -6
- package/dist/vue.runtime.esm-browser.js +4075 -3631
- package/dist/vue.runtime.esm-browser.prod.js +2 -2
- package/dist/vue.runtime.esm-bundler.js +4089 -3645
- package/dist/vue.runtime.global.js +4047 -3609
- package/dist/vue.runtime.global.prod.js +2 -2
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -84,12 +84,12 @@ The following workflow walks through the steps of migrating an actual Vue 2 app
|
|
|
84
84
|
...options,
|
|
85
85
|
compilerOptions: {
|
|
86
86
|
compatConfig: {
|
|
87
|
-
MODE: 2
|
|
88
|
-
}
|
|
89
|
-
}
|
|
87
|
+
MODE: 2,
|
|
88
|
+
},
|
|
89
|
+
},
|
|
90
90
|
}
|
|
91
91
|
})
|
|
92
|
-
}
|
|
92
|
+
},
|
|
93
93
|
}
|
|
94
94
|
```
|
|
95
95
|
|
|
@@ -103,8 +103,8 @@ The following workflow walks through the steps of migrating an actual Vue 2 app
|
|
|
103
103
|
module.exports = {
|
|
104
104
|
resolve: {
|
|
105
105
|
alias: {
|
|
106
|
-
vue: '@vue/compat'
|
|
107
|
-
}
|
|
106
|
+
vue: '@vue/compat',
|
|
107
|
+
},
|
|
108
108
|
},
|
|
109
109
|
module: {
|
|
110
110
|
rules: [
|
|
@@ -114,13 +114,13 @@ The following workflow walks through the steps of migrating an actual Vue 2 app
|
|
|
114
114
|
options: {
|
|
115
115
|
compilerOptions: {
|
|
116
116
|
compatConfig: {
|
|
117
|
-
MODE: 2
|
|
118
|
-
}
|
|
119
|
-
}
|
|
120
|
-
}
|
|
121
|
-
}
|
|
122
|
-
]
|
|
123
|
-
}
|
|
117
|
+
MODE: 2,
|
|
118
|
+
},
|
|
119
|
+
},
|
|
120
|
+
},
|
|
121
|
+
},
|
|
122
|
+
],
|
|
123
|
+
},
|
|
124
124
|
}
|
|
125
125
|
```
|
|
126
126
|
|
|
@@ -134,20 +134,20 @@ The following workflow walks through the steps of migrating an actual Vue 2 app
|
|
|
134
134
|
export default {
|
|
135
135
|
resolve: {
|
|
136
136
|
alias: {
|
|
137
|
-
vue: '@vue/compat'
|
|
138
|
-
}
|
|
137
|
+
vue: '@vue/compat',
|
|
138
|
+
},
|
|
139
139
|
},
|
|
140
140
|
plugins: [
|
|
141
141
|
vue({
|
|
142
142
|
template: {
|
|
143
143
|
compilerOptions: {
|
|
144
144
|
compatConfig: {
|
|
145
|
-
MODE: 2
|
|
146
|
-
}
|
|
147
|
-
}
|
|
148
|
-
}
|
|
149
|
-
})
|
|
150
|
-
]
|
|
145
|
+
MODE: 2,
|
|
146
|
+
},
|
|
147
|
+
},
|
|
148
|
+
},
|
|
149
|
+
}),
|
|
150
|
+
],
|
|
151
151
|
}
|
|
152
152
|
```
|
|
153
153
|
|
|
@@ -207,7 +207,7 @@ import { configureCompat } from 'vue'
|
|
|
207
207
|
// disable compat for certain features
|
|
208
208
|
configureCompat({
|
|
209
209
|
FEATURE_ID_A: false,
|
|
210
|
-
FEATURE_ID_B: false
|
|
210
|
+
FEATURE_ID_B: false,
|
|
211
211
|
})
|
|
212
212
|
```
|
|
213
213
|
|
|
@@ -221,7 +221,7 @@ import { configureCompat } from 'vue'
|
|
|
221
221
|
configureCompat({
|
|
222
222
|
MODE: 3,
|
|
223
223
|
FEATURE_ID_A: true,
|
|
224
|
-
FEATURE_ID_B: true
|
|
224
|
+
FEATURE_ID_B: true,
|
|
225
225
|
})
|
|
226
226
|
```
|
|
227
227
|
|
|
@@ -233,8 +233,8 @@ A component can use the `compatConfig` option, which expects the same options as
|
|
|
233
233
|
export default {
|
|
234
234
|
compatConfig: {
|
|
235
235
|
MODE: 3, // opt-in to Vue 3 behavior for this component only
|
|
236
|
-
FEATURE_ID_A: true // features can also be toggled at component level
|
|
237
|
-
}
|
|
236
|
+
FEATURE_ID_A: true, // features can also be toggled at component level
|
|
237
|
+
},
|
|
238
238
|
// ...
|
|
239
239
|
}
|
|
240
240
|
```
|
|
@@ -256,73 +256,73 @@ Features that start with `COMPILER_` are compiler-specific: if you are using the
|
|
|
256
256
|
|
|
257
257
|
> Should be fixed upfront or will likely lead to errors
|
|
258
258
|
|
|
259
|
-
| ID | Type | Description | Docs
|
|
260
|
-
| ------------------------------------- | ---- | ----------------------------------------------------------------------- |
|
|
261
|
-
| GLOBAL_MOUNT_CONTAINER | ⨂ | Mounted application does not replace the element it's mounted to | [link](https://v3-migration.vuejs.org/breaking-changes/mount-changes.html)
|
|
262
|
-
| CONFIG_DEVTOOLS | ⨂ | production devtools is now a build-time flag | [link](https://github.com/vuejs/core/tree/main/packages/vue#bundler-build-feature-flags)
|
|
263
|
-
| COMPILER_V_IF_V_FOR_PRECEDENCE | ⨂ | `v-if` and `v-for` precedence when used on the same element has changed | [link](https://v3-migration.vuejs.org/breaking-changes/v-if-v-for.html)
|
|
264
|
-
| COMPILER_V_IF_SAME_KEY | ⨂ | `v-if` branches can no longer have the same key | [link](https://v3-migration.vuejs.org/breaking-changes/key-attribute.html#on-conditional-branches)
|
|
265
|
-
| COMPILER_V_FOR_TEMPLATE_KEY_PLACEMENT | ⨂ | `<template v-for>` key should now be placed on `<template>` | [link](https://v3-migration.vuejs.org/breaking-changes/key-attribute.html#with-template-v-for)
|
|
266
|
-
| COMPILER_SFC_FUNCTIONAL | ⨂ | `<template functional>` is no longer supported in SFCs | [link](https://v3-migration.vuejs.org/breaking-changes/functional-components.html#single-file-components-sfcs)
|
|
259
|
+
| ID | Type | Description | Docs |
|
|
260
|
+
| ------------------------------------- | ---- | ----------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
|
|
261
|
+
| GLOBAL_MOUNT_CONTAINER | ⨂ | Mounted application does not replace the element it's mounted to | [link](https://v3-migration.vuejs.org/breaking-changes/mount-changes.html) |
|
|
262
|
+
| CONFIG_DEVTOOLS | ⨂ | production devtools is now a build-time flag | [link](https://github.com/vuejs/core/tree/main/packages/vue#bundler-build-feature-flags) |
|
|
263
|
+
| COMPILER_V_IF_V_FOR_PRECEDENCE | ⨂ | `v-if` and `v-for` precedence when used on the same element has changed | [link](https://v3-migration.vuejs.org/breaking-changes/v-if-v-for.html) |
|
|
264
|
+
| COMPILER_V_IF_SAME_KEY | ⨂ | `v-if` branches can no longer have the same key | [link](https://v3-migration.vuejs.org/breaking-changes/key-attribute.html#on-conditional-branches) |
|
|
265
|
+
| COMPILER_V_FOR_TEMPLATE_KEY_PLACEMENT | ⨂ | `<template v-for>` key should now be placed on `<template>` | [link](https://v3-migration.vuejs.org/breaking-changes/key-attribute.html#with-template-v-for) |
|
|
266
|
+
| COMPILER_SFC_FUNCTIONAL | ⨂ | `<template functional>` is no longer supported in SFCs | [link](https://v3-migration.vuejs.org/breaking-changes/functional-components.html#single-file-components-sfcs) |
|
|
267
267
|
|
|
268
268
|
### Partially Compatible with Caveats
|
|
269
269
|
|
|
270
|
-
| ID | Type | Description | Docs
|
|
271
|
-
| ------------------------ | ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
270
|
+
| ID | Type | Description | Docs |
|
|
271
|
+
| ------------------------ | ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------- |
|
|
272
272
|
| CONFIG_IGNORED_ELEMENTS | ◐ | `config.ignoredElements` is now `config.compilerOptions.isCustomElement` (only in browser compiler build). If using build setup, `isCustomElement` must be passed via build configuration. | [link](https://v3-migration.vuejs.org/breaking-changes/global-api.html#config-ignoredelements-is-now-config-iscustomelement) |
|
|
273
273
|
| COMPILER_INLINE_TEMPLATE | ◐ | `inline-template` removed (compat only supported in browser compiler build) | [link](https://v3-migration.vuejs.org/breaking-changes/inline-template-attribute.html) |
|
|
274
274
|
| PROPS_DEFAULT_THIS | ◐ | props default factory no longer have access to `this` (in compat mode, `this` is not a real instance - it only exposes props, `$options` and injections) | [link](https://v3-migration.vuejs.org/breaking-changes/props-default-this.html) |
|
|
275
|
-
| INSTANCE_DESTROY | ◐ | `$destroy` instance method removed (in compat mode, only supported on root instance) |
|
|
276
|
-
| GLOBAL_PRIVATE_UTIL | ◐ | `Vue.util` is private and no longer available |
|
|
275
|
+
| INSTANCE_DESTROY | ◐ | `$destroy` instance method removed (in compat mode, only supported on root instance) | |
|
|
276
|
+
| GLOBAL_PRIVATE_UTIL | ◐ | `Vue.util` is private and no longer available | |
|
|
277
277
|
| CONFIG_PRODUCTION_TIP | ◐ | `config.productionTip` no longer necessary | [link](https://v3-migration.vuejs.org/breaking-changes/global-api.html#config-productiontip-removed) |
|
|
278
278
|
| CONFIG_SILENT | ◐ | `config.silent` removed |
|
|
279
279
|
|
|
280
280
|
### Compat only (no warning)
|
|
281
281
|
|
|
282
|
-
| ID | Type | Description
|
|
283
|
-
| ------------------ | ---- |
|
|
282
|
+
| ID | Type | Description | Docs |
|
|
283
|
+
| ------------------ | ---- | -------------------------------------- | ----------------------------------------------------------------------- |
|
|
284
284
|
| TRANSITION_CLASSES | ⭘ | Transition enter/leave classes changed | [link](https://v3-migration.vuejs.org/breaking-changes/transition.html) |
|
|
285
285
|
|
|
286
286
|
### Fully Compatible
|
|
287
287
|
|
|
288
|
-
| ID | Type | Description | Docs
|
|
289
|
-
| ---------------------------- | ---- | --------------------------------------------------------------------- |
|
|
290
|
-
| GLOBAL_MOUNT | ✔
|
|
291
|
-
| GLOBAL_EXTEND | ✔
|
|
292
|
-
| GLOBAL_PROTOTYPE | ✔
|
|
293
|
-
| GLOBAL_SET | ✔
|
|
294
|
-
| GLOBAL_DELETE | ✔
|
|
295
|
-
| GLOBAL_OBSERVABLE | ✔
|
|
296
|
-
| CONFIG_KEY_CODES | ✔
|
|
297
|
-
| CONFIG_WHITESPACE | ✔
|
|
298
|
-
| INSTANCE_SET | ✔
|
|
299
|
-
| INSTANCE_DELETE | ✔
|
|
300
|
-
| INSTANCE_EVENT_EMITTER | ✔
|
|
301
|
-
| INSTANCE_EVENT_HOOKS | ✔
|
|
302
|
-
| INSTANCE_CHILDREN | ✔
|
|
303
|
-
| INSTANCE_LISTENERS | ✔
|
|
304
|
-
| INSTANCE_SCOPED_SLOTS | ✔
|
|
305
|
-
| INSTANCE_ATTRS_CLASS_STYLE | ✔
|
|
306
|
-
| OPTIONS_DATA_FN | ✔
|
|
307
|
-
| OPTIONS_DATA_MERGE | ✔
|
|
308
|
-
| OPTIONS_BEFORE_DESTROY | ✔
|
|
309
|
-
| OPTIONS_DESTROYED | ✔
|
|
310
|
-
| WATCH_ARRAY | ✔
|
|
311
|
-
| V_ON_KEYCODE_MODIFIER | ✔
|
|
312
|
-
| CUSTOM_DIR | ✔
|
|
313
|
-
| ATTR_FALSE_VALUE | ✔
|
|
314
|
-
| ATTR_ENUMERATED_COERCION | ✔
|
|
315
|
-
| TRANSITION_GROUP_ROOT | ✔
|
|
316
|
-
| COMPONENT_ASYNC | ✔
|
|
317
|
-
| COMPONENT_FUNCTIONAL | ✔
|
|
318
|
-
| COMPONENT_V_MODEL | ✔
|
|
319
|
-
| RENDER_FUNCTION | ✔
|
|
320
|
-
| FILTERS | ✔
|
|
321
|
-
| COMPILER_IS_ON_ELEMENT | ✔
|
|
322
|
-
| COMPILER_V_BIND_SYNC | ✔
|
|
323
|
-
| COMPILER_V_BIND_PROP | ✔
|
|
324
|
-
| COMPILER_V_BIND_OBJECT_ORDER | ✔
|
|
325
|
-
| COMPILER_V_ON_NATIVE | ✔
|
|
326
|
-
| COMPILER_V_FOR_REF | ✔
|
|
327
|
-
| COMPILER_NATIVE_TEMPLATE | ✔
|
|
328
|
-
| COMPILER_FILTERS | ✔
|
|
288
|
+
| ID | Type | Description | Docs |
|
|
289
|
+
| ---------------------------- | ---- | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
|
|
290
|
+
| GLOBAL_MOUNT | ✔ | new Vue() -> createApp | [link](https://v3-migration.vuejs.org/breaking-changes/global-api.html#mounting-app-instance) |
|
|
291
|
+
| GLOBAL_EXTEND | ✔ | Vue.extend removed (use `defineComponent` or `extends` option) | [link](https://v3-migration.vuejs.org/breaking-changes/global-api.html#vue-extend-replaced-by-definecomponent) |
|
|
292
|
+
| GLOBAL_PROTOTYPE | ✔ | `Vue.prototype` -> `app.config.globalProperties` | [link](https://v3-migration.vuejs.org/breaking-changes/global-api.html#vue-prototype-replaced-by-config-globalproperties) |
|
|
293
|
+
| GLOBAL_SET | ✔ | `Vue.set` removed (no longer needed) | |
|
|
294
|
+
| GLOBAL_DELETE | ✔ | `Vue.delete` removed (no longer needed) | |
|
|
295
|
+
| GLOBAL_OBSERVABLE | ✔ | `Vue.observable` removed (use `reactive`) | [link](https://vuejs.org/api/reactivity-core.html#reactive) |
|
|
296
|
+
| CONFIG_KEY_CODES | ✔ | config.keyCodes removed | [link](https://v3-migration.vuejs.org/breaking-changes/keycode-modifiers.html) |
|
|
297
|
+
| CONFIG_WHITESPACE | ✔ | In Vue 3 whitespace defaults to `"condense"` | |
|
|
298
|
+
| INSTANCE_SET | ✔ | `vm.$set` removed (no longer needed) | |
|
|
299
|
+
| INSTANCE_DELETE | ✔ | `vm.$delete` removed (no longer needed) | |
|
|
300
|
+
| INSTANCE_EVENT_EMITTER | ✔ | `vm.$on`, `vm.$off`, `vm.$once` removed | [link](https://v3-migration.vuejs.org/breaking-changes/events-api.html) |
|
|
301
|
+
| INSTANCE_EVENT_HOOKS | ✔ | Instance no longer emits `hook:x` events | [link](https://v3-migration.vuejs.org/breaking-changes/vnode-lifecycle-events.html) |
|
|
302
|
+
| INSTANCE_CHILDREN | ✔ | `vm.$children` removed | [link](https://v3-migration.vuejs.org/breaking-changes/children.html) |
|
|
303
|
+
| INSTANCE_LISTENERS | ✔ | `vm.$listeners` removed | [link](https://v3-migration.vuejs.org/breaking-changes/listeners-removed.html) |
|
|
304
|
+
| INSTANCE_SCOPED_SLOTS | ✔ | `vm.$scopedSlots` removed; `vm.$slots` now exposes functions | [link](https://v3-migration.vuejs.org/breaking-changes/slots-unification.html) |
|
|
305
|
+
| INSTANCE_ATTRS_CLASS_STYLE | ✔ | `$attrs` now includes `class` and `style` | [link](https://v3-migration.vuejs.org/breaking-changes/attrs-includes-class-style.html) |
|
|
306
|
+
| OPTIONS_DATA_FN | ✔ | `data` must be a function in all cases | [link](https://v3-migration.vuejs.org/breaking-changes/data-option.html) |
|
|
307
|
+
| OPTIONS_DATA_MERGE | ✔ | `data` from mixin or extension is now shallow merged | [link](https://v3-migration.vuejs.org/breaking-changes/data-option.html) |
|
|
308
|
+
| OPTIONS_BEFORE_DESTROY | ✔ | `beforeDestroy` -> `beforeUnmount` | |
|
|
309
|
+
| OPTIONS_DESTROYED | ✔ | `destroyed` -> `unmounted` | |
|
|
310
|
+
| WATCH_ARRAY | ✔ | watching an array no longer triggers on mutation unless deep | [link](https://v3-migration.vuejs.org/breaking-changes/watch.html) |
|
|
311
|
+
| V_ON_KEYCODE_MODIFIER | ✔ | `v-on` no longer supports keyCode modifiers | [link](https://v3-migration.vuejs.org/breaking-changes/keycode-modifiers.html) |
|
|
312
|
+
| CUSTOM_DIR | ✔ | Custom directive hook names changed | [link](https://v3-migration.vuejs.org/breaking-changes/custom-directives.html) |
|
|
313
|
+
| ATTR_FALSE_VALUE | ✔ | No longer removes attribute if binding value is boolean `false` | [link](https://v3-migration.vuejs.org/breaking-changes/attribute-coercion.html) |
|
|
314
|
+
| ATTR_ENUMERATED_COERCION | ✔ | No longer special case enumerated attributes | [link](https://v3-migration.vuejs.org/breaking-changes/attribute-coercion.html) |
|
|
315
|
+
| TRANSITION_GROUP_ROOT | ✔ | `<transition-group>` no longer renders a root element by default | [link](https://v3-migration.vuejs.org/breaking-changes/transition-group.html) |
|
|
316
|
+
| COMPONENT_ASYNC | ✔ | Async component API changed (now requires `defineAsyncComponent`) | [link](https://v3-migration.vuejs.org/breaking-changes/async-components.html) |
|
|
317
|
+
| COMPONENT_FUNCTIONAL | ✔ | Functional component API changed (now must be plain functions) | [link](https://v3-migration.vuejs.org/breaking-changes/functional-components.html) |
|
|
318
|
+
| COMPONENT_V_MODEL | ✔ | Component v-model reworked | [link](https://v3-migration.vuejs.org/breaking-changes/v-model.html) |
|
|
319
|
+
| RENDER_FUNCTION | ✔ | Render function API changed | [link](https://v3-migration.vuejs.org/breaking-changes/render-function-api.html) |
|
|
320
|
+
| FILTERS | ✔ | Filters removed (this option affects only runtime filter APIs) | [link](https://v3-migration.vuejs.org/breaking-changes/filters.html) |
|
|
321
|
+
| COMPILER_IS_ON_ELEMENT | ✔ | `is` usage is now restricted to `<component>` only | [link](https://v3-migration.vuejs.org/breaking-changes/custom-elements-interop.html) |
|
|
322
|
+
| COMPILER_V_BIND_SYNC | ✔ | `v-bind.sync` replaced by `v-model` with arguments | [link](https://v3-migration.vuejs.org/breaking-changes/v-model.html) |
|
|
323
|
+
| COMPILER_V_BIND_PROP | ✔ | `v-bind.prop` modifier removed | |
|
|
324
|
+
| COMPILER_V_BIND_OBJECT_ORDER | ✔ | `v-bind="object"` is now order sensitive | [link](https://v3-migration.vuejs.org/breaking-changes/v-bind.html) |
|
|
325
|
+
| COMPILER_V_ON_NATIVE | ✔ | `v-on.native` modifier removed | [link](https://v3-migration.vuejs.org/breaking-changes/v-on-native-modifier-removed.html) |
|
|
326
|
+
| COMPILER_V_FOR_REF | ✔ | `ref` in `v-for` (compiler support) | |
|
|
327
|
+
| COMPILER_NATIVE_TEMPLATE | ✔ | `<template>` with no special directives now renders as native element | |
|
|
328
|
+
| COMPILER_FILTERS | ✔ | filters (compiler support) | |
|
package/dist/vue-compat.d.ts
CHANGED