@ckeditor/ckeditor5-engine 0.0.0-internal-20241017.0

package/src/view/observer/bubblingeventinfo.js

@@ -0,0 +1,37 @@
+/**
+ * @license Copyright (c) 2003-2024, 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/bubblingeventinfo
+ */
+import { EventInfo } from '@ckeditor/ckeditor5-utils';
+/**
+ * The event object passed to bubbling event callbacks. It is used to provide information about the event as well as a tool to
+ * manipulate it.
+ */
+export default class BubblingEventInfo extends EventInfo {
+    /**
+     * @param source The emitter.
+     * @param name The event name.
+     * @param startRange The view range that the bubbling should start from.
+     */
+    constructor(source, name, startRange) {
+        super(source, name);
+        this.startRange = startRange;
+        this._eventPhase = 'none';
+        this._currentTarget = null;
+    }
+    /**
+     * The current event phase.
+     */
+    get eventPhase() {
+        return this._eventPhase;
+    }
+    /**
+     * The current bubbling target.
+     */
+    get currentTarget() {
+        return this._currentTarget;
+    }
+}

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

@@ -0,0 +1,43 @@
+/**
+ * @license Copyright (c) 2003-2024, 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/clickobserver
+ */
+import DomEventObserver from './domeventobserver.js';
+import type DomEventData from './domeventdata.js';
+import type { BubblingEvent } from './bubblingemittermixin.js';
+/**
+ * {@link module:engine/view/document~Document#event:click Click} event observer.
+ *
+ * Note that this observer is not available by default. To make it available it needs to be added to
+ * {@link module:engine/view/view~View view controller} by a {@link module:engine/view/view~View#addObserver} method.
+ */
+export default class ClickObserver extends DomEventObserver<'click'> {
+    /**
+     * @inheritDoc
+     */
+    readonly domEventType: "click";
+    /**
+     * @inheritDoc
+     */
+    onDomEvent(domEvent: MouseEvent): void;
+}
+/**
+ * Fired when one of the editables has been clicked.
+ *
+ * Introduced by {@link module:engine/view/observer/clickobserver~ClickObserver}.
+ *
+ * Note that this event is not available by default. To make it available
+ * {@link module:engine/view/observer/clickobserver~ClickObserver} needs to be added
+ * to {@link module:engine/view/view~View} by a {@link module:engine/view/view~View#addObserver} method.
+ *
+ * @see module:engine/view/observer/clickobserver~ClickObserver
+ * @eventName module:engine/view/document~Document#click
+ * @param data Event data.
+ */
+export type ViewDocumentClickEvent = BubblingEvent<{
+    name: 'click';
+    args: [data: DomEventData<MouseEvent>];
+}>;

package/src/view/observer/clickobserver.js

@@ -0,0 +1,29 @@
+/**
+ * @license Copyright (c) 2003-2024, 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/clickobserver
+ */
+import DomEventObserver from './domeventobserver.js';
+/**
+ * {@link module:engine/view/document~Document#event:click Click} event observer.
+ *
+ * Note that this observer is not available by default. To make it available it needs to be added to
+ * {@link module:engine/view/view~View view controller} by a {@link module:engine/view/view~View#addObserver} method.
+ */
+export default class ClickObserver extends DomEventObserver {
+    constructor() {
+        super(...arguments);
+        /**
+         * @inheritDoc
+         */
+        this.domEventType = 'click';
+    }
+    /**
+     * @inheritDoc
+     */
+    onDomEvent(domEvent) {
+        this.fire(domEvent.type, domEvent);
+    }
+}

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

