handsontable 0.0.0-next-9059914-20231025 → 0.0.0-next-21d91d0-20231025

package/plugins/comments/contextMenuItem/addEditComment.js

@@ -0,0 +1,41 @@
+"use strict";
+
+exports.__esModule = true;
+exports.default = addEditCommentItem;
+var C = _interopRequireWildcard(require("../../../i18n/constants"));
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+/**
+ * @param {Comments} plugin The Comments plugin instance.
+ * @returns {object}
+ */
+function addEditCommentItem(plugin) {
+  return {
+    key: 'commentsAddEdit',
+    name() {
+      var _this$getSelectedRang;
+      const highlight = (_this$getSelectedRang = this.getSelectedRangeLast()) === null || _this$getSelectedRang === void 0 ? void 0 : _this$getSelectedRang.highlight;
+      if (highlight !== null && highlight !== void 0 && highlight.isCell() && plugin.getCommentAtCell(highlight.row, highlight.col)) {
+        return this.getTranslatedPhrase(C.CONTEXTMENU_ITEMS_EDIT_COMMENT);
+      }
+      return this.getTranslatedPhrase(C.CONTEXTMENU_ITEMS_ADD_COMMENT);
+    },
+    callback() {
+      const range = this.getSelectedRangeLast();
+      this.deselectCell();
+      plugin.setRange(range);
+      plugin.show();
+      plugin.focusEditor();
+    },
+    disabled() {
+      const range = this.getSelectedRangeLast();
+      if (!range) {
+        return true;
+      }
+      if (range.highlight.isHeader()) {
+        return true;
+      }
+      return this.countRenderedRows() === 0 || this.countRenderedCols() === 0;
+    }
+  };
+}

package/plugins/comments/contextMenuItem/addEditComment.mjs

@@ -0,0 +1,35 @@
+import * as C from "../../../i18n/constants.mjs";
+/**
+ * @param {Comments} plugin The Comments plugin instance.
+ * @returns {object}
+ */
+export default function addEditCommentItem(plugin) {
+  return {
+    key: 'commentsAddEdit',
+    name() {
+      var _this$getSelectedRang;
+      const highlight = (_this$getSelectedRang = this.getSelectedRangeLast()) === null || _this$getSelectedRang === void 0 ? void 0 : _this$getSelectedRang.highlight;
+      if (highlight !== null && highlight !== void 0 && highlight.isCell() && plugin.getCommentAtCell(highlight.row, highlight.col)) {
+        return this.getTranslatedPhrase(C.CONTEXTMENU_ITEMS_EDIT_COMMENT);
+      }
+      return this.getTranslatedPhrase(C.CONTEXTMENU_ITEMS_ADD_COMMENT);
+    },
+    callback() {
+      const range = this.getSelectedRangeLast();
+      this.deselectCell();
+      plugin.setRange(range);
+      plugin.show();
+      plugin.focusEditor();
+    },
+    disabled() {
+      const range = this.getSelectedRangeLast();
+      if (!range) {
+        return true;
+      }
+      if (range.highlight.isHeader()) {
+        return true;
+      }
+      return this.countRenderedRows() === 0 || this.countRenderedCols() === 0;
+    }
+  };
+}

package/plugins/comments/contextMenuItem/readOnlyComment.js

@@ -0,0 +1,49 @@
+"use strict";
+
+exports.__esModule = true;
+exports.default = readOnlyCommentItem;
+var C = _interopRequireWildcard(require("../../../i18n/constants"));
+var _utils = require("../../contextMenu/utils");
+var _comments = require("../comments");
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+/**
+ * @param {Comments} plugin The Comments plugin instance.
+ * @returns {object}
+ */
+function readOnlyCommentItem(plugin) {
+  return {
+    key: 'commentsReadOnly',
+    name() {
+      const label = this.getTranslatedPhrase(C.CONTEXTMENU_ITEMS_READ_ONLY_COMMENT);
+      const areReadOnly = (0, _utils.checkSelectionConsistency)(this.getSelectedRange(), (row, col) => {
+        return plugin.getCommentMeta(row, col, _comments.META_READONLY);
+      });
+      return areReadOnly ? (0, _utils.markLabelAsSelected)(label) : label;
+    },
+    callback() {
+      const range = this.getSelectedRangeLast();
+      range.forAll((row, column) => {
+        if (row >= 0 && column >= 0) {
+          const currentState = !!plugin.getCommentMeta(row, column, _comments.META_READONLY);
+          plugin.updateCommentMeta(row, column, {
+            [_comments.META_READONLY]: !currentState
+          });
+        }
+      });
+    },
+    disabled() {
+      const range = this.getSelectedRangeLast();
+      if (!range) {
+        return true;
+      }
+      if (range.highlight.isHeader()) {
+        return true;
+      }
+      if (!plugin.getCommentAtCell(range.highlight.row, range.highlight.col)) {
+        return true;
+      }
+      return this.countRenderedRows() === 0 || this.countRenderedCols() === 0;
+    }
+  };
+}

