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

package/LICENSE.md

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

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

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

package/build/logic/GlobalState.js.map

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

package/build/logic/GlobalStateProvider.js

@@ -0,0 +1,102 @@
+import { c as _c } from "react/compiler-runtime";
+import { createContext, use, useState } from 'react';
+import GlobalState from "./GlobalState.js";
+import { jsx as _jsx } from "react/jsx-runtime";
+const Context = /*#__PURE__*/createContext(null);
+
+/**
+ * Returns the GlobalState object from the context. In most cases you should use
+ * other hooks, like useGlobalState(), etc. to interact with the global state,
+ * instead of accessing the GlobalState object directly.
+ */
+export function useGlobalStateObject() {
+  const globalState = use(Context);
+  if (!globalState) throw new Error('Missing GlobalStateProvider');
+  return globalState;
+}
+
+/**
+ * Returns SSR context.
+ * @param throwWithoutSsrContext - If _true_ (default), this hook will throw
+ *  if no SSR context is attached to the global state; set _false_ to not throw
+ *  in such case. In either case this hook will throw if the <GlobalStateProvider>
+ *  (hence the global state) is missing.
+ * @returns SSR context.
+ * @throws
+ *  - If current component has no parent <GlobalStateProvider> in the rendered
+ *    React tree.
+ *  - If `throwWithoutSsrContext` is _true_ (default), and there is no SSR
+ *    context attached to the global state provided by <GlobalStateProvider>.
+ */
+export function useSsrContext(t0) {
+  const throwWithoutSsrContext = t0 === undefined ? true : t0;
+  const {
+    ssrContext
+  } = useGlobalStateObject();
+  if (!ssrContext && throwWithoutSsrContext) {
+    throw new Error("No SSR context found");
+  }
+  return ssrContext;
+}
+/**
+ * Provides global state to its children.
+ * @param prop.children Component children, which will be provided with
+ * the global state, and rendered in place of the provider.
+ * @param prop.initialState Initial content of the global state.
+ * @param prop.ssrContext Server-side rendering (SSR) context.
+ * @param prop.stateProxy This option is useful for code
+ * splitting and SSR implementation:
+ * - If `true`, this provider instance will fetch and reuse the global state
+ *   from a parent provider.
+ * - If `GlobalState` instance, it will be used by this provider.
+ * - If not given, a new `GlobalState` instance will be created and used.
+ */
+const GlobalStateProvider = t0 => {
+  const $ = _c(3);
+  const {
+    children,
+    ...rest
+  } = t0;
+  const [localState, setLocalState] = useState();
+  let state;
+  if ("stateProxy" in rest && rest.stateProxy) {
+    if (localState) {
+      setLocalState(undefined);
+    }
+    if (rest.stateProxy === true) {
+      const gs = use(Context);
+      if (!gs) {
+        throw Error("Missing GlobalStateProvider");
+      }
+      state = gs;
+    } else {
+      state = rest.stateProxy;
+    }
+  } else {
+    if (localState) {
+      state = localState;
+    } else {
+      const {
+        initialState,
+        ssrContext
+      } = rest;
+      state = new GlobalState(typeof initialState === "function" ? initialState() : initialState, ssrContext);
+      setLocalState(state);
+    }
+  }
+  let t1;
+  if ($[0] !== children || $[1] !== state) {
+    t1 = /*#__PURE__*/_jsx(Context, {
+      value: state,
+      children: children
+    });
+    $[0] = children;
+    $[1] = state;
+    $[2] = t1;
+  } else {
+    t1 = $[2];
+  }
+  return t1;
+};
+export default GlobalStateProvider;
+//# sourceMappingURL=GlobalStateProvider.js.map

