@webkrafters/react-observable-context 2.1.4-rc.0 → 2.1.5

package/README.md

@@ -4,11 +4,13 @@ A context bearing an observable consumer store. State changes within the store's
 
 **React::memo** *(and PureComponents)* remain the go-to solution for the repeated automatic re-renderings of entire component trees resulting from ***component*** state changes. 
 
-_**Recommendation:**_ For optimum performance, consider wrapping in **React::memo** most components using this package's ***useContext*** function either directly or through another React hook. This will protect such components and their descendants from unrelated cascading render operations. ***Exempt:*** certain components such as those wrapped in the `React-Redux::connect()` HOC. Such HOC provide similar protection to wrapped components and their descendants. 
+_**Recommendation:**_ For optimum performance, consider wrapping in **React::memo** most components using this package's ***useContext*** function either directly or through another React hook. This will protect such components and their descendants from unrelated cascading render operations.
+
+***Exempt*** from the recommendation are certain components such as those wrapped in the `React-Redux::connect()` Higher Order Component (HOC). Such HOC provides similar cascade-render protections to wrapped components and their descendants. 
 
 <hr />
 
-<h4><u>Install</u></h4>
+<h3><u>Install</u></h3>
 
 npm i -S @webkrafters/react-observable-context
 
@@ -16,7 +18,7 @@ npm install --save @webkrafters/react-observable-context
 
 ## API
 
-The React-Observable-Context package exports **3** modules namely: the **createContext** method, the **useContext** hook and the **Provider** component.
+The React-Observable-Context package exports **4** modules namely: the **createContext** method, the **useContext** hook, the **Provider** component and the **UsageError** class.
 
 * **createContext** is a zero-parameter funtion returning a store-bearing context. Pass the context to the React::useContext() parameter to obtain the context's `store`.
 
@@ -24,6 +26,8 @@ The React-Observable-Context package exports **3** modules namely: the **createC
 
 * **Provider** can immediately be used as-is anywhere the React-Observable-Context is required. It accepts **3** props and the customary Provider `children` prop. Supply the context to its `context` prop; the initial state to the customary Provider `value` prop; and the optional `prehooks` prop <i>(discussed in the prehooks section below)</i>.
 
+* **UsageError** class is the Error type reported for attempts to access this context's store outside of its Provider component tree.
+
 ***<u>Note:</u>*** the Provider `context` prop is not updateable. Once set, all further updates to this prop are not recorded.
 
 ### The Store

package/dist/index.js

@@ -113,6 +113,10 @@ var useContext = function useContext(context) {
 exports.useContext = useContext;
 var defaultPrehooks = Object.freeze({});
 var _setState = function () {
+  var initDiff = function initDiff(propKey, changed, replaced) {
+    changed[propKey] = {};
+    replaced[propKey] = {};
+  };
   var setAtomic = function setAtomic(state, newState, changed, replaced, stateKey) {
     if ((0, _lodash4["default"])(state[stateKey], newState[stateKey])) {
       return;
@@ -130,18 +134,14 @@ var _setState = function () {
     changed[stateKey] = newState[stateKey];
   };
   var setArray = function setArray(state, newState, changed, replaced, rootKey) {
-    changed[rootKey] = {};
-    replaced[rootKey] = {};
+    initDiff(rootKey, changed, replaced);
     for (var i = 0, len = newState[rootKey].length; i < len; i++) {
       setAtomic(state[rootKey], newState[rootKey], changed[rootKey], replaced[rootKey], i);
     }
   };
   var setPlainObject = function setPlainObject(state, newState, changed, replaced, rootKey) {
-    changed[rootKey] = {};
-    replaced[rootKey] = {};
-    for (var k in newState[rootKey]) {
-      setAtomic(state[rootKey], newState[rootKey], changed[rootKey], replaced[rootKey], k);
-    }
+    initDiff(rootKey, changed, replaced);
+    set(state[rootKey], newState[rootKey], changed[rootKey], replaced[rootKey]);
   };
   var set = function set(state, newState) {
     var changed = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};

package/package.json

@@ -79,5 +79,5 @@
     "test:watch": "eslint --fix && jest --updateSnapshot --watchAll"
   },
   "types": "dist/index.d.ts",
-  "version": "2.1.4-rc.0"
+  "version": "2.1.5"
 }