@ckeditor/ckeditor5-engine 37.0.0-alpha.0 → 37.0.0-alpha.1

package/src/index.d.ts

@@ -15,10 +15,13 @@ export type { AddHighlightCallback, AttributeDescriptor, ElementCreatorFunction,
 export type { default as Mapper, MapperModelToViewPositionEvent, MapperViewToModelPositionEvent } from './conversion/mapper';
 export type { default as ModelConsumable } from './conversion/modelconsumable';
 export type { Consumables, default as ViewConsumable } from './conversion/viewconsumable';
-export { default as DataProcessor } from './dataprocessor/dataprocessor';
+export type { default as DataProcessor } from './dataprocessor/dataprocessor';
 export { default as HtmlDataProcessor } from './dataprocessor/htmldataprocessor';
 export type { default as Operation } from './model/operation/operation';
 export { default as InsertOperation } from './model/operation/insertoperation';
+export { default as MoveOperation } from './model/operation/moveoperation';
+export { default as MergeOperation } from './model/operation/mergeoperation';
+export { default as SplitOperation } from './model/operation/splitoperation';
 export { default as MarkerOperation } from './model/operation/markeroperation';
 export { default as OperationFactory } from './model/operation/operationfactory';
 export type { default as AttributeOperation } from './model/operation/attributeoperation';
@@ -58,7 +61,7 @@ export { default as Renderer } from './view/renderer';
 export { default as View } from './view/view';
 export { default as ViewDocument } from './view/document';
 export { default as ViewText } from './view/text';
-export { default as ViewElement, ElementAttributes as ViewElementAttributes } from './view/element';
+export { default as ViewElement, type ElementAttributes as ViewElementAttributes } from './view/element';
 export { default as ViewContainerElement } from './view/containerelement';
 export { default as ViewEditableElement } from './view/editableelement';
 export { default as ViewAttributeElement } from './view/attributeelement';
@@ -97,7 +100,7 @@ export type { ViewDocumentTabEvent } from './view/observer/tabobserver';
 export type { ViewDocumentClickEvent } from './view/observer/clickobserver';
 export type { ViewDocumentSelectionChangeEvent } from './view/observer/selectionobserver';
 export type { ViewRenderEvent } from './view/view';
-export { StylesProcessor, BoxSides } from './view/stylesmap';
+export { StylesProcessor, type BoxSides } from './view/stylesmap';
 export * from './view/styles/background';
 export * from './view/styles/border';
 export * from './view/styles/margin';

package/src/index.js

@@ -13,6 +13,9 @@ export { default as DataController } from './controller/datacontroller';
 export { default as Conversion } from './conversion/conversion';
 export { default as HtmlDataProcessor } from './dataprocessor/htmldataprocessor';
 export { default as InsertOperation } from './model/operation/insertoperation';
+export { default as MoveOperation } from './model/operation/moveoperation';
+export { default as MergeOperation } from './model/operation/mergeoperation';
+export { default as SplitOperation } from './model/operation/splitoperation';
 export { default as MarkerOperation } from './model/operation/markeroperation';
 export { default as OperationFactory } from './model/operation/operationfactory';
 export { transformSets } from './model/operation/transform';

package/src/model/document.d.ts

@@ -231,7 +231,8 @@ export default class Document extends Document_base {
  * } );
  * ```
  *
- * @eventName change
+ * @eventName ~Document#change
+ * @eventName ~Document#change:data
  * @param batch The batch that was used in the executed changes block.
  */
 export type DocumentChangeEvent = {

package/src/model/documentselection.d.ts

@@ -353,7 +353,7 @@ export default class DocumentSelection extends DocumentSelection_base {
 /**
  * Fired when selection range(s) changed.
  *
- * @eventName change:range
+ * @eventName ~DocumentSelection#change:range
  * @param directChange In case of {@link module:engine/model/selection~Selection} class it is always set
  * to `true` which indicates that the selection change was caused by a direct use of selection's API.
  * The {@link module:engine/model/documentselection~DocumentSelection}, however, may change because its position
@@ -366,7 +366,7 @@ export type DocumentSelectionChangeRangeEvent = SelectionChangeRangeEvent;
 /**
  * Fired when selection attribute changed.
  *
- * @eventName change:attribute
+ * @eventName ~DocumentSelection#change:attribute
  * @param directChange In case of {@link module:engine/model/selection~Selection} class it is always set
  * to `true` which indicates that the selection change was caused by a direct use of selection's API.
  * The {@link module:engine/model/documentselection~DocumentSelection}, however, may change because its attributes
@@ -380,7 +380,7 @@ export type DocumentSelectionChangeAttributeEvent = SelectionChangeAttributeEven
 /**
  * Fired when selection marker(s) changed.
  *
- * @eventName change:marker
+ * @eventName ~DocumentSelection#change:marker
  * @param directChange This is always set to `false` in case of `change:marker` event as there is no possibility
  * to change markers directly through {@link module:engine/model/documentselection~DocumentSelection} API.
  * See also {@link module:engine/model/documentselection~DocumentSelection#event:change:range} and
@@ -399,7 +399,7 @@ export type DocumentSelectionChangeMarkerEvent = {
 /**
  * Fired when selection range(s), attribute(s) or marker(s) changed.
  *
- * @eventName change
+ * @eventName ~DocumentSelection#change
  * @param directChange This is always set to `false` in case of `change:marker` event as there is no possibility
  * to change markers directly through {@link module:engine/model/documentselection~DocumentSelection} API.
  * See also {@link module:engine/model/documentselection~DocumentSelection#event:change:range} and

package/src/model/liveposition.d.ts

@@ -67,7 +67,7 @@ export default class LivePosition extends LivePosition_base {
 /**
  * Fired when `LivePosition` instance is changed due to changes on {@link module:engine/model/document~Document}.
  *
- * @eventName change
+ * @eventName ~LivePosition#change
  * @param oldPosition Position equal to this live position before it got changed.
  */
 export type LivePositionChangeEvent = {

package/src/model/liverange.d.ts

@@ -60,7 +60,7 @@ export default class LiveRange extends LiveRange_base {
  * Fired when `LiveRange` instance boundaries have changed due to changes in the
  * {@link module:engine/model/document~Document document}.
  *
- * @eventName change:range
+ * @eventName ~LiveRange#change:range
  * @param oldRange Range with start and end position equal to start and end position of this live
  * range before it got changed.
  * @param data Object with additional information about the change.
@@ -77,7 +77,7 @@ export type LiveRangeChangeRangeEvent = {
  * Fired when `LiveRange` instance boundaries have not changed after a change in {@link module:engine/model/document~Document document}
  * but the change took place inside the range, effectively changing its content.
  *
- * @eventName change:content
+ * @eventName ~LiveRange#change:content
  * @param range Range with start and end position equal to start and end position of
  * change range.
  * @param data Object with additional information about the change.

package/src/model/markercollection.d.ts

@@ -294,9 +294,9 @@ export type { Marker };
  * {@link module:engine/model/markercollection~MarkerCollection#event:update MarkerCollection update event}.
  *
  * @see module:engine/model/liverange~LiveRange#event:change:range
- * @eventName change:range
+ * @eventName ~Marker#change:range
  */
-export type MarkerCollectionChangeRangeEvent = LiveRangeChangeRangeEvent;
+export type MarkerChangeRangeEvent = LiveRangeChangeRangeEvent;
 /**
  * Fired whenever change on {@link module:engine/model/document~Document} is done inside {@link ~Marker#_liveRange marker range}.
  * This is a delegated {@link module:engine/model/liverange~LiveRange#event:change:content LiveRange change:content event}.
@@ -306,17 +306,17 @@ export type MarkerCollectionChangeRangeEvent = LiveRangeChangeRangeEvent;
  * {@link module:engine/model/markercollection~MarkerCollection#event:update MarkerCollection update event}.
  *
  * @see module:engine/model/liverange~LiveRange#event:change:content
- * @eventName change:content
+ * @eventName ~Marker#change:content
  */
 export type MarkerCollectionChangeContentEvent = LiveRangeChangeContentEvent;
 /**
  * Describes `change:range` or `change:content` event.
  */
-export type MarkerCollectionChangeEvent = LiveRangeChangeEvent;
+export type MarkerChangeEvent = LiveRangeChangeEvent;
 /**
  * Fired whenever marker is added, updated or removed from `MarkerCollection`.
  *
- * @eventName update
+ * @eventName ~MarkerCollection#update
  * @param marker Updated Marker.
  * @param oldRange Marker range before the update. When is not defined it
  * means that marker is just added.

package/src/model/model.d.ts

@@ -117,10 +117,9 @@ export default class Model extends Model_base {
      *
      * By default, a new batch with the default {@link module:engine/model/batch~Batch#constructor batch type} is created.
      * To define the {@link module:engine/model/batch~Batch} into which you want to add your changes,
-     * use {@link #enqueueChange#CUSTOM_BATCH}.
+     * use {@link #enqueueChange:CUSTOM_BATCH `enqueueChange( batchOrType, callback )`}.
      *
      * @label DEFAULT_BATCH
-     * If not defined, a new batch with the default type will be created.
      * @param callback Callback function which may modify the model.
      */
     enqueueChange(callback: (writer: Writer) => unknown): void;
@@ -147,7 +146,8 @@ export default class Model extends Model_base {
      * done in the outer `change()` block.
      *
      * Second, it lets you define the {@link module:engine/model/batch~Batch} into which you want to add your changes.
-     * If you want to use default {@link module:engine/model/batch~Batch#constructor batch type}, use {@link #enqueueChange#DEFAULT_BATCH}.
+     * If you want to use default {@link module:engine/model/batch~Batch#constructor batch type}, use
+     * {@link #enqueueChange:DEFAULT_BATCH `enqueueChange( callback )`}.
      *
      * ```ts
      * model.enqueueChange( { isUndoable: false }, writer => {
@@ -650,9 +650,82 @@ export default class Model extends Model_base {
      * @param item
      */
     createRangeOn(item: Item): ModelRange;
+    /**
+     * Creates a new selection instance based on the given {@link module:engine/model/selection~Selectable 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()`}.
+     *
+     * ```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
+     * // 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
+     * // just after the item.
+     * const selection = writer.createSelection( paragraph, 'on' );
+     *
+     * // Additional options (`'backward'`) can be specified as the last argument.
+     *
+     * // Creates backward selection.
+     * const selection = writer.createSelection( element, 'in', { backward: true } );
+     * ```
+     *
+     * See also: {@link #createSelection:SELECTABLE `createSelection( selectable, options )`}.
+     *
+     * @label NODE_OFFSET
+     */
     createSelection(selectable: Node, placeOrOffset: PlaceOrOffset, options?: {
         backward?: boolean;
     }): ModelSelection;
+    /**
+     * Creates a new selection instance based on the given {@link module:engine/model/selection~Selectable 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()`}.
+     *
+     * ```ts
+     * // Creates empty selection without ranges.
+     * const selection = writer.createSelection();
+     *
+     * // Creates selection at the given range.
+     * const range = writer.createRange( start, end );
+     * const selection = writer.createSelection( range );
+     *
+     * // Creates selection at the given ranges
+     * const ranges = [ writer.createRange( start1, end2 ), writer.createRange( star2, end2 ) ];
+     * const selection = writer.createSelection( ranges );
+     *
+     * // Creates selection from the other selection.
+     * // Note: It doesn't copies selection attributes.
+     * const otherSelection = writer.createSelection();
+     * const selection = writer.createSelection( otherSelection );
+     *
+     * // Creates selection from the given document selection.
+     * // Note: It doesn't copies selection attributes.
+     * const documentSelection = model.document.selection;
+     * const selection = writer.createSelection( documentSelection );
+     *
+     * // Creates selection at the given position.
+     * const position = writer.createPositionFromPath( root, path );
+     * const selection = writer.createSelection( position );
+     *
+     * // Additional options (`'backward'`) can be specified as the last argument.
+     *
+     * // Creates backward selection.
+     * const selection = writer.createSelection( range, { backward: true } );
+     * ```
+     *
+     * See also: {@link #createSelection:NODE_OFFSET `createSelection( node, placeOrOffset, options )`}.
+     *
+     * @label SELECTABLE
+     */
     createSelection(selectable?: Exclude<Selectable, Node>, options?: {
         backward?: boolean;
     }): ModelSelection;
@@ -691,7 +764,7 @@ export default class Model extends Model_base {
  * {@link module:engine/model/model~Model#change} block.
  *
  * @internal
- * @eventName _beforeChanges
+ * @eventName ~Model#_beforeChanges
  */
 export type BeforeChangesEvent = {
     name: '_beforeChanges';
@@ -702,7 +775,7 @@ export type BeforeChangesEvent = {
  * {@link module:engine/model/model~Model#change} block.
  *
  * @internal
- * @eventName _afterChanges
+ * @eventName ~Model#_afterChanges
  */
 export type AfterChangesEvent = {
     name: '_afterChanges';
@@ -710,7 +783,7 @@ export type AfterChangesEvent = {
 };
 /**
  * Fired every time any {@link module:engine/model/operation/operation~Operation operation} is applied on the model
- * using {@link #applyOperation}.
+ * 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
@@ -724,21 +797,21 @@ export type AfterChangesEvent = {
  * * with `low` priority {@link module:engine/model/liveposition~LivePosition} and {@link module:engine/model/liverange~LiveRange}
  * update themselves.
  *
- * @eventName applyOperation
+ * @eventName ~Model#applyOperation
  * @param args Arguments of the `applyOperation` which is an array with a single element - applied
  * {@link module:engine/model/operation/operation~Operation operation}.
  */
 export type ModelApplyOperationEvent = DecoratedMethodEvent<Model, 'applyOperation'>;
 /**
- * Event fired when {@link #insertContent} method is called.
+ * Event fired when {@link ~Model#insertContent} method is called.
  *
- * The {@link #insertContent default action of that method} is implemented as a
+ * The {@link ~Model#insertContent default action of that method} is implemented as a
  * listener to this event so it can be fully customized by the features.
  *
- * **Note** The `selectable` parameter for the {@link #insertContent} is optional. When `undefined` value is passed the method uses
+ * **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}.
  *
- * @eventName insertContent
+ * @eventName ~Model#insertContent
  * @param args The arguments passed to the original method.
  */
 export type ModelInsertContentEvent = {
@@ -753,15 +826,15 @@ export type ModelInsertContentEvent = {
     return: ModelRange;
 };
 /**
- * Event fired when the {@link #insertObject} method is called.
+ * Event fired when the {@link ~Model#insertObject} method is called.
  *
- * The {@link #insertObject default action of that method} is implemented as a
+ * The {@link ~Model#insertObject default action of that method} is implemented as a
  * listener to this event so it can be fully customized by the features.
  *
- * **Note** The `selectable` parameter for the {@link #insertObject} is optional. When `undefined` value is passed the method uses
+ * **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}.
  *
- * @eventName insertObject
+ * @eventName ~Model#insertObject
  * @param args The arguments passed to the original method.
  */
 export type ModelInsertObjectEvent = {
@@ -780,32 +853,32 @@ export type ModelInsertObjectEvent = {
     return: ModelRange;
 };
 /**
- * Event fired when {@link #deleteContent} method is called.
+ * Event fired when {@link ~Model#deleteContent} method is called.
  *
- * The {@link #deleteContent default action of that method} is implemented as a
+ * The {@link ~Model#deleteContent default action of that method} is implemented as a
  * listener to this event so it can be fully customized by the features.
  *
- * @eventName deleteContent
+ * @eventName ~Model#deleteContent
  * @param args The arguments passed to the original method.
  */
 export type ModelDeleteContentEvent = DecoratedMethodEvent<Model, 'deleteContent'>;
 /**
- * Event fired when {@link #modifySelection} method is called.
+ * Event fired when {@link ~Model#modifySelection} method is called.
  *
- * The {@link #modifySelection default action of that method} is implemented as a
+ * The {@link ~Model#modifySelection default action of that method} is implemented as a
  * listener to this event so it can be fully customized by the features.
  *
- * @eventName modifySelection
+ * @eventName ~Model#modifySelection
  * @param args The arguments passed to the original method.
  */
 export type ModelModifySelectionEvent = DecoratedMethodEvent<Model, 'modifySelection'>;
 /**
- * Event fired when {@link #getSelectedContent} method is called.
+ * Event fired when {@link ~Model#getSelectedContent} method is called.
  *
- * The {@link #getSelectedContent default action of that method} is implemented as a
+ * The {@link ~Model#getSelectedContent default action of that method} is implemented as a
  * listener to this event so it can be fully customized by the features.
  *
- * @eventName getSelectedContent
+ * @eventName ~Model#getSelectedContent
  * @param args The arguments passed to the original method.
  */
 export type ModelGetSelectedContentEvent = DecoratedMethodEvent<Model, 'getSelectedContent'>;

package/src/model/model.js

@@ -730,57 +730,6 @@ export default class Model extends ObservableMixin() {
     createRangeOn(item) {
         return ModelRange._createOn(item);
     }
-    /**
-     * Creates a new selection instance based on the given {@link module:engine/model/selection~Selectable 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()`}.
-     *
-     * ```ts
-     * // Creates empty selection without ranges.
-     * const selection = writer.createSelection();
-     *
-     * // Creates selection at the given range.
-     * const range = writer.createRange( start, end );
-     * const selection = writer.createSelection( range );
-     *
-     * // Creates selection at the given ranges
-     * const ranges = [ writer.createRange( start1, end2 ), writer.createRange( star2, end2 ) ];
-     * const selection = writer.createSelection( ranges );
-     *
-     * // Creates selection from the other selection.
-     * // Note: It doesn't copies selection attributes.
-     * const otherSelection = writer.createSelection();
-     * const selection = writer.createSelection( otherSelection );
-     *
-     * // Creates selection from the given document selection.
-     * // Note: It doesn't copies selection attributes.
-     * const documentSelection = model.document.selection;
-     * const selection = writer.createSelection( documentSelection );
-     *
-     * // Creates selection at the given position.
-     * const position = writer.createPositionFromPath( root, path );
-     * const selection = writer.createSelection( position );
-     *
-     * // 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
-     * // 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
-     * // just after the item.
-     * const selection = writer.createSelection( paragraph, 'on' );
-     *
-     * // Additional options (`'backward'`) can be specified as the last argument.
-     *
-     * // Creates backward selection.
-     * const selection = writer.createSelection( range, { backward: true } );
-     * ```
-     */
     createSelection(...args) {
         return new ModelSelection(...args);
     }

package/src/model/operation/mergeoperation.d.ts

@@ -19,7 +19,7 @@ import type Document from '../document';
  */
 export default class MergeOperation extends Operation {
     /**
-     * Position inside the merged element. All nodes from that element after that position will be moved to {@link ~#targetPosition}.
+     * Position inside the merged element. All nodes from that element after that position will be moved to {@link #targetPosition}.
      */
     sourcePosition: Position;
     /**
@@ -38,7 +38,7 @@ export default class MergeOperation extends Operation {
      * Creates a merge operation.
      *
      * @param sourcePosition Position inside the merged element. All nodes from that
-     * element after that position will be moved to {@link ~#targetPosition}.
+     * element after that position will be moved to {@link #targetPosition}.
      * @param howMany Summary offset size of nodes which will be moved from the merged element to the new parent.
      * @param targetPosition Position which the nodes from the merged elements will be moved to.
      * @param graveyardPosition Position in graveyard to which the merged element will be moved.

package/src/model/operation/mergeoperation.js

@@ -24,7 +24,7 @@ export default class MergeOperation extends Operation {
      * Creates a merge operation.
      *
      * @param sourcePosition Position inside the merged element. All nodes from that
-     * element after that position will be moved to {@link ~#targetPosition}.
+     * element after that position will be moved to {@link #targetPosition}.
      * @param howMany Summary offset size of nodes which will be moved from the merged element to the new parent.
      * @param targetPosition Position which the nodes from the merged elements will be moved to.
      * @param graveyardPosition Position in graveyard to which the merged element will be moved.

package/src/model/operation/splitoperation.d.ts

@@ -58,7 +58,7 @@ export default class SplitOperation extends Operation {
     get moveTargetPosition(): Position;
     /**
      * Artificial range that contains all the nodes from the split element that will be moved to the new element.
-     * The range starts at {@link ~#splitPosition} and ends in the same parent, at `POSITIVE_INFINITY` offset.
+     * The range starts at {@link #splitPosition} and ends in the same parent, at `POSITIVE_INFINITY` offset.
      */
     get movedRange(): Range;
     /**

package/src/model/operation/splitoperation.js

@@ -59,7 +59,7 @@ export default class SplitOperation extends Operation {
     }
     /**
      * Artificial range that contains all the nodes from the split element that will be moved to the new element.
-     * The range starts at {@link ~#splitPosition} and ends in the same parent, at `POSITIVE_INFINITY` offset.
+     * The range starts at {@link #splitPosition} and ends in the same parent, at `POSITIVE_INFINITY` offset.
      */
     get movedRange() {
         const end = this.splitPosition.getShiftedBy(Number.POSITIVE_INFINITY);

package/src/model/operation/utils.d.ts

@@ -47,7 +47,7 @@ export declare function _move(this: any, sourceRange: Range, targetPosition: Pos
 export declare function _setAttribute(range: Range, key: string, value: unknown): void;
 /**
  * Normalizes given object or an array of objects to an array of {@link module:engine/model/node~Node nodes}. See
- * {@link module:engine/model/node~NodeSet NodeSet} for details on how normalization is performed.
+ * {@link ~NodeSet NodeSet} for details on how normalization is performed.
  *
  * @internal
  * @param nodes Objects to normalize.

package/src/model/operation/utils.js

@@ -115,7 +115,7 @@ export function _setAttribute(range, key, value) {
 }
 /**
  * Normalizes given object or an array of objects to an array of {@link module:engine/model/node~Node nodes}. See
- * {@link module:engine/model/node~NodeSet NodeSet} for details on how normalization is performed.
+ * {@link ~NodeSet NodeSet} for details on how normalization is performed.
  *
  * @internal
  * @param nodes Objects to normalize.

package/src/model/schema.d.ts

@@ -509,16 +509,16 @@ export default class Schema extends Schema_base {
     private _getValidRangesForRange;
 }
 /**
- * Event fired when the {@link #checkChild} method is called. It allows plugging in
+ * Event fired when the {@link ~Schema#checkChild} method is called. It allows plugging in
  * additional behavior, for example implementing rules which cannot be defined using the declarative
  * {@link module:engine/model/schema~SchemaItemDefinition} interface.
  *
- * **Note:** The {@link #addChildCheck} method is a more handy way to register callbacks. Internally,
+ * **Note:** The {@link ~Schema#addChildCheck} method is a more handy way to register callbacks. Internally,
  * it registers a listener to this event but comes with a simpler API and it is the recommended choice
  * in most of the cases.
  *
- * The {@link #checkChild} method fires an event because it is
- * {@link module:utils/observablemixin~ObservableMixin#decorate decorated} with it. Thanks to that you can
+ * The {@link ~Schema#checkChild} method fires an event because it is
+ * {@link module:utils/observablemixin~Observable#decorate decorated} with it. Thanks to that you can
  * use this event in various ways, but the most important use case is overriding standard behavior of the
  * `checkChild()` method. Let's see a typical listener template:
  *
@@ -571,7 +571,7 @@ export default class Schema extends Schema_base {
  * }, { priority: 'high' } );
  * ```
  *
- * @eventName checkChild
+ * @eventName ~Schema#checkChild
  * @param args The `checkChild()`'s arguments.
  */
 export type SchemaCheckChildEvent = {
@@ -579,16 +579,16 @@ export type SchemaCheckChildEvent = {
     args: [[context: SchemaContext, def: SchemaCompiledItemDefinition]];
 };
 /**
- * Event fired when the {@link #checkAttribute} method is called. It allows plugging in
+ * Event fired when the {@link ~Schema#checkAttribute} method is called. It allows plugging in
  * additional behavior, for example implementing rules which cannot be defined using the declarative
  * {@link module:engine/model/schema~SchemaItemDefinition} interface.
  *
- * **Note:** The {@link #addAttributeCheck} method is a more handy way to register callbacks. Internally,
+ * **Note:** The {@link ~Schema#addAttributeCheck} method is a more handy way to register callbacks. Internally,
  * it registers a listener to this event but comes with a simpler API and it is the recommended choice
  * in most of the cases.
  *
- * The {@link #checkAttribute} method fires an event because it is
- * {@link module:utils/observablemixin~ObservableMixin#decorate decorated} with it. Thanks to that you can
+ * The {@link ~Schema#checkAttribute} method fires an event because it is
+ * {@link module:utils/observablemixin~Observable#decorate decorated} with it. Thanks to that you can
  * use this event in various ways, but the most important use case is overriding the standard behavior of the
  * `checkAttribute()` method. Let's see a typical listener template:
  *
@@ -638,7 +638,7 @@ export type SchemaCheckChildEvent = {
  * }, { priority: 'high' } );
  * ```
  *
- * @eventName checkAttribute
+ * @eventName ~Schema#checkAttribute
  * @param args The `checkAttribute()`'s arguments.
  */
 export type SchemaCheckAttributeEvent = {

package/src/model/schema.js

@@ -61,9 +61,9 @@ export default class Schema extends ObservableMixin() {
              *
              * This situation may happen when:
              *
-             * * Two or more plugins called {@link #register `register()`} with the same name. This will usually mean that
-             * there is a collision between plugins which try to use the same element in the model. Unfortunately,
-             * the only way to solve this is by modifying one of these plugins to use a unique model element name.
+             * * Two or more plugins called {@link module:engine/model/schema~Schema#register `register()`} with the same name.
+             * This will usually mean that there is a collision between plugins which try to use the same element in the model.
+             * Unfortunately, the only way to solve this is by modifying one of these plugins to use a unique model element name.
              * * A single plugin was loaded twice. This happens when it is installed by npm/yarn in two versions
              * and usually means one or more of the following issues:
              *     * a version mismatch (two of your dependencies require two different versions of this plugin),
@@ -113,7 +113,7 @@ export default class Schema extends ObservableMixin() {
              * Cannot extend an item which was not registered yet.
              *
              * This error happens when a plugin tries to extend the schema definition of an item which was not
-             * {@link #register registered} yet.
+             * {@link module:engine/model/schema~Schema#register registered} yet.
              *
              * @param itemName The name of the model element which is being extended.
              * @error schema-cannot-extend-missing-item

package/src/model/selection.d.ts

@@ -420,7 +420,7 @@ export type SelectionChangeEvent = {
 /**
  * Fired when selection range(s) changed.
  *
- * @eventName change:range
+ * @eventName ~Selection#change:range
  * @param directChange In case of {@link module:engine/model/selection~Selection} class it is always set
  * to `true` which indicates that the selection change was caused by a direct use of selection's API.
  * The {@link module:engine/model/documentselection~DocumentSelection}, however, may change because its position
@@ -440,7 +440,7 @@ export type SelectionChangeRangeEvent = {
 /**
  * Fired when selection attribute changed.
  *
- * @eventName change:attribute
+ * @eventName ~Selection#change:attribute
  * @param directChange In case of {@link module:engine/model/selection~Selection} class it is always set
  * to `true` which indicates that the selection change was caused by a direct use of selection's API.
  * The {@link module:engine/model/documentselection~DocumentSelection}, however, may change because its attributes