@take-out/helpers 0.0.32 → 0.0.33

package/src/storage/createStorage.ts

@@ -0,0 +1,141 @@
+import { getStorageDriver } from './driver'
+
+const namespaces = new Set<string>()
+
+/**
+ * namespaced storage interface with JSON serialization
+ * @template K - key type (string literal union for type-safe keys)
+ * @template V - value type (automatically JSON serialized/deserialized)
+ */
+export interface Storage<K extends string = string, V = unknown> {
+  /** get a JSON-parsed value by key */
+  get(key: K): V | undefined
+  /** set a value (JSON serialized) */
+  set(key: K, value: V): void
+  /** remove a key */
+  remove(key: K): void
+  /** check if key exists */
+  has(key: K): boolean
+  /** get all keys in this namespace */
+  keys(): K[]
+  /** remove all keys in this namespace */
+  clear(): void
+  /** get raw string value (no JSON parsing) - localStorage compatible */
+  getItem(key: K): string | null
+  /** set raw string value (no JSON serialization) - localStorage compatible */
+  setItem(key: K, value: string): void
+}
+
+/**
+ * create a namespaced storage instance
+ * @param namespace - unique prefix for all keys (throws if already used)
+ * @returns storage instance with get/set (JSON) and getItem/setItem (raw) methods
+ * @example
+ * const store = createStorage<'token' | 'user', string>('auth')
+ * store.set('token', 'abc123')
+ * store.get('token') // 'abc123'
+ */
+export function createStorage<K extends string, V>(namespace: string): Storage<K, V> {
+  if (namespaces.has(namespace)) {
+    throw new Error(`storage namespace already exists: ${namespace}`)
+  }
+  namespaces.add(namespace)
+
+  const prefix = `${namespace}:`
+  const prefixKey = (key: string) => `${prefix}${key}`
+
+  return {
+    get(key: K): V | undefined {
+      const driver = getStorageDriver()
+      if (!driver) return undefined
+      const raw = driver.getItem(prefixKey(key))
+      if (raw == null) return undefined
+      try {
+        return JSON.parse(raw)
+      } catch {
+        return undefined
+      }
+    },
+
+    set(key: K, value: V): void {
+      const driver = getStorageDriver()
+      if (!driver) return
+      driver.setItem(prefixKey(key), JSON.stringify(value))
+    },
+
+    remove(key: K): void {
+      const driver = getStorageDriver()
+      if (!driver) return
+      driver.removeItem(prefixKey(key))
+    },
+
+    has(key: K): boolean {
+      const driver = getStorageDriver()
+      if (!driver) return false
+      return driver.getItem(prefixKey(key)) != null
+    },
+
+    keys(): K[] {
+      const driver = getStorageDriver()
+      if (!driver) return []
+      return driver
+        .getAllKeys()
+        .filter((k) => k.startsWith(prefix))
+        .map((k) => k.slice(prefix.length) as K)
+    },
+
+    clear(): void {
+      const driver = getStorageDriver()
+      if (!driver) return
+      for (const key of this.keys()) {
+        driver.removeItem(prefixKey(key))
+      }
+    },
+
+    getItem(key: K): string | null {
+      const driver = getStorageDriver()
+      if (!driver) return null
+      return driver.getItem(prefixKey(key)) ?? null
+    },
+
+    setItem(key: K, value: string): void {
+      const driver = getStorageDriver()
+      if (!driver) return
+      driver.setItem(prefixKey(key), value)
+    },
+  }
+}
+
+/**
+ * single-value storage interface
+ * @template T - value type (automatically JSON serialized/deserialized)
+ */
+export interface StorageValue<T> {
+  /** get the stored value */
+  get(): T | undefined
+  /** set the value */
+  set(value: T): void
+  /** remove the value */
+  remove(): void
+  /** check if value exists */
+  has(): boolean
+}
+
+/**
+ * create a single-value storage (wrapper around createStorage)
+ * @param key - unique storage key
+ * @returns storage value instance
+ * @example
+ * const token = createStorageValue<string>('auth-token')
+ * token.set('abc123')
+ * token.get() // 'abc123'
+ */
+export function createStorageValue<T>(key: string): StorageValue<T> {
+  const storage = createStorage<'value', T>(`_v:${key}`)
+  return {
+    get: (): T | undefined => storage.get('value'),
+    set: (value: T): void => storage.set('value', value),
+    remove: (): void => storage.remove('value'),
+    has: (): boolean => storage.has('value'),
+  }
+}

package/src/storage/driver.ts

@@ -0,0 +1,20 @@
+import type { StorageDriver } from './types'
+
+let driver: StorageDriver | null = null
+
+export function setStorageDriver(d: StorageDriver): void {
+  driver = d
+}
+
+export function getStorageDriver(): StorageDriver | null {
+  if (driver) return driver
+  if (typeof localStorage !== 'undefined') {
+    return {
+      getItem: (key) => localStorage.getItem(key),
+      setItem: (key, value) => localStorage.setItem(key, value),
+      removeItem: (key) => localStorage.removeItem(key),
+      getAllKeys: () => Object.keys(localStorage),
+    }
+  }
+  return null
+}

package/src/storage/index.ts

@@ -0,0 +1,4 @@
+export { createStorage, createStorageValue } from './createStorage'
+export type { Storage, StorageValue } from './createStorage'
+export { getStorageDriver, setStorageDriver } from './driver'
+export type { StorageDriver } from './types'

package/src/storage/types.ts

@@ -0,0 +1,6 @@
+export interface StorageDriver {
+  getItem(key: string): string | null | undefined
+  setItem(key: string, value: string): void
+  removeItem(key: string): void
+  getAllKeys(): string[]
+}

package/types/async/asyncContext.d.ts.map

@@ -8,7 +8,7 @@
     "src/async/asyncContext.ts"
   ],
   "sourcesContent": [
-    "interface AsyncContext<T> {\n  get(): T | undefined\n  run<R>(value: T, fn: () => R | Promise<R>): Promise<R>\n}\n\ninterface NodeAsyncLocalStorage<T> {\n  getStore(): T | undefined\n  run<R>(store: T, callback: () => R): R\n}\n\ninterface AsyncLocalStorageConstructor {\n  new <T>(): NodeAsyncLocalStorage<T>\n}\n\nlet nodeAsyncLocalStorageCache: AsyncLocalStorageConstructor | null = null\n\nasync function getNodeAsyncLocalStorage(): Promise<AsyncLocalStorageConstructor | null> {\n  if (!nodeAsyncLocalStorageCache) {\n    try {\n      const module = await import('node:async_hooks')\n      nodeAsyncLocalStorageCache =\n        module.AsyncLocalStorage as AsyncLocalStorageConstructor\n    } catch {\n      return null\n    }\n  }\n  return nodeAsyncLocalStorageCache\n}\n\nexport function createAsyncContext<T>(): AsyncContext<T> {\n  if (process.env.VITE_ENVIRONMENT === 'ssr') {\n    let storage: NodeAsyncLocalStorage<T> | null = null\n\n    getNodeAsyncLocalStorage().then((AsyncLocalStorage) => {\n      if (AsyncLocalStorage && !storage) {\n        storage = new AsyncLocalStorage<T>()\n      }\n    })\n\n    return {\n      get(): T | undefined {\n        if (!storage) {\n          console.warn(`⚠️ called AsyncContext before load!`)\n          return\n        }\n\n        return storage.getStore()\n      },\n\n      async run<R>(value: T, fn: () => R | Promise<R>): Promise<R> {\n        if (!storage) {\n          throw new Error(`⚠️ called AsyncContext before load!`)\n        }\n        return storage.run(value, fn)\n      },\n    }\n  } else {\n    // browser implementation using promise patching\n    return createBrowserAsyncContext<T>()\n  }\n}\n\nfunction createBrowserAsyncContext<T>(): AsyncContext<T> {\n  let currentContext: T | undefined\n  const contextStack: (T | undefined)[] = []\n\n  return {\n    get(): T | undefined {\n      return currentContext\n    },\n    async run<R>(value: T, fn: () => R | Promise<R>): Promise<R> {\n      const prevContext = currentContext\n      currentContext = value\n      contextStack.push(prevContext)\n\n      // store original Promise methods\n      const OriginalPromise = Promise\n      const OriginalThen = OriginalPromise.prototype.then\n      const OriginalCatch = OriginalPromise.prototype.catch\n      const OriginalFinally = OriginalPromise.prototype.finally\n\n      function wrapCallback(\n        callback: Function | undefined | null,\n        context: T | undefined\n      ): Function | undefined | null {\n        if (!callback) return callback\n        return (...args: any[]) => {\n          const prevContext = currentContext\n          currentContext = context\n          try {\n            return callback(...args)\n          } finally {\n            currentContext = prevContext\n          }\n        }\n      }\n\n      // patch Promise methods to capture and restore context\n      // biome-ignore lint/suspicious/noThenProperty: intentional patching for context propagation\n      OriginalPromise.prototype.then = function (\n        this: Promise<any>,\n        onFulfilled?: any,\n        onRejected?: any\n      ): Promise<any> {\n        const context = currentContext\n        return OriginalThen.call(\n          this,\n          wrapCallback(onFulfilled, context) as any,\n          wrapCallback(onRejected, context) as any\n        )\n      }\n\n      OriginalPromise.prototype.catch = function (\n        this: Promise<any>,\n        onRejected?: any\n      ): Promise<any> {\n        const context = currentContext\n        return OriginalCatch.call(this, wrapCallback(onRejected, context) as any)\n      }\n\n      OriginalPromise.prototype.finally = function (\n        this: Promise<any>,\n        onFinally?: any\n      ): Promise<any> {\n        const context = currentContext\n        return OriginalFinally.call(this, wrapCallback(onFinally, context) as any)\n      }\n\n      try {\n        const result = await fn()\n        return result\n      } finally {\n        // restore original Promise methods\n        // biome-ignore lint/suspicious/noThenProperty: restoring original methods\n        OriginalPromise.prototype.then = OriginalThen\n        OriginalPromise.prototype.catch = OriginalCatch\n        OriginalPromise.prototype.finally = OriginalFinally\n\n        contextStack.pop()\n        currentContext = prevContext\n      }\n    },\n  }\n}\n"
+    "interface AsyncContext<T> {\n  get(): T | undefined\n  run<R>(value: T, fn: () => R | Promise<R>): Promise<R>\n}\n\ninterface NodeAsyncLocalStorage<T> {\n  getStore(): T | undefined\n  run<R>(store: T, callback: () => R): R\n}\n\ninterface AsyncLocalStorageConstructor {\n  new <T>(): NodeAsyncLocalStorage<T>\n}\n\nlet nodeAsyncLocalStorageCache: AsyncLocalStorageConstructor | null = null\n\nasync function getNodeAsyncLocalStorage(): Promise<AsyncLocalStorageConstructor | null> {\n  if (!nodeAsyncLocalStorageCache) {\n    try {\n      const module = await import('node:async_hooks')\n      nodeAsyncLocalStorageCache =\n        module.AsyncLocalStorage as AsyncLocalStorageConstructor\n    } catch {\n      return null\n    }\n  }\n  return nodeAsyncLocalStorageCache\n}\n\nexport function createAsyncContext<T>(): AsyncContext<T> {\n  if (process.env.VITE_ENVIRONMENT === 'ssr') {\n    let storage: NodeAsyncLocalStorage<T> | null = null\n\n    getNodeAsyncLocalStorage().then((AsyncLocalStorage) => {\n      if (AsyncLocalStorage && !storage) {\n        storage = new AsyncLocalStorage<T>()\n      }\n    })\n\n    return {\n      get(): T | undefined {\n        if (!storage) {\n          console.warn(`⚠️ called AsyncContext before load!`)\n          return\n        }\n\n        return storage.getStore()\n      },\n\n      async run<R>(value: T, fn: () => R | Promise<R>): Promise<R> {\n        if (!storage) {\n          throw new Error(`⚠️ called AsyncContext before load!`)\n        }\n        return storage.run(value, fn)\n      },\n    }\n  } else {\n    // browser implementation using promise patching\n    return createBrowserAsyncContext<T>()\n  }\n}\n\nfunction createBrowserAsyncContext<T>(): AsyncContext<T> {\n  let currentContext: T | undefined\n  const contextStack: (T | undefined)[] = []\n\n  return {\n    get(): T | undefined {\n      return currentContext\n    },\n    async run<R>(value: T, fn: () => R | Promise<R>): Promise<R> {\n      const prevContext = currentContext\n      currentContext = value\n      contextStack.push(prevContext)\n\n      // store original Promise methods\n      const OriginalPromise = Promise\n      const OriginalThen = OriginalPromise.prototype.then\n      const OriginalCatch = OriginalPromise.prototype.catch\n      const OriginalFinally = OriginalPromise.prototype.finally\n\n      function wrapCallback(\n        callback: Function | undefined | null,\n        context: T | undefined\n      ): Function | undefined | null {\n        if (!callback) return callback\n        return (...args: any[]) => {\n          const prevContext = currentContext\n          currentContext = context\n          try {\n            return callback(...args)\n          } finally {\n            currentContext = prevContext\n          }\n        }\n      }\n\n      // patch Promise methods to capture and restore context\n      // eslint-disable-next-line no-then-property -- intentional patching for context propagation\n      OriginalPromise.prototype.then = function (\n        this: Promise<any>,\n        onFulfilled?: any,\n        onRejected?: any\n      ): Promise<any> {\n        const context = currentContext\n        return OriginalThen.call(\n          this,\n          wrapCallback(onFulfilled, context) as any,\n          wrapCallback(onRejected, context) as any\n        )\n      }\n\n      OriginalPromise.prototype.catch = function (\n        this: Promise<any>,\n        onRejected?: any\n      ): Promise<any> {\n        const context = currentContext\n        return OriginalCatch.call(this, wrapCallback(onRejected, context) as any)\n      }\n\n      OriginalPromise.prototype.finally = function (\n        this: Promise<any>,\n        onFinally?: any\n      ): Promise<any> {\n        const context = currentContext\n        return OriginalFinally.call(this, wrapCallback(onFinally, context) as any)\n      }\n\n      try {\n        const result = await fn()\n        return result\n      } finally {\n        // restore original Promise methods\n        // eslint-disable-next-line no-then-property -- restoring original methods\n        OriginalPromise.prototype.then = OriginalThen\n        OriginalPromise.prototype.catch = OriginalCatch\n        OriginalPromise.prototype.finally = OriginalFinally\n\n        contextStack.pop()\n        currentContext = prevContext\n      }\n    },\n  }\n}\n"
   ],
   "version": 3
 }

