@ckeditor/ckeditor5-find-and-replace 47.6.1 → 48.0.0-alpha.0

package/src/findandreplaceui.js

@@ -1,277 +0,0 @@
-/**
- * @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/findandreplaceui
- */
-import { Plugin } from 'ckeditor5/src/core.js';
-import { IconFindReplace } from 'ckeditor5/src/icons.js';
-import { ButtonView, MenuBarMenuListItemButtonView, Dialog, DialogViewPosition, createDropdown, DropdownView, FormHeaderView, CssTransitionDisablerMixin } from 'ckeditor5/src/ui.js';
-import { FindAndReplaceFormView } from './ui/findandreplaceformview.js';
-/**
- * The default find and replace UI.
- *
- * It registers the `'findAndReplace'` UI button in the editor's {@link module:ui/componentfactory~ComponentFactory component factory}.
- * that uses the {@link module:find-and-replace/findandreplace~FindAndReplace FindAndReplace} plugin API.
- */
-export class FindAndReplaceUI extends Plugin {
-    /**
-     * @inheritDoc
-     */
-    static get requires() {
-        return [Dialog];
-    }
-    /**
-     * @inheritDoc
-     */
-    static get pluginName() {
-        return 'FindAndReplaceUI';
-    }
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin() {
-        return true;
-    }
-    /**
-     * A reference to the find and replace form view.
-     */
-    formView;
-    /**
-     * @inheritDoc
-     */
-    constructor(editor) {
-        super(editor);
-        editor.config.define('findAndReplace.uiType', 'dialog');
-        this.formView = null;
-    }
-    /**
-     * @inheritDoc
-     */
-    init() {
-        const editor = this.editor;
-        const isUiUsingDropdown = editor.config.get('findAndReplace.uiType') === 'dropdown';
-        const findCommand = editor.commands.get('find');
-        const t = this.editor.t;
-        // Register the toolbar component: dropdown or button (that opens a dialog).
-        editor.ui.componentFactory.add('findAndReplace', () => {
-            let view;
-            if (isUiUsingDropdown) {
-                view = this._createDropdown();
-                // Button should be disabled when in source editing mode. See #10001.
-                view.bind('isEnabled').to(findCommand);
-            }
-            else {
-                view = this._createDialogButtonForToolbar();
-            }
-            editor.keystrokes.set('Ctrl+F', (data, cancelEvent) => {
-                if (!findCommand.isEnabled) {
-                    return;
-                }
-                if (view instanceof DropdownView) {
-                    const dropdownButtonView = view.buttonView;
-                    if (!dropdownButtonView.isOn) {
-                        dropdownButtonView.fire('execute');
-                    }
-                }
-                else {
-                    if (view.isOn) {
-                        // If the dialog is open, do not close it. Instead focus it.
-                        // Unfortunately we can't simply use:
-                        // 	this.formView!.focus();
-                        // because it would always move focus to the first input field, which we don't want.
-                        editor.plugins.get('Dialog').view.focus();
-                    }
-                    else {
-                        view.fire('execute');
-                    }
-                }
-                cancelEvent();
-            });
-            return view;
-        });
-        if (!isUiUsingDropdown) {
-            editor.ui.componentFactory.add('menuBar:findAndReplace', () => {
-                return this._createDialogButtonForMenuBar();
-            });
-        }
-        // Add the information about the keystroke to the accessibility database.
-        editor.accessibility.addKeystrokeInfos({
-            keystrokes: [
-                {
-                    label: t('Find in the document'),
-                    keystroke: 'CTRL+F'
-                }
-            ]
-        });
-    }
-    /**
-     * Creates a dropdown containing the find and replace form.
-     */
-    _createDropdown() {
-        const editor = this.editor;
-        const t = editor.locale.t;
-        const dropdownView = createDropdown(editor.locale);
-        dropdownView.once('change:isOpen', () => {
-            this.formView = this._createFormView();
-            this.formView.children.add(new FormHeaderView(editor.locale, {
-                label: t('Find and replace')
-            }), 0);
-            dropdownView.panelView.children.add(this.formView);
-        });
-        // Every time a dropdown is opened, the search text field should get focused and selected for better UX.
-        // Note: Using the low priority here to make sure the following listener starts working after
-        // the default action of the drop-down is executed (i.e. the panel showed up). Otherwise,
-        // the invisible form/input cannot be focused/selected.
-        //
-        // Each time a dropdown is closed, move the focus back to the find and replace toolbar button
-        // and let the find and replace editing feature know that all search results can be invalidated
-        // and no longer should be marked in the content.
-        dropdownView.on('change:isOpen', (event, name, isOpen) => {
-            if (isOpen) {
-                this._setupFormView();
-            }
-            else {
-                this.fire('searchReseted');
-            }
-        }, { priority: 'low' });
-        dropdownView.buttonView.set({
-            icon: IconFindReplace,
-            label: t('Find and replace'),
-            keystroke: 'CTRL+F',
-            tooltip: true
-        });
-        return dropdownView;
-    }
-    /**
-     * Creates a button that opens a dialog with the find and replace form.
-     */
-    _createDialogButtonForToolbar() {
-        const editor = this.editor;
-        const buttonView = this._createButton(ButtonView);
-        const dialog = editor.plugins.get('Dialog');
-        buttonView.set({
-            tooltip: true
-        });
-        // Button should be on when the find and replace dialog is opened.
-        buttonView.bind('isOn').to(dialog, 'id', id => id === 'findAndReplace');
-        // Every time a dialog is opened, the search text field should get focused and selected for better UX.
-        // Each time a dialog is closed, move the focus back to the find and replace toolbar button
-        // and let the find and replace editing feature know that all search results can be invalidated
-        // and no longer should be marked in the content.
-        buttonView.on('execute', () => {
-            if (buttonView.isOn) {
-                dialog.hide();
-            }
-            else {
-                this._showDialog();
-            }
-        });
-        return buttonView;
-    }
-    /**
-     * Creates a button for for menu bar that will show find and replace dialog.
-     */
-    _createDialogButtonForMenuBar() {
-        const buttonView = this._createButton(MenuBarMenuListItemButtonView);
-        const dialogPlugin = this.editor.plugins.get('Dialog');
-        const dialog = this.editor.plugins.get('Dialog');
-        buttonView.set({
-            role: 'menuitemcheckbox',
-            isToggleable: true
-        });
-        // Button should be on when the find and replace dialog is opened.
-        buttonView.bind('isOn').to(dialog, 'id', id => id === 'findAndReplace');
-        buttonView.on('execute', () => {
-            if (dialogPlugin.id === 'findAndReplace') {
-                dialogPlugin.hide();
-                return;
-            }
-            this._showDialog();
-        });
-        return buttonView;
-    }
-    /**
-     * Creates a button for find and replace command to use either in toolbar or in menu bar.
-     */
-    _createButton(ButtonClass) {
-        const editor = this.editor;
-        const findCommand = editor.commands.get('find');
-        const buttonView = new ButtonClass(editor.locale);
-        const t = editor.locale.t;
-        // Button should be disabled when in source editing mode. See #10001.
-        buttonView.bind('isEnabled').to(findCommand);
-        buttonView.set({
-            icon: IconFindReplace,
-            label: t('Find and replace'),
-            keystroke: 'CTRL+F'
-        });
-        return buttonView;
-    }
-    /**
-     * Shows the find and replace dialog.
-     */
-    _showDialog() {
-        const editor = this.editor;
-        const dialog = editor.plugins.get('Dialog');
-        const t = editor.locale.t;
-        if (!this.formView) {
-            this.formView = this._createFormView();
-        }
-        dialog.show({
-            id: 'findAndReplace',
-            title: t('Find and replace'),
-            content: this.formView,
-            position: DialogViewPosition.EDITOR_TOP_SIDE,
-            onShow: () => {
-                this._setupFormView();
-            },
-            onHide: () => {
-                this.fire('searchReseted');
-            }
-        });
-    }
-    /**
-     * Sets up the form view for the findN and replace.
-     */
-    _createFormView() {
-        const editor = this.editor;
-        const formView = new (CssTransitionDisablerMixin(FindAndReplaceFormView))(editor.locale);
-        const commands = editor.commands;
-        const findAndReplaceEditing = this.editor.plugins.get('FindAndReplaceEditing');
-        const editingState = findAndReplaceEditing.state;
-        formView.bind('highlightOffset').to(editingState, 'highlightedOffset');
-        // Let the form know how many results were found in total.
-        formView.listenTo(editingState.results, 'change', () => {
-            formView.matchCount = editingState.results.length;
-        });
-        // Command states are used to enable/disable individual form controls.
-        // To keep things simple, instead of binding 4 individual observables, there's only one that combines every
-        // commands' isEnabled state. Yes, it will change more often but this simplifies the structure of the form.
-        const findNextCommand = commands.get('findNext');
-        const findPreviousCommand = commands.get('findPrevious');
-        const replaceCommand = commands.get('replace');
-        const replaceAllCommand = commands.get('replaceAll');
-        formView.bind('_areCommandsEnabled').to(findNextCommand, 'isEnabled', findPreviousCommand, 'isEnabled', replaceCommand, 'isEnabled', replaceAllCommand, 'isEnabled', (findNext, findPrevious, replace, replaceAll) => ({ findNext, findPrevious, replace, replaceAll }));
-        // The UI plugin works as an interface between the form and the editing part of the feature.
-        formView.delegate('findNext', 'findPrevious', 'replace', 'replaceAll').to(this);
-        // Let the feature know that search results are no longer relevant because the user changed the searched phrase
-        // (or options) but didn't hit the "Find" button yet (e.g. still typing).
-        formView.on('change:isDirty', (evt, data, isDirty) => {
-            if (isDirty) {
-                this.fire('searchReseted');
-            }
-        });
-        return formView;
-    }
-    /**
-     * Clears the find and replace form and focuses the search text field.
-     */
-    _setupFormView() {
-        this.formView.disableCssTransitions();
-        this.formView.reset();
-        this.formView._findInputView.fieldView.select();
-        this.formView.enableCssTransitions();
-    }
-}

