@vue/runtime-vapor 3.6.0-beta.11 → 3.6.0-beta.13

package/dist/runtime-vapor.d.ts

@@ -7,6 +7,8 @@ type NodeRef = string | Ref | ((ref: Element | VaporComponentInstance, refs: Rec
 type RefEl = Element | VaporComponentInstance | DynamicFragment | VaporFragment;
 type setRefFn = (el: RefEl, ref: NodeRef, refFor?: boolean, refKey?: string) => NodeRef | undefined;
 export declare function createTemplateRefSetter(): setRefFn;
+export declare function setStaticTemplateRef(el: RefEl, ref: NodeRef, refFor?: boolean, refKey?: string): NodeRef | undefined;
+export declare function setTemplateRefBinding(el: RefEl, getter: () => any, setter?: setRefFn, refFor?: boolean, refKey?: string): void;
 //#endregion
 //#region temp/packages/runtime-vapor/src/keepAlive.d.ts
 export interface VaporKeepAliveContext {
@@ -27,8 +29,11 @@ export declare class VaporFragment<T extends Block = Block> implements Transitio
   validityPending?: boolean;
   insert?: (parent: ParentNode, anchor: Node | null, transitionHooks?: TransitionHooks) => void;
   remove?: (parent?: ParentNode, transitionHooks?: TransitionHooks) => void;
-  hydrate?: (...args: any[]) => void;
+  hydrate?(...args: any[]): void;
   setRef?: (instance: VaporComponentInstance, ref: NodeRef, refFor: boolean, refKey: string | undefined) => void;
+  onBeforeInsert?: ((nodes: Block) => void)[];
+  onBeforeRemove?: ((scope: EffectScope$1) => boolean)[];
+  onBeforeUpdate?: (() => void)[];
   onUpdated?: ((nodes?: Block) => void)[];
   readonly renderInstance: GenericComponentInstance | null;
   readonly slotOwner: VaporComponentInstance | null;
@@ -38,7 +43,9 @@ export declare class VaporFragment<T extends Block = Block> implements Transitio
   protected runWithRenderCtx<R>(fn: () => R, scope?: EffectScope$1): R;
 }
 declare class ForFragment extends VaporFragment<Block[]> {
+  resetListeners?: (() => void)[];
   constructor(nodes: Block[]);
+  onReset(fn: () => void): void;
 }
 export declare class DynamicFragment extends VaporFragment {
   anchor: Node;
@@ -47,21 +54,23 @@ export declare class DynamicFragment extends VaporFragment {
   pending?: {
     render?: BlockFn;
     key: any;
+    noScope: boolean;
   };
   anchorLabel?: string;
   keyed?: boolean;
   inTransition?: boolean;
-  attrs?: Record<string, any>;
-  constructor(anchorLabel?: string, keyed?: boolean, locate?: boolean);
-  protected registerSlotBoundaryDirty(): void;
-  update(render?: BlockFn, key?: any): void;
-  renderBranch(render: BlockFn | undefined, transition: VaporTransitionHooks | undefined, parent: ParentNode | null, key: any): void;
-  hydrate: (isEmpty?: boolean, isSlot?: boolean) => void;
+  hasFallthroughAttrs?: true;
+  constructor(anchorLabel?: string, keyed?: boolean, locate?: boolean, trackSlotBoundary?: boolean);
+  update(render?: BlockFn, key?: any, noScope?: boolean): void;
+  renderBranch(render: BlockFn | undefined, transition: VaporTransitionHooks | undefined, parent: ParentNode | null, key: any, noScope?: boolean): void;
+  hydrate(isEmpty?: boolean, isSlot?: boolean): void;
 }
 interface SlotBoundaryContext {
   parent: SlotBoundaryContext | null;
-  getLocalFallback: () => BlockFn | undefined;
+  getFallback: () => BlockFn | undefined;
+  run<R>(fn: () => R, scope?: EffectScope$1): R;
   markDirty: () => void;
+  redirected?: SlotBoundaryContext;
 }
 export declare function isFragment(val: NonNullable<unknown>): val is VaporFragment;
 //#endregion
@@ -85,25 +94,24 @@ export declare function insert(block: Block, parent: ParentNode & {
 export declare function prepend(parent: ParentNode, ...blocks: Block[]): void;
 export declare function remove(block: Block, parent?: ParentNode): void;
 //#endregion
-//#region temp/packages/runtime-vapor/src/vdomInterop.d.ts
+//#region temp/packages/runtime-vapor/src/vdomInteropState.d.ts
 declare const interopKey: unique symbol;
-export declare const vaporInteropPlugin: Plugin;
 //#endregion
 //#region temp/packages/runtime-vapor/src/componentProps.d.ts
-type RawProps = Record<string, () => unknown> & {
+type RawProps = Record<string, unknown> & {
   $?: DynamicPropsSource[] & {
     [interopKey]?: boolean;
   };
 };
-type DynamicPropsSource = (() => Record<string, unknown>) | Record<string, () => unknown>;
+type DynamicPropsSource = (() => Record<string, unknown>) | Record<string, unknown>;
 //#endregion
 //#region temp/packages/runtime-vapor/src/renderEffect.d.ts
 declare class RenderEffect extends ReactiveEffect {
-  render: () => void;
   i: VaporComponentInstance | null;
   job: SchedulerJob;
-  updateJob: SchedulerJob;
-  constructor(render: () => void);
+  updateJob?: SchedulerJob;
+  render: () => void;
+  constructor(render: () => void, noLifecycle?: boolean);
   fn(): void;
   notify(): void;
 }
@@ -129,7 +137,7 @@ type DynamicSlotSource = StaticSlots | DynamicSlotFn;
 * 2. elements inherit the slot owner's scopeId
 */
 export declare function withVaporCtx(fn: Function): BlockFn;
-export declare function createSlot(name: string | (() => string), rawProps?: LooseRawProps | null, fallback?: VaporSlot, noSlotted?: boolean, once?: boolean): Block;
+export declare function createSlot(name?: string | (() => string), rawProps?: LooseRawProps | null, fallback?: VaporSlot, flags?: number): Block;
 //#endregion
 //#region temp/packages/runtime-vapor/src/apiDefineComponent.d.ts
 export type VaporPublicProps = ReservedProps & AllowedComponentProps & ComponentCustomProps;
@@ -192,7 +200,7 @@ declare class TeleportFragment extends VaporFragment {
   mountContainer?: ParentNode | null;
   mountAnchor?: Node | null;
   private mountToTargetJob?;
-  constructor(props: LooseRawProps, slots?: LooseRawSlots | null);
+  constructor(props: LooseRawProps, slots?: RawSlots | null);
   get parent(): ParentNode | null;
   private initChildren;
   private ensureChildrenInitialized;
@@ -255,12 +263,12 @@ interface SharedInternalOptions {
   */
   __emitsOptions?: ObjectEmitsOptions;
 }
-type LooseRawProps = Record<string, (() => unknown) | DynamicPropsSource[]> & {
+type LooseRawProps = Record<string, unknown> & {
   $?: DynamicPropsSource[];
 };
-type LooseRawSlots = Record<string, VaporSlot | DynamicSlotSource[]> & {
+type LooseRawSlots = VaporSlot | (Record<string, VaporSlot | DynamicSlotSource[]> & {
   $?: DynamicSlotSource[];
-};
+});
 export declare function createComponent(component: VaporComponent, rawProps?: LooseRawProps | null, rawSlots?: LooseRawSlots | null, isSingleRoot?: boolean, once?: boolean, appContext?: GenericAppContext, managedMount?: boolean): VaporComponentInstance;
 export declare class VaporComponentInstance<Props extends Record<string, any> = {}, Emits extends EmitsOptions = {}, Slots extends StaticSlots = StaticSlots, Exposed extends Record<string, any> = Record<string, any>, TypeBlock extends Block = Block, TypeRefs extends Record<string, any> = Record<string, any>> implements GenericComponentInstance {
   vapor: true;
@@ -299,6 +307,7 @@ export declare class VaporComponentInstance<Props extends Record<string, any> =
   shapeFlag?: number;
   $key?: any;
   oncePropsCache?: Record<string | symbol, any>;
+  isOnce: boolean;
   isMounted: boolean;
   isUnmounted: boolean;
   isDeactivated: boolean;
@@ -335,7 +344,7 @@ export declare class VaporComponentInstance<Props extends Record<string, any> =
   * @deprecated only used for JSX to detect props types.
   */
   $props: Props;
-  constructor(comp: VaporComponent, rawProps?: RawProps | null, rawSlots?: RawSlots | null, appContext?: GenericAppContext, once?: boolean);
+  constructor(comp: VaporComponent, rawProps?: RawProps | null, rawSlots?: LooseRawSlots | null, appContext?: GenericAppContext, once?: boolean);
   /**
   * Expose `getKeysFromRawProps` on the instance so it can be used in code
   * paths where it's needed, e.g. `useModel`
@@ -344,6 +353,12 @@ export declare class VaporComponentInstance<Props extends Record<string, any> =
 }
 export declare function isVaporComponent(value: unknown): value is VaporComponentInstance;
 /**
+* Resolve an asset component by name before passing it to the fallback helper;
+* a string passed directly to `createComponentWithFallback` is plain element
+* fallback, not a component name.
+*/
+export declare function createAssetComponent(name: string, rawProps?: LooseRawProps | null, rawSlots?: LooseRawSlots | null, isSingleRoot?: boolean, once?: boolean, maybeSelfReference?: boolean, appContext?: GenericAppContext): HTMLElement | VaporComponentInstance;
+/**
 * Used when a component cannot be resolved at compile time
 * and needs rely on runtime resolution - where it might fallback to a plain
 * element if the resolution fails.
@@ -358,6 +373,9 @@ export declare const createVaporSSRApp: CreateAppFunction<ParentNode, VaporCompo
 //#region temp/packages/runtime-vapor/src/apiDefineAsyncComponent.d.ts
 export declare function defineVaporAsyncComponent<T extends VaporComponent>(source: AsyncComponentLoader<T> | AsyncComponentOptions<T>): T;
 //#endregion
+//#region temp/packages/runtime-vapor/src/vdomInterop.d.ts
+export declare const vaporInteropPlugin: Plugin;
+//#endregion
 //#region temp/packages/runtime-vapor/src/directives/custom.d.ts
 export type VaporDirective = (node: Element | VaporComponentInstance, value?: () => any, argument?: string, modifiers?: DirectiveModifiers) => (() => void) | void;
 type VaporDirectiveArguments = Array<[VaporDirective | undefined] | [VaporDirective | undefined, () => any] | [VaporDirective | undefined, (() => any) | undefined, argument: string] | [VaporDirective | undefined, value: (() => any) | undefined, argument: string | undefined, modifiers: DirectiveModifiers]>;
@@ -431,7 +449,7 @@ export declare function setInsertionState(parent: ParentNode & {
 }, anchor?: Node | 0 | null, logicalIndex?: number): void;
 //#endregion
 //#region temp/packages/runtime-vapor/src/dom/template.d.ts
-export declare function template(html: string, root?: boolean, isStatic?: boolean, ns?: Namespace): () => Node & {
+export declare function template(html: string, flags?: number, ns?: Namespace): () => Node & {
   $root?: true;
 };
 //#endregion
@@ -447,6 +465,7 @@ type TargetElement = Element & {
   $root?: true;
   $html?: string;
   $cls?: string;
+  $clsFlags?: number;
   $sty?: NormalizedStyle | string | undefined;
   value?: string;
   _value?: any;
@@ -454,7 +473,8 @@ type TargetElement = Element & {
 export declare function setProp(el: any, key: string, value: any): void;
 export declare function setAttr(el: any, key: string, value: any, isSVG?: boolean): void;
 export declare function setDOMProp(el: any, key: string, value: any, forceHydrate?: boolean, attrName?: string): void;
-export declare function setClass(el: TargetElement, value: any, isSVG?: boolean): void;
+export declare function setClass(el: TargetElement, value: any, isSVG?: boolean, isNormalized?: boolean): void;
+export declare function setClassName(el: TargetElement, flags: number, cls: string | string[], prefix?: string, suffix?: string): void;
 export declare function setStyle(el: TargetElement, value: any): void;
 export declare function setValue(el: TargetElement, value: any, forceHydrate?: boolean): void;
 /**
@@ -481,16 +501,20 @@ export declare function setBlockHtml(block: Block & {
 export declare function setDynamicProps(el: any, args: any[], isSVG?: boolean): void;
 //#endregion
 //#region temp/packages/runtime-vapor/src/dom/event.d.ts
-export declare function on(el: Element, event: string, handler: (e: Event) => any | ((e: Event) => any)[], options?: AddEventListenerOptions & {
-  effect?: boolean;
-}): void;
-export declare function delegate(el: any, event: string, handler: (e: Event) => any): void;
+type EventHandler = (...args: any[]) => any;
+type EventHandlerValue = EventHandler | EventHandler[];
+type MaybeEventHandlerValue = EventHandlerValue | null | undefined;
+export declare function on(el: Element, event: string, handler: EventHandlerValue, options?: AddEventListenerOptions): void;
+export declare function onBinding(el: Element, event: string, handler: EventHandlerValue, options?: AddEventListenerOptions): void;
+export declare function delegate(el: any, event: string, handler: EventHandler): void;
 export declare const delegateEvents: (...names: string[]) => void;
-export declare function setDynamicEvents(el: HTMLElement, events: Record<string, (...args: any[]) => any>): void;
-export declare function createInvoker(handler: (...args: any[]) => any): (...args: any[]) => any;
+export declare function setDynamicEvents(el: HTMLElement, events: Record<string, EventHandlerValue>): void;
+export declare function withVaporModifiers<T extends (event: Event, ...args: unknown[]) => any>(fn: T | null | undefined, modifiers: string[]): T;
+export declare function withVaporKeys<T extends (event: KeyboardEvent) => any>(fn: T | null | undefined, modifiers: string[]): T;
+export declare function createInvoker(handler: MaybeEventHandlerValue): EventHandler;
 //#endregion
 //#region temp/packages/runtime-vapor/src/apiCreateIf.d.ts
-export declare function createIf(condition: () => any, b1: BlockFn, b2?: BlockFn, blockShape?: number, once?: boolean, index?: number): Block;
+export declare function createIf(condition: () => any, b1: BlockFn, b2?: BlockFn, flags?: number): Block;
 //#endregion
 //#region temp/packages/runtime-vapor/src/apiCreateFragment.d.ts
 /**
@@ -507,9 +531,29 @@ export declare function createKeyedFragment(key: () => any, render: BlockFn): Bl
 //#endregion
 //#region temp/packages/runtime-vapor/src/apiCreateFor.d.ts
 type Source = any[] | Record<any, any> | number | Set<any> | Map<any, any>;
-export declare const createFor: (src: () => Source, renderItem: (item: ShallowRef<any>, key: ShallowRef<any>, index: ShallowRef<number | undefined>) => Block, getKey?: (item: any, key: any, index?: number) => any, flags?: number, setup?: (_: {
-  createSelector: (source: () => any) => (cb: () => void) => void;
-}) => void) => ForFragment;
+export declare const createFor: (src: () => Source, renderItem: (item: ShallowRef<any>, key: ShallowRef<any>, index: ShallowRef<number | undefined>) => Block, getKey?: (item: any, key: any, index?: number) => any, flags?: number) => ForFragment;
+interface ForSelector {
+  (key: any, oper: () => void): void;
+  /**
+  * Bulk-reset the selector's internal state. Hook into a v-for's fast-reset
+  * paths via `forFragment.onReset(selector.reset)` so the lazy per-item
+  * `onScopeDispose` teardowns short-circuit instead of doing N individual
+  * Map.delete() calls.
+  */
+  reset(): void;
+}
+/**
+* Builds a key-indexed selector that activates only the opers registered with
+* the key matching the current source value. Compared to letting each item
+* subscribe directly, this keeps re-renders on source change O(2) instead of
+* O(N) (only previous and new active item re-run).
+*
+* Selector cleanup follows the current scope. Per-item teardown is auto-wired
+* via `onScopeDispose` so callers (typically v-for item scopes) don't need
+* explicit deregistration. For bulk-reset hot paths, attach the selector to
+* the v-for via `frag.onReset(selector.reset)` to skip the per-item Map ops.
+*/
+export declare function createSelector(source: () => any): ForSelector;
 export declare function createForSlots(rawSource: Source, getSlot: (item: any, key: any, index?: number) => DynamicSlot): DynamicSlot[];
 export declare function getRestElement(val: any, keys: string[]): any;
 export declare function getDefaultValue(val: any, defaultVal: any): any;
@@ -523,7 +567,7 @@ export declare function setBlockKey(block: (Block & {
 }) | null | undefined, key: any): void;
 //#endregion
 //#region temp/packages/runtime-vapor/src/apiCreateDynamicComponent.d.ts
-export declare function createDynamicComponent(getter: () => any, rawProps?: RawProps | null, rawSlots?: RawSlots | null, isSingleRoot?: boolean, once?: boolean): VaporFragment;
+export declare function createDynamicComponent(getter: () => any, rawProps?: RawProps | null, rawSlots?: LooseRawSlots | null, isSingleRoot?: boolean, once?: boolean): VaporFragment;
 //#endregion
 //#region temp/packages/runtime-vapor/src/apiSetupHelpers.d.ts
 export declare function withAsyncContext(getAwaitable: () => any): [any, () => void];