@dr.pogodin/react-global-state 0.9.3 → 0.10.0-alpha.2

package/src/withGlobalStateType.ts

@@ -0,0 +1,118 @@
+import {
+  type TypeLock,
+  type ValueAtPathT,
+  type ValueOrInitializerT,
+} from './utils';
+
+import GlobalStateProvider, {
+  getGlobalState,
+  getSsrContext,
+} from './GlobalStateProvider';
+
+import SsrContext from './SsrContext';
+
+import useGlobalState, {
+  type UseGlobalStateResT,
+} from './useGlobalState';
+
+import useAsyncCollection, {
+  type AsyncCollectionLoaderT,
+} from './useAsyncCollection';
+
+import useAsyncData, {
+  type AsyncDataLoaderT,
+  type DataInEnvelopeAtPathT,
+  type UseAsyncDataOptionsT,
+  type UseAsyncDataResT,
+} from './useAsyncData';
+
+export default function withGlobalStateType<StateT>() {
+  // These wrap useGlobalState() with locked-in StateT type.
+
+  function useGlobalStateWrap(): UseGlobalStateResT<StateT>;
+
+  function useGlobalStateWrap<PathT extends null | string | undefined>(
+    path: PathT,
+    initialValue?: ValueOrInitializerT<ValueAtPathT<StateT, PathT, never>>,
+  ): UseGlobalStateResT<ValueAtPathT<StateT, PathT, void>>;
+
+  function useGlobalStateWrap<
+    Unlocked extends 0 | 1 = 0,
+    ValueT = void,
+  >(
+    path: null | string | undefined,
+    initialValue?: ValueOrInitializerT<TypeLock<Unlocked, never, ValueT>>,
+  ): UseGlobalStateResT<TypeLock<Unlocked, void, ValueT>>;
+
+  function useGlobalStateWrap(
+    path?: null | string,
+    initialValue?: ValueOrInitializerT<unknown>,
+  ): UseGlobalStateResT<any> {
+    return useGlobalState<1, unknown>(path, initialValue);
+  }
+
+  // These overloads & implementation wrap useAsyncData() hook to lock-in its
+  // underlying StateT.
+
+  function useAsyncDataWrap<PathT extends null | string | undefined>(
+    path: PathT,
+    loader: AsyncDataLoaderT<DataInEnvelopeAtPathT<StateT, PathT>>,
+    options?: UseAsyncDataOptionsT,
+  ): UseAsyncDataResT<DataInEnvelopeAtPathT<StateT, PathT>>;
+
+  function useAsyncDataWrap<
+    Unlocked extends 0 | 1 = 0,
+    DataT = unknown,
+  >(
+    path: null | string | undefined,
+    loader: AsyncDataLoaderT<TypeLock<Unlocked, void, DataT>>,
+    options?: UseAsyncDataOptionsT,
+  ): UseAsyncDataResT<TypeLock<Unlocked, never, DataT>>;
+
+  function useAsyncDataWrap<DataT>(
+    path: null | string | undefined,
+    loader: AsyncDataLoaderT<DataT>,
+    options: UseAsyncDataOptionsT = {},
+  ): UseAsyncDataResT<DataT> {
+    return useAsyncData<1, DataT>(path, loader, options);
+  }
+
+  // These overloads & implementation wrap useAsyncCollection() hook to lock-in
+  // its underlying StateT.
+
+  function useAsyncCollectionWrap<PathT extends null | string | undefined>(
+    id: string,
+    path: PathT,
+    loader: AsyncCollectionLoaderT<DataInEnvelopeAtPathT<StateT, PathT>>,
+    options?: UseAsyncDataOptionsT,
+  ): UseAsyncDataResT<DataInEnvelopeAtPathT<StateT, PathT>>;
+
+  function useAsyncCollectionWrap<
+    Unlocked extends 0 | 1 = 0,
+    DataT = unknown,
+  >(
+    id: string,
+    path: null | string | undefined,
+    loader: AsyncCollectionLoaderT<TypeLock<Unlocked, void, DataT>>,
+    options?: UseAsyncDataOptionsT,
+  ): UseAsyncDataResT<DataT>;
+
+  function useAsyncCollectionWrap<DataT>(
+    id: string,
+    path: null | string | undefined,
+    loader: AsyncCollectionLoaderT<DataT>,
+    options: UseAsyncDataOptionsT = {},
+  ): UseAsyncDataResT<DataT> {
+    return useAsyncCollection<1, DataT>(id, path, loader, options);
+  }
+
+  return {
+    getGlobalState: getGlobalState<StateT>,
+    getSsrContext: getSsrContext<StateT>,
+    GlobalStateProvider: GlobalStateProvider<StateT>,
+    SsrContext: SsrContext<StateT>,
+    useAsyncCollection: useAsyncCollectionWrap,
+    useAsyncData: useAsyncDataWrap,
+    useGlobalState: useGlobalStateWrap,
+  };
+}

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "@tsconfig/recommended",
+  "include": ["src/**/*"],
+  "compilerOptions": {
+    "declaration": true,
+    "jsx": "react-jsx",
+    "outDir": "build"
+  }
+}

