@choksheak/react-utils 0.4.6 → 0.4.8

package/chunk-KGDXU6Q2.min.cjs

@@ -0,0 +1,222 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+var _chunkRRQBFF4Wmincjs = require('./chunk-RRQBFF4W.min.cjs');
+
+// src/sharedState.ts
+var _timeConstants = require('@choksheak/ts-utils/timeConstants');
+var _react = require('react');
+var SharedStateConfig = {
+  /**
+   * Default duration for storage expiration in milliseconds. Initial value
+   * is 30 days, but can be changed to anything.
+   */
+  storeExpiryMs: 30 * _timeConstants.MS_PER_DAY,
+  /**
+   * True to load from storage only on mount, false (default) to load in
+   * the top level scope when the shared state is defined.
+   */
+  lazyLoad: false,
+  /** Default to log to console. */
+  log: (...args) => console.log("[sharedState]", ...args)
+};
+function configureSharedState(config) {
+  Object.assign(SharedStateConfig, config);
+}
+function createPubSubStore() {
+  const dataByKey = /* @__PURE__ */ new Map();
+  const subscribersByKey = /* @__PURE__ */ new Map();
+  function notify(key, next, prev) {
+    const subscribers = subscribersByKey.get(key);
+    if (!subscribers) return;
+    const copy = Array.from(subscribers.values());
+    for (const subscriber of copy) {
+      try {
+        subscriber(next, prev);
+      } catch (e) {
+        console.error(`Error invoking subscriber:`, e);
+      }
+    }
+  }
+  return {
+    // This could be undefined if T includes undefined, else it should never
+    // return undefined because the user has to always specify the default value.
+    get(key) {
+      return dataByKey.get(key);
+    },
+    set(key, value) {
+      const prev = dataByKey.get(key);
+      if (prev === value) return;
+      dataByKey.set(key, value);
+      notify(key, value, prev);
+    },
+    delete(key) {
+      dataByKey.delete(key);
+    },
+    setNoNotify(key, value) {
+      dataByKey.set(key, value);
+    },
+    // Subscribe to changes of a specific key
+    subscribe(key, subscriber) {
+      let subscribers = subscribersByKey.get(key);
+      if (!subscribers) {
+        subscribers = /* @__PURE__ */ new Set();
+        subscribersByKey.set(key, subscribers);
+      }
+      subscribers.add(subscriber);
+      return () => {
+        subscribers.delete(subscriber);
+        if (subscribers.size === 0) subscribersByKey.delete(key);
+      };
+    }
+  };
+}
+function getOrCreatePubSubStore() {
+  if (typeof window !== "undefined") {
+    const t = window.globalThis;
+    return t.reactUtilsPubSubStore || (t.reactUtilsPubSubStore = createPubSubStore());
+  }
+  return createPubSubStore();
+}
+var pubSubStore = getOrCreatePubSubStore();
+var STORAGE_KEY = "state";
+var stateKey = 0;
+function getNextStateKey() {
+  if (typeof window !== "undefined") {
+    const t = window.globalThis;
+    t.reactUtilsStateKey = (_nullishCoalesce(t.reactUtilsStateKey, () => ( 0))) + 1;
+    return t.reactUtilsStateKey;
+  }
+  return ++stateKey;
+}
+function sharedState(defaultValue, options) {
+  let readyResolve = () => {
+  };
+  const readyPromise = new Promise((resolve) => {
+    readyResolve = resolve;
+  });
+  const resolveReadyPromise = readyResolve;
+  const log = _optionalChain([options, 'optionalAccess', _ => _.log]) || SharedStateConfig.log;
+  const pubSubKey = String(getNextStateKey());
+  if (log && _optionalChain([options, 'optionalAccess', _2 => _2.name])) {
+    log(`${options.name} -> ${pubSubKey}`);
+  }
+  const storageAdapter = _chunkRRQBFF4Wmincjs.getStorageAdapter.call(void 0, 
+    options,
+    SharedStateConfig.storeExpiryMs
+  );
+  pubSubStore.setNoNotify(pubSubKey, defaultValue);
+  const lazyLoad = _optionalChain([options, 'optionalAccess', _3 => _3.lazyLoad]);
+  const lazy = lazyLoad !== void 0 ? lazyLoad : SharedStateConfig.lazyLoad;
+  function completeInit(stored) {
+    const value = stored !== void 0 ? stored : defaultValue;
+    pubSubStore.set(pubSubKey, value);
+    obj.initDone = true;
+    resolveReadyPromise();
+  }
+  const obj = {
+    name: _optionalChain([options, 'optionalAccess', _4 => _4.name]),
+    defaultValue,
+    pubSubKey,
+    /** Allow users to await for the completion of data init. */
+    readyPromise,
+    storeExpiryMs: SharedStateConfig.storeExpiryMs,
+    lazy,
+    storageAdapter,
+    initStarted: false,
+    initDone: false,
+    /** `subscribe` function required by useSyncExternalStore. */
+    subscribe(subscriber) {
+      return pubSubStore.subscribe(pubSubKey, () => subscriber());
+    },
+    /** Returns true if there is a backing store. */
+    hasStore() {
+      return Boolean(storageAdapter);
+    },
+    /**
+     * Set a value directly into the store. Does nothing if there is no
+     * backing store.
+     *
+     * Warning: If you want to set the value properly, you should use
+     * `setValue()` instead which also updates the in-memory copy.
+     */
+    setInStore(value) {
+      return _optionalChain([storageAdapter, 'optionalAccess', _5 => _5.set, 'call', _6 => _6(STORAGE_KEY, value)]);
+    },
+    /**
+     * Get a value directly from the store. Returns undefined if there is no
+     * backing store.
+     */
+    getFromStore() {
+      return _optionalChain([storageAdapter, 'optionalAccess', _7 => _7.get, 'call', _8 => _8(STORAGE_KEY)]);
+    },
+    /**
+     * Get the value of the shared state.
+     *  `getSnapshot` function — must return same ref if value unchanged.
+     * Note that this would return the default value if data init from store is
+     * not completed yet.
+     */
+    getSnapshot() {
+      return pubSubStore.get(pubSubKey);
+    },
+    /** Set the value of the shared state. */
+    setValue(next) {
+      if (typeof next === "function") {
+        const prev = pubSubStore.get(pubSubKey);
+        next = next(prev);
+      }
+      pubSubStore.set(pubSubKey, next);
+      void obj.setInStore(next);
+    },
+    /**
+     * Remove the value of the shared state. Actually this just sets the value
+     * back to the given default value.
+     */
+    delete() {
+      pubSubStore.set(pubSubKey, defaultValue);
+      return _optionalChain([storageAdapter, 'optionalAccess', _9 => _9.set, 'call', _10 => _10(STORAGE_KEY, defaultValue)]);
+    },
+    /** Initial default handling. */
+    initDefaultValueOnce() {
+      if (obj.initDone || obj.initStarted) return;
+      obj.initStarted = true;
+      const maybePromise = obj.getFromStore();
+      if (maybePromise instanceof Promise) {
+        return maybePromise.then(completeInit);
+      } else {
+        const stored = maybePromise;
+        completeInit(stored);
+      }
+    }
+  };
+  if (!lazy) {
+    obj.initDefaultValueOnce();
+  }
+  return obj;
+}
+function useSharedState(state) {
+  void state.initDefaultValueOnce();
+  const value = _react.useSyncExternalStore.call(void 0, 
+    (onStoreChange) => state.subscribe(onStoreChange),
+    () => state.getSnapshot(),
+    // getServerSnapshot is needed to prevent SSR dev errors in nextjs.
+    () => state.getSnapshot()
+  );
+  return [value, state.setValue];
+}
+function useSharedStateValue(state) {
+  return useSharedState(state)[0];
+}
+function useSharedStateSetter(state) {
+  void state.initDefaultValueOnce();
+  return state.setValue;
+}
+
+
+
+
+
+
+
+
+exports.SharedStateConfig = SharedStateConfig; exports.configureSharedState = configureSharedState; exports.sharedState = sharedState; exports.useSharedState = useSharedState; exports.useSharedStateValue = useSharedStateValue; exports.useSharedStateSetter = useSharedStateSetter;
+//# sourceMappingURL=chunk-KGDXU6Q2.min.cjs.map

