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

package/src/model/writer.d.ts

@@ -2,18 +2,18 @@
  * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
  */
-import DocumentFragment from './documentfragment.js';
-import Element from './element.js';
-import Position, { type PositionOffset, type PositionStickiness } from './position.js';
-import Range from './range.js';
-import RootElement from './rootelement.js';
-import Text from './text.js';
+import { ModelDocumentFragment } from './documentfragment.js';
+import { ModelElement } from './element.js';
+import { ModelPosition, type ModelPositionOffset, type ModelPositionStickiness } from './position.js';
+import { ModelRange } from './range.js';
+import { ModelRootElement } from './rootelement.js';
+import { ModelText } from './text.js';
 import type { Marker } from './markercollection.js';
-import type { default as Selection, PlaceOrOffset, Selectable } from './selection.js';
-import type Batch from './batch.js';
-import type Item from './item.js';
-import type Model from './model.js';
-import type { default as Node, NodeAttributes } from './node.js';
+import type { ModelSelection, ModelPlaceOrOffset, ModelSelectable } from './selection.js';
+import { type Batch } from './batch.js';
+import { type ModelItem } from './item.js';
+import { type Model } from './model.js';
+import type { ModelNode, ModelNodeAttributes } from './node.js';
 /**
  * The model can only be modified by using the writer. It should be used whenever you want to create a node, modify
  * child nodes, attributes or text, set the selection's position and its attributes.
@@ -30,14 +30,14 @@ import type { default as Node, NodeAttributes } from './node.js';
  * Note that the writer should never be stored and used outside of the `change()` and
  * `enqueueChange()` blocks.
  *
- * Note that writer's methods do not check the {@link module:engine/model/schema~Schema}. It is possible
+ * Note that writer's methods do not check the {@link module:engine/model/schema~ModelSchema}. It is possible
  * to create incorrect model structures by using the writer. Read more about in
  * {@glink framework/deep-dive/schema#who-checks-the-schema "Who checks the schema?"}.
  *
  * @see module:engine/model/model~Model#change
  * @see module:engine/model/model~Model#enqueueChange
  */