package/build/module/GlobalState.js

@@ -1,191 +0,0 @@
-import _classPrivateFieldGet from "@babel/runtime/helpers/classPrivateFieldGet";
-import _classPrivateFieldSet from "@babel/runtime/helpers/classPrivateFieldSet";
-function _classPrivateFieldInitSpec(obj, privateMap, value) { _checkPrivateRedeclaration(obj, privateMap); privateMap.set(obj, value); }
-function _checkPrivateRedeclaration(obj, privateCollection) { if (privateCollection.has(obj)) { throw new TypeError("Cannot initialize the same private elements twice on an object"); } }
-import { cloneDeep, get, isFunction, isObject, isNil, set, toPath } from 'lodash';
-import { isDebugMode } from "./utils";
-const ERR_NO_SSR_WATCH = 'GlobalState must not be watched at server side';
-var _initialState = /*#__PURE__*/new WeakMap();
-var _nextNotifierId = /*#__PURE__*/new WeakMap();
-var _ssrContext = /*#__PURE__*/new WeakMap();
-var _currentState = /*#__PURE__*/new WeakMap();
-var _watchers = /*#__PURE__*/new WeakMap();
-export default class GlobalState {
-  /**
-   * Creates a new global state object.
-   * @param {any} [initialState] Intial global state content.
-   * @param {SsrContext} [ssrContext] Server-side rendering context.
-   */
-  constructor(initialState, ssrContext) {
-    _classPrivateFieldInitSpec(this, _initialState, {
-      writable: true,
-      value: void 0
-    });
-    _classPrivateFieldInitSpec(this, _nextNotifierId, {
-      writable: true,
-      value: null
-    });
-    _classPrivateFieldInitSpec(this, _ssrContext, {
-      writable: true,
-      value: void 0
-    });
-    _classPrivateFieldInitSpec(this, _currentState, {
-      writable: true,
-      value: void 0
-    });
-    _classPrivateFieldInitSpec(this, _watchers, {
-      writable: true,
-      value: []
-    });
-    _classPrivateFieldSet(this, _currentState, initialState);
-    _classPrivateFieldSet(this, _initialState, initialState);
-    if (ssrContext) {
-      /* eslint-disable no-param-reassign */
-      ssrContext.dirty = false;
-      ssrContext.pending = [];
-      ssrContext.state = _classPrivateFieldGet(this, _currentState);
-      /* eslint-enable no-param-reassign */
-
-      _classPrivateFieldSet(this, _ssrContext, ssrContext);
-    }
-    if (process.env.NODE_ENV !== 'production' && isDebugMode()) {
-      /* eslint-disable no-console */
-      let msg = 'New ReactGlobalState created';
-      if (ssrContext) msg += ' (SSR mode)';
-      console.groupCollapsed(msg);
-      console.log('Initial state:', cloneDeep(initialState));
-      console.groupEnd();
-      /* eslint-enable no-console */
-    }
-  }
-
-  /**
-   * 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) {
-    let {
-      initialState,
-      initialValue
-    } = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
-    const state = initialState ? _classPrivateFieldGet(this, _initialState) : _classPrivateFieldGet(this, _currentState);
-    let value = isNil(path) ? state : get(state, path);
-    if (value === undefined && initialValue !== undefined) {
-      value = isFunction(initialValue) ? initialValue() : initialValue;
-      if (!initialState || this.get(path) === undefined) this.set(path, value);
-    }
-    return value;
-  }
-
-  /**
-   * Writes the `value` to given global state `path`.
-   * @param {string} [path] Dot-delimitered state path. If not given, entire
-   * global state content is replaced by the `value`.
-   * @param {any} value The value.
-   * @return {any} Given `value` itself.
-   */
-  set(path, value) {
-    if (value !== this.get(path)) {
-      if (process.env.NODE_ENV !== 'production' && isDebugMode()) {
-        /* eslint-disable no-console */
-        console.groupCollapsed(`ReactGlobalState update. Path: "${path || ''}"`);
-        console.log('New value:', cloneDeep(value));
-        /* eslint-enable no-console */
-      }
-
-      if (isNil(path)) _classPrivateFieldSet(this, _currentState, value);else {
-        const root = {
-          state: _classPrivateFieldGet(this, _currentState)
-        };
-        let segIdx = 0;
-        let pos = root;
-        const pathSegments = toPath(`state.${path}`);
-        for (; segIdx < pathSegments.length - 1; segIdx += 1) {
-          const seg = pathSegments[segIdx];
-          const next = pos[seg];
-          if (Array.isArray(next)) pos[seg] = [...next];else if (isObject(next)) pos[seg] = {
-            ...next
-          };else {
-            // We arrived to a state sub-segment, where the remaining part of
-            // the update path does not exist yet. We rely on lodash's set()
-            // function to create the remaining path, and set the value.
-            set(pos, pathSegments.slice(segIdx), value);
-            break;
-          }
-          pos = pos[seg];
-        }
-        if (segIdx === pathSegments.length - 1) {
-          pos[pathSegments[segIdx]] = value;
-        }
-        _classPrivateFieldSet(this, _currentState, root.state);
-      }
-      if (_classPrivateFieldGet(this, _ssrContext)) {
-        _classPrivateFieldGet(this, _ssrContext).dirty = true;
-        _classPrivateFieldGet(this, _ssrContext).state = _classPrivateFieldGet(this, _currentState);
-      } else if (!_classPrivateFieldGet(this, _nextNotifierId)) {
-        _classPrivateFieldSet(this, _nextNotifierId, setTimeout(() => {
-          _classPrivateFieldSet(this, _nextNotifierId, null);
-          [..._classPrivateFieldGet(this, _watchers)].forEach(w => w());
-        }));
-      }
-      if (process.env.NODE_ENV !== 'production' && isDebugMode()) {
-        /* eslint-disable no-console */
-        console.log('New state:', cloneDeep(_classPrivateFieldGet(this, _currentState)));
-        console.groupEnd();
-        /* eslint-enable no-console */
-      }
-    }
-
-    return value;
-  }
-
-  /**
-   * Unsubscribes `callback` from watching state updates; no operation if
-   * `callback` is not subscribed to the state updates.
-   * @param {function} callback
-   * @throws if {@link SsrContext} is attached to the state instance: the state
-   * watching functionality is intended for client-side (non-SSR) only.
-   */
-  unWatch(callback) {
-    if (_classPrivateFieldGet(this, _ssrContext)) throw new Error(ERR_NO_SSR_WATCH);
-    const watchers = _classPrivateFieldGet(this, _watchers);
-    const pos = watchers.indexOf(callback);
-    if (pos >= 0) {
-      watchers[pos] = watchers[watchers.length - 1];
-      watchers.pop();
-    }
-  }
-  get ssrContext() {
-    return _classPrivateFieldGet(this, _ssrContext);
-  }
-
-  /**
-   * Subscribes `callback` to watch state updates; no operation if
-   * `callback` is already subscribed to this state instance.
-   * @param {function} callback It will be called without any arguments every
-   * time the state content changes (note, howhever, separate state updates can
-   * be applied to the state at once, and watching callbacks will be called once
-   * after such bulk update).
-   * @throws if {@link SsrContext} is attached to the state instance: the state
-   * watching functionality is intended for client-side (non-SSR) only.
-   */
-  watch(callback) {
-    if (_classPrivateFieldGet(this, _ssrContext)) throw new Error(ERR_NO_SSR_WATCH);
-    const watchers = _classPrivateFieldGet(this, _watchers);
-    if (watchers.indexOf(callback) < 0) {
-      watchers.push(callback);
-    }
-  }
-}
-//# sourceMappingURL=GlobalState.js.map

