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

package/src/view/uielement.d.ts

@@ -5,12 +5,12 @@
 /**
  * @module engine/view/uielement
  */
-import Element, { type ElementAttributes } from './element.js';
-import Node from './node.js';
-import type View from './view.js';
-import type Document from './document.js';
-import type DomConverter from './domconverter.js';
-import type Item from './item.js';
+import { ViewElement, type ViewElementAttributes } from './element.js';
+import { ViewNode } from './node.js';
+import { type EditingView } from './view.js';
+import { type ViewDocument } from './document.js';
+import { type ViewDomConverter } from './domconverter.js';
+import { type ViewItem } from './item.js';
 type DomDocument = globalThis.Document;
 type DomElement = globalThis.HTMLElement;
 /**
@@ -19,44 +19,44 @@ type DomElement = globalThis.HTMLElement;
  * UI elements can be used.
  *
  * How a UI element is rendered is in your control (you pass a callback to
- * {@link module:engine/view/downcastwriter~DowncastWriter#createUIElement `downcastWriter#createUIElement()`}).
+ * {@link module:engine/view/downcastwriter~ViewDowncastWriter#createUIElement `downcastWriter#createUIElement()`}).
  * The editor will ignore your UI element – the selection cannot be placed in it, it is skipped (invisible) when
  * the user modifies the selection by using arrow keys and the editor does not listen to any mutations which
  * happen inside your UI elements.
  *
  * The limitation is that you cannot convert a model element to a UI element. UI elements need to be
  * created for {@link module:engine/model/markercollection~Marker markers} or as additinal elements
- * inside normal {@link module:engine/view/containerelement~ContainerElement container elements}.
+ * inside normal {@link module:engine/view/containerelement~ViewContainerElement container elements}.
  *
  * To create a new UI element use the
- * {@link module:engine/view/downcastwriter~DowncastWriter#createUIElement `downcastWriter#createUIElement()`} method.
+ * {@link module:engine/view/downcastwriter~ViewDowncastWriter#createUIElement `downcastWriter#createUIElement()`} method.
  */
