@ckeditor/ckeditor5-engine 48.1.1 → 48.2.0-alpha.0

package/dist/model/document.d.ts

@@ -98,6 +98,12 @@ export declare class ModelDocument extends /* #__PURE__ */ ModelDocument_base {
      * **Note:** do not use this method after the editor has been initialized! If you want to dynamically add a root, use
      * {@link module:engine/model/writer~ModelWriter#addRoot `model.Writer#addRoot`} instead.
      *
+     * **Note:** The default `elementName` value is `'$root'`. When the editor uses a custom root
+     * {@link module:core/editor/editorconfig~RootConfig#modelElement `modelElement`}, pass the configured model element
+     * name explicitly so the created root matches the schema the features expect.
+     * See the {@glink framework/deep-dive/schema#custom-root-elements Custom root elements} section of the
+     * {@glink framework/deep-dive/schema Schema deep-dive} guide for more details.
+     *
      * @param elementName The element name. Defaults to `'$root'` which also has some basic schema defined
      * (e.g. `$block` elements are allowed inside the `$root`). Make sure to define a proper schema if you use a different name.
      * @param rootName A unique root name.

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

@@ -7,6 +7,7 @@
  */
 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';
 /**
@@ -45,6 +46,11 @@ export declare class MoveOperation extends Operation {
      * @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.
      */

package/dist/model/writer.d.ts

@@ -630,6 +630,12 @@ export declare class ModelWriter {
      *
      * Throws an error, if trying to add a root that is already added and attached.
      *
+     * **Note:** The default `elementName` value is `'$root'`. When the editor uses a custom root
+     * {@link module:core/editor/editorconfig~RootConfig#modelElement `modelElement`}, pass the configured model element
+     * name explicitly so the added root matches the schema the features expect.
+     * See the {@glink framework/deep-dive/schema#custom-root-elements Custom root elements} section of the
+     * {@glink framework/deep-dive/schema Schema deep-dive} guide for more details.
+     *
      * @param rootName Name of the added root.
      * @param elementName The element name. Defaults to `'$root'` which also has some basic schema defined
      * (e.g. `$block` elements are allowed inside the `$root`). Make sure to define a proper schema if you use a different name.

package/dist/view/view.d.ts

@@ -12,6 +12,7 @@ import { ViewPosition, type ViewPositionOffset } from './position.js';
 import { ViewRange } from './range.js';
 import { ViewSelection, type ViewPlaceOrOffset, type ViewSelectable, type ViewSelectionOptions } from './selection.js';
 import type { Observer, ObserverConstructor } from './observer/observer.js';
+import type { ViewDocumentFragment } from './documentfragment.js';
 import type { StylesProcessor } from './stylesmap.js';
 import { type ViewElement } from './element.js';
 import type { ViewNode } from './node.js';
@@ -313,7 +314,7 @@ export declare class EditingView extends /* #__PURE__ */ EditingView_base {
      *
      * @param element Element which is a parent for the range.
      */
-    createRangeIn(element: ViewElement): ViewRange;
+    createRangeIn(element: ViewElement | ViewDocumentFragment): ViewRange;
     /**
      * Creates new {@link module:engine/view/selection~ViewSelection} instance.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-engine",
-  "version": "48.1.1",
+  "version": "48.2.0-alpha.0",
   "description": "The editing engine of CKEditor 5 – the best browser-based rich text editor.",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "CKSource (http://cksource.com/)",
@@ -37,7 +37,7 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@ckeditor/ckeditor5-utils": "48.1.1",
+    "@ckeditor/ckeditor5-utils": "48.2.0-alpha.0",
     "es-toolkit": "1.45.1"
   },
   "files": [