@dr.pogodin/react-global-state 0.6.4 → 0.7.0

package/README.md

@@ -257,5 +257,82 @@ of some, or all async data at the server side.
     }
     ```
 
+### Frequently Asked Questions
+
+- _Does React Global State library avoid unnecessary component re-renders when values updated in the global state are irrelevant to those components?_
+
+  Yes, it does avoid unnecessary re-renders of the component tree. A component
+  relying on `some.path` in the global state is re-rendered only when the value
+  at this path, or its sub-path has changed; _i.e._ it will be re-rendered if
+  the value at `some.path` has changed, and it will be re-rendered if the value
+  at `some.path.sub.path` has changed.
+
+- _How would you describe your use case compared to another React global state library, e.g. [Valtio](https://www.npmjs.com/package/valtio)?_
+
+  1.  React Global State is designed to follow the standard React API as close
+      as possible. _E.g._ if some component relies on the local state:
+      ```jsx
+      const [value, setValue] = useState(initialState);
+      ```
+      to move that value to the global state (or _vice versa_) one only needs to
+      replace the hook with
+      ```jsx
+      const [value, setValue] = useGlobalState(path, initialState);
+      ```
+      The [useGlobalState()] hook takes care to follow all edge cases of the
+      standard [useState()]: `setValue` setter identity is stable (does not
+      change on re-renders), functional updates and lazy initial state are
+      supported.
+
+      Other libraries tend to re-invent the wheel, introducing their own APIs,
+      which (i) should be learned and understood; (ii) do complicate migration
+      of components between the local and global state, should it be needed in
+      a course of app development / prototyping.
+
+  2.  When it comes to async data in the global state other libraries tend to
+      offer only a very basic supported, often relying on experimental or internal
+      React mechanics.
+
+      React Global State, [useAsyncData()] and [useAsyncCollection()] hooks in
+      particular, implements async data fetching and management features: when
+      multiple components use these hooks to load async data to the same global
+      state path the library takes care to do the actual loading just once, and
+      then keep the data without reloading until their age reaches (configurable)
+      max age. There is an automated garbage collection of expired, non-used
+      async data from the global state; there is server-side rendering (SSR)
+      support, with suggested high-level setup taking care that all async data
+      loaded using [useAsyncData()] and [useAsyncCollection()] hooks will be
+      automatically loaded and used in server-side renders (still allowing to
+      opt-out of that for individual hooks, and timeout server-side fetching of
+      data that take too long to arrive, in which case the library will fetch
+      such data client-side). It does not rely on experimental React APIs to
+      achieve its functionality, it only uses current public APIs.
+
+      For me the support of async data fetching into the global state and their
+      further management with out-of-the-box SSR support was the primary
+      motivation to create React Global State. There are many other global state
+      React libraries, but I was not able to find any that would cover the async
+      data handling with that ease I believed was possible. The secondary
+      motivation was that existing global state libraries either had
+      the shortcoming of unnecessary component re-renders when data irrelevant
+      to them where updated in the global state, or introduced their
+      own APIs, where following the standard React APIs for local state looks
+      to me a way more convenient approach.
+
+- _Is React Global State library production ready (considering the current version number 0.y.z)?_
+
+  Yes. I personally use it in production for all my commercial and personal
+  React projects for over an year. I just don't feel like to call it v1 until
+  a reasonable adoption by 3rd party developers, and any API improvements that
+  may come out of community experience.
+
 [Library Reference](https://dr.pogodin.studio/docs/react-global-state/index.html) •
 [Blog Article](https://dr.pogodin.studio/dev-blog/the-global-state-in-react-designed-right)
+
+[useAsyncCollection()]: https://dr.pogodin.studio/docs/react-global-state/docs/api/hooks/useasynccollection
+[useAsyncData()]: https://dr.pogodin.studio/docs/react-global-state/docs/api/hooks/useasyncdata
+[useGlobalState()]: https://dr.pogodin.studio/docs/react-global-state/docs/api/hooks/useglobalstate
+[useState()]: https://reactjs.org/docs/hooks-reference.html#usestate
+
+[functional updates]: https://reactjs.org/docs/hooks-reference.html#functional-updates
+[lazy initial state]: https://reactjs.org/docs/hooks-reference.html#functional-updates

package/build/{web → module}/GlobalState.js

@@ -1,28 +1,14 @@
-"use strict";
+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";
 
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+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; }
 
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = void 0;
-
-var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
-
-var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
-
-var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/classCallCheck"));
-
-var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/createClass"));
-
-var _lodash = require("lodash");
-
-var _utils = require("./utils");
-
-function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); if (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 = arguments[i] != null ? arguments[i] : {}; if (i % 2) { ownKeys(Object(source), true).forEach(function (key) { (0, _defineProperty2.default)(target, key, source[key]); }); } else if (Object.getOwnPropertyDescriptors) { Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)); } else { ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } } return target; }
+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 { 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.
@@ -32,7 +18,7 @@ var ERR_NO_SSR_WATCH = 'GlobalState must not be watched at server side';
  */
 
 function fullPath(statePath) {
-  return (0, _lodash.isNil)(statePath) ? 'state' : "state.".concat(statePath);
+  return isNil(statePath) ? 'state' : "state.".concat(statePath);
 }
 
 var GlobalState = /*#__PURE__*/function () {
@@ -42,10 +28,10 @@ var GlobalState = /*#__PURE__*/function () {
    * @param {SsrContext} [ssrContext] Server-side rendering context.
    */
   function GlobalState(initialState, ssrContext) {
-    (0, _classCallCheck2.default)(this, GlobalState);
+    _classCallCheck(this, GlobalState);
 
     /* eslint-disable no-param-reassign */
-    this.state = (0, _lodash.cloneDeep)(initialState);
+    this.state = cloneDeep(initialState);
     this.nextNotifierId = null;
     this.watchers = [];
 
@@ -56,12 +42,12 @@ var GlobalState = /*#__PURE__*/function () {
       this.ssrContext = ssrContext;
     }
 
-    if (process.env.NODE_ENV !== 'production' && (0, _utils.isDebugMode)()) {
+    if (process.env.NODE_ENV !== 'production' && isDebugMode()) {
       /* eslint-disable no-console */
       var msg = 'New ReactGlobalState created';
       if (ssrContext) msg += ' (SSR mode)';
       console.groupCollapsed(msg);
-      console.log('Initial state:', (0, _lodash.cloneDeep)(initialState));
+      console.log('Initial state:', cloneDeep(initialState));
       console.groupEnd();
       /* eslint-enable no-console */
     }
@@ -77,10 +63,10 @@ var GlobalState = /*#__PURE__*/function () {
    */
 
 
-  (0, _createClass2.default)(GlobalState, [{
+  _createClass(GlobalState, [{
     key: "get",
     value: function get(path) {
-      return (0, _lodash.get)(this, fullPath(path));
+      return _get(this, fullPath(path));
     }
     /**
      * Writes the `value` to given global state `path`.
@@ -97,21 +83,21 @@ var GlobalState = /*#__PURE__*/function () {
 
       var p = fullPath(path);
 
-      if (value !== (0, _lodash.get)(this, p)) {
-        if (process.env.NODE_ENV !== 'production' && (0, _utils.isDebugMode)()) {
+      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:', (0, _lodash.cloneDeep)(value));
+          console.log('New value:', cloneDeep(value));
           /* eslint-enable no-console */
         }
 
         var pos = this;
-        var pathSegments = (0, _lodash.toPath)(p);
+        var pathSegments = toPath(p);
 
         for (var i = 0; i < pathSegments.length - 1; i += 1) {
           var seg = pathSegments[i];
           var next = pos[seg];
-          if ((0, _lodash.isArray)(next)) pos[seg] = (0, _toConsumableArray2.default)(next);else if ((0, _lodash.isObject)(next)) pos[seg] = _objectSpread({}, next);else break;
+          if (isArray(next)) pos[seg] = _toConsumableArray(next);else if (isObject(next)) pos[seg] = _objectSpread({}, next);else 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.
@@ -120,7 +106,7 @@ var GlobalState = /*#__PURE__*/function () {
         // avoided.
 
 
-        (0, _lodash.set)(this, p, value);
+        _set(this, p, value);
 
         if (this.ssrContext) {
           this.ssrContext.dirty = true;
@@ -128,15 +114,16 @@ var GlobalState = /*#__PURE__*/function () {
         } else if (!this.nextNotifierId) {
           this.nextNotifierId = setTimeout(function () {
             _this.nextNotifierId = null;
-            (0, _toConsumableArray2.default)(_this.watchers).forEach(function (w) {
+
+            _toConsumableArray(_this.watchers).forEach(function (w) {
               return w();
             });
           });
         }
 
-        if (process.env.NODE_ENV !== 'production' && (0, _utils.isDebugMode)()) {
+        if (process.env.NODE_ENV !== 'production' && isDebugMode()) {
           /* eslint-disable no-console */
-          console.log('New state:', (0, _lodash.cloneDeep)(this.state));
+          console.log('New state:', cloneDeep(this.state));
           console.groupEnd();
           /* eslint-enable no-console */
         }
@@ -186,8 +173,9 @@ var GlobalState = /*#__PURE__*/function () {
       }
     }
   }]);
+
   return GlobalState;
 }();
 
-exports.default = GlobalState;
+export { GlobalState as default };
 //# sourceMappingURL=GlobalState.js.map

package/build/module/GlobalState.js.map

@@ -0,0 +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"}

package/build/{web → module}/GlobalStateProvider.js

@@ -1,24 +1,10 @@
-"use strict";
-
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = GlobalStateProvider;
-exports.getGlobalState = getGlobalState;
-exports.getSsrContext = getSsrContext;
-
-var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
-
-var _react = require("react");
-
-var _GlobalState = _interopRequireDefault(require("./GlobalState"));
-
-var _jsxRuntime = require("react/jsx-runtime");
+import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
 
 /* eslint-disable react/prop-types */
-var context = /*#__PURE__*/(0, _react.createContext)();
+import { createContext, useContext, useState } from 'react';
+import GlobalState from "./GlobalState";
+import { jsx as _jsx } from "react/jsx-runtime";
+var context = /*#__PURE__*/createContext();
 /**
  * Gets {@link GlobalState} instance from the context. In most cases
  * you should use {@link useGlobalState}, and other hooks to interact with
@@ -26,7 +12,7 @@ var context = /*#__PURE__*/(0, _react.createContext)();
  * @return {GlobalState}
  */
 
-function getGlobalState() {
+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,
@@ -34,7 +20,7 @@ function getGlobalState() {
   // another hook, useGlobalState().
 
   /* eslint-disable react-hooks/rules-of-hooks */
-  var globalState = (0, _react.useContext)(context);
+  var globalState = useContext(context);
   /* eslint-enable react-hooks/rules-of-hooks */
 
   if (!globalState) throw new Error('Missing GlobalStateProvider');
@@ -55,8 +41,7 @@ function getGlobalState() {
  *   to the global state provided by {@link <GlobalStateProvider>}.
  */
 
-
-function getSsrContext() {
+export function getSsrContext() {
   var throwWithoutSsrContext = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
 
   var _getGlobalState = getGlobalState(),
@@ -82,8 +67,7 @@ function getSsrContext() {
  * - If not given, a new `GlobalState` instance will be created and used.
  */
 
-
-function GlobalStateProvider(_ref) {
+export default function GlobalStateProvider(_ref) {
   var children = _ref.children,
       initialState = _ref.initialState,
       ssrContext = _ref.ssrContext,
@@ -95,16 +79,16 @@ function GlobalStateProvider(_ref) {
 
   /* eslint-disable react-hooks/rules-of-hooks */
 
-  if (stateProxy instanceof _GlobalState.default) state = stateProxy;else if (stateProxy) state = getGlobalState();else {
-    var _useState = (0, _react.useState)(new _GlobalState.default(initialState, ssrContext));
+  if (stateProxy instanceof GlobalState) state = stateProxy;else if (stateProxy) state = getGlobalState();else {
+    var _useState = useState(new GlobalState(initialState, ssrContext));
 
-    var _useState2 = (0, _slicedToArray2.default)(_useState, 1);
+    var _useState2 = _slicedToArray(_useState, 1);
 
     state = _useState2[0];
   }
   /* eslint-enable react-hooks/rules-of-hooks */
 
-  return /*#__PURE__*/(0, _jsxRuntime.jsx)(context.Provider, {
+  return /*#__PURE__*/_jsx(context.Provider, {
     value: state,
     children: children
   });

package/build/module/GlobalStateProvider.js.map

@@ -0,0 +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"}

package/build/module/index.js

@@ -0,0 +1,19 @@
+// TODO: This is a temporary polyfill for `Promise.allSettled(..)` method,
+// which is supported natively by NodeJS >= v12.9.0. As earlier NodeJS version
+// 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;
+    }));
+  };
+}
+
+export { default as GlobalStateProvider, getGlobalState, getSsrContext } from "./GlobalStateProvider";
+export { default as useAsyncCollection } from "./useAsyncCollection";
+export { default as useAsyncData } from "./useAsyncData";
+export { default as useGlobalState } from "./useGlobalState";
+//# sourceMappingURL=index.js.map

package/build/module/index.js.map

@@ -0,0 +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"}

package/build/{web → module}/useAsyncCollection.js

@@ -1,18 +1,7 @@
-"use strict";
-
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = useAsyncCollection;
-
-var _useAsyncData = _interopRequireDefault(require("./useAsyncData"));
-
 /**
  * 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
@@ -59,10 +48,11 @@ var _useAsyncData = _interopRequireDefault(require("./useAsyncData"));
  * _e.g._ {@link useGlobalState}, but doing so you may interfere with related
  * `useAsyncData()` hooks logic.
  */
-function useAsyncCollection(id, path, loader) {
+
+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 (0, _useAsyncData.default)(itemPath, function (oldData) {
+  return useAsyncData(itemPath, function (oldData) {
     return loader(id, oldData);
   }, options);
 }

package/build/module/useAsyncCollection.js.map

@@ -0,0 +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"}

package/build/{web → module}/useAsyncData.js

@@ -1,36 +1,21 @@
-"use strict";
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
+import _asyncToGenerator from "@babel/runtime/helpers/asyncToGenerator";
+import _regeneratorRuntime from "@babel/runtime/regenerator";
 
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+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; }
 
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = useAsyncData;
-
-var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
-
-var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
-
-var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
-
-var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
-
-var _lodash = require("lodash");
-
-var _react = require("react");
-
-var _uuid = require("uuid");
-
-var _GlobalStateProvider = require("./GlobalStateProvider");
-
-var _useGlobalState3 = _interopRequireDefault(require("./useGlobalState"));
-
-var _utils = require("./utils");
-
-function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); if (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 = arguments[i] != null ? arguments[i] : {}; if (i % 2) { ownKeys(Object(source), true).forEach(function (key) { (0, _defineProperty2.default)(target, key, source[key]); }); } else if (Object.getOwnPropertyDescriptors) { Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)); } else { ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } } return target; }
+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; }
 
+/**
+ * Loads and uses async data into the GlobalState path.
+ */
+import { cloneDeep } from 'lodash';
+import { useEffect } from 'react';
+import { v4 as uuid } from 'uuid';
+import { getGlobalState } from "./GlobalStateProvider";
+import useGlobalState from "./useGlobalState";
+import { isDebugMode } from "./utils";
 var DEFAULT_MAXAGE = 5 * 60 * 1000; // 5 minutes.
 
 /**
@@ -105,26 +90,26 @@ function load(_x, _x2, _x3, _x4) {
 
 
 function _load() {
-  _load = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(path, loader, globalState, oldData) {
+  _load = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee(path, loader, globalState, oldData) {
     var opIdPrefix,
         operationId,
         operationIdPath,
         data,
         state,
         _args = arguments;
-    return _regenerator.default.wrap(function _callee$(_context) {
+    return _regeneratorRuntime.wrap(function _callee$(_context) {
       while (1) {
         switch (_context.prev = _context.next) {
           case 0:
             opIdPrefix = _args.length > 4 && _args[4] !== undefined ? _args[4] : 'C';
 
-            if (process.env.NODE_ENV !== 'production' && (0, _utils.isDebugMode)()) {
+            if (process.env.NODE_ENV !== 'production' && isDebugMode()) {
               /* eslint-disable no-console */
               console.log("ReactGlobalState: useAsyncData data (re-)loading. Path: \"".concat(path || '', "\""));
               /* eslint-enable no-console */
             }
 
-            operationId = opIdPrefix + (0, _uuid.v4)();
+            operationId = opIdPrefix + uuid();
             operationIdPath = path ? "".concat(path, ".operationId") : 'operationId';
             globalState.set(operationIdPath, operationId);
             _context.next = 7;
@@ -135,10 +120,10 @@ function _load() {
             state = globalState.get(path);
 
             if (operationId === state.operationId) {
-              if (process.env.NODE_ENV !== 'production' && (0, _utils.isDebugMode)()) {
+              if (process.env.NODE_ENV !== 'production' && isDebugMode()) {
                 /* eslint-disable no-console */
                 console.groupCollapsed("ReactGlobalState: useAsyncData data (re-)loaded. Path: \"".concat(path || '', "\""));
-                console.log('Data:', (0, _lodash.cloneDeep)(data));
+                console.log('Data:', cloneDeep(data));
                 /* eslint-enable no-console */
               }
 
@@ -148,7 +133,7 @@ function _load() {
                 timestamp: Date.now()
               }));
 
-              if (process.env.NODE_ENV !== 'production' && (0, _utils.isDebugMode)()) {
+              if (process.env.NODE_ENV !== 'production' && isDebugMode()) {
                 /* eslint-disable no-console */
                 console.groupEnd();
                 /* eslint-enable no-console */
@@ -165,7 +150,7 @@ function _load() {
   return _load.apply(this, arguments);
 }
 
-function useAsyncData(path, loader) {
+export default function useAsyncData(path, loader) {
   var options = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
   var garbageCollectAge = options.garbageCollectAge,
       maxage = options.maxage,
@@ -173,15 +158,15 @@ function useAsyncData(path, loader) {
   if (maxage === undefined) maxage = DEFAULT_MAXAGE;
   if (refreshAge === undefined) refreshAge = maxage;
   if (garbageCollectAge === undefined) garbageCollectAge = maxage;
-  var globalState = (0, _GlobalStateProvider.getGlobalState)();
+  var globalState = getGlobalState();
 
-  var _useGlobalState = (0, _useGlobalState3.default)(path, {
+  var _useGlobalState = useGlobalState(path, {
     data: null,
     numRefs: 0,
     operationId: '',
     timestamp: 0
   }),
-      _useGlobalState2 = (0, _slicedToArray2.default)(_useGlobalState, 1),
+      _useGlobalState2 = _slicedToArray(_useGlobalState, 1),
       localState = _useGlobalState2[0];
 
   if (globalState.ssrContext && !options.noSSR) {
@@ -200,7 +185,7 @@ function useAsyncData(path, loader) {
     //
     // TODO: Though, maybe there is a way to refactor it into a cleaner code.
     // The same applies to other useEffect() hooks below.
-    (0, _react.useEffect)(function () {
+    useEffect(function () {
       // eslint-disable-line react-hooks/rules-of-hooks
       var numRefsPath = path ? "".concat(path, ".numRefs") : 'numRefs';
       var numRefs = globalState.get(numRefsPath);
@@ -209,7 +194,7 @@ function useAsyncData(path, loader) {
         var state = globalState.get(path);
 
         if (state.numRefs === 1 && garbageCollectAge < Date.now() - state.timestamp) {
-          if (process.env.NODE_ENV !== 'production' && (0, _utils.isDebugMode)()) {
+          if (process.env.NODE_ENV !== 'production' && isDebugMode()) {
             /* eslint-disable no-console */
             console.log("ReactGlobalState - useAsyncData garbage collected at path ".concat(path || ''));
             /* eslint-enable no-console */
@@ -227,7 +212,7 @@ function useAsyncData(path, loader) {
     // Data loading and refreshing.
 
     var loadTriggered = false;
-    (0, _react.useEffect)(function () {
+    useEffect(function () {
       // eslint-disable-line react-hooks/rules-of-hooks
       var state = globalState.get(path);
 
@@ -237,7 +222,7 @@ function useAsyncData(path, loader) {
       }
     });
     var deps = options.deps || [];
-    (0, _react.useEffect)(function () {
+    useEffect(function () {
       // eslint-disable-line react-hooks/rules-of-hooks
       if (!loadTriggered && deps.length) load(path, loader, globalState);
     }, deps); // eslint-disable-line react-hooks/exhaustive-deps

package/build/module/useAsyncData.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/useAsyncData.js"],"names":["cloneDeep","useEffect","v4","uuid","getGlobalState","useGlobalState","isDebugMode","DEFAULT_MAXAGE","load","path","loader","globalState","oldData","opIdPrefix","process","env","NODE_ENV","console","log","operationId","operationIdPath","set","get","data","state","groupCollapsed","timestamp","Date","now","groupEnd","useAsyncData","options","garbageCollectAge","maxage","refreshAge","undefined","numRefs","localState","ssrContext","noSSR","pending","push","numRefsPath","loadTriggered","charAt","deps","length","loading","Boolean"],"mappings":"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","sourcesContent":["/**\n * Loads and uses async data into the GlobalState path.\n */\n\nimport { cloneDeep } from 'lodash';\nimport { useEffect } from 'react';\nimport { v4 as uuid } from 'uuid';\n\nimport { getGlobalState } from './GlobalStateProvider';\nimport useGlobalState from './useGlobalState';\nimport { isDebugMode } from './utils';\n\nconst DEFAULT_MAXAGE = 5 * 60 * 1000; // 5 minutes.\n\n/**\n * Executes the data loading operation.\n * @param {string} path Data segment path inside the global state.\n * @param {function} loader Data loader.\n * @param {GlobalState} globalState The global state instance.\n * @param {any} [oldData] Optional. Previously fetched data, currently stored in\n *  the state, if already fetched by the caller; otherwise, they will be fetched\n *  by the load() function itself.\n * @param {string} [opIdPrefix='C'] operationId prefix to use, which should be\n * 'C' at the client-side (default), or 'S' at the server-side (within SSR\n * context).\n * @return {Promise} Resolves once the operation is done.\n * @ignore\n */\nasync function load(path, loader, globalState, oldData, opIdPrefix = 'C') {\n  if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n    /* eslint-disable no-console */\n    console.log(\n      `ReactGlobalState: useAsyncData data (re-)loading. Path: \"${path || ''}\"`,\n    );\n    /* eslint-enable no-console */\n  }\n  const operationId = opIdPrefix + uuid();\n  const operationIdPath = path ? `${path}.operationId` : 'operationId';\n  globalState.set(operationIdPath, operationId);\n  const data = await loader(oldData || globalState.get(path).data);\n  const state = globalState.get(path);\n  if (operationId === state.operationId) {\n    if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n      /* eslint-disable no-console */\n      console.groupCollapsed(\n        `ReactGlobalState: useAsyncData data (re-)loaded. Path: \"${\n          path || ''\n        }\"`,\n      );\n      console.log('Data:', cloneDeep(data));\n      /* eslint-enable no-console */\n    }\n    globalState.set(path, {\n      ...state,\n      data,\n      operationId: '',\n      timestamp: Date.now(),\n    });\n    if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n      /* eslint-disable no-console */\n      console.groupEnd();\n      /* eslint-enable no-console */\n    }\n  }\n}\n\n/**\n * Resolves asynchronous data, and stores them at given `path` of global\n * state. When multiple components rely on asynchronous data at the same `path`,\n * the data are resolved once, and reused until their age is within specified\n * bounds. Once the data are stale, the hook allows to refresh them. It also\n * garbage-collects stale data from the global state when the last component\n * relying on them is unmounted.\n * @param {string} path Dot-delimitered state path, where data envelop is\n * stored.\n * @param {AsyncDataLoader} loader Asynchronous function which resolves (loads)\n * data, which should be stored at the global state `path`. When multiple\n * components\n * use `useAsyncData()` hook for the same `path`, the library assumes that all\n * hook instances are called with the same `loader` (_i.e._ whichever of these\n * loaders is used to resolve async data, the result is acceptable to be reused\n * in all related components).\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 useAsyncData(\n  path,\n  loader,\n  options = {},\n) {\n  let { garbageCollectAge, maxage, refreshAge } = options;\n  if (maxage === undefined) maxage = DEFAULT_MAXAGE;\n  if (refreshAge === undefined) refreshAge = maxage;\n  if (garbageCollectAge === undefined) garbageCollectAge = maxage;\n\n  const globalState = getGlobalState();\n  const [localState] = useGlobalState(path, {\n    data: null,\n    numRefs: 0,\n    operationId: '',\n    timestamp: 0,\n  });\n\n  if (globalState.ssrContext && !options.noSSR) {\n    const state = globalState.get(path);\n    if (!state.timestamp && !state.operationId) {\n      globalState.ssrContext.pending.push(\n        load(path, loader, globalState, state.data, 'S'),\n      );\n    }\n  } else {\n    // This takes care about the client-side reference counting, and garbage\n    // collection.\n    //\n    // Note: the Rules of Hook below are violated by conditional call to a hook,\n    // but as the condition is actually server-side or client-side environment,\n    // it is effectively non-conditional at the runtime.\n    //\n    // TODO: Though, maybe there is a way to refactor it into a cleaner code.\n    // The same applies to other useEffect() hooks below.\n    useEffect(() => { // eslint-disable-line react-hooks/rules-of-hooks\n      const numRefsPath = path ? `${path}.numRefs` : 'numRefs';\n      const numRefs = globalState.get(numRefsPath);\n      globalState.set(numRefsPath, numRefs + 1);\n      return () => {\n        const state = globalState.get(path);\n        if (\n          state.numRefs === 1\n          && garbageCollectAge < Date.now() - state.timestamp\n        ) {\n          if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n            /* eslint-disable no-console */\n            console.log(\n              `ReactGlobalState - useAsyncData garbage collected at path ${\n                path || ''\n              }`,\n            );\n            /* eslint-enable no-console */\n          }\n          globalState.set(path, {\n            ...state,\n            data: null,\n            numRefs: 0,\n            timestamp: 0,\n          });\n        } else globalState.set(numRefsPath, state.numRefs - 1);\n      };\n    }, [garbageCollectAge, globalState, path]);\n\n    // Note: a bunch of Rules of Hooks ignored belows because in our very\n    // special case the otherwise wrong behavior is actually what we need.\n\n    // Data loading and refreshing.\n    let loadTriggered = false;\n    useEffect(() => { // eslint-disable-line react-hooks/rules-of-hooks\n      const state = globalState.get(path);\n      if (refreshAge < Date.now() - state.timestamp\n      && (!state.operationId || state.operationId.charAt() === 'S')) {\n        load(path, loader, globalState, state.data);\n        loadTriggered = true; // eslint-disable-line react-hooks/exhaustive-deps\n      }\n    });\n\n    const deps = options.deps || [];\n    useEffect(() => { // eslint-disable-line react-hooks/rules-of-hooks\n      if (!loadTriggered && deps.length) load(path, loader, globalState);\n    }, deps); // eslint-disable-line react-hooks/exhaustive-deps\n  }\n\n  return {\n    data: maxage < Date.now() - localState.timestamp ? null : localState.data,\n    loading: Boolean(localState.operationId),\n    timestamp: localState.timestamp,\n  };\n}\n"],"file":"useAsyncData.js"}

