@praxisjs/core 0.4.0 → 0.4.2

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @praxisjs/core
 
+## 0.4.2
+
+### Patch Changes
+
+- d11a10a: Fix `effect()` stop function not preventing re-runs
+
+  The function returned by `effect()` was only calling the cleanup callback but leaving the effect subscribed to all tracked signals, so it would keep re-running after being stopped. The stop function now sets a `stopped` flag that makes future invocations of the wrapped effect a no-op, and nullifies the cleanup reference to ensure idempotent behaviour.
+
+  This also fixes `$subscribe` unsubscription in `@praxisjs/store`, which relied on this mechanism to detach listeners.
+
+## 0.4.1
+
+### Patch Changes
+
+- fe39901: fix(core): fix effect subscription leak in `when()` when source is immediately truthy
+
+  When `source()` returned a truthy value on the first synchronous effect run, `stop` was still `undefined` at that point. The `stop?.()` call inside the callback was a no-op, leaving the effect subscribed forever — any future change to the source kept triggering the effect (which returned early via `disposed`, but still maintained its reactive tracking).
+
+  The implementation was refactored to use a `ref` object (`{ cancel }`) to hold the cancellation function. This allows `stop` to be declared as `const`, removes the optional chain on a non-nullable type, and ensures the effect is properly cancelled via `if (disposed) stop()` after the first synchronous run.
+
 ## 0.4.0
 
 ### Minor Changes

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

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

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

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

package/dist/__tests__/batch.test.js

@@ -0,0 +1,26 @@
+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");
+    });
+});
+//# sourceMappingURL=batch.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"batch.test.js","sourceRoot":"","sources":["../../src/__tests__/batch.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE;IACrB,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,KAAK,CAAC,GAAG,EAAE;YACT,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACT,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACZ,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QAC5D,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACtB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,CAAC,GAAG,EAAE;YACR,KAAK,CAAC,GAAG,EAAE;gBACX,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC;YAClC,CAAC,CAAC,CAAC;QAAC,CAAC,CACN,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

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

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

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

package/dist/__tests__/component.test.js

@@ -0,0 +1,68 @@
+import { describe, it, expect } from "vitest";
+import { RootComponent } from "../component/base";
+import { StatefulComponent } from "../component/stateful";
+import { StatelessComponent } from "../component/stateless";
+class ConcreteRoot extends RootComponent {
+    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);
+    });
+});
+class ConcreteStateless extends StatelessComponent {
+    render() { return null; }
+}
+describe("StatelessComponent", () => {
+    it("stores props on _rawProps", () => {
+        const c = new ConcreteStateless({ name: "Alice" });
+        expect(c._rawProps.name).toBe("Alice");
+    });
+    it("_setProps replaces _rawProps contents", () => {
+        const c = new ConcreteStateless({ name: "Alice" });
+        c._setProps({ name: "Bob" });
+        expect(c._rawProps.name).toBe("Bob");
+    });
+    it("_setProps removes old keys", () => {
+        const c = new ConcreteStateless({ name: "Alice" });
+        c._setProps({});
+        expect(c._rawProps.name).toBeUndefined();
+    });
+});
+//# sourceMappingURL=component.test.js.map

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

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

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

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

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

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

package/dist/__tests__/computed.test.js

@@ -0,0 +1,112 @@
+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 = [];
+        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 = [];
+        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 = [];
+        const unsub = c.subscribe((v) => received.push(v));
+        unsub();
+        s.set(10);
+        expect(received).toEqual([1]);
+    });
+    it("computeFn that throws propagates the error on read", () => {
+        const s = signal(true);
+        const c = computed(() => {
+            if (s())
+                throw new Error("compute error");
+            return 0;
+        });
+        expect(() => c()).toThrow("compute error");
+    });
+    it("dynamic dependency: switches tracked signal based on condition", () => {
+        const toggle = signal(true);
+        const a = signal(10);
+        const b = signal(20);
+        const c = computed(() => (toggle() ? a() : b()));
+        expect(c()).toBe(10);
+        a.set(11);
+        expect(c()).toBe(11);
+        toggle.set(false);
+        expect(c()).toBe(20);
+        b.set(21);
+        expect(c()).toBe(21);
+    });
+    it("unsubscribe then re-subscribe works correctly", () => {
+        const s = signal(1);
+        const c = computed(() => s() * 3);
+        const received = [];
+        const unsub = c.subscribe((v) => received.push(v));
+        unsub();
+        // Re-subscribe
+        c.subscribe((v) => received.push(v));
+        s.set(2);
+        expect(received).toContain(6);
+    });
+});
+//# sourceMappingURL=computed.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"computed.test.js","sourceRoot":"","sources":["../../src/__tests__/computed.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAElD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;IACxB,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QACxC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QACvC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACT,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;QACvB,MAAM,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QAClC,CAAC,EAAE,CAAC;QACJ,MAAM,CAAC,EAAE,CAAC,CAAC,oBAAoB,EAAE,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;QACjC,MAAM,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;QACvB,CAAC,EAAE,CAAC;QACJ,CAAC,EAAE,CAAC;QACJ,MAAM,CAAC,EAAE,CAAC,CAAC,oBAAoB,EAAE,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC;QAClC,MAAM,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;QACvB,CAAC,EAAE,CAAC;QACJ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACT,CAAC,EAAE,CAAC;QACJ,MAAM,CAAC,EAAE,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAC7B,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QACxC,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;QACjD,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACT,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACrC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACT,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACT,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACnD,KAAK,EAAE,CAAC;QACR,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACV,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QACvB,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE;YACtB,IAAI,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;YAC1C,OAAO,CAAC,CAAC;QACX,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5B,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;QACrB,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;QACrB,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAEjD,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrB,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACV,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAErB,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAClB,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrB,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACV,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,MAAM,KAAK,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACnD,KAAK,EAAE,CAAC;QAER,eAAe;QACf,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACrC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACT,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

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

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

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