@@ -0,0 +1,82 @@
+/**
+ * @license Copyright (c) 2003-2024, 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/compositionobserver
+ */
+import DomEventObserver from './domeventobserver.js';
+import type View from '../view.js';
+import type DomEventData from './domeventdata.js';
+/**
+ * {@link module:engine/view/document~Document#event:compositionstart Compositionstart},
+ * {@link module:engine/view/document~Document#event:compositionupdate compositionupdate} and
+ * {@link module:engine/view/document~Document#event:compositionend compositionend} events observer.
+ *
+ * Note that this observer is attached by the {@link module:engine/view/view~View} and is available by default.
+ */
+export default class CompositionObserver extends DomEventObserver<'compositionstart' | 'compositionupdate' | 'compositionend'> {
+    /**
+     * @inheritDoc
+     */
+    readonly domEventType: readonly ["compositionstart", "compositionupdate", "compositionend"];
+    /**
+     * @inheritDoc
+     */
+    constructor(view: View);
+    /**
+     * @inheritDoc
+     */
+    onDomEvent(domEvent: CompositionEvent): void;
+}
+export interface CompositionEventData extends DomEventData<CompositionEvent> {
+    data: string | null;
+}
+/**
+ * Fired when composition starts inside one of the editables.
+ *
+ * Introduced by {@link module:engine/view/observer/compositionobserver~CompositionObserver}.
+ *
+ * Note that because {@link module:engine/view/observer/compositionobserver~CompositionObserver} is attached by the
+ * {@link module:engine/view/view~View} this event is available by default.
+ *
+ * @see module:engine/view/observer/compositionobserver~CompositionObserver
+ * @eventName module:engine/view/document~Document#compositionstart
+ * @param data Event data.
+ */
+export type ViewDocumentCompositionStartEvent = {
+    name: 'compositionstart';
+    args: [data: CompositionEventData];
+};
+/**
+ * Fired when composition is updated inside one of the editables.
+ *
+ * Introduced by {@link module:engine/view/observer/compositionobserver~CompositionObserver}.
+ *
+ * Note that because {@link module:engine/view/observer/compositionobserver~CompositionObserver} is attached by the
+ * {@link module:engine/view/view~View} this event is available by default.
+ *
+ * @see module:engine/view/observer/compositionobserver~CompositionObserver
+ * @eventName module:engine/view/document~Document#compositionupdate
+ * @param data Event data.
+ */
+export type ViewDocumentCompositionUpdateEvent = {
+    name: 'compositionupdate';
+    args: [data: CompositionEventData];
+};
+/**
+ * Fired when composition ends inside one of the editables.
+ *
+ * Introduced by {@link module:engine/view/observer/compositionobserver~CompositionObserver}.
+ *
+ * Note that because {@link module:engine/view/observer/compositionobserver~CompositionObserver} is attached by the
+ * {@link module:engine/view/view~View} this event is available by default.
+ *
+ * @see module:engine/view/observer/compositionobserver~CompositionObserver
+ * @eventName module:engine/view/document~Document#compositionend
+ * @param data Event data.
+ */
+export type ViewDocumentCompositionEndEvent = {
+    name: 'compositionend';
+    args: [data: CompositionEventData];
+};

package/src/view/observer/compositionobserver.js