package/src/findandreplaceutils.js

@@ -1,160 +0,0 @@
-/**
- * @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 { Plugin } from 'ckeditor5/src/core.js';
-import { Collection, uid } from 'ckeditor5/src/utils.js';
-import { escapeRegExp } from 'es-toolkit/compat';
-/**
- * A set of helpers related to find and replace.
- */
-export class FindAndReplaceUtils extends Plugin {
-    /**
-     * @inheritDoc
-     */
-    static get pluginName() {
-        return 'FindAndReplaceUtils';
-    }
-    /**
-     * @inheritDoc
-     */
-    static get isOfficialPlugin() {
-        return true;
-    }
-    /**
-     * Executes findCallback and updates search results list.
-     *
-     * @param range The model range to scan for matches.
-     * @param model The model.
-     * @param findCallback The callback that should return `true` if provided text matches the search term.
-     * @param startResults An optional collection of find matches that the function should
-     * start with. This would be a collection returned by a previous `updateFindResultFromRange()` call.
-     * @returns A collection of objects describing find match.
-     *
-     * An example structure:
-     *
-     * ```js
-     * {
-     *	id: resultId,
-     *	label: foundItem.label,
-     *	marker
-     *	}
-     * ```
-     */
-    updateFindResultFromRange(range, model, findCallback, startResults) {
-        const results = startResults || new Collection();
-        const checkIfResultAlreadyOnList = (marker) => results.find(markerItem => {
-            const { marker: resultsMarker } = markerItem;
-            const resultRange = resultsMarker.getRange();
-            const markerRange = marker.getRange();
-            return resultRange.isEqual(markerRange);
-        });
-        model.change(writer => {
-            [...range].forEach(({ type, item }) => {
-                if (type === 'elementStart') {
-                    if (model.schema.checkChild(item, '$text')) {
-                        let foundItems = findCallback({
-                            item,
-                            text: this.rangeToText(model.createRangeIn(item))
-                        });
-                        if (!foundItems) {
-                            return;
-                        }
-                        if ('results' in foundItems) {
-                            foundItems = foundItems.results;
-                        }
-                        foundItems.forEach(foundItem => {
-                            const resultId = `findResult:${uid()}`;
-                            const marker = writer.addMarker(resultId, {
-                                usingOperation: false,
-                                affectsData: false,
-                                range: writer.createRange(writer.createPositionAt(item, foundItem.start), writer.createPositionAt(item, foundItem.end))
-                            });
-                            const index = findInsertIndex(results, marker);
-                            if (!checkIfResultAlreadyOnList(marker)) {
-                                results.add({
-                                    id: resultId,
-                                    label: foundItem.label,
-                                    marker
-                                }, index);
-                            }
-                        });
-                    }
-                }
-            });
-        });
-        return results;
-    }
-    /**
-     * Returns text representation of a range. The returned text length should be the same as range length.
-     * In order to achieve this, this function will replace inline elements (text-line) as new line character ("\n").
-     *
-     * @param range The model range.
-     * @returns The text content of the provided range.
-     */
-    rangeToText(range) {
-        return Array.from(range.getItems({ shallow: true })).reduce((rangeText, node) => {
-            // Trim text to a last occurrence of an inline element and update range start.
-            if (!(node.is('$text') || node.is('$textProxy'))) {
-                // Editor has only one inline element defined in schema: `<softBreak>` which is treated as new line character in blocks.
-                // Special handling might be needed for other inline elements (inline widgets).
-                return `${rangeText}\n`;
-            }
-            return rangeText + node.data;
-        }, '');
-    }
-    /**
-     * Creates a text matching callback for a specified search term and matching options.
-     *
-     * @param searchTerm The search term.
-     * @param options Matching options.
-     * 	- options.matchCase=false If set to `true` letter casing will be ignored.
-     * 	- options.wholeWords=false If set to `true` only whole words that match `callbackOrText` will be matched.
-     */
-    findByTextCallback(searchTerm, options) {
-        let flags = 'gu';
-        if (!options.matchCase) {
-            flags += 'i';
-        }
-        let regExpQuery = `(${escapeRegExp(searchTerm)})`;
-        if (options.wholeWords) {
-            const nonLetterGroup = '[^a-zA-Z\u00C0-\u024F\u1E00-\u1EFF]';
-            if (!new RegExp('^' + nonLetterGroup).test(searchTerm)) {
-                regExpQuery = `(^|${nonLetterGroup}|_)${regExpQuery}`;
-            }
-            if (!new RegExp(nonLetterGroup + '$').test(searchTerm)) {
-                regExpQuery = `${regExpQuery}(?=_|${nonLetterGroup}|$)`;
-            }
-        }
-        const regExp = new RegExp(regExpQuery, flags);
-        function findCallback({ text }) {
-            const matches = [...text.matchAll(regExp)];
-            return matches.map(regexpMatchToFindResult);
-        }
-        return findCallback;
-    }
-}
-// Finds the appropriate index in the resultsList Collection.
-function findInsertIndex(resultsList, markerToInsert) {
-    const result = resultsList.find(({ marker }) => {
-        return markerToInsert.getStart().isBefore(marker.getStart());
-    });
-    return result ? resultsList.getIndex(result) : resultsList.length;
-}
-/**
- *  Maps RegExp match result to find result.
- */
-function regexpMatchToFindResult(matchResult) {
-    const lastGroupIndex = matchResult.length - 1;
-    let startOffset = matchResult.index;
-    // Searches with match all flag have an extra matching group with empty string or white space matched before the word.
-    // If the search term starts with the space already, there is no extra group even with match all flag on.
-    if (matchResult.length === 3) {
-        startOffset += matchResult[1].length;
-    }
-    return {
-        label: matchResult[lastGroupIndex],
-        start: startOffset,
-        end: startOffset + matchResult[lastGroupIndex].length
-    };
-}

