atom.io 0.37.0 → 0.38.0

package/dist/internal/index.js

@@ -1,5 +1,5 @@
 import { parseJson, stringifyJson } from "atom.io/json";
-import { Anarchy, AtomIOLogger } from "atom.io";
+import { Anarchy, AtomIOLogger, PRETTY_TOKEN_TYPES } from "atom.io";
 import { SetRTX } from "atom.io/transceivers/set-rtx";
 
 //#region src/internal/arbitrary.ts
@@ -43,7 +43,19 @@ var CircularBuffer = class CircularBuffer {
 };
 
 //#endregion
-//#region src/internal/store/counterfeit.ts
+//#region src/internal/store/deposit.ts
+function deposit(state) {
+	const token = {
+		key: state.key,
+		type: state.type
+	};
+	if (`family` in state) token.family = state.family;
+	return token;
+}
+
+//#endregion
+//#region src/internal/store/mint-or-counterfeit.ts
+const COUNTERFEIT = Symbol(`counterfeit`);
 const FAMILY_MEMBER_TOKEN_TYPES = {
 	atom_family: `atom`,
 	molecule_family: `molecule`,
@@ -53,33 +65,22 @@ const FAMILY_MEMBER_TOKEN_TYPES = {
 	writable_held_selector_family: `writable_held_selector`,
 	writable_pure_selector_family: `writable_pure_selector`
 };
-function counterfeit(token, key) {
+function mint(token, key, counterfeit) {
 	const subKey = stringifyJson(key);
 	const fullKey = `${token.key}(${subKey})`;
 	const type = FAMILY_MEMBER_TOKEN_TYPES[token.type];
 	const stateToken = {
 		key: fullKey,
-		type
+		type,
+		family: {
+			key: token.key,
+			subKey
+		}
 	};
-	Object.assign(stateToken, { family: {
-		key: token.key,
-		subKey
-	} });
-	Object.assign(stateToken, { counterfeit: true });
+	if (counterfeit) stateToken.counterfeit = true;
 	return stateToken;
 }
 
-//#endregion
-//#region src/internal/store/deposit.ts
-function deposit(state) {
-	const token = {
-		key: state.key,
-		type: state.type
-	};
-	if (`family` in state) token.family = state.family;
-	return token;
-}
-
 //#endregion
 //#region src/internal/junction.ts
 var Junction = class {
@@ -382,6 +383,37 @@ const recallState = (store, state) => {
 	return target.valueMap.get(state.key);
 };
 
+//#endregion
+//#region src/internal/get-state/get-fallback.ts
+function getFallback(store, token, family, subKey) {
+	const disposal = store.disposalTraces.buffer.find((item) => item?.key === stringifyJson(subKey));
+	store.logger.error(`❌`, token.type, token.key, `gets a fallback value because key`, subKey, `is not allocated`, disposal ? `This key was previously disposed:\n${disposal.trace}` : `(no previous disposal trace found)`);
+	switch (family.type) {
+		case `mutable_atom_family`: {
+			if (store.defaults.has(family.key)) return store.defaults.get(family.key);
+			const defaultValue = new family.class();
+			store.defaults.set(family.key, defaultValue);
+			return defaultValue;
+		}
+		case `atom_family`: {
+			if (store.defaults.has(family.key)) return store.defaults.get(family.key);
+			const def = family.default;
+			const defaultValue = def(subKey);
+			store.defaults.set(family.key, defaultValue);
+			return defaultValue;
+		}
+		case `readonly_pure_selector_family`:
+		case `writable_pure_selector_family`:
+		case `readonly_held_selector_family`:
+		case `writable_held_selector_family`: {
+			if (store.defaults.has(family.key)) return store.defaults.get(family.key);
+			const defaultValue = family.default(subKey);
+			store.defaults.set(family.key, defaultValue);
+			return defaultValue;
+		}
+	}
+}
+
 //#endregion
 //#region src/internal/future.ts
 /**
@@ -452,7 +484,7 @@ function isChildStore(store) {
 function openOperation(store, token) {
 	if (store.operation.open) {
 		const rejectionTime = performance.now();
-		store.logger.info(`❗`, token.type, token.key, `deferring setState at T-${rejectionTime} until setState for "${store.operation.token.key}" is done`);
+		store.logger.info(`🚫`, token.type, token.key, `deferring setState at T-${rejectionTime} until setState for "${store.operation.token.key}" is done`);
 		return rejectionTime;
 	}
 	store.operation = {
@@ -626,10 +658,10 @@ function readOrComputeValue(target, state, mut) {
 //#endregion
 //#region src/internal/families/get-family-of-token.ts
 function getFamilyOfToken(store, token) {
-	if (token.family) {
-		const family = store.families.get(token.family.key);
-		if (family) return family;
-	}
+	return withdraw(store, {
+		key: token.family.key,
+		type: `${token.type}_family`
+	});
 }
 
 //#endregion
@@ -644,23 +676,11 @@ const abortTransaction = (store) => {
 	target.parent.child = null;
 };
 
-//#endregion
-//#region src/internal/capitalize.ts
-function capitalize(string) {
-	return string[0].toUpperCase() + string.slice(1);
-}
-
-//#endregion
-//#region src/internal/pretty-print.ts
-function prettyPrintTokenType(token) {
-	return token.type.split(`_`).map(capitalize).join(` `);
-}
-
 //#endregion
 //#region src/internal/not-found-error.ts
 var NotFoundError = class extends Error {
 	constructor(token, store) {
-		super(`${prettyPrintTokenType(token)} ${stringifyJson(token.key)} not found in store "${store.config.name}".`);
+		super(`${PRETTY_TOKEN_TYPES[token.type]} ${stringifyJson(token.key)} not found in store "${store.config.name}".`);
 	}
 };
 
@@ -773,7 +793,7 @@ function resetAtomOrSelector(target, state) {
 //#endregion
 //#region src/internal/set-state/set-into-store.ts
 function setIntoStore(store, ...params) {
-	operateOnStore(store, true, ...params);
+	operateOnStore(store, OWN_OP, ...params);
 }
 
 //#endregion
@@ -895,7 +915,7 @@ function allocateIntoStore(store, provenance, key, dependsOn = `any`) {
 	else target.on.moleculeCreation.next(creationEvent);
 	for (const claim of invalidKeys) {
 		const disposal = store.disposalTraces.buffer.find((item) => item?.key === claim);
-		store.logger.error(`❌`, `molecule`, key, `allocation failed:`, `Could not allocate to ${claim} in store "${store.config.name}".`, disposal ? `\n   ${claim} was most recently disposed\n${disposal.trace}` : `No previous disposal trace for ${claim} was found.`);
+		store.logger.error(`❌`, `key`, key, `allocation failed:`, `Could not allocate to ${claim} in store "${store.config.name}".`, disposal ? `\n   ${claim} was most recently disposed\n${disposal.trace}` : `No previous disposal trace for ${claim} was found.`);
 	}
 	return key;
 }
@@ -910,7 +930,7 @@ function deallocateFromStore(store, claim) {
 	const molecule = store.molecules.get(stringKey);
 	if (!molecule) {
 		const disposal = store.disposalTraces.buffer.find((item) => item?.key === stringKey);
-		store.logger.error(`❌`, `molecule`, claim, `deallocation failed:`, `Could not find allocation for ${stringKey} in store "${store.config.name}".`, disposal ? `\n   This state was most recently deallocated\n${disposal.trace}` : `No previous disposal trace for ${stringKey} was found.`);
+		store.logger.error(`❌`, `key`, claim, `deallocation failed:`, `Could not find allocation for ${stringKey} in store "${store.config.name}".`, disposal ? `\n   This state was most recently deallocated\n${disposal.trace}` : `No previous disposal trace for ${stringKey} was found.`);
 		return;
 	}
 	const joinKeys = store.moleculeJoins.getRelatedKeys(molecule.key);
@@ -964,14 +984,14 @@ function claimWithinStore(store, newProvenance, claim, exclusive) {
 	const molecule = target.molecules.get(stringKey);
 	if (!molecule) {
 		const disposal = store.disposalTraces.buffer.find((item) => item?.key === stringKey);
-		store.logger.error(`❌`, `molecule`, claim, `claim failed:`, `Could not allocate to ${stringKey} in store "${store.config.name}".`, disposal ? `\n   ${stringKey} was most recently disposed\n${disposal.trace}` : `No previous disposal trace for ${stringKey} was found.`);
+		store.logger.error(`❌`, `key`, stringKey, `claim failed:`, `Could not allocate to ${stringKey} in store "${store.config.name}".`, disposal ? `\n   ${stringKey} was most recently disposed\n${disposal.trace}` : `No previous disposal trace for ${stringKey} was found.`);
 		return claim;
 	}
 	const newProvenanceKey = stringifyJson(newProvenance);
 	const newProvenanceMolecule = target.molecules.get(newProvenanceKey);
 	if (!newProvenanceMolecule) {
 		const disposal = store.disposalTraces.buffer.find((item) => item?.key === newProvenanceKey);
-		store.logger.error(`❌`, `molecule`, claim, `claim failed:`, `Could not allocate to ${newProvenanceKey} in store "${store.config.name}".`, disposal ? `\n   ${newProvenanceKey} was most recently disposed\n${disposal.trace}` : `No previous disposal trace for ${newProvenanceKey} was found.`);
+		store.logger.error(`❌`, `key`, claim, `claim failed:`, `Could not allocate to ${newProvenanceKey} in store "${store.config.name}".`, disposal ? `\n   ${newProvenanceKey} was most recently disposed\n${disposal.trace}` : `No previous disposal trace for ${newProvenanceKey} was found.`);
 		return claim;
 	}
 	const priorProvenance = store.moleculeGraph.getRelationEntries({ downstreamMoleculeKey: molecule.stringKey }).filter(([, { source }]) => source !== stringKey).map(([key]) => parseJson(key));
@@ -1020,7 +1040,7 @@ function createInStore(update, store) {
 	const { family: familyMeta } = update.token;
 	if (familyMeta) {
 		const family = store.families.get(familyMeta.key);
-		if (family) findInStore(store, family, parseJson(familyMeta.subKey));
+		if (family) mintInStore(store, family, parseJson(familyMeta.subKey), MUST_CREATE);
 	}
 }
 function ingestMoleculeCreationEvent(update, applying, store) {
@@ -1045,7 +1065,7 @@ function ingestMoleculeDisposalEvent(update, applying, store) {
 				for (const [familyKey, value] of update.values) {
 					const family = store.families.get(familyKey);
 					if (family) {
-						findInStore(store, family, update.key);
+						mintInStore(store, family, update.key, MUST_CREATE);
 						const memberKey = `${familyKey}(${stringifyJson(update.key)})`;
 						store.valueMap.set(memberKey, value);
 					}
@@ -1338,42 +1358,57 @@ function initFamilyMemberInStore(store, token, key) {
 
 //#endregion
 //#region src/internal/families/mint-in-store.ts
-function mintInStore(store, familyToken, key) {
+const MUST_CREATE = Symbol(`MUST_NOT_EXIST`);
+function mintInStore(store, familyToken, key, shouldCreate) {
+	let stateToken;
+	let willCreate;
+	switch (shouldCreate) {
+		case MUST_CREATE:
+			willCreate = true;
+			break;
+		case void 0:
+			willCreate = false;
+			break;
+	}
 	const stringKey = stringifyJson(key);
 	const molecule = store.molecules.get(stringKey);
 	if (!molecule && store.config.lifespan === `immortal`) {
-		const fakeToken = counterfeit(familyToken, key);
-		store.logger.error(`❌`, fakeToken.type, fakeToken.key, `was not found in store "${store.config.name}"; returned a counterfeit token.`);
+		const fakeToken = mint(familyToken, key, COUNTERFEIT);
+		store.logger.warn(`💣`, `key`, stringKey, `was used to mint a counterfeit token for`, familyToken.type, `"${familyToken.key}"`);
 		return fakeToken;
 	}
-	const newStateToken = initFamilyMemberInStore(store, familyToken, key);
-	const target = newest(store);
-	if (newStateToken.family) {
-		if (isRootStore(target)) switch (newStateToken.type) {
-			case `atom`:
-			case `mutable_atom`:
-				store.on.atomCreation.next(newStateToken);
-				break;
-			case `writable_pure_selector`:
-			case `readonly_pure_selector`:
-			case `writable_held_selector`:
-			case `readonly_held_selector`:
-				store.on.selectorCreation.next(newStateToken);
-				break;
+	if (willCreate) {
+		stateToken = initFamilyMemberInStore(store, familyToken, key);
+		const target = newest(store);
+		if (stateToken.family) {
+			if (isRootStore(target)) switch (stateToken.type) {
+				case `atom`:
+				case `mutable_atom`:
+					store.on.atomCreation.next(stateToken);
+					break;
+				case `writable_pure_selector`:
+				case `readonly_pure_selector`:
+				case `writable_held_selector`:
+				case `readonly_held_selector`:
+					store.on.selectorCreation.next(stateToken);
+					break;
+			}
+			else if (isChildStore(target) && target.on.transactionApplying.state === null) target.transactionMeta.update.subEvents.push({
+				type: `state_creation`,
+				token: stateToken,
+				timestamp: Date.now()
+			});
 		}
-		else if (isChildStore(target) && target.on.transactionApplying.state === null) target.transactionMeta.update.subEvents.push({
-			type: `state_creation`,
-			token: newStateToken,
-			timestamp: Date.now()
-		});
-	}
-	if (molecule) target.moleculeData.set(stringKey, familyToken.key);
-	return newStateToken;
+		if (molecule) target.moleculeData.set(stringKey, familyToken.key);
+	} else stateToken = mint(familyToken, key);
+	return stateToken;
 }
 
 //#endregion
 //#region src/internal/set-state/operate-on-store.ts
-function operateOnStore(store, ownOp, ...params) {
+const OWN_OP = Symbol(`OWN_OP`);
+const JOIN_OP = Symbol(`JOIN_OP`);
+function operateOnStore(store, opMode, ...params) {
 	let existingToken;
 	let brandNewToken;
 	let token;
@@ -1383,12 +1418,12 @@ function operateOnStore(store, ownOp, ...params) {
 	if (params.length === 2) {
 		token = params[0];
 		value = params[1];
-		if (token.family) {
+		if (`family` in token) {
 			family = getFamilyOfToken(store, token);
 			key = parseJson(token.family.subKey);
 			existingToken = seekInStore(store, family, key);
 			if (!existingToken) {
-				brandNewToken = mintInStore(store, family, key);
+				brandNewToken = mintInStore(store, family, key, MUST_CREATE);
 				token = brandNewToken;
 			} else token = existingToken;
 		}
@@ -1398,13 +1433,13 @@ function operateOnStore(store, ownOp, ...params) {
 		value = params[2];
 		existingToken = seekInStore(store, family, key);
 		if (!existingToken) {
-			brandNewToken = mintInStore(store, family, key);
+			brandNewToken = mintInStore(store, family, key, MUST_CREATE);
 			token = brandNewToken;
 		} else token = existingToken;
 	}
 	const action = value === RESET_STATE ? `reset` : `set`;
 	let target;
-	if (ownOp) {
+	if (opMode === OWN_OP) {
 		const result = openOperation(store, token);
 		const rejected = typeof result === `number`;
 		if (rejected) {
@@ -1412,7 +1447,7 @@ function operateOnStore(store, ownOp, ...params) {
 			const unsubscribe = store.on.operationClose.subscribe(`waiting to ${action} "${token.key}" at T-${rejectionTime}`, function waitUntilOperationCloseToSetState() {
 				unsubscribe();
 				store.logger.info(`🟢`, token.type, token.key, `resuming deferred`, action, `from T-${rejectionTime}`);
-				operateOnStore(store, ownOp, token, value);
+				operateOnStore(store, opMode, token, value);
 			});
 			return;
 		}
@@ -1421,7 +1456,7 @@ function operateOnStore(store, ownOp, ...params) {
 	if (`counterfeit` in token && `family` in token) {
 		const subKey = token.family.subKey;
 		const disposal = store.disposalTraces.buffer.find((item) => item?.key === subKey);
-		store.logger.error(`❌`, token.type, token.key, `could not be`, action, `because it was not found in the store "${store.config.name}".`, disposal ? `This state was previously disposed:\n${disposal.trace}` : `No previous disposal trace was found.`);
+		store.logger.error(`❌`, token.type, token.key, `could not be`, action, `because key`, subKey, `is not allocated.`, disposal ? `this key was previously disposed:${disposal.trace}` : `(no previous disposal trace found)`);
 		return;
 	}
 	const state = withdraw(target, token);
@@ -1430,7 +1465,7 @@ function operateOnStore(store, ownOp, ...params) {
 	else protoUpdate = setAtomOrSelector(target, state, value);
 	const isNewlyCreated = Boolean(brandNewToken);
 	dispatchOrDeferStateUpdate(target, state, protoUpdate, isNewlyCreated);
-	if (ownOp) closeOperation(target);
+	if (opMode === OWN_OP) closeOperation(target);
 }
 
 //#endregion
@@ -1492,25 +1527,26 @@ function registerSelector(store, selectorType, selectorKey, covered) {
 	return {
 		get: (...params) => {
 			const target = newest(store);
-			let dependency;
-			if (params.length === 2) {
-				const [family, key] = params;
-				dependency = findInStore(store, family, key);
-			} else [dependency] = params;
-			const dependencyState = withdraw(store, dependency);
-			const dependencyValue = readOrComputeValue(store, dependencyState);
-			const dependencyKey = dependency.key;
-			store.logger.info(`🔌`, selectorType, selectorKey, `registers dependency ( "${dependencyKey}" =`, dependencyValue, `)`);
+			const { token, familyToken, subKey } = reduceReference(store, ...params);
+			let dependencyValue;
+			if (`counterfeit` in token && familyToken && subKey) {
+				const dependencyFamily = withdraw(store, familyToken);
+				dependencyValue = getFallback(store, token, dependencyFamily, subKey);
+			} else {
+				const dependency = withdraw(store, token);
+				dependencyValue = readOrComputeValue(store, dependency);
+			}
+			store.logger.info(`🔌`, selectorType, selectorKey, `registers dependency ( "${token.key}" =`, dependencyValue, `)`);
 			target.selectorGraph.set({
-				upstreamSelectorKey: dependencyKey,
+				upstreamSelectorKey: token.key,
 				downstreamSelectorKey: selectorKey
-			}, { source: dependency.key });
-			updateSelectorAtoms(store, selectorType, selectorKey, dependency, covered);
+			}, { source: token.key });
+			updateSelectorAtoms(store, selectorType, selectorKey, token, covered);
 			return dependencyValue;
 		},
 		set: ((...params) => {
 			const target = newest(store);
-			operateOnStore(target, false, ...params);
+			operateOnStore(target, JOIN_OP, ...params);
 		}),
 		find: ((...args) => findInStore(store, ...args)),
 		json: (token) => getJsonToken(store, token)
@@ -1818,7 +1854,7 @@ function createReadonlyPureSelectorFamily(store, options, internalRoles) {
 		type
 	};
 	const existing = store.families.get(familyKey);
-	if (existing) store.logger.error(`❗`, type, familyKey, `Overwriting an existing ${prettyPrintTokenType(existing)} "${existing.key}" in store "${store.config.name}". You can safely ignore this warning if it is due to hot module replacement.`);
+	if (existing) store.logger.error(`❗`, type, familyKey, `Overwriting an existing ${PRETTY_TOKEN_TYPES[existing.type]} "${existing.key}" in store "${store.config.name}". You can safely ignore this warning if it is due to hot module replacement.`);
 	const subject = new Subject();
 	const familyFunction = (key) => {
 		const subKey = stringifyJson(key);
@@ -1864,7 +1900,7 @@ function createRegularAtomFamily(store, options, internalRoles) {
 		type: `atom_family`
 	};
 	const existing = store.families.get(options.key);
-	if (existing) store.logger.error(`❗`, `atom_family`, options.key, `Overwriting an existing ${prettyPrintTokenType(existing)} "${existing.key}" in store "${store.config.name}". You can safely ignore this warning if it is due to hot module replacement.`);
+	if (existing) store.logger.error(`❗`, `atom_family`, options.key, `Overwriting an existing ${PRETTY_TOKEN_TYPES[existing.type]} "${existing.key}" in store "${store.config.name}". You can safely ignore this warning if it is due to hot module replacement.`);
 	const subject = new Subject();
 	const familyFunction = (key) => {
 		const subKey = stringifyJson(key);
@@ -1889,12 +1925,13 @@ function createRegularAtomFamily(store, options, internalRoles) {
 		return token;
 	};
 	const atomFamily$1 = Object.assign(familyFunction, familyToken, {
+		default: options.default,
 		subject,
 		install: (s) => createRegularAtomFamily(s, options),
 		internalRoles
 	});
 	store.families.set(options.key, atomFamily$1);
-	store.defaults.set(options.key, options.default);
+	if (options.default instanceof Function === false) store.defaults.set(options.key, options.default);
 	return familyToken;
 }
 
@@ -1908,7 +1945,7 @@ function createReadonlyHeldSelectorFamily(store, options, internalRoles) {
 		type
 	};
 	const existing = store.families.get(familyKey);
-	if (existing) store.logger.error(`❗`, type, familyKey, `Overwriting an existing ${prettyPrintTokenType(existing)} "${existing.key}" in store "${store.config.name}". You can safely ignore this warning if it is due to hot module replacement.`);
+	if (existing) store.logger.error(`❗`, type, familyKey, `Overwriting an existing ${PRETTY_TOKEN_TYPES[existing.type]} "${existing.key}" in store "${store.config.name}". You can safely ignore this warning if it is due to hot module replacement.`);
 	const subject = new Subject();
 	const familyFunction = (key) => {
 		const subKey = stringifyJson(key);
@@ -1950,7 +1987,7 @@ function createWritableHeldSelectorFamily(store, options, internalRoles) {
 		type
 	};
 	const existing = store.families.get(familyKey);
-	if (existing) store.logger.error(`❗`, type, familyKey, `Overwriting an existing ${prettyPrintTokenType(existing)} "${existing.key}" in store "${store.config.name}". You can safely ignore this warning if it is due to hot module replacement.`);
+	if (existing) store.logger.error(`❗`, type, familyKey, `Overwriting an existing ${PRETTY_TOKEN_TYPES[existing.type]} "${existing.key}" in store "${store.config.name}". You can safely ignore this warning if it is due to hot module replacement.`);
 	const subject = new Subject();
 	const familyFunction = (key) => {
 		const subKey = stringifyJson(key);
@@ -1993,7 +2030,7 @@ function createWritablePureSelectorFamily(store, options, internalRoles) {
 		type
 	};
 	const existing = store.families.get(familyKey);
-	if (existing) store.logger.error(`❗`, type, familyKey, `Overwriting an existing ${prettyPrintTokenType(existing)} "${existing.key}" in store "${store.config.name}". You can safely ignore this warning if it is due to hot module replacement.`);
+	if (existing) store.logger.error(`❗`, type, familyKey, `Overwriting an existing ${PRETTY_TOKEN_TYPES[existing.type]} "${existing.key}" in store "${store.config.name}". You can safely ignore this warning if it is due to hot module replacement.`);
 	const subject = new Subject();
 	const familyFunction = (key) => {
 		const subKey = stringifyJson(key);
@@ -2071,6 +2108,7 @@ function seekInStore(store, token, key) {
 //#endregion
 //#region src/internal/families/find-in-store.ts
 function findInStore(store, familyToken, key) {
+	withdraw(store, familyToken);
 	const existingStateToken = seekInStore(store, familyToken, key);
 	if (existingStateToken) return existingStateToken;
 	const newStateToken = mintInStore(store, familyToken, key);
@@ -2109,37 +2147,58 @@ function disposeFromStore(store, ...params) {
 }
 
 //#endregion
-//#region src/internal/get-state/get-from-store.ts
-function getFromStore(store, ...params) {
+//#region src/internal/get-state/reduce-reference.ts
+function reduceReference(store, ...params) {
+	let existingToken;
+	let brandNewToken;
+	let familyToken;
+	let subKey;
 	let token;
-	let family;
-	let key;
-	if (params.length === 1) token = params[0];
-	else {
-		family = params[0];
-		key = params[1];
-		token = findInStore(store, family, key);
-	}
-	if (`counterfeit` in token && `family` in token) {
-		family = store.families.get(token.family.key);
-		const subKey = token.family.subKey;
-		const disposal = store.disposalTraces.buffer.find((item) => item?.key === subKey);
-		store.logger.error(`❌`, token.type, token.key, `could not be retrieved because it was not found in the store "${store.config.name}".`, disposal ? `This state was previously disposed:\n${disposal.trace}` : `No previous disposal trace was found.`);
-		switch (family.type) {
-			case `atom_family`:
-			case `mutable_atom_family`: return store.defaults.get(family.key);
-			case `readonly_pure_selector_family`:
-			case `writable_pure_selector_family`:
-			case `readonly_held_selector_family`:
-			case `writable_held_selector_family`: {
-				if (store.defaults.has(family.key)) return store.defaults.get(token.family.key);
-				const defaultValue = withdraw(store, family).default(subKey);
-				store.defaults.set(family.key, defaultValue);
-				return defaultValue;
-			}
+	if (params.length === 1) {
+		token = params[0];
+		if (`family` in token) {
+			familyToken = getFamilyOfToken(store, token);
+			withdraw(store, familyToken);
+			subKey = parseJson(token.family.subKey);
+			existingToken = seekInStore(store, familyToken, subKey);
+			if (`counterfeit` in token) return {
+				token,
+				familyToken,
+				subKey,
+				isNew: false
+			};
+			if (!existingToken) {
+				brandNewToken = mintInStore(store, familyToken, subKey, MUST_CREATE);
+				token = brandNewToken;
+			} else token = existingToken;
 		}
+	} else {
+		familyToken = params[0];
+		subKey = params[1];
+		existingToken = seekInStore(store, familyToken, subKey);
+		if (!existingToken) {
+			brandNewToken = mintInStore(store, familyToken, subKey, MUST_CREATE);
+			token = brandNewToken;
+		} else token = existingToken;
+	}
+	return {
+		token,
+		familyToken,
+		subKey,
+		isNew: Boolean(brandNewToken)
+	};
+}
+
+//#endregion
+//#region src/internal/get-state/get-from-store.ts
+function getFromStore(store, ...params) {
+	const { token, familyToken, subKey } = reduceReference(store, ...params);
+	if (`counterfeit` in token && familyToken && subKey) {
+		const family = withdraw(store, familyToken);
+		return getFallback(store, token, family, subKey);
 	}
-	return readOrComputeValue(store, withdraw(store, token));
+	const state = withdraw(store, token);
+	return readOrComputeValue(store, state);
 }
 
 //#endregion
@@ -2168,6 +2227,7 @@ function subscribeToState(store, token, key, handleUpdate) {
 			});
 		} else handleUpdate(update);
 	}
+	reduceReference(store, token);
 	const state = withdraw(store, token);
 	store.logger.info(`👀`, state.type, state.key, `Adding subscription "${key}"`);
 	const isSelector = state.type === `writable_pure_selector` || state.type === `readonly_pure_selector`;
@@ -2470,7 +2530,7 @@ function createMutableAtomFamily(store, options, internalRoles) {
 		type: `mutable_atom_family`
 	};
 	const existing = store.families.get(options.key);
-	if (existing) store.logger.error(`❗`, `mutable_atom_family`, options.key, `Overwriting an existing ${prettyPrintTokenType(existing)} "${existing.key}" in store "${store.config.name}". You can safely ignore this warning if it is due to hot module replacement.`);
+	if (existing) store.logger.error(`❗`, `mutable_atom_family`, options.key, `Overwriting an existing ${PRETTY_TOKEN_TYPES[existing.type]} "${existing.key}" in store "${store.config.name}". You can safely ignore this warning if it is due to hot module replacement.`);
 	const subject = new Subject();
 	const familyFunction = (key) => {
 		const subKey = stringifyJson(key);
@@ -2494,6 +2554,7 @@ function createMutableAtomFamily(store, options, internalRoles) {
 		return token;
 	};
 	const atomFamily$1 = Object.assign(familyFunction, familyToken, {
+		class: options.class,
 		subject,
 		install: (s) => createMutableAtomFamily(s, options),
 		internalRoles
@@ -2530,7 +2591,7 @@ const getJsonToken = (store, mutableAtomToken) => {
 			type: `writable_pure_selector_family`
 		};
 		const family = withdraw(target, jsonFamilyToken);
-		const subKey = JSON.parse(mutableAtomToken.family.subKey);
+		const subKey = parseJson(mutableAtomToken.family.subKey);
 		const jsonToken = findInStore(store, family, subKey);
 		return jsonToken;
 	}
@@ -2760,10 +2821,9 @@ function disposeAtom(store, atomToken) {
 	else {
 		atom.cleanup?.();
 		const lastValue = store.valueMap.get(atom.key);
-		const atomFamily$1 = withdraw(store, {
-			key: family.key,
-			type: `atom_family`
-		});
+		const familyToken = getFamilyOfToken(store, atomToken);
+		const atomFamily$1 = withdraw(store, familyToken);
+		const subject = atomFamily$1.subject;
 		const disposal = {
 			type: `state_disposal`,
 			subType: `atom`,
@@ -2771,7 +2831,7 @@ function disposeAtom(store, atomToken) {
 			value: lastValue,
 			timestamp: Date.now()
 		};
-		atomFamily$1.subject.next(disposal);
+		subject.next(disposal);
 		const isChild = isChildStore(target);
 		target.atoms.delete(key);
 		target.valueMap.delete(key);
@@ -2802,6 +2862,12 @@ function hasRole(atom, role) {
 	return atom.internalRoles.includes(role);
 }
 
+//#endregion
+//#region src/internal/capitalize.ts
+function capitalize(string) {
+	return string[0].toUpperCase() + string.slice(1);
+}
+
 //#endregion
 //#region src/internal/install-into-store.ts
 /**
@@ -3359,6 +3425,7 @@ function createTimeline(store, options, data) {
 	return token;
 }
 function addAtomToTimeline(store, atomToken, tl) {
+	reduceReference(store, atomToken);
 	let maybeAtom = withdraw(store, atomToken);
 	if (maybeAtom.type === `mutable_atom`) {
 		const updateToken = getUpdateToken(maybeAtom);
@@ -3569,5 +3636,5 @@ const timeTravel = (store, action, token) => {
 };
 
 //#endregion
-export { CircularBuffer, FAMILY_MEMBER_TOKEN_TYPES, FamilyTracker, Future, IMPLICIT, INTERNAL_ROLES, Join, Junction, LazyMap, NotFoundError, RESET_STATE, StatefulSubject, Store, Subject, TRANSACTION_PHASES, Tracker, abortTransaction, actUponStore, allocateIntoStore, applyTransaction, arbitrary, assignTransactionToContinuity, become, buildTransaction, capitalize, claimWithinStore, clearStore, closeOperation, counterfeit, createJoin, createMutableAtom, createMutableAtomFamily, createReadonlyHeldSelector, createReadonlyPureSelector, createReadonlyPureSelectorFamily, createRegularAtom, createRegularAtomFamily, createSelectorFamily, createStandaloneSelector, createTimeline, createTransaction, createWritableHeldSelector, createWritablePureSelector, createWritablePureSelectorFamily, deallocateFromStore, deposit, disposeAtom, disposeFromStore, disposeSelector, editRelationsInStore, evictCachedValue, evictDownstreamFromAtom, evictDownstreamFromSelector, findInStore, findRelationsInStore, fuseWithinStore, getContinuityKey, getEnvironmentData, getEpochNumberOfAction, getEpochNumberOfContinuity, getFromStore, getInternalRelationsFromStore, getJoin, getJsonFamily, getJsonToken, getSelectorDependencyKeys, getTrace, getUpdateFamily, getUpdateToken, hasRole, ingestAtomUpdate, ingestCreationEvent, ingestDisposalEvent, ingestMoleculeCreationEvent, ingestMoleculeDisposalEvent, ingestMoleculeTransferEvent, ingestSelectorUpdate, ingestTransactionUpdate, initFamilyMemberInStore, installIntoStore, isAtomKey, isChildStore, isDone, isReadonlySelectorKey, isReservedIntrospectionKey, isRootStore, isSelectorKey, isStateKey, isTransceiver, makeRootMoleculeInStore, markDone, newest, openOperation, prettyPrintTokenType, readFromCache, readOrComputeValue, recallState, registerSelector, resetAtomOrSelector, resetInStore, seekInStore, setAtomOrSelector, setEpochNumberOfAction, setEpochNumberOfContinuity, setIntoStore, subscribeInStore, subscribeToRootDependency, subscribeToState, subscribeToTimeline, subscribeToTransaction, timeTravel, traceRootSelectorAtoms, updateSelectorAtoms, withdraw, writeToCache };
+export { COUNTERFEIT, CircularBuffer, FAMILY_MEMBER_TOKEN_TYPES, FamilyTracker, Future, IMPLICIT, INTERNAL_ROLES, Join, Junction, LazyMap, NotFoundError, RESET_STATE, StatefulSubject, Store, Subject, TRANSACTION_PHASES, Tracker, abortTransaction, actUponStore, allocateIntoStore, applyTransaction, arbitrary, assignTransactionToContinuity, become, buildTransaction, capitalize, claimWithinStore, clearStore, closeOperation, createJoin, createMutableAtom, createMutableAtomFamily, createReadonlyHeldSelector, createReadonlyPureSelector, createReadonlyPureSelectorFamily, createRegularAtom, createRegularAtomFamily, createSelectorFamily, createStandaloneSelector, createTimeline, createTransaction, createWritableHeldSelector, createWritablePureSelector, createWritablePureSelectorFamily, deallocateFromStore, deposit, disposeAtom, disposeFromStore, disposeSelector, editRelationsInStore, evictCachedValue, evictDownstreamFromAtom, evictDownstreamFromSelector, findInStore, findRelationsInStore, fuseWithinStore, getContinuityKey, getEnvironmentData, getEpochNumberOfAction, getEpochNumberOfContinuity, getFromStore, getInternalRelationsFromStore, getJoin, getJsonFamily, getJsonToken, getSelectorDependencyKeys, getTrace, getUpdateFamily, getUpdateToken, hasRole, ingestAtomUpdate, ingestCreationEvent, ingestDisposalEvent, ingestMoleculeCreationEvent, ingestMoleculeDisposalEvent, ingestMoleculeTransferEvent, ingestSelectorUpdate, ingestTransactionUpdate, initFamilyMemberInStore, installIntoStore, isAtomKey, isChildStore, isDone, isReadonlySelectorKey, isReservedIntrospectionKey, isRootStore, isSelectorKey, isStateKey, isTransceiver, makeRootMoleculeInStore, markDone, mint, newest, openOperation, readFromCache, readOrComputeValue, recallState, registerSelector, resetAtomOrSelector, resetInStore, seekInStore, setAtomOrSelector, setEpochNumberOfAction, setEpochNumberOfContinuity, setIntoStore, subscribeInStore, subscribeToRootDependency, subscribeToState, subscribeToTimeline, subscribeToTransaction, timeTravel, traceRootSelectorAtoms, updateSelectorAtoms, withdraw, writeToCache };
 //# sourceMappingURL=index.js.map