package/chunk-KGDXU6Q2.min.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/choksheaklau/src/react-utils/dist/chunk-KGDXU6Q2.min.cjs","../src/sharedState.ts"],"names":[],"mappings":"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","file":"/Users/choksheaklau/src/react-utils/dist/chunk-KGDXU6Q2.min.cjs","sourcesContent":[null,"/**\n * @packageDocumentation\n *\n * The \"shared state\" is a React state that shares the same value across the\n * entire app. Users declare a shared state constant that can be reused across\n * multiple components with the same underlying value.\n *\n * Shared states provide persistence to local storage and/or indexed DB out of\n * the box, by using \"@choksheak/ts-utils\". Note that no matter if the shared\n * state uses persistence or not, it will always maintain a copy of the state\n * in memory. Persisted values can be configured with an automatic expiration\n * duration.\n *\n * This module is largely similar to the open source \"jotai\" npm library. You\n * can use shared states to replace \"jotai\" in your code, and optionally make\n * use of the persistence mechanism. A quick migration guide from jotai is:\n *\n * ```\n *   atom()          -->  sharedState()\n *   useAtom()       -->  useSharedState()\n *   useAtomValue()  -->  useSharedStateValue()\n *   useSetAtom()    -->  useSharedStateSetter()\n * ```\n *\n * Example:\n * ```\n *   import { sharedState, useSharedState } from \"@choksheak/react-utils/sharedState\";\n *\n *   // Create a new shared state in the top level scope.\n *   // The first argument is the default value, which is required.\n *   // The second argument is an options object, and is optional (defaults\n *   // to storing in memory only without any persistence).\n *   const usersState = sharedState(\n *     [], { store: { persistTo: \"indexedDb\", key: \"users\" }}\n *   );\n *\n *   export const UsersComponent: React.FC = () => {\n *     // Get both the value and the setter.\n *     const [users, setUsers] = useSharedState(usersState);\n *     ...\n *   };\n *\n *   export const ReadOnlyComponent: React.FC = () => {\n *     // Get the value only.\n *     const users = useSharedStateValue(usersState);\n *     ...\n *   };\n *\n *   export const WriteOnlyComponent: React.FC = () => {\n *     // Get the setter only.\n *     const setUsers = useSharedStateSetter(usersState);\n *     ...\n *   };\n * ```\n */\n\nimport { MS_PER_DAY } from \"@choksheak/ts-utils/timeConstants\";\nimport { Dispatch, SetStateAction, useSyncExternalStore } from \"react\";\n\nimport { getStorageAdapter, StorageOptions } from \"./storage\";\n\n/************************************************************************/\n/* Global config                                                        */\n/************************************************************************/\n\n/**\n * These values are configurable by the user at any time.\n */\nexport const SharedStateConfig = {\n  /**\n   * Default duration for storage expiration in milliseconds. Initial value\n   * is 30 days, but can be changed to anything.\n   */\n  storeExpiryMs: 30 * MS_PER_DAY,\n\n  /**\n   * True to load from storage only on mount, false (default) to load in\n   * the top level scope when the shared state is defined.\n   */\n  lazyLoad: false,\n\n  /** Default to log to console. */\n  log: (...args: unknown[]) => console.log(\"[sharedState]\", ...args),\n};\n\nexport type SharedStateConfig = typeof SharedStateConfig;\n\n/** Convenience function to update global defaults. */\nexport function configureSharedState(config: Partial<SharedStateConfig>) {\n  Object.assign(SharedStateConfig, config);\n}\n\n/************************************************************************/\n/* Pub-sub store\n/************************************************************************/\n\ntype Subscriber<T> = (next: T, prev: T) => void;\n\nfunction createPubSubStore() {\n  const dataByKey = new Map<string, unknown>();\n  const subscribersByKey = new Map<string, Set<Subscriber<unknown>>>();\n\n  function notify<T>(key: string, next: T, prev: T): void {\n    const subscribers = subscribersByKey.get(key);\n    if (!subscribers) return;\n\n    // Make copy to protect against mutation during iteration.\n    const copy = Array.from(subscribers.values());\n    for (const subscriber of copy) {\n      try {\n        subscriber(next, prev);\n      } catch (e) {\n        console.error(`Error invoking subscriber:`, e);\n      }\n    }\n  }\n\n  return {\n    // This could be undefined if T includes undefined, else it should never\n    // return undefined because the user has to always specify the default value.\n    get<T>(key: string): T {\n      return dataByKey.get(key) as T;\n    },\n\n    set<T>(key: string, value: T): void {\n      const prev = dataByKey.get(key) as T;\n\n      // Do nothing if no change.\n      if (prev === value) return;\n\n      dataByKey.set(key, value);\n      notify(key, value, prev);\n    },\n\n    delete(key: string): void {\n      dataByKey.delete(key);\n    },\n\n    setNoNotify<T>(key: string, value: T): void {\n      dataByKey.set(key, value);\n    },\n\n    // Subscribe to changes of a specific key\n    subscribe<T>(key: string, subscriber: Subscriber<T>): () => void {\n      let subscribers = subscribersByKey.get(key);\n      if (!subscribers) {\n        subscribers = new Set();\n        subscribersByKey.set(key, subscribers);\n      }\n\n      // Type coercion: we store Subscriber<unknown>\n      subscribers.add(subscriber as Subscriber<unknown>);\n\n      // Return unsubscribe function\n      return () => {\n        subscribers.delete(subscriber as Subscriber<unknown>);\n        if (subscribers.size === 0) subscribersByKey.delete(key);\n      };\n    },\n  } as const;\n}\n\n/**\n * Ensure we always use the same store. If we create two stores, then the\n * reactive updates will fail.\n */\nfunction getOrCreatePubSubStore() {\n  if (typeof window !== \"undefined\") {\n    const t = window.globalThis as {\n      reactUtilsPubSubStore?: ReturnType<typeof createPubSubStore>;\n    };\n    return (\n      t.reactUtilsPubSubStore || (t.reactUtilsPubSubStore = createPubSubStore())\n    );\n  }\n  return createPubSubStore();\n}\n\nconst pubSubStore = getOrCreatePubSubStore();\n\n/************************************************************************/\n/* Shared state implementation                                          */\n/************************************************************************/\n\nconst STORAGE_KEY = \"state\";\n\n/** Options to configure a shared state. */\nexport type SharedStateOptions<T> = {\n  /** Load from store only on first use of useSharedState(). */\n  lazyLoad?: boolean;\n  /** Used for debug logging. */\n  name?: string;\n  /** Customize the logger. */\n  log?: (...args: unknown[]) => void;\n} & StorageOptions<T>;\n\nlet stateKey = 0;\n\n// Try to make this safe across hot reloads and bundling.\nfunction getNextStateKey() {\n  if (typeof window !== \"undefined\") {\n    const t = window.globalThis as { reactUtilsStateKey?: number };\n    t.reactUtilsStateKey = (t.reactUtilsStateKey ?? 0) + 1;\n    return t.reactUtilsStateKey;\n  }\n  return ++stateKey;\n}\n\n/**\n * Create a new shared state object. Put this code at the top level scope:\n *\n * Example:\n * ```\n *   const counterState = sharedState<number>(0);\n * ```\n */\nexport function sharedState<T>(\n  defaultValue: T,\n  options?: SharedStateOptions<T>,\n) {\n  let readyResolve: () => void = () => {};\n\n  const readyPromise = new Promise<void>((resolve) => {\n    readyResolve = resolve;\n  });\n\n  const resolveReadyPromise = readyResolve;\n\n  const log = options?.log || SharedStateConfig.log;\n\n  // We'll make a new key with each hot reload, but that's ok.\n  const pubSubKey = String(getNextStateKey());\n\n  if (log && options?.name) {\n    log(`${options.name} -> ${pubSubKey}`);\n  }\n\n  // Use max of 1 storage adapter per shared state.\n  const storageAdapter = getStorageAdapter(\n    options,\n    SharedStateConfig.storeExpiryMs,\n  );\n\n  // Always set the default value first to avoid returning undefineds if that\n  // is not part of T. Don't notify with the default value.\n  pubSubStore.setNoNotify(pubSubKey, defaultValue);\n\n  const lazyLoad = options?.lazyLoad;\n  const lazy = lazyLoad !== undefined ? lazyLoad : SharedStateConfig.lazyLoad;\n\n  function completeInit(stored: T | undefined) {\n    const value = stored !== undefined ? stored : defaultValue;\n\n    pubSubStore.set(pubSubKey, value);\n\n    // @ts-expect-error ts(2540) - Assign to readonly property.\n    obj.initDone = true;\n    resolveReadyPromise();\n  }\n\n  const obj = {\n    name: options?.name,\n    defaultValue,\n    pubSubKey,\n\n    /** Allow users to await for the completion of data init. */\n    readyPromise,\n\n    storeExpiryMs: SharedStateConfig.storeExpiryMs,\n    lazy,\n    storageAdapter,\n\n    initStarted: false,\n    initDone: false,\n\n    /** `subscribe` function required by useSyncExternalStore. */\n    subscribe(subscriber: () => void): () => void {\n      return pubSubStore.subscribe(pubSubKey, () => subscriber());\n    },\n\n    /** Returns true if there is a backing store. */\n    hasStore(): boolean {\n      return Boolean(storageAdapter);\n    },\n\n    /**\n     * Set a value directly into the store. Does nothing if there is no\n     * backing store.\n     *\n     * Warning: If you want to set the value properly, you should use\n     * `setValue()` instead which also updates the in-memory copy.\n     */\n    setInStore(value: T): Promise<void> | void {\n      return storageAdapter?.set(STORAGE_KEY, value);\n    },\n\n    /**\n     * Get a value directly from the store. Returns undefined if there is no\n     * backing store.\n     */\n    getFromStore(): Promise<T | undefined> | T | undefined {\n      return storageAdapter?.get(STORAGE_KEY);\n    },\n\n    /**\n     * Get the value of the shared state.\n     *  `getSnapshot` function — must return same ref if value unchanged.\n     * Note that this would return the default value if data init from store is\n     * not completed yet.\n     */\n    getSnapshot(): T {\n      return pubSubStore.get(pubSubKey);\n    },\n\n    /** Set the value of the shared state. */\n    setValue(next: SetStateAction<T>): void {\n      if (typeof next === \"function\") {\n        const prev = pubSubStore.get<T>(pubSubKey);\n        next = (next as (p: T) => T)(prev);\n      }\n\n      pubSubStore.set(pubSubKey, next);\n      void obj.setInStore(next);\n    },\n\n    /**\n     * Remove the value of the shared state. Actually this just sets the value\n     * back to the given default value.\n     */\n    delete(): Promise<void> | void {\n      pubSubStore.set(pubSubKey, defaultValue);\n      return storageAdapter?.set(STORAGE_KEY, defaultValue);\n    },\n\n    /** Initial default handling. */\n    initDefaultValueOnce(): Promise<void> | void {\n      if (obj.initDone || obj.initStarted) return;\n      // @ts-expect-error ts(2540) - Assign to readonly property.\n      obj.initStarted = true;\n\n      const maybePromise = obj.getFromStore();\n\n      // Allow sync vs async code paths. This allows init to be fully completed\n      // from store before the sharedState() function returns.\n      if (maybePromise instanceof Promise) {\n        return maybePromise.then(completeInit);\n      } else {\n        const stored = maybePromise;\n        completeInit(stored);\n      }\n    },\n  } as const;\n\n  if (!lazy) {\n    obj.initDefaultValueOnce();\n  }\n\n  return obj;\n}\n\nexport type SharedState<T> = ReturnType<typeof sharedState<T>>;\n\n/**\n * React hook for subscribing to a key in the global store.\n *\n * Example:\n * ```\n *   const [counter, setCounter] = useSharedState(counterState);\n * ```\n */\nexport function useSharedState<T>(\n  state: SharedState<T>,\n): [T, Dispatch<SetStateAction<T>>] {\n  void state.initDefaultValueOnce();\n\n  const value = useSyncExternalStore(\n    (onStoreChange) => state.subscribe(onStoreChange),\n    () => state.getSnapshot(),\n    // getServerSnapshot is needed to prevent SSR dev errors in nextjs.\n    () => state.getSnapshot(),\n  );\n\n  return [value, state.setValue];\n}\n\n/**\n * Same as useSharedState(), but returns the value only.\n *\n * Example:\n * ```\n *   const counter = useSharedStateValue(counterState);\n * ```\n */\nexport function useSharedStateValue<T>(state: SharedState<T>) {\n  return useSharedState(state)[0];\n}\n\n/**\n * Same as useSharedState(), but returns the setter only.\n *\n * Example:\n * ```\n *   const setCounter = useSharedStateSetter(counterState);\n * ```\n */\nexport function useSharedStateSetter<T>(state: SharedState<T>) {\n  void state.initDefaultValueOnce();\n\n  return state.setValue;\n}\n"]}

