@ckeditor/ckeditor5-engine 38.2.0-alpha.1 → 39.0.1

package/src/model/operation/transform.js

@@ -2,18 +2,18 @@
  * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
-import InsertOperation from './insertoperation.js';
-import AttributeOperation from './attributeoperation.js';
-import RenameOperation from './renameoperation.js';
-import MarkerOperation from './markeroperation.js';
-import MoveOperation from './moveoperation.js';
-import RootAttributeOperation from './rootattributeoperation.js';
-import RootOperation from './rootoperation.js';
-import MergeOperation from './mergeoperation.js';
-import SplitOperation from './splitoperation.js';
-import NoOperation from './nooperation.js';
-import Range from '../range.js';
-import Position from '../position.js';
+import InsertOperation from './insertoperation';
+import AttributeOperation from './attributeoperation';
+import RenameOperation from './renameoperation';
+import MarkerOperation from './markeroperation';
+import MoveOperation from './moveoperation';
+import RootAttributeOperation from './rootattributeoperation';
+import RootOperation from './rootoperation';
+import MergeOperation from './mergeoperation';
+import SplitOperation from './splitoperation';
+import NoOperation from './nooperation';
+import Range from '../range';
+import Position from '../position';
 import { compareArrays } from '@ckeditor/ckeditor5-utils';
 const transformations = new Map();
 /**
@@ -1641,8 +1641,8 @@ setTransformation(RootAttributeOperation, RootAttributeOperation, (a, b, context
     return [a];
 });
 // -----------------------
-setTransformation(RootOperation, RootOperation, (a, b, context) => {
-    if (a.rootName === b.rootName && a.isAdd === b.isAdd && !context.bWasUndone) {
+setTransformation(RootOperation, RootOperation, (a, b) => {
+    if (a.rootName === b.rootName && a.isAdd === b.isAdd) {
         return [new NoOperation(0)];
     }
     return [a];

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

@@ -5,12 +5,12 @@
 /**
  * @module engine/model/operation/utils
  */
-import Node from '../node.js';
-import Range from '../range.js';
-import type DocumentFragment from '../documentfragment.js';
-import type Item from '../item.js';
-import type NodeList from '../nodelist.js';
-import type Position from '../position.js';
+import Node from '../node';
+import Range from '../range';
+import type DocumentFragment from '../documentfragment';
+import type Item from '../item';
+import type NodeList from '../nodelist';
+import type Position from '../position';
 /**
  * Inserts given nodes at given position.
  *

package/src/model/operation/utils.js

@@ -5,10 +5,10 @@
 /**
  * @module engine/model/operation/utils
  */
-import Node from '../node.js';
-import Range from '../range.js';
-import Text from '../text.js';
-import TextProxy from '../textproxy.js';
+import Node from '../node';
+import Range from '../range';
+import Text from '../text';
+import TextProxy from '../textproxy';
 import { CKEditorError, isIterable } from '@ckeditor/ckeditor5-utils';
 /**
  * Inserts given nodes at given position.

package/src/model/position.d.ts

@@ -5,20 +5,20 @@
 /**
  * @module engine/model/position
  */
-import TypeCheckable from './typecheckable.js';
-import { type TreeWalkerOptions, type TreeWalkerValue } from './treewalker.js';
-import type Document from './document.js';
-import type DocumentFragment from './documentfragment.js';
-import type Element from './element.js';
-import type InsertOperation from './operation/insertoperation.js';
-import type Item from './item.js';
-import type MergeOperation from './operation/mergeoperation.js';
-import type MoveOperation from './operation/moveoperation.js';
-import type Node from './node.js';
-import type Operation from './operation/operation.js';
-import type SplitOperation from './operation/splitoperation.js';
-import type Text from './text.js';
-import '@ckeditor/ckeditor5-utils/src/version.js';
+import TypeCheckable from './typecheckable';
+import { type TreeWalkerOptions, type TreeWalkerValue } from './treewalker';
+import type Document from './document';
+import type DocumentFragment from './documentfragment';
+import type Element from './element';
+import type InsertOperation from './operation/insertoperation';
+import type Item from './item';
+import type MergeOperation from './operation/mergeoperation';
+import type MoveOperation from './operation/moveoperation';
+import type Node from './node';
+import type Operation from './operation/operation';
+import type SplitOperation from './operation/splitoperation';
+import type Text from './text';
+import '@ckeditor/ckeditor5-utils/src/version';
 /**
  * Represents a position in the model tree.
  *

package/src/model/position.js

@@ -5,11 +5,11 @@
 /**
  * @module engine/model/position
  */