package/plugins/comments/contextMenuItem/readOnlyComment.mjs

@@ -0,0 +1,43 @@
+import * as C from "../../../i18n/constants.mjs";
+import { checkSelectionConsistency, markLabelAsSelected } from "../../contextMenu/utils.mjs";
+import { META_READONLY } from "../comments.mjs";
+/**
+ * @param {Comments} plugin The Comments plugin instance.
+ * @returns {object}
+ */
+export default function readOnlyCommentItem(plugin) {
+  return {
+    key: 'commentsReadOnly',
+    name() {
+      const label = this.getTranslatedPhrase(C.CONTEXTMENU_ITEMS_READ_ONLY_COMMENT);
+      const areReadOnly = checkSelectionConsistency(this.getSelectedRange(), (row, col) => {
+        return plugin.getCommentMeta(row, col, META_READONLY);
+      });
+      return areReadOnly ? markLabelAsSelected(label) : label;
+    },
+    callback() {
+      const range = this.getSelectedRangeLast();
+      range.forAll((row, column) => {
+        if (row >= 0 && column >= 0) {
+          const currentState = !!plugin.getCommentMeta(row, column, META_READONLY);
+          plugin.updateCommentMeta(row, column, {
+            [META_READONLY]: !currentState
+          });
+        }
+      });
+    },
+    disabled() {
+      const range = this.getSelectedRangeLast();
+      if (!range) {
+        return true;
+      }
+      if (range.highlight.isHeader()) {
+        return true;
+      }
+      if (!plugin.getCommentAtCell(range.highlight.row, range.highlight.col)) {
+        return true;
+      }
+      return this.countRenderedRows() === 0 || this.countRenderedCols() === 0;
+    }
+  };
+}

package/plugins/comments/contextMenuItem/removeComment.js

@@ -0,0 +1,38 @@
+"use strict";
+
+exports.__esModule = true;
+exports.default = removeCommentItem;
+var C = _interopRequireWildcard(require("../../../i18n/constants"));
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+/**
+ * @param {Comments} plugin The Comments plugin instance.
+ * @returns {object}
+ */
+function removeCommentItem(plugin) {
+  return {
+    key: 'commentsRemove',
+    name() {
+      return this.getTranslatedPhrase(C.CONTEXTMENU_ITEMS_REMOVE_COMMENT);
+    },
+    callback() {
+      const range = this.getSelectedRangeLast();
+      range.forAll((row, column) => {
+        if (row >= 0 && column >= 0) {
+          plugin.removeCommentAtCell(row, column, false);
+        }
+      });
+      this.render();
+    },
+    disabled() {
+      const range = this.getSelectedRangeLast();
+      if (!range) {
+        return true;
+      }
+      if (range.highlight.isHeader()) {
+        return true;
+      }
+      return this.countRenderedRows() === 0 || this.countRenderedCols() === 0;
+    }
+  };
+}

package/plugins/comments/contextMenuItem/removeComment.mjs

@@ -0,0 +1,32 @@
+import * as C from "../../../i18n/constants.mjs";
+/**
+ * @param {Comments} plugin The Comments plugin instance.
+ * @returns {object}
+ */
+export default function removeCommentItem(plugin) {
+  return {
+    key: 'commentsRemove',
+    name() {
+      return this.getTranslatedPhrase(C.CONTEXTMENU_ITEMS_REMOVE_COMMENT);
+    },
+    callback() {
+      const range = this.getSelectedRangeLast();
+      range.forAll((row, column) => {
+        if (row >= 0 && column >= 0) {
+          plugin.removeCommentAtCell(row, column, false);
+        }
+      });
+      this.render();
+    },
+    disabled() {
+      const range = this.getSelectedRangeLast();
+      if (!range) {
+        return true;
+      }
+      if (range.highlight.isHeader()) {
+        return true;
+      }
+      return this.countRenderedRows() === 0 || this.countRenderedCols() === 0;
+    }
+  };
+}

