atom.io 0.40.9 → 0.40.10

package/dist/transceivers/o-list/index.d.ts

@@ -0,0 +1,77 @@
+import { Fn, Subject, Transceiver, TransceiverMode } from "atom.io/internal";
+import { primitive } from "atom.io/json";
+
+//#region src/transceivers/o-list/o-list.d.ts
+type ArrayUpdate<P extends primitive> = {
+  type: `copyWithin`;
+  target: number;
+  start: number;
+  end?: number;
+  prev: readonly P[];
+} | {
+  type: `extend`;
+  next: number;
+  prev: number;
+} | {
+  type: `fill`;
+  value: P;
+  start?: number;
+  end?: number;
+  prev: readonly P[];
+} | {
+  type: `pop` | `shift`;
+  value?: P;
+} | {
+  type: `push` | `unshift`;
+  items: readonly P[];
+} | {
+  type: `reverse`;
+} | {
+  type: `set`;
+  next: P;
+  prev?: P;
+  index: number;
+} | {
+  type: `sort`;
+  next: readonly P[];
+  prev: readonly P[];
+} | {
+  type: `splice`;
+  start: number;
+  deleteCount?: number;
+  items?: readonly P[];
+  deleted?: readonly P[];
+} | {
+  type: `truncate`;
+  length: number;
+  items: readonly P[];
+};
+type OListUpdateType = ArrayUpdate<any>[`type`];
+type ArrayMutationHandler = { [K in Exclude<OListUpdateType, `extend` | `set` | `truncate`>]: Fn };
+declare class OList<P extends primitive> extends Array<P> implements Transceiver<ReadonlyArray<P>, ArrayUpdate<P>, ReadonlyArray<P>>, ArrayMutationHandler {
+  mode: TransceiverMode;
+  readonly subject: Subject<ArrayUpdate<P>>;
+  readonly READONLY_VIEW: ReadonlyArray<P>;
+  constructor(arrayLength?: number);
+  constructor(...items: P[]);
+  toJSON(): ReadonlyArray<P>;
+  static fromJSON<P extends primitive>(json: ReadonlyArray<P>): OList<P>;
+  push(...items: P[]): number;
+  pop(): P | undefined;
+  shift(): P | undefined;
+  unshift(...items: P[]): number;
+  reverse(): this;
+  sort(compareFn?: (a: P, b: P) => number): this;
+  splice(start: number, deleteCount?: number): P[];
+  splice(start: number, deleteCount: number, ...items: P[]): P[];
+  copyWithin(target: number, start: number, end?: number): this;
+  subscribe(key: string, fn: (update: ArrayUpdate<P>) => void): () => void;
+  emit(update: ArrayUpdate<P>): void;
+  private doStep;
+  do(update: ArrayUpdate<P>): null;
+  undoStep(update: ArrayUpdate<P>): void;
+  undo(update: ArrayUpdate<P>): number | null;
+}
+//#endregion
+export { ArrayMutationHandler, ArrayUpdate, OList, OListUpdateType };
+//# sourceMappingURL=index.d.ts.map

package/dist/transceivers/o-list/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/transceivers/o-list/o-list.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/transceivers/o-list/index.js

