@ckeditor/ckeditor5-engine 48.8.1-alpha.4 → 49.0.0-alpha.1

package/dist/model/operation/moveoperation.d.ts

@@ -1,96 +1,102 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
 /**
- * @module engine/model/operation/moveoperation
- */
-import { Operation } from './operation.js';
-import { ModelPosition } from '../position.js';
-import type { ModelSelectable } from '../selection.js';
-import { type ModelDocument } from '../document.js';
+* @module engine/model/operation/moveoperation
+*/
+import { Operation } from "./operation.js";
+import { ModelPosition } from "../position.js";
+import { ModelRange } from "../range.js";
+import type { ModelSelectable } from "../selection.js";
+import { type ModelDocument } from "../document.js";
 /**
- * Operation to move a range of {@link module:engine/model/item~ModelItem model items}
- * to given {@link module:engine/model/position~ModelPosition target position}.
- */
+* Operation to move a range of {@link module:engine/model/item~ModelItem model items}
+* to given {@link module:engine/model/position~ModelPosition target position}.
+*/
 export declare class MoveOperation extends Operation {
-    /**
-     * Position before the first {@link module:engine/model/item~ModelItem model item} to move.
-     */
-    sourcePosition: ModelPosition;
-    /**
-     * Offset size of moved range.
-     */
-    howMany: number;
-    /**
-     * Position at which moved nodes will be inserted.
-     */
-    targetPosition: ModelPosition;
-    /**
-     * Creates a move operation.
-     *
-     * @param sourcePosition Position before the first {@link module:engine/model/item~ModelItem model item} to move.
-     * @param howMany Offset size of moved range. Moved range will start from `sourcePosition` and end at
-     * `sourcePosition` with offset shifted by `howMany`.
-     * @param targetPosition Position at which moved nodes will be inserted.
-     * @param baseVersion Document {@link module:engine/model/document~ModelDocument#version} on which operation
-     * can be applied or `null` if the operation operates on detached (non-document) tree.
-     */
-    constructor(sourcePosition: ModelPosition, howMany: number, targetPosition: ModelPosition, baseVersion: number | null);
-    /**
-     * @inheritDoc
-     */
-    get type(): 'move' | 'remove' | 'reinsert';
-    /**
-     * @inheritDoc
-     */
-    get affectedSelectable(): ModelSelectable;
-    /**
-     * Creates and returns an operation that has the same parameters as this operation.
-     */
-    clone(): MoveOperation;
-    /**
-     * Returns the start position of the moved range after it got moved. This may be different than
-     * {@link module:engine/model/operation/moveoperation~MoveOperation#targetPosition} in some cases, i.e. when a range is moved
-     * inside the same parent but {@link module:engine/model/operation/moveoperation~MoveOperation#targetPosition targetPosition}
-     * is after {@link module:engine/model/operation/moveoperation~MoveOperation#sourcePosition sourcePosition}.
-     *
-     * ```
-     *  vv              vv
-     * abcdefg ===> adefbcg
-     *      ^          ^
-     *      targetPos  movedRangeStart
-     *      offset 6   offset 4
-     *```
-     */
-    getMovedRangeStart(): ModelPosition;
-    /**
-     * See {@link module:engine/model/operation/operation~Operation#getReversed `Operation#getReversed()`}.
-     */
-    getReversed(): Operation;
-    /**
-     * @inheritDoc
-     * @internal
-     */
-    _validate(): void;
-    /**
-     * @inheritDoc
-     * @internal
-     */
-    _execute(): void;
-    /**
-     * @inheritDoc
-     */
-    toJSON(): unknown;
-    /**
-     * @inheritDoc
-     */
-    static get className(): string;
-    /**
-     * Creates `MoveOperation` object from deserialized object, i.e. from parsed JSON string.
-     *
-     * @param json Deserialized JSON object.
-     * @param document Document on which this operation will be applied.
-     */
-    static fromJSON(json: any, document: ModelDocument): MoveOperation;
+	/**
+	* Position before the first {@link module:engine/model/item~ModelItem model item} to move.
+	*/
+	sourcePosition: ModelPosition;
+	/**
+	* Offset size of moved range.
+	*/
+	howMany: number;
+	/**
+	* Position at which moved nodes will be inserted.
+	*/
+	targetPosition: ModelPosition;
+	/**
+	* Creates a move operation.
+	*
+	* @param sourcePosition Position before the first {@link module:engine/model/item~ModelItem model item} to move.
+	* @param howMany Offset size of moved range. Moved range will start from `sourcePosition` and end at
+	* `sourcePosition` with offset shifted by `howMany`.
+	* @param targetPosition Position at which moved nodes will be inserted.
+	* @param baseVersion Document {@link module:engine/model/document~ModelDocument#version} on which operation
+	* can be applied or `null` if the operation operates on detached (non-document) tree.
+	*/
+	constructor(sourcePosition: ModelPosition, howMany: number, targetPosition: ModelPosition, baseVersion: number | null);
+	/**
+	* @inheritDoc
+	*/
+	get type(): "move" | "remove" | "reinsert";
+	/**
+	* @inheritDoc
+	*/
+	get affectedSelectable(): ModelSelectable;
+	/**
+	* Returns the range that is moved by this operation. This is equal to a range starting at {@link #sourcePosition} spanning over
+	* {@link #howMany} nodes.
+	*/
+	get sourceRange(): ModelRange;
+	/**
+	* Creates and returns an operation that has the same parameters as this operation.
+	*/
+	clone(): MoveOperation;
+	/**
+	* Returns the start position of the moved range after it got moved. This may be different than
+	* {@link module:engine/model/operation/moveoperation~MoveOperation#targetPosition} in some cases, i.e. when a range is moved
+	* inside the same parent but {@link module:engine/model/operation/moveoperation~MoveOperation#targetPosition targetPosition}
+	* is after {@link module:engine/model/operation/moveoperation~MoveOperation#sourcePosition sourcePosition}.
+	*
+	* ```
+	*  vv              vv
+	* abcdefg ===> adefbcg
+	*      ^          ^
+	*      targetPos  movedRangeStart
+	*      offset 6   offset 4
+	*```
+	*/
+	getMovedRangeStart(): ModelPosition;
+	/**
+	* See {@link module:engine/model/operation/operation~Operation#getReversed `Operation#getReversed()`}.
+	*/
+	getReversed(): Operation;
+	/**
+	* @inheritDoc
+	* @internal
+	*/
+	override _validate(): void;
+	/**
+	* @inheritDoc
+	* @internal
+	*/
+	_execute(): void;
+	/**
+	* @inheritDoc
+	*/
+	override toJSON(): unknown;
+	/**
+	* @inheritDoc
+	*/
+	static override get className(): string;
+	/**
+	* Creates `MoveOperation` object from deserialized object, i.e. from parsed JSON string.
+	*
+	* @param json Deserialized JSON object.
+	* @param document Document on which this operation will be applied.
+	*/
+	static override fromJSON(json: any, document: ModelDocument): MoveOperation;
 }

