@fluixi/reactive 1.0.0-alpha.82 → 1.0.0-alpha.84

package/dist/lib/signal/cached-resource.d.ts

@@ -1,9 +1,21 @@
 /**
- * createCachedResource — reactive resource with TTL-based caching.
+ * createCachedResource: a reactive resource with TTL-based caching.
  *
  * Fetches once and returns the cached result for subsequent reads within the
  * TTL window. After the TTL expires the next read triggers a re-fetch.
  *
+ * It runs on the live graph, as of this change. It used to build on `./signal.js`,
+ * which tracks its current consumer in a module-level `Listener` while everything on
+ * the default entry tracks through `G.consumer`. The two never saw each other, so
+ * `createEffect(() => data())` subscribed to nothing and a binding kept whatever it
+ * first rendered, which on an initial load is the loading state. `cross-graph.spec.ts`
+ * holds the general shape of that hazard; this file is no longer an instance of it.
+ *
+ * Suspense needs no bookkeeping here. The accessor throws the pending promise and the
+ * runtime's suspend handler finds the nearest boundary from the effect that was
+ * reading, which is what `graph/resource.ts` relies on too. The manual increment and
+ * decrement against a lazily-resolved context went with the port.
+ *
  * Two forms (mirrors createResource):
  *
  *   // 1. no reactive source
@@ -20,27 +32,27 @@
  *   );
  *
  * Options:
- *   ttl                  — cache lifetime in ms. Default: Infinity (manual invalidate only)
- *   name                 — cache namespace. If omitted, each call-site gets its own isolated cache.
- *   staleWhileRevalidate — when true (default), show stale data while background-fetching.
+ *   ttl: cache lifetime in ms. Default: Infinity (manual invalidate only)
+ *   name: cache namespace. If omitted, each call-site gets its own isolated cache.
+ *   staleWhileRevalidate, when true (default), show stale data while background-fetching.
  *                          When false, show a loading state during revalidation.
  *
  * Resource shape (same as createResource):
- *   data()        — current value (throws pending promise during initial load for Suspense)
- *   data.loading  — true during initial load
- *   data.latest   — value without throwing
- *   data.error    — last error
- *   data.stale    — true when showing stale data during background revalidation
+ *   data(): current value (throws pending promise during initial load for Suspense)
+ *   data.loading: true during initial load
+ *   data.latest: value without throwing
+ *   data.error: last error
+ *   data.stale: true when showing stale data during background revalidation
  *
  * Actions:
- *   refetch()     — force re-fetch regardless of TTL, keeps showing current value while loading
- *   invalidate()  — delete cache entry and re-fetch (shows loading on next read)
+ *   refetch(): force re-fetch regardless of TTL, keeps showing current value while loading
+ *   invalidate(): delete cache entry and re-fetch (shows loading on next read)
  */
