@webkrafters/react-observable-context 3.0.0 → 4.0.0-alpha.1

package/dist/main/set-state/index.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var _lodash = _interopRequireDefault(require("lodash.clonedeep"));
+var _lodash2 = _interopRequireDefault(require("lodash.isequal"));
+var _lodash3 = _interopRequireDefault(require("lodash.isplainobject"));
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
+function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it["return"] != null) it["return"](); } finally { if (didErr) throw err; } } }; }
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
+/** @param {{[x:string]: any}} obj */
+var isIndexBasedObj = function isIndexBasedObj(obj) {
+  return Object.keys(obj).every(function (k) {
+    var i = +k;
+    return Number.isInteger(i) && i > -1;
+  });
+};
+/**
 * Mutates its arguments
 *
 * @param {HasArrayRoot<K>|HasObjectRoot<K>} state
 * @param {HasArrayRoot<K>|HasObjectRoot<K>} newState
 * @param {K} stateKey
 * @param {Stats} stats
 * @template {KeyTypes} K
 */
+function setAtomic(state, newState, stateKey, stats) {
+  if ((0, _lodash2["default"])(state[stateKey], newState[stateKey])) {
+    return;
+  }
+  var isPlainObjectNewState = (0, _lodash3["default"])(newState[stateKey]);
+  var isArrayNewState = Array.isArray(newState[stateKey]);
+  if (Array.isArray(state[stateKey])) {
+    if (isArrayNewState) {
+      return setArray(state, newState, stateKey, stats);
+    }
+    if (isPlainObjectNewState && isIndexBasedObj(newState[stateKey])) {
+      return setArrayIndex(state, newState, stateKey, stats);
+    }
+  }
+  if (isPlainObjectNewState && (0, _lodash3["default"])(state[stateKey])) {
+    return setPlainObject(state, newState, stateKey, stats);
+  }
+  stats.hasChanges = true;
+  state[stateKey] = isArrayNewState || isPlainObjectNewState ? (0, _lodash["default"])(newState[stateKey]) : newState[stateKey];
+}
+;
+/**
 * Mutates its arguments
 *
 * @param {HasArrayRoot<K>} state
 * @param {HasArrayRoot<K>} newState
 * @param {K} rootKey
 * @param {Stats} stats
 * @template {KeyTypes} K
 */
+function setArray(state, newState, rootKey, stats) {
+  var nsLength = newState[rootKey].length;
+  if (state[rootKey].length !== nsLength) {
+    state[rootKey].length = nsLength;
+    stats.hasChanges = true;
+  }
+  for (var i = 0; i < nsLength; i++) {
+    setAtomic(state[rootKey], newState[rootKey], i, stats);
+  }
+}
+;
+/**
 * Mutates its arguments
 *
 * @param {HasArrayRoot<K>} state
 * @param {HasObjectRoot<K>} newState
 * @param {K} rootKey
 * @param {Stats} stats
 * @template {KeyTypes} K
 */
+function setArrayIndex(state, newState, rootKey, stats) {
+  var incomingIndexes = Object.keys(newState[rootKey]).map(function (i) {
+    return +i;
+  });
+  var maxIncomingIndex = Math.max.apply(Math, _toConsumableArray(incomingIndexes));
+  if (maxIncomingIndex >= state[rootKey].length) {
+    state[rootKey].length = maxIncomingIndex + 1;
+    stats.hasChanges = true;
+  }
+  var _iterator = _createForOfIteratorHelper(incomingIndexes),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var i = _step.value;
+      setAtomic(state[rootKey], newState[rootKey], i, stats);
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+}
+;
+/**
 * Mutates its arguments
 *
 * @param {HasObjectRoot<K>} state
 * @param {HasObjectRoot<K>} newState
 * @param {K} rootKey
 * @param {Stats} stats
 * @template {KeyTypes} K
 */
+function setPlainObject(state, newState, rootKey, stats) {
+  set(state[rootKey], newState[rootKey], stats);
+}
+;
+/**
 * Mutates its arguments
 *
 * @param {HasObjectRoot} state
 * @param {HasObjectRoot} newState
 * @param {Stats} stats
 */
