@praxisjs/core 0.4.0 → 0.4.1

package/dist/__tests__/resource.test.js

@@ -0,0 +1,84 @@
+import { describe, it, expect, vi } from "vitest";
+import { resource, createResource } from "../async/resource";
+import { signal } from "../signal/signal";
+describe("resource", () => {
+    it("starts as pending and resolves to success", async () => {
+        const r = resource(() => Promise.resolve("hello"));
+        expect(r.status()).toBe("pending");
+        await vi.waitFor(() => r.status() === "success");
+        expect(r.data()).toBe("hello");
+        expect(r.pending()).toBe(false);
+        expect(r.error()).toBeNull();
+    });
+    it("transitions to error on rejection", async () => {
+        const r = resource(() => Promise.reject(new Error("oops")));
+        await new Promise((res) => setTimeout(res, 0));
+        expect(r.status()).toBe("error");
+        expect(r.error().message).toBe("oops");
+        expect(r.data()).toBeNull();
+    });
+    it("wraps non-Error rejections in Error", async () => {
+        const r = resource(() => Promise.reject("plain string"));
+        await new Promise((res) => setTimeout(res, 0));
+        expect(r.status()).toBe("error");
+        expect(r.error()).toBeInstanceOf(Error);
+    });
+    it("immediate=false does not fetch on creation", () => {
+        const fetcher = vi.fn(() => Promise.resolve(1));
+        const r = resource(fetcher, { immediate: false });
+        expect(fetcher).not.toHaveBeenCalled();
+        expect(r.status()).toBe("idle");
+    });
+    it("refetch() re-runs the fetcher", async () => {
+        let count = 0;
+        const r = resource(() => Promise.resolve(++count));
+        await vi.waitFor(() => r.status() === "success");
+        expect(r.data()).toBe(1);
+        r.refetch();
+        await vi.waitFor(() => r.data() === 2);
+        expect(r.data()).toBe(2);
+    });
+    it("cancel() sets status back to idle and ignores in-flight result", async () => {
+        let resolve;
+        const r = resource(() => new Promise((res) => { resolve = res; }));
+        r.cancel();
+        expect(r.status()).toBe("idle");
+        resolve(99);
+        await new Promise((r) => setTimeout(r, 10));
+        expect(r.data()).toBeNull(); // stale result ignored
+    });
+    it("mutate() sets data directly", async () => {
+        const r = resource(() => Promise.resolve(1));
+        await vi.waitFor(() => r.status() === "success");
+        r.mutate(999);
+        expect(r.data()).toBe(999);
+        expect(r.status()).toBe("success");
+        expect(r.error()).toBeNull();
+    });
+    it("initialData is visible when immediate=false", () => {
+        const r = resource(() => new Promise(() => { }), { initialData: "cached", immediate: false });
+        expect(r.data()).toBe("cached");
+        expect(r.status()).toBe("idle");
+    });
+    it("keepPreviousData=true preserves old data during refetch", async () => {
+        let call = 0;
+        const r = resource(() => Promise.resolve(++call), { keepPreviousData: true });
+        await vi.waitFor(() => r.data() === 1);
+        r.refetch();
+        // data should still be 1 while pending
+        expect(r.data()).toBe(1);
+        await vi.waitFor(() => r.data() === 2);
+    });
+});
+describe("createResource", () => {
+    it("re-fetches when the param signal changes", async () => {
+        const id = signal(1);
+        const fetcher = vi.fn((n) => Promise.resolve(n * 10));
+        const r = createResource(id, fetcher);
+        await vi.waitFor(() => r.data() === 10);
+        id.set(2);
+        await vi.waitFor(() => r.data() === 20);
+        expect(fetcher).toHaveBeenCalledTimes(2);
+    });
+});
+//# sourceMappingURL=resource.test.js.map

package/dist/__tests__/resource.test.js.map

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

package/dist/__tests__/signal.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=signal.test.d.ts.map

