Merge pull request #8126 from QwikDev/v2-async-computed-changes

feat: async computed changes

Author: wmertens

.changeset/deep-places-allow.md

@@ -0,0 +1,5 @@
+---
+'@qwik.dev/core': minor
+---
+
+feat: rename .resolve() to .promise()

.changeset/orange-planes-kiss.md

@@ -0,0 +1,5 @@
+---
+'@qwik.dev/core': minor
+---
+
+feat: change behavior of useAsyncComputed$ to throw only once

.changeset/petite-experts-press.md

@@ -0,0 +1,5 @@
+---
+'@qwik.dev/router': minor
+---
+
+feat: extend routeLoader$ signal type and eslint rule

packages/docs/src/routes/api/qwik-router/api.json

@@ -446,7 +446,7 @@
         }
       ],
       "kind": "TypeAlias",
-      "content": "```typescript\nexport type LoaderSignal<TYPE> = TYPE extends () => ValueOrPromise<infer VALIDATOR> ? ReadonlySignal<ValueOrPromise<VALIDATOR>> : ReadonlySignal<TYPE>;\n```",
+      "content": "```typescript\nexport type LoaderSignal<TYPE> = (TYPE extends () => ValueOrPromise<infer VALIDATOR> ? ReadonlySignal<ValueOrPromise<VALIDATOR>> : ReadonlySignal<TYPE>) & Pick<AsyncComputedReadonlySignal, 'promise' | 'loading' | 'error'>;\n```",
       "editUrl": "https://github.com/QwikDev/qwik/tree/main/packages/qwik-router/src/runtime/src/types.ts",
       "mdFile": "router.loadersignal.md"
     },

packages/docs/src/routes/api/qwik-router/index.mdx

@@ -1163,11 +1163,12 @@ export type Loader<RETURN> = {
 ## LoaderSignal
 
 ```typescript
-export type LoaderSignal<TYPE> = TYPE extends () => ValueOrPromise<
+export type LoaderSignal<TYPE> = (TYPE extends () => ValueOrPromise<
   infer VALIDATOR
 >
   ? ReadonlySignal<ValueOrPromise<VALIDATOR>>
-  : ReadonlySignal<TYPE>;
+  : ReadonlySignal<TYPE>) &
+  Pick<AsyncComputedReadonlySignal, "promise" | "loading" | "error">;
 ```
 
 [Edit this section](https://github.com/QwikDev/qwik/tree/main/packages/qwik-router/src/runtime/src/types.ts)

packages/docs/src/routes/api/qwik/api.json

@@ -244,7 +244,7 @@
         }
       ],
       "kind": "Interface",
-      "content": "```typescript\nexport interface AsyncComputedReadonlySignal<T = unknown> extends ComputedSignal<T> \n```\n**Extends:** [ComputedSignal](#computedsignal)<!-- -->&lt;T&gt;\n\n\n<table><thead><tr><th>\n\nProperty\n\n\n</th><th>\n\nModifiers\n\n\n</th><th>\n\nType\n\n\n</th><th>\n\nDescription\n\n\n</th></tr></thead>\n<tbody><tr><td>\n\n[error](#)\n\n\n</td><td>\n\n\n</td><td>\n\nError \\| null\n\n\n</td><td>\n\nThe error that occurred while computing the signal.\n\n\n</td></tr>\n<tr><td>\n\n[loading](#)\n\n\n</td><td>\n\n\n</td><td>\n\nboolean\n\n\n</td><td>\n\nWhether the signal is currently loading.\n\n\n</td></tr>\n</tbody></table>\n\n\n<table><thead><tr><th>\n\nMethod\n\n\n</th><th>\n\nDescription\n\n\n</th></tr></thead>\n<tbody><tr><td>\n\n[resolve()](#asynccomputedreadonlysignal-resolve)\n\n\n</td><td>\n\n\n</td></tr>\n</tbody></table>",
+      "content": "```typescript\nexport interface AsyncComputedReadonlySignal<T = unknown> extends ComputedSignal<T> \n```\n**Extends:** [ComputedSignal](#computedsignal)<!-- -->&lt;T&gt;\n\n\n<table><thead><tr><th>\n\nProperty\n\n\n</th><th>\n\nModifiers\n\n\n</th><th>\n\nType\n\n\n</th><th>\n\nDescription\n\n\n</th></tr></thead>\n<tbody><tr><td>\n\n[error](#)\n\n\n</td><td>\n\n\n</td><td>\n\nError \\| null\n\n\n</td><td>\n\nThe error that occurred while computing the signal.\n\n\n</td></tr>\n<tr><td>\n\n[loading](#)\n\n\n</td><td>\n\n\n</td><td>\n\nboolean\n\n\n</td><td>\n\nWhether the signal is currently loading.\n\n\n</td></tr>\n</tbody></table>\n\n\n<table><thead><tr><th>\n\nMethod\n\n\n</th><th>\n\nDescription\n\n\n</th></tr></thead>\n<tbody><tr><td>\n\n[promise()](#asynccomputedreadonlysignal-promise)\n\n\n</td><td>\n\nA promise that resolves when the value is computed.\n\n\n</td></tr>\n</tbody></table>",
       "editUrl": "https://github.com/QwikDev/qwik/tree/main/packages/qwik/src/core/reactive-primitives/signal.public.ts",
       "mdFile": "core.asynccomputedreadonlysignal.md"
     },