-export default class UIElement extends Element {
+export declare class ViewUIElement extends ViewElement {
     /**
      * Creates new instance of UIElement.
      *
      * Throws {@link module:utils/ckeditorerror~CKEditorError CKEditorError} `view-uielement-cannot-add` when third parameter is passed,
      * to inform that usage of UIElement is incorrect (adding child nodes to UIElement is forbidden).
      *
-     * @see module:engine/view/downcastwriter~DowncastWriter#createUIElement
+     * @see module:engine/view/downcastwriter~ViewDowncastWriter#createUIElement
      * @internal
      * @param document The document instance to which this element belongs.
      * @param name Node name.
      * @param attrs Collection of attributes.
      * @param children A list of nodes to be inserted into created element.
      */
-    constructor(document: Document, name: string, attrs?: ElementAttributes, children?: Node | Iterable<Node>);
+    constructor(document: ViewDocument, name: string, attrs?: ViewElementAttributes, children?: ViewNode | Iterable<ViewNode>);
     /**
-     * Overrides {@link module:engine/view/element~Element#_insertChild} method.
+     * Overrides {@link module:engine/view/element~ViewElement#_insertChild} method.
      * Throws {@link module:utils/ckeditorerror~CKEditorError CKEditorError} `view-uielement-cannot-add` to prevent adding any child nodes
      * to UIElement.
      *
      * @internal
      */
-    _insertChild(index: number, items: Item | Iterable<Item>): number;
+    _insertChild(index: number, items: ViewItem | Iterable<ViewItem>): number;
     /**
-     * Renders this {@link module:engine/view/uielement~UIElement} to DOM. This method is called by
-     * {@link module:engine/view/domconverter~DomConverter}.
+     * Renders this {@link module:engine/view/uielement~ViewUIElement} to DOM. This method is called by
+     * {@link module:engine/view/domconverter~ViewDomConverter}.
      * Do not use inheritance to create custom rendering method, replace `render()` method instead:
      *
      * ```ts
@@ -74,9 +74,9 @@ export default class UIElement extends Element {
      * the {@link module:ui/editorui/editorui~EditorUI#update `editor.ui.update()`} method
      * after rendering your UI element.
      *
-     * @param domConverter Instance of the DomConverter used to optimize the output.
+     * @param domConverter Instance of the ViewDomConverter used to optimize the output.
      */
-    render(domDocument: DomDocument, domConverter: DomConverter): DomElement;
+    render(domDocument: DomDocument, domConverter: ViewDomConverter): DomElement;
     /**
      * Creates DOM element based on this view UIElement.
      * Note that each time this method is called new DOM element is created.
@@ -84,13 +84,14 @@ export default class UIElement extends Element {
     toDomElement(domDocument: DomDocument): DomElement;
 }
 /**
- * This function injects UI element handling to the given {@link module:engine/view/document~Document document}.
+ * This function injects UI element handling to the given {@link module:engine/view/document~ViewDocument document}.
  *
- * A callback is added to {@link module:engine/view/document~Document#event:keydown document keydown event}.
+ * A callback is added to {@link module:engine/view/document~ViewDocument#event:keydown document keydown event}.
  * The callback handles the situation when right arrow key is pressed and selection is collapsed before a UI element.
  * Without this handler, it would be impossible to "jump over" UI element using right arrow key.
  *
  * @param view View controller to which the quirks handling will be injected.
+ * @internal
  */
-export declare function injectUiElementHandling(view: View): void;
+export declare function injectUiElementHandling(view: EditingView): void;
 export {};

package/src/view/uielement.js

@@ -5,8 +5,8 @@
 /**
  * @module engine/view/uielement
  */
-import Element from './element.js';
-import Node from './node.js';
+import { ViewElement } from './element.js';
+import { ViewNode } from './node.js';
 import { CKEditorError, keyCodes } from '@ckeditor/ckeditor5-utils';
 /**
  * UI element class. It should be used to represent editing UI which needs to be injected into the editing view
@@ -14,26 +14,26 @@ import { CKEditorError, keyCodes } from '@ckeditor/ckeditor5-utils';
  * UI elements can be used.
  *
  * How a UI element is rendered is in your control (you pass a callback to
- * {@link module:engine/view/downcastwriter~DowncastWriter#createUIElement `downcastWriter#createUIElement()`}).
+ * {@link module:engine/view/downcastwriter~ViewDowncastWriter#createUIElement `downcastWriter#createUIElement()`}).
  * The editor will ignore your UI element – the selection cannot be placed in it, it is skipped (invisible) when
  * the user modifies the selection by using arrow keys and the editor does not listen to any mutations which
  * happen inside your UI elements.
  *
  * The limitation is that you cannot convert a model element to a UI element. UI elements need to be
  * created for {@link module:engine/model/markercollection~Marker markers} or as additinal elements
- * inside normal {@link module:engine/view/containerelement~ContainerElement container elements}.
+ * inside normal {@link module:engine/view/containerelement~ViewContainerElement container elements}.
  *
  * To create a new UI element use the
- * {@link module:engine/view/downcastwriter~DowncastWriter#createUIElement `downcastWriter#createUIElement()`} method.
+ * {@link module:engine/view/downcastwriter~ViewDowncastWriter#createUIElement `downcastWriter#createUIElement()`} method.
  */
-export default class UIElement extends Element {
+export class ViewUIElement extends ViewElement {
     /**
      * Creates new instance of UIElement.
      *
      * Throws {@link module:utils/ckeditorerror~CKEditorError CKEditorError} `view-uielement-cannot-add` when third parameter is passed,
      * to inform that usage of UIElement is incorrect (adding child nodes to UIElement is forbidden).
      *
-     * @see module:engine/view/downcastwriter~DowncastWriter#createUIElement
+     * @see module:engine/view/downcastwriter~ViewDowncastWriter#createUIElement
      * @internal
      * @param document The document instance to which this element belongs.
      * @param name Node name.
@@ -45,16 +45,16 @@ export default class UIElement extends Element {
         this.getFillerOffset = getFillerOffset;
     }
     /**
-     * Overrides {@link module:engine/view/element~Element#_insertChild} method.
+     * Overrides {@link module:engine/view/element~ViewElement#_insertChild} method.
      * Throws {@link module:utils/ckeditorerror~CKEditorError CKEditorError} `view-uielement-cannot-add` to prevent adding any child nodes
      * to UIElement.
      *
      * @internal
      */
     _insertChild(index, items) {
-        if (items && (items instanceof Node || Array.from(items).length > 0)) {
+        if (items && (items instanceof ViewNode || Array.from(items).length > 0)) {
             /**
-             * Cannot add children to {@link module:engine/view/uielement~UIElement}.
+             * Cannot add children to {@link module:engine/view/uielement~ViewUIElement}.
              *
              * @error view-uielement-cannot-add
              */
@@ -63,8 +63,8 @@ export default class UIElement extends Element {
         return 0;
     }
     /**
-     * Renders this {@link module:engine/view/uielement~UIElement} to DOM. This method is called by
-     * {@link module:engine/view/domconverter~DomConverter}.
+     * Renders this {@link module:engine/view/uielement~ViewUIElement} to DOM. This method is called by
+     * {@link module:engine/view/domconverter~ViewDomConverter}.
      * Do not use inheritance to create custom rendering method, replace `render()` method instead:
      *
      * ```ts
@@ -82,7 +82,7 @@ export default class UIElement extends Element {
      * the {@link module:ui/editorui/editorui~EditorUI#update `editor.ui.update()`} method
      * after rendering your UI element.
      *
-     * @param domConverter Instance of the DomConverter used to optimize the output.
+     * @param domConverter Instance of the ViewDomConverter used to optimize the output.
      */
     render(domDocument, domConverter // eslint-disable-line @typescript-eslint/no-unused-vars
     ) {
@@ -103,7 +103,7 @@ export default class UIElement extends Element {
 }
 // The magic of type inference using `is` method is centralized in `TypeCheckable` class.
 // Proper overload would interfere with that.
-UIElement.prototype.is = function (type, name) {
+ViewUIElement.prototype.is = function (type, name) {
     if (!name) {
         return type === 'uiElement' || type === 'view:uiElement' ||
             // From super.is(). This is highly utilised method and cannot call super. See ckeditor/ckeditor5#6529.
@@ -116,13 +116,14 @@ UIElement.prototype.is = function (type, name) {
     }
 };
 /**
- * This function injects UI element handling to the given {@link module:engine/view/document~Document document}.
+ * This function injects UI element handling to the given {@link module:engine/view/document~ViewDocument document}.
  *
- * A callback is added to {@link module:engine/view/document~Document#event:keydown document keydown event}.
+ * A callback is added to {@link module:engine/view/document~ViewDocument#event:keydown document keydown event}.
  * The callback handles the situation when right arrow key is pressed and selection is collapsed before a UI element.
  * Without this handler, it would be impossible to "jump over" UI element using right arrow key.
  *
  * @param view View controller to which the quirks handling will be injected.
+ * @internal
  */
 export function injectUiElementHandling(view) {
     view.document.on('arrowKey', (evt, data) => jumpOverUiElement(evt, data, view.domConverter), { priority: 'low' });

package/src/view/upcastwriter.d.ts

@@ -5,54 +5,54 @@
 /**
  * @module engine/view/upcastwriter
  */
-import DocumentFragment from './documentfragment.js';
-import Element, { type ElementAttributes } from './element.js';
-import Text from './text.js';
-import Position, { type PositionOffset } from './position.js';
-import Range from './range.js';
-import Selection, { type PlaceOrOffset, type Selectable, type SelectionOptions } from './selection.js';
-import type Document from './document.js';
-import type Item from './item.js';
-import type Node from './node.js';
+import { ViewDocumentFragment } from './documentfragment.js';
+import { ViewElement, type ViewElementAttributes } from './element.js';
+import { ViewText } from './text.js';
+import { ViewPosition, type ViewPositionOffset } from './position.js';
+import { ViewRange } from './range.js';
+import { ViewSelection, type ViewPlaceOrOffset, type ViewSelectable, type ViewSelectionOptions } from './selection.js';
+import { type ViewDocument } from './document.js';
+import { type ViewItem } from './item.js';
+import { type ViewNode } from './node.js';
 /**
  * View upcast writer. It provides a set of methods used to manipulate non-semantic view trees.
  *
  * It should be used only while working on a non-semantic view
  * (e.g. a view created from HTML string on paste).
  * To manipulate a view which was or is being downcasted from the the model use the
- * {@link module:engine/view/downcastwriter~DowncastWriter downcast writer}.
+ * {@link module:engine/view/downcastwriter~ViewDowncastWriter downcast writer}.
  *
  * Read more about changing the view in the {@glink framework/architecture/editing-engine#changing-the-view Changing the view}
  * section of the {@glink framework/architecture/editing-engine Editing engine architecture} guide.
  *
- * Unlike `DowncastWriter`, which is available in the {@link module:engine/view/view~View#change `View#change()`} block,
- * `UpcastWriter` can be created wherever you need it:
+ * Unlike `ViewDowncastWriter`, which is available in the {@link module:engine/view/view~EditingView#change `View#change()`} block,
+ * `ViewUpcastWriter` can be created wherever you need it:
  *
  * ```ts
- * const writer = new UpcastWriter( viewDocument );
+ * const writer = new ViewUpcastWriter( viewDocument );
  * const text = writer.createText( 'foo!' );
  *
  * writer.appendChild( text, someViewElement );
  * ```
  */
-export default class UpcastWriter {
+export declare class ViewUpcastWriter {
     /**
      * The view document instance in which this upcast writer operates.
      */
-    readonly document: Document;
+    readonly document: ViewDocument;
     /**
      * @param document The view document instance in which this upcast writer operates.
      */
-    constructor(document: Document);
+    constructor(document: ViewDocument);
     /**
-     * Creates a new {@link module:engine/view/documentfragment~DocumentFragment} instance.
+     * Creates a new {@link module:engine/view/documentfragment~ViewDocumentFragment} instance.
      *
      * @param children A list of nodes to be inserted into the created document fragment.
      * @returns The created document fragment.
      */
-    createDocumentFragment(children?: Node | Iterable<Node>): DocumentFragment;
+    createDocumentFragment(children?: ViewNode | Iterable<ViewNode>): ViewDocumentFragment;
     /**
-     * Creates a new {@link module:engine/view/element~Element} instance.
+     * Creates a new {@link module:engine/view/element~ViewElement} instance.
      *
      * Attributes can be passed in various formats:
      *
@@ -67,62 +67,62 @@ export default class UpcastWriter {
      * @param children A list of nodes to be inserted into created element.
      * @returns Created element.
      */
-    createElement(name: string, attrs?: ElementAttributes, children?: Node | Iterable<Node>): Element;
+    createElement(name: string, attrs?: ViewElementAttributes, children?: ViewNode | Iterable<ViewNode>): ViewElement;
     /**
-     * Creates a new {@link module:engine/view/text~Text} instance.
+     * Creates a new {@link module:engine/view/text~ViewText} instance.
      *
      * @param data The text's data.
      * @returns The created text node.
      */
-    createText(data: string): Text;
+    createText(data: string): ViewText;
     /**
      * Clones the provided element.
      *
-     * @see module:engine/view/element~Element#_clone
+     * @see module:engine/view/element~ViewElement#_clone
      * @param element Element to be cloned.
      * @param deep If set to `true` clones element and all its children recursively. When set to `false`,
      * element will be cloned without any children.
      * @returns Clone of this element.
      */
-    clone(element: Element, deep?: boolean): Element;
+    clone(element: ViewElement, deep?: boolean): ViewElement;
     /**
      * Appends a child node or a list of child nodes at the end of this node
      * and sets the parent of these nodes to this element.
      *
-     * @see module:engine/view/element~Element#_appendChild
+     * @see module:engine/view/element~ViewElement#_appendChild
      * @param items Items to be inserted.
      * @param element Element to which items will be appended.
      * @returns Number of appended nodes.
      */
-    appendChild(items: Item | string | Iterable<Item | string>, element: Element | DocumentFragment): number;
+    appendChild(items: ViewItem | string | Iterable<ViewItem | string>, element: ViewElement | ViewDocumentFragment): number;
     /**
      * Inserts a child node or a list of child nodes on the given index and sets the parent of these nodes to
      * this element.
      *
-     * @see module:engine/view/element~Element#_insertChild
+     * @see module:engine/view/element~ViewElement#_insertChild
      * @param index Offset at which nodes should be inserted.
      * @param items Items to be inserted.
      * @param element Element to which items will be inserted.
      * @returns Number of inserted nodes.
      */
-    insertChild(index: number, items: Item | Iterable<Item>, element: Element | DocumentFragment): number;
+    insertChild(index: number, items: ViewItem | Iterable<ViewItem>, element: ViewElement | ViewDocumentFragment): number;
     /**
      * Removes the given number of child nodes starting at the given index and set the parent of these nodes to `null`.
      *
-     * @see module:engine/view/element~Element#_removeChildren
+     * @see module:engine/view/element~ViewElement#_removeChildren
      * @param index Offset from which nodes will be removed.
      * @param howMany Number of nodes to remove.
      * @param element Element which children will be removed.
      * @returns The array containing removed nodes.
      */
-    removeChildren(index: number, howMany: number, element: Element | DocumentFragment): Array<Node>;
+    removeChildren(index: number, howMany: number, element: ViewElement | ViewDocumentFragment): Array<ViewNode>;
     /**
      * Removes given element from the view structure. Will not have effect on detached elements.
      *
      * @param element Element which will be removed.
      * @returns The array containing removed nodes.
      */
-    remove(element: Node): Array<Node>;
+    remove(element: ViewNode): Array<ViewNode>;
     /**
      * Replaces given element with the new one in the view structure. Will not have effect on detached elements.
      *
@@ -130,14 +130,14 @@ export default class UpcastWriter {
      * @param newElement Element which will be inserted in the place of the old element.
      * @returns Whether old element was successfully replaced.
      */
-    replace(oldElement: Element, newElement: Element): boolean;
+    replace(oldElement: ViewElement, newElement: ViewElement): boolean;
     /**
      * Removes given element from view structure and places its children in its position.
      * It does nothing if element has no parent.
      *
      * @param element Element to unwrap.
      */
-    unwrapElement(element: Element): void;
+    unwrapElement(element: ViewElement): void;
     /**
      * Renames element by creating a copy of a given element but with its name changed and then moving contents of the
      * old element to the new one.
@@ -148,7 +148,7 @@ export default class UpcastWriter {
      * @param  element Element to be renamed.
      * @returns New element or null if the old element was not replaced (happens for detached elements).
      */
-    rename(newName: string, element: Element): Element | null;
+    rename(newName: string, element: ViewElement): ViewElement | null;
     /**
      * Adds or overwrites element's attribute with a specified key and value.
      *
@@ -156,12 +156,12 @@ export default class UpcastWriter {
      * writer.setAttribute( 'href', 'http://ckeditor.com', linkElement );
      * ```
      *
-     * @see module:engine/view/element~Element#_setAttribute
+     * @see module:engine/view/element~ViewElement#_setAttribute
      * @param key Attribute key.
      * @param value Attribute value.
      * @param element Element for which attribute will be set.
      */
-    setAttribute(key: string, value: unknown, element: Element): void;
+    setAttribute(key: string, value: unknown, element: ViewElement): void;
     /**
      * Removes attribute from the element.
      *
@@ -169,11 +169,11 @@ export default class UpcastWriter {
      * writer.removeAttribute( 'href', linkElement );
      * ```
      *
-     * @see module:engine/view/element~Element#_removeAttribute
+     * @see module:engine/view/element~ViewElement#_removeAttribute
      * @param key Attribute key.
      * @param element Element from which attribute will be removed.
      */
-    removeAttribute(key: string, element: Element): void;
+    removeAttribute(key: string, element: ViewElement): void;
     /**
      * Adds specified class to the element.
      *
@@ -182,11 +182,11 @@ export default class UpcastWriter {
      * writer.addClass( [ 'foo', 'bar' ], linkElement );
      * ```
      *
-     * @see module:engine/view/element~Element#_addClass
+     * @see module:engine/view/element~ViewElement#_addClass
      * @param className Single class name or array of class names which will be added.
      * @param element Element for which class will be added.
      */
-    addClass(className: string | Array<string>, element: Element): void;
+    addClass(className: string | Array<string>, element: ViewElement): void;
     /**
      * Removes specified class from the element.
      *
@@ -195,11 +195,11 @@ export default class UpcastWriter {
      * writer.removeClass( [ 'foo', 'bar' ], linkElement );
      * ```
      *
-     * @see module:engine/view/element~Element#_removeClass
+     * @see module:engine/view/element~ViewElement#_removeClass
      * @param className Single class name or array of class names which will be removed.
      * @param element Element from which class will be removed.
      */
-    removeClass(className: string | Array<string>, element: Element): void;
+    removeClass(className: string | Array<string>, element: ViewElement): void;
     /**
      * Adds style to the element.
      *
@@ -211,13 +211,13 @@ export default class UpcastWriter {
      * {@link module:engine/controller/datacontroller~DataController#addStyleProcessorRules a particular style processor rule is enabled}.
      * See {@link module:engine/view/stylesmap~StylesMap#set `StylesMap#set()`} for details.
      *
-     * @see module:engine/view/element~Element#_setStyle
+     * @see module:engine/view/element~ViewElement#_setStyle
      * @label KEY_VALUE
      * @param property Property name.
      * @param value Value to set.
      * @param element Element for which style will be added.
      */
-    setStyle(property: string, value: string, element: Element): void;
+    setStyle(property: string, value: string, element: ViewElement): void;
     /**
      * Adds style to the element.
      *
@@ -232,12 +232,12 @@ export default class UpcastWriter {
      * {@link module:engine/controller/datacontroller~DataController#addStyleProcessorRules a particular style processor rule is enabled}.
      * See {@link module:engine/view/stylesmap~StylesMap#set `StylesMap#set()`} for details.
      *
-     * @see module:engine/view/element~Element#_setStyle
+     * @see module:engine/view/element~ViewElement#_setStyle
      * @label OBJECT
      * @param properties Object with key - value pairs.
      * @param element Element for which style will be added.
      */
-    setStyle(properties: Record<string, string>, element: Element): void;
+    setStyle(properties: Record<string, string>, element: ViewElement): void;
     /**
      * Removes specified style from the element.
      *
@@ -250,91 +250,91 @@ export default class UpcastWriter {
      * {@link module:engine/controller/datacontroller~DataController#addStyleProcessorRules a particular style processor rule is enabled}.
      * See {@link module:engine/view/stylesmap~StylesMap#remove `StylesMap#remove()`} for details.
      *
-     * @see module:engine/view/element~Element#_removeStyle
+     * @see module:engine/view/element~ViewElement#_removeStyle
      * @param property Style property name or names to be removed.
      * @param element Element from which style will be removed.
      */
-    removeStyle(property: string | Array<string>, element: Element): void;
+    removeStyle(property: string | Array<string>, element: ViewElement): void;
     /**
      * Sets a custom property on element. Unlike attributes, custom properties are not rendered to the DOM,
      * so they can be used to add special data to elements.
      *
-     * @see module:engine/view/element~Element#_setCustomProperty
+     * @see module:engine/view/element~ViewElement#_setCustomProperty
      * @param key Custom property name/key.
      * @param value Custom property value to be stored.
      * @param element Element for which custom property will be set.
      */
-    setCustomProperty(key: string | symbol, value: unknown, element: Element | DocumentFragment): void;
+    setCustomProperty(key: string | symbol, value: unknown, element: ViewElement | ViewDocumentFragment): void;
     /**
      * Removes a custom property stored under the given key.
      *
-     * @see module:engine/view/element~Element#_removeCustomProperty
+     * @see module:engine/view/element~ViewElement#_removeCustomProperty
      * @param key Name/key of the custom property to be removed.
      * @param element Element from which the custom property will be removed.
      * @returns Returns true if property was removed.
      */
-    removeCustomProperty(key: string | symbol, element: Element | DocumentFragment): boolean;
+    removeCustomProperty(key: string | symbol, element: ViewElement | ViewDocumentFragment): boolean;
     /**
      * Creates position at the given location. The location can be specified as:
      *
-     * * a {@link module:engine/view/position~Position position},
+     * * a {@link module:engine/view/position~ViewPosition position},
      * * parent element and offset (offset defaults to `0`),
      * * parent element and `'end'` (sets position at the end of that element),
-     * * {@link module:engine/view/item~Item view item} and `'before'` or `'after'` (sets position before or after given view item).
+     * * {@link module:engine/view/item~ViewItem view item} and `'before'` or `'after'` (sets position before or after given view item).
      *
      * This method is a shortcut to other constructors such as:
      *
      * * {@link #createPositionBefore},
      * * {@link #createPositionAfter},
      *
-     * @param offset Offset or one of the flags. Used only when first parameter is a {@link module:engine/view/item~Item view item}.
+     * @param offset Offset or one of the flags. Used only when first parameter is a {@link module:engine/view/item~ViewItem view item}.
      */
-    createPositionAt(itemOrPosition: Item | Position, offset?: PositionOffset): Position;
+    createPositionAt(itemOrPosition: ViewItem | ViewPosition, offset?: ViewPositionOffset): ViewPosition;
     /**
      * Creates a new position after given view item.
      *
      * @param item View item after which the position should be located.
      */
-    createPositionAfter(item: Item): Position;
+    createPositionAfter(item: ViewItem): ViewPosition;
     /**
      * Creates a new position before given view item.
      *
      * @param item View item before which the position should be located.
      */
-    createPositionBefore(item: Item): Position;
+    createPositionBefore(item: ViewItem): ViewPosition;
     /**
      * Creates a range spanning from `start` position to `end` position.
      *
-     * **Note:** This factory method creates it's own {@link module:engine/view/position~Position} instances basing on passed values.
+     * **Note:** This factory method creates it's own {@link module:engine/view/position~ViewPosition} instances basing on passed values.
      *
      * @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: ViewPosition, end: ViewPosition): ViewRange;
     /**
-     * Creates a range that starts before given {@link module:engine/view/item~Item view item} and ends after it.
+     * Creates a range that starts before given {@link module:engine/view/item~ViewItem view item} and ends after it.
      */
-    createRangeOn(item: Item): Range;
+    createRangeOn(item: ViewItem): ViewRange;
     /**
-     * Creates a range inside an {@link module:engine/view/element~Element element} which starts before the first child of
+     * Creates a range inside an {@link module:engine/view/element~ViewElement element} which starts before the first child of
      * that element and ends after the last child of that element.
      *
      * @param element Element which is a parent for the range.
      */
-    createRangeIn(element: Element | DocumentFragment): Range;
+    createRangeIn(element: ViewElement | ViewDocumentFragment): ViewRange;
     /**
-     * Creates a new {@link module:engine/view/selection~Selection} instance.
+     * Creates a new {@link module:engine/view/selection~ViewSelection} instance.
      *
      * ```ts
      * // Creates collapsed selection at the position of given item and offset.
      * const paragraph = writer.createContainerElement( 'paragraph' );
      * const selection = writer.createSelection( paragraph, offset );
      *
-     * // Creates a range inside an {@link module:engine/view/element~Element element} which starts before the
+     * // Creates a range inside an {@link module:engine/view/element~ViewElement element} which starts before the
      * // first child of that element and ends after the last child of that element.
      * const selection = writer.createSelection( paragraph, 'in' );
      *
-     * // Creates a range on an {@link module:engine/view/item~Item item} which starts before the item and ends
+     * // Creates a range on an {@link module:engine/view/item~ViewItem item} which starts before the item and ends
      * // just after the item.
      * const selection = writer.createSelection( paragraph, 'on' );
      * ```
@@ -362,9 +362,9 @@ export default class UpcastWriter {
      *
      * @label NODE_OFFSET
      */
-    createSelection(selectable: Node, placeOrOffset: PlaceOrOffset, options?: SelectionOptions): Selection;
+    createSelection(selectable: ViewNode, placeOrOffset: ViewPlaceOrOffset, options?: ViewSelectionOptions): ViewSelection;
     /**
-     * Creates a new {@link module:engine/view/selection~Selection} instance.
+     * Creates a new {@link module:engine/view/selection~ViewSelection} instance.
      *
      * ```ts
      * // Creates empty selection without ranges.
@@ -413,5 +413,5 @@ export default class UpcastWriter {
      *
      * @label SELECTABLE
      */
-    createSelection(selectable?: Exclude<Selectable, Node>, options?: SelectionOptions): Selection;
+    createSelection(selectable?: Exclude<ViewSelectable, ViewNode>, options?: ViewSelectionOptions): ViewSelection;
 }