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

package/package.json

@@ -1,17 +1,15 @@
 {
   "name": "@dr.pogodin/react-global-state",
-  "version": "0.20.1",
+  "version": "0.21.0",
   "description": "Hook-based global state for React",
   "main": "./build/code/index.js",
   "types": "./build/types/index.d.ts",
   "exports": {
-    "require": "./build/cjs/index.js",
     "types": "./build/types/index.d.ts",
     "default": "./build/code/index.js"
   },
   "scripts": {
-    "build": "rimraf build && npm run build:types && npm run build:code && npm run build:cjs",
-    "build:cjs": "rimraf buidl/cjs && babel src -x .ts,.tsx --out-dir build/cjs --source-maps",
+    "build": "rimraf build && npm run build:types && npm run build:code",
     "build:code": "rimraf build/code && babel src -x .ts,.tsx --out-dir build/code --source-maps --config-file ./babel.module.config.js",
     "build:types": "rimraf build/types && tsc --project tsconfig.types.json",
     "jest": "npm run jest:types && npm run jest:logic",
@@ -58,7 +56,7 @@
     "@dr.pogodin/eslint-configs": "^0.1.1",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.0",
-    "@tsconfig/recommended": "^1.0.10",
+    "@tsconfig/recommended": "^1.0.11",
     "@types/jest": "^30.0.0",
     "@types/pretty": "^2.0.3",
     "@types/react": "^19.2.2",
@@ -69,7 +67,7 @@
     "jest": "^30.2.0",
     "jest-environment-jsdom": "^30.2.0",
     "mockdate": "^3.0.5",
-    "rimraf": "^6.0.1",
+    "rimraf": "^6.1.0",
     "tstyche": "^5.0.0",
     "typescript": "^5.9.3"
   },

package/build/cjs/GlobalState.js

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

package/build/cjs/GlobalState.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"GlobalState.js","names":["_get","_interopRequireDefault","require","_isFunction","_isObject","_isNil","_set","_toPath","_utils","ERR_NO_SSR_WATCH","GlobalState","asyncDataAbortCallbacks","dependencies","initialState","watchers","nextNotifierId","currentState","constructor","ssrContext","dirty","pending","state","process","env","NODE_ENV","isDebugMode","msg","console","groupCollapsed","log","cloneDeepForLog","groupEnd","numAsyncDataAbortCallbacks","Object","keys","length","asyncDataLoadDone","opid","aborted","dropDependencies","path","hasChangedDependencies","deps","prevDeps","changed","i","freeze","getEntireState","opts","undefined","initialValue","iv","isFunction","setEntireState","notifyStateUpdate","value","p","setTimeout","watcher","setAsyncDataAbortCallback","cb","get","isNil","res","set","root","segIdx","pos","pathSegments","toPath","seg","next","Array","isArray","isObject","slice","unWatch","callback","Error","indexOf","pop","watch","includes","push","exports","default"],"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/cjs/GlobalStateProvider.js

@@ -1,100 +0,0 @@
-"use strict";
-
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = void 0;
-exports.getGlobalState = getGlobalState;
-exports.getSsrContext = getSsrContext;
-var _isFunction = _interopRequireDefault(require("lodash/isFunction.js"));
-var _react = require("react");
-var _GlobalState = _interopRequireDefault(require("./GlobalState"));
-var _jsxRuntime = require("react/jsx-runtime");
-const Context = /*#__PURE__*/(0, _react.createContext)(null);
-
-/**
- * Gets {@link GlobalState} instance from the context. In most cases
- * you should use {@link useGlobalState}, and other hooks to interact with
- * the global state, instead of accessing it directly.
- * @return
- */
-function getGlobalState() {
-  // TODO: Think about it: on one hand we on purpose called this function
-  // as getGlobalState(), so that ppl looking for the state hook prefer using
-  // useGlobalState(), while this getGlobalState() is reserved for nieche cases;
-  // on the other hand, perhaps we can rename it into useSomething, to both
-  // follow conventions, and to keep stuff clearly named at the same time.
-  // eslint-disable-next-line react-hooks/rules-of-hooks
-  const globalState = (0, _react.use)(Context);
-  if (!globalState) throw new Error('Missing GlobalStateProvider');
-  return globalState;
-}
-
-/**
- * @category Hooks
- * @desc Gets 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 the hook will throw
- * if the {@link <GlobalStateProvider>} (hence the state) is missing.
- * @returns SSR context.
- * @throws
- * - If current component has no parent {@link <GlobalStateProvider>}
- *   in the rendered React tree.
- * - If `throwWithoutSsrContext` is `true`, and there is no SSR context attached
- *   to the global state provided by {@link <GlobalStateProvider>}.
- */
-function getSsrContext(throwWithoutSsrContext = true) {
-  const {
-    ssrContext
-  } = getGlobalState();
-  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 = ({
-  children,
-  ...rest
-}) => {
-  const [localState, setLocalState] = (0, _react.useState)();
-  let state;
-
-  // 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) {
-    if (localState) setLocalState(undefined);
-    state = rest.stateProxy === true ? getGlobalState() : rest.stateProxy;
-  } else if (localState) {
-    state = localState;
-  } else {
-    const {
-      initialState,
-      ssrContext
-    } = rest;
-    state = new _GlobalState.default((0, _isFunction.default)(initialState) ? initialState() : initialState, ssrContext);
-    setLocalState(state);
-  }
-  return /*#__PURE__*/(0, _jsxRuntime.jsx)(Context, {
-    value: state,
-    children: children
-  });
-};
-var _default = exports.default = GlobalStateProvider;
-//# sourceMappingURL=GlobalStateProvider.js.map

package/build/cjs/GlobalStateProvider.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"GlobalStateProvider.js","names":["_isFunction","_interopRequireDefault","require","_react","_GlobalState","_jsxRuntime","Context","createContext","getGlobalState","globalState","use","Error","getSsrContext","throwWithoutSsrContext","ssrContext","GlobalStateProvider","children","rest","localState","setLocalState","useState","state","stateProxy","undefined","initialState","GlobalState","isFunction","jsx","value","_default","exports","default"],"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,IAAAA,WAAA,GAAAC,sBAAA,CAAAC,OAAA;AAEA,IAAAC,MAAA,GAAAD,OAAA;AAOA,IAAAE,YAAA,GAAAH,sBAAA,CAAAC,OAAA;AAAwC,IAAAG,WAAA,GAAAH,OAAA;AAKxC,MAAMI,OAAO,gBAAG,IAAAC,oBAAa,EAA8B,IAAI,CAAC;;AAEhE;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,cAAcA,CAAA,EAGQ;EACpC;EACA;EACA;EACA;EACA;EACA;EACA,MAAMC,WAAW,GAAG,IAAAC,UAAG,EAACJ,OAAO,CAAC;EAChC,IAAI,CAACG,WAAW,EAAE,MAAM,IAAIE,KAAK,CAAC,6BAA6B,CAAC;EAChE,OAAOF,WAAW;AACpB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASG,aAAaA,CAG3BC,sBAAsB,GAAG,IAAI,EACJ;EACzB,MAAM;IAAEC;EAAW,CAAC,GAAGN,cAAc,CAAoC,CAAC;EAC1E,IAAI,CAACM,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,GAAG,IAAAC,eAAQ,EAAM,CAAC;EAEnD,IAAIC,KAAU;;EAEd;EACA;EACA;EACA;EACA,IAAI,YAAY,IAAIJ,IAAI,IAAKA,IAAI,CAACK,UAAsB,EAAE;IACxD,IAAIJ,UAAU,EAAEC,aAAa,CAACI,SAAS,CAAC;IACxCF,KAAK,GAAGJ,IAAI,CAACK,UAAU,KAAK,IAAI,GAAGd,cAAc,CAAC,CAAC,GAAGS,IAAI,CAACK,UAAU;EACvE,CAAC,MAAM,IAAIJ,UAAU,EAAE;IACrBG,KAAK,GAAGH,UAAU;EACpB,CAAC,MAAM;IACL,MAAM;MACJM,YAAY;MACZV;IACF,CAAC,GAAGG,IAA0C;IAE9CI,KAAK,GAAG,IAAII,oBAAW,CACrB,IAAAC,mBAAU,EAACF,YAAY,CAAC,GAAGA,YAAY,CAAC,CAAC,GAAGA,YAAY,EACxDV,UACF,CAAC;IAEDK,aAAa,CAACE,KAAK,CAAC;EACtB;EAEA,oBAAO,IAAAhB,WAAA,CAAAsB,GAAA,EAACrB,OAAO;IAACsB,KAAK,EAAEP,KAAM;IAAAL,QAAA,EAAEA;EAAQ,CAAU,CAAC;AACpD,CAAC;AAAC,IAAAa,QAAA,GAAAC,OAAA,CAAAC,OAAA,GAEahB,mBAAmB","ignoreList":[]}

