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

package/dist/core-internal.d.ts

@@ -3,6 +3,7 @@ import * as CSS_2 from 'csstype';
 import { isBrowser } from './build';
 import { isDev } from './build';
 import { isServer } from './build';
+import { JSXNode as JSXNode_2 } from './types/jsx-node';
 import { QRL as QRL_2 } from './qrl.public';
 
 /**
@@ -81,6 +82,11 @@ import { QRL as QRL_2 } from './qrl.public';
  */
 export declare const $: <T>(expression: T) => QRL<T>;
 
+declare interface AddRootFn {
+    (obj: unknown, returnRef?: never): number;
+    (obj: unknown, returnRef: true): SeenRef;
+}
+
 declare type AllEventKeys = keyof AllEventsMap;
 
 declare type AllEventMapRaw = HTMLElementEventMap & DocumentEventMap & WindowEventHandlersEventMap & {
@@ -369,6 +375,7 @@ export declare interface AsyncComputedReadonlySignal<T = unknown> extends Comput
     loading: boolean;
     /** The error that occurred while computing the signal. */
     error: Error | null;
+    resolve(): Promise<T>;
 }
 
 /** @public */
@@ -402,6 +409,7 @@ declare class AsyncComputedSignalImpl<T> extends ComputedSignalImpl<T, AsyncComp
     set untrackedError(value: Error | null);
     get untrackedError(): Error | null;
     invalidate(): void;
+    resolve(): Promise<T>;
     $computeIfNeeded$(): boolean | undefined;
 }
 
