@ckeditor/ckeditor5-engine 39.0.1 → 40.0.0

package/src/view/observer/selectionobserver.js

@@ -1,202 +1,202 @@
-/**
- * @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 engine/view/observer/selectionobserver
- */
-/* global setInterval, clearInterval */
-import Observer from './observer';
-import MutationObserver from './mutationobserver';
-import { env } from '@ckeditor/ckeditor5-utils';
-import { debounce } from 'lodash-es';
-import FocusObserver from './focusobserver';
-/**
- * Selection observer class observes selection changes in the document. If a selection changes on the document this
- * observer checks if the DOM selection is different from the {@link module:engine/view/document~Document#selection view selection}.
- * The selection observer fires {@link module:engine/view/document~Document#event:selectionChange} event only if
- * a selection change was the only change in the document and the DOM selection is different from the view selection.
- *
- * This observer also manages the {@link module:engine/view/document~Document#isSelecting} property of the view document.
- *
- * Note that this observer is attached by the {@link module:engine/view/view~View} and is available by default.
- */
-export default class SelectionObserver extends Observer {
-    constructor(view) {
-        super(view);
-        this.mutationObserver = view.getObserver(MutationObserver);
-        this.focusObserver = view.getObserver(FocusObserver);
-        this.selection = this.document.selection;
-        this.domConverter = view.domConverter;
-        this._documents = new WeakSet();
-        this._fireSelectionChangeDoneDebounced = debounce(data => {
-            this.document.fire('selectionChangeDone', data);
-        }, 200);
-        this._clearInfiniteLoopInterval = setInterval(() => this._clearInfiniteLoop(), 1000);
-        this._documentIsSelectingInactivityTimeoutDebounced = debounce(() => (this.document.isSelecting = false), 5000);
-        this._loopbackCounter = 0;
-    }
-    /**
-     * @inheritDoc
-     */
-    observe(domElement) {
-        const domDocument = domElement.ownerDocument;
-        const startDocumentIsSelecting = () => {
-            this.document.isSelecting = true;
-            // Let's activate the safety timeout each time the document enters the "is selecting" state.
-            this._documentIsSelectingInactivityTimeoutDebounced();
-        };
-        const endDocumentIsSelecting = () => {
-            if (!this.document.isSelecting) {
-                return;
-            }
-            // Make sure that model selection is up-to-date at the end of selecting process.
-            // Sometimes `selectionchange` events could arrive after the `mouseup` event and that selection could be already outdated.
-            this._handleSelectionChange(null, domDocument);
-            this.document.isSelecting = false;
-            // The safety timeout can be canceled when the document leaves the "is selecting" state.
-            this._documentIsSelectingInactivityTimeoutDebounced.cancel();
-        };
-        // The document has the "is selecting" state while the user keeps making (extending) the selection
-        // (e.g. by holding the mouse button and moving the cursor). The state resets when they either released
-        // the mouse button or interrupted the process by pressing or releasing any key.
-        this.listenTo(domElement, 'selectstart', startDocumentIsSelecting, { priority: 'highest' });
-        this.listenTo(domElement, 'keydown', endDocumentIsSelecting, { priority: 'highest', useCapture: true });
-        this.listenTo(domElement, 'keyup', endDocumentIsSelecting, { priority: 'highest', useCapture: true });
-        // Add document-wide listeners only once. This method could be called for multiple editing roots.
-        if (this._documents.has(domDocument)) {
-            return;
-        }
-        // This listener is using capture mode to make sure that selection is upcasted before any other
-        // handler would like to check it and update (for example table multi cell selection).
-        this.listenTo(domDocument, 'mouseup', endDocumentIsSelecting, { priority: 'highest', useCapture: true });
-        this.listenTo(domDocument, 'selectionchange', (evt, domEvent) => {
-            // @if CK_DEBUG_TYPING // if ( ( window as any ).logCKETyping ) {
-            // @if CK_DEBUG_TYPING // 	const domSelection = domDocument.defaultView!.getSelection();
-            // @if CK_DEBUG_TYPING // 	console.group( '%c[SelectionObserver]%c selectionchange', 'color:green', ''
-            // @if CK_DEBUG_TYPING // 	);
-            // @if CK_DEBUG_TYPING // 	console.info( '%c[SelectionObserver]%c DOM Selection:', 'font-weight:bold;color:green', '',
-            // @if CK_DEBUG_TYPING // 		{ node: domSelection!.anchorNode, offset: domSelection!.anchorOffset },
-            // @if CK_DEBUG_TYPING // 		{ node: domSelection!.focusNode, offset: domSelection!.focusOffset }
-            // @if CK_DEBUG_TYPING // 	);
-            // @if CK_DEBUG_TYPING // }
-            // The Renderer is disabled while composing on non-android browsers, so we can't update the view selection
-            // because the DOM and view tree drifted apart. Position mapping could fail because of it.
-            if (this.document.isComposing && !env.isAndroid) {
-                // @if CK_DEBUG_TYPING // if ( ( window as any ).logCKETyping ) {
-                // @if CK_DEBUG_TYPING // 	console.info( '%c[SelectionObserver]%c Selection change ignored (isComposing)',
-                // @if CK_DEBUG_TYPING // 		'font-weight:bold;color:green', ''
-                // @if CK_DEBUG_TYPING // 	);
-                // @if CK_DEBUG_TYPING // 	console.groupEnd();
-                // @if CK_DEBUG_TYPING // }
-                return;
-            }
-            this._handleSelectionChange(domEvent, domDocument);
-            // @if CK_DEBUG_TYPING // if ( ( window as any ).logCKETyping ) {
-            // @if CK_DEBUG_TYPING // 	console.groupEnd();
-            // @if CK_DEBUG_TYPING // }
-            // Defer the safety timeout when the selection changes (e.g. the user keeps extending the selection
-            // using their mouse).
-            this._documentIsSelectingInactivityTimeoutDebounced();
-        });
-        this._documents.add(domDocument);
-    }
-    /**
-     * @inheritDoc
-     */
-    stopObserving(domElement) {
-        this.stopListening(domElement);
-    }
-    /**
-     * @inheritDoc
-     */
-    destroy() {
-        super.destroy();
-        clearInterval(this._clearInfiniteLoopInterval);
-        this._fireSelectionChangeDoneDebounced.cancel();
-        this._documentIsSelectingInactivityTimeoutDebounced.cancel();
-    }
-    /* istanbul ignore next -- @preserve */
-    _reportInfiniteLoop() {
-        // @if CK_DEBUG //		throw new Error(
-        // @if CK_DEBUG //			'Selection change observer detected an infinite rendering loop.\n\n' +
-        // @if CK_DEBUG //	 		'⚠️⚠️ Report this error on https://github.com/ckeditor/ckeditor5/issues/11658.'
-        // @if CK_DEBUG //		);
-    }
-    /**
-     * Selection change listener. {@link module:engine/view/observer/mutationobserver~MutationObserver#flush Flush} mutations, check if
-     * a selection changes and fires {@link module:engine/view/document~Document#event:selectionChange} event on every change
-     * and {@link module:engine/view/document~Document#event:selectionChangeDone} when a selection stop changing.
-     *
-     * @param domEvent DOM event.
-     * @param domDocument DOM document.
-     */
-    _handleSelectionChange(domEvent, domDocument) {
-        if (!this.isEnabled) {
-            return;
-        }
-        const domSelection = domDocument.defaultView.getSelection();
-        if (this.checkShouldIgnoreEventFromTarget(domSelection.anchorNode)) {
-            return;
-        }
-        // Ensure the mutation event will be before selection event on all browsers.
-        this.mutationObserver.flush();
-        const newViewSelection = this.domConverter.domSelectionToView(domSelection);
-        // Do not convert selection change if the new view selection has no ranges in it.
-        //
-        // It means that the DOM selection is in some way incorrect. Ranges that were in the DOM selection could not be
-        // converted to the view. This happens when the DOM selection was moved outside of the editable element.
-        if (newViewSelection.rangeCount == 0) {
-            this.view.hasDomSelection = false;
-            return;
-        }
-        this.view.hasDomSelection = true;
-        // Mark the latest focus change as complete (we got new selection after the focus so the selection is in the focused element).
-        this.focusObserver.flush();
-        if (this.selection.isEqual(newViewSelection) && this.domConverter.isDomSelectionCorrect(domSelection)) {
-            return;
-        }
-        // Ensure we are not in the infinite loop (#400).
-        // This counter is reset each second. 60 selection changes in 1 second is enough high number
-        // to be very difficult (impossible) to achieve using just keyboard keys (during normal editor use).
-        if (++this._loopbackCounter > 60) {
-            // Selection change observer detected an infinite rendering loop.
-            // Most probably you try to put the selection in the position which is not allowed
-            // by the browser and browser fixes it automatically what causes `selectionchange` event on
-            // which a loopback through a model tries to re-render the wrong selection and again.
-            this._reportInfiniteLoop();
-            return;
-        }
-        if (this.selection.isSimilar(newViewSelection)) {
-            // If selection was equal and we are at this point of algorithm, it means that it was incorrect.
-            // Just re-render it, no need to fire any events, etc.
-            this.view.forceRender();
-        }
-        else {
-            const data = {
-                oldSelection: this.selection,
-                newSelection: newViewSelection,
-                domSelection
-            };
-            // @if CK_DEBUG_TYPING // if ( ( window as any ).logCKETyping ) {
-            // @if CK_DEBUG_TYPING // 	console.info( '%c[SelectionObserver]%c Fire selection change:',
-            // @if CK_DEBUG_TYPING // 		'font-weight:bold;color:green', '',
-            // @if CK_DEBUG_TYPING // 		newViewSelection.getFirstRange()
-            // @if CK_DEBUG_TYPING // 	);
-            // @if CK_DEBUG_TYPING // }
-            // Prepare data for new selection and fire appropriate events.
-            this.document.fire('selectionChange', data);
-            // Call `#_fireSelectionChangeDoneDebounced` every time when `selectionChange` event is fired.
-            // This function is debounced what means that `selectionChangeDone` event will be fired only when
-            // defined int the function time will elapse since the last time the function was called.
-            // So `selectionChangeDone` will be fired when selection will stop changing.
-            this._fireSelectionChangeDoneDebounced(data);
-        }
-    }
-    /**
-     * Clears `SelectionObserver` internal properties connected with preventing infinite loop.
-     */
-    _clearInfiniteLoop() {
-        this._loopbackCounter = 0;
-    }
-}
+/**
+ * @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 engine/view/observer/selectionobserver
+ */
+/* global setInterval, clearInterval */
+import Observer from './observer';
+import MutationObserver from './mutationobserver';
+import { env } from '@ckeditor/ckeditor5-utils';
+import { debounce } from 'lodash-es';
+import FocusObserver from './focusobserver';
+/**
+ * Selection observer class observes selection changes in the document. If a selection changes on the document this
+ * observer checks if the DOM selection is different from the {@link module:engine/view/document~Document#selection view selection}.
+ * The selection observer fires {@link module:engine/view/document~Document#event:selectionChange} event only if
+ * a selection change was the only change in the document and the DOM selection is different from the view selection.
+ *
+ * This observer also manages the {@link module:engine/view/document~Document#isSelecting} property of the view document.
+ *
+ * Note that this observer is attached by the {@link module:engine/view/view~View} and is available by default.
+ */
+export default class SelectionObserver extends Observer {
+    constructor(view) {
+        super(view);
+        this.mutationObserver = view.getObserver(MutationObserver);
+        this.focusObserver = view.getObserver(FocusObserver);
+        this.selection = this.document.selection;
+        this.domConverter = view.domConverter;
+        this._documents = new WeakSet();
+        this._fireSelectionChangeDoneDebounced = debounce(data => {
+            this.document.fire('selectionChangeDone', data);
+        }, 200);
+        this._clearInfiniteLoopInterval = setInterval(() => this._clearInfiniteLoop(), 1000);
+        this._documentIsSelectingInactivityTimeoutDebounced = debounce(() => (this.document.isSelecting = false), 5000);
+        this._loopbackCounter = 0;
+    }
+    /**
+     * @inheritDoc
+     */
+    observe(domElement) {
+        const domDocument = domElement.ownerDocument;
+        const startDocumentIsSelecting = () => {
+            this.document.isSelecting = true;
+            // Let's activate the safety timeout each time the document enters the "is selecting" state.
+            this._documentIsSelectingInactivityTimeoutDebounced();
+        };
+        const endDocumentIsSelecting = () => {
+            if (!this.document.isSelecting) {
+                return;
+            }
+            // Make sure that model selection is up-to-date at the end of selecting process.
+            // Sometimes `selectionchange` events could arrive after the `mouseup` event and that selection could be already outdated.
+            this._handleSelectionChange(null, domDocument);
+            this.document.isSelecting = false;
+            // The safety timeout can be canceled when the document leaves the "is selecting" state.
+            this._documentIsSelectingInactivityTimeoutDebounced.cancel();
+        };
+        // The document has the "is selecting" state while the user keeps making (extending) the selection
+        // (e.g. by holding the mouse button and moving the cursor). The state resets when they either released
+        // the mouse button or interrupted the process by pressing or releasing any key.
+        this.listenTo(domElement, 'selectstart', startDocumentIsSelecting, { priority: 'highest' });
+        this.listenTo(domElement, 'keydown', endDocumentIsSelecting, { priority: 'highest', useCapture: true });
+        this.listenTo(domElement, 'keyup', endDocumentIsSelecting, { priority: 'highest', useCapture: true });
+        // Add document-wide listeners only once. This method could be called for multiple editing roots.
+        if (this._documents.has(domDocument)) {
+            return;
+        }
+        // This listener is using capture mode to make sure that selection is upcasted before any other
+        // handler would like to check it and update (for example table multi cell selection).
+        this.listenTo(domDocument, 'mouseup', endDocumentIsSelecting, { priority: 'highest', useCapture: true });
+        this.listenTo(domDocument, 'selectionchange', (evt, domEvent) => {
+            // @if CK_DEBUG_TYPING // if ( ( window as any ).logCKETyping ) {
+            // @if CK_DEBUG_TYPING // 	const domSelection = domDocument.defaultView!.getSelection();
+            // @if CK_DEBUG_TYPING // 	console.group( '%c[SelectionObserver]%c selectionchange', 'color:green', ''
+            // @if CK_DEBUG_TYPING // 	);
+            // @if CK_DEBUG_TYPING // 	console.info( '%c[SelectionObserver]%c DOM Selection:', 'font-weight:bold;color:green', '',
+            // @if CK_DEBUG_TYPING // 		{ node: domSelection!.anchorNode, offset: domSelection!.anchorOffset },
+            // @if CK_DEBUG_TYPING // 		{ node: domSelection!.focusNode, offset: domSelection!.focusOffset }
+            // @if CK_DEBUG_TYPING // 	);
+            // @if CK_DEBUG_TYPING // }
+            // The Renderer is disabled while composing on non-android browsers, so we can't update the view selection
+            // because the DOM and view tree drifted apart. Position mapping could fail because of it.
+            if (this.document.isComposing && !env.isAndroid) {
+                // @if CK_DEBUG_TYPING // if ( ( window as any ).logCKETyping ) {
+                // @if CK_DEBUG_TYPING // 	console.info( '%c[SelectionObserver]%c Selection change ignored (isComposing)',
+                // @if CK_DEBUG_TYPING // 		'font-weight:bold;color:green', ''
+                // @if CK_DEBUG_TYPING // 	);
+                // @if CK_DEBUG_TYPING // 	console.groupEnd();
+                // @if CK_DEBUG_TYPING // }
+                return;
+            }
+            this._handleSelectionChange(domEvent, domDocument);
+            // @if CK_DEBUG_TYPING // if ( ( window as any ).logCKETyping ) {
+            // @if CK_DEBUG_TYPING // 	console.groupEnd();
+            // @if CK_DEBUG_TYPING // }
+            // Defer the safety timeout when the selection changes (e.g. the user keeps extending the selection
+            // using their mouse).
+            this._documentIsSelectingInactivityTimeoutDebounced();
+        });
+        this._documents.add(domDocument);
+    }
+    /**
+     * @inheritDoc
+     */
+    stopObserving(domElement) {
+        this.stopListening(domElement);
+    }
+    /**
+     * @inheritDoc
+     */
+    destroy() {
+        super.destroy();
+        clearInterval(this._clearInfiniteLoopInterval);
+        this._fireSelectionChangeDoneDebounced.cancel();
+        this._documentIsSelectingInactivityTimeoutDebounced.cancel();
+    }
+    /* istanbul ignore next -- @preserve */
+    _reportInfiniteLoop() {
+        // @if CK_DEBUG //		throw new Error(
+        // @if CK_DEBUG //			'Selection change observer detected an infinite rendering loop.\n\n' +
+        // @if CK_DEBUG //	 		'⚠️⚠️ Report this error on https://github.com/ckeditor/ckeditor5/issues/11658.'
+        // @if CK_DEBUG //		);
+    }
+    /**
+     * Selection change listener. {@link module:engine/view/observer/mutationobserver~MutationObserver#flush Flush} mutations, check if
+     * a selection changes and fires {@link module:engine/view/document~Document#event:selectionChange} event on every change
+     * and {@link module:engine/view/document~Document#event:selectionChangeDone} when a selection stop changing.
+     *
+     * @param domEvent DOM event.
+     * @param domDocument DOM document.
+     */
+    _handleSelectionChange(domEvent, domDocument) {
+        if (!this.isEnabled) {
+            return;
+        }
+        const domSelection = domDocument.defaultView.getSelection();
+        if (this.checkShouldIgnoreEventFromTarget(domSelection.anchorNode)) {
+            return;
+        }
+        // Ensure the mutation event will be before selection event on all browsers.
+        this.mutationObserver.flush();
+        const newViewSelection = this.domConverter.domSelectionToView(domSelection);
+        // Do not convert selection change if the new view selection has no ranges in it.
+        //
+        // It means that the DOM selection is in some way incorrect. Ranges that were in the DOM selection could not be
+        // converted to the view. This happens when the DOM selection was moved outside of the editable element.
+        if (newViewSelection.rangeCount == 0) {
+            this.view.hasDomSelection = false;
+            return;
+        }
+        this.view.hasDomSelection = true;
+        // Mark the latest focus change as complete (we got new selection after the focus so the selection is in the focused element).
+        this.focusObserver.flush();
+        if (this.selection.isEqual(newViewSelection) && this.domConverter.isDomSelectionCorrect(domSelection)) {
+            return;
+        }
+        // Ensure we are not in the infinite loop (#400).
+        // This counter is reset each second. 60 selection changes in 1 second is enough high number
+        // to be very difficult (impossible) to achieve using just keyboard keys (during normal editor use).
+        if (++this._loopbackCounter > 60) {
+            // Selection change observer detected an infinite rendering loop.
+            // Most probably you try to put the selection in the position which is not allowed
+            // by the browser and browser fixes it automatically what causes `selectionchange` event on
+            // which a loopback through a model tries to re-render the wrong selection and again.
+            this._reportInfiniteLoop();
+            return;
+        }
+        if (this.selection.isSimilar(newViewSelection)) {
+            // If selection was equal and we are at this point of algorithm, it means that it was incorrect.
+            // Just re-render it, no need to fire any events, etc.
+            this.view.forceRender();
+        }
+        else {
+            const data = {
+                oldSelection: this.selection,
+                newSelection: newViewSelection,
+                domSelection
+            };
+            // @if CK_DEBUG_TYPING // if ( ( window as any ).logCKETyping ) {
+            // @if CK_DEBUG_TYPING // 	console.info( '%c[SelectionObserver]%c Fire selection change:',
+            // @if CK_DEBUG_TYPING // 		'font-weight:bold;color:green', '',
+            // @if CK_DEBUG_TYPING // 		newViewSelection.getFirstRange()
+            // @if CK_DEBUG_TYPING // 	);
+            // @if CK_DEBUG_TYPING // }
+            // Prepare data for new selection and fire appropriate events.
+            this.document.fire('selectionChange', data);
+            // Call `#_fireSelectionChangeDoneDebounced` every time when `selectionChange` event is fired.
+            // This function is debounced what means that `selectionChangeDone` event will be fired only when
+            // defined int the function time will elapse since the last time the function was called.
+            // So `selectionChangeDone` will be fired when selection will stop changing.
+            this._fireSelectionChangeDoneDebounced(data);
+        }
+    }
+    /**
+     * Clears `SelectionObserver` internal properties connected with preventing infinite loop.
+     */
+    _clearInfiniteLoop() {
+        this._loopbackCounter = 0;
+    }
+}

