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

package/src/converters/upcasttable.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/converters/upcasttable.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
  */
 import { createEmptyTableCell } from '../utils/common.js';
@@ -159,10 +159,13 @@ export function ensureParagraphInTableCell(elementName) {
  * headingRows    - The number of rows that go as table headers.
  * headingColumns - The maximum number of row headings.
  * rows           - Sorted `<tr>` elements as they should go into the model - ie. if `<thead>` is inserted after `<tbody>` in the view.
+ *
+ * @param viewTable The view table element.
+ * @returns The table metadata.
  */
 function scanTable(viewTable) {
-    let headingRows = 0;
     let headingColumns = undefined;
+    let shouldAccumulateHeadingRows = true;
     // The `<tbody>` and `<thead>` sections in the DOM do not have to be in order `<thead>` -> `<tbody>` and there might be more than one
     // of them.
     // As the model does not have these sections, rows from different sections must be sorted.
@@ -188,6 +191,7 @@ function scanTable(viewTable) {
         }
         // Save the first `<thead>` in the table as table header - all other ones will be converted to table body rows.
         if (tableChild.name === 'thead' && !firstTheadElement) {
+            shouldAccumulateHeadingRows = true;
             firstTheadElement = tableChild;
         }
         // There might be some extra empty text nodes between the `<tr>`s.
@@ -208,12 +212,15 @@ function scanTable(viewTable) {
                     // of the cell span from the previous row.
                     // Issue: https://github.com/ckeditor/ckeditor5/issues/17556
                     (maxPrevColumns === null || trColumns.length === maxPrevColumns) &&
-                    trColumns.every(e => e.is('element', 'th')))) {
-                headingRows++;
+                    trColumns.every(e => e.is('element', 'th')) &&
+                    // If there is at least one "normal" table row between heading rows, then stop accumulating heading rows.
+                    shouldAccumulateHeadingRows)) {
                 headRows.push(tr);
+                shouldAccumulateHeadingRows = true;
             }
             else {
                 bodyRows.push(tr);
+                shouldAccumulateHeadingRows = false;
             }
             // We use the maximum number of columns to avoid false positives when detecting
             // multiple rows with single column within `rowspan`. Without it the last row of `rowspan=3`
@@ -233,12 +240,12 @@ function scanTable(viewTable) {
             index += 1;
         }
         // Update headingColumns.
-        if (!headingColumns || index < headingColumns) {
+        if (headingColumns === undefined || index < headingColumns) {
             headingColumns = index;
         }
     }
     return {
-        headingRows,
+        headingRows: headRows.length,
         headingColumns: headingColumns || 0,
         rows: [...headRows, ...bodyRows]
     };

