atom.io 0.3.0 → 0.3.1

package/dist/index.js

@@ -22,20 +22,20 @@ var __spreadValues = (a, b) => {
 };
 var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
 var __objRest = (source, exclude) => {
-  var target3 = {};
+  var target2 = {};
   for (var prop in source)
     if (__hasOwnProp.call(source, prop) && exclude.indexOf(prop) < 0)
-      target3[prop] = source[prop];
+      target2[prop] = source[prop];
   if (source != null && __getOwnPropSymbols)
     for (var prop of __getOwnPropSymbols(source)) {
       if (exclude.indexOf(prop) < 0 && __propIsEnum.call(source, prop))
-        target3[prop] = source[prop];
+        target2[prop] = source[prop];
     }
-  return target3;
+  return target2;
 };
-var __export = (target3, all) => {
+var __export = (target2, all) => {
   for (var name in all)
-    __defProp(target3, name, { get: all[name], enumerable: true });
+    __defProp(target2, name, { get: all[name], enumerable: true });
 };
 var __copyProps = (to, from, except, desc) => {
   if (from && typeof from === "object" || typeof from === "function") {
@@ -45,12 +45,12 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
-var __toESM = (mod, isNodeMode, target3) => (target3 = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+var __toESM = (mod, isNodeMode, target2) => (target2 = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
   // If the importer is in node compatibility mode or this is not an ESM
   // file that has been converted to a CommonJS file using a Babel-
   // compatible transform (i.e. "__esModule" has not been set), then set
   // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target3, "default", { value: mod, enumerable: true }) : target3,
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target2, "default", { value: mod, enumerable: true }) : target2,
   mod
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
@@ -58,6 +58,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
+  LOG_LEVELS: () => LOG_LEVELS,
   __INTERNAL__: () => internal_exports,
   atom: () => atom,
   atomFamily: () => atomFamily,
@@ -82,7 +83,6 @@ module.exports = __toCommonJS(src_exports);
 var internal_exports = {};
 __export(internal_exports, {
   IMPLICIT: () => IMPLICIT,
-  LOG_LEVELS: () => LOG_LEVELS,
   TRANSACTION_PHASES: () => TRANSACTION_PHASES,
   abortTransaction: () => abortTransaction,
   applyTransaction: () => applyTransaction,
@@ -120,7 +120,6 @@ __export(internal_exports, {
   selectorFamily__INTERNAL: () => selectorFamily__INTERNAL,
   selector__INTERNAL: () => selector__INTERNAL,
   setAtomState: () => setAtomState,
-  setLogLevel: () => setLogLevel,
   setSelectorState: () => setSelectorState,
   setState__INTERNAL: () => setState__INTERNAL,
   storeAtom: () => storeAtom,
@@ -136,7 +135,6 @@ __export(internal_exports, {
   undoTransactionUpdate: () => undoTransactionUpdate,
   undo__INTERNAL: () => undo__INTERNAL,
   updateSelectorAtoms: () => updateSelectorAtoms,
-  useLogger: () => useLogger,
   withdraw: () => withdraw
 });
 
@@ -168,7 +166,7 @@ var getState__INTERNAL = (state, store = IMPLICIT.STORE) => {
     (_a = store.config.logger) == null ? void 0 : _a.info(`>> read "${state.key}"`);
     return readCachedValue(state.key, store);
   }
-  if (`get` in state) {
+  if (state.type !== `atom`) {
     (_b = store.config.logger) == null ? void 0 : _b.info(`-> calc "${state.key}"`);
     return computeSelectorState(state);
   }
@@ -631,21 +629,30 @@ var clearStore = (store = IMPLICIT.STORE) => {
 };
 
 // src/internal/operation.ts
-var openOperation = (store) => {
-  var _a;
+var openOperation = (token, store) => {
+  var _a, _b;
   const core = target(store);
+  if (core.operation.open) {
+    console.warn(core.operation.open);
+    (_a = store.config.logger) == null ? void 0 : _a.error(
+      `\u274C failed to setState to "${token.key}" during a setState for "${core.operation.token.key}"`
+    );
+    throw Symbol(`violation`);
+  }
   core.operation = {
     open: true,
     done: /* @__PURE__ */ new Set(),
-    prev: store.valueMap
+    prev: store.valueMap,
+    time: Date.now(),
+    token
   };
-  (_a = store.config.logger) == null ? void 0 : _a.info(`\u2B55`, `operation start`);
+  (_b = store.config.logger) == null ? void 0 : _b.info(`\u2B55 operation start from "${token.key}"`);
 };
 var closeOperation = (store) => {
   var _a;
   const core = target(store);
   core.operation = { open: false };
-  (_a = store.config.logger) == null ? void 0 : _a.info(`\u{1F534}`, `operation done`);
+  (_a = store.config.logger) == null ? void 0 : _a.info(`\u{1F534} operation done`);
 };
 var isDone = (key, store = IMPLICIT.STORE) => {
   var _a;
@@ -878,7 +885,7 @@ function atomFamily__INTERNAL(options, store = IMPLICIT.STORE) {
       var _a;
       const subKey = stringifyJson(key);
       const family = { key: options.key, subKey };
-      const fullKey = `${options.key}__${subKey}`;
+      const fullKey = `${options.key}(${subKey})`;
       const existing = withdraw({ key: fullKey, type: `atom` }, store);
       const token = existing ? deposit(existing) : atom__INTERNAL(
         {
@@ -906,7 +913,7 @@ function readonlySelectorFamily__INTERNAL(options, store) {
     (key) => {
       const subKey = stringifyJson(key);
       const family = { key: options.key, subKey };
-      const fullKey = `${options.key}__${subKey}`;
+      const fullKey = `${options.key}(${subKey})`;
       const existing = core.readonlySelectors.get(fullKey);
       if (existing) {
         return deposit(existing);
@@ -938,7 +945,7 @@ function selectorFamily__INTERNAL(options, store = IMPLICIT.STORE) {
     (key) => {
       const subKey = stringifyJson(key);
       const family = { key: options.key, subKey };
-      const fullKey = `${options.key}__${subKey}`;
+      const fullKey = `${options.key}(${subKey})`;
       const existing = core.selectors.get(fullKey);
       if (existing) {
         return deposit(existing);
@@ -962,39 +969,6 @@ function selectorFamily__INTERNAL(options, store = IMPLICIT.STORE) {
   );
 }
 
-// src/internal/logger.ts
-var LOG_LEVELS = [
-  `info`,
-  `warn`,
-  `error`
-];
-var setLogLevel = (preferredLevel, store = IMPLICIT.STORE) => {
-  const { logger__INTERNAL } = store.config;
-  if (preferredLevel === null) {
-    store.config.logger = null;
-  } else {
-    store.config.logger = __spreadValues({}, console);
-    LOG_LEVELS.forEach((logLevel) => {
-      if (LOG_LEVELS.indexOf(logLevel) < LOG_LEVELS.indexOf(preferredLevel)) {
-        store.config.logger[logLevel] = doNothing;
-      } else {
-        store.config.logger[logLevel] = logger__INTERNAL[logLevel];
-      }
-    });
-  }
-};
-var useLogger = (logger, store = IMPLICIT.STORE) => {
-  var _a;
-  const currentLogLevel = store.config.logger === null ? null : (_a = LOG_LEVELS.find(
-    (logLevel) => {
-      var _a2;
-      return ((_a2 = store.config.logger) == null ? void 0 : _a2[logLevel]) !== doNothing;
-    }
-  )) != null ? _a : null;
-  store.config.logger__INTERNAL = __spreadValues({}, logger);
-  setLogLevel(currentLogLevel, store);
-};
-
 // src/internal/selector-internal.ts
 var import_hamt_plus5 = __toESM(require("hamt_plus"));
 var Rx4 = __toESM(require("rxjs"));
@@ -1058,8 +1032,9 @@ var registerSelector = (selectorKey, store = IMPLICIT.STORE) => ({
       );
     } else {
       (_b = store.config.logger) == null ? void 0 : _b.info(
-        `\u{1F50C} registerSelector "${selectorKey}" <- "${dependency.key}" =`,
-        dependencyValue
+        `\u{1F50C} registerSelector "${selectorKey}" <- ( "${dependency.key}" =`,
+        dependencyValue,
+        `)`
       );
       core.selectorGraph = core.selectorGraph.set(selectorKey, dependency.key, {
         source: dependency.key
@@ -1251,6 +1226,8 @@ var subscribeToRootAtoms = (state, store) => {
 // src/internal/timeline-internal.ts
 var import_hamt_plus7 = __toESM(require("hamt_plus"));
 function timeline__INTERNAL(options, store = IMPLICIT.STORE) {
+  var _a, _b;
+  let incompleteSelectorTime = null;
   let incompleteTransactionKey = null;
   const timelineData = {
     at: 0,
@@ -1260,9 +1237,11 @@ function timeline__INTERNAL(options, store = IMPLICIT.STORE) {
   const subscribeToAtom = (token) => {
     const state = withdraw(token, store);
     state.subject.subscribe((update) => {
-      var _a, _b, _c;
+      var _a2, _b2, _c, _d, _e;
+      const storeCurrentSelectorKey = store.operation.open && store.operation.token.type === `selector` ? store.operation.token.key : null;
+      const storeCurrentSelectorTime = store.operation.open && store.operation.token.type === `selector` ? store.operation.time : null;
       const storeCurrentTransactionKey = store.transactionStatus.phase === `applying` ? store.transactionStatus.key : null;
-      (_a = store.config.logger) == null ? void 0 : _a.info(
+      (_a2 = store.config.logger) == null ? void 0 : _a2.info(
         `\u23F3 timeline "${options.key}" saw atom "${token.key}" go (`,
         update.oldValue,
         `->`,
@@ -1276,14 +1255,17 @@ function timeline__INTERNAL(options, store = IMPLICIT.STORE) {
         );
         if (incompleteTransactionKey !== storeCurrentTransactionKey) {
           if (incompleteTransactionKey) {
-            (_b = store.config.logger) == null ? void 0 : _b.error(
+            (_b2 = store.config.logger) == null ? void 0 : _b2.error(
               `Timeline "${options.key}" was unable to resolve transaction "${incompleteTransactionKey}. This is probably a bug.`
             );
           }
           incompleteTransactionKey = storeCurrentTransactionKey;
           const subscription = currentTransaction.subject.subscribe((update2) => {
-            var _a2;
+            var _a3;
             if (timelineData.timeTraveling === false) {
+              if (timelineData.at !== timelineData.history.length) {
+                timelineData.history.splice(timelineData.at);
+              }
               timelineData.history.push(__spreadProps(__spreadValues({
                 type: `transaction_update`
               }, update2), {
@@ -1295,35 +1277,95 @@ function timeline__INTERNAL(options, store = IMPLICIT.STORE) {
             timelineData.at = timelineData.history.length;
             subscription.unsubscribe();
             incompleteTransactionKey = null;
-            (_a2 = store.config.logger) == null ? void 0 : _a2.info(
-              `\u231B timeline "${options.key}" pushed a transaction_update from "${update2.key}"`
+            (_a3 = store.config.logger) == null ? void 0 : _a3.info(
+              `\u231B timeline "${options.key}" got a transaction_update "${update2.key}"`
             );
           });
         }
+      } else if (storeCurrentSelectorKey) {
+        if (timelineData.timeTraveling === false) {
+          if (storeCurrentSelectorTime !== incompleteSelectorTime) {
+            const newSelectorUpdate = {
+              type: `selector_update`,
+              key: storeCurrentSelectorKey,
+              atomUpdates: []
+            };
+            newSelectorUpdate.atomUpdates.push(__spreadValues({
+              key: token.key,
+              type: `atom_update`
+            }, update));
+            if (timelineData.at !== timelineData.history.length) {
+              timelineData.history.splice(timelineData.at);
+            }
+            timelineData.history.push(newSelectorUpdate);
+            (_c = store.config.logger) == null ? void 0 : _c.info(
+              `\u231B timeline "${options.key}" got a selector_update "${storeCurrentSelectorKey}" with`,
+              newSelectorUpdate.atomUpdates.map((atomUpdate) => atomUpdate.key)
+            );
+            timelineData.at = timelineData.history.length;
+            incompleteSelectorTime = storeCurrentSelectorTime;
+          } else {
+            const latestUpdate = timelineData.history.at(-1);
+            if ((latestUpdate == null ? void 0 : latestUpdate.type) === `selector_update`) {
+              latestUpdate.atomUpdates.push(__spreadValues({
+                key: token.key,
+                type: `atom_update`
+              }, update));
+              (_d = store.config.logger) == null ? void 0 : _d.info(
+                `   \u231B timeline "${options.key}" set selector_update "${storeCurrentSelectorKey}" to`,
+                latestUpdate == null ? void 0 : latestUpdate.atomUpdates.map((atomUpdate) => atomUpdate.key)
+              );
+            }
+          }
+        }
       } else {
         if (timelineData.timeTraveling === false) {
+          incompleteSelectorTime = null;
+          if (timelineData.at !== timelineData.history.length) {
+            timelineData.history.splice(timelineData.at);
+          }
           timelineData.history.push({
-            type: `state_update`,
+            type: `atom_update`,
             key: token.key,
             oldValue: update.oldValue,
             newValue: update.newValue
           });
-          (_c = store.config.logger) == null ? void 0 : _c.info(
-            `\u231B timeline "${options.key}" pushed a state_update to "${token.key}"`
+          (_e = store.config.logger) == null ? void 0 : _e.info(
+            `\u231B timeline "${options.key}" got a state_update to "${token.key}"`
           );
           timelineData.at = timelineData.history.length;
         }
       }
     });
   };
+  const core = target(store);
   for (const tokenOrFamily of options.atoms) {
+    const timelineKey = core.timelineAtoms.getRelatedId(tokenOrFamily.key);
+    if (timelineKey) {
+      (_a = store.config.logger) == null ? void 0 : _a.error(
+        `\u274C Failed to add atom "${tokenOrFamily.key}" to timeline "${options.key}" because it belongs to timeline "${timelineKey}"`
+      );
+      continue;
+    }
     if (tokenOrFamily.type === `atom_family`) {
       const family = tokenOrFamily;
       family.subject.subscribe((token) => subscribeToAtom(token));
     } else {
       const token = tokenOrFamily;
+      if (`family` in token && token.family) {
+        const familyTimelineKey = core.timelineAtoms.getRelatedId(
+          token.family.key
+        );
+        if (familyTimelineKey) {
+          (_b = store.config.logger) == null ? void 0 : _b.error(
+            `\u274C Failed to add atom "${token.key}" to timeline "${options.key}" because its family "${token.family.key}" belongs to timeline "${familyTimelineKey}"`
+          );
+          continue;
+        }
+      }
       subscribeToAtom(token);
     }
+    core.timelineAtoms = core.timelineAtoms.set(tokenOrFamily.key, options.key);
   }
   store.timelineStore = import_hamt_plus7.default.set(options.key, timelineData, store.timelineStore);
   return {
@@ -1332,28 +1374,30 @@ function timeline__INTERNAL(options, store = IMPLICIT.STORE) {
   };
 }
 var redo__INTERNAL = (token, store = IMPLICIT.STORE) => {
-  var _a, _b;
+  var _a, _b, _c, _d;
+  (_a = store.config.logger) == null ? void 0 : _a.info(`\u23E9 redo "${token.key}"`);
   const timelineData = store.timelineStore.get(token.key);
   if (!timelineData) {
-    (_a = store.config.logger) == null ? void 0 : _a.error(
-      `Tried to redo on timeline "${token.key}" has not been initialized.`
+    (_b = store.config.logger) == null ? void 0 : _b.error(
+      `Failed to redo on timeline "${token.key}". This timeline has not been initialized.`
     );
     return;
   }
   if (timelineData.at === timelineData.history.length) {
-    (_b = store.config.logger) == null ? void 0 : _b.warn(
-      `Tried to redo on timeline "${token.key}" but there is nothing to redo.`
+    (_c = store.config.logger) == null ? void 0 : _c.warn(
+      `Failed to redo at the end of timeline "${token.key}". There is nothing to redo.`
     );
     return;
   }
   timelineData.timeTraveling = true;
   const update = timelineData.history[timelineData.at];
   switch (update.type) {
-    case `state_update`: {
+    case `atom_update`: {
       const { key, newValue } = update;
       setState({ key, type: `atom` }, newValue);
       break;
     }
+    case `selector_update`:
     case `transaction_update`: {
       for (const atomUpdate of update.atomUpdates) {
         const { key, newValue } = atomUpdate;
@@ -1364,19 +1408,23 @@ var redo__INTERNAL = (token, store = IMPLICIT.STORE) => {
   }
   ++timelineData.at;
   timelineData.timeTraveling = false;
+  (_d = store.config.logger) == null ? void 0 : _d.info(
+    `\u23F9\uFE0F "${token.key}" is now at ${timelineData.at} / ${timelineData.history.length}`
+  );
 };
 var undo__INTERNAL = (token, store = IMPLICIT.STORE) => {
-  var _a, _b;
+  var _a, _b, _c, _d;
+  (_a = store.config.logger) == null ? void 0 : _a.info(`\u23EA undo "${token.key}"`);
   const timelineData = store.timelineStore.get(token.key);
   if (!timelineData) {
-    (_a = store.config.logger) == null ? void 0 : _a.error(
-      `Tried to undo on timeline "${token.key}" has not been initialized.`
+    (_b = store.config.logger) == null ? void 0 : _b.error(
+      `Failed to undo on timeline "${token.key}". This timeline has not been initialized.`
     );
     return;
   }
   if (timelineData.at === 0) {
-    (_b = store.config.logger) == null ? void 0 : _b.warn(
-      `Tried to undo on timeline "${token.key}" but there is nothing to undo.`
+    (_c = store.config.logger) == null ? void 0 : _c.warn(
+      `Failed to undo at the beginning of timeline "${token.key}". There is nothing to undo.`
     );
     return;
   }
@@ -1384,11 +1432,12 @@ var undo__INTERNAL = (token, store = IMPLICIT.STORE) => {
   --timelineData.at;
   const update = timelineData.history[timelineData.at];
   switch (update.type) {
-    case `state_update`: {
+    case `atom_update`: {
       const { key, oldValue } = update;
       setState({ key, type: `atom` }, oldValue);
       break;
     }
+    case `selector_update`:
     case `transaction_update`: {
       for (const atomUpdate of update.atomUpdates) {
         const { key, oldValue } = atomUpdate;
@@ -1398,6 +1447,9 @@ var undo__INTERNAL = (token, store = IMPLICIT.STORE) => {
     }
   }
   timelineData.timeTraveling = false;
+  (_d = store.config.logger) == null ? void 0 : _d.info(
+    `\u23F9\uFE0F "${token.key}" is now at ${timelineData.at} / ${timelineData.history.length}`
+  );
 };
 
 // src/atom.ts
@@ -1408,6 +1460,39 @@ function atomFamily(options) {
   return atomFamily__INTERNAL(options);
 }
 
+// src/logger.ts
+var LOG_LEVELS = [
+  `info`,
+  `warn`,
+  `error`
+];
+var setLogLevel = (preferredLevel, store = IMPLICIT.STORE) => {
+  const { logger__INTERNAL } = store.config;
+  if (preferredLevel === null) {
+    store.config.logger = null;
+  } else {
+    store.config.logger = __spreadValues({}, console);
+    LOG_LEVELS.forEach((logLevel) => {
+      if (LOG_LEVELS.indexOf(logLevel) < LOG_LEVELS.indexOf(preferredLevel)) {
+        store.config.logger[logLevel] = doNothing;
+      } else {
+        store.config.logger[logLevel] = logger__INTERNAL[logLevel];
+      }
+    });
+  }
+};
+var useLogger = (logger, store = IMPLICIT.STORE) => {
+  var _a;
+  const currentLogLevel = store.config.logger === null ? null : (_a = LOG_LEVELS.find(
+    (logLevel) => {
+      var _a2;
+      return ((_a2 = store.config.logger) == null ? void 0 : _a2[logLevel]) !== doNothing;
+    }
+  )) != null ? _a : null;
+  store.config.logger__INTERNAL = __spreadValues({}, logger);
+  setLogLevel(currentLogLevel, store);
+};
+
 // src/selector.ts
 function selector(options) {
   return selector__INTERNAL(options);
@@ -1416,30 +1501,13 @@ function selectorFamily(options) {
   return selectorFamily__INTERNAL(options);
 }
 
-// src/timeline.ts
-var timeline = (options) => {
-  return timeline__INTERNAL(options);
-};
-var redo = (token) => {
-  return redo__INTERNAL(token, IMPLICIT.STORE);
-};
-var undo = (token) => {
-  return undo__INTERNAL(token, IMPLICIT.STORE);
-};
-
-// src/transaction.ts
-function transaction(options) {
-  return transaction__INTERNAL(options);
-}
-var runTransaction = (token, store = IMPLICIT.STORE) => (...parameters) => withdraw(token, store).run(...parameters);
-
 // src/subscribe.ts
 var subscribe = (token, handleUpdate, store = IMPLICIT.STORE) => {
   var _a;
   const state = withdraw(token, store);
   const subscription = state.subject.subscribe(handleUpdate);
   (_a = store.config.logger) == null ? void 0 : _a.info(`\u{1F440} subscribe to "${state.key}"`);
-  const dependencySubscriptions = `get` in state ? subscribeToRootAtoms(state, store) : null;
+  const dependencySubscriptions = state.type !== `atom` ? subscribeToRootAtoms(state, store) : null;
   const unsubscribe = dependencySubscriptions === null ? () => {
     var _a2;
     (_a2 = store.config.logger) == null ? void 0 : _a2.info(`\u{1F648} unsubscribe from "${state.key}"`);
@@ -1469,13 +1537,37 @@ var subscribeToTransaction = (token, handleUpdate, store = IMPLICIT.STORE) => {
   return unsubscribe;
 };
 
+// src/timeline.ts
+var timeline = (options) => {
+  return timeline__INTERNAL(options);
+};
+var redo = (token) => {
+  return redo__INTERNAL(token, IMPLICIT.STORE);
+};
+var undo = (token) => {
+  return undo__INTERNAL(token, IMPLICIT.STORE);
+};
+
+// src/transaction.ts
+function transaction(options) {
+  return transaction__INTERNAL(options);
+}
+var runTransaction = (token, store = IMPLICIT.STORE) => (...parameters) => withdraw(token, store).run(...parameters);
+
 // src/index.ts
 var getState = (token, store = IMPLICIT.STORE) => {
   const state = withdraw(token, store);
   return getState__INTERNAL(state, store);
 };
 var setState = (token, value, store = IMPLICIT.STORE) => {
-  openOperation(store);
+  try {
+    openOperation(token, store);
+  } catch (thrown) {
+    if (!(typeof thrown === `symbol`)) {
+      throw thrown;
+    }
+    return;
+  }
   const state = withdraw(token, store);
   setState__INTERNAL(state, value, store);
   closeOperation(store);
@@ -1483,6 +1575,7 @@ var setState = (token, value, store = IMPLICIT.STORE) => {
 var isDefault = (token, store = IMPLICIT.STORE) => token.type === `atom` ? isAtomDefault(token.key, store) : isSelectorDefault(token.key, store);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  LOG_LEVELS,
   __INTERNAL__,
   atom,
   atomFamily,