@qwik.dev/core 2.0.0-beta.13 → 2.0.0-beta.15

package/dist/core-internal.d.ts

@@ -89,20 +89,12 @@ declare interface AddRootFn {
 
 declare type AllEventKeys = keyof AllEventsMap;
 
-declare type AllEventMapRaw = HTMLElementEventMap & DocumentEventMap & WindowEventHandlersEventMap & {
-    qidle: QwikIdleEvent;
-    qinit: QwikInitEvent;
-    qsymbol: QwikSymbolEvent;
-    qvisible: QwikVisibleEvent;
-    qviewtransition: QwikViewTransitionEvent;
-};
+declare type AllEventMapRaw = QwikHTMLElementEventMap & QwikDocumentEventMap & QwikWindowEventMap;
 
 declare type AllEventsMap = Omit<AllEventMapRaw, keyof EventCorrectionMap> & EventCorrectionMap;
 
 declare type _AllowPlainQrl<Q> = QRLEventHandlerMulti<any, any> extends Q ? Q extends QRLEventHandlerMulti<infer EV, infer EL> ? Q | (EL extends Element ? EventHandler<EV, EL> : never) : Q : Q extends QRL<infer U> ? Q | U : NonNullable<Q> extends never ? Q : QRL<Q> | Q;
 
-declare type AllPascalEventMaps = PascalMap<AllEventsMap>;
-
 declare type AllSignalFlags = SignalFlags | WrappedSignalFlags | SerializationSignalFlags;
 
 /**
@@ -375,7 +367,8 @@ export declare interface AsyncComputedReadonlySignal<T = unknown> extends Comput
     loading: boolean;
     /** The error that occurred while computing the signal. */
     error: Error | null;
-    resolve(): Promise<T>;
+    /** A promise that resolves when the value is computed. */
+    promise(): Promise<T>;
 }
 
 /** @public */
@@ -388,14 +381,15 @@ export declare type AsyncComputedReturnType<T> = T extends Promise<infer T> ? As
  *
  * # ================================
  */