package/build/logic/GlobalStateProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlobalStateProvider.js","names":["state"],"sources":["../../src/GlobalStateProvider.tsx"],"sourcesContent":["import {\n  type ReactNode,\n  createContext,\n  use,\n  useState,\n} from 'react';\n\nimport GlobalState from './GlobalState';\nimport type SsrContext from './SsrContext';\n\nimport type { ValueOrInitializerT } from './utils';\n\nconst Context = createContext<GlobalState<unknown> | null>(null);\n\n/**\n * Returns the GlobalState object from the context. In most cases you should use\n * other hooks, like useGlobalState(), etc. to interact with the global state,\n * instead of accessing the GlobalState object directly.\n */\nexport function useGlobalStateObject<\n  StateT,\n  SsrContextT extends SsrContext<StateT> = SsrContext<StateT>,\n>(): GlobalState<StateT, SsrContextT> {\n  const globalState = use(Context);\n  if (!globalState) throw new Error('Missing GlobalStateProvider');\n  return globalState as GlobalState<StateT, SsrContextT>;\n}\n\n/**\n * Returns SSR context.\n * @param throwWithoutSsrContext - If _true_ (default), this hook will throw\n *  if no SSR context is attached to the global state; set _false_ to not throw\n *  in such case. In either case this hook will throw if the <GlobalStateProvider>\n *  (hence the global state) is missing.\n * @returns SSR context.\n * @throws\n *  - If current component has no parent <GlobalStateProvider> in the rendered\n *    React tree.\n *  - If `throwWithoutSsrContext` is _true_ (default), and there is no SSR\n *    context attached to the global state provided by <GlobalStateProvider>.\n */\nexport function useSsrContext<\n  SsrContextT extends SsrContext<unknown>,\n>(\n  throwWithoutSsrContext = true,\n): SsrContextT | undefined {\n  const { ssrContext } = useGlobalStateObject<SsrContextT['state'], SsrContextT>();\n  if (!ssrContext && throwWithoutSsrContext) {\n    throw new Error('No SSR context found');\n  }\n  return ssrContext;\n}\n\ntype NewStateProps<StateT, SsrContextT extends SsrContext<StateT>> = {\n  initialState: ValueOrInitializerT<StateT>;\n  ssrContext?: SsrContextT;\n};\n\ntype GlobalStateProviderProps<\n  StateT,\n  SsrContextT extends SsrContext<StateT>,\n> = (NewStateProps<StateT, SsrContextT> | {\n  stateProxy: GlobalState<StateT, SsrContextT> | true;\n}) & {\n  children?: ReactNode;\n};\n\n/**\n * Provides global state to its children.\n * @param prop.children Component children, which will be provided with\n * the global state, and rendered in place of the provider.\n * @param prop.initialState Initial content of the global state.\n * @param prop.ssrContext Server-side rendering (SSR) context.\n * @param prop.stateProxy This option is useful for code\n * splitting and SSR implementation:\n * - If `true`, this provider instance will fetch and reuse the global state\n *   from a parent provider.\n * - If `GlobalState` instance, it will be used by this provider.\n * - If not given, a new `GlobalState` instance will be created and used.\n */\nconst GlobalStateProvider = <\n  StateT,\n  SsrContextT extends SsrContext<StateT> = SsrContext<StateT>,\n>(\n  { children, ...rest }: GlobalStateProviderProps<StateT, SsrContextT>,\n): ReactNode => {\n  type GST = GlobalState<StateT, SsrContextT>;\n\n  const [localState, setLocalState] = useState<GST>();\n\n  let state: GST;\n\n  // Below we cast `rest.stateProxy` as \"boolean\" for safe backward\n  // compatibility with plain JavaScript (as TypeScript typings only\n  // permit \"true\" or GlobalState value; while legacy codebase may\n  // pass in a boolean value here, occasionally equal \"false\").\n  if ('stateProxy' in rest && (rest.stateProxy as boolean)) {\n    if (localState) setLocalState(undefined);\n\n    if (rest.stateProxy === true) {\n      const gs = use(Context);\n      if (!gs) throw Error('Missing GlobalStateProvider');\n      state = gs as GlobalState<StateT, SsrContextT>;\n    } else state = rest.stateProxy;\n  } else if (localState) {\n    state = localState;\n  } else {\n    const {\n      initialState,\n      ssrContext,\n    } = rest as NewStateProps<StateT, SsrContextT>;\n\n    state = new GlobalState(\n      typeof initialState === 'function' ? (initialState as () => StateT)() : initialState,\n      ssrContext,\n    );\n\n    setLocalState(state);\n  }\n\n  return <Context value={state}>{children}</Context>;\n};\n\nexport default GlobalStateProvider;\n"],"mappings":";AAAA,SAEE,aAAa,EACb,GAAG,EACH,QAAQ,QACH,OAAO;AAAC,OAER,WAAW;AAAA;AAKlB,MAAM,OAAO,gBAAG,aAAa,CAA8B,IAAI,CAAC;;AAEhE;AACA;AACA;AACA;AACA;AACA,OAAO,SAAS,oBAAoB,GAGE;EACpC,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC;EAChC,IAAI,CAAC,WAAW,EAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC;EAChE,OAAO,WAAW;AACpB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO;EAGL,iCAA6B,KAA7B,SAA6B,GAA7B,IAA6B,GAA7B,EAA6B;EAE7B;IAAA;EAAA,IAAuB,oBAAoB,CAAoC,CAAC;EAChF,IAAI,CAAC,UAAoC,IAArC,sBAAqC;IACvC,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC;EAAC;EACzC,OACM,UAAU;AAAA;AAiBnB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,mBAAmB,GAAG;EAAA;EAI1B;IAAA;IAAA;EAAA,MAAoE;EAIpE,oCAAoC,QAAQ,CAAM,CAAC;EAE/CA,GAAA;EAMJ,IAAI,YAAY,IAAI,IAAoC,IAA3B,IAAI,WAAuB;IACtD,IAAI,UAAU;MAAE,aAAa,CAAC,SAAS,CAAC;IAAA;IAExC,IAAI,IAAI,WAAW,KAAK,IAAI;MAC1B,WAAW,GAAG,CAAC,OAAO,CAAC;MACvB,IAAI,CAAC,EAAE;QAAE,MAAM,KAAK,CAAC,6BAA6B,CAAC;MAAC;MACpD,MAAAA,CAAA,CAAQ,EAAE;IAAL;MACA,MAAAA,CAAA,CAAQ,IAAI,WAAW;IAAlB;EAAmB;IAC1B,IAAI,UAAU;MACnB,MAAAA,CAAA,CAAQ,UAAU;IAAb;MAEL;QAAA;QAAA;MAAA,IAGI,IAAI;MAER,MAAAA,CAAA,CAAQA,GAAA,CAAI,WAAW,CACrB,OAAO,YAAY,KAAK,UAA4D,GAA9C,YAAY,CAAiC,CAAC,GAApF,YAAoF,EACpF,UACF,CAAC;MAED,aAAa,CAAC,KAAK,CAAC;IAAA;EACrB;EAAA;EAAA;IAEM,uBAAC,OAAO;MAAQA,KAAK,EAAL,KAAK;MAAA,UAAG;IAAQ,CAAU,CAAC;IAAA;IAAA;IAAA;EAAA;IAAA;EAAA;EAAA,OAA3C,EAA2C;AAAA,CACnD;AAED,eAAe,mBAAmB","ignoreList":[]}

package/build/logic/SsrContext.js

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

package/build/logic/SsrContext.js.map

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

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

@@ -1,10 +1,10 @@
 import GlobalState from "./GlobalState.js";
-import GlobalStateProvider, { getGlobalState, getSsrContext } from "./GlobalStateProvider.js";
+import GlobalStateProvider, { useGlobalStateObject, useSsrContext } from "./GlobalStateProvider.js";
 import SsrContext from "./SsrContext.js";
 import useAsyncCollection from "./useAsyncCollection.js";
 import { loadAsyncData, newAsyncDataEnvelope, useAsyncData } from "./useAsyncData.js";
 import useGlobalState from "./useGlobalState.js";
-export { GlobalState, GlobalStateProvider, SsrContext, getGlobalState, getSsrContext, loadAsyncData, newAsyncDataEnvelope, useAsyncCollection, useAsyncData, useGlobalState };
+export { GlobalState, GlobalStateProvider, SsrContext, loadAsyncData, newAsyncDataEnvelope, useAsyncCollection, useAsyncData, useGlobalState, useGlobalStateObject, useSsrContext };
 
 // eslint-disable-next-line @typescript-eslint/consistent-type-definitions
 
@@ -15,13 +15,13 @@ const api = {
   GlobalState,
   GlobalStateProvider,
   SsrContext,
-  getGlobalState,
-  getSsrContext,
   loadAsyncData,
   newAsyncDataEnvelope,
   useAsyncCollection,
   useAsyncData,
-  useGlobalState
+  useGlobalState,
+  useGlobalStateObject,
+  useSsrContext
 };
 export function withGlobalStateType() {
   return api;

package/build/logic/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/index.ts"],"sourcesContent":["import GlobalState from './GlobalState';\n\nimport GlobalStateProvider, {\n  useGlobalStateObject,\n  useSsrContext,\n} from './GlobalStateProvider';\n\nimport SsrContext from './SsrContext';\n\nimport useAsyncCollection, {\n  type UseAsyncCollectionI,\n  type UseAsyncCollectionResT,\n} from './useAsyncCollection';\n\nimport {\n  type AsyncDataEnvelopeT,\n  type AsyncDataLoaderT,\n  type AsyncDataReloaderT,\n  type LoadAsyncDataI,\n  type UseAsyncDataI,\n  type UseAsyncDataOptionsT,\n  type UseAsyncDataResT,\n  loadAsyncData,\n  newAsyncDataEnvelope,\n  useAsyncData,\n} from './useAsyncData';\n\nimport useGlobalState, { type UseGlobalStateI } from './useGlobalState';\n\nexport type {\n  AsyncCollectionLoaderT,\n  AsyncCollectionReloaderT,\n  AsyncCollectionT,\n} from './useAsyncCollection';\n\nexport type { SetterT, UseGlobalStateResT } from './useGlobalState';\n\nexport type { ForceT, ValueOrInitializerT } from './utils';\n\nexport {\n  type AsyncDataEnvelopeT,\n  type AsyncDataLoaderT,\n  type AsyncDataReloaderT,\n  GlobalState,\n  GlobalStateProvider,\n  SsrContext,\n  type UseAsyncCollectionI,\n  type UseAsyncCollectionResT,\n  type UseAsyncDataI,\n  type UseAsyncDataOptionsT,\n  type UseAsyncDataResT,\n  type UseGlobalStateI,\n  loadAsyncData,\n  newAsyncDataEnvelope,\n  useAsyncCollection,\n  useAsyncData,\n  useGlobalState,\n  useGlobalStateObject,\n  useSsrContext,\n};\n\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\ninterface API<\n  StateT,\n  SsrContextT extends SsrContext<StateT> = SsrContext<StateT>,\n> {\n  GlobalState: typeof GlobalState<StateT, SsrContextT>;\n  GlobalStateProvider: typeof GlobalStateProvider<StateT, SsrContextT>;\n  SsrContext: typeof SsrContext<StateT>;\n  loadAsyncData: LoadAsyncDataI<StateT>;\n  newAsyncDataEnvelope: typeof newAsyncDataEnvelope;\n  useAsyncCollection: UseAsyncCollectionI<StateT>;\n  useAsyncData: UseAsyncDataI<StateT>;\n  useGlobalState: UseGlobalStateI<StateT>;\n  useGlobalStateObject: typeof useGlobalStateObject<StateT, SsrContextT>;\n  useSsrContext: typeof useSsrContext<SsrContextT>;\n}\n\nconst api = {\n  // TODO: I am puzzled, why ESLint eforces this sorting order as alphabetical?\n  // Perhaps, we should tune something in its config settings, as it seems to mix\n  // some extra sorting logic, which I am not sure I like.\n  GlobalState,\n  GlobalStateProvider,\n  SsrContext,\n  loadAsyncData,\n  newAsyncDataEnvelope,\n  useAsyncCollection,\n  useAsyncData,\n  useGlobalState,\n  useGlobalStateObject,\n  useSsrContext,\n};\n\nexport function withGlobalStateType<\n  StateT,\n  SsrContextT extends SsrContext<StateT> = SsrContext<StateT>,\n>(): API<StateT, SsrContextT> {\n  return api;\n}\n"],"mappings":"OAAO,WAAW;AAAA,OAEX,mBAAmB,IACxB,oBAAoB,EACpB,aAAa;AAAA,OAGR,UAAU;AAAA,OAEV,kBAAkB;AAAA,SAavB,aAAa,EACb,oBAAoB,EACpB,YAAY;AAAA,OAGP,cAAc;AAYrB,SAIE,WAAW,EACX,mBAAmB,EACnB,UAAU,EAOV,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,aAAa;;AAGf;;AAiBA,MAAM,GAAG,GAAG;EACV;EACA;EACA;EACA,WAAW;EACX,mBAAmB;EACnB,UAAU;EACV,aAAa;EACb,oBAAoB;EACpB,kBAAkB;EAClB,YAAY;EACZ,cAAc;EACd,oBAAoB;EACpB;AACF,CAAC;AAED,OAAO,SAAS,mBAAmB,GAGL;EAC5B,OAAO,GAAG;AACZ","ignoreList":[]}