package/dist/model/operation/nooperation.d.ts

@@ -1,38 +1,38 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
 /**
- * @module engine/model/operation/nooperation
- */
-import { Operation } from './operation.js';
-import type { ModelSelectable } from '../selection.js';
+* @module engine/model/operation/nooperation
+*/
+import { Operation } from "./operation.js";
+import type { ModelSelectable } from "../selection.js";
 /**
- * Operation which is doing nothing ("empty operation", "do-nothing operation", "noop"). This is an operation,
- * which when executed does not change the tree model. It still has some parameters defined for transformation purposes.
- *
- * In most cases this operation is a result of transforming operations. When transformation returns
- * {@link module:engine/model/operation/nooperation~NoOperation} it means that changes done by the transformed operation
- * have already been applied.
- */
+* Operation which is doing nothing ("empty operation", "do-nothing operation", "noop"). This is an operation,
+* which when executed does not change the tree model. It still has some parameters defined for transformation purposes.
+*
+* In most cases this operation is a result of transforming operations. When transformation returns
+* {@link module:engine/model/operation/nooperation~NoOperation} it means that changes done by the transformed operation
+* have already been applied.
+*/
 export declare class NoOperation extends Operation {
-    get type(): 'noop';
-    /**
-     * @inheritDoc
-     */
-    get affectedSelectable(): ModelSelectable;
-    /**
-     * Creates and returns an operation that has the same parameters as this operation.
-     */
-    clone(): NoOperation;
-    /**
-     * See {@link module:engine/model/operation/operation~Operation#getReversed `Operation#getReversed()`}.
-     */
-    getReversed(): Operation;
-    /** @internal */
-    _execute(): void;
-    /**
-     * @inheritDoc
-     */
-    static get className(): string;
+	get type(): "noop";
+	/**
+	* @inheritDoc
+	*/
+	get affectedSelectable(): ModelSelectable;
+	/**
+	* Creates and returns an operation that has the same parameters as this operation.
+	*/
+	clone(): NoOperation;
+	/**
+	* See {@link module:engine/model/operation/operation~Operation#getReversed `Operation#getReversed()`}.
+	*/
+	getReversed(): Operation;
+	/** @internal */
+	_execute(): void;
+	/**
+	* @inheritDoc
+	*/
+	static override get className(): string;
 }

package/dist/model/operation/operation.d.ts

@@ -1,99 +1,99 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
 /**
- * @module engine/model/operation/operation
- */
-import { type Batch } from '../batch.js';
-import { type ModelDocument } from '../document.js';
-import type { ModelSelectable } from '../selection.js';
+* @module engine/model/operation/operation
+*/
+import { type Batch } from "../batch.js";
+import { type ModelDocument } from "../document.js";
+import type { ModelSelectable } from "../selection.js";
 /**
- * Abstract base operation class.
- */
+* Abstract base operation class.
+*/
 export declare abstract class Operation {
-    /**
-     * {@link module:engine/model/document~ModelDocument#version} on which operation can be applied. If you try to
-     * {@link module:engine/model/model~Model#applyOperation apply} operation with different base version than the
-     * {@link module:engine/model/document~ModelDocument#version document version} the
-     * {@link module:utils/ckeditorerror~CKEditorError model-document-applyOperation-wrong-version} error is thrown.
-     */
-    baseVersion: number | null;
-    /**
-     * Defines whether operation is executed on attached or detached {@link module:engine/model/item~ModelItem items}.
-     */
-    readonly isDocumentOperation: boolean;
-    /**
-     * {@link module:engine/model/batch~Batch Batch} to which the operation is added or `null` if the operation is not
-     * added to any batch yet.
-     *
-     * Note, that a {@link #isDocumentOperation non-document operation} has this property always set to `null`, and is never added
-     * to any batch.
-     */
-    batch: Batch | null;
-    /**
-     * Operation type.
-     */
-    abstract readonly type: string;
-    /**
-     * Base operation constructor.
-     *
-     * @param baseVersion Document {@link module:engine/model/document~ModelDocument#version} on which operation
-     * can be applied or `null` if the operation operates on detached (non-document) tree.
-     */
-    constructor(baseVersion: number | null);
-    /**
-     * A selectable that will be affected by the operation after it is executed.
-     *
-     * The exact returned parameter differs between operation types.
-     */
-    abstract get affectedSelectable(): ModelSelectable;
-    /**
-     * Creates and returns an operation that has the same parameters as this operation.
-     *
-     * @returns Clone of this operation.
-     */
-    abstract clone(): Operation;
-    /**
-     * Creates and returns a reverse operation. Reverse operation when executed right after
-     * the original operation will bring back tree model state to the point before the original
-     * operation execution. In other words, it reverses changes done by the original operation.
-     *
-     * Keep in mind that tree model state may change since executing the original operation,
-     * so reverse operation will be "outdated". In that case you will need to transform it by
-     * all operations that were executed after the original operation.
-     *
-     * @returns Reversed operation.
-     */
-    abstract getReversed(): Operation;
-    /**
-     * Executes the operation - modifications described by the operation properties will be applied to the model tree.
-     *
-     * @internal
-     */
-    abstract _execute(): void;
-    /**
-     * Checks whether the operation's parameters are correct and the operation can be correctly executed. Throws
-     * an error if operation is not valid.
-     *
-     * @internal
-     */
-    _validate(): void;
-    /**
-     * Custom toJSON method to solve child-parent circular dependencies.
-     *
-     * @returns Clone of this object with the operation property replaced with string.
-     */
-    toJSON(): unknown;
-    /**
-     * Name of the operation class used for serialization.
-     */
-    static get className(): string;
-    /**
-     * Creates `Operation` object from deserialized object, i.e. from parsed JSON string.
-     *
-     * @param json Deserialized JSON object.
-     * @param document Document on which this operation will be applied.
-     */
-    static fromJSON(json: any, document: ModelDocument): Operation;
+	/**
+	* {@link module:engine/model/document~ModelDocument#version} on which operation can be applied. If you try to
+	* {@link module:engine/model/model~Model#applyOperation apply} operation with different base version than the
+	* {@link module:engine/model/document~ModelDocument#version document version} the
+	* {@link module:utils/ckeditorerror~CKEditorError model-document-applyOperation-wrong-version} error is thrown.
+	*/
+	baseVersion: number | null;
+	/**
+	* Defines whether operation is executed on attached or detached {@link module:engine/model/item~ModelItem items}.
+	*/
+	readonly isDocumentOperation: boolean;
+	/**
+	* {@link module:engine/model/batch~Batch Batch} to which the operation is added or `null` if the operation is not
+	* added to any batch yet.
+	*
+	* Note, that a {@link #isDocumentOperation non-document operation} has this property always set to `null`, and is never added
+	* to any batch.
+	*/
+	batch: Batch | null;
+	/**
+	* Operation type.
+	*/
+	abstract readonly type: string;
+	/**
+	* Base operation constructor.
+	*
+	* @param baseVersion Document {@link module:engine/model/document~ModelDocument#version} on which operation
+	* can be applied or `null` if the operation operates on detached (non-document) tree.
+	*/
+	constructor(baseVersion: number | null);
+	/**
+	* A selectable that will be affected by the operation after it is executed.
+	*
+	* The exact returned parameter differs between operation types.
+	*/
+	abstract get affectedSelectable(): ModelSelectable;
+	/**
+	* Creates and returns an operation that has the same parameters as this operation.
+	*
+	* @returns Clone of this operation.
+	*/
+	abstract clone(): Operation;
+	/**
+	* Creates and returns a reverse operation. Reverse operation when executed right after
+	* the original operation will bring back tree model state to the point before the original
+	* operation execution. In other words, it reverses changes done by the original operation.
+	*
+	* Keep in mind that tree model state may change since executing the original operation,
+	* so reverse operation will be "outdated". In that case you will need to transform it by
+	* all operations that were executed after the original operation.
+	*
+	* @returns Reversed operation.
+	*/
+	abstract getReversed(): Operation;
+	/**
+	* Executes the operation - modifications described by the operation properties will be applied to the model tree.
+	*
+	* @internal
+	*/
+	abstract _execute(): void;
+	/**
+	* Checks whether the operation's parameters are correct and the operation can be correctly executed. Throws
+	* an error if operation is not valid.
+	*
+	* @internal
+	*/
+	_validate(): void;
+	/**
+	* Custom toJSON method to solve child-parent circular dependencies.
+	*
+	* @returns Clone of this object with the operation property replaced with string.
+	*/
+	toJSON(): unknown;
+	/**
+	* Name of the operation class used for serialization.
+	*/
+	static get className(): string;
+	/**
+	* Creates `Operation` object from deserialized object, i.e. from parsed JSON string.
+	*
+	* @param json Deserialized JSON object.
+	* @param document Document on which this operation will be applied.
+	*/
+	static fromJSON(json: any, document: ModelDocument): Operation;
 }

package/dist/model/operation/operationfactory.d.ts

@@ -1,18 +1,18 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
-import { Operation } from './operation.js';
-import { type ModelDocument } from '../document.js';
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
+import { Operation } from "./operation.js";
+import { type ModelDocument } from "../document.js";
 /**
- * A factory class for creating operations.
- */
+* A factory class for creating operations.
+*/
 export declare abstract class OperationFactory {
-    /**
-     * Creates an operation instance from a JSON object (parsed JSON string).
-     *
-     * @param json Deserialized JSON object.
-     * @param document Document on which this operation will be applied.
-     */
-    static fromJSON(json: any, document: ModelDocument): Operation;
+	/**
+	* Creates an operation instance from a JSON object (parsed JSON string).
+	*
+	* @param json Deserialized JSON object.
+	* @param document Document on which this operation will be applied.
+	*/
+	static fromJSON(json: any, document: ModelDocument): Operation;
 }