package/chunk-MNWSPF5J.min.js

@@ -0,0 +1,18 @@
+// src/useDeepMemo.ts
+import { isEqual } from "lodash-es";
+import { useMemo, useState } from "react";
+function useDeepMemo(value) {
+  const [state, setState] = useState(value);
+  return useMemo(() => {
+    if (isEqual(state, value)) {
+      return state;
+    }
+    setState(value);
+    return value;
+  }, [state, value]);
+}
+
+export {
+  useDeepMemo
+};
+//# sourceMappingURL=chunk-MNWSPF5J.min.js.map

package/{useDeepMemo.min.mjs.map → chunk-MNWSPF5J.min.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/useDeepMemo.ts"],"sourcesContent":["/**\n * @packageDocumentation\n *\n * Provides a memoized value in React where the value is checked for deep\n * equality. If the value has changed, but is deeply equal to the previous\n * value, then useDeepMemo will return the same reference to the previous\n * value and ignore the latest value.\n *\n * This is mainly used in shared queries to check for changes in the query\n * arguments, but it might be useful for your own use cases.\n */\n\nimport { isEqual } from \"lodash-es\";\nimport { useMemo, useState } from \"react\";\n\n/**\n * Provides a stable value for T based on deep equality. The deep equality is\n * determined by the `isEqual()` function in lodash.\n */\nexport function useDeepMemo<T>(value: T): T {\n  const [state, setState] = useState<T>(value);\n\n  return useMemo(() => {\n    if (isEqual(state, value)) {\n      return state;\n    }\n\n    // We check equality, so this should be safe.\n    // eslint-disable-next-line react-hooks/set-state-in-render\n    setState(value);\n\n    return value;\n  }, [state, value]);\n}\n"],"mappings":"AAYA,OAAS,WAAAA,MAAe,YACxB,OAAS,WAAAC,EAAS,YAAAC,MAAgB,QAM3B,SAASC,EAAeC,EAAa,CAC1C,GAAM,CAACC,EAAOC,CAAQ,EAAIJ,EAAYE,CAAK,EAE3C,OAAOH,EAAQ,IACTD,EAAQK,EAAOD,CAAK,EACfC,GAKTC,EAASF,CAAK,EAEPA,GACN,CAACC,EAAOD,CAAK,CAAC,CACnB","names":["isEqual","useMemo","useState","useDeepMemo","value","state","setState"]}
+{"version":3,"sources":["../src/useDeepMemo.ts"],"sourcesContent":["/**\n * @packageDocumentation\n *\n * Provides a memoized value in React where the value is checked for deep\n * equality. If the value has changed, but is deeply equal to the previous\n * value, then useDeepMemo will return the same reference to the previous\n * value and ignore the latest value.\n *\n * This is mainly used in shared queries to check for changes in the query\n * arguments, but it might be useful for your own use cases.\n */\n\nimport { isEqual } from \"lodash-es\";\nimport { useMemo, useState } from \"react\";\n\n/**\n * Provides a stable value for T based on deep equality. The deep equality is\n * determined by the `isEqual()` function in lodash.\n */\nexport function useDeepMemo<T>(value: T): T {\n  const [state, setState] = useState<T>(value);\n\n  return useMemo(() => {\n    if (isEqual(state, value)) {\n      return state;\n    }\n\n    // We check equality, so this should be safe.\n    // eslint-disable-next-line react-hooks/set-state-in-render\n    setState(value);\n\n    return value;\n  }, [state, value]);\n}\n"],"mappings":";AAYA,SAAS,eAAe;AACxB,SAAS,SAAS,gBAAgB;AAM3B,SAAS,YAAe,OAAa;AAC1C,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAY,KAAK;AAE3C,SAAO,QAAQ,MAAM;AACnB,QAAI,QAAQ,OAAO,KAAK,GAAG;AACzB,aAAO;AAAA,IACT;AAIA,aAAS,KAAK;AAEd,WAAO;AAAA,EACT,GAAG,CAAC,OAAO,KAAK,CAAC;AACnB;","names":[]}

