@dr.pogodin/react-global-state 0.9.2 → 0.10.0-alpha.1

package/build/module/useAsyncData.js

@@ -1,206 +0,0 @@
-/**
- * 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";
-const DEFAULT_MAXAGE = 5 * 60 * 1000; // 5 minutes.
-
-/**
- * Executes the data loading operation.
- * @param {string} path Data segment path inside the global state.
- * @param {function} loader Data loader.
- * @param {GlobalState} globalState The global state instance.
- * @param {any} [oldData] Optional. Previously fetched data, currently stored in
- *  the state, if already fetched by the caller; otherwise, they will be fetched
- *  by the load() function itself.
- * @param {string} [opIdPrefix='C'] operationId prefix to use, which should be
- * 'C' at the client-side (default), or 'S' at the server-side (within SSR
- * context).
- * @return {Promise} Resolves once the operation is done.
- * @ignore
- */
-async function load(path, loader, globalState, oldData) {
-  let opIdPrefix = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : 'C';
-  if (process.env.NODE_ENV !== 'production' && isDebugMode()) {
-    /* eslint-disable no-console */
-    console.log(`ReactGlobalState: useAsyncData data (re-)loading. Path: "${path || ''}"`);
-    /* eslint-enable no-console */
-  }
-
-  const operationId = opIdPrefix + uuid();
-  const operationIdPath = path ? `${path}.operationId` : 'operationId';
-  globalState.set(operationIdPath, operationId);
-  const data = await loader(oldData || globalState.get(path).data);
-  const state = globalState.get(path);
-  if (operationId === state.operationId) {
-    if (process.env.NODE_ENV !== 'production' && isDebugMode()) {
-      /* eslint-disable no-console */
-      console.groupCollapsed(`ReactGlobalState: useAsyncData data (re-)loaded. Path: "${path || ''}"`);
-      console.log('Data:', cloneDeep(data));
-      /* eslint-enable no-console */
-    }
-
-    globalState.set(path, {
-      ...state,
-      data,
-      operationId: '',
-      timestamp: Date.now()
-    });
-    if (process.env.NODE_ENV !== 'production' && isDebugMode()) {
-      /* eslint-disable no-console */
-      console.groupEnd();
-      /* eslint-enable no-console */
-    }
-  }
-}
-
-/**
- * Resolves asynchronous data, and stores them at given `path` of global
- * state. When multiple components rely on asynchronous data at the same `path`,
- * the data are resolved once, and reused until their age is within specified
- * bounds. Once the data are stale, the hook allows to refresh them. It also
- * garbage-collects stale data from the global state when the last component
- * relying on them is unmounted.
- * @param {string} path Dot-delimitered state path, where data envelop is
- * stored.
- * @param {AsyncDataLoader} loader Asynchronous function which resolves (loads)
- * data, which should be stored at the global state `path`. When multiple
- * components
- * use `useAsyncData()` hook for the same `path`, the library assumes that all
- * hook instances are called with the same `loader` (_i.e._ whichever of these
- * loaders is used to resolve async data, the result is acceptable to be reused
- * in all related components).
- * @param {object} [options] Additional options.
- * @param {any[]}  [options.deps=[]] An array of dependencies, which trigger
- * data reload when changed. Given dependency changes are watched shallowly
- * (similarly to the standard React's
- * [useEffect()](https://reactjs.org/docs/hooks-reference.html#useeffect)).
- * @param {boolean} [options.noSSR] If `true`, this hook won't load data during
- * server-side rendering.
- * @param {number} [options.garbageCollectAge=maxage] The maximum age of data
- * (in milliseconds), after which they are dropped from the state when the last
- * component referencing them via `useAsyncData()` hook unmounts. Defaults to
- * `maxage` option value.
- * @param {number} [options.maxage=5 x 60 x 1000] The maximum age of
- * data (in milliseconds) acceptable to the hook's caller. If loaded data are
- * older than this value, `null` is returned instead. Defaults to 5 minutes.
- * @param {number} [options.refreshAge=maxage] The maximum age of data
- * (in milliseconds), after which their refreshment will be triggered when
- * any component referencing them via `useAsyncData()` hook (re-)renders.
- * Defaults to `maxage` value.
- * @return {{
- *   data: any,
- *   loading: boolean,
- *   timestamp: number
- * }} Returns an object with three fields: `data` holds the actual result of
- * last `loader` invokation, if any, and if satisfies `maxage` limit; `loading`
- * is a boolean flag, which is `true` if data are being loaded (the hook is
- * waiting for `loader` function resolution); `timestamp` (in milliseconds)
- * is Unix timestamp of related data currently loaded into the global state.
- *
- * Note that loaded data, if any, are stored at the given `path` of global state
- * along with related meta-information, using slightly different state segment
- * structure (see {@link AsyncDataEnvelope}). That segment of the global state
- * can be accessed, and even modified using other hooks,
- * _e.g._ {@link useGlobalState}, but doing so you may interfere with related
- * `useAsyncData()` hooks logic.
- */
-export default function useAsyncData(path, loader) {
-  let options = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
-  let {
-    garbageCollectAge,
-    maxage,
-    refreshAge
-  } = options;
-  if (maxage === undefined) maxage = DEFAULT_MAXAGE;
-  if (refreshAge === undefined) refreshAge = maxage;
-  if (garbageCollectAge === undefined) garbageCollectAge = maxage;
-
-  // Note: here we can't depend on useGlobalState() to init the initial value,
-  // because that way we'll have issues with SSR (see details below).
-  const globalState = getGlobalState();
-  const state = globalState.get(path, {
-    initialValue: {
-      data: null,
-      numRefs: 0,
-      operationId: '',
-      timestamp: 0
-    }
-  });
-  if (globalState.ssrContext && !options.noSSR) {
-    if (!state.timestamp && !state.operationId) {
-      globalState.ssrContext.pending.push(load(path, loader, globalState, state.data, 'S'));
-    }
-  } else {
-    // This takes care about the client-side reference counting, and garbage
-    // collection.
-    //
-    // Note: the Rules of Hook below are violated by conditional call to a hook,
-    // but as the condition is actually server-side or client-side environment,
-    // it is effectively non-conditional at the runtime.
-    //
-    // TODO: Though, maybe there is a way to refactor it into a cleaner code.
-    // The same applies to other useEffect() hooks below.
-    useEffect(() => {
-      // eslint-disable-line react-hooks/rules-of-hooks
-      const numRefsPath = path ? `${path}.numRefs` : 'numRefs';
-      const numRefs = globalState.get(numRefsPath);
-      globalState.set(numRefsPath, numRefs + 1);
-      return () => {
-        const state2 = globalState.get(path);
-        if (state2.numRefs === 1 && garbageCollectAge < Date.now() - state2.timestamp) {
-          if (process.env.NODE_ENV !== 'production' && isDebugMode()) {
-            /* eslint-disable no-console */
-            console.log(`ReactGlobalState - useAsyncData garbage collected at path ${path || ''}`);
-            /* eslint-enable no-console */
-          }
-
-          globalState.set(path, {
-            ...state2,
-            data: null,
-            numRefs: 0,
-            timestamp: 0
-          });
-        } else globalState.set(numRefsPath, state2.numRefs - 1);
-      };
-    }, [garbageCollectAge, globalState, path]);
-
-    // Note: a bunch of Rules of Hooks ignored belows because in our very
-    // special case the otherwise wrong behavior is actually what we need.
-
-    // Data loading and refreshing.
-    let loadTriggered = false;
-    useEffect(() => {
-      // eslint-disable-line react-hooks/rules-of-hooks
-      const state2 = globalState.get(path);
-      if (refreshAge < Date.now() - state2.timestamp && (!state2.operationId || state2.operationId.charAt() === 'S')) {
-        load(path, loader, globalState, state2.data);
-        loadTriggered = true; // eslint-disable-line react-hooks/exhaustive-deps
-      }
-    });
-
-    const deps = options.deps || [];
-    useEffect(() => {
-      // eslint-disable-line react-hooks/rules-of-hooks
-      if (!loadTriggered && deps.length) load(path, loader, globalState);
-    }, deps); // eslint-disable-line react-hooks/exhaustive-deps
-  }
-
-  const [localState] = useGlobalState(path, {
-    data: null,
-    numRefs: 0,
-    operationId: '',
-    timestamp: 0
-  });
-  return {
-    data: maxage < Date.now() - localState.timestamp ? null : localState.data,
-    loading: Boolean(localState.operationId),
-    timestamp: localState.timestamp
-  };
-}
-//# sourceMappingURL=useAsyncData.js.map

