⚡ This new version enhances internationalization (i18n), improves connector configurations, and prepares for future updates with tree shaking optimizations. ⚡

Resources

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

Breaking changes

• Private utility functions:
  The functions utils.isNullish and utils.isNotNullish are now marked as private. They were mistakenly made public and have always been intended for internal use.

• Removed utility functions:
  Several utility functions, originally designed for internal use to retrieve default values for CellStateStyle and CellStyle, have been removed:

  • utils.getValue
  • stringUtils.getColor
  • stringUtils.getNumber
  • stringUtils.getStringValue

  You should now use the nullish coalescing operator (??) and Optional chaining (?.) instead.

• Removed Client.isBrowserSupported:
  The Client.isBrowserSupported method has been removed. It was not correctly validating all the prerequisites for determining whether the browser supports maxGraph. This method is now deprecated with no direct replacement.

• Moved Client.VERSION to constants.VERSION:
  The VERSION constant, previously stored in Client, is now stored in the constants module to ensure its immutability, as it represents the actual version of maxGraph.

• Relocated Translations configuration:
  Configuration elements for translations have been moved from Client to TranslationsConfig. The following properties have been migrated:

  • Client.defaultLanguage → TranslationsConfig.getDefaultLanguage
  • Client.setDefaultLanguage → TranslationsConfig.setDefaultLanguage
  • Client.language → TranslationsConfig.getLanguage
  • Client.setLanguage → TranslationsConfig.setLanguage
  • Client.languages → TranslationsConfig.getLanguages
  • Client.setLanguages → TranslationsConfig.setLanguages

• Connector Configuration changes:

  • ManhattanConnector: Now configured via the global ManhattanConnectorConfig object. Several properties that were previously part of EdgeStyle have moved to this configuration object:
    • MANHATTAN_END_DIRECTIONS → endDirections
    • MANHATTAN_MAX_ALLOWED_DIRECTION_CHANGE → maxAllowedDirectionChange
    • MANHATTAN_MAXIMUM_LOOPS → maxLoops
    • MANHATTAN_START_DIRECTIONS → startDirections
    • MANHATTAN_STEP → step
  • OrthConnector: Now configured via the global OrthogonalConnectorConfig object. The following properties have been moved:
    • orthBuffer → buffer
    • orthPointsFallback → pointsFallback

• Internal utility methods:
  Several properties and utility methods previously exposed by EdgeStyle are now internal. For example:

  • The getRoutePattern method has been removed entirely, as it was not being used anywhere within the codebase.

Highlights

🌍 Custom Shape Support for Overlays

You can now use custom shapes for overlays instead of just images. The CellRenderer provides extension points for configuring custom shapes and their associated DOM nodes.

Here is an example of custom Overlays taken from the Overlays strory 👇🏿

🌐 Improved i18n Support

This release enhances i18n support with the restoration of original mxGraph resource files (Chinese, English, and German) and adds French and Spanish resources. Additionally, a new configuration object, TranslationsConfig, is introduced to simplify and extend internationalization functionality in future releases.
This update is part of ongoing efforts to allow for custom i18n mechanisms in future versions (see issue #688).

🔗 Enhanced Manhattan and Orthogonal Connector Configuration

The configuration for both the Manhattan and Orthogonal connectors is now centralized in dedicated global configuration objects: ManhattanConnectorConfig and OrthogonalConnectorConfig. This change helps clarify responsibilities and makes future tree shaking optimizations easier. Additionally, related reset functions are now available.

What's Changed

🎉 New Features

• feat!: introduce global config for the Orthogonal connector by @tbouffard in feat!: introduce global config for the Orthogonal connector #678
• feat!: introduce global config for the Manhattan connector by @tbouffard in feat!: introduce global config for the Manhattan connector #681
• feat: provide i18n default resources by @tbouffard in feat: provide i18n default resources #689
• feat: provide i18n resources for French and Spanish by @tbouffard in feat: provide i18n resources for French and Spanish #690
• feat!: introduce TranslationsConfig by @tbouffard in feat!: introduce TranslationsConfig #691
• feat: allow to use custom shape for overlays by @tbouffard in feat: allow to use custom shape for overlays #696

🐛 Bug Fixes

• fix: Graph.isValidAncestor manages null Cell parameter by @tbouffard in fix: Graph.isValidAncestor manages null Cell parameter #699

📝 Documentation

• docs: apply improvements to the navbar by @tbouffard in docs: apply improvements to the navbar #675
• docs: improve css and images page by @tbouffard in docs: improve css and images page #677

⚙️ Refactor

• refactor!: mark isNullish and isNotNullish as private by @tbouffard in refactor!: mark isNullish and isNotNullish as private #661
• refactor!: remove extra getDefault functions and related functions by @tbouffard in refactor!: remove extra getDefault functions and related functions #662
• refactor!: remove Client.isBrowserSupported by @tbouffard in refactor!: remove Client.isBrowserSupported #679
• refactor!: move VERSION to constants by @tbouffard in refactor!: move VERSION to constants #680
• refactor!: extract Orthogonal and Manhattan connectors by @tbouffard in refactor!: extract Orthogonal and Manhattan connectors #684
• refactor: rename OrthConnectorConfig to OrthogonalConnectorConfig by @tbouffard in refactor: rename OrthConnectorConfig to OrthogonalConnectorConfig #685
• refactor: do not redeclare ImageShape properties already in Shape by @tbouffard in refactor: do not redeclare ImageShape properties already in Shape #694
• refactor: reset more global configurations in stories by @tbouffard in refactor: reset more global configurations in stories #646
• refactor: use external CSS file MenuStyle and ShowRegion stories by @tbouffard in refactor: use external CSS file MenuStyle and ShowRegion stories #698

Full Changelog: v0.15.1...v0.16.0