chem-rx 0.0.1 → 0.0.3

package/README.md

@@ -1,6 +1,6 @@
 # chem-rx
 
-`chem-rx` wraps`rx.js` to provide a state management solution focused on
+`chem-rx` wraps `rxjs` to provide a state management solution focused on
 simplicity. Useable with or without React!
 
 ## Atom
@@ -14,10 +14,10 @@ Atoms are state containers that take any value - object, array, or primitive.
 ```
 import { Atom } from 'chem-rx'
 
-const numberAtom: BaseAtom = Atom(0)
-const stringAtom: BaseAtom = Atom('hello')
-const arrayAtom: ArrayAtom = Atom(['hello', 'world'])
-const objectAtom: ObjectAtom = Atom({ 'hello': 'world', 'world': 'hello' })
+const number$: BaseAtom = Atom(0)
+const string$: BaseAtom = Atom('hello')
+const array$: ArrayAtom = Atom(['hello', 'world'])
+const object$: ObjectAtom = Atom({ 'hello': 'world', 'world': 'hello' })
 ```
 
 ### Getting & setting values
@@ -26,55 +26,293 @@ const objectAtom: ObjectAtom = Atom({ 'hello': 'world', 'world': 'hello' })
 `ObjectAtom` depending on the input.
 
 ```
-/*
- * BaseAtom
- */
-numberAtom.set(2)
-numberAtom.value()
+// Base Atom
+number$.set(2)
+number$.value()
 // 2
 
-/*
- * ArrayAtom
- */
-arrayAtom.push('!')
-arrayAtom.value()
+// ArrayAtom
+array$.push('!')
+array$.value()
 // ['hello', 'world', '!']
-arrayAtom.get(1)
+array$.get(1)
 // 'world'
 
-/*
- * ObjectAtom
- */
-objectAtom.set('world', 'hi')
-objectAtom.value()
+// ObjectAtom
+object$.set('world', 'hi')
+object$.value()
 // {'hello': 'world', 'world': 'hi'}
 
-objectAtom.set('sup', 'earth')
+object$.set('sup', 'earth')
 // {'hello': 'world', 'world': 'hi', 'sup': 'earth'}
 
-objectAtom.get('world')
+object$.get('world')
 // 'hi'
 ```
 
-### Transforming Atoms
+### Selecting Atoms
+
+You can select Object and Array atoms to return new Atoms that wrap the values
+at that key. This can be useful for working with different parts of nested Array
+and Object atoms.
+
+```
+const nestedData = Atom({
+  stacy: {
+    nickname: "stace",
+    education: {
+      school: "Penn",
+      graduation: 2014,
+    },
+  },
+});
+
+const stacy = nestedData.select("stacy");
+console.log(stacy.get('nickname'))
+// 'stace'
+
+const stacySchool = nestedData.select("stacy").select("education");
+console.log(stacySchool.get('school'))
+// 'Penn'
+```
+
+### Derived Atoms (read-only)
+
+You can derive new Atoms from any existing atoms. Any time the original atoms
+change, your derived atoms will automatically update with new values!
+
+```
+const atom$ = Atom(3);
+
+// square it
+const squared$ = atom$.derive((x) => x * x);
+
+// "9"
+console.log(squared$.value())
+
+// Update the original value
+atom$.set(4)
+
+// "16"
+console.log(squared$.value())
+```
+
+Every derived atom is **read-only**. This prevents you from overriding the
+derived output value, since it is automatically derived from another input!
+
+```
+// ERR: Property 'set' does not exist on type ReadOnlyAtom
+squared$.set(2)
+```
 
