cross-state 1.0.1 → 1.1.0

package/dist/{storeMethods-CQhXlHpl.js → storeMethods-CNx6pQ_S.js}

@@ -1,5 +1,5 @@
 import { l as makeSelector, n as createStore } from "./store-v3RYWzVg.js";
-import { c as deepEqual, s as isPlainObject } from "./propAccess-DvWFpYoj.js";
+import { c as deepEqual, s as isPlainObject, u as strictEqual } from "./propAccess-DvWFpYoj.js";
 import { t as isAnyPath } from "./path-CyYq74W8.js";
 import { createContext, useCallback, useContext, useDebugValue, useEffect, useLayoutEffect, useMemo, useRef, useSyncExternalStore } from "react";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
@@ -83,23 +83,30 @@ function useStore(store, ...args) {
 		selectorRaw = args[0];
 		allOptions = args[1] ?? {};
 	} else allOptions = args[0] ?? {};
-	const selector = useMemo(() => makeSelector(selectorRaw), [selectorRaw]);
+	const selectorMemoized = useMemoEquals(selectorRaw);
+	const selector = useMemo(() => makeSelector(selectorMemoized), [selectorMemoized]);
 	const lastEqualsRef = useRef(void 0);
 	if (store.derivedFrom) return useStore(store.derivedFrom.store, (value$1) => {
 		for (const selector$1 of store.derivedFrom.selectors) value$1 = makeSelector(selector$1)(value$1);
 		return selector(value$1);
 	}, allOptions);
-	const { disableTrackingProxy = true, equals = store.options.equals ?? deepEqual, withViewTransition,...options } = allOptions;
+	const { enableTrackingProxy, equals = store.options.equals ?? deepEqual, withViewTransition, storeValueEquals = strictEqual,...options } = allOptions;
 	const snapshot = useRef(void 0);
 	const get = useCallback(() => {
 		const storeValue = store.get();
+		if (snapshot.current && storeValueEquals(storeValue, snapshot.current.storeValue) && selector === snapshot.current.selector) return snapshot.current.selectedValue;
 		const selectedValue = selector(storeValue);
-		if (!snapshot.current || storeValue !== snapshot.current.storeValue && !(lastEqualsRef.current?.(selectedValue) ?? false)) snapshot.current = {
+		if (!(lastEqualsRef.current?.(selectedValue) ?? false)) snapshot.current = {
 			storeValue,
+			selector,
 			selectedValue
 		};
 		return snapshot.current.selectedValue;
-	}, [store, selector]);
+	}, [
+		store,
+		storeValueEquals,
+		selector
+	]);
 	const subOptions = useMemoEquals({
 		...options,
 		runNow: false
@@ -145,7 +152,7 @@ function useStore(store, ...args) {
 	]), get, get);
 	let lastEquals = (newValue) => equals(newValue, value);
 	let revoke;
