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

package/src/conversion/downcasthelpers.js

@@ -7,14 +7,14 @@
  *
  * @module engine/conversion/downcasthelpers
  */
-import ModelRange from '../model/range.js';
-import ModelSelection from '../model/selection.js';
-import ModelDocumentSelection from '../model/documentselection.js';
-import ModelElement from '../model/element.js';
-import ModelPosition from '../model/position.js';
-import ViewAttributeElement from '../view/attributeelement.js';
-import ConversionHelpers from './conversionhelpers.js';
-import StylesMap from '../view/stylesmap.js';
+import { ModelRange } from '../model/range.js';
+import { ModelSelection } from '../model/selection.js';
+import { ModelDocumentSelection } from '../model/documentselection.js';
+import { ModelElement } from '../model/element.js';
+import { ModelPosition } from '../model/position.js';
+import { ViewAttributeElement } from '../view/attributeelement.js';
+import { ConversionHelpers } from './conversionhelpers.js';
+import { StylesMap } from '../view/stylesmap.js';
 import { CKEditorError, toArray } from '@ckeditor/ckeditor5-utils';
 import { cloneDeep } from 'es-toolkit/compat';
 /**
@@ -24,7 +24,7 @@ import { cloneDeep } from 'es-toolkit/compat';
  *
  * @extends module:engine/conversion/conversionhelpers~ConversionHelpers
  */