-### Composing Atoms & ReadOnlyAtoms
+You can optionally enforce `readOnly` on an atom at creation time if needed
+
+```
+const atom$ = Atom(3, true);
+
+// ERR: Property 'set' does not exist on type ReadOnlyAtom
+atom$.set(2)
+```
+
+### Combining Atoms
+
+Multiple atoms can also be **combined** to create brand new atoms!
+
+Here's an example of joining a set of normalized data models
+
+```
+const pets$ = Atom<{ [name: string]: { type: "dog" | "cat"; age: number } }>({
+  spot: {name: 'spot', type: "dog", age: 5 },
+  tabby: {name: 'tabby', type: "cat", age: 12 },
+});
+
+const people$ = Atom<{ [name: string]: { pets: string[] } }>({
+  mary: { pets: ["spot"] },
+  cam: { pets: ["tabby"] },
+});
+
+const mary$ = Atom.combine(pets$, people$.select("mary")).derive(
+  ([pets, mary]) => {
+    return {
+      ...mary,
+      pets: mary.pets.map((petName) => pets[petName]),
+    };
+  }
+);
+
+console.log(mary$.select('pets').value())
+/*
+ * [{
+ *   name: "spot",
+ *   type: "dog",
+ *   age: 5,
+ * }]
+ */
+```
 
 ### Subscribing to updates
 
+Atoms emit values each time they're updated. You can subscribe callbacks to them
+to act on updates
+
+```
+const atom$ = Atom(3);
+
+const subscription = atom$.subscribe(val => {
+    console.log("Received value: ", val)
+})
+
+atom$.set(4)
+// "Received value: 4"
+
+// Unsubscribe to clean up
+subscription.unsubscribe();
+```
+
+### Signals
+
+Sometimes, all you want is something to ping you when there's an update. Signals
+are stateless transceivers for signaling updates.
+
+```
+const signal$ = new Signal();
+
+const subscription = signal$.subscribe(() => {
+    console.log("PONG")
+})
+
+signal$.ping()
+// "PONG"
+
+// Unsubscribe to clean up
+subscription.unsubscribe();
+```
+
+Signals can also send values if needed.
+
+```
+const signal$ = new Signal();
+
+const subscription = signal$.subscribe((value) => {
+    console.log("PONGED: ", value)
+})
+
+signal$.ping("hello")
+// "PONGED: hello"
+
+// Unsubscribe to clean up
+subscription.unsubscribe();
+```
+
 ## Use with React
 
 ### useAtom
 
+`useAtom` automatically updates with new values in your react components.
+
+If you want to update your atoms, you can simply call the same `set`
+(Base/ObjectAtom) or `push` (ArrayAtom) methods you would typically use outside
+of react.
+
+```
+import { Atom, useAtom } from 'chem-rx'
+
+const count$ = Atom(0)
+
+function Counter() {
+  const count = useAtom(count$)
+  return (
+    <h1>
+      {count}
+        <button onClick={() => count$.set(count$.value() + 1)}>one up</button> ...
+```
+
+Remember that you can mix and match for any of your needs
+
+### useSelectAtom
+
+With `useSelect` can select a specific key from an atom, and still have it live
+update in your react component.
+
+```
+import { Atom, useAtom } from 'chem-rx'
+
+const count$ = Atom({ inner: 0 })
+
+function Counter() {
+  const count = useSelectAtom(count$, 'inner')
+  return (
+    <h1>
+      {count}
+        <button onClick={() => count$.set('inner', count + 2)}>one up</button> ...
+```
+
 ### hydrateAtoms
 
-## Use with rx.js
+With SSR, your atoms will likely need to be properly hydrated to prevent
+server/client mismatches. You can use `hydrateAtoms` as a simple solution for
+seeding your client-side Atoms with the correct data.
+
+```
+import { Atom, useAtom, hydrateAtoms } from 'chem-rx'
+
+const count$ = Atom(0)
+const CounterPage = ({ countFromServer }) => {
+  hydrateAtoms([[count$, countFromServer]])
+  const count = useAtom(count$)
+  // count would be the value of `countFromServer`, not 0.
+}
+```
+
+## Suggested Usage
+
+There are several suggested "patterns" when using Atoms:
+
+1. Suffix all atoms with `$` (for readability).
+2. Keep all data management **outside** of your views (e.g, React)
+3. Avoid using `set` and `push` directly from your client components. Instead,
+   create helper functions (actions)
+4. Name your helper actions as `<atomName>$<actionName>`, to easily see what
+   atoms are involved.
+5. Name your derived atoms as `<baseAtom>_<derivedValue>$` to easily see which
+   atoms it derives from.
+
+## Common Issues
+
+Here are some common issues you might run into when starting out.
+
+1. Keep your atoms in separate files to prevent circular dependencies.
+   1. I typically create a new file for every action, so I can easily see the
+      API surface at a glance
+
+## Advanced Usage with `rxjs`
+
+Behind the scenes, `chem-rx` uses
+[rxjs Observables](https://rxjs.dev/guide/operators) to enable reactivity.
+`Atom` abstracts away the majority of Rx intentionally, to extract the most
+common patterns used when managing front-end data.
+
+If you're coming in with prior experience and are seeking more complex operators
+enabled by Rx, you're in luck, because every Atom is simply a wrapper around a
+`BehaviorSubject`!
+
+You can use any rxjs operations you want with `Atom.pipe`, which wraps
+`Observable.pipe` to return an Atom.
+
+```
+import { map } from "rxjs";
+
+const atom$ = Atom(3);
+
+// Replace `map` with any operators from rxjs
+const squared$: Atom<number> = atom.pipe(map((x) => x * x));
+
+// "9"
+console.log(squared$.value());
+```
 
 ## Why...?
 
 This library spawned out of a love for the flexibility and expressiveness of
-[rx.js](https://github.com/ReactiveX/rxjs) Observables, and the simplicity of
+[rxjs](https://github.com/ReactiveX/rxjs) Observables, and the simplicity of
 atomic libraries like [jotai](https://github.com/pmndrs/jotai).
-
-Its primary focus is on ease of use and code cleanliness, and is my go-to
-library for all client-side state management

package/dist/Atom.d.ts

@@ -1,29 +1,64 @@
 import { BehaviorSubject, Observable, OperatorFunction, Subscription } from "rxjs";
 export type AtomTuple<T> = {
-    [K in keyof T]: Atom<T[K]>;
+    [K in keyof T]: ReadOnlyAtom<T[K]>;
 };
-export declare class Atom<T> {
+export declare class ReadOnlyAtom<T> {
     _behavior$: BehaviorSubject<T>;
     _parent?: BehaviorSubject<T>[];
     _bonds: BehaviorSubject<T>[];
     _fromObservable: Observable<T> | null;
     _fromObservableSubscription: Subscription | null;
-    static combine<A extends readonly unknown[]>(...atoms: readonly [...AtomTuple<A>]): Atom<A>;
     constructor(_value: T | Observable<T>);
-    push(nextVal: T): void;
-    transform(): Atom<T>;
-    transform<A>(op1: OperatorFunction<T, A>): Atom<A>;
-    transform<A, B>(op1: OperatorFunction<T, A>, op2: OperatorFunction<A, B>): Atom<B>;
-    transform<A, B, C>(op1: OperatorFunction<T, A>, op2: OperatorFunction<A, B>, op3: OperatorFunction<B, C>): Atom<C>;
-    transform<A, B, C, D>(op1: OperatorFunction<T, A>, op2: OperatorFunction<A, B>, op3: OperatorFunction<B, C>, op4: OperatorFunction<C, D>): Atom<D>;
-    transform<A, B, C, D, E>(op1: OperatorFunction<T, A>, op2: OperatorFunction<A, B>, op3: OperatorFunction<B, C>, op4: OperatorFunction<C, D>, op5: OperatorFunction<D, E>): Atom<E>;
-    transform<A, B, C, D, E, F>(op1: OperatorFunction<T, A>, op2: OperatorFunction<A, B>, op3: OperatorFunction<B, C>, op4: OperatorFunction<C, D>, op5: OperatorFunction<D, E>, op6: OperatorFunction<E, F>): Atom<F>;
-    transform<A, B, C, D, E, F, G>(op1: OperatorFunction<T, A>, op2: OperatorFunction<A, B>, op3: OperatorFunction<B, C>, op4: OperatorFunction<C, D>, op5: OperatorFunction<D, E>, op6: OperatorFunction<E, F>, op7: OperatorFunction<F, G>): Atom<G>;
-    transform<A, B, C, D, E, F, G, H>(op1: OperatorFunction<T, A>, op2: OperatorFunction<A, B>, op3: OperatorFunction<B, C>, op4: OperatorFunction<C, D>, op5: OperatorFunction<D, E>, op6: OperatorFunction<E, F>, op7: OperatorFunction<F, G>, op8: OperatorFunction<G, H>): Atom<H>;
-    transform<A, B, C, D, E, F, G, H, I>(op1: OperatorFunction<T, A>, op2: OperatorFunction<A, B>, op3: OperatorFunction<B, C>, op4: OperatorFunction<C, D>, op5: OperatorFunction<D, E>, op6: OperatorFunction<E, F>, op7: OperatorFunction<F, G>, op8: OperatorFunction<G, H>, op9: OperatorFunction<H, I>): Atom<I>;
-    transform<A, B, C, D, E, F, G, H, I>(op1: OperatorFunction<T, A>, op2: OperatorFunction<A, B>, op3: OperatorFunction<B, C>, op4: OperatorFunction<C, D>, op5: OperatorFunction<D, E>, op6: OperatorFunction<E, F>, op7: OperatorFunction<F, G>, op8: OperatorFunction<G, H>, op9: OperatorFunction<H, I>, ...operations: OperatorFunction<any, any>[]): Atom<unknown>;
+    pipe(): ReadOnlyAtom<T>;
+    pipe<A>(op1: OperatorFunction<T, A>): ReadOnlyAtom<A>;
+    pipe<A, B>(op1: OperatorFunction<T, A>, op2: OperatorFunction<A, B>): ReadOnlyAtom<B>;
+    pipe<A, B, C>(op1: OperatorFunction<T, A>, op2: OperatorFunction<A, B>, op3: OperatorFunction<B, C>): ReadOnlyAtom<C>;
+    pipe<A, B, C, D>(op1: OperatorFunction<T, A>, op2: OperatorFunction<A, B>, op3: OperatorFunction<B, C>, op4: OperatorFunction<C, D>): ReadOnlyAtom<D>;
+    pipe<A, B, C, D, E>(op1: OperatorFunction<T, A>, op2: OperatorFunction<A, B>, op3: OperatorFunction<B, C>, op4: OperatorFunction<C, D>, op5: OperatorFunction<D, E>): ReadOnlyAtom<E>;
+    pipe<A, B, C, D, E, F>(op1: OperatorFunction<T, A>, op2: OperatorFunction<A, B>, op3: OperatorFunction<B, C>, op4: OperatorFunction<C, D>, op5: OperatorFunction<D, E>, op6: OperatorFunction<E, F>): ReadOnlyAtom<F>;
+    pipe<A, B, C, D, E, F, G>(op1: OperatorFunction<T, A>, op2: OperatorFunction<A, B>, op3: OperatorFunction<B, C>, op4: OperatorFunction<C, D>, op5: OperatorFunction<D, E>, op6: OperatorFunction<E, F>, op7: OperatorFunction<F, G>): ReadOnlyAtom<G>;
+    pipe<A, B, C, D, E, F, G, H>(op1: OperatorFunction<T, A>, op2: OperatorFunction<A, B>, op3: OperatorFunction<B, C>, op4: OperatorFunction<C, D>, op5: OperatorFunction<D, E>, op6: OperatorFunction<E, F>, op7: OperatorFunction<F, G>, op8: OperatorFunction<G, H>): ReadOnlyAtom<H>;
+    pipe<A, B, C, D, E, F, G, H, I>(op1: OperatorFunction<T, A>, op2: OperatorFunction<A, B>, op3: OperatorFunction<B, C>, op4: OperatorFunction<C, D>, op5: OperatorFunction<D, E>, op6: OperatorFunction<E, F>, op7: OperatorFunction<F, G>, op8: OperatorFunction<G, H>, op9: OperatorFunction<H, I>): ReadOnlyAtom<I>;
+    pipe<A, B, C, D, E, F, G, H, I>(op1: OperatorFunction<T, A>, op2: OperatorFunction<A, B>, op3: OperatorFunction<B, C>, op4: OperatorFunction<C, D>, op5: OperatorFunction<D, E>, op6: OperatorFunction<E, F>, op7: OperatorFunction<F, G>, op8: OperatorFunction<G, H>, op9: OperatorFunction<H, I>, ...operations: OperatorFunction<any, any>[]): ReadOnlyAtom<unknown>;
+    derive<A>(deriveFn: (value: T, index: number) => A): ReadOnlyAtom<A>;
     subscribe(...params: Parameters<BehaviorSubject<T>["subscribe"]>): Subscription;
-    getValue(): T;
+    value(): T;
     dispose(): void;
+    get(key: T extends (infer W)[] ? number : T extends {
+        [key in keyof T]: infer W;
+    } ? keyof T : undefined): T extends (infer W)[] ? T[number] : T extends {
+        [key in keyof T]: infer W;
+    } ? T[keyof T] : undefined;
+    select<K extends keyof T>(key: K): T[K] extends (infer W)[] ? ArrayAtom<W> : T[K] extends {
+        [key: string | symbol]: infer W;
+    } ? ObjectAtom<T[K]> : BaseAtom<T[K]>;
+}
+export declare class BaseAtom<T> extends ReadOnlyAtom<T> {
+    set(nextVal: T): void;
+}
+export declare class ArrayAtom<T> extends ReadOnlyAtom<T[]> {
+    constructor(initialValue: T[]);
+    push(nextVal: T): void;
+}
+export declare class ObjectAtom<T extends {
+    [key in K]: V;
+}, K extends string | number | symbol = keyof T, V = T[K]> extends ReadOnlyAtom<T> {
+    set(nextKey: K, nextValue: V): void;
+}
+export declare function Atom<T>(value: T extends {
+    [key: string]: infer V;
+} | any[] ? never : Observable<T>): BaseAtom<T>;
+export declare function Atom<T extends any[]>(value: Observable<T>): ArrayAtom<T[number]>;
+export declare function Atom<T>(value: T extends {
+    [key in keyof T]: infer V;
+} ? Observable<T> : never): ObjectAtom<T>;
+export declare function Atom<T extends any[]>(value: T): ArrayAtom<T[number]>;
+export declare function Atom<T extends {
+    [key: string]: T[keyof T];
+}>(value: T): ObjectAtom<T>;
+export declare function Atom<T>(value: T): BaseAtom<T>;
+export declare function Atom<T>(value: T, readOnly?: boolean): ReadOnlyAtom<T>;
+export declare namespace Atom {
+    var combine: <A extends readonly unknown[]>(...atoms_0: AtomTuple<A>) => ReadOnlyAtom<A>;
 }
 //# sourceMappingURL=Atom.d.ts.map

package/dist/Atom.d.ts.map

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

package/dist/Signal.d.ts

@@ -1,9 +1,9 @@
-import { Subject, Subscription } from "rxjs";
-export declare class Signal<T = void> {
+import { Subject } from "rxjs";
+export declare class BaseSignal<T = any> {
     _subject$: Subject<T>;
     constructor();
     ping(value: T): void;
-    subscribe(...params: Parameters<Subject<T>["subscribe"]>): Subscription;
-    dispose(): void;
+    subscribe(...params: Parameters<Subject<T>["subscribe"]>): import("rxjs").Subscription;
 }
+export declare function Signal<T>(): void;
 //# sourceMappingURL=Signal.d.ts.map

package/dist/Signal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Signal.d.ts","sourceRoot":"","sources":["../src/Signal.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EAIP,YAAY,EACb,MAAM,MAAM,CAAC;AAGd,qBAAa,MAAM,CAAC,CAAC,GAAG,IAAI;IAC1B,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;;IAOtB,IAAI,CAAC,KAAK,EAAE,CAAC;IAIb,SAAS,CAAC,GAAG,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IAKxD,OAAO;CAGR"}
+{"version":3,"file":"Signal.d.ts","sourceRoot":"","sources":["../src/Signal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,qBAAa,UAAU,CAAC,CAAC,GAAG,GAAG;IAC7B,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;;IAOtB,IAAI,CAAC,KAAK,EAAE,CAAC;IAIb,SAAS,CAAC,GAAG,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;CAGzD;AAED,wBAAgB,MAAM,CAAC,CAAC,UAAM"}