@ckeditor/ckeditor5-table 31.0.0 → 33.0.0

package/src/tableproperties/commands/tableheightcommand.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2021, CKSource - Frederico Knabben. All rights reserved.
+ * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 
@@ -40,7 +40,7 @@ export default class TableHeightCommand extends TablePropertyCommand {
 	 * @param {String} defaultValue The default value of the attribute.
 	 */
 	constructor( editor, defaultValue ) {
-		super( editor, 'height', defaultValue );
+		super( editor, 'tableHeight', defaultValue );
 	}
 
 	/**

package/src/tableproperties/commands/tablepropertycommand.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2021, CKSource - Frederico Knabben. All rights reserved.
+ * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 
@@ -77,7 +77,7 @@ export default class TablePropertyCommand extends Command {
 		const table = selection.getFirstPosition().findAncestor( 'table' );
 		const valueToSet = this._getValueToSet( value );
 
-		model.enqueueChange( batch || 'default', writer => {
+		model.enqueueChange( batch, writer => {
 			if ( valueToSet ) {
 				writer.setAttribute( this.attributeName, valueToSet, table );
 			} else {

package/src/tableproperties/commands/tablewidthcommand.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2021, CKSource - Frederico Knabben. All rights reserved.
+ * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 
@@ -40,7 +40,7 @@ export default class TableWidthCommand extends TablePropertyCommand {
 	 * @param {String} defaultValue The default value of the attribute.
 	 */
 	constructor( editor, defaultValue ) {
-		super( editor, 'width', defaultValue );
+		super( editor, 'tableWidth', defaultValue );
 	}
 
 	/**

package/src/tableproperties/tablepropertiesediting.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2021, CKSource - Frederico Knabben. All rights reserved.
+ * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 
@@ -34,10 +34,10 @@ const FLOAT_VALUES_REG_EXP = /^(left|none|right)$/;
  *
  * Introduces table's model attributes and their conversion:
  *
- * - border: `borderStyle`, `borderColor` and `borderWidth`
- * - background color: `backgroundColor`
- * - horizontal alignment: `alignment`
- * - width & height: `width` & `height`
+ * - border: `tableBorderStyle`, `tableBorderColor` and `tableBorderWidth`
+ * - background color: `tableBackgroundColor`
+ * - horizontal alignment: `tableAlignment`
+ * - width & height: `tableWidth` & `tableHeight`
  *
  * It also registers commands used to manipulate the above attributes:
  *
@@ -91,14 +91,14 @@ export default class TablePropertiesEditing extends Plugin {
 		editor.commands.add( 'tableAlignment', new TableAlignmentCommand( editor, defaultTableProperties.alignment ) );
 
 		enableTableToFigureProperty( schema, conversion, {
-			modelAttribute: 'width',
+			modelAttribute: 'tableWidth',
 			styleName: 'width',
 			defaultValue: defaultTableProperties.width
 		} );
 		editor.commands.add( 'tableWidth', new TableWidthCommand( editor, defaultTableProperties.width ) );
 
 		enableTableToFigureProperty( schema, conversion, {
-			modelAttribute: 'height',
+			modelAttribute: 'tableHeight',
 			styleName: 'height',
 			defaultValue: defaultTableProperties.height
 		} );
@@ -106,7 +106,7 @@ export default class TablePropertiesEditing extends Plugin {
 
 		editor.data.addStyleProcessorRules( addBackgroundRules );
 		enableProperty( schema, conversion, {
-			modelAttribute: 'backgroundColor',
+			modelAttribute: 'tableBackgroundColor',
 			styleName: 'background-color',
 			defaultValue: defaultTableProperties.backgroundColor
 		} );
@@ -117,22 +117,30 @@ export default class TablePropertiesEditing extends Plugin {
 	}
 }
 
-// Enables `'borderStyle'`, `'borderColor'` and `'borderWidth'` attributes for table.
+// Enables `tableBorderStyle'`, `tableBorderColor'` and `tableBorderWidth'` attributes for table.
 //
 // @param {module:engine/model/schema~Schema} schema
 // @param {module:engine/conversion/conversion~Conversion} conversion
 // @param {Object} defaultBorder The default border values.
-// @param {String} defaultBorder.color The default `borderColor` value.
-// @param {String} defaultBorder.style The default `borderStyle` value.
-// @param {String} defaultBorder.width The default `borderWidth` value.
+// @param {String} defaultBorder.color The default `tableBorderColor` value.
+// @param {String} defaultBorder.style The default `tableBorderStyle` value.
+// @param {String} defaultBorder.width The default `tableBorderWidth` value.
 function enableBorderProperties( schema, conversion, defaultBorder ) {
+	const modelAttributes = {
+		width: 'tableBorderWidth',
+		color: 'tableBorderColor',
+		style: 'tableBorderStyle'
+	};
+
 	schema.extend( 'table', {
-		allowAttributes: [ 'borderWidth', 'borderColor', 'borderStyle' ]
+		allowAttributes: Object.values( modelAttributes )
 	} );
-	upcastBorderStyles( conversion, 'table', defaultBorder );
-	downcastTableAttribute( conversion, { modelAttribute: 'borderColor', styleName: 'border-color' } );
-	downcastTableAttribute( conversion, { modelAttribute: 'borderStyle', styleName: 'border-style' } );
-	downcastTableAttribute( conversion, { modelAttribute: 'borderWidth', styleName: 'border-width' } );
+
+	upcastBorderStyles( conversion, 'table', modelAttributes, defaultBorder );
+
+	downcastTableAttribute( conversion, { modelAttribute: modelAttributes.color, styleName: 'border-color' } );
+	downcastTableAttribute( conversion, { modelAttribute: modelAttributes.style, styleName: 'border-style' } );
+	downcastTableAttribute( conversion, { modelAttribute: modelAttributes.width, styleName: 'border-width' } );
 }
 
 // Enables the `'alignment'` attribute for table.
@@ -142,14 +150,14 @@ function enableBorderProperties( schema, conversion, defaultBorder ) {
 // @param {String} defaultValue The default alignment value.
 function enableAlignmentProperty( schema, conversion, defaultValue ) {
 	schema.extend( 'table', {
-		allowAttributes: [ 'alignment' ]
+		allowAttributes: [ 'tableAlignment' ]
 	} );
 
 	conversion.for( 'downcast' )
 		.attributeToAttribute( {
 			model: {
 				name: 'table',
-				key: 'alignment'
+				key: 'tableAlignment'
 			},
 			view: alignment => ( {
 				key: 'style',
@@ -171,7 +179,7 @@ function enableAlignmentProperty( schema, conversion, defaultValue ) {
 				}
 			},
 			model: {
-				key: 'alignment',
+				key: 'tableAlignment',
 				value: viewElement => {
 					let align = viewElement.getStyle( 'float' );
 
@@ -193,7 +201,7 @@ function enableAlignmentProperty( schema, conversion, defaultValue ) {
 			},
 			model: {
 				name: 'table',
-				key: 'alignment',
+				key: 'tableAlignment',
 				value: viewElement => {
 					const align = viewElement.getAttribute( 'align' );
 

package/src/tableproperties/tablepropertiesui.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2021, CKSource - Frederico Knabben. All rights reserved.
+ * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 

package/src/tableproperties/ui/tablepropertiesview.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2021, CKSource - Frederico Knabben. All rights reserved.
+ * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 
@@ -379,6 +379,16 @@ export default class TablePropertiesView extends View {
 		this.keystrokes.listenTo( this.element );
 	}
 
+	/**
+	 * @inheritDoc
+	 */
+	destroy() {
+		super.destroy();
+
+		this.focusTracker.destroy();
+		this.keystrokes.destroy();
+	}
+
 	/**
 	 * Focuses the fist focusable field in the form.
 	 */

package/src/tableproperties.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2021, CKSource - Frederico Knabben. All rights reserved.
+ * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 

package/src/tableselection.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2021, CKSource - Frederico Knabben. All rights reserved.
+ * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 
@@ -14,7 +14,6 @@ import TableWalker from './tablewalker';
 import TableUtils from './tableutils';
 
 import { cropTableToDimensions, adjustLastRowIndex, adjustLastColumnIndex } from './utils/structure';
-import { getColumnIndexes, getRowIndexes, getSelectedTableCells, isSelectionRectangular } from './utils/selection';
 
 import '../theme/tableselection.css';
 
@@ -36,7 +35,7 @@ export default class TableSelection extends Plugin {
 	 * @inheritDoc
 	 */
 	static get requires() {
-		return [ TableUtils ];
+		return [ TableUtils, TableUtils ];
 	}
 
 	/**
@@ -58,9 +57,10 @@ export default class TableSelection extends Plugin {
 	 * @returns {Array.<module:engine/model/element~Element>|null}
 	 */
 	getSelectedTableCells() {
+		const tableUtils = this.editor.plugins.get( TableUtils );
 		const selection = this.editor.model.document.selection;
 
-		const selectedCells = getSelectedTableCells( selection );
+		const selectedCells = tableUtils.getSelectedTableCells( selection );
 
 		if ( selectedCells.length == 0 ) {
 			return null;
@@ -81,6 +81,7 @@ export default class TableSelection extends Plugin {
 	 * @returns {module:engine/model/documentfragment~DocumentFragment|null}
 	 */
 	getSelectionAsFragment() {
+		const tableUtils = this.editor.plugins.get( TableUtils );
 		const selectedCells = this.getSelectedTableCells();
 
 		if ( !selectedCells ) {
@@ -89,10 +90,9 @@ export default class TableSelection extends Plugin {
 
 		return this.editor.model.change( writer => {
 			const documentFragment = writer.createDocumentFragment();
-			const tableUtils = this.editor.plugins.get( 'TableUtils' );
 
-			const { first: firstColumn, last: lastColumn } = getColumnIndexes( selectedCells );
-			const { first: firstRow, last: lastRow } = getRowIndexes( selectedCells );
+			const { first: firstColumn, last: lastColumn } = tableUtils.getColumnIndexes( selectedCells );
+			const { first: firstRow, last: lastRow } = tableUtils.getRowIndexes( selectedCells );
 
 			const sourceTable = selectedCells[ 0 ].findAncestor( 'table' );
 
@@ -101,7 +101,7 @@ export default class TableSelection extends Plugin {
 
 			// If the selection is rectangular there could be a case of all cells in the last row/column spanned over
 			// next row/column so the real lastRow/lastColumn should be updated.
-			if ( isSelectionRectangular( selectedCells, tableUtils ) ) {
+			if ( tableUtils.isSelectionRectangular( selectedCells ) ) {
 				const dimensions = {
 					firstColumn,
 					lastColumn,
@@ -269,10 +269,11 @@ export default class TableSelection extends Plugin {
 	 * @param {Array.<*>} args Delete content method arguments.
 	 */
 	_handleDeleteContent( event, args ) {
+		const tableUtils = this.editor.plugins.get( TableUtils );
 		const [ selection, options ] = args;
 		const model = this.editor.model;
 		const isBackward = !options || options.direction == 'backward';
-		const selectedTableCells = getSelectedTableCells( selection );
+		const selectedTableCells = tableUtils.getSelectedTableCells( selection );
 
 		if ( !selectedTableCells.length ) {
 			return;

package/src/tabletoolbar.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2021, CKSource - Frederico Knabben. All rights reserved.
+ * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 

package/src/tableui.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2021, CKSource - Frederico Knabben. All rights reserved.
+ * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 

package/src/tableutils.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2021, CKSource - Frederico Knabben. All rights reserved.
+ * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 
@@ -775,6 +775,288 @@ export default class TableUtils extends Plugin {
 		return Array.from( table.getChildren() )
 			.reduce( ( rowCount, child ) => child.is( 'element', 'tableRow' ) ? rowCount + 1 : rowCount, 0 );
 	}
+
+	/**
+	 * Creates an instance of the table walker.
+	 *
+	 * The table walker iterates internally by traversing the table from row index = 0 and column index = 0.
+	 * It walks row by row and column by column in order to output values defined in the options.
+	 * By default it will output only the locations that are occupied by a cell. To include also spanned rows and columns,
+	 * pass the `includeAllSlots` option.
+	 *
+	 * @protected
+	 * @param {module:engine/model/element~Element} table A table over which the walker iterates.
+	 * @param {Object} [options={}] An object with configuration.
+	 * @param {Number} [options.row] A row index for which this iterator will output cells.
+	 * Can't be used together with `startRow` and `endRow`.
+	 * @param {Number} [options.startRow=0] A row index from which this iterator should start. Can't be used together with `row`.
+	 * @param {Number} [options.endRow] A row index at which this iterator should end. Can't be used together with `row`.
+	 * @param {Number} [options.column] A column index for which this iterator will output cells.
+	 * Can't be used together with `startColumn` and `endColumn`.
+	 * @param {Number} [options.startColumn=0] A column index from which this iterator should start. Can't be used together with `column`.
+	 * @param {Number} [options.endColumn] A column index at which this iterator should end. Can't be used together with `column`.
+	 * @param {Boolean} [options.includeAllSlots=false] Also return values for spanned cells.
+	 */
+	createTableWalker( table, options = {} ) {
+		return new TableWalker( table, options );
+	}
+
+	/**
+	 * Returns all model table cells that are fully selected (from the outside)
+	 * within the provided model selection's ranges.
+	 *
+	 * To obtain the cells selected from the inside, use
+	 * {@link #getTableCellsContainingSelection}.
+	 *
+	 * @param {module:engine/model/selection~Selection} selection
+	 * @returns {Array.<module:engine/model/element~Element>}
+	 */
+	getSelectedTableCells( selection ) {
+		const cells = [];
+
+		for ( const range of this.sortRanges( selection.getRanges() ) ) {
+			const element = range.getContainedElement();
+
+			if ( element && element.is( 'element', 'tableCell' ) ) {
+				cells.push( element );
+			}
+		}
+
+		return cells;
+	}
+
+	/**
+	 * Returns all model table cells that the provided model selection's ranges
+	 * {@link module:engine/model/range~Range#start} inside.
+	 *
+	 * To obtain the cells selected from the outside, use
+	 * {@link #getSelectedTableCells}.
+	 *
+	 * @param {module:engine/model/selection~Selection} selection
+	 * @returns {Array.<module:engine/model/element~Element>}
+	 */
+	getTableCellsContainingSelection( selection ) {
+		const cells = [];
+
+		for ( const range of selection.getRanges() ) {
+			const cellWithSelection = range.start.findAncestor( 'tableCell' );
+
+			if ( cellWithSelection ) {
+				cells.push( cellWithSelection );
+			}
+		}
+
+		return cells;
+	}
+
+	/**
+	 * Returns all model table cells that are either completely selected
+	 * by selection ranges or host selection range
+	 * {@link module:engine/model/range~Range#start start positions} inside them.
+	 *
+	 * Combines {@link #getTableCellsContainingSelection} and
+	 * {@link #getSelectedTableCells}.
+	 *
+	 * @param {module:engine/model/selection~Selection} selection
+	 * @returns {Array.<module:engine/model/element~Element>}
+	 */
+	getSelectionAffectedTableCells( selection ) {
+		const selectedCells = this.getSelectedTableCells( selection );
+
+		if ( selectedCells.length ) {
+			return selectedCells;
+		}
+
+		return this.getTableCellsContainingSelection( selection );
+	}
+
+	/**
+	 * Returns an object with the `first` and `last` row index contained in the given `tableCells`.
+	 *
+	 *		const selectedTableCells = getSelectedTableCells( editor.model.document.selection );
+	*
+	*		const { first, last } = getRowIndexes( selectedTableCells );
+	*
+	*		console.log( `Selected rows: ${ first } to ${ last }` );
+	*
+	* @param {Array.<module:engine/model/element~Element>} tableCells
+	* @returns {Object} Returns an object with the `first` and `last` table row indexes.
+	*/
+	getRowIndexes( tableCells ) {
+		const indexes = tableCells.map( cell => cell.parent.index );
+
+		return this._getFirstLastIndexesObject( indexes );
+	}
+
+	/**
+	 * Returns an object with the `first` and `last` column index contained in the given `tableCells`.
+	 *
+	 *		const selectedTableCells = getSelectedTableCells( editor.model.document.selection );
+	*
+	*		const { first, last } = getColumnIndexes( selectedTableCells );
+	*
+	*		console.log( `Selected columns: ${ first } to ${ last }` );
+	*
+	* @param {Array.<module:engine/model/element~Element>} tableCells
+	* @returns {Object} Returns an object with the `first` and `last` table column indexes.
+	*/
+	getColumnIndexes( tableCells ) {
+		const table = tableCells[ 0 ].findAncestor( 'table' );
+		const tableMap = [ ...new TableWalker( table ) ];
+
+		const indexes = tableMap
+			.filter( entry => tableCells.includes( entry.cell ) )
+			.map( entry => entry.column );
+
+		return this._getFirstLastIndexesObject( indexes );
+	}
+
+	/**
+	 * Checks if the selection contains cells that do not exceed rectangular selection.
+	 *
+	 * In a table below:
+	 *
+	 *		┌───┬───┬───┬───┐
+	*		│ a │ b │ c │ d │
+	*		├───┴───┼───┤   │
+	*		│ e     │ f │   │
+	*		│       ├───┼───┤
+	*		│       │ g │ h │
+	*		└───────┴───┴───┘
+	*
+	* Valid selections are these which create a solid rectangle (without gaps), such as:
+	*   - a, b (two horizontal cells)
+	*   - c, f (two vertical cells)
+	*   - a, b, e (cell "e" spans over four cells)
+	*   - c, d, f (cell d spans over a cell in the row below)
+	*
+	* While an invalid selection would be:
+	*   - a, c (the unselected cell "b" creates a gap)
+	*   - f, g, h (cell "d" spans over a cell from the row of "f" cell - thus creates a gap)
+	*
+	* @param {Array.<module:engine/model/element~Element>} selectedTableCells
+	* @returns {Boolean}
+	*/
+	isSelectionRectangular( selectedTableCells ) {
+		if ( selectedTableCells.length < 2 || !this._areCellInTheSameTableSection( selectedTableCells ) ) {
+			return false;
+		}
+
+		// A valid selection is a fully occupied rectangle composed of table cells.
+		// Below we will calculate the area of a selected table cells and the area of valid selection.
+		// The area of a valid selection is defined by top-left and bottom-right cells.
+		const rows = new Set();
+		const columns = new Set();
+
+		let areaOfSelectedCells = 0;
+
+		for ( const tableCell of selectedTableCells ) {
+			const { row, column } = this.getCellLocation( tableCell );
+			const rowspan = parseInt( tableCell.getAttribute( 'rowspan' ) || 1 );
+			const colspan = parseInt( tableCell.getAttribute( 'colspan' ) || 1 );
+
+			// Record row & column indexes of current cell.
+			rows.add( row );
+			columns.add( column );
+
+			// For cells that spans over multiple rows add also the last row that this cell spans over.
+			if ( rowspan > 1 ) {
+				rows.add( row + rowspan - 1 );
+			}
+
+			// For cells that spans over multiple columns add also the last column that this cell spans over.
+			if ( colspan > 1 ) {
+				columns.add( column + colspan - 1 );
+			}
+
+			areaOfSelectedCells += ( rowspan * colspan );
+		}
+
+		// We can only merge table cells that are in adjacent rows...
+		const areaOfValidSelection = getBiggestRectangleArea( rows, columns );
+
+		return areaOfValidSelection == areaOfSelectedCells;
+	}
+
+	/**
+	 * Returns array of sorted ranges.
+	 *
+	 * @param {Iterable.<module:engine/model/range~Range>} ranges
+	 * @return {Array.<module:engine/model/range~Range>}
+	 */
+	sortRanges( ranges ) {
+		return Array.from( ranges ).sort( compareRangeOrder );
+	}
+
+	/**
+	 * Helper method to get an object with `first` and `last` indexes from an unsorted array of indexes.
+	 *
+	 * @private
+	 * @param {Number[]} indexes
+	 * @returns {Object}
+	 */
+	_getFirstLastIndexesObject( indexes ) {
+		const allIndexesSorted = indexes.sort( ( indexA, indexB ) => indexA - indexB );
+
+		const first = allIndexesSorted[ 0 ];
+		const last = allIndexesSorted[ allIndexesSorted.length - 1 ];
+
+		return { first, last };
+	}
+
+	/**
+	 * Checks if the selection does not mix a header (column or row) with other cells.
+	 *
+	 * For instance, in the table below valid selections consist of cells with the same letter only.
+	 * So, a-a (same heading row and column) or d-d (body cells) are valid while c-d or a-b are not.
+	 *
+	 * header columns
+	 *		  ↓   ↓
+	 *		┌───┬───┬───┬───┐
+	 *		│ a │ a │ b │ b │  ← header row
+	 *		├───┼───┼───┼───┤
+	 *		│ c │ c │ d │ d │
+	 *		├───┼───┼───┼───┤
+	 *		│ c │ c │ d │ d │
+	 *		└───┴───┴───┴───┘
+	 *
+	 * @private
+	 * @param {Array.<module:engine/model/element~Element>} tableCells
+	 * @returns {Boolean}
+	 */
+	_areCellInTheSameTableSection( tableCells ) {
+		const table = tableCells[ 0 ].findAncestor( 'table' );
+
+		const rowIndexes = this.getRowIndexes( tableCells );
+		const headingRows = parseInt( table.getAttribute( 'headingRows' ) || 0 );
+
+		// Calculating row indexes is a bit cheaper so if this check fails we can't merge.
+		if ( !this._areIndexesInSameSection( rowIndexes, headingRows ) ) {
+			return false;
+		}
+
+		const headingColumns = parseInt( table.getAttribute( 'headingColumns' ) || 0 );
+		const columnIndexes = this.getColumnIndexes( tableCells );
+
+		// Similarly cells must be in same column section.
+		return this._areIndexesInSameSection( columnIndexes, headingColumns );
+	}
+
+	/**
+	 * Unified check if table rows/columns indexes are in the same heading/body section.
+	 *
+	 * @private
+	 * @param {Object} params
+	 * @param {Number} params.first
+	 * @param {Number} params.last
+	 * @param {Number} headingSectionSize
+	 */
+	_areIndexesInSameSection( { first, last }, headingSectionSize ) {
+		const firstCellIsInHeading = first < headingSectionSize;
+		const lastCellIsInHeading = last < headingSectionSize;
+
+		return firstCellIsInHeading === lastCellIsInHeading;
+	}
 }
 
 // Creates empty rows at the given index in an existing table.
@@ -943,3 +1225,31 @@ function moveCellsToRow( table, targetRowIndex, cellsToMove, writer ) {
 		}
 	}
 }
+
+function compareRangeOrder( rangeA, rangeB ) {
+	// Since table cell ranges are disjoint, it's enough to check their start positions.
+	const posA = rangeA.start;
+	const posB = rangeB.start;
+
+	// Checking for equal position (returning 0) is not needed because this would be either:
+	// a. Intersecting range (not allowed by model)
+	// b. Collapsed range on the same position (allowed by model but should not happen).
+	return posA.isBefore( posB ) ? -1 : 1;
+}
+
+// Calculates the area of a maximum rectangle that can span over the provided row & column indexes.
+//
+// @param {Array.<Number>} rows
+// @param {Array.<Number>} columns
+// @returns {Number}
+function getBiggestRectangleArea( rows, columns ) {
+	const rowsIndexes = Array.from( rows.values() );
+	const columnIndexes = Array.from( columns.values() );
+
+	const lastRow = Math.max( ...rowsIndexes );
+	const firstRow = Math.min( ...rowsIndexes );
+	const lastColumn = Math.max( ...columnIndexes );
+	const firstColumn = Math.min( ...columnIndexes );
+
+	return ( lastRow - firstRow + 1 ) * ( lastColumn - firstColumn + 1 );
+}

package/src/tablewalker.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2021, CKSource - Frederico Knabben. All rights reserved.
+ * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 

package/src/ui/colorinputview.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2021, CKSource - Frederico Knabben. All rights reserved.
+ * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 

package/src/ui/formrowview.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2021, CKSource - Frederico Knabben. All rights reserved.
+ * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 

package/src/ui/inserttableview.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2021, CKSource - Frederico Knabben. All rights reserved.
+ * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 

package/src/utils/common.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2021, CKSource - Frederico Knabben. All rights reserved.
+ * @license Copyright (c) 2003-2022, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */