@ckeditor/ckeditor5-engine 41.4.1 → 42.0.0-alpha.0

package/dist/types/controller/datacontroller.d.ts

@@ -42,7 +42,7 @@ declare const DataController_base: {
  * editor.data.get( { rootName: 'customRoot' } ); // -> '<p>Hello!</p>'
  * ```
  */
-export default class DataController extends DataController_base {
+export default class DataController extends /* #__PURE__ */ DataController_base {
     /**
      * Data model.
      */

package/dist/types/controller/editingcontroller.d.ts

@@ -22,7 +22,7 @@ declare const EditingController_base: {
  * including selection handling. It also creates the {@link ~EditingController#view view} which builds a
  * browser-independent virtualization over the DOM elements. The editing controller also attaches default converters.
  */
-export default class EditingController extends EditingController_base {
+export default class EditingController extends /* #__PURE__ */ EditingController_base {
     /**
      * Editor model.
      */

package/dist/types/conversion/downcastdispatcher.d.ts

@@ -117,7 +117,7 @@ declare const DowncastDispatcher_base: {
  * } );
  * ```
  */
-export default class DowncastDispatcher extends DowncastDispatcher_base {
+export default class DowncastDispatcher extends /* #__PURE__ */ DowncastDispatcher_base {
     /**
      * A template for an interface passed by the dispatcher to the event callbacks.
      *

package/dist/types/conversion/mapper.d.ts

@@ -41,7 +41,7 @@ declare const Mapper_base: {
  * with `'lowest'` priority. To override default `Mapper` mapping, add custom callback with higher priority and
  * stop the event.
  */
-export default class Mapper extends Mapper_base {
+export default class Mapper extends /* #__PURE__ */ Mapper_base {
     /**
      * Model element to view element mapping.
      */

package/dist/types/conversion/upcastdispatcher.d.ts

@@ -121,7 +121,7 @@ declare const UpcastDispatcher_base: {
  * @fires text
  * @fires documentFragment
  */
-export default class UpcastDispatcher extends UpcastDispatcher_base {
+export default class UpcastDispatcher extends /* #__PURE__ */ UpcastDispatcher_base {
     /**
      * An interface passed by the dispatcher to the event callbacks.
      */

package/dist/types/index.d.ts

@@ -21,6 +21,7 @@ export type { default as ModelConsumable } from './conversion/modelconsumable.js
 export type { Consumables, default as ViewConsumable } from './conversion/viewconsumable.js';
 export type { default as DataProcessor } from './dataprocessor/dataprocessor.js';
 export { default as HtmlDataProcessor } from './dataprocessor/htmldataprocessor.js';
+export { default as XmlDataProcessor } from './dataprocessor/xmldataprocessor.js';
 export type { default as Operation } from './model/operation/operation.js';
 export { default as InsertOperation } from './model/operation/insertoperation.js';
 export { default as MoveOperation } from './model/operation/moveoperation.js';
@@ -92,7 +93,7 @@ export { default as ClickObserver } from './view/observer/clickobserver.js';
 export { default as DomEventObserver } from './view/observer/domeventobserver.js';
 export { default as MouseObserver } from './view/observer/mouseobserver.js';
 export { default as TabObserver } from './view/observer/tabobserver.js';
-export { default as FocusObserver } from './view/observer/focusobserver.js';
+export { default as FocusObserver, type ViewDocumentBlurEvent, type ViewDocumentFocusEvent } from './view/observer/focusobserver.js';
 export { default as DowncastWriter } from './view/downcastwriter.js';
 export { default as UpcastWriter } from './view/upcastwriter.js';
 export { default as Matcher, type MatcherPattern, type MatcherObjectPattern, type Match, type MatchResult } from './view/matcher.js';

package/dist/types/model/differ.d.ts

@@ -12,8 +12,8 @@
 import Position from './position.js';
 import Range from './range.js';
 import type { default as MarkerCollection, MarkerData } from './markercollection.js';
-import type Element from './element.js';
 import type Item from './item.js';
+import type Node from './node.js';
 import type RootElement from './rootelement.js';
 import type Operation from './operation/operation.js';
 /**
@@ -25,6 +25,11 @@ import type Operation from './operation/operation.js';
  * elements and new ones and returns a change set.
  */
 export default class Differ {
+    /**
+     * Priority of the {@link ~Differ#_elementState element states}. States on higher indexes of the array can overwrite states on the lower
+     * indexes.
+     */
+    private static readonly _statesPriority;
     /**
      * Reference to the model's marker collection.
      */
@@ -37,18 +42,48 @@ export default class Differ {
      */
     private readonly _changesInElement;
     /**
-     * A map that stores "element's children snapshots". A snapshot is representing children of a given element before
-     * the first change was applied on that element. Snapshot items are objects with two properties: `name`,
-     * containing the element name (or `'$text'` for a text node) and `attributes` which is a map of the node's attributes.
+     * Stores a snapshot for these model nodes that might have changed.
+     *
+     * This complements {@link ~Differ#_elementChildrenSnapshots `_elementChildrenSnapshots`}.
+     *
+     * See also {@link ~DifferSnapshot}.
      */
-    private readonly _elementSnapshots;
+    private readonly _elementsSnapshots;
+    /**
+     * For each element or document fragment inside which there was a change, it stores a snapshot of the child nodes list (an array
+     * of children snapshots that represent the state in the element / fragment before any change has happened).
+     *
+     * This complements {@link ~Differ#_elementsSnapshots `_elementsSnapshots`}.
+     *
+     * See also {@link ~DifferSnapshot}.
+     */
+    private readonly _elementChildrenSnapshots;
+    /**
+     * Keeps the state for a given element, describing how the element was changed so far. It is used to evaluate the `action` property
+     * of diff items returned by {@link ~Differ#getChanges}.
+     *
+     * Possible values, in the order from the lowest priority to the highest priority:
+     *
+     * * `'refresh'` - element was refreshed,
+     * * `'rename'` - element was renamed,
+     * * `'move'` - element was moved (or, usually, removed, that is moved to the graveyard).
+     *
+     * Element that was refreshed, may change its state to `'rename'` if it was later renamed, or to `'move'` if it was removed.
+     * But the element cannot change its state from `'move'` to `'rename'`, or from `'rename'` to `'refresh'`.
+     *
+     * Only already existing elements are registered in `_elementState`. If a new element was inserted as a result of a buffered operation,
+     * it is not be registered in `_elementState`.
+     */
+    private readonly _elementState;
     /**
      * A map that stores all changed markers.
      *
      * The keys of the map are marker names.
+     *
      * The values of the map are objects with the following properties:
-     * - `oldMarkerData`,
-     * - `newMarkerData`.
+     *
+     * * `oldMarkerData`,
+     * * `newMarkerData`.
      */
     private readonly _changedMarkers;
     /**
@@ -93,7 +128,7 @@ export default class Differ {
      */
     get isEmpty(): boolean;
     /**
-     * Buffers the given operation. An operation has to be buffered before it is executed.
+     * Buffers the given operation. **An operation has to be buffered before it is executed.**
      *
      * @param operationToBuffer An operation to buffer.
      */
@@ -181,14 +216,6 @@ export default class Differ {
      * Resets `Differ`. Removes all buffered changes.
      */
     reset(): void;
-    /**
-     * Buffers the root state change after the root was attached or detached
-     */
-    private _bufferRootStateChange;
-    /**
-     * Buffers a root attribute change.
-     */
-    private _bufferRootAttributeChange;
     /**
      * Marks the given `item` in differ to be "refreshed". It means that the item will be marked as removed and inserted
      * in the differ changes set, so it will be effectively re-converted when the differ changes are handled by a dispatcher.
@@ -210,6 +237,14 @@ export default class Differ {
      * @internal
      */
     _bufferRootLoad(root: RootElement): void;
+    /**
+     * Buffers the root state change after the root was attached or detached
+     */
+    private _bufferRootStateChange;
+    /**
+     * Buffers a root attribute change.
+     */
+    private _bufferRootAttributeChange;
     /**
      * Saves and handles an insert change.
      */
@@ -226,14 +261,34 @@ export default class Differ {
      * Saves and handles a model change.
      */
     private _markChange;
+    /**
+     * Tries to set given state for given item.
+     *
+     * This method does simple validation (it sets the state only for model elements, not for text proxy nodes). It also follows state
+     * setting rules, that is, `'refresh'` cannot overwrite `'rename'`, and `'rename'` cannot overwrite `'move'`.
+     */
+    private _setElementState;
+    /**
+     * Returns a value for {@link ~DifferItemAction `action`} property for diff items returned by {@link ~Differ#getChanges}.
+     * This method aims to return `'rename'` or `'refresh'` when it should, and `diffItemType` ("default action") in all other cases.
+     *
+     * It bases on a few factors:
+     *
+     * * for text nodes, the method always returns `diffItemType`,
+     * * for newly inserted element, the method returns `diffItemType`,
+     * * if {@link ~Differ#_elementState element state} was not recorded, the method returns `diffItemType`,
+     * * if state was recorded, and it was `'move'` (default action), the method returns `diffItemType`,
+     * * finally, if state was `'refresh'` or `'rename'`, the method returns the state value.
+     */
+    private _getDiffActionForNode;
     /**
      * Gets an array of changes that have already been saved for a given element.
      */
     private _getChangesForElement;
     /**
-     * Saves a children snapshot for a given element.
+     * Creates and saves a snapshot for all children of the given element.
      */
-    private _makeSnapshot;
+    private _makeSnapshots;
     /**
      * For a given newly saved change, compares it with a change already done on the element and modifies the incoming
      * change and/or the old change.
@@ -247,7 +302,9 @@ export default class Differ {
      *
      * @param parent The element in which the change happened.
      * @param offset The offset at which change happened.
-     * @param elementSnapshot The snapshot of the removed element a character.
+     * @param action Further specifies what kind of action led to generating this change.
+     * @param elementSnapshot Snapshot of the inserted node after changes.
+     * @param elementSnapshotBefore Snapshot of the inserted node before changes.
      * @returns The diff item.
      */
     private _getInsertDiff;
@@ -256,7 +313,8 @@ export default class Differ {
      *
      * @param parent The element in which change happened.
      * @param offset The offset at which change happened.
-     * @param elementSnapshot The snapshot of the removed element a character.
+     * @param action Further specifies what kind of action led to generating this change.
+     * @param elementSnapshot The snapshot of the removed node before changes.
      * @returns The diff item.
      */
     private _getRemoveDiff;
@@ -279,6 +337,32 @@ export default class Differ {
      */
     private _removeAllNestedChanges;
 }
+/**
+ * Further specifies what kind of action led to generating a change:
+ *
+ * * `'insert'` if element was inserted,
+ * * `'remove'` if element was removed,
+ * * `'rename'` if element got renamed (e.g. `writer.rename()`),
+ * * `'refresh'` if element got refreshed (e.g. `model.editing.reconvertItem()`).
+ */
+export type DifferItemAction = 'insert' | 'remove' | 'rename' | 'refresh';
+/**
+ * A snapshot is representing state of a given element before the first change was applied on that element.
+ */
+export interface DifferSnapshot {
+    /**
+     * Node for which was snapshot was made.
+     */
+    node: Node;
+    /**
+     * Name of the element at the time when the snapshot was made. For text node snapshots, it is set to `'$text'`.
+     */
+    name: string;
+    /**
+     * Attributes of the node at the time when the snapshot was made.
+     */
+    attributes: Map<string, unknown>;
+}
 /**
  * The single diff item.
  *
@@ -298,19 +382,19 @@ export interface DiffItemInsert {
      */
     type: 'insert';
     /**
-     * Reference to the model element that was inserted.
+     * Further specifies what kind of action led to generating this change.
      *
-     * Undefined if the diff item is related to text node insertion.
-     *
-     * @internal
+     * The action is set in relation to the document state before any change. It means that, for example, if an element was added and
+     * then renamed (during the same {@link module:engine/model/batch~Batch batch}), the action will be set to `'insert'`, because when
+     * compared to the document state before changes, a new element was inserted, and the renaming does not matter from this point of view.
      */
-    _element?: Element;
+    action: DifferItemAction;
     /**
      * The name of the inserted elements or `'$text'` for a text node.
      */
     name: string;
     /**
-     * Map of attributes that were set on the item while it was inserted.
+     * Map of attributes of the inserted element.
      */
     attributes: Map<string, unknown>;
     /**
@@ -321,6 +405,25 @@ export interface DiffItemInsert {
      * The length of an inserted text node. For elements, it is always 1 as each inserted element is counted as a one.
      */
     length: number;
+    /**
+     * Holds information about the element state before all changes happened.
+     *
+     * For example, when `<paragraph textAlign="right">` was changed to `<codeBlock language="plaintext">`,
+     * `before.name` will be equal to `'paragraph'` and `before.attributes` map will have one entry: `'textAlign' -> 'right'`.
+     *
+     * The property is available only if the insertion change was due to element rename or refresh (when `action` property is `'rename'`
+     * or `'refresh'`). As such, `before` property is never available for text node changes.
+     */
+    before?: {
+        /**
+         * The name of the inserted element before all changes.
+         */
+        name: string;
+        /**
+         * Map of the attributes of the inserted element before all changes.
+         */
+        attributes: Map<string, unknown>;
+    };
 }
 /**
  * A single diff item for removed nodes.
@@ -331,24 +434,13 @@ export interface DiffItemRemove {
      */
     type: 'remove';
     /**
-     * Reference to the model element that was removed.
-     *
-     * Undefined if the diff item is related to text node deletion.
+     * Further specifies what kind of action led to generating this change.
      *
-     * Note that this element will have the state after all changes has been performed on the model, not before. For example, if a paragraph
-     * was first renamed to `heading1`, and then removed, `element.name` will be `heading1`. Similarly, with attributes. Also, you should
-     * not read the element's position, as it will no longer point to the original element position.
-     *
-     * Instead, you should use {@link ~DiffItemRemove#name `DiffItemRemove#name`},
-     * {@link ~DiffItemRemove#attributes `DiffItemRemove#attributes`}, and {@link ~DiffItemRemove#position `DiffItemRemove#position`}.
-     *
-     * This property should be only used to check instance reference equality. For example, if you want to detect that some particular
-     * element was removed, you can check `_element` property. You can use it together with {@link ~DiffItemInsert#_element `#_element`} on
-     * insert diff items to detect move, refresh, or rename changes.
-     *
-     * @internal
+     * The action is set in relation to the document state before any change. It means that, for example, if an element was renamed and
+     * then removed (during the same {@link module:engine/model/batch~Batch batch}), the action will be set to `'remove'`, because when
+     * compared to the document state before changes, the element was removed, and it does not matter that it was also renamed at one point.
      */
-    _element?: Element;
+    action: DifferItemAction;
     /**
      * The name of the removed element or `'$text'` for a text node.
      */

package/dist/types/model/document.d.ts

@@ -40,7 +40,7 @@ declare const Document_base: {
  * However, the document may contain multiple roots – e.g. when the editor has multiple editable areas
  * (e.g. a title and a body of a message).
  */
-export default class Document extends Document_base {
+export default class Document extends /* #__PURE__ */ Document_base {
     /**
      * The {@link module:engine/model/model~Model model} that the document is a part of.
      */

package/dist/types/model/documentselection.d.ts

@@ -43,7 +43,7 @@ declare const DocumentSelection_base: import("@ckeditor/ckeditor5-utils").Mixed<
  * If you need to represent a selection in document fragment,
  * use {@link module:engine/model/selection~Selection Selection class} instead.
  */
-export default class DocumentSelection extends DocumentSelection_base {
+export default class DocumentSelection extends /* #__PURE__ */ DocumentSelection_base {
     /**
      * Selection used internally by that class (`DocumentSelection` is a proxy to that selection).
      */

package/dist/types/model/liveposition.d.ts

@@ -27,7 +27,7 @@ declare const LivePosition_base: import("@ckeditor/ckeditor5-utils").Mixed<typeo
  * have to be unbound.
  * Use {@link module:engine/model/liveposition~LivePosition#detach} whenever you don't need `LivePosition` anymore.
  */
-export default class LivePosition extends LivePosition_base {
+export default class LivePosition extends /* #__PURE__ */ LivePosition_base {
     /**
      * Root of the position path.
      */

package/dist/types/model/liverange.d.ts

@@ -23,7 +23,7 @@ declare const LiveRange_base: import("@ckeditor/ckeditor5-utils").Mixed<typeof R
  * **Note:** Be very careful when dealing with `LiveRange`. Each `LiveRange` instance bind events that might
  * have to be unbound. Use {@link module:engine/model/liverange~LiveRange#detach detach} whenever you don't need `LiveRange` anymore.
  */
-export default class LiveRange extends LiveRange_base {
+export default class LiveRange extends /* #__PURE__ */ LiveRange_base {
     /**
      * Creates a live range.
      *

package/dist/types/model/markercollection.d.ts

@@ -31,7 +31,7 @@ declare const MarkerCollection_base: {
  *
  * @see module:engine/model/markercollection~Marker
  */
-export default class MarkerCollection extends MarkerCollection_base implements Iterable<Marker> {
+export default class MarkerCollection extends /* #__PURE__ */ MarkerCollection_base implements Iterable<Marker> {
     /**
      * Stores {@link ~Marker markers} added to the collection.
      */
@@ -209,7 +209,7 @@ declare const Marker_base: import("@ckeditor/ckeditor5-utils").Mixed<typeof Type
  *
  * `Marker` instances are created and destroyed only by {@link ~MarkerCollection MarkerCollection}.
  */
-declare class Marker extends Marker_base {
+declare class Marker extends /* #__PURE__ */ Marker_base {
     /**
      * Marker's name.
      */

package/dist/types/model/model.d.ts

@@ -32,7 +32,7 @@ declare const Model_base: {
  * Editor's data model. Read about the model in the
  * {@glink framework/architecture/editing-engine engine architecture} guide.
  */
-export default class Model extends Model_base {
+export default class Model extends /* #__PURE__ */ Model_base {
     /**
      * Model's marker collection.
      */

package/dist/types/model/schema.d.ts

@@ -35,7 +35,7 @@ declare const Schema_base: {
  * {@glink framework/architecture/editing-engine Introduction to the Editing engine architecture} guide.
  * * The {@glink framework/deep-dive/schema Schema deep-dive} guide.
  */
-export default class Schema extends Schema_base {
+export default class Schema extends /* #__PURE__ */ Schema_base {
     private readonly _sourceDefinitions;
     /**
      * A dictionary containing attribute properties.
@@ -677,9 +677,15 @@ export type SchemaCheckAttributeEvent = {
  * * {@link ~SchemaItemDefinition#allowIn `allowIn`} – Defines in which other items this item will be allowed.
  * * {@link ~SchemaItemDefinition#allowChildren `allowChildren`} – Defines which other items are allowed inside this item.
  * * {@link ~SchemaItemDefinition#allowAttributes `allowAttributes`} – Defines allowed attributes of the given item.
- * * {@link ~SchemaItemDefinition#allowContentOf `allowContentOf`} – Inherits "allowed children" from other items.
- * * {@link ~SchemaItemDefinition#allowWhere `allowWhere`} – Inherits "allowed in" from other items.
- * * {@link ~SchemaItemDefinition#allowAttributesOf `allowAttributesOf`} – Inherits attributes from other items.
+ * * {@link ~SchemaItemDefinition#disallowIn `disallowIn`} – Defines in which other items this item will be disallowed.
+ * * {@link ~SchemaItemDefinition#disallowChildren `disallowChildren`} – Defines which other items are disallowed inside this item.
+ * * {@link ~SchemaItemDefinition#disallowAttributes `disallowAttributes`} – Defines disallowed attributes of the given item.
+ * * {@link ~SchemaItemDefinition#allowContentOf `allowContentOf`} – Makes this item allow children that are also allowed in the
+ * specified items. This acknowledges disallow rules.
+ * * {@link ~SchemaItemDefinition#allowWhere `allowWhere`} – Makes this item allowed where the specified items are allowed. This
+ * acknowledges disallow rules.
+ * * {@link ~SchemaItemDefinition#allowAttributesOf `allowAttributesOf`} – Inherits attributes from other items. This acknowledges
+ * disallow rules.
  * * {@link ~SchemaItemDefinition#inheritTypesFrom `inheritTypesFrom`} – Inherits `is*` properties of other items.
  * * {@link ~SchemaItemDefinition#inheritAllFrom `inheritAllFrom`} –
  * A shorthand for `allowContentOf`, `allowWhere`, `allowAttributesOf`, `inheritTypesFrom`.
@@ -687,7 +693,6 @@ export type SchemaCheckAttributeEvent = {
  * # The `is*` properties
  *
  * There are a couple commonly used `is*` properties. Their role is to assign additional semantics to schema items.
- * You can define more properties but you will also need to implement support for them in the existing editor features.
  *
  * * {@link ~SchemaItemDefinition#isBlock `isBlock`} – Whether this item is paragraph-like.
  * Generally speaking, content is usually made out of blocks like paragraphs, list items, images, headings, etc.
@@ -808,6 +813,15 @@ export type SchemaCheckAttributeEvent = {
  * } );
  * ```
  *
+ * Register `inlineImage` as a kind of an inline object but disallow it inside captions:
+ *
+ * ```ts
+ * schema.register( 'imageInline', {
+ * 	inheritAllFrom: '$inlineObject',
+ * 	disallowIn: [ 'caption' ]
+ * } );
+ * ```
+ *
  * Make `listItem` inherit all from `$block` but also allow additional attributes:
  *
  * ```ts
@@ -851,6 +865,18 @@ export interface SchemaItemDefinition {
      * Defines allowed attributes of the given item.
      */
     allowAttributes?: string | Array<string>;
+    /**
+     * Defines in which other items this item will be disallowed. Takes precedence over allow rules.
+     */
+    disallowIn?: string | Array<string>;
+    /**
+     * Defines which other items are disallowed inside this item. Takes precedence over allow rules.
+     */
+    disallowChildren?: string | Array<string>;
+    /**
+     * Defines disallowed attributes for this item. Takes precedence over allow rules.
+     */
+    disallowAttributes?: string | Array<string>;
     /**
      * Inherits "allowed children" from other items.
      */
@@ -860,7 +886,7 @@ export interface SchemaItemDefinition {
      */
     allowWhere?: string | Array<string>;
     /**
-     * Inherits attributes from other items.
+     * Inherits "allowed attributes" from other items.
      */
     allowAttributesOf?: string | Array<string>;
     /**

package/dist/types/model/selection.d.ts

@@ -24,7 +24,7 @@ declare const Selection_base: import("@ckeditor/ckeditor5-utils").Mixed<typeof T
  * Additionally, selection may have its own attributes (think – whether text typed in in this selection
  * should have those attributes – e.g. whether you type a bolded text).
  */
-export default class Selection extends Selection_base {
+export default class Selection extends /* #__PURE__ */ Selection_base {
     /**
      * Specifies whether the last added range was added as a backward or forward range.
      */

package/dist/types/view/document.d.ts

@@ -22,7 +22,7 @@ declare const Document_base: import("@ckeditor/ckeditor5-utils").Mixed<{
  * Document class creates an abstract layer over the content editable area, contains a tree of view elements and
  * {@link module:engine/view/documentselection~DocumentSelection view selection} associated with this document.
  */
-export default class Document extends Document_base {
+export default class Document extends /* #__PURE__ */ Document_base {
     /**
      * Selection done on this document.
      */

package/dist/types/view/documentfragment.d.ts

@@ -21,7 +21,7 @@ declare const DocumentFragment_base: import("@ckeditor/ckeditor5-utils").Mixed<t
  * {@link module:engine/view/upcastwriter~UpcastWriter#createDocumentFragment `UpcastWriter#createDocumentFragment()`}
  * method.
  */
-export default class DocumentFragment extends DocumentFragment_base implements Iterable<Node> {
+export default class DocumentFragment extends /* #__PURE__ */ DocumentFragment_base implements Iterable<Node> {
     /**
      * The document to which this document fragment belongs.
      */

package/dist/types/view/documentselection.d.ts

@@ -28,7 +28,7 @@ declare const DocumentSelection_base: import("@ckeditor/ckeditor5-utils").Mixed<
  * the {@link module:engine/view/view~View#change `View#change()`} block
  * (so via {@link module:engine/view/downcastwriter~DowncastWriter#setSelection `DowncastWriter#setSelection()`}).
  */
-export default class DocumentSelection extends DocumentSelection_base {
+export default class DocumentSelection extends /* #__PURE__ */ DocumentSelection_base {
     /**
      * Selection is used internally (`DocumentSelection` is a proxy to that selection).
      */

package/dist/types/view/domconverter.d.ts

@@ -548,6 +548,15 @@ export default class DomConverter {
      * @returns `true` if given `node` ends with space, `false` otherwise.
      */
     private _nodeEndsWithSpace;
+    /**
+     * Checks whether given text contains preformatted white space. This is the case if
+     * * any of node ancestors has a name which is in `preElements` array, or
+     * * the closest ancestor that has the `white-space` CSS property sets it to a value that preserves spaces
+     *
+     * @param node Node to check
+     * @returns `true` if given node contains preformatted white space, `false` otherwise.
+     */
+    private _isPreFormatted;
     /**
      * Helper function. For given {@link module:engine/view/text~Text view text node}, it finds previous or next sibling
      * that is contained in the same container element. If there is no such sibling, `null` is returned.

package/dist/types/view/editableelement.d.ts

@@ -23,7 +23,7 @@ declare const EditableElement_base: import("@ckeditor/ckeditor5-utils").Mixed<ty
  * The constructor of this class shouldn't be used directly. To create new `EditableElement` use the
  * {@link module:engine/view/downcastwriter~DowncastWriter#createEditableElement `downcastWriter#createEditableElement()`} method.
  */
-export default class EditableElement extends EditableElement_base {
+export default class EditableElement extends /* #__PURE__ */ EditableElement_base {
     /**
      * Whether the editable is in read-write or read-only mode.
      *

package/dist/types/view/node.d.ts

@@ -21,7 +21,7 @@ declare const Node_base: import("@ckeditor/ckeditor5-utils").Mixed<typeof TypeCh
  * Use the {@link module:engine/view/downcastwriter~DowncastWriter} or {@link module:engine/view/upcastwriter~UpcastWriter}
  * to create new instances of view nodes.
  */
-export default abstract class Node extends Node_base {
+export default abstract class Node extends /* #__PURE__ */ Node_base {
     /**
      * The document instance to which this node belongs.
      */

package/dist/types/view/observer/observer.d.ts

@@ -18,7 +18,7 @@ declare const Observer_base: {
  * Observers can also add features to the view, for instance by updating its status or marking elements
  * which need a refresh on DOM events.
  */
-export default abstract class Observer extends Observer_base {
+export default abstract class Observer extends /* #__PURE__ */ Observer_base {
     /**
      * An instance of the view controller.
      */

package/dist/types/view/renderer.d.ts

@@ -30,7 +30,7 @@ declare const Renderer_base: {
  * Renderer uses {@link module:engine/view/domconverter~DomConverter} to transform view nodes and positions
  * to and from the DOM.
  */
-export default class Renderer extends Renderer_base {
+export default class Renderer extends /* #__PURE__ */ Renderer_base {
     /**
      * Set of DOM Documents instances.
      */

package/dist/types/view/selection.d.ts

@@ -30,7 +30,7 @@ declare const Selection_base: import("@ckeditor/ckeditor5-utils").Mixed<typeof T
  * A selection can consist of {@link module:engine/view/range~Range ranges} that can be set by using
  * the {@link module:engine/view/selection~Selection#setTo `Selection#setTo()`} method.
  */
-export default class Selection extends Selection_base {
+export default class Selection extends /* #__PURE__ */ Selection_base {
     /**
      * Stores all ranges that are selected.
      */

package/dist/types/view/view.d.ts

@@ -68,7 +68,7 @@ declare const View_base: {
  * If you do not need full a DOM - view management, and only want to transform a tree of view elements to a tree of DOM
  * elements you do not need this controller. You can use the {@link module:engine/view/domconverter~DomConverter DomConverter} instead.
  */
-export default class View extends View_base {
+export default class View extends /* #__PURE__ */ View_base {
     /**
      * Instance of the {@link module:engine/view/document~Document} associated with this view controller.
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-engine",
-  "version": "41.4.1",
+  "version": "42.0.0-alpha.0",
   "description": "The editing engine of CKEditor 5 – the best browser-based rich text editor.",
   "keywords": [
     "wysiwyg",
@@ -24,7 +24,7 @@
   "type": "module",
   "main": "src/index.js",
   "dependencies": {
-    "@ckeditor/ckeditor5-utils": "41.4.1",
+    "@ckeditor/ckeditor5-utils": "42.0.0-alpha.0",
     "lodash-es": "4.17.21"
   },
   "author": "CKSource (http://cksource.com/)",