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

package/dist/tablecellwidth/commands/tablecellwidthcommand.d.ts

@@ -1,46 +1,46 @@
 /**
- * @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/tablecellwidth/commands/tablecellwidthcommand
- */
-import type { Editor } from '@ckeditor/ckeditor5-core';
-import { TableCellPropertyCommand } from '../../tablecellproperties/commands/tablecellpropertycommand.js';
+* @module table/tablecellwidth/commands/tablecellwidthcommand
+*/
+import type { Editor } from "@ckeditor/ckeditor5-core";
+import { TableCellPropertyCommand } from "../../tablecellproperties/commands/tablecellpropertycommand.js";
 /**
- * The table cell width command.
- *
- * The command is registered by the {@link module:table/tablecellwidth/tablecellwidthediting~TableCellWidthEditing} as
- * the `'tableCellWidth'` editor command.
- *
- * To change the width of selected cells, execute the command:
- *
- * ```ts
- * editor.execute( 'tableCellWidth', {
- *   value: '50px'
- * } );
- * ```
- *
- * **Note**: This command adds a default `'px'` unit to numeric values. Executing:
- *
- * ```ts
- * editor.execute( 'tableCellWidth', {
- *   value: '50'
- * } );
- * ```
- *
- * will set the `width` attribute to `'50px'` in the model.
- */
+* The table cell width command.
+*
+* The command is registered by the {@link module:table/tablecellwidth/tablecellwidthediting~TableCellWidthEditing} as
+* the `'tableCellWidth'` editor command.
+*
+* To change the width of selected cells, execute the command:
+*
+* ```ts
+* editor.execute( 'tableCellWidth', {
+*   value: '50px'
+* } );
+* ```
+*
+* **Note**: This command adds a default `'px'` unit to numeric values. Executing:
+*
+* ```ts
+* editor.execute( 'tableCellWidth', {
+*   value: '50'
+* } );
+* ```
+*
+* will set the `width` attribute to `'50px'` in the model.
+*/
 export declare class TableCellWidthCommand extends TableCellPropertyCommand {
-    /**
-     * Creates a new `TableCellWidthCommand` instance.
-     *
-     * @param editor An editor in which this command will be used.
-     * @param defaultValue The default value of the attribute.
-     */
-    constructor(editor: Editor, defaultValue: string);
-    /**
-     * @inheritDoc
-     */
-    _getValueToSet(value: string | number | undefined): unknown;
+	/**
+	* Creates a new `TableCellWidthCommand` instance.
+	*
+	* @param editor An editor in which this command will be used.
+	* @param defaultValue The default value of the attribute.
+	*/
+	constructor(editor: Editor, defaultValue: string);
+	/**
+	* @inheritDoc
+	*/
+	override _getValueToSet(value: string | number | undefined): unknown;
 }

package/dist/tablecellwidth/tablecellwidthediting.d.ts

@@ -1,33 +1,33 @@
 /**
- * @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/tablecellwidth/tablecellwidthediting
- */
-import { Plugin } from '@ckeditor/ckeditor5-core';
-import { TableEditing } from './../tableediting.js';
+* @module table/tablecellwidth/tablecellwidthediting
+*/
+import { Plugin, type PluginDependenciesOf } from "@ckeditor/ckeditor5-core";
+import { TableEditing } from "./../tableediting.js";
 /**
- * The table cell width editing feature.
- *
- * Introduces `tableCellWidth` table cell model attribute alongside with its converters
- * and a command.
- */
+* The table cell width editing feature.
+*
+* Introduces `tableCellWidth` table cell model attribute alongside with its converters
+* and a command.
+*/
 export declare class TableCellWidthEditing extends Plugin {
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "TableCellWidthEditing";
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    static get requires(): readonly [typeof TableEditing];
-    /**
-     * @inheritDoc
-     */
-    init(): void;
+	/**
+	* @inheritDoc
+	*/
+	static get pluginName(): "TableCellWidthEditing";
+	/**
+	* @inheritDoc
+	*/
+	static override get isOfficialPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	static get requires(): PluginDependenciesOf<[TableEditing]>;
+	/**
+	* @inheritDoc
+	*/
+	init(): void;
 }

