@figliolia/galena 1.0.1 → 2.0.1

package/README.md

@@ -54,7 +54,7 @@ Creating units of state using `AppState.composeState()` will scope your new unit
 // BusinessLogic.ts 
 import { AppState } from "./AppState.ts";
 
-const subscription = AppState.subscribe("navigation", navigationState => {
+const subscription = AppState.subscribe("navigation", state => {
   // React to changes to Navigation state
 });
 
@@ -531,4 +531,5 @@ As the application scales with more state updates and connected components, the
 ### Support for Frontend Frameworks!
 `Galena` provides bindings for React through [react-galena](https://github.com/alexfigliolia/react-galena). This package provides factories for generating HOC's and hooks from your Galena instances and units of State!
 
-
+#### Demo Application
+To see some basic usage using Galena with React, please check out this [Example App](https://github.com/alexfigliolia/galena-quick-start)

package/dist/Galena/Galena.d.ts

@@ -26,32 +26,32 @@ import { State } from "./State";
  * import { AppState } from "./AppState";
  *
  * AppState.subscribe(appState => {
- *  const navState = appState.get("navigation");
- *  const { currentRoute } = navState.state;
- *  // do something with state changes!
+ *   const navState = appState.get("navigation");
+ *   const { currentRoute } = navState.state;
+ *   // do something with state changes!
  * });
  * ```
  * #### Using the State Instance
  * ```typescript
  * NavigationState.subscribe(navigation => {
- *  const { currentRoute } = navigation.state
- *  // do something with state changes!
+ *   const { currentRoute } = navigation
+ *   // do something with state changes!
  * });
  * ```
  *
  * #### Using Global Subscriptions
  * ```typescript
- * NavigationState.subscribeAll(galenaInstance => {
- *  const { currentRoute } = galenaInstance.get("navigation").state
- *  // do something with state changes!
+ * NavigationState.subscribeAll(nextState => {
+ *   const { currentRoute } = nextState.navigation
+ *   // do something with state changes!
  * });
  * ```
  *
  * ### Mutating State
  * ```typescript
  * NavigationState.update(state => {
- *  state.currentRoute = "/profile";
- *  // You can mutate state without creating new objects!
+ *   state.currentRoute = "/profile";
+ *   // You can mutate state without creating new objects!
  * });
  * ```
  */
@@ -113,7 +113,7 @@ export declare class Galena<T extends Record<string, State<any>> = Record<string
      * subscription, call `Galena.unsubscribe()` with the ID returned
      * by this method
      */
-    subscribe<K extends keyof T>(name: K, mutation: Parameters<T[K]["subscribe"]>["0"]): string;
+    subscribe<K extends keyof T>(name: K, callback: Parameters<T[K]["subscribe"]>["0"]): string;
     /**
      * Unsubscribe
      *
@@ -132,7 +132,7 @@ export declare class Galena<T extends Record<string, State<any>> = Record<string
      * subscription, call `Galena.unsubscribeAll()` with the ID
      * returned
      */
-    subscribeAll(callback: (state: Galena<T>) => void): string;
+    subscribeAll(callback: (nextState: T) => void): string;
     /**
      * Unsubscribe
      *

package/dist/Galena/Galena.js

@@ -29,32 +29,32 @@ const State_1 = require("./State");
  * import { AppState } from "./AppState";
  *
  * AppState.subscribe(appState => {
- *  const navState = appState.get("navigation");
- *  const { currentRoute } = navState.state;
- *  // do something with state changes!
+ *   const navState = appState.get("navigation");
+ *   const { currentRoute } = navState.state;
+ *   // do something with state changes!
  * });
  * ```
  * #### Using the State Instance
  * ```typescript
  * NavigationState.subscribe(navigation => {
- *  const { currentRoute } = navigation.state
- *  // do something with state changes!
+ *   const { currentRoute } = navigation
+ *   // do something with state changes!
  * });
  * ```
  *
  * #### Using Global Subscriptions
  * ```typescript
- * NavigationState.subscribeAll(galenaInstance => {
- *  const { currentRoute } = galenaInstance.get("navigation").state
- *  // do something with state changes!
+ * NavigationState.subscribeAll(nextState => {
+ *   const { currentRoute } = nextState.navigation
+ *   // do something with state changes!
  * });
  * ```
  *
  * ### Mutating State
  * ```typescript
  * NavigationState.update(state => {
- *  state.currentRoute = "/profile";
- *  // You can mutate state without creating new objects!
+ *   state.currentRoute = "/profile";
+ *   // You can mutate state without creating new objects!
  * });
  * ```
  */
@@ -136,8 +136,8 @@ class Galena {
      * subscription, call `Galena.unsubscribe()` with the ID returned
      * by this method
      */
-    subscribe(name, mutation) {
-        return this.get(name).subscribe(mutation);
+    subscribe(name, callback) {
+        return this.get(name).subscribe(callback);
     }
     /**
      * Unsubscribe
@@ -166,7 +166,7 @@ class Galena {
             stateSubscriptions.push([
                 key,
                 this.state[key].subscribe(() => {
-                    callback(this);
+                    callback(this.state);
                 }),
             ]);
         }

package/dist/Galena/State.d.ts

@@ -50,7 +50,7 @@ import { Scheduler } from "./Scheduler";
  *
  * #### Subscribing to State Changes
  * ```typescript
- * MyState.subscribe(({ state }) => {
+ * MyState.subscribe((state) => {
  *   const { listItems } = state
  *   // Do something with your list items!
  * });
@@ -200,7 +200,7 @@ export declare class State<T extends any = any> extends Scheduler {
      * callback you provide will execute each time state changes.
      * Returns a unique identifier for your subscription
      */
-    subscribe(callback: (nextState: State<T>) => void): string;
+    subscribe(callback: (nextState: T) => void): string;
     /**
      * Unsubscribe
      *

package/dist/Galena/State.js

@@ -54,7 +54,7 @@ const Scheduler_1 = require("./Scheduler");
  *
  * #### Subscribing to State Changes
  * ```typescript
- * MyState.subscribe(({ state }) => {
+ * MyState.subscribe((state) => {
  *   const { listItems } = state
  *   // Do something with your list items!
  * });
@@ -216,7 +216,7 @@ class State extends Scheduler_1.Scheduler {
      */
     scheduleUpdate(priority) {
         this.lifeCycleEvent(types_1.MiddlewareEvents.onUpdate);
-        void this.scheduleTask(() => this.emitter.emit(this.name, this), priority);
+        void this.scheduleTask(() => this.emitter.emit(this.name, this.state), priority);
     }
     /**
      * Register Middleware

package/dist/Galena/types.d.ts

@@ -1,6 +1,6 @@
 import type { State } from "./State";
 export type MutationEvent<T extends any> = {
-    [key: State<T>["name"]]: State<T>;
+    [key: State<T>["name"]]: T;
 };
 export declare enum Priority {
     "IMMEDIATE" = 1,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@figliolia/galena",
-  "version": "1.0.1",
+  "version": "2.0.1",
   "description": "A performant state management library supporting mutable state, batched updates, middleware and a rich development API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -34,7 +34,7 @@
     "lint": "tsc --noemit && eslint ./ --fix"
   },
   "dependencies": {
-    "@figliolia/event-emitter": "^1.0.6"
+    "@figliolia/event-emitter": "^1.0.7"
   },
   "devDependencies": {
     "@types/node": "^16.7.13",

package/src/Galena/Galena.ts

@@ -30,32 +30,32 @@ import { State } from "Galena/State";
  * import { AppState } from "./AppState";
  *
  * AppState.subscribe(appState => {
- *  const navState = appState.get("navigation");
- *  const { currentRoute } = navState.state;
- *  // do something with state changes!
+ *   const navState = appState.get("navigation");
+ *   const { currentRoute } = navState.state;
+ *   // do something with state changes!
  * });
  * ```
  * #### Using the State Instance
  * ```typescript
  * NavigationState.subscribe(navigation => {
- *  const { currentRoute } = navigation.state
- *  // do something with state changes!
+ *   const { currentRoute } = navigation
+ *   // do something with state changes!
  * });
  * ```
  *
  * #### Using Global Subscriptions
  * ```typescript
- * NavigationState.subscribeAll(galenaInstance => {
- *  const { currentRoute } = galenaInstance.get("navigation").state
- *  // do something with state changes!
+ * NavigationState.subscribeAll(nextState => {
+ *   const { currentRoute } = nextState.navigation
+ *   // do something with state changes!
  * });
  * ```
  *
  * ### Mutating State
  * ```typescript
  * NavigationState.update(state => {
- *  state.currentRoute = "/profile";
- *  // You can mutate state without creating new objects!
+ *   state.currentRoute = "/profile";
+ *   // You can mutate state without creating new objects!
  * });
  * ```
  */
@@ -166,9 +166,9 @@ export class Galena<
    */
   public subscribe<K extends keyof T>(
     name: K,
-    mutation: Parameters<T[K]["subscribe"]>["0"]
+    callback: Parameters<T[K]["subscribe"]>["0"]
   ) {
-    return this.get(name).subscribe(mutation);
+    return this.get(name).subscribe(callback);
   }
 
   /**
@@ -192,14 +192,14 @@ export class Galena<
    * subscription, call `Galena.unsubscribeAll()` with the ID
    * returned
    */
-  public subscribeAll(callback: (state: Galena<T>) => void) {
+  public subscribeAll(callback: (nextState: T) => void) {
     const subscriptionID = this.IDs.get();
     const stateSubscriptions: [state: string, ID: string][] = [];
     for (const key in this.state) {
       stateSubscriptions.push([
         key,
         this.state[key].subscribe(() => {
-          callback(this);
+          callback(this.state);
         }),
       ]);
     }

package/src/Galena/State.ts

@@ -53,7 +53,7 @@ import { Scheduler } from "./Scheduler";
  *
  * #### Subscribing to State Changes
  * ```typescript
- * MyState.subscribe(({ state }) => {
+ * MyState.subscribe((state) => {
  *   const { listItems } = state
  *   // Do something with your list items!
  * });
@@ -237,7 +237,10 @@ export class State<T extends any = any> extends Scheduler {
    */
   private scheduleUpdate(priority: Priority) {
     this.lifeCycleEvent(MiddlewareEvents.onUpdate);
-    void this.scheduleTask(() => this.emitter.emit(this.name, this), priority);
+    void this.scheduleTask(
+      () => this.emitter.emit(this.name, this.state),
+      priority
+    );
   }
 
   /**
@@ -257,7 +260,7 @@ export class State<T extends any = any> extends Scheduler {
    * callback you provide will execute each time state changes.
    * Returns a unique identifier for your subscription
    */
-  public subscribe(callback: (nextState: State<T>) => void) {
+  public subscribe(callback: (nextState: T) => void) {
     return this.emitter.on(this.name, callback);
   }
 

package/src/Galena/types.ts

@@ -1,7 +1,7 @@
 import type { State } from "./State";
 
 export type MutationEvent<T extends any> = {
-  [key: State<T>["name"]]: State<T>;
+  [key: State<T>["name"]]: T;
 };
 
 export enum Priority {