@vue/runtime-vapor 3.6.0-alpha.3 → 3.6.0-alpha.5

package/dist/runtime-vapor.d.ts

@@ -1,10 +1,10 @@
-import { VNode, TransitionHooks, TransitionState, TransitionProps, Plugin, SchedulerJob, GenericComponentInstance, GenericAppContext, EffectScope as EffectScope$1, EmitFn, SuspenseBoundary, LifecycleHook, NormalizedPropsOptions, ObjectEmitsOptions, ComponentInternalOptions, AsyncComponentInternalOptions, ComponentPropsOptions, EmitsOptions, CreateAppFunction, AsyncComponentLoader, AsyncComponentOptions, DirectiveModifiers } from '@vue/runtime-dom';
+import { VNode, TransitionHooks, TransitionState, TransitionProps, Plugin, SchedulerJob, GenericComponentInstance, GenericAppContext, EffectScope as EffectScope$1, EmitFn, SuspenseBoundary, LifecycleHook, NormalizedPropsOptions, ObjectEmitsOptions, ComponentInternalOptions, AsyncComponentInternalOptions, ComponentPropsOptions, EmitsOptions, CreateAppFunction, AsyncComponentLoader, AsyncComponentOptions, DirectiveModifiers, VueElementBase, CustomElementOptions } from '@vue/runtime-dom';
 import { Ref, EffectScope, ReactiveEffect, ShallowRef } from '@vue/reactivity';
-import { NormalizedStyle } from '@vue/shared';
+import { Namespace, NormalizedStyle } from '@vue/shared';
 
 type NodeRef = string | Ref | ((ref: Element | VaporComponentInstance, refs: Record<string, any>) => void);
 type RefEl = Element | VaporComponentInstance;
-type setRefFn = (el: RefEl, ref: NodeRef, oldRef?: NodeRef, refFor?: boolean) => NodeRef | undefined;
+type setRefFn = (el: RefEl, ref: NodeRef, oldRef?: NodeRef, refFor?: boolean, refKey?: string) => NodeRef | undefined;
 export declare function createTemplateRefSetter(): setRefFn;
 
 export declare class VaporFragment<T extends Block = Block> implements TransitionOptions {
@@ -18,6 +18,7 @@ export declare class VaporFragment<T extends Block = Block> implements Transitio
     remove?: (parent?: ParentNode, transitionHooks?: TransitionHooks) => void;
     hydrate?: (...args: any[]) => void;
     setRef?: (instance: VaporComponentInstance, ref: NodeRef, refFor: boolean, refKey: string | undefined) => void;
+    updated?: ((nodes?: Block) => void)[];
     constructor(nodes: T);
 }
 declare class ForFragment extends VaporFragment<Block[]> {
@@ -29,8 +30,9 @@ declare class DynamicFragment extends VaporFragment {
     current?: BlockFn;
     fallback?: BlockFn;
     anchorLabel?: string;
-    inKeepAlive?: boolean;
-    keptAliveScopes?: Map<any, EffectScope>;
+    getScope?: (key: any) => EffectScope | undefined;
+    beforeTeardown?: ((oldKey: any, nodes: Block, scope: EffectScope) => boolean)[];
+    beforeMount?: ((newKey: any, nodes: Block, scope: EffectScope) => void)[];
     constructor(anchorLabel?: string);
     update(render?: BlockFn, key?: any): void;
     private render;
@@ -43,6 +45,7 @@ interface VaporTransitionHooks extends TransitionHooks {
     props: TransitionProps;
     instance: VaporComponentInstance;
     disabled?: boolean;
+    group?: boolean;
 }
 interface TransitionOptions {
     $key?: any;
@@ -90,18 +93,9 @@ type DynamicSlot = {
 type DynamicSlotFn = () => DynamicSlot | DynamicSlot[];
 type DynamicSlotSource = StaticSlots | DynamicSlotFn;
 /**
- * Wraps a slot function to execute in the parent component's context.
- *
- * This ensures that:
- * 1. Reactive effects created inside the slot (e.g., `renderEffect`) bind to the
- *    parent's instance, so the parent's lifecycle hooks fire when the slot's
- *    reactive dependencies change.
- * 2. Elements created in the slot inherit the parent's scopeId for proper style
- *    scoping in scoped CSS.
- *
- * **Rationale**: Slots are defined in the parent's template, so the parent should
- * own the rendering context and be aware of updates.
- *
+ * Wrap a slot function to memoize currentInstance
+ * 1. ensure correct currentInstance in forwarded slots
+ * 2. elements created in the slot 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): Block;
@@ -117,12 +111,14 @@ declare class TeleportFragment extends VaporFragment {
     private rawProps?;
     private resolvedProps?;
     private rawSlots?;
+    isDisabled?: boolean;
     target?: ParentNode | null;
     targetAnchor?: Node | null;
     targetStart?: Node | null;
     placeholder?: Node;
     mountContainer?: ParentNode | null;
     mountAnchor?: Node | null;
+    parentComponent: GenericComponentInstance;
     constructor(props: LooseRawProps, slots: LooseRawSlots);
     get parent(): ParentNode | null;
     private initChildren;
@@ -187,6 +183,7 @@ declare class VaporComponentInstance implements GenericComponentInstance {
     attrs: Record<string, any>;
     propsDefaults: Record<string, any> | null;
     slots: StaticSlots;
+    scopeId?: string | null;
     rawPropsRef?: ShallowRef<any>;
     rawSlotsRef?: ShallowRef<any>;
     emit: EmitFn;
@@ -198,7 +195,9 @@ declare class VaporComponentInstance implements GenericComponentInstance {
     provides: Record<string, any>;
     ids: [string, number, number];
     suspense: SuspenseBoundary | null;
+    renderEffects?: RenderEffect[];
     hasFallthrough: boolean;
+    shapeFlag?: number;
     isMounted: boolean;
     isUnmounted: boolean;
     isDeactivated: boolean;
@@ -221,13 +220,11 @@ declare class VaporComponentInstance implements GenericComponentInstance {
     devtoolsRawSetupState?: any;
     hmrRerender?: () => void;
     hmrReload?: (newComp: VaporComponent) => void;
-    renderEffects?: RenderEffect[];
     parentTeleport?: TeleportFragment | null;
     propsOptions?: NormalizedPropsOptions;
     emitsOptions?: ObjectEmitsOptions | null;
     isSingleRoot?: boolean;
-    shapeFlag?: number;
-    constructor(comp: VaporComponent, rawProps?: RawProps | null, rawSlots?: RawSlots | null, appContext?: GenericAppContext, once?: boolean);
+    constructor(comp: VaporComponent, rawProps?: RawProps | null, rawSlots?: RawSlots | null, appContext?: GenericAppContext, once?: boolean, parent?: GenericComponentInstance | null);
     /**
      * Expose `getKeysFromRawProps` on the instance so it can be used in code
      * paths where it's needed, e.g. `useModel`
@@ -241,6 +238,7 @@ export declare function isVaporComponent(value: unknown): value is VaporComponen
  * element if the resolution fails.
  */
 export declare function createComponentWithFallback(comp: VaporComponent | string, rawProps?: LooseRawProps | null, rawSlots?: LooseRawSlots | null, isSingleRoot?: boolean, once?: boolean, appContext?: GenericAppContext): HTMLElement | VaporComponentInstance;
+export declare function createPlainElement(comp: string, rawProps?: LooseRawProps | null, rawSlots?: LooseRawSlots | null, isSingleRoot?: boolean, once?: boolean): HTMLElement;
 
 export declare const createVaporApp: CreateAppFunction<ParentNode, VaporComponent>;
 export declare const createVaporSSRApp: CreateAppFunction<ParentNode, VaporComponent>;
@@ -261,6 +259,29 @@ export declare function withVaporDirectives(node: Element | VaporComponentInstan
 
 export declare const VaporKeepAliveImpl: ObjectVaporComponent;
 
+type VaporElementConstructor<P = {}> = {
+    new (initialProps?: Record<string, any>): VaporElement & P;
+};
+export declare function defineVaporCustomElement(options: any, extraOptions?: Omit<ObjectVaporComponent, 'setup'>, 
+/**
+ * @internal
+ */
+_createApp?: CreateAppFunction<ParentNode, VaporComponent>): VaporElementConstructor;
+export declare const defineVaporSSRCustomElement: typeof defineVaporCustomElement;
+type VaporInnerComponentDef = VaporComponent & CustomElementOptions;
+declare class VaporElement extends VueElementBase<ParentNode, VaporComponent, VaporInnerComponentDef> {
+    constructor(def: VaporInnerComponentDef, props?: Record<string, any> | undefined, createAppFn?: CreateAppFunction<ParentNode, VaporComponent>);
+    protected _needsHydration(): boolean;
+    protected _mount(def: VaporInnerComponentDef): void;
+    protected _update(): void;
+    protected _unmount(): void;
+    /**
+     * Only called when shadowRoot is false
+     */
+    protected _updateSlotNodes(replacements: Map<Node, Node[]>): void;
+    private _createComponent;
+}
+
 type InsertionParent = ParentNode & {
     $fc?: Node | null;
     $llc?: Node | null;
@@ -278,7 +299,7 @@ export declare function setInsertionState(parent: ParentNode & {
 }, anchor?: Node | 0 | null | number, last?: boolean): void;
 
 /*! #__NO_SIDE_EFFECTS__ */
-export declare function template(html: string, root?: boolean): () => Node & {
+export declare function template(html: string, root?: boolean, ns?: Namespace): () => Node & {
     $root?: true;
 };
 
@@ -304,9 +325,9 @@ type TargetElement = Element & {
     _value?: any;
 };
 export declare function setProp(el: any, key: string, value: any): void;
-export declare function setAttr(el: any, key: string, value: any): void;
-export declare function setDOMProp(el: any, key: string, value: any, forceHydrate?: boolean): void;
-export declare function setClass(el: TargetElement, 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 setStyle(el: TargetElement, value: any): void;
 export declare function setValue(el: TargetElement, value: any, forceHydrate?: boolean): void;
 /**
@@ -330,7 +351,7 @@ export declare function setHtml(el: TargetElement, value: any): void;
 export declare function setBlockHtml(block: Block & {
     $html?: string;
 }, value: any): void;
-export declare function setDynamicProps(el: any, args: any[]): void;
+export declare function setDynamicProps(el: any, args: any[], isSVG?: boolean): void;
 
 export declare function on(el: Element, event: string, handler: (e: Event) => any, options?: AddEventListenerOptions & {
     effect?: boolean;
@@ -338,6 +359,7 @@ export declare function on(el: Element, event: string, handler: (e: Event) => an
 export declare function delegate(el: any, event: string, handler: (e: Event) => any): 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 createIf(condition: () => any, b1: BlockFn, b2?: BlockFn, once?: boolean): Block;
 
@@ -351,6 +373,8 @@ export declare function createForSlots(rawSource: Source, getSlot: (item: any, k
 export declare function getRestElement(val: any, keys: string[]): any;
 export declare function getDefaultValue(val: any, defaultVal: any): any;
 
+export declare function useVaporCssVars(getter: () => Record<string, string>): void;
+
 export declare function createDynamicComponent(getter: () => any, rawProps?: RawProps | null, rawSlots?: RawSlots | null, isSingleRoot?: boolean, once?: boolean): VaporFragment;
 
 export declare function applyVShow(target: Block, source: () => any): void;