package/build/module/GlobalState.js.map

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

package/build/module/GlobalStateProvider.js

@@ -1,81 +0,0 @@
-/* eslint-disable react/prop-types */
-
-import { createContext, useContext, useRef } from 'react';
-import GlobalState from "./GlobalState";
-import { jsx as _jsx } from "react/jsx-runtime";
-const context = /*#__PURE__*/createContext();
-
-/**
- * Gets {@link GlobalState} instance from the context. In most cases
- * you should use {@link useGlobalState}, and other hooks to interact with
- * the global state, instead of accessing it directly.
- * @return {GlobalState}
- */
-export function getGlobalState() {
-  // Here Rules of Hooks are violated because "getGlobalState()" does not follow
-  // convention that hook names should start with use... This is intentional in
-  // our case, as getGlobalState() hook is intended for advance scenarious,
-  // while the normal interaction with the global state should happen via
-  // another hook, useGlobalState().
-  /* eslint-disable react-hooks/rules-of-hooks */
-  const globalState = useContext(context);
-  /* eslint-enable react-hooks/rules-of-hooks */
-  if (!globalState) throw new Error('Missing GlobalStateProvider');
-  return globalState;
-}
-
-/**
- * @category Hooks
- * @desc Gets SSR context.
- * @param {boolean} [throwWithoutSsrContext=true] If `true` (default),
- * this hook will throw if no SSR context is attached to the global state;
- * set `false` to not throw in such case. In either case the hook will throw
- * if the {@link <GlobalStateProvider>} (hence the state) is missing.
- * @returns {SsrContext} SSR context.
- * @throws
- * - If current component has no parent {@link <GlobalStateProvider>}
- *   in the rendered React tree.
- * - If `throwWithoutSsrContext` is `true`, and there is no SSR context attached
- *   to the global state provided by {@link <GlobalStateProvider>}.
- */
-export function getSsrContext() {
-  let throwWithoutSsrContext = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
-  const {
-    ssrContext
-  } = getGlobalState();
-  if (!ssrContext && throwWithoutSsrContext) {
-    throw new Error('No SSR context found');
-  }
-  return ssrContext;
-}
-
-/**
- * Provides global state to its children.
- * @prop {ReactNode} [children] Component children, which will be provided with
- * the global state, and rendered in place of the provider.
- * @prop {any} [initialState] Initial content of the global state.
- * @prop {SsrContext} [ssrContext] Server-side rendering (SSR) context.
- * @prop {boolean|GlobalState} [stateProxy] This option is useful for code
- * splitting and SSR implementation:
- * - If `true`, this provider instance will fetch and reuse the global state
- *   from a parent provider.
- * - If `GlobalState` instance, it will be used by this provider.
- * - If not given, a new `GlobalState` instance will be created and used.
- */
-export default function GlobalStateProvider(_ref) {
-  let {
-    children,
-    initialState,
-    ssrContext,
-    stateProxy
-  } = _ref;
-  const state = useRef();
-  if (!state.current) {
-    if (stateProxy instanceof GlobalState) state.current = stateProxy;else if (stateProxy) state.current = getGlobalState();else state.current = new GlobalState(initialState, ssrContext);
-  }
-  return /*#__PURE__*/_jsx(context.Provider, {
-    value: state.current,
-    children: children
-  });
-}
-//# sourceMappingURL=GlobalStateProvider.js.map