-export default class Writer {
+export declare class ModelWriter {
     /**
      * Instance of the model on which this writer operates.
      */
@@ -56,7 +56,7 @@ export default class Writer {
      */
     constructor(model: Model, batch: Batch);
     /**
-     * Creates a new {@link module:engine/model/text~Text text node}.
+     * Creates a new {@link module:engine/model/text~ModelText text node}.
      *
      * ```ts
      * writer.createText( 'foo' );
@@ -65,11 +65,11 @@ export default class Writer {
      *
      * @param data Text data.
      * @param attributes Text attributes.
-     * @returns {module:engine/model/text~Text} Created text node.
+     * @returns {module:engine/model/text~ModelText} Created text node.
      */
-    createText(data: string, attributes?: NodeAttributes): Text;
+    createText(data: string, attributes?: ModelNodeAttributes): ModelText;
     /**
-     * Creates a new {@link module:engine/model/element~Element element}.
+     * Creates a new {@link module:engine/model/element~ModelElement element}.
      *
      * ```ts
      * writer.createElement( 'paragraph' );
@@ -80,13 +80,13 @@ export default class Writer {
      * @param attributes Elements attributes.
      * @returns Created element.
      */
-    createElement(name: string, attributes?: NodeAttributes): Element;
+    createElement(name: string, attributes?: ModelNodeAttributes): ModelElement;
     /**
-     * Creates a new {@link module:engine/model/documentfragment~DocumentFragment document fragment}.
+     * Creates a new {@link module:engine/model/documentfragment~ModelDocumentFragment document fragment}.
      *
      * @returns Created document fragment.
      */
-    createDocumentFragment(): DocumentFragment;
+    createDocumentFragment(): ModelDocumentFragment;
     /**
      * Creates a copy of the element and returns it. Created element has the same name and attributes as the original element.
      * If clone is deep, the original element's children are also cloned. If not, then empty element is returned.
@@ -95,7 +95,7 @@ export default class Writer {
      * @param deep If set to `true` clones element and all its children recursively. When set to `false`,
      * element will be cloned without any child.
      */
-    cloneElement(element: Element, deep?: boolean): Element;
+    cloneElement(element: ModelElement, deep?: boolean): ModelElement;
     /**
      * Inserts item on given position.
      *
@@ -132,16 +132,16 @@ export default class Writer {
      * Note that you cannot re-insert a node from a document to a different document or a document fragment. In this case,
      * `model-writer-insert-forbidden-move` is thrown.
      *
-     * If you want to move {@link module:engine/model/range~Range range} instead of an
-     * {@link module:engine/model/item~Item item} use {@link module:engine/model/writer~Writer#move `Writer#move()`}.
+     * If you want to move {@link module:engine/model/range~ModelRange range} instead of an
+     * {@link module:engine/model/item~ModelItem item} use {@link module:engine/model/writer~ModelWriter#move `Writer#move()`}.
      *
      * **Note:** For a paste-like content insertion mechanism see
      * {@link module:engine/model/model~Model#insertContent `model.insertContent()`}.
      *
      * @param item Item or document fragment to insert.
-     * @param offset Offset or one of the flags. Used only when second parameter is a {@link module:engine/model/item~Item model item}.
+     * @param offset Offset or one of the flags. Used only when second parameter is a {@link module:engine/model/item~ModelItem model item}.
      */
-    insert(item: Item | DocumentFragment, itemOrPosition: Item | DocumentFragment | Position, offset?: PositionOffset): void;
+    insert(item: ModelItem | ModelDocumentFragment, itemOrPosition: ModelItem | ModelDocumentFragment | ModelPosition, offset?: ModelPositionOffset): void;
     /**
      * Creates and inserts text on given position.
      *
@@ -165,9 +165,9 @@ export default class Writer {
      *
      * @label WITHOUT_ATTRIBUTES
      * @param text Text data.
-     * @param offset Offset or one of the flags. Used only when second parameter is a {@link module:engine/model/item~Item model item}.
+     * @param offset Offset or one of the flags. Used only when second parameter is a {@link module:engine/model/item~ModelItem model item}.
      */
-    insertText(text: string, itemOrPosition?: Item | Position, offset?: PositionOffset): void;
+    insertText(text: string, itemOrPosition?: ModelItem | ModelPosition, offset?: ModelPositionOffset): void;
     /**
      * Creates and inserts text with specified attributes on given position.
      *
@@ -192,9 +192,9 @@ export default class Writer {
      * @label WITH_ATTRIBUTES
      * @param text Text data.
      * @param attributes Text attributes.
-     * @param offset Offset or one of the flags. Used only when third parameter is a {@link module:engine/model/item~Item model item}.
+     * @param offset Offset or one of the flags. Used only when third parameter is a {@link module:engine/model/item~ModelItem model item}.
      */
-    insertText(text: string, attributes?: NodeAttributes, itemOrPosition?: Item | Position, offset?: PositionOffset): void;
+    insertText(text: string, attributes?: ModelNodeAttributes, itemOrPosition?: ModelItem | ModelPosition, offset?: ModelPositionOffset): void;
     /**
      * Creates and inserts element on given position. You can optionally set attributes:
      *
@@ -218,9 +218,9 @@ export default class Writer {
      *
      * @label WITHOUT_ATTRIBUTES
      * @param name Name of the element.
-     * @param offset Offset or one of the flags. Used only when second parameter is a {@link module:engine/model/item~Item model item}.
+     * @param offset Offset or one of the flags. Used only when second parameter is a {@link module:engine/model/item~ModelItem model item}.
      */
-    insertElement(name: string, itemOrPosition: Item | DocumentFragment | Position, offset?: PositionOffset): void;
+    insertElement(name: string, itemOrPosition: ModelItem | ModelDocumentFragment | ModelPosition, offset?: ModelPositionOffset): void;
     /**
      * Creates and inserts element with specified attributes on given position.
      *
@@ -245,9 +245,9 @@ export default class Writer {
      * @label WITH_ATTRIBUTES
      * @param name Name of the element.
      * @param attributes Elements attributes.
-     * @param offset Offset or one of the flags. Used only when third parameter is a {@link module:engine/model/item~Item model item}.
+     * @param offset Offset or one of the flags. Used only when third parameter is a {@link module:engine/model/item~ModelItem model item}.
      */
-    insertElement(name: string, attributes: NodeAttributes, itemOrPosition: Item | DocumentFragment | Position, offset?: PositionOffset): void;
+    insertElement(name: string, attributes: ModelNodeAttributes, itemOrPosition: ModelItem | ModelDocumentFragment | ModelPosition, offset?: ModelPositionOffset): void;
     /**
      * Inserts item at the end of the given parent.
      *
@@ -258,12 +258,12 @@ export default class Writer {
      *
      * Note that if the item already has parent it will be removed from the previous parent.
      *
-     * If you want to move {@link module:engine/model/range~Range range} instead of an
-     * {@link module:engine/model/item~Item item} use {@link module:engine/model/writer~Writer#move `Writer#move()`}.
+     * If you want to move {@link module:engine/model/range~ModelRange range} instead of an
+     * {@link module:engine/model/item~ModelItem item} use {@link module:engine/model/writer~ModelWriter#move `Writer#move()`}.
      *
      * @param item Item or document fragment to insert.
      */
-    append(item: Item | DocumentFragment, parent: Element | DocumentFragment): void;
+    append(item: ModelItem | ModelDocumentFragment, parent: ModelElement | ModelDocumentFragment): void;
     /**
      * Creates text node and inserts it at the end of the parent.
      *
@@ -274,7 +274,7 @@ export default class Writer {
      * @label WITHOUT_ATTRIBUTES
      * @param text Text data.
      */
-    appendText(text: string, parent: Element | DocumentFragment): void;
+    appendText(text: string, parent: ModelElement | ModelDocumentFragment): void;
     /**
      * Creates text node with specified attributes and inserts it at the end of the parent.
      *
@@ -286,7 +286,7 @@ export default class Writer {
      * @param text Text data.
      * @param attributes Text attributes.
      */
-    appendText(text: string, attributes: NodeAttributes, parent: Element | DocumentFragment): void;
+    appendText(text: string, attributes: ModelNodeAttributes, parent: ModelElement | ModelDocumentFragment): void;
     /**
      * Creates element and inserts it at the end of the parent.
      *
@@ -297,7 +297,7 @@ export default class Writer {
      * @label WITHOUT_ATTRIBUTES
      * @param name Name of the element.
      */
-    appendElement(name: string, parent: Element | DocumentFragment): void;
+    appendElement(name: string, parent: ModelElement | ModelDocumentFragment): void;
     /**
      * Creates element with specified attributes and inserts it at the end of the parent.
      *
@@ -309,19 +309,19 @@ export default class Writer {
      * @param name Name of the element.
      * @param attributes Elements attributes.
      */
-    appendElement(name: string, attributes: NodeAttributes, parent: Element | DocumentFragment): void;
+    appendElement(name: string, attributes: ModelNodeAttributes, parent: ModelElement | ModelDocumentFragment): void;
     /**
-     * Sets value of the attribute with given key on a {@link module:engine/model/item~Item model item}
-     * or on a {@link module:engine/model/range~Range range}.
+     * Sets value of the attribute with given key on a {@link module:engine/model/item~ModelItem model item}
+     * or on a {@link module:engine/model/range~ModelRange range}.
      *
      * @param key Attribute key.
      * @param value Attribute new value.
      * @param itemOrRange Model item or range on which the attribute will be set.
      */
-    setAttribute(key: string, value: unknown, itemOrRange: Item | Range): void;
+    setAttribute(key: string, value: unknown, itemOrRange: ModelItem | ModelRange): void;
     /**
-     * Sets values of attributes on a {@link module:engine/model/item~Item model item}
-     * or on a {@link module:engine/model/range~Range range}.
+     * Sets values of attributes on a {@link module:engine/model/item~ModelItem model item}
+     * or on a {@link module:engine/model/range~ModelRange range}.
      *
      * ```ts
      * writer.setAttributes( {
@@ -333,21 +333,21 @@ export default class Writer {
      * @param attributes Attributes keys and values.
      * @param itemOrRange Model item or range on which the attributes will be set.
      */
-    setAttributes(attributes: NodeAttributes, itemOrRange: Item | Range): void;
+    setAttributes(attributes: ModelNodeAttributes, itemOrRange: ModelItem | ModelRange): void;
     /**
-     * Removes an attribute with given key from a {@link module:engine/model/item~Item model item}
-     * or from a {@link module:engine/model/range~Range range}.
+     * Removes an attribute with given key from a {@link module:engine/model/item~ModelItem model item}
+     * or from a {@link module:engine/model/range~ModelRange range}.
      *
      * @param key Attribute key.
      * @param itemOrRange Model item or range from which the attribute will be removed.
      */
-    removeAttribute(key: string, itemOrRange: Item | Range): void;
+    removeAttribute(key: string, itemOrRange: ModelItem | ModelRange): void;
     /**
      * Removes all attributes from all elements in the range or from the given item.
      *
      * @param itemOrRange Model item or range from which all attributes will be removed.
      */
-    clearAttributes(itemOrRange: Item | Range): void;
+    clearAttributes(itemOrRange: ModelItem | ModelRange): void;
     /**
      * Moves all items in the source range to the target position.
      *
@@ -370,20 +370,20 @@ export default class Writer {
      * These parameters work the same way as {@link #createPositionAt `writer.createPositionAt()`}.
      *
      * 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},
+     * (element or document fragment) or between {@link module:engine/model/document~ModelDocument#roots documents roots},
      * 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.
+     * {@link module:engine/model/writer~ModelWriter#insert} in such cases.
      *
      * @param range Source range.
-     * @param offset Offset or one of the flags. Used only when second parameter is a {@link module:engine/model/item~Item model item}.
+     * @param offset Offset or one of the flags. Used only when second parameter is a {@link module:engine/model/item~ModelItem model item}.
      */
-    move(range: Range, itemOrPosition: Item | Position, offset?: PositionOffset): void;
+    move(range: ModelRange, itemOrPosition: ModelItem | ModelPosition, offset?: ModelPositionOffset): void;
     /**
-     * Removes given model {@link module:engine/model/item~Item item} or {@link module:engine/model/range~Range range}.
+     * Removes given model {@link module:engine/model/item~ModelItem item} or {@link module:engine/model/range~ModelRange range}.
      *
      * @param itemOrRange Model item or range to remove.
      */
-    remove(itemOrRange: Item | Range): void;
+    remove(itemOrRange: ModelItem | ModelRange): void;
     /**
      * Merges two siblings at the given position.
      *
@@ -392,68 +392,68 @@ export default class Writer {
      *
      * @param position Position between merged elements.
      */
-    merge(position: Position): void;
+    merge(position: ModelPosition): void;
     /**
      * Shortcut for {@link module:engine/model/model~Model#createPositionFromPath `Model#createPositionFromPath()`}.
      *
      * @param root Root of the position.
-     * @param path Position path. See {@link module:engine/model/position~Position#path}.
-     * @param stickiness Position stickiness. See {@link module:engine/model/position~PositionStickiness}.
+     * @param path Position path. See {@link module:engine/model/position~ModelPosition#path}.
+     * @param stickiness Position stickiness. See {@link module:engine/model/position~ModelPositionStickiness}.
      */
-    createPositionFromPath(root: Element | DocumentFragment, path: ReadonlyArray<number>, stickiness?: PositionStickiness): Position;
+    createPositionFromPath(root: ModelElement | ModelDocumentFragment, path: ReadonlyArray<number>, stickiness?: ModelPositionStickiness): ModelPosition;
     /**
      * Shortcut for {@link module:engine/model/model~Model#createPositionAt `Model#createPositionAt()`}.
      *
-     * @param offset Offset or one of the flags. Used only when first parameter is a {@link module:engine/model/item~Item model item}.
+     * @param offset Offset or one of the flags. Used only when first parameter is a {@link module:engine/model/item~ModelItem model item}.
      */
-    createPositionAt(itemOrPosition: Item | Position | DocumentFragment, offset?: PositionOffset): Position;
+    createPositionAt(itemOrPosition: ModelItem | ModelPosition | ModelDocumentFragment, offset?: ModelPositionOffset): ModelPosition;
     /**
      * Shortcut for {@link module:engine/model/model~Model#createPositionAfter `Model#createPositionAfter()`}.
      *
      * @param item Item after which the position should be placed.
      */
-    createPositionAfter(item: Item): Position;
+    createPositionAfter(item: ModelItem): ModelPosition;
     /**
      * Shortcut for {@link module:engine/model/model~Model#createPositionBefore `Model#createPositionBefore()`}.
      *
      * @param item Item after which the position should be placed.
      */
-    createPositionBefore(item: Item): Position;
+    createPositionBefore(item: ModelItem): ModelPosition;
     /**
      * Shortcut for {@link module:engine/model/model~Model#createRange `Model#createRange()`}.
      *
      * @param start Start position.
      * @param end End position. If not set, range will be collapsed at `start` position.
      */
-    createRange(start: Position, end?: Position): Range;
+    createRange(start: ModelPosition, end?: ModelPosition): ModelRange;
     /**
      * Shortcut for {@link module:engine/model/model~Model#createRangeIn `Model#createRangeIn()`}.
      *
      * @param element Element which is a parent for the range.
      */
-    createRangeIn(element: Element | DocumentFragment): Range;
+    createRangeIn(element: ModelElement | ModelDocumentFragment): ModelRange;
     /**
      * Shortcut for {@link module:engine/model/model~Model#createRangeOn `Model#createRangeOn()`}.
      *
      * @param element Element which is a parent for the range.
      */
-    createRangeOn(element: Item): Range;
+    createRangeOn(element: ModelItem): ModelRange;
     /**
      * Shortcut for {@link module:engine/model/model~Model#createSelection:NODE_OFFSET `Model#createSelection()`}.
      *
      * @label NODE_OFFSET
      */
-    createSelection(selectable: Node, placeOrOffset: PlaceOrOffset, options?: {
+    createSelection(selectable: ModelNode, placeOrOffset: ModelPlaceOrOffset, options?: {
         backward?: boolean;
-    }): Selection;
+    }): ModelSelection;
     /**
      * Shortcut for {@link module:engine/model/model~Model#createSelection:SELECTABLE `Model#createSelection()`}.
      *
      * @label SELECTABLE
      */
-    createSelection(selectable?: Exclude<Selectable, Node>, options?: {
+    createSelection(selectable?: Exclude<ModelSelectable, ModelNode>, options?: {
         backward?: boolean;
-    }): Selection;
+    }): ModelSelection;
     /**
      * Performs merge action in a detached tree.
      *
@@ -472,7 +472,7 @@ export default class Writer {
      * @param element The element to rename.
      * @param newName New element name.
      */
-    rename(element: Element | DocumentFragment, newName: string): void;
+    rename(element: ModelElement | ModelDocumentFragment, newName: string): void;
     /**
      * Splits elements starting from the given position and going to the top of the model tree as long as given
      * `limitElement` is reached. When `limitElement` is not defined then only the parent of the given position will be split.
@@ -486,27 +486,27 @@ export default class Writer {
      * * `position` - Position between split elements.
      * * `range` - Range that stars from the end of the first split element and ends at the beginning of the first copy element.
      */
-    split(position: Position, limitElement?: Node | DocumentFragment): {
-        position: Position;
-        range: Range;
+    split(position: ModelPosition, limitElement?: ModelNode | ModelDocumentFragment): {
+        position: ModelPosition;
+        range: ModelRange;
     };
     /**
      * Wraps the given range with the given element or with a new element (if a string was passed).
      *
-     * **Note:** range to wrap should be a "flat range" (see {@link module:engine/model/range~Range#isFlat `Range#isFlat`}).
+     * **Note:** range to wrap should be a "flat range" (see {@link module:engine/model/range~ModelRange#isFlat `Range#isFlat`}).
      * If not, an error will be thrown.
      *
      * @param range Range to wrap.
      * @param elementOrString Element or name of element to wrap the range with.
      */
-    wrap(range: Range, elementOrString: Element | string): void;
+    wrap(range: ModelRange, elementOrString: ModelElement | string): void;
     /**
      * Unwraps children of the given element – all its children are moved before it and then the element is removed.
      * Throws error if you try to unwrap an element which does not have a parent.
      *
      * @param element Element to unwrap.
      */
-    unwrap(element: Element): void;
+    unwrap(element: ModelElement): void;
     /**
      * Adds a {@link module:engine/model/markercollection~Marker marker}. Marker is a named range, which tracks
      * changes in the document and updates its range automatically, when model tree changes.
@@ -520,8 +520,8 @@ export default class Writer {
      * The `options.affectsData` parameter, which defaults to `false`, allows you to define if a marker affects the data. It should be
      * `true` when the marker change changes the data returned by the
      * {@link module:core/editor/editor~Editor#getData `editor.getData()`} method.
-     * When set to `true` it fires the {@link module:engine/model/document~Document#event:change:data `change:data`} event.
-     * When set to `false` it fires the {@link module:engine/model/document~Document#event:change `change`} event.
+     * When set to `true` it fires the {@link module:engine/model/document~ModelDocument#event:change:data `change:data`} event.
+     * When set to `false` it fires the {@link module:engine/model/document~ModelDocument#event:change `change`} event.
      *
      * Create marker directly base on marker's name:
      *
@@ -554,7 +554,7 @@ export default class Writer {
     addMarker(name: string, options: {
         usingOperation: boolean;
         affectsData?: boolean;
-        range: Range;
+        range: ModelRange;
     }): Marker;
     /**
      * Adds, updates or refreshes a {@link module:engine/model/markercollection~Marker marker}. Marker is a named range, which tracks
@@ -564,7 +564,8 @@ export default class Writer {
      * As the first parameter you can set marker name or instance. If none of them is provided, new marker, with a unique
      * name is created and returned.
      *
-     * **Note**: If you want to change the {@link module:engine/view/element~Element view element} of the marker while its data in the model
+     * **Note**: If you want to change the {@link module:engine/view/element~ViewElement view element}
+     * of the marker while its data in the model
      * remains the same, use the dedicated {@link module:engine/controller/editingcontroller~EditingController#reconvertMarker} method.
      *
      * The `options.usingOperation` parameter lets you change if the marker should be managed by operations or not. See
@@ -574,8 +575,8 @@ export default class Writer {
      * The `options.affectsData` parameter, which defaults to `false`, allows you to define if a marker affects the data. It should be
      * `true` when the marker change changes the data returned by
      * the {@link module:core/editor/editor~Editor#getData `editor.getData()`} method.
-     * When set to `true` it fires the {@link module:engine/model/document~Document#event:change:data `change:data`} event.
-     * When set to `false` it fires the {@link module:engine/model/document~Document#event:change `change`} event.
+     * When set to `true` it fires the {@link module:engine/model/document~ModelDocument#event:change:data `change:data`} event.
+     * When set to `false` it fires the {@link module:engine/model/document~ModelDocument#event:change `change`} event.
      *
      * Update marker directly base on marker's name:
      *
@@ -612,7 +613,7 @@ export default class Writer {
      * @param options.affectsData Flag indicating that the marker changes the editor data.
      */
     updateMarker(markerOrName: string | Marker, options?: {
-        range?: Range;
+        range?: ModelRange;
         usingOperation?: boolean;
         affectsData?: boolean;
     }): void;
@@ -634,7 +635,7 @@ export default class Writer {
      * (e.g. `$block` elements are allowed inside the `$root`). Make sure to define a proper schema if you use a different name.
      * @returns The added root element.
      */
-    addRoot(rootName: string, elementName?: string): RootElement;
+    addRoot(rootName: string, elementName?: string): ModelRootElement;
     /**
      * Detaches the root from the document.
      *
@@ -650,24 +651,24 @@ export default class Writer {
      *
      * @param rootOrName Name of the detached root.
      */
-    detachRoot(rootOrName: string | RootElement): void;
+    detachRoot(rootOrName: string | ModelRootElement): void;
     /**
      * Sets the document's selection (ranges and direction) to the specified location based on the given
-     * {@link module:engine/model/selection~Selectable selectable} or creates an empty selection if no arguments were passed.
+     * {@link module:engine/model/selection~ModelSelectable selectable} or creates an empty selection if no arguments were passed.
      *
      * ```ts
      * // Sets collapsed selection at the position of the given node and an offset.
      * writer.setSelection( paragraph, offset );
      * ```
      *
-     * Creates a range inside an {@link module:engine/model/element~Element element} which starts before the first child of
+     * Creates a range inside an {@link module:engine/model/element~ModelElement element} which starts before the first child of
      * that element and ends after the last child of that element.
      *
      * ```ts
      * writer.setSelection( paragraph, 'in' );
      * ```
      *
-     * Creates a range on an {@link module:engine/model/item~Item item} which starts before the item and ends just after the item.
+     * Creates a range on an {@link module:engine/model/item~ModelItem item} which starts before the item and ends just after the item.
      *
      * ```ts
      * writer.setSelection( paragraph, 'on' );
@@ -686,12 +687,12 @@ export default class Writer {
      *
      * @label NODE_OFFSET
      */
-    setSelection(selectable: Node, placeOrOffset: PlaceOrOffset, options?: {
+    setSelection(selectable: ModelNode, placeOrOffset: ModelPlaceOrOffset, options?: {
         backward?: boolean;
     }): void;
     /**
      * Sets the document's selection (ranges and direction) to the specified location based on the given
-     * {@link module:engine/model/selection~Selectable selectable} or creates an empty selection if no arguments were passed.
+     * {@link module:engine/model/selection~ModelSelectable selectable} or creates an empty selection if no arguments were passed.
      *
      * ```ts
      * // Sets selection to the given range.
@@ -731,19 +732,19 @@ export default class Writer {
      *
      * @label SELECTABLE
      */
-    setSelection(selectable: Exclude<Selectable, Node>, options?: {
+    setSelection(selectable: Exclude<ModelSelectable, ModelNode>, options?: {
         backward?: boolean;
     }): void;
     /**
-     * Moves {@link module:engine/model/documentselection~DocumentSelection#focus} to the specified location.
+     * Moves {@link module:engine/model/documentselection~ModelDocumentSelection#focus} to the specified location.
      *
      * The location can be specified in the same form as
      * {@link #createPositionAt `writer.createPositionAt()`} parameters.
      *
      * @param itemOrPosition
-     * @param offset Offset or one of the flags. Used only when first parameter is a {@link module:engine/model/item~Item model item}.
+     * @param offset Offset or one of the flags. Used only when first parameter is a {@link module:engine/model/item~ModelItem model item}.
      */
-    setSelectionFocus(itemOrPosition: Item | Position, offset?: PositionOffset): void;
+    setSelectionFocus(itemOrPosition: ModelItem | ModelPosition, offset?: ModelPositionOffset): void;
     /**
      * Sets attribute on the selection. If attribute with the same key already is set, it's value is overwritten.
      *
@@ -774,7 +775,7 @@ export default class Writer {
      * @label OBJECT
      * @param objectOrIterable Object / iterable of key => value attribute pairs.
      */
-    setSelectionAttribute(objectOrIterable: NodeAttributes): void;
+    setSelectionAttribute(objectOrIterable: ModelNodeAttributes): void;
     /**
      * Removes attribute(s) with given key(s) from the selection.
      *
@@ -794,7 +795,7 @@ export default class Writer {
      */
     removeSelectionAttribute(keyOrIterableOfKeys: string | Iterable<string>): void;
     /**
-     * Temporarily changes the {@link module:engine/model/documentselection~DocumentSelection#isGravityOverridden gravity}
+     * Temporarily changes the {@link module:engine/model/documentselection~ModelDocumentSelection#isGravityOverridden gravity}
      * of the selection from left to right.
      *
      * The gravity defines from which direction the selection inherits its attributes. If it's the default left gravity,
@@ -817,13 +818,13 @@ export default class Writer {
      */
     overrideSelectionGravity(): string;
     /**
-     * Restores {@link ~Writer#overrideSelectionGravity} gravity to default.
+     * Restores {@link ~ModelWriter#overrideSelectionGravity} gravity to default.
      *
      * Restoring the gravity is only possible using the unique identifier returned by
-     * {@link ~Writer#overrideSelectionGravity}. Note that the gravity remains overridden as long as won't be restored
+     * {@link ~ModelWriter#overrideSelectionGravity}. Note that the gravity remains overridden as long as won't be restored
      * the same number of times it was overridden.
      *
-     * @param uid The unique id returned by {@link ~Writer#overrideSelectionGravity}.
+     * @param uid The unique id returned by {@link ~ModelWriter#overrideSelectionGravity}.
      */
     restoreSelectionGravity(uid: string): void;
     /**