+function set(state, newState, stats) {
+  for (var k in newState) {
+    setAtomic(state, newState, k, stats);
+  }
+}
+;
+/**
 * @param {T} state
 * @param {PartialState<T>} newState
 * @param {Listener<T>} [onStateChange]
 * @template {State} T
 */
+function setState(state, newState, onStateChange) {
+  var stats = {
+    hasChanges: false
+  };
+  set(state, newState, stats);
+  stats.hasChanges && (onStateChange === null || onStateChange === void 0 ? void 0 : onStateChange(state));
+}
+;
+var _default = setState;
+exports["default"] = _default;

package/dist/model/accessor/index.d.ts

@@ -0,0 +1 @@
+export default Accessor;
    static "__#5@#NUM_INSTANCES": number;
    /**
     * @param {T} source State object reference from which the accessedPropertyPaths are to be selected.
     * @param {Array<string>} accessedPropertyPaths
     */
    constructor(source: T, accessedPropertyPaths: Array<string>);
    /** @type {boolean} */
    refreshDue: boolean;
    get numClients(): number;
    get id(): number;
    get paths(): string[];
    get value(): Readonly<import("../../types").PartialState<T>>;
    /** @param {string} clientId */
    addClient(clientId: string): void;
    hasClient(clientId: string): boolean;
    removeClient(clientId: string): boolean;
    /**
     * @param {{[propertyPath: string]: Atom}} atoms Curated slices of state currently requested
     * @returns {Readonly<PartialState<State>>}
     */
    refreshValue(atoms: {
        [propertyPath: string]: import("../atom").default;
    }): Readonly<PartialState<State>>;
    #private;

package/dist/model/accessor/index.js

