atom.io 0.6.8 → 0.7.0

package/realtime-testing/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/setup-realtime-test.tsx","../../../anvl/src/object/entries.ts"],"names":["clients"],"mappings":"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","sourcesContent":["import * as http from \"http\"\n\nimport { type RenderResult, prettyDOM, render } from \"@testing-library/react\"\nimport * as AtomIO from \"atom.io\"\nimport * as Internal from \"atom.io/internal\"\nimport * as AR from \"atom.io/react\"\nimport * as RTC from \"atom.io/realtime-react\"\nimport * as Happy from \"happy-dom\"\nimport * as React from \"react\"\nimport * as SocketIO from \"socket.io\"\nimport type { Socket as ClientSocket } from \"socket.io-client\"\nimport { io } from \"socket.io-client\"\n\nimport { recordToEntries } from \"~/packages/anvl/src/object\"\n\nexport type TestSetupOptions = {\n\tserver: (tools: { socket: SocketIO.Socket; silo: AtomIO.Silo }) => void\n}\nexport type TestSetupOptions__SingleClient = TestSetupOptions & {\n\tclient: React.FC\n}\nexport type TestSetupOptions__MultiClient<ClientNames extends string> =\n\tTestSetupOptions & {\n\t\tclients: {\n\t\t\t[K in ClientNames]: React.FC\n\t\t}\n\t}\n\nexport type RealtimeTestTools = {\n\tname: string\n\tsilo: AtomIO.Silo\n\tdispose: () => void\n}\nexport type RealtimeTestClient = RealtimeTestTools & {\n\trenderResult: RenderResult\n\tprettyPrint: () => void\n\treconnect: () => void\n\tdisconnect: () => void\n}\nexport type RealtimeTestServer = RealtimeTestTools & {\n\tport: number\n}\n\nexport type RealtimeTestAPI = {\n\tserver: RealtimeTestServer\n\tteardown: () => void\n}\nexport type RealtimeTestAPI__SingleClient = RealtimeTestAPI & {\n\tclient: RealtimeTestClient\n}\nexport type RealtimeTestAPI__MultiClient<ClientNames extends string> =\n\tRealtimeTestAPI & {\n\t\tclients: Record<ClientNames, RealtimeTestClient>\n\t}\n\nexport const setupRealtimeTestServer = (\n\toptions: TestSetupOptions,\n): RealtimeTestServer => {\n\tconst httpServer = http.createServer((_, res) => res.end(`Hello World!`))\n\tconst address = httpServer.listen().address()\n\tconst port =\n\t\ttypeof address === `string` ? 80 : address === null ? null : address.port\n\tif (port === null) throw new Error(`Could not determine port for test server`)\n\tconst server = new SocketIO.Server(httpServer)\n\tconst silo = new AtomIO.Silo(`SERVER`, Internal.IMPLICIT.STORE)\n\n\tserver.on(`connection`, (socket: SocketIO.Socket) => {\n\t\toptions.server({ socket, silo })\n\t})\n\n\tconst dispose = () => {\n\t\tserver.close()\n\t\tInternal.clearStore(silo.store)\n\t}\n\n\treturn {\n\t\tname: `SERVER`,\n\t\tsilo,\n\t\tdispose,\n\t\tport,\n\t}\n}\nexport const setupRealtimeTestClient = (\n\toptions: TestSetupOptions__SingleClient,\n\tname: string,\n\tport: number,\n): RealtimeTestClient => {\n\tconst socket: ClientSocket = io(`http://localhost:${port}/`)\n\tconst silo = new AtomIO.Silo(name, Internal.IMPLICIT.STORE)\n\n\tconst { document } = new Happy.Window()\n\tdocument.body.innerHTML = `<div id=\"app\"></div>`\n\tconst renderResult = render(\n\t\t<AR.StoreProvider store={silo.store}>\n\t\t\t<RTC.RealtimeProvider socket={socket}>\n\t\t\t\t<options.client />\n\t\t\t</RTC.RealtimeProvider>\n\t\t</AR.StoreProvider>,\n\t\t{\n\t\t\tcontainer: document.querySelector(`#app`) as unknown as HTMLElement,\n\t\t},\n\t)\n\n\tconst prettyPrint = () => console.log(prettyDOM(renderResult.container))\n\n\tconst disconnect = () => socket.disconnect()\n\tconst reconnect = () => socket.connect()\n\n\tconst dispose = () => {\n\t\tsocket.disconnect()\n\t\tInternal.clearStore(silo.store)\n\t}\n\n\treturn {\n\t\tname,\n\t\tsilo,\n\t\trenderResult,\n\t\tprettyPrint,\n\t\tdisconnect,\n\t\treconnect,\n\t\tdispose,\n\t}\n}\n\nexport const singleClient = (\n\toptions: TestSetupOptions__SingleClient,\n): RealtimeTestAPI__SingleClient => {\n\tconst server = setupRealtimeTestServer(options)\n\tconst client = setupRealtimeTestClient(options, `CLIENT`, server.port)\n\n\treturn {\n\t\tclient,\n\t\tserver,\n\t\tteardown: () => {\n\t\t\tclient.dispose()\n\t\t\tserver.dispose()\n\t\t},\n\t}\n}\n\nexport const multiClient = <ClientNames extends string>(\n\toptions: TestSetupOptions__MultiClient<ClientNames>,\n): RealtimeTestAPI__MultiClient<ClientNames> => {\n\tconst server = setupRealtimeTestServer(options)\n\tconst clients = recordToEntries(options.clients).reduce(\n\t\t(clients, [name, client]) => ({\n\t\t\t...clients,\n\t\t\t[name]: setupRealtimeTestClient({ ...options, client }, name, server.port),\n\t\t}),\n\t\t{} as Record<ClientNames, RealtimeTestClient>,\n\t)\n\n\treturn {\n\t\tclients,\n\t\tserver,\n\t\tteardown: () => {\n\t\t\trecordToEntries(clients).forEach(([, client]) => client.dispose())\n\t\t\tserver.dispose()\n\t\t},\n\t}\n}\n","export type Entries<K extends keyof any, V> = [key: K, value: V][]\n\nexport const recordToEntries = <K extends keyof any, V>(\n\tobj: Record<K, V>,\n): Entries<K, V> => Object.entries(obj) as Entries<K, V>\n\nexport const entriesToRecord = <K extends keyof any, V>(\n\tentries: Entries<K, V>,\n): Record<K, V> => Object.fromEntries(entries) as Record<K, V>\n"]}