@@ -0,0 +1,308 @@
+import { Subject } from "atom.io/internal";
+
+//#region src/transceivers/o-list/o-list.ts
+var OList = class OList extends Array {
+	mode = `record`;
+	subject = new Subject();
+	READONLY_VIEW = this;
+	constructor(...items) {
+		super(...items);
+		return new Proxy(this, { set: (target, prop, value, receiver) => {
+			if (typeof prop === `string` && !Number.isNaN(Number.parseInt(prop, 10))) {
+				const index = Number(prop);
+				let prev;
+				if (this.mode === `record`) prev = target[index];
+				target[index] = value;
+				if (prev) this.emit({
+					type: `set`,
+					index,
+					next: value,
+					prev
+				});
+				else if (this.mode === `record`) this.emit({
+					type: `set`,
+					index,
+					next: value
+				});
+				return true;
+			}
+			if (prop === `length`) {
+				if (this.mode === `record`) {
+					const prevLength = target.length;
+					if (prevLength === value) return true;
+					if (prevLength > value) {
+						const dropped = target.slice(value);
+						target.length = value;
+						this.emit({
+							type: `truncate`,
+							length: value,
+							items: dropped
+						});
+					} else {
+						target.length = value;
+						this.emit({
+							type: `extend`,
+							next: value,
+							prev: prevLength
+						});
+					}
+				} else target.length = value;
+				return true;
+			}
+			return Reflect.set(target, prop, value, receiver);
+		} });
+	}
+	toJSON() {
+		return [...this];
+	}
+	static fromJSON(json) {
+		return new OList(...json);
+	}
+	push(...items) {
+		let result;
+		if (this.mode === `record`) {
+			this.mode = `playback`;
+			result = super.push(...items);
+			this.mode = `record`;
+			this.emit({
+				type: `push`,
+				items
+			});
+		} else result = super.push(...items);
+		return result;
+	}
+	pop() {
+		let value;
+		if (this.mode === `record`) {
+			this.mode = `playback`;
+			value = super.pop();
+			if (value === void 0) this.emit({ type: `pop` });
+			else this.emit({
+				type: `pop`,
+				value
+			});
+			this.mode = `record`;
+		} else value = super.pop();
+		return value;
+	}
+	shift() {
+		let value;
+		if (this.mode === `record`) {
+			this.mode = `playback`;
+			value = super.shift();
+			if (value === void 0) this.emit({ type: `shift` });
+			else this.emit({
+				type: `shift`,
+				value
+			});
+			this.mode = `record`;
+		} else value = super.shift();
+		return value;
+	}
+	unshift(...items) {
+		let result;
+		if (this.mode === `record`) {
+			this.mode = `playback`;
+			result = super.unshift(...items);
+			this.emit({
+				type: `unshift`,
+				items
+			});
+			this.mode = `record`;
+		} else result = super.unshift(...items);
+		return result;
+	}
+	reverse() {
+		super.reverse();
+		if (this.mode === `record`) this.emit({ type: `reverse` });
+		return this;
+	}
+	sort(compareFn) {
+		if (this.mode === `record`) {
+			this.mode = `playback`;
+			const prev = [...this];
+			super.sort(compareFn);
+			const next = [...this];
+			this.emit({
+				type: `sort`,
+				next,
+				prev
+			});
+			this.mode = `record`;
+		}
+		return this;
+	}
+	splice(...params) {
+		const [start, deleteCount, ...items] = params;
+		const originalMode = this.mode;
+		if (originalMode === `record`) this.mode = `playback`;
+		const deleted = super.splice(...params);
+		if (originalMode === `record`) this.mode = `record`;
+		if (deleteCount === void 0) this.emit({
+			type: `splice`,
+			start,
+			items,
+			deleted,
+			deleteCount: deleted.length
+		});
+		else this.emit({
+			type: `splice`,
+			start,
+			items,
+			deleted,
+			deleteCount
+		});
+		return deleted;
+	}
+	copyWithin(target, start, end) {
+		const originalMode = this.mode;
+		let prev;
+		if (originalMode === `record`) {
+			prev = this.slice(target);
+			this.mode = `playback`;
+		}
+		super.copyWithin(target, start, end);
+		if (originalMode === `record`) this.mode = `record`;
+		if (prev) if (end === void 0) this.emit({
+			type: `copyWithin`,
+			prev,
+			target,
+			start
+		});
+		else this.emit({
+			type: `copyWithin`,
+			prev,
+			target,
+			start,
+			end
+		});
+		return this;
+	}
+	subscribe(key, fn) {
+		return this.subject.subscribe(key, fn);
+	}
+	emit(update) {
+		this.subject.next(update);
+	}
+	doStep(update) {
+		switch (update.type) {
+			case `copyWithin`:
+				this.copyWithin(update.target, update.start, update.end);
+				break;
+			case `extend`:
+				this.length = update.next;
+				break;
+			case `fill`:
+				this.fill(update.value, update.start, update.end);
+				break;
+			case `pop`:
+				this.pop();
+				break;
+			case `push`:
+				this.push(...update.items);
+				break;
+			case `reverse`:
+				this.reverse();
+				break;
+			case `shift`:
+				this.shift();
+				break;
+			case `sort`:
+				for (let i = 0; i < update.next.length; i++) this[i] = update.next[i];
+				this.length = update.next.length;
+				break;
+			case `splice`:
+				if (update.deleteCount !== void 0 && update.items) this.splice(update.start, update.deleteCount, ...update.items);
+				else this.splice(update.start);
+				break;
+			case `truncate`:
+				this.length = update.length;
+				break;
+			case `set`:
+				this[update.index] = update.next;
+				break;
+			case `unshift`:
+				this.unshift(...update.items);
+				break;
+		}
+	}
+	do(update) {
+		this.mode = `playback`;
+		this.doStep(update);
+		this.mode = `record`;
+		return null;
+	}
+	undoStep(update) {
+		switch (update.type) {
+			case `copyWithin`:
+				for (let i = 0; i < update.prev.length; i++) this[i + update.target] = update.prev[i];
+				break;
+			case `extend`:
+				this.length = update.prev;
+				break;
+			case `fill`:
+				{
+					const start = update.start ?? 0;
+					for (let i = 0; i < update.prev.length; i++) this[i + start] = update.prev[i];
+				}
+				break;
+			case `pop`:
+				if (update.value) this.push(update.value);
+				break;
+			case `push`:
+				{
+					let i = update.items.length - 1;
+					while (i >= 0) {
+						this.pop();
+						--i;
+					}
+				}
+				break;
+			case `reverse`:
+				this.reverse();
+				break;
+			case `shift`:
+				if (update.value) this.unshift(update.value);
+				break;
+			case `sort`:
+				for (let i = 0; i < update.prev.length; i++) this[i] = update.prev[i];
+				this.length = update.prev.length;
+				break;
+			case `set`:
+				if (update.prev) this[update.index] = update.prev;
+				else {
+					delete this[update.index];
+					const firstEmptyIndex = this.findIndex((_, i) => !Object.hasOwn(this, i));
+					if (firstEmptyIndex !== -1) this.length = firstEmptyIndex;
+				}
+				break;
+			case `splice`:
+				if (update.deleted) if (update.items) this.splice(update.start, update.items.length, ...update.deleted);
+				else this.splice(update.start, 0, ...update.deleted);
+				else if (update.items) this.splice(update.start, update.items.length);
+				break;
+			case `truncate`:
+				this.push(...update.items);
+				break;
+			case `unshift`:
+				{
+					let i = update.items.length - 1;
+					while (i >= 0) {
+						this.shift();
+						--i;
+					}
+				}
+				break;
+		}
+	}
+	undo(update) {
+		this.mode = `playback`;
+		this.undoStep(update);
+		this.mode = `record`;
+		return null;
+	}
+};
+
+//#endregion
+export { OList };
+//# sourceMappingURL=index.js.map