package/types/async/useAsync.d.ts.map

@@ -8,7 +8,7 @@
     "src/async/useAsync.ts"
   ],
   "sourcesContent": [
-    "import { useState, useEffect } from 'react'\n\nexport function useAsync<T>(\n  promiseFn: () => Promise<T>,\n  args: any[]\n): [T, 'loading' | 'idle' | 'error', Error | null] {\n  const [data, setData] = useState<T | null>(null)\n  const [error, setError] = useState<Error | null>(null)\n  const [loading, setLoading] = useState<boolean>(true)\n\n  useEffect(() => {\n    let isMounted = true\n\n    const fetchData = async () => {\n      try {\n        const result = await promiseFn()\n        if (isMounted) {\n          setData(result)\n          setLoading(false)\n        }\n      } catch (err) {\n        if (isMounted) {\n          setError(err as Error)\n          setLoading(false)\n        }\n      }\n    }\n\n    fetchData()\n\n    return () => {\n      isMounted = false\n    }\n    // biome-ignore lint/correctness/useExhaustiveDependencies: ignore\n  }, args)\n\n  return [data as T, error ? 'error' : loading ? 'loading' : 'idle', error]\n}\n"
+    "import { useState, useEffect } from 'react'\n\nexport function useAsync<T>(\n  promiseFn: () => Promise<T>,\n  args: any[]\n): [T, 'loading' | 'idle' | 'error', Error | null] {\n  const [data, setData] = useState<T | null>(null)\n  const [error, setError] = useState<Error | null>(null)\n  const [loading, setLoading] = useState<boolean>(true)\n\n  useEffect(() => {\n    let isMounted = true\n\n    const fetchData = async () => {\n      try {\n        const result = await promiseFn()\n        if (isMounted) {\n          setData(result)\n          setLoading(false)\n        }\n      } catch (err) {\n        if (isMounted) {\n          setError(err as Error)\n          setLoading(false)\n        }\n      }\n    }\n\n    fetchData()\n\n    return () => {\n      isMounted = false\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, args)\n\n  return [data as T, error ? 'error' : loading ? 'loading' : 'idle', error]\n}\n"
   ],
   "version": 3
 }

package/types/async/useAsyncEffect.d.ts.map

@@ -1,5 +1,5 @@
 {
-  "mappings": "KAMK;KAEA,uBACHA,QAAQ,aACR,GAAG,gBACA,QAAQ;KAER,qBAAqB;CACxB;CACA;CACA;AACD;AAED,OAAO,iBAAS,eACdC,IAAI,qBACJC,cACAC,UAAU;AAKZ,OAAO,iBAAS,qBACdF,IAAI,qBACJC,cACAC,UAAU",
+  "mappings": "KAOK;KAEA,uBACHA,QAAQ,aACR,GAAG,gBACA,QAAQ;KAER,qBAAqB;CACxB;CACA;CACA;AACD;AAED,OAAO,iBAAS,eACdC,IAAI,qBACJC,cACAC,UAAU;AAKZ,OAAO,iBAAS,qBACdF,IAAI,qBACJC,cACAC,UAAU",
   "names": [
     "signal: AbortSignal",
     "cb: AsyncEffectCallback",
@@ -10,7 +10,7 @@
     "src/async/useAsyncEffect.ts"
   ],
   "sourcesContent": [
-    "// adopted from https://github.com/franciscop/use-async/blob/master/src/index.js\n\nimport { useEffect, useId, useLayoutEffect } from 'react'\nimport { EMPTY_OBJECT } from '../constants'\nimport { handleAbortError } from './abortable'\n\ntype Cleanup = () => void\n\ntype AsyncEffectCallback = (\n  signal: AbortSignal,\n  ...deps: any[]\n) => Promise<Cleanup | void> | void\n\ntype AsyncEffectOptions = {\n  circuitBreakAfter?: number\n  circuitBreakPeriod?: number\n  debug?: boolean\n}\n\nexport function useAsyncEffect(\n  cb: AsyncEffectCallback,\n  deps: any[] = [],\n  options?: AsyncEffectOptions\n): void {\n  useAsyncEffectImpl(false, cb, deps, options)\n}\n\nexport function useAsyncLayoutEffect(\n  cb: AsyncEffectCallback,\n  deps: any[] = [],\n  options?: AsyncEffectOptions\n): void {\n  useAsyncEffectImpl(true, cb, deps, options)\n}\n\nfunction useAsyncEffectImpl(\n  isLayoutEffect: boolean,\n  cb: AsyncEffectCallback,\n  deps: any[] = [],\n  options: AsyncEffectOptions = EMPTY_OBJECT\n): void {\n  const effectHook = isLayoutEffect ? useLayoutEffect : useEffect\n  // biome-ignore lint/correctness/useHookAtTopLevel: ignore\n  const effectId = process.env.NODE_ENV === 'development' ? useId() : ''\n\n  effectHook(() => {\n    // Generate a unique ID for this effect instance for loop detection\n    checkEffectLoop(effectId, options.circuitBreakAfter, options.circuitBreakPeriod)\n    const controller = new AbortController()\n    const signal = controller.signal\n\n    // wrap in try in case its not async (for simple use cases)\n    try {\n      const value = cb(signal, ...deps)\n\n      Promise.resolve(value)\n        .then(async (res) => {\n          if (res && typeof res === 'function') {\n            if (signal.aborted) return res()\n            signal.addEventListener('abort', res)\n          }\n        })\n        .catch(handleAbortError)\n    } catch (error) {\n      handleAbortError(error, options.debug)\n    }\n\n    return () => {\n      if (signal.aborted) return\n      controller.abort()\n    }\n  }, deps)\n}\n\n// loop detection in dev mode\nlet effectRunCounts: Map<string, number[]>\nlet checkEffectLoop: (\n  effectId: string,\n  circuitBreakAfter?: number,\n  circuitBreakPeriod?: number\n) => void\n\nif (process.env.NODE_ENV === 'development') {\n  effectRunCounts = new Map<string, number[]>()\n\n  checkEffectLoop = (\n    effectId: string,\n    circuitBreakAfter: number = 20,\n    circuitBreakPeriod: number = 1000\n  ) => {\n    const now = Date.now()\n    const runs = effectRunCounts.get(effectId) || []\n\n    runs.push(now)\n\n    // keep only runs from the specified period\n    const recentRuns = runs.filter((time) => now - time < circuitBreakPeriod)\n    effectRunCounts.set(effectId, recentRuns)\n\n    const runCount = recentRuns.length\n\n    if (runCount > circuitBreakAfter) {\n      const message = `🚨 useAsyncEffect infinite loop detected! Effect ran ${runCount} times in <${circuitBreakPeriod}ms`\n      if (process.env.NODE_ENV === 'development') {\n        console.error(message)\n        // biome-ignore lint/suspicious/noDebugger: ignore\n        debugger\n      } else {\n        alert(message)\n        throw new Error(message)\n      }\n    } else if (runCount > circuitBreakAfter / 2) {\n      console.warn(\n        `⚠️ useAsyncEffect potential loop: Effect ran ${runCount} times in <${circuitBreakPeriod}ms`\n      )\n    }\n  }\n} else {\n  checkEffectLoop = () => {}\n}\n"
+    "// adopted from https://github.com/franciscop/use-async/blob/master/src/index.js\n\nimport { useEffect, useId, useLayoutEffect } from 'react'\n\nimport { EMPTY_OBJECT } from '../constants'\nimport { handleAbortError } from './abortable'\n\ntype Cleanup = () => void\n\ntype AsyncEffectCallback = (\n  signal: AbortSignal,\n  ...deps: any[]\n) => Promise<Cleanup | void> | void\n\ntype AsyncEffectOptions = {\n  circuitBreakAfter?: number\n  circuitBreakPeriod?: number\n  debug?: boolean\n}\n\nexport function useAsyncEffect(\n  cb: AsyncEffectCallback,\n  deps: any[] = [],\n  options?: AsyncEffectOptions\n): void {\n  useAsyncEffectImpl(false, cb, deps, options)\n}\n\nexport function useAsyncLayoutEffect(\n  cb: AsyncEffectCallback,\n  deps: any[] = [],\n  options?: AsyncEffectOptions\n): void {\n  useAsyncEffectImpl(true, cb, deps, options)\n}\n\nfunction useAsyncEffectImpl(\n  isLayoutEffect: boolean,\n  cb: AsyncEffectCallback,\n  deps: any[] = [],\n  options: AsyncEffectOptions = EMPTY_OBJECT\n): void {\n  const effectHook = isLayoutEffect ? useLayoutEffect : useEffect\n  // eslint-disable-next-line react-hooks/rules-of-hooks\n  const effectId = process.env.NODE_ENV === 'development' ? useId() : ''\n\n  effectHook(() => {\n    // Generate a unique ID for this effect instance for loop detection\n    checkEffectLoop(effectId, options.circuitBreakAfter, options.circuitBreakPeriod)\n    const controller = new AbortController()\n    const signal = controller.signal\n\n    // wrap in try in case its not async (for simple use cases)\n    try {\n      const value = cb(signal, ...deps)\n\n      Promise.resolve(value)\n        .then(async (res) => {\n          if (res && typeof res === 'function') {\n            if (signal.aborted) return res()\n            signal.addEventListener('abort', res)\n          }\n        })\n        .catch(handleAbortError)\n    } catch (error) {\n      handleAbortError(error, options.debug)\n    }\n\n    return () => {\n      if (signal.aborted) return\n      controller.abort()\n    }\n  }, deps)\n}\n\n// loop detection in dev mode\nlet effectRunCounts: Map<string, number[]>\nlet checkEffectLoop: (\n  effectId: string,\n  circuitBreakAfter?: number,\n  circuitBreakPeriod?: number\n) => void\n\nif (process.env.NODE_ENV === 'development') {\n  effectRunCounts = new Map<string, number[]>()\n\n  checkEffectLoop = (\n    effectId: string,\n    circuitBreakAfter: number = 20,\n    circuitBreakPeriod: number = 1000\n  ) => {\n    const now = Date.now()\n    const runs = effectRunCounts.get(effectId) || []\n\n    runs.push(now)\n\n    // keep only runs from the specified period\n    const recentRuns = runs.filter((time) => now - time < circuitBreakPeriod)\n    effectRunCounts.set(effectId, recentRuns)\n\n    const runCount = recentRuns.length\n\n    if (runCount > circuitBreakAfter) {\n      const message = `🚨 useAsyncEffect infinite loop detected! Effect ran ${runCount} times in <${circuitBreakPeriod}ms`\n      if (process.env.NODE_ENV === 'development') {\n        console.error(message)\n        // eslint-disable-next-line no-debugger\n        debugger\n      } else {\n        alert(message)\n        throw new Error(message)\n      }\n    } else if (runCount > circuitBreakAfter / 2) {\n      console.warn(\n        `⚠️ useAsyncEffect potential loop: Effect ran ${runCount} times in <${circuitBreakPeriod}ms`\n      )\n    }\n  }\n} else {\n  checkEffectLoop = () => {}\n}\n"
   ],
   "version": 3
 }