package/build/module/useAsyncData.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"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","data","get","state","groupCollapsed","timestamp","Date","now","groupEnd","useAsyncData","options","garbageCollectAge","maxage","refreshAge","undefined","initialValue","numRefs","ssrContext","noSSR","pending","push","numRefsPath","state2","loadTriggered","charAt","deps","length","localState","loading","Boolean"],"sources":["../../src/useAsyncData.js"],"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  // Note: here we can't depend on useGlobalState() to init the initial value,\n  // because that way we'll have issues with SSR (see details below).\n  const globalState = getGlobalState();\n  const state = globalState.get(path, {\n    initialValue: {\n      data: null,\n      numRefs: 0,\n      operationId: '',\n      timestamp: 0,\n    },\n  });\n\n  if (globalState.ssrContext && !options.noSSR) {\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 state2 = globalState.get(path);\n        if (\n          state2.numRefs === 1\n          && garbageCollectAge < Date.now() - state2.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            ...state2,\n            data: null,\n            numRefs: 0,\n            timestamp: 0,\n          });\n        } else globalState.set(numRefsPath, state2.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 state2 = globalState.get(path);\n      if (refreshAge < Date.now() - state2.timestamp\n      && (!state2.operationId || state2.operationId.charAt() === 'S')) {\n        load(path, loader, globalState, state2.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  const [localState] = useGlobalState(path, {\n    data: null,\n    numRefs: 0,\n    operationId: '',\n    timestamp: 0,\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"],"mappings":"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"}