package/build/cjs/SsrContext.js

@@ -1,15 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = void 0;
-class SsrContext {
-  dirty = false;
-  pending = [];
-  constructor(state) {
-    this.state = state;
-  }
-}
-exports.default = SsrContext;
-//# sourceMappingURL=SsrContext.js.map

package/build/cjs/SsrContext.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"SsrContext.js","names":["SsrContext","dirty","pending","constructor","state","exports","default"],"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":";;;;;;AAAe,MAAMA,UAAU,CAAS;EACtCC,KAAK,GAAY,KAAK;EAEtBC,OAAO,GAAyB,EAAE;EAElCC,WAAWA,CAAQC,KAAc,EAAE;IAAA,KAAhBA,KAAc,GAAdA,KAAc;EAAI;AACvC;AAACC,OAAA,CAAAC,OAAA,GAAAN,UAAA","ignoreList":[]}

package/build/cjs/index.js

@@ -1,88 +0,0 @@
-"use strict";
-
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-Object.defineProperty(exports, "GlobalState", {
-  enumerable: true,
-  get: function () {
-    return _GlobalState.default;
-  }
-});
-Object.defineProperty(exports, "GlobalStateProvider", {
-  enumerable: true,
-  get: function () {
-    return _GlobalStateProvider.default;
-  }
-});
-Object.defineProperty(exports, "SsrContext", {
-  enumerable: true,
-  get: function () {
-    return _SsrContext.default;
-  }
-});
-Object.defineProperty(exports, "getGlobalState", {
-  enumerable: true,
-  get: function () {
-    return _GlobalStateProvider.getGlobalState;
-  }
-});
-Object.defineProperty(exports, "getSsrContext", {
-  enumerable: true,
-  get: function () {
-    return _GlobalStateProvider.getSsrContext;
-  }
-});
-Object.defineProperty(exports, "newAsyncDataEnvelope", {
-  enumerable: true,
-  get: function () {
-    return _useAsyncData.newAsyncDataEnvelope;
-  }
-});
-Object.defineProperty(exports, "useAsyncCollection", {
-  enumerable: true,
-  get: function () {
-    return _useAsyncCollection.default;
-  }
-});
-Object.defineProperty(exports, "useAsyncData", {
-  enumerable: true,
-  get: function () {
-    return _useAsyncData.useAsyncData;
-  }
-});
-Object.defineProperty(exports, "useGlobalState", {
-  enumerable: true,
-  get: function () {
-    return _useGlobalState.default;
-  }
-});
-exports.withGlobalStateType = withGlobalStateType;
-var _GlobalState = _interopRequireDefault(require("./GlobalState"));
-var _GlobalStateProvider = _interopRequireWildcard(require("./GlobalStateProvider"));
-var _SsrContext = _interopRequireDefault(require("./SsrContext"));
-var _useAsyncCollection = _interopRequireDefault(require("./useAsyncCollection"));
-var _useAsyncData = require("./useAsyncData");
-var _useGlobalState = _interopRequireDefault(require("./useGlobalState"));
-function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
-// eslint-disable-next-line @typescript-eslint/consistent-type-definitions
-
-const api = {
-  // TODO: I am puzzled, why ESLint eforces this sorting order as alphabetical?
-  // Perhaps, we should tune something in its config settings, as it seems to mix
-  // some extra sorting logic, which I am not sure I like.
-  GlobalState: _GlobalState.default,
-  GlobalStateProvider: _GlobalStateProvider.default,
-  SsrContext: _SsrContext.default,
-  getGlobalState: _GlobalStateProvider.getGlobalState,
-  getSsrContext: _GlobalStateProvider.getSsrContext,
-  newAsyncDataEnvelope: _useAsyncData.newAsyncDataEnvelope,
-  useAsyncCollection: _useAsyncCollection.default,
-  useAsyncData: _useAsyncData.useAsyncData,
-  useGlobalState: _useGlobalState.default
-};
-function withGlobalStateType() {
-  return api;
-}
-//# sourceMappingURL=index.js.map