-import TypeCheckable from './typecheckable.js';
-import TreeWalker from './treewalker.js';
+import TypeCheckable from './typecheckable';
+import TreeWalker from './treewalker';
 import { CKEditorError, compareArrays } from '@ckeditor/ckeditor5-utils';
 // To check if component is loaded more than once.
-import '@ckeditor/ckeditor5-utils/src/version.js';
+import '@ckeditor/ckeditor5-utils/src/version';
 /**
  * Represents a position in the model tree.
  *

package/src/model/range.d.ts

@@ -5,18 +5,18 @@
 /**
  * @module engine/model/range
  */
-import TypeCheckable from './typecheckable.js';
-import Position from './position.js';
-import TreeWalker, { type TreeWalkerOptions, type TreeWalkerValue } from './treewalker.js';
-import type Document from './document.js';
-import type DocumentFragment from './documentfragment.js';
-import type Element from './element.js';
-import type InsertOperation from './operation/insertoperation.js';
-import type Item from './item.js';
-import type MergeOperation from './operation/mergeoperation.js';
-import type MoveOperation from './operation/moveoperation.js';
-import type Operation from './operation/operation.js';
-import type SplitOperation from './operation/splitoperation.js';
+import TypeCheckable from './typecheckable';
+import Position from './position';
+import TreeWalker, { type TreeWalkerOptions, type TreeWalkerValue } from './treewalker';
+import type Document from './document';
+import type DocumentFragment from './documentfragment';
+import type Element from './element';
+import type InsertOperation from './operation/insertoperation';
+import type Item from './item';
+import type MergeOperation from './operation/mergeoperation';
+import type MoveOperation from './operation/moveoperation';
+import type Operation from './operation/operation';
+import type SplitOperation from './operation/splitoperation';
 /**
  * Represents a range in the model tree.
  *

package/src/model/range.js

@@ -5,9 +5,9 @@
 /**
  * @module engine/model/range
  */
-import TypeCheckable from './typecheckable.js';
-import Position from './position.js';
-import TreeWalker from './treewalker.js';
+import TypeCheckable from './typecheckable';
+import Position from './position';
+import TreeWalker from './treewalker';
 import { CKEditorError, compareArrays } from '@ckeditor/ckeditor5-utils';
 /**
  * Represents a range in the model tree.

package/src/model/rootelement.d.ts

@@ -5,8 +5,8 @@
 /**
  * @module engine/model/rootelement
  */
-import Element from './element.js';
-import type Document from './document.js';
+import Element from './element';
+import type Document from './document';
 /**
  * Type of {@link module:engine/model/element~Element} that is a root of a model tree.
  */