package/src/findcommand.js

@@ -1,83 +0,0 @@
-/**
- * @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/findcommand
-*/
-import { Command } from 'ckeditor5/src/core.js';
-/**
- * The find command. It is used by the {@link module:find-and-replace/findandreplace~FindAndReplace find and replace feature}.
- */
-export class FindCommand extends Command {
-    /**
-     * The find and replace state object used for command operations.
-     */
-    _state;
-    /**
-     * Creates a new `FindCommand` instance.
-     *
-     * @param editor The editor on which this command will be used.
-     * @param state An object to hold plugin state.
-     */
-    constructor(editor, state) {
-        super(editor);
-        // The find command is always enabled.
-        this.isEnabled = true;
-        // It does not affect data so should be enabled in read-only mode.
-        this.affectsData = false;
-        this._state = state;
-    }
-    /**
-     * Executes the command.
-     *
-     * @param callbackOrText
-     * @param options Options object.
-     * @param options.matchCase If set to `true`, the letter case will be matched.
-     * @param options.wholeWords If set to `true`, only whole words that match `callbackOrText` will be matched.
-     *
-     * @fires execute
-     */
-    execute(callbackOrText, { matchCase, wholeWords } = {}) {
-        const { editor } = this;
-        const { model } = editor;
-        const findAndReplaceUtils = editor.plugins.get('FindAndReplaceUtils');
-        let findCallback;
-        let callbackSearchText = '';
-        // Allow to execute `find()` on a plugin with a keyword only.
-        if (typeof callbackOrText === 'string') {
-            findCallback = (...args) => ({
-                results: findAndReplaceUtils.findByTextCallback(callbackOrText, { matchCase, wholeWords })(...args),
-                searchText: callbackOrText
-            });
-        }
-        else {
-            findCallback = callbackOrText;
-        }
-        // Wrap the callback to get the search text that will be assigned to the state.
-        const oldCallback = findCallback;
-        findCallback = (...args) => {
-            const result = oldCallback(...args);
-            if (result && 'searchText' in result) {
-                callbackSearchText = result.searchText;
-            }
-            return result;
-        };
-        // Initial search is done on all nodes in all roots inside the content.
-        const results = model.document.getRootNames()
-            .reduce(((currentResults, rootName) => findAndReplaceUtils.updateFindResultFromRange(model.createRangeIn(model.document.getRoot(rootName)), model, findCallback, currentResults)), null);
-        this._state.clear(model);
-        this._state.results.addMany(results);
-        this._state.highlightedResult = results.get(0);
-        this._state.searchText = callbackSearchText;
-        if (findCallback) {
-            this._state.lastSearchCallback = findCallback;
-        }
-        this._state.matchCase = !!matchCase;
-        this._state.matchWholeWords = !!wholeWords;
-        return {
-            results,
-            findCallback
-        };
-    }
-}

