rexfect 0.0.7

package/dist/effect.test.js

@@ -0,0 +1,123 @@
+import { describe, it, expect, vi } from "vitest";
+import { atom } from "./atom";
+import { effect } from "./effect";
+describe("effect", () => {
+    it("should run immediately on creation", () => {
+        const fn = vi.fn();
+        effect(fn);
+        expect(fn).toHaveBeenCalledTimes(1);
+    });
+    it("should track dependencies and re-run on change", () => {
+        const [count, setCount] = atom(0);
+        const fn = vi.fn(() => {
+            count(); // track dependency
+        });
+        effect(fn);
+        expect(fn).toHaveBeenCalledTimes(1);
+        setCount(1);
+        expect(fn).toHaveBeenCalledTimes(2);
+    });
+    it("should provide context with nth counter", () => {
+        const [count, setCount] = atom(0);
+        const nthValues = [];
+        effect((ctx) => {
+            nthValues.push(ctx.nth);
+            count();
+        });
+        setCount(1);
+        setCount(2);
+        expect(nthValues).toEqual([0, 1, 2]);
+    });
+    it("should provide name from options in context", () => {
+        let receivedName;
+        effect((ctx) => {
+            receivedName = ctx.key;
+        }, { key: "testEffect" });
+        expect(receivedName).toBe("testEffect");
+    });
+    it("should have undefined name when not provided", () => {
+        let receivedName = "initial";
+        effect((ctx) => {
+            receivedName = ctx.key;
+        });
+        expect(receivedName).toBeUndefined();
+    });
+    it("should dispose when dispose function is called", () => {
+        const [count, setCount] = atom(0);
+        const fn = vi.fn(() => {
+            count();
+        });
+        const dispose = effect(fn);
+        expect(fn).toHaveBeenCalledTimes(1);
+        dispose();
+        setCount(1);
+        expect(fn).toHaveBeenCalledTimes(1); // not called again
+    });
+    it("should handle errors with onError handler", () => {
+        const errorHandler = vi.fn();
+        const error = new Error("test error");
+        effect((ctx) => {
+            ctx.onError(errorHandler);
+            throw error;
+        });
+        expect(errorHandler).toHaveBeenCalledWith(error);
+    });
+    it("should rethrow errors if no onError handler", () => {
+        const error = new Error("test error");
+        expect(() => {
+            effect(() => {
+                throw error;
+            });
+        }).toThrow(error);
+    });
+    it("should support use() for plugins", () => {
+        const plugin = vi.fn((ctx) => {
+            return ctx.nth * 2;
+        });
+        effect((ctx) => {
+            const result = ctx.use(plugin);
+            expect(result).toBe(0);
+        });
+    });
+    it("should throw error if effect returns a Promise", () => {
+        // Using async function (returns Promise)
+        expect(() => {
+            effect(async () => {
+                await Promise.resolve();
+            });
+        }).toThrow("effect() received an async function");
+    });
+    it("should throw error if effect returns a Promise-like object", () => {
+        // Returning a thenable object
+        expect(() => {
+            effect(() => {
+                return { then: () => { } };
+            });
+        }).toThrow("effect() received an async function");
+    });
+    it("should throw error if effect returns a plain Promise", () => {
+        // Explicitly returning a Promise
+        expect(() => {
+            effect(() => {
+                return Promise.resolve("value");
+            });
+        }).toThrow("effect() received an async function");
+    });
+    it("should not throw for effects that return undefined", () => {
+        // Normal effect that returns nothing
+        expect(() => {
+            effect(() => {
+                // do something
+            });
+        }).not.toThrow();
+    });
+    it("should not throw for effects that return non-Promise values", () => {
+        // Effect that returns a value (unusual but allowed)
+        expect(() => {
+            effect(() => {
+                return "some value";
+            });
+        }).not.toThrow();
+    });
+});
+//# sourceMappingURL=effect.test.js.map

package/dist/effect.test.js.map

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

package/dist/emitter.d.ts

