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

package/dist/testing/index.d.ts

@@ -18,19 +18,9 @@ declare interface AddRootFn {
 
 declare type AllSignalFlags = SignalFlags | WrappedSignalFlags | SerializationSignalFlags;
 
-declare type AsyncComputedCtx = {
-    track: Tracker;
-    cleanup: (callback: () => void) => void;
-};
-
-/** @public */
-declare type AsyncComputedFn<T> = (ctx: AsyncComputedCtx) => Promise<T>;
-
-declare type AsyncComputeQRL<T> = QRLInternal<AsyncComputedFn<T>>;
-
 /** Class for back reference to the EffectSubscription */
 declare abstract class BackRef {
-    [_EFFECT_BACK_REF]: Map<EffectProperty | string, EffectSubscription> | undefined;
+    [_EFFECT_BACK_REF]: Map<any, any> | undefined;
 }
 
 declare type BivariantQrlFn<ARGS extends any[], RETURN> = {
@@ -43,58 +33,18 @@ declare type BivariantQrlFn<ARGS extends any[], RETURN> = {
     bivarianceHack(...args: ARGS): Promise<RETURN>;
 }['bivarianceHack'];
 
-declare interface Chore<T extends ChoreType = ChoreType> {
-    $type$: T;
-    $idx$: number | string;
-    $host$: HostElement;
-    $target$: ChoreTarget | null;
-    $payload$: unknown;
-    $state$: ChoreState;
-    $blockedChores$: ChoreArray | null;
-    $startTime$: number | undefined;
-    $endTime$: number | undefined;
-    $resolve$: ((value: any) => void) | undefined;
-    $reject$: ((reason?: any) => void) | undefined;
-    $returnValue$: ValueOrPromise<ChoreReturnValue<T>>;
-}
-
-declare class ChoreArray extends Array<Chore> {
-    add(value: Chore): number;
-    delete(value: Chore): number;
-}
-
-declare type ChoreReturnValue<T extends ChoreType = ChoreType> = T extends ChoreType.RECOMPUTE_AND_SCHEDULE_EFFECTS | ChoreType.WAIT_FOR_QUEUE | ChoreType.NODE_PROP ? void : T extends ChoreType.NODE_DIFF | ChoreType.COMPONENT ? JSXOutput_2 : unknown;
-
-declare enum ChoreState {
+declare const enum ChoreBits {
     NONE = 0,
-    RUNNING = 1,
-    FAILED = 2,
-    DONE = 3
+    TASKS = 1,
+    NODE_DIFF = 2,
+    COMPONENT = 4,
+    NODE_PROPS = 8,
+    COMPUTE = 16,
+    CHILDREN = 32,
+    CLEANUP = 64,
+    DIRTY_MASK = 127
 }
 
-declare type ChoreTarget = HostElement | QRLInternal<(...args: unknown[]) => unknown> | Signal | StoreTarget;
-
-declare const enum ChoreType {
-    MACRO = 240,
-    MICRO = 15,
-    /** Ensure that the QRL promise is resolved before processing next chores in the queue */
-    QRL_RESOLVE = 1,
-    RUN_QRL = 2,
-    TASK = 3,
-    NODE_DIFF = 4,
-    NODE_PROP = 5,
-    COMPONENT = 6,
-    RECOMPUTE_AND_SCHEDULE_EFFECTS = 7,
-    VISIBLE = 16,
-    CLEANUP_VISIBLE = 32,
-    WAIT_FOR_QUEUE = 255
-}
-
-/** @public */
-declare type ComputedFn<T> = () => T;
-
-declare type ComputeQRL<T> = QRLInternal<ComputedFn<T>>;
-
 /**
  * Effect is something which needs to happen (side-effect) due to signal value change.
  *
@@ -104,17 +54,19 @@ declare type ComputeQRL<T> = QRLInternal<ComputedFn<T>>;
  * - `VNode` and `ISsrNode`: Either a component or `<Signal>`
  * - `Signal2`: A derived signal which contains a computation function.
  */
-declare type Consumer = Task | VNode | ISsrNode | SignalImpl;
+declare type Consumer = Task | VNode | SignalImpl | ISsrNode;
 
 declare interface Container {
     readonly $version$: string;
-    readonly $scheduler$: Scheduler;
     readonly $storeProxyMap$: ObjToProxyMap;
     readonly $locale$: string;
     readonly $getObjectById$: (id: number | string) => any;
     readonly $serverData$: Record<string, any>;
     $currentUniqueId$: number;
     $buildBase$: string | null;
+    $renderPromise$: Promise<void> | null;
+    $resolveRenderPromise$: (() => void) | null;
+    $cursorCount$: number;
     handleError(err: any, $host$: HostElement | null): void;
     getParentHost(host: HostElement): HostElement | null;
     setContext<T>(host: HostElement, context: ContextId<T>, value: T): void;
@@ -219,18 +171,6 @@ export declare const createDOM: ({ html }?: {
     userEvent: (queryOrElement: string | Element | keyof HTMLElementTagNameMap | null, eventNameCamel: string | keyof WindowEventMap, eventPayload?: any) => Promise<void>;
 }>;
 
-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 | 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>;
-    (type: ChoreType.NODE_DIFF, host: HostElement, target: HostElement, value: JSXOutput_2 | Signal): Chore<ChoreType.NODE_DIFF>;
-    (type: ChoreType.NODE_PROP, host: HostElement, prop: string, value: any): Chore<ChoreType.NODE_PROP>;
-    (type: ChoreType.CLEANUP_VISIBLE, task: Task): Chore<ChoreType.CLEANUP_VISIBLE>;
-};
-
 declare interface DescriptorBase<T = unknown, B = unknown> extends BackRef {
     $flags$: number;
     $index$: number;
@@ -240,14 +180,6 @@ declare interface DescriptorBase<T = unknown, B = unknown> extends BackRef {
     $destroy$: NoSerialize<() => void> | null;
 }
 
-/** @public */
-declare interface DevJSX {
-    fileName: string;
-    lineNumber: number;
-    columnNumber: number;
-    stack?: string;
-}
-
 declare type DomRef = {
     $ssrNode$: SsrNode;
 };
@@ -345,32 +277,12 @@ declare interface ElementFixtureOptions {
     html?: string;
 }
 
-/** @internal */
-declare class ElementVNode extends VNode {
-    firstChild: VNode | null | undefined;
-    lastChild: VNode | null | undefined;
-    element: QElement;
-    elementName: string | undefined;
-    constructor(flags: VNodeFlags, parent: ElementVNode | VirtualVNode | null, previousSibling: VNode | null | undefined, nextSibling: VNode | null | undefined, firstChild: VNode | null | undefined, lastChild: VNode | null | undefined, element: QElement, elementName: string | undefined);
-}
-
 /** @public */
 export declare function emulateExecutionOfQwikFuncs(document: Document): void;
 
 /** @public */
 export declare function expectDOM(actual: Element, expected: string): Promise<void>;
 
-/**
- * Any function taking a props object that returns JSXOutput.
- *
- * The `key`, `flags` and `dev` parameters are for internal use.
- *
- * @public
- */
-declare type FunctionComponent<P = unknown> = {
-    renderFn(props: P, key: string | null, flags: number, dev?: DevJSX): JSXOutput_2;
-}['renderFn'];
-
 /** @public */
 export declare function getTestPlatform(): TestPlatform;
 
@@ -381,8 +293,6 @@ declare interface InvokeContext {
     $url$: URL | undefined;
     /** The Virtual parent component for the current component code */
     $hostElement$: HostElement | undefined;
-    /** The current DOM element */
-    $element$: Element | undefined;
     /** The event we're currently handling */
     $event$: PossibleEvents | undefined;
     /** The QRL function we're currently executing */
@@ -397,6 +307,7 @@ declare type InvokeTuple = [Element, Event, URL?];
 declare interface ISsrNode {
     id: string;
     flags: SsrNodeFlags;
+    dirty: ChoreBits;
     parentComponent: ISsrNode | null;
     vnodeData: VNodeData;
     currentFile: string | null;
@@ -407,29 +318,6 @@ declare interface ISsrNode {
     setTreeNonUpdatable(): void;
 }
 
-/** @public */
-declare type JSXChildren = string | number | boolean | null | undefined | Function | RegExp | JSXChildren[] | Promise<JSXChildren> | Signal<JSXChildren> | JSXNode;
-
-/**
- * A JSX Node, an internal structure. You probably want to use `JSXOutput` instead.
- *
- * @public
- */
-declare interface JSXNode<T extends string | FunctionComponent | unknown = unknown> {
-    type: T;
-    props: T extends FunctionComponent<infer P> ? P : Record<any, unknown>;
-    children: JSXChildren | null;
-    key: string | null;
-    dev?: DevJSX;
-}
-
-/**
- * Any valid output for a component
- *
- * @public
- */
-declare type JSXOutput_2 = JSXNode | string | number | boolean | null | undefined | JSXOutput_2[];
-
 /** @public */
 declare interface MockDocument extends Document {
 }
@@ -466,18 +354,10 @@ declare type NoSerialize<T> = (T & {
 
 declare type ObjToProxyMap = WeakMap<any, any>;
 
-/** @public */
-declare type OnRenderFn<PROPS> = (props: PROPS) => JSXOutput_2;
-
 declare type PossibleEvents = Event | SimplifiedServerRequestEvent | typeof TaskEvent | typeof RenderEvent | typeof ResourceEvent;
 
 declare type Props = Record<string, unknown>;
 
-declare interface QElement extends Element {
-    qDispatchEvent?: (event: Event, scope: QwikLoaderEventScope) => ValueOrPromise<unknown>;
-    vNode?: VNode;
-}
-
 /**
  * The `QRL` type represents a lazy-loadable AND serializable resource.
  *
@@ -622,6 +502,7 @@ declare interface QRLDev {
     hi: number;
 }
 
+/** @internal */
 declare type QRLInternal<TYPE = unknown> = QRL<TYPE> & QRLInternalMethods<TYPE>;
 
 declare type QRLInternalMethods<TYPE> = {
@@ -642,8 +523,6 @@ declare type QRLInternalMethods<TYPE> = {
 
 declare type QrlReturn<T> = T extends (...args: any) => infer R ? Awaited<R> : unknown;
 
-declare type QwikLoaderEventScope = '-document' | '-window' | '';
-
 /** @public */
 declare interface ReadonlySignal<T = unknown> {
     readonly value: T;
@@ -660,12 +539,11 @@ declare interface ResourceReturnInternal<T> {
     _error: Error | undefined;
     _cache: number;
     _timeout: number;
+    _generation: number;
     value: Promise<T>;
     loading: boolean;
 }
 
-declare type Scheduler = ReturnType<typeof createScheduler>;
-
 /** Stores the location of an object. If no parent, it's a root. */
 declare type SeenRef = {
     $index$: number;
@@ -856,91 +734,6 @@ declare interface TestPlatform extends CorePlatform {
     flush: () => Promise<void>;
 }
 
-/**
- * Used to signal to Qwik which state should be watched for changes.
- *
- * The `Tracker` is passed into the `taskFn` of `useTask`. It is intended to be used to wrap state
- * objects in a read proxy which signals to Qwik which properties should be watched for changes. A
- * change to any of the properties causes the `taskFn` to rerun.
- *
- * ### Example
- *
- * The `obs` passed into the `taskFn` is used to mark `state.count` as a property of interest. Any
- * changes to the `state.count` property will cause the `taskFn` to rerun.
- *
- * ```tsx
- * const Cmp = component$(() => {
- *   const store = useStore({ count: 0, doubleCount: 0 });
- *   const signal = useSignal(0);
- *   useTask$(({ track }) => {
- *     // Any signals or stores accessed inside the task will be tracked
- *     const count = track(() => store.count);
- *     // You can also pass a signal to track() directly
- *     const signalCount = track(signal);
- *     store.doubleCount = count + signalCount;
- *   });
- *   return (
- *     <div>
- *       <span>
- *         {store.count} / {store.doubleCount}
- *       </span>
- *       <button
- *         onClick$={() => {
- *           store.count++;
- *           signal.value++;
- *         }}
- *       >
- *         +
- *       </button>
- *     </div>
- *   );
- * });
- * ```
- *
- * @public
- * @see `useTask`
- */
-declare interface Tracker {
-    /**
-     * Include the expression using stores / signals to track:
-     *
-     * ```tsx
-     * track(() => store.count);
-     * ```
-     *
-     * The `track()` function also returns the value of the scoped expression:
-     *
-     * ```tsx
-     * const count = track(() => store.count);
-     * ```
-     */
-    <T>(fn: () => T): T;
-    /**
-     * Used to track the whole object. If any property of the passed store changes, the task will be
-     * scheduled to run. Also accepts signals.
-     *
-     * Note that the change tracking is not deep. If you want to track changes to nested properties,
-     * you need to use `track` on each of them.
-     *
-     * ```tsx
-     * track(store); // returns store
-     * track(signal); // returns signal.value
-     * ```
-     */
-    <T extends object>(obj: T): T extends Signal<infer U> ? U : T;
-    /**
-     * Used to track to track a specific property of an object.
-     *
-     * Note that the change tracking is not deep. If you want to track changes to nested properties,
-     * you need to use `track` on each of them.
-     *
-     * ```tsx
-     * track(store, 'propA'); // returns store.propA
-     * ```
-     */
-    <T extends object, P extends keyof T>(obj: T, prop: P): T[P];
-}
-
 /**
  * Trigger an event in unit tests on an element. Needs to be kept in sync with the Qwik Loader event
  * dispatching.
@@ -960,28 +753,18 @@ export declare function trigger(root: Element, queryOrElement: string | Element
  */
 declare type ValueOrPromise<T> = T | Promise<T>;
 
-/** @internal */
-declare class VirtualVNode extends VNode {
-    firstChild: VNode | null | undefined;
-    lastChild: VNode | null | undefined;
-    constructor(flags: VNodeFlags, parent: ElementVNode | VirtualVNode | null, previousSibling: VNode | null | undefined, nextSibling: VNode | null | undefined, firstChild: VNode | null | undefined, lastChild: VNode | null | undefined);
-}
-
 /** @internal */
 declare abstract class VNode extends BackRef {
     flags: VNodeFlags;
-    parent: ElementVNode | VirtualVNode | null;
+    parent: VNode | null;
     previousSibling: VNode | null | undefined;
     nextSibling: VNode | null | undefined;
-    props: unknown[] | null;
+    props: Props | null;
     slotParent: VNode | null;
-    chores: ChoreArray | null;
-    blockedChores: ChoreArray | null;
-    constructor(flags: VNodeFlags, parent: ElementVNode | VirtualVNode | null, previousSibling: VNode | null | undefined, nextSibling: VNode | null | undefined);
-    getProp<T>(key: string, getObject: ((id: string) => any) | null): T | null;
-    setProp(key: string, value: any): void;
-    getAttr(key: string): string | null;
-    setAttr(key: string, value: string | null | boolean, journal: VNodeJournal | null): void;
+    dirty: ChoreBits;
+    dirtyChildren: VNode[] | null;
+    nextDirtyChildIndex: number;
+    constructor(flags: VNodeFlags, parent: VNode | null, previousSibling: VNode | null | undefined, nextSibling: VNode | null | undefined, props: Props | null);
     toString(): string;
 }
 
@@ -1066,30 +849,12 @@ declare const enum VNodeFlags {
     Inflated = 8,
     Resolved = 16,
     Deleted = 32,
-    NAMESPACE_MASK = 192,
-    NEGATED_NAMESPACE_MASK = -193,
+    Cursor = 64,
+    NAMESPACE_MASK = 384,
+    NEGATED_NAMESPACE_MASK = -385,
     NS_html = 0,// http://www.w3.org/1999/xhtml
-    NS_svg = 64,// http://www.w3.org/2000/svg
-    NS_math = 128
-}
-
-declare type VNodeJournal = Array<VNodeJournalOpCode | Document | Element | Text | string | boolean | null>;
-
-/**
- * Fundamental DOM operations are:
- *
- * - Insert new DOM element/text
- * - Remove DOM element/text
- * - Set DOM element attributes
- * - Set text node value
- */
-declare const enum VNodeJournalOpCode {
-    SetText = 1,// ------ [SetAttribute, target, text]
-    SetAttribute = 2,// - [SetAttribute, target, ...(key, values)]]
-    HoistStyles = 3,// -- [HoistStyles, document]
-    Remove = 4,// ------- [Remove, target(parent), ...nodes]
-    RemoveAll = 5,// ------- [RemoveAll, target(parent)]
-    Insert = 6
+    NS_svg = 128,// http://www.w3.org/2000/svg
+    NS_math = 256
 }
 
 /**