@vue/runtime-core 3.5.0-alpha.2 → 3.5.0-alpha.3

package/dist/runtime-core.d.ts

@@ -1,5 +1,5 @@
-import { computed as computed$1, Ref, ShallowUnwrapRef, UnwrapNestedRefs, DebuggerEvent, ComputedGetter, WritableComputedOptions, ReactiveEffect, ComputedRef, DebuggerOptions, reactive } from '@vue/reactivity';
-export { ComputedGetter, ComputedRef, ComputedSetter, CustomRefFactory, DebuggerEvent, DebuggerEventExtraInfo, DebuggerOptions, DeepReadonly, EffectScheduler, EffectScope, MaybeRef, MaybeRefOrGetter, Raw, ReactiveEffect, ReactiveEffectOptions, ReactiveEffectRunner, ReactiveFlags, Ref, ShallowReactive, ShallowRef, ShallowUnwrapRef, ToRef, ToRefs, TrackOpTypes, TriggerOpTypes, UnwrapNestedRefs, UnwrapRef, WritableComputedOptions, WritableComputedRef, customRef, effect, effectScope, getCurrentScope, isProxy, isReactive, isReadonly, isRef, isShallow, markRaw, onScopeDispose, proxyRefs, reactive, readonly, ref, shallowReactive, shallowReadonly, shallowRef, stop, toRaw, toRef, toRefs, toValue, triggerRef, unref } from '@vue/reactivity';
+import { computed as computed$1, Ref, ShallowUnwrapRef, UnwrapNestedRefs, DebuggerEvent, ComputedGetter, WritableComputedOptions, ReactiveEffect, ComputedRef, DebuggerOptions, ReactiveMarker, ShallowRef, reactive } from '@vue/reactivity';
+export { ComputedGetter, ComputedRef, ComputedSetter, CustomRefFactory, DebuggerEvent, DebuggerEventExtraInfo, DebuggerOptions, DeepReadonly, EffectScheduler, EffectScope, MaybeRef, MaybeRefOrGetter, Raw, Reactive, ReactiveEffect, ReactiveEffectOptions, ReactiveEffectRunner, ReactiveFlags, Ref, ShallowReactive, ShallowRef, ShallowUnwrapRef, ToRef, ToRefs, TrackOpTypes, TriggerOpTypes, UnwrapNestedRefs, UnwrapRef, WritableComputedOptions, WritableComputedRef, customRef, effect, effectScope, getCurrentScope, isProxy, isReactive, isReadonly, isRef, isShallow, markRaw, onScopeDispose, proxyRefs, reactive, readonly, ref, shallowReactive, shallowReadonly, shallowRef, stop, toRaw, toRef, toRefs, toValue, triggerRef, unref } from '@vue/reactivity';
 import { IfAny, Prettify, Awaited, LooseRequired, UnionToIntersection, OverloadParameters } from '@vue/shared';
 export { camelize, capitalize, normalizeClass, normalizeProps, normalizeStyle, toDisplayString, toHandlerKey } from '@vue/shared';
 
@@ -54,9 +54,8 @@ interface SchedulerJob extends Function {
     /**
      * Attached by renderer.ts when setting up a component's render effect
      * Used to obtain component information when reporting max recursive updates.
-     * dev only.
      */
-    ownerInstance?: ComponentInternalInstance;
+    i?: ComponentInternalInstance;
 }
 type SchedulerJobs = SchedulerJob | SchedulerJob[];
 export declare function nextTick<T = void, R = void>(this: T, fn?: (this: T) => R): Promise<Awaited<R>>;
@@ -209,7 +208,7 @@ type BooleanKey<T, K extends keyof T = keyof T> = K extends any ? [T[K]] extends
  * const emit = defineEmits<{
  *   // <eventName>: <expected arguments>
  *   change: []
- *   update: [value: string] // named tuple syntax
+ *   update: [value: number] // named tuple syntax
  * }>()
  *
  * emit('change')
