easy-signal 3.2.6 → 4.0.0

package/README.md

@@ -1,8 +1,8 @@
 # Easy Signal
 
-Two simple interfaces for creating two types of signals. The first (and original signal in this module) is a defined
-event that can be triggered and listened to with a single function. The second is a defined data store that allows you
-to react to changes to that data (popularized by solid-js). These two are `EventSignal` and `ReactiveSignal`.
+Two interfaces for creating two types of signals. The first (and original signal in this module) is a function that
+defines an event and can be triggered and listened to with the single function. The second is a reactive data store that
+allows to react to changes (popularized by solid-js). These two are `Signal` and `Atom`.
 
 Full type safety with TypeScript with both use-cases.
 
@@ -12,24 +12,24 @@ Full type safety with TypeScript with both use-cases.
 npm install easy-signal
 ```
 
-## EventSignal Usage
+## Signal Usage
 
-An EventSignal is a function that represents a single event. The function can be used to subscribe to be notified of
+A Signal is a function that represents a single event. The function can be used to subscribe to be notified of
 the events as well as to trigger them.
 
-EventSignals offer similar functionality as the browser's `eventDispatcher` API, but rather than a general API for any
+Signals offer similar functionality as the browser's `eventDispatcher` API, but rather than a general API for any
 event, each event would use its own signal. This allows each signal to have a specific function signature as opposed to
 the browser's generic `event` object. This is a great system in TypeScript being able to see the exact data each event
 produces.
 
-### EventSignal Basic Usage
+### Signal Basic Usage
 
 ```ts
 // file seconds.ts
-import { eventSignal } from 'easy-signal';
+import { signal } from 'easy-signal';
 
 // Create the signal and export it for use. Optionally provide the subscriber signature