package/dist/transceivers/o-list/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["prev: P | undefined","result: number","value: P | undefined","prev: P[] | undefined"],"sources":["../../../src/transceivers/o-list/o-list.ts"],"sourcesContent":["import type { Fn, Transceiver, TransceiverMode } from \"atom.io/internal\"\nimport { Subject } from \"atom.io/internal\"\nimport type { primitive } from \"atom.io/json\"\n\ntype ArrayMutations = Exclude<keyof Array<any>, keyof ReadonlyArray<any>>\nexport type ArrayUpdate<P extends primitive> =\n\t| {\n\t\t\ttype: `copyWithin`\n\t\t\ttarget: number\n\t\t\tstart: number\n\t\t\tend?: number\n\t\t\tprev: readonly P[]\n\t  }\n\t| {\n\t\t\ttype: `extend`\n\t\t\tnext: number\n\t\t\tprev: number\n\t  }\n\t| {\n\t\t\ttype: `fill`\n\t\t\tvalue: P\n\t\t\tstart?: number\n\t\t\tend?: number\n\t\t\tprev: readonly P[]\n\t  }\n\t| {\n\t\t\ttype: `pop` | `shift`\n\t\t\tvalue?: P\n\t  }\n\t| {\n\t\t\ttype: `push` | `unshift`\n\t\t\titems: readonly P[]\n\t  }\n\t| {\n\t\t\ttype: `reverse`\n\t  }\n\t| {\n\t\t\ttype: `set`\n\t\t\tnext: P\n\t\t\tprev?: P\n\t\t\tindex: number\n\t  }\n\t| {\n\t\t\ttype: `sort`\n\t\t\tnext: readonly P[]\n\t\t\tprev: readonly P[]\n\t  }\n\t| {\n\t\t\ttype: `splice`\n\t\t\tstart: number\n\t\t\tdeleteCount?: number\n\t\t\titems?: readonly P[]\n\t\t\tdeleted?: readonly P[]\n\t  }\n\t| {\n\t\t\ttype: `truncate`\n\t\t\tlength: number\n\t\t\titems: readonly P[]\n\t  }\nexport type OListUpdateType = ArrayUpdate<any>[`type`]\ntrue satisfies ArrayMutations extends OListUpdateType\n\t? true\n\t: Exclude<ArrayMutations, OListUpdateType>\n\nexport type ArrayMutationHandler = {\n\t[K in Exclude<OListUpdateType, `extend` | `set` | `truncate`>]: Fn\n}\n\nexport class OList<P extends primitive>\n\textends Array<P>\n\timplements\n\t\tTransceiver<ReadonlyArray<P>, ArrayUpdate<P>, ReadonlyArray<P>>,\n\t\tArrayMutationHandler\n{\n\tpublic mode: TransceiverMode = `record`\n\tpublic readonly subject: Subject<ArrayUpdate<P>> = new Subject<\n\t\tArrayUpdate<P>\n\t>()\n\n\tpublic readonly READONLY_VIEW: ReadonlyArray<P> = this\n\n\tpublic constructor(arrayLength?: number)\n\tpublic constructor(...items: P[])\n\tpublic constructor(...items: P[]) {\n\t\tsuper(...items)\n\t\t// biome-ignore lint/correctness/noConstructorReturn: this is chill\n\t\treturn new Proxy(this, {\n\t\t\tset: (target, prop, value, receiver) => {\n\t\t\t\tif (\n\t\t\t\t\ttypeof prop === `string` &&\n\t\t\t\t\t!Number.isNaN(Number.parseInt(prop, 10))\n\t\t\t\t) {\n\t\t\t\t\tconst index = Number(prop)\n\t\t\t\t\tlet prev: P | undefined\n\t\t\t\t\tif (this.mode === `record`) {\n\t\t\t\t\t\tprev = target[index]\n\t\t\t\t\t}\n\t\t\t\t\ttarget[index] = value\n\t\t\t\t\tif (prev) {\n\t\t\t\t\t\tthis.emit({ type: `set`, index, next: value, prev })\n\t\t\t\t\t} else if (this.mode === `record`) {\n\t\t\t\t\t\tthis.emit({ type: `set`, index, next: value })\n\t\t\t\t\t}\n\t\t\t\t\treturn true\n\t\t\t\t}\n\t\t\t\tif (prop === `length`) {\n\t\t\t\t\tif (this.mode === `record`) {\n\t\t\t\t\t\tconst prevLength = target.length\n\t\t\t\t\t\tif (prevLength === value) return true\n\t\t\t\t\t\tif (prevLength > value) {\n\t\t\t\t\t\t\tconst dropped = target.slice(value)\n\t\t\t\t\t\t\ttarget.length = value\n\t\t\t\t\t\t\tthis.emit({ type: `truncate`, length: value, items: dropped })\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\ttarget.length = value\n\t\t\t\t\t\t\tthis.emit({ type: `extend`, next: value, prev: prevLength })\n\t\t\t\t\t\t}\n\t\t\t\t\t} else {\n\t\t\t\t\t\ttarget.length = value\n\t\t\t\t\t}\n\t\t\t\t\treturn true\n\t\t\t\t}\n\t\t\t\treturn Reflect.set(target, prop, value, receiver)\n\t\t\t},\n\t\t})\n\t}\n\n\tpublic toJSON(): ReadonlyArray<P> {\n\t\treturn [...this]\n\t}\n\n\tpublic static fromJSON<P extends primitive>(json: ReadonlyArray<P>): OList<P> {\n\t\treturn new OList<P>(...json)\n\t}\n\n\tpublic push(...items: P[]): number {\n\t\tlet result: number\n\t\tif (this.mode === `record`) {\n\t\t\tthis.mode = `playback`\n\t\t\tresult = super.push(...items)\n\t\t\tthis.mode = `record`\n\t\t\tthis.emit({ type: `push`, items })\n\t\t} else {\n\t\t\tresult = super.push(...items)\n\t\t}\n\t\treturn result\n\t}\n\tpublic pop(): P | undefined {\n\t\tlet value: P | undefined\n\t\tif (this.mode === `record`) {\n\t\t\tthis.mode = `playback`\n\t\t\tvalue = super.pop()\n\t\t\tif (value === undefined) {\n\t\t\t\tthis.emit({ type: `pop` })\n\t\t\t} else {\n\t\t\t\tthis.emit({ type: `pop`, value })\n\t\t\t}\n\t\t\tthis.mode = `record`\n\t\t} else {\n\t\t\tvalue = super.pop()\n\t\t}\n\t\treturn value\n\t}\n\tpublic shift(): P | undefined {\n\t\tlet value: P | undefined\n\t\tif (this.mode === `record`) {\n\t\t\tthis.mode = `playback`\n\t\t\tvalue = super.shift()\n\t\t\tif (value === undefined) {\n\t\t\t\tthis.emit({ type: `shift` })\n\t\t\t} else {\n\t\t\t\tthis.emit({ type: `shift`, value })\n\t\t\t}\n\t\t\tthis.mode = `record`\n\t\t} else {\n\t\t\tvalue = super.shift()\n\t\t}\n\t\treturn value\n\t}\n\tpublic unshift(...items: P[]): number {\n\t\tlet result: number\n\t\tif (this.mode === `record`) {\n\t\t\tthis.mode = `playback`\n\t\t\tresult = super.unshift(...items)\n\t\t\tthis.emit({ type: `unshift`, items })\n\t\t\tthis.mode = `record`\n\t\t} else {\n\t\t\tresult = super.unshift(...items)\n\t\t}\n\t\treturn result\n\t}\n\n\tpublic reverse(): this {\n\t\tsuper.reverse()\n\t\tif (this.mode === `record`) {\n\t\t\tthis.emit({ type: `reverse` })\n\t\t}\n\t\treturn this\n\t}\n\n\tpublic sort(compareFn?: (a: P, b: P) => number): this {\n\t\tif (this.mode === `record`) {\n\t\t\tthis.mode = `playback`\n\t\t\tconst prev = [...this]\n\t\t\tsuper.sort(compareFn)\n\t\t\tconst next = [...this]\n\t\t\tthis.emit({ type: `sort`, next, prev })\n\t\t\tthis.mode = `record`\n\t\t}\n\t\treturn this\n\t}\n\n\tpublic splice(start: number, deleteCount?: number): P[]\n\tpublic splice(start: number, deleteCount: number, ...items: P[]): P[]\n\tpublic splice(\n\t\t...params: [start: number, deleteCount?: number, ...items: P[]]\n\t): P[] {\n\t\tconst [start, deleteCount, ...items] = params\n\t\tconst originalMode = this.mode\n\t\tif (originalMode === `record`) this.mode = `playback`\n\t\tconst deleted = super.splice(...(params as [number, number, ...P[]]))\n\t\tif (originalMode === `record`) this.mode = `record`\n\t\tif (deleteCount === undefined) {\n\t\t\tthis.emit({\n\t\t\t\ttype: `splice`,\n\t\t\t\tstart,\n\t\t\t\titems,\n\t\t\t\tdeleted,\n\t\t\t\tdeleteCount: deleted.length,\n\t\t\t})\n\t\t} else {\n\t\t\tthis.emit({ type: `splice`, start, items, deleted, deleteCount })\n\t\t}\n\n\t\treturn deleted\n\t}\n\n\tpublic copyWithin(target: number, start: number, end?: number): this {\n\t\tconst originalMode = this.mode\n\t\tlet prev: P[] | undefined\n\t\tif (originalMode === `record`) {\n\t\t\tprev = this.slice(target)\n\t\t\tthis.mode = `playback`\n\t\t}\n\t\tsuper.copyWithin(target, start, end)\n\t\tif (originalMode === `record`) this.mode = `record`\n\t\tif (prev) {\n\t\t\tif (end === undefined) {\n\t\t\t\tthis.emit({ type: `copyWithin`, prev, target, start })\n\t\t\t} else {\n\t\t\t\tthis.emit({ type: `copyWithin`, prev, target, start, end })\n\t\t\t}\n\t\t}\n\t\treturn this\n\t}\n\n\tpublic subscribe(\n\t\tkey: string,\n\t\tfn: (update: ArrayUpdate<P>) => void,\n\t): () => void {\n\t\treturn this.subject.subscribe(key, fn)\n\t}\n\n\tpublic emit(update: ArrayUpdate<P>): void {\n\t\tthis.subject.next(update)\n\t}\n\n\tprivate doStep(update: ArrayUpdate<P>): void {\n\t\tconst type = update.type\n\t\tswitch (type) {\n\t\t\tcase `copyWithin`:\n\t\t\t\tthis.copyWithin(update.target, update.start, update.end)\n\t\t\t\tbreak\n\t\t\tcase `extend`:\n\t\t\t\tthis.length = update.next\n\t\t\t\tbreak\n\t\t\tcase `fill`:\n\t\t\t\tthis.fill(update.value, update.start, update.end)\n\t\t\t\tbreak\n\t\t\tcase `pop`:\n\t\t\t\tthis.pop()\n\t\t\t\tbreak\n\t\t\tcase `push`:\n\t\t\t\tthis.push(...update.items)\n\t\t\t\tbreak\n\t\t\tcase `reverse`:\n\t\t\t\tthis.reverse()\n\t\t\t\tbreak\n\t\t\tcase `shift`:\n\t\t\t\tthis.shift()\n\t\t\t\tbreak\n\t\t\tcase `sort`:\n\t\t\t\tfor (let i = 0; i < update.next.length; i++) {\n\t\t\t\t\tthis[i] = update.next[i]\n\t\t\t\t}\n\t\t\t\tthis.length = update.next.length\n\t\t\t\tbreak\n\t\t\tcase `splice`:\n\t\t\t\tif (update.deleteCount !== undefined && update.items) {\n\t\t\t\t\tthis.splice(update.start, update.deleteCount, ...update.items)\n\t\t\t\t} else {\n\t\t\t\t\tthis.splice(update.start)\n\t\t\t\t}\n\t\t\t\tbreak\n\t\t\tcase `truncate`:\n\t\t\t\tthis.length = update.length\n\t\t\t\tbreak\n\t\t\tcase `set`:\n\t\t\t\tthis[update.index] = update.next\n\t\t\t\tbreak\n\t\t\tcase `unshift`:\n\t\t\t\tthis.unshift(...update.items)\n\t\t\t\tbreak\n\t\t}\n\t}\n\n\tpublic do(update: ArrayUpdate<P>): null {\n\t\tthis.mode = `playback`\n\t\tthis.doStep(update)\n\t\tthis.mode = `record`\n\t\treturn null\n\t}\n\n\tpublic undoStep(update: ArrayUpdate<P>): void {\n\t\tswitch (update.type) {\n\t\t\tcase `copyWithin`:\n\t\t\t\tfor (let i = 0; i < update.prev.length; i++) {\n\t\t\t\t\tthis[i + update.target] = update.prev[i]\n\t\t\t\t}\n\t\t\t\tbreak\n\t\t\tcase `extend`:\n\t\t\t\tthis.length = update.prev\n\t\t\t\tbreak\n\t\t\tcase `fill`:\n\t\t\t\t{\n\t\t\t\t\tconst start = update.start ?? 0\n\t\t\t\t\tfor (let i = 0; i < update.prev.length; i++) {\n\t\t\t\t\t\tthis[i + start] = update.prev[i]\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tbreak\n\t\t\tcase `pop`:\n\t\t\t\tif (update.value) this.push(update.value)\n\t\t\t\tbreak\n\t\t\tcase `push`:\n\t\t\t\t{\n\t\t\t\t\tlet i = update.items.length - 1\n\t\t\t\t\twhile (i >= 0) {\n\t\t\t\t\t\tthis.pop()\n\t\t\t\t\t\t--i\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tbreak\n\t\t\tcase `reverse`:\n\t\t\t\tthis.reverse()\n\t\t\t\tbreak\n\t\t\tcase `shift`:\n\t\t\t\tif (update.value) this.unshift(update.value)\n\t\t\t\tbreak\n\t\t\tcase `sort`:\n\t\t\t\tfor (let i = 0; i < update.prev.length; i++) {\n\t\t\t\t\tthis[i] = update.prev[i]\n\t\t\t\t}\n\t\t\t\tthis.length = update.prev.length\n\t\t\t\tbreak\n\t\t\tcase `set`:\n\t\t\t\tif (update.prev) {\n\t\t\t\t\tthis[update.index] = update.prev\n\t\t\t\t} else {\n\t\t\t\t\t// eslint-disable-next-line @typescript-eslint/no-dynamic-delete\n\t\t\t\t\tdelete this[update.index]\n\t\t\t\t\tconst firstEmptyIndex = this.findIndex(\n\t\t\t\t\t\t(_, i) => !Object.hasOwn(this, i),\n\t\t\t\t\t)\n\t\t\t\t\tif (firstEmptyIndex !== -1) {\n\t\t\t\t\t\tthis.length = firstEmptyIndex\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tbreak\n\t\t\tcase `splice`:\n\t\t\t\tif (update.deleted) {\n\t\t\t\t\tif (update.items) {\n\t\t\t\t\t\tthis.splice(update.start, update.items.length, ...update.deleted)\n\t\t\t\t\t} else {\n\t\t\t\t\t\tthis.splice(update.start, 0, ...update.deleted)\n\t\t\t\t\t}\n\t\t\t\t} else if (update.items) {\n\t\t\t\t\tthis.splice(update.start, update.items.length)\n\t\t\t\t}\n\t\t\t\tbreak\n\t\t\tcase `truncate`:\n\t\t\t\tthis.push(...update.items)\n\t\t\t\tbreak\n\t\t\tcase `unshift`:\n\t\t\t\t{\n\t\t\t\t\tlet i = update.items.length - 1\n\t\t\t\t\twhile (i >= 0) {\n\t\t\t\t\t\tthis.shift()\n\t\t\t\t\t\t--i\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tbreak\n\t\t}\n\t}\n\n\tpublic undo(update: ArrayUpdate<P>): number | null {\n\t\tthis.mode = `playback`\n\t\tthis.undoStep(update)\n\t\tthis.mode = `record`\n\t\treturn null\n\t}\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "atom.io",
-  "version": "0.40.9",
+  "version": "0.40.10",
   "description": "Composable and testable reactive data library.",
   "homepage": "https://atom.io.fyi",
   "sideEffects": false,
@@ -65,7 +65,7 @@
     "@storybook/addon-onboarding": "9.1.5",
     "@storybook/react-vite": "9.1.5",
     "@testing-library/react": "16.3.0",
-    "@types/bun": "npm:bun-types@1.2.21",
+    "@types/bun": "npm:bun-types@1.2.22",
     "@types/eslint": "9.6.1",
     "@types/estree": "1.0.8",
     "@types/http-proxy": "1.17.16",
@@ -87,10 +87,10 @@
     "npmlog": "7.0.1",
     "nyc": "17.1.0",
     "postgres": "3.4.7",
-    "preact": "10.27.1",
+    "preact": "10.27.2",
     "react": "19.1.1",
     "react-dom": "19.1.1",
-    "react-router-dom": "7.9.0",
+    "react-router-dom": "7.9.1",
     "recoverage": "0.1.11",
     "socket.io": "4.8.1",
     "socket.io-client": "4.8.1",
@@ -166,6 +166,10 @@
       "import": "./dist/realtime-testing/index.js",
       "types": "./dist/realtime-testing/index.d.ts"
     },
