atom.io 0.13.0 → 0.14.1

package/internal/dist/index.cjs

@@ -1,8 +1,5 @@
 'use strict';
 
-var atom_io = require('atom.io');
-var json = require('atom.io/json');
-
 var __defProp = Object.defineProperty;
 var __defProps = Object.defineProperties;
 var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
@@ -23,7 +20,78 @@ var __spreadValues = (a, b) => {
 };
 var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
 
-// src/future.ts
+// src/get-state.ts
+function getState(token, store = IMPLICIT.STORE) {
+  var _a;
+  const state = (_a = withdraw(token, store)) != null ? _a : withdrawNewFamilyMember(token, store);
+  if (state === void 0) {
+    throw new NotFoundError(token, store);
+  }
+  return readOrComputeValue(state, store);
+}
+
+// src/logger.ts
+var simpleLog = (logLevel) => (icon, tokenType, tokenKey, message, ...rest) => {
+  console[logLevel](`${icon} ${tokenType} "${tokenKey}" ${message}`, ...rest);
+};
+var simpleLogger = {
+  error: simpleLog(`error`),
+  info: simpleLog(`info`),
+  warn: simpleLog(`warn`)
+};
+var AtomIOLogger = class {
+  constructor(logLevel, filter, logger = simpleLogger) {
+    this.logLevel = logLevel;
+    this.filter = filter;
+    this.logger = logger;
+    this.error = (...args) => {
+      var _a, _b;
+      if (((_b = (_a = this.filter) == null ? void 0 : _a.call(this, ...args)) != null ? _b : true) && this.logLevel !== null) {
+        this.logger.error(...args);
+      }
+    };
+    this.info = (...args) => {
+      var _a, _b;
+      if (((_b = (_a = this.filter) == null ? void 0 : _a.call(this, ...args)) != null ? _b : true) && this.logLevel === `info`) {
+        this.logger.info(...args);
+      }
+    };
+    this.warn = (...args) => {
+      var _a, _b;
+      if (((_b = (_a = this.filter) == null ? void 0 : _a.call(this, ...args)) != null ? _b : true) && this.logLevel !== `error` && this.logLevel !== null) {
+        this.logger.warn(...args);
+      }
+    };
+  }
+};
+
+// src/set-state.ts
+function setState(token, value, store = IMPLICIT.STORE) {
+  var _a;
+  const rejection = openOperation(token, store);
+  if (rejection) {
+    return;
+  }
+  const state = (_a = withdraw(token, store)) != null ? _a : withdrawNewFamilyMember(token, store);
+  if (state === void 0) {
+    throw new NotFoundError(token, store);
+  }
+  setAtomOrSelector(state, value, store);
+  closeOperation(store);
+}
+
+// src/transaction.ts
+var runTransaction = (token, store = IMPLICIT.STORE) => (...parameters) => {
+  const tx = withdraw(token, store);
+  if (tx) {
+    return tx.run(...parameters);
+  }
+  throw new Error(
+    `Cannot run transaction "${token.key}": transaction not found in store "${store.config.name}".`
+  );
+};
+
+// internal/src/future.ts
 var Future = class extends Promise {
   constructor(executor) {
     super((resolve, reject) => {
@@ -42,7 +110,7 @@ var Future = class extends Promise {
   }
 };
 
-// src/lineage.ts
+// internal/src/lineage.ts
 function newest(scion) {
   while (scion.child !== null) {
     scion = scion.child;
@@ -56,7 +124,7 @@ function eldest(scion) {
   return scion;
 }
 
-// src/caching.ts
+// internal/src/caching.ts
 function cacheValue(key, value, subject, store) {
   const target = newest(store);
   const currentValue = target.valueMap.get(key);
@@ -100,165 +168,348 @@ var evictCachedValue = (key, store) => {
   core.valueMap.delete(key);
   store.logger.info(`\u{1F5D1}`, `state`, key, `evicted`);
 };
-var Tracker = class {
-  constructor(mutableState, store) {
-    this.unsubscribeFromInnerValue = null;
-    this.mutableState = mutableState;
-    const target = newest(store);
-    this.latestUpdateState = this.initializeState(mutableState, target);
-    this.observeCore(mutableState, this.latestUpdateState, target);
-    this.updateCore(mutableState, this.latestUpdateState, target);
-    target.trackers.set(mutableState.key, this);
+
+// ../anvl/src/json/index.ts
+var parseJson = (str) => JSON.parse(str);
+var stringifyJson = (json) => JSON.stringify(json);
+
+// json/src/select-json.ts
+var selectJson = (atom, transform, store = IMPLICIT.STORE) => {
+  return createSelector(
+    {
+      key: `${atom.key}:JSON`,
+      get: ({ get }) => transform.toJson(get(atom)),
+      set: ({ set }, newValue) => set(atom, transform.fromJson(newValue))
+    },
+    void 0,
+    store
+  );
+};
+
+// json/src/select-json-family.ts
+var selectJsonFamily = (atomFamily, transform, store = IMPLICIT.STORE) => {
+  const jsonFamily = createSelectorFamily(
+    {
+      key: `${atomFamily.key}:JSON`,
+      get: (key) => ({ get }) => transform.toJson(get(atomFamily(key))),
+      set: (key) => ({ set }, newValue) => set(atomFamily(key), transform.fromJson(newValue))
+    },
+    store
+  );
+  atomFamily.subject.subscribe(
+    `store=${store.config.name}::json-selector-family`,
+    (token) => {
+      if (token.family) {
+        jsonFamily(parseJson(token.family.subKey));
+      }
+    }
+  );
+  return jsonFamily;
+};
+
+// internal/src/read-or-compute-value.ts
+var readOrComputeValue = (state, store) => {
+  if (isValueCached(state.key, store)) {
+    store.logger.info(`\u{1F4D6}`, state.type, state.key, `reading cached value`);
+    return readCachedValue(state.key, store);
   }
-  initializeState(mutableState, store) {
-    const latestUpdateStateKey = `*${mutableState.key}`;
-    deleteAtom({ type: `atom`, key: latestUpdateStateKey }, store);
-    const familyMetaData = mutableState.family ? {
-      key: `*${mutableState.family.key}`,
-      subKey: mutableState.family.subKey
-    } : void 0;
-    const latestUpdateState = createAtom(
-      {
-        key: latestUpdateStateKey,
-        default: null
-      },
-      familyMetaData,
-      store
+  if (state.type !== `atom`) {
+    store.logger.info(`\u{1F9EE}`, state.type, state.key, `computing value`);
+    return state.get();
+  }
+  const fallback = state.default instanceof Function ? state.default() : state.default;
+  store.logger.info(
+    `\u{1F481}`,
+    `atom`,
+    state.key,
+    `could not find cached value; using default`,
+    fallback
+  );
+  return state.default instanceof Function ? state.default() : state.default;
+};
+
+// internal/src/operation.ts
+var openOperation = (token, store) => {
+  const target = newest(store);
+  if (target.operation.open) {
+    store.logger.error(
+      `\u274C`,
+      token.type,
+      token.key,
+      `failed to setState during a setState for "${target.operation.token.key}"`
     );
-    return latestUpdateState;
+    return `rejection`;
   }
-  observeCore(mutableState, latestUpdateState, store) {
-    const originalInnerValue = atom_io.getState(mutableState, store);
-    const target = newest(store);
-    this.unsubscribeFromInnerValue = originalInnerValue.subscribe(
-      `tracker:${store.config.name}:${target.transactionMeta === null ? `main` : target.transactionMeta.update.key}`,
-      (update) => {
-        const unsubscribe = store.subject.operationStatus.subscribe(
-          mutableState.key,
-          () => {
-            unsubscribe();
-            atom_io.setState(latestUpdateState, update, store);
-          }
-        );
-      }
+  target.operation = {
+    open: true,
+    done: /* @__PURE__ */ new Set(),
+    prev: /* @__PURE__ */ new Map(),
+    time: Date.now(),
+    token
+  };
+  store.logger.info(
+    `\u2B55`,
+    token.type,
+    token.key,
+    `operation start in store "${store.config.name}"${target.transactionMeta === null ? `` : ` ${target.transactionMeta.phase} "${target.transactionMeta.update.key}"`}`
+  );
+};
+var closeOperation = (store) => {
+  const target = newest(store);
+  if (target.operation.open) {
+    store.logger.info(
+      `\u{1F534}`,
+      target.operation.token.type,
+      target.operation.token.key,
+      `operation done in store "${store.config.name}"`
     );
-    atom_io.subscribe(
-      mutableState,
-      (update) => {
-        var _a;
-        if (update.newValue !== update.oldValue) {
-          (_a = this.unsubscribeFromInnerValue) == null ? void 0 : _a.call(this);
-          const target2 = newest(store);
-          this.unsubscribeFromInnerValue = update.newValue.subscribe(
-            `tracker:${store.config.name}:${target2.transactionMeta === null ? `main` : target2.transactionMeta.update.key}`,
-            (update2) => {
-              const unsubscribe = store.subject.operationStatus.subscribe(
-                mutableState.key,
-                () => {
-                  unsubscribe();
-                  atom_io.setState(latestUpdateState, update2, store);
-                }
-              );
-            }
-          );
-        }
-      },
-      `${store.config.name}: tracker observing inner value`,
-      store
+  }
+  target.operation = { open: false };
+  store.subject.operationStatus.next(target.operation);
+};
+var isDone = (key, store) => {
+  const target = newest(store);
+  if (!target.operation.open) {
+    store.logger.warn(
+      `\u{1F41E}`,
+      `unknown`,
+      key,
+      `isDone called outside of an operation. This is probably a bug.`
     );
+    return true;
   }
-  updateCore(mutableState, latestUpdateState, store) {
-    atom_io.subscribe(
-      latestUpdateState,
-      ({ newValue, oldValue }) => {
-        const timelineId = store.timelineAtoms.getRelatedKey(
-          latestUpdateState.key
-        );
-        if (timelineId) {
-          const timelineData = store.timelines.get(timelineId);
-          if (timelineData == null ? void 0 : timelineData.timeTraveling) {
-            const unsubscribe2 = atom_io.subscribeToTimeline(
-              { key: timelineId, type: `timeline` },
-              (update) => {
-                unsubscribe2();
-                atom_io.setState(
-                  mutableState,
-                  (transceiver) => {
-                    if (update === `redo` && newValue) {
-                      transceiver.do(newValue);
-                    } else if (update === `undo` && oldValue) {
-                      transceiver.undo(oldValue);
-                    }
-                    return transceiver;
-                  },
-                  store
-                );
-              }
-            );
-            return;
-          }
-        }
-        const unsubscribe = store.subject.operationStatus.subscribe(
-          latestUpdateState.key,
-          () => {
-            unsubscribe();
-            const mutable = atom_io.getState(mutableState, store);
-            const updateNumber = mutable.getUpdateNumber(newValue);
-            const eventOffset = updateNumber - mutable.cacheUpdateNumber;
-            if (newValue && eventOffset === 1) {
-              atom_io.setState(
-                mutableState,
-                (transceiver) => (transceiver.do(newValue), transceiver),
-                store
-              );
-            }
-          }
-        );
-      },
-      `${store.config.name}: tracker observing latest update`,
-      store
+  return target.operation.done.has(key);
+};
+var markDone = (key, store) => {
+  const target = newest(store);
+  if (!target.operation.open) {
+    store.logger.warn(
+      `\u{1F41E}`,
+      `unknown`,
+      key,
+      `markDone called outside of an operation. This is probably a bug.`
     );
+    return;
   }
+  target.operation.done.add(key);
 };
 
-// src/mutable/create-mutable-atom.ts
-function createMutableAtom(options, store) {
-  store.logger.info(
-    `\u{1F527}`,
-    `atom`,
-    options.key,
-    `creating in store "${store.config.name}"`
-  );
-  const coreState = createAtom(options, void 0, store);
-  new Tracker(coreState, store);
-  const jsonState = json.selectJson(coreState, options, store);
-  const target = newest(store);
-  atom_io.subscribe(
-    jsonState,
-    () => {
-      const trackerHasBeenInitialized = newest(store).trackers.has(coreState.key);
-      if (!trackerHasBeenInitialized) {
-        new Tracker(coreState, store);
-      }
-    },
-    `tracker-initializer:${store == null ? void 0 : store.config.name}:${target.transactionMeta === null ? `main` : `${target.transactionMeta.update.key}`}`
-  );
-  return coreState;
-}
+// internal/src/set-state/become.ts
+var become = (nextVersionOfThing) => (originalThing) => nextVersionOfThing instanceof Function ? nextVersionOfThing(
+  originalThing instanceof Function ? originalThing() : originalThing
+) : nextVersionOfThing;
 
-// src/store/deposit.ts
-function deposit(state) {
-  const token = {
-    key: state.key,
-    type: state.type
-  };
-  if (`family` in state) {
-    token.family = state.family;
+// internal/src/subject.ts
+var Subject = class {
+  constructor() {
+    this.subscribers = /* @__PURE__ */ new Map();
   }
-  return token;
-}
-
-// ../../rel8/junction/src/junction.ts
+  subscribe(key, subscriber) {
+    this.subscribers.set(key, subscriber);
+    const unsubscribe = () => this.unsubscribe(key);
+    return unsubscribe;
+  }
+  unsubscribe(key) {
+    this.subscribers.delete(key);
+  }
+  next(value) {
+    for (const subscriber of this.subscribers.values()) {
+      subscriber(value);
+    }
+  }
+};
+var StatefulSubject = class extends Subject {
+  constructor(initialState) {
+    super();
+    this.state = initialState;
+  }
+  next(value) {
+    this.state = value;
+    super.next(value);
+  }
+};
+
+// internal/src/set-state/copy-mutable-if-needed.ts
+function copyMutableIfNeeded(atom, transform, origin, target) {
+  const originValue = origin.valueMap.get(atom.key);
+  const targetValue = target.valueMap.get(atom.key);
+  if (originValue === targetValue) {
+    origin.logger.info(`\u{1F4C3}`, `atom`, `${atom.key}`, `copying`);
+    const jsonValue = transform.toJson(originValue);
+    const copiedValue = transform.fromJson(jsonValue);
+    target.valueMap.set(atom.key, copiedValue);
+    new Tracker(atom, origin);
+    return copiedValue;
+  }
+  return targetValue;
+}
+
+// internal/src/set-state/copy-mutable-in-transaction.ts
+function copyMutableIfWithinTransaction(oldValue, atom, store) {
+  const target = newest(store);
+  const parent = target.parent;
+  if (parent !== null) {
+    if (`toJson` in atom && `fromJson` in atom) {
+      const copiedValue = copyMutableIfNeeded(atom, atom, parent, target);
+      return copiedValue;
+    }
+    if (`family` in atom) {
+      const family = parent.families.get(atom.family.key);
+      if (family && family.type === `atom_family`) {
+        const result = copyMutableFamilyMemberWithinTransaction(
+          atom,
+          family,
+          parent,
+          target
+        );
+        if (result) {
+          return result;
+        }
+      }
+    }
+  }
+  return oldValue;
+}
+function copyMutableFamilyMemberWithinTransaction(atom, family, origin, target) {
+  if (`toJson` in family && `fromJson` in family) {
+    const copyCreated = copyMutableIfNeeded(atom, family, origin, target);
+    return copyCreated;
+  }
+  return null;
+}
+
+// internal/src/set-state/emit-update.ts
+var emitUpdate = (state, update, store) => {
+  store.logger.info(
+    `\u{1F4E2}`,
+    state.type,
+    state.key,
+    `went (`,
+    update.oldValue,
+    `->`,
+    update.newValue,
+    `) subscribers:`,
+    state.subject.subscribers
+  );
+  state.subject.next(update);
+};
+
+// internal/src/set-state/evict-downstream.ts
+var evictDownStream = (atom, store) => {
+  const target = newest(store);
+  const downstreamKeys = target.selectorAtoms.getRelatedKeys(atom.key);
+  store.logger.info(
+    `\u{1F9F9}`,
+    atom.type,
+    atom.key,
+    downstreamKeys ? `evicting ${downstreamKeys.size} states downstream:` : `no downstream states`,
+    downstreamKeys != null ? downstreamKeys : `to evict`
+  );
+  if (downstreamKeys) {
+    if (target.operation.open) {
+      store.logger.info(
+        `\u{1F9F9}`,
+        atom.type,
+        atom.key,
+        `[ ${[...target.operation.done].join(`, `)} ] already done`
+      );
+    }
+    for (const key of downstreamKeys) {
+      if (isDone(key, store)) {
+        continue;
+      }
+      evictCachedValue(key, store);
+      markDone(key, store);
+    }
+  }
+};
+
+// internal/src/set-state/stow-update.ts
+function shouldUpdateBeStowed(key, update) {
+  if (isTransceiver(update.newValue)) {
+    return false;
+  }
+  if (key.includes(`\u{1F441}\u200D\u{1F5E8}`)) {
+    return false;
+  }
+  return true;
+}
+var stowUpdate = (state, update, store) => {
+  const { key } = state;
+  const target = newest(store);
+  if (target.transactionMeta === null || target.transactionMeta.phase !== `building`) {
+    store.logger.error(
+      `\u{1F41E}`,
+      `atom`,
+      key,
+      `stowUpdate called outside of a transaction. This is probably a bug.`
+    );
+    return;
+  }
+  const shouldStow = shouldUpdateBeStowed(key, update);
+  if (!shouldStow) {
+    return;
+  }
+  const atomUpdate = __spreadValues({ key }, update);
+  if (state.family) {
+    atomUpdate.family = state.family;
+  }
+  target.transactionMeta.update.updates.push(atomUpdate);
+  store.logger.info(
+    `\u{1F4C1}`,
+    `atom`,
+    key,
+    `stowed (`,
+    update.oldValue,
+    `->`,
+    update.newValue,
+    `)`
+  );
+};
+
+// internal/src/set-state/set-atom.ts
+var setAtom = (atom, next, store) => {
+  const target = newest(store);
+  const oldValue = readOrComputeValue(atom, store);
+  let newValue = copyMutableIfWithinTransaction(oldValue, atom, store);
+  newValue = become(next)(newValue);
+  store.logger.info(`\u{1F4DD}`, `atom`, atom.key, `set to`, newValue);
+  newValue = cacheValue(atom.key, newValue, atom.subject, store);
+  if (isAtomDefault(atom.key, store)) {
+    markAtomAsNotDefault(atom.key, store);
+  }
+  markDone(atom.key, store);
+  evictDownStream(atom, store);
+  const update = { oldValue, newValue };
+  if (target.transactionMeta === null || target.transactionMeta.phase === `applying`) {
+    emitUpdate(atom, update, store);
+  } else {
+    stowUpdate(atom, update, store);
+  }
+};
+
+// internal/src/set-state/set-atom-or-selector.ts
+var setAtomOrSelector = (state, value, store) => {
+  if (state.type === `selector`) {
+    state.set(value);
+  } else {
+    setAtom(state, value, store);
+  }
+};
+
+// internal/src/store/deposit.ts
+function deposit(state) {
+  const token = {
+    key: state.key,
+    type: state.type
+  };
+  if (`family` in state) {
+    token.family = state.family;
+  }
+  return token;
+}
+
+// ../rel8/junction/src/junction.ts
 var Junction = class {
   constructor(data, config) {
     this.relations = /* @__PURE__ */ new Map();
@@ -516,37 +767,7 @@ var Junction = class {
   }
 };
 
-// src/subject.ts
-var Subject = class {
-  constructor() {
-    this.subscribers = /* @__PURE__ */ new Map();
-  }
-  subscribe(key, subscriber) {
-    this.subscribers.set(key, subscriber);
-    const unsubscribe = () => this.unsubscribe(key);
-    return unsubscribe;
-  }
-  unsubscribe(key) {
-    this.subscribers.delete(key);
-  }
-  next(value) {
-    for (const subscriber of this.subscribers.values()) {
-      subscriber(value);
-    }
-  }
-};
-var StatefulSubject = class extends Subject {
-  constructor(initialState) {
-    super();
-    this.state = initialState;
-  }
-  next(value) {
-    this.state = value;
-    super.next(value);
-  }
-};
-
-// src/store/store.ts
+// internal/src/store/store.ts
 var Store = class {
   constructor(name, store = null) {
     this.parent = null;
@@ -591,7 +812,7 @@ var Store = class {
       name: `IMPLICIT_STORE`
     };
     this.loggers = [
-      new atom_io.AtomIOLogger(`warn`, (_, __, key) => !key.includes(`\u{1F441}\u200D\u{1F5E8}`))
+      new AtomIOLogger(`warn`, (_, __, key) => !key.includes(`\u{1F441}\u200D\u{1F5E8}`))
     ];
     this.logger = {
       error: (...messages) => {
@@ -645,7 +866,7 @@ var clearStore = (store) => {
   store.config = config;
 };
 
-// src/store/withdraw.ts
+// internal/src/store/withdraw.ts
 function withdraw(token, store) {
   var _a, _b, _c, _d;
   const target = newest(store);
@@ -656,7 +877,7 @@ function withdraw(token, store) {
   return void 0;
 }
 
-// src/store/withdraw-new-family-member.ts
+// internal/src/store/withdraw-new-family-member.ts
 function withdrawNewFamilyMember(token, store) {
   if (token.family) {
     store.logger.info(
@@ -674,318 +895,22 @@ function withdrawNewFamilyMember(token, store) {
       return state;
     }
   }
-  return void 0;
-}
-
-// src/families/create-atom-family.ts
-function createAtomFamily(options, store) {
-  const subject = new Subject();
-  const atomFamily = Object.assign(
-    (key) => {
-      const subKey = json.stringifyJson(key);
-      const family = { key: options.key, subKey };
-      const fullKey = `${options.key}(${subKey})`;
-      const existing = withdraw({ key: fullKey, type: `atom` }, store);
-      let token;
-      if (existing) {
-        token = deposit(existing);
-      } else {
-        const individualOptions = {
-          key: fullKey,
-          default: options.default instanceof Function ? options.default(key) : options.default
-        };
-        if (options.effects) {
-          individualOptions.effects = options.effects(key);
-        }
-        token = createAtom(individualOptions, family, store);
-        subject.next(token);
-      }
-      return token;
-    },
-    {
-      key: options.key,
-      type: `atom_family`,
-      subject
-    }
-  );
-  const target = newest(store);
-  target.families.set(options.key, atomFamily);
-  return atomFamily;
-}
-
-// src/operation.ts
-var openOperation = (token, store) => {
-  const target = newest(store);
-  if (target.operation.open) {
-    store.logger.error(
-      `\u274C`,
-      token.type,
-      token.key,
-      `failed to setState during a setState for "${target.operation.token.key}"`
-    );
-    return `rejection`;
-  }
-  target.operation = {
-    open: true,
-    done: /* @__PURE__ */ new Set(),
-    prev: /* @__PURE__ */ new Map(),
-    time: Date.now(),
-    token
-  };
-  store.logger.info(
-    `\u2B55`,
-    token.type,
-    token.key,
-    `operation start in store "${store.config.name}"${target.transactionMeta === null ? `` : ` ${target.transactionMeta.phase} "${target.transactionMeta.update.key}"`}`
-  );
-};
-var closeOperation = (store) => {
-  const target = newest(store);
-  if (target.operation.open) {
-    store.logger.info(
-      `\u{1F534}`,
-      target.operation.token.type,
-      target.operation.token.key,
-      `operation done in store "${store.config.name}"`
-    );
-  }
-  target.operation = { open: false };
-  store.subject.operationStatus.next(target.operation);
-};
-var isDone = (key, store) => {
-  const target = newest(store);
-  if (!target.operation.open) {
-    store.logger.warn(
-      `\u{1F41E}`,
-      `unknown`,
-      key,
-      `isDone called outside of an operation. This is probably a bug.`
-    );
-    return true;
-  }
-  return target.operation.done.has(key);
-};
-var markDone = (key, store) => {
-  const target = newest(store);
-  if (!target.operation.open) {
-    store.logger.warn(
-      `\u{1F41E}`,
-      `unknown`,
-      key,
-      `markDone called outside of an operation. This is probably a bug.`
-    );
-    return;
-  }
-  target.operation.done.add(key);
-};
-
-// src/set-state/become.ts
-var become = (nextVersionOfThing) => (originalThing) => nextVersionOfThing instanceof Function ? nextVersionOfThing(
-  originalThing instanceof Function ? originalThing() : originalThing
-) : nextVersionOfThing;
-
-// src/read-or-compute-value.ts
-var readOrComputeValue = (state, store) => {
-  if (isValueCached(state.key, store)) {
-    store.logger.info(`\u{1F4D6}`, state.type, state.key, `reading cached value`);
-    return readCachedValue(state.key, store);
-  }
-  if (state.type !== `atom`) {
-    store.logger.info(`\u{1F9EE}`, state.type, state.key, `computing value`);
-    return state.get();
-  }
-  const fallback = state.default instanceof Function ? state.default() : state.default;
-  store.logger.info(
-    `\u{1F481}`,
-    `atom`,
-    state.key,
-    `could not find cached value; using default`,
-    fallback
-  );
-  return state.default instanceof Function ? state.default() : state.default;
-};
-
-// src/set-state/copy-mutable-if-needed.ts
-function copyMutableIfNeeded(atom, transform, origin, target) {
-  const originValue = origin.valueMap.get(atom.key);
-  const targetValue = target.valueMap.get(atom.key);
-  if (originValue === targetValue) {
-    origin.logger.info(`\u{1F4C3}`, `atom`, `${atom.key}`, `copying`);
-    const jsonValue = transform.toJson(originValue);
-    const copiedValue = transform.fromJson(jsonValue);
-    target.valueMap.set(atom.key, copiedValue);
-    new Tracker(atom, origin);
-    return copiedValue;
-  }
-  return targetValue;
-}
-
-// src/set-state/copy-mutable-in-transaction.ts
-function copyMutableIfWithinTransaction(oldValue, atom, store) {
-  const target = newest(store);
-  const parent = target.parent;
-  if (parent !== null) {
-    if (`toJson` in atom && `fromJson` in atom) {
-      const copiedValue = copyMutableIfNeeded(atom, atom, parent, target);
-      return copiedValue;
-    }
-    if (`family` in atom) {
-      const family = parent.families.get(atom.family.key);
-      if (family && family.type === `atom_family`) {
-        const result = copyMutableFamilyMemberWithinTransaction(
-          atom,
-          family,
-          parent,
-          target
-        );
-        if (result) {
-          return result;
-        }
-      }
-    }
-  }
-  return oldValue;
-}
-function copyMutableFamilyMemberWithinTransaction(atom, family, origin, target) {
-  if (`toJson` in family && `fromJson` in family) {
-    const copyCreated = copyMutableIfNeeded(atom, family, origin, target);
-    return copyCreated;
-  }
-  return null;
-}
-
-// src/set-state/emit-update.ts
-var emitUpdate = (state, update, store) => {
-  store.logger.info(
-    `\u{1F4E2}`,
-    state.type,
-    state.key,
-    `went (`,
-    update.oldValue,
-    `->`,
-    update.newValue,
-    `) subscribers:`,
-    state.subject.subscribers
-  );
-  state.subject.next(update);
-};
-
-// src/set-state/evict-downstream.ts
-var evictDownStream = (atom, store) => {
-  const target = newest(store);
-  const downstreamKeys = target.selectorAtoms.getRelatedKeys(atom.key);
-  store.logger.info(
-    `\u{1F9F9}`,
-    atom.type,
-    atom.key,
-    downstreamKeys ? `evicting ${downstreamKeys.size} states downstream:` : `no downstream states`,
-    downstreamKeys != null ? downstreamKeys : `to evict`
-  );
-  if (downstreamKeys) {
-    if (target.operation.open) {
-      store.logger.info(
-        `\u{1F9F9}`,
-        atom.type,
-        atom.key,
-        `[ ${[...target.operation.done].join(`, `)} ] already done`
-      );
-    }
-    for (const key of downstreamKeys) {
-      if (isDone(key, store)) {
-        continue;
-      }
-      evictCachedValue(key, store);
-      markDone(key, store);
-    }
-  }
-};
-
-// src/set-state/stow-update.ts
-function shouldUpdateBeStowed(key, update) {
-  if (isTransceiver(update.newValue)) {
-    return false;
-  }
-  if (key.includes(`\u{1F441}\u200D\u{1F5E8}`)) {
-    return false;
-  }
-  return true;
-}
-var stowUpdate = (state, update, store) => {
-  const { key } = state;
-  const target = newest(store);
-  if (target.transactionMeta === null || target.transactionMeta.phase !== `building`) {
-    store.logger.error(
-      `\u{1F41E}`,
-      `atom`,
-      key,
-      `stowUpdate called outside of a transaction. This is probably a bug.`
-    );
-    return;
-  }
-  const shouldStow = shouldUpdateBeStowed(key, update);
-  if (!shouldStow) {
-    return;
-  }
-  const atomUpdate = __spreadValues({ key }, update);
-  if (state.family) {
-    atomUpdate.family = state.family;
-  }
-  target.transactionMeta.update.updates.push(atomUpdate);
-  store.logger.info(
-    `\u{1F4C1}`,
-    `atom`,
-    key,
-    `stowed (`,
-    update.oldValue,
-    `->`,
-    update.newValue,
-    `)`
-  );
-};
-
-// src/set-state/set-atom.ts
-var setAtom = (atom, next, store) => {
-  const target = newest(store);
-  const oldValue = readOrComputeValue(atom, store);
-  let newValue = copyMutableIfWithinTransaction(oldValue, atom, store);
-  newValue = become(next)(newValue);
-  store.logger.info(`\u{1F4DD}`, `atom`, atom.key, `set to`, newValue);
-  newValue = cacheValue(atom.key, newValue, atom.subject, store);
-  if (isAtomDefault(atom.key, store)) {
-    markAtomAsNotDefault(atom.key, store);
-  }
-  markDone(atom.key, store);
-  evictDownStream(atom, store);
-  const update = { oldValue, newValue };
-  if (target.transactionMeta === null || target.transactionMeta.phase === `applying`) {
-    emitUpdate(atom, update, store);
-  } else {
-    stowUpdate(atom, update, store);
-  }
-};
-
-// src/set-state/set-atom-or-selector.ts
-var setAtomOrSelector = (state, value, store) => {
-  if (state.type === `selector`) {
-    state.set(value);
-  } else {
-    setAtom(state, value, store);
-  }
-};
+  return void 0;
+}
 
-// src/keys.ts
+// internal/src/keys.ts
 var isAtomKey = (key, store) => newest(store).atoms.has(key);
 var isSelectorKey = (key, store) => newest(store).selectors.has(key);
 var isReadonlySelectorKey = (key, store) => newest(store).readonlySelectors.has(key);
 var isStateKey = (key, store) => isAtomKey(key, store) || isSelectorKey(key, store) || isReadonlySelectorKey(key, store);
 
-// src/selector/get-selector-dependency-keys.ts
+// internal/src/selector/get-selector-dependency-keys.ts
 var getSelectorDependencyKeys = (key, store) => {
   const sources = newest(store).selectorGraph.getRelationEntries({ downstreamSelectorKey: key }).filter(([_, { source }]) => source !== key).map(([_, { source }]) => source).filter((source) => isStateKey(source, store));
   return sources;
 };
 
-// src/selector/trace-selector-atoms.ts
+// internal/src/selector/trace-selector-atoms.ts
 var traceSelectorAtoms = (selectorKey, directDependencyKey, store) => {
   const rootKeys = [];
   const indirectDependencyKeys = getSelectorDependencyKeys(
@@ -1018,11 +943,11 @@ var traceAllSelectorAtoms = (selectorKey, store) => {
   );
 };
 
-// src/selector/update-selector-atoms.ts
+// internal/src/selector/update-selector-atoms.ts
 var updateSelectorAtoms = (selectorKey, dependency, store) => {
-  const core = newest(store);
+  const target = newest(store);
   if (dependency.type === `atom`) {
-    core.selectorAtoms = core.selectorAtoms.set({
+    target.selectorAtoms.set({
       selectorKey,
       atomKey: dependency.key
     });
@@ -1041,7 +966,7 @@ var updateSelectorAtoms = (selectorKey, dependency, store) => {
       `discovers root atoms: [ ${rootKeys.map((key) => `"${key}"`).join(`, `)} ]`
     );
     for (const atomKey of rootKeys) {
-      core.selectorAtoms = core.selectorAtoms.set({
+      target.selectorAtoms = target.selectorAtoms.set({
         selectorKey,
         atomKey
       });
@@ -1049,7 +974,7 @@ var updateSelectorAtoms = (selectorKey, dependency, store) => {
   }
 };
 
-// src/selector/register-selector.ts
+// internal/src/selector/register-selector.ts
 var registerSelector = (selectorKey, store) => ({
   get: (dependency) => {
     const target = newest(store);
@@ -1070,7 +995,7 @@ var registerSelector = (selectorKey, store) => ({
       `)`
     );
     if (!alreadyRegistered) {
-      target.selectorGraph = target.selectorGraph.set(
+      target.selectorGraph.set(
         {
           upstreamSelectorKey: dependency.key,
           downstreamSelectorKey: selectorKey
@@ -1094,7 +1019,7 @@ var registerSelector = (selectorKey, store) => ({
   }
 });
 
-// src/selector/create-read-write-selector.ts
+// internal/src/selector/create-read-write-selector.ts
 var createReadWriteSelector = (options, family, store) => {
   const target = newest(store);
   const subject = new Subject();
@@ -1117,125 +1042,442 @@ var createReadWriteSelector = (options, family, store) => {
       newValue,
       `)`
     );
-    cacheValue(options.key, newValue, subject, store);
-    markDone(options.key, store);
-    if (target.transactionMeta === null) {
-      subject.next({ newValue, oldValue });
-    }
-    options.set({ get, set }, newValue);
-  };
-  const mySelector = __spreadValues(__spreadProps(__spreadValues({}, options), {
-    subject,
-    install: (s) => createSelector(options, family, s),
-    get: getSelf,
-    set: setSelf,
-    type: `selector`
-  }), family && { family });
-  target.selectors.set(options.key, mySelector);
-  const initialValue = getSelf();
-  store.logger.info(`\u2728`, mySelector.type, mySelector.key, `=`, initialValue);
-  const token = {
-    key: options.key,
-    type: `selector`
-  };
-  if (family) {
-    token.family = family;
+    cacheValue(options.key, newValue, subject, store);
+    markDone(options.key, store);
+    if (target.transactionMeta === null) {
+      subject.next({ newValue, oldValue });
+    }
+    options.set({ get, set }, newValue);
+  };
+  const mySelector = __spreadValues(__spreadProps(__spreadValues({}, options), {
+    subject,
+    install: (s) => createSelector(options, family, s),
+    get: getSelf,
+    set: setSelf,
+    type: `selector`
+  }), family && { family });
+  target.selectors.set(options.key, mySelector);
+  const initialValue = getSelf();
+  store.logger.info(`\u2728`, mySelector.type, mySelector.key, `=`, initialValue);
+  const token = {
+    key: options.key,
+    type: `selector`
+  };
+  if (family) {
+    token.family = family;
+  }
+  store.subject.selectorCreation.next(token);
+  return token;
+};
+
+// internal/src/selector/create-readonly-selector.ts
+var createReadonlySelector = (options, family, store) => {
+  const target = newest(store);
+  const subject = new Subject();
+  const { get } = registerSelector(options.key, store);
+  const getSelf = () => {
+    const value = options.get({ get });
+    cacheValue(options.key, value, subject, store);
+    return value;
+  };
+  const readonlySelector = __spreadValues(__spreadProps(__spreadValues({}, options), {
+    subject,
+    install: (s) => createSelector(options, family, s),
+    get: getSelf,
+    type: `readonly_selector`
+  }), family && { family });
+  target.readonlySelectors.set(options.key, readonlySelector);
+  const initialValue = getSelf();
+  store.logger.info(
+    `\u2728`,
+    readonlySelector.type,
+    readonlySelector.key,
+    `=`,
+    initialValue
+  );
+  const token = {
+    key: options.key,
+    type: `readonly_selector`
+  };
+  if (family) {
+    token.family = family;
+  }
+  store.subject.selectorCreation.next(token);
+  return token;
+};
+
+// internal/src/selector/create-selector.ts
+function createSelector(options, family, store) {
+  const target = newest(store);
+  const existingWritable = target.selectors.get(options.key);
+  const existingReadonly = target.readonlySelectors.get(options.key);
+  if (existingWritable || existingReadonly) {
+    store.logger.error(
+      `\u274C`,
+      existingReadonly ? `readonly_selector` : `selector`,
+      options.key,
+      `Tried to create selector, but it already exists in the store. (Ignore if you are in development using hot module replacement.)`
+    );
+  }
+  if (`set` in options) {
+    return createReadWriteSelector(options, family, store);
+  }
+  return createReadonlySelector(options, family, store);
+}
+
+// internal/src/selector/delete-selector.ts
+function deleteSelector(selectorToken, store) {
+  const target = newest(store);
+  const { key } = selectorToken;
+  switch (selectorToken.type) {
+    case `selector`:
+      target.selectors.delete(key);
+      break;
+    case `readonly_selector`:
+      target.readonlySelectors.delete(key);
+      break;
+  }
+  target.valueMap.delete(key);
+  target.selectorAtoms.delete(key);
+  const downstreamTokens = target.selectorGraph.getRelationEntries({ upstreamSelectorKey: key }).filter(([_, { source }]) => source === key).map(
+    ([downstreamSelectorKey]) => {
+      var _a;
+      return (_a = target.selectors.get(downstreamSelectorKey)) != null ? _a : target.readonlySelectors.get(downstreamSelectorKey);
+    }
+  );
+  for (const downstreamToken of downstreamTokens) {
+    if (downstreamToken) {
+      deleteSelector(downstreamToken, store);
+    }
+  }
+  target.selectorGraph.delete(key);
+  store.logger.info(`\u{1F525}`, selectorToken.type, `${key}`, `deleted`);
+}
+
+// internal/src/subscribe/recall-state.ts
+var recallState = (state, store) => {
+  const target = newest(store);
+  if (!target.operation.open) {
+    return target.valueMap.get(state.key);
+  }
+  return target.operation.prev.get(state.key);
+};
+
+// internal/src/subscribe/subscribe-to-root-atoms.ts
+var subscribeToRootAtoms = (state, store) => {
+  const dependencySubscriptions = `default` in state ? null : traceAllSelectorAtoms(state.key, store).map((atomKey) => {
+    const atom = store.atoms.get(atomKey);
+    if (atom === void 0) {
+      throw new Error(
+        `Atom "${atomKey}", a dependency of selector "${state.key}", not found in store "${store.config.name}".`
+      );
+    }
+    return atom.subject.subscribe(
+      `${state.type}:${state.key}`,
+      (atomChange) => {
+        store.logger.info(
+          `\u{1F4E2}`,
+          state.type,
+          state.key,
+          `root`,
+          atomKey,
+          `went`,
+          atomChange.oldValue,
+          `->`,
+          atomChange.newValue
+        );
+        const oldValue = recallState(state, store);
+        const newValue = readOrComputeValue(state, store);
+        store.logger.info(
+          `\u2728`,
+          state.type,
+          state.key,
+          `went`,
+          oldValue,
+          `->`,
+          newValue
+        );
+        state.subject.next({ newValue, oldValue });
+      }
+    );
+  });
+  return dependencySubscriptions;
+};
+
+// internal/src/subscribe/subscribe-to-state.ts
+function subscribeToState(token, handleUpdate, key, store) {
+  const state = withdraw(token, store);
+  if (state === void 0) {
+    throw new Error(
+      `State "${token.key}" not found in this store. Did you forget to initialize with the "atom" or "selector" function?`
+    );
+  }
+  const unsubFunction = state.subject.subscribe(key, handleUpdate);
+  store.logger.info(`\u{1F440}`, state.type, state.key, `Adding subscription "${key}"`);
+  const dependencyUnsubFunctions = state.type !== `atom` ? subscribeToRootAtoms(state, store) : null;
+  const unsubscribe = dependencyUnsubFunctions === null ? () => {
+    store.logger.info(
+      `\u{1F648}`,
+      state.type,
+      state.key,
+      `Removing subscription "${key}"`
+    );
+    unsubFunction();
+  } : () => {
+    store.logger.info(
+      `\u{1F648}`,
+      state.type,
+      state.key,
+      `Removing subscription "${key}"`
+    );
+    unsubFunction();
+    for (const unsubFromDependency of dependencyUnsubFunctions) {
+      unsubFromDependency();
+    }
+  };
+  return unsubscribe;
+}
+
+// internal/src/subscribe/subscribe-to-timeline.ts
+var subscribeToTimeline = (token, handleUpdate, key, store) => {
+  const tl = withdraw(token, store);
+  if (tl === void 0) {
+    throw new Error(
+      `Cannot subscribe to timeline "${token.key}": timeline not found in store "${store.config.name}".`
+    );
+  }
+  store.logger.info(`\u{1F440}`, `timeline`, token.key, `Adding subscription "${key}"`);
+  const unsubscribe = tl.subject.subscribe(key, handleUpdate);
+  return () => {
+    store.logger.info(
+      `\u{1F648}`,
+      `timeline`,
+      token.key,
+      `Removing subscription "${key}" from timeline`
+    );
+    unsubscribe();
+  };
+};
+
+// internal/src/subscribe/subscribe-to-transaction.ts
+var subscribeToTransaction = (token, handleUpdate, key, store) => {
+  const tx = withdraw(token, store);
+  if (tx === void 0) {
+    throw new Error(
+      `Cannot subscribe to transaction "${token.key}": transaction not found in store "${store.config.name}".`
+    );
+  }
+  store.logger.info(
+    `\u{1F440}`,
+    `transaction`,
+    token.key,
+    `Adding subscription "${key}"`
+  );
+  const unsubscribe = tx.subject.subscribe(key, handleUpdate);
+  return () => {
+    store.logger.info(
+      `\u{1F648}`,
+      `transaction`,
+      token.key,
+      `Removing subscription "${key}"`
+    );
+    unsubscribe();
+  };
+};
+
+// internal/src/mutable/tracker.ts
+var Tracker = class {
+  constructor(mutableState, store) {
+    this.unsubscribeFromInnerValue = null;
+    this.mutableState = mutableState;
+    const target = newest(store);
+    this.latestUpdateState = this.initializeState(mutableState, target);
+    this.observeCore(mutableState, this.latestUpdateState, target);
+    this.updateCore(mutableState, this.latestUpdateState, target);
+    target.trackers.set(mutableState.key, this);
+  }
+  initializeState(mutableState, store) {
+    const latestUpdateStateKey = `*${mutableState.key}`;
+    deleteAtom({ type: `atom`, key: latestUpdateStateKey }, store);
+    const familyMetaData = mutableState.family ? {
+      key: `*${mutableState.family.key}`,
+      subKey: mutableState.family.subKey
+    } : void 0;
+    const latestUpdateState = createAtom(
+      {
+        key: latestUpdateStateKey,
+        default: null
+      },
+      familyMetaData,
+      store
+    );
+    return latestUpdateState;
+  }
+  observeCore(mutableState, latestUpdateState, store) {
+    const originalInnerValue = getState(mutableState, store);
+    const target = newest(store);
+    this.unsubscribeFromInnerValue = originalInnerValue.subscribe(
+      `tracker:${store.config.name}:${target.transactionMeta === null ? `main` : target.transactionMeta.update.key}`,
+      (update) => {
+        const unsubscribe = store.subject.operationStatus.subscribe(
+          mutableState.key,
+          () => {
+            unsubscribe();
+            setState(latestUpdateState, update, store);
+          }
+        );
+      }
+    );
+    subscribeToState(
+      mutableState,
+      (update) => {
+        var _a;
+        if (update.newValue !== update.oldValue) {
+          (_a = this.unsubscribeFromInnerValue) == null ? void 0 : _a.call(this);
+          const target2 = newest(store);
+          this.unsubscribeFromInnerValue = update.newValue.subscribe(
+            `tracker:${store.config.name}:${target2.transactionMeta === null ? `main` : target2.transactionMeta.update.key}`,
+            (update2) => {
+              const unsubscribe = store.subject.operationStatus.subscribe(
+                mutableState.key,
+                () => {
+                  unsubscribe();
+                  setState(latestUpdateState, update2, store);
+                }
+              );
+            }
+          );
+        }
+      },
+      `${store.config.name}: tracker observing inner value`,
+      store
+    );
+  }
+  updateCore(mutableState, latestUpdateState, store) {
+    subscribeToState(
+      latestUpdateState,
+      ({ newValue, oldValue }) => {
+        const timelineId = store.timelineAtoms.getRelatedKey(
+          latestUpdateState.key
+        );
+        if (timelineId) {
+          const timelineData = store.timelines.get(timelineId);
+          if (timelineData == null ? void 0 : timelineData.timeTraveling) {
+            const unsubscribe2 = subscribeToTimeline(
+              { key: timelineId, type: `timeline` },
+              (update) => {
+                unsubscribe2();
+                setState(
+                  mutableState,
+                  (transceiver) => {
+                    if (update === `redo` && newValue) {
+                      transceiver.do(newValue);
+                    } else if (update === `undo` && oldValue) {
+                      transceiver.undo(oldValue);
+                    }
+                    return transceiver;
+                  },
+                  store
+                );
+              },
+              `${mutableState.key}: tracker observing timeline`,
+              store
+            );
+            return;
+          }
+        }
+        const unsubscribe = store.subject.operationStatus.subscribe(
+          latestUpdateState.key,
+          () => {
+            unsubscribe();
+            const mutable = getState(mutableState, store);
+            const updateNumber = mutable.getUpdateNumber(newValue);
+            const eventOffset = updateNumber - mutable.cacheUpdateNumber;
+            if (newValue && eventOffset === 1) {
+              setState(
+                mutableState,
+                (transceiver) => (transceiver.do(newValue), transceiver),
+                store
+              );
+            }
+          }
+        );
+      },
+      `${store.config.name}: tracker observing latest update`,
+      store
+    );
   }
-  store.subject.selectorCreation.next(token);
-  return token;
 };
 
-// src/selector/create-readonly-selector.ts
-var createReadonlySelector = (options, family, store) => {
-  const target = newest(store);
-  const subject = new Subject();
-  const { get } = registerSelector(options.key, store);
-  const getSelf = () => {
-    const value = options.get({ get });
-    cacheValue(options.key, value, subject, store);
-    return value;
-  };
-  const readonlySelector = __spreadValues(__spreadProps(__spreadValues({}, options), {
-    subject,
-    install: (s) => createSelector(options, family, s),
-    get: getSelf,
-    type: `readonly_selector`
-  }), family && { family });
-  target.readonlySelectors.set(options.key, readonlySelector);
-  const initialValue = getSelf();
+// internal/src/mutable/create-mutable-atom.ts
+function createMutableAtom(options, store) {
   store.logger.info(
-    `\u2728`,
-    readonlySelector.type,
-    readonlySelector.key,
-    `=`,
-    initialValue
+    `\u{1F527}`,
+    `atom`,
+    options.key,
+    `creating in store "${store.config.name}"`
   );
-  const token = {
-    key: options.key,
-    type: `readonly_selector`
-  };
-  if (family) {
-    token.family = family;
-  }
-  store.subject.selectorCreation.next(token);
-  return token;
-};
-
-// src/selector/create-selector.ts
-function createSelector(options, family, store) {
+  const coreState = createAtom(options, void 0, store);
+  new Tracker(coreState, store);
+  const jsonState = selectJson(coreState, options, store);
   const target = newest(store);
-  const existingWritable = target.selectors.get(options.key);
-  const existingReadonly = target.readonlySelectors.get(options.key);
-  if (existingWritable || existingReadonly) {
-    store.logger.error(
-      `\u274C`,
-      existingReadonly ? `readonly_selector` : `selector`,
-      options.key,
-      `Tried to create selector, but it already exists in the store. (Ignore if you are in development using hot module replacement.)`
-    );
-  }
-  if (`set` in options) {
-    return createReadWriteSelector(options, family, store);
-  }
-  return createReadonlySelector(options, family, store);
+  subscribeToState(
+    jsonState,
+    () => {
+      const trackerHasBeenInitialized = newest(store).trackers.has(coreState.key);
+      if (!trackerHasBeenInitialized) {
+        new Tracker(coreState, store);
+      }
+    },
+    `tracker-initializer:${store == null ? void 0 : store.config.name}:${target.transactionMeta === null ? `main` : `${target.transactionMeta.update.key}`}`,
+    store
+  );
+  return coreState;
 }
 
-// src/selector/delete-selector.ts
-function deleteSelector(selectorToken, store) {
-  const target = newest(store);
-  const { key } = selectorToken;
-  switch (selectorToken.type) {
-    case `selector`:
-      target.selectors.delete(key);
-      break;
-    case `readonly_selector`:
-      target.readonlySelectors.delete(key);
-      break;
-  }
-  target.valueMap.delete(key);
-  target.selectorAtoms.delete(key);
-  const downstreamTokens = target.selectorGraph.getRelationEntries({ upstreamSelectorKey: key }).filter(([_, { source }]) => source === key).map(
-    ([downstreamSelectorKey]) => {
-      var _a;
-      return (_a = target.selectors.get(downstreamSelectorKey)) != null ? _a : target.readonlySelectors.get(downstreamSelectorKey);
+// internal/src/families/create-atom-family.ts
+function createAtomFamily(options, store) {
+  const subject = new Subject();
+  const atomFamily = Object.assign(
+    (key) => {
+      const subKey = stringifyJson(key);
+      const family = { key: options.key, subKey };
+      const fullKey = `${options.key}(${subKey})`;
+      const existing = withdraw({ key: fullKey, type: `atom` }, store);
+      let token;
+      if (existing) {
+        token = deposit(existing);
+      } else {
+        const individualOptions = {
+          key: fullKey,
+          default: options.default instanceof Function ? options.default(key) : options.default
+        };
+        if (options.effects) {
+          individualOptions.effects = options.effects(key);
+        }
+        token = createAtom(individualOptions, family, store);
+        subject.next(token);
+      }
+      return token;
+    },
+    {
+      key: options.key,
+      type: `atom_family`,
+      subject
     }
   );
-  for (const downstreamToken of downstreamTokens) {
-    if (downstreamToken) {
-      deleteSelector(downstreamToken, store);
-    }
-  }
-  target.selectorGraph.delete(key);
-  store.logger.info(`\u{1F525}`, selectorToken.type, `${key}`, `deleted`);
+  const target = newest(store);
+  target.families.set(options.key, atomFamily);
+  return atomFamily;
 }
 
-// src/families/create-readonly-selector-family.ts
+// internal/src/families/create-readonly-selector-family.ts
 function createReadonlySelectorFamily(options, store) {
   const subject = new Subject();
   return Object.assign(
     (key) => {
       const target = newest(store);
-      const subKey = json.stringifyJson(key);
+      const subKey = stringifyJson(key);
       const family = { key: options.key, subKey };
       const fullKey = `${options.key}(${subKey})`;
       const existing = target.readonlySelectors.get(fullKey);
@@ -1258,6 +1500,8 @@ function createReadonlySelectorFamily(options, store) {
     }
   );
 }
+
+// internal/src/families/create-selector-family.ts
 function createSelectorFamily(options, store) {
   const isReadonly = !(`set` in options);
   if (isReadonly) {
@@ -1267,7 +1511,7 @@ function createSelectorFamily(options, store) {
   const subject = new Subject();
   const selectorFamily = Object.assign(
     (key) => {
-      const subKey = json.stringifyJson(key);
+      const subKey = stringifyJson(key);
       const family = { key: options.key, subKey };
       const fullKey = `${options.key}(${subKey})`;
       const existing = target.selectors.get(fullKey);
@@ -1295,7 +1539,7 @@ function createSelectorFamily(options, store) {
   return selectorFamily;
 }
 
-// src/mutable/tracker-family.ts
+// internal/src/mutable/tracker-family.ts
 var FamilyTracker = class {
   constructor(findMutableState, store) {
     this.findLatestUpdateState = createAtomFamily(
@@ -1310,7 +1554,7 @@ var FamilyTracker = class {
       `store=${store.config.name}::tracker-atom-family`,
       (atomToken) => {
         if (atomToken.family) {
-          const key = json.parseJson(atomToken.family.subKey);
+          const key = parseJson(atomToken.family.subKey);
           this.findLatestUpdateState(key);
           new Tracker(atomToken, store);
         }
@@ -1320,7 +1564,7 @@ var FamilyTracker = class {
       `store=${store.config.name}::tracker-atom-family`,
       (atomToken) => {
         if (atomToken.family) {
-          const key = json.parseJson(atomToken.family.subKey);
+          const key = parseJson(atomToken.family.subKey);
           const mutableAtomToken = this.findMutableState(key);
           new Tracker(mutableAtomToken, store);
         }
@@ -1329,18 +1573,18 @@ var FamilyTracker = class {
   }
 };
 
-// src/mutable/create-mutable-atom-family.ts
+// internal/src/mutable/create-mutable-atom-family.ts
 function createMutableAtomFamily(options, store) {
   const coreFamily = Object.assign(
     createAtomFamily(options, store),
     options
   );
-  json.selectJsonFamily(coreFamily, options);
+  selectJsonFamily(coreFamily, options);
   new FamilyTracker(coreFamily, store);
   return coreFamily;
 }
 
-// src/mutable/get-json-family.ts
+// internal/src/mutable/get-json-family.ts
 var getJsonFamily = (mutableAtomFamily, store) => {
   const target = newest(store);
   const key = `${mutableAtomFamily.key}:JSON`;
@@ -1350,7 +1594,7 @@ var getJsonFamily = (mutableAtomFamily, store) => {
   return jsonFamily;
 };
 
-// src/mutable/get-json-token.ts
+// internal/src/mutable/get-json-token.ts
 var getJsonToken = (mutableAtomToken) => {
   const key = mutableAtomToken.family ? `${mutableAtomToken.family.key}:JSON(${mutableAtomToken.family.subKey})` : `${mutableAtomToken.key}:JSON`;
   const jsonToken = { type: `selector`, key };
@@ -1363,7 +1607,7 @@ var getJsonToken = (mutableAtomToken) => {
   return jsonToken;
 };
 
-// src/mutable/get-update-token.ts
+// internal/src/mutable/get-update-token.ts
 var getUpdateToken = (mutableAtomToken) => {
   const key = `*${mutableAtomToken.key}`;
   const updateToken = { type: `atom`, key };
@@ -1376,20 +1620,20 @@ var getUpdateToken = (mutableAtomToken) => {
   return updateToken;
 };
 
-// src/mutable/is-atom-token-mutable.ts
+// internal/src/mutable/is-atom-token-mutable.ts
 function isAtomTokenMutable(token) {
   return token.key.endsWith(`::mutable`);
 }
 
-// src/mutable/transceiver.ts
+// internal/src/mutable/transceiver.ts
 function isTransceiver(value) {
   return typeof value === `object` && value !== null && `do` in value && `undo` in value && `subscribe` in value;
 }
 
-// src/mutable/index.ts
+// internal/src/mutable/index.ts
 var isAtomMutable = (atom) => `isMutable` in atom;
 
-// src/atom/is-default.ts
+// internal/src/atom/is-default.ts
 var isAtomDefault = (key, store) => {
   const core = newest(store);
   return core.atomsThatAreDefault.has(key);
@@ -1408,7 +1652,7 @@ var isSelectorDefault = (key, store) => {
   return rootKeys.every((rootKey) => isAtomDefault(rootKey, store));
 };
 
-// src/atom/create-atom.ts
+// internal/src/atom/create-atom.ts
 function createAtom(options, family, store) {
   store.logger.info(
     `\u{1F528}`,
@@ -1455,8 +1699,8 @@ function createAtom(options, family, store) {
     const cleanupFunctions = [];
     for (const effect of options.effects) {
       const cleanup = effect({
-        setSelf: (next) => atom_io.setState(token, next, store),
-        onSet: (handle) => atom_io.subscribe(token, handle, `effect[${effectIndex}]`, store)
+        setSelf: (next) => setState(token, next, store),
+        onSet: (handle) => subscribeToState(token, handle, `effect[${effectIndex}]`, store)
       });
       if (cleanup) {
         cleanupFunctions.push(cleanup);
@@ -1473,7 +1717,7 @@ function createAtom(options, family, store) {
   return token;
 }
 
-// src/atom/delete-atom.ts
+// internal/src/atom/delete-atom.ts
 function deleteAtom(atomToken, store) {
   var _a, _b;
   const target = newest(store);
@@ -1505,7 +1749,7 @@ function deleteAtom(atomToken, store) {
   store.logger.info(`\u{1F525}`, `atom`, `${key}`, `deleted`);
 }
 
-// src/lazy-map.ts
+// internal/src/lazy-map.ts
 var LazyMap = class extends Map {
   constructor(source) {
     super();
@@ -1539,7 +1783,7 @@ var LazyMap = class extends Map {
   }
 };
 
-// src/not-found-error.ts
+// internal/src/not-found-error.ts
 var capitalize = (str) => str[0].toUpperCase() + str.slice(1);
 function prettyPrintTokenType(token) {
   if (token.type === `readonly_selector`) {
@@ -1555,63 +1799,7 @@ var NotFoundError = class extends Error {
   }
 };
 
-// src/subscribe/recall-state.ts
-var recallState = (state, store) => {
-  const target = newest(store);
-  if (!target.operation.open) {
-    store.logger.warn(
-      `\u{1F41E}`,
-      state.type,
-      state.key,
-      `recall called outside of an operation. This is probably a bug.`
-    );
-    return target.valueMap.get(state.key);
-  }
-  return target.operation.prev.get(state.key);
-};
-
-// src/subscribe/subscribe-to-root-atoms.ts
-var subscribeToRootAtoms = (state, store) => {
-  const dependencySubscriptions = `default` in state ? null : traceAllSelectorAtoms(state.key, store).map((atomKey) => {
-    const atom = store.atoms.get(atomKey);
-    if (atom === void 0) {
-      throw new Error(
-        `Atom "${atomKey}", a dependency of selector "${state.key}", not found in store "${store.config.name}".`
-      );
-    }
-    return atom.subject.subscribe(
-      `${state.type}:${state.key}`,
-      (atomChange) => {
-        store.logger.info(
-          `\u{1F4E2}`,
-          state.type,
-          state.key,
-          `root`,
-          atomKey,
-          `went`,
-          atomChange.oldValue,
-          `->`,
-          atomChange.newValue
-        );
-        const oldValue = recallState(state, store);
-        const newValue = readOrComputeValue(state, store);
-        store.logger.info(
-          `\u2728`,
-          state.type,
-          state.key,
-          `went`,
-          oldValue,
-          `->`,
-          newValue
-        );
-        state.subject.next({ newValue, oldValue });
-      }
-    );
-  });
-  return dependencySubscriptions;
-};
-
-// src/timeline/add-atom-to-timeline.ts
+// internal/src/timeline/add-atom-to-timeline.ts
 var addAtomToTimeline = (atomToken, tl, store) => {
   const atom = withdraw(atomToken, store);
   if (atom === void 0) {
@@ -1803,7 +1991,7 @@ var addAtomToTimeline = (atomToken, tl, store) => {
   });
 };
 
-// src/timeline/create-timeline.ts
+// internal/src/timeline/create-timeline.ts
 function createTimeline(options, store, data) {
   var _a, _b;
   const tl = __spreadProps(__spreadValues({
@@ -1874,6 +2062,8 @@ function createTimeline(options, store, data) {
   store.subject.timelineCreation.next(token);
   return token;
 }
+
+// internal/src/timeline/time-travel.ts
 var timeTravel = (direction, token, store) => {
   const action = direction === `forward` ? `redo` : `undo`;
   store.logger.info(
@@ -1909,7 +2099,7 @@ var timeTravel = (direction, token, store) => {
   const updateValues = (atomUpdate) => {
     const { key, newValue, oldValue } = atomUpdate;
     const value = direction === `forward` ? newValue : oldValue;
-    atom_io.setState({ key, type: `atom` }, value, store);
+    setState({ key, type: `atom` }, value, store);
   };
   const updateValuesFromTransactionUpdate = (transactionUpdate) => {
     const updates = direction === `forward` ? transactionUpdate.updates : [...transactionUpdate.updates].reverse();
@@ -1951,7 +2141,7 @@ var timeTravel = (direction, token, store) => {
   );
 };
 
-// src/transaction/abort-transaction.ts
+// internal/src/transaction/abort-transaction.ts
 var abortTransaction = (store) => {
   const target = newest(store);
   if (target.transactionMeta === null || target.parent === null) {
@@ -1971,6 +2161,8 @@ var abortTransaction = (store) => {
   );
   target.parent.child = null;
 };
+
+// internal/src/transaction/apply-transaction.ts
 function ingestAtomUpdate(update, parent, child) {
   var _a, _b, _c;
   const { key, newValue } = update;
@@ -1998,7 +2190,7 @@ function ingestAtomUpdate(update, parent, child) {
       );
     }
   }
-  atom_io.setState(token, newValue, parent);
+  setState(token, newValue, parent);
 }
 function ingestTransactionUpdate(transactionUpdate, parent, child) {
   for (const update of transactionUpdate.updates) {
@@ -2054,7 +2246,7 @@ var applyTransaction = (output, store) => {
   parent.subject.transactionApplying.next(null);
 };
 
-// src/transaction/build-transaction.ts
+// internal/src/transaction/build-transaction.ts
 var buildTransaction = (key, params, store) => {
   const parent = newest(store);
   parent.child = {
@@ -2098,6 +2290,8 @@ var buildTransaction = (key, params, store) => {
     params
   );
 };
+
+// internal/src/transaction/create-transaction.ts
 function createTransaction(options, store) {
   const newTransaction = {
     key: options.key,
@@ -2107,9 +2301,9 @@ function createTransaction(options, store) {
       try {
         const output = options.do(
           {
-            get: (token2) => atom_io.getState(token2, store),
-            set: (token2, value) => atom_io.setState(token2, value, store),
-            run: (token2) => atom_io.runTransaction(token2, store)
+            get: (token2) => getState(token2, store),
+            set: (token2, value) => setState(token2, value, store),
+            run: (token2) => runTransaction(token2, store)
           },
           ...params
         );
@@ -2130,6 +2324,8 @@ function createTransaction(options, store) {
   store.subject.transactionCreation.next(token);
   return token;
 }
+
+// internal/src/transaction/redo-transaction.ts
 var redoTransactionUpdate = (transactionUpdate, store) => {
   store.logger.info(`\u23ED\uFE0F`, `transaction`, transactionUpdate.key, `Redo`);
   for (const update of transactionUpdate.updates) {
@@ -2142,12 +2338,14 @@ var redoTransactionUpdate = (transactionUpdate, store) => {
           `State "${token.key}" not found in this store. This is surprising, because we are navigating the history of the store.`
         );
       }
-      atom_io.setState(state, newValue, store);
+      setState(state, newValue, store);
     } else {
       redoTransactionUpdate(update, store);
     }
   }
 };
+
+// internal/src/transaction/undo-transaction.ts
 var undoTransactionUpdate = (transactionUpdate, store) => {
   store.logger.info(`\u23EE\uFE0F`, `transaction`, transactionUpdate.key, `Undo`);
   for (const update of transactionUpdate.updates.reverse()) {
@@ -2160,14 +2358,14 @@ var undoTransactionUpdate = (transactionUpdate, store) => {
           `State "${token.key}" not found in this store. This is surprising, because we are navigating the history of the store.`
         );
       }
-      atom_io.setState(state, newValue, store);
+      setState(state, newValue, store);
     } else {
       undoTransactionUpdate(update, store);
     }
   }
 };
 
-// src/transaction/index.ts
+// internal/src/transaction/index.ts
 var TRANSACTION_PHASES = [`idle`, `building`, `applying`];
 
 exports.FamilyTracker = FamilyTracker;
@@ -2228,6 +2426,9 @@ exports.redoTransactionUpdate = redoTransactionUpdate;
 exports.registerSelector = registerSelector;
 exports.setAtomOrSelector = setAtomOrSelector;
 exports.subscribeToRootAtoms = subscribeToRootAtoms;
+exports.subscribeToState = subscribeToState;
+exports.subscribeToTimeline = subscribeToTimeline;
+exports.subscribeToTransaction = subscribeToTransaction;
 exports.timeTravel = timeTravel;
 exports.traceAllSelectorAtoms = traceAllSelectorAtoms;
 exports.traceSelectorAtoms = traceSelectorAtoms;