atom.io 0.32.4 → 0.33.1

package/dist/transceivers/set-rtx/index.js

@@ -0,0 +1,204 @@
+import { Subject } from "atom.io/internal";
+import { stringifyJson } from "atom.io/json";
+
+//#region src/transceivers/set-rtx/set-rtx.ts
+var SetRTX = class SetRTX extends Set {
+	mode = `record`;
+	subject = new Subject();
+	cacheLimit = 0;
+	cache = [];
+	cacheIdx = -1;
+	cacheUpdateNumber = -1;
+	constructor(values, cacheLimit = 0) {
+		super(values);
+		if (values instanceof SetRTX) {
+			this.parent = values;
+			this.cacheUpdateNumber = values.cacheUpdateNumber;
+		}
+		if (cacheLimit) {
+			this.cacheLimit = cacheLimit;
+			this.cache = new Array(cacheLimit);
+			this.subscribe(`auto cache`, (update) => {
+				this.cacheIdx++;
+				this.cacheIdx %= this.cacheLimit;
+				this.cache[this.cacheIdx] = update;
+			});
+		}
+	}
+	toJSON() {
+		return {
+			members: [...this],
+			cache: this.cache,
+			cacheLimit: this.cacheLimit,
+			cacheIdx: this.cacheIdx,
+			cacheUpdateNumber: this.cacheUpdateNumber
+		};
+	}
+	static fromJSON(json) {
+		const set = new SetRTX(json.members, json.cacheLimit);
+		set.cache = json.cache;
+		set.cacheIdx = json.cacheIdx;
+		set.cacheUpdateNumber = json.cacheUpdateNumber;
+		return set;
+	}
+	add(value) {
+		const result = super.add(value);
+		if (this.mode === `record`) {
+			this.cacheUpdateNumber++;
+			this.emit(`add:${stringifyJson(value)}`);
+		}
+		return result;
+	}
+	clear() {
+		const capturedContents = this.mode === `record` ? [...this] : null;
+		super.clear();
+		if (capturedContents) {
+			this.cacheUpdateNumber++;
+			this.emit(`clear:${JSON.stringify(capturedContents)}`);
+		}
+	}
+	delete(value) {
+		const result = super.delete(value);
+		if (this.mode === `record`) {
+			this.cacheUpdateNumber++;
+			this.emit(`del:${stringifyJson(value)}`);
+		}
+		return result;
+	}
+	parent = null;
+	child = null;
+	transactionUpdates = null;
+	transaction(run) {
+		this.mode = `transaction`;
+		this.transactionUpdates = [];
+		this.child = new SetRTX(this);
+		const unsubscribe = this.child._subscribe(`transaction`, (update) => {
+			this.transactionUpdates?.push(update);
+		});
+		try {
+			const shouldCommit = run(this.child);
+			if (shouldCommit) {
+				for (const update of this.transactionUpdates) this.doStep(update);
+				this.cacheUpdateNumber++;
+				this.emit(`tx:${this.transactionUpdates.join(`;`)}`);
+			}
+		} catch (thrown) {
+			console.warn(`Did not apply transaction to SetRTX; this error was thrown:`, thrown);
+			throw thrown;
+		} finally {
+			unsubscribe();
+			this.child = null;
+			this.transactionUpdates = null;
+			this.mode = `record`;
+		}
+	}
+	_subscribe(key, fn) {
+		return this.subject.subscribe(key, fn);
+	}
+	subscribe(key, fn) {
+		return this.subject.subscribe(key, (update) => {
+			fn(`${this.cacheUpdateNumber}=${update}`);
+		});
+	}
+	emit(update) {
+		this.subject.next(update);
+	}
+	doStep(update) {
+		const typeValueBreak = update.indexOf(`:`);
+		const type = update.substring(0, typeValueBreak);
+		const value = update.substring(typeValueBreak + 1);
+		switch (type) {
+			case `add`:
+				this.add(JSON.parse(value));
+				break;
+			case `clear`:
+				this.clear();
+				break;
+			case `del`:
+				this.delete(JSON.parse(value));
+				break;
+			case `tx`: for (const subUpdate of value.split(`;`)) this.doStep(subUpdate);
+		}
+	}
+	getUpdateNumber(update) {
+		const breakpoint = update.indexOf(`=`);
+		return Number(update.substring(0, breakpoint));
+	}
+	do(update) {
+		const breakpoint = update.indexOf(`=`);
+		const updateNumber = Number(update.substring(0, breakpoint));
+		const eventOffset = updateNumber - this.cacheUpdateNumber;
+		const isFuture = eventOffset > 0;
+		if (isFuture) {
+			if (eventOffset === 1) {
+				this.mode = `playback`;
+				const innerUpdate = update.substring(breakpoint + 1);
+				this.doStep(innerUpdate);
+				this.mode = `record`;
+				this.cacheUpdateNumber = updateNumber;
+				return null;
+			}
+			return this.cacheUpdateNumber + 1;
+		}
+		if (Math.abs(eventOffset) < this.cacheLimit) {
+			const eventIdx = this.cacheIdx + eventOffset;
+			const cachedUpdate = this.cache[eventIdx];
+			if (cachedUpdate === update) return null;
+			this.mode = `playback`;
+			let done = false;
+			while (!done) {
+				this.cacheIdx %= this.cacheLimit;
+				const u = this.cache[this.cacheIdx];
+				this.cacheIdx--;
+				if (!u) return `OUT_OF_RANGE`;
+				this.undo(u);
+				done = this.cacheIdx === eventIdx - 1;
+			}
+			const innerUpdate = update.substring(breakpoint + 1);
+			this.doStep(innerUpdate);
+			this.mode = `record`;
+			this.cacheUpdateNumber = updateNumber;
+			return null;
+		}
+		return `OUT_OF_RANGE`;
+	}
+	undoStep(update) {
+		const breakpoint = update.indexOf(`:`);
+		const type = update.substring(0, breakpoint);
+		const value = update.substring(breakpoint + 1);
+		switch (type) {
+			case `add`:
+				this.delete(JSON.parse(value));
+				break;
+			case `del`:
+				this.add(JSON.parse(value));
+				break;
+			case `clear`: {
+				const values = JSON.parse(value);
+				for (const v of values) this.add(v);
+				break;
+			}
+			case `tx`: {
+				const updates = value.split(`;`);
+				for (let i = updates.length - 1; i >= 0; i--) this.undoStep(updates[i]);
+			}
+		}
+	}
+	undo(update) {
+		const breakpoint = update.indexOf(`=`);
+		const updateNumber = Number(update.substring(0, breakpoint));
+		if (updateNumber === this.cacheUpdateNumber) {
+			this.mode = `playback`;
+			const innerUpdate = update.substring(breakpoint + 1);
+			this.undoStep(innerUpdate);
+			this.mode = `record`;
+			this.cacheUpdateNumber--;
+			return null;
+		}
+		return this.cacheUpdateNumber;
+	}
+};
+
+//#endregion
+export { SetRTX };
+//# sourceMappingURL=index.js.map