package/plugins/contextMenu/commandExecutor.js

@@ -85,6 +85,7 @@ class CommandExecutor {
  * @param {string[]} subCommands The collection of the commands.
  * @returns {boolean}
  */
+exports.CommandExecutor = CommandExecutor;
 function findSubCommand(subCommandName, subCommands) {
   let command;
   (0, _array.arrayEach)(subCommands, cmd => {
@@ -95,6 +96,4 @@ function findSubCommand(subCommandName, subCommands) {
     }
   });
   return command;
-}
-var _default = CommandExecutor;
-exports.default = _default;
+}

package/plugins/contextMenu/commandExecutor.mjs

@@ -9,7 +9,7 @@ import { hasOwnProperty } from "../../helpers/object.mjs";
  * @private
  * @class CommandExecutor
  */
-class CommandExecutor {
+export class CommandExecutor {
   constructor(hotInstance) {
     this.hot = hotInstance;
     this.commands = {};
@@ -92,5 +92,4 @@ function findSubCommand(subCommandName, subCommands) {
     }
   });
   return command;
-}
-export default CommandExecutor;
+}

package/plugins/contextMenu/contextMenu.d.ts

@@ -60,7 +60,7 @@ export class ContextMenu extends BasePlugin {
 
   constructor(hotInstance: Core);
   isEnabled(): boolean;
-  open(event: Event): void;
+  open(position: { left: number, top: number } | Event, offset?: { above?: number, below?: number, left?: number, right?: number }): void;
   close(): void;
   executeCommand(commandName: string, ...params: any): void;
 }

package/plugins/contextMenu/contextMenu.js

@@ -4,10 +4,12 @@ exports.__esModule = true;
 var _base = require("../base");
 var _pluginHooks = _interopRequireDefault(require("../../pluginHooks"));
 var _array = require("../../helpers/array");
-var _commandExecutor = _interopRequireDefault(require("./commandExecutor"));
+var _object = require("../../helpers/object");
+var _commandExecutor = require("./commandExecutor");
 var _eventManager = _interopRequireDefault(require("../../eventManager"));
-var _itemsFactory = _interopRequireDefault(require("./itemsFactory"));
-var _menu = _interopRequireDefault(require("./menu"));
+var _itemsFactory = require("./itemsFactory");
+var _menu = require("./menu");
+var _utils = require("./utils");
 var _element = require("../../helpers/dom/element");
 var _predefinedItems = require("./predefinedItems");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
@@ -15,6 +17,7 @@ const PLUGIN_KEY = 'contextMenu';
 exports.PLUGIN_KEY = PLUGIN_KEY;
 const PLUGIN_PRIORITY = 70;
 exports.PLUGIN_PRIORITY = PLUGIN_PRIORITY;
+const SHORTCUTS_GROUP = PLUGIN_KEY;
 _pluginHooks.default.getSingleton().register('afterContextMenuDefaultOptions');
 _pluginHooks.default.getSingleton().register('beforeContextMenuShow');
 _pluginHooks.default.getSingleton().register('afterContextMenuShow');