package/src/view/observer/tabobserver.d.ts

@@ -1,46 +1,46 @@
-/**
- * @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 engine/view/observer/tabobserver
- */
-import type View from '../view';
-import Observer from './observer';
-import type { KeyEventData } from './keyobserver';
-import type { BubblingEvent } from './bubblingemittermixin';
-/**
- * Tab observer introduces the {@link module:engine/view/document~Document#event:tab `Document#tab`} event.
- *
- * Note that because {@link module:engine/view/observer/tabobserver~TabObserver} is attached by the
- * {@link module:engine/view/view~View}, this event is available by default.
- */
-export default class TabObserver extends Observer {
-    /**
-     * @inheritDoc
-     */
-    constructor(view: View);
-    /**
-     * @inheritDoc
-     */
-    observe(): void;
-    /**
-     * @inheritDoc
-     */
-    stopObserving(): void;
-}
-/**
- * Event fired when the user presses a tab key.
- *
- * Introduced by {@link module:engine/view/observer/tabobserver~TabObserver}.
- *
- * Note that because {@link module:engine/view/observer/tabobserver~TabObserver} is attached by the
- * {@link module:engine/view/view~View}, this event is available by default.
- *
- * @eventName module:engine/view/document~Document#tab
- * @param data
- */
-export type ViewDocumentTabEvent = BubblingEvent<{
-    name: 'tab';
-    args: [data: KeyEventData];
-}>;
+/**
+ * @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 engine/view/observer/tabobserver
+ */
+import type View from '../view';
+import Observer from './observer';
+import type { KeyEventData } from './keyobserver';
+import type { BubblingEvent } from './bubblingemittermixin';
+/**
+ * Tab observer introduces the {@link module:engine/view/document~Document#event:tab `Document#tab`} event.
+ *
+ * Note that because {@link module:engine/view/observer/tabobserver~TabObserver} is attached by the
+ * {@link module:engine/view/view~View}, this event is available by default.
+ */
+export default class TabObserver extends Observer {
+    /**
+     * @inheritDoc
+     */
+    constructor(view: View);
+    /**
+     * @inheritDoc
+     */
+    observe(): void;
+    /**
+     * @inheritDoc
+     */
+    stopObserving(): void;
+}
+/**
+ * Event fired when the user presses a tab key.
+ *
+ * Introduced by {@link module:engine/view/observer/tabobserver~TabObserver}.
+ *
+ * Note that because {@link module:engine/view/observer/tabobserver~TabObserver} is attached by the
+ * {@link module:engine/view/view~View}, this event is available by default.
+ *
+ * @eventName module:engine/view/document~Document#tab
+ * @param data
+ */
+export type ViewDocumentTabEvent = BubblingEvent<{
+    name: 'tab';
+    args: [data: KeyEventData];
+}>;