package/chunk-P2E73RBM.min.cjs

@@ -0,0 +1,35 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});// src/stringify.ts
+function stringifyDeterministicForKeys(params) {
+  const cache = /* @__PURE__ */ new Set();
+  return JSON.stringify(params, (_, value) => {
+    if (typeof value === "function") {
+      throw new Error(`Functions should not be passed into query parameters`);
+    }
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+      return value;
+    }
+    if (cache.has(value)) {
+      return "[Circular]";
+    }
+    cache.add(value);
+    if (value !== params) {
+      try {
+        JSON.stringify(value);
+      } catch (e) {
+        return "[Unserializable]";
+      }
+    }
+    return Object.keys(value).sort().reduce(
+      (result, key) => {
+        result[key] = value[key];
+        return result;
+      },
+      {}
+    );
+  });
+}
+
+
+
+exports.stringifyDeterministicForKeys = stringifyDeterministicForKeys;
+//# sourceMappingURL=chunk-P2E73RBM.min.cjs.map

package/chunk-P2E73RBM.min.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/choksheaklau/src/react-utils/dist/chunk-P2E73RBM.min.cjs","../src/stringify.ts"],"names":[],"mappings":"AAAA;ACmBO,SAAS,6BAAA,CAA8B,MAAA,EAAyB;AACrE,EAAA,MAAM,MAAA,kBAAQ,IAAI,GAAA,CAAI,CAAA;AAEtB,EAAA,OAAO,IAAA,CAAK,SAAA,CAAU,MAAA,EAAQ,CAAC,CAAA,EAAG,KAAA,EAAA,GAAU;AAC1C,IAAA,GAAA,CAAI,OAAO,MAAA,IAAU,UAAA,EAAY;AAC/B,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,oDAAA,CAAsD,CAAA;AAAA,IACxE;AAEA,IAAA,GAAA,CAAI,CAAC,MAAA,GAAS,OAAO,MAAA,IAAU,SAAA,GAAY,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,EAAG;AAC/D,MAAA,OAAO,KAAA;AAAA,IACT;AAEA,IAAA,GAAA,CAAI,KAAA,CAAM,GAAA,CAAI,KAAK,CAAA,EAAG;AAEpB,MAAA,OAAO,YAAA;AAAA,IACT;AAEA,IAAA,KAAA,CAAM,GAAA,CAAI,KAAK,CAAA;AAIf,IAAA,GAAA,CAAI,MAAA,IAAU,MAAA,EAAQ;AACpB,MAAA,IAAI;AACF,QAAA,IAAA,CAAK,SAAA,CAAU,KAAK,CAAA;AAAA,MACtB,EAAA,UAAQ;AACN,QAAA,OAAO,kBAAA;AAAA,MACT;AAAA,IACF;AAEA,IAAA,OAAO,MAAA,CAAO,IAAA,CAAK,KAAK,CAAA,CACrB,IAAA,CAAK,CAAA,CACL,MAAA;AAAA,MACC,CAAC,MAAA,EAAiC,GAAA,EAAA,GAAgB;AAChD,QAAA,MAAA,CAAO,GAAG,EAAA,EAAI,KAAA,CAAM,GAAG,CAAA;AACvB,QAAA,OAAO,MAAA;AAAA,MACT,CAAA;AAAA,MACA,CAAC;AAAA,IACH,CAAA;AAAA,EACJ,CAAC,CAAA;AACH;AD5BA;AACA;AACE;AACF,sEAAC","file":"/Users/choksheaklau/src/react-utils/dist/chunk-P2E73RBM.min.cjs","sourcesContent":[null,"/**\n * @packageDocumentation\n *\n * Implements special stringify for use in the shared queries. This will likely\n * not be reusable for your own use cases.\n *\n * Normally you will not need to use this module directly, but if you have a\n * need for it, feel free to use it.\n */\n\n/**\n * JSON stringify a value of any type, and returns an unsafe string. The string\n * is \"unsafe\" because you might not be able to restore the original object\n * using the serialized JSON. This is specifically used for query key generation\n * and is not suitable for more general uses.\n *\n * Note: The given value should not contain any functions because functions\n * cannot be serialized and deserialized properly.\n */\nexport function stringifyDeterministicForKeys(params: unknown): string {\n  const cache = new Set();\n\n  return JSON.stringify(params, (_, value) => {\n    if (typeof value === \"function\") {\n      throw new Error(`Functions should not be passed into query parameters`);\n    }\n\n    if (!value || typeof value !== \"object\" || Array.isArray(value)) {\n      return value;\n    }\n\n    if (cache.has(value)) {\n      // Circular reference detected! Return a placeholder string.\n      return \"[Circular]\";\n    }\n\n    cache.add(value);\n\n    // Don't crash on circular references, but don't mark the top level object\n    // as circular because we want to return as much string as possible.\n    if (value !== params) {\n      try {\n        JSON.stringify(value);\n      } catch {\n        return \"[Unserializable]\";\n      }\n    }\n\n    return Object.keys(value)\n      .sort()\n      .reduce(\n        (result: Record<string, unknown>, key: string) => {\n          result[key] = value[key];\n          return result;\n        },\n        {} as Record<string, unknown>,\n      );\n  });\n}\n"]}

package/chunk-PCGGKBOL.min.js

@@ -0,0 +1,222 @@
+import {
+  getStorageAdapter
+} from "./chunk-4YV72T4D.min.js";
+
+// src/sharedState.ts
+import { MS_PER_DAY } from "@choksheak/ts-utils/timeConstants";
+import { useSyncExternalStore } from "react";
+var SharedStateConfig = {
+  /**
+   * Default duration for storage expiration in milliseconds. Initial value
+   * is 30 days, but can be changed to anything.
+   */
+  storeExpiryMs: 30 * MS_PER_DAY,
+  /**
+   * True to load from storage only on mount, false (default) to load in
+   * the top level scope when the shared state is defined.
+   */
+  lazyLoad: false,
+  /** Default to log to console. */
+  log: (...args) => console.log("[sharedState]", ...args)
+};
+function configureSharedState(config) {
+  Object.assign(SharedStateConfig, config);
+}
+function createPubSubStore() {
+  const dataByKey = /* @__PURE__ */ new Map();
+  const subscribersByKey = /* @__PURE__ */ new Map();
+  function notify(key, next, prev) {
+    const subscribers = subscribersByKey.get(key);
+    if (!subscribers) return;
+    const copy = Array.from(subscribers.values());
+    for (const subscriber of copy) {
+      try {
+        subscriber(next, prev);
+      } catch (e) {
+        console.error(`Error invoking subscriber:`, e);
+      }
+    }
+  }
+  return {
+    // This could be undefined if T includes undefined, else it should never
+    // return undefined because the user has to always specify the default value.
+    get(key) {
+      return dataByKey.get(key);
+    },
+    set(key, value) {
+      const prev = dataByKey.get(key);
+      if (prev === value) return;
+      dataByKey.set(key, value);
+      notify(key, value, prev);
+    },
+    delete(key) {
+      dataByKey.delete(key);
+    },
+    setNoNotify(key, value) {
+      dataByKey.set(key, value);
+    },
+    // Subscribe to changes of a specific key
+    subscribe(key, subscriber) {
+      let subscribers = subscribersByKey.get(key);
+      if (!subscribers) {
+        subscribers = /* @__PURE__ */ new Set();
+        subscribersByKey.set(key, subscribers);
+      }
+      subscribers.add(subscriber);
+      return () => {
+        subscribers.delete(subscriber);
+        if (subscribers.size === 0) subscribersByKey.delete(key);
+      };
+    }
+  };
+}
+function getOrCreatePubSubStore() {
+  if (typeof window !== "undefined") {
+    const t = window.globalThis;
+    return t.reactUtilsPubSubStore || (t.reactUtilsPubSubStore = createPubSubStore());
+  }
+  return createPubSubStore();
+}
+var pubSubStore = getOrCreatePubSubStore();
+var STORAGE_KEY = "state";
+var stateKey = 0;
+function getNextStateKey() {
+  if (typeof window !== "undefined") {
+    const t = window.globalThis;
+    t.reactUtilsStateKey = (t.reactUtilsStateKey ?? 0) + 1;
+    return t.reactUtilsStateKey;
+  }
+  return ++stateKey;
+}
+function sharedState(defaultValue, options) {
+  let readyResolve = () => {
+  };
+  const readyPromise = new Promise((resolve) => {
+    readyResolve = resolve;
+  });
+  const resolveReadyPromise = readyResolve;
+  const log = options?.log || SharedStateConfig.log;
+  const pubSubKey = String(getNextStateKey());
+  if (log && options?.name) {
+    log(`${options.name} -> ${pubSubKey}`);
+  }
+  const storageAdapter = getStorageAdapter(
+    options,
+    SharedStateConfig.storeExpiryMs
+  );
+  pubSubStore.setNoNotify(pubSubKey, defaultValue);
+  const lazyLoad = options?.lazyLoad;
+  const lazy = lazyLoad !== void 0 ? lazyLoad : SharedStateConfig.lazyLoad;
+  function completeInit(stored) {
+    const value = stored !== void 0 ? stored : defaultValue;
+    pubSubStore.set(pubSubKey, value);
+    obj.initDone = true;
+    resolveReadyPromise();
+  }
+  const obj = {
+    name: options?.name,
+    defaultValue,
+    pubSubKey,
+    /** Allow users to await for the completion of data init. */
+    readyPromise,
+    storeExpiryMs: SharedStateConfig.storeExpiryMs,
+    lazy,
+    storageAdapter,
+    initStarted: false,
+    initDone: false,
+    /** `subscribe` function required by useSyncExternalStore. */
+    subscribe(subscriber) {
+      return pubSubStore.subscribe(pubSubKey, () => subscriber());
+    },
+    /** Returns true if there is a backing store. */
+    hasStore() {
+      return Boolean(storageAdapter);
+    },
+    /**
+     * Set a value directly into the store. Does nothing if there is no
+     * backing store.
+     *
+     * Warning: If you want to set the value properly, you should use
+     * `setValue()` instead which also updates the in-memory copy.
+     */
+    setInStore(value) {
+      return storageAdapter?.set(STORAGE_KEY, value);
+    },
+    /**
+     * Get a value directly from the store. Returns undefined if there is no
+     * backing store.
+     */
+    getFromStore() {
+      return storageAdapter?.get(STORAGE_KEY);
+    },
+    /**
+     * Get the value of the shared state.
+     *  `getSnapshot` function — must return same ref if value unchanged.
+     * Note that this would return the default value if data init from store is
+     * not completed yet.
+     */
+    getSnapshot() {
+      return pubSubStore.get(pubSubKey);
+    },
+    /** Set the value of the shared state. */
+    setValue(next) {
+      if (typeof next === "function") {
+        const prev = pubSubStore.get(pubSubKey);
+        next = next(prev);
+      }
+      pubSubStore.set(pubSubKey, next);
+      void obj.setInStore(next);
+    },
+    /**
+     * Remove the value of the shared state. Actually this just sets the value
+     * back to the given default value.
+     */
+    delete() {
+      pubSubStore.set(pubSubKey, defaultValue);
+      return storageAdapter?.set(STORAGE_KEY, defaultValue);
+    },
+    /** Initial default handling. */
+    initDefaultValueOnce() {
+      if (obj.initDone || obj.initStarted) return;
+      obj.initStarted = true;
+      const maybePromise = obj.getFromStore();
+      if (maybePromise instanceof Promise) {
+        return maybePromise.then(completeInit);
+      } else {
+        const stored = maybePromise;
+        completeInit(stored);
+      }
+    }
+  };
+  if (!lazy) {
+    obj.initDefaultValueOnce();
+  }
+  return obj;
+}
+function useSharedState(state) {
+  void state.initDefaultValueOnce();
+  const value = useSyncExternalStore(
+    (onStoreChange) => state.subscribe(onStoreChange),
+    () => state.getSnapshot(),
+    // getServerSnapshot is needed to prevent SSR dev errors in nextjs.
+    () => state.getSnapshot()
+  );
+  return [value, state.setValue];
+}
+function useSharedStateValue(state) {
+  return useSharedState(state)[0];
+}
+function useSharedStateSetter(state) {
+  void state.initDefaultValueOnce();
+  return state.setValue;
+}
+
+export {
+  SharedStateConfig,
+  configureSharedState,
+  sharedState,
+  useSharedState,
+  useSharedStateValue,
+  useSharedStateSetter
+};
+//# sourceMappingURL=chunk-PCGGKBOL.min.js.map

package/chunk-PCGGKBOL.min.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/sharedState.ts"],"sourcesContent":["/**\n * @packageDocumentation\n *\n * The \"shared state\" is a React state that shares the same value across the\n * entire app. Users declare a shared state constant that can be reused across\n * multiple components with the same underlying value.\n *\n * Shared states provide persistence to local storage and/or indexed DB out of\n * the box, by using \"@choksheak/ts-utils\". Note that no matter if the shared\n * state uses persistence or not, it will always maintain a copy of the state\n * in memory. Persisted values can be configured with an automatic expiration\n * duration.\n *\n * This module is largely similar to the open source \"jotai\" npm library. You\n * can use shared states to replace \"jotai\" in your code, and optionally make\n * use of the persistence mechanism. A quick migration guide from jotai is:\n *\n * ```\n *   atom()          -->  sharedState()\n *   useAtom()       -->  useSharedState()\n *   useAtomValue()  -->  useSharedStateValue()\n *   useSetAtom()    -->  useSharedStateSetter()\n * ```\n *\n * Example:\n * ```\n *   import { sharedState, useSharedState } from \"@choksheak/react-utils/sharedState\";\n *\n *   // Create a new shared state in the top level scope.\n *   // The first argument is the default value, which is required.\n *   // The second argument is an options object, and is optional (defaults\n *   // to storing in memory only without any persistence).\n *   const usersState = sharedState(\n *     [], { store: { persistTo: \"indexedDb\", key: \"users\" }}\n *   );\n *\n *   export const UsersComponent: React.FC = () => {\n *     // Get both the value and the setter.\n *     const [users, setUsers] = useSharedState(usersState);\n *     ...\n *   };\n *\n *   export const ReadOnlyComponent: React.FC = () => {\n *     // Get the value only.\n *     const users = useSharedStateValue(usersState);\n *     ...\n *   };\n *\n *   export const WriteOnlyComponent: React.FC = () => {\n *     // Get the setter only.\n *     const setUsers = useSharedStateSetter(usersState);\n *     ...\n *   };\n * ```\n */\n\nimport { MS_PER_DAY } from \"@choksheak/ts-utils/timeConstants\";\nimport { Dispatch, SetStateAction, useSyncExternalStore } from \"react\";\n\nimport { getStorageAdapter, StorageOptions } from \"./storage\";\n\n/************************************************************************/\n/* Global config                                                        */\n/************************************************************************/\n\n/**\n * These values are configurable by the user at any time.\n */\nexport const SharedStateConfig = {\n  /**\n   * Default duration for storage expiration in milliseconds. Initial value\n   * is 30 days, but can be changed to anything.\n   */\n  storeExpiryMs: 30 * MS_PER_DAY,\n\n  /**\n   * True to load from storage only on mount, false (default) to load in\n   * the top level scope when the shared state is defined.\n   */\n  lazyLoad: false,\n\n  /** Default to log to console. */\n  log: (...args: unknown[]) => console.log(\"[sharedState]\", ...args),\n};\n\nexport type SharedStateConfig = typeof SharedStateConfig;\n\n/** Convenience function to update global defaults. */\nexport function configureSharedState(config: Partial<SharedStateConfig>) {\n  Object.assign(SharedStateConfig, config);\n}\n\n/************************************************************************/\n/* Pub-sub store\n/************************************************************************/\n\ntype Subscriber<T> = (next: T, prev: T) => void;\n\nfunction createPubSubStore() {\n  const dataByKey = new Map<string, unknown>();\n  const subscribersByKey = new Map<string, Set<Subscriber<unknown>>>();\n\n  function notify<T>(key: string, next: T, prev: T): void {\n    const subscribers = subscribersByKey.get(key);\n    if (!subscribers) return;\n\n    // Make copy to protect against mutation during iteration.\n    const copy = Array.from(subscribers.values());\n    for (const subscriber of copy) {\n      try {\n        subscriber(next, prev);\n      } catch (e) {\n        console.error(`Error invoking subscriber:`, e);\n      }\n    }\n  }\n\n  return {\n    // This could be undefined if T includes undefined, else it should never\n    // return undefined because the user has to always specify the default value.\n    get<T>(key: string): T {\n      return dataByKey.get(key) as T;\n    },\n\n    set<T>(key: string, value: T): void {\n      const prev = dataByKey.get(key) as T;\n\n      // Do nothing if no change.\n      if (prev === value) return;\n\n      dataByKey.set(key, value);\n      notify(key, value, prev);\n    },\n\n    delete(key: string): void {\n      dataByKey.delete(key);\n    },\n\n    setNoNotify<T>(key: string, value: T): void {\n      dataByKey.set(key, value);\n    },\n\n    // Subscribe to changes of a specific key\n    subscribe<T>(key: string, subscriber: Subscriber<T>): () => void {\n      let subscribers = subscribersByKey.get(key);\n      if (!subscribers) {\n        subscribers = new Set();\n        subscribersByKey.set(key, subscribers);\n      }\n\n      // Type coercion: we store Subscriber<unknown>\n      subscribers.add(subscriber as Subscriber<unknown>);\n\n      // Return unsubscribe function\n      return () => {\n        subscribers.delete(subscriber as Subscriber<unknown>);\n        if (subscribers.size === 0) subscribersByKey.delete(key);\n      };\n    },\n  } as const;\n}\n\n/**\n * Ensure we always use the same store. If we create two stores, then the\n * reactive updates will fail.\n */\nfunction getOrCreatePubSubStore() {\n  if (typeof window !== \"undefined\") {\n    const t = window.globalThis as {\n      reactUtilsPubSubStore?: ReturnType<typeof createPubSubStore>;\n    };\n    return (\n      t.reactUtilsPubSubStore || (t.reactUtilsPubSubStore = createPubSubStore())\n    );\n  }\n  return createPubSubStore();\n}\n\nconst pubSubStore = getOrCreatePubSubStore();\n\n/************************************************************************/\n/* Shared state implementation                                          */\n/************************************************************************/\n\nconst STORAGE_KEY = \"state\";\n\n/** Options to configure a shared state. */\nexport type SharedStateOptions<T> = {\n  /** Load from store only on first use of useSharedState(). */\n  lazyLoad?: boolean;\n  /** Used for debug logging. */\n  name?: string;\n  /** Customize the logger. */\n  log?: (...args: unknown[]) => void;\n} & StorageOptions<T>;\n\nlet stateKey = 0;\n\n// Try to make this safe across hot reloads and bundling.\nfunction getNextStateKey() {\n  if (typeof window !== \"undefined\") {\n    const t = window.globalThis as { reactUtilsStateKey?: number };\n    t.reactUtilsStateKey = (t.reactUtilsStateKey ?? 0) + 1;\n    return t.reactUtilsStateKey;\n  }\n  return ++stateKey;\n}\n\n/**\n * Create a new shared state object. Put this code at the top level scope:\n *\n * Example:\n * ```\n *   const counterState = sharedState<number>(0);\n * ```\n */\nexport function sharedState<T>(\n  defaultValue: T,\n  options?: SharedStateOptions<T>,\n) {\n  let readyResolve: () => void = () => {};\n\n  const readyPromise = new Promise<void>((resolve) => {\n    readyResolve = resolve;\n  });\n\n  const resolveReadyPromise = readyResolve;\n\n  const log = options?.log || SharedStateConfig.log;\n\n  // We'll make a new key with each hot reload, but that's ok.\n  const pubSubKey = String(getNextStateKey());\n\n  if (log && options?.name) {\n    log(`${options.name} -> ${pubSubKey}`);\n  }\n\n  // Use max of 1 storage adapter per shared state.\n  const storageAdapter = getStorageAdapter(\n    options,\n    SharedStateConfig.storeExpiryMs,\n  );\n\n  // Always set the default value first to avoid returning undefineds if that\n  // is not part of T. Don't notify with the default value.\n  pubSubStore.setNoNotify(pubSubKey, defaultValue);\n\n  const lazyLoad = options?.lazyLoad;\n  const lazy = lazyLoad !== undefined ? lazyLoad : SharedStateConfig.lazyLoad;\n\n  function completeInit(stored: T | undefined) {\n    const value = stored !== undefined ? stored : defaultValue;\n\n    pubSubStore.set(pubSubKey, value);\n\n    // @ts-expect-error ts(2540) - Assign to readonly property.\n    obj.initDone = true;\n    resolveReadyPromise();\n  }\n\n  const obj = {\n    name: options?.name,\n    defaultValue,\n    pubSubKey,\n\n    /** Allow users to await for the completion of data init. */\n    readyPromise,\n\n    storeExpiryMs: SharedStateConfig.storeExpiryMs,\n    lazy,\n    storageAdapter,\n\n    initStarted: false,\n    initDone: false,\n\n    /** `subscribe` function required by useSyncExternalStore. */\n    subscribe(subscriber: () => void): () => void {\n      return pubSubStore.subscribe(pubSubKey, () => subscriber());\n    },\n\n    /** Returns true if there is a backing store. */\n    hasStore(): boolean {\n      return Boolean(storageAdapter);\n    },\n\n    /**\n     * Set a value directly into the store. Does nothing if there is no\n     * backing store.\n     *\n     * Warning: If you want to set the value properly, you should use\n     * `setValue()` instead which also updates the in-memory copy.\n     */\n    setInStore(value: T): Promise<void> | void {\n      return storageAdapter?.set(STORAGE_KEY, value);\n    },\n\n    /**\n     * Get a value directly from the store. Returns undefined if there is no\n     * backing store.\n     */\n    getFromStore(): Promise<T | undefined> | T | undefined {\n      return storageAdapter?.get(STORAGE_KEY);\n    },\n\n    /**\n     * Get the value of the shared state.\n     *  `getSnapshot` function — must return same ref if value unchanged.\n     * Note that this would return the default value if data init from store is\n     * not completed yet.\n     */\n    getSnapshot(): T {\n      return pubSubStore.get(pubSubKey);\n    },\n\n    /** Set the value of the shared state. */\n    setValue(next: SetStateAction<T>): void {\n      if (typeof next === \"function\") {\n        const prev = pubSubStore.get<T>(pubSubKey);\n        next = (next as (p: T) => T)(prev);\n      }\n\n      pubSubStore.set(pubSubKey, next);\n      void obj.setInStore(next);\n    },\n\n    /**\n     * Remove the value of the shared state. Actually this just sets the value\n     * back to the given default value.\n     */\n    delete(): Promise<void> | void {\n      pubSubStore.set(pubSubKey, defaultValue);\n      return storageAdapter?.set(STORAGE_KEY, defaultValue);\n    },\n\n    /** Initial default handling. */\n    initDefaultValueOnce(): Promise<void> | void {\n      if (obj.initDone || obj.initStarted) return;\n      // @ts-expect-error ts(2540) - Assign to readonly property.\n      obj.initStarted = true;\n\n      const maybePromise = obj.getFromStore();\n\n      // Allow sync vs async code paths. This allows init to be fully completed\n      // from store before the sharedState() function returns.\n      if (maybePromise instanceof Promise) {\n        return maybePromise.then(completeInit);\n      } else {\n        const stored = maybePromise;\n        completeInit(stored);\n      }\n    },\n  } as const;\n\n  if (!lazy) {\n    obj.initDefaultValueOnce();\n  }\n\n  return obj;\n}\n\nexport type SharedState<T> = ReturnType<typeof sharedState<T>>;\n\n/**\n * React hook for subscribing to a key in the global store.\n *\n * Example:\n * ```\n *   const [counter, setCounter] = useSharedState(counterState);\n * ```\n */\nexport function useSharedState<T>(\n  state: SharedState<T>,\n): [T, Dispatch<SetStateAction<T>>] {\n  void state.initDefaultValueOnce();\n\n  const value = useSyncExternalStore(\n    (onStoreChange) => state.subscribe(onStoreChange),\n    () => state.getSnapshot(),\n    // getServerSnapshot is needed to prevent SSR dev errors in nextjs.\n    () => state.getSnapshot(),\n  );\n\n  return [value, state.setValue];\n}\n\n/**\n * Same as useSharedState(), but returns the value only.\n *\n * Example:\n * ```\n *   const counter = useSharedStateValue(counterState);\n * ```\n */\nexport function useSharedStateValue<T>(state: SharedState<T>) {\n  return useSharedState(state)[0];\n}\n\n/**\n * Same as useSharedState(), but returns the setter only.\n *\n * Example:\n * ```\n *   const setCounter = useSharedStateSetter(counterState);\n * ```\n */\nexport function useSharedStateSetter<T>(state: SharedState<T>) {\n  void state.initDefaultValueOnce();\n\n  return state.setValue;\n}\n"],"mappings":"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","names":[]}

package/chunk-PHITDXZT.min.js

@@ -0,0 +1,36 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJS = (cb, mod) => function __require() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+export {
+  __commonJS,
+  __export,
+  __toESM
+};
+//# sourceMappingURL=chunk-PHITDXZT.min.js.map

package/chunk-PHITDXZT.min.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}