@ckeditor/ckeditor5-engine 38.2.0-alpha.1 → 39.0.0

package/src/view/rooteditableelement.js

@@ -5,7 +5,7 @@
 /**
  * @module engine/view/rooteditableelement
  */
-import EditableElement from './editableelement.js';
+import EditableElement from './editableelement';
 const rootNameSymbol = Symbol('rootName');
 /**
  * Class representing a single root in the data view. A root can be either {@link ~RootEditableElement#isReadOnly editable or read-only},

package/src/view/selection.d.ts

@@ -5,14 +5,14 @@
 /**
  * @module engine/view/selection
  */
-import TypeCheckable from './typecheckable.js';
-import Range from './range.js';
-import Position, { type PositionOffset } from './position.js';
-import Node from './node.js';
-import DocumentSelection from './documentselection.js';
-import type Element from './element.js';
-import type Item from './item.js';
-import type EditableElement from './editableelement.js';
+import TypeCheckable from './typecheckable';
+import Range from './range';
+import Position, { type PositionOffset } from './position';
+import Node from './node';
+import DocumentSelection from './documentselection';
+import type Element from './element';
+import type Item from './item';
+import type EditableElement from './editableelement';
 declare const Selection_base: import("@ckeditor/ckeditor5-utils").Mixed<typeof TypeCheckable, import("@ckeditor/ckeditor5-utils").Emitter>;
 /**
  * Class representing an arbirtary selection in the view.

package/src/view/selection.js

@@ -5,11 +5,11 @@
 /**
  * @module engine/view/selection
  */
-import TypeCheckable from './typecheckable.js';
-import Range from './range.js';
-import Position from './position.js';
-import Node from './node.js';
-import DocumentSelection from './documentselection.js';
+import TypeCheckable from './typecheckable';
+import Range from './range';
+import Position from './position';
+import Node from './node';
+import DocumentSelection from './documentselection';
 import { CKEditorError, EmitterMixin, count, isIterable } from '@ckeditor/ckeditor5-utils';
 /**
  * Class representing an arbirtary selection in the view.

package/src/view/styles/background.d.ts

@@ -5,7 +5,7 @@
 /**
  * @module engine/view/styles/background
  */
-import type { StylesProcessor } from '../stylesmap.js';
+import type { StylesProcessor } from '../stylesmap';
 /**
  * Adds a background CSS styles processing rules.
  *

package/src/view/styles/background.js

@@ -2,7 +2,7 @@
  * @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 { getShorthandValues, isAttachment, isColor, isPosition, isRepeat, isURL } from './utils.js';
+import { getShorthandValues, isAttachment, isColor, isPosition, isRepeat, isURL } from './utils';
 /**
  * Adds a background CSS styles processing rules.
  *

package/src/view/styles/border.d.ts

@@ -5,7 +5,7 @@
 /**
  * @module engine/view/styles/border
  */
-import type { StylesProcessor } from '../stylesmap.js';
+import type { StylesProcessor } from '../stylesmap';
 /**
  * Adds a border CSS styles processing rules.
  *

package/src/view/styles/border.js

@@ -2,7 +2,7 @@
  * @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 { getShorthandValues, getBoxSidesValueReducer, getBoxSidesValues, isLength, isLineStyle } from './utils.js';
+import { getShorthandValues, getBoxSidesValueReducer, getBoxSidesValues, isLength, isLineStyle } from './utils';
 /**
  * Adds a border CSS styles processing rules.
  *

package/src/view/styles/margin.d.ts

@@ -5,7 +5,7 @@
 /**
  * @module engine/view/styles/margin
  */
-import type { StylesProcessor } from '../stylesmap.js';
+import type { StylesProcessor } from '../stylesmap';
 /**
  * Adds a margin CSS styles processing rules.
  *

package/src/view/styles/margin.js

@@ -2,7 +2,7 @@
  * @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 { getPositionShorthandNormalizer, getBoxSidesValueReducer } from './utils.js';
+import { getPositionShorthandNormalizer, getBoxSidesValueReducer } from './utils';
 /**
  * Adds a margin CSS styles processing rules.
  *

package/src/view/styles/padding.d.ts

@@ -5,7 +5,7 @@
 /**
  * @module engine/view/styles/padding
  */
-import type { StylesProcessor } from '../stylesmap.js';
+import type { StylesProcessor } from '../stylesmap';
 /**
  * Adds a margin CSS styles processing rules.
  *

package/src/view/styles/padding.js

@@ -2,7 +2,7 @@
  * @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 { getPositionShorthandNormalizer, getBoxSidesValueReducer } from './utils.js';
+import { getPositionShorthandNormalizer, getBoxSidesValueReducer } from './utils';
 /**
  * Adds a margin CSS styles processing rules.
  *

package/src/view/styles/utils.d.ts

@@ -5,7 +5,7 @@
 /**
  * @module engine/view/styles/utils
  */