+    "./transceivers/o-list": {
+      "import": "./dist/transceivers/o-list/index.js",
+      "types": "./dist/transceivers/o-list/index.d.ts"
+    },
     "./transceivers/set-rtx": {
       "import": "./dist/transceivers/set-rtx/index.js",
       "types": "./dist/transceivers/set-rtx/index.d.ts"

package/src/transceivers/o-list/index.ts

@@ -0,0 +1 @@
+export * from "./o-list"

package/src/transceivers/o-list/o-list.ts

@@ -0,0 +1,412 @@
+import type { Fn, Transceiver, TransceiverMode } from "atom.io/internal"
+import { Subject } from "atom.io/internal"
+import type { primitive } from "atom.io/json"
+
+type ArrayMutations = Exclude<keyof Array<any>, keyof ReadonlyArray<any>>
+export type ArrayUpdate<P extends primitive> =
+	| {
+			type: `copyWithin`
+			target: number
+			start: number
+			end?: number
+			prev: readonly P[]
+	  }
+	| {
+			type: `extend`
+			next: number
+			prev: number
+	  }
+	| {
+			type: `fill`
+			value: P
+			start?: number
+			end?: number
+			prev: readonly P[]
+	  }
+	| {
+			type: `pop` | `shift`
+			value?: P
+	  }
+	| {
+			type: `push` | `unshift`
+			items: readonly P[]
+	  }
+	| {
+			type: `reverse`
+	  }
+	| {
+			type: `set`
+			next: P
+			prev?: P
+			index: number
+	  }
+	| {
+			type: `sort`
+			next: readonly P[]
+			prev: readonly P[]
+	  }
+	| {
+			type: `splice`
+			start: number
+			deleteCount?: number
+			items?: readonly P[]
+			deleted?: readonly P[]
+	  }
+	| {
+			type: `truncate`
+			length: number
+			items: readonly P[]
+	  }
+export type OListUpdateType = ArrayUpdate<any>[`type`]
+true satisfies ArrayMutations extends OListUpdateType
+	? true
+	: Exclude<ArrayMutations, OListUpdateType>
+
+export type ArrayMutationHandler = {
+	[K in Exclude<OListUpdateType, `extend` | `set` | `truncate`>]: Fn
+}
+
+export class OList<P extends primitive>
+	extends Array<P>
+	implements
+		Transceiver<ReadonlyArray<P>, ArrayUpdate<P>, ReadonlyArray<P>>,
+		ArrayMutationHandler
+{
+	public mode: TransceiverMode = `record`
+	public readonly subject: Subject<ArrayUpdate<P>> = new Subject<
+		ArrayUpdate<P>
+	>()
+
+	public readonly READONLY_VIEW: ReadonlyArray<P> = this
+
+	public constructor(arrayLength?: number)
+	public constructor(...items: P[])
+	public constructor(...items: P[]) {
+		super(...items)
+		// biome-ignore lint/correctness/noConstructorReturn: this is chill
+		return new Proxy(this, {
+			set: (target, prop, value, receiver) => {
+				if (
+					typeof prop === `string` &&
+					!Number.isNaN(Number.parseInt(prop, 10))
+				) {
+					const index = Number(prop)
+					let prev: P | undefined
+					if (this.mode === `record`) {
+						prev = target[index]
+					}
+					target[index] = value
+					if (prev) {
+						this.emit({ type: `set`, index, next: value, prev })
+					} else if (this.mode === `record`) {
+						this.emit({ type: `set`, index, next: value })
+					}
+					return true
+				}
+				if (prop === `length`) {
+					if (this.mode === `record`) {
+						const prevLength = target.length
+						if (prevLength === value) return true
+						if (prevLength > value) {
+							const dropped = target.slice(value)
+							target.length = value
+							this.emit({ type: `truncate`, length: value, items: dropped })
+						} else {
+							target.length = value
+							this.emit({ type: `extend`, next: value, prev: prevLength })
+						}
+					} else {
+						target.length = value
+					}
+					return true
+				}
+				return Reflect.set(target, prop, value, receiver)
+			},
+		})
+	}
+
+	public toJSON(): ReadonlyArray<P> {
+		return [...this]
+	}
+
+	public static fromJSON<P extends primitive>(json: ReadonlyArray<P>): OList<P> {
+		return new OList<P>(...json)
+	}
+
+	public push(...items: P[]): number {
+		let result: number
+		if (this.mode === `record`) {
+			this.mode = `playback`
+			result = super.push(...items)
+			this.mode = `record`
+			this.emit({ type: `push`, items })
+		} else {
+			result = super.push(...items)
+		}
+		return result
+	}
+	public pop(): P | undefined {
+		let value: P | undefined
+		if (this.mode === `record`) {
+			this.mode = `playback`
+			value = super.pop()
+			if (value === undefined) {
+				this.emit({ type: `pop` })
+			} else {
+				this.emit({ type: `pop`, value })
+			}
+			this.mode = `record`
+		} else {
+			value = super.pop()
+		}
+		return value
+	}
+	public shift(): P | undefined {
+		let value: P | undefined
+		if (this.mode === `record`) {
+			this.mode = `playback`
+			value = super.shift()
+			if (value === undefined) {
+				this.emit({ type: `shift` })
+			} else {
+				this.emit({ type: `shift`, value })
+			}
+			this.mode = `record`
+		} else {
+			value = super.shift()
+		}
+		return value
+	}
+	public unshift(...items: P[]): number {
+		let result: number
+		if (this.mode === `record`) {
+			this.mode = `playback`
+			result = super.unshift(...items)
+			this.emit({ type: `unshift`, items })
+			this.mode = `record`
+		} else {
+			result = super.unshift(...items)
+		}
+		return result
+	}
+
+	public reverse(): this {
+		super.reverse()
+		if (this.mode === `record`) {
+			this.emit({ type: `reverse` })
+		}
+		return this
+	}
+
+	public sort(compareFn?: (a: P, b: P) => number): this {
+		if (this.mode === `record`) {
+			this.mode = `playback`
+			const prev = [...this]
+			super.sort(compareFn)
+			const next = [...this]
+			this.emit({ type: `sort`, next, prev })
+			this.mode = `record`
+		}
+		return this
+	}
+
+	public splice(start: number, deleteCount?: number): P[]
+	public splice(start: number, deleteCount: number, ...items: P[]): P[]
+	public splice(
+		...params: [start: number, deleteCount?: number, ...items: P[]]
+	): P[] {
+		const [start, deleteCount, ...items] = params
+		const originalMode = this.mode
+		if (originalMode === `record`) this.mode = `playback`
+		const deleted = super.splice(...(params as [number, number, ...P[]]))
+		if (originalMode === `record`) this.mode = `record`
+		if (deleteCount === undefined) {
+			this.emit({
+				type: `splice`,
+				start,
+				items,
+				deleted,
+				deleteCount: deleted.length,
+			})
+		} else {
+			this.emit({ type: `splice`, start, items, deleted, deleteCount })
+		}
+
+		return deleted
+	}
+
+	public copyWithin(target: number, start: number, end?: number): this {
+		const originalMode = this.mode
+		let prev: P[] | undefined
+		if (originalMode === `record`) {
+			prev = this.slice(target)
+			this.mode = `playback`
+		}
+		super.copyWithin(target, start, end)
+		if (originalMode === `record`) this.mode = `record`
+		if (prev) {
+			if (end === undefined) {
+				this.emit({ type: `copyWithin`, prev, target, start })
+			} else {
+				this.emit({ type: `copyWithin`, prev, target, start, end })
+			}
+		}
+		return this
+	}
+
+	public subscribe(
+		key: string,
+		fn: (update: ArrayUpdate<P>) => void,
+	): () => void {
+		return this.subject.subscribe(key, fn)
+	}
+
+	public emit(update: ArrayUpdate<P>): void {
+		this.subject.next(update)
+	}
+
+	private doStep(update: ArrayUpdate<P>): void {
+		const type = update.type
+		switch (type) {
+			case `copyWithin`:
+				this.copyWithin(update.target, update.start, update.end)
+				break
+			case `extend`:
+				this.length = update.next
+				break
+			case `fill`:
+				this.fill(update.value, update.start, update.end)
+				break
+			case `pop`:
+				this.pop()
+				break
+			case `push`:
+				this.push(...update.items)
+				break
+			case `reverse`:
+				this.reverse()
+				break
+			case `shift`:
+				this.shift()
+				break
+			case `sort`:
+				for (let i = 0; i < update.next.length; i++) {
+					this[i] = update.next[i]
+				}
+				this.length = update.next.length
+				break
+			case `splice`:
+				if (update.deleteCount !== undefined && update.items) {
+					this.splice(update.start, update.deleteCount, ...update.items)
+				} else {
+					this.splice(update.start)
+				}
+				break
+			case `truncate`:
+				this.length = update.length
+				break
+			case `set`:
+				this[update.index] = update.next
+				break
+			case `unshift`:
+				this.unshift(...update.items)
+				break
+		}
+	}
+
+	public do(update: ArrayUpdate<P>): null {
+		this.mode = `playback`
+		this.doStep(update)
+		this.mode = `record`
+		return null
+	}
+
+	public undoStep(update: ArrayUpdate<P>): void {
+		switch (update.type) {
+			case `copyWithin`:
+				for (let i = 0; i < update.prev.length; i++) {
+					this[i + update.target] = update.prev[i]
+				}
+				break
+			case `extend`:
+				this.length = update.prev
+				break
+			case `fill`:
+				{
+					const start = update.start ?? 0
+					for (let i = 0; i < update.prev.length; i++) {
+						this[i + start] = update.prev[i]
+					}
+				}
+				break
+			case `pop`:
+				if (update.value) this.push(update.value)
+				break
+			case `push`:
+				{
+					let i = update.items.length - 1
+					while (i >= 0) {
+						this.pop()
+						--i
+					}
+				}
+				break
+			case `reverse`:
+				this.reverse()
+				break
+			case `shift`:
+				if (update.value) this.unshift(update.value)
+				break
+			case `sort`:
+				for (let i = 0; i < update.prev.length; i++) {
+					this[i] = update.prev[i]
+				}
+				this.length = update.prev.length
+				break
+			case `set`:
+				if (update.prev) {
+					this[update.index] = update.prev
+				} else {
+					// eslint-disable-next-line @typescript-eslint/no-dynamic-delete
+					delete this[update.index]
+					const firstEmptyIndex = this.findIndex(
+						(_, i) => !Object.hasOwn(this, i),
+					)
+					if (firstEmptyIndex !== -1) {
+						this.length = firstEmptyIndex
+					}
+				}
+				break
+			case `splice`:
+				if (update.deleted) {
+					if (update.items) {
+						this.splice(update.start, update.items.length, ...update.deleted)
+					} else {
+						this.splice(update.start, 0, ...update.deleted)
+					}
+				} else if (update.items) {
+					this.splice(update.start, update.items.length)
+				}
+				break
+			case `truncate`:
+				this.push(...update.items)
+				break
+			case `unshift`:
+				{
+					let i = update.items.length - 1
+					while (i >= 0) {
+						this.shift()
+						--i
+					}
+				}
+				break
+		}
+	}
+
+	public undo(update: ArrayUpdate<P>): number | null {
+		this.mode = `playback`
+		this.undoStep(update)
+		this.mode = `record`
+		return null
+	}
+}