package/dist/tableclipboard.d.ts

@@ -1,83 +1,83 @@
 /**
- * @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 { ClipboardPipeline, ClipboardMarkersUtils } from '@ckeditor/ckeditor5-clipboard';
-import { Plugin } from '@ckeditor/ckeditor5-core';
-import type { ModelDocumentFragment, ModelElement, ModelItem, Model, ModelPosition, ModelWriter } from '@ckeditor/ckeditor5-engine';
-import { TableSelection } from './tableselection.js';
-import { type TableSlot } from './tablewalker.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 { ClipboardPipeline, ClipboardMarkersUtils } from "@ckeditor/ckeditor5-clipboard";
+import { Plugin, type PluginDependenciesOf } from "@ckeditor/ckeditor5-core";
+import type { ModelDocumentFragment, ModelElement, ModelItem, Model, ModelPosition, ModelWriter } from "@ckeditor/ckeditor5-engine";
+import { TableSelection } from "./tableselection.js";
+import { type TableSlot } from "./tablewalker.js";
+import { TableUtils } from "./tableutils.js";
 /**
- * This plugin adds support for copying/cutting/pasting fragments of tables.
- * It is loaded automatically by the {@link module:table/table~Table} plugin.
- */
+* This plugin adds support for copying/cutting/pasting fragments of tables.
+* It is loaded automatically by the {@link module:table/table~Table} plugin.
+*/
 export declare class TableClipboard extends Plugin {
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "TableClipboard";
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    static get requires(): readonly [typeof ClipboardMarkersUtils, typeof ClipboardPipeline, typeof TableSelection, typeof TableUtils];
-    /**
-     * @inheritDoc
-     */
-    init(): void;
-    /**
-     * Sets up listening for events from the clipboard pipeline to properly handle
-     * table content merging during paste/drop operations.
-     *
-     * When a user is dragging and dropping a table, we want to insert the entire table into
-     * a table cell instead of merging table contents. For paste and other events,
-     * the normal table merge behavior is applied.
-     */
-    private _listenToContentInsertion;
-    /**
-     * Copies table content to a clipboard on "copy" & "cut" events.
-     *
-     * @param evt An object containing information about the handled event.
-     * @param data Clipboard event data.
-     */
-    private _onCopyCut;
-    /**
-     * Overrides default {@link module:engine/model/model~Model#insertContent `model.insertContent()`} method to handle pasting table inside
-     * selected table fragment.
-     *
-     * Depending on selected table fragment:
-     * - If a selected table fragment is smaller than paste table it will crop pasted table to match dimensions.
-     * - If dimensions are equal it will replace selected table fragment with a pasted table contents.
-     *
-     * @param content The content to insert.
-     * @param selectable The selection into which the content should be inserted.
-     * If not provided the current model document selection will be used.
-     */
-    private _onInsertContent;
-    /**
-     * Inserts provided `selectedTableCells` into `pastedTable`.
-     */
-    private _replaceSelectedCells;
-    /**
-     * Replaces the part of selectedTable with pastedTable.
-     */
-    private _replaceSelectedCellsWithPasted;
-    /**
-     * Replaces a single table slot.
-     *
-     * @returns Inserted table cell or null if slot should remain empty.
-     * @private
-     */
-    _replaceTableSlotCell(tableSlot: TableSlot, cellToInsert: ModelElement | null, insertPosition: ModelPosition, writer: ModelWriter): ModelElement | null;
-    /**
-     * Extracts the table for pasting into a table.
-     *
-     * @param content The content to insert.
-     * @param model The editor model.
-     */
-    getTableIfOnlyTableInContent(content: ModelDocumentFragment | ModelItem, model: Model): ModelElement | null;
+	/**
+	* @inheritDoc
+	*/
+	static get pluginName(): "TableClipboard";
+	/**
+	* @inheritDoc
+	*/
+	static override get isOfficialPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	static get requires(): PluginDependenciesOf<[ClipboardMarkersUtils, ClipboardPipeline, TableSelection, TableUtils]>;
+	/**
+	* @inheritDoc
+	*/
+	init(): void;
+	/**
+	* Sets up listening for events from the clipboard pipeline to properly handle
+	* table content merging during paste/drop operations.
+	*
+	* When a user is dragging and dropping a table, we want to insert the entire table into
+	* a table cell instead of merging table contents. For paste and other events,
+	* the normal table merge behavior is applied.
+	*/
+	private _listenToContentInsertion;
+	/**
+	* Copies table content to a clipboard on "copy" & "cut" events.
+	*
+	* @param evt An object containing information about the handled event.
+	* @param data Clipboard event data.
+	*/
+	private _onCopyCut;
+	/**
+	* Overrides default {@link module:engine/model/model~Model#insertContent `model.insertContent()`} method to handle pasting table inside
+	* selected table fragment.
+	*
+	* Depending on selected table fragment:
+	* - If a selected table fragment is smaller than paste table it will crop pasted table to match dimensions.
+	* - If dimensions are equal it will replace selected table fragment with a pasted table contents.
+	*
+	* @param content The content to insert.
+	* @param selectable The selection into which the content should be inserted.
+	* If not provided the current model document selection will be used.
+	*/
+	private _onInsertContent;
+	/**
+	* Inserts provided `selectedTableCells` into `pastedTable`.
+	*/
+	private _replaceSelectedCells;
+	/**
+	* Replaces the part of selectedTable with pastedTable.
+	*/
+	private _replaceSelectedCellsWithPasted;
+	/**
+	* Replaces a single table slot.
+	*
+	* @returns Inserted table cell or null if slot should remain empty.
+	* @private
+	*/
+	_replaceTableSlotCell(tableSlot: TableSlot, cellToInsert: ModelElement | null, insertPosition: ModelPosition, writer: ModelWriter): ModelElement | null;
+	/**
+	* Extracts the table for pasting into a table.
+	*
+	* @param content The content to insert.
+	* @param model The editor model.
+	*/
+	getTableIfOnlyTableInContent(content: ModelDocumentFragment | ModelItem, model: Model): ModelElement | null;
 }