-import type { BoxSides, PropertyDescriptor, StyleValue } from '../stylesmap.js';
+import type { BoxSides, PropertyDescriptor, StyleValue } from '../stylesmap';
 /**
  * Checks if string contains [color](https://developer.mozilla.org/en-US/docs/Web/CSS/color) CSS value.
  *

package/src/view/text.d.ts

@@ -5,8 +5,8 @@
 /**
  * @module engine/view/text
  */
-import Node from './node.js';
-import type Document from './document.js';
+import Node from './node';
+import type Document from './document';
 /**
  * Tree view text node.
  *

package/src/view/text.js

@@ -5,7 +5,7 @@
 /**
  * @module engine/view/text
  */
-import Node from './node.js';
+import Node from './node';
 /**
  * Tree view text node.
  *

package/src/view/textproxy.d.ts

@@ -5,12 +5,12 @@
 /**
  * @module engine/view/textproxy
  */
-import TypeCheckable from './typecheckable.js';
-import type Document from './document.js';
-import type DocumentFragment from './documentfragment.js';
-import type Element from './element.js';
-import type Node from './node.js';
-import type Text from './text.js';
+import TypeCheckable from './typecheckable';
+import type Document from './document';
+import type DocumentFragment from './documentfragment';
+import type Element from './element';
+import type Node from './node';
+import type Text from './text';
 /**
  * TextProxy is a wrapper for substring of {@link module:engine/view/text~Text}. Instance of this class is created by
  * {@link module:engine/view/treewalker~TreeWalker} when only a part of {@link module:engine/view/text~Text} needs to be returned.

package/src/view/textproxy.js

@@ -5,7 +5,7 @@
 /**
  * @module engine/view/textproxy
  */
-import TypeCheckable from './typecheckable.js';
+import TypeCheckable from './typecheckable';
 import { CKEditorError } from '@ckeditor/ckeditor5-utils';
 /**
  * TextProxy is a wrapper for substring of {@link module:engine/view/text~Text}. Instance of this class is created by

package/src/view/treewalker.d.ts

@@ -2,9 +2,9 @@
  * @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 Position from './position.js';
-import type Item from './item.js';
-import type Range from './range.js';
+import Position from './position';
+import type Item from './item';
+import type Range from './range';
 /**
  * Position iterator class. It allows to iterate forward and backward over the document.
  */

package/src/view/treewalker.js

@@ -5,10 +5,10 @@
 /**
  * @module engine/view/treewalker
  */
-import Element from './element.js';
-import Text from './text.js';
-import TextProxy from './textproxy.js';
-import Position from './position.js';
+import Element from './element';
+import Text from './text';
+import TextProxy from './textproxy';
+import Position from './position';
 import { CKEditorError } from '@ckeditor/ckeditor5-utils';
 /**
  * Position iterator class. It allows to iterate forward and backward over the document.

package/src/view/typecheckable.d.ts

@@ -2,22 +2,22 @@
  * @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 type AttributeElement from './attributeelement.js';
-import type ContainerElement from './containerelement.js';
-import type DocumentFragment from './documentfragment.js';
-import type DocumentSelection from './documentselection.js';
-import type EditableElement from './editableelement.js';
-import type Element from './element.js';
-import type EmptyElement from './emptyelement.js';
-import type Node from './node.js';
-import type Position from './position.js';
-import type Range from './range.js';
-import type RawElement from './rawelement.js';
-import type RootEditableElement from './rooteditableelement.js';
-import type Selection from './selection.js';
-import type Text from './text.js';
-import type TextProxy from './textproxy.js';
-import type UIElement from './uielement.js';
+import type AttributeElement from './attributeelement';
+import type ContainerElement from './containerelement';
+import type DocumentFragment from './documentfragment';
+import type DocumentSelection from './documentselection';
+import type EditableElement from './editableelement';
+import type Element from './element';
+import type EmptyElement from './emptyelement';
+import type Node from './node';
+import type Position from './position';
+import type Range from './range';
+import type RawElement from './rawelement';
+import type RootEditableElement from './rooteditableelement';
+import type Selection from './selection';
+import type Text from './text';
+import type TextProxy from './textproxy';
+import type UIElement from './uielement';
 /**
  * @module engine/view/typecheckable
  */

package/src/view/uielement.d.ts