package/build/cjs/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","names":["_GlobalState","_interopRequireDefault","require","_GlobalStateProvider","_interopRequireWildcard","_SsrContext","_useAsyncCollection","_useAsyncData","_useGlobalState","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","api","GlobalState","GlobalStateProvider","SsrContext","getGlobalState","getSsrContext","newAsyncDataEnvelope","useAsyncCollection","useAsyncData","useGlobalState","withGlobalStateType"],"sources":["../../src/index.ts"],"sourcesContent":["import GlobalState from './GlobalState';\n\nimport GlobalStateProvider, {\n  getGlobalState,\n  getSsrContext,\n} from './GlobalStateProvider';\n\nimport SsrContext from './SsrContext';\n\nimport useAsyncCollection, {\n  type UseAsyncCollectionI,\n  type UseAsyncCollectionResT,\n} from './useAsyncCollection';\n\nimport {\n  type AsyncDataEnvelopeT,\n  type AsyncDataLoaderT,\n  type AsyncDataReloaderT,\n  type UseAsyncDataI,\n  type UseAsyncDataOptionsT,\n  type UseAsyncDataResT,\n  newAsyncDataEnvelope,\n  useAsyncData,\n} from './useAsyncData';\n\nimport useGlobalState, { type UseGlobalStateI } from './useGlobalState';\n\nexport type {\n  AsyncCollectionLoaderT,\n  AsyncCollectionReloaderT,\n  AsyncCollectionT,\n} from './useAsyncCollection';\n\nexport type { SetterT, UseGlobalStateResT } from './useGlobalState';\n\nexport type { ForceT, ValueOrInitializerT } from './utils';\n\nexport {\n  type AsyncDataEnvelopeT,\n  type AsyncDataLoaderT,\n  type AsyncDataReloaderT,\n  type UseAsyncCollectionResT,\n  type UseAsyncDataOptionsT,\n  type UseAsyncDataResT,\n  getGlobalState,\n  getSsrContext,\n  GlobalState,\n  GlobalStateProvider,\n  newAsyncDataEnvelope,\n  SsrContext,\n  useAsyncCollection,\n  useAsyncData,\n  useGlobalState,\n};\n\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\ninterface API<\n  StateT,\n  SsrContextT extends SsrContext<StateT> = SsrContext<StateT>,\n> {\n  getGlobalState: typeof getGlobalState<StateT, SsrContextT>;\n  getSsrContext: typeof getSsrContext<SsrContextT>;\n  GlobalState: typeof GlobalState<StateT, SsrContextT>;\n  GlobalStateProvider: typeof GlobalStateProvider<StateT, SsrContextT>;\n  newAsyncDataEnvelope: typeof newAsyncDataEnvelope;\n  SsrContext: typeof SsrContext<StateT>;\n  useAsyncCollection: UseAsyncCollectionI<StateT>;\n  useAsyncData: UseAsyncDataI<StateT>;\n  useGlobalState: UseGlobalStateI<StateT>;\n}\n\nconst api = {\n  // TODO: I am puzzled, why ESLint eforces this sorting order as alphabetical?\n  // Perhaps, we should tune something in its config settings, as it seems to mix\n  // some extra sorting logic, which I am not sure I like.\n  GlobalState,\n  GlobalStateProvider,\n  SsrContext,\n  getGlobalState,\n  getSsrContext,\n  newAsyncDataEnvelope,\n  useAsyncCollection,\n  useAsyncData,\n  useGlobalState,\n};\n\nexport function withGlobalStateType<\n  StateT,\n  SsrContextT extends SsrContext<StateT> = SsrContext<StateT>,\n>(): API<StateT, SsrContextT> {\n  return api as API<StateT, SsrContextT>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,YAAA,GAAAC,sBAAA,CAAAC,OAAA;AAEA,IAAAC,oBAAA,GAAAC,uBAAA,CAAAF,OAAA;AAKA,IAAAG,WAAA,GAAAJ,sBAAA,CAAAC,OAAA;AAEA,IAAAI,mBAAA,GAAAL,sBAAA,CAAAC,OAAA;AAKA,IAAAK,aAAA,GAAAL,OAAA;AAWA,IAAAM,eAAA,GAAAP,sBAAA,CAAAC,OAAA;AAAwE,SAAAE,wBAAAK,CAAA,EAAAC,CAAA,6BAAAC,OAAA,MAAAC,CAAA,OAAAD,OAAA,IAAAE,CAAA,OAAAF,OAAA,YAAAP,uBAAA,YAAAA,CAAAK,CAAA,EAAAC,CAAA,SAAAA,CAAA,IAAAD,CAAA,IAAAA,CAAA,CAAAK,UAAA,SAAAL,CAAA,MAAAM,CAAA,EAAAC,CAAA,EAAAC,CAAA,KAAAC,SAAA,QAAAC,OAAA,EAAAV,CAAA,iBAAAA,CAAA,uBAAAA,CAAA,yBAAAA,CAAA,SAAAQ,CAAA,MAAAF,CAAA,GAAAL,CAAA,GAAAG,CAAA,GAAAD,CAAA,QAAAG,CAAA,CAAAK,GAAA,CAAAX,CAAA,UAAAM,CAAA,CAAAM,GAAA,CAAAZ,CAAA,GAAAM,CAAA,CAAAO,GAAA,CAAAb,CAAA,EAAAQ,CAAA,gBAAAP,CAAA,IAAAD,CAAA,gBAAAC,CAAA,OAAAa,cAAA,CAAAC,IAAA,CAAAf,CAAA,EAAAC,CAAA,OAAAM,CAAA,IAAAD,CAAA,GAAAU,MAAA,CAAAC,cAAA,KAAAD,MAAA,CAAAE,wBAAA,CAAAlB,CAAA,EAAAC,CAAA,OAAAM,CAAA,CAAAK,GAAA,IAAAL,CAAA,CAAAM,GAAA,IAAAP,CAAA,CAAAE,CAAA,EAAAP,CAAA,EAAAM,CAAA,IAAAC,CAAA,CAAAP,CAAA,IAAAD,CAAA,CAAAC,CAAA,WAAAO,CAAA,KAAAR,CAAA,EAAAC,CAAA;AA8BxE;;AAgBA,MAAMkB,GAAG,GAAG;EACV;EACA;EACA;EACAC,WAAW,EAAXA,oBAAW;EACXC,mBAAmB,EAAnBA,4BAAmB;EACnBC,UAAU,EAAVA,mBAAU;EACVC,cAAc,EAAdA,mCAAc;EACdC,aAAa,EAAbA,kCAAa;EACbC,oBAAoB,EAApBA,kCAAoB;EACpBC,kBAAkB,EAAlBA,2BAAkB;EAClBC,YAAY,EAAZA,0BAAY;EACZC,cAAc,EAAdA;AACF,CAAC;AAEM,SAASC,mBAAmBA,CAAA,EAGL;EAC5B,OAAOV,GAAG;AACZ","ignoreList":[]}