@ckeditor/ckeditor5-table 0.0.0-nightly-next-20260127.0 → 0.0.0-nightly-next-20260128.0

package/ckeditor5-metadata.json

@@ -47,6 +47,7 @@
 						"table",
 						"thead",
 						"tbody",
+						"tfoot",
 						"tr"
 					]
 				},

package/dist/augmentation.d.ts

@@ -2,21 +2,7 @@
  * @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 type { TableConfig, Table, TableCaption, TableCaptionEditing, TableCaptionUI, TableCellProperties, TableCellPropertiesEditing, TableCellPropertiesUI, TableCellWidthEditing, TableClipboard, TableColumnResize, TableColumnResizeEditing, TableEditing, TableKeyboard, TableLayout, TableLayoutEditing, TableMouse, TableProperties, TablePropertiesEditing, TablePropertiesUI, TableSelection, TableToolbar, TableUI, TableUtils, PlainTableOutput, InsertColumnCommand, InsertRowCommand, InsertTableCommand, InsertTableLayoutCommand, MergeCellCommand, MergeCellsCommand, RemoveColumnCommand, RemoveRowCommand, SelectColumnCommand, SelectRowCommand, SetHeaderColumnCommand, SetHeaderRowCommand, TableTypeCommand, SplitCellCommand, ToggleTableCaptionCommand, TableCellBackgroundColorCommand, TableCellBorderColorCommand, TableCellBorderStyleCommand, TableCellBorderWidthCommand, TableCellHeightCommand, TableCellHorizontalAlignmentCommand, TableCellPaddingCommand, TableCellVerticalAlignmentCommand, TableCellWidthCommand, TableAlignmentCommand, TableBackgroundColorCommand, TableBorderColorCommand, TableBorderStyleCommand, TableBorderWidthCommand, TableHeightCommand, TableWidthCommand, TableCellTypeCommand } from './index.js';