package/build/{web → module}/useGlobalState.js

@@ -1,24 +1,9 @@
-"use strict";
-
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = useGlobalState;
-
-var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
-
-var _lodash = require("lodash");
-
-var _react = require("react");
-
-var _GlobalStateProvider = require("./GlobalStateProvider");
-
-var _utils = require("./utils");
-
+import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
 // Hook for updates of global state.
-
+import { cloneDeep, isFunction, isUndefined } from 'lodash';
+import { useEffect, useRef, useState } from 'react';
+import { getGlobalState } from "./GlobalStateProvider";
+import { isDebugMode } from "./utils";
 /**
  * The primary hook for interacting with the global state, modeled after
  * the standard React's
@@ -69,23 +54,24 @@ var _utils = require("./utils");
  *   Also, similar to the standard React's state setters, `setValue()` is
  *   stable function: it does not change between component re-renders.
  */
-function useGlobalState(path, initialValue) {
-  var globalState = (0, _GlobalStateProvider.getGlobalState)();
+
+export default function useGlobalState(path, initialValue) {
+  var globalState = getGlobalState();
   var state = globalState.get(path);
 
-  if ((0, _lodash.isUndefined)(state) && !(0, _lodash.isUndefined)(initialValue)) {
-    var value = (0, _lodash.isFunction)(initialValue) ? initialValue() : initialValue;
+  if (isUndefined(state) && !isUndefined(initialValue)) {
+    var value = isFunction(initialValue) ? initialValue() : initialValue;
     state = globalState.set(path, value);
   }
 
-  var _useState = (0, _react.useState)(function () {
+  var _useState = useState(function () {
     return state;
   }),
-      _useState2 = (0, _slicedToArray2.default)(_useState, 2),
+      _useState2 = _slicedToArray(_useState, 2),
       localState = _useState2[0],
       setLocalState = _useState2[1];
 
-  (0, _react.useEffect)(function () {
+  useEffect(function () {
     // Note: the "callback.active" flag below is needed to workaround the issue
     // https://github.com/birdofpreyru/react-global-state/issues/33,
     // which, unfortunately, I am not able to reproduce in test environment,
@@ -107,19 +93,19 @@ function useGlobalState(path, initialValue) {
       globalState.unWatch(callback);
     };
   }, [globalState, localState, path]);
-  var ref = (0, _react.useRef)();
+  var ref = useRef();
 
   if (!ref.current) {
     ref.current = {
       localState: localState,
       path: path,
       setter: function setter(value) {
-        var newValue = (0, _lodash.isFunction)(value) ? value(ref.current.localState) : value;
+        var newValue = isFunction(value) ? value(ref.current.localState) : value;
 
-        if (process.env.NODE_ENV !== 'production' && (0, _utils.isDebugMode)()) {
+        if (process.env.NODE_ENV !== 'production' && isDebugMode()) {
           /* eslint-disable no-console */
           console.groupCollapsed("ReactGlobalState - useGlobalState setter triggered for path ".concat(ref.current.path || ''));
-          console.log('New value:', (0, _lodash.cloneDeep)(newValue));
+          console.log('New value:', cloneDeep(newValue));
           console.groupEnd();
           /* eslint-enable no-console */
         }

package/build/module/useGlobalState.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/useGlobalState.js"],"names":["cloneDeep","isFunction","isUndefined","useEffect","useRef","useState","getGlobalState","isDebugMode","useGlobalState","path","initialValue","globalState","state","get","value","set","localState","setLocalState","callback","active","newState","watch","unWatch","ref","current","setter","newValue","process","env","NODE_ENV","console","groupCollapsed","log","groupEnd"],"mappings":"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","sourcesContent":["// Hook for updates of global state.\n\nimport { cloneDeep, isFunction, isUndefined } from 'lodash';\nimport { useEffect, useRef, useState } from 'react';\n\nimport { getGlobalState } from './GlobalStateProvider';\nimport { isDebugMode } from './utils';\n\n/**\n * The primary hook for interacting with the global state, modeled after\n * the standard React's\n * [useState](https://reactjs.org/docs/hooks-reference.html#usestate).\n * It subscribes a component to a given `path` of global state, and provides\n * a function to update it. Each time the value at `path` changes, the hook\n * triggers re-render of its host component.\n *\n * **Note:**\n * - For performance, the library does not copy objects written to / read from\n *   global state paths. You MUST NOT manually mutate returned state values,\n *   or change objects already written into the global state, without explicitly\n *   clonning them first yourself.\n * - State update notifications are asynchronous. When your code does multiple\n *   global state updates in the same React rendering cycle, all state update\n *   notifications are queued and dispatched together, after the current\n *   rendering cycle. In other words, in any given rendering cycle the global\n *   state values are \"fixed\", and all changes becomes visible at once in the\n *   next triggered rendering pass.\n *\n * @param {string} [path] Dot-delimitered state path. It can be undefined to\n * subscribe for entire state.\n *\n * Under-the-hood state values are read and written using `lodash`\n * [_.get()](https://lodash.com/docs/4.17.15#get) and\n * [_.set()](https://lodash.com/docs/4.17.15#set) methods, thus it is safe\n * to access state paths which have not been created before.\n * @param {any} [initialValue] Initial value to set at the `path`, or its\n * factory:\n * - If a function is given, it will act similar to\n *   [the lazy initial state of the standard React's useState()](https://reactjs.org/docs/hooks-reference.html#lazy-initial-state):\n *   only if the value at `path` is `undefined`, the function will be executed,\n *   and the value it returns will be written to the `path`.\n * - Otherwise, the given value itself will be written to the `path`,\n *   if the current value at `path` is `undefined`.\n * @return {Array} It returs an array with two elements: `[value, setValue]`:\n *\n * - The `value` is the current value at given `path`.\n *\n * - The `setValue()` is setter function to write a new value to the `path`.\n *\n *   Similar to the standard React's `useState()`, it supports\n *   [functional value updates](https://reactjs.org/docs/hooks-reference.html#functional-updates):\n *   if `setValue()` is called with a function as argument, that function will\n *   be called and its return value will be written to `path`. Otherwise,\n *   the argument of `setValue()` itself is written to `path`.\n *\n *   Also, similar to the standard React's state setters, `setValue()` is\n *   stable function: it does not change between component re-renders.\n */\nexport default function useGlobalState(path, initialValue) {\n  const globalState = getGlobalState();\n  let state = globalState.get(path);\n  if (isUndefined(state) && !isUndefined(initialValue)) {\n    const value = isFunction(initialValue) ? initialValue() : initialValue;\n    state = globalState.set(path, value);\n  }\n  const [\n    localState,\n    setLocalState,\n  ] = useState(() => state);\n\n  useEffect(() => {\n    // Note: the \"callback.active\" flag below is needed to workaround the issue\n    // https://github.com/birdofpreyru/react-global-state/issues/33,\n    // which, unfortunately, I am not able to reproduce in test environment,\n    // but I definitely seen it in the wild.\n    const callback = () => {\n      if (callback.active) {\n        const newState = globalState.get(path);\n        if (newState !== localState) setLocalState(() => newState);\n      }\n    };\n    callback.active = true;\n    globalState.watch(callback);\n    callback();\n    return () => {\n      delete callback.active;\n      globalState.unWatch(callback);\n    };\n  }, [globalState, localState, path]);\n\n  const ref = useRef();\n  if (!ref.current) {\n    ref.current = {\n      localState,\n      path,\n      setter: (value) => {\n        const newValue = isFunction(value)\n          ? value(ref.current.localState) : value;\n        if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n          /* eslint-disable no-console */\n          console.groupCollapsed(\n            `ReactGlobalState - useGlobalState setter triggered for path ${\n              ref.current.path || ''\n            }`,\n          );\n          console.log('New value:', cloneDeep(newValue));\n          console.groupEnd();\n          /* eslint-enable no-console */\n        }\n\n        globalState.set(ref.current.path, newValue);\n\n        // The update of local state here is important for managed inputs:\n        // if we wait until the global state change notification is delivered\n        // (which happens after the next React render), React won't conserve\n        // the text cursor inside the currently focused input field (the cursor\n        // will jump to the field end, like if the value was changed not by\n        // keyboard input).\n        setLocalState(() => newValue);\n      },\n    };\n  } else {\n    ref.current.localState = localState;\n    ref.current.path = path;\n  }\n\n  return [\n    localState,\n    ref.current.setter,\n  ];\n}\n"],"file":"useGlobalState.js"}

package/build/{web → module}/utils.js

@@ -1,11 +1,3 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = void 0;
-exports.isDebugMode = isDebugMode;
-
 // Auxiliary stuff.
 
 /**
@@ -20,14 +12,12 @@ exports.isDebugMode = isDebugMode;
  * @returns {boolean}
  * @ignore
  */
-function isDebugMode() {
+export function isDebugMode() {
   try {
     return process.env.NODE_ENV !== 'production' && !!process.env.REACT_GLOBAL_STATE_DEBUG;
   } catch (error) {
     return false;
   }
 }
-
-var _default = null;
-exports.default = _default;
+export default null;
 //# sourceMappingURL=utils.js.map

package/build/module/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils.js"],"names":["isDebugMode","process","env","NODE_ENV","REACT_GLOBAL_STATE_DEBUG","error"],"mappings":"AAAA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASA,WAAT,GAAuB;AAC5B,MAAI;AACF,WAAOC,OAAO,CAACC,GAAR,CAAYC,QAAZ,KAAyB,YAAzB,IACF,CAAC,CAACF,OAAO,CAACC,GAAR,CAAYE,wBADnB;AAED,GAHD,CAGE,OAAOC,KAAP,EAAc;AACd,WAAO,KAAP;AACD;AACF;AAED,eAAe,IAAf","sourcesContent":["// Auxiliary stuff.\n\n/**\n * Returns 'true' if debug logging should be performed; 'false' otherwise.\n *\n * BEWARE: The actual safeguards for the debug logging still should read\n *  if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n *    // Some debug logging\n *  }\n * to ensure that debug code is stripped out by Webpack in production mode.\n *\n * @returns {boolean}\n * @ignore\n */\nexport function isDebugMode() {\n  try {\n    return process.env.NODE_ENV !== 'production'\n      && !!process.env.REACT_GLOBAL_STATE_DEBUG;\n  } catch (error) {\n    return false;\n  }\n}\n\nexport default null;\n"],"file":"utils.js"}

package/package.json

@@ -1,12 +1,16 @@
 {
   "name": "@dr.pogodin/react-global-state",
-  "version": "0.6.4",
+  "version": "0.7.0",
   "description": "Hook-based global state for React",
-  "main": "index.js",
+  "exports": {
+    "module": "./build/module/index.js",
+    "node": "./build/node/index.js",
+    "types": "./index.d.ts"
+  },
   "scripts": {
-    "build": "rimraf build && npm run build:node && npm run build:web",
+    "build": "rimraf build && npm run build:module && npm run build:node",
+    "build:module": "rimraf build/web && babel src --out-dir build/module --source-maps --config-file ./babel.module.config.js",
     "build:node": "rimraf build/node && babel src --out-dir build/node --source-maps",
-    "build:web": "rimraf build/web && babel src --out-dir build/web --source-maps --config-file ./babel.web.config.js",
     "jest": "jest --config jest/config.json",
     "lint": "eslint --ext .js,.jsx .",
     "test": "npm run lint && npm run jest"
@@ -27,32 +31,32 @@
   "bugs": {
     "url": "https://github.com/birdofpreyru/react-global-state.git/issues"
   },
-  "homepage": "https://dr.pogodin.studio/dev-blog/the-global-state-in-react-designed-right",
+  "homepage": "https://dr.pogodin.studio/docs/react-global-state/index.html",
   "dependencies": {
-    "@babel/runtime": "^7.15.4",
+    "@babel/runtime": "^7.17.2",
     "lodash": "^4.17.21",
     "uuid": "^8.3.2"
   },
   "devDependencies": {
-    "@babel/cli": "^7.15.7",
-    "@babel/core": "^7.15.8",
-    "@babel/node": "^7.15.8",
-    "@babel/plugin-transform-runtime": "^7.15.8",
-    "@babel/preset-env": "^7.15.8",
-    "@babel/preset-react": "^7.14.5",
-    "babel-eslint": "^10.1.0",
-    "babel-jest": "^27.3.1",
+    "@babel/cli": "^7.17.6",
+    "@babel/core": "^7.17.5",
+    "@babel/eslint-parser": "^7.17.0",
+    "@babel/eslint-plugin": "^7.16.5",
+    "@babel/node": "^7.16.8",
+    "@babel/plugin-transform-runtime": "^7.17.0",
+    "@babel/preset-env": "^7.16.11",
+    "@babel/preset-react": "^7.16.7",
+    "babel-jest": "^27.5.1",
     "babel-plugin-module-resolver": "^4.1.0",
-    "eslint": "^7.32.0",
-    "eslint-config-airbnb": "^18.2.1",
+    "eslint": "^8.10.0",
+    "eslint-config-airbnb": "^19.0.4",
     "eslint-import-resolver-babel-module": "^5.3.1",
-    "eslint-plugin-import": "^2.25.2",
-    "eslint-plugin-jest": "^25.2.2",
-    "eslint-plugin-jsx-a11y": "^6.4.1",
-    "eslint-plugin-react": "^7.26.1",
-    "eslint-plugin-react-hooks": "^4.2.0",
-    "jest": "^27.3.1",
-    "jsdoc": "^3.6.7",
+    "eslint-plugin-import": "^2.25.4",
+    "eslint-plugin-jest": "^26.1.1",
+    "eslint-plugin-jsx-a11y": "^6.5.1",
+    "eslint-plugin-react": "^7.29.3",
+    "eslint-plugin-react-hooks": "^4.3.0",
+    "jest": "^27.5.1",
     "mockdate": "^3.0.5",
     "pretty": "^2.0.0",
     "react": "^17.0.2",

package/build/web/GlobalState.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/GlobalState.js"],"names":["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"}

package/build/web/GlobalStateProvider.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/GlobalStateProvider.jsx"],"names":["context","getGlobalState","globalState","Error","getSsrContext","throwWithoutSsrContext","ssrContext","GlobalStateProvider","children","initialState","stateProxy","state","GlobalState"],"mappings":";;;;;;;;;;;;;AAEA;;AAEA;;;;AAJA;AAMA,IAAMA,OAAO,gBAAG,2BAAhB;AAEA;AACA;AACA;AACA;AACA;AACA;;AACO,SAASC,cAAT,GAA0B;AAC/B;AACA;AACA;AACA;AACA;;AACA;AACA,MAAMC,WAAW,GAAG,uBAAWF,OAAX,CAApB;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;;;AACO,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;;;AACe,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,YAAYE,oBAA1B,EAAuCD,KAAK,GAAGD,UAAR,CAAvC,KACK,IAAIA,UAAJ,EAAgBC,KAAK,GAAGV,cAAc,EAAtB,CAAhB;AAAA,oBACU,qBAAS,IAAIW,oBAAJ,CAAgBH,YAAhB,EAA8BH,UAA9B,CAAT,CADV;;AAAA;;AACCK,IAAAA,KADD;AAAA;AAEL;;AACA,sBACE,qBAAC,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"}

package/build/web/index.js

@@ -1,72 +0,0 @@
-"use strict";
-
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
-
-var _typeof = require("@babel/runtime/helpers/typeof");
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-Object.defineProperty(exports, "GlobalStateProvider", {
-  enumerable: true,
-  get: function get() {
-    return _GlobalStateProvider.default;
-  }
-});
-Object.defineProperty(exports, "getGlobalState", {
-  enumerable: true,
-  get: function get() {
-    return _GlobalStateProvider.getGlobalState;
-  }
-});
-Object.defineProperty(exports, "getSsrContext", {
-  enumerable: true,
-  get: function get() {
-    return _GlobalStateProvider.getSsrContext;
-  }
-});
-Object.defineProperty(exports, "useAsyncCollection", {
-  enumerable: true,
-  get: function get() {
-    return _useAsyncCollection.default;
-  }
-});
-Object.defineProperty(exports, "useAsyncData", {
-  enumerable: true,
-  get: function get() {
-    return _useAsyncData.default;
-  }
-});
-Object.defineProperty(exports, "useGlobalState", {
-  enumerable: true,
-  get: function get() {
-    return _useGlobalState.default;
-  }
-});
-
-var _GlobalStateProvider = _interopRequireWildcard(require("./GlobalStateProvider"));
-
-var _useAsyncCollection = _interopRequireDefault(require("./useAsyncCollection"));
-
-var _useAsyncData = _interopRequireDefault(require("./useAsyncData"));
-
-var _useGlobalState = _interopRequireDefault(require("./useGlobalState"));
-
-function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
-
-function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
-
-// TODO: This is a temporary polyfill for `Promise.allSettled(..)` method,
-// which is supported natively by NodeJS >= v12.9.0. As earlier NodeJS version
-// 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;
-    }));
-  };
-}
-//# sourceMappingURL=index.js.map

package/build/web/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/index.js"],"names":["Promise","allSettled","promises","all","map","p","finally"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAUA;;AAMA;;AACA;;AACA;;;;;;AAlBA;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","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"}

package/build/web/useAsyncCollection.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/useAsyncCollection.js"],"names":["useAsyncCollection","id","path","loader","options","itemPath","oldData"],"mappings":";;;;;;;;;AAIA;;AAJA;AACA;AACA;;AAIA;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;AACe,SAASA,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,SAAO,2BAAaI,QAAb,EAAuB,UAACC,OAAD;AAAA,WAAaH,MAAM,CAACF,EAAD,EAAKK,OAAL,CAAnB;AAAA,GAAvB,EAAyDF,OAAzD,CAAP;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"}

package/build/web/useAsyncData.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/useAsyncData.js"],"names":["DEFAULT_MAXAGE","load","path","loader","globalState","oldData","opIdPrefix","process","env","NODE_ENV","console","log","operationId","operationIdPath","set","get","data","state","groupCollapsed","timestamp","Date","now","groupEnd","useAsyncData","options","garbageCollectAge","maxage","refreshAge","undefined","numRefs","localState","ssrContext","noSSR","pending","push","numRefsPath","loadTriggered","charAt","deps","length","loading","Boolean"],"mappings":";;;;;;;;;;;;;;;;;AAIA;;AACA;;AACA;;AAEA;;AACA;;AACA;;;;;;AAEA,IAAMA,cAAc,GAAG,IAAI,EAAJ,GAAS,IAAhC,C,CAAsC;;AAEtC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;SACeC,I;;;AAsCf;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;AACA;AACA;AACA;AACA;;;;kFAxFA,iBAAoBC,IAApB,EAA0BC,MAA1B,EAAkCC,WAAlC,EAA+CC,OAA/C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAwDC,YAAAA,UAAxD,2DAAqE,GAArE;;AACE,gBAAIC,OAAO,CAACC,GAAR,CAAYC,QAAZ,KAAyB,YAAzB,IAAyC,yBAA7C,EAA4D;AAC1D;AACAC,cAAAA,OAAO,CAACC,GAAR,qEAC8DT,IAAI,IAAI,EADtE;AAGA;AACD;;AACKU,YAAAA,WARR,GAQsBN,UAAU,GAAG,eARnC;AASQO,YAAAA,eATR,GAS0BX,IAAI,aAAMA,IAAN,oBAA2B,aATzD;AAUEE,YAAAA,WAAW,CAACU,GAAZ,CAAgBD,eAAhB,EAAiCD,WAAjC;AAVF;AAAA,mBAWqBT,MAAM,CAACE,OAAO,IAAID,WAAW,CAACW,GAAZ,CAAgBb,IAAhB,EAAsBc,IAAlC,CAX3B;;AAAA;AAWQA,YAAAA,IAXR;AAYQC,YAAAA,KAZR,GAYgBb,WAAW,CAACW,GAAZ,CAAgBb,IAAhB,CAZhB;;AAaE,gBAAIU,WAAW,KAAKK,KAAK,CAACL,WAA1B,EAAuC;AACrC,kBAAIL,OAAO,CAACC,GAAR,CAAYC,QAAZ,KAAyB,YAAzB,IAAyC,yBAA7C,EAA4D;AAC1D;AACAC,gBAAAA,OAAO,CAACQ,cAAR,oEAEIhB,IAAI,IAAI,EAFZ;AAKAQ,gBAAAA,OAAO,CAACC,GAAR,CAAY,OAAZ,EAAqB,uBAAUK,IAAV,CAArB;AACA;AACD;;AACDZ,cAAAA,WAAW,CAACU,GAAZ,CAAgBZ,IAAhB,kCACKe,KADL;AAEED,gBAAAA,IAAI,EAAJA,IAFF;AAGEJ,gBAAAA,WAAW,EAAE,EAHf;AAIEO,gBAAAA,SAAS,EAAEC,IAAI,CAACC,GAAL;AAJb;;AAMA,kBAAId,OAAO,CAACC,GAAR,CAAYC,QAAZ,KAAyB,YAAzB,IAAyC,yBAA7C,EAA4D;AAC1D;AACAC,gBAAAA,OAAO,CAACY,QAAR;AACA;AACD;AACF;;AAnCH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,G;;;;AAyFe,SAASC,YAAT,CACbrB,IADa,EAEbC,MAFa,EAIb;AAAA,MADAqB,OACA,uEADU,EACV;AACA,MAAMC,iBAAN,GAAgDD,OAAhD,CAAMC,iBAAN;AAAA,MAAyBC,MAAzB,GAAgDF,OAAhD,CAAyBE,MAAzB;AAAA,MAAiCC,UAAjC,GAAgDH,OAAhD,CAAiCG,UAAjC;AACA,MAAID,MAAM,KAAKE,SAAf,EAA0BF,MAAM,GAAG1B,cAAT;AAC1B,MAAI2B,UAAU,KAAKC,SAAnB,EAA8BD,UAAU,GAAGD,MAAb;AAC9B,MAAID,iBAAiB,KAAKG,SAA1B,EAAqCH,iBAAiB,GAAGC,MAApB;AAErC,MAAMtB,WAAW,GAAG,0CAApB;;AACA,wBAAqB,8BAAeF,IAAf,EAAqB;AACxCc,IAAAA,IAAI,EAAE,IADkC;AAExCa,IAAAA,OAAO,EAAE,CAF+B;AAGxCjB,IAAAA,WAAW,EAAE,EAH2B;AAIxCO,IAAAA,SAAS,EAAE;AAJ6B,GAArB,CAArB;AAAA;AAAA,MAAOW,UAAP;;AAOA,MAAI1B,WAAW,CAAC2B,UAAZ,IAA0B,CAACP,OAAO,CAACQ,KAAvC,EAA8C;AAC5C,QAAMf,KAAK,GAAGb,WAAW,CAACW,GAAZ,CAAgBb,IAAhB,CAAd;;AACA,QAAI,CAACe,KAAK,CAACE,SAAP,IAAoB,CAACF,KAAK,CAACL,WAA/B,EAA4C;AAC1CR,MAAAA,WAAW,CAAC2B,UAAZ,CAAuBE,OAAvB,CAA+BC,IAA/B,CACEjC,IAAI,CAACC,IAAD,EAAOC,MAAP,EAAeC,WAAf,EAA4Ba,KAAK,CAACD,IAAlC,EAAwC,GAAxC,CADN;AAGD;AACF,GAPD,MAOO;AACL;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,0BAAU,YAAM;AAAE;AAChB,UAAMmB,WAAW,GAAGjC,IAAI,aAAMA,IAAN,gBAAuB,SAA/C;AACA,UAAM2B,OAAO,GAAGzB,WAAW,CAACW,GAAZ,CAAgBoB,WAAhB,CAAhB;AACA/B,MAAAA,WAAW,CAACU,GAAZ,CAAgBqB,WAAhB,EAA6BN,OAAO,GAAG,CAAvC;AACA,aAAO,YAAM;AACX,YAAMZ,KAAK,GAAGb,WAAW,CAACW,GAAZ,CAAgBb,IAAhB,CAAd;;AACA,YACEe,KAAK,CAACY,OAAN,KAAkB,CAAlB,IACGJ,iBAAiB,GAAGL,IAAI,CAACC,GAAL,KAAaJ,KAAK,CAACE,SAF5C,EAGE;AACA,cAAIZ,OAAO,CAACC,GAAR,CAAYC,QAAZ,KAAyB,YAAzB,IAAyC,yBAA7C,EAA4D;AAC1D;AACAC,YAAAA,OAAO,CAACC,GAAR,qEAEIT,IAAI,IAAI,EAFZ;AAKA;AACD;;AACDE,UAAAA,WAAW,CAACU,GAAZ,CAAgBZ,IAAhB,kCACKe,KADL;AAEED,YAAAA,IAAI,EAAE,IAFR;AAGEa,YAAAA,OAAO,EAAE,CAHX;AAIEV,YAAAA,SAAS,EAAE;AAJb;AAMD,SAnBD,MAmBOf,WAAW,CAACU,GAAZ,CAAgBqB,WAAhB,EAA6BlB,KAAK,CAACY,OAAN,GAAgB,CAA7C;AACR,OAtBD;AAuBD,KA3BD,EA2BG,CAACJ,iBAAD,EAAoBrB,WAApB,EAAiCF,IAAjC,CA3BH,EAVK,CAuCL;AACA;AAEA;;AACA,QAAIkC,aAAa,GAAG,KAApB;AACA,0BAAU,YAAM;AAAE;AAChB,UAAMnB,KAAK,GAAGb,WAAW,CAACW,GAAZ,CAAgBb,IAAhB,CAAd;;AACA,UAAIyB,UAAU,GAAGP,IAAI,CAACC,GAAL,KAAaJ,KAAK,CAACE,SAAhC,KACA,CAACF,KAAK,CAACL,WAAP,IAAsBK,KAAK,CAACL,WAAN,CAAkByB,MAAlB,OAA+B,GADrD,CAAJ,EAC+D;AAC7DpC,QAAAA,IAAI,CAACC,IAAD,EAAOC,MAAP,EAAeC,WAAf,EAA4Ba,KAAK,CAACD,IAAlC,CAAJ;AACAoB,QAAAA,aAAa,GAAG,IAAhB,CAF6D,CAEvC;AACvB;AACF,KAPD;AASA,QAAME,IAAI,GAAGd,OAAO,CAACc,IAAR,IAAgB,EAA7B;AACA,0BAAU,YAAM;AAAE;AAChB,UAAI,CAACF,aAAD,IAAkBE,IAAI,CAACC,MAA3B,EAAmCtC,IAAI,CAACC,IAAD,EAAOC,MAAP,EAAeC,WAAf,CAAJ;AACpC,KAFD,EAEGkC,IAFH,EAtDK,CAwDK;AACX;;AAED,SAAO;AACLtB,IAAAA,IAAI,EAAEU,MAAM,GAAGN,IAAI,CAACC,GAAL,KAAaS,UAAU,CAACX,SAAjC,GAA6C,IAA7C,GAAoDW,UAAU,CAACd,IADhE;AAELwB,IAAAA,OAAO,EAAEC,OAAO,CAACX,UAAU,CAAClB,WAAZ,CAFX;AAGLO,IAAAA,SAAS,EAAEW,UAAU,CAACX;AAHjB,GAAP;AAKD","sourcesContent":["/**\n * Loads and uses async data into the GlobalState path.\n */\n\nimport { cloneDeep } from 'lodash';\nimport { useEffect } from 'react';\nimport { v4 as uuid } from 'uuid';\n\nimport { getGlobalState } from './GlobalStateProvider';\nimport useGlobalState from './useGlobalState';\nimport { isDebugMode } from './utils';\n\nconst DEFAULT_MAXAGE = 5 * 60 * 1000; // 5 minutes.\n\n/**\n * Executes the data loading operation.\n * @param {string} path Data segment path inside the global state.\n * @param {function} loader Data loader.\n * @param {GlobalState} globalState The global state instance.\n * @param {any} [oldData] Optional. Previously fetched data, currently stored in\n *  the state, if already fetched by the caller; otherwise, they will be fetched\n *  by the load() function itself.\n * @param {string} [opIdPrefix='C'] operationId prefix to use, which should be\n * 'C' at the client-side (default), or 'S' at the server-side (within SSR\n * context).\n * @return {Promise} Resolves once the operation is done.\n * @ignore\n */\nasync function load(path, loader, globalState, oldData, opIdPrefix = 'C') {\n  if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n    /* eslint-disable no-console */\n    console.log(\n      `ReactGlobalState: useAsyncData data (re-)loading. Path: \"${path || ''}\"`,\n    );\n    /* eslint-enable no-console */\n  }\n  const operationId = opIdPrefix + uuid();\n  const operationIdPath = path ? `${path}.operationId` : 'operationId';\n  globalState.set(operationIdPath, operationId);\n  const data = await loader(oldData || globalState.get(path).data);\n  const state = globalState.get(path);\n  if (operationId === state.operationId) {\n    if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n      /* eslint-disable no-console */\n      console.groupCollapsed(\n        `ReactGlobalState: useAsyncData data (re-)loaded. Path: \"${\n          path || ''\n        }\"`,\n      );\n      console.log('Data:', cloneDeep(data));\n      /* eslint-enable no-console */\n    }\n    globalState.set(path, {\n      ...state,\n      data,\n      operationId: '',\n      timestamp: Date.now(),\n    });\n    if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n      /* eslint-disable no-console */\n      console.groupEnd();\n      /* eslint-enable no-console */\n    }\n  }\n}\n\n/**\n * Resolves asynchronous data, and stores them at given `path` of global\n * state. When multiple components rely on asynchronous data at the same `path`,\n * the data are resolved once, and reused until their age is within specified\n * bounds. Once the data are stale, the hook allows to refresh them. It also\n * garbage-collects stale data from the global state when the last component\n * relying on them is unmounted.\n * @param {string} path Dot-delimitered state path, where data envelop is\n * stored.\n * @param {AsyncDataLoader} loader Asynchronous function which resolves (loads)\n * data, which should be stored at the global state `path`. When multiple\n * components\n * use `useAsyncData()` hook for the same `path`, the library assumes that all\n * hook instances are called with the same `loader` (_i.e._ whichever of these\n * loaders is used to resolve async data, the result is acceptable to be reused\n * in all related components).\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 useAsyncData(\n  path,\n  loader,\n  options = {},\n) {\n  let { garbageCollectAge, maxage, refreshAge } = options;\n  if (maxage === undefined) maxage = DEFAULT_MAXAGE;\n  if (refreshAge === undefined) refreshAge = maxage;\n  if (garbageCollectAge === undefined) garbageCollectAge = maxage;\n\n  const globalState = getGlobalState();\n  const [localState] = useGlobalState(path, {\n    data: null,\n    numRefs: 0,\n    operationId: '',\n    timestamp: 0,\n  });\n\n  if (globalState.ssrContext && !options.noSSR) {\n    const state = globalState.get(path);\n    if (!state.timestamp && !state.operationId) {\n      globalState.ssrContext.pending.push(\n        load(path, loader, globalState, state.data, 'S'),\n      );\n    }\n  } else {\n    // This takes care about the client-side reference counting, and garbage\n    // collection.\n    //\n    // Note: the Rules of Hook below are violated by conditional call to a hook,\n    // but as the condition is actually server-side or client-side environment,\n    // it is effectively non-conditional at the runtime.\n    //\n    // TODO: Though, maybe there is a way to refactor it into a cleaner code.\n    // The same applies to other useEffect() hooks below.\n    useEffect(() => { // eslint-disable-line react-hooks/rules-of-hooks\n      const numRefsPath = path ? `${path}.numRefs` : 'numRefs';\n      const numRefs = globalState.get(numRefsPath);\n      globalState.set(numRefsPath, numRefs + 1);\n      return () => {\n        const state = globalState.get(path);\n        if (\n          state.numRefs === 1\n          && garbageCollectAge < Date.now() - state.timestamp\n        ) {\n          if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n            /* eslint-disable no-console */\n            console.log(\n              `ReactGlobalState - useAsyncData garbage collected at path ${\n                path || ''\n              }`,\n            );\n            /* eslint-enable no-console */\n          }\n          globalState.set(path, {\n            ...state,\n            data: null,\n            numRefs: 0,\n            timestamp: 0,\n          });\n        } else globalState.set(numRefsPath, state.numRefs - 1);\n      };\n    }, [garbageCollectAge, globalState, path]);\n\n    // Note: a bunch of Rules of Hooks ignored belows because in our very\n    // special case the otherwise wrong behavior is actually what we need.\n\n    // Data loading and refreshing.\n    let loadTriggered = false;\n    useEffect(() => { // eslint-disable-line react-hooks/rules-of-hooks\n      const state = globalState.get(path);\n      if (refreshAge < Date.now() - state.timestamp\n      && (!state.operationId || state.operationId.charAt() === 'S')) {\n        load(path, loader, globalState, state.data);\n        loadTriggered = true; // eslint-disable-line react-hooks/exhaustive-deps\n      }\n    });\n\n    const deps = options.deps || [];\n    useEffect(() => { // eslint-disable-line react-hooks/rules-of-hooks\n      if (!loadTriggered && deps.length) load(path, loader, globalState);\n    }, deps); // eslint-disable-line react-hooks/exhaustive-deps\n  }\n\n  return {\n    data: maxage < Date.now() - localState.timestamp ? null : localState.data,\n    loading: Boolean(localState.operationId),\n    timestamp: localState.timestamp,\n  };\n}\n"],"file":"useAsyncData.js"}

package/build/web/useGlobalState.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/useGlobalState.js"],"names":["useGlobalState","path","initialValue","globalState","state","get","value","set","localState","setLocalState","callback","active","newState","watch","unWatch","ref","current","setter","newValue","process","env","NODE_ENV","console","groupCollapsed","log","groupEnd"],"mappings":"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","sourcesContent":["// Hook for updates of global state.\n\nimport { cloneDeep, isFunction, isUndefined } from 'lodash';\nimport { useEffect, useRef, useState } from 'react';\n\nimport { getGlobalState } from './GlobalStateProvider';\nimport { isDebugMode } from './utils';\n\n/**\n * The primary hook for interacting with the global state, modeled after\n * the standard React's\n * [useState](https://reactjs.org/docs/hooks-reference.html#usestate).\n * It subscribes a component to a given `path` of global state, and provides\n * a function to update it. Each time the value at `path` changes, the hook\n * triggers re-render of its host component.\n *\n * **Note:**\n * - For performance, the library does not copy objects written to / read from\n *   global state paths. You MUST NOT manually mutate returned state values,\n *   or change objects already written into the global state, without explicitly\n *   clonning them first yourself.\n * - State update notifications are asynchronous. When your code does multiple\n *   global state updates in the same React rendering cycle, all state update\n *   notifications are queued and dispatched together, after the current\n *   rendering cycle. In other words, in any given rendering cycle the global\n *   state values are \"fixed\", and all changes becomes visible at once in the\n *   next triggered rendering pass.\n *\n * @param {string} [path] Dot-delimitered state path. It can be undefined to\n * subscribe for entire state.\n *\n * Under-the-hood state values are read and written using `lodash`\n * [_.get()](https://lodash.com/docs/4.17.15#get) and\n * [_.set()](https://lodash.com/docs/4.17.15#set) methods, thus it is safe\n * to access state paths which have not been created before.\n * @param {any} [initialValue] Initial value to set at the `path`, or its\n * factory:\n * - If a function is given, it will act similar to\n *   [the lazy initial state of the standard React's useState()](https://reactjs.org/docs/hooks-reference.html#lazy-initial-state):\n *   only if the value at `path` is `undefined`, the function will be executed,\n *   and the value it returns will be written to the `path`.\n * - Otherwise, the given value itself will be written to the `path`,\n *   if the current value at `path` is `undefined`.\n * @return {Array} It returs an array with two elements: `[value, setValue]`:\n *\n * - The `value` is the current value at given `path`.\n *\n * - The `setValue()` is setter function to write a new value to the `path`.\n *\n *   Similar to the standard React's `useState()`, it supports\n *   [functional value updates](https://reactjs.org/docs/hooks-reference.html#functional-updates):\n *   if `setValue()` is called with a function as argument, that function will\n *   be called and its return value will be written to `path`. Otherwise,\n *   the argument of `setValue()` itself is written to `path`.\n *\n *   Also, similar to the standard React's state setters, `setValue()` is\n *   stable function: it does not change between component re-renders.\n */\nexport default function useGlobalState(path, initialValue) {\n  const globalState = getGlobalState();\n  let state = globalState.get(path);\n  if (isUndefined(state) && !isUndefined(initialValue)) {\n    const value = isFunction(initialValue) ? initialValue() : initialValue;\n    state = globalState.set(path, value);\n  }\n  const [\n    localState,\n    setLocalState,\n  ] = useState(() => state);\n\n  useEffect(() => {\n    // Note: the \"callback.active\" flag below is needed to workaround the issue\n    // https://github.com/birdofpreyru/react-global-state/issues/33,\n    // which, unfortunately, I am not able to reproduce in test environment,\n    // but I definitely seen it in the wild.\n    const callback = () => {\n      if (callback.active) {\n        const newState = globalState.get(path);\n        if (newState !== localState) setLocalState(() => newState);\n      }\n    };\n    callback.active = true;\n    globalState.watch(callback);\n    callback();\n    return () => {\n      delete callback.active;\n      globalState.unWatch(callback);\n    };\n  }, [globalState, localState, path]);\n\n  const ref = useRef();\n  if (!ref.current) {\n    ref.current = {\n      localState,\n      path,\n      setter: (value) => {\n        const newValue = isFunction(value)\n          ? value(ref.current.localState) : value;\n        if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n          /* eslint-disable no-console */\n          console.groupCollapsed(\n            `ReactGlobalState - useGlobalState setter triggered for path ${\n              ref.current.path || ''\n            }`,\n          );\n          console.log('New value:', cloneDeep(newValue));\n          console.groupEnd();\n          /* eslint-enable no-console */\n        }\n\n        globalState.set(ref.current.path, newValue);\n\n        // The update of local state here is important for managed inputs:\n        // if we wait until the global state change notification is delivered\n        // (which happens after the next React render), React won't conserve\n        // the text cursor inside the currently focused input field (the cursor\n        // will jump to the field end, like if the value was changed not by\n        // keyboard input).\n        setLocalState(() => newValue);\n      },\n    };\n  } else {\n    ref.current.localState = localState;\n    ref.current.path = path;\n  }\n\n  return [\n    localState,\n    ref.current.setter,\n  ];\n}\n"],"file":"useGlobalState.js"}

package/build/web/utils.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/utils.js"],"names":["isDebugMode","process","env","NODE_ENV","REACT_GLOBAL_STATE_DEBUG","error"],"mappings":";;;;;;;;AAAA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASA,WAAT,GAAuB;AAC5B,MAAI;AACF,WAAOC,OAAO,CAACC,GAAR,CAAYC,QAAZ,KAAyB,YAAzB,IACF,CAAC,CAACF,OAAO,CAACC,GAAR,CAAYE,wBADnB;AAED,GAHD,CAGE,OAAOC,KAAP,EAAc;AACd,WAAO,KAAP;AACD;AACF;;eAEc,I","sourcesContent":["// Auxiliary stuff.\n\n/**\n * Returns 'true' if debug logging should be performed; 'false' otherwise.\n *\n * BEWARE: The actual safeguards for the debug logging still should read\n *  if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n *    // Some debug logging\n *  }\n * to ensure that debug code is stripped out by Webpack in production mode.\n *\n * @returns {boolean}\n * @ignore\n */\nexport function isDebugMode() {\n  try {\n    return process.env.NODE_ENV !== 'production'\n      && !!process.env.REACT_GLOBAL_STATE_DEBUG;\n  } catch (error) {\n    return false;\n  }\n}\n\nexport default null;\n"],"file":"utils.js"}

package/index.js

@@ -1,18 +0,0 @@
-/**
- * Exposes the build for NodeJS LTS for Node environment, and web build for
- * other environments.
- */
-
-/* eslint-disable global-require, no-eval */
-
-let lib;
-
-try {
-  lib = process.versions.node && eval('require')('./build/node');
-} catch (error) {
-  lib = undefined;
-}
-
-if (!lib) lib = require('./build/web');
-
-module.exports = lib;

package/node.js

@@ -1,5 +0,0 @@
-/**
- * Exposes the build for NodeJS LTS.
- */
-
-module.exports = require('./build/node');

package/web.js

@@ -1,5 +0,0 @@
-/**
- * Exposes web build (> 0.5%, last 2 versions, Firefox ESR, not dead).
- */
-
-module.exports = require('./build/web');