@maxgraph/core

@maxgraph/core

maxGraph is a TypeScript library which can display and allow interaction with vector diagrams. At a high level, it provides:

• Nodes, also known as vertices which are typically represented by shapes like rectangles.
• Edges which can be lines and arrows which normally point between one node and another.

It provides many of the diagramming features which would be expected by a piece of presentation software like Microsoft® PowerPoint™ or LibreOffice® Impress such as being able to resize, move or rotate nodes, but has a stronger focus on automatic layout algorithms and applications of Graph Theory. It is suited towards software which requires finer-grained customization of functionality than off-the-shelf packages.

For more details, see the maxGraph GitHub repository.

Install

npm install @maxgraph/core

Getting started

All the information is available in the README of the GitHub repository.

Changelog

0.21.0

Release date: 2025-07-22

For more details, see the 0.21.0 Changelog on the GitHub release page.

This release improves Webpack and Node.js compatibility, removes legacy code, and slightly reduces bundle size.

Breaking Changes:

• The AbstractGraph.fit method moved to FitPlugin, as well as the minFitScale and maxFitScale properties. The method now accepts a single parameter, mainly to minimize the need to pass many default values.
• The Dictionary class has been removed. The maxGraph API use the Map class instead, which is a standard JavaScript feature. If your code depends on the Dictionary class, you can use the Map class instead.
• The arcSize of rounded shapes was not always correctly computed in the past. The computation is now consistent everywhere in the code and matches the mxGraph behavior. To have the same rendering as before for edges, you must multiply the arcSize by 2 in your styles.
• The AbstractGraph.getPlugin method now explicitly returns undefined when a plugin is not found.
  TypeScript users must update their code to handle the undefined case when calling this method.
• The return types of some methods of EditorToolbar are now more precise.
  • addPrototype(): HTMLImageElement instead of HTMLImageElement | HTMLButtonElement
  • addCombo(): HTMLSelectElement instead of HTMLElement