@fluixi/reactive 1.0.0-alpha.91 → 1.0.0-alpha.93

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

@@ -1,65 +1,38 @@
 /**
- * createCachedResource: a reactive resource with TTL-based caching.
+ * `cachedResource`: a resource whose results are kept, by key, for a TTL.
  *
- * 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.
+ * Fetches once and serves the cached result to later reads within the TTL; after it, the
+ * next read fetches again, showing the stale value meanwhile unless `staleWhileRevalidate`
+ * is off. Readers of the same key share one request in flight.
  *
- * 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.
+ *   const workspace = cachedResource(workspaceId, (id) => api.get(`/workspaces/${id}`), {
+ *     name: 'workspace',
+ *     ttl: 5 * 60_000,
+ *   });
+ *   workspace();            // the value; suspends under <Suspense> on the first load
+ *   workspace.stale;        // true while a background refetch runs
+ *   workspace.invalidate(); // drop the entry and fetch again
  *
- * 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.
+ * Where entries live is the cache's business (`ResourceCache`). By default: one cache per
+ * request on the server, so visitors never share an entry or an in-flight fetch; the page in
+ * a browser. Pass `cache` to keep them elsewhere, for instance a storage that survives a reload.
  *
- * Two forms (mirrors createResource):
+ * A value fetched during the server render travels to the browser with the page, like a
+ * plain resource's, and seeds the first read there instead of a second fetch.
  *
- *   // 1. no reactive source
- *   const [data, { refetch, invalidate }] = createCachedResource(
- *     () => apiClient.get('/data'),
- *     { ttl: 5 * 60_000, name: 'my-data' }
- *   );
- *
- *   // 2. reactive source (re-fetches when source value changes)
- *   const [data, { refetch, invalidate }] = createCachedResource(
- *     () => workspaceId(),
- *     (id) => apiClient.get(`/workspaces/${id}`),
- *     { ttl: 5 * 60_000, name: 'workspace' }
- *   );
- *
- * 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.
- *                          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
- *
- * 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)
+ * It runs on the live graph. Suspense needs no bookkeeping here: the accessor throws the
+ * pending promise and the runtime finds the nearest boundary from the reading effect.
  */
 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();
+import { currentResourceCache, getServerData, nextResourceId, reportResourceData, trackResourcePromise, } from './graph/ssr-hooks.js';
 let _autoId = 0;
 // ── 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 = {}) {
