handsontable 9.0.1 → 11.0.1

package/plugins/columnSummary/columnSummary.js

@@ -2,6 +2,8 @@
 
 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); }
 
+require("core-js/modules/es.object.to-string.js");
+
 require("core-js/modules/es.reflect.construct.js");
 
 require("core-js/modules/es.reflect.get.js");
@@ -16,8 +18,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");
@@ -27,7 +27,7 @@ require("core-js/modules/es.string.iterator.js");
 require("core-js/modules/web.dom-collections.iterator.js");
 
 exports.__esModule = true;
-exports.ColumnSummary = exports.PLUGIN_PRIORITY = exports.PLUGIN_KEY = void 0;
+exports.PLUGIN_PRIORITY = exports.PLUGIN_KEY = exports.ColumnSummary = void 0;
 
 require("core-js/modules/es.array.concat.js");
 
@@ -63,7 +63,7 @@ function _defineProperties(target, props) { for (var i = 0; i < props.length; i+
 
 function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); 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; }
 
@@ -73,7 +73,7 @@ function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf || func
 
 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; }
 
@@ -86,10 +86,29 @@ exports.PLUGIN_KEY = PLUGIN_KEY;
 var PLUGIN_PRIORITY = 220;
 /**
  * @plugin ColumnSummary
+ * @class ColumnSummary
  *
  * @description
- * Allows making pre-defined calculations on the cell values and display the results within Handsontable.
- * [See the demo for more information](https://handsontable.com/docs/demo-summary-calculations.html).
+ * The `ColumnSummary` plugin lets you [easily summarize your columns](@/guides/columns/column-summary.md).
+ *
+ * You can use the [built-in summary functions](@/guides/columns/column-summary.md#built-in-summary-functions),
+ * or implement a [custom summary function](@/guides/columns/column-summary.md#implementing-a-custom-summary-function).
+ *
+ * For each column summary, you can set the following configuration options:
+ *
+ * | Option | Required | Type | Default | Description |
+ * |---|---|---|---|---|
+ * | `sourceColumn` | No | Number | Same as `destinationColumn` | [Selects a column to summarize](@/guides/columns/column-summary.md#step-2-select-cells-that-you-want-to-summarize) |
+ * | `ranges` | No | Array | - | [Selects ranges of rows to summarize](@/guides/columns/column-summary.md#step-2-select-cells-that-you-want-to-summarize) |
+ * | `type` | Yes | String | - | [Sets a summary function](@/guides/columns/column-summary.md#step-3-calculate-your-summary) |
+ * | `destinationRow` | Yes | Number | - | [Sets the destination cell's row coordinate](@/guides/columns/column-summary.md#step-4-provide-the-destination-cell-s-coordinates) |
+ * | `destinationColumn` | Yes | Number | - | [Sets the destination cell's column coordinate](@/guides/columns/column-summary.md#step-4-provide-the-destination-cell-s-coordinates) |
+ * | `forceNumeric` | No | Boolean | `false` | [Forces the summary to treat non-numerics as numerics](@/guides/columns/column-summary.md#forcing-numeric-values) |
+ * | `reversedRowCoords` | No | Boolean | `false` | [Reverses row coordinates](@/guides/columns/column-summary.md#step-5-make-room-for-the-destination-cell) |
+ * | `suppressDataTypeErrors` | No | Boolean | `true` | [Suppresses data type errors](@/guides/columns/column-summary.md#throwing-data-type-errors) |
+ * | `readOnly` | No | Boolean | `true` | Makes summary cell read-only |
+ * | `roundFloat` | No | Number | - | [Rounds summary result](@/guides/columns/column-summary.md#rounding-a-column-summary-result) |
+ * | `customFunction` | No | Function | - | [Lets you add a custom summary function](@/guides/columns/column-summary.md#implementing-a-custom-summary-function) |
  *
  * @example
  * const container = document.getElementById('example');
@@ -99,20 +118,20 @@ var PLUGIN_PRIORITY = 220;
  *   rowHeaders: true,
  *   columnSummary: [
  *     {
+ *       type: 'min',
  *       destinationRow: 4,
  *       destinationColumn: 1,
- *       type: 'min'
  *     },
  *     {
+ *       type: 'max',
  *       destinationRow: 0,
  *       destinationColumn: 3,
- *       reversedRowCoords: true,
- *       type: 'max'
+ *       reversedRowCoords: true
  *     },
  *     {
+ *       type: 'sum',
  *       destinationRow: 4,
  *       destinationColumn: 5,
- *       type: 'sum',
  *       forceNumeric: true
  *     }
  *   ]
@@ -558,7 +577,7 @@ var ColumnSummary = /*#__PURE__*/function (_BasePlugin) {
      * @private
      * @param {Array} rows Array of visual row indexes to be moved.
      * @param {number} finalIndex Visual row index, being a start index for the moved rows. Points to where the elements will be placed after the moving action.
-     * To check the visualization of the final index, please take a look at [documentation](/docs/demo-moving.html).
+     * To check the visualization of the final index, please take a look at [documentation](@/guides/rows/row-moving.md).
      */
 
   }, {

package/plugins/columnSummary/columnSummary.mjs

@@ -2,6 +2,7 @@ function _typeof(obj) { "@babel/helpers - typeof"; if (typeof Symbol === "functi
 
 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";
@@ -9,7 +10,6 @@ import "core-js/modules/es.array.slice.js";
 import "core-js/modules/es.object.freeze.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";
@@ -31,7 +31,7 @@ function _defineProperties(target, props) { for (var i = 0; i < props.length; i+
 
 function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); 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; }
 
@@ -41,7 +41,7 @@ function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf || func
 
 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; }
 
@@ -57,10 +57,29 @@ export var PLUGIN_KEY = 'columnSummary';
 export var PLUGIN_PRIORITY = 220;
 /**
  * @plugin ColumnSummary
+ * @class ColumnSummary
  *
  * @description
- * Allows making pre-defined calculations on the cell values and display the results within Handsontable.
- * [See the demo for more information](https://handsontable.com/docs/demo-summary-calculations.html).
+ * The `ColumnSummary` plugin lets you [easily summarize your columns](@/guides/columns/column-summary.md).
+ *
+ * You can use the [built-in summary functions](@/guides/columns/column-summary.md#built-in-summary-functions),
+ * or implement a [custom summary function](@/guides/columns/column-summary.md#implementing-a-custom-summary-function).
+ *
+ * For each column summary, you can set the following configuration options:
+ *
+ * | Option | Required | Type | Default | Description |
+ * |---|---|---|---|---|
+ * | `sourceColumn` | No | Number | Same as `destinationColumn` | [Selects a column to summarize](@/guides/columns/column-summary.md#step-2-select-cells-that-you-want-to-summarize) |
+ * | `ranges` | No | Array | - | [Selects ranges of rows to summarize](@/guides/columns/column-summary.md#step-2-select-cells-that-you-want-to-summarize) |
+ * | `type` | Yes | String | - | [Sets a summary function](@/guides/columns/column-summary.md#step-3-calculate-your-summary) |
+ * | `destinationRow` | Yes | Number | - | [Sets the destination cell's row coordinate](@/guides/columns/column-summary.md#step-4-provide-the-destination-cell-s-coordinates) |
+ * | `destinationColumn` | Yes | Number | - | [Sets the destination cell's column coordinate](@/guides/columns/column-summary.md#step-4-provide-the-destination-cell-s-coordinates) |
+ * | `forceNumeric` | No | Boolean | `false` | [Forces the summary to treat non-numerics as numerics](@/guides/columns/column-summary.md#forcing-numeric-values) |
+ * | `reversedRowCoords` | No | Boolean | `false` | [Reverses row coordinates](@/guides/columns/column-summary.md#step-5-make-room-for-the-destination-cell) |
+ * | `suppressDataTypeErrors` | No | Boolean | `true` | [Suppresses data type errors](@/guides/columns/column-summary.md#throwing-data-type-errors) |
+ * | `readOnly` | No | Boolean | `true` | Makes summary cell read-only |
+ * | `roundFloat` | No | Number | - | [Rounds summary result](@/guides/columns/column-summary.md#rounding-a-column-summary-result) |
+ * | `customFunction` | No | Function | - | [Lets you add a custom summary function](@/guides/columns/column-summary.md#implementing-a-custom-summary-function) |
  *
  * @example
  * const container = document.getElementById('example');
@@ -70,20 +89,20 @@ export var PLUGIN_PRIORITY = 220;
  *   rowHeaders: true,
  *   columnSummary: [
  *     {
+ *       type: 'min',
  *       destinationRow: 4,
  *       destinationColumn: 1,
- *       type: 'min'
  *     },
  *     {
+ *       type: 'max',
  *       destinationRow: 0,
  *       destinationColumn: 3,
- *       reversedRowCoords: true,
- *       type: 'max'
+ *       reversedRowCoords: true
  *     },
  *     {
+ *       type: 'sum',
  *       destinationRow: 4,
  *       destinationColumn: 5,
- *       type: 'sum',
  *       forceNumeric: true
  *     }
  *   ]
@@ -527,7 +546,7 @@ export var ColumnSummary = /*#__PURE__*/function (_BasePlugin) {
      * @private
      * @param {Array} rows Array of visual row indexes to be moved.
      * @param {number} finalIndex Visual row index, being a start index for the moved rows. Points to where the elements will be placed after the moving action.
-     * To check the visualization of the final index, please take a look at [documentation](/docs/demo-moving.html).
+     * To check the visualization of the final index, please take a look at [documentation](@/guides/rows/row-moving.md).
      */
 
   }, {

package/plugins/columnSummary/endpoints.js

@@ -5,6 +5,8 @@ exports.default = void 0;
 
 require("core-js/modules/es.array.index-of.js");
 
+require("core-js/modules/es.object.to-string.js");
+
 require("core-js/modules/es.number.to-fixed.js");
 
 var _array = require("../../helpers/array");
@@ -20,8 +22,8 @@ function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _d
 /**
  * Class used to make all endpoint-related operations.
  *
+ * @private
  * @class Endpoints
- * @plugin ColumnSummary
  */
 var Endpoints = /*#__PURE__*/function () {
   function Endpoints(plugin, settings) {
@@ -274,13 +276,13 @@ var Endpoints = /*#__PURE__*/function () {
       if (this.settingsType === 'function') {
         // We need to run it on a next avaiable hook, because the TrimRows' `afterCreateRow` hook triggers after this one,
         // and it needs to be run to properly calculate the endpoint value.
-        var beforeRenderCallback = function beforeRenderCallback() {
-          _this2.hot.removeHook('beforeRender', beforeRenderCallback);
+        var beforeViewRenderCallback = function beforeViewRenderCallback() {
+          _this2.hot.removeHook('beforeViewRender', beforeViewRenderCallback);
 
           return _this2.refreshAllEndpoints();
         };
 
-        this.hot.addHookOnce('beforeRender', beforeRenderCallback);
+        this.hot.addHookOnce('beforeViewRender', beforeViewRenderCallback);
         return;
       }
 

package/plugins/columnSummary/endpoints.mjs

@@ -1,4 +1,5 @@
 import "core-js/modules/es.array.index-of.js";
+import "core-js/modules/es.object.to-string.js";
 import "core-js/modules/es.number.to-fixed.js";
 
 function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
@@ -12,8 +13,8 @@ import { warn } from "../../helpers/console.mjs";
 /**
  * Class used to make all endpoint-related operations.
  *
+ * @private
  * @class Endpoints
- * @plugin ColumnSummary
  */
 
 var Endpoints = /*#__PURE__*/function () {
@@ -267,13 +268,13 @@ var Endpoints = /*#__PURE__*/function () {
       if (this.settingsType === 'function') {
         // We need to run it on a next avaiable hook, because the TrimRows' `afterCreateRow` hook triggers after this one,
         // and it needs to be run to properly calculate the endpoint value.
-        var beforeRenderCallback = function beforeRenderCallback() {
-          _this2.hot.removeHook('beforeRender', beforeRenderCallback);
+        var beforeViewRenderCallback = function beforeViewRenderCallback() {
+          _this2.hot.removeHook('beforeViewRender', beforeViewRenderCallback);
 
           return _this2.refreshAllEndpoints();
         };
 
-        this.hot.addHookOnce('beforeRender', beforeRenderCallback);
+        this.hot.addHookOnce('beforeViewRender', beforeViewRenderCallback);
         return;
       }
 

package/plugins/columnSummary/index.d.ts

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

package/plugins/columnSummary/index.js

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

package/plugins/comments/commentEditor.js

@@ -14,8 +14,8 @@ function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _d
 /**
  * Comment editor for the Comments plugin.
  *
+ * @private
  * @class CommentEditor
- * @plugin Comments
  */
 var CommentEditor = /*#__PURE__*/function () {
   function CommentEditor(rootDocument) {

package/plugins/comments/commentEditor.mjs

@@ -8,8 +8,8 @@ import { addClass } from "../../helpers/dom/element.mjs";
 /**
  * Comment editor for the Comments plugin.
  *
+ * @private
  * @class CommentEditor
- * @plugin Comments
  */
 
 var CommentEditor = /*#__PURE__*/function () {

package/plugins/comments/comments.d.ts

@@ -0,0 +1,50 @@
+import Core from '../../core';
+import { BasePlugin } from '../base';
+import CellCoords from '../../3rdparty/walkontable/src/cell/coords';
+
+export interface CommentObject {
+  value?: string;
+  readOnly?: boolean;
+  style?: {
+    height?: number;
+    width?: number;
+  };
+}
+export interface DetailedSettings {
+  displayDelay?: number;
+}
+
+export type Settings = boolean | DetailedSettings;
+
+export interface CommentConfig {
+  row: number;
+  col: number;
+  comment: CommentObject;
+}
+
+export interface CommentsRangeObject {
+  from: CellCoords;
+  to?: CellCoords;
+}
+
+export class Comments extends BasePlugin {
+  constructor(hotInstance: Core);
+
+  range: CommentsRangeObject;
+
+  isEnabled(): boolean;
+  setRange(range: CommentsRangeObject): void;
+  clearRange(): void;
+  setComment(value: string): void;
+  setCommentAtCell(row: number, column: number, value: string): void;
+  removeComment(forceRender?: boolean): void;
+  removeCommentAtCell(row: number, column: number, forceRender?: boolean): void;
+  getComment(): string;
+  getCommentAtCell(row: number, column: number): string;
+  show(): boolean;
+  showAtCell(row: number, column: number): boolean;
+  hide(): void;
+  refreshEditor(force?: boolean): void;
+  updateCommentMeta(row: number, column: number, metaObject: object): void;
+  getCommentMeta(row: number, column: number, property: string): any;
+}

package/plugins/comments/comments.js

@@ -19,7 +19,7 @@ require("core-js/modules/es.symbol.description.js");
 require("core-js/modules/es.symbol.iterator.js");
 
 exports.__esModule = true;
-exports.Comments = exports.PLUGIN_PRIORITY = exports.PLUGIN_KEY = void 0;
+exports.PLUGIN_PRIORITY = exports.PLUGIN_KEY = exports.Comments = void 0;
 
 require("core-js/modules/es.array.iterator.js");
 
@@ -65,7 +65,7 @@ function _defineProperties(target, props) { for (var i = 0; i < props.length; i+
 
 function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); 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; }
 
@@ -75,7 +75,7 @@ function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf || func
 
 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; }
 
@@ -95,8 +95,8 @@ var META_READONLY = 'readOnly';
 /* eslint-disable jsdoc/require-description-complete-sentence */
 
 /**
- * @class Comments
  * @plugin Comments
+ * @class Comments
  *
  * @description
  * This plugin allows setting and managing cell comments by either an option in the context menu or with the use of
@@ -111,7 +111,12 @@ var META_READONLY = 'readOnly';
  *
  * ```js
  * comments: {
- *   displayDelay: 1000
+ *   displayDelay: 1000,
+ *   readOnly: true,
+ *   style: {
+ *     width: 300,
+ *     height: 100
+ *   }
  * }
  * ```
  *
@@ -435,7 +440,7 @@ 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();

package/plugins/comments/comments.mjs

@@ -8,7 +8,7 @@ function _defineProperties(target, props) { for (var i = 0; i < props.length; i+
 
 function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); 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; }
 
@@ -18,7 +18,7 @@ function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf || func
 
 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; }
 
@@ -59,8 +59,8 @@ var META_READONLY = 'readOnly';
 /* eslint-disable jsdoc/require-description-complete-sentence */
 
 /**
- * @class Comments
  * @plugin Comments
+ * @class Comments
  *
  * @description
  * This plugin allows setting and managing cell comments by either an option in the context menu or with the use of
@@ -75,7 +75,12 @@ var META_READONLY = 'readOnly';
  *
  * ```js
  * comments: {
- *   displayDelay: 1000
+ *   displayDelay: 1000,
+ *   readOnly: true,
+ *   style: {
+ *     width: 300,
+ *     height: 100
+ *   }
  * }
  * ```
  *
@@ -399,7 +404,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();

package/plugins/comments/displaySwitch.js

@@ -24,8 +24,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/displaySwitch.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

@@ -22,8 +22,8 @@ function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _d
 /**
  * Command executor for ContextMenu.
  *
+ * @private
  * @class CommandExecutor
- * @plugin ContextMenu
  */
 var CommandExecutor = /*#__PURE__*/function () {
   function CommandExecutor(hotInstance) {

package/plugins/contextMenu/commandExecutor.mjs

@@ -13,8 +13,8 @@ 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;
+}