package/dist/__tests__/signal.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/signal.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/signal.test.js

@@ -0,0 +1,64 @@
+import { describe, it, expect } from "vitest";
+import { signal } from "../signal/signal";
+describe("signal", () => {
+    it("returns initial value", () => {
+        const s = signal(42);
+        expect(s()).toBe(42);
+    });
+    it("updates value with set", () => {
+        const s = signal(0);
+        s.set(10);
+        expect(s()).toBe(10);
+    });
+    it("updates value with update fn", () => {
+        const s = signal(5);
+        s.update((v) => v * 2);
+        expect(s()).toBe(10);
+    });
+    it("skips update when value is identical", () => {
+        const s = signal(1);
+        const calls = [];
+        s.subscribe((v) => calls.push(v));
+        const before = calls.length;
+        s.set(1); // same value
+        expect(calls.length).toBe(before);
+    });
+    it("subscribe fires immediately with current value", () => {
+        const s = signal("hello");
+        const received = [];
+        s.subscribe((v) => received.push(v));
+        expect(received).toEqual(["hello"]);
+    });
+    it("subscribe fires on subsequent updates", () => {
+        const s = signal(0);
+        const received = [];
+        s.subscribe((v) => received.push(v));
+        s.set(1);
+        s.set(2);
+        expect(received).toEqual([0, 1, 2]);
+    });
+    it("unsubscribe stops receiving updates", () => {
+        const s = signal(0);
+        const received = [];
+        const unsub = s.subscribe((v) => received.push(v));
+        unsub();
+        s.set(99);
+        expect(received).toEqual([0]);
+    });
+    it("marks __isSignal = true", () => {
+        const s = signal(0);
+        expect(s.__isSignal).toBe(true);
+    });
+    it("supports object values", () => {
+        const s = signal({ name: "Alice" });
+        s.set({ name: "Bob" });
+        expect(s().name).toBe("Bob");
+    });
+    it("supports null and undefined", () => {
+        const s = signal(null);
+        expect(s()).toBeNull();
+        s.set(5);
+        expect(s()).toBe(5);
+    });
+});
+//# sourceMappingURL=signal.test.js.map

package/dist/__tests__/signal.test.js.map

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

package/dist/__tests__/track.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=track.test.d.ts.map

package/dist/__tests__/track.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"track.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/track.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/track.test.js

@@ -0,0 +1,54 @@
+import { describe, it, expect, vi } from "vitest";
+import { track, runEffect, activeEffect } from "../signal/effect";
+import { signal } from "../signal/signal";
+describe("track", () => {
+    it("runs the effect immediately", () => {
+        const fn = vi.fn();
+        track(fn);
+        expect(fn).toHaveBeenCalledOnce();
+    });
+    it("sets activeEffect during execution, resets after", () => {
+        let during = "not-set";
+        track(() => {
+            during = activeEffect;
+        });
+        expect(during).toBeTypeOf("function");
+        expect(activeEffect).toBeNull();
+    });
+    it("supports nested track calls — restores outer effect", () => {
+        const outer = vi.fn();
+        const inner = vi.fn();
+        let outerActive;
+        let innerActive;
+        track(() => {
+            outer();
+            outerActive = activeEffect;
+            track(() => {
+                inner();
+                innerActive = activeEffect;
+            });
+            // after inner track, activeEffect should be back to outer
+            expect(activeEffect).toBe(outerActive);
+        });
+        expect(outer).toHaveBeenCalledOnce();
+        expect(inner).toHaveBeenCalledOnce();
+        expect(innerActive).not.toBe(outerActive);
+    });
+    it("subscribes the tracked effect to signals read inside it", () => {
+        const s = signal(1);
+        const values = [];
+        track(() => values.push(s()));
+        s.set(2);
+        expect(values).toEqual([1, 2]);
+    });
+});
+describe("runEffect", () => {
+    it("sets activeEffect to the given value", () => {
+        const fn = () => { };
+        runEffect(fn);
+        expect(activeEffect).toBe(fn);
+        runEffect(null);
+        expect(activeEffect).toBeNull();
+    });
+});
+//# sourceMappingURL=track.test.js.map