-	if (!disableTrackingProxy) [value, lastEquals, revoke] = trackingProxy(value, equals);
+	if (enableTrackingProxy) [value, lastEquals, revoke] = trackingProxy(value, equals);
 	useLayoutEffect(() => {
 		lastEqualsRef.current = lastEquals;
 		revoke?.();
@@ -368,4 +375,4 @@ const storeMethods = {
 
 //#endregion
 export { useProp as a, cacheMethods as c, useLoadingBoundary as d, useStore as f, useScope as i, useCache as l, scopeMethods as n, useLatestFunction as o, useMemoEquals as p, ScopeProvider as r, useLatestRef as s, storeMethods as t, LoadingBoundary as u };
-//# sourceMappingURL=storeMethods-CQhXlHpl.js.map
+//# sourceMappingURL=storeMethods-CNx6pQ_S.js.map

package/dist/storeMethods-CNx6pQ_S.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storeMethods-CNx6pQ_S.js","names":["equals","selectorRaw: Selector<T, S> | AnyPath | undefined","allOptions: UseStoreOptionsWithSelector<T, S>","selector","value","_listener: (value: any) => void","lastObservedValue: any","revoke: (() => void) | undefined","rootCache: Cache<any, any>","selector","selector: Selector<T, S> | AnyPath | undefined","updater: ((value: S) => Update<T>) | undefined","options: UseStoreOptions<S> | undefined","_store: Store<any>","scopeMethods: {\n  useScope: typeof boundUseScope;\n  useStore: typeof boundUseScopeStore;\n  useProp: typeof boundUseScopeProp;\n  Provider: typeof Provider;\n}","storeMethods: {\n  useStore: typeof boundUseStore;\n  useProp: typeof boundUseProp;\n}"],"sources":["../src/lib/trackingProxy.ts","../src/react/lib/useMemoEquals.ts","../src/react/useStore.ts","../src/react/loadingBoundary.tsx","../src/react/useCache.ts","../src/react/cacheMethods.ts","../src/react/lib/useLatestRef.ts","../src/react/lib/useLatestFunction.ts","../src/react/useProp.ts","../src/react/scope.tsx","../src/react/scopeMethods.ts","../src/react/storeMethods.ts"],"sourcesContent":["import { isPlainObject } from '@lib/helpers';\nimport { deepEqual } from './equals';\n\nconst unwrapProxySymbol = /* @__PURE__ */ Symbol('unwrapProxy');\n\nexport type TrackingProxy<T> = [value: T, equals: (newValue: T) => boolean, revoke?: () => void];\ntype Object_ = Record<string | symbol, unknown>;\n\nexport function trackingProxy<T>(\n  value: T,\n  equals: (a: any, b: any) => boolean = deepEqual,\n): TrackingProxy<T> {\n  if (!isPlainObject(value) && !Array.isArray(value)) {\n    return [value, (other) => equals(value, other)];\n  }\n\n  // Unpack proxies, we don't want to nest them\n  value = (value as any)[unwrapProxySymbol] ?? value;\n\n  const deps = new Array<TrackingProxy<any>[1]>();\n  const revokations = new Array<() => void>();\n  let revoked = false;\n\n  function trackComplexProp(function_: any, ...args: any[]) {\n    const [proxiedValue, equals, revoke] = 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    if (revoke) {\n      revokations.push(revoke);\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      if (p === unwrapProxySymbol) {\n        return value;\n      }\n\n      if (revoked) {\n        return target[p];\n      }\n\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 [\n    proxy,\n    (other) => !!other && deps.every((equals) => equals(other)),\n    () => {\n      revoked = true;\n      revokations.forEach((revoke) => revoke());\n    },\n  ];\n}\n","import { deepEqual } from '@lib/equals';\nimport { useEffect, useRef } from 'react';\n\nexport default function useMemoEquals<T>(value: T, equals: (a: T, b: T) => boolean = deepEqual): T {\n  const ref = useRef<{ value: T }>(undefined);\n  const hasChanged = !ref.current || !equals(ref.current.value, value);\n\n  useEffect(() => {\n    if (hasChanged) {\n      ref.current = { value };\n    }\n  });\n\n  return hasChanged ? value : ref.current!.value;\n}\n","import type { Selector, SubscribeOptions } from '@core/commonTypes';\nimport type { Store } from '@core/store';\nimport type { Constrain } from '@lib/constrain';\nimport { deepEqual, strictEqual } from '@lib/equals';\nimport { makeSelector } from '@lib/makeSelector';\nimport { isAnyPath, type AnyPath, type Path, type Value } from '@lib/path';\nimport { trackingProxy } from '@lib/trackingProxy';\nimport useMemoEquals from '@react/lib/useMemoEquals';\nimport {\n  useCallback,\n  useDebugValue,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n  useSyncExternalStore,\n} from 'react';\n\nexport interface UseStoreOptions<T> extends Omit<SubscribeOptions, 'runNow' | 'passive'> {\n  /**\n   * If true, the cache content can be consumed but no fetch will be triggered.\n   * @default false\n   */\n\n  passive?: boolean;\n\n  /**\n   * (experimental) If true, the a rerender will only be triggered when a property of the returned value changes that was\n   * actually accessed during the last render.\n   * @default false\n   */\n  enableTrackingProxy?: boolean;\n\n  /**\n   * (experimental) If provided, a rerender will be wrapped in a browser view transition.\n   */\n  withViewTransition?: boolean | ((value: T) => unknown);\n}\n\nexport interface UseStoreOptionsWithSelector<T, S> extends UseStoreOptions<S> {\n  /**\n   * Equality function to compare the raw store values before reevaluating the selector.\n   * Can be used to avoid unnecessary selector evaluations.\n   * @default strictEqual\n   */\n  storeValueEquals?: (newValue: T, oldValue: T) => boolean;\n}\n\nexport function useStore<T, S>(\n  store: Store<T>,\n  selector: Selector<T, S>,\n  option?: UseStoreOptionsWithSelector<T, S>,\n): S;\n\nexport function useStore<T, const P>(\n  store: Store<T>,\n  selector: Constrain<P, Path<T>>,\n  option?: UseStoreOptionsWithSelector<T, Value<T, P>>,\n): Value<T, P>;\n\nexport function useStore<T>(store: Store<T>, option?: UseStoreOptions<T>): T;\n\nexport function useStore<T, S>(\n  store: Store<T>,\n  ...args:\n    | [Selector<T, S> | AnyPath, UseStoreOptionsWithSelector<T, S>?]\n    | [UseStoreOptionsWithSelector<T, S>?]\n): S {\n  let selectorRaw: Selector<T, S> | AnyPath | undefined;\n  let allOptions: UseStoreOptionsWithSelector<T, S>;\n\n  if (typeof args[0] === 'function' || isAnyPath(args[0])) {\n    selectorRaw = args[0];\n    allOptions = args[1] ?? {};\n  } else {\n    allOptions = args[0] ?? {};\n  }\n\n  const selectorMemoized = useMemoEquals(selectorRaw);\n  const selector = useMemo(() => makeSelector<T, S>(selectorMemoized), [selectorMemoized]);\n  const lastEqualsRef = useRef<(newValue: S) => boolean | undefined>(undefined);\n\n  if (store.derivedFrom) {\n    return useStore(\n      store.derivedFrom.store,\n      (value) => {\n        for (const selector of store.derivedFrom!.selectors) {\n          value = makeSelector(selector)(value);\n        }\n        return selector(value);\n      },\n      allOptions,\n    );\n  }\n\n  const {\n    enableTrackingProxy,\n    equals = store.options.equals ?? deepEqual,\n    withViewTransition,\n    storeValueEquals = strictEqual,\n    ...options\n  } = allOptions;\n\n  const snapshot = useRef<{ storeValue: T; selector: (value: T) => S; selectedValue: S }>(\n    undefined,\n  );\n\n  const get = useCallback(() => {\n    const storeValue = store.get();\n\n    if (\n      snapshot.current &&\n      storeValueEquals(storeValue, snapshot.current.storeValue) &&\n      selector === snapshot.current.selector\n    ) {\n      return snapshot.current.selectedValue;\n    }\n\n    const selectedValue = selector(storeValue);\n    if (!(lastEqualsRef.current?.(selectedValue) ?? false)) {\n      snapshot.current = { storeValue, selector, selectedValue };\n    }\n\n    return snapshot.current!.selectedValue;\n  }, [store, storeValueEquals, selector]);\n\n  const subOptions = useMemoEquals({ ...options, runNow: false });\n\n  const subscribe = useCallback(\n    (listener: () => void) => {\n      let _listener: (value: any) => void = listener;\n      let stopped = false;\n\n      if (withViewTransition && (document as any).startViewTransition) {\n        let lastObservedValue: any;\n\n        _listener = (value: any) => {\n          const observedValue =\n            withViewTransition instanceof Function ? withViewTransition(value) : value;\n\n          if (equals(lastObservedValue, observedValue)) {\n            listener();\n            return;\n          }\n\n          lastObservedValue = observedValue;\n\n          let hasChanges = false;\n          const mutationObserver = new MutationObserver(() => {\n            hasChanges = true;\n            mutationObserver.disconnect();\n          });\n          mutationObserver.observe(document.body, { childList: true, subtree: true });\n\n          (document as any).startViewTransition(() => {\n            mutationObserver.disconnect();\n\n            if (!stopped) {\n              listener();\n            }\n\n            if (!hasChanges) {\n              throw new Error('no change');\n            }\n          });\n        };\n      }\n\n      const cancel = store.subscribe(_listener, subOptions);\n      return () => {\n        stopped = true;\n        cancel();\n      };\n    },\n    [store, withViewTransition, equals, subOptions],\n  );\n\n  let value = useSyncExternalStore<S>(subscribe, get, get);\n  let lastEquals = (newValue: S) => equals(newValue, value);\n  let revoke: (() => void) | undefined;\n\n  if (enableTrackingProxy) {\n    [value, lastEquals, revoke] = trackingProxy(value, equals);\n  }\n\n  useLayoutEffect(() => {\n    lastEqualsRef.current = lastEquals;\n    revoke?.();\n  });\n\n  useDebugValue(value);\n  return value;\n}\n","import { createStore } from '@core';\nimport { useStore } from '@react/useStore';\nimport { createContext, useContext, useLayoutEffect, useMemo, type ReactNode } from 'react';\n\nexport interface LoadingBoundaryEntry {\n  label?: ReactNode;\n}\n\nexport interface LoadingBoundaryProps {\n  /**\n   * Fallback node to render when there are loading components within the boundary.\n   */\n  fallback?: ReactNode | ((entries: LoadingBoundaryEntry[]) => ReactNode);\n\n  /**\n   * Child node to render when there are no loading components within the boundary.\n   */\n  children?: ReactNode;\n\n  /**\n   * Add a loading state from outside the boundary. Useful for when you want to\n   * show a loading state for a component that is not a child of the boundary.\n   */\n  isLoading?: boolean;\n}\n\nconst LoadingBoundaryContext = createContext(createStore(new Set<LoadingBoundaryEntry>()));\n\nexport function LoadingBoundary({\n  fallback,\n  children,\n  isLoading: isLoadingExternal,\n}: LoadingBoundaryProps): React.JSX.Element {\n  const store = useMemo(() => createStore(new Set<LoadingBoundaryEntry>()), []);\n  const entries = useStore(store);\n  const isLoading = entries.size > 0 || isLoadingExternal;\n\n  const fallbackNode = isLoading\n    ? typeof fallback === 'function'\n      ? fallback([...entries])\n      : fallback\n    : undefined;\n\n  return (\n    <LoadingBoundaryContext.Provider value={store}>\n      {fallbackNode !== undefined ? (\n        <>\n          {fallbackNode}\n          <div style={{ display: 'none' }}>{children}</div>\n        </>\n      ) : (\n        children\n      )}\n    </LoadingBoundaryContext.Provider>\n  );\n}\n\nexport function useLoadingBoundary(isLoading: boolean | undefined, label?: ReactNode): void {\n  const store = useContext(LoadingBoundaryContext);\n\n  useLayoutEffect(() => {\n    if (!isLoading) {\n      return;\n    }\n\n    const entry = { label };\n    store.set((entries) => new Set(entries).add(entry));\n\n    return () => {\n      store.set((entries) => {\n        const newEntries = new Set(entries);\n        newEntries.delete(entry);\n        return newEntries;\n      });\n    };\n    // oxlint-disable-next-line exhaustive-deps\n  }, [store, isLoading]);\n}\n","import type { Cache } from '@core';\nimport type { CacheState } from '@lib/cacheState';\nimport { makeSelector } from '@lib/makeSelector';\nimport { useLoadingBoundary } from '@react/loadingBoundary';\nimport { useEffect, useMemo, useRef } from 'react';\nimport { useStore, type UseStoreOptions } from './useStore';\n\nexport type UseCacheArray<T> = [\n  value: T | undefined,\n  error: unknown | undefined,\n  isUpdating: boolean,\n  isStale: boolean,\n];\n\nexport type UseCacheValue<T> = UseCacheArray<T> & CacheState<T>;\n\nexport interface UseCacheOptions<T> extends UseStoreOptions<UseCacheArray<T> & CacheState<T>> {\n  /**\n   * If true, will always return undefined as value and no fetch will be triggered.\n   * @default false\n   */\n  disabled?: boolean;\n\n  /**\n   * If true, the cache will be invalidated when the component mounts.\n   * @default false\n   */\n  updateOnMount?: boolean;\n\n  /**\n   * If true, `useCache` will throw a promise when the cache is pending. This can be used with React Suspense.\n   * @see https://react.dev/reference/react/Suspense\n   * @default false\n   */\n  suspense?: boolean;\n\n  /**\n   * If true, `useCache` will register its loading state with the nearest `LoadingBoundary`.\n   * @default false\n   */\n  loadingBoundary?: boolean;\n}\n\nexport function useCache<T>(\n  cache: Cache<T, any>,\n  {\n    passive,\n    disabled,\n    updateOnMount,\n    withViewTransition,\n    suspense,\n    loadingBoundary,\n    ...options\n  }: UseCacheOptions<T> = {},\n): UseCacheValue<T> {\n  if (withViewTransition === true) {\n    withViewTransition = (state) => state.value;\n  }\n\n  const { rootCache, selector } = useMemo(() => {\n    const rootCache: Cache<any, any> = cache.derivedFromCache?.cache ?? cache;\n    let selector = (x: any) => x;\n\n    if (cache.derivedFromCache) {\n      selector = (value: any) => {\n        for (const s of cache.derivedFromCache!.selectors) {\n          value = makeSelector(s)(value);\n        }\n        return value;\n      };\n    }\n\n    return { rootCache, selector };\n  }, [cache]);\n\n  const hasMounted = useRef(false);\n\n  useEffect(() => {\n    hasMounted.current = true;\n\n    if (updateOnMount) {\n      rootCache.invalidate();\n    }\n    // oxlint-disable-next-line exhaustive-deps\n  }, []);\n\n  const result = useStore(\n    rootCache.state,\n    (state) => {\n      if (disabled) {\n        return Object.assign<UseCacheArray<T>, CacheState<T>>(\n          [undefined, undefined, false, false],\n          { status: 'pending', isUpdating: false, isStale: false, isConnected: false },\n        );\n      }\n\n      const isStale = updateOnMount && !hasMounted.current ? true : state.isStale;\n      try {\n        const value = state.status === 'value' ? selector(state.value) : undefined;\n\n        return Object.assign<UseCacheArray<T>, CacheState<T>>(\n          [value, state.error, state.isUpdating, isStale],\n          { ...state, value, isStale },\n        );\n      } catch (error) {\n        return Object.assign<UseCacheArray<T>, CacheState<T>>(\n          [undefined, error, state.isUpdating, isStale],\n          {\n            status: 'error',\n            error,\n            isUpdating: state.isUpdating,\n            isStale: isStale,\n            isConnected: state.isConnected,\n          },\n        );\n      }\n    },\n    { ...options, withViewTransition, passive: passive || disabled },\n  );\n\n  useEffect(\n    () => rootCache.subscribe(() => undefined, { passive: passive || disabled }),\n    [rootCache, passive, disabled],\n  );\n\n  useLoadingBoundary(loadingBoundary && !disabled && result.status === 'pending');\n\n  if (suspense && result.status === 'pending') {\n    throw rootCache.get();\n  }\n\n  return result;\n}\n","import type { Cache } from '@core';\nimport { type UseCacheOptions, type UseCacheValue, useCache } from '@react/useCache';\n\nexport const cacheMethods = {\n  useCache<T>(this: Cache<T, any>, options?: UseCacheOptions<T>): UseCacheValue<T> {\n    return useCache(this, options);\n  },\n};\n","import { useEffect, useRef } from 'react';\n\nexport default function useLatestRef<T>(value: T): { current: T } {\n  const ref = useRef(value);\n\n  useEffect(() => {\n    ref.current = value;\n  }, [value]);\n\n  return ref;\n}\n","import useLatestRef from '@react/lib/useLatestRef';\n\nexport default function useLatestFunction<Args extends any[], R>(\n  fn: (...args: Args) => R,\n): (...args: Args) => R {\n  const ref = useLatestRef(fn);\n\n  return (...args: Args) => {\n    return ref.current(...args);\n  };\n}\n","import { type Selector, type Update } from '@core/commonTypes';\nimport type { Store } from '@core/store';\nimport type { Constrain } from '@lib/constrain';\nimport { isAnyPath, type AnyPath, type SettablePath, type Value } from '@lib/path';\nimport useLatestFunction from '@react/lib/useLatestFunction';\nimport { useStore, type UseStoreOptions } from './useStore';\n\nexport function useProp<T, S>(\n  store: Store<T>,\n  selector: Selector<T, S>,\n  updater: (value: S) => Update<T>,\n  options?: UseStoreOptions<S>,\n): [value: S, setValue: Store<S>['set']];\n\nexport function useProp<T, const P>(\n  store: Store<T>,\n  selector: Constrain<P, SettablePath<T>>,\n  options?: UseStoreOptions<Value<T, P>>,\n): [value: Value<T, P>, setValue: Store<Value<T, P>>['set']];\n\nexport function useProp<T>(\n  store: Store<T>,\n  options?: UseStoreOptions<T>,\n): [value: T, setValue: Store<T>['set']];\n\nexport function useProp<T, S>(\n  store: Store<T>,\n  ...args:\n    | [Selector<T, S>, (value: S) => Update<T>, UseStoreOptions<S>?]\n    | [AnyPath, UseStoreOptions<Value<T, any>>?]\n    | [UseStoreOptions<S>?]\n): [value: S, setValue: Store<S>['set']] {\n  let selector: Selector<T, S> | AnyPath | undefined;\n  let updater: ((value: S) => Update<T>) | undefined;\n  let options: UseStoreOptions<S> | undefined;\n\n  if (typeof args[0] === 'function' || isAnyPath(args[0])) {\n    selector = args[0];\n    if (typeof args[1] === 'function') {\n      updater = args[1];\n      options = args[2];\n    } else {\n      options = args[1];\n    }\n  } else {\n    options = args[0];\n  }\n\n  const value = useStore(store, (selector ?? ((x) => x)) as Selector<T, S>, options);\n\n  const update = useLatestFunction((update) => {\n    let _store: Store<any> = store;\n    if (selector) {\n      _store = _store.map(selector as Selector<any, any>, updater);\n    }\n\n    _store.set(update);\n  });\n\n  return [value, update];\n}\n","import type { Scope, Selector, Update } from '@core';\nimport { createStore, type Store } from '@core/store';\nimport type { Constrain } from '@lib/constrain';\nimport type { Path, Value } from '@lib/path';\nimport { createContext, useContext, useMemo, type Context, type ReactNode } from 'react';\nimport { useProp } from './useProp';\nimport { useStore, type UseStoreOptions } from './useStore';\n\nexport type ScopeProps<T> = { scope: Scope<T>; store?: Store<T>; children?: ReactNode };\n\ndeclare module '..' {\n  interface Scope<T> {\n    context?: Context<Store<T>>;\n  }\n}\n\nfunction getScopeContext<T>(scope: Scope<T>): Context<Store<T>> {\n  scope.context ??= createContext<Store<T>>(createStore(scope.defaultValue));\n  return scope.context;\n}\n\nexport function ScopeProvider<T>({\n  scope,\n  store: inputStore,\n  children,\n}: ScopeProps<T>): React.JSX.Element {\n  const context = getScopeContext(scope);\n  const currentStore = useMemo(\n    () => inputStore ?? createStore(scope.defaultValue),\n    [scope, inputStore],\n  );\n\n  return <context.Provider value={currentStore}>{children}</context.Provider>;\n}\n\nexport function useScope<T>(scope: Scope<T>): Store<T> {\n  const context = getScopeContext(scope);\n  return useContext(context);\n}\n\nexport function useScopeStore<T, S>(\n  scope: Scope<T>,\n  selector: Selector<T, S>,\n  option?: UseStoreOptions<S>,\n): S;\n\nexport function useScopeStore<T, const P>(\n  scope: Scope<T>,\n  selector: Constrain<P, Path<T>>,\n  option?: UseStoreOptions<Value<T, P>>,\n): Value<T, P>;\n\nexport function useScopeStore<T>(scope: Scope<T>, option?: UseStoreOptions<T>): T;\n\nexport function useScopeStore<T>(scope: Scope<T>, ...args: any[]): T {\n  const store = useScope(scope);\n  return useStore(store, ...args);\n}\n\nexport function useScopeProp<T, S>(\n  scope: Scope<T>,\n  selector: Selector<T, S>,\n  updater: (value: S) => Update<T>,\n  options?: UseStoreOptions<S>,\n): [value: S, setValue: Store<S>['set']];\n\nexport function useScopeProp<T, const P>(\n  scope: Scope<T>,\n  selector: Constrain<P, Path<T>>,\n  options?: UseStoreOptions<Value<T, P>>,\n): [value: Value<T, P>, setValue: Store<Value<T, P>>['set']];\n\nexport function useScopeProp<T>(\n  scope: Scope<T>,\n  options?: UseStoreOptions<T>,\n): [value: T, setValue: Store<T>['set']];\n\nexport function useScopeProp<T>(\n  scope: Scope<T>,\n  ...args: any[]\n): [value: T, setValue: Store<T>['set']] {\n  const store = useScope(scope);\n  return useProp(store, ...args);\n}\n","import type { Scope, Selector, Store, Update } from '@core';\nimport type { Constrain } from '@lib/constrain';\nimport type { Path, Value } from '@lib/path';\nimport {\n  ScopeProvider,\n  useScope,\n  useScopeProp,\n  useScopeStore,\n  type ScopeProps,\n} from '@react/scope';\nimport type { UseStoreOptions } from '@react/useStore';\n\nfunction boundUseScope<T>(this: Scope<T>): Store<T> {\n  return useScope(this);\n}\n\nfunction boundUseScopeStore<T, S>(\n  this: Scope<T>,\n  selector: Selector<T, S>,\n  option?: UseStoreOptions<S>,\n): S;\n\nfunction boundUseScopeStore<T, const P>(\n  this: Scope<T>,\n  selector: Constrain<P, Path<T>>,\n  option?: UseStoreOptions<Value<T, P>>,\n): Value<T, P>;\n\nfunction boundUseScopeStore<T>(this: Scope<T>, option?: UseStoreOptions<T>): T;\n\nfunction boundUseScopeStore(this: Scope<any>, ...args: any[]) {\n  return useScopeStore(this, ...args);\n}\n\nfunction boundUseScopeProp<T, S>(\n  this: Scope<T>,\n  selector: Selector<T, S>,\n  updater: (value: S) => Update<T>,\n  options?: UseStoreOptions<S>,\n): [value: S, setValue: Store<S>['set']];\n\nfunction boundUseScopeProp<T, const P>(\n  this: Scope<T>,\n  selector: Constrain<P, Path<T>>,\n  options?: UseStoreOptions<Value<T, P>>,\n): [value: Value<T, P>, setValue: Store<Value<T, P>>['set']];\n\nfunction boundUseScopeProp<T>(\n  this: Scope<T>,\n  options?: UseStoreOptions<T>,\n): [value: T, setValue: Store<T>['set']];\n\nfunction boundUseScopeProp(this: Scope<any>, ...args: any[]) {\n  return useScopeProp(this, ...args);\n}\n\nfunction Provider<T>(this: Scope<T>, props: Omit<ScopeProps<T>, 'scope'>): React.JSX.Element {\n  return ScopeProvider({ ...props, scope: this });\n}\n\nexport const scopeMethods: {\n  useScope: typeof boundUseScope;\n  useStore: typeof boundUseScopeStore;\n  useProp: typeof boundUseScopeProp;\n  Provider: typeof Provider;\n} = {\n  useScope: boundUseScope,\n  useStore: boundUseScopeStore,\n  useProp: boundUseScopeProp,\n  Provider,\n};\n","import type { Selector, Store, Update } from '@core';\nimport type { Constrain } from '@lib/constrain';\nimport type { Path, Value } from '@lib/path';\nimport { useProp } from '@react/useProp';\nimport { type UseStoreOptions, useStore } from '@react/useStore';\n\nfunction boundUseStore<T, S>(\n  this: Store<T>,\n  selector: Selector<T, S>,\n  option?: UseStoreOptions<S>,\n): S;\nfunction boundUseStore<T, const P>(\n  this: Store<T>,\n  selector: Constrain<P, Path<T>>,\n  option?: UseStoreOptions<Value<T, P>>,\n): Value<T, P>;\nfunction boundUseStore<T>(this: Store<T>, option?: UseStoreOptions<T>): T;\nfunction boundUseStore(this: Store<any>, ...args: any[]) {\n  return useStore(this, ...args);\n}\n\nfunction boundUseProp<T, S>(\n  this: Store<T>,\n  selector: Selector<T, S>,\n  updater: (value: S) => Update<T>,\n  options?: UseStoreOptions<S>,\n): [value: S, setValue: Store<S>['set']];\nfunction boundUseProp<T, const P>(\n  this: Store<T>,\n  selector: Constrain<P, Path<T>>,\n  options?: UseStoreOptions<Value<T, P>>,\n): [value: Value<T, P>, setValue: Store<Value<T, P>>['set']];\nfunction boundUseProp<T>(\n  this: Store<T>,\n  options?: UseStoreOptions<T>,\n): [value: T, setValue: Store<T>['set']];\nfunction boundUseProp(this: Store<any>, ...args: any[]) {\n  return useProp(this, ...args);\n}\n\nexport const storeMethods: {\n  useStore: typeof boundUseStore;\n  useProp: typeof boundUseProp;\n} = {\n  useStore: boundUseStore,\n  useProp: boundUseProp,\n};\n"],"mappings":"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"}

package/dist/{storeMethods-y3PlfTHV.d.cts → storeMethods-D71fizqI.d.cts}

@@ -3,17 +3,33 @@ import { B as Value, C as Selector, K as Constrain, N as Path, T as Update, r as
 import { Context, ReactNode } from "react";
 
 //#region src/react/useStore.d.ts
-interface UseStoreOptions<S> extends Omit<SubscribeOptions, "runNow" | "passive"> {
+interface UseStoreOptions<T> extends Omit<SubscribeOptions, "runNow" | "passive"> {
   /**
   * If true, the cache content can be consumed but no fetch will be triggered.
   * @default false
   */
   passive?: boolean;
-  disableTrackingProxy?: boolean;
-  withViewTransition?: boolean | ((value: S) => unknown);
+  /**
+  * (experimental) If true, the a rerender will only be triggered when a property of the returned value changes that was
+  * actually accessed during the last render.
+  * @default false
+  */
+  enableTrackingProxy?: boolean;
+  /**
+  * (experimental) If provided, a rerender will be wrapped in a browser view transition.
+  */
+  withViewTransition?: boolean | ((value: T) => unknown);
+}
+interface UseStoreOptionsWithSelector<T, S> extends UseStoreOptions<S> {
+  /**
+  * Equality function to compare the raw store values before reevaluating the selector.
+  * Can be used to avoid unnecessary selector evaluations.
+  * @default strictEqual
+  */
+  storeValueEquals?: (newValue: T, oldValue: T) => boolean;
 }
-declare function useStore<T, S>(store: Store<T>, selector: Selector<T, S>, option?: UseStoreOptions<S>): S;
-declare function useStore<T, const P>(store: Store<T>, selector: Constrain<P, Path<T>>, option?: UseStoreOptions<Value<T, P>>): Value<T, P>;
+declare function useStore<T, S>(store: Store<T>, selector: Selector<T, S>, option?: UseStoreOptionsWithSelector<T, S>): S;
+declare function useStore<T, const P>(store: Store<T>, selector: Constrain<P, Path<T>>, option?: UseStoreOptionsWithSelector<T, Value<T, P>>): Value<T, P>;
 declare function useStore<T>(store: Store<T>, option?: UseStoreOptions<T>): T;
 //#endregion
 //#region src/react/useCache.d.ts
@@ -104,4 +120,4 @@ declare const storeMethods: {
 };
 //#endregion
 export { useScope as a, UseCacheValue as c, useStore as d, ScopeProvider as i, useCache as l, scopeMethods as n, cacheMethods as o, ScopeProps as r, UseCacheArray as s, storeMethods as t, UseStoreOptions as u };
-//# sourceMappingURL=storeMethods-y3PlfTHV.d.cts.map
+//# sourceMappingURL=storeMethods-D71fizqI.d.cts.map

package/dist/{storeMethods-Dsz0-Cda.d.ts → storeMethods-DmseqZrw.d.ts}

@@ -3,17 +3,33 @@ import { B as Value, C as Selector, K as Constrain, N as Path, T as Update, r as
 import { Context, ReactNode } from "react";
 
 //#region src/react/useStore.d.ts
-interface UseStoreOptions<S> extends Omit<SubscribeOptions, "runNow" | "passive"> {
+interface UseStoreOptions<T> extends Omit<SubscribeOptions, "runNow" | "passive"> {
   /**
   * If true, the cache content can be consumed but no fetch will be triggered.
   * @default false
   */
   passive?: boolean;
-  disableTrackingProxy?: boolean;
-  withViewTransition?: boolean | ((value: S) => unknown);
+  /**
+  * (experimental) If true, the a rerender will only be triggered when a property of the returned value changes that was
+  * actually accessed during the last render.
+  * @default false
+  */
+  enableTrackingProxy?: boolean;
+  /**
+  * (experimental) If provided, a rerender will be wrapped in a browser view transition.
+  */
+  withViewTransition?: boolean | ((value: T) => unknown);
+}
+interface UseStoreOptionsWithSelector<T, S> extends UseStoreOptions<S> {
+  /**
+  * Equality function to compare the raw store values before reevaluating the selector.
+  * Can be used to avoid unnecessary selector evaluations.
+  * @default strictEqual
+  */
+  storeValueEquals?: (newValue: T, oldValue: T) => boolean;
 }
-declare function useStore<T, S>(store: Store<T>, selector: Selector<T, S>, option?: UseStoreOptions<S>): S;
-declare function useStore<T, const P>(store: Store<T>, selector: Constrain<P, Path<T>>, option?: UseStoreOptions<Value<T, P>>): Value<T, P>;
+declare function useStore<T, S>(store: Store<T>, selector: Selector<T, S>, option?: UseStoreOptionsWithSelector<T, S>): S;
+declare function useStore<T, const P>(store: Store<T>, selector: Constrain<P, Path<T>>, option?: UseStoreOptionsWithSelector<T, Value<T, P>>): Value<T, P>;
 declare function useStore<T>(store: Store<T>, option?: UseStoreOptions<T>): T;
 //#endregion
 //#region src/react/useCache.d.ts
@@ -104,4 +120,4 @@ declare const storeMethods: {
 };
 //#endregion
 export { useScope as a, UseCacheValue as c, useStore as d, ScopeProvider as i, useCache as l, scopeMethods as n, cacheMethods as o, ScopeProps as r, UseCacheArray as s, storeMethods as t, UseStoreOptions as u };
-//# sourceMappingURL=storeMethods-Dsz0-Cda.d.ts.map
+//# sourceMappingURL=storeMethods-DmseqZrw.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cross-state",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "(React) state library",
   "license": "ISC",
   "repository": "schummar/cross-state",

package/dist/storeMethods-CQhXlHpl.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"storeMethods-CQhXlHpl.js","names":["equals","selectorRaw: Selector<T, S> | AnyPath | undefined","allOptions: UseStoreOptions<S>","selector","value","_listener: (value: any) => void","lastObservedValue: any","revoke: (() => void) | undefined","rootCache: Cache<any, any>","selector","selector: Selector<T, S> | AnyPath | undefined","updater: ((value: S) => Update<T>) | undefined","options: UseStoreOptions<S> | undefined","_store: Store<any>","scopeMethods: {\n  useScope: typeof boundUseScope;\n  useStore: typeof boundUseScopeStore;\n  useProp: typeof boundUseScopeProp;\n  Provider: typeof Provider;\n}","storeMethods: {\n  useStore: typeof boundUseStore;\n  useProp: typeof boundUseProp;\n}"],"sources":["../src/lib/trackingProxy.ts","../src/react/lib/useMemoEquals.ts","../src/react/useStore.ts","../src/react/loadingBoundary.tsx","../src/react/useCache.ts","../src/react/cacheMethods.ts","../src/react/lib/useLatestRef.ts","../src/react/lib/useLatestFunction.ts","../src/react/useProp.ts","../src/react/scope.tsx","../src/react/scopeMethods.ts","../src/react/storeMethods.ts"],"sourcesContent":["import { isPlainObject } from '@lib/helpers';\nimport { deepEqual } from './equals';\n\nconst unwrapProxySymbol = /* @__PURE__ */ Symbol('unwrapProxy');\n\nexport type TrackingProxy<T> = [value: T, equals: (newValue: T) => boolean, revoke?: () => void];\ntype Object_ = Record<string | symbol, unknown>;\n\nexport function trackingProxy<T>(\n  value: T,\n  equals: (a: any, b: any) => boolean = deepEqual,\n): TrackingProxy<T> {\n  if (!isPlainObject(value) && !Array.isArray(value)) {\n    return [value, (other) => equals(value, other)];\n  }\n\n  // Unpack proxies, we don't want to nest them\n  value = (value as any)[unwrapProxySymbol] ?? value;\n\n  const deps = new Array<TrackingProxy<any>[1]>();\n  const revokations = new Array<() => void>();\n  let revoked = false;\n\n  function trackComplexProp(function_: any, ...args: any[]) {\n    const [proxiedValue, equals, revoke] = 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    if (revoke) {\n      revokations.push(revoke);\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      if (p === unwrapProxySymbol) {\n        return value;\n      }\n\n      if (revoked) {\n        return target[p];\n      }\n\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 [\n    proxy,\n    (other) => !!other && deps.every((equals) => equals(other)),\n    () => {\n      revoked = true;\n      revokations.forEach((revoke) => revoke());\n    },\n  ];\n}\n","import { deepEqual } from '@lib/equals';\nimport { useEffect, useRef } from 'react';\n\nexport default function useMemoEquals<T>(value: T, equals: (a: T, b: T) => boolean = deepEqual): T {\n  const ref = useRef<{ value: T }>(undefined);\n  const hasChanged = !ref.current || !equals(ref.current.value, value);\n\n  useEffect(() => {\n    if (hasChanged) {\n      ref.current = { value };\n    }\n  });\n\n  return hasChanged ? value : ref.current!.value;\n}\n","import type { Selector, SubscribeOptions } from '@core/commonTypes';\nimport type { Store } from '@core/store';\nimport type { Constrain } from '@lib/constrain';\nimport { deepEqual } from '@lib/equals';\nimport { makeSelector } from '@lib/makeSelector';\nimport { isAnyPath, type AnyPath, type Path, type Value } from '@lib/path';\nimport { trackingProxy } from '@lib/trackingProxy';\nimport useMemoEquals from '@react/lib/useMemoEquals';\nimport {\n  useCallback,\n  useDebugValue,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n  useSyncExternalStore,\n} from 'react';\n\nexport interface UseStoreOptions<S> extends Omit<SubscribeOptions, 'runNow' | 'passive'> {\n  /**\n   * If true, the cache content can be consumed but no fetch will be triggered.\n   * @default false\n   */\n  passive?: boolean;\n\n  disableTrackingProxy?: boolean;\n\n  withViewTransition?: boolean | ((value: S) => unknown);\n}\n\nexport function useStore<T, S>(\n  store: Store<T>,\n  selector: Selector<T, S>,\n  option?: UseStoreOptions<S>,\n): S;\n\nexport function useStore<T, const P>(\n  store: Store<T>,\n  selector: Constrain<P, Path<T>>,\n  option?: UseStoreOptions<Value<T, P>>,\n): Value<T, P>;\n\nexport function useStore<T>(store: Store<T>, option?: UseStoreOptions<T>): T;\n\nexport function useStore<T, S>(\n  store: Store<T>,\n  ...args: [Selector<T, S> | AnyPath, UseStoreOptions<S>?] | [UseStoreOptions<S>?]\n): S {\n  let selectorRaw: Selector<T, S> | AnyPath | undefined;\n  let allOptions: UseStoreOptions<S>;\n\n  if (typeof args[0] === 'function' || isAnyPath(args[0])) {\n    selectorRaw = args[0];\n    allOptions = args[1] ?? {};\n  } else {\n    allOptions = args[0] ?? {};\n  }\n\n  const selector = useMemo(() => makeSelector<T, S>(selectorRaw), [selectorRaw]);\n  const lastEqualsRef = useRef<(newValue: S) => boolean | undefined>(undefined);\n\n  if (store.derivedFrom) {\n    return useStore(\n      store.derivedFrom.store,\n      (value) => {\n        for (const selector of store.derivedFrom!.selectors) {\n          value = makeSelector(selector)(value);\n        }\n        return selector(value);\n      },\n      allOptions,\n    );\n  }\n\n  const {\n    disableTrackingProxy = true,\n    equals = store.options.equals ?? deepEqual,\n    withViewTransition,\n    ...options\n  } = allOptions;\n\n  const snapshot = useRef<{ storeValue: T; selectedValue: S }>(undefined);\n\n  const get = useCallback(() => {\n    const storeValue = store.get();\n    const selectedValue = selector(storeValue);\n\n    const hasChanged =\n      !snapshot.current ||\n      (storeValue !== snapshot.current.storeValue &&\n        !(lastEqualsRef.current?.(selectedValue) ?? false));\n\n    if (hasChanged) {\n      snapshot.current = { storeValue, selectedValue };\n    }\n\n    return snapshot.current!.selectedValue;\n  }, [store, selector]);\n\n  const subOptions = useMemoEquals({ ...options, runNow: false });\n\n  const subscribe = useCallback(\n    (listener: () => void) => {\n      let _listener: (value: any) => void = listener;\n      let stopped = false;\n\n      if (withViewTransition && (document as any).startViewTransition) {\n        let lastObservedValue: any;\n\n        _listener = (value: any) => {\n          const observedValue =\n            withViewTransition instanceof Function ? withViewTransition(value) : value;\n\n          if (equals(lastObservedValue, observedValue)) {\n            listener();\n            return;\n          }\n\n          lastObservedValue = observedValue;\n\n          let hasChanges = false;\n          const mutationObserver = new MutationObserver(() => {\n            hasChanges = true;\n            mutationObserver.disconnect();\n          });\n          mutationObserver.observe(document.body, { childList: true, subtree: true });\n\n          (document as any).startViewTransition(() => {\n            mutationObserver.disconnect();\n\n            if (!stopped) {\n              listener();\n            }\n\n            if (!hasChanges) {\n              throw new Error('no change');\n            }\n          });\n        };\n      }\n\n      const cancel = store.subscribe(_listener, subOptions);\n      return () => {\n        stopped = true;\n        cancel();\n      };\n    },\n    [store, withViewTransition, equals, subOptions],\n  );\n\n  let value = useSyncExternalStore<S>(subscribe, get, get);\n  let lastEquals = (newValue: S) => equals(newValue, value);\n  let revoke: (() => void) | undefined;\n\n  if (!disableTrackingProxy) {\n    [value, lastEquals, revoke] = trackingProxy(value, equals);\n  }\n\n  useLayoutEffect(() => {\n    lastEqualsRef.current = lastEquals;\n    revoke?.();\n  });\n\n  useDebugValue(value);\n  return value;\n}\n","import { createStore } from '@core';\nimport { useStore } from '@react/useStore';\nimport { createContext, useContext, useLayoutEffect, useMemo, type ReactNode } from 'react';\n\nexport interface LoadingBoundaryEntry {\n  label?: ReactNode;\n}\n\nexport interface LoadingBoundaryProps {\n  /**\n   * Fallback node to render when there are loading components within the boundary.\n   */\n  fallback?: ReactNode | ((entries: LoadingBoundaryEntry[]) => ReactNode);\n\n  /**\n   * Child node to render when there are no loading components within the boundary.\n   */\n  children?: ReactNode;\n\n  /**\n   * Add a loading state from outside the boundary. Useful for when you want to\n   * show a loading state for a component that is not a child of the boundary.\n   */\n  isLoading?: boolean;\n}\n\nconst LoadingBoundaryContext = createContext(createStore(new Set<LoadingBoundaryEntry>()));\n\nexport function LoadingBoundary({\n  fallback,\n  children,\n  isLoading: isLoadingExternal,\n}: LoadingBoundaryProps): React.JSX.Element {\n  const store = useMemo(() => createStore(new Set<LoadingBoundaryEntry>()), []);\n  const entries = useStore(store);\n  const isLoading = entries.size > 0 || isLoadingExternal;\n\n  const fallbackNode = isLoading\n    ? typeof fallback === 'function'\n      ? fallback([...entries])\n      : fallback\n    : undefined;\n\n  return (\n    <LoadingBoundaryContext.Provider value={store}>\n      {fallbackNode !== undefined ? (\n        <>\n          {fallbackNode}\n          <div style={{ display: 'none' }}>{children}</div>\n        </>\n      ) : (\n        children\n      )}\n    </LoadingBoundaryContext.Provider>\n  );\n}\n\nexport function useLoadingBoundary(isLoading: boolean | undefined, label?: ReactNode): void {\n  const store = useContext(LoadingBoundaryContext);\n\n  useLayoutEffect(() => {\n    if (!isLoading) {\n      return;\n    }\n\n    const entry = { label };\n    store.set((entries) => new Set(entries).add(entry));\n\n    return () => {\n      store.set((entries) => {\n        const newEntries = new Set(entries);\n        newEntries.delete(entry);\n        return newEntries;\n      });\n    };\n    // oxlint-disable-next-line exhaustive-deps\n  }, [store, isLoading]);\n}\n","import type { Cache } from '@core';\nimport type { CacheState } from '@lib/cacheState';\nimport { makeSelector } from '@lib/makeSelector';\nimport { useLoadingBoundary } from '@react/loadingBoundary';\nimport { useEffect, useMemo, useRef } from 'react';\nimport { useStore, type UseStoreOptions } from './useStore';\n\nexport type UseCacheArray<T> = [\n  value: T | undefined,\n  error: unknown | undefined,\n  isUpdating: boolean,\n  isStale: boolean,\n];\n\nexport type UseCacheValue<T> = UseCacheArray<T> & CacheState<T>;\n\nexport interface UseCacheOptions<T> extends UseStoreOptions<UseCacheArray<T> & CacheState<T>> {\n  /**\n   * If true, will always return undefined as value and no fetch will be triggered.\n   * @default false\n   */\n  disabled?: boolean;\n\n  /**\n   * If true, the cache will be invalidated when the component mounts.\n   * @default false\n   */\n  updateOnMount?: boolean;\n\n  /**\n   * If true, `useCache` will throw a promise when the cache is pending. This can be used with React Suspense.\n   * @see https://react.dev/reference/react/Suspense\n   * @default false\n   */\n  suspense?: boolean;\n\n  /**\n   * If true, `useCache` will register its loading state with the nearest `LoadingBoundary`.\n   * @default false\n   */\n  loadingBoundary?: boolean;\n}\n\nexport function useCache<T>(\n  cache: Cache<T, any>,\n  {\n    passive,\n    disabled,\n    updateOnMount,\n    withViewTransition,\n    suspense,\n    loadingBoundary,\n    ...options\n  }: UseCacheOptions<T> = {},\n): UseCacheValue<T> {\n  if (withViewTransition === true) {\n    withViewTransition = (state) => state.value;\n  }\n\n  const { rootCache, selector } = useMemo(() => {\n    const rootCache: Cache<any, any> = cache.derivedFromCache?.cache ?? cache;\n    let selector = (x: any) => x;\n\n    if (cache.derivedFromCache) {\n      selector = (value: any) => {\n        for (const s of cache.derivedFromCache!.selectors) {\n          value = makeSelector(s)(value);\n        }\n        return value;\n      };\n    }\n\n    return { rootCache, selector };\n  }, [cache]);\n\n  const hasMounted = useRef(false);\n\n  useEffect(() => {\n    hasMounted.current = true;\n\n    if (updateOnMount) {\n      rootCache.invalidate();\n    }\n    // oxlint-disable-next-line exhaustive-deps\n  }, []);\n\n  const result = useStore(\n    rootCache.state,\n    (state) => {\n      if (disabled) {\n        return Object.assign<UseCacheArray<T>, CacheState<T>>(\n          [undefined, undefined, false, false],\n          { status: 'pending', isUpdating: false, isStale: false, isConnected: false },\n        );\n      }\n\n      const isStale = updateOnMount && !hasMounted.current ? true : state.isStale;\n      try {\n        const value = state.status === 'value' ? selector(state.value) : undefined;\n\n        return Object.assign<UseCacheArray<T>, CacheState<T>>(\n          [value, state.error, state.isUpdating, isStale],\n          { ...state, value, isStale },\n        );\n      } catch (error) {\n        return Object.assign<UseCacheArray<T>, CacheState<T>>(\n          [undefined, error, state.isUpdating, isStale],\n          {\n            status: 'error',\n            error,\n            isUpdating: state.isUpdating,\n            isStale: isStale,\n            isConnected: state.isConnected,\n          },\n        );\n      }\n    },\n    { ...options, withViewTransition, passive: passive || disabled },\n  );\n\n  useEffect(\n    () => rootCache.subscribe(() => undefined, { passive: passive || disabled }),\n    [rootCache, passive, disabled],\n  );\n\n  useLoadingBoundary(loadingBoundary && !disabled && result.status === 'pending');\n\n  if (suspense && result.status === 'pending') {\n    throw rootCache.get();\n  }\n\n  return result;\n}\n","import type { Cache } from '@core';\nimport { type UseCacheOptions, type UseCacheValue, useCache } from '@react/useCache';\n\nexport const cacheMethods = {\n  useCache<T>(this: Cache<T, any>, options?: UseCacheOptions<T>): UseCacheValue<T> {\n    return useCache(this, options);\n  },\n};\n","import { useEffect, useRef } from 'react';\n\nexport default function useLatestRef<T>(value: T): { current: T } {\n  const ref = useRef(value);\n\n  useEffect(() => {\n    ref.current = value;\n  }, [value]);\n\n  return ref;\n}\n","import useLatestRef from '@react/lib/useLatestRef';\n\nexport default function useLatestFunction<Args extends any[], R>(\n  fn: (...args: Args) => R,\n): (...args: Args) => R {\n  const ref = useLatestRef(fn);\n\n  return (...args: Args) => {\n    return ref.current(...args);\n  };\n}\n","import { type Selector, type Update } from '@core/commonTypes';\nimport type { Store } from '@core/store';\nimport type { Constrain } from '@lib/constrain';\nimport { isAnyPath, type AnyPath, type SettablePath, type Value } from '@lib/path';\nimport useLatestFunction from '@react/lib/useLatestFunction';\nimport { useStore, type UseStoreOptions } from './useStore';\n\nexport function useProp<T, S>(\n  store: Store<T>,\n  selector: Selector<T, S>,\n  updater: (value: S) => Update<T>,\n  options?: UseStoreOptions<S>,\n): [value: S, setValue: Store<S>['set']];\n\nexport function useProp<T, const P>(\n  store: Store<T>,\n  selector: Constrain<P, SettablePath<T>>,\n  options?: UseStoreOptions<Value<T, P>>,\n): [value: Value<T, P>, setValue: Store<Value<T, P>>['set']];\n\nexport function useProp<T>(\n  store: Store<T>,\n  options?: UseStoreOptions<T>,\n): [value: T, setValue: Store<T>['set']];\n\nexport function useProp<T, S>(\n  store: Store<T>,\n  ...args:\n    | [Selector<T, S>, (value: S) => Update<T>, UseStoreOptions<S>?]\n    | [AnyPath, UseStoreOptions<Value<T, any>>?]\n    | [UseStoreOptions<S>?]\n): [value: S, setValue: Store<S>['set']] {\n  let selector: Selector<T, S> | AnyPath | undefined;\n  let updater: ((value: S) => Update<T>) | undefined;\n  let options: UseStoreOptions<S> | undefined;\n\n  if (typeof args[0] === 'function' || isAnyPath(args[0])) {\n    selector = args[0];\n    if (typeof args[1] === 'function') {\n      updater = args[1];\n      options = args[2];\n    } else {\n      options = args[1];\n    }\n  } else {\n    options = args[0];\n  }\n\n  const value = useStore(store, (selector ?? ((x) => x)) as Selector<T, S>, options);\n\n  const update = useLatestFunction((update) => {\n    let _store: Store<any> = store;\n    if (selector) {\n      _store = _store.map(selector as Selector<any, any>, updater);\n    }\n\n    _store.set(update);\n  });\n\n  return [value, update];\n}\n","import type { Scope, Selector, Update } from '@core';\nimport { createStore, type Store } from '@core/store';\nimport type { Constrain } from '@lib/constrain';\nimport type { Path, Value } from '@lib/path';\nimport { createContext, useContext, useMemo, type Context, type ReactNode } from 'react';\nimport { useProp } from './useProp';\nimport { useStore, type UseStoreOptions } from './useStore';\n\nexport type ScopeProps<T> = { scope: Scope<T>; store?: Store<T>; children?: ReactNode };\n\ndeclare module '..' {\n  interface Scope<T> {\n    context?: Context<Store<T>>;\n  }\n}\n\nfunction getScopeContext<T>(scope: Scope<T>): Context<Store<T>> {\n  scope.context ??= createContext<Store<T>>(createStore(scope.defaultValue));\n  return scope.context;\n}\n\nexport function ScopeProvider<T>({\n  scope,\n  store: inputStore,\n  children,\n}: ScopeProps<T>): React.JSX.Element {\n  const context = getScopeContext(scope);\n  const currentStore = useMemo(\n    () => inputStore ?? createStore(scope.defaultValue),\n    [scope, inputStore],\n  );\n\n  return <context.Provider value={currentStore}>{children}</context.Provider>;\n}\n\nexport function useScope<T>(scope: Scope<T>): Store<T> {\n  const context = getScopeContext(scope);\n  return useContext(context);\n}\n\nexport function useScopeStore<T, S>(\n  scope: Scope<T>,\n  selector: Selector<T, S>,\n  option?: UseStoreOptions<S>,\n): S;\n\nexport function useScopeStore<T, const P>(\n  scope: Scope<T>,\n  selector: Constrain<P, Path<T>>,\n  option?: UseStoreOptions<Value<T, P>>,\n): Value<T, P>;\n\nexport function useScopeStore<T>(scope: Scope<T>, option?: UseStoreOptions<T>): T;\n\nexport function useScopeStore<T>(scope: Scope<T>, ...args: any[]): T {\n  const store = useScope(scope);\n  return useStore(store, ...args);\n}\n\nexport function useScopeProp<T, S>(\n  scope: Scope<T>,\n  selector: Selector<T, S>,\n  updater: (value: S) => Update<T>,\n  options?: UseStoreOptions<S>,\n): [value: S, setValue: Store<S>['set']];\n\nexport function useScopeProp<T, const P>(\n  scope: Scope<T>,\n  selector: Constrain<P, Path<T>>,\n  options?: UseStoreOptions<Value<T, P>>,\n): [value: Value<T, P>, setValue: Store<Value<T, P>>['set']];\n\nexport function useScopeProp<T>(\n  scope: Scope<T>,\n  options?: UseStoreOptions<T>,\n): [value: T, setValue: Store<T>['set']];\n\nexport function useScopeProp<T>(\n  scope: Scope<T>,\n  ...args: any[]\n): [value: T, setValue: Store<T>['set']] {\n  const store = useScope(scope);\n  return useProp(store, ...args);\n}\n","import type { Scope, Selector, Store, Update } from '@core';\nimport type { Constrain } from '@lib/constrain';\nimport type { Path, Value } from '@lib/path';\nimport {\n  ScopeProvider,\n  useScope,\n  useScopeProp,\n  useScopeStore,\n  type ScopeProps,\n} from '@react/scope';\nimport type { UseStoreOptions } from '@react/useStore';\n\nfunction boundUseScope<T>(this: Scope<T>): Store<T> {\n  return useScope(this);\n}\n\nfunction boundUseScopeStore<T, S>(\n  this: Scope<T>,\n  selector: Selector<T, S>,\n  option?: UseStoreOptions<S>,\n): S;\n\nfunction boundUseScopeStore<T, const P>(\n  this: Scope<T>,\n  selector: Constrain<P, Path<T>>,\n  option?: UseStoreOptions<Value<T, P>>,\n): Value<T, P>;\n\nfunction boundUseScopeStore<T>(this: Scope<T>, option?: UseStoreOptions<T>): T;\n\nfunction boundUseScopeStore(this: Scope<any>, ...args: any[]) {\n  return useScopeStore(this, ...args);\n}\n\nfunction boundUseScopeProp<T, S>(\n  this: Scope<T>,\n  selector: Selector<T, S>,\n  updater: (value: S) => Update<T>,\n  options?: UseStoreOptions<S>,\n): [value: S, setValue: Store<S>['set']];\n\nfunction boundUseScopeProp<T, const P>(\n  this: Scope<T>,\n  selector: Constrain<P, Path<T>>,\n  options?: UseStoreOptions<Value<T, P>>,\n): [value: Value<T, P>, setValue: Store<Value<T, P>>['set']];\n\nfunction boundUseScopeProp<T>(\n  this: Scope<T>,\n  options?: UseStoreOptions<T>,\n): [value: T, setValue: Store<T>['set']];\n\nfunction boundUseScopeProp(this: Scope<any>, ...args: any[]) {\n  return useScopeProp(this, ...args);\n}\n\nfunction Provider<T>(this: Scope<T>, props: Omit<ScopeProps<T>, 'scope'>): React.JSX.Element {\n  return ScopeProvider({ ...props, scope: this });\n}\n\nexport const scopeMethods: {\n  useScope: typeof boundUseScope;\n  useStore: typeof boundUseScopeStore;\n  useProp: typeof boundUseScopeProp;\n  Provider: typeof Provider;\n} = {\n  useScope: boundUseScope,\n  useStore: boundUseScopeStore,\n  useProp: boundUseScopeProp,\n  Provider,\n};\n","import type { Selector, Store, Update } from '@core';\nimport type { Constrain } from '@lib/constrain';\nimport type { Path, Value } from '@lib/path';\nimport { useProp } from '@react/useProp';\nimport { type UseStoreOptions, useStore } from '@react/useStore';\n\nfunction boundUseStore<T, S>(\n  this: Store<T>,\n  selector: Selector<T, S>,\n  option?: UseStoreOptions<S>,\n): S;\nfunction boundUseStore<T, const P>(\n  this: Store<T>,\n  selector: Constrain<P, Path<T>>,\n  option?: UseStoreOptions<Value<T, P>>,\n): Value<T, P>;\nfunction boundUseStore<T>(this: Store<T>, option?: UseStoreOptions<T>): T;\nfunction boundUseStore(this: Store<any>, ...args: any[]) {\n  return useStore(this, ...args);\n}\n\nfunction boundUseProp<T, S>(\n  this: Store<T>,\n  selector: Selector<T, S>,\n  updater: (value: S) => Update<T>,\n  options?: UseStoreOptions<S>,\n): [value: S, setValue: Store<S>['set']];\nfunction boundUseProp<T, const P>(\n  this: Store<T>,\n  selector: Constrain<P, Path<T>>,\n  options?: UseStoreOptions<Value<T, P>>,\n): [value: Value<T, P>, setValue: Store<Value<T, P>>['set']];\nfunction boundUseProp<T>(\n  this: Store<T>,\n  options?: UseStoreOptions<T>,\n): [value: T, setValue: Store<T>['set']];\nfunction boundUseProp(this: Store<any>, ...args: any[]) {\n  return useProp(this, ...args);\n}\n\nexport const storeMethods: {\n  useStore: typeof boundUseStore;\n  useProp: typeof boundUseProp;\n} = {\n  useStore: boundUseStore,\n  useProp: boundUseProp,\n};\n"],"mappings":";;;;;;;AAGA,MAAM,oBAAoC,uBAAO,cAAc;AAK/D,SAAgB,cACd,OACA,SAAsC,WACpB;AAClB,KAAI,CAAC,cAAc,MAAM,IAAI,CAAC,MAAM,QAAQ,MAAM,CAChD,QAAO,CAAC,QAAQ,UAAU,OAAO,OAAO,MAAM,CAAC;AAIjD,SAAS,MAAc,sBAAsB;CAE7C,MAAM,OAAO,IAAI,OAA8B;CAC/C,MAAM,cAAc,IAAI,OAAmB;CAC3C,IAAI,UAAU;CAEd,SAAS,iBAAiB,WAAgB,GAAG,MAAa;EACxD,MAAM,CAAC,cAAcA,UAAQ,UAAU,cAAc,UAAU,OAAO,GAAG,KAAK,CAAC;AAE/E,OAAK,MAAM,eAAe;AACxB,OAAI,CAAC,cAAc,WAAW,IAAI,CAAC,MAAM,QAAQ,WAAW,CAC1D,QAAO;AAGT,UAAOA,SAAO,UAAU,YAAY,GAAG,KAAK,CAAC;IAC7C;AAEF,MAAI,OACF,aAAY,KAAK,OAAO;AAG1B,SAAO;;CAGT,SAAS,gBAAgB,WAAgB,GAAG,MAAa;EACvD,MAAM,kBAAkB,UAAU,OAAO,GAAG,KAAK;AAEjD,OAAK,MAAM,eAAe;AACxB,UAAO,UAAU,YAAY,GAAG,KAAK,KAAK;IAC1C;AAEF,SAAO;;AA+CT,QAAO;EA5CO,IAAI,MAAM,OAAsB;GAC5C,IAAI,QAAQ,GAAG,UAAU;AACvB,QAAI,MAAM,kBACR,QAAO;AAGT,QAAI,QACF,QAAO,OAAO;IAGhB,MAAM,EAAE,UAAU,iBAAiB,OAAO,yBAAyB,QAAQ,EAAE,IAAI,EAAE;AACnF,QAAI,aAAa,SAAS,iBAAiB,MACzC,QAAO,OAAO;AAGhB,WAAO,iBAAiB,QAAQ,KAAK,GAAG,SAAS;;GAGnD,yBAAyB,QAAQ,GAAG;IAClC,MAAM,EAAE,UAAU,iBAAiB,OAAO,yBAAyB,QAAQ,EAAE,IAAI,EAAE;AACnF,QAAI,aAAa,SAAS,iBAAiB,MACzC,QAAO,QAAQ,yBAAyB,QAAQ,EAAE;AAGpD,WAAO,iBAAiB,QAAQ,0BAA0B,EAAE;;GAG9D,UAAU;AACR,WAAO,iBAAiB,QAAQ,QAAQ;;GAG1C,iBAAiB;AACf,WAAO,gBAAgB,QAAQ,eAAe;;GAGhD,IAAI,SAAS,GAAG;AACd,WAAO,gBAAgB,QAAQ,KAAK,EAAE;;GAGxC,eAAe;AACb,WAAO,gBAAgB,QAAQ,aAAa;;GAE/C,CAAC;GAIC,UAAU,CAAC,CAAC,SAAS,KAAK,OAAO,aAAWA,SAAO,MAAM,CAAC;QACrD;AACJ,aAAU;AACV,eAAY,SAAS,WAAW,QAAQ,CAAC;;EAE5C;;;;;ACnGH,SAAwB,cAAiB,OAAU,SAAkC,WAAc;CACjG,MAAM,MAAM,OAAqB,OAAU;CAC3C,MAAM,aAAa,CAAC,IAAI,WAAW,CAAC,OAAO,IAAI,QAAQ,OAAO,MAAM;AAEpE,iBAAgB;AACd,MAAI,WACF,KAAI,UAAU,EAAE,OAAO;GAEzB;AAEF,QAAO,aAAa,QAAQ,IAAI,QAAS;;;;;AC8B3C,SAAgB,SACd,OACA,GAAG,MACA;CACH,IAAIC;CACJ,IAAIC;AAEJ,KAAI,OAAO,KAAK,OAAO,cAAc,UAAU,KAAK,GAAG,EAAE;AACvD,gBAAc,KAAK;AACnB,eAAa,KAAK,MAAM,EAAE;OAE1B,cAAa,KAAK,MAAM,EAAE;CAG5B,MAAM,WAAW,cAAc,aAAmB,YAAY,EAAE,CAAC,YAAY,CAAC;CAC9E,MAAM,gBAAgB,OAA6C,OAAU;AAE7E,KAAI,MAAM,YACR,QAAO,SACL,MAAM,YAAY,QACjB,YAAU;AACT,OAAK,MAAMC,cAAY,MAAM,YAAa,UACxC,WAAQ,aAAaA,WAAS,CAACC,QAAM;AAEvC,SAAO,SAASA,QAAM;IAExB,WACD;CAGH,MAAM,EACJ,uBAAuB,MACvB,SAAS,MAAM,QAAQ,UAAU,WACjC,mBACA,GAAG,YACD;CAEJ,MAAM,WAAW,OAA4C,OAAU;CAEvE,MAAM,MAAM,kBAAkB;EAC5B,MAAM,aAAa,MAAM,KAAK;EAC9B,MAAM,gBAAgB,SAAS,WAAW;AAO1C,MAJE,CAAC,SAAS,WACT,eAAe,SAAS,QAAQ,cAC/B,EAAE,cAAc,UAAU,cAAc,IAAI,OAG9C,UAAS,UAAU;GAAE;GAAY;GAAe;AAGlD,SAAO,SAAS,QAAS;IACxB,CAAC,OAAO,SAAS,CAAC;CAErB,MAAM,aAAa,cAAc;EAAE,GAAG;EAAS,QAAQ;EAAO,CAAC;CAmD/D,IAAI,QAAQ,qBAjDM,aACf,aAAyB;EACxB,IAAIC,YAAkC;EACtC,IAAI,UAAU;AAEd,MAAI,sBAAuB,SAAiB,qBAAqB;GAC/D,IAAIC;AAEJ,gBAAa,YAAe;IAC1B,MAAM,gBACJ,8BAA8B,WAAW,mBAAmBF,QAAM,GAAGA;AAEvE,QAAI,OAAO,mBAAmB,cAAc,EAAE;AAC5C,eAAU;AACV;;AAGF,wBAAoB;IAEpB,IAAI,aAAa;IACjB,MAAM,mBAAmB,IAAI,uBAAuB;AAClD,kBAAa;AACb,sBAAiB,YAAY;MAC7B;AACF,qBAAiB,QAAQ,SAAS,MAAM;KAAE,WAAW;KAAM,SAAS;KAAM,CAAC;AAE3E,IAAC,SAAiB,0BAA0B;AAC1C,sBAAiB,YAAY;AAE7B,SAAI,CAAC,QACH,WAAU;AAGZ,SAAI,CAAC,WACH,OAAM,IAAI,MAAM,YAAY;MAE9B;;;EAIN,MAAM,SAAS,MAAM,UAAU,WAAW,WAAW;AACrD,eAAa;AACX,aAAU;AACV,WAAQ;;IAGZ;EAAC;EAAO;EAAoB;EAAQ;EAAW,CAChD,EAE8C,KAAK,IAAI;CACxD,IAAI,cAAc,aAAgB,OAAO,UAAU,MAAM;CACzD,IAAIG;AAEJ,KAAI,CAAC,qBACH,EAAC,OAAO,YAAY,UAAU,cAAc,OAAO,OAAO;AAG5D,uBAAsB;AACpB,gBAAc,UAAU;AACxB,YAAU;GACV;AAEF,eAAc,MAAM;AACpB,QAAO;;;;;ACzIT,MAAM,yBAAyB,cAAc,4BAAY,IAAI,KAA2B,CAAC,CAAC;AAE1F,SAAgB,gBAAgB,EAC9B,UACA,UACA,WAAW,qBAC+B;CAC1C,MAAM,QAAQ,cAAc,4BAAY,IAAI,KAA2B,CAAC,EAAE,EAAE,CAAC;CAC7E,MAAM,UAAU,SAAS,MAAM;CAG/B,MAAM,eAFY,QAAQ,OAAO,KAAK,oBAGlC,OAAO,aAAa,aAClB,SAAS,CAAC,GAAG,QAAQ,CAAC,GACtB,WACF;AAEJ,QACE,oBAAC,uBAAuB;EAAS,OAAO;YACrC,iBAAiB,SAChB,8CACG,cACD,oBAAC;GAAI,OAAO,EAAE,SAAS,QAAQ;GAAG;IAAe,IAChD,GAEH;GAE8B;;AAItC,SAAgB,mBAAmB,WAAgC,OAAyB;CAC1F,MAAM,QAAQ,WAAW,uBAAuB;AAEhD,uBAAsB;AACpB,MAAI,CAAC,UACH;EAGF,MAAM,QAAQ,EAAE,OAAO;AACvB,QAAM,KAAK,YAAY,IAAI,IAAI,QAAQ,CAAC,IAAI,MAAM,CAAC;AAEnD,eAAa;AACX,SAAM,KAAK,YAAY;IACrB,MAAM,aAAa,IAAI,IAAI,QAAQ;AACnC,eAAW,OAAO,MAAM;AACxB,WAAO;KACP;;IAGH,CAAC,OAAO,UAAU,CAAC;;;;;ACjCxB,SAAgB,SACd,OACA,EACE,SACA,UACA,eACA,oBACA,UACA,gBACA,GAAG,YACmB,EAAE,EACR;AAClB,KAAI,uBAAuB,KACzB,uBAAsB,UAAU,MAAM;CAGxC,MAAM,EAAE,WAAW,aAAa,cAAc;EAC5C,MAAMC,cAA6B,MAAM,kBAAkB,SAAS;EACpE,IAAIC,cAAY,MAAW;AAE3B,MAAI,MAAM,iBACR,eAAY,UAAe;AACzB,QAAK,MAAM,KAAK,MAAM,iBAAkB,UACtC,SAAQ,aAAa,EAAE,CAAC,MAAM;AAEhC,UAAO;;AAIX,SAAO;GAAE;GAAW;GAAU;IAC7B,CAAC,MAAM,CAAC;CAEX,MAAM,aAAa,OAAO,MAAM;AAEhC,iBAAgB;AACd,aAAW,UAAU;AAErB,MAAI,cACF,WAAU,YAAY;IAGvB,EAAE,CAAC;CAEN,MAAM,SAAS,SACb,UAAU,QACT,UAAU;AACT,MAAI,SACF,QAAO,OAAO,OACZ;GAAC;GAAW;GAAW;GAAO;GAAM,EACpC;GAAE,QAAQ;GAAW,YAAY;GAAO,SAAS;GAAO,aAAa;GAAO,CAC7E;EAGH,MAAM,UAAU,iBAAiB,CAAC,WAAW,UAAU,OAAO,MAAM;AACpE,MAAI;GACF,MAAM,QAAQ,MAAM,WAAW,UAAU,SAAS,MAAM,MAAM,GAAG;AAEjE,UAAO,OAAO,OACZ;IAAC;IAAO,MAAM;IAAO,MAAM;IAAY;IAAQ,EAC/C;IAAE,GAAG;IAAO;IAAO;IAAS,CAC7B;WACM,OAAO;AACd,UAAO,OAAO,OACZ;IAAC;IAAW;IAAO,MAAM;IAAY;IAAQ,EAC7C;IACE,QAAQ;IACR;IACA,YAAY,MAAM;IACT;IACT,aAAa,MAAM;IACpB,CACF;;IAGL;EAAE,GAAG;EAAS;EAAoB,SAAS,WAAW;EAAU,CACjE;AAED,iBACQ,UAAU,gBAAgB,QAAW,EAAE,SAAS,WAAW,UAAU,CAAC,EAC5E;EAAC;EAAW;EAAS;EAAS,CAC/B;AAED,oBAAmB,mBAAmB,CAAC,YAAY,OAAO,WAAW,UAAU;AAE/E,KAAI,YAAY,OAAO,WAAW,UAChC,OAAM,UAAU,KAAK;AAGvB,QAAO;;;;;AChIT,MAAa,eAAe,EAC1B,SAAiC,SAAgD;AAC/E,QAAO,SAAS,MAAM,QAAQ;GAEjC;;;;ACLD,SAAwB,aAAgB,OAA0B;CAChE,MAAM,MAAM,OAAO,MAAM;AAEzB,iBAAgB;AACd,MAAI,UAAU;IACb,CAAC,MAAM,CAAC;AAEX,QAAO;;;;;ACPT,SAAwB,kBACtB,IACsB;CACtB,MAAM,MAAM,aAAa,GAAG;AAE5B,SAAQ,GAAG,SAAe;AACxB,SAAO,IAAI,QAAQ,GAAG,KAAK;;;;;;ACiB/B,SAAgB,QACd,OACA,GAAG,MAIoC;CACvC,IAAIC;CACJ,IAAIC;CACJ,IAAIC;AAEJ,KAAI,OAAO,KAAK,OAAO,cAAc,UAAU,KAAK,GAAG,EAAE;AACvD,aAAW,KAAK;AAChB,MAAI,OAAO,KAAK,OAAO,YAAY;AACjC,aAAU,KAAK;AACf,aAAU,KAAK;QAEf,WAAU,KAAK;OAGjB,WAAU,KAAK;AAcjB,QAAO,CAXO,SAAS,OAAQ,cAAc,MAAM,IAAuB,QAAQ,EAEnE,mBAAmB,WAAW;EAC3C,IAAIC,SAAqB;AACzB,MAAI,SACF,UAAS,OAAO,IAAI,UAAgC,QAAQ;AAG9D,SAAO,IAAI,OAAO;GAClB,CAEoB;;;;;AC3CxB,SAAS,gBAAmB,OAAoC;AAC9D,OAAM,YAAY,cAAwB,YAAY,MAAM,aAAa,CAAC;AAC1E,QAAO,MAAM;;AAGf,SAAgB,cAAiB,EAC/B,OACA,OAAO,YACP,YACmC;CACnC,MAAM,UAAU,gBAAgB,MAAM;CACtC,MAAM,eAAe,cACb,cAAc,YAAY,MAAM,aAAa,EACnD,CAAC,OAAO,WAAW,CACpB;AAED,QAAO,oBAAC,QAAQ;EAAS,OAAO;EAAe;GAA4B;;AAG7E,SAAgB,SAAY,OAA2B;AAErD,QAAO,WADS,gBAAgB,MAAM,CACZ;;AAiB5B,SAAgB,cAAiB,OAAiB,GAAG,MAAgB;AAEnE,QAAO,SADO,SAAS,MAAM,EACN,GAAG,KAAK;;AAqBjC,SAAgB,aACd,OACA,GAAG,MACoC;AAEvC,QAAO,QADO,SAAS,MAAM,EACP,GAAG,KAAK;;;;;ACtEhC,SAAS,gBAA2C;AAClD,QAAO,SAAS,KAAK;;AAiBvB,SAAS,mBAAqC,GAAG,MAAa;AAC5D,QAAO,cAAc,MAAM,GAAG,KAAK;;AAqBrC,SAAS,kBAAoC,GAAG,MAAa;AAC3D,QAAO,aAAa,MAAM,GAAG,KAAK;;AAGpC,SAAS,SAA4B,OAAwD;AAC3F,QAAO,cAAc;EAAE,GAAG;EAAO,OAAO;EAAM,CAAC;;AAGjD,MAAaC,eAKT;CACF,UAAU;CACV,UAAU;CACV,SAAS;CACT;CACD;;;;ACrDD,SAAS,cAAgC,GAAG,MAAa;AACvD,QAAO,SAAS,MAAM,GAAG,KAAK;;AAkBhC,SAAS,aAA+B,GAAG,MAAa;AACtD,QAAO,QAAQ,MAAM,GAAG,KAAK;;AAG/B,MAAaC,eAGT;CACF,UAAU;CACV,SAAS;CACV"}