@qwik.dev/core 2.0.0-beta.31 → 2.0.0-beta.32

package/dist/backpatch/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qwik.dev/core/backpatch",
-  "version": "2.0.0-beta.31-dev+906321a",
+  "version": "2.0.0-beta.32-dev+0e29f8a",
   "main": "index.mjs",
   "types": "index.d.ts",
   "private": true,

package/dist/build/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qwik.dev/core/build",
-  "version": "2.0.0-beta.31-dev+906321a",
+  "version": "2.0.0-beta.32-dev+0e29f8a",
   "main": "index.mjs",
   "types": "index.d.ts",
   "private": true,

package/dist/cli.mjs

@@ -1,6 +1,6 @@
 /**
  * @license
- * @qwik.dev/core/cli 2.0.0-beta.31-dev+906321a
+ * @qwik.dev/core/cli 2.0.0-beta.32-dev+0e29f8a
  * Copyright QwikDev. All Rights Reserved.
  * Use of this source code is governed by an MIT-style license that can be
  * found in the LICENSE file at https://github.com/QwikDev/qwik/blob/main/LICENSE
@@ -12953,7 +12953,7 @@ async function printHelp(app) {
   await runCommand2(Object.assign(app, { task: args[0], args }));
 }
 function printVersion() {
-  console.log("2.0.0-beta.31-dev+906321a");
+  console.log("2.0.0-beta.32-dev+0e29f8a");
 }
 export {
   runCli,

package/dist/core-internal.d.ts

@@ -381,7 +381,7 @@ declare type AsyncCtx<T = unknown> = {
     /** The result of the previous computation, if any */
     readonly previous: T | undefined;
     /** Extra info passed to `invalidate(info)` for this computation, if any. */