-import { type Setter, type Resource } from './signal.js';
+import type { Setter, Resource } from './signal.js';
 export interface CachedResourceOptions {
     /**
      * Cache lifetime in milliseconds.
-     * Default: `Infinity` — data lives until `invalidate()` is called.
+     * Default: `Infinity`, data lives until `invalidate()` is called.
      */
     ttl?: number;
     /**
@@ -52,7 +64,7 @@ export interface CachedResourceOptions {
     /**
      * When `true` (default), stale data is returned immediately while a
      * background re-fetch runs. The resource stays in `state='ready'` and
-     * `stale=true` during revalidation — no loading skeleton.
+     * `stale=true` during revalidation, no loading skeleton.
      *
      * When `false`, a foreground re-fetch is triggered that sets
      * `state='refreshing'` (data is still visible but `loading=true`).
@@ -74,11 +86,11 @@ export type CachedResourceReturn<T> = [
     }
 ];
 /**
- * No-source overload — fetch is not keyed by any reactive value.
+ * No-source overload: fetch is not keyed by any reactive value.
  */
 export declare function createCachedResource<T>(fetcher: () => Promise<T> | T, options?: CachedResourceOptions): CachedResourceReturn<T>;
 /**
- * With-source overload — fetch re-runs whenever the source accessor returns a
+ * With-source overload: fetch re-runs whenever the source accessor returns a
  * new value (falsy source suspends the fetch, same as `createResource`).
  */
 export declare function createCachedResource<T, S>(source: () => S | false | null | undefined, fetcher: (key: S) => Promise<T> | T, options?: CachedResourceOptions): CachedResourceReturn<T>;

package/dist/lib/signal/cached-resource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cached-resource.d.ts","sourceRoot":"","sources":["../../../src/lib/signal/cached-resource.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,EASL,KAAK,MAAM,EACX,KAAK,QAAQ,EAEd,MAAM,aAAa,CAAC;AAgBrB,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;OAOG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,GAAG;IAC5C,oEAAoE;IACpE,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI;IACpC,cAAc,CAAC,CAAC,CAAC;IACjB;QACE,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;QAC9B,kEAAkE;QAClE,OAAO,EAAE,MAAM,IAAI,CAAC;QACpB,4EAA4E;QAC5E,UAAU,EAAE,MAAM,IAAI,CAAC;KACxB;CACF,CAAC;AAQF;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EAC7B,OAAO,CAAC,EAAE,qBAAqB,GAC9B,oBAAoB,CAAC,CAAC,CAAC,CAAC;AAE3B;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,CAAC,EACvC,MAAM,EAAE,MAAM,CAAC,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,EAC1C,OAAO,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EACnC,OAAO,CAAC,EAAE,qBAAqB,GAC9B,oBAAoB,CAAC,CAAC,CAAC,CAAC;AAoP3B;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAK/D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAG9C"}
+{"version":3,"file":"cached-resource.d.ts","sourceRoot":"","sources":["../../../src/lib/signal/cached-resource.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAYH,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAiB,MAAM,aAAa,CAAC;AAgBnE,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;OAOG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,GAAG;IAC5C,oEAAoE;IACpE,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI;IACpC,cAAc,CAAC,CAAC,CAAC;IACjB;QACE,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;QAC9B,kEAAkE;QAClE,OAAO,EAAE,MAAM,IAAI,CAAC;QACpB,4EAA4E;QAC5E,UAAU,EAAE,MAAM,IAAI,CAAC;KACxB;CACF,CAAC;AAUF;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EAC7B,OAAO,CAAC,EAAE,qBAAqB,GAC9B,oBAAoB,CAAC,CAAC,CAAC,CAAC;AAE3B;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,CAAC,EACvC,MAAM,EAAE,MAAM,CAAC,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,EAC1C,OAAO,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EACnC,OAAO,CAAC,EAAE,qBAAqB,GAC9B,oBAAoB,CAAC,CAAC,CAAC,CAAC;AAwO3B;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAK/D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAG9C"}

package/dist/lib/signal/cached-resource.js

@@ -1,9 +1,21 @@
 /**
- * createCachedResource — reactive resource with TTL-based caching.
+ * createCachedResource: a reactive resource with TTL-based caching.
  *
  * Fetches once and returns the cached result for subsequent reads within the
  * TTL window. After the TTL expires the next read triggers a re-fetch.
  *
+ * It runs on the live graph, as of this change. It used to build on `./signal.js`,
+ * which tracks its current consumer in a module-level `Listener` while everything on
+ * the default entry tracks through `G.consumer`. The two never saw each other, so
+ * `createEffect(() => data())` subscribed to nothing and a binding kept whatever it
+ * first rendered, which on an initial load is the loading state. `cross-graph.spec.ts`
+ * holds the general shape of that hazard; this file is no longer an instance of it.
+ *
+ * Suspense needs no bookkeeping here. The accessor throws the pending promise and the
+ * runtime's suspend handler finds the nearest boundary from the effect that was
+ * reading, which is what `graph/resource.ts` relies on too. The manual increment and
+ * decrement against a lazily-resolved context went with the port.
+ *
  * Two forms (mirrors createResource):
  *
  *   // 1. no reactive source
@@ -20,27 +32,31 @@
  *   );
  *
  * Options:
- *   ttl                  — cache lifetime in ms. Default: Infinity (manual invalidate only)
- *   name                 — cache namespace. If omitted, each call-site gets its own isolated cache.
- *   staleWhileRevalidate — when true (default), show stale data while background-fetching.
+ *   ttl: cache lifetime in ms. Default: Infinity (manual invalidate only)
+ *   name: cache namespace. If omitted, each call-site gets its own isolated cache.
+ *   staleWhileRevalidate, when true (default), show stale data while background-fetching.
  *                          When false, show a loading state during revalidation.
  *
  * Resource shape (same as createResource):
- *   data()        — current value (throws pending promise during initial load for Suspense)
- *   data.loading  — true during initial load
- *   data.latest   — value without throwing
- *   data.error    — last error
- *   data.stale    — true when showing stale data during background revalidation
+ *   data(): current value (throws pending promise during initial load for Suspense)
+ *   data.loading: true during initial load
+ *   data.latest: value without throwing
+ *   data.error: last error
+ *   data.stale: true when showing stale data during background revalidation
  *
  * Actions:
- *   refetch()     — force re-fetch regardless of TTL, keeps showing current value while loading
- *   invalidate()  — delete cache entry and re-fetch (shows loading on next read)
+ *   refetch(): force re-fetch regardless of TTL, keeps showing current value while loading
+ *   invalidate(): delete cache entry and re-fetch (shows loading on next read)
  */
-import { createSignal, createEffect, onCleanup, batch, untrack, useContext, getSuspenseContext, trackResourcePromise, } from './signal.js';
+import { createSignal, createEffect, onCleanup, batch, untrack, } from './graph/compat.js';
+// Graph-agnostic SSR hooks, the same ones graph/resource.ts uses.
+import { trackResourcePromise } from './graph/ssr-hooks.js';
 const ttlCache = new Map();
 const inflight = new Map();
 let _autoId = 0;
-// ── Symbol constants (must match signal.ts) ───────────────────────────────────
+// ── Brand symbols ─────────────────────────────────────────────────────────────
+// Registry symbols, so every copy of every graph agrees on them without importing
+// anything. graph/resource.ts stamps a resource with the same two.
 const $SIGNAL = Symbol.for('signal');
 const $RESOURCE = Symbol.for('resource');
 export function createCachedResource(sourceOrFetcher, fetcherOrOptions, opts = {}) {
@@ -54,7 +70,7 @@ export function createCachedResource(sourceOrFetcher, fetcherOrOptions, opts = {
         options = opts;
     }
     else {
-        // No source — treat the first arg as fetcher, source = () => true
+        // No source: treat the first arg as fetcher, source = () => true
         sourceFn = () => true;
         fetchFn = sourceOrFetcher;
         options = fetcherOrOptions ?? opts;
@@ -97,12 +113,9 @@ export function createCachedResource(sourceOrFetcher, fetcherOrOptions, opts = {
         if (!background) {
             trackResourcePromise(promise); // server async SSR: collect & await
             setPendingP(promise);
-            // Register with nearest Suspense boundary for initial loads.
-            const suspCtx = _SuspenseContext && useContext(_SuspenseContext);
-            if (suspCtx) {
-                suspCtx.increment();
-                promise.finally(() => suspCtx.decrement());
-            }
+            // No boundary bookkeeping here. The accessor throws the pending promise, and
+            // the runtime's suspend handler finds the nearest boundary from the effect that
+            // was reading. graph/resource.ts leaves it to the same path.
         }
         promise.then((v) => { if (!isCancelled())
             settle(v, background); }, (e) => { if (!isCancelled() && !background)
@@ -124,15 +137,8 @@ export function createCachedResource(sourceOrFetcher, fetcherOrOptions, opts = {
             setPendingP(undefined);
         });
     }
-    // ── Suspense context (lazy, avoid module-init order issues) ───────────────
-    let _SuspenseContext;
     // ── Main effect ───────────────────────────────────────────────────────────
     createEffect(() => {
-        // Lazily grab the suspense context the first time the effect runs,
-        // so it's looked up in the correct component Owner scope.
-        if (_SuspenseContext === undefined) {
-            _SuspenseContext = getSuspenseContext();
-        }
         const key = sourceFn();
         tick(); // track manual triggers
         // Suspend fetch when source is falsy (mirrors createResource)
@@ -160,7 +166,7 @@ export function createCachedResource(sourceOrFetcher, fetcherOrOptions, opts = {
         const cached = ttlCache.get(ck);
         // ── Cache HIT (fresh) ─────────────────────────────────────────────────
         if (cached && isFresh(cached) && !doRefetch && !doInvalidate) {
-            // Serve synchronously — no loading state, no fetch.
+            // Serve synchronously, no loading state, no fetch.
             const cur = untrack(resourceState);
             if (cur !== 'ready' || untrack(value) !== cached.value) {
                 batch(() => {
@@ -197,7 +203,7 @@ export function createCachedResource(sourceOrFetcher, fetcherOrOptions, opts = {
         doFetch(key, ck, false /* foreground */, () => cancelled);
     });
     // ── Resource accessor ─────────────────────────────────────────────────────
-    // During 'pending': throw the pending promise → Suspense shows skeleton.
+    // During 'pending': throw the pending promise -> Suspense shows skeleton.
     // During 'refreshing': return stale value (no Suspense regression).
     // During 'ready'/'errored': return value or throw error.
     const resource = (() => {