@@ -0,0 +1,62 @@
+/**
+ * @license Copyright (c) 2003-2024, 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/compositionobserver
+ */
+import DomEventObserver from './domeventobserver.js';
+// @if CK_DEBUG_TYPING // const { _debouncedLine } = require( '../../dev-utils/utils.js' );
+/**
+ * {@link module:engine/view/document~Document#event:compositionstart Compositionstart},
+ * {@link module:engine/view/document~Document#event:compositionupdate compositionupdate} and
+ * {@link module:engine/view/document~Document#event:compositionend compositionend} events observer.
+ *
+ * Note that this observer is attached by the {@link module:engine/view/view~View} and is available by default.
+ */
+export default class CompositionObserver extends DomEventObserver {
+    /**
+     * @inheritDoc
+     */
+    constructor(view) {
+        super(view);
+        /**
+         * @inheritDoc
+         */
+        this.domEventType = ['compositionstart', 'compositionupdate', 'compositionend'];
+        const document = this.document;
+        document.on('compositionstart', () => {
+            // @if CK_DEBUG_TYPING // if ( ( window as any ).logCKETyping ) {
+            // @if CK_DEBUG_TYPING // 	console.log( '%c[CompositionObserver] ' +
+            // @if CK_DEBUG_TYPING // 		'┌───────────────────────────── isComposing = true ─────────────────────────────┐',
+            // @if CK_DEBUG_TYPING // 		'font-weight: bold; color: green'
+            // @if CK_DEBUG_TYPING // 	);
+            // @if CK_DEBUG_TYPING // }
+            document.isComposing = true;
+        }, { priority: 'low' });
+        document.on('compositionend', () => {
+            // @if CK_DEBUG_TYPING // if ( ( window as any ).logCKETyping ) {
+            // @if CK_DEBUG_TYPING // 	console.log( '%c[CompositionObserver] ' +
+            // @if CK_DEBUG_TYPING // 		'└───────────────────────────── isComposing = false ─────────────────────────────┘',
+            // @if CK_DEBUG_TYPING // 		'font-weight: bold; color: green'
+            // @if CK_DEBUG_TYPING // 	);
+            // @if CK_DEBUG_TYPING // }
+            document.isComposing = false;
+        }, { priority: 'low' });
+    }
+    /**
+     * @inheritDoc
+     */
+    onDomEvent(domEvent) {
+        // @if CK_DEBUG_TYPING // if ( ( window as any ).logCKETyping ) {
+        // @if CK_DEBUG_TYPING // 	_debouncedLine();
+        // @if CK_DEBUG_TYPING // 	console.group( `%c[CompositionObserver]%c ${ domEvent.type }`, 'color: green', '' );
+        // @if CK_DEBUG_TYPING // }
+        this.fire(domEvent.type, domEvent, {
+            data: domEvent.data
+        });
+        // @if CK_DEBUG_TYPING // if ( ( window as any ).logCKETyping ) {
+        // @if CK_DEBUG_TYPING // 	console.groupEnd();
+        // @if CK_DEBUG_TYPING // }
+    }
+}

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

@@ -0,0 +1,50 @@
+/**
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
+ * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
+ */
+import type Document from '../document.js';
+import type Element from '../element.js';
+import type View from '../view.js';
+/**
+ * Information about a DOM event in context of the {@link module:engine/view/document~Document}.
+ * It wraps the native event, which usually should not be used as the wrapper contains
+ * additional data (like key code for keyboard events).
+ *
+ * @typeParam TEvent The type of DOM Event that this class represents.
+ */
+export default class DomEventData<TEvent extends Event = Event> {
+    /**
+     * Instance of the view controller.
+     */
+    readonly view: View;
+    /**
+     * The instance of the document.
+     */
+    readonly document: Document;
+    /**
+     * The DOM event.
+     */
+    readonly domEvent: TEvent;
+    /**
+     * The DOM target.
+     */
+    readonly domTarget: HTMLElement;
+    /**
+     * @param view The instance of the view controller.
+     * @param domEvent The DOM event.
+     * @param additionalData Additional properties that the instance should contain.
+     */
+    constructor(view: View, domEvent: TEvent, additionalData?: object);
+    /**
+     * The tree view element representing the target.
+     */
+    get target(): Element;
+    /**
+     * Prevents the native's event default action.
+     */
+    preventDefault(): void;
+    /**
+     * Stops native event propagation.
+     */
+    stopPropagation(): void;
+}

package/src/view/observer/domeventdata.js

