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

package/src/view/stylesmap.d.ts

@@ -2,12 +2,12 @@
  * @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 type { ElementAttributeValue } from './element.js';
+import type { ViewElementAttributeValue } from './element.js';
 import { type ArrayOrItem } from '@ckeditor/ckeditor5-utils';
 /**
  * Styles map. Allows handling (adding, removing, retrieving) a set of style rules (usually, of an element).
  */
-export default class StylesMap implements ElementAttributeValue {
+export declare class StylesMap implements ViewElementAttributeValue {
     /**
      * Keeps an internal representation of styles map. Normalized styles are kept as object tree to allow unified modification and
      * value access model using lodash's get, set, unset, etc methods.
@@ -61,7 +61,7 @@ export default class StylesMap implements ElementAttributeValue {
      *
      * ```ts
      * // Enable 'margin' shorthand processing:
-     * editor.data.addStyleProcessorRules( addMarginRules );
+     * editor.data.addStyleProcessorRules( addMarginStylesRules );
      *
      * styles.setTo( 'margin:2px;' );
      *
@@ -94,7 +94,7 @@ export default class StylesMap implements ElementAttributeValue {
      *
      * ```ts
      * // Enable 'margin' shorthand processing:
-     * editor.data.addStyleProcessorRules( addMarginRules );
+     * editor.data.addStyleProcessorRules( addMarginStylesRules );
      *
      * styles.set( 'margin', '2px' );
      * ```
@@ -173,7 +173,7 @@ export default class StylesMap implements ElementAttributeValue {
      *
      * ```ts
      * // Enable 'margin' shorthand processing:
-     * editor.data.addStyleProcessorRules( addMarginRules );
+     * editor.data.addStyleProcessorRules( addMarginStylesRules );
      *
      * styles.setTo( 'margin:1px' );
      *
@@ -191,7 +191,7 @@ export default class StylesMap implements ElementAttributeValue {
      *
      * ```ts
      * // Enable 'margin' shorthand processing:
-     * editor.data.addStyleProcessorRules( addMarginRules );
+     * editor.data.addStyleProcessorRules( addMarginStylesRules );
      *
      * const styles = new Styles();
      * styles.setTo( 'margin:1px 2px 3em;' );
@@ -227,7 +227,7 @@ export default class StylesMap implements ElementAttributeValue {
      *
      * ```ts
      * // Enable 'margin' shorthand processing:
-     * editor.data.addStyleProcessorRules( addMarginRules );
+     * editor.data.addStyleProcessorRules( addMarginStylesRules );
      *
      * styles.set( 'margin' , '1px' );
      * styles.set( 'background', '#f00' );
@@ -243,7 +243,7 @@ export default class StylesMap implements ElementAttributeValue {
      *
      * ```ts
      * // Enable 'margin' shorthand processing:
-     * editor.data.addStyleProcessorRules( addMarginRules );
+     * editor.data.addStyleProcessorRules( addMarginStylesRules );
      *
      * const styles = new Styles();
      * styles.setTo( 'margin:1px;' );
@@ -328,7 +328,7 @@ export default class StylesMap implements ElementAttributeValue {
     /**
      * Returns normalized styles entries for further processing.
      */
-    getStylesEntries(): Array<PropertyDescriptor>;
+    getStylesEntries(): Array<StylePropertyDescriptor>;
     /**
      * Clones the attribute value.
      *
@@ -353,38 +353,34 @@ export default class StylesMap implements ElementAttributeValue {
      */
     _getConsumables(name?: string): Array<string>;
     /**
-     * Used by {@link module:engine/view/element~Element#_canMergeAttributesFrom} to verify if the given attribute can be merged without
+     * Used by {@link module:engine/view/element~ViewElement#_canMergeAttributesFrom} to verify if the given attribute can be merged without
      * conflicts into the attribute.
      *
-     * This method is indirectly used by the {@link module:engine/view/downcastwriter~DowncastWriter} while down-casting
-     * an {@link module:engine/view/attributeelement~AttributeElement} to merge it with other AttributeElement.
+     * This method is indirectly used by the {@link module:engine/view/downcastwriter~ViewDowncastWriter} while down-casting
+     * an {@link module:engine/view/attributeelement~ViewAttributeElement} to merge it with other ViewAttributeElement.
      *
      * @internal
      */
     _canMergeFrom(other: StylesMap): boolean;
     /**
-     * Used by {@link module:engine/view/element~Element#_mergeAttributesFrom} to merge a given attribute into the attribute.
+     * Used by {@link module:engine/view/element~ViewElement#_mergeAttributesFrom} to merge a given attribute into the attribute.
      *
-     * This method is indirectly used by the {@link module:engine/view/downcastwriter~DowncastWriter} while down-casting
-     * an {@link module:engine/view/attributeelement~AttributeElement} to merge it with other AttributeElement.
+     * This method is indirectly used by the {@link module:engine/view/downcastwriter~ViewDowncastWriter} while down-casting
+     * an {@link module:engine/view/attributeelement~ViewAttributeElement} to merge it with other ViewAttributeElement.
      *
      * @internal
      */
     _mergeFrom(other: StylesMap): void;
     /**
-     * Used by {@link module:engine/view/element~Element#_canSubtractAttributesOf} to verify if the given attribute can be fully
+     * Used by {@link module:engine/view/element~ViewElement#_canSubtractAttributesOf} to verify if the given attribute can be fully
      * subtracted from the attribute.
      *
-     * This method is indirectly used by the {@link module:engine/view/downcastwriter~DowncastWriter} while down-casting
-     * an {@link module:engine/view/attributeelement~AttributeElement} to unwrap the AttributeElement.
+     * This method is indirectly used by the {@link module:engine/view/downcastwriter~ViewDowncastWriter} while down-casting
+     * an {@link module:engine/view/attributeelement~ViewAttributeElement} to unwrap the ViewAttributeElement.
      *
      * @internal
      */
     _isMatching(other: StylesMap): boolean;
-    /**
-     * Removes empty objects upon removing an entry from internal object.
-     */
-    private _cleanEmptyObjectsOnPath;
 }
 /**
  * Style processor is responsible for writing and reading a normalized styles object.
@@ -474,7 +470,7 @@ export declare class StylesProcessor {
      *
      * @param name Name of style property.
      */
-    getReducedForm(name: string, styles: Styles): Array<PropertyDescriptor>;
+    getReducedForm(name: string, styles: Styles): Array<StylePropertyDescriptor>;
     /**
      * Return all style properties. Also expand shorthand properties (e.g. `margin`, `background`) if respective extractor is available.
      *
@@ -550,7 +546,7 @@ export declare class StylesProcessor {
      * } );
      * ```
      */
-    setNormalizer(name: string, callback: Normalizer): void;
+    setNormalizer(name: string, callback: StylesNormalizer): void;
     /**
      * Adds a extractor callback for a style property.
      *
@@ -595,7 +591,7 @@ export declare class StylesProcessor {
      *
      * @param callbackOrPath Callback that return a requested value or path string for single values.
      */
-    setExtractor(name: string, callbackOrPath: Extractor): void;
+    setExtractor(name: string, callbackOrPath: StylesExtractor): void;
     /**
      * Adds a reducer callback for a style property.
      *
@@ -632,7 +628,7 @@ export declare class StylesProcessor {
      * } );
      * ```
      */
-    setReducer(name: string, callback: Reducer): void;
+    setReducer(name: string, callback: StylesReducer): void;
     /**
      * Defines a style shorthand relation to other style notations.
      *
@@ -671,7 +667,7 @@ export declare class StylesProcessor {
  * const marginTopDescriptor = [ 'margin-top', '2px' ];
  * ```
  */
-export type PropertyDescriptor = [name: string, value: string];
+export type StylePropertyDescriptor = [name: string, value: string];
 /**
  * An object describing values associated with the sides of a box, for instance margins, paddings,
  * border widths, border colors, etc.
@@ -692,7 +688,7 @@ export type PropertyDescriptor = [name: string, value: string];
  * };
  * ```
  */
-export type BoxSides = {
+export type BoxStyleSides = {
     /**
      * Top side value.
      */
@@ -719,13 +715,13 @@ export interface Styles {
 /**
  * The value of style.
  */
-export type StyleValue = string | Array<string> | Styles | BoxSides;
+export type StyleValue = string | Array<string> | Styles | BoxStyleSides;
 /**
  * A normalizer method for a style property.
  *
  * @see ~StylesProcessor#setNormalizer
  */
-export type Normalizer = (name: string) => {
+export type StylesNormalizer = (name: string) => {
     path: string;
     value: StyleValue;
 };
@@ -734,10 +730,10 @@ export type Normalizer = (name: string) => {
  *
  * @see ~StylesProcessor#setExtractor
  */
-export type Extractor = string | ((name: string, styles: Styles) => StyleValue | undefined);
+export type StylesExtractor = string | ((name: string, styles: Styles) => StyleValue | undefined);
 /**
  * A reducer callback for a style property.
  *
  * @see ~StylesProcessor#setReducer
  */
-export type Reducer = (value: StyleValue) => Array<PropertyDescriptor>;
+export type StylesReducer = (value: StyleValue) => Array<StylePropertyDescriptor>;

package/src/view/stylesmap.js

@@ -5,13 +5,13 @@
 /**
  * @module engine/view/stylesmap
  */
-import { get, isObject, merge, set, unset } from 'es-toolkit/compat';
+import { get, isObject, merge, set } from 'es-toolkit/compat';
 import { toArray } from '@ckeditor/ckeditor5-utils';
 import { isPatternMatched } from './matcher.js';
 /**
  * Styles map. Allows handling (adding, removing, retrieving) a set of style rules (usually, of an element).
  */
-export default class StylesMap {
+export class StylesMap {
     /**
      * Keeps an internal representation of styles map. Normalized styles are kept as object tree to allow unified modification and
      * value access model using lodash's get, set, unset, etc methods.
@@ -83,7 +83,7 @@ export default class StylesMap {
      *
      * ```ts
      * // Enable 'margin' shorthand processing:
-     * editor.data.addStyleProcessorRules( addMarginRules );
+     * editor.data.addStyleProcessorRules( addMarginStylesRules );
      *
      * styles.setTo( 'margin:2px;' );
      *
@@ -137,7 +137,7 @@ export default class StylesMap {
      *
      * ```ts
      * // Enable 'margin' shorthand processing:
-     * editor.data.addStyleProcessorRules( addMarginRules );
+     * editor.data.addStyleProcessorRules( addMarginStylesRules );
      *
      * styles.setTo( 'margin:1px' );
      *
@@ -150,13 +150,26 @@ export default class StylesMap {
      * @param names Style name or an array of names.
      */
     remove(names) {
+        const normalizedStylesToRemove = {};
         for (const name of toArray(names)) {
+            // First, try the easy path, when the path reflects normalized styles structure.
+            const path = toPath(name);
+            const pathValue = get(this._styles, path);
+            if (pathValue) {
+                appendStyleValue(normalizedStylesToRemove, path, pathValue);
+            }
+            else {
+                // Easy path did not work, so try to get the value from the styles map.
+                const value = this.getAsString(name);
+                if (value !== undefined) {
+                    this._styleProcessor.toNormalizedForm(name, value, normalizedStylesToRemove);
+                }
+            }
+        }
+        if (Object.keys(normalizedStylesToRemove).length) {
+            removeStyles(this._styles, normalizedStylesToRemove);
             this._cachedStyleNames = null;
             this._cachedExpandedStyleNames = null;
-            const path = toPath(name);
-            unset(this._styles, path);
-            delete this._styles[name];
-            this._cleanEmptyObjectsOnPath(path);
         }
     }
     /**
@@ -164,7 +177,7 @@ export default class StylesMap {
      *
      * ```ts
      * // Enable 'margin' shorthand processing:
-     * editor.data.addStyleProcessorRules( addMarginRules );
+     * editor.data.addStyleProcessorRules( addMarginStylesRules );
      *
      * const styles = new Styles();
      * styles.setTo( 'margin:1px 2px 3em;' );
@@ -202,7 +215,7 @@ export default class StylesMap {
      *
      * ```ts
      * // Enable 'margin' shorthand processing:
-     * editor.data.addStyleProcessorRules( addMarginRules );
+     * editor.data.addStyleProcessorRules( addMarginStylesRules );
      *
      * styles.set( 'margin' , '1px' );
      * styles.set( 'background', '#f00' );
@@ -226,7 +239,7 @@ export default class StylesMap {
      *
      * ```ts
      * // Enable 'margin' shorthand processing:
-     * editor.data.addStyleProcessorRules( addMarginRules );
+     * editor.data.addStyleProcessorRules( addMarginStylesRules );
      *
      * const styles = new Styles();
      * styles.setTo( 'margin:1px;' );
@@ -422,11 +435,11 @@ export default class StylesMap {
         return result;
     }
     /**
-     * Used by {@link module:engine/view/element~Element#_canMergeAttributesFrom} to verify if the given attribute can be merged without
+     * Used by {@link module:engine/view/element~ViewElement#_canMergeAttributesFrom} to verify if the given attribute can be merged without
      * conflicts into the attribute.
      *
-     * This method is indirectly used by the {@link module:engine/view/downcastwriter~DowncastWriter} while down-casting
-     * an {@link module:engine/view/attributeelement~AttributeElement} to merge it with other AttributeElement.
+     * This method is indirectly used by the {@link module:engine/view/downcastwriter~ViewDowncastWriter} while down-casting
+     * an {@link module:engine/view/attributeelement~ViewAttributeElement} to merge it with other ViewAttributeElement.
      *
      * @internal
      */
@@ -439,10 +452,10 @@ export default class StylesMap {
         return true;
     }
     /**
-     * Used by {@link module:engine/view/element~Element#_mergeAttributesFrom} to merge a given attribute into the attribute.
+     * Used by {@link module:engine/view/element~ViewElement#_mergeAttributesFrom} to merge a given attribute into the attribute.
      *
-     * This method is indirectly used by the {@link module:engine/view/downcastwriter~DowncastWriter} while down-casting
-     * an {@link module:engine/view/attributeelement~AttributeElement} to merge it with other AttributeElement.
+     * This method is indirectly used by the {@link module:engine/view/downcastwriter~ViewDowncastWriter} while down-casting
+     * an {@link module:engine/view/attributeelement~ViewAttributeElement} to merge it with other ViewAttributeElement.
      *
      * @internal
      */
@@ -454,11 +467,11 @@ export default class StylesMap {
         }
     }
     /**
-     * Used by {@link module:engine/view/element~Element#_canSubtractAttributesOf} to verify if the given attribute can be fully
+     * Used by {@link module:engine/view/element~ViewElement#_canSubtractAttributesOf} to verify if the given attribute can be fully
      * subtracted from the attribute.
      *
-     * This method is indirectly used by the {@link module:engine/view/downcastwriter~DowncastWriter} while down-casting
-     * an {@link module:engine/view/attributeelement~AttributeElement} to unwrap the AttributeElement.
+     * This method is indirectly used by the {@link module:engine/view/downcastwriter~ViewDowncastWriter} while down-casting
+     * an {@link module:engine/view/attributeelement~ViewAttributeElement} to unwrap the ViewAttributeElement.
      *
      * @internal
      */
@@ -470,25 +483,6 @@ export default class StylesMap {
         }
         return true;
     }
-    /**
-     * Removes empty objects upon removing an entry from internal object.
-     */
-    _cleanEmptyObjectsOnPath(path) {
-        const pathParts = path.split('.');
-        const isChildPath = pathParts.length > 1;
-        if (!isChildPath) {
-            return;
-        }
-        const parentPath = pathParts.splice(0, pathParts.length - 1).join('.');
-        const parentObject = get(this._styles, parentPath);
-        if (!parentObject) {
-            return;
-        }
-        const isParentEmpty = !Object.keys(parentObject).length;
-        if (isParentEmpty) {
-            this.remove(parentPath);
-        }
-    }
 }
 /**
  * Style processor is responsible for writing and reading a normalized styles object.
@@ -926,3 +920,22 @@ function appendStyleValue(stylesObject, nameOrPath, valueOrObject) {
     }
     set(stylesObject, nameOrPath, valueToSet);
 }
+/**
+ * Modifies the `styles` deeply nested object by removing properties defined in `toRemove`.
+ */
+function removeStyles(styles, toRemove) {
+    for (const key of Object.keys(toRemove)) {
+        if (styles[key] !== null &&
+            !Array.isArray(styles[key]) &&
+            typeof styles[key] == 'object' &&
+            typeof toRemove[key] == 'object') {
+            removeStyles(styles[key], toRemove[key]);
+            if (!Object.keys(styles[key]).length) {
+                delete styles[key];
+            }
+        }
+        else {
+            delete styles[key];
+        }
+    }
+}

package/src/view/text.d.ts

@@ -5,33 +5,33 @@
 /**
  * @module engine/view/text
  */
-import Node from './node.js';
-import type Document from './document.js';
+import { ViewNode } from './node.js';
+import { type ViewDocument } from './document.js';
 /**
  * Tree view text node.
  *
  * The constructor of this class should not be used directly. To create a new text node instance
- * use the {@link module:engine/view/downcastwriter~DowncastWriter#createText `DowncastWriter#createText()`}
+ * use the {@link module:engine/view/downcastwriter~ViewDowncastWriter#createText `ViewDowncastWriter#createText()`}
  * method when working on data downcasted from the model or the
- * {@link module:engine/view/upcastwriter~UpcastWriter#createText `UpcastWriter#createText()`}
+ * {@link module:engine/view/upcastwriter~ViewUpcastWriter#createText `ViewUpcastWriter#createText()`}
  * method when working on non-semantic views.
  */
-export default class Text extends Node {
+export declare class ViewText extends ViewNode {
     /**
      * The text content.
      *
-     * Setting the data fires the {@link module:engine/view/node~Node#event:change:text change event}.
+     * Setting the data fires the {@link module:engine/view/node~ViewNode#event:change:text change event}.
      */
     private _textData;
     /**
      * Creates a tree view text node.
      *
-     * @see module:engine/view/downcastwriter~DowncastWriter#createText
+     * @see module:engine/view/downcastwriter~ViewDowncastWriter#createText
      * @internal
      * @param document The document instance to which this text node belongs.
      * @param data The text's data.
      */
-    constructor(document: Document, data: string);
+    constructor(document: ViewDocument, data: string);
     /**
      * The text content.
      */
@@ -51,7 +51,7 @@ export default class Text extends Node {
      *
      * If the protected getter didn't exist, `foo._data` will return `undefined` and result of the merge will be invalid.
      *
-     * The setter sets data and fires the {@link module:engine/view/node~Node#event:change:text change event}.
+     * The setter sets data and fires the {@link module:engine/view/node~ViewNode#event:change:text change event}.
      *
      * @internal
      */
@@ -63,12 +63,12 @@ export default class Text extends Node {
      *
      * @param otherNode Node to check if it is same as this node.
      */
-    isSimilar(otherNode: Node): boolean;
+    isSimilar(otherNode: ViewNode): boolean;
     /**
      * Clones this node.
      *
      * @internal
      * @returns Text node that is a clone of this node.
      */
-    _clone(): Text;
+    _clone(): ViewText;
 }

package/src/view/text.js

@@ -5,27 +5,27 @@
 /**
  * @module engine/view/text
  */
-import Node from './node.js';
+import { ViewNode } from './node.js';
 /**
  * Tree view text node.
  *
  * The constructor of this class should not be used directly. To create a new text node instance
- * use the {@link module:engine/view/downcastwriter~DowncastWriter#createText `DowncastWriter#createText()`}
+ * use the {@link module:engine/view/downcastwriter~ViewDowncastWriter#createText `ViewDowncastWriter#createText()`}
  * method when working on data downcasted from the model or the
- * {@link module:engine/view/upcastwriter~UpcastWriter#createText `UpcastWriter#createText()`}
+ * {@link module:engine/view/upcastwriter~ViewUpcastWriter#createText `ViewUpcastWriter#createText()`}
  * method when working on non-semantic views.
  */
-export default class Text extends Node {
+export class ViewText extends ViewNode {
     /**
      * The text content.
      *
-     * Setting the data fires the {@link module:engine/view/node~Node#event:change:text change event}.
+     * Setting the data fires the {@link module:engine/view/node~ViewNode#event:change:text change event}.
      */
     _textData;
     /**
      * Creates a tree view text node.
      *
-     * @see module:engine/view/downcastwriter~DowncastWriter#createText
+     * @see module:engine/view/downcastwriter~ViewDowncastWriter#createText
      * @internal
      * @param document The document instance to which this text node belongs.
      * @param data The text's data.
@@ -55,7 +55,7 @@ export default class Text extends Node {
      *
      * If the protected getter didn't exist, `foo._data` will return `undefined` and result of the merge will be invalid.
      *
-     * The setter sets data and fires the {@link module:engine/view/node~Node#event:change:text change event}.
+     * The setter sets data and fires the {@link module:engine/view/node~ViewNode#event:change:text change event}.
      *
      * @internal
      */
@@ -73,7 +73,7 @@ export default class Text extends Node {
      * @param otherNode Node to check if it is same as this node.
      */
     isSimilar(otherNode) {
-        if (!(otherNode instanceof Text)) {
+        if (!(otherNode instanceof ViewText)) {
             return false;
         }
         return this === otherNode || this.data === otherNode.data;
@@ -85,12 +85,12 @@ export default class Text extends Node {
      * @returns Text node that is a clone of this node.
      */
     _clone() {
-        return new Text(this.document, this.data);
+        return new ViewText(this.document, this.data);
     }
 }
 // The magic of type inference using `is` method is centralized in `TypeCheckable` class.
 // Proper overload would interfere with that.
-Text.prototype.is = function (type) {
+ViewText.prototype.is = function (type) {
     return type === '$text' || type === 'view:$text' ||
         // This are legacy values kept for backward compatibility.
         type === 'text' || type === 'view:text' ||

package/src/view/textproxy.d.ts

@@ -5,43 +5,44 @@
 /**
  * @module engine/view/textproxy
  */
-import TypeCheckable from './typecheckable.js';
-import type Document from './document.js';
-import type DocumentFragment from './documentfragment.js';
-import type Element from './element.js';
-import type Node from './node.js';
-import type Text from './text.js';
+import { ViewTypeCheckable } from './typecheckable.js';
+import { type ViewDocument } from './document.js';
+import { type ViewDocumentFragment } from './documentfragment.js';
+import { type ViewElement } from './element.js';
+import { type ViewNode } from './node.js';
+import { type ViewText } from './text.js';
 /**
- * TextProxy is a wrapper for substring of {@link module:engine/view/text~Text}. Instance of this class is created by
- * {@link module:engine/view/treewalker~TreeWalker} when only a part of {@link module:engine/view/text~Text} needs to be returned.
+ * ViewTextProxy is a wrapper for substring of {@link module:engine/view/text~ViewText}. Instance of this class is created by
+ * {@link module:engine/view/treewalker~ViewTreeWalker} when only a part of {@link module:engine/view/text~ViewText} needs to be returned.
  *
- * `TextProxy` has an API similar to {@link module:engine/view/text~Text Text} and allows to do most of the common tasks performed
+ * `ViewTextProxy` has an API similar to {@link module:engine/view/text~ViewText Text} and allows to do most of the common tasks performed
  * on view nodes.
  *
- * **Note:** Some `TextProxy` instances may represent whole text node, not just a part of it.
- * See {@link module:engine/view/textproxy~TextProxy#isPartial}.
+ * **Note:** Some `ViewTextProxy` instances may represent whole text node, not just a part of it.
+ * See {@link module:engine/view/textproxy~ViewTextProxy#isPartial}.
  *
- * **Note:** `TextProxy` is a readonly interface.
+ * **Note:** `ViewTextProxy` is a readonly interface.
  *
- * **Note:** `TextProxy` instances are created on the fly basing on the current state of parent {@link module:engine/view/text~Text}.
+ * **Note:** `ViewTextProxy` instances are created on the fly basing
+ * on the current state of parent {@link module:engine/view/text~ViewText}.
  * Because of this it is highly unrecommended to store references to `TextProxy instances because they might get
- * invalidated due to operations on Document. Also TextProxy is not a {@link module:engine/view/node~Node} so it cannot be
- * inserted as a child of {@link module:engine/view/element~Element}.
+ * invalidated due to operations on Document. Also ViewTextProxy is not a {@link module:engine/view/node~ViewNode} so it cannot be
+ * inserted as a child of {@link module:engine/view/element~ViewElement}.
  *
- * `TextProxy` instances are created by {@link module:engine/view/treewalker~TreeWalker view tree walker}. You should not need to create
- * an instance of this class by your own.
+ * `ViewTextProxy` instances are created by {@link module:engine/view/treewalker~ViewTreeWalker view tree walker}.
+ * You should not need to create an instance of this class by your own.
  */
-export default class TextProxy extends TypeCheckable {
+export declare class ViewTextProxy extends ViewTypeCheckable {
     /**
-     * Reference to the {@link module:engine/view/text~Text} element which TextProxy is a substring.
+     * Reference to the {@link module:engine/view/text~ViewText} element which ViewTextProxy is a substring.
      */
-    readonly textNode: Text;
+    readonly textNode: ViewText;
     /**
      * Text data represented by this text proxy.
      */
     readonly data: string;
     /**
-     * Offset in the `textNode` where this `TextProxy` instance starts.
+     * Offset in the `textNode` where this `ViewTextProxy` instance starts.
      */
     readonly offsetInText: number;
     /**
@@ -49,37 +50,37 @@ export default class TextProxy extends TypeCheckable {
      *
      * @internal
      * @param textNode Text node which part is represented by this text proxy.
-     * @param offsetInText Offset in {@link module:engine/view/textproxy~TextProxy#textNode text node}
+     * @param offsetInText Offset in {@link module:engine/view/textproxy~ViewTextProxy#textNode text node}
      * from which the text proxy starts.
      * @param length Text proxy length, that is how many text node's characters, starting from `offsetInText` it represents.
      */
-    constructor(textNode: Text, offsetInText: number, length: number);
+    constructor(textNode: ViewText, offsetInText: number, length: number);
     /**
      * Offset size of this node.
      */
     get offsetSize(): number;
     /**
-     * Flag indicating whether `TextProxy` instance covers only part of the original {@link module:engine/view/text~Text text node}
+     * Flag indicating whether `ViewTextProxy` instance covers only part of the original {@link module:engine/view/text~ViewText text node}
      * (`true`) or the whole text node (`false`).
      *
-     * This is `false` when text proxy starts at the very beginning of {@link module:engine/view/textproxy~TextProxy#textNode textNode}
-     * ({@link module:engine/view/textproxy~TextProxy#offsetInText offsetInText} equals `0`) and text proxy sizes is equal to
+     * This is `false` when text proxy starts at the very beginning of {@link module:engine/view/textproxy~ViewTextProxy#textNode textNode}
+     * ({@link module:engine/view/textproxy~ViewTextProxy#offsetInText offsetInText} equals `0`) and text proxy sizes is equal to
      * text node size.
      */
     get isPartial(): boolean;
     /**
      * Parent of this text proxy, which is same as parent of text node represented by this text proxy.
      */
-    get parent(): Element | DocumentFragment | null;
+    get parent(): ViewElement | ViewDocumentFragment | null;
     /**
      * Root of this text proxy, which is same as root of text node represented by this text proxy.
      */
-    get root(): Node | DocumentFragment;
+    get root(): ViewNode | ViewDocumentFragment;
     /**
-     * {@link module:engine/view/document~Document View document} that owns this text proxy, or `null` if the text proxy is inside
-     * {@link module:engine/view/documentfragment~DocumentFragment document fragment}.
+     * {@link module:engine/view/document~ViewDocument View document} that owns this text proxy, or `null` if the text proxy is inside
+     * {@link module:engine/view/documentfragment~ViewDocumentFragment document fragment}.
      */
-    get document(): Document | null;
+    get document(): ViewDocument | null;
     /**
      * Returns ancestors array of this text proxy.
      *
@@ -92,5 +93,5 @@ export default class TextProxy extends TypeCheckable {
     getAncestors(options?: {
         includeSelf?: boolean;
         parentFirst?: boolean;
-    }): Array<Text | Element | DocumentFragment>;
+    }): Array<ViewText | ViewElement | ViewDocumentFragment>;
 }