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

package/dist/list/listview.d.ts

@@ -1,124 +1,124 @@
 /**
- * @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/list/listview
- */
-import { View } from '../view.js';
-import { type FocusableView } from '../focuscycler.js';
-import { ListItemView } from './listitemview.js';
-import { ListItemGroupView } from './listitemgroupview.js';
-import { type ListSeparatorView } from './listseparatorview.js';
-import { type DropdownPanelFocusable } from '../dropdown/dropdownpanelfocusable.js';
-import { ViewCollection } from '../viewcollection.js';
-import { FocusTracker, KeystrokeHandler, type Locale } from '@ckeditor/ckeditor5-utils';
-import '../../theme/components/list/list.css';
+* @module ui/list/listview
+*/
+import { View } from "../view.js";
+import { type FocusableView } from "../focuscycler.js";
+import { ListItemView } from "./listitemview.js";
+import { ListItemGroupView } from "./listitemgroupview.js";
+import { type ListSeparatorView } from "./listseparatorview.js";
+import { type DropdownPanelFocusable } from "../dropdown/dropdownpanelfocusable.js";
+import { ViewCollection } from "../viewcollection.js";
+import { FocusTracker, KeystrokeHandler, type Locale } from "@ckeditor/ckeditor5-utils";
+import "../../theme/components/list/list.css";
 /**
- * The list view class.
- */
+* The list view class.
+*/
 export declare class ListView extends View<HTMLUListElement> implements DropdownPanelFocusable {
-    /**
-     * The collection of focusable views in the list. It is used to determine accessible navigation
-     * between the {@link module:ui/list/listitemview~ListItemView list items} and
-     * {@link module:ui/list/listitemgroupview~ListItemGroupView list groups}.
-     */
-    readonly focusables: ViewCollection<FocusableView>;
-    /**
-     * Collection of the child list views.
-     */
-    readonly items: ViewCollection<ListItemView | ListItemGroupView | ListSeparatorView>;
-    /**
-     * Tracks information about DOM focus in the list.
-     */
-    readonly focusTracker: FocusTracker;
-    /**
-     * Instance of the {@link module:utils/keystrokehandler~KeystrokeHandler}.
-     */
-    readonly keystrokes: KeystrokeHandler;
-    /**
-     * Label used by assistive technologies to describe this list element.
-     *
-     * @observable
-     */
-    ariaLabel: string | undefined;
-    /**
-     * (Optional) The ARIA property reflected by the `aria-ariaLabelledBy` DOM attribute used by assistive technologies.
-     *
-     * @observable
-     */
-    ariaLabelledBy?: string | undefined;
-    /**
-     * The property reflected by the `role` DOM attribute to be used by assistive technologies.
-     *
-     * @observable
-     */
-    role: string | undefined;
-    /**
-     * Helps cycling over focusable {@link #items} in the list.
-     */
-    private readonly _focusCycler;
-    /**
-     * A cached map of {@link module:ui/list/listitemgroupview~ListItemGroupView} to `change` event listeners for their `items`.
-     * Used for accessibility and keyboard navigation purposes.
-     */
-    private readonly _listItemGroupToChangeListeners;
-    /**
-     * @inheritDoc
-     */
-    constructor(locale?: Locale);
-    /**
-     * @inheritDoc
-     */
-    render(): void;
-    /**
-     * @inheritDoc
-     */
-    destroy(): void;
-    /**
-     * Focuses the first focusable in {@link #items}.
-     */
-    focus(): void;
-    /**
-     * Focuses the first focusable in {@link #items}.
-     */
-    focusFirst(): void;
-    /**
-     * Focuses the last focusable in {@link #items}.
-     */
-    focusLast(): void;
-    /**
-     * Registers a list item view in the focus tracker.
-     *
-     * @param item The list item view to be registered.
-     * @param index Index of the list item view in the {@link #items} collection. If not specified, the item will be added at the end.
-     */
-    private _registerFocusableListItem;
-    /**
-     * Removes a list item view from the focus tracker.
-     *
-     * @param item The list item view to be removed.
-     */
-    private _deregisterFocusableListItem;
-    /**
-     * Gets a callback that will be called when the `items` collection of a {@link module:ui/list/listitemgroupview~ListItemGroupView}
-     * change.
-     *
-     * @param groupView The group view for which the callback will be created.
-     * @returns The callback function to be used for the items `change` event listener in a group.
-     */
-    private _getOnGroupItemsChangeCallback;
-    /**
-     * Registers a list item group view (and its children) in the focus tracker.
-     *
-     * @param groupView A group view to be registered.
-     * @param groupIndex Index of the group view in the {@link #items} collection. If not specified, the group will be added at the end.
-     */
-    private _registerFocusableItemsGroup;
-    /**
-     * Removes a list item group view (and its children) from the focus tracker.
-     *
-     * @param groupView The group view to be removed.
-     */
-    private _deregisterFocusableItemsGroup;
+	/**
+	* The collection of focusable views in the list. It is used to determine accessible navigation
+	* between the {@link module:ui/list/listitemview~ListItemView list items} and
+	* {@link module:ui/list/listitemgroupview~ListItemGroupView list groups}.
+	*/
+	readonly focusables: ViewCollection<FocusableView>;
+	/**
+	* Collection of the child list views.
+	*/
+	readonly items: ViewCollection<ListItemView | ListItemGroupView | ListSeparatorView>;
+	/**
+	* Tracks information about DOM focus in the list.
+	*/
+	readonly focusTracker: FocusTracker;
+	/**
+	* Instance of the {@link module:utils/keystrokehandler~KeystrokeHandler}.
+	*/
+	readonly keystrokes: KeystrokeHandler;
+	/**
+	* Label used by assistive technologies to describe this list element.
+	*
+	* @observable
+	*/
+	ariaLabel: string | undefined;
+	/**
+	* (Optional) The ARIA property reflected by the `aria-ariaLabelledBy` DOM attribute used by assistive technologies.
+	*
+	* @observable
+	*/
+	ariaLabelledBy?: string | undefined;
+	/**
+	* The property reflected by the `role` DOM attribute to be used by assistive technologies.
+	*
+	* @observable
+	*/
+	role: string | undefined;
+	/**
+	* Helps cycling over focusable {@link #items} in the list.
+	*/
+	private readonly _focusCycler;
+	/**
+	* A cached map of {@link module:ui/list/listitemgroupview~ListItemGroupView} to `change` event listeners for their `items`.
+	* Used for accessibility and keyboard navigation purposes.
+	*/
+	private readonly _listItemGroupToChangeListeners;
+	/**
+	* @inheritDoc
+	*/
+	constructor(locale?: Locale);
+	/**
+	* @inheritDoc
+	*/
+	override render(): void;
+	/**
+	* @inheritDoc
+	*/
+	override destroy(): void;
+	/**
+	* Focuses the first focusable in {@link #items}.
+	*/
+	focus(): void;
+	/**
+	* Focuses the first focusable in {@link #items}.
+	*/
+	focusFirst(): void;
+	/**
+	* Focuses the last focusable in {@link #items}.
+	*/
+	focusLast(): void;
+	/**
+	* Registers a list item view in the focus tracker.
+	*
+	* @param item The list item view to be registered.
+	* @param index Index of the list item view in the {@link #items} collection. If not specified, the item will be added at the end.
+	*/
+	private _registerFocusableListItem;
+	/**
+	* Removes a list item view from the focus tracker.
+	*
+	* @param item The list item view to be removed.
+	*/
+	private _deregisterFocusableListItem;
+	/**
+	* Gets a callback that will be called when the `items` collection of a {@link module:ui/list/listitemgroupview~ListItemGroupView}
+	* change.
+	*
+	* @param groupView The group view for which the callback will be created.
+	* @returns The callback function to be used for the items `change` event listener in a group.
+	*/
+	private _getOnGroupItemsChangeCallback;
+	/**
+	* Registers a list item group view (and its children) in the focus tracker.
+	*
+	* @param groupView A group view to be registered.
+	* @param groupIndex Index of the group view in the {@link #items} collection. If not specified, the group will be added at the end.
+	*/
+	private _registerFocusableItemsGroup;
+	/**
+	* Removes a list item group view (and its children) from the focus tracker.
+	*
+	* @param groupView The group view to be removed.
+	*/
+	private _deregisterFocusableItemsGroup;
 }

