@vc-shell/framework 2.5.0-pr338.cf3c39c → 2.5.0-pr339.3f40f2e

package/dist/core/composables/useLatestRequest/index.d.ts

@@ -6,6 +6,25 @@ export interface LatestRequest {
     complete(): void;
 }
 export interface UseLatestRequestReturn {
+    /**
+     * Runs a request and hands back its result only while it is still the newest.
+     * A superseded request resolves to `undefined`, so the caller returns early
+     * instead of writing a stale answer:
+     *
+     * ```ts
+     * const result = await search.latest(client.searchProducts(criteria));
+     * if (!result) return;
+     * searchResult.value = result;
+     * ```
+     *
+     * This is `begin`/`isCurrent`/`complete` with the bookkeeping folded in —
+     * there is no `finally` to forget. Reach for `begin` directly only when the
+     * request and the check cannot sit in the same function.
+     *
+     * Rejections propagate untouched. `undefined` means superseded, so a request
+     * whose own successful result is `undefined` needs `begin` instead.
+     */
+    latest<T>(request: Promise<T>): Promise<T | undefined>;
     /** Starts a request and supersedes any earlier one. */
     begin(): LatestRequest;
     /** Supersedes the in-flight request without starting a new one — e.g. on selection change. */
@@ -23,17 +42,15 @@ export interface UseLatestRequestReturn {
  * const search = useLatestRequest();
  *
  * async function load(criteria) {
- *   const request = search.begin();
- *   try {
- *     const result = await api.search(criteria);
- *     if (!request.isCurrent()) return;   // a newer search won
- *     items.value = result;
- *   } finally {
- *     request.complete();
- *   }
+ *   const result = await search.latest(api.search(criteria));
+ *   if (!result) return;              // a newer search won
+ *   items.value = result;
  * }
  * ```
  *
+ * `begin` is the same thing with the bookkeeping exposed, for the cases where
+ * the request and the check cannot sit in the same function.
+ *
  * This discards the late result rather than cancelling the request: the
  * generated API clients build their own `RequestInit` and take no `AbortSignal`,
  * so there is nothing to cancel through. Aborting would additionally save the

package/dist/core/composables/useLatestRequest/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/composables/useLatestRequest/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkD,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAE/E,MAAM,WAAW,aAAa;IAC5B,2FAA2F;IAC3F,SAAS,IAAI,OAAO,CAAC;IACrB,0FAA0F;IAC1F,QAAQ,IAAI,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,uDAAuD;IACvD,KAAK,IAAI,aAAa,CAAC;IACvB,8FAA8F;IAC9F,UAAU,IAAI,IAAI,CAAC;IACnB,2FAA2F;IAC3F,OAAO,IAAI,IAAI,CAAC;IAChB,sDAAsD;IACtD,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,gBAAgB,IAAI,sBAAsB,CA2CzD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/composables/useLatestRequest/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkD,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAE/E,MAAM,WAAW,aAAa;IAC5B,2FAA2F;IAC3F,SAAS,IAAI,OAAO,CAAC;IACrB,0FAA0F;IAC1F,QAAQ,IAAI,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IACvD,uDAAuD;IACvD,KAAK,IAAI,aAAa,CAAC;IACvB,8FAA8F;IAC9F,UAAU,IAAI,IAAI,CAAC;IACnB,2FAA2F;IAC3F,OAAO,IAAI,IAAI,CAAC;IAChB,sDAAsD;IACtD,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gBAAgB,IAAI,sBAAsB,CAsDzD"}

package/dist/framework.js

@@ -752,25 +752,35 @@ function Il() {
   const e = b(!1);
   let t = 0, a = !1;
   function n() {
-    const r = ++t;
-    let l = !1;
+    const l = ++t;
+    let c = !1;
     return a || (e.value = !0), {
-      isCurrent: () => !a && r === t,
+      isCurrent: () => !a && l === t,
       complete: () => {
-        l || (l = !0, !a && r === t && (e.value = !1));
+        c || (c = !0, !a && l === t && (e.value = !1));
       }
     };
   }
-  function s() {
-    t++, e.value = !1;
+  async function s(l) {
+    const c = n();
+    try {
+      const u = await l;
+      return c.isCurrent() ? u : void 0;
+    } finally {
+      c.complete();
+    }
   }
   function o() {
-    a = !0, s();
+    t++, e.value = !1;
+  }
+  function r() {
+    a = !0, o();
   }
-  return rt() && it(o), {
+  return rt() && it(r), {
+    latest: s,
     begin: n,
-    invalidate: s,
-    dispose: o,
+    invalidate: o,
+    dispose: r,
     pending: Me(e)
   };
 }
@@ -2121,12 +2131,12 @@ function xo() {
     hasNotification: (t) => e.hasNotification(t)
   });
 }
-const $o = "2.5.0-pr338.cf3c39c";
+const $o = "2.5.0-pr339.3f40f2e";
 function Ko() {
   return {
     version: $o,
-    buildDate: "2026-08-31T16:21:04.502Z",
-    gitHash: "cf3c39cf0"
+    buildDate: "2026-09-01T06:36:03.116Z",
+    gitHash: "3f40f2eb0"
   };
 }
 function zo(e = Ko()) {