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

package/dist/tablecolumnresize/tablecolumnresizeediting.d.ts

@@ -1,188 +1,188 @@
 /**
- * @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 { Plugin, type Editor } from '@ckeditor/ckeditor5-core';
-import type { ModelElement } from '@ckeditor/ckeditor5-engine';
-import { TableEditing } from '../tableediting.js';
-import { TableUtils } from '../tableutils.js';
+* @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 { Plugin, type Editor, type PluginDependenciesOf } from "@ckeditor/ckeditor5-core";
+import type { ModelElement } from "@ckeditor/ckeditor5-engine";
+import { TableEditing } from "../tableediting.js";
+import { TableUtils } from "../tableutils.js";
 /**
- * The table column resize editing plugin.
- */
+* The table column resize editing plugin.
+*/
 export declare class TableColumnResizeEditing extends Plugin {
-    /**
-     * A flag indicating if the column resizing is in progress.
-     */
-    private _isResizingActive;
-    /**
-     * A flag indicating if the column resizing is allowed. It is not allowed if the editor is in read-only
-     * or comments-only mode or the `TableColumnResize` plugin is disabled.
-     *
-     * @observable
-     * @internal
-     */
-    _isResizingAllowed: boolean;
-    /**
-     * A temporary storage for the required data needed to correctly calculate the widths of the resized columns. This storage is
-     * initialized when column resizing begins, and is purged upon completion.
-     */
-    private _resizingData;
-    /**
-     * DOM emitter.
-     */
-    private _domEmitter;
-    /**
-     * A local reference to the {@link module:table/tableutils~TableUtils} plugin.
-     */
-    private _tableUtilsPlugin;
-    /**
-     * Starting mouse position data used to add a threshold to the resizing process.
-     */
-    private _initialMouseEventData;
-    /**
-     * @inheritDoc
-     */
-    static get requires(): readonly [typeof TableEditing, typeof TableUtils];
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "TableColumnResizeEditing";
-    /**
-     * @inheritDoc
-     * @internal
-     */
-    static get licenseFeatureCode(): string;
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    static get isPremiumPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    constructor(editor: Editor);
-    /**
-     * @inheritDoc
-     */
-    init(): void;
-    /**
-     * @inheritDoc
-     */
-    destroy(): void;
-    /**
-     * Returns a 'tableColumnGroup' element from the 'table'.
-     *
-     * @param element A 'table' or 'tableColumnGroup' element.
-     * @returns A 'tableColumnGroup' element.
-     */
-    getColumnGroupElement(element: ModelElement): ModelElement | undefined;
-    /**
-     * Returns an array of 'tableColumn' elements.
-     *
-     * @param element A 'table' or 'tableColumnGroup' element.
-     * @returns An array of 'tableColumn' elements.
-     */
-    getTableColumnElements(element: ModelElement): Array<ModelElement>;
-    /**
-     * Returns an array of table column widths.
-     *
-     * @param element A 'table' or 'tableColumnGroup' element.
-     * @returns An array of table column widths.
-     */
-    getTableColumnsWidths(element: ModelElement): Array<string>;
-    /**
-     * Registers new attributes for a table model element.
-     */
-    private _extendSchema;
-    /**
-     * Registers table column resize post-fixer.
-     *
-     * It checks if the change from the differ concerns a table-related element or attribute. For detected changes it:
-     *  * Adjusts the `columnWidths` attribute to guarantee that the sum of the widths from all columns is 100%.
-     *  * Checks if the `columnWidths` attribute gets updated accordingly after columns have been added or removed.
-     */
-    private _registerPostFixer;
-    /**
-     * Registers table column resize converters.
-     */
-    private _registerConverters;
-    /**
-     * Registers listeners to handle resizing process.
-     */
-    private _registerResizingListeners;
-    /**
-     * Calculate and set `top` and `bottom` styles to the column resizer element to fit the height of the table.
-     *
-     * @param viewResizer The column resizer element.
-     */
-    private _recalculateResizerElement;
-    /**
-     * Remove `top` and `bottom` styles of the column resizer element.
-     *
-     * @param viewResizer The column resizer element.
-     */
-    private _resetResizerStyles;
-    /**
-     * Handles the `mouseover` event on column resizer element.
-     * Recalculates the `top` and `bottom` styles of the column resizer element to fit the height of the table.
-     *
-     * @param eventInfo An object containing information about the fired event.
-     * @param domEventData The data related to the DOM event.
-     */
-    private _onMouseOverHandler;
-    /**
-     * Handles the `mouseout` event on column resizer element.
-     * When resizing is not active, it resets the `top` and `bottom` styles of the column resizer element.
-     *
-     * @param eventInfo An object containing information about the fired event.
-     * @param domEventData The data related to the DOM event.
-     */
-    private _onMouseOutHandler;
-    /**
-     * Handles the `mousedown` event on column resizer element:
-     *  * calculates the initial column pixel widths,
-     *  * inserts the `<colgroup>` element if it is not present in the `<table>`,
-     *  * puts the necessary data in the temporary storage,
-     *  * applies the attributes to the `<table>` view element.
-     *
-     * @param eventInfo An object containing information about the fired event.
-     * @param domEventData The data related to the DOM event.
-     */
-    private _onMouseDownHandler;
-    /**
-     * Starts the resizing process after the threshold is reached.
-     */
-    private _startResizingAfterThreshold;
-    /**
-     * Handles the `mousemove` event.
-     *  * If resizing process is not in progress, it does nothing.
-     *  * If resizing is active but not allowed, it stops the resizing process instantly calling the `mousedown` event handler.
-     *  * Otherwise it dynamically updates the widths of the resized columns.
-     *
-     * @param eventInfo An object containing information about the fired event.
-     * @param mouseEventData The native DOM event.
-     */
-    private _onMouseMoveHandler;
-    /**
-     * Handles the `mouseup` event.
-     *  * If resizing process is not in progress, it does nothing.
-     *  * If resizing is active but not allowed, it cancels the resizing process restoring the original widths.
-     *  * Otherwise it propagates the changes from view to the model by executing the adequate commands.
-     */
-    private _onMouseUpHandler;
-    /**
-     * Retrieves and returns required data needed for the resizing process.
-     *
-     * @param domEventData The data of the `mousedown` event.
-     * @param columnWidths The current widths of the columns.
-     * @returns The data needed for the resizing process.
-     */
-    private _getResizingData;
-    /**
-     * Registers a listener ensuring that each resizable cell have a resizer handle.
-     */
-    private _registerResizerInserter;
+	/**
+	* A flag indicating if the column resizing is in progress.
+	*/
+	private _isResizingActive;
+	/**
+	* A flag indicating if the column resizing is allowed. It is not allowed if the editor is in read-only
+	* or comments-only mode or the `TableColumnResize` plugin is disabled.
+	*
+	* @observable
+	* @internal
+	*/
+	_isResizingAllowed: boolean;
+	/**
+	* A temporary storage for the required data needed to correctly calculate the widths of the resized columns. This storage is
+	* initialized when column resizing begins, and is purged upon completion.
+	*/
+	private _resizingData;
+	/**
+	* DOM emitter.
+	*/
+	private _domEmitter;
+	/**
+	* A local reference to the {@link module:table/tableutils~TableUtils} plugin.
+	*/
+	private _tableUtilsPlugin;
+	/**
+	* Starting mouse position data used to add a threshold to the resizing process.
+	*/
+	private _initialMouseEventData;
+	/**
+	* @inheritDoc
+	*/
+	static get requires(): PluginDependenciesOf<[TableEditing, TableUtils]>;
+	/**
+	* @inheritDoc
+	*/
+	static get pluginName(): "TableColumnResizeEditing";
+	/**
+	* @inheritDoc
+	* @internal
+	*/
+	static get licenseFeatureCode(): string;
+	/**
+	* @inheritDoc
+	*/
+	static override get isOfficialPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	static override get isPremiumPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	constructor(editor: Editor);
+	/**
+	* @inheritDoc
+	*/
+	init(): void;
+	/**
+	* @inheritDoc
+	*/
+	override destroy(): void;
+	/**
+	* Returns a 'tableColumnGroup' element from the 'table'.
+	*
+	* @param element A 'table' or 'tableColumnGroup' element.
+	* @returns A 'tableColumnGroup' element.
+	*/
+	getColumnGroupElement(element: ModelElement): ModelElement | undefined;
+	/**
+	* Returns an array of 'tableColumn' elements.
+	*
+	* @param element A 'table' or 'tableColumnGroup' element.
+	* @returns An array of 'tableColumn' elements.
+	*/
+	getTableColumnElements(element: ModelElement): Array<ModelElement>;
+	/**
+	* Returns an array of table column widths.
+	*
+	* @param element A 'table' or 'tableColumnGroup' element.
+	* @returns An array of table column widths.
+	*/
+	getTableColumnsWidths(element: ModelElement): Array<string>;
+	/**
+	* Registers new attributes for a table model element.
+	*/
+	private _extendSchema;
+	/**
+	* Registers table column resize post-fixer.
+	*
+	* It checks if the change from the differ concerns a table-related element or attribute. For detected changes it:
+	*  * Adjusts the `columnWidths` attribute to guarantee that the sum of the widths from all columns is 100%.
+	*  * Checks if the `columnWidths` attribute gets updated accordingly after columns have been added or removed.
+	*/
+	private _registerPostFixer;
+	/**
+	* Registers table column resize converters.
+	*/
+	private _registerConverters;
+	/**
+	* Registers listeners to handle resizing process.
+	*/
+	private _registerResizingListeners;
+	/**
+	* Calculate and set `top` and `bottom` styles to the column resizer element to fit the height of the table.
+	*
+	* @param viewResizer The column resizer element.
+	*/
+	private _recalculateResizerElement;
+	/**
+	* Remove `top` and `bottom` styles of the column resizer element.
+	*
+	* @param viewResizer The column resizer element.
+	*/
+	private _resetResizerStyles;
+	/**
+	* Handles the `mouseover` event on column resizer element.
+	* Recalculates the `top` and `bottom` styles of the column resizer element to fit the height of the table.
+	*
+	* @param eventInfo An object containing information about the fired event.
+	* @param domEventData The data related to the DOM event.
+	*/
+	private _onMouseOverHandler;
+	/**
+	* Handles the `mouseout` event on column resizer element.
+	* When resizing is not active, it resets the `top` and `bottom` styles of the column resizer element.
+	*
+	* @param eventInfo An object containing information about the fired event.
+	* @param domEventData The data related to the DOM event.
+	*/
+	private _onMouseOutHandler;
+	/**
+	* Handles the `mousedown` event on column resizer element:
+	*  * calculates the initial column pixel widths,
+	*  * inserts the `<colgroup>` element if it is not present in the `<table>`,
+	*  * puts the necessary data in the temporary storage,
+	*  * applies the attributes to the `<table>` view element.
+	*
+	* @param eventInfo An object containing information about the fired event.
+	* @param domEventData The data related to the DOM event.
+	*/
+	private _onMouseDownHandler;
+	/**
+	* Starts the resizing process after the threshold is reached.
+	*/
+	private _startResizingAfterThreshold;
+	/**
+	* Handles the `mousemove` event.
+	*  * If resizing process is not in progress, it does nothing.
+	*  * If resizing is active but not allowed, it stops the resizing process instantly calling the `mousedown` event handler.
+	*  * Otherwise it dynamically updates the widths of the resized columns.
+	*
+	* @param eventInfo An object containing information about the fired event.
+	* @param mouseEventData The native DOM event.
+	*/
+	private _onMouseMoveHandler;
+	/**
+	* Handles the `mouseup` event.
+	*  * If resizing process is not in progress, it does nothing.
+	*  * If resizing is active but not allowed, it cancels the resizing process restoring the original widths.
+	*  * Otherwise it propagates the changes from view to the model by executing the adequate commands.
+	*/
+	private _onMouseUpHandler;
+	/**
+	* Retrieves and returns required data needed for the resizing process.
+	*
+	* @param domEventData The data of the `mousedown` event.
+	* @param columnWidths The current widths of the columns.
+	* @returns The data needed for the resizing process.
+	*/
+	private _getResizingData;
+	/**
+	* Registers a listener ensuring that each resizable cell have a resizer handle.
+	*/
+	private _registerResizerInserter;
 }