package/dist/menubar/menubarmenubuttonview.d.ts

@@ -1,32 +1,32 @@
 /**
- * @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 { IconView } from '../icon/iconview.js';
-import { ListItemButtonView } from '../button/listitembuttonview.js';
-import type { Locale } from '@ckeditor/ckeditor5-utils';
-import '../../theme/components/menubar/menubarmenubutton.css';
+* @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 { IconView } from "../icon/iconview.js";
+import { ListItemButtonView } from "../button/listitembuttonview.js";
+import type { Locale } from "@ckeditor/ckeditor5-utils";
+import "../../theme/components/menubar/menubarmenubutton.css";
 /**
- * A menu {@link module:ui/menubar/menubarmenuview~MenuBarMenuView#buttonView} class. Buttons like this one
- * open both top-level bar menus as well as sub-menus.
- */
+* A menu {@link module:ui/menubar/menubarmenuview~MenuBarMenuView#buttonView} class. Buttons like this one
+* open both top-level bar menus as well as sub-menus.
+*/
 export declare class MenuBarMenuButtonView extends ListItemButtonView {
-    /**
-     * An icon that displays an arrow to indicate a direction of the menu.
-     */
-    readonly arrowView: IconView;
-    /**
-     * Creates an instance of the menu bar button view.
-     *
-     * @param locale The localization services instance.
-     */
-    constructor(locale: Locale);
-    /**
-     * @inheritDoc
-     */
-    render(): void;
-    /**
-     * Creates the {@link #arrowView} instance.
-     */
-    private _createArrowView;
+	/**
+	* An icon that displays an arrow to indicate a direction of the menu.
+	*/
+	readonly arrowView: IconView;
+	/**
+	* Creates an instance of the menu bar button view.
+	*
+	* @param locale The localization services instance.
+	*/
+	constructor(locale: Locale);
+	/**
+	* @inheritDoc
+	*/
+	override render(): void;
+	/**
+	* Creates the {@link #arrowView} instance.
+	*/
+	private _createArrowView;
 }

package/dist/menubar/menubarmenulistitembuttonview.d.ts

@@ -1,21 +1,21 @@
 /**
- * @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/menubar/menubarmenulistitembuttonview
- */
-import type { Locale } from '@ckeditor/ckeditor5-utils';
-import { ListItemButtonView } from '../button/listitembuttonview.js';
-import '../../theme/components/menubar/menubarmenulistitembutton.css';
+* @module ui/menubar/menubarmenulistitembuttonview
+*/
+import type { Locale } from "@ckeditor/ckeditor5-utils";
+import { ListItemButtonView } from "../button/listitembuttonview.js";
+import "../../theme/components/menubar/menubarmenulistitembutton.css";
 /**
- * A menu bar list button view. Buttons like this one execute user actions.
- */
+* A menu bar list button view. Buttons like this one execute user actions.
+*/
 export declare class MenuBarMenuListItemButtonView extends ListItemButtonView {
-    /**
-     * Creates an instance of the menu bar list button view.
-     *
-     * @param locale The localization services instance.
-     */
-    constructor(locale: Locale);
+	/**
+	* Creates an instance of the menu bar list button view.
+	*
+	* @param locale The localization services instance.
+	*/
+	constructor(locale: Locale);
 }

package/dist/menubar/menubarmenulistitemfiledialogbuttonview.d.ts

@@ -1,23 +1,23 @@
 /**
- * @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/menubar/menubarmenulistitemfiledialogbuttonview
- */
-import type { Locale } from '@ckeditor/ckeditor5-utils';
-import { FileDialogListItemButtonView } from '../button/filedialogbuttonview.js';
-import '../../theme/components/menubar/menubarmenulistitembutton.css';
+* @module ui/menubar/menubarmenulistitemfiledialogbuttonview
+*/
+import type { Locale } from "@ckeditor/ckeditor5-utils";
+import { FileDialogListItemButtonView } from "../button/filedialogbuttonview.js";
+import "../../theme/components/menubar/menubarmenulistitembutton.css";
 /**
- * A menu bar list file dialog button view. Buttons like this one execute user actions.
- *
- * This component provides a button that opens the native file selection dialog.
- */
+* A menu bar list file dialog button view. Buttons like this one execute user actions.
+*
+* This component provides a button that opens the native file selection dialog.
+*/
 export declare class MenuBarMenuListItemFileDialogButtonView extends FileDialogListItemButtonView {
-    /**
-     * Creates an instance of the menu bar list button view.
-     *
-     * @param locale The localization services instance.
-     */
-    constructor(locale: Locale);
+	/**
+	* Creates an instance of the menu bar list button view.
+	*
+	* @param locale The localization services instance.
+	*/
+	constructor(locale: Locale);
 }

package/dist/menubar/menubarmenulistitemview.d.ts

@@ -1,25 +1,25 @@
 /**
- * @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/menubar/menubarmenulistitemview
- */
-import type { Locale } from '@ckeditor/ckeditor5-utils';
-import { ListItemView } from '../list/listitemview.js';
-import { type MenuBarMenuView } from './menubarmenuview.js';
-import '../../theme/components/menubar/menubarmenulistitem.css';
+* @module ui/menubar/menubarmenulistitemview
+*/
+import type { Locale } from "@ckeditor/ckeditor5-utils";
+import { ListItemView } from "../list/listitemview.js";
+import { type MenuBarMenuView } from "./menubarmenuview.js";
+import "../../theme/components/menubar/menubarmenulistitem.css";
 /**
- * A menu bar list item view, a child of {@link module:ui/menubar/menubarmenulistview~MenuBarMenuListView}.
- *
- * Populate this item with a {@link module:ui/menubar/menubarmenulistitembuttonview~MenuBarMenuListItemButtonView} instance
- * or a {@link module:ui/menubar/menubarmenuview~MenuBarMenuView} instance to create a sub-menu.
- */
+* A menu bar list item view, a child of {@link module:ui/menubar/menubarmenulistview~MenuBarMenuListView}.
+*
+* Populate this item with a {@link module:ui/menubar/menubarmenulistitembuttonview~MenuBarMenuListItemButtonView} instance
+* or a {@link module:ui/menubar/menubarmenuview~MenuBarMenuView} instance to create a sub-menu.
+*/
 export declare class MenuBarMenuListItemView extends ListItemView {
-    /**
-     * Creates an instance of the list item view.
-     *
-     * @param locale The localization services instance.
-     */
-    constructor(locale: Locale, parentMenuView: MenuBarMenuView);
+	/**
+	* Creates an instance of the list item view.
+	*
+	* @param locale The localization services instance.
+	*/
+	constructor(locale: Locale, parentMenuView: MenuBarMenuView);
 }

package/dist/menubar/menubarmenulistview.d.ts

@@ -1,29 +1,29 @@
 /**
- * @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/menubar/menubarmenulistview
- */
-import type { Locale } from '@ckeditor/ckeditor5-utils';
-import { ListView } from '../list/listview.js';
+* @module ui/menubar/menubarmenulistview
+*/
+import type { Locale } from "@ckeditor/ckeditor5-utils";
+import { ListView } from "../list/listview.js";
 /**
- * A list of menu bar items, a child of {@link module:ui/menubar/menubarmenuview~MenuBarMenuView#panelView}.
- *
- * Use this class to create a list of items (options, buttons) to be displayed in a menu bar.
- *
- * To populate this list, use {@link module:ui/menubar/menubarmenulistitemview~MenuBarMenuListItemView} instances.
- */
+* A list of menu bar items, a child of {@link module:ui/menubar/menubarmenuview~MenuBarMenuView#panelView}.
+*
+* Use this class to create a list of items (options, buttons) to be displayed in a menu bar.
+*
+* To populate this list, use {@link module:ui/menubar/menubarmenulistitemview~MenuBarMenuListItemView} instances.
+*/
 export declare class MenuBarMenuListView extends ListView {
-    /**
-     * Creates an instance of the list view.
-     *
-     * @param locale The localization services instance.
-     */
-    constructor(locale: Locale);
-    /**
-     * This method adds empty space if there is any toggleable item in the list.
-     * It makes the list properly aligned.
-     */
-    private _setItemsCheckSpace;
+	/**
+	* Creates an instance of the list view.
+	*
+	* @param locale The localization services instance.
+	*/
+	constructor(locale: Locale);
+	/**
+	* This method adds empty space if there is any toggleable item in the list.
+	* It makes the list properly aligned.
+	*/
+	private _setItemsCheckSpace;
 }

package/dist/menubar/menubarmenupanelview.d.ts

@@ -1,53 +1,53 @@
 /**
- * @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/menubar/menubarmenupanelview
- */
-import { type Locale } from '@ckeditor/ckeditor5-utils';
-import type { FocusableView } from '../focuscycler.js';
-import { type ViewCollection } from '../viewcollection.js';
-import { View } from '../view.js';
-import '../../theme/components/menubar/menubarmenupanel.css';
+* @module ui/menubar/menubarmenupanelview
+*/
+import { type Locale } from "@ckeditor/ckeditor5-utils";
+import type { FocusableView } from "../focuscycler.js";
+import { type ViewCollection } from "../viewcollection.js";
+import { View } from "../view.js";
+import "../../theme/components/menubar/menubarmenupanel.css";
 /**
- * A view representing a {@link module:ui/menubar/menubarmenuview~MenuBarMenuView#panelView} of a menu.
- */
+* A view representing a {@link module:ui/menubar/menubarmenuview~MenuBarMenuView#panelView} of a menu.
+*/
 export declare class MenuBarMenuPanelView extends View implements FocusableView {
-    /**
-     * Collection of the child views in this panel.
-     */
-    readonly children: ViewCollection<FocusableView>;
-    /**
-     * Controls whether the panel is visible.
-     *
-     * @observable
-     */
-    isVisible: boolean;
-    /**
-     * The name of the position of the panel, relative to the parent.
-     *
-     * This property is reflected in the CSS class suffix set to {@link #element} that controls
-     * the position of the panel.
-     *
-     * @observable
-     * @default 'se'
-     */
-    position: MenuBarMenuPanelPosition;
-    /**
-     * Creates an instance of the menu panel view.
-     *
-     * @param locale The localization services instance.
-     */
-    constructor(locale?: Locale);
-    /**
-     * Focuses the first child of the panel (default) or the last one if the `direction` is `-1`.
-     */
-    focus(direction?: -1 | 1): void;
+	/**
+	* Collection of the child views in this panel.
+	*/
+	readonly children: ViewCollection<FocusableView>;
+	/**
+	* Controls whether the panel is visible.
+	*
+	* @observable
+	*/
+	isVisible: boolean;
+	/**
+	* The name of the position of the panel, relative to the parent.
+	*
+	* This property is reflected in the CSS class suffix set to {@link #element} that controls
+	* the position of the panel.
+	*
+	* @observable
+	* @default 'se'
+	*/
+	position: MenuBarMenuPanelPosition;
+	/**
+	* Creates an instance of the menu panel view.
+	*
+	* @param locale The localization services instance.
+	*/
+	constructor(locale?: Locale);
+	/**
+	* Focuses the first child of the panel (default) or the last one if the `direction` is `-1`.
+	*/
+	focus(direction?: -1 | 1): void;
 }
 /**
- * The names of the positions of the {@link module:ui/menubar/menubarmenupanelview~MenuBarMenuPanelView}.
- *
- * They are reflected as CSS class suffixes on the panel view element.
- */
-export type MenuBarMenuPanelPosition = 'se' | 'sw' | 'ne' | 'nw' | 'w' | 'ws' | 'e' | 'es';
+* The names of the positions of the {@link module:ui/menubar/menubarmenupanelview~MenuBarMenuPanelView}.
+*
+* They are reflected as CSS class suffixes on the panel view element.
+*/
+export type MenuBarMenuPanelPosition = "se" | "sw" | "ne" | "nw" | "w" | "ws" | "e" | "es";