@webkrafters/react-observable-context 4.4.2 → 4.4.4

package/README.md

@@ -342,6 +342,7 @@ Routinely, the `value` prop is initialized with the full initial state. It may o
 
 <h2 id="selector-map">Selector Map</h2>
 A selector map is an object holding key:value pairs.<br />
+<i><b>An array of <a href="#property-path">property paths</a> is also acceptable:</b> indexes serve as keys for this purpose.</i><br />
 <span style="margin-right: 10px">-</span><code>key</code> refers to an arbitrary name to be assigned to a given property in the <a href="#store"><code>store.data</code></a>.<br />
 <span style="margin-right: 10px">-</span><code>value</code> refers to the <a href="#property-path">property path</a> leading to a state slice whose value will be assigned to and observed by this <a href="#store"><code>store.data</code></a> property.<br />
 <span style="margin-right: 10px">-</span>A special '<a href="#fullstate-selectorkey">@@STATE</a>' value may be used to access and observe the full state object.<br />
@@ -361,7 +362,9 @@ const state = {
   }
 };
 
-// a client observing the following selector map
+/* --------------------------------------------- */
+/* a client observing the following selector map */
+/* --------------------------------------------- */
 const selectorMap = {
   all: '@@STATE',
   myData: 'd',
@@ -373,7 +376,20 @@ store.data = {
   all: state,
   myData: state.d,
   secondFElement: state.d.f[1]
-}
+};
+
+/* --------------------------------------------------- */
+/* a client observing the following property path list */
+/* --------------------------------------------------- */
+const propertyPaths = [ '@@STATE', 'd', 'd.f[1]' ];
+
+// will receive the following store data
+store.data = {
+  0: state,
+  1: state.d,
+  2: state.d.f[1]
+};
+
 ```
 
 ## Storage

package/dist/main/hooks/use-render-key-provider/index.d.ts

@@ -1,6 +1,6 @@
 export default useRenderKeyProvider;
-export type Provider<T extends import("../../../types").State> = (selectorMap: {
-    [selectorKey: string]: string | keyof T;
-}) => [string | keyof T];
+export type Provider<T extends import("../../../types").State, MAP extends BaseSelectorMap<T> = BaseSelectorMap<T>> = (selectorMap: SelectorMap<T, MAP>) => [string | keyof T];
+export type SelectorMap<STATE extends import("../../../types").State = import("../../../types").State, MAP extends BaseSelectorMap<STATE> = BaseSelectorMap<STATE>> = import("../../../types").SelectorMap<STATE>;
+export type BaseSelectorMap<STATE extends import("../../../types").State = import("../../../types").State> = import("../../../types").BaseSelectorMap<STATE>;
 export type State = import("../../../types").State;
-declare const useRenderKeyProvider: Provider<T>;
+declare const useRenderKeyProvider: Provider<T, BaseSelectorMap<T>>;

package/dist/main/index.d.ts

@@ -18,6 +18,10 @@ export function createContext<T extends import("../types").State>(): ObservableC
  * a valid property path follows the `lodash` object property path convention.
  * for a state = { a: 1, b: 2, c: 3, d: { e: 5, f: [6, { x: 7, y: 8, z: 9 } ] } }
  * Any of the following is an applicable selector map.
+ * ['d', 'a'] => {
+ * 		0: { e: 5, f: [6, { x: 7, y: 8, z: 9 } ] },
+ * 		1: 1
+ * }
  * {myData: 'd', count: 'a'} => {
  * 		myData: { e: 5, f: [6, { x: 7, y: 8, z: 9 } ] },
  * 		count: 1

package/dist/model/atom/index.js

@@ -17,6 +17,17 @@ function _classApplyDescriptorGet(receiver, descriptor) { if (descriptor.get) {
 function _classPrivateFieldSet(receiver, privateMap, value) { var descriptor = _classExtractFieldDescriptor(receiver, privateMap, "set"); _classApplyDescriptorSet(receiver, descriptor, value); return value; }
 function _classExtractFieldDescriptor(receiver, privateMap, action) { if (!privateMap.has(receiver)) { throw new TypeError("attempted to " + action + " private field on non-instance"); } return privateMap.get(receiver); }
 function _classApplyDescriptorSet(receiver, descriptor, value) { if (descriptor.set) { descriptor.set.call(receiver, value); } else { if (!descriptor.writable) { throw new TypeError("attempted to set read only private field"); } descriptor.value = value; } }
+var isFunction = function () {
+  var toString = Function.prototype.toString;
+  var is = function is(v) {
+    try {
+      return toString.call(v);
+    } catch (e) {
+      return false;
+    }
+  };
+  return is;
+}();
 var _connections = new WeakMap();
 var _value = new WeakMap();
 var Atom = function () {
@@ -59,7 +70,7 @@ var Atom = function () {
   }, {
     key: "setValue",
     value: function setValue(newValue) {
-      _classPrivateFieldSet(this, _value, (0, _utils.makeReadonly)((0, _utils.clonedeep)(newValue)));
+      _classPrivateFieldSet(this, _value, !isFunction(newValue) ? (0, _utils.makeReadonly)((0, _utils.clonedeep)(newValue)) : newValue);
     }
   }]);
   return Atom;

package/dist/types.d.ts

@@ -1,10 +1,10 @@
 declare const _default: any;
 export default _default;
-export type BaseSelectorMap<T extends State> = {
+export type BaseSelectorMap<T extends State> = (string | keyof T)[] | ({
     [dataPropKey: string]: string | keyof T;
 } & {
     [dataPropKey: string]: "@@STATE";
-};
+});
 export type BaseType = boolean | any[] | {
     [x: string]: any;
 } | KeyType;

package/package.json

@@ -133,5 +133,5 @@
     "test:watch": "eslint --fix && jest --updateSnapshot --watchAll"
   },
   "types": "dist/main/index.d.ts",
-  "version": "4.4.2"
+  "version": "4.4.4"
 }