@figliolia/galena 3.0.3 → 4.0.1

package/src/Profiler.ts

@@ -26,7 +26,7 @@ export class Profiler<T = any> extends Middleware<T> {
 
   public override onBeforeUpdate(state: State<T>) {
     this.startTime = performance.now();
-    this.previousState = state.getSnapshot();
+    this.previousState = state.getState();
   }
 
   public override onUpdate(state: State<T>) {
@@ -46,7 +46,7 @@ export class Profiler<T = any> extends Middleware<T> {
       console.log(
         "   %cCurrent State    ",
         "color: rgb(17, 118, 249); font-weight: bold",
-        state.getSnapshot(),
+        state.getState(),
       );
     }
   }

package/src/State.ts

@@ -1,4 +1,5 @@
 import { EventEmitter } from "@figliolia/event-emitter";
+import { API } from "./API";
 import type { Middleware } from "./Middleware";
 import type { NonFunction, Setter, Subscriber } from "./types";
 
@@ -9,11 +10,11 @@ import type { NonFunction, Setter, Subscriber } from "./types";
  * as isolated instances or be part of your global app
  * state (via `Galena` instances).
  *
- * There are three ways to create state instances
+ * There are two ways to create state instances
  *
  * ```typescript
  * import { State, createState, Profiler } from "@figliolia/galena";
- * // for island states that can be shared between react components
+ 
  * const myState = new State("<any value>", ...middleware);
  * // or
  * const myState = createState("<any value>", ...middleware);
@@ -23,18 +24,19 @@ import type { NonFunction, Setter, Subscriber } from "./types";
  * myState.subscribe(nextValue => {});
  * myState.registerMiddleware(new Profiler());
  * myState.reset(); // reset back to it's original value
+ * // to get the current value at any point in time
+ * const currentValue = myState.getState();
  * ```
  */
-export class State<T> {
+export class State<T> extends API<T, NonFunction<T>> {
   private state: NonFunction<T>;
-  public readonly middleware: Middleware<T>[] = [];
   private readonly Emitter = new EventEmitter<{ change: NonFunction<T> }>();
   constructor(
     public readonly initialState: NonFunction<T>,
     ...middleware: Middleware<T>[]
   ) {
+    super(...middleware);
     this.state = initialState;
-    this.registerMiddleware(...middleware);
   }
 
   /**
@@ -68,14 +70,13 @@ export class State<T> {
   public readonly reset = this.withEmission(() => this.initialState);
 
   /**
-   * Get Snapshot
+   * Get State
    *
-   * Returns the current state. Designed for compatibility with
-   * `useSyncExternalStore`
+   * Returns the current state
    */
-  public readonly getSnapshot = () => {
+  public getState() {
     return this.state;
-  };
+  }
 
   /**
    * Subscribe
@@ -83,12 +84,12 @@ export class State<T> {
    * Registers a callback to be executed each time state
    * changes. Returns an `unsubscribe` function
    */
-  public readonly subscribe = (fn: Subscriber<T>) => {
+  public subscribe(fn: Subscriber<T>) {
     const ID = this.Emitter.on("change", fn);
     return () => {
       this.Emitter.off("change", ID);
     };
-  };
+  }
 
   /**
    * Register Middleware
@@ -139,11 +140,11 @@ export class State<T> {
  * as isolated instances or be part of your global app
  * state (via `Galena` instances).
  *
- * There are three ways to create state instances
+ * There are two ways to create state instances
  *
  * ```typescript
  * import { State, createState, Profiler } from "@figliolia/galena";
- * // for island states that can be shared between react components
+ 
  * const myState = new State("<any value>", ...middleware);
  * // or
  * const myState = createState("<any value>", ...middleware);
@@ -153,6 +154,8 @@ export class State<T> {
  * myState.subscribe(nextValue => {});
  * myState.registerMiddleware(new Profiler());
  * myState.reset(); // reset back to it's original value
+ * // to get the current value at any point in time
+ * const currentValue = myState.getState();
  * ```
  */
 export function createState<T>(

package/src/types.ts

@@ -27,4 +27,8 @@ export type StateTypes<T extends Record<string, State<any>>> = ReturnType<
   StateType<T[keyof T]>
 >;
 
-export type StateType<T extends State<any>> = ReturnType<T["getSnapshot"]>;
+export type StateType<T extends State<any>> = ReturnType<T["getState"]>;
+
+export type GalenaState<T extends Record<string, State<any>>> = {
+  [K in keyof T]: StateType<T[K]>;
+};