package/realtime-testing/dist/index.mjs

@@ -0,0 +1,116 @@
+import * as http from 'http';
+import { render, prettyDOM } from '@testing-library/react';
+import * as AtomIO from 'atom.io';
+import * as Internal from 'atom.io/internal';
+import * as AR from 'atom.io/react';
+import * as RTC from 'atom.io/realtime-react';
+import * as Happy from 'happy-dom';
+import * as SocketIO from 'socket.io';
+import { io } from 'socket.io-client';
+import { jsx } from 'react/jsx-runtime';
+
+var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+
+// ../../anvl/src/object/entries.ts
+var recordToEntries = (obj) => Object.entries(obj);
+var setupRealtimeTestServer = (options) => {
+  const httpServer = http.createServer((_, res) => res.end(`Hello World!`));
+  const address = httpServer.listen().address();
+  const port = typeof address === `string` ? 80 : address === null ? null : address.port;
+  if (port === null)
+    throw new Error(`Could not determine port for test server`);
+  const server = new SocketIO.Server(httpServer);
+  const silo = new AtomIO.Silo(`SERVER`, Internal.IMPLICIT.STORE);
+  server.on(`connection`, (socket) => {
+    options.server({ socket, silo });
+  });
+  const dispose = () => {
+    server.close();
+    Internal.clearStore(silo.store);
+  };
+  return {
+    name: `SERVER`,
+    silo,
+    dispose,
+    port
+  };
+};
+var setupRealtimeTestClient = (options, name, port) => {
+  const socket = io(`http://localhost:${port}/`);
+  const silo = new AtomIO.Silo(name, Internal.IMPLICIT.STORE);
+  const { document } = new Happy.Window();
+  document.body.innerHTML = `<div id="app"></div>`;
+  const renderResult = render(
+    /* @__PURE__ */ jsx(AR.StoreProvider, { store: silo.store, children: /* @__PURE__ */ jsx(RTC.RealtimeProvider, { socket, children: /* @__PURE__ */ jsx(options.client, {}) }) }),
+    {
+      container: document.querySelector(`#app`)
+    }
+  );
+  const prettyPrint = () => console.log(prettyDOM(renderResult.container));
+  const disconnect = () => socket.disconnect();
+  const reconnect = () => socket.connect();
+  const dispose = () => {
+    socket.disconnect();
+    Internal.clearStore(silo.store);
+  };
+  return {
+    name,
+    silo,
+    renderResult,
+    prettyPrint,
+    disconnect,
+    reconnect,
+    dispose
+  };
+};
+var singleClient = (options) => {
+  const server = setupRealtimeTestServer(options);
+  const client = setupRealtimeTestClient(options, `CLIENT`, server.port);
+  return {
+    client,
+    server,
+    teardown: () => {
+      client.dispose();
+      server.dispose();
+    }
+  };
+};
+var multiClient = (options) => {
+  const server = setupRealtimeTestServer(options);
+  const clients = recordToEntries(options.clients).reduce(
+    (clients2, [name, client]) => __spreadProps(__spreadValues({}, clients2), {
+      [name]: setupRealtimeTestClient(__spreadProps(__spreadValues({}, options), { client }), name, server.port)
+    }),
+    {}
+  );
+  return {
+    clients,
+    server,
+    teardown: () => {
+      recordToEntries(clients).forEach(([, client]) => client.dispose());
+      server.dispose();
+    }
+  };
+};
+
+export { multiClient, setupRealtimeTestClient, setupRealtimeTestServer, singleClient };
+//# sourceMappingURL=out.js.map
+//# sourceMappingURL=index.mjs.map