@@ -0,0 +1,129 @@
+import { Listener, SingleOrMultipleListeners } from "./types";
+/**
+ * Event emitter interface for pub/sub pattern.
+ *
+ * @template T - The type of payload emitted to listeners (defaults to void)
+ */
+export interface Emitter<T = void> {
+    /**
+     * Subscribe to events with one or more listeners.
+     *
+     * @param listeners - Single listener or array of listeners
+     * @returns Unsubscribe function (idempotent - safe to call multiple times)
+     */
+    on(listeners: SingleOrMultipleListeners<T>): VoidFunction;
+    /**
+     * Subscribe with a mapping function that filters and transforms events.
+     *
+     * The map function receives the emitted value and returns either:
+     * - `{ value: TValue }` - Listener is called with the transformed value
+     * - `undefined` - Listener is NOT called (event filtered out)
+     *
+     * @template TValue - The transformed value type passed to listeners
+     * @param map - Transform function that can filter (return undefined) or map values
+     * @param listeners - Single listener or array of listeners for transformed values
+     * @returns Unsubscribe function
+     *
+     * @example Filter and transform
+     * ```ts
+     * const emitter = emitter<{ type: string; data: number }>();
+     *
+     * // Only listen to 'success' events, extract just the data
+     * emitter.on(
+     *   (event) => event.type === 'success' ? { value: event.data } : undefined,
+     *   (data) => console.log('Success data:', data)
+     * );
+     * ```
+     */
+    on<TValue>(map: (value: T) => {
+        value: TValue;
+    } | undefined, listeners: SingleOrMultipleListeners<TValue>): VoidFunction;
+    /**
+     * Emit an event to all registered listeners.
+     *
+     * @param payload - The value to pass to all listeners
+     */
+    emit(payload: T): void;
+    /**
+     * Emit an event to all registered listeners in LIFO (reverse) order.
+     * Useful for cleanup scenarios where resources should be released
+     * in reverse order of acquisition.
+     *
+     * @param payload - The value to pass to all listeners
+     */
+    emitLifo(payload: T): void;
+    /**
+     * Remove all registered listeners.
+     */
+    clear(): void;
+    /**
+     * Emit an event to all listeners, then clear all listeners.
+     * Useful for one-time events like disposal.
+     *
+     * @param payload - The value to pass to all listeners
+     */
+    emitAndClear(payload: T): void;
+    /**
+     * Emit an event to all listeners in LIFO (reverse) order, then clear.
+     * Useful for cleanup scenarios where resources should be released
+     * in reverse order of acquisition.
+     *
+     * @param payload - The value to pass to all listeners
+     */
+    emitAndClearLifo(payload: T): void;
+    /**
+     * Emit to all listeners, clear, and "settle" the emitter.
+     *
+     * After settling:
+     * - Any new `on()` call immediately invokes the listener with the settled payload
+     * - Returns a no-op unsubscribe function
+     * - `emit()` and `emitAndClear()` become no-ops
+     *
+     * Useful for one-time events where late subscribers should still receive the value
+     * (similar to Promise behavior).
+     *
+     * @param payload - The final value to pass to all listeners
+     */
+    settle(payload: T): void;
+    /** Number of registered listeners */
+    readonly size: number;
+    /** Whether the emitter has been settled */
+    readonly settled: boolean;
+}
+/**
+ * Creates an event emitter for managing and notifying listeners.
+ *
+ * An emitter provides a simple pub/sub pattern for managing event listeners.
+ * It's used internally by signals and effects to manage subscriptions and notifications.
+ *
+ * Features:
+ * - Add listeners that will be notified when events are emitted
+ * - Emit events to all registered listeners
+ * - Remove listeners via unsubscribe functions
+ * - Clear all listeners at once
+ * - Safe to call unsubscribe multiple times (idempotent)
+ *
+ * @template T - The type of payload that will be emitted to listeners (defaults to void)
+ * @returns An emitter object with add, emit, and clear methods
+ *
+ * @example
+ * ```ts
+ * const eventEmitter = emitter<string>();
+ *
+ * // Subscribe to events
+ * const unsubscribe = eventEmitter.on((message) => {
+ *   console.log('Received:', message);
+ * });
+ *
+ * // Emit an event
+ * eventEmitter.emit('Hello'); // Logs: "Received: Hello"
+ *
+ * // Unsubscribe
+ * unsubscribe();
+ *
+ * // Clear all listeners
+ * eventEmitter.clear();
+ * ```
+ */
+export declare function emitter<T = void>(initialListeners?: Listener<T>[]): Emitter<T>;
+//# sourceMappingURL=emitter.d.ts.map

package/dist/emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.d.ts","sourceRoot":"","sources":["../src/emitter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAE9D;;;;GAIG;AACH,MAAM,WAAW,OAAO,CAAC,CAAC,GAAG,IAAI;IAC/B;;;;;OAKG;IACH,EAAE,CAAC,SAAS,EAAE,yBAAyB,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC;IAE1D;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,EAAE,CAAC,MAAM,EACP,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,EAChD,SAAS,EAAE,yBAAyB,CAAC,MAAM,CAAC,GAC3C,YAAY,CAAC;IAEhB;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC;IAEvB;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC;IAE3B;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;;;;OAKG;IACH,YAAY,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC;IAE/B;;;;;;OAMG;IACH,gBAAgB,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC;IAEnC;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC;IAEzB,qCAAqC;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,2CAA2C;IAC3C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AA4ID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,OAAO,CAAC,CAAC,GAAG,IAAI,EAC9B,gBAAgB,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,GAC/B,OAAO,CAAC,CAAC,CAAC,CAEZ"}

package/dist/emitter.js

