handsontable 9.0.2 → 11.1.0

package/plugins/comments/comments.mjs

@@ -1,4 +1,4 @@
-function _typeof(obj) { "@babel/helpers - typeof"; if (typeof Symbol === "function" && typeof Symbol.iterator === "symbol") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }; } return _typeof(obj); }
+function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
 
 function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
 
@@ -6,19 +6,19 @@ function _classCallCheck(instance, Constructor) { if (!(instance instanceof Cons
 
 function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }
 
-function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
 
-function _get(target, property, receiver) { if (typeof Reflect !== "undefined" && Reflect.get) { _get = Reflect.get; } else { _get = function _get(target, property, receiver) { var base = _superPropBase(target, property); if (!base) return; var desc = Object.getOwnPropertyDescriptor(base, property); if (desc.get) { return desc.get.call(receiver); } return desc.value; }; } return _get(target, property, receiver || target); }
+function _get() { if (typeof Reflect !== "undefined" && Reflect.get) { _get = Reflect.get; } else { _get = function _get(target, property, receiver) { var base = _superPropBase(target, property); if (!base) return; var desc = Object.getOwnPropertyDescriptor(base, property); if (desc.get) { return desc.get.call(arguments.length < 3 ? target : receiver); } return desc.value; }; } return _get.apply(this, arguments); }
 
 function _superPropBase(object, property) { while (!Object.prototype.hasOwnProperty.call(object, property)) { object = _getPrototypeOf(object); if (object === null) break; } return object; }
 
-function _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); if (superClass) _setPrototypeOf(subClass, superClass); }
+function _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); Object.defineProperty(subClass, "prototype", { writable: false }); if (superClass) _setPrototypeOf(subClass, superClass); }
 
 function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf || function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }
 
 function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
 
-function _possibleConstructorReturn(self, call) { if (call && (_typeof(call) === "object" || typeof call === "function")) { return call; } return _assertThisInitialized(self); }
+function _possibleConstructorReturn(self, call) { if (call && (_typeof(call) === "object" || typeof call === "function")) { return call; } else if (call !== void 0) { throw new TypeError("Derived constructors may only return object or undefined"); } return _assertThisInitialized(self); }
 
 function _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); } return self; }
 
@@ -31,7 +31,6 @@ import "core-js/modules/es.object.to-string.js";
 import "core-js/modules/es.string.iterator.js";
 import "core-js/modules/es.weak-map.js";
 import "core-js/modules/web.dom-collections.iterator.js";
-import "core-js/modules/web.timers.js";
 import "core-js/modules/es.object.set-prototype-of.js";
 import "core-js/modules/es.object.get-prototype-of.js";
 import "core-js/modules/es.reflect.construct.js";
@@ -43,7 +42,7 @@ import "core-js/modules/es.symbol.iterator.js";
 import { addClass, closest, isChildOf, hasClass, offset, outerWidth, outerHeight } from "../../helpers/dom/element.mjs";
 import { deepClone, deepExtend, isObject } from "../../helpers/object.mjs";
 import EventManager from "../../eventManager.mjs";
-import { CellCoords } from "../../3rdparty/walkontable/src/index.mjs";
+import { CellCoords, CellRange } from "../../3rdparty/walkontable/src/index.mjs";
 import { BasePlugin } from "../base/index.mjs";
 import CommentEditor from "./commentEditor.mjs";
 import { checkSelectionConsistency, markLabelAsSelected } from "../contextMenu/utils.mjs";
@@ -75,7 +74,12 @@ var META_READONLY = 'readOnly';
  *
  * ```js
  * comments: {
- *   displayDelay: 1000
+ *   displayDelay: 1000,
+ *   readOnly: true,
+ *   style: {
+ *     width: 300,
+ *     height: 100
+ *   }
  * }
  * ```
  *