package/dist/transceivers/set-rtx/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["values?: Iterable<P>","json: SetRTXJson<P>","value: P","run: (child: SetRTX<P>) => boolean","key: string","fn: (update: SetUpdate) => void","fn: (update: NumberedSetUpdate) => void","update: SetUpdate","update: NumberedSetUpdate"],"sources":["../../../src/transceivers/set-rtx/set-rtx.ts"],"sourcesContent":["import type { Lineage, Transceiver, TransceiverMode } from \"atom.io/internal\"\nimport { Subject } from \"atom.io/internal\"\nimport type { Json, primitive } from \"atom.io/json\"\nimport { stringifyJson } from \"atom.io/json\"\n\nexport type SetUpdateType = `add` | `clear` | `del` | `tx`\nexport type SetUpdate = `${SetUpdateType}:${string}`\nexport type NumberedSetUpdate = `${number}=${SetUpdate}`\n\nexport interface SetRTXJson<P extends primitive> extends Json.Object {\n\tmembers: P[]\n\tcache: (NumberedSetUpdate | null)[]\n\tcacheLimit: number\n\tcacheIdx: number\n\tcacheUpdateNumber: number\n}\nexport class SetRTX<P extends primitive>\n\textends Set<P>\n\timplements Transceiver<NumberedSetUpdate>, Lineage\n{\n\tpublic mode: TransceiverMode = `record`\n\tpublic readonly subject: Subject<SetUpdate> = new Subject<SetUpdate>()\n\tpublic cacheLimit = 0\n\tpublic cache: (NumberedSetUpdate | null)[] = []\n\tpublic cacheIdx = -1\n\tpublic cacheUpdateNumber = -1\n\n\tpublic constructor(values?: Iterable<P>, cacheLimit = 0) {\n\t\tsuper(values)\n\t\tif (values instanceof SetRTX) {\n\t\t\tthis.parent = values\n\t\t\tthis.cacheUpdateNumber = values.cacheUpdateNumber\n\t\t}\n\t\tif (cacheLimit) {\n\t\t\tthis.cacheLimit = cacheLimit\n\t\t\tthis.cache = new Array(cacheLimit)\n\t\t\tthis.subscribe(`auto cache`, (update) => {\n\t\t\t\tthis.cacheIdx++\n\t\t\t\tthis.cacheIdx %= this.cacheLimit\n\t\t\t\tthis.cache[this.cacheIdx] = update\n\t\t\t})\n\t\t}\n\t}\n\n\tpublic toJSON(): SetRTXJson<P> {\n\t\treturn {\n\t\t\tmembers: [...this],\n\t\t\tcache: this.cache,\n\t\t\tcacheLimit: this.cacheLimit,\n\t\t\tcacheIdx: this.cacheIdx,\n\t\t\tcacheUpdateNumber: this.cacheUpdateNumber,\n\t\t}\n\t}\n\n\tpublic static fromJSON<P extends primitive>(json: SetRTXJson<P>): SetRTX<P> {\n\t\tconst set = new SetRTX<P>(json.members, json.cacheLimit)\n\t\tset.cache = json.cache\n\t\tset.cacheIdx = json.cacheIdx\n\t\tset.cacheUpdateNumber = json.cacheUpdateNumber\n\t\treturn set\n\t}\n\n\tpublic add(value: P): this {\n\t\tconst result = super.add(value)\n\t\tif (this.mode === `record`) {\n\t\t\tthis.cacheUpdateNumber++\n\t\t\tthis.emit(`add:${stringifyJson<P>(value)}`)\n\t\t}\n\t\treturn result\n\t}\n\n\tpublic clear(): void {\n\t\tconst capturedContents = this.mode === `record` ? [...this] : null\n\t\tsuper.clear()\n\t\tif (capturedContents) {\n\t\t\tthis.cacheUpdateNumber++\n\t\t\tthis.emit(`clear:${JSON.stringify(capturedContents)}`)\n\t\t}\n\t}\n\n\tpublic delete(value: P): boolean {\n\t\tconst result = super.delete(value)\n\t\tif (this.mode === `record`) {\n\t\t\tthis.cacheUpdateNumber++\n\t\t\tthis.emit(`del:${stringifyJson<P>(value)}`)\n\t\t}\n\t\treturn result\n\t}\n\n\tpublic readonly parent: SetRTX<P> | null = null\n\tpublic child: SetRTX<P> | null = null\n\tpublic transactionUpdates: SetUpdate[] | null = null\n\tpublic transaction(run: (child: SetRTX<P>) => boolean): void {\n\t\tthis.mode = `transaction`\n\t\tthis.transactionUpdates = []\n\t\tthis.child = new SetRTX(this)\n\t\tconst unsubscribe = this.child._subscribe(`transaction`, (update) => {\n\t\t\tthis.transactionUpdates?.push(update)\n\t\t})\n\t\ttry {\n\t\t\tconst shouldCommit = run(this.child)\n\t\t\tif (shouldCommit) {\n\t\t\t\tfor (const update of this.transactionUpdates) {\n\t\t\t\t\tthis.doStep(update)\n\t\t\t\t}\n\t\t\t\tthis.cacheUpdateNumber++\n\t\t\t\tthis.emit(`tx:${this.transactionUpdates.join(`;`)}`)\n\t\t\t}\n\t\t} catch (thrown) {\n\t\t\t/* eslint-disable-next-line no-console */\n\t\t\tconsole.warn(\n\t\t\t\t`Did not apply transaction to SetRTX; this error was thrown:`,\n\t\t\t\tthrown,\n\t\t\t)\n\t\t\tthrow thrown\n\t\t} finally {\n\t\t\tunsubscribe()\n\t\t\tthis.child = null\n\t\t\tthis.transactionUpdates = null\n\t\t\tthis.mode = `record`\n\t\t}\n\t}\n\n\tprotected _subscribe(\n\t\tkey: string,\n\t\tfn: (update: SetUpdate) => void,\n\t): () => void {\n\t\treturn this.subject.subscribe(key, fn)\n\t}\n\tpublic subscribe(\n\t\tkey: string,\n\t\tfn: (update: NumberedSetUpdate) => void,\n\t): () => void {\n\t\treturn this.subject.subscribe(key, (update) => {\n\t\t\tfn(`${this.cacheUpdateNumber}=${update}`)\n\t\t})\n\t}\n\n\tpublic emit(update: SetUpdate): void {\n\t\tthis.subject.next(update)\n\t}\n\n\tprivate doStep(update: SetUpdate): void {\n\t\tconst typeValueBreak = update.indexOf(`:`)\n\t\tconst type = update.substring(0, typeValueBreak) as SetUpdateType\n\t\tconst value = update.substring(typeValueBreak + 1)\n\t\tswitch (type) {\n\t\t\tcase `add`:\n\t\t\t\tthis.add(JSON.parse(value))\n\t\t\t\tbreak\n\t\t\tcase `clear`:\n\t\t\t\tthis.clear()\n\t\t\t\tbreak\n\t\t\tcase `del`:\n\t\t\t\tthis.delete(JSON.parse(value))\n\t\t\t\tbreak\n\t\t\tcase `tx`:\n\t\t\t\tfor (const subUpdate of value.split(`;`)) {\n\t\t\t\t\tthis.doStep(subUpdate as SetUpdate)\n\t\t\t\t}\n\t\t}\n\t}\n\n\tpublic getUpdateNumber(update: NumberedSetUpdate): number {\n\t\tconst breakpoint = update.indexOf(`=`)\n\t\treturn Number(update.substring(0, breakpoint))\n\t}\n\n\tpublic do(update: NumberedSetUpdate): number | `OUT_OF_RANGE` | null {\n\t\tconst breakpoint = update.indexOf(`=`)\n\t\tconst updateNumber = Number(update.substring(0, breakpoint))\n\t\tconst eventOffset = updateNumber - this.cacheUpdateNumber\n\t\tconst isFuture = eventOffset > 0\n\t\tif (isFuture) {\n\t\t\tif (eventOffset === 1) {\n\t\t\t\tthis.mode = `playback`\n\t\t\t\tconst innerUpdate = update.substring(breakpoint + 1) as SetUpdate\n\t\t\t\tthis.doStep(innerUpdate)\n\t\t\t\tthis.mode = `record`\n\t\t\t\tthis.cacheUpdateNumber = updateNumber\n\t\t\t\treturn null\n\t\t\t}\n\t\t\treturn this.cacheUpdateNumber + 1\n\t\t}\n\t\tif (Math.abs(eventOffset) < this.cacheLimit) {\n\t\t\tconst eventIdx = this.cacheIdx + eventOffset\n\t\t\tconst cachedUpdate = this.cache[eventIdx]\n\t\t\tif (cachedUpdate === update) {\n\t\t\t\treturn null\n\t\t\t}\n\t\t\tthis.mode = `playback`\n\t\t\tlet done = false\n\t\t\twhile (!done) {\n\t\t\t\tthis.cacheIdx %= this.cacheLimit\n\t\t\t\tconst u = this.cache[this.cacheIdx]\n\t\t\t\tthis.cacheIdx--\n\t\t\t\tif (!u) {\n\t\t\t\t\treturn `OUT_OF_RANGE`\n\t\t\t\t}\n\t\t\t\tthis.undo(u)\n\t\t\t\tdone = this.cacheIdx === eventIdx - 1\n\t\t\t}\n\t\t\tconst innerUpdate = update.substring(breakpoint + 1) as SetUpdate\n\t\t\tthis.doStep(innerUpdate)\n\t\t\tthis.mode = `record`\n\t\t\tthis.cacheUpdateNumber = updateNumber\n\t\t\treturn null\n\t\t}\n\t\treturn `OUT_OF_RANGE`\n\t}\n\n\tpublic undoStep(update: SetUpdate): void {\n\t\tconst breakpoint = update.indexOf(`:`)\n\t\tconst type = update.substring(0, breakpoint) as SetUpdateType\n\t\tconst value = update.substring(breakpoint + 1)\n\t\tswitch (type) {\n\t\t\tcase `add`:\n\t\t\t\tthis.delete(JSON.parse(value))\n\t\t\t\tbreak\n\t\t\tcase `del`:\n\t\t\t\tthis.add(JSON.parse(value))\n\t\t\t\tbreak\n\t\t\tcase `clear`: {\n\t\t\t\tconst values = JSON.parse(value) as P[]\n\t\t\t\tfor (const v of values) this.add(v)\n\t\t\t\tbreak\n\t\t\t}\n\t\t\tcase `tx`: {\n\t\t\t\tconst updates = value.split(`;`) as SetUpdate[]\n\t\t\t\tfor (let i = updates.length - 1; i >= 0; i--) {\n\t\t\t\t\tthis.undoStep(updates[i])\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\tpublic undo(update: NumberedSetUpdate): number | null {\n\t\tconst breakpoint = update.indexOf(`=`)\n\t\tconst updateNumber = Number(update.substring(0, breakpoint))\n\t\tif (updateNumber === this.cacheUpdateNumber) {\n\t\t\tthis.mode = `playback`\n\t\t\tconst innerUpdate = update.substring(breakpoint + 1) as SetUpdate\n\t\t\tthis.undoStep(innerUpdate)\n\t\t\tthis.mode = `record`\n\t\t\tthis.cacheUpdateNumber--\n\t\t\treturn null\n\t\t}\n\t\treturn this.cacheUpdateNumber\n\t}\n}\n"],"mappings":";;;;AAgBA,IAAa,SAAb,MAAa,eACJ,IAET;CACC,AAAO,QAAyB;CAChC,AAAgB,UAA8B,IAAI;CAClD,AAAO,aAAa;CACpB,AAAO,QAAsC,CAAE;CAC/C,AAAO,WAAW;CAClB,AAAO,oBAAoB;CAE3B,AAAO,YAAYA,QAAsB,aAAa,GAAG;AACxD,QAAM,OAAO;AACb,MAAI,kBAAkB,QAAQ;AAC7B,QAAK,SAAS;AACd,QAAK,oBAAoB,OAAO;EAChC;AACD,MAAI,YAAY;AACf,QAAK,aAAa;AAClB,QAAK,QAAQ,IAAI,MAAM;AACvB,QAAK,WAAW,aAAa,CAAC,WAAW;AACxC,SAAK;AACL,SAAK,YAAY,KAAK;AACtB,SAAK,MAAM,KAAK,YAAY;GAC5B,EAAC;EACF;CACD;CAED,AAAO,SAAwB;AAC9B,SAAO;GACN,SAAS,CAAC,GAAG,IAAK;GAClB,OAAO,KAAK;GACZ,YAAY,KAAK;GACjB,UAAU,KAAK;GACf,mBAAmB,KAAK;EACxB;CACD;CAED,OAAc,SAA8BC,MAAgC;EAC3E,MAAM,MAAM,IAAI,OAAU,KAAK,SAAS,KAAK;AAC7C,MAAI,QAAQ,KAAK;AACjB,MAAI,WAAW,KAAK;AACpB,MAAI,oBAAoB,KAAK;AAC7B,SAAO;CACP;CAED,AAAO,IAAIC,OAAgB;EAC1B,MAAM,SAAS,MAAM,IAAI,MAAM;AAC/B,MAAI,KAAK,UAAU,SAAS;AAC3B,QAAK;AACL,QAAK,MAAM,MAAM,cAAiB,MAAM,CAAC,EAAE;EAC3C;AACD,SAAO;CACP;CAED,AAAO,QAAc;EACpB,MAAM,mBAAmB,KAAK,UAAU,UAAU,CAAC,GAAG,IAAK,IAAG;AAC9D,QAAM,OAAO;AACb,MAAI,kBAAkB;AACrB,QAAK;AACL,QAAK,MAAM,QAAQ,KAAK,UAAU,iBAAiB,CAAC,EAAE;EACtD;CACD;CAED,AAAO,OAAOA,OAAmB;EAChC,MAAM,SAAS,MAAM,OAAO,MAAM;AAClC,MAAI,KAAK,UAAU,SAAS;AAC3B,QAAK;AACL,QAAK,MAAM,MAAM,cAAiB,MAAM,CAAC,EAAE;EAC3C;AACD,SAAO;CACP;CAED,AAAgB,SAA2B;CAC3C,AAAO,QAA0B;CACjC,AAAO,qBAAyC;CAChD,AAAO,YAAYC,KAA0C;AAC5D,OAAK,QAAQ;AACb,OAAK,qBAAqB,CAAE;AAC5B,OAAK,QAAQ,IAAI,OAAO;EACxB,MAAM,cAAc,KAAK,MAAM,YAAY,cAAc,CAAC,WAAW;AACpE,QAAK,oBAAoB,KAAK,OAAO;EACrC,EAAC;AACF,MAAI;GACH,MAAM,eAAe,IAAI,KAAK,MAAM;AACpC,OAAI,cAAc;AACjB,SAAK,MAAM,UAAU,KAAK,mBACzB,MAAK,OAAO,OAAO;AAEpB,SAAK;AACL,SAAK,MAAM,KAAK,KAAK,mBAAmB,MAAM,GAAG,CAAC,EAAE;GACpD;EACD,SAAQ,QAAQ;AAEhB,WAAQ,MACN,8DACD,OACA;AACD,SAAM;EACN,UAAS;AACT,gBAAa;AACb,QAAK,QAAQ;AACb,QAAK,qBAAqB;AAC1B,QAAK,QAAQ;EACb;CACD;CAED,AAAU,WACTC,KACAC,IACa;AACb,SAAO,KAAK,QAAQ,UAAU,KAAK,GAAG;CACtC;CACD,AAAO,UACND,KACAE,IACa;AACb,SAAO,KAAK,QAAQ,UAAU,KAAK,CAAC,WAAW;AAC9C,OAAI,EAAE,KAAK,kBAAkB,GAAG,OAAO,EAAE;EACzC,EAAC;CACF;CAED,AAAO,KAAKC,QAAyB;AACpC,OAAK,QAAQ,KAAK,OAAO;CACzB;CAED,AAAQ,OAAOA,QAAyB;EACvC,MAAM,iBAAiB,OAAO,SAAS,GAAG;EAC1C,MAAM,OAAO,OAAO,UAAU,GAAG,eAAe;EAChD,MAAM,QAAQ,OAAO,UAAU,iBAAiB,EAAE;AAClD,UAAQ,MAAR;GACC,MAAM;AACL,SAAK,IAAI,KAAK,MAAM,MAAM,CAAC;AAC3B;GACD,MAAM;AACL,SAAK,OAAO;AACZ;GACD,MAAM;AACL,SAAK,OAAO,KAAK,MAAM,MAAM,CAAC;AAC9B;GACD,MAAM,IACL,MAAK,MAAM,aAAa,MAAM,OAAO,GAAG,CACvC,MAAK,OAAO,UAAuB;EAErC;CACD;CAED,AAAO,gBAAgBC,QAAmC;EACzD,MAAM,aAAa,OAAO,SAAS,GAAG;AACtC,SAAO,OAAO,OAAO,UAAU,GAAG,WAAW,CAAC;CAC9C;CAED,AAAO,GAAGA,QAA2D;EACpE,MAAM,aAAa,OAAO,SAAS,GAAG;EACtC,MAAM,eAAe,OAAO,OAAO,UAAU,GAAG,WAAW,CAAC;EAC5D,MAAM,cAAc,eAAe,KAAK;EACxC,MAAM,WAAW,cAAc;AAC/B,MAAI,UAAU;AACb,OAAI,gBAAgB,GAAG;AACtB,SAAK,QAAQ;IACb,MAAM,cAAc,OAAO,UAAU,aAAa,EAAE;AACpD,SAAK,OAAO,YAAY;AACxB,SAAK,QAAQ;AACb,SAAK,oBAAoB;AACzB,WAAO;GACP;AACD,UAAO,KAAK,oBAAoB;EAChC;AACD,MAAI,KAAK,IAAI,YAAY,GAAG,KAAK,YAAY;GAC5C,MAAM,WAAW,KAAK,WAAW;GACjC,MAAM,eAAe,KAAK,MAAM;AAChC,OAAI,iBAAiB,OACpB,QAAO;AAER,QAAK,QAAQ;GACb,IAAI,OAAO;AACX,WAAQ,MAAM;AACb,SAAK,YAAY,KAAK;IACtB,MAAM,IAAI,KAAK,MAAM,KAAK;AAC1B,SAAK;AACL,SAAK,EACJ,SAAQ;AAET,SAAK,KAAK,EAAE;AACZ,WAAO,KAAK,aAAa,WAAW;GACpC;GACD,MAAM,cAAc,OAAO,UAAU,aAAa,EAAE;AACpD,QAAK,OAAO,YAAY;AACxB,QAAK,QAAQ;AACb,QAAK,oBAAoB;AACzB,UAAO;EACP;AACD,UAAQ;CACR;CAED,AAAO,SAASD,QAAyB;EACxC,MAAM,aAAa,OAAO,SAAS,GAAG;EACtC,MAAM,OAAO,OAAO,UAAU,GAAG,WAAW;EAC5C,MAAM,QAAQ,OAAO,UAAU,aAAa,EAAE;AAC9C,UAAQ,MAAR;GACC,MAAM;AACL,SAAK,OAAO,KAAK,MAAM,MAAM,CAAC;AAC9B;GACD,MAAM;AACL,SAAK,IAAI,KAAK,MAAM,MAAM,CAAC;AAC3B;GACD,MAAM,QAAQ;IACb,MAAM,SAAS,KAAK,MAAM,MAAM;AAChC,SAAK,MAAM,KAAK,OAAQ,MAAK,IAAI,EAAE;AACnC;GACA;GACD,MAAM,KAAK;IACV,MAAM,UAAU,MAAM,OAAO,GAAG;AAChC,SAAK,IAAI,IAAI,QAAQ,SAAS,GAAG,KAAK,GAAG,IACxC,MAAK,SAAS,QAAQ,GAAG;GAE1B;EACD;CACD;CAED,AAAO,KAAKC,QAA0C;EACrD,MAAM,aAAa,OAAO,SAAS,GAAG;EACtC,MAAM,eAAe,OAAO,OAAO,UAAU,GAAG,WAAW,CAAC;AAC5D,MAAI,iBAAiB,KAAK,mBAAmB;AAC5C,QAAK,QAAQ;GACb,MAAM,cAAc,OAAO,UAAU,aAAa,EAAE;AACpD,QAAK,SAAS,YAAY;AAC1B,QAAK,QAAQ;AACb,QAAK;AACL,UAAO;EACP;AACD,SAAO,KAAK;CACZ;AACD"}