package/realtime-testing/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/setup-realtime-test.tsx","../../../anvl/src/object/entries.ts"],"names":["clients"],"mappings":"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","sourcesContent":["import * as http from \"http\"\n\nimport { type RenderResult, prettyDOM, render } from \"@testing-library/react\"\nimport * as AtomIO from \"atom.io\"\nimport * as Internal from \"atom.io/internal\"\nimport * as AR from \"atom.io/react\"\nimport * as RTC from \"atom.io/realtime-react\"\nimport * as Happy from \"happy-dom\"\nimport * as React from \"react\"\nimport * as SocketIO from \"socket.io\"\nimport type { Socket as ClientSocket } from \"socket.io-client\"\nimport { io } from \"socket.io-client\"\n\nimport { recordToEntries } from \"~/packages/anvl/src/object\"\n\nexport type TestSetupOptions = {\n\tserver: (tools: { socket: SocketIO.Socket; silo: AtomIO.Silo }) => void\n}\nexport type TestSetupOptions__SingleClient = TestSetupOptions & {\n\tclient: React.FC\n}\nexport type TestSetupOptions__MultiClient<ClientNames extends string> =\n\tTestSetupOptions & {\n\t\tclients: {\n\t\t\t[K in ClientNames]: React.FC\n\t\t}\n\t}\n\nexport type RealtimeTestTools = {\n\tname: string\n\tsilo: AtomIO.Silo\n\tdispose: () => void\n}\nexport type RealtimeTestClient = RealtimeTestTools & {\n\trenderResult: RenderResult\n\tprettyPrint: () => void\n\treconnect: () => void\n\tdisconnect: () => void\n}\nexport type RealtimeTestServer = RealtimeTestTools & {\n\tport: number\n}\n\nexport type RealtimeTestAPI = {\n\tserver: RealtimeTestServer\n\tteardown: () => void\n}\nexport type RealtimeTestAPI__SingleClient = RealtimeTestAPI & {\n\tclient: RealtimeTestClient\n}\nexport type RealtimeTestAPI__MultiClient<ClientNames extends string> =\n\tRealtimeTestAPI & {\n\t\tclients: Record<ClientNames, RealtimeTestClient>\n\t}\n\nexport const setupRealtimeTestServer = (\n\toptions: TestSetupOptions,\n): RealtimeTestServer => {\n\tconst httpServer = http.createServer((_, res) => res.end(`Hello World!`))\n\tconst address = httpServer.listen().address()\n\tconst port =\n\t\ttypeof address === `string` ? 80 : address === null ? null : address.port\n\tif (port === null) throw new Error(`Could not determine port for test server`)\n\tconst server = new SocketIO.Server(httpServer)\n\tconst silo = new AtomIO.Silo(`SERVER`, Internal.IMPLICIT.STORE)\n\n\tserver.on(`connection`, (socket: SocketIO.Socket) => {\n\t\toptions.server({ socket, silo })\n\t})\n\n\tconst dispose = () => {\n\t\tserver.close()\n\t\tInternal.clearStore(silo.store)\n\t}\n\n\treturn {\n\t\tname: `SERVER`,\n\t\tsilo,\n\t\tdispose,\n\t\tport,\n\t}\n}\nexport const setupRealtimeTestClient = (\n\toptions: TestSetupOptions__SingleClient,\n\tname: string,\n\tport: number,\n): RealtimeTestClient => {\n\tconst socket: ClientSocket = io(`http://localhost:${port}/`)\n\tconst silo = new AtomIO.Silo(name, Internal.IMPLICIT.STORE)\n\n\tconst { document } = new Happy.Window()\n\tdocument.body.innerHTML = `<div id=\"app\"></div>`\n\tconst renderResult = render(\n\t\t<AR.StoreProvider store={silo.store}>\n\t\t\t<RTC.RealtimeProvider socket={socket}>\n\t\t\t\t<options.client />\n\t\t\t</RTC.RealtimeProvider>\n\t\t</AR.StoreProvider>,\n\t\t{\n\t\t\tcontainer: document.querySelector(`#app`) as unknown as HTMLElement,\n\t\t},\n\t)\n\n\tconst prettyPrint = () => console.log(prettyDOM(renderResult.container))\n\n\tconst disconnect = () => socket.disconnect()\n\tconst reconnect = () => socket.connect()\n\n\tconst dispose = () => {\n\t\tsocket.disconnect()\n\t\tInternal.clearStore(silo.store)\n\t}\n\n\treturn {\n\t\tname,\n\t\tsilo,\n\t\trenderResult,\n\t\tprettyPrint,\n\t\tdisconnect,\n\t\treconnect,\n\t\tdispose,\n\t}\n}\n\nexport const singleClient = (\n\toptions: TestSetupOptions__SingleClient,\n): RealtimeTestAPI__SingleClient => {\n\tconst server = setupRealtimeTestServer(options)\n\tconst client = setupRealtimeTestClient(options, `CLIENT`, server.port)\n\n\treturn {\n\t\tclient,\n\t\tserver,\n\t\tteardown: () => {\n\t\t\tclient.dispose()\n\t\t\tserver.dispose()\n\t\t},\n\t}\n}\n\nexport const multiClient = <ClientNames extends string>(\n\toptions: TestSetupOptions__MultiClient<ClientNames>,\n): RealtimeTestAPI__MultiClient<ClientNames> => {\n\tconst server = setupRealtimeTestServer(options)\n\tconst clients = recordToEntries(options.clients).reduce(\n\t\t(clients, [name, client]) => ({\n\t\t\t...clients,\n\t\t\t[name]: setupRealtimeTestClient({ ...options, client }, name, server.port),\n\t\t}),\n\t\t{} as Record<ClientNames, RealtimeTestClient>,\n\t)\n\n\treturn {\n\t\tclients,\n\t\tserver,\n\t\tteardown: () => {\n\t\t\trecordToEntries(clients).forEach(([, client]) => client.dispose())\n\t\t\tserver.dispose()\n\t\t},\n\t}\n}\n","export type Entries<K extends keyof any, V> = [key: K, value: V][]\n\nexport const recordToEntries = <K extends keyof any, V>(\n\tobj: Record<K, V>,\n): Entries<K, V> => Object.entries(obj) as Entries<K, V>\n\nexport const entriesToRecord = <K extends keyof any, V>(\n\tentries: Entries<K, V>,\n): Record<K, V> => Object.fromEntries(entries) as Record<K, V>\n"]}

package/{src/realtime-testing → realtime-testing/src}/setup-realtime-test.tsx

@@ -1,16 +1,18 @@
 import * as http from "http"
 
-import { prettyDOM, render, type RenderResult } from "@testing-library/react"
+import { type RenderResult, prettyDOM, render } from "@testing-library/react"
 import * as AtomIO from "atom.io"
+import * as Internal from "atom.io/internal"
 import * as AR from "atom.io/react"
 import * as RTC from "atom.io/realtime-react"
-import * as RR from "fp-ts/ReadonlyRecord"
 import * as Happy from "happy-dom"
 import * as React from "react"
 import * as SocketIO from "socket.io"
 import type { Socket as ClientSocket } from "socket.io-client"
 import { io } from "socket.io-client"
 
+import { recordToEntries } from "~/packages/anvl/src/object"
+
 export type TestSetupOptions = {
 	server: (tools: { socket: SocketIO.Socket; silo: AtomIO.Silo }) => void
 }
@@ -60,7 +62,7 @@ export const setupRealtimeTestServer = (
 		typeof address === `string` ? 80 : address === null ? null : address.port
 	if (port === null) throw new Error(`Could not determine port for test server`)
 	const server = new SocketIO.Server(httpServer)
-	const silo = AtomIO.silo(`SERVER`, AtomIO.__INTERNAL__.IMPLICIT.STORE)
+	const silo = new AtomIO.Silo(`SERVER`, Internal.IMPLICIT.STORE)
 
 	server.on(`connection`, (socket: SocketIO.Socket) => {
 		options.server({ socket, silo })
@@ -68,7 +70,7 @@ export const setupRealtimeTestServer = (
 
 	const dispose = () => {
 		server.close()
-		AtomIO.__INTERNAL__.clearStore(silo.store)
+		Internal.clearStore(silo.store)
 	}
 
 	return {
@@ -84,7 +86,7 @@ export const setupRealtimeTestClient = (
 	port: number,
 ): RealtimeTestClient => {
 	const socket: ClientSocket = io(`http://localhost:${port}/`)
-	const silo = AtomIO.silo(name, AtomIO.__INTERNAL__.IMPLICIT.STORE)
+	const silo = new AtomIO.Silo(name, Internal.IMPLICIT.STORE)
 
 	const { document } = new Happy.Window()
 	document.body.innerHTML = `<div id="app"></div>`
@@ -106,7 +108,7 @@ export const setupRealtimeTestClient = (
 
 	const dispose = () => {
 		socket.disconnect()
-		AtomIO.__INTERNAL__.clearStore(silo.store)
+		Internal.clearStore(silo.store)
 	}
 
 	return {
@@ -140,7 +142,7 @@ export const multiClient = <ClientNames extends string>(
 	options: TestSetupOptions__MultiClient<ClientNames>,
 ): RealtimeTestAPI__MultiClient<ClientNames> => {
 	const server = setupRealtimeTestServer(options)
-	const clients = RR.toEntries(options.clients).reduce(
+	const clients = recordToEntries(options.clients).reduce(
 		(clients, [name, client]) => ({
 			...clients,
 			[name]: setupRealtimeTestClient({ ...options, client }, name, server.port),
@@ -152,7 +154,7 @@ export const multiClient = <ClientNames extends string>(
 		clients,
 		server,
 		teardown: () => {
-			RR.toEntries(clients).forEach(([, client]) => client.dispose())
+			recordToEntries(clients).forEach(([, client]) => client.dispose())
 			server.dispose()
 		},
 	}

package/src/atom.ts

@@ -1,8 +1,13 @@
-import type { Json } from "~/packages/anvl/src/json"
+import type { Subject, Transceiver } from "atom.io/internal"
+import {
+	createAtom,
+	createAtomFamily,
+	createMutableAtom,
+	createMutableAtomFamily,
+} from "atom.io/internal"
+import type { Json, JsonInterface } from "atom.io/json"
 
-import type { AtomToken } from "."
-import type { Subject } from "./internal"
-import { atomFamily__INTERNAL, atom__INTERNAL } from "./internal"
+import type { AtomToken, MutableAtomToken } from "."
 
 export type Effectors<T> = {
 	setSelf: <V extends T>(next: V | ((oldValue: T) => V)) => void
@@ -16,9 +21,26 @@ export type AtomOptions<T> = {
 	default: T | (() => T)
 	effects?: AtomEffect<T>[]
 }
+// biome-ignore format: complex intersection
+export type MutableAtomOptions<T extends Transceiver<any>, J extends Json.Serializable> = 
+	& JsonInterface<T, J>
+	& Omit<AtomOptions<T>, `default`> 
+	& { 
+			default: ()	=> T
+			mutable: true
+		}
 
-export function atom<T>(options: AtomOptions<T>): AtomToken<T> {
-	return atom__INTERNAL<T>(options)
+export function atom<T extends Transceiver<any>, J extends Json.Serializable>(
+	options: MutableAtomOptions<T, J>,
+): MutableAtomToken<T, J>
+export function atom<T>(options: AtomOptions<T>): AtomToken<T>
+export function atom<T>(
+	options: AtomOptions<any> | MutableAtomOptions<any, any>,
+): AtomToken<any> {
+	if (`mutable` in options) {
+		return createMutableAtom(options)
+	}
+	return createAtom<T>(options)
 }
 
 export type AtomFamilyOptions<T, K extends Json.Serializable> = {
@@ -34,9 +56,43 @@ export type AtomFamily<T, K extends Json.Serializable = Json.Serializable> = ((
 	type: `atom_family`
 	subject: Subject<AtomToken<T>>
 }
+// biome-ignore format: intersection
+export type MutableAtomFamilyOptions<
+	T extends Transceiver<any>,
+	J extends Json.Serializable,
+	K extends Json.Serializable,
+> = 
+	& AtomFamilyOptions<T, K>
+	& JsonInterface<T, J>
+	& { mutable: true }
 
+// biome-ignore format: intersection
+export type MutableAtomFamily<
+	Core extends Transceiver<any>,
+	SerializableCore extends Json.Serializable,
+	Key extends Json.Serializable,
+> = 
+	& JsonInterface<Core, SerializableCore>
+	& ((key: Key) => MutableAtomToken<Core, SerializableCore>) 
+	& {
+			key: `${string}::mutable`
+			type: `atom_family`
+			subject: Subject<MutableAtomToken<Core, SerializableCore>>
+		}
+
+export function atomFamily<
+	T extends Transceiver<any>,
+	J extends Json.Serializable,
+	K extends Json.Serializable,
+>(options: MutableAtomFamilyOptions<T, J, K>): MutableAtomFamily<T, J, K>
 export function atomFamily<T, K extends Json.Serializable>(
 	options: AtomFamilyOptions<T, K>,
-): AtomFamily<T, K> {
-	return atomFamily__INTERNAL<T, K>(options)
+): AtomFamily<T, K>
+export function atomFamily<T, K extends Json.Serializable>(
+	options: AtomFamilyOptions<T, K> | MutableAtomFamilyOptions<any, any, any>,
+): AtomFamily<T, K> | MutableAtomFamily<any, any, any> {
+	if (`mutable` in options) {
+		return createMutableAtomFamily(options)
+	}
+	return createAtomFamily<T, K>(options)
 }

package/src/index.ts

@@ -1,28 +1,23 @@
-import { capitalize } from "~/packages/anvl/src/string/capitalize"
-
-import {
-	IMPLICIT,
-	closeOperation,
-	openOperation,
-	getState__INTERNAL,
-	setState__INTERNAL,
-	isAtomDefault,
-	isSelectorDefault,
-	withdraw,
-} from "./internal"
-import * as __INTERNAL__ from "./internal"
-import type { Store } from "./internal/store"
+import * as IO from "atom.io/internal"
+import type { Store, Transceiver } from "atom.io/internal"
+import type { Json } from "atom.io/json"
 
 export * from "./atom"
 export * from "./logger"
 export * from "./selector"
 export * from "./silo"
-export * from "./subscribe"
+export {
+	subscribe,
+	subscribeToTimeline,
+	subscribeToTransaction,
+	KeyedStateUpdate,
+	StateUpdate,
+	UpdateHandler,
+} from "./subscribe"
 export * from "./timeline"
 export * from "./transaction"
-export { __INTERNAL__ }
-export type { Store } from "./internal/store"
-export type { Json } from "~/packages/anvl/src/json"
+
+export type ƒn = (...parameters: any[]) => any
 
 export type AtomToken<_> = {
 	key: string
@@ -30,6 +25,13 @@ export type AtomToken<_> = {
 	family?: FamilyMetadata
 	__brand?: _
 }
+export interface MutableAtomToken<
+	T extends Transceiver<any>,
+	J extends Json.Serializable,
+> extends AtomToken<T> {
+	__asJSON?: J
+	__update?: T extends Transceiver<infer Update> ? Update : never
+}
 export type SelectorToken<_> = {
 	key: string
 	type: `selector`
@@ -50,11 +52,15 @@ export type FamilyMetadata = {
 	subKey: string
 }
 
+export const capitalize = (str: string): string =>
+	str[0].toUpperCase() + str.slice(1)
+
 export const getState = <T>(
 	token: ReadonlySelectorToken<T> | StateToken<T>,
-	store: Store = IMPLICIT.STORE,
+	store: Store = IO.IMPLICIT.STORE,
 ): T => {
-	const state = withdraw<T>(token, store)
+	const state =
+		IO.withdraw(token, store) ?? IO.withdrawNewFamilyMember(token, store)
 	if (state === null) {
 		throw new Error(
 			`${capitalize(token.type)} "${token.key}" not found in store "${
@@ -62,23 +68,24 @@ export const getState = <T>(
 			}".`,
 		)
 	}
-	return getState__INTERNAL(state, store)
+	return IO.getState__INTERNAL(state, store)
 }
 
 export const setState = <T, New extends T>(
 	token: StateToken<T>,
 	value: New | ((oldValue: T) => New),
-	store: Store = IMPLICIT.STORE,
+	store: Store = IO.IMPLICIT.STORE,
 ): void => {
 	try {
-		openOperation(token, store)
+		IO.openOperation(token, store)
 	} catch (thrown) {
 		if (!(typeof thrown === `symbol`)) {
 			throw thrown
 		}
 		return
 	}
-	const state = withdraw(token, store)
+	const state =
+		IO.withdraw(token, store) ?? IO.withdrawNewFamilyMember(token, store)
 	if (state === null) {
 		throw new Error(
 			`${capitalize(token.type)} "${token.key}" not found in store "${
@@ -86,14 +93,14 @@ export const setState = <T, New extends T>(
 			}".`,
 		)
 	}
-	setState__INTERNAL(state, value, store)
-	closeOperation(store)
+	IO.setState__INTERNAL(state, value, store)
+	IO.closeOperation(store)
 }
 
 export const isDefault = (
 	token: ReadonlySelectorToken<unknown> | StateToken<unknown>,
-	store: Store = IMPLICIT.STORE,
+	store: Store = IO.IMPLICIT.STORE,
 ): boolean =>
 	token.type === `atom`
-		? isAtomDefault(token.key, store)
-		: isSelectorDefault(token.key, store)
+		? IO.isAtomDefault(token.key, store)
+		: IO.isSelectorDefault(token.key, store)

package/src/logger.ts

@@ -1,7 +1,7 @@
-import { doNothing } from "~/packages/anvl/src/function"
+import { IMPLICIT } from "atom.io/internal"
+import type { Store } from "atom.io/internal"
 
-import type { Store } from "./internal/store"
-import { IMPLICIT } from "./internal/store"
+export const NO_OP = (): void => undefined
 
 export type Logger = Pick<Console, `error` | `info` | `warn`>
 export const LOG_LEVELS: ReadonlyArray<keyof Logger> = [
@@ -21,10 +21,10 @@ export const setLogLevel = (
 		store.config.logger = { ...console }
 		LOG_LEVELS.forEach((logLevel) => {
 			if (LOG_LEVELS.indexOf(logLevel) < LOG_LEVELS.indexOf(preferredLevel)) {
-				// rome-ignore lint/style/noNonNullAssertion: we just set it
-				store.config.logger![logLevel] = doNothing
+				// biome-ignore lint/style/noNonNullAssertion: we just set it
+				store.config.logger![logLevel] = NO_OP
 			} else {
-				// rome-ignore lint/style/noNonNullAssertion: we just set it
+				// biome-ignore lint/style/noNonNullAssertion: we just set it
 				store.config.logger![logLevel] = logger__INTERNAL[logLevel]
 			}
 		})
@@ -39,7 +39,7 @@ export const useLogger = (
 		store.config.logger === null
 			? null
 			: LOG_LEVELS.find(
-					(logLevel) => store.config.logger?.[logLevel] !== doNothing,
+					(logLevel) => store.config.logger?.[logLevel] !== NO_OP,
 			  ) ?? null
 	store.config.logger__INTERNAL = { ...logger }
 	setLogLevel(currentLogLevel, store)

package/src/selector.ts

@@ -1,8 +1,8 @@
-import type { Json } from "~/packages/anvl/src/json"
+import type { Subject } from "atom.io/internal"
+import { createSelector, createSelectorFamily } from "atom.io/internal"
+import type { Json } from "atom.io/json"
 
 import type { ReadonlySelectorToken, SelectorToken } from "."
-import type { Subject } from "./internal"
-import { selectorFamily__INTERNAL, selector__INTERNAL } from "./internal"
 import type { Read, Write } from "./transaction"
 
 export type SelectorOptions<T> = {
@@ -22,7 +22,7 @@ export function selector<T>(
 export function selector<T>(
 	options: ReadonlySelectorOptions<T> | SelectorOptions<T>,
 ): ReadonlySelectorToken<T> | SelectorToken<T> {
-	return selector__INTERNAL(options)
+	return createSelector(options)
 }
 
 export type SelectorFamilyOptions<T, K extends Json.Serializable> = {
@@ -62,5 +62,5 @@ export function selectorFamily<T, K extends Json.Serializable>(
 export function selectorFamily<T, K extends Json.Serializable>(
 	options: ReadonlySelectorFamilyOptions<T, K> | SelectorFamilyOptions<T, K>,
 ): ReadonlySelectorFamily<T, K> | SelectorFamily<T, K> {
-	return selectorFamily__INTERNAL(options)
+	return createSelectorFamily(options)
 }

package/src/silo.ts

@@ -1,53 +1,59 @@
-import type { redo, timeline, undo } from "."
-import { getState, setState, subscribe } from "."
-import type { atom, atomFamily } from "./atom"
-import type { Store } from "./internal"
 import {
-	atomFamily__INTERNAL,
-	atom__INTERNAL,
-	createStore,
+	Store,
+	createAtom,
+	createAtomFamily,
+	createMutableAtom,
+	createMutableAtomFamily,
+	createSelector,
+	createSelectorFamily,
 	redo__INTERNAL,
-	selectorFamily__INTERNAL,
-	selector__INTERNAL,
 	timeline__INTERNAL,
 	transaction__INTERNAL,
 	undo__INTERNAL,
-} from "./internal"
+} from "atom.io/internal"
+
+import type { redo, timeline, undo } from "."
+import { getState, setState, subscribe } from "."
+import type { atom, atomFamily } from "./atom"
 import type { selector, selectorFamily } from "./selector"
 import type { transaction } from "./transaction"
 
-export type Silo = ReturnType<typeof silo>
-
-export const silo = (
-	name: string,
-	fromStore: Store | null = null,
-): {
-	store: Store
-	atom: typeof atom
-	atomFamily: typeof atomFamily
-	selector: typeof selector
-	selectorFamily: typeof selectorFamily
-	transaction: typeof transaction
-	timeline: typeof timeline
-	getState: typeof getState
-	setState: typeof setState
-	subscribe: typeof subscribe
-	undo: typeof undo
-	redo: typeof redo
-} => {
-	const store = createStore(name, fromStore)
-	return {
-		store,
-		atom: (options) => atom__INTERNAL(options, undefined, store),
-		atomFamily: (options) => atomFamily__INTERNAL(options, store),
-		selector: (options) => selector__INTERNAL(options, undefined, store) as any,
-		selectorFamily: (options) => selectorFamily__INTERNAL(options, store) as any,
-		transaction: (options) => transaction__INTERNAL(options, store),
-		timeline: (options) => timeline__INTERNAL(options, store),
-		getState: (token) => getState(token, store),
-		setState: (token, newValue) => setState(token, newValue, store),
-		subscribe: (token, handler) => subscribe(token, handler, store),
-		undo: (token) => undo__INTERNAL(token, store),
-		redo: (token) => redo__INTERNAL(token, store),
+export class Silo {
+	public store: Store
+	public atom: typeof atom
+	public atomFamily: typeof atomFamily
+	public selector: typeof selector
+	public selectorFamily: typeof selectorFamily
+	public transaction: typeof transaction
+	public timeline: typeof timeline
+	public getState: typeof getState
+	public setState: typeof setState
+	public subscribe: typeof subscribe
+	public undo: typeof undo
+	public redo: typeof redo
+	public constructor(name: string, fromStore: Store | null = null) {
+		const s = new Store(name, fromStore)
+		this.store = s
+		this.atom = (options) => {
+			if (`mutable` in options) {
+				return createMutableAtom(options, s)
+			}
+			return createAtom(options, undefined, s)
+		}
+		this.atomFamily = (options) => {
+			if (`mutable` in options) {
+				return createMutableAtomFamily(options, s) as any
+			}
+			return createAtomFamily(options, s)
+		}
+		this.selector = (options) => createSelector(options, undefined, s) as any
+		this.selectorFamily = (options) => createSelectorFamily(options, s) as any
+		this.transaction = (options) => transaction__INTERNAL(options, s)
+		this.timeline = (options) => timeline__INTERNAL(options, s)
+		this.getState = (token) => getState(token, s)
+		this.setState = (token, newValue) => setState(token, newValue, s)
+		this.subscribe = (token, handler, key) => subscribe(token, handler, key, s)
+		this.undo = (token) => undo__INTERNAL(token, s)
+		this.redo = (token) => redo__INTERNAL(token, s)
 	}
 }