package/build/module/GlobalStateProvider.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"GlobalStateProvider.js","names":["createContext","useContext","useRef","GlobalState","jsx","_jsx","context","getGlobalState","globalState","Error","getSsrContext","throwWithoutSsrContext","arguments","length","undefined","ssrContext","GlobalStateProvider","_ref","children","initialState","stateProxy","state","current","Provider","value"],"sources":["../../src/GlobalStateProvider.jsx"],"sourcesContent":["/* eslint-disable react/prop-types */\n\nimport { createContext, useContext, useRef } from 'react';\n\nimport GlobalState from './GlobalState';\n\nconst context = createContext();\n\n/**\n * Gets {@link GlobalState} instance from the context. In most cases\n * you should use {@link useGlobalState}, and other hooks to interact with\n * the global state, instead of accessing it directly.\n * @return {GlobalState}\n */\nexport function getGlobalState() {\n  // Here Rules of Hooks are violated because \"getGlobalState()\" does not follow\n  // convention that hook names should start with use... This is intentional in\n  // our case, as getGlobalState() hook is intended for advance scenarious,\n  // while the normal interaction with the global state should happen via\n  // another hook, useGlobalState().\n  /* eslint-disable react-hooks/rules-of-hooks */\n  const globalState = useContext(context);\n  /* eslint-enable react-hooks/rules-of-hooks */\n  if (!globalState) throw new Error('Missing GlobalStateProvider');\n  return globalState;\n}\n\n/**\n * @category Hooks\n * @desc Gets SSR context.\n * @param {boolean} [throwWithoutSsrContext=true] If `true` (default),\n * this hook will throw if no SSR context is attached to the global state;\n * set `false` to not throw in such case. In either case the hook will throw\n * if the {@link &lt;GlobalStateProvider&gt;} (hence the state) is missing.\n * @returns {SsrContext} SSR context.\n * @throws\n * - If current component has no parent {@link &lt;GlobalStateProvider&gt;}\n *   in the rendered React tree.\n * - If `throwWithoutSsrContext` is `true`, and there is no SSR context attached\n *   to the global state provided by {@link &lt;GlobalStateProvider&gt;}.\n */\nexport function getSsrContext(throwWithoutSsrContext = true) {\n  const { ssrContext } = getGlobalState();\n  if (!ssrContext && throwWithoutSsrContext) {\n    throw new Error('No SSR context found');\n  }\n  return ssrContext;\n}\n\n/**\n * Provides global state to its children.\n * @prop {ReactNode} [children] Component children, which will be provided with\n * the global state, and rendered in place of the provider.\n * @prop {any} [initialState] Initial content of the global state.\n * @prop {SsrContext} [ssrContext] Server-side rendering (SSR) context.\n * @prop {boolean|GlobalState} [stateProxy] This option is useful for code\n * splitting and SSR implementation:\n * - If `true`, this provider instance will fetch and reuse the global state\n *   from a parent provider.\n * - If `GlobalState` instance, it will be used by this provider.\n * - If not given, a new `GlobalState` instance will be created and used.\n */\nexport default function GlobalStateProvider({\n  children,\n  initialState,\n  ssrContext,\n  stateProxy,\n}) {\n  const state = useRef();\n  if (!state.current) {\n    if (stateProxy instanceof GlobalState) state.current = stateProxy;\n    else if (stateProxy) state.current = getGlobalState();\n    else state.current = new GlobalState(initialState, ssrContext);\n  }\n  return (\n    <context.Provider value={state.current}>\n      {children}\n    </context.Provider>\n  );\n}\n"],"mappings":"AAAA;;AAEA,SAASA,aAAa,EAAEC,UAAU,EAAEC,MAAM,QAAQ,OAAO;AAEzD,OAAOC,WAAW;AAAsB,SAAAC,GAAA,IAAAC,IAAA;AAExC,MAAMC,OAAO,gBAAGN,aAAa,EAAE;;AAE/B;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASO,cAAcA,CAAA,EAAG;EAC/B;EACA;EACA;EACA;EACA;EACA;EACA,MAAMC,WAAW,GAAGP,UAAU,CAACK,OAAO,CAAC;EACvC;EACA,IAAI,CAACE,WAAW,EAAE,MAAM,IAAIC,KAAK,CAAC,6BAA6B,CAAC;EAChE,OAAOD,WAAW;AACpB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASE,aAAaA,CAAA,EAAgC;EAAA,IAA/BC,sBAAsB,GAAAC,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAG,IAAI;EACzD,MAAM;IAAEG;EAAW,CAAC,GAAGR,cAAc,EAAE;EACvC,IAAI,CAACQ,UAAU,IAAIJ,sBAAsB,EAAE;IACzC,MAAM,IAAIF,KAAK,CAAC,sBAAsB,CAAC;EACzC;EACA,OAAOM,UAAU;AACnB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,eAAe,SAASC,mBAAmBA,CAAAC,IAAA,EAKxC;EAAA,IALyC;IAC1CC,QAAQ;IACRC,YAAY;IACZJ,UAAU;IACVK;EACF,CAAC,GAAAH,IAAA;EACC,MAAMI,KAAK,GAAGnB,MAAM,EAAE;EACtB,IAAI,CAACmB,KAAK,CAACC,OAAO,EAAE;IAClB,IAAIF,UAAU,YAAYjB,WAAW,EAAEkB,KAAK,CAACC,OAAO,GAAGF,UAAU,CAAC,KAC7D,IAAIA,UAAU,EAAEC,KAAK,CAACC,OAAO,GAAGf,cAAc,EAAE,CAAC,KACjDc,KAAK,CAACC,OAAO,GAAG,IAAInB,WAAW,CAACgB,YAAY,EAAEJ,UAAU,CAAC;EAChE;EACA,oBACEV,IAAA,CAACC,OAAO,CAACiB,QAAQ;IAACC,KAAK,EAAEH,KAAK,CAACC,OAAQ;IAAAJ,QAAA,EACpCA;EAAQ,EACQ;AAEvB"}