package/src/findnextcommand.js

@@ -1,51 +0,0 @@
-/**
- * @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/findnextcommand
-*/
-import { Command } from 'ckeditor5/src/core.js';
-/**
- * The find next command. Moves the highlight to the next search result.
- *
- * It is used by the {@link module:find-and-replace/findandreplace~FindAndReplace find and replace feature}.
- */
-export class FindNextCommand extends Command {
-    /**
-     * The find and replace state object used for command operations.
-     */
-    _state;
-    /**
-     * Creates a new `FindNextCommand` instance.
-     *
-     * @param editor The editor on which this command will be used.
-     * @param state An object to hold plugin state.
-     */
-    constructor(editor, state) {
-        super(editor);
-        // It does not affect data so should be enabled in read-only mode.
-        this.affectsData = false;
-        this._state = state;
-        this.isEnabled = false;
-        this.listenTo(this._state.results, 'change', () => {
-            this.isEnabled = this._state.results.length > 1;
-        });
-    }
-    /**
-     * @inheritDoc
-     */
-    refresh() {
-        this.isEnabled = this._state.results.length > 1;
-    }
-    /**
-     * @inheritDoc
-     */
-    execute() {
-        const results = this._state.results;
-        const currentIndex = results.getIndex(this._state.highlightedResult);
-        const nextIndex = currentIndex + 1 >= results.length ?
-            0 : currentIndex + 1;
-        this._state.highlightedResult = this._state.results.get(nextIndex);
-    }
-}

package/src/findpreviouscommand.js

@@ -1,25 +0,0 @@
-/**
- * @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/findpreviouscommand
-*/
-import { FindNextCommand } from './findnextcommand.js';
-/**
- * The find previous command. Moves the highlight to the previous search result.
- *
- * It is used by the {@link module:find-and-replace/findandreplace~FindAndReplace find and replace feature}.
- */
-export class FindPreviousCommand extends FindNextCommand {
-    /**
-     * @inheritDoc
-     */
-    execute() {
-        const results = this._state.results;
-        const currentIndex = results.getIndex(this._state.highlightedResult);
-        const previousIndex = currentIndex - 1 < 0 ?
-            this._state.results.length - 1 : currentIndex - 1;
-        this._state.highlightedResult = this._state.results.get(previousIndex);
-    }
-}

package/src/index.js

@@ -1,20 +0,0 @@
-/**
- * @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
- */
-export { FindAndReplace } from './findandreplace.js';
-export { FindAndReplaceEditing } from './findandreplaceediting.js';
-export { FindAndReplaceUI } from './findandreplaceui.js';
-export { FindAndReplaceUtils } from './findandreplaceutils.js';
-export { FindCommand } from './findcommand.js';
-export { FindNextCommand } from './findnextcommand.js';
-export { FindPreviousCommand } from './findpreviouscommand.js';
-export { ReplaceCommand } from './replacecommand.js';
-export { ReplaceAllCommand } from './replaceallcommand.js';
-export { FindReplaceCommandBase } from './replacecommandbase.js';
-export { FindAndReplaceFormView } from './ui/findandreplaceformview.js';
-export { FindAndReplaceState, sortSearchResultsByMarkerPositions as _sortFindResultsByMarkerPositions } from './findandreplacestate.js';
-import './augmentation.js';

