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

package/dist/search/text/searchtextqueryview.d.ts

@@ -1,73 +1,73 @@
 /**
- * @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 { ButtonView } from '../../button/buttonview.js';
-import { IconView } from '../../icon/iconview.js';
-import { LabeledFieldView, type LabeledFieldViewCreator } from '../../labeledfield/labeledfieldview.js';
-import { type InputBase } from '../../input/inputbase.js';
-import type { Locale } from '@ckeditor/ckeditor5-utils';
+* @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 { ButtonView } from "../../button/buttonview.js";
+import { IconView } from "../../icon/iconview.js";
+import { LabeledFieldView, type LabeledFieldViewCreator } from "../../labeledfield/labeledfieldview.js";
+import { type InputBase } from "../../input/inputbase.js";
+import type { Locale } from "@ckeditor/ckeditor5-utils";
 /**
- * A search input field for the {@link module:ui/search/text/searchtextview~SearchTextView} component.
- *
- * @internal
- * @extends module:ui/labeledfield/labeledfieldview~LabeledFieldView
- */
+* A search input field for the {@link module:ui/search/text/searchtextview~SearchTextView} component.
+*
+* @internal
+* @extends module:ui/labeledfield/labeledfieldview~LabeledFieldView
+*/
 export declare class SearchTextQueryView<TQueryFieldView extends InputBase<HTMLInputElement | HTMLTextAreaElement>> extends LabeledFieldView<TQueryFieldView> {
-    /**
-     * The loupe icon displayed next to the {@link #fieldView}.
-     */
-    iconView?: IconView;
-    /**
-     * The button that clears and focuses the {@link #fieldView}.
-     */
-    resetButtonView?: ButtonView;
-    /**
-     * A reference to the view configuration.
-     */
-    private readonly _viewConfig;
-    /**
-     * @inheritDoc
-     */
-    constructor(locale: Locale, config: SearchTextQueryViewConfig<TQueryFieldView>);
-    /**
-     * Resets the search field to its default state.
-     */
-    reset(): void;
+	/**
+	* The loupe icon displayed next to the {@link #fieldView}.
+	*/
+	iconView?: IconView;
+	/**
+	* The button that clears and focuses the {@link #fieldView}.
+	*/
+	resetButtonView?: ButtonView;
+	/**
+	* A reference to the view configuration.
+	*/
+	private readonly _viewConfig;
+	/**
+	* @inheritDoc
+	*/
+	constructor(locale: Locale, config: SearchTextQueryViewConfig<TQueryFieldView>);
+	/**
+	* Resets the search field to its default state.
+	*/
+	reset(): void;
 }
 /**
- * An event fired when the field is reset using the
- * {@link module:ui/search/text/searchtextqueryview~SearchTextQueryView#resetButtonView}.
- *
- * @eventName ~SearchTextQueryView#reset
- */
+* An event fired when the field is reset using the
+* {@link module:ui/search/text/searchtextqueryview~SearchTextQueryView#resetButtonView}.
+*
+* @eventName ~SearchTextQueryView#reset
+*/
 export type SearchTextQueryViewResetEvent = {
-    name: 'reset';
-    args: [];
+	name: "reset";
+	args: [];
 };
 /**
- * The configuration of the {@link module:ui/search/text/searchtextqueryview~SearchTextQueryView} view.
- */
+* The configuration of the {@link module:ui/search/text/searchtextqueryview~SearchTextQueryView} view.
+*/
 export interface SearchTextQueryViewConfig<TConfigSearchField extends InputBase<HTMLInputElement | HTMLTextAreaElement>> {
-    /**
-     * The human-readable label of the search field.
-     */
-    label: string;
-    /**
-     * Determines whether the button that resets the search should be visible.
-     *
-     * @default true
-     */
-    showResetButton?: boolean;
-    /**
-     * Determines whether the loupe icon should be visible.
-     *
-     * @default true
-     */
-    showIcon?: boolean;
-    /**
-     * The function that creates the search field input view. By default, a plain
-     * {@link module:ui/inputtext/inputtextview~InputTextView} is used for this purpose.
-     */
-    creator?: LabeledFieldViewCreator<TConfigSearchField>;
+	/**
+	* The human-readable label of the search field.
+	*/
+	label: string;
+	/**
+	* Determines whether the button that resets the search should be visible.
+	*
+	* @default true
+	*/
+	showResetButton?: boolean;
+	/**
+	* Determines whether the loupe icon should be visible.
+	*
+	* @default true
+	*/
+	showIcon?: boolean;
+	/**
+	* The function that creates the search field input view. By default, a plain
+	* {@link module:ui/inputtext/inputtextview~InputTextView} is used for this purpose.
+	*/
+	creator?: LabeledFieldViewCreator<TConfigSearchField>;
 }

package/dist/search/text/searchtextview.d.ts

@@ -1,219 +1,218 @@
 /**
- * @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/text/searchtextview
+* @module ui/search/text/searchtextview
 */
-import { FocusTracker, KeystrokeHandler, type Locale } from '@ckeditor/ckeditor5-utils';
-import { View } from '../../view.js';
-import { SearchTextQueryView, type SearchTextQueryViewConfig } from './searchtextqueryview.js';
-import { SearchResultsView } from '../searchresultsview.js';
-import { FocusCycler, type FocusableView } from '../../focuscycler.js';
-import { type FilteredView } from '../filteredview.js';
-import { type ViewCollection } from '../../viewcollection.js';
-import { type InputBase } from '../../input/inputbase.js';
-import { type InputTextView } from '../../inputtext/inputtextview.js';
-import '../../../theme/components/search/search.css';
+import { FocusTracker, KeystrokeHandler, type Locale } from "@ckeditor/ckeditor5-utils";
+import { View } from "../../view.js";
+import { SearchTextQueryView, type SearchTextQueryViewConfig } from "./searchtextqueryview.js";
+import { SearchResultsView } from "../searchresultsview.js";
+import { FocusCycler, type FocusableView } from "../../focuscycler.js";
+import { type FilteredView } from "../filteredview.js";
+import { type ViewCollection } from "../../viewcollection.js";
+import { type InputBase } from "../../input/inputbase.js";
+import { type InputTextView } from "../../inputtext/inputtextview.js";
 /**
- * A search component that allows filtering of an arbitrary view based on a search query
- * specified by the user in a text field.
- *
- *```ts
- * // This view must specify the `filter()` and `focus()` methods.
- * const filteredView = ...;
- *
- * const searchView = new SearchTextView( locale, {
- * 	searchFieldLabel: 'Search list items',
- * 	filteredView
- * } );
- *
- * view.render();
- *
- * document.body.append( view.element );
- * ```
- */
+* A search component that allows filtering of an arbitrary view based on a search query
+* specified by the user in a text field.
+*
+*```ts
+* // This view must specify the `filter()` and `focus()` methods.
+* const filteredView = ...;
+*
+* const searchView = new SearchTextView( locale, {
+* 	searchFieldLabel: 'Search list items',
+* 	filteredView
+* } );
+*
+* view.render();
+*
+* document.body.append( view.element );
+* ```
+*/
 export declare class SearchTextView<TQueryFieldView extends InputBase<HTMLInputElement | HTMLTextAreaElement> = InputTextView> extends View {
-    /**
-     * Tracks information about the DOM focus in the view.
-     *
-     * @readonly
-     */
-    focusTracker: FocusTracker;
-    /**
-     * An instance of the keystroke handler managing user interaction and accessibility.
-     *
-     * @readonly
-     */
-    keystrokes: KeystrokeHandler;
-    /**
-     * A view hosting the {@link #filteredView} passed in the configuration and the {@link #infoView}.
-     */
-    resultsView: SearchResultsView;
-    /**
-     * The view that is filtered by the search query.
-     */
-    filteredView: FilteredView;
-    /**
-     * The view that displays the information about the search results.
-     */
-    infoView: FocusableView | undefined;
-    /**
-     * The view that allows the user to enter the search query.
-     */
-    queryView: SearchTextQueryView<TQueryFieldView>;
-    /**
-     * Controls whether the component is in read-only mode.
-     *
-     * @default true
-     * @observable
-     */
-    isEnabled: boolean;
-    /**
-     * The number of results found for the current search query. Updated upon the {@link #search} event.
-     *
-     * @default 0
-     * @observable
-     */
-    resultsCount: number;
-    /**
-     * The number of the items that can be searched in the {@link #filteredView}. Updated upon the {@link #search} event.
-     *
-     * @default 0
-     * @observable
-     */
-    totalItemsCount: number;
-    /**
-     * The collection of children of the view.
-     *
-     * @readonly
-     */
-    readonly children: ViewCollection;
-    /**
-     * The collection of focusable children of the view. Used by the focus management logic.
-     *
-     * @readonly
-     */
-    readonly focusableChildren: ViewCollection<FocusableView>;
-    locale: Locale;
-    /**
-     * Provides the focus management (keyboard navigation) between {@link #queryView} and {@link #filteredView}.
-     *
-     * @readonly
-     */
-    focusCycler: FocusCycler;
-    /**
-     * The cached configuration object.
-     *
-     * @internal
-     */
-    protected _config: SearchTextViewConfig<TQueryFieldView>;
-    /**
-     * Creates an instance of the {@link module:ui/search/text/searchtextview~SearchTextView} class.
-     *
-     * @param locale The localization services instance.
-     * @param config Configuration of the view.
-     */
-    constructor(locale: Locale, config: SearchTextViewConfig<TQueryFieldView>);
-    /**
-     * @inheritDoc
-     */
-    render(): void;
-    /**
-     * Focuses the {@link #queryView}.
-     */
-    focus(): void;
-    /**
-     * Resets the component to its initial state.
-     */
-    reset(): void;
-    /**
-     * Searches the {@link #filteredView} for the given query.
-     *
-     * @internal
-     * @param query The search query string.
-     */
-    search(query: string): void;
-    /**
-     * Creates a search field view based on configured creator..
-     */
-    private _createSearchTextQueryView;
-    /**
-     * Initializes the default {@link #infoView} behavior with default text labels when no custom info view
-     * was specified in the view config.
-     */
-    private _enableDefaultInfoViewBehavior;
+	/**
+	* Tracks information about the DOM focus in the view.
+	*
+	* @readonly
+	*/
+	focusTracker: FocusTracker;
+	/**
+	* An instance of the keystroke handler managing user interaction and accessibility.
+	*
+	* @readonly
+	*/
+	keystrokes: KeystrokeHandler;
+	/**
+	* A view hosting the {@link #filteredView} passed in the configuration and the {@link #infoView}.
+	*/
+	resultsView: SearchResultsView;
+	/**
+	* The view that is filtered by the search query.
+	*/
+	filteredView: FilteredView;
+	/**
+	* The view that displays the information about the search results.
+	*/
+	infoView: FocusableView | undefined;
+	/**
+	* The view that allows the user to enter the search query.
+	*/
+	queryView: SearchTextQueryView<TQueryFieldView>;
+	/**
+	* Controls whether the component is in read-only mode.
+	*
+	* @default true
+	* @observable
+	*/
+	isEnabled: boolean;
+	/**
+	* The number of results found for the current search query. Updated upon the {@link #search} event.
+	*
+	* @default 0
+	* @observable
+	*/
+	resultsCount: number;
+	/**
+	* The number of the items that can be searched in the {@link #filteredView}. Updated upon the {@link #search} event.
+	*
+	* @default 0
+	* @observable
+	*/
+	totalItemsCount: number;
+	/**
+	* The collection of children of the view.
+	*
+	* @readonly
+	*/
+	readonly children: ViewCollection;
+	/**
+	* The collection of focusable children of the view. Used by the focus management logic.
+	*
+	* @readonly
+	*/
+	readonly focusableChildren: ViewCollection<FocusableView>;
+	locale: Locale;
+	/**
+	* Provides the focus management (keyboard navigation) between {@link #queryView} and {@link #filteredView}.
+	*
+	* @readonly
+	*/
+	focusCycler: FocusCycler;
+	/**
+	* The cached configuration object.
+	*
+	* @internal
+	*/
+	protected _config: SearchTextViewConfig<TQueryFieldView>;
+	/**
+	* Creates an instance of the {@link module:ui/search/text/searchtextview~SearchTextView} class.
+	*
+	* @param locale The localization services instance.
+	* @param config Configuration of the view.
+	*/
+	constructor(locale: Locale, config: SearchTextViewConfig<TQueryFieldView>);
+	/**
+	* @inheritDoc
+	*/
+	override render(): void;
+	/**
+	* Focuses the {@link #queryView}.
+	*/
+	focus(): void;
+	/**
+	* Resets the component to its initial state.
+	*/
+	reset(): void;
+	/**
+	* Searches the {@link #filteredView} for the given query.
+	*
+	* @internal
+	* @param query The search query string.
+	*/
+	search(query: string): void;
+	/**
+	* Creates a search field view based on configured creator..
+	*/
+	private _createSearchTextQueryView;
+	/**
+	* Initializes the default {@link #infoView} behavior with default text labels when no custom info view
+	* was specified in the view config.
+	*/
+	private _enableDefaultInfoViewBehavior;
 }
 /**
- * The configuration of the {@link module:ui/search/text/searchtextview~SearchTextView} class.
- */
+* The configuration of the {@link module:ui/search/text/searchtextview~SearchTextView} class.
+*/
 export interface SearchTextViewConfig<TConfigSearchField extends InputBase<HTMLInputElement | HTMLTextAreaElement>> {
-    /**
-     * The configuration of the view's query field.
-     */
-    queryView: SearchTextQueryViewConfig<TConfigSearchField>;
-    /**
-     * The view that is filtered by the search query.
-     */
-    filteredView: FilteredView;
-    /**
-     * The view that displays the information about the search results.
-     */
-    infoView?: {
-        /**
-         * The view that displays the information about the search results. If not specified,
-         * {@link module:ui/search/searchinfoview~SearchInfoView} is used.
-         */
-        instance?: FocusableView;
-        /**
-         * The configuration of text labels displayed in the {@link #infoView} in different states
-         * of the search component.
-         *
-         * **Note**: This configuration is only used when the {@link #infoView} is **not** specified.
-         * In other cases, please use the {@link module:ui/search/searchview~SearchTextViewSearchEvent} to bring about
-         * your own info text logic.
-         */
-        text?: {
-            notFound?: {
-                primary: SearchTextViewDefaultInfoText;
-                secondary?: SearchTextViewDefaultInfoText;
-            };
-            noSearchableItems?: {
-                primary: SearchTextViewDefaultInfoText;
-                secondary?: SearchTextViewDefaultInfoText;
-            };
-        };
-    };
-    /**
-     * The custom CSS class name to be added to the search view element.
-     */
-    class?: string;
+	/**
+	* The configuration of the view's query field.
+	*/
+	queryView: SearchTextQueryViewConfig<TConfigSearchField>;
+	/**
+	* The view that is filtered by the search query.
+	*/
+	filteredView: FilteredView;
+	/**
+	* The view that displays the information about the search results.
+	*/
+	infoView?: {
+		/**
+		* The view that displays the information about the search results. If not specified,
+		* {@link module:ui/search/searchinfoview~SearchInfoView} is used.
+		*/
+		instance?: FocusableView;
+		/**
+		* The configuration of text labels displayed in the {@link #infoView} in different states
+		* of the search component.
+		*
+		* **Note**: This configuration is only used when the {@link #infoView} is **not** specified.
+		* In other cases, please use the {@link module:ui/search/searchview~SearchTextViewSearchEvent} to bring about
+		* your own info text logic.
+		*/
+		text?: {
+			notFound?: {
+				primary: SearchTextViewDefaultInfoText;
+				secondary?: SearchTextViewDefaultInfoText;
+			};
+			noSearchableItems?: {
+				primary: SearchTextViewDefaultInfoText;
+				secondary?: SearchTextViewDefaultInfoText;
+			};
+		};
+	};
+	/**
+	* The custom CSS class name to be added to the search view element.
+	*/
+	class?: string;
 }
 /**
- * Describes value of a info text configuration in {@link module:ui/search/text/searchtextview~SearchTextViewConfig}.
- * A string or a function that returns a string with the information about the search results.
- */
+* Describes value of a info text configuration in {@link module:ui/search/text/searchtextview~SearchTextViewConfig}.
+* A string or a function that returns a string with the information about the search results.
+*/
 export type SearchTextViewDefaultInfoText = string | ((query: string, resultsCount: number, totalItemsCount: number) => string);
 /**
- * An event fired when the search query changes fired by {@link module:ui/search/text/searchtextview~SearchTextView#search}.
- *
- * @eventName ~SearchTextView#search
- */
+* An event fired when the search query changes fired by {@link module:ui/search/text/searchtextview~SearchTextView#search}.
+*
+* @eventName ~SearchTextView#search
+*/
 export type SearchTextViewSearchEvent = {
-    name: 'search';
-    args: [SearchTextViewSearchEventData];
+	name: "search";
+	args: [SearchTextViewSearchEventData];
 };
 export type SearchTextViewSearchEventData = {
-    /**
-     * The search query string.
-     */
-    query: string;
-    /**
-     * The number of results found for the current search query.
-     */
-    resultsCount: number;
-    /**
-     * The number of the items that can be searched.
-     */
-    totalItemsCount: number;
+	/**
+	* The search query string.
+	*/
+	query: string;
+	/**
+	* The number of results found for the current search query.
+	*/
+	resultsCount: number;
+	/**
+	* The number of the items that can be searched.
+	*/
+	totalItemsCount: number;
 };

package/dist/spinner/spinnerview.d.ts

@@ -1,25 +1,24 @@
 /**
- * @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/spinner/spinnerview
- */
-import { View } from '../view.js';
-import '../../theme/components/spinner/spinner.css';
+* @module ui/spinner/spinnerview
+*/
+import { View } from "../view.js";
 /**
- * The spinner view class.
- */
+* The spinner view class.
+*/
 export declare class SpinnerView extends View {
-    /**
-     * Controls whether the spinner is visible.
-     *
-     * @observable
-     * @default false
-     */
-    isVisible: boolean;
-    /**
-     * @inheritDoc
-     */
-    constructor();
+	/**
+	* Controls whether the spinner is visible.
+	*
+	* @observable
+	* @default false
+	*/
+	isVisible: boolean;
+	/**
+	* @inheritDoc
+	*/
+	constructor();
 }

package/dist/tabs/tabbuttonview.d.ts

@@ -0,0 +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
+*/
+/**
+* @module ui/tabs/tabbuttonview
+*/
+import { type ArrayOrItem, type Locale } from "@ckeditor/ckeditor5-utils";
+import { ButtonView } from "../button/buttonview.js";
+/**
+* The available positions of the tabs (and their buttons) within a tabs view.
+*/
+export declare const TAB_POSITIONS: readonly ["top", "left", "right"];
+/**
+* A single position of the tabs within a tabs view.
+*/
+export type TabPosition = typeof TAB_POSITIONS[number];
+/**
+* A button that toggles the visibility of a tab in a tabs view component.
+*/
+export declare class TabButtonView extends ButtonView {
+	/**
+	* The position of the tab button.
+	*
+	* @observable
+	*/
+	side: TabPosition;
+	/**
+	* @inheritDoc
+	*/
+	constructor(locale?: Locale, options?: TabButtonViewOptions);
+	/**
+	* Shows the tab button.
+	*/
+	show(): void;
+	/**
+	* Hides the tab button.
+	*/
+	hide(): void;
+}
+/**
+* The options for the {@link module:ui/tabs/tabbuttonview~TabButtonView} class.
+*/
+export type TabButtonViewOptions = {
+	/**
+	* An additional CSS class added to the {@link module:ui/tabs/tabbuttonview~TabButtonView#element}.
+	*/
+	class?: ArrayOrItem<string>;
+	/**
+	* The position of the tab button.
+	*/
+	side?: TabPosition;
+};