package/dist/web/index.d.ts

@@ -0,0 +1,15 @@
+import { AtomEffect } from "atom.io";
+
+//#region src/web/persist-sync.d.ts
+type StringInterface<T> = {
+  stringify: (t: T) => string;
+  parse: (s: string) => T;
+};
+declare const persistSync: <T>(storage: Storage, {
+  stringify,
+  parse
+}: StringInterface<T>, key: string) => AtomEffect<T>;
+
+//#endregion
+export { StringInterface, persistSync };
+//# sourceMappingURL=index.d.ts.map

package/dist/web/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":["t: T","s: string","storage: Storage","key: string"],"sources":["../../src/web/persist-sync.ts"],"sourcesContent":null,"mappings":";;;KAEY;iBACI;EADhB,KAAY,EAAA,CAAA,CAAA,EAAA,MAAA,EAAA,GAEW,CAFX;CAAA;AACI,cAIH,WAJG,EAAA,CAAA,CAAA,CAAA,CAAA,OAAA,EAML,OANK,EAAA;EAAA,SAAA;EAAA;AAAA,CAAA,EAOQ,eAPR,CAOwB,CAPxB,CAAA,EAAA,GAAA,EAAA,MAAA,EAAA,GASZ,UATY,CASD,CATC,CAAA"}