package/src/replaceallcommand.js

@@ -1,50 +0,0 @@
-/**
- * @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/replaceallcommand
- */
-import { Collection } from 'ckeditor5/src/utils.js';
-import { FindReplaceCommandBase } from './replacecommandbase.js';
-/**
- * The replace all command. It is used by the {@link module:find-and-replace/findandreplace~FindAndReplace find and replace feature}.
- */
-export class ReplaceAllCommand extends FindReplaceCommandBase {
-    /**
-     * Replaces all the occurrences of `textToReplace` with a given `newText` string.
-     *
-     * ```ts
-     *	replaceAllCommand.execute( 'replaceAll', 'new text replacement', 'text to replace' );
-     * ```
-     *
-     * Alternatively you can call it from editor instance:
-     *
-     * ```ts
-     *	editor.execute( 'replaceAll', 'new text', 'old text' );
-     * ```
-     *
-     * @param newText Text that will be inserted to the editor for each match.
-     * @param textToReplace Text to be replaced or a collection of matches
-     * as returned by the find command.
-     *
-     * @fires module:core/command~Command#event:execute
-     */
-    execute(newText, textToReplace) {
-        const { editor } = this;
-        const { model } = editor;
-        const findAndReplaceUtils = editor.plugins.get('FindAndReplaceUtils');
-        const results = textToReplace instanceof Collection ?
-            textToReplace : model.document.getRootNames()
-            .reduce(((currentResults, rootName) => findAndReplaceUtils.updateFindResultFromRange(model.createRangeIn(model.document.getRoot(rootName)), model, findAndReplaceUtils.findByTextCallback(textToReplace, this._state), currentResults)), null);
-        if (results.length) {
-            // Wrapped in single change will batch it into one transaction.
-            model.change(() => {
-                [...results].forEach(searchResult => {
-                    // Just reuse logic from the replace command to replace a single match.
-                    this._replace(newText, searchResult);
-                });
-            });
-        }
-    }
-}