package/dist/__tests__/track.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"track.test.js","sourceRoot":"","sources":["../../src/__tests__/track.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAElD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE;IACrB,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACnB,KAAK,CAAC,EAAE,CAAC,CAAC;QACV,MAAM,CAAC,EAAE,CAAC,CAAC,oBAAoB,EAAE,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,IAAI,MAAM,GAAY,SAAS,CAAC;QAChC,KAAK,CAAC,GAAG,EAAE;YACT,MAAM,GAAG,YAAY,CAAC;QACxB,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QACtC,MAAM,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,KAAK,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACtB,MAAM,KAAK,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACtB,IAAI,WAAoB,CAAC;QACzB,IAAI,WAAoB,CAAC;QAEzB,KAAK,CAAC,GAAG,EAAE;YACT,KAAK,EAAE,CAAC;YACR,WAAW,GAAG,YAAY,CAAC;YAC3B,KAAK,CAAC,GAAG,EAAE;gBACT,KAAK,EAAE,CAAC;gBACR,WAAW,GAAG,YAAY,CAAC;YAC7B,CAAC,CAAC,CAAC;YACH,0DAA0D;YAC1D,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,KAAK,CAAC,CAAC,oBAAoB,EAAE,CAAC;QACrC,MAAM,CAAC,KAAK,CAAC,CAAC,oBAAoB,EAAE,CAAC;QACrC,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC9B,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACT,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,EAAE,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC;QACpB,SAAS,CAAC,EAAE,CAAC,CAAC;QACd,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9B,SAAS,CAAC,IAAI,CAAC,CAAC;QAChB,MAAM,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;IAClC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,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,cAcpC;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,aAcvE"}
+{"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,aAcvE"}

package/dist/reactive/reactive.js