package/types/async/useLazyMount.d.ts

@@ -1,5 +1,5 @@
-import type React from "react";
 import { type IdleOptions } from "./idle";
+import type React from "react";
 export type LazyMountProps = IdleOptions;
 export declare const useLazyMount: (props?: LazyMountProps) => boolean;
 export declare const LazyMount: ({ children,...idleProps }: LazyMountProps & {

package/types/async/useLazyMount.d.ts.map

@@ -1,5 +1,5 @@
 {
-  "mappings": "AAAA,YAAY,WAAW,OAAO;AAE9B,cAAoB,mBAAmB,QAAQ;AAG/C,YAAY,iBAAiB;AAE7B,OAAO,cAAM,eAAgBA,QAAO;AAkBpC,OAAO,cAAM,YAAa,EACxB,SACA,GAAG,WACgC,EAAlC,iBAAiB;CAAE;AAAe,MAAG,MAAM",
+  "mappings": "AAEA,cAAoB,mBAAmB,QAAQ;AAG/C,YAAY,WAAW,OAAO;AAE9B,YAAY,iBAAiB;AAE7B,OAAO,cAAM,eAAgBA,QAAO;AAkBpC,OAAO,cAAM,YAAa,EACxB,SACA,GAAG,WACgC,EAAlC,iBAAiB;CAAE;AAAe,MAAG,MAAM",
   "names": [
     "props: LazyMountProps"
   ],
@@ -7,7 +7,7 @@
     "src/async/useLazyMount.ts"
   ],
   "sourcesContent": [
-    "import type React from 'react'\nimport { startTransition, useState } from 'react'\nimport { idle, type IdleOptions } from './idle'\nimport { useAsyncEffect } from './useAsyncEffect'\n\nexport type LazyMountProps = IdleOptions\n\nexport const useLazyMount = (props: LazyMountProps = { max: 100 }): boolean => {\n  const [mounted, setMounted] = useState(false)\n\n  useAsyncEffect(\n    async (signal) => {\n      await idle(props, signal)\n      startTransition(() => {\n        setMounted(true)\n      })\n    },\n    [\n      // no need for deps it only ever mounts once\n    ]\n  )\n\n  return mounted\n}\n\nexport const LazyMount = ({\n  children,\n  ...idleProps\n}: LazyMountProps & { children: any }): React.ReactNode => {\n  const mounted = useLazyMount(idleProps)\n  return mounted ? children : null\n}\n"
+    "import { startTransition, useState } from 'react'\n\nimport { idle, type IdleOptions } from './idle'\nimport { useAsyncEffect } from './useAsyncEffect'\n\nimport type React from 'react'\n\nexport type LazyMountProps = IdleOptions\n\nexport const useLazyMount = (props: LazyMountProps = { max: 100 }): boolean => {\n  const [mounted, setMounted] = useState(false)\n\n  useAsyncEffect(\n    async (signal) => {\n      await idle(props, signal)\n      startTransition(() => {\n        setMounted(true)\n      })\n    },\n    [\n      // no need for deps it only ever mounts once\n    ]\n  )\n\n  return mounted\n}\n\nexport const LazyMount = ({\n  children,\n  ...idleProps\n}: LazyMountProps & { children: any }): React.ReactNode => {\n  const mounted = useLazyMount(idleProps)\n  return mounted ? children : null\n}\n"
   ],
   "version": 3
 }

package/types/async/useLazyValue.d.ts.map

@@ -1,5 +1,5 @@
 {
-  "mappings": "AACA,cAAoB,mBAAmB,QAAQ;AAG/C,OAAO,cAAM,eAAgB,GAC3BA,OAAO,GACP,EACE,qBACA,GAAG,aAC8C,GAAhD,cAAc;CAAE;AAAgC,MAClD",
+  "mappings": "AAEA,cAAoB,mBAAmB,QAAQ;AAG/C,OAAO,cAAM,eAAgB,GAC3BA,OAAO,GACP,EACE,qBACA,GAAG,aAC8C,GAAhD,cAAc;CAAE;AAAgC,MAClD",
   "names": [
     "value: T"
   ],
@@ -7,7 +7,7 @@
     "src/async/useLazyValue.ts"
   ],
   "sourcesContent": [
-    "import { startTransition, useState } from 'react'\nimport { idle, type IdleOptions } from './idle'\nimport { useAsyncEffect } from './useAsyncEffect'\n\nexport const useLazyValue = <T>(\n  value: T,\n  {\n    immediateFirstUpdate,\n    ...idleOptions\n  }: IdleOptions & { immediateFirstUpdate?: boolean } = {}\n): T => {\n  const [lazyValue, setLazyValue] = useState(value)\n\n  // first update to a real value immediate\n  if (value && lazyValue === undefined && lazyValue !== value && immediateFirstUpdate) {\n    setLazyValue(value)\n  }\n\n  useAsyncEffect(\n    async (signal) => {\n      await idle(idleOptions, signal)\n      startTransition(() => {\n        setLazyValue(value)\n      })\n    },\n    [value]\n  )\n\n  return lazyValue\n}\n"
+    "import { startTransition, useState } from 'react'\n\nimport { idle, type IdleOptions } from './idle'\nimport { useAsyncEffect } from './useAsyncEffect'\n\nexport const useLazyValue = <T>(\n  value: T,\n  {\n    immediateFirstUpdate,\n    ...idleOptions\n  }: IdleOptions & { immediateFirstUpdate?: boolean } = {}\n): T => {\n  const [lazyValue, setLazyValue] = useState(value)\n\n  // first update to a real value immediate\n  if (value && lazyValue === undefined && lazyValue !== value && immediateFirstUpdate) {\n    setLazyValue(value)\n  }\n\n  useAsyncEffect(\n    async (signal) => {\n      await idle(idleOptions, signal)\n      startTransition(() => {\n        setLazyValue(value)\n      })\n    },\n    [value]\n  )\n\n  return lazyValue\n}\n"
   ],
   "version": 3
 }

package/types/emitter.d.ts.map

