atom.io 0.32.2 → 0.32.3

package/README.md

@@ -1,6 +1,3 @@
-
-
-
 <div align="center">
   <picture>
     <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/jeremybanka/wayforge/main/packages/atom.io/__assets__/logo-dark-mode.png">
@@ -10,52 +7,35 @@
 </div>
 
 <h1 align="center">
-  atom.io
+  <code>atom.io</code>
 </h1>
 
-<h3 align="center">
-  Composable, high-performance reactivity for ECMAScript inspired by <a href="https://recoiljs.org/">Recoil</a> 💙
-</h3>
-
-
-
-<h3 align="center">
-  <a href="https://atom.io.fyi">📖 Read the docs at atom.io.fyi</a>
-</h3>
-
-
-
-
 ```shell
 npm i atom.io
 ```
-```shell
-pnpm i atom.io
-```
-```shell
-bun i atom.io
-```
 
 <p align="center">
-  <a href="https://bundlephobia.com/result?p=atom.io">
-    <img alt="Bundlephobia" src="https://img.shields.io/bundlephobia/minzip/atom.io?style=for-the-badge&labelColor=333">
+  <a aria-label="NPM version" href="https://www.npmjs.com/package/atom.io">
+    <img alt="NPM Version" src="https://img.shields.io/npm/v/atom.io?style=for-the-badge">
   </a>
-  <a aria-label="Types" href="https://www.npmjs.com/package/atom.io">
-    <img alt="Types" src="https://img.shields.io/npm/types/atom.io?style=for-the-badge&labelColor=333">
+  <a aria-label="Dependencies 0" href="https://www.npmjs.com/package/atom.io">
+    <img alt="Dependencies 0" src=" https://img.shields.io/badge/dependencies-0-0?style=for-the-badge">
   </a>
-  <a aria-label="Build status" href="https://github.com/jeremybanka/wayforge/actions/workflows/integration.yml">
-    <img alt="Build status" src="https://img.shields.io/github/actions/workflow/status/jeremybanka/wayforge/integration.yml?branch=main&style=for-the-badge&labelColor=333">
+  <a aria-label="Types" href="https://www.npmjs.com/package/atom.io">
+    <img alt="Types" src="https://img.shields.io/npm/types/atom.io?style=for-the-badge">
   </a>
-  <a aria-label="NPM version" href="https://www.npmjs.com/package/atom.io">
-    <img alt="NPM Version" src="https://img.shields.io/npm/v/atom.io?style=for-the-badge&labelColor=333">
+  <a href="https://bundlephobia.com/result?p=atom.io">
+    <img alt="Bundlephobia" src="https://img.shields.io/bundlephobia/minzip/atom.io?style=for-the-badge">
   </a>
-  <a aria-label="Coverage" href="https://coveralls.io/github/jeremybanka/wayforge">
-    <img alt="Coverage" src="https://img.shields.io/coverallsCoverage/github/jeremybanka/wayforge?style=for-the-badge&labelColor=333">
+  <a aria-label="Coverage" href="https://recoverage.cloud/">
+    <img alt="Coverage" src="https://img.shields.io/endpoint?url=https%3A%2F%2Frecoverage.cloud%2Fshields%2FS1ikz1yFmk93qbAI7lLnu%2Fatom.io">
   </a>
-
 </p>
 
+<h3 align="center">
+  Composable, high-performance reactivity for ECMAScript inspired by <a href="https://recoiljs.org/">Recoil</a> 💙
+</h3>
 
-
-
-
+<h3 align="center">
+  <a href="https://atom.io.fyi">📖 Read the docs at atom.io.fyi</a>
+</h3>

package/data/dist/index.js

@@ -1,4 +1,4 @@
-import { IMPLICIT, createStandaloneSelector, findInStore, capitalize, createRegularAtom, createRegularAtomFamily, createSelectorFamily } from '../../dist/chunk-RXQWAO26.js';
+import { IMPLICIT, createStandaloneSelector, findInStore, capitalize, createRegularAtom, createRegularAtomFamily, createSelectorFamily } from '../../dist/chunk-35NB2XZU.js';
 import '../../dist/chunk-XWL6SNVU.js';
 
 // data/src/dict.ts

package/dist/{chunk-YPME5OLO.js → chunk-2XDFCXGB.js}