@@ -5,12 +5,12 @@
 /**
  * @module engine/view/uielement
  */
-import Element, { type ElementAttributes } from './element.js';
-import Node from './node.js';
-import type View from './view.js';
-import type Document from './document.js';
-import type DomConverter from './domconverter.js';
-import type Item from './item.js';
+import Element, { type ElementAttributes } from './element';
+import Node from './node';
+import type View from './view';
+import type Document from './document';
+import type DomConverter from './domconverter';
+import type Item from './item';
 type DomDocument = globalThis.Document;
 type DomElement = globalThis.HTMLElement;
 /**

package/src/view/uielement.js

@@ -5,8 +5,8 @@
 /**
  * @module engine/view/uielement
  */
-import Element from './element.js';
-import Node from './node.js';
+import Element from './element';
+import Node from './node';
 import { CKEditorError, keyCodes } from '@ckeditor/ckeditor5-utils';
 /**
  * UI element class. It should be used to represent editing UI which needs to be injected into the editing view

package/src/view/upcastwriter.d.ts

@@ -5,15 +5,15 @@
 /**
  * @module engine/view/upcastwriter
  */
-import DocumentFragment from './documentfragment.js';
-import Element, { type ElementAttributes } from './element.js';
-import Text from './text.js';
-import Position, { type PositionOffset } from './position.js';
-import Range from './range.js';
-import Selection, { type PlaceOrOffset, type Selectable, type SelectionOptions } from './selection.js';
-import type Document from './document.js';
-import type Item from './item.js';
-import type Node from './node.js';
+import DocumentFragment from './documentfragment';
+import Element, { type ElementAttributes } from './element';
+import Text from './text';
+import Position, { type PositionOffset } from './position';
+import Range from './range';
+import Selection, { type PlaceOrOffset, type Selectable, type SelectionOptions } from './selection';
+import type Document from './document';
+import type Item from './item';
+import type Node from './node';
 /**
  * View upcast writer. It provides a set of methods used to manipulate non-semantic view trees.
  *

package/src/view/upcastwriter.js

@@ -5,13 +5,13 @@
 /**
  * @module engine/view/upcastwriter
  */
-import DocumentFragment from './documentfragment.js';
-import Element from './element.js';
-import Text from './text.js';
+import DocumentFragment from './documentfragment';
+import Element from './element';
+import Text from './text';
 import { isPlainObject } from 'lodash-es';
-import Position from './position.js';
-import Range from './range.js';
-import Selection from './selection.js';
+import Position from './position';
+import Range from './range';
+import Selection from './selection';
 /**
  * View upcast writer. It provides a set of methods used to manipulate non-semantic view trees.
  *

package/src/view/view.d.ts

@@ -5,18 +5,27 @@
 /**
  * @module engine/view/view
  */
