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

package/dist/tableconfig.d.ts

@@ -42,6 +42,31 @@ export interface TableConfig {
         rows?: number;
         columns?: number;
     };
+    /**
+     * Number of footer rows to render by default when inserting new tables.
+     *
+     * You can configure it like this:
+     *
+     * ```ts
+     * const tableConfig = {
+     * 	defaultFooters: 1
+     * };
+     * ```
+     *
+     * The rows property is optional, defaulting to 0 (no footer).
+     * This option is ignored when {@link module:table/tableconfig~TableConfig#enableFooters `config.table.enableFooters`} is `false`.
+     */
+    defaultFooters?: number;
+    /**
+     * Enables support for table footers (`<tfoot>`).
+     *
+     * When set to `true`, the editor will upcast and downcast `<tfoot>` elements, and the footer toggle will be visible
+     * in the table row dropdown.
+     * When set to `false` (default), footer rows are ignored and the footer toggle is hidden in the table row dropdown.
+     *
+     * @default false
+     */
+    enableFooters?: boolean;
     /**
      * Items to be placed in the table content toolbar.
      * The {@link module:table/tabletoolbar~TableToolbar} plugin is required to make this toolbar work.

package/dist/tableutils.d.ts

@@ -76,6 +76,7 @@ export declare class TableUtils extends Plugin {
      * @param options.columns The number of columns to create. Default value is 2.
      * @param options.headingRows The number of heading rows. Default value is 0.
      * @param options.headingColumns The number of heading columns. Default value is 0.
+     * @param options.footerRows The number of footer rows. Default value is 0.
      * @returns The created table element.
      */
     createTable(writer: ModelWriter, options: {
@@ -83,6 +84,7 @@ export declare class TableUtils extends Plugin {
         columns?: number;
         headingRows?: number;
         headingColumns?: number;
+        footerRows?: number;
     }): ModelElement;
     /**
      * Inserts rows into a table.
@@ -350,44 +352,55 @@ export declare class TableUtils extends Plugin {
      * {@link #getTableCellsContainingSelection}.
      */
     getSelectedTableCells(selection: ModelSelection | ModelDocumentSelection): Array<ModelElement>;
+    /**
+     * Sets the number of footer rows for the given `table`.
+     *
+     * * If number of footer rows is greater than the number of rows in the table, it will be truncated to the number of rows.
+     * * If footer rows and heading rows overlap, the number of heading rows will be adjusted
+     *
+     * It'll have no effect if {@link module:table/tableconfig~TableConfig#enableFooters `table.enableFooters`} is set to `false`.
+     *
+     * @param writer The model writer.
+     * @param table The table model element.
+     * @param footerRows The number of footer rows to set.
+     */
+    setFooterRowsCount(writer: ModelWriter, table: ModelElement, footerRows: number): void;
     /**
      * Sets the number of heading rows for the given `table`.
      *
+     * If number of heading rows is greater than the number of rows in the table,
+     * it will be truncated to the number of rows.
+     *
      * @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.updateCellType If set to `false` it will only update the `headingRows` attribute
+     * without updating the cell types in the table. Default is `true`.
      * @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;
+    setHeadingRowsCount(writer: ModelWriter, table: ModelElement, headingRows: number, options?: UpdateTableHeadingsOptions): void;
     /**
      * Sets the number of heading columns for the given `table`.
      *
+     * If number of heading columns is greater than the number of columns in the table,
+     * it will be truncated to the number of columns.
+     *
      * @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.updateCellType If set to `false` it will only update the `headingColumns` attribute
+     * without updating the cell types in the table. Default is `true`.
      * @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;
+    setHeadingColumnsCount(writer: ModelWriter, table: ModelElement, headingColumns: number, options?: UpdateTableHeadingsOptions): void;
     /**
      * Returns all model table cells that the provided model selection's ranges
      * {@link module:engine/model/range~ModelRange#start} inside.
@@ -485,5 +498,44 @@ export declare class TableUtils extends Plugin {
     /**
      * Unified check if table rows/columns indexes are in the same heading/body section.
      */
-    private _areIndexesInSameSection;
+    private _areIndexesInSameHeadingSection;
+    /**
+     * Unified check if table rows indexes are in the same footer/body section.
+     */
+    private _areIndexesInSameFooterSection;
 }
+/**
+ * Options for the {@link module:table/tableutils~TableUtils#setHeadingRowsCount} and
+ * {@link module:table/tableutils~TableUtils#setHeadingColumnsCount} methods.
+ */
+export type UpdateTableHeadingsOptions = {
+    /**
+     * If set to `false` it will only update the `headingRows`/`headingColumns` attribute
+     * without updating the cell types in the table.
+     *
+     * This option has no effect if {@link module:table/tablecellproperties/tablecellpropertiesediting~TableCellPropertiesEditing}
+     * is not loaded.
+     *
+     * @default true
+     */
+    updateCellType?: boolean;
+    /**
+     * If set to `true`, it will check if the rows/columns that are no longer in the heading section
+     * should be updated to body cells.
+     *
+     * This option has no effect if {@link module:table/tablecellproperties/tablecellpropertiesediting~TableCellPropertiesEditing}
+     * is not loaded.
+     *
+     * @default true
+     */
+    resetFormerHeadingCells?: boolean;
+    /**
+     * If set to `true`, it will check if the following rows/columns look like a header and expand the heading section.
+     *
+     * This option has no effect if {@link module:table/tablecellproperties/tablecellpropertiesediting~TableCellPropertiesEditing}
+     * is not loaded.
+     *
+     * @default true
+     */
+    autoExpand?: boolean;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-table",
-  "version": "0.0.0-nightly-next-20260127.0",
+  "version": "0.0.0-nightly-next-20260128.0",
   "description": "Table feature for CKEditor 5.",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "CKSource (http://cksource.com/)",
@@ -26,14 +26,14 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@ckeditor/ckeditor5-clipboard": "0.0.0-nightly-next-20260127.0",
-    "@ckeditor/ckeditor5-core": "0.0.0-nightly-next-20260127.0",
-    "@ckeditor/ckeditor5-engine": "0.0.0-nightly-next-20260127.0",
-    "@ckeditor/ckeditor5-icons": "0.0.0-nightly-next-20260127.0",
-    "@ckeditor/ckeditor5-typing": "0.0.0-nightly-next-20260127.0",
-    "@ckeditor/ckeditor5-ui": "0.0.0-nightly-next-20260127.0",
-    "@ckeditor/ckeditor5-utils": "0.0.0-nightly-next-20260127.0",
-    "@ckeditor/ckeditor5-widget": "0.0.0-nightly-next-20260127.0",
+    "@ckeditor/ckeditor5-clipboard": "0.0.0-nightly-next-20260128.0",
+    "@ckeditor/ckeditor5-core": "0.0.0-nightly-next-20260128.0",
+    "@ckeditor/ckeditor5-engine": "0.0.0-nightly-next-20260128.0",
+    "@ckeditor/ckeditor5-icons": "0.0.0-nightly-next-20260128.0",
+    "@ckeditor/ckeditor5-typing": "0.0.0-nightly-next-20260128.0",
+    "@ckeditor/ckeditor5-ui": "0.0.0-nightly-next-20260128.0",
+    "@ckeditor/ckeditor5-utils": "0.0.0-nightly-next-20260128.0",
+    "@ckeditor/ckeditor5-widget": "0.0.0-nightly-next-20260128.0",
     "es-toolkit": "1.39.5"
   },
   "files": [