@@ -1255,6 +1255,23 @@
       "editUrl": "https://github.com/QwikDev/qwik/tree/main/packages/qwik/src/core/shared/prefetch-service-worker/prefetch.ts",
       "mdFile": "core.prefetchserviceworker.md"
     },
+    {
+      "name": "promise",
+      "id": "asynccomputedreadonlysignal-promise",
+      "hierarchy": [
+        {
+          "name": "AsyncComputedReadonlySignal",
+          "id": "asynccomputedreadonlysignal-promise"
+        },
+        {
+          "name": "promise",
+          "id": "asynccomputedreadonlysignal-promise"
+        }
+      ],
+      "kind": "MethodSignature",
+      "content": "A promise that resolves when the value is computed.\n\n\n```typescript\npromise(): Promise<T>;\n```\n**Returns:**\n\nPromise&lt;T&gt;",
+      "mdFile": "core.asynccomputedreadonlysignal.promise.md"
+    },
     {
       "name": "PropFunction",
       "id": "propfunction",
@@ -1801,23 +1818,6 @@
       "editUrl": "https://github.com/QwikDev/qwik/tree/main/packages/qwik/src/core/ssr/ssr-types.ts",
       "mdFile": "core.renderssroptions.md"
     },
-    {
-      "name": "resolve",
-      "id": "asynccomputedreadonlysignal-resolve",
-      "hierarchy": [
-        {
-          "name": "AsyncComputedReadonlySignal",
-          "id": "asynccomputedreadonlysignal-resolve"
-        },
-        {
-          "name": "resolve",
-          "id": "asynccomputedreadonlysignal-resolve"
-        }
-      ],
-      "kind": "MethodSignature",
-      "content": "```typescript\nresolve(): Promise<T>;\n```\n**Returns:**\n\nPromise&lt;T&gt;",
-      "mdFile": "core.asynccomputedreadonlysignal.resolve.md"
-    },
     {
       "name": "Resource",
       "id": "resource",

packages/docs/src/routes/api/qwik/index.mdx

@@ -196,10 +196,12 @@ Description
 </th></tr></thead>
 <tbody><tr><td>
 
-[resolve()](#asynccomputedreadonlysignal-resolve)
+[promise()](#asynccomputedreadonlysignal-promise)
 
 </td><td>
 
+A promise that resolves when the value is computed.
+
 </td></tr>
 </tbody></table>
 
@@ -2629,6 +2631,18 @@ opts
 
 [Edit this section](https://github.com/QwikDev/qwik/tree/main/packages/qwik/src/core/shared/prefetch-service-worker/prefetch.ts)
 
+## promise
+
+A promise that resolves when the value is computed.
+
+```typescript
+promise(): Promise<T>;
+```
+
+**Returns:**
+
+Promise&lt;T&gt;
+
 ## PropFunction
 
 Alias for `QRL<T>`. Of historic relevance only.
@@ -3700,16 +3714,6 @@ StreamWriter
 
 [Edit this section](https://github.com/QwikDev/qwik/tree/main/packages/qwik/src/core/ssr/ssr-types.ts)
 
-## resolve
-
-```typescript
-resolve(): Promise<T>;
-```
-
-**Returns:**
-
-Promise&lt;T&gt;
-
 ## Resource
 
 This method works like an async memoized function that runs whenever some tracked value changes and returns some data.