@ckeditor/ckeditor5-engine 45.0.0 → 45.1.0-alpha.1

package/dist/index.js

@@ -586,7 +586,7 @@ Text$1.prototype.is = function(type) {
  *
  * **Note:** `TextProxy` instances are created on the fly basing on the current state of parent {@link module:engine/view/text~Text}.
  * Because of this it is highly unrecommended to store references to `TextProxy instances because they might get
- * invalidated due to operations on Document. Also TextProxy is not a {@link module:engine/view/node~Node} so it can not be
+ * invalidated due to operations on Document. Also TextProxy is not a {@link module:engine/view/node~Node} so it cannot be
  * inserted as a child of {@link module:engine/view/element~Element}.
  *
  * `TextProxy` instances are created by {@link module:engine/view/treewalker~TreeWalker view tree walker}. You should not need to create
@@ -609,7 +609,6 @@ Text$1.prototype.is = function(type) {
 	 * @param offsetInText Offset in {@link module:engine/view/textproxy~TextProxy#textNode text node}
 	 * from which the text proxy starts.
 	 * @param length Text proxy length, that is how many text node's characters, starting from `offsetInText` it represents.
-	 * @constructor
 	 */ constructor(textNode, offsetInText, length){
         super();
         this.textNode = textNode;
@@ -3731,7 +3730,7 @@ ContainerElement.prototype.is = function(type, name) {
 	 * @internal
 	 * @param document The document instance to which this element belongs.
 	 * @param name Node name.
-	 * @param attrs Collection of attributes.
+	 * @param attributes Collection of attributes.
 	 * @param children A list of nodes to be inserted into created element.
 	 */ constructor(document, name, attributes, children){
         super(document, name, attributes, children);
@@ -4435,10 +4434,10 @@ RootEditableElement.prototype.is = function(type, name) {
         }
         if (!item.parent) {
             /**
-			 * You can not make a position after a root.
+			 * You cannot make a position after a root.
 			 *
 			 * @error view-position-after-root
-			 * @param {module:engine/view/node~Node} root
+			 * @param {module:engine/view/node~Node} root A root item.
 			 */ throw new CKEditorError('view-position-after-root', item, {
                 root: item
             });
@@ -4460,7 +4459,7 @@ RootEditableElement.prototype.is = function(type, name) {
 			 * You cannot make a position before a root.
 			 *
 			 * @error view-position-before-root
-			 * @param {module:engine/view/node~Node} root
+			 * @param {module:engine/view/node~Node} root A root item.
 			 */ throw new CKEditorError('view-position-before-root', item, {
                 root: item
             });
@@ -6153,7 +6152,7 @@ AttributeElement.prototype.is = function(type, name) {
 	 * @internal
 	 * @param document The document instance to which this element belongs.
 	 * @param name Node name.
-	 * @param attrs Collection of attributes.
+	 * @param attributes Collection of attributes.
 	 * @param children A list of nodes to be inserted into created element.
 	 */ constructor(document, name, attributes, children){
         super(document, name, attributes, children);
@@ -6697,7 +6696,8 @@ DocumentFragment$1.prototype.is = function(type) {
 	 * The location can be specified in the same form as {@link module:engine/view/view~View#createPositionAt view.createPositionAt()}
 	 * parameters.
 	 *
-	 * @param Offset or one of the flags. Used only when the first parameter is a {@link module:engine/view/item~Item view item}.
+	 * @param itemOrPosition
+	 * @param offset Offset or one of the flags. Used only when the first parameter is a {@link module:engine/view/item~Item view item}.
 	 */ setSelectionFocus(itemOrPosition, offset) {
         this.document.selection._setFocus(itemOrPosition, offset);
     }
@@ -7504,7 +7504,7 @@ DocumentFragment$1.prototype.is = function(type) {
 	 * conversionApi.writer.insert( viewPosition, viewSlot );
 	 * ```
 	 *
-	 * While providing a filtered slot, make sure to provide slots for all child nodes. A single node can not be downcasted into
+	 * While providing a filtered slot, make sure to provide slots for all child nodes. A single node cannot be downcasted into
 	 * multiple slots.
 	 *
 	 * **Note**: You should not change the order of nodes. View elements should be in the same order as model nodes.
@@ -8136,7 +8136,7 @@ const validNodesToInsert = [
  * * Block filler is an element which fill block elements, like `<p>`. CKEditor uses `<br>` as a block filler during the editing,
  * as browsers do natively. So instead of an empty `<p>` there will be `<p><br></p>`. The advantage of block filler is that
  * it is transparent for the selection, so when the caret is before the `<br>` and user presses right arrow he will be
- * moved to the next paragraph, not after the `<br>`. The disadvantage is that it breaks a block, so it can not be used
+ * moved to the next paragraph, not after the `<br>`. The disadvantage is that it breaks a block, so it cannot be used
  * in the middle of a line of text. The {@link module:engine/view/filler~BR_FILLER `<br>` filler} can be replaced with any other
  * character in the data output, for instance {@link module:engine/view/filler~NBSP_FILLER non-breaking space} or
  * {@link module:engine/view/filler~MARKED_NBSP_FILLER marked non-breaking space}.
@@ -8597,6 +8597,14 @@ const validNodesToInsert = [
         const domFillerNode = this._inlineFiller;
         // Something weird happened and the stored node doesn't contain the filler's text.
         if (!startsWithFiller(domFillerNode)) {
+            // @if CK_DEBUG_TYPING // if ( ( window as any ).logCKETyping ) {
+            // @if CK_DEBUG_TYPING // 	console.log( ..._buildLogMessage( this, 'Renderer',
+            // @if CK_DEBUG_TYPING // 		'Inline filler node: ' +
+            // @if CK_DEBUG_TYPING // 		`%c${ _escapeTextNodeData( domFillerNode.data ) }%c (${ domFillerNode.data.length })`,
+            // @if CK_DEBUG_TYPING // 		'color: blue',
+            // @if CK_DEBUG_TYPING // 		''
+            // @if CK_DEBUG_TYPING // 	) );
+            // @if CK_DEBUG_TYPING // }
             /**
 			 * The inline filler node was lost. Most likely, something overwrote the filler text node
 			 * in the DOM.
@@ -9966,7 +9974,7 @@ const UNSAFE_ELEMENT_REPLACEMENT_ATTRIBUTE = 'data-ck-unsafe-element';
     }
     /**
 	 * Converts DOM Range to view {@link module:engine/view/range~Range}.
-	 * If the start or end position can not be converted `null` is returned.
+	 * If the start or end position cannot be converted `null` is returned.
 	 *
 	 * @param domRange DOM range.
 	 * @returns View range.
@@ -10246,7 +10254,7 @@ const UNSAFE_ELEMENT_REPLACEMENT_ATTRIBUTE = 'data-ck-unsafe-element';
     /**
 	 * Returns `true` if given selection is a backward selection, that is, if it's `focus` is before `anchor`.
 	 *
-	 * @param DOM Selection instance to check.
+	 * @param selection Selection instance to check.
 	 */ isDomSelectionBackward(selection) {
         if (selection.isCollapsed) {
             return false;
@@ -10888,9 +10896,9 @@ const UNSAFE_ELEMENT_REPLACEMENT_ATTRIBUTE = 'data-ck-unsafe-element';
  * ```
  *
  * @error domconverter-unsafe-attribute-detected
- * @param domElement The DOM element the attribute was set on.
- * @param key The original name of the attribute
- * @param value The value of the original attribute
+ * @param {HTMLElement} domElement The DOM element the attribute was set on.
+ * @param {string} key The original name of the attribute
+ * @param {string} value The value of the original attribute
  */
 
 /**
@@ -11861,8 +11869,6 @@ function sameNodes(child1, child2) {
             // @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 ) {
@@ -11872,8 +11878,6 @@ function sameNodes(child1, child2) {
             // @if CK_DEBUG_TYPING // 	) );
             // @if CK_DEBUG_TYPING // }
             document.isComposing = false;
-        }, {
-            priority: 'low'
         });
     }
     /**
@@ -12004,7 +12008,7 @@ function getFiles(nativeDataTransfer) {
         // @if CK_DEBUG_TYPING // if ( ( window as any ).logCKETyping ) {
         // @if CK_DEBUG_TYPING // 	_debouncedLine();
         // @if CK_DEBUG_TYPING // 	console.group( ..._buildLogMessage( this, 'InputObserver',
-        // @if CK_DEBUG_TYPING // 		`${ domEvent.type }: ${ domEvent.inputType }`
+        // @if CK_DEBUG_TYPING // 		`${ domEvent.type }: ${ domEvent.inputType } - ${ domEvent.isComposing ? 'is' : 'not' } composing`,
         // @if CK_DEBUG_TYPING // 	) );
         // @if CK_DEBUG_TYPING // }
         const domTargetRanges = domEvent.getTargetRanges();
@@ -12040,6 +12044,8 @@ function getFiles(nativeDataTransfer) {
         if (viewDocument.selection.isFake) {
             // Future-proof: in case of multi-range fake selections being possible.
             targetRanges = Array.from(viewDocument.selection.getRanges());
+            // Do not allow typing inside a fake selection container, we will handle it manually.
+            domEvent.preventDefault();
         // @if CK_DEBUG_TYPING // if ( ( window as any ).logCKETyping ) {
         // @if CK_DEBUG_TYPING // 	console.info( ..._buildLogMessage( this, 'InputObserver',
         // @if CK_DEBUG_TYPING // 		'%cusing fake selection:',
@@ -12054,8 +12060,34 @@ function getFiles(nativeDataTransfer) {
                 // We try to fall back to collapsed range at the valid end position.
                 // See https://github.com/ckeditor/ckeditor5/issues/14411.
                 // See https://github.com/ckeditor/ckeditor5/issues/14050.
-                const viewStart = view.domConverter.domPositionToView(domRange.startContainer, domRange.startOffset);
+                let viewStart = view.domConverter.domPositionToView(domRange.startContainer, domRange.startOffset);
                 const viewEnd = view.domConverter.domPositionToView(domRange.endContainer, domRange.endOffset);
+                // When text replacement is enabled and browser tries to replace double space with dot, and space,
+                // but the first space is no longer where browser put it (it was moved to an attribute element),
+                // then we must extend the target range so it does not include a part of an inline filler.
+                if (viewStart && startsWithFiller(domRange.startContainer) && domRange.startOffset < INLINE_FILLER_LENGTH) {
+                    // @if CK_DEBUG_TYPING // if ( ( window as any ).logCKETyping ) {
+                    // @if CK_DEBUG_TYPING // 	console.info( ..._buildLogMessage( this, 'InputObserver',
+                    // @if CK_DEBUG_TYPING // 		'Target range starts in an inline filler - adjusting it',
+                    // @if CK_DEBUG_TYPING // 	) );
+                    // @if CK_DEBUG_TYPING // }
+                    domEvent.preventDefault();
+                    let count = INLINE_FILLER_LENGTH - domRange.startOffset;
+                    viewStart = viewStart.getLastMatchingPosition((value)=>{
+                        // Ignore attribute and UI elements but stop on container elements.
+                        if (value.item.is('attributeElement') || value.item.is('uiElement')) {
+                            return true;
+                        }
+                        // Skip as many characters as inline filler was overlapped.
+                        if (value.item.is('$textProxy') && count--) {
+                            return true;
+                        }
+                        return false;
+                    }, {
+                        direction: 'backward',
+                        singleCharacters: true
+                    });
+                }
                 if (viewStart) {
                     return view.createRange(viewStart, viewEnd);
                 } else if (viewEnd) {
@@ -12099,7 +12131,10 @@ function getFiles(nativeDataTransfer) {
         }
         // Normalize the insertText data that includes new-line characters.
         // https://github.com/ckeditor/ckeditor5/issues/2045.
-        if (domEvent.inputType == 'insertText' && data && data.includes('\n')) {
+        if ([
+            'insertText',
+            'insertReplacementText'
+        ].includes(domEvent.inputType) && data && data.includes('\n')) {
             // There might be a single new-line or double for new paragraph, but we translate
             // it to paragraphs as it is our default action for enter handling.
             const parts = data.split(/\n{1,2}/g);
@@ -13295,7 +13330,7 @@ function formatReturnValue(type, item, previousPosition, nextPosition, length) {
 			 * Position path must be an array with at least one item.
 			 *
 			 * @error model-position-path-incorrect-format
-			 * @param path
+			 * @param {Array.<number>} path A path to the position.
 			 */ throw new CKEditorError('model-position-path-incorrect-format', root, {
                 path
             });
@@ -13351,7 +13386,7 @@ function formatReturnValue(type, item, previousPosition, nextPosition, length) {
 				 * the {@glink framework/architecture/editing-engine#indexes-and-offsets Editing engine architecture} guide.
 				 *
 				 * @error model-position-path-incorrect
-				 * @param position The incorrect position.
+				 * @param {module:engine/model/position~Position} position The incorrect position.
 				 */ throw new CKEditorError('model-position-path-incorrect', this, {
                     position: this
                 });
@@ -13975,10 +14010,10 @@ function formatReturnValue(type, item, previousPosition, nextPosition, length) {
 	 */ static _createAfter(item, stickiness) {
         if (!item.parent) {
             /**
-			 * You can not make a position after a root element.
+			 * You cannot make a position after a root element.
 			 *
 			 * @error model-position-after-root
-			 * @param root
+			 * @param {module:engine/model/rootelement~RootElement} root The root element..
 			 */ throw new CKEditorError('model-position-after-root', [
                 this,
                 item
@@ -13997,10 +14032,10 @@ function formatReturnValue(type, item, previousPosition, nextPosition, length) {
 	 */ static _createBefore(item, stickiness) {
         if (!item.parent) {
             /**
-			 * You can not make a position before a root element.
+			 * You cannot make a position before a root element.
 			 *
 			 * @error model-position-before-root
-			 * @param root
+			 * @param {module:engine/model/rootelement~RootElement} root The root element..
 			 */ throw new CKEditorError('model-position-before-root', item, {
                 root: item
             });
@@ -14024,7 +14059,7 @@ function formatReturnValue(type, item, previousPosition, nextPosition, length) {
 			 * Cannot create position for document. Root with specified name does not exist.
 			 *
 			 * @error model-position-fromjson-no-root
-			 * @param rootName
+			 * @param {string} rootName The root name.
 			 */ throw new CKEditorError('model-position-fromjson-no-root', doc, {
                 rootName: json.root
             });
@@ -14898,7 +14933,7 @@ Position.prototype.is = function(type) {
 	 * If the deleted range contains transformed range, `null` will be returned.
 	 *
 	 * @internal
-	 * @param deletionPosition Position from which nodes are removed.
+	 * @param deletePosition Position from which nodes are removed.
 	 * @param howMany How many nodes are removed.
 	 * @returns Result of the transformation.
 	 */ _getTransformedByDeletion(deletePosition, howMany) {
@@ -17795,8 +17830,8 @@ Node$1.prototype.is = function(type) {
 				 * Trying to add a range that intersects with another range in the selection.
 				 *
 				 * @error model-selection-range-intersects
-				 * @param addedRange Range that was added to the selection.
-				 * @param intersectingRange Range in the selection that intersects with `addedRange`.
+				 * @param {module:engine/model/range~Range} addedRange Range that was added to the selection.
+				 * @param {module:engine/model/range~Range} intersectingRange Range in the selection that intersects with `addedRange`.
 				 */ throw new CKEditorError('model-selection-range-intersects', [
                     this,
                     range
@@ -18696,7 +18731,7 @@ DocumentSelection.prototype.is = function(type) {
 			 * UID obtained from the {@link module:engine/model/writer~Writer#overrideSelectionGravity} to restore.
 			 *
 			 * @error document-selection-gravity-wrong-restore
-			 * @param uid The unique identifier returned by
+			 * @param {string} uid The unique identifier returned by
 			 * {@link module:engine/model/documentselection~DocumentSelection#_overrideGravity}.
 			 */ throw new CKEditorError('document-selection-gravity-wrong-restore', this, {
                 uid
@@ -18734,7 +18769,7 @@ DocumentSelection.prototype.is = function(type) {
 				 * starts or ends at incorrect position.
 				 *
 				 * @error document-selection-wrong-position
-				 * @param range
+				 * @param {module:engine/model/range~Range} range The invalid range.
 				 */ throw new CKEditorError('document-selection-wrong-position', this, {
                     range
                 });
@@ -19189,8 +19224,8 @@ DocumentSelection.prototype.is = function(type) {
 			 * Given offset cannot be found in the node list.
 			 *
 			 * @error model-nodelist-offset-out-of-bounds
-			 * @param offset
-			 * @param nodeList Stringified node list.
+			 * @param {number} offset The offset value.
+			 * @param {module:engine/model/nodelist~NodeList} nodeList Stringified node list.
 			 */ throw new CKEditorError('model-nodelist-offset-out-of-bounds', this, {
                 offset,
                 nodeList: this
@@ -19765,13 +19800,10 @@ function cloneNodes(nodes) {
 	 *
 	 * @param config Conversion configuration.
 	 * @param config.model The description or a name of the model element to convert.
-	 * @param config.model.attributes The list of attribute names that should be consumed while creating
-	 * the view element. Note that the view will be reconverted if any of the listed attributes changes.
- 	 * @param config.model.children Specifies whether the view element requires reconversion if the list
-	 * of the model child nodes changed.
 	 * @param config.view A view element definition or a function that takes the model element and
 	 * {@link module:engine/conversion/downcastdispatcher~DowncastConversionApi downcast conversion API}
 	 * as parameters and returns a view container element.
+	 * @param config.converterPriority Converter priority.
 	 */ elementToElement(config) {
         return this.add(downcastElementToElement(config));
     }
@@ -19879,12 +19911,10 @@ function cloneNodes(nodes) {
 	 *
 	 * @param config Conversion configuration.
  	 * @param config.model The description or a name of the model element to convert.
-	 * @param config.model.name The name of the model element to convert.
- 	 * @param config.model.attributes The list of attribute names that should be consumed while creating
-	 * the view structure. Note that the view will be reconverted if any of the listed attributes will change.
 	 * @param config.view A function that takes the model element and
 	 * {@link module:engine/conversion/downcastdispatcher~DowncastConversionApi downcast conversion API} as parameters
 	 * and returns a view container element with slots for model child nodes to be converted into.
+	 * @param config.converterPriority Converter priority.
 	 */ elementToStructure(config) {
         return this.add(downcastElementToStructure(config));
     }
@@ -20939,6 +20969,7 @@ function cloneNodes(nodes) {
 			 * ```
 			 *
 			 * @error conversion-attribute-to-attribute-on-text
+			 * @param {object} data The conversion data.
 			 */ throw new CKEditorError('conversion-attribute-to-attribute-on-text', conversionApi.dispatcher, data);
         }
         // First remove the old attribute if there was one.
@@ -21189,7 +21220,7 @@ function cloneNodes(nodes) {
 			 * ```
 			 *
 			 * @error conversion-element-to-structure-disallowed-text
-			 * @param {String} elementName The name of the element the structure is to be created for.
+			 * @param {string} elementName The name of the element the structure is to be created for.
 			 */ throw new CKEditorError('conversion-element-to-structure-disallowed-text', dispatcher, {
                 elementName: model.name
             });
@@ -21590,9 +21621,9 @@ function getFromAttributeCreator(config) {
     };
 }
 /**
- * Creates a function that create view slots.
+ * Creates a function that creates view slots.
  *
- * @returns Function exposed by writer as createSlot().
+ * @returns Function exposed by the writer as `createSlot()`.
  */ function createSlotFactory(element, slotsMap, conversionApi) {
     return (writer, modeOrFilter)=>{
         const slot = writer.createContainerElement('$slot');
@@ -21603,9 +21634,10 @@ function getFromAttributeCreator(config) {
             children = Array.from(element.getChildren()).filter((element)=>modeOrFilter(element));
         } else {
             /**
-			 * Unknown slot mode was provided to `writer.createSlot()` in downcast converter.
+			 * Unknown slot mode was provided to `writer.createSlot()` in the downcast converter.
 			 *
 			 * @error conversion-slot-mode-unknown
+			 * @param {never} modeOrFilter The specified mode or filter.
 			 */ throw new CKEditorError('conversion-slot-mode-unknown', conversionApi.dispatcher, {
                 modeOrFilter
             });
@@ -23131,7 +23163,7 @@ function getFromAttributeCreator(config) {
 			 * The marker with the provided name does not exist and cannot be reconverted.
 			 *
 			 * @error editingcontroller-reconvertmarker-marker-not-exist
-			 * @param {String} markerName The name of the reconverted marker.
+			 * @param {string} markerName The name of the reconverted marker.
 			 */ throw new CKEditorError('editingcontroller-reconvertmarker-marker-not-exist', this, {
                 markerName
             });
@@ -26248,7 +26280,10 @@ function removeDisallowedAttributeFromNode(schema, node, writer) {
     /**
 	 * Creates and caches conversion helpers for given dispatchers group.
 	 *
+	 * @param options Group name.
 	 * @param options.name Group name.
+	 * @param options.dispatchers Dispatchers to register.
+	 * @param options.isDowncast Whether downcast group.
 	 */ _createConversionHelpers({ name, dispatchers, isDowncast }) {
         if (this._helpers.has(name)) {
             /**
@@ -26468,7 +26503,7 @@ function* _getUpcastDefinition(model, view, upcastAlso) {
 	 * Creates `Operation` object from deserialized object, i.e. from parsed JSON string.
 	 *
 	 * @param json Deserialized JSON object.
-	 * @param doc Document on which this operation will be applied.
+	 * @param document Document on which this operation will be applied.
 	 */ static fromJSON(json, document) {
         return new this(json.baseVersion);
     }
@@ -26479,7 +26514,7 @@ function* _getUpcastDefinition(model, view, upcastAlso) {
  *
  * @internal
  * @param position Position at which nodes should be inserted.
- * @param normalizedNodes Nodes to insert.
+ * @param nodes Nodes to insert.
  * @returns Range spanning over inserted elements.
  */ function _insert(position, nodes) {
     const normalizedNodes = _normalizeNodes(nodes);
@@ -27478,9 +27513,9 @@ class MarkerOperation extends Operation {
 				 * Changed node has different attribute value than operation's old attribute value.
 				 *
 				 * @error attribute-operation-wrong-old-value
-				 * @param item
-				 * @param key
-				 * @param value
+				 * @param {module:engine/model/item~Item} root The item element.
+				 * @param {string} key The key of the attribute.
+				 * @param {never} value The value.
 				 */ throw new CKEditorError('attribute-operation-wrong-old-value', this, {
                     item,
                     key: this.key,
@@ -27492,8 +27527,8 @@ class MarkerOperation extends Operation {
 				 * The attribute with given key already exists for the given node.
 				 *
 				 * @error attribute-operation-attribute-exists
-				 * @param node
-				 * @param key
+				 * @param {module:engine/model/item~Item} root The item element.
+				 * @param {string} key The key of the attribute.
 				 */ throw new CKEditorError('attribute-operation-attribute-exists', this, {
                     node: item,
                     key: this.key
@@ -27740,9 +27775,8 @@ class MarkerOperation extends Operation {
 			 * The element to change is not a root element.
 			 *
 			 * @error rootattribute-operation-not-a-root
-			 * @param root
-			 * @param key
-			 * @param value
+			 * @param {module:engine/model/rootelement~RootElement} root The root element.
+			 * @param {string} key The key of the attribute.
 			 */ throw new CKEditorError('rootattribute-operation-not-a-root', this, {
                 root: this.root,
                 key: this.key
@@ -27753,9 +27787,8 @@ class MarkerOperation extends Operation {
 			 * The attribute which should be removed does not exist for the given node.
 			 *
 			 * @error rootattribute-operation-wrong-old-value
-			 * @param root
-			 * @param key
-			 * @param value
+			 * @param {module:engine/model/rootelement~RootElement} root The root element.
+			 * @param {string} key The key of the attribute.
 			 */ throw new CKEditorError('rootattribute-operation-wrong-old-value', this, {
                 root: this.root,
                 key: this.key
@@ -27766,8 +27799,8 @@ class MarkerOperation extends Operation {
 			 * The attribute with given key already exists for the given node.
 			 *
 			 * @error rootattribute-operation-attribute-exists
-			 * @param root
-			 * @param key
+			 * @param {module:engine/model/rootelement~RootElement} root The root element.
+			 * @param {string} key The key of the attribute.
 			 */ throw new CKEditorError('rootattribute-operation-attribute-exists', this, {
                 root: this.root,
                 key: this.key
@@ -27804,10 +27837,10 @@ class MarkerOperation extends Operation {
 	 */ static fromJSON(json, document) {
         if (!document.getRoot(json.root)) {
             /**
-			 * Cannot create RootAttributeOperation for document. Root with specified name does not exist.
+			 * Cannot create RootAttributeOperation for document. Root with the specified name does not exist.
 			 *
 			 * @error rootattribute-operation-fromjson-no-root
-			 * @param rootName
+			 * @param {string} rootName The root name.
 			 */ throw new CKEditorError('rootattribute-operation-fromjson-no-root', this, {
                 rootName: json.root
             });
@@ -28959,19 +28992,74 @@ setTransformation(MarkerOperation, SplitOperation, (a, b, context)=>{
     }
     if (a.newRange) {
         if (context.abRelation) {
+            // If we have context, it means that there was previously a merge operation which transformed this marker operation, and that
+            // merge operation was then undone, and this split operation should reverse the marker to state before the merge operation.
             const aNewRange = a.newRange._getTransformedBySplitOperation(b);
-            if (a.newRange.start.isEqual(b.splitPosition) && context.abRelation.wasStartBeforeMergedElement) {
-                a.newRange.start = Position._createAt(b.insertionPosition);
-            } else if (a.newRange.start.isEqual(b.splitPosition) && !context.abRelation.wasInLeftElement) {
-                a.newRange.start = Position._createAt(b.moveTargetPosition);
+            if (a.newRange.start.isEqual(b.splitPosition)) {
+                // If marker range start is same as split position, we need to decide where marker start should be placed, as there
+                // are three possible options.
+                //
+                if (context.abRelation.wasStartBeforeMergedElement) {
+                    // If the marker start was initially before the merged element, move it back to that place.
+                    //
+                    // <p>Foo</p>[<p>Bar]</p>  -- merge ->  <p>Foo[Bar]</p>  -- default split ->  <p>Foo</p><p>[Bar]</p>
+                    // <p>Foo</p>[<p>Bar]</p>  -- merge ->  <p>Foo[Bar]</p>  --- fixed split -->  <p>Foo</p>[<p>Bar]</p>
+                    //
+                    a.newRange.start = Position._createAt(b.insertionPosition);
+                } else if (context.abRelation.wasInLeftElement) {
+                    // If the marker start was initially in the "left" element, keep the start position there.
+                    //
+                    // <p>Foo[</p><p>Bar]</p>  -- merge ->  <p>Foo[Bar]</p>  -- default split ->  <p>Foo</p><p>[Bar]</p>
+                    // <p>Foo[</p><p>Bar]</p>  -- merge ->  <p>Foo[Bar]</p>  --- fixed split -->  <p>Foo[</p><p>Bar]</p>
+                    //
+                    a.newRange.start = Position._createAt(a.newRange.start);
+                } else {
+                    // Finally, the start position must have been at the beginning of the "right" (merged) element.
+                    // In this case, move it back to the "right" element.
+                    //
+                    // Note, that this what the default transformation (`_getTransformedBySplitOperation()`) does, BUT ONLY for
+                    // a non-collapsed marker. For a collapsed marker, by default, the whole marker is kept at the split position,
+                    // which would be incorrect. This is why this case is needed, and why we don't use `aNewRange.start` here.
+                    //
+                    // <p>Foo</p><p>[]Bar</p>  -- merge ->  <p>Foo[]Bar</p>  -- default split ->  <p>Foo[]</p><p>Bar</p>
+                    // <p>Foo</p><p>[]Bar</p>  -- merge ->  <p>Foo[]Bar</p>  --- fixed split -->  <p>Foo</p><p>[]Bar</p>
+                    //
+                    a.newRange.start = Position._createAt(b.moveTargetPosition);
+                }
             } else {
+                // If marker range start is not the same as split position, simply use the default transformation, as there is no
+                // ambiguity in this case.
                 a.newRange.start = aNewRange.start;
             }
-            if (a.newRange.end.isEqual(b.splitPosition) && context.abRelation.wasInRightElement) {
-                a.newRange.end = Position._createAt(b.moveTargetPosition);
-            } else if (a.newRange.end.isEqual(b.splitPosition) && context.abRelation.wasEndBeforeMergedElement) {
-                a.newRange.end = Position._createAt(b.insertionPosition);
+            if (a.newRange.end.isEqual(b.splitPosition)) {
+                // If marker range end is same as split position, we need to decide where marker end should be placed, as there
+                // are three possible options.
+                //
+                if (a.newRange.end.isEqual(b.splitPosition) && context.abRelation.wasEndBeforeMergedElement) {
+                    // If the marker end was initially before the merged element, move it back to that place.
+                    //
+                    // <p>[Foo</p>]<p>Bar</p>  -- merge ->  <p>[Foo]Bar</p>  -- default split ->  <p>[Foo]</p><p>Bar</p>
+                    // <p>[Foo</p>]<p>Bar</p>  -- merge ->  <p>[Foo]Bar</p>  --- fixed split -->  <p>[Foo</p>]<p>Bar</p>
+                    //
+                    a.newRange.end = Position._createAt(b.insertionPosition);
+                } else if (context.abRelation.wasInRightElement) {
+                    // If the marker was initially in the "right" element, keep the end position there.
+                    //
+                    // <p>[Foo</p><p>]Bar</p>  -- merge ->  <p>[Foo]Bar</p>  -- default split ->  <p>[Foo]</p><p>Bar</p>
+                    // <p>[Foo</p><p>]Bar</p>  -- merge ->  <p>[Foo]Bar</p>  --- fixed split -->  <p>[Foo</p><p>]Bar</p>
+                    //
+                    a.newRange.end = Position._createAt(b.moveTargetPosition);
+                } else {
+                    // Finally, the end position must have been at the end of the "left" (merged) element.
+                    // In this case, keep it where it is.
+                    //
+                    // Note, that this is what the default transformation does, so we could use `aNewRange.end`, but this is more clear.
+                    //
+                    a.newRange.end = Position._createAt(a.newRange.end);
+                }
             } else {
+                // If marker range end is not the same as split position, simply use the default transformation, as there is no
+                // ambiguity in this case.
                 a.newRange.end = aNewRange.end;
             }
             return [
@@ -31603,7 +31691,8 @@ LivePosition.prototype.is = function(type) {
 			 * Only operations with matching versions can be added to the history.
 			 *
 			 * @error model-document-history-addoperation-incorrect-version
-			 * @param errorData The operation and the current document history version.
+			 * @param {module:engine/model/operation/operation~Operation} operation The current operation.
+			 * @param {number} historyVersion The current document history version.
 			 */ throw new CKEditorError('model-document-history-addoperation-incorrect-version', this, {
                 operation,
                 historyVersion: this.version
@@ -33225,7 +33314,7 @@ DocumentFragment.prototype.is = function(type) {
 	 *
 	 * Note that items can be moved only within the same tree. It means that you can move items within the same root
 	 * (element or document fragment) or between {@link module:engine/model/document~Document#roots documents roots},
-	 * but you can not move items from document fragment to the document or from one detached element to another. Use
+	 * but you cannot move items from document fragment to the document or from one detached element to another. Use
 	 * {@link module:engine/model/writer~Writer#insert} in such cases.
 	 *
 	 * @param range Source range.
@@ -33430,7 +33519,7 @@ DocumentFragment.prototype.is = function(type) {
         let splitElement = position.parent;
         if (!splitElement.parent) {
             /**
-			 * Element with no parent can not be split.
+			 * Element with no parent cannot be split.
 			 *
 			 * @error writer-split-element-no-parent
 			 */ throw new CKEditorError('writer-split-element-no-parent', this);
@@ -34150,6 +34239,18 @@ DocumentFragment.prototype.is = function(type) {
  * **Note:** If there is no valid position for the selection, the paragraph will always be created:
  *
  * `[<imageBlock src="foo.jpg"></imageBlock>]` -> `<paragraph>[]</paragraph>`.
+ *
+ * @param options.doNotFixSelection Whether given selection-to-remove should be fixed if it ends at the beginning of an element.
+ *
+ * By default, `deleteContent()` will fix selection before performing a deletion, so that the selection does not end at the beginning of
+ * an element. For example, selection `<heading>[Heading</heading><paragraph>]Some text.</paragraph>` will be treated as it was
+ * `<heading>[Heading]</heading><paragraph>Some text.</paragraph>`. As a result, the elements will not get merged.
+ *
+ * If selection is as in example, visually, the next element (paragraph) is not selected and it may be confusing for the user that
+ * the elements got merged. Selection is set up like this by browsers when a user triple-clicks on some text.
+ *
+ * However, in some cases, it is expected to remove content exactly as selected in the selection, without any fixing. In these cases,
+ * this flag can be set to `true`, which will prevent fixing the selection.
  */ function deleteContent(model, selection, options = {}) {
     if (selection.isCollapsed) {
         return;
@@ -34176,7 +34277,13 @@ DocumentFragment.prototype.is = function(type) {
             }
         }
         // Get the live positions for the range adjusted to span only blocks selected from the user perspective.
-        const [startPosition, endPosition] = getLivePositionsForSelectedBlocks(selRange);
+        let startPosition, endPosition;
+        if (!options.doNotFixSelection) {
+            [startPosition, endPosition] = getLivePositionsForSelectedBlocks(selRange);
+        } else {
+            startPosition = LivePosition.fromPosition(selRange.start, 'toPrevious');
+            endPosition = LivePosition.fromPosition(selRange.end, 'toNext');
+        }
         // 2. Remove the content if there is any.
         if (!startPosition.isTouching(endPosition)) {
             writer.remove(writer.createRange(startPosition, endPosition));
@@ -34737,7 +34844,6 @@ function removeRangeContent(range, writer) {
  * @param model The model in context of which the insertion should be performed.
  * @param content The content to insert.
  * @param selectable Selection into which the content should be inserted.
- * @param placeOrOffset Sets place or offset of the selection.
  * @returns Range which contains all the performed changes. This is a range that, if removed,
  * would return the model to the state before the insertion. If no changes were preformed by `insertContent`, returns a range collapsed
  * at the insertion position.
@@ -35075,8 +35181,8 @@ function removeRangeContent(range, writer) {
 			 * Given node cannot be inserted on the given position.
 			 *
 			 * @error insertcontent-wrong-position
-			 * @param node Node to insert.
-			 * @param position Position to insert the node at.
+			 * @param {module:engine/model/node~Node} node Node to insert.
+			 * @param {module:engine/model/position~Position} position Position to insert the node at.
 			 */ throw new CKEditorError('insertcontent-wrong-position', this, {
                 node,
                 position: this.position
@@ -35367,7 +35473,6 @@ function removeRangeContent(range, writer) {
  * @param object An object to be inserted into the model document.
  * @param selectable A selectable where the content should be inserted. If not specified, the current
  * {@link module:engine/model/document~Document#selection document selection} will be used instead.
- * @param placeOrOffset Specifies the exact place or offset for the insertion to take place, relative to `selectable`.
  * @param options Additional options.
  * @param options.findOptimalPosition An option that, when set, adjusts the insertion position (relative to
  * `selectable` and `placeOrOffset`) so that the content of `selectable` is not split upon insertion (a.k.a. non-destructive insertion).
@@ -37820,6 +37925,7 @@ const domConverterStub = {
 /**
  * Writes the content of the {@link module:engine/view/document~Document document} to an HTML-like string.
  *
+ * @param view The view to stringify.
  * @param options.withoutSelection Whether to write the selection. When set to `true`, the selection will
  * not be included in the returned string.
  * @param options.rootName The name of the root from which the data should be stringified. If not provided,
@@ -37828,8 +37934,6 @@ const domConverterStub = {
  * instead of `<p>`, `<attribute:b>` instead of `<b>` and `<empty:img>` instead of `<img>`).
  * @param options.showPriority When set to `true`, the attribute element's priority will be printed
  * (`<span view-priority="12">`, `<b view-priority="10">`).
- * @param options.showAttributeElementId When set to `true`, the attribute element's ID will be printed
- * (`<span id="marker:foo">`).
  * @param options.renderUIElements When set to `true`, the inner content of each
  * {@link module:engine/view/uielement~UIElement} will be printed.
  * @param options.renderRawElements When set to `true`, the inner content of each
@@ -38122,7 +38226,6 @@ setData$1._parse = parse$1;
  * this node will be used as the root for all parsed nodes.
  * @param options.sameSelectionCharacters When set to `false`, the selection inside the text should be marked using
  * `{` and `}` and the selection outside the ext using `[` and `]`. When set to `true`, both should be marked with `[` and `]` only.
- * @param options.stylesProcessor Styles processor.
  * @returns Returns the parsed view node or an object with two fields: `view` and `selection` when selection ranges were included in the
  * data to parse.
  */ function parse$1(data, options = {}) {