atom.io 0.9.9 → 0.9.10

package/internal/dist/index.mjs

@@ -52,94 +52,6 @@ function deposit(state) {
   return token;
 }
 
-// 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);
-    }
-  }
-};
-
-// src/transaction/abort-transaction.ts
-var abortTransaction = (store) => {
-  var _a, _b;
-  if (store.transactionStatus.phase === `idle`) {
-    (_a = store.config.logger) == null ? void 0 : _a.warn(
-      `abortTransaction called outside of a transaction. This is probably a bug.`
-    );
-    return;
-  }
-  store.transactionStatus = { phase: `idle` };
-  (_b = store.config.logger) == null ? void 0 : _b.info(`\u{1FA82}`, `transaction fail`);
-};
-var applyTransaction = (output, store) => {
-  var _a, _b, _c, _d, _e;
-  if (store.transactionStatus.phase !== `building`) {
-    (_a = store.config.logger) == null ? void 0 : _a.warn(
-      `abortTransaction called outside of a transaction. This is probably a bug.`
-    );
-    return;
-  }
-  store.transactionStatus.phase = `applying`;
-  store.transactionStatus.output = output;
-  const { atomUpdates } = store.transactionStatus;
-  (_b = store.config.logger) == null ? void 0 : _b.info(
-    `\u{1F6C3} applying transaction "${store.transactionStatus.key}" with ${atomUpdates.length} updates.`
-  );
-  (_c = store.config.logger) == null ? void 0 : _c.info(`\u{1F6C3} the updates are:`, atomUpdates);
-  for (const { key, newValue } of atomUpdates) {
-    const token = { key, type: `atom` };
-    if (!store.valueMap.has(token.key)) {
-      if (token.family) {
-        const family = store.families.get(token.family.key);
-        if (family) {
-          family(token.family.subKey);
-        }
-      } else {
-        const newAtom = store.transactionStatus.core.atoms.get(token.key);
-        if (!newAtom) {
-          throw new Error(
-            `Absurd Error: Atom "${token.key}" not found while copying updates from transaction "${store.transactionStatus.key}" to store "${store.config.name}"`
-          );
-        }
-        store.atoms.set(newAtom.key, newAtom);
-        store.valueMap.set(newAtom.key, newAtom.default);
-        (_d = store.config.logger) == null ? void 0 : _d.info(`\u{1F527}`, `add atom "${newAtom.key}"`);
-      }
-    }
-    setState(token, newValue, store);
-  }
-  const myTransaction = withdraw(
-    { key: store.transactionStatus.key, type: `transaction` },
-    store
-  );
-  if (myTransaction === void 0) {
-    throw new Error(
-      `Transaction "${store.transactionStatus.key}" not found. Absurd. How is this running?`
-    );
-  }
-  myTransaction.subject.next({
-    key: store.transactionStatus.key,
-    atomUpdates,
-    output,
-    params: store.transactionStatus.params
-  });
-  store.transactionStatus = { phase: `idle` };
-  (_e = store.config.logger) == null ? void 0 : _e.info(`\u{1F6EC}`, `transaction "${myTransaction.key}" applied`);
-};
-
 // ../../rel8/junction/src/junction.ts
 var Junction = class {
   constructor(data, config) {
@@ -338,6 +250,180 @@ 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);
+    }
+  }
+};
+
+// src/store/store.ts
+var Store = class {
+  constructor(name, store = null) {
+    this.valueMap = /* @__PURE__ */ new Map();
+    this.atoms = /* @__PURE__ */ new Map();
+    this.selectors = /* @__PURE__ */ new Map();
+    this.readonlySelectors = /* @__PURE__ */ new Map();
+    this.trackers = /* @__PURE__ */ new Map();
+    this.families = /* @__PURE__ */ new Map();
+    this.timelines = /* @__PURE__ */ new Map();
+    this.transactions = /* @__PURE__ */ new Map();
+    this.atomsThatAreDefault = /* @__PURE__ */ new Set();
+    this.timelineAtoms = new Junction({
+      between: [`timelineKey`, `atomKey`],
+      cardinality: `1:n`
+    });
+    this.selectorAtoms = new Junction({
+      between: [`selectorKey`, `atomKey`],
+      cardinality: `n:n`
+    });
+    this.selectorGraph = new Junction(
+      {
+        between: [`upstreamSelectorKey`, `downstreamSelectorKey`],
+        cardinality: `n:n`
+      },
+      {
+        makeContentKey: (...keys) => keys.sort().join(`:`)
+      }
+    );
+    this.subject = {
+      atomCreation: new Subject(),
+      selectorCreation: new Subject(),
+      transactionCreation: new Subject(),
+      timelineCreation: new Subject(),
+      operationStatus: new Subject()
+    };
+    this.operation = { open: false };
+    this.transactionStatus = { phase: `idle` };
+    this.config = {
+      name: `IMPLICIT_STORE`,
+      logger: __spreadProps(__spreadValues({}, console), { info: () => void 0 }),
+      logger__INTERNAL: console
+    };
+    var _a;
+    if (store !== null) {
+      this.valueMap = new Map(store == null ? void 0 : store.valueMap);
+      this.operation = __spreadValues({}, store == null ? void 0 : store.operation);
+      this.transactionStatus = __spreadValues({}, store == null ? void 0 : store.transactionStatus);
+      this.config = __spreadProps(__spreadValues({}, store == null ? void 0 : store.config), {
+        logger__INTERNAL: console,
+        logger: __spreadValues(__spreadProps(__spreadValues({}, console), {
+          info: () => void 0
+        }), (_a = store == null ? void 0 : store.config) == null ? void 0 : _a.logger),
+        name
+      });
+      for (const [, atom] of store.atoms) {
+        atom.install(this);
+      }
+      for (const [, selector] of store.readonlySelectors) {
+        selector.install(this);
+      }
+      for (const [, selector] of store.selectors) {
+        selector.install(this);
+      }
+      for (const [, tx] of store.transactions) {
+        tx.install(this);
+      }
+      for (const [, timeline] of store.timelines) {
+        timeline.install(this);
+      }
+    }
+  }
+};
+var IMPLICIT = {
+  STORE_INTERNAL: void 0,
+  get STORE() {
+    var _a;
+    return (_a = this.STORE_INTERNAL) != null ? _a : this.STORE_INTERNAL = new Store(`IMPLICIT_STORE`);
+  }
+};
+var clearStore = (store = IMPLICIT.STORE) => {
+  const { config } = store;
+  Object.assign(store, new Store(config.name));
+  store.config = config;
+};
+
+// src/transaction/abort-transaction.ts
+var abortTransaction = (store) => {
+  var _a, _b;
+  if (store.transactionStatus.phase === `idle`) {
+    (_a = store.config.logger) == null ? void 0 : _a.warn(
+      `abortTransaction called outside of a transaction. This is probably a bug.`
+    );
+    return;
+  }
+  store.transactionStatus = { phase: `idle` };
+  (_b = store.config.logger) == null ? void 0 : _b.info(`\u{1FA82}`, `transaction fail`);
+};
+var applyTransaction = (output, store) => {
+  var _a, _b, _c, _d, _e;
+  if (store.transactionStatus.phase !== `building`) {
+    (_a = store.config.logger) == null ? void 0 : _a.warn(
+      `abortTransaction called outside of a transaction. This is probably a bug.`
+    );
+    return;
+  }
+  store.transactionStatus.phase = `applying`;
+  store.transactionStatus.output = output;
+  const { atomUpdates } = store.transactionStatus;
+  (_b = store.config.logger) == null ? void 0 : _b.info(
+    `\u{1F6C3} applying transaction "${store.transactionStatus.key}" with ${atomUpdates.length} updates.`
+  );
+  (_c = store.config.logger) == null ? void 0 : _c.info(`\u{1F6C3} the updates are:`, atomUpdates);
+  for (const { key, newValue } of atomUpdates) {
+    const token = { key, type: `atom` };
+    if (!store.valueMap.has(token.key)) {
+      if (token.family) {
+        const family = store.families.get(token.family.key);
+        if (family) {
+          family(token.family.subKey);
+        }
+      } else {
+        const newAtom = store.transactionStatus.core.atoms.get(token.key);
+        if (!newAtom) {
+          throw new Error(
+            `Absurd Error: Atom "${token.key}" not found while copying updates from transaction "${store.transactionStatus.key}" to store "${store.config.name}"`
+          );
+        }
+        store.atoms.set(newAtom.key, newAtom);
+        store.valueMap.set(newAtom.key, newAtom.default);
+        (_d = store.config.logger) == null ? void 0 : _d.info(`\u{1F527}`, `add atom "${newAtom.key}"`);
+      }
+    }
+    setState(token, newValue, store);
+  }
+  const myTransaction = withdraw(
+    { key: store.transactionStatus.key, type: `transaction` },
+    store
+  );
+  if (myTransaction === void 0) {
+    throw new Error(
+      `Transaction "${store.transactionStatus.key}" not found. Absurd. How is this running?`
+    );
+  }
+  myTransaction.subject.next({
+    key: store.transactionStatus.key,
+    atomUpdates,
+    output,
+    params: store.transactionStatus.params
+  });
+  store.transactionStatus = { phase: `idle` };
+  (_e = store.config.logger) == null ? void 0 : _e.info(`\u{1F6EC}`, `transaction "${myTransaction.key}" applied`);
+};
+
 // src/transaction/build-transaction.ts
 var buildTransaction = (key, params, store) => {
   var _a;
@@ -441,107 +527,6 @@ var undoTransactionUpdate = (update, store) => {
 // src/transaction/index.ts
 var TRANSACTION_PHASES = [`idle`, `building`, `applying`];
 
-// src/store/lookup.ts
-function lookup(key, store) {
-  var _a;
-  const core = target(store);
-  let type = core.atoms.has(key) ? `atom` : core.selectors.has(key) ? `selector` : core.readonlySelectors.has(key) ? `readonly_selector` : ``;
-  if (!type) {
-    const errorId = Math.random().toString(36);
-    type = `\u{1F6A8} This state could not be found by lookup! Check the console for "${errorId}"`;
-    (_a = store.config.logger) == null ? void 0 : _a.error(
-      `${errorId}: Key "${key}" does not exist in the store.`
-    );
-  }
-  return { key, type };
-}
-
-// src/store/store.ts
-var Store = class {
-  constructor(name, store = null) {
-    this.valueMap = /* @__PURE__ */ new Map();
-    this.atoms = /* @__PURE__ */ new Map();
-    this.selectors = /* @__PURE__ */ new Map();
-    this.readonlySelectors = /* @__PURE__ */ new Map();
-    this.trackers = /* @__PURE__ */ new Map();
-    this.families = /* @__PURE__ */ new Map();
-    this.timelines = /* @__PURE__ */ new Map();
-    this.transactions = /* @__PURE__ */ new Map();
-    this.atomsThatAreDefault = /* @__PURE__ */ new Set();
-    this.timelineAtoms = new Junction({
-      between: [`timelineKey`, `atomKey`],
-      cardinality: `1:n`
-    });
-    this.selectorAtoms = new Junction({
-      between: [`selectorKey`, `atomKey`],
-      cardinality: `n:n`
-    });
-    this.selectorGraph = new Junction(
-      {
-        between: [`upstreamSelectorKey`, `downstreamSelectorKey`],
-        cardinality: `n:n`
-      },
-      {
-        makeContentKey: (...keys) => keys.sort().join(`:`)
-      }
-    );
-    this.subject = {
-      atomCreation: new Subject(),
-      selectorCreation: new Subject(),
-      transactionCreation: new Subject(),
-      timelineCreation: new Subject(),
-      operationStatus: new Subject()
-    };
-    this.operation = { open: false };
-    this.transactionStatus = { phase: `idle` };
-    this.config = {
-      name: `IMPLICIT_STORE`,
-      logger: __spreadProps(__spreadValues({}, console), { info: () => void 0 }),
-      logger__INTERNAL: console
-    };
-    var _a;
-    if (store !== null) {
-      this.valueMap = new Map(store == null ? void 0 : store.valueMap);
-      this.operation = __spreadValues({}, store == null ? void 0 : store.operation);
-      this.transactionStatus = __spreadValues({}, store == null ? void 0 : store.transactionStatus);
-      this.config = __spreadProps(__spreadValues({}, store == null ? void 0 : store.config), {
-        logger__INTERNAL: console,
-        logger: __spreadValues(__spreadProps(__spreadValues({}, console), {
-          info: () => void 0
-        }), (_a = store == null ? void 0 : store.config) == null ? void 0 : _a.logger),
-        name
-      });
-      for (const [, atom] of store.atoms) {
-        atom.install(this);
-      }
-      for (const [, selector] of store.readonlySelectors) {
-        selector.install(this);
-      }
-      for (const [, selector] of store.selectors) {
-        selector.install(this);
-      }
-      for (const [, tx] of store.transactions) {
-        tx.install(this);
-      }
-      for (const [, timeline] of store.timelines) {
-        timeline.install(this);
-      }
-    }
-  }
-};
-var IMPLICIT = {
-  STORE_INTERNAL: void 0,
-  get STORE() {
-    var _a;
-    return (_a = this.STORE_INTERNAL) != null ? _a : this.STORE_INTERNAL = new Store(`IMPLICIT_STORE`);
-  }
-};
-var clearStore = (store = IMPLICIT.STORE) => {
-  const { config } = store;
-  Object.assign(store, new Store(config.name));
-  store.config = config;
-};
-
 // src/timeline/add-atom-to-timeline.ts
 var addAtomToTimeline = (atomToken, tl, store = IMPLICIT.STORE) => {
   const atom = withdraw(atomToken, store);
@@ -934,10 +919,12 @@ var cacheValue = (key, value, subject, store = IMPLICIT.STORE) => {
       subject.next({ newValue: value2, oldValue: value2 });
     }).catch((error) => {
       var _a;
-      (_a = store.config.logger) == null ? void 0 : _a.error(
-        `Promised value for "${key}" rejected:`,
-        error
-      );
+      if (error !== `canceled`) {
+        (_a = store.config.logger) == null ? void 0 : _a.error(
+          `Promised value for "${key}" rejected:`,
+          error
+        );
+      }
     });
   } else {
     target(store).valueMap.set(key, value);
@@ -1132,9 +1119,15 @@ function createAtomFamily(options, store = IMPLICIT.STORE) {
   return atomFamily;
 }
 
-// src/selector/lookup-selector-sources.ts
-var lookupSelectorSources = (key, store) => {
-  const sources = target(store).selectorGraph.getRelationEntries({ downstreamSelectorKey: key }).filter(([_, { source }]) => source !== key).map(([_, { source }]) => lookup(source, store));
+// src/keys.ts
+var isAtomKey = (key, store) => target(store).atoms.has(key);
+var isSelectorKey = (key, store) => target(store).selectors.has(key);
+var isReadonlySelectorKey = (key, store) => target(store).readonlySelectors.has(key);
+var isStateKey = (key, store) => isAtomKey(key, store) || isSelectorKey(key, store) || isReadonlySelectorKey(key, store);
+
+// src/selector/get-selector-dependency-keys.ts
+var getSelectorDependencyKeys = (key, store) => {
+  const sources = target(store).selectorGraph.getRelationEntries({ downstreamSelectorKey: key }).filter(([_, { source }]) => source !== key).map(([_, { source }]) => source).filter((source) => isStateKey(source, store));
   return sources;
 };
 
@@ -1379,36 +1372,35 @@ var setState__INTERNAL = (state, value, store = IMPLICIT.STORE) => {
 };
 
 // src/selector/trace-selector-atoms.ts
-var traceSelectorAtoms = (selectorKey, dependency, store) => {
-  var _a;
-  const roots = [];
-  const sources = lookupSelectorSources(dependency.key, store);
+var traceSelectorAtoms = (selectorKey, directDependencyKey, store) => {
+  const rootKeys = [];
+  const indirectDependencyKeys = getSelectorDependencyKeys(
+    directDependencyKey,
+    store
+  );
   let depth = 0;
-  while (sources.length > 0) {
-    const source = sources.shift();
+  while (indirectDependencyKeys.length > 0) {
+    const indirectDependencyKey = indirectDependencyKeys.shift();
     ++depth;
-    if (depth > 999) {
-      (_a = store.config.logger) == null ? void 0 : _a.warn(
-        `Maximum selector dependency depth exceeded 999 in selector "${selectorKey}".`
-      );
-    }
     if (depth > 99999) {
       throw new Error(
-        `Maximum selector dependency depth exceeded in selector "${selectorKey}".`
+        `Maximum selector dependency depth exceeded (> 99999) in selector "${selectorKey}". This is likely due to a circular dependency.`
       );
     }
-    if (source.type !== `atom`) {
-      sources.push(...lookupSelectorSources(source.key, store));
-    } else {
-      roots.push(source);
+    if (!isAtomKey(indirectDependencyKey, store)) {
+      indirectDependencyKeys.push(
+        ...getSelectorDependencyKeys(indirectDependencyKey, store)
+      );
+    } else if (!rootKeys.includes(indirectDependencyKey)) {
+      rootKeys.push(indirectDependencyKey);
     }
   }
-  return roots;
+  return rootKeys;
 };
 var traceAllSelectorAtoms = (selectorKey, store) => {
-  const sources = lookupSelectorSources(selectorKey, store);
-  return sources.flatMap(
-    (source) => source.type === `atom` ? source : traceSelectorAtoms(selectorKey, source, store)
+  const directDependencyKeys = getSelectorDependencyKeys(selectorKey, store);
+  return directDependencyKeys.flatMap(
+    (depKey) => isAtomKey(depKey, store) ? depKey : traceSelectorAtoms(selectorKey, depKey, store)
   );
 };
 
@@ -1426,15 +1418,15 @@ var updateSelectorAtoms = (selectorKey, dependency, store) => {
     );
     return;
   }
-  const roots = traceSelectorAtoms(selectorKey, dependency, store);
+  const rootKeys = traceSelectorAtoms(selectorKey, dependency.key, store);
   (_b = store.config.logger) == null ? void 0 : _b.info(
     `   || adding roots for "${selectorKey}":`,
-    roots.map((r) => r.key)
+    rootKeys.map((r) => r)
   );
-  for (const root of roots) {
+  for (const atomKey of rootKeys) {
     core.selectorAtoms = core.selectorAtoms.set({
       selectorKey,
-      atomKey: root.key
+      atomKey
     });
   }
 };
@@ -1751,8 +1743,8 @@ var markAtomAsNotDefault = (key, store = IMPLICIT.STORE) => {
   core.atomsThatAreDefault.delete(key);
 };
 var isSelectorDefault = (key, store = IMPLICIT.STORE) => {
-  const roots = traceAllSelectorAtoms(key, store);
-  return roots.every((root) => isAtomDefault(root.key, store));
+  const rootKeys = traceAllSelectorAtoms(key, store);
+  return rootKeys.every((rootKey) => isAtomDefault(rootKey, store));
 };
 
 // src/atom/create-atom.ts
@@ -1825,11 +1817,11 @@ var recallState = (state, store = IMPLICIT.STORE) => {
 
 // src/subscribe/subscribe-to-root-atoms.ts
 var subscribeToRootAtoms = (state, store) => {
-  const dependencySubscriptions = `default` in state ? null : traceAllSelectorAtoms(state.key, store).map((atomToken) => {
-    const atom = withdraw(atomToken, 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 "${atomToken.key}", a dependency of selector "${state.key}", not found in store "${store.config.name}".`
+        `Atom "${atomKey}", a dependency of selector "${state.key}", not found in store "${store.config.name}".`
       );
     }
     return atom.subject.subscribe(
@@ -1837,7 +1829,7 @@ var subscribeToRootAtoms = (state, store) => {
       (atomChange) => {
         var _a, _b;
         (_a = store.config.logger) == null ? void 0 : _a.info(
-          `\u{1F4E2} selector "${state.key}" saw root "${atomToken.key}" go (`,
+          `\u{1F4E2} selector "${state.key}" saw root "${atomKey}" go (`,
           atomChange.oldValue,
           `->`,
           atomChange.newValue,
@@ -1859,6 +1851,6 @@ var subscribeToRootAtoms = (state, store) => {
   return dependencySubscriptions;
 };
 
-export { FamilyTracker, Future, IMPLICIT, Store, Subject, TRANSACTION_PHASES, Tracker, abortTransaction, addAtomToTimeline, applyTransaction, become, buildTransaction, cacheValue, clearStore, closeOperation, createAtom, createAtomFamily, createMutableAtom, createMutableAtomFamily, createReadonlySelectorFamily, createSelector, createSelectorFamily, deleteAtom, deposit, evictCachedValue, getJsonToken, getState__INTERNAL, getUpdateToken, isAtomDefault, isAtomMutable, isAtomTokenMutable, isDone, isSelectorDefault, isTransceiver, isValueCached, lookup, lookupSelectorSources, markAtomAsDefault, markAtomAsNotDefault, markDone, openOperation, readCachedValue, redoTransactionUpdate, redo__INTERNAL, registerSelector, setState__INTERNAL, subscribeToRootAtoms, target, timeline__INTERNAL, traceAllSelectorAtoms, traceSelectorAtoms, transaction__INTERNAL, undoTransactionUpdate, undo__INTERNAL, updateSelectorAtoms, withdraw, withdrawNewFamilyMember };
+export { FamilyTracker, Future, IMPLICIT, Store, Subject, TRANSACTION_PHASES, Tracker, abortTransaction, addAtomToTimeline, applyTransaction, become, buildTransaction, cacheValue, clearStore, closeOperation, createAtom, createAtomFamily, createMutableAtom, createMutableAtomFamily, createReadonlySelectorFamily, createSelector, createSelectorFamily, deleteAtom, deposit, evictCachedValue, getJsonToken, getSelectorDependencyKeys, getState__INTERNAL, getUpdateToken, isAtomDefault, isAtomKey, isAtomMutable, isAtomTokenMutable, isDone, isReadonlySelectorKey, isSelectorDefault, isSelectorKey, isStateKey, isTransceiver, isValueCached, markAtomAsDefault, markAtomAsNotDefault, markDone, openOperation, readCachedValue, redoTransactionUpdate, redo__INTERNAL, registerSelector, setState__INTERNAL, subscribeToRootAtoms, target, timeline__INTERNAL, traceAllSelectorAtoms, traceSelectorAtoms, transaction__INTERNAL, undoTransactionUpdate, undo__INTERNAL, updateSelectorAtoms, withdraw, withdrawNewFamilyMember };
 //# sourceMappingURL=out.js.map
 //# sourceMappingURL=index.mjs.map