Graph

Basic graph implementations as building blocks for better things.

Test

$ npm i
$ npm test

Usage

DirectedGraph

import * as G from 'ts-directed-graph'

const graph = new G.DirectedGraph<G.Node>()

const n1 = graph.addNode({ id: 'N-1' })
const n2 = graph.addNode({ id: 'N-2' })
const n3 = graph.addNode({ id: 'N-3' })

graph.addEdge('N-1', 'N-2')
graph.addEdge('N-2', 'N-3')

Events

An instance of DirectedGraph can be configured to emit events by injecting an emitter to its constructor:

// Replace with the appropriate emitter for the environment
import EventEmitter from 'node:events'

const emitter = new EventEmitter()

const graph = new G.DirectedGraph<G.Node>({
  emitter
})

emitter.on('node:added', (arg0) => { /* ... */ })

For an instance of DirectedGraph<T>, the event list includes:

event	arg0
node:added	T
node:removed	T
node:replaced	T
edge:added	Edge

DirectedAcyclicGraph

See DirectedGraph, but expect an AcyclicViolationError when attempting to introduce a cyclic relationship between nodes.

Serialize

ts-directed-graph includes a basic Mermaid serializer to help visualize and debug graphs.

import { Serialize } from 'ts-directed-graph'

const actual = Serialize.toMermaid(graph)

License

ISC