@ckeditor/ckeditor5-find-and-replace 40.0.0 → 40.2.0

package/src/ui/findandreplaceformview.d.ts

@@ -1,288 +1,288 @@
-/**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
- */
-/**
- * @module find-and-replace/ui/findandreplaceformview
- */
-import { View, LabeledFieldView, type InputView } from 'ckeditor5/src/ui';
-import { type Locale } from 'ckeditor5/src/utils';
-import '@ckeditor/ckeditor5-ui/theme/components/responsive-form/responsiveform.css';
-import '../../theme/findandreplaceform.css';
-/**
- * The find and replace form view class.
- *
- * See {@link module:find-and-replace/ui/findandreplaceformview~FindAndReplaceFormView}.
- */
-export default class FindAndReplaceFormView extends View {
-    /**
-     * 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;
-    /**
-     * The find options dropdown.
-     */
-    private readonly _optionsDropdown;
-    /**
-     * The replace button view.
-     */
-    private readonly _replaceButtonView;
-    /**
-     * The replace all button view.
-     */
-    private readonly _replaceAllButtonView;
-    /**
-     * The fieldset aggregating the find UI.
-     */
-    private readonly _findFieldsetView;
-    /**
-     * The fieldset aggregating the replace UI.
-     */
-    private readonly _replaceFieldsetView;
-    /**
-     * 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.
-     */
-    private readonly _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;
-    /**
-     * Focuses the fist {@link #_focusables} in the form.
-     */
-    focus(): 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 `<fieldset>` aggregating all find controls.
-     */
-    private _createFindFieldset;
-    /**
-     * 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;
-    /**
-     * Configures and returns the `<fieldset>` aggregating all replace controls.
-     */
-    private _createReplaceFieldset;
-    /**
-     * 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 _createOptionsDropdown;
-    /**
-     * 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.
- */
-export type FindNextEvent = {
-    name: 'findNext';
-    args: [data?: FindNextEventData];
-};
-export type FindNextEventData = FindEventBaseData & {
-    matchCase: boolean;
-    wholeWords: boolean;
-};
-/**
- * Fired when the find previous button is triggered.
- *
- * @eventName ~FindAndReplaceFormView#findPrevious
- * @param data The event data.
- */
-export type FindPreviousEvent = {
-    name: 'findPrevious';
-    args: [data?: FindEventBaseData];
-};
-/**
- * Base type for all find/replace events.
- */
-export type FindEventBaseData = {
-    searchText: string;
-};
-/**
- * Fired when the replace button is triggered.
- *
- * @eventName ~FindAndReplaceFormView#replace
- * @param data The event data.
- */
-export type ReplaceEvent = {
-    name: 'replace';
-    args: [data: ReplaceEventData];
-};
-export type ReplaceEventData = FindEventBaseData & {
-    replaceText: string;
-};
-/**
- * Fired when the replaceAll button is triggered.
- *
- * @eventName ~FindAndReplaceFormView#replaceAll
- * @param data The event data.
- */
-export type ReplaceAllEvent = {
-    name: 'replaceAll';
-    args: [data: ReplaceEventData];
-};
+/**
+ * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+/**
+ * @module find-and-replace/ui/findandreplaceformview
+ */
+import { View, LabeledFieldView, type InputView } from 'ckeditor5/src/ui';
+import { type Locale } from 'ckeditor5/src/utils';
+import '@ckeditor/ckeditor5-ui/theme/components/responsive-form/responsiveform.css';
+import '../../theme/findandreplaceform.css';
+/**
+ * The find and replace form view class.
+ *
+ * See {@link module:find-and-replace/ui/findandreplaceformview~FindAndReplaceFormView}.
+ */
+export default class FindAndReplaceFormView extends View {
+    /**
+     * 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;
+    /**
+     * The find options dropdown.
+     */
+    private readonly _optionsDropdown;
+    /**
+     * The replace button view.
+     */
+    private readonly _replaceButtonView;
+    /**
+     * The replace all button view.
+     */
+    private readonly _replaceAllButtonView;
+    /**
+     * The fieldset aggregating the find UI.
+     */
+    private readonly _findFieldsetView;
+    /**
+     * The fieldset aggregating the replace UI.
+     */
+    private readonly _replaceFieldsetView;
+    /**
+     * 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.
+     */
+    private readonly _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;
+    /**
+     * Focuses the fist {@link #_focusables} in the form.
+     */
+    focus(): 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 `<fieldset>` aggregating all find controls.
+     */
+    private _createFindFieldset;
+    /**
+     * 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;
+    /**
+     * Configures and returns the `<fieldset>` aggregating all replace controls.
+     */
+    private _createReplaceFieldset;
+    /**
+     * 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 _createOptionsDropdown;
+    /**
+     * 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.
+ */
+export type FindNextEvent = {
+    name: 'findNext';
+    args: [data?: FindNextEventData];
+};
+export type FindNextEventData = FindEventBaseData & {
+    matchCase: boolean;
+    wholeWords: boolean;
+};
+/**
+ * Fired when the find previous button is triggered.
+ *
+ * @eventName ~FindAndReplaceFormView#findPrevious
+ * @param data The event data.
+ */
+export type FindPreviousEvent = {
+    name: 'findPrevious';
+    args: [data?: FindEventBaseData];
+};
+/**
+ * Base type for all find/replace events.
+ */
+export type FindEventBaseData = {
+    searchText: string;
+};
+/**
+ * Fired when the replace button is triggered.
+ *
+ * @eventName ~FindAndReplaceFormView#replace
+ * @param data The event data.
+ */
+export type ReplaceEvent = {
+    name: 'replace';
+    args: [data: ReplaceEventData];
+};
+export type ReplaceEventData = FindEventBaseData & {
+    replaceText: string;
+};
+/**
+ * Fired when the replaceAll button is triggered.
+ *
+ * @eventName ~FindAndReplaceFormView#replaceAll
+ * @param data The event data.
+ */
+export type ReplaceAllEvent = {
+    name: 'replaceAll';
+    args: [data: ReplaceEventData];
+};