package/dist/__tests__/effect.test.js

@@ -0,0 +1,84 @@
+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 = [];
+        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 = [];
+        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 = [];
+        effect(() => {
+            sums.push(a() + b());
+        });
+        a.set(2);
+        b.set(20);
+        expect(sums).toEqual([11, 12, 22]);
+    });
+    it("stop() prevents future re-runs", () => {
+        const s = signal(0);
+        const values = [];
+        const stop = effect(() => {
+            values.push(s());
+        });
+        stop();
+        s.set(99);
+        expect(values).toEqual([0]); // only initial run
+    });
+    it("effect with no reactive dependencies runs once only", () => {
+        const ran = vi.fn();
+        effect(() => {
+            ran(); // no signal reads
+        });
+        expect(ran).toHaveBeenCalledTimes(1);
+        // No signal changes possible — just verify it doesn't re-run spontaneously
+        expect(ran).toHaveBeenCalledTimes(1);
+    });
+    it("stop() with no cleanup function does not throw", () => {
+        const stop = effect(() => { });
+        expect(() => stop()).not.toThrow();
+    });
+    it("cleanup is re-invoked before each re-run", () => {
+        const s = signal(0);
+        const cleanupCount = { n: 0 };
+        effect(() => {
+            s(); // track
+            return () => { cleanupCount.n++; };
+        });
+        s.set(1);
+        s.set(2);
+        // cleanup called once before second run, once before third run
+        expect(cleanupCount.n).toBe(2);
+    });
+});
+//# sourceMappingURL=effect.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"effect.test.js","sourceRoot":"","sources":["../../src/__tests__/effect.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAElD,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;IACtB,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACpB,MAAM,CAAC,GAAG,CAAC,CAAC;QACZ,MAAM,CAAC,GAAG,CAAC,CAAC,oBAAoB,EAAE,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,CAAC,GAAG,EAAE;YACV,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;QACnB,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACT,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACT,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,SAAS,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,EAAE,CAAC;QACP,MAAM,CAAC,SAAS,CAAC,CAAC,oBAAoB,EAAE,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,EAAE;YACV,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YACd,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACvB,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACT,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;QACrB,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,EAAE;YACV,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACT,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACV,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,EAAE;YACvB,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;QACnB,CAAC,CAAC,CAAC;QACH,IAAI,EAAE,CAAC;QACP,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACV,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,mBAAmB;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACpB,MAAM,CAAC,GAAG,EAAE;YACV,GAAG,EAAE,CAAC,CAAC,kBAAkB;QAC3B,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QACrC,2EAA2E;QAC3E,MAAM,CAAC,GAAG,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,EAAE,GAAyB,CAAC,CAAC,CAAC;QACrD,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,YAAY,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QAC9B,MAAM,CAAC,GAAG,EAAE;YACV,CAAC,EAAE,CAAC,CAAC,QAAQ;YACb,OAAO,GAAG,EAAE,GAAG,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACT,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACT,+DAA+D;QAC/D,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

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

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

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

package/dist/__tests__/peek.test.js

@@ -0,0 +1,26 @@
+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 = [];
+        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);
+    });
+});
+//# sourceMappingURL=peek.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"peek.test.js","sourceRoot":"","sources":["../../src/__tests__/peek.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE;IACpB,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,IAAI,GAAa,EAAE,CAAC;QAE1B,MAAM,CAAC,GAAG,EAAE;YACV,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,8BAA8B;QACpD,CAAC,CAAC,CAAC;QAEH,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,4BAA4B;QACvC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

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

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

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

package/dist/__tests__/persisted-signal.test.js