package/dist/web/index.js

@@ -0,0 +1,16 @@
+//#region src/web/persist-sync.ts
+const persistSync = (storage, { stringify, parse }, key) => ({ setSelf, onSet }) => {
+	const savedValue = storage.getItem(key);
+	if (savedValue != null) setSelf(parse(savedValue));
+	onSet(({ newValue }) => {
+		if (newValue == null) {
+			storage.removeItem(key);
+			return;
+		}
+		storage.setItem(key, stringify(newValue));
+	});
+};
+
+//#endregion
+export { persistSync };
+//# sourceMappingURL=index.js.map

package/dist/web/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["storage: Storage","key: string"],"sources":["../../src/web/persist-sync.ts"],"sourcesContent":["import type { AtomEffect } from \"atom.io\"\n\nexport type StringInterface<T> = {\n\tstringify: (t: T) => string\n\tparse: (s: string) => T\n}\n\nexport const persistSync =\n\t<T>(\n\t\tstorage: Storage,\n\t\t{ stringify, parse }: StringInterface<T>,\n\t\tkey: string,\n\t): AtomEffect<T> =>\n\t({ setSelf, onSet }) => {\n\t\tconst savedValue = storage.getItem(key)\n\t\tif (savedValue != null) setSelf(parse(savedValue))\n\n\t\tonSet(({ newValue }) => {\n\t\t\tif (newValue == null) {\n\t\t\t\tstorage.removeItem(key)\n\t\t\t\treturn\n\t\t\t}\n\t\t\tstorage.setItem(key, stringify(newValue))\n\t\t})\n\t}\n"],"mappings":";AAOA,MAAa,cACZ,CACCA,SACA,EAAE,WAAW,OAA2B,EACxCC,QAED,CAAC,EAAE,SAAS,OAAO,KAAK;CACvB,MAAM,aAAa,QAAQ,QAAQ,IAAI;AACvC,KAAI,cAAc,KAAM,SAAQ,MAAM,WAAW,CAAC;AAElD,OAAM,CAAC,EAAE,UAAU,KAAK;AACvB,MAAI,YAAY,MAAM;AACrB,WAAQ,WAAW,IAAI;AACvB;EACA;AACD,UAAQ,QAAQ,KAAK,UAAU,SAAS,CAAC;CACzC,EAAC;AACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "atom.io",
-  "version": "0.32.4",
+  "version": "0.33.1",
   "description": "Composable and testable reactive data library.",
   "homepage": "https://atom.io.fyi",
   "sideEffects": false,
