@dxos/echo-atom 0.0.0 → 0.8.4-main.69d29f4

package/dist/lib/browser/index.mjs

@@ -0,0 +1,178 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/atom.ts
+var atom_exports = {};
+__export(atom_exports, {
+  make: () => make2,
+  makeProperty: () => makeProperty
+});
+import * as Atom from "@effect-atom/atom/Atom";
+import isEqual from "lodash.isequal";
+import { Obj, Ref } from "@dxos/echo";
+import { assertArgument } from "@dxos/invariant";
+
+// src/ref-utils.ts
+var loadRefTarget = (ref, get, onTargetAvailable) => {
+  const currentTarget = ref.target;
+  if (currentTarget) {
+    return onTargetAvailable(currentTarget);
+  }
+  void ref.load().then((loadedTarget) => {
+    get.setSelf(onTargetAvailable(loadedTarget));
+  }).catch(() => {
+  });
+  return void 0;
+};
+
+// src/atom.ts
+var objectFamily = Atom.family((obj) => {
+  return Atom.make((get) => {
+    const unsubscribe = Obj.subscribe(obj, () => {
+      get.setSelf(Obj.getSnapshot(obj));
+    });
+    get.addFinalizer(() => unsubscribe());
+    return Obj.getSnapshot(obj);
+  });
+});
+var refFamily = Atom.family((ref) => {
+  return Atom.make((get) => {
+    let unsubscribeTarget;
+    const setupTargetSubscription = (target) => {
+      unsubscribeTarget?.();
+      unsubscribeTarget = Obj.subscribe(target, () => {
+        get.setSelf(Obj.getSnapshot(target));
+      });
+      return Obj.getSnapshot(target);
+    };
+    get.addFinalizer(() => unsubscribeTarget?.());
+    return loadRefTarget(ref, get, setupTargetSubscription);
+  });
+});
+var snapshotForComparison = (value) => {
+  if (Array.isArray(value)) {
+    return [
+      ...value
+    ];
+  }
+  if (value !== null && typeof value === "object") {
+    return {
+      ...value
+    };
+  }
+  return value;
+};
+var propertyFamily = Atom.family((obj) => Atom.family((key) => {
+  return Atom.make((get) => {
+    let previousSnapshot = snapshotForComparison(obj[key]);
+    const unsubscribe = Obj.subscribe(obj, () => {
+      const newValue = obj[key];
+      if (!isEqual(previousSnapshot, newValue)) {
+        previousSnapshot = snapshotForComparison(newValue);
+        get.setSelf(snapshotForComparison(newValue));
+      }
+    });
+    get.addFinalizer(() => unsubscribe());
+    return snapshotForComparison(obj[key]);
+  });
+}));
+function make2(objOrRef) {
+  if (objOrRef === void 0) {
+    return Atom.make(() => void 0);
+  }
+  if (Ref.isRef(objOrRef)) {
+    return refFamily(objOrRef);
+  }
+  const obj = objOrRef;
+  assertArgument(Obj.isObject(obj), "obj", "Object must be a reactive object");
+  return objectFamily(obj);
+}
+function makeProperty(obj, key) {
+  if (obj === void 0) {
+    return Atom.make(() => void 0);
+  }
+  assertArgument(Obj.isObject(obj), "obj", "Object must be a reactive object");
+  assertArgument(key in obj, "key", "Property must exist on object");
+  return propertyFamily(obj)(key);
+}
+
+// src/query-atom.ts
+var query_atom_exports = {};
+__export(query_atom_exports, {
+  fromQuery: () => fromQuery,
+  make: () => make3
+});
+import { Atom as Atom2 } from "@effect-atom/atom";
+import { DXN, Database, Query } from "@dxos/echo";
+import { WeakDictionary } from "@dxos/util";
+var fromQuery = (queryResult) => Atom2.make((get) => {
+  const unsubscribe = queryResult.subscribe(() => {
+    get.setSelf(queryResult.results);
+  });
+  get.addFinalizer(unsubscribe);
+  return queryResult.results;
+});
+var queryableRegistry = new WeakDictionary();
+var KEY_SEPARATOR = "~";
+var queryFamily = Atom2.family((key) => {
+  const separatorIndex = key.indexOf(KEY_SEPARATOR);
+  const identifier = key.slice(0, separatorIndex);
+  const serializedAst = key.slice(separatorIndex + 1);
+  const queryable = queryableRegistry.get(identifier);
+  if (!queryable) {
+    return Atom2.make(() => []);
+  }
+  const ast = JSON.parse(serializedAst);
+  const queryResult = queryable.query(Query.fromAst(ast));
+  return Atom2.make((get) => {
+    const unsubscribe = queryResult.subscribe(() => {
+      get.setSelf(queryResult.results);
+    });
+    get.addFinalizer(unsubscribe);
+    return queryResult.results;
+  });
+});
+var getQueryableIdentifier = (queryable) => {
+  if (Database.isDatabase(queryable)) {
+    return queryable.spaceId;
+  }
+  if ("dxn" in queryable && queryable.dxn instanceof DXN) {
+    return queryable.dxn.toString();
+  }
+  if ("id" in queryable && typeof queryable.id === "string") {
+    return queryable.id;
+  }
+  throw new Error("Unable to derive identifier from queryable.");
+};
+var make3 = (queryable, queryOrFilter) => {
+  const identifier = getQueryableIdentifier(queryable);
+  return fromQueryable(queryable, identifier, queryOrFilter);
+};
+var fromQueryable = (queryable, identifier, queryOrFilter) => {
+  queryableRegistry.set(identifier, queryable);
+  const normalizedQuery = Query.is(queryOrFilter) ? queryOrFilter : Query.select(queryOrFilter);
+  const key = `${identifier}${KEY_SEPARATOR}${JSON.stringify(normalizedQuery.ast)}`;
+  return queryFamily(key);
+};
+
+// src/ref-atom.ts
+var ref_atom_exports = {};
+__export(ref_atom_exports, {
+  make: () => make5
+});
+import * as Atom3 from "@effect-atom/atom/Atom";
+var refFamily2 = Atom3.family((ref) => {
+  return Atom3.make((get) => {
+    return loadRefTarget(ref, get, (target) => target);
+  });
+});
+var make5 = refFamily2;
+export {
+  atom_exports as AtomObj,
+  query_atom_exports as AtomQuery,
+  ref_atom_exports as AtomRef
+};
+//# sourceMappingURL=index.mjs.map