@@ -2,14 +2,21 @@ import { signal } from "../signal";
 import { effect } from "../signal/effect";
 export function when(source, fn) {
     let disposed = false;
+    const ref = { cancel: undefined };
     const stop = effect(() => {
         const value = source();
         if (!value || disposed)
             return;
         disposed = true;
-        stop();
+        ref.cancel?.();
         fn(value);
     });
+    ref.cancel = stop;
+    // If source was truthy on the first synchronous run, ref.cancel?.() above
+    // was a no-op because it hadn't been assigned yet. Cancel the effect now.
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+    if (disposed)
+        stop();
     return stop;
 }
 export function until(source) {

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;IAErB,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,IAAI,EAAE,CAAC;QACP,EAAE,CAAC,KAAK,CAAC,CAAC;IACZ,CAAC,CAAC,CAAC;IAEH,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,CAAI,MAAM,EAAE,CAAC,CAAC;IACpC,IAAI,OAAkD,CAAC;IAEvD,MAAM,CAAC,GAAG,EAAE;QACV,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;IACT,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,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,CAAI,MAAM,EAAE,CAAC,CAAC;IACpC,IAAI,OAAkD,CAAC;IAEvD,MAAM,CAAC,GAAG,EAAE;QACV,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;IACT,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/signal/persisted.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"persisted.d.ts","sourceRoot":"","sources":["../../src/signal/persisted.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAI/C,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC;IACjC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,CAAC,CAAC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,eAAe,CAAC,CAAC,EAC/B,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,CAAC,EACf,OAAO,GAAE,sBAAsB,CAAC,CAAC,CAAM,aA0ExC"}
+{"version":3,"file":"persisted.d.ts","sourceRoot":"","sources":["../../src/signal/persisted.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAI/C,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC;IACjC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,CAAC,CAAC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,eAAe,CAAC,CAAC,EAC/B,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,CAAC,EACf,OAAO,GAAE,sBAAsB,CAAC,CAAC,CAAM,aAwExC"}

package/dist/signal/persisted.js

@@ -39,19 +39,17 @@ export function persistedSignal(key, initialValue, options = {}) {
     }
     if (syncTabs) {
         window.addEventListener("storage", (event) => {
-            if (event.key === key || event.storageArea !== localStorage)
+            if (event.key !== key || event.storageArea !== localStorage)
                 return;
-            {
-                try {
-                    const newValue = event.newValue
-                        ? deserialize(event.newValue)
-                        : initialValue;
-                    inner.set(newValue);
-                }
-                catch (e) {
-                    console.warn(`Failed to deserialize value for key "${key}" from storage event:`, e);
-                    inner.set(initialValue);
-                }
+            try {
+                const newValue = event.newValue
+                    ? deserialize(event.newValue)
+                    : initialValue;
+                inner.set(newValue);
+            }
+            catch (e) {
+                console.warn(`Failed to deserialize value for key "${key}" from storage event:`, e);
+                inner.set(initialValue);
             }
         });
     }

package/dist/signal/persisted.js.map

@@ -1 +1 @@
-{"version":3,"file":"persisted.js","sourceRoot":"","sources":["../../src/signal/persisted.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"persisted.js","sourceRoot":"","sources":["../../src/signal/persisted.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAQlC,MAAM,UAAU,eAAe,CAC7B,GAAW,EACX,YAAe,EACf,UAAqC,EAAE;IAEvC,MAAM,EACJ,SAAS,GAAG,IAAI,CAAC,SAAS,EAC1B,WAAW,GAAG,IAAI,CAAC,KAA6B,EAChD,QAAQ,GAAG,IAAI,GAChB,GAAG,OAAO,CAAC;IAEZ,SAAS,cAAc;QACrB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACzC,OAAO,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;QACrD,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,wCAAwC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;YACjE,OAAO,YAAY,CAAC;QACtB,CAAC;IACH,CAAC;IAED,SAAS,cAAc,CAAC,KAAQ;QAC9B,IAAI,CAAC;YACH,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAC1C,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YAC/B,CAAC;iBAAM,CAAC;gBACN,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,sCAAsC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAI,cAAc,EAAE,CAAC,CAAC;IAE1C,SAAS,IAAI;QACX,OAAO,KAAK,EAAE,CAAC;IACjB,CAAC;IAED,SAAS,GAAG,CAAC,KAAQ;QACnB,cAAc,CAAC,KAAK,CAAC,CAAC;QACtB,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC;IAED,SAAS,MAAM,CAAC,EAAkB;QAChC,MAAM,QAAQ,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;QAC7B,cAAc,CAAC,QAAQ,CAAC,CAAC;QACzB,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACtB,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE;YAC3C,IAAI,KAAK,CAAC,GAAG,KAAK,GAAG,IAAI,KAAK,CAAC,WAAW,KAAK,YAAY;gBAAE,OAAO;YACpE,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ;oBAC7B,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC;oBAC7B,CAAC,CAAC,YAAY,CAAC;gBACjB,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACtB,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,CAAC,IAAI,CACV,wCAAwC,GAAG,uBAAuB,EAClE,CAAC,CACF,CAAC;gBACF,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,MAAM,GAAG,IAAiB,CAAC;IACjC,MAAM,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/C,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC;IAEzB,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/package.json

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

package/src/__tests__/batch.test.ts

@@ -0,0 +1,29 @@
+import { describe, it, expect } from "vitest";
+
+import { batch } from "../signal/batch";
+import { signal } from "../signal/signal";
+
+describe("batch", () => {
+  it("executes the wrapped function", () => {
+    const s = signal(0);
+    batch(() => {
+      s.set(5);
+      s.set(10);
+    });
+    expect(s()).toBe(10);
+  });
+
+  it("does not throw when no effects are tracking", () => {
+    const s = signal(0);
+    expect(() => { batch(() => { s.set(1); }); }).not.toThrow();
+    expect(s()).toBe(1);
+  });
+
+  it("propagates errors thrown inside the batch", () => {
+    expect(() =>
+      { batch(() => {
+        throw new Error("inside batch");
+      }); },
+    ).toThrow("inside batch");
+  });
+});

package/src/__tests__/component.test.ts

@@ -0,0 +1,58 @@
+import { describe, it, expect } from "vitest";
+
+import { RootComponent } from "../component/base";
+import { StatefulComponent } from "../component/stateful";
+
+class ConcreteRoot extends RootComponent<{ name: string }> {
+  render() { return null; }
+}
+
+class ConcreteStateful extends StatefulComponent {
+  render() { return null; }
+}
+
+describe("RootComponent", () => {
+  it("stores props on _rawProps", () => {
+    const c = new ConcreteRoot({ name: "Alice" });
+    expect(c._rawProps.name).toBe("Alice");
+  });
+
+  it("exposes props via .props getter", () => {
+    const c = new ConcreteRoot({ name: "Bob" });
+    expect(c.props.name).toBe("Bob");
+  });
+
+  it("_mounted starts as false", () => {
+    const c = new ConcreteRoot({ name: "" });
+    expect(c._mounted).toBe(false);
+  });
+
+  it("_anchor starts as undefined", () => {
+    const c = new ConcreteRoot({ name: "" });
+    expect(c._anchor).toBeUndefined();
+  });
+
+  it("defaults to empty object when no props given", () => {
+    const c = new ConcreteRoot();
+    expect(c._rawProps).toEqual({});
+  });
+});
+
+describe("StatefulComponent", () => {
+  it("_defaults starts as empty object", () => {
+    const c = new ConcreteStateful();
+    expect(c._defaults).toEqual({});
+  });
+
+  it("_stateDirty starts as false", () => {
+    const c = new ConcreteStateful();
+    expect(c._stateDirty).toBe(false);
+  });
+
+  it("_setProps replaces _rawProps contents", () => {
+    const c = new ConcreteStateful({ x: 1 });
+    c._setProps({ y: 2 });
+    expect((c._rawProps).x).toBeUndefined();
+    expect((c._rawProps).y).toBe(2);
+  });
+});

package/src/__tests__/computed.test.ts

@@ -0,0 +1,89 @@
+import { describe, it, expect, vi } from "vitest";
+
+import { computed } from "../signal/computed";
+import { signal } from "../signal/signal";
+
+describe("computed", () => {
+  it("derives value from signal", () => {
+    const s = signal(4);
+    const doubled = computed(() => s() * 2);
+    expect(doubled()).toBe(8);
+  });
+
+  it("updates when source signal changes", () => {
+    const s = signal(3);
+    const triple = computed(() => s() * 3);
+    s.set(5);
+    expect(triple()).toBe(15);
+  });
+
+  it("is lazy — does not recompute until accessed", () => {
+    const s = signal(1);
+    const fn = vi.fn(() => s() + 1);
+    const c = computed(fn);
+    expect(fn).not.toHaveBeenCalled();
+    c();
+    expect(fn).toHaveBeenCalledOnce();
+  });
+
+  it("caches value between reads when source has not changed", () => {
+    const s = signal(2);
+    const fn = vi.fn(() => s() * 10);
+    const c = computed(fn);
+    c();
+    c();
+    expect(fn).toHaveBeenCalledOnce();
+  });
+
+  it("recomputes after source change", () => {
+    const s = signal(1);
+    const fn = vi.fn(() => s() + 100);
+    const c = computed(fn);
+    c();
+    s.set(2);
+    c();
+    expect(fn).toHaveBeenCalledTimes(2);
+  });
+
+  it("marks __isComputed = true", () => {
+    const c = computed(() => 42);
+    expect(c.__isComputed).toBe(true);
+  });
+
+  it("chained computed values update correctly", () => {
+    const s = signal(1);
+    const doubled = computed(() => s() * 2);
+    const quadrupled = computed(() => doubled() * 2);
+    expect(quadrupled()).toBe(4);
+    s.set(3);
+    expect(quadrupled()).toBe(12);
+  });
+
+  it("subscribe fires immediately with computed value", () => {
+    const s = signal(5);
+    const c = computed(() => s() + 1);
+    const received: number[] = [];
+    c.subscribe((v) => received.push(v));
+    expect(received).toEqual([6]);
+  });
+
+  it("subscribe fires when source changes", () => {
+    const s = signal(0);
+    const c = computed(() => s() * 3);
+    const received: number[] = [];
+    c.subscribe((v) => received.push(v));
+    s.set(2);
+    s.set(4);
+    expect(received).toEqual([0, 6, 12]);
+  });
+
+  it("unsubscribe stops receiving updates", () => {
+    const s = signal(0);
+    const c = computed(() => s() + 1);
+    const received: number[] = [];
+    const unsub = c.subscribe((v) => received.push(v));
+    unsub();
+    s.set(10);
+    expect(received).toEqual([1]);
+  });
+});

package/src/__tests__/effect.test.ts

@@ -0,0 +1,54 @@
+import { describe, it, expect, vi } from "vitest";
+
+import { effect } from "../signal/effect";
+import { signal } from "../signal/signal";
+
+describe("effect", () => {
+  it("runs immediately on creation", () => {
+    const ran = vi.fn();
+    effect(ran);
+    expect(ran).toHaveBeenCalledOnce();
+  });
+
+  it("re-runs when a tracked signal changes", () => {
+    const s = signal(1);
+    const values: number[] = [];
+    effect(() => {
+      values.push(s());
+    });
+    s.set(2);
+    s.set(3);
+    expect(values).toEqual([1, 2, 3]);
+  });
+
+  it("stop() calls the cleanup function", () => {
+    const cleanupFn = vi.fn();
+    const stop = effect(() => cleanupFn);
+    stop();
+    expect(cleanupFn).toHaveBeenCalledOnce();
+  });
+
+  it("calls cleanup function before re-run", () => {
+    const s = signal(0);
+    const order: string[] = [];
+    effect(() => {
+      const v = s();
+      order.push(`run:${v}`);
+      return () => order.push(`cleanup`);
+    });
+    s.set(1);
+    expect(order).toEqual(["run:0", "cleanup", "run:1"]);
+  });
+
+  it("tracks multiple signals", () => {
+    const a = signal(1);
+    const b = signal(10);
+    const sums: number[] = [];
+    effect(() => {
+      sums.push(a() + b());
+    });
+    a.set(2);
+    b.set(20);
+    expect(sums).toEqual([11, 12, 22]);
+  });
+});

package/src/__tests__/peek.test.ts

@@ -0,0 +1,31 @@
+import { describe, it, expect } from "vitest";
+
+import { computed } from "../signal/computed";
+import { effect } from "../signal/effect";
+import { peek } from "../signal/peek";
+import { signal } from "../signal/signal";
+
+describe("peek", () => {
+  it("returns the current value without tracking", () => {
+    const s = signal(42);
+    expect(peek(s)).toBe(42);
+  });
+
+  it("does not subscribe the active effect when peeked", () => {
+    const s = signal(1);
+    const runs: number[] = [];
+
+    effect(() => {
+      runs.push(peek(s)); // peek — should not subscribe
+    });
+
+    s.set(99); // should NOT trigger re-run
+    expect(runs).toEqual([1]);
+  });
+
+  it("works with computed values", () => {
+    const s = signal(5);
+    const c = computed(() => s() * 2);
+    expect(peek(c)).toBe(10);
+  });
+});