@@ -1,5 +1,5 @@
 {
-  "mappings": "AACA,cAAc,KAAK,yBAAyB,OAAO;KA+B9C,eAAe,KAAK,kBAAkB,KAAK;CAC9C;AACD;KAEI,kBAAkB,KAAK;CAC1B;CACA,cAAcA,GAAG,GAAGC,GAAG;AACxB;AAED,OAAO,cAAM,cAAc,GAAG;CAC5B,QAAQ;CACR,OAAO;CACP,UAAU,eAAe;CAEzB,YAAYC,OAAO,GAAGC,UAAU,eAAe;CAK/C,SAAUC,aAAaC,IAAI;CAO3B,OAAQC,MAAM;CAqCd,iBAAgB,QAAQ;AAQzB;;AAGD,OAAO,iBAAS,oBAAoB,GAClCC,cACAC,cAAc,GACdC,UAAU,kBAAkB,KAC3B,QAAQ;AAIX,OAAO,iBAAS,cAAc,GAC5BF,cACAC,cAAc,GACdC,UAAU,kBAAkB,KAC3B,QAAQ;AAKX,YAAY,YAAY,UAAU,gBAAgB,UAAU,cAAc,OACtE;AAGJ,OAAO,cAAM,aAAc,UAAU,cACnCC,SAAS,GACTC,KAAKC,IAAI,YAAY,aACrBC;AAeF,OAAO,cAAM,kBAAmB,UAAU,cACxCH,SAAS,GACTI,UAAU;CAAE;AAAmB,MAC9B,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCf,OAAO,cAAM;CAAsB,UAAU;CAAc,UAAU,YAAY;CAAI;EACnFJ,SAAS,GACTK,WAAWb,OAAO,MAAM,GACxBc,UAAU;CACR;CACA;AACD,GACDC,iBACC;AAgCH,OAAO,cAAM;OAA6B,mBAAmB;CAAgB;EAC3EC,UAAU,GACVC,WAAWC,WAAW,WAAW,KAAI,YAAY,EAAE,UAAU,GAC7DC,UAAU;CAAE;CAAmB,WAAWC,GAAG,GAAGC,GAAG;AAAe,MACjE;AAgDH,OAAO,cAAM,mBAAoB,UAAU,cACzCb,SAAS,QACNc,KAAKC,KAAK,YAAY,aAAaZ;AAKxC,OAAO,cAAM,oBAAqB,UAAU,cAC1CH,SAAS,QACN,GACHgB,WAAWC,OAAO,YAAY,OAAO,GACrCC,UAAU;CAAE;CAAmB;AAAgB,GAC/Cf,iBACG;AAUL,OAAO,iBAAS,wBAAwB,GACtCN,cACAC,cAAc,GACdqB,iBAAiB,KAAK,eAAe,IAAI,0BAEnC,QAAQ,KACbC,OAAO,kBAAkB;CAAE,QAAQ;CAAG;AAAkB,OAAM,IAAI",
+  "mappings": "AAUA,cAAc,KAAK,yBAAyB,OAAO;KAwB9C,eAAe,KAAK,kBAAkB,KAAK;CAC9C;AACD;KAEI,kBAAkB,KAAK;CAC1B;CACA,cAAcA,GAAG,GAAGC,GAAG;AACxB;AAED,OAAO,cAAM,cAAc,GAAG;CAC5B,QAAQ;CACR,OAAO;CACP,UAAU,eAAe;CAEzB,YAAYC,OAAO,GAAGC,UAAU,eAAe;CAK/C,SAAUC,aAAaC,IAAI;CAO3B,OAAQC,MAAM;CAqCd,iBAAgB,QAAQ;AAQzB;;AAGD,OAAO,iBAAS,oBAAoB,GAClCC,cACAC,cAAc,GACdC,UAAU,kBAAkB,KAC3B,QAAQ;AAIX,OAAO,iBAAS,cAAc,GAC5BF,cACAC,cAAc,GACdC,UAAU,kBAAkB,KAC3B,QAAQ;AAKX,YAAY,YAAY,UAAU,gBAChC,UAAU,cAAc,OAAO;AAEjC,OAAO,cAAM,aAAc,UAAU,cACnCC,SAAS,GACTC,KAAKC,IAAI,YAAY,aACrBC;AAeF,OAAO,cAAM,kBAAmB,UAAU,cACxCH,SAAS,GACTI,UAAU;CAAE;AAAmB,MAC9B,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCf,OAAO,cAAM;CAAsB,UAAU;CAAc,UAAU,YAAY;CAAI;EACnFJ,SAAS,GACTK,WAAWb,OAAO,MAAM,GACxBc,UAAU;CACR;CACA;AACD,GACDC,iBACC;AAgCH,OAAO,cAAM;OAA6B,mBAAmB;CAAgB;EAC3EC,UAAU,GACVC,WAAWC,WAAW,WAAW,KAAI,YAAY,EAAE,UAAU,GAC7DC,UAAU;CAAE;CAAmB,WAAWC,GAAG,GAAGC,GAAG;AAAe,MACjE;AAgDH,OAAO,cAAM,mBAAoB,UAAU,cACzCb,SAAS,QACNc,KAAKC,KAAK,YAAY,aAAaZ;AAKxC,OAAO,cAAM,oBAAqB,UAAU,cAC1CH,SAAS,QACN,GACHgB,WAAWC,OAAO,YAAY,OAAO,GACrCC,UAAU;CAAE;CAAmB;AAAgB,GAC/Cf,iBACG;AAUL,OAAO,iBAAS,wBAAwB,GACtCN,cACAC,cAAc,GACdqB,iBAAiB,KAAK,eAAe,IAAI,0BAEnC,QAAQ,KACbC,OAAO,kBAAkB;CAAE,QAAQ;CAAG;AAAkB,OAAM,IAAI",
   "names": [
     "a: T",
     "b: T",
@@ -37,7 +37,7 @@
     "src/emitter.tsx"
   ],
   "sourcesContent": [
-    "import { dequal } from 'dequal'\nimport type { JSX, PropsWithChildren } from 'react'\nimport * as React from 'react'\nimport { use, useLayoutEffect, useState } from 'react'\nimport { handleAbortError } from './async/abortable'\nimport { DEBUG_LEVEL, EMPTY_ARRAY } from './constants'\nimport { AbortError } from './error/errors'\nimport { createGlobalContext } from './react/createGlobalContext'\nimport { globalValue } from './global/globalValue'\n\n// keeps a reference to the current value easily\n\n// TODO can replace with useEffectEvent\nfunction useGet<A>(\n  currentValue: A,\n  initialValue?: any,\n  forwardToFunction?: boolean\n): () => A {\n  const curRef = React.useRef<any>(initialValue ?? currentValue)\n\n  useLayoutEffect(() => {\n    curRef.current = currentValue\n  })\n\n  return React.useCallback(\n    forwardToFunction\n      ? (...args) => curRef.current?.apply(null, args)\n      : () => curRef.current,\n    []\n  )\n}\n\ntype EmitterOptions<T> = CreateEmitterOpts<T> & {\n  name: string\n}\n\ntype CreateEmitterOpts<T> = {\n  silent?: boolean\n  comparator?: (a: T, b: T) => boolean\n}\n\nexport class Emitter<const T> {\n  private disposables = new Set<(cb: any) => void>()\n  value: T\n  options?: EmitterOptions<T>\n\n  constructor(value: T, options?: EmitterOptions<T>) {\n    this.value = value\n    this.options = options\n  }\n\n  listen = (disposable: (cb: T) => void): (() => void) => {\n    this.disposables.add(disposable)\n    return (): void => {\n      this.disposables.delete(disposable)\n    }\n  }\n\n  emit = (next: T): void => {\n    if (process.env.NODE_ENV === 'development') {\n      setCache(this, next)\n    }\n    const compare = this.options?.comparator\n    if (compare) {\n      if (this.value && compare(this.value, next)) {\n        return\n      }\n    } else {\n      if (this.value === next) {\n        if (process.env.NODE_ENV === 'development') {\n          console.warn(\n            `[emitter] ${this.options?.name} no comparator option but received same value!\n            \nthis will emit the same value again, which can be desirable, but we warn to ensure it's not unintended:\n\n- if you want this behavior, add { comparator: isEqualNever }\n- if you want only non-equal values: { comparator: isEqualIdentity }\n- if you want only deeply non-equal values: { comparator: isEqualDeep }`\n          )\n        }\n      }\n    }\n    this.value = next\n    if (DEBUG_LEVEL > 1) {\n      if (!this.options?.silent) {\n        const name = this.options?.name\n        console.groupCollapsed(`📣 ${name}`)\n        console.info(next)\n        console.trace(`trace >`)\n        console.groupEnd()\n      }\n    }\n    this.disposables.forEach((cb) => cb(next))\n  }\n\n  nextValue = (): Promise<T> => {\n    return new Promise<T>((res) => {\n      const dispose = this.listen((val) => {\n        dispose()\n        res(val)\n      })\n    })\n  }\n}\n\n// just createEmitter but ensures it doesn't mess up on HMR\nexport function createGlobalEmitter<T>(\n  name: string,\n  defaultValue: T,\n  options?: CreateEmitterOpts<T>\n): Emitter<T> {\n  return globalValue(name, () => createEmitter(name, defaultValue, options))\n}\n\nexport function createEmitter<T>(\n  name: string,\n  defaultValue: T,\n  options?: CreateEmitterOpts<T>\n): Emitter<T> {\n  const existing = createOrUpdateCache(name, defaultValue) as T\n  return new Emitter<T>(existing || defaultValue, { name, ...options })\n}\n\nexport type EmitterType<E extends Emitter<any>> = E extends Emitter<infer Val>\n  ? Val\n  : never\n\nexport const useEmitter = <E extends Emitter<any>>(\n  emitter: E,\n  cb: (cb: EmitterType<E>) => void,\n  args?: any[]\n): void => {\n  const getCallback = useGet(cb)\n\n  useLayoutEffect(() => {\n    return emitter.listen((val) => {\n      try {\n        getCallback()(val)\n      } catch (err) {\n        handleAbortError(err)\n      }\n    })\n  }, [emitter, getCallback])\n}\n\nexport const useEmitterValue = <E extends Emitter<any>>(\n  emitter: E,\n  options?: { disable?: boolean }\n): EmitterType<E> => {\n  const [state, setState] = useState<EmitterType<E>>(emitter.value)\n  const disabled = options?.disable\n\n  useLayoutEffect(() => {\n    if (disabled) return\n    if (emitter.value !== state) {\n      setState(emitter.value)\n    }\n    return emitter.listen(setState)\n  }, [disabled, emitter, state])\n\n  return state\n}\n\n/**\n * By default selectors run every render, as well as when emitters update. This is a change\n * from the previous behavior where they only ran when emitters changed value.\n *\n * The reason for this is because emitters capture the variables in scope of the component\n * each render already by using \"useGet\" by default, which makes them easier to use - you\n * don't need to pass an args[] array except for edge cases.\n *\n * Before explaining why we switched to the default, understand the different uses:\n *\n * - Default behavior - selector is updated every render, and ran every render, as well as\n *   when emitter value changes, so you basically are always up to date.\n *\n * - Set an args[] array as the fourth argument - this will stop the automatic capturing\n *   and instead update selector only when you change args[] yourself. This is good for when you\n *   want explicit control over re-selection and rendering.\n *\n * - With { lazy: true }, the selector only runs when the emitter value changes. If used with\n *   args[], you capture the context of the selector based on args[], if not, it's based on the\n *   current render.\n *\n * I made this change when we had 16 usages of useEmitterSelector and 100% of them are doing very\n * cheap calculations, so this feels like the right pattern. For the rare case of a heavy selector,\n * you have the option to control it.\n *\n */\nexport const useEmitterSelector = <E extends Emitter<any>, T extends EmitterType<E>, R>(\n  emitter: E,\n  selector: (value: T) => R,\n  options?: {\n    disable?: boolean\n    lazy?: boolean\n  },\n  args: any[] = EMPTY_ARRAY\n): R => {\n  const [state, setState] = useState<R>(() => selector(emitter.value))\n  const disabled = options?.disable\n  const getSelector = useGet(selector)\n\n  if (options?.lazy !== true) {\n    const next = selector(emitter.value)\n    if (next !== state) {\n      setState(next)\n    }\n  }\n\n  // biome-ignore lint/correctness/useExhaustiveDependencies: we are using args fine\n  useLayoutEffect(() => {\n    if (disabled) return\n    return emitter.listen((val) => {\n      try {\n        const selectorFn = args !== EMPTY_ARRAY ? selector : getSelector()\n        const next = selectorFn(val)\n        setState(next)\n      } catch (error) {\n        if (error instanceof AbortError) {\n          return\n        }\n        throw error\n      }\n    })\n  }, [disabled, emitter, getSelector, ...args])\n\n  return state\n}\n\nexport const useEmittersSelector = <const E extends readonly Emitter<any>[], R>(\n  emitters: E,\n  selector: (values: { [K in keyof E]: EmitterType<E[K]> }) => R,\n  options?: { disable?: boolean; isEqual?: (a: R, b: R) => boolean }\n): R => {\n  const getSelector = useGet(selector)\n  const disabled = options?.disable\n\n  const [state, setState] = useState<R>(() => {\n    const values = emitters.map((e) => e.value) as { [K in keyof E]: EmitterType<E[K]> }\n    return getSelector()(values)\n  })\n\n  // biome-ignore lint/correctness/useExhaustiveDependencies: ignore\n  useLayoutEffect(() => {\n    if (disabled) {\n      return\n    }\n\n    const handler = () => {\n      const values = emitters.map((e) => e.value) as {\n        [K in keyof E]: EmitterType<E[K]>\n      }\n      try {\n        const next = getSelector()(values)\n        setState((prev) => {\n          if (options?.isEqual?.(prev, next)) {\n            return prev\n          }\n          if (dequal(prev, next)) {\n            return prev\n          }\n          return next\n        })\n      } catch (error) {\n        if (error instanceof AbortError) {\n          return\n        }\n        throw error\n      }\n    }\n\n    const disposals = emitters.map((emitter) => emitter.listen(handler))\n\n    return () => {\n      disposals.forEach((d) => d())\n    }\n  }, [disabled, getSelector, ...emitters])\n\n  return state\n}\n\nexport const createUseEmitter = <E extends Emitter<any>>(\n  emitter: E\n): ((cb: (val: EmitterType<E>) => void, args?: any[]) => void) => {\n  return (cb: (val: EmitterType<E>) => void, args?: any[]) =>\n    useEmitter(emitter, cb, args)\n}\n\nexport const createUseSelector = <E extends Emitter<any>>(\n  emitter: E\n): (<R>(\n  selector: (value: EmitterType<E>) => R,\n  options?: { disable?: boolean; lazy?: boolean },\n  args?: any[]\n) => R) => {\n  return <R,>(\n    selector: (value: EmitterType<E>) => R,\n    options?: { disable?: boolean; lazy?: boolean },\n    args?: any[]\n  ): R => {\n    return useEmitterSelector(emitter, selector, options, args)\n  }\n}\n\nexport function createContextualEmitter<T>(\n  name: string,\n  defaultValue: T,\n  defaultOptions?: Omit<EmitterOptions<T>, 'name'>\n): readonly [\n  () => Emitter<T>,\n  (props: PropsWithChildren<{ value?: T; silent?: boolean }>) => JSX.Element,\n] {\n  const id = Math.random().toString(36)\n  const EmitterContext = createGlobalContext<Emitter<T> | null>(\n    `contextual-emitter/${id}`,\n    null\n  )\n\n  const useContextEmitter = () => {\n    const emitter = use(EmitterContext)\n    if (!emitter) {\n      throw new Error('useContextEmitter must be used within an EmitterProvider')\n    }\n    return emitter\n  }\n\n  type ProvideEmitterProps = PropsWithChildren<{\n    value?: T\n    silent?: boolean\n  }>\n\n  const ProvideEmitter = (props: ProvideEmitterProps) => {\n    const { children, value, silent } = props\n    const [emitter] = useState(\n      () => new Emitter<T>(value ?? defaultValue, { name, silent, ...defaultOptions })\n    )\n\n    useLayoutEffect(() => {\n      if (value !== undefined && value !== emitter.value) {\n        emitter.emit(value)\n      }\n    }, [value, emitter])\n\n    return <EmitterContext.Provider value={emitter}>{children}</EmitterContext.Provider>\n  }\n\n  return [useContextEmitter, ProvideEmitter] as const\n}\n\nconst HMRCache =\n  process.env.NODE_ENV === 'development'\n    ? new Map<string, { originalDefaultValue: unknown; currentValue: unknown }>()\n    : null\n\nfunction setCache(emitter: Emitter<any>, value: unknown) {\n  const name = emitter.options?.name\n  if (!name) return\n  const cache = HMRCache?.get(name)\n  if (!cache) return\n  cache.currentValue = value\n}\n\nfunction createOrUpdateCache(name: string, defaultValueProp: unknown) {\n  const existing = HMRCache?.get(name)\n  const defaultValue = dequal(existing?.originalDefaultValue, defaultValueProp)\n    ? existing?.currentValue\n    : defaultValueProp\n\n  if (!existing) {\n    HMRCache?.set(name, {\n      originalDefaultValue: defaultValueProp,\n      currentValue: defaultValue,\n    })\n  }\n\n  return defaultValue\n}\n"
+    "import { dequal } from 'dequal'\nimport * as React from 'react'\nimport { use, useLayoutEffect, useState } from 'react'\n\nimport { handleAbortError } from './async/abortable'\nimport { DEBUG_LEVEL, EMPTY_ARRAY } from './constants'\nimport { AbortError } from './error/errors'\nimport { globalValue } from './global/globalValue'\nimport { createGlobalContext } from './react/createGlobalContext'\n\nimport type { JSX, PropsWithChildren } from 'react'\n\n// keeps a reference to the current value easily\n\n// TODO can replace with useEffectEvent\nfunction useGet<A>(\n  currentValue: A,\n  initialValue?: any,\n  forwardToFunction?: boolean\n): () => A {\n  const curRef = React.useRef<any>(initialValue ?? currentValue)\n\n  useLayoutEffect(() => {\n    curRef.current = currentValue\n  })\n\n  return React.useCallback(\n    forwardToFunction\n      ? (...args) => curRef.current?.apply(null, args)\n      : () => curRef.current,\n    []\n  )\n}\n\ntype EmitterOptions<T> = CreateEmitterOpts<T> & {\n  name: string\n}\n\ntype CreateEmitterOpts<T> = {\n  silent?: boolean\n  comparator?: (a: T, b: T) => boolean\n}\n\nexport class Emitter<const T> {\n  private disposables = new Set<(cb: any) => void>()\n  value: T\n  options?: EmitterOptions<T>\n\n  constructor(value: T, options?: EmitterOptions<T>) {\n    this.value = value\n    this.options = options\n  }\n\n  listen = (disposable: (cb: T) => void): (() => void) => {\n    this.disposables.add(disposable)\n    return (): void => {\n      this.disposables.delete(disposable)\n    }\n  }\n\n  emit = (next: T): void => {\n    if (process.env.NODE_ENV === 'development') {\n      setCache(this, next)\n    }\n    const compare = this.options?.comparator\n    if (compare) {\n      if (this.value && compare(this.value, next)) {\n        return\n      }\n    } else {\n      if (this.value === next) {\n        if (process.env.NODE_ENV === 'development') {\n          console.warn(\n            `[emitter] ${this.options?.name} no comparator option but received same value!\n            \nthis will emit the same value again, which can be desirable, but we warn to ensure it's not unintended:\n\n- if you want this behavior, add { comparator: isEqualNever }\n- if you want only non-equal values: { comparator: isEqualIdentity }\n- if you want only deeply non-equal values: { comparator: isEqualDeep }`\n          )\n        }\n      }\n    }\n    this.value = next\n    if (DEBUG_LEVEL > 1) {\n      if (!this.options?.silent) {\n        const name = this.options?.name\n        console.groupCollapsed(`📣 ${name}`)\n        console.info(next)\n        console.trace(`trace >`)\n        console.groupEnd()\n      }\n    }\n    this.disposables.forEach((cb) => cb(next))\n  }\n\n  nextValue = (): Promise<T> => {\n    return new Promise<T>((res) => {\n      const dispose = this.listen((val) => {\n        dispose()\n        res(val)\n      })\n    })\n  }\n}\n\n// just createEmitter but ensures it doesn't mess up on HMR\nexport function createGlobalEmitter<T>(\n  name: string,\n  defaultValue: T,\n  options?: CreateEmitterOpts<T>\n): Emitter<T> {\n  return globalValue(name, () => createEmitter(name, defaultValue, options))\n}\n\nexport function createEmitter<T>(\n  name: string,\n  defaultValue: T,\n  options?: CreateEmitterOpts<T>\n): Emitter<T> {\n  const existing = createOrUpdateCache(name, defaultValue) as T\n  return new Emitter<T>(existing || defaultValue, { name, ...options })\n}\n\nexport type EmitterType<E extends Emitter<any>> =\n  E extends Emitter<infer Val> ? Val : never\n\nexport const useEmitter = <E extends Emitter<any>>(\n  emitter: E,\n  cb: (cb: EmitterType<E>) => void,\n  args?: any[]\n): void => {\n  const getCallback = useGet(cb)\n\n  useLayoutEffect(() => {\n    return emitter.listen((val) => {\n      try {\n        getCallback()(val)\n      } catch (err) {\n        handleAbortError(err)\n      }\n    })\n  }, [emitter, getCallback])\n}\n\nexport const useEmitterValue = <E extends Emitter<any>>(\n  emitter: E,\n  options?: { disable?: boolean }\n): EmitterType<E> => {\n  const [state, setState] = useState<EmitterType<E>>(emitter.value)\n  const disabled = options?.disable\n\n  useLayoutEffect(() => {\n    if (disabled) return\n    if (emitter.value !== state) {\n      setState(emitter.value)\n    }\n    return emitter.listen(setState)\n  }, [disabled, emitter, state])\n\n  return state\n}\n\n/**\n * By default selectors run every render, as well as when emitters update. This is a change\n * from the previous behavior where they only ran when emitters changed value.\n *\n * The reason for this is because emitters capture the variables in scope of the component\n * each render already by using \"useGet\" by default, which makes them easier to use - you\n * don't need to pass an args[] array except for edge cases.\n *\n * Before explaining why we switched to the default, understand the different uses:\n *\n * - Default behavior - selector is updated every render, and ran every render, as well as\n *   when emitter value changes, so you basically are always up to date.\n *\n * - Set an args[] array as the fourth argument - this will stop the automatic capturing\n *   and instead update selector only when you change args[] yourself. This is good for when you\n *   want explicit control over re-selection and rendering.\n *\n * - With { lazy: true }, the selector only runs when the emitter value changes. If used with\n *   args[], you capture the context of the selector based on args[], if not, it's based on the\n *   current render.\n *\n * I made this change when we had 16 usages of useEmitterSelector and 100% of them are doing very\n * cheap calculations, so this feels like the right pattern. For the rare case of a heavy selector,\n * you have the option to control it.\n *\n */\nexport const useEmitterSelector = <E extends Emitter<any>, T extends EmitterType<E>, R>(\n  emitter: E,\n  selector: (value: T) => R,\n  options?: {\n    disable?: boolean\n    lazy?: boolean\n  },\n  args: any[] = EMPTY_ARRAY\n): R => {\n  const [state, setState] = useState<R>(() => selector(emitter.value))\n  const disabled = options?.disable\n  const getSelector = useGet(selector)\n\n  if (options?.lazy !== true) {\n    const next = selector(emitter.value)\n    if (next !== state) {\n      setState(next)\n    }\n  }\n\n  // eslint-disable-next-line react-hooks/exhaustive-deps\n  useLayoutEffect(() => {\n    if (disabled) return\n    return emitter.listen((val) => {\n      try {\n        const selectorFn = args !== EMPTY_ARRAY ? selector : getSelector()\n        const next = selectorFn(val)\n        setState(next)\n      } catch (error) {\n        if (error instanceof AbortError) {\n          return\n        }\n        throw error\n      }\n    })\n  }, [disabled, emitter, getSelector, ...args])\n\n  return state\n}\n\nexport const useEmittersSelector = <const E extends readonly Emitter<any>[], R>(\n  emitters: E,\n  selector: (values: { [K in keyof E]: EmitterType<E[K]> }) => R,\n  options?: { disable?: boolean; isEqual?: (a: R, b: R) => boolean }\n): R => {\n  const getSelector = useGet(selector)\n  const disabled = options?.disable\n\n  const [state, setState] = useState<R>(() => {\n    const values = emitters.map((e) => e.value) as { [K in keyof E]: EmitterType<E[K]> }\n    return getSelector()(values)\n  })\n\n  // eslint-disable-next-line react-hooks/exhaustive-deps\n  useLayoutEffect(() => {\n    if (disabled) {\n      return\n    }\n\n    const handler = () => {\n      const values = emitters.map((e) => e.value) as {\n        [K in keyof E]: EmitterType<E[K]>\n      }\n      try {\n        const next = getSelector()(values)\n        setState((prev) => {\n          if (options?.isEqual?.(prev, next)) {\n            return prev\n          }\n          if (dequal(prev, next)) {\n            return prev\n          }\n          return next\n        })\n      } catch (error) {\n        if (error instanceof AbortError) {\n          return\n        }\n        throw error\n      }\n    }\n\n    const disposals = emitters.map((emitter) => emitter.listen(handler))\n\n    return () => {\n      disposals.forEach((d) => d())\n    }\n  }, [disabled, getSelector, ...emitters])\n\n  return state\n}\n\nexport const createUseEmitter = <E extends Emitter<any>>(\n  emitter: E\n): ((cb: (val: EmitterType<E>) => void, args?: any[]) => void) => {\n  return (cb: (val: EmitterType<E>) => void, args?: any[]) =>\n    useEmitter(emitter, cb, args)\n}\n\nexport const createUseSelector = <E extends Emitter<any>>(\n  emitter: E\n): (<R>(\n  selector: (value: EmitterType<E>) => R,\n  options?: { disable?: boolean; lazy?: boolean },\n  args?: any[]\n) => R) => {\n  return <R,>(\n    selector: (value: EmitterType<E>) => R,\n    options?: { disable?: boolean; lazy?: boolean },\n    args?: any[]\n  ): R => {\n    return useEmitterSelector(emitter, selector, options, args)\n  }\n}\n\nexport function createContextualEmitter<T>(\n  name: string,\n  defaultValue: T,\n  defaultOptions?: Omit<EmitterOptions<T>, 'name'>\n): readonly [\n  () => Emitter<T>,\n  (props: PropsWithChildren<{ value?: T; silent?: boolean }>) => JSX.Element,\n] {\n  const id = Math.random().toString(36)\n  const EmitterContext = createGlobalContext<Emitter<T> | null>(\n    `contextual-emitter/${id}`,\n    null\n  )\n\n  const useContextEmitter = () => {\n    const emitter = use(EmitterContext)\n    if (!emitter) {\n      throw new Error('useContextEmitter must be used within an EmitterProvider')\n    }\n    return emitter\n  }\n\n  type ProvideEmitterProps = PropsWithChildren<{\n    value?: T\n    silent?: boolean\n  }>\n\n  const ProvideEmitter = (props: ProvideEmitterProps) => {\n    const { children, value, silent } = props\n    const [emitter] = useState(\n      () => new Emitter<T>(value ?? defaultValue, { name, silent, ...defaultOptions })\n    )\n\n    useLayoutEffect(() => {\n      if (value !== undefined && value !== emitter.value) {\n        emitter.emit(value)\n      }\n    }, [value, emitter])\n\n    return <EmitterContext.Provider value={emitter}>{children}</EmitterContext.Provider>\n  }\n\n  return [useContextEmitter, ProvideEmitter] as const\n}\n\nconst HMRCache =\n  process.env.NODE_ENV === 'development'\n    ? new Map<string, { originalDefaultValue: unknown; currentValue: unknown }>()\n    : null\n\nfunction setCache(emitter: Emitter<any>, value: unknown) {\n  const name = emitter.options?.name\n  if (!name) return\n  const cache = HMRCache?.get(name)\n  if (!cache) return\n  cache.currentValue = value\n}\n\nfunction createOrUpdateCache(name: string, defaultValueProp: unknown) {\n  const existing = HMRCache?.get(name)\n  const defaultValue = dequal(existing?.originalDefaultValue, defaultValueProp)\n    ? existing?.currentValue\n    : defaultValueProp\n\n  if (!existing) {\n    HMRCache?.set(name, {\n      originalDefaultValue: defaultValueProp,\n      currentValue: defaultValue,\n    })\n  }\n\n  return defaultValue\n}\n"
   ],
   "version": 3
 }

