Version 0.22.0 released on 2025-12-11.

⚡ This new version makes default style properties globally configurable and includes bug fixes for a smoother developer experience. ⚡

Resources

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

Highlights

Globally configurable default style properties

Previously, changing default styles required local configuration per Graph instance using a Stylesheet.
It was also not possible to configure the rounding factor used when a vertex uses a non absolute arcSize, because there was no dedicated cell style property for that.
This release solves these limitations by making the built-in defaults globally configurable.

The StyleDefaultsConfig object has been extended to allow customization of default style values that were previously hardcoded as constants.
All direct references to DEFAULT_* constants in the codebase are now replaced with StyleDefaultsConfig property access. This means you can change these defaults at runtime without updating stylesheets on every Graph instance.

New configurable properties include:

• Font settings: fontFamily, fontSize
• Arrow settings: arrowSize, arrowSpacing, arrowWidth
• Size settings: markerSize, imageSize, startSize
• Rounding: roundingFactor, lineArcSize

You can now globally customize these defaults at runtime like this:

import { StyleDefaultsConfig } from '@maxgraph/core';

// Change default marker size
StyleDefaultsConfig.markerSize = 10;

// Change default image size for labels
StyleDefaultsConfig.imageSize = 32;

// Change default swimlane start size
StyleDefaultsConfig.startSize = 50;

// Change default rounding factor
StyleDefaultsConfig.roundingFactor = 0.4;

Bug fixes

This release also includes bug fixes that improve overall stability and consistency of rendering and styling.
If you encounter any regressions or unexpected behavior, please open an issue with a minimal reproduction so we can address it quickly.

What's Changed

🎉 New Features

• feat: accept more nullish parameter in various methods by @tbouffard in feat: accept more nullish parameter in various methods  #892
• feat: allow to pass more null and undefined to Multiplicity by @tbouffard in feat: allow to pass more null and undefined to Multiplicity #914
• feat: add generic font in default font family by @tbouffard in feat: add generic font in default font family #931
• feat: make default style properties globally configurable by @tbouffard in feat: make default style properties globally configurable #932

🐛 Bug Fixes

• fix(editor): ensure editor context in installDblClickHandler callback by @tbouffard in fix(editor): ensure editor context in installDblClickHandler callback #934
• fix: restore tooltip display when PopupMenuHandler is unavailable by @chrisob194 in fix: restore tooltip display when PopupMenuHandler is unavailable #970
• fix(VertexHandler): fix top-left resize handle behavior by @Lockps in fix(VertexHandler): fix top-left resize handle behavior #968

📝 Documentation

• docs: add badge to DeepWiki in the README by @tbouffard in docs: add badge to DeepWiki in the README #913
• docs(website): enable system color mode toggle by @tbouffard in docs(website): enable system color mode toggle #933
• docs: display correct title on image of the home page by @tbouffard in docs: display correct title on image of the home page #951
• docs: add Contributing guide by @tbouffard in docs: add Contributing guide #948

⚙️ Refactor

• refactor: fix most problems in the Wires story by @tbouffard in refactor: fix most problems in the Wires story #893
• refactor: simplify signature of the isNullish internal function by @tbouffard in refactor: simplify signature of the isNullish internal function #907
• refactor: migrate the Guides story to TypeScript by @tbouffard in refactor: migrate the Guides story to TypeScript #908
• refactor: simplify implementation of ParallelEdgeLayout by @tbouffard in refactor: simplify implementation of ParallelEdgeLayout #909
• refactor: ensure mixins do not create shared properties in AbstractGraph by @tbouffard in refactor: ensure mixins do not create shared properties in AbstractGraph #879
• refactor: simplify Editor installDblClickHandler by @tbouffard in refactor: simplify Editor installDblClickHandler #938
• refactor: prefer includes to indexOf by @tbouffard in refactor: prefer includes to indexOf #952
• refactor(Stylesheet): simplify default style creation methods by @tbouffard in refactor(Stylesheet): simplify default style creation methods #955
• refactor: introduce AbstractPathShape base class for shape hierarchy by @tbouffard in refactor: introduce AbstractPathShape base class for shape hierarchy #953
• refactor: improve types usage in PageBreaksMixin by @tbouffard in refactor: improve types usage in PageBreaksMixin #956

🛠 Chore

• test: add more tests for FitPlugin.fit by @tbouffard in test: add more tests for FitPlugin.fit #888
• chore(typescript): always use explicit override by @tbouffard in chore(typescript): always use explicit override #921
• chore: use stricter options with the TS compiler by @tbouffard in chore: use stricter options with the TS compiler #922
• chore: add some unicorn eslint plugin rules by @tbouffard in chore: add some unicorn eslint plugin rules #925
• chore: add config files for some code assistant by @tbouffard in chore: add config files for some code assistant #930
• chore: build with node 22 by @tbouffard in chore: build with node 22 #937
• chore: add react patterns to dependabot configuration by @tbouffard in chore: add react patterns to dependabot configuration #964
• docs: enhance bug report template with additional guidance by @tbouffard in docs: enhance bug report template with additional guidance #967
• chore: build with node 24 by @tbouffard in chore: build with node 24 #971
• ci: publish npm package with trusted publisher by @tbouffard in ci: publish npm package with trusted publisher #972

New Contributors

• @chrisob194 made their first contribution in fix: restore tooltip display when PopupMenuHandler is unavailable #970
• @Lockps made their first contribution in fix(VertexHandler): fix top-left resize handle behavior #968

Full Changelog: v0.21.0...v0.22.0