@ckeditor/ckeditor5-table 48.2.0-alpha.7 → 48.3.0-alpha.0

package/dist/commands/setheaderrowcommand.d.ts

@@ -1,53 +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
- */
+* @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/setheaderrowcommand
- */
-import { Command } from '@ckeditor/ckeditor5-core';
+* @module table/commands/setheaderrowcommand
+*/
+import { Command } from "@ckeditor/ckeditor5-core";
 /**
- * The header row command.
- *
- * The command is registered by {@link module:table/tableediting~TableEditing} as the `'setTableColumnHeader'` editor command.
- *
- * You can make the row containing the selected cell a [header](https://www.w3.org/TR/html50/tabular-data.html#the-th-element) by executing:
- *
- * ```ts
- * editor.execute( 'setTableRowHeader' );
- * ```
- *
- * **Note:** All preceding rows will also become headers. If the current row is already a header, executing this command
- * will make it a regular row back again (including the following rows).
- */
+* The header row command.
+*
+* The command is registered by {@link module:table/tableediting~TableEditing} as the `'setTableColumnHeader'` editor command.
+*
+* You can make the row containing the selected cell a [header](https://www.w3.org/TR/html50/tabular-data.html#the-th-element) by executing:
+*
+* ```ts
+* editor.execute( 'setTableRowHeader' );
+* ```
+*
+* **Note:** All preceding rows will also become headers. If the current row is already a header, executing this command
+* will make it a regular row back again (including the following rows).
+*/
 export declare class SetHeaderRowCommand extends Command {
-    /**
-     * Flag indicating whether the command is active. The command is active when the
-     * {@link module:engine/model/selection~ModelSelection} is in a header row.
-     *
-     * @observable
-     */
-    value: boolean;
-    /**
-     * @inheritDoc
-     */
-    refresh(): void;
-    /**
-     * Executes the command.
-     *
-     * When the selection is in a non-header row, the command will set the `headingRows` table attribute to cover that row.
-     *
-     * When the selection is already in a header row, it will set `headingRows` so the heading section will end before that row.
-     *
-     * @fires execute
-     * @param options.forceValue If set, the command will set (`true`) or unset (`false`) the header 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 heading section.
-     */
-    private _isInHeading;
+	/**
+	* Flag indicating whether the command is active. The command is active when the
+	* {@link module:engine/model/selection~ModelSelection} is in a header row.
+	*
+	* @observable
+	*/
+	value: boolean;
+	/**
+	* @inheritDoc
+	*/
+	override refresh(): void;
+	/**
+	* Executes the command.
+	*
+	* When the selection is in a non-header row, the command will set the `headingRows` table attribute to cover that row.
+	*
+	* When the selection is already in a header row, it will set `headingRows` so the heading section will end before that row.
+	*
+	* @fires execute
+	* @param options.forceValue If set, the command will set (`true`) or unset (`false`) the header rows according to
+	* the `forceValue` parameter instead of the current model state.
+	*/
+	override execute(options?: {
+		forceValue?: boolean;
+	}): void;
+	/**
+	* Checks if a table cell is in the heading section.
+	*/
+	private _isInHeading;
 }

package/dist/commands/splitcellcommand.d.ts

@@ -1,43 +1,43 @@
 /**
- * @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
- */
+* @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/splitcellcommand
- */
-import { Command, type Editor } from '@ckeditor/ckeditor5-core';
+* @module table/commands/splitcellcommand
+*/
+import { Command, type Editor } from "@ckeditor/ckeditor5-core";
 /**
- * The split cell command.
- *
- * The command is registered by {@link module:table/tableediting~TableEditing} as the `'splitTableCellVertically'`
- * and `'splitTableCellHorizontally'`  editor commands.
- *
- * You can split any cell vertically or horizontally by executing this command. For example, to split the selected table cell vertically:
- *
- * ```ts
- * editor.execute( 'splitTableCellVertically' );
- * ```
- */
+* The split cell command.
+*
+* The command is registered by {@link module:table/tableediting~TableEditing} as the `'splitTableCellVertically'`
+* and `'splitTableCellHorizontally'`  editor commands.
+*
+* You can split any cell vertically or horizontally by executing this command. For example, to split the selected table cell vertically:
+*
+* ```ts
+* editor.execute( 'splitTableCellVertically' );
+* ```
+*/
 export declare class SplitCellCommand extends Command {
-    /**
-     * The direction that indicates which cell will be split.
-     */
-    readonly direction: 'horizontally' | 'vertically';
-    /**
-     * Creates a new `SplitCellCommand` instance.
-     *
-     * @param editor The editor on which this command will be used.
-     * @param options.direction Indicates whether the command should split cells `'horizontally'` or `'vertically'`.
-     */
-    constructor(editor: Editor, options?: {
-        direction?: 'horizontally' | 'vertically';
-    });
-    /**
-     * @inheritDoc
-     */
-    refresh(): void;
-    /**
-     * @inheritDoc
-     */
-    execute(): void;
+	/**
+	* The direction that indicates which cell will be split.
+	*/
+	readonly direction: "horizontally" | "vertically";
+	/**
+	* Creates a new `SplitCellCommand` instance.
+	*
+	* @param editor The editor on which this command will be used.
+	* @param options.direction Indicates whether the command should split cells `'horizontally'` or `'vertically'`.
+	*/
+	constructor(editor: Editor, options?: {
+		direction?: "horizontally" | "vertically";
+	});
+	/**
+	* @inheritDoc
+	*/
+	override refresh(): void;
+	/**
+	* @inheritDoc
+	*/
+	override execute(): void;
 }

package/dist/converters/downcast.d.ts

@@ -1,102 +1,102 @@
 /**
- * @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
- */
+* @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/downcast
- */
-import { type Editor } from '@ckeditor/ckeditor5-core';
-import type { ViewElement, ModelElement, DowncastElementCreatorFunction, DowncastConversionApi } from '@ckeditor/ckeditor5-engine';
-import { TableUtils } from '../tableutils.js';
-import type { TableConversionAdditionalSlot } from '../tableediting.js';
+* @module table/converters/downcast
+*/
+import { type Editor } from "@ckeditor/ckeditor5-core";
+import type { ViewElement, ModelElement, DowncastElementCreatorFunction, DowncastConversionApi } from "@ckeditor/ckeditor5-engine";
+import { TableUtils } from "../tableutils.js";
+import type { TableConversionAdditionalSlot } from "../tableediting.js";
 /**
- * Model table element to view table element conversion helper.
- *
- * @internal
- */
+* Model table element to view table element conversion helper.
+*
+* @internal
+*/
 export declare function downcastTable(tableUtils: TableUtils, options: DowncastTableOptions): DowncastElementCreatorFunction;
 /**
- * Model table row element to view `<tr>` element conversion helper.
- *
- * @internal
- * @returns Element creator.
- */
+* Model table row element to view `<tr>` element conversion helper.
+*
+* @internal
+* @returns Element creator.
+*/
 export declare function downcastRow(): DowncastElementCreatorFunction;
 /**
- * Model table cell element to view `<td>` or `<th>` element conversion helper.
- *
- * This conversion helper will create proper `<th>` elements for table cells that are in the heading section (heading row or column)
- * and `<td>` otherwise.
- *
- * @internal
- * @param options.asWidget If set to `true`, the downcast conversion will produce a widget.
- * @param options.cellTypeEnabled If returns `true`, the downcast conversion will use the `tableCellType` attribute to determine cell type.
- * @returns Element creator.
- */
+* Model table cell element to view `<td>` or `<th>` element conversion helper.
+*
+* This conversion helper will create proper `<th>` elements for table cells that are in the heading section (heading row or column)
+* and `<td>` otherwise.
+*
+* @internal
+* @param options.asWidget If set to `true`, the downcast conversion will produce a widget.
+* @param options.cellTypeEnabled If returns `true`, the downcast conversion will use the `tableCellType` attribute to determine cell type.
+* @returns Element creator.
+*/
 export declare function downcastCell(options: {
-    asWidget?: boolean;
-    cellTypeEnabled: () => boolean;
+	asWidget?: boolean;
+	cellTypeEnabled: () => boolean;
 }): DowncastElementCreatorFunction;
 /**
- * Overrides paragraph inside table cell conversion.
- *
- * This converter:
- * * should be used to override default paragraph conversion.
- * * It will only convert `<paragraph>` placed directly inside `<tableCell>`.
- * * For a single paragraph without attributes it returns `<span>` to simulate data table.
- * * For all other cases it returns `<p>` element.
- *
- * @internal
- * @param options.asWidget If set to `true`, the downcast conversion will produce a widget.
- * @returns Element creator.
- */
+* Overrides paragraph inside table cell conversion.
+*
+* This converter:
+* * should be used to override default paragraph conversion.
+* * It will only convert `<paragraph>` placed directly inside `<tableCell>`.
+* * For a single paragraph without attributes it returns `<span>` to simulate data table.
+* * For all other cases it returns `<p>` element.
+*
+* @internal
+* @param options.asWidget If set to `true`, the downcast conversion will produce a widget.
+* @returns Element creator.
+*/
 export declare function convertParagraphInTableCell(options?: {
-    asWidget?: boolean;
+	asWidget?: boolean;
 }): DowncastElementCreatorFunction;
 /**
- * Checks if given model `<paragraph>` is an only child of a parent (`<tableCell>`) and if it has any attribute set.
- *
- * The paragraph should be converted in the editing view to:
- *
- * * If returned `true` - to a `<span class="ck-table-bogus-paragraph">`
- * * If returned `false` - to a `<p>`
- *
- * @internal
- */
+* Checks if given model `<paragraph>` is an only child of a parent (`<tableCell>`) and if it has any attribute set.
+*
+* The paragraph should be converted in the editing view to:
+*
+* * If returned `true` - to a `<span class="ck-table-bogus-paragraph">`
+* * If returned `false` - to a `<p>`
+*
+* @internal
+*/
 export declare function isSingleParagraphWithoutAttributes(modelElement: ModelElement): boolean;
 /**
- * Downcasts a plain table (also used in the clipboard pipeline).
- */
+* Downcasts a plain table (also used in the clipboard pipeline).
+*/
 export declare function convertPlainTable(editor: Editor): DowncastElementCreatorFunction;
 /**
- * Downcasts a plain table caption (also used in the clipboard pipeline).
- */
+* Downcasts a plain table caption (also used in the clipboard pipeline).
+*/
 export declare function convertPlainTableCaption(editor: Editor): DowncastElementCreatorFunction;
 /**
- * Downcasts a plain table.
- *
- * @param table Table model element.
- * @param conversionApi The conversion API object.
- * @param editor The editor instance.
- * @returns Created element.
- */
+* Downcasts a plain table.
+*
+* @param table Table model element.
+* @param conversionApi The conversion API object.
+* @param editor The editor instance.
+* @returns Created element.
+*/
 export declare function downcastPlainTable(table: ModelElement, conversionApi: DowncastConversionApi, editor: Editor): ViewElement;
 /**
- * Registers border and background attributes converters for plain tables or when the clipboard pipeline is used.
- */
+* Registers border and background attributes converters for plain tables or when the clipboard pipeline is used.
+*/
 export declare function downcastTableBorderAndBackgroundAttributes(editor: Editor): void;
 /**
- * Options for the downcast table conversion.
- *
- * @internal
- */
+* Options for the downcast table conversion.
+*
+* @internal
+*/
 export interface DowncastTableOptions {
-    /**
-     * If set to `true`, the downcast conversion will produce a widget.
-     */
-    asWidget?: boolean;
-    /**
-     * Array of additional slot handlers.
-     */
-    additionalSlots: Array<TableConversionAdditionalSlot>;
+	/**
+	* If set to `true`, the downcast conversion will produce a widget.
+	*/
+	asWidget?: boolean;
+	/**
+	* Array of additional slot handlers.
+	*/
+	additionalSlots: Array<TableConversionAdditionalSlot>;
 }

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

@@ -1,22 +1,22 @@
 /**
- * @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
- */
+* @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-caption-post-fixer
- */
-import type { Model } from '@ckeditor/ckeditor5-engine';
+* @module table/converters/table-caption-post-fixer
+*/
+import type { Model } from "@ckeditor/ckeditor5-engine";
 /**
- * Injects a table caption post-fixer into the model.
- *
- * The role of the table caption post-fixer is to ensure that the table with caption have the correct structure
- * after a {@link module:engine/model/model~Model#change `change()`} block was executed.
- *
- * The correct structure means that:
- *
- * * If there are many caption model element, they are merged into one model.
- * * A final, merged caption model is placed at the end of the table.
- *
- * @internal
- */
+* Injects a table caption post-fixer into the model.
+*
+* The role of the table caption post-fixer is to ensure that the table with caption have the correct structure
+* after a {@link module:engine/model/model~Model#change `change()`} block was executed.
+*
+* The correct structure means that:
+*
+* * If there are many caption model element, they are merged into one model.
+* * A final, merged caption model is placed at the end of the table.
+*
+* @internal
+*/
 export declare function injectTableCaptionPostFixer(model: Model): void;

package/dist/converters/table-cell-paragraph-post-fixer.d.ts

@@ -1,34 +1,34 @@
 /**
- * @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
- */
+* @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-cell-paragraph-post-fixer
- */
-import type { Model } from '@ckeditor/ckeditor5-engine';
+* @module table/converters/table-cell-paragraph-post-fixer
+*/
+import type { Model } from "@ckeditor/ckeditor5-engine";
 /**
- * Injects a table cell post-fixer into the model which inserts a `paragraph` element into empty table cells.
- *
- * A table cell must contain at least one block element as a child. An empty table cell will have an empty `paragraph` as a child.
- *
- * ```xml
- * <table>
- *   <tableRow>
- *      <tableCell></tableCell>
- *   </tableRow>
- * </table>
- * ```
- *
- * Will be fixed to:
- *
- * ```xml
- * <table>
- *   <tableRow>
- *      <tableCell><paragraph></paragraph></tableCell>
- *   </tableRow>
- * </table>
- * ```
- *
- * @internal
- */
+* Injects a table cell post-fixer into the model which inserts a `paragraph` element into empty table cells.
+*
+* A table cell must contain at least one block element as a child. An empty table cell will have an empty `paragraph` as a child.
+*
+* ```xml
+* <table>
+*   <tableRow>
+*      <tableCell></tableCell>
+*   </tableRow>
+* </table>
+* ```
+*
+* Will be fixed to:
+*
+* ```xml
+* <table>
+*   <tableRow>
+*      <tableCell><paragraph></paragraph></tableCell>
+*   </tableRow>
+* </table>
+* ```
+*
+* @internal
+*/
 export declare function injectTableCellParagraphPostFixer(model: Model): void;

package/dist/converters/table-cell-refresh-handler.d.ts

@@ -1,20 +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
- */
+* @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-cell-refresh-handler
- */
-import type { EditingController, Model } from '@ckeditor/ckeditor5-engine';
+* @module table/converters/table-cell-refresh-handler
+*/
+import type { EditingController, Model } from "@ckeditor/ckeditor5-engine";
 /**
- * A table cell refresh handler which marks the table cell in the differ to have it re-rendered.
- *
- * Model `paragraph` inside a table cell can be rendered as `<span>` or `<p>`. It is rendered as `<span>` if this is the only block
- * element in that table cell and it does not have any attributes. It is rendered as `<p>` otherwise.
- *
- * When table cell content changes, for example a second `paragraph` element is added, we need to ensure that the first `paragraph` is
- * re-rendered so it changes from `<span>` to `<p>`. The easiest way to do it is to re-render the entire table cell.
- *
- * @internal
- */
+* A table cell refresh handler which marks the table cell in the differ to have it re-rendered.
+*
+* Model `paragraph` inside a table cell can be rendered as `<span>` or `<p>`. It is rendered as `<span>` if this is the only block
+* element in that table cell and it does not have any attributes. It is rendered as `<p>` otherwise.
+*
+* When table cell content changes, for example a second `paragraph` element is added, we need to ensure that the first `paragraph` is
+* re-rendered so it changes from `<span>` to `<p>`. The easiest way to do it is to re-render the entire table cell.
+*
+* @internal
+*/
 export declare function tableCellRefreshHandler(model: Model, editing: EditingController): void;