-export const onSecond = eventSignal<number>();
+export const onSecond = signal<number>();
 
 // Passing a non-function value will dispatch the event
 setInterval(() => {
@@ -51,9 +51,9 @@ Errors may also be listened to from the signal by passing `ForErrors` as the sec
 and errors may be dispatched by passing an Error object to the signal method.
 
 ```ts
-import { eventSignal, ForErrors } from 'easy-signal';
+import { signal, ForErrors } from 'easy-signal';
 
-const dataStream = eventSignal();
+const dataStream = signal();
 
 dataStream(data => console.log('data is:' data));
 dataStream(error => console.log('Error is:' error), ForErrors);
@@ -65,10 +65,10 @@ stream.on('error', err => dataStream(err));
 To get a subscriber-only method for external use, pass in the `GetOnSignal` constant.
 
 ```ts
-import { eventSignal, GetOnSignal } from 'easy-signal';
+import { signal, GetOnSignal } from 'easy-signal';
 
 function getMyAPI() {
-  const doSomething = eventSignal();
+  const doSomething = signal();
 
   // doSomething() will trigger subscribers that were added in onSomething(...). This protects the signal from being
   // triggered/dispatched outside of `getMyAPI`. Sometimes you may want more control to prevent just anyone from
@@ -90,32 +90,30 @@ const onSomething = signal();
 onSomething(ClearSignal); // clears signal
 ```
 
-## ReactiveSignal Usage
+## Atom Usage
 
-A ReactiveSignal is a function that represents a single piece of data. The function can be used to get the data, set the
-data, and update the data with an updater function. To subscribe to changes use the separate `subscribe` function. The
-ReactiveSignal allows for Observers to be created, which are functions that will be rerun whenever any ReactiveSignals
-they access are updated, and ComputedSignals which are read-only signals whose value is derived from other signals and
-which will be updated whenever they are.
+An Atom is a function that represents a single piece of data. The function can be used to get the data and set the
+data. A `subscribe` function allows reacting to changes on the data in an atom. An `observe` function allows for a
+function to be rerun whenever any atoms it depends on are changed. And a `derived` function allows a readonly atom to
+be created which depends on, or is derived from, other atoms.
 
-### ReactiveSignal Basic Usage
+### Atom Basic Usage
 
-Here we will use an example similar to the EventSignal, but unlike the EventSignal, the current seconds since epoch will
-be stored and can be accessed any time, whereas the EventSignal only fires an event with the data provided. This
+Here we will use an example similar to the Signal, but unlike the Signal, the current seconds since epoch will
+be stored and can be accessed any time, whereas the Signal only fires an event with the data provided. This
 particular example isn't very compelling.
 
 ```ts
 // file seconds.ts
-import { reactiveSignal } from 'easy-signal';
+import { atom } from 'easy-signal';
 
 // Create the signal and export it for use. Optionally provide the subscriber signature
-export const onSecond = reactiveSignal(0);
+export const onSecond = atom(0);
 
 // Passing a non-function value will dispatch the event
 setInterval(() => {
   const currentSecond = Math.floor(Date.now() / 1000);
   onSecond(currentSecond);
-  // or onSecond(currentValue => newValue) to update
 });
 ```
 
@@ -131,36 +129,39 @@ const unsubscribe = onSecond.subscribe(seconds => {
 });
 ```
 
-### Observer Basic Usage
+### `observe` Basic Usage
 
-To take action whenever data changes, you can observe or more signals by accessing them in a function call. You can also
-prevent that function from being called too often when data changes by using the Timings. Below, we update the content
-of the DOM whenever the user or billing data is updated, but we only do it after an animation frame to prevent the DOM
-updates from being too frequent. Providing no Timing will call the function immediately after any data is changed.
+To take action whenever data changes, you can observe one or more signals by accessing them in a function call. Below,
+we update the content of the DOM whenever the user or billing data is updated, but we only do it after an animation
+frame to prevent the DOM updates from being too frequent.
 
 Because `user()` and `billing()` are called the first time the observe function is run, it automatically subscribes to
 know when they are changed so that the function may be rerun.
 
 ```ts
-import { reactiveSignal, observe, Timing } from 'easy-signal';
+import { atom, observe, onAnimationFrame } from 'easy-signal';
 
-const user = reactiveSignal(userData);
-const billing = reactiveSignal(billingData);
+const user = atom(userData);
+const billing = atom(billingData);
 
-const unobserve = observe(() => {
+const updateDom = onAnimationFrame((name, plan) => {
   document.body.innerText = `${user().name} has the plan ${billing().plan}`;
-}, Timing.AnimationFrame);
+});
+
+const unobserve = observe(() => {
+  updateDom(user().name, billing().plan);
+});
 ```
 
-### ComputedSignal Basic Usage
+### `derived` Basic Usage
 
 Create read-only signals whose value is derived from other signals and which will be updated whenever they are.
 
 ```ts
-import { computedSignal } from 'easy-signal';
+import { derived } from 'easy-signal';
 import { user, billing } from 'my-other-signals';
 
-const delinquent = computedSignal(() => {
+const delinquent = derived(() => {
   if (user().subscribed) {
     return billing().status === 'delinquent';
   }

package/dist/atom.d.ts

@@ -0,0 +1,40 @@
+import type { Subscriber, Unsubscriber } from './types';
+export type Invalidator<T> = (value?: T) => void;
+export type StartStopNotifier<T> = (set: Atom<T>) => Unsubscriber | void;
+export type { Subscriber, Unsubscriber };
+export interface Derived<T> {
+    /**
+     * Return the current value.
+     */
+    (): T;
+    /**
+     * Subscribe to changes with a callback. Returns an unsubscribe function.
+     */
+    subscribe(callback: Subscriber<T>, invalidate?: Invalidator<T>): Unsubscriber;
+}
+export interface Atom<T> extends Derived<T> {
+    /**
+     * Set the value and inform subscribers.
+     */
+    (value: T): void;
+    /**
+     * @deprecated use atom(value) instead, kept for Svelte 3 compatibility (e.g. $store = value)
+     */
+    set(value: T): void;
+}
+/**
+ * Creates a `Readable` atom that allows reading by subscription.
+ */
+export declare function readable<T>(value?: T, start?: StartStopNotifier<T>): Derived<T>;
+/**
+ * Create a `Writable` atom that allows both updating and reading by subscription.
+ */
+export declare function atom<T>(value: T, start?: StartStopNotifier<T>): Atom<T>;
+/**
+ * Observe atoms and derived values by synchronizing one or more readable atoms within an aggregation function.
+ */
+export declare function observe<T>(fn: () => T): Unsubscriber;
+/**
+ * Create a `Readable` atom that derives its value from other atoms and updates when those atoms change.
+ */
+export declare function derived<T>(fn: () => T, initialValue?: T): Derived<T>;

package/dist/atom.js

@@ -0,0 +1,137 @@
+const noop = () => { };
+// Ensure 2 versions of the signal library can work together
+const symbol = Symbol.for('reactiveAtoms');
+const root = globalThis[symbol] ||
+    (globalThis[symbol] = {
+        context: null,
+        subscriberQueue: new Map(),
+        trackingDependencies: null,
+    });
+/**
+ * Creates a `Readable` atom that allows reading by subscription.
+ */
+export function readable(value, start) {
+    const core = atom(value, start);
+    const readable = () => core();
+    return Object.assign(readable, { subscribe: core.subscribe });
+}
+/**
+ * Create a `Writable` atom that allows both updating and reading by subscription.
+ */
+export function atom(value, start = noop) {
+    let stop;
+    let started = false;
+    const subscribers = new Map();
+    function atom(newValue) {
+        if (newValue === undefined) {
+            if (!subscribers.size && !started) {
+                started = true;
+                try {
+                    (start(atom) || noop)();
+                }
+                finally {
+                    started = false;
+                }
+            }
+            if (root.trackingDependencies) {
+                root.trackingDependencies.add(atom);
+            }
+            return value;
+        }
+        else if (value !== newValue) {
+            value = newValue;
+            if (stop) {
+                // atom is ready
+                const runQueue = !root.subscriberQueue.size;
+                subscribers.forEach((invalidate, subscriber) => {
+                    if (!root.subscriberQueue.has(subscriber)) {
+                        invalidate();
+                    }
+                    else {
+                        // move to the end of the queue
+                        root.subscriberQueue.delete(subscriber);
+                    }
+                    root.subscriberQueue.set(subscriber, value);
+                });
+                if (runQueue) {
+                    const iter = root.subscriberQueue.entries();
+                    while (root.subscriberQueue.size > 0) {
+                        const [subscriber, value] = iter.next().value;
+                        root.subscriberQueue.delete(subscriber);
+                        subscriber(value);
+                    }
+                }
+            }
+        }
+    }
+    function subscribe(subscriber, invalidate = noop) {
+        subscribers.set(subscriber, invalidate);
+        if (subscribers.size === 1) {
+            stop = start(atom) || noop;
+        }
+        invalidate();
+        subscriber(value);
+        return () => {
+            subscribers.delete(subscriber);
+            if (subscribers.size === 0) {
+                stop();
+                stop = null;
+            }
+        };
+    }
+    return Object.assign(atom, { subscribe, set: (value) => atom(value) });
+}
+/**
+ * Observe atoms and derived values by synchronizing one or more readable atoms within an aggregation function.
+ */
+export function observe(fn) {
+    return derived(fn).subscribe(noop);
+}
+/**
+ * Create a `Readable` atom that derives its value from other atoms and updates when those atoms change.
+ */
+export function derived(fn, initialValue) {
+    const dependencies = new Map();
+    return readable(initialValue, set => {
+        let inited = false;
+        let pending = 0;
+        const subscriber = () => --pending === 0 && inited && sync();
+        const invalidate = () => pending++;
+        const sync = () => {
+            const [oldDeps, newDeps] = trackDependencies(new Set(dependencies.keys()), () => {
+                const result = fn();
+                set(result);
+            });
+            oldDeps.forEach(dep => {
+                dependencies.get(dep)();
+                dependencies.delete(dep);
+            });
+            inited = false;
+            newDeps.forEach(atom => {
+                const unsubscribe = atom.subscribe(subscriber, invalidate);
+                dependencies.set(atom, unsubscribe);
+            });
+            inited = true;
+        };
+        sync();
+        return function stop() {
+            dependencies.forEach(unsub => unsub());
+            dependencies.clear();
+        };
+    });
+}
+function trackDependencies(existing, fn) {
+    const priorDependencies = root.trackingDependencies;
+    const newDeps = (root.trackingDependencies = new Set());
+    try {
+        fn();
+    }
+    finally {
+        root.trackingDependencies = priorDependencies;
+        const oldDeps = new Set(existing);
+        newDeps.forEach(oldDeps.delete, oldDeps);
+        existing.forEach(newDeps.delete, newDeps);
+        return [oldDeps, newDeps];
+    }
+}
+//# sourceMappingURL=atom.js.map

package/dist/atom.js.map

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

package/dist/debounce.d.ts

@@ -0,0 +1,12 @@
+/**
+ * A function to debounce the execution of a function until the next microtask.
+ */
+export declare function onTick<T extends (...args: any[]) => void>(fn: T): T;
+/**
+ * A function to debounce the execution of a function until the next setTimeout(..., 0).
+ */
+export declare function onTimeout<T extends (...args: any[]) => void>(fn: T): T;
+/**
+ * A function to debounce the execution of a function until the next animation frame.
+ */
+export declare function onAnimationFrame<T extends (...args: any[]) => void>(fn: T): T;

package/dist/debounce.js

@@ -0,0 +1,36 @@
+function debounce(scheduler, fn) {
+    let nextArgs;
+    return ((...args) => {
+        nextArgs = args;
+        if (!nextArgs) {
+            scheduler(() => {
+                const args = nextArgs;
+                nextArgs = null;
+                fn(...args);
+            });
+        }
+        nextArgs = args;
+    });
+}
+const tick = (callback) => Promise.resolve().then(callback);
+const timeout = (callback) => setTimeout(callback);
+const frame = (callback) => requestAnimationFrame(callback);
+/**
+ * A function to debounce the execution of a function until the next microtask.
+ */
+export function onTick(fn) {
+    return debounce(tick, fn);
+}
+/**
+ * A function to debounce the execution of a function until the next setTimeout(..., 0).
+ */
+export function onTimeout(fn) {
+    return debounce(timeout, fn);
+}
+/**
+ * A function to debounce the execution of a function until the next animation frame.
+ */
+export function onAnimationFrame(fn) {
+    return debounce(frame, fn);
+}
+//# sourceMappingURL=debounce.js.map

package/dist/debounce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounce.js","sourceRoot":"","sources":["../src/debounce.ts"],"names":[],"mappings":"AAEA,SAAS,QAAQ,CAAqC,SAAoB,EAAE,EAAK;IAC/E,IAAI,QAAe,CAAC;IAEpB,OAAO,CAAC,CAAC,GAAG,IAAW,EAAE,EAAE;QACzB,QAAQ,GAAG,IAAI,CAAC;QAChB,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,SAAS,CAAC,GAAG,EAAE;gBACb,MAAM,IAAI,GAAG,QAAQ,CAAC;gBACtB,QAAQ,GAAG,IAAI,CAAC;gBAChB,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;YACd,CAAC,CAAC,CAAC;QACL,CAAC;QACD,QAAQ,GAAG,IAAI,CAAC;IAClB,CAAC,CAAM,CAAC;AACV,CAAC;AAED,MAAM,IAAI,GAAc,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACvE,MAAM,OAAO,GAAc,CAAC,QAAQ,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;AAC9D,MAAM,KAAK,GAAc,CAAC,QAAQ,EAAE,EAAE,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;AAEvE;;GAEG;AACH,MAAM,UAAU,MAAM,CAAqC,EAAK;IAC9D,OAAO,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAqC,EAAK;IAC/D,OAAO,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAqC,EAAK;IACxE,OAAO,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export * from './eventSignal';
-export * from './reactiveSignal';
-export * from './signalStore';
+export * from './atom';
+export * from './debounce';
+export * from './signal';

package/dist/index.js

@@ -1,4 +1,4 @@
-export * from './eventSignal';
-export * from './reactiveSignal';
-export * from './signalStore';
+export * from './atom';
+export * from './debounce';
+export * from './signal';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC"}

package/dist/{eventSignal.d.ts → signal.d.ts}

@@ -1,12 +1,13 @@
-declare type Args<T> = T extends (...args: infer A) => any ? A : never;
-export declare type EventSignalSubscriber = (...args: any[]) => any;
-export declare type ErrorSubscriber = (error: Error) => any;
-export declare type Unsubscriber = () => void;
-export declare type OnSignal<T extends EventSignalSubscriber = EventSignalSubscriber> = {
+import type { Unsubscriber } from './types';
+type Args<T> = T extends (...args: infer A) => any ? A : never;
+export type SignalSubscriber = (...args: any[]) => any;
+export type ErrorSubscriber = (error: Error) => any;
+export type { Unsubscriber };
+export type OnSignal<T extends SignalSubscriber = SignalSubscriber> = {
     (subscriber: T): Unsubscriber;
     (errorListener: ErrorSubscriber, what: typeof ForErrors): Unsubscriber;
 };
-export declare type EventSignal<T extends EventSignalSubscriber = EventSignalSubscriber> = OnSignal<T> & {
+export type Signal<T extends SignalSubscriber = SignalSubscriber> = OnSignal<T> & {
     (...args: Args<T>): Promise<void>;
     (data: Error): Promise<void>;
     (data: typeof ClearSignal): void;
@@ -32,5 +33,4 @@ export declare const ForErrors: unique symbol;
  * onLoad('data'); // logs 'loaded data'
  * onLoad(new Error('error')); // logs 'error Error: error'
  */
-export declare function eventSignal<T extends EventSignalSubscriber = EventSignalSubscriber>(): EventSignal<T>;
-export {};
+export declare function signal<T extends SignalSubscriber = SignalSubscriber>(): Signal<T>;

package/dist/{eventSignal.js → signal.js}

@@ -18,7 +18,7 @@ export const ForErrors = Symbol();
  * onLoad('data'); // logs 'loaded data'
  * onLoad(new Error('error')); // logs 'error Error: error'
  */
-export function eventSignal() {
+export function signal() {
     const subscribers = new Set();
     const errorListeners = new Set();
     function onSignal(subscriber, what) {
@@ -49,4 +49,4 @@ export function eventSignal() {
     }
     return signal;
 }
-//# sourceMappingURL=eventSignal.js.map
+//# sourceMappingURL=signal.js.map

package/dist/signal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.js","sourceRoot":"","sources":["../src/signal.ts"],"names":[],"mappings":"AAmBA,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC;AACpC,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,EAAE,CAAC;AACrC,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC;AAElC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,MAAM;IACpB,MAAM,WAAW,GAAG,IAAI,GAAG,EAAoB,CAAC;IAChD,MAAM,cAAc,GAAG,IAAI,GAAG,EAAoB,CAAC;IAEnD,SAAS,QAAQ,CAAC,UAA+B,EAAE,IAAuB;QACxE,MAAM,SAAS,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,WAAW,CAAC;QACpE,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC1B,OAAO,GAAG,EAAE;YACV,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC/B,CAAC,CAAC;IACJ,CAAC;IAQD,SAAS,MAAM,CAAC,GAAG,IAAW;QAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,OAAO,GAAG,KAAK,UAAU,EAAE,CAAC;YAC9B,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;aAAM,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;YAC/B,WAAW,CAAC,KAAK,EAAE,CAAC;YACpB,cAAc,CAAC,KAAK,EAAE,CAAC;QACzB,CAAC;aAAM,IAAI,GAAG,KAAK,YAAY,EAAE,CAAC;YAChC,OAAO,QAAuB,CAAC;QACjC,CAAC;aAAM,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;YAChC,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC/F,CAAC;aAAM,CAAC;YACN,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAChG,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,2 @@
+export type Unsubscriber = () => void;
+export type Subscriber<T> = (value: T) => void;

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "easy-signal",
-  "version": "3.2.6",
-  "description": "A tiny (25 LOC), simple utility for alerting subscribers when an event happens, allowing for error handling and clearing.",
+  "version": "4.0.0",
+  "description": "A package with 2 types of signals, an small and simple event signal, and a reactive value-based signal called atoms.",
   "main": "dist/index.js",
   "scripts": {
     "build": "tsc",
@@ -17,7 +17,9 @@
     "events",
     "typescript",
     "subscriber",
-    "dispatcher"
+    "dispatcher",
+    "reactive",
+    "atom"
   ],
   "author": "Jacob Wright",
   "license": "MIT",
@@ -26,6 +28,6 @@
   },
   "homepage": "https://github.com/dabblewriter/easy-signal#readme",
   "devDependencies": {
-    "typescript": "^4.8.2"
+    "typescript": "^5.4.5"
   }
 }