atom.io 0.5.0 → 0.6.0

package/realtime-react/dist/index.mjs

@@ -0,0 +1,168 @@
+// ../src/realtime-react/realtime-context.tsx
+import * as React from "react";
+import * as AR from "atom.io/react";
+import { io } from "socket.io-client";
+
+// ../src/realtime-react/realtime-state.ts
+import * as AtomIO from "atom.io";
+var myIdState__INTERNAL = AtomIO.atom({
+  key: `myId__INTERNAL`,
+  default: null
+});
+var myIdState = AtomIO.selector({
+  key: `myId`,
+  get: ({ get }) => get(myIdState__INTERNAL)
+});
+
+// ../src/realtime-react/realtime-context.tsx
+import { jsx } from "@emotion/react/jsx-runtime";
+var RealtimeContext = React.createContext({
+  socket: io()
+});
+var RealtimeProvider = ({ children, socket }) => {
+  const setMyId = AR.useI(myIdState__INTERNAL);
+  React.useEffect(() => {
+    socket.on(`connect`, () => {
+      setMyId(socket.id);
+    });
+    socket.on(`disconnect`, () => {
+      setMyId(null);
+    });
+  }, [socket, setMyId]);
+  return /* @__PURE__ */ jsx(RealtimeContext.Provider, { value: { socket }, children });
+};
+
+// ../src/realtime-react/use-pull.ts
+import * as React3 from "react";
+import * as AtomIO3 from "atom.io";
+
+// ../src/react/store-context.tsx
+import * as React2 from "react";
+import * as AtomIO2 from "atom.io";
+import { jsx as jsx2 } from "@emotion/react/jsx-runtime";
+var StoreContext = React2.createContext(
+  AtomIO2.__INTERNAL__.IMPLICIT.STORE
+);
+
+// ../src/realtime-react/use-pull.ts
+function usePull(token) {
+  const { socket } = React3.useContext(RealtimeContext);
+  const store = React3.useContext(StoreContext);
+  React3.useEffect(() => {
+    socket.on(`serve:${token.key}`, (data) => {
+      AtomIO3.setState(token, data, store);
+    });
+    socket.emit(`sub:${token.key}`);
+    return () => {
+      socket.off(`serve:${token.key}`);
+      socket.emit(`unsub:${token.key}`);
+    };
+  }, [token.key]);
+}
+
+// ../src/realtime-react/use-pull-family.ts
+import * as React4 from "react";
+import * as AtomIO4 from "atom.io";
+function usePullFamily(family) {
+  const { socket } = React4.useContext(RealtimeContext);
+  const store = React4.useContext(StoreContext);
+  React4.useEffect(() => {
+    socket.on(`serve:${family.key}`, (key, data) => {
+      AtomIO4.setState(family(key), data, store);
+    });
+    socket == null ? void 0 : socket.emit(`sub:${family.key}`);
+    return () => {
+      socket == null ? void 0 : socket.off(`serve:${family.key}`);
+      socket == null ? void 0 : socket.emit(`unsub:${family.key}`);
+    };
+  }, [family.key]);
+}
+
+// ../src/realtime-react/use-pull-family-member.ts
+import * as React5 from "react";
+import * as AtomIO5 from "atom.io";
+function usePullFamilyMember(family, subKey) {
+  const token = family(subKey);
+  const { socket } = React5.useContext(RealtimeContext);
+  const store = React5.useContext(StoreContext);
+  React5.useEffect(() => {
+    socket == null ? void 0 : socket.on(`serve:${token.key}`, (data) => {
+      AtomIO5.setState(family(subKey), data, store);
+    });
+    socket == null ? void 0 : socket.emit(`sub:${family.key}`, subKey);
+    return () => {
+      socket == null ? void 0 : socket.off(`serve:${token.key}`);
+      socket == null ? void 0 : socket.emit(`unsub:${token.key}`);
+    };
+  }, [family.key]);
+}
+
+// ../src/realtime-react/use-push.ts
+import * as React6 from "react";
+import * as AtomIO6 from "atom.io";
+function usePush(token) {
+  const { socket } = React6.useContext(RealtimeContext);
+  const store = React6.useContext(StoreContext);
+  React6.useEffect(() => {
+    socket.emit(`claim:${token.key}`);
+    AtomIO6.subscribe(
+      token,
+      ({ newValue }) => {
+        socket.emit(`pub:${token.key}`, newValue);
+      },
+      store
+    );
+    return () => {
+      socket.emit(`unclaim:${token.key}`);
+    };
+  }, [token.key]);
+}
+
+// ../src/realtime-react/use-server-action.ts
+import * as React7 from "react";
+import * as AtomIO7 from "atom.io";
+import { StoreContext as StoreContext2 } from "atom.io/react";
+var TX_SUBS = /* @__PURE__ */ new Map();
+function useServerAction(token) {
+  const store = React7.useContext(StoreContext2);
+  const { socket } = React7.useContext(RealtimeContext);
+  React7.useEffect(() => {
+    var _a;
+    const count = (_a = TX_SUBS.get(token.key)) != null ? _a : 0;
+    TX_SUBS.set(token.key, count + 1);
+    const unsubscribe = count === 0 ? AtomIO7.subscribeToTransaction(
+      token,
+      (update) => socket.emit(`tx:${token.key}`, update),
+      store
+    ) : () => null;
+    return () => {
+      var _a2;
+      const newCount = (_a2 = TX_SUBS.get(token.key)) != null ? _a2 : 0;
+      TX_SUBS.set(token.key, newCount - 1);
+      unsubscribe();
+    };
+  }, [token.key]);
+  return AtomIO7.runTransaction(token, store);
+}
+
+// ../src/realtime-react/realtime-hooks.ts
+var realtimeHooks = {
+  usePull,
+  usePullFamily,
+  usePullFamilyMember,
+  usePush,
+  useServerAction
+};
+export {
+  RealtimeContext,
+  RealtimeProvider,
+  myIdState,
+  myIdState__INTERNAL,
+  realtimeHooks,
+  usePull,
+  usePullFamily,
+  usePullFamilyMember,
+  usePush,
+  useServerAction
+};
+//# sourceMappingURL=index.mjs.map

