@ckeditor/ckeditor5-table 47.3.0 → 47.4.0-alpha.0

package/src/tableproperties/ui/tablepropertiesview.d.ts

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

package/src/tableproperties/ui/tablepropertiesview.js

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

package/src/tableproperties/ui/tablepropertiesviewexperimental.d.ts

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

package/src/tableproperties/ui/tablepropertiesviewexperimental.js

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

package/src/tableproperties.d.ts

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

package/src/tableproperties.js

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

package/src/tableselection.d.ts

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

package/src/tableselection.js

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

package/src/tabletoolbar.d.ts

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

package/src/tabletoolbar.js

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

package/src/tableui.d.ts

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

package/src/tableui.js

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

package/src/tableutils.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
 import { Plugin } from 'ckeditor5/src/core.js';
@@ -350,6 +350,44 @@ export declare class TableUtils extends Plugin {
      * {@link #getTableCellsContainingSelection}.
      */
     getSelectedTableCells(selection: ModelSelection | ModelDocumentSelection): Array<ModelElement>;
+    /**
+     * Sets the number of heading rows for the given `table`.
+     *
+     * @param writer The model writer.
+     * @param table The table model element.
+     * @param headingRows The number of heading rows to set.
+     * @param options Additional options.
+     * @param options.shallow If set to `true` it will only update the `headingRows` attribute
+     * without updating the cell types in the table. Default is `false`.
+     * @param options.resetFormerHeadingCells If set to `true`, it will check if the rows that are no longer in the heading section
+     * should be updated to body cells. Default is `true`.
+     * @param options.autoExpand If set to `true`, it will check if the following rows look like a header and expand the heading section.
+     * Default is `true`.
+     */
+    setHeadingRowsCount(writer: ModelWriter, table: ModelElement, headingRows: number, options?: {
+        shallow?: boolean;
+        resetFormerHeadingCells?: boolean;
+        autoExpand?: boolean;
+    }): void;
+    /**
+     * Sets the number of heading columns for the given `table`.
+     *
+     * @param writer The model writer to use.
+     * @param table The table model element.
+     * @param headingColumns The number of heading columns to set.
+     * @param options Additional options.
+     * @param options.shallow If set to `true` it will only update the `headingColumns` attribute
+     * without updating the cell types in the table. Default is `false`.
+     * @param options.resetFormerHeadingCells If set to `true`, it will check if the columns that are no longer in the heading section
+     * should be updated to body cells. Default is `true`.
+     * @param options.autoExpand If set to `true`, it will check if the following columns look like a header and expand the heading section.
+     * Default is `true`.
+     */
+    setHeadingColumnsCount(writer: ModelWriter, table: ModelElement, headingColumns: number, options?: {
+        shallow?: boolean;
+        resetFormerHeadingCells?: boolean;
+        autoExpand?: boolean;
+    }): void;
     /**
      * Returns all model table cells that the provided model selection's ranges
      * {@link module:engine/model/range~ModelRange#start} inside.

package/src/tableutils.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
 /**
@@ -8,7 +8,7 @@
 import { CKEditorError } from 'ckeditor5/src/utils.js';
 import { Plugin } from 'ckeditor5/src/core.js';
 import { TableWalker } from './tablewalker.js';
-import { createEmptyTableCell, updateNumericAttribute } from './utils/common.js';
+import { createEmptyTableCell, updateNumericAttribute, isEntireCellsLineHeader, isTableCellTypeEnabled } from './utils/common.js';
 import { removeEmptyColumns, removeEmptyRows } from './utils/structure.js';
 import { getTableColumnElements } from './tablecolumnresize/utils.js';
 /**
@@ -103,10 +103,10 @@ export class TableUtils extends Plugin {
         const columns = options.columns || 2;
         createEmptyRows(writer, table, 0, rows, columns);
         if (options.headingRows) {
-            updateNumericAttribute('headingRows', Math.min(options.headingRows, rows), table, writer, 0);
+            this.setHeadingRowsCount(writer, table, Math.min(options.headingRows, rows));
         }
         if (options.headingColumns) {
-            updateNumericAttribute('headingColumns', Math.min(options.headingColumns, columns), table, writer, 0);
+            this.setHeadingColumnsCount(writer, table, Math.min(options.headingColumns, columns));
         }
         return table;
     }
@@ -144,6 +144,7 @@ export class TableUtils extends Plugin {
         const rowsToInsert = options.rows || 1;
         const isCopyStructure = options.copyStructureFromAbove !== undefined;
         const copyStructureFrom = options.copyStructureFromAbove ? insertAt - 1 : insertAt;
+        const cellTypeEnabled = isTableCellTypeEnabled(this.editor);
         const rows = this.getRows(table);
         const columns = this.getColumns(table);
         if (insertAt > rows) {
@@ -155,14 +156,29 @@ export class TableUtils extends Plugin {
             throw new CKEditorError('tableutils-insertrows-insert-out-of-range', this, { options });
         }
         model.change(writer => {
-            const headingRows = table.getAttribute('headingRows') || 0;
+            let headingRows = table.getAttribute('headingRows') || 0;
+            const headingColumns = table.getAttribute('headingColumns') || 0;
             // Inserting rows inside heading section requires to update `headingRows` attribute as the heading section will grow.
             if (headingRows > insertAt) {
-                updateNumericAttribute('headingRows', headingRows + rowsToInsert, table, writer, 0);
+                headingRows += rowsToInsert;
+                this.setHeadingRowsCount(writer, table, headingRows, {
+                    shallow: true
+                });
             }
             // Inserting at the end or at the beginning of a table doesn't require to calculate anything special.
             if (!isCopyStructure && (insertAt === 0 || insertAt === rows)) {
-                createEmptyRows(writer, table, insertAt, rowsToInsert, columns);
+                const rows = createEmptyRows(writer, table, insertAt, rowsToInsert, columns);
+                if (cellTypeEnabled) {
+                    for (let rowOffset = 0; rowOffset < rows.length; rowOffset++) {
+                        const row = rows[rowOffset];
+                        for (let columnIndex = 0; columnIndex < columns; columnIndex++) {
+                            const cell = row[columnIndex];
+                            if (insertAt + rowOffset < headingRows || columnIndex < headingColumns) {
+                                writer.setAttribute('tableCellType', 'header', cell);
+                            }
+                        }
+                    }
+                }
                 return;
             }
             // Iterate over all the rows above the inserted rows in order to check for the row-spanned cells.
@@ -194,7 +210,11 @@ export class TableUtils extends Plugin {
                     const insertPosition = writer.createPositionAt(tableRow, 'end');
                     // Insert the empty cell only if this slot is not row-spanned from any other cell.
                     if (colspan > 0) {
-                        createEmptyTableCell(writer, insertPosition, colspan > 1 ? { colspan } : undefined);
+                        const insertedCells = createEmptyTableCell(writer, insertPosition, colspan > 1 ? { colspan } : undefined);
+                        // If we insert row in heading section, set proper cell type.
+                        if (cellTypeEnabled && (insertAt + rowIndex < headingRows || cellIndex < headingColumns)) {
+                            writer.setAttribute('tableCellType', 'header', insertedCells);
+                        }
                     }
                     // Skip the col-spanned slots, there won't be any cells.
                     cellIndex += Math.abs(colspan) - 1;
@@ -233,21 +253,36 @@ export class TableUtils extends Plugin {
         const model = this.editor.model;
         const insertAt = options.at || 0;
         const columnsToInsert = options.columns || 1;
+        const cellTypeEnabled = isTableCellTypeEnabled(this.editor);
         model.change(writer => {
-            const headingColumns = table.getAttribute('headingColumns');
+            const headingRows = table.getAttribute('headingRows') || 0;
+            let headingColumns = table.getAttribute('headingColumns');
             // Inserting columns inside heading section requires to update `headingColumns` attribute as the heading section will grow.
             if (insertAt < headingColumns) {
-                writer.setAttribute('headingColumns', headingColumns + columnsToInsert, table);
+                headingColumns += columnsToInsert;
+                this.setHeadingColumnsCount(writer, table, headingColumns, {
+                    shallow: true
+                });
             }
             const tableColumns = this.getColumns(table);
             // Inserting at the end and at the beginning of a table doesn't require to calculate anything special.
             if (insertAt === 0 || tableColumns === insertAt) {
+                let rowIndex = 0;
                 for (const tableRow of table.getChildren()) {
                     // Ignore non-row elements inside the table (e.g. caption).
                     if (!tableRow.is('element', 'tableRow')) {
                         continue;
                     }
-                    createCells(columnsToInsert, writer, writer.createPositionAt(tableRow, insertAt ? 'end' : 0));
+                    const insertedCells = createCells(columnsToInsert, writer, writer.createPositionAt(tableRow, insertAt ? 'end' : 0));
+                    if (cellTypeEnabled) {
+                        // If we insert column in heading section, set proper cell type.
+                        for (let columnOffset = 0; columnOffset < insertedCells.length; columnOffset++) {
+                            if (insertAt + columnOffset < headingColumns || rowIndex < headingRows) {
+                                writer.setAttribute('tableCellType', 'header', insertedCells[columnOffset]);
+                            }
+                        }
+                    }
+                    rowIndex++;
                 }
                 return;
             }
@@ -271,7 +306,15 @@ export class TableUtils extends Plugin {
                 else {
                     // It's either cell at this column index or spanned cell by a row-spanned cell from row above.
                     // In table above it's cell "e" and a spanned position from row below (empty cell between cells "g" and "h")
-                    createCells(columnsToInsert, writer, tableSlot.getPositionBefore());
+                    const insertedCells = createCells(columnsToInsert, writer, tableSlot.getPositionBefore());
+                    // If we insert column in heading section, set proper cell type.
+                    if (cellTypeEnabled) {
+                        for (let columnOffset = 0; columnOffset < insertedCells.length; columnOffset++) {
+                            if (insertAt + columnOffset < headingColumns || row < headingRows) {
+                                writer.setAttribute('tableCellType', 'header', insertedCells[columnOffset]);
+                            }
+                        }
+                    }
                 }
             }
         });
@@ -347,6 +390,15 @@ export class TableUtils extends Plugin {
                 // because of cleaning empty rows and we only removed one of them.
                 removeEmptyRows(table, this);
             }
+            // 3. If next rows are entirely header, adjust heading rows count.
+            if (isTableCellTypeEnabled(this.editor)) {
+                let headingRows = table.getAttribute('headingRows') || 0;
+                const totalRows = this.getRows(table);
+                while (headingRows < totalRows && isEntireCellsLineHeader({ table, row: headingRows })) {
+                    headingRows++;
+                }
+                this.setHeadingRowsCount(writer, table, headingRows, { shallow: true });
+            }
         });
     }
     /**
@@ -416,6 +468,15 @@ export class TableUtils extends Plugin {
                 // because of cleaning empty columns and we only removed one of them.
                 removeEmptyColumns(table, this);
             }
+            // If next columns are entirely header, adjust heading columns count.
+            if (isTableCellTypeEnabled(this.editor)) {
+                let headingColumns = table.getAttribute('headingColumns') || 0;
+                const totalColumns = this.getColumns(table);
+                while (headingColumns < totalColumns && isEntireCellsLineHeader({ table, column: headingColumns })) {
+                    headingColumns++;
+                }
+                this.setHeadingColumnsCount(writer, table, headingColumns, { shallow: true });
+            }
         });
     }
     /**
@@ -728,6 +789,130 @@ export class TableUtils extends Plugin {
         }
         return cells;
     }
+    /**
+     * Sets the number of heading rows for the given `table`.
+     *
+     * @param writer The model writer.
+     * @param table The table model element.
+     * @param headingRows The number of heading rows to set.
+     * @param options Additional options.
+     * @param options.shallow If set to `true` it will only update the `headingRows` attribute
+     * without updating the cell types in the table. Default is `false`.
+     * @param options.resetFormerHeadingCells If set to `true`, it will check if the rows that are no longer in the heading section
+     * should be updated to body cells. Default is `true`.
+     * @param options.autoExpand If set to `true`, it will check if the following rows look like a header and expand the heading section.
+     * Default is `true`.
+     */
+    setHeadingRowsCount(writer, table, headingRows, options = {}) {
+        const { shallow, resetFormerHeadingCells = true, autoExpand = true } = options;
+        const oldHeadingRows = table.getAttribute('headingRows') || 0;
+        if (headingRows === oldHeadingRows) {
+            return;
+        }
+        updateNumericAttribute('headingRows', headingRows, table, writer, 0);
+        if (shallow || !isTableCellTypeEnabled(this.editor)) {
+            return;
+        }
+        // Set header type to all cells in new heading rows.
+        for (const { cell, row, column } of new TableWalker(table, { endRow: headingRows - 1 })) {
+            updateTableCellType({
+                table,
+                writer,
+                cell,
+                row,
+                column
+            });
+        }
+        // If heading rows were reduced, set body type to all cells in rows that are no longer in heading section.
+        if (resetFormerHeadingCells && headingRows < oldHeadingRows) {
+            for (let row = headingRows; row < oldHeadingRows; row++) {
+                // Handle edge case when some cells were already changed to body type manually,
+                // before changing heading rows count.
+                if (!isEntireCellsLineHeader({ table, row })) {
+                    break;
+                }
+                for (const { cell, row: cellRow, column } of new TableWalker(table, { row })) {
+                    updateTableCellType({
+                        table,
+                        writer,
+                        cell,
+                        row: cellRow,
+                        column
+                    });
+                }
+            }
+        }
+        // If following rows looks like header, expand heading rows to cover them.
+        if (autoExpand && headingRows > oldHeadingRows) {
+            const totalRows = this.getRows(table);
+            while (headingRows < totalRows && isEntireCellsLineHeader({ table, row: headingRows })) {
+                headingRows++;
+            }
+            updateNumericAttribute('headingRows', headingRows, table, writer, 0);
+        }
+    }
+    /**
+     * Sets the number of heading columns for the given `table`.
+     *
+     * @param writer The model writer to use.
+     * @param table The table model element.
+     * @param headingColumns The number of heading columns to set.
+     * @param options Additional options.
+     * @param options.shallow If set to `true` it will only update the `headingColumns` attribute
+     * without updating the cell types in the table. Default is `false`.
+     * @param options.resetFormerHeadingCells If set to `true`, it will check if the columns that are no longer in the heading section
+     * should be updated to body cells. Default is `true`.
+     * @param options.autoExpand If set to `true`, it will check if the following columns look like a header and expand the heading section.
+     * Default is `true`.
+     */
+    setHeadingColumnsCount(writer, table, headingColumns, options = {}) {
+        const { shallow, resetFormerHeadingCells = true, autoExpand = true } = options;
+        const oldHeadingColumns = table.getAttribute('headingColumns') || 0;
+        if (headingColumns === oldHeadingColumns) {
+            return;
+        }
+        updateNumericAttribute('headingColumns', headingColumns, table, writer, 0);
+        if (shallow || !isTableCellTypeEnabled(this.editor)) {
+            return;
+        }
+        // Set header type to all cells in new heading columns.
+        for (const { cell, row, column } of new TableWalker(table, { endColumn: headingColumns - 1 })) {
+            updateTableCellType({
+                table,
+                writer,
+                cell,
+                row,
+                column
+            });
+        }
+        // If heading columns were reduced, set body type to all cells in columns that are no longer in heading section.
+        if (resetFormerHeadingCells && headingColumns < oldHeadingColumns) {
+            for (let column = headingColumns; column < oldHeadingColumns; column++) {
+                // Handle edge case when some cells were already changed to body type manually,
+                // before changing heading columns count.
+                if (!isEntireCellsLineHeader({ table, column })) {
+                    break;
+                }
+                for (const { cell, row, column: cellColumn } of new TableWalker(table, { column })) {
+                    updateTableCellType({
+                        table,
+                        writer,
+                        cell,
+                        row,
+                        column: cellColumn
+                    });
+                }
+            }
+        }
+        // If following columns looks like header, expand heading columns to cover them.
+        if (autoExpand && headingColumns > oldHeadingColumns) {
+            const totalColumns = this.getColumns(table);
+            while (headingColumns < totalColumns && isEntireCellsLineHeader({ table, column: headingColumns })) {
+                headingColumns++;
+            }
+            updateNumericAttribute('headingColumns', headingColumns, table, writer, 0);
+        }
+    }
     /**
      * Returns all model table cells that the provided model selection's ranges
      * {@link module:engine/model/range~ModelRange#start} inside.
@@ -913,11 +1098,13 @@ export class TableUtils extends Plugin {
  * @param tableCellToInsert The number of cells to insert in each row.
  */
 function createEmptyRows(writer, table, insertAt, rows, tableCellToInsert, attributes = {}) {
+    const insertedRows = [];
     for (let i = 0; i < rows; i++) {
         const tableRow = writer.createElement('tableRow');
         writer.insert(tableRow, table, insertAt);
-        createCells(tableCellToInsert, writer, writer.createPositionAt(tableRow, 'end'), attributes);
+        insertedRows.push(createCells(tableCellToInsert, writer, writer.createPositionAt(tableRow, 'end'), attributes));
     }
+    return insertedRows;
 }
 /**
  * Creates cells at a given position.
@@ -925,9 +1112,14 @@ function createEmptyRows(writer, table, insertAt, rows, tableCellToInsert, attri
  * @param cells The number of cells to create
  */
 function createCells(cells, writer, insertPosition, attributes = {}) {
+    const createdCells = [];
+    let currentPosition = insertPosition;
     for (let i = 0; i < cells; i++) {
-        createEmptyTableCell(writer, insertPosition, attributes);
+        const cell = createEmptyTableCell(writer, currentPosition, attributes);
+        createdCells.push(cell);
+        currentPosition = writer.createPositionAfter(cell);
     }
+    return createdCells;
 }
 /**
  * Evenly distributes the span of a cell to a number of provided cells.
@@ -1074,3 +1266,17 @@ function getBiggestRectangleArea(rows, columns) {
     const firstColumn = Math.min(...columnIndexes);
     return (lastRow - firstRow + 1) * (lastColumn - firstColumn + 1);
 }
+/**
+ * Updates the `tableCellType` attribute of a table cell based on its position in the table
+ * and the table's `headingRows` and `headingColumns` attributes.
+ */
+function updateTableCellType({ writer, table, row, column, cell }) {
+    const headingRows = table.getAttribute('headingRows') || 0;
+    const headingColumns = table.getAttribute('headingColumns') || 0;
+    if (row >= headingRows && column >= headingColumns) {
+        writer.removeAttribute('tableCellType', cell);
+    }
+    else {
+        writer.setAttribute('tableCellType', 'header', cell);
+    }
+}

package/src/tablewalker.d.ts

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

package/src/tablewalker.js

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

package/src/ui/colorinputview.d.ts

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

package/src/ui/colorinputview.js

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

package/src/ui/inserttableview.d.ts

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

package/src/ui/inserttableview.js

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

package/src/utils/common.d.ts

@@ -1,10 +1,11 @@
 /**
- * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
 /**
  * @module table/utils/common
  */
+import type { Editor } from 'ckeditor5/src/core.js';
 import type { Conversion, ModelElement, ModelItem, ModelPosition, ModelSchema, ModelWriter, ModelDocumentSelection } from 'ckeditor5/src/engine.js';
 import { type TableUtils } from '../tableutils.js';
 /**
@@ -53,3 +54,25 @@ export declare function enableProperty(schema: ModelSchema, conversion: Conversi
  * @internal
  */
 export declare function getSelectionAffectedTable(selection: ModelDocumentSelection): ModelElement;
+/**
+ * Groups table cells by their parent table.
+ *
+ * @internal
+ */
+export declare function groupCellsByTable(tableCells: Array<ModelElement>): Map<ModelElement, Array<ModelElement>>;
+/**
+ * Checks if all cells in a given row or column are header cells.
+ *
+ * @internal
+ */
+export declare function isEntireCellsLineHeader({ table, row, column }: {
+    table: ModelElement;
+    row?: number;
+    column?: number;
+}): boolean;
+/**
+ * Checks whether the `tableCellType` attribute is enabled in the editor schema and the experimental flag is set.
+ *
+ * @internal
+ */
+export declare function isTableCellTypeEnabled(editor: Editor): boolean;

package/src/utils/common.js

@@ -1,8 +1,9 @@
 /**
- * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
 import { downcastAttributeToStyle, upcastStyleToAttribute } from '../converters/tableproperties.js';
+import { TableWalker } from '../tablewalker.js';
 /**
  * A common method to update the numeric value. If a value is the default one, it will be unset.
  *
@@ -74,3 +75,44 @@ export function getSelectionAffectedTable(selection) {
     }
     return selection.getFirstPosition().findAncestor('table');
 }
+/**
+ * Groups table cells by their parent table.
+ *
+ * @internal
+ */
+export function groupCellsByTable(tableCells) {
+    const tableMap = new Map();
+    for (const tableCell of tableCells) {
+        const table = tableCell.findAncestor('table');
+        if (!tableMap.has(table)) {
+            tableMap.set(table, []);
+        }
+        tableMap.get(table).push(tableCell);
+    }
+    return tableMap;
+}
+/**
+ * Checks if all cells in a given row or column are header cells.
+ *
+ * @internal
+ */
+export function isEntireCellsLineHeader({ table, row, column }) {
+    const tableWalker = new TableWalker(table, { row, column });
+    for (const { cell } of tableWalker) {
+        const cellType = cell.getAttribute('tableCellType');
+        if (cellType !== 'header') {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Checks whether the `tableCellType` attribute is enabled in the editor schema and the experimental flag is set.
+ *
+ * @internal
+ */
+export function isTableCellTypeEnabled(editor) {
+    const { model, config } = editor;
+    return (model.schema.checkAttribute('tableCell', 'tableCellType') &&
+        config.get('experimentalFlags.tableCellTypeSupport') === true);
+}

package/src/utils/structure.d.ts

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