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

package/dist/panel/sticky/stickypanelview.d.ts

@@ -1,156 +1,167 @@
 /**
- * @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/panel/sticky/stickypanelview
- */
-import { View } from '../../view.js';
-import { type ViewCollection } from '../../viewcollection.js';
-import { type Locale } from '@ckeditor/ckeditor5-utils';
-import '../../../theme/components/panel/stickypanel.css';
+* @module ui/panel/sticky/stickypanelview
+*/
+import { View } from "../../view.js";
+import { type ViewCollection } from "../../viewcollection.js";
+import { type Locale } from "@ckeditor/ckeditor5-utils";
 /**
- * The sticky panel view class.
- */
+* The sticky panel view class.
+*/
 export declare class StickyPanelView extends View {
-    /**
-     * Collection of the child views which creates balloon panel contents.
-     */
-    readonly content: ViewCollection;
-    /**
-     * Controls whether the sticky panel should be active.
-     *
-     * @readonly
-     * @observable
-     */
-    isActive: boolean;
-    /**
-     * Controls whether the sticky panel is in the "sticky" state.
-     *
-     * @readonly
-     * @observable
-     */
-    isSticky: boolean;
-    /**
-     * The limiter element for the sticky panel instance. Its bounding rect limits
-     * the "stickyness" of the panel, i.e. when the panel reaches the bottom
-     * edge of the limiter, it becomes sticky to that edge and does not float
-     * off the limiter. It is mandatory for the panel to work properly and once
-     * set, it cannot be changed.
-     *
-     * @readonly
-     * @observable
-     */
-    limiterElement: HTMLElement | null;
-    /**
-     * The offset from the bottom edge of {@link #limiterElement}
-     * which stops the panel from stickying any further to prevent limiter's content
-     * from being completely covered.
-     *
-     * @readonly
-     * @observable
-     * @default 50
-     */
-    limiterBottomOffset: number;
-    /**
-     * The offset from the top edge of the web browser's viewport which makes the
-     * panel become sticky. The default value is `0`, which means the panel becomes
-     * sticky when it's upper edge touches the top of the page viewport.
-     *
-     * This attribute is useful when the web page has UI elements positioned to the top
-     * either using `position: fixed` or `position: sticky`, which would cover the
-     * sticky panel or vice–versa (depending on the `z-index` hierarchy).
-     *
-     * Bound to {@link module:ui/editorui/editorui~EditorUI#viewportOffset `EditorUI#viewportOffset`}.
-     *
-     * If {@link module:core/editor/editorconfig~EditorConfig#ui `EditorConfig#ui.viewportOffset.top`} is defined, then
-     * it will override the default value.
-     *
-     * @observable
-     * @default 0
-     */
-    viewportTopOffset: number;
-    /**
-     * The panel which accepts children into {@link #content} collection.
-     * Also an element which is positioned when {@link #isSticky}.
-     */
-    contentPanelElement: HTMLElement;
-    /**
-     * Controls the `margin-left` CSS style of the panel.
-     *
-     * @private
-     * @readonly
-     * @observable
-     */
-    _marginLeft: string | null;
-    /**
-     * Set `true` if the sticky panel reached the bottom edge of the
-     * {@link #limiterElement}.
-     *
-     * @private
-     * @readonly
-     * @observable
-     */
-    _isStickyToTheBottomOfLimiter: boolean;
-    /**
-     * The `top` CSS position of the panel when it is sticky to the top of the viewport or scrollable
-     * ancestors of the {@link #limiterElement}.
-     *
-     * @private
-     * @readonly
-     * @observable
-     */
-    _stickyTopOffset: number | null;
-    /**
-     * The `bottom` CSS position of the panel when it is sticky to the bottom of the {@link #limiterElement}.
-     *
-     * @private
-     * @readonly
-     * @observable
-     */
-    _stickyBottomOffset: number | null;
-    /**
-     * A dummy element which visually fills the space as long as the
-     * actual panel is sticky. It prevents flickering of the UI.
-     */
-    private _contentPanelPlaceholder;
-    /**
-     * @inheritDoc
-     */
-    constructor(locale?: Locale);
-    /**
-     * @inheritDoc
-     */
-    render(): void;
-    /**
-     * Analyzes the environment to decide whether the panel should be sticky or not.
-     * Then handles the positioning of the panel.
-     */
-    checkIfShouldBeSticky(): void;
-    /**
-     * Sticks the panel at the given CSS `top` offset.
-     *
-     * @private
-     * @param topOffset
-     */
-    private _stickToTopOfAncestors;
-    /**
-     * Sticks the panel at the bottom of the limiter with a given CSS `bottom` offset.
-     *
-     * @private
-     * @param stickyBottomOffset
-     */
-    private _stickToBottomOfLimiter;
-    /**
-     * Unsticks the panel putting it back to its original position.
-     *
-     * @private
-     */
-    private _unstick;
-    /**
-     * Returns the bounding rect of the {@link #contentPanelElement}.
-     *
-     * @private
-     */
-    private get _contentPanelRect();
+	/**
+	* Collection of the child views which creates balloon panel contents.
+	*/
+	readonly content: ViewCollection;
+	/**
+	* Controls whether the sticky panel should be active.
+	*
+	* @readonly
+	* @observable
+	*/
+	isActive: boolean;
+	/**
+	* Controls whether the sticky panel is in the "sticky" state.
+	*
+	* @readonly
+	* @observable
+	*/
+	isSticky: boolean;
+	/**
+	* The limiter element for the sticky panel instance. Its bounding rect limits
+	* the "stickyness" of the panel, i.e. when the panel reaches the bottom
+	* edge of the limiter, it becomes sticky to that edge and does not float
+	* off the limiter. It is mandatory for the panel to work properly and once
+	* set, it cannot be changed.
+	*
+	* @readonly
+	* @observable
+	*/
+	limiterElement: HTMLElement | null;
+	/**
+	* The offset from the bottom edge of {@link #limiterElement}
+	* which stops the panel from stickying any further to prevent limiter's content
+	* from being completely covered.
+	*
+	* @readonly
+	* @observable
+	* @default 50
+	*/
+	limiterBottomOffset: number;
+	/**
+	* The offset from the top edge of the web browser's viewport which makes the
+	* panel become sticky. The default value is `0`, which means the panel becomes
+	* sticky when it's upper edge touches the top of the page viewport.
+	*
+	* This attribute is useful when the web page has UI elements positioned to the top
+	* either using `position: fixed` or `position: sticky`, which would cover the
+	* sticky panel or vice–versa (depending on the `z-index` hierarchy).
+	*
+	* Bound to {@link module:ui/editorui/editorui~EditorUI#viewportOffset `EditorUI#viewportOffset`}.
+	*
+	* If {@link module:core/editor/editorconfig~EditorConfig#ui `EditorConfig#ui.viewportOffset.top`} is defined, then
+	* it will override the default value.
+	*
+	* @observable
+	* @default 0
+	*/
+	viewportTopOffset: number;
+	/**
+	* The panel which accepts children into {@link #content} collection.
+	* Also an element which is positioned when {@link #isSticky}.
+	*/
+	contentPanelElement: HTMLElement;
+	/**
+	* Controls the `margin-left` CSS style of the panel.
+	*
+	* @private
+	* @readonly
+	* @observable
+	*/
+	_marginLeft: string | null;
+	/**
+	* Set `true` if the sticky panel reached the bottom edge of the
+	* {@link #limiterElement}.
+	*
+	* @private
+	* @readonly
+	* @observable
+	*/
+	_isStickyToTheBottomOfLimiter: boolean;
+	/**
+	* The `top` CSS position of the panel when it is sticky to the top of the viewport or scrollable
+	* ancestors of the {@link #limiterElement}.
+	*
+	* @private
+	* @readonly
+	* @observable
+	*/
+	_stickyTopOffset: number | null;
+	/**
+	* The `bottom` CSS position of the panel when it is sticky to the bottom of the {@link #limiterElement}.
+	*
+	* @private
+	* @readonly
+	* @observable
+	*/
+	_stickyBottomOffset: number | null;
+	/**
+	* A dummy element which visually fills the space as long as the
+	* actual panel is sticky. It prevents flickering of the UI.
+	*/
+	private _contentPanelPlaceholder;
+	/**
+	* The shadow roots {@link #limiterElement} lives in, currently covered by their own `scroll` listener
+	* (in addition to `document`). `scroll` is not `composed`, so it never crosses a shadow boundary: a
+	* listener on `document`, even with `useCapture: true`, never sees a scrollable container inside a shadow
+	* root hosting the limiter.
+	*/
+	private _scrollListenerShadowRoots;
+	/**
+	* @inheritDoc
+	*/
+	constructor(locale?: Locale);
+	/**
+	* @inheritDoc
+	*/
+	override render(): void;
+	/**
+	* Attaches or detaches the `scroll` listener on the shadow roots {@link #limiterElement} currently lives in,
+	* so they match exactly. See {@link #_scrollListenerShadowRoots}.
+	*/
+	private _syncScrollListenerRoots;
+	/**
+	* Analyzes the environment to decide whether the panel should be sticky or not.
+	* Then handles the positioning of the panel.
+	*/
+	checkIfShouldBeSticky(): void;
+	/**
+	* Sticks the panel at the given CSS `top` offset.
+	*
+	* @private
+	* @param topOffset
+	*/
+	private _stickToTopOfAncestors;
+	/**
+	* Sticks the panel at the bottom of the limiter with a given CSS `bottom` offset.
+	*
+	* @private
+	* @param stickyBottomOffset
+	*/
+	private _stickToBottomOfLimiter;
+	/**
+	* Unsticks the panel putting it back to its original position.
+	*
+	* @private
+	*/
+	private _unstick;
+	/**
+	* Returns the bounding rect of the {@link #contentPanelElement}.
+	*
+	* @private
+	*/
+	private get _contentPanelRect();
 }

package/dist/search/filteredview.d.ts

@@ -1,31 +1,31 @@
 /**
- * @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/search/filteredview
- */
-import type { FocusableView } from '../focuscycler.js';
+* @module ui/search/filteredview
+*/
+import type { FocusableView } from "../focuscycler.js";
 /**
- * A view that can be filtered by a {@link module:ui/search/text/searchtextview~SearchTextView}.
- */
+* A view that can be filtered by a {@link module:ui/search/text/searchtextview~SearchTextView}.
+*/
 export interface FilteredView extends FocusableView {
-    /**
-     * Filters the view by the given regular expression.
-     */
-    filter(regExp: RegExp | null): {
-        resultsCount: number;
-        totalItemsCount: number;
-    };
+	/**
+	* Filters the view by the given regular expression.
+	*/
+	filter(regExp: RegExp | null): {
+		resultsCount: number;
+		totalItemsCount: number;
+	};
 }
 /**
- * Fired when the user selects an autocomplete option. The event data should contain the selected value.
- *
- * @eventName ~FilteredView#execute
- */
+* Fired when the user selects an autocomplete option. The event data should contain the selected value.
+*
+* @eventName ~FilteredView#execute
+*/
 export interface FilteredViewExecuteEvent {
-    name: 'execute';
-    args: [{
-        value: string;
-    }];
+	name: "execute";
+	args: [{
+		value: string;
+	}];
 }

package/dist/search/filtergroupanditemnames.d.ts

@@ -1,15 +1,15 @@
 /**
- * @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 { type ViewCollection } from '../viewcollection.js';
-import { type ListItemGroupView } from '../list/listitemgroupview.js';
-import { type ListItemView } from '../list/listitemview.js';
-import { type ListSeparatorView } from '../list/listseparatorview.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 { type ViewCollection } from "../viewcollection.js";
+import { type ListItemGroupView } from "../list/listitemgroupview.js";
+import { type ListItemView } from "../list/listitemview.js";
+import { type ListSeparatorView } from "../list/listseparatorview.js";
 /**
- * A filter function that returns matching item and group names in the list view.
- */
+* A filter function that returns matching item and group names in the list view.
+*/
 export declare function filterGroupAndItemNames(regExp: RegExp | null, items: ViewCollection<ListItemGroupView | ListItemView | ListSeparatorView>): {
-    resultsCount: number;
-    totalItemsCount: number;
+	resultsCount: number;
+	totalItemsCount: number;
 };

package/dist/search/searchinfoview.d.ts

@@ -1,45 +1,45 @@
 /**
- * @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/search/searchinfoview
+* @module ui/search/searchinfoview
 */
-import type { FocusableView } from '../focuscycler.js';
-import { View } from '../view.js';
+import type { FocusableView } from "../focuscycler.js";
+import { View } from "../view.js";
 /**
- * A view displaying an information text related to different states of {@link module:ui/search/text/searchtextview~SearchTextView}.
- *
- * @internal
- */
+* A view displaying an information text related to different states of {@link module:ui/search/text/searchtextview~SearchTextView}.
+*
+* @internal
+*/
 export declare class SearchInfoView extends View implements FocusableView {
-    /**
-     * Controls whether the view is visible.
-     *
-     * @observable
-     * @default false
-     */
-    isVisible: boolean;
-    /**
-     * Controls the primary line of text in the info.
-     *
-     * @observable
-     * @default ''
-     */
-    primaryText: string;
-    /**
-     * Controls the secondary line of text in the info.
-     *
-     * @observable
-     * @default ''
-     */
-    secondaryText: string;
-    /**
-     * @inheritDoc
-     */
-    constructor();
-    /**
-     * Focuses the view
-     */
-    focus(): void;
+	/**
+	* Controls whether the view is visible.
+	*
+	* @observable
+	* @default false
+	*/
+	isVisible: boolean;
+	/**
+	* Controls the primary line of text in the info.
+	*
+	* @observable
+	* @default ''
+	*/
+	primaryText: string;
+	/**
+	* Controls the secondary line of text in the info.
+	*
+	* @observable
+	* @default ''
+	*/
+	secondaryText: string;
+	/**
+	* @inheritDoc
+	*/
+	constructor();
+	/**
+	* Focuses the view
+	*/
+	focus(): void;
 }