@@ -0,0 +1,164 @@
+const noop = () => { };
+/**
+ * Class-based emitter implementation for better V8 optimization.
+ * All instances share methods via prototype.
+ */
+class EmitterImpl {
+    /** Set of registered listeners */
+    _listeners;
+    /** Settled payload (if settled) */
+    _settledPayload = undefined;
+    /** Whether the emitter has been settled */
+    _isSettled = false;
+    /** Bound version of on() for passing as callback */
+    on;
+    constructor(initialListeners) {
+        this._listeners = new Set(initialListeners);
+        // Bind 'on' to preserve 'this' context when passed as callback
+        this.on = this._on.bind(this);
+    }
+    get size() {
+        return this._listeners.size;
+    }
+    get settled() {
+        return this._isSettled;
+    }
+    _on(listenersOrMap, mappedListeners) {
+        let newListeners;
+        if (mappedListeners === undefined) {
+            // Simple form: on(listeners)
+            newListeners = Array.isArray(listenersOrMap)
+                ? listenersOrMap
+                : [listenersOrMap];
+        }
+        else {
+            // Mapped form: on(map, listeners)
+            const map = listenersOrMap;
+            const sourceListeners = Array.isArray(mappedListeners)
+                ? mappedListeners
+                : [mappedListeners];
+            newListeners = [
+                (value) => {
+                    const mappedValue = map(value);
+                    if (mappedValue) {
+                        for (let i = 0; i < sourceListeners.length; i++) {
+                            sourceListeners[i](mappedValue.value);
+                        }
+                    }
+                },
+            ];
+        }
+        // If settled, call listeners immediately and return no-op
+        if (this._isSettled) {
+            const payload = this._settledPayload;
+            for (let i = 0; i < newListeners.length; i++) {
+                newListeners[i](payload);
+            }
+            return noop;
+        }
+        const listeners = this._listeners;
+        for (let i = 0; i < newListeners.length; i++) {
+            listeners.add(newListeners[i]);
+        }
+        return () => {
+            for (let i = 0; i < newListeners.length; i++) {
+                listeners.delete(newListeners[i]);
+            }
+        };
+    }
+    emit(payload) {
+        if (this._isSettled)
+            return;
+        this._doEmit(payload, false, false);
+    }
+    emitLifo(payload) {
+        if (this._isSettled)
+            return;
+        this._doEmit(payload, false, true);
+    }
+    clear() {
+        this._listeners.clear();
+    }
+    emitAndClear(payload) {
+        if (this._isSettled)
+            return;
+        this._doEmit(payload, true, false);
+    }
+    emitAndClearLifo(payload) {
+        if (this._isSettled)
+            return;
+        this._doEmit(payload, true, true);
+    }
+    settle(payload) {
+        if (this._isSettled)
+            return;
+        this._settledPayload = payload;
+        this._isSettled = true;
+        this._doEmit(payload, true, false);
+    }
+    /**
+     * Internal emit implementation.
+     * Creates snapshot to handle modifications during iteration.
+     */
+    _doEmit(payload, clear, lifo) {
+        const listeners = this._listeners;
+        const size = listeners.size;
+        if (size === 0)
+            return;
+        // Create snapshot - necessary because Set.forEach includes items added during iteration
+        const copy = Array.from(listeners);
+        if (clear) {
+            listeners.clear();
+        }
+        // Use traditional for loop for maximum performance
+        if (lifo) {
+            for (let i = size - 1; i >= 0; i--) {
+                copy[i](payload);
+            }
+        }
+        else {
+            for (let i = 0; i < size; i++) {
+                copy[i](payload);
+            }
+        }
+    }
+}
+/**
+ * Creates an event emitter for managing and notifying listeners.
+ *
+ * An emitter provides a simple pub/sub pattern for managing event listeners.
+ * It's used internally by signals and effects to manage subscriptions and notifications.
+ *
+ * Features:
+ * - Add listeners that will be notified when events are emitted
+ * - Emit events to all registered listeners
+ * - Remove listeners via unsubscribe functions
+ * - Clear all listeners at once
+ * - Safe to call unsubscribe multiple times (idempotent)
+ *
+ * @template T - The type of payload that will be emitted to listeners (defaults to void)
+ * @returns An emitter object with add, emit, and clear methods
+ *
+ * @example
+ * ```ts
+ * const eventEmitter = emitter<string>();
+ *
+ * // Subscribe to events
+ * const unsubscribe = eventEmitter.on((message) => {
+ *   console.log('Received:', message);
+ * });
+ *
+ * // Emit an event
+ * eventEmitter.emit('Hello'); // Logs: "Received: Hello"
+ *
+ * // Unsubscribe
+ * unsubscribe();
+ *
+ * // Clear all listeners
+ * eventEmitter.clear();
+ * ```
+ */
+export function emitter(initialListeners) {
+    return new EmitterImpl(initialListeners);
+}
+//# sourceMappingURL=emitter.js.map

package/dist/emitter.js.map

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

package/dist/emitter.test.d.ts

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

package/dist/emitter.test.d.ts.map

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