@dr.pogodin/react-global-state 0.19.3 → 0.20.0

package/build/cjs/useGlobalState.js

@@ -77,72 +77,71 @@ initialValue
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 ) {
   const globalState = (0, _GlobalStateProvider.getGlobalState)();
-  const ref = (0, _react.useRef)(undefined);
-
-  // TODO: Revise how this `rc` variable is used, perhaps we can simplify stuff
-  // here.
-  let rc = ref.current;
-  if (!ref.current) {
+  const ref = (0, _react.useRef)(null);
+  const [stable] = (0, _react.useState)(() => {
     const emitter = new _jsUtils.Emitter();
-    ref.current = {
-      emitter,
-      globalState,
-      path,
-      setter: value => {
-        const newState = (0, _lodash.isFunction)(value) ? value(rc.globalState.get(rc.path)) : value;
-        if (process.env.NODE_ENV !== 'production' && (0, _utils.isDebugMode)()) {
-          /* eslint-disable no-console */
-          console.groupCollapsed(`ReactGlobalState - useGlobalState setter triggered for path ${rc.path ?? ''}`);
-          console.log('New value:', (0, _utils.cloneDeepForLog)(newState, rc.path ?? ''));
-          console.groupEnd();
-          /* eslint-enable no-console */
-        }
-        rc.globalState.set(rc.path, newState);
-
-        // NOTE: The regular global state's update notifications, automatically
-        // triggered by the rc.globalState.set() call above, are batched, and
-        // scheduled to fire asynchronosuly at a later time, which is problematic
-        // for managed text inputs - if they have their value update delayed to
-        // future render cycles, it will result in reset of their cursor position
-        // to the value end. Calling the rc.emitter.emit() below causes a sooner
-        // state update for the current component, thus working around the issue.
-        // For additional details see the original issue:
-        // https://github.com/birdofpreyru/react-global-state/issues/22
-        if (newState !== rc.state) rc.emitter.emit();
-      },
-      state: (0, _lodash.isFunction)(initialValue) ? initialValue() : initialValue,
-      subscribe: emitter.addListener.bind(emitter),
-      watcher: () => {
-        // TODO: Revise it later.
-        // eslint-disable-next-line @typescript-eslint/no-confusing-void-expression
-        const state = rc.globalState.get(rc.path);
-        if (state !== rc.state) rc.emitter.emit();
+    const setter = value => {
+      const rc = ref.current;
+      if (!rc) throw Error('Internal error');
+      const newState = (0, _lodash.isFunction)(value) ? value(rc.globalState.get(rc.path)) : value;
+      if (process.env.NODE_ENV !== 'production' && (0, _utils.isDebugMode)()) {
+        /* eslint-disable no-console */
+        console.groupCollapsed(`ReactGlobalState - useGlobalState setter triggered for path ${rc.path ?? ''}`);
+        console.log('New value:', (0, _utils.cloneDeepForLog)(newState, rc.path ?? ''));
+        console.groupEnd();
+        /* eslint-enable no-console */
       }
+      rc.globalState.set(rc.path, newState);
+
+      // NOTE: The regular global state's update notifications, automatically
+      // triggered by the rc.globalState.set() call above, are batched, and
+      // scheduled to fire asynchronosuly at a later time, which is problematic
+      // for managed text inputs - if they have their value update delayed to
+      // future render cycles, it will result in reset of their cursor position
+      // to the value end. Calling the rc.emitter.emit() below causes a sooner
+      // state update for the current component, thus working around the issue.
+      // For additional details see the original issue:
+      // https://github.com/birdofpreyru/react-global-state/issues/22
+      if (newState !== rc.prevValue) emitter.emit();
+    };
+    const subscribe = emitter.addListener.bind(emitter);
+    return {
+      emitter,
+      setter,
+      subscribe
     };
-  }
-  rc = ref.current;
-  rc.globalState = globalState;
-  rc.path = path;
-  rc.state = (0, _react.useSyncExternalStore)(rc.subscribe, () => rc.globalState.get(rc.path, {
+  });
+  const value = (0, _react.useSyncExternalStore)(stable.subscribe, () => globalState.get(path, {
     initialValue
-  }), () => rc.globalState.get(rc.path, {
+  }), () => globalState.get(path, {
     initialState: true,
     initialValue
   }));
+  ref.current ??= {
+    globalState,
+    path,
+    prevValue: value
+  };
   (0, _react.useEffect)(() => {
-    const {
-      watcher
-    } = ref.current;
+    ref.current = {
+      globalState,
+      path,
+      prevValue: ref.current.prevValue
+    };
+    const watcher = () => {
+      const nextValue = globalState.get(path);
+      if (ref.current.prevValue !== nextValue) {
+        ref.current.prevValue = nextValue;
+        stable.emitter.emit();
+      }
+    };
     globalState.watch(watcher);
     watcher();
     return () => {
       globalState.unWatch(watcher);
     };
-  }, [globalState]);
-  (0, _react.useEffect)(() => {
-    ref.current.watcher();
-  }, [path]);
-  return [rc.state, rc.setter];
+  }, [globalState, stable.emitter, path]);
+  return [value, stable.setter];
 }
 var _default = exports.default = useGlobalState; // TODO: Revise.
 // eslint-disable-next-line @typescript-eslint/consistent-type-definitions

package/build/cjs/useGlobalState.js.map

@@ -1 +1 @@
-{"version":3,"file":"useGlobalState.js","names":["_lodash","require","_react","_jsUtils","_GlobalStateProvider","_utils","useGlobalState","path","initialValue","globalState","getGlobalState","ref","useRef","undefined","rc","current","emitter","Emitter","setter","value","newState","isFunction","get","process","env","NODE_ENV","isDebugMode","console","groupCollapsed","log","cloneDeepForLog","groupEnd","set","state","emit","subscribe","addListener","bind","watcher","useSyncExternalStore","initialState","useEffect","watch","unWatch","_default","exports","default"],"sources":["../../src/useGlobalState.ts"],"sourcesContent":["// Hook for updates of global state.\n\nimport { isFunction } from 'lodash';\n\nimport {\n  type Dispatch,\n  type SetStateAction,\n  useEffect,\n  useRef,\n  useSyncExternalStore,\n} from 'react';\n\nimport { Emitter } from '@dr.pogodin/js-utils';\n\nimport type GlobalState from './GlobalState';\nimport { getGlobalState } from './GlobalStateProvider';\n\nimport {\n  type CallbackT,\n  type ForceT,\n  type LockT,\n  type TypeLock,\n  type ValueAtPathT,\n  type ValueOrInitializerT,\n  cloneDeepForLog,\n  isDebugMode,\n} from './utils';\n\nexport type SetterT<T> = Dispatch<SetStateAction<T>>;\n\ntype ListenerT = () => void;\n\ntype GlobalStateRef = {\n  emitter: Emitter<[]>;\n  globalState: GlobalState<unknown>;\n  path: null | string | undefined;\n  setter: SetterT<unknown>;\n  subscribe: (listener: ListenerT) => () => void;\n  state: unknown;\n  watcher: CallbackT;\n};\n\nexport type UseGlobalStateResT<T> = [T, SetterT<T>];\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 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 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 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 */\n\n// \"Enforced type overload\"\nfunction useGlobalState<\n  Forced extends ForceT | LockT = LockT,\n  ValueT = void,\n>(\n  path: null | string | undefined,\n  initialValue?: ValueOrInitializerT<TypeLock<Forced, never, ValueT>>,\n): UseGlobalStateResT<TypeLock<Forced, void, ValueT>>;\n\n// \"Entire state overload\"\nfunction useGlobalState<StateT>(): UseGlobalStateResT<StateT>;\n\n// \"State evaluation overload\"\nfunction useGlobalState<\n  StateT,\n  PathT extends null | string | undefined,\n>(\n  path: PathT,\n  initialValue: ValueOrInitializerT<\n    Exclude<ValueAtPathT<StateT, PathT, never>, undefined>>\n): UseGlobalStateResT<Exclude<ValueAtPathT<StateT, PathT, void>, undefined>>;\n\nfunction useGlobalState<\n  StateT,\n  PathT extends null | string | undefined,\n>(\n  path: PathT,\n  initialValue?: ValueOrInitializerT<ValueAtPathT<StateT, PathT, never>>\n): UseGlobalStateResT<ValueAtPathT<StateT, PathT, void>>;\n\nfunction useGlobalState(\n  path?: null | string,\n  // TODO: Revise it later!\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  initialValue?: ValueOrInitializerT<any>,\n\n  // TODO: Revise it later!\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n): UseGlobalStateResT<any> {\n  const globalState = getGlobalState();\n\n  const ref = useRef<GlobalStateRef>(undefined);\n\n  // TODO: Revise how this `rc` variable is used, perhaps we can simplify stuff\n  // here.\n  let rc: GlobalStateRef | undefined = ref.current;\n  if (!ref.current) {\n    const emitter = new Emitter();\n    ref.current = {\n      emitter,\n      globalState,\n      path,\n      setter: (value) => {\n        const newState = isFunction(value)\n          ? value(rc!.globalState.get(rc!.path)) as unknown\n          : value;\n\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:', cloneDeepForLog(newState, rc!.path ?? ''));\n          console.groupEnd();\n          /* eslint-enable no-console */\n        }\n        rc!.globalState.set<ForceT, unknown>(rc!.path, newState);\n\n        // NOTE: The regular global state's update notifications, automatically\n        // triggered by the rc.globalState.set() call above, are batched, and\n        // scheduled to fire asynchronosuly at a later time, which is problematic\n        // for managed text inputs - if they have their value update delayed to\n        // future render cycles, it will result in reset of their cursor position\n        // to the value end. Calling the rc.emitter.emit() below causes a sooner\n        // state update for the current component, thus working around the issue.\n        // For additional details see the original issue:\n        // https://github.com/birdofpreyru/react-global-state/issues/22\n        if (newState !== rc!.state) rc!.emitter.emit();\n      },\n      state: isFunction(initialValue) ? initialValue() : initialValue,\n      subscribe: emitter.addListener.bind(emitter),\n      watcher: () => {\n        // TODO: Revise it later.\n        // eslint-disable-next-line @typescript-eslint/no-confusing-void-expression\n        const state = rc!.globalState.get(rc!.path) as unknown;\n        if (state !== rc!.state) rc!.emitter.emit();\n      },\n    };\n  }\n  rc = ref.current!;\n\n  rc.globalState = globalState;\n  rc.path = path;\n\n  rc.state = useSyncExternalStore(\n    rc.subscribe,\n    () => rc.globalState.get<ForceT, unknown>(rc.path, { initialValue }),\n\n    () => rc.globalState.get<ForceT, unknown>(\n      rc.path,\n      { initialState: true, initialValue },\n    ),\n  );\n\n  useEffect(() => {\n    const { watcher } = ref.current!;\n    globalState.watch(watcher);\n    watcher();\n    return () => {\n      globalState.unWatch(watcher);\n    };\n  }, [globalState]);\n\n  useEffect(() => {\n    ref.current!.watcher();\n  }, [path]);\n\n  return [rc.state, rc.setter];\n}\n\nexport default useGlobalState;\n\n// TODO: Revise.\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\nexport interface UseGlobalStateI<StateT> {\n  (): UseGlobalStateResT<StateT>;\n\n  <PathT extends null | string | undefined>(\n    path: PathT,\n    initialValue: ValueOrInitializerT<\n      Exclude<ValueAtPathT<StateT, PathT, never>, undefined>>\n  ): UseGlobalStateResT<Exclude<ValueAtPathT<StateT, PathT, void>, undefined>>;\n\n  <PathT extends null | string | undefined>(\n    path: PathT,\n    initialValue?: ValueOrInitializerT<ValueAtPathT<StateT, PathT, never>>\n  ): UseGlobalStateResT<ValueAtPathT<StateT, PathT, void>>;\n\n  <Forced extends ForceT | LockT = LockT, ValueT = unknown>(\n    path: null | string | undefined,\n    initialValue?: ValueOrInitializerT<TypeLock<Forced, never, ValueT>>,\n  ): UseGlobalStateResT<TypeLock<Forced, void, ValueT>>;\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"useGlobalState.js","names":["_lodash","require","_react","_jsUtils","_GlobalStateProvider","_utils","useGlobalState","path","initialValue","globalState","getGlobalState","ref","useRef","stable","useState","emitter","Emitter","setter","value","rc","current","Error","newState","isFunction","get","process","env","NODE_ENV","isDebugMode","console","groupCollapsed","log","cloneDeepForLog","groupEnd","set","prevValue","emit","subscribe","addListener","bind","useSyncExternalStore","initialState","useEffect","watcher","nextValue","watch","unWatch","_default","exports","default"],"sources":["../../src/useGlobalState.ts"],"sourcesContent":["// Hook for updates of global state.\n\nimport { isFunction } from 'lodash';\n\nimport {\n  type Dispatch,\n  type SetStateAction,\n  useEffect,\n  useRef,\n  useState,\n  useSyncExternalStore,\n} from 'react';\n\nimport { Emitter } from '@dr.pogodin/js-utils';\n\nimport type GlobalState from './GlobalState';\nimport { getGlobalState } from './GlobalStateProvider';\n\nimport {\n  type ForceT,\n  type LockT,\n  type TypeLock,\n  type ValueAtPathT,\n  type ValueOrInitializerT,\n  cloneDeepForLog,\n  isDebugMode,\n} from './utils';\n\nexport type SetterT<T> = Dispatch<SetStateAction<T>>;\n\ntype ListenerT = () => void;\n\ntype CurrentT = {\n  globalState: GlobalState<unknown>;\n  path: null | string | undefined;\n  prevValue: unknown;\n};\n\ntype StableT = {\n  emitter: Emitter<[]>;\n  setter: SetterT<unknown>;\n  subscribe: (listener: ListenerT) => () => void;\n};\n\nexport type UseGlobalStateResT<T> = [T, SetterT<T>];\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 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 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 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 */\n\n// \"Enforced type overload\"\nfunction useGlobalState<\n  Forced extends ForceT | LockT = LockT,\n  ValueT = void,\n>(\n  path: null | string | undefined,\n  initialValue?: ValueOrInitializerT<TypeLock<Forced, never, ValueT>>,\n): UseGlobalStateResT<TypeLock<Forced, void, ValueT>>;\n\n// \"Entire state overload\"\nfunction useGlobalState<StateT>(): UseGlobalStateResT<StateT>;\n\n// \"State evaluation overload\"\nfunction useGlobalState<\n  StateT,\n  PathT extends null | string | undefined,\n>(\n  path: PathT,\n  initialValue: ValueOrInitializerT<\n    Exclude<ValueAtPathT<StateT, PathT, never>, undefined>>\n): UseGlobalStateResT<Exclude<ValueAtPathT<StateT, PathT, void>, undefined>>;\n\nfunction useGlobalState<\n  StateT,\n  PathT extends null | string | undefined,\n>(\n  path: PathT,\n  initialValue?: ValueOrInitializerT<ValueAtPathT<StateT, PathT, never>>\n): UseGlobalStateResT<ValueAtPathT<StateT, PathT, void>>;\n\nfunction useGlobalState(\n  path?: null | string,\n  // TODO: Revise it later!\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  initialValue?: ValueOrInitializerT<any>,\n\n  // TODO: Revise it later!\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n): UseGlobalStateResT<any> {\n  const globalState = getGlobalState();\n\n  const ref = useRef<CurrentT>(null);\n\n  const [stable] = useState<StableT>(() => {\n    const emitter = new Emitter();\n    const setter = (value: unknown) => {\n      const rc = ref.current;\n      if (!rc) throw Error('Internal error');\n\n      const newState = isFunction(value)\n        ? value(rc.globalState.get(rc.path)) as unknown\n        : value;\n\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:', cloneDeepForLog(newState, rc.path ?? ''));\n        console.groupEnd();\n        /* eslint-enable no-console */\n      }\n      rc.globalState.set<ForceT, unknown>(rc.path, newState);\n\n      // NOTE: The regular global state's update notifications, automatically\n      // triggered by the rc.globalState.set() call above, are batched, and\n      // scheduled to fire asynchronosuly at a later time, which is problematic\n      // for managed text inputs - if they have their value update delayed to\n      // future render cycles, it will result in reset of their cursor position\n      // to the value end. Calling the rc.emitter.emit() below causes a sooner\n      // state update for the current component, thus working around the issue.\n      // For additional details see the original issue:\n      // https://github.com/birdofpreyru/react-global-state/issues/22\n      if (newState !== rc.prevValue) emitter.emit();\n    };\n    const subscribe = emitter.addListener.bind(emitter);\n    return { emitter, setter, subscribe };\n  });\n\n  const value = useSyncExternalStore(\n    stable.subscribe,\n    () => globalState.get<ForceT, unknown>(path, { initialValue }),\n\n    () => globalState.get<ForceT, unknown>(\n      path,\n      { initialState: true, initialValue },\n    ),\n  );\n\n  ref.current ??= {\n    globalState,\n    path,\n    prevValue: value,\n  };\n\n  useEffect(() => {\n    ref.current = {\n      globalState,\n      path,\n      prevValue: ref.current!.prevValue,\n    };\n\n    const watcher = () => {\n      const nextValue = globalState.get<ForceT, unknown>(path);\n      if (ref.current!.prevValue !== nextValue) {\n        ref.current!.prevValue = nextValue;\n        stable.emitter.emit();\n      }\n    };\n\n    globalState.watch(watcher);\n    watcher();\n\n    return () => {\n      globalState.unWatch(watcher);\n    };\n  }, [globalState, stable.emitter, path]);\n\n  return [value, stable.setter];\n}\n\nexport default useGlobalState;\n\n// TODO: Revise.\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\nexport interface UseGlobalStateI<StateT> {\n  (): UseGlobalStateResT<StateT>;\n\n  <PathT extends null | string | undefined>(\n    path: PathT,\n    initialValue: ValueOrInitializerT<\n      Exclude<ValueAtPathT<StateT, PathT, never>, undefined>>\n  ): UseGlobalStateResT<Exclude<ValueAtPathT<StateT, PathT, void>, undefined>>;\n\n  <PathT extends null | string | undefined>(\n    path: PathT,\n    initialValue?: ValueOrInitializerT<ValueAtPathT<StateT, PathT, never>>\n  ): UseGlobalStateResT<ValueAtPathT<StateT, PathT, void>>;\n\n  <Forced extends ForceT | LockT = LockT, ValueT = unknown>(\n    path: null | string | undefined,\n    initialValue?: ValueOrInitializerT<TypeLock<Forced, never, ValueT>>,\n  ): UseGlobalStateResT<TypeLock<Forced, void, ValueT>>;\n}\n"],"mappings":"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","ignoreList":[]}

package/build/code/GlobalStateProvider.js

@@ -1,5 +1,5 @@
 import { isFunction } from 'lodash';
-import { createContext, use, useRef } from 'react';
+import { createContext, use, useState } from 'react';
 import GlobalState from "./GlobalState";
 import { jsx as _jsx } from "react/jsx-runtime";
 const Context = /*#__PURE__*/createContext(null);
@@ -62,22 +62,25 @@ const GlobalStateProvider = ({
   children,
   ...rest
 }) => {
-  const localStateRef = useRef(undefined);
+  const [localState, setLocalState] = useState();
   let state;
-  // TODO: Revise.
-  // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+
+  // Below we cast `rest.stateProxy` as "boolean" for safe backward
+  // compatibility with plain JavaScript (as TypeScript typings only
+  // permit "true" or GlobalState value; while legacy codebase may
+  // pass in a boolean value here, occasionally equal "false").
   if ('stateProxy' in rest && rest.stateProxy) {
-    localStateRef.current = undefined;
+    if (localState) setLocalState(undefined);
     state = rest.stateProxy === true ? getGlobalState() : rest.stateProxy;
+  } else if (localState) {
+    state = localState;
   } else {
-    if (!localStateRef.current) {
-      const {
-        initialState,
-        ssrContext
-      } = rest;
-      localStateRef.current = new GlobalState(isFunction(initialState) ? initialState() : initialState, ssrContext);
-    }
-    state = localStateRef.current;
+    const {
+      initialState,
+      ssrContext
+    } = rest;
+    state = new GlobalState(isFunction(initialState) ? initialState() : initialState, ssrContext);
+    setLocalState(state);
   }
   return /*#__PURE__*/_jsx(Context, {
     value: state,

package/build/code/GlobalStateProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"GlobalStateProvider.js","names":["isFunction","createContext","use","useRef","GlobalState","jsx","_jsx","Context","getGlobalState","globalState","Error","getSsrContext","throwWithoutSsrContext","ssrContext","GlobalStateProvider","children","rest","localStateRef","undefined","state","stateProxy","current","initialState","value"],"sources":["../../src/GlobalStateProvider.tsx"],"sourcesContent":["import { isFunction } from 'lodash';\n\nimport {\n  type ReactNode,\n  createContext,\n  use,\n  useRef,\n} from 'react';\n\nimport GlobalState from './GlobalState';\nimport type SsrContext from './SsrContext';\n\nimport type { ValueOrInitializerT } from './utils';\n\nconst Context = createContext<GlobalState<unknown> | null>(null);\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\n */\nexport function getGlobalState<\n  StateT,\n  SsrContextT extends SsrContext<StateT> = SsrContext<StateT>,\n>(): GlobalState<StateT, SsrContextT> {\n  // TODO: Think about it: on one hand we on purpose called this function\n  // as getGlobalState(), so that ppl looking for the state hook prefer using\n  // useGlobalState(), while this getGlobalState() is reserved for nieche cases;\n  // on the other hand, perhaps we can rename it into useSomething, to both\n  // follow conventions, and to keep stuff clearly named at the same time.\n  // eslint-disable-next-line react-hooks/rules-of-hooks\n  const globalState = use(Context);\n  if (!globalState) throw new Error('Missing GlobalStateProvider');\n  return globalState as GlobalState<StateT, SsrContextT>;\n}\n\n/**\n * @category Hooks\n * @desc Gets SSR context.\n * @param throwWithoutSsrContext 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 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<\n  SsrContextT extends SsrContext<unknown>,\n>(\n  throwWithoutSsrContext = true,\n): SsrContextT | undefined {\n  const { ssrContext } = getGlobalState<SsrContextT['state'], SsrContextT>();\n  if (!ssrContext && throwWithoutSsrContext) {\n    throw new Error('No SSR context found');\n  }\n  return ssrContext;\n}\n\ntype NewStateProps<StateT, SsrContextT extends SsrContext<StateT>> = {\n  initialState: ValueOrInitializerT<StateT>;\n  ssrContext?: SsrContextT;\n};\n\ntype GlobalStateProviderProps<\n  StateT,\n  SsrContextT extends SsrContext<StateT>,\n> = {\n  children?: ReactNode;\n} & (NewStateProps<StateT, SsrContextT> | {\n  stateProxy: true | GlobalState<StateT, SsrContextT>;\n});\n\n/**\n * Provides global state to its children.\n * @param prop.children Component children, which will be provided with\n * the global state, and rendered in place of the provider.\n * @param prop.initialState Initial content of the global state.\n * @param prop.ssrContext Server-side rendering (SSR) context.\n * @param prop.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 */\nconst GlobalStateProvider = <\n  StateT,\n  SsrContextT extends SsrContext<StateT> = SsrContext<StateT>,\n>(\n  { children, ...rest }: GlobalStateProviderProps<StateT, SsrContextT>,\n): ReactNode => {\n  type GST = GlobalState<StateT, SsrContextT>;\n  const localStateRef = useRef<GST>(undefined);\n  let state: GST;\n  // TODO: Revise.\n  // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n  if ('stateProxy' in rest && rest.stateProxy) {\n    localStateRef.current = undefined;\n    state = rest.stateProxy === true ? getGlobalState() : rest.stateProxy;\n  } else {\n    if (!localStateRef.current) {\n      const {\n        initialState,\n        ssrContext,\n      } = rest as NewStateProps<StateT, SsrContextT>;\n      localStateRef.current = new GlobalState(\n        isFunction(initialState) ? initialState() : initialState,\n        ssrContext,\n      );\n    }\n    state = localStateRef.current;\n  }\n  return <Context value={state}>{children}</Context>;\n};\n\nexport default GlobalStateProvider;\n"],"mappings":"AAAA,SAASA,UAAU,QAAQ,QAAQ;AAEnC,SAEEC,aAAa,EACbC,GAAG,EACHC,MAAM,QACD,OAAO;AAEd,OAAOC,WAAW;AAAsB,SAAAC,GAAA,IAAAC,IAAA;AAKxC,MAAMC,OAAO,gBAAGN,aAAa,CAA8B,IAAI,CAAC;;AAEhE;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASO,cAAcA,CAAA,EAGQ;EACpC;EACA;EACA;EACA;EACA;EACA;EACA,MAAMC,WAAW,GAAGP,GAAG,CAACK,OAAO,CAAC;EAChC,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,CAG3BC,sBAAsB,GAAG,IAAI,EACJ;EACzB,MAAM;IAAEC;EAAW,CAAC,GAAGL,cAAc,CAAoC,CAAC;EAC1E,IAAI,CAACK,UAAU,IAAID,sBAAsB,EAAE;IACzC,MAAM,IAAIF,KAAK,CAAC,sBAAsB,CAAC;EACzC;EACA,OAAOG,UAAU;AACnB;AAgBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,mBAAmB,GAAGA,CAI1B;EAAEC,QAAQ;EAAE,GAAGC;AAAoD,CAAC,KACtD;EAEd,MAAMC,aAAa,GAAGd,MAAM,CAAMe,SAAS,CAAC;EAC5C,IAAIC,KAAU;EACd;EACA;EACA,IAAI,YAAY,IAAIH,IAAI,IAAIA,IAAI,CAACI,UAAU,EAAE;IAC3CH,aAAa,CAACI,OAAO,GAAGH,SAAS;IACjCC,KAAK,GAAGH,IAAI,CAACI,UAAU,KAAK,IAAI,GAAGZ,cAAc,CAAC,CAAC,GAAGQ,IAAI,CAACI,UAAU;EACvE,CAAC,MAAM;IACL,IAAI,CAACH,aAAa,CAACI,OAAO,EAAE;MAC1B,MAAM;QACJC,YAAY;QACZT;MACF,CAAC,GAAGG,IAA0C;MAC9CC,aAAa,CAACI,OAAO,GAAG,IAAIjB,WAAW,CACrCJ,UAAU,CAACsB,YAAY,CAAC,GAAGA,YAAY,CAAC,CAAC,GAAGA,YAAY,EACxDT,UACF,CAAC;IACH;IACAM,KAAK,GAAGF,aAAa,CAACI,OAAO;EAC/B;EACA,oBAAOf,IAAA,CAACC,OAAO;IAACgB,KAAK,EAAEJ,KAAM;IAAAJ,QAAA,EAAEA;EAAQ,CAAU,CAAC;AACpD,CAAC;AAED,eAAeD,mBAAmB","ignoreList":[]}
+{"version":3,"file":"GlobalStateProvider.js","names":["isFunction","createContext","use","useState","GlobalState","jsx","_jsx","Context","getGlobalState","globalState","Error","getSsrContext","throwWithoutSsrContext","ssrContext","GlobalStateProvider","children","rest","localState","setLocalState","state","stateProxy","undefined","initialState","value"],"sources":["../../src/GlobalStateProvider.tsx"],"sourcesContent":["import { isFunction } from 'lodash';\n\nimport {\n  type ReactNode,\n  createContext,\n  use,\n  useState,\n} from 'react';\n\nimport GlobalState from './GlobalState';\nimport type SsrContext from './SsrContext';\n\nimport type { ValueOrInitializerT } from './utils';\n\nconst Context = createContext<GlobalState<unknown> | null>(null);\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\n */\nexport function getGlobalState<\n  StateT,\n  SsrContextT extends SsrContext<StateT> = SsrContext<StateT>,\n>(): GlobalState<StateT, SsrContextT> {\n  // TODO: Think about it: on one hand we on purpose called this function\n  // as getGlobalState(), so that ppl looking for the state hook prefer using\n  // useGlobalState(), while this getGlobalState() is reserved for nieche cases;\n  // on the other hand, perhaps we can rename it into useSomething, to both\n  // follow conventions, and to keep stuff clearly named at the same time.\n  // eslint-disable-next-line react-hooks/rules-of-hooks\n  const globalState = use(Context);\n  if (!globalState) throw new Error('Missing GlobalStateProvider');\n  return globalState as GlobalState<StateT, SsrContextT>;\n}\n\n/**\n * @category Hooks\n * @desc Gets SSR context.\n * @param throwWithoutSsrContext 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 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<\n  SsrContextT extends SsrContext<unknown>,\n>(\n  throwWithoutSsrContext = true,\n): SsrContextT | undefined {\n  const { ssrContext } = getGlobalState<SsrContextT['state'], SsrContextT>();\n  if (!ssrContext && throwWithoutSsrContext) {\n    throw new Error('No SSR context found');\n  }\n  return ssrContext;\n}\n\ntype NewStateProps<StateT, SsrContextT extends SsrContext<StateT>> = {\n  initialState: ValueOrInitializerT<StateT>;\n  ssrContext?: SsrContextT;\n};\n\ntype GlobalStateProviderProps<\n  StateT,\n  SsrContextT extends SsrContext<StateT>,\n> = {\n  children?: ReactNode;\n} & (NewStateProps<StateT, SsrContextT> | {\n  stateProxy: true | GlobalState<StateT, SsrContextT>;\n});\n\n/**\n * Provides global state to its children.\n * @param prop.children Component children, which will be provided with\n * the global state, and rendered in place of the provider.\n * @param prop.initialState Initial content of the global state.\n * @param prop.ssrContext Server-side rendering (SSR) context.\n * @param prop.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 */\nconst GlobalStateProvider = <\n  StateT,\n  SsrContextT extends SsrContext<StateT> = SsrContext<StateT>,\n>(\n  { children, ...rest }: GlobalStateProviderProps<StateT, SsrContextT>,\n): ReactNode => {\n  type GST = GlobalState<StateT, SsrContextT>;\n\n  const [localState, setLocalState] = useState<GST>();\n\n  let state: GST;\n\n  // Below we cast `rest.stateProxy` as \"boolean\" for safe backward\n  // compatibility with plain JavaScript (as TypeScript typings only\n  // permit \"true\" or GlobalState value; while legacy codebase may\n  // pass in a boolean value here, occasionally equal \"false\").\n  if ('stateProxy' in rest && (rest.stateProxy as boolean)) {\n    if (localState) setLocalState(undefined);\n    state = rest.stateProxy === true ? getGlobalState() : rest.stateProxy;\n  } else if (localState) {\n    state = localState;\n  } else {\n    const {\n      initialState,\n      ssrContext,\n    } = rest as NewStateProps<StateT, SsrContextT>;\n\n    state = new GlobalState(\n      isFunction(initialState) ? initialState() : initialState,\n      ssrContext,\n    );\n\n    setLocalState(state);\n  }\n\n  return <Context value={state}>{children}</Context>;\n};\n\nexport default GlobalStateProvider;\n"],"mappings":"AAAA,SAASA,UAAU,QAAQ,QAAQ;AAEnC,SAEEC,aAAa,EACbC,GAAG,EACHC,QAAQ,QACH,OAAO;AAEd,OAAOC,WAAW;AAAsB,SAAAC,GAAA,IAAAC,IAAA;AAKxC,MAAMC,OAAO,gBAAGN,aAAa,CAA8B,IAAI,CAAC;;AAEhE;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASO,cAAcA,CAAA,EAGQ;EACpC;EACA;EACA;EACA;EACA;EACA;EACA,MAAMC,WAAW,GAAGP,GAAG,CAACK,OAAO,CAAC;EAChC,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,CAG3BC,sBAAsB,GAAG,IAAI,EACJ;EACzB,MAAM;IAAEC;EAAW,CAAC,GAAGL,cAAc,CAAoC,CAAC;EAC1E,IAAI,CAACK,UAAU,IAAID,sBAAsB,EAAE;IACzC,MAAM,IAAIF,KAAK,CAAC,sBAAsB,CAAC;EACzC;EACA,OAAOG,UAAU;AACnB;AAgBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,mBAAmB,GAAGA,CAI1B;EAAEC,QAAQ;EAAE,GAAGC;AAAoD,CAAC,KACtD;EAGd,MAAM,CAACC,UAAU,EAAEC,aAAa,CAAC,GAAGf,QAAQ,CAAM,CAAC;EAEnD,IAAIgB,KAAU;;EAEd;EACA;EACA;EACA;EACA,IAAI,YAAY,IAAIH,IAAI,IAAKA,IAAI,CAACI,UAAsB,EAAE;IACxD,IAAIH,UAAU,EAAEC,aAAa,CAACG,SAAS,CAAC;IACxCF,KAAK,GAAGH,IAAI,CAACI,UAAU,KAAK,IAAI,GAAGZ,cAAc,CAAC,CAAC,GAAGQ,IAAI,CAACI,UAAU;EACvE,CAAC,MAAM,IAAIH,UAAU,EAAE;IACrBE,KAAK,GAAGF,UAAU;EACpB,CAAC,MAAM;IACL,MAAM;MACJK,YAAY;MACZT;IACF,CAAC,GAAGG,IAA0C;IAE9CG,KAAK,GAAG,IAAIf,WAAW,CACrBJ,UAAU,CAACsB,YAAY,CAAC,GAAGA,YAAY,CAAC,CAAC,GAAGA,YAAY,EACxDT,UACF,CAAC;IAEDK,aAAa,CAACC,KAAK,CAAC;EACtB;EAEA,oBAAOb,IAAA,CAACC,OAAO;IAACgB,KAAK,EAAEJ,KAAM;IAAAJ,QAAA,EAAEA;EAAQ,CAAU,CAAC;AACpD,CAAC;AAED,eAAeD,mBAAmB","ignoreList":[]}

package/build/code/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["GlobalState","GlobalStateProvider","getGlobalState","getSsrContext","SsrContext","useAsyncCollection","newAsyncDataEnvelope","useAsyncData","useGlobalState","api","withGlobalStateType"],"sources":["../../src/index.ts"],"sourcesContent":["import GlobalState from './GlobalState';\n\nimport GlobalStateProvider, {\n  getGlobalState,\n  getSsrContext,\n} from './GlobalStateProvider';\n\nimport SsrContext from './SsrContext';\n\nimport useAsyncCollection, {\n  type UseAsyncCollectionI,\n  type UseAsyncCollectionResT,\n} from './useAsyncCollection';\n\nimport {\n  type AsyncDataEnvelopeT,\n  type AsyncDataLoaderT,\n  type AsyncDataReloaderT,\n  type UseAsyncDataI,\n  type UseAsyncDataOptionsT,\n  type UseAsyncDataResT,\n  newAsyncDataEnvelope,\n  useAsyncData,\n} from './useAsyncData';\n\nimport useGlobalState, { type UseGlobalStateI } from './useGlobalState';\n\nexport type { AsyncCollectionLoaderT, AsyncCollectionT } from './useAsyncCollection';\n\nexport type { SetterT, UseGlobalStateResT } from './useGlobalState';\n\nexport type { ForceT, ValueOrInitializerT } from './utils';\n\nexport {\n  type AsyncDataEnvelopeT,\n  type AsyncDataLoaderT,\n  type AsyncDataReloaderT,\n  type UseAsyncCollectionResT,\n  type UseAsyncDataOptionsT,\n  type UseAsyncDataResT,\n  getGlobalState,\n  getSsrContext,\n  GlobalState,\n  GlobalStateProvider,\n  newAsyncDataEnvelope,\n  SsrContext,\n  useAsyncCollection,\n  useAsyncData,\n  useGlobalState,\n};\n\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\ninterface API<\n  StateT,\n  SsrContextT extends SsrContext<StateT> = SsrContext<StateT>,\n> {\n  getGlobalState: typeof getGlobalState<StateT, SsrContextT>;\n  getSsrContext: typeof getSsrContext<SsrContextT>;\n  GlobalState: typeof GlobalState<StateT, SsrContextT>;\n  GlobalStateProvider: typeof GlobalStateProvider<StateT, SsrContextT>;\n  newAsyncDataEnvelope: typeof newAsyncDataEnvelope;\n  SsrContext: typeof SsrContext<StateT>;\n  useAsyncCollection: UseAsyncCollectionI<StateT>;\n  useAsyncData: UseAsyncDataI<StateT>;\n  useGlobalState: UseGlobalStateI<StateT>;\n}\n\nconst api = {\n  // TODO: I am puzzled, why ESLint eforces this sorting order as alphabetical?\n  // Perhaps, we should tune something in its config settings, as it seems to mix\n  // some extra sorting logic, which I am not sure I like.\n  GlobalState,\n  GlobalStateProvider,\n  SsrContext,\n  getGlobalState,\n  getSsrContext,\n  newAsyncDataEnvelope,\n  useAsyncCollection,\n  useAsyncData,\n  useGlobalState,\n};\n\nexport function withGlobalStateType<\n  StateT,\n  SsrContextT extends SsrContext<StateT> = SsrContext<StateT>,\n>(): API<StateT, SsrContextT> {\n  return api as API<StateT, SsrContextT>;\n}\n"],"mappings":"AAAA,OAAOA,WAAW;AAElB,OAAOC,mBAAmB,IACxBC,cAAc,EACdC,aAAa;AAGf,OAAOC,UAAU;AAEjB,OAAOC,kBAAkB;AAKzB,SAOEC,oBAAoB,EACpBC,YAAY;AAGd,OAAOC,cAAc;AAQrB,SAOEN,cAAc,EACdC,aAAa,EACbH,WAAW,EACXC,mBAAmB,EACnBK,oBAAoB,EACpBF,UAAU,EACVC,kBAAkB,EAClBE,YAAY,EACZC,cAAc;;AAGhB;;AAgBA,MAAMC,GAAG,GAAG;EACV;EACA;EACA;EACAT,WAAW;EACXC,mBAAmB;EACnBG,UAAU;EACVF,cAAc;EACdC,aAAa;EACbG,oBAAoB;EACpBD,kBAAkB;EAClBE,YAAY;EACZC;AACF,CAAC;AAED,OAAO,SAASE,mBAAmBA,CAAA,EAGL;EAC5B,OAAOD,GAAG;AACZ","ignoreList":[]}
+{"version":3,"file":"index.js","names":["GlobalState","GlobalStateProvider","getGlobalState","getSsrContext","SsrContext","useAsyncCollection","newAsyncDataEnvelope","useAsyncData","useGlobalState","api","withGlobalStateType"],"sources":["../../src/index.ts"],"sourcesContent":["import GlobalState from './GlobalState';\n\nimport GlobalStateProvider, {\n  getGlobalState,\n  getSsrContext,\n} from './GlobalStateProvider';\n\nimport SsrContext from './SsrContext';\n\nimport useAsyncCollection, {\n  type UseAsyncCollectionI,\n  type UseAsyncCollectionResT,\n} from './useAsyncCollection';\n\nimport {\n  type AsyncDataEnvelopeT,\n  type AsyncDataLoaderT,\n  type AsyncDataReloaderT,\n  type UseAsyncDataI,\n  type UseAsyncDataOptionsT,\n  type UseAsyncDataResT,\n  newAsyncDataEnvelope,\n  useAsyncData,\n} from './useAsyncData';\n\nimport useGlobalState, { type UseGlobalStateI } from './useGlobalState';\n\nexport type {\n  AsyncCollectionLoaderT,\n  AsyncCollectionReloaderT,\n  AsyncCollectionT,\n} from './useAsyncCollection';\n\nexport type { SetterT, UseGlobalStateResT } from './useGlobalState';\n\nexport type { ForceT, ValueOrInitializerT } from './utils';\n\nexport {\n  type AsyncDataEnvelopeT,\n  type AsyncDataLoaderT,\n  type AsyncDataReloaderT,\n  type UseAsyncCollectionResT,\n  type UseAsyncDataOptionsT,\n  type UseAsyncDataResT,\n  getGlobalState,\n  getSsrContext,\n  GlobalState,\n  GlobalStateProvider,\n  newAsyncDataEnvelope,\n  SsrContext,\n  useAsyncCollection,\n  useAsyncData,\n  useGlobalState,\n};\n\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\ninterface API<\n  StateT,\n  SsrContextT extends SsrContext<StateT> = SsrContext<StateT>,\n> {\n  getGlobalState: typeof getGlobalState<StateT, SsrContextT>;\n  getSsrContext: typeof getSsrContext<SsrContextT>;\n  GlobalState: typeof GlobalState<StateT, SsrContextT>;\n  GlobalStateProvider: typeof GlobalStateProvider<StateT, SsrContextT>;\n  newAsyncDataEnvelope: typeof newAsyncDataEnvelope;\n  SsrContext: typeof SsrContext<StateT>;\n  useAsyncCollection: UseAsyncCollectionI<StateT>;\n  useAsyncData: UseAsyncDataI<StateT>;\n  useGlobalState: UseGlobalStateI<StateT>;\n}\n\nconst api = {\n  // TODO: I am puzzled, why ESLint eforces this sorting order as alphabetical?\n  // Perhaps, we should tune something in its config settings, as it seems to mix\n  // some extra sorting logic, which I am not sure I like.\n  GlobalState,\n  GlobalStateProvider,\n  SsrContext,\n  getGlobalState,\n  getSsrContext,\n  newAsyncDataEnvelope,\n  useAsyncCollection,\n  useAsyncData,\n  useGlobalState,\n};\n\nexport function withGlobalStateType<\n  StateT,\n  SsrContextT extends SsrContext<StateT> = SsrContext<StateT>,\n>(): API<StateT, SsrContextT> {\n  return api as API<StateT, SsrContextT>;\n}\n"],"mappings":"AAAA,OAAOA,WAAW;AAElB,OAAOC,mBAAmB,IACxBC,cAAc,EACdC,aAAa;AAGf,OAAOC,UAAU;AAEjB,OAAOC,kBAAkB;AAKzB,SAOEC,oBAAoB,EACpBC,YAAY;AAGd,OAAOC,cAAc;AAYrB,SAOEN,cAAc,EACdC,aAAa,EACbH,WAAW,EACXC,mBAAmB,EACnBK,oBAAoB,EACpBF,UAAU,EACVC,kBAAkB,EAClBE,YAAY,EACZC,cAAc;;AAGhB;;AAgBA,MAAMC,GAAG,GAAG;EACV;EACA;EACA;EACAT,WAAW;EACXC,mBAAmB;EACnBG,UAAU;EACVF,cAAc;EACdC,aAAa;EACbG,oBAAoB;EACpBD,kBAAkB;EAClBE,YAAY;EACZC;AACF,CAAC;AAED,OAAO,SAASE,mBAAmBA,CAAA,EAGL;EAC5B,OAAOD,GAAG;AACZ","ignoreList":[]}

package/build/code/useAsyncCollection.js

@@ -2,7 +2,7 @@
  * Loads and uses item(s) in an async collection.
  */
 
-import { useEffect, useRef } from 'react';
+import { useEffect, useRef, useState } from 'react';
 import { v4 as uuid } from 'uuid';
 import { getGlobalState } from "./GlobalStateProvider";
 import { DEFAULT_MAXAGE, load, newAsyncDataEnvelope } from "./useAsyncData";
@@ -82,68 +82,6 @@ function normalizeIds(idOrIds) {
   return [idOrIds];
 }
 
-/**
- * Inits/updates, and returns the heap.
- */
-function useHeap(ids, path, loader, gs) {
-  const ref = useRef(undefined);
-  let heap = ref.current;
-  if (heap) {
-    // Update.
-    heap.ids = ids;
-    heap.path = path;
-    heap.loader = loader;
-    heap.globalState = gs;
-  } else {
-    // Initialization.
-    const reload = async customLoader => {
-      const heap2 = ref.current;
-      const localLoader = customLoader !== null && customLoader !== void 0 ? customLoader : heap2.loader;
-      // TODO: Revise - not sure all related typing is 100% correct,
-      // thus let's keep this runtime assertion.
-      // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
-      if (!localLoader || !heap2.globalState || !heap2.ids) {
-        throw Error('Internal error');
-      }
-      for (const id of heap2.ids) {
-        const itemPath = heap2.path ? `${heap2.path}.${id}` : `${id}`;
-        const promiseOrVoid = load(itemPath,
-        // TODO: Revise! Most probably we don't have fully correct loader
-        // typing, as it may return either promise or value, and those two
-        // cases call for different runtime behavior, which in turns only
-        // happens if the outer function on the next line matches the same
-        // async / sync signature.
-        // eslint-disable-next-line @typescript-eslint/promise-function-async
-        (oldData, meta) => localLoader(id, oldData, meta), heap2.globalState);
-        if (promiseOrVoid instanceof Promise) await promiseOrVoid;
-      }
-    };
-    heap = {
-      globalState: gs,
-      ids,
-      loader,
-      path,
-      reload,
-      // TODO: Revise! Most probably we don't have fully correct loader
-      // typing, as it may return either promise or value, and those two
-      // cases call for different runtime behavior, which in turns only
-      // happens if the outer function on the next line matches the same
-      // async / sync signature.
-      // eslint-disable-next-line @typescript-eslint/promise-function-async
-      reloadSingle: customLoader => ref.current.reload(
-      // TODO: Revise! Most probably we don't have fully correct loader
-      // typing, as it may return either promise or value, and those two
-      // cases call for different runtime behavior, which in turns only
-      // happens if the outer function on the next line matches the same
-      // async / sync signature.
-      // eslint-disable-next-line @typescript-eslint/promise-function-async
-      customLoader && ((id, ...args) => customLoader(...args)))
-    };
-    ref.current = heap;
-  }
-  return heap;
-}
-
 /**
  * Resolves and stores at the given `path` of the global state elements of
  * an asynchronous data collection.
@@ -154,13 +92,12 @@ function useHeap(ids, path, loader, gs) {
 // and reused in both hooks.
 // eslint-disable-next-line complexity
 function useAsyncCollection(idOrIds, path, loader, options = {}) {
-  var _options$maxage, _options$refreshAge, _options$garbageColle;
+  var _options$maxage, _options$refreshAge, _options$garbageColle, _ref$current;
   const ids = normalizeIds(idOrIds);
   const maxage = (_options$maxage = options.maxage) !== null && _options$maxage !== void 0 ? _options$maxage : DEFAULT_MAXAGE;
   const refreshAge = (_options$refreshAge = options.refreshAge) !== null && _options$refreshAge !== void 0 ? _options$refreshAge : maxage;
   const garbageCollectAge = (_options$garbageColle = options.garbageCollectAge) !== null && _options$garbageColle !== void 0 ? _options$garbageColle : maxage;
   const globalState = getGlobalState();
-  const heap = useHeap(ids, path, loader, globalState);
 
   // Server-side logic.
   if (globalState.ssrContext) {
@@ -241,6 +178,70 @@ function useAsyncCollection(idOrIds, path, loader, options = {}) {
     });
   }
   const [localState] = useGlobalState(path, {});
+  const ref = useRef(null);
+  (_ref$current = ref.current) !== null && _ref$current !== void 0 ? _ref$current : ref.current = {
+    globalState,
+    ids,
+    loader,
+    path
+  };
+  useEffect(() => {
+    ref.current = {
+      globalState,
+      ids,
+      loader,
+      path
+    };
+  }, [globalState, ids, loader, path]);
+  const [stable] = useState(() => {
+    const reload = async customLoader => {
+      const rc = ref.current;
+      if (!rc) throw Error('Internal error');
+      const localLoader = customLoader !== null && customLoader !== void 0 ? customLoader : rc.loader;
+
+      // TODO: Revise - not sure all related typing is 100% correct,
+      // thus let's keep this runtime assertion.
+      // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+      if (!localLoader || !rc.globalState || !rc.ids) {
+        throw Error('Internal error');
+      }
+      for (const id of rc.ids) {
+        const itemPath = rc.path ? `${rc.path}.${id}` : `${id}`;
+        const promiseOrVoid = load(itemPath,
+        // TODO: Revise! Most probably we don't have fully correct loader
+        // typing, as it may return either promise or value, and those two
+        // cases call for different runtime behavior, which in turns only
+        // happens if the outer function on the next line matches the same
+        // async / sync signature.
+        // eslint-disable-next-line @typescript-eslint/promise-function-async
+        (oldData, meta) => localLoader(id, oldData, meta), rc.globalState);
+        if (promiseOrVoid instanceof Promise) await promiseOrVoid;
+      }
+    };
+
+    // TODO: Revise! Most probably we don't have fully correct loader
+    // typing, as it may return either promise or value, and those two
+    // cases call for different runtime behavior, which in turns only
+    // happens if the outer function on the next line matches the same
+    // async / sync signature.
+    // eslint-disable-next-line @typescript-eslint/promise-function-async
+    const reloadSingle = customLoader => reload(
+    // TODO: Revise! Most probably we don't have fully correct loader
+    // typing, as it may return either promise or value, and those two
+    // cases call for different runtime behavior, which in turns only
+    // happens if the outer function on the next line matches the same
+    // async / sync signature.
+    // eslint-disable-next-line @typescript-eslint/promise-function-async
+    customLoader && ((id, ...args) => customLoader(...args)));
+    const setSingle = data => {
+      void reload(() => data);
+    };
+    return {
+      reload,
+      reloadSingle,
+      setSingle
+    };
+  });
   if (!Array.isArray(idOrIds)) {
     var _e$timestamp, _e$data;
     // TODO: Revise related typings!
@@ -249,14 +250,15 @@ function useAsyncCollection(idOrIds, path, loader, options = {}) {
     return {
       data: maxage < Date.now() - timestamp ? null : (_e$data = e === null || e === void 0 ? void 0 : e.data) !== null && _e$data !== void 0 ? _e$data : null,
       loading: !!(e !== null && e !== void 0 && e.operationId),
-      reload: heap.reloadSingle,
+      reload: stable.reloadSingle,
+      set: stable.setSingle,
       timestamp
     };
   }
   const res = {
     items: {},
     loading: false,
-    reload: heap.reload,
+    reload: stable.reload,
     timestamp: Number.MAX_VALUE
   };
   for (const id of ids) {

package/build/code/useAsyncCollection.js.map

@@ -1 +1 @@
-{"version":3,"file":"useAsyncCollection.js","names":["useEffect","useRef","v4","uuid","getGlobalState","DEFAULT_MAXAGE","load","newAsyncDataEnvelope","useGlobalState","hash","isDebugMode","gcOnWithhold","ids","path","gs","collection","get","id","envelope","numRefs","set","idsToStringSet","res","Set","add","toString","gcOnRelease","gcAge","entries","Object","now","Date","idSet","toBeReleased","has","timestamp","process","env","NODE_ENV","console","log","normalizeIds","idOrIds","Array","isArray","from","sort","a","b","localeCompare","useHeap","loader","ref","undefined","heap","current","globalState","reload","customLoader","heap2","localLoader","Error","itemPath","promiseOrVoid","oldData","meta","Promise","reloadSingle","args","useAsyncCollection","options","_options$maxage","_options$refreshAge","_options$garbageColle","maxage","refreshAge","garbageCollectAge","ssrContext","disabled","noSSR","operationId","state","initialValue","data","pending","push","idsHash","_state2$timestamp","state2","deps","hasChangedDependencies","startsWith","_state2$timestamp2","dropDependencies","old","localState","_e$timestamp","_e$data","e","loading","items","Number","MAX_VALUE","_e$timestamp2","_e$data2"],"sources":["../../src/useAsyncCollection.ts"],"sourcesContent":["/**\n * Loads and uses item(s) in an async collection.\n */\n\nimport { useEffect, useRef } from 'react';\nimport { v4 as uuid } from 'uuid';\n\nimport type GlobalState from './GlobalState';\nimport { getGlobalState } from './GlobalStateProvider';\n\nimport {\n  type AsyncDataEnvelopeT,\n  type AsyncDataReloaderT,\n  type DataInEnvelopeAtPathT,\n  type OperationIdT,\n  type UseAsyncDataOptionsT,\n  type UseAsyncDataResT,\n  DEFAULT_MAXAGE,\n  load,\n  newAsyncDataEnvelope,\n} from './useAsyncData';\n\nimport useGlobalState from './useGlobalState';\n\nimport {\n  type ForceT,\n  type LockT,\n  type TypeLock,\n  hash,\n  isDebugMode,\n} from './utils';\n\nexport type AsyncCollectionT<\n  DataT = unknown,\n  IdT extends number | string = number | string,\n> = Record<IdT, AsyncDataEnvelopeT<DataT>>;\n\nexport type AsyncCollectionLoaderT<\n  DataT,\n  IdT extends number | string = number | string,\n> = (id: IdT, oldData: null | DataT, meta: {\n  isAborted: () => boolean;\n  oldDataTimestamp: number;\n  setAbortCallback: (cb: () => void) => void;\n}) => DataT | null | Promise<DataT | null>;\n\nexport type AsyncCollectionReloaderT<\n  DataT,\n  IdT extends number | string = number | string,\n>\n  = (loader?: AsyncCollectionLoaderT<DataT, IdT>) => void | Promise<void>;\n\ntype CollectionItemT<DataT> = {\n  data: DataT | null;\n  loading: boolean;\n  timestamp: number;\n};\n\nexport type UseAsyncCollectionResT<\n  DataT,\n  IdT extends number | string = number | string,\n> = {\n  items: Record<IdT, CollectionItemT<DataT>>;\n  loading: boolean;\n  reload: AsyncCollectionReloaderT<DataT, IdT>;\n  timestamp: number;\n};\n\ntype HeapT<\n  DataT,\n  IdT extends number | string,\n> = {\n  // Note: these heap fields are necessary to make reload() a stable function.\n  globalState: GlobalState<unknown>;\n  ids: IdT[];\n  path: null | string | undefined;\n  loader: AsyncCollectionLoaderT<DataT, IdT>;\n  reload: AsyncCollectionReloaderT<DataT, IdT>;\n  reloadSingle: AsyncDataReloaderT<DataT>;\n};\n\n/**\n * GarbageCollector: the piece of logic executed on mounting of\n * an useAsyncCollection() hook, and on update of hook params, to update\n * the state according to the new param values. It increments by 1 `numRefs`\n * counters for the requested collection items.\n */\nfunction gcOnWithhold<IdT extends number | string>(\n  ids: IdT[],\n  path: null | string | undefined,\n  gs: GlobalState<unknown>,\n) {\n  const collection = { ...gs.get<ForceT, AsyncCollectionT>(path) };\n\n  for (const id of ids) {\n    let envelope = collection[id];\n    if (envelope) envelope = { ...envelope, numRefs: 1 + envelope.numRefs };\n    else envelope = newAsyncDataEnvelope<unknown>(null, { numRefs: 1 });\n    collection[id] = envelope;\n  }\n\n  gs.set<ForceT, AsyncCollectionT>(path, collection);\n}\n\nfunction idsToStringSet<IdT extends number | string>(ids: IdT[]): Set<string> {\n  const res = new Set<string>();\n  for (const id of ids) {\n    res.add(id.toString());\n  }\n  return res;\n}\n\n/**\n * GarbageCollector: the piece of logic executed on un-mounting of\n * an useAsyncCollection() hook, and on update of hook params, to clean-up\n * after the previous param values. It decrements by 1 `numRefs` counters\n * for previously requested collection items, and also drops from the state\n * stale records.\n */\nfunction gcOnRelease<IdT extends number | string>(\n  ids: IdT[],\n  path: null | string | undefined,\n  gs: GlobalState<unknown>,\n  gcAge: number,\n) {\n  type EnvelopeT = AsyncDataEnvelopeT<unknown>;\n\n  const entries = Object.entries<EnvelopeT | undefined>(\n    gs.get<ForceT, AsyncCollectionT>(path),\n  );\n\n  const now = Date.now();\n  const idSet = idsToStringSet(ids);\n  const collection: AsyncCollectionT = {};\n  for (const [id, envelope] of entries) {\n    if (envelope) {\n      const toBeReleased = idSet.has(id);\n\n      let { numRefs } = envelope;\n      if (toBeReleased) --numRefs;\n\n      if (gcAge > now - envelope.timestamp || numRefs > 0) {\n        collection[id as IdT] = toBeReleased\n          ? { ...envelope, numRefs }\n          : envelope;\n      } else if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n        // eslint-disable-next-line no-console\n        console.log(\n          `useAsyncCollection(): Garbage collected at the path \"${\n            path}\", ID = ${id}`,\n        );\n      }\n    }\n  }\n\n  gs.set<ForceT, AsyncCollectionT>(path, collection);\n}\n\nfunction normalizeIds<IdT extends number | string>(\n  idOrIds: IdT | IdT[],\n): IdT[] {\n  if (Array.isArray(idOrIds)) {\n    // Removes ID duplicates.\n    const res = Array.from(new Set(idOrIds));\n\n    // Ensures stable ID order.\n    res.sort((a, b) => a.toString().localeCompare(b.toString()));\n\n    return res;\n  }\n  return [idOrIds];\n}\n\n/**\n * Inits/updates, and returns the heap.\n */\nfunction useHeap<\n  DataT,\n  IdT extends number | string,\n>(\n  ids: IdT[],\n  path: null | string | undefined,\n  loader: AsyncCollectionLoaderT<DataT, IdT>,\n  gs: GlobalState<unknown>,\n): HeapT<DataT, IdT> {\n  const ref = useRef<HeapT<DataT, IdT>>(undefined);\n\n  let heap = ref.current;\n\n  if (heap) {\n    // Update.\n    heap.ids = ids;\n    heap.path = path;\n    heap.loader = loader;\n    heap.globalState = gs;\n  } else {\n    // Initialization.\n    const reload = async (\n      customLoader?: AsyncCollectionLoaderT<DataT, IdT>,\n    ) => {\n      const heap2 = ref.current!;\n\n      const localLoader = customLoader ?? heap2.loader;\n      // TODO: Revise - not sure all related typing is 100% correct,\n      // thus let's keep this runtime assertion.\n      // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n      if (!localLoader || !heap2.globalState || !heap2.ids) {\n        throw Error('Internal error');\n      }\n\n      for (const id of heap2.ids) {\n        const itemPath = heap2.path ? `${heap2.path}.${id}` : `${id}`;\n\n        const promiseOrVoid = load(\n          itemPath,\n          // TODO: Revise! Most probably we don't have fully correct loader\n          // typing, as it may return either promise or value, and those two\n          // cases call for different runtime behavior, which in turns only\n          // happens if the outer function on the next line matches the same\n          // async / sync signature.\n          // eslint-disable-next-line @typescript-eslint/promise-function-async\n          (oldData: DataT | null, meta) => localLoader(id, oldData, meta),\n          heap2.globalState,\n        );\n\n        if (promiseOrVoid instanceof Promise) await promiseOrVoid;\n      }\n    };\n    heap = {\n      globalState: gs,\n      ids,\n      loader,\n      path,\n      reload,\n      // TODO: Revise! Most probably we don't have fully correct loader\n      // typing, as it may return either promise or value, and those two\n      // cases call for different runtime behavior, which in turns only\n      // happens if the outer function on the next line matches the same\n      // async / sync signature.\n      // eslint-disable-next-line @typescript-eslint/promise-function-async\n      reloadSingle: (customLoader) => ref.current!.reload(\n        // TODO: Revise! Most probably we don't have fully correct loader\n        // typing, as it may return either promise or value, and those two\n        // cases call for different runtime behavior, which in turns only\n        // happens if the outer function on the next line matches the same\n        // async / sync signature.\n        // eslint-disable-next-line @typescript-eslint/promise-function-async\n        customLoader && ((id, ...args) => customLoader(...args)),\n      ),\n    };\n    ref.current = heap;\n  }\n\n  return heap;\n}\n\n/**\n * Resolves and stores at the given `path` of the global state elements of\n * an asynchronous data collection.\n */\n\nfunction useAsyncCollection<\n  StateT,\n  PathT extends null | string | undefined,\n  IdT extends number | string,\n\n  DataT extends DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`> = DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>,\n>(\n  id: IdT,\n  path: PathT,\n  loader: AsyncCollectionLoaderT<DataT, IdT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncDataResT<DataT>;\n\nfunction useAsyncCollection<\n  Forced extends ForceT | LockT = LockT,\n  DataT = unknown,\n  IdT extends number | string = number | string,\n>(\n  id: IdT,\n  path: null | string | undefined,\n  loader: AsyncCollectionLoaderT<TypeLock<Forced, void, DataT>, IdT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncDataResT<TypeLock<Forced, void, DataT>>;\n\nfunction useAsyncCollection<\n  StateT,\n  PathT extends null | string | undefined,\n  IdT extends number | string,\n\n  DataT extends DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`> = DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>,\n>(\n  id: IdT[],\n  path: PathT,\n  loader: AsyncCollectionLoaderT<DataT, IdT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncCollectionResT<DataT, IdT>;\n\nfunction useAsyncCollection<\n  Forced extends ForceT | LockT = LockT,\n  DataT = unknown,\n  IdT extends number | string = number | string,\n>(\n  id: IdT[],\n  path: null | string | undefined,\n  loader: AsyncCollectionLoaderT<TypeLock<Forced, void, DataT>, IdT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncCollectionResT<DataT, IdT>;\n\nfunction useAsyncCollection<\n  StateT,\n  PathT extends null | string | undefined,\n  IdT extends number | string,\n\n  DataT extends DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`> = DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>,\n>(\n  id: IdT | IdT[],\n  path: PathT,\n  loader: AsyncCollectionLoaderT<DataT, IdT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncDataResT<DataT> | UseAsyncCollectionResT<DataT, IdT>;\n\n// TODO: This is largely similar to useAsyncData() logic, just more generic.\n// Perhaps, a bunch of logic blocks can be split into stand-alone functions,\n// and reused in both hooks.\n// eslint-disable-next-line complexity\nfunction useAsyncCollection<\n  DataT,\n  IdT extends number | string,\n>(\n  idOrIds: IdT | IdT[],\n  path: null | string | undefined,\n  loader: AsyncCollectionLoaderT<DataT, IdT>,\n  options: UseAsyncDataOptionsT = {},\n): UseAsyncDataResT<DataT> | UseAsyncCollectionResT<DataT, IdT> {\n  const ids = normalizeIds(idOrIds);\n  const maxage: number = options.maxage ?? DEFAULT_MAXAGE;\n  const refreshAge: number = options.refreshAge ?? maxage;\n  const garbageCollectAge: number = options.garbageCollectAge ?? maxage;\n\n  const globalState = getGlobalState();\n\n  const heap = useHeap(ids, path, loader, globalState);\n\n  // Server-side logic.\n  if (globalState.ssrContext) {\n    if (!options.disabled && !options.noSSR) {\n      const operationId: OperationIdT = `S${uuid()}`;\n      for (const id of ids) {\n        const itemPath = path ? `${path}.${id}` : `${id}`;\n        const state = globalState.get<ForceT, AsyncDataEnvelopeT<DataT>>(\n          itemPath,\n          {\n            initialValue: newAsyncDataEnvelope<DataT>(),\n          },\n        );\n        if (!state.timestamp && !state.operationId) {\n          const promiseOrVoid = load(\n            itemPath,\n            (...args):\n              DataT | null | Promise<DataT | null> => loader(id, ...args),\n            globalState,\n            {\n              data: state.data,\n              timestamp: state.timestamp,\n            },\n            operationId,\n          );\n\n          if (promiseOrVoid instanceof Promise) {\n            globalState.ssrContext.pending.push(promiseOrVoid);\n          }\n        }\n      }\n    }\n\n  // Client-side logic.\n  } else {\n    const { disabled } = options;\n\n    // Reference-counting & garbage collection.\n\n    const idsHash = hash(ids);\n\n    // TODO: Violation of rules of hooks is fine here,\n    // but perhaps it can be refactored to avoid the need for it.\n    useEffect(() => { // eslint-disable-line react-hooks/rules-of-hooks\n      if (!disabled) gcOnWithhold(ids, path, globalState);\n      return () => {\n        if (!disabled) gcOnRelease(ids, path, globalState, garbageCollectAge);\n      };\n\n      // `ids` are represented in the dependencies array by `idsHash` value,\n      // as useEffect() hook requires a constant size of dependencies array.\n      // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [\n      disabled,\n      garbageCollectAge,\n      globalState,\n      idsHash,\n      path,\n    ]);\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    useEffect(() => { // eslint-disable-line react-hooks/rules-of-hooks\n      if (!disabled) {\n        void (async () => {\n          for (const id of ids) {\n            const itemPath = path ? `${path}.${id}` : `${id}`;\n\n            type EnvT = AsyncDataEnvelopeT<DataT> | undefined;\n            const state2: EnvT = globalState.get<ForceT, EnvT>(itemPath);\n\n            const { deps } = options;\n            if (\n              (deps && globalState.hasChangedDependencies(itemPath, deps))\n              || (\n                refreshAge < Date.now() - (state2?.timestamp ?? 0)\n                && (!state2?.operationId || state2.operationId.startsWith('S'))\n              )\n            ) {\n              if (!deps) globalState.dropDependencies(itemPath);\n              await load(\n                itemPath,\n                // TODO: I guess, the loader is not correctly typed here -\n                // it can be synchronous, and in that case the following method\n                // should be kept synchronous to not alter the sync logic.\n                // eslint-disable-next-line @typescript-eslint/promise-function-async\n                (old, ...args) => loader(id, old as DataT, ...args),\n                globalState,\n                {\n                  data: state2?.data,\n                  timestamp: state2?.timestamp ?? 0,\n                },\n              );\n            }\n          }\n        })();\n      }\n    });\n  }\n\n  const [localState] = useGlobalState<\n    ForceT, Record<string, AsyncDataEnvelopeT<DataT>>\n  >(path, {});\n\n  if (!Array.isArray(idOrIds)) {\n    // TODO: Revise related typings!\n    const e = localState[idOrIds as string];\n    const timestamp = e?.timestamp ?? 0;\n    return {\n      data: maxage < Date.now() - timestamp ? null : e?.data ?? null,\n      loading: !!e?.operationId,\n      reload: heap.reloadSingle,\n      timestamp,\n    };\n  }\n\n  const res: UseAsyncCollectionResT<DataT, IdT> = {\n    items: {} as Record<IdT, CollectionItemT<DataT>>,\n    loading: false,\n    reload: heap.reload,\n    timestamp: Number.MAX_VALUE,\n  };\n\n  for (const id of ids) {\n    // TODO: Revise related typing. Should `localState` have a more specific type?\n    const e = localState[id as string];\n    const loading = !!e?.operationId;\n    const timestamp = e?.timestamp ?? 0;\n\n    res.items[id] = {\n      data: maxage < Date.now() - timestamp ? null : e?.data ?? null,\n      loading,\n      timestamp,\n    };\n    res.loading ||= loading;\n    if (res.timestamp > timestamp) res.timestamp = timestamp;\n  }\n\n  return res;\n}\n\nexport default useAsyncCollection;\n\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\nexport interface UseAsyncCollectionI<StateT> {\n  <PathT extends null | string | undefined, IdT extends number | string>(\n    id: IdT,\n    path: PathT,\n    loader: AsyncCollectionLoaderT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncDataResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>>;\n\n  <\n    Forced extends ForceT | LockT = LockT,\n    DataT = unknown,\n    IdT extends number | string = number | string,\n  >(\n    id: IdT,\n    path: null | string | undefined,\n    loader: AsyncCollectionLoaderT<TypeLock<Forced, void, DataT>, IdT>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncDataResT<TypeLock<Forced, void, DataT>>;\n\n  <PathT extends null | string | undefined, IdT extends number | string>(\n    id: IdT[],\n    path: PathT,\n    loader: AsyncCollectionLoaderT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncCollectionResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>;\n\n  <\n    Forced extends ForceT | LockT = LockT,\n    DataT = unknown,\n    IdT extends number | string = number | string,\n  >(\n    id: IdT[],\n    path: null | string | undefined,\n    loader: AsyncCollectionLoaderT<TypeLock<Forced, void, DataT>, IdT>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncCollectionResT<DataT, IdT>;\n\n  <PathT extends null | string | undefined, IdT extends number | string>(\n    id: IdT | IdT[],\n    path: PathT,\n    loader: AsyncCollectionLoaderT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncDataResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>>\n    | UseAsyncCollectionResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>;\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"useAsyncCollection.js","names":["useEffect","useRef","useState","v4","uuid","getGlobalState","DEFAULT_MAXAGE","load","newAsyncDataEnvelope","useGlobalState","hash","isDebugMode","gcOnWithhold","ids","path","gs","collection","get","id","envelope","numRefs","set","idsToStringSet","res","Set","add","toString","gcOnRelease","gcAge","entries","Object","now","Date","idSet","toBeReleased","has","timestamp","process","env","NODE_ENV","console","log","normalizeIds","idOrIds","Array","isArray","from","sort","a","b","localeCompare","useAsyncCollection","loader","options","_options$maxage","_options$refreshAge","_options$garbageColle","_ref$current","maxage","refreshAge","garbageCollectAge","globalState","ssrContext","disabled","noSSR","operationId","itemPath","state","initialValue","promiseOrVoid","args","data","Promise","pending","push","idsHash","_state2$timestamp","state2","deps","hasChangedDependencies","startsWith","_state2$timestamp2","dropDependencies","old","localState","ref","current","stable","reload","customLoader","rc","Error","localLoader","oldData","meta","reloadSingle","setSingle","_e$timestamp","_e$data","e","loading","items","Number","MAX_VALUE","_e$timestamp2","_e$data2"],"sources":["../../src/useAsyncCollection.ts"],"sourcesContent":["/**\n * Loads and uses item(s) in an async collection.\n */\n\nimport { useEffect, useRef, useState } from 'react';\nimport { v4 as uuid } from 'uuid';\n\nimport type GlobalState from './GlobalState';\nimport { getGlobalState } from './GlobalStateProvider';\n\nimport {\n  type AsyncDataEnvelopeT,\n  type AsyncDataReloaderT,\n  type DataInEnvelopeAtPathT,\n  type OperationIdT,\n  type UseAsyncDataOptionsT,\n  type UseAsyncDataResT,\n  DEFAULT_MAXAGE,\n  load,\n  newAsyncDataEnvelope,\n} from './useAsyncData';\n\nimport useGlobalState from './useGlobalState';\n\nimport {\n  type ForceT,\n  type LockT,\n  type TypeLock,\n  hash,\n  isDebugMode,\n} from './utils';\n\nexport type AsyncCollectionT<\n  DataT = unknown,\n  IdT extends number | string = number | string,\n> = Record<IdT, AsyncDataEnvelopeT<DataT>>;\n\nexport type AsyncCollectionLoaderT<\n  DataT,\n  IdT extends number | string = number | string,\n> = (id: IdT, oldData: null | DataT, meta: {\n  isAborted: () => boolean;\n  oldDataTimestamp: number;\n  setAbortCallback: (cb: () => void) => void;\n}) => DataT | null | Promise<DataT | null>;\n\nexport type AsyncCollectionReloaderT<\n  DataT,\n  IdT extends number | string = number | string,\n> = (loader?: AsyncCollectionLoaderT<DataT, IdT>) => void | Promise<void>;\n\ntype CollectionItemT<DataT> = {\n  data: DataT | null;\n  loading: boolean;\n  timestamp: number;\n};\n\nexport type UseAsyncCollectionResT<\n  DataT,\n  IdT extends number | string = number | string,\n> = {\n  items: Record<IdT, CollectionItemT<DataT>>;\n  loading: boolean;\n  reload: AsyncCollectionReloaderT<DataT, IdT>;\n  timestamp: number;\n};\n\ntype CurrentT<DataT, IdT extends number | string> = {\n  globalState: GlobalState<unknown>;\n  ids: IdT[];\n  loader: AsyncCollectionLoaderT<DataT, IdT>;\n  path: null | string | undefined;\n};\n\ntype StableT<DataT, IdT extends number | string> = {\n  reload: AsyncCollectionReloaderT<DataT, IdT>;\n  reloadSingle: AsyncDataReloaderT<DataT>;\n  setSingle: (data: DataT | null) => void;\n};\n\n/**\n * GarbageCollector: the piece of logic executed on mounting of\n * an useAsyncCollection() hook, and on update of hook params, to update\n * the state according to the new param values. It increments by 1 `numRefs`\n * counters for the requested collection items.\n */\nfunction gcOnWithhold<IdT extends number | string>(\n  ids: IdT[],\n  path: null | string | undefined,\n  gs: GlobalState<unknown>,\n) {\n  const collection = { ...gs.get<ForceT, AsyncCollectionT>(path) };\n\n  for (const id of ids) {\n    let envelope = collection[id];\n    if (envelope) envelope = { ...envelope, numRefs: 1 + envelope.numRefs };\n    else envelope = newAsyncDataEnvelope<unknown>(null, { numRefs: 1 });\n    collection[id] = envelope;\n  }\n\n  gs.set<ForceT, AsyncCollectionT>(path, collection);\n}\n\nfunction idsToStringSet<IdT extends number | string>(ids: IdT[]): Set<string> {\n  const res = new Set<string>();\n  for (const id of ids) {\n    res.add(id.toString());\n  }\n  return res;\n}\n\n/**\n * GarbageCollector: the piece of logic executed on un-mounting of\n * an useAsyncCollection() hook, and on update of hook params, to clean-up\n * after the previous param values. It decrements by 1 `numRefs` counters\n * for previously requested collection items, and also drops from the state\n * stale records.\n */\nfunction gcOnRelease<IdT extends number | string>(\n  ids: IdT[],\n  path: null | string | undefined,\n  gs: GlobalState<unknown>,\n  gcAge: number,\n) {\n  type EnvelopeT = AsyncDataEnvelopeT<unknown>;\n\n  const entries = Object.entries<EnvelopeT | undefined>(\n    gs.get<ForceT, AsyncCollectionT>(path),\n  );\n\n  const now = Date.now();\n  const idSet = idsToStringSet(ids);\n  const collection: AsyncCollectionT = {};\n  for (const [id, envelope] of entries) {\n    if (envelope) {\n      const toBeReleased = idSet.has(id);\n\n      let { numRefs } = envelope;\n      if (toBeReleased) --numRefs;\n\n      if (gcAge > now - envelope.timestamp || numRefs > 0) {\n        collection[id as IdT] = toBeReleased\n          ? { ...envelope, numRefs }\n          : envelope;\n      } else if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n        // eslint-disable-next-line no-console\n        console.log(\n          `useAsyncCollection(): Garbage collected at the path \"${\n            path}\", ID = ${id}`,\n        );\n      }\n    }\n  }\n\n  gs.set<ForceT, AsyncCollectionT>(path, collection);\n}\n\nfunction normalizeIds<IdT extends number | string>(\n  idOrIds: IdT | IdT[],\n): IdT[] {\n  if (Array.isArray(idOrIds)) {\n    // Removes ID duplicates.\n    const res = Array.from(new Set(idOrIds));\n\n    // Ensures stable ID order.\n    res.sort((a, b) => a.toString().localeCompare(b.toString()));\n\n    return res;\n  }\n  return [idOrIds];\n}\n\n/**\n * Resolves and stores at the given `path` of the global state elements of\n * an asynchronous data collection.\n */\n\nfunction useAsyncCollection<\n  StateT,\n  PathT extends null | string | undefined,\n  IdT extends number | string,\n\n  DataT extends DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`> = DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>,\n>(\n  id: IdT,\n  path: PathT,\n  loader: AsyncCollectionLoaderT<DataT, IdT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncDataResT<DataT>;\n\nfunction useAsyncCollection<\n  Forced extends ForceT | LockT = LockT,\n  DataT = unknown,\n  IdT extends number | string = number | string,\n>(\n  id: IdT,\n  path: null | string | undefined,\n  loader: AsyncCollectionLoaderT<TypeLock<Forced, void, DataT>, IdT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncDataResT<TypeLock<Forced, void, DataT>>;\n\nfunction useAsyncCollection<\n  StateT,\n  PathT extends null | string | undefined,\n  IdT extends number | string,\n\n  DataT extends DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`> = DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>,\n>(\n  id: IdT[],\n  path: PathT,\n  loader: AsyncCollectionLoaderT<DataT, IdT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncCollectionResT<DataT, IdT>;\n\nfunction useAsyncCollection<\n  Forced extends ForceT | LockT = LockT,\n  DataT = unknown,\n  IdT extends number | string = number | string,\n>(\n  id: IdT[],\n  path: null | string | undefined,\n  loader: AsyncCollectionLoaderT<TypeLock<Forced, void, DataT>, IdT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncCollectionResT<DataT, IdT>;\n\nfunction useAsyncCollection<\n  StateT,\n  PathT extends null | string | undefined,\n  IdT extends number | string,\n\n  DataT extends DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`> = DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>,\n>(\n  id: IdT | IdT[],\n  path: PathT,\n  loader: AsyncCollectionLoaderT<DataT, IdT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncDataResT<DataT> | UseAsyncCollectionResT<DataT, IdT>;\n\n// TODO: This is largely similar to useAsyncData() logic, just more generic.\n// Perhaps, a bunch of logic blocks can be split into stand-alone functions,\n// and reused in both hooks.\n// eslint-disable-next-line complexity\nfunction useAsyncCollection<\n  DataT,\n  IdT extends number | string,\n>(\n  idOrIds: IdT | IdT[],\n  path: null | string | undefined,\n  loader: AsyncCollectionLoaderT<DataT, IdT>,\n  options: UseAsyncDataOptionsT = {},\n): UseAsyncDataResT<DataT> | UseAsyncCollectionResT<DataT, IdT> {\n  const ids = normalizeIds(idOrIds);\n  const maxage: number = options.maxage ?? DEFAULT_MAXAGE;\n  const refreshAge: number = options.refreshAge ?? maxage;\n  const garbageCollectAge: number = options.garbageCollectAge ?? maxage;\n\n  const globalState = getGlobalState();\n\n  // Server-side logic.\n  if (globalState.ssrContext) {\n    if (!options.disabled && !options.noSSR) {\n      const operationId: OperationIdT = `S${uuid()}`;\n      for (const id of ids) {\n        const itemPath = path ? `${path}.${id}` : `${id}`;\n        const state = globalState.get<ForceT, AsyncDataEnvelopeT<DataT>>(\n          itemPath,\n          {\n            initialValue: newAsyncDataEnvelope<DataT>(),\n          },\n        );\n        if (!state.timestamp && !state.operationId) {\n          const promiseOrVoid = load(\n            itemPath,\n            (...args):\n              DataT | null | Promise<DataT | null> => loader(id, ...args),\n            globalState,\n            {\n              data: state.data,\n              timestamp: state.timestamp,\n            },\n            operationId,\n          );\n\n          if (promiseOrVoid instanceof Promise) {\n            globalState.ssrContext.pending.push(promiseOrVoid);\n          }\n        }\n      }\n    }\n\n  // Client-side logic.\n  } else {\n    const { disabled } = options;\n\n    // Reference-counting & garbage collection.\n\n    const idsHash = hash(ids);\n\n    // TODO: Violation of rules of hooks is fine here,\n    // but perhaps it can be refactored to avoid the need for it.\n    useEffect(() => { // eslint-disable-line react-hooks/rules-of-hooks\n      if (!disabled) gcOnWithhold(ids, path, globalState);\n      return () => {\n        if (!disabled) gcOnRelease(ids, path, globalState, garbageCollectAge);\n      };\n\n      // `ids` are represented in the dependencies array by `idsHash` value,\n      // as useEffect() hook requires a constant size of dependencies array.\n      // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [\n      disabled,\n      garbageCollectAge,\n      globalState,\n      idsHash,\n      path,\n    ]);\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    useEffect(() => { // eslint-disable-line react-hooks/rules-of-hooks\n      if (!disabled) {\n        void (async () => {\n          for (const id of ids) {\n            const itemPath = path ? `${path}.${id}` : `${id}`;\n\n            type EnvT = AsyncDataEnvelopeT<DataT> | undefined;\n            const state2: EnvT = globalState.get<ForceT, EnvT>(itemPath);\n\n            const { deps } = options;\n            if (\n              (deps && globalState.hasChangedDependencies(itemPath, deps))\n              || (\n                refreshAge < Date.now() - (state2?.timestamp ?? 0)\n                && (!state2?.operationId || state2.operationId.startsWith('S'))\n              )\n            ) {\n              if (!deps) globalState.dropDependencies(itemPath);\n              await load(\n                itemPath,\n                // TODO: I guess, the loader is not correctly typed here -\n                // it can be synchronous, and in that case the following method\n                // should be kept synchronous to not alter the sync logic.\n                // eslint-disable-next-line @typescript-eslint/promise-function-async\n                (old, ...args) => loader(id, old as DataT, ...args),\n                globalState,\n                {\n                  data: state2?.data,\n                  timestamp: state2?.timestamp ?? 0,\n                },\n              );\n            }\n          }\n        })();\n      }\n    });\n  }\n\n  const [localState] = useGlobalState<\n    ForceT, Record<string, AsyncDataEnvelopeT<DataT>>\n  >(path, {});\n\n  const ref = useRef<CurrentT<DataT, IdT>>(null);\n\n  ref.current ??= {\n    globalState,\n    ids,\n    loader,\n    path,\n  };\n\n  useEffect(() => {\n    ref.current = {\n      globalState,\n      ids,\n      loader,\n      path,\n    };\n  }, [globalState, ids, loader, path]);\n\n  const [stable] = useState<StableT<DataT, IdT>>(() => {\n    const reload = async (\n      customLoader?: AsyncCollectionLoaderT<DataT, IdT>,\n    ) => {\n      const rc = ref.current;\n      if (!rc) throw Error('Internal error');\n\n      const localLoader = customLoader ?? rc.loader;\n\n      // TODO: Revise - not sure all related typing is 100% correct,\n      // thus let's keep this runtime assertion.\n      // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n      if (!localLoader || !rc.globalState || !rc.ids) {\n        throw Error('Internal error');\n      }\n\n      for (const id of rc.ids) {\n        const itemPath = rc.path ? `${rc.path}.${id}` : `${id}`;\n\n        const promiseOrVoid = load(\n          itemPath,\n          // TODO: Revise! Most probably we don't have fully correct loader\n          // typing, as it may return either promise or value, and those two\n          // cases call for different runtime behavior, which in turns only\n          // happens if the outer function on the next line matches the same\n          // async / sync signature.\n          // eslint-disable-next-line @typescript-eslint/promise-function-async\n          (oldData: DataT | null, meta) => localLoader(id, oldData, meta),\n          rc.globalState,\n        );\n\n        if (promiseOrVoid instanceof Promise) await promiseOrVoid;\n      }\n    };\n\n    // TODO: Revise! Most probably we don't have fully correct loader\n    // typing, as it may return either promise or value, and those two\n    // cases call for different runtime behavior, which in turns only\n    // happens if the outer function on the next line matches the same\n    // async / sync signature.\n    // eslint-disable-next-line @typescript-eslint/promise-function-async\n    const reloadSingle: AsyncDataReloaderT<DataT> = (customLoader) => reload(\n      // TODO: Revise! Most probably we don't have fully correct loader\n      // typing, as it may return either promise or value, and those two\n      // cases call for different runtime behavior, which in turns only\n      // happens if the outer function on the next line matches the same\n      // async / sync signature.\n      // eslint-disable-next-line @typescript-eslint/promise-function-async\n      customLoader && ((id, ...args) => customLoader(...args)),\n    );\n\n    const setSingle = (data: DataT | null) => {\n      void reload(() => data);\n    };\n\n    return { reload, reloadSingle, setSingle };\n  });\n\n  if (!Array.isArray(idOrIds)) {\n    // TODO: Revise related typings!\n    const e = localState[idOrIds as string];\n    const timestamp = e?.timestamp ?? 0;\n    return {\n      data: maxage < Date.now() - timestamp ? null : e?.data ?? null,\n      loading: !!e?.operationId,\n      reload: stable.reloadSingle,\n      set: stable.setSingle,\n      timestamp,\n    };\n  }\n\n  const res: UseAsyncCollectionResT<DataT, IdT> = {\n    items: {} as Record<IdT, CollectionItemT<DataT>>,\n    loading: false,\n    reload: stable.reload,\n    timestamp: Number.MAX_VALUE,\n  };\n\n  for (const id of ids) {\n    // TODO: Revise related typing. Should `localState` have a more specific type?\n    const e = localState[id as string];\n    const loading = !!e?.operationId;\n    const timestamp = e?.timestamp ?? 0;\n\n    res.items[id] = {\n      data: maxage < Date.now() - timestamp ? null : e?.data ?? null,\n      loading,\n      timestamp,\n    };\n    res.loading ||= loading;\n    if (res.timestamp > timestamp) res.timestamp = timestamp;\n  }\n\n  return res;\n}\n\nexport default useAsyncCollection;\n\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\nexport interface UseAsyncCollectionI<StateT> {\n  <PathT extends null | string | undefined, IdT extends number | string>(\n    id: IdT,\n    path: PathT,\n    loader: AsyncCollectionLoaderT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncDataResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>>;\n\n  <\n    Forced extends ForceT | LockT = LockT,\n    DataT = unknown,\n    IdT extends number | string = number | string,\n  >(\n    id: IdT,\n    path: null | string | undefined,\n    loader: AsyncCollectionLoaderT<TypeLock<Forced, void, DataT>, IdT>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncDataResT<TypeLock<Forced, void, DataT>>;\n\n  <PathT extends null | string | undefined, IdT extends number | string>(\n    id: IdT[],\n    path: PathT,\n    loader: AsyncCollectionLoaderT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncCollectionResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>;\n\n  <\n    Forced extends ForceT | LockT = LockT,\n    DataT = unknown,\n    IdT extends number | string = number | string,\n  >(\n    id: IdT[],\n    path: null | string | undefined,\n    loader: AsyncCollectionLoaderT<TypeLock<Forced, void, DataT>, IdT>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncCollectionResT<DataT, IdT>;\n\n  <PathT extends null | string | undefined, IdT extends number | string>(\n    id: IdT | IdT[],\n    path: PathT,\n    loader: AsyncCollectionLoaderT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncDataResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>>\n    | UseAsyncCollectionResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>;\n}\n"],"mappings":"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","ignoreList":[]}