package/build/module/useGlobalState.js

@@ -1,109 +0,0 @@
-// Hook for updates of global state.
-
-import { cloneDeep, isFunction } from 'lodash';
-import { useEffect, useRef, useSyncExternalStore } 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
- * [useState](https://reactjs.org/docs/hooks-reference.html#usestate).
- * It subscribes a component to a given `path` of global state, and provides
- * a function to update it. Each time the value at `path` changes, the hook
- * triggers re-render of its host component.
- *
- * **Note:**
- * - For performance, the library does not copy objects written to / read from
- *   global state paths. You MUST NOT manually mutate returned state values,
- *   or change objects already written into the global state, without explicitly
- *   clonning them first yourself.
- * - State update notifications are asynchronous. When your code does multiple
- *   global state updates in the same React rendering cycle, all state update
- *   notifications are queued and dispatched together, after the current
- *   rendering cycle. In other words, in any given rendering cycle the global
- *   state values are "fixed", and all changes becomes visible at once in the
- *   next triggered rendering pass.
- *
- * @param {string} [path] Dot-delimitered state path. It can be undefined to
- * subscribe for entire state.
- *
- * Under-the-hood state values are read and written using `lodash`
- * [_.get()](https://lodash.com/docs/4.17.15#get) and
- * [_.set()](https://lodash.com/docs/4.17.15#set) methods, thus it is safe
- * to access state paths which have not been created before.
- * @param {any} [initialValue] Initial value to set at the `path`, or its
- * factory:
- * - If a function is given, it will act similar to
- *   [the lazy initial state of the standard React's useState()](https://reactjs.org/docs/hooks-reference.html#lazy-initial-state):
- *   only if the value at `path` is `undefined`, the function will be executed,
- *   and the value it returns will be written to the `path`.
- * - Otherwise, the given value itself will be written to the `path`,
- *   if the current value at `path` is `undefined`.
- * @return {Array} It returs an array with two elements: `[value, setValue]`:
- *
- * - The `value` is the current value at given `path`.
- *
- * - The `setValue()` is setter function to write a new value to the `path`.
- *
- *   Similar to the standard React's `useState()`, it supports
- *   [functional value updates](https://reactjs.org/docs/hooks-reference.html#functional-updates):
- *   if `setValue()` is called with a function as argument, that function will
- *   be called and its return value will be written to `path`. Otherwise,
- *   the argument of `setValue()` itself is written to `path`.
- *
- *   Also, similar to the standard React's state setters, `setValue()` is
- *   stable function: it does not change between component re-renders.
- */
-export default function useGlobalState(path, initialValue) {
-  const ref = useRef();
-  if (!ref.current) {
-    ref.current = {
-      callbacks: [],
-      setter: value => {
-        const rc = ref.current;
-        const newState = isFunction(value) ? value(rc.state) : value;
-        if (process.env.NODE_ENV !== 'production' && isDebugMode()) {
-          /* eslint-disable no-console */
-          console.groupCollapsed(`ReactGlobalState - useGlobalState setter triggered for path ${rc.path || ''}`);
-          console.log('New value:', cloneDeep(newState));
-          console.groupEnd();
-          /* eslint-enable no-console */
-        }
-
-        rc.globalState.set(rc.path, newState);
-      },
-      watcher: () => {
-        const rc = ref.current;
-        const state = rc.globalState.get(rc.path);
-        if (state !== rc.state) {
-          for (let i = 0; i < rc.callbacks.length; ++i) {
-            rc.callbacks[i]();
-          }
-        }
-      }
-    };
-  }
-  const rc = ref.current;
-  const globalState = getGlobalState();
-  rc.globalState = globalState;
-  rc.path = path;
-  rc.state = useSyncExternalStore(cb => {
-    rc.callbacks.push(cb);
-  }, () => rc.globalState.get(rc.path, {
-    initialValue
-  }), () => rc.globalState.get(rc.path, {
-    initialValue,
-    initialState: true
-  }));
-  useEffect(() => {
-    globalState.watch(rc.watcher);
-    rc.watcher();
-    return () => globalState.unWatch(rc.watcher);
-  }, [globalState, rc]);
-  useEffect(() => {
-    rc.watcher();
-  }, [path, rc]);
-  return [rc.state, rc.setter];
-}
-//# sourceMappingURL=useGlobalState.js.map

package/build/module/useGlobalState.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"useGlobalState.js","names":["cloneDeep","isFunction","useEffect","useRef","useSyncExternalStore","getGlobalState","isDebugMode","useGlobalState","path","initialValue","ref","current","callbacks","setter","value","rc","newState","state","process","env","NODE_ENV","console","groupCollapsed","log","groupEnd","globalState","set","watcher","get","i","length","cb","push","initialState","watch","unWatch"],"sources":["../../src/useGlobalState.js"],"sourcesContent":["// Hook for updates of global state.\n\nimport { cloneDeep, isFunction } from 'lodash';\nimport { useEffect, useRef, useSyncExternalStore } 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 ref = useRef();\n  if (!ref.current) {\n    ref.current = {\n      callbacks: [],\n      setter: (value) => {\n        const rc = ref.current;\n        const newState = isFunction(value) ? value(rc.state) : 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              rc.path || ''\n            }`,\n          );\n          console.log('New value:', cloneDeep(newState));\n          console.groupEnd();\n          /* eslint-enable no-console */\n        }\n        rc.globalState.set(rc.path, newState);\n      },\n      watcher: () => {\n        const rc = ref.current;\n        const state = rc.globalState.get(rc.path);\n        if (state !== rc.state) {\n          for (let i = 0; i < rc.callbacks.length; ++i) {\n            rc.callbacks[i]();\n          }\n        }\n      },\n    };\n  }\n\n  const rc = ref.current;\n  const globalState = getGlobalState();\n  rc.globalState = globalState;\n  rc.path = path;\n\n  rc.state = useSyncExternalStore(\n    (cb) => { rc.callbacks.push(cb); },\n    () => rc.globalState.get(rc.path, { initialValue }),\n    () => rc.globalState.get(rc.path, { initialValue, initialState: true }),\n  );\n\n  useEffect(() => {\n    globalState.watch(rc.watcher);\n    rc.watcher();\n    return () => globalState.unWatch(rc.watcher);\n  }, [globalState, rc]);\n\n  useEffect(() => {\n    rc.watcher();\n  }, [path, rc]);\n\n  return [rc.state, rc.setter];\n}\n"],"mappings":"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"}

package/build/module/utils.js

@@ -1,23 +0,0 @@
-// Auxiliary stuff.
-
-/**
- * Returns 'true' if debug logging should be performed; 'false' otherwise.
- *
- * BEWARE: The actual safeguards for the debug logging still should read
- *  if (process.env.NODE_ENV !== 'production' && isDebugMode()) {
- *    // Some debug logging
- *  }
- * to ensure that debug code is stripped out by Webpack in production mode.
- *
- * @returns {boolean}
- * @ignore
- */
-export function isDebugMode() {
-  try {
-    return process.env.NODE_ENV !== 'production' && !!process.env.REACT_GLOBAL_STATE_DEBUG;
-  } catch (error) {
-    return false;
-  }
-}
-export default null;
-//# sourceMappingURL=utils.js.map

package/build/module/utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.js","names":["isDebugMode","process","env","NODE_ENV","REACT_GLOBAL_STATE_DEBUG","error"],"sources":["../../src/utils.js"],"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"],"mappings":"AAAA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASA,WAAW,GAAG;EAC5B,IAAI;IACF,OAAOC,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,IACvC,CAAC,CAACF,OAAO,CAACC,GAAG,CAACE,wBAAwB;EAC7C,CAAC,CAAC,OAAOC,KAAK,EAAE;IACd,OAAO,KAAK;EACd;AACF;AAEA,eAAe,IAAI"}

package/build/node/GlobalState.js

@@ -1,174 +0,0 @@
-"use strict";
-
-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';
-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) {
-    this.#currentState = initialState;
-    this.#initialState = initialState;
-    if (ssrContext) {
-      /* eslint-disable no-param-reassign */
-      ssrContext.dirty = false;
-      ssrContext.pending = [];
-      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';
-      if (ssrContext) msg += ' (SSR mode)';
-      console.groupCollapsed(msg);
-      console.log('Initial state:', (0, _lodash.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, {
-    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
-   * 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' && (0, _utils.isDebugMode)()) {
-        /* eslint-disable no-console */
-        console.groupCollapsed(`ReactGlobalState update. Path: "${path || ''}"`);
-        console.log('New value:', (0, _lodash.cloneDeep)(value));
-        /* eslint-enable no-console */
-      }
-
-      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.#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 (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.
-   * @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 (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 +0,0 @@
-{"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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"}