package/src/index.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
  */
 /**
@@ -61,7 +61,6 @@ export { TableCellHeightCommand } from './tablecellproperties/commands/tablecell
 export { TableCellHorizontalAlignmentCommand } from './tablecellproperties/commands/tablecellhorizontalalignmentcommand.js';
 export { TableCellPaddingCommand } from './tablecellproperties/commands/tablecellpaddingcommand.js';
 export { TableCellVerticalAlignmentCommand } from './tablecellproperties/commands/tablecellverticalalignmentcommand.js';
-export { TableCellPropertyCommand } from './tablecellproperties/commands/tablecellpropertycommand.js';
 export { TableCellWidthCommand } from './tablecellwidth/commands/tablecellwidthcommand.js';
 export { TableAlignmentCommand } from './tableproperties/commands/tablealignmentcommand.js';
 export { TableBackgroundColorCommand } from './tableproperties/commands/tablebackgroundcolorcommand.js';
@@ -71,6 +70,8 @@ export { TableBorderWidthCommand } from './tableproperties/commands/tableborderw
 export { TableHeightCommand } from './tableproperties/commands/tableheightcommand.js';
 export { TableWidthCommand } from './tableproperties/commands/tablewidthcommand.js';
 export { TablePropertyCommand, type TablePropertyCommandExecuteOptions } from './tableproperties/commands/tablepropertycommand.js';
+export { TableCellTypeCommand, type TableCellType } from './tablecellproperties/commands/tablecelltypecommand.js';
+export { TableCellPropertyCommand, type TableCellPropertyCommandAfterExecuteEvent, type TableCellPropertyCommandAfterExecuteEventData } from './tablecellproperties/commands/tablecellpropertycommand.js';
 export type { ViewDocumentTableMouseMoveEvent, ViewDocumentTableMouseLeaveEvent } from './tablemouse/mouseeventsobserver.js';
 export type { TableConfig, TableAlignmentConfig, TablePropertiesConfig, TablePropertiesOptions, TableCellPropertiesConfig, TableColorConfig, TableCellPropertiesOptions, TableLayoutConfig, TableCaptionConfig, TableType } from './tableconfig.js';
 export { downcastTable as _downcastTable, downcastRow as _downcastTableRow, downcastCell as _downcastTableCell, convertParagraphInTableCell as _convertParagraphInTableCell, isSingleParagraphWithoutAttributes as _isSingleTableParagraphWithoutAttributes } from './converters/downcast.js';

package/src/index.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
  */
 /**
@@ -62,7 +62,6 @@ export { TableCellHeightCommand } from './tablecellproperties/commands/tablecell
 export { TableCellHorizontalAlignmentCommand } from './tablecellproperties/commands/tablecellhorizontalalignmentcommand.js';
 export { TableCellPaddingCommand } from './tablecellproperties/commands/tablecellpaddingcommand.js';
 export { TableCellVerticalAlignmentCommand } from './tablecellproperties/commands/tablecellverticalalignmentcommand.js';
-export { TableCellPropertyCommand } from './tablecellproperties/commands/tablecellpropertycommand.js';
 export { TableCellWidthCommand } from './tablecellwidth/commands/tablecellwidthcommand.js';
 export { TableAlignmentCommand } from './tableproperties/commands/tablealignmentcommand.js';
 export { TableBackgroundColorCommand } from './tableproperties/commands/tablebackgroundcolorcommand.js';
@@ -72,6 +71,8 @@ export { TableBorderWidthCommand } from './tableproperties/commands/tableborderw
 export { TableHeightCommand } from './tableproperties/commands/tableheightcommand.js';
 export { TableWidthCommand } from './tableproperties/commands/tablewidthcommand.js';
 export { TablePropertyCommand } from './tableproperties/commands/tablepropertycommand.js';
+export { TableCellTypeCommand } from './tablecellproperties/commands/tablecelltypecommand.js';
+export { TableCellPropertyCommand } from './tablecellproperties/commands/tablecellpropertycommand.js';
 // Internal exports.
 export { downcastTable as _downcastTable, downcastRow as _downcastTableRow, downcastCell as _downcastTableCell, convertParagraphInTableCell as _convertParagraphInTableCell, isSingleParagraphWithoutAttributes as _isSingleTableParagraphWithoutAttributes } from './converters/downcast.js';
 export { injectTableCaptionPostFixer as _injectTableCaptionPostFixer } from './converters/table-caption-post-fixer.js';

package/src/plaintableoutput.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/plaintableoutput.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/table.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/table.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/tablecaption/tablecaptionediting.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/tablecaption/tablecaptionediting.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/tablecaption/tablecaptionui.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/tablecaption/tablecaptionui.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/tablecaption/toggletablecaptioncommand.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/tablecaption/toggletablecaptioncommand.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/tablecaption/utils.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/tablecaption/utils.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
  */
 import { getSelectionAffectedTable } from '../utils/common.js';

package/src/tablecaption.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/tablecaption.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/tablecellproperties/commands/tablecellbackgroundcolorcommand.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/tablecellproperties/commands/tablecellbackgroundcolorcommand.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
  */
 import { TableCellPropertyCommand } from './tablecellpropertycommand.js';

package/src/tablecellproperties/commands/tablecellbordercolorcommand.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/tablecellproperties/commands/tablecellbordercolorcommand.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
  */
 import { TableCellPropertyCommand } from './tablecellpropertycommand.js';

package/src/tablecellproperties/commands/tablecellborderstylecommand.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/tablecellproperties/commands/tablecellborderstylecommand.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
  */
 import { TableCellPropertyCommand } from './tablecellpropertycommand.js';