@@ -23,6 +23,12 @@ export default class RootElement extends Element {
      * @internal
      */
     _isAttached: boolean;
+    /**
+     * Informs if the root element is loaded (default).
+     *
+     * @internal
+     */
+    _isLoaded: boolean;
     /**
      * Creates root element.
      *

package/src/model/rootelement.js

@@ -5,7 +5,7 @@
 /**
  * @module engine/model/rootelement
  */
-import Element from './element.js';
+import Element from './element';
 /**
  * Type of {@link module:engine/model/element~Element} that is a root of a model tree.
  */
@@ -23,6 +23,12 @@ export default class RootElement extends Element {
          * @internal
          */
         this._isAttached = true;
+        /**
+         * Informs if the root element is loaded (default).
+         *
+         * @internal
+         */
+        this._isLoaded = true;
         this._document = document;
         this.rootName = rootName;
     }

package/src/model/schema.d.ts

@@ -5,15 +5,15 @@
 /**
  * @module engine/model/schema
  */
-import Element from './element.js';
-import Position from './position.js';
-import Range from './range.js';
-import type DocumentFragment from './documentfragment.js';
-import type DocumentSelection from './documentselection.js';
-import type Item from './item.js';
-import type Node from './node.js';
-import type Selection from './selection.js';
-import type Writer from './writer.js';
+import Element from './element';
+import Position from './position';
+import Range from './range';
+import type DocumentFragment from './documentfragment';
+import type DocumentSelection from './documentselection';
+import type Item from './item';
+import type Node from './node';
+import type Selection from './selection';
+import type Writer from './writer';
 declare const Schema_base: {
     new (): import("@ckeditor/ckeditor5-utils").Observable;
     prototype: import("@ckeditor/ckeditor5-utils").Observable;

package/src/model/schema.js

@@ -5,11 +5,11 @@
 /**
  * @module engine/model/schema
  */
-import Element from './element.js';
-import Position from './position.js';
-import Range from './range.js';
-import Text from './text.js';
-import TreeWalker from './treewalker.js';
+import Element from './element';
+import Position from './position';
+import Range from './range';
+import Text from './text';
+import TreeWalker from './treewalker';
 import { CKEditorError, ObservableMixin } from '@ckeditor/ckeditor5-utils';
 /**
  * The model's schema. It defines the allowed and disallowed structures of nodes as well as nodes' attributes.
@@ -677,6 +677,11 @@ export default class Schema extends ObservableMixin() {
      * @returns Nearest selection range or `null` if one cannot be found.
      */
     getNearestSelectionRange(position, direction = 'both') {
+        if (position.root.rootName == '$graveyard') {
+            // No valid selection range in the graveyard.
+            // This is important when getting the document selection default range.
+            return null;
+        }
         // Return collapsed range if provided position is valid.
         if (this.checkChild(position, '$text')) {
             return new Range(position);

package/src/model/selection.d.ts

@@ -5,13 +5,13 @@
 /**
  * @module engine/model/selection
  */
-import TypeCheckable from './typecheckable.js';
-import Node from './node.js';
-import Position, { type PositionOffset } from './position.js';
-import Range from './range.js';
-import type DocumentSelection from './documentselection.js';
-import type Element from './element.js';
-import type Item from './item.js';
+import TypeCheckable from './typecheckable';
+import Node from './node';
+import Position, { type PositionOffset } from './position';
+import Range from './range';
+import type DocumentSelection from './documentselection';
+import type Element from './element';
+import type Item from './item';
 declare const Selection_base: import("@ckeditor/ckeditor5-utils").Mixed<typeof TypeCheckable, import("@ckeditor/ckeditor5-utils").Emitter>;
 /**
  * Selection is a set of {@link module:engine/model/range~Range ranges}. It has a direction specified by its

package/src/model/selection.js

@@ -5,10 +5,10 @@
 /**
  * @module engine/model/selection
  */
-import TypeCheckable from './typecheckable.js';
-import Node from './node.js';
-import Position from './position.js';
-import Range from './range.js';
+import TypeCheckable from './typecheckable';
+import Node from './node';
+import Position from './position';
+import Range from './range';
 import { CKEditorError, EmitterMixin, isIterable } from '@ckeditor/ckeditor5-utils';
 /**
  * Selection is a set of {@link module:engine/model/range~Range ranges}. It has a direction specified by its

package/src/model/text.d.ts

@@ -5,7 +5,7 @@
 /**
  * @module engine/model/text
  */
-import Node, { type NodeAttributes } from './node.js';
+import Node, { type NodeAttributes } from './node';
 /**
  * Model text node. Type of {@link module:engine/model/node~Node node} that contains {@link module:engine/model/text~Text#data text data}.
  *

package/src/model/text.js

@@ -5,7 +5,7 @@
 /**
  * @module engine/model/text
  */
-import Node from './node.js';
+import Node from './node';
 // @if CK_DEBUG_ENGINE // const { convertMapToStringifiedObject } = require( '../dev-utils/utils' );
 /**
  * Model text node. Type of {@link module:engine/model/node~Node node} that contains {@link module:engine/model/text~Text#data text data}.

package/src/model/textproxy.d.ts

@@ -5,11 +5,11 @@
 /**
  * @module engine/model/textproxy
  */
-import TypeCheckable from './typecheckable.js';
-import type DocumentFragment from './documentfragment.js';
-import type Element from './element.js';
-import type Node from './node.js';
-import type Text from './text.js';
+import TypeCheckable from './typecheckable';
+import type DocumentFragment from './documentfragment';
+import type Element from './element';
+import type Node from './node';
+import type Text from './text';
 /**
  * `TextProxy` represents a part of {@link module:engine/model/text~Text text node}.
  *

package/src/model/textproxy.js

@@ -5,7 +5,7 @@
 /**
  * @module engine/model/textproxy
  */
-import TypeCheckable from './typecheckable.js';
+import TypeCheckable from './typecheckable';
 import { CKEditorError } from '@ckeditor/ckeditor5-utils';
 // @if CK_DEBUG_ENGINE // const { convertMapToStringifiedObject } = require( '../dev-utils/utils' );
 /**

package/src/model/treewalker.d.ts

@@ -2,9 +2,9 @@
  * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
-import { default as Position } from './position.js';
-import type Item from './item.js';
-import type Range from './range.js';
+import { default as Position } from './position';
+import type Item from './item';
+import type Range from './range';
 /**
  * Position iterator class. It allows to iterate forward and backward over the document.
  */

package/src/model/treewalker.js

@@ -5,10 +5,10 @@
 /**
  * @module engine/model/treewalker
  */
-import Element from './element.js';
-import { default as Position, getTextNodeAtPosition, getNodeAfterPosition, getNodeBeforePosition } from './position.js';
-import Text from './text.js';
-import TextProxy from './textproxy.js';
+import Element from './element';
+import { default as Position, getTextNodeAtPosition, getNodeAfterPosition, getNodeBeforePosition } from './position';
+import Text from './text';
+import TextProxy from './textproxy';
 import { CKEditorError } from '@ckeditor/ckeditor5-utils';
 /**
  * Position iterator class. It allows to iterate forward and backward over the document.

package/src/model/typecheckable.d.ts

@@ -5,19 +5,19 @@
 /**
  * @module engine/model/typecheckable
  */
-import type { Marker } from './markercollection.js';
-import type DocumentFragment from './documentfragment.js';
-import type DocumentSelection from './documentselection.js';
-import type Element from './element.js';
-import type LivePosition from './liveposition.js';
-import type LiveRange from './liverange.js';
-import type Node from './node.js';
-import type Position from './position.js';
-import type Range from './range.js';
-import type RootElement from './rootelement.js';
-import type Selection from './selection.js';
-import type Text from './text.js';
-import type TextProxy from './textproxy.js';
+import type { Marker } from './markercollection';
+import type DocumentFragment from './documentfragment';
+import type DocumentSelection from './documentselection';
+import type Element from './element';
+import type LivePosition from './liveposition';
+import type LiveRange from './liverange';
+import type Node from './node';
+import type Position from './position';
+import type Range from './range';
+import type RootElement from './rootelement';
+import type Selection from './selection';
+import type Text from './text';
+import type TextProxy from './textproxy';
 export default abstract class TypeCheckable {
     /**
      * Checks whether the object is of type {@link module:engine/model/node~Node} or its subclass.

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

@@ -2,10 +2,10 @@
  * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
-import type Node from '../node.js';
-import type Position from '../position.js';
-import type Schema from '../schema.js';
-import type Writer from '../writer.js';
+import type Node from '../node';
+import type Position from '../position';
+import type Schema from '../schema';
+import type Writer from '../writer';
 /**
  * @module engine/model/utils/autoparagraphing
  */

package/src/model/utils/autoparagraphing.js

@@ -14,8 +14,7 @@
  */
 export function autoParagraphEmptyRoots(writer) {
     const { schema, document } = writer.model;
-    for (const rootName of document.getRootNames()) {
-        const root = document.getRoot(rootName);
+    for (const root of document.getRoots()) {
         if (root.isEmpty && !schema.checkChild(root, '$text')) {
             // If paragraph element is allowed in the root, create paragraph element.
             if (schema.checkChild(root, 'paragraph')) {

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

@@ -5,9 +5,9 @@
 /**
  * @module engine/model/utils/deletecontent
  */
-import DocumentSelection from '../documentselection.js';
-import type Model from '../model.js';
-import type Selection from '../selection.js';
+import DocumentSelection from '../documentselection';
+import type Model from '../model';
+import type Selection from '../selection';
 /**
  * Deletes content of the selection and merge siblings. The resulting selection is always collapsed.
  *

package/src/model/utils/deletecontent.js

@@ -5,9 +5,9 @@
 /**
  * @module engine/model/utils/deletecontent
  */
-import DocumentSelection from '../documentselection.js';
-import LivePosition from '../liveposition.js';
-import Range from '../range.js';
+import DocumentSelection from '../documentselection';
+import LivePosition from '../liveposition';
+import Range from '../range';
 /**
  * Deletes content of the selection and merge siblings. The resulting selection is always collapsed.
  *

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

@@ -2,10 +2,10 @@
  * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
-import type DocumentSelection from '../documentselection.js';
-import type Model from '../model.js';
-import type Range from '../range.js';
-import type Selection from '../selection.js';
+import type DocumentSelection from '../documentselection';
+import type Model from '../model';
+import type Range from '../range';
+import type Selection from '../selection';
 /**
  * Returns a model range which is optimal (in terms of UX) for inserting a widget block.
  *

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

@@ -2,10 +2,10 @@
  * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
-import type DocumentFragment from '../documentfragment.js';
-import type DocumentSelection from '../documentselection.js';
-import type Model from '../model.js';
-import type Selection from '../selection.js';
+import type DocumentFragment from '../documentfragment';
+import type DocumentSelection from '../documentselection';
+import type Model from '../model';
+import type Selection from '../selection';
 /**
  * @module engine/model/utils/getselectedcontent
  */

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

@@ -5,12 +5,12 @@
 /**
  * @module engine/model/utils/insertcontent
  */
-import DocumentSelection from '../documentselection.js';
-import Range from '../range.js';
-import type DocumentFragment from '../documentfragment.js';
-import type Item from '../item.js';
-import type Model from '../model.js';
-import type Selection from '../selection.js';
+import DocumentSelection from '../documentselection';
+import Range from '../range';
+import type DocumentFragment from '../documentfragment';
+import type Item from '../item';
+import type Model from '../model';
+import type Selection from '../selection';
 /**
  * Inserts content into the editor (specified selection) as one would expect the paste functionality to work.
  *

package/src/model/utils/insertcontent.js

@@ -5,12 +5,12 @@
 /**
  * @module engine/model/utils/insertcontent
  */
-import DocumentSelection from '../documentselection.js';
-import Element from '../element.js';
-import LivePosition from '../liveposition.js';
-import LiveRange from '../liverange.js';
-import Position from '../position.js';
-import Range from '../range.js';
+import DocumentSelection from '../documentselection';
+import Element from '../element';
+import LivePosition from '../liveposition';
+import LiveRange from '../liverange';
+import Position from '../position';
+import Range from '../range';
 import { CKEditorError } from '@ckeditor/ckeditor5-utils';
 /**
  * Inserts content into the editor (specified selection) as one would expect the paste functionality to work.

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

@@ -2,11 +2,11 @@
  * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
-import type DocumentSelection from '../documentselection.js';
-import type Selection from '../selection.js';
-import type Element from '../element.js';
-import type Model from '../model.js';
-import type Range from '../range.js';
+import type DocumentSelection from '../documentselection';
+import type Selection from '../selection';
+import type Element from '../element';
+import type Model from '../model';
+import type Range from '../range';
 /**
  * Inserts an {@glink framework/deep-dive/schema#object-elements object element} at a specific position in the editor content.
  *

package/src/model/utils/insertobject.js

@@ -5,7 +5,7 @@
 /**
  * @module engine/model/utils/insertobject
  */
-import { findOptimalInsertionRange } from './findoptimalinsertionrange.js';
+import { findOptimalInsertionRange } from './findoptimalinsertionrange';
 import { CKEditorError, first } from '@ckeditor/ckeditor5-utils';
 /**
  * Inserts an {@glink framework/deep-dive/schema#object-elements object element} at a specific position in the editor content.

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

@@ -5,9 +5,9 @@
 /**
  * @module engine/model/utils/modifyselection
  */
-import DocumentSelection from '../documentselection.js';
-import type Model from '../model.js';
-import type Selection from '../selection.js';
+import DocumentSelection from '../documentselection';
+import type Model from '../model';
+import type Selection from '../selection';
 /**
  * Modifies the selection. Currently, the supported modifications are:
  *

package/src/model/utils/modifyselection.js

@@ -5,10 +5,10 @@
 /**
  * @module engine/model/utils/modifyselection
  */
-import DocumentSelection from '../documentselection.js';
-import Position from '../position.js';
-import Range from '../range.js';
-import TreeWalker from '../treewalker.js';
+import DocumentSelection from '../documentselection';
+import Position from '../position';
+import Range from '../range';
+import TreeWalker from '../treewalker';
 import { isInsideSurrogatePair, isInsideCombinedSymbol, isInsideEmojiSequence } from '@ckeditor/ckeditor5-utils';
 const wordBoundaryCharacters = ' ,.?!:;"-()';
 /**

package/src/model/utils/selection-post-fixer.d.ts

@@ -2,9 +2,9 @@
  * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
-import Range from '../range.js';
-import type Model from '../model.js';
-import type Schema from '../schema.js';
+import Range from '../range';
+import type Model from '../model';
+import type Schema from '../schema';
 /**
  * Injects selection post-fixer to the model.
  *