@dr.pogodin/react-global-state 0.19.4 → 0.20.1

package/build/cjs/useAsyncData.js.map

@@ -1 +1 @@
-{"version":3,"file":"useAsyncData.js","names":["_react","require","_uuid","_jsUtils","_GlobalStateProvider","_useGlobalState","_interopRequireDefault","_utils","DEFAULT_MAXAGE","exports","MIN_MS","newAsyncDataEnvelope","initialData","numRefs","timestamp","data","operationId","setState","path","gs","prevState","get","process","env","NODE_ENV","isDebugMode","console","groupCollapsed","log","cloneDeepForLog","set","Date","now","groupEnd","finalizeLoad","asyncDataLoadDone","state","load","loader","globalState","old","uuid","operationIdPath","prevOperationId","definedOld","e","dataOrPromise","isAborted","opid","oldDataTimestamp","setAbortCallback","cb","Error","setAsyncDataAbortCallback","Promise","then","finally","undefined","useAsyncData","options","maxage","refreshAge","garbageCollectAge","getGlobalState","initialValue","current","heap","useRef","reload","customLoader","localLoader","ssrContext","disabled","noSSR","promiseOrVoid","pending","push","useEffect","numRefsPath","state2","dropDependencies","deps","hasChangedDependencies","startsWith","localState","useGlobalState","loading","Boolean"],"sources":["../../src/useAsyncData.ts"],"sourcesContent":["/**\n * Loads and uses async data into the GlobalState path.\n */\n\nimport { useEffect, useRef } from 'react';\nimport { v4 as uuid } from 'uuid';\n\nimport { MIN_MS } from '@dr.pogodin/js-utils';\n\nimport { getGlobalState } from './GlobalStateProvider';\nimport useGlobalState from './useGlobalState';\n\nimport {\n  type ForceT,\n  type LockT,\n  type TypeLock,\n  type ValueAtPathT,\n  cloneDeepForLog,\n  isDebugMode,\n} from './utils';\n\nimport type GlobalState from './GlobalState';\nimport type SsrContext from './SsrContext';\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: null | DataT, meta: {\n  isAborted: () => boolean;\n  oldDataTimestamp: number;\n  setAbortCallback: (cb: () => void) => void;\n}) => DataT | null | Promise<DataT | null>;\n\nexport type AsyncDataReloaderT<DataT>\n= (loader?: AsyncDataLoaderT<DataT>) => void | Promise<void>;\n\nexport type AsyncDataEnvelopeT<DataT> = {\n  data: null | DataT;\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: string | null | 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\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 load<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${uuid()}`,\n): void | Promise<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 dataOrPromise = loader(definedOld.data, {\n    isAborted: () => {\n      // TODO: Can we improve the typing, to avoid ForceT?\n      const opid = globalState.get<\n        ForceT, AsyncDataEnvelopeT<DataT>>(path).operationId;\n      return opid !== operationId;\n    },\n    oldDataTimestamp: definedOld.timestamp,\n    setAbortCallback(cb: () => void) {\n      const opid = globalState.get<\n        ForceT, AsyncDataEnvelopeT<DataT>>(path).operationId;\n      if (opid !== operationId) {\n        throw Error(`Operation #${operationId} has completed already`);\n      }\n      globalState.setAsyncDataAbortCallback(operationId, cb);\n    },\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() a stable function.\n  globalState?: GlobalState<unknown>;\n  path?: null | string;\n  loader?: AsyncDataLoaderT<DataT>;\n  reload?: AsyncDataReloaderT<DataT>;\n  set?: (data: DataT | null) => void;\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 = getGlobalState();\n  const state = globalState.get<ForceT, AsyncDataEnvelopeT<DataT>>(path, {\n    initialValue: newAsyncDataEnvelope<DataT>(),\n  });\n\n  const { current: heap } = useRef<HeapT<DataT>>({});\n  heap.globalState = globalState;\n  heap.path = path;\n  heap.loader = loader;\n\n  heap.reload ??= (\n    customLoader?: AsyncDataLoaderT<DataT>,\n  ): void | Promise<void> => {\n    const localLoader = customLoader ?? heap.loader;\n    if (!localLoader || !heap.globalState) throw Error('Internal error');\n    return load(heap.path, localLoader, heap.globalState);\n  };\n\n  heap.set ??= (data: DataT | null) => {\n    if (!heap.globalState) throw Error('Internal error');\n    setState(data, heap.path, heap.globalState);\n  };\n\n  if (globalState.ssrContext) {\n    if (\n      !options.disabled && !options.noSSR\n      && !state.operationId && !state.timestamp\n    ) {\n      const promiseOrVoid = load(path, loader, globalState, {\n        data: state.data,\n        timestamp: state.timestamp,\n      }, `S${uuid()}`);\n      if (promiseOrVoid instanceof Promise) {\n        globalState.ssrContext.pending.push(promiseOrVoid);\n      }\n    }\n  } else {\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(() => { // eslint-disable-line react-hooks/rules-of-hooks\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(() => { // eslint-disable-line react-hooks/rules-of-hooks\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          void load(path, loader, globalState, {\n            data: state2.data,\n            timestamp: state2.timestamp,\n          });\n        }\n      }\n    });\n  }\n\n  const [localState] = useGlobalState<ForceT, AsyncDataEnvelopeT<DataT>>(\n    path,\n    newAsyncDataEnvelope<DataT>(),\n  );\n\n  return {\n    data: maxage < Date.now() - localState.timestamp ? null : localState.data,\n    loading: Boolean(localState.operationId),\n    reload: heap.reload,\n    set: heap.set,\n    timestamp: localState.timestamp,\n  };\n}\n\nexport { useAsyncData };\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":[]}
+{"version":3,"file":"useAsyncData.js","names":["_react","require","_uuid","_jsUtils","_GlobalStateProvider","_useGlobalState","_interopRequireDefault","_utils","DEFAULT_MAXAGE","exports","MIN_MS","newAsyncDataEnvelope","initialData","numRefs","timestamp","data","operationId","setState","path","gs","prevState","get","process","env","NODE_ENV","isDebugMode","console","groupCollapsed","log","cloneDeepForLog","set","Date","now","groupEnd","finalizeLoad","asyncDataLoadDone","state","load","loader","globalState","old","uuid","operationIdPath","prevOperationId","definedOld","e","dataOrPromise","isAborted","opid","oldDataTimestamp","setAbortCallback","cb","Error","setAsyncDataAbortCallback","Promise","then","finally","undefined","useAsyncData","options","maxage","refreshAge","garbageCollectAge","getGlobalState","initialValue","current","heap","useRef","reload","customLoader","localLoader","ssrContext","disabled","noSSR","promiseOrVoid","pending","push","useEffect","numRefsPath","state2","dropDependencies","deps","hasChangedDependencies","startsWith","localState","useGlobalState","loading","Boolean"],"sources":["../../src/useAsyncData.ts"],"sourcesContent":["/**\n * Loads and uses async data into the GlobalState path.\n */\n\nimport { useEffect, useRef } from 'react';\nimport { v4 as uuid } from 'uuid';\n\nimport { MIN_MS } from '@dr.pogodin/js-utils';\n\nimport { getGlobalState } from './GlobalStateProvider';\nimport useGlobalState from './useGlobalState';\n\nimport {\n  type ForceT,\n  type LockT,\n  type TypeLock,\n  type ValueAtPathT,\n  cloneDeepForLog,\n  isDebugMode,\n} from './utils';\n\nimport type GlobalState from './GlobalState';\nimport type SsrContext from './SsrContext';\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: null | DataT, meta: {\n    isAborted: () => boolean;\n    oldDataTimestamp: number;\n    setAbortCallback: (cb: () => void) => void;\n  }) => DataT | null | Promise<DataT | null>;\n\nexport type AsyncDataReloaderT<DataT>\n  = (loader?: AsyncDataLoaderT<DataT>) => void | Promise<void>;\n\nexport type AsyncDataEnvelopeT<DataT> = {\n  data: null | DataT;\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: string | null | 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\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 load<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${uuid()}`,\n): void | Promise<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 dataOrPromise = loader(definedOld.data, {\n    isAborted: () => {\n      // TODO: Can we improve the typing, to avoid ForceT?\n      const opid = globalState.get<\n        ForceT, AsyncDataEnvelopeT<DataT>>(path).operationId;\n      return opid !== operationId;\n    },\n    oldDataTimestamp: definedOld.timestamp,\n    setAbortCallback(cb: () => void) {\n      const opid = globalState.get<\n        ForceT, AsyncDataEnvelopeT<DataT>>(path).operationId;\n      if (opid !== operationId) {\n        throw Error(`Operation #${operationId} has completed already`);\n      }\n      globalState.setAsyncDataAbortCallback(operationId, cb);\n    },\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() a stable function.\n  globalState?: GlobalState<unknown>;\n  path?: null | string;\n  loader?: AsyncDataLoaderT<DataT>;\n  reload?: AsyncDataReloaderT<DataT>;\n  set?: (data: DataT | null) => void;\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 = getGlobalState();\n  const state = globalState.get<ForceT, AsyncDataEnvelopeT<DataT>>(path, {\n    initialValue: newAsyncDataEnvelope<DataT>(),\n  });\n\n  const { current: heap } = useRef<HeapT<DataT>>({});\n  heap.globalState = globalState;\n  heap.path = path;\n  heap.loader = loader;\n\n  heap.reload ??= (\n    customLoader?: AsyncDataLoaderT<DataT>,\n  ): void | Promise<void> => {\n    const localLoader = customLoader ?? heap.loader;\n    if (!localLoader || !heap.globalState) throw Error('Internal error');\n    return load(heap.path, localLoader, heap.globalState);\n  };\n\n  heap.set ??= (data: DataT | null) => {\n    if (!heap.globalState) throw Error('Internal error');\n    setState(data, heap.path, heap.globalState);\n  };\n\n  if (globalState.ssrContext) {\n    if (\n      !options.disabled && !options.noSSR\n      && !state.operationId && !state.timestamp\n    ) {\n      const promiseOrVoid = load(path, loader, globalState, {\n        data: state.data,\n        timestamp: state.timestamp,\n      }, `S${uuid()}`);\n      if (promiseOrVoid instanceof Promise) {\n        globalState.ssrContext.pending.push(promiseOrVoid);\n      }\n    }\n  } else {\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(() => { // eslint-disable-line react-hooks/rules-of-hooks\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(() => { // eslint-disable-line react-hooks/rules-of-hooks\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          void load(path, loader, globalState, {\n            data: state2.data,\n            timestamp: state2.timestamp,\n          });\n        }\n      }\n    });\n  }\n\n  const [localState] = useGlobalState<ForceT, AsyncDataEnvelopeT<DataT>>(\n    path,\n    newAsyncDataEnvelope<DataT>(),\n  );\n\n  return {\n    data: maxage < Date.now() - localState.timestamp ? null : localState.data,\n    loading: Boolean(localState.operationId),\n    reload: heap.reload,\n    set: heap.set,\n    timestamp: localState.timestamp,\n  };\n}\n\nexport { useAsyncData };\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/cjs/useGlobalState.js

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

package/build/cjs/useGlobalState.js.map

@@ -1 +1 @@
-{"version":3,"file":"useGlobalState.js","names":["_lodash","require","_react","_jsUtils","_GlobalStateProvider","_utils","useGlobalState","path","initialValue","globalState","getGlobalState","ref","useRef","undefined","rc","current","emitter","Emitter","setter","value","newState","isFunction","get","process","env","NODE_ENV","isDebugMode","console","groupCollapsed","log","cloneDeepForLog","groupEnd","set","state","emit","subscribe","addListener","bind","watcher","useSyncExternalStore","initialState","useEffect","watch","unWatch","_default","exports","default"],"sources":["../../src/useGlobalState.ts"],"sourcesContent":["// Hook for updates of global state.\n\nimport { isFunction } from 'lodash';\n\nimport {\n  type Dispatch,\n  type SetStateAction,\n  useEffect,\n  useRef,\n  useSyncExternalStore,\n} from 'react';\n\nimport { Emitter } from '@dr.pogodin/js-utils';\n\nimport type GlobalState from './GlobalState';\nimport { getGlobalState } from './GlobalStateProvider';\n\nimport {\n  type CallbackT,\n  type ForceT,\n  type LockT,\n  type TypeLock,\n  type ValueAtPathT,\n  type ValueOrInitializerT,\n  cloneDeepForLog,\n  isDebugMode,\n} from './utils';\n\nexport type SetterT<T> = Dispatch<SetStateAction<T>>;\n\ntype ListenerT = () => void;\n\ntype GlobalStateRef = {\n  emitter: Emitter<[]>;\n  globalState: GlobalState<unknown>;\n  path: null | string | undefined;\n  setter: SetterT<unknown>;\n  subscribe: (listener: ListenerT) => () => void;\n  state: unknown;\n  watcher: CallbackT;\n};\n\nexport type UseGlobalStateResT<T> = [T, SetterT<T>];\n\n/**\n * The primary hook for interacting with the global state, modeled after\n * the standard React's\n * [useState](https://reactjs.org/docs/hooks-reference.html#usestate).\n * It subscribes a component to a given `path` of global state, and provides\n * a function to update it. Each time the value at `path` changes, the hook\n * triggers re-render of its host component.\n *\n * **Note:**\n * - For performance, the library does not copy objects written to / read from\n *   global state paths. You MUST NOT manually mutate returned state values,\n *   or change objects already written into the global state, without explicitly\n *   clonning them first yourself.\n * - State update notifications are asynchronous. When your code does multiple\n *   global state updates in the same React rendering cycle, all state update\n *   notifications are queued and dispatched together, after the current\n *   rendering cycle. In other words, in any given rendering cycle the global\n *   state values are \"fixed\", and all changes becomes visible at once in the\n *   next triggered rendering pass.\n *\n * @param path Dot-delimitered state path. It can be undefined to\n * subscribe for entire state.\n *\n * Under-the-hood state values are read and written using `lodash`\n * [_.get()](https://lodash.com/docs/4.17.15#get) and\n * [_.set()](https://lodash.com/docs/4.17.15#set) methods, thus it is safe\n * to access state paths which have not been created before.\n * @param initialValue Initial value to set at the `path`, or its\n * factory:\n * - If a function is given, it will act similar to\n *   [the lazy initial state of the standard React's useState()](https://reactjs.org/docs/hooks-reference.html#lazy-initial-state):\n *   only if the value at `path` is `undefined`, the function will be executed,\n *   and the value it returns will be written to the `path`.\n * - Otherwise, the given value itself will be written to the `path`,\n *   if the current value at `path` is `undefined`.\n * @return It returs an array with two elements: `[value, setValue]`:\n *\n * - The `value` is the current value at given `path`.\n *\n * - The `setValue()` is setter function to write a new value to the `path`.\n *\n *   Similar to the standard React's `useState()`, it supports\n *   [functional value updates](https://reactjs.org/docs/hooks-reference.html#functional-updates):\n *   if `setValue()` is called with a function as argument, that function will\n *   be called and its return value will be written to `path`. Otherwise,\n *   the argument of `setValue()` itself is written to `path`.\n *\n *   Also, similar to the standard React's state setters, `setValue()` is\n *   stable function: it does not change between component re-renders.\n */\n\n// \"Enforced type overload\"\nfunction useGlobalState<\n  Forced extends ForceT | LockT = LockT,\n  ValueT = void,\n>(\n  path: null | string | undefined,\n  initialValue?: ValueOrInitializerT<TypeLock<Forced, never, ValueT>>,\n): UseGlobalStateResT<TypeLock<Forced, void, ValueT>>;\n\n// \"Entire state overload\"\nfunction useGlobalState<StateT>(): UseGlobalStateResT<StateT>;\n\n// \"State evaluation overload\"\nfunction useGlobalState<\n  StateT,\n  PathT extends null | string | undefined,\n>(\n  path: PathT,\n  initialValue: ValueOrInitializerT<\n    Exclude<ValueAtPathT<StateT, PathT, never>, undefined>>\n): UseGlobalStateResT<Exclude<ValueAtPathT<StateT, PathT, void>, undefined>>;\n\nfunction useGlobalState<\n  StateT,\n  PathT extends null | string | undefined,\n>(\n  path: PathT,\n  initialValue?: ValueOrInitializerT<ValueAtPathT<StateT, PathT, never>>\n): UseGlobalStateResT<ValueAtPathT<StateT, PathT, void>>;\n\nfunction useGlobalState(\n  path?: null | string,\n  // TODO: Revise it later!\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  initialValue?: ValueOrInitializerT<any>,\n\n  // TODO: Revise it later!\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n): UseGlobalStateResT<any> {\n  const globalState = getGlobalState();\n\n  const ref = useRef<GlobalStateRef>(undefined);\n\n  // TODO: Revise how this `rc` variable is used, perhaps we can simplify stuff\n  // here.\n  let rc: GlobalStateRef | undefined = ref.current;\n  if (!ref.current) {\n    const emitter = new Emitter();\n    ref.current = {\n      emitter,\n      globalState,\n      path,\n      setter: (value) => {\n        const newState = isFunction(value)\n          ? value(rc!.globalState.get(rc!.path)) as unknown\n          : value;\n\n        if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n          /* eslint-disable no-console */\n          console.groupCollapsed(\n            `ReactGlobalState - useGlobalState setter triggered for path ${\n              rc!.path ?? ''\n            }`,\n          );\n          console.log('New value:', cloneDeepForLog(newState, rc!.path ?? ''));\n          console.groupEnd();\n          /* eslint-enable no-console */\n        }\n        rc!.globalState.set<ForceT, unknown>(rc!.path, newState);\n\n        // NOTE: The regular global state's update notifications, automatically\n        // triggered by the rc.globalState.set() call above, are batched, and\n        // scheduled to fire asynchronosuly at a later time, which is problematic\n        // for managed text inputs - if they have their value update delayed to\n        // future render cycles, it will result in reset of their cursor position\n        // to the value end. Calling the rc.emitter.emit() below causes a sooner\n        // state update for the current component, thus working around the issue.\n        // For additional details see the original issue:\n        // https://github.com/birdofpreyru/react-global-state/issues/22\n        if (newState !== rc!.state) rc!.emitter.emit();\n      },\n      state: isFunction(initialValue) ? initialValue() : initialValue,\n      subscribe: emitter.addListener.bind(emitter),\n      watcher: () => {\n        // TODO: Revise it later.\n        // eslint-disable-next-line @typescript-eslint/no-confusing-void-expression\n        const state = rc!.globalState.get(rc!.path) as unknown;\n        if (state !== rc!.state) rc!.emitter.emit();\n      },\n    };\n  }\n  rc = ref.current!;\n\n  rc.globalState = globalState;\n  rc.path = path;\n\n  rc.state = useSyncExternalStore(\n    rc.subscribe,\n    () => rc.globalState.get<ForceT, unknown>(rc.path, { initialValue }),\n\n    () => rc.globalState.get<ForceT, unknown>(\n      rc.path,\n      { initialState: true, initialValue },\n    ),\n  );\n\n  useEffect(() => {\n    const { watcher } = ref.current!;\n    globalState.watch(watcher);\n    watcher();\n    return () => {\n      globalState.unWatch(watcher);\n    };\n  }, [globalState]);\n\n  useEffect(() => {\n    ref.current!.watcher();\n  }, [path]);\n\n  return [rc.state, rc.setter];\n}\n\nexport default useGlobalState;\n\n// TODO: Revise.\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\nexport interface UseGlobalStateI<StateT> {\n  (): UseGlobalStateResT<StateT>;\n\n  <PathT extends null | string | undefined>(\n    path: PathT,\n    initialValue: ValueOrInitializerT<\n      Exclude<ValueAtPathT<StateT, PathT, never>, undefined>>\n  ): UseGlobalStateResT<Exclude<ValueAtPathT<StateT, PathT, void>, undefined>>;\n\n  <PathT extends null | string | undefined>(\n    path: PathT,\n    initialValue?: ValueOrInitializerT<ValueAtPathT<StateT, PathT, never>>\n  ): UseGlobalStateResT<ValueAtPathT<StateT, PathT, void>>;\n\n  <Forced extends ForceT | LockT = LockT, ValueT = unknown>(\n    path: null | string | undefined,\n    initialValue?: ValueOrInitializerT<TypeLock<Forced, never, ValueT>>,\n  ): UseGlobalStateResT<TypeLock<Forced, void, ValueT>>;\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"useGlobalState.js","names":["_isFunction","_interopRequireDefault","require","_react","_jsUtils","_GlobalStateProvider","_utils","useGlobalState","path","initialValue","globalState","getGlobalState","ref","useRef","stable","useState","emitter","Emitter","setter","value","rc","current","Error","newState","isFunction","get","process","env","NODE_ENV","isDebugMode","console","groupCollapsed","log","cloneDeepForLog","groupEnd","set","prevValue","emit","subscribe","addListener","bind","useSyncExternalStore","initialState","useEffect","watcher","nextValue","watch","unWatch","_default","exports","default"],"sources":["../../src/useGlobalState.ts"],"sourcesContent":["// Hook for updates of global state.\n\nimport isFunction from 'lodash/isFunction.js';\n\nimport {\n  type Dispatch,\n  type SetStateAction,\n  useEffect,\n  useRef,\n  useState,\n  useSyncExternalStore,\n} from 'react';\n\nimport { Emitter } from '@dr.pogodin/js-utils';\n\nimport type GlobalState from './GlobalState';\nimport { getGlobalState } from './GlobalStateProvider';\n\nimport {\n  type ForceT,\n  type LockT,\n  type TypeLock,\n  type ValueAtPathT,\n  type ValueOrInitializerT,\n  cloneDeepForLog,\n  isDebugMode,\n} from './utils';\n\nexport type SetterT<T> = Dispatch<SetStateAction<T>>;\n\ntype ListenerT = () => void;\n\ntype CurrentT = {\n  globalState: GlobalState<unknown>;\n  path: null | string | undefined;\n  prevValue: unknown;\n};\n\ntype StableT = {\n  emitter: Emitter<[]>;\n  setter: SetterT<unknown>;\n  subscribe: (listener: ListenerT) => () => void;\n};\n\nexport type UseGlobalStateResT<T> = [T, SetterT<T>];\n\n/**\n * The primary hook for interacting with the global state, modeled after\n * the standard React's\n * [useState](https://reactjs.org/docs/hooks-reference.html#usestate).\n * It subscribes a component to a given `path` of global state, and provides\n * a function to update it. Each time the value at `path` changes, the hook\n * triggers re-render of its host component.\n *\n * **Note:**\n * - For performance, the library does not copy objects written to / read from\n *   global state paths. You MUST NOT manually mutate returned state values,\n *   or change objects already written into the global state, without explicitly\n *   clonning them first yourself.\n * - State update notifications are asynchronous. When your code does multiple\n *   global state updates in the same React rendering cycle, all state update\n *   notifications are queued and dispatched together, after the current\n *   rendering cycle. In other words, in any given rendering cycle the global\n *   state values are \"fixed\", and all changes becomes visible at once in the\n *   next triggered rendering pass.\n *\n * @param path Dot-delimitered state path. It can be undefined to\n * subscribe for entire state.\n *\n * Under-the-hood state values are read and written using `lodash`\n * [_.get()](https://lodash.com/docs/4.17.15#get) and\n * [_.set()](https://lodash.com/docs/4.17.15#set) methods, thus it is safe\n * to access state paths which have not been created before.\n * @param initialValue Initial value to set at the `path`, or its\n * factory:\n * - If a function is given, it will act similar to\n *   [the lazy initial state of the standard React's useState()](https://reactjs.org/docs/hooks-reference.html#lazy-initial-state):\n *   only if the value at `path` is `undefined`, the function will be executed,\n *   and the value it returns will be written to the `path`.\n * - Otherwise, the given value itself will be written to the `path`,\n *   if the current value at `path` is `undefined`.\n * @return It returs an array with two elements: `[value, setValue]`:\n *\n * - The `value` is the current value at given `path`.\n *\n * - The `setValue()` is setter function to write a new value to the `path`.\n *\n *   Similar to the standard React's `useState()`, it supports\n *   [functional value updates](https://reactjs.org/docs/hooks-reference.html#functional-updates):\n *   if `setValue()` is called with a function as argument, that function will\n *   be called and its return value will be written to `path`. Otherwise,\n *   the argument of `setValue()` itself is written to `path`.\n *\n *   Also, similar to the standard React's state setters, `setValue()` is\n *   stable function: it does not change between component re-renders.\n */\n\n// \"Enforced type overload\"\nfunction useGlobalState<\n  Forced extends ForceT | LockT = LockT,\n  ValueT = void,\n>(\n  path: null | string | undefined,\n  initialValue?: ValueOrInitializerT<TypeLock<Forced, never, ValueT>>,\n): UseGlobalStateResT<TypeLock<Forced, void, ValueT>>;\n\n// \"Entire state overload\"\nfunction useGlobalState<StateT>(): UseGlobalStateResT<StateT>;\n\n// \"State evaluation overload\"\nfunction useGlobalState<\n  StateT,\n  PathT extends null | string | undefined,\n>(\n  path: PathT,\n  initialValue: ValueOrInitializerT<\n    Exclude<ValueAtPathT<StateT, PathT, never>, undefined>>,\n): UseGlobalStateResT<Exclude<ValueAtPathT<StateT, PathT, void>, undefined>>;\n\nfunction useGlobalState<\n  StateT,\n  PathT extends null | string | undefined,\n>(\n  path: PathT,\n  initialValue?: ValueOrInitializerT<ValueAtPathT<StateT, PathT, never>>,\n): UseGlobalStateResT<ValueAtPathT<StateT, PathT, void>>;\n\nfunction useGlobalState(\n  path?: null | string,\n  // TODO: Revise it later!\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  initialValue?: ValueOrInitializerT<any>,\n\n  // TODO: Revise it later!\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n): UseGlobalStateResT<any> {\n  const globalState = getGlobalState();\n\n  const ref = useRef<CurrentT>(null);\n\n  const [stable] = useState<StableT>(() => {\n    const emitter = new Emitter();\n    const setter = (value: unknown) => {\n      const rc = ref.current;\n      if (!rc) throw Error('Internal error');\n\n      const newState = isFunction(value)\n        ? value(rc.globalState.get(rc.path)) as unknown\n        : value;\n\n      if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n        /* eslint-disable no-console */\n        console.groupCollapsed(\n          `ReactGlobalState - useGlobalState setter triggered for path ${\n            rc.path ?? ''\n          }`,\n        );\n        console.log('New value:', cloneDeepForLog(newState, rc.path ?? ''));\n        console.groupEnd();\n        /* eslint-enable no-console */\n      }\n      rc.globalState.set<ForceT, unknown>(rc.path, newState);\n\n      // NOTE: The regular global state's update notifications, automatically\n      // triggered by the rc.globalState.set() call above, are batched, and\n      // scheduled to fire asynchronosuly at a later time, which is problematic\n      // for managed text inputs - if they have their value update delayed to\n      // future render cycles, it will result in reset of their cursor position\n      // to the value end. Calling the rc.emitter.emit() below causes a sooner\n      // state update for the current component, thus working around the issue.\n      // For additional details see the original issue:\n      // https://github.com/birdofpreyru/react-global-state/issues/22\n      if (newState !== rc.prevValue) emitter.emit();\n    };\n    const subscribe = emitter.addListener.bind(emitter);\n    return { emitter, setter, subscribe };\n  });\n\n  const value = useSyncExternalStore(\n    stable.subscribe,\n    () => globalState.get<ForceT, unknown>(path, { initialValue }),\n\n    () => globalState.get<ForceT, unknown>(\n      path,\n      { initialState: true, initialValue },\n    ),\n  );\n\n  ref.current ??= {\n    globalState,\n    path,\n    prevValue: value,\n  };\n\n  useEffect(() => {\n    ref.current = {\n      globalState,\n      path,\n      prevValue: ref.current!.prevValue,\n    };\n\n    const watcher = () => {\n      const nextValue = globalState.get<ForceT, unknown>(path);\n      if (ref.current!.prevValue !== nextValue) {\n        ref.current!.prevValue = nextValue;\n        stable.emitter.emit();\n      }\n    };\n\n    globalState.watch(watcher);\n    watcher();\n\n    return () => {\n      globalState.unWatch(watcher);\n    };\n  }, [globalState, stable.emitter, path]);\n\n  return [value, stable.setter];\n}\n\nexport default useGlobalState;\n\n// TODO: Revise.\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\nexport interface UseGlobalStateI<StateT> {\n  (): UseGlobalStateResT<StateT>;\n\n  <PathT extends null | string | undefined>(\n    path: PathT,\n    initialValue: ValueOrInitializerT<\n      Exclude<ValueAtPathT<StateT, PathT, never>, undefined>>\n  ): UseGlobalStateResT<Exclude<ValueAtPathT<StateT, PathT, void>, undefined>>;\n\n  <PathT extends null | string | undefined>(\n    path: PathT,\n    initialValue?: ValueOrInitializerT<ValueAtPathT<StateT, PathT, never>>\n  ): UseGlobalStateResT<ValueAtPathT<StateT, PathT, void>>;\n\n  <Forced extends ForceT | LockT = LockT, ValueT = unknown>(\n    path: null | string | undefined,\n    initialValue?: ValueOrInitializerT<TypeLock<Forced, never, ValueT>>,\n  ): UseGlobalStateResT<TypeLock<Forced, void, ValueT>>;\n}\n"],"mappings":"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","ignoreList":[]}

package/build/cjs/utils.js

@@ -1,5 +1,6 @@
 "use strict";
 
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
@@ -7,7 +8,7 @@ exports.cloneDeepForLog = cloneDeepForLog;
 exports.escape = escape;
 exports.hash = hash;
 exports.isDebugMode = isDebugMode;
-var _lodash = require("lodash");
+var _cloneDeep = _interopRequireDefault(require("lodash/cloneDeep.js"));
 // TODO: This (ForceT, LockT, and TypeLock) probably should be moved to JS Utils
 // lib.
 
@@ -59,7 +60,7 @@ function cloneDeepForLog(value, key = '') {
     return value;
   }
   const start = Date.now();
-  const res = (0, _lodash.cloneDeep)(value);
+  const res = (0, _cloneDeep.default)(value);
   const time = Date.now() - start;
   if (time > 300) {
     // eslint-disable-next-line no-console

package/build/cjs/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","names":["_lodash","require","isDebugMode","process","env","NODE_ENV","REACT_GLOBAL_STATE_DEBUG","cloneDeepBailKeys","Set","cloneDeepForLog","value","key","has","console","warn","start","Date","now","res","cloneDeep","time","add","escape","x","replace","toString","hash","items","map","join"],"sources":["../../src/utils.ts"],"sourcesContent":["import { type GetFieldType, cloneDeep } from 'lodash';\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\n/**\n * Converts given value to an escaped string. For now, we are good with the most\n * trivial escape logic:\n *  - '%' characters are replaced by '%0' code pair;\n *  - '/' characters are replaced by '%1' code pair.\n */\nexport function escape(x: number | string): string {\n  return typeof x === 'string'\n    ? x.replace(/%/g, '%0').replace(/\\//g, '%1')\n    : x.toString();\n}\n\n/**\n * Hashes given string array. For our current needs we are fine to go with\n * the most trivial implementation, which probably should not be called \"hash\"\n * in the strict sense: we just escape each given string to not include '/'\n * characters, and then we join all those strings using '/' as the separator.\n */\nexport function hash(items: Array<number | string>): string {\n  return items.map(escape).join('/');\n}\n"],"mappings":";;;;;;;;;AAAA,IAAAA,OAAA,GAAAC,OAAA;AAIA;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;AACO,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;AACO,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,GAAG,IAAAC,iBAAS,EAACT,KAAK,CAAC;EAC5B,MAAMU,IAAI,GAAGJ,IAAI,CAACC,GAAG,CAAC,CAAC,GAAGF,KAAK;EAC/B,IAAIK,IAAI,GAAG,GAAG,EAAE;IACd;IACAP,OAAO,CAACC,IAAI,CAAC,GAAGM,IAAI,4CAA4CT,GAAG,KAAK,CAAC;IACzEJ,iBAAiB,CAACc,GAAG,CAACV,GAAG,CAAC;EAC5B;EAEA,OAAOO,GAAG;AACZ;;AAEA;AACA;AACA;AACA;AACA;AACA;AACO,SAASI,MAAMA,CAACC,CAAkB,EAAU;EACjD,OAAO,OAAOA,CAAC,KAAK,QAAQ,GACxBA,CAAC,CAACC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAACA,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,GAC1CD,CAAC,CAACE,QAAQ,CAAC,CAAC;AAClB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,IAAIA,CAACC,KAA6B,EAAU;EAC1D,OAAOA,KAAK,CAACC,GAAG,CAACN,MAAM,CAAC,CAACO,IAAI,CAAC,GAAG,CAAC;AACpC","ignoreList":[]}
+{"version":3,"file":"utils.js","names":["_cloneDeep","_interopRequireDefault","require","isDebugMode","process","env","NODE_ENV","REACT_GLOBAL_STATE_DEBUG","cloneDeepBailKeys","Set","cloneDeepForLog","value","key","has","console","warn","start","Date","now","res","cloneDeep","time","add","escape","x","replace","toString","hash","items","map","join"],"sources":["../../src/utils.ts"],"sourcesContent":["import type { GetFieldType } from 'lodash';\nimport cloneDeep from 'lodash/cloneDeep.js';\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\n/**\n * Converts given value to an escaped string. For now, we are good with the most\n * trivial escape logic:\n *  - '%' characters are replaced by '%0' code pair;\n *  - '/' characters are replaced by '%1' code pair.\n */\nexport function escape(x: number | string): string {\n  return typeof x === 'string'\n    ? x.replace(/%/g, '%0').replace(/\\//g, '%1')\n    : x.toString();\n}\n\n/**\n * Hashes given string array. For our current needs we are fine to go with\n * the most trivial implementation, which probably should not be called \"hash\"\n * in the strict sense: we just escape each given string to not include '/'\n * characters, and then we join all those strings using '/' as the separator.\n */\nexport function hash(items: Array<number | string>): string {\n  return items.map(escape).join('/');\n}\n"],"mappings":";;;;;;;;;;AACA,IAAAA,UAAA,GAAAC,sBAAA,CAAAC,OAAA;AAIA;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;AACO,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;AACO,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,GAAG,IAAAC,kBAAS,EAACT,KAAK,CAAC;EAC5B,MAAMU,IAAI,GAAGJ,IAAI,CAACC,GAAG,CAAC,CAAC,GAAGF,KAAK;EAC/B,IAAIK,IAAI,GAAG,GAAG,EAAE;IACd;IACAP,OAAO,CAACC,IAAI,CAAC,GAAGM,IAAI,4CAA4CT,GAAG,KAAK,CAAC;IACzEJ,iBAAiB,CAACc,GAAG,CAACV,GAAG,CAAC;EAC5B;EAEA,OAAOO,GAAG;AACZ;;AAEA;AACA;AACA;AACA;AACA;AACA;AACO,SAASI,MAAMA,CAACC,CAAkB,EAAU;EACjD,OAAO,OAAOA,CAAC,KAAK,QAAQ,GACxBA,CAAC,CAACC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAACA,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,GAC1CD,CAAC,CAACE,QAAQ,CAAC,CAAC;AAClB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,IAAIA,CAACC,KAA6B,EAAU;EAC1D,OAAOA,KAAK,CAACC,GAAG,CAACN,MAAM,CAAC,CAACO,IAAI,CAAC,GAAG,CAAC;AACpC","ignoreList":[]}

package/build/code/GlobalState.js

@@ -3,8 +3,13 @@ function _checkPrivateRedeclaration(e, t) { if (t.has(e)) throw new TypeError("C
 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, isFunction, isObject, isNil, set, toPath } from 'lodash';
-import { cloneDeepForLog, isDebugMode } from "./utils";
+import get from 'lodash/get.js';
+import isFunction from 'lodash/isFunction.js';
+import isObject from 'lodash/isObject.js';
+import isNil from 'lodash/isNil.js';
+import set from 'lodash/set.js';
+import toPath from 'lodash/toPath.js';
+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();

package/build/code/GlobalState.js.map

@@ -1 +1 @@
-{"version":3,"file":"GlobalState.js","names":["get","isFunction","isObject","isNil","set","toPath","cloneDeepForLog","isDebugMode","ERR_NO_SSR_WATCH","_asyncDataAbortCallbacks","WeakMap","_dependencies","_initialState","_watchers","_nextNotifierId","_currentState","GlobalState","constructor","initialState","ssrContext","_classPrivateFieldInitSpec","_classPrivateFieldSet","dirty","pending","state","_classPrivateFieldGet","process","env","NODE_ENV","msg","console","groupCollapsed","log","groupEnd","numAsyncDataAbortCallbacks","Object","keys","length","asyncDataLoadDone","opid","aborted","_classPrivateFieldGet2","_classPrivateFieldGet3","call","dropDependencies","path","hasChangedDependencies","deps","prevDeps","changed","i","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 {\n  get,\n  isFunction,\n  isObject,\n  isNil,\n  set,\n  toPath,\n} from 'lodash';\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: Record<string, () => void> = {};\n\n  #dependencies: Record<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 Object.keys(this.#asyncDataAbortCallbacks).length;\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[opid]?.();\n    delete this.#asyncDataAbortCallbacks[opid];\n  }\n\n  /**\n   * Drops the record of dependencies, if any, for the given path.\n   */\n  dropDependencies(path: string): void {\n    delete this.#dependencies[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[path];\n    let changed = !prevDeps || prevDeps.length !== deps.length;\n    for (let i = 0; !changed && i < deps.length; ++i) {\n      changed = prevDeps![i] !== deps[i];\n    }\n    this.#dependencies[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 = isFunction(iv) ? iv() : 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[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 (isNil(path)) {\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 = isFunction(iv) ? iv() : 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 (isNil(path)) 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 (isObject(next)) pos[seg] = { ...next };\n        else {\n          // We arrived to a state sub-segment, where the remaining part of\n          // the update path does not exist yet. We rely on lodash's set()\n          // function to create the remaining path, and set the value.\n          set(pos, pathSegments.slice(segIdx), value);\n          break;\n        }\n        pos = pos[seg] 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":[]}
+{"version":3,"file":"GlobalState.js","names":["get","isFunction","isObject","isNil","set","toPath","cloneDeepForLog","isDebugMode","ERR_NO_SSR_WATCH","_asyncDataAbortCallbacks","WeakMap","_dependencies","_initialState","_watchers","_nextNotifierId","_currentState","GlobalState","constructor","initialState","ssrContext","_classPrivateFieldInitSpec","_classPrivateFieldSet","dirty","pending","state","_classPrivateFieldGet","process","env","NODE_ENV","msg","console","groupCollapsed","log","groupEnd","numAsyncDataAbortCallbacks","Object","keys","length","asyncDataLoadDone","opid","aborted","_classPrivateFieldGet2","_classPrivateFieldGet3","call","dropDependencies","path","hasChangedDependencies","deps","prevDeps","changed","i","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 from 'lodash/get.js';\nimport isFunction from 'lodash/isFunction.js';\nimport isObject from 'lodash/isObject.js';\nimport isNil from 'lodash/isNil.js';\nimport set from 'lodash/set.js';\nimport toPath from 'lodash/toPath.js';\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: Record<string, () => void> = {};\n\n  #dependencies: Record<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 Object.keys(this.#asyncDataAbortCallbacks).length;\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[opid]?.();\n    delete this.#asyncDataAbortCallbacks[opid];\n  }\n\n  /**\n   * Drops the record of dependencies, if any, for the given path.\n   */\n  dropDependencies(path: string): void {\n    delete this.#dependencies[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[path];\n    let changed = !prevDeps || prevDeps.length !== deps.length;\n    for (let i = 0; !changed && i < deps.length; ++i) {\n      changed = prevDeps![i] !== deps[i];\n    }\n    this.#dependencies[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 = isFunction(iv) ? iv() : 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[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 (isNil(path)) {\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 = isFunction(iv) ? iv() : 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 (isNil(path)) 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 (isObject(next)) pos[seg] = { ...next };\n        else {\n          // We arrived to a state sub-segment, where the remaining part of\n          // the update path does not exist yet. We rely on lodash's set()\n          // function to create the remaining path, and set the value.\n          set(pos, pathSegments.slice(segIdx), value);\n          break;\n        }\n        pos = pos[seg] 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

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

package/build/code/GlobalStateProvider.js.map

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

package/build/code/index.js

@@ -1,9 +1,9 @@
-import GlobalState from "./GlobalState";
-import GlobalStateProvider, { getGlobalState, getSsrContext } from "./GlobalStateProvider";
-import SsrContext from "./SsrContext";
-import useAsyncCollection from "./useAsyncCollection";
-import { newAsyncDataEnvelope, useAsyncData } from "./useAsyncData";
-import useGlobalState from "./useGlobalState";
+import GlobalState from "./GlobalState.js";
+import GlobalStateProvider, { getGlobalState, getSsrContext } from "./GlobalStateProvider.js";
+import SsrContext from "./SsrContext.js";
+import useAsyncCollection from "./useAsyncCollection.js";
+import { newAsyncDataEnvelope, useAsyncData } from "./useAsyncData.js";
+import useGlobalState from "./useGlobalState.js";
 export { getGlobalState, getSsrContext, GlobalState, GlobalStateProvider, newAsyncDataEnvelope, SsrContext, useAsyncCollection, useAsyncData, useGlobalState };
 
 // eslint-disable-next-line @typescript-eslint/consistent-type-definitions