cross-state 0.6.10 → 0.7.2

package/dist/es/store.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.mjs","sources":["../../src/lib/calcDuration.ts","../../src/lib/queue.ts","../../src/lib/equals.ts","../../src/lib/trackingProxy.ts","../../src/lib/calculationHelper.ts","../../src/lib/callable.ts","../../src/lib/debounce.ts","../../src/lib/forwardError.ts","../../src/lib/clone.ts","../../src/lib/propAccess.ts","../../src/lib/makeSelector.ts","../../src/lib/standardMethods.ts","../../src/lib/throttle.ts","../../src/core/store.ts"],"sourcesContent":["import type { Duration } from '../core/commonTypes';\n\nexport function calcDuration(t: Duration) {\n  if (typeof t === 'number') return t;\n  return (\n    (t.milliseconds ?? 0) +\n    (t.seconds ?? 0) * 1000 +\n    (t.minutes ?? 0) * 60 * 1000 +\n    (t.hours ?? 0) * 60 * 60 * 1000 +\n    (t.days ?? 0) * 24 * 60 * 60 * 1000\n  );\n}\n","import type { MaybePromise } from './maybePromise';\nimport type { Listener } from '@core';\n\ntype Action<T> = () => MaybePromise<T>;\n\nexport interface Queue {\n  <T>(action: Action<T>, ref?: any): Promise<T>;\n  clear: () => void;\n  whenDone: () => Promise<void>;\n  size: number;\n  getRefs: () => any[];\n}\n\nexport function queue(): Queue {\n  const q: {\n    action: Action<any>;\n    resolve: (value: any) => void;\n    reject: (error: unknown) => void;\n    ref?: any;\n  }[] = [];\n  const completionListeners = new Set<Listener<void>>();\n  let active = false;\n\n  const notify = () => {\n    for (const listener of completionListeners) {\n      listener();\n    }\n\n    completionListeners.clear();\n  };\n\n  const run = async () => {\n    if (!active) {\n      active = true;\n\n      let next;\n      while ((next = q.shift())) {\n        try {\n          let result = next.action();\n          if (result instanceof Promise) {\n            result = await result;\n          }\n\n          next.resolve(result);\n        } catch (error) {\n          next.reject(error);\n        }\n      }\n\n      active = false;\n      notify();\n    }\n  };\n\n  return Object.assign(\n    <T>(action: Action<T>, ref?: any) => {\n      return new Promise<T>((resolve, reject) => {\n        q.push({ action, resolve, reject, ref });\n        run();\n      });\n    },\n    {\n      clear() {\n        q.length = 0;\n      },\n\n      whenDone() {\n        if (!active) {\n          return Promise.resolve();\n        }\n\n        return new Promise<void>((resolve) => {\n          completionListeners.add(resolve);\n        });\n      },\n\n      get size() {\n        return q.length;\n      },\n\n      getRefs() {\n        return q.map((item) => item.ref).filter((x) => x !== undefined);\n      },\n    },\n  );\n}\n","export function defaultEqual(a: any, b: any) {\n  return a === b;\n}\n\nexport function shallowEqual(a: any, b: any): boolean {\n  return internalEqual(defaultEqual)(a, b);\n}\n\nexport function deepEqual(a: any, b: any): boolean {\n  return internalEqual(deepEqual)(a, b);\n}\n\nconst internalEqual = (comp: (a: any, b: any) => boolean) => (a: any, b: any) => {\n  if (a === b) {\n    return true;\n  }\n\n  if (a === null || b === null || typeof a !== 'object' || typeof b !== 'object') {\n    // eslint-disable-next-line no-self-compare\n    return a !== a && b !== b;\n  }\n\n  if (a.constructor !== b.constructor) {\n    return false;\n  }\n\n  if (a.constructor === Object) {\n    const entries1 = Object.entries(a);\n    const entries2 = Object.entries(b);\n    return (\n      entries1.length === entries2.length && entries1.every(([key, value]) => comp(value, b[key]))\n    );\n  }\n\n  if (Array.isArray(a)) {\n    return a.length === b.length && a.every((value, i) => comp(value, b[i]));\n  }\n\n  if (a instanceof Date) {\n    return a.getTime() === b.getTime();\n  }\n\n  if (a instanceof RegExp) {\n    return a.source === b.source && a.flags === b.flags;\n  }\n\n  if (a instanceof Map) {\n    return a.size === b.size && [...a.entries()].every(([key, value]) => comp(value, b.get(key)));\n  }\n\n  if (a instanceof Set) {\n    return a.size === b.size && [...a.values()].every((value) => b.has(value));\n  }\n\n  if (typeof ArrayBuffer !== 'undefined' && ArrayBuffer.isView(a)) {\n    if (a.byteLength !== b.byteLength) {\n      return false;\n    }\n\n    const a_ = new Int8Array(a.buffer);\n    const b_ = new Int8Array(b.buffer);\n    return a_.every((value, i) => value === b_[i]);\n  }\n\n  return false;\n};\n","import { deepEqual } from './equals';\n\nexport type TrackingProxy<T> = [value: T, equals: (newValue: T) => boolean];\ntype Object_ = Record<string | symbol, unknown>;\n\nfunction isPlainObject(value: unknown) {\n  return (\n    typeof value === 'object' && value !== null && Object.getPrototypeOf(value) === Object.prototype\n  );\n}\n\nexport function trackingProxy<T>(value: T, equals = deepEqual): TrackingProxy<T> {\n  if (!isPlainObject(value) && !Array.isArray(value)) {\n    return [value, (other) => equals(value, other)];\n  }\n\n  const deps = new Array<TrackingProxy<any>[1]>();\n\n  function trackComplexProp(function_: any, ...args: any[]) {\n    const [proxiedValue, equals] = trackingProxy(function_(value, ...args));\n\n    deps.push((otherValue) => {\n      if (!isPlainObject(otherValue) && !Array.isArray(otherValue)) {\n        return false;\n      }\n\n      return equals(function_(otherValue, ...args));\n    });\n\n    return proxiedValue;\n  }\n\n  function trackSimpleProp(function_: any, ...args: any[]) {\n    const calculatedValue = function_(value, ...args);\n\n    deps.push((otherValue) => {\n      return function_(otherValue, ...args) === calculatedValue;\n    });\n\n    return calculatedValue;\n  }\n\n  const proxy = new Proxy(value as T & Object_, {\n    get(target, p, receiver) {\n      const { writable, configurable } = Object.getOwnPropertyDescriptor(target, p) ?? {};\n      if (writable === false && configurable === false) {\n        return target[p];\n      }\n\n      return trackComplexProp(Reflect.get, p, receiver);\n    },\n\n    getOwnPropertyDescriptor(target, p) {\n      const { writable, configurable } = Object.getOwnPropertyDescriptor(target, p) ?? {};\n      if (writable === false && configurable === false) {\n        return Reflect.getOwnPropertyDescriptor(target, p);\n      }\n\n      return trackComplexProp(Reflect.getOwnPropertyDescriptor, p);\n    },\n\n    ownKeys() {\n      return trackComplexProp(Reflect.ownKeys);\n    },\n\n    getPrototypeOf() {\n      return trackSimpleProp(Reflect.getPrototypeOf);\n    },\n\n    has(_target, p) {\n      return trackSimpleProp(Reflect.has, p);\n    },\n\n    isExtensible() {\n      return trackSimpleProp(Reflect.isExtensible);\n    },\n  });\n\n  return [proxy, (other) => !!other && deps.every((equals) => equals(other))];\n}\n","import type { MaybePromise } from './maybePromise';\nimport { queue } from './queue';\nimport { trackingProxy } from './trackingProxy';\nimport { deepEqual } from './equals';\nimport type { Store } from '@core/store';\nimport type {\n  CalculationHelpers,\n  Cancel,\n  ConnectionState,\n  UpdateFrom,\n  Use,\n} from '@core/commonTypes';\n\nexport class CalculationHelper<T> {\n  private current?: {\n    cancel: Cancel;\n    check: () => void;\n    invalidateDependencies: () => void;\n  };\n\n  constructor(\n    public options: {\n      calculate: (helpers: CalculationHelpers<T>) => Cancel | void;\n      addEffect: (effect: () => Cancel | void) => Cancel;\n      getValue?: () => T | undefined;\n      onValue?: (value: T) => void;\n      onError?: (error: unknown) => void;\n      onConnectionState?: (state: ConnectionState) => void;\n      onInvalidate?: () => void;\n    },\n  ) {\n    options.addEffect(() => {\n      if (this.current) {\n        this.current.check();\n      } else {\n        this.execute();\n      }\n    });\n  }\n\n  execute() {\n    this.stop();\n\n    const { calculate, addEffect, getValue, onValue, onError, onConnectionState, onInvalidate } =\n      this.options;\n    const checks = new Array<() => boolean>();\n    const deps = new Map<Store<any>, { on: () => void; off: () => void; invalidate: () => void }>();\n    const q = queue();\n    let isActive = false;\n    let isCancled = false;\n\n    const cancelEffect = addEffect(() => {\n      isActive = true;\n\n      for (const dep of deps.values()) {\n        dep.on();\n      }\n\n      return () => {\n        isActive = false;\n\n        for (const dep of deps.values()) {\n          dep.off();\n        }\n\n        if (cancelSubscription) {\n          cancelSubscription();\n          cancelSubscription = undefined;\n          cancel();\n          onInvalidate?.();\n        }\n      };\n    });\n\n    const cancel = () => {\n      isCancled = true;\n      cancelSubscription?.();\n      cancelEffect();\n      delete this.current;\n    };\n\n    const checkAll = () => {\n      if (!checks.every((check) => check())) {\n        cancel();\n        onInvalidate?.();\n      }\n    };\n\n    const invalidateDependencies = () => {\n      for (const dep of deps.values()) {\n        dep.invalidate();\n      }\n    };\n\n    const use: Use = (store, { disableProxy } = {}) => {\n      if (isCancled) {\n        return store.get();\n      }\n\n      let value = store.get();\n      let equals = (newValue: any) => {\n        return deepEqual(newValue, value);\n      };\n\n      if (!disableProxy) {\n        [value, equals] = trackingProxy(value);\n      }\n\n      const check = () => equals(store.get());\n      let sub: Cancel | undefined;\n\n      const dep = {\n        on() {\n          this.off();\n\n          sub = store.subscribe(\n            () => {\n              if (sub && !check()) {\n                cancel();\n                onInvalidate?.();\n              }\n            },\n            { runNow: false },\n          );\n        },\n        off() {\n          sub?.();\n          sub = undefined;\n        },\n        invalidate() {\n          if ('invalidate' in store && store.invalidate instanceof Function) {\n            store.invalidate();\n          }\n        },\n      };\n\n      if (isActive) {\n        dep.on();\n      }\n\n      checks.push(check);\n      deps.set(store, dep);\n\n      return value;\n    };\n\n    const updateValue = (update: UpdateFrom<MaybePromise<T>, [T | undefined]>) =>\n      q(async () => {\n        if (isCancled) {\n          return;\n        }\n\n        if (update instanceof Function) {\n          try {\n            update = update(getValue?.());\n          } catch (error) {\n            onError?.(error);\n            return;\n          }\n        }\n\n        if (update instanceof Promise) {\n          try {\n            update = await update;\n          } catch (error) {\n            if (!isCancled) {\n              onError?.(error);\n            }\n            return;\n          }\n        }\n\n        if (!isCancled) {\n          onValue?.(update);\n        }\n      });\n\n    const updateError = (error: unknown) =>\n      q(() => {\n        if (!isCancled) {\n          onError?.(error);\n        }\n      });\n\n    const updateConnectionState = (state: ConnectionState) =>\n      q(() => {\n        if (!isCancled) {\n          onConnectionState?.(state);\n        }\n      });\n\n    let cancelSubscription: Cancel | void;\n    try {\n      cancelSubscription = calculate({ use, updateValue, updateError, updateConnectionState });\n    } catch (error) {\n      onError?.(error);\n    }\n\n    this.current = { cancel, check: checkAll, invalidateDependencies };\n  }\n\n  stop() {\n    this.current?.cancel();\n  }\n\n  check() {\n    this.current?.check();\n  }\n\n  checkOrExecute() {\n    if (this.current) {\n      this.check();\n    } else {\n      this.execute();\n    }\n  }\n\n  invalidateDependencies() {\n    this.current?.invalidateDependencies();\n  }\n}\n","export class Callable<Args extends any[], T> extends Function {\n  constructor(protected _call: (...args: Args) => T) {\n    super('...args', 'return this._call(...args)');\n\n    // eslint-disable-next-line no-constructor-return\n    return this.bind(this);\n  }\n}\n","import { calcDuration } from './calcDuration';\nimport type { Duration } from '@core';\n\nexport type DebounceOptions =\n  | Duration\n  | {\n      wait: Duration;\n      maxWait?: Duration;\n    };\n\nexport function debounce<Args extends any[]>(\n  action: (...args: Args) => void,\n  options: Duration | DebounceOptions,\n): (...args: Args) => void {\n  const wait =\n    typeof options === 'object' && 'wait' in options\n      ? calcDuration(options.wait)\n      : calcDuration(options);\n\n  const maxWait =\n    typeof options === 'object' && 'maxWait' in options && options.maxWait !== undefined\n      ? calcDuration(options.maxWait)\n      : undefined;\n\n  let timeout: ReturnType<typeof setTimeout> | undefined;\n  let timeoutStarted: number | undefined;\n\n  return (...args: Args) => {\n    const now = Date.now();\n    timeoutStarted ??= now;\n\n    const deadline = Math.min(\n      //\n      now + wait,\n      timeoutStarted + (maxWait ?? Number.POSITIVE_INFINITY),\n    );\n\n    if (timeout !== undefined) {\n      clearTimeout(timeout);\n    }\n\n    timeout = setTimeout(() => {\n      timeout = undefined;\n      timeoutStarted = undefined;\n      action(...args);\n    }, deadline - now);\n  };\n}\n","export function forwardError(error: unknown) {\n  setTimeout(() => {\n    throw error;\n  });\n}\n","export function flatClone<T>(object: T): T {\n  if (object instanceof Map) {\n    return new Map(object) as any;\n  }\n\n  if (object instanceof Set) {\n    return new Set(object) as any;\n  }\n\n  if (Array.isArray(object)) {\n    return [...object] as any;\n  }\n\n  if (object instanceof Object) {\n    return { ...object };\n  }\n\n  return object;\n}\n","import type { Update } from '../core/commonTypes';\nimport { flatClone } from './clone';\nimport type { Path, Value } from './path';\n\nexport function castArrayPath(path: string | KeyType[]): KeyType[] {\n  if (Array.isArray(path)) {\n    return path as any;\n  }\n\n  if (path === '') {\n    return [] as any;\n  }\n\n  return (path as string).split('.') as any;\n}\n\nexport function get<T, P extends Path<T>>(object: T, path: P): Value<T, P> {\n  const _path = castArrayPath(path as any);\n  const [first, ...rest] = _path;\n\n  if (first === undefined || !object) {\n    return object as Value<T, P>;\n  }\n\n  if (object instanceof Map) {\n    return get(object.get(first), rest as any);\n  }\n\n  if (object instanceof Set) {\n    return get(Array.from(object)[Number(first)], rest as any);\n  }\n\n  if (object instanceof Object) {\n    return get(object[first as keyof T], rest as any) as Value<T, P>;\n  }\n\n  throw new Error(`Could not get ${path} of ${object}`);\n}\n\nexport function set<T, P extends Path<T>>(\n  object: T,\n  path: P,\n  value: Update<Value<T, P>>,\n  rootPath = path,\n): T {\n  const _path = castArrayPath(path as any);\n  const [first, ...rest] = _path;\n\n  if (first === undefined) {\n    return value as any;\n  }\n\n  const updateChild = (child: any) => {\n    if (!child && rest.length > 0) {\n      const _rootPath = castArrayPath(rootPath as any);\n\n      const prefix = _rootPath.slice(0, -rest.length) as KeyType[];\n      throw new Error(`Cannot set ${rootPath} because ${prefix.join('.')} is ${child}`);\n    }\n\n    return set(child, rest as any, value, rootPath);\n  };\n\n  if (object instanceof Map) {\n    const copy = flatClone(object);\n    const child = copy.get(first);\n    copy.set(first, updateChild(child));\n    return copy;\n  }\n\n  if (object instanceof Set) {\n    const copy = [...object];\n    const child = copy[Number(first)];\n    copy[Number(first)] = updateChild(child);\n    return new Set(copy) as any;\n  }\n\n  if (object instanceof Object || object === undefined) {\n    const copy = flatClone(object ?? ({} as T));\n    copy[first as keyof T] = updateChild(copy[first as keyof T]);\n    return copy;\n  }\n\n  throw new Error(`Could not set ${path} of ${object}`);\n}\n\nexport function remove<T, P extends Path<T, true>>(object: T, path: P): T {\n  const _path = castArrayPath(path as any);\n\n  if (_path.length === 0) {\n    return undefined as any;\n  }\n\n  const parentPath = _path.slice(0, -1);\n  const key = _path[_path.length - 1];\n\n  const parent = flatClone(get(object, parentPath as any));\n\n  if (parent instanceof Map) {\n    parent.delete(key);\n  } else if (parent instanceof Set) {\n    const value = Array.from(parent)[Number(key)];\n    parent.delete(value);\n  } else {\n    delete parent[key as keyof typeof parent];\n  }\n\n  return set(object, parentPath as any, parent);\n}\n","import type { Path } from './path';\nimport { get } from './propAccess';\n\nexport function makeSelector<T, S>(selector?: ((value: T) => S) | Path<any>): (value: T) => S {\n  if (!selector) {\n    return (x) => x as any;\n  }\n\n  if (selector instanceof Function) {\n    return selector;\n  }\n\n  return (x) => get(x, selector as any) as any;\n}\n","import type { Store } from '../core/store';\nimport type { OptionalPropertyOf } from './typeHelpers';\n\ntype Function_ = (...args: any) => any;\n\nfunction createArrayAction<P extends keyof Array<any>>(prop: P) {\n  return function arrayAction<T extends Array<any>>(\n    this: Store<T>,\n    ...args: T[P] extends Function_ ? Parameters<T[P]> : never\n  ): T[P] extends Function_ ? ReturnType<T[P]> : never {\n    const newArray = this.get().slice() as T;\n    const result = (newArray[prop] as Function_)(...(args as any));\n    this.set(newArray);\n    return result;\n  };\n}\nexport const arrayMethods = {\n  splice: /* @__PURE__ */ createArrayAction('splice'),\n  push: /* @__PURE__ */ createArrayAction('push'),\n  pop: /* @__PURE__ */ createArrayAction('pop'),\n  shift: /* @__PURE__ */ createArrayAction('shift'),\n  unshift: /* @__PURE__ */ createArrayAction('unshift'),\n  reverse: /* @__PURE__ */ createArrayAction('reverse'),\n  sort: /* @__PURE__ */ createArrayAction('sort'),\n};\n\nexport const recordMethods = {\n  delete<T extends Record<any, any>, K extends OptionalPropertyOf<T>>(this: Store<T>, key: K) {\n    const copy = { ...this.get() };\n    delete copy[key];\n    this.set(copy);\n  },\n\n  clear<T extends Record<any, any>>(this: Store<Partial<T>>) {\n    this.set({} as T);\n  },\n};\n\nexport const mapMethods = {\n  delete<K, V>(this: Store<Map<K, V>>, key: K) {\n    const newMap = new Map(this.get());\n    const result = newMap.delete(key);\n    this.set(newMap);\n    return result;\n  },\n\n  clear<K, V>(this: Store<Map<K, V>>) {\n    this.set(new Map());\n  },\n};\n\nexport const setMethods = {\n  add<T>(this: Store<Set<T>>, value: T) {\n    const newSet = new Set(this.get());\n    newSet.add(value);\n    this.set(newSet);\n  },\n\n  delete<T>(this: Store<Set<T>>, value: T) {\n    const newSet = new Set(this.get());\n    newSet.delete(value);\n    this.set(newSet);\n  },\n\n  clear<T>(this: Store<Set<T>>) {\n    this.set(new Set());\n  },\n};\n","import { calcDuration } from './calcDuration';\nimport type { Duration } from '@core';\n\nexport function throttle<Args extends any[]>(\n  action: (...args: Args) => void,\n  duration: Duration,\n): (...args: Args) => void {\n  const ms = calcDuration(duration);\n\n  let t = 0;\n  let timeout: ReturnType<typeof setTimeout> | undefined;\n\n  return (...args: Args) => {\n    if (timeout !== undefined) {\n      clearTimeout(timeout);\n    }\n\n    const dt = t + ms - Date.now();\n    if (dt <= 0) {\n      action(...args);\n      t = Date.now();\n      return;\n    }\n\n    timeout = setTimeout(() => {\n      action(...args);\n      t = Date.now();\n    }, dt);\n  };\n}\n","import type {\n  CalculationHelpers,\n  Cancel,\n  Duration,\n  Effect,\n  Listener,\n  Selector,\n  SubscribeOptions,\n  Update,\n  Use,\n  UseOptions,\n} from './commonTypes';\nimport { calcDuration } from '@lib/calcDuration';\nimport { CalculationHelper } from '@lib/calculationHelper';\nimport { Callable } from '@lib/callable';\nimport { debounce } from '@lib/debounce';\nimport { deepEqual } from '@lib/equals';\nimport { forwardError } from '@lib/forwardError';\nimport { makeSelector } from '@lib/makeSelector';\nimport type { Path, Value } from '@lib/path';\nimport { get, set } from '@lib/propAccess';\nimport { arrayMethods, mapMethods, recordMethods, setMethods } from '@lib/standardMethods';\nimport { throttle } from '@lib/throttle';\n\nexport type StoreMethods = Record<string, (...args: any[]) => any>;\n\nexport type BoundStoreMethods<T, Methods extends StoreMethods> = Methods &\n  ThisType<Store<T> & Methods>;\n\nexport interface StoreOptions {\n  retain?: Duration;\n}\n\nexport interface StoreOptionsWithMethods<T, Methods extends StoreMethods> extends StoreOptions {\n  methods?: Methods & ThisType<Store<T> & Methods & StandardMethods<T>>;\n}\n\nexport type Calculate<T> = (this: CalculationHelpers<T>, helpers: CalculationHelpers<T>) => T;\n\ntype StandardMethods<T> = T extends Map<any, any>\n  ? typeof mapMethods\n  : T extends Set<any>\n  ? typeof setMethods\n  : T extends Array<any>\n  ? typeof arrayMethods\n  : T extends Record<any, any>\n  ? typeof recordMethods\n  : Record<string, never>;\n\ntype StoreWithMethods<T, Methods extends StoreMethods> = Store<T> &\n  Omit<BoundStoreMethods<T, Methods>, keyof Store<T>> &\n  StandardMethods<T>;\n\nfunction noop() {\n  return undefined;\n}\n\nexport class Store<T> extends Callable<any, any> {\n  protected _value?: { v: T };\n\n  protected listeners = new Map<Listener, boolean>();\n\n  protected effects = new Map<\n    Effect,\n    { handle?: Cancel; retain?: number; timeout?: ReturnType<typeof setTimeout> }\n  >();\n\n  protected notifyId = {};\n\n  protected calculationHelper = new CalculationHelper<T>({\n    calculate: (helpers) => {\n      if (this.getter instanceof Function) {\n        const value = this.getter.apply(helpers, [helpers]);\n        this._value = { v: value };\n        this.notify();\n      }\n    },\n    addEffect: (effect) => this.addEffect(effect, this.options.retain),\n    getValue: () => this._value?.v,\n    onInvalidate: () => this.reset(),\n  });\n\n  constructor(\n    public readonly getter: T | Calculate<T>,\n    public readonly options: StoreOptions = {},\n    public readonly derivedFrom?: {\n      store: Store<any>;\n      selectors: (Selector<any, any> | Path<any>)[];\n      updater: (state: any) => void;\n    },\n    protected readonly _call: (...args: any[]) => any = () => undefined,\n  ) {\n    super(_call);\n    this.get = this.get.bind(this);\n    this.set = this.set.bind(this);\n    this.subscribe = this.subscribe.bind(this);\n    this.once = this.once.bind(this);\n    this.map = this.map.bind(this);\n    this.addEffect = this.addEffect.bind(this);\n    this.isActive = this.isActive.bind(this);\n\n    if (!(getter instanceof Function)) {\n      this._value = { v: getter };\n    }\n  }\n\n  get(): T {\n    this.calculationHelper.check();\n\n    if (!this._value) {\n      this.calculationHelper.execute();\n      return this.get();\n    }\n\n    return this._value.v;\n  }\n\n  set(update: Update<T>): void;\n\n  set<P extends Path<T>>(path: P, update: Update<Value<T, P>>): void;\n\n  set(...args: any[]): void {\n    const path: any = args.length > 1 ? args[0] : [];\n    let update: Update<any> = args.length > 1 ? args[1] : args[0];\n\n    if (update instanceof Function) {\n      const before = this.get();\n      const valueBefore = get(before, path);\n      const valueAfter = update(valueBefore);\n      update = set(before, path, valueAfter);\n    } else if (path.length > 0) {\n      update = set(this.get(), path, update);\n    }\n\n    if (this.derivedFrom) {\n      this.derivedFrom.updater(update);\n      return;\n    }\n\n    this._value = { v: update };\n    this.notify();\n  }\n\n  protected reset() {\n    this._value = undefined;\n\n    if (this.isActive()) {\n      this.calculationHelper.execute();\n    }\n  }\n\n  subscribe(listener: Listener<T>, options?: SubscribeOptions): Cancel {\n    const {\n      passive,\n      runNow = true,\n      throttle: throttleOption,\n      debounce: debounceOption,\n      equals = deepEqual,\n    } = options ?? {};\n\n    let compareToValue = this._value?.v;\n    let previousValue: T | undefined;\n    let hasRun = false;\n\n    let innerListener = (force?: boolean | void) => {\n      if (!this._value) {\n        return;\n      }\n\n      const value = this._value.v;\n\n      if (!force && equals(value, compareToValue)) {\n        return;\n      }\n\n      compareToValue = value;\n      const _previousValue = previousValue;\n      previousValue = value;\n      hasRun = true;\n\n      try {\n        listener(value, _previousValue);\n      } catch (error) {\n        forwardError(error);\n      }\n    };\n\n    if (throttleOption) {\n      innerListener = throttle(innerListener, throttleOption);\n    } else if (debounceOption) {\n      innerListener = debounce(innerListener, debounceOption);\n    }\n\n    this.listeners.set(innerListener, !passive);\n    if (!passive) {\n      this.onSubscribe();\n    }\n\n    if (runNow && !hasRun) {\n      innerListener(true);\n    }\n\n    return () => {\n      this.listeners.delete(innerListener);\n      if (!passive) {\n        this.onUnsubscribe();\n      }\n    };\n  }\n\n  once<S extends T>(condition: (value: T) => value is S): Promise<S>;\n\n  once(condition?: (value: T) => boolean): Promise<T>;\n\n  once(condition: (value: T) => boolean = (value) => !!value): Promise<any> {\n    return new Promise<T>((resolve) => {\n      let stopped = false;\n      const cancel = this.subscribe(\n        (value) => {\n          if (stopped || (condition && !condition(value))) {\n            return;\n          }\n\n          resolve(value);\n          stopped = true;\n          setTimeout(() => cancel());\n        },\n        {\n          runNow: !!condition,\n        },\n      );\n    });\n  }\n\n  map<S>(\n    selector: Selector<T, S>,\n    updater?: (value: S) => Update<T>,\n    options?: UseOptions,\n  ): Store<S>;\n\n  map<P extends Path<T>>(selector: P, options?: UseOptions): Store<Value<T, P>>;\n\n  map(_selector: Selector<T, any> | Path<any>, ...args: any[]): Store<any> {\n    const updater: ((value: any) => Update<T>) | undefined =\n      _selector instanceof Function\n        ? args[0]\n        : (value) => (state) => set(state, _selector as Path<T>, value);\n\n    const options = _selector instanceof Function ? args[1] : args[0];\n\n    const selector = makeSelector(_selector);\n\n    const derivedFrom = {\n      store: this.derivedFrom ? this.derivedFrom.store : this,\n      selectors: this.derivedFrom ? [...this.derivedFrom.selectors, _selector] : [_selector],\n\n      updater: (value: any) => {\n        if (!updater) {\n          throw new TypeError(\n            'Can only updated computed stores that either are derived from other stores using string selectors or have an updater function.',\n          );\n        }\n\n        let update = updater(value);\n\n        if (update instanceof Function) {\n          update = update(this.get());\n        }\n\n        if (this.derivedFrom) {\n          this.derivedFrom.updater(update);\n        } else {\n          this.set(update);\n        }\n      },\n    };\n\n    return new Store(\n      ({ use }) => {\n        return selector(use(this, options));\n      },\n      this.options,\n      derivedFrom,\n    );\n  }\n\n  /** Add an effect that will be executed when the store becomes active, which means when it has at least one subscriber.\n   * @param effect\n   * If there is already a subscriber, the effect will be executed immediately.\n   * Otherweise it will be executed as soon as the first subscription is created.\n   * Every time all subscriptions are removed and the first is created again, the effect will be executed again.\n   * @param retain\n   * If provided, delay tearing down effects when the last subscriber is removed. This is useful if a short gap in subscriber coverage is supposed to be ignored. E.g. when switching pages, the old page might unsubscribe, while the new page subscribes immediately after.\n   * @returns\n   * The effect can return a teardown callback, which will be executed when the last subscription is removed and potentially the ratain time has passed.\n   */\n  addEffect(effect: Effect, retain?: Duration) {\n    this.effects.set(effect, {\n      handle: this.isActive() ? effect() ?? noop : undefined,\n      retain: retain !== undefined ? calcDuration(retain) : undefined,\n    });\n\n    return () => {\n      const { handle, timeout } = this.effects.get(effect) ?? {};\n      handle?.();\n\n      if (timeout !== undefined) {\n        clearTimeout(timeout);\n      }\n\n      this.effects.delete(effect);\n    };\n  }\n\n  /** Return whether the store is currently active, which means whether it has at least one subscriber. */\n  isActive() {\n    return [...this.listeners.values()].some(Boolean);\n  }\n\n  protected onSubscribe() {\n    if ([...this.listeners.values()].filter(Boolean).length > 1) return;\n\n    for (const [effect, { handle, retain, timeout }] of this.effects.entries()) {\n      if (timeout !== undefined) {\n        clearTimeout(timeout);\n      }\n\n      this.effects.set(effect, {\n        handle: handle ?? effect() ?? noop,\n        retain,\n        timeout: undefined,\n      });\n    }\n  }\n\n  protected onUnsubscribe() {\n    if ([...this.listeners.values()].some(Boolean)) return;\n\n    for (const [effect, { handle, retain, timeout }] of this.effects.entries()) {\n      if (!retain) {\n        handle?.();\n      }\n\n      if (timeout !== undefined) {\n        clearTimeout(timeout);\n      }\n\n      this.effects.set(effect, {\n        handle: retain ? handle : undefined,\n        retain,\n        timeout: retain && handle ? setTimeout(handle, retain) : undefined,\n      });\n    }\n  }\n\n  protected notify() {\n    const n = {};\n    this.notifyId = n;\n\n    const snapshot = [...this.listeners.keys()];\n    for (const listener of snapshot) {\n      listener();\n      if (n !== this.notifyId) break;\n    }\n  }\n}\n\nconst defaultOptions: StoreOptions = {};\n\nfunction create<T>(\n  calculate: (this: { use: Use }, fns: { use: Use }) => T,\n  options?: StoreOptions,\n): Store<T>;\nfunction create<T, Methods extends StoreMethods = {}>(\n  initialState: T,\n  options?: StoreOptionsWithMethods<T, Methods>,\n): StoreWithMethods<T, Methods>;\nfunction create<T, Methods extends StoreMethods>(\n  initialState: T | ((this: { use: Use }, fns: { use: Use }) => T),\n  options?: StoreOptionsWithMethods<T, Methods>,\n): StoreWithMethods<T, Methods> | Store<T> {\n  const store = new Store(initialState, options);\n\n  if (initialState instanceof Function) {\n    return store;\n  }\n\n  let methods: StoreMethods | undefined = options?.methods;\n\n  if (initialState instanceof Map) {\n    methods = { ...mapMethods, ...methods };\n  } else if (initialState instanceof Set) {\n    methods = { ...setMethods, ...methods };\n  } else if (Array.isArray(initialState)) {\n    methods = { ...arrayMethods, ...methods };\n  } else if (initialState instanceof Object) {\n    methods = { ...recordMethods, ...methods };\n  }\n\n  const boundMethods = Object.fromEntries(\n    Object.entries(methods ?? ({} as BoundStoreMethods<T, any>))\n      .filter(([name]) => !(name in store))\n      .map(([name, action]) => [name, (action as any).bind(store)]),\n  ) as BoundStoreMethods<T, any>;\n\n  return Object.assign(store, boundMethods);\n}\n\nexport const createStore = /* @__PURE__ */ Object.assign(create, { defaultOptions });\n"],"names":["equals"],"mappings":"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"}

package/dist/types/core/cache.d.ts

@@ -2,6 +2,7 @@ import type { Duration, Selector, Use } from './commonTypes';
 import { type ResourceGroup } from './resourceGroup';
 import { Store } from './store';
 import type { CacheState, ErrorState, ValueState } from '../lib/cacheState';
+import { type MaybePromise } from '../lib/maybePromise';
 import type { Path, Value } from '../lib/path';
 export interface CacheGetOptions {
     update?: 'whenMissing' | 'whenStale' | 'force';
@@ -10,7 +11,9 @@ export interface CacheGetOptions {
 export interface CacheFunction<T, Args extends any[] = []> {
     (this: {
         use: Use;
-    }, ...args: Args): Promise<T>;
+    }, ...args: Args): Promise<T> | ((cache: {
+        use: Use;
+    }) => Promise<T>);
 }
 export interface CacheOptions<T> {
     invalidateAfter?: Duration | ((state: ValueState<T> | ErrorState) => Duration | null) | null;
@@ -28,7 +31,7 @@ export declare class Cache<T> extends Store<Promise<T>> {
         selectors: (Selector<any, any> | Path<any>)[];
     } | undefined;
     readonly state: Store<CacheState<T>> & Omit<ThisType<Store<CacheState<T>>>, keyof Store<T_1>> & {
-        delete<T_2 extends Record<any, any>, K_1 extends Exclude<{ [K in keyof T_2]: T_2 extends Record<K, T_2[K]> ? never : K; }[keyof T_2], undefined>>(this: Store<T_2>, key: K_1): void;
+        delete<T_2 extends Record<any, any>, K extends import("../lib/typeHelpers").OptionalPropertyOf<T_2>>(this: Store<T_2>, key: K): void;
         clear<T_3 extends Record<any, any>>(this: Store<Partial<T_3>>): void;
     };
     protected stalePromise?: Promise<T>;
@@ -38,6 +41,8 @@ export declare class Cache<T> extends Store<Promise<T>> {
         selectors: (Selector<any, any> | Path<any>)[];
     } | undefined, _call?: (...args: any[]) => any);
     get({ update, backgroundUpdate }?: CacheGetOptions): Promise<T>;
+    updateValue(value: MaybePromise<T>): void;
+    updateError(error: unknown): void;
     invalidate({ invalidateDependencies }?: {
         invalidateDependencies?: boolean;
     }): void;

package/dist/types/core/commonTypes.d.ts

@@ -1,5 +1,6 @@
 import type { Store } from './store';
 import type { DebounceOptions } from '../lib/debounce';
+import { type MaybePromise } from '../lib/maybePromise';
 export interface Listener<T = void> {
     (value: T, previouseValue?: T): void;
 }
@@ -49,3 +50,10 @@ export interface UseOptions {
 export interface Use {
     <T>(store: Store<T>, options?: UseOptions): T;
 }
+export type ConnectionState = 'connecting' | 'open' | 'closing' | 'closed';
+export interface CalculationHelpers<T> {
+    use: Use;
+    updateValue: (update: UpdateFrom<MaybePromise<T>, [T | undefined]>) => void;
+    updateError: (error: unknown) => void;
+    updateConnectionState: (state: ConnectionState) => void;
+}

package/dist/types/core/index.d.ts

@@ -1,7 +1,7 @@
-export type { CacheFunction, CacheGetOptions, CacheOptions } from './cache';
-export { Cache, createCache } from './cache';
+export { Cache, createCache, type CacheFunction, type CacheGetOptions, type CacheOptions, } from './cache';
 export type { Cancel, Duration, Effect, Listener, SubscribeOptions } from './commonTypes';
-export type { Resource } from './resourceGroup';
-export { allResources, createResourceGroup, ResourceGroup } from './resourceGroup';
-export type { BoundStoreMethods, StoreMethods, StoreOptions, StoreOptionsWithMethods, } from './store';
-export { createStore, Store } from './store';
+export { ResourceGroup, allResources, createResourceGroup, type Resource } from './resourceGroup';
+export { Scope, createScope } from './scope';
+export { Store, createStore, type BoundStoreMethods, type StoreMethods, type StoreOptions, type StoreOptionsWithMethods, } from './store';
+export { SubstriptionCache, createSubscriptionCache, type SubscriptionCacheFunction, type SubstriptionCacheOptions, } from './subscriptionCache';
+export { createUrlStore, type UrlStore, type UrlStoreOptions } from './urlStore';

package/dist/types/core/resourceGroup.d.ts

@@ -1,6 +1,6 @@
 export interface Resource {
-    invalidate(): void;
-    clear(): void;
+    invalidateAll(): void;
+    clearAll(): void;
 }
 export declare class ResourceGroup {
     readonly name?: string | undefined;

package/dist/types/core/scope.d.ts

@@ -0,0 +1,5 @@
+export declare class Scope<T> {
+    readonly defaultValue: T;
+    constructor(defaultValue: T);
+}
+export declare function createScope<T>(defaultValue: T): Scope<T>;

package/dist/types/core/store.d.ts

@@ -1,4 +1,4 @@
-import type { Cancel, Duration, Effect, Listener, Selector, SubscribeOptions, Update, Use, UseOptions } from './commonTypes';
+import type { CalculationHelpers, Cancel, Duration, Effect, Listener, Selector, SubscribeOptions, Update, Use, UseOptions } from './commonTypes';
 import { CalculationHelper } from '../lib/calculationHelper';
 import { Callable } from '../lib/callable';
 import type { Path, Value } from '../lib/path';
@@ -6,16 +6,12 @@ import { arrayMethods, mapMethods, recordMethods, setMethods } from '../lib/stan
 export type StoreMethods = Record<string, (...args: any[]) => any>;
 export type BoundStoreMethods<T, Methods extends StoreMethods> = Methods & ThisType<Store<T> & Methods>;
 export interface StoreOptions {
-    retain?: number;
+    retain?: Duration;
 }
 export interface StoreOptionsWithMethods<T, Methods extends StoreMethods> extends StoreOptions {
     methods?: Methods & ThisType<Store<T> & Methods & StandardMethods<T>>;
 }
-export type Calculate<T> = (this: {
-    use: Use;
-}, fns: {
-    use: Use;
-}) => T;
+export type Calculate<T> = (this: CalculationHelpers<T>, helpers: CalculationHelpers<T>) => T;
 type StandardMethods<T> = T extends Map<any, any> ? typeof mapMethods : T extends Set<any> ? typeof setMethods : T extends Array<any> ? typeof arrayMethods : T extends Record<any, any> ? typeof recordMethods : Record<string, never>;
 type StoreWithMethods<T, Methods extends StoreMethods> = Store<T> & Omit<BoundStoreMethods<T, Methods>, keyof Store<T>> & StandardMethods<T>;
 export declare class Store<T> extends Callable<any, any> {
@@ -24,6 +20,7 @@ export declare class Store<T> extends Callable<any, any> {
     readonly derivedFrom?: {
         store: Store<any>;
         selectors: (Selector<any, any> | Path<any>)[];
+        updater: (state: any) => void;
     } | undefined;
     protected readonly _call: (...args: any[]) => any;
     protected _value?: {
@@ -36,19 +33,20 @@ export declare class Store<T> extends Callable<any, any> {
         timeout?: number | undefined;
     }>;
     protected notifyId: {};
-    protected calculationHelper: CalculationHelper<unknown>;
+    protected calculationHelper: CalculationHelper<T>;
     constructor(getter: T | Calculate<T>, options?: StoreOptions, derivedFrom?: {
         store: Store<any>;
         selectors: (Selector<any, any> | Path<any>)[];
+        updater: (state: any) => void;
     } | undefined, _call?: (...args: any[]) => any);
     get(): T;
     set(update: Update<T>): void;
     set<P extends Path<T>>(path: P, update: Update<Value<T, P>>): void;
     protected reset(): void;
-    sub(listener: Listener<T>, options?: SubscribeOptions): Cancel;
+    subscribe(listener: Listener<T>, options?: SubscribeOptions): Cancel;
     once<S extends T>(condition: (value: T) => value is S): Promise<S>;
     once(condition?: (value: T) => boolean): Promise<T>;
-    map<S>(selector: Selector<T, S>, options?: UseOptions): Store<S>;
+    map<S>(selector: Selector<T, S>, updater?: (value: S) => Update<T>, options?: UseOptions): Store<S>;
     map<P extends Path<T>>(selector: P, options?: UseOptions): Store<Value<T, P>>;
     /** Add an effect that will be executed when the store becomes active, which means when it has at least one subscriber.
      * @param effect

package/dist/types/core/subscriptionCache.d.ts

@@ -0,0 +1,51 @@
+import { type CalculationHelpers, type Cancel, type ConnectionState, type Duration, type Selector } from './commonTypes';
+import { type ResourceGroup } from './resourceGroup';
+import { Store } from './store';
+import { type Path } from '../lib/path';
+export interface SubscriptionCacheFunction<T, Args extends any[] = []> {
+    (this: CalculationHelpers<T | undefined>, ...args: Args): Cancel | void | ((cache: CalculationHelpers<T | undefined>) => Cancel | void);
+}
+export interface SubstriptionCacheOptions {
+    clearOnInvalidate?: boolean;
+    clearUnusedAfter?: Duration | null;
+    resourceGroup?: ResourceGroup | ResourceGroup[];
+    retain?: Duration;
+}
+export declare class SubstriptionCache<T> extends Store<T | undefined> {
+    readonly connectFunction: SubscriptionCacheFunction<T>;
+    readonly options: SubstriptionCacheOptions;
+    readonly derivedFromSubscriptionCache?: {
+        subscriptionCache: SubstriptionCache<any>;
+        selectors: (Selector<any, any> | Path<any>)[];
+    } | undefined;
+    readonly state: Store<{
+        connectionState: ConnectionState;
+        error: unknown;
+    }> & Omit<ThisType<Store<{
+        connectionState: ConnectionState;
+        error: unknown;
+    }>>, keyof Store<T_1>> & {
+        delete<T_2 extends Record<any, any>, K extends import("../lib/typeHelpers").OptionalPropertyOf<T_2>>(this: Store<T_2>, key: K): void;
+        clear<T_3 extends Record<any, any>>(this: Store<Partial<T_3>>): void;
+    };
+    constructor(connectFunction: SubscriptionCacheFunction<T>, options?: SubstriptionCacheOptions, derivedFromSubscriptionCache?: {
+        subscriptionCache: SubstriptionCache<any>;
+        selectors: (Selector<any, any> | Path<any>)[];
+    } | undefined, _call?: (...args: any[]) => any);
+    invalidate({ invalidateDependencies }?: {
+        invalidateDependencies?: boolean;
+    }): void;
+    clear({ invalidateDependencies }?: {
+        invalidateDependencies?: boolean;
+    }): void;
+}
+type CreateReturnType<T, Args extends any[]> = {
+    (...args: Args): SubstriptionCache<T>;
+    invalidateAll: () => void;
+    clearAll: () => void;
+} & ([] extends Args ? SubstriptionCache<T> : {});
+declare function create<T, Args extends any[] = []>(cacheFunction: SubscriptionCacheFunction<T, Args>, options?: SubstriptionCacheOptions): CreateReturnType<T, Args>;
+export declare const createSubscriptionCache: typeof create & {
+    defaultOptions: SubstriptionCacheOptions;
+};
+export {};

package/dist/types/core/urlStore.d.ts

@@ -0,0 +1,26 @@
+import { type Update } from './commonTypes';
+import { Store, type StoreOptions } from './store';
+import { type Path, type Value } from '../lib/path';
+export interface UrlStoreOptions<T> extends StoreOptions {
+    key: string;
+    type?: 'search' | 'hash';
+    serialize?: (value: T) => string;
+    deserialize?: (value: string) => T;
+    defaultValue?: T;
+    onCommit?: (value: T | undefined) => void;
+}
+export interface UrlStoreOptionsWithDefaults<T> extends UrlStoreOptions<T> {
+    defaultValue: T;
+}
+export type UrlStoreOptionsRequired<T> = UrlStoreOptions<T> & Required<Pick<UrlStoreOptions<T>, 'type' | 'serialize' | 'deserialize' | 'defaultValue'>>;
+export declare class UrlStore<T> extends Store<T> {
+    readonly options: UrlStoreOptionsRequired<T>;
+    private serializedDefaultValue;
+    constructor(options: UrlStoreOptionsRequired<T>);
+    set(update: Update<T>): void;
+    set<P extends Path<T>>(path: P, update: Update<Value<T, P>>): void;
+    protected watchUrl(): () => void;
+    protected updateUrl(value: T | undefined): void;
+}
+export declare function createUrlStore<T>(options: UrlStoreOptionsWithDefaults<T>): UrlStore<T>;
+export declare function createUrlStore<T>(options: UrlStoreOptions<T>): UrlStore<T | undefined>;

package/dist/types/immer/immerMethods.d.ts

@@ -0,0 +1,10 @@
+import type { Draft } from 'immer';
+import type { Store } from '../core/store';
+import { type Path, type Value } from '../lib/path';
+type Recipe<T> = (draft: Draft<T>) => void;
+declare function update<T>(this: Store<T>, recipe: Recipe<T>): void;
+declare function update<T, P extends Path<T>>(this: Store<T>, path: P, recipe: Recipe<Value<T, P>>): void;
+export declare const immerMethods: {
+    update: typeof update;
+};
+export {};

package/dist/types/immer/index.d.ts

@@ -1 +1 @@
-export { immerActions } from './immerActions';
+export { immerMethods } from './immerMethods';

package/dist/types/immer/register.d.ts

@@ -0,0 +1,7 @@
+import { immerMethods } from './immerMethods';
+type ImmerMethods = typeof immerMethods;
+declare module '../core' {
+    interface Store<T> extends ImmerMethods {
+    }
+}
+export {};

package/dist/types/index.d.ts

@@ -1,4 +1,6 @@
 export * from './core';
-export { InstanceCache } from './lib/instanceCache';
 export { calcDuration } from './lib/calcDuration';
+export { InstanceCache } from './lib/instanceCache';
 export { arrayMethods, mapMethods, recordMethods, setMethods } from './lib/standardMethods';
+export * from './lib/updateHelpers';
+export * from './persist';

package/dist/types/lib/calculationHelper.d.ts

@@ -1,22 +1,27 @@
-import type { MaybePromise } from './maybePromise';
-import type { Cancel, UpdateFrom, Use } from '../core/commonTypes';
+import type { CalculationHelpers, Cancel, ConnectionState } from '../core/commonTypes';
 export declare class CalculationHelper<T> {
-    private options;
+    options: {
+        calculate: (helpers: CalculationHelpers<T>) => Cancel | void;
+        addEffect: (effect: () => Cancel | void) => Cancel;
+        getValue?: () => T | undefined;
+        onValue?: (value: T) => void;
+        onError?: (error: unknown) => void;
+        onConnectionState?: (state: ConnectionState) => void;
+        onInvalidate?: () => void;
+    };
     private current?;
     constructor(options: {
-        calculate: (fns: {
-            use: Use;
-            updateValue: (update: UpdateFrom<MaybePromise<T>, [T | undefined]>) => void;
-            updateError: (error: unknown) => void;
-        }) => Cancel | void;
+        calculate: (helpers: CalculationHelpers<T>) => Cancel | void;
         addEffect: (effect: () => Cancel | void) => Cancel;
         getValue?: () => T | undefined;
-        setValue?: (value: T) => void;
-        setError?: (error: unknown) => void;
+        onValue?: (value: T) => void;
+        onError?: (error: unknown) => void;
+        onConnectionState?: (state: ConnectionState) => void;
         onInvalidate?: () => void;
     });
     execute(): void;
     stop(): void;
     check(): void;
+    checkOrExecute(): void;
     invalidateDependencies(): void;
 }

package/dist/types/lib/equals.d.ts

@@ -1,3 +1,3 @@
-export declare function defaultEquals(a: any, b: any): boolean;
-export declare function simpleShallowEquals(a: any, b: any): boolean;
-export declare function simpleDeepEquals(a: any, b: any): boolean;
+export declare function defaultEqual(a: any, b: any): boolean;
+export declare function shallowEqual(a: any, b: any): boolean;
+export declare function deepEqual(a: any, b: any): boolean;

package/dist/types/lib/path.d.ts

@@ -1,12 +1,12 @@
-import type { ArrayToStringPath, Array_, Object_, OptionalPropertyOf, StringToArrayPath, StringToNumber } from './typeHelpers';
-export type KeyType = string | number;
+import type { ArrayToStringPath, Array_, IsAny, IsNever, Object_, OptionalPropertyOf, StringToArrayPath, StringToNumber } from './typeHelpers';
+export type KeyType = string | number | symbol;
 export type GetKeys<T extends Object_ | Array_> = T extends Array_ ? T extends readonly [] ? never : '0' extends keyof T ? StringToNumber<keyof T> : number : keyof T;
 export type PathAsArray<T, Optional = false> = 0 extends 1 & T ? KeyType[] : T extends never ? never : T extends Object_ | Array_ ? {
     [K in GetKeys<T>]: (Optional extends true ? (K extends OptionalPropertyOf<T> ? [K] : never) : [K]) | [K, ...PathAsArray<T[K], Optional>];
 }[GetKeys<T>] : T extends Map<infer K extends KeyType, infer V> ? [K] | [K, ...PathAsArray<V, Optional>] : T extends Set<any> ? [number] : never;
 export type PathAsString<T, Optional = false> = ArrayToStringPath<PathAsArray<T, Optional>>;
 export type Path<T, Optional = false> = PathAsString<T, Optional> | PathAsArray<T, Optional>;
-export type Value<T, P> = 0 extends 1 & T ? any : P extends string ? Value<T, StringToArrayPath<P>> : P extends [infer First extends KeyType, ...infer Rest extends KeyType[]] ? T extends Object_ ? Record<any, any> extends T ? Value<T[First], Rest> | undefined : Value<T[First], Rest> : T extends Array_ ? any[] extends T ? Value<T[First & keyof T], Rest> | undefined : Value<T[First & keyof T], Rest> : T extends Map<any, infer V> | Set<infer V> ? Value<V, Rest> | undefined : never : T;
+export type Value<T, P> = true extends IsAny<T> | IsAny<P> ? any : true extends IsNever<T> | IsNever<P> ? never : P extends string ? Value<T, StringToArrayPath<P>> : P extends [infer First extends KeyType, ...infer Rest extends KeyType[]] ? T extends Object_ ? Record<any, any> extends T ? Value<T[First], Rest> | undefined : Value<T[First], Rest> : T extends Array_ ? any[] extends T ? Value<T[First & keyof T], Rest> | undefined : Value<T[First & keyof T], Rest> : T extends Map<any, infer V> | Set<infer V> ? Value<V, Rest> | undefined : never : T;
 export type WildcardPathAsArray<T> = [] | (0 extends 1 & T ? KeyType[] : T extends never ? never : T extends Object_ | Array_ ? {
     [K in GetKeys<T>]: ['*'] | [K] | [K, ...WildcardPathAsArray<T[K]>];
 }[GetKeys<T>] : T extends Map<infer K extends KeyType, infer V> ? ['*'] | [K] | [K, ...WildcardPathAsArray<V>] : T extends Set<any> ? ['*'] | [number] : never);

package/dist/types/lib/promiseWithState.d.ts

@@ -0,0 +1,9 @@
+import { type ErrorState, type PendingState, type ValueState } from './cacheState';
+import { type MaybePromise } from './maybePromise';
+export declare class PromiseWithState<T> extends Promise<T> {
+    state: ValueState<T> | ErrorState | PendingState;
+    static resolve(): PromiseWithState<void>;
+    static resolve<T>(value: MaybePromise<T>): PromiseWithState<T>;
+    static reject<T = never>(error: unknown): PromiseWithState<T>;
+    constructor(value: Promise<T>, state?: ValueState<T> | ErrorState | PendingState);
+}

package/dist/types/lib/standardMethods.d.ts

@@ -1,4 +1,5 @@
 import type { Store } from '../core/store';
+import type { OptionalPropertyOf } from './typeHelpers';
 type Function_ = (...args: any) => any;
 export declare const arrayMethods: {
     splice: <T extends any[]>(this: Store<T>, ...args: T["splice"] extends Function_ ? Parameters<T["splice"]> : never) => T["splice"] extends Function_ ? ReturnType<T["splice"]> : never;
@@ -10,7 +11,7 @@ export declare const arrayMethods: {
     sort: <T_6 extends any[]>(this: Store<T_6>, ...args: T_6["sort"] extends Function_ ? Parameters<T_6["sort"]> : never) => T_6["sort"] extends Function_ ? ReturnType<T_6["sort"]> : never;
 };
 export declare const recordMethods: {
-    delete<T extends Record<any, any>, K_1 extends Exclude<{ [K in keyof T]: T extends Record<K, T[K]> ? never : K; }[keyof T], undefined>>(this: Store<T>, key: K_1): void;
+    delete<T extends Record<any, any>, K extends OptionalPropertyOf<T>>(this: Store<T>, key: K): void;
     clear<T_1 extends Record<any, any>>(this: Store<Partial<T_1>>): void;
 };
 export declare const mapMethods: {

package/dist/types/lib/trackingProxy.d.ts

@@ -1,2 +1,3 @@
+import { deepEqual } from './equals';
 export type TrackingProxy<T> = [value: T, equals: (newValue: T) => boolean];
-export declare function trackingProxy<T>(value: T): TrackingProxy<T>;
+export declare function trackingProxy<T>(value: T, equals?: typeof deepEqual): TrackingProxy<T>;

package/dist/types/lib/typeHelpers.d.ts

@@ -1,4 +1,4 @@
-export type Object_ = Record<string | number, unknown>;
+export type Object_ = Record<string | number | symbol, unknown>;
 export type Array_ = readonly unknown[];
 export type StringToNumber<T> = T extends `${infer K extends number}` ? K : never;
 export type ArrayToStringPath<T> = T extends [] ? '' : T extends [infer First extends string, ...infer Rest] ? First extends `${string}.${string}` ? never : Rest['length'] extends 0 ? First : `${First}.${ArrayToStringPath<Rest>}` : never;
@@ -6,3 +6,5 @@ export type StringToArrayPath<T> = T extends '' ? [] : T extends `${infer First}
 export type OptionalPropertyOf<T> = Exclude<{
     [K in keyof T]: T extends Record<K, T[K]> ? never : K;
 }[keyof T], undefined>;
+export type IsAny<T> = 0 extends 1 & T ? true : false;
+export type IsNever<T> = [T] extends [never] ? true : false;

package/dist/types/lib/updateHelpers.d.ts

@@ -0,0 +1 @@
+export declare function findOrDefault<T>(array: T[], predicate: (item: T) => boolean, defaultValue: T | (() => T)): T;

package/dist/types/react/index.d.ts

@@ -1,5 +1,7 @@
+export { reactMethods } from './reactMethods';
 export { read } from './read';
-export { type StoreScopeProps, StoreScopeProvider, useStoreScope } from './storeScope';
+export { ScopeProvider, useScope, type ScopeProps } from './scope';
 export { useCache, type UseCacheArray, type UseCacheValue } from './useCache';
+export { useDecoupledState, type UseDecoupledStateOptions } from './useDecoupledState';
 export { useProp } from './useProp';
 export { useStore, type UseStoreOptions } from './useStore';

package/dist/types/react/reactMethods.d.ts

@@ -0,0 +1,9 @@
+import { type UseStoreOptions } from './useStore';
+import type { Store } from '../core/store';
+export declare const reactMethods: {
+    useStore<T>(this: Store<T>, options?: UseStoreOptions): T;
+    useProp<T_1>(this: Store<T_1>, options?: UseStoreOptions): [value: T_1, setValue: {
+        (update: import("../core/commonTypes").Update<T_1>): void;
+        <P extends import("../lib/path").Path<T_1>>(path: P, update: import("../core/commonTypes").Update<import("../lib/path").Value<T_1, P>>): void;
+    }];
+};

package/dist/types/react/register.d.ts

@@ -0,0 +1,29 @@
+import { reactMethods } from './reactMethods';
+import { type ScopeProps } from './scope';
+import { type UseCacheOptions } from './useCache';
+import { type UseStoreOptions } from './useStore';
+import { Cache, Scope, Store } from '../core';
+type StoreMethods = typeof reactMethods;
+type CacheMethods = typeof cacheMethods;
+type ScopeMethods = typeof scopeMethods;
+declare module '../core' {
+    interface Store<T> extends StoreMethods {
+    }
+    interface Cache<T> extends CacheMethods {
+    }
+    interface Scope<T> extends ScopeMethods {
+    }
+}
+declare const cacheMethods: {
+    useCache<T>(this: Cache<T>, options?: UseCacheOptions): import("./useCache").UseCacheValue<T>;
+};
+declare const scopeMethods: {
+    useScope<T>(this: Scope<T>): Store<T>;
+    useStore<T_1>(this: Scope<T_1>, options?: UseStoreOptions): T_1;
+    useProp<T_2>(this: Scope<T_2>, options?: UseStoreOptions): [value: T_2, setValue: {
+        (update: import("../core/commonTypes").Update<T_2>): void;
+        <P extends import("../lib/path").Path<T_2>>(path: P, update: import("../core/commonTypes").Update<import("../lib/path").Value<T_2, P>>): void;
+    }];
+    Provider<T_3>(this: Scope<T_3>, props: Omit<ScopeProps<T_3>, "scope">): JSX.Element;
+};
+export {};

package/dist/types/react/scope.d.ts

@@ -0,0 +1,16 @@
+import type { ReactNode } from 'react';
+import { type UseStoreOptions } from './useStore';
+import type { Store } from '../core/store';
+import type { Scope } from '../core';
+export type ScopeProps<T> = {
+    scope: Scope<T>;
+    store?: Store<T>;
+    children?: ReactNode;
+};
+export declare function ScopeProvider<T>({ scope, store: inputStore, children }: ScopeProps<T>): JSX.Element;
+export declare function useScope<T>(scope: Scope<T>): Store<T>;
+export declare function useScopeStore<T>(scope: Scope<T>, options?: UseStoreOptions): T;
+export declare function useScopeProp<T>(scope: Scope<T>, options?: UseStoreOptions): [value: T, setValue: {
+    (update: import("../core/commonTypes").Update<T>): void;
+    <P extends import("../lib/path").Path<T>>(path: P, update: import("../core/commonTypes").Update<import("../lib/path").Value<T, P>>): void;
+}];

package/dist/types/react/useCache.d.ts

@@ -10,5 +10,6 @@ export type UseCacheArray<T> = [
 export type UseCacheValue<T> = UseCacheArray<T> & CacheState<T>;
 export interface UseCacheOptions extends UseStoreOptions {
     passive?: boolean;
+    updateOnMount?: boolean;
 }
-export declare function useCache<T>(cache: Cache<T>, { passive, ...options }?: UseCacheOptions): UseCacheValue<T>;
+export declare function useCache<T>(cache: Cache<T>, { passive, updateOnMount, ...options }?: UseCacheOptions): UseCacheValue<T>;

package/dist/types/react/useDecoupledState.d.ts

@@ -0,0 +1,7 @@
+import { type Duration } from '../core';
+export interface UseDecoupledStateOptions<T> {
+    debounce?: Duration;
+    throttle?: Duration;
+    onCommit?: (value: T) => void;
+}
+export declare function useDecoupledState<T>(value: T, onChange: (value: T) => void, options?: UseDecoupledStateOptions<T>): [state: T, setState: (value: T) => void];

package/dist/types/react/useProp.d.ts

@@ -1,4 +1,3 @@
 import type { UseStoreOptions } from './useStore';
 import type { Store } from '../core/store';
-import type { UpdateFunction } from '../core/commonTypes';
-export declare function useProp<T>(store: Store<T>, options?: UseStoreOptions): [value: T, setValue: UpdateFunction<T>];
+export declare function useProp<T>(store: Store<T>, options?: UseStoreOptions): [value: T, setValue: typeof store.set];