package/dist/tablecolumnresize/tablewidthscommand.d.ts

@@ -1,38 +1,38 @@
 /**
- * @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/tablecolumnresize/tablewidthscommand
- */
-import type { ModelElement } from '@ckeditor/ckeditor5-engine';
-import { Command } from '@ckeditor/ckeditor5-core';
+* @module table/tablecolumnresize/tablewidthscommand
+*/
+import type { ModelElement } from "@ckeditor/ckeditor5-engine";
+import { Command } from "@ckeditor/ckeditor5-core";
 /**
- * Command used by the {@link module:table/tablecolumnresize~TableColumnResize Table column resize feature} that
- * updates the width of the whole table as well as its individual columns.
- */
+* Command used by the {@link module:table/tablecolumnresize~TableColumnResize Table column resize feature} that
+* updates the width of the whole table as well as its individual columns.
+*/
 export declare class TableWidthsCommand extends Command {
-    /**
-     * @inheritDoc
-     */
-    refresh(): void;
-    /**
-     * Updated the `tableWidth` attribute of the table and the `columnWidth` attribute of the columns of that table.
-     */
-    execute(options?: TableWidthsCommandOptions): void;
+	/**
+	* @inheritDoc
+	*/
+	override refresh(): void;
+	/**
+	* Updated the `tableWidth` attribute of the table and the `columnWidth` attribute of the columns of that table.
+	*/
+	override execute(options?: TableWidthsCommandOptions): void;
 }
 export interface TableWidthsCommandOptions {
-    /**
-     * New value of the `columnWidths` attribute. Must be array of strings or string with comma-separated values.
-     * If skipped, the column widths information will be deleted.
-     */
-    columnWidths?: Array<string> | string;
-    /**
-     * The new table width. If skipped, the model attribute will be removed.
-     */
-    tableWidth?: string;
-    /**
-     * The table that is having the columns resized.
-     */
-    table?: ModelElement;
+	/**
+	* New value of the `columnWidths` attribute. Must be array of strings or string with comma-separated values.
+	* If skipped, the column widths information will be deleted.
+	*/
+	columnWidths?: Array<string> | string;
+	/**
+	* The new table width. If skipped, the model attribute will be removed.
+	*/
+	tableWidth?: string;
+	/**
+	* The table that is having the columns resized.
+	*/
+	table?: ModelElement;
 }