package/src/tablecellproperties/commands/tablecellborderwidthcommand.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/tablecellproperties/commands/tablecellborderwidthcommand.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
  */
 import { TableCellPropertyCommand } from './tablecellpropertycommand.js';

package/src/tablecellproperties/commands/tablecellheightcommand.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/tablecellproperties/commands/tablecellheightcommand.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
  */
 import { TableCellPropertyCommand } from './tablecellpropertycommand.js';

package/src/tablecellproperties/commands/tablecellhorizontalalignmentcommand.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/tablecellproperties/commands/tablecellhorizontalalignmentcommand.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
  */
 import { TableCellPropertyCommand } from './tablecellpropertycommand.js';

package/src/tablecellproperties/commands/tablecellpaddingcommand.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/tablecellproperties/commands/tablecellpaddingcommand.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
  */
 import { TableCellPropertyCommand } from './tablecellpropertycommand.js';

package/src/tablecellproperties/commands/tablecellpropertycommand.d.ts

@@ -1,12 +1,12 @@
 /**
- * @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/tablecellproperties/commands/tablecellpropertycommand
  */
 import { Command, type Editor } from 'ckeditor5/src/core.js';
-import type { ModelElement, Batch } from 'ckeditor5/src/engine.js';
+import type { ModelElement, Batch, ModelWriter } from 'ckeditor5/src/engine.js';
 /**
  * The table cell attribute command.
  *
@@ -70,3 +70,21 @@ export declare class TableCellPropertyCommand extends Command {
      */
     private _getSingleValue;
 }
+/**
+ * Fired after the {@link module:table/tablecellproperties/commands/tablecellpropertycommand~TableCellPropertyCommand}
+ *
+ * @eventName ~TableCellPropertyCommand#afterExecute
+ */
+export type TableCellPropertyCommandAfterExecuteEvent = {
+    name: 'afterExecute';
+    args: [data: TableCellPropertyCommandAfterExecuteEventData];
+};
+/**
+ * The data of the
+ * {@link module:table/tablecellproperties/commands/tablecellpropertycommand~TableCellPropertyCommandAfterExecuteEvent} event.
+ */
+export type TableCellPropertyCommandAfterExecuteEventData = {
+    writer: ModelWriter;
+    tableCells: Array<ModelElement>;
+    valueToSet: unknown;
+};

package/src/tablecellproperties/commands/tablecellpropertycommand.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
  */
 /**
@@ -44,6 +44,9 @@ export class TableCellPropertyCommand extends Command {
         this._defaultContentTableValue = defaultValue;
         // Hardcoded defaults for layout table.
         switch (attributeName) {
+            case 'tableCellType':
+                this._defaultLayoutTableValue = 'data';
+                break;
             case 'tableCellBorderStyle':
                 this._defaultLayoutTableValue = 'none';
                 break;
@@ -94,6 +97,11 @@ export class TableCellPropertyCommand extends Command {
             else {
                 tableCells.forEach(tableCell => writer.removeAttribute(this.attributeName, tableCell));
             }
+            this.fire('afterExecute', {
+                writer,
+                tableCells,
+                valueToSet
+            });
         });
     }
     /**

package/src/tablecellproperties/commands/tablecelltypecommand.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @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/tablecellproperties/commands/tablecelltypecommand
+ */
+import type { Editor } from 'ckeditor5/src/core.js';
+import type { ModelElement, ModelWriter } from 'ckeditor5/src/engine.js';
+import { TableUtils } from '../../tableutils.js';
+import { TableCellPropertyCommand } from './tablecellpropertycommand.js';
+/**
+ * The table cell type command.
+ *
+ * The command is registered by the {@link module:table/tablecellproperties/tablecellpropertiesediting~TableCellPropertiesEditing} as
+ * the `'tableCellType'` editor command.
+ *
+ * To change the type of selected cells, execute the command:
+ *
+ * ```ts
+ * editor.execute( 'tableCellType', {
+ *   value: 'header'
+ * } );
+ * ```
+ *
+ * The `value` can be either `'header'` or `'data'`.
+ * It'll return `undefined` if multiple types are selected.
+ */
+export declare class TableCellTypeCommand extends TableCellPropertyCommand {
+    /**
+     * Creates a new `TableCellTypeCommand` instance.
+     *
+     * @param editor An editor in which this command will be used.
+     */
+    constructor(editor: Editor);
+    /**
+     * @inheritDoc
+     */
+    refresh(): void;
+    /**
+     * Returns the attribute value for a table cell.
+     */
+    protected _getAttribute(tableCell: ModelElement | undefined): unknown;
+}
+/**
+ * Type of the table cell.
+ */
+export type TableCellType = 'data' | 'header';
+/**
+ * Updates the `headingRows` and `headingColumns` attributes of the given tables
+ * based on the `tableCellType` of their cells.
+ */
+export declare function updateTablesHeadingAttributes(tableUtils: TableUtils, writer: ModelWriter, tables: Iterable<ModelElement>): boolean;

