@ckeditor/ckeditor5-engine 39.0.1 → 40.0.0

package/src/view/observer/focusobserver.js

@@ -1,86 +1,86 @@
-/**
- * @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/focusobserver
- */
-/* globals setTimeout, clearTimeout */
-import DomEventObserver from './domeventobserver';
-/**
- * {@link module:engine/view/document~Document#event:focus Focus}
- * and {@link module:engine/view/document~Document#event:blur blur} events observer.
- * Focus observer handle also {@link module:engine/view/rooteditableelement~RootEditableElement#isFocused isFocused} property of the
- * {@link module:engine/view/rooteditableelement~RootEditableElement root elements}.
- *
- * Note that this observer is attached by the {@link module:engine/view/view~View} and is available by default.
- */
-export default class FocusObserver extends DomEventObserver {
-    /**
-     * @inheritDoc
-     */
-    constructor(view) {
-        super(view);
-        /**
-         * Set to `true` if the document is in the process of setting the focus.
-         *
-         * The flag is used to indicate that setting the focus is in progress.
-         */
-        this._isFocusChanging = false;
-        /**
-         * @inheritDoc
-         */
-        this.domEventType = ['focus', 'blur'];
-        this.useCapture = true;
-        const document = this.document;
-        document.on('focus', () => {
-            this._isFocusChanging = true;
-            // Unfortunately native `selectionchange` event is fired asynchronously.
-            // We need to wait until `SelectionObserver` handle the event and then render. Otherwise rendering will
-            // overwrite new DOM selection with selection from the view.
-            // See https://github.com/ckeditor/ckeditor5-engine/issues/795 for more details.
-            // Long timeout is needed to solve #676 and https://github.com/ckeditor/ckeditor5-engine/issues/1157 issues.
-            //
-            // Using `view.change()` instead of `view.forceRender()` to prevent double rendering
-            // in a situation where `selectionchange` already caused selection change.
-            this._renderTimeoutId = setTimeout(() => {
-                this.flush();
-                view.change(() => { });
-            }, 50);
-        });
-        document.on('blur', (evt, data) => {
-            const selectedEditable = document.selection.editableElement;
-            if (selectedEditable === null || selectedEditable === data.target) {
-                document.isFocused = false;
-                this._isFocusChanging = false;
-                // Re-render the document to update view elements
-                // (changing document.isFocused already marked view as changed since last rendering).
-                view.change(() => { });
-            }
-        });
-    }
-    /**
-     * Finishes setting the document focus state.
-     */
-    flush() {
-        if (this._isFocusChanging) {
-            this._isFocusChanging = false;
-            this.document.isFocused = true;
-        }
-    }
-    /**
-     * @inheritDoc
-     */
-    onDomEvent(domEvent) {
-        this.fire(domEvent.type, domEvent);
-    }
-    /**
-     * @inheritDoc
-     */
-    destroy() {
-        if (this._renderTimeoutId) {
-            clearTimeout(this._renderTimeoutId);
-        }
-        super.destroy();
-    }
-}
+/**
+ * @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/focusobserver
+ */
+/* globals setTimeout, clearTimeout */
+import DomEventObserver from './domeventobserver';
+/**
+ * {@link module:engine/view/document~Document#event:focus Focus}
+ * and {@link module:engine/view/document~Document#event:blur blur} events observer.
+ * Focus observer handle also {@link module:engine/view/rooteditableelement~RootEditableElement#isFocused isFocused} property of the
+ * {@link module:engine/view/rooteditableelement~RootEditableElement root elements}.
+ *
+ * Note that this observer is attached by the {@link module:engine/view/view~View} and is available by default.
+ */
+export default class FocusObserver extends DomEventObserver {
+    /**
+     * @inheritDoc
+     */
+    constructor(view) {
+        super(view);
+        /**
+         * Set to `true` if the document is in the process of setting the focus.
+         *
+         * The flag is used to indicate that setting the focus is in progress.
+         */
+        this._isFocusChanging = false;
+        /**
+         * @inheritDoc
+         */
+        this.domEventType = ['focus', 'blur'];
+        this.useCapture = true;
+        const document = this.document;
+        document.on('focus', () => {
+            this._isFocusChanging = true;
+            // Unfortunately native `selectionchange` event is fired asynchronously.
+            // We need to wait until `SelectionObserver` handle the event and then render. Otherwise rendering will
+            // overwrite new DOM selection with selection from the view.
+            // See https://github.com/ckeditor/ckeditor5-engine/issues/795 for more details.
+            // Long timeout is needed to solve #676 and https://github.com/ckeditor/ckeditor5-engine/issues/1157 issues.
+            //
+            // Using `view.change()` instead of `view.forceRender()` to prevent double rendering
+            // in a situation where `selectionchange` already caused selection change.
+            this._renderTimeoutId = setTimeout(() => {
+                this.flush();
+                view.change(() => { });
+            }, 50);
+        });
+        document.on('blur', (evt, data) => {
+            const selectedEditable = document.selection.editableElement;
+            if (selectedEditable === null || selectedEditable === data.target) {
+                document.isFocused = false;
+                this._isFocusChanging = false;
+                // Re-render the document to update view elements
+                // (changing document.isFocused already marked view as changed since last rendering).
+                view.change(() => { });
+            }
+        });
+    }
+    /**
+     * Finishes setting the document focus state.
+     */
+    flush() {
+        if (this._isFocusChanging) {
+            this._isFocusChanging = false;
+            this.document.isFocused = true;
+        }
+    }
+    /**
+     * @inheritDoc
+     */
+    onDomEvent(domEvent) {
+        this.fire(domEvent.type, domEvent);
+    }
+    /**
+     * @inheritDoc
+     */
+    destroy() {
+        if (this._renderTimeoutId) {
+            clearTimeout(this._renderTimeoutId);
+        }
+        super.destroy();
+    }
+}

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

