@dr.pogodin/react-global-state 0.8.3 → 0.9.1

package/build/module/GlobalState.js

@@ -1,181 +1,191 @@
-import _defineProperty from "@babel/runtime/helpers/defineProperty";
-import _toConsumableArray from "@babel/runtime/helpers/toConsumableArray";
-import _classCallCheck from "@babel/runtime/helpers/classCallCheck";
-import _createClass from "@babel/runtime/helpers/createClass";
-
-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; }
-
-import { cloneDeep, get as _get, isArray, isObject, isNil, set as _set, toPath } from 'lodash';
+import _classPrivateFieldGet from "@babel/runtime/helpers/classPrivateFieldGet";
+import _classPrivateFieldSet from "@babel/runtime/helpers/classPrivateFieldSet";
+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"); } }
+import { cloneDeep, get, isFunction, isObject, isNil, set, toPath } from 'lodash';
 import { isDebugMode } from "./utils";
-var ERR_NO_SSR_WATCH = 'GlobalState must not be watched at server side';
-/**
- * Transform state path into the full path inside GlobalState object.
- * @param {string} statePath
- * @return {string}
- * @ignore
- */
-
-function fullPath(statePath) {
-  return isNil(statePath) ? 'state' : "state.".concat(statePath);
-}
-
-var GlobalState = /*#__PURE__*/function () {
+const ERR_NO_SSR_WATCH = 'GlobalState must not be watched at server side';
+var _initialState = /*#__PURE__*/new WeakMap();
+var _nextNotifierId = /*#__PURE__*/new WeakMap();
+var _ssrContext = /*#__PURE__*/new WeakMap();
+var _currentState = /*#__PURE__*/new WeakMap();
+var _watchers = /*#__PURE__*/new WeakMap();
+export default class GlobalState {
   /**
    * Creates a new global state object.
    * @param {any} [initialState] Intial global state content.
    * @param {SsrContext} [ssrContext] Server-side rendering context.
    */
-  function GlobalState(initialState, ssrContext) {
-    _classCallCheck(this, GlobalState);
-
-    /* eslint-disable no-param-reassign */
-    this.state = cloneDeep(initialState);
-    this.nextNotifierId = null;
-    this.watchers = [];
-
+  constructor(initialState, ssrContext) {
+    _classPrivateFieldInitSpec(this, _initialState, {
+      writable: true,
+      value: void 0
+    });
+    _classPrivateFieldInitSpec(this, _nextNotifierId, {
+      writable: true,
+      value: null
+    });
+    _classPrivateFieldInitSpec(this, _ssrContext, {
+      writable: true,
+      value: void 0
+    });
+    _classPrivateFieldInitSpec(this, _currentState, {
+      writable: true,
+      value: void 0
+    });
+    _classPrivateFieldInitSpec(this, _watchers, {
+      writable: true,
+      value: []
+    });
+    _classPrivateFieldSet(this, _currentState, initialState);
+    _classPrivateFieldSet(this, _initialState, initialState);
     if (ssrContext) {
+      /* eslint-disable no-param-reassign */
       ssrContext.dirty = false;
       ssrContext.pending = [];
-      ssrContext.state = this.state;
-      this.ssrContext = ssrContext;
-    }
+      ssrContext.state = _classPrivateFieldGet(this, _currentState);
+      /* eslint-enable no-param-reassign */
 
+      _classPrivateFieldSet(this, _ssrContext, ssrContext);
+    }
     if (process.env.NODE_ENV !== 'production' && isDebugMode()) {
       /* eslint-disable no-console */
-      var msg = 'New ReactGlobalState created';
+      let msg = 'New ReactGlobalState created';
       if (ssrContext) msg += ' (SSR mode)';
       console.groupCollapsed(msg);
       console.log('Initial state:', cloneDeep(initialState));
       console.groupEnd();
       /* eslint-enable no-console */
     }
-    /* eslint-enable no-param-reassign */
-
   }
+
   /**
-   * Gets the value at given `path` of global state. If `path` is null or
-   * undefined, the entire state object is returned.
-   * @param {string} [path] Dot-delimitered state path. If not given, entire
-   * global state content is returned.
-   * @return {any}
+   * Gets current or initial value at the specified "path" of the global state.
+   * Allows to get the entire global state, and automatically set default value
+   * at the "path".
+   * @param {string} [path] Dot-delimitered state path. Pass it "null",
+   *  or "undefined" to refer the entire global state.
+   * @param {object} [options={}] Additional options.
+   * @param {boolean} [options.initialState] If "true" the value will be read
+   *  from the initial state instead of the current one.
+   * @param {any} [options.initialValue] If the value read from the "path" is
+   *  "undefined", this "initialValue" will be returned instead. In such case
+   *  "initialValue" will also be written to the "path" of the current global
+   *  state (no matter "initialState" flag), if "undefined" is stored there.
+   * @return {any} Retrieved value.
    */
-
-
-  _createClass(GlobalState, [{
-    key: "get",
-    value: function get(path) {
-      return _get(this, fullPath(path));
+  get(path) {
+    let {
+      initialState,
+      initialValue
+    } = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+    const state = initialState ? _classPrivateFieldGet(this, _initialState) : _classPrivateFieldGet(this, _currentState);
+    let value = isNil(path) ? state : get(state, path);
+    if (value === undefined && initialValue !== undefined) {
+      value = isFunction(initialValue) ? initialValue() : initialValue;
+      if (!initialState || this.get(path) === undefined) this.set(path, value);
     }
-    /**
-     * Writes the `value` to given global state `path`.
-     * @param {string} [path] Dot-delimitered state path. If not given, entire
-     * global state content is replaced by the `value`.
-     * @param {any} value The value.
-     * @return {any} Given `value` itself.
-     */
-
-  }, {
-    key: "set",
-    value: function set(path, value) {
-      var _this = this;
-
-      var p = fullPath(path);
-
-      if (value !== _get(this, p)) {
-        if (process.env.NODE_ENV !== 'production' && isDebugMode()) {
-          /* eslint-disable no-console */
-          console.groupCollapsed("ReactGlobalState update. Path: \"".concat(path || '', "\""));
-          console.log('New value:', cloneDeep(value));
-          /* eslint-enable no-console */
-        }
+    return value;
+  }
 
-        var pos = this;
-        var pathSegments = toPath(p);
+  /**
+   * Writes the `value` to given global state `path`.
+   * @param {string} [path] Dot-delimitered state path. If not given, entire
+   * global state content is replaced by the `value`.
+   * @param {any} value The value.
+   * @return {any} Given `value` itself.
+   */
+  set(path, value) {
+    if (value !== this.get(path)) {
+      if (process.env.NODE_ENV !== 'production' && isDebugMode()) {
+        /* eslint-disable no-console */
+        console.groupCollapsed(`ReactGlobalState update. Path: "${path || ''}"`);
+        console.log('New value:', cloneDeep(value));
+        /* eslint-enable no-console */
+      }
 
-        for (var i = 0; i < pathSegments.length - 1; i += 1) {
-          var seg = pathSegments[i];
-          var next = pos[seg];
-          if (isArray(next)) pos[seg] = _toConsumableArray(next);else if (isObject(next)) pos[seg] = _objectSpread({}, next);else break;
+      if (isNil(path)) _classPrivateFieldSet(this, _currentState, value);else {
+        const root = {
+          state: _classPrivateFieldGet(this, _currentState)
+        };
+        let segIdx = 0;
+        let pos = root;
+        const pathSegments = toPath(`state.${path}`);
+        for (; segIdx < pathSegments.length - 1; segIdx += 1) {
+          const seg = pathSegments[segIdx];
+          const next = pos[seg];
+          if (Array.isArray(next)) pos[seg] = [...next];else if (isObject(next)) pos[seg] = {
+            ...next
+          };else {
+            // We arrived to a state sub-segment, where the remaining part of
+            // the update path does not exist yet. We rely on lodash's set()
+            // function to create the remaining path, and set the value.
+            set(pos, pathSegments.slice(segIdx), value);
+            break;
+          }
           pos = pos[seg];
-        } // TODO: With such naive use of _.set, the state is mutated in place,
-        // which may cause tons of unexpected side effects for dependants.
-        // It will be better to partially clone the state, so that any existing
-        // references are not mutated, while the full deep clonning is also
-        // avoided.
-
-
-        _set(this, p, value);
-
-        if (this.ssrContext) {
-          this.ssrContext.dirty = true;
-          this.ssrContext.state = this.state;
-        } else if (!this.nextNotifierId) {
-          this.nextNotifierId = setTimeout(function () {
-            _this.nextNotifierId = null;
-
-            _toConsumableArray(_this.watchers).forEach(function (w) {
-              return w();
-            });
-          });
         }
-
-        if (process.env.NODE_ENV !== 'production' && isDebugMode()) {
-          /* eslint-disable no-console */
-          console.log('New state:', cloneDeep(this.state));
-          console.groupEnd();
-          /* eslint-enable no-console */
+        if (segIdx === pathSegments.length - 1) {
+          pos[pathSegments[segIdx]] = value;
         }
+        _classPrivateFieldSet(this, _currentState, root.state);
       }
-
-      return value;
-    }
-    /**
-     * Unsubscribes `callback` from watching state updates; no operation if
-     * `callback` is not subscribed to the state updates.
-     * @param {function} callback
-     * @throws if {@link SsrContext} is attached to the state instance: the state
-     * watching functionality is intended for client-side (non-SSR) only.
-     */
-
-  }, {
-    key: "unWatch",
-    value: function unWatch(callback) {
-      if (this.ssrContext) throw new Error(ERR_NO_SSR_WATCH);
-      var watchers = this.watchers;
-      var pos = watchers.indexOf(callback);
-
-      if (pos >= 0) {
-        watchers[pos] = watchers[watchers.length - 1];
-        watchers.pop();
+      if (_classPrivateFieldGet(this, _ssrContext)) {
+        _classPrivateFieldGet(this, _ssrContext).dirty = true;
+        _classPrivateFieldGet(this, _ssrContext).state = _classPrivateFieldGet(this, _currentState);
+      } else if (!_classPrivateFieldGet(this, _nextNotifierId)) {
+        _classPrivateFieldSet(this, _nextNotifierId, setTimeout(() => {
+          _classPrivateFieldSet(this, _nextNotifierId, null);
+          [..._classPrivateFieldGet(this, _watchers)].forEach(w => w());
+        }));
+      }
+      if (process.env.NODE_ENV !== 'production' && isDebugMode()) {
+        /* eslint-disable no-console */
+        console.log('New state:', cloneDeep(_classPrivateFieldGet(this, _currentState)));
+        console.groupEnd();
+        /* eslint-enable no-console */
       }
     }
-    /**
-     * Subscribes `callback` to watch state updates; no operation if
-     * `callback` is already subscribed to this state instance.
-     * @param {function} callback It will be called without any arguments every
-     * time the state content changes (note, howhever, separate state updates can
-     * be applied to the state at once, and watching callbacks will be called once
-     * after such bulk update).
-     * @throws if {@link SsrContext} is attached to the state instance: the state
-     * watching functionality is intended for client-side (non-SSR) only.
-     */
 
-  }, {
-    key: "watch",
-    value: function watch(callback) {
-      if (this.ssrContext) throw new Error(ERR_NO_SSR_WATCH);
-      var watchers = this.watchers;
+    return value;
+  }
 
-      if (watchers.indexOf(callback) < 0) {
-        watchers.push(callback);
-      }
+  /**
+   * Unsubscribes `callback` from watching state updates; no operation if
+   * `callback` is not subscribed to the state updates.
+   * @param {function} callback
+   * @throws if {@link SsrContext} is attached to the state instance: the state
+   * watching functionality is intended for client-side (non-SSR) only.
+   */
+  unWatch(callback) {
+    if (_classPrivateFieldGet(this, _ssrContext)) throw new Error(ERR_NO_SSR_WATCH);
+    const watchers = _classPrivateFieldGet(this, _watchers);
+    const pos = watchers.indexOf(callback);
+    if (pos >= 0) {
+      watchers[pos] = watchers[watchers.length - 1];
+      watchers.pop();
     }
-  }]);
-
-  return GlobalState;
-}();
+  }
+  get ssrContext() {
+    return _classPrivateFieldGet(this, _ssrContext);
+  }
 
-export { GlobalState as default };
+  /**
+   * Subscribes `callback` to watch state updates; no operation if
+   * `callback` is already subscribed to this state instance.
+   * @param {function} callback It will be called without any arguments every
+   * time the state content changes (note, howhever, separate state updates can
+   * be applied to the state at once, and watching callbacks will be called once
+   * after such bulk update).
+   * @throws if {@link SsrContext} is attached to the state instance: the state
+   * watching functionality is intended for client-side (non-SSR) only.
+   */
+  watch(callback) {
+    if (_classPrivateFieldGet(this, _ssrContext)) throw new Error(ERR_NO_SSR_WATCH);
+    const watchers = _classPrivateFieldGet(this, _watchers);
+    if (watchers.indexOf(callback) < 0) {
+      watchers.push(callback);
+    }
+  }
+}
 //# sourceMappingURL=GlobalState.js.map

package/build/module/GlobalState.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/GlobalState.js"],"names":["cloneDeep","get","isArray","isObject","isNil","set","toPath","isDebugMode","ERR_NO_SSR_WATCH","fullPath","statePath","GlobalState","initialState","ssrContext","state","nextNotifierId","watchers","dirty","pending","process","env","NODE_ENV","msg","console","groupCollapsed","log","groupEnd","path","value","p","pos","pathSegments","i","length","seg","next","setTimeout","forEach","w","callback","Error","indexOf","pop","push"],"mappings":"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","sourcesContent":["import {\n  cloneDeep,\n  get,\n  isArray,\n  isObject,\n  isNil,\n  set,\n  toPath,\n} from 'lodash';\n\nimport { isDebugMode } from './utils';\n\nconst ERR_NO_SSR_WATCH = 'GlobalState must not be watched at server side';\n\n/**\n * Transform state path into the full path inside GlobalState object.\n * @param {string} statePath\n * @return {string}\n * @ignore\n */\nfunction fullPath(statePath) {\n  return isNil(statePath) ? 'state' : `state.${statePath}`;\n}\n\nexport default class GlobalState {\n  /**\n   * Creates a new global state object.\n   * @param {any} [initialState] Intial global state content.\n   * @param {SsrContext} [ssrContext] Server-side rendering context.\n   */\n  constructor(initialState, ssrContext) {\n    /* eslint-disable no-param-reassign */\n    this.state = cloneDeep(initialState);\n    this.nextNotifierId = null;\n    this.watchers = [];\n\n    if (ssrContext) {\n      ssrContext.dirty = false;\n      ssrContext.pending = [];\n      ssrContext.state = this.state;\n      this.ssrContext = ssrContext;\n    }\n\n    if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n      /* eslint-disable no-console */\n      let msg = 'New ReactGlobalState created';\n      if (ssrContext) msg += ' (SSR mode)';\n      console.groupCollapsed(msg);\n      console.log('Initial state:', cloneDeep(initialState));\n      console.groupEnd();\n      /* eslint-enable no-console */\n    }\n    /* eslint-enable no-param-reassign */\n  }\n\n  /**\n   * Gets the value at given `path` of global state. If `path` is null or\n   * undefined, the entire state object is returned.\n   * @param {string} [path] Dot-delimitered state path. If not given, entire\n   * global state content is returned.\n   * @return {any}\n   */\n  get(path) {\n    return get(this, fullPath(path));\n  }\n\n  /**\n   * Writes the `value` to given global state `path`.\n   * @param {string} [path] Dot-delimitered state path. If not given, entire\n   * global state content is replaced by the `value`.\n   * @param {any} value The value.\n   * @return {any} Given `value` itself.\n   */\n  set(path, value) {\n    const p = fullPath(path);\n    if (value !== get(this, p)) {\n      if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n        /* eslint-disable no-console */\n        console.groupCollapsed(\n          `ReactGlobalState update. Path: \"${path || ''}\"`,\n        );\n        console.log('New value:', cloneDeep(value));\n        /* eslint-enable no-console */\n      }\n      let pos = this;\n      const pathSegments = toPath(p);\n      for (let i = 0; i < pathSegments.length - 1; i += 1) {\n        const seg = pathSegments[i];\n        const next = pos[seg];\n        if (isArray(next)) pos[seg] = [...next];\n        else if (isObject(next)) pos[seg] = { ...next };\n        else break;\n        pos = pos[seg];\n      }\n\n      // TODO: With such naive use of _.set, the state is mutated in place,\n      // which may cause tons of unexpected side effects for dependants.\n      // It will be better to partially clone the state, so that any existing\n      // references are not mutated, while the full deep clonning is also\n      // avoided.\n      set(this, p, value);\n\n      if (this.ssrContext) {\n        this.ssrContext.dirty = true;\n        this.ssrContext.state = this.state;\n      } else if (!this.nextNotifierId) {\n        this.nextNotifierId = setTimeout(() => {\n          this.nextNotifierId = null;\n          [...this.watchers].forEach((w) => w());\n        });\n      }\n      if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n        /* eslint-disable no-console */\n        console.log('New state:', cloneDeep(this.state));\n        console.groupEnd();\n        /* eslint-enable no-console */\n      }\n    }\n    return value;\n  }\n\n  /**\n   * Unsubscribes `callback` from watching state updates; no operation if\n   * `callback` is not subscribed to the state updates.\n   * @param {function} callback\n   * @throws if {@link SsrContext} is attached to the state instance: the state\n   * watching functionality is intended for client-side (non-SSR) only.\n   */\n  unWatch(callback) {\n    if (this.ssrContext) throw new Error(ERR_NO_SSR_WATCH);\n    const { watchers } = this;\n    const pos = watchers.indexOf(callback);\n    if (pos >= 0) {\n      watchers[pos] = watchers[watchers.length - 1];\n      watchers.pop();\n    }\n  }\n\n  /**\n   * Subscribes `callback` to watch state updates; no operation if\n   * `callback` is already subscribed to this state instance.\n   * @param {function} callback It will be called without any arguments every\n   * time the state content changes (note, howhever, separate state updates can\n   * be applied to the state at once, and watching callbacks will be called once\n   * after such bulk update).\n   * @throws if {@link SsrContext} is attached to the state instance: the state\n   * watching functionality is intended for client-side (non-SSR) only.\n   */\n  watch(callback) {\n    if (this.ssrContext) throw new Error(ERR_NO_SSR_WATCH);\n    const { watchers } = this;\n    if (watchers.indexOf(callback) < 0) {\n      watchers.push(callback);\n    }\n  }\n}\n"],"file":"GlobalState.js"}
+{"version":3,"file":"GlobalState.js","names":["cloneDeep","get","isFunction","isObject","isNil","set","toPath","isDebugMode","ERR_NO_SSR_WATCH","GlobalState","constructor","initialState","ssrContext","dirty","pending","state","process","env","NODE_ENV","msg","console","groupCollapsed","log","groupEnd","path","initialValue","value","undefined","root","segIdx","pos","pathSegments","length","seg","next","Array","isArray","slice","setTimeout","forEach","w","unWatch","callback","Error","watchers","indexOf","pop","watch","push"],"sources":["../../src/GlobalState.js"],"sourcesContent":["import {\n  cloneDeep,\n  get,\n  isFunction,\n  isObject,\n  isNil,\n  set,\n  toPath,\n} from 'lodash';\n\nimport { isDebugMode } from './utils';\n\nconst ERR_NO_SSR_WATCH = 'GlobalState must not be watched at server side';\n\nexport default class GlobalState {\n  #initialState;\n\n  #nextNotifierId = null;\n\n  #ssrContext;\n\n  #currentState;\n\n  #watchers = [];\n\n  /**\n   * Creates a new global state object.\n   * @param {any} [initialState] Intial global state content.\n   * @param {SsrContext} [ssrContext] Server-side rendering context.\n   */\n  constructor(initialState, ssrContext) {\n    this.#currentState = initialState;\n    this.#initialState = initialState;\n\n    if (ssrContext) {\n      /* eslint-disable no-param-reassign */\n      ssrContext.dirty = false;\n      ssrContext.pending = [];\n      ssrContext.state = this.#currentState;\n      /* eslint-enable no-param-reassign */\n\n      this.#ssrContext = ssrContext;\n    }\n\n    if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n      /* eslint-disable no-console */\n      let msg = 'New ReactGlobalState created';\n      if (ssrContext) msg += ' (SSR mode)';\n      console.groupCollapsed(msg);\n      console.log('Initial state:', cloneDeep(initialState));\n      console.groupEnd();\n      /* eslint-enable no-console */\n    }\n  }\n\n  /**\n   * Gets current or initial value at the specified \"path\" of the global state.\n   * Allows to get the entire global state, and automatically set default value\n   * at the \"path\".\n   * @param {string} [path] Dot-delimitered state path. Pass it \"null\",\n   *  or \"undefined\" to refer the entire global state.\n   * @param {object} [options={}] Additional options.\n   * @param {boolean} [options.initialState] If \"true\" the value will be read\n   *  from the initial state instead of the current one.\n   * @param {any} [options.initialValue] If the value read from the \"path\" is\n   *  \"undefined\", this \"initialValue\" will be returned instead. In such case\n   *  \"initialValue\" will also be written to the \"path\" of the current global\n   *  state (no matter \"initialState\" flag), if \"undefined\" is stored there.\n   * @return {any} Retrieved value.\n   */\n  get(path, { initialState, initialValue } = {}) {\n    const state = initialState ? this.#initialState : this.#currentState;\n    let value = isNil(path) ? state : get(state, path);\n    if (value === undefined && initialValue !== undefined) {\n      value = isFunction(initialValue) ? initialValue() : initialValue;\n      if (!initialState || this.get(path) === undefined) this.set(path, value);\n    }\n    return value;\n  }\n\n  /**\n   * Writes the `value` to given global state `path`.\n   * @param {string} [path] Dot-delimitered state path. If not given, entire\n   * global state content is replaced by the `value`.\n   * @param {any} value The value.\n   * @return {any} Given `value` itself.\n   */\n  set(path, value) {\n    if (value !== this.get(path)) {\n      if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n        /* eslint-disable no-console */\n        console.groupCollapsed(\n          `ReactGlobalState update. Path: \"${path || ''}\"`,\n        );\n        console.log('New value:', cloneDeep(value));\n        /* eslint-enable no-console */\n      }\n\n      if (isNil(path)) this.#currentState = value;\n      else {\n        const root = { state: this.#currentState };\n        let segIdx = 0;\n        let pos = root;\n        const pathSegments = toPath(`state.${path}`);\n        for (; segIdx < pathSegments.length - 1; segIdx += 1) {\n          const seg = pathSegments[segIdx];\n          const next = pos[seg];\n          if (Array.isArray(next)) pos[seg] = [...next];\n          else if (isObject(next)) pos[seg] = { ...next };\n          else {\n            // We arrived to a state sub-segment, where the remaining part of\n            // the update path does not exist yet. We rely on lodash's set()\n            // function to create the remaining path, and set the value.\n            set(pos, pathSegments.slice(segIdx), value);\n            break;\n          }\n          pos = pos[seg];\n        }\n\n        if (segIdx === pathSegments.length - 1) {\n          pos[pathSegments[segIdx]] = value;\n        }\n\n        this.#currentState = root.state;\n      }\n\n      if (this.#ssrContext) {\n        this.#ssrContext.dirty = true;\n        this.#ssrContext.state = this.#currentState;\n      } else if (!this.#nextNotifierId) {\n        this.#nextNotifierId = setTimeout(() => {\n          this.#nextNotifierId = null;\n          [...this.#watchers].forEach((w) => w());\n        });\n      }\n      if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n        /* eslint-disable no-console */\n        console.log('New state:', cloneDeep(this.#currentState));\n        console.groupEnd();\n        /* eslint-enable no-console */\n      }\n    }\n    return value;\n  }\n\n  /**\n   * Unsubscribes `callback` from watching state updates; no operation if\n   * `callback` is not subscribed to the state updates.\n   * @param {function} callback\n   * @throws if {@link SsrContext} is attached to the state instance: the state\n   * watching functionality is intended for client-side (non-SSR) only.\n   */\n  unWatch(callback) {\n    if (this.#ssrContext) throw new Error(ERR_NO_SSR_WATCH);\n\n    const watchers = this.#watchers;\n    const pos = watchers.indexOf(callback);\n    if (pos >= 0) {\n      watchers[pos] = watchers[watchers.length - 1];\n      watchers.pop();\n    }\n  }\n\n  get ssrContext() { return this.#ssrContext; }\n\n  /**\n   * Subscribes `callback` to watch state updates; no operation if\n   * `callback` is already subscribed to this state instance.\n   * @param {function} callback It will be called without any arguments every\n   * time the state content changes (note, howhever, separate state updates can\n   * be applied to the state at once, and watching callbacks will be called once\n   * after such bulk update).\n   * @throws if {@link SsrContext} is attached to the state instance: the state\n   * watching functionality is intended for client-side (non-SSR) only.\n   */\n  watch(callback) {\n    if (this.#ssrContext) throw new Error(ERR_NO_SSR_WATCH);\n\n    const watchers = this.#watchers;\n    if (watchers.indexOf(callback) < 0) {\n      watchers.push(callback);\n    }\n  }\n}\n"],"mappings":"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"}

package/build/module/GlobalStateProvider.js

@@ -1,31 +1,29 @@
-import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
-
 /* eslint-disable react/prop-types */
-import { createContext, useContext, useState } from 'react';
+
+import { createContext, useContext, useRef } from 'react';
 import GlobalState from "./GlobalState";
 import { jsx as _jsx } from "react/jsx-runtime";
-var context = /*#__PURE__*/createContext();
+const context = /*#__PURE__*/createContext();
+
 /**
  * Gets {@link GlobalState} instance from the context. In most cases
  * you should use {@link useGlobalState}, and other hooks to interact with
  * the global state, instead of accessing it directly.
  * @return {GlobalState}
  */
-
 export function getGlobalState() {
   // Here Rules of Hooks are violated because "getGlobalState()" does not follow
   // convention that hook names should start with use... This is intentional in
   // our case, as getGlobalState() hook is intended for advance scenarious,
   // while the normal interaction with the global state should happen via
   // another hook, useGlobalState().
-
   /* eslint-disable react-hooks/rules-of-hooks */
-  var globalState = useContext(context);
+  const globalState = useContext(context);
   /* eslint-enable react-hooks/rules-of-hooks */
-
   if (!globalState) throw new Error('Missing GlobalStateProvider');
   return globalState;
 }
+
 /**
  * @category Hooks
  * @desc Gets SSR context.
@@ -40,19 +38,17 @@ export function getGlobalState() {
  * - If `throwWithoutSsrContext` is `true`, and there is no SSR context attached
  *   to the global state provided by {@link <GlobalStateProvider>}.
  */
-
 export function getSsrContext() {
-  var throwWithoutSsrContext = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
-
-  var _getGlobalState = getGlobalState(),
-      ssrContext = _getGlobalState.ssrContext;
-
+  let throwWithoutSsrContext = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+  const {
+    ssrContext
+  } = getGlobalState();
   if (!ssrContext && throwWithoutSsrContext) {
     throw new Error('No SSR context found');
   }
-
   return ssrContext;
 }
+
 /**
  * Provides global state to its children.
  * @prop {ReactNode} [children] Component children, which will be provided with
@@ -66,30 +62,19 @@ export function getSsrContext() {
  * - If `GlobalState` instance, it will be used by this provider.
  * - If not given, a new `GlobalState` instance will be created and used.
  */
-
 export default function GlobalStateProvider(_ref) {
-  var children = _ref.children,
-      initialState = _ref.initialState,
-      ssrContext = _ref.ssrContext,
-      stateProxy = _ref.stateProxy;
-  var state; // Here Rules of Hooks are violated because hooks are called conditionally,
-  // however we assume that these properties should not change at runtime, thus
-  // the actual hook order is preserved. Probably, it should be handled better,
-  // though.
-
-  /* eslint-disable react-hooks/rules-of-hooks */
-
-  if (stateProxy instanceof GlobalState) state = stateProxy;else if (stateProxy) state = getGlobalState();else {
-    var _useState = useState(new GlobalState(initialState, ssrContext));
-
-    var _useState2 = _slicedToArray(_useState, 1);
-
-    state = _useState2[0];
+  let {
+    children,
+    initialState,
+    ssrContext,
+    stateProxy
+  } = _ref;
+  const state = useRef();
+  if (!state.current) {
+    if (stateProxy instanceof GlobalState) state.current = stateProxy;else if (stateProxy) state.current = getGlobalState();else state.current = new GlobalState(initialState, ssrContext);
   }
-  /* eslint-enable react-hooks/rules-of-hooks */
-
   return /*#__PURE__*/_jsx(context.Provider, {
-    value: state,
+    value: state.current,
     children: children
   });
 }

package/build/module/GlobalStateProvider.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/GlobalStateProvider.jsx"],"names":["createContext","useContext","useState","GlobalState","context","getGlobalState","globalState","Error","getSsrContext","throwWithoutSsrContext","ssrContext","GlobalStateProvider","children","initialState","stateProxy","state"],"mappings":";;AAAA;AAEA,SAASA,aAAT,EAAwBC,UAAxB,EAAoCC,QAApC,QAAoD,OAApD;AAEA,OAAOC,WAAP;;AAEA,IAAMC,OAAO,gBAAGJ,aAAa,EAA7B;AAEA;AACA;AACA;AACA;AACA;AACA;;AACA,OAAO,SAASK,cAAT,GAA0B;AAC/B;AACA;AACA;AACA;AACA;;AACA;AACA,MAAMC,WAAW,GAAGL,UAAU,CAACG,OAAD,CAA9B;AACA;;AACA,MAAI,CAACE,WAAL,EAAkB,MAAM,IAAIC,KAAJ,CAAU,6BAAV,CAAN;AAClB,SAAOD,WAAP;AACD;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AACA,OAAO,SAASE,aAAT,GAAsD;AAAA,MAA/BC,sBAA+B,uEAAN,IAAM;;AAC3D,wBAAuBJ,cAAc,EAArC;AAAA,MAAQK,UAAR,mBAAQA,UAAR;;AACA,MAAI,CAACA,UAAD,IAAeD,sBAAnB,EAA2C;AACzC,UAAM,IAAIF,KAAJ,CAAU,sBAAV,CAAN;AACD;;AACD,SAAOG,UAAP;AACD;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AACA,eAAe,SAASC,mBAAT,OAKZ;AAAA,MAJDC,QAIC,QAJDA,QAIC;AAAA,MAHDC,YAGC,QAHDA,YAGC;AAAA,MAFDH,UAEC,QAFDA,UAEC;AAAA,MADDI,UACC,QADDA,UACC;AACD,MAAIC,KAAJ,CADC,CAED;AACA;AACA;AACA;;AACA;;AACA,MAAID,UAAU,YAAYX,WAA1B,EAAuCY,KAAK,GAAGD,UAAR,CAAvC,KACK,IAAIA,UAAJ,EAAgBC,KAAK,GAAGV,cAAc,EAAtB,CAAhB;AAAA,oBACUH,QAAQ,CAAC,IAAIC,WAAJ,CAAgBU,YAAhB,EAA8BH,UAA9B,CAAD,CADlB;;AAAA;;AACCK,IAAAA,KADD;AAAA;AAEL;;AACA,sBACE,KAAC,OAAD,CAAS,QAAT;AAAkB,IAAA,KAAK,EAAEA,KAAzB;AAAA,cACGH;AADH,IADF;AAKD","sourcesContent":["/* eslint-disable react/prop-types */\n\nimport { createContext, useContext, useState } from 'react';\n\nimport GlobalState from './GlobalState';\n\nconst context = createContext();\n\n/**\n * Gets {@link GlobalState} instance from the context. In most cases\n * you should use {@link useGlobalState}, and other hooks to interact with\n * the global state, instead of accessing it directly.\n * @return {GlobalState}\n */\nexport function getGlobalState() {\n  // Here Rules of Hooks are violated because \"getGlobalState()\" does not follow\n  // convention that hook names should start with use... This is intentional in\n  // our case, as getGlobalState() hook is intended for advance scenarious,\n  // while the normal interaction with the global state should happen via\n  // another hook, useGlobalState().\n  /* eslint-disable react-hooks/rules-of-hooks */\n  const globalState = useContext(context);\n  /* eslint-enable react-hooks/rules-of-hooks */\n  if (!globalState) throw new Error('Missing GlobalStateProvider');\n  return globalState;\n}\n\n/**\n * @category Hooks\n * @desc Gets SSR context.\n * @param {boolean} [throwWithoutSsrContext=true] If `true` (default),\n * this hook will throw if no SSR context is attached to the global state;\n * set `false` to not throw in such case. In either case the hook will throw\n * if the {@link &lt;GlobalStateProvider&gt;} (hence the state) is missing.\n * @returns {SsrContext} SSR context.\n * @throws\n * - If current component has no parent {@link &lt;GlobalStateProvider&gt;}\n *   in the rendered React tree.\n * - If `throwWithoutSsrContext` is `true`, and there is no SSR context attached\n *   to the global state provided by {@link &lt;GlobalStateProvider&gt;}.\n */\nexport function getSsrContext(throwWithoutSsrContext = true) {\n  const { ssrContext } = getGlobalState();\n  if (!ssrContext && throwWithoutSsrContext) {\n    throw new Error('No SSR context found');\n  }\n  return ssrContext;\n}\n\n/**\n * Provides global state to its children.\n * @prop {ReactNode} [children] Component children, which will be provided with\n * the global state, and rendered in place of the provider.\n * @prop {any} [initialState] Initial content of the global state.\n * @prop {SsrContext} [ssrContext] Server-side rendering (SSR) context.\n * @prop {boolean|GlobalState} [stateProxy] This option is useful for code\n * splitting and SSR implementation:\n * - If `true`, this provider instance will fetch and reuse the global state\n *   from a parent provider.\n * - If `GlobalState` instance, it will be used by this provider.\n * - If not given, a new `GlobalState` instance will be created and used.\n */\nexport default function GlobalStateProvider({\n  children,\n  initialState,\n  ssrContext,\n  stateProxy,\n}) {\n  let state;\n  // Here Rules of Hooks are violated because hooks are called conditionally,\n  // however we assume that these properties should not change at runtime, thus\n  // the actual hook order is preserved. Probably, it should be handled better,\n  // though.\n  /* eslint-disable react-hooks/rules-of-hooks */\n  if (stateProxy instanceof GlobalState) state = stateProxy;\n  else if (stateProxy) state = getGlobalState();\n  else [state] = useState(new GlobalState(initialState, ssrContext));\n  /* eslint-enable react-hooks/rules-of-hooks */\n  return (\n    <context.Provider value={state}>\n      {children}\n    </context.Provider>\n  );\n}\n"],"file":"GlobalStateProvider.js"}
+{"version":3,"file":"GlobalStateProvider.js","names":["createContext","useContext","useRef","GlobalState","context","getGlobalState","globalState","Error","getSsrContext","throwWithoutSsrContext","ssrContext","GlobalStateProvider","children","initialState","stateProxy","state","current"],"sources":["../../src/GlobalStateProvider.jsx"],"sourcesContent":["/* eslint-disable react/prop-types */\n\nimport { createContext, useContext, useRef } from 'react';\n\nimport GlobalState from './GlobalState';\n\nconst context = createContext();\n\n/**\n * Gets {@link GlobalState} instance from the context. In most cases\n * you should use {@link useGlobalState}, and other hooks to interact with\n * the global state, instead of accessing it directly.\n * @return {GlobalState}\n */\nexport function getGlobalState() {\n  // Here Rules of Hooks are violated because \"getGlobalState()\" does not follow\n  // convention that hook names should start with use... This is intentional in\n  // our case, as getGlobalState() hook is intended for advance scenarious,\n  // while the normal interaction with the global state should happen via\n  // another hook, useGlobalState().\n  /* eslint-disable react-hooks/rules-of-hooks */\n  const globalState = useContext(context);\n  /* eslint-enable react-hooks/rules-of-hooks */\n  if (!globalState) throw new Error('Missing GlobalStateProvider');\n  return globalState;\n}\n\n/**\n * @category Hooks\n * @desc Gets SSR context.\n * @param {boolean} [throwWithoutSsrContext=true] If `true` (default),\n * this hook will throw if no SSR context is attached to the global state;\n * set `false` to not throw in such case. In either case the hook will throw\n * if the {@link &lt;GlobalStateProvider&gt;} (hence the state) is missing.\n * @returns {SsrContext} SSR context.\n * @throws\n * - If current component has no parent {@link &lt;GlobalStateProvider&gt;}\n *   in the rendered React tree.\n * - If `throwWithoutSsrContext` is `true`, and there is no SSR context attached\n *   to the global state provided by {@link &lt;GlobalStateProvider&gt;}.\n */\nexport function getSsrContext(throwWithoutSsrContext = true) {\n  const { ssrContext } = getGlobalState();\n  if (!ssrContext && throwWithoutSsrContext) {\n    throw new Error('No SSR context found');\n  }\n  return ssrContext;\n}\n\n/**\n * Provides global state to its children.\n * @prop {ReactNode} [children] Component children, which will be provided with\n * the global state, and rendered in place of the provider.\n * @prop {any} [initialState] Initial content of the global state.\n * @prop {SsrContext} [ssrContext] Server-side rendering (SSR) context.\n * @prop {boolean|GlobalState} [stateProxy] This option is useful for code\n * splitting and SSR implementation:\n * - If `true`, this provider instance will fetch and reuse the global state\n *   from a parent provider.\n * - If `GlobalState` instance, it will be used by this provider.\n * - If not given, a new `GlobalState` instance will be created and used.\n */\nexport default function GlobalStateProvider({\n  children,\n  initialState,\n  ssrContext,\n  stateProxy,\n}) {\n  const state = useRef();\n  if (!state.current) {\n    if (stateProxy instanceof GlobalState) state.current = stateProxy;\n    else if (stateProxy) state.current = getGlobalState();\n    else state.current = new GlobalState(initialState, ssrContext);\n  }\n  return (\n    <context.Provider value={state.current}>\n      {children}\n    </context.Provider>\n  );\n}\n"],"mappings":"AAAA;;AAEA,SAASA,aAAa,EAAEC,UAAU,EAAEC,MAAM,QAAQ,OAAO;AAEzD,OAAOC,WAAW;AAAsB;AAExC,MAAMC,OAAO,gBAAGJ,aAAa,EAAE;;AAE/B;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASK,cAAc,GAAG;EAC/B;EACA;EACA;EACA;EACA;EACA;EACA,MAAMC,WAAW,GAAGL,UAAU,CAACG,OAAO,CAAC;EACvC;EACA,IAAI,CAACE,WAAW,EAAE,MAAM,IAAIC,KAAK,CAAC,6BAA6B,CAAC;EAChE,OAAOD,WAAW;AACpB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASE,aAAa,GAAgC;EAAA,IAA/BC,sBAAsB,uEAAG,IAAI;EACzD,MAAM;IAAEC;EAAW,CAAC,GAAGL,cAAc,EAAE;EACvC,IAAI,CAACK,UAAU,IAAID,sBAAsB,EAAE;IACzC,MAAM,IAAIF,KAAK,CAAC,sBAAsB,CAAC;EACzC;EACA,OAAOG,UAAU;AACnB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,eAAe,SAASC,mBAAmB,OAKxC;EAAA,IALyC;IAC1CC,QAAQ;IACRC,YAAY;IACZH,UAAU;IACVI;EACF,CAAC;EACC,MAAMC,KAAK,GAAGb,MAAM,EAAE;EACtB,IAAI,CAACa,KAAK,CAACC,OAAO,EAAE;IAClB,IAAIF,UAAU,YAAYX,WAAW,EAAEY,KAAK,CAACC,OAAO,GAAGF,UAAU,CAAC,KAC7D,IAAIA,UAAU,EAAEC,KAAK,CAACC,OAAO,GAAGX,cAAc,EAAE,CAAC,KACjDU,KAAK,CAACC,OAAO,GAAG,IAAIb,WAAW,CAACU,YAAY,EAAEH,UAAU,CAAC;EAChE;EACA,oBACE,KAAC,OAAO,CAAC,QAAQ;IAAC,KAAK,EAAEK,KAAK,CAACC,OAAQ;IAAA,UACpCJ;EAAQ,EACQ;AAEvB"}

package/build/module/index.js

@@ -3,15 +3,8 @@
 // are still in a wide use, this polyfill is added here, and it is to be dropped
 // some time later.
 if (!Promise.allSettled) {
-  Promise.allSettled = function (promises) {
-    return Promise.all(promises.map(function (p) {
-      return p instanceof Promise ? p.finally(function () {
-        return null;
-      }) : p;
-    }));
-  };
+  Promise.allSettled = promises => Promise.all(promises.map(p => p instanceof Promise ? p.finally(() => null) : p));
 }
-
 export { default as GlobalStateProvider, getGlobalState, getSsrContext } from "./GlobalStateProvider";
 export { default as useAsyncCollection } from "./useAsyncCollection";
 export { default as useAsyncData } from "./useAsyncData";

package/build/module/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/index.js"],"names":["Promise","allSettled","promises","all","map","p","finally","default","GlobalStateProvider","getGlobalState","getSsrContext","useAsyncCollection","useAsyncData","useGlobalState"],"mappings":"AAAA;AACA;AACA;AACA;AACA,IAAI,CAACA,OAAO,CAACC,UAAb,EAAyB;AACvBD,EAAAA,OAAO,CAACC,UAAR,GAAqB,UAACC,QAAD;AAAA,WAAcF,OAAO,CAACG,GAAR,CACjCD,QAAQ,CAACE,GAAT,CAAa,UAACC,CAAD;AAAA,aAAQA,CAAC,YAAYL,OAAb,GAAuBK,CAAC,CAACC,OAAF,CAAU;AAAA,eAAM,IAAN;AAAA,OAAV,CAAvB,GAA+CD,CAAvD;AAAA,KAAb,CADiC,CAAd;AAAA,GAArB;AAGD;;AAED,SACEE,OAAO,IAAIC,mBADb,EAEEC,cAFF,EAGEC,aAHF;AAMA,SAASH,OAAO,IAAII,kBAApB;AACA,SAASJ,OAAO,IAAIK,YAApB;AACA,SAASL,OAAO,IAAIM,cAApB","sourcesContent":["// TODO: This is a temporary polyfill for `Promise.allSettled(..)` method,\n// which is supported natively by NodeJS >= v12.9.0. As earlier NodeJS version\n// are still in a wide use, this polyfill is added here, and it is to be dropped\n// some time later.\nif (!Promise.allSettled) {\n  Promise.allSettled = (promises) => Promise.all(\n    promises.map((p) => (p instanceof Promise ? p.finally(() => null) : p)),\n  );\n}\n\nexport {\n  default as GlobalStateProvider,\n  getGlobalState,\n  getSsrContext,\n} from './GlobalStateProvider';\n\nexport { default as useAsyncCollection } from './useAsyncCollection';\nexport { default as useAsyncData } from './useAsyncData';\nexport { default as useGlobalState } from './useGlobalState';\n"],"file":"index.js"}
+{"version":3,"file":"index.js","names":["Promise","allSettled","promises","all","map","p","finally","default","GlobalStateProvider","getGlobalState","getSsrContext","useAsyncCollection","useAsyncData","useGlobalState"],"sources":["../../src/index.js"],"sourcesContent":["// TODO: This is a temporary polyfill for `Promise.allSettled(..)` method,\n// which is supported natively by NodeJS >= v12.9.0. As earlier NodeJS version\n// are still in a wide use, this polyfill is added here, and it is to be dropped\n// some time later.\nif (!Promise.allSettled) {\n  Promise.allSettled = (promises) => Promise.all(\n    promises.map((p) => (p instanceof Promise ? p.finally(() => null) : p)),\n  );\n}\n\nexport {\n  default as GlobalStateProvider,\n  getGlobalState,\n  getSsrContext,\n} from './GlobalStateProvider';\n\nexport { default as useAsyncCollection } from './useAsyncCollection';\nexport { default as useAsyncData } from './useAsyncData';\nexport { default as useGlobalState } from './useGlobalState';\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA,IAAI,CAACA,OAAO,CAACC,UAAU,EAAE;EACvBD,OAAO,CAACC,UAAU,GAAIC,QAAQ,IAAKF,OAAO,CAACG,GAAG,CAC5CD,QAAQ,CAACE,GAAG,CAAEC,CAAC,IAAMA,CAAC,YAAYL,OAAO,GAAGK,CAAC,CAACC,OAAO,CAAC,MAAM,IAAI,CAAC,GAAGD,CAAE,CAAC,CACxE;AACH;AAEA,SACEE,OAAO,IAAIC,mBAAmB,EAC9BC,cAAc,EACdC,aAAa;AAGf,SAASH,OAAO,IAAII,kBAAkB;AACtC,SAASJ,OAAO,IAAIK,YAAY;AAChC,SAASL,OAAO,IAAIM,cAAc"}

package/build/module/useAsyncCollection.js

@@ -1,7 +1,9 @@
 /**
  * Loads and uses an item in an async collection.
  */
+
 import useAsyncData from "./useAsyncData";
+
 /**
  * Resolves and stores at the given `path` of global state elements of
  * an asynchronous data collection. In other words, it is an auxiliar wrapper
@@ -48,12 +50,9 @@ import useAsyncData from "./useAsyncData";
  * _e.g._ {@link useGlobalState}, but doing so you may interfere with related
  * `useAsyncData()` hooks logic.
  */
-
 export default function useAsyncCollection(id, path, loader) {
-  var options = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : {};
-  var itemPath = path ? "".concat(path, ".").concat(id) : id;
-  return useAsyncData(itemPath, function (oldData) {
-    return loader(id, oldData);
-  }, options);
+  let options = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : {};
+  const itemPath = path ? `${path}.${id}` : id;
+  return useAsyncData(itemPath, oldData => loader(id, oldData), options);
 }
 //# sourceMappingURL=useAsyncCollection.js.map

package/build/module/useAsyncCollection.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/useAsyncCollection.js"],"names":["useAsyncData","useAsyncCollection","id","path","loader","options","itemPath","oldData"],"mappings":"AAAA;AACA;AACA;AAEA,OAAOA,YAAP;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AACA,eAAe,SAASC,kBAAT,CACbC,EADa,EAEbC,IAFa,EAGbC,MAHa,EAKb;AAAA,MADAC,OACA,uEADU,EACV;AACA,MAAMC,QAAQ,GAAGH,IAAI,aAAMA,IAAN,cAAcD,EAAd,IAAqBA,EAA1C;AACA,SAAOF,YAAY,CAACM,QAAD,EAAW,UAACC,OAAD;AAAA,WAAaH,MAAM,CAACF,EAAD,EAAKK,OAAL,CAAnB;AAAA,GAAX,EAA6CF,OAA7C,CAAnB;AACD","sourcesContent":["/**\n * Loads and uses an item in an async collection.\n */\n\nimport useAsyncData from './useAsyncData';\n\n/**\n * Resolves and stores at the given `path` of global state elements of\n * an asynchronous data collection. In other words, it is an auxiliar wrapper\n * around {@link useAsyncData}, which uses a loader which resolves to different\n * data, based on ID argument passed in, and stores data fetched for different\n * IDs in the state.\n * @param {string} id ID of the collection item to load & use.\n * @param {string} path The global state path where entire collection should be\n *  stored.\n * @param {AsyncCollectionLoader} loader A loader function, which takes an\n * ID of data to load, and resolves to the corresponding data.\n * @param {object} [options] Additional options.\n * @param {any[]} [options.deps=[]] An array of dependencies, which trigger\n * data reload when changed. Given dependency changes are watched shallowly\n * (similarly to the standard React's\n * [useEffect()](https://reactjs.org/docs/hooks-reference.html#useeffect)).\n * @param {boolean} [options.noSSR] If `true`, this hook won't load data during\n * server-side rendering.\n * @param {number} [options.garbageCollectAge=maxage] The maximum age of data\n * (in milliseconds), after which they are dropped from the state when the last\n * component referencing them via `useAsyncData()` hook unmounts. Defaults to\n * `maxage` option value.\n * @param {number} [options.maxage=5 x 60 x 1000] The maximum age of\n * data (in milliseconds) acceptable to the hook's caller. If loaded data are\n * older than this value, `null` is returned instead. Defaults to 5 minutes.\n * @param {number} [options.refreshAge=maxage] The maximum age of data\n * (in milliseconds), after which their refreshment will be triggered when\n * any component referencing them via `useAsyncData()` hook (re-)renders.\n * Defaults to `maxage` value.\n * @return {{\n *   data: any,\n *   loading: boolean,\n *   timestamp: number\n * }} Returns an object with three fields: `data` holds the actual result of\n * last `loader` invokation, if any, and if satisfies `maxage` limit; `loading`\n * is a boolean flag, which is `true` if data are being loaded (the hook is\n * waiting for `loader` function resolution); `timestamp` (in milliseconds)\n * is Unix timestamp of related data currently loaded into the global state.\n *\n * Note that loaded data, if any, are stored at the given `path` of global state\n * along with related meta-information, using slightly different state segment\n * structure (see {@link AsyncDataEnvelope}). That segment of the global state\n * can be accessed, and even modified using other hooks,\n * _e.g._ {@link useGlobalState}, but doing so you may interfere with related\n * `useAsyncData()` hooks logic.\n */\nexport default function useAsyncCollection(\n  id,\n  path,\n  loader,\n  options = {},\n) {\n  const itemPath = path ? `${path}.${id}` : id;\n  return useAsyncData(itemPath, (oldData) => loader(id, oldData), options);\n}\n"],"file":"useAsyncCollection.js"}
+{"version":3,"file":"useAsyncCollection.js","names":["useAsyncData","useAsyncCollection","id","path","loader","options","itemPath","oldData"],"sources":["../../src/useAsyncCollection.js"],"sourcesContent":["/**\n * Loads and uses an item in an async collection.\n */\n\nimport useAsyncData from './useAsyncData';\n\n/**\n * Resolves and stores at the given `path` of global state elements of\n * an asynchronous data collection. In other words, it is an auxiliar wrapper\n * around {@link useAsyncData}, which uses a loader which resolves to different\n * data, based on ID argument passed in, and stores data fetched for different\n * IDs in the state.\n * @param {string} id ID of the collection item to load & use.\n * @param {string} path The global state path where entire collection should be\n *  stored.\n * @param {AsyncCollectionLoader} loader A loader function, which takes an\n * ID of data to load, and resolves to the corresponding data.\n * @param {object} [options] Additional options.\n * @param {any[]} [options.deps=[]] An array of dependencies, which trigger\n * data reload when changed. Given dependency changes are watched shallowly\n * (similarly to the standard React's\n * [useEffect()](https://reactjs.org/docs/hooks-reference.html#useeffect)).\n * @param {boolean} [options.noSSR] If `true`, this hook won't load data during\n * server-side rendering.\n * @param {number} [options.garbageCollectAge=maxage] The maximum age of data\n * (in milliseconds), after which they are dropped from the state when the last\n * component referencing them via `useAsyncData()` hook unmounts. Defaults to\n * `maxage` option value.\n * @param {number} [options.maxage=5 x 60 x 1000] The maximum age of\n * data (in milliseconds) acceptable to the hook's caller. If loaded data are\n * older than this value, `null` is returned instead. Defaults to 5 minutes.\n * @param {number} [options.refreshAge=maxage] The maximum age of data\n * (in milliseconds), after which their refreshment will be triggered when\n * any component referencing them via `useAsyncData()` hook (re-)renders.\n * Defaults to `maxage` value.\n * @return {{\n *   data: any,\n *   loading: boolean,\n *   timestamp: number\n * }} Returns an object with three fields: `data` holds the actual result of\n * last `loader` invokation, if any, and if satisfies `maxage` limit; `loading`\n * is a boolean flag, which is `true` if data are being loaded (the hook is\n * waiting for `loader` function resolution); `timestamp` (in milliseconds)\n * is Unix timestamp of related data currently loaded into the global state.\n *\n * Note that loaded data, if any, are stored at the given `path` of global state\n * along with related meta-information, using slightly different state segment\n * structure (see {@link AsyncDataEnvelope}). That segment of the global state\n * can be accessed, and even modified using other hooks,\n * _e.g._ {@link useGlobalState}, but doing so you may interfere with related\n * `useAsyncData()` hooks logic.\n */\nexport default function useAsyncCollection(\n  id,\n  path,\n  loader,\n  options = {},\n) {\n  const itemPath = path ? `${path}.${id}` : id;\n  return useAsyncData(itemPath, (oldData) => loader(id, oldData), options);\n}\n"],"mappings":"AAAA;AACA;AACA;;AAEA,OAAOA,YAAY;;AAEnB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,eAAe,SAASC,kBAAkB,CACxCC,EAAE,EACFC,IAAI,EACJC,MAAM,EAEN;EAAA,IADAC,OAAO,uEAAG,CAAC,CAAC;EAEZ,MAAMC,QAAQ,GAAGH,IAAI,GAAI,GAAEA,IAAK,IAAGD,EAAG,EAAC,GAAGA,EAAE;EAC5C,OAAOF,YAAY,CAACM,QAAQ,EAAGC,OAAO,IAAKH,MAAM,CAACF,EAAE,EAAEK,OAAO,CAAC,EAAEF,OAAO,CAAC;AAC1E"}