@@ -1,4 +1,4 @@
-import { atom, SetRTX, join, selectorFamily, getInternalRelations, assignTransactionToContinuity, IMPLICIT, setEpochNumberOfContinuity } from './chunk-RXQWAO26.js';
+import { atom, SetRTX, join, selectorFamily, getInternalRelations, assignTransactionToContinuity, IMPLICIT, setEpochNumberOfContinuity } from './chunk-35NB2XZU.js';
 
 // realtime/src/realtime-continuity.ts
 var InvariantMap = class extends Map {

package/dist/{chunk-RXQWAO26.js → chunk-35NB2XZU.js}

@@ -362,19 +362,30 @@ var readOrComputeValue = (target, state) => {
     target.logger.info(`\u{1F4D6}`, state.type, state.key, `reading cached value`);
     return readCachedValue(state, target);
   }
-  if (state.type === `selector` || state.type === `readonly_selector`) {
-    target.logger.info(`\u{1F9EE}`, state.type, state.key, `computing value`);
-    return state.get();
+  switch (state.type) {
+    case `selector`:
+    case `readonly_selector`:
+      target.logger.info(`\u{1F9EE}`, state.type, state.key, `computing value`);
+      return state.get();
+    case `atom`:
+    case `mutable_atom`: {
+      const def = state.default;
+      let fallback;
+      if (def instanceof Function) {
+        fallback = def();
+      } else {
+        fallback = def;
+      }
+      target.logger.info(
+        `\u{1F481}`,
+        `atom`,
+        state.key,
+        `could not find cached value; using default`,
+        fallback
+      );
+      return fallback;
+    }
   }
-  const fallback = state.default instanceof Function ? state.default() : state.default;
-  target.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
@@ -502,55 +513,8 @@ var evictDownStream = (store, atom2) => {
   }
 };
 
-// internal/src/set-state/stow-update.ts
-function shouldUpdateBeStowed(key, update) {
-  if (isTransceiver(update.newValue)) {
-    return false;
-  }
-  if (key.includes(`\u{1F50D}`)) {
-    return false;
-  }
-  return true;
-}
-var stowUpdate = (store, state, update) => {
-  const { key } = state;
-  const target = newest(store);
-  if (!isChildStore(target) || 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 = {
-    type: `atom_update`,
-    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 = (atom2, next, target) => {
+var setAtom = (target, atom2, next) => {
   const oldValue = readOrComputeValue(target, atom2);
   let newValue = oldValue;
   if (atom2.type === `mutable_atom` && isChildStore(target)) {
@@ -567,23 +531,45 @@ var setAtom = (atom2, next, target) => {
   markDone(target, atom2.key);
   evictDownStream(target, atom2);
   const update = { oldValue, newValue };
-  if (isRootStore(target)) {
+  if (!isChildStore(target)) {
     emitUpdate(target, atom2, update);
-  } else if (target.parent) {
-    if (target.on.transactionApplying.state === null) {
-      stowUpdate(target, atom2, update);
-    } else if (atom2.key.startsWith(`*`)) {
-      const mutableKey = atom2.key.slice(1);
-      const mutableAtom = target.atoms.get(mutableKey);
-      let transceiver = target.valueMap.get(mutableKey);
-      if (mutableAtom.type === `mutable_atom` && isChildStore(target)) {
-        const { parent } = target;
-        const copiedValue = copyMutableIfNeeded(target, mutableAtom, parent);
-        transceiver = copiedValue;
-      }
-      const accepted = transceiver.do(update.newValue) === null;
-      if (accepted) evictDownStream(target, mutableAtom);
+    return;
+  }
+  if (target.on.transactionApplying.state === null) {
+    const { key } = atom2;
+    if (isTransceiver(update.newValue)) {
+      return;
     }
+    const atomUpdate = {
+      type: `atom_update`,
+      key,
+      ...update
+    };
+    if (atom2.family) {
+      atomUpdate.family = atom2.family;
+    }
+    target.transactionMeta.update.updates.push(atomUpdate);
+    target.logger.info(
+      `\u{1F4C1}`,
+      `atom`,
+      key,
+      `stowed (`,
+      update.oldValue,
+      `->`,
+      update.newValue,
+      `)`
+    );
+  } else if (atom2.key.startsWith(`*`)) {
+    const mutableKey = atom2.key.slice(1);
+    const mutableAtom = target.atoms.get(mutableKey);
+    let transceiver = target.valueMap.get(mutableKey);
+    if (mutableAtom.type === `mutable_atom` && isChildStore(target)) {
+      const { parent } = target;
+      const copiedValue = copyMutableIfNeeded(target, mutableAtom, parent);
+      transceiver = copiedValue;
+    }
+    const accepted = transceiver.do(update.newValue) === null;
+    if (accepted) evictDownStream(target, mutableAtom);
   }
 };
 
@@ -592,7 +578,7 @@ var setAtomOrSelector = (store, state, value) => {
   switch (state.type) {
     case `atom`:
     case `mutable_atom`:
-      setAtom(state, value, store);
+      setAtom(store, state, value);
       break;
     case `selector`:
       state.set(value);
@@ -1661,6 +1647,27 @@ function ingestTransactionUpdate(applying, transactionUpdate, store) {
   }
 }
 
+// internal/src/transaction/get-epoch-number.ts
+function getContinuityKey(store, transactionKey) {
+  const continuity = store.transactionMeta.actionContinuities.getRelatedKey(transactionKey);
+  return continuity;
+}
+function getEpochNumberOfContinuity(store, continuityKey) {
+  const epoch = store.transactionMeta.epoch.get(continuityKey);
+  return epoch;
+}
+function getEpochNumberOfAction(store, transactionKey) {
+  const isRoot = isRootStore(store);
+  if (!isRoot) {
+    return void 0;
+  }
+  const continuityKey = getContinuityKey(store, transactionKey);
+  if (continuityKey === void 0) {
+    return void 0;
+  }
+  return getEpochNumberOfContinuity(store, continuityKey);
+}
+
 // internal/src/transaction/set-epoch-number.ts
 function setEpochNumberOfContinuity(store, continuityKey, newEpoch) {
   const isRoot = isRootStore(store);
@@ -1673,7 +1680,7 @@ function setEpochNumberOfAction(store, transactionKey, newEpoch) {
   if (!isRoot) {
     return;
   }
-  const continuityKey = store.transactionMeta.actionContinuities.getRelatedKey(transactionKey);
+  const continuityKey = getContinuityKey(store, transactionKey);
   if (continuityKey !== void 0) {
     store.transactionMeta.epoch.set(continuityKey, newEpoch);
   }
@@ -2249,24 +2256,6 @@ function createTransaction(store, options) {
   return token;
 }
 
-// internal/src/transaction/get-epoch-number.ts
-function getContinuityKey(store, transactionKey) {
-  const isRoot = isRootStore(store);
-  const continuity = isRoot ? store.transactionMeta.actionContinuities.getRelatedKey(transactionKey) : void 0;
-  return continuity;
-}
-function getEpochNumberOfContinuity(store, continuityKey) {
-  const isRoot = isRootStore(store);
-  const epoch = isRoot && continuityKey ? store.transactionMeta.epoch.get(continuityKey) : void 0;
-  return epoch;
-}
-function getEpochNumberOfAction(store, transactionKey) {
-  const isRoot = isRootStore(store);
-  const continuity = isRoot ? store.transactionMeta.actionContinuities.getRelatedKey(transactionKey) : void 0;
-  const epoch = isRoot && continuity !== void 0 ? store.transactionMeta.epoch.get(continuity) : void 0;
-  return epoch;
-}
-
 // internal/src/transaction/index.ts
 var TRANSACTION_PHASES = [`idle`, `building`, `applying`];
 
@@ -2471,7 +2460,7 @@ var Store = class {
     lifespan: `ephemeral`
   };
   loggers = [
-    new AtomIOLogger(`warn`, (_, __, key) => !key.includes(`\u{1F50D}`))
+    new AtomIOLogger(`warn`, (_, __, key) => !isReservedIntrospectionKey(key))
   ];
   logger = {
     error: (...messages) => {
@@ -3100,18 +3089,18 @@ function isTransceiver(value) {
 function copyMutableIfNeeded(target, atom2, origin) {
   const originValue = origin.valueMap.get(atom2.key);
   const targetValue = target.valueMap.get(atom2.key);
-  if (originValue === targetValue) {
-    if (originValue === void 0) {
-      return typeof atom2.default === `function` ? atom2.default() : atom2.default;
-    }
-    origin.logger.info(`\u{1F4C3}`, `atom`, atom2.key, `copying`);
-    const jsonValue = atom2.toJson(originValue);
-    const copiedValue = atom2.fromJson(jsonValue);
-    target.valueMap.set(atom2.key, copiedValue);
-    new Tracker(atom2, origin);
-    return copiedValue;
-  }
-  return targetValue;
+  if (originValue !== targetValue) {
+    return targetValue;
+  }
+  if (originValue === void 0) {
+    return atom2.default();
+  }
+  origin.logger.info(`\u{1F4C3}`, `atom`, atom2.key, `copying`);
+  const jsonValue = atom2.toJson(originValue);
+  const copiedValue = atom2.fromJson(jsonValue);
+  target.valueMap.set(atom2.key, copiedValue);
+  new Tracker(atom2, origin);
+  return copiedValue;
 }
 
 // internal/src/caching.ts
@@ -4039,6 +4028,11 @@ function getInternalRelationsFromStore(token, store) {
   return family;
 }
 
+// internal/src/reserved-keys.ts
+function isReservedIntrospectionKey(value) {
+  return value.startsWith(`\u{1F50D} `);
+}
+
 // internal/src/timeline/create-timeline.ts
 function createTimeline(store, options, data) {
   const tl = {
@@ -4504,4 +4498,4 @@ var JSON_DEFAULTS = {
   string: ``
 };
 
-export { $claim, Anarchy, AtomIOLogger, CircularBuffer, FAMILY_MEMBER_TOKEN_TYPES, FamilyTracker, Future, IMPLICIT, JSON_DEFAULTS, JSON_TYPE_NAMES, Join, Junction, LOG_LEVELS, LazyMap, NotFoundError, Realm, SetRTX, Silo, StatefulSubject, Store, Subject, T$, TRANSACTION_PHASES, Tracker, abortTransaction, actUponStore, allocateIntoStore, applyTransaction, arbitrary, assignTransactionToContinuity, atom, atomFamily, become, belongsTo, buildTransaction, cacheValue, capitalize, claimWithinStore, clearStore, closeOperation, counterfeit, createAtomFamily, createMutableAtom, createMutableAtomFamily, createReadonlySelector, createReadonlySelectorFamily, createRegularAtom, createRegularAtomFamily, createSelectorFamily, createStandaloneAtom, createStandaloneSelector, createTimeline, createTransaction, createWritableSelector, deallocateFromStore, deposit, disposeAtom, disposeFromStore, disposeSelector, disposeState, editRelations, editRelationsInStore, evictCachedValue, findInStore, findRelations, findRelationsInStore, findState, fromEntries, fuseWithinStore, getContinuityKey, getEnvironmentData, getEpochNumberOfAction, getEpochNumberOfContinuity, getFromStore, getInternalRelations, getInternalRelationsFromStore, getJoin, getJsonFamily, getJsonToken, getSelectorDependencyKeys, getState, getTrace, getUpdateFamily, getUpdateToken, ingestAtomUpdate, ingestCreationEvent, ingestDisposalEvent, ingestMoleculeCreationEvent, ingestMoleculeDisposalEvent, ingestMoleculeTransferEvent, ingestSelectorUpdate, ingestTransactionUpdate, initFamilyMemberInStore, isAtomDefault, isAtomKey, isChildStore, isDone, isJson, isReadonlySelectorKey, isRootStore, isSelectorKey, isStateKey, isToken, isTransceiver, join, makeRootMoleculeInStore, markAtomAsDefault, markAtomAsNotDefault, markDone, newest, openOperation, parseJson, prettyPrintTokenType, readCachedValue, readOrComputeValue, recallState, redo, registerSelector, runTransaction, seekInStore, selectJson, selectJsonFamily, selector, selectorFamily, setAtomOrSelector, setEpochNumberOfAction, setEpochNumberOfContinuity, setIntoStore, setState, simpleLog, simpleLogger, stringifyJson, subscribe, subscribeInStore, subscribeToRootAtoms, subscribeToState, subscribeToTimeline, subscribeToTransaction, timeTravel, timeline, toEntries, traceAllSelectorAtoms, traceSelectorAtoms, transaction, undo, updateSelectorAtoms, withdraw };
+export { $claim, Anarchy, AtomIOLogger, CircularBuffer, FAMILY_MEMBER_TOKEN_TYPES, FamilyTracker, Future, IMPLICIT, JSON_DEFAULTS, JSON_TYPE_NAMES, Join, Junction, LOG_LEVELS, LazyMap, NotFoundError, Realm, SetRTX, Silo, StatefulSubject, Store, Subject, T$, TRANSACTION_PHASES, Tracker, abortTransaction, actUponStore, allocateIntoStore, applyTransaction, arbitrary, assignTransactionToContinuity, atom, atomFamily, become, belongsTo, buildTransaction, cacheValue, capitalize, claimWithinStore, clearStore, closeOperation, counterfeit, createAtomFamily, createMutableAtom, createMutableAtomFamily, createReadonlySelector, createReadonlySelectorFamily, createRegularAtom, createRegularAtomFamily, createSelectorFamily, createStandaloneAtom, createStandaloneSelector, createTimeline, createTransaction, createWritableSelector, deallocateFromStore, deposit, disposeAtom, disposeFromStore, disposeSelector, disposeState, editRelations, editRelationsInStore, evictCachedValue, findInStore, findRelations, findRelationsInStore, findState, fromEntries, fuseWithinStore, getContinuityKey, getEnvironmentData, getEpochNumberOfAction, getEpochNumberOfContinuity, getFromStore, getInternalRelations, getInternalRelationsFromStore, getJoin, getJsonFamily, getJsonToken, getSelectorDependencyKeys, getState, getTrace, getUpdateFamily, getUpdateToken, ingestAtomUpdate, ingestCreationEvent, ingestDisposalEvent, ingestMoleculeCreationEvent, ingestMoleculeDisposalEvent, ingestMoleculeTransferEvent, ingestSelectorUpdate, ingestTransactionUpdate, initFamilyMemberInStore, isAtomDefault, isAtomKey, isChildStore, isDone, isJson, isReadonlySelectorKey, isReservedIntrospectionKey, isRootStore, isSelectorKey, isStateKey, isToken, isTransceiver, join, makeRootMoleculeInStore, markAtomAsDefault, markAtomAsNotDefault, markDone, newest, openOperation, parseJson, prettyPrintTokenType, readCachedValue, readOrComputeValue, recallState, redo, registerSelector, runTransaction, seekInStore, selectJson, selectJsonFamily, selector, selectorFamily, setAtomOrSelector, setEpochNumberOfAction, setEpochNumberOfContinuity, setIntoStore, setState, simpleLog, simpleLogger, stringifyJson, subscribe, subscribeInStore, subscribeToRootAtoms, subscribeToState, subscribeToTimeline, subscribeToTransaction, timeTravel, timeline, toEntries, traceAllSelectorAtoms, traceSelectorAtoms, transaction, undo, updateSelectorAtoms, withdraw };

package/dist/{chunk-XN3EO2UT.js → chunk-EF4S7H42.js}

@@ -1,5 +1,5 @@
 import { persistSync } from './chunk-4LWKCEW3.js';
-import { atom, selector, setIntoStore, getEpochNumberOfContinuity, isRootStore, ingestTransactionUpdate, setEpochNumberOfContinuity, disposeAtom, parseJson, getJsonToken, getUpdateToken, subscribeToState, subscribeToTransaction, getFromStore, assignTransactionToContinuity, actUponStore } from './chunk-RXQWAO26.js';
+import { atom, selector, setIntoStore, isRootStore, getEpochNumberOfContinuity, ingestTransactionUpdate, setEpochNumberOfContinuity, disposeAtom, parseJson, getJsonToken, getUpdateToken, subscribeToState, subscribeToTransaction, getFromStore, assignTransactionToContinuity, actUponStore } from './chunk-35NB2XZU.js';
 
 // realtime-client/src/continuity/register-and-attempt-confirmed-update.ts
 var useRegisterAndAttemptConfirmedUpdate = (store, continuityKey, socket, optimisticUpdates, confirmedUpdates) => (confirmed) => {
@@ -150,9 +150,12 @@ var useRegisterAndAttemptConfirmedUpdate = (store, continuityKey, socket, optimi
       continuityKey,
       `has no optimistic updates to deal with`
     );
-    const continuityEpoch = getEpochNumberOfContinuity(store, continuityKey);
     const isRoot = isRootStore(store);
-    if (isRoot && continuityEpoch === confirmed.epoch - 1) {
+    let continuityEpoch;
+    if (isRoot) {
+      continuityEpoch = getEpochNumberOfContinuity(store, continuityKey);
+    }
+    if (continuityEpoch === confirmed.epoch - 1) {
       store.logger.info(
         `\u2705`,
         `continuity`,

package/dist/{chunk-QRPY4LSO.js → chunk-LTLDKXDN.js}

@@ -1,6 +1,6 @@
-import { myIdState__INTERNAL, pullAtom, pullAtomFamilyMember, pullMutableAtom, pullMutableAtomFamilyMember, pullSelector, pullSelectorFamilyMember, pushState, serverAction, syncContinuity } from './chunk-XN3EO2UT.js';
-import { useI, StoreContext, useO } from './chunk-HEEVASKG.js';
-import { findInStore, actUponStore, arbitrary } from './chunk-RXQWAO26.js';
+import { myIdState__INTERNAL, pullAtom, pullAtomFamilyMember, pullMutableAtom, pullMutableAtomFamilyMember, pullSelector, pullSelectorFamilyMember, pushState, serverAction, syncContinuity } from './chunk-EF4S7H42.js';
+import { useI, StoreContext, useO } from './chunk-MENOYVPP.js';
+import { findInStore, actUponStore, arbitrary } from './chunk-35NB2XZU.js';
 import * as React from 'react';
 import { jsx } from 'react/jsx-runtime';
 

package/dist/{chunk-HEEVASKG.js → chunk-MENOYVPP.js}

@@ -1,4 +1,4 @@
-import { IMPLICIT, setIntoStore, subscribeToState, getFromStore, findInStore, getJsonToken, withdraw, subscribeToTimeline, redo, undo } from './chunk-RXQWAO26.js';
+import { IMPLICIT, setIntoStore, subscribeToState, getFromStore, findInStore, getJsonToken, withdraw, subscribeToTimeline, redo, undo } from './chunk-35NB2XZU.js';
 import * as React5 from 'react';
 import { jsx } from 'react/jsx-runtime';
 

package/dist/{chunk-KMBRCA5Q.js → chunk-RGUNRT72.js}

@@ -1,4 +1,4 @@
-import { IMPLICIT, getState, createReadonlySelectorFamily, createRegularAtomFamily, Subject, createSelectorFamily, createRegularAtom, createStandaloneSelector, deposit } from './chunk-RXQWAO26.js';
+import { IMPLICIT, getState, createReadonlySelectorFamily, createRegularAtomFamily, Subject, createSelectorFamily, createRegularAtom, createStandaloneSelector, isReservedIntrospectionKey, deposit } from './chunk-35NB2XZU.js';
 
 // introspection/src/attach-atom-index.ts
 var attachAtomIndex = (store) => {
@@ -9,21 +9,22 @@ var attachAtomIndex = (store) => {
       default: () => {
         const base = /* @__PURE__ */ new Map();
         for (const [key, val] of store.atoms) {
-          if (!key.includes(`\u{1F50D}`)) {
-            const token = deposit(val);
-            if (val.family) {
-              let familyNode = base.get(val.family.key);
-              if (!familyNode || !(`familyMembers` in familyNode)) {
-                familyNode = {
-                  key: val.family.key,
-                  familyMembers: /* @__PURE__ */ new Map()
-                };
-                base.set(val.family.key, familyNode);
-              }
-              familyNode.familyMembers.set(val.family.subKey, token);
-            } else {
-              base.set(key, token);
+          if (isReservedIntrospectionKey(key)) {
+            continue;
+          }
+          const token = deposit(val);
+          if (val.family) {
+            let familyNode = base.get(val.family.key);
+            if (!familyNode || !(`familyMembers` in familyNode)) {
+              familyNode = {
+                key: val.family.key,
+                familyMembers: /* @__PURE__ */ new Map()
+              };
+              base.set(val.family.key, familyNode);
             }
+            familyNode.familyMembers.set(val.family.subKey, token);
+          } else {
+            base.set(key, token);
           }
         }
         return base;
@@ -31,7 +32,7 @@ var attachAtomIndex = (store) => {
       effects: [
         ({ setSelf }) => {
           store.on.atomCreation.subscribe(`introspection`, (atomToken) => {
-            if (atomToken.key.includes(`\u{1F50D}`)) {
+            if (isReservedIntrospectionKey(atomToken.key)) {
               return;
             }
             setSelf((self) => {
@@ -90,21 +91,22 @@ var attachSelectorIndex = (store) => {
         const base = /* @__PURE__ */ new Map();
         for (const map of [store.readonlySelectors, store.selectors]) {
           for (const [key, val] of map) {
-            if (!key.includes(`\u{1F50D}`)) {
-              const token = deposit(val);
-              if (val.family) {
-                let familyNode = base.get(val.family.key);
-                if (!familyNode || !(`familyMembers` in familyNode)) {
-                  familyNode = {
-                    key: val.family.key,
-                    familyMembers: /* @__PURE__ */ new Map()
-                  };
-                  base.set(val.family.key, familyNode);
-                }
-                familyNode.familyMembers.set(val.family.subKey, token);
-              } else {
-                base.set(key, token);
+            if (isReservedIntrospectionKey(key)) {
+              continue;
+            }
+            const token = deposit(val);
+            if (val.family) {
+              let familyNode = base.get(val.family.key);
+              if (!familyNode || !(`familyMembers` in familyNode)) {
+                familyNode = {
+                  key: val.family.key,
+                  familyMembers: /* @__PURE__ */ new Map()
+                };
+                base.set(val.family.key, familyNode);
               }
+              familyNode.familyMembers.set(val.family.subKey, token);
+            } else {
+              base.set(key, token);
             }
           }
         }
@@ -115,7 +117,7 @@ var attachSelectorIndex = (store) => {
           store.on.selectorCreation.subscribe(
             `introspection`,
             (selectorToken) => {
-              if (selectorToken.key.includes(`\u{1F50D}`)) {
+              if (isReservedIntrospectionKey(selectorToken.key)) {
                 return;
               }
               setSelf((self) => {

package/dist/{chunk-NDTM5IY3.js → chunk-TS76LQVD.js}

@@ -1,5 +1,5 @@
-import { roomIndex, usersInRooms } from './chunk-YPME5OLO.js';
-import { atomFamily, selectorFamily, transaction, editRelationsInStore, atom, SetRTX, join, parseJson, Subject, stringifyJson, findRelationsInStore, IMPLICIT, getFromStore, subscribeToState, findInStore, getJsonToken, getUpdateToken, actUponStore, setIntoStore, subscribeToTransaction, isRootStore } from './chunk-RXQWAO26.js';
+import { roomIndex, usersInRooms } from './chunk-2XDFCXGB.js';
+import { atomFamily, selectorFamily, transaction, editRelationsInStore, atom, SetRTX, join, parseJson, Subject, stringifyJson, findRelationsInStore, IMPLICIT, getFromStore, subscribeToState, findInStore, getJsonToken, getUpdateToken, actUponStore, setIntoStore, subscribeToTransaction, isRootStore } from './chunk-35NB2XZU.js';
 import { spawn } from 'node:child_process';
 
 // realtime-server/src/ipc-sockets/custom-socket.ts

package/dist/index.js

@@ -1,2 +1,2 @@
-export { $claim, Anarchy, AtomIOLogger, LOG_LEVELS, Realm, Silo, T$, atom, atomFamily, belongsTo, disposeState, editRelations, findRelations, findState, getInternalRelations, getState, isToken, join, redo, runTransaction, selector, selectorFamily, setState, simpleLog, simpleLogger, subscribe, timeline, transaction, undo } from './chunk-RXQWAO26.js';
+export { $claim, Anarchy, AtomIOLogger, LOG_LEVELS, Realm, Silo, T$, atom, atomFamily, belongsTo, disposeState, editRelations, findRelations, findState, getInternalRelations, getState, isToken, join, redo, runTransaction, selector, selectorFamily, setState, simpleLog, simpleLogger, subscribe, timeline, transaction, undo } from './chunk-35NB2XZU.js';
 import './chunk-XWL6SNVU.js';

package/internal/dist/index.d.ts

@@ -185,8 +185,8 @@ type Transaction<F extends Func> = {
 };
 declare function createTransaction<F extends Func>(store: Store, options: TransactionOptions<F>): TransactionToken<F>;
 
-declare function getContinuityKey(store: Store, transactionKey: string): string | undefined;
-declare function getEpochNumberOfContinuity(store: Store, continuityKey: string): number | undefined;
+declare function getContinuityKey(store: RootStore, transactionKey: string): string | undefined;
+declare function getEpochNumberOfContinuity(store: RootStore, continuityKey: string): number | undefined;
 declare function getEpochNumberOfAction(store: Store, transactionKey: string): number | undefined;
 
 declare function setEpochNumberOfContinuity(store: Store, continuityKey: string, newEpoch: number): void;
@@ -638,6 +638,9 @@ declare class NotFoundError extends Error {
 
 declare function prettyPrintTokenType(token: AtomIOToken): string;
 
+type ReservedIntrospectionKey = `🔍 ${string}`;
+declare function isReservedIntrospectionKey(value: string): value is ReservedIntrospectionKey;
+
 declare const createReadonlySelector: <T>(store: Store, options: ReadonlySelectorOptions<T>, family: FamilyMetadata | undefined) => ReadonlySelectorToken<T>;
 
 declare function createStandaloneSelector<T>(store: Store, options: WritableSelectorOptions<T>): WritableSelectorToken<T>;
@@ -695,7 +698,7 @@ type RegularAtom<T> = AtomIOState & {
 };
 type MutableAtom<T extends Transceiver<any>, J extends Json.Serializable> = AtomIOState & JsonInterface<T, J> & {
     type: `mutable_atom`;
-    default: T | (() => T);
+    default: () => T;
     cleanup?: () => void;
 };
 type Atom<T> = RegularAtom<T> | (T extends Transceiver<any> ? MutableAtom<T, any> : never);
@@ -741,4 +744,4 @@ type WritableFamily<T, K extends Canonical> = AtomFamily<T, K> | WritableSelecto
 type ReadableFamily<T, K extends Canonical> = AtomFamily<T, K> | SelectorFamily<T, K>;
 type AtomIOInternalResource = ReadableFamily<any, any> | ReadableState<any> | Timeline<any> | Transaction<any>;
 
-export { type Atom, type AtomFamily, type AtomIOInternalResource, type AtomIOState, type AtomKey, type BaseExternalStoreConfiguration, type ChildStore, CircularBuffer, type Count, type Each, type Empty, type EnvironmentData, type ExternalStoreConfiguration, type ExternalStoreWithContentConfiguration, FAMILY_MEMBER_TOKEN_TYPES, FamilyTracker, type Flat, type Func, Future, IMPLICIT, Join, type JoinStateFamilies, Junction, type JunctionAdvancedConfiguration, type JunctionEntries, type JunctionEntriesBase, type JunctionJSON, type JunctionSchema, type JunctionSchemaBase, LazyMap, type Lineage, type Modify, type Molecule, type MutableAtom, type MutableAtomFamily, NotFoundError, type OperationProgress, type ReadableFamily, type ReadableState, type ReadonlySelector, type ReadonlySelectorFamily, type ReadonlySelectorKey, type Refinement, type RegularAtom, type RegularAtomFamily, type RootStore, type Selector, type SelectorFamily, type SelectorKey, type Signal, type StateKey, StatefulSubject, Store, Subject, TRANSACTION_PHASES, type Timeline, type TimelineAtomUpdate, type TimelineMoleculeCreation, type TimelineMoleculeDisposal, type TimelineSelectorUpdate, type TimelineStateCreation, type TimelineStateDisposal, type TimelineTransactionUpdate, Tracker, type Transaction, type TransactionEpoch, type TransactionPhase, type TransactionProgress, type Transceiver, type TransceiverMode, type WritableFamily, type WritableSelector, type WritableSelectorFamily, type WritableState, abortTransaction, actUponStore, allocateIntoStore, applyTransaction, arbitrary, assignTransactionToContinuity, become, buildTransaction, cacheValue, capitalize, claimWithinStore, clearStore, closeOperation, counterfeit, createAtomFamily, createMutableAtom, createMutableAtomFamily, createReadonlySelector, createReadonlySelectorFamily, createRegularAtom, createRegularAtomFamily, createSelectorFamily, createStandaloneAtom, createStandaloneSelector, createTimeline, createTransaction, createWritableSelector, deallocateFromStore, deposit, disposeAtom, disposeFromStore, disposeSelector, editRelationsInStore, evictCachedValue, findInStore, findRelationsInStore, fuseWithinStore, getContinuityKey, getEnvironmentData, getEpochNumberOfAction, getEpochNumberOfContinuity, getFromStore, getInternalRelationsFromStore, getJoin, getJsonFamily, getJsonToken, getSelectorDependencyKeys, getTrace, getUpdateFamily, getUpdateToken, ingestAtomUpdate, ingestCreationEvent, ingestDisposalEvent, ingestMoleculeCreationEvent, ingestMoleculeDisposalEvent, ingestMoleculeTransferEvent, ingestSelectorUpdate, ingestTransactionUpdate, initFamilyMemberInStore, isAtomDefault, isAtomKey, isChildStore, isDone, isReadonlySelectorKey, isRootStore, isSelectorKey, isStateKey, isTransceiver, makeRootMoleculeInStore, markAtomAsDefault, markAtomAsNotDefault, markDone, newest, openOperation, prettyPrintTokenType, readCachedValue, readOrComputeValue, recallState, registerSelector, seekInStore, setAtomOrSelector, setEpochNumberOfAction, setEpochNumberOfContinuity, setIntoStore, subscribeInStore, subscribeToRootAtoms, subscribeToState, subscribeToTimeline, subscribeToTransaction, timeTravel, traceAllSelectorAtoms, traceSelectorAtoms, updateSelectorAtoms, withdraw };
+export { type Atom, type AtomFamily, type AtomIOInternalResource, type AtomIOState, type AtomKey, type BaseExternalStoreConfiguration, type ChildStore, CircularBuffer, type Count, type Each, type Empty, type EnvironmentData, type ExternalStoreConfiguration, type ExternalStoreWithContentConfiguration, FAMILY_MEMBER_TOKEN_TYPES, FamilyTracker, type Flat, type Func, Future, IMPLICIT, Join, type JoinStateFamilies, Junction, type JunctionAdvancedConfiguration, type JunctionEntries, type JunctionEntriesBase, type JunctionJSON, type JunctionSchema, type JunctionSchemaBase, LazyMap, type Lineage, type Modify, type Molecule, type MutableAtom, type MutableAtomFamily, NotFoundError, type OperationProgress, type ReadableFamily, type ReadableState, type ReadonlySelector, type ReadonlySelectorFamily, type ReadonlySelectorKey, type Refinement, type RegularAtom, type RegularAtomFamily, type ReservedIntrospectionKey, type RootStore, type Selector, type SelectorFamily, type SelectorKey, type Signal, type StateKey, StatefulSubject, Store, Subject, TRANSACTION_PHASES, type Timeline, type TimelineAtomUpdate, type TimelineMoleculeCreation, type TimelineMoleculeDisposal, type TimelineSelectorUpdate, type TimelineStateCreation, type TimelineStateDisposal, type TimelineTransactionUpdate, Tracker, type Transaction, type TransactionEpoch, type TransactionPhase, type TransactionProgress, type Transceiver, type TransceiverMode, type WritableFamily, type WritableSelector, type WritableSelectorFamily, type WritableState, abortTransaction, actUponStore, allocateIntoStore, applyTransaction, arbitrary, assignTransactionToContinuity, become, buildTransaction, cacheValue, capitalize, claimWithinStore, clearStore, closeOperation, counterfeit, createAtomFamily, createMutableAtom, createMutableAtomFamily, createReadonlySelector, createReadonlySelectorFamily, createRegularAtom, createRegularAtomFamily, createSelectorFamily, createStandaloneAtom, createStandaloneSelector, createTimeline, createTransaction, createWritableSelector, deallocateFromStore, deposit, disposeAtom, disposeFromStore, disposeSelector, editRelationsInStore, evictCachedValue, findInStore, findRelationsInStore, fuseWithinStore, getContinuityKey, getEnvironmentData, getEpochNumberOfAction, getEpochNumberOfContinuity, getFromStore, getInternalRelationsFromStore, getJoin, getJsonFamily, getJsonToken, getSelectorDependencyKeys, getTrace, getUpdateFamily, getUpdateToken, ingestAtomUpdate, ingestCreationEvent, ingestDisposalEvent, ingestMoleculeCreationEvent, ingestMoleculeDisposalEvent, ingestMoleculeTransferEvent, ingestSelectorUpdate, ingestTransactionUpdate, initFamilyMemberInStore, isAtomDefault, isAtomKey, isChildStore, isDone, isReadonlySelectorKey, isReservedIntrospectionKey, isRootStore, isSelectorKey, isStateKey, isTransceiver, makeRootMoleculeInStore, markAtomAsDefault, markAtomAsNotDefault, markDone, newest, openOperation, prettyPrintTokenType, readCachedValue, readOrComputeValue, recallState, registerSelector, seekInStore, setAtomOrSelector, setEpochNumberOfAction, setEpochNumberOfContinuity, setIntoStore, subscribeInStore, subscribeToRootAtoms, subscribeToState, subscribeToTimeline, subscribeToTransaction, timeTravel, traceAllSelectorAtoms, traceSelectorAtoms, updateSelectorAtoms, withdraw };

package/internal/dist/index.js

@@ -1,2 +1,2 @@
-export { CircularBuffer, FAMILY_MEMBER_TOKEN_TYPES, FamilyTracker, Future, IMPLICIT, Join, Junction, LazyMap, NotFoundError, StatefulSubject, Store, Subject, TRANSACTION_PHASES, Tracker, abortTransaction, actUponStore, allocateIntoStore, applyTransaction, arbitrary, assignTransactionToContinuity, become, buildTransaction, cacheValue, capitalize, claimWithinStore, clearStore, closeOperation, counterfeit, createAtomFamily, createMutableAtom, createMutableAtomFamily, createReadonlySelector, createReadonlySelectorFamily, createRegularAtom, createRegularAtomFamily, createSelectorFamily, createStandaloneAtom, createStandaloneSelector, createTimeline, createTransaction, createWritableSelector, deallocateFromStore, deposit, disposeAtom, disposeFromStore, disposeSelector, editRelationsInStore, evictCachedValue, findInStore, findRelationsInStore, fuseWithinStore, getContinuityKey, getEnvironmentData, getEpochNumberOfAction, getEpochNumberOfContinuity, getFromStore, getInternalRelationsFromStore, getJoin, getJsonFamily, getJsonToken, getSelectorDependencyKeys, getTrace, getUpdateFamily, getUpdateToken, ingestAtomUpdate, ingestCreationEvent, ingestDisposalEvent, ingestMoleculeCreationEvent, ingestMoleculeDisposalEvent, ingestMoleculeTransferEvent, ingestSelectorUpdate, ingestTransactionUpdate, initFamilyMemberInStore, isAtomDefault, isAtomKey, isChildStore, isDone, isReadonlySelectorKey, isRootStore, isSelectorKey, isStateKey, isTransceiver, makeRootMoleculeInStore, markAtomAsDefault, markAtomAsNotDefault, markDone, newest, openOperation, prettyPrintTokenType, readCachedValue, readOrComputeValue, recallState, registerSelector, seekInStore, setAtomOrSelector, setEpochNumberOfAction, setEpochNumberOfContinuity, setIntoStore, subscribeInStore, subscribeToRootAtoms, subscribeToState, subscribeToTimeline, subscribeToTransaction, timeTravel, traceAllSelectorAtoms, traceSelectorAtoms, updateSelectorAtoms, withdraw } from '../../dist/chunk-RXQWAO26.js';
+export { CircularBuffer, FAMILY_MEMBER_TOKEN_TYPES, FamilyTracker, Future, IMPLICIT, Join, Junction, LazyMap, NotFoundError, StatefulSubject, Store, Subject, TRANSACTION_PHASES, Tracker, abortTransaction, actUponStore, allocateIntoStore, applyTransaction, arbitrary, assignTransactionToContinuity, become, buildTransaction, cacheValue, capitalize, claimWithinStore, clearStore, closeOperation, counterfeit, createAtomFamily, createMutableAtom, createMutableAtomFamily, createReadonlySelector, createReadonlySelectorFamily, createRegularAtom, createRegularAtomFamily, createSelectorFamily, createStandaloneAtom, createStandaloneSelector, createTimeline, createTransaction, createWritableSelector, deallocateFromStore, deposit, disposeAtom, disposeFromStore, disposeSelector, editRelationsInStore, evictCachedValue, findInStore, findRelationsInStore, fuseWithinStore, getContinuityKey, getEnvironmentData, getEpochNumberOfAction, getEpochNumberOfContinuity, getFromStore, getInternalRelationsFromStore, getJoin, getJsonFamily, getJsonToken, getSelectorDependencyKeys, getTrace, getUpdateFamily, getUpdateToken, ingestAtomUpdate, ingestCreationEvent, ingestDisposalEvent, ingestMoleculeCreationEvent, ingestMoleculeDisposalEvent, ingestMoleculeTransferEvent, ingestSelectorUpdate, ingestTransactionUpdate, initFamilyMemberInStore, isAtomDefault, isAtomKey, isChildStore, isDone, isReadonlySelectorKey, isReservedIntrospectionKey, isRootStore, isSelectorKey, isStateKey, isTransceiver, makeRootMoleculeInStore, markAtomAsDefault, markAtomAsNotDefault, markDone, newest, openOperation, prettyPrintTokenType, readCachedValue, readOrComputeValue, recallState, registerSelector, seekInStore, setAtomOrSelector, setEpochNumberOfAction, setEpochNumberOfContinuity, setIntoStore, subscribeInStore, subscribeToRootAtoms, subscribeToState, subscribeToTimeline, subscribeToTransaction, timeTravel, traceAllSelectorAtoms, traceSelectorAtoms, updateSelectorAtoms, withdraw } from '../../dist/chunk-35NB2XZU.js';
 import '../../dist/chunk-XWL6SNVU.js';

package/internal/src/get-state/read-or-compute-value.ts

@@ -10,18 +10,28 @@ export const readOrComputeValue = <T>(
 		target.logger.info(`📖`, state.type, state.key, `reading cached value`)
 		return readCachedValue(state, target)
 	}
-	if (state.type === `selector` || state.type === `readonly_selector`) {
-		target.logger.info(`🧮`, state.type, state.key, `computing value`)
-		return state.get()
+	switch (state.type) {
+		case `selector`:
+		case `readonly_selector`:
+			target.logger.info(`🧮`, state.type, state.key, `computing value`)
+			return state.get()
+		case `atom`:
+		case `mutable_atom`: {
+			const def = state.default
+			let fallback: T
+			if (def instanceof Function) {
+				fallback = def()
+			} else {
+				fallback = def
+			}
+			target.logger.info(
+				`💁`,
+				`atom`,
+				state.key,
+				`could not find cached value; using default`,
+				fallback,
+			)
+			return fallback
+		}
 	}
-	const fallback =
-		state.default instanceof Function ? state.default() : state.default
-	target.logger.info(
-		`💁`,
-		`atom`,
-		state.key,
-		`could not find cached value; using default`,
-		fallback,
-	)
-	return state.default instanceof Function ? state.default() : state.default
 }