@@ -1,86 +1,86 @@
-/**
- * @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/inputobserver
- */
-import DomEventObserver from './domeventobserver';
-import type DomEventData from './domeventdata';
-import type ViewRange from '../range';
-import DataTransfer from '../datatransfer';
-/**
- * Observer for events connected with data input.
- *
- * **Note**: This observer is attached by {@link module:engine/view/view~View} and available by default in all
- * editor instances.
- */
-export default class InputObserver extends DomEventObserver<'beforeinput'> {
-    /**
-     * @inheritDoc
-     */
-    readonly domEventType: "beforeinput";
-    /**
-     * @inheritDoc
-     */
-    onDomEvent(domEvent: InputEvent): void;
-}
-/**
- * Fired before the web browser inputs, deletes, or formats some data.
- *
- * This event is introduced by {@link module:engine/view/observer/inputobserver~InputObserver} and available
- * by default in all editor instances (attached by {@link module:engine/view/view~View}).
- *
- * @see module:engine/view/observer/inputobserver~InputObserver
- * @eventName module:engine/view/document~Document#beforeinput
- * @param data Event data containing detailed information about the event.
- */
-export type ViewDocumentInputEvent = {
-    name: 'beforeinput';
-    args: [data: InputEventData];
-};
-/**
- * The value of the {@link ~ViewDocumentInputEvent} event.
- */
-export interface InputEventData extends DomEventData<InputEvent> {
-    /**
-     * The type of the input event (e.g. "insertText" or "deleteWordBackward"). Corresponds to native `InputEvent#inputType`.
-     */
-    readonly inputType: string;
-    /**
-     * A unified text data passed along with the input event. Depending on:
-     *
-     * * the web browser and input events implementation (for instance [Level 1](https://www.w3.org/TR/input-events-1/) or
-     * [Level 2](https://www.w3.org/TR/input-events-2/)),
-     * * {@link module:engine/view/observer/inputobserver~InputEventData#inputType input type}
-     *
-     * text data is sometimes passed in the `data` and sometimes in the `dataTransfer` property.
-     *
-     * * If `InputEvent#data` was set, this property reflects its value.
-     * * If `InputEvent#data` is unavailable, this property contains the `'text/plain'` data from
-     * {@link module:engine/view/observer/inputobserver~InputEventData#dataTransfer}.
-     * * If the event ({@link module:engine/view/observer/inputobserver~InputEventData#inputType input type})
-     * provides no data whatsoever, this property is `null`.
-     */
-    readonly data: string | null;
-    /**
-     * The data transfer instance of the input event. Corresponds to native `InputEvent#dataTransfer`.
-     *
-     * The value is `null` when no `dataTransfer` was passed along with the input event.
-     */
-    readonly dataTransfer: DataTransfer;
-    /**
-     * A flag indicating that the `beforeinput` event was fired during composition.
-     *
-     * Corresponds to the
-     * {@link module:engine/view/document~Document#event:compositionstart},
-     * {@link module:engine/view/document~Document#event:compositionupdate},
-     * and {@link module:engine/view/document~Document#event:compositionend } trio.
-     */
-    readonly isComposing: boolean;
-    /**
-     * Editing {@link module:engine/view/range~Range view ranges} corresponding to DOM ranges provided by the web browser
-     * (as returned by `InputEvent#getTargetRanges()`).
-     */
-    readonly targetRanges: Array<ViewRange>;
-}
+/**
+ * @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/inputobserver
+ */
+import DomEventObserver from './domeventobserver';
+import type DomEventData from './domeventdata';
+import type ViewRange from '../range';
+import DataTransfer from '../datatransfer';
+/**
+ * Observer for events connected with data input.
+ *
+ * **Note**: This observer is attached by {@link module:engine/view/view~View} and available by default in all
+ * editor instances.
+ */
+export default class InputObserver extends DomEventObserver<'beforeinput'> {
+    /**
+     * @inheritDoc
+     */
+    readonly domEventType: "beforeinput";
+    /**
+     * @inheritDoc
+     */
+    onDomEvent(domEvent: InputEvent): void;
+}
+/**
+ * Fired before the web browser inputs, deletes, or formats some data.
+ *
+ * This event is introduced by {@link module:engine/view/observer/inputobserver~InputObserver} and available
+ * by default in all editor instances (attached by {@link module:engine/view/view~View}).
+ *
+ * @see module:engine/view/observer/inputobserver~InputObserver
+ * @eventName module:engine/view/document~Document#beforeinput
+ * @param data Event data containing detailed information about the event.
+ */
+export type ViewDocumentInputEvent = {
+    name: 'beforeinput';
+    args: [data: InputEventData];
+};
+/**
+ * The value of the {@link ~ViewDocumentInputEvent} event.
+ */
+export interface InputEventData extends DomEventData<InputEvent> {
+    /**
+     * The type of the input event (e.g. "insertText" or "deleteWordBackward"). Corresponds to native `InputEvent#inputType`.
+     */
+    readonly inputType: string;
+    /**
+     * A unified text data passed along with the input event. Depending on:
+     *
+     * * the web browser and input events implementation (for instance [Level 1](https://www.w3.org/TR/input-events-1/) or
+     * [Level 2](https://www.w3.org/TR/input-events-2/)),
+     * * {@link module:engine/view/observer/inputobserver~InputEventData#inputType input type}
+     *
+     * text data is sometimes passed in the `data` and sometimes in the `dataTransfer` property.
+     *
+     * * If `InputEvent#data` was set, this property reflects its value.
+     * * If `InputEvent#data` is unavailable, this property contains the `'text/plain'` data from
+     * {@link module:engine/view/observer/inputobserver~InputEventData#dataTransfer}.
+     * * If the event ({@link module:engine/view/observer/inputobserver~InputEventData#inputType input type})
+     * provides no data whatsoever, this property is `null`.
+     */
+    readonly data: string | null;
+    /**
+     * The data transfer instance of the input event. Corresponds to native `InputEvent#dataTransfer`.
+     *
+     * The value is `null` when no `dataTransfer` was passed along with the input event.
+     */
+    readonly dataTransfer: DataTransfer;
+    /**
+     * A flag indicating that the `beforeinput` event was fired during composition.
+     *
+     * Corresponds to the
+     * {@link module:engine/view/document~Document#event:compositionstart},
+     * {@link module:engine/view/document~Document#event:compositionupdate},
+     * and {@link module:engine/view/document~Document#event:compositionend } trio.
+     */
+    readonly isComposing: boolean;
+    /**
+     * Editing {@link module:engine/view/range~Range view ranges} corresponding to DOM ranges provided by the web browser
+     * (as returned by `InputEvent#getTargetRanges()`).
+     */
+    readonly targetRanges: Array<ViewRange>;
+}