@ckeditor/ckeditor5-table 48.8.1-alpha.4 → 49.0.0-alpha.0

package/dist/ui/inserttableview.d.ts

@@ -1,83 +1,82 @@
 /**
- * @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/ui/inserttableview
- */
-import { View, ButtonView, type ViewCollection } from '@ckeditor/ckeditor5-ui';
-import { KeystrokeHandler, FocusTracker, type Locale } from '@ckeditor/ckeditor5-utils';
-import './../../theme/inserttable.css';
+* @module table/ui/inserttableview
+*/
+import { View, ButtonView, type ViewCollection } from "@ckeditor/ckeditor5-ui";
+import { KeystrokeHandler, FocusTracker, type Locale } from "@ckeditor/ckeditor5-utils";
 /**
- * The table size view.
- *
- * It renders a 10x10 grid to choose the inserted table size.
- *
- * @internal
- */
+* The table size view.
+*
+* It renders a 10x10 grid to choose the inserted table size.
+*
+* @internal
+*/
 export declare class InsertTableView extends View {
-    /**
-     * A collection of table size box items.
-     */
-    readonly items: ViewCollection<ButtonView>;
-    /**
-     * Listen to `keydown` events fired in this view's main element.
-     */
-    readonly keystrokes: KeystrokeHandler;
-    /**
-     * Tracks information about the DOM focus in the grid.
-     */
-    readonly focusTracker: FocusTracker;
-    /**
-     * The currently selected number of rows of the new table.
-     *
-     * @observable
-     */
-    rows: number;
-    /**
-     * The currently selected number of columns of the new table.
-     *
-     * @observable
-     */
-    columns: number;
-    /**
-     * The label text displayed under the boxes.
-     *
-     * @observable
-     */
-    label: string;
-    /**
-     * @inheritDoc
-     */
-    constructor(locale: Locale);
-    render(): void;
-    /**
-     * Resets the rows and columns selection.
-     */
-    reset(): void;
-    /**
-     * @inheritDoc
-     */
-    focus(): void;
-    /**
-     * @inheritDoc
-     */
-    focusLast(): void;
-    /**
-     * Highlights grid boxes depending on rows and columns selected.
-     */
-    private _highlightGridBoxes;
-    /**
-     * Creates a new Button for the grid.
-     *
-     * @param locale The locale instance.
-     * @param row Row number.
-     * @param column Column number.
-     * @param label The grid button label.
-     */
-    private _createGridButton;
-    /**
-     * @returns A view collection containing boxes to be placed in a table grid.
-     */
-    private _createGridCollection;
+	/**
+	* A collection of table size box items.
+	*/
+	readonly items: ViewCollection<ButtonView>;
+	/**
+	* Listen to `keydown` events fired in this view's main element.
+	*/
+	readonly keystrokes: KeystrokeHandler;
+	/**
+	* Tracks information about the DOM focus in the grid.
+	*/
+	readonly focusTracker: FocusTracker;
+	/**
+	* The currently selected number of rows of the new table.
+	*
+	* @observable
+	*/
+	rows: number;
+	/**
+	* The currently selected number of columns of the new table.
+	*
+	* @observable
+	*/
+	columns: number;
+	/**
+	* The label text displayed under the boxes.
+	*
+	* @observable
+	*/
+	label: string;
+	/**
+	* @inheritDoc
+	*/
+	constructor(locale: Locale);
+	override render(): void;
+	/**
+	* Resets the rows and columns selection.
+	*/
+	reset(): void;
+	/**
+	* @inheritDoc
+	*/
+	focus(): void;
+	/**
+	* @inheritDoc
+	*/
+	focusLast(): void;
+	/**
+	* Highlights grid boxes depending on rows and columns selected.
+	*/
+	private _highlightGridBoxes;
+	/**
+	* Creates a new Button for the grid.
+	*
+	* @param locale The locale instance.
+	* @param row Row number.
+	* @param column Column number.
+	* @param label The grid button label.
+	*/
+	private _createGridButton;
+	/**
+	* @returns A view collection containing boxes to be placed in a table grid.
+	*/
+	private _createGridCollection;
 }