@@ -0,0 +1,47 @@
+/**
+ * @license Copyright (c) 2003-2024, 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/domeventdata
+ */
+import { extend } from 'lodash-es';
+/**
+ * Information about a DOM event in context of the {@link module:engine/view/document~Document}.
+ * It wraps the native event, which usually should not be used as the wrapper contains
+ * additional data (like key code for keyboard events).
+ *
+ * @typeParam TEvent The type of DOM Event that this class represents.
+ */
+export default class DomEventData {
+    /**
+     * @param view The instance of the view controller.
+     * @param domEvent The DOM event.
+     * @param additionalData Additional properties that the instance should contain.
+     */
+    constructor(view, domEvent, additionalData) {
+        this.view = view;
+        this.document = view.document;
+        this.domEvent = domEvent;
+        this.domTarget = domEvent.target;
+        extend(this, additionalData);
+    }
+    /**
+     * The tree view element representing the target.
+     */
+    get target() {
+        return this.view.domConverter.mapDomToView(this.domTarget);
+    }
+    /**
+     * Prevents the native's event default action.
+     */
+    preventDefault() {
+        this.domEvent.preventDefault();
+    }
+    /**
+     * Stops native event propagation.
+     */
+    stopPropagation() {
+        this.domEvent.stopPropagation();
+    }
+}

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

@@ -0,0 +1,78 @@
+/**
+ * @license Copyright (c) 2003-2024, 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/domeventobserver
+ */
+import Observer from './observer.js';
+import type { EventInfo } from '@ckeditor/ckeditor5-utils';
+/**
+ * Base class for DOM event observers. This class handles
+ * {@link module:engine/view/observer/observer~Observer#observe adding} listeners to DOM elements,
+ * {@link module:engine/view/observer/observer~Observer#disable disabling} and
+ * {@link module:engine/view/observer/observer~Observer#enable re-enabling} events.
+ * Child class needs to define
+ * {@link module:engine/view/observer/domeventobserver~DomEventObserver#domEventType DOM event type} and
+ * {@link module:engine/view/observer/domeventobserver~DomEventObserver#onDomEvent callback}.
+ *
+ * For instance:
+ *
+ * ```ts
+ * class ClickObserver extends DomEventObserver<'click'> {
+ * 	// It can also be defined as a normal property in the constructor.
+ * 	get domEventType(): 'click' {
+ * 		return 'click';
+ * 	}
+ *
+ * 	onDomEvent( domEvent: MouseEvent ): void {
+ * 		this.fire( 'click', domEvent );
+ * 	}
+ * }
+ * ```
+ *
+ * @typeParam EventType DOM Event type name or an union of those.
+ * @typeParam AdditionalData Additional data passed along with the event.
+ */
+export default abstract class DomEventObserver<EventType extends keyof HTMLElementEventMap, AdditionalData extends object = object> extends Observer {
+    /**
+     * Type of the DOM event the observer should listen to. Array of types can be defined
+     * if the observer should listen to multiple DOM events.
+     */
+    abstract get domEventType(): EventType | ReadonlyArray<EventType>;
+    /**
+     * If set to `true` DOM events will be listened on the capturing phase.
+     * Default value is `false`.
+     */
+    useCapture: boolean;
+    /**
+     * If set to `true`, indicates that the function specified by listener will never call `preventDefault()`.
+     * Default value is `false`.
+     */
+    usePassive: boolean;
+    /**
+     * Callback which should be called when the DOM event occurred. Note that the callback will not be called if
+     * observer {@link #isEnabled is not enabled}.
+     *
+     * @see #domEventType
+     */
+    abstract onDomEvent(event: HTMLElementEventMap[EventType]): void;
+    /**
+     * @inheritDoc
+     */
+    observe(domElement: HTMLElement): void;
+    /**
+     * @inheritDoc
+     */
+    stopObserving(domElement: HTMLElement): void;
+    /**
+     * Calls `Document#fire()` if observer {@link #isEnabled is enabled}.
+     *
+     * @see module:utils/emittermixin~Emitter#fire
+     * @param eventType The event type (name).
+     * @param domEvent The DOM event.
+     * @param additionalData The additional data which should extend the
+     * {@link module:engine/view/observer/domeventdata~DomEventData event data} object.
+     */
+    fire(eventType: string | EventInfo, domEvent: Event, additionalData?: AdditionalData): void;
+}

package/src/view/observer/domeventobserver.js

