@ckeditor/ckeditor5-table 48.2.0 → 48.3.0-alpha.1

package/dist/tableselection.d.ts

@@ -1,111 +1,111 @@
 /**
- * @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/tableselection
- */
-import { Plugin } from '@ckeditor/ckeditor5-core';
-import type { ModelElement, ModelDocumentFragment } from '@ckeditor/ckeditor5-engine';
-import { TableUtils } from './tableutils.js';
-import '../theme/tableselection.css';
+* @module table/tableselection
+*/
+import { Plugin, type PluginDependenciesOf } from "@ckeditor/ckeditor5-core";
+import type { ModelElement, ModelDocumentFragment } from "@ckeditor/ckeditor5-engine";
+import { TableUtils } from "./tableutils.js";
+import "../theme/tableselection.css";
 /**
- * This plugin enables the advanced table cells, rows and columns selection.
- * It is loaded automatically by the {@link module:table/table~Table} plugin.
- */
+* This plugin enables the advanced table cells, rows and columns selection.
+* It is loaded automatically by the {@link module:table/table~Table} plugin.
+*/
 export declare class TableSelection extends Plugin {
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "TableSelection";
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    static get requires(): readonly [typeof TableUtils, typeof TableUtils];
-    /**
-     * @inheritDoc
-     */
-    init(): void;
-    /**
-     * Returns the currently selected table cells or `null` if it is not a table cells selection.
-     */
-    getSelectedTableCells(): Array<ModelElement> | null;
-    /**
-     * Returns the selected table fragment as a document fragment.
-     */
-    getSelectionAsFragment(): ModelDocumentFragment | null;
-    /**
-     * Sets the model selection based on given anchor and target cells (can be the same cell).
-     * Takes care of setting the backward flag.
-     *
-     * ```ts
-     * const modelRoot = editor.model.document.getRoot();
-     * const firstCell = modelRoot.getNodeByPath( [ 0, 0, 0 ] );
-     * const lastCell = modelRoot.getNodeByPath( [ 0, 0, 1 ] );
-     *
-     * const tableSelection = editor.plugins.get( 'TableSelection' );
-     * tableSelection.setCellSelection( firstCell, lastCell );
-     * ```
-     */
-    setCellSelection(anchorCell: ModelElement, targetCell: ModelElement): void;
-    /**
-     * Returns the focus cell from the current selection.
-     */
-    getFocusCell(): ModelElement | null;
-    /**
-     * Returns the anchor cell from the current selection.
-     */
-    getAnchorCell(): ModelElement | null;
-    /**
-     * Defines a selection converter which marks the selected cells with a specific class.
-     *
-     * The real DOM selection is put in the last cell. Since the order of ranges is dependent on whether the
-     * selection is backward or not, the last cell will usually be close to the "focus" end of the selection
-     * (a selection has anchor and focus).
-     *
-     * The real DOM selection is then hidden with CSS.
-     */
-    private _defineSelectionConverter;
-    /**
-     * Creates a listener that reacts to changes in {@link #isEnabled} and, if the plugin was disabled,
-     * it collapses the multi-cell selection to a regular selection placed inside a table cell.
-     *
-     * This listener helps features that disable the table selection plugin bring the selection
-     * to a clear state they can work with (for instance, because they don't support multiple cell selection).
-     */
-    private _enablePluginDisabling;
-    /**
-     * Overrides the default `model.deleteContent()` behavior over a selected table fragment.
-     *
-     * @param args Delete content method arguments.
-     */
-    private _handleDeleteContent;
-    /**
-     * This handler makes it possible to remove the content of all selected cells by starting to type.
-     * If you take a look at {@link #_defineSelectionConverter} you will find out that despite the multi-cell selection being set
-     * in the model, the view selection is collapsed in the last cell (because most browsers are unable to render multi-cell selections;
-     * yes, it's a hack).
-     *
-     * When multiple cells are selected in the model and the user starts to type, the
-     * {@link module:engine/view/document~ViewDocument#event:insertText} event carries information provided by the
-     * beforeinput DOM  event, that in turn only knows about this collapsed DOM selection in the last cell.
-     *
-     * As a result, the selected cells have no chance to be cleaned up. To fix this, this listener intercepts
-     * the event and injects the custom view selection in the data that translates correctly to the actual state
-     * of the multi-cell selection in the model.
-     *
-     * @param data Insert text event data.
-     */
-    private _handleInsertTextEvent;
-    /**
-     * Returns an array of table cells that should be selected based on the
-     * given anchor cell and target (focus) cell.
-     *
-     * The cells are returned in a reverse direction if the selection is backward.
-     */
-    private _getCellsToSelect;
+	/**
+	* @inheritDoc
+	*/
+	static get pluginName(): "TableSelection";
+	/**
+	* @inheritDoc
+	*/
+	static override get isOfficialPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	static get requires(): PluginDependenciesOf<[TableUtils, TableUtils]>;
+	/**
+	* @inheritDoc
+	*/
+	init(): void;
+	/**
+	* Returns the currently selected table cells or `null` if it is not a table cells selection.
+	*/
+	getSelectedTableCells(): Array<ModelElement> | null;
+	/**
+	* Returns the selected table fragment as a document fragment.
+	*/
+	getSelectionAsFragment(): ModelDocumentFragment | null;
+	/**
+	* Sets the model selection based on given anchor and target cells (can be the same cell).
+	* Takes care of setting the backward flag.
+	*
+	* ```ts
+	* const modelRoot = editor.model.document.getRoot();
+	* const firstCell = modelRoot.getNodeByPath( [ 0, 0, 0 ] );
+	* const lastCell = modelRoot.getNodeByPath( [ 0, 0, 1 ] );
+	*
+	* const tableSelection = editor.plugins.get( 'TableSelection' );
+	* tableSelection.setCellSelection( firstCell, lastCell );
+	* ```
+	*/
+	setCellSelection(anchorCell: ModelElement, targetCell: ModelElement): void;
+	/**
+	* Returns the focus cell from the current selection.
+	*/
+	getFocusCell(): ModelElement | null;
+	/**
+	* Returns the anchor cell from the current selection.
+	*/
+	getAnchorCell(): ModelElement | null;
+	/**
+	* Defines a selection converter which marks the selected cells with a specific class.
+	*
+	* The real DOM selection is put in the last cell. Since the order of ranges is dependent on whether the
+	* selection is backward or not, the last cell will usually be close to the "focus" end of the selection
+	* (a selection has anchor and focus).
+	*
+	* The real DOM selection is then hidden with CSS.
+	*/
+	private _defineSelectionConverter;
+	/**
+	* Creates a listener that reacts to changes in {@link #isEnabled} and, if the plugin was disabled,
+	* it collapses the multi-cell selection to a regular selection placed inside a table cell.
+	*
+	* This listener helps features that disable the table selection plugin bring the selection
+	* to a clear state they can work with (for instance, because they don't support multiple cell selection).
+	*/
+	private _enablePluginDisabling;
+	/**
+	* Overrides the default `model.deleteContent()` behavior over a selected table fragment.
+	*
+	* @param args Delete content method arguments.
+	*/
+	private _handleDeleteContent;
+	/**
+	* This handler makes it possible to remove the content of all selected cells by starting to type.
+	* If you take a look at {@link #_defineSelectionConverter} you will find out that despite the multi-cell selection being set
+	* in the model, the view selection is collapsed in the last cell (because most browsers are unable to render multi-cell selections;
+	* yes, it's a hack).
+	*
+	* When multiple cells are selected in the model and the user starts to type, the
+	* {@link module:engine/view/document~ViewDocument#event:insertText} event carries information provided by the
+	* beforeinput DOM  event, that in turn only knows about this collapsed DOM selection in the last cell.
+	*
+	* As a result, the selected cells have no chance to be cleaned up. To fix this, this listener intercepts
+	* the event and injects the custom view selection in the data that translates correctly to the actual state
+	* of the multi-cell selection in the model.
+	*
+	* @param data Insert text event data.
+	*/
+	private _handleInsertTextEvent;
+	/**
+	* Returns an array of table cells that should be selected based on the
+	* given anchor cell and target (focus) cell.
+	*
+	* The cells are returned in a reverse direction if the selection is backward.
+	*/
+	private _getCellsToSelect;
 }