@@ -0,0 +1,258 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var _lodash = _interopRequireDefault(require("lodash.clonedeep"));
+var _lodash2 = _interopRequireDefault(require("lodash.isequal"));
+var _lodash3 = _interopRequireDefault(require("lodash.isplainobject"));
+var _lodash4 = _interopRequireDefault(require("lodash.set"));
+var _constants = require("../../constants");
+var _utils = require("../../utils");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
+function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
+function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+function _classPrivateFieldInitSpec(obj, privateMap, value) { _checkPrivateRedeclaration(obj, privateMap); privateMap.set(obj, value); }
+function _checkPrivateRedeclaration(obj, privateCollection) { if (privateCollection.has(obj)) { throw new TypeError("Cannot initialize the same private elements twice on an object"); } }
+function _classPrivateFieldGet(receiver, privateMap) { var descriptor = _classExtractFieldDescriptor(receiver, privateMap, "get"); return _classApplyDescriptorGet(receiver, descriptor); }
+function _classStaticPrivateFieldSpecSet(receiver, classConstructor, descriptor, value) { _classCheckPrivateStaticAccess(receiver, classConstructor); _classCheckPrivateStaticFieldDescriptor(descriptor, "set"); _classApplyDescriptorSet(receiver, descriptor, value); return value; }
+function _classStaticPrivateFieldSpecGet(receiver, classConstructor, descriptor) { _classCheckPrivateStaticAccess(receiver, classConstructor); _classCheckPrivateStaticFieldDescriptor(descriptor, "get"); return _classApplyDescriptorGet(receiver, descriptor); }
+function _classCheckPrivateStaticFieldDescriptor(descriptor, action) { if (descriptor === undefined) { throw new TypeError("attempted to " + action + " private static field before its declaration"); } }
+function _classCheckPrivateStaticAccess(receiver, classConstructor) { if (receiver !== classConstructor) { throw new TypeError("Private static access of wrong provenance"); } }
+function _classApplyDescriptorGet(receiver, descriptor) { if (descriptor.get) { return descriptor.get.call(receiver); } return descriptor.value; }
+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; } }
+function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it["return"] != null) it["return"](); } finally { if (didErr) throw err; } } }; }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return _typeof(key) === "symbol" ? key : String(key); }
+function _toPrimitive(input, hint) { if (_typeof(input) !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (_typeof(res) !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
+/**
 * Returns function that checks whether its argument is either the ancestorPath or its child/descendant
 *
 * @type {(ancestorPath?: string) => {contains: (path: string) => boolean}}
 */
+var getPathTesterIn = function () {
+  var PATH_DELIMITERS = {
+    '.': null,
+    '[': null
+  };
+  return function () {
+    var ancestorPath = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : '';
+    var ancestorPathLength = (ancestorPath === null || ancestorPath === void 0 ? void 0 : ancestorPath.length) || 0;
+    return {
+      contains: function contains(path) {
+        return ancestorPathLength && path.startsWith(ancestorPath) && (ancestorPathLength === path.length || path[ancestorPathLength] in PATH_DELIMITERS);
+      }
+    };
+  };
+}();
+/**
 * Merges `changes` into a `slice` of the state object.
 *
 * Advisory: Will undo the readonly xteristics of affected hierarchies within the `slice`.
 */
+var mergeChanges = function () {
+  var matchCompositeType = function matchCompositeType(slice, changes) {
+    if (Array.isArray(slice) && Array.isArray(changes)) {
+      return Array;
+    }
+    if ((0, _lodash3["default"])(slice) && (0, _lodash3["default"])(changes)) {
+      return Object;
+    }
+  };
+  var doMergeAt = function doMergeAt(key, slice, changes) {
+    if ((0, _lodash2["default"])(slice[key], changes[key])) {
+      return;
+    }
+    if (Object.isFrozen(changes[key])) {
+      slice[key] = changes[key];
+      return;
+    }
+    if (Object.isFrozen(slice[key])) {
+      slice[key] = _objectSpread({}, slice[key]);
+    }
+    switch (matchCompositeType(slice[key], changes[key])) {
+      case Object:
+        runMerger(slice[key], changes[key]);
+        break;
+      case Array:
+        slice[key].length = changes[key].length;
+        runMerger(slice[key], changes[key]);
+        break;
+      default:
+        slice[key] = changes[key];
+    }
+  };
+  var runMerger = function runMerger(slice, changes) {
+    if ((0, _lodash3["default"])(changes)) {
+      for (var k in changes) {
+        doMergeAt(k, slice, changes);
+      }
+    } else if (Array.isArray(changes)) {
+      changes.forEach(function (_, c) {
+        return doMergeAt(c, slice, changes);
+      });
+    }
+  };
+  /**
   * @param {T} slice
   * @param {T} changes
   * @template {PartialState<State>} T
   */
+  var mergeChanges = function mergeChanges(slice, changes) {
+    !(0, _lodash2["default"])(slice, changes) && runMerger(slice, changes);
+  };
+  return mergeChanges;
+}();
+/** @type {(paths: Array<string>) => Array<string>} */
+var arrangePaths = function arrangePaths(paths) {
+  if (paths.includes(_constants.DEFAULT_STATE_PATH)) {
+    return [_constants.DEFAULT_STATE_PATH];
+  }
+  /** @type {Array<string>} */
+  var arranged = [];
+  var group = getPathTesterIn();
+  var _iterator = _createForOfIteratorHelper((0, _lodash["default"])(paths).sort()),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var path = _step.value;
+      if (group.contains(path)) {
+        continue;
+      }
+      group = getPathTesterIn(path);
+      arranged.push(path);
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  return arranged;
+};
+/** @template {State} T */
+var _clients = new WeakMap();
+var _id = new WeakMap();
+var _paths = new WeakMap();
+var _source = new WeakMap();
+var _value = new WeakMap();
+var Accessor = function () {
+  /** @type {Set<string>} */
+  /** @type {number} */
+  /** @type {Array<string>} */
+  /** @type {T} */
+  /** @type {Readonly<PartialState<T>>} */
+  /**
   * @param {T} source State object reference from which the accessedPropertyPaths are to be selected.
   * @param {Array<string>} accessedPropertyPaths
   */
+  function Accessor(source, accessedPropertyPaths) {
+    var _Accessor$NUM_INSTANC, _Accessor$NUM_INSTANC2;
+    _classCallCheck(this, Accessor);
+    _classPrivateFieldInitSpec(this, _clients, {
+      writable: true,
+      value: void 0
+    });
+    _classPrivateFieldInitSpec(this, _id, {
+      writable: true,
+      value: void 0
+    });
+    _classPrivateFieldInitSpec(this, _paths, {
+      writable: true,
+      value: void 0
+    });
+    _classPrivateFieldInitSpec(this, _source, {
+      writable: true,
+      value: void 0
+    });
+    _classPrivateFieldInitSpec(this, _value, {
+      writable: true,
+      value: void 0
+    });
+    _classPrivateFieldSet(this, _clients, new Set());
+    _classPrivateFieldSet(this, _id, _classStaticPrivateFieldSpecSet(Accessor, Accessor, _NUM_INSTANCES, (_Accessor$NUM_INSTANC2 = _classStaticPrivateFieldSpecGet(Accessor, Accessor, _NUM_INSTANCES), ++_Accessor$NUM_INSTANC2)));
+    _classPrivateFieldSet(this, _paths, arrangePaths(accessedPropertyPaths));
+    /** @type {boolean} */
+    this.refreshDue = true;
+    _classPrivateFieldSet(this, _source, source);
+    _classPrivateFieldSet(this, _value, (0, _utils.makeReadonly)({}));
+  }
+  _createClass(Accessor, [{
+    key: "numClients",
+    get: function get() {
+      return _classPrivateFieldGet(this, _clients).size;
+    }
+  }, {
+    key: "id",
+    get: function get() {
+      return _classPrivateFieldGet(this, _id);
+    }
+  }, {
+    key: "paths",
+    get: function get() {
+      return _classPrivateFieldGet(this, _paths);
+    }
+  }, {
+    key: "value",
+    get: function get() {
+      return _classPrivateFieldGet(this, _value);
+    }
+    /** @param {string} clientId */
+  }, {
+    key: "addClient",
+    value: function addClient(clientId) {
+      _classPrivateFieldGet(this, _clients).add(clientId);
+    }
+    /** @type {(clientId: string) => boolean} */
+  }, {
+    key: "hasClient",
+    value: function hasClient(clientId) {
+      return _classPrivateFieldGet(this, _clients).has(clientId);
+    }
+    /** @type {(clientId: string) => boolean} */
+  }, {
+    key: "removeClient",
+    value: function removeClient(clientId) {
+      return _classPrivateFieldGet(this, _clients)["delete"](clientId);
+    }
+    /**
     * @param {{[propertyPath: string]: Atom}} atoms Curated slices of state currently requested
     * @returns {Readonly<PartialState<State>>}
     */
+  }, {
+    key: "refreshValue",
+    value: function refreshValue(atoms) {
+      if (!this.refreshDue) {
+        return _classPrivateFieldGet(this, _value);
+      }
+      this.refreshDue = false;
+      var value = _objectSpread({}, _classPrivateFieldGet(this, _value));
+      if (_classPrivateFieldGet(this, _paths)[0] === _constants.DEFAULT_STATE_PATH) {
+        for (var k in _classPrivateFieldGet(this, _source)) {
+          if (!(0, _lodash2["default"])(value[k], _classPrivateFieldGet(this, _source)[k])) {
+            value[k] = (0, _lodash["default"])(_classPrivateFieldGet(this, _source)[k]);
+          }
+        }
+      } else {
+        /** @type {PartialState<State>} */
+        var update = {};
+        var _iterator2 = _createForOfIteratorHelper(_classPrivateFieldGet(this, _paths)),
+          _step2;
+        try {
+          for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+            var p = _step2.value;
+            if (!(p in atoms)) {
+              continue;
+            }
+            var atom = atoms[p];
+            !atom.isConnected(_classPrivateFieldGet(this, _id)) && atom.connect(_classPrivateFieldGet(this, _id));
+            (0, _lodash4["default"])(update, p, atom.value);
+          }
+        } catch (err) {
+          _iterator2.e(err);
+        } finally {
+          _iterator2.f();
+        }
+        mergeChanges(value, update);
+      }
+      _classPrivateFieldSet(this, _value, (0, _utils.makeReadonly)(value));
+      return _classPrivateFieldGet(this, _value);
+    }
+  }]);
+  return Accessor;
+}();
+var _NUM_INSTANCES = {
+  writable: true,
+  value: 0
+};
+var _default = Accessor;
+exports["default"] = _default;

package/dist/model/accessor-cache/index.d.ts

@@ -0,0 +1 @@
+export default AccessorCache;
    /** @param {T} origin State object reference from which slices stored in this cache are to be curated */
    constructor(origin: T);
    /**
     * Gets state slice from the cache matching the `propertyPaths`.\
     * If not found, creates a new entry for the client from source, and returns it.
     *
     * @param {string} clientId
     * @param {...string} propertyPaths
     * @return {Readonly<PartialState<T>>}
     */
    get(clientId: string, ...propertyPaths: string[]): Readonly<PartialState<T>>;
    /**
     * Unlinks a consumer from the cache: performing synchronized state cleanup
     *
     * @param {string} clientId
     */
    unlinkClient(clientId: string): void;
    /** Observes the origin state bearing ObservableContext store for state changes to update accessors. */
    watchSource(): void;
    #private;

package/dist/model/accessor-cache/index.js

@@ -0,0 +1,165 @@
+"use strict";
+function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var _lodash = _interopRequireDefault(require("lodash.get"));
+var _lodash2 = _interopRequireDefault(require("lodash.isempty"));
+var _lodash3 = _interopRequireDefault(require("lodash.isequal"));
+var _constants = require("../../constants");
+var _atom = _interopRequireDefault(require("../atom"));
+var _accessor = _interopRequireDefault(require("../accessor"));
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
+function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it["return"] != null) it["return"](); } finally { if (didErr) throw err; } } }; }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
+function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return _typeof(key) === "symbol" ? key : String(key); }
+function _toPrimitive(input, hint) { if (_typeof(input) !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (_typeof(res) !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
+function _classPrivateMethodInitSpec(obj, privateSet) { _checkPrivateRedeclaration(obj, privateSet); privateSet.add(obj); }
+function _classPrivateFieldInitSpec(obj, privateMap, value) { _checkPrivateRedeclaration(obj, privateMap); privateMap.set(obj, value); }
+function _checkPrivateRedeclaration(obj, privateCollection) { if (privateCollection.has(obj)) { throw new TypeError("Cannot initialize the same private elements twice on an object"); } }
+function _classPrivateMethodGet(receiver, privateSet, fn) { if (!privateSet.has(receiver)) { throw new TypeError("attempted to get private field on non-instance"); } return fn; }
+function _classPrivateFieldGet(receiver, privateMap) { var descriptor = _classExtractFieldDescriptor(receiver, privateMap, "get"); return _classApplyDescriptorGet(receiver, descriptor); }
+function _classApplyDescriptorGet(receiver, descriptor) { if (descriptor.get) { return descriptor.get.call(receiver); } return descriptor.value; }
+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 _accessors = new WeakMap();
+var _atoms = new WeakMap();
+var _origin = new WeakMap();
+var _createAccessor = new WeakSet();
+/** @template {State} T */
+var AccessorCache = function () {
+  /** @type {{[propertyPaths: string]: Accessor<T>}} */
+  /** @type {{[propertyPath: string]: Atom}} */
+  /** @type {T} */
+  /** @param {T} origin State object reference from which slices stored in this cache are to be curated */
+  function AccessorCache(origin) {
+    _classCallCheck(this, AccessorCache);
+    _classPrivateMethodInitSpec(this, _createAccessor);
+    _classPrivateFieldInitSpec(this, _accessors, {
+      writable: true,
+      value: void 0
+    });
+    _classPrivateFieldInitSpec(this, _atoms, {
+      writable: true,
+      value: void 0
+    });
+    _classPrivateFieldInitSpec(this, _origin, {
+      writable: true,
+      value: void 0
+    });
+    _classPrivateFieldSet(this, _accessors, {});
+    _classPrivateFieldSet(this, _atoms, {});
+    _classPrivateFieldSet(this, _origin, origin);
+  }
+  /**
   * Add new cache entry
   *
   * @param {string} cacheKey
   * @param {Array<string>} propertyPaths
   * @return {Accessor<T>}
   */
+  _createClass(AccessorCache, [{
+    key: "get",
+    value:
+    /**
     * Gets state slice from the cache matching the `propertyPaths`.\
     * If not found, creates a new entry for the client from source, and returns it.
     *
     * @param {string} clientId
     * @param {...string} propertyPaths
     * @return {Readonly<PartialState<T>>}
     */
+    function get(clientId) {
+      for (var _len = arguments.length, propertyPaths = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
+        propertyPaths[_key - 1] = arguments[_key];
+      }
+      if ((0, _lodash2["default"])(propertyPaths)) {
+        propertyPaths = [_constants.DEFAULT_STATE_PATH];
+      }
+      var cacheKey = JSON.stringify(propertyPaths);
+      var accessor = cacheKey in _classPrivateFieldGet(this, _accessors) ? _classPrivateFieldGet(this, _accessors)[cacheKey] : _classPrivateMethodGet(this, _createAccessor, _createAccessor2).call(this, cacheKey, propertyPaths);
+      !accessor.hasClient(clientId) && accessor.addClient(clientId);
+      return accessor.refreshValue(_classPrivateFieldGet(this, _atoms));
+    }
+    /**
     * Unlinks a consumer from the cache: performing synchronized state cleanup
     *
     * @param {string} clientId
     */
+  }, {
+    key: "unlinkClient",
+    value: function unlinkClient(clientId) {
+      var accessors = _classPrivateFieldGet(this, _accessors);
+      var atoms = _classPrivateFieldGet(this, _atoms);
+      for (var k in accessors) {
+        var accessor = accessors[k];
+        if (!accessor.removeClient(clientId) || accessor.numClients) {
+          continue;
+        }
+        var _iterator = _createForOfIteratorHelper(accessor.paths),
+          _step;
+        try {
+          for (_iterator.s(); !(_step = _iterator.n()).done;) {
+            var p = _step.value;
+            if (p in atoms && atoms[p].disconnect(accessor.id) < 1) {
+              delete atoms[p];
+            }
+          }
+        } catch (err) {
+          _iterator.e(err);
+        } finally {
+          _iterator.f();
+        }
+        delete accessors[k];
+      }
+    }
+    /** Observes the origin state bearing ObservableContext store for state changes to update accessors. */
+  }, {
+    key: "watchSource",
+    value: function watchSource() {
+      var accessors = _classPrivateFieldGet(this, _accessors);
+      var atoms = _classPrivateFieldGet(this, _atoms);
+      var state = _classPrivateFieldGet(this, _origin);
+      var updatedPaths = {};
+      for (var path in atoms) {
+        var newAtomVal = (0, _lodash["default"])(state, path);
+        if ((0, _lodash3["default"])(newAtomVal, atoms[path].value)) {
+          continue;
+        }
+        atoms[path].setValue(newAtomVal);
+        updatedPaths[path] = true;
+      }
+      if ((0, _lodash2["default"])(updatedPaths)) {
+        for (var k in accessors) {
+          if (accessors[k].paths[0] === _constants.DEFAULT_STATE_PATH) {
+            accessors[k].refreshDue = true;
+          }
+        }
+        return;
+      }
+      for (var _k in accessors) {
+        if (accessors[_k].refreshDue) {
+          continue;
+        }
+        var accessorPaths = accessors[_k].paths;
+        accessors[_k].refreshDue = accessorPaths[0] === _constants.DEFAULT_STATE_PATH || accessorPaths.some(function (p) {
+          return p in updatedPaths;
+        });
+      }
+    }
+  }]);
+  return AccessorCache;
+}();
+function _createAccessor2(cacheKey, propertyPaths) {
+  var atoms = _classPrivateFieldGet(this, _atoms);
+  var accessor = new _accessor["default"](_classPrivateFieldGet(this, _origin), propertyPaths);
+  _classPrivateFieldGet(this, _accessors)[cacheKey] = accessor;
+  var _iterator2 = _createForOfIteratorHelper(accessor.paths),
+    _step2;
+  try {
+    for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+      var path = _step2.value;
+      if (path in atoms) {
+        continue;
+      }
+      atoms[path] = new _atom["default"]();
+      atoms[path].setValue((0, _lodash["default"])(_classPrivateFieldGet(this, _origin), path));
+    }
+  } catch (err) {
+    _iterator2.e(err);
+  } finally {
+    _iterator2.f();
+  }
+  return _classPrivateFieldGet(this, _accessors)[cacheKey];
+}
+var _default = AccessorCache;
+exports["default"] = _default;