@@ -154,23 +158,13 @@ export var Comments = /*#__PURE__*/function (_BasePlugin) {
 
     _this.range = {};
     /**
+     * Prevents showing/hiding editor that reacts on the logic triggered by the "mouseover" events.
+     *
      * @private
      * @type {boolean}
      */
 
-    _this.mouseDown = false;
-    /**
-     * @private
-     * @type {boolean}
-     */
-
-    _this.contextMenuEvent = false;
-    /**
-     * @private
-     * @type {*}
-     */
-
-    _this.timer = null;
+    _this.preventEditorAutoSwitch = false;
     privatePool.set(_assertThisInitialized(_this), {
       tempEditorDimensions: {},
       cellBelowCursor: null
@@ -228,7 +222,7 @@ export var Comments = /*#__PURE__*/function (_BasePlugin) {
         return _this2.hide();
       });
       this.addHook('afterBeginEditing', function () {
-        return _this2.onAfterBeginEditing();
+        return _this2.hide();
       });
       this.displaySwitch.addLocalHook('hide', function () {
         return _this2.hide();
@@ -399,7 +393,7 @@ export var Comments = /*#__PURE__*/function (_BasePlugin) {
         throw new Error('Before using this method, first set cell range (hot.getPlugin("comment").setRange())');
       }
 
-      this.hot.setCellMeta(this.range.from.row, this.range.from.col, META_COMMENT, void 0);
+      this.hot.setCellMeta(this.range.from.row, this.range.from.col, META_COMMENT);
 
       if (forceRender) {
         this.hot.render();
@@ -504,9 +498,7 @@ export var Comments = /*#__PURE__*/function (_BasePlugin) {
   }, {
     key: "hide",
     value: function hide() {
-      if (!this.editor.hidden) {
-        this.editor.hide();
-      }
+      this.editor.hide();
     }
     /**
      * Refreshes comment editor position and styling.
@@ -665,30 +657,22 @@ export var Comments = /*#__PURE__*/function (_BasePlugin) {
   }, {
     key: "onMouseDown",
     value: function onMouseDown(event) {
-      this.mouseDown = true;
-
       if (!this.hot.view || !this.hot.view.wt) {
         return;
       }
 
-      if (!this.contextMenuEvent && !this.targetIsCommentTextArea(event)) {
+      if (!this.preventEditorAutoSwitch && !this.targetIsCommentTextArea(event)) {
         var eventCell = closest(event.target, 'TD', 'TBODY');
         var coordinates = null;
 
         if (eventCell) {
-          coordinates = this.hot.view.wt.wtTable.getCoords(eventCell);
-          coordinates = {
-            row: this.hot.rowIndexMapper.getVisualFromRenderableIndex(coordinates.row),
-            col: this.hot.columnIndexMapper.getVisualFromRenderableIndex(coordinates.col)
-          };
+          coordinates = this.hot.getCoords(eventCell);
         }
 
         if (!eventCell || this.range.from && coordinates && (this.range.from.row !== coordinates.row || this.range.from.col !== coordinates.col)) {
           this.hide();
         }
       }
-
-      this.contextMenuEvent = false;
     }
     /**
      * `mouseover` event callback.
@@ -702,17 +686,15 @@ export var Comments = /*#__PURE__*/function (_BasePlugin) {
     value: function onMouseOver(event) {
       var priv = privatePool.get(this);
       var rootDocument = this.hot.rootDocument;
-      priv.cellBelowCursor = rootDocument.elementFromPoint(event.clientX, event.clientY);
 
-      if (this.mouseDown || this.editor.isFocused() || hasClass(event.target, 'wtBorder') || priv.cellBelowCursor !== event.target || !this.editor) {
+      if (this.preventEditorAutoSwitch || this.editor.isFocused() || hasClass(event.target, 'wtBorder') || priv.cellBelowCursor === event.target || !this.editor) {
         return;
       }
 
+      priv.cellBelowCursor = rootDocument.elementFromPoint(event.clientX, event.clientY);
+
       if (this.targetIsCellWithComment(event)) {
-        var coordinates = this.hot.view.wt.wtTable.getCoords(event.target);
-        var range = {
-          from: new CellCoords(this.hot.rowIndexMapper.getVisualFromRenderableIndex(coordinates.row), this.hot.columnIndexMapper.getVisualFromRenderableIndex(coordinates.col))
-        };
+        var range = new CellRange(this.hot.getCoords(event.target));
         this.displaySwitch.show(range);
       } else if (isChildOf(event.target, rootDocument) && !this.targetIsCommentTextArea(event)) {
         this.displaySwitch.hide();
@@ -727,7 +709,7 @@ export var Comments = /*#__PURE__*/function (_BasePlugin) {
   }, {
     key: "onMouseUp",
     value: function onMouseUp() {
-      this.mouseDown = false;
+      this.preventEditorAutoSwitch = false;
     }
     /**
      * The `afterRenderer` hook callback.
@@ -801,22 +783,15 @@ export var Comments = /*#__PURE__*/function (_BasePlugin) {
   }, {
     key: "onContextMenuAddComment",
     value: function onContextMenuAddComment() {
-      var _this4 = this;
-
-      this.displaySwitch.cancelHiding();
       var coords = this.hot.getSelectedRangeLast();
-      this.contextMenuEvent = true;
+      this.preventEditorAutoSwitch = true;
+      this.displaySwitch.cancelHiding();
       this.setRange({
         from: coords.highlight
       });
       this.show();
-      setTimeout(function () {
-        if (_this4.hot) {
-          _this4.hot.deselectCell();
-
-          _this4.editor.focus();
-        }
-      }, 10);
+      this.hot.deselectCell();
+      this.editor.focus();
     }
     /**
      * Context Menu's "remove comment" callback.
@@ -827,13 +802,13 @@ export var Comments = /*#__PURE__*/function (_BasePlugin) {
   }, {
     key: "onContextMenuRemoveComment",
     value: function onContextMenuRemoveComment() {
-      var _this5 = this;
+      var _this4 = this;
 
       var coords = this.hot.getSelectedRangeLast();
-      this.contextMenuEvent = true;
+      this.preventEditorAutoSwitch = true;
       coords.forAll(function (row, column) {
         if (row >= 0 && column >= 0) {
-          _this5.removeCommentAtCell(row, column, false);
+          _this4.removeCommentAtCell(row, column, false);
         }
       });
       this.hot.render();
@@ -847,15 +822,15 @@ export var Comments = /*#__PURE__*/function (_BasePlugin) {
   }, {
     key: "onContextMenuMakeReadOnly",
     value: function onContextMenuMakeReadOnly() {
-      var _this6 = this;
+      var _this5 = this;
 
       var coords = this.hot.getSelectedRangeLast();
-      this.contextMenuEvent = true;
+      this.preventEditorAutoSwitch = true;
       coords.forAll(function (row, column) {
         if (row >= 0 && column >= 0) {
-          var currentState = !!_this6.getCommentMeta(row, column, META_READONLY);
+          var currentState = !!_this5.getCommentMeta(row, column, META_READONLY);
 
-          _this6.updateCommentMeta(row, column, _defineProperty({}, META_READONLY, !currentState));
+          _this5.updateCommentMeta(row, column, _defineProperty({}, META_READONLY, !currentState));
         }
       });
     }
@@ -869,10 +844,10 @@ export var Comments = /*#__PURE__*/function (_BasePlugin) {
   }, {
     key: "addToContextMenu",
     value: function addToContextMenu(defaultOptions) {
-      var _this7 = this;
+      var _this6 = this;
 
       var isThereAnyCellRendered = function isThereAnyCellRendered() {
-        return _this7.hot.rowIndexMapper.getRenderableIndexesLength() > 0 && _this7.hot.columnIndexMapper.getRenderableIndexesLength() > 0;
+        return _this6.hot.rowIndexMapper.getRenderableIndexesLength() > 0 && _this6.hot.columnIndexMapper.getRenderableIndexesLength() > 0;
       };
 
       defaultOptions.items.push({
@@ -880,21 +855,21 @@ export var Comments = /*#__PURE__*/function (_BasePlugin) {
       }, {
         key: 'commentsAddEdit',
         name: function name() {
-          if (_this7.checkSelectionCommentsConsistency()) {
-            return _this7.hot.getTranslatedPhrase(C.CONTEXTMENU_ITEMS_EDIT_COMMENT);
+          if (_this6.checkSelectionCommentsConsistency()) {
+            return _this6.hot.getTranslatedPhrase(C.CONTEXTMENU_ITEMS_EDIT_COMMENT);
           }
 
-          return _this7.hot.getTranslatedPhrase(C.CONTEXTMENU_ITEMS_ADD_COMMENT);
+          return _this6.hot.getTranslatedPhrase(C.CONTEXTMENU_ITEMS_ADD_COMMENT);
         },
         callback: function callback() {
-          return _this7.onContextMenuAddComment();
+          return _this6.onContextMenuAddComment();
         },
         disabled: function disabled() {
           if (!isThereAnyCellRendered()) {
             return true;
           }
 
-          return !(_this7.hot.getSelectedLast() && !_this7.hot.selection.isSelectedByCorner());
+          return !(_this6.hot.getSelectedLast() && !_this6.hot.selection.isSelectedByCorner());
         }
       }, {
         key: 'commentsRemove',
@@ -902,23 +877,23 @@ export var Comments = /*#__PURE__*/function (_BasePlugin) {
           return this.getTranslatedPhrase(C.CONTEXTMENU_ITEMS_REMOVE_COMMENT);
         },
         callback: function callback() {
-          return _this7.onContextMenuRemoveComment();
+          return _this6.onContextMenuRemoveComment();
         },
         disabled: function disabled() {
           if (!isThereAnyCellRendered()) {
             return true;
           }
 
-          return !(_this7.hot.getSelectedLast() && !_this7.hot.selection.isSelectedByCorner());
+          return !(_this6.hot.getSelectedLast() && !_this6.hot.selection.isSelectedByCorner());
         }
       }, {
         key: 'commentsReadOnly',
         name: function name() {
-          var _this8 = this;
+          var _this7 = this;
 
           var label = this.getTranslatedPhrase(C.CONTEXTMENU_ITEMS_READ_ONLY_COMMENT);
           var hasProperty = checkSelectionConsistency(this.getSelectedRangeLast(), function (row, col) {
-            var readOnlyProperty = _this8.getCellMeta(row, col)[META_COMMENT];
+            var readOnlyProperty = _this7.getCellMeta(row, col)[META_COMMENT];
 
             if (readOnlyProperty) {
               readOnlyProperty = readOnlyProperty[META_READONLY];
@@ -936,14 +911,14 @@ export var Comments = /*#__PURE__*/function (_BasePlugin) {
           return label;
         },
         callback: function callback() {
-          return _this7.onContextMenuMakeReadOnly();
+          return _this6.onContextMenuMakeReadOnly();
         },
         disabled: function disabled() {
           if (!isThereAnyCellRendered()) {
             return true;
           }
 
-          return !(_this7.hot.getSelectedLast() && !_this7.hot.selection.isSelectedByCorner()) || !_this7.checkSelectionCommentsConsistency();
+          return !(_this6.hot.getSelectedLast() && !_this6.hot.selection.isSelectedByCorner()) || !_this6.checkSelectionCommentsConsistency();
         }
       });
     }
@@ -962,19 +937,6 @@ export var Comments = /*#__PURE__*/function (_BasePlugin) {
       if (isObject(commentSetting)) {
         return commentSetting.displayDelay;
       }
-
-      return void 0;
-    }
-    /**
-     * `afterBeginEditing` hook callback.
-     *
-     * @private
-     */
-
-  }, {
-    key: "onAfterBeginEditing",
-    value: function onAfterBeginEditing() {
-      this.hide();
     }
     /**
      * Destroys the plugin instance.

package/plugins/comments/displaySwitch.js

@@ -17,15 +17,15 @@ function _classCallCheck(instance, Constructor) { if (!(instance instanceof Cons
 
 function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }
 
-function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
 
 var DEFAULT_DISPLAY_DELAY = 250;
 var DEFAULT_HIDE_DELAY = 250;
 /**
  * Display switch for the Comments plugin. Manages the time of delayed displaying / hiding comments.
  *
+ * @private
  * @class DisplaySwitch
- * @plugin Comments
  */
 
 var DisplaySwitch = /*#__PURE__*/function () {

package/plugins/comments/displaySwitch.mjs

@@ -4,7 +4,7 @@ function _classCallCheck(instance, Constructor) { if (!(instance instanceof Cons
 
 function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }
 
-function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
 
 import { debounce } from "../../helpers/function.mjs";
 import { mixin } from "../../helpers/object.mjs";
@@ -14,8 +14,8 @@ var DEFAULT_HIDE_DELAY = 250;
 /**
  * Display switch for the Comments plugin. Manages the time of delayed displaying / hiding comments.
  *
+ * @private
  * @class DisplaySwitch
- * @plugin Comments
  */
 
 var DisplaySwitch = /*#__PURE__*/function () {

package/plugins/comments/index.d.ts

@@ -0,0 +1 @@
+export * from './comments';

package/plugins/comments/index.js

@@ -1,7 +1,7 @@
 "use strict";
 
 exports.__esModule = true;
-exports.Comments = exports.PLUGIN_PRIORITY = exports.PLUGIN_KEY = void 0;
+exports.PLUGIN_PRIORITY = exports.PLUGIN_KEY = exports.Comments = void 0;
 
 var _comments = require("./comments");
 

package/plugins/contextMenu/commandExecutor.js

@@ -17,13 +17,13 @@ function _classCallCheck(instance, Constructor) { if (!(instance instanceof Cons
 
 function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }
 
-function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
 
 /**
  * Command executor for ContextMenu.
  *
+ * @private
  * @class CommandExecutor
- * @plugin ContextMenu
  */
 var CommandExecutor = /*#__PURE__*/function () {
   function CommandExecutor(hotInstance) {

package/plugins/contextMenu/commandExecutor.mjs

@@ -6,15 +6,15 @@ function _classCallCheck(instance, Constructor) { if (!(instance instanceof Cons
 
 function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }
 
-function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
 
 import { arrayEach } from "../../helpers/array.mjs";
 import { hasOwnProperty } from "../../helpers/object.mjs";
 /**
  * Command executor for ContextMenu.
  *
+ * @private
  * @class CommandExecutor
- * @plugin ContextMenu
  */
 
 var CommandExecutor = /*#__PURE__*/function () {

package/plugins/contextMenu/contextMenu.d.ts

@@ -0,0 +1,65 @@
+import CellCoords from '../../3rdparty/walkontable/src/cell/coords';
+import Core from '../../core';
+import { BasePlugin } from '../base';
+
+export type PredefinedMenuItemKey = 'row_above' | 'row_below' | 'col_left' | 'col_right' |
+  '---------' | 'remove_row' | 'remove_col' | 'clear_column' | 'undo' | 'redo' |
+  'make_read_only' | 'alignment' | 'cut' | 'copy' | 'freeze_column' | 'unfreeze_column' |
+  'borders' | 'commentsAddEdit' | 'commentsRemove' | 'commentsReadOnly' | 'mergeCells' |
+  'add_child' | 'detach_from_parent' | 'hidden_columns_hide' | 'hidden_columns_show' |
+  'hidden_rows_hide' | 'hidden_rows_show' | 'filter_by_condition' | 'filter_operators' |
+  'filter_by_condition2' | 'filter_by_value' | 'filter_action_bar';
+
+export interface SeparatorObject {
+  name: string;
+}
+
+export interface Selection {
+  start: CellCoords;
+  end: CellCoords;
+}
+
+export interface MenuConfig {
+  [key: string]: MenuItemConfig;
+}
+
+export interface MenuItemConfig {
+  name?: string | ((this: Core) => string);
+  key?: string;
+  hidden?: boolean | ((this: Core) => boolean | void);
+  disabled?: boolean | ((this: Core) => boolean | void);
+  disableSelection?: boolean;
+  isCommand?: boolean;
+  callback?(this: Core, key: string, selection: Selection[], clickEvent: MouseEvent): void;
+  renderer?(this: MenuItemConfig, hot: Core, wrapper: HTMLElement, row: number, col: number, prop: number | string, itemValue: string): HTMLElement;
+  submenu?: SubmenuConfig;
+}
+
+export interface SubmenuConfig {
+  items: SubmenuItemConfig[];
+}
+
+export interface SubmenuItemConfig extends Omit<MenuItemConfig, "key"> {
+  /**
+   * Submenu item `key` must be defined as "parent_key:sub_key" where "parent_key" is the parent MenuItemConfig key.
+   */
+  key: string;
+}
+
+export interface DetailedSettings {
+  callback?: (key: string, selection: Selection[], clickEvent: MouseEvent) => void;
+  items: PredefinedMenuItemKey[] | MenuConfig;
+}
+
+export type Settings = boolean | PredefinedMenuItemKey[] | DetailedSettings;
+
+export class ContextMenu extends BasePlugin {
+  static DEFAULT_ITEMS: PredefinedMenuItemKey[];
+  static SEPARATOR: SeparatorObject;
+
+  constructor(hotInstance: Core);
+  isEnabled(): boolean;
+  open(event: Event): void;
+  close(): void;
+  executeCommand(commandName: string, ...params: any): void;
+}

package/plugins/contextMenu/contextMenu.js

@@ -1,6 +1,8 @@
 "use strict";
 
-function _typeof(obj) { "@babel/helpers - typeof"; if (typeof Symbol === "function" && typeof Symbol.iterator === "symbol") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }; } return _typeof(obj); }
+function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
+
+require("core-js/modules/es.object.to-string.js");
 
 require("core-js/modules/es.reflect.construct.js");
 
@@ -12,8 +14,6 @@ require("core-js/modules/es.symbol.js");
 
 require("core-js/modules/es.symbol.description.js");
 
-require("core-js/modules/es.object.to-string.js");
-
 require("core-js/modules/es.symbol.iterator.js");
 
 require("core-js/modules/es.array.iterator.js");
@@ -23,7 +23,7 @@ require("core-js/modules/es.string.iterator.js");
 require("core-js/modules/web.dom-collections.iterator.js");
 
 exports.__esModule = true;
-exports.ContextMenu = exports.PLUGIN_PRIORITY = exports.PLUGIN_KEY = void 0;
+exports.PLUGIN_PRIORITY = exports.PLUGIN_KEY = exports.ContextMenu = void 0;
 
 require("core-js/modules/es.array.concat.js");
 
@@ -55,19 +55,19 @@ function _classCallCheck(instance, Constructor) { if (!(instance instanceof Cons
 
 function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }
 
-function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
 
-function _get(target, property, receiver) { if (typeof Reflect !== "undefined" && Reflect.get) { _get = Reflect.get; } else { _get = function _get(target, property, receiver) { var base = _superPropBase(target, property); if (!base) return; var desc = Object.getOwnPropertyDescriptor(base, property); if (desc.get) { return desc.get.call(receiver); } return desc.value; }; } return _get(target, property, receiver || target); }
+function _get() { if (typeof Reflect !== "undefined" && Reflect.get) { _get = Reflect.get; } else { _get = function _get(target, property, receiver) { var base = _superPropBase(target, property); if (!base) return; var desc = Object.getOwnPropertyDescriptor(base, property); if (desc.get) { return desc.get.call(arguments.length < 3 ? target : receiver); } return desc.value; }; } return _get.apply(this, arguments); }
 
 function _superPropBase(object, property) { while (!Object.prototype.hasOwnProperty.call(object, property)) { object = _getPrototypeOf(object); if (object === null) break; } return object; }
 
-function _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); if (superClass) _setPrototypeOf(subClass, superClass); }
+function _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); Object.defineProperty(subClass, "prototype", { writable: false }); if (superClass) _setPrototypeOf(subClass, superClass); }
 
 function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf || function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }
 
 function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
 
-function _possibleConstructorReturn(self, call) { if (call && (_typeof(call) === "object" || typeof call === "function")) { return call; } return _assertThisInitialized(self); }
+function _possibleConstructorReturn(self, call) { if (call && (_typeof(call) === "object" || typeof call === "function")) { return call; } else if (call !== void 0) { throw new TypeError("Derived constructors may only return object or undefined"); } return _assertThisInitialized(self); }
 
 function _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); } return self; }
 
@@ -407,6 +407,7 @@ var ContextMenu = /*#__PURE__*/function (_BasePlugin) {
       var showRowHeaders = settings.rowHeaders;
       var showColHeaders = settings.colHeaders;
       /**
+       * @private
        * @param {HTMLElement} element The element to validate.
        * @returns {boolean}
        */

package/plugins/contextMenu/contextMenu.mjs

@@ -1,14 +1,14 @@
-function _typeof(obj) { "@babel/helpers - typeof"; if (typeof Symbol === "function" && typeof Symbol.iterator === "symbol") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }; } return _typeof(obj); }
+function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
 
 import "core-js/modules/es.array.concat.js";
 import "core-js/modules/es.object.set-prototype-of.js";
 import "core-js/modules/es.object.get-prototype-of.js";
+import "core-js/modules/es.object.to-string.js";
 import "core-js/modules/es.reflect.construct.js";
 import "core-js/modules/es.reflect.get.js";
 import "core-js/modules/es.object.get-own-property-descriptor.js";
 import "core-js/modules/es.symbol.js";
 import "core-js/modules/es.symbol.description.js";
-import "core-js/modules/es.object.to-string.js";
 import "core-js/modules/es.symbol.iterator.js";
 import "core-js/modules/es.array.iterator.js";
 import "core-js/modules/es.string.iterator.js";
@@ -18,19 +18,19 @@ function _classCallCheck(instance, Constructor) { if (!(instance instanceof Cons
 
 function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }
 
-function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
 
-function _get(target, property, receiver) { if (typeof Reflect !== "undefined" && Reflect.get) { _get = Reflect.get; } else { _get = function _get(target, property, receiver) { var base = _superPropBase(target, property); if (!base) return; var desc = Object.getOwnPropertyDescriptor(base, property); if (desc.get) { return desc.get.call(receiver); } return desc.value; }; } return _get(target, property, receiver || target); }
+function _get() { if (typeof Reflect !== "undefined" && Reflect.get) { _get = Reflect.get; } else { _get = function _get(target, property, receiver) { var base = _superPropBase(target, property); if (!base) return; var desc = Object.getOwnPropertyDescriptor(base, property); if (desc.get) { return desc.get.call(arguments.length < 3 ? target : receiver); } return desc.value; }; } return _get.apply(this, arguments); }
 
 function _superPropBase(object, property) { while (!Object.prototype.hasOwnProperty.call(object, property)) { object = _getPrototypeOf(object); if (object === null) break; } return object; }
 
-function _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); if (superClass) _setPrototypeOf(subClass, superClass); }
+function _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); Object.defineProperty(subClass, "prototype", { writable: false }); if (superClass) _setPrototypeOf(subClass, superClass); }
 
 function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf || function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }
 
 function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
 
-function _possibleConstructorReturn(self, call) { if (call && (_typeof(call) === "object" || typeof call === "function")) { return call; } return _assertThisInitialized(self); }
+function _possibleConstructorReturn(self, call) { if (call && (_typeof(call) === "object" || typeof call === "function")) { return call; } else if (call !== void 0) { throw new TypeError("Derived constructors may only return object or undefined"); } return _assertThisInitialized(self); }
 
 function _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); } return self; }
 
@@ -371,6 +371,7 @@ export var ContextMenu = /*#__PURE__*/function (_BasePlugin) {
       var showRowHeaders = settings.rowHeaders;
       var showColHeaders = settings.colHeaders;
       /**
+       * @private
        * @param {HTMLElement} element The element to validate.
        * @returns {boolean}
        */

package/plugins/contextMenu/cursor.js

@@ -9,13 +9,13 @@ function _classCallCheck(instance, Constructor) { if (!(instance instanceof Cons
 
 function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }
 
-function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
 
 /**
  * Helper class for checking if element will fit at the desired side of cursor.
  *
+ * @private
  * @class Cursor
- * @plugin ContextMenu
  */
 var Cursor = /*#__PURE__*/function () {
   function Cursor(object, rootWindow) {