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

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/package.json

@@ -62,8 +62,8 @@
     "dist/main/hooks/use-state-manager/index.d.ts",
     "dist/main/hooks/use-store/index.js",
     "dist/main/hooks/use-store/index.d.ts",
-    "dist/model/accesor/index.js",
-    "dist/model/accesor/index.d.ts",
+    "dist/model/accessor/index.js",
+    "dist/model/accessor/index.d.ts",
     "dist/model/accessor-cache/index.js",
     "dist/model/accessor-cache/index.d.ts",
     "dist/model/atom/index.js",
@@ -108,5 +108,5 @@
     "test:watch": "eslint --fix && jest --updateSnapshot --watchAll"
   },
   "types": "dist/main/index.d.ts",
-  "version": "4.0.0-alpha.0"
+  "version": "4.0.0-alpha.1"
 }