-    readonly info: unknown;
+    readonly info?: unknown;
 };
 
 /**
@@ -396,16 +396,16 @@ export declare type AsyncFn<T> = (ctx: AsyncCtx) => ValueOrPromise<T>;
 /** Retains job metadata and also serves as the argument for the compute function */
 declare class AsyncJob<T> implements AsyncCtx<T> {
     readonly $signal$: AsyncSignalImpl<T>;
-    readonly info: unknown;
-    readonly $infoVersion$: number;
     /** First holds the compute promise and then the cleanup promise */
-    $promise$: Promise<void> | null;
+    $promise$: Promise<void> | null | void;
     $cleanupRequested$: boolean;
     $canWrite$: boolean;
     $track$: AsyncCtx<T>['track'] | undefined;
     $cleanups$: Parameters<AsyncCtx<T>['cleanup']>[0][] | undefined;
     $abortController$: AbortController | undefined;
-    constructor($signal$: AsyncSignalImpl<T>, info: unknown, $infoVersion$: number);
+    info: unknown;
+    $infoVersion$: number | undefined;
+    constructor($signal$: AsyncSignalImpl<T>, info: unknown, $infoVersion$: number | undefined);
     get track(): AsyncCtx<T>['track'];
     get abortSignal(): AbortSignal;
     /** Backward compatible cache method for resource */
@@ -451,18 +451,40 @@ export declare interface AsyncSignal<T = unknown> extends ComputedSignal<T> {
      * ```
      */
     loading: boolean;
+    /**
+     * Lets you read the loading state without subscribing to `.loading` updates. It also triggers
+     * lazy loading of the signal.
+     *
+     * Setting it will trigger listeners for `.loading`.
+     */
+    untrackedLoading: boolean;
     /**
      * The error that occurred while computing the signal, if any. This will be cleared when the
-     * signal is successfully computed.
+     * signal is successfully computed. It does not trigger lazy loading of the signal.
      */
     error: Error | undefined;
     /**
-     * Staleness/poll interval in ms. Writable and immediately effective.
+     * Lets you read the error state without subscribing to `.error` updates. It does not trigger lazy
+     * loading of the signal.
+     *
+     * Setting it will trigger listeners for `.error`.
+     */
+    untrackedError: Error | undefined;
+    /**
+     * Expiration time in ms. Writable and immediately effective.
+     *
+     * When set, the signal is invalidated after this many ms. Whether it auto-recomputes depends on
+     * the `poll` property. `0` means no expiration.
+     */
+    expires: number;
+    /**
+     * Whether to automatically re-run the function when the value expires. Writable and immediately
+     * effective. Only relevant when `expires` is set.
      *
-     * - **Positive**: Poll — re-compute after this many ms when subscribers exist.
-     * - **Negative**: Stale-only — mark stale after `|interval|` ms, no auto-recompute.
-     * - **`0`**: No staleness tracking or polling.
+     * Defaults to `true`.
      */
+    poll: boolean;
+    /** @deprecated Use `expires` and `poll` instead. Will be removed before v2 */
     interval: number;
     /** A promise that resolves when the value is computed or rejected. */
     promise(): Promise<void>;
@@ -477,7 +499,9 @@ export declare interface AsyncSignal<T = unknown> extends ComputedSignal<T> {
 
 declare const enum AsyncSignalFlags {
     EAGER_CLEANUP = 32,
-    CLIENT_ONLY = 64
+    CLIENT_ONLY = 64,
+    CLEAR_ON_INVALIDATE = 128,
+    NO_POLL = 256
 }
 
 /**
@@ -486,21 +510,23 @@ declare const enum AsyncSignalFlags {
  * AsyncSignalImpl
  *
  * # ================================
+ *
+ * @internal
  */
 declare class AsyncSignalImpl<T> extends ComputedSignalImpl<T, AsyncQRL<T>> implements BackRef, AsyncSignal<T> {
     $untrackedLoading$: boolean;
     $untrackedError$: Error | undefined;
-    $loadingEffects$: undefined | Set<EffectSubscription>;
-    $errorEffects$: undefined | Set<EffectSubscription>;
     $current$: AsyncJob<T> | null;
-    $jobs$: AsyncJob<T>[];
-    $concurrency$: number;
-    $interval$: number;
+    $jobs$: AsyncJob<T>[] | undefined;
+    $concurrency$: number | undefined;
+    $expires$: number | undefined;
     $timeoutMs$: number | undefined;
-    $info$: unknown;
-    $infoVersion$: number;
+    $loadingEffects$: undefined | Set<EffectSubscription>;
+    $errorEffects$: undefined | Set<EffectSubscription>;
     $pollTimeoutId$: ReturnType<typeof setTimeout> | undefined;
     $computationTimeoutId$: ReturnType<typeof setTimeout> | undefined;
+    $info$: unknown | undefined;
+    $infoVersion$: number | undefined;
     [_EFFECT_BACK_REF]: Map<EffectProperty | string, EffectSubscription> | undefined;
     constructor(container: _Container | null, fn: AsyncQRL<T>, flags?: SignalFlags | SerializationSignalFlags, options?: AsyncSignalOptions<T>);
     get untrackedValue(): T;
@@ -532,10 +558,16 @@ declare class AsyncSignalImpl<T> extends ComputedSignalImpl<T, AsyncQRL<T>> impl
     get error(): Error | undefined;
     set untrackedError(value: Error | undefined);
     get untrackedError(): Error | undefined;
+    get expires(): number;
+    set expires(value: number);
+    get poll(): boolean;
+    set poll(value: boolean);
+    /** @deprecated Use `expires` and `poll` instead. */
     get interval(): number;
     set interval(value: number);
     /** Invalidates the signal, causing it to re-compute its value. */
     invalidate(info?: unknown): Promise<void>;
+    $setInvalid$(allowRecalc: boolean, mustClear: boolean | number): void;
     /** Abort the current computation and run cleanups if needed. */
     abort(reason?: any): void;
     /** Schedule eager cleanup on next macro task if no subscribers remain. */
@@ -545,14 +577,19 @@ declare class AsyncSignalImpl<T> extends ComputedSignalImpl<T, AsyncQRL<T>> impl
     /** Run the computation if needed */
     $computeIfNeeded$(): void;
     $runComputation$(running: AsyncJob<T>): Promise<void>;
+    /**
+     * Sets the error from the given job. We only accept errors from the current job and we ignore
+     * AbortErrors.
+     */
+    $setError$(job: AsyncJob<T>, error: Error): void;
     /** Called after SSR/unmount */
     $destroy$(): Promise<void>;
     private $clearNextPoll$;
     private $scheduleNextPoll$;
     private $hasSubscribers$;
-    $requestCleanups$(job: AsyncJob<T>, reason?: any): Promise<void | null>;
+    $requestCleanups$(job: AsyncJob<T>, reason?: any): void;
     /** Clean up and trigger signal compute once complete */
-    $runCleanups$(job: AsyncJob<T>): Promise<void>;
+    $runCleanups$(job: AsyncJob<T>): Promise<void> | undefined;
 }
 
 /** @public */
@@ -573,21 +610,23 @@ export declare interface AsyncSignalOptions<T> extends ComputedOptions {
      */
     eagerCleanup?: boolean;
     /**
-     * Wait for previous invocation to complete before running again.
+     * Time in milliseconds after which the value expires.
      *
-     * Defaults to `true`.
+     * When the value expires and subscribers exist, the signal is invalidated. If `poll` is `true`
+     * (default), the function is re-run automatically. If `poll` is `false`, the value is marked
+     * stale and recomputation happens when reading `.value` or `.loading`.
      *
-     * @deprecated Not implemented yet
+     * `0` (default) means no expiration.
      */
-    awaitPrevious?: boolean;
+    expires?: number;
     /**
-     * Controls staleness and polling behavior.
+     * Whether to automatically re-run the function when the value expires. Only relevant when
+     * `expires` is set.
      *
-     * - **Positive**: Re-run the function after `interval` ms if subscribers exist (polling).
-     * - **Negative**: Mark the value as stale after `|interval|` ms, but do NOT auto-recompute.
-     *   Consumers can check staleness and manually trigger recomputation.
-     * - **`0`** (default): No staleness tracking or polling.
+     * Defaults to `true`.
      */
+    poll?: boolean;
+    /** @deprecated Use `expires` and `poll` instead. Will be removed before v2 */
     interval?: number;
     /**
      * When true, the async computation is postponed to the browser. On SSR, the signal remains
@@ -596,6 +635,23 @@ export declare interface AsyncSignalOptions<T> extends ComputedOptions {
      * Defaults to `false`.
      */
     clientOnly?: boolean;
+    /**
+     * When true (default), the previous value is kept while the signal re-computes after
+     * invalidation, so reads return stale data instead of throwing a promise. Reactivity will then
+     * update the readers when the new value is ready.
+     *
+     * When false, invalidation clears the value so reads throw the computation promise (like the
+     * initial load), which is useful for navigations where showing old data would be confusing.
+     *
+     * Note that polling invalidations (`expires` with `poll: true`) are not affected by this option
+     * and will keep the old value while the new value is loading, to avoid flashing loaders.
+     *
+     * This option only affects manual invalidations via `invalidate()`, and non-polling expirations
+     * (`poll: false`, or there are no subscribers).
+     *
+     * Defaults to `true`.
+     */
+    allowStale?: boolean;
     /**
      * Maximum time in milliseconds to wait for the async computation to complete. If exceeded, the
      * computation is aborted and an error is thrown.
@@ -633,6 +689,10 @@ declare type BivariantQrlFn<ARGS extends any[], RETURN> = {
 /** @public */
 declare type Booleanish = boolean | `${boolean}`;
 
+declare type Capture = {
+    [K in keyof HTMLElementEventMap as `capture:${K}`]?: boolean;
+};
+
 /**
  * The current captured scope during QRL invocation. This is used to provide the lexical scope for
  * QRL functions. It is used one time per invocation, synchronously, so it is safe to store it in
@@ -1194,7 +1254,7 @@ export declare interface DOMAttributes<EL extends Element> extends DOMAttributes
     class?: ClassList | Signal<ClassList> | undefined;
 }
 
-declare interface DOMAttributesBase<EL extends Element> extends QwikIntrinsicAttributes, PreventDefault, StopPropagation, RefAttr<EL> {
+declare interface DOMAttributesBase<EL extends Element> extends QwikIntrinsicAttributes, PreventDefault, StopPropagation, Capture, Passive, RefAttr<EL> {
     dangerouslySetInnerHTML?: string | undefined;
 }
 
@@ -2103,6 +2163,10 @@ declare type PascalCaseName<T extends string> = T extends keyof LcEventNameMap ?
  */
 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 Passive = {
+    [K in keyof HTMLElementEventMap as `passive:${K}`]?: boolean;
+};
+
 declare type PopoverTargetAction = 'hide' | 'show' | 'toggle';
 
 declare type PossibleEvents = Event | SimplifiedServerRequestEvent | typeof TaskEvent | typeof RenderEvent;
@@ -4205,7 +4269,7 @@ export declare const useLexicalScope: <VARS extends any[]>() => VARS;
  * @public
  * @see `useOn`, `useOnWindow`, `useOnDocument`.
  */
-export declare const useOn: <T extends KnownEventNames>(event: T | T[], eventQrl: EventQRL<T>) => void;
+export declare const useOn: <T extends KnownEventNames>(event: T | T[], eventQrl: EventQRL<T>, options?: UseOnOptions) => void;
 
 /**
  * Register a listener on `document`.
@@ -4234,7 +4298,21 @@ export declare const useOn: <T extends KnownEventNames>(event: T | T[], eventQrl
  * });
  * ```
  */
-export declare const useOnDocument: <T extends KnownEventNames>(event: T | T[], eventQrl: EventQRL<T>) => void;
+export declare const useOnDocument: <T extends KnownEventNames>(event: T | T[], eventQrl: EventQRL<T>, options?: UseOnOptions) => void;
+
+/** @public */
+export declare type UseOnOptions = UseOnOptionsBase & ({
+    passive?: boolean;
+    preventdefault?: never;
+} | {
+    passive?: never;
+    preventdefault?: boolean;
+});
+
+declare interface UseOnOptionsBase {
+    capture?: boolean;
+    stoppropagation?: boolean;
+}
 
 /**
  * Register a listener on `window`.
@@ -4264,7 +4342,7 @@ export declare const useOnDocument: <T extends KnownEventNames>(event: T | T[],
  * });
  * ```
  */
-export declare const useOnWindow: <T extends KnownEventNames>(event: T | T[], eventQrl: EventQRL<T>) => void;
+export declare const useOnWindow: <T extends KnownEventNames>(event: T | T[], eventQrl: EventQRL<T>, options?: UseOnOptions) => void;
 
 /**
  * This method works like an async memoized function that runs whenever some tracked value changes
@@ -4661,7 +4739,7 @@ export declare const _VAR_PROPS: unique symbol;
 export declare const _verifySerializable: <T>(value: T, preMessage?: string) => T;
 
 /**
- * 2.0.0-beta.31-dev+906321a
+ * 2.0.0-beta.32-dev+0e29f8a
  *
  * @public
  */