@dxos/graph 0.7.5-labs.e27f9b9 → 0.7.5-main.2567c87

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

@@ -1,18 +1,15 @@
 import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
 
-// packages/common/graph/src/model.ts
-import { inspectCustom } from "@dxos/debug";
-import { failedInvariant, invariant as invariant2 } from "@dxos/invariant";
-import { getSnapshot } from "@dxos/live-object";
-import { isNotFalsy, removeBy, stripUndefined } from "@dxos/util";
-
-// packages/common/graph/src/util.ts
+// packages/common/graph/src/buidler.ts
 import { FormatEnum } from "@dxos/echo-schema";
 import { invariant } from "@dxos/invariant";
-import { getSchema, create } from "@dxos/live-object";
+import { getSchema } from "@dxos/live-object";
 import { log } from "@dxos/log";
 import { getSchemaProperties } from "@dxos/schema";
 
+// packages/common/graph/src/graph.ts
+import { create } from "@dxos/live-object";
+
 // packages/common/graph/src/types.ts
 import { S } from "@dxos/echo-schema";
 var BaseGraphNode = S.Struct({
@@ -23,140 +20,43 @@ var BaseGraphNode = S.Struct({
 var BaseGraphEdge = S.Struct({
   id: S.String,
   type: S.optional(S.String),
-  data: S.optional(S.Any),
   source: S.String,
-  target: S.String
+  target: S.String,
+  data: S.optional(S.Any)
 });
-var ExtendableBaseGraphNode = S.extend(BaseGraphNode, S.Struct({}, {
-  key: S.String,
-  value: S.Any
-}));
 var Graph = S.Struct({
-  id: S.optional(S.String),
-  nodes: S.mutable(S.Array(ExtendableBaseGraphNode)),
+  nodes: S.mutable(S.Array(BaseGraphNode)),
   edges: S.mutable(S.Array(BaseGraphEdge))
 });
+var emptyGraph = {
+  nodes: [],
+  edges: []
+};
 
 // packages/common/graph/src/util.ts
-var __dxlog_file = "/home/runner/work/dxos/dxos/packages/common/graph/src/util.ts";
-var KEY_REGEX = /\w+/;
-var createEdgeId = ({ source, target, relation }) => {
-  invariant(source.match(KEY_REGEX), `invalid source: ${source}`, {
-    F: __dxlog_file,
-    L: 21,
-    S: void 0,
-    A: [
-      "source.match(KEY_REGEX)",
-      "`invalid source: ${source}`"
-    ]
-  });
-  invariant(target.match(KEY_REGEX), `invalid target: ${target}`, {
-    F: __dxlog_file,
-    L: 22,
-    S: void 0,
-    A: [
-      "target.match(KEY_REGEX)",
-      "`invalid target: ${target}`"
-    ]
-  });
-  return [
-    source,
-    relation,
-    target
-  ].join("_");
-};
-var parseEdgeId = (id) => {
-  const [source, relation, target] = id.split("_");
-  invariant(source.length && target.length, void 0, {
-    F: __dxlog_file,
-    L: 28,
-    S: void 0,
-    A: [
-      "source.length && target.length",
-      ""
-    ]
-  });
-  return {
-    source,
-    relation: relation.length ? relation : void 0,
-    target
-  };
-};
-var createGraph = (objects) => {
-  const graph = new GraphModel(create(Graph, {
-    nodes: [],
-    edges: []
-  }));
-  objects.forEach((object) => {
-    graph.addNode({
-      id: object.id,
-      type: object.typename,
-      data: object
-    });
-  });
-  objects.forEach((object) => {
-    const schema = getSchema(object);
-    if (!schema) {
-      log.info("no schema for object", {
-        id: object.id.slice(0, 8)
-      }, {
-        F: __dxlog_file,
-        L: 48,
-        S: void 0,
-        C: (f, a) => f(...a)
-      });
-      return;
+var removeElements = (array, predicate) => {
+  const deleted = [];
+  for (let i = array.length - 1; i >= 0; i--) {
+    if (predicate(array[i], i)) {
+      deleted.push(...array.splice(i, 1));
     }
-    for (const prop of getSchemaProperties(schema.ast, object)) {
-      if (prop.format === FormatEnum.Ref) {
-        const source = object;
-        const target = object[prop.name]?.target;
-        if (target) {
-          graph.addEdge({
-            id: createEdgeId({
-              source: source.id,
-              target: target.id,
-              relation: String(prop.name)
-            }),
-            source: source.id,
-            target: target.id
-          });
-        }
-      }
-    }
-  });
-  return graph;
+  }
+  return deleted;
 };
 
-// packages/common/graph/src/model.ts
-var __dxlog_file2 = "/home/runner/work/dxos/dxos/packages/common/graph/src/model.ts";
+// packages/common/graph/src/graph.ts
 var ReadonlyGraphModel = class {
-  /**
-  * NOTE: Pass in simple Graph or ReactiveObject.
-  */
-  constructor(graph) {
-    this._graph = graph ?? {
-      nodes: [],
-      edges: []
-    };
-  }
-  [inspectCustom]() {
-    return this.toJSON();
-  }
-  /**
-  * Return stable sorted JSON representation of graph.
-  */
-  // TODO(burdon): Create separate toJson method with computed signal.
-  toJSON() {
-    const { id, nodes, edges } = getSnapshot(this._graph);
-    nodes.sort(({ id: a }, { id: b }) => a.localeCompare(b));
-    edges.sort(({ id: a }, { id: b }) => a.localeCompare(b));
-    return stripUndefined({
-      id,
+  constructor({ nodes = [], edges = [] } = {}) {
+    this._graph = create(Graph, {
       nodes,
       edges
     });
   }
+  toJSON() {
+    this._graph.nodes.sort(({ id: a }, { id: b }) => a.localeCompare(b));
+    this._graph.edges.sort(({ id: a }, { id: b }) => a.localeCompare(b));
+    return JSON.parse(JSON.stringify(this._graph));
+  }
   get graph() {
     return this._graph;
   }
@@ -166,51 +66,20 @@ var ReadonlyGraphModel = class {
   get edges() {
     return this._graph.edges;
   }
-  //
-  // Nodes
-  //
-  findNode(id) {
-    return this.nodes.find((node) => node.id === id);
-  }
   getNode(id) {
-    return this.findNode(id) ?? failedInvariant();
+    return this.nodes.find((node) => node.id === id);
   }
-  filterNodes({ type } = {}) {
+  getNodes({ type }) {
     return this.nodes.filter((node) => !type || type === node.type);
   }
-  //
-  // Edges
-  //
-  findEdge(id) {
-    return this.edges.find((edge) => edge.id === id);
-  }
   getEdge(id) {
-    return this.findEdge(id) ?? failedInvariant();
+    return this.edges.find((edge) => edge.id === id);
   }
-  filterEdges({ type, source, target } = {}) {
+  getEdges({ type, source, target }) {
     return this.edges.filter((edge) => (!type || type === edge.type) && (!source || source === edge.source) && (!target || target === edge.target));
   }
-  //
-  // Traverse
-  //
-  traverse(root) {
-    return this._traverse(root);
-  }
-  _traverse(root, visited = /* @__PURE__ */ new Set()) {
-    if (visited.has(root.id)) {
-      return [];
-    }
-    visited.add(root.id);
-    const targets = this.filterEdges({
-      source: root.id
-    }).map((edge) => this.getNode(edge.target)).filter(isNotFalsy);
-    return [
-      root,
-      ...targets.flatMap((target) => this._traverse(target, visited))
-    ];
-  }
 };
-var AbstractGraphModel = class extends ReadonlyGraphModel {
+var GraphModel = class _GraphModel extends ReadonlyGraphModel {
   clear() {
     this._graph.nodes.length = 0;
     this._graph.edges.length = 0;
@@ -229,153 +98,117 @@ var AbstractGraphModel = class extends ReadonlyGraphModel {
     return this;
   }
   addNode(node) {
-    invariant2(node.id, "ID is required", {
-      F: __dxlog_file2,
-      L: 153,
-      S: this,
-      A: [
-        "node.id",
-        "'ID is required'"
-      ]
-    });
-    invariant2(!this.findNode(node.id), `node already exists: ${node.id}`, {
-      F: __dxlog_file2,
-      L: 154,
-      S: this,
-      A: [
-        "!this.findNode(node.id)",
-        "`node already exists: ${node.id}`"
-      ]
-    });
     this._graph.nodes.push(node);
-    return node;
+    return this;
   }
   addNodes(nodes) {
-    return nodes.map((node) => this.addNode(node));
+    nodes.forEach((node) => this.addNode(node));
+    return this;
   }
   addEdge(edge) {
-    invariant2(edge.source, void 0, {
-      F: __dxlog_file2,
-      L: 164,
-      S: this,
-      A: [
-        "edge.source",
-        ""
-      ]
-    });
-    invariant2(edge.target, void 0, {
-      F: __dxlog_file2,
-      L: 165,
-      S: this,
-      A: [
-        "edge.target",
-        ""
-      ]
-    });
-    if (!edge.id) {
-      edge = {
-        id: createEdgeId(edge),
-        ...edge
-      };
-    }
-    invariant2(!this.findNode(edge.id), void 0, {
-      F: __dxlog_file2,
-      L: 170,
-      S: this,
-      A: [
-        "!this.findNode(edge.id!)",
-        ""
-      ]
-    });
     this._graph.edges.push(edge);
-    return edge;
+    return this;
   }
   addEdges(edges) {
-    return edges.map((edge) => this.addEdge(edge));
+    edges.forEach((edge) => this.addEdge(edge));
+    return this;
   }
+  // TODO(burdon): Return graph.
   removeNode(id) {
-    const nodes = removeBy(this._graph.nodes, (node) => node.id === id);
-    const edges = removeBy(this._graph.edges, (edge) => edge.source === id || edge.target === id);
-    return this.copy({
+    const nodes = removeElements(this._graph.nodes, (node) => node.id === id);
+    const edges = removeElements(this._graph.edges, (edge) => edge.source === id || edge.target === id);
+    return new _GraphModel({
       nodes,
       edges
     });
   }
   removeNodes(ids) {
     const graphs = ids.map((id) => this.removeNode(id));
-    return this.copy().addGraphs(graphs);
+    return new _GraphModel().addGraphs(graphs);
   }
   removeEdge(id) {
-    const edges = removeBy(this._graph.edges, (edge) => edge.id === id);
-    return this.copy({
-      nodes: [],
+    const edges = removeElements(this._graph.edges, (edge) => edge.id === id);
+    return new _GraphModel({
       edges
     });
   }
   removeEdges(ids) {
     const graphs = ids.map((id) => this.removeEdge(id));
-    return this.copy().addGraphs(graphs);
+    return new _GraphModel().addGraphs(graphs);
   }
 };
-var AbstractGraphBuilder = class {
-  constructor(_model) {
-    this._model = _model;
-  }
-  get model() {
-    return this._model;
-  }
-  call(cb) {
-    cb(this);
-    return this;
-  }
-  getNode(id) {
-    return this.model.getNode(id);
-  }
-  addNode(node) {
-    this._model.addNode(node);
-    return this;
-  }
-  addEdge(edge) {
-    this._model.addEdge(edge);
-    return this;
-  }
-  addNodes(nodes) {
-    this._model.addNodes(nodes);
-    return this;
-  }
-  addEdges(edges) {
-    this._model.addEdges(edges);
-    return this;
-  }
+
+// packages/common/graph/src/buidler.ts
+var __dxlog_file = "/home/runner/work/dxos/dxos/packages/common/graph/src/buidler.ts";
+var createEdgeId = ({ source, target, relation }) => `${source}-${relation}-${target}`;
+var parseEdgeId = (id) => {
+  const [source, relation, target] = id.split("-");
+  invariant(source && target && relation, void 0, {
+    F: __dxlog_file,
+    L: 22,
+    S: void 0,
+    A: [
+      "source && target && relation",
+      ""
+    ]
+  });
+  return {
+    source,
+    relation,
+    target
+  };
 };
-var GraphModel = class _GraphModel extends AbstractGraphModel {
-  get builder() {
-    return new GraphBuilder(this);
-  }
-  copy(graph) {
-    return new _GraphModel({
-      nodes: graph?.nodes ?? [],
-      edges: graph?.edges ?? []
+var createGraph = (objects) => {
+  const graph = new GraphModel();
+  objects.forEach((object) => {
+    graph.addNode({
+      id: object.id,
+      type: object.typename,
+      data: object
     });
-  }
-};
-var GraphBuilder = class extends AbstractGraphBuilder {
-  call(cb) {
-    cb(this);
-    return this;
-  }
+  });
+  objects.forEach((object) => {
+    const schema = getSchema(object);
+    if (!schema) {
+      log.info("no schema for object", {
+        id: object.id.slice(0, 8)
+      }, {
+        F: __dxlog_file,
+        L: 41,
+        S: void 0,
+        C: (f, a) => f(...a)
+      });
+      return;
+    }
+    for (const prop of getSchemaProperties(schema.ast, object)) {
+      if (prop.format === FormatEnum.Ref) {
+        const source = object;
+        const target = object[prop.name]?.target;
+        if (target) {
+          graph.addEdge({
+            id: createEdgeId({
+              source: source.id,
+              target: target.id,
+              relation: String(prop.name)
+            }),
+            source: source.id,
+            target: target.id
+          });
+        }
+      }
+    }
+  });
+  return graph;
 };
 export {
-  AbstractGraphBuilder,
-  AbstractGraphModel,
   BaseGraphEdge,
   BaseGraphNode,
   Graph,
-  GraphBuilder,
   GraphModel,
   ReadonlyGraphModel,
   createEdgeId,
   createGraph,
+  emptyGraph,
   parseEdgeId
 };
 //# sourceMappingURL=index.mjs.map

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../../src/model.ts", "../../../src/util.ts", "../../../src/types.ts"],
-  "sourcesContent": ["//\n// Copyright 2024 DXOS.org\n//\n\nimport { inspectCustom } from '@dxos/debug';\nimport { failedInvariant, invariant } from '@dxos/invariant';\nimport { getSnapshot } from '@dxos/live-object';\nimport { type MakeOptional, isNotFalsy, removeBy, stripUndefined } from '@dxos/util';\n\nimport { type Graph, type GraphNode, type GraphEdge, type BaseGraphNode, type BaseGraphEdge } from './types';\nimport { createEdgeId } from './util';\n\n/**\n * Wrapper class contains reactive nodes and edges.\n */\nexport class ReadonlyGraphModel<\n  Node extends BaseGraphNode = BaseGraphNode,\n  Edge extends BaseGraphEdge = BaseGraphEdge,\n> {\n  protected readonly _graph: Graph;\n\n  /**\n   * NOTE: Pass in simple Graph or ReactiveObject.\n   */\n  constructor(graph?: Graph) {\n    this._graph = graph ?? { nodes: [], edges: [] };\n  }\n\n  [inspectCustom]() {\n    return this.toJSON();\n  }\n\n  /**\n   * Return stable sorted JSON representation of graph.\n   */\n  // TODO(burdon): Create separate toJson method with computed signal.\n  toJSON() {\n    const { id, nodes, edges } = getSnapshot(this._graph);\n    nodes.sort(({ id: a }, { id: b }) => a.localeCompare(b));\n    edges.sort(({ id: a }, { id: b }) => a.localeCompare(b));\n    return stripUndefined({ id, nodes, edges });\n  }\n\n  get graph(): Graph {\n    return this._graph;\n  }\n\n  get nodes(): Node[] {\n    return this._graph.nodes as Node[];\n  }\n\n  get edges(): Edge[] {\n    return this._graph.edges as Edge[];\n  }\n\n  //\n  // Nodes\n  //\n\n  findNode(id: string): Node | undefined {\n    return this.nodes.find((node) => node.id === id);\n  }\n\n  getNode(id: string): Node {\n    return this.findNode(id) ?? failedInvariant();\n  }\n\n  filterNodes({ type }: Partial<GraphNode> = {}): Node[] {\n    return this.nodes.filter((node) => !type || type === node.type);\n  }\n\n  //\n  // Edges\n  //\n\n  findEdge(id: string): Edge | undefined {\n    return this.edges.find((edge) => edge.id === id);\n  }\n\n  getEdge(id: string): Edge {\n    return this.findEdge(id) ?? failedInvariant();\n  }\n\n  filterEdges({ type, source, target }: Partial<GraphEdge> = {}): Edge[] {\n    return this.edges.filter(\n      (edge) =>\n        (!type || type === edge.type) && (!source || source === edge.source) && (!target || target === edge.target),\n    );\n  }\n\n  //\n  // Traverse\n  //\n\n  traverse(root: Node): Node[] {\n    return this._traverse(root);\n  }\n\n  private _traverse(root: Node, visited: Set<string> = new Set()): Node[] {\n    if (visited.has(root.id)) {\n      return [];\n    }\n\n    visited.add(root.id);\n    const targets = this.filterEdges({ source: root.id })\n      .map((edge) => this.getNode(edge.target))\n      .filter(isNotFalsy);\n\n    return [root, ...targets.flatMap((target) => this._traverse(target, visited))];\n  }\n}\n\n/**\n * Typed wrapper.\n */\nexport abstract class AbstractGraphModel<\n  Node extends BaseGraphNode,\n  Edge extends BaseGraphEdge,\n  Model extends AbstractGraphModel<Node, Edge, Model, Builder>,\n  Builder extends AbstractGraphBuilder<Node, Edge, Model>,\n> extends ReadonlyGraphModel<Node, Edge> {\n  /**\n   * Allows chaining.\n   */\n  abstract get builder(): Builder;\n\n  /**\n   * Shallow copy of provided graph.\n   */\n  abstract copy(graph?: Partial<Graph>): Model;\n\n  clear(): this {\n    this._graph.nodes.length = 0;\n    this._graph.edges.length = 0;\n    return this;\n  }\n\n  addGraph(graph: Model): this {\n    this.addNodes(graph.nodes);\n    this.addEdges(graph.edges);\n    return this;\n  }\n\n  addGraphs(graphs: Model[]): this {\n    graphs.forEach((graph) => {\n      this.addNodes(graph.nodes);\n      this.addEdges(graph.edges);\n    });\n    return this;\n  }\n\n  addNode(node: Node): Node {\n    invariant(node.id, 'ID is required');\n    invariant(!this.findNode(node.id), `node already exists: ${node.id}`);\n    this._graph.nodes.push(node);\n    return node;\n  }\n\n  addNodes(nodes: Node[]): Node[] {\n    return nodes.map((node) => this.addNode(node));\n  }\n\n  addEdge(edge: MakeOptional<Edge, 'id'>): Edge {\n    invariant(edge.source);\n    invariant(edge.target);\n    if (!edge.id) {\n      // TODO(burdon): Generate random id.\n      edge = { id: createEdgeId(edge), ...edge };\n    }\n    invariant(!this.findNode(edge.id!));\n    this._graph.edges.push(edge as Edge);\n    return edge as Edge;\n  }\n\n  addEdges(edges: Edge[]): Edge[] {\n    return edges.map((edge) => this.addEdge(edge));\n  }\n\n  removeNode(id: string): Model {\n    const nodes = removeBy<Node>(this._graph.nodes as Node[], (node) => node.id === id);\n    const edges = removeBy<Edge>(this._graph.edges as Edge[], (edge) => edge.source === id || edge.target === id);\n    return this.copy({ nodes, edges });\n  }\n\n  removeNodes(ids: string[]): Model {\n    const graphs = ids.map((id) => this.removeNode(id));\n    return this.copy().addGraphs(graphs);\n  }\n\n  removeEdge(id: string): Model {\n    const edges = removeBy<Edge>(this._graph.edges as Edge[], (edge) => edge.id === id);\n    return this.copy({ nodes: [], edges });\n  }\n\n  removeEdges(ids: string[]): Model {\n    const graphs = ids.map((id) => this.removeEdge(id));\n    return this.copy().addGraphs(graphs);\n  }\n}\n\n/**\n * Chainable wrapper\n */\nexport abstract class AbstractGraphBuilder<\n  Node extends BaseGraphNode,\n  Edge extends BaseGraphEdge,\n  Model extends GraphModel<Node, Edge>,\n> {\n  constructor(protected readonly _model: Model) {}\n\n  get model(): Model {\n    return this._model;\n  }\n\n  call(cb: (builder: this) => void): this {\n    cb(this);\n    return this;\n  }\n\n  getNode(id: string): Node {\n    return this.model.getNode(id);\n  }\n\n  addNode(node: Node): this {\n    this._model.addNode(node);\n    return this;\n  }\n\n  addEdge(edge: MakeOptional<Edge, 'id'>): this {\n    this._model.addEdge(edge);\n    return this;\n  }\n\n  addNodes(nodes: Node[]): this {\n    this._model.addNodes(nodes);\n    return this;\n  }\n\n  addEdges(edges: Edge[]): this {\n    this._model.addEdges(edges);\n    return this;\n  }\n}\n\nexport class GraphModel<\n  Node extends BaseGraphNode = BaseGraphNode,\n  Edge extends BaseGraphEdge = BaseGraphEdge,\n> extends AbstractGraphModel<Node, Edge, GraphModel<Node, Edge>, GraphBuilder<Node, Edge>> {\n  override get builder() {\n    return new GraphBuilder<Node, Edge>(this);\n  }\n\n  override copy(graph?: Partial<Graph>) {\n    return new GraphModel<Node, Edge>({ nodes: graph?.nodes ?? [], edges: graph?.edges ?? [] });\n  }\n}\n\nexport class GraphBuilder<\n  Node extends BaseGraphNode = BaseGraphNode,\n  Edge extends BaseGraphEdge = BaseGraphEdge,\n> extends AbstractGraphBuilder<Node, Edge, GraphModel<Node, Edge>> {\n  override call(cb: (builder: this) => void) {\n    cb(this);\n    return this;\n  }\n}\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { type ReactiveEchoObject } from '@dxos/echo-db';\nimport { FormatEnum } from '@dxos/echo-schema';\nimport { invariant } from '@dxos/invariant';\nimport { getSchema, create } from '@dxos/live-object';\nimport { log } from '@dxos/log';\nimport { getSchemaProperties } from '@dxos/schema';\n\nimport { GraphModel } from './model';\nimport { Graph, type GraphNode } from './types';\n\nconst KEY_REGEX = /\\w+/;\n\n// NOTE: The `relation` is different from the `type`.\ntype EdgeMeta = { source: string; target: string; relation?: string };\n\nexport const createEdgeId = ({ source, target, relation }: EdgeMeta) => {\n  invariant(source.match(KEY_REGEX), `invalid source: ${source}`);\n  invariant(target.match(KEY_REGEX), `invalid target: ${target}`);\n  return [source, relation, target].join('_');\n};\n\nexport const parseEdgeId = (id: string): EdgeMeta => {\n  const [source, relation, target] = id.split('_');\n  invariant(source.length && target.length);\n  return { source, relation: relation.length ? relation : undefined, target };\n};\n\n/**\n * Creates a new reactive graph from a set of ECHO objects.\n * References are mapped onto graph edges.\n */\nexport const createGraph = (objects: ReactiveEchoObject<any>[]): GraphModel<GraphNode<ReactiveEchoObject<any>>> => {\n  const graph = new GraphModel<GraphNode<ReactiveEchoObject<any>>>(create(Graph, { nodes: [], edges: [] }));\n\n  // Map objects.\n  objects.forEach((object) => {\n    graph.addNode({ id: object.id, type: object.typename, data: object });\n  });\n\n  // Find references.\n  objects.forEach((object) => {\n    const schema = getSchema(object);\n    if (!schema) {\n      log.info('no schema for object', { id: object.id.slice(0, 8) });\n      return;\n    }\n\n    // Parse schema to follow referenced objects.\n    for (const prop of getSchemaProperties(schema.ast, object)) {\n      if (prop.format === FormatEnum.Ref) {\n        const source = object;\n        const target = object[prop.name]?.target;\n        if (target) {\n          graph.addEdge({\n            id: createEdgeId({ source: source.id, target: target.id, relation: String(prop.name) }),\n            source: source.id,\n            target: target.id,\n          });\n        }\n      }\n    }\n  });\n\n  return graph;\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { S } from '@dxos/echo-schema';\nimport { type Specialize } from '@dxos/util';\n\nexport const BaseGraphNode = S.Struct({\n  id: S.String,\n  type: S.optional(S.String),\n  data: S.optional(S.Any),\n});\n\n/** Raw base type. */\nexport type BaseGraphNode = S.Schema.Type<typeof BaseGraphNode>;\n/** Typed node data. */\nexport type GraphNode<Data = any, Optional extends boolean = false> = Specialize<\n  BaseGraphNode,\n  Optional extends true ? { data?: Data } : { data: Data }\n>;\n\nexport declare namespace GraphNode {\n  export type Optional<T = any> = GraphNode<T, true>;\n}\n\nexport const BaseGraphEdge = S.Struct({\n  id: S.String,\n  type: S.optional(S.String),\n  data: S.optional(S.Any),\n  source: S.String,\n  target: S.String,\n});\n\n/** Raw base type. */\nexport type BaseGraphEdge = S.Schema.Type<typeof BaseGraphEdge>;\n\n/** Typed edge data. */\nexport type GraphEdge<Data = any, Optional extends boolean = false> = Specialize<\n  BaseGraphEdge,\n  Optional extends true ? { data?: Data } : { data: Data }\n>;\n\nexport declare namespace GraphEdge {\n  export type Optional<T = any> = GraphEdge<T, true>;\n}\n\n/**\n * Allows any additional properties on graph nodes.\n */\nconst ExtendableBaseGraphNode = S.extend(BaseGraphNode, S.Struct({}, { key: S.String, value: S.Any }));\n\n/**\n * Generic graph.\n */\nexport const Graph = S.Struct({\n  id: S.optional(S.String),\n  nodes: S.mutable(S.Array(ExtendableBaseGraphNode)),\n  edges: S.mutable(S.Array(BaseGraphEdge)),\n});\n\nexport type Graph = S.Schema.Type<typeof Graph>;\n"],
-  "mappings": "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",
-  "names": ["inspectCustom", "failedInvariant", "invariant", "getSnapshot", "isNotFalsy", "removeBy", "stripUndefined", "FormatEnum", "invariant", "getSchema", "create", "log", "getSchemaProperties", "S", "BaseGraphNode", "S", "Struct", "id", "String", "type", "optional", "data", "Any", "BaseGraphEdge", "source", "target", "ExtendableBaseGraphNode", "extend", "key", "value", "Graph", "nodes", "mutable", "Array", "edges", "KEY_REGEX", "createEdgeId", "source", "target", "relation", "invariant", "match", "join", "parseEdgeId", "id", "split", "length", "undefined", "createGraph", "objects", "graph", "GraphModel", "create", "Graph", "nodes", "edges", "forEach", "object", "addNode", "type", "typename", "data", "schema", "getSchema", "log", "info", "slice", "prop", "getSchemaProperties", "ast", "format", "FormatEnum", "Ref", "name", "addEdge", "String", "ReadonlyGraphModel", "constructor", "graph", "_graph", "nodes", "edges", "inspectCustom", "toJSON", "id", "getSnapshot", "sort", "a", "b", "localeCompare", "stripUndefined", "findNode", "find", "node", "getNode", "failedInvariant", "filterNodes", "type", "filter", "findEdge", "edge", "getEdge", "filterEdges", "source", "target", "traverse", "root", "_traverse", "visited", "Set", "has", "add", "targets", "map", "isNotFalsy", "flatMap", "AbstractGraphModel", "clear", "length", "addGraph", "addNodes", "addEdges", "addGraphs", "graphs", "forEach", "addNode", "invariant", "push", "addEdge", "createEdgeId", "removeNode", "removeBy", "copy", "removeNodes", "ids", "removeEdge", "removeEdges", "AbstractGraphBuilder", "_model", "model", "call", "cb", "GraphModel", "builder", "GraphBuilder"]
+  "sources": ["../../../src/buidler.ts", "../../../src/graph.ts", "../../../src/types.ts", "../../../src/util.ts"],
+  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { type ReactiveEchoObject } from '@dxos/echo-db';\nimport { FormatEnum } from '@dxos/echo-schema';\nimport { invariant } from '@dxos/invariant';\nimport { getSchema } from '@dxos/live-object';\nimport { log } from '@dxos/log';\nimport { getSchemaProperties } from '@dxos/schema';\n\nimport { GraphModel } from './graph';\nimport { type GraphNode } from './types';\n\n// NOTE: The `relation` is different from the `type`.\ntype Edge = { source: string; target: string; relation: string };\n\nexport const createEdgeId = ({ source, target, relation }: Edge) => `${source}-${relation}-${target}`;\n\nexport const parseEdgeId = (id: string): Edge => {\n  const [source, relation, target] = id.split('-');\n  invariant(source && target && relation);\n  return { source, relation, target };\n};\n\n/**\n * Maps an ECHO object graph onto a layout graph.\n */\nexport const createGraph = (objects: ReactiveEchoObject<any>[]): GraphModel<GraphNode<ReactiveEchoObject<any>>> => {\n  const graph = new GraphModel<GraphNode<ReactiveEchoObject<any>>>();\n\n  // Map objects.\n  objects.forEach((object) => {\n    graph.addNode({ id: object.id, type: object.typename, data: object });\n  });\n\n  // Find references.\n  objects.forEach((object) => {\n    const schema = getSchema(object);\n    if (!schema) {\n      log.info('no schema for object', { id: object.id.slice(0, 8) });\n      return;\n    }\n\n    // Parse schema to follow referenced objects.\n    for (const prop of getSchemaProperties(schema.ast, object)) {\n      if (prop.format === FormatEnum.Ref) {\n        const source = object;\n        const target = object[prop.name]?.target;\n        if (target) {\n          graph.addEdge({\n            id: createEdgeId({ source: source.id, target: target.id, relation: String(prop.name) }),\n            source: source.id,\n            target: target.id,\n          });\n        }\n      }\n    }\n  });\n\n  return graph;\n};\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { create } from '@dxos/live-object';\n\nimport { Graph, type GraphNode, type GraphEdge } from './types';\nimport { removeElements } from './util';\n\n// TODO(burdon): Traversal/visitor.\n\n/**\n * Typed reactive object graph.\n */\nexport class ReadonlyGraphModel<Node extends GraphNode = any, Edge extends GraphEdge = any> {\n  protected readonly _graph: Graph;\n\n  constructor({ nodes = [], edges = [] }: Partial<Graph> = {}) {\n    this._graph = create(Graph, { nodes, edges });\n  }\n\n  toJSON() {\n    // Sort to enable stable comparisons.\n    this._graph.nodes.sort(({ id: a }, { id: b }) => a.localeCompare(b));\n    this._graph.edges.sort(({ id: a }, { id: b }) => a.localeCompare(b));\n    return JSON.parse(JSON.stringify(this._graph));\n  }\n\n  get graph(): Graph {\n    return this._graph;\n  }\n\n  get nodes(): Node[] {\n    return this._graph.nodes as Node[];\n  }\n\n  get edges(): Edge[] {\n    return this._graph.edges as Edge[];\n  }\n\n  getNode(id: string): Node | undefined {\n    return this.nodes.find((node) => node.id === id);\n  }\n\n  getNodes({ type }: Partial<Node>): Node[] {\n    return this.nodes.filter((node) => !type || type === node.type);\n  }\n\n  getEdge(id: string): Edge | undefined {\n    return this.edges.find((edge) => edge.id === id);\n  }\n\n  getEdges({ type, source, target }: Partial<Edge>): Edge[] {\n    return this.edges.filter(\n      (edge) =>\n        (!type || type === edge.type) && (!source || source === edge.source) && (!target || target === edge.target),\n    );\n  }\n}\n\nexport class GraphModel<Node extends GraphNode = any, Edge extends GraphEdge = any> extends ReadonlyGraphModel<\n  Node,\n  Edge\n> {\n  clear(): this {\n    this._graph.nodes.length = 0;\n    this._graph.edges.length = 0;\n    return this;\n  }\n\n  addGraph(graph: GraphModel<Node, Edge>): this {\n    this.addNodes(graph.nodes);\n    this.addEdges(graph.edges);\n    return this;\n  }\n\n  addGraphs(graphs: GraphModel<Node, Edge>[]): this {\n    graphs.forEach((graph) => {\n      this.addNodes(graph.nodes);\n      this.addEdges(graph.edges);\n    });\n    return this;\n  }\n\n  addNode(node: Node): this {\n    this._graph.nodes.push(node);\n    return this;\n  }\n\n  addNodes(nodes: Node[]): this {\n    nodes.forEach((node) => this.addNode(node));\n    return this;\n  }\n\n  addEdge(edge: Edge): this {\n    this._graph.edges.push(edge);\n    return this;\n  }\n\n  addEdges(edges: Edge[]): this {\n    edges.forEach((edge) => this.addEdge(edge));\n    return this;\n  }\n\n  // TODO(burdon): Return graph.\n\n  removeNode(id: string): GraphModel<Node, Edge> {\n    const nodes = removeElements(this._graph.nodes, (node) => node.id === id);\n    const edges = removeElements(this._graph.edges, (edge) => edge.source === id || edge.target === id);\n    return new GraphModel<Node, Edge>({ nodes, edges });\n  }\n\n  removeNodes(ids: string[]): GraphModel<Node, Edge> {\n    const graphs = ids.map((id) => this.removeNode(id));\n    return new GraphModel<Node, Edge>().addGraphs(graphs);\n  }\n\n  removeEdge(id: string): GraphModel<Node, Edge> {\n    const edges = removeElements(this._graph.edges, (edge) => edge.id === id);\n    return new GraphModel<Node, Edge>({ edges });\n  }\n\n  removeEdges(ids: string[]): GraphModel<Node, Edge> {\n    const graphs = ids.map((id) => this.removeEdge(id));\n    return new GraphModel<Node, Edge>().addGraphs(graphs);\n  }\n}\n", "//\n// Copyright 2024 DXOS.org\n//\n\nimport { S } from '@dxos/echo-schema';\n\n// Prior art:\n// - https://graphology.github.io (TS, tree-shakable, multiple packages for extensions)\n// - https://github.com/dagrejs/graphlib (mature, extensive)\n// - https://github.com/avoidwork/tiny-graph\n\nexport const BaseGraphNode = S.Struct({\n  id: S.String,\n  type: S.optional(S.String),\n  data: S.optional(S.Any),\n});\n\nexport type BaseGraphNode = S.Schema.Type<typeof BaseGraphNode>;\nexport type GraphNode<Data extends object | void = void> = BaseGraphNode & { data: Data };\n\nexport const BaseGraphEdge = S.Struct({\n  id: S.String,\n  type: S.optional(S.String),\n  source: S.String,\n  target: S.String,\n  data: S.optional(S.Any),\n});\n\nexport type BaseGraphEdge = S.Schema.Type<typeof BaseGraphEdge>;\nexport type GraphEdge<Data extends object | void = void> = BaseGraphEdge & { data: Data };\n\n/**\n * Generic graph abstraction.\n */\nexport const Graph = S.Struct({\n  nodes: S.mutable(S.Array(BaseGraphNode)),\n  edges: S.mutable(S.Array(BaseGraphEdge)),\n});\n\nexport type Graph = S.Schema.Type<typeof Graph>;\n\nexport const emptyGraph: Graph = { nodes: [], edges: [] };\n", "//\n// Copyright 2024 DXOS.org\n//\n\n// TODO(burdon): GraphBuilder.\n\n// TODO(burdon): Move to @dxos/live-object?\nexport const removeElements = <T>(array: T[], predicate: (element: T, index: number) => boolean): T[] => {\n  const deleted: T[] = [];\n  for (let i = array.length - 1; i >= 0; i--) {\n    if (predicate(array[i], i)) {\n      deleted.push(...array.splice(i, 1));\n    }\n  }\n\n  return deleted;\n};\n"],
+  "mappings": "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",
+  "names": ["FormatEnum", "invariant", "getSchema", "log", "getSchemaProperties", "create", "S", "BaseGraphNode", "S", "Struct", "id", "String", "type", "optional", "data", "Any", "BaseGraphEdge", "source", "target", "Graph", "nodes", "mutable", "Array", "edges", "emptyGraph", "removeElements", "array", "predicate", "deleted", "i", "length", "push", "splice", "ReadonlyGraphModel", "constructor", "nodes", "edges", "_graph", "create", "Graph", "toJSON", "sort", "id", "a", "b", "localeCompare", "JSON", "parse", "stringify", "graph", "getNode", "find", "node", "getNodes", "type", "filter", "getEdge", "edge", "getEdges", "source", "target", "GraphModel", "clear", "length", "addGraph", "addNodes", "addEdges", "addGraphs", "graphs", "forEach", "addNode", "push", "addEdge", "removeNode", "removeElements", "removeNodes", "ids", "map", "removeEdge", "removeEdges", "createEdgeId", "source", "target", "relation", "parseEdgeId", "id", "split", "invariant", "createGraph", "objects", "graph", "GraphModel", "forEach", "object", "addNode", "type", "typename", "data", "schema", "getSchema", "log", "info", "slice", "prop", "getSchemaProperties", "ast", "format", "FormatEnum", "Ref", "name", "addEdge", "String"]
 }

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

@@ -1 +1 @@
-{"inputs":{"packages/common/graph/src/types.ts":{"bytes":4437,"imports":[{"path":"@dxos/echo-schema","kind":"import-statement","external":true}],"format":"esm"},"packages/common/graph/src/util.ts":{"bytes":9104,"imports":[{"path":"@dxos/echo-schema","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/live-object","kind":"import-statement","external":true},{"path":"@dxos/log","kind":"import-statement","external":true},{"path":"@dxos/schema","kind":"import-statement","external":true},{"path":"packages/common/graph/src/model.ts","kind":"import-statement","original":"./model"},{"path":"packages/common/graph/src/types.ts","kind":"import-statement","original":"./types"}],"format":"esm"},"packages/common/graph/src/model.ts":{"bytes":23788,"imports":[{"path":"@dxos/debug","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/live-object","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"packages/common/graph/src/util.ts","kind":"import-statement","original":"./util"}],"format":"esm"},"packages/common/graph/src/index.ts":{"bytes":647,"imports":[{"path":"packages/common/graph/src/model.ts","kind":"import-statement","original":"./model"},{"path":"packages/common/graph/src/types.ts","kind":"import-statement","original":"./types"},{"path":"packages/common/graph/src/util.ts","kind":"import-statement","original":"./util"}],"format":"esm"}},"outputs":{"packages/common/graph/dist/lib/node-esm/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":18690},"packages/common/graph/dist/lib/node-esm/index.mjs":{"imports":[{"path":"@dxos/debug","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/live-object","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"@dxos/echo-schema","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/live-object","kind":"import-statement","external":true},{"path":"@dxos/log","kind":"import-statement","external":true},{"path":"@dxos/schema","kind":"import-statement","external":true},{"path":"@dxos/echo-schema","kind":"import-statement","external":true}],"exports":["AbstractGraphBuilder","AbstractGraphModel","BaseGraphEdge","BaseGraphNode","Graph","GraphBuilder","GraphModel","ReadonlyGraphModel","createEdgeId","createGraph","parseEdgeId"],"entryPoint":"packages/common/graph/src/index.ts","inputs":{"packages/common/graph/src/model.ts":{"bytesInOutput":5449},"packages/common/graph/src/util.ts":{"bytesInOutput":2277},"packages/common/graph/src/types.ts":{"bytesInOutput":551},"packages/common/graph/src/index.ts":{"bytesInOutput":0}},"bytes":8795}}}
+{"inputs":{"packages/common/graph/src/types.ts":{"bytes":3825,"imports":[{"path":"@dxos/echo-schema","kind":"import-statement","external":true}],"format":"esm"},"packages/common/graph/src/util.ts":{"bytes":1705,"imports":[],"format":"esm"},"packages/common/graph/src/graph.ts":{"bytes":12508,"imports":[{"path":"@dxos/live-object","kind":"import-statement","external":true},{"path":"packages/common/graph/src/types.ts","kind":"import-statement","original":"./types"},{"path":"packages/common/graph/src/util.ts","kind":"import-statement","original":"./util"}],"format":"esm"},"packages/common/graph/src/buidler.ts":{"bytes":7346,"imports":[{"path":"@dxos/echo-schema","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/live-object","kind":"import-statement","external":true},{"path":"@dxos/log","kind":"import-statement","external":true},{"path":"@dxos/schema","kind":"import-statement","external":true},{"path":"packages/common/graph/src/graph.ts","kind":"import-statement","original":"./graph"}],"format":"esm"},"packages/common/graph/src/index.ts":{"bytes":654,"imports":[{"path":"packages/common/graph/src/buidler.ts","kind":"import-statement","original":"./buidler"},{"path":"packages/common/graph/src/graph.ts","kind":"import-statement","original":"./graph"},{"path":"packages/common/graph/src/types.ts","kind":"import-statement","original":"./types"}],"format":"esm"}},"outputs":{"packages/common/graph/dist/lib/node-esm/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":12613},"packages/common/graph/dist/lib/node-esm/index.mjs":{"imports":[{"path":"@dxos/echo-schema","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/live-object","kind":"import-statement","external":true},{"path":"@dxos/log","kind":"import-statement","external":true},{"path":"@dxos/schema","kind":"import-statement","external":true},{"path":"@dxos/live-object","kind":"import-statement","external":true},{"path":"@dxos/echo-schema","kind":"import-statement","external":true}],"exports":["BaseGraphEdge","BaseGraphNode","Graph","GraphModel","ReadonlyGraphModel","createEdgeId","createGraph","emptyGraph","parseEdgeId"],"entryPoint":"packages/common/graph/src/index.ts","inputs":{"packages/common/graph/src/buidler.ts":{"bytesInOutput":1716},"packages/common/graph/src/graph.ts":{"bytesInOutput":2460},"packages/common/graph/src/types.ts":{"bytesInOutput":454},"packages/common/graph/src/util.ts":{"bytesInOutput":223},"packages/common/graph/src/index.ts":{"bytesInOutput":0}},"bytes":5367}}}

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

@@ -0,0 +1,16 @@
+import { type ReactiveEchoObject } from '@dxos/echo-db';
+import { GraphModel } from './graph';
+import { type GraphNode } from './types';
+type Edge = {
+    source: string;
+    target: string;
+    relation: string;
+};
+export declare const createEdgeId: ({ source, target, relation }: Edge) => string;
+export declare const parseEdgeId: (id: string) => Edge;
+/**
+ * Maps an ECHO object graph onto a layout graph.
+ */
+export declare const createGraph: (objects: ReactiveEchoObject<any>[]) => GraphModel<GraphNode<ReactiveEchoObject<any>>>;
+export {};
+//# sourceMappingURL=buidler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"buidler.d.ts","sourceRoot":"","sources":["../../../src/buidler.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAOxD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAGzC,KAAK,IAAI,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjE,eAAO,MAAM,YAAY,iCAAkC,IAAI,WAAsC,CAAC;AAEtG,eAAO,MAAM,WAAW,OAAQ,MAAM,KAAG,IAIxC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,YAAa,kBAAkB,CAAC,GAAG,CAAC,EAAE,KAAG,UAAU,CAAC,SAAS,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAiC7G,CAAC"}

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

@@ -0,0 +1,30 @@
+import { Graph, type GraphNode, type GraphEdge } from './types';
+/**
+ * Typed reactive object graph.
+ */
+export declare class ReadonlyGraphModel<Node extends GraphNode = any, Edge extends GraphEdge = any> {
+    protected readonly _graph: Graph;
+    constructor({ nodes, edges }?: Partial<Graph>);
+    toJSON(): any;
+    get graph(): Graph;
+    get nodes(): Node[];
+    get edges(): Edge[];
+    getNode(id: string): Node | undefined;
+    getNodes({ type }: Partial<Node>): Node[];
+    getEdge(id: string): Edge | undefined;
+    getEdges({ type, source, target }: Partial<Edge>): Edge[];
+}
+export declare class GraphModel<Node extends GraphNode = any, Edge extends GraphEdge = any> extends ReadonlyGraphModel<Node, Edge> {
+    clear(): this;
+    addGraph(graph: GraphModel<Node, Edge>): this;
+    addGraphs(graphs: GraphModel<Node, Edge>[]): this;
+    addNode(node: Node): this;
+    addNodes(nodes: Node[]): this;
+    addEdge(edge: Edge): this;
+    addEdges(edges: Edge[]): this;
+    removeNode(id: string): GraphModel<Node, Edge>;
+    removeNodes(ids: string[]): GraphModel<Node, Edge>;
+    removeEdge(id: string): GraphModel<Node, Edge>;
+    removeEdges(ids: string[]): GraphModel<Node, Edge>;
+}
+//# sourceMappingURL=graph.d.ts.map