@ckeditor/ckeditor5-table 36.0.1 → 37.0.0-alpha.1

package/ckeditor5-metadata.json

@@ -4,7 +4,7 @@
 			"name": "Table",
 			"className": "Table",
 			"description": "Adds table creation and editing tools that help content authors bring tabular data into their documents.",
-			"docs": "features/table.html",
+			"docs": "features/tables/tables.html",
 			"path": "src/table.js",
 			"uiComponents": [
 				{
@@ -66,7 +66,7 @@
 			"name": "Table cell properties",
 			"className": "TableCellProperties",
 			"description": "Adds the ability to style individual table cells.",
-			"docs": "features/table.html#table-and-cell-styling-tools",
+			"docs": "features/tables/tables-styling.html",
 			"path": "src/tablecellproperties",
 			"requires": [
 				"Table",
@@ -105,7 +105,7 @@
 			"name": "Table properties",
 			"className": "TableProperties",
 			"description": "Adds the ability to style entire tables.",
-			"docs": "features/table.html#table-and-cell-styling-tools",
+			"docs": "features/tables/tables-styling.html",
 			"path": "src/tableproperties",
 			"requires": [
 				"Table",
@@ -144,7 +144,7 @@
 			"name": "Table toolbar",
 			"className": "TableToolbar",
 			"description": "Creates configurable toolbars for both the table feature and table content. They show up when the table widget or the content inside a table cell are selected.",
-			"docs": "features/table.html#toolbars",
+			"docs": "features/tables/tables.html#toolbars",
 			"path": "src/tabletoolbar.js",
 			"requires": [
 				"Table"
@@ -158,7 +158,7 @@
 			"name": "Table caption",
 			"className": "TableCaption",
 			"description": "Adds support for table captions, which inform the reader about the content of the table. Using captions is also beneficial from the accessibility point of view.",
-			"docs": "features/table.html#table-caption",
+			"docs": "features/tables/tables-caption.html",
 			"path": "src/tablecaption.js",
 			"requires": [
 				"Table"
@@ -174,7 +174,7 @@
 			"name": "Table column resize",
 			"className": "TableColumnResize",
 			"description": "Adds support for table column resize, which allows to set the width of each column in a table using a resize handle.",
-			"docs": "features/table.html#table-column-resize",
+			"docs": "features/tables/tables-resize.html",
 			"path": "src/tablecolumnresize.js",
 			"requires": [
 				"Table"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-table",
-  "version": "36.0.1",
+  "version": "37.0.0-alpha.1",
   "description": "Table feature for CKEditor 5.",
   "keywords": [
     "ckeditor",
@@ -12,35 +12,36 @@
   ],
   "main": "src/index.js",
   "dependencies": {
-    "ckeditor5": "^36.0.1",
+    "ckeditor5": "^37.0.0-alpha.1",
     "lodash-es": "^4.17.15"
   },
   "devDependencies": {
-    "@ckeditor/ckeditor5-alignment": "^36.0.1",
-    "@ckeditor/ckeditor5-basic-styles": "^36.0.1",
-    "@ckeditor/ckeditor5-block-quote": "^36.0.1",
-    "@ckeditor/ckeditor5-clipboard": "^36.0.1",
-    "@ckeditor/ckeditor5-core": "^36.0.1",
-    "@ckeditor/ckeditor5-dev-utils": "^32.0.0",
-    "@ckeditor/ckeditor5-editor-classic": "^36.0.1",
-    "@ckeditor/ckeditor5-engine": "^36.0.1",
-    "@ckeditor/ckeditor5-highlight": "^36.0.1",
-    "@ckeditor/ckeditor5-horizontal-line": "^36.0.1",
-    "@ckeditor/ckeditor5-html-support": "^36.0.1",
-    "@ckeditor/ckeditor5-image": "^36.0.1",
-    "@ckeditor/ckeditor5-indent": "^36.0.1",
-    "@ckeditor/ckeditor5-link": "^36.0.1",
-    "@ckeditor/ckeditor5-list": "^36.0.1",
-    "@ckeditor/ckeditor5-media-embed": "^36.0.1",
-    "@ckeditor/ckeditor5-paragraph": "^36.0.1",
-    "@ckeditor/ckeditor5-theme-lark": "^36.0.1",
-    "@ckeditor/ckeditor5-typing": "^36.0.1",
-    "@ckeditor/ckeditor5-ui": "^36.0.1",
-    "@ckeditor/ckeditor5-undo": "^36.0.1",
-    "@ckeditor/ckeditor5-utils": "^36.0.1",
-    "@ckeditor/ckeditor5-widget": "^36.0.1",
-    "@ckeditor/ckeditor5-source-editing": "^36.0.1",
+    "@ckeditor/ckeditor5-alignment": "^37.0.0-alpha.1",
+    "@ckeditor/ckeditor5-basic-styles": "^37.0.0-alpha.1",
+    "@ckeditor/ckeditor5-block-quote": "^37.0.0-alpha.1",
+    "@ckeditor/ckeditor5-clipboard": "^37.0.0-alpha.1",
+    "@ckeditor/ckeditor5-core": "^37.0.0-alpha.1",
+    "@ckeditor/ckeditor5-dev-utils": "^35.0.0",
+    "@ckeditor/ckeditor5-editor-classic": "^37.0.0-alpha.1",
+    "@ckeditor/ckeditor5-engine": "^37.0.0-alpha.1",
+    "@ckeditor/ckeditor5-highlight": "^37.0.0-alpha.1",
+    "@ckeditor/ckeditor5-horizontal-line": "^37.0.0-alpha.1",
+    "@ckeditor/ckeditor5-html-support": "^37.0.0-alpha.1",
+    "@ckeditor/ckeditor5-image": "^37.0.0-alpha.1",
+    "@ckeditor/ckeditor5-indent": "^37.0.0-alpha.1",
+    "@ckeditor/ckeditor5-link": "^37.0.0-alpha.1",
+    "@ckeditor/ckeditor5-list": "^37.0.0-alpha.1",
+    "@ckeditor/ckeditor5-media-embed": "^37.0.0-alpha.1",
+    "@ckeditor/ckeditor5-paragraph": "^37.0.0-alpha.1",
+    "@ckeditor/ckeditor5-theme-lark": "^37.0.0-alpha.1",
+    "@ckeditor/ckeditor5-typing": "^37.0.0-alpha.1",
+    "@ckeditor/ckeditor5-ui": "^37.0.0-alpha.1",
+    "@ckeditor/ckeditor5-undo": "^37.0.0-alpha.1",
+    "@ckeditor/ckeditor5-utils": "^37.0.0-alpha.1",
+    "@ckeditor/ckeditor5-widget": "^37.0.0-alpha.1",
+    "@ckeditor/ckeditor5-source-editing": "^37.0.0-alpha.1",
     "json-diff": "^0.5.4",
+    "typescript": "^4.8.4",
     "webpack": "^5.58.1",
     "webpack-cli": "^4.9.0"
   },
@@ -59,13 +60,17 @@
   },
   "files": [
     "lang",
-    "src",
+    "src/**/*.js",
+    "src/**/*.d.ts",
     "theme",
     "build",
     "ckeditor5-metadata.json",
     "CHANGELOG.md"
   ],
   "scripts": {
-    "dll:build": "webpack"
-  }
+    "dll:build": "webpack",
+    "build": "tsc -p ./tsconfig.json",
+    "postversion": "npm run build"
+  },
+  "types": "src/index.d.ts"
 }

package/src/augmentation.d.ts

@@ -0,0 +1,76 @@
+/**
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+import type { TableConfig, Table, TableCaption, TableCaptionEditing, TableCaptionUI, TableCellProperties, TableCellPropertiesEditing, TableCellPropertiesUI, TableCellWidthEditing, TableClipboard, TableColumnResize, TableColumnResizeEditing, TableEditing, TableKeyboard, TableMouse, TableProperties, TablePropertiesEditing, TablePropertiesUI, TableSelection, TableToolbar, TableUI, TableUtils, PlainTableOutput, InsertColumnCommand, InsertRowCommand, InsertTableCommand, MergeCellCommand, MergeCellsCommand, RemoveColumnCommand, RemoveRowCommand, SelectColumnCommand, SelectRowCommand, SetHeaderColumnCommand, SetHeaderRowCommand, SplitCellCommand, ToggleTableCaptionCommand, TableCellBackgroundColorCommand, TableCellBorderColorCommand, TableCellBorderStyleCommand, TableCellBorderWidthCommand, TableCellHeightCommand, TableCellHorizontalAlignmentCommand, TableCellPaddingCommand, TableCellVerticalAlignmentCommand, TableCellWidthCommand, TableAlignmentCommand, TableBackgroundColorCommand, TableBorderColorCommand, TableBorderStyleCommand, TableBorderWidthCommand, TableHeightCommand, TableWidthCommand } from './index';
+declare module '@ckeditor/ckeditor5-core' {
+    interface EditorConfig {
+        /**
+         * The configuration of the {@link module:table/table~Table} feature.
+         *
+         * Read more in {@link module:table/tableconfig~TableConfig}.
+         */
+        table?: TableConfig;
+    }
+    interface PluginsMap {
+        [Table.pluginName]: Table;
+        [TableCaption.pluginName]: TableCaption;
+        [TableCaptionEditing.pluginName]: TableCaptionEditing;
+        [TableCaptionUI.pluginName]: TableCaptionUI;
+        [TableCellProperties.pluginName]: TableCellProperties;
+        [TableCellPropertiesEditing.pluginName]: TableCellPropertiesEditing;
+        [TableCellPropertiesUI.pluginName]: TableCellPropertiesUI;
+        [TableCellWidthEditing.pluginName]: TableCellWidthEditing;
+        [TableClipboard.pluginName]: TableClipboard;
+        [TableColumnResize.pluginName]: TableColumnResize;
+        [TableColumnResizeEditing.pluginName]: TableColumnResizeEditing;
+        [TableEditing.pluginName]: TableEditing;
+        [TableKeyboard.pluginName]: TableKeyboard;
+        [TableMouse.pluginName]: TableMouse;
+        [TableProperties.pluginName]: TableProperties;
+        [TablePropertiesEditing.pluginName]: TablePropertiesEditing;
+        [TablePropertiesUI.pluginName]: TablePropertiesUI;
+        [TableSelection.pluginName]: TableSelection;
+        [TableToolbar.pluginName]: TableToolbar;
+        [TableUI.pluginName]: TableUI;
+        [TableUtils.pluginName]: TableUtils;
+        [PlainTableOutput.pluginName]: PlainTableOutput;
+    }
+    interface CommandsMap {
+        insertTableColumnLeft: InsertColumnCommand;
+        insertTableColumnRight: InsertColumnCommand;
+        insertTableRowAbove: InsertRowCommand;
+        insertTableRowBelow: InsertRowCommand;
+        insertTable: InsertTableCommand;
+        mergeTableCellRight: MergeCellCommand;
+        mergeTableCellLeft: MergeCellCommand;
+        mergeTableCellDown: MergeCellCommand;
+        mergeTableCellUp: MergeCellCommand;
+        mergeTableCells: MergeCellsCommand;
+        removeTableColumn: RemoveColumnCommand;
+        removeTableRow: RemoveRowCommand;
+        selectTableColumn: SelectColumnCommand;
+        selectTableRow: SelectRowCommand;
+        setTableColumnHeader: SetHeaderColumnCommand;
+        setTableRowHeader: SetHeaderRowCommand;
+        splitTableCellVertically: SplitCellCommand;
+        splitTableCellHorizontally: SplitCellCommand;
+        toggleTableCaption: ToggleTableCaptionCommand;
+        tableCellBackgroundColor: TableCellBackgroundColorCommand;
+        tableCellBorderColor: TableCellBorderColorCommand;
+        tableCellBorderStyle: TableCellBorderStyleCommand;
+        tableCellBorderWidth: TableCellBorderWidthCommand;
+        tableCellHeight: TableCellHeightCommand;
+        tableCellHorizontalAlignment: TableCellHorizontalAlignmentCommand;
+        tableCellPadding: TableCellPaddingCommand;
+        tableCellVerticalAlignment: TableCellVerticalAlignmentCommand;
+        tableCellWidth: TableCellWidthCommand;
+        tableAlignment: TableAlignmentCommand;
+        tableBackgroundColor: TableBackgroundColorCommand;
+        tableBorderColor: TableBorderColorCommand;
+        tableBorderStyle: TableBorderStyleCommand;
+        tableBorderWidth: TableBorderWidthCommand;
+        tableHeight: TableHeightCommand;
+        tableWidth: TableWidthCommand;
+    }
+}

package/src/augmentation.js

@@ -0,0 +1,5 @@
+/**
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+export {};

package/src/commands/insertcolumncommand.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module table/commands/insertcolumncommand
+ */
+import { Command, type Editor } from 'ckeditor5/src/core';
+/**
+ * The insert column command.
+ *
+ * The command is registered by {@link module:table/tableediting~TableEditing} as the `'insertTableColumnLeft'` and
+ * `'insertTableColumnRight'` editor commands.
+ *
+ * To insert a column to the left of the selected cell, execute the following command:
+ *
+ * ```ts
+ * editor.execute( 'insertTableColumnLeft' );
+ * ```
+ *
+ * To insert a column to the right of the selected cell, execute the following command:
+ *
+ * ```ts
+ * editor.execute( 'insertTableColumnRight' );
+ * ```
+ */
+export default class InsertColumnCommand extends Command {
+    /**
+     * The order of insertion relative to the column in which the caret is located.
+     */
+    readonly order: 'left' | 'right';
+    /**
+     * Creates a new `InsertColumnCommand` instance.
+     *
+     * @param editor An editor on which this command will be used.
+     * @param options.order The order of insertion relative to the column in which the caret is located.
+     * Possible values: `"left"` and `"right"`. Default value is "right".
+     */
+    constructor(editor: Editor, options?: {
+        order?: 'left' | 'right';
+    });
+    /**
+     * @inheritDoc
+     */
+    refresh(): void;
+    /**
+     * Executes the command.
+     *
+     * Depending on the command's {@link #order} value, it inserts a column to the `'left'` or `'right'` of the column
+     * in which the selection is set.
+     *
+     * @fires execute
+     */
+    execute(): void;
+}

package/src/commands/insertcolumncommand.js

@@ -2,13 +2,10 @@
  * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
-
 /**
  * @module table/commands/insertcolumncommand
  */
-
 import { Command } from 'ckeditor5/src/core';
-
 /**
  * The insert column command.
  *
@@ -17,66 +14,54 @@ import { Command } from 'ckeditor5/src/core';
  *
  * To insert a column to the left of the selected cell, execute the following command:
  *
- *		editor.execute( 'insertTableColumnLeft' );
+ * ```ts
+ * editor.execute( 'insertTableColumnLeft' );
+ * ```
  *
  * To insert a column to the right of the selected cell, execute the following command:
  *
- *		editor.execute( 'insertTableColumnRight' );
- *
- * @extends module:core/command~Command
+ * ```ts
+ * editor.execute( 'insertTableColumnRight' );
+ * ```
  */
 export default class InsertColumnCommand extends Command {
-	/**
-	 * Creates a new `InsertColumnCommand` instance.
-	 *
-	 * @param {module:core/editor/editor~Editor} editor An editor on which this command will be used.
-	 * @param {Object} options
-	 * @param {String} [options.order="right"] The order of insertion relative to the column in which the caret is located.
-	 * Possible values: `"left"` and `"right"`.
-	 */
-	constructor( editor, options = {} ) {
-		super( editor );
-
-		/**
-		 * The order of insertion relative to the column in which the caret is located.
-		 *
-		 * @readonly
-		 * @member {String} module:table/commands/insertcolumncommand~InsertColumnCommand#order
-		 */
-		this.order = options.order || 'right';
-	}
-
-	/**
-	 * @inheritDoc
-	 */
-	refresh() {
-		const selection = this.editor.model.document.selection;
-		const tableUtils = this.editor.plugins.get( 'TableUtils' );
-		const isAnyCellSelected = !!tableUtils.getSelectionAffectedTableCells( selection ).length;
-
-		this.isEnabled = isAnyCellSelected;
-	}
-
-	/**
-	 * Executes the command.
-	 *
-	 * Depending on the command's {@link #order} value, it inserts a column to the `'left'` or `'right'` of the column
-	 * in which the selection is set.
-	 *
-	 * @fires execute
-	 */
-	execute() {
-		const editor = this.editor;
-		const selection = editor.model.document.selection;
-		const tableUtils = editor.plugins.get( 'TableUtils' );
-		const insertBefore = this.order === 'left';
-
-		const affectedTableCells = tableUtils.getSelectionAffectedTableCells( selection );
-		const columnIndexes = tableUtils.getColumnIndexes( affectedTableCells );
-
-		const column = insertBefore ? columnIndexes.first : columnIndexes.last;
-		const table = affectedTableCells[ 0 ].findAncestor( 'table' );
-
-		tableUtils.insertColumns( table, { columns: 1, at: insertBefore ? column : column + 1 } );
-	}
+    /**
+     * Creates a new `InsertColumnCommand` instance.
+     *
+     * @param editor An editor on which this command will be used.
+     * @param options.order The order of insertion relative to the column in which the caret is located.
+     * Possible values: `"left"` and `"right"`. Default value is "right".
+     */
+    constructor(editor, options = {}) {
+        super(editor);
+        this.order = options.order || 'right';
+    }
+    /**
+     * @inheritDoc
+     */
+    refresh() {
+        const selection = this.editor.model.document.selection;
+        const tableUtils = this.editor.plugins.get('TableUtils');
+        const isAnyCellSelected = !!tableUtils.getSelectionAffectedTableCells(selection).length;
+        this.isEnabled = isAnyCellSelected;
+    }
+    /**
+     * Executes the command.
+     *
+     * Depending on the command's {@link #order} value, it inserts a column to the `'left'` or `'right'` of the column
+     * in which the selection is set.
+     *
+     * @fires execute
+     */
+    execute() {
+        const editor = this.editor;
+        const selection = editor.model.document.selection;
+        const tableUtils = editor.plugins.get('TableUtils');
+        const insertBefore = this.order === 'left';
+        const affectedTableCells = tableUtils.getSelectionAffectedTableCells(selection);
+        const columnIndexes = tableUtils.getColumnIndexes(affectedTableCells);
+        const column = insertBefore ? columnIndexes.first : columnIndexes.last;
+        const table = affectedTableCells[0].findAncestor('table');
+        tableUtils.insertColumns(table, { columns: 1, at: insertBefore ? column : column + 1 });
+    }
 }

package/src/commands/insertrowcommand.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module table/commands/insertrowcommand
+ */
+import { Command, type Editor } from 'ckeditor5/src/core';
+/**
+ * The insert row command.
+ *
+ * The command is registered by {@link module:table/tableediting~TableEditing} as the `'insertTableRowBelow'` and
+ * `'insertTableRowAbove'` editor commands.
+ *
+ * To insert a row below the selected cell, execute the following command:
+ *
+ * ```ts
+ * editor.execute( 'insertTableRowBelow' );
+ * ```
+ *
+ * To insert a row above the selected cell, execute the following command:
+ *
+ * ```ts
+ * editor.execute( 'insertTableRowAbove' );
+ * ```
+ */
+export default class InsertRowCommand extends Command {
+    /**
+     * The order of insertion relative to the row in which the caret is located.
+     */
+    readonly order: 'above' | 'below';
+    /**
+     * Creates a new `InsertRowCommand` instance.
+     *
+     * @param editor The editor on which this command will be used.
+     * @param options.order The order of insertion relative to the row in which the caret is located.
+     * Possible values: `"above"` and `"below"`. Default value is "below"
+     */
+    constructor(editor: Editor, options?: {
+        order?: 'above' | 'below';
+    });
+    /**
+     * @inheritDoc
+     */
+    refresh(): void;
+    /**
+     * Executes the command.
+     *
+     * Depending on the command's {@link #order} value, it inserts a row `'below'` or `'above'` the row in which selection is set.
+     *
+     * @fires execute
+     */
+    execute(): void;
+}

package/src/commands/insertrowcommand.js

@@ -2,13 +2,10 @@
  * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
-
 /**
  * @module table/commands/insertrowcommand
  */
-
 import { Command } from 'ckeditor5/src/core';
-
 /**
  * The insert row command.
  *
@@ -17,65 +14,53 @@ import { Command } from 'ckeditor5/src/core';
  *
  * To insert a row below the selected cell, execute the following command:
  *
- *		editor.execute( 'insertTableRowBelow' );
+ * ```ts
+ * editor.execute( 'insertTableRowBelow' );
+ * ```
  *
  * To insert a row above the selected cell, execute the following command:
  *
- *		editor.execute( 'insertTableRowAbove' );
- *
- * @extends module:core/command~Command
+ * ```ts
+ * editor.execute( 'insertTableRowAbove' );
+ * ```
  */
 export default class InsertRowCommand extends Command {
-	/**
-	 * Creates a new `InsertRowCommand` instance.
-	 *
-	 * @param {module:core/editor/editor~Editor} editor The editor on which this command will be used.
-	 * @param {Object} options
-	 * @param {String} [options.order="below"] The order of insertion relative to the row in which the caret is located.
-	 * Possible values: `"above"` and `"below"`.
-	 */
-	constructor( editor, options = {} ) {
-		super( editor );
-
-		/**
-		 * The order of insertion relative to the row in which the caret is located.
-		 *
-		 * @readonly
-		 * @member {String} module:table/commands/insertrowcommand~InsertRowCommand#order
-		 */
-		this.order = options.order || 'below';
-	}
-
-	/**
-	 * @inheritDoc
-	 */
-	refresh() {
-		const selection = this.editor.model.document.selection;
-		const tableUtils = this.editor.plugins.get( 'TableUtils' );
-		const isAnyCellSelected = !!tableUtils.getSelectionAffectedTableCells( selection ).length;
-
-		this.isEnabled = isAnyCellSelected;
-	}
-
-	/**
-	 * Executes the command.
-	 *
-	 * Depending on the command's {@link #order} value, it inserts a row `'below'` or `'above'` the row in which selection is set.
-	 *
-	 * @fires execute
-	 */
-	execute() {
-		const editor = this.editor;
-		const selection = editor.model.document.selection;
-		const tableUtils = editor.plugins.get( 'TableUtils' );
-		const insertAbove = this.order === 'above';
-
-		const affectedTableCells = tableUtils.getSelectionAffectedTableCells( selection );
-		const rowIndexes = tableUtils.getRowIndexes( affectedTableCells );
-
-		const row = insertAbove ? rowIndexes.first : rowIndexes.last;
-		const table = affectedTableCells[ 0 ].findAncestor( 'table' );
-
-		tableUtils.insertRows( table, { at: insertAbove ? row : row + 1, copyStructureFromAbove: !insertAbove } );
-	}
+    /**
+     * Creates a new `InsertRowCommand` instance.
+     *
+     * @param editor The editor on which this command will be used.
+     * @param options.order The order of insertion relative to the row in which the caret is located.
+     * Possible values: `"above"` and `"below"`. Default value is "below"
+     */
+    constructor(editor, options = {}) {
+        super(editor);
+        this.order = options.order || 'below';
+    }
+    /**
+     * @inheritDoc
+     */
+    refresh() {
+        const selection = this.editor.model.document.selection;
+        const tableUtils = this.editor.plugins.get('TableUtils');
+        const isAnyCellSelected = !!tableUtils.getSelectionAffectedTableCells(selection).length;
+        this.isEnabled = isAnyCellSelected;
+    }
+    /**
+     * Executes the command.
+     *
+     * Depending on the command's {@link #order} value, it inserts a row `'below'` or `'above'` the row in which selection is set.
+     *
+     * @fires execute
+     */
+    execute() {
+        const editor = this.editor;
+        const selection = editor.model.document.selection;
+        const tableUtils = editor.plugins.get('TableUtils');
+        const insertAbove = this.order === 'above';
+        const affectedTableCells = tableUtils.getSelectionAffectedTableCells(selection);
+        const rowIndexes = tableUtils.getRowIndexes(affectedTableCells);
+        const row = insertAbove ? rowIndexes.first : rowIndexes.last;
+        const table = affectedTableCells[0].findAncestor('table');
+        tableUtils.insertRows(table, { at: insertAbove ? row : row + 1, copyStructureFromAbove: !insertAbove });
+    }
 }

package/src/commands/inserttablecommand.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module table/commands/inserttablecommand
+ */
+import { Command } from 'ckeditor5/src/core';
+/**
+ * The insert table command.
+ *
+ * The command is registered by {@link module:table/tableediting~TableEditing} as the `'insertTable'` editor command.
+ *
+ * To insert a table at the current selection, execute the command and specify the dimensions:
+ *
+ * ```ts
+ * editor.execute( 'insertTable', { rows: 20, columns: 5 } );
+ * ```
+ */
+export default class InsertTableCommand extends Command {
+    /**
+     * @inheritDoc
+     */
+    refresh(): void;
+    /**
+     * Executes the command.
+     *
+     * Inserts a table with the given number of rows and columns into the editor.
+     *
+     * @param options.rows The number of rows to create in the inserted table. Default value is 2.
+     * @param options.columns The number of columns to create in the inserted table. Default value is 2.
+     * @param options.headingRows The number of heading rows. If not provided it will default to
+     * {@link module:table/tableconfig~TableConfig#defaultHeadings `config.table.defaultHeadings.rows`} table config.
+     * @param options.headingColumns The number of heading columns. If not provided it will default to
+     * {@link module:table/tableconfig~TableConfig#defaultHeadings `config.table.defaultHeadings.columns`} table config.
+     * @fires execute
+     */
+    execute(options?: {
+        rows?: number;
+        columns?: number;
+        headingRows?: number;
+        headingColumns?: number;
+    }): void;
+}