atom.io 0.27.5 → 0.28.1

package/introspection/dist/index.js

@@ -1,393 +1,2 @@
+export { Auditor, Differ, Refinery, attachIntrospectionStates, diffArray, diffBoolean, diffNumber, diffObject, diffString, discoverType, jsonRefinery, jsonTreeRefinery, prettyJson, primitiveRefinery } from '../../dist/chunk-D52JNVER.js';
 import '../../dist/chunk-XWL6SNVU.js';
-import * as Internal from 'atom.io/internal';
-import { createRegularAtom, deposit, createStandaloneSelector, IMPLICIT, createRegularAtomFamily, Subject, createSelectorFamily } from 'atom.io/internal';
-import { getState } from 'atom.io';
-
-var attachAtomIndex = (store = IMPLICIT.STORE) => {
-  const atomTokenIndexState__INTERNAL = createRegularAtom(
-    store,
-    {
-      key: `\u{1F441}\u200D\u{1F5E8} Atom Token Index (Internal)`,
-      default: () => {
-        const base = /* @__PURE__ */ new Map();
-        for (const [key, val] of store.atoms) {
-          if (!key.includes(`\u{1F441}\u200D\u{1F5E8}`)) {
-            const token = deposit(val);
-            if (val.family) {
-              let familyNode = base.get(val.family.key);
-              if (!familyNode || !(`familyMembers` in familyNode)) {
-                familyNode = {
-                  key: val.family.key,
-                  familyMembers: /* @__PURE__ */ new Map()
-                };
-                base.set(val.family.key, familyNode);
-              }
-              familyNode.familyMembers.set(val.family.subKey, token);
-            } else {
-              base.set(key, token);
-            }
-          }
-        }
-        return base;
-      },
-      effects: [
-        ({ setSelf }) => {
-          store.on.atomCreation.subscribe(`introspection`, (atomToken) => {
-            if (atomToken.key.includes(`\u{1F441}\u200D\u{1F5E8}`)) {
-              return;
-            }
-            setSelf((self) => {
-              if (atomToken.family) {
-                const { key: familyKey, subKey } = atomToken.family;
-                let familyNode = self.get(familyKey);
-                if (familyNode === void 0 || !(`familyMembers` in familyNode)) {
-                  familyNode = {
-                    key: familyKey,
-                    familyMembers: /* @__PURE__ */ new Map()
-                  };
-                  self.set(familyKey, familyNode);
-                }
-                familyNode.familyMembers.set(subKey, atomToken);
-              } else {
-                self.set(atomToken.key, atomToken);
-              }
-              return self;
-            });
-          });
-          store.on.atomDisposal.subscribe(`introspection`, (atomToken) => {
-            setSelf((self) => {
-              if (atomToken.family) {
-                const { key: familyKey, subKey } = atomToken.family;
-                const familyNode = self.get(familyKey);
-                if (familyNode && `familyMembers` in familyNode) {
-                  familyNode.familyMembers.delete(subKey);
-                  if (familyNode.familyMembers.size === 0) {
-                    self.delete(familyKey);
-                  }
-                }
-              } else {
-                self.delete(atomToken.key);
-              }
-              return self;
-            });
-          });
-        }
-      ]
-    },
-    void 0
-  );
-  return createStandaloneSelector(store, {
-    key: `\u{1F441}\u200D\u{1F5E8} Atom Token Index`,
-    get: ({ get }) => get(atomTokenIndexState__INTERNAL)
-  });
-};
-var attachSelectorIndex = (store = IMPLICIT.STORE) => {
-  const readonlySelectorTokenIndexState__INTERNAL = createRegularAtom(
-    store,
-    {
-      key: `\u{1F441}\u200D\u{1F5E8} Selector Token Index (Internal)`,
-      default: () => {
-        const base = /* @__PURE__ */ new Map();
-        for (const map of [store.readonlySelectors, store.selectors]) {
-          for (const [key, val] of map) {
-            if (!key.includes(`\u{1F441}\u200D\u{1F5E8}`)) {
-              const token = deposit(val);
-              if (val.family) {
-                let familyNode = base.get(val.family.key);
-                if (!familyNode || !(`familyMembers` in familyNode)) {
-                  familyNode = {
-                    key: val.family.key,
-                    familyMembers: /* @__PURE__ */ new Map()
-                  };
-                  base.set(val.family.key, familyNode);
-                }
-                familyNode.familyMembers.set(val.family.subKey, token);
-              } else {
-                base.set(key, token);
-              }
-            }
-          }
-        }
-        return base;
-      },
-      effects: [
-        ({ setSelf }) => {
-          store.on.selectorCreation.subscribe(
-            `introspection`,
-            (selectorToken) => {
-              if (selectorToken.key.includes(`\u{1F441}\u200D\u{1F5E8}`)) {
-                return;
-              }
-              setSelf((self) => {
-                if (selectorToken.family) {
-                  const { key: familyKey, subKey } = selectorToken.family;
-                  let familyNode = self.get(familyKey);
-                  if (familyNode === void 0 || !(`familyMembers` in familyNode)) {
-                    familyNode = {
-                      key: familyKey,
-                      familyMembers: /* @__PURE__ */ new Map()
-                    };
-                    self.set(familyKey, familyNode);
-                  }
-                  familyNode.familyMembers.set(subKey, selectorToken);
-                } else {
-                  self.set(selectorToken.key, selectorToken);
-                }
-                return self;
-              });
-            }
-          );
-          store.on.selectorDisposal.subscribe(
-            `introspection`,
-            (selectorToken) => {
-              setSelf((self) => {
-                if (selectorToken.family) {
-                  const { key: familyKey, subKey } = selectorToken.family;
-                  const familyNode = self.get(familyKey);
-                  if (familyNode && `familyMembers` in familyNode) {
-                    familyNode.familyMembers.delete(subKey);
-                    if (familyNode.familyMembers.size === 0) {
-                      self.delete(familyKey);
-                    }
-                  }
-                } else {
-                  self.delete(selectorToken.key);
-                }
-                return self;
-              });
-            }
-          );
-        }
-      ]
-    },
-    void 0
-  );
-  return createStandaloneSelector(IMPLICIT.STORE, {
-    key: `\u{1F441}\u200D\u{1F5E8} Selector Token Index`,
-    get: ({ get }) => get(readonlySelectorTokenIndexState__INTERNAL)
-  });
-};
-var attachTimelineFamily = (store = IMPLICIT.STORE) => {
-  const findTimelineLogState__INTERNAL = createRegularAtomFamily(store, {
-    key: `\u{1F441}\u200D\u{1F5E8} Timeline Update Log (Internal)`,
-    default: (key) => store.timelines.get(key) ?? {
-      type: `timeline`,
-      key: ``,
-      at: 0,
-      timeTraveling: null,
-      history: [],
-      selectorTime: null,
-      transactionKey: null,
-      install: () => {
-      },
-      subject: new Subject(),
-      subscriptions: /* @__PURE__ */ new Map()
-    },
-    effects: (key) => [
-      ({ setSelf }) => {
-        const tl = store.timelines.get(key);
-        tl?.subject.subscribe(`introspection`, (_) => {
-          setSelf({ ...tl });
-        });
-      }
-    ]
-  });
-  const findTimelineLogState = createSelectorFamily(
-    store,
-    {
-      key: `\u{1F441}\u200D\u{1F5E8} Timeline Update Log`,
-      get: (key) => ({ get }) => get(findTimelineLogState__INTERNAL, key)
-    }
-  );
-  return findTimelineLogState;
-};
-var attachTimelineIndex = (store = IMPLICIT.STORE) => {
-  const timelineTokenIndexState__INTERNAL = createRegularAtom(
-    store,
-    {
-      key: `\u{1F441}\u200D\u{1F5E8} Timeline Token Index (Internal)`,
-      default: () => [...store.timelines].map(([key]) => {
-        return { key, type: `timeline` };
-      }),
-      effects: [
-        ({ setSelf }) => {
-          store.on.timelineCreation.subscribe(
-            `introspection`,
-            (timelineToken) => {
-              setSelf((state) => [...state, timelineToken]);
-            }
-          );
-        }
-      ]
-    },
-    void 0
-  );
-  const timelineTokenIndex = createStandaloneSelector(store, {
-    key: `\u{1F441}\u200D\u{1F5E8} Timeline Token Index`,
-    get: ({ get }) => get(timelineTokenIndexState__INTERNAL)
-  });
-  return timelineTokenIndex;
-};
-var attachTransactionIndex = (store = IMPLICIT.STORE) => {
-  const transactionTokenIndexState__INTERNAL = createRegularAtom(
-    store,
-    {
-      key: `\u{1F441}\u200D\u{1F5E8} Transaction Token Index (Internal)`,
-      default: () => [...store.transactions].map(([key]) => {
-        return { key, type: `transaction` };
-      }),
-      effects: [
-        ({ setSelf }) => {
-          store.on.transactionCreation.subscribe(
-            `introspection`,
-            (transactionToken) => {
-              setSelf((state) => [...state, transactionToken]);
-            }
-          );
-        }
-      ]
-    },
-    void 0
-  );
-  const transactionTokenIndex = createStandaloneSelector(store, {
-    key: `\u{1F441}\u200D\u{1F5E8} Transaction Token Index`,
-    get: ({ get }) => get(transactionTokenIndexState__INTERNAL)
-  });
-  return transactionTokenIndex;
-};
-var attachTransactionLogs = (store = IMPLICIT.STORE) => {
-  const transactionUpdateLogAtoms = createRegularAtomFamily(store, {
-    key: `\u{1F441}\u200D\u{1F5E8} Transaction Update Log (Internal)`,
-    default: () => [],
-    effects: (key) => [
-      ({ setSelf }) => {
-        const tx = store.transactions.get(key);
-        tx?.subject.subscribe(`introspection`, (transactionUpdate) => {
-          if (transactionUpdate.key === key) {
-            setSelf((state) => [...state, transactionUpdate]);
-          }
-        });
-      }
-    ]
-  });
-  const findTransactionUpdateLogState = createSelectorFamily(store, {
-    key: `\u{1F441}\u200D\u{1F5E8} Transaction Update Log`,
-    get: (key) => ({ get }) => get(transactionUpdateLogAtoms, key)
-  });
-  return findTransactionUpdateLogState;
-};
-
-// introspection/src/attach-introspection-states.ts
-var attachIntrospectionStates = (store = Internal.IMPLICIT.STORE) => {
-  return {
-    atomIndex: attachAtomIndex(store),
-    selectorIndex: attachSelectorIndex(store),
-    transactionIndex: attachTransactionIndex(store),
-    findTransactionLogState: attachTransactionLogs(store),
-    timelineIndex: attachTimelineIndex(store),
-    findTimelineState: attachTimelineFamily(store)
-  };
-};
-var Auditor = class _Auditor {
-  /**
-   * @param {Store} store - The store to audit.
-   */
-  constructor(store = Internal.IMPLICIT.STORE) {
-    this.store = store;
-    this.atomIndex = attachAtomIndex(this.store);
-    this.selectorIndex = attachSelectorIndex(this.store);
-    this.unsubscribeFromAtomCreation = this.store.on.atomCreation.subscribe(
-      `auditor-${this.auditorCreatedAt}`,
-      ({ key }) => {
-        this.statesCreatedAt.set(key, performance.now() - this.auditorCreatedAt);
-      }
-    );
-    this.unsubscribeFromAtomDisposal = this.store.on.atomDisposal.subscribe(
-      `auditor-${this.auditorCreatedAt}`,
-      ({ key }) => {
-        this.statesCreatedAt.delete(key);
-      }
-    );
-    this.unsubscribeFromSelectorCreation = this.store.on.selectorCreation.subscribe(
-      `auditor-${this.auditorCreatedAt}`,
-      ({ key }) => {
-        this.statesCreatedAt.set(
-          key,
-          performance.now() - this.auditorCreatedAt
-        );
-      }
-    );
-    this.unsubscribeFromSelectorDisposal = this.store.on.selectorDisposal.subscribe(
-      `auditor-${this.auditorCreatedAt}`,
-      ({ key }) => {
-        this.statesCreatedAt.delete(key);
-      }
-    );
-  }
-  auditorCreatedAt = performance.now();
-  statesCreatedAt = /* @__PURE__ */ new Map();
-  atomIndex;
-  selectorIndex;
-  disposed = false;
-  unsubscribeFromAtomCreation;
-  unsubscribeFromAtomDisposal;
-  unsubscribeFromSelectorCreation;
-  unsubscribeFromSelectorDisposal;
-  static DEFAULT_LIST_RESOURCES_PARAM = {
-    atomFamilies: true,
-    selectorFamilies: true
-  };
-  /**
-   * Lists all resources in the store, along with their creation time.
-   *
-   * @param {ListResourcesParam} [param] - Optional parameters for filtering the list of resources.
-   * @returns {readonly [ReadableToken<unknown>, number]}[] - An array of tuples, where each tuple contains a state token belonging to a family in the store and that state's creation time.
-   */
-  listResources(param = _Auditor.DEFAULT_LIST_RESOURCES_PARAM) {
-    if (this.disposed) {
-      throw new Error(`This Auditor has been disposed`);
-    }
-    const atoms = getState(this.atomIndex);
-    const selectors = getState(this.selectorIndex);
-    const atomFamilyNodes = [...atoms.values()].filter(
-      (node) => `familyMembers` in node
-    );
-    const selectorFamilyNodes = [...selectors.values()].filter(
-      (node) => `familyMembers` in node
-    );
-    const currentTime = performance.now();
-    const resources = [];
-    if (param.atomFamilies) {
-      for (const familyNode of atomFamilyNodes) {
-        const tokens = familyNode.familyMembers.values();
-        for (const token of tokens) {
-          const storedTime = this.statesCreatedAt.get(token.key);
-          const creationTime = storedTime ?? this.auditorCreatedAt;
-          const age = currentTime - creationTime;
-          resources.push([token, age]);
-        }
-      }
-    }
-    if (param.selectorFamilies) {
-      for (const familyNode of selectorFamilyNodes) {
-        const tokens = familyNode.familyMembers.values();
-        for (const token of tokens) {
-          const storedTime = this.statesCreatedAt.get(token.key);
-          const creationTime = storedTime ?? this.auditorCreatedAt;
-          const age = currentTime - creationTime;
-          resources.push([token, age]);
-        }
-      }
-    }
-    return resources;
-  }
-  [Symbol.dispose]() {
-    this.unsubscribeFromAtomCreation();
-    this.unsubscribeFromAtomDisposal();
-    this.unsubscribeFromSelectorCreation();
-    this.unsubscribeFromSelectorDisposal();
-    this.disposed = true;
-  }
-};
-
-export { Auditor, attachIntrospectionStates };