package/build/module/index.js

@@ -1,12 +0,0 @@
-// 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 = promises => Promise.all(promises.map(p => p instanceof Promise ? p.finally(() => null) : p));
-}
-export { default as GlobalStateProvider, getGlobalState, getSsrContext } from "./GlobalStateProvider";
-export { default as useAsyncCollection } from "./useAsyncCollection";
-export { default as useAsyncData } from "./useAsyncData";
-export { default as useGlobalState } from "./useGlobalState";
-//# sourceMappingURL=index.js.map

package/build/module/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","names":["Promise","allSettled","promises","all","map","p","finally","default","GlobalStateProvider","getGlobalState","getSsrContext","useAsyncCollection","useAsyncData","useGlobalState"],"sources":["../../src/index.js"],"sourcesContent":["// TODO: This is a temporary polyfill for `Promise.allSettled(..)` method,\n// which is supported natively by NodeJS >= v12.9.0. As earlier NodeJS version\n// are still in a wide use, this polyfill is added here, and it is to be dropped\n// some time later.\nif (!Promise.allSettled) {\n  Promise.allSettled = (promises) => Promise.all(\n    promises.map((p) => (p instanceof Promise ? p.finally(() => null) : p)),\n  );\n}\n\nexport {\n  default as GlobalStateProvider,\n  getGlobalState,\n  getSsrContext,\n} from './GlobalStateProvider';\n\nexport { default as useAsyncCollection } from './useAsyncCollection';\nexport { default as useAsyncData } from './useAsyncData';\nexport { default as useGlobalState } from './useGlobalState';\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA,IAAI,CAACA,OAAO,CAACC,UAAU,EAAE;EACvBD,OAAO,CAACC,UAAU,GAAIC,QAAQ,IAAKF,OAAO,CAACG,GAAG,CAC5CD,QAAQ,CAACE,GAAG,CAAEC,CAAC,IAAMA,CAAC,YAAYL,OAAO,GAAGK,CAAC,CAACC,OAAO,CAAC,MAAM,IAAI,CAAC,GAAGD,CAAE,CAAC,CACxE;AACH;AAEA,SACEE,OAAO,IAAIC,mBAAmB,EAC9BC,cAAc,EACdC,aAAa;AAGf,SAASH,OAAO,IAAII,kBAAkB;AACtC,SAASJ,OAAO,IAAIK,YAAY;AAChC,SAASL,OAAO,IAAIM,cAAc"}

package/build/module/useAsyncCollection.js.map

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