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

package/src/model/model.d.ts

@@ -5,20 +5,20 @@
 /**
  * @module engine/model/model
  */
-import Batch, { type BatchType } from './batch.js';
-import Document from './document.js';
-import MarkerCollection from './markercollection.js';
-import ModelPosition, { type PositionOffset, type PositionStickiness } from './position.js';
-import ModelRange from './range.js';
-import ModelSelection, { type PlaceOrOffset, type Selectable } from './selection.js';
-import DocumentSelection from './documentselection.js';
-import Schema from './schema.js';
-import Writer from './writer.js';
-import Node from './node.js';
-import type ModelDocumentFragment from './documentfragment.js';
-import type Item from './item.js';
-import type ModelElement from './element.js';
-import type Operation from './operation/operation.js';
+import { Batch, type BatchType } from './batch.js';
+import { ModelDocument } from './document.js';
+import { MarkerCollection } from './markercollection.js';
+import { ModelPosition, type ModelPositionOffset, type ModelPositionStickiness } from './position.js';
+import { ModelRange } from './range.js';
+import { ModelSelection, type ModelPlaceOrOffset, type ModelSelectable } from './selection.js';
+import { ModelDocumentSelection } from './documentselection.js';
+import { ModelSchema } from './schema.js';
+import { ModelWriter } from './writer.js';
+import { ModelNode } from './node.js';
+import { type ModelDocumentFragment } from './documentfragment.js';
+import { type ModelItem } from './item.js';
+import { type ModelElement } from './element.js';
+import { type Operation } from './operation/operation.js';
 import { type DecoratedMethodEvent } from '@ckeditor/ckeditor5-utils';
 declare const Model_base: {
     new (): import("@ckeditor/ckeditor5-utils").Observable;
@@ -28,7 +28,7 @@ declare const Model_base: {
  * Editor's data model. Read about the model in the
  * {@glink framework/architecture/editing-engine engine architecture} guide.
  */
-export default class Model extends /* #__PURE__ */ Model_base {
+export declare class Model extends /* #__PURE__ */ Model_base {
     /**
      * Model's marker collection.
      */
@@ -36,11 +36,11 @@ export default class Model extends /* #__PURE__ */ Model_base {
     /**
      * Model's document.
      */
-    readonly document: Document;
+    readonly document: ModelDocument;
     /**
      * Model's schema.
      */
-    readonly schema: Schema;
+    readonly schema: ModelSchema;
     /**
      * All callbacks added by {@link module:engine/model/model~Model#change} or
      * {@link module:engine/model/model~Model#enqueueChange} methods waiting to be executed.
@@ -54,7 +54,7 @@ export default class Model extends /* #__PURE__ */ Model_base {
     /**
      * The `change()` method is the primary way of changing the model. You should use it to modify all document nodes
      * (including detached nodes – i.e. nodes not added to the {@link module:engine/model/model~Model#document model document}),
-     * the {@link module:engine/model/document~Document#selection document's selection}, and
+     * the {@link module:engine/model/document~ModelDocument#selection document's selection}, and
      * {@link module:engine/model/model~Model#markers model markers}.
      *
      * ```ts
@@ -92,7 +92,7 @@ export default class Model extends /* #__PURE__ */ Model_base {
      * @typeParam TReturn The return type of the provided callback.
      * @param callback Callback function which may modify the model.
      */
-    change<TReturn>(callback: (writer: Writer) => TReturn): TReturn;
+    change<TReturn>(callback: (writer: ModelWriter) => TReturn): TReturn;
     /**
      * The `enqueueChange()` method performs similar task as the {@link #change `change()` method}, with two major differences.
      *
@@ -122,7 +122,7 @@ export default class Model extends /* #__PURE__ */ Model_base {
      * @label DEFAULT_BATCH
      * @param callback Callback function which may modify the model.
      */
-    enqueueChange(callback: (writer: Writer) => unknown): void;
+    enqueueChange(callback: (writer: ModelWriter) => unknown): void;
     /**
      * The `enqueueChange()` method performs similar task as the {@link #change `change()` method}, with two major differences.
      *
@@ -164,20 +164,20 @@ export default class Model extends /* #__PURE__ */ Model_base {
      * ```
      *
      * In order to make a nested `enqueueChange()` create a single undo step together with the changes done in the outer `change()`
-     * block, you can obtain the batch instance from the  {@link module:engine/model/writer~Writer#batch writer} of the outer block.
+     * block, you can obtain the batch instance from the  {@link module:engine/model/writer~ModelWriter#batch writer} of the outer block.
      *
      * @label CUSTOM_BATCH
      * @param batchOrType A batch or a {@link module:engine/model/batch~Batch#constructor batch type} that should be used in the callback.
      * If not defined, a new batch with the default type will be created.
      * @param callback Callback function which may modify the model.
      */
-    enqueueChange(batchOrType: Batch | BatchType | undefined, callback: (writer: Writer) => unknown): void;
+    enqueueChange(batchOrType: Batch | BatchType | undefined, callback: (writer: ModelWriter) => unknown): void;
     /**
      * {@link module:utils/observablemixin~Observable#decorate Decorated} function for applying
      * {@link module:engine/model/operation/operation~Operation operations} to the model.
      *
      * This is a low-level way of changing the model. It is exposed for very specific use cases (like the undo feature).
-     * Normally, to modify the model, you will want to use {@link module:engine/model/writer~Writer `Writer`}.
+     * Normally, to modify the model, you will want to use {@link module:engine/model/writer~ModelWriter `Writer`}.
      * See also {@glink framework/architecture/editing-engine#changing-the-model Changing the model} section
      * of the {@glink framework/architecture/editing-engine Editing architecture} guide.
      *
@@ -197,9 +197,9 @@ export default class Model extends /* #__PURE__ */ Model_base {
      * It can split elements, merge them, wrap bare text nodes with paragraphs, etc. &ndash; just like the
      * pasting feature should do.
      *
-     * For lower-level methods see {@link module:engine/model/writer~Writer `Writer`}.
+     * For lower-level methods see {@link module:engine/model/writer~ModelWriter `Writer`}.
      *
-     * This method, unlike {@link module:engine/model/writer~Writer `Writer`}'s methods, does not have to be used
+     * This method, unlike {@link module:engine/model/writer~ModelWriter `Writer`}'s methods, does not have to be used
      * inside a {@link #change `change()` block}.
      *
      * # Conversion and schema
@@ -286,7 +286,7 @@ export default class Model extends /* #__PURE__ */ Model_base {
      * ```
      *
      * If you want the document selection to be moved to the inserted content, use the
-     * {@link module:engine/model/writer~Writer#setSelection `setSelection()`} method of the writer after inserting
+     * {@link module:engine/model/writer~ModelWriter#setSelection `setSelection()`} method of the writer after inserting
      * the content:
      *
      * ```ts
@@ -301,7 +301,7 @@ export default class Model extends /* #__PURE__ */ Model_base {
      * } );
      * ```
      *
-     * If an instance of the {@link module:engine/model/selection~Selection model selection} is passed as `selectable`,
+     * If an instance of the {@link module:engine/model/selection~ModelSelection model selection} is passed as `selectable`,
      * the new content will be inserted at the passed selection (instead of document selection):
      *
      * ```ts
@@ -326,7 +326,7 @@ export default class Model extends /* #__PURE__ */ Model_base {
      * This param defines a position in relation to that item.
      * at the insertion position.
      */
-    insertContent(content: Item | ModelDocumentFragment, selectable?: Selectable, placeOrOffset?: PlaceOrOffset, ...rest: Array<unknown>): ModelRange;
+    insertContent(content: ModelItem | ModelDocumentFragment, selectable?: ModelSelectable, placeOrOffset?: ModelPlaceOrOffset, ...rest: Array<unknown>): ModelRange;
     /**
      * Inserts an {@glink framework/deep-dive/schema#object-elements object element} at a specific position in the editor content.
      *
@@ -341,8 +341,8 @@ export default class Model extends /* #__PURE__ */ Model_base {
      * # Notes
      *
      * * If you want to insert a non-object content, see {@link #insertContent} instead.
-     * * For lower-level API, see {@link module:engine/model/writer~Writer `Writer`}.
-     * * Unlike {@link module:engine/model/writer~Writer `Writer`}, this method does not have to be used inside
+     * * For lower-level API, see {@link module:engine/model/writer~ModelWriter `Writer`}.
+     * * Unlike {@link module:engine/model/writer~ModelWriter `Writer`}, this method does not have to be used inside
      * a {@link #change `change()` block}.
      * * Inserting object into the model is not enough to make CKEditor 5 render that content to the user.
      * CKEditor 5 implements a model-view-controller architecture and what `model.insertObject()` does
@@ -393,7 +393,7 @@ export default class Model extends /* #__PURE__ */ Model_base {
      *
      * @param element An object to be inserted into the model document.
      * @param selectable A selectable where the content should be inserted. If not specified, the current
-     * {@link module:engine/model/document~Document#selection document selection} will be used instead.
+     * {@link module:engine/model/document~ModelDocument#selection document selection} will be used instead.
      * @param placeOrOffset Specifies the exact place or offset for the insertion to take place, relative to `selectable`.
      * @param options Additional options.
      * @param options.findOptimalPosition An option that, when set, adjusts the insertion position (relative to
@@ -404,13 +404,13 @@ export default class Model extends /* #__PURE__ */ Model_base {
      *
      * Note that this option only works for block objects. Inline objects are inserted into text and do not split blocks.
      * @param options.setSelection An option that, when set, moves the
-     * {@link module:engine/model/document~Document#selection document selection} after inserting the object.
+     * {@link module:engine/model/document~ModelDocument#selection document selection} after inserting the object.
      * * When `'on'`, the document selection will be set on the inserted object.
      * * When `'after'`, the document selection will move to the closest text node after the inserted object. If there is no
      * such text node, a paragraph will be created and the document selection will be moved inside it.
      * at the insertion position.
      */
-    insertObject(element: ModelElement, selectable?: Selectable, placeOrOffset?: PlaceOrOffset | null, options?: {
+    insertObject(element: ModelElement, selectable?: ModelSelectable, placeOrOffset?: ModelPlaceOrOffset | null, options?: {
         findOptimalPosition?: 'auto' | 'before' | 'after';
         setSelection?: 'on' | 'after';
     }, ...rest: Array<unknown>): ModelRange;
@@ -434,7 +434,7 @@ export default class Model extends /* #__PURE__ */ Model_base {
      * * `<heading1>x^y</heading1>` with the option disabled (`leaveUnmerged == false`)
      * * `<heading1>x^</heading1><paragraph>y</paragraph>` with enabled (`leaveUnmerged == true`).
      *
-     * Note: {@link module:engine/model/schema~Schema#isObject object} and {@link module:engine/model/schema~Schema#isLimit limit}
+     * Note: {@link module:engine/model/schema~ModelSchema#isObject object} and {@link module:engine/model/schema~ModelSchema#isLimit limit}
      * elements will not be merged.
      *
      * @param options.doNotResetEntireContent Whether to skip replacing the entire content with a
@@ -461,7 +461,7 @@ export default class Model extends /* #__PURE__ */ Model_base {
      * Deleting backward corresponds to using the <kbd>Backspace</kbd> key, while deleting content forward corresponds to
      * the <kbd>Shift</kbd>+<kbd>Backspace</kbd> keystroke.
      */
-    deleteContent(selection: ModelSelection | DocumentSelection, options?: {
+    deleteContent(selection: ModelSelection | ModelDocumentSelection, options?: {
         leaveUnmerged?: boolean;
         doNotResetEntireContent?: boolean;
         doNotAutoparagraph?: boolean;
@@ -496,7 +496,7 @@ export default class Model extends /* #__PURE__ */ Model_base {
      * @param options.unit The unit by which selection should be modified.
      * @param options.treatEmojiAsSingleUnit Whether multi-characer emoji sequences should be handled as single unit.
      */
-    modifySelection(selection: ModelSelection | DocumentSelection, options?: {
+    modifySelection(selection: ModelSelection | ModelDocumentSelection, options?: {
         direction?: 'forward' | 'backward';
         unit?: 'character' | 'codePoint' | 'word';
         treatEmojiAsSingleUnit?: boolean;
@@ -528,16 +528,16 @@ export default class Model extends /* #__PURE__ */ Model_base {
      * @fires getSelectedContent
      * @param selection The selection of which content will be returned.
      */
-    getSelectedContent(selection: ModelSelection | DocumentSelection): ModelDocumentFragment;
+    getSelectedContent(selection: ModelSelection | ModelDocumentSelection): ModelDocumentFragment;
     /**
-     * Checks whether the given {@link module:engine/model/range~Range range} or
-     * {@link module:engine/model/element~Element element} has any meaningful content.
+     * Checks whether the given {@link module:engine/model/range~ModelRange range} or
+     * {@link module:engine/model/element~ModelElement element} has any meaningful content.
      *
      * Meaningful content is:
      *
      * * any text node (`options.ignoreWhitespaces` allows controlling whether this text node must also contain
      * any non-whitespace characters),
-     * * or any {@link module:engine/model/schema~Schema#isContent content element},
+     * * or any {@link module:engine/model/schema~ModelSchema#isContent content element},
      * * or any {@link module:engine/model/markercollection~Marker marker} which
      * {@link module:engine/model/markercollection~Marker#_affectsData affects data}.
      *
@@ -562,29 +562,29 @@ export default class Model extends /* #__PURE__ */ Model_base {
      *
      * This method is decorated. Although this method accepts any parameter of `Selectable` type, the
      * {@link ~Model#event:canEditAt `canEditAt` event} is fired with `selectable` normalized to an instance of
-     * {@link module:engine/model/selection~Selection} or {@link module:engine/model/documentselection~DocumentSelection}
+     * {@link module:engine/model/selection~ModelSelection} or {@link module:engine/model/documentselection~ModelDocumentSelection}
      *
      * @fires canEditAt
      */
-    canEditAt(selectable: Selectable): boolean;
+    canEditAt(selectable: ModelSelectable): boolean;
     /**
      * Creates a position from the given root and path in that root.
      *
      * Note: This method is also available as
-     * {@link module:engine/model/writer~Writer#createPositionFromPath `Writer#createPositionFromPath()`}.
+     * {@link module:engine/model/writer~ModelWriter#createPositionFromPath `Writer#createPositionFromPath()`}.
      *
      * @param root Root of the position.
-     * @param path Position path. See {@link module:engine/model/position~Position#path}.
-     * @param stickiness Position stickiness. See {@link module:engine/model/position~PositionStickiness}.
+     * @param path Position path. See {@link module:engine/model/position~ModelPosition#path}.
+     * @param stickiness Position stickiness. See {@link module:engine/model/position~ModelPositionStickiness}.
      */
-    createPositionFromPath(root: ModelElement | ModelDocumentFragment, path: ReadonlyArray<number>, stickiness?: PositionStickiness): ModelPosition;
+    createPositionFromPath(root: ModelElement | ModelDocumentFragment, path: ReadonlyArray<number>, stickiness?: ModelPositionStickiness): ModelPosition;
     /**
      * Creates position at the given location. The location can be specified as:
      *
-     * * a {@link module:engine/model/position~Position position},
+     * * a {@link module:engine/model/position~ModelPosition position},
      * * a parent element and offset in that element,
      * * a parent element and `'end'` (the position will be set at the end of that element),
-     * * a {@link module:engine/model/item~Item model item} and `'before'` or `'after'`
+     * * a {@link module:engine/model/item~ModelItem model item} and `'before'` or `'after'`
      * (the position will be set before or after the given model item).
      *
      * This method is a shortcut to other factory methods such as:
@@ -593,35 +593,35 @@ export default class Model extends /* #__PURE__ */ Model_base {
      * * {@link module:engine/model/model~Model#createPositionAfter `createPositionAfter()`}.
      *
      * Note: This method is also available as
-     * {@link module:engine/model/writer~Writer#createPositionAt `Writer#createPositionAt()`},
+     * {@link module:engine/model/writer~ModelWriter#createPositionAt `Writer#createPositionAt()`},
      *
      * @param itemOrPosition
-     * @param offset Offset or one of the flags. Used only when first parameter is a {@link module:engine/model/item~Item model item}.
+     * @param offset Offset or one of the flags. Used only when first parameter is a {@link module:engine/model/item~ModelItem model item}.
      */
-    createPositionAt(itemOrPosition: Item | ModelPosition | ModelDocumentFragment, offset?: PositionOffset): ModelPosition;
+    createPositionAt(itemOrPosition: ModelItem | ModelPosition | ModelDocumentFragment, offset?: ModelPositionOffset): ModelPosition;
     /**
-     * Creates a new position after the given {@link module:engine/model/item~Item model item}.
+     * Creates a new position after the given {@link module:engine/model/item~ModelItem model item}.
      *
      * Note: This method is also available as
-     * {@link module:engine/model/writer~Writer#createPositionAfter `Writer#createPositionAfter()`}.
+     * {@link module:engine/model/writer~ModelWriter#createPositionAfter `Writer#createPositionAfter()`}.
      *
      * @param item Item after which the position should be placed.
      */
-    createPositionAfter(item: Item): ModelPosition;
+    createPositionAfter(item: ModelItem): ModelPosition;
     /**
-     * Creates a new position before the given {@link module:engine/model/item~Item model item}.
+     * Creates a new position before the given {@link module:engine/model/item~ModelItem model item}.
      *
      * Note: This method is also available as
-     * {@link module:engine/model/writer~Writer#createPositionBefore `Writer#createPositionBefore()`}.
+     * {@link module:engine/model/writer~ModelWriter#createPositionBefore `Writer#createPositionBefore()`}.
      *
      * @param item Item before which the position should be placed.
      */
-    createPositionBefore(item: Item): ModelPosition;
+    createPositionBefore(item: ModelItem): ModelPosition;
     /**
      * Creates a range spanning from the `start` position to the `end` position.
      *
      * Note: This method is also available as
-     * {@link module:engine/model/writer~Writer#createRange `Writer#createRange()`}:
+     * {@link module:engine/model/writer~ModelWriter#createRange `Writer#createRange()`}:
      *
      * ```ts
      * model.change( writer => {
@@ -638,7 +638,7 @@ export default class Model extends /* #__PURE__ */ Model_base {
      * that element and ends after the last child of that element.
      *
      * Note: This method is also available as
-     * {@link module:engine/model/writer~Writer#createRangeIn `Writer#createRangeIn()`}:
+     * {@link module:engine/model/writer~ModelWriter#createRangeIn `Writer#createRangeIn()`}:
      *
      * ```ts
      * model.change( writer => {
@@ -650,10 +650,10 @@ export default class Model extends /* #__PURE__ */ Model_base {
      */
     createRangeIn(element: ModelElement | ModelDocumentFragment): ModelRange;
     /**
-     * Creates a range that starts before the given {@link module:engine/model/item~Item model item} and ends after it.
+     * Creates a range that starts before the given {@link module:engine/model/item~ModelItem model item} and ends after it.
      *
      * Note: This method is also available on `writer` instance as
-     * {@link module:engine/model/writer~Writer#createRangeOn `Writer.createRangeOn()`}:
+     * {@link module:engine/model/writer~ModelWriter#createRangeOn `Writer.createRangeOn()`}:
      *
      * ```ts
      * model.change( writer => {
@@ -663,24 +663,24 @@ export default class Model extends /* #__PURE__ */ Model_base {
      *
      * @param item
      */
-    createRangeOn(item: Item): ModelRange;
+    createRangeOn(item: ModelItem): ModelRange;
     /**
-     * Creates a new selection instance based on the given {@link module:engine/model/selection~Selectable selectable}
+     * Creates a new selection instance based on the given {@link module:engine/model/selection~ModelSelectable selectable}
      * or creates an empty selection if no arguments were passed.
      *
      * Note: This method is also available as
-     * {@link module:engine/model/writer~Writer#createSelection `Writer#createSelection()`}.
+     * {@link module:engine/model/writer~ModelWriter#createSelection `Writer#createSelection()`}.
      *
      * ```ts
      * // Creates selection at the given offset in the given element.
      * const paragraph = writer.createElement( 'paragraph' );
      * const selection = writer.createSelection( paragraph, offset );
      *
-     * // Creates a range inside an {@link module:engine/model/element~Element element} which starts before the
+     * // Creates a range inside an {@link module:engine/model/element~ModelElement element} which starts before the
      * // first child of that element and ends after the last child of that element.
      * const selection = writer.createSelection( paragraph, 'in' );
      *
-     * // Creates a range on an {@link module:engine/model/item~Item item} which starts before the item and ends
+     * // Creates a range on an {@link module:engine/model/item~ModelItem item} which starts before the item and ends
      * // just after the item.
      * const selection = writer.createSelection( paragraph, 'on' );
      *
@@ -694,15 +694,15 @@ export default class Model extends /* #__PURE__ */ Model_base {
      *
      * @label NODE_OFFSET
      */
-    createSelection(selectable: Node, placeOrOffset: PlaceOrOffset, options?: {
+    createSelection(selectable: ModelNode, placeOrOffset: ModelPlaceOrOffset, options?: {
         backward?: boolean;
     }): ModelSelection;
     /**
-     * Creates a new selection instance based on the given {@link module:engine/model/selection~Selectable selectable}
+     * Creates a new selection instance based on the given {@link module:engine/model/selection~ModelSelectable selectable}
      * or creates an empty selection if no arguments were passed.
      *
      * Note: This method is also available as
-     * {@link module:engine/model/writer~Writer#createSelection `Writer#createSelection()`}.
+     * {@link module:engine/model/writer~ModelWriter#createSelection `Writer#createSelection()`}.
      *
      * ```ts
      * // Creates empty selection without ranges.
@@ -740,7 +740,7 @@ export default class Model extends /* #__PURE__ */ Model_base {
      *
      * @label SELECTABLE
      */
-    createSelection(selectable?: Exclude<Selectable, Node>, options?: {
+    createSelection(selectable?: Exclude<ModelSelectable, ModelNode>, options?: {
         backward?: boolean;
     }): ModelSelection;
     /**
@@ -763,7 +763,7 @@ export default class Model extends /* #__PURE__ */ Model_base {
      */
     createOperationFromJSON(json: unknown): Operation;
     /**
-     * Removes all events listeners set by model instance and destroys {@link module:engine/model/document~Document}.
+     * Removes all events listeners set by model instance and destroys {@link module:engine/model/document~ModelDocument}.
      */
     destroy(): void;
     /**
@@ -799,15 +799,15 @@ export type AfterChangesEvent = {
  * using {@link ~Model#applyOperation}.
  *
  * Note that this event is suitable only for very specific use-cases. Use it if you need to listen to every single operation
- * applied on the document. However, in most cases {@link module:engine/model/document~Document#event:change} should
+ * applied on the document. However, in most cases {@link module:engine/model/document~ModelDocument#event:change} should
  * be used.
  *
  * A few callbacks are already added to this event by engine internal classes:
  *
  * * with `highest` priority operation is validated,
  * * with `normal` priority operation is executed,
- * * with `low` priority the {@link module:engine/model/document~Document} updates its version,
- * * with `low` priority {@link module:engine/model/liveposition~LivePosition} and {@link module:engine/model/liverange~LiveRange}
+ * * with `low` priority the {@link module:engine/model/document~ModelDocument} updates its version,
+ * * with `low` priority {@link module:engine/model/liveposition~ModelLivePosition} and {@link module:engine/model/liverange~ModelLiveRange}
  * update themselves.
  *
  * @eventName ~Model#applyOperation
@@ -822,7 +822,7 @@ export type ModelApplyOperationEvent = DecoratedMethodEvent<Model, 'applyOperati
  * listener to this event so it can be fully customized by the features.
  *
  * **Note** The `selectable` parameter for the {@link ~Model#insertContent} is optional. When `undefined` value is passed the method uses
- * {@link module:engine/model/document~Document#selection document selection}.
+ * {@link module:engine/model/document~ModelDocument#selection document selection}.
  *
  * @eventName ~Model#insertContent
  * @param args The arguments passed to the original method.
@@ -831,8 +831,8 @@ export type ModelInsertContentEvent = {
     name: 'insertContent';
     args: [
         [
-            content: Item | ModelDocumentFragment,
-            selectable?: ModelSelection | DocumentSelection,
+            content: ModelItem | ModelDocumentFragment,
+            selectable?: ModelSelection | ModelDocumentSelection,
             ...rest: Array<unknown>
         ]
     ];
@@ -845,7 +845,7 @@ export type ModelInsertContentEvent = {
  * listener to this event so it can be fully customized by the features.
  *
  * **Note** The `selectable` parameter for the {@link ~Model#insertObject} is optional. When `undefined` value is passed the method uses
- * {@link module:engine/model/document~Document#selection document selection}.
+ * {@link module:engine/model/document~ModelDocument#selection document selection}.
  *
  * @eventName ~Model#insertObject
  * @param args The arguments passed to the original method.
@@ -855,7 +855,7 @@ export type ModelInsertObjectEvent = {
     args: [
         [
             element: ModelElement,
-            selectable?: ModelSelection | DocumentSelection | null,
+            selectable?: ModelSelection | ModelDocumentSelection | null,
             options?: {
                 findOptimalPosition?: 'auto' | 'before' | 'after';
                 setSelection?: 'on' | 'after';
@@ -902,7 +902,8 @@ export type ModelGetSelectedContentEvent = DecoratedMethodEvent<Model, 'getSelec
  * listener to this event, so it can be fully customized by the features.
  *
  * Although the original method accepts any parameter of `Selectable` type, this event is fired with `selectable` normalized
- * to an instance of {@link module:engine/model/selection~Selection} or {@link module:engine/model/documentselection~DocumentSelection}.
+ * to an instance of {@link module:engine/model/selection~ModelSelection} or
+ * {@link module:engine/model/documentselection~ModelDocumentSelection}.
  *
  * @eventName ~Model#canEditAt
  * @param args The arguments passed to the original method.
@@ -911,7 +912,7 @@ export type ModelCanEditAtEvent = {
     name: 'canEditAt';
     args: [
         [
-            selectable?: ModelSelection | DocumentSelection
+            selectable?: ModelSelection | ModelDocumentSelection
         ]
     ];
     return: boolean;