@@ -0,0 +1,84 @@
+/**
+ * @license Copyright (c) 2003-2024, 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/domeventobserver
+ */
+import Observer from './observer.js';
+import DomEventData from './domeventdata.js';
+/**
+ * Base class for DOM event observers. This class handles
+ * {@link module:engine/view/observer/observer~Observer#observe adding} listeners to DOM elements,
+ * {@link module:engine/view/observer/observer~Observer#disable disabling} and
+ * {@link module:engine/view/observer/observer~Observer#enable re-enabling} events.
+ * Child class needs to define
+ * {@link module:engine/view/observer/domeventobserver~DomEventObserver#domEventType DOM event type} and
+ * {@link module:engine/view/observer/domeventobserver~DomEventObserver#onDomEvent callback}.
+ *
+ * For instance:
+ *
+ * ```ts
+ * class ClickObserver extends DomEventObserver<'click'> {
+ * 	// It can also be defined as a normal property in the constructor.
+ * 	get domEventType(): 'click' {
+ * 		return 'click';
+ * 	}
+ *
+ * 	onDomEvent( domEvent: MouseEvent ): void {
+ * 		this.fire( 'click', domEvent );
+ * 	}
+ * }
+ * ```
+ *
+ * @typeParam EventType DOM Event type name or an union of those.
+ * @typeParam AdditionalData Additional data passed along with the event.
+ */
+export default class DomEventObserver extends Observer {
+    constructor() {
+        super(...arguments);
+        /**
+         * If set to `true` DOM events will be listened on the capturing phase.
+         * Default value is `false`.
+         */
+        this.useCapture = false;
+        /**
+         * If set to `true`, indicates that the function specified by listener will never call `preventDefault()`.
+         * Default value is `false`.
+         */
+        this.usePassive = false;
+    }
+    /**
+     * @inheritDoc
+     */
+    observe(domElement) {
+        const types = typeof this.domEventType == 'string' ? [this.domEventType] : this.domEventType;
+        types.forEach(type => {
+            this.listenTo(domElement, type, (eventInfo, domEvent) => {
+                if (this.isEnabled && !this.checkShouldIgnoreEventFromTarget(domEvent.target)) {
+                    this.onDomEvent(domEvent);
+                }
+            }, { useCapture: this.useCapture, usePassive: this.usePassive });
+        });
+    }
+    /**
+     * @inheritDoc
+     */
+    stopObserving(domElement) {
+        this.stopListening(domElement);
+    }
+    /**
+     * Calls `Document#fire()` if observer {@link #isEnabled is enabled}.
+     *
+     * @see module:utils/emittermixin~Emitter#fire
+     * @param eventType The event type (name).
+     * @param domEvent The DOM event.
+     * @param additionalData The additional data which should extend the
+     * {@link module:engine/view/observer/domeventdata~DomEventData event data} object.
+     */
+    fire(eventType, domEvent, additionalData) {
+        if (this.isEnabled) {
+            this.document.fire(eventType, new DomEventData(this.view, domEvent, additionalData));
+        }
+    }
+}

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

@@ -0,0 +1,47 @@
+/**
+ * @license Copyright (c) 2003-2024, 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/fakeselectionobserver
+ */
+import Observer from './observer.js';
+import type View from '../view.js';
+/**
+ * Fake selection observer class. If view selection is fake it is placed in dummy DOM container. This observer listens
+ * on {@link module:engine/view/document~Document#event:keydown keydown} events and handles moving fake view selection to the correct place
+ * if arrow keys are pressed.
+ * Fires {@link module:engine/view/document~Document#event:selectionChange selectionChange event} simulating natural behaviour of
+ * {@link module:engine/view/observer/selectionobserver~SelectionObserver SelectionObserver}.
+ */
+export default class FakeSelectionObserver extends Observer {
+    /**
+     * Fires debounced event `selectionChangeDone`. It uses `lodash#debounce` method to delay function call.
+     */
+    private readonly _fireSelectionChangeDoneDebounced;
+    /**
+     * Creates new FakeSelectionObserver instance.
+     */
+    constructor(view: View);
+    /**
+     * @inheritDoc
+     */
+    observe(): void;
+    /**
+     * @inheritDoc
+     */
+    stopObserving(): void;
+    /**
+     * @inheritDoc
+     */
+    destroy(): void;
+    /**
+     * Handles collapsing view selection according to given key code. If left or up key is provided - new selection will be
+     * collapsed to left. If right or down key is pressed - new selection will be collapsed to right.
+     *
+     * This method fires {@link module:engine/view/document~Document#event:selectionChange} and
+     * {@link module:engine/view/document~Document#event:selectionChangeDone} events imitating behaviour of
+     * {@link module:engine/view/observer/selectionobserver~SelectionObserver}.
+     */
+    private _handleSelectionMove;
+}

