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

package/dist/ui/colorinputview.d.ts

@@ -1,145 +1,145 @@
 /**
- * @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/colorinputview
- */
-import { View, InputTextView, FocusCycler, ViewCollection, type ColorDefinition, type DropdownView, type ColorPickerConfig, type FocusableView } from '@ckeditor/ckeditor5-ui';
-import { FocusTracker, KeystrokeHandler, type Locale } from '@ckeditor/ckeditor5-utils';
-import '../../theme/colorinput.css';
+* @module table/ui/colorinputview
+*/
+import { View, InputTextView, FocusCycler, ViewCollection, type ColorDefinition, type DropdownView, type ColorPickerConfig, type FocusableView } from "@ckeditor/ckeditor5-ui";
+import { FocusTracker, KeystrokeHandler, type Locale } from "@ckeditor/ckeditor5-utils";
+import "../../theme/colorinput.css";
 /**
- * The options for the color input view.
- *
- * @internal
- */
+* The options for the color input view.
+*
+* @internal
+*/
 export type ColorInputViewOptions = {
-    colorDefinitions: Array<ColorDefinition>;
-    columns: number;
-    defaultColorValue?: string;
-    colorPickerConfig: false | ColorPickerConfig;
+	colorDefinitions: Array<ColorDefinition>;
+	columns: number;
+	defaultColorValue?: string;
+	colorPickerConfig: false | ColorPickerConfig;
 };
 /**
- * The color input view class. It allows the user to type in a color (hex, rgb, etc.)
- * or choose it from the configurable color palette with a preview.
- *
- * @internal
- */
+* The color input view class. It allows the user to type in a color (hex, rgb, etc.)
+* or choose it from the configurable color palette with a preview.
+*
+* @internal
+*/
 export declare class ColorInputView extends View implements FocusableView {
-    /**
-     * The value of the input.
-     *
-     * @observable
-     * @default ''
-     */
-    value: string;
-    /**
-     * Controls whether the input view is in read-only mode.
-     *
-     * @observable
-     * @default false
-     */
-    isReadOnly: boolean;
-    /**
-     * An observable flag set to `true` when the input is focused by the user.
-     * `false` otherwise.
-     *
-     * @observable
-     * @default false
-     */
-    readonly isFocused: boolean;
-    /**
-     * An observable flag set to `true` when the input contains no text.
-     *
-     * @observable
-     * @default true
-     */
-    readonly isEmpty: boolean;
-    /**
-     * @observable
-     */
-    hasError: boolean;
-    /**
-     * A cached reference to the options passed to the constructor.
-     */
-    options: ColorInputViewOptions;
-    /**
-     * Tracks information about the DOM focus in the view.
-     */
-    readonly focusTracker: FocusTracker;
-    /**
-     * Helps cycling over focusable children in the input view.
-     */
-    readonly focusCycler: FocusCycler;
-    /**
-     * A collection of views that can be focused in the view.
-     */
-    protected readonly _focusables: ViewCollection<FocusableView>;
-    /**
-     * An instance of the dropdown allowing to select a color from a grid.
-     */
-    dropdownView: DropdownView;
-    /**
-     * An instance of the input allowing the user to type a color value.
-     */
-    inputView: InputTextView;
-    /**
-     * An instance of the {@link module:utils/keystrokehandler~KeystrokeHandler}.
-     */
-    readonly keystrokes: KeystrokeHandler;
-    /**
-     * The flag that indicates whether the user is still typing.
-     * If set to true, it means that the text input field ({@link #inputView}) still has the focus.
-     * So, we should interrupt the user by replacing the input's value.
-     */
-    protected _stillTyping: boolean;
-    /**
-     * Creates an instance of the color input view.
-     *
-     * @param locale The locale instance.
-     * @param options The input options.
-     * @param options.colorDefinitions The colors to be displayed in the palette inside the input's dropdown.
-     * @param options.columns The number of columns in which the colors will be displayed.
-     * @param options.defaultColorValue If specified, the color input view will replace the "Remove color" button with
-     * the "Restore default" button. Instead of clearing the input field, the default color value will be set.
-     */
-    constructor(locale: Locale, options: ColorInputViewOptions);
-    /**
-     * @inheritDoc
-     */
-    render(): void;
-    /**
-     * Focuses the view.
-     */
-    focus(direction: 1 | -1): void;
-    /**
-     * @inheritDoc
-     */
-    destroy(): void;
-    /**
-     * Creates and configures the {@link #dropdownView}.
-     */
-    private _createDropdownView;
-    /**
-     * Creates and configures an instance of {@link module:ui/inputtext/inputtextview~InputTextView}.
-     *
-     * @returns A configured instance to be set as {@link #inputView}.
-     */
-    private _createInputTextView;
-    /**
-     * Creates and configures the panel with "color grid" and "color picker" inside the {@link #dropdownView}.
-     */
-    private _createColorSelector;
-    /**
-     * Sets {@link #inputView}'s value property to the color value or color label,
-     * if there is one and the user is not typing.
-     *
-     * Handles cases like:
-     *
-     * * Someone picks the color in the grid.
-     * * The color is set from the plugin level.
-     *
-     * @param inputValue Color value to be set.
-     */
-    private _setInputValue;
+	/**
+	* The value of the input.
+	*
+	* @observable
+	* @default ''
+	*/
+	value: string;
+	/**
+	* Controls whether the input view is in read-only mode.
+	*
+	* @observable
+	* @default false
+	*/
+	isReadOnly: boolean;
+	/**
+	* An observable flag set to `true` when the input is focused by the user.
+	* `false` otherwise.
+	*
+	* @observable
+	* @default false
+	*/
+	readonly isFocused: boolean;
+	/**
+	* An observable flag set to `true` when the input contains no text.
+	*
+	* @observable
+	* @default true
+	*/
+	readonly isEmpty: boolean;
+	/**
+	* @observable
+	*/
+	hasError: boolean;
+	/**
+	* A cached reference to the options passed to the constructor.
+	*/
+	options: ColorInputViewOptions;
+	/**
+	* Tracks information about the DOM focus in the view.
+	*/
+	readonly focusTracker: FocusTracker;
+	/**
+	* Helps cycling over focusable children in the input view.
+	*/
+	readonly focusCycler: FocusCycler;
+	/**
+	* A collection of views that can be focused in the view.
+	*/
+	protected readonly _focusables: ViewCollection<FocusableView>;
+	/**
+	* An instance of the dropdown allowing to select a color from a grid.
+	*/
+	dropdownView: DropdownView;
+	/**
+	* An instance of the input allowing the user to type a color value.
+	*/
+	inputView: InputTextView;
+	/**
+	* An instance of the {@link module:utils/keystrokehandler~KeystrokeHandler}.
+	*/
+	readonly keystrokes: KeystrokeHandler;
+	/**
+	* The flag that indicates whether the user is still typing.
+	* If set to true, it means that the text input field ({@link #inputView}) still has the focus.
+	* So, we should interrupt the user by replacing the input's value.
+	*/
+	protected _stillTyping: boolean;
+	/**
+	* Creates an instance of the color input view.
+	*
+	* @param locale The locale instance.
+	* @param options The input options.
+	* @param options.colorDefinitions The colors to be displayed in the palette inside the input's dropdown.
+	* @param options.columns The number of columns in which the colors will be displayed.
+	* @param options.defaultColorValue If specified, the color input view will replace the "Remove color" button with
+	* the "Restore default" button. Instead of clearing the input field, the default color value will be set.
+	*/
+	constructor(locale: Locale, options: ColorInputViewOptions);
+	/**
+	* @inheritDoc
+	*/
+	override render(): void;
+	/**
+	* Focuses the view.
+	*/
+	focus(direction: 1 | -1): void;
+	/**
+	* @inheritDoc
+	*/
+	override destroy(): void;
+	/**
+	* Creates and configures the {@link #dropdownView}.
+	*/
+	private _createDropdownView;
+	/**
+	* Creates and configures an instance of {@link module:ui/inputtext/inputtextview~InputTextView}.
+	*
+	* @returns A configured instance to be set as {@link #inputView}.
+	*/
+	private _createInputTextView;
+	/**
+	* Creates and configures the panel with "color grid" and "color picker" inside the {@link #dropdownView}.
+	*/
+	private _createColorSelector;
+	/**
+	* Sets {@link #inputView}'s value property to the color value or color label,
+	* if there is one and the user is not typing.
+	*
+	* Handles cases like:
+	*
+	* * Someone picks the color in the grid.
+	* * The color is set from the plugin level.
+	*
+	* @param inputValue Color value to be set.
+	*/
+	private _setInputValue;
 }

package/dist/ui/inserttableview.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
- */
+* @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";
+import "./../../theme/inserttable.css";
 /**
- * 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,78 @@
 /**
- * @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;