handsontable 9.0.1 → 11.0.1

package/selection/mouseEventHandler.mjs

@@ -30,9 +30,9 @@ export function mouseDown(_ref) {
   var selectedRow = selection.isSelectedByRowHeader();
 
   if (isShiftKey && currentSelection) {
-    if (coords.row >= 0 && coords.col >= 0 && !controller.cells) {
+    if (coords.row >= 0 && coords.col >= 0 && !controller.cell) {
       selection.setRangeEnd(coords);
-    } else if ((selectedCorner || selectedRow) && coords.row >= 0 && coords.col >= 0 && !controller.cells) {
+    } else if ((selectedCorner || selectedRow) && coords.row >= 0 && coords.col >= 0 && !controller.cell) {
       selection.setRangeEnd(new CellCoords(coords.row, coords.col));
     } else if (selectedCorner && coords.row < 0 && !controller.column) {
       selection.setRangeEnd(new CellCoords(currentSelection.to.row, coords.col));
@@ -56,7 +56,7 @@ export function mouseDown(_ref) {
       if (performSelection) {
         selection.selectRows(coords.row, coords.row, coords.col);
       }
-    } else if (coords.col >= 0 && coords.row >= 0 && !controller.cells) {
+    } else if (coords.col >= 0 && coords.row >= 0 && !controller.cell) {
       if (performSelection) {
         selection.setRangeStart(coords);
       }

package/selection/range.js

@@ -3,6 +3,8 @@
 exports.__esModule = true;
 exports.default = void 0;
 
+require("core-js/modules/es.object.to-string.js");
+
 require("core-js/modules/es.array.includes.js");
 
 require("core-js/modules/es.string.includes.js");
@@ -11,8 +13,6 @@ require("core-js/modules/es.symbol.iterator.js");
 
 require("core-js/modules/es.array.iterator.js");
 
-require("core-js/modules/es.object.to-string.js");
-
 require("core-js/modules/es.string.iterator.js");
 
 require("core-js/modules/web.dom-collections.iterator.js");
@@ -36,7 +36,7 @@ function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _d
  * @class SelectionRange
  * @util
  */
-var SelectionRange = /*#__PURE__*/function () {
+var SelectionRange = /*#__PURE__*/function (_Symbol$iterator) {
   function SelectionRange() {
     _classCallCheck(this, SelectionRange);
 
@@ -180,14 +180,14 @@ var SelectionRange = /*#__PURE__*/function () {
       return cellRange;
     }
   }, {
-    key: Symbol.iterator,
+    key: _Symbol$iterator,
     value: function value() {
       return this.ranges[Symbol.iterator]();
     }
   }]);
 
   return SelectionRange;
-}();
+}(Symbol.iterator);
 
 var _default = SelectionRange;
 exports.default = _default;

package/selection/range.mjs

@@ -1,8 +1,8 @@
+import "core-js/modules/es.object.to-string.js";
 import "core-js/modules/es.array.includes.js";
 import "core-js/modules/es.string.includes.js";
 import "core-js/modules/es.symbol.iterator.js";
 import "core-js/modules/es.array.iterator.js";
-import "core-js/modules/es.object.to-string.js";
 import "core-js/modules/es.string.iterator.js";
 import "core-js/modules/web.dom-collections.iterator.js";
 import "core-js/modules/es.symbol.js";
@@ -23,7 +23,7 @@ import { CellRange } from "./../3rdparty/walkontable/src/index.mjs";
  * @util
  */
 
-var SelectionRange = /*#__PURE__*/function () {
+var SelectionRange = /*#__PURE__*/function (_Symbol$iterator) {
   function SelectionRange() {
     _classCallCheck(this, SelectionRange);
 
@@ -167,13 +167,13 @@ var SelectionRange = /*#__PURE__*/function () {
       return cellRange;
     }
   }, {
-    key: Symbol.iterator,
+    key: _Symbol$iterator,
     value: function value() {
       return this.ranges[Symbol.iterator]();
     }
   }]);
 
   return SelectionRange;
-}();
+}(Symbol.iterator);
 
 export default SelectionRange;

package/selection/selection.js

@@ -12,6 +12,8 @@ require("core-js/modules/es.symbol.iterator.js");
 
 require("core-js/modules/es.function.name.js");
 
+require("core-js/modules/es.regexp.exec.js");
+
 exports.__esModule = true;
 exports.default = void 0;
 
@@ -75,7 +77,7 @@ function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o =
 
 function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
 
-function _iterableToArrayLimit(arr, i) { var _i = arr && (typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"]); if (_i == null) return; var _arr = []; var _n = true; var _d = false; var _s, _e; try { for (_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true) { _arr.push(_s.value); if (i && _arr.length === i) break; } } catch (err) { _d = true; _e = err; } finally { try { if (!_n && _i["return"] != null) _i["return"](); } finally { if (_d) throw _e; } } return _arr; }
+function _iterableToArrayLimit(arr, i) { var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"]; if (_i == null) return; var _arr = []; var _n = true; var _d = false; var _s, _e; try { for (_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true) { _arr.push(_s.value); if (i && _arr.length === i) break; } } catch (err) { _d = true; _e = err; } finally { try { if (!_n && _i["return"] != null) _i["return"](); } finally { if (_d) throw _e; } } return _arr; }
 
 function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 
@@ -313,15 +315,18 @@ var Selection = /*#__PURE__*/function () {
       var isMultipleSelection = (0, _mixed.isUndefined)(multipleSelection) ? (0, _keyStateObserver.isPressedCtrlKey)() : multipleSelection;
       var isRowNegative = coords.row < 0;
       var isColumnNegative = coords.col < 0;
-      var selectedByCorner = isRowNegative && isColumnNegative;
+      var selectedByCorner = isRowNegative && isColumnNegative; // We are creating copy. We would like to modify just the start of the selection by below hook. Then original coords
+      // should be handled by next methods.
+
+      var coordsClone = coords.clone();
       this.selectedByCorner = selectedByCorner;
-      this.runLocalHooks("beforeSetRangeStart".concat(fragment ? 'Only' : ''), coords);
+      this.runLocalHooks("beforeSetRangeStart".concat(fragment ? 'Only' : ''), coordsClone);
 
       if (!isMultipleMode || isMultipleMode && !isMultipleSelection && (0, _mixed.isUndefined)(multipleSelection)) {
         this.selectedRange.clear();
       }
 
-      this.selectedRange.add(coords);
+      this.selectedRange.add(coordsClone);
 
       if (this.getLayerLevel() === 0) {
         this.selectedByRowHeader.clear();
@@ -365,14 +370,17 @@ var Selection = /*#__PURE__*/function () {
     value: function setRangeEnd(coords) {
       if (this.selectedRange.isEmpty()) {
         return;
-      }
+      } // We are creating copy. We would like to modify just the end of the selection by below hook. Then original coords
+      // should be handled by next methods.
+
 
-      this.runLocalHooks('beforeSetRangeEnd', coords);
+      var coordsClone = coords.clone();
+      this.runLocalHooks('beforeSetRangeEnd', coordsClone);
       this.begin();
       var cellRange = this.selectedRange.current();
 
       if (this.settings.selectionMode !== 'single') {
-        cellRange.setTo(new _src.CellCoords(coords.row, coords.col));
+        cellRange.setTo(new _src.CellCoords(coordsClone.row, coordsClone.col));
       } // Set up current selection.
 
 
@@ -488,13 +496,14 @@ var Selection = /*#__PURE__*/function () {
      *
      * @param {number} rowDelta Rows number to move, value can be passed as negative number.
      * @param {number} colDelta Columns number to move, value can be passed as negative number.
-     * @param {boolean} force If `true` the new rows/columns will be created if necessary. Otherwise, row/column will
+     * @param {boolean} [force=false] If `true` the new rows/columns will be created if necessary. Otherwise, row/column will
      *                        be created according to `minSpareRows/minSpareCols` settings of Handsontable.
      */
 
   }, {
     key: "transformStart",
-    value: function transformStart(rowDelta, colDelta, force) {
+    value: function transformStart(rowDelta, colDelta) {
+      var force = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;
       this.setRangeStart(this.transformation.transformStart(rowDelta, colDelta, force));
     }
     /**

package/selection/selection.mjs

@@ -4,6 +4,7 @@ import "core-js/modules/es.symbol.js";
 import "core-js/modules/es.symbol.description.js";
 import "core-js/modules/es.symbol.iterator.js";
 import "core-js/modules/es.function.name.js";
+import "core-js/modules/es.regexp.exec.js";
 
 var _templateObject;
 
@@ -15,7 +16,7 @@ function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o =
 
 function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
 
-function _iterableToArrayLimit(arr, i) { var _i = arr && (typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"]); if (_i == null) return; var _arr = []; var _n = true; var _d = false; var _s, _e; try { for (_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true) { _arr.push(_s.value); if (i && _arr.length === i) break; } } catch (err) { _d = true; _e = err; } finally { try { if (!_n && _i["return"] != null) _i["return"](); } finally { if (_d) throw _e; } } return _arr; }
+function _iterableToArrayLimit(arr, i) { var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"]; if (_i == null) return; var _arr = []; var _n = true; var _d = false; var _s, _e; try { for (_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true) { _arr.push(_s.value); if (i && _arr.length === i) break; } } catch (err) { _d = true; _e = err; } finally { try { if (!_n && _i["return"] != null) _i["return"](); } finally { if (_d) throw _e; } } return _arr; }
 
 function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 
@@ -279,15 +280,18 @@ var Selection = /*#__PURE__*/function () {
       var isMultipleSelection = isUndefined(multipleSelection) ? isPressedCtrlKey() : multipleSelection;
       var isRowNegative = coords.row < 0;
       var isColumnNegative = coords.col < 0;
-      var selectedByCorner = isRowNegative && isColumnNegative;
+      var selectedByCorner = isRowNegative && isColumnNegative; // We are creating copy. We would like to modify just the start of the selection by below hook. Then original coords
+      // should be handled by next methods.
+
+      var coordsClone = coords.clone();
       this.selectedByCorner = selectedByCorner;
-      this.runLocalHooks("beforeSetRangeStart".concat(fragment ? 'Only' : ''), coords);
+      this.runLocalHooks("beforeSetRangeStart".concat(fragment ? 'Only' : ''), coordsClone);
 
       if (!isMultipleMode || isMultipleMode && !isMultipleSelection && isUndefined(multipleSelection)) {
         this.selectedRange.clear();
       }
 
-      this.selectedRange.add(coords);
+      this.selectedRange.add(coordsClone);
 
       if (this.getLayerLevel() === 0) {
         this.selectedByRowHeader.clear();
@@ -331,14 +335,17 @@ var Selection = /*#__PURE__*/function () {
     value: function setRangeEnd(coords) {
       if (this.selectedRange.isEmpty()) {
         return;
-      }
+      } // We are creating copy. We would like to modify just the end of the selection by below hook. Then original coords
+      // should be handled by next methods.
+
 
-      this.runLocalHooks('beforeSetRangeEnd', coords);
+      var coordsClone = coords.clone();
+      this.runLocalHooks('beforeSetRangeEnd', coordsClone);
       this.begin();
       var cellRange = this.selectedRange.current();
 
       if (this.settings.selectionMode !== 'single') {
-        cellRange.setTo(new CellCoords(coords.row, coords.col));
+        cellRange.setTo(new CellCoords(coordsClone.row, coordsClone.col));
       } // Set up current selection.
 
 
@@ -454,13 +461,14 @@ var Selection = /*#__PURE__*/function () {
      *
      * @param {number} rowDelta Rows number to move, value can be passed as negative number.
      * @param {number} colDelta Columns number to move, value can be passed as negative number.
-     * @param {boolean} force If `true` the new rows/columns will be created if necessary. Otherwise, row/column will
+     * @param {boolean} [force=false] If `true` the new rows/columns will be created if necessary. Otherwise, row/column will
      *                        be created according to `minSpareRows/minSpareCols` settings of Handsontable.
      */
 
   }, {
     key: "transformStart",
-    value: function transformStart(rowDelta, colDelta, force) {
+    value: function transformStart(rowDelta, colDelta) {
+      var force = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;
       this.setRangeStart(this.transformation.transformStart(rowDelta, colDelta, force));
     }
     /**

package/selection/transformation.js

@@ -50,7 +50,7 @@ var Transformation = /*#__PURE__*/function () {
    *
    * @param {number} rowDelta Rows number to move, value can be passed as negative number.
    * @param {number} colDelta Columns number to move, value can be passed as negative number.
-   * @param {boolean} force If `true` the new rows/columns will be created if necessary. Otherwise, row/column will
+   * @param {boolean} [force=false] If `true` the new rows/columns will be created if necessary. Otherwise, row/column will
    *                        be created according to `minSpareRows/minSpareCols` settings of Handsontable.
    * @returns {CellCoords} Visual coordinates after transformation.
    */
@@ -58,7 +58,8 @@ var Transformation = /*#__PURE__*/function () {
 
   _createClass(Transformation, [{
     key: "transformStart",
-    value: function transformStart(rowDelta, colDelta, force) {
+    value: function transformStart(rowDelta, colDelta) {
+      var force = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;
       var delta = new _src.CellCoords(rowDelta, colDelta);
       var highlightCoords = this.range.current().highlight;
 

package/selection/transformation.mjs

@@ -41,7 +41,7 @@ var Transformation = /*#__PURE__*/function () {
    *
    * @param {number} rowDelta Rows number to move, value can be passed as negative number.
    * @param {number} colDelta Columns number to move, value can be passed as negative number.
-   * @param {boolean} force If `true` the new rows/columns will be created if necessary. Otherwise, row/column will
+   * @param {boolean} [force=false] If `true` the new rows/columns will be created if necessary. Otherwise, row/column will
    *                        be created according to `minSpareRows/minSpareCols` settings of Handsontable.
    * @returns {CellCoords} Visual coordinates after transformation.
    */
@@ -49,7 +49,8 @@ var Transformation = /*#__PURE__*/function () {
 
   _createClass(Transformation, [{
     key: "transformStart",
-    value: function transformStart(rowDelta, colDelta, force) {
+    value: function transformStart(rowDelta, colDelta) {
+      var force = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;
       var delta = new CellCoords(rowDelta, colDelta);
       var highlightCoords = this.range.current().highlight;
 

package/selection/utils.js

@@ -6,13 +6,15 @@ require("core-js/modules/es.array.slice.js");
 
 require("core-js/modules/es.function.name.js");
 
+require("core-js/modules/es.regexp.exec.js");
+
 exports.__esModule = true;
+exports.SELECTION_TYPE_UNRECOGNIZED = exports.SELECTION_TYPE_OBJECT = exports.SELECTION_TYPE_EMPTY = exports.SELECTION_TYPE_ARRAY = exports.SELECTION_TYPES = void 0;
 exports.detectSelectionType = detectSelectionType;
+exports.isValidCoord = isValidCoord;
 exports.normalizeSelectionFactory = normalizeSelectionFactory;
 exports.transformSelectionToColumnDistance = transformSelectionToColumnDistance;
 exports.transformSelectionToRowDistance = transformSelectionToRowDistance;
-exports.isValidCoord = isValidCoord;
-exports.SELECTION_TYPES = exports.SELECTION_TYPE_OBJECT = exports.SELECTION_TYPE_ARRAY = exports.SELECTION_TYPE_EMPTY = exports.SELECTION_TYPE_UNRECOGNIZED = void 0;
 
 require("core-js/modules/es.symbol.js");
 
@@ -50,7 +52,7 @@ function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o =
 
 function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
 
-function _iterableToArrayLimit(arr, i) { var _i = arr && (typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"]); if (_i == null) return; var _arr = []; var _n = true; var _d = false; var _s, _e; try { for (_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true) { _arr.push(_s.value); if (i && _arr.length === i) break; } } catch (err) { _d = true; _e = err; } finally { try { if (!_n && _i["return"] != null) _i["return"](); } finally { if (_d) throw _e; } } return _arr; }
+function _iterableToArrayLimit(arr, i) { var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"]; if (_i == null) return; var _arr = []; var _n = true; var _d = false; var _s, _e; try { for (_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true) { _arr.push(_s.value); if (i && _arr.length === i) break; } } catch (err) { _d = true; _e = err; } finally { try { if (!_n && _i["return"] != null) _i["return"](); } finally { if (_d) throw _e; } } return _arr; }
 
 function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 
@@ -116,7 +118,7 @@ function detectSelectionType(selectionRanges) {
 /**
  * Factory function designed for normalization data schema from different data structures of the selection ranges.
  *
- * @param {string} type Selection type which will be processed.
+ * @param {number} type Selection type which will be processed.
  * @param {object} [options] The normalization options.
  * @param {boolean} [options.keepDirection=false] If `true`, the coordinates which contain the direction of the
  *                                                selected cells won't be changed. Otherwise, the selection will be

package/selection/utils.mjs

@@ -6,7 +6,7 @@ function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o =
 
 function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
 
-function _iterableToArrayLimit(arr, i) { var _i = arr && (typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"]); if (_i == null) return; var _arr = []; var _n = true; var _d = false; var _s, _e; try { for (_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true) { _arr.push(_s.value); if (i && _arr.length === i) break; } } catch (err) { _d = true; _e = err; } finally { try { if (!_n && _i["return"] != null) _i["return"](); } finally { if (_d) throw _e; } } return _arr; }
+function _iterableToArrayLimit(arr, i) { var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"]; if (_i == null) return; var _arr = []; var _n = true; var _d = false; var _s, _e; try { for (_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true) { _arr.push(_s.value); if (i && _arr.length === i) break; } } catch (err) { _d = true; _e = err; } finally { try { if (!_n && _i["return"] != null) _i["return"](); } finally { if (_d) throw _e; } } return _arr; }
 
 function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 
@@ -26,6 +26,7 @@ import "core-js/modules/es.array.sort.js";
 import "core-js/modules/es.symbol.iterator.js";
 import "core-js/modules/es.array.slice.js";
 import "core-js/modules/es.function.name.js";
+import "core-js/modules/es.regexp.exec.js";
 import { CellRange } from "./../3rdparty/walkontable/src/index.mjs";
 import { arrayEach, arrayReduce } from "./../helpers/array.mjs";
 import { isUndefined } from "./../helpers/mixed.mjs";
@@ -84,7 +85,7 @@ export function detectSelectionType(selectionRanges) {
 /**
  * Factory function designed for normalization data schema from different data structures of the selection ranges.
  *
- * @param {string} type Selection type which will be processed.
+ * @param {number} type Selection type which will be processed.
  * @param {object} [options] The normalization options.
  * @param {boolean} [options.keepDirection=false] If `true`, the coordinates which contain the direction of the
  *                                                selected cells won't be changed. Otherwise, the selection will be

package/settings.d.ts

@@ -0,0 +1,208 @@
+import { PikadayOptions } from 'pikaday';
+import Core from './core';
+import { Events } from './pluginHooks';
+import {
+  CellValue,
+  ColumnDataGetterSetterFunction,
+  LabelOptions,
+  NumericFormatOptions,
+  RowObject,
+  SelectOptionsObject,
+  SimpleCellCoords,
+} from './common';
+import CellCoords from './3rdparty/walkontable/src/cell/coords';
+import { Settings as AutoColumnSizeSettings } from './plugins/autoColumnSize';
+import { Settings as AutofillSettings } from './plugins/autofill';
+import { Settings as AutoRowSizeSettings } from './plugins/autoRowSize';
+import { Settings as CollapsibleColumnsSettings } from './plugins/collapsibleColumns';
+import { Settings as ColumnSortingSettings } from './plugins/columnSorting';
+import { Settings as ColumnSummarySettings } from './plugins/columnSummary';
+import { Settings as CommentsSettings, CommentObject } from './plugins/comments';
+import { Settings as ContextMenuSettings } from './plugins/contextMenu';
+import { Settings as CopyPasteSettings } from './plugins/copyPaste';
+import { Settings as CustomBordersSettings } from './plugins/customBorders';
+import { Settings as DropdownMenuSettings } from './plugins/dropdownMenu';
+import { Settings as FormulasSettings } from './plugins/formulas';
+import { Settings as HiddenColumnsSettings } from './plugins/hiddenColumns';
+import { Settings as HiddenRowsSettings } from './plugins/hiddenRows';
+import { Settings as MergeCellsSettings } from './plugins/mergeCells';
+import { Settings as MultiColumnSortingSettings } from './plugins/multiColumnSorting';
+import { Settings as NestedHeadersSettings } from './plugins/nestedHeaders';
+import { Settings as SearchSettings } from './plugins/search';
+import { EditorType, BaseEditor } from './editors';
+import { RendererType } from './renderers';
+import { BaseRenderer } from './renderers/base';
+import { ValidatorType } from './validators';
+import { BaseValidator } from './validators/base';
+import { CellType } from './cellTypes';
+
+/**
+ * Additional cell-specific meta data.
+ */
+export interface CellMeta extends ColumnSettings {
+  valid?: boolean;
+  comment?: CommentObject;
+  isSearchResult?: boolean;
+  hidden?: boolean;
+  skipRowOnPaste?: boolean;
+}
+
+/**
+ * A rendered cell object with computed properties.
+ */
+export interface CellProperties extends CellMeta {
+  row: number;
+  col: number;
+  instance: Core;
+  visualRow: number;
+  visualCol: number;
+  prop: string | number;
+}
+
+/**
+ * @internal
+ * Omit properties K from T
+ */
+export type Omit<T, K extends keyof T> = Pick<T, ({ [P in keyof T]: P } & { [P in K]: never } & { [x: string]: never, [x: number]: never })[keyof T]>;
+
+/**
+ * Column settings inherit grid settings but overload the meaning of `data` to be specific to each column.
+ */
+export interface ColumnSettings extends Omit<GridSettings, "data"> {
+  data?: string | number | ColumnDataGetterSetterFunction;
+  /**
+   * Column and cell meta data is extensible, developers can add any properties they want.
+   */
+  [key: string]: any;
+}
+
+export interface CellSettings extends CellMeta {
+  row: number;
+  col: number;
+}
+
+/**
+ * Base table settings that will cascade to columns and cells.
+ */
+export interface GridSettings extends Events {
+  activeHeaderClassName?: string;
+  allowEmpty?: boolean;
+  allowHtml?: boolean;
+  allowInsertColumn?: boolean;
+  allowInsertRow?: boolean;
+  allowInvalid?: boolean;
+  allowRemoveColumn?: boolean;
+  allowRemoveRow?: boolean;
+  autoColumnSize?: AutoColumnSizeSettings;
+  autoRowSize?: AutoRowSizeSettings;
+  autoWrapCol?: boolean;
+  autoWrapRow?: boolean;
+  bindRowsWithHeaders?: boolean | 'loose' | 'strict';
+  cell?: CellSettings[];
+  cells?: (this: CellProperties, row: number, column: number, prop: string | number) => CellMeta;
+  checkedTemplate?: boolean | string | number;
+  className?: string | string[];
+  colHeaders?: boolean | string[] | ((index: number) => string);
+  collapsibleColumns?: CollapsibleColumnsSettings;
+  columnHeaderHeight?: number | Array<number | undefined>;
+  columns?: ColumnSettings[] | ((index: number) => ColumnSettings);
+  columnSorting?: ColumnSortingSettings;
+  columnSummary?: ColumnSummarySettings;
+  colWidths?: number | string | number[] | string[] | undefined[] | Array<number | string | undefined> | ((index: number) => string | number | undefined);
+  commentedCellClassName?: string;
+  comments?: CommentsSettings;
+  contextMenu?: ContextMenuSettings;
+  copyable?: boolean;
+  copyPaste?: CopyPasteSettings;
+  correctFormat?: boolean;
+  currentColClassName?: string;
+  currentHeaderClassName?: string;
+  currentRowClassName?: string;
+  customBorders?: CustomBordersSettings;
+  data?: CellValue[][] | RowObject[];
+  dataSchema?: RowObject | CellValue[] | ((row: number) => RowObject | CellValue[]);
+  dateFormat?: string;
+  datePickerConfig?: PikadayOptions;
+  defaultDate?: string;
+  disableVisualSelection?: boolean | 'current' | 'area' | 'header' | Array<'current' | 'area' | 'header'>;
+  dragToScroll?: boolean;
+  dropdownMenu?: DropdownMenuSettings;
+  editor?: EditorType | typeof BaseEditor | boolean | string;
+  enterBeginsEditing?: boolean;
+  enterMoves?: CellCoords | SimpleCellCoords | ((event: KeyboardEvent) => CellCoords | SimpleCellCoords);
+  fillHandle?: AutofillSettings;
+  filter?: boolean;
+  filteringCaseSensitive?: boolean;
+  filters?: boolean;
+  fixedColumnsLeft?: number;
+  fixedRowsBottom?: number;
+  fixedRowsTop?: number;
+  formulas?: FormulasSettings;
+  fragmentSelection?: boolean | 'cell';
+  height?: number | string | (() => number | string);
+  hiddenColumns?: HiddenColumnsSettings;
+  hiddenRows?: HiddenRowsSettings;
+  invalidCellClassName?: string;
+  isEmptyCol?: (this: Core, col: number) => boolean;
+  isEmptyRow?: (this: Core, row: number) => boolean;
+  label?: LabelOptions;
+  language?: string;
+  licenseKey?: string | 'non-commercial-and-evaluation';
+  manualColumnFreeze?: boolean;
+  manualColumnMove?: boolean | number[];
+  manualColumnResize?: boolean | number[];
+  manualRowMove?: boolean | number[];
+  manualRowResize?: boolean | number[];
+  maxCols?: number;
+  maxRows?: number;
+  mergeCells?: MergeCellsSettings;
+  minCols?: number;
+  minRows?: number;
+  minSpareCols?: number;
+  minSpareRows?: number;
+  multiColumnSorting?: MultiColumnSortingSettings;
+  nestedHeaders?: NestedHeadersSettings;
+  nestedRows?: boolean;
+  noWordWrapClassName?: string;
+  numericFormat?: NumericFormatOptions;
+  observeDOMVisibility?: boolean;
+  outsideClickDeselects?: boolean | ((target: HTMLElement) => boolean);
+  persistentState?: boolean;
+  placeholder?: string;
+  placeholderCellClassName?: string;
+  preventOverflow?: boolean | 'vertical' | 'horizontal';
+  preventWheel?: boolean;
+  readOnly?: boolean;
+  readOnlyCellClassName?: string;
+  renderAllRows?: boolean;
+  renderer?: RendererType | string | BaseRenderer;
+  rowHeaders?: boolean | string[] | ((index: number) => string);
+  rowHeaderWidth?: number | number[];
+  rowHeights?: number | string | number[] | string[] | undefined[] | Array<number | string | undefined> | ((index: number) => string | number | undefined);
+  search?: SearchSettings;
+  selectionMode?: 'single' | 'range' | 'multiple';
+  selectOptions?: string[] | SelectOptionsObject | ((visualRow: number, visualColumn: number, prop: string | number) => string[] | SelectOptionsObject);
+  skipColumnOnPaste?: boolean;
+  skipRowOnPaste?: boolean;
+  sortByRelevance?: boolean;
+  source?: string[] | number[] | ((this: CellProperties, query: string, callback: (items: string[]) => void) => void);
+  startCols?: number;
+  startRows?: number;
+  stretchH?: 'none' | 'all' | 'last';
+  strict?: boolean;
+  tableClassName?: string | string[];
+  tabMoves?: CellCoords | SimpleCellCoords | ((event: KeyboardEvent) => CellCoords | SimpleCellCoords);
+  title?: string;
+  trimDropdown?: boolean;
+  trimRows?: boolean | number[];
+  trimWhitespace?: boolean;
+  type?: CellType | string;
+  uncheckedTemplate?: boolean | string | number;
+  undo?: boolean;
+  validator?: BaseValidator | RegExp | ValidatorType | string;
+  viewportColumnRenderingOffset?: number | 'auto';
+  viewportRowRenderingOffset?: number | 'auto';
+  visibleRows?: number;
+  width?: number | string | (() => number | string);
+  wordWrap?: boolean;
+}