@ckeditor/ckeditor5-find-and-replace 48.8.1-alpha.4 → 49.0.0-alpha.0

package/dist/ui/findandreplaceformview.d.ts

@@ -1,308 +1,307 @@
 /**
- * @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 find-and-replace/ui/findandreplaceformview
- */
-import { View, LabeledFieldView, FocusCycler, ViewCollection, type InputView } from '@ckeditor/ckeditor5-ui';
-import { type Locale } from '@ckeditor/ckeditor5-utils';
-import '../../theme/findandreplaceform.css';
+* @module find-and-replace/ui/findandreplaceformview
+*/
+import { View, LabeledFieldView, FocusCycler, ViewCollection, type InputView } from "@ckeditor/ckeditor5-ui";
+import { type Locale } from "@ckeditor/ckeditor5-utils";
 /**
- * The find and replace form view class.
- *
- * See {@link module:find-and-replace/ui/findandreplaceformview~FindAndReplaceFormView}.
- */
+* The find and replace form view class.
+*
+* See {@link module:find-and-replace/ui/findandreplaceformview~FindAndReplaceFormView}.
+*/
 export declare class FindAndReplaceFormView extends View {
-    /**
-     * A collection of child views.
-     */
-    children: ViewCollection;
-    /**
-     * Stores the number of matched search results.
-     *
-     * @readonly
-     * @observable
-     */
-    matchCount: number;
-    /**
-     * The offset of currently highlighted search result in {@link #matchCount matched results}.
-     *
-     * @observable
-     */
-    readonly highlightOffset: number;
-    /**
-     * `true` when the search params (find text, options) has been changed by the user since
-     * the last time find was executed. `false` otherwise.
-     *
-     * @readonly
-     * @observable
-     */
-    isDirty: boolean;
-    /**
-     * A live object with the aggregated `isEnabled` states of editor commands related to find and
-     * replace. For instance, it may look as follows:
-     *
-     * ```json
-     * {
-     * 	findNext: true,
-     * 	findPrevious: true,
-     * 	replace: false,
-     * 	replaceAll: false
-     * }
-     * ```
-     *
-     * @internal
-     * @observable
-     */
-    readonly _areCommandsEnabled: Record<string, boolean>;
-    /**
-     * The content of the counter label displaying the index of the current highlighted match
-     * on top of the find input, for instance "3 of 50".
-     *
-     * @internal
-     * @readonly
-     * @observable
-     */
-    _resultsCounterText: string;
-    /**
-     * The flag reflecting the state of the "Match case" switch button in the search options
-     * dropdown.
-     *
-     * @internal
-     * @readonly
-     * @observable
-     */
-    _matchCase: boolean;
-    /**
-     * The flag reflecting the state of the "Whole words only" switch button in the search options
-     * dropdown.
-     *
-     * @internal
-     * @readonly
-     * @observable
-     */
-    _wholeWordsOnly: boolean;
-    /**
-     * This flag is set `true` when some matches were found and the user didn't change the search
-     * params (text to find, options) yet. This is only possible immediately after hitting the "Find" button.
-     * `false` when there were no matches (see {@link #matchCount}) or the user changed the params (see {@link #isDirty}).
-     *
-     * It is used to control the enabled state of the replace UI (input and buttons); replacing text is only possible
-     * if this flag is `true`.
-     *
-     * @internal
-     * @observable
-     */
-    readonly _searchResultsFound: boolean;
-    /**
-     * The find in text input view that stores the searched string.
-     *
-     * @internal
-     */
-    readonly _findInputView: LabeledFieldView<InputView>;
-    /**
-     * The replace input view.
-     */
-    private readonly _replaceInputView;
-    /**
-     * The find button view that initializes the search process.
-     */
-    private readonly _findButtonView;
-    /**
-     * The find previous button view.
-     */
-    private readonly _findPrevButtonView;
-    /**
-     * The find next button view.
-     */
-    private readonly _findNextButtonView;
-    /**
-     * A collapsible view aggregating the advanced search options.
-     */
-    private readonly _advancedOptionsCollapsibleView;
-    /**
-     * A switch button view controlling the "Match case" option.
-     */
-    private readonly _matchCaseSwitchView;
-    /**
-     * A switch button view controlling the "Whole words only" option.
-     */
-    private readonly _wholeWordsOnlySwitchView;
-    /**
-     * The replace button view.
-     */
-    private readonly _replaceButtonView;
-    /**
-     * The replace all button view.
-     */
-    private readonly _replaceAllButtonView;
-    /**
-     * The `div` aggregating the inputs.
-     */
-    private readonly _inputsDivView;
-    /**
-     * The `div` aggregating the action buttons.
-     */
-    private readonly _actionButtonsDivView;
-    /**
-     * Tracks information about the DOM focus in the form.
-     */
-    private readonly _focusTracker;
-    /**
-     * An instance of the {@link module:utils/keystrokehandler~KeystrokeHandler}.
-     */
-    private readonly _keystrokes;
-    /**
-     * A collection of views that can be focused in the form.
-     */
-    private readonly _focusables;
-    /**
-     * Helps cycling over {@link #_focusables} in the form.
-     */
-    readonly focusCycler: FocusCycler;
-    locale: Locale;
-    /**
-     * Creates a view of find and replace form.
-     *
-     * @param locale The localization services instance.
-     */
-    constructor(locale: Locale);
-    /**
-     * @inheritDoc
-     */
-    render(): void;
-    /**
-     * @inheritDoc
-     */
-    destroy(): void;
-    /**
-     * @inheritDoc
-     */
-    focus(direction?: 1 | -1): void;
-    /**
-     * Resets the form before re-appearing.
-     *
-     * It clears error messages, hides the match counter and disables the replace feature
-     * until the next hit of the "Find" button.
-     *
-     * **Note**: It does not reset inputs and options, though. This way the form works better in editors with
-     * disappearing toolbar (e.g. BalloonEditor): hiding the toolbar by accident (together with the find and replace UI)
-     * does not require filling the entire form again.
-     */
-    reset(): void;
-    /**
-     * Returns the value of the find input.
-     */
-    private get _textToFind();
-    /**
-     * Returns the value of the replace input.
-     */
-    private get _textToReplace();
-    /**
-     * Configures and returns the `<div>` aggregating all form inputs.
-     */
-    private _createInputsDiv;
-    /**
-     * The action performed when the {@link #_findButtonView} is pressed.
-     */
-    private _onFindButtonExecute;
-    /**
-     * Configures an injects the find results counter displaying a "N of M" label of the {@link #_findInputView}.
-     */
-    private _injectFindResultsCounter;
-    /**
-     * Creates the collapsible view aggregating the advanced search options.
-     */
-    private _createAdvancedOptionsCollapsible;
-    /**
-     * Configures and returns the `<div>` element aggregating all form action buttons.
-     */
-    private _createActionButtonsDiv;
-    /**
-     * Creates, configures and returns and instance of a dropdown allowing users to narrow
-     * the search criteria down. The dropdown has a list with switch buttons for each option.
-     */
-    private _createMatchCaseSwitch;
-    /**
-     * Creates, configures and returns and instance of a dropdown allowing users to narrow
-     * the search criteria down. The dropdown has a list with switch buttons for each option.
-     */
-    private _createWholeWordsOnlySwitch;
-    /**
-     * Initializes the {@link #_focusables} and {@link #_focusTracker} to allow navigation
-     * using <kbd>Tab</kbd> and <kbd>Shift</kbd>+<kbd>Tab</kbd> keystrokes in the right order.
-     */
-    private _initFocusCycling;
-    /**
-     * Initializes the keystroke handling in the form.
-     */
-    private _initKeystrokeHandling;
-    /**
-     * Creates a button view.
-     *
-     * @param options The properties of the `ButtonView`.
-     * @returns The button view instance.
-     */
-    private _createButton;
-    /**
-     * Creates a labeled input view.
-     *
-     * @param label The input label.
-     * @returns The labeled input view instance.
-     */
-    private _createInputField;
+	/**
+	* A collection of child views.
+	*/
+	children: ViewCollection;
+	/**
+	* Stores the number of matched search results.
+	*
+	* @readonly
+	* @observable
+	*/
+	matchCount: number;
+	/**
+	* The offset of currently highlighted search result in {@link #matchCount matched results}.
+	*
+	* @observable
+	*/
+	readonly highlightOffset: number;
+	/**
+	* `true` when the search params (find text, options) has been changed by the user since
+	* the last time find was executed. `false` otherwise.
+	*
+	* @readonly
+	* @observable
+	*/
+	isDirty: boolean;
+	/**
+	* A live object with the aggregated `isEnabled` states of editor commands related to find and
+	* replace. For instance, it may look as follows:
+	*
+	* ```json
+	* {
+	* 	findNext: true,
+	* 	findPrevious: true,
+	* 	replace: false,
+	* 	replaceAll: false
+	* }
+	* ```
+	*
+	* @internal
+	* @observable
+	*/
+	readonly _areCommandsEnabled: Record<string, boolean>;
+	/**
+	* The content of the counter label displaying the index of the current highlighted match
+	* on top of the find input, for instance "3 of 50".
+	*
+	* @internal
+	* @readonly
+	* @observable
+	*/
+	_resultsCounterText: string;
+	/**
+	* The flag reflecting the state of the "Match case" switch button in the search options
+	* dropdown.
+	*
+	* @internal
+	* @readonly
+	* @observable
+	*/
+	_matchCase: boolean;
+	/**
+	* The flag reflecting the state of the "Whole words only" switch button in the search options
+	* dropdown.
+	*
+	* @internal
+	* @readonly
+	* @observable
+	*/
+	_wholeWordsOnly: boolean;
+	/**
+	* This flag is set `true` when some matches were found and the user didn't change the search
+	* params (text to find, options) yet. This is only possible immediately after hitting the "Find" button.
+	* `false` when there were no matches (see {@link #matchCount}) or the user changed the params (see {@link #isDirty}).
+	*
+	* It is used to control the enabled state of the replace UI (input and buttons); replacing text is only possible
+	* if this flag is `true`.
+	*
+	* @internal
+	* @observable
+	*/
+	readonly _searchResultsFound: boolean;
+	/**
+	* The find in text input view that stores the searched string.
+	*
+	* @internal
+	*/
+	readonly _findInputView: LabeledFieldView<InputView>;
+	/**
+	* The replace input view.
+	*/
+	private readonly _replaceInputView;
+	/**
+	* The find button view that initializes the search process.
+	*/
+	private readonly _findButtonView;
+	/**
+	* The find previous button view.
+	*/
+	private readonly _findPrevButtonView;
+	/**
+	* The find next button view.
+	*/
+	private readonly _findNextButtonView;
+	/**
+	* A collapsible view aggregating the advanced search options.
+	*/
+	private readonly _advancedOptionsCollapsibleView;
+	/**
+	* A switch button view controlling the "Match case" option.
+	*/
+	private readonly _matchCaseSwitchView;
+	/**
+	* A switch button view controlling the "Whole words only" option.
+	*/
+	private readonly _wholeWordsOnlySwitchView;
+	/**
+	* The replace button view.
+	*/
+	private readonly _replaceButtonView;
+	/**
+	* The replace all button view.
+	*/
+	private readonly _replaceAllButtonView;
+	/**
+	* The `div` aggregating the inputs.
+	*/
+	private readonly _inputsDivView;
+	/**
+	* The `div` aggregating the action buttons.
+	*/
+	private readonly _actionButtonsDivView;
+	/**
+	* Tracks information about the DOM focus in the form.
+	*/
+	private readonly _focusTracker;
+	/**
+	* An instance of the {@link module:utils/keystrokehandler~KeystrokeHandler}.
+	*/
+	private readonly _keystrokes;
+	/**
+	* A collection of views that can be focused in the form.
+	*/
+	private readonly _focusables;
+	/**
+	* Helps cycling over {@link #_focusables} in the form.
+	*/
+	readonly focusCycler: FocusCycler;
+	locale: Locale;
+	/**
+	* Creates a view of find and replace form.
+	*
+	* @param locale The localization services instance.
+	*/
+	constructor(locale: Locale);
+	/**
+	* @inheritDoc
+	*/
+	override render(): void;
+	/**
+	* @inheritDoc
+	*/
+	override destroy(): void;
+	/**
+	* @inheritDoc
+	*/
+	focus(direction?: 1 | -1): void;
+	/**
+	* Resets the form before re-appearing.
+	*
+	* It clears error messages, hides the match counter and disables the replace feature
+	* until the next hit of the "Find" button.
+	*
+	* **Note**: It does not reset inputs and options, though. This way the form works better in editors with
+	* disappearing toolbar (e.g. BalloonEditor): hiding the toolbar by accident (together with the find and replace UI)
+	* does not require filling the entire form again.
+	*/
+	reset(): void;
+	/**
+	* Returns the value of the find input.
+	*/
+	private get _textToFind();
+	/**
+	* Returns the value of the replace input.
+	*/
+	private get _textToReplace();
+	/**
+	* Configures and returns the `<div>` aggregating all form inputs.
+	*/
+	private _createInputsDiv;
+	/**
+	* The action performed when the {@link #_findButtonView} is pressed.
+	*/
+	private _onFindButtonExecute;
+	/**
+	* Configures an injects the find results counter displaying a "N of M" label of the {@link #_findInputView}.
+	*/
+	private _injectFindResultsCounter;
+	/**
+	* Creates the collapsible view aggregating the advanced search options.
+	*/
+	private _createAdvancedOptionsCollapsible;
+	/**
+	* Configures and returns the `<div>` element aggregating all form action buttons.
+	*/
+	private _createActionButtonsDiv;
+	/**
+	* Creates, configures and returns and instance of a dropdown allowing users to narrow
+	* the search criteria down. The dropdown has a list with switch buttons for each option.
+	*/
+	private _createMatchCaseSwitch;
+	/**
+	* Creates, configures and returns and instance of a dropdown allowing users to narrow
+	* the search criteria down. The dropdown has a list with switch buttons for each option.
+	*/
+	private _createWholeWordsOnlySwitch;
+	/**
+	* Initializes the {@link #_focusables} and {@link #_focusTracker} to allow navigation
+	* using <kbd>Tab</kbd> and <kbd>Shift</kbd>+<kbd>Tab</kbd> keystrokes in the right order.
+	*/
+	private _initFocusCycling;
+	/**
+	* Initializes the keystroke handling in the form.
+	*/
+	private _initKeystrokeHandling;
+	/**
+	* Creates a button view.
+	*
+	* @param options The properties of the `ButtonView`.
+	* @returns The button view instance.
+	*/
+	private _createButton;
+	/**
+	* Creates a labeled input view.
+	*
+	* @param label The input label.
+	* @returns The labeled input view instance.
+	*/
+	private _createInputField;
 }
 /**
- * Fired when the find next button is triggered.
- *
- * @eventName ~FindAndReplaceFormView#findNext
- * @param data The event data.
- */
+* Fired when the find next button is triggered.
+*
+* @eventName ~FindAndReplaceFormView#findNext
+* @param data The event data.
+*/
 export type FindNextEvent = {
-    name: 'findNext';
-    args: [data?: FindNextEventData];
+	name: "findNext";
+	args: [data?: FindNextEventData];
 };
 export type FindNextEventData = FindEventBaseData & {
-    matchCase: boolean;
-    wholeWords: boolean;
+	matchCase: boolean;
+	wholeWords: boolean;
 };
 /**
- * Fired when the find previous button is triggered.
- *
- * @eventName ~FindAndReplaceFormView#findPrevious
- * @param data The event data.
- */
+* Fired when the find previous button is triggered.
+*
+* @eventName ~FindAndReplaceFormView#findPrevious
+* @param data The event data.
+*/
 export type FindPreviousEvent = {
-    name: 'findPrevious';
-    args: [data?: FindEventBaseData];
+	name: "findPrevious";
+	args: [data?: FindEventBaseData];
 };
 /**
- * Base type for all find/replace events.
- */
+* Base type for all find/replace events.
+*/
 export type FindEventBaseData = {
-    searchText: string;
+	searchText: string;
 };
 /**
- * Fired when the replace button is triggered.
- *
- * @eventName ~FindAndReplaceFormView#replace
- * @param data The event data.
- */
+* Fired when the replace button is triggered.
+*
+* @eventName ~FindAndReplaceFormView#replace
+* @param data The event data.
+*/
 export type ReplaceEvent = {
-    name: 'replace';
-    args: [data: ReplaceEventData];
+	name: "replace";
+	args: [data: ReplaceEventData];
 };
 export type ReplaceEventData = FindEventBaseData & {
-    replaceText: string;
+	replaceText: string;
 };
 /**
- * Fired when the replaceAll button is triggered.
- *
- * @eventName ~FindAndReplaceFormView#replaceAll
- * @param data The event data.
- */
+* Fired when the replaceAll button is triggered.
+*
+* @eventName ~FindAndReplaceFormView#replaceAll
+* @param data The event data.
+*/
 export type ReplaceAllEvent = {
-    name: 'replaceAll';
-    args: [data: ReplaceEventData];
+	name: "replaceAll";
+	args: [data: ReplaceEventData];
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-find-and-replace",
-  "version": "48.8.1-alpha.4",
+  "version": "49.0.0-alpha.0",
   "description": "Find and replace feature for CKEditor 5.",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "CKSource (http://cksource.com/)",
@@ -26,12 +26,12 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@ckeditor/ckeditor5-core": "48.8.1-alpha.4",
-    "@ckeditor/ckeditor5-engine": "48.8.1-alpha.4",
-    "@ckeditor/ckeditor5-icons": "48.8.1-alpha.4",
-    "@ckeditor/ckeditor5-ui": "48.8.1-alpha.4",
-    "@ckeditor/ckeditor5-utils": "48.8.1-alpha.4",
-    "es-toolkit": "1.45.1"
+    "@ckeditor/ckeditor5-core": "49.0.0-alpha.0",
+    "@ckeditor/ckeditor5-engine": "49.0.0-alpha.0",
+    "@ckeditor/ckeditor5-icons": "49.0.0-alpha.0",
+    "@ckeditor/ckeditor5-ui": "49.0.0-alpha.0",
+    "@ckeditor/ckeditor5-utils": "49.0.0-alpha.0",
+    "es-toolkit": "1.52.0"
   },
   "files": [
     "dist",