+export function cachedResource(sourceOrFetcher, fetcherOrOptions, opts = {}) {
     // ── Normalise overloads ──────────────────────────────────────────────────
     let sourceFn;
     let fetchFn;
@@ -77,7 +50,15 @@ export function createCachedResource(sourceOrFetcher, fetcherOrOptions, opts = {
     }
     const { ttl = Infinity, name = `_auto_${_autoId++}`, staleWhileRevalidate = true, } = options;
     const ns = name;
-    const buildKey = (key) => `${ns}:${JSON.stringify(key)}`;
+    const cache = options.cache ?? currentResourceCache();
+    const inflight = cache.inflight;
+    // The same transport as a plain resource: an id in creation order, matched on both sides.
+    const ssrId = options.transport === false ? undefined : nextResourceId();
+    const seed = ssrId !== undefined ? getServerData(ssrId) : undefined;
+    const deps = options.deps ?? [];
+    // Tracked inside the effect, untracked from invalidate().
+    const depValues = () => deps.map((dep) => dep());
+    const buildKey = (key, values = untrack(depValues)) => `${ns}:${JSON.stringify(key)}` + (deps.length ? `:${JSON.stringify(values)}` : '');
     const isFresh = (entry) => ttl === Infinity || Date.now() - entry.timestamp <= ttl;
     // ── Reactive state ────────────────────────────────────────────────────────
     const [value, setValue] = createSignal(undefined, { equals: false });
@@ -93,16 +74,19 @@ export function createCachedResource(sourceOrFetcher, fetcherOrOptions, opts = {
     // ── Fetch helper ──────────────────────────────────────────────────────────
     function doFetch(key, ck, background, isCancelled) {
         // Attach to an in-flight request for the same key (dedup).
-        if (inflight.has(ck)) {
-            inflight.get(ck).then((v) => { if (!isCancelled())
+        const running = inflight.get(ck);
+        if (running) {
+            running.then((v) => { if (!isCancelled())
                 settle(v, background); }, (e) => { if (!isCancelled() && !background)
                 fail(e); });
-            if (!background)
-                setPendingP(inflight.get(ck));
+            if (!background) {
+                trackResourcePromise(running);
+                setPendingP(running);
+            }
             return;
         }
         const promise = Promise.resolve(fetchFn(key)).then((v) => {
-            ttlCache.set(ck, { value: v, timestamp: Date.now() });
+            cache.set(ck, { value: v, timestamp: Date.now() });
             inflight.delete(ck);
             return v;
         }, (e) => {
@@ -121,7 +105,9 @@ export function createCachedResource(sourceOrFetcher, fetcherOrOptions, opts = {
             settle(v, background); }, (e) => { if (!isCancelled() && !background)
             fail(e); });
     }
-    function settle(v, background) {
+    function settle(v, _background) {
+        if (ssrId !== undefined)
+            reportResourceData(ssrId, v); // serialize for hydration
         batch(() => {
             setValue(() => v);
             setResourceState('ready');
@@ -140,6 +126,7 @@ export function createCachedResource(sourceOrFetcher, fetcherOrOptions, opts = {
     // ── Main effect ───────────────────────────────────────────────────────────
     createEffect(() => {
         const key = sourceFn();
+        const values = depValues();
         tick(); // track manual triggers
         // Suspend fetch when source is falsy (mirrors createResource)
         if (key === false || key === null || key === undefined) {
@@ -155,18 +142,23 @@ export function createCachedResource(sourceOrFetcher, fetcherOrOptions, opts = {
         const doInvalidate = flagInvalidate;
         flagRefetch = false;
         flagInvalidate = false;
-        const ck = buildKey(key);
+        const ck = buildKey(key, values);
+        // A value the server fetched for this page: the first read takes it as fresh.
+        if (seed && prevKey === UNSET && !cache.get(ck))
+            cache.set(ck, { value: seed.value, timestamp: Date.now() });
         // Clear cache on explicit invalidate
         if (doInvalidate)
-            ttlCache.delete(ck);
+            cache.delete(ck);
         const keyChanged = prevKey === UNSET || key !== prevKey;
         prevKey = key;
         let cancelled = false;
         onCleanup(() => { cancelled = true; });
-        const cached = ttlCache.get(ck);
+        const cached = cache.get(ck);
         // ── Cache HIT (fresh) ─────────────────────────────────────────────────
         if (cached && isFresh(cached) && !doRefetch && !doInvalidate) {
             // Serve synchronously, no loading state, no fetch.
+            if (ssrId !== undefined)
+                reportResourceData(ssrId, cached.value);
             const cur = untrack(resourceState);
             if (cur !== 'ready' || untrack(value) !== cached.value) {
                 batch(() => {
@@ -235,29 +227,24 @@ export function createCachedResource(sourceOrFetcher, fetcherOrOptions, opts = {
     const invalidate = () => {
         const key = untrack(sourceFn);
         if (key !== null && key !== undefined && key !== false) {
-            ttlCache.delete(buildKey(key));
+            cache.delete(buildKey(key));
         }
         flagInvalidate = true;
         setTick(v => v + 1);
     };
-    return [resource, { mutate: setValue, refetch, invalidate }];
+    return Object.assign(resource, { mutate: setValue, refetch, invalidate });
 }
 // ── Cache utilities ────────────────────────────────────────────────────────────
 /**
- * Clear all TTL cache entries for a given namespace (name).
- * Useful to invalidate a whole category of data at once.
+ * Drops cached entries in the current scope: those of one `name`, or all of them. On a
+ * logout or a workspace switch, so nothing fetched for the previous one is served.
  */
-export function clearCachedResourceNamespace(name) {
+export function clearCachedResources(name, cache = currentResourceCache()) {
+    if (name === undefined)
+        return cache.clear();
     const prefix = `${name}:`;
-    for (const key of ttlCache.keys()) {
+    for (const key of [...cache.keys()])
         if (key.startsWith(prefix))
-            ttlCache.delete(key);
-    }
-}
-/**
- * Clear the entire TTL cache. Useful on logout / workspace switch.
- */
-export function clearAllCachedResources() {
-    ttlCache.clear();
-    inflight.clear();
+            cache.delete(key);
 }
+export { createResourceCache } from './graph/ssr-hooks.js';

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

@@ -1,7 +1,7 @@
-/*! @fluixi/reactive v1.0.0-alpha.91 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/reactive v1.0.0-alpha.93 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 
 // src/version.generated.ts
-var VERSION = "1.0.0-alpha.91";
+var VERSION = "1.0.0-alpha.93";
 
 // src/lib/signal/graph/state.ts
 var MAJOR = VERSION.split(".")[0];
@@ -51,11 +51,12 @@ function observeReactiveNodes(next) {
 }
 var running = [];
 var origin;
+var currentScope;
 function reportReactiveNode(report) {
   const observer = G.observer;
   if (observer) {
     observer.created(
-      report.parents === void 0 ? { ...report, parents: running, origin: report.origin ?? origin } : report
+      report.parents === void 0 ? { ...report, parents: running, origin: report.origin ?? origin, scope: report.scope ?? currentScope } : { ...report, scope: report.scope ?? currentScope }
     );
   }
 }
@@ -349,7 +350,7 @@ function batch(fn) {
   }
 }
 var EffectNode = class {
-  constructor(fn, report = false) {
+  constructor(fn, report = false, name) {
     this.queued = false;
     this.disposed = false;
     this.owner = makeOwner(G.owner);
@@ -361,7 +362,7 @@ var EffectNode = class {
         if (typeof r === "function") (this.owner.cleanups ??= []).push(r);
       });
     });
-    reportReactiveNode({ kind: "effect", node: this.computed, handle: this, internal: !report });
+    reportReactiveNode({ kind: "effect", node: this.computed, handle: this, internal: !report, ...name ? { name } : {} });
     this.watcher = new Watcher(() => enqueue(this));
     this.run();
     this.watcher.watch(this.computed);
@@ -388,8 +389,8 @@ var EffectNode = class {
     disposeOwner(this.owner);
   }
 };
-function effect(fn, report = false) {
-  const node = new EffectNode(fn, report);
+function effect(fn, report = false, name) {
+  const node = new EffectNode(fn, report, name);
   return () => node.dispose();
 }
 
@@ -429,12 +430,12 @@ function createSignal(value, options) {
   if (isObserved()) onCleanup(() => reportReactiveDispose(state));
   return [read, write];
 }
-function createEffect(fn, value) {
+function createEffect(fn, value, options) {
   let prev = value;
   return effect(() => {
     const r = fn(prev);
     prev = r;
-  }, true);
+  }, true, options?.name);
 }
 function batch2(fn) {
   return batch(fn);
@@ -448,14 +449,47 @@ var _resourceTracker = null;
 function trackResourcePromise(p) {
   if (_resourceTracker) _resourceTracker(p);
 }
+var _serverDataGetter = null;
+function getServerData(id) {
+  return _serverDataGetter ? _serverDataGetter(id) : void 0;
+}
+var _resourceIdSource = null;
+function nextResourceId() {
+  return _resourceIdSource ? _resourceIdSource() : void 0;
+}
+var _resourceDataSink = null;
+function reportResourceData(id, value) {
+  if (_resourceDataSink) _resourceDataSink(id, value);
+}
+function createResourceCache() {
+  const entries = /* @__PURE__ */ new Map();
+  const inflight = /* @__PURE__ */ new Map();
+  return {
+    get: (key) => entries.get(key),
+    set: (key, entry) => void entries.set(key, entry),
+    delete: (key) => void entries.delete(key),
+    keys: () => entries.keys(),
+    clear: () => {
+      entries.clear();
+      inflight.clear();
+    },
+    inflight
+  };
+}
+var _cacheScope = null;
+var _pageCache;
+function currentResourceCache() {
+  const scoped = _cacheScope?.();
+  if (scoped) return scoped;
+  if (typeof window === "undefined") return createResourceCache();
+  return _pageCache ??= createResourceCache();
+}
 
 // src/lib/signal/cached-resource.ts
-var ttlCache = /* @__PURE__ */ new Map();
-var inflight = /* @__PURE__ */ new Map();
 var _autoId = 0;
 var $SIGNAL2 = /* @__PURE__ */ Symbol.for("signal");
 var $RESOURCE = /* @__PURE__ */ Symbol.for("resource");
-function createCachedResource(sourceOrFetcher, fetcherOrOptions, opts = {}) {
+function cachedResource(sourceOrFetcher, fetcherOrOptions, opts = {}) {
   let sourceFn;
   let fetchFn;
   let options;
@@ -474,7 +508,13 @@ function createCachedResource(sourceOrFetcher, fetcherOrOptions, opts = {}) {
     staleWhileRevalidate = true
   } = options;
   const ns = name;
-  const buildKey = (key) => `${ns}:${JSON.stringify(key)}`;
+  const cache = options.cache ?? currentResourceCache();
+  const inflight = cache.inflight;
+  const ssrId = options.transport === false ? void 0 : nextResourceId();
+  const seed = ssrId !== void 0 ? getServerData(ssrId) : void 0;
+  const deps = options.deps ?? [];
+  const depValues = () => deps.map((dep) => dep());
+  const buildKey = (key, values = untrack2(depValues)) => `${ns}:${JSON.stringify(key)}` + (deps.length ? `:${JSON.stringify(values)}` : "");
   const isFresh = (entry) => ttl === Infinity || Date.now() - entry.timestamp <= ttl;
   const [value, setValue] = createSignal(void 0, { equals: false });
   const [resourceState, setResourceState] = createSignal("unresolved", { equals: false });
@@ -487,8 +527,9 @@ function createCachedResource(sourceOrFetcher, fetcherOrOptions, opts = {}) {
   let flagRefetch = false;
   let flagInvalidate = false;
   function doFetch(key, ck, background, isCancelled) {
-    if (inflight.has(ck)) {
-      inflight.get(ck).then(
+    const running2 = inflight.get(ck);
+    if (running2) {
+      running2.then(
         (v) => {
           if (!isCancelled()) settle(v, background);
         },
@@ -496,12 +537,15 @@ function createCachedResource(sourceOrFetcher, fetcherOrOptions, opts = {}) {
           if (!isCancelled() && !background) fail(e);
         }
       );
-      if (!background) setPendingP(inflight.get(ck));
+      if (!background) {
+        trackResourcePromise(running2);
+        setPendingP(running2);
+      }
       return;
     }
     const promise = Promise.resolve(fetchFn(key)).then(
       (v) => {
-        ttlCache.set(ck, { value: v, timestamp: Date.now() });
+        cache.set(ck, { value: v, timestamp: Date.now() });
         inflight.delete(ck);
         return v;
       },
@@ -524,7 +568,8 @@ function createCachedResource(sourceOrFetcher, fetcherOrOptions, opts = {}) {
       }
     );
   }
-  function settle(v, background) {
+  function settle(v, _background) {
+    if (ssrId !== void 0) reportResourceData(ssrId, v);
     batch2(() => {
       setValue(() => v);
       setResourceState("ready");
@@ -542,6 +587,7 @@ function createCachedResource(sourceOrFetcher, fetcherOrOptions, opts = {}) {
   }
   createEffect(() => {
     const key = sourceFn();
+    const values = depValues();
     tick();
     if (key === false || key === null || key === void 0) {
       prevKey = UNSET;
@@ -556,16 +602,18 @@ function createCachedResource(sourceOrFetcher, fetcherOrOptions, opts = {}) {
     const doInvalidate = flagInvalidate;
     flagRefetch = false;
     flagInvalidate = false;
-    const ck = buildKey(key);
-    if (doInvalidate) ttlCache.delete(ck);
+    const ck = buildKey(key, values);
+    if (seed && prevKey === UNSET && !cache.get(ck)) cache.set(ck, { value: seed.value, timestamp: Date.now() });
+    if (doInvalidate) cache.delete(ck);
     const keyChanged = prevKey === UNSET || key !== prevKey;
     prevKey = key;
     let cancelled = false;
     onCleanup(() => {
       cancelled = true;
     });
-    const cached = ttlCache.get(ck);
+    const cached = cache.get(ck);
     if (cached && isFresh(cached) && !doRefetch && !doInvalidate) {
+      if (ssrId !== void 0) reportResourceData(ssrId, cached.value);
       const cur2 = untrack2(resourceState);
       if (cur2 !== "ready" || untrack2(value) !== cached.value) {
         batch2(() => {
@@ -626,25 +674,20 @@ function createCachedResource(sourceOrFetcher, fetcherOrOptions, opts = {}) {
   const invalidate = () => {
     const key = untrack2(sourceFn);
     if (key !== null && key !== void 0 && key !== false) {
-      ttlCache.delete(buildKey(key));
+      cache.delete(buildKey(key));
     }
     flagInvalidate = true;
     setTick((v) => v + 1);
   };
-  return [resource, { mutate: setValue, refetch, invalidate }];
+  return Object.assign(resource, { mutate: setValue, refetch, invalidate });
 }
-function clearCachedResourceNamespace(name) {
+function clearCachedResources(name, cache = currentResourceCache()) {
+  if (name === void 0) return cache.clear();
   const prefix = `${name}:`;
-  for (const key of ttlCache.keys()) {
-    if (key.startsWith(prefix)) ttlCache.delete(key);
-  }
-}
-function clearAllCachedResources() {
-  ttlCache.clear();
-  inflight.clear();
+  for (const key of [...cache.keys()]) if (key.startsWith(prefix)) cache.delete(key);
 }
 export {
-  clearAllCachedResources,
-  clearCachedResourceNamespace,
-  createCachedResource
+  cachedResource,
+  clearCachedResources,
+  createResourceCache
 };

package/dist/lib/signal/graph/children.cjs

@@ -25,7 +25,7 @@ __export(children_exports, {
 module.exports = __toCommonJS(children_exports);
 
 // src/version.generated.ts
-var VERSION = "1.0.0-alpha.91";
+var VERSION = "1.0.0-alpha.93";
 
 // src/lib/signal/graph/state.ts
 var MAJOR = VERSION.split(".")[0];
@@ -75,11 +75,12 @@ function observeReactiveNodes(next) {
 }
 var running = [];
 var origin;
+var currentScope;
 function reportReactiveNode(report) {
   const observer = G.observer;
   if (observer) {
     observer.created(
-      report.parents === void 0 ? { ...report, parents: running, origin: report.origin ?? origin } : report
+      report.parents === void 0 ? { ...report, parents: running, origin: report.origin ?? origin, scope: report.scope ?? currentScope } : { ...report, scope: report.scope ?? currentScope }
     );
   }
 }

package/dist/lib/signal/graph/children.mjs

@@ -1,5 +1,5 @@
 // src/version.generated.ts
-var VERSION = "1.0.0-alpha.91";
+var VERSION = "1.0.0-alpha.93";
 
 // src/lib/signal/graph/state.ts
 var MAJOR = VERSION.split(".")[0];
@@ -49,11 +49,12 @@ function observeReactiveNodes(next) {
 }
 var running = [];
 var origin;
+var currentScope;
 function reportReactiveNode(report) {
   const observer = G.observer;
   if (observer) {
     observer.created(
-      report.parents === void 0 ? { ...report, parents: running, origin: report.origin ?? origin } : report
+      report.parents === void 0 ? { ...report, parents: running, origin: report.origin ?? origin, scope: report.scope ?? currentScope } : { ...report, scope: report.scope ?? currentScope }
     );
   }
 }

package/dist/lib/signal/graph/compat.cjs

@@ -1,4 +1,4 @@
-/*! @fluixi/reactive v1.0.0-alpha.91 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/reactive v1.0.0-alpha.93 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 "use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -42,7 +42,7 @@ __export(compat_exports, {
 module.exports = __toCommonJS(compat_exports);
 
 // src/version.generated.ts
-var VERSION = "1.0.0-alpha.91";
+var VERSION = "1.0.0-alpha.93";
 
 // src/lib/signal/graph/state.ts
 var MAJOR = VERSION.split(".")[0];
@@ -92,11 +92,12 @@ function observeReactiveNodes(next) {
 }
 var running = [];
 var origin;
+var currentScope;
 function reportReactiveNode(report) {
   const observer = G.observer;
   if (observer) {
     observer.created(
-      report.parents === void 0 ? { ...report, parents: running, origin: report.origin ?? origin } : report
+      report.parents === void 0 ? { ...report, parents: running, origin: report.origin ?? origin, scope: report.scope ?? currentScope } : { ...report, scope: report.scope ?? currentScope }
     );
   }
 }
@@ -416,7 +417,7 @@ function batch(fn) {
   }
 }
 var EffectNode = class {
-  constructor(fn, report = false) {
+  constructor(fn, report = false, name) {
     this.queued = false;
     this.disposed = false;
     this.owner = makeOwner(G.owner);
@@ -428,7 +429,7 @@ var EffectNode = class {
         if (typeof r === "function") (this.owner.cleanups ??= []).push(r);
       });
     });
-    reportReactiveNode({ kind: "effect", node: this.computed, handle: this, internal: !report });
+    reportReactiveNode({ kind: "effect", node: this.computed, handle: this, internal: !report, ...name ? { name } : {} });
     this.watcher = new Watcher(() => enqueue(this));
     this.run();
     this.watcher.watch(this.computed);
@@ -455,8 +456,8 @@ var EffectNode = class {
     disposeOwner(this.owner);
   }
 };
-function effect(fn, report = false) {
-  const node = new EffectNode(fn, report);
+function effect(fn, report = false, name) {
+  const node = new EffectNode(fn, report, name);
   return () => node.dispose();
 }
 
@@ -524,12 +525,12 @@ function createMemo(fn, value, options) {
   if (isObserved()) onCleanup(() => reportReactiveDispose(c));
   return read;
 }
-function createEffect(fn, value) {
+function createEffect(fn, value, options) {
   let prev = value;
   return effect(() => {
     const r = fn(prev);
     prev = r;
-  }, true);
+  }, true, options?.name);
 }
 function createComputed(fn, value) {
   let prev = value;

package/dist/lib/signal/graph/compat.d.ts

@@ -20,7 +20,9 @@ export declare function createMemo<T>(fn: (prev?: T) => T, value?: T, options?:
  * createEffect, a re-running side effect. The fn receives the previous return
  * value and may return a new one (legacy signature) or a cleanup function.
  */
-export declare function createEffect<T>(fn: (prev?: T) => T | (() => void), value?: T): () => void;
+export declare function createEffect<T>(fn: (prev?: T) => T | (() => void), value?: T, options?: {
+    name?: string;
+}): () => void;
 /**
  * createComputed, an EAGER, owner-managed reactive computation (returns void).
  * Unlike a lazy memo it runs immediately and re-runs eagerly when a dep changes;

package/dist/lib/signal/graph/compat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compat.d.ts","sourceRoot":"","sources":["../../../../src/lib/signal/graph/compat.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"compat.d.ts","sourceRoot":"","sources":["../../../../src/lib/signal/graph/compat.ts"],"names":[],"mappings":"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"}

package/dist/lib/signal/graph/compat.js

@@ -110,7 +110,7 @@ export function createMemo(fn, value, options) {
  * createEffect, a re-running side effect. The fn receives the previous return
  * value and may return a new one (legacy signature) or a cleanup function.
  */
-export function createEffect(fn, value) {
+export function createEffect(fn, value, options) {
     let prev = value;
     return l1effect(() => {
         const r = fn(prev);
@@ -118,7 +118,7 @@ export function createEffect(fn, value) {
         // never returns one, in which case onCleanup is the cleanup path. We keep the
         // legacy carry-the-value behaviour; cleanups use onCleanup.
         prev = r;
-    }, true);
+    }, true, options?.name);
 }
 /**
  * createComputed, an EAGER, owner-managed reactive computation (returns void).