package/src/tablecellproperties/commands/tablecelltypecommand.js

@@ -0,0 +1,167 @@
+/**
+ * @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 { TableUtils } from '../../tableutils.js';
+import { TableCellPropertyCommand } from './tablecellpropertycommand.js';
+import { groupCellsByTable, getSelectionAffectedTable } from '../../utils/common.js';
+import { TableWalker } from '../../tablewalker.js';
+/**
+ * The table cell type command.
+ *
+ * The command is registered by the {@link module:table/tablecellproperties/tablecellpropertiesediting~TableCellPropertiesEditing} as
+ * the `'tableCellType'` editor command.
+ *
+ * To change the type of selected cells, execute the command:
+ *
+ * ```ts
+ * editor.execute( 'tableCellType', {
+ *   value: 'header'
+ * } );
+ * ```
+ *
+ * The `value` can be either `'header'` or `'data'`.
+ * It'll return `undefined` if multiple types are selected.
+ */
+export class TableCellTypeCommand extends TableCellPropertyCommand {
+    /**
+     * Creates a new `TableCellTypeCommand` instance.
+     *
+     * @param editor An editor in which this command will be used.
+     */
+    constructor(editor) {
+        super(editor, 'tableCellType', 'data');
+        this.on('afterExecute', (_, data) => {
+            const { writer, tableCells } = data;
+            const tableUtils = this.editor.plugins.get(TableUtils);
+            const tablesMap = groupCellsByTable(tableCells);
+            updateTablesHeadingAttributes(tableUtils, writer, tablesMap.keys());
+        });
+    }
+    /**
+     * @inheritDoc
+     */
+    refresh() {
+        super.refresh();
+        const table = getSelectionAffectedTable(this.editor.model.document.selection);
+        if (this.isEnabled && table && table.getAttribute('tableType') === 'layout') {
+            this.isEnabled = false;
+        }
+    }
+    /**
+     * Returns the attribute value for a table cell.
+     */
+    _getAttribute(tableCell) {
+        return tableCell?.getAttribute(this.attributeName) || 'data';
+    }
+}
+/**
+ * Updates the `headingRows` and `headingColumns` attributes of the given tables
+ * based on the `tableCellType` of their cells.
+ */
+export function updateTablesHeadingAttributes(tableUtils, writer, tables) {
+    let changed = false;
+    for (const table of tables) {
+        let headingRows = table.getAttribute('headingRows') || 0;
+        let headingColumns = table.getAttribute('headingColumns') || 0;
+        // Prioritize the dimension that is already larger to prevent the other dimension from
+        // aggressively consuming "orphaned" header cells. In other words, if table has three
+        // heading columns (which fills entire table), we should not count all rows as heading rows.
+        // User might later add column to the right which should not be heading.
+        //
+        // The other example, in a 2x2 table where all cells are headers (e.g. due to concurrent edits),
+        // if headingColumns=0 and headingRows=0 (but all cells are headers):
+        // - Processing rows first would expand headingRows to 2 (covering all cells), leaving headingColumns at 0.
+        // - Processing columns first expands headingColumns to 2, leaving headingRows at 0.
+        //
+        // It should be good enough to resolve conflicts in most cases.
+        const processColumnsFirst = headingColumns > headingRows;
+        if (processColumnsFirst) {
+            const newHeadingColumns = getAdjustedHeadingSectionSize(tableUtils, table, 'column', headingColumns, headingRows);
+            if (newHeadingColumns !== headingColumns) {
+                tableUtils.setHeadingColumnsCount(writer, table, newHeadingColumns, { shallow: true });
+                headingColumns = newHeadingColumns;
+                changed = true;
+            }
+        }
+        const newHeadingRows = getAdjustedHeadingSectionSize(tableUtils, table, 'row', headingRows, headingColumns);
+        if (newHeadingRows !== headingRows) {
+            tableUtils.setHeadingRowsCount(writer, table, newHeadingRows, { shallow: true });
+            headingRows = newHeadingRows;
+            changed = true;
+        }
+        if (!processColumnsFirst) {
+            const newHeadingColumns = getAdjustedHeadingSectionSize(tableUtils, table, 'column', headingColumns, headingRows);
+            if (newHeadingColumns !== headingColumns) {
+                tableUtils.setHeadingColumnsCount(writer, table, newHeadingColumns, { shallow: true });
+                changed = true;
+            }
+        }
+    }
+    return changed;
+}
+/**
+ * Calculates the adjusted size of a heading section (rows or columns).
+ *
+ * The algorithm iterates through rows (or columns) to determine if they should be part of the heading section.
+ * A row/column is included if:
+ * 1. All its cells are of type 'header'.
+ * 2. AND it contains at least one header cell that is NOT already covered by the perpendicular heading section.
+ *
+ * This check prevents the algorithm from aggressively expanding the heading section when cells are already
+ * headers due to the other dimension.
+ *
+ * Consider a 2x2 table where all cells are headers:
+ *
+ * ```
+ *    C0  C1
+ *   +---+---+
+ * R0| H | H |
+ *   +---+---+
+ * R1| H | H |
+ *   +---+---+
+ * ```
+ *
+ * If `headingColumns=2`, both C0 and C1 are heading columns.
+ * If we want `headingRows=1` (only R0), the algorithm must NOT include R1, even though R1 consists of header cells.
+ * R1's cells are headers because of C0 and C1.
+ *
+ * Without this check, the algorithm would see that R1 is all headers and force `headingRows` to 2.
+ * This would prevent the user from reducing `headingRows` from 2 to 1 without converting R1 cells to 'data'
+ * (which would incorrectly break C0 and C1).
+ */
+function getAdjustedHeadingSectionSize(tableUtils, table, mode, currentSize, perpendicularHeadingSize) {
+    const totalRowsOrColumns = mode === 'row' ? tableUtils.getRows(table) : tableUtils.getColumns(table);
+    let size = currentSize;
+    // Iterate through each row/column to check if all cells are headers.
+    for (let currentIndex = 0; currentIndex < totalRowsOrColumns; currentIndex++) {
+        const walker = new TableWalker(table, { [mode]: currentIndex });
+        let allCellsAreHeaders = true;
+        let hasHeaderOutsidePerpendicularSection = false;
+        // Check each cell in the current row/column.
+        for (const { cell, row, column } of walker) {
+            // If we find a non-header cell, this row/column can't be part of the heading section.
+            if (cell.getAttribute('tableCellType') !== 'header') {
+                allCellsAreHeaders = false;
+                break;
+            }
+            // Check if this header cell extends beyond the perpendicular heading section.
+            // E.g., when checking rows, see if the cell extends beyond headingColumns.
+            const perpendicularIndex = mode === 'row' ? column : row;
+            if (perpendicularIndex >= perpendicularHeadingSize) {
+                hasHeaderOutsidePerpendicularSection = true;
+            }
+        }
+        // If not all cells are headers, we can't extend the heading section any further.
+        if (!allCellsAreHeaders) {
+            // The section cannot extend beyond the last valid header row/column.
+            return Math.min(size, currentIndex);
+        }
+        // If there's a header extending beyond the perpendicular section,
+        // we must include this row/column in the heading section.
+        if (hasHeaderOutsidePerpendicularSection) {
+            size = Math.max(size, currentIndex + 1);
+        }
+    }
+    return Math.min(size, totalRowsOrColumns);
+}