package/types/index.d.ts

@@ -1,7 +1,6 @@
 export * from "./constants";
 export * from "./emitter";
 // array
-export * from "./array/fuzzy";
 export * from "./array/getRandomItem";
 export * from "./array/takeLast";
 export * from "./array/uniqBy";
@@ -21,7 +20,6 @@ export * from "./async/useLazyValue";
 // browser
 export * from "./browser/clearIndexedDB";
 export * from "./browser/isActiveElementFormField";
-export * from "./browser/localStorage";
 export * from "./browser/openPopup";
 // debug
 export * from "./debug/debugLog";
@@ -54,6 +52,8 @@ export * from "./object/objectUniqueKey";
 // react
 export * from "./react/createGlobalContext";
 export * from "./react/getCurrentComponentStack";
+// storage
+export * from "./storage";
 // server
 export * from "./server/ensureEnv";
 export * from "./server/getHeaders";

package/types/index.d.ts.map

@@ -1,11 +1,11 @@
 {
-  "mappings": "AAAA,cAAc;AACd,cAAc;;AAGd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;;AAGd,cAAc;;AAGd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;;AAGd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;;AAGd,cAAc;AACd,cAAc;;AAGd,cAAc;AACd,cAAc;;AAGd,cAAc;;;AAKd,cAAc;AACd,cAAc;AACd,cAAc;;AAGd,cAAc;AACd,cAAc;;AAGd,cAAc;;AAGd,cAAc;AACd,cAAc;AACd,SAAS,uBAAuB;AAChC,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;;AAGd,cAAc;AACd,cAAc;;AAGd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;;AAGd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;;AAGd,cAAc;AACd,cAAc;AACd,cAAc;;AAGd,mBAAmB;AACnB,mBAAmB;AACnB,mBAAmB;AACnB,mBAAmB;AACnB,mBAAmB;;AAGnB,cAAc;AACd,cAAc",
+  "mappings": "AAAA,cAAc;AACd,cAAc;;AAGd,cAAc;AACd,cAAc;AACd,cAAc;;AAGd,cAAc;;AAGd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;;AAGd,cAAc;AACd,cAAc;AACd,cAAc;;AAGd,cAAc;AACd,cAAc;;AAGd,cAAc;AACd,cAAc;;AAGd,cAAc;;;AAKd,cAAc;AACd,cAAc;AACd,cAAc;;AAGd,cAAc;AACd,cAAc;;AAGd,cAAc;;AAGd,cAAc;AACd,cAAc;AACd,SAAS,uBAAuB;AAChC,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;;AAGd,cAAc;AACd,cAAc;;AAGd,cAAc;;AAGd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;;AAGd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;;AAGd,cAAc;AACd,cAAc;AACd,cAAc;;AAGd,mBAAmB;AACnB,mBAAmB;AACnB,mBAAmB;AACnB,mBAAmB;AACnB,mBAAmB;;AAGnB,cAAc;AACd,cAAc",
   "names": [],
   "sources": [
     "src/index.ts"
   ],
   "sourcesContent": [
-    "export * from './constants'\nexport * from './emitter'\n\n// array\nexport * from './array/fuzzy'\nexport * from './array/getRandomItem'\nexport * from './array/takeLast'\nexport * from './array/uniqBy'\n\n// assert\nexport * from './assert'\n\n// async\nexport * from './async/abortable'\nexport * from './async/asyncContext'\nexport * from './async/idle'\nexport * from './async/interval'\nexport * from './async/isAborted'\nexport * from './async/sleep'\nexport * from './async/useAsync'\nexport * from './async/useAsyncEffect'\nexport * from './async/useLazyMount'\nexport * from './async/useLazyValue'\n\n// browser\nexport * from './browser/clearIndexedDB'\nexport * from './browser/isActiveElementFormField'\nexport * from './browser/localStorage'\nexport * from './browser/openPopup'\n\n// debug\nexport * from './debug/debugLog'\nexport * from './debug/debugUseState'\n\n// ensure\nexport * from './ensure/ensure'\nexport * from './ensure/ensureOne'\n\n// error\nexport * from './error/errors'\n\n// files\n\n// function\nexport * from './function/emptyFn'\nexport * from './function/identityFn'\nexport * from './function/throttle'\n\n// global\nexport * from './global/globalEffect'\nexport * from './global/globalValue'\n\n// number\nexport * from './number/formatNumber'\n\n// object\nexport * from './object/decorateObject'\nexport * from './object/isEqualDeep'\nexport { isEqualDeepLite } from './object/isEqualDeep'\nexport * from './object/isEqualIdentity'\nexport * from './object/isEqualJSON'\nexport * from './object/isEqualNever'\nexport * from './object/mapObject'\nexport * from './object/object'\nexport * from './object/objectUniqueKey'\n\n// react\nexport * from './react/createGlobalContext'\nexport * from './react/getCurrentComponentStack'\n\n// server\nexport * from './server/ensureEnv'\nexport * from './server/getHeaders'\nexport * from './server/prettyPrintRequest'\nexport * from './server/prettyPrintResponse'\nexport * from './server/streamToString'\n\n// string\nexport * from './string/dedent'\nexport * from './string/ellipsis'\nexport * from './string/hash'\nexport * from './string/insertAtIndex'\nexport * from './string/pickLast'\nexport * from './string/pluralize'\nexport * from './string/randomId'\nexport * from './string/slugify'\nexport * from './string/truncateList'\n\n// time\nexport * from './time/formatDate'\nexport * from './time/formatDateRelative'\nexport * from './time/time'\n\n// types\nexport type * from './types/NullToOptional'\nexport type * from './types/object'\nexport type * from './types/react'\nexport type * from './types/timer'\nexport type * from './types/tuple'\n\n// url\nexport * from './url/urlSanitize'\nexport * from './url/urlValidate'\n"
+    "export * from './constants'\nexport * from './emitter'\n\n// array\nexport * from './array/getRandomItem'\nexport * from './array/takeLast'\nexport * from './array/uniqBy'\n\n// assert\nexport * from './assert'\n\n// async\nexport * from './async/abortable'\nexport * from './async/asyncContext'\nexport * from './async/idle'\nexport * from './async/interval'\nexport * from './async/isAborted'\nexport * from './async/sleep'\nexport * from './async/useAsync'\nexport * from './async/useAsyncEffect'\nexport * from './async/useLazyMount'\nexport * from './async/useLazyValue'\n\n// browser\nexport * from './browser/clearIndexedDB'\nexport * from './browser/isActiveElementFormField'\nexport * from './browser/openPopup'\n\n// debug\nexport * from './debug/debugLog'\nexport * from './debug/debugUseState'\n\n// ensure\nexport * from './ensure/ensure'\nexport * from './ensure/ensureOne'\n\n// error\nexport * from './error/errors'\n\n// files\n\n// function\nexport * from './function/emptyFn'\nexport * from './function/identityFn'\nexport * from './function/throttle'\n\n// global\nexport * from './global/globalEffect'\nexport * from './global/globalValue'\n\n// number\nexport * from './number/formatNumber'\n\n// object\nexport * from './object/decorateObject'\nexport * from './object/isEqualDeep'\nexport { isEqualDeepLite } from './object/isEqualDeep'\nexport * from './object/isEqualIdentity'\nexport * from './object/isEqualJSON'\nexport * from './object/isEqualNever'\nexport * from './object/mapObject'\nexport * from './object/object'\nexport * from './object/objectUniqueKey'\n\n// react\nexport * from './react/createGlobalContext'\nexport * from './react/getCurrentComponentStack'\n\n// storage\nexport * from './storage'\n\n// server\nexport * from './server/ensureEnv'\nexport * from './server/getHeaders'\nexport * from './server/prettyPrintRequest'\nexport * from './server/prettyPrintResponse'\nexport * from './server/streamToString'\n\n// string\nexport * from './string/dedent'\nexport * from './string/ellipsis'\nexport * from './string/hash'\nexport * from './string/insertAtIndex'\nexport * from './string/pickLast'\nexport * from './string/pluralize'\nexport * from './string/randomId'\nexport * from './string/slugify'\nexport * from './string/truncateList'\n\n// time\nexport * from './time/formatDate'\nexport * from './time/formatDateRelative'\nexport * from './time/time'\n\n// types\nexport type * from './types/NullToOptional'\nexport type * from './types/object'\nexport type * from './types/react'\nexport type * from './types/timer'\nexport type * from './types/tuple'\n\n// url\nexport * from './url/urlSanitize'\nexport * from './url/urlValidate'\n"
   ],
   "version": 3
 }