package/dist/utils/common.d.ts

@@ -1,78 +1,84 @@
 /**
- * @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/utils/common
- */
-import type { Editor } from '@ckeditor/ckeditor5-core';
-import type { Conversion, ModelElement, ModelItem, ModelPosition, ModelSchema, ModelWriter, ModelDocumentSelection } from '@ckeditor/ckeditor5-engine';
-import { type TableUtils } from '../tableutils.js';
+* @module table/utils/common
+*/
+import type { Editor } from "@ckeditor/ckeditor5-core";
+import type { Conversion, ModelElement, ModelItem, ModelPosition, ModelSchema, ModelWriter, ModelDocumentSelection } from "@ckeditor/ckeditor5-engine";
+import { type TableUtils } from "../tableutils.js";
 /**
- * A common method to update the numeric value. If a value is the default one, it will be unset.
- *
- * @internal
- * @param key An attribute key.
- * @param value The new attribute value.
- * @param item A model item on which the attribute will be set.
- * @param defaultValue The default attribute value. If a value is lower or equal, it will be unset.
- */
+* A common method to update the numeric value. If a value is the default one, it will be unset.
+*
+* @internal
+* @param key An attribute key.
+* @param value The new attribute value.
+* @param item A model item on which the attribute will be set.
+* @param defaultValue The default attribute value. If a value is lower or equal, it will be unset.
+*/
 export declare function updateNumericAttribute(key: string, value: unknown, item: ModelItem, writer: ModelWriter, defaultValue?: unknown): void;
 /**
- * A common method to create an empty table cell. It creates a proper model structure as a table cell must have at least one block inside.
- *
- * @internal
- * @param writer The model writer.
- * @param insertPosition The position at which the table cell should be inserted.
- * @param attributes The element attributes.
- * @returns Created table cell.
- */
+* A common method to create an empty table cell. It creates a proper model structure as a table cell must have at least one block inside.
+*
+* @internal
+* @param writer The model writer.
+* @param insertPosition The position at which the table cell should be inserted.
+* @param attributes The element attributes.
+* @returns Created table cell.
+*/
 export declare function createEmptyTableCell(writer: ModelWriter, insertPosition: ModelPosition, attributes?: Record<string, unknown>): ModelElement;
 /**
- * Checks if a table cell belongs to the heading column section.
- *
- * @internal
- */
+* Checks if a table cell belongs to the heading column section.
+*
+* @internal
+*/
 export declare function isHeadingColumnCell(tableUtils: TableUtils, tableCell: ModelElement): boolean;
 /**
- * Enables conversion for an attribute for simple view-model mappings.
- *
- * @internal
- * @param options.defaultValue The default value for the specified `modelAttribute`.
- */
+* Enables conversion for an attribute for simple view-model mappings.
+*
+* @internal
+* @param options.defaultValue The default value for the specified `modelAttribute`.
+*/
 export declare function enableProperty(schema: ModelSchema, conversion: Conversion, options: {
-    modelAttribute: string;
-    styleName: string;
-    attributeName?: string;
-    attributeType?: 'length' | 'color';
-    defaultValue: string;
-    reduceBoxSides?: boolean;
+	modelAttribute: string;
+	styleName: string;
+	attributeName?: string;
+	attributeType?: "length" | "color";
+	defaultValue: string;
+	reduceBoxSides?: boolean;
 }): void;
 /**
- * Depending on the position of the selection we either return the table under cursor or look for the table higher in the hierarchy.
- *
- * @internal
- */
+* Depending on the position of the selection we either return the table under cursor or look for the table higher in the hierarchy.
+*
+* @internal
+*/
 export declare function getSelectionAffectedTable(selection: ModelDocumentSelection): ModelElement;
 /**
- * Groups table cells by their parent table.
- *
- * @internal
- */
+* 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
- */
+* 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;
+	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
- */
+* 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;
+/**
+* Yields every empty block (typically a `paragraph`) found inside the given table's cells.
+*
+* @internal
+*/
+export declare function getEmptyTableCellBlocks(table: ModelElement): IterableIterator<ModelElement>;