@@ -83,7 +86,7 @@ class ContextMenu extends _base.BasePlugin {
      * @private
      * @type {CommandExecutor}
      */
-    this.commandExecutor = new _commandExecutor.default(this.hot);
+    this.commandExecutor = new _commandExecutor.CommandExecutor(this.hot);
     /**
      * Instance of {@link ItemsFactory}.
      *
@@ -122,7 +125,7 @@ class ContextMenu extends _base.BasePlugin {
     if (typeof settings.callback === 'function') {
       this.commandExecutor.setCommonCallback(settings.callback);
     }
-    this.menu = new _menu.default(this.hot, {
+    this.menu = new _menu.Menu(this.hot, {
       className: 'htContextMenu',
       keepInViewport: true,
       container: settings.uiContainer || this.hot.rootDocument.body
@@ -137,6 +140,7 @@ class ContextMenu extends _base.BasePlugin {
       return _this.executeCommand.call(_this, ...params);
     });
     this.addHook('afterOnCellContextMenu', event => this.onAfterOnCellContextMenu(event));
+    this.registerShortcuts();
     super.enablePlugin();
   }
 
@@ -149,6 +153,7 @@ class ContextMenu extends _base.BasePlugin {
   updatePlugin() {
     this.disablePlugin();
     this.enablePlugin();
+    this.unregisterShortcuts();
     super.updatePlugin();
   }
 
@@ -164,50 +169,80 @@ class ContextMenu extends _base.BasePlugin {
     super.disablePlugin();
   }
 
+  /**
+   * Register shortcuts responsible for toggling context menu.
+   *
+   * @private
+   */
+  registerShortcuts() {
+    this.hot.getShortcutManager().getContext('grid').addShortcut({
+      keys: [['Control/Meta', 'Shift', '\\'], ['Shift', 'F10']],
+      callback: () => {
+        const {
+          highlight
+        } = this.hot.getSelectedRangeLast();
+        this.hot.scrollToFocusedCell();
+        const rect = this.hot.getCell(highlight.row, highlight.col, true).getBoundingClientRect();
+        const offset = (0, _utils.getDocumentOffsetByElement)(this.menu.container, this.hot.rootDocument);
+        this.open({
+          left: rect.left + offset.left,
+          top: rect.top + offset.top - 1 + rect.height
+        }, {
+          left: rect.width,
+          above: -rect.height
+        });
+      },
+      runOnlyIf: () => this.hot.getSelectedRangeLast() && !this.menu.isOpened(),
+      group: SHORTCUTS_GROUP
+    });
+  }
+
+  /**
+   * Unregister shortcuts responsible for toggling context menu.
+   *
+   * @private
+   */
+  unregisterShortcuts() {
+    this.hot.getShortcutManager().getContext('grid').removeShortcutsByGroup(SHORTCUTS_GROUP);
+  }
+
   /**
    * Opens menu and re-position it based on the passed coordinates.
    *
-   * @param {Event} event The mouse event object.
+   * @param {{ top: number, left: number }|Event} position An object with `top` and `left` properties
+   * which contains coordinates relative to the browsers viewport (without included scroll offsets).
+   * Or if the native event is passed the menu will be positioned based on the `pageX` and `pageY`
+   * coordinates.
+   * @param {{ above: number, below: number, left: number, right: number }} offset An object allows applying
+   * the offset to the menu position.
+   * @fires Hooks#beforeContextMenuShow
+   * @fires Hooks#afterContextMenuShow
    */
-  open(event) {
-    if (!this.menu) {
+  open(position) {
+    var _this$menu;
+    let offset = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {
+      above: 0,
+      below: 0,
+      left: 0,
+      right: 0
+    };
+    if ((_this$menu = this.menu) !== null && _this$menu !== void 0 && _this$menu.isOpened()) {
       return;
     }
     this.prepareMenuItems();
     this.menu.open();
-    if (!this.menu.isOpened()) {
-      return;
-    }
-    let offsetTop = 0;
-    let offsetLeft = 0;
-    if (this.hot.rootDocument !== this.menu.container.ownerDocument) {
-      const {
-        frameElement
-      } = this.hot.rootWindow;
-      const {
-        top,
-        left
-      } = frameElement.getBoundingClientRect();
-      offsetTop = top - (0, _element.getWindowScrollTop)(event.view);
-      offsetLeft = left - (0, _element.getWindowScrollLeft)(event.view);
-    } else {
-      offsetTop = -1 * (0, _element.getWindowScrollTop)(this.menu.hotMenu.rootWindow);
-      offsetLeft = -1 * (0, _element.getWindowScrollLeft)(this.menu.hotMenu.rootWindow);
-    }
-    this.menu.setPosition({
-      top: parseInt(event.pageY, 10) + offsetTop,
-      left: parseInt(event.pageX, 10) + offsetLeft
+    (0, _object.objectEach)(offset, (value, key) => {
+      this.menu.setOffset(key, value);
     });
+    this.menu.setPosition(position);
   }
 
   /**
    * Closes the menu.
    */
   close() {
-    if (!this.menu) {
-      return;
-    }
-    this.menu.close();
+    var _this$menu2;
+    (_this$menu2 = this.menu) === null || _this$menu2 === void 0 || _this$menu2.close();
     this.itemsFactory = null;
   }
 
@@ -259,7 +294,7 @@ class ContextMenu extends _base.BasePlugin {
    * @fires Hooks#beforeContextMenuSetItems
    */
   prepareMenuItems() {
-    this.itemsFactory = new _itemsFactory.default(this.hot, ContextMenu.DEFAULT_ITEMS);
+    this.itemsFactory = new _itemsFactory.ItemsFactory(this.hot, ContextMenu.DEFAULT_ITEMS);
     const settings = this.hot.getSettings()[PLUGIN_KEY];
     const predefinedItems = {
       items: this.itemsFactory.getItems(settings)
@@ -305,7 +340,11 @@ class ContextMenu extends _base.BasePlugin {
         return;
       }
     }
-    this.open(event);
+    const offset = (0, _utils.getDocumentOffsetByElement)(this.menu.container, this.hot.rootDocument);
+    this.open({
+      top: event.clientY + offset.top,
+      left: event.clientX + offset.left
+    });
   }
 
   /**

package/plugins/contextMenu/contextMenu.mjs

@@ -1,14 +1,17 @@
 import { BasePlugin } from "../base/index.mjs";
 import Hooks from "../../pluginHooks.mjs";
 import { arrayEach } from "../../helpers/array.mjs";
-import CommandExecutor from "./commandExecutor.mjs";
+import { objectEach } from "../../helpers/object.mjs";
+import { CommandExecutor } from "./commandExecutor.mjs";
 import EventManager from "../../eventManager.mjs";
-import ItemsFactory from "./itemsFactory.mjs";
-import Menu from "./menu.mjs";
-import { getWindowScrollLeft, getWindowScrollTop, hasClass } from "../../helpers/dom/element.mjs";
-import { ROW_ABOVE, ROW_BELOW, COLUMN_LEFT, COLUMN_RIGHT, REMOVE_ROW, REMOVE_COLUMN, UNDO, REDO, READ_ONLY, ALIGNMENT, SEPARATOR } from "./predefinedItems.mjs";
+import { ItemsFactory } from "./itemsFactory.mjs";
+import { Menu } from "./menu/index.mjs";
+import { getDocumentOffsetByElement } from "./utils.mjs";
+import { hasClass } from "../../helpers/dom/element.mjs";
+import { ROW_ABOVE, ROW_BELOW, COLUMN_LEFT, COLUMN_RIGHT, REMOVE_ROW, REMOVE_COLUMN, UNDO, REDO, READ_ONLY, ALIGNMENT, SEPARATOR } from "./predefinedItems/index.mjs";
 export const PLUGIN_KEY = 'contextMenu';
 export const PLUGIN_PRIORITY = 70;
+const SHORTCUTS_GROUP = PLUGIN_KEY;
 Hooks.getSingleton().register('afterContextMenuDefaultOptions');
 Hooks.getSingleton().register('beforeContextMenuShow');
 Hooks.getSingleton().register('afterContextMenuShow');
@@ -131,6 +134,7 @@ export class ContextMenu extends BasePlugin {
       return _this.executeCommand.call(_this, ...params);
     });
     this.addHook('afterOnCellContextMenu', event => this.onAfterOnCellContextMenu(event));
+    this.registerShortcuts();
     super.enablePlugin();
   }
 
@@ -143,6 +147,7 @@ export class ContextMenu extends BasePlugin {
   updatePlugin() {
     this.disablePlugin();
     this.enablePlugin();
+    this.unregisterShortcuts();
     super.updatePlugin();
   }
 
@@ -158,50 +163,80 @@ export class ContextMenu extends BasePlugin {
     super.disablePlugin();
   }
 
+  /**
+   * Register shortcuts responsible for toggling context menu.
+   *
+   * @private
+   */
+  registerShortcuts() {
+    this.hot.getShortcutManager().getContext('grid').addShortcut({
+      keys: [['Control/Meta', 'Shift', '\\'], ['Shift', 'F10']],
+      callback: () => {
+        const {
+          highlight
+        } = this.hot.getSelectedRangeLast();
+        this.hot.scrollToFocusedCell();
+        const rect = this.hot.getCell(highlight.row, highlight.col, true).getBoundingClientRect();
+        const offset = getDocumentOffsetByElement(this.menu.container, this.hot.rootDocument);
+        this.open({
+          left: rect.left + offset.left,
+          top: rect.top + offset.top - 1 + rect.height
+        }, {
+          left: rect.width,
+          above: -rect.height
+        });
+      },
+      runOnlyIf: () => this.hot.getSelectedRangeLast() && !this.menu.isOpened(),
+      group: SHORTCUTS_GROUP
+    });
+  }
+
+  /**
+   * Unregister shortcuts responsible for toggling context menu.
+   *
+   * @private
+   */
+  unregisterShortcuts() {
+    this.hot.getShortcutManager().getContext('grid').removeShortcutsByGroup(SHORTCUTS_GROUP);
+  }
+
   /**
    * Opens menu and re-position it based on the passed coordinates.
    *
-   * @param {Event} event The mouse event object.
+   * @param {{ top: number, left: number }|Event} position An object with `top` and `left` properties
+   * which contains coordinates relative to the browsers viewport (without included scroll offsets).
+   * Or if the native event is passed the menu will be positioned based on the `pageX` and `pageY`
+   * coordinates.
+   * @param {{ above: number, below: number, left: number, right: number }} offset An object allows applying
+   * the offset to the menu position.
+   * @fires Hooks#beforeContextMenuShow
+   * @fires Hooks#afterContextMenuShow
    */
-  open(event) {
-    if (!this.menu) {
+  open(position) {
+    var _this$menu;
+    let offset = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {
+      above: 0,
+      below: 0,
+      left: 0,
+      right: 0
+    };
+    if ((_this$menu = this.menu) !== null && _this$menu !== void 0 && _this$menu.isOpened()) {
       return;
     }
     this.prepareMenuItems();
     this.menu.open();
-    if (!this.menu.isOpened()) {
-      return;
-    }
-    let offsetTop = 0;
-    let offsetLeft = 0;
-    if (this.hot.rootDocument !== this.menu.container.ownerDocument) {
-      const {
-        frameElement
-      } = this.hot.rootWindow;
-      const {
-        top,
-        left
-      } = frameElement.getBoundingClientRect();
-      offsetTop = top - getWindowScrollTop(event.view);
-      offsetLeft = left - getWindowScrollLeft(event.view);
-    } else {
-      offsetTop = -1 * getWindowScrollTop(this.menu.hotMenu.rootWindow);
-      offsetLeft = -1 * getWindowScrollLeft(this.menu.hotMenu.rootWindow);
-    }
-    this.menu.setPosition({
-      top: parseInt(event.pageY, 10) + offsetTop,
-      left: parseInt(event.pageX, 10) + offsetLeft
+    objectEach(offset, (value, key) => {
+      this.menu.setOffset(key, value);
     });
+    this.menu.setPosition(position);
   }
 
   /**
    * Closes the menu.
    */
   close() {
-    if (!this.menu) {
-      return;
-    }
-    this.menu.close();
+    var _this$menu2;
+    (_this$menu2 = this.menu) === null || _this$menu2 === void 0 || _this$menu2.close();
     this.itemsFactory = null;
   }
 
@@ -299,7 +334,11 @@ export class ContextMenu extends BasePlugin {
         return;
       }
     }
-    this.open(event);
+    const offset = getDocumentOffsetByElement(this.menu.container, this.hot.rootDocument);
+    this.open({
+      top: event.clientY + offset.top,
+      left: event.clientX + offset.left
+    });
   }
 
   /**

package/plugins/contextMenu/itemsFactory.js

@@ -66,6 +66,7 @@ class ItemsFactory {
  * @param {object} items Additional options.
  * @returns {object[]} Returns parsed and merged menu items collection ready to render.
  */
+exports.ItemsFactory = ItemsFactory;
 function getItems() {
   let itemsPattern = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : null;
   let defaultPattern = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : [];
@@ -119,6 +120,4 @@ function getItems() {
     });
   }
   return result;
-}
-var _default = ItemsFactory;
-exports.default = _default;
+}

package/plugins/contextMenu/itemsFactory.mjs

@@ -1,14 +1,14 @@
 import "core-js/modules/es.array.push.js";
 import { objectEach, isObject, extend } from "../../helpers/object.mjs";
 import { arrayEach } from "../../helpers/array.mjs";
-import { SEPARATOR, ITEMS, predefinedItems } from "./predefinedItems.mjs";
+import { SEPARATOR, ITEMS, predefinedItems } from "./predefinedItems/index.mjs";
 /**
  * Predefined items class factory for menu items.
  *
  * @private
  * @class ItemsFactory
  */
-class ItemsFactory {
+export class ItemsFactory {
   constructor(hotInstance) {
     let orderPattern = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : null;
     this.hot = hotInstance;
@@ -116,5 +116,4 @@ function getItems() {
     });
   }
   return result;
-}
-export default ItemsFactory;
+}