package/types/object/object.d.ts

@@ -6,7 +6,7 @@ export declare function postfixObjKeys<
 	B extends string
 >(obj: A, postfix: B): { [Key in `${keyof A extends string ? keyof A : never}${B}`] : string };
 export declare function objectFromEntries<ARR_T extends EntriesType>(arr: ARR_T): EntriesToObject<ARR_T>;
-export declare function objectKeys<O extends Object>(obj: O): Array<keyof O>;
+export declare function objectKeys<O extends object>(obj: O): Array<keyof O>;
 export declare function objectEntries<OBJ_T extends ObjectType>(obj: OBJ_T): ObjectEntries<OBJ_T>;
 
 //# sourceMappingURL=object.d.ts.map

package/types/object/object.d.ts.map

@@ -1,5 +1,5 @@
 {
-  "mappings": "AAAA,cACE,iBACA,aACA,eACA,kBACK,iBAAiB;AAExB,OAAO,iBAAS;CAAe,UAAU;;CAAyB;CAAE;EAClEA,KAAK,GACLC,SAAS,OAER,gBAAgB,yBAAyB,YAAY;AAOxD,OAAO,iBAAS,kBAAkB,cAAc,aAC9CC,KAAK,QACJ,gBAAgB;AAInB,OAAO,iBAAS,WAAW,UAAU,QAAQC,KAAK,IACrB,YAAY;AAGzC,OAAO,iBAAS,cAAc,cAAc,YAC1CC,KAAK,QACJ,cAAc",
+  "mappings": "AAAA,cACE,iBACA,aACA,eACA,kBACK,iBAAiB;AAExB,OAAO,iBAAS;CAAe,UAAU;;CAAyB;CAAE;EAClEA,KAAK,GACLC,SAAS,OAER,gBAAgB,yBAAyB,YAAY;AAOxD,OAAO,iBAAS,kBAAkB,cAAc,aAC9CC,KAAK,QACJ,gBAAgB;AAInB,OAAO,iBAAS,WAAW,kBAAkBC,KAAK,IACrB,YAAY;AAGzC,OAAO,iBAAS,cAAc,cAAc,YAC1CC,KAAK,QACJ,cAAc",
   "names": [
     "obj: A",
     "postfix: B",
@@ -11,7 +11,7 @@
     "src/object/object.ts"
   ],
   "sourcesContent": [
-    "import type {\n  EntriesToObject,\n  EntriesType,\n  ObjectEntries,\n  ObjectType,\n} from '../types/object'\n\nexport function postfixObjKeys<A extends { [key: string]: string }, B extends string>(\n  obj: A,\n  postfix: B\n): {\n  [Key in `${keyof A extends string ? keyof A : never}${B}`]: string\n} {\n  return Object.fromEntries(\n    Object.entries(obj).map(([k, v]) => [`${k}${postfix}`, v])\n  ) as any\n}\n\nexport function objectFromEntries<ARR_T extends EntriesType>(\n  arr: ARR_T\n): EntriesToObject<ARR_T> {\n  return Object.fromEntries(arr) as EntriesToObject<ARR_T>\n}\n\nexport function objectKeys<O extends Object>(obj: O) {\n  return Object.keys(obj) as Array<keyof O>\n}\n\nexport function objectEntries<OBJ_T extends ObjectType>(\n  obj: OBJ_T\n): ObjectEntries<OBJ_T> {\n  return Object.entries(obj) as ObjectEntries<OBJ_T>\n}\n"
+    "import type {\n  EntriesToObject,\n  EntriesType,\n  ObjectEntries,\n  ObjectType,\n} from '../types/object'\n\nexport function postfixObjKeys<A extends { [key: string]: string }, B extends string>(\n  obj: A,\n  postfix: B\n): {\n  [Key in `${keyof A extends string ? keyof A : never}${B}`]: string\n} {\n  return Object.fromEntries(\n    Object.entries(obj).map(([k, v]) => [`${k}${postfix}`, v])\n  ) as any\n}\n\nexport function objectFromEntries<ARR_T extends EntriesType>(\n  arr: ARR_T\n): EntriesToObject<ARR_T> {\n  return Object.fromEntries(arr) as EntriesToObject<ARR_T>\n}\n\nexport function objectKeys<O extends object>(obj: O) {\n  return Object.keys(obj) as Array<keyof O>\n}\n\nexport function objectEntries<OBJ_T extends ObjectType>(\n  obj: OBJ_T\n): ObjectEntries<OBJ_T> {\n  return Object.entries(obj) as ObjectEntries<OBJ_T>\n}\n"
   ],
   "version": 3
 }