-export default class DowncastHelpers extends ConversionHelpers {
+export class DowncastHelpers extends ConversionHelpers {
     /**
      * Model element to view element conversion helper.
      *
@@ -505,7 +505,7 @@ export default class DowncastHelpers extends ConversionHelpers {
      * If a function is passed as the `config.view` parameter, it will be used to generate both boundary elements. The function
      * receives the `data` object and {@link module:engine/conversion/downcastdispatcher~DowncastConversionApi downcast conversion API}
      * as a parameters and should return an instance of the
-     * {@link module:engine/view/uielement~UIElement view UI element}. The `data` object and
+     * {@link module:engine/view/uielement~ViewUIElement view UI element}. The `data` object and
      * {@link module:engine/conversion/downcastdispatcher~DowncastConversionApi `conversionApi`} are passed from
      * {@link module:engine/conversion/downcastdispatcher~DowncastDispatcher#event:addMarker}. Additionally,
      * the `data.isOpening` parameter is passed, which is set to `true` for the marker start boundary element, and `false` for
@@ -528,13 +528,13 @@ export default class DowncastHelpers extends ConversionHelpers {
      * Model marker to highlight conversion helper.
      *
      * This conversion results in creating a highlight on view nodes. For this kind of conversion,
-     * the {@link module:engine/conversion/downcasthelpers~HighlightDescriptor} should be provided.
+     * the {@link module:engine/conversion/downcasthelpers~DowncastHighlightDescriptor} should be provided.
      *
-     * For text nodes, a `<span>` {@link module:engine/view/attributeelement~AttributeElement} is created and it wraps all text nodes
+     * For text nodes, a `<span>` {@link module:engine/view/attributeelement~ViewAttributeElement} is created and it wraps all text nodes
      * in the converted marker range. For example, a model marker set like this: `<paragraph>F[oo b]ar</paragraph>` becomes
      * `<p>F<span class="comment">oo b</span>ar</p>` in the view.
      *
-     * {@link module:engine/view/containerelement~ContainerElement} may provide a custom way of handling highlight. Most often,
+     * {@link module:engine/view/containerelement~ViewContainerElement} may provide a custom way of handling highlight. Most often,
      * the element itself is given classes and attributes described in the highlight descriptor (instead of being wrapped in `<span>`).
      * For example, a model marker set like this:
      * `[<imageInline src="foo.jpg"></imageInline>]` becomes `<img src="foo.jpg" class="comment"></img>` in the view.
@@ -569,7 +569,7 @@ export default class DowncastHelpers extends ConversionHelpers {
      * If a function is passed as the `config.view` parameter, it will be used to generate the highlight descriptor. The function
      * receives the `data` object and {@link module:engine/conversion/downcastdispatcher~DowncastConversionApi downcast conversion API}
      * as the parameters and should return a
-     * {@link module:engine/conversion/downcasthelpers~HighlightDescriptor highlight descriptor}.
+     * {@link module:engine/conversion/downcasthelpers~DowncastHighlightDescriptor highlight descriptor}.
      * The `data` object properties are passed from {@link module:engine/conversion/downcastdispatcher~DowncastDispatcher#event:addMarker}.
      *
      * See {@link module:engine/conversion/conversion~Conversion#for `conversion.for()`} to learn how to add a converter
@@ -720,6 +720,7 @@ export default class DowncastHelpers extends ConversionHelpers {
  * ```
  *
  * @returns Insert text event converter.
+ * @internal
  */
 export function insertText() {
     return (evt, data, conversionApi) => {
@@ -736,6 +737,7 @@ export function insertText() {
  * Function factory that creates a default downcast converter for triggering attributes and children conversion.
  *
  * @returns The converter.
+ * @internal
  */
 export function insertAttributesAndChildren() {
     return (evt, data, conversionApi) => {
@@ -755,6 +757,7 @@ export function insertAttributesAndChildren() {
  * ```
  *
  * @returns Remove event converter.
+ * @internal
  */
 export function remove() {
     return (evt, data, conversionApi) => {
@@ -773,11 +776,13 @@ export function remove() {
     };
 }
 /**
- * Creates a `<span>` {@link module:engine/view/attributeelement~AttributeElement view attribute element} from the information
- * provided by the {@link module:engine/conversion/downcasthelpers~HighlightDescriptor highlight descriptor} object. If the priority
+ * Creates a `<span>` {@link module:engine/view/attributeelement~ViewAttributeElement view attribute element} from the information
+ * provided by the {@link module:engine/conversion/downcasthelpers~DowncastHighlightDescriptor highlight descriptor} object. If the priority
  * is not provided in the descriptor, the default priority will be used.
+ *
+ * @internal
  */
-export function createViewElementFromHighlightDescriptor(writer, descriptor) {
+export function createViewElementFromDowncastHighlightDescriptor(writer, descriptor) {
     const viewElement = writer.createAttributeElement('span', descriptor.attributes);
     if (descriptor.classes) {
         viewElement._addClass(descriptor.classes);
@@ -789,8 +794,9 @@ export function createViewElementFromHighlightDescriptor(writer, descriptor) {
     return viewElement;
 }
 /**
- * Function factory that creates a converter which converts a non-collapsed {@link module:engine/model/selection~Selection model selection}
- * to a {@link module:engine/view/documentselection~DocumentSelection view selection}. The converter consumes appropriate
+ * Function factory that creates a converter which converts a non-collapsed
+ * {@link module:engine/model/selection~ModelSelection model selection}
+ * to a {@link module:engine/view/documentselection~ViewDocumentSelection view selection}. The converter consumes appropriate
  * value from the `consumable` object and maps model positions from the selection to view positions.
  *
  * ```ts
@@ -798,6 +804,7 @@ export function createViewElementFromHighlightDescriptor(writer, descriptor) {
  * ```
  *
  * @returns Selection converter.
+ * @internal
  */
 export function convertRangeSelection() {
     return (evt, data, conversionApi) => {
@@ -816,10 +823,11 @@ export function convertRangeSelection() {
     };
 }
 /**
- * Function factory that creates a converter which converts a collapsed {@link module:engine/model/selection~Selection model selection} to
- * a {@link module:engine/view/documentselection~DocumentSelection view selection}. The converter consumes appropriate
+ * Function factory that creates a converter which converts a collapsed
+ * {@link module:engine/model/selection~ModelSelection model selection} to
+ * a {@link module:engine/view/documentselection~ViewDocumentSelection view selection}. The converter consumes appropriate
  * value from the `consumable` object, maps the model selection position to the view position and breaks
- * {@link module:engine/view/attributeelement~AttributeElement attribute elements} at the selection position.
+ * {@link module:engine/view/attributeelement~ViewAttributeElement attribute elements} at the selection position.
  *
  * ```ts
  * modelDispatcher.on( 'selection', convertCollapsedSelection() );
@@ -840,6 +848,7 @@ export function convertRangeSelection() {
  * by merging attributes.
  *
  * @returns Selection converter.
+ * @internal
  */
 export function convertCollapsedSelection() {
     return (evt, data, conversionApi) => {
@@ -859,9 +868,9 @@ export function convertCollapsedSelection() {
 }
 /**
  * Function factory that creates a converter which cleans artifacts after the previous
- * {@link module:engine/model/selection~Selection model selection} conversion. It removes all empty
- * {@link module:engine/view/attributeelement~AttributeElement view attribute elements} and merges sibling attributes at all start and end
- * positions of all ranges.
+ * {@link module:engine/model/selection~ModelSelection model selection} conversion. It removes all empty
+ * {@link module:engine/view/attributeelement~ViewAttributeElement view attribute elements} and merges
+ * sibling attributes at all start and end positions of all ranges.
  *
  * ```
  *    <p><strong>^</strong></p>
@@ -884,6 +893,7 @@ export function convertCollapsedSelection() {
  * which does the opposite by breaking attributes in the selection position.
  *
  * @returns Selection converter.
+ * @internal
  */
 export function cleanSelection() {
     return (evt, data, conversionApi) => {
@@ -919,7 +929,7 @@ export function cleanSelection() {
  *
  * Passed `Function` will be provided with the attribute value and then all the parameters of the
  * {@link module:engine/conversion/downcastdispatcher~DowncastDispatcher#event:attribute `attribute` event}.
- * It is expected that the function returns an {@link module:engine/view/element~Element}.
+ * It is expected that the function returns an {@link module:engine/view/element~ViewElement}.
  * The result of the function will be the wrapping element.
  * When the provided `Function` does not return any element, no conversion will take place.
  *
@@ -973,7 +983,7 @@ export function wrap(elementCreator) {
  * Function factory that creates a converter which converts node insertion changes from the model to the view.
  * The function passed will be provided with all the parameters of the dispatcher's
  * {@link module:engine/conversion/downcastdispatcher~DowncastDispatcher#event:insert `insert` event}.
- * It is expected that the function returns an {@link module:engine/view/element~Element}.
+ * It is expected that the function returns an {@link module:engine/view/element~ViewElement}.
  * The result of the function will be inserted into the view.
  *
  * The converter automatically consumes the corresponding value from the consumables list and binds the model and view elements.
@@ -1021,7 +1031,7 @@ export function insertElement(elementCreator, consumer = defaultConsumer) {
 /**
  * Function factory that creates a converter which converts a single model node insertion to a view structure.
  *
- * It is expected that the passed element creator function returns an {@link module:engine/view/element~Element} with attached slots
+ * It is expected that the passed element creator function returns an {@link module:engine/view/element~ViewElement} with attached slots
  * created with `writer.createSlot()` to indicate where child nodes should be converted.
  *
  * @see module:engine/conversion/downcasthelpers~DowncastHelpers#elementToStructure
@@ -1060,7 +1070,7 @@ export function insertStructure(elementCreator, consumer) {
 }
 /**
  * Function factory that creates a converter which converts marker adding change to the
- * {@link module:engine/view/uielement~UIElement view UI element}.
+ * {@link module:engine/view/uielement~ViewUIElement view UI element}.
  *
  * The view UI element that will be added to the view depends on the passed parameter. See {@link ~insertElement}.
  * In case of a non-collapsed range, the UI element will not wrap nodes but separate elements will be placed at the beginning
@@ -1110,7 +1120,7 @@ export function insertUIElement(elementCreator) {
     };
 }
 /**
- * Function factory that returns a default downcast converter for removing a {@link module:engine/view/uielement~UIElement UI element}
+ * Function factory that returns a default downcast converter for removing a {@link module:engine/view/uielement~ViewUIElement UI element}
  * based on marker remove change.
  *
  * This converter unbinds elements from the marker name.
@@ -1284,7 +1294,7 @@ function removeMarkerData(viewCreator) {
  * ```
  *
  * @param attributeCreator Function returning an object with two properties: `key` and `value`, which
- * represent the attribute key and attribute value to be set on a {@link module:engine/view/element~Element view element}.
+ * represent the attribute key and attribute value to be set on a {@link module:engine/view/element~ViewElement view element}.
  * The function is passed the model attribute value as the first parameter and additional data about the change as the second parameter.
  * @returns Set/change attribute converter.
  */
@@ -1301,11 +1311,11 @@ function changeAttribute(attributeCreator) {
         conversionApi.consumable.consume(data.item, evt.name);
         const viewElement = conversionApi.mapper.toViewElement(data.item);
         const viewWriter = conversionApi.writer;
-        // If model item cannot be mapped to a view element, it means item is not an `Element` instance but a `TextProxy` node.
+        // If model item cannot be mapped to a view element, it means item is not an `Element` instance but a `ModelTextProxy` node.
         // Only elements can have attributes in a view so do not proceed for anything else (#1587).
         if (!viewElement) {
             /**
-             * This error occurs when a {@link module:engine/model/textproxy~TextProxy text node's} attribute is to be downcasted
+             * This error occurs when a {@link module:engine/model/textproxy~ModelTextProxy text node's} attribute is to be downcasted
              * by an {@link module:engine/conversion/conversion~Conversion#attributeToAttribute `Attribute to Attribute converter`}.
              * In most cases it is caused by converters misconfiguration when only "generic" converter is defined:
              *
@@ -1324,8 +1334,8 @@ function changeAttribute(attributeCreator) {
              * } );
              * ```
              *
-             * In such cases, to convert the same attribute for both {@link module:engine/model/element~Element}
-             * and {@link module:engine/model/textproxy~TextProxy `Text`} nodes, text specific
+             * In such cases, to convert the same attribute for both {@link module:engine/model/element~ModelElement}
+             * and {@link module:engine/model/textproxy~ModelTextProxy `Text`} nodes, text specific
              * {@link module:engine/conversion/conversion~Conversion#attributeToElement `Attribute to Element converter`}
              * with higher {@link module:utils/priorities~PriorityString priority} must also be defined:
              *
@@ -1377,8 +1387,8 @@ function changeAttribute(attributeCreator) {
 }
 /**
  * Function factory that creates a converter which converts the text inside marker's range. The converter wraps the text with
- * {@link module:engine/view/attributeelement~AttributeElement} created from the provided descriptor.
- * See {link module:engine/conversion/downcasthelpers~createViewElementFromHighlightDescriptor}.
+ * {@link module:engine/view/attributeelement~ViewAttributeElement} created from the provided descriptor.
+ * See {link module:engine/conversion/downcasthelpers~createViewElementFromDowncastHighlightDescriptor}.
  *
  * It can also be used to convert the selection that is inside a marker. In that case, an empty attribute element will be
  * created and the selection will be put inside it.
@@ -1387,7 +1397,7 @@ function changeAttribute(attributeCreator) {
  *
  * If the highlight descriptor does not provide the `id` property, the name of the marker will be used.
  *
- * This converter binds the created {@link module:engine/view/attributeelement~AttributeElement attribute elemens} with the marker name
+ * This converter binds the created {@link module:engine/view/attributeelement~ViewAttributeElement attribute elemens} with the marker name
  * using the {@link module:engine/conversion/mapper~Mapper#bindElementToMarker} method.
  */
 function highlightText(highlightDescriptor) {
@@ -1406,7 +1416,7 @@ function highlightText(highlightDescriptor) {
             return;
         }
         const viewWriter = conversionApi.writer;
-        const viewElement = createViewElementFromHighlightDescriptor(viewWriter, descriptor);
+        const viewElement = createViewElementFromDowncastHighlightDescriptor(viewWriter, descriptor);
         const viewSelection = viewWriter.document.selection;
         if (data.item instanceof ModelSelection || data.item instanceof ModelDocumentSelection) {
             viewWriter.wrap(viewSelection.getFirstRange(), viewElement);
@@ -1429,7 +1439,7 @@ function highlightText(highlightDescriptor) {
  * Converter function factory. It creates a function which applies the marker's highlight to an element inside the marker's range.
  *
  * The converter checks if an element has the `addHighlight` function stored as a
- * {@link module:engine/view/element~Element#_setCustomProperty custom property} and, if so, uses it to apply the highlight.
+ * {@link module:engine/view/element~ViewElement#_setCustomProperty custom property} and, if so, uses it to apply the highlight.
  * In such case the converter will consume all element's children, assuming that they were handled by the element itself.
  *
  * When the `addHighlight` custom property is not present, the element is not converted in any special way.
@@ -1439,8 +1449,8 @@ function highlightText(highlightDescriptor) {
  *
  * If the highlight descriptor does not provide the `id` property, the name of the marker will be used.
  *
- * This converter binds altered {@link module:engine/view/containerelement~ContainerElement container elements} with the marker name using
- * the {@link module:engine/conversion/mapper~Mapper#bindElementToMarker} method.
+ * This converter binds altered {@link module:engine/view/containerelement~ViewContainerElement container elements}
+ * with the marker name using the {@link module:engine/conversion/mapper~Mapper#bindElementToMarker} method.
  */
 function highlightElement(highlightDescriptor) {
     return (evt, data, conversionApi) => {
@@ -1476,11 +1486,11 @@ function highlightElement(highlightDescriptor) {
  *
  * Both text nodes and elements are handled by this converter but they are handled a bit differently.
  *
- * Text nodes are unwrapped using the {@link module:engine/view/attributeelement~AttributeElement attribute element} created from the
- * provided highlight descriptor. See {link module:engine/conversion/downcasthelpers~HighlightDescriptor}.
+ * Text nodes are unwrapped using the {@link module:engine/view/attributeelement~ViewAttributeElement attribute element} created from the
+ * provided highlight descriptor. See {link module:engine/conversion/downcasthelpers~DowncastHighlightDescriptor}.
  *
  * For elements, the converter checks if an element has the `removeHighlight` function stored as a
- * {@link module:engine/view/element~Element#_setCustomProperty custom property}. If so, it uses it to remove the highlight.
+ * {@link module:engine/view/element~ViewElement#_setCustomProperty custom property}. If so, it uses it to remove the highlight.
  * In such case, the children of that element will not be converted.
  *
  * When `removeHighlight` is not present, the element is not converted in any special way.
@@ -1503,7 +1513,7 @@ function removeHighlight(highlightDescriptor) {
             return;
         }
         // View element that will be used to unwrap `AttributeElement`s.
-        const viewHighlightElement = createViewElementFromHighlightDescriptor(conversionApi.writer, descriptor);
+        const viewHighlightElement = createViewElementFromDowncastHighlightDescriptor(conversionApi.writer, descriptor);
         // Get all elements bound with given marker name.
         const elements = conversionApi.mapper.markerNameToElements(data.markerName);
         if (!elements) {
@@ -1567,9 +1577,9 @@ function downcastElementToStructure(config) {
     return (dispatcher) => {
         if (dispatcher._conversionApi.schema.checkChild(model.name, '$text')) {
             /**
-             * This error occurs when a {@link module:engine/model/element~Element model element} is downcasted
+             * This error occurs when a {@link module:engine/model/element~ModelElement model element} is downcasted
              * via {@link module:engine/conversion/downcasthelpers~DowncastHelpers#elementToStructure} helper but the element was
-             * allowed to host `$text` by the {@link module:engine/model/schema~Schema model schema}.
+             * allowed to host `$text` by the {@link module:engine/model/schema~ModelSchema model schema}.
              *
              * For instance, this may be the result of `myElement` allowing the content of
              * {@glink framework/deep-dive/schema#generic-items `$block`} in its schema definition:
@@ -1623,7 +1633,7 @@ function downcastElementToStructure(config) {
  * @param config.model The key of the attribute to convert from or a `{ key, values }` object. `values` is an array
  * of `String`s with possible values if the model attribute is an enumerable.
  * @param config.view A view element definition or a function that takes the model attribute value and
- * {@link module:engine/view/downcastwriter~DowncastWriter view downcast writer} as parameters and returns a view attribute element.
+ * {@link module:engine/view/downcastwriter~ViewDowncastWriter view downcast writer} as parameters and returns a view attribute element.
  * If `config.model.values` is given, `config.view` should be an object assigning values from `config.model.values` to view element
  * definitions or functions.
  * @param config.converterPriority Converter priority.
@@ -1768,7 +1778,7 @@ function normalizeModelElementConfig(model) {
     };
 }
 /**
- * Takes `config.view`, and if it is an {@link module:engine/view/elementdefinition~ElementDefinition}, converts it
+ * Takes `config.view`, and if it is an {@link module:engine/view/elementdefinition~ViewElementDefinition}, converts it
  * to a function (because lower level converters accept only element creator functions).
  *
  * @param view View configuration.
@@ -1783,7 +1793,7 @@ function normalizeToElementConfig(view, viewElementType) {
     return ((modelData, conversionApi) => createViewElementFromDefinition(view, conversionApi, viewElementType));
 }
 /**
- * Creates a view element instance from the provided {@link module:engine/view/elementdefinition~ElementDefinition} and class.
+ * Creates a view element instance from the provided {@link module:engine/view/elementdefinition~ViewElementDefinition} and class.
  */
 function createViewElementFromDefinition(viewElementDefinition, conversionApi, viewElementType) {
     if (typeof viewElementDefinition == 'string') {
@@ -2033,7 +2043,7 @@ function validateSlotsChildren(element, slotsMap, conversionApi) {
          * Filters provided to `writer.createSlot()` overlap (at least two filters accept the same child element).
          *
          * @error conversion-slot-filter-overlap
-         * @param {module:engine/model/element~Element} element The element of which children would not be properly
+         * @param {module:engine/model/element~ModelElement} element The element of which children would not be properly
          * allocated to multiple slots.
          */
         throw new CKEditorError('conversion-slot-filter-overlap', conversionApi.dispatcher, { element });
@@ -2044,7 +2054,7 @@ function validateSlotsChildren(element, slotsMap, conversionApi) {
          * the children elements would not be assigned to any of the slots).
          *
          * @error conversion-slot-filter-incomplete
-         * @param {module:engine/model/element~Element} element The element of which children would not be properly
+         * @param {module:engine/model/element~ModelElement} element The element of which children would not be properly
          * allocated to multiple slots.
          */
         throw new CKEditorError('conversion-slot-filter-incomplete', conversionApi.dispatcher, { element });

package/src/conversion/mapper.d.ts

@@ -5,21 +5,21 @@
 /**
  * @module engine/conversion/mapper
  */
-import ModelPosition from '../model/position.js';
-import ModelRange from '../model/range.js';
-import ViewPosition from '../view/position.js';
-import ViewRange from '../view/range.js';
-import type ViewDocumentFragment from '../view/documentfragment.js';
-import type ViewElement from '../view/element.js';
-import type ModelElement from '../model/element.js';
-import type ModelDocumentFragment from '../model/documentfragment.js';
-import type { default as ViewNode } from '../view/node.js';
+import { ModelPosition } from '../model/position.js';
+import { ModelRange } from '../model/range.js';
+import { ViewPosition } from '../view/position.js';
+import { ViewRange } from '../view/range.js';
+import { type ViewDocumentFragment } from '../view/documentfragment.js';
+import { type ViewElement } from '../view/element.js';
+import { type ModelElement } from '../model/element.js';
+import { type ModelDocumentFragment } from '../model/documentfragment.js';
+import type { ViewNode } from '../view/node.js';
 declare const Mapper_base: {
     new (): import("@ckeditor/ckeditor5-utils").Emitter;
     prototype: import("@ckeditor/ckeditor5-utils").Emitter;
 };
 /**
- * Maps elements, positions and markers between the {@link module:engine/view/document~Document view} and
+ * Maps elements, positions and markers between the {@link module:engine/view/document~ViewDocument view} and
  * the {@link module:engine/model/model model}.
  *
  * The instance of the Mapper used for the editing pipeline is available in
@@ -37,7 +37,7 @@ declare const Mapper_base: {
  * with `'lowest'` priority. To override default `Mapper` mapping, add custom callback with higher priority and
  * stop the event.
  */
-export default class Mapper extends /* #__PURE__ */ Mapper_base {
+export declare class Mapper extends /* #__PURE__ */ Mapper_base {
     /**
      * Model element to view element mapping.
      */
@@ -54,7 +54,7 @@ export default class Mapper extends /* #__PURE__ */ Mapper_base {
     /**
      * Model marker name to view elements mapping.
      *
-     * Keys are `String`s while values are `Set`s with {@link module:engine/view/element~Element view elements}.
+     * Keys are `String`s while values are `Set`s with {@link module:engine/view/element~ViewElement view elements}.
      * One marker (name) can be mapped to multiple elements.
      */
     private _markerNameToElements;
@@ -92,7 +92,7 @@ export default class Mapper extends /* #__PURE__ */ Mapper_base {
      */
     bindElements(modelElement: ModelElement | ModelDocumentFragment, viewElement: ViewElement | ViewDocumentFragment): void;
     /**
-     * Unbinds the given {@link module:engine/view/element~Element view element} from the map.
+     * Unbinds the given {@link module:engine/view/element~ViewElement view element} from the map.
      *
      * **Note:** view-to-model binding will be removed, if it existed. However, corresponding model-to-view binding
      * will be removed only if model element is still bound to the passed `viewElement`.
@@ -109,7 +109,7 @@ export default class Mapper extends /* #__PURE__ */ Mapper_base {
         defer?: boolean;
     }): void;
     /**
-     * Unbinds the given {@link module:engine/model/element~Element model element} from the map.
+     * Unbinds the given {@link module:engine/model/element~ModelElement model element} from the map.
      *
      * **Note:** the model-to-view binding will be removed, if it existed. However, the corresponding view-to-model binding
      * will be removed only if the view element is still bound to the passed `modelElement`.
@@ -121,7 +121,7 @@ export default class Mapper extends /* #__PURE__ */ Mapper_base {
      */
     unbindModelElement(modelElement: ModelElement): void;
     /**
-     * Binds the given marker name with the given {@link module:engine/view/element~Element view element}. The element
+     * Binds the given marker name with the given {@link module:engine/view/element~ViewElement view element}. The element
      * will be added to the current set of elements bound with the given marker name.
      *
      * @param element Element to bind.
@@ -153,7 +153,7 @@ export default class Mapper extends /* #__PURE__ */ Mapper_base {
     /**
      * Gets the corresponding model element.
      *
-     * **Note:** {@link module:engine/view/uielement~UIElement} does not have corresponding element in model.
+     * **Note:** {@link module:engine/view/uielement~ViewUIElement} does not have corresponding element in model.
      *
      * @label ELEMENT
      * @param viewElement View element.
@@ -299,11 +299,11 @@ export default class Mapper extends /* #__PURE__ */ Mapper_base {
      * The length is calculated as follows:
      * * if a {@link #registerViewToModelLength length mapping callback} is provided for the given `viewNode`, it is used to
      * evaluate the model length (`viewNode` is used as first and only parameter passed to the callback),
-     * * length of a {@link module:engine/view/text~Text text node} is equal to the length of its
-     * {@link module:engine/view/text~Text#data data},
-     * * length of a {@link module:engine/view/uielement~UIElement ui element} is equal to 0,
-     * * length of a mapped {@link module:engine/view/element~Element element} is equal to 1,
-     * * length of a non-mapped {@link module:engine/view/element~Element element} is equal to the length of its children.
+     * * length of a {@link module:engine/view/text~ViewText text node} is equal to the length of its
+     * {@link module:engine/view/text~ViewText#data data},
+     * * length of a {@link module:engine/view/uielement~ViewUIElement ui element} is equal to 0,
+     * * length of a mapped {@link module:engine/view/element~ViewElement element} is equal to 1,
+     * * length of a non-mapped {@link module:engine/view/element~ViewElement element} is equal to the length of its children.
      *
      * Examples:
      *
@@ -553,8 +553,8 @@ export declare class MapperCache extends /* #__PURE__ */ MapperCache_base {
 }
 /**
  * Fired for each model-to-view position mapping request. The purpose of this event is to enable custom model-to-view position
- * mapping. Callbacks added to this event take {@link module:engine/model/position~Position model position} and are expected to
- * calculate the {@link module:engine/view/position~Position view position}. The calculated view position should be added as
+ * mapping. Callbacks added to this event take {@link module:engine/model/position~ModelPosition model position} and are expected to
+ * calculate the {@link module:engine/view/position~ViewPosition view position}. The calculated view position should be added as
  * a `viewPosition` value in the `data` object that is passed as one of parameters to the event callback.
  *
  * ```ts
@@ -624,7 +624,7 @@ export type MapperModelToViewPositionEvent = {
 };
 /**
  * Data pipeline object that can store and pass data between callbacks. The callback should add
- * the `viewPosition` value to that object with calculated the {@link module:engine/view/position~Position view position}.
+ * the `viewPosition` value to that object with calculated the {@link module:engine/view/position~ViewPosition view position}.
  */
 export type MapperModelToViewPositionEventData = {
     /**
@@ -637,7 +637,7 @@ export type MapperModelToViewPositionEventData = {
     modelPosition: ModelPosition;
     /**
      * The callback should add the `viewPosition` value to that object with calculated the
-     * {@link module:engine/view/position~Position view position}.
+     * {@link module:engine/view/position~ViewPosition view position}.
      */
     viewPosition?: ViewPosition;
     /**
@@ -683,7 +683,7 @@ export type MapperViewToModelPositionEvent = {
 };
 /**
  * Data pipeline object that can store and pass data between callbacks. The callback should add
- * `modelPosition` value to that object with calculated {@link module:engine/model/position~Position model position}.
+ * `modelPosition` value to that object with calculated {@link module:engine/model/position~ModelPosition model position}.
  */
 export type MapperViewToModelPositionEventData = {
     /**
@@ -692,7 +692,7 @@ export type MapperViewToModelPositionEventData = {
     mapper: Mapper;
     /**
      * The callback should add `modelPosition` value to that object with calculated
-     * {@link module:engine/model/position~Position model position}.
+     * {@link module:engine/model/position~ModelPosition model position}.
      */
     modelPosition?: ModelPosition;
     /**

package/src/conversion/mapper.js

@@ -5,13 +5,13 @@
 /**
  * @module engine/conversion/mapper
  */
-import ModelPosition from '../model/position.js';
-import ModelRange from '../model/range.js';
-import ViewPosition from '../view/position.js';
-import ViewRange from '../view/range.js';
+import { ModelPosition } from '../model/position.js';
+import { ModelRange } from '../model/range.js';
+import { ViewPosition } from '../view/position.js';
+import { ViewRange } from '../view/range.js';
 import { CKEditorError, EmitterMixin } from '@ckeditor/ckeditor5-utils';
 /**
- * Maps elements, positions and markers between the {@link module:engine/view/document~Document view} and
+ * Maps elements, positions and markers between the {@link module:engine/view/document~ViewDocument view} and
  * the {@link module:engine/model/model model}.
  *
  * The instance of the Mapper used for the editing pipeline is available in
@@ -29,7 +29,7 @@ import { CKEditorError, EmitterMixin } from '@ckeditor/ckeditor5-utils';
  * with `'lowest'` priority. To override default `Mapper` mapping, add custom callback with higher priority and
  * stop the event.
  */
-export default class Mapper extends /* #__PURE__ */ EmitterMixin() {
+export class Mapper extends /* #__PURE__ */ EmitterMixin() {
     /**
      * Model element to view element mapping.
      */
@@ -46,7 +46,7 @@ export default class Mapper extends /* #__PURE__ */ EmitterMixin() {
     /**
      * Model marker name to view elements mapping.
      *
-     * Keys are `String`s while values are `Set`s with {@link module:engine/view/element~Element view elements}.
+     * Keys are `String`s while values are `Set`s with {@link module:engine/view/element~ViewElement view elements}.
      * One marker (name) can be mapped to multiple elements.
      */
     _markerNameToElements = new Map();
@@ -118,7 +118,7 @@ export default class Mapper extends /* #__PURE__ */ EmitterMixin() {
         this._viewToModelMapping.set(viewElement, modelElement);
     }
     /**
-     * Unbinds the given {@link module:engine/view/element~Element view element} from the map.
+     * Unbinds the given {@link module:engine/view/element~ViewElement view element} from the map.
      *
      * **Note:** view-to-model binding will be removed, if it existed. However, corresponding model-to-view binding
      * will be removed only if model element is still bound to the passed `viewElement`.
@@ -153,7 +153,7 @@ export default class Mapper extends /* #__PURE__ */ EmitterMixin() {
         }
     }
     /**
-     * Unbinds the given {@link module:engine/model/element~Element model element} from the map.
+     * Unbinds the given {@link module:engine/model/element~ModelElement model element} from the map.
      *
      * **Note:** the model-to-view binding will be removed, if it existed. However, the corresponding view-to-model binding
      * will be removed only if the view element is still bound to the passed `modelElement`.
@@ -175,7 +175,7 @@ export default class Mapper extends /* #__PURE__ */ EmitterMixin() {
         }
     }
     /**
-     * Binds the given marker name with the given {@link module:engine/view/element~Element view element}. The element
+     * Binds the given marker name with the given {@link module:engine/view/element~ViewElement view element}. The element
      * will be added to the current set of elements bound with the given marker name.
      *
      * @param element Element to bind.
@@ -426,11 +426,11 @@ export default class Mapper extends /* #__PURE__ */ EmitterMixin() {
      * The length is calculated as follows:
      * * if a {@link #registerViewToModelLength length mapping callback} is provided for the given `viewNode`, it is used to
      * evaluate the model length (`viewNode` is used as first and only parameter passed to the callback),
-     * * length of a {@link module:engine/view/text~Text text node} is equal to the length of its
-     * {@link module:engine/view/text~Text#data data},
-     * * length of a {@link module:engine/view/uielement~UIElement ui element} is equal to 0,
-     * * length of a mapped {@link module:engine/view/element~Element element} is equal to 1,
-     * * length of a non-mapped {@link module:engine/view/element~Element element} is equal to the length of its children.
+     * * length of a {@link module:engine/view/text~ViewText text node} is equal to the length of its
+     * {@link module:engine/view/text~ViewText#data data},
+     * * length of a {@link module:engine/view/uielement~ViewUIElement ui element} is equal to 0,
+     * * length of a mapped {@link module:engine/view/element~ViewElement element} is equal to 1,
+     * * length of a non-mapped {@link module:engine/view/element~ViewElement element} is equal to the length of its children.
      *
      * Examples:
      *