Version 0.21.0 released on 2025-07-23.

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

Resources

• npm package: @maxgraph/core 0.21.0
• Fixed issues: milestone 0.21.0
• Documentation: maxgraph_0.21.0_website.zip
• Examples: maxgraph_0.21.0_examples.zip
• Changelog (only includes a summary and breaking changes): changelog

Breaking changes

fit method moved to FitPlugin

The AbstractGraph.fit method and the minFitScale and maxFitScale properties have been moved to the FitPlugin.
This helps reduce the size of the base graph when the plugin is not used.

Removal of Dictionary class

The Dictionary class has been removed. You can now use the native JavaScript Map object, which is available in all environments supported by maxGraph.
This class was originally introduced in mxGraph to support old browsers lacking Map.

If your code used Dictionary, replace it with Map.

Rounded shapes: consistent arcSize rendering

The way arcSize is computed for rounded shapes is now consistent across all shape types and matches the behavior of mxGraph.

TypeScript-specific changes

• AbstractGraph.getPlugin() now explicitly returns undefined if the plugin is not found.
  You must handle the undefined case in your code.

• Improved return types for EditorToolbar methods:

  • addPrototype() now returns HTMLImageElement (was HTMLImageElement | HTMLButtonElement)
  • addCombo() now returns HTMLSelectElement (was HTMLElement)

Highlights

🔍 Search bar on the documentation website

You can now quickly search the documentation!
The new search bar uses a local lunr-search index for fast results.

🛠️ Webpack configuration simplified + Node.js ESM support

maxGraph can now be used with Webpack and Node.js ESM without extra config 🎉

Before this update, using maxGraph with Webpack required a workaround like this:

module.exports = {
  module: {
    rules: [
      {
        test: /\.m?js/,
        resolve: {
          fullySpecified: false,
        },
      },
    ],
  },
};

This was needed because import paths in maxGraph were missing the .js extension.
This also caused issues when importing maxGraph in ESM contexts with Node.js — no workaround was possible in that case.

These issues are now fixed ✅

📦 Bundle size reduction

Small but measurable size gains:

• -0.7 kB: removal of the Dictionary class and internal refactoring (#857)
• -1.0 kB: when not using the FitPlugin, due to fit logic moving out of BaseGraph (#734)

What's Changed

🎉 New Features

• feat: let choose the implementation of ConstraintHandler by @tbouffard in feat: let choose the implementation of ConstraintHandler #838
• feat(type): allow optional for parameters of AbstractGraph.addCells by @tbouffard in feat(type): allow optional for parameters of AbstractGraph.addCells #847
• feat: add search to website by @tbouffard in feat: add search to website #853
• feat: ease webpack configuration and add support Node ESM by @tbouffard in feat: ease webpack configuration and add support Node ESM #867

🐛 Bug Fixes

• fix(FitPlugin): handle edge cases in fitCenter calculation by @tbouffard in fix(FitPlugin): handle edge cases in fitCenter calculation #831
• fix: correct Editor cycleAttribute and swapStyles methods by @tbouffard in fix: correct Editor cycleAttribute and swapStyles methods #871
• fix!: improve the robustness of codecs by @tbouffard in fix!: improve the robustness of codecs #872
• fix: consistently compute the arcSize for edges and vertices by @tbouffard in fix: consistently compute the arcSize for edges and vertices #884

📝 Documentation

• docs(release): fix the name of the zip files to archive by @tbouffard in docs(release): fix the name of the zip files to archive #833
• docs: fix CHANGELOG for 0.20.0 by @tbouffard in docs: fix CHANGELOG for 0.20.0 #845
• docs: improve jsdoc of CellOverlay by @tbouffard in docs: improve jsdoc of CellOverlay #846
• docs: fix some typedoc warnings by @tbouffard in docs: fix some typedoc warnings #870

⚙️ Refactor

• refactor!: move AbstractGraph.fit to FitPlugin by @tbouffard in refactor!: move AbstractGraph.fit to FitPlugin #734
• refactor: migrate the Orthogonal story to TypeScript by @tbouffard in refactor: migrate the Orthogonal story to TypeScript #835
• refactor: migrate the FixedPoints story to TypeScript by @tbouffard in refactor: migrate the FixedPoints story to TypeScript #839
• refactor(type)!: make AbstractGraph.getPlugin return T | undefined by @tbouffard in refactor(type)!: make AbstractGraph.getPlugin return T | undefined #842
• refactor: increase usage of the MouseListenerSet interface by @tbouffard in refactor: increase usage of the MouseListenerSet interface #848
• refactor(stories): remove reference to Graph handler by @tbouffard in refactor(stories): remove reference to Graph handler #849
• refactor!: remove Dictionary and use Map instead by @tbouffard in refactor!: remove Dictionary and use Map instead #857
• refactor: migrate the DragSource story to TypeScript by @tbouffard in refactor: migrate the DragSource story to TypeScript #860
• refactor: remove reference to legacy insert cells methods by @tbouffard in refactor: remove reference to legacy insert cells methods #876
• refactor: migrate the Thread story to TypeScript by @tbouffard in refactor: migrate the Thread story to TypeScript #877
• refactor: migrate the Stylesheet story to TypeScript by @tbouffard in refactor: migrate the Stylesheet story to TypeScript #878

🛠 Chore

• test: add more tests to FitPlugin by @tbouffard in test: add more tests to FitPlugin #834
• test: add tests for Cell.hasAttribute by @tbouffard in test: add tests for Cell.hasAttribute #850
• chore(eslint): use flat configuration by @tbouffard in chore(eslint): use flat configuration #851
• ci: run with ubuntu-24.04 by @tbouffard in ci: run with ubuntu-24.04 #861
• ci: display the date of the release in the release notes by @tbouffard in ci: display the date of the release in the release notes #885

Full Changelog: v0.20.0...v0.21.0