package/src/view/observer/tabobserver.js

@@ -1,42 +1,42 @@
-/**
- * @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
- */
-import Observer from './observer';
-import BubblingEventInfo from './bubblingeventinfo';
-import { keyCodes } from '@ckeditor/ckeditor5-utils';
-/**
- * Tab observer introduces the {@link module:engine/view/document~Document#event:tab `Document#tab`} event.
- *
- * Note that because {@link module:engine/view/observer/tabobserver~TabObserver} is attached by the
- * {@link module:engine/view/view~View}, this event is available by default.
- */
-export default class TabObserver extends Observer {
-    /**
-     * @inheritDoc
-     */
-    constructor(view) {
-        super(view);
-        const doc = this.document;
-        doc.on('keydown', (evt, data) => {
-            if (!this.isEnabled ||
-                data.keyCode != keyCodes.tab ||
-                data.ctrlKey) {
-                return;
-            }
-            const event = new BubblingEventInfo(doc, 'tab', doc.selection.getFirstRange());
-            doc.fire(event, data);
-            if (event.stop.called) {
-                evt.stop();
-            }
-        });
-    }
-    /**
-     * @inheritDoc
-     */
-    observe() { }
-    /**
-     * @inheritDoc
-     */
-    stopObserving() { }
-}
+/**
+ * @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
+ */
+import Observer from './observer';
+import BubblingEventInfo from './bubblingeventinfo';
+import { keyCodes } from '@ckeditor/ckeditor5-utils';
+/**
+ * Tab observer introduces the {@link module:engine/view/document~Document#event:tab `Document#tab`} event.
+ *
+ * Note that because {@link module:engine/view/observer/tabobserver~TabObserver} is attached by the
+ * {@link module:engine/view/view~View}, this event is available by default.
+ */
+export default class TabObserver extends Observer {
+    /**
+     * @inheritDoc
+     */
+    constructor(view) {
+        super(view);
+        const doc = this.document;
+        doc.on('keydown', (evt, data) => {
+            if (!this.isEnabled ||
+                data.keyCode != keyCodes.tab ||
+                data.ctrlKey) {
+                return;
+            }
+            const event = new BubblingEventInfo(doc, 'tab', doc.selection.getFirstRange());
+            doc.fire(event, data);
+            if (event.stop.called) {
+                evt.stop();
+            }
+        });
+    }
+    /**
+     * @inheritDoc
+     */
+    observe() { }
+    /**
+     * @inheritDoc
+     */
+    stopObserving() { }
+}