package/dist/tablecolumnresize/commands/tablecolumnwidthcommand.d.ts

@@ -0,0 +1,56 @@
+/**
+* @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/commands/tablecolumnwidthcommand
+*/
+import { Command } from "@ckeditor/ckeditor5-core";
+import type { Batch } from "@ckeditor/ckeditor5-engine";
+/**
+* The table column width command.
+*
+* The command is registered by the {@link module:table/tablecolumnresize/tablecolumnresizeediting~TableColumnResizeEditing}
+* as the `'tableColumnWidth'` editor command.
+*
+* It sets the width of every column covered by the selected cells (keeping the whole table's width mode consistent),
+* so the change actually takes effect in a resized table - where a per-cell width would be shadowed by the column
+* group. The command is enabled whenever the selection maps onto the columns of a resized, regular table.
+*
+* ```ts
+* editor.execute( 'tableColumnWidth', {
+*   value: '150px'
+* } );
+* ```
+*
+* **Note**: This command adds a default `'px'` unit to numeric values. Executing:
+*
+* ```ts
+* editor.execute( 'tableColumnWidth', {
+*   value: '150'
+* } );
+* ```
+*
+* will set the column width to `'150px'`.
+*/
+export declare class TableColumnWidthCommand extends Command {
+	/**
+	* The width of the first column covered by the selection, or `null` when the selection does not map onto table
+	* columns (for example when there is no cell selected or the table is not resized).
+	*
+	* @readonly
+	* @observable
+	*/
+	value: string | null;
+	/**
+	* @inheritDoc
+	*/
+	override refresh(): void;
+	/**
+	* @inheritDoc
+	*/
+	override execute(options?: {
+		value?: string | number;
+		batch?: Batch;
+	}): void;
+}

package/dist/tablecolumnresize/constants.d.ts

