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

package/build/node/GlobalState.js

@@ -4,42 +4,33 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.default = void 0;
-
 var _lodash = require("lodash");
-
 var _utils = require("./utils");
-
 const ERR_NO_SSR_WATCH = 'GlobalState must not be watched at server side';
-/**
- * Transform state path into the full path inside GlobalState object.
- * @param {string} statePath
- * @return {string}
- * @ignore
- */
-
-function fullPath(statePath) {
-  return (0, _lodash.isNil)(statePath) ? 'state' : `state.${statePath}`;
-}
-
 class GlobalState {
+  #initialState;
+  #nextNotifierId = null;
+  #ssrContext;
+  #currentState;
+  #watchers = [];
+
   /**
    * Creates a new global state object.
    * @param {any} [initialState] Intial global state content.
    * @param {SsrContext} [ssrContext] Server-side rendering context.
    */
   constructor(initialState, ssrContext) {
-    /* eslint-disable no-param-reassign */
-    this.state = (0, _lodash.cloneDeep)(initialState);
-    this.nextNotifierId = null;
-    this.watchers = [];
-
+    this.#currentState = initialState;
+    this.#initialState = initialState;
     if (ssrContext) {
+      /* eslint-disable no-param-reassign */
       ssrContext.dirty = false;
       ssrContext.pending = [];
-      ssrContext.state = this.state;
-      this.ssrContext = ssrContext;
-    }
+      ssrContext.state = this.#currentState;
+      /* eslint-enable no-param-reassign */
 
+      this.#ssrContext = ssrContext;
+    }
     if (process.env.NODE_ENV !== 'production' && (0, _utils.isDebugMode)()) {
       /* eslint-disable no-console */
       let msg = 'New ReactGlobalState created';
@@ -49,21 +40,36 @@ class GlobalState {
       console.groupEnd();
       /* eslint-enable no-console */
     }
-    /* eslint-enable no-param-reassign */
-
   }
+
   /**
-   * Gets the value at given `path` of global state. If `path` is null or
-   * undefined, the entire state object is returned.
-   * @param {string} [path] Dot-delimitered state path. If not given, entire
-   * global state content is returned.
-   * @return {any}
+   * Gets current or initial value at the specified "path" of the global state.
+   * Allows to get the entire global state, and automatically set default value
+   * at the "path".
+   * @param {string} [path] Dot-delimitered state path. Pass it "null",
+   *  or "undefined" to refer the entire global state.
+   * @param {object} [options={}] Additional options.
+   * @param {boolean} [options.initialState] If "true" the value will be read
+   *  from the initial state instead of the current one.
+   * @param {any} [options.initialValue] If the value read from the "path" is
+   *  "undefined", this "initialValue" will be returned instead. In such case
+   *  "initialValue" will also be written to the "path" of the current global
+   *  state (no matter "initialState" flag), if "undefined" is stored there.
+   * @return {any} Retrieved value.
    */
-
-
-  get(path) {
-    return (0, _lodash.get)(this, fullPath(path));
+  get(path, {
+    initialState,
+    initialValue
+  } = {}) {
+    const state = initialState ? this.#initialState : this.#currentState;
+    let value = (0, _lodash.isNil)(path) ? state : (0, _lodash.get)(state, path);
+    if (value === undefined && initialValue !== undefined) {
+      value = (0, _lodash.isFunction)(initialValue) ? initialValue() : initialValue;
+      if (!initialState || this.get(path) === undefined) this.set(path, value);
+    }
+    return value;
   }
+
   /**
    * Writes the `value` to given global state `path`.
    * @param {string} [path] Dot-delimitered state path. If not given, entire
@@ -71,12 +77,8 @@ class GlobalState {
    * @param {any} value The value.
    * @return {any} Given `value` itself.
    */
-
-
   set(path, value) {
-    const p = fullPath(path);
-
-    if (value !== (0, _lodash.get)(this, p)) {
+    if (value !== this.get(path)) {
       if (process.env.NODE_ENV !== 'production' && (0, _utils.isDebugMode)()) {
         /* eslint-disable no-console */
         console.groupCollapsed(`ReactGlobalState update. Path: "${path || ''}"`);
@@ -84,37 +86,44 @@ class GlobalState {
         /* eslint-enable no-console */
       }
 
-      let pos = this;
-      const pathSegments = (0, _lodash.toPath)(p);
-
-      for (let i = 0; i < pathSegments.length - 1; i += 1) {
-        const seg = pathSegments[i];
-        const next = pos[seg];
-        if ((0, _lodash.isArray)(next)) pos[seg] = [...next];else if ((0, _lodash.isObject)(next)) pos[seg] = { ...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.
-      // It will be better to partially clone the state, so that any existing
-      // references are not mutated, while the full deep clonning is also
-      // avoided.
-
-
-      (0, _lodash.set)(this, p, value);
-
-      if (this.ssrContext) {
-        this.ssrContext.dirty = true;
-        this.ssrContext.state = this.state;
-      } else if (!this.nextNotifierId) {
-        this.nextNotifierId = setTimeout(() => {
-          this.nextNotifierId = null;
-          [...this.watchers].forEach(w => w());
+      if ((0, _lodash.isNil)(path)) this.#currentState = value;else {
+        const root = {
+          state: this.#currentState
+        };
+        let segIdx = 0;
+        let pos = root;
+        const pathSegments = (0, _lodash.toPath)(`state.${path}`);
+        for (; segIdx < pathSegments.length - 1; segIdx += 1) {
+          const seg = pathSegments[segIdx];
+          const next = pos[seg];
+          if (Array.isArray(next)) pos[seg] = [...next];else if ((0, _lodash.isObject)(next)) pos[seg] = {
+            ...next
+          };else {
+            // We arrived to a state sub-segment, where the remaining part of
+            // the update path does not exist yet. We rely on lodash's set()
+            // function to create the remaining path, and set the value.
+            (0, _lodash.set)(pos, pathSegments.slice(segIdx), value);
+            break;
+          }
+          pos = pos[seg];
+        }
+        if (segIdx === pathSegments.length - 1) {
+          pos[pathSegments[segIdx]] = value;
+        }
+        this.#currentState = root.state;
+      }
+      if (this.#ssrContext) {
+        this.#ssrContext.dirty = true;
+        this.#ssrContext.state = this.#currentState;
+      } else if (!this.#nextNotifierId) {
+        this.#nextNotifierId = setTimeout(() => {
+          this.#nextNotifierId = null;
+          [...this.#watchers].forEach(w => w());
         });
       }
-
       if (process.env.NODE_ENV !== 'production' && (0, _utils.isDebugMode)()) {
         /* eslint-disable no-console */
-        console.log('New state:', (0, _lodash.cloneDeep)(this.state));
+        console.log('New state:', (0, _lodash.cloneDeep)(this.#currentState));
         console.groupEnd();
         /* eslint-enable no-console */
       }
@@ -122,6 +131,7 @@ class GlobalState {
 
     return value;
   }
+
   /**
    * Unsubscribes `callback` from watching state updates; no operation if
    * `callback` is not subscribed to the state updates.
@@ -129,20 +139,19 @@ class GlobalState {
    * @throws if {@link SsrContext} is attached to the state instance: the state
    * watching functionality is intended for client-side (non-SSR) only.
    */
-
-
   unWatch(callback) {
-    if (this.ssrContext) throw new Error(ERR_NO_SSR_WATCH);
-    const {
-      watchers
-    } = this;
+    if (this.#ssrContext) throw new Error(ERR_NO_SSR_WATCH);
+    const watchers = this.#watchers;
     const pos = watchers.indexOf(callback);
-
     if (pos >= 0) {
       watchers[pos] = watchers[watchers.length - 1];
       watchers.pop();
     }
   }
+  get ssrContext() {
+    return this.#ssrContext;
+  }
+
   /**
    * Subscribes `callback` to watch state updates; no operation if
    * `callback` is already subscribed to this state instance.
@@ -153,20 +162,13 @@ class GlobalState {
    * @throws if {@link SsrContext} is attached to the state instance: the state
    * watching functionality is intended for client-side (non-SSR) only.
    */
-
-
   watch(callback) {
-    if (this.ssrContext) throw new Error(ERR_NO_SSR_WATCH);
-    const {
-      watchers
-    } = this;
-
+    if (this.#ssrContext) throw new Error(ERR_NO_SSR_WATCH);
+    const watchers = this.#watchers;
     if (watchers.indexOf(callback) < 0) {
       watchers.push(callback);
     }
   }
-
 }
-
 exports.default = GlobalState;
 //# sourceMappingURL=GlobalState.js.map

package/build/node/GlobalState.js.map

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

package/build/node/GlobalStateProvider.js

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

package/build/node/GlobalStateProvider.js.map

@@ -1 +1 @@
-{"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,MAAMA,OAAO,gBAAG,2BAAhB;AAEA;AACA;AACA;AACA;AACA;AACA;;AACO,SAASC,cAAT,GAA0B;AAC/B;AACA;AACA;AACA;AACA;;AACA;AACA,QAAMC,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,CAAuBC,sBAAsB,GAAG,IAAhD,EAAsD;AAC3D,QAAM;AAAEC,IAAAA;AAAF,MAAiBL,cAAc,EAArC;;AACA,MAAI,CAACK,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,CAA6B;AAC1CC,EAAAA,QAD0C;AAE1CC,EAAAA,YAF0C;AAG1CH,EAAAA,UAH0C;AAI1CI,EAAAA;AAJ0C,CAA7B,EAKZ;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,KACA,CAACU,KAAD,IAAU,qBAAS,IAAIC,oBAAJ,CAAgBH,YAAhB,EAA8BH,UAA9B,CAAT,CAAV;AACL;;AACA,sBACE,qBAAC,OAAD,CAAS,QAAT;AAAkB,IAAA,KAAK,EAAEK,KAAzB;AAAA,cACGH;AADH,IADF;AAKD","sourcesContent":["/* eslint-disable react/prop-types */\n\nimport { createContext, useContext, useState } from 'react';\n\nimport GlobalState from './GlobalState';\n\nconst context = createContext();\n\n/**\n * Gets {@link GlobalState} instance from the context. In most cases\n * you should use {@link useGlobalState}, and other hooks to interact with\n * the global state, instead of accessing it directly.\n * @return {GlobalState}\n */\nexport function getGlobalState() {\n  // Here Rules of Hooks are violated because \"getGlobalState()\" does not follow\n  // convention that hook names should start with use... This is intentional in\n  // our case, as getGlobalState() hook is intended for advance scenarious,\n  // while the normal interaction with the global state should happen via\n  // another hook, useGlobalState().\n  /* eslint-disable react-hooks/rules-of-hooks */\n  const globalState = useContext(context);\n  /* eslint-enable react-hooks/rules-of-hooks */\n  if (!globalState) throw new Error('Missing GlobalStateProvider');\n  return globalState;\n}\n\n/**\n * @category Hooks\n * @desc Gets SSR context.\n * @param {boolean} [throwWithoutSsrContext=true] If `true` (default),\n * this hook will throw if no SSR context is attached to the global state;\n * set `false` to not throw in such case. In either case the hook will throw\n * if the {@link &lt;GlobalStateProvider&gt;} (hence the state) is missing.\n * @returns {SsrContext} SSR context.\n * @throws\n * - If current component has no parent {@link &lt;GlobalStateProvider&gt;}\n *   in the rendered React tree.\n * - If `throwWithoutSsrContext` is `true`, and there is no SSR context attached\n *   to the global state provided by {@link &lt;GlobalStateProvider&gt;}.\n */\nexport function getSsrContext(throwWithoutSsrContext = true) {\n  const { ssrContext } = getGlobalState();\n  if (!ssrContext && throwWithoutSsrContext) {\n    throw new Error('No SSR context found');\n  }\n  return ssrContext;\n}\n\n/**\n * Provides global state to its children.\n * @prop {ReactNode} [children] Component children, which will be provided with\n * the global state, and rendered in place of the provider.\n * @prop {any} [initialState] Initial content of the global state.\n * @prop {SsrContext} [ssrContext] Server-side rendering (SSR) context.\n * @prop {boolean|GlobalState} [stateProxy] This option is useful for code\n * splitting and SSR implementation:\n * - If `true`, this provider instance will fetch and reuse the global state\n *   from a parent provider.\n * - If `GlobalState` instance, it will be used by this provider.\n * - If not given, a new `GlobalState` instance will be created and used.\n */\nexport default function GlobalStateProvider({\n  children,\n  initialState,\n  ssrContext,\n  stateProxy,\n}) {\n  let state;\n  // Here Rules of Hooks are violated because hooks are called conditionally,\n  // however we assume that these properties should not change at runtime, thus\n  // the actual hook order is preserved. Probably, it should be handled better,\n  // though.\n  /* eslint-disable react-hooks/rules-of-hooks */\n  if (stateProxy instanceof GlobalState) state = stateProxy;\n  else if (stateProxy) state = getGlobalState();\n  else [state] = useState(new GlobalState(initialState, ssrContext));\n  /* eslint-enable react-hooks/rules-of-hooks */\n  return (\n    <context.Provider value={state}>\n      {children}\n    </context.Provider>\n  );\n}\n"],"file":"GlobalStateProvider.js"}
+{"version":3,"file":"GlobalStateProvider.js","names":["context","createContext","getGlobalState","globalState","useContext","Error","getSsrContext","throwWithoutSsrContext","ssrContext","GlobalStateProvider","children","initialState","stateProxy","state","useRef","current","GlobalState"],"sources":["../../src/GlobalStateProvider.jsx"],"sourcesContent":["/* eslint-disable react/prop-types */\n\nimport { createContext, useContext, useRef } from 'react';\n\nimport GlobalState from './GlobalState';\n\nconst context = createContext();\n\n/**\n * Gets {@link GlobalState} instance from the context. In most cases\n * you should use {@link useGlobalState}, and other hooks to interact with\n * the global state, instead of accessing it directly.\n * @return {GlobalState}\n */\nexport function getGlobalState() {\n  // Here Rules of Hooks are violated because \"getGlobalState()\" does not follow\n  // convention that hook names should start with use... This is intentional in\n  // our case, as getGlobalState() hook is intended for advance scenarious,\n  // while the normal interaction with the global state should happen via\n  // another hook, useGlobalState().\n  /* eslint-disable react-hooks/rules-of-hooks */\n  const globalState = useContext(context);\n  /* eslint-enable react-hooks/rules-of-hooks */\n  if (!globalState) throw new Error('Missing GlobalStateProvider');\n  return globalState;\n}\n\n/**\n * @category Hooks\n * @desc Gets SSR context.\n * @param {boolean} [throwWithoutSsrContext=true] If `true` (default),\n * this hook will throw if no SSR context is attached to the global state;\n * set `false` to not throw in such case. In either case the hook will throw\n * if the {@link &lt;GlobalStateProvider&gt;} (hence the state) is missing.\n * @returns {SsrContext} SSR context.\n * @throws\n * - If current component has no parent {@link &lt;GlobalStateProvider&gt;}\n *   in the rendered React tree.\n * - If `throwWithoutSsrContext` is `true`, and there is no SSR context attached\n *   to the global state provided by {@link &lt;GlobalStateProvider&gt;}.\n */\nexport function getSsrContext(throwWithoutSsrContext = true) {\n  const { ssrContext } = getGlobalState();\n  if (!ssrContext && throwWithoutSsrContext) {\n    throw new Error('No SSR context found');\n  }\n  return ssrContext;\n}\n\n/**\n * Provides global state to its children.\n * @prop {ReactNode} [children] Component children, which will be provided with\n * the global state, and rendered in place of the provider.\n * @prop {any} [initialState] Initial content of the global state.\n * @prop {SsrContext} [ssrContext] Server-side rendering (SSR) context.\n * @prop {boolean|GlobalState} [stateProxy] This option is useful for code\n * splitting and SSR implementation:\n * - If `true`, this provider instance will fetch and reuse the global state\n *   from a parent provider.\n * - If `GlobalState` instance, it will be used by this provider.\n * - If not given, a new `GlobalState` instance will be created and used.\n */\nexport default function GlobalStateProvider({\n  children,\n  initialState,\n  ssrContext,\n  stateProxy,\n}) {\n  const state = useRef();\n  if (!state.current) {\n    if (stateProxy instanceof GlobalState) state.current = stateProxy;\n    else if (stateProxy) state.current = getGlobalState();\n    else state.current = new GlobalState(initialState, ssrContext);\n  }\n  return (\n    <context.Provider value={state.current}>\n      {children}\n    </context.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;AAEA;AAEA;AAAwC;AAJxC;;AAMA,MAAMA,OAAO,gBAAG,IAAAC,oBAAa,GAAE;;AAE/B;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,cAAc,GAAG;EAC/B;EACA;EACA;EACA;EACA;EACA;EACA,MAAMC,WAAW,GAAG,IAAAC,iBAAU,EAACJ,OAAO,CAAC;EACvC;EACA,IAAI,CAACG,WAAW,EAAE,MAAM,IAAIE,KAAK,CAAC,6BAA6B,CAAC;EAChE,OAAOF,WAAW;AACpB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASG,aAAa,CAACC,sBAAsB,GAAG,IAAI,EAAE;EAC3D,MAAM;IAAEC;EAAW,CAAC,GAAGN,cAAc,EAAE;EACvC,IAAI,CAACM,UAAU,IAAID,sBAAsB,EAAE;IACzC,MAAM,IAAIF,KAAK,CAAC,sBAAsB,CAAC;EACzC;EACA,OAAOG,UAAU;AACnB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACe,SAASC,mBAAmB,CAAC;EAC1CC,QAAQ;EACRC,YAAY;EACZH,UAAU;EACVI;AACF,CAAC,EAAE;EACD,MAAMC,KAAK,GAAG,IAAAC,aAAM,GAAE;EACtB,IAAI,CAACD,KAAK,CAACE,OAAO,EAAE;IAClB,IAAIH,UAAU,YAAYI,oBAAW,EAAEH,KAAK,CAACE,OAAO,GAAGH,UAAU,CAAC,KAC7D,IAAIA,UAAU,EAAEC,KAAK,CAACE,OAAO,GAAGb,cAAc,EAAE,CAAC,KACjDW,KAAK,CAACE,OAAO,GAAG,IAAIC,oBAAW,CAACL,YAAY,EAAEH,UAAU,CAAC;EAChE;EACA,oBACE,qBAAC,OAAO,CAAC,QAAQ;IAAC,KAAK,EAAEK,KAAK,CAACE,OAAQ;IAAA,UACpCL;EAAQ,EACQ;AAEvB"}

package/build/node/index.js

@@ -1,7 +1,6 @@
 "use strict";
 
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
-
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
@@ -41,19 +40,12 @@ Object.defineProperty(exports, "useGlobalState", {
     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 (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

package/build/node/index.js.map

@@ -1 +1 @@
-{"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,GAAsBC,QAAD,IAAcF,OAAO,CAACG,GAAR,CACjCD,QAAQ,CAACE,GAAT,CAAcC,CAAD,IAAQA,CAAC,YAAYL,OAAb,GAAuBK,CAAC,CAACC,OAAF,CAAU,MAAM,IAAhB,CAAvB,GAA+CD,CAApE,CADiC,CAAnC;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"}
+{"version":3,"file":"index.js","names":["Promise","allSettled","promises","all","map","p","finally"],"sources":["../../src/index.js"],"sourcesContent":["// TODO: This is a temporary polyfill for `Promise.allSettled(..)` method,\n// which is supported natively by NodeJS >= v12.9.0. As earlier NodeJS version\n// are still in a wide use, this polyfill is added here, and it is to be dropped\n// some time later.\nif (!Promise.allSettled) {\n  Promise.allSettled = (promises) => Promise.all(\n    promises.map((p) => (p instanceof Promise ? p.finally(() => null) : p)),\n  );\n}\n\nexport {\n  default as GlobalStateProvider,\n  getGlobalState,\n  getSsrContext,\n} from './GlobalStateProvider';\n\nexport { default as useAsyncCollection } from './useAsyncCollection';\nexport { default as useAsyncData } from './useAsyncData';\nexport { default as useGlobalState } from './useGlobalState';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAUA;AAMA;AACA;AACA;AAA6D;AAAA;AAlB7D;AACA;AACA;AACA;AACA,IAAI,CAACA,OAAO,CAACC,UAAU,EAAE;EACvBD,OAAO,CAACC,UAAU,GAAIC,QAAQ,IAAKF,OAAO,CAACG,GAAG,CAC5CD,QAAQ,CAACE,GAAG,CAAEC,CAAC,IAAMA,CAAC,YAAYL,OAAO,GAAGK,CAAC,CAACC,OAAO,CAAC,MAAM,IAAI,CAAC,GAAGD,CAAE,CAAC,CACxE;AACH"}

package/build/node/useAsyncCollection.js

@@ -1,14 +1,11 @@
 "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.
  */

package/build/node/useAsyncCollection.js.map

@@ -1 +1 @@
-{"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,EAIbC,OAAO,GAAG,EAJG,EAKb;AACA,QAAMC,QAAQ,GAAGH,IAAI,GAAI,GAAEA,IAAK,IAAGD,EAAG,EAAjB,GAAqBA,EAA1C;AACA,SAAO,2BAAaI,QAAb,EAAwBC,OAAD,IAAaH,MAAM,CAACF,EAAD,EAAKK,OAAL,CAA1C,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"}
+{"version":3,"file":"useAsyncCollection.js","names":["useAsyncCollection","id","path","loader","options","itemPath","useAsyncData","oldData"],"sources":["../../src/useAsyncCollection.js"],"sourcesContent":["/**\n * Loads and uses an item in an async collection.\n */\n\nimport useAsyncData from './useAsyncData';\n\n/**\n * Resolves and stores at the given `path` of global state elements of\n * an asynchronous data collection. In other words, it is an auxiliar wrapper\n * around {@link useAsyncData}, which uses a loader which resolves to different\n * data, based on ID argument passed in, and stores data fetched for different\n * IDs in the state.\n * @param {string} id ID of the collection item to load & use.\n * @param {string} path The global state path where entire collection should be\n *  stored.\n * @param {AsyncCollectionLoader} loader A loader function, which takes an\n * ID of data to load, and resolves to the corresponding data.\n * @param {object} [options] Additional options.\n * @param {any[]} [options.deps=[]] An array of dependencies, which trigger\n * data reload when changed. Given dependency changes are watched shallowly\n * (similarly to the standard React's\n * [useEffect()](https://reactjs.org/docs/hooks-reference.html#useeffect)).\n * @param {boolean} [options.noSSR] If `true`, this hook won't load data during\n * server-side rendering.\n * @param {number} [options.garbageCollectAge=maxage] The maximum age of data\n * (in milliseconds), after which they are dropped from the state when the last\n * component referencing them via `useAsyncData()` hook unmounts. Defaults to\n * `maxage` option value.\n * @param {number} [options.maxage=5 x 60 x 1000] The maximum age of\n * data (in milliseconds) acceptable to the hook's caller. If loaded data are\n * older than this value, `null` is returned instead. Defaults to 5 minutes.\n * @param {number} [options.refreshAge=maxage] The maximum age of data\n * (in milliseconds), after which their refreshment will be triggered when\n * any component referencing them via `useAsyncData()` hook (re-)renders.\n * Defaults to `maxage` value.\n * @return {{\n *   data: any,\n *   loading: boolean,\n *   timestamp: number\n * }} Returns an object with three fields: `data` holds the actual result of\n * last `loader` invokation, if any, and if satisfies `maxage` limit; `loading`\n * is a boolean flag, which is `true` if data are being loaded (the hook is\n * waiting for `loader` function resolution); `timestamp` (in milliseconds)\n * is Unix timestamp of related data currently loaded into the global state.\n *\n * Note that loaded data, if any, are stored at the given `path` of global state\n * along with related meta-information, using slightly different state segment\n * structure (see {@link AsyncDataEnvelope}). That segment of the global state\n * can be accessed, and even modified using other hooks,\n * _e.g._ {@link useGlobalState}, but doing so you may interfere with related\n * `useAsyncData()` hooks logic.\n */\nexport default function useAsyncCollection(\n  id,\n  path,\n  loader,\n  options = {},\n) {\n  const itemPath = path ? `${path}.${id}` : id;\n  return useAsyncData(itemPath, (oldData) => loader(id, oldData), options);\n}\n"],"mappings":";;;;;;;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,kBAAkB,CACxCC,EAAE,EACFC,IAAI,EACJC,MAAM,EACNC,OAAO,GAAG,CAAC,CAAC,EACZ;EACA,MAAMC,QAAQ,GAAGH,IAAI,GAAI,GAAEA,IAAK,IAAGD,EAAG,EAAC,GAAGA,EAAE;EAC5C,OAAO,IAAAK,qBAAY,EAACD,QAAQ,EAAGE,OAAO,IAAKJ,MAAM,CAACF,EAAE,EAAEM,OAAO,CAAC,EAAEH,OAAO,CAAC;AAC1E"}