jspreadsheet 9.5.4 → 10.0.1-beta.2

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 /**
- * Official Type definitions for Jspreadsheet Pro v9
- * https://jspreadsheet.com/v9
+ * Official Type definitions for Jspreadsheet Pro v10
+ * https://jspreadsheet.com/v10
  */
 
 declare function jspreadsheet(element: HTMLElement, options: jspreadsheet.Spreadsheet) : Array<jspreadsheet.worksheetInstance>;
@@ -9,24 +9,22 @@ declare namespace jspreadsheet {
 
     /** License string. Use setLicense to define the license */
     let license: string;
-
     /** Default row height for a table */
     let defaultRowHeight: number | string;
-
     /** The container that holds all spreadsheet instances in the screen */
     let spreadsheet: Spreadsheet[];
-
     /** The container that holds all extensions loaded */
     let extensions: object;
-
     /** Advance excel like helpers */
     let helpers: Helpers;
-
     /** Native editors. You can have extra entries not defined here when working with custom editors */
     let editors: Editors;
-
     /** Internal method */
     let picker: Function;
+    /** History tracker controllers */
+    let history: History;
+    /** Clipboard controller */
+    let clipboard: ClipBoard;
 
     /** Define the translations from english to any other language. Ex.{ 'hello': 'Ola', 'Successfully Saved': 'Salvo com sucesso' } */
     function setDictionary(dictionary: object) : void;
@@ -52,9 +50,84 @@ declare namespace jspreadsheet {
     /** Jspreadsheet forms extension. More info at: https://jspreadsheet.com/products */
     function forms(options: any) : void;
 
+    /** Jspreadsheet search extension. More info at: https://jspreadsheet.com/products */
+    function search() : void;
+
+    /** Jspreadsheet importer extension. More info at: https://jspreadsheet.com/products */
+    function importer() : void;
+
+    /** Jspreadsheet validations extension. More info at: https://jspreadsheet.com/products */
+    function validations() : void;
+
+    /** Jspreadsheet bar extension. More info at: https://jspreadsheet.com/products */
+    function bar() : void;
+
     /** Get the current version */
     function version(): object;
 
+    interface ClipBoard {
+        worksheet: worksheetInstance,
+        value: string,
+        selection: number[],
+        cut: boolean,
+        hash: string,
+    }
+
+    /** Images */
+    interface Image {
+        src: string,
+        top?: number,
+        left?: number,
+        width?: number,
+        height?: number,
+    }
+
+    /** New column object */
+    interface newColumn {
+        column?: number,
+        data?: any[],
+        options: Column,
+    }
+
+    /* New row object */
+    interface newRow {
+        row?: number,
+        data?: any[],
+        options: Row,
+    }
+
+    /** Advance comments */
+    interface Comment {
+        // User unique identification
+        user_id?: number,
+        // User name
+        name?: string,
+        // User image
+        image?: string,
+        // Date of the comments
+        date?: string,
+    }
+
+    /** Global History */
+    interface History {
+        /** History index cursor */
+        index: number;
+        /** History items */
+        actions: [];
+        /** When true the next item is cascaded in the same existing history element */
+        cascade: boolean;
+        /** When true no history will be added to the tracker */
+        ignore: boolean;
+        /** A history redo or undo is in progress */
+        progress: 'undo' | 'redo' | null;
+        /** Undo last action */
+        undo: () => void;
+        /** Redo most recent action */
+        redo: () => void;
+        /** Reset history tracker */
+        reset: () => void;
+    }
+
     /** Only available with the Validations extension */
     interface Validation {
         /** Excel-like range format Sheet1!A1:A6 */
@@ -145,8 +218,12 @@ declare namespace jspreadsheet {
         // Get the excel-like letter based on the index number
         getColumnName: (index: number) => string;
         // Get the cell name from its coordinates
+        getCellNameFromCoords: (x: number, y: number) => string;
+        // Aliases or getCellNameFromCoords
         getColumnNameFromCoords: (x: number, y: number) => string;
         // Get the coordinates from a cell name
+        getCoordsFromCellName: (name: string) => [number, number];
+        // Alias for getCoordsFromCellName
         getCoordsFromColumnName: (name: string) => [number, number];
         // Shift the formula by x and y positions in the matrix
         shiftFormula: (formula: string, x: number, y: number) => string;
@@ -154,8 +231,14 @@ declare namespace jspreadsheet {
         getTokensFromRange: (range: string) => string[];
         // Get the range from an array of tokens
         getRangeFromTokens: (tokens: string[]) => string;
-        // Extract the tokens from a formula
-        getTokens: (formula: string, worksheetName?: string) => string[];
+        // Get the coordinates as a number from a range string
+        getCoordsFromRange: (range: string) => [number,number,number,number];
+        // Get range string from [x1,y1,x2,y2]
+        getRangeFromCoords: (coords: [number,number,number,number]) => string;
+        // Extract the configuration from JSS from a static HTML table
+        createFromTable: (element: HTMLElement, options?: Worksheet) => Worksheet;
+        // CSV string to JS array. delimiter default ','
+        parseCSV: (str: string, delimiter?: string) => string[];
     }
 
     interface Tabs {
@@ -262,21 +345,21 @@ declare namespace jspreadsheet {
     }
 
     interface Calendar {
-        /** Render type. Default: 'default' */
+        /** Specifies the type of calendar to render. Default is 'default'. Possible values are 'default' and 'year-month-picker'. */
         type?: 'default' | 'year-month-picker';
-        /** Disable the dates out of the defined range. */
+        /** An array of numbers specifying a range of valid dates. Dates outside this range will be disabled. */
         validRange?: number[];
-        /** The calendar starts in a day of week (0 for Sunday - 6 for Saturday). Default: 0 (Sunday) */
+        /** Specifies the day of the week the calendar starts on, where 0 is Sunday and 6 is Saturday. Default is 0 (Sunday). */
         format?: string;
-        /** Calendar input is readonly */
+        /** Specifies whether the calendar input is readonly or not. Default is false. */
         readonly?: boolean;
-        /** Select today automatically when no date value is defined. */
+        /** Specifies whether today's date is automatically selected when no date is defined. Default is false. */
         today?: boolean;
-        /** Show hour and minute dropdown. */
+        /** Specifies whether to display a dropdown for selecting hour and minute values. Default is false. */
         time?: boolean;
-        /** Show reset button. Default: true */
+        /** Specifies whether to display a reset button. Default is true. */
         resetButton?: boolean;
-        /** Calendar input placeholder. */
+        /** Specifies a placeholder text to display in the calendar input when no date is selected. */
         placeholder?: string;
     }
 
@@ -302,67 +385,75 @@ declare namespace jspreadsheet {
         // Associate to an array of values
         a?: any[][];
         // Part of a merged cells
-        merged?: number[];
+        merged?: any[];
+        // Style
+        s?: number;
+        // Comments
+        c?: string|object;
+        // Meta
+        meta?: object;
+        // Chain
+        chain?: Map<object, object>;
     }
 
     interface Column {
-        /** Define the column type. Can be a string to define a native editor, or a method to define the custom editor plugin. */
+        /** Define the type of editor to use for the column. Can be a string to define a native editor, or a method to define a custom editor plugin. */
         type?: Editor | 'autocomplete' | 'calendar' | 'checkbox' | 'color' | 'dropdown' | 'hidden' | 'html' | 'image' | 'numeric' | 'radio' | 'text' | 'notes';
-        /** Column title */
+        /** The title of the column. */
         title?: string;
-        /** Name or a path of a property when the data is a JSON object. */
+        /** The name or path of a property when the data is a JSON object. */
         name?: string;
-        /** Define the onmouseover tooltip for the column header. */
+        /** Define the tooltip text to display on mouseover for the column header. */
         tooltip?: string;
-        /** Width of the column */
+        /** The width of the column. Default: 100px */
         width?: number;
-        /** Visibility of a column */
+        /** Whether the column is visible. */
         visible?: boolean,
-        /** Column alignment. Default: center */
+        /** The alignment of the column content. Default: center. */
         align?: 'center' | 'left' | 'right' | 'justify';
-        /** It is a method to overwrite the column definitions in real-time just before the column edition. */
+        /** A method to overwrite the column definitions in real-time just before the column is edited. */
         filterOptions?: (worksheet: worksheetInstance, cell: HTMLElement, x: number, y: number, value: number|string, options: Column) => Column;
-        /** Load the items from the dropdown from a remote URL. */
+        /** The URL to load items from for the dropdown in this column, or when used in a text cell it will be a create a link */
         url?: string;
-        /** Define the items in the dropdown and autocomplete column type. */
+        /** The items to show in the dropdown or autocomplete. */
         source?: Array<DropdownItem> | Array<string> | Array<number>;
-        /** Autocomplete: boolean */
+        /** Whether the column is an autocomplete field. */
         autocomplete?: boolean;
-        /** Define the dropdown or autocomplete to accept multiple options. */
+        /** Whether the dropdown or autocomplete can accept multiple options. */
         multiple?: boolean;
-        /** Define the dropdown separator for multiple dropdown options. Default ; */
+        /** The delimiter to use for separating multiple dropdown options. Default: ";". */
         delimiter?: string;
-        /** Define the input mask for the data cell. @see https://jsuites.net/v4/javascript-mask */
+        /** The input mask to apply to the data cell. @see https://jsuites.net/v4/javascript-mask */
         mask?: string;
-        /** Decimal representation character. */
+        /** The character to use as the decimal separator. */
         decimal?: '.' | ',';
-        /** Truncate the string in the cell by any number of characters. */
+        /** The maximum number of characters to display in the cell before truncating. */
         truncate?: number,
-        /** Disable the mask when editing. */
+        /** Whether to disable the mask when editing. */
         disabledMaskOnEdition?: boolean;
-        /** It defines a renderer method or rule for the cell content. */
+        /** A renderer method or rule for the cell content. */
         render?: string | ((td: HTMLElement, value: number|string, x: number, y: number, worksheet: worksheetInstance, options: Column) => void);
-        /** Define the format of the date or numbers in the cell. Default for the calendar: DD/MM/YYYY */
+        /** The format of the date or numbers in the cell. Default for the calendar: "DD/MM/YYYY". */
         format?: string;
-        /** Define the column as primaryKey. */
+        /** Whether the column is a primary key. */
         primaryKey?: boolean;
-        /** Extended configuration for one column. */
+        /** Extended configuration for the column. */
         options?: Calendar | Dropdown;
-        /** The column is read-only */
+        /** Whether the column is read-only. */
         readOnly?: boolean;
-        /** Process the raw data when copy or download. Default: true */
+        /** Whether to process the raw data when copying or downloading. Default: true. */
         process?: boolean;
-        /** Try to cast numbers from a cell text. Default: true */
+        /** Whether to try to cast numbers from a cell text. Default: true. */
         autoCasting?: boolean;
-        /** Shift formula when copy and pasting. This option is only valid for custom column type. Default: false */
+        /** Whether to shift the formula when copying and pasting. This option is only valid for custom column types. Default: false. */
         shiftFormula?: boolean;
-        /** Wrap the text in the column */
+        /** Whether to wrap the text in the column. */
         wrap?: boolean;
-        /** Rotate text value between -90 and 90. Default: null */
+        /** The rotation angle for the text value, between -90 and 90. Default: null. */
         rotate?: number;
-        /** CSS odd even background color. Default: false */
+        /** Whether to apply CSS odd-even background color to the column. Default: false. */
         zebra?: boolean;
-        /** Group a number of columns define in this property */
+        /** The number of columns to group together. */
         group?: number;
         /** State of the column group. */
         state?: boolean;
@@ -402,22 +493,22 @@ declare namespace jspreadsheet {
     }
 
     interface Row {
-        /** Row height in pixels. */
-        height?: number;
-        /** Row identification. */
-        title?: string;
-        /** Row identification. */
-        visible?: boolean;
-        /** Style for the tr */
-        style?: string;
-        /** RecordID for the row */
-        id?: number;
-        /** Group row elements */
-        group?: number;
-        /** Group row state */
-        state?: boolean;
-        /** Readonly status of the row */
-        readOnly?: boolean;
+      /** Height of the row in pixels. */
+      height?: number;
+      /** Title or name of the row. */
+      title?: string;
+      /** Determines whether the row is visible or not. */
+      visible?: boolean;
+      /** Inline style for the row element (tr tag). */
+      style?: string;
+      /** ID number that identifies the row. */
+      id?: number;
+      /** Number of rows that this row is grouped with. */
+      group?: number;
+      /** State of the row group (collapsed or expanded). */
+      state?: boolean;
+      /** Determines whether the row is read-only or not. */
+      readOnly?: boolean;
     }
 
     interface RowInstance {
@@ -476,6 +567,8 @@ declare namespace jspreadsheet {
         colspan?: number;
         /** Alignment */
         align?: 'left' | 'center' | 'right';
+        /** Frozen */
+        frozen?: boolean;
     }
 
     interface Spreadsheet {
@@ -541,6 +634,8 @@ declare namespace jspreadsheet {
         onbeforesave?: (spreadsheet: spreadsheetInstance, worksheet: worksheetInstance, data: object) => boolean | object;
         /** After something is saved */
         onsave?: (spreadsheet: spreadsheetInstance, worksheet: worksheetInstance, data: Array<any>, result: object) => void;
+        /** When something goes wrong during a persistence operation */
+        onerror?: (spreadsheet: spreadsheetInstance, result: object) => void;
         /** Before a column value is changed. NOTE: It is possible to overwrite the original value, by return a new value on this method. */
         onbeforechange?: (worksheet: worksheetInstance, cell: HTMLElement, x: number, y: number, value: any) => boolean | any;
         /** After a column value is changed. */
@@ -550,25 +645,25 @@ declare namespace jspreadsheet {
         /** When a copy is performed in the spreadsheet. Any string returned will overwrite the user data or return null to progress with the default behavior. */
         oncopy?: (worksheet: worksheetInstance, selectedCells: Array<number>, data: string) => boolean | string;
         /** Before the paste action is performed. Can return parsed or filtered data. It is possible to cancel the action when the return is false. */
-        onbeforepaste?: (worksheet: worksheetInstance, data: Array<any>, x: number, y: number, style: [], processedData: string) => boolean | [];
+        onbeforepaste?: (worksheet: worksheetInstance, data: Array<any>, x: number, y: number, properties: []) => boolean | [];
         /** After a paste action is performed in the spreadsheet. */
         onpaste?: (worksheet: worksheetInstance, records: Array<any>) => void;
         /** Before a new row is inserted. You can cancel the insert event by returning false. */
-        onbeforeinsertrow?: (worksheet: worksheetInstance, rowNumber: number, numOfRows: number, insertBefore: boolean) => boolean | void;
+        onbeforeinsertrow?: (worksheet: worksheetInstance, newRow: []) => boolean | newRow[] | void;
         /** After a new row is inserted. */
-        oninsertrow?: (worksheet: worksheetInstance, rowNumber: number, numOfRows: number, rowData: [], insertBefore: boolean) => void;
+        oninsertrow?: (worksheet: worksheetInstance, newRow: []) => void;
         /** Before a row is deleted. You can cancel the delete event by returning false. */
-        onbeforedeleterow?: (worksheet: worksheetInstance, rowNumber: number, numOfRows: number) => boolean | void;
+        onbeforedeleterow?: (worksheet: worksheetInstance,  rows: number[]) => number[] | boolean | void;
         /** After a row is excluded. */
-        ondeleterow?: (worksheet: worksheetInstance, rowNumber: number, numOfRows: number, rowHTMLElements: [], rowData: [], cellAttributes: []) => void;
+        ondeleterow?: (worksheet: worksheetInstance, rows: number[]) => void;
         /** Before a new column is inserted. You can cancel the insert event by returning false. */
-        onbeforeinsertcolumn?: (worksheet: worksheetInstance, columnNumber: number, numOfColumns: number, insertBefore: boolean) => boolean | void;
+        onbeforeinsertcolumn?: (worksheet: worksheetInstance, newColumn: []) => boolean | newColumn[] | void;
         /** After a new column is inserted. */
-        oninsertcolumn?: (worksheet: worksheetInstance, columnNumber: number, numOfColumns: number, historyRecords: [], insertBefore: boolean) => void;
+        oninsertcolumn?: (worksheet: worksheetInstance, affected: []) => void;
         /** Before a column is excluded. You can cancel the insert event by returning false. */
-        onbeforedeletecolumn?: (worksheet: worksheetInstance, columnNumber: number, numOfColumns: number) => boolean | void;
+        onbeforedeletecolumn?: (worksheet: worksheetInstance, cols: number[]) => number[] | boolean | void;
         /** After a column is excluded. */
-        ondeletecolumn?: (worksheet: worksheetInstance, columnNumber: number, numOfColumns: number, affectedHTMLElements: [], historyProperties: [], cellAttributes: []) => void;
+        ondeletecolumn?: (worksheet: worksheetInstance, cols: number[]) => void;
         /** After a row is moved to a new position. */
         onmoverow?: (worksheet: worksheetInstance, origin: number, destination: number) => void;
         /** After a column is moved to a new position. */
@@ -579,8 +674,8 @@ declare namespace jspreadsheet {
         onresizecolumn?: (worksheet: worksheetInstance, column: number | Array<number>, width: number | Array<number>, oldWidth: number | Array<number>) => void;
         /** When the selection is changed. */
         onselection?: (worksheet: worksheetInstance, px: number, py: number, ux: number, uy: number, origin?: object) => void;
-        /** Before a new comment is added or updated. Return false to cancel the event. */
-        onbeforecomments?: (worksheet: worksheetInstance, cells: object) => boolean | void;
+        /** Before the comments is added or updated. Return false to cancel the event, void to accept the action or a object. */
+        onbeforecomments?: (worksheet: worksheetInstance, cells: object) => boolean | object | void;
         /** After a new comment is added or updated. */
         oncomments?: (worksheet: worksheetInstance, newValues: object, previousValues: object) => void;
         /** It runs before sorting a column. It should return an array with a custom sorting or false to cancel the user action. */
@@ -659,10 +754,6 @@ declare namespace jspreadsheet {
         onopenfilter?: (worksheet: worksheetInstance, column: number, options: Array<object>) => void | Array<object>;
         /** When the viewport dimension is updated. */
         onresize?: (worksheet: worksheetInstance, w: number, h: number) => void
-        /** Before the references are changed. */
-        onbeforechangereferences?: (worksheet: worksheetInstance, affectedTokens: [], deletedTokens: []) => void
-        /** When the references are changed. Sorting, Add/Delete/Move Rows and Columns. */
-        onchangereferences?: (worksheet: worksheetInstance, affectedTokens: [], deletedTokens: []) => void
         /** Intercept the ajax call before save. XHR ajax object */
         onbeforesend?: (worksheet: worksheetInstance, xhr: object) => void
         /** When defined names is affected */
@@ -674,25 +765,19 @@ declare namespace jspreadsheet {
         /** When change the column visibility */
         onchangecolumnvisibility?: (worksheet: object, state: boolean, columns: []) => void
         /** When a new row group is created */
-        oncreaterowgroup?: (worksheet: object, row: number, numOfItems: number) => void
-        /** When a row group is reset */
-        onresetrowgroup?: (worksheet: object, row: number) => void
+        ongrouprow?: (worksheet: object, row: number, numOfItems: number) => void
         /** When open a row group */
         onopenrowgroup?: (worksheet: object, row: number) => void
         /** When close a row group */
         oncloserowgroup?: (worksheet: object, row: number) => void
         /** When a new column group is created */
-        oncreatecolumngroup?: (worksheet: object, column: number, numOfItems: number) => void
-        /** When a column group is reset */
-        onresetcolumngroup?: (worksheet: object, column: number) => void
+        ongroupcolumn?: (worksheet: object, column: number, numOfItems: number) => void
         /** When open a column group */
         onopencolumngroup?: (worksheet: object, column: number) => void
         /** When close a column group */
         onclosecolumngroup?: (worksheet: object, column: number) => void
         /** General event handler */
         onevent?: (worksheet: worksheetInstance, method: string, a?: any, b?: any, c?: any, d?: any, e?: any, f?: any) => any
-        /** Run every single table update action. Can bring performance issues if perform too much changes. */
-        updateTable?: (worksheet: worksheetInstance, cell: HTMLElement, x: number, y: number, value: string) => void;
         /** Return false to cancel the contextMenu event, or return custom elements for the contextmenu. */
         contextMenu?: Contextmenu | null;
         /** The first row is the header titles when parsing a HTML table */
@@ -711,6 +796,10 @@ declare namespace jspreadsheet {
         validations?: Validation[];
         /** Plugins */
         plugins?: Record<string, Function>;
+        /** Global style */
+        style?: string[];
+        /** Snap the cells to the grid when scrolling. Default: false */
+        snapToGrid?: boolean;
         /** Space between the table and the end of the container. Default: 100   */
         spacing?: number;
     }
@@ -813,15 +902,15 @@ declare namespace jspreadsheet {
         /** Virtualization for rows. Works only when tableOverflow: true. Default: true */
         virtualizationY?: boolean;
         /** Initial comments. Default: null */
-        comments?: Record<string, string>;
+        comments?: Record<string, string|Comment[]>;
         /** Initial meta information. Default: null */
         meta?: Record<string, any>;
         /** Style */
-        style?: Record<string, string>;
-        /** Freeze columns. Default: 0 */
-        freezeColumns?: number;
-        /** Freeze rows. Default: 0 */
-        freezeRows?: number;
+        style?: Record<string, string|number>;
+        /** List of frozen column numbers. Should be a number or an array of consecutive numbers. Example: [4,5,6] */
+        freezeColumns?: number|number[];
+        /** List of frozen row numbers. Should be a number or an array of consecutive numbers. Example: [4,5,6] */
+        freezeRows?: number|number[];
         /** Enable freeze column manual control. Default: false */
         freezeColumnControl?: boolean,
         /** Enable freeze row manual control. Default: false */
@@ -838,7 +927,7 @@ declare namespace jspreadsheet {
         filters?: boolean;
         /** Footers */
         footers?: Array<any>;
-        /** Apply mask on footers */
+        /** Apply mask on footers. Default: true */
         applyMaskOnFooters?: boolean;
         /** Define options for the plugins. Each key should be the pluginName. */
         pluginOptions?: Record<string, any>;
@@ -851,9 +940,11 @@ declare namespace jspreadsheet {
         /** Enable resizable worksheet in on or both direction (horizontal | vertical | both). Default: none */
         resize?: 'horizontal' | 'vertical' | 'both' | 'none' | undefined;
         /** Wrap. Default: false */
-        wrap?: boolean,
+        wrap?: boolean;
         /** Show the worksheet gridlines. Default: true */
-        gridline?: boolean,
+        gridline?: boolean;
+        /** Floating images */
+        images?: Image[];
     }
 
     interface spreadsheetInstance {
@@ -861,10 +952,6 @@ declare namespace jspreadsheet {
         config: Spreadsheet;
         /** Contextmenu HTMLElement */
         contextmenu: HTMLElement;
-        /** Create a new worksheet from the given settings */
-        createWorksheet: (options: Worksheet) => worksheetInstance;
-        /** Delete an existing worksheet by its position */
-        deleteWorksheet: (position: number) => void;
         /** DOM Element */
         el: HTMLElement;
         /** DOM Element. Alias for el */
@@ -873,44 +960,16 @@ declare namespace jspreadsheet {
         filter: HTMLElement;
         /** Toggle the full screen mode */
         fullscreen: (state: Boolean) => void;
-        /** Get the toolbar object definitions */
-        getToolbar: (toolbar: Toolbar) => object,
-        /** Set the toolbar */
-        setToolbar: (toolbar: Toolbar) => void;
-        /** Show the toolbar */
-        showToolbar: () => void;
-        /** Hide the toolbar */
-        hideToolbar: () => void;
-        /** Get the worksheet index by instance or worksheet instance by index */
-        getWorksheet: (worksheetIdent: worksheetInstance | number) => number | string;
-        /** Get the active worksheet when applicable */
-        getWorksheetActive: () => number;
-        /** Get the worksheet instance by its position */
-        getWorksheetInstance: (position: number) => worksheetInstance;
         /** HTMLElement Helper */
         helper: HTMLElement,
-        /** Array with the history information */
-        history: [];
-        /** Internal history index position */
-        historyIndex: number;
         /** Ignore events */
         ignoreEvents: boolean;
-        /** Ignore history events */
-        ignoreHistory: boolean;
         /** Ignore persistence events */
         ignorePersistence: boolean;
         /** HTMLElement editor container */
         input: HTMLElement;
         /** HTMLElement loading element */
         loading: HTMLElement;
-        /** Rename an existing worksheet by its position */
-        renameWorksheet: (position: number, title: string) => void;
-        /** Move the position of a worksheet */
-        updateWorksheet: (from: number, to: number) => void;
-        /** Move the position of a worksheet. DOM Only (Internal method) - Please use updateWorksheet */
-        moveWorksheet: (from: number, to: number) => void;
-        /** Open a worksheet */
-        openWorksheet: (position: number) => void;
         /** Spreadsheet unique name */
         name: string;
         /** List of plugins loaded to the spreadsheet */
@@ -920,7 +979,7 @@ declare namespace jspreadsheet {
         /** Show progressbar */
         progress: (state: boolean) => void;
         /** Queue of formulas used during the loading */
-        queue: Array<string>;
+        queue: Map<object, object>;
         /** Undo */
         undo: () => void;
         /** Redo */
@@ -935,20 +994,46 @@ declare namespace jspreadsheet {
         worksheets: Array<Worksheet>;
         /** Load plugins into the spreadsheet */
         setPlugins: (plugins: Record<string, Function>) => void;
-        /** Internal history handlers */
-        setHistory: (history: object) => void;
-        /** Internal history handlers */
-        resetHistory: () => void;
         /** Internal method: event dispatch controllers. */
         dispatch: (...args: string[]) => void;
         /** Get the spreadsheet configuration */
         getConfig: () => Spreadsheet;
+        /** Get the worksheet index by instance or worksheetId  */
+        getWorksheet: (worksheetIdent: worksheetInstance | string) => number;
+        /** Get the worksheet name */
+        getWorksheetName: (position: number) => string;
+        /** Open a worksheet */
+        openWorksheet: (position: number) => void;
+        /** Create a new worksheet */
+        createWorksheet: (worksheetOptions: Worksheet, position?: Number) => worksheetInstance;
+        /** Delete an existing worksheet by its position */
+        deleteWorksheet: (position: number) => void;
+        /** Rename an existing worksheet by its position */
+        renameWorksheet: (position: number, title: string) => void;
+        /** Move the position of a worksheet. ignoreDomUpdates: true will block updates to the DOM */
+        moveWorksheet: (from: number, to: number, ignoreDomUpdates?: boolean) => void;
+        /** Get the active worksheet when applicable */
+        getWorksheetActive: () => number;
+        /** Get the worksheet instance by its position */
+        getWorksheetInstance: (position: number) => worksheetInstance;
+        /** Parse the toolbar definitions with defaults */
+        getToolbar: (toolbar: Toolbar) => object,
+        /** Set the toolbar */
+        setToolbar: (toolbar: Toolbar) => void;
+        /** Show the toolbar */
+        showToolbar: () => void;
+        /** Hide the toolbar */
+        hideToolbar: () => void;
+        /** Refresh the toolbar based on the current worksheet */
+        refreshToolbar: () => void;
+        /** Internal validations cache */
+        validations: () => void;
     }
 
     interface worksheetInstance {
         /** Array with the borders information */
         borders: Border[];
-        /** Close the editon for one cell */
+        /** Close the edition for one cell */
         closeEditor: (cell: HTMLElement, save: boolean) => void;
         /** Close the filters */
         closeFilters: (update: boolean) => void;
@@ -962,8 +1047,6 @@ declare namespace jspreadsheet {
         copy: (cut?: boolean) => void;
         /** HTML Element for the handler fill */
         corner: HTMLElement;
-        /** Create a new worksheet */
-        createWorksheet: (worksheetOptions: Worksheet) => worksheetInstance;
         /** Internal selected cell */
         cursor: object;
         /** Cut */
@@ -972,10 +1055,10 @@ declare namespace jspreadsheet {
         data: (highlighted?: boolean, processed?: boolean, delimiter?: string, asJson?: boolean) => Array<Array<any>> | Array<Record<string, any>> | string | null;
         /** Internal use control type to defined JSON (1) or ARRAY (0). */
         dataType: number,
-        /** Delete an existing column */
-        deleteColumn: (columnnumber: number, numOfColumns?: number) => void;
-        /** Delete an existing row */
-        deleteRow: (rownumber: number, numOfRows?: number) => void;
+        /** Delete one more more columns */
+        deleteColumn: (columnNumber: number|number[], numOfColumns?: number) => void;
+        /** Delete an existing row or rows */
+        deleteRow: (rowNumber: number|number[], numOfRows?: number) => void;
         /** Destroy all merged cells */
         destroyMerged: () => void;
         /** Legacy alias destroyMerged */
@@ -998,8 +1081,6 @@ declare namespace jspreadsheet {
         first: (shiftKey?: boolean, ctrlKey?: boolean) => void;
         /** Internal footer controllers */
         footers: Record<string, string>;
-        /** Internal formula chain controllers */
-        formula: [];
         /** Toggle the fullscreen mode */
         fullscreen: (state: boolean) => void;
         /** Get the border */
@@ -1018,8 +1099,8 @@ declare namespace jspreadsheet {
         getColumnIdByName: (name: string) => number;
         /** Alias for getProperties */
         getColumnOptions: (x: number, y?: number) => Column;
-        /** Get the comments from one cell. Example: getComments('A1') */
-        getComments: (cellName?: string) => string;
+        /** Get the comments from one cell or multiple cells. Example: getComments('A1') */
+        getComments: (cellName?: string) => string | object;
         /** Get the worksheet settings */
         getConfig: () => Worksheet;
         /**
@@ -1049,7 +1130,7 @@ declare namespace jspreadsheet {
         /** Get the height of one row by its position when height is defined. */
         getHeight: (row?: number) => Array<number> | number;
         /** Get the highlighted coordinates */
-        getHighlighted: () => Array<any>;
+        getHighlighted: () => null | Array<number>;
         /** Get the data as JSON. */
         getJson: (h?: boolean, processed?: boolean, delimiter?: boolean, asJson?: boolean) => any;
         /** Get the processed data cell shown to the user by the cell name or coordinates. */
@@ -1086,16 +1167,18 @@ declare namespace jspreadsheet {
         getRowId: (row: number) => number;
         /**
          * Get the selected cells
-         * @param {boolean} columnNameOnly - Return an array of cell names or cell DOM elements
-         * @param {boolean} ignoreHidden - Ignore hidden cells
+         * @param {boolean?} columnNameOnly - Return an array of cell names or cell DOM elements
+         * @param {boolean?} ignoreHidden - Ignore hidden cells
          */
-        getSelected: (columnNameOnly: boolean, ignoreHidden?: boolean) => any[];
+        getSelected: (columnNameOnly?: boolean, ignoreHidden?: boolean) => any[];
+        /** Get the coordinates of the main selection */
+        getSelection: () => null | Array<number>;
         /** Get the selected columns indexes */
-        getSelectedColumns: () => number[];
-        /** Get the selected rows. DOMElements or Indexes */
-        getSelectedRows: (indexes?: boolean) => HTMLElement[] | number[];
+        getSelectedColumns: (visibleOnly?: boolean) => number[];
+        /** Get the selected rows indexes. */
+        getSelectedRows: (visibleOnly?: boolean) => number[];
         /** Get the style from a cell or all cells. getStyle() or getStyle('A1') */
-        getStyle: (cellName?: string|null) => string|object;
+        getStyle: (cellName?: string|null, onlyIndexes?: boolean) => string|object;
         /** Get value by the cell name or object. The value can be the raw or processed value. */
         getValue: (cell: string, processed: boolean) => string;
         /** Get value by the coordinates. The value can be the raw or processed value. */
@@ -1118,10 +1201,20 @@ declare namespace jspreadsheet {
         hideRow: (row: number|number[]) => void;
         /** Hide the search container */
         hideSearch: () => void;
-        /** Add a new column */
-        insertColumn: (numOfColOrData?: number | any[], columnNumber?: number, insertBefore?: boolean, properties?: Column, data?: any[] | any[][] | null, extraInformationFromEvents?: object, mouseEvent?: object) => void;
-        /** Add a new row */
-        insertRow: (numOfRowsOrData?: number | any[], rowNumber?: number, insertBefore?: boolean, data?: any[] | any[][] | null, mouseEvent?: object) => void;
+        /**
+         * Add new column(s)
+         * @param {number|object[]} column - number of columns or array with column information
+         * @param {number?} columnNumber - reference when the first argument is a number
+         * @param {boolean?} insertBefore - insertBefore when the first argument is a number
+         */
+        insertColumn: (column?: number | newColumn[], columnNumber?: number, insertBefore?: boolean) => void;
+        /**
+         * Add new row(s)
+         * @param {number|object[]} row - number of rows or array with row information
+         * @param {number?} rowNumber - reference when the first argument is a number
+         * @param {boolean?} insertBefore - insertBefore when the first argument is a number
+         */
+        insertRow: (row?: number | newRow[], rowNumber?: number, insertBefore?: boolean) => void;
         /** Check if cell is attached to the DOM */
         isAttached: (x: number, y: number) => boolean;
         /** The worksheet is editable */
@@ -1136,10 +1229,10 @@ declare namespace jspreadsheet {
         left: (shiftKey?: boolean, ctrlKey?: boolean, jump?: boolean) => void;
         /** Dynamic load data to the spreadsheet. This method does not trigger events or persistence and reset the spreadsheet. To persist use setData. */
         loadData: (data: any[]) => void;
-        /** Change a column position */
-        moveColumn: (from: number, to: number) => void;
-        /** Change a row position */
-        moveRow: (from: number, to: number) => void;
+        /** Move one or more columns to another position */
+        moveColumn: (col: number, to: number, quantityOfColumns?: number) => void;
+        /** Move one or more rows to another position  */
+        moveRow: (row: number, to: number, quantityOfRows?: number) => void;
         /** Get the column name */
         name: (col: number) => string;
         /** Start the edition for one cell */
@@ -1164,8 +1257,6 @@ declare namespace jspreadsheet {
         quantityOfPages?: () => number;
         /** Array container for all cell DOM elements */
         records: Records[][];
-        /** Refresh the whole data or from a single row  */
-        refresh: (y: number | undefined) => void;
         /** Refresh the borders by the border name */
         refreshBorders: (border?: string) => void;
         /** Refresh footers */
@@ -1222,8 +1313,8 @@ declare namespace jspreadsheet {
         setCells: (cellName: string, settings: Column) => void;
         /** Set the column data from its number */
         setColumnData: (col: number, data: any[], force?: boolean) => void;
-        /** Set the comments for one cell */
-        setComments: (cellName: string, comments: string) => void;
+        /** Set the comments for one or multiple cells */
+        setComments: (cellName: string | Record<string, string>, comments?: string) => void;
         /** Change the worksheet settings */
         setConfig: (config: Worksheet) => void;
         /** Set the worksheet data */
@@ -1236,8 +1327,8 @@ declare namespace jspreadsheet {
         setFooter: (data: []) => void;
         /** Set the footer value */
         setFooterValue: (col: number, row: number, value: any) => void;
-        /** Freeze x number of columns */
-        setFreezeColumns: (num: number) => void;
+        /** List of columns to freeze. Should be a number or an array of consecutive numbers. Example: [4,5,6] */
+        setFreezeColumns: (num: number|number[]) => void;
         /** Set the header title. Empty or null to reset to the default header value. */
         setHeader: (x: number, title?: string) => void;
         /** Set the height of one row by its position. currentHeight is for internal use only */
@@ -1263,7 +1354,7 @@ declare namespace jspreadsheet {
         /**
          * Set a cell value
          *
-         * @param {mixed} cell destination cell
+         * @param {string|string[]|object} cell destination cell
          * @param {string|number} value
          * @param {boolean} force value over readonly cells
          * @return void
@@ -1324,15 +1415,15 @@ declare namespace jspreadsheet {
         /** Which page the row number is */
         whichPage?: (row: number) => number;
         /** Create a new group of rows */
-        setRowGroup: (row: number, numOfElements: number) => void;
+        setRowGroup: (row: number, numOfItems?: number) => void;
         /** Open a new group of rows */
         openRowGroup: (row: number) => void;
         /** Close a new group of rows */
         closeRowGroup: (row: number) => void;
-        /** Destroy a new group of rows */
+        /** Reset a group of rows */
         resetRowGroup: (row: number) => void;
         /** Create a new group of columns */
-        setColumnGroup: (column: number, numOfElements: number) => void;
+        setColumnGroup: (column: number, numOfItems?: number) => void;
         /** Open a new group of columns */
         openColumnGroup: (column: number) => void;
         /** Close a new group of columns */
@@ -1343,12 +1434,6 @@ declare namespace jspreadsheet {
         autoResize: (column: number[]) => void;
         /** Aliases for jspreadsheet.helpers. Tools to handle spreadsheet data */
         helpers: Helpers;
-        /** Deprecated. Alias for the parent.showToolbar() */
-        showToolbar: () => void;
-        /** Deprecated. Alias for the parent.hideToolbar() */
-        hideToolbar: () => void;
-        /** Refresh the toolbar based on the current worksheet */
-        refreshToolbar: () => void;
         /** Internal persistence handler */
         persistence: Function;
         /** Deprecated. Alias for parent.undo */
@@ -1371,10 +1456,8 @@ declare namespace jspreadsheet {
         onload?: () => void;
         /** Internal nested headers DOM container */
         nested?: object;
-        /** Internal formula array values */
-        resetArray?: (x: number, y: number) => void;
-        /** Freeze a number of rows */
-        setFreezeRows: (numberOfRows: number) => void;
+        /** List of rows to freeze. Should be a number or an array of consecutive numbers. Example: [4,5,6] */
+        setFreezeRows: (numberOfRows: number|number[]) => void;
         /** Reset the freeze rows */
         resetFreezeRows: () => void;
         /** Reset the properties of a cell */
@@ -1383,31 +1466,57 @@ declare namespace jspreadsheet {
         setFormula: () => void;
         /** Update nested cell properties */
         setNestedCell: (x: number, y: number, properties: Nested) => void;
-        /** Internal method: Update the merge cell dimensions */
-        updateMerge: (cellName: string, colspan: number, rowspan: number) => void;
-        /** Get the worksheet name */
-        getWorksheetName: () => string;
-        /** Rename an existing worksheet by its position */
-        renameWorksheet: (position: number, title: string) => void;
-        /** Open this worksheet */
-        openWorksheet: () => void;
-        /** Move the position of a worksheet. DOM Only (Internal method) - Please use updateWorksheet */
-        moveWorksheet: (from: number, to: number) => void;
-        /** Get the worksheet index by instance or worksheet instance by index */
-        getWorksheet: (worksheetIdent: worksheetInstance | number) => number | string;
-        /** Get the active worksheet when applicable */
-        getWorksheetActive: () => number;
-        /** Delete an existing worksheet by its position */
-        deleteWorksheet: (position: number) => void;
         /** Get a validation object. Require the extension Validations. */
         getValidations: (validationIndex: number | null) => Validation | Validation[];
         /** Insert or update existing validations by index. Require the extension Validations. */
         setValidations: (validations: Validations[]) => void;
         /** Reset validations by validation indexes. Require the extension Validations. */
         resetValidations: (validationIndex: number | number[]) => void;
+        /** Load all validations rules from a cell based on its coordinates. */
+        loadValidations: (xOrCell: number|object, y?: number) => object[];
+        /** This method returns true when a cell has not passed all the validations defined for that cell. */
+        hasErrors: (xOrCell: number|object, y?: number) => boolean;
         /** Resize columns to match the visible content */
         autoWidth: (columns: number[]) => void;
+        /** Show the column headers */
+        showHeaders: () => void;
+        /** Hide the column headers */
+        hideHeaders: () => void;
+        /** Refresh the search on the viewport */
+        updateSearch: () => void;
+        /** Get the worksheet index by instance or worksheetId  */
+        getWorksheet: (worksheetIdent: worksheetInstance | string) => number;
+        /** Get the worksheet name */
+        getWorksheetName: (position?: number) => string;
+        /** Open a worksheet */
+        openWorksheet: (position?: number) => void;
+        /** Create a new worksheet */
+        createWorksheet: (worksheetOptions: Worksheet, position?: Number) => worksheetInstance;
+        /** Delete an existing worksheet by its position */
+        deleteWorksheet: (position?: number) => void;
+        /** Rename an existing worksheet by its position */
+        renameWorksheet: (position: number, title: string) => void;
+        /** Move the position of a worksheet. ignoreDomUpdates: true will block updates to the DOM */
+        moveWorksheet: (from: number, to: number, ignoreDomUpdates?: boolean) => void;
+        /** Get the active worksheet when applicable */
+        getWorksheetActive: () => number;
+        /** Get the worksheet instance by its position */
+        getWorksheetInstance: (position: number) => worksheetInstance;
+        /** Parse the toolbar definitions with defaults */
+        getToolbar: (toolbar: Toolbar) => object,
+        /** Set the toolbar */
+        setToolbar: (toolbar: Toolbar) => void;
+        /** Show the toolbar */
+        showToolbar: () => void;
+        /** Hide the toolbar */
+        hideToolbar: () => void;
+        /** Refresh the toolbar based on the current worksheet */
+        refreshToolbar: () => void;
+        /** Add, update or delete a new worksheet floating image */
+        setImage: (index: number, info: Image) => void;
+        /** Add a global formula to the tracking system. Use from formula pro. Only use if necessary. */
+        setTracking: () => void;
     }
 }
 
-export default jspreadsheet;
+export default jspreadsheet;