@dr.pogodin/react-global-state 0.24.0 → 0.25.0

package/LICENSE.md

@@ -1,6 +1,6 @@
 # MIT License
 
-_Copyright © 2019–2025, Dr. Sergey Pogodin_
+_Copyright © 2019–2026, Dr. Sergey Pogodin_
   &mdash; <doc@pogodin.studio> (https://dr.pogodin.studio)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy

package/build/{code → logic}/GlobalState.js

@@ -1,41 +1,33 @@
-function _classPrivateFieldInitSpec(e, t, a) { _checkPrivateRedeclaration(e, t), t.set(e, a); }
-function _checkPrivateRedeclaration(e, t) { if (t.has(e)) throw new TypeError("Cannot initialize the same private elements twice on an object"); }
-function _classPrivateFieldGet(s, a) { return s.get(_assertClassBrand(s, a)); }
-function _classPrivateFieldSet(s, a, r) { return s.set(_assertClassBrand(s, a), r), r; }
-function _assertClassBrand(e, t, n) { if ("function" == typeof e ? e === t : e.has(t)) return arguments.length < 3 ? t : n; throw new TypeError("Private element is not present on this object"); }
 import { get, set, toPath } from 'lodash-es';
 import { cloneDeepForLog, isDebugMode } from "./utils.js";
 const ERR_NO_SSR_WATCH = 'GlobalState must not be watched at server side';
-var _asyncDataAbortCallbacks = /*#__PURE__*/new WeakMap();
-var _dependencies = /*#__PURE__*/new WeakMap();
-var _initialState = /*#__PURE__*/new WeakMap();
-var _watchers = /*#__PURE__*/new WeakMap();
-var _nextNotifierId = /*#__PURE__*/new WeakMap();
-var _currentState = /*#__PURE__*/new WeakMap();
 export default class GlobalState {
+  ssrContext;
+  #asyncDataAbortCallbacks = new Map();
+  #dependencies = new Map();
+  #initialState;
+
+  // TODO: It is tempting to replace watchers here by
+  // Emitter from @dr.pogodin/js-utils, but we need to clone
+  // current watchers for emitting later, and this is not something
+  // Emitter supports right now.
+  #watchers = [];
+  #nextNotifierId;
+  #currentState;
+
   /**
    * Creates a new global state object.
    * @param initialState Intial global state content.
    * @param ssrContext Server-side rendering context.
    */
   constructor(initialState, ssrContext) {
-    _classPrivateFieldInitSpec(this, _asyncDataAbortCallbacks, new Map());
-    _classPrivateFieldInitSpec(this, _dependencies, new Map());
-    _classPrivateFieldInitSpec(this, _initialState, void 0);
-    // TODO: It is tempting to replace watchers here by
-    // Emitter from @dr.pogodin/js-utils, but we need to clone
-    // current watchers for emitting later, and this is not something
-    // Emitter supports right now.
-    _classPrivateFieldInitSpec(this, _watchers, []);
-    _classPrivateFieldInitSpec(this, _nextNotifierId, void 0);
-    _classPrivateFieldInitSpec(this, _currentState, void 0);
-    _classPrivateFieldSet(_currentState, this, initialState);
-    _classPrivateFieldSet(_initialState, this, initialState);
+    this.#currentState = initialState;
+    this.#initialState = initialState;
     if (ssrContext) {
       /* eslint-disable no-param-reassign */
       ssrContext.dirty = false;
       ssrContext.pending = [];
-      ssrContext.state = _classPrivateFieldGet(_currentState, this);
+      ssrContext.state = this.#currentState;
       /* eslint-enable no-param-reassign */
 
       this.ssrContext = ssrContext;
@@ -56,7 +48,7 @@ export default class GlobalState {
    * just for the sake of testing the library.
    */
   get numAsyncDataAbortCallbacks() {
-    return _classPrivateFieldGet(_asyncDataAbortCallbacks, this).size;
+    return this.#asyncDataAbortCallbacks.size;
   }
 
   /**
@@ -65,16 +57,15 @@ export default class GlobalState {
    * it drops the callback.
    */
   asyncDataLoadDone(opid, aborted) {
-    var _classPrivateFieldGet2;
-    if (aborted) (_classPrivateFieldGet2 = _classPrivateFieldGet(_asyncDataAbortCallbacks, this).get(opid)) === null || _classPrivateFieldGet2 === void 0 || _classPrivateFieldGet2();
-    _classPrivateFieldGet(_asyncDataAbortCallbacks, this).delete(opid);
+    if (aborted) this.#asyncDataAbortCallbacks.get(opid)?.();
+    this.#asyncDataAbortCallbacks.delete(opid);
   }
 
   /**
    * Drops the record of dependencies, if any, for the given path.
    */
   dropDependencies(path) {
-    _classPrivateFieldGet(_dependencies, this).delete(path);
+    this.#dependencies.delete(path);
   }
 
   /**
@@ -89,12 +80,12 @@ export default class GlobalState {
    * level in the logic?
    */
   hasChangedDependencies(path, deps) {
-    const prevDeps = _classPrivateFieldGet(_dependencies, this).get(path);
-    let changed = (prevDeps === null || prevDeps === void 0 ? void 0 : prevDeps.length) !== deps.length;
+    const prevDeps = this.#dependencies.get(path);
+    let changed = prevDeps?.length !== deps.length;
     for (let i = 0; !changed && i < deps.length; ++i) {
       changed = prevDeps[i] !== deps[i];
     }
-    _classPrivateFieldGet(_dependencies, this).set(path, Object.freeze(deps));
+    this.#dependencies.set(path, Object.freeze(deps));
     return changed;
   }
 
@@ -104,11 +95,11 @@ export default class GlobalState {
    * @param opts.initialValue
    */
   getEntireState(opts) {
-    let state = opts !== null && opts !== void 0 && opts.initialState ? _classPrivateFieldGet(_initialState, this) : _classPrivateFieldGet(_currentState, this);
-    if (state !== undefined || (opts === null || opts === void 0 ? void 0 : opts.initialValue) === undefined) return state;
+    let state = opts?.initialState ? this.#initialState : this.#currentState;
+    if (state !== undefined || opts?.initialValue === undefined) return state;
     const iv = opts.initialValue;
     state = typeof iv === 'function' ? iv() : iv;
-    if (_classPrivateFieldGet(_currentState, this) === undefined) this.setEntireState(state);
+    if (this.#currentState === undefined) this.setEntireState(state);
     return state;
   }
 
@@ -120,20 +111,20 @@ export default class GlobalState {
       /* eslint-disable no-console */
       const p = typeof path === 'string' ? `"${path}"` : 'none (entire state update)';
       console.groupCollapsed(`ReactGlobalState update. Path: ${p}`);
-      console.log('New value:', cloneDeepForLog(value, path !== null && path !== void 0 ? path : ''));
-      console.log('New state:', cloneDeepForLog(_classPrivateFieldGet(_currentState, this)));
+      console.log('New value:', cloneDeepForLog(value, path ?? ''));
+      console.log('New state:', cloneDeepForLog(this.#currentState));
       console.groupEnd();
       /* eslint-enable no-console */
     }
     if (this.ssrContext) {
       this.ssrContext.dirty = true;
-      this.ssrContext.state = _classPrivateFieldGet(_currentState, this);
-    } else if (!_classPrivateFieldGet(_nextNotifierId, this)) {
-      _classPrivateFieldSet(_nextNotifierId, this, setTimeout(() => {
-        _classPrivateFieldSet(_nextNotifierId, this, undefined);
-        const watchers = [..._classPrivateFieldGet(_watchers, this)];
+      this.ssrContext.state = this.#currentState;
+    } else if (!this.#nextNotifierId) {
+      this.#nextNotifierId = setTimeout(() => {
+        this.#nextNotifierId = undefined;
+        const watchers = [...this.#watchers];
         for (const watcher of watchers) watcher();
-      }));
+      });
     }
   }
 
@@ -142,7 +133,7 @@ export default class GlobalState {
    * the given operation ID. Throws if already registered.
    */
   setAsyncDataAbortCallback(opid, cb) {
-    _classPrivateFieldGet(_asyncDataAbortCallbacks, this).set(opid, cb);
+    this.#asyncDataAbortCallbacks.set(opid, cb);
   }
 
   /**
@@ -150,8 +141,8 @@ export default class GlobalState {
    * @param value
    */
   setEntireState(value) {
-    if (_classPrivateFieldGet(_currentState, this) !== value) {
-      _classPrivateFieldSet(_currentState, this, value);
+    if (this.#currentState !== value) {
+      this.#currentState = value;
       this.notifyStateUpdate(null, value);
     }
     return value;
@@ -186,9 +177,9 @@ export default class GlobalState {
       const res = this.getEntireState(opts);
       return res;
     }
-    const state = opts !== null && opts !== void 0 && opts.initialState ? _classPrivateFieldGet(_initialState, this) : _classPrivateFieldGet(_currentState, this);
+    const state = opts?.initialState ? this.#initialState : this.#currentState;
     let res = get(state, path);
-    if (res !== undefined || (opts === null || opts === void 0 ? void 0 : opts.initialValue) === undefined) return res;
+    if (res !== undefined || opts?.initialValue === undefined) return res;
     const iv = opts.initialValue;
     res = typeof iv === 'function' ? iv() : iv;
 
@@ -220,7 +211,7 @@ export default class GlobalState {
     // eslint-disable-next-line @typescript-eslint/no-confusing-void-expression
     if (value !== this.get(path)) {
       const root = {
-        state: _classPrivateFieldGet(_currentState, this)
+        state: this.#currentState
       };
       let segIdx = 0;
 
@@ -248,7 +239,7 @@ export default class GlobalState {
       if (segIdx === pathSegments.length - 1) {
         pos[pathSegments[segIdx]] = value;
       }
-      _classPrivateFieldSet(_currentState, this, root.state);
+      this.#currentState = root.state;
       this.notifyStateUpdate(path, value);
     }
     return value;
@@ -263,7 +254,7 @@ export default class GlobalState {
    */
   unWatch(callback) {
     if (this.ssrContext) throw new Error(ERR_NO_SSR_WATCH);
-    const watchers = _classPrivateFieldGet(_watchers, this);
+    const watchers = this.#watchers;
     const pos = watchers.indexOf(callback);
     if (pos >= 0) {
       watchers[pos] = watchers[watchers.length - 1];
@@ -283,7 +274,7 @@ export default class GlobalState {
    */
   watch(callback) {
     if (this.ssrContext) throw new Error(ERR_NO_SSR_WATCH);
-    const watchers = _classPrivateFieldGet(_watchers, this);
+    const watchers = this.#watchers;
     if (!watchers.includes(callback)) {
       watchers.push(callback);
     }

package/build/logic/GlobalState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlobalState.js","names":[],"sources":["../../src/GlobalState.ts"],"sourcesContent":["import { get, set, toPath } from 'lodash-es';\n\nimport type SsrContext from './SsrContext';\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\nconst ERR_NO_SSR_WATCH = 'GlobalState must not be watched at server side';\n\ntype GetOptsT<T> = {\n  initialState?: boolean;\n  initialValue?: ValueOrInitializerT<T>;\n};\n\nexport default class GlobalState<\n  StateT,\n  SsrContextT extends SsrContext<StateT> = SsrContext<StateT>,\n> {\n  readonly ssrContext?: SsrContextT;\n\n  #asyncDataAbortCallbacks = new Map<string, () => void>();\n\n  #dependencies = new Map<string, readonly unknown[]>();\n\n  #initialState: StateT;\n\n  // TODO: It is tempting to replace watchers here by\n  // Emitter from @dr.pogodin/js-utils, but we need to clone\n  // current watchers for emitting later, and this is not something\n  // Emitter supports right now.\n  #watchers: CallbackT[] = [];\n\n  #nextNotifierId?: NodeJS.Timeout;\n\n  #currentState: StateT;\n\n  /**\n   * Creates a new global state object.\n   * @param initialState Intial global state content.\n   * @param ssrContext Server-side rendering context.\n   */\n  constructor(\n    initialState: StateT,\n    ssrContext?: SsrContextT,\n  ) {\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:', cloneDeepForLog(initialState));\n      console.groupEnd();\n      /* eslint-enable no-console */\n    }\n  }\n\n  /**\n   * Returns the number of currently registered async data abort callbacks,\n   * just for the sake of testing the library.\n   */\n  get numAsyncDataAbortCallbacks(): number {\n    return this.#asyncDataAbortCallbacks.size;\n  }\n\n  /**\n   * If `aborted` is \"true\" and there is an abort callback registered for\n   * the specified operation, it triggers the callback. Then, in any case,\n   * it drops the callback.\n   */\n  asyncDataLoadDone(opid: string, aborted: boolean): void {\n    if (aborted) this.#asyncDataAbortCallbacks.get(opid)?.();\n    this.#asyncDataAbortCallbacks.delete(opid);\n  }\n\n  /**\n   * Drops the record of dependencies, if any, for the given path.\n   */\n  dropDependencies(path: string): void {\n    this.#dependencies.delete(path);\n  }\n\n  /**\n   * Checks if given `deps` are different from previously recorded ones for\n   * the given `path`. If they are, `deps` are recorded as the new deps for\n   * the `path`, and also the array is frozen, to prevent it from being\n   * modified.\n   *\n   * TODO: This may not work as expected if path string is not normalized,\n   * and the for the same path different alternative ways to spell it down\n   * are used. We should normalize given path here, I guess, or on a higher\n   * level in the logic?\n   */\n  hasChangedDependencies(path: string, deps: unknown[]): boolean {\n    const prevDeps = this.#dependencies.get(path);\n    let changed = prevDeps?.length !== deps.length;\n    for (let i = 0; !changed && i < deps.length; ++i) {\n      changed = prevDeps![i] !== deps[i];\n    }\n    this.#dependencies.set(path, Object.freeze(deps));\n    return changed;\n  }\n\n  /**\n   * Gets entire state, the same way as .get(null, opts) would do.\n   * @param opts.initialState\n   * @param opts.initialValue\n   */\n  getEntireState(opts?: GetOptsT<StateT>): StateT {\n    let state = opts?.initialState ? this.#initialState : this.#currentState;\n    if (state !== undefined || opts?.initialValue === undefined) return state;\n\n    const iv = opts.initialValue;\n    state = typeof iv === 'function' ? (iv as () => StateT)() : iv;\n    if (this.#currentState === undefined) this.setEntireState(state);\n    return state;\n  }\n\n  /**\n   * Notifies all connected state watchers that a state update has happened.\n   */\n  private notifyStateUpdate(path: null | string | undefined, value: unknown) {\n    if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n      /* eslint-disable no-console */\n      const p = typeof path === 'string'\n        ? `\"${path}\"` : 'none (entire state update)';\n      console.groupCollapsed(`ReactGlobalState update. Path: ${p}`);\n      console.log('New value:', cloneDeepForLog(value, path ?? ''));\n      console.log('New state:', cloneDeepForLog(this.#currentState));\n      console.groupEnd();\n      /* eslint-enable no-console */\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 = undefined;\n        const watchers = [...this.#watchers];\n        for (const watcher of watchers) watcher();\n      });\n    }\n  }\n\n  /**\n   * Registers an abort callback for an async data retrieval operation with\n   * the given operation ID. Throws if already registered.\n   */\n  setAsyncDataAbortCallback(opid: string, cb: () => void): void {\n    this.#asyncDataAbortCallbacks.set(opid, cb);\n  }\n\n  /**\n   * Sets entire state, the same way as .set(null, value) would do.\n   * @param value\n   */\n  setEntireState(value: StateT): StateT {\n    if (this.#currentState !== value) {\n      this.#currentState = value;\n      this.notifyStateUpdate(null, value);\n    }\n    return value;\n  }\n\n  /**\n   * Gets current or initial value at the specified \"path\" of the global state.\n   * @param path Dot-delimitered state path.\n   * @param options Additional options.\n   * @param options.initialState If \"true\" the value will be read\n   *  from the initial state instead of the current one.\n   * @param 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 Retrieved value.\n   */\n\n  // .get() without arguments just falls back to .getEntireState().\n  get(): StateT;\n\n  // This variant attempts to automatically resolve and check the type of value\n  // at the given path, as precise as the actual state and path types permit.\n  // If the automatic path resolution is not possible, the ValueT fallsback\n  // to `never` (or to `undefined` in some cases), effectively forbidding\n  // to use this .get() variant.\n  get<\n    PathT extends null | string | undefined,\n    ValueArgT extends ValueAtPathT<StateT, PathT, never>,\n    ValueResT extends ValueAtPathT<StateT, PathT, void>,\n  >(path: PathT, opts?: GetOptsT<ValueArgT>): ValueResT;\n\n  // This variant is not callable by default (without generic arguments),\n  // otherwise it allows to set the correct ValueT directly.\n  get<Forced extends ForceT | LockT = LockT, ValueT = void>(\n    path?: null | string,\n    opts?: GetOptsT<TypeLock<Forced, never, ValueT>>,\n  ): TypeLock<Forced, void, ValueT>;\n\n  get<ValueT>(path?: null | string, opts?: GetOptsT<ValueT>): ValueT {\n    if (typeof path !== 'string') {\n      const res = this.getEntireState((opts as unknown) as GetOptsT<StateT>);\n      return (res as unknown) as ValueT;\n    }\n\n    const state = opts?.initialState ? this.#initialState : this.#currentState;\n\n    let res = get(state, path) as ValueT;\n    if (res !== undefined || opts?.initialValue === undefined) return res;\n\n    const iv = opts.initialValue;\n    res = typeof iv === 'function' ? (iv as () => ValueT)() : iv;\n\n    // TODO: Revise.\n    // eslint-disable-next-line @typescript-eslint/no-confusing-void-expression\n    if (!opts.initialState || (this.get(path) as unknown) === undefined) {\n      this.set<ForceT, unknown>(path, res);\n    }\n\n    return res;\n  }\n\n  /**\n   * Writes the `value` to given global state `path`.\n   * @param path Dot-delimitered state path. If not given, entire\n   * global state content is replaced by the `value`.\n   * @param value The value.\n   * @return Given `value` itself.\n   */\n\n  // This variant attempts automatic value type resolution & checking.\n  set<\n    PathT extends null | string | undefined,\n    ValueArgT extends ValueAtPathT<StateT, PathT, never>,\n    ValueResT extends ValueAtPathT<StateT, PathT, void>,\n  >(path: PathT, value: ValueArgT): ValueResT;\n\n  // This variant is disabled by default, otherwise allows to give\n  // expected value type explicitly.\n  set<Forced extends ForceT | LockT = LockT, ValueT = never>(\n    path: null | string | undefined,\n    value: TypeLock<Forced, never, ValueT>,\n  ): TypeLock<Forced, void, ValueT>;\n\n  set(path: null | string | undefined, value: unknown): unknown {\n    if (typeof path !== 'string') return this.setEntireState(value as StateT);\n\n    // TODO: Revise.\n    // eslint-disable-next-line @typescript-eslint/no-confusing-void-expression\n    if (value !== this.get(path)) {\n      const root = { state: this.#currentState };\n      let segIdx = 0;\n\n      // TODO: It is not 100% correct, as `pos` can be an array, or any other\n      // value as we travel through the state tree. To simplify the typing for\n      // now, I guess, we can go with this record type, though.\n      let pos: Record<string, unknown> = root;\n      const pathSegments = toPath(`state.${path}`);\n      for (; segIdx < pathSegments.length - 1; segIdx += 1) {\n        const seg = pathSegments[segIdx]!;\n\n        // TODO: Revise: Typing is not quite correct here, but it works fine in the runtime.\n        const next = pos[seg];\n        if (Array.isArray(next)) pos[seg] = [...(next as unknown[])];\n        else if (typeof next === 'object') 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] as Record<string, unknown>;\n      }\n\n      if (segIdx === pathSegments.length - 1) {\n        pos[pathSegments[segIdx]!] = value;\n      }\n\n      this.#currentState = root.state;\n\n      this.notifyStateUpdate(path, value);\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 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: CallbackT): void {\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  /**\n   * Subscribes `callback` to watch state updates; no operation if\n   * `callback` is already subscribed to this state instance.\n   * @param 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: CallbackT): void {\n    if (this.ssrContext) throw new Error(ERR_NO_SSR_WATCH);\n\n    const watchers = this.#watchers;\n    if (!watchers.includes(callback)) {\n      watchers.push(callback);\n    }\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/build/logic/GlobalStateProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlobalStateProvider.js","names":["state"],"sources":["../../src/GlobalStateProvider.tsx"],"sourcesContent":["import {\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 * Returns the GlobalState object from the context. In most cases you should use\n * other hooks, like useGlobalState(), etc. to interact with the global state,\n * instead of accessing the GlobalState object directly.\n */\nexport function useGlobalStateObject<\n  StateT,\n  SsrContextT extends SsrContext<StateT> = SsrContext<StateT>,\n>(): GlobalState<StateT, SsrContextT> {\n  const globalState = use(Context);\n  if (!globalState) throw new Error('Missing GlobalStateProvider');\n  return globalState as GlobalState<StateT, SsrContextT>;\n}\n\n/**\n * Returns SSR context.\n * @param throwWithoutSsrContext - If _true_ (default), this hook will throw\n *  if no SSR context is attached to the global state; set _false_ to not throw\n *  in such case. In either case this hook will throw if the <GlobalStateProvider>\n *  (hence the global state) is missing.\n * @returns SSR context.\n * @throws\n *  - If current component has no parent <GlobalStateProvider> in the rendered\n *    React tree.\n *  - If `throwWithoutSsrContext` is _true_ (default), and there is no SSR\n *    context attached to the global state provided by <GlobalStateProvider>.\n */\nexport function useSsrContext<\n  SsrContextT extends SsrContext<unknown>,\n>(\n  throwWithoutSsrContext = true,\n): SsrContextT | undefined {\n  const { ssrContext } = useGlobalStateObject<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> = (NewStateProps<StateT, SsrContextT> | {\n  stateProxy: GlobalState<StateT, SsrContextT> | true;\n}) & {\n  children?: ReactNode;\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\n    if (rest.stateProxy === true) {\n      const gs = use(Context);\n      if (!gs) throw Error('Missing GlobalStateProvider');\n      state = gs as GlobalState<StateT, SsrContextT>;\n    } else state = 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      typeof initialState === 'function' ? (initialState as () => StateT)() : 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,SAEE,aAAa,EACb,GAAG,EACH,QAAQ,QACH,OAAO;AAAC,OAER,WAAW;AAAA;AAKlB,MAAM,OAAO,gBAAG,aAAa,CAA8B,IAAI,CAAC;;AAEhE;AACA;AACA;AACA;AACA;AACA,OAAO,SAAS,oBAAoB,GAGE;EACpC,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC;EAChC,IAAI,CAAC,WAAW,EAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC;EAChE,OAAO,WAAW;AACpB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO;EAGL,iCAA6B,KAA7B,SAA6B,GAA7B,IAA6B,GAA7B,EAA6B;EAE7B;IAAA;EAAA,IAAuB,oBAAoB,CAAoC,CAAC;EAChF,IAAI,CAAC,UAAoC,IAArC,sBAAqC;IACvC,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC;EAAC;EACzC,OACM,UAAU;AAAA;AAiBnB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,mBAAmB,GAAG;EAAA;EAI1B;IAAA;IAAA;EAAA,MAAoE;EAIpE,oCAAoC,QAAQ,CAAM,CAAC;EAE/CA,GAAA;EAMJ,IAAI,YAAY,IAAI,IAAoC,IAA3B,IAAI,WAAuB;IACtD,IAAI,UAAU;MAAE,aAAa,CAAC,SAAS,CAAC;IAAA;IAExC,IAAI,IAAI,WAAW,KAAK,IAAI;MAC1B,WAAW,GAAG,CAAC,OAAO,CAAC;MACvB,IAAI,CAAC,EAAE;QAAE,MAAM,KAAK,CAAC,6BAA6B,CAAC;MAAC;MACpD,MAAAA,CAAA,CAAQ,EAAE;IAAL;MACA,MAAAA,CAAA,CAAQ,IAAI,WAAW;IAAlB;EAAmB;IAC1B,IAAI,UAAU;MACnB,MAAAA,CAAA,CAAQ,UAAU;IAAb;MAEL;QAAA;QAAA;MAAA,IAGI,IAAI;MAER,MAAAA,CAAA,CAAQA,GAAA,CAAI,WAAW,CACrB,OAAO,YAAY,KAAK,UAA4D,GAA9C,YAAY,CAAiC,CAAC,GAApF,YAAoF,EACpF,UACF,CAAC;MAED,aAAa,CAAC,KAAK,CAAC;IAAA;EACrB;EAAA;EAAA;IAEM,uBAAC,OAAO;MAAQA,KAAK,EAAL,KAAK;MAAA,UAAG;IAAQ,CAAU,CAAC;IAAA;IAAA;IAAA;EAAA;IAAA;EAAA;EAAA,OAA3C,EAA2C;AAAA,CACnD;AAED,eAAe,mBAAmB","ignoreList":[]}

package/build/logic/SsrContext.js

@@ -0,0 +1,8 @@
+export default class SsrContext {
+  dirty = false;
+  pending = [];
+  constructor(state) {
+    this.state = state;
+  }
+}
+//# sourceMappingURL=SsrContext.js.map

package/build/logic/SsrContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SsrContext.js","names":[],"sources":["../../src/SsrContext.ts"],"sourcesContent":["export default class SsrContext<StateT> {\n  dirty: boolean = false;\n\n  pending: Array<Promise<void>> = [];\n\n  constructor(public state?: StateT) { }\n}\n"],"mappings":"AAAA,eAAe,MAAM,UAAU,CAAS;EACtC,KAAK,GAAY,KAAK;EAEtB,OAAO,GAAyB,EAAE;EAElC,WAAW,CAAQ,KAAc,EAAE;IAAA,KAAhB,KAAc,GAAd,KAAc;EAAI;AACvC","ignoreList":[]}

package/build/logic/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/index.ts"],"sourcesContent":["import GlobalState from './GlobalState';\n\nimport GlobalStateProvider, {\n  useGlobalStateObject,\n  useSsrContext,\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 LoadAsyncDataI,\n  type UseAsyncDataI,\n  type UseAsyncDataOptionsT,\n  type UseAsyncDataResT,\n  loadAsyncData,\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  GlobalState,\n  GlobalStateProvider,\n  SsrContext,\n  type UseAsyncCollectionI,\n  type UseAsyncCollectionResT,\n  type UseAsyncDataI,\n  type UseAsyncDataOptionsT,\n  type UseAsyncDataResT,\n  type UseGlobalStateI,\n  loadAsyncData,\n  newAsyncDataEnvelope,\n  useAsyncCollection,\n  useAsyncData,\n  useGlobalState,\n  useGlobalStateObject,\n  useSsrContext,\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  GlobalState: typeof GlobalState<StateT, SsrContextT>;\n  GlobalStateProvider: typeof GlobalStateProvider<StateT, SsrContextT>;\n  SsrContext: typeof SsrContext<StateT>;\n  loadAsyncData: LoadAsyncDataI<StateT>;\n  newAsyncDataEnvelope: typeof newAsyncDataEnvelope;\n  useAsyncCollection: UseAsyncCollectionI<StateT>;\n  useAsyncData: UseAsyncDataI<StateT>;\n  useGlobalState: UseGlobalStateI<StateT>;\n  useGlobalStateObject: typeof useGlobalStateObject<StateT, SsrContextT>;\n  useSsrContext: typeof useSsrContext<SsrContextT>;\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  loadAsyncData,\n  newAsyncDataEnvelope,\n  useAsyncCollection,\n  useAsyncData,\n  useGlobalState,\n  useGlobalStateObject,\n  useSsrContext,\n};\n\nexport function withGlobalStateType<\n  StateT,\n  SsrContextT extends SsrContext<StateT> = SsrContext<StateT>,\n>(): API<StateT, SsrContextT> {\n  return api;\n}\n"],"mappings":"OAAO,WAAW;AAAA,OAEX,mBAAmB,IACxB,oBAAoB,EACpB,aAAa;AAAA,OAGR,UAAU;AAAA,OAEV,kBAAkB;AAAA,SAavB,aAAa,EACb,oBAAoB,EACpB,YAAY;AAAA,OAGP,cAAc;AAYrB,SAIE,WAAW,EACX,mBAAmB,EACnB,UAAU,EAOV,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,aAAa;;AAGf;;AAiBA,MAAM,GAAG,GAAG;EACV;EACA;EACA;EACA,WAAW;EACX,mBAAmB;EACnB,UAAU;EACV,aAAa;EACb,oBAAoB;EACpB,kBAAkB;EAClB,YAAY;EACZ,cAAc;EACd,oBAAoB;EACpB;AACF,CAAC;AAED,OAAO,SAAS,mBAAmB,GAGL;EAC5B,OAAO,GAAG;AACZ","ignoreList":[]}

package/build/{code → logic}/useAsyncCollection.js

@@ -91,11 +91,10 @@ function normalizeIds(idOrIds) {
 // and reused in both hooks.
 // eslint-disable-next-line complexity
 function useAsyncCollection(idOrIds, path, loader, options = {}) {
-  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 maxage = options.maxage ?? DEFAULT_MAXAGE;
+  const refreshAge = options.refreshAge ?? maxage;
+  const garbageCollectAge = options.garbageCollectAge ?? maxage;
   const globalState = useGlobalStateObject();
 
   // Server-side logic.
@@ -147,14 +146,12 @@ function useAsyncCollection(idOrIds, path, loader, options = {}) {
     if (!disabled) {
       void (async () => {
         for (const id_0 of ids) {
-          var _state2$timestamp;
           const itemPath_0 = path ? `${path}.${id_0}` : `${id_0}`;
           const state2 = globalState.get(itemPath_0);
           const {
             deps
           } = options;
-          if (deps && globalState.hasChangedDependencies(itemPath_0, deps) || refreshAge < Date.now() - ((_state2$timestamp = state2 === null || state2 === void 0 ? void 0 : state2.timestamp) !== null && _state2$timestamp !== void 0 ? _state2$timestamp : 0) && (!(state2 !== null && state2 !== void 0 && state2.operationId) || state2.operationId.startsWith('S'))) {
-            var _state2$data, _state2$timestamp2;
+          if (deps && globalState.hasChangedDependencies(itemPath_0, deps) || refreshAge < Date.now() - (state2?.timestamp ?? 0) && (!state2?.operationId || state2.operationId.startsWith('S'))) {
             if (!deps) globalState.dropDependencies(itemPath_0);
             await loadAsyncData(itemPath_0,
             // TODO: I guess, the loader is not correctly typed here -
@@ -162,8 +159,8 @@ function useAsyncCollection(idOrIds, path, loader, options = {}) {
             // should be kept synchronous to not alter the sync logic.
             // eslint-disable-next-line @typescript-eslint/promise-function-async
             (old, ...args_0) => loader(id_0, old, ...args_0), globalState, {
-              data: (_state2$data = state2 === null || state2 === void 0 ? void 0 : state2.data) !== null && _state2$data !== void 0 ? _state2$data : null,
-              timestamp: (_state2$timestamp2 = state2 === null || state2 === void 0 ? void 0 : state2.timestamp) !== null && _state2$timestamp2 !== void 0 ? _state2$timestamp2 : 0
+              data: state2?.data ?? null,
+              timestamp: state2?.timestamp ?? 0
             });
           }
         }
@@ -172,7 +169,7 @@ 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 = {
+  ref.current ??= {
     globalState,
     ids,
     loader,
@@ -190,7 +187,7 @@ function useAsyncCollection(idOrIds, path, loader, options = {}) {
     const reload = async customLoader => {
       const rc = ref.current;
       if (!rc) throw Error('Internal error');
-      const localLoader = customLoader !== null && customLoader !== void 0 ? customLoader : rc.loader;
+      const localLoader = customLoader ?? rc.loader;
 
       // TODO: Revise - not sure all related typing is 100% correct,
       // thus let's keep this runtime assertion.
@@ -252,13 +249,12 @@ function useAsyncCollection(idOrIds, path, loader, options = {}) {
     };
   });
   if (!Array.isArray(idOrIds)) {
-    var _e_0$timestamp, _e_0$data;
     // TODO: Revise related typings!
     const e_0 = localState[idOrIds];
-    const timestamp = (_e_0$timestamp = e_0 === null || e_0 === void 0 ? void 0 : e_0.timestamp) !== null && _e_0$timestamp !== void 0 ? _e_0$timestamp : 0;
+    const timestamp = e_0?.timestamp ?? 0;
     return {
-      data: stale[idOrIds] ? null : (_e_0$data = e_0 === null || e_0 === void 0 ? void 0 : e_0.data) !== null && _e_0$data !== void 0 ? _e_0$data : null,
-      loading: !!(e_0 !== null && e_0 !== void 0 && e_0.operationId),
+      data: stale[idOrIds] ? null : e_0?.data ?? null,
+      loading: !!e_0?.operationId,
       reload: stable.reloadSingle,
       set: stable.setSingle,
       timestamp
@@ -271,17 +267,16 @@ function useAsyncCollection(idOrIds, path, loader, options = {}) {
     timestamp: Number.MAX_VALUE
   };
   for (const id_4 of ids) {
-    var _e_1$timestamp, _e_1$data;
     // TODO: Revise related typing. Should `localState` have a more specific type?
     const e_1 = localState[id_4];
-    const loading = !!(e_1 !== null && e_1 !== void 0 && e_1.operationId);
-    const timestamp_0 = (_e_1$timestamp = e_1 === null || e_1 === void 0 ? void 0 : e_1.timestamp) !== null && _e_1$timestamp !== void 0 ? _e_1$timestamp : 0;
+    const loading = !!e_1?.operationId;
+    const timestamp_0 = e_1?.timestamp ?? 0;
     res.items[id_4] = {
-      data: stale[id_4] ? null : (_e_1$data = e_1 === null || e_1 === void 0 ? void 0 : e_1.data) !== null && _e_1$data !== void 0 ? _e_1$data : null,
+      data: stale[id_4] ? null : e_1?.data ?? null,
       loading,
       timestamp: timestamp_0
     };
-    res.loading || (res.loading = loading);
+    res.loading ||= loading;
     if (res.timestamp > timestamp_0) res.timestamp = timestamp_0;
   }
   return res;

package/build/logic/useAsyncCollection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAsyncCollection.js","names":["id","itemPath","args","promiseOrVoid","customLoader","e","timestamp"],"sources":["../../src/useAsyncCollection.ts"],"sourcesContent":["/**\n * Loads and uses item(s) in an async collection.\n */\n\nimport { useEffect, useRef, useState } from 'react';\n\nimport type GlobalState from './GlobalState';\nimport { useGlobalStateObject } from './GlobalStateProvider';\n\nimport {\n  type AsyncDataEnvelopeT,\n  type AsyncDataReloaderT,\n  DEFAULT_MAXAGE,\n  type DataInEnvelopeAtPathT,\n  type OperationIdT,\n  type UseAsyncDataOptionsT,\n  type UseAsyncDataResT,\n  loadAsyncData,\n  newAsyncDataEnvelope,\n} from './useAsyncData';\n\nimport useGlobalState from './useGlobalState';\n\nimport {\n  type ForceT,\n  type LockT,\n  type TypeLock,\n  areEqual,\n  isDebugMode,\n} from './utils';\n\nexport type AsyncCollectionT<\n  DataT = unknown,\n  IdT extends number | string = number | string,\n> = Partial<Record<IdT, AsyncDataEnvelopeT<DataT>>>;\n\nexport type AsyncCollectionLoaderT<\n  DataT,\n  IdT extends number | string = number | string,\n> = (id: IdT, oldData: DataT | null, meta: {\n  abortSignal: AbortSignal;\n  oldDataTimestamp: number;\n}) => DataT | Promise<DataT | null> | null;\n\nexport type AsyncCollectionReloaderT<\n  DataT,\n  IdT extends number | string = number | string,\n> = (loader?: AsyncCollectionLoaderT<DataT, IdT>) => Promise<void> | 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): UseAsyncCollectionResT<DataT, IdT> | UseAsyncDataResT<DataT>;\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): UseAsyncCollectionResT<DataT, IdT> | UseAsyncDataResT<DataT> {\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 = useGlobalStateObject();\n\n  // Server-side logic.\n  if (globalState.ssrContext) {\n    if (!options.disabled && !options.noSSR) {\n      const operationId: OperationIdT = `S${globalThis.crypto.randomUUID()}`;\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 = loadAsyncData<ForceT, DataT>(\n            itemPath,\n            (...args):\n              DataT | Promise<DataT | null> | 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\n  const { disabled } = options;\n\n  // Reference-counting & garbage collection.\n\n  const idsString = JSON.stringify(ids);\n\n  useEffect(() => {\n    const localIds = JSON.parse(idsString) as IdT[];\n\n    if (!disabled) gcOnWithhold(localIds, path, globalState);\n    return () => {\n      if (!disabled) {\n        gcOnRelease(localIds, path, globalState, garbageCollectAge);\n      }\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  }, [\n    disabled,\n    garbageCollectAge,\n    globalState,\n    idsString,\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(() => {\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 loadAsyncData<ForceT, DataT>(\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, ...args),\n              globalState,\n              {\n                data: state2?.data ?? null,\n                timestamp: state2?.timestamp ?? 0,\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 = loadAsyncData<ForceT, DataT>(\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  const [stale, setStale] = useState({} as Record<IdT, boolean>);\n\n  // TODO: Merge into the data-reloading effect above?\n  useEffect(() => {\n    const now = Date.now();\n    const nowStale = {} as Record<IdT, boolean>;\n    for (const [key, e] of Object.entries(localState)) {\n      nowStale[key as IdT] = maxage < now - e.timestamp;\n    }\n\n    const id = areEqual(stale, nowStale) ? null : requestAnimationFrame(() => {\n      setStale(nowStale);\n    });\n\n    return () => {\n      if (id !== null) cancelAnimationFrame(id);\n    };\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: stale[idOrIds] ? 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: stale[id] ? 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  ): UseAsyncCollectionResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>\n    | UseAsyncDataResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>>;\n}\n"],"mappings":"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","ignoreList":[]}

package/build/{code → logic}/useAsyncData.js

@@ -36,8 +36,8 @@ export function newAsyncDataEnvelope(initialData = null, {
 function setState(data, path, gs, prevState = gs.get(path)) {
   if (process.env.NODE_ENV !== 'production' && isDebugMode()) {
     /* eslint-disable no-console */
-    console.groupCollapsed(`ReactGlobalState: async data (re-)loaded. Path: "${path !== null && path !== void 0 ? path : ''}"`);
-    console.log('Data:', cloneDeepForLog(data, path !== null && path !== void 0 ? path : ''));
+    console.groupCollapsed(`ReactGlobalState: async data (re-)loaded. Path: "${path ?? ''}"`);
+    console.log('Data:', cloneDeepForLog(data, path ?? ''));
     /* eslint-enable no-console */
   }
   gs.set(path, {
@@ -62,7 +62,7 @@ function finalizeLoad(data, path, gs, operationId) {
   // set up, thus it should be cleaned out here.
   gs.asyncDataLoadDone(operationId, false);
   const state = gs.get(path);
-  if (operationId === (state === null || state === void 0 ? void 0 : state.operationId)) setState(data, path, gs, state);
+  if (operationId === state?.operationId) setState(data, path, gs, state);
 }
 /**
  * Executes the data loading operation.
@@ -86,7 +86,7 @@ export function loadAsyncData(path, loader, globalState, old,
 operationId = `C${globalThis.crypto.randomUUID()}`) {
   if (process.env.NODE_ENV !== 'production' && isDebugMode()) {
     /* eslint-disable no-console */
-    console.log(`ReactGlobalState: async data (re-)loading. Path: "${path !== null && path !== void 0 ? path : ''}"`);
+    console.log(`ReactGlobalState: async data (re-)loading. Path: "${path ?? ''}"`);
     /* eslint-enable no-console */
   }
   const operationIdPath = path ? `${path}.operationId` : 'operationId';
@@ -135,7 +135,6 @@ operationId = `C${globalThis.crypto.randomUUID()}`) {
 // as it is done inside useAsyncCollection().
 
 function useAsyncData(path, loader, t0) {
-  var _options$maxage, _options$refreshAge, _options$garbageColle;
   const $ = _c(38);
   let t1;
   if ($[0] !== t0) {
@@ -146,9 +145,9 @@ function useAsyncData(path, loader, t0) {
     t1 = $[1];
   }
   const options = t1;
-  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 maxage = options.maxage ?? DEFAULT_MAXAGE;
+  const refreshAge = options.refreshAge ?? maxage;
+  const garbageCollectAge = options.garbageCollectAge ?? maxage;
   const globalState = useGlobalStateObject();
   const state = globalState.get(path, {
     initialValue: newAsyncDataEnvelope()
@@ -189,7 +188,7 @@ function useAsyncData(path, loader, t0) {
   if ($[10] === Symbol.for("react.memo_cache_sentinel")) {
     t4 = () => ({
       reload: customLoader => {
-        const localLoader = customLoader !== null && customLoader !== void 0 ? customLoader : heap.loader;
+        const localLoader = customLoader ?? heap.loader;
         return loadAsyncData(heap.path, localLoader, heap.globalState);
       },
       set: data => {
@@ -229,9 +228,9 @@ function useAsyncData(path, loader, t0) {
           const state2 = globalState.get(path);
           if (state2.numRefs === 1 && garbageCollectAge < Date.now() - state2.timestamp) {
             if (process.env.NODE_ENV !== "production" && isDebugMode()) {
-              console.log(`ReactGlobalState - useAsyncData garbage collected at path ${path !== null && path !== void 0 ? path : ""}`);
+              console.log(`ReactGlobalState - useAsyncData garbage collected at path ${path ?? ""}`);
             }
-            globalState.dropDependencies(path !== null && path !== void 0 ? path : "");
+            globalState.dropDependencies(path ?? "");
             globalState.set(path, {
               ...state2,
               data: null,
@@ -264,9 +263,9 @@ function useAsyncData(path, loader, t0) {
         const {
           deps
         } = options;
-        if (deps && globalState.hasChangedDependencies(path !== null && path !== void 0 ? path : "", deps) || refreshAge < Date.now() - state2_0.timestamp && (!state2_0.operationId || state2_0.operationId.startsWith("S"))) {
+        if (deps && globalState.hasChangedDependencies(path ?? "", deps) || refreshAge < Date.now() - state2_0.timestamp && (!state2_0.operationId || state2_0.operationId.startsWith("S"))) {
           if (!deps) {
-            globalState.dropDependencies(path !== null && path !== void 0 ? path : "");
+            globalState.dropDependencies(path ?? "");
           }
           loadAsyncData(path, loader, globalState, {
             data: state2_0.data,

package/build/logic/useAsyncData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAsyncData.js","names":["state2"],"sources":["../../src/useAsyncData.ts"],"sourcesContent":["/**\n * Loads and uses async data into the GlobalState path.\n */\n\nimport { useEffect, useRef, useState } from 'react';\n\nimport { MIN_MS } from '@dr.pogodin/js-utils';\n\nimport type GlobalState from './GlobalState';\nimport { useGlobalStateObject } from './GlobalStateProvider';\n\nimport type SsrContext from './SsrContext';\n\nimport useGlobalState from './useGlobalState';\nimport {\n  type ForceT,\n  type LockT,\n  type TypeLock,\n  type ValueAtPathT,\n  cloneDeepForLog,\n  isDebugMode,\n} from './utils';\n\nexport const DEFAULT_MAXAGE = 5 * MIN_MS; // 5 minutes.\n\n// NOTE: Here, and below it is important whether a loader and related\n// (re-)loading handlers return a promise or a value, as returning promises\n// mean the async mode, in which related global state values are updated\n// asynchronously (the new value comes into effect in a next rendering cycle),\n// while returning a non-promise value means a synchronous mode, in which\n// related global state values are updated immediately, within the current\n// rendering cycle.\n\nexport type AsyncDataLoaderT<DataT>\n  = (oldData: DataT | null, meta: {\n    abortSignal: AbortSignal;\n    oldDataTimestamp: number;\n  }) => DataT | Promise<DataT | null> | null;\n\nexport type AsyncDataReloaderT<DataT>\n  = (loader?: AsyncDataLoaderT<DataT>) => Promise<void> | void;\n\nexport type AsyncDataEnvelopeT<DataT> = {\n  data: DataT | null;\n  numRefs: number;\n  operationId: string;\n  timestamp: number;\n};\n\nexport type OperationIdT = `${'C' | 'S'}${string}`;\n\nexport function newAsyncDataEnvelope<DataT>(\n  initialData: DataT | null = null,\n  { numRefs = 0, timestamp = 0 } = {},\n): AsyncDataEnvelopeT<DataT> {\n  return {\n    data: initialData,\n    numRefs,\n    operationId: '',\n    timestamp,\n  };\n}\n\nexport type UseAsyncDataOptionsT = {\n  deps?: unknown[];\n  disabled?: boolean;\n  garbageCollectAge?: number;\n  maxage?: number;\n  noSSR?: boolean;\n  refreshAge?: number;\n};\n\nexport type UseAsyncDataResT<DataT> = {\n  data: DataT | null;\n  loading: boolean;\n  reload: AsyncDataReloaderT<DataT>;\n  set: (data: DataT | null) => void;\n  timestamp: number;\n};\n\n/**\n * Writes data into the global state, and prints console messages in the debug\n * mode.\n */\nfunction setState<\n  DataT,\n  EnvT extends AsyncDataEnvelopeT<DataT>,\n>(\n  data: DataT,\n  path: null | string | undefined,\n  gs: GlobalState<unknown, SsrContext<unknown>>,\n  prevState: EnvT = gs.get<ForceT, EnvT>(path),\n) {\n  if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n    /* eslint-disable no-console */\n    console.groupCollapsed(\n      `ReactGlobalState: async data (re-)loaded. Path: \"${\n        path ?? ''\n      }\"`,\n    );\n    console.log('Data:', cloneDeepForLog(data, path ?? ''));\n    /* eslint-enable no-console */\n  }\n\n  gs.set<ForceT, AsyncDataEnvelopeT<DataT>>(path, {\n    ...prevState,\n    data,\n    operationId: '',\n    timestamp: Date.now(),\n  });\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\nfunction finalizeLoad<DataT>(\n  data: DataT,\n  path: null | string | undefined,\n  gs: GlobalState<unknown, SsrContext<unknown>>,\n  operationId: OperationIdT,\n): void {\n  // NOTE: We don't really mean that it hasn't been aborted,\n  // the \"false\" flag rather says we don't need to trigger \"on aborted\"\n  // callback for this operation, if any is registered - just drop it.\n  //\n  // Also, in the synchronous state update mode, we don't really need to set up\n  // the abort callback at all (as there is no way to use it), but for now it is\n  // set up, thus it should be cleaned out here.\n  gs.asyncDataLoadDone(operationId, false);\n\n  type EnvT = AsyncDataEnvelopeT<DataT> | undefined;\n  const state: EnvT = gs.get<ForceT, EnvT>(path);\n\n  if (operationId === state?.operationId) setState(data, path, gs, state);\n}\n\nexport function loadAsyncData<\n  StateT,\n  PathT extends null | string | undefined,\n  DataT extends DataInEnvelopeAtPathT<\n    StateT, PathT> = DataInEnvelopeAtPathT<StateT, PathT>,\n>(\n  path: PathT,\n  loader: AsyncDataLoaderT<DataT>,\n  globalState: GlobalState<StateT, SsrContext<StateT>>,\n  old?: { data: DataT | null; timestamp: number },\n  operationId?: OperationIdT,\n): Promise<void> | void;\n\nexport function loadAsyncData<\n  Forced extends ForceT | LockT = LockT,\n  DataT = unknown,\n>(\n  path: null | string | undefined,\n  loader: AsyncDataLoaderT<TypeLock<Forced, void, DataT>>,\n  globalState: GlobalState<unknown, SsrContext<unknown>>,\n  old?: { data: DataT | null; timestamp: number },\n  operationId?: OperationIdT,\n): Promise<void> | void;\n\n/**\n * Executes the data loading operation.\n * @param path Data segment path inside the global state.\n * @param loader Data loader.\n * @param globalState The global state instance.\n * @param 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 opIdPrefix 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 Resolves once the operation is done.\n * @ignore\n */\nexport function loadAsyncData<DataT>(\n  path: null | string | undefined,\n  loader: AsyncDataLoaderT<DataT>,\n  globalState: GlobalState<unknown, SsrContext<unknown>>,\n  old?: { data: DataT | null; timestamp: number },\n\n  // TODO: Should this parameter be just a binary flag (client or server),\n  // and UUID always generated inside this function? Or do we need it in\n  // the caller methods as well, in some cases (see useAsyncCollection()\n  // use case as well).\n  operationId: OperationIdT = `C${globalThis.crypto.randomUUID()}`,\n): Promise<void> | void {\n  if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n    /* eslint-disable no-console */\n    console.log(\n      `ReactGlobalState: async data (re-)loading. Path: \"${path ?? ''}\"`,\n    );\n    /* eslint-enable no-console */\n  }\n\n  const operationIdPath = path ? `${path}.operationId` : 'operationId';\n  {\n    const prevOperationId = globalState.get<ForceT, string>(operationIdPath);\n    if (prevOperationId) globalState.asyncDataLoadDone(prevOperationId, true);\n  }\n  globalState.set<ForceT, string>(operationIdPath, operationId);\n\n  let definedOld = old;\n  if (!definedOld) {\n    // TODO: Can we improve the typing, to avoid ForceT?\n    const e = globalState.get<ForceT, AsyncDataEnvelopeT<DataT>>(path);\n    definedOld = { data: e.data, timestamp: e.timestamp };\n  }\n\n  const controller = new AbortController();\n  globalState.setAsyncDataAbortCallback(operationId, () => {\n    controller.abort();\n  });\n\n  const dataOrPromise = loader(definedOld.data, {\n    abortSignal: controller.signal,\n    oldDataTimestamp: definedOld.timestamp,\n  });\n\n  if (dataOrPromise instanceof Promise) {\n    return dataOrPromise.then((data) => {\n      finalizeLoad(data, path, globalState, operationId);\n    }).finally(() => {\n      // NOTE: We don't really mean that it hasn't been aborted,\n      // the \"false\" flag rather says we don't need to trigger \"on aborted\"\n      // callback for this operation, if any is registered - just drop it.\n      globalState.asyncDataLoadDone(operationId, false);\n    });\n  }\n\n  finalizeLoad(dataOrPromise, path, globalState, operationId);\n  return undefined;\n}\n\n/**\n * Resolves asynchronous data, and stores them at given `path` of global\n * state.\n */\n\nexport type DataInEnvelopeAtPathT<\n  StateT,\n  PathT extends null | string | undefined,\n> = Exclude<Extract<ValueAtPathT<StateT, PathT, void>, AsyncDataEnvelopeT<unknown>>['data'], null>;\n\n// TODO: Perhaps split the heap management to a dedicated hook,\n// as it is done inside useAsyncCollection().\ntype HeapT<DataT> = {\n  // NOTE: These heap fields are necessary to make reload() and set() stable\n  // functions.\n  globalState: GlobalState<unknown>;\n  loader: AsyncDataLoaderT<DataT>;\n  path: null | string | undefined;\n};\n\nfunction useAsyncData<\n  StateT,\n  PathT extends null | string | undefined,\n\n  DataT extends DataInEnvelopeAtPathT<\n    StateT, PathT> = DataInEnvelopeAtPathT<StateT, PathT>,\n>(\n  path: PathT,\n  loader: AsyncDataLoaderT<DataT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncDataResT<DataT>;\n\nfunction useAsyncData<\n  Forced extends ForceT | LockT = LockT,\n  DataT = void,\n>(\n  path: null | string | undefined,\n  loader: AsyncDataLoaderT<TypeLock<Forced, void, DataT>>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncDataResT<TypeLock<Forced, void, DataT>>;\n\nfunction useAsyncData<DataT>(\n  path: null | string | undefined,\n  loader: AsyncDataLoaderT<DataT>,\n  options: UseAsyncDataOptionsT = {},\n): UseAsyncDataResT<DataT> {\n  const maxage: number = options.maxage ?? DEFAULT_MAXAGE;\n  const refreshAge: number = options.refreshAge ?? maxage;\n  const garbageCollectAge: number = options.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 = useGlobalStateObject();\n  const state = globalState.get<ForceT, AsyncDataEnvelopeT<DataT>>(path, {\n    initialValue: newAsyncDataEnvelope<DataT>(),\n  });\n\n  const { current: heap } = useRef<HeapT<DataT>>({\n    globalState,\n    loader,\n    path,\n  });\n\n  useEffect(() => {\n    heap.globalState = globalState;\n    heap.path = path;\n    heap.loader = loader;\n  });\n\n  // NOTE: State inititalizer function here helps to avoid ESLint warnings\n  // about accessing references during the render.\n  const [stable] = useState(() => ({\n    reload: (\n      customLoader?: AsyncDataLoaderT<DataT>,\n    ): Promise<void> | void => {\n      const localLoader = customLoader ?? heap.loader;\n\n      return loadAsyncData<ForceT, DataT>(\n        heap.path,\n        localLoader,\n        heap.globalState,\n      );\n    },\n    set: (data: DataT | null) => {\n      setState(data, heap.path, heap.globalState);\n    },\n  }));\n\n  if (globalState.ssrContext) {\n    if (\n      !options.disabled && !options.noSSR\n      && !state.operationId && !state.timestamp\n    ) {\n      const promiseOrVoid = loadAsyncData<ForceT, DataT>(\n        path,\n        loader,\n        globalState,\n        {\n          data: state.data,\n          timestamp: state.timestamp,\n        },\n        `S${globalThis.crypto.randomUUID()}`,\n      );\n\n      if (promiseOrVoid instanceof Promise) {\n        globalState.ssrContext.pending.push(promiseOrVoid);\n      }\n    }\n  }\n\n  const { disabled } = options;\n\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(() => {\n    const numRefsPath = path ? `${path}.numRefs` : 'numRefs';\n    if (!disabled) {\n      const numRefs = globalState.get<ForceT, number>(numRefsPath);\n      globalState.set<ForceT, number>(numRefsPath, numRefs + 1);\n    }\n    return () => {\n      if (!disabled) {\n        const state2: AsyncDataEnvelopeT<DataT> = globalState.get<\n          ForceT, AsyncDataEnvelopeT<DataT>>(\n          path,\n        );\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.dropDependencies(path ?? '');\n          globalState.set<ForceT, AsyncDataEnvelopeT<DataT>>(path, {\n            ...state2,\n            data: null,\n            numRefs: 0,\n            timestamp: 0,\n          });\n        } else {\n          globalState.set<ForceT, number>(numRefsPath, state2.numRefs - 1);\n        }\n      }\n    };\n  }, [disabled, 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  useEffect(() => {\n    if (!disabled) {\n      const state2: AsyncDataEnvelopeT<DataT> = globalState.get<\n        ForceT, AsyncDataEnvelopeT<DataT>>(path);\n\n      const { deps } = options;\n      if (\n        // The hook is called with a list of dependencies, that mismatch\n        // dependencies last used to retrieve the data at given path.\n        (deps && globalState.hasChangedDependencies(path ?? '', deps))\n\n        // Data at the path are stale, and are not being loaded.\n        || (\n          refreshAge < Date.now() - state2.timestamp\n          && (!state2.operationId || state2.operationId.startsWith('S'))\n        )\n      ) {\n        if (!deps) globalState.dropDependencies(path ?? '');\n\n        void loadAsyncData<ForceT, DataT>(path, loader, globalState, {\n          data: state2.data,\n          timestamp: state2.timestamp,\n        });\n      }\n    }\n  });\n\n  const [localState] = useGlobalState<ForceT, AsyncDataEnvelopeT<DataT>>(\n    path,\n    newAsyncDataEnvelope<DataT>(),\n  );\n\n  const [stale, setStale] = useState<boolean>(\n    () => maxage < Date.now() - localState.timestamp,\n  );\n\n  // TODO: Merge into the data-reloading effect above?\n  useEffect(() => {\n    const nowStale = maxage < Date.now() - localState.timestamp;\n    const id = stale === nowStale ? null : requestAnimationFrame(() => {\n      setStale(nowStale);\n    });\n\n    return () => {\n      if (id !== null) cancelAnimationFrame(id);\n    };\n  });\n\n  return {\n    data: stale ? null : localState.data,\n    loading: !!localState.operationId,\n    reload: stable.reload,\n    set: stable.set,\n    timestamp: localState.timestamp,\n  };\n}\n\nexport { useAsyncData };\n\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\nexport interface LoadAsyncDataI<StateT> {\n  <\n    PathT extends null | string | undefined,\n    DataT extends DataInEnvelopeAtPathT<\n      StateT, PathT> = DataInEnvelopeAtPathT<StateT, PathT>,\n  >(\n    path: PathT,\n    loader: AsyncDataLoaderT<DataT>,\n    globalState: GlobalState<StateT, SsrContext<StateT>>,\n    old?: { data: DataT | null; timestamp: number },\n    operationId?: OperationIdT,\n  ): Promise<void> | void;\n\n  <Forced extends ForceT | LockT = LockT, DataT = unknown>(\n    path: null | string | undefined,\n    loader: AsyncDataLoaderT<TypeLock<Forced, void, DataT>>,\n    globalState: GlobalState<unknown, SsrContext<unknown>>,\n    old?: { data: DataT | null; timestamp: number },\n    operationId?: OperationIdT,\n  ): Promise<void> | void;\n}\n\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\nexport interface UseAsyncDataI<StateT> {\n  <PathT extends null | string | undefined>(\n    path: PathT,\n    loader: AsyncDataLoaderT<DataInEnvelopeAtPathT<StateT, PathT>>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncDataResT<DataInEnvelopeAtPathT<StateT, PathT>>;\n\n  <Forced extends ForceT | LockT = LockT, DataT = unknown>(\n    path: null | string | undefined,\n    loader: AsyncDataLoaderT<TypeLock<Forced, void, DataT>>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncDataResT<TypeLock<Forced, void, DataT>>;\n}\n"],"mappings":"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","ignoreList":[]}

package/build/{code → logic}/useGlobalState.js

@@ -65,7 +65,6 @@ initialValue
 // TODO: Revise it later!
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 ) {
-  var _ref$current;
   const globalState = useGlobalStateObject();
   const ref = useRef(null);
   const [stable] = useState(() => {
@@ -75,10 +74,9 @@ initialValue
       if (!rc) throw Error('Internal error');
       const newState = typeof value === 'function' ? value(rc.globalState.get(rc.path)) : value;
       if (process.env.NODE_ENV !== 'production' && isDebugMode()) {
-        var _rc$path, _rc$path2;
         /* eslint-disable no-console */
-        console.groupCollapsed(`ReactGlobalState - useGlobalState setter triggered for path ${(_rc$path = rc.path) !== null && _rc$path !== void 0 ? _rc$path : ''}`);
-        console.log('New value:', cloneDeepForLog(newState, (_rc$path2 = rc.path) !== null && _rc$path2 !== void 0 ? _rc$path2 : ''));
+        console.groupCollapsed(`ReactGlobalState - useGlobalState setter triggered for path ${rc.path ?? ''}`);
+        console.log('New value:', cloneDeepForLog(newState, rc.path ?? ''));
         console.groupEnd();
         /* eslint-enable no-console */
       }
@@ -108,7 +106,7 @@ initialValue
     initialState: true,
     initialValue
   }));
-  (_ref$current = ref.current) !== null && _ref$current !== void 0 ? _ref$current : ref.current = {
+  ref.current ??= {
     globalState,
     path,
     prevValue: value_0

package/build/logic/useGlobalState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGlobalState.js","names":["value"],"sources":["../../src/useGlobalState.ts"],"sourcesContent":["// Hook for updates of global state.\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 { useGlobalStateObject } 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 = useGlobalStateObject();\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 = typeof value === 'function'\n        ? (value as (x: unknown) => unknown)(\n          rc.globalState.get<ForceT, unknown>(rc.path),\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/logic/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","names":[],"sources":["../../src/utils.ts"],"sourcesContent":["import type { GetFieldType } from 'lodash';\nimport { cloneDeep } from 'lodash-es';\n\nimport type { ObjectKey } from '@dr.pogodin/js-utils';\n\nexport type CallbackT = () => void;\n\n// TODO: This (ForceT, LockT, and TypeLock) probably should be moved to JS Utils\n// lib.\n\nexport declare const force: unique symbol;\nexport declare const lock: unique symbol;\n\nexport type ForceT = typeof force;\nexport type LockT = typeof lock;\n\nexport type TypeLock<\n  Unlocked extends ForceT | LockT,\n\n  // TODO: Revise later.\n  // eslint-disable-next-line @typescript-eslint/no-redundant-type-constituents\n  LockedT extends never | void,\n  UnlockedT,\n> = Unlocked extends ForceT ? UnlockedT : LockedT;\n\n/**\n * Given the type of state, `StateT`, and the type of state path, `PathT`,\n * it evaluates the type of value at that path of the state, if it can be\n * evaluated from the path type (it is possible when `PathT` is a string\n * literal type, and `StateT` elements along this path have appropriate\n * types); otherwise it falls back to the specified `UnknownT` type,\n * which should be set either `never` (for input arguments), or `void`\n * (for return types) - `never` and `void` in those places forbid assignments,\n * and are not auto-inferred to more permissible types.\n *\n * BEWARE: When StateT is any the construct resolves to any for any string\n * paths.\n */\nexport type ValueAtPathT<\n  StateT,\n  PathT extends null | string | undefined,\n\n  // TODO: Revise later.\n  // eslint-disable-next-line @typescript-eslint/no-redundant-type-constituents, @typescript-eslint/no-invalid-void-type\n  UnknownT extends never | undefined | void,\n> = unknown extends StateT\n  ? UnknownT\n  : string extends PathT\n    ? UnknownT\n    : PathT extends null | undefined\n      ? StateT\n      : GetFieldType<StateT, PathT> extends undefined\n        ? UnknownT : GetFieldType<StateT, PathT>;\n\nexport type ValueOrInitializerT<ValueT> = (() => ValueT) | ValueT;\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\n * @ignore\n */\nexport function isDebugMode(): boolean {\n  try {\n    return process.env.NODE_ENV !== 'production'\n      && !!process.env.REACT_GLOBAL_STATE_DEBUG;\n  } catch {\n    return false;\n  }\n}\n\nconst cloneDeepBailKeys = new Set<string>();\n\n/**\n * Deep-clones given value for logging purposes, or returns the value itself\n * if the previous clone attempt, with the same key, took more than 300ms\n * (to avoid situations when large payload in the global state slows down\n * development versions of the app due to the logging overhead).\n */\nexport function cloneDeepForLog<T>(value: T, key: string = ''): T {\n  if (cloneDeepBailKeys.has(key)) {\n    // eslint-disable-next-line no-console\n    console.warn(`The logged value won't be clonned (key \"${key}\").`);\n    return value;\n  }\n\n  const start = Date.now();\n  const res = cloneDeep(value);\n  const time = Date.now() - start;\n  if (time > 300) {\n    // eslint-disable-next-line no-console\n    console.warn(`${time}ms spent to clone the logged value (key \"${key}\").`);\n    cloneDeepBailKeys.add(key);\n  }\n\n  return res;\n}\n\nexport function areEqual<K extends ObjectKey>(\n  a: Record<K, boolean>,\n  b: Record<K, boolean>,\n): boolean {\n  for (const [key, value] of Object.entries(a)) {\n    if (b[key as K] !== value) return false;\n  }\n  for (const [key, value] of Object.entries(b)) {\n    if (a[key as K] !== value) return false;\n  }\n  return true;\n}\n"],"mappings":"AACA,SAAS,SAAS,QAAQ,WAAW;;AAMrC;AACA;;AAiBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAmBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAAS,WAAW,GAAY;EACrC,IAAI;IACF,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,IACvC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB;EAC7C,CAAC,CAAC,MAAM;IACN,OAAO,KAAK;EACd;AACF;AAEA,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAS,CAAC;;AAE3C;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAAS,eAAe,CAAI,KAAQ,EAAE,GAAW,GAAG,EAAE,EAAK;EAChE,IAAI,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;IAC9B;IACA,OAAO,CAAC,IAAI,CAAC,2CAA2C,GAAG,KAAK,CAAC;IACjE,OAAO,KAAK;EACd;EAEA,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;EACxB,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,CAAC;EAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK;EAC/B,IAAI,IAAI,GAAG,GAAG,EAAE;IACd;IACA,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,4CAA4C,GAAG,KAAK,CAAC;IACzE,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC;EAC5B;EAEA,OAAO,GAAG;AACZ;AAEA,OAAO,SAAS,QAAQ,CACtB,CAAqB,EACrB,CAAqB,EACZ;EACT,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;IAC5C,IAAI,CAAC,CAAC,GAAG,CAAM,KAAK,KAAK,EAAE,OAAO,KAAK;EACzC;EACA,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;IAC5C,IAAI,CAAC,CAAC,GAAG,CAAM,KAAK,KAAK,EAAE,OAAO,KAAK;EACzC;EACA,OAAO,IAAI;AACb","ignoreList":[]}

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@dr.pogodin/react-global-state",
-  "version": "0.24.0",
+  "version": "0.25.0",
   "description": "Hook-based global state for React",
-  "main": "./build/code/index.js",
+  "main": "./build/logic/index.js",
   "types": "./build/types/index.d.ts",
   "exports": {
     "types": "./build/types/index.d.ts",
-    "default": "./build/code/index.js"
+    "default": "./build/logic/index.js"
   },
   "scripts": {
-    "build": "rimraf build && npm run build:types && npm run build:code",
-    "build:code": "rimraf build/code && babel src -x .ts,.tsx --out-dir build/code --source-maps --config-file ./babel.module.config.js",
+    "build": "rimraf build && npm run build:types && npm run build:logic",
+    "build:logic": "rimraf build/logic && NODE_ENV=production babel src -x .ts,.tsx --out-dir build/logic --source-maps --config-file ./babel.build.config.js",
     "build:types": "rimraf build/types && tsc --project tsconfig.types.json",
     "jest": "npm run jest:types && npm run jest:logic",
     "jest:logic": "jest --config jest/config.json -w 1 --no-cache",
@@ -39,26 +39,26 @@
     "node": ">=22"
   },
   "dependencies": {
-    "@babel/runtime": "^7.29.7",
-    "@dr.pogodin/js-utils": "^0.1.8",
+    "@dr.pogodin/js-utils": "^0.2.0",
     "@types/lodash": "^4.17.24",
     "lodash-es": "^4.18.1"
   },
   "devDependencies": {
-    "@babel/cli": "^7.29.7",
-    "@babel/core": "^7.29.7",
-    "@babel/node": "^7.29.7",
-    "@babel/plugin-transform-runtime": "^7.29.7",
-    "@babel/preset-env": "^7.29.7",
-    "@babel/preset-react": "^7.29.7",
-    "@babel/preset-typescript": "^7.29.7",
-    "@dr.pogodin/eslint-configs": "^0.2.14",
+    "@babel/cli": "^8.0.4",
+    "@babel/core": "^8.0.1",
+    "@babel/node": "^8.0.1",
+    "@babel/preset-env": "^8.0.2",
+    "@babel/preset-react": "^8.0.1",
+    "@babel/preset-typescript": "^8.0.1",
+    "@dr.pogodin/babel-plugin-add-import-extension": "^2.1.0",
+    "@dr.pogodin/eslint-configs": "^0.3.0",
     "@jest/globals": "^30.4.1",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.2",
     "@tsconfig/recommended": "^1.0.13",
     "@types/jest": "^30.0.0",
     "@types/lodash-es": "^4.17.12",
+    "@types/node": "^24.13.3",
     "@types/pretty": "^2.0.3",
     "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
@@ -71,10 +71,11 @@
     "mockdate": "^3.0.5",
     "rimraf": "^6.1.3",
     "tstyche": "^7.2.1",
-    "typescript": "^5.9.3"
+    "typescript": "^6.0.3"
   },
   "peerDependencies": {
     "react": "^19.2.7",
     "react-dom": "^19.2.7"
-  }
+  },
+  "type": "module"
 }

package/build/code/GlobalState.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"GlobalState.js","names":["get","set","toPath","cloneDeepForLog","isDebugMode","ERR_NO_SSR_WATCH","_asyncDataAbortCallbacks","WeakMap","_dependencies","_initialState","_watchers","_nextNotifierId","_currentState","GlobalState","constructor","initialState","ssrContext","_classPrivateFieldInitSpec","Map","_classPrivateFieldSet","dirty","pending","state","_classPrivateFieldGet","process","env","NODE_ENV","msg","console","groupCollapsed","log","groupEnd","numAsyncDataAbortCallbacks","size","asyncDataLoadDone","opid","aborted","_classPrivateFieldGet2","delete","dropDependencies","path","hasChangedDependencies","deps","prevDeps","changed","length","i","Object","freeze","getEntireState","opts","undefined","initialValue","iv","setEntireState","notifyStateUpdate","value","p","setTimeout","watchers","watcher","setAsyncDataAbortCallback","cb","res","root","segIdx","pos","pathSegments","seg","next","Array","isArray","slice","unWatch","callback","Error","indexOf","pop","watch","includes","push"],"sources":["../../src/GlobalState.ts"],"sourcesContent":["import { get, set, toPath } from 'lodash-es';\n\nimport type SsrContext from './SsrContext';\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\nconst ERR_NO_SSR_WATCH = 'GlobalState must not be watched at server side';\n\ntype GetOptsT<T> = {\n  initialState?: boolean;\n  initialValue?: ValueOrInitializerT<T>;\n};\n\nexport default class GlobalState<\n  StateT,\n  SsrContextT extends SsrContext<StateT> = SsrContext<StateT>,\n> {\n  readonly ssrContext?: SsrContextT;\n\n  #asyncDataAbortCallbacks = new Map<string, () => void>();\n\n  #dependencies = new Map<string, readonly unknown[]>();\n\n  #initialState: StateT;\n\n  // TODO: It is tempting to replace watchers here by\n  // Emitter from @dr.pogodin/js-utils, but we need to clone\n  // current watchers for emitting later, and this is not something\n  // Emitter supports right now.\n  #watchers: CallbackT[] = [];\n\n  #nextNotifierId?: NodeJS.Timeout;\n\n  #currentState: StateT;\n\n  /**\n   * Creates a new global state object.\n   * @param initialState Intial global state content.\n   * @param ssrContext Server-side rendering context.\n   */\n  constructor(\n    initialState: StateT,\n    ssrContext?: SsrContextT,\n  ) {\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:', cloneDeepForLog(initialState));\n      console.groupEnd();\n      /* eslint-enable no-console */\n    }\n  }\n\n  /**\n   * Returns the number of currently registered async data abort callbacks,\n   * just for the sake of testing the library.\n   */\n  get numAsyncDataAbortCallbacks(): number {\n    return this.#asyncDataAbortCallbacks.size;\n  }\n\n  /**\n   * If `aborted` is \"true\" and there is an abort callback registered for\n   * the specified operation, it triggers the callback. Then, in any case,\n   * it drops the callback.\n   */\n  asyncDataLoadDone(opid: string, aborted: boolean): void {\n    if (aborted) this.#asyncDataAbortCallbacks.get(opid)?.();\n    this.#asyncDataAbortCallbacks.delete(opid);\n  }\n\n  /**\n   * Drops the record of dependencies, if any, for the given path.\n   */\n  dropDependencies(path: string): void {\n    this.#dependencies.delete(path);\n  }\n\n  /**\n   * Checks if given `deps` are different from previously recorded ones for\n   * the given `path`. If they are, `deps` are recorded as the new deps for\n   * the `path`, and also the array is frozen, to prevent it from being\n   * modified.\n   *\n   * TODO: This may not work as expected if path string is not normalized,\n   * and the for the same path different alternative ways to spell it down\n   * are used. We should normalize given path here, I guess, or on a higher\n   * level in the logic?\n   */\n  hasChangedDependencies(path: string, deps: unknown[]): boolean {\n    const prevDeps = this.#dependencies.get(path);\n    let changed = prevDeps?.length !== deps.length;\n    for (let i = 0; !changed && i < deps.length; ++i) {\n      changed = prevDeps![i] !== deps[i];\n    }\n    this.#dependencies.set(path, Object.freeze(deps));\n    return changed;\n  }\n\n  /**\n   * Gets entire state, the same way as .get(null, opts) would do.\n   * @param opts.initialState\n   * @param opts.initialValue\n   */\n  getEntireState(opts?: GetOptsT<StateT>): StateT {\n    let state = opts?.initialState ? this.#initialState : this.#currentState;\n    if (state !== undefined || opts?.initialValue === undefined) return state;\n\n    const iv = opts.initialValue;\n    state = typeof iv === 'function' ? (iv as () => StateT)() : iv;\n    if (this.#currentState === undefined) this.setEntireState(state);\n    return state;\n  }\n\n  /**\n   * Notifies all connected state watchers that a state update has happened.\n   */\n  private notifyStateUpdate(path: null | string | undefined, value: unknown) {\n    if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n      /* eslint-disable no-console */\n      const p = typeof path === 'string'\n        ? `\"${path}\"` : 'none (entire state update)';\n      console.groupCollapsed(`ReactGlobalState update. Path: ${p}`);\n      console.log('New value:', cloneDeepForLog(value, path ?? ''));\n      console.log('New state:', cloneDeepForLog(this.#currentState));\n      console.groupEnd();\n      /* eslint-enable no-console */\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 = undefined;\n        const watchers = [...this.#watchers];\n        for (const watcher of watchers) watcher();\n      });\n    }\n  }\n\n  /**\n   * Registers an abort callback for an async data retrieval operation with\n   * the given operation ID. Throws if already registered.\n   */\n  setAsyncDataAbortCallback(opid: string, cb: () => void): void {\n    this.#asyncDataAbortCallbacks.set(opid, cb);\n  }\n\n  /**\n   * Sets entire state, the same way as .set(null, value) would do.\n   * @param value\n   */\n  setEntireState(value: StateT): StateT {\n    if (this.#currentState !== value) {\n      this.#currentState = value;\n      this.notifyStateUpdate(null, value);\n    }\n    return value;\n  }\n\n  /**\n   * Gets current or initial value at the specified \"path\" of the global state.\n   * @param path Dot-delimitered state path.\n   * @param options Additional options.\n   * @param options.initialState If \"true\" the value will be read\n   *  from the initial state instead of the current one.\n   * @param 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 Retrieved value.\n   */\n\n  // .get() without arguments just falls back to .getEntireState().\n  get(): StateT;\n\n  // This variant attempts to automatically resolve and check the type of value\n  // at the given path, as precise as the actual state and path types permit.\n  // If the automatic path resolution is not possible, the ValueT fallsback\n  // to `never` (or to `undefined` in some cases), effectively forbidding\n  // to use this .get() variant.\n  get<\n    PathT extends null | string | undefined,\n    ValueArgT extends ValueAtPathT<StateT, PathT, never>,\n    ValueResT extends ValueAtPathT<StateT, PathT, void>,\n  >(path: PathT, opts?: GetOptsT<ValueArgT>): ValueResT;\n\n  // This variant is not callable by default (without generic arguments),\n  // otherwise it allows to set the correct ValueT directly.\n  get<Forced extends ForceT | LockT = LockT, ValueT = void>(\n    path?: null | string,\n    opts?: GetOptsT<TypeLock<Forced, never, ValueT>>,\n  ): TypeLock<Forced, void, ValueT>;\n\n  get<ValueT>(path?: null | string, opts?: GetOptsT<ValueT>): ValueT {\n    if (typeof path !== 'string') {\n      const res = this.getEntireState((opts as unknown) as GetOptsT<StateT>);\n      return (res as unknown) as ValueT;\n    }\n\n    const state = opts?.initialState ? this.#initialState : this.#currentState;\n\n    let res = get(state, path) as ValueT;\n    if (res !== undefined || opts?.initialValue === undefined) return res;\n\n    const iv = opts.initialValue;\n    res = typeof iv === 'function' ? (iv as () => ValueT)() : iv;\n\n    // TODO: Revise.\n    // eslint-disable-next-line @typescript-eslint/no-confusing-void-expression\n    if (!opts.initialState || (this.get(path) as unknown) === undefined) {\n      this.set<ForceT, unknown>(path, res);\n    }\n\n    return res;\n  }\n\n  /**\n   * Writes the `value` to given global state `path`.\n   * @param path Dot-delimitered state path. If not given, entire\n   * global state content is replaced by the `value`.\n   * @param value The value.\n   * @return Given `value` itself.\n   */\n\n  // This variant attempts automatic value type resolution & checking.\n  set<\n    PathT extends null | string | undefined,\n    ValueArgT extends ValueAtPathT<StateT, PathT, never>,\n    ValueResT extends ValueAtPathT<StateT, PathT, void>,\n  >(path: PathT, value: ValueArgT): ValueResT;\n\n  // This variant is disabled by default, otherwise allows to give\n  // expected value type explicitly.\n  set<Forced extends ForceT | LockT = LockT, ValueT = never>(\n    path: null | string | undefined,\n    value: TypeLock<Forced, never, ValueT>,\n  ): TypeLock<Forced, void, ValueT>;\n\n  set(path: null | string | undefined, value: unknown): unknown {\n    if (typeof path !== 'string') return this.setEntireState(value as StateT);\n\n    // TODO: Revise.\n    // eslint-disable-next-line @typescript-eslint/no-confusing-void-expression\n    if (value !== this.get(path)) {\n      const root = { state: this.#currentState };\n      let segIdx = 0;\n\n      // TODO: It is not 100% correct, as `pos` can be an array, or any other\n      // value as we travel through the state tree. To simplify the typing for\n      // now, I guess, we can go with this record type, though.\n      let pos: Record<string, unknown> = root;\n      const pathSegments = toPath(`state.${path}`);\n      for (; segIdx < pathSegments.length - 1; segIdx += 1) {\n        const seg = pathSegments[segIdx]!;\n\n        // TODO: Revise: Typing is not quite correct here, but it works fine in the runtime.\n        const next = pos[seg];\n        if (Array.isArray(next)) pos[seg] = [...(next as unknown[])];\n        else if (typeof next === 'object') 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] as Record<string, unknown>;\n      }\n\n      if (segIdx === pathSegments.length - 1) {\n        pos[pathSegments[segIdx]!] = value;\n      }\n\n      this.#currentState = root.state;\n\n      this.notifyStateUpdate(path, value);\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 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: CallbackT): void {\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  /**\n   * Subscribes `callback` to watch state updates; no operation if\n   * `callback` is already subscribed to this state instance.\n   * @param 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: CallbackT): void {\n    if (this.ssrContext) throw new Error(ERR_NO_SSR_WATCH);\n\n    const watchers = this.#watchers;\n    if (!watchers.includes(callback)) {\n      watchers.push(callback);\n    }\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/build/code/GlobalStateProvider.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"GlobalStateProvider.js","names":["createContext","use","useState","GlobalState","jsx","_jsx","Context","useGlobalStateObject","globalState","Error","useSsrContext","t0","throwWithoutSsrContext","undefined","ssrContext","GlobalStateProvider","$","_c","children","rest","localState","setLocalState","state","stateProxy","gs","initialState","t1"],"sources":["../../src/GlobalStateProvider.tsx"],"sourcesContent":["import {\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 * Returns the GlobalState object from the context. In most cases you should use\n * other hooks, like useGlobalState(), etc. to interact with the global state,\n * instead of accessing the GlobalState object directly.\n */\nexport function useGlobalStateObject<\n  StateT,\n  SsrContextT extends SsrContext<StateT> = SsrContext<StateT>,\n>(): GlobalState<StateT, SsrContextT> {\n  const globalState = use(Context);\n  if (!globalState) throw new Error('Missing GlobalStateProvider');\n  return globalState as GlobalState<StateT, SsrContextT>;\n}\n\n/**\n * Returns SSR context.\n * @param throwWithoutSsrContext - If _true_ (default), this hook will throw\n *  if no SSR context is attached to the global state; set _false_ to not throw\n *  in such case. In either case this hook will throw if the <GlobalStateProvider>\n *  (hence the global state) is missing.\n * @returns SSR context.\n * @throws\n *  - If current component has no parent <GlobalStateProvider> in the rendered\n *    React tree.\n *  - If `throwWithoutSsrContext` is _true_ (default), and there is no SSR\n *    context attached to the global state provided by <GlobalStateProvider>.\n */\nexport function useSsrContext<\n  SsrContextT extends SsrContext<unknown>,\n>(\n  throwWithoutSsrContext = true,\n): SsrContextT | undefined {\n  const { ssrContext } = useGlobalStateObject<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> = (NewStateProps<StateT, SsrContextT> | {\n  stateProxy: GlobalState<StateT, SsrContextT> | true;\n}) & {\n  children?: ReactNode;\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\n    if (rest.stateProxy === true) {\n      const gs = use(Context);\n      if (!gs) throw Error('Missing GlobalStateProvider');\n      state = gs as GlobalState<StateT, SsrContextT>;\n    } else state = 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      typeof initialState === 'function' ? (initialState as () => StateT)() : 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,SAEEA,aAAa,EACbC,GAAG,EACHC,QAAQ,QACH,OAAO;AAAC,OAERC,WAAW;AAAA,SAAAC,GAAA,IAAAC,IAAA;AAKlB,MAAMC,OAAO,gBAAGN,aAAa,CAA8B,IAAI,CAAC;;AAEhE;AACA;AACA;AACA;AACA;AACA,OAAO,SAASO,oBAAoBA,CAAA,EAGE;EACpC,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,OAAO,SAAAE,cAAAC,EAAA;EAGL,MAAAC,sBAAA,GAAAD,EAA6B,KAA7BE,SAA6B,GAA7B,IAA6B,GAA7BF,EAA6B;EAE7B;IAAAG;EAAA,IAAuBP,oBAAoB,CAAoC,CAAC;EAChF,IAAI,CAACO,UAAoC,IAArCF,sBAAqC;IACvC,MAAM,IAAIH,KAAK,CAAC,sBAAsB,CAAC;EAAC;EACzC,OACMK,UAAU;AAAA;AAiBnB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,mBAAmB,GAAGJ,EAAA;EAAA,MAAAK,CAAA,GAAAC,EAAA;EAI1B;IAAAC,QAAA;IAAA,GAAAC;EAAA,IAAAR,EAAoE;EAIpE,OAAAS,UAAA,EAAAC,aAAA,IAAoCnB,QAAQ,CAAM,CAAC;EAE/CoB,GAAA,CAAAA,KAAA;EAMJ,IAAI,YAAY,IAAIH,IAAoC,IAA3BA,IAAI,CAAAI,UAAuB;IACtD,IAAIH,UAAU;MAAEC,aAAa,CAACR,SAAS,CAAC;IAAA;IAExC,IAAIM,IAAI,CAAAI,UAAW,KAAK,IAAI;MAC1B,MAAAC,EAAA,GAAWvB,GAAG,CAACK,OAAO,CAAC;MACvB,IAAI,CAACkB,EAAE;QAAE,MAAMf,KAAK,CAAC,6BAA6B,CAAC;MAAC;MACpDa,KAAA,CAAAA,CAAA,CAAQE,EAAE;IAAL;MACAF,KAAA,CAAAA,CAAA,CAAQH,IAAI,CAAAI,UAAW;IAAlB;EAAmB;IAC1B,IAAIH,UAAU;MACnBE,KAAA,CAAAA,CAAA,CAAQF,UAAU;IAAb;MAEL;QAAAK,YAAA;QAAAX;MAAA,IAGIK,IAAI;MAERG,KAAA,CAAAA,CAAA,CAAQA,GAAA,CAAInB,WAAW,CACrB,OAAOsB,YAAY,KAAK,UAA4D,GAA9CA,YAAY,CAAiC,CAAC,GAApFA,YAAoF,EACpFX,UACF,CAAC;MAEDO,aAAa,CAACC,KAAK,CAAC;IAAA;EACrB;EAAA,IAAAI,EAAA;EAAA,IAAAV,CAAA,QAAAE,QAAA,IAAAF,CAAA,QAAAM,KAAA;IAEMI,EAAA,gBAAArB,IAAA,CAACC,OAAO;MAAQgB,KAAK,EAALA,KAAK;MAAAJ,QAAA,EAAGA;IAAQ,CAAU,CAAC;IAAAF,CAAA,MAAAE,QAAA;IAAAF,CAAA,MAAAM,KAAA;IAAAN,CAAA,MAAAU,EAAA;EAAA;IAAAA,EAAA,GAAAV,CAAA;EAAA;EAAA,OAA3CU,EAA2C;AAAA,CACnD;AAED,eAAeX,mBAAmB","ignoreList":[]}

package/build/code/SsrContext.js

@@ -1,9 +0,0 @@
-import _defineProperty from "@babel/runtime/helpers/defineProperty";
-export default class SsrContext {
-  constructor(state) {
-    _defineProperty(this, "dirty", false);
-    _defineProperty(this, "pending", []);
-    this.state = state;
-  }
-}
-//# sourceMappingURL=SsrContext.js.map

package/build/code/SsrContext.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"SsrContext.js","names":["SsrContext","constructor","state","_defineProperty"],"sources":["../../src/SsrContext.ts"],"sourcesContent":["export default class SsrContext<StateT> {\n  dirty: boolean = false;\n\n  pending: Array<Promise<void>> = [];\n\n  constructor(public state?: StateT) { }\n}\n"],"mappings":";AAAA,eAAe,MAAMA,UAAU,CAAS;EAKtCC,WAAWA,CAAQC,KAAc,EAAE;IAAAC,eAAA,gBAJlB,KAAK;IAAAA,eAAA,kBAEU,EAAE;IAAA,KAEfD,KAAc,GAAdA,KAAc;EAAI;AACvC","ignoreList":[]}

package/build/code/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","names":["GlobalState","GlobalStateProvider","useGlobalStateObject","useSsrContext","SsrContext","useAsyncCollection","loadAsyncData","newAsyncDataEnvelope","useAsyncData","useGlobalState","api","withGlobalStateType"],"sources":["../../src/index.ts"],"sourcesContent":["import GlobalState from './GlobalState';\n\nimport GlobalStateProvider, {\n  useGlobalStateObject,\n  useSsrContext,\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 LoadAsyncDataI,\n  type UseAsyncDataI,\n  type UseAsyncDataOptionsT,\n  type UseAsyncDataResT,\n  loadAsyncData,\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  GlobalState,\n  GlobalStateProvider,\n  SsrContext,\n  type UseAsyncCollectionI,\n  type UseAsyncCollectionResT,\n  type UseAsyncDataI,\n  type UseAsyncDataOptionsT,\n  type UseAsyncDataResT,\n  type UseGlobalStateI,\n  loadAsyncData,\n  newAsyncDataEnvelope,\n  useAsyncCollection,\n  useAsyncData,\n  useGlobalState,\n  useGlobalStateObject,\n  useSsrContext,\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  GlobalState: typeof GlobalState<StateT, SsrContextT>;\n  GlobalStateProvider: typeof GlobalStateProvider<StateT, SsrContextT>;\n  SsrContext: typeof SsrContext<StateT>;\n  loadAsyncData: LoadAsyncDataI<StateT>;\n  newAsyncDataEnvelope: typeof newAsyncDataEnvelope;\n  useAsyncCollection: UseAsyncCollectionI<StateT>;\n  useAsyncData: UseAsyncDataI<StateT>;\n  useGlobalState: UseGlobalStateI<StateT>;\n  useGlobalStateObject: typeof useGlobalStateObject<StateT, SsrContextT>;\n  useSsrContext: typeof useSsrContext<SsrContextT>;\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  loadAsyncData,\n  newAsyncDataEnvelope,\n  useAsyncCollection,\n  useAsyncData,\n  useGlobalState,\n  useGlobalStateObject,\n  useSsrContext,\n};\n\nexport function withGlobalStateType<\n  StateT,\n  SsrContextT extends SsrContext<StateT> = SsrContext<StateT>,\n>(): API<StateT, SsrContextT> {\n  return api;\n}\n"],"mappings":"OAAOA,WAAW;AAAA,OAEXC,mBAAmB,IACxBC,oBAAoB,EACpBC,aAAa;AAAA,OAGRC,UAAU;AAAA,OAEVC,kBAAkB;AAAA,SAavBC,aAAa,EACbC,oBAAoB,EACpBC,YAAY;AAAA,OAGPC,cAAc;AAYrB,SAIET,WAAW,EACXC,mBAAmB,EACnBG,UAAU,EAOVE,aAAa,EACbC,oBAAoB,EACpBF,kBAAkB,EAClBG,YAAY,EACZC,cAAc,EACdP,oBAAoB,EACpBC,aAAa;;AAGf;;AAiBA,MAAMO,GAAG,GAAG;EACV;EACA;EACA;EACAV,WAAW;EACXC,mBAAmB;EACnBG,UAAU;EACVE,aAAa;EACbC,oBAAoB;EACpBF,kBAAkB;EAClBG,YAAY;EACZC,cAAc;EACdP,oBAAoB;EACpBC;AACF,CAAC;AAED,OAAO,SAASQ,mBAAmBA,CAAA,EAGL;EAC5B,OAAOD,GAAG;AACZ","ignoreList":[]}

package/build/code/useAsyncCollection.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"useAsyncCollection.js","names":["useEffect","useRef","useState","useGlobalStateObject","DEFAULT_MAXAGE","loadAsyncData","newAsyncDataEnvelope","useGlobalState","areEqual","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","globalThis","crypto","randomUUID","itemPath","state","initialValue","promiseOrVoid","args","data","Promise","pending","push","idsString","JSON","stringify","localIds","parse","_state2$timestamp","state2","deps","hasChangedDependencies","startsWith","_state2$data","_state2$timestamp2","dropDependencies","old","localState","ref","current","stable","reload","customLoader","rc","Error","localLoader","oldData","meta","reloadSingle","setSingle","stale","setStale","nowStale","key","e","requestAnimationFrame","cancelAnimationFrame","_e_0$timestamp","_e_0$data","loading","items","Number","MAX_VALUE","_e_1$timestamp","_e_1$data"],"sources":["../../src/useAsyncCollection.ts"],"sourcesContent":["/**\n * Loads and uses item(s) in an async collection.\n */\n\nimport { useEffect, useRef, useState } from 'react';\n\nimport type GlobalState from './GlobalState';\nimport { useGlobalStateObject } from './GlobalStateProvider';\n\nimport {\n  type AsyncDataEnvelopeT,\n  type AsyncDataReloaderT,\n  DEFAULT_MAXAGE,\n  type DataInEnvelopeAtPathT,\n  type OperationIdT,\n  type UseAsyncDataOptionsT,\n  type UseAsyncDataResT,\n  loadAsyncData,\n  newAsyncDataEnvelope,\n} from './useAsyncData';\n\nimport useGlobalState from './useGlobalState';\n\nimport {\n  type ForceT,\n  type LockT,\n  type TypeLock,\n  areEqual,\n  isDebugMode,\n} from './utils';\n\nexport type AsyncCollectionT<\n  DataT = unknown,\n  IdT extends number | string = number | string,\n> = Partial<Record<IdT, AsyncDataEnvelopeT<DataT>>>;\n\nexport type AsyncCollectionLoaderT<\n  DataT,\n  IdT extends number | string = number | string,\n> = (id: IdT, oldData: DataT | null, meta: {\n  abortSignal: AbortSignal;\n  oldDataTimestamp: number;\n}) => DataT | Promise<DataT | null> | null;\n\nexport type AsyncCollectionReloaderT<\n  DataT,\n  IdT extends number | string = number | string,\n> = (loader?: AsyncCollectionLoaderT<DataT, IdT>) => Promise<void> | 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): UseAsyncCollectionResT<DataT, IdT> | UseAsyncDataResT<DataT>;\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): UseAsyncCollectionResT<DataT, IdT> | UseAsyncDataResT<DataT> {\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 = useGlobalStateObject();\n\n  // Server-side logic.\n  if (globalState.ssrContext) {\n    if (!options.disabled && !options.noSSR) {\n      const operationId: OperationIdT = `S${globalThis.crypto.randomUUID()}`;\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 = loadAsyncData<ForceT, DataT>(\n            itemPath,\n            (...args):\n              DataT | Promise<DataT | null> | 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\n  const { disabled } = options;\n\n  // Reference-counting & garbage collection.\n\n  const idsString = JSON.stringify(ids);\n\n  useEffect(() => {\n    const localIds = JSON.parse(idsString) as IdT[];\n\n    if (!disabled) gcOnWithhold(localIds, path, globalState);\n    return () => {\n      if (!disabled) {\n        gcOnRelease(localIds, path, globalState, garbageCollectAge);\n      }\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  }, [\n    disabled,\n    garbageCollectAge,\n    globalState,\n    idsString,\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(() => {\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 loadAsyncData<ForceT, DataT>(\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, ...args),\n              globalState,\n              {\n                data: state2?.data ?? null,\n                timestamp: state2?.timestamp ?? 0,\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 = loadAsyncData<ForceT, DataT>(\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  const [stale, setStale] = useState({} as Record<IdT, boolean>);\n\n  // TODO: Merge into the data-reloading effect above?\n  useEffect(() => {\n    const now = Date.now();\n    const nowStale = {} as Record<IdT, boolean>;\n    for (const [key, e] of Object.entries(localState)) {\n      nowStale[key as IdT] = maxage < now - e.timestamp;\n    }\n\n    const id = areEqual(stale, nowStale) ? null : requestAnimationFrame(() => {\n      setStale(nowStale);\n    });\n\n    return () => {\n      if (id !== null) cancelAnimationFrame(id);\n    };\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: stale[idOrIds] ? 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: stale[id] ? 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  ): UseAsyncCollectionResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>\n    | UseAsyncDataResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>>;\n}\n"],"mappings":"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","ignoreList":[]}

package/build/code/useAsyncData.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"useAsyncData.js","names":["useEffect","useRef","useState","MIN_MS","useGlobalStateObject","useGlobalState","cloneDeepForLog","isDebugMode","DEFAULT_MAXAGE","newAsyncDataEnvelope","initialData","numRefs","timestamp","data","operationId","setState","path","gs","prevState","get","process","env","NODE_ENV","console","groupCollapsed","log","set","Date","now","groupEnd","finalizeLoad","asyncDataLoadDone","state","loadAsyncData","loader","globalState","old","globalThis","crypto","randomUUID","operationIdPath","prevOperationId","definedOld","e","controller","AbortController","setAsyncDataAbortCallback","abort","dataOrPromise","abortSignal","signal","oldDataTimestamp","Promise","then","finally","undefined","useAsyncData","t0","_options$maxage","_options$refreshAge","_options$garbageColle","$","_c","t1","options","maxage","refreshAge","garbageCollectAge","initialValue","t2","current","heap","t3","t4","Symbol","for","reload","customLoader","localLoader","stable","ssrContext","disabled","noSSR","promiseOrVoid","pending","push","t5","t6","numRefsPath","state2","dropDependencies","t7","state2_0","deps","hasChangedDependencies","startsWith","t8","localState","t9","stale","setStale","t10","nowStale","id","requestAnimationFrame","cancelAnimationFrame","t11","t12","t13","loading"],"sources":["../../src/useAsyncData.ts"],"sourcesContent":["/**\n * Loads and uses async data into the GlobalState path.\n */\n\nimport { useEffect, useRef, useState } from 'react';\n\nimport { MIN_MS } from '@dr.pogodin/js-utils';\n\nimport type GlobalState from './GlobalState';\nimport { useGlobalStateObject } from './GlobalStateProvider';\n\nimport type SsrContext from './SsrContext';\n\nimport useGlobalState from './useGlobalState';\nimport {\n  type ForceT,\n  type LockT,\n  type TypeLock,\n  type ValueAtPathT,\n  cloneDeepForLog,\n  isDebugMode,\n} from './utils';\n\nexport const DEFAULT_MAXAGE = 5 * MIN_MS; // 5 minutes.\n\n// NOTE: Here, and below it is important whether a loader and related\n// (re-)loading handlers return a promise or a value, as returning promises\n// mean the async mode, in which related global state values are updated\n// asynchronously (the new value comes into effect in a next rendering cycle),\n// while returning a non-promise value means a synchronous mode, in which\n// related global state values are updated immediately, within the current\n// rendering cycle.\n\nexport type AsyncDataLoaderT<DataT>\n  = (oldData: DataT | null, meta: {\n    abortSignal: AbortSignal;\n    oldDataTimestamp: number;\n  }) => DataT | Promise<DataT | null> | null;\n\nexport type AsyncDataReloaderT<DataT>\n  = (loader?: AsyncDataLoaderT<DataT>) => Promise<void> | void;\n\nexport type AsyncDataEnvelopeT<DataT> = {\n  data: DataT | null;\n  numRefs: number;\n  operationId: string;\n  timestamp: number;\n};\n\nexport type OperationIdT = `${'C' | 'S'}${string}`;\n\nexport function newAsyncDataEnvelope<DataT>(\n  initialData: DataT | null = null,\n  { numRefs = 0, timestamp = 0 } = {},\n): AsyncDataEnvelopeT<DataT> {\n  return {\n    data: initialData,\n    numRefs,\n    operationId: '',\n    timestamp,\n  };\n}\n\nexport type UseAsyncDataOptionsT = {\n  deps?: unknown[];\n  disabled?: boolean;\n  garbageCollectAge?: number;\n  maxage?: number;\n  noSSR?: boolean;\n  refreshAge?: number;\n};\n\nexport type UseAsyncDataResT<DataT> = {\n  data: DataT | null;\n  loading: boolean;\n  reload: AsyncDataReloaderT<DataT>;\n  set: (data: DataT | null) => void;\n  timestamp: number;\n};\n\n/**\n * Writes data into the global state, and prints console messages in the debug\n * mode.\n */\nfunction setState<\n  DataT,\n  EnvT extends AsyncDataEnvelopeT<DataT>,\n>(\n  data: DataT,\n  path: null | string | undefined,\n  gs: GlobalState<unknown, SsrContext<unknown>>,\n  prevState: EnvT = gs.get<ForceT, EnvT>(path),\n) {\n  if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n    /* eslint-disable no-console */\n    console.groupCollapsed(\n      `ReactGlobalState: async data (re-)loaded. Path: \"${\n        path ?? ''\n      }\"`,\n    );\n    console.log('Data:', cloneDeepForLog(data, path ?? ''));\n    /* eslint-enable no-console */\n  }\n\n  gs.set<ForceT, AsyncDataEnvelopeT<DataT>>(path, {\n    ...prevState,\n    data,\n    operationId: '',\n    timestamp: Date.now(),\n  });\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\nfunction finalizeLoad<DataT>(\n  data: DataT,\n  path: null | string | undefined,\n  gs: GlobalState<unknown, SsrContext<unknown>>,\n  operationId: OperationIdT,\n): void {\n  // NOTE: We don't really mean that it hasn't been aborted,\n  // the \"false\" flag rather says we don't need to trigger \"on aborted\"\n  // callback for this operation, if any is registered - just drop it.\n  //\n  // Also, in the synchronous state update mode, we don't really need to set up\n  // the abort callback at all (as there is no way to use it), but for now it is\n  // set up, thus it should be cleaned out here.\n  gs.asyncDataLoadDone(operationId, false);\n\n  type EnvT = AsyncDataEnvelopeT<DataT> | undefined;\n  const state: EnvT = gs.get<ForceT, EnvT>(path);\n\n  if (operationId === state?.operationId) setState(data, path, gs, state);\n}\n\nexport function loadAsyncData<\n  StateT,\n  PathT extends null | string | undefined,\n  DataT extends DataInEnvelopeAtPathT<\n    StateT, PathT> = DataInEnvelopeAtPathT<StateT, PathT>,\n>(\n  path: PathT,\n  loader: AsyncDataLoaderT<DataT>,\n  globalState: GlobalState<StateT, SsrContext<StateT>>,\n  old?: { data: DataT | null; timestamp: number },\n  operationId?: OperationIdT,\n): Promise<void> | void;\n\nexport function loadAsyncData<\n  Forced extends ForceT | LockT = LockT,\n  DataT = unknown,\n>(\n  path: null | string | undefined,\n  loader: AsyncDataLoaderT<TypeLock<Forced, void, DataT>>,\n  globalState: GlobalState<unknown, SsrContext<unknown>>,\n  old?: { data: DataT | null; timestamp: number },\n  operationId?: OperationIdT,\n): Promise<void> | void;\n\n/**\n * Executes the data loading operation.\n * @param path Data segment path inside the global state.\n * @param loader Data loader.\n * @param globalState The global state instance.\n * @param 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 opIdPrefix 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 Resolves once the operation is done.\n * @ignore\n */\nexport function loadAsyncData<DataT>(\n  path: null | string | undefined,\n  loader: AsyncDataLoaderT<DataT>,\n  globalState: GlobalState<unknown, SsrContext<unknown>>,\n  old?: { data: DataT | null; timestamp: number },\n\n  // TODO: Should this parameter be just a binary flag (client or server),\n  // and UUID always generated inside this function? Or do we need it in\n  // the caller methods as well, in some cases (see useAsyncCollection()\n  // use case as well).\n  operationId: OperationIdT = `C${globalThis.crypto.randomUUID()}`,\n): Promise<void> | void {\n  if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n    /* eslint-disable no-console */\n    console.log(\n      `ReactGlobalState: async data (re-)loading. Path: \"${path ?? ''}\"`,\n    );\n    /* eslint-enable no-console */\n  }\n\n  const operationIdPath = path ? `${path}.operationId` : 'operationId';\n  {\n    const prevOperationId = globalState.get<ForceT, string>(operationIdPath);\n    if (prevOperationId) globalState.asyncDataLoadDone(prevOperationId, true);\n  }\n  globalState.set<ForceT, string>(operationIdPath, operationId);\n\n  let definedOld = old;\n  if (!definedOld) {\n    // TODO: Can we improve the typing, to avoid ForceT?\n    const e = globalState.get<ForceT, AsyncDataEnvelopeT<DataT>>(path);\n    definedOld = { data: e.data, timestamp: e.timestamp };\n  }\n\n  const controller = new AbortController();\n  globalState.setAsyncDataAbortCallback(operationId, () => {\n    controller.abort();\n  });\n\n  const dataOrPromise = loader(definedOld.data, {\n    abortSignal: controller.signal,\n    oldDataTimestamp: definedOld.timestamp,\n  });\n\n  if (dataOrPromise instanceof Promise) {\n    return dataOrPromise.then((data) => {\n      finalizeLoad(data, path, globalState, operationId);\n    }).finally(() => {\n      // NOTE: We don't really mean that it hasn't been aborted,\n      // the \"false\" flag rather says we don't need to trigger \"on aborted\"\n      // callback for this operation, if any is registered - just drop it.\n      globalState.asyncDataLoadDone(operationId, false);\n    });\n  }\n\n  finalizeLoad(dataOrPromise, path, globalState, operationId);\n  return undefined;\n}\n\n/**\n * Resolves asynchronous data, and stores them at given `path` of global\n * state.\n */\n\nexport type DataInEnvelopeAtPathT<\n  StateT,\n  PathT extends null | string | undefined,\n> = Exclude<Extract<ValueAtPathT<StateT, PathT, void>, AsyncDataEnvelopeT<unknown>>['data'], null>;\n\n// TODO: Perhaps split the heap management to a dedicated hook,\n// as it is done inside useAsyncCollection().\ntype HeapT<DataT> = {\n  // NOTE: These heap fields are necessary to make reload() and set() stable\n  // functions.\n  globalState: GlobalState<unknown>;\n  loader: AsyncDataLoaderT<DataT>;\n  path: null | string | undefined;\n};\n\nfunction useAsyncData<\n  StateT,\n  PathT extends null | string | undefined,\n\n  DataT extends DataInEnvelopeAtPathT<\n    StateT, PathT> = DataInEnvelopeAtPathT<StateT, PathT>,\n>(\n  path: PathT,\n  loader: AsyncDataLoaderT<DataT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncDataResT<DataT>;\n\nfunction useAsyncData<\n  Forced extends ForceT | LockT = LockT,\n  DataT = void,\n>(\n  path: null | string | undefined,\n  loader: AsyncDataLoaderT<TypeLock<Forced, void, DataT>>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncDataResT<TypeLock<Forced, void, DataT>>;\n\nfunction useAsyncData<DataT>(\n  path: null | string | undefined,\n  loader: AsyncDataLoaderT<DataT>,\n  options: UseAsyncDataOptionsT = {},\n): UseAsyncDataResT<DataT> {\n  const maxage: number = options.maxage ?? DEFAULT_MAXAGE;\n  const refreshAge: number = options.refreshAge ?? maxage;\n  const garbageCollectAge: number = options.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 = useGlobalStateObject();\n  const state = globalState.get<ForceT, AsyncDataEnvelopeT<DataT>>(path, {\n    initialValue: newAsyncDataEnvelope<DataT>(),\n  });\n\n  const { current: heap } = useRef<HeapT<DataT>>({\n    globalState,\n    loader,\n    path,\n  });\n\n  useEffect(() => {\n    heap.globalState = globalState;\n    heap.path = path;\n    heap.loader = loader;\n  });\n\n  // NOTE: State inititalizer function here helps to avoid ESLint warnings\n  // about accessing references during the render.\n  const [stable] = useState(() => ({\n    reload: (\n      customLoader?: AsyncDataLoaderT<DataT>,\n    ): Promise<void> | void => {\n      const localLoader = customLoader ?? heap.loader;\n\n      return loadAsyncData<ForceT, DataT>(\n        heap.path,\n        localLoader,\n        heap.globalState,\n      );\n    },\n    set: (data: DataT | null) => {\n      setState(data, heap.path, heap.globalState);\n    },\n  }));\n\n  if (globalState.ssrContext) {\n    if (\n      !options.disabled && !options.noSSR\n      && !state.operationId && !state.timestamp\n    ) {\n      const promiseOrVoid = loadAsyncData<ForceT, DataT>(\n        path,\n        loader,\n        globalState,\n        {\n          data: state.data,\n          timestamp: state.timestamp,\n        },\n        `S${globalThis.crypto.randomUUID()}`,\n      );\n\n      if (promiseOrVoid instanceof Promise) {\n        globalState.ssrContext.pending.push(promiseOrVoid);\n      }\n    }\n  }\n\n  const { disabled } = options;\n\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(() => {\n    const numRefsPath = path ? `${path}.numRefs` : 'numRefs';\n    if (!disabled) {\n      const numRefs = globalState.get<ForceT, number>(numRefsPath);\n      globalState.set<ForceT, number>(numRefsPath, numRefs + 1);\n    }\n    return () => {\n      if (!disabled) {\n        const state2: AsyncDataEnvelopeT<DataT> = globalState.get<\n          ForceT, AsyncDataEnvelopeT<DataT>>(\n          path,\n        );\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.dropDependencies(path ?? '');\n          globalState.set<ForceT, AsyncDataEnvelopeT<DataT>>(path, {\n            ...state2,\n            data: null,\n            numRefs: 0,\n            timestamp: 0,\n          });\n        } else {\n          globalState.set<ForceT, number>(numRefsPath, state2.numRefs - 1);\n        }\n      }\n    };\n  }, [disabled, 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  useEffect(() => {\n    if (!disabled) {\n      const state2: AsyncDataEnvelopeT<DataT> = globalState.get<\n        ForceT, AsyncDataEnvelopeT<DataT>>(path);\n\n      const { deps } = options;\n      if (\n        // The hook is called with a list of dependencies, that mismatch\n        // dependencies last used to retrieve the data at given path.\n        (deps && globalState.hasChangedDependencies(path ?? '', deps))\n\n        // Data at the path are stale, and are not being loaded.\n        || (\n          refreshAge < Date.now() - state2.timestamp\n          && (!state2.operationId || state2.operationId.startsWith('S'))\n        )\n      ) {\n        if (!deps) globalState.dropDependencies(path ?? '');\n\n        void loadAsyncData<ForceT, DataT>(path, loader, globalState, {\n          data: state2.data,\n          timestamp: state2.timestamp,\n        });\n      }\n    }\n  });\n\n  const [localState] = useGlobalState<ForceT, AsyncDataEnvelopeT<DataT>>(\n    path,\n    newAsyncDataEnvelope<DataT>(),\n  );\n\n  const [stale, setStale] = useState<boolean>(\n    () => maxage < Date.now() - localState.timestamp,\n  );\n\n  // TODO: Merge into the data-reloading effect above?\n  useEffect(() => {\n    const nowStale = maxage < Date.now() - localState.timestamp;\n    const id = stale === nowStale ? null : requestAnimationFrame(() => {\n      setStale(nowStale);\n    });\n\n    return () => {\n      if (id !== null) cancelAnimationFrame(id);\n    };\n  });\n\n  return {\n    data: stale ? null : localState.data,\n    loading: !!localState.operationId,\n    reload: stable.reload,\n    set: stable.set,\n    timestamp: localState.timestamp,\n  };\n}\n\nexport { useAsyncData };\n\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\nexport interface LoadAsyncDataI<StateT> {\n  <\n    PathT extends null | string | undefined,\n    DataT extends DataInEnvelopeAtPathT<\n      StateT, PathT> = DataInEnvelopeAtPathT<StateT, PathT>,\n  >(\n    path: PathT,\n    loader: AsyncDataLoaderT<DataT>,\n    globalState: GlobalState<StateT, SsrContext<StateT>>,\n    old?: { data: DataT | null; timestamp: number },\n    operationId?: OperationIdT,\n  ): Promise<void> | void;\n\n  <Forced extends ForceT | LockT = LockT, DataT = unknown>(\n    path: null | string | undefined,\n    loader: AsyncDataLoaderT<TypeLock<Forced, void, DataT>>,\n    globalState: GlobalState<unknown, SsrContext<unknown>>,\n    old?: { data: DataT | null; timestamp: number },\n    operationId?: OperationIdT,\n  ): Promise<void> | void;\n}\n\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\nexport interface UseAsyncDataI<StateT> {\n  <PathT extends null | string | undefined>(\n    path: PathT,\n    loader: AsyncDataLoaderT<DataInEnvelopeAtPathT<StateT, PathT>>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncDataResT<DataInEnvelopeAtPathT<StateT, PathT>>;\n\n  <Forced extends ForceT | LockT = LockT, DataT = unknown>(\n    path: null | string | undefined,\n    loader: AsyncDataLoaderT<TypeLock<Forced, void, DataT>>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncDataResT<TypeLock<Forced, void, DataT>>;\n}\n"],"mappings":"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","ignoreList":[]}

package/build/code/useGlobalState.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"useGlobalState.js","names":["useEffect","useRef","useState","useSyncExternalStore","Emitter","useGlobalStateObject","cloneDeepForLog","isDebugMode","useGlobalState","path","initialValue","_ref$current","globalState","ref","stable","emitter","setter","value","rc","current","Error","newState","get","process","env","NODE_ENV","_rc$path","_rc$path2","console","groupCollapsed","log","groupEnd","set","prevValue","emit","subscribe","addListener","bind","initialState","watcher","nextValue","watch","unWatch"],"sources":["../../src/useGlobalState.ts"],"sourcesContent":["// Hook for updates of global state.\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 { useGlobalStateObject } 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 = useGlobalStateObject();\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 = typeof value === 'function'\n        ? (value as (x: unknown) => unknown)(\n          rc.globalState.get<ForceT, unknown>(rc.path),\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/utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.js","names":["cloneDeep","isDebugMode","process","env","NODE_ENV","REACT_GLOBAL_STATE_DEBUG","cloneDeepBailKeys","Set","cloneDeepForLog","value","key","has","console","warn","start","Date","now","res","time","add","areEqual","a","b","Object","entries"],"sources":["../../src/utils.ts"],"sourcesContent":["import type { GetFieldType } from 'lodash';\nimport { cloneDeep } from 'lodash-es';\n\nimport type { ObjectKey } from '@dr.pogodin/js-utils';\n\nexport type CallbackT = () => void;\n\n// TODO: This (ForceT, LockT, and TypeLock) probably should be moved to JS Utils\n// lib.\n\nexport declare const force: unique symbol;\nexport declare const lock: unique symbol;\n\nexport type ForceT = typeof force;\nexport type LockT = typeof lock;\n\nexport type TypeLock<\n  Unlocked extends ForceT | LockT,\n\n  // TODO: Revise later.\n  // eslint-disable-next-line @typescript-eslint/no-redundant-type-constituents\n  LockedT extends never | void,\n  UnlockedT,\n> = Unlocked extends ForceT ? UnlockedT : LockedT;\n\n/**\n * Given the type of state, `StateT`, and the type of state path, `PathT`,\n * it evaluates the type of value at that path of the state, if it can be\n * evaluated from the path type (it is possible when `PathT` is a string\n * literal type, and `StateT` elements along this path have appropriate\n * types); otherwise it falls back to the specified `UnknownT` type,\n * which should be set either `never` (for input arguments), or `void`\n * (for return types) - `never` and `void` in those places forbid assignments,\n * and are not auto-inferred to more permissible types.\n *\n * BEWARE: When StateT is any the construct resolves to any for any string\n * paths.\n */\nexport type ValueAtPathT<\n  StateT,\n  PathT extends null | string | undefined,\n\n  // TODO: Revise later.\n  // eslint-disable-next-line @typescript-eslint/no-redundant-type-constituents, @typescript-eslint/no-invalid-void-type\n  UnknownT extends never | undefined | void,\n> = unknown extends StateT\n  ? UnknownT\n  : string extends PathT\n    ? UnknownT\n    : PathT extends null | undefined\n      ? StateT\n      : GetFieldType<StateT, PathT> extends undefined\n        ? UnknownT : GetFieldType<StateT, PathT>;\n\nexport type ValueOrInitializerT<ValueT> = (() => ValueT) | ValueT;\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\n * @ignore\n */\nexport function isDebugMode(): boolean {\n  try {\n    return process.env.NODE_ENV !== 'production'\n      && !!process.env.REACT_GLOBAL_STATE_DEBUG;\n  } catch {\n    return false;\n  }\n}\n\nconst cloneDeepBailKeys = new Set<string>();\n\n/**\n * Deep-clones given value for logging purposes, or returns the value itself\n * if the previous clone attempt, with the same key, took more than 300ms\n * (to avoid situations when large payload in the global state slows down\n * development versions of the app due to the logging overhead).\n */\nexport function cloneDeepForLog<T>(value: T, key: string = ''): T {\n  if (cloneDeepBailKeys.has(key)) {\n    // eslint-disable-next-line no-console\n    console.warn(`The logged value won't be clonned (key \"${key}\").`);\n    return value;\n  }\n\n  const start = Date.now();\n  const res = cloneDeep(value);\n  const time = Date.now() - start;\n  if (time > 300) {\n    // eslint-disable-next-line no-console\n    console.warn(`${time}ms spent to clone the logged value (key \"${key}\").`);\n    cloneDeepBailKeys.add(key);\n  }\n\n  return res;\n}\n\nexport function areEqual<K extends ObjectKey>(\n  a: Record<K, boolean>,\n  b: Record<K, boolean>,\n): boolean {\n  for (const [key, value] of Object.entries(a)) {\n    if (b[key as K] !== value) return false;\n  }\n  for (const [key, value] of Object.entries(b)) {\n    if (a[key as K] !== value) return false;\n  }\n  return true;\n}\n"],"mappings":"AACA,SAASA,SAAS,QAAQ,WAAW;;AAMrC;AACA;;AAiBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAmBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,WAAWA,CAAA,EAAY;EACrC,IAAI;IACF,OAAOC,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,IACvC,CAAC,CAACF,OAAO,CAACC,GAAG,CAACE,wBAAwB;EAC7C,CAAC,CAAC,MAAM;IACN,OAAO,KAAK;EACd;AACF;AAEA,MAAMC,iBAAiB,GAAG,IAAIC,GAAG,CAAS,CAAC;;AAE3C;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,eAAeA,CAAIC,KAAQ,EAAEC,GAAW,GAAG,EAAE,EAAK;EAChE,IAAIJ,iBAAiB,CAACK,GAAG,CAACD,GAAG,CAAC,EAAE;IAC9B;IACAE,OAAO,CAACC,IAAI,CAAC,2CAA2CH,GAAG,KAAK,CAAC;IACjE,OAAOD,KAAK;EACd;EAEA,MAAMK,KAAK,GAAGC,IAAI,CAACC,GAAG,CAAC,CAAC;EACxB,MAAMC,GAAG,GAAGjB,SAAS,CAACS,KAAK,CAAC;EAC5B,MAAMS,IAAI,GAAGH,IAAI,CAACC,GAAG,CAAC,CAAC,GAAGF,KAAK;EAC/B,IAAII,IAAI,GAAG,GAAG,EAAE;IACd;IACAN,OAAO,CAACC,IAAI,CAAC,GAAGK,IAAI,4CAA4CR,GAAG,KAAK,CAAC;IACzEJ,iBAAiB,CAACa,GAAG,CAACT,GAAG,CAAC;EAC5B;EAEA,OAAOO,GAAG;AACZ;AAEA,OAAO,SAASG,QAAQA,CACtBC,CAAqB,EACrBC,CAAqB,EACZ;EACT,KAAK,MAAM,CAACZ,GAAG,EAAED,KAAK,CAAC,IAAIc,MAAM,CAACC,OAAO,CAACH,CAAC,CAAC,EAAE;IAC5C,IAAIC,CAAC,CAACZ,GAAG,CAAM,KAAKD,KAAK,EAAE,OAAO,KAAK;EACzC;EACA,KAAK,MAAM,CAACC,GAAG,EAAED,KAAK,CAAC,IAAIc,MAAM,CAACC,OAAO,CAACF,CAAC,CAAC,EAAE;IAC5C,IAAID,CAAC,CAACX,GAAG,CAAM,KAAKD,KAAK,EAAE,OAAO,KAAK;EACzC;EACA,OAAO,IAAI;AACb","ignoreList":[]}

package/eslint.config.mjs

@@ -1,19 +0,0 @@
-/* eslint-disable import/no-extraneous-dependencies */
-
-import { defineConfig } from 'eslint/config';
-import eslintConfigs from '@dr.pogodin/eslint-configs';
-
-export default defineConfig([
-  { ignores: [
-    'build/',
-    'docs/build/',
-    'docs/.docusaurus/',
-  ] },
-  eslintConfigs.configs.javascript,
-  eslintConfigs.configs.typescript,
-  eslintConfigs.configs.react,
-  {
-    extends: [eslintConfigs.configs.jest],
-    files: ['__tests__/**'],
-  },
-]);

package/tsconfig.json

@@ -1,22 +0,0 @@
-{
-  "extends": "@tsconfig/recommended",
-
-  // TODO: This actually breaks VSCode code analysis inside ts-types. We should
-  // do no exclusion here, but provide a different TS config file for Jest tests
-  // to use.
-  "exclude": ["__tests__/ts-types"],
-
-  "compilerOptions": {
-    "declaration": true,
-    "jsx": "react-jsx",
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "noUncheckedIndexedAccess": true,
-    "outDir": "build",
-    "paths": {
-      "*": ["./*"]
-    },
-    "types": ["node"],
-    "verbatimModuleSyntax": true
-  }
-}

package/tsconfig.types.json

@@ -1,14 +0,0 @@
-{
-  "extends": "@tsconfig/recommended",
-  "include": ["src", "types.d.ts"],
-  "compilerOptions": {
-    "declaration": true,
-    "emitDeclarationOnly": true,
-    "jsx": "react-jsx",
-    "module": "ESNext",
-    "moduleResolution": "Node",
-    "outDir": "build/types",
-    "strict": true,
-    "verbatimModuleSyntax": true,
-  }
-}

package/tstyche.json

@@ -1,6 +0,0 @@
-{
-  "$schema": "https://tstyche.org/schemas/config.json",
-  "checkDeclarationFiles": true,
-  "checkSuppressedErrors": true,
-  "testFileMatch": ["__tests__/**/*.{ts,tsx}"]
-}