@@ -433,6 +441,13 @@ declare type BivariantQrlFn<ARGS extends any[], RETURN> = {
 /** @public */
 declare type Booleanish = boolean | `${boolean}`;
 
+/**
+ * Handles events for bind:checked
+ *
+ * @internal
+ */
+export declare const _chk: (_: any, element: HTMLInputElement) => void;
+
 declare interface Chore<T extends ChoreType = ChoreType> {
     $type$: T;
     $idx$: number | string;
@@ -440,7 +455,7 @@ declare interface Chore<T extends ChoreType = ChoreType> {
     $target$: ChoreTarget | null;
     $payload$: unknown;
     $state$: ChoreState;
-    $blockedChores$: Chore[] | null;
+    $blockedChores$: ChoreArray | null;
     $startTime$: number | undefined;
     $endTime$: number | undefined;
     $resolve$: ((value: any) => void) | undefined;
@@ -1015,7 +1030,6 @@ declare interface DeserializeContainer {
     $state$?: unknown[];
     $storeProxyMap$: ObjToProxyMap;
     $forwardRefs$: Array<number> | null;
-    $initialQRLs$: Array<string> | null;
     readonly $scheduler$: Scheduler | null;
 }
 
@@ -1049,7 +1063,6 @@ declare class DomContainer extends _SharedContainer implements ClientContainer {
     $qFuncs$: Array<(...args: unknown[]) => unknown>;
     $instanceHash$: string;
     $forwardRefs$: Array<number> | null;
-    $initialQRLs$: Array<string> | null;
     vNodeLocate: (id: string | Element) => _VNode;
     private $stateData$;
     private $styleIds$;
@@ -1068,24 +1081,6 @@ declare class DomContainer extends _SharedContainer implements ClientContainer {
     $appendStyle$(content: string, styleId: string, host: _VirtualVNode, scoped: boolean): void;
     /** Set the server data for the Qwik Router. */
     private $setServerData$;
-    /**
-     * Schedule the initial QRLs to be resolved.
-     *
-     * Schedules the QRLs that are defined in the state data as `PreloadQRL`.
-     *
-     * This is done because when computed and custom serializer QRLs are called they need QRL to work.
-     * If the QRL is not resolved at this point, it will be resolved by throwing a promise and
-     * rerunning the whole wrapping function again. We want to avoid that, because it means that the
-     * function can execute twice.
-     *
-     * ```ts
-     * useVisibleTask$(() => {
-     *   runHeavyLogic(); // This will be called again if the QRL of `computedOrCustomSerializer` is not resolved.
-     *   console.log(computedOrCustomSerializer.value); // Throw a promise if QRL not resolved and execute visible task again.
-     * });
-     * ```
-     */
-    private $scheduleInitialQRLs$;
 }
 export { DomContainer }
 export { DomContainer as _DomContainer }
@@ -1155,9 +1150,9 @@ _SubscriptionData | null
 export declare class _ElementVNode extends _VNode {
     firstChild: _VNode | null | undefined;
     lastChild: _VNode | null | undefined;
-    element: Element;
+    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: Element, 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);
 }
 
 /** @internal */
@@ -1235,8 +1230,8 @@ export declare type FunctionComponent<P = unknown> = {
     renderFn(props: P, key: string | null, flags: number, dev?: DevJSX): JSXOutput;
 }['renderFn'];
 
-/** @internal */
-export declare const _getConstProps: <T, JSX>(props: PropsProxy | Record<string, unknown> | null | undefined) => Props | null;
+/** Used by the optimizer for spread props operations @internal */
+export declare const _getConstProps: (props: PropsProxy | Record<string, unknown> | null | undefined) => Props | null;
 
 /** @internal */
 export declare const _getContextContainer: () => ClientContainer | undefined;
@@ -1279,8 +1274,8 @@ export declare const getPlatform: () => CorePlatform;
 /** @internal */
 export declare function _getQContainerElement(element: Element | _VNode): Element | null;
 
-/** @internal */
-export declare const _getVarProps: <T, JSX>(props: PropsProxy | Record<string, unknown> | null | undefined) => Props | null;
+/** Used by the optimizer for spread props operations @internal */
+export declare const _getVarProps: (props: PropsProxy | Record<string, unknown> | null | undefined) => Props | null;
 
 /** @public */
 declare interface GlobalInjections {
@@ -1292,10 +1287,8 @@ declare interface GlobalInjections {
 }
 
 /**
- * The legacy transform, used in special cases like `<div {...props} key="key" />`. Note that the
- * children are spread arguments, instead of a prop like in jsx() calls.
- *
- * Also note that this disables optimizations.
+ * The legacy transform, used by some JSX transpilers. The optimizer normally replaces this with
+ * optimized calls, with the same caveat as `jsx()`.
  *
  * @public
  */
@@ -1431,8 +1424,16 @@ export declare const _IMMUTABLE: unique symbol;
  */
 export declare const implicit$FirstArg: <FIRST, REST extends any[], RET>(fn: (qrl: QRL<FIRST>, ...rest: REST) => RET) => ((qrl: FIRST, ...rest: REST) => RET);
 
-/** @internal */
-export declare const inlinedQrl: <T>(symbol: T, symbolName: string, lexicalScopeCapture?: any[]) => QRL<T>;
+/**
+ * Create an inlined QRL. This is mostly useful on the server side for serialization.
+ *
+ * @param symbol - The object/function to register, or `null` to retrieve a previously registered
+ *   one by hash
+ * @param symbolName - The name of the symbol.
+ * @param lexicalScopeCapture - A set of lexically scoped variables to capture.
+ * @public
+ */
+export declare const inlinedQrl: <T>(symbol: T | null, symbolName: string, lexicalScopeCapture?: any[]) => QRL<T>;
 
 /** @internal */
 export declare const inlinedQrlDEV: <T = any>(symbol: T, symbolName: string, opts: QRLDev, lexicalScopeCapture?: any[]) => QRL<T>;
@@ -1468,8 +1469,6 @@ declare type IntrinsicSVGElements = {
 /** The shared state during an invoke() call */
 declare interface InvokeContext {
     $url$: URL | undefined;
-    /** The next available index for the sequentialScope array */
-    $i$: number;
     /** The Virtual parent component for the current component code */
     $hostElement$: HostElement | undefined;
     /** The current DOM element */
@@ -1543,25 +1542,33 @@ export declare function _isStringifiable(value: unknown): value is _Stringifiabl
 export declare const _isTask: (value: any) => value is Task;
 
 /**
+ * Used by the JSX transpilers to create a JSXNode. Note that the optimizer will normally not use
+ * this, instead using _jsxSplit and _jsxSorted directly.
+ *
+ * The optimizer will also replace all `jsx()` calls with the more optimized versions.
+ *
+ * The exception is when the props are not a literal object, which can only happen when the `jsx`
+ * call is written directly.
+ *
  * @public
- * Used by the JSX transpilers to create a JSXNode.
- * Note that the optimizer will not use this, instead using _jsxSplit and _jsxSorted directly.
  */
-declare const jsx: <T extends string | FunctionComponent<any>>(type: T, props: T extends FunctionComponent<infer PROPS> ? PROPS : Props, key?: string | number | null) => JSXNode<T>;
-export { jsx }
-export { jsx as jsxs }
+export declare const jsx: <T extends string | FunctionComponent<any>>(type: T, props: T extends FunctionComponent<infer PROPS> ? PROPS : Props, key?: string | number | null, _isStatic?: boolean, dev?: JsxDevOpts) => JSXNode<T>;
 
 /** @internal */
 export declare const _jsxBranch: <T>(input?: T) => T | undefined;
 
 /** @internal @deprecated v1 compat */
-export declare const _jsxC: (type: any, mutable: any, _flags: any, key: any) => JSXNode<any>;
+export declare const _jsxC: (type: any, mutable: any, _flags: any, key: any) => JSXNode_2<any>;
 
 /** @public */
 export declare type JSXChildren = string | number | boolean | null | undefined | Function | RegExp | JSXChildren[] | Promise<JSXChildren> | Signal<JSXChildren> | JSXNode;
 
-/** @public */
-export declare const jsxDEV: <T extends string | FunctionComponent<Props>>(type: T, props: T extends FunctionComponent<infer PROPS> ? PROPS : Props, key: string | number | null | undefined, _isStatic: boolean, opts: JsxDevOpts, _ctx: unknown) => JSXNode<T>;
+/**
+ * Alias of `jsx` for development purposes.
+ *
+ * @public
+ */
+export declare const jsxDEV: <T extends string | FunctionComponent<any>>(type: T, props: T extends FunctionComponent<infer PROPS> ? PROPS : Props, key?: string | number | null, _isStatic?: boolean, dev?: JsxDevOpts) => JSXNode<T>;
 
 declare interface JsxDevOpts {
     fileName: string;
@@ -1588,9 +1595,38 @@ export declare interface JSXNode<T extends string | FunctionComponent | unknown
  * @internal
  */
 export declare interface JSXNodeInternal<T extends string | FunctionComponent | unknown = unknown> extends JSXNode<T> {
-    varProps: Record<any, unknown>;
-    constProps: Record<any, unknown> | null;
-    flags: number;
+    /** The type of node */
+    type: T;
+    /** Do the varProps need sorting */
+    toSort: boolean;
+    /** The key property */
+    key: string | null;
+    /**
+     * Props that are not guaranteed shallow equal across runs.
+     *
+     * Any prop that is in `constProps` takes precedence over `varProps`.
+     *
+     * Does not contain `children` or `key`.
+     *
+     * `onEvent$` props are normalized to the html `on:event` version
+     */
+    varProps: Props;
+    /**
+     * Props that will be shallow equal across runs. Does not contain any props that are in varProps.
+     *
+     * Any prop that is in `constProps` takes precedence over `varProps`.
+     *
+     * Does not contain `children` or `key`.
+     *
+     * `onEvent$` props are normalized to the html `on:event` version
+     */
+    constProps: Props | null;
+    /** The children of the node */
+    children: JSXChildren;
+    /** Filename etc for debugging */
+    dev?: DevJSX & {
+        stack: string | undefined;
+    };
 }
 
 /**
@@ -1601,10 +1637,17 @@ export declare interface JSXNodeInternal<T extends string | FunctionComponent |
 export declare type JSXOutput = JSXNode | string | number | boolean | null | undefined | JSXOutput[];
 
 /** @internal @deprecated v1 compat */
-export declare const _jsxQ: (type: any, mutable: any, immutable: any, children: any, _flags: any, key: any) => JSXNode<any>;
+export declare const _jsxQ: (type: any, mutable: any, immutable: any, children: any, _flags: any, key: any) => JSXNode_2<any>;
 
 /** @internal @deprecated v1 compat */
-export declare const _jsxS: (type: any, mutable: any, immutable: any, _flags: any, key: any) => JSXNode<any>;
+export declare const _jsxS: (type: any, mutable: any, immutable: any, _flags: any, key: any) => JSXNode_2<any>;
+
+/**
+ * Alias of `jsx` to support JSX syntax.
+ *
+ * @public
+ */
+export declare const jsxs: <T extends string | FunctionComponent<any>>(type: T, props: T extends FunctionComponent<infer PROPS> ? PROPS : Props, key?: string | number | null, _isStatic?: boolean, dev?: JsxDevOpts) => JSXNode<T>;
 
 /**
  * Create a JSXNode with the properties fully split into variable and constant parts, and children
@@ -1616,7 +1659,7 @@ export declare const _jsxS: (type: any, mutable: any, immutable: any, _flags: an
  * still update the attribute on the vnode.
  *
  * @param type - The JSX type
- * @param varProps - The properties of the tag, sorted, excluding children, excluding any constProps
+ * @param varProps - The properties of the tag, sorted, excluding children, key and any constProps
  * @param constProps - The properties of the tag that are known to be constant references and don't
  *   need checking for changes on re-render
  * @param children - JSX children. Any `children` in the props objects are ignored.
@@ -1626,13 +1669,13 @@ export declare const _jsxSorted: <T>(type: T, varProps: Props | null, constProps
 
 /**
  * Create a JSXNode, with the properties split into variable and constant parts, but the variable
- * parts could include keys from constProps, as well as `key` and `children`.
+ * parts could include keys from `constProps`, as well as `key` and `children`.
  *
- * The constant parts are expected to be the same on every render, and are not checked for changes.
- * This means that they are constant scalars or refs. When the ref is a signal or a store, it can
- * still update the attribute on the vnode.
+ * `constProps` cannot include `key` or `children`. The constant parts are expected to be the same
+ * on every render, and are not checked for changes. This means that they are constant scalars or
+ * refs. When the ref is a signal or a store, it can still update the attribute on the vnode.
  *
- * If `children` is defined, any `children` in the props will be ignored.
+ * If `children` or `key` are defined, any `children`/`key` in the props will be ignored.
  *
  * @param type - The tag type
  * @param varProps - The properties of the tag that could change, including children
@@ -1640,7 +1683,7 @@ export declare const _jsxSorted: <T>(type: T, varProps: Props | null, constProps
  *   for changes on re-render
  * @internal
  */
-export declare const _jsxSplit: <T extends string | FunctionComponent<any>>(type: T, varProps: Props | null, constProps: Props | null, children: JSXChildren | null | undefined, flags: number, key: string | number | null, dev?: DevJSX) => JSXNodeInternal<T>;
+export declare const _jsxSplit: <T extends string | FunctionComponent<any>>(type: T, varProps: Props | null, constProps: Props | null, children: JSXChildren | null | undefined, flags: number, key?: string | number | null, dev?: DevJSX) => JSXNodeInternal<T>;
 
 /** @public */
 export declare type JSXTagName = keyof HTMLElementTagNameMap | Omit<string, keyof HTMLElementTagNameMap>;
@@ -1821,6 +1864,9 @@ export declare interface OnVisibleTaskOptions {
     strategy?: VisibleTaskStrategy;
 }
 
+/** @internal */
+declare const _OWNER: unique symbol;
+
 /**
  * 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
@@ -1960,6 +2006,7 @@ export declare type PropsOf<COMP> = COMP extends string ? COMP extends keyof Qwi
 declare type PropsProxy = {
     [_VAR_PROPS]: Props;
     [_CONST_PROPS]: Props | null;
+    [_OWNER]: JSXNodeInternal;
 };
 
 declare type PropType<T extends object, P extends keyof T> = P extends keyof T ? T[P] : 'value' extends keyof T ? T['value'] : never;
@@ -1977,6 +2024,11 @@ export declare interface _QDocument extends Document {
     qVNodeData: WeakMap<Element, string>;
 }
 
+declare interface QElement extends Element {
+    qDispatchEvent?: (event: Event, scope: QwikLoaderEventScope) => boolean;
+    vNode?: _VNode;
+}
+
 /**
  * The `QRL` type represents a lazy-loadable AND serializable resource.
  *
@@ -2331,6 +2383,8 @@ declare type QwikKnownEventsPlain<EL> = {
     [K in keyof AllPascalEventMaps as `${'document:' | 'window:' | ''}on${K}$`]?: QRLEventHandlerMulti<AllPascalEventMaps[K], EL> | EventHandler<AllPascalEventMaps[K], EL>;
 };
 
+declare type QwikLoaderEventScope = '-document' | '-window' | '';
+
 /**
  * The metadata of the build. One of its uses is storing where QRL symbols are located.
  *
@@ -2472,7 +2526,12 @@ declare type RefFnInterface<EL> = {
     (el: EL): void;
 };
 
-/** @internal */
+/**
+ * Register a QRL symbol globally for lookup by its hash. This is used by the optimizer to register
+ * the names passed in `reg_ctx_name`.
+ *
+ * @internal
+ */
 export declare const _regSymbol: (symbol: any, hash: string) => any;
 
 /**
@@ -2658,7 +2717,7 @@ declare interface ResourceReturnInternal<T> {
 export declare const _restProps: (props: PropsProxy, omit?: string[], target?: Props) => Props;
 
 /**
- * This is called by qwik-loader to schedule a QRL. It has to be synchronous.
+ * This is called by qwik-loader to run a QRL. It has to be synchronous.
  *
  * @internal
  */
@@ -2666,10 +2725,10 @@ export declare const _run: (...args: unknown[]) => ValueOrPromise<unknown>;
 
 declare type Scheduler = ReturnType<typeof createScheduler>;
 
+/** Stores the location of an object. If no parent, it's a root. */
 declare type SeenRef = {
-    $parent$: unknown | null;
     $index$: number;
-    $rootIndex$: number;
+    $parent$?: SeenRef | null;
 };
 
 /** @public */
@@ -2691,28 +2750,21 @@ declare interface SerializationContext {
      * - `{ parent, index }` - The parent object and the index within that parent.
      * - `undefined` - Object has not been seen yet.
      */
-    $wasSeen$: (obj: unknown) => SeenRef | undefined;
+    getSeenRef: (obj: unknown) => SeenRef | undefined;
+    /** Returns the root index of the object, if it is a root. Otherwise returns undefined. */
     $hasRootId$: (obj: unknown) => number | undefined;
     /**
      * Root objects which need to be serialized.
      *
      * Roots are entry points into the object graph. Typically the roots are held by the listeners.
      *
-     * Returns a path string representing the path from roots through all parents to the object.
-     * Format: "3 2 0" where each number is the index within its parent, from root to leaf.
-     */
-    $addRoot$: (obj: unknown, parent?: unknown) => number;
-    /**
-     * Get root path of the object without creating a new root.
-     *
-     * This is used during serialization, as new roots can't be created during serialization.
-     *
-     * The function throws if the root was not found.
+     * Returns the index of the root object.
      */
-    $addRootPath$: (obj: any) => string | number;
-    $seen$: (obj: unknown, parent: unknown | null, index: number) => void;
+    $addRoot$: AddRootFn;
+    /** Mark an object as seen during serialization. This is used to handle backreferences and cycles */
+    $markSeen$: (obj: unknown, parent: SeenRef | undefined, index: number) => SeenRef;
     $roots$: unknown[];
-    $objectPathStringCache$: Map<unknown, string | number>;
+    $promoteToRoot$: (ref: SeenRef, index?: number) => void;
     $addSyncFn$($funcStr$: string | null, argsCount: number, fn: Function): number;
     $isSsrNode$: (obj: unknown) => obj is SsrNode;
     $isDomRef$: (obj: unknown) => obj is DomRef;
@@ -2905,6 +2957,7 @@ declare class SignalImpl<T = any> implements Signal<T> {
     /** Store a list of effects which are dependent on this signal. */
     $effects$: null | Set<EffectSubscription>;
     $container$: Container | null;
+    $wrappedSignal$: WrappedSignalImpl<T> | null;
     constructor(container: Container | null, value: T);
     /**
      * Use this to force running subscribers, for example when the calculated value has mutated but
@@ -3201,7 +3254,7 @@ declare type SsrAttrKey = string;
 
 declare type SsrAttrs = Array<SsrAttrKey | SsrAttrValue>;
 
-declare type SsrAttrValue = string | Signal<any> | boolean | object | null;
+declare type SsrAttrValue = string | Signal<any> | Promise<any> | boolean | object | null;
 
 /** @public */
 export declare const SSRComment: FunctionComponent<{
@@ -3211,6 +3264,7 @@ export declare const SSRComment: FunctionComponent<{
 declare interface SSRContainer extends Container {
     readonly tag: string;
     readonly isHtml: boolean;
+    readonly size: number;
     readonly writer: StreamWriter;
     readonly serializationCtx: SerializationContext;
     readonly symbolToChunkResolver: SymbolToChunkResolver;
@@ -3218,6 +3272,7 @@ declare interface SSRContainer extends Container {
     additionalHeadNodes: Array<JSXNodeInternal>;
     additionalBodyNodes: Array<JSXNodeInternal>;
     unclaimedProjectionComponentFrameQueue: ISsrComponentFrame[];
+    write(text: string): void;
     openContainer(): void;
     closeContainer(): ValueOrPromise<void>;
     openElement(elementName: string, varAttrs: SsrAttrs | null, constAttrs?: SsrAttrs | null, currentFile?: string | null): string | undefined;
@@ -3928,6 +3983,8 @@ export declare const useLexicalScope: <VARS extends any[]>() => VARS;
  * Used to programmatically add event listeners. Useful from custom `use*` methods, which do not
  * have access to the JSX. Otherwise, it's adding a JSX listener in the `<div>` is a better idea.
  *
+ * Events are case sensitive.
+ *
  * @public
  * @see `useOn`, `useOnWindow`, `useOnDocument`.
  */
@@ -3939,6 +3996,8 @@ export declare const useOn: <T extends KnownEventNames>(event: T | T[], eventQrl
  * Used to programmatically add event listeners. Useful from custom `use*` methods, which do not
  * have access to the JSX.
  *
+ * Events are case sensitive.
+ *
  * @public
  * @see `useOn`, `useOnWindow`, `useOnDocument`.
  *
@@ -3966,6 +4025,8 @@ export declare const useOnDocument: <T extends KnownEventNames>(event: T | T[],
  * Used to programmatically add event listeners. Useful from custom `use*` methods, which do not
  * have access to the JSX.
  *
+ * Events are case sensitive.
+ *
  * @public
  * @see `useOn`, `useOnWindow`, `useOnDocument`.
  *
@@ -4345,6 +4406,13 @@ export declare const useVisibleTask$: (fn: TaskFn, opts?: OnVisibleTaskOptions)
 /** @internal */
 export declare const useVisibleTaskQrl: (qrl: QRL<TaskFn>, opts?: OnVisibleTaskOptions) => void;
 
+/**
+ * Handles events for bind:value
+ *
+ * @internal
+ */
+export declare const _val: (_: any, element: HTMLInputElement) => void;
+
 /**
  * Type representing a value which is either resolve or a promise.
  *
@@ -4359,7 +4427,7 @@ export declare const _VAR_PROPS: unique symbol;
 export declare const _verifySerializable: <T>(value: T, preMessage?: string) => T;
 
 /**
- * 2.0.0-beta.11-dev+d7daca3
+ * 2.0.0-beta.13-dev+cb19ff7
  *
  * @public
  */
@@ -4511,8 +4579,9 @@ declare const enum VNodeJournalOpCode {
     SetText = 1,// ------ [SetAttribute, target, text]
     SetAttribute = 2,// - [SetAttribute, target, ...(key, values)]]
     HoistStyles = 3,// -- [HoistStyles, document]
-    Remove = 4,// ------- [Insert, target(parent), ...nodes]
-    Insert = 5
+    Remove = 4,// ------- [Remove, target(parent), ...nodes]
+    RemoveAll = 5,// ------- [RemoveAll, target(parent)]
+    Insert = 6
 }
 
 /** @internal */
@@ -4553,6 +4622,7 @@ declare class WrappedSignalImpl<T> extends SignalImpl<T> implements BackRef {
     force(): void;
     get untrackedValue(): T;
     $computeIfNeeded$(): void;
+    $unwrapIfSignal$(): SignalImpl<T> | WrappedSignalImpl<T>;
     set value(_: any);
     get value(): any;
 }