@ckeditor/ckeditor5-engine 45.2.1-alpha.9 → 46.0.0-alpha.0

package/src/model/documentselection.js

@@ -5,44 +5,44 @@
 /**
  * @module engine/model/documentselection
  */
-import TypeCheckable from './typecheckable.js';
-import LiveRange from './liverange.js';
-import Selection from './selection.js';
-import Text from './text.js';
-import TextProxy from './textproxy.js';
+import { ModelTypeCheckable } from './typecheckable.js';
+import { ModelLiveRange } from './liverange.js';
+import { ModelSelection } from './selection.js';
+import { ModelText } from './text.js';
+import { ModelTextProxy } from './textproxy.js';
 import { CKEditorError, Collection, EmitterMixin, toMap, uid } from '@ckeditor/ckeditor5-utils';
 const storePrefix = 'selection:';
 /**
- * `DocumentSelection` is a special selection which is used as the
- * {@link module:engine/model/document~Document#selection document's selection}.
- * There can be only one instance of `DocumentSelection` per document.
+ * `ModelDocumentSelection` is a special selection which is used as the
+ * {@link module:engine/model/document~ModelDocument#selection document's selection}.
+ * There can be only one instance of `ModelDocumentSelection` per document.
  *
- * Document selection can only be changed by using the {@link module:engine/model/writer~Writer} instance
+ * Document selection can only be changed by using the {@link module:engine/model/writer~ModelWriter} instance
  * inside the {@link module:engine/model/model~Model#change `change()`} block, as it provides a secure way to modify model.
  *
- * `DocumentSelection` is automatically updated upon changes in the {@link module:engine/model/document~Document document}
+ * `ModelDocumentSelection` is automatically updated upon changes in the {@link module:engine/model/document~ModelDocument document}
  * to always contain valid ranges. Its attributes are inherited from the text unless set explicitly.
  *
- * Differences between {@link module:engine/model/selection~Selection} and `DocumentSelection` are:
- * * there is always a range in `DocumentSelection` - even if no ranges were added there is a "default range"
+ * Differences between {@link module:engine/model/selection~ModelSelection} and `ModelDocumentSelection` are:
+ * * there is always a range in `ModelDocumentSelection` - even if no ranges were added there is a "default range"
  * present in the selection,
  * * ranges added to this selection updates automatically when the document changes,
- * * attributes of `DocumentSelection` are updated automatically according to selection ranges.
+ * * attributes of `ModelDocumentSelection` are updated automatically according to selection ranges.
  *
- * Since `DocumentSelection` uses {@link module:engine/model/liverange~LiveRange live ranges}
- * and is updated when {@link module:engine/model/document~Document document}
- * changes, it cannot be set on {@link module:engine/model/node~Node nodes}
- * that are inside {@link module:engine/model/documentfragment~DocumentFragment document fragment}.
+ * Since `ModelDocumentSelection` uses {@link module:engine/model/liverange~ModelLiveRange live ranges}
+ * and is updated when {@link module:engine/model/document~ModelDocument document}
+ * changes, it cannot be set on {@link module:engine/model/node~ModelNode nodes}
+ * that are inside {@link module:engine/model/documentfragment~ModelDocumentFragment document fragment}.
  * If you need to represent a selection in document fragment,
- * use {@link module:engine/model/selection~Selection Selection class} instead.
+ * use {@link module:engine/model/selection~ModelSelection Selection class} instead.
  */
