@qwik.dev/core 2.0.0-beta.3 → 2.0.0-beta.4

package/dist/core.mjs

@@ -1,6 +1,6 @@
 /**
  * @license
- * @qwik.dev/core 2.0.0-beta.3-dev+aa098fc
+ * @qwik.dev/core 2.0.0-beta.4-dev+9849dcf
  * 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
@@ -72,6 +72,24 @@ const createAndLogError = (asyncThrow, message, ...optionalParams) => {
     return err;
 };
 
+/** @private */
+const isSerializableObject = (v) => {
+    const proto = Object.getPrototypeOf(v);
+    return proto === Object.prototype || proto === Array.prototype || proto === null;
+};
+const isObject = (v) => {
+    return typeof v === 'object' && v !== null;
+};
+const isArray = (v) => {
+    return Array.isArray(v);
+};
+const isString = (v) => {
+    return typeof v === 'string';
+};
+const isFunction = (v) => {
+    return typeof v === 'function';
+};
+
 const codeToText = (code, ...parts) => {
     if (qDev) {
         // Keep one error, one line to make it easier to search for the error message.
@@ -116,7 +134,7 @@ const codeToText = (code, ...parts) => {
         if (parts.length) {
             text = text.replaceAll(/{{(\d+)}}/g, (_, index) => {
                 let v = parts[index];
-                if (v && typeof v === 'object' && v.constructor === Object) {
+                if (v && isObject(v) && v.constructor === Object) {
                     v = JSON.stringify(v).slice(0, 50);
                 }
                 return v;
@@ -377,7 +395,7 @@ const delay = (timeout) => {
         setTimeout(resolve, timeout);
     });
 };
-// Retries a function that throws a promise.
+/** Retries a function that throws a promise. */
 function retryOnPromise(fn, retryCount = 0) {
     const retryOrThrow = (e) => {
         if (isPromise(e) && retryCount < MAX_RETRY_ON_PROMISE_COUNT) {
@@ -402,24 +420,6 @@ function retryOnPromise(fn, retryCount = 0) {
     }
 }
 
-/** @private */
-const isSerializableObject = (v) => {
-    const proto = Object.getPrototypeOf(v);
-    return proto === Object.prototype || proto === Array.prototype || proto === null;
-};
-const isObject = (v) => {
-    return !!v && typeof v === 'object';
-};
-const isArray = (v) => {
-    return Array.isArray(v);
-};
-const isString = (v) => {
-    return typeof v === 'string';
-};
-const isFunction = (v) => {
-    return typeof v === 'function';
-};
-
 const ASSERT_DISCLAIMER = 'Internal assert, this is likely caused by a bug in Qwik: ';
 function assertDefined(value, text, ...parts) {
     if (qDev) {
@@ -639,7 +639,7 @@ class WrappedSignalImpl extends SignalImpl {
         this.$funcStr$ = fnStr;
         this.$flags$ = flags;
     }
-    $invalidate$() {
+    invalidate() {
         this.$flags$ |= 1 /* SignalFlags.INVALID */;
         this.$forceRunEffects$ = false;
         this.$container$?.$scheduler$(7 /* ChoreType.RECOMPUTE_AND_SCHEDULE_EFFECTS */, this.$hostElement$, this, this.$effects$);
@@ -649,9 +649,8 @@ class WrappedSignalImpl extends SignalImpl {
      * remained the same object.
      */
     force() {
-        this.$flags$ |= 1 /* SignalFlags.INVALID */;
-        this.$forceRunEffects$ = false;
-        triggerEffects(this.$container$, this, this.$effects$);
+        this.$forceRunEffects$ = true;
+        this.$container$?.$scheduler$(7 /* ChoreType.RECOMPUTE_AND_SCHEDULE_EFFECTS */, this.$hostElement$, this, this.$effects$);
     }
     get untrackedValue() {
         const didChange = this.$computeIfNeeded$();
@@ -709,7 +708,6 @@ function isSsrNode(value) {
 }
 
 let _context;
-/** @public */
 const tryGetInvokeContext = () => {
     if (!_context) {
         const context = typeof document !== 'undefined' && document && document.__q_context__;
@@ -730,6 +728,7 @@ const getInvokeContext = () => {
     }
     return ctx;
 };
+/** @internal */
 const useInvokeContext = () => {
     const ctx = tryGetInvokeContext();
     if (!ctx || ctx.$event$ !== RenderEvent) {
@@ -775,7 +774,7 @@ const newInvokeContextFromTuple = ([element, event, url]) => {
 // TODO how about putting url and locale (and event/custom?) in to a "static" object
 const newInvokeContext = (locale, hostElement, element, event, url) => {
     // ServerRequestEvent has .locale, but it's not always defined.
-    const $locale$ = locale || (typeof event === 'object' && event && 'locale' in event ? event.locale : undefined);
+    const $locale$ = locale || (event && isObject(event) && 'locale' in event ? event.locale : undefined);
     const ctx = {
         $url$: url,
         $i$: 0,
@@ -855,6 +854,13 @@ const _getContextEvent = () => {
     }
 };
 /** @internal */
+const _getContextContainer = () => {
+    const iCtx = tryGetInvokeContext();
+    if (iCtx) {
+        return iCtx.$container$;
+    }
+};
+/** @internal */
 const _jsxBranch = (input) => {
     return input;
 };
@@ -1228,7 +1234,7 @@ const isRecoverable = (err) => {
  *
  * @public
  */
-const version = "2.0.0-beta.3-dev+aa098fc";
+const version = "2.0.0-beta.4-dev+9849dcf";
 
 /** @internal */
 const EMPTY_ARRAY = [];
@@ -1393,6 +1399,8 @@ const _CONST_PROPS = Symbol('CONST');
 const _VAR_PROPS = Symbol('VAR');
 /** @internal @deprecated v1 compat */
 const _IMMUTABLE = Symbol('IMMUTABLE');
+/** @internal */
+const _UNINITIALIZED = Symbol('UNINITIALIZED');
 
 // <docs markdown="../../readme.md#implicit$FirstArg">
 // !!DO NOT EDIT THIS COMMENT DIRECTLY!!!
@@ -1462,14 +1470,15 @@ class ComputedSignalImpl extends SignalImpl {
     constructor(container, fn, 
     // We need a separate flag to know when the computation needs running because
     // we need the old value to know if effects need running after computation
-    flags = 1 /* SignalFlags.INVALID */) {
+    flags = 1 /* SignalFlags.INVALID */ |
+        16 /* ComputedSignalFlags.SERIALIZATION_STRATEGY_ALWAYS */) {
         // The value is used for comparison when signals trigger, which can only happen
         // when it was calculated before. Therefore we can pass whatever we like.
         super(container, NEEDS_COMPUTATION);
         this.$computeQrl$ = fn;
         this.$flags$ = flags;
     }
-    $invalidate$() {
+    invalidate() {
         this.$flags$ |= 1 /* SignalFlags.INVALID */;
         this.$forceRunEffects$ = false;
         this.$container$?.$scheduler$(7 /* ChoreType.RECOMPUTE_AND_SCHEDULE_EFFECTS */, null, this, this.$effects$);
@@ -1539,7 +1548,7 @@ class ComputedSignalImpl extends SignalImpl {
  */
 class SerializerSignalImpl extends ComputedSignalImpl {
     constructor(container, argQrl) {
-        super(container, argQrl);
+        super(container, argQrl, 1 /* SignalFlags.INVALID */ | 16 /* ComputedSignalFlags.SERIALIZATION_STRATEGY_ALWAYS */);
     }
     $didInitialize$ = false;
     $computeIfNeeded$() {
@@ -1555,7 +1564,7 @@ class SerializerSignalImpl extends ComputedSignalImpl {
         const update = arg.update;
         const currentValue = this.$untrackedValue$ === NEEDS_COMPUTATION ? initial : this.$untrackedValue$;
         const untrackedValue = trackSignal(() => this.$didInitialize$
-            ? update?.(currentValue)
+            ? update?.(currentValue) || currentValue
             : deserialize(currentValue), this, "." /* EffectProperty.VNODE */, this.$container$);
         const didChange = (this.$didInitialize$ && untrackedValue !== 'undefined') ||
             untrackedValue !== this.$untrackedValue$;
@@ -1644,8 +1653,7 @@ class StoreHandler {
         }
         const flags = this.$flags$;
         if (flags & 1 /* StoreFlags.RECURSIVE */ &&
-            typeof value === 'object' &&
-            value !== null &&
+            isObject(value) &&
             !Object.isFrozen(value) &&
             !isStore(value) &&
             !Object.isFrozen(target)) {
@@ -1823,7 +1831,7 @@ class AsyncComputedSignalImpl extends ComputedSignalImpl {
     $loadingEffects$ = null;
     $errorEffects$ = null;
     $destroy$;
-    $promiseValue$ = null;
+    $promiseValue$ = NEEDS_COMPUTATION;
     [_EFFECT_BACK_REF] = null;
     constructor(container, fn, flags = 1 /* SignalFlags.INVALID */) {
         super(container, fn, flags);
@@ -1857,6 +1865,10 @@ class AsyncComputedSignalImpl extends ComputedSignalImpl {
     get untrackedError() {
         return this.$untrackedError$;
     }
+    invalidate() {
+        super.invalidate();
+        this.$promiseValue$ = NEEDS_COMPUTATION;
+    }
     $computeIfNeeded$() {
         if (!(this.$flags$ & 1 /* SignalFlags.INVALID */)) {
             return false;
@@ -1864,11 +1876,12 @@ class AsyncComputedSignalImpl extends ComputedSignalImpl {
         const computeQrl = this.$computeQrl$;
         throwIfQRLNotResolved(computeQrl);
         const [cleanup] = cleanupFn(this, (err) => this.$container$?.handleError(err, null));
-        const untrackedValue = this.$promiseValue$ ??
-            computeQrl.getFn()({
+        const untrackedValue = this.$promiseValue$ === NEEDS_COMPUTATION
+            ? computeQrl.getFn()({
                 track: trackFn(this, this.$container$),
                 cleanup,
-            });
+            })
+            : this.$promiseValue$;
         if (isPromise(untrackedValue)) {
             this.untrackedLoading = true;
             this.untrackedError = null;
@@ -1879,11 +1892,12 @@ class AsyncComputedSignalImpl extends ComputedSignalImpl {
                 this.untrackedError = null;
             })
                 .catch((err) => {
+                this.$promiseValue$ = err;
                 this.untrackedLoading = false;
                 this.untrackedError = err;
             });
         }
-        this.$promiseValue$ = null;
+        this.$promiseValue$ = NEEDS_COMPUTATION;
         this.$flags$ &= -2 /* SignalFlags.INVALID */;
         const didChange = untrackedValue !== this.$untrackedValue$;
         if (didChange) {
@@ -1898,13 +1912,15 @@ const createSignal$1 = (value) => {
     return new SignalImpl(null, value);
 };
 /** @internal */
-const createComputedSignal = (qrl) => {
-    throwIfQRLNotResolved(qrl);
-    return new ComputedSignalImpl(null, qrl);
+const createComputedSignal = (qrl, options) => {
+    return new ComputedSignalImpl(options?.container || null, qrl, getComputedSignalFlags(options?.serializationStrategy || 'always'));
+};
+/** @internal */
+const createAsyncComputedSignal = (qrl, options) => {
+    return new AsyncComputedSignalImpl(options?.container || null, qrl, getComputedSignalFlags(options?.serializationStrategy || 'never'));
 };
 /** @internal */
 const createSerializerSignal = (arg) => {
-    throwIfQRLNotResolved(arg);
     return new SerializerSignalImpl(null, arg);
 };
 
@@ -1923,11 +1939,22 @@ const createSignal = createSignal$1;
  * The QRL must be a function which returns the value of the signal. The function must not have side
  * effects, and it must be synchronous.
  *
- * If you need the function to be async, use `useSignal` and `useTask$` instead.
+ * If you need the function to be async, use `useAsyncComputed$` instead.
  *
  * @public
  */
 const createComputed$ = /*#__PURE__*/ implicit$FirstArg(createComputedSignal);
+/**
+ * Create an async computed signal which is calculated from the given QRL. A computed signal is a
+ * signal which is calculated from other signals or async operation. When the signals change, the
+ * computed signal is recalculated.
+ *
+ * The QRL must be a function which returns the value of the signal. The function must not have side
+ * effects, and it can be async.
+ *
+ * @public
+ */
+const createAsyncComputed$ = /*#__PURE__*/ implicit$FirstArg(createAsyncComputedSignal);
 /**
  * Create a signal that holds a custom serializable value. See {@link useSerializer$} for more
  * details.
@@ -1987,17 +2014,6 @@ const _wrapProp = (...args) => {
     // the object is not reactive, so we can just return the value
     return obj[prop];
 };
-/** @internal */
-const _wrapStore = (obj, prop) => {
-    const target = getStoreTarget(obj);
-    const value = target[prop];
-    if (isSignal(value)) {
-        return value;
-    }
-    else {
-        return new WrappedSignalImpl(null, getProp, [obj, prop], null, 1 /* SignalFlags.INVALID */);
-    }
-};
 /** @internal @deprecated v1 compat */
 const _wrapSignal = (obj, prop) => {
     const r = _wrapProp(obj, prop);
@@ -2432,9 +2448,12 @@ const executeComponent = (container, renderHost, subscriptionHost, componentQRL,
         return jsx;
     }, (err) => {
         if (isPromise(err) && retryCount < MAX_RETRY_ON_PROMISE_COUNT) {
-            return err.then(() => executeComponentWithPromiseExceptionRetry(retryCount++));
+            return err.then(() => executeComponentWithPromiseExceptionRetry(++retryCount));
         }
         else {
+            if (retryCount >= MAX_RETRY_ON_PROMISE_COUNT) {
+                throw new Error(`Max retry count of component execution reached`);
+            }
             throw err;
         }
     });
@@ -4997,10 +5016,12 @@ function getResourceValueAsPromise(props) {
         return resource.then(useBindInvokeContext(props.onResolved), useBindInvokeContext(props.onRejected));
     }
     else if (isSignal(resource)) {
-        return Promise.resolve(resource.value).then(useBindInvokeContext(props.onResolved), useBindInvokeContext(props.onRejected));
+        const value = retryOnPromise(() => resource.value);
+        const promise = isPromise(value) ? value : Promise.resolve(value);
+        return promise.then(useBindInvokeContext(props.onResolved));
     }
     else {
-        return Promise.resolve(resource).then(useBindInvokeContext(props.onResolved), useBindInvokeContext(props.onRejected));
+        return Promise.resolve(resource).then(useBindInvokeContext(props.onResolved));
     }
 }
 const _createResourceReturn = (opts) => {
@@ -5531,7 +5552,7 @@ const createScheduler = (container, scheduleDrain, journalFlush) => {
                         if (target instanceof ComputedSignalImpl || target instanceof WrappedSignalImpl) {
                             const forceRunEffects = target.$forceRunEffects$;
                             target.$forceRunEffects$ = false;
-                            if (!effects?.size) {
+                            if (!effects?.size && !forceRunEffects) {
                                 break;
                             }
                             // needed for computed signals and throwing QRLs
@@ -6475,7 +6496,7 @@ const triggerEffects = (container, signal, effects) => {
                         container.$scheduler$(1 /* ChoreType.QRL_RESOLVE */, null, consumer.$computeQrl$);
                     }
                 }
-                consumer.$invalidate$();
+                consumer.invalidate();
             }
             else if (property === ":" /* EffectProperty.COMPONENT */) {
                 const host = consumer;
@@ -6510,7 +6531,23 @@ const triggerEffects = (container, signal, effects) => {
 };
 /** @internal */
 const isSerializerObj = (obj) => {
-    return (typeof obj === 'object' && obj !== null && typeof obj[SerializerSymbol] === 'function');
+    return isObject(obj) && typeof obj[SerializerSymbol] === 'function';
+};
+const getComputedSignalFlags = (serializationStrategy) => {
+    let flags = 1 /* SignalFlags.INVALID */;
+    switch (serializationStrategy) {
+        // TODO: implement this in the future
+        // case 'auto':
+        //   flags |= ComputedSignalFlags.SERIALIZATION_STRATEGY_AUTO;
+        //   break;
+        case 'never':
+            flags |= 8 /* ComputedSignalFlags.SERIALIZATION_STRATEGY_NEVER */;
+            break;
+        case 'always':
+            flags |= 16 /* ComputedSignalFlags.SERIALIZATION_STRATEGY_ALWAYS */;
+            break;
+    }
+    return flags;
 };
 
 const stringifyPath = [];
@@ -8250,7 +8287,7 @@ const VNodeArray = class VNode extends Array {
 /** There's [documentation](./serialization.md) */
 const deserializedProxyMap = new WeakMap();
 const isDeserializerProxy = (value) => {
-    return typeof value === 'object' && value !== null && SERIALIZER_PROXY_UNWRAP in value;
+    return isObject(value) && SERIALIZER_PROXY_UNWRAP in value;
 };
 const SERIALIZER_PROXY_UNWRAP = Symbol('UNWRAP');
 /** Call this on the serialized root state */
@@ -8458,9 +8495,7 @@ const inflate = (container, target, typeId, data) => {
             if (hasValue) {
                 asyncComputed.$untrackedValue$ = d[6];
             }
-            else {
-                asyncComputed.$flags$ |= 1 /* SignalFlags.INVALID */;
-            }
+            asyncComputed.$flags$ |= 1 /* SignalFlags.INVALID */;
             break;
         }
         // Inflating a SerializerSignal is the same as inflating a ComputedSignal
@@ -8560,7 +8595,7 @@ const inflate = (container, target, typeId, data) => {
             propsProxy[_VAR_PROPS] = data === 0 ? {} : data[0];
             propsProxy[_CONST_PROPS] = data[1];
             break;
-        case 35 /* TypeIds.EffectData */: {
+        case 35 /* TypeIds.SubscriptionData */: {
             const effectData = target;
             effectData.data.$scopedStyleIdPrefix$ = data[0];
             effectData.data.$isConst$ = data[1];
@@ -8581,6 +8616,7 @@ const _constants = [
     EMPTY_OBJ,
     NEEDS_COMPUTATION,
     STORE_ALL_PROPS,
+    _UNINITIALIZED,
     Slot,
     Fragment,
     NaN,
@@ -8600,6 +8636,7 @@ const _constantNames = [
     'EMPTY_OBJ',
     'NEEDS_COMPUTATION',
     'STORE_ALL_PROPS',
+    '_UNINITIALIZED',
     'Slot',
     'Fragment',
     'NaN',
@@ -8621,7 +8658,13 @@ const allocate = (container, typeId, value) => {
             if (!container.$forwardRefs$) {
                 throw qError(18 /* QError.serializeErrorCannotAllocate */, ['forward ref']);
             }
-            return container.$getObjectById$(container.$forwardRefs$[value]);
+            const rootRef = container.$forwardRefs$[value];
+            if (rootRef === -1) {
+                return _UNINITIALIZED;
+            }
+            else {
+                return container.$getObjectById$(rootRef);
+            }
         case 2 /* TypeIds.ForwardRefs */:
             return value;
         case 3 /* TypeIds.Constant */:
@@ -8716,7 +8759,7 @@ const allocate = (container, typeId, value) => {
             else {
                 throw qError(17 /* QError.serializeErrorExpectedVNode */, [typeof vNode]);
             }
-        case 35 /* TypeIds.EffectData */:
+        case 35 /* TypeIds.SubscriptionData */:
             return new SubscriptionData({});
         default:
             throw qError(18 /* QError.serializeErrorCannotAllocate */, [typeId]);
@@ -8778,7 +8821,7 @@ DomRefConstructor, symbolToChunkResolver, getProp, setProp, storeProxyMap, write
         };
     }
     const seenObjsMap = new Map();
-    const rootsPathMap = new Map();
+    const objectPathStringCache = new Map();
     const syncFnMap = new Map();
     const syncFns = [];
     const roots = [];
@@ -8787,7 +8830,7 @@ DomRefConstructor, symbolToChunkResolver, getProp, setProp, storeProxyMap, write
         return seenObjsMap.set(obj, { $parent$: parent, $index$: index, $rootIndex$: -1 });
     };
     const $addRootPath$ = (obj) => {
-        const rootPath = rootsPathMap.get(obj);
+        const rootPath = objectPathStringCache.get(obj);
         if (rootPath) {
             return rootPath;
         }
@@ -8806,7 +8849,7 @@ DomRefConstructor, symbolToChunkResolver, getProp, setProp, storeProxyMap, write
             current = seenObjsMap.get(current.$parent$);
         }
         const pathStr = path.length > 1 ? path.join(' ') : path.length ? path[0] : seen.$index$;
-        rootsPathMap.set(obj, pathStr);
+        objectPathStringCache.set(obj, pathStr);
         return pathStr;
     };
     const $addRoot$ = (obj, parent = null) => {
@@ -8873,7 +8916,7 @@ DomRefConstructor, symbolToChunkResolver, getProp, setProp, storeProxyMap, write
         $storeProxyMap$: storeProxyMap,
         $getProp$: getProp,
         $setProp$: setProp,
-        $pathMap$: rootsPathMap,
+        $objectPathStringCache$: objectPathStringCache,
     };
 };
 function $discoverRoots$(serializationContext, obj, parent, index) {
@@ -8897,7 +8940,8 @@ const discoverValuesForVNodeData = (vnodeData, callback) => {
             for (let i = 1; i < value.length; i += 2) {
                 const keyValue = value[i - 1];
                 const attrValue = value[i];
-                if (typeof attrValue === 'string' ||
+                if (attrValue == null ||
+                    typeof attrValue === 'string' ||
                     // skip empty props
                     (keyValue === ELEMENT_PROPS &&
                         Object.keys(attrValue).length === 0)) {
@@ -8922,6 +8966,14 @@ class PromiseResult {
         this.$qrl$ = $qrl$;
     }
 }
+class SerializationWeakRef {
+    $obj$;
+    constructor($obj$) {
+        this.$obj$ = $obj$;
+    }
+}
+/** @internal */
+const _serializationWeakRef = (obj) => new SerializationWeakRef(obj);
 /**
  * Format:
  *
@@ -8932,12 +8984,14 @@ class PromiseResult {
  * - Therefore root indexes need to be doubled to get the actual index.
  */
 async function serialize(serializationContext) {
-    const { $writer$, $isSsrNode$, $isDomRef$, $storeProxyMap$, $addRoot$, $pathMap$, $wasSeen$ } = serializationContext;
+    const { $writer$, $isSsrNode$, $isDomRef$, $storeProxyMap$, $addRoot$, $objectPathStringCache$, $wasSeen$, } = serializationContext;
     let depth = 0;
+    let rootIdx = 0;
     const forwardRefs = [];
     let forwardRefsId = 0;
     const promises = new Set();
     const preloadQrls = new Set();
+    const s11nWeakRefs = new Map();
     let parent = null;
     const isRootObject = () => depth === 0;
     const outputArray = (value, writeFn) => {
@@ -8982,19 +9036,41 @@ async function serialize(serializationContext) {
     };
     const addPreloadQrl = (qrl) => {
         preloadQrls.add(qrl);
-        serializationContext.$addRoot$(qrl, null);
+        serializationContext.$addRoot$(qrl);
     };
-    const outputRootRef = (value, rootDepth = 0) => {
+    const outputAsRootRef = (value, rootDepth = 0) => {
         const seen = $wasSeen$(value);
-        const rootRefPath = $pathMap$.get(value);
+        const rootRefPath = $objectPathStringCache$.get(value);
+        // Objects are the only way to create circular dependencies.
+        // So the first thing to to is to see if we have a circular dependency.
+        // (NOTE: For root objects we need to serialize them regardless if we have seen
+        //        them before, otherwise the root object reference will point to itself.)
+        // Also note that depth will be 1 for objects in root
         if (rootDepth === depth && seen && seen.$parent$ !== null && rootRefPath) {
             output(0 /* TypeIds.RootRef */, rootRefPath);
             return true;
         }
         else if (depth > rootDepth && seen && seen.$rootIndex$ !== -1) {
+            // We have seen this object before, so we can serialize it as a reference.
+            // Otherwise serialize as normal
             output(0 /* TypeIds.RootRef */, seen.$rootIndex$);
             return true;
         }
+        else if (s11nWeakRefs.has(value)) {
+            const forwardRefId = s11nWeakRefs.get(value);
+            // We see the object again, we must now make it a root and update the forward ref
+            if (rootDepth === depth) {
+                // It's already a root
+                forwardRefs[forwardRefId] = rootIdx;
+            }
+            else {
+                // ref
+                const rootRef = $addRoot$(value);
+                output(0 /* TypeIds.RootRef */, rootRef);
+                forwardRefs[forwardRefId] = rootRef;
+                return true;
+            }
+        }
         return false;
     };
     const writeValue = (value) => {
@@ -9009,13 +9085,13 @@ async function serialize(serializationContext) {
         }
         else if (typeof value === 'function') {
             if (value === Slot) {
-                output(3 /* TypeIds.Constant */, 9 /* Constants.Slot */);
+                output(3 /* TypeIds.Constant */, 10 /* Constants.Slot */);
             }
             else if (value === Fragment) {
-                output(3 /* TypeIds.Constant */, 10 /* Constants.Fragment */);
+                output(3 /* TypeIds.Constant */, 11 /* Constants.Fragment */);
             }
             else if (isQrl(value)) {
-                if (!outputRootRef(value)) {
+                if (!outputAsRootRef(value)) {
                     const qrl = qrlToString(serializationContext, value);
                     const type = preloadQrls.has(value) ? 21 /* TypeIds.PreloadQRL */ : 20 /* TypeIds.QRL */;
                     if (isRootObject()) {
@@ -9038,19 +9114,19 @@ async function serialize(serializationContext) {
         }
         else if (typeof value === 'number') {
             if (Number.isNaN(value)) {
-                output(3 /* TypeIds.Constant */, 11 /* Constants.NaN */);
+                output(3 /* TypeIds.Constant */, 12 /* Constants.NaN */);
             }
             else if (!Number.isFinite(value)) {
-                output(3 /* TypeIds.Constant */, value < 0 ? 13 /* Constants.NegativeInfinity */ : 12 /* Constants.PositiveInfinity */);
+                output(3 /* TypeIds.Constant */, value < 0 ? 14 /* Constants.NegativeInfinity */ : 13 /* Constants.PositiveInfinity */);
             }
             else if (value === Number.MAX_SAFE_INTEGER) {
-                output(3 /* TypeIds.Constant */, 14 /* Constants.MaxSafeInt */);
+                output(3 /* TypeIds.Constant */, 15 /* Constants.MaxSafeInt */);
             }
             else if (value === Number.MAX_SAFE_INTEGER - 1) {
-                output(3 /* TypeIds.Constant */, 15 /* Constants.AlmostMaxSafeInt */);
+                output(3 /* TypeIds.Constant */, 16 /* Constants.AlmostMaxSafeInt */);
             }
             else if (value === Number.MIN_SAFE_INTEGER) {
-                output(3 /* TypeIds.Constant */, 16 /* Constants.MinSafeInt */);
+                output(3 /* TypeIds.Constant */, 17 /* Constants.MinSafeInt */);
             }
             else {
                 output(4 /* TypeIds.Number */, value);
@@ -9080,7 +9156,7 @@ async function serialize(serializationContext) {
                 output(3 /* TypeIds.Constant */, 4 /* Constants.EmptyString */);
             }
             else {
-                if (!outputRootRef(value)) {
+                if (!outputAsRootRef(value)) {
                     output(5 /* TypeIds.String */, value);
                 }
             }
@@ -9094,6 +9170,9 @@ async function serialize(serializationContext) {
         else if (value === STORE_ALL_PROPS) {
             output(3 /* TypeIds.Constant */, 8 /* Constants.STORE_ALL_PROPS */);
         }
+        else if (value === _UNINITIALIZED) {
+            output(3 /* TypeIds.Constant */, 9 /* Constants.UNINITIALIZED */);
+        }
         else {
             throw qError(20 /* QError.serializeErrorUnknownType */, [typeof value]);
         }
@@ -9103,14 +9182,11 @@ async function serialize(serializationContext) {
          * The object writer outputs an array object (without type prefix) and this increases the depth
          * for the objects within (depth 1).
          */
-        // Objects are the only way to create circular dependencies.
-        // So the first thing to to is to see if we have a circular dependency.
-        // (NOTE: For root objects we need to serialize them regardless if we have seen
-        //        them before, otherwise the root object reference will point to itself.)
-        // Also note that depth will be 1 for objects in root
-        if (outputRootRef(value, 1)) {
+        if (outputAsRootRef(value, 1)) {
             return;
         }
+        // handle custom serializers
+        // add to the seen map
         if (isPropsProxy(value)) {
             const varProps = value[_VAR_PROPS];
             const constProps = value[_CONST_PROPS];
@@ -9122,7 +9198,7 @@ async function serialize(serializationContext) {
             output(34 /* TypeIds.PropsProxy */, out);
         }
         else if (value instanceof SubscriptionData) {
-            output(35 /* TypeIds.EffectData */, [value.data.$scopedStyleIdPrefix$, value.data.$isConst$]);
+            output(35 /* TypeIds.SubscriptionData */, [value.data.$scopedStyleIdPrefix$, value.data.$isConst$]);
         }
         else if (isStore(value)) {
             if (isResource(value)) {
@@ -9198,14 +9274,6 @@ async function serialize(serializationContext) {
                 output(1 /* TypeIds.ForwardRef */, forwardRefId);
                 return;
             }
-            /**
-             * Special case: when a Signal value is an SSRNode, it always needs to be a DOM ref instead.
-             * It can never be meant to become a vNode, because vNodes are internal only.
-             */
-            const v = value instanceof ComputedSignalImpl &&
-                (value.$flags$ & 1 /* SignalFlags.INVALID */ || fastSkipSerialize(value.$untrackedValue$))
-                ? NEEDS_COMPUTATION
-                : value.$untrackedValue$;
             if (value instanceof WrappedSignalImpl) {
                 output(26 /* TypeIds.WrappedSignal */, [
                     ...serializeWrappingFn(serializationContext, value),
@@ -9215,35 +9283,34 @@ async function serialize(serializationContext) {
                     ...(value.$effects$ || []),
                 ]);
             }
-            else if (value instanceof AsyncComputedSignalImpl) {
-                addPreloadQrl(value.$computeQrl$);
-                const out = [
-                    value.$computeQrl$,
-                    value.$effects$,
-                    value.$loadingEffects$,
-                    value.$errorEffects$,
-                    value.$untrackedLoading$,
-                    value.$untrackedError$,
-                ];
-                if (v !== NEEDS_COMPUTATION) {
-                    out.push(v);
-                }
-                output(28 /* TypeIds.AsyncComputedSignal */, out);
-            }
             else if (value instanceof ComputedSignalImpl) {
+                let v = value.$untrackedValue$;
+                const shouldAlwaysSerialize = value.$flags$ & 16 /* ComputedSignalFlags.SERIALIZATION_STRATEGY_ALWAYS */;
+                const shouldNeverSerialize = value.$flags$ & 8 /* ComputedSignalFlags.SERIALIZATION_STRATEGY_NEVER */;
+                const isInvalid = value.$flags$ & 1 /* SignalFlags.INVALID */;
+                const isSkippable = fastSkipSerialize(value.$untrackedValue$);
+                if (shouldAlwaysSerialize) {
+                    v = value.$untrackedValue$;
+                }
+                else if (shouldNeverSerialize) {
+                    v = NEEDS_COMPUTATION;
+                }
+                else if (isInvalid || isSkippable) {
+                    v = NEEDS_COMPUTATION;
+                }
                 addPreloadQrl(value.$computeQrl$);
-                const out = [
-                    value.$computeQrl$,
-                    // TODO check if we can use domVRef for effects
-                    value.$effects$,
-                ];
+                const out = [value.$computeQrl$, value.$effects$];
+                const isAsync = value instanceof AsyncComputedSignalImpl;
+                if (isAsync) {
+                    out.push(value.$loadingEffects$, value.$errorEffects$, value.$untrackedLoading$, value.$untrackedError$);
+                }
                 if (v !== NEEDS_COMPUTATION) {
                     out.push(v);
                 }
-                output(27 /* TypeIds.ComputedSignal */, out);
+                output(isAsync ? 28 /* TypeIds.AsyncComputedSignal */ : 27 /* TypeIds.ComputedSignal */, out);
             }
             else {
-                output(25 /* TypeIds.Signal */, [v, ...(value.$effects$ || [])]);
+                output(25 /* TypeIds.Signal */, [value.$untrackedValue$, ...(value.$effects$ || [])]);
             }
         }
         else if (value instanceof URL) {
@@ -9378,6 +9445,12 @@ async function serialize(serializationContext) {
             const out = btoa(buf).replace(/=+$/, '');
             output(19 /* TypeIds.Uint8Array */, out);
         }
+        else if (value instanceof SerializationWeakRef) {
+            const forwardRefId = forwardRefsId++;
+            s11nWeakRefs.set(value.$obj$, forwardRefId);
+            forwardRefs[forwardRefId] = -1;
+            output(1 /* TypeIds.ForwardRef */, forwardRefId);
+        }
         else if (vnode_isVNode(value)) {
             output(3 /* TypeIds.Constant */, 0 /* Constants.Undefined */);
         }
@@ -9401,21 +9474,20 @@ async function serialize(serializationContext) {
     }
     const outputRoots = async () => {
         $writer$.write('[');
-        let lastRootsLength = 0;
         let rootsLength = serializationContext.$roots$.length;
-        while (lastRootsLength < rootsLength || promises.size) {
-            if (lastRootsLength !== 0) {
+        while (rootIdx < rootsLength || promises.size) {
+            if (rootIdx !== 0) {
                 $writer$.write(',');
             }
             let separator = false;
-            for (let i = lastRootsLength; i < rootsLength; i++) {
+            for (; rootIdx < rootsLength; rootIdx++) {
                 if (separator) {
                     $writer$.write(',');
                 }
                 else {
                     separator = true;
                 }
-                writeValue(serializationContext.$roots$[i]);
+                writeValue(serializationContext.$roots$[rootIdx]);
             }
             if (promises.size) {
                 try {
@@ -9425,7 +9497,6 @@ async function serialize(serializationContext) {
                     // ignore rejections, they will be serialized as rejected promises
                 }
             }
-            lastRootsLength = rootsLength;
             rootsLength = serializationContext.$roots$.length;
         }
         if (forwardRefs.length) {
@@ -9731,7 +9802,7 @@ function shouldTrackObj(obj) {
     return (
     // THINK: Not sure if we need to keep track of functions (QRLs) Let's skip them for now.
     // and see if we have a test case which requires them.
-    (typeof obj === 'object' && obj !== null) ||
+    isObject(obj) ||
         /**
          * We track all strings greater than 1 character, because those take at least 6 bytes to encode
          * and even with 999 root objects it saves one byte per reference. Tracking more objects makes
@@ -9759,9 +9830,7 @@ function isResource(value) {
     return '__brand' in value && value.__brand === 'resource';
 }
 const frameworkType = (obj) => {
-    return ((typeof obj === 'object' &&
-        obj !== null &&
-        (obj instanceof SignalImpl || obj instanceof Task || isJSXNode(obj))) ||
+    return ((isObject(obj) && (obj instanceof SignalImpl || obj instanceof Task || isJSXNode(obj))) ||
         isQrl(obj));
 };
 const canSerialize = (value, seen = new WeakSet()) => {
@@ -9847,6 +9916,9 @@ const canSerialize = (value, seen = new WeakSet()) => {
             return true;
         }
     }
+    else if (value === _UNINITIALIZED) {
+        return true;
+    }
     return false;
 };
 const QRL_RUNTIME_CHUNK = 'mock-chunk';
@@ -9886,12 +9958,12 @@ const _typeIdNames = [
     'FormData',
     'JSXNode',
     'PropsProxy',
-    'EffectData',
+    'SubscriptionData',
 ];
 const circularProofJson = (obj, indent) => {
     const seen = new WeakSet();
-    return JSON.stringify(obj, (key, value) => {
-        if (typeof value === 'object' && value !== null) {
+    return JSON.stringify(obj, (_, value) => {
+        if (isObject(value)) {
             if (seen.has(value)) {
                 return `[Circular ${value.constructor.name}]`;
             }
@@ -9928,7 +10000,7 @@ const dumpState = (state, color = false, prefix = '', limit = 20) => {
         let value = state[++i];
         if (key === undefined) {
             hasRaw = true;
-            out.push(`${RED}[raw${typeof value === 'object' && value ? ` ${value.constructor.name}` : ''}]${RESET} ${printRaw(value, `${prefix}  `)}`);
+            out.push(`${RED}[raw${isObject(value) ? ` ${value.constructor.name}` : ''}]${RESET} ${printRaw(value, `${prefix}  `)}`);
         }
         else {
             if (key === 3 /* TypeIds.Constant */) {
@@ -10042,7 +10114,6 @@ const _verifySerializable = (value, seen, ctx, preMessage) => {
     return value;
 };
 const noSerializeSet = /*#__PURE__*/ new WeakSet();
-const weakSerializeSet = /*#__PURE__*/ new WeakSet();
 const shouldSerialize = (obj) => {
     if (isObject(obj) || isFunction(obj)) {
         return !noSerializeSet.has(obj);
@@ -10051,7 +10122,7 @@ const shouldSerialize = (obj) => {
 };
 const fastSkipSerialize = (obj) => {
     return (obj &&
-        (typeof obj === 'object' || typeof obj === 'function') &&
+        (isObject(obj) || typeof obj === 'function') &&
         (NoSerializeSymbol in obj || noSerializeSet.has(obj)));
 };
 // <docs markdown="../../readme.md#noSerialize">
@@ -10076,16 +10147,11 @@ const fastSkipSerialize = (obj) => {
 // </docs>
 const noSerialize = (input) => {
     // only add supported values to the noSerializeSet, prevent console errors
-    if ((typeof input === 'object' && input !== null) || typeof input === 'function') {
+    if ((isObject(input) && input !== null) || typeof input === 'function') {
         noSerializeSet.add(input);
     }
     return input;
 };
-/** @internal */
-const _weakSerialize = (input) => {
-    weakSerializeSet.add(input);
-    return input;
-};
 /**
  * If an object has this property, it will not be serialized. Use this on prototypes to avoid having
  * to call `noSerialize()` on every object.
@@ -11289,13 +11355,13 @@ const useConstant = (value) => {
     return set(value);
 };
 
-const useComputedCommon = (qrl, Class) => {
+const useComputedCommon = (qrl, createFn, options) => {
     const { val, set } = useSequentialScope();
     if (val) {
         return val;
     }
     assertQrl(qrl);
-    const signal = new Class(null, qrl);
+    const signal = createFn(qrl, options);
     set(signal);
     // Note that we first save the signal
     // and then we throw to load the qrl
@@ -11304,8 +11370,8 @@ const useComputedCommon = (qrl, Class) => {
     return signal;
 };
 /** @internal */
-const useComputedQrl = (qrl) => {
-    return useComputedCommon(qrl, ComputedSignalImpl);
+const useComputedQrl = (qrl, options) => {
+    return useComputedCommon(qrl, createComputedSignal, options);
 };
 /**
  * Creates a computed signal which is calculated from the given function. A computed signal is a
@@ -11320,7 +11386,7 @@ const useComputedQrl = (qrl) => {
 const useComputed$ = implicit$FirstArg(useComputedQrl);
 
 /** @internal */
-const useSerializerQrl = (qrl) => useComputedCommon(qrl, SerializerSignalImpl);
+const useSerializerQrl = (qrl) => useComputedCommon(qrl, createSerializerSignal);
 /**
  * Creates a signal which holds a custom serializable value. It requires that the value implements
  * the `CustomSerializable` type, which means having a function under the `[SerializeSymbol]`
@@ -11575,8 +11641,8 @@ const useTask$ = /*#__PURE__*/ implicit$FirstArg(useTaskQrl);
 const useVisibleTask$ = /*#__PURE__*/ implicit$FirstArg(useVisibleTaskQrl);
 
 /** @internal */
-const useAsyncComputedQrl = (qrl) => {
-    return useComputedCommon(qrl, AsyncComputedSignalImpl);
+const useAsyncComputedQrl = (qrl, options) => {
+    return useComputedCommon(qrl, createAsyncComputedSignal, options);
 };
 /**
  * Creates a computed signal which is calculated from the given function. A computed signal is a
@@ -11667,5 +11733,5 @@ const PREFETCH_CODE = /*#__PURE__*/ ((c // Service worker container
  */
 const PrefetchGraph = (_opts = {}) => null;
 
-export { $, Fragment, NoSerializeSymbol, PrefetchGraph, PrefetchServiceWorker, RenderOnce, Resource, SSRComment, SSRRaw, SSRStream, SSRStreamBlock, SerializerSymbol, SkipRender, Slot, _CONST_PROPS, DomContainer as _DomContainer, _EFFECT_BACK_REF, EMPTY_ARRAY as _EMPTY_ARRAY, _IMMUTABLE, _SharedContainer, SubscriptionData as _SubscriptionData, _VAR_PROPS, _deserialize, dumpState as _dumpState, _fnSignal, _getContextElement, _getContextEvent, getDomContainer as _getDomContainer, _getQContainerElement, isJSXNode as _isJSXNode, isStringifiable as _isStringifiable, _jsxBranch, _jsxC, _jsxQ, _jsxS, _jsxSorted, _jsxSplit, _noopQrl, _noopQrlDEV, preprocessState as _preprocessState, _qrlSync, _regSymbol, _restProps, queueQRL as _run, _serialize, scheduleTask as _task, verifySerializable as _verifySerializable, vnode_toString as _vnode_toString, _waitUntilRendered, _walkJSX, _weakSerialize, _wrapProp, _wrapSignal, _wrapStore, component$, componentQrl, createComputed$, createComputedSignal as createComputedQrl, createContextId, h as createElement, createSerializer$, createSerializerSignal as createSerializerQrl, createSignal, event$, eventQrl, getDomContainer, getLocale, getPlatform, h, implicit$FirstArg, inlinedQrl, inlinedQrlDEV, isSignal, jsx, jsxDEV, jsx as jsxs, noSerialize, qrl, qrlDEV, render, setPlatform, sync$, untrack, unwrapStore, useAsyncComputed$, useAsyncComputedQrl, useComputed$, useComputedQrl, useConstant, useContext, useContextProvider, useErrorBoundary, useId, useLexicalScope, useOn, useOnDocument, useOnWindow, useResource$, useResourceQrl, useSerializer$, useSerializerQrl, useServerData, useSignal, useStore, useStyles$, useStylesQrl, useStylesScoped$, useStylesScopedQrl, useTask$, useTaskQrl, useVisibleTask$, useVisibleTaskQrl, version, withLocale };
+export { $, Fragment, NoSerializeSymbol, PrefetchGraph, PrefetchServiceWorker, RenderOnce, Resource, SSRComment, SSRRaw, SSRStream, SSRStreamBlock, SerializerSymbol, SkipRender, Slot, _CONST_PROPS, DomContainer as _DomContainer, _EFFECT_BACK_REF, EMPTY_ARRAY as _EMPTY_ARRAY, _IMMUTABLE, _SharedContainer, SubscriptionData as _SubscriptionData, _UNINITIALIZED, _VAR_PROPS, _deserialize, dumpState as _dumpState, _fnSignal, _getContextContainer, _getContextElement, _getContextEvent, getDomContainer as _getDomContainer, _getQContainerElement, isJSXNode as _isJSXNode, isStringifiable as _isStringifiable, _jsxBranch, _jsxC, _jsxQ, _jsxS, _jsxSorted, _jsxSplit, _noopQrl, _noopQrlDEV, preprocessState as _preprocessState, _qrlSync, _regSymbol, _restProps, queueQRL as _run, _serializationWeakRef, _serialize, scheduleTask as _task, useInvokeContext as _useInvokeContext, verifySerializable as _verifySerializable, vnode_toString as _vnode_toString, _waitUntilRendered, _walkJSX, _wrapProp, _wrapSignal, component$, componentQrl, createAsyncComputed$, createAsyncComputedSignal as createAsyncComputedQrl, createComputed$, createComputedSignal as createComputedQrl, createContextId, h as createElement, createSerializer$, createSerializerSignal as createSerializerQrl, createSignal, event$, eventQrl, getDomContainer, getLocale, getPlatform, h, implicit$FirstArg, inlinedQrl, inlinedQrlDEV, isSignal, jsx, jsxDEV, jsx as jsxs, noSerialize, qrl, qrlDEV, render, setPlatform, sync$, untrack, unwrapStore, useAsyncComputed$, useAsyncComputedQrl, useComputed$, useComputedQrl, useConstant, useContext, useContextProvider, useErrorBoundary, useId, useLexicalScope, useOn, useOnDocument, useOnWindow, useResource$, useResourceQrl, useSerializer$, useSerializerQrl, useServerData, useSignal, useStore, useStyles$, useStylesQrl, useStylesScoped$, useStylesScopedQrl, useTask$, useTaskQrl, useVisibleTask$, useVisibleTaskQrl, version, withLocale };
 //# sourceMappingURL=core.mjs.map