package/dist/tabletoolbar.d.ts

@@ -1,36 +1,36 @@
 /**
- * @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/tabletoolbar
- */
-import { Plugin } from '@ckeditor/ckeditor5-core';
-import { WidgetToolbarRepository } from '@ckeditor/ckeditor5-widget';
+* @module table/tabletoolbar
+*/
+import { Plugin, type PluginDependenciesOf } from "@ckeditor/ckeditor5-core";
+import { WidgetToolbarRepository } from "@ckeditor/ckeditor5-widget";
 /**
- * The table toolbar class. It creates toolbars for the table feature and its content (for now only for the table cell content).
- *
- * The table toolbar shows up when a table widget is selected. Its components (e.g. buttons) are created based on the
- * {@link module:table/tableconfig~TableConfig#tableToolbar `table.tableToolbar` configuration option}.
- *
- * Table content toolbar shows up when the selection is inside the content of a table. It creates its component based on the
- * {@link module:table/tableconfig~TableConfig#contentToolbar `table.contentToolbar` configuration option}.
- */
+* The table toolbar class. It creates toolbars for the table feature and its content (for now only for the table cell content).
+*
+* The table toolbar shows up when a table widget is selected. Its components (e.g. buttons) are created based on the
+* {@link module:table/tableconfig~TableConfig#tableToolbar `table.tableToolbar` configuration option}.
+*
+* Table content toolbar shows up when the selection is inside the content of a table. It creates its component based on the
+* {@link module:table/tableconfig~TableConfig#contentToolbar `table.contentToolbar` configuration option}.
+*/
 export declare class TableToolbar extends Plugin {
-    /**
-     * @inheritDoc
-     */
-    static get requires(): readonly [typeof WidgetToolbarRepository];
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "TableToolbar";
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    afterInit(): void;
+	/**
+	* @inheritDoc
+	*/
+	static get requires(): PluginDependenciesOf<[WidgetToolbarRepository]>;
+	/**
+	* @inheritDoc
+	*/
+	static get pluginName(): "TableToolbar";
+	/**
+	* @inheritDoc
+	*/
+	static override get isOfficialPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	afterInit(): void;
 }

package/dist/tableui.d.ts

@@ -1,58 +1,58 @@
 /**
- * @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/tableui
- */
-import { Plugin } from '@ckeditor/ckeditor5-core';
+* @module table/tableui
+*/
+import { Plugin } from "@ckeditor/ckeditor5-core";
 /**
- * The table UI plugin. It introduces:
- *
- * * The `'insertTable'` dropdown,
- * * The `'menuBar:insertTable'` menu bar menu,
- * * The `'tableColumn'` dropdown,
- * * The `'tableRow'` dropdown,
- * * The `'mergeTableCells'` split button.
- *
- * The `'tableColumn'`, `'tableRow'` and `'mergeTableCells'` dropdowns work best with {@link module:table/tabletoolbar~TableToolbar}.
- */
+* The table UI plugin. It introduces:
+*
+* * The `'insertTable'` dropdown,
+* * The `'menuBar:insertTable'` menu bar menu,
+* * The `'tableColumn'` dropdown,
+* * The `'tableRow'` dropdown,
+* * The `'mergeTableCells'` split button.
+*
+* The `'tableColumn'`, `'tableRow'` and `'mergeTableCells'` dropdowns work best with {@link module:table/tabletoolbar~TableToolbar}.
+*/
 export declare class TableUI extends Plugin {
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "TableUI";
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    init(): void;
-    /**
-     * Creates a dropdown view from a set of options.
-     *
-     * @param label The dropdown button label.
-     * @param icon An icon for the dropdown button.
-     * @param options The list of options for the dropdown.
-     */
-    private _prepareDropdown;
-    /**
-     * Creates a dropdown view with a {@link module:ui/dropdown/button/splitbuttonview~SplitButtonView} for
-     * merge (and split)–related commands.
-     *
-     * @param label The dropdown button label.
-     * @param icon An icon for the dropdown button.
-     * @param options The list of options for the dropdown.
-     */
-    private _prepareMergeSplitButtonDropdown;
-    /**
-     * Injects a {@link module:ui/list/listview~ListView} into the passed dropdown with buttons
-     * which execute editor commands as configured in passed options.
-     *
-     * @param options The list of options for the dropdown.
-     * @returns Commands the list options are interacting with.
-     */
-    private _fillDropdownWithListOptions;
+	/**
+	* @inheritDoc
+	*/
+	static get pluginName(): "TableUI";
+	/**
+	* @inheritDoc
+	*/
+	static override get isOfficialPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	init(): void;
+	/**
+	* Creates a dropdown view from a set of options.
+	*
+	* @param label The dropdown button label.
+	* @param icon An icon for the dropdown button.
+	* @param options The list of options for the dropdown.
+	*/
+	private _prepareDropdown;
+	/**
+	* Creates a dropdown view with a {@link module:ui/dropdown/button/splitbuttonview~SplitButtonView} for
+	* merge (and split)–related commands.
+	*
+	* @param label The dropdown button label.
+	* @param icon An icon for the dropdown button.
+	* @param options The list of options for the dropdown.
+	*/
+	private _prepareMergeSplitButtonDropdown;
+	/**
+	* Injects a {@link module:ui/list/listview~ListView} into the passed dropdown with buttons
+	* which execute editor commands as configured in passed options.
+	*
+	* @param options The list of options for the dropdown.
+	* @returns Commands the list options are interacting with.
+	*/
+	private _fillDropdownWithListOptions;
 }