@praxisjs/core 1.6.0 → 1.7.0

package/dist/async/resource.js

@@ -1,14 +1,19 @@
 import { computed, signal } from "../signal";
-import { effect } from "../signal/effect";
+import { getCacheEntry, setCacheEntry, deleteInflight, getInflight, setInflight, registerResource, unregisterResource, } from "./resource-cache";
+import { effect, untrack } from "../signal/effect";
 export function resource(fetcher, options = {}) {
-    const { initialData = null, immediate = true, keepPreviousData = false, } = options;
-    const _data = signal(initialData);
+    const { initialData = null, immediate = true, keepPreviousData = false, key, staleTime = 0, refetchOnFocus = false, } = options;
+    const cached = key ? getCacheEntry(key) : undefined;
+    const isCacheFresh = cached !== undefined && Date.now() - cached.timestamp < staleTime;
+    const _data = signal(cached ? cached.data : initialData);
     const _error = signal(null);
-    const _status = signal("idle");
+    const _status = signal(cached ? "success" : "idle");
     let _runId = 0;
     function _execute(fn) {
         const currentRunId = ++_runId;
-        if (!keepPreviousData) {
+        // untrack: _data.set(result) in the resolve handler must not re-trigger the enclosing effect.
+        const hasCachedData = key !== undefined && untrack(() => _data()) !== null;
+        if (!keepPreviousData && !hasCachedData) {
             _data.set(null);
         }
         _error.set(null);
@@ -19,16 +24,37 @@ export function resource(fetcher, options = {}) {
             _data.set(result);
             _error.set(null);
             _status.set("success");
+            if (key) {
+                setCacheEntry(key, result);
+                deleteInflight(key);
+            }
         }).catch((err) => {
             if (currentRunId !== _runId)
                 return;
             _error.set(err instanceof Error ? err : new Error(String(err)));
             _status.set("error");
+            if (key)
+                deleteInflight(key);
         });
     }
+    function _startFetch() {
+        if (key) {
+            const existing = getInflight(key);
+            if (existing) {
+                _execute(existing);
+                return;
+            }
+            const promise = fetcher();
+            setInflight(key, promise);
+            _execute(promise);
+        }
+        else {
+            _execute(fetcher());
+        }
+    }
     function execute() {
         try {
-            _execute(fetcher());
+            _startFetch();
         }
         catch (err) {
             _runId++;
@@ -36,17 +62,55 @@ export function resource(fetcher, options = {}) {
             _status.set("error");
         }
     }
-    if (immediate) {
-        effect(() => {
+    if (key) {
+        registerResource(key, execute);
+    }
+    let stopEffect;
+    if (immediate && !isCacheFresh) {
+        stopEffect = effect(() => {
             try {
-                _execute(fetcher());
+                if (key) {
+                    const existing = getInflight(key);
+                    if (existing) {
+                        _execute(existing);
+                    }
+                    else {
+                        const promise = fetcher();
+                        setInflight(key, promise);
+                        _execute(promise);
+                    }
+                }
+                else {
+                    _execute(fetcher());
+                }
             }
             catch (err) {
+                _runId++;
                 _error.set(err instanceof Error ? err : new Error(String(err)));
                 _status.set("error");
             }
         });
     }
+    let _removeFocusListener;
+    if (refetchOnFocus && typeof document !== "undefined") {
+        const onVisibility = () => {
+            if (document.visibilityState === "visible") {
+                execute();
+            }
+        };
+        document.addEventListener("visibilitychange", onVisibility);
+        _removeFocusListener = () => {
+            document.removeEventListener("visibilitychange", onVisibility);
+        };
+    }
+    function destroy() {
+        stopEffect?.();
+        stopEffect = undefined;
+        _removeFocusListener?.();
+        _removeFocusListener = undefined;
+        if (key)
+            unregisterResource(key, execute);
+    }
     return {
         data: computed(() => _data()),
         pending: computed(() => _status() === "pending"),
@@ -65,6 +129,7 @@ export function resource(fetcher, options = {}) {
             _error.set(null);
             _status.set("success");
         },
+        destroy,
     };
 }
 export function createResource(param, fetcher, options = {}) {

package/dist/async/resource.js.map

@@ -1 +1 @@
-{"version":3,"file":"resource.js","sourceRoot":"","sources":["../../src/async/resource.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"resource.js","sourceRoot":"","sources":["../../src/async/resource.ts"],"names":[],"mappings":"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"}

package/dist/internal.d.ts

@@ -2,4 +2,5 @@ export { debounced, until, when, history, type HistoryElement, } from "./reactiv
 export { signal, persistedSignal, syncedSignal, peek, computed, batch, effect, untrack, type PersistedSignalOptions, type SyncedSignal, } from "./signal";
 export { RootComponent } from "./component";
 export { resource, createResource, type ResourceStatus, type Resource, type ResourceOptions, } from "./async/resource";
+export { invalidateResource, _clearCache } from "./async/resource-cache";
 //# sourceMappingURL=internal.d.ts.map

package/dist/internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,KAAK,EACL,IAAI,EACJ,OAAO,EACP,KAAK,cAAc,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,MAAM,EACN,eAAe,EACf,YAAY,EACZ,IAAI,EACJ,QAAQ,EACR,KAAK,EACL,MAAM,EACN,OAAO,EACP,KAAK,sBAAsB,EAC3B,KAAK,YAAY,GAClB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EACL,QAAQ,EACR,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,KAAK,EACL,IAAI,EACJ,OAAO,EACP,KAAK,cAAc,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,MAAM,EACN,eAAe,EACf,YAAY,EACZ,IAAI,EACJ,QAAQ,EACR,KAAK,EACL,MAAM,EACN,OAAO,EACP,KAAK,sBAAsB,EAC3B,KAAK,YAAY,GAClB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EACL,QAAQ,EACR,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/internal.js

@@ -2,4 +2,5 @@ export { debounced, until, when, history, } from "./reactive";
 export { signal, persistedSignal, syncedSignal, peek, computed, batch, effect, untrack, } from "./signal";
 export { RootComponent } from "./component";
 export { resource, createResource, } from "./async/resource";
+export { invalidateResource, _clearCache } from "./async/resource-cache";
 //# sourceMappingURL=internal.js.map

package/dist/internal.js.map

@@ -1 +1 @@
-{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,KAAK,EACL,IAAI,EACJ,OAAO,GAER,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,MAAM,EACN,eAAe,EACf,YAAY,EACZ,IAAI,EACJ,QAAQ,EACR,KAAK,EACL,MAAM,EACN,OAAO,GAGR,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EACL,QAAQ,EACR,cAAc,GAIf,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,KAAK,EACL,IAAI,EACJ,OAAO,GAER,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,MAAM,EACN,eAAe,EACf,YAAY,EACZ,IAAI,EACJ,QAAQ,EACR,KAAK,EACL,MAAM,EACN,OAAO,GAGR,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EACL,QAAQ,EACR,cAAc,GAIf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/reactive/reactive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reactive.d.ts","sourceRoot":"","sources":["../../src/reactive/reactive.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAKzD,wBAAgB,IAAI,CAAC,CAAC,EACpB,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,EAC/B,EAAE,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,cAsBpC;AAED,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,2BAQvD;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM;UAmBf,MAAM,IAAI;EAIlE"}
+{"version":3,"file":"reactive.d.ts","sourceRoot":"","sources":["../../src/reactive/reactive.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAKzD,wBAAgB,IAAI,CAAC,CAAC,EACpB,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,EAC/B,EAAE,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,cAsBpC;AAED,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,2BAQvD;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM;UAkBf,MAAM,IAAI;EAIlE"}

package/dist/reactive/reactive.js

@@ -32,8 +32,6 @@ export function debounced(source, ms) {
     let timeout;
     const stop = effect(() => {
         const value = source();
-        if (timeout)
-            clearTimeout(timeout);
         timeout = setTimeout(() => {
             current.set(value);
             timeout = undefined;

package/dist/reactive/reactive.js.map

@@ -1 +1 @@
-{"version":3,"file":"reactive.js","sourceRoot":"","sources":["../../src/reactive/reactive.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,MAAM,UAAU,IAAI,CAClB,MAA+B,EAC/B,EAAmC;IAEnC,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,MAAM,GAAG,GAAG,EAAE,MAAM,EAAE,SAAqC,EAAE,CAAC;IAE9D,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,EAAE;QACvB,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC,KAAK,IAAI,QAAQ;YAAE,OAAO;QAE/B,QAAQ,GAAG,IAAI,CAAC;QAChB,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC;QACf,EAAE,CAAC,KAAK,CAAC,CAAC;IACZ,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC;IAElB,0EAA0E;IAC1E,0EAA0E;IAC1E,uEAAuE;IACvE,IAAI,QAAQ;QAAE,IAAI,EAAE,CAAC;IAErB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,KAAK,CAAI,MAA+B;IACtD,OAAO,IAAI,OAAO,CAAiB,CAAC,OAAO,EAAE,EAAE;QAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YAClC,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,CAAC,CAAC;QAEH,KAAK,IAAI,CAAC;IACZ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,SAAS,CAAI,MAA+B,EAAE,EAAU;IACtE,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACjC,IAAI,OAAkD,CAAC;IAEvD,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,EAAE;QACvB,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC;QACvB,IAAI,OAAO;YAAE,YAAY,CAAC,OAAO,CAAC,CAAC;QACnC,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YACxB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACnB,OAAO,GAAG,SAAS,CAAC;QACtB,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,OAAO,GAAG,EAAE;YACV,IAAI,OAAO,EAAE,CAAC;gBACZ,YAAY,CAAC,OAAO,CAAC,CAAC;gBACtB,OAAO,GAAG,SAAS,CAAC;YACtB,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,eAAe,GAAG,OAA2C,CAAC;IACpE,eAAe,CAAC,IAAI,GAAG,IAAI,CAAC;IAE5B,OAAO,eAAe,CAAC;AACzB,CAAC"}
+{"version":3,"file":"reactive.js","sourceRoot":"","sources":["../../src/reactive/reactive.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,MAAM,UAAU,IAAI,CAClB,MAA+B,EAC/B,EAAmC;IAEnC,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,MAAM,GAAG,GAAG,EAAE,MAAM,EAAE,SAAqC,EAAE,CAAC;IAE9D,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,EAAE;QACvB,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC,KAAK,IAAI,QAAQ;YAAE,OAAO;QAE/B,QAAQ,GAAG,IAAI,CAAC;QAChB,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC;QACf,EAAE,CAAC,KAAK,CAAC,CAAC;IACZ,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC;IAElB,0EAA0E;IAC1E,0EAA0E;IAC1E,uEAAuE;IACvE,IAAI,QAAQ;QAAE,IAAI,EAAE,CAAC;IAErB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,KAAK,CAAI,MAA+B;IACtD,OAAO,IAAI,OAAO,CAAiB,CAAC,OAAO,EAAE,EAAE;QAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YAClC,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,CAAC,CAAC;QAEH,KAAK,IAAI,CAAC;IACZ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,SAAS,CAAI,MAA+B,EAAE,EAAU;IACtE,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACjC,IAAI,OAAkD,CAAC;IAEvD,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,EAAE;QACvB,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC;QACvB,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YACxB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACnB,OAAO,GAAG,SAAS,CAAC;QACtB,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,OAAO,GAAG,EAAE;YACV,IAAI,OAAO,EAAE,CAAC;gBACZ,YAAY,CAAC,OAAO,CAAC,CAAC;gBACtB,OAAO,GAAG,SAAS,CAAC;YACtB,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,eAAe,GAAG,OAA2C,CAAC;IACpE,eAAe,CAAC,IAAI,GAAG,IAAI,CAAC;IAE5B,OAAO,eAAe,CAAC;AACzB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@praxisjs/core",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/src/__tests__/computed.test.ts

@@ -186,6 +186,35 @@ describe("computed", () => {
     expect(bVal).toBeGreaterThanOrEqual(1);
   });
 
+  it("microtask guard: skips notifySubs when leaf subscriber unsubscribes before microtask fires", async () => {
+    const s = signal(0);
+    const c = computed(() => s() * 2);
+    const results: number[] = [];
+    const unsub = c.subscribe((v) => results.push(v));
+    // results = [0]
+
+    s.set(1); // markDirty: queues microtask (scheduled = true)
+    unsub();  // removes leaf subscriber BEFORE microtask fires → leafHolder.subs = null
+
+    await Promise.resolve(); // microtask: if (leafHolder.subs !== null) → FALSE → no notify
+    expect(results).toEqual([0]); // no update received after unsubscribe
+  });
+
+  it("skips re-scheduling leaf notification when already scheduled (!scheduled false branch)", async () => {
+    const s = signal(0);
+    const c = computed(() => s() * 2);
+    const results: number[] = [];
+    c.subscribe((v) => results.push(v));
+    // results = [0] after initial subscribe
+
+    s.set(1); // markDirty: scheduled = true, microtask queued
+    c();      // re-computes: dirty = false (scheduled still true)
+    s.set(2); // markDirty: dirty=false → proceeds, but !scheduled is false → no second microtask
+
+    await Promise.resolve(); // microtask runs, subscriber notified with current value
+    expect(results).toContain(4); // 2 * 2
+  });
+
   it("double unsubscribe on computed does not crash", () => {
     const s = signal(1);
     const c = computed(() => s() + 1);

package/src/__tests__/resource-focus.test.ts

@@ -0,0 +1,61 @@
+// @vitest-environment jsdom
+import { describe, it, expect, vi, beforeEach } from "vitest";
+
+import { resource } from "../async/resource";
+import { _clearCache } from "../async/resource-cache";
+
+describe("resource — refetchOnFocus", () => {
+  beforeEach(() => { _clearCache(); });
+
+  it("refetches when document becomes visible", async () => {
+    let call = 0;
+    const fetcher = vi.fn(() => Promise.resolve(++call));
+    const r = resource(fetcher, { refetchOnFocus: true });
+    await vi.waitFor(() => r.status() === "success");
+    expect(fetcher).toHaveBeenCalledTimes(1);
+
+    Object.defineProperty(document, "visibilityState", {
+      configurable: true,
+      get: () => "visible",
+    });
+    document.dispatchEvent(new Event("visibilitychange"));
+
+    await vi.waitFor(() => r.data() === 2);
+    expect(fetcher).toHaveBeenCalledTimes(2);
+    r.destroy();
+  });
+
+  it("does not refetch when document becomes hidden", async () => {
+    const fetcher = vi.fn(() => Promise.resolve(1));
+    const r = resource(fetcher, { refetchOnFocus: true });
+    await vi.waitFor(() => r.status() === "success");
+
+    Object.defineProperty(document, "visibilityState", {
+      configurable: true,
+      get: () => "hidden",
+    });
+    document.dispatchEvent(new Event("visibilitychange"));
+    await new Promise((res) => setTimeout(res, 10));
+
+    expect(fetcher).toHaveBeenCalledTimes(1);
+    r.destroy();
+  });
+
+  it("destroy() removes the visibilitychange listener", async () => {
+    let call = 0;
+    const fetcher = vi.fn(() => Promise.resolve(++call));
+    const r = resource(fetcher, { refetchOnFocus: true });
+    await vi.waitFor(() => r.status() === "success");
+
+    r.destroy();
+
+    Object.defineProperty(document, "visibilityState", {
+      configurable: true,
+      get: () => "visible",
+    });
+    document.dispatchEvent(new Event("visibilitychange"));
+    await new Promise((res) => setTimeout(res, 10));
+
+    expect(fetcher).toHaveBeenCalledTimes(1); // no refetch after destroy
+  });
+});

package/src/__tests__/resource.test.ts

@@ -1,6 +1,7 @@
-import { describe, it, expect, vi } from "vitest";
+import { describe, it, expect, vi, beforeEach } from "vitest";
 
 import { resource, createResource } from "../async/resource";
+import { invalidateResource, _clearCache } from "../async/resource-cache";
 import { signal } from "../signal/signal";
 
 describe("resource", () => {
@@ -151,6 +152,182 @@ describe("resource — execute() sync throw via refetch()", () => {
   });
 });
 
+describe("resource — destroy()", () => {
+  it("destroy() stops the reactive effect — signal changes no longer trigger refetch", async () => {
+    const id = signal(1);
+    const fetcher = vi.fn((n: number) => Promise.resolve(n * 10));
+    const r = resource(() => fetcher(id()), { immediate: true });
+    await vi.waitFor(() => r.status() === "success");
+    expect(fetcher).toHaveBeenCalledTimes(1);
+
+    r.destroy();
+    id.set(2);
+    await new Promise((res) => setTimeout(res, 10));
+    expect(fetcher).toHaveBeenCalledTimes(1); // no re-fetch after destroy
+  });
+
+  it("destroy() is idempotent", async () => {
+    const r = resource(() => Promise.resolve(1));
+    await vi.waitFor(() => r.status() === "success");
+    expect(() => { r.destroy(); r.destroy(); }).not.toThrow();
+  });
+});
+
+describe("resource — cache + SWR (key, staleTime)", () => {
+  beforeEach(() => { _clearCache(); });
+
+  it("key: populates data from cache on creation (SWR)", async () => {
+    // First resource fills the cache
+    const r1 = resource(() => Promise.resolve("cached-value"), { key: "swr-test" });
+    await vi.waitFor(() => r1.status() === "success");
+
+    // Second resource with same key starts with cached data immediately
+    const r2 = resource(() => Promise.resolve("new-value"), { key: "swr-test" });
+    expect(r2.data()).toBe("cached-value"); // stale data shown immediately
+    expect(r2.status()).toBe("pending"); // fetching fresh data in background
+    await vi.waitFor(() => r2.data() === "new-value");
+    r1.destroy();
+    r2.destroy();
+  });
+
+  it("staleTime: skips fetch when cache is fresh", async () => {
+    const fetcher = vi.fn(() => Promise.resolve("fresh"));
+    const r1 = resource(fetcher, { key: "fresh-test", staleTime: 60_000 });
+    await vi.waitFor(() => r1.status() === "success");
+    expect(fetcher).toHaveBeenCalledTimes(1);
+
+    // Second resource within staleTime — no fetch
+    const r2 = resource(fetcher, { key: "fresh-test", staleTime: 60_000 });
+    expect(r2.data()).toBe("fresh");
+    expect(r2.status()).toBe("success");
+    await new Promise((res) => setTimeout(res, 10));
+    expect(fetcher).toHaveBeenCalledTimes(1); // no second fetch
+    r1.destroy();
+    r2.destroy();
+  });
+
+  it("staleTime: 0 (default) always refetches even with cached data", async () => {
+    const fetcher = vi.fn(() => Promise.resolve("v1"));
+    const r1 = resource(fetcher, { key: "always-stale" });
+    await vi.waitFor(() => r1.status() === "success");
+
+    const r2 = resource(fetcher, { key: "always-stale", staleTime: 0 });
+    expect(r2.data()).toBe("v1"); // shows stale immediately
+    await vi.waitFor(() => r2.status() === "success");
+    expect(fetcher).toHaveBeenCalledTimes(2); // did refetch
+    r1.destroy();
+    r2.destroy();
+  });
+});
+
+describe("resource — deduplication", () => {
+  beforeEach(() => { _clearCache(); });
+
+  it("two resources with the same key share a single in-flight request", async () => {
+    let resolveShared!: (v: string) => void;
+    const fetcher = vi.fn(
+      () => new Promise<string>((res) => { resolveShared = res; }),
+    );
+
+    const r1 = resource(fetcher, { key: "dedup-test" });
+    const r2 = resource(fetcher, { key: "dedup-test" });
+
+    expect(fetcher).toHaveBeenCalledTimes(1); // only one fetch started
+
+    resolveShared("shared-result");
+    await vi.waitFor(() => r1.status() === "success");
+    await vi.waitFor(() => r2.status() === "success");
+
+    expect(r1.data()).toBe("shared-result");
+    expect(r2.data()).toBe("shared-result");
+    r1.destroy();
+    r2.destroy();
+  });
+});
+
+describe("resource — key + non-Error sync throw in effect", () => {
+  beforeEach(() => { _clearCache(); });
+
+  it("key: wraps non-Error sync throw from fetcher inside effect in Error", async () => {
+    const r = resource(
+      () => {
+        // eslint-disable-next-line @typescript-eslint/only-throw-error
+        throw "raw string error in keyed effect";
+      },
+      { key: "non-error-keyed" },
+    );
+    await vi.waitFor(() => r.status() === "error");
+    expect(r.error()).toBeInstanceOf(Error);
+    expect((r.error() as Error).message).toBe("raw string error in keyed effect");
+    r.destroy();
+  });
+});
+
+describe("resource — key + rejection / sync-throw", () => {
+  beforeEach(() => { _clearCache(); });
+
+  it("key: clears in-flight entry on rejection (catch path)", async () => {
+    const r = resource(
+      () => Promise.reject(new Error("keyed failure")),
+      { key: "reject-test" },
+    );
+    await new Promise((res) => setTimeout(res, 0));
+    expect(r.status()).toBe("error");
+    expect((r.error() as Error).message).toBe("keyed failure");
+    r.destroy();
+  });
+
+  it("key: sync throw inside effect is captured as error", async () => {
+    const r = resource(
+      () => { throw new Error("sync in keyed effect"); },
+      { key: "sync-throw-keyed" },
+    );
+    await vi.waitFor(() => r.status() === "error");
+    expect((r.error() as Error).message).toBe("sync in keyed effect");
+    r.destroy();
+  });
+});
+
+describe("resource — invalidateResource()", () => {
+  beforeEach(() => { _clearCache(); });
+
+  it("clears cache and triggers refetch on all registered resources", async () => {
+    let call = 0;
+    const fetcher = vi.fn(() => Promise.resolve(++call));
+
+    const r1 = resource(fetcher, { key: "inv-test" });
+    const r2 = resource(fetcher, { key: "inv-test" });
+    await vi.waitFor(() => r1.status() === "success");
+    await vi.waitFor(() => r2.status() === "success");
+
+    const callsBefore = fetcher.mock.calls.length;
+    invalidateResource("inv-test");
+
+    await vi.waitFor(() => r1.status() === "success" && r1.data() !== callsBefore);
+    expect(fetcher.mock.calls.length).toBeGreaterThan(callsBefore);
+    r1.destroy();
+    r2.destroy();
+  });
+
+  it("no-op when key has no registered resources", () => {
+    expect(() => { invalidateResource("nonexistent-key"); }).not.toThrow();
+  });
+
+  it("unregisters resource on destroy — invalidate no longer triggers it", async () => {
+    let call = 0;
+    const fetcher = vi.fn(() => Promise.resolve(++call));
+    const r = resource(fetcher, { key: "unreg-test" });
+    await vi.waitFor(() => r.status() === "success");
+
+    r.destroy();
+    const callsBefore = fetcher.mock.calls.length;
+
+    invalidateResource("unreg-test");
+    await new Promise((res) => setTimeout(res, 10));
+    expect(fetcher.mock.calls.length).toBe(callsBefore); // no refetch after destroy
+  });
+});
+
 describe("resource — additional cases", () => {
   it("two concurrent refetch() calls — last result wins, stale result is discarded", async () => {
     let resolveFirst!: (v: string) => void;

package/src/__tests__/signal.test.ts

@@ -1,6 +1,8 @@
 import { describe, it, expect } from "vitest";
 
-import { signal } from "../signal/signal";
+import { batch } from "../signal/batch";
+import { signal, addSub, removeSub, type SubList } from "../signal/signal";
+import type { Effect } from "../signal/effect";
 
 describe("signal", () => {
   it("returns initial value", () => {
@@ -125,6 +127,58 @@ describe("signal", () => {
     expect(() => s.set(1)).not.toThrow();
   });
 
+  it("unsubscribing one of multiple subscribers removes only that subscriber", () => {
+    const s = signal(0);
+    const a: number[] = [];
+    const b: number[] = [];
+    const unsubA = s.subscribe((v) => a.push(v));
+    s.subscribe((v) => b.push(v));
+    // subs is now an array — hits removeSub else branch
+    unsubA();
+    s.set(1);
+    expect(a).toEqual([0]); // A stopped after initial fire
+    expect(b).toEqual([0, 1]); // B still receives
+  });
+
+  it("unsubscribing a non-existent subscriber from array subs is a no-op", () => {
+    const s = signal(0);
+    const a: number[] = [];
+    const b: number[] = [];
+    s.subscribe((v) => a.push(v));
+    const unsubB = s.subscribe((v) => b.push(v));
+    unsubB(); // remove B, subs becomes array without B
+    unsubB(); // call again — idx will be -1, splice not called
+    expect(() => s.set(1)).not.toThrow();
+    expect(a).toContain(1);
+  });
+
+  it("batch defers notifications for multiple array subscribers", () => {
+    const s = signal(0);
+    const a: number[] = [];
+    const b: number[] = [];
+    s.subscribe((v) => a.push(v));
+    s.subscribe((v) => b.push(v));
+    // subs is an array; inside batch, notifySubs hits the batching=true array path
+    batch(() => {
+      s.set(1);
+      expect(a).toEqual([0]); // not yet fired
+      expect(b).toEqual([0]);
+    });
+    expect(a).toContain(1);
+    expect(b).toContain(1);
+  });
+
+  it("removeSub with non-matching single-function subscriber is a no-op", () => {
+    // When subs is a single function and we try to remove a different function,
+    // the holder must remain unchanged (subs !== eff → false branch).
+    const holder: { subs: SubList } = { subs: null };
+    const fn1: Effect = () => {};
+    const fn2: Effect = () => {};
+    addSub(holder, fn1); // subs = fn1 (single function)
+    removeSub(holder, fn2); // fn2 !== fn1 → no-op
+    expect(holder.subs).toBe(fn1);
+  });
+
   it("set() with mutated object reference (same ref) does NOT notify — Object.is semantics", () => {
     const obj = { count: 0 };
     const s = signal(obj);

package/src/async/resource-cache.ts

@@ -0,0 +1,62 @@
+interface CacheEntry {
+  data: unknown;
+  timestamp: number;
+}
+
+const _cache = new Map<string, CacheEntry>();
+const _inflight = new Map<string, Promise<unknown>>();
+const _registry = new Map<string, Set<() => void>>();
+
+export function getCacheEntry(key: string): CacheEntry | undefined {
+  return _cache.get(key);
+}
+
+export function setCacheEntry(key: string, data: unknown): void {
+  _cache.set(key, { data, timestamp: Date.now() });
+}
+
+export function deleteCacheEntry(key: string): void {
+  _cache.delete(key);
+}
+
+export function getInflight(key: string): Promise<unknown> | undefined {
+  return _inflight.get(key);
+}
+
+export function setInflight(key: string, promise: Promise<unknown>): void {
+  _inflight.set(key, promise);
+}
+
+export function deleteInflight(key: string): void {
+  _inflight.delete(key);
+}
+
+export function registerResource(key: string, refetch: () => void): void {
+  let set = _registry.get(key);
+  if (!set) {
+    set = new Set();
+    _registry.set(key, set);
+  }
+  set.add(refetch);
+}
+
+export function unregisterResource(key: string, refetch: () => void): void {
+  _registry.get(key)?.delete(refetch);
+}
+
+/**
+ * Clears the cache entry and in-flight request for `key`, then triggers
+ * every active resource registered under that key to refetch.
+ */
+export function invalidateResource(key: string): void {
+  deleteCacheEntry(key);
+  deleteInflight(key);
+  _registry.get(key)?.forEach((fn) => { fn(); });
+}
+
+/** Resets all cache state. Intended for use in tests only. */
+export function _clearCache(): void {
+  _cache.clear();
+  _inflight.clear();
+  _registry.clear();
+}