@@ -270,7 +269,7 @@ export declare function defineOptions<RawBindings = {}, D = {}, C extends Comput
     slots?: never;
 }): void;
 export declare function defineSlots<S extends Record<string, any> = Record<string, any>>(): StrictUnwrapSlotsType<SlotsType<S>>;
-export type ModelRef<T, M extends string | number | symbol = string> = Ref<T> & [
+export type ModelRef<T, M extends PropertyKey = string> = Ref<T> & [
     ModelRef<T, M>,
     Record<M, true | undefined>
 ];
@@ -311,20 +310,20 @@ type DefineModelOptions<T = any> = {
  * const count = defineModel<number>('count', { default: 0 })
  * ```
  */
-export declare function defineModel<T, M extends string | number | symbol = string>(options: {
+export declare function defineModel<T, M extends PropertyKey = string>(options: {
     required: true;
 } & PropOptions<T> & DefineModelOptions<T>): ModelRef<T, M>;
-export declare function defineModel<T, M extends string | number | symbol = string>(options: {
+export declare function defineModel<T, M extends PropertyKey = string>(options: {
     default: any;
 } & PropOptions<T> & DefineModelOptions<T>): ModelRef<T, M>;
-export declare function defineModel<T, M extends string | number | symbol = string>(options?: PropOptions<T> & DefineModelOptions<T>): ModelRef<T | undefined, M>;
-export declare function defineModel<T, M extends string | number | symbol = string>(name: string, options: {
+export declare function defineModel<T, M extends PropertyKey = string>(options?: PropOptions<T> & DefineModelOptions<T>): ModelRef<T | undefined, M>;
+export declare function defineModel<T, M extends PropertyKey = string>(name: string, options: {
     required: true;
 } & PropOptions<T> & DefineModelOptions<T>): ModelRef<T, M>;
-export declare function defineModel<T, M extends string | number | symbol = string>(name: string, options: {
+export declare function defineModel<T, M extends PropertyKey = string>(name: string, options: {
     default: any;
 } & PropOptions<T> & DefineModelOptions<T>): ModelRef<T, M>;
-export declare function defineModel<T, M extends string | number | symbol = string>(name: string, options?: PropOptions<T> & DefineModelOptions<T>): ModelRef<T | undefined, M>;
+export declare function defineModel<T, M extends PropertyKey = string>(name: string, options?: PropOptions<T> & DefineModelOptions<T>): ModelRef<T | undefined, M>;
 type NotUndefined<T> = T extends undefined ? never : T;
 type MappedOmit<T, K extends keyof any> = {
     [P in keyof T as P extends K ? never : P]: T[P];
@@ -376,10 +375,10 @@ type TypeEmitsToOptions<T extends ComponentTypeEmits> = T extends Record<string,
 type ParametersToFns<T extends any[]> = {
     [K in T[0]]: K extends `${infer C}` ? (...args: T extends [C, ...infer Args] ? Args : never) => any : never;
 };
-type ShortEmitsToObject<E> = E extends Record<string, any[]> ? {
+export type ShortEmitsToObject<E> = E extends Record<string, any[]> ? {
     [K in keyof E]: (...args: E[K]) => any;
 } : E;
-type EmitFn<Options = ObjectEmitsOptions, Event extends keyof Options = keyof Options> = Options extends Array<infer V> ? (event: V, ...args: any[]) => void : {} extends Options ? (event: string, ...args: any[]) => void : UnionToIntersection<{
+export type EmitFn<Options = ObjectEmitsOptions, Event extends keyof Options = keyof Options> = Options extends Array<infer V> ? (event: V, ...args: any[]) => void : {} extends Options ? (event: string, ...args: any[]) => void : UnionToIntersection<{
     [key in Event]: Options[key] extends (...args: infer Args) => any ? (event: key, ...args: Args) => void : Options[key] extends any[] ? (event: key, ...args: Options[key]) => void : (event: key, ...args: any[]) => void;
 }[Event]>;
 
@@ -397,7 +396,7 @@ return withDirectives(h(comp), [
 */
 
 export interface DirectiveBinding<Value = any, Modifiers extends string = string, Arg extends string = string> {
-    instance: ComponentPublicInstance | null;
+    instance: ComponentPublicInstance | Record<string, any> | null;
     value: Value;
     oldValue: Value | null;
     arg?: Arg;
@@ -484,7 +483,7 @@ type ExposedKeys<T, Exposed extends string & keyof T> = '' extends Exposed ? T :
 export type ComponentPublicInstance<P = {}, // props type extracted from props option
 B = {}, // raw bindings returned from setup()
 D = {}, // return from data()
-C extends ComputedOptions = {}, M extends MethodOptions = {}, E extends EmitsOptions = {}, PublicProps = P, Defaults = {}, MakeDefaultsOptional extends boolean = false, Options = ComponentOptionsBase<any, any, any, any, any, any, any, any, any>, I extends ComponentInjectOptions = {}, S extends SlotsType = {}, Exposed extends string = ''> = {
+C extends ComputedOptions = {}, M extends MethodOptions = {}, E extends EmitsOptions = {}, PublicProps = {}, Defaults = {}, MakeDefaultsOptional extends boolean = false, Options = ComponentOptionsBase<any, any, any, any, any, any, any, any, any>, I extends ComponentInjectOptions = {}, S extends SlotsType = {}, Exposed extends string = ''> = {
     $: ComponentInternalInstance;
     $data: D;
     $props: MakeDefaultsOptional extends true ? Partial<Defaults> & Omit<Prettify<P> & PublicProps, keyof Defaults> : Prettify<P> & PublicProps;
@@ -498,8 +497,8 @@ C extends ComputedOptions = {}, M extends MethodOptions = {}, E extends EmitsOpt
     $options: Options & MergedComponentOptionsOverride;
     $forceUpdate: () => void;
     $nextTick: typeof nextTick;
-    $watch<T extends string | ((...args: any) => any)>(source: T, cb: T extends (...args: any) => infer R ? (...args: [R, R]) => any : (...args: any) => any, options?: WatchOptions): WatchStopHandle;
-} & ExposedKeys<IfAny<P, P, Omit<P, keyof ShallowUnwrapRef<B>>> & ShallowUnwrapRef<B> & UnwrapNestedRefs<D> & ExtractComputedReturns<C> & M & ComponentCustomProperties & InjectToObject<I>, Exposed>;
+    $watch<T extends string | ((...args: any) => any)>(source: T, cb: T extends (...args: any) => infer R ? (...args: [R, R, OnCleanup]) => any : (...args: [any, any, OnCleanup]) => any, options?: WatchOptions): WatchStopHandle;
+} & ExposedKeys<IfAny<P, P, Readonly<Defaults> & Omit<P, keyof ShallowUnwrapRef<B> | keyof Defaults>> & ShallowUnwrapRef<B> & UnwrapNestedRefs<D> & ExtractComputedReturns<C> & M & ComponentCustomProperties & InjectToObject<I>, Exposed>;
 
 declare enum LifecycleHooks {
     BEFORE_CREATE = "bc",
@@ -535,7 +534,6 @@ declare const SuspenseImpl: {
     __isSuspense: boolean;
     process(n1: VNode | null, n2: VNode, container: RendererElement, anchor: RendererNode | null, parentComponent: ComponentInternalInstance | null, parentSuspense: SuspenseBoundary | null, namespace: ElementNamespace, slotScopeIds: string[] | null, optimized: boolean, rendererInternals: RendererInternals): void;
     hydrate: typeof hydrateSuspense;
-    create: typeof createSuspenseBoundary;
     normalize: typeof normalizeSuspenseChildren;
 };
 export declare const Suspense: {
@@ -568,10 +566,9 @@ export interface SuspenseBoundary {
     fallback(fallbackVNode: VNode): void;
     move(container: RendererElement, anchor: RendererNode | null, type: MoveType): void;
     next(): RendererNode | null;
-    registerDep(instance: ComponentInternalInstance, setupRenderEffect: SetupRenderEffectFn): void;
+    registerDep(instance: ComponentInternalInstance, setupRenderEffect: SetupRenderEffectFn, optimized: boolean): void;
     unmount(parentSuspense: SuspenseBoundary | null, doRemove?: boolean): void;
 }
-declare function createSuspenseBoundary(vnode: VNode, parentSuspense: SuspenseBoundary | null, parentComponent: ComponentInternalInstance | null, container: RendererElement, hiddenContainer: RendererElement, anchor: RendererNode | null, namespace: ElementNamespace, slotScopeIds: string[] | null, optimized: boolean, rendererInternals: RendererInternals, isHydrating?: boolean): SuspenseBoundary;
 declare function hydrateSuspense(node: Node, vnode: VNode, parentComponent: ComponentInternalInstance | null, parentSuspense: SuspenseBoundary | null, namespace: ElementNamespace, slotScopeIds: string[] | null, optimized: boolean, rendererInternals: RendererInternals, hydrateNode: (node: Node, vnode: VNode, parentComponent: ComponentInternalInstance | null, parentSuspense: SuspenseBoundary | null, slotScopeIds: string[] | null, optimized: boolean) => Node | null): Node | null;
 declare function normalizeSuspenseChildren(vnode: VNode): void;
 
@@ -638,7 +635,7 @@ export declare const BaseTransition: new () => {
         default(): VNode[];
     };
 };
-export declare function resolveTransitionHooks(vnode: VNode, props: BaseTransitionProps<any>, state: TransitionState, instance: ComponentInternalInstance): TransitionHooks;
+export declare function resolveTransitionHooks(vnode: VNode, props: BaseTransitionProps<any>, state: TransitionState, instance: ComponentInternalInstance, postClone?: (hooks: TransitionHooks) => void): TransitionHooks;
 export declare function setTransitionHooks(vnode: VNode, hooks: TransitionHooks): void;
 export declare function getTransitionRawChildren(children: VNode[], keepComment?: boolean, parentKey?: VNode['key']): VNode[];
 
@@ -652,7 +649,7 @@ export interface HydrationRenderer extends Renderer<Element | ShadowRoot> {
 export type ElementNamespace = 'svg' | 'mathml' | undefined;
 export type RootRenderFunction<HostElement = RendererElement> = (vnode: VNode | null, container: HostElement, namespace?: ElementNamespace) => void;
 export interface RendererOptions<HostNode = RendererNode, HostElement = RendererElement> {
-    patchProp(el: HostElement, key: string, prevValue: any, nextValue: any, namespace?: ElementNamespace, prevChildren?: VNode<HostNode, HostElement>[], parentComponent?: ComponentInternalInstance | null, parentSuspense?: SuspenseBoundary | null, unmountChildren?: UnmountChildrenFn): void;
+    patchProp(el: HostElement, key: string, prevValue: any, nextValue: any, namespace?: ElementNamespace, parentComponent?: ComponentInternalInstance | null): void;
     insert(el: HostNode, parent: HostElement, anchor?: HostNode | null): void;
     remove(el: HostNode): void;
     createElement(type: string, namespace?: ElementNamespace, isCustomizedBuiltIn?: string, vnodeProps?: (VNodeProps & {
@@ -670,7 +667,7 @@ export interface RendererOptions<HostNode = RendererNode, HostElement = Renderer
     insertStaticContent?(content: string, parent: HostElement, anchor: HostNode | null, namespace: ElementNamespace, start?: HostNode | null, end?: HostNode | null): [HostNode, HostNode];
 }
 export interface RendererNode {
-    [key: string]: any;
+    [key: string | symbol]: any;
 }
 export interface RendererElement extends RendererNode {
 }
@@ -695,7 +692,6 @@ type MoveFn = (vnode: VNode, container: RendererElement, anchor: RendererNode |
 type NextFn = (vnode: VNode) => RendererNode | null;
 type UnmountFn = (vnode: VNode, parentComponent: ComponentInternalInstance | null, parentSuspense: SuspenseBoundary | null, doRemove?: boolean, optimized?: boolean) => void;
 type RemoveFn = (vnode: VNode) => void;
-type UnmountChildrenFn = (children: VNode[], parentComponent: ComponentInternalInstance | null, parentSuspense: SuspenseBoundary | null, doRemove?: boolean, optimized?: boolean, start?: number) => void;
 type MountComponentFn = (initialVNode: VNode, container: RendererElement, anchor: RendererNode | null, parentComponent: ComponentInternalInstance | null, parentSuspense: SuspenseBoundary | null, namespace: ElementNamespace, optimized: boolean) => void;
 type SetupRenderEffectFn = (instance: ComponentInternalInstance, initialVNode: VNode, container: RendererElement, anchor: RendererNode | null, parentSuspense: SuspenseBoundary | null, namespace: ElementNamespace, optimized: boolean) => void;
 declare enum MoveType {
@@ -739,16 +735,16 @@ export declare const KeepAlive: {
 export declare function onActivated(hook: Function, target?: ComponentInternalInstance | null): void;
 export declare function onDeactivated(hook: Function, target?: ComponentInternalInstance | null): void;
 
-export declare const onBeforeMount: (hook: () => any, target?: ComponentInternalInstance | null) => false | Function | undefined;
-export declare const onMounted: (hook: () => any, target?: ComponentInternalInstance | null) => false | Function | undefined;
-export declare const onBeforeUpdate: (hook: () => any, target?: ComponentInternalInstance | null) => false | Function | undefined;
-export declare const onUpdated: (hook: () => any, target?: ComponentInternalInstance | null) => false | Function | undefined;
-export declare const onBeforeUnmount: (hook: () => any, target?: ComponentInternalInstance | null) => false | Function | undefined;
-export declare const onUnmounted: (hook: () => any, target?: ComponentInternalInstance | null) => false | Function | undefined;
-export declare const onServerPrefetch: (hook: () => any, target?: ComponentInternalInstance | null) => false | Function | undefined;
+export declare const onBeforeMount: (hook: () => any, target?: ComponentInternalInstance | null) => void;
+export declare const onMounted: (hook: () => any, target?: ComponentInternalInstance | null) => void;
+export declare const onBeforeUpdate: (hook: () => any, target?: ComponentInternalInstance | null) => void;
+export declare const onUpdated: (hook: () => any, target?: ComponentInternalInstance | null) => void;
+export declare const onBeforeUnmount: (hook: () => any, target?: ComponentInternalInstance | null) => void;
+export declare const onUnmounted: (hook: () => any, target?: ComponentInternalInstance | null) => void;
+export declare const onServerPrefetch: (hook: () => any, target?: ComponentInternalInstance | null) => void;
 type DebuggerHook = (e: DebuggerEvent) => void;
-export declare const onRenderTriggered: (hook: DebuggerHook, target?: ComponentInternalInstance | null) => false | Function | undefined;
-export declare const onRenderTracked: (hook: DebuggerHook, target?: ComponentInternalInstance | null) => false | Function | undefined;
+export declare const onRenderTriggered: (hook: DebuggerHook, target?: ComponentInternalInstance | null) => void;
+export declare const onRenderTracked: (hook: DebuggerHook, target?: ComponentInternalInstance | null) => void;
 type ErrorCapturedHook<TError = unknown> = (err: TError, instance: ComponentPublicInstance | null, info: string) => boolean | void;
 export declare function onErrorCaptured<TError = Error>(hook: ErrorCapturedHook<TError>, target?: ComponentInternalInstance | null): void;
 
@@ -1034,7 +1030,7 @@ export interface App<HostElement = any> {
     mount(rootContainer: HostElement | string, isHydrate?: boolean, namespace?: boolean | ElementNamespace): ComponentPublicInstance;
     unmount(): void;
     onUnmount(cb: () => void): void;
-    provide<T>(key: InjectionKey<T> | string, value: T): this;
+    provide<T, K = InjectionKey<T> | string | number>(key: K, value: K extends InjectionKey<infer V> ? V : T): this;
     /**
      * Runs a function with the app as active instance. This allows using of `inject()` within the function to get access
      * to variables provided via `app.provide()`.
@@ -1076,6 +1072,16 @@ export interface AppConfig {
      * Enable warnings for computed getters that recursively trigger itself.
      */
     warnRecursiveComputed?: boolean;
+    /**
+     * Whether to throw unhandled errors in production.
+     * Default is `false` to avoid crashing on any error (and only logs it)
+     * But in some cases, e.g. SSR, throwing might be more desirable.
+     */
+    throwUnhandledErrorInProduction?: boolean;
+    /**
+     * Prefix for all useId() calls within this app
+     */
+    idPrefix?: string;
 }
 export interface AppContext {
     app: App;
@@ -1097,12 +1103,13 @@ type TeleportVNode = VNode<RendererNode, RendererElement, TeleportProps>;
 export interface TeleportProps {
     to: string | RendererElement | null | undefined;
     disabled?: boolean;
+    defer?: boolean;
 }
 declare const TeleportImpl: {
     name: string;
     __isTeleport: boolean;
     process(n1: TeleportVNode | null, n2: TeleportVNode, container: RendererElement, anchor: RendererNode | null, parentComponent: ComponentInternalInstance | null, parentSuspense: SuspenseBoundary | null, namespace: ElementNamespace, slotScopeIds: string[] | null, optimized: boolean, internals: RendererInternals): void;
-    remove(vnode: VNode, parentComponent: ComponentInternalInstance | null, parentSuspense: SuspenseBoundary | null, optimized: boolean, { um: unmount, o: { remove: hostRemove } }: RendererInternals, doRemove: boolean): void;
+    remove(vnode: VNode, parentComponent: ComponentInternalInstance | null, parentSuspense: SuspenseBoundary | null, { um: unmount, o: { remove: hostRemove } }: RendererInternals, doRemove: boolean): void;
     move: typeof moveTeleport;
     hydrate: typeof hydrateTeleport;
 };
@@ -1149,16 +1156,28 @@ export declare const Static: unique symbol;
 export type VNodeTypes = string | VNode | Component | typeof Text | typeof Static | typeof Comment | typeof Fragment | typeof Teleport | typeof TeleportImpl | typeof Suspense | typeof SuspenseImpl;
 export type VNodeRef = string | Ref | ((ref: Element | ComponentPublicInstance | null, refs: Record<string, any>) => void);
 type VNodeNormalizedRefAtom = {
+    /**
+     * component instance
+     */
     i: ComponentInternalInstance;
+    /**
+     * Actual ref
+     */
     r: VNodeRef;
+    /**
+     * setup ref key
+     */
     k?: string;
+    /**
+     * refInFor marker
+     */
     f?: boolean;
 };
 type VNodeNormalizedRef = VNodeNormalizedRefAtom | VNodeNormalizedRefAtom[];
 type VNodeMountHook = (vnode: VNode) => void;
 type VNodeUpdateHook = (vnode: VNode, oldVNode: VNode) => void;
 export type VNodeProps = {
-    key?: string | number | symbol;
+    key?: PropertyKey;
     ref?: VNodeRef;
     ref_for?: boolean;
     ref_key?: string;
@@ -1178,7 +1197,7 @@ export interface VNode<HostNode = RendererNode, HostElement = RendererElement, E
 }> {
     type: VNodeTypes;
     props: (VNodeProps & ExtraProps) | null;
-    key: string | number | symbol | null;
+    key: PropertyKey | null;
     ref: VNodeNormalizedRef | null;
     /**
      * SFC only. This is assigned on vnode creation using currentScopeId
@@ -1192,6 +1211,7 @@ export interface VNode<HostNode = RendererNode, HostElement = RendererElement, E
     el: HostNode | null;
     anchor: HostNode | null;
     target: HostElement | null;
+    targetStart: HostNode | null;
     targetAnchor: HostNode | null;
     suspense: SuspenseBoundary | null;
     shapeFlag: number;
@@ -1284,7 +1304,7 @@ type Data = Record<string, unknown>;
  * the usage of `InstanceType<typeof Comp>` which only works for
  * constructor-based component definition types.
  *
- * Exmaple:
+ * @example
  * ```ts
  * const MyComp = { ... }
  * declare const instance: ComponentInstance<typeof MyComp>
@@ -1387,7 +1407,7 @@ export type SetupContext<E = EmitsOptions, S extends SlotsType = {}> = E extends
     attrs: Data;
     slots: UnwrapSlotsType<S>;
     emit: EmitFn<E>;
-    expose: (exposed?: Record<string, any>) => void;
+    expose: <Exposed extends Record<string, any> = Record<string, any>>(exposed?: Exposed) => void;
 } : never;
 /**
  * We expose a subset of properties on the internal instance as they are
@@ -1428,8 +1448,6 @@ export interface ComponentInternalInstance {
     slots: InternalSlots;
     refs: Data;
     emit: EmitFn;
-    attrsProxy: Data | null;
-    slotsProxy: Slots | null;
     isMounted: boolean;
     isUnmounted: boolean;
     isDeactivated: boolean;
@@ -1445,8 +1463,9 @@ export declare const isRuntimeOnly: () => boolean;
 export type WatchEffect = (onCleanup: OnCleanup) => void;
 export type WatchSource<T = any> = Ref<T> | ComputedRef<T> | (() => T);
 export type WatchCallback<V = any, OV = any> = (value: V, oldValue: OV, onCleanup: OnCleanup) => any;
+type MaybeUndefined<T, I> = I extends true ? T | undefined : T;
 type MapSources<T, Immediate> = {
-    [K in keyof T]: T[K] extends WatchSource<infer V> ? Immediate extends true ? V | undefined : V : T[K] extends object ? Immediate extends true ? T[K] | undefined : T[K] : never;
+    [K in keyof T]: T[K] extends WatchSource<infer V> ? MaybeUndefined<V, Immediate> : T[K] extends object ? MaybeUndefined<T[K], Immediate> : never;
 };
 type OnCleanup = (cleanupFn: () => void) => void;
 export interface WatchOptionsBase extends DebuggerOptions {
@@ -1462,10 +1481,10 @@ export declare function watchEffect(effect: WatchEffect, options?: WatchOptionsB
 export declare function watchPostEffect(effect: WatchEffect, options?: DebuggerOptions): WatchStopHandle;
 export declare function watchSyncEffect(effect: WatchEffect, options?: DebuggerOptions): WatchStopHandle;
 type MultiWatchSources = (WatchSource<unknown> | object)[];
-export declare function watch<T, Immediate extends Readonly<boolean> = false>(source: WatchSource<T>, cb: WatchCallback<T, Immediate extends true ? T | undefined : T>, options?: WatchOptions<Immediate>): WatchStopHandle;
+export declare function watch<T, Immediate extends Readonly<boolean> = false>(source: WatchSource<T>, cb: WatchCallback<T, MaybeUndefined<T, Immediate>>, options?: WatchOptions<Immediate>): WatchStopHandle;
+export declare function watch<T extends Readonly<MultiWatchSources>, Immediate extends Readonly<boolean> = false>(sources: readonly [...T] | T, cb: [T] extends [ReactiveMarker] ? WatchCallback<T, MaybeUndefined<T, Immediate>> : WatchCallback<MapSources<T, false>, MapSources<T, Immediate>>, options?: WatchOptions<Immediate>): WatchStopHandle;
 export declare function watch<T extends MultiWatchSources, Immediate extends Readonly<boolean> = false>(sources: [...T], cb: WatchCallback<MapSources<T, false>, MapSources<T, Immediate>>, options?: WatchOptions<Immediate>): WatchStopHandle;
-export declare function watch<T extends Readonly<MultiWatchSources>, Immediate extends Readonly<boolean> = false>(source: T, cb: WatchCallback<MapSources<T, false>, MapSources<T, Immediate>>, options?: WatchOptions<Immediate>): WatchStopHandle;
-export declare function watch<T extends object, Immediate extends Readonly<boolean> = false>(source: T, cb: WatchCallback<T, Immediate extends true ? T | undefined : T>, options?: WatchOptions<Immediate>): WatchStopHandle;
+export declare function watch<T extends object, Immediate extends Readonly<boolean> = false>(source: T, cb: WatchCallback<T, MaybeUndefined<T, Immediate>>, options?: WatchOptions<Immediate>): WatchStopHandle;
 
 type AsyncComponentResolveResult<T = Component> = T | {
     default: T;
@@ -1485,7 +1504,11 @@ export declare function defineAsyncComponent<T extends Component = {
     new (): ComponentPublicInstance;
 }>(source: AsyncComponentLoader<T> | AsyncComponentOptions<T>): T;
 
-export declare function useModel<M extends string | number | symbol, T extends Record<string, any>, K extends keyof T>(props: T, name: K, options?: DefineModelOptions<T[K]>): ModelRef<T[K], M>;
+export declare function useModel<M extends PropertyKey, T extends Record<string, any>, K extends keyof T>(props: T, name: K, options?: DefineModelOptions<T[K]>): ModelRef<T[K], M>;
+
+export declare function useTemplateRef<T = unknown>(key: string): Readonly<ShallowRef<T | null>>;
+
+export declare function useId(): string | undefined;
 
 type RawProps = VNodeProps & {
     __v_isVNode?: never;
@@ -1548,12 +1571,13 @@ export declare enum ErrorCodes {
     FUNCTION_REF = 12,
     ASYNC_COMPONENT_LOADER = 13,
     SCHEDULER = 14,
-    APP_UNMOUNT_CLEANUP = 15
+    COMPONENT_UPDATE = 15,
+    APP_UNMOUNT_CLEANUP = 16
 }
 type ErrorTypes = LifecycleHooks | ErrorCodes;
-export declare function callWithErrorHandling(fn: Function, instance: ComponentInternalInstance | null, type: ErrorTypes, args?: unknown[]): any;
+export declare function callWithErrorHandling(fn: Function, instance: ComponentInternalInstance | null | undefined, type: ErrorTypes, args?: unknown[]): any;
 export declare function callWithAsyncErrorHandling(fn: Function | Function[], instance: ComponentInternalInstance | null, type: ErrorTypes, args?: unknown[]): any;
-export declare function handleError(err: unknown, instance: ComponentInternalInstance | null, type: ErrorTypes, throwInDev?: boolean): void;
+export declare function handleError(err: unknown, instance: ComponentInternalInstance | null | undefined, type: ErrorTypes, throwInDev?: boolean): void;
 
 export declare function initCustomFormatter(): void;
 
@@ -1630,7 +1654,7 @@ export declare function renderList<T>(source: Iterable<T>, renderItem: (value: T
 /**
  * v-for object
  */
-export declare function renderList<T>(source: T, renderItem: <K extends keyof T>(value: T[K], key: K, index: number) => VNodeChild): VNodeChild[];
+export declare function renderList<T>(source: T, renderItem: <K extends keyof T>(value: T[K], key: string, index: number) => VNodeChild): VNodeChild[];
 
 /**
  * For prefixing keys in v-on="obj" with "on"
@@ -1690,8 +1714,8 @@ export type LegacyConfig = {
 
 type LegacyPublicInstance = ComponentPublicInstance & LegacyPublicProperties;
 interface LegacyPublicProperties {
-    $set(target: object, key: string, value: any): void;
-    $delete(target: object, key: string): void;
+    $set<T extends Record<keyof any, any>, K extends keyof T>(target: T, key: K, value: T[K]): void;
+    $delete<T extends Record<keyof any, any>, K extends keyof T>(target: T, key: K): void;
     $mount(el?: string | Element): this;
     $destroy(): void;
     $scopedSlots: Slots;
@@ -1728,11 +1752,11 @@ export type CompatVue = Pick<App, 'version' | 'component' | 'directive'> & {
     /**
      * @deprecated Vue 3 no longer needs set() for adding new properties.
      */
-    set(target: any, key: string | number | symbol, value: any): void;
+    set(target: any, key: PropertyKey, value: any): void;
     /**
      * @deprecated Vue 3 no longer needs delete() for property deletions.
      */
-    delete(target: any, key: string | number | symbol): void;
+    delete(target: any, key: PropertyKey): void;
     /**
      * @deprecated use `reactive` instead.
      */