package/types/react/createGlobalContext.d.ts.map

@@ -1,5 +1,5 @@
 {
-  "mappings": "AAAA,cAAc,eAA8B,OAAO;;;AAMnD,OAAO,iBAAS,oBAAoB,GAAGA,aAAaC,cAAc,IAAI,QAAQ",
+  "mappings": "AAAA,cAAc,eAA8B,OAAO;;;AAOnD,OAAO,iBAAS,oBAAoB,GAAGA,aAAaC,cAAc,IAAI,QAAQ",
   "names": [
     "key: string",
     "defaultValue: T"
@@ -8,7 +8,7 @@
     "src/react/createGlobalContext.ts"
   ],
   "sourcesContent": [
-    "import { type Context, createContext } from 'react'\nimport { globalValue } from '../global/globalValue'\n\n// create or retrieve a React context that is stored on `globalThis`.\n// this ensures a stable singleton that survives hot-reloads during development.\n\nexport function createGlobalContext<T>(key: string, defaultValue: T): Context<T> {\n  return globalValue(key, () => createContext<T>(defaultValue))\n}\n"
+    "import { type Context, createContext } from 'react'\n\nimport { globalValue } from '../global/globalValue'\n\n// create or retrieve a React context that is stored on `globalThis`.\n// this ensures a stable singleton that survives hot-reloads during development.\n\nexport function createGlobalContext<T>(key: string, defaultValue: T): Context<T> {\n  return globalValue(key, () => createContext<T>(defaultValue))\n}\n"
   ],
   "version": 3
 }