@@ -1,33 +1,48 @@
 /**
- * @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/constants
- */
-/**
- * The minimum column width given as a percentage value. Used in situations when the table is not yet rendered, so it is impossible to
- * calculate how many percentage of the table width would be {@link ~COLUMN_MIN_WIDTH_IN_PIXELS minimum column width in pixels}.
- *
- * @internal
- */
+* @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/constants
+*/
+/**
+* The minimum column width given as a percentage value. Used in situations when the table is not yet rendered, so it is impossible to
+* calculate how many percentage of the table width would be {@link ~COLUMN_MIN_WIDTH_IN_PIXELS minimum column width in pixels}.
+*
+* @internal
+*/
 export declare const COLUMN_MIN_WIDTH_AS_PERCENTAGE = 5;
 /**
- * The minimum column width in pixels when the maximum table width is known.
- * This value is an equivalent of `10%` of the default editor width (600px).
- *
- * @internal
- */
+* The minimum column width in pixels when the maximum table width is known.
+* This value is an equivalent of `10%` of the default editor width (600px).
+*
+* @internal
+*/
 export declare const COLUMN_MIN_WIDTH_IN_PIXELS = 40;
 /**
- * Determines how many digits after the decimal point are used to store the column width as a percentage value.
- *
- * @internal
- */
+* Determines how many digits after the decimal point are used to store the column width as a percentage value.
+*
+* @internal
+*/
 export declare const COLUMN_WIDTH_PRECISION = 2;
 /**
- * The distance in pixels that the mouse has to move to start resizing the column.
- *
- * @internal
- */
+* The distance in pixels that the mouse has to move to start resizing the column.
+*
+* @internal
+*/
 export declare const COLUMN_RESIZE_DISTANCE_THRESHOLD = 3;
+/**
+* The distance (in pixels) around the container's width within which a dragged table edge snaps to exactly
+* 100% of the container width, in either direction - making it easy to precisely land on that value.
+*
+* @internal
+*/
+export declare const TABLE_WIDTH_SNAP_THRESHOLD_IN_PIXELS = 5;
+/**
+* How much further (in pixels, on top of the snap threshold above) a table edge has to be dragged past the
+* container's width before it actually starts growing past 100% again. This is what makes 100% "sticky" -
+* while still letting the table grow past it with a deliberate, longer drag.
+*
+* @internal
+*/
+export declare const TABLE_WIDTH_GROWTH_RESISTANCE_IN_PIXELS = 10;

package/dist/tablecolumnresize/converters.d.ts

@@ -1,28 +1,28 @@
 /**
- * @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/converters
- */
-import type { DowncastDispatcher, UpcastDispatcher } from '@ckeditor/ckeditor5-engine';
-import { type TableUtils } from '../tableutils.js';
+* @module table/tablecolumnresize/converters
+*/
+import type { DowncastDispatcher, UpcastDispatcher } from "@ckeditor/ckeditor5-engine";
+import { type TableUtils } from "../tableutils.js";
 /**
- * Returns a upcast helper that ensures the number of `<tableColumn>` elements corresponds to the actual number of columns in the table,
- * because the input data might have too few or too many <col> elements.
- *
- * @internal
- */
+* Returns a upcast helper that ensures the number of `<tableColumn>` elements corresponds to the actual number of columns in the table,
+* because the input data might have too few or too many <col> elements.
+*
+* @internal
+*/
 export declare function upcastColgroupElement(tableUtilsPlugin: TableUtils): (dispatcher: UpcastDispatcher) => void;
 /**
- * Returns downcast helper for adding `ck-table-resized` class if there is a `<tableColumnGroup>` element inside the table.
- *
- * @internal
- */
+* Returns downcast helper for adding `ck-table-resized` class if there is a `<tableColumnGroup>` element inside the table.
+*
+* @internal
+*/
 export declare function downcastTableResizedClass(): (dispatcher: DowncastDispatcher) => void;
 /**
- * Returns a upcast helper that removes the `ck-table-resized` class from the table element.
- *
- * @internal
- */
+* Returns a upcast helper that removes the `ck-table-resized` class from the table element.
+*
+* @internal
+*/
 export declare function upcastTableResizedClass(): (dispatcher: UpcastDispatcher) => void;