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

package/dist/textarea/textareaview.d.ts

@@ -1,104 +1,108 @@
 /**
- * @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 ui/textarea/textareaview
- */
-import { type Locale } from '@ckeditor/ckeditor5-utils';
-import { InputBase } from '../input/inputbase.js';
-import '../../theme/components/input/input.css';
-import '../../theme/components/textarea/textarea.css';
+* @module ui/textarea/textareaview
+*/
+import { type Locale } from "@ckeditor/ckeditor5-utils";
+import { InputBase } from "../input/inputbase.js";
 /**
- * The textarea view class.
- *
- * ```ts
- * const textareaView = new TextareaView();
- *
- * textareaView.minRows = 2;
- * textareaView.maxRows = 10;
- *
- * textareaView.render();
- *
- * document.body.append( textareaView.element );
- * ```
- */
+* The textarea view class.
+*
+* ```ts
+* const textareaView = new TextareaView();
+*
+* textareaView.minRows = 2;
+* textareaView.maxRows = 10;
+*
+* textareaView.render();
+*
+* document.body.append( textareaView.element );
+* ```
+*/
 export declare class TextareaView extends InputBase<HTMLTextAreaElement> {
-    /**
-     * Specifies the visible height of a text area, in lines.
-     *
-     * @observable
-     * @default 2
-     */
-    minRows: number;
-    /**
-     * Specifies the maximum number of rows.
-     *
-     * @observable
-     * @default 5
-     */
-    maxRows: number;
-    /**
-     * Specifies the value of HTML attribute that indicates whether the user can resize the element.
-     *
-     * @observable
-     * @default 'none'
-    */
-    resize: 'both' | 'horizontal' | 'vertical' | 'none';
-    /**
-     * An internal property that stores the current height of the textarea. Used for the DOM binding.
-     *
-     * @observable
-     * @default null
-     * @internal
-     */
-    _height: number | null;
-    /**
-     * An instance of the resize observer used to detect when the view is visible or not and update
-     * its height if any changes that affect it were made while it was invisible.
-     *
-     * **Note:** Created in {@link #render}.
-     */
-    private _resizeObserver;
-    /**
-     * A flag that indicates whether the {@link #_updateAutoGrowHeight} method should be called when the view becomes
-     * visible again. See {@link #_resizeObserver}.
-     */
-    private _isUpdateAutoGrowHeightPending;
-    /**
-     * @inheritDoc
-     */
-    constructor(locale?: Locale);
-    /**
-     * @inheritDoc
-     */
-    render(): void;
-    /**
-     * @inheritDoc
-     */
-    destroy(): void;
-    /**
-     * @inheritDoc
-     */
-    reset(): void;
-    /**
-     * Updates the {@link #_height} of the view depending on {@link #minRows}, {@link #maxRows}, and the current content size.
-     *
-     * **Note**: This method overrides manual resize done by the user using a handle. It's a known bug.
-     */
-    private _updateAutoGrowHeight;
-    /**
-     * Validates the {@link #minRows} and {@link #maxRows} properties and warns in the console if the configuration is incorrect.
-     */
-    private _validateMinMaxRows;
+	/**
+	* Specifies the visible height of a text area, in lines.
+	*
+	* @observable
+	* @default 2
+	*/
+	minRows: number;
+	/**
+	* Specifies the maximum number of rows.
+	*
+	* @observable
+	* @default 5
+	*/
+	maxRows: number;
+	/**
+	* Specifies the value of HTML attribute that indicates whether the user can resize the element.
+	*
+	* @observable
+	* @default 'none'
+	*/
+	resize: "both" | "horizontal" | "vertical" | "none";
+	/**
+	* An internal property that stores the current height of the textarea. Used for the DOM binding.
+	*
+	* @observable
+	* @default null
+	* @internal
+	*/
+	_height: number | null;
+	/**
+	* An instance of the resize observer used to detect when the view is visible or not and update
+	* its height if any changes that affect it were made while it was invisible.
+	*
+	* **Note:** Created in {@link #render}.
+	*/
+	private _resizeObserver;
+	/**
+	* A flag that indicates whether the {@link #_updateAutoGrowHeight} method should be called when the view becomes
+	* visible again. See {@link #_resizeObserver}.
+	*/
+	private _isUpdateAutoGrowHeightPending;
+	/**
+	* @inheritDoc
+	*/
+	constructor(locale?: Locale);
+	/**
+	* @inheritDoc
+	*/
+	override render(): void;
+	/**
+	* @inheritDoc
+	*/
+	override destroy(): void;
+	/**
+	* @inheritDoc
+	*/
+	override reset(): void;
+	/**
+	* Updates the {@link #_height} of the view once the DOM element reflects the change that triggered the update.
+	* If the view is not visible at that moment, the update is deferred until it becomes visible again
+	* (see {@link #_resizeObserver}).
+	*/
+	private _updateAutoGrowHeightWhenVisible;
+	/**
+	* Updates the {@link #_height} of the view depending on {@link #minRows}, {@link #maxRows}, and the current content size.
+	*
+	* **Note**: This method overrides manual resize done by the user using a handle. It's a known bug.
+	*/
+	private _updateAutoGrowHeight;
+	/**
+	* Validates the {@link #minRows} and {@link #maxRows} properties and warns in the console if the configuration is incorrect.
+	*/
+	private _validateMinMaxRows;
 }
 /**
- * Fired every time the layout of the {@link module:ui/textarea/textareaview~TextareaView} possibly changed as a result
- * of the user input or the value change via {@link module:ui/textarea/textareaview~TextareaView#value}.
- *
- * @eventName ~TextareaView#update
- */
+* Fired every time the layout of the {@link module:ui/textarea/textareaview~TextareaView} possibly changed as a result
+* of the user input or the value change via {@link module:ui/textarea/textareaview~TextareaView#value}.
+*
+* @eventName ~TextareaView#update
+*/
 export type TextareaViewUpdateEvent = {
-    name: 'update';
-    args: [];
+	name: "update";
+	args: [];
 };

package/dist/toolbar/balloon/balloontoolbar.d.ts

@@ -1,130 +1,130 @@
 /**
- * @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 ui/toolbar/balloon/balloontoolbar
- */
-import { ContextualBalloon } from '../../panel/balloon/contextualballoon.js';
-import { ToolbarView } from '../toolbarview.js';
-import { Plugin, type Editor } from '@ckeditor/ckeditor5-core';
-import { FocusTracker } from '@ckeditor/ckeditor5-utils';
+* @module ui/toolbar/balloon/balloontoolbar
+*/
+import { ContextualBalloon } from "../../panel/balloon/contextualballoon.js";
+import { ToolbarView } from "../toolbarview.js";
+import { Plugin, type Editor, type PluginDependenciesOf } from "@ckeditor/ckeditor5-core";
+import { FocusTracker } from "@ckeditor/ckeditor5-utils";
 /**
- * The contextual toolbar.
- *
- * It uses the {@link module:ui/panel/balloon/contextualballoon~ContextualBalloon contextual balloon plugin}.
- */
+* The contextual toolbar.
+*
+* It uses the {@link module:ui/panel/balloon/contextualballoon~ContextualBalloon contextual balloon plugin}.
+*/
 export declare class BalloonToolbar extends Plugin {
-    /**
-     * The toolbar view displayed in the balloon.
-     */
-    readonly toolbarView: ToolbarView;
-    /**
-     * Tracks the focus of the {@link module:ui/editorui/editorui~EditorUI#getEditableElement editable element}
-     * and the {@link #toolbarView}. When both are blurred then the toolbar should hide.
-     */
-    readonly focusTracker: FocusTracker;
-    /**
-     * A cached and normalized `config.balloonToolbar` object.
-     */
-    private _balloonConfig;
-    /**
-     * An instance of the resize observer that allows to respond to changes in editable's geometry
-     * so the toolbar can stay within its boundaries (and group toolbar items that do not fit).
-     *
-     * **Note**: Used only when `shouldNotGroupWhenFull` was **not** set in the
-     * {@link module:core/editor/editorconfig~EditorConfig#balloonToolbar configuration}.
-     *
-     * **Note:** Created in {@link #init}.
-     */
-    private _resizeObserver;
-    /**
-     * The contextual balloon plugin instance.
-     */
-    private readonly _balloon;
-    /**
-     * Fires `_selectionChangeDebounced` event using `es-toolkit#debounce`.
-     *
-     * This event is an internal plugin event which is fired 200 ms after model selection last change.
-     * This is to makes easy test debounced action without need to use `setTimeout`.
-     *
-     * This function is stored as a plugin property to make possible to cancel
-     * trailing debounced invocation on destroy.
-     */
-    private readonly _fireSelectionChangeDebounced;
-    /**
-     * @inheritDoc
-     */
-    static get pluginName(): "BalloonToolbar";
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin(): true;
-    /**
-     * @inheritDoc
-     */
-    static get requires(): readonly [typeof ContextualBalloon];
-    /**
-     * @inheritDoc
-     */
-    constructor(editor: Editor);
-    /**
-     * @inheritDoc
-     */
-    init(): void;
-    /**
-     * Returns whether the toolbar is visible in the ContextualBalloon.
-     */
-    private get _isToolbarVisible();
-    /**
-     * Creates the toolbar view instance.
-     */
-    private _createToolbarView;
-    /**
-     * Shows the toolbar and attaches it to the selection.
-     *
-     * Fires {@link #event:show} event which can be stopped to prevent the toolbar from showing up.
-     *
-     * @param showForCollapsedSelection When set `true`, the toolbar will show despite collapsed selection in the
-     * editing view.
-     */
-    show(showForCollapsedSelection?: boolean): void;
-    /**
-     * Hides the toolbar.
-     */
-    hide(): void;
-    /**
-     * Add or remove editable elements to the focus tracker. It watches added and removed roots
-     * and adds or removes their editable elements to the focus tracker.
-     */
-    private _trackFocusableEditableElements;
-    /**
-     * Returns positioning options for the {@link #_balloon}. They control the way balloon is attached
-     * to the selection.
-     */
-    private _getBalloonPositionData;
-    /**
-     * Updates the position of the {@link #_balloon} to make up for changes:
-     *
-     * * in the geometry of the selection it is attached to (e.g. the selection moved in the viewport or expanded or shrunk),
-     * * or the geometry of the balloon toolbar itself (e.g. the toolbar has grouped or ungrouped some items and it is shorter or longer).
-     */
-    private _updatePosition;
-    /**
-     * @inheritDoc
-     */
-    destroy(): void;
-    /**
-     * Returns toolbar positions for the given direction of the selection.
-     */
-    private _getBalloonPositions;
+	/**
+	* The toolbar view displayed in the balloon.
+	*/
+	readonly toolbarView: ToolbarView;
+	/**
+	* Tracks the focus of the {@link module:ui/editorui/editorui~EditorUI#getEditableElement editable element}
+	* and the {@link #toolbarView}. When both are blurred then the toolbar should hide.
+	*/
+	readonly focusTracker: FocusTracker;
+	/**
+	* A cached and normalized `config.balloonToolbar` object.
+	*/
+	private _balloonConfig;
+	/**
+	* An instance of the resize observer that allows to respond to changes in editable's geometry
+	* so the toolbar can stay within its boundaries (and group toolbar items that do not fit).
+	*
+	* **Note**: Used only when `shouldNotGroupWhenFull` was **not** set in the
+	* {@link module:core/editor/editorconfig~EditorConfig#balloonToolbar configuration}.
+	*
+	* **Note:** Created in {@link #init}.
+	*/
+	private _resizeObserver;
+	/**
+	* The contextual balloon plugin instance.
+	*/
+	private readonly _balloon;
+	/**
+	* Fires `_selectionChangeDebounced` event using `es-toolkit#debounce`.
+	*
+	* This event is an internal plugin event which is fired 200 ms after model selection last change.
+	* This is to makes easy test debounced action without need to use `setTimeout`.
+	*
+	* This function is stored as a plugin property to make possible to cancel
+	* trailing debounced invocation on destroy.
+	*/
+	private readonly _fireSelectionChangeDebounced;
+	/**
+	* @inheritDoc
+	*/
+	static get pluginName(): "BalloonToolbar";
+	/**
+	* @inheritDoc
+	*/
+	static override get isOfficialPlugin(): true;
+	/**
+	* @inheritDoc
+	*/
+	static get requires(): PluginDependenciesOf<[ContextualBalloon]>;
+	/**
+	* @inheritDoc
+	*/
+	constructor(editor: Editor);
+	/**
+	* @inheritDoc
+	*/
+	init(): void;
+	/**
+	* Returns whether the toolbar is visible in the ContextualBalloon.
+	*/
+	private get _isToolbarVisible();
+	/**
+	* Creates the toolbar view instance.
+	*/
+	private _createToolbarView;
+	/**
+	* Shows the toolbar and attaches it to the selection.
+	*
+	* Fires {@link #event:show} event which can be stopped to prevent the toolbar from showing up.
+	*
+	* @param showForCollapsedSelection When set `true`, the toolbar will show despite collapsed selection in the
+	* editing view.
+	*/
+	show(showForCollapsedSelection?: boolean): void;
+	/**
+	* Hides the toolbar.
+	*/
+	hide(): void;
+	/**
+	* Add or remove editable elements to the focus tracker. It watches added and removed roots
+	* and adds or removes their editable elements to the focus tracker.
+	*/
+	private _trackFocusableEditableElements;
+	/**
+	* Returns positioning options for the {@link #_balloon}. They control the way balloon is attached
+	* to the selection.
+	*/
+	private _getBalloonPositionData;
+	/**
+	* Updates the position of the {@link #_balloon} to make up for changes:
+	*
+	* * in the geometry of the selection it is attached to (e.g. the selection moved in the viewport or expanded or shrunk),
+	* * or the geometry of the balloon toolbar itself (e.g. the toolbar has grouped or ungrouped some items and it is shorter or longer).
+	*/
+	private _updatePosition;
+	/**
+	* @inheritDoc
+	*/
+	override destroy(): void;
+	/**
+	* Returns toolbar positions for the given direction of the selection.
+	*/
+	private _getBalloonPositions;
 }
 /**
- * This event is fired just before the toolbar shows up. Stopping this event will prevent this.
- *
- * @eventName ~BalloonToolbar#show
- */
+* This event is fired just before the toolbar shows up. Stopping this event will prevent this.
+*
+* @eventName ~BalloonToolbar#show
+*/
 export type BalloonToolbarShowEvent = {
-    name: 'show';
-    args: [];
+	name: "show";
+	args: [];
 };

package/dist/toolbar/block/blockbuttonview.d.ts

@@ -1,35 +1,34 @@
 /**
- * @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 ui/toolbar/block/blockbuttonview
- */
-import { ButtonView } from '../../button/buttonview.js';
-import { type Locale } from '@ckeditor/ckeditor5-utils';
-import '../../../theme/components/toolbar/blocktoolbar.css';
+* @module ui/toolbar/block/blockbuttonview
+*/
+import { ButtonView } from "../../button/buttonview.js";
+import { type Locale } from "@ckeditor/ckeditor5-utils";
 /**
- * The block button view class.
- *
- * This view represents a button attached next to block element where the selection is anchored.
- *
- * See {@link module:ui/toolbar/block/blocktoolbar~BlockToolbar}.
- */
+* The block button view class.
+*
+* This view represents a button attached next to block element where the selection is anchored.
+*
+* See {@link module:ui/toolbar/block/blocktoolbar~BlockToolbar}.
+*/
 export declare class BlockButtonView extends ButtonView {
-    /**
-     * Top offset.
-     *
-     * @observable
-     */
-    top: number;
-    /**
-     * Left offset.
-     *
-     * @observable
-     */
-    left: number;
-    /**
-     * @inheritDoc
-     */
-    constructor(locale?: Locale);
+	/**
+	* Top offset.
+	*
+	* @observable
+	*/
+	top: number;
+	/**
+	* Left offset.
+	*
+	* @observable
+	*/
+	left: number;
+	/**
+	* @inheritDoc
+	*/
+	constructor(locale?: Locale);
 }