package/dist/search/searchresultsview.d.ts

@@ -1,54 +1,54 @@
 /**
- * @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/search/searchresultsview
- */
-import { View } from '../view.js';
-import { type ViewCollection } from '../viewcollection.js';
-import { FocusTracker, type Locale } from '@ckeditor/ckeditor5-utils';
-import { FocusCycler, type FocusableView } from '../focuscycler.js';
+* @module ui/search/searchresultsview
+*/
+import { View } from "../view.js";
+import { type ViewCollection } from "../viewcollection.js";
+import { FocusTracker, type Locale } from "@ckeditor/ckeditor5-utils";
+import { FocusCycler, type FocusableView } from "../focuscycler.js";
 /**
- * A sub-component of {@link module:ui/search/text/searchtextview~SearchTextView}. It hosts the filtered and the information views.
- */
+* A sub-component of {@link module:ui/search/text/searchtextview~SearchTextView}. It hosts the filtered and the information views.
+*/
 export declare class SearchResultsView extends View implements FocusableView {
-    /**
-     * Tracks information about the DOM focus in the view.
-     *
-     * @readonly
-     */
-    focusTracker: FocusTracker;
-    /**
-     * The collection of the child views inside of the list item {@link #element}.
-     *
-     * @readonly
-     */
-    children: ViewCollection<FocusableView>;
-    /**
-     * Provides the focus management (keyboard navigation) in the view.
-     *
-     * @readonly
-     */
-    protected _focusCycler: FocusCycler;
-    /**
-     * @inheritDoc
-     */
-    constructor(locale: Locale);
-    /**
-     * @inheritDoc
-     */
-    render(): void;
-    /**
-     * Focuses the view.
-     */
-    focus(): void;
-    /**
-     * Focuses the first child view.
-     */
-    focusFirst(): void;
-    /**
-     * Focuses the last child view.
-     */
-    focusLast(): void;
+	/**
+	* Tracks information about the DOM focus in the view.
+	*
+	* @readonly
+	*/
+	focusTracker: FocusTracker;
+	/**
+	* The collection of the child views inside of the list item {@link #element}.
+	*
+	* @readonly
+	*/
+	children: ViewCollection<FocusableView>;
+	/**
+	* Provides the focus management (keyboard navigation) in the view.
+	*
+	* @readonly
+	*/
+	protected _focusCycler: FocusCycler;
+	/**
+	* @inheritDoc
+	*/
+	constructor(locale: Locale);
+	/**
+	* @inheritDoc
+	*/
+	override render(): void;
+	/**
+	* Focuses the view.
+	*/
+	focus(): void;
+	/**
+	* Focuses the first child view.
+	*/
+	focusFirst(): void;
+	/**
+	* Focuses the last child view.
+	*/
+	focusLast(): void;
 }