@@ -19,28 +19,36 @@
     "@floating-ui/react": ">=0.25.0",
     "@floating-ui/react-dom": ">=2.0.0",
     "@testing-library/react": ">=14.0.0",
+    "@typescript-eslint/parser": ">=9.0.0",
     "eslint": ">=9.0.0",
+    "happy-dom": ">=17.4.4",
     "motion": ">=11.0.0",
     "react": "^18.0.0 || ^19.0.0",
     "socket.io": ">=4.0.0",
     "socket.io-client": ">=4.0.0"
   },
   "peerDependenciesMeta": {
-    "@testing-library/react": {
+    "@floating-ui/react": {
       "optional": true
     },
-    "react": {
+    "@floating-ui/react-dom": {
       "optional": true
     },
-    "@floating-ui/react": {
+    "@testing-library/react": {
       "optional": true
     },
-    "@floating-ui/react-dom": {
+    "@typescript-eslint/parser": {
+      "optional": true
+    },
+    "react": {
       "optional": true
     },
     "eslint": {
       "optional": true
     },
+    "happy-dom": {
+      "optional": true
+    },
     "motion": {
       "optional": true
     },
@@ -52,191 +60,132 @@
     }
   },
   "devDependencies": {
+    "@eslint/core": "0.14.0",
     "@testing-library/react": "16.3.0",
+    "@types/bun": "npm:bun-types@1.2.11",
     "@types/eslint": "9.6.1",
     "@types/estree": "1.0.6",
     "@types/http-proxy": "1.17.16",
     "@types/npmlog": "7.0.0",
-    "@types/react": "19.1.0",
+    "@types/react": "19.1.2",
     "@types/tmp": "0.2.6",
-    "@typescript-eslint/parser": "8.29.1",
-    "@typescript-eslint/rule-tester": "8.29.1",
-    "@typescript-eslint/utils": "8.29.1",
-    "@vitest/coverage-v8": "3.1.1",
-    "@vitest/ui": "3.1.1",
-    "bun-types": "1.2.9",
+    "@typescript-eslint/parser": "8.31.1",
+    "@typescript-eslint/rule-tester": "8.31.1",
+    "@typescript-eslint/utils": "8.31.1",
+    "@vitest/coverage-v8": "3.1.2",
+    "@vitest/ui": "3.1.2",
     "concurrently": "9.1.2",
-    "drizzle-kit": "0.30.6",
-    "drizzle-orm": "0.41.0",
-    "eslint": "9.24.0",
-    "happy-dom": "17.4.4",
+    "drizzle-kit": "0.31.0",
+    "drizzle-orm": "0.43.1",
+    "eslint": "9.25.1",
+    "happy-dom": "17.4.6",
     "http-proxy": "1.18.1",
-    "motion": "12.6.3",
+    "motion": "12.9.4",
     "npmlog": "7.0.1",
     "nyc": "17.1.0",
     "postgres": "3.4.5",
     "preact": "10.26.5",
     "react": "19.1.0",
     "react-dom": "19.1.0",
-    "react-router-dom": "7.5.0",
-    "recoverage": "0.1.7",
+    "react-router-dom": "7.5.3",
+    "recoverage": "0.1.9",
     "socket.io": "4.8.1",
     "socket.io-client": "4.8.1",
     "tmp": "0.2.3",
-    "tsup": "8.4.0",
-    "tsx": "4.19.3",
+    "tsdown": "0.10.2",
+    "tsx": "4.19.4",
     "typescript": "5.8.3",
-    "vite": "6.2.6",
+    "vite": "6.3.4",
     "vite-tsconfig-paths": "5.1.4",
-    "vitest": "3.1.1",
-    "zod": "3.24.2",
-    "break-check": "0.6.10"
+    "vitest": "3.1.2",
+    "zod": "3.24.3",
+    "break-check": "0.6.13"
   },
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "module": "./dist/main/index.js",
   "files": [
     "dist",
     "src",
-    "data/dist",
-    "data/package.json",
     "data/src",
-    "eslint-plugin/dist",
-    "eslint-plugin/package.json",
     "eslint-plugin/src",
-    "internal/dist",
-    "internal/package.json",
     "internal/src",
-    "introspection/dist",
-    "introspection/package.json",
     "introspection/src",
-    "json/dist",
-    "json/package.json",
     "json/src",
-    "react/dist",
-    "react/package.json",
     "react/src",
-    "react-devtools/dist",
-    "react-devtools/package.json",
     "react-devtools/src",
-    "realtime/dist",
-    "realtime/package.json",
     "realtime/src",
-    "realtime-client/dist",
-    "realtime-client/package.json",
     "realtime-client/src",
-    "realtime-react/dist",
-    "realtime-react/package.json",
     "realtime-react/src",
-    "realtime-server/dist",
-    "realtime-server/package.json",
     "realtime-server/src",
-    "realtime-testing/dist",
-    "realtime-testing/package.json",
     "realtime-testing/src",
-    "transceivers/set-rtx/dist",
-    "transceivers/set-rtx/package.json",
     "transceivers/set-rtx/src",
-    "web/dist",
-    "web/package.json",
     "web/src"
   ],
   "exports": {
     "./package.json": "./package.json",
     ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "import": "./dist/main/index.js",
+      "types": "./dist/main/index.d.ts"
     },
-    "./data/package.json": "./data/package.json",
     "./data": {
-      "import": "./data/dist/index.js",
-      "types": "./data/dist/index.d.ts"
+      "import": "./dist/data/index.js",
+      "types": "./dist/data/index.d.ts"
     },
-    "./eslint-plugin/package.json": "./eslint-plugin/package.json",
     "./eslint-plugin": {
-      "import": "./eslint-plugin/dist/index.js",
-      "types": "./eslint-plugin/dist/index.d.ts"
+      "import": "./dist/eslint-plugin/index.js",
+      "types": "./dist/eslint-plugin/index.d.ts"
     },
-    "./internal/package.json": "./internal/package.json",
     "./internal": {
-      "import": "./internal/dist/index.js",
-      "types": "./internal/dist/index.d.ts"
+      "import": "./dist/internal/index.js",
+      "types": "./dist/internal/index.d.ts"
     },
-    "./introspection/package.json": "./introspection/package.json",
     "./introspection": {
-      "import": "./introspection/dist/index.js",
-      "types": "./introspection/dist/index.d.ts"
+      "import": "./dist/introspection/index.js",
+      "types": "./dist/introspection/index.d.ts"
     },
-    "./json/package.json": "./json/package.json",
     "./json": {
-      "import": "./json/dist/index.js",
-      "types": "./json/dist/index.d.ts"
+      "import": "./dist/json/index.js",
+      "types": "./dist/json/index.d.ts"
     },
-    "./react/package.json": "./react/package.json",
     "./react": {
-      "import": "./react/dist/index.js",
-      "types": "./react/dist/index.d.ts"
+      "import": "./dist/react/index.js",
+      "types": "./dist/react/index.d.ts"
     },
-    "./react-devtools/package.json": "./react-devtools/package.json",
     "./react-devtools": {
-      "import": "./react-devtools/dist/index.js",
-      "types": "./react-devtools/dist/index.d.ts"
+      "import": "./dist/react-devtools/index.js",
+      "types": "./dist/react-devtools/index.d.ts"
     },
-    "./realtime/package.json": "./realtime/package.json",
     "./realtime": {
-      "import": "./realtime/dist/index.js",
-      "types": "./realtime/dist/index.d.ts"
+      "import": "./dist/realtime/index.js",
+      "types": "./dist/realtime/index.d.ts"
     },
-    "./realtime-client/package.json": "./realtime-client/package.json",
     "./realtime-client": {
-      "import": "./realtime-client/dist/index.js",
-      "types": "./realtime-client/dist/index.d.ts"
+      "import": "./dist/realtime-client/index.js",
+      "types": "./dist/realtime-client/index.d.ts"
     },
-    "./realtime-react/package.json": "./realtime-react/package.json",
     "./realtime-react": {
-      "import": "./realtime-react/dist/index.js",
-      "types": "./realtime-react/dist/index.d.ts"
+      "import": "./dist/realtime-react/index.js",
+      "types": "./dist/realtime-react/index.d.ts"
     },
-    "./realtime-server/package.json": "./realtime-server/package.json",
     "./realtime-server": {
-      "import": "./realtime-server/dist/index.js",
-      "types": "./realtime-server/dist/index.d.ts"
+      "import": "./dist/realtime-server/index.js",
+      "types": "./dist/realtime-server/index.d.ts"
     },
-    "./realtime-testing/package.json": "./realtime-testing/package.json",
     "./realtime-testing": {
-      "import": "./realtime-testing/dist/index.js",
-      "types": "./realtime-testing/dist/index.d.ts"
+      "import": "./dist/realtime-testing/index.js",
+      "types": "./dist/realtime-testing/index.d.ts"
     },
-    "./transceivers/set-rtx/package.json": "./transceivers/set-rtx/package.json",
     "./transceivers/set-rtx": {
-      "import": "./transceivers/set-rtx/dist/index.js",
-      "types": "./transceivers/set-rtx/dist/index.d.ts"
+      "import": "./dist/transceivers/set-rtx/index.js",
+      "types": "./dist/transceivers/set-rtx/index.d.ts"
     },
-    "./web/package.json": "./web/package.json",
     "./web": {
-      "import": "./web/dist/index.js",
-      "types": "./web/dist/index.d.ts"
+      "import": "./dist/web/index.js",
+      "types": "./dist/web/index.d.ts"
     }
   },
   "scripts": {
     "manifest": "tsx __scripts__/manifest-build.node.ts",
-    "clean:build": "find . -type d -name 'dist' -not -path '*/node_modules/*' | xargs rm -rf",
-    "build": "bun run clean:build && concurrently \"bun:build:*\"",
-    "build:main": "tsup-node",
-    "build:types": "tsup-node --dts",
-    "build:data": "cd data && tsup-node",
-    "build:eslint-plugin": "cd eslint-plugin && tsup-node",
-    "build:internal": "cd internal && tsup-node",
-    "build:introspection": "cd introspection && tsup-node",
-    "build:json": "cd json && tsup-node",
-    "build:react": "cd react && tsup-node",
-    "build:react-devtools": "cd react-devtools && tsup-node",
-    "build:realtime": "cd realtime && tsup-node",
-    "build:realtime-client": "cd realtime-client && tsup-node",
-    "build:realtime-react": "cd realtime-react && tsup-node",
-    "build:realtime-server": "cd realtime-server && tsup-node",
-    "build:realtime-testing": "cd realtime-testing && tsup-node",
-    "build:transceivers:set-rtx": "cd transceivers/set-rtx && tsup-node",
-    "build:web": "cd web && tsup-node",
+    "build": "tsdown && bun ./__scripts__/build-sort.bun.ts",
     "lint:biome": "biome check -- .",
     "lint:eslint": "eslint -- .",
     "lint:types": "tsc --noEmit",

package/{eslint-plugin/src → src/eslint-plugin}/index.ts

@@ -4,9 +4,11 @@ import * as Rules from "./rules"
 
 export { Rules }
 
-export default {
+const plugin: ESLint.Plugin = {
 	rules: {
 		"explicit-state-types": Rules.explicitStateTypes as any,
 		"synchronous-selector-dependencies": Rules.synchronousSelectorDependencies,
 	},
 } satisfies ESLint.Plugin
+
+export default plugin

package/{eslint-plugin/src → src/eslint-plugin}/rules/explicit-state-types.ts

@@ -7,7 +7,12 @@ const createRule = ESLintUtils.RuleCreator(
 
 const STATE_FUNCTIONS = [`atom`, `atomFamily`, `selector`, `selectorFamily`]
 
-export const explicitStateTypes = createRule({
+export const explicitStateTypes: ESLintUtils.RuleModule<
+	`noTypeArgument`,
+	[],
+	unknown,
+	ESLintUtils.RuleListener
+> = createRule({
 	name: `explicit-state-types`,
 	meta: {
 		type: `problem`,

package/{eslint-plugin/src → src/eslint-plugin}/rules/synchronous-selector-dependencies.ts

@@ -1,10 +1,23 @@
 /* eslint-disable @typescript-eslint/switch-exhaustiveness-check */
+import type { RuleType } from "@eslint/core"
 import type { Rule } from "eslint"
 import type * as ESTree from "estree"
 
 import { walk } from "../walk"
 
-export const synchronousSelectorDependencies = {
+export const synchronousSelectorDependencies: {
+	meta: {
+		type: RuleType
+		docs: {
+			description: string
+			category: string
+			recommended: boolean
+			url: string
+		}
+		schema: never[]
+	}
+	create(context: Rule.RuleContext): Rule.NodeListener
+} = {
 	meta: {
 		type: `problem`,
 		docs: {

package/{internal/src → src/internal}/families/index.ts

@@ -1,7 +1,9 @@
 export * from "./create-atom-family"
 export * from "./create-readonly-selector-family"
+export * from "./create-readonly-selector-family"
 export * from "./create-regular-atom-family"
 export * from "./create-selector-family"
+export * from "./create-writable-selector-family"
 export * from "./dispose-from-store"
 export * from "./find-in-store"
 export * from "./init-family-member"

package/{internal/src → src/internal}/index.ts

@@ -30,6 +30,7 @@ export * from "./get-environment-data"
 export * from "./get-state"
 export * from "./get-trace"
 export * from "./ingest-updates"
+export * from "./install-into-store"
 export * from "./join"
 export * from "./junction"
 export * from "./keys"

package/{internal/src → src/internal}/junction.ts

@@ -83,8 +83,9 @@ export class Junction<
 	public readonly a: ASide
 	public readonly b: BSide
 	public readonly cardinality: `1:1` | `1:n` | `n:n`
-	public readonly relations = new Map<AType | BType, Set<AType> | Set<BType>>()
-	public readonly contents = new Map<string, Content>()
+	public readonly relations: Map<AType | BType, Set<AType> | Set<BType>> =
+		new Map()
+	public readonly contents: Map<string, Content> = new Map()
 
 	public isAType?: Refinement<string, AType> | null
 	public isBType?: Refinement<string, BType> | null

package/{internal/src → src/internal}/lazy-map.ts

@@ -1,5 +1,5 @@
 export class LazyMap<K, V> extends Map<K, V> {
-	public deleted = new Set<K>()
+	public deleted: Set<K> = new Set()
 	protected readonly source: Map<K, V>
 
 	public constructor(source: Map<K, V>) {