-import Document from './document.js';
-import DowncastWriter from './downcastwriter.js';
-import Renderer from './renderer.js';
-import DomConverter from './domconverter.js';
-import Position, { type PositionOffset } from './position.js';
-import Range from './range.js';
-import Selection, { type PlaceOrOffset, type Selectable, type SelectionOptions } from './selection.js';
-import type { default as Observer, ObserverConstructor } from './observer/observer.js';
-import type { StylesProcessor } from './stylesmap.js';
-import type Element from './element.js';
-import type Node from './node.js';
-import type Item from './item.js';
+import Document from './document';
+import DowncastWriter from './downcastwriter';
+import Renderer from './renderer';
+import DomConverter from './domconverter';
+import Position, { type PositionOffset } from './position';
+import Range from './range';
+import Selection, { type PlaceOrOffset, type Selectable, type SelectionOptions } from './selection';
+import type { default as Observer, ObserverConstructor } from './observer/observer';
+import type { StylesProcessor } from './stylesmap';
+import type Element from './element';
+import type Node from './node';
+import type Item from './item';
+import KeyObserver from './observer/keyobserver';
+import FakeSelectionObserver from './observer/fakeselectionobserver';
+import MutationObserver from './observer/mutationobserver';
+import SelectionObserver from './observer/selectionobserver';
+import FocusObserver from './observer/focusobserver';
+import CompositionObserver from './observer/compositionobserver';
+import InputObserver from './observer/inputobserver';
+import ArrowKeysObserver from './observer/arrowkeysobserver';
+import TabObserver from './observer/tabobserver';
 type IfTrue<T> = T extends true ? true : never;
 type DomRange = globalThis.Range;
 declare const View_base: {
@@ -168,13 +177,7 @@ export default class View extends View_base {
      * @returns Added observer instance.
      */
     addObserver(ObserverConstructor: ObserverConstructor): Observer;
-    /**
-     * Returns observer of the given type or `undefined` if such observer has not been added yet.
-     *
-     * @param ObserverConstructor The constructor of an observer to get.
-     * @returns Observer instance or undefined.
-     */
-    getObserver<T extends ObserverConstructor>(ObserverConstructor: T): InstanceType<T> | undefined;
+    getObserver<T extends ObserverConstructor>(ObserverConstructor: T): T extends AlwaysRegisteredObservers ? InstanceType<T> : InstanceType<T> | undefined;
     /**
      * Disables all added observers.
      */
@@ -477,4 +480,8 @@ export type ViewScrollToTheSelectionEventData = {
     alignToTop?: boolean;
     forceScroll?: boolean;
 };
+/**
+ * Observers that are always registered.
+ */
+export type AlwaysRegisteredObservers = typeof MutationObserver | typeof FocusObserver | typeof SelectionObserver | typeof KeyObserver | typeof FakeSelectionObserver | typeof CompositionObserver | typeof ArrowKeysObserver | typeof InputObserver | typeof TabObserver;
 export {};

package/src/view/view.js

@@ -5,25 +5,25 @@
 /**
  * @module engine/view/view
  */
-import Document from './document.js';
-import DowncastWriter from './downcastwriter.js';
-import Renderer from './renderer.js';
-import DomConverter from './domconverter.js';
-import Position from './position.js';
-import Range from './range.js';
-import Selection from './selection.js';
-import KeyObserver from './observer/keyobserver.js';
-import FakeSelectionObserver from './observer/fakeselectionobserver.js';
-import MutationObserver from './observer/mutationobserver.js';
-import SelectionObserver from './observer/selectionobserver.js';
-import FocusObserver from './observer/focusobserver.js';
-import CompositionObserver from './observer/compositionobserver.js';
-import InputObserver from './observer/inputobserver.js';
-import ArrowKeysObserver from './observer/arrowkeysobserver.js';
-import TabObserver from './observer/tabobserver.js';
-import { CKEditorError, ObservableMixin, scrollViewportToShowTarget } from '@ckeditor/ckeditor5-utils';
-import { injectUiElementHandling } from './uielement.js';
-import { injectQuirksHandling } from './filler.js';
+import Document from './document';
+import DowncastWriter from './downcastwriter';
+import Renderer from './renderer';
+import DomConverter from './domconverter';
+import Position from './position';
+import Range from './range';
+import Selection from './selection';
+import KeyObserver from './observer/keyobserver';
+import FakeSelectionObserver from './observer/fakeselectionobserver';
+import MutationObserver from './observer/mutationobserver';
+import SelectionObserver from './observer/selectionobserver';
+import FocusObserver from './observer/focusobserver';
+import CompositionObserver from './observer/compositionobserver';
+import InputObserver from './observer/inputobserver';
+import ArrowKeysObserver from './observer/arrowkeysobserver';
+import TabObserver from './observer/tabobserver';
+import { CKEditorError, env, ObservableMixin, scrollViewportToShowTarget } from '@ckeditor/ckeditor5-utils';
+import { injectUiElementHandling } from './uielement';
+import { injectQuirksHandling } from './filler';
 import { cloneDeep } from 'lodash-es';
 /**
  * Editor's view controller class. Its main responsibility is DOM - View management for editing purposes, to provide
@@ -104,6 +104,7 @@ export default class View extends ObservableMixin() {
             .to(this.document, 'isFocused', 'isSelecting', 'isComposing');
         this._writer = new DowncastWriter(this.document);
         // Add default observers.
+        // Make sure that this list matches AlwaysRegisteredObservers type.
         this.addObserver(MutationObserver);
         this.addObserver(FocusObserver);
         this.addObserver(SelectionObserver);
@@ -132,6 +133,17 @@ export default class View extends ObservableMixin() {
         this.listenTo(this.document, 'change:isFocused', () => {
             this._hasChangedSinceTheLastRendering = true;
         });
+        // Remove ranges from DOM selection if editor is blurred.
+        // See https://github.com/ckeditor/ckeditor5/issues/5753.
+        if (env.isiOS) {
+            this.listenTo(this.document, 'blur', (evt, data) => {
+                const relatedViewElement = this.domConverter.mapDomToView(data.domEvent.relatedTarget);
+                // Do not modify DOM selection if focus is moved to other editable of the same editor.
+                if (!relatedViewElement) {
+                    this.domConverter._clearDomSelection();
+                }
+            });
+        }
     }
     /**
      * Attaches a DOM root element to the view element and enable all observers on that element.