maxGraph · tbouffard · Dec 19, 2025 · Dec 17, 2025 · Dec 17, 2025 · Dec 17, 2025
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -9,6 +9,10 @@ For more details on the contents of a release, see [the GitHub release page] (ht
 
 _**Note:** Yet to be released breaking changes appear here._
 
+**Breaking Changes**:
+- The `getTooltip` and `getTooltipForCell` methods have been moved from `AbstractGraph` to the `TooltipHandler` plugin.
+  If you were overriding these methods in a `AbstractGraph` subclass, you should now extend `TooltipHandler` instead.
+
 ## 0.22.0
 
 Release date: `2025-12-11`

diff --git a/..._tests__/view/mixins/TooltipMixin.test.ts → packages/core/__tests__/view/Graph.test.ts b/..._tests__/view/mixins/TooltipMixin.test.ts → packages/core/__tests__/view/Graph.test.ts
@@ -15,15 +15,10 @@ limitations under the License.
 */
 
 import { test } from '@jest/globals';
-import { createGraphWithoutPlugins } from '../../utils';
-import { Cell, CellState } from '../../../src';
+import { createGraphWithoutPlugins } from '../utils';
 
-test('The "TooltipHandler" plugin is not available', () => {
+test('setTooltips - the "TooltipHandler" plugin is not available', () => {
   const graph = createGraphWithoutPlugins();
+  // just validate there is no error in this case
   graph.setTooltips(true);
 });
-
-test('The "SelectionCellsHandler" plugin is not available', () => {
-  const graph = createGraphWithoutPlugins();
-  graph.getTooltip(new CellState(null, new Cell()), null!, 0, 0);
-});
diff --git a/packages/core/__tests__/view/handler/TooltipHandler.test.ts b/packages/core/__tests__/view/handler/TooltipHandler.test.ts
@@ -0,0 +1,26 @@
+/*
+Copyright 2025-present The maxGraph project Contributors
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+import { test } from '@jest/globals';
+import { createGraphWithoutPlugins } from '../../utils';
+import { Cell, CellState, TooltipHandler } from '../../../src';
+
+// ensure that no error occurs in this case
+test('Call getTooltip when the "SelectionCellsHandler" plugin is not available', () => {
+  const tooltipHandler = new TooltipHandler(createGraphWithoutPlugins());
+  // just validate there is no error in this case
+  tooltipHandler.getTooltip(new CellState(null, new Cell()), null!, 0, 0);
+});
diff --git a/packages/core/src/view/AbstractGraph.ts b/packages/core/src/view/AbstractGraph.ts
@@ -61,6 +61,7 @@ import type ImageBundle from './image/ImageBundle.js';
 import { applyGraphMixins } from './mixins/_graph-mixins-apply.js';
 import { isNullish } from '../internal/utils.js';
 import { isI18nEnabled } from '../internal/i18n-utils.js';
+import type TooltipHandler from './plugins/TooltipHandler.js';
 
 /**
  * Extends {@link EventSource} to implement a graph component for the browser. This is the entry point class of the package.
@@ -528,6 +529,11 @@ export abstract class AbstractGraph extends EventSource {
 
   getContainsValidationErrorsResource = () => this.containsValidationErrorsResource;
 
+  setTooltips(enabled: boolean): void {
+    const tooltipHandler = this.getPlugin<TooltipHandler>('TooltipHandler');
+    tooltipHandler?.setEnabled(enabled);
+  }
+
   /**
    * Updates the model in a transaction.
    *

diff --git a/packages/core/src/view/mixins/TooltipMixin.ts b/packages/core/src/view/mixins/TooltipMixin.ts
diff --git a/packages/core/src/view/mixins/TooltipMixin.type.ts b/packages/core/src/view/mixins/TooltipMixin.type.ts
diff --git a/packages/core/src/view/mixins/_graph-mixins-apply.ts b/packages/core/src/view/mixins/_graph-mixins-apply.ts
@@ -35,7 +35,6 @@ import { SelectionMixin } from './SelectionMixin.js';
 import { SnapMixin } from './SnapMixin.js';
 import { SwimlaneMixin } from './SwimlaneMixin.js';
 import { TerminalMixin } from './TerminalMixin.js';
-import { TooltipMixin } from './TooltipMixin.js';
 import { ValidationMixin } from './ValidationMixin.js';
 import { VertexMixin } from './VertexMixin.js';
 import { ZoomMixin } from './ZoomMixin.js';
@@ -65,7 +64,6 @@ export const applyGraphMixins = (target: typeof AbstractGraph) => {
     SnapMixin,
     SwimlaneMixin,
     TerminalMixin,
-    TooltipMixin,
     ValidationMixin,
     VertexMixin,
     ZoomMixin,

diff --git a/packages/core/src/view/mixins/_graph-mixins-types.ts b/packages/core/src/view/mixins/_graph-mixins-types.ts
@@ -35,7 +35,6 @@ import './SelectionMixin.type.js';
 import './SnapMixin.type.js';
 import './SwimlaneMixin.type.js';
 import './TerminalMixin.type.js';
-import './TooltipMixin.type.js';
 import './ValidationMixin.type.js';
 import './VertexMixin.type.js';
 import './ZoomMixin.type.js';