package/src/view/observer/fakeselectionobserver.js

@@ -0,0 +1,91 @@
+/**
+ * @license Copyright (c) 2003-2024, 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/fakeselectionobserver
+ */
+import Observer from './observer.js';
+import ViewSelection from '../selection.js';
+import { keyCodes } from '@ckeditor/ckeditor5-utils';
+import { debounce } from 'lodash-es';
+/**
+ * Fake selection observer class. If view selection is fake it is placed in dummy DOM container. This observer listens
+ * on {@link module:engine/view/document~Document#event:keydown keydown} events and handles moving fake view selection to the correct place
+ * if arrow keys are pressed.
+ * Fires {@link module:engine/view/document~Document#event:selectionChange selectionChange event} simulating natural behaviour of
+ * {@link module:engine/view/observer/selectionobserver~SelectionObserver SelectionObserver}.
+ */
+export default class FakeSelectionObserver extends Observer {
+    /**
+     * Creates new FakeSelectionObserver instance.
+     */
+    constructor(view) {
+        super(view);
+        this._fireSelectionChangeDoneDebounced = debounce(data => {
+            this.document.fire('selectionChangeDone', data);
+        }, 200);
+    }
+    /**
+     * @inheritDoc
+     */
+    observe() {
+        const document = this.document;
+        document.on('arrowKey', (eventInfo, data) => {
+            const selection = document.selection;
+            if (selection.isFake && this.isEnabled) {
+                // Prevents default key down handling - no selection change will occur.
+                data.preventDefault();
+            }
+        }, { context: '$capture' });
+        document.on('arrowKey', (eventInfo, data) => {
+            const selection = document.selection;
+            if (selection.isFake && this.isEnabled) {
+                this._handleSelectionMove(data.keyCode);
+            }
+        }, { priority: 'lowest' });
+    }
+    /**
+     * @inheritDoc
+     */
+    stopObserving() { }
+    /**
+     * @inheritDoc
+     */
+    destroy() {
+        super.destroy();
+        this._fireSelectionChangeDoneDebounced.cancel();
+    }
+    /**
+     * Handles collapsing view selection according to given key code. If left or up key is provided - new selection will be
+     * collapsed to left. If right or down key is pressed - new selection will be collapsed to right.
+     *
+     * This method fires {@link module:engine/view/document~Document#event:selectionChange} and
+     * {@link module:engine/view/document~Document#event:selectionChangeDone} events imitating behaviour of
+     * {@link module:engine/view/observer/selectionobserver~SelectionObserver}.
+     */
+    _handleSelectionMove(keyCode) {
+        const selection = this.document.selection;
+        const newSelection = new ViewSelection(selection.getRanges(), { backward: selection.isBackward, fake: false });
+        // Left or up arrow pressed - move selection to start.
+        if (keyCode == keyCodes.arrowleft || keyCode == keyCodes.arrowup) {
+            newSelection.setTo(newSelection.getFirstPosition());
+        }
+        // Right or down arrow pressed - move selection to end.
+        if (keyCode == keyCodes.arrowright || keyCode == keyCodes.arrowdown) {
+            newSelection.setTo(newSelection.getLastPosition());
+        }
+        const data = {
+            oldSelection: selection,
+            newSelection,
+            domSelection: null
+        };
+        // Fire dummy selection change event.
+        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);
+    }
+}