package/types/storage/createStorage.d.ts

@@ -0,0 +1,65 @@
+/**
+* namespaced storage interface with JSON serialization
+* @template K - key type (string literal union for type-safe keys)
+* @template V - value type (automatically JSON serialized/deserialized)
+*/
+export interface Storage<
+	K extends string = string,
+	V = unknown
+> {
+	/** get a JSON-parsed value by key */
+	get(key: K): V | undefined;
+	/** set a value (JSON serialized) */
+	set(key: K, value: V): void;
+	/** remove a key */
+	remove(key: K): void;
+	/** check if key exists */
+	has(key: K): boolean;
+	/** get all keys in this namespace */
+	keys(): K[];
+	/** remove all keys in this namespace */
+	clear(): void;
+	/** get raw string value (no JSON parsing) - localStorage compatible */
+	getItem(key: K): string | null;
+	/** set raw string value (no JSON serialization) - localStorage compatible */
+	setItem(key: K, value: string): void;
+}
+/**
+* create a namespaced storage instance
+* @param namespace - unique prefix for all keys (throws if already used)
+* @returns storage instance with get/set (JSON) and getItem/setItem (raw) methods
+* @example
+* const store = createStorage<'token' | 'user', string>('auth')
+* store.set('token', 'abc123')
+* store.get('token') // 'abc123'
+*/
+export declare function createStorage<
+	K extends string,
+	V
+>(namespace: string): Storage<K, V>;
+/**
+* single-value storage interface
+* @template T - value type (automatically JSON serialized/deserialized)
+*/
+export interface StorageValue<T> {
+	/** get the stored value */
+	get(): T | undefined;
+	/** set the value */
+	set(value: T): void;
+	/** remove the value */
+	remove(): void;
+	/** check if value exists */
+	has(): boolean;
+}
+/**
+* create a single-value storage (wrapper around createStorage)
+* @param key - unique storage key
+* @returns storage value instance
+* @example
+* const token = createStorageValue<string>('auth-token')
+* token.set('abc123')
+* token.get() // 'abc123'
+*/
+export declare function createStorageValue<T>(key: string): StorageValue<T>;
+
+//# sourceMappingURL=createStorage.d.ts.map

package/types/storage/createStorage.d.ts.map

@@ -0,0 +1,18 @@
+{
+  "mappings": ";;;;;AASA,iBAAiB;CAAQ;CAA2B;EAAa;;CAE/D,IAAIA,KAAK,IAAI;;CAEb,IAAIA,KAAK,GAAGC,OAAO;;CAEnB,OAAOD,KAAK;;CAEZ,IAAIA,KAAK;;CAET,QAAQ;;CAER;;CAEA,QAAQA,KAAK;;CAEb,QAAQA,KAAK,GAAGE;AACjB;;;;;;;;;;AAWD,OAAO,iBAAS;CAAc;CAAkB;EAAGC,oBAAoB,QAAQ,GAAG;;;;;AA2ElF,iBAAiB,aAAa,GAAG;;CAE/B,OAAO;;CAEP,IAAIC,OAAO;;CAEX;;CAEA;AACD;;;;;;;;;;AAWD,OAAO,iBAAS,mBAAmB,GAAGC,cAAc,aAAa",
+  "names": [
+    "key: K",
+    "value: V",
+    "value: string",
+    "namespace: string",
+    "value: T",
+    "key: string"
+  ],
+  "sources": [
+    "src/storage/createStorage.ts"
+  ],
+  "sourcesContent": [
+    "import { getStorageDriver } from './driver'\n\nconst namespaces = new Set<string>()\n\n/**\n * namespaced storage interface with JSON serialization\n * @template K - key type (string literal union for type-safe keys)\n * @template V - value type (automatically JSON serialized/deserialized)\n */\nexport interface Storage<K extends string = string, V = unknown> {\n  /** get a JSON-parsed value by key */\n  get(key: K): V | undefined\n  /** set a value (JSON serialized) */\n  set(key: K, value: V): void\n  /** remove a key */\n  remove(key: K): void\n  /** check if key exists */\n  has(key: K): boolean\n  /** get all keys in this namespace */\n  keys(): K[]\n  /** remove all keys in this namespace */\n  clear(): void\n  /** get raw string value (no JSON parsing) - localStorage compatible */\n  getItem(key: K): string | null\n  /** set raw string value (no JSON serialization) - localStorage compatible */\n  setItem(key: K, value: string): void\n}\n\n/**\n * create a namespaced storage instance\n * @param namespace - unique prefix for all keys (throws if already used)\n * @returns storage instance with get/set (JSON) and getItem/setItem (raw) methods\n * @example\n * const store = createStorage<'token' | 'user', string>('auth')\n * store.set('token', 'abc123')\n * store.get('token') // 'abc123'\n */\nexport function createStorage<K extends string, V>(namespace: string): Storage<K, V> {\n  if (namespaces.has(namespace)) {\n    throw new Error(`storage namespace already exists: ${namespace}`)\n  }\n  namespaces.add(namespace)\n\n  const prefix = `${namespace}:`\n  const prefixKey = (key: string) => `${prefix}${key}`\n\n  return {\n    get(key: K): V | undefined {\n      const driver = getStorageDriver()\n      if (!driver) return undefined\n      const raw = driver.getItem(prefixKey(key))\n      if (raw == null) return undefined\n      try {\n        return JSON.parse(raw)\n      } catch {\n        return undefined\n      }\n    },\n\n    set(key: K, value: V): void {\n      const driver = getStorageDriver()\n      if (!driver) return\n      driver.setItem(prefixKey(key), JSON.stringify(value))\n    },\n\n    remove(key: K): void {\n      const driver = getStorageDriver()\n      if (!driver) return\n      driver.removeItem(prefixKey(key))\n    },\n\n    has(key: K): boolean {\n      const driver = getStorageDriver()\n      if (!driver) return false\n      return driver.getItem(prefixKey(key)) != null\n    },\n\n    keys(): K[] {\n      const driver = getStorageDriver()\n      if (!driver) return []\n      return driver\n        .getAllKeys()\n        .filter((k) => k.startsWith(prefix))\n        .map((k) => k.slice(prefix.length) as K)\n    },\n\n    clear(): void {\n      const driver = getStorageDriver()\n      if (!driver) return\n      for (const key of this.keys()) {\n        driver.removeItem(prefixKey(key))\n      }\n    },\n\n    getItem(key: K): string | null {\n      const driver = getStorageDriver()\n      if (!driver) return null\n      return driver.getItem(prefixKey(key)) ?? null\n    },\n\n    setItem(key: K, value: string): void {\n      const driver = getStorageDriver()\n      if (!driver) return\n      driver.setItem(prefixKey(key), value)\n    },\n  }\n}\n\n/**\n * single-value storage interface\n * @template T - value type (automatically JSON serialized/deserialized)\n */\nexport interface StorageValue<T> {\n  /** get the stored value */\n  get(): T | undefined\n  /** set the value */\n  set(value: T): void\n  /** remove the value */\n  remove(): void\n  /** check if value exists */\n  has(): boolean\n}\n\n/**\n * create a single-value storage (wrapper around createStorage)\n * @param key - unique storage key\n * @returns storage value instance\n * @example\n * const token = createStorageValue<string>('auth-token')\n * token.set('abc123')\n * token.get() // 'abc123'\n */\nexport function createStorageValue<T>(key: string): StorageValue<T> {\n  const storage = createStorage<'value', T>(`_v:${key}`)\n  return {\n    get: (): T | undefined => storage.get('value'),\n    set: (value: T): void => storage.set('value', value),\n    remove: (): void => storage.remove('value'),\n    has: (): boolean => storage.has('value'),\n  }\n}\n"
+  ],
+  "version": 3
+}

package/types/storage/driver.d.ts

@@ -0,0 +1,5 @@
+import type { StorageDriver } from "./types";
+export declare function setStorageDriver(d: StorageDriver): void;
+export declare function getStorageDriver(): StorageDriver | null;
+
+//# sourceMappingURL=driver.d.ts.map

package/types/storage/driver.d.ts.map

@@ -0,0 +1,13 @@
+{
+  "mappings": "AAAA,cAAc,qBAAqB,SAAS;AAI5C,OAAO,iBAAS,iBAAiBA,GAAG;AAIpC,OAAO,iBAAS,oBAAoB",
+  "names": [
+    "d: StorageDriver"
+  ],
+  "sources": [
+    "src/storage/driver.ts"
+  ],
+  "sourcesContent": [
+    "import type { StorageDriver } from './types'\n\nlet driver: StorageDriver | null = null\n\nexport function setStorageDriver(d: StorageDriver): void {\n  driver = d\n}\n\nexport function getStorageDriver(): StorageDriver | null {\n  if (driver) return driver\n  if (typeof localStorage !== 'undefined') {\n    return {\n      getItem: (key) => localStorage.getItem(key),\n      setItem: (key, value) => localStorage.setItem(key, value),\n      removeItem: (key) => localStorage.removeItem(key),\n      getAllKeys: () => Object.keys(localStorage),\n    }\n  }\n  return null\n}\n"
+  ],
+  "version": 3
+}

package/types/storage/index.d.ts

@@ -0,0 +1,6 @@
+export { createStorage, createStorageValue } from "./createStorage";
+export type { Storage, StorageValue } from "./createStorage";
+export { getStorageDriver, setStorageDriver } from "./driver";
+export type { StorageDriver } from "./types";
+
+//# sourceMappingURL=index.d.ts.map

package/types/storage/index.d.ts.map

@@ -0,0 +1,11 @@
+{
+  "mappings": "AAAA,SAAS,eAAe,0BAA0B;AAClD,cAAc,SAAS,oBAAoB;AAC3C,SAAS,kBAAkB,wBAAwB;AACnD,cAAc,qBAAqB",
+  "names": [],
+  "sources": [
+    "src/storage/index.ts"
+  ],
+  "sourcesContent": [
+    "export { createStorage, createStorageValue } from './createStorage'\nexport type { Storage, StorageValue } from './createStorage'\nexport { getStorageDriver, setStorageDriver } from './driver'\nexport type { StorageDriver } from './types'\n"
+  ],
+  "version": 3
+}

package/types/storage/types.d.ts

@@ -0,0 +1,8 @@
+export interface StorageDriver {
+	getItem(key: string): string | null | undefined;
+	setItem(key: string, value: string): void;
+	removeItem(key: string): void;
+	getAllKeys(): string[];
+}
+
+//# sourceMappingURL=types.d.ts.map