package/dist/lib/browser/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/atom.ts", "../../../src/ref-utils.ts", "../../../src/query-atom.ts", "../../../src/ref-atom.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Atom from '@effect-atom/atom/Atom';\nimport isEqual from 'lodash.isequal';\n\nimport { Obj, Ref } from '@dxos/echo';\nimport { assertArgument } from '@dxos/invariant';\n\nimport { loadRefTarget } from './ref-utils';\n\n/**\n * Atom family for ECHO objects.\n * Uses object reference as key - same object returns same atom.\n */\nconst objectFamily = Atom.family(<T extends Obj.Unknown>(obj: T): Atom.Atom<Obj.Snapshot<T>> => {\n  return Atom.make<Obj.Snapshot<T>>((get) => {\n    const unsubscribe = Obj.subscribe(obj, () => {\n      get.setSelf(Obj.getSnapshot(obj));\n    });\n\n    get.addFinalizer(() => unsubscribe());\n\n    return Obj.getSnapshot(obj);\n  });\n});\n\n/**\n * Internal helper to create an atom from a Ref.\n * Handles async loading and subscribes to the target for reactive updates.\n * Uses Atom.family internally - same ref reference returns same atom instance.\n */\nconst refFamily = Atom.family(<T extends Obj.Unknown>(ref: Ref.Ref<T>): Atom.Atom<Obj.Snapshot<T> | undefined> => {\n  return Atom.make<Obj.Snapshot<T> | undefined>((get) => {\n    let unsubscribeTarget: (() => void) | undefined;\n\n    const setupTargetSubscription = (target: T): Obj.Snapshot<T> => {\n      unsubscribeTarget?.();\n      unsubscribeTarget = Obj.subscribe(target, () => {\n        get.setSelf(Obj.getSnapshot(target));\n      });\n      return Obj.getSnapshot(target);\n    };\n\n    get.addFinalizer(() => unsubscribeTarget?.());\n\n    return loadRefTarget(ref, get, setupTargetSubscription);\n  });\n});\n\n/**\n * Snapshot a value to create a new reference for comparison and React dependency tracking.\n * Arrays and plain objects are shallow-copied so that:\n * 1. The snapshot is isolated from mutations to the original value.\n * 2. React's shallow comparison (Object.is) detects changes via new reference identity.\n */\nconst snapshotForComparison = <V>(value: V): V => {\n  if (Array.isArray(value)) {\n    return [...value] as V;\n  }\n  if (value !== null && typeof value === 'object') {\n    return { ...value } as V;\n  }\n  return value;\n};\n\n/**\n * Atom family for ECHO object properties.\n * Uses nested families: outer keyed by object, inner keyed by property key.\n * Same object+key combination returns same atom instance.\n */\nconst propertyFamily = Atom.family(<T extends Obj.Unknown>(obj: T) =>\n  Atom.family(<K extends keyof T>(key: K): Atom.Atom<T[K]> => {\n    return Atom.make<T[K]>((get) => {\n      // Snapshot the initial value for comparison (arrays/objects need copying).\n      let previousSnapshot = snapshotForComparison(obj[key]);\n\n      const unsubscribe = Obj.subscribe(obj, () => {\n        const newValue = obj[key];\n        if (!isEqual(previousSnapshot, newValue)) {\n          previousSnapshot = snapshotForComparison(newValue);\n          // Return a snapshot copy so React sees a new reference.\n          get.setSelf(snapshotForComparison(newValue));\n        }\n      });\n\n      get.addFinalizer(() => unsubscribe());\n\n      // Return a snapshot copy so React sees a new reference.\n      return snapshotForComparison(obj[key]);\n    });\n  }),\n);\n\n/**\n * Create a read-only atom for a reactive object or ref.\n * Works with Echo objects, plain reactive objects (from Obj.make), and Refs.\n * Returns immutable snapshots of the object data (branded with SnapshotKindId).\n * The atom updates automatically when the object is mutated.\n * For refs, automatically handles async loading.\n * Uses Atom.family internally - same object/ref reference returns same atom instance.\n *\n * @param objOrRef - The reactive object or ref to create an atom for, or undefined.\n * @returns An atom that returns the object snapshot. Returns undefined only for refs (async loading) or undefined input.\n */\nexport function make<T extends Obj.Unknown>(obj: T): Atom.Atom<Obj.Snapshot<T>>;\nexport function make<T extends Obj.Unknown>(ref: Ref.Ref<T>): Atom.Atom<Obj.Snapshot<T> | undefined>;\nexport function make<T extends Obj.Unknown>(\n  objOrRef: T | Ref.Ref<T> | undefined,\n): Atom.Atom<Obj.Snapshot<T> | undefined>;\nexport function make<T extends Obj.Unknown>(\n  objOrRef: T | Ref.Ref<T> | undefined,\n): Atom.Atom<Obj.Snapshot<T> | undefined> {\n  if (objOrRef === undefined) {\n    return Atom.make<Obj.Snapshot<T> | undefined>(() => undefined);\n  }\n\n  // Handle Ref inputs.\n  if (Ref.isRef(objOrRef)) {\n    return refFamily(objOrRef as Ref.Ref<T>);\n  }\n\n  // At this point, objOrRef is definitely T (not a Ref).\n  const obj = objOrRef as T;\n  assertArgument(Obj.isObject(obj), 'obj', 'Object must be a reactive object');\n\n  return objectFamily(obj);\n}\n\n/**\n * Create a read-only atom for a specific property of a reactive object.\n * Works with both Echo objects (from createObject) and plain live objects (from Obj.make).\n * The atom updates automatically when the property is mutated.\n * Only fires updates when the property value actually changes.\n * Uses Atom.family internally - same object+key combination returns same atom instance.\n *\n * @param obj - The reactive object to create an atom for, or undefined.\n * @param key - The property key to subscribe to.\n * @returns An atom that returns the property value, or undefined if obj is undefined.\n */\nexport function makeProperty<T extends Obj.Unknown, K extends keyof T>(obj: T, key: K): Atom.Atom<T[K]>;\nexport function makeProperty<T extends Obj.Unknown, K extends keyof T>(\n  obj: T | undefined,\n  key: K,\n): Atom.Atom<T[K] | undefined>;\nexport function makeProperty<T extends Obj.Unknown, K extends keyof T>(\n  obj: T | undefined,\n  key: K,\n): Atom.Atom<T[K] | undefined> {\n  if (obj === undefined) {\n    return Atom.make<T[K] | undefined>(() => undefined);\n  }\n\n  assertArgument(Obj.isObject(obj), 'obj', 'Object must be a reactive object');\n  assertArgument(key in obj, 'key', 'Property must exist on object');\n  return propertyFamily(obj)(key);\n}\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport type * as Atom from '@effect-atom/atom/Atom';\n\nimport type { Ref } from '@dxos/echo';\n\n/**\n * Internal helper for loading ref targets in atoms.\n * Handles the common pattern of checking for loaded target and triggering async load.\n *\n * @param ref - The ref to load.\n * @param get - The atom context for setSelf.\n * @param onTargetAvailable - Callback invoked when target is available (sync or async).\n *   Should return the value to use for the atom.\n * @returns The result of onTargetAvailable if target is already loaded, undefined otherwise.\n */\nexport const loadRefTarget = <T, R>(\n  ref: Ref.Ref<T>,\n  get: Atom.Context,\n  onTargetAvailable: (target: T) => R,\n): R | undefined => {\n  const currentTarget = ref.target;\n  if (currentTarget) {\n    return onTargetAvailable(currentTarget);\n  }\n\n  // Target not loaded yet - trigger async load.\n  void ref\n    .load()\n    .then((loadedTarget) => {\n      get.setSelf(onTargetAvailable(loadedTarget));\n    })\n    .catch(() => {\n      // Loading failed, keep target as undefined.\n    });\n\n  return undefined;\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { Atom } from '@effect-atom/atom';\n\nimport { DXN, Database, type Entity, type Filter, Query, type QueryResult } from '@dxos/echo';\nimport { WeakDictionary } from '@dxos/util';\n\n/**\n * Create a self-updating atom from an existing QueryResult.\n * Internally subscribes to queryResult and uses get.setSelf to update.\n * Cleanup is handled via get.addFinalizer.\n *\n * Note: This creates a new atom each time. For memoization, use `make` instead.\n *\n * @param queryResult - The QueryResult to wrap.\n * @returns An atom that automatically updates when query results change.\n */\nexport const fromQuery = <T extends Entity.Unknown>(queryResult: QueryResult.QueryResult<T>): Atom.Atom<T[]> =>\n  Atom.make((get) => {\n    // TODO(wittjosiah): Consider subscribing to individual objects here as well, and grabbing their snapshots.\n    // Subscribe to QueryResult changes.\n    const unsubscribe = queryResult.subscribe(() => {\n      get.setSelf(queryResult.results);\n    });\n\n    // Register cleanup for when atom is no longer used.\n    get.addFinalizer(unsubscribe);\n\n    return queryResult.results;\n  });\n\n// Registry: key → Queryable (WeakRef with auto-cleanup when GC'd).\nconst queryableRegistry = new WeakDictionary<string, Database.Queryable>();\n\n// Key separator that won't appear in identifiers (DXN strings use colons).\nconst KEY_SEPARATOR = '~';\n\n// Atom.family keyed by \"identifier\\0serializedAST\".\nconst queryFamily = Atom.family((key: string) => {\n  // Parse key outside Atom.make - runs once per key.\n  const separatorIndex = key.indexOf(KEY_SEPARATOR);\n  const identifier = key.slice(0, separatorIndex);\n  const serializedAst = key.slice(separatorIndex + 1);\n\n  // Get queryable outside Atom.make - keeps Queryable alive via closure.\n  const queryable = queryableRegistry.get(identifier);\n  if (!queryable) {\n    return Atom.make(() => [] as Entity.Unknown[]);\n  }\n\n  // Create query outside Atom.make - runs once, not on every recompute.\n  const ast = JSON.parse(serializedAst);\n  const queryResult = queryable.query(Query.fromAst(ast)) as QueryResult.QueryResult<Entity.Unknown>;\n\n  return Atom.make((get) => {\n    const unsubscribe = queryResult.subscribe(() => {\n      get.setSelf(queryResult.results);\n    });\n    get.addFinalizer(unsubscribe);\n\n    return queryResult.results;\n  });\n});\n\n/**\n * Derive a stable identifier from a Queryable.\n * Supports Database (spaceId), Queue (dxn), and objects with id.\n */\nconst getQueryableIdentifier = (queryable: Database.Queryable): string => {\n  // Database: use spaceId.\n  if (Database.isDatabase(queryable)) {\n    return queryable.spaceId;\n  }\n  // Queue or similar: use dxn if it's a DXN instance.\n  if ('dxn' in queryable && queryable.dxn instanceof DXN) {\n    return queryable.dxn.toString();\n  }\n  // Fallback: use id if it's a string.\n  if ('id' in queryable && typeof queryable.id === 'string') {\n    return queryable.id;\n  }\n  throw new Error('Unable to derive identifier from queryable.');\n};\n\n/**\n * Get a memoized query atom for any Queryable (Database, Queue, etc.).\n * Uses a single Atom.family keyed by queryable identifier + serialized query AST.\n * Same queryable + query/filter = same atom instance (proper memoization).\n *\n * @param queryable - The queryable to query (Database, Queue, etc.).\n * @param queryOrFilter - A Query or Filter to execute.\n * @returns A memoized atom that updates when query results change.\n */\nexport const make = <T extends Entity.Unknown>(\n  queryable: Database.Queryable,\n  queryOrFilter: Query.Query<T> | Filter.Filter<T>,\n): Atom.Atom<T[]> => {\n  const identifier = getQueryableIdentifier(queryable);\n  return fromQueryable(queryable, identifier, queryOrFilter);\n};\n\n/**\n * Internal: Get a memoized query atom for any Queryable with a custom identifier.\n */\nconst fromQueryable = <T extends Entity.Unknown>(\n  queryable: Database.Queryable,\n  identifier: string,\n  queryOrFilter: Query.Query<T> | Filter.Filter<T>,\n): Atom.Atom<T[]> => {\n  // Register queryable in registry (WeakDictionary handles cleanup automatically).\n  queryableRegistry.set(identifier, queryable);\n\n  // Normalize to Query.\n  const normalizedQuery: Query.Any = Query.is(queryOrFilter)\n    ? queryOrFilter\n    : Query.select(queryOrFilter as Filter.Filter<T>);\n\n  // Build key: identifier\\0serializedAST (using null char as separator to avoid DXN colon conflicts).\n  const key = `${identifier}${KEY_SEPARATOR}${JSON.stringify(normalizedQuery.ast)}`;\n\n  return queryFamily(key) as Atom.Atom<T[]>;\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Atom from '@effect-atom/atom/Atom';\n\nimport { type Ref } from '@dxos/echo';\n\nimport { loadRefTarget } from './ref-utils';\n\n/**\n * Atom family for ECHO refs.\n * Uses ref reference as key - same ref returns same atom.\n * This atom only updates once when the ref loads - it does not subscribe to object changes.\n * Use AtomObj.make with a ref if you need reactive snapshots of ECHO objects.\n */\nconst refFamily = Atom.family(<T>(ref: Ref.Ref<T>): Atom.Atom<T | undefined> => {\n  return Atom.make<T | undefined>((get) => {\n    return loadRefTarget(ref, get, (target) => target);\n  });\n});\n\n/**\n * Create a read-only atom for a reference target.\n * Returns undefined if the target hasn't loaded yet.\n * Updates when the ref loads but does NOT subscribe to target object changes.\n * Use AtomObj.make with a ref if you need reactive snapshots of ECHO objects.\n * Uses Atom.family internally - same ref reference returns same atom instance.\n *\n * Supports refs to any target type including ECHO objects and Queues.\n */\nexport const make = refFamily;\n"],
+  "mappings": "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",
+  "names": ["make", "Atom", "isEqual", "Obj", "Ref", "assertArgument", "loadRefTarget", "ref", "get", "onTargetAvailable", "currentTarget", "target", "load", "then", "loadedTarget", "setSelf", "catch", "undefined", "objectFamily", "family", "obj", "make", "get", "unsubscribe", "Obj", "subscribe", "setSelf", "getSnapshot", "addFinalizer", "refFamily", "ref", "unsubscribeTarget", "setupTargetSubscription", "target", "loadRefTarget", "snapshotForComparison", "value", "Array", "isArray", "propertyFamily", "key", "previousSnapshot", "newValue", "isEqual", "objOrRef", "undefined", "Ref", "isRef", "assertArgument", "isObject", "makeProperty", "make", "Atom", "DXN", "Database", "Query", "WeakDictionary", "fromQuery", "queryResult", "Atom", "make", "get", "unsubscribe", "subscribe", "setSelf", "results", "addFinalizer", "queryableRegistry", "WeakDictionary", "KEY_SEPARATOR", "queryFamily", "family", "key", "separatorIndex", "indexOf", "identifier", "slice", "serializedAst", "queryable", "ast", "JSON", "parse", "query", "Query", "fromAst", "getQueryableIdentifier", "Database", "isDatabase", "spaceId", "dxn", "DXN", "toString", "id", "Error", "queryOrFilter", "fromQueryable", "set", "normalizedQuery", "is", "select", "stringify", "make", "Atom", "refFamily", "family", "ref", "make", "get", "loadRefTarget", "target"]
+}

package/dist/lib/browser/meta.json

@@ -0,0 +1 @@
+{"inputs":{"src/ref-utils.ts":{"bytes":3291,"imports":[],"format":"esm"},"src/atom.ts":{"bytes":14945,"imports":[{"path":"@effect-atom/atom/Atom","kind":"import-statement","external":true},{"path":"lodash.isequal","kind":"import-statement","external":true},{"path":"@dxos/echo","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"src/ref-utils.ts","kind":"import-statement","original":"./ref-utils"}],"format":"esm"},"src/query-atom.ts":{"bytes":13559,"imports":[{"path":"@effect-atom/atom","kind":"import-statement","external":true},{"path":"@dxos/echo","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true}],"format":"esm"},"src/ref-atom.ts":{"bytes":3183,"imports":[{"path":"@effect-atom/atom/Atom","kind":"import-statement","external":true},{"path":"src/ref-utils.ts","kind":"import-statement","original":"./ref-utils"}],"format":"esm"},"src/index.ts":{"bytes":816,"imports":[{"path":"src/atom.ts","kind":"import-statement","original":"./atom"},{"path":"src/query-atom.ts","kind":"import-statement","original":"./query-atom"},{"path":"src/ref-atom.ts","kind":"import-statement","original":"./ref-atom"}],"format":"esm"}},"outputs":{"dist/lib/browser/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":18123},"dist/lib/browser/index.mjs":{"imports":[{"path":"@effect-atom/atom/Atom","kind":"import-statement","external":true},{"path":"lodash.isequal","kind":"import-statement","external":true},{"path":"@dxos/echo","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@effect-atom/atom","kind":"import-statement","external":true},{"path":"@dxos/echo","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"@effect-atom/atom/Atom","kind":"import-statement","external":true}],"exports":["AtomObj","AtomQuery","AtomRef"],"entryPoint":"src/index.ts","inputs":{"src/atom.ts":{"bytesInOutput":2313},"src/ref-utils.ts":{"bytesInOutput":301},"src/index.ts":{"bytesInOutput":0},"src/query-atom.ts":{"bytesInOutput":2044},"src/ref-atom.ts":{"bytesInOutput":291}},"bytes":5350}}}

package/dist/lib/node-esm/index.mjs

@@ -0,0 +1,179 @@
+import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/atom.ts
+var atom_exports = {};
+__export(atom_exports, {
+  make: () => make2,
+  makeProperty: () => makeProperty
+});
+import * as Atom from "@effect-atom/atom/Atom";
+import isEqual from "lodash.isequal";
+import { Obj, Ref } from "@dxos/echo";
+import { assertArgument } from "@dxos/invariant";
+
+// src/ref-utils.ts
+var loadRefTarget = (ref, get, onTargetAvailable) => {
+  const currentTarget = ref.target;
+  if (currentTarget) {
+    return onTargetAvailable(currentTarget);
+  }
+  void ref.load().then((loadedTarget) => {
+    get.setSelf(onTargetAvailable(loadedTarget));
+  }).catch(() => {
+  });
+  return void 0;
+};
+
+// src/atom.ts
+var objectFamily = Atom.family((obj) => {
+  return Atom.make((get) => {
+    const unsubscribe = Obj.subscribe(obj, () => {
+      get.setSelf(Obj.getSnapshot(obj));
+    });
+    get.addFinalizer(() => unsubscribe());
+    return Obj.getSnapshot(obj);
+  });
+});
+var refFamily = Atom.family((ref) => {
+  return Atom.make((get) => {
+    let unsubscribeTarget;
+    const setupTargetSubscription = (target) => {
+      unsubscribeTarget?.();
+      unsubscribeTarget = Obj.subscribe(target, () => {
+        get.setSelf(Obj.getSnapshot(target));
+      });
+      return Obj.getSnapshot(target);
+    };
+    get.addFinalizer(() => unsubscribeTarget?.());
+    return loadRefTarget(ref, get, setupTargetSubscription);
+  });
+});
+var snapshotForComparison = (value) => {
+  if (Array.isArray(value)) {
+    return [
+      ...value
+    ];
+  }
+  if (value !== null && typeof value === "object") {
+    return {
+      ...value
+    };
+  }
+  return value;
+};
+var propertyFamily = Atom.family((obj) => Atom.family((key) => {
+  return Atom.make((get) => {
+    let previousSnapshot = snapshotForComparison(obj[key]);
+    const unsubscribe = Obj.subscribe(obj, () => {
+      const newValue = obj[key];
+      if (!isEqual(previousSnapshot, newValue)) {
+        previousSnapshot = snapshotForComparison(newValue);
+        get.setSelf(snapshotForComparison(newValue));
+      }
+    });
+    get.addFinalizer(() => unsubscribe());
+    return snapshotForComparison(obj[key]);
+  });
+}));
+function make2(objOrRef) {
+  if (objOrRef === void 0) {
+    return Atom.make(() => void 0);
+  }
+  if (Ref.isRef(objOrRef)) {
+    return refFamily(objOrRef);
+  }
+  const obj = objOrRef;
+  assertArgument(Obj.isObject(obj), "obj", "Object must be a reactive object");
+  return objectFamily(obj);
+}
+function makeProperty(obj, key) {
+  if (obj === void 0) {
+    return Atom.make(() => void 0);
+  }
+  assertArgument(Obj.isObject(obj), "obj", "Object must be a reactive object");
+  assertArgument(key in obj, "key", "Property must exist on object");
+  return propertyFamily(obj)(key);
+}
+
+// src/query-atom.ts
+var query_atom_exports = {};
+__export(query_atom_exports, {
+  fromQuery: () => fromQuery,
+  make: () => make3
+});
+import { Atom as Atom2 } from "@effect-atom/atom";
+import { DXN, Database, Query } from "@dxos/echo";
+import { WeakDictionary } from "@dxos/util";
+var fromQuery = (queryResult) => Atom2.make((get) => {
+  const unsubscribe = queryResult.subscribe(() => {
+    get.setSelf(queryResult.results);
+  });
+  get.addFinalizer(unsubscribe);
+  return queryResult.results;
+});
+var queryableRegistry = new WeakDictionary();
+var KEY_SEPARATOR = "~";
+var queryFamily = Atom2.family((key) => {
+  const separatorIndex = key.indexOf(KEY_SEPARATOR);
+  const identifier = key.slice(0, separatorIndex);
+  const serializedAst = key.slice(separatorIndex + 1);
+  const queryable = queryableRegistry.get(identifier);
+  if (!queryable) {
+    return Atom2.make(() => []);
+  }
+  const ast = JSON.parse(serializedAst);
+  const queryResult = queryable.query(Query.fromAst(ast));
+  return Atom2.make((get) => {
+    const unsubscribe = queryResult.subscribe(() => {
+      get.setSelf(queryResult.results);
+    });
+    get.addFinalizer(unsubscribe);
+    return queryResult.results;
+  });
+});
+var getQueryableIdentifier = (queryable) => {
+  if (Database.isDatabase(queryable)) {
+    return queryable.spaceId;
+  }
+  if ("dxn" in queryable && queryable.dxn instanceof DXN) {
+    return queryable.dxn.toString();
+  }
+  if ("id" in queryable && typeof queryable.id === "string") {
+    return queryable.id;
+  }
+  throw new Error("Unable to derive identifier from queryable.");
+};
+var make3 = (queryable, queryOrFilter) => {
+  const identifier = getQueryableIdentifier(queryable);
+  return fromQueryable(queryable, identifier, queryOrFilter);
+};
+var fromQueryable = (queryable, identifier, queryOrFilter) => {
+  queryableRegistry.set(identifier, queryable);
+  const normalizedQuery = Query.is(queryOrFilter) ? queryOrFilter : Query.select(queryOrFilter);
+  const key = `${identifier}${KEY_SEPARATOR}${JSON.stringify(normalizedQuery.ast)}`;
+  return queryFamily(key);
+};
+
+// src/ref-atom.ts
+var ref_atom_exports = {};
+__export(ref_atom_exports, {
+  make: () => make5
+});
+import * as Atom3 from "@effect-atom/atom/Atom";
+var refFamily2 = Atom3.family((ref) => {
+  return Atom3.make((get) => {
+    return loadRefTarget(ref, get, (target) => target);
+  });
+});
+var make5 = refFamily2;
+export {
+  atom_exports as AtomObj,
+  query_atom_exports as AtomQuery,
+  ref_atom_exports as AtomRef
+};
+//# sourceMappingURL=index.mjs.map

package/dist/lib/node-esm/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/atom.ts", "../../../src/ref-utils.ts", "../../../src/query-atom.ts", "../../../src/ref-atom.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Atom from '@effect-atom/atom/Atom';\nimport isEqual from 'lodash.isequal';\n\nimport { Obj, Ref } from '@dxos/echo';\nimport { assertArgument } from '@dxos/invariant';\n\nimport { loadRefTarget } from './ref-utils';\n\n/**\n * Atom family for ECHO objects.\n * Uses object reference as key - same object returns same atom.\n */\nconst objectFamily = Atom.family(<T extends Obj.Unknown>(obj: T): Atom.Atom<Obj.Snapshot<T>> => {\n  return Atom.make<Obj.Snapshot<T>>((get) => {\n    const unsubscribe = Obj.subscribe(obj, () => {\n      get.setSelf(Obj.getSnapshot(obj));\n    });\n\n    get.addFinalizer(() => unsubscribe());\n\n    return Obj.getSnapshot(obj);\n  });\n});\n\n/**\n * Internal helper to create an atom from a Ref.\n * Handles async loading and subscribes to the target for reactive updates.\n * Uses Atom.family internally - same ref reference returns same atom instance.\n */\nconst refFamily = Atom.family(<T extends Obj.Unknown>(ref: Ref.Ref<T>): Atom.Atom<Obj.Snapshot<T> | undefined> => {\n  return Atom.make<Obj.Snapshot<T> | undefined>((get) => {\n    let unsubscribeTarget: (() => void) | undefined;\n\n    const setupTargetSubscription = (target: T): Obj.Snapshot<T> => {\n      unsubscribeTarget?.();\n      unsubscribeTarget = Obj.subscribe(target, () => {\n        get.setSelf(Obj.getSnapshot(target));\n      });\n      return Obj.getSnapshot(target);\n    };\n\n    get.addFinalizer(() => unsubscribeTarget?.());\n\n    return loadRefTarget(ref, get, setupTargetSubscription);\n  });\n});\n\n/**\n * Snapshot a value to create a new reference for comparison and React dependency tracking.\n * Arrays and plain objects are shallow-copied so that:\n * 1. The snapshot is isolated from mutations to the original value.\n * 2. React's shallow comparison (Object.is) detects changes via new reference identity.\n */\nconst snapshotForComparison = <V>(value: V): V => {\n  if (Array.isArray(value)) {\n    return [...value] as V;\n  }\n  if (value !== null && typeof value === 'object') {\n    return { ...value } as V;\n  }\n  return value;\n};\n\n/**\n * Atom family for ECHO object properties.\n * Uses nested families: outer keyed by object, inner keyed by property key.\n * Same object+key combination returns same atom instance.\n */\nconst propertyFamily = Atom.family(<T extends Obj.Unknown>(obj: T) =>\n  Atom.family(<K extends keyof T>(key: K): Atom.Atom<T[K]> => {\n    return Atom.make<T[K]>((get) => {\n      // Snapshot the initial value for comparison (arrays/objects need copying).\n      let previousSnapshot = snapshotForComparison(obj[key]);\n\n      const unsubscribe = Obj.subscribe(obj, () => {\n        const newValue = obj[key];\n        if (!isEqual(previousSnapshot, newValue)) {\n          previousSnapshot = snapshotForComparison(newValue);\n          // Return a snapshot copy so React sees a new reference.\n          get.setSelf(snapshotForComparison(newValue));\n        }\n      });\n\n      get.addFinalizer(() => unsubscribe());\n\n      // Return a snapshot copy so React sees a new reference.\n      return snapshotForComparison(obj[key]);\n    });\n  }),\n);\n\n/**\n * Create a read-only atom for a reactive object or ref.\n * Works with Echo objects, plain reactive objects (from Obj.make), and Refs.\n * Returns immutable snapshots of the object data (branded with SnapshotKindId).\n * The atom updates automatically when the object is mutated.\n * For refs, automatically handles async loading.\n * Uses Atom.family internally - same object/ref reference returns same atom instance.\n *\n * @param objOrRef - The reactive object or ref to create an atom for, or undefined.\n * @returns An atom that returns the object snapshot. Returns undefined only for refs (async loading) or undefined input.\n */\nexport function make<T extends Obj.Unknown>(obj: T): Atom.Atom<Obj.Snapshot<T>>;\nexport function make<T extends Obj.Unknown>(ref: Ref.Ref<T>): Atom.Atom<Obj.Snapshot<T> | undefined>;\nexport function make<T extends Obj.Unknown>(\n  objOrRef: T | Ref.Ref<T> | undefined,\n): Atom.Atom<Obj.Snapshot<T> | undefined>;\nexport function make<T extends Obj.Unknown>(\n  objOrRef: T | Ref.Ref<T> | undefined,\n): Atom.Atom<Obj.Snapshot<T> | undefined> {\n  if (objOrRef === undefined) {\n    return Atom.make<Obj.Snapshot<T> | undefined>(() => undefined);\n  }\n\n  // Handle Ref inputs.\n  if (Ref.isRef(objOrRef)) {\n    return refFamily(objOrRef as Ref.Ref<T>);\n  }\n\n  // At this point, objOrRef is definitely T (not a Ref).\n  const obj = objOrRef as T;\n  assertArgument(Obj.isObject(obj), 'obj', 'Object must be a reactive object');\n\n  return objectFamily(obj);\n}\n\n/**\n * Create a read-only atom for a specific property of a reactive object.\n * Works with both Echo objects (from createObject) and plain live objects (from Obj.make).\n * The atom updates automatically when the property is mutated.\n * Only fires updates when the property value actually changes.\n * Uses Atom.family internally - same object+key combination returns same atom instance.\n *\n * @param obj - The reactive object to create an atom for, or undefined.\n * @param key - The property key to subscribe to.\n * @returns An atom that returns the property value, or undefined if obj is undefined.\n */\nexport function makeProperty<T extends Obj.Unknown, K extends keyof T>(obj: T, key: K): Atom.Atom<T[K]>;\nexport function makeProperty<T extends Obj.Unknown, K extends keyof T>(\n  obj: T | undefined,\n  key: K,\n): Atom.Atom<T[K] | undefined>;\nexport function makeProperty<T extends Obj.Unknown, K extends keyof T>(\n  obj: T | undefined,\n  key: K,\n): Atom.Atom<T[K] | undefined> {\n  if (obj === undefined) {\n    return Atom.make<T[K] | undefined>(() => undefined);\n  }\n\n  assertArgument(Obj.isObject(obj), 'obj', 'Object must be a reactive object');\n  assertArgument(key in obj, 'key', 'Property must exist on object');\n  return propertyFamily(obj)(key);\n}\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport type * as Atom from '@effect-atom/atom/Atom';\n\nimport type { Ref } from '@dxos/echo';\n\n/**\n * Internal helper for loading ref targets in atoms.\n * Handles the common pattern of checking for loaded target and triggering async load.\n *\n * @param ref - The ref to load.\n * @param get - The atom context for setSelf.\n * @param onTargetAvailable - Callback invoked when target is available (sync or async).\n *   Should return the value to use for the atom.\n * @returns The result of onTargetAvailable if target is already loaded, undefined otherwise.\n */\nexport const loadRefTarget = <T, R>(\n  ref: Ref.Ref<T>,\n  get: Atom.Context,\n  onTargetAvailable: (target: T) => R,\n): R | undefined => {\n  const currentTarget = ref.target;\n  if (currentTarget) {\n    return onTargetAvailable(currentTarget);\n  }\n\n  // Target not loaded yet - trigger async load.\n  void ref\n    .load()\n    .then((loadedTarget) => {\n      get.setSelf(onTargetAvailable(loadedTarget));\n    })\n    .catch(() => {\n      // Loading failed, keep target as undefined.\n    });\n\n  return undefined;\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { Atom } from '@effect-atom/atom';\n\nimport { DXN, Database, type Entity, type Filter, Query, type QueryResult } from '@dxos/echo';\nimport { WeakDictionary } from '@dxos/util';\n\n/**\n * Create a self-updating atom from an existing QueryResult.\n * Internally subscribes to queryResult and uses get.setSelf to update.\n * Cleanup is handled via get.addFinalizer.\n *\n * Note: This creates a new atom each time. For memoization, use `make` instead.\n *\n * @param queryResult - The QueryResult to wrap.\n * @returns An atom that automatically updates when query results change.\n */\nexport const fromQuery = <T extends Entity.Unknown>(queryResult: QueryResult.QueryResult<T>): Atom.Atom<T[]> =>\n  Atom.make((get) => {\n    // TODO(wittjosiah): Consider subscribing to individual objects here as well, and grabbing their snapshots.\n    // Subscribe to QueryResult changes.\n    const unsubscribe = queryResult.subscribe(() => {\n      get.setSelf(queryResult.results);\n    });\n\n    // Register cleanup for when atom is no longer used.\n    get.addFinalizer(unsubscribe);\n\n    return queryResult.results;\n  });\n\n// Registry: key → Queryable (WeakRef with auto-cleanup when GC'd).\nconst queryableRegistry = new WeakDictionary<string, Database.Queryable>();\n\n// Key separator that won't appear in identifiers (DXN strings use colons).\nconst KEY_SEPARATOR = '~';\n\n// Atom.family keyed by \"identifier\\0serializedAST\".\nconst queryFamily = Atom.family((key: string) => {\n  // Parse key outside Atom.make - runs once per key.\n  const separatorIndex = key.indexOf(KEY_SEPARATOR);\n  const identifier = key.slice(0, separatorIndex);\n  const serializedAst = key.slice(separatorIndex + 1);\n\n  // Get queryable outside Atom.make - keeps Queryable alive via closure.\n  const queryable = queryableRegistry.get(identifier);\n  if (!queryable) {\n    return Atom.make(() => [] as Entity.Unknown[]);\n  }\n\n  // Create query outside Atom.make - runs once, not on every recompute.\n  const ast = JSON.parse(serializedAst);\n  const queryResult = queryable.query(Query.fromAst(ast)) as QueryResult.QueryResult<Entity.Unknown>;\n\n  return Atom.make((get) => {\n    const unsubscribe = queryResult.subscribe(() => {\n      get.setSelf(queryResult.results);\n    });\n    get.addFinalizer(unsubscribe);\n\n    return queryResult.results;\n  });\n});\n\n/**\n * Derive a stable identifier from a Queryable.\n * Supports Database (spaceId), Queue (dxn), and objects with id.\n */\nconst getQueryableIdentifier = (queryable: Database.Queryable): string => {\n  // Database: use spaceId.\n  if (Database.isDatabase(queryable)) {\n    return queryable.spaceId;\n  }\n  // Queue or similar: use dxn if it's a DXN instance.\n  if ('dxn' in queryable && queryable.dxn instanceof DXN) {\n    return queryable.dxn.toString();\n  }\n  // Fallback: use id if it's a string.\n  if ('id' in queryable && typeof queryable.id === 'string') {\n    return queryable.id;\n  }\n  throw new Error('Unable to derive identifier from queryable.');\n};\n\n/**\n * Get a memoized query atom for any Queryable (Database, Queue, etc.).\n * Uses a single Atom.family keyed by queryable identifier + serialized query AST.\n * Same queryable + query/filter = same atom instance (proper memoization).\n *\n * @param queryable - The queryable to query (Database, Queue, etc.).\n * @param queryOrFilter - A Query or Filter to execute.\n * @returns A memoized atom that updates when query results change.\n */\nexport const make = <T extends Entity.Unknown>(\n  queryable: Database.Queryable,\n  queryOrFilter: Query.Query<T> | Filter.Filter<T>,\n): Atom.Atom<T[]> => {\n  const identifier = getQueryableIdentifier(queryable);\n  return fromQueryable(queryable, identifier, queryOrFilter);\n};\n\n/**\n * Internal: Get a memoized query atom for any Queryable with a custom identifier.\n */\nconst fromQueryable = <T extends Entity.Unknown>(\n  queryable: Database.Queryable,\n  identifier: string,\n  queryOrFilter: Query.Query<T> | Filter.Filter<T>,\n): Atom.Atom<T[]> => {\n  // Register queryable in registry (WeakDictionary handles cleanup automatically).\n  queryableRegistry.set(identifier, queryable);\n\n  // Normalize to Query.\n  const normalizedQuery: Query.Any = Query.is(queryOrFilter)\n    ? queryOrFilter\n    : Query.select(queryOrFilter as Filter.Filter<T>);\n\n  // Build key: identifier\\0serializedAST (using null char as separator to avoid DXN colon conflicts).\n  const key = `${identifier}${KEY_SEPARATOR}${JSON.stringify(normalizedQuery.ast)}`;\n\n  return queryFamily(key) as Atom.Atom<T[]>;\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Atom from '@effect-atom/atom/Atom';\n\nimport { type Ref } from '@dxos/echo';\n\nimport { loadRefTarget } from './ref-utils';\n\n/**\n * Atom family for ECHO refs.\n * Uses ref reference as key - same ref returns same atom.\n * This atom only updates once when the ref loads - it does not subscribe to object changes.\n * Use AtomObj.make with a ref if you need reactive snapshots of ECHO objects.\n */\nconst refFamily = Atom.family(<T>(ref: Ref.Ref<T>): Atom.Atom<T | undefined> => {\n  return Atom.make<T | undefined>((get) => {\n    return loadRefTarget(ref, get, (target) => target);\n  });\n});\n\n/**\n * Create a read-only atom for a reference target.\n * Returns undefined if the target hasn't loaded yet.\n * Updates when the ref loads but does NOT subscribe to target object changes.\n * Use AtomObj.make with a ref if you need reactive snapshots of ECHO objects.\n * Uses Atom.family internally - same ref reference returns same atom instance.\n *\n * Supports refs to any target type including ECHO objects and Queues.\n */\nexport const make = refFamily;\n"],
+  "mappings": "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",
+  "names": ["make", "Atom", "isEqual", "Obj", "Ref", "assertArgument", "loadRefTarget", "ref", "get", "onTargetAvailable", "currentTarget", "target", "load", "then", "loadedTarget", "setSelf", "catch", "undefined", "objectFamily", "family", "obj", "make", "get", "unsubscribe", "Obj", "subscribe", "setSelf", "getSnapshot", "addFinalizer", "refFamily", "ref", "unsubscribeTarget", "setupTargetSubscription", "target", "loadRefTarget", "snapshotForComparison", "value", "Array", "isArray", "propertyFamily", "key", "previousSnapshot", "newValue", "isEqual", "objOrRef", "undefined", "Ref", "isRef", "assertArgument", "isObject", "makeProperty", "make", "Atom", "DXN", "Database", "Query", "WeakDictionary", "fromQuery", "queryResult", "Atom", "make", "get", "unsubscribe", "subscribe", "setSelf", "results", "addFinalizer", "queryableRegistry", "WeakDictionary", "KEY_SEPARATOR", "queryFamily", "family", "key", "separatorIndex", "indexOf", "identifier", "slice", "serializedAst", "queryable", "ast", "JSON", "parse", "query", "Query", "fromAst", "getQueryableIdentifier", "Database", "isDatabase", "spaceId", "dxn", "DXN", "toString", "id", "Error", "queryOrFilter", "fromQueryable", "set", "normalizedQuery", "is", "select", "stringify", "make", "Atom", "refFamily", "family", "ref", "make", "get", "loadRefTarget", "target"]
+}

package/dist/lib/node-esm/meta.json

@@ -0,0 +1 @@
+{"inputs":{"src/ref-utils.ts":{"bytes":3291,"imports":[],"format":"esm"},"src/atom.ts":{"bytes":14945,"imports":[{"path":"@effect-atom/atom/Atom","kind":"import-statement","external":true},{"path":"lodash.isequal","kind":"import-statement","external":true},{"path":"@dxos/echo","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"src/ref-utils.ts","kind":"import-statement","original":"./ref-utils"}],"format":"esm"},"src/query-atom.ts":{"bytes":13559,"imports":[{"path":"@effect-atom/atom","kind":"import-statement","external":true},{"path":"@dxos/echo","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true}],"format":"esm"},"src/ref-atom.ts":{"bytes":3183,"imports":[{"path":"@effect-atom/atom/Atom","kind":"import-statement","external":true},{"path":"src/ref-utils.ts","kind":"import-statement","original":"./ref-utils"}],"format":"esm"},"src/index.ts":{"bytes":816,"imports":[{"path":"src/atom.ts","kind":"import-statement","original":"./atom"},{"path":"src/query-atom.ts","kind":"import-statement","original":"./query-atom"},{"path":"src/ref-atom.ts","kind":"import-statement","original":"./ref-atom"}],"format":"esm"}},"outputs":{"dist/lib/node-esm/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":18124},"dist/lib/node-esm/index.mjs":{"imports":[{"path":"@effect-atom/atom/Atom","kind":"import-statement","external":true},{"path":"lodash.isequal","kind":"import-statement","external":true},{"path":"@dxos/echo","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@effect-atom/atom","kind":"import-statement","external":true},{"path":"@dxos/echo","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"@effect-atom/atom/Atom","kind":"import-statement","external":true}],"exports":["AtomObj","AtomQuery","AtomRef"],"entryPoint":"src/index.ts","inputs":{"src/atom.ts":{"bytesInOutput":2313},"src/ref-utils.ts":{"bytesInOutput":301},"src/index.ts":{"bytesInOutput":0},"src/query-atom.ts":{"bytesInOutput":2044},"src/ref-atom.ts":{"bytesInOutput":291}},"bytes":5442}}}

package/dist/types/src/atom.d.ts

@@ -0,0 +1,30 @@
+import * as Atom from '@effect-atom/atom/Atom';
+import { Obj, Ref } from '@dxos/echo';
+/**
+ * Create a read-only atom for a reactive object or ref.
+ * Works with Echo objects, plain reactive objects (from Obj.make), and Refs.
+ * Returns immutable snapshots of the object data (branded with SnapshotKindId).
+ * The atom updates automatically when the object is mutated.
+ * For refs, automatically handles async loading.
+ * Uses Atom.family internally - same object/ref reference returns same atom instance.
+ *
+ * @param objOrRef - The reactive object or ref to create an atom for, or undefined.
+ * @returns An atom that returns the object snapshot. Returns undefined only for refs (async loading) or undefined input.
+ */
+export declare function make<T extends Obj.Unknown>(obj: T): Atom.Atom<Obj.Snapshot<T>>;
+export declare function make<T extends Obj.Unknown>(ref: Ref.Ref<T>): Atom.Atom<Obj.Snapshot<T> | undefined>;
+export declare function make<T extends Obj.Unknown>(objOrRef: T | Ref.Ref<T> | undefined): Atom.Atom<Obj.Snapshot<T> | undefined>;
+/**
+ * Create a read-only atom for a specific property of a reactive object.
+ * Works with both Echo objects (from createObject) and plain live objects (from Obj.make).
+ * The atom updates automatically when the property is mutated.
+ * Only fires updates when the property value actually changes.
+ * Uses Atom.family internally - same object+key combination returns same atom instance.
+ *
+ * @param obj - The reactive object to create an atom for, or undefined.
+ * @param key - The property key to subscribe to.
+ * @returns An atom that returns the property value, or undefined if obj is undefined.
+ */
+export declare function makeProperty<T extends Obj.Unknown, K extends keyof T>(obj: T, key: K): Atom.Atom<T[K]>;
+export declare function makeProperty<T extends Obj.Unknown, K extends keyof T>(obj: T | undefined, key: K): Atom.Atom<T[K] | undefined>;
+//# sourceMappingURL=atom.d.ts.map

package/dist/types/src/atom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atom.d.ts","sourceRoot":"","sources":["../../../src/atom.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,IAAI,MAAM,wBAAwB,CAAC;AAG/C,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAwFtC;;;;;;;;;;GAUG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AAChF,wBAAgB,IAAI,CAAC,CAAC,SAAS,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;AACrG,wBAAgB,IAAI,CAAC,CAAC,SAAS,GAAG,CAAC,OAAO,EACxC,QAAQ,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,SAAS,GACnC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;AAoB1C;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,GAAG,CAAC,OAAO,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACxG,wBAAgB,YAAY,CAAC,CAAC,SAAS,GAAG,CAAC,OAAO,EAAE,CAAC,SAAS,MAAM,CAAC,EACnE,GAAG,EAAE,CAAC,GAAG,SAAS,EAClB,GAAG,EAAE,CAAC,GACL,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC"}

package/dist/types/src/atom.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=atom.test.d.ts.map

package/dist/types/src/atom.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atom.test.d.ts","sourceRoot":"","sources":["../../../src/atom.test.ts"],"names":[],"mappings":""}

package/dist/types/src/batching.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=batching.test.d.ts.map

package/dist/types/src/batching.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batching.test.d.ts","sourceRoot":"","sources":["../../../src/batching.test.ts"],"names":[],"mappings":""}

package/dist/types/src/index.d.ts

@@ -0,0 +1,4 @@
+export * as AtomObj from './atom';
+export * as AtomQuery from './query-atom';
+export * as AtomRef from './ref-atom';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,OAAO,MAAM,QAAQ,CAAC;AAClC,OAAO,KAAK,SAAS,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,OAAO,MAAM,YAAY,CAAC"}

package/dist/types/src/query-atom.d.ts

@@ -0,0 +1,24 @@
+import { Atom } from '@effect-atom/atom';
+import { Database, type Entity, type Filter, Query, type QueryResult } from '@dxos/echo';
+/**
+ * Create a self-updating atom from an existing QueryResult.
+ * Internally subscribes to queryResult and uses get.setSelf to update.
+ * Cleanup is handled via get.addFinalizer.
+ *
+ * Note: This creates a new atom each time. For memoization, use `make` instead.
+ *
+ * @param queryResult - The QueryResult to wrap.
+ * @returns An atom that automatically updates when query results change.
+ */
+export declare const fromQuery: <T extends Entity.Unknown>(queryResult: QueryResult.QueryResult<T>) => Atom.Atom<T[]>;
+/**
+ * Get a memoized query atom for any Queryable (Database, Queue, etc.).
+ * Uses a single Atom.family keyed by queryable identifier + serialized query AST.
+ * Same queryable + query/filter = same atom instance (proper memoization).
+ *
+ * @param queryable - The queryable to query (Database, Queue, etc.).
+ * @param queryOrFilter - A Query or Filter to execute.
+ * @returns A memoized atom that updates when query results change.
+ */
+export declare const make: <T extends Entity.Unknown>(queryable: Database.Queryable, queryOrFilter: Query.Query<T> | Filter.Filter<T>) => Atom.Atom<T[]>;
+//# sourceMappingURL=query-atom.d.ts.map

package/dist/types/src/query-atom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-atom.d.ts","sourceRoot":"","sources":["../../../src/query-atom.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC,OAAO,EAAO,QAAQ,EAAE,KAAK,MAAM,EAAE,KAAK,MAAM,EAAE,KAAK,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9F;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,SAAS,MAAM,CAAC,OAAO,EAAE,aAAa,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC,KAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAYvG,CAAC;AAuDL;;;;;;;;GAQG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,SAAS,MAAM,CAAC,OAAO,EAC3C,WAAW,QAAQ,CAAC,SAAS,EAC7B,eAAe,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAC/C,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAGf,CAAC"}

package/dist/types/src/query-atom.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=query-atom.test.d.ts.map

package/dist/types/src/query-atom.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-atom.test.d.ts","sourceRoot":"","sources":["../../../src/query-atom.test.ts"],"names":[],"mappings":""}

package/dist/types/src/reactivity.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=reactivity.test.d.ts.map

package/dist/types/src/reactivity.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactivity.test.d.ts","sourceRoot":"","sources":["../../../src/reactivity.test.ts"],"names":[],"mappings":""}

package/dist/types/src/ref-atom.d.ts

@@ -0,0 +1,13 @@
+import * as Atom from '@effect-atom/atom/Atom';
+import { type Ref } from '@dxos/echo';
+/**
+ * Create a read-only atom for a reference target.
+ * Returns undefined if the target hasn't loaded yet.
+ * Updates when the ref loads but does NOT subscribe to target object changes.
+ * Use AtomObj.make with a ref if you need reactive snapshots of ECHO objects.
+ * Uses Atom.family internally - same ref reference returns same atom instance.
+ *
+ * Supports refs to any target type including ECHO objects and Queues.
+ */
+export declare const make: <T>(arg: Ref.Ref<T>) => Atom.Atom<T | undefined>;
+//# sourceMappingURL=ref-atom.d.ts.map

package/dist/types/src/ref-atom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-atom.d.ts","sourceRoot":"","sources":["../../../src/ref-atom.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,IAAI,MAAM,wBAAwB,CAAC;AAE/C,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAgBtC;;;;;;;;GAQG;AACH,eAAO,MAAM,IAAI,GAfc,CAAC,8CAeH,CAAC"}

package/dist/types/src/ref-atom.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ref-atom.test.d.ts.map

package/dist/types/src/ref-atom.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-atom.test.d.ts","sourceRoot":"","sources":["../../../src/ref-atom.test.ts"],"names":[],"mappings":""}

package/dist/types/src/ref-utils.d.ts

@@ -0,0 +1,14 @@
+import type * as Atom from '@effect-atom/atom/Atom';
+import type { Ref } from '@dxos/echo';
+/**
+ * Internal helper for loading ref targets in atoms.
+ * Handles the common pattern of checking for loaded target and triggering async load.
+ *
+ * @param ref - The ref to load.
+ * @param get - The atom context for setSelf.
+ * @param onTargetAvailable - Callback invoked when target is available (sync or async).
+ *   Should return the value to use for the atom.
+ * @returns The result of onTargetAvailable if target is already loaded, undefined otherwise.
+ */
+export declare const loadRefTarget: <T, R>(ref: Ref.Ref<T>, get: Atom.Context, onTargetAvailable: (target: T) => R) => R | undefined;
+//# sourceMappingURL=ref-utils.d.ts.map

package/dist/types/src/ref-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-utils.d.ts","sourceRoot":"","sources":["../../../src/ref-utils.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,IAAI,MAAM,wBAAwB,CAAC;AAEpD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,CAAC,EAChC,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EACf,KAAK,IAAI,CAAC,OAAO,EACjB,mBAAmB,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,KAClC,CAAC,GAAG,SAiBN,CAAC"}