-declare module '@ckeditor/ckeditor5-engine' {
-    interface ExperimentalFlagsConfig {
-        /**
-         * When enabled, the {@link module:table/tableproperties/tablepropertiesediting~TablePropertiesEditing table properties feature}
-         * and {@link module:table/tablecellproperties/tablecellpropertiesediting~TableCellPropertiesEditing table cell properties feature}
-         * upcast `border="0"` attributes on `<table>` and `<td>`/`<th>` elements as `tableBorderStyle` and `tableCellBorderStyle` styles
-         * with value set to `none`.
-         *
-         * This is useful when migrating content from the CKEditor 4, which used `border="0"` to represent tables and cells without borders.
-         * This will be enabled by default in the future CKEditor 5 releases.
-         */
-        upcastTableBorderZeroAttributes?: boolean;
-    }
-}
+import type { TableConfig, Table, TableCaption, TableCaptionEditing, TableCaptionUI, TableCellProperties, TableCellPropertiesEditing, TableCellPropertiesUI, TableCellWidthEditing, TableClipboard, TableColumnResize, TableColumnResizeEditing, TableEditing, TableKeyboard, TableLayout, TableLayoutEditing, TableMouse, TableProperties, TablePropertiesEditing, TablePropertiesUI, TableSelection, TableToolbar, TableUI, TableUtils, PlainTableOutput, InsertColumnCommand, InsertRowCommand, InsertTableCommand, InsertTableLayoutCommand, MergeCellCommand, MergeCellsCommand, RemoveColumnCommand, RemoveRowCommand, SelectColumnCommand, SelectRowCommand, SetHeaderColumnCommand, SetHeaderRowCommand, TableTypeCommand, SplitCellCommand, ToggleTableCaptionCommand, TableCellBackgroundColorCommand, TableCellBorderColorCommand, TableCellBorderStyleCommand, TableCellBorderWidthCommand, TableCellHeightCommand, TableCellHorizontalAlignmentCommand, TableCellPaddingCommand, TableCellVerticalAlignmentCommand, TableCellWidthCommand, TableAlignmentCommand, TableBackgroundColorCommand, TableBorderColorCommand, TableBorderStyleCommand, TableBorderWidthCommand, TableHeightCommand, TableWidthCommand, TableCellTypeCommand, SetFooterRowCommand } from './index.js';
 declare module '@ckeditor/ckeditor5-core' {
     interface EditorConfig {
         /**
@@ -70,6 +56,7 @@ declare module '@ckeditor/ckeditor5-core' {
         selectTableRow: SelectRowCommand;
         setTableColumnHeader: SetHeaderColumnCommand;
         setTableRowHeader: SetHeaderRowCommand;
+        setTableFooterRow: SetFooterRowCommand;
         splitTableCellVertically: SplitCellCommand;
         splitTableCellHorizontally: SplitCellCommand;
         toggleTableCaption: ToggleTableCaptionCommand;

package/dist/commands/inserttablecommand.d.ts

@@ -33,6 +33,9 @@ export declare class InsertTableCommand extends Command {
      * {@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.
+     * @param options.footerRows The number of footer rows. If not provided it will default to
+     * {@link module:table/tableconfig~TableConfig#defaultFooters `config.table.defaultFooters`} table config.
+     * This option is ignored when {@link module:table/tableconfig~TableConfig#enableFooters `config.table.enableFooters`} is `false`.
      * @fires execute
      */
     execute(options?: {
@@ -40,5 +43,6 @@ export declare class InsertTableCommand extends Command {
         columns?: number;
         headingRows?: number;
         headingColumns?: number;
+        footerRows?: number;
     }): void;
 }

package/dist/commands/setfooterrowcommand.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/commands/setfooterrowcommand
+ */
+import { Command } from '@ckeditor/ckeditor5-core';
+/**
+ * The footer row command.
+ *
+ * The command is registered by {@link module:table/tableediting~TableEditing} as the `'setTableFooterRow'` editor command.
+ *
+ * You can make the row containing the selected cell a footer by executing:
+ *
+ * ```ts
+ * editor.execute( 'setTableFooterRow' );
+ * ```
+ *
+ * **Note:** All following rows will also become footers. If the current row is already a footer, executing this command
+ * will make it a regular row back again (including the preceding rows).
+ */
+export declare class SetFooterRowCommand extends Command {
+    /**
+     * Flag indicating whether the command is active. The command is active when the
+     * {@link module:engine/model/selection~ModelSelection} is in a footer row.
+     *
+     * @observable
+     */
+    value: boolean;
+    /**
+     * @inheritDoc
+     */
+    refresh(): void;
+    /**
+     * Executes the command.
+     *
+     * When the selection is in a non-footer row, the command will set the `footerRows` table attribute to cover that row.
+     *
+     * When the selection is already in a footer row, it will set `footerRows` so the footer section will start after that row.
+     *
+     * @fires execute
+     * @param options.forceValue If set, the command will set (`true`) or unset (`false`) the footer rows according to
+     * the `forceValue` parameter instead of the current model state.
+     */
+    execute(options?: {
+        forceValue?: boolean;
+    }): void;
+    /**
+     * Checks if a table cell is in the footer section.
+     */
+    private _isInFooter;
+}

package/dist/converters/downcast.d.ts

@@ -7,7 +7,7 @@
  */
 import { type Editor } from '@ckeditor/ckeditor5-core';
 import type { ViewElement, ModelElement, DowncastElementCreatorFunction, DowncastConversionApi } from '@ckeditor/ckeditor5-engine';
-import { type TableUtils } from '../tableutils.js';
+import { TableUtils } from '../tableutils.js';
 import type { TableConversionAdditionalSlot } from '../tableediting.js';
 /**
  * Model table element to view table element conversion helper.

package/dist/converters/table-structure-post-fixer.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @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/converters/table-structure-post-fixer
+ */
+import type { Editor } from '@ckeditor/ckeditor5-core';
+/**
+ * Injects a table structure post-fixer into the model.
+ *
+ * It checks if the `headingRows` and `footerRows` attributes do not overlap.
+ * If they overlap, the `footerRows` attribute is corrected.
+ *
+ * We prefer `headingRows` over `footerRows` because changing `headingRows` would require updating
+ * the `tableCellType` attribute of the cells in the row, which is not required when changing `footerRows`.
+ *
+ * @param editor The editor instance.
+ */
+export declare function injectTableStructurePostFixer(editor: Editor): void;

package/dist/converters/{table-headings-refresh-handler.d.ts → table-structure-refresh-handler.d.ts}

@@ -3,7 +3,7 @@
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
 /**
- * @module table/converters/table-headings-refresh-handler
+ * @module table/converters/table-structure-refresh-handler
  */
 import type { EditingController, Model } from '@ckeditor/ckeditor5-engine';
 /**
@@ -16,4 +16,4 @@ import type { EditingController, Model } from '@ckeditor/ckeditor5-engine';
  *
  * @internal
  */
-export declare function tableHeadingsRefreshHandler(model: Model, editing: EditingController): void;
+export declare function tableStructureRefreshHandler(model: Model, editing: EditingController): void;

package/dist/converters/upcasttable.d.ts

@@ -27,10 +27,14 @@ export declare function upcastTableFigure(): (dispatcher: UpcastDispatcher) => v
  *
  * This conversion helper converts the table element as well as table rows.
  *
+ * @param options Conversion options.
+ * @param options.enableFooters If set to `true` the `footerRows` attribute will be upcasted.
  * @returns Conversion helper.
  * @internal
  */
-export declare function upcastTable(): (dispatcher: UpcastDispatcher) => void;
+export declare function upcastTable(options: {
+    enableFooters?: boolean;
+}): (dispatcher: UpcastDispatcher) => void;
 /**
  * A conversion helper that skips empty <tr> elements from upcasting at the beginning of the table.
  *

package/dist/index-content.css

@@ -34,17 +34,21 @@
 		border:1px double hsl(0, 0%, 70%);
 	}
 
-.ck-content table.table:not(.layout-table) > thead > tr > th, .ck-content figure.table:not(.layout-table) > table > thead > tr > th, .ck-content table.table:not(.layout-table) > tbody > tr > th, .ck-content figure.table:not(.layout-table) > table > tbody > tr > th{
+.ck-content table.table:not(.layout-table) > thead > tr > th, .ck-content figure.table:not(.layout-table) > table > thead > tr > th, .ck-content table.table:not(.layout-table) > tfoot > tr > th, .ck-content figure.table:not(.layout-table) > table > tfoot > tr > th, .ck-content table.table:not(.layout-table) > tbody > tr > th, .ck-content figure.table:not(.layout-table) > table > tbody > tr > th{
 					font-weight:bold;
 					background:hsla(0, 0%, 0%, 5%);
 				}
 
 .ck-content table.table:not(.layout-table) > thead > tr > td,
 				.ck-content figure.table:not(.layout-table) > table > thead > tr > td,
+				.ck-content table.table:not(.layout-table) > tfoot > tr > td,
+				.ck-content figure.table:not(.layout-table) > table > tfoot > tr > td,
 				.ck-content table.table:not(.layout-table) > tbody > tr > td,
 				.ck-content figure.table:not(.layout-table) > table > tbody > tr > td,
 				.ck-content table.table:not(.layout-table) > thead > tr > th,
 				.ck-content figure.table:not(.layout-table) > table > thead > tr > th,
+				.ck-content table.table:not(.layout-table) > tfoot > tr > th,
+				.ck-content figure.table:not(.layout-table) > table > tfoot > tr > th,
 				.ck-content table.table:not(.layout-table) > tbody > tr > th,
 				.ck-content figure.table:not(.layout-table) > table > tbody > tr > th{
 
@@ -53,11 +57,11 @@
 					border:1px solid hsl(0, 0%, 75%);
 				}
 
-.ck-content table.table:not(.layout-table) > thead > tr > td > p:first-of-type, .ck-content figure.table:not(.layout-table) > table > thead > tr > td > p:first-of-type, .ck-content table.table:not(.layout-table) > tbody > tr > td > p:first-of-type, .ck-content figure.table:not(.layout-table) > table > tbody > tr > td > p:first-of-type, .ck-content table.table:not(.layout-table) > thead > tr > th > p:first-of-type, .ck-content figure.table:not(.layout-table) > table > thead > tr > th > p:first-of-type, .ck-content table.table:not(.layout-table) > tbody > tr > th > p:first-of-type, .ck-content figure.table:not(.layout-table) > table > tbody > tr > th > p:first-of-type{
+.ck-content table.table:not(.layout-table) > thead > tr > td > p:first-of-type, .ck-content figure.table:not(.layout-table) > table > thead > tr > td > p:first-of-type, .ck-content table.table:not(.layout-table) > tfoot > tr > td > p:first-of-type, .ck-content figure.table:not(.layout-table) > table > tfoot > tr > td > p:first-of-type, .ck-content table.table:not(.layout-table) > tbody > tr > td > p:first-of-type, .ck-content figure.table:not(.layout-table) > table > tbody > tr > td > p:first-of-type, .ck-content table.table:not(.layout-table) > thead > tr > th > p:first-of-type, .ck-content figure.table:not(.layout-table) > table > thead > tr > th > p:first-of-type, .ck-content table.table:not(.layout-table) > tfoot > tr > th > p:first-of-type, .ck-content figure.table:not(.layout-table) > table > tfoot > tr > th > p:first-of-type, .ck-content table.table:not(.layout-table) > tbody > tr > th > p:first-of-type, .ck-content figure.table:not(.layout-table) > table > tbody > tr > th > p:first-of-type{
 						margin-top:0;
 					}
 
-.ck-content table.table:not(.layout-table) > thead > tr > td > p:last-of-type, .ck-content figure.table:not(.layout-table) > table > thead > tr > td > p:last-of-type, .ck-content table.table:not(.layout-table) > tbody > tr > td > p:last-of-type, .ck-content figure.table:not(.layout-table) > table > tbody > tr > td > p:last-of-type, .ck-content table.table:not(.layout-table) > thead > tr > th > p:last-of-type, .ck-content figure.table:not(.layout-table) > table > thead > tr > th > p:last-of-type, .ck-content table.table:not(.layout-table) > tbody > tr > th > p:last-of-type, .ck-content figure.table:not(.layout-table) > table > tbody > tr > th > p:last-of-type{
+.ck-content table.table:not(.layout-table) > thead > tr > td > p:last-of-type, .ck-content figure.table:not(.layout-table) > table > thead > tr > td > p:last-of-type, .ck-content table.table:not(.layout-table) > tfoot > tr > td > p:last-of-type, .ck-content figure.table:not(.layout-table) > table > tfoot > tr > td > p:last-of-type, .ck-content table.table:not(.layout-table) > tbody > tr > td > p:last-of-type, .ck-content figure.table:not(.layout-table) > table > tbody > tr > td > p:last-of-type, .ck-content table.table:not(.layout-table) > thead > tr > th > p:last-of-type, .ck-content figure.table:not(.layout-table) > table > thead > tr > th > p:last-of-type, .ck-content table.table:not(.layout-table) > tfoot > tr > th > p:last-of-type, .ck-content figure.table:not(.layout-table) > table > tfoot > tr > th > p:last-of-type, .ck-content table.table:not(.layout-table) > tbody > tr > th > p:last-of-type, .ck-content figure.table:not(.layout-table) > table > tbody > tr > th > p:last-of-type{
 						margin-bottom:0;
 					}
 

package/dist/index.css

@@ -57,17 +57,21 @@
 
 /* stylelint-disable no-descending-specificity */
 
-.ck-content table.table:not(.layout-table) > thead > tr > th, .ck-content figure.table:not(.layout-table) > table > thead > tr > th, .ck-content table.table:not(.layout-table) > tbody > tr > th, .ck-content figure.table:not(.layout-table) > table > tbody > tr > th {
+.ck-content table.table:not(.layout-table) > thead > tr > th, .ck-content figure.table:not(.layout-table) > table > thead > tr > th, .ck-content table.table:not(.layout-table) > tfoot > tr > th, .ck-content figure.table:not(.layout-table) > table > tfoot > tr > th, .ck-content table.table:not(.layout-table) > tbody > tr > th, .ck-content figure.table:not(.layout-table) > table > tbody > tr > th {
 					font-weight: bold;
 					background: hsla(0, 0%, 0%, 5%);
 				}
 
 .ck-content table.table:not(.layout-table) > thead > tr > td,
 				.ck-content figure.table:not(.layout-table) > table > thead > tr > td,
+				.ck-content table.table:not(.layout-table) > tfoot > tr > td,
+				.ck-content figure.table:not(.layout-table) > table > tfoot > tr > td,
 				.ck-content table.table:not(.layout-table) > tbody > tr > td,
 				.ck-content figure.table:not(.layout-table) > table > tbody > tr > td,
 				.ck-content table.table:not(.layout-table) > thead > tr > th,
 				.ck-content figure.table:not(.layout-table) > table > thead > tr > th,
+				.ck-content table.table:not(.layout-table) > tfoot > tr > th,
+				.ck-content figure.table:not(.layout-table) > table > tfoot > tr > th,
 				.ck-content table.table:not(.layout-table) > tbody > tr > th,
 				.ck-content figure.table:not(.layout-table) > table > tbody > tr > th {
 
@@ -84,7 +88,7 @@
 					 */
 				}
 
-.ck-content table.table:not(.layout-table) > thead > tr > td > p:first-of-type, .ck-content figure.table:not(.layout-table) > table > thead > tr > td > p:first-of-type, .ck-content table.table:not(.layout-table) > tbody > tr > td > p:first-of-type, .ck-content figure.table:not(.layout-table) > table > tbody > tr > td > p:first-of-type, .ck-content table.table:not(.layout-table) > thead > tr > th > p:first-of-type, .ck-content figure.table:not(.layout-table) > table > thead > tr > th > p:first-of-type, .ck-content table.table:not(.layout-table) > tbody > tr > th > p:first-of-type, .ck-content figure.table:not(.layout-table) > table > tbody > tr > th > p:first-of-type {
+.ck-content table.table:not(.layout-table) > thead > tr > td > p:first-of-type, .ck-content figure.table:not(.layout-table) > table > thead > tr > td > p:first-of-type, .ck-content table.table:not(.layout-table) > tfoot > tr > td > p:first-of-type, .ck-content figure.table:not(.layout-table) > table > tfoot > tr > td > p:first-of-type, .ck-content table.table:not(.layout-table) > tbody > tr > td > p:first-of-type, .ck-content figure.table:not(.layout-table) > table > tbody > tr > td > p:first-of-type, .ck-content table.table:not(.layout-table) > thead > tr > th > p:first-of-type, .ck-content figure.table:not(.layout-table) > table > thead > tr > th > p:first-of-type, .ck-content table.table:not(.layout-table) > tfoot > tr > th > p:first-of-type, .ck-content figure.table:not(.layout-table) > table > tfoot > tr > th > p:first-of-type, .ck-content table.table:not(.layout-table) > tbody > tr > th > p:first-of-type, .ck-content figure.table:not(.layout-table) > table > tbody > tr > th > p:first-of-type {
 						margin-top: 0;
 					}
 
@@ -98,7 +102,7 @@
 					 * See: https://github.com/ckeditor/ckeditor5/pull/18801
 					 */
 
-.ck-content table.table:not(.layout-table) > thead > tr > td > p:last-of-type, .ck-content figure.table:not(.layout-table) > table > thead > tr > td > p:last-of-type, .ck-content table.table:not(.layout-table) > tbody > tr > td > p:last-of-type, .ck-content figure.table:not(.layout-table) > table > tbody > tr > td > p:last-of-type, .ck-content table.table:not(.layout-table) > thead > tr > th > p:last-of-type, .ck-content figure.table:not(.layout-table) > table > thead > tr > th > p:last-of-type, .ck-content table.table:not(.layout-table) > tbody > tr > th > p:last-of-type, .ck-content figure.table:not(.layout-table) > table > tbody > tr > th > p:last-of-type {
+.ck-content table.table:not(.layout-table) > thead > tr > td > p:last-of-type, .ck-content figure.table:not(.layout-table) > table > thead > tr > td > p:last-of-type, .ck-content table.table:not(.layout-table) > tfoot > tr > td > p:last-of-type, .ck-content figure.table:not(.layout-table) > table > tfoot > tr > td > p:last-of-type, .ck-content table.table:not(.layout-table) > tbody > tr > td > p:last-of-type, .ck-content figure.table:not(.layout-table) > table > tbody > tr > td > p:last-of-type, .ck-content table.table:not(.layout-table) > thead > tr > th > p:last-of-type, .ck-content figure.table:not(.layout-table) > table > thead > tr > th > p:last-of-type, .ck-content table.table:not(.layout-table) > tfoot > tr > th > p:last-of-type, .ck-content figure.table:not(.layout-table) > table > tfoot > tr > th > p:last-of-type, .ck-content table.table:not(.layout-table) > tbody > tr > th > p:last-of-type, .ck-content figure.table:not(.layout-table) > table > tbody > tr > th > p:last-of-type {
 						margin-bottom: 0;
 					}