-declare class AsyncComputedSignalImpl<T> extends ComputedSignalImpl<T, AsyncComputeQRL<T>> implements BackRef {
+declare class AsyncComputedSignalImpl<T> extends ComputedSignalImpl<T | undefined, AsyncComputeQRL<T>> implements BackRef {
     $untrackedLoading$: boolean;
-    $untrackedError$: Error | null;
-    $loadingEffects$: null | Set<EffectSubscription>;
-    $errorEffects$: null | Set<EffectSubscription>;
+    $untrackedError$: Error | undefined;
+    $loadingEffects$: undefined | Set<EffectSubscription>;
+    $errorEffects$: undefined | Set<EffectSubscription>;
     $destroy$: NoSerialize<() => void> | null;
-    private $promiseValue$;
-    [_EFFECT_BACK_REF]: Map<EffectProperty | string, EffectSubscription> | null;
+    $promiseValue$: T | typeof NEEDS_COMPUTATION;
+    private $promise$;
+    [_EFFECT_BACK_REF]: Map<EffectProperty | string, EffectSubscription> | undefined;
     constructor(container: Container | null, fn: AsyncComputeQRL<T>, flags?: SignalFlags | SerializationSignalFlags);
     /**
      * Loading is true if the signal is still waiting for the promise to resolve, false if the promise
@@ -405,12 +399,14 @@ declare class AsyncComputedSignalImpl<T> extends ComputedSignalImpl<T, AsyncComp
     set untrackedLoading(value: boolean);
     get untrackedLoading(): boolean;
     /** The error that occurred when the signal was resolved. */
-    get error(): Error | null;
-    set untrackedError(value: Error | null);
-    get untrackedError(): Error | null;
+    get error(): Error | undefined;
+    set untrackedError(value: Error | undefined);
+    get untrackedError(): Error | undefined;
     invalidate(): void;
-    resolve(): Promise<T>;
-    $computeIfNeeded$(): boolean | undefined;
+    promise(): Promise<T>;
+    $computeIfNeeded$(): Promise<void> | undefined;
+    private $promiseComputation$;
+    private setValue;
 }
 
 declare type AsyncComputeQRL<T> = QRLInternal<AsyncComputedFn<T>>;
@@ -425,7 +421,7 @@ declare type Augmented<E, A = {}> = Prettify<Filtered<E, A> & A>;
 
 /** Class for back reference to the EffectSubscription */
 declare abstract class BackRef {
-    [_EFFECT_BACK_REF]: Map<EffectProperty | string, EffectSubscription> | null;
+    [_EFFECT_BACK_REF]: Map<EffectProperty | string, EffectSubscription> | undefined;
 }
 
 declare type BivariantQrlFn<ARGS extends any[], RETURN> = {
@@ -659,7 +655,7 @@ declare class ComputedSignalImpl<T, S extends QRLInternal = ComputeQRL<T>> exten
      */
     $computeQrl$: S;
     $flags$: SignalFlags | SerializationSignalFlags;
-    [_EFFECT_BACK_REF]: Map<EffectProperty | string, EffectSubscription> | null;
+    [_EFFECT_BACK_REF]: Map<EffectProperty | string, EffectSubscription> | undefined;
     constructor(container: Container | null, fn: S, flags?: SignalFlags | SerializationSignalFlags);
     invalidate(): void;
     /**
@@ -954,10 +950,10 @@ export declare const createComputedQrl: <T>(qrl: QRL<() => T>, options?: Compute
  */
 export declare const createContextId: <STATE = unknown>(name: string) => ContextId<STATE>;
 
-declare const createScheduler: (container: Container, journalFlush: () => void, choreQueue: ChoreArray, blockedChores: Set<Chore>, runningChores: Set<Chore>) => {
+declare const createScheduler: (container: Container, journalFlush: () => void, choreQueue: ChoreArray, blockedChores: ChoreArray, runningChores: Set<Chore>) => {
     (type: ChoreType.QRL_RESOLVE, ignore: null, target: ComputeQRL<any> | AsyncComputeQRL<any>): Chore<ChoreType.QRL_RESOLVE>;
     (type: ChoreType.WAIT_FOR_QUEUE): Chore<ChoreType.WAIT_FOR_QUEUE>;
-    (type: ChoreType.RECOMPUTE_AND_SCHEDULE_EFFECTS, host: HostElement | null, target: Signal<unknown> | StoreTarget, effects: Set<EffectSubscription> | null): Chore<ChoreType.RECOMPUTE_AND_SCHEDULE_EFFECTS>;
+    (type: ChoreType.RECOMPUTE_AND_SCHEDULE_EFFECTS, host: HostElement | undefined, target: Signal<unknown> | StoreTarget, effects: Set<EffectSubscription> | undefined): Chore<ChoreType.RECOMPUTE_AND_SCHEDULE_EFFECTS>;
     (type: ChoreType.TASK | ChoreType.VISIBLE, task: Task): Chore<ChoreType.TASK | ChoreType.VISIBLE>;
     (type: ChoreType.RUN_QRL, host: HostElement, target: QRLInternal<(...args: unknown[]) => unknown>, args: unknown[]): Chore<ChoreType.RUN_QRL>;
     (type: ChoreType.COMPONENT, host: HostElement, qrl: QRLInternal<OnRenderFn<unknown>>, props: Props | null): Chore<ChoreType.COMPONENT>;
@@ -1004,7 +1000,6 @@ export declare interface CSSProperties extends CSS_2.Properties<string | number>
     [v: `--${string}`]: string | number | undefined;
 }
 
-/** @public */
 declare interface DescriptorBase<T = unknown, B = unknown> extends BackRef {
     $flags$: number;
     $index$: number;
@@ -1171,11 +1166,10 @@ export declare const event$: <T>(qrl: T) => QRL_2<T>;
 
 declare type EventCorrectionMap = {
     auxclick: PointerEvent;
-    beforetoggle: CorrectedToggleEvent;
     click: PointerEvent;
     dblclick: PointerEvent;
     input: InputEvent;
-    toggle: CorrectedToggleEvent;
+    qvisible: QwikVisibleEvent;
 };
 
 declare type EventFromName<T extends string> = LcEvent<T>;
@@ -1576,6 +1570,14 @@ declare interface JsxDevOpts {
     columnNumber: number;
 }
 
+declare type JSXDocumentEvents = {
+    [K in keyof QwikDocumentEventMap as `document:on${PascalCaseName<K>}$`]: QwikDocumentEventMap[K];
+};
+
+declare type JSXElementEvents = {
+    [K in keyof QwikHTMLElementEventMap as `on${PascalCaseName<K>}$`]: QwikHTMLElementEventMap[K];
+};
+
 /**
  * A JSX Node, an internal structure. You probably want to use `JSXOutput` instead.
  *
@@ -1589,6 +1591,21 @@ export declare interface JSXNode<T extends string | FunctionComponent | unknown
     dev?: DevJSX;
 }
 
+declare class JSXNodeImpl<T = unknown> implements JSXNodeInternal<T> {
+    type: T;
+    toSort: boolean;
+    key: string | null;
+    varProps: Props;
+    constProps: Props | null;
+    children: JSXChildren;
+    dev?: DevJSX & {
+        stack: string | undefined;
+    };
+    _proxy: Props | null;
+    constructor(type: T, varProps?: Props | null, constProps?: Props | null, children?: JSXChildren, key?: string | number | null, toSort?: boolean, dev?: DevJSX);
+    get props(): T extends FunctionComponent<infer PROPS> ? PROPS : Props;
+}
+
 /**
  * The internal representation of a JSX Node.
  *
@@ -1688,6 +1705,10 @@ export declare const _jsxSplit: <T extends string | FunctionComponent<any>>(type
 /** @public */
 export declare type JSXTagName = keyof HTMLElementTagNameMap | Omit<string, keyof HTMLElementTagNameMap>;
 
+declare type JSXWindowEvents = {
+    [K in keyof QwikWindowEventMap as `window:on${PascalCaseName<K>}$`]: QwikWindowEventMap[K];
+};
+
 /**
  * The names of events that Qwik knows about. They are all lowercase, but on the JSX side, they are
  * PascalCase for nicer DX. (`onAuxClick$` vs `onauxclick$`)
@@ -1788,6 +1809,12 @@ export declare type NativeUIEvent = UIEvent;
 /** @public @deprecated Use `WheelEvent` and use the second argument to the handler function for the current event target */
 export declare type NativeWheelEvent = WheelEvent;
 
+/**
+ * Special value used to mark that a given signal needs to be computed. This is essentially a
+ * "marked as dirty" flag.
+ */
+declare const NEEDS_COMPUTATION: any;
+
 declare interface NodePropData {
     $scopedStyleIdPrefix$: string | null;
     $isConst$: boolean;
@@ -1867,6 +1894,8 @@ export declare interface OnVisibleTaskOptions {
 /** @internal */
 declare const _OWNER: unique symbol;
 
+declare type PascalCaseName<T extends string> = T extends keyof LcEventNameMap ? LcEventNameMap[T] : Capitalize<T>;
+
 /**
  * Capitalized multi-word names of some known events so we have nicer qwik attributes. For example,
  * instead of `oncompositionEnd$` we can use `onCompositionEnd$`. Note that any capitalization
@@ -1874,15 +1903,7 @@ declare const _OWNER: unique symbol;
  *
  * Add any multi-word event names to this list. Single word events are automatically converted.
  */
-declare type PascalCaseNames = 'AnimationEnd' | 'AnimationIteration' | 'AnimationStart' | 'AuxClick' | 'BeforeToggle' | 'CanPlay' | 'CanPlayThrough' | 'CompositionEnd' | 'CompositionStart' | 'CompositionUpdate' | 'ContextMenu' | 'DblClick' | 'DragEnd' | 'DragEnter' | 'DragExit' | 'DragLeave' | 'DragOver' | 'DragStart' | 'DurationChange' | 'FocusIn' | 'FocusOut' | 'FullscreenChange' | 'FullscreenError' | 'GotPointerCapture' | 'KeyDown' | 'KeyPress' | 'KeyUp' | 'LoadedData' | 'LoadedMetadata' | 'LoadEnd' | 'LoadStart' | 'LostPointerCapture' | 'MouseDown' | 'MouseEnter' | 'MouseLeave' | 'MouseMove' | 'MouseOut' | 'MouseOver' | 'MouseUp' | 'PointerCancel' | 'PointerDown' | 'PointerEnter' | 'PointerLeave' | 'PointerMove' | 'PointerOut' | 'PointerOver' | 'PointerUp' | 'QIdle' | 'QInit' | 'QSymbol' | 'QVisible' | 'RateChange' | 'RateChange' | 'SecurityPolicyViolation' | 'SelectionChange' | 'SelectStart' | 'TimeUpdate' | 'TouchCancel' | 'TouchEnd' | 'TouchMove' | 'TouchStart' | 'TransitionCancel' | 'TransitionEnd' | 'TransitionRun' | 'TransitionStart' | 'VisibilityChange' | 'VolumeChange';
-
-/**
- * Convert an event map to PascalCase. For example, `HTMLElementEventMap` contains lowercase keys,
- * so this will capitalize them, and use the `LcEventNameMap` for multi-word events names.
- */
-declare type PascalMap<M> = {
-    [K in Extract<keyof M, string> as K extends keyof LcEventNameMap ? LcEventNameMap[K] : Capitalize<K>]: M[K];
-};
+declare type PascalCaseNames = 'AnimationEnd' | 'AnimationIteration' | 'AnimationStart' | 'AuxClick' | 'BeforeToggle' | 'CanPlay' | 'CanPlayThrough' | 'CompositionEnd' | 'CompositionStart' | 'CompositionUpdate' | 'ContextMenu' | 'DblClick' | 'DragEnd' | 'DragEnter' | 'DragExit' | 'DragLeave' | 'DragOver' | 'DragStart' | 'DurationChange' | 'FocusIn' | 'FocusOut' | 'FullscreenChange' | 'FullscreenError' | 'GotPointerCapture' | 'KeyDown' | 'KeyPress' | 'KeyUp' | 'LoadedData' | 'LoadedMetadata' | 'LoadEnd' | 'LoadStart' | 'LostPointerCapture' | 'MouseDown' | 'MouseEnter' | 'MouseLeave' | 'MouseMove' | 'MouseOut' | 'MouseOver' | 'MouseUp' | 'PointerCancel' | 'PointerDown' | 'PointerEnter' | 'PointerLeave' | 'PointerMove' | 'PointerOut' | 'PointerOver' | 'PointerUp' | 'QIdle' | 'QInit' | 'QResume' | 'QSymbol' | 'QVisible' | 'QViewTransition' | 'RateChange' | 'RateChange' | 'SecurityPolicyViolation' | 'SelectionChange' | 'SelectStart' | 'TimeUpdate' | 'TouchCancel' | 'TouchEnd' | 'TouchMove' | 'TouchStart' | 'TransitionCancel' | 'TransitionEnd' | 'TransitionRun' | 'TransitionStart' | 'VisibilityChange' | 'VolumeChange';
 
 declare type PopoverTargetAction = 'hide' | 'show' | 'toggle';
 
@@ -1984,6 +2005,9 @@ export declare type PropFunction<T> = QRL<T>;
 
 declare type Props = Record<string, unknown>;
 
+/** @internal */
+declare const _PROPS_HANDLER: unique symbol;
+
 /**
  * Infers `Props` from the component or tag.
  *
@@ -2007,7 +2031,21 @@ declare type PropsProxy = {
     [_VAR_PROPS]: Props;
     [_CONST_PROPS]: Props | null;
     [_OWNER]: JSXNodeInternal;
-};
+    [_PROPS_HANDLER]: PropsProxyHandler;
+} & Record<string | symbol, unknown>;
+
+declare class PropsProxyHandler implements ProxyHandler<any> {
+    owner: JSXNodeImpl;
+    $effects$: undefined | Map<string | symbol, Set<EffectSubscription>>;
+    $container$: Container | null;
+    constructor(owner: JSXNodeImpl);
+    get(_: any, prop: string | symbol): any;
+    set(_: any, prop: string | symbol, value: any): boolean;
+    deleteProperty(_: any, prop: string | symbol): boolean;
+    has(_: any, prop: string | symbol): boolean;
+    getOwnPropertyDescriptor(_: any, p: string | symbol): PropertyDescriptor | undefined;
+    ownKeys(): string[];
+}
 
 declare type PropType<T extends object, P extends keyof T> = P extends keyof T ? T[P] : 'value' extends keyof T ? T['value'] : never;
 
@@ -2025,7 +2063,7 @@ export declare interface _QDocument extends Document {
 }
 
 declare interface QElement extends Element {
-    qDispatchEvent?: (event: Event, scope: QwikLoaderEventScope) => boolean;
+    qDispatchEvent?: (event: Event, scope: QwikLoaderEventScope) => ValueOrPromise<unknown>;
     vNode?: _VNode;
 }
 
@@ -2161,7 +2199,7 @@ export declare type QRL<TYPE = unknown> = {
     getCaptured(): unknown[] | null;
     getSymbol(): string;
     getHash(): string;
-    dev: QRLDev | null;
+    dev?: QRLDev | null;
 } & BivariantQrlFn<QrlArgs<TYPE>, QrlReturn<TYPE>>;
 
 /**
@@ -2195,7 +2233,7 @@ export declare const qrlDEV: <T = any>(chunkOrFn: string | (() => Promise<any>),
  *
  * @public
  */
-export declare type QRLEventHandlerMulti<EV extends Event, EL> = QRL<EventHandler<EV, EL>> | undefined | null | QRLEventHandlerMulti<EV, EL>[] | EventHandler<EV, EL>;
+export declare type QRLEventHandlerMulti<EV extends Event, EL> = QRL<EventHandler<EV, EL>> | undefined | null | QRLEventHandlerMulti<EV, EL>[];
 
 declare type QRLInternal<TYPE = unknown> = QRL<TYPE> & QRLInternalMethods<TYPE>;
 
@@ -2282,13 +2320,19 @@ export declare type QwikClipboardEvent<T = Element> = NativeClipboardEvent;
 /** @public @deprecated Use `CompositionEvent` and use the second argument to the handler function for the current event target */
 export declare type QwikCompositionEvent<T = Element> = NativeCompositionEvent;
 
-declare type QwikCustomEvents<EL> = {};
-
 declare type QwikCustomEventsPlain<EL> = {
     /** The handler */
     [key: `${'document:' | 'window:' | ''}on${string}$`]: QRLEventHandlerMulti<Event, EL> | EventHandler<Event, EL>;
 };
 
+declare type QwikDocumentEventMap = Omit<DocumentEventMap, keyof QwikHTMLElementEventMap> & Omit<QwikHTMLElementEventMap, 'qvisible' | 'focus' | 'blur'> & {
+    qidle: QwikIdleEvent;
+    qinit: QwikInitEvent;
+    qsymbol: QwikSymbolEvent;
+    qresume: QwikResumeEvent;
+    qviewtransition: QwikViewTransitionEvent;
+};
+
 /** @public */
 export declare interface QwikDOMAttributes extends DOMAttributes<Element> {
 }
@@ -2297,11 +2341,13 @@ export declare interface QwikDOMAttributes extends DOMAttributes<Element> {
 export declare type QwikDragEvent<T = Element> = NativeDragEvent;
 
 /** @public */
-declare type QwikEvents<EL, Plain extends boolean = true> = Plain extends true ? QwikKnownEventsPlain<EL> & QwikCustomEventsPlain<EL> : QwikKnownEvents<EL> & QwikCustomEvents<EL>;
+declare type QwikEvents<EL, Plain extends boolean = true> = Plain extends true ? QwikKnownEventsPlain<EL> & QwikCustomEventsPlain<EL> : QwikKnownEvents<EL>;
 
 /** @public @deprecated Use `FocusEvent` and use the second argument to the handler function for the current event target */
 export declare type QwikFocusEvent<T = Element> = NativeFocusEvent;
 
+declare type QwikHTMLElementEventMap = Omit<HTMLElementEventMap, keyof EventCorrectionMap> & EventCorrectionMap;
+
 /**
  * The DOM props without plain handlers, for use inside functions
  *
@@ -2372,15 +2418,17 @@ declare namespace QwikJSX {
 export { QwikJSX as JSX }
 export { QwikJSX }
 
+declare type QwikJSXEvents = JSXElementEvents & JSXDocumentEvents & JSXWindowEvents;
+
 /** @public @deprecated Use `KeyboardEvent` and use the second argument to the handler function for the current event target */
 export declare type QwikKeyboardEvent<T = Element> = NativeKeyboardEvent;
 
 declare type QwikKnownEvents<EL> = {
-    [K in keyof AllPascalEventMaps as `${'document:' | 'window:' | ''}on${K}$`]?: QRLEventHandlerMulti<AllPascalEventMaps[K], EL>;
+    [K in keyof QwikJSXEvents]?: QRLEventHandlerMulti<QwikJSXEvents[K], EL>;
 };
 
 declare type QwikKnownEventsPlain<EL> = {
-    [K in keyof AllPascalEventMaps as `${'document:' | 'window:' | ''}on${K}$`]?: QRLEventHandlerMulti<AllPascalEventMaps[K], EL> | EventHandler<AllPascalEventMaps[K], EL>;
+    [K in keyof QwikJSXEvents]?: QRLEventHandlerMulti<QwikJSXEvents[K], EL> | EventHandler<QwikJSXEvents[K], EL>;
 };
 
 declare type QwikLoaderEventScope = '-document' | '-window' | '';
@@ -2446,6 +2494,12 @@ export declare type QwikMouseEvent<T = Element, E = NativeMouseEvent> = E;
 /** @public @deprecated Use `PointerEvent` and use the second argument to the handler function for the current event target */
 export declare type QwikPointerEvent<T = Element> = NativePointerEvent;
 
+/**
+ * Emitted by qwik-core on the container element when it resumes from a paused state. You cannot put
+ * a Qwik event handler on the container so you must listen on the document instead. @public
+ */
+export declare type QwikResumeEvent = CustomEvent<{}>;
+
 /** @public @deprecated Use `SubmitEvent` and use the second argument to the handler function for the current event target */
 export declare type QwikSubmitEvent<T = Element> = SubmitEvent;
 
@@ -2476,7 +2530,7 @@ declare interface QwikSymbol {
     captureNames?: string[];
 }
 
-/** Emitted by qwik-loader when a module was lazily loaded @public */
+/** Emitted by qwik-loader on document when a module was lazily loaded @public */
 export declare type QwikSymbolEvent = CustomEvent<{
     symbol: string;
     element: Element;
@@ -2497,14 +2551,19 @@ export declare type QwikTransitionEvent<T = Element> = NativeTransitionEvent;
 export declare type QwikUIEvent<T = Element> = NativeUIEvent;
 
 /** Emitted by qwik-core on document when the a view transition start @public */
-declare type QwikViewTransitionEvent = CustomEvent<ViewTransition>;
+export declare type QwikViewTransitionEvent = CustomEvent<ViewTransition>;
 
-/** Emitted by qwik-loader when an element becomes visible. Used by `useVisibleTask$` @public */
+/**
+ * Handled by qwik-loader when an element becomes visible. Used by `useVisibleTask$`. Does not
+ * bubble. @public
+ */
 export declare type QwikVisibleEvent = CustomEvent<IntersectionObserverEntry>;
 
 /** @public @deprecated Use `WheelEvent` and use the second argument to the handler function for the current event target */
 export declare type QwikWheelEvent<T = Element> = NativeWheelEvent;
 
+declare type QwikWindowEventMap = Omit<WindowEventHandlersEventMap, keyof QwikDocumentEventMap> & QwikDocumentEventMap;
+
 /** @public */
 export declare interface ReadonlySignal<T = unknown> {
     readonly value: T;
@@ -2955,7 +3014,7 @@ declare const enum SignalFlags {
 declare class SignalImpl<T = any> implements Signal<T> {
     $untrackedValue$: T;
     /** Store a list of effects which are dependent on this signal. */
-    $effects$: null | Set<EffectSubscription>;
+    $effects$: undefined | Set<EffectSubscription>;
     $container$: Container | null;
     $wrappedSignal$: WrappedSignalImpl<T> | null;
     constructor(container: Container | null, value: T);
@@ -3652,18 +3711,11 @@ declare type SymbolToChunkResolver = (symbol: string) => string;
 export declare const sync$: <T extends Function>(fn: T) => SyncQRL<T>;
 
 /** @public */
-export declare interface SyncQRL<TYPE extends Function = any> extends QRL<TYPE> {
+export declare type SyncQRL<TYPE extends Function> = QRL<TYPE> & {
     __brand__SyncQRL__: TYPE;
-    /**
-     * Resolve the QRL of closure and invoke it.
-     *
-     * @param args - Closure arguments.
-     * @returns A return value of the closure.
-     */
-    (...args: TYPE extends (...args: infer ARGS) => any ? ARGS : never): TYPE extends (...args: any[]) => infer RETURN ? RETURN : never;
     resolved: TYPE;
-    dev: QRLDev | null;
-}
+    dev?: QRLDev | null;
+} & BivariantQrlFn<QrlArgs<TYPE>, QrlReturn<TYPE>>;
 
 declare type TableCellSpecialAttrs = {
     align?: 'left' | 'center' | 'right' | 'justify' | 'char' | undefined;
@@ -3700,6 +3752,12 @@ declare const TaskEvent = "qTask";
 /** @public */
 export declare type TaskFn = (ctx: TaskCtx) => ValueOrPromise<void | (() => void)>;
 
+/** @public */
+export declare interface TaskOptions {
+    /** Block the rendering of the component until the task completes. Default is `true` */
+    deferUpdates?: boolean;
+}
+
 /** @internal */
 export declare class _TextVNode extends _VNode {
     textNode: Text | null;
@@ -4373,10 +4431,10 @@ export declare const useStylesScopedQrl: (styles: QRL<string>) => UseStylesScope
  * @public
  * @see `Tracker`
  */
-export declare const useTask$: (fn: TaskFn) => void;
+export declare const useTask$: (fn: TaskFn, opts?: TaskOptions) => void;
 
 /** @internal */
-export declare const useTaskQrl: (qrl: QRL<TaskFn>) => void;
+export declare const useTaskQrl: (qrl: QRL<TaskFn>, opts?: TaskOptions) => void;
 
 /**
  * ```tsx
@@ -4427,7 +4485,7 @@ export declare const _VAR_PROPS: unique symbol;
 export declare const _verifySerializable: <T>(value: T, preMessage?: string) => T;
 
 /**
- * 2.0.0-beta.13-dev+cb19ff7
+ * 2.0.0-beta.15-dev+920f1a4
  *
  * @public
  */
@@ -4611,8 +4669,8 @@ declare class WrappedSignalImpl<T> extends SignalImpl<T> implements BackRef {
     $func$: (...args: any[]) => T;
     $funcStr$: string | null;
     $flags$: AllSignalFlags;
-    $hostElement$: HostElement | null;
-    [_EFFECT_BACK_REF]: Map<EffectProperty | string, EffectSubscription> | null;
+    $hostElement$: HostElement | undefined;
+    [_EFFECT_BACK_REF]: Map<EffectProperty | string, EffectSubscription> | undefined;
     constructor(container: Container | null, fn: (...args: any[]) => T, args: any[], fnStr: string | null, flags?: SignalFlags);
     invalidate(): void;
     /**