-export default class DocumentSelection extends /* #__PURE__ */ EmitterMixin(TypeCheckable) {
+export class ModelDocumentSelection extends /* #__PURE__ */ EmitterMixin(ModelTypeCheckable) {
     /**
-     * Selection used internally by that class (`DocumentSelection` is a proxy to that selection).
+     * Selection used internally by that class (`ModelDocumentSelection` is a proxy to that selection).
      */
     _selection;
     /**
-     * Creates an empty live selection for given {@link module:engine/model/document~Document}.
+     * Creates an empty live selection for given {@link module:engine/model/document~ModelDocument}.
      *
      * @param doc Document which owns this selection.
      */
@@ -63,8 +63,8 @@ export default class DocumentSelection extends /* #__PURE__ */ EmitterMixin(Type
     /**
      * Selection anchor. Anchor may be described as a position where the most recent part of the selection starts.
      * Together with {@link #focus} they define the direction of selection, which is important
-     * when expanding/shrinking selection. Anchor is always {@link module:engine/model/range~Range#start start} or
-     * {@link module:engine/model/range~Range#end end} position of the most recently added range.
+     * when expanding/shrinking selection. Anchor is always {@link module:engine/model/range~ModelRange#start start} or
+     * {@link module:engine/model/range~ModelRange#end end} position of the most recently added range.
      *
      * Is set to `null` if there are no ranges in selection.
      *
@@ -91,7 +91,7 @@ export default class DocumentSelection extends /* #__PURE__ */ EmitterMixin(Type
     }
     /**
      * Describes whether `Documentselection` has own range(s) set, or if it is defaulted to
-     * {@link module:engine/model/document~Document#_getDefaultRange document's default range}.
+     * {@link module:engine/model/document~ModelDocument#_getDefaultRange document's default range}.
      */
     get hasOwnRange() {
         return this._selection.hasOwnRange;
@@ -107,7 +107,7 @@ export default class DocumentSelection extends /* #__PURE__ */ EmitterMixin(Type
         return this._selection.isBackward;
     }
     /**
-     * Describes whether the gravity is overridden (using {@link module:engine/model/writer~Writer#overrideSelectionGravity}) or not.
+     * Describes whether the gravity is overridden (using {@link module:engine/model/writer~ModelWriter#overrideSelectionGravity}) or not.
      *
      * Note that the gravity remains overridden as long as will not be restored the same number of times as it was overridden.
      */
@@ -118,13 +118,13 @@ export default class DocumentSelection extends /* #__PURE__ */ EmitterMixin(Type
      * A collection of selection {@link module:engine/model/markercollection~Marker markers}.
      * Marker is a selection marker when selection range is inside the marker range.
      *
-     * **Note**: Only markers from {@link ~DocumentSelection#observeMarkers observed markers groups} are collected.
+     * **Note**: Only markers from {@link ~ModelDocumentSelection#observeMarkers observed markers groups} are collected.
      */
     get markers() {
         return this._selection.markers;
     }
     /**
-     * Used for the compatibility with the {@link module:engine/model/selection~Selection#isEqual} method.
+     * Used for the compatibility with the {@link module:engine/model/selection~ModelSelection#isEqual} method.
      *
      * @internal
      */
@@ -139,7 +139,7 @@ export default class DocumentSelection extends /* #__PURE__ */ EmitterMixin(Type
     }
     /**
      * Returns the first position in the selection.
-     * First position is the position that {@link module:engine/model/position~Position#isBefore is before}
+     * First position is the position that {@link module:engine/model/position~ModelPosition#isBefore is before}
      * any other position in the selection.
      *
      * Returns `null` if there are no ranges in selection.
@@ -149,7 +149,7 @@ export default class DocumentSelection extends /* #__PURE__ */ EmitterMixin(Type
     }
     /**
      * Returns the last position in the selection.
-     * Last position is the position that {@link module:engine/model/position~Position#isAfter is after}
+     * Last position is the position that {@link module:engine/model/position~ModelPosition#isAfter is after}
      * any other position in the selection.
      *
      * Returns `null` if there are no ranges in selection.
@@ -159,8 +159,8 @@ export default class DocumentSelection extends /* #__PURE__ */ EmitterMixin(Type
     }
     /**
      * Returns a copy of the first range in the selection.
-     * First range is the one which {@link module:engine/model/range~Range#start start} position
-     * {@link module:engine/model/position~Position#isBefore is before} start position of all other ranges
+     * First range is the one which {@link module:engine/model/range~ModelRange#start start} position
+     * {@link module:engine/model/position~ModelPosition#isBefore is before} start position of all other ranges
      * (not to confuse with the first range added to the selection).
      *
      * Returns `null` if there are no ranges in selection.
@@ -170,9 +170,9 @@ export default class DocumentSelection extends /* #__PURE__ */ EmitterMixin(Type
     }
     /**
      * Returns a copy of the last range in the selection.
-     * Last range is the one which {@link module:engine/model/range~Range#end end} position
-     * {@link module:engine/model/position~Position#isAfter is after} end position of all other ranges (not to confuse with the range most
-     * recently added to the selection).
+     * Last range is the one which {@link module:engine/model/range~ModelRange#end end} position
+     * {@link module:engine/model/position~ModelPosition#isAfter is after} end position of all
+     * other ranges (not to confuse with the range most recently added to the selection).
      *
      * Returns `null` if there are no ranges in selection.
      */
@@ -180,7 +180,7 @@ export default class DocumentSelection extends /* #__PURE__ */ EmitterMixin(Type
         return this._selection.getLastRange();
     }
     /**
-     * Gets elements of type {@link module:engine/model/schema~Schema#isBlock "block"} touched by the selection.
+     * Gets elements of type {@link module:engine/model/schema~ModelSchema#isBlock "block"} touched by the selection.
      *
      * This method's result can be used for example to apply block styling to all blocks covered by this selection.
      *
@@ -236,7 +236,7 @@ export default class DocumentSelection extends /* #__PURE__ */ EmitterMixin(Type
         return this._selection.getSelectedBlocks();
     }
     /**
-     * Returns the selected element. {@link module:engine/model/element~Element Element} is considered as selected if there is only
+     * Returns the selected element. {@link module:engine/model/element~ModelElement Element} is considered as selected if there is only
      * one range in the selection, and that range contains exactly one element.
      * Returns `null` if there is no selected element.
      */
@@ -245,7 +245,7 @@ export default class DocumentSelection extends /* #__PURE__ */ EmitterMixin(Type
     }
     /**
      * Checks whether the selection contains the entire content of the given element. This means that selection must start
-     * at a position {@link module:engine/model/position~Position#isTouching touching} the element's start and ends at position
+     * at a position {@link module:engine/model/position~ModelPosition#isTouching touching} the element's start and ends at position
      * touching the element's end.
      *
      * By default, this method will check whether the entire content of the selection's current root is selected.
@@ -302,7 +302,7 @@ export default class DocumentSelection extends /* #__PURE__ */ EmitterMixin(Type
     }
     /**
      * Registers a marker group prefix or a marker name to be collected in the
-     * {@link ~DocumentSelection#markers selection markers collection}.
+     * {@link ~ModelDocumentSelection#markers selection markers collection}.
      *
      * See also {@link module:engine/model/markercollection~MarkerCollection#getMarkersGroup `MarkerCollection#getMarkersGroup()`}.
      *
@@ -312,26 +312,26 @@ export default class DocumentSelection extends /* #__PURE__ */ EmitterMixin(Type
         this._selection.observeMarkers(prefixOrName);
     }
     /**
-     * Moves {@link module:engine/model/documentselection~DocumentSelection#focus} to the specified location.
-     * Should be used only within the {@link module:engine/model/writer~Writer#setSelectionFocus} method.
+     * Moves {@link module:engine/model/documentselection~ModelDocumentSelection#focus} to the specified location.
+     * Should be used only within the {@link module:engine/model/writer~ModelWriter#setSelectionFocus} method.
      *
      * The location can be specified in the same form as
-     * {@link module:engine/model/writer~Writer#createPositionAt writer.createPositionAt()} parameters.
+     * {@link module:engine/model/writer~ModelWriter#createPositionAt writer.createPositionAt()} parameters.
      *
-     * @see module:engine/model/writer~Writer#setSelectionFocus
+     * @see module:engine/model/writer~ModelWriter#setSelectionFocus
      * @internal
      * @param offset Offset or one of the flags. Used only when
-     * first parameter is a {@link module:engine/model/item~Item model item}.
+     * first parameter is a {@link module:engine/model/item~ModelItem model item}.
      */
     _setFocus(itemOrPosition, offset) {
         this._selection.setFocus(itemOrPosition, offset);
     }
     /**
      * Sets this selection's ranges and direction to the specified location based on the given
-     * {@link module:engine/model/selection~Selectable selectable}.
-     * Should be used only within the {@link module:engine/model/writer~Writer#setSelection} method.
+     * {@link module:engine/model/selection~ModelSelectable selectable}.
+     * Should be used only within the {@link module:engine/model/writer~ModelWriter#setSelection} method.
      *
-     * @see module:engine/model/writer~Writer#setSelection
+     * @see module:engine/model/writer~ModelWriter#setSelection
      * @internal
      */
     _setTo(...args) {
@@ -339,9 +339,9 @@ export default class DocumentSelection extends /* #__PURE__ */ EmitterMixin(Type
     }
     /**
      * Sets attribute on the selection. If attribute with the same key already is set, it's value is overwritten.
-     * Should be used only within the {@link module:engine/model/writer~Writer#setSelectionAttribute} method.
+     * Should be used only within the {@link module:engine/model/writer~ModelWriter#setSelectionAttribute} method.
      *
-     * @see module:engine/model/writer~Writer#setSelectionAttribute
+     * @see module:engine/model/writer~ModelWriter#setSelectionAttribute
      * @internal
      * @param key Key of the attribute to set.
      * @param value Attribute value.
@@ -351,11 +351,11 @@ export default class DocumentSelection extends /* #__PURE__ */ EmitterMixin(Type
     }
     /**
      * Removes an attribute with given key from the selection.
-     * If the given attribute was set on the selection, fires the {@link module:engine/model/selection~Selection#event:change:range}
+     * If the given attribute was set on the selection, fires the {@link module:engine/model/selection~ModelSelection#event:change:range}
      * event with removed attribute key.
-     * Should be used only within the {@link module:engine/model/writer~Writer#removeSelectionAttribute} method.
+     * Should be used only within the {@link module:engine/model/writer~ModelWriter#removeSelectionAttribute} method.
      *
-     * @see module:engine/model/writer~Writer#removeSelectionAttribute
+     * @see module:engine/model/writer~ModelWriter#removeSelectionAttribute
      * @internal
      * @param key Key of the attribute to remove.
      */
@@ -380,7 +380,7 @@ export default class DocumentSelection extends /* #__PURE__ */ EmitterMixin(Type
      * It returns an unique identifier which is required to restore the gravity. It guarantees the symmetry
      * of the process.
      *
-     * @see module:engine/model/writer~Writer#overrideSelectionGravity
+     * @see module:engine/model/writer~ModelWriter#overrideSelectionGravity
      * @internal
      * @returns The unique id which allows restoring the gravity.
      */
@@ -388,13 +388,13 @@ export default class DocumentSelection extends /* #__PURE__ */ EmitterMixin(Type
         return this._selection.overrideGravity();
     }
     /**
-     * Restores the {@link ~DocumentSelection#_overrideGravity overridden gravity}.
+     * Restores the {@link ~ModelDocumentSelection#_overrideGravity overridden gravity}.
      *
      * Restoring the gravity is only possible using the unique identifier returned by
-     * {@link ~DocumentSelection#_overrideGravity}. Note that the gravity remains overridden as long as won't be restored
+     * {@link ~ModelDocumentSelection#_overrideGravity}. Note that the gravity remains overridden as long as won't be restored
      * the same number of times it was overridden.
      *
-     * @see module:engine/model/writer~Writer#restoreSelectionGravity
+     * @see module:engine/model/writer~ModelWriter#restoreSelectionGravity
      * @internal
      * @param uid The unique id returned by {@link #_overrideGravity}.
      */
@@ -422,25 +422,26 @@ export default class DocumentSelection extends /* #__PURE__ */ EmitterMixin(Type
 }
 // The magic of type inference using `is` method is centralized in `TypeCheckable` class.
 // Proper overload would interfere with that.
-DocumentSelection.prototype.is = function (type) {
+ModelDocumentSelection.prototype.is = function (type) {
     return type === 'selection' ||
         type == 'model:selection' ||
         type == 'documentSelection' ||
         type == 'model:documentSelection';
 };
 /**
- * `LiveSelection` is used internally by {@link module:engine/model/documentselection~DocumentSelection} and shouldn't be used directly.
+ * `LiveSelection` is used internally by {@link module:engine/model/documentselection~ModelDocumentSelection}
+ * and shouldn't be used directly.
  *
- * LiveSelection` is automatically updated upon changes in the {@link module:engine/model/document~Document document}
+ * `LiveSelection` is automatically updated upon changes in the {@link module:engine/model/document~ModelDocument document}
  * to always contain valid ranges. Its attributes are inherited from the text unless set explicitly.
  *
- * Differences between {@link module:engine/model/selection~Selection} and `LiveSelection` are:
+ * Differences between {@link module:engine/model/selection~ModelSelection} and `LiveSelection` are:
  * * there is always a range in `LiveSelection` - even if no ranges were added there is a "default range"
  * present in the selection,
  * * ranges added to this selection updates automatically when the document changes,
  * * attributes of `LiveSelection` are updated automatically according to selection ranges.
  */
-class LiveSelection extends Selection {
+class LiveSelection extends ModelSelection {
     /**
      * List of selection markers.
      * Marker is a selection marker when selection range is inside the marker range.
@@ -482,7 +483,7 @@ class LiveSelection extends Selection {
      */
     _observedMarkers = new Set();
     /**
-     * Creates an empty live selection for given {@link module:engine/model/document~Document}.
+     * Creates an empty live selection for given {@link module:engine/model/document~ModelDocument}.
      *
      * @param doc Document which owns this selection.
      */
@@ -536,7 +537,7 @@ class LiveSelection extends Selection {
     }
     /**
      * Describes whether `LiveSelection` has own range(s) set, or if it is defaulted to
-     * {@link module:engine/model/document~Document#_getDefaultRange document's default range}.
+     * {@link module:engine/model/document~ModelDocument#_getDefaultRange document's default range}.
      */
     get hasOwnRange() {
         return this._ranges.length > 0;
@@ -609,11 +610,11 @@ class LiveSelection extends Selection {
         if (!this._overriddenGravityRegister.has(uid)) {
             /**
              * Restoring gravity for an unknown UID is not possible. Make sure you are using a correct
-             * UID obtained from the {@link module:engine/model/writer~Writer#overrideSelectionGravity} to restore.
+             * UID obtained from the {@link module:engine/model/writer~ModelWriter#overrideSelectionGravity} to restore.
              *
              * @error document-selection-gravity-wrong-restore
              * @param {string} uid The unique identifier returned by
-             * {@link module:engine/model/documentselection~DocumentSelection#_overrideGravity}.
+             * {@link module:engine/model/documentselection~ModelDocumentSelection#_overrideGravity}.
              */
             throw new CKEditorError('document-selection-gravity-wrong-restore', this, { uid });
         }
@@ -645,11 +646,11 @@ class LiveSelection extends Selection {
         for (const range of ranges) {
             if (!this._document._validateSelectionRange(range)) {
                 /**
-                 * Range from {@link module:engine/model/documentselection~DocumentSelection document selection}
+                 * Range from {@link module:engine/model/documentselection~ModelDocumentSelection document selection}
                  * starts or ends at incorrect position.
                  *
                  * @error document-selection-wrong-position
-                 * @param {module:engine/model/range~Range} range The invalid range.
+                 * @param {module:engine/model/range~ModelRange} range The invalid range.
                  */
                 throw new CKEditorError('document-selection-wrong-position', this, { range });
             }
@@ -657,7 +658,7 @@ class LiveSelection extends Selection {
     }
     /**
      * Prepares given range to be added to selection. Checks if it is correct,
-     * converts it to {@link module:engine/model/liverange~LiveRange LiveRange}
+     * converts it to {@link module:engine/model/liverange~ModelLiveRange ModelLiveRange}
      * and sets listeners listening to the range's change event.
      */
     _prepareRange(range) {
@@ -666,7 +667,7 @@ class LiveSelection extends Selection {
             // @if CK_DEBUG // console.warn( 'Trying to add a Range that is in the graveyard root. Range rejected.' );
             return;
         }
-        const liveRange = LiveRange.fromRange(range);
+        const liveRange = ModelLiveRange.fromRange(range);
         // If selection range is moved to the graveyard remove it from the selection object.
         // Also, save some data that can be used to restore selection later, on `Model#applyOperation` event.
         liveRange.on('change:range', (evt, oldRange, data) => {
@@ -751,7 +752,7 @@ class LiveSelection extends Selection {
         }
     }
     /**
-     * Updates this selection attributes according to its ranges and the {@link module:engine/model/document~Document model document}.
+     * Updates this selection attributes according to its ranges and the {@link module:engine/model/document~ModelDocument model document}.
      */
     _updateAttributes(clearAll) {
         const newAttributes = toMap(this._getSurroundingAttributes());
@@ -961,7 +962,7 @@ function getTextAttributes(node, schema) {
     if (!node) {
         return null;
     }
-    if (node instanceof TextProxy || node instanceof Text) {
+    if (node instanceof ModelTextProxy || node instanceof ModelText) {
         return node.getAttributes();
     }
     if (!schema.isInline(node)) {

package/src/model/element.d.ts

@@ -5,15 +5,15 @@
 /**
  * @module engine/model/element
  */
-import Node, { type NodeAttributes } from './node.js';
-import type Item from './item.js';
+import { ModelNode, type ModelNodeAttributes } from './node.js';
+import { type ModelItem } from './item.js';
 /**
- * Model element. Type of {@link module:engine/model/node~Node node} that has a {@link module:engine/model/element~Element#name name} and
- * {@link module:engine/model/element~Element#getChildren child nodes}.
+ * Model element. Type of {@link module:engine/model/node~ModelNode node} that has a
+ * {@link module:engine/model/element~ModelElement#name name} and {@link module:engine/model/element~ModelElement#getChildren child nodes}.
  *
- * **Important**: see {@link module:engine/model/node~Node} to read about restrictions using `Element` and `Node` API.
+ * **Important**: see {@link module:engine/model/node~ModelNode} to read about restrictions using `Element` and `Node` API.
  */
-export default class Element extends Node {
+export declare class ModelElement extends ModelNode {
     /**
      * Element name.
      */
@@ -26,20 +26,20 @@ export default class Element extends Node {
      * Creates a model element.
      *
      * **Note:** Constructor of this class shouldn't be used directly in the code.
-     * Use the {@link module:engine/model/writer~Writer#createElement} method instead.
+     * Use the {@link module:engine/model/writer~ModelWriter#createElement} method instead.
      *
      * @internal
      * @param name Element's name.
      * @param attrs Element's attributes. See {@link module:utils/tomap~toMap} for a list of accepted values.
      * @param children One or more nodes to be inserted as children of created element.
      */
-    constructor(name: string, attrs?: NodeAttributes, children?: string | Item | Iterable<string | Item>);
+    constructor(name: string, attrs?: ModelNodeAttributes, children?: string | ModelItem | Iterable<string | ModelItem>);
     /**
      * Number of this element's children.
      */
     get childCount(): number;
     /**
-     * Sum of {@link module:engine/model/node~Node#offsetSize offset sizes} of all of this element's children.
+     * Sum of {@link module:engine/model/node~ModelNode#offsetSize offset sizes} of all of this element's children.
      */
     get maxOffset(): number;
     /**
@@ -52,37 +52,37 @@ export default class Element extends Node {
      * @param index Index in this element.
      * @returns Child node.
      */
-    getChild(index: number): Node | null;
+    getChild(index: number): ModelNode | null;
     /**
      * Gets the child at the given offset. Returns `null` if incorrect index was passed.
      *
      * @param offset Offset in this element.
      * @returns Child node.
      */
-    getChildAtOffset(offset: number): Node | null;
+    getChildAtOffset(offset: number): ModelNode | null;
     /**
      * Returns an iterator that iterates over all of this element's children.
      */
-    getChildren(): IterableIterator<Node>;
+    getChildren(): IterableIterator<ModelNode>;
     /**
      * Returns an index of the given child node. Returns `null` if given node is not a child of this element.
      *
      * @param node Child node to look for.
      * @returns Child node's index in this element.
      */
-    getChildIndex(node: Node): number | null;
+    getChildIndex(node: ModelNode): number | null;
     /**
      * Returns the starting offset of given child. Starting offset is equal to the sum of
-     * {@link module:engine/model/node~Node#offsetSize offset sizes} of all node's siblings that are before it. Returns `null` if
+     * {@link module:engine/model/node~ModelNode#offsetSize offset sizes} of all node's siblings that are before it. Returns `null` if
      * given node is not a child of this element.
      *
      * @param node Child node to look for.
      * @returns Child node's starting offset.
      */
-    getChildStartOffset(node: Node): number | null;
+    getChildStartOffset(node: ModelNode): number | null;
     /**
      * Returns index of a node that occupies given offset. If given offset is too low, returns `0`. If given offset is
-     * too high, returns {@link module:engine/model/element~Element#getChildIndex index after last child}.
+     * too high, returns {@link module:engine/model/element~ModelElement#getChildIndex index after last child}.
      *
      * ```ts
      * const textNode = new Text( 'foo' );
@@ -109,7 +109,7 @@ export default class Element extends Node {
      *
      * @param relativePath Path of the node to find, relative to this element.
      */
-    getNodeByPath(relativePath: Array<number>): Node;
+    getNodeByPath(relativePath: Array<number>): ModelNode;
     /**
      * Returns the parent element of the given name. Returns null if the element is not inside the desired parent.
      *
@@ -119,7 +119,7 @@ export default class Element extends Node {
      */
     findAncestor(parentName: string, options?: {
         includeSelf?: boolean;
-    }): Element | null;
+    }): ModelElement | null;
     /**
      * Converts `Element` instance to plain object and returns it. Takes care of converting all of this element's children.
      *
@@ -134,39 +134,39 @@ export default class Element extends Node {
      * @param deep If set to `true` clones element and all its children recursively. When set to `false`,
      * element will be cloned without any child.
      */
-    _clone(deep?: boolean): Element;
+    _clone(deep?: boolean): ModelElement;
     /**
-     * {@link module:engine/model/element~Element#_insertChild Inserts} one or more nodes at the end of this element.
+     * {@link module:engine/model/element~ModelElement#_insertChild Inserts} one or more nodes at the end of this element.
      *
-     * @see module:engine/model/writer~Writer#append
+     * @see module:engine/model/writer~ModelWriter#append
      * @internal
      * @param nodes Nodes to be inserted.
      */
-    _appendChild(nodes: string | Item | Iterable<string | Item>): void;
+    _appendChild(nodes: string | ModelItem | Iterable<string | ModelItem>): void;
     /**
-     * Inserts one or more nodes at the given index and sets {@link module:engine/model/node~Node#parent parent} of these nodes
+     * Inserts one or more nodes at the given index and sets {@link module:engine/model/node~ModelNode#parent parent} of these nodes
      * to this element.
      *
-     * @see module:engine/model/writer~Writer#insert
+     * @see module:engine/model/writer~ModelWriter#insert
      * @internal
      * @param index Index at which nodes should be inserted.
      * @param items Items to be inserted.
      */
-    _insertChild(index: number, items: string | Item | Iterable<string | Item>): void;
+    _insertChild(index: number, items: string | ModelItem | Iterable<string | ModelItem>): void;
     /**
      * Removes one or more nodes starting at the given index and sets
-     * {@link module:engine/model/node~Node#parent parent} of these nodes to `null`.
+     * {@link module:engine/model/node~ModelNode#parent parent} of these nodes to `null`.
      *
-     * @see module:engine/model/writer~Writer#remove
+     * @see module:engine/model/writer~ModelWriter#remove
      * @internal
      * @param index Index of the first node to remove.
      * @param howMany Number of nodes to remove.
      * @returns Array containing removed nodes.
      */
-    _removeChildren(index: number, howMany?: number): Array<Node>;
+    _removeChildren(index: number, howMany?: number): Array<ModelNode>;
     /**
      * Removes children nodes provided as an array and sets
-     * the {@link module:engine/model/node~Node#parent parent} of these nodes to `null`.
+     * the {@link module:engine/model/node~ModelNode#parent parent} of these nodes to `null`.
      *
      * These nodes do not need to be direct siblings.
      *
@@ -175,7 +175,7 @@ export default class Element extends Node {
      * @internal
      * @param nodes Array of nodes.
      */
-    _removeChildrenArray(nodes: Array<Node>): void;
+    _removeChildrenArray(nodes: Array<ModelNode>): void;
     /**
      * Creates an `Element` instance from given plain object (i.e. parsed JSON string).
      * Converts `Element` children to proper nodes.
@@ -183,5 +183,5 @@ export default class Element extends Node {
      * @param json Plain object to be converted to `Element`.
      * @returns `Element` instance created using given plain object.
      */
-    static fromJSON(json: any): Element;
+    static fromJSON(json: any): ModelElement;
 }