@@ -0,0 +1,122 @@
+// @vitest-environment jsdom
+import { describe, it, expect, beforeEach, vi } from "vitest";
+import { persistedSignal } from "../signal/persisted";
+beforeEach(() => {
+    localStorage.clear();
+});
+describe("persistedSignal", () => {
+    it("returns initialValue when nothing is stored", () => {
+        const s = persistedSignal("key1", 42);
+        expect(s()).toBe(42);
+    });
+    it("reads existing value from localStorage", () => {
+        localStorage.setItem("key2", "99");
+        const s = persistedSignal("key2", 0);
+        expect(s()).toBe(99);
+    });
+    it("persists set() to localStorage", () => {
+        const s = persistedSignal("key3", 0);
+        s.set(7);
+        expect(localStorage.getItem("key3")).toBe("7");
+        expect(s()).toBe(7);
+    });
+    it("persists update() to localStorage", () => {
+        const s = persistedSignal("key4", 10);
+        s.update((v) => v + 5);
+        expect(localStorage.getItem("key4")).toBe("15");
+        expect(s()).toBe(15);
+    });
+    it("removes the key when set to null", () => {
+        const s = persistedSignal("key5", "hello");
+        s.set(null);
+        expect(localStorage.getItem("key5")).toBeNull();
+    });
+    it("marks __isSignal = true", () => {
+        const s = persistedSignal("key6", 0);
+        expect(s.__isSignal).toBe(true);
+    });
+    it("supports custom serialize/deserialize", () => {
+        const s = persistedSignal("key7", { x: 1 }, {
+            serialize: (v) => JSON.stringify(v),
+            deserialize: (raw) => JSON.parse(raw),
+        });
+        s.set({ x: 99 });
+        expect(localStorage.getItem("key7")).toBe('{"x":99}');
+        const s2 = persistedSignal("key7", { x: 0 }, {
+            serialize: JSON.stringify,
+            deserialize: (raw) => JSON.parse(raw),
+        });
+        expect(s2().x).toBe(99);
+    });
+    it("falls back to initialValue when deserialization fails", () => {
+        const warn = vi.spyOn(console, "warn").mockImplementation(() => { });
+        localStorage.setItem("key8", "{ bad json");
+        const s = persistedSignal("key8", 42);
+        expect(s()).toBe(42);
+        warn.mockRestore();
+    });
+    it("syncs from storage event on other tab", () => {
+        const s = persistedSignal("key9", 1);
+        window.dispatchEvent(new StorageEvent("storage", {
+            key: "key9",
+            newValue: "55",
+            storageArea: localStorage,
+        }));
+        expect(s()).toBe(55);
+    });
+    it("syncTabs=false does not add storage listener", () => {
+        const s = persistedSignal("key10", 1, { syncTabs: false });
+        s.set(5);
+        // Just verify it works without errors
+        expect(s()).toBe(5);
+    });
+    it("warns and falls back to initialValue when serialize throws on set", () => {
+        const warn = vi.spyOn(console, "warn").mockImplementation(() => { });
+        const s = persistedSignal("key11", { x: 1 }, {
+            serialize: () => { throw new Error("serialize fail"); },
+            deserialize: JSON.parse,
+        });
+        expect(() => s.set({ x: 2 })).not.toThrow();
+        expect(warn).toHaveBeenCalledWith(expect.stringContaining("Failed to serialize"), expect.any(Error));
+        warn.mockRestore();
+    });
+    it("syncs to initialValue when storage event has newValue=null (key removed)", () => {
+        const s = persistedSignal("key12", 42);
+        s.set(99);
+        window.dispatchEvent(new StorageEvent("storage", {
+            key: "key12",
+            newValue: null, // key removed in another tab
+            storageArea: localStorage,
+        }));
+        expect(s()).toBe(42); // falls back to initialValue
+    });
+    it("warns and falls back to initialValue when storage event deserialization fails", () => {
+        const warn = vi.spyOn(console, "warn").mockImplementation(() => { });
+        const s = persistedSignal("key13", 0, {
+            deserialize: () => { throw new Error("bad"); },
+        });
+        window.dispatchEvent(new StorageEvent("storage", {
+            key: "key13",
+            newValue: "invalid",
+            storageArea: localStorage,
+        }));
+        expect(s()).toBe(0);
+        expect(warn).toHaveBeenCalledWith(expect.stringContaining("Failed to deserialize"), expect.any(Error));
+        warn.mockRestore();
+    });
+    it("ignores storage events from other keys", () => {
+        const s = persistedSignal("key14", 1);
+        window.dispatchEvent(new StorageEvent("storage", {
+            key: "other-key",
+            newValue: "999",
+            storageArea: localStorage,
+        }));
+        expect(s()).toBe(1);
+    });
+    it("set(undefined) removes the key from localStorage", () => {
+        const s = persistedSignal("key15", 5);
+        s.set(undefined);
+        expect(localStorage.getItem("key15")).toBeNull();
+    });
+});
+//# sourceMappingURL=persisted-signal.test.js.map

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

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

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

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

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

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