package/introspection/src/attach-introspection-states.ts

@@ -15,6 +15,7 @@ import { attachTimelineFamily } from "./attach-timeline-family"
 import { attachTimelineIndex } from "./attach-timeline-index"
 import { attachTransactionIndex } from "./attach-transaction-index"
 import { attachTransactionLogs } from "./attach-transaction-logs"
+import { attachTypeSelectors } from "./attach-type-selectors"
 
 export const attachIntrospectionStates = (
 	store: Internal.Store = Internal.IMPLICIT.STORE,
@@ -22,19 +23,21 @@ export const attachIntrospectionStates = (
 	atomIndex: ReadonlySelectorToken<AtomTokenIndex>
 	selectorIndex: ReadonlySelectorToken<SelectorTokenIndex>
 	transactionIndex: ReadonlySelectorToken<TransactionToken<Func>[]>
-	findTransactionLogState: ReadonlySelectorFamilyToken<
+	transactionLogSelectors: ReadonlySelectorFamilyToken<
 		TransactionUpdate<Func>[],
 		string
 	>
 	timelineIndex: ReadonlySelectorToken<TimelineToken<any>[]>
-	findTimelineState: ReadonlySelectorFamilyToken<Timeline<any>, string>
+	timelineSelectors: ReadonlySelectorFamilyToken<Timeline<any>, string>
+	typeSelectors: ReadonlySelectorFamilyToken<string, string>
 } => {
 	return {
 		atomIndex: attachAtomIndex(store),
 		selectorIndex: attachSelectorIndex(store),
 		transactionIndex: attachTransactionIndex(store),
-		findTransactionLogState: attachTransactionLogs(store),
+		transactionLogSelectors: attachTransactionLogs(store),
 		timelineIndex: attachTimelineIndex(store),
-		findTimelineState: attachTimelineFamily(store),
+		timelineSelectors: attachTimelineFamily(store),
+		typeSelectors: attachTypeSelectors(store),
 	}
 }

package/introspection/src/attach-type-selectors.ts

@@ -0,0 +1,26 @@
+import type { ReadonlySelectorFamilyToken } from "atom.io"
+import type { Store } from "atom.io/internal"
+import { createReadonlySelectorFamily, IMPLICIT } from "atom.io/internal"
+
+import { discoverType } from "./refinery"
+
+export const attachTypeSelectors = (
+	store: Store = IMPLICIT.STORE,
+): ReadonlySelectorFamilyToken<string, string> => {
+	const typeSelectors = createReadonlySelectorFamily<string, string>(store, {
+		key: `👁‍🗨 State Type`,
+		get:
+			(token) =>
+			({ get }) => {
+				let state: unknown
+				try {
+					state = get(token as any)
+				} catch (error) {
+					return `error`
+				}
+				const typeOfState = discoverType(state)
+				return typeOfState
+			},
+	})
+	return typeSelectors
+}

package/introspection/src/differ.ts

@@ -0,0 +1,167 @@
+import { sprawl } from "anvl/object"
+import type { Json } from "atom.io/json"
+
+import type { Refinery, Supported } from "./refinery"
+import { discoverType, jsonTreeRefinery, primitiveRefinery } from "./refinery"
+
+export function diffNumber(a: number, b: number): Delta {
+	const sign = a < b ? `+` : `-`
+	return {
+		summary: `${sign}${Math.abs(a - b)} (${a} → ${b})`,
+	}
+}
+
+export function diffString(a: string, b: string): Delta {
+	const sign = a.length < b.length ? `+` : `-`
+	return {
+		summary: `${sign}${Math.abs(a.length - b.length)} ("${a}" → "${b}")`,
+	}
+}
+
+export function diffBoolean(a: boolean, b: boolean): Delta {
+	return {
+		summary: `${a} → ${b}`,
+	}
+}
+
+export function diffObject(
+	a: Json.Tree.Object,
+	b: Json.Tree.Object,
+	recurse: Diff<unknown>,
+): Delta {
+	let summary = ``
+	const added: Delta[`added`] = []
+	const removed: Delta[`removed`] = []
+	const changed: Delta[`changed`] = []
+
+	sprawl(a, (path, nodeA) => {
+		let key: string
+		for (key of path) {
+			const nodeB = b[key]
+			if (nodeB === undefined) {
+				removed.push([key, JSON.stringify(nodeA)])
+			} else {
+				const delta = recurse(nodeA, nodeB)
+				if (delta.summary !== `No Change`) {
+					changed.push([key, delta])
+				}
+			}
+		}
+	})
+
+	sprawl(b, (path, nodeB) => {
+		let key: string
+		for (key of path) {
+			const nodeA = a[key]
+			if (nodeA === undefined) {
+				added.push([key, JSON.stringify(nodeB)])
+			}
+		}
+	})
+
+	summary = `～${changed.length} ＋${added.length} －${removed.length}`
+
+	return {
+		summary,
+		added,
+		removed,
+		changed,
+	}
+}
+
+export function diffArray(
+	a: Json.Tree.Array,
+	b: Json.Tree.Array,
+	recurse: Diff<unknown>,
+): Delta {
+	return diffObject(a as any, b as any, recurse)
+}
+
+type Delta = {
+	summary: string
+	added?: [path: string, addedStringifiedValue: string][]
+	removed?: [path: string, removedStringifiedValue: string][]
+	changed?: [path: string, delta: Delta][]
+}
+
+type Diff<T> = (a: T, b: T) => Delta
+type DiffTree<T> = (a: T, b: T, recurse: Differ<any, any>[`diff`]) => Delta
+
+export class Differ<
+	Leaf extends Record<string, any>,
+	Tree extends Record<string, any>,
+> {
+	public leafRefinery: Refinery<Leaf>
+	public treeRefinery: Refinery<Tree>
+	public leafDiffers: { [KL in keyof Leaf]: Diff<Supported<Leaf[KL]>> }
+	public treeDiffers: { [KT in keyof Tree]: DiffTree<Supported<Tree[KT]>> }
+
+	public constructor(
+		leafRefinery: Refinery<Leaf>,
+		treeRefinery: Refinery<Tree>,
+		diffFunctions: {
+			[KT in keyof Tree]: DiffTree<Supported<Tree[KT]>>
+		} & { [KL in keyof Leaf]: Diff<Supported<Leaf[KL]>> },
+	) {
+		this.leafRefinery = leafRefinery
+		this.treeRefinery = treeRefinery
+		this.leafDiffers = {} as any
+		this.treeDiffers = {} as any
+		for (const key of Object.keys(leafRefinery.supported)) {
+			const diffFunction = diffFunctions[key]
+			this.leafDiffers[key as keyof Leaf] = diffFunction
+		}
+		for (const key of Object.keys(treeRefinery.supported)) {
+			const diffFunction = diffFunctions[key]
+			this.treeDiffers[key as keyof Tree] = diffFunction
+		}
+	}
+
+	public diff(a: unknown, b: unknown): Delta {
+		if (a === b) {
+			return { summary: `No Change` }
+		}
+
+		const aRefined = this.leafRefinery.refine(a) ?? this.treeRefinery.refine(a)
+		const bRefined = this.leafRefinery.refine(b) ?? this.treeRefinery.refine(b)
+
+		if (aRefined !== null && bRefined !== null) {
+			if (aRefined.type === bRefined.type) {
+				if (aRefined.type in this.leafDiffers) {
+					const delta = this.leafDiffers[aRefined.type](
+						aRefined.data,
+						bRefined.data,
+					)
+					return delta
+				}
+				if (aRefined.type in this.treeDiffers) {
+					const delta = this.treeDiffers[aRefined.type](
+						aRefined.data,
+						bRefined.data,
+						(x, y) => this.diff(x, y),
+					)
+					return delta
+				}
+			}
+		}
+		const typeA = discoverType(a)
+		const typeB = discoverType(b)
+		if (typeA === typeB) {
+			return {
+				summary: `${typeA} → ${typeB}`,
+			}
+		}
+		return {
+			summary: `Type change: ${typeA} → ${typeB}`,
+		}
+	}
+}
+
+export const prettyJson = new Differ(primitiveRefinery, jsonTreeRefinery, {
+	number: diffNumber,
+	string: diffString,
+	boolean: diffBoolean,
+	null: () => ({ summary: `No Change` }),
+	object: diffObject,
+	array: diffArray,
+})

package/introspection/src/index.ts

@@ -2,6 +2,8 @@ import type { ReadableToken } from "atom.io"
 
 export * from "./attach-introspection-states"
 export * from "./auditor"
+export * from "./differ"
+export * from "./refinery"
 
 export type FamilyNode<Token extends ReadableToken<unknown>> = {
 	key: string