package/realtime-react/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/realtime-react/realtime-context.tsx","../../src/realtime-react/realtime-state.ts","../../src/realtime-react/use-pull.ts","../../src/react/store-context.tsx","../../src/realtime-react/use-pull-family.ts","../../src/realtime-react/use-pull-family-member.ts","../../src/realtime-react/use-push.ts","../../src/realtime-react/use-server-action.ts","../../src/realtime-react/realtime-hooks.ts"],"sourcesContent":["import * as React from \"react\"\n\nimport * as AR from \"atom.io/react\"\nimport type { Socket } from \"socket.io-client\"\nimport { io } from \"socket.io-client\"\n\nimport { myIdState__INTERNAL } from \"./realtime-state\"\n\nexport const RealtimeContext = React.createContext<{ socket: Socket }>({\n  socket: io(),\n})\n\nexport const RealtimeProvider: React.FC<{\n  children: React.ReactNode\n  socket: Socket\n}> = ({ children, socket }) => {\n  const setMyId = AR.useI(myIdState__INTERNAL)\n  React.useEffect(() => {\n    socket.on(`connect`, () => {\n      setMyId(socket.id)\n    })\n    socket.on(`disconnect`, () => {\n      setMyId(null)\n    })\n  }, [socket, setMyId])\n  return (\n    <RealtimeContext.Provider value={{ socket }}>\n      {children}\n    </RealtimeContext.Provider>\n  )\n}\n","import * as AtomIO from \"atom.io\"\n\nexport const myIdState__INTERNAL = AtomIO.atom<string | null>({\n  key: `myId__INTERNAL`,\n  default: null,\n})\nexport const myIdState = AtomIO.selector<string | null>({\n  key: `myId`,\n  get: ({ get }) => get(myIdState__INTERNAL),\n})\n","import * as React from \"react\"\n\nimport * as AtomIO from \"atom.io\"\n\nimport type { Json } from \"~/packages/anvl/src/json\"\n\nimport { RealtimeContext } from \"./realtime-context\"\nimport { StoreContext } from \"../react\"\n\nexport function usePull<J extends Json>(token: AtomIO.StateToken<J>): void {\n  const { socket } = React.useContext(RealtimeContext)\n  const store = React.useContext(StoreContext)\n  React.useEffect(() => {\n    socket.on(`serve:${token.key}`, (data: J) => {\n      AtomIO.setState(token, data, store)\n    })\n    socket.emit(`sub:${token.key}`)\n    return () => {\n      socket.off(`serve:${token.key}`)\n      socket.emit(`unsub:${token.key}`)\n    }\n  }, [token.key])\n}\n","import * as React from \"react\"\n\nimport * as AtomIO from \"atom.io\"\n\nexport const StoreContext = React.createContext<AtomIO.Store>(\n  AtomIO.__INTERNAL__.IMPLICIT.STORE\n)\n\nexport const StoreProvider: React.FC<{\n  children: React.ReactNode\n  store?: AtomIO.Store\n}> = ({ children, store = AtomIO.__INTERNAL__.IMPLICIT.STORE }) => (\n  <StoreContext.Provider value={store}>{children}</StoreContext.Provider>\n)\n","import * as React from \"react\"\n\nimport * as AtomIO from \"atom.io\"\n\nimport type { Json } from \"~/packages/anvl/src/json\"\n\nimport { RealtimeContext } from \"./realtime-context\"\nimport { StoreContext } from \"../react\"\n\nexport function usePullFamily<J extends Json>(\n  family: AtomIO.AtomFamily<J> | AtomIO.SelectorFamily<J>\n): void {\n  const { socket } = React.useContext(RealtimeContext)\n  const store = React.useContext(StoreContext)\n  React.useEffect(() => {\n    socket.on(`serve:${family.key}`, (key: Json, data: J) => {\n      AtomIO.setState(family(key), data, store)\n    })\n    socket?.emit(`sub:${family.key}`)\n    return () => {\n      socket?.off(`serve:${family.key}`)\n      socket?.emit(`unsub:${family.key}`)\n    }\n  }, [family.key])\n}\n","import * as React from \"react\"\n\nimport * as AtomIO from \"atom.io\"\n\nimport type { Json } from \"~/packages/anvl/src/json\"\n\nimport { RealtimeContext } from \"./realtime-context\"\nimport { StoreContext } from \"../react\"\n\nexport function usePullFamilyMember<J extends Json>(\n  family: AtomIO.AtomFamily<J> | AtomIO.SelectorFamily<J>,\n  subKey: AtomIO.Serializable\n): void {\n  const token = family(subKey)\n  const { socket } = React.useContext(RealtimeContext)\n  const store = React.useContext(StoreContext)\n  React.useEffect(() => {\n    socket?.on(`serve:${token.key}`, (data: J) => {\n      AtomIO.setState(family(subKey), data, store)\n    })\n    socket?.emit(`sub:${family.key}`, subKey)\n    return () => {\n      socket?.off(`serve:${token.key}`)\n      socket?.emit(`unsub:${token.key}`)\n    }\n  }, [family.key])\n}\n","import * as React from \"react\"\n\nimport * as AtomIO from \"atom.io\"\n\nimport type { Json } from \"~/packages/anvl/src/json\"\n\nimport { RealtimeContext } from \"./realtime-context\"\nimport { StoreContext } from \"../react\"\n\nexport function usePush<J extends Json>(token: AtomIO.StateToken<J>): void {\n  const { socket } = React.useContext(RealtimeContext)\n  const store = React.useContext(StoreContext)\n  React.useEffect(() => {\n    socket.emit(`claim:${token.key}`)\n    AtomIO.subscribe(\n      token,\n      ({ newValue }) => {\n        socket.emit(`pub:${token.key}`, newValue)\n      },\n      store\n    )\n    return () => {\n      socket.emit(`unclaim:${token.key}`)\n    }\n  }, [token.key])\n}\n","import * as React from \"react\"\n\nimport * as AtomIO from \"atom.io\"\nimport { StoreContext } from \"atom.io/react\"\n\nimport type { ƒn } from \"~/packages/anvl/src/function\"\n\nimport { RealtimeContext } from \"./realtime-context\"\n\nconst TX_SUBS = new Map<string, number>()\nexport function useServerAction<ƒ extends ƒn>(\n  token: AtomIO.TransactionToken<ƒ>\n): (...parameters: Parameters<ƒ>) => ReturnType<ƒ> {\n  const store = React.useContext(StoreContext)\n  const { socket } = React.useContext(RealtimeContext)\n  React.useEffect(() => {\n    const count = TX_SUBS.get(token.key) ?? 0\n    TX_SUBS.set(token.key, count + 1)\n    const unsubscribe =\n      count === 0\n        ? AtomIO.subscribeToTransaction(\n            token,\n            (update) => socket.emit(`tx:${token.key}`, update),\n            store\n          )\n        : () => null\n    return () => {\n      const newCount = TX_SUBS.get(token.key) ?? 0\n      TX_SUBS.set(token.key, newCount - 1)\n      unsubscribe()\n    }\n  }, [token.key])\n  return AtomIO.runTransaction(token, store)\n}\n","import type * as AtomIO from \"atom.io\"\n\nimport type { ƒn } from \"~/packages/anvl/src/function\"\nimport type { Json } from \"~/packages/anvl/src/json\"\n\nimport { usePull } from \"./use-pull\"\nimport { usePullFamily } from \"./use-pull-family\"\nimport { usePullFamilyMember } from \"./use-pull-family-member\"\nimport { usePush } from \"./use-push\"\nimport { useServerAction } from \"./use-server-action\"\n\nexport type RealtimeHooks = {\n  usePull: <J extends Json>(token: AtomIO.StateToken<J>) => void\n  usePullFamily: <J extends Json>(\n    family: AtomIO.AtomFamily<J> | AtomIO.SelectorFamily<J>\n  ) => void\n  usePullFamilyMember: <J extends Json>(\n    family: AtomIO.AtomFamily<J> | AtomIO.SelectorFamily<J>,\n    subKey: string\n  ) => void\n  usePush: <J extends Json>(token: AtomIO.StateToken<J>) => void\n  useServerAction: <ƒ extends ƒn>(\n    token: AtomIO.TransactionToken<ƒ>\n  ) => (...parameters: Parameters<ƒ>) => ReturnType<ƒ>\n}\n\nexport const realtimeHooks: RealtimeHooks = {\n  usePull,\n  usePullFamily,\n  usePullFamilyMember,\n  usePush,\n  useServerAction,\n}\n\nexport * from \"./use-pull\"\nexport * from \"./use-pull-family\"\nexport * from \"./use-pull-family-member\"\nexport * from \"./use-push\"\nexport * from \"./use-server-action\"\n"],"mappings":"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","names":["React","AtomIO","React","AtomIO","jsx","React","AtomIO","React","AtomIO","React","AtomIO","React","AtomIO","StoreContext","StoreContext","_a"]}

package/realtime-react/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "atom.io-realtime-react",
+  "private": true,
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "module": "dist/index.mjs",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "browser": "./dist/index.mjs",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  }
+}

package/src/index.ts

@@ -50,12 +50,6 @@ export type FamilyMetadata = {
   subKey: string
 }
 
-export type TransactionToken<_> = {
-  key: string
-  type: `transaction`
-  __brand?: _
-}
-
 export const getState = <T>(
   token: ReadonlySelectorToken<T> | StateToken<T>,
   store: Store = IMPLICIT.STORE

package/src/internal/get.ts

@@ -2,14 +2,21 @@ import HAMT from "hamt_plus"
 
 import type { ƒn } from "~/packages/anvl/src/function"
 
-import type { Atom, ReadonlySelector, Selector, Store } from "."
+import type {
+  Atom,
+  ReadonlySelector,
+  Selector,
+  Store,
+  Timeline,
+  Transaction,
+} from "."
 import { target, isValueCached, readCachedValue, IMPLICIT } from "."
 import type {
   AtomToken,
   ReadonlySelectorToken,
   SelectorToken,
   StateToken,
-  Transaction,
+  TimelineToken,
   TransactionToken,
 } from ".."
 
@@ -51,13 +58,19 @@ export function withdraw<T>(
   token: ReadonlySelectorToken<T> | StateToken<T>,
   store: Store
 ): Atom<T> | ReadonlySelector<T> | Selector<T> | null
+export function withdraw<T>(token: TimelineToken, store: Store): Timeline | null
 export function withdraw<T>(
-  token: ReadonlySelectorToken<T> | StateToken<T> | TransactionToken<T>,
+  token:
+    | ReadonlySelectorToken<T>
+    | StateToken<T>
+    | TimelineToken
+    | TransactionToken<T>,
   store: Store
 ):
   | Atom<T>
   | ReadonlySelector<T>
   | Selector<T>
+  | Timeline
   | Transaction<T extends ƒn ? T : never>
   | null {
   const core = target(store)
@@ -66,6 +79,7 @@ export function withdraw<T>(
     HAMT.get(token.key, core.selectors) ??
     HAMT.get(token.key, core.readonlySelectors) ??
     HAMT.get(token.key, core.transactions) ??
+    HAMT.get(token.key, core.timelines) ??
     null
   )
 }

package/src/internal/index.ts

@@ -5,9 +5,11 @@ export * from "./is-default"
 export * as META from "./meta"
 export * from "./operation"
 export * from "./selector-internal"
+export * from "./selector"
 export * from "./set"
 export * from "./store"
 export * from "./subscribe-internal"
 export * from "./time-travel-internal"
 export * from "./timeline-internal"
 export * from "./transaction-internal"
+export * from "./transaction"

package/src/internal/meta/meta-state.ts

@@ -7,7 +7,7 @@ export type StateTokenIndex<
   Token extends
     | AtomToken<unknown>
     | ReadonlySelectorToken<unknown>
-    | SelectorToken<unknown>
+    | SelectorToken<unknown>,
 > = Record<
   string,
   | Token

package/src/internal/operation.ts

@@ -34,7 +34,9 @@ export const openOperation = (token: StateToken<any>, store: Store): void => {
     time: Date.now(),
     token,
   }
-  store.config.logger?.info(`⭕ operation start from "${token.key}"`)
+  store.config.logger?.info(
+    `⭕ operation start from "${token.key}" in store "${store.config.name}"`
+  )
 }
 export const closeOperation = (store: Store): void => {
   const core = target(store)

package/src/internal/selector/create-read-write-selector.ts

@@ -0,0 +1,62 @@
+import HAMT from "hamt_plus"
+import * as Rx from "rxjs"
+
+import { become } from "~/packages/anvl/src/function"
+
+import {
+  type Store,
+  type Selector,
+  type StoreCore,
+  registerSelector,
+  selector__INTERNAL,
+} from ".."
+import type { FamilyMetadata, SelectorToken } from "../.."
+import type { SelectorOptions } from "../../selector"
+import { cacheValue, markDone } from "../operation"
+
+export const createReadWriteSelector = <T>(
+  options: SelectorOptions<T>,
+  family: FamilyMetadata | undefined,
+  store: Store,
+  core: StoreCore
+): SelectorToken<T> => {
+  const subject = new Rx.Subject<{ newValue: T; oldValue: T }>()
+
+  const { get, set } = registerSelector(options.key, store)
+  const getSelf = () => {
+    const value = options.get({ get })
+    cacheValue(options.key, value, store)
+    return value
+  }
+
+  const setSelf = (next: T | ((oldValue: T) => T)): void => {
+    store.config.logger?.info(`   <- "${options.key}" became`, next)
+    const oldValue = getSelf()
+    const newValue = become(next)(oldValue)
+    cacheValue(options.key, newValue, store)
+    markDone(options.key, store)
+    if (store.transactionStatus.phase === `idle`) {
+      subject.next({ newValue, oldValue })
+    }
+    options.set({ get, set }, newValue)
+  }
+  const mySelector: Selector<T> = {
+    ...options,
+    subject,
+    install: (s: Store) => selector__INTERNAL(options, family, s),
+    get: getSelf,
+    set: setSelf,
+    type: `selector`,
+    ...(family && { family }),
+  }
+  core.selectors = HAMT.set(options.key, mySelector, core.selectors)
+  const initialValue = getSelf()
+  store.config.logger?.info(`   ✨ "${options.key}" =`, initialValue)
+  const token: SelectorToken<T> = {
+    key: options.key,
+    type: `selector`,
+    family,
+  }
+  store.subject.selectorCreation.next(token)
+  return token
+}

package/src/internal/selector/create-readonly-selector.ts

@@ -0,0 +1,52 @@
+import HAMT from "hamt_plus"
+import * as Rx from "rxjs"
+
+import { registerSelector } from "./register-selector"
+import type {
+  FamilyMetadata,
+  ReadonlySelectorOptions,
+  ReadonlySelectorToken,
+  Store,
+} from "../.."
+import { cacheValue } from "../operation"
+import { selector__INTERNAL, type ReadonlySelector } from "../selector-internal"
+import type { StoreCore } from "../store"
+
+export const createReadonlySelector = <T>(
+  options: ReadonlySelectorOptions<T>,
+  family: FamilyMetadata | undefined,
+  store: Store,
+  core: StoreCore
+): ReadonlySelectorToken<T> => {
+  const subject = new Rx.Subject<{ newValue: T; oldValue: T }>()
+
+  const { get } = registerSelector(options.key, store)
+  const getSelf = () => {
+    const value = options.get({ get })
+    cacheValue(options.key, value, store)
+    return value
+  }
+
+  const readonlySelector: ReadonlySelector<T> = {
+    ...options,
+    subject,
+    install: (s: Store) => selector__INTERNAL(options, family, s),
+    get: getSelf,
+    type: `readonly_selector`,
+    ...(family && { family }),
+  }
+  core.readonlySelectors = HAMT.set(
+    options.key,
+    readonlySelector,
+    core.readonlySelectors
+  )
+  const initialValue = getSelf()
+  store.config.logger?.info(`   ✨ "${options.key}" =`, initialValue)
+  const token: ReadonlySelectorToken<T> = {
+    key: options.key,
+    type: `readonly_selector`,
+    family,
+  }
+  store.subject.selectorCreation.next(token)
+  return token
+}

package/src/internal/selector/index.ts

@@ -0,0 +1,4 @@
+export * from "./lookup-selector-sources"
+export * from "./register-selector"
+export * from "./trace-selector-atoms"
+export * from "./update-selector-atoms"

package/src/internal/selector/lookup-selector-sources.ts

@@ -0,0 +1,16 @@
+import type { Store } from ".."
+import { target, lookup } from ".."
+import type { AtomToken, ReadonlySelectorToken, SelectorToken } from "../.."
+
+export const lookupSelectorSources = (
+  key: string,
+  store: Store
+): (
+  | AtomToken<unknown>
+  | ReadonlySelectorToken<unknown>
+  | SelectorToken<unknown>
+)[] =>
+  target(store)
+    .selectorGraph.getRelations(key)
+    .filter(({ source }) => source !== key)
+    .map(({ source }) => lookup(source, store))

package/src/internal/selector/register-selector.ts

@@ -0,0 +1,57 @@
+import { updateSelectorAtoms } from "./update-selector-atoms"
+import type { Transactors } from "../../transaction"
+import { getState__INTERNAL, withdraw } from "../get"
+import { setState__INTERNAL } from "../set"
+import type { Store } from "../store"
+import { IMPLICIT } from "../store"
+import { target } from "../transaction-internal"
+
+export const registerSelector = (
+  selectorKey: string,
+  store: Store = IMPLICIT.STORE
+): Transactors => ({
+  get: (dependency) => {
+    const core = target(store)
+    const alreadyRegistered = core.selectorGraph
+      .getRelations(selectorKey)
+      .some(({ source }) => source === dependency.key)
+
+    const dependencyState = withdraw(dependency, store)
+    if (dependencyState === null) {
+      throw new Error(
+        `State "${dependency.key}" not found in this store. Did you forget to initialize with the "atom" or "selector" function?`
+      )
+    }
+    const dependencyValue = getState__INTERNAL(dependencyState, store)
+
+    if (alreadyRegistered) {
+      store.config.logger?.info(
+        `   || ${selectorKey} <- ${dependency.key} =`,
+        dependencyValue
+      )
+    } else {
+      store.config.logger?.info(
+        `🔌 registerSelector "${selectorKey}" <- ( "${dependency.key}" =`,
+        dependencyValue,
+        `)`
+      )
+      core.selectorGraph = core.selectorGraph.set(
+        { from: dependency.key, to: selectorKey },
+        {
+          source: dependency.key,
+        }
+      )
+    }
+    updateSelectorAtoms(selectorKey, dependency, store)
+    return dependencyValue
+  },
+  set: (stateToken, newValue) => {
+    const state = withdraw(stateToken, store)
+    if (state === null) {
+      throw new Error(
+        `State "${stateToken.key}" not found in this store. Did you forget to initialize with the "atom" or "selector" function?`
+      )
+    }
+    setState__INTERNAL(state, newValue, store)
+  },
+})

package/src/internal/selector/trace-selector-atoms.ts

@@ -0,0 +1,43 @@
+import { lookupSelectorSources } from "./lookup-selector-sources"
+import type { Store, AtomToken, ReadonlySelectorToken, StateToken } from "../.."
+
+export const traceSelectorAtoms = (
+  selectorKey: string,
+  dependency: ReadonlySelectorToken<unknown> | StateToken<unknown>,
+  store: Store
+): AtomToken<unknown>[] => {
+  const roots: AtomToken<unknown>[] = []
+
+  const sources = lookupSelectorSources(dependency.key, store)
+  let depth = 0
+  while (sources.length > 0) {
+    /* eslint-disable-next-line @typescript-eslint/no-non-null-assertion */
+    const source = sources.shift()!
+    ++depth
+    if (depth > 999) {
+      throw new Error(
+        `Maximum selector dependency depth exceeded in selector "${selectorKey}".`
+      )
+    }
+
+    if (source.type !== `atom`) {
+      sources.push(...lookupSelectorSources(source.key, store))
+    } else {
+      roots.push(source)
+    }
+  }
+
+  return roots
+}
+
+export const traceAllSelectorAtoms = (
+  selectorKey: string,
+  store: Store
+): AtomToken<unknown>[] => {
+  const sources = lookupSelectorSources(selectorKey, store)
+  return sources.flatMap((source) =>
+    source.type === `atom`
+      ? source
+      : traceSelectorAtoms(selectorKey, source, store)
+  )
+}

package/src/internal/selector/update-selector-atoms.ts

@@ -0,0 +1,33 @@
+import { traceSelectorAtoms } from "./trace-selector-atoms"
+import type { Store } from ".."
+import { target } from ".."
+import type { ReadonlySelectorToken, StateToken } from "../.."
+
+export const updateSelectorAtoms = (
+  selectorKey: string,
+  dependency: ReadonlySelectorToken<unknown> | StateToken<unknown>,
+  store: Store
+): void => {
+  const core = target(store)
+  if (dependency.type === `atom`) {
+    core.selectorAtoms = core.selectorAtoms.set({
+      selectorKey,
+      atomKey: dependency.key,
+    })
+    store.config.logger?.info(
+      `   || adding root for "${selectorKey}": ${dependency.key}`
+    )
+    return
+  }
+  const roots = traceSelectorAtoms(selectorKey, dependency, store)
+  store.config.logger?.info(
+    `   || adding roots for "${selectorKey}":`,
+    roots.map((r) => r.key)
+  )
+  for (const root of roots) {
+    core.selectorAtoms = core.selectorAtoms.set({
+      selectorKey,
+      atomKey: root.key,
+    })
+  }
+}