@figliolia/galena 3.0.3 → 4.0.0

package/dist/Profiler.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"Profiler.mjs","names":[],"sources":["../src/Profiler.ts"],"sourcesContent":["import { Middleware } from \"./Middleware\";\nimport type { State } from \"./State\";\n\n/**\n * Profiler\n *\n * A logger for state transitions exceeding a given\n * millisecond threshold\n *\n * ```typescript\n * const AppState = new Galena({}, new Profiler());\n * // or\n * AppState.registerMiddlerware(new Profiler());\n * // or\n * const MyState = new State(4, new Profiler());\n * // or\n * MyState.registerMiddleware(new Profiler());\n * ```\n */\nexport class Profiler<T = any> extends Middleware<T> {\n  private previousState: T | null = null;\n  private startTime: null | number = null;\n  constructor(public readonly threshold = 16) {\n    super();\n  }\n\n  public override onBeforeUpdate(state: State<T>) {\n    this.startTime = performance.now();\n    this.previousState = state.getSnapshot();\n  }\n\n  public override onUpdate(state: State<T>) {\n    if (this.startTime === null) {\n      return;\n    }\n    const diff = performance.now() - this.startTime;\n    if (diff >= this.threshold) {\n      console.warn(\n        `A slow state transition of ${diff.toFixed(1)}ms was detected when transitioning the following piece of state`,\n      );\n      console.log(\n        \"   %cPrevious State\",\n        \"color: #26ad65; font-weight: bold\",\n        this.previousState,\n      );\n      console.log(\n        \"   %cCurrent State    \",\n        \"color: rgb(17, 118, 249); font-weight: bold\",\n        state.getSnapshot(),\n      );\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAmBA,IAAa,WAAb,cAAuC,WAAc;CACnD,gBAAkC;CAClC,YAAmC;CACnC,YAAY,YAA4B,IAAI;AAC1C,SAAO;AADmB,OAAA,YAAA;;CAI5B,eAA+B,OAAiB;AAC9C,OAAK,YAAY,YAAY,KAAK;AAClC,OAAK,gBAAgB,MAAM,aAAa;;CAG1C,SAAyB,OAAiB;AACxC,MAAI,KAAK,cAAc,KACrB;EAEF,MAAM,OAAO,YAAY,KAAK,GAAG,KAAK;AACtC,MAAI,QAAQ,KAAK,WAAW;AAC1B,WAAQ,KACN,8BAA8B,KAAK,QAAQ,EAAE,CAAC,iEAC/C;AACD,WAAQ,IACN,uBACA,qCACA,KAAK,cACN;AACD,WAAQ,IACN,0BACA,+CACA,MAAM,aAAa,CACpB"}
+{"version":3,"file":"Profiler.mjs","names":[],"sources":["../src/Profiler.ts"],"sourcesContent":["import { Middleware } from \"./Middleware\";\nimport type { State } from \"./State\";\n\n/**\n * Profiler\n *\n * A logger for state transitions exceeding a given\n * millisecond threshold\n *\n * ```typescript\n * const AppState = new Galena({}, new Profiler());\n * // or\n * AppState.registerMiddlerware(new Profiler());\n * // or\n * const MyState = new State(4, new Profiler());\n * // or\n * MyState.registerMiddleware(new Profiler());\n * ```\n */\nexport class Profiler<T = any> extends Middleware<T> {\n  private previousState: T | null = null;\n  private startTime: null | number = null;\n  constructor(public readonly threshold = 16) {\n    super();\n  }\n\n  public override onBeforeUpdate(state: State<T>) {\n    this.startTime = performance.now();\n    this.previousState = state.getState();\n  }\n\n  public override onUpdate(state: State<T>) {\n    if (this.startTime === null) {\n      return;\n    }\n    const diff = performance.now() - this.startTime;\n    if (diff >= this.threshold) {\n      console.warn(\n        `A slow state transition of ${diff.toFixed(1)}ms was detected when transitioning the following piece of state`,\n      );\n      console.log(\n        \"   %cPrevious State\",\n        \"color: #26ad65; font-weight: bold\",\n        this.previousState,\n      );\n      console.log(\n        \"   %cCurrent State    \",\n        \"color: rgb(17, 118, 249); font-weight: bold\",\n        state.getState(),\n      );\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAmBA,IAAa,WAAb,cAAuC,WAAc;CACnD,gBAAkC;CAClC,YAAmC;CACnC,YAAY,YAA4B,IAAI;AAC1C,SAAO;AADmB,OAAA,YAAA;;CAI5B,eAA+B,OAAiB;AAC9C,OAAK,YAAY,YAAY,KAAK;AAClC,OAAK,gBAAgB,MAAM,UAAU;;CAGvC,SAAyB,OAAiB;AACxC,MAAI,KAAK,cAAc,KACrB;EAEF,MAAM,OAAO,YAAY,KAAK,GAAG,KAAK;AACtC,MAAI,QAAQ,KAAK,WAAW;AAC1B,WAAQ,KACN,8BAA8B,KAAK,QAAQ,EAAE,CAAC,iEAC/C;AACD,WAAQ,IACN,uBACA,qCACA,KAAK,cACN;AACD,WAAQ,IACN,0BACA,+CACA,MAAM,UAAU,CACjB"}

package/dist/State.cjs

@@ -1,3 +1,4 @@
+const require_API = require("./API.cjs");
 let _figliolia_event_emitter = require("@figliolia/event-emitter");
 //#region src/State.ts
 /**
@@ -7,11 +8,11 @@ let _figliolia_event_emitter = require("@figliolia/event-emitter");
 * 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);
@@ -21,16 +22,17 @@ let _figliolia_event_emitter = require("@figliolia/event-emitter");
 * 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();
 * ```
 */
-var State = class {
+var State = class extends require_API.API {
 	state;
-	middleware = [];
 	Emitter = new _figliolia_event_emitter.EventEmitter();
 	constructor(initialState, ...middleware) {
+		super(...middleware);
 		this.initialState = initialState;
 		this.state = initialState;
-		this.registerMiddleware(...middleware);
 	}
 	/**
 	* Set
@@ -63,7 +65,7 @@ var State = class {
 	* Returns the current state. Designed for compatibility with
 	* `useSyncExternalStore`
 	*/
-	getSnapshot = () => {
+	getState = () => {
 		return this.state;
 	};
 	/**
@@ -118,11 +120,11 @@ var State = class {
 * 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);
@@ -132,6 +134,8 @@ var State = class {
 * 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();
 * ```
 */
 function createState(...args) {

package/dist/State.d.cts

@@ -1,5 +1,6 @@
 import { NonFunction, Setter, Subscriber } from "./types.cjs";
 import { Middleware } from "./Middleware.cjs";
+import { API } from "./API.cjs";
 
 //#region src/State.d.ts
 /**
@@ -9,11 +10,11 @@ import { Middleware } from "./Middleware.cjs";
  * 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,12 +24,13 @@ import { Middleware } from "./Middleware.cjs";
  * 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();
  * ```
  */
-declare class State<T> {
+declare class State<T> extends API<T, NonFunction<T>> {
   readonly initialState: NonFunction<T>;
   private state;
-  readonly middleware: Middleware<T>[];
   private readonly Emitter;
   constructor(initialState: NonFunction<T>, ...middleware: Middleware<T>[]);
   /**
@@ -59,7 +61,7 @@ declare class State<T> {
    * Returns the current state. Designed for compatibility with
    * `useSyncExternalStore`
    */
-  readonly getSnapshot: () => NonFunction<T>;
+  readonly getState: () => NonFunction<T>;
   /**
    * Subscribe
    *
@@ -87,11 +89,11 @@ declare 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);
@@ -101,6 +103,8 @@ declare 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();
  * ```
  */
 declare function createState<T>(...args: ConstructorParameters<typeof State<T>>): State<T>;

package/dist/State.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"State.d.cts","names":[],"sources":["../src/State.ts"],"mappings":";;;;;;AA2BA;;;;;;;;;;;;;;;;;;;;;cAAa,KAAA;EAAA,SAKO,YAAA,EAAc,WAAA,CAAY,CAAA;EAAA,QAJpC,KAAA;EAAA,SACQ,UAAA,EAAY,UAAA,CAAW,CAAA;EAAA,iBACtB,OAAA;cAEC,YAAA,EAAc,WAAA,CAAY,CAAA,MACvC,UAAA,EAAY,UAAA,CAAW,CAAA;EANX;;;;;;EAAA,SAkBD,GAAA,GAAG,KAAA,EAAA,WAAA,CAAA,CAAA;EAhBoB;;;;;;;EAAA,SAyBvB,MAAA,GAAM,MAAA,EAAA,MAAA,CAAA,CAAA;EArBM;;;;;;EAAA,SAkCZ,KAAA;EAbM;;;;;;EAAA,SAqBN,WAAA,QAAW,WAAA,CAAA,CAAA;EAUM;;;;;;EAAA,SAAjB,SAAA,GAAa,EAAA,EAAI,UAAA,CAAW,CAAA;EAkBpC;;;;;;;EAJD,kBAAA,CAAA,GAAsB,UAAA,EAAY,UAAA,CAAW,CAAA;EAAA,QAI5C,YAAA;EAAA,QAaA,IAAA;EAAA,UAOE,UAAA,CAAW,MAAA,EAAQ,MAAA,CAAO,CAAA,IAAK,MAAA,IAAU,WAAA,CAAY,CAAA;EAAA,QAIvD,gBAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;iBA8BM,WAAA,GAAA,CAAA,GACX,IAAA,EAAM,qBAAA,QAA6B,KAAA,CAAM,CAAA,KAAG,KAAA,CAAA,CAAA"}
+{"version":3,"file":"State.d.cts","names":[],"sources":["../src/State.ts"],"mappings":";;;;;;;AA8BA;;;;;;;;;;;;;;;;;;;;;;;cAAa,KAAA,YAAiB,GAAA,CAAI,CAAA,EAAG,WAAA,CAAY,CAAA;EAAA,SAI7B,YAAA,EAAc,WAAA,CAAY,CAAA;EAAA,QAHpC,KAAA;EAAA,iBACS,OAAA;cAEC,YAAA,EAAc,WAAA,CAAY,CAAA,MACvC,UAAA,EAAY,UAAA,CAAW,CAAA;EALG;;;;;;EAAA,SAiBf,GAAA,GAAG,KAAA,EAAA,WAAA,CAAA,CAAA;EAba;;;;;;;EAAA,SAsBhB,MAAA,GAAM,MAAA,EAAA,MAAA,CAAA,CAAA;EArBjB;;;;;;EAAA,SAkCW,KAAA;EAbA;;;;;;EAAA,SAqBA,QAAA,QAAQ,WAAA,CAAA,CAAA;EAAA;;;;;;EAAA,SAUR,SAAA,GAAa,EAAA,EAAI,UAAA,CAAW,CAAA;EAcH;;;;;;;EAAlC,kBAAA,CAAA,GAAsB,UAAA,EAAY,UAAA,CAAW,CAAA;EAAA,QAI5C,YAAA;EAAA,QAaA,IAAA;EAAA,UAOE,UAAA,CAAW,MAAA,EAAQ,MAAA,CAAO,CAAA,IAAK,MAAA,IAAU,WAAA,CAAY,CAAA;EAAA,QAIvD,gBAAA;AAAA;;AAgCV;;;;;;;;;;;;;;;;;;;;;;;;iBAAgB,WAAA,GAAA,CAAA,GACX,IAAA,EAAM,qBAAA,QAA6B,KAAA,CAAM,CAAA,KAAG,KAAA,CAAA,CAAA"}

package/dist/State.d.mts

@@ -1,5 +1,6 @@
 import { NonFunction, Setter, Subscriber } from "./types.mjs";
 import { Middleware } from "./Middleware.mjs";
+import { API } from "./API.mjs";
 
 //#region src/State.d.ts
 /**
@@ -9,11 +10,11 @@ import { Middleware } from "./Middleware.mjs";
  * 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,12 +24,13 @@ import { Middleware } from "./Middleware.mjs";
  * 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();
  * ```
  */
-declare class State<T> {
+declare class State<T> extends API<T, NonFunction<T>> {
   readonly initialState: NonFunction<T>;
   private state;
-  readonly middleware: Middleware<T>[];
   private readonly Emitter;
   constructor(initialState: NonFunction<T>, ...middleware: Middleware<T>[]);
   /**
@@ -59,7 +61,7 @@ declare class State<T> {
    * Returns the current state. Designed for compatibility with
    * `useSyncExternalStore`
    */
-  readonly getSnapshot: () => NonFunction<T>;
+  readonly getState: () => NonFunction<T>;
   /**
    * Subscribe
    *
@@ -87,11 +89,11 @@ declare 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);
@@ -101,6 +103,8 @@ declare 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();
  * ```
  */
 declare function createState<T>(...args: ConstructorParameters<typeof State<T>>): State<T>;

package/dist/State.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"State.d.mts","names":[],"sources":["../src/State.ts"],"mappings":";;;;;;AA2BA;;;;;;;;;;;;;;;;;;;;;cAAa,KAAA;EAAA,SAKO,YAAA,EAAc,WAAA,CAAY,CAAA;EAAA,QAJpC,KAAA;EAAA,SACQ,UAAA,EAAY,UAAA,CAAW,CAAA;EAAA,iBACtB,OAAA;cAEC,YAAA,EAAc,WAAA,CAAY,CAAA,MACvC,UAAA,EAAY,UAAA,CAAW,CAAA;EANX;;;;;;EAAA,SAkBD,GAAA,GAAG,KAAA,EAAA,WAAA,CAAA,CAAA;EAhBoB;;;;;;;EAAA,SAyBvB,MAAA,GAAM,MAAA,EAAA,MAAA,CAAA,CAAA;EArBM;;;;;;EAAA,SAkCZ,KAAA;EAbM;;;;;;EAAA,SAqBN,WAAA,QAAW,WAAA,CAAA,CAAA;EAUM;;;;;;EAAA,SAAjB,SAAA,GAAa,EAAA,EAAI,UAAA,CAAW,CAAA;EAkBpC;;;;;;;EAJD,kBAAA,CAAA,GAAsB,UAAA,EAAY,UAAA,CAAW,CAAA;EAAA,QAI5C,YAAA;EAAA,QAaA,IAAA;EAAA,UAOE,UAAA,CAAW,MAAA,EAAQ,MAAA,CAAO,CAAA,IAAK,MAAA,IAAU,WAAA,CAAY,CAAA;EAAA,QAIvD,gBAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;iBA8BM,WAAA,GAAA,CAAA,GACX,IAAA,EAAM,qBAAA,QAA6B,KAAA,CAAM,CAAA,KAAG,KAAA,CAAA,CAAA"}
+{"version":3,"file":"State.d.mts","names":[],"sources":["../src/State.ts"],"mappings":";;;;;;;AA8BA;;;;;;;;;;;;;;;;;;;;;;;cAAa,KAAA,YAAiB,GAAA,CAAI,CAAA,EAAG,WAAA,CAAY,CAAA;EAAA,SAI7B,YAAA,EAAc,WAAA,CAAY,CAAA;EAAA,QAHpC,KAAA;EAAA,iBACS,OAAA;cAEC,YAAA,EAAc,WAAA,CAAY,CAAA,MACvC,UAAA,EAAY,UAAA,CAAW,CAAA;EALG;;;;;;EAAA,SAiBf,GAAA,GAAG,KAAA,EAAA,WAAA,CAAA,CAAA;EAba;;;;;;;EAAA,SAsBhB,MAAA,GAAM,MAAA,EAAA,MAAA,CAAA,CAAA;EArBjB;;;;;;EAAA,SAkCW,KAAA;EAbA;;;;;;EAAA,SAqBA,QAAA,QAAQ,WAAA,CAAA,CAAA;EAAA;;;;;;EAAA,SAUR,SAAA,GAAa,EAAA,EAAI,UAAA,CAAW,CAAA;EAcH;;;;;;;EAAlC,kBAAA,CAAA,GAAsB,UAAA,EAAY,UAAA,CAAW,CAAA;EAAA,QAI5C,YAAA;EAAA,QAaA,IAAA;EAAA,UAOE,UAAA,CAAW,MAAA,EAAQ,MAAA,CAAO,CAAA,IAAK,MAAA,IAAU,WAAA,CAAY,CAAA;EAAA,QAIvD,gBAAA;AAAA;;AAgCV;;;;;;;;;;;;;;;;;;;;;;;;iBAAgB,WAAA,GAAA,CAAA,GACX,IAAA,EAAM,qBAAA,QAA6B,KAAA,CAAM,CAAA,KAAG,KAAA,CAAA,CAAA"}

package/dist/State.mjs

@@ -1,3 +1,4 @@
+import { API } from "./API.mjs";
 import { EventEmitter } from "@figliolia/event-emitter";
 //#region src/State.ts
 /**
@@ -7,11 +8,11 @@ import { EventEmitter } from "@figliolia/event-emitter";
 * 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);
@@ -21,16 +22,17 @@ import { EventEmitter } from "@figliolia/event-emitter";
 * 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();
 * ```
 */
-var State = class {
+var State = class extends API {
 	state;
-	middleware = [];
 	Emitter = new EventEmitter();
 	constructor(initialState, ...middleware) {
+		super(...middleware);
 		this.initialState = initialState;
 		this.state = initialState;
-		this.registerMiddleware(...middleware);
 	}
 	/**
 	* Set
@@ -63,7 +65,7 @@ var State = class {
 	* Returns the current state. Designed for compatibility with
 	* `useSyncExternalStore`
 	*/
-	getSnapshot = () => {
+	getState = () => {
 		return this.state;
 	};
 	/**
@@ -118,11 +120,11 @@ var State = class {
 * 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);
@@ -132,6 +134,8 @@ var State = class {
 * 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();
 * ```
 */
 function createState(...args) {

package/dist/State.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"State.mjs","names":[],"sources":["../src/State.ts"],"sourcesContent":["import { EventEmitter } from \"@figliolia/event-emitter\";\nimport type { Middleware } from \"./Middleware\";\nimport type { NonFunction, Setter, Subscriber } from \"./types\";\n\n/**\n * ### State\n *\n * The unit of reactivity for Galena. `State`'s can act\n * as isolated instances or be part of your global app\n * state (via `Galena` instances).\n *\n * There are three ways to create state instances\n *\n * ```typescript\n * import { State, createState, Profiler } from \"@figliolia/galena\";\n * // for island states that can be shared between react components\n * const myState = new State(\"<any value>\", ...middleware);\n * // or\n * const myState = createState(\"<any value>\", ...middleware);\n *\n * myState.set(\"<new-value>\");\n * myState.update(previousValue => \"<new-value>\");\n * myState.subscribe(nextValue => {});\n * myState.registerMiddleware(new Profiler());\n * myState.reset(); // reset back to it's original value\n * ```\n */\nexport class State<T> {\n  private state: NonFunction<T>;\n  public readonly middleware: Middleware<T>[] = [];\n  private readonly Emitter = new EventEmitter<{ change: NonFunction<T> }>();\n  constructor(\n    public readonly initialState: NonFunction<T>,\n    ...middleware: Middleware<T>[]\n  ) {\n    this.state = initialState;\n    this.registerMiddleware(...middleware);\n  }\n\n  /**\n   * Set\n   *\n   * Updates the current value of state notifying\n   * all interested parties\n   */\n  public readonly set = this.withEmission((state: NonFunction<T>) => state);\n\n  /**\n   * Update\n   *\n   * Updates the current value of state using a setter function\n   * receiving the previous state as a parameter. Notifies all\n   * interested parties\n   */\n  public readonly update = this.withEmission((setter: Setter<T>) => {\n    if (this.diffSetter(setter)) {\n      return setter;\n    }\n    return setter(this.state);\n  });\n\n  /**\n   * Reset\n   *\n   * Resets the current state back to the state which the instance\n   * was initialized with. Notifies all interested parties\n   */\n  public readonly reset = this.withEmission(() => this.initialState);\n\n  /**\n   * Get Snapshot\n   *\n   * Returns the current state. Designed for compatibility with\n   * `useSyncExternalStore`\n   */\n  public readonly getSnapshot = () => {\n    return this.state;\n  };\n\n  /**\n   * Subscribe\n   *\n   * Registers a callback to be executed each time state\n   * changes. Returns an `unsubscribe` function\n   */\n  public readonly subscribe = (fn: Subscriber<T>) => {\n    const ID = this.Emitter.on(\"change\", fn);\n    return () => {\n      this.Emitter.off(\"change\", ID);\n    };\n  };\n\n  /**\n   * Register Middleware\n   *\n   * Registers any number of `Middleware` instances on the\n   * current instance of `State`. Your middleware will begin\n   * executing at the next state transition\n   */\n  public registerMiddleware(...middleware: Middleware<T>[]) {\n    this.middleware.push(...middleware);\n  }\n\n  private withEmission<\n    F extends (...args: any[]) => NonFunction<T> | Promise<NonFunction<T>>,\n  >(fn: F) {\n    return (...args: Parameters<F>) => {\n      const result = fn(...args);\n      if (result instanceof Promise) {\n        void result.then(resolved => this.emit(resolved));\n        return;\n      }\n      return this.emit(result);\n    };\n  }\n\n  private emit(nextState: NonFunction<T>) {\n    this.invokeMiddleware(\"onBeforeUpdate\");\n    this.state = nextState;\n    this.Emitter.emit(\"change\", this.state);\n    this.invokeMiddleware(\"onUpdate\");\n  }\n\n  protected diffSetter(setter: Setter<T>): setter is NonFunction<T> {\n    return typeof setter !== \"function\";\n  }\n\n  private invokeMiddleware<K extends keyof Middleware<T>>(fn: K) {\n    for (const middleware of this.middleware) {\n      middleware[fn](this);\n    }\n  }\n}\n\n/**\n * ### createState\n *\n * The unit of reactivity for Galena. `State`'s can act\n * as isolated instances or be part of your global app\n * state (via `Galena` instances).\n *\n * There are three ways to create state instances\n *\n * ```typescript\n * import { State, createState, Profiler } from \"@figliolia/galena\";\n * // for island states that can be shared between react components\n * const myState = new State(\"<any value>\", ...middleware);\n * // or\n * const myState = createState(\"<any value>\", ...middleware);\n *\n * myState.set(\"<new-value>\");\n * myState.update(previousValue => \"<new-value>\");\n * myState.subscribe(nextValue => {});\n * myState.registerMiddleware(new Profiler());\n * myState.reset(); // reset back to it's original value\n * ```\n */\nexport function createState<T>(\n  ...args: ConstructorParameters<typeof State<T>>\n) {\n  return new State<T>(...args);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,IAAa,QAAb,MAAsB;CACpB;CACA,aAA8C,EAAE;CAChD,UAA2B,IAAI,cAA0C;CACzE,YACE,cACA,GAAG,YACH;AAFgB,OAAA,eAAA;AAGhB,OAAK,QAAQ;AACb,OAAK,mBAAmB,GAAG,WAAW;;;;;;;;CASxC,MAAsB,KAAK,cAAc,UAA0B,MAAM;;;;;;;;CASzE,SAAyB,KAAK,cAAc,WAAsB;AAChE,MAAI,KAAK,WAAW,OAAO,CACzB,QAAO;AAET,SAAO,OAAO,KAAK,MAAM;GACzB;;;;;;;CAQF,QAAwB,KAAK,mBAAmB,KAAK,aAAa;;;;;;;CAQlE,oBAAoC;AAClC,SAAO,KAAK;;;;;;;;CASd,aAA6B,OAAsB;EACjD,MAAM,KAAK,KAAK,QAAQ,GAAG,UAAU,GAAG;AACxC,eAAa;AACX,QAAK,QAAQ,IAAI,UAAU,GAAG;;;;;;;;;;CAWlC,mBAA0B,GAAG,YAA6B;AACxD,OAAK,WAAW,KAAK,GAAG,WAAW;;CAGrC,aAEE,IAAO;AACP,UAAQ,GAAG,SAAwB;GACjC,MAAM,SAAS,GAAG,GAAG,KAAK;AAC1B,OAAI,kBAAkB,SAAS;AACxB,WAAO,MAAK,aAAY,KAAK,KAAK,SAAS,CAAC;AACjD;;AAEF,UAAO,KAAK,KAAK,OAAO;;;CAI5B,KAAa,WAA2B;AACtC,OAAK,iBAAiB,iBAAiB;AACvC,OAAK,QAAQ;AACb,OAAK,QAAQ,KAAK,UAAU,KAAK,MAAM;AACvC,OAAK,iBAAiB,WAAW;;CAGnC,WAAqB,QAA6C;AAChE,SAAO,OAAO,WAAW;;CAG3B,iBAAwD,IAAO;AAC7D,OAAK,MAAM,cAAc,KAAK,WAC5B,YAAW,IAAI,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;AA4B1B,SAAgB,YACd,GAAG,MACH;AACA,QAAO,IAAI,MAAS,GAAG,KAAK"}
+{"version":3,"file":"State.mjs","names":[],"sources":["../src/State.ts"],"sourcesContent":["import { EventEmitter } from \"@figliolia/event-emitter\";\nimport { API } from \"./API\";\nimport type { Middleware } from \"./Middleware\";\nimport type { NonFunction, Setter, Subscriber } from \"./types\";\n\n/**\n * ### State\n *\n * The unit of reactivity for Galena. `State`'s can act\n * as isolated instances or be part of your global app\n * state (via `Galena` instances).\n *\n * There are two ways to create state instances\n *\n * ```typescript\n * import { State, createState, Profiler } from \"@figliolia/galena\";\n \n * const myState = new State(\"<any value>\", ...middleware);\n * // or\n * const myState = createState(\"<any value>\", ...middleware);\n *\n * myState.set(\"<new-value>\");\n * myState.update(previousValue => \"<new-value>\");\n * myState.subscribe(nextValue => {});\n * myState.registerMiddleware(new Profiler());\n * myState.reset(); // reset back to it's original value\n * // to get the current value at any point in time\n * const currentValue = myState.getState();\n * ```\n */\nexport class State<T> extends API<T, NonFunction<T>> {\n  private state: NonFunction<T>;\n  private readonly Emitter = new EventEmitter<{ change: NonFunction<T> }>();\n  constructor(\n    public readonly initialState: NonFunction<T>,\n    ...middleware: Middleware<T>[]\n  ) {\n    super(...middleware);\n    this.state = initialState;\n  }\n\n  /**\n   * Set\n   *\n   * Updates the current value of state notifying\n   * all interested parties\n   */\n  public readonly set = this.withEmission((state: NonFunction<T>) => state);\n\n  /**\n   * Update\n   *\n   * Updates the current value of state using a setter function\n   * receiving the previous state as a parameter. Notifies all\n   * interested parties\n   */\n  public readonly update = this.withEmission((setter: Setter<T>) => {\n    if (this.diffSetter(setter)) {\n      return setter;\n    }\n    return setter(this.state);\n  });\n\n  /**\n   * Reset\n   *\n   * Resets the current state back to the state which the instance\n   * was initialized with. Notifies all interested parties\n   */\n  public readonly reset = this.withEmission(() => this.initialState);\n\n  /**\n   * Get Snapshot\n   *\n   * Returns the current state. Designed for compatibility with\n   * `useSyncExternalStore`\n   */\n  public readonly getState = () => {\n    return this.state;\n  };\n\n  /**\n   * Subscribe\n   *\n   * Registers a callback to be executed each time state\n   * changes. Returns an `unsubscribe` function\n   */\n  public readonly subscribe = (fn: Subscriber<T>) => {\n    const ID = this.Emitter.on(\"change\", fn);\n    return () => {\n      this.Emitter.off(\"change\", ID);\n    };\n  };\n\n  /**\n   * Register Middleware\n   *\n   * Registers any number of `Middleware` instances on the\n   * current instance of `State`. Your middleware will begin\n   * executing at the next state transition\n   */\n  public registerMiddleware(...middleware: Middleware<T>[]) {\n    this.middleware.push(...middleware);\n  }\n\n  private withEmission<\n    F extends (...args: any[]) => NonFunction<T> | Promise<NonFunction<T>>,\n  >(fn: F) {\n    return (...args: Parameters<F>) => {\n      const result = fn(...args);\n      if (result instanceof Promise) {\n        void result.then(resolved => this.emit(resolved));\n        return;\n      }\n      return this.emit(result);\n    };\n  }\n\n  private emit(nextState: NonFunction<T>) {\n    this.invokeMiddleware(\"onBeforeUpdate\");\n    this.state = nextState;\n    this.Emitter.emit(\"change\", this.state);\n    this.invokeMiddleware(\"onUpdate\");\n  }\n\n  protected diffSetter(setter: Setter<T>): setter is NonFunction<T> {\n    return typeof setter !== \"function\";\n  }\n\n  private invokeMiddleware<K extends keyof Middleware<T>>(fn: K) {\n    for (const middleware of this.middleware) {\n      middleware[fn](this);\n    }\n  }\n}\n\n/**\n * ### createState\n *\n * The unit of reactivity for Galena. `State`'s can act\n * as isolated instances or be part of your global app\n * state (via `Galena` instances).\n *\n * There are two ways to create state instances\n *\n * ```typescript\n * import { State, createState, Profiler } from \"@figliolia/galena\";\n \n * const myState = new State(\"<any value>\", ...middleware);\n * // or\n * const myState = createState(\"<any value>\", ...middleware);\n *\n * myState.set(\"<new-value>\");\n * myState.update(previousValue => \"<new-value>\");\n * myState.subscribe(nextValue => {});\n * myState.registerMiddleware(new Profiler());\n * myState.reset(); // reset back to it's original value\n * // to get the current value at any point in time\n * const currentValue = myState.getState();\n * ```\n */\nexport function createState<T>(\n  ...args: ConstructorParameters<typeof State<T>>\n) {\n  return new State<T>(...args);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BA,IAAa,QAAb,cAA8B,IAAuB;CACnD;CACA,UAA2B,IAAI,cAA0C;CACzE,YACE,cACA,GAAG,YACH;AACA,QAAM,GAAG,WAAW;AAHJ,OAAA,eAAA;AAIhB,OAAK,QAAQ;;;;;;;;CASf,MAAsB,KAAK,cAAc,UAA0B,MAAM;;;;;;;;CASzE,SAAyB,KAAK,cAAc,WAAsB;AAChE,MAAI,KAAK,WAAW,OAAO,CACzB,QAAO;AAET,SAAO,OAAO,KAAK,MAAM;GACzB;;;;;;;CAQF,QAAwB,KAAK,mBAAmB,KAAK,aAAa;;;;;;;CAQlE,iBAAiC;AAC/B,SAAO,KAAK;;;;;;;;CASd,aAA6B,OAAsB;EACjD,MAAM,KAAK,KAAK,QAAQ,GAAG,UAAU,GAAG;AACxC,eAAa;AACX,QAAK,QAAQ,IAAI,UAAU,GAAG;;;;;;;;;;CAWlC,mBAA0B,GAAG,YAA6B;AACxD,OAAK,WAAW,KAAK,GAAG,WAAW;;CAGrC,aAEE,IAAO;AACP,UAAQ,GAAG,SAAwB;GACjC,MAAM,SAAS,GAAG,GAAG,KAAK;AAC1B,OAAI,kBAAkB,SAAS;AACxB,WAAO,MAAK,aAAY,KAAK,KAAK,SAAS,CAAC;AACjD;;AAEF,UAAO,KAAK,KAAK,OAAO;;;CAI5B,KAAa,WAA2B;AACtC,OAAK,iBAAiB,iBAAiB;AACvC,OAAK,QAAQ;AACb,OAAK,QAAQ,KAAK,UAAU,KAAK,MAAM;AACvC,OAAK,iBAAiB,WAAW;;CAGnC,WAAqB,QAA6C;AAChE,SAAO,OAAO,WAAW;;CAG3B,iBAAwD,IAAO;AAC7D,OAAK,MAAM,cAAc,KAAK,WAC5B,YAAW,IAAI,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8B1B,SAAgB,YACd,GAAG,MACH;AACA,QAAO,IAAI,MAAS,GAAG,KAAK"}

package/dist/index.d.cts

@@ -1,7 +1,7 @@
-import { AppSubscriber, GalenaSnapshot, NonFunction, PartialSupport, Setter, StateType, StateTypes, Subscriber } from "./types.cjs";
+import { AppSubscriber, GalenaSnapshot, GalenaState, NonFunction, PartialSupport, Setter, StateType, StateTypes, Subscriber } from "./types.cjs";
 import { State, createState } from "./State.cjs";
 import { Middleware } from "./Middleware.cjs";
 import { Galena, createGalena } from "./Galena.cjs";
 import { Logger } from "./Logger.cjs";
 import { Profiler } from "./Profiler.cjs";
-export { AppSubscriber, Galena, GalenaSnapshot, Logger, Middleware, NonFunction, PartialSupport, Profiler, Setter, State, StateType, StateTypes, Subscriber, createGalena, createState };
+export { AppSubscriber, Galena, GalenaSnapshot, GalenaState, Logger, Middleware, NonFunction, PartialSupport, Profiler, Setter, State, StateType, StateTypes, Subscriber, createGalena, createState };

package/dist/index.d.mts

@@ -1,7 +1,7 @@
-import { AppSubscriber, GalenaSnapshot, NonFunction, PartialSupport, Setter, StateType, StateTypes, Subscriber } from "./types.mjs";
+import { AppSubscriber, GalenaSnapshot, GalenaState, NonFunction, PartialSupport, Setter, StateType, StateTypes, Subscriber } from "./types.mjs";
 import { State, createState } from "./State.mjs";
 import { Middleware } from "./Middleware.mjs";
 import { Galena, createGalena } from "./Galena.mjs";
 import { Logger } from "./Logger.mjs";
 import { Profiler } from "./Profiler.mjs";
-export { AppSubscriber, Galena, GalenaSnapshot, Logger, Middleware, NonFunction, PartialSupport, Profiler, Setter, State, StateType, StateTypes, Subscriber, createGalena, createState };
+export { AppSubscriber, Galena, GalenaSnapshot, GalenaState, Logger, Middleware, NonFunction, PartialSupport, Profiler, Setter, State, StateType, StateTypes, Subscriber, createGalena, createState };

package/dist/types.d.cts

@@ -11,7 +11,8 @@ interface GalenaSnapshot<T extends Record<string, State<any>>, K extends Extract
 }
 type AppSubscriber<T extends Record<string, State<any>>, K extends Extract<keyof T, string> = Extract<keyof T, string>> = ((payload: GalenaSnapshot<T, K>) => void) | (() => void);
 type StateTypes<T extends Record<string, State<any>>> = ReturnType<StateType<T[keyof T]>>;
-type StateType<T extends State<any>> = ReturnType<T["getSnapshot"]>;
+type StateType<T extends State<any>> = ReturnType<T["getState"]>;
+type GalenaState<T extends Record<string, State<any>>> = { [K in keyof T]: StateType<T[K]> };
 //#endregion
-export { AppSubscriber, GalenaSnapshot, NonFunction, PartialSupport, Setter, StateType, StateTypes, Subscriber };
+export { AppSubscriber, GalenaSnapshot, GalenaState, NonFunction, PartialSupport, Setter, StateType, StateTypes, Subscriber };
 //# sourceMappingURL=types.d.cts.map

package/dist/types.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.cts","names":[],"sources":["../src/types.ts"],"mappings":";;;KAEY,WAAA,MAAiB,CAAA,cAAc,IAAA,2BAA8B,CAAA;AAAA,KAE7D,cAAA,MAAoB,CAAA,SAAU,MAAA,gBAAsB,OAAA,CAAQ,CAAA,IAAK,CAAA;AAAA,KAEjE,MAAA,MACR,WAAA,CAAY,CAAA,MACV,SAAA,EAAW,WAAA,CAAY,CAAA,MAAO,WAAA,CAAY,CAAA,IAAK,OAAA,CAAQ,WAAA,CAAY,CAAA;AAAA,KAE7D,UAAA,QAAkB,KAAA,EAAO,WAAA,CAAY,CAAA;AAAA,UAEhC,cAAA,WACL,MAAA,SAAe,KAAA,kBACf,OAAA,OAAc,CAAA,YAAa,OAAA,OAAc,CAAA;EAEnD,OAAA,EAAS,CAAA,CAAE,CAAA;EACX,KAAA,EAAO,CAAA;AAAA;AAAA,KAGG,aAAA,WACA,MAAA,SAAe,KAAA,kBACf,OAAA,OAAc,CAAA,YAAa,OAAA,OAAc,CAAA,eAC/C,OAAA,EAAS,cAAA,CAAe,CAAA,EAAG,CAAA;AAAA,KAErB,UAAA,WAAqB,MAAA,SAAe,KAAA,UAAe,UAAA,CAC7D,SAAA,CAAU,CAAA,OAAQ,CAAA;AAAA,KAGR,SAAA,WAAoB,KAAA,SAAc,UAAA,CAAW,CAAA"}
+{"version":3,"file":"types.d.cts","names":[],"sources":["../src/types.ts"],"mappings":";;;KAEY,WAAA,MAAiB,CAAA,cAAc,IAAA,2BAA8B,CAAA;AAAA,KAE7D,cAAA,MAAoB,CAAA,SAAU,MAAA,gBAAsB,OAAA,CAAQ,CAAA,IAAK,CAAA;AAAA,KAEjE,MAAA,MACR,WAAA,CAAY,CAAA,MACV,SAAA,EAAW,WAAA,CAAY,CAAA,MAAO,WAAA,CAAY,CAAA,IAAK,OAAA,CAAQ,WAAA,CAAY,CAAA;AAAA,KAE7D,UAAA,QAAkB,KAAA,EAAO,WAAA,CAAY,CAAA;AAAA,UAEhC,cAAA,WACL,MAAA,SAAe,KAAA,kBACf,OAAA,OAAc,CAAA,YAAa,OAAA,OAAc,CAAA;EAEnD,OAAA,EAAS,CAAA,CAAE,CAAA;EACX,KAAA,EAAO,CAAA;AAAA;AAAA,KAGG,aAAA,WACA,MAAA,SAAe,KAAA,kBACf,OAAA,OAAc,CAAA,YAAa,OAAA,OAAc,CAAA,eAC/C,OAAA,EAAS,cAAA,CAAe,CAAA,EAAG,CAAA;AAAA,KAErB,UAAA,WAAqB,MAAA,SAAe,KAAA,UAAe,UAAA,CAC7D,SAAA,CAAU,CAAA,OAAQ,CAAA;AAAA,KAGR,SAAA,WAAoB,KAAA,SAAc,UAAA,CAAW,CAAA;AAAA,KAE7C,WAAA,WAAsB,MAAA,SAAe,KAAA,wBACnC,CAAA,GAAI,SAAA,CAAU,CAAA,CAAE,CAAA"}

package/dist/types.d.mts

@@ -11,7 +11,8 @@ interface GalenaSnapshot<T extends Record<string, State<any>>, K extends Extract
 }
 type AppSubscriber<T extends Record<string, State<any>>, K extends Extract<keyof T, string> = Extract<keyof T, string>> = ((payload: GalenaSnapshot<T, K>) => void) | (() => void);
 type StateTypes<T extends Record<string, State<any>>> = ReturnType<StateType<T[keyof T]>>;
-type StateType<T extends State<any>> = ReturnType<T["getSnapshot"]>;
+type StateType<T extends State<any>> = ReturnType<T["getState"]>;
+type GalenaState<T extends Record<string, State<any>>> = { [K in keyof T]: StateType<T[K]> };
 //#endregion
-export { AppSubscriber, GalenaSnapshot, NonFunction, PartialSupport, Setter, StateType, StateTypes, Subscriber };
+export { AppSubscriber, GalenaSnapshot, GalenaState, NonFunction, PartialSupport, Setter, StateType, StateTypes, Subscriber };
 //# sourceMappingURL=types.d.mts.map

package/dist/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../src/types.ts"],"mappings":";;;KAEY,WAAA,MAAiB,CAAA,cAAc,IAAA,2BAA8B,CAAA;AAAA,KAE7D,cAAA,MAAoB,CAAA,SAAU,MAAA,gBAAsB,OAAA,CAAQ,CAAA,IAAK,CAAA;AAAA,KAEjE,MAAA,MACR,WAAA,CAAY,CAAA,MACV,SAAA,EAAW,WAAA,CAAY,CAAA,MAAO,WAAA,CAAY,CAAA,IAAK,OAAA,CAAQ,WAAA,CAAY,CAAA;AAAA,KAE7D,UAAA,QAAkB,KAAA,EAAO,WAAA,CAAY,CAAA;AAAA,UAEhC,cAAA,WACL,MAAA,SAAe,KAAA,kBACf,OAAA,OAAc,CAAA,YAAa,OAAA,OAAc,CAAA;EAEnD,OAAA,EAAS,CAAA,CAAE,CAAA;EACX,KAAA,EAAO,CAAA;AAAA;AAAA,KAGG,aAAA,WACA,MAAA,SAAe,KAAA,kBACf,OAAA,OAAc,CAAA,YAAa,OAAA,OAAc,CAAA,eAC/C,OAAA,EAAS,cAAA,CAAe,CAAA,EAAG,CAAA;AAAA,KAErB,UAAA,WAAqB,MAAA,SAAe,KAAA,UAAe,UAAA,CAC7D,SAAA,CAAU,CAAA,OAAQ,CAAA;AAAA,KAGR,SAAA,WAAoB,KAAA,SAAc,UAAA,CAAW,CAAA"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../src/types.ts"],"mappings":";;;KAEY,WAAA,MAAiB,CAAA,cAAc,IAAA,2BAA8B,CAAA;AAAA,KAE7D,cAAA,MAAoB,CAAA,SAAU,MAAA,gBAAsB,OAAA,CAAQ,CAAA,IAAK,CAAA;AAAA,KAEjE,MAAA,MACR,WAAA,CAAY,CAAA,MACV,SAAA,EAAW,WAAA,CAAY,CAAA,MAAO,WAAA,CAAY,CAAA,IAAK,OAAA,CAAQ,WAAA,CAAY,CAAA;AAAA,KAE7D,UAAA,QAAkB,KAAA,EAAO,WAAA,CAAY,CAAA;AAAA,UAEhC,cAAA,WACL,MAAA,SAAe,KAAA,kBACf,OAAA,OAAc,CAAA,YAAa,OAAA,OAAc,CAAA;EAEnD,OAAA,EAAS,CAAA,CAAE,CAAA;EACX,KAAA,EAAO,CAAA;AAAA;AAAA,KAGG,aAAA,WACA,MAAA,SAAe,KAAA,kBACf,OAAA,OAAc,CAAA,YAAa,OAAA,OAAc,CAAA,eAC/C,OAAA,EAAS,cAAA,CAAe,CAAA,EAAG,CAAA;AAAA,KAErB,UAAA,WAAqB,MAAA,SAAe,KAAA,UAAe,UAAA,CAC7D,SAAA,CAAU,CAAA,OAAQ,CAAA;AAAA,KAGR,SAAA,WAAoB,KAAA,SAAc,UAAA,CAAW,CAAA;AAAA,KAE7C,WAAA,WAAsB,MAAA,SAAe,KAAA,wBACnC,CAAA,GAAI,SAAA,CAAU,CAAA,CAAE,CAAA"}

package/package.json

@@ -1,7 +1,13 @@
 {
   "name": "@figliolia/galena",
-  "version": "3.0.3",
+  "version": "4.0.0",
   "description": "A performant state management library supporting middleware and a rich developer API",
+  "keywords": [
+    "flux",
+    "react",
+    "state",
+    "state management"
+  ],
   "homepage": "https://github.com/alexfigliolia/galena#readme",
   "license": "MIT",
   "author": "Alex Figliolia",
@@ -48,11 +54,5 @@
   },
   "peerDependencies": {
     "@figliolia/event-emitter": ">=1.2.0"
-  },
-  "keywords": [
-    "state",
-    "state management",
-    "flux",
-    "react"
-  ]
+  }
 }

package/src/API.ts

@@ -0,0 +1,12 @@
+import type { Middleware } from "./Middleware";
+
+export abstract class API<T, E, M = T> {
+  public readonly middleware: Middleware<M>[] = [];
+  constructor(...middleware: Middleware<M>[]) {
+    this.registerMiddleware(...middleware);
+  }
+
+  public abstract getState(): T;
+  public abstract subscribe(subscriber: (payload: E) => void): () => void;
+  public abstract registerMiddleware(...middlewares: Middleware<M>[]): void;
+}

package/src/Galena.ts

@@ -1,9 +1,11 @@
 import { EventEmitter } from "@figliolia/event-emitter";
+import { API } from "./API";
 import type { Middleware } from "./Middleware";
 import type { State } from "./State";
 import type {
   AppSubscriber,
   GalenaSnapshot,
+  GalenaState,
   Setter,
   StateType,
   StateTypes,
@@ -29,22 +31,44 @@ import type {
  * }, ...middleware);
  *
  * // to retreive and work with an individual unit
- * const myUnit = AppState.get("<key>"); // Returns State<T>
+ * const userState = AppState.get("user"); // Returns State<T>
  *
  * // to run a callback anytime a unit of state changes
  * const listener = AppState.subscribe(({ state, updated }) => {
  *   // do something with the `State` instance that updated
  *   // the entirety of your state
  * });
+ *
+ * // get the current application state
+ * const currentState = AppState.getState();
+ *
+ * // operate on an instance of state
+ * AppState.update("user", userState => ({
+ *   ...userState,
+ *   // your updates
+ * }));
  * ```
  */
-export class Galena<T extends Record<string, State<any>>> {
+export class Galena<T extends Record<string, State<any>>> extends API<
+  GalenaState<T>,
+  GalenaSnapshot<T>,
+  StateTypes<T>
+> {
   private Emitter = new EventEmitter<{ change: GalenaSnapshot<T> }>();
   constructor(
     public readonly state: T,
     ...middleware: Middleware<StateTypes<T>>[]
   ) {
-    this.registerMiddleware(...middleware);
+    super(...middleware);
+  }
+
+  public getState() {
+    const result = {} as GalenaState<T>;
+    for (const key in this.state) {
+      const state = key as keyof T;
+      result[state] = this.state[key].getState();
+    }
+    return result;
   }
 
   /**
@@ -149,13 +173,22 @@ export class Galena<T extends Record<string, State<any>>> {
  * }, ...middleware);
  *
  * // to retreive and work with an individual unit
- * const myUnit = AppState.get("<key>"); // Returns State<T>
+ * const userState = AppState.get("user"); // Returns State<T>
  *
  * // to run a callback anytime a unit of state changes
  * const listener = AppState.subscribe(({ state, updated }) => {
  *   // do something with the `State` instance that updated
  *   // the entirety of your state
  * });
+ *
+ * // get the current application state
+ * const currentState = AppState.getState();
+ *
+ * // operate on an instance of state
+ * AppState.update("user", userState => ({
+ *   ...userState,
+ *   // your updates
+ * }));
  * ```
  */
 export const createGalena = <T extends Record<string, State<any>>>(

package/src/Logger.ts

@@ -22,7 +22,7 @@ export class Logger<T = any> extends Middleware {
   private previousState: T | null = null;
 
   override onBeforeUpdate(state: State<T>) {
-    this.previousState = state.getSnapshot();
+    this.previousState = state.getState();
   }
 
   override onUpdate(state: State<T>) {
@@ -40,7 +40,7 @@ export class Logger<T = any> extends Middleware {
     console.log(
       "   %cNext State    ",
       "color: rgb(17, 118, 249); font-weight: bold",
-      state.getSnapshot(),
+      state.getState(),
     );
   }
 

package/src/Middleware.ts

@@ -19,7 +19,7 @@ import type { State } from "./State";
  *
  *   public override onBeforeUpdate(state: State<T>) {
  *     this.startTime = performance.now();
- *     this.previousState = state.getSnapshot();
+ *     this.previousState = state.getState();
  *   }
  *
  *   public override onUpdate(state: T) {
@@ -27,7 +27,7 @@ import type { State } from "./State";
  *     if(diff >= this.threshold) {
  *       console.warn(`A slow state transition was detected when transitioning the following piece of state`);
  *       console.log('Previous state', this.previousState);
- *       console.log('Current state', state.getSnapshot());
+ *       console.log('Current state', state.getState());
  *     }
  *   }
  * }

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(),
       );
     }
   }