@ckeditor/ckeditor5-engine 40.1.0 → 41.0.0

package/src/model/schema.d.ts

@@ -1,19 +1,19 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 /**
  * @module engine/model/schema
  */
-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';
+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';
 declare const Schema_base: {
     new (): import("@ckeditor/ckeditor5-utils").Observable;
     prototype: import("@ckeditor/ckeditor5-utils").Observable;
@@ -225,7 +225,7 @@ export default class Schema extends Schema_base {
      * ```
      *
      * Note: When verifying whether the given node can be a child of the given context, the
-     * schema also verifies the entire context — from its root to its last element. Therefore, it is possible
+     * schema also verifies the entire context – from its root to its last element. Therefore, it is possible
      * for `checkChild()` to return `false` even though the context's last element can contain the checked child.
      * It happens if one of the context's elements does not allow its child.
      *
@@ -254,7 +254,7 @@ export default class Schema extends Schema_base {
     /**
      * Checks whether the given element (`elementToMerge`) can be merged with the specified base element (`positionOrBaseElement`).
      *
-     * In other words — whether `elementToMerge`'s children {@link #checkChild are allowed} in the `positionOrBaseElement`.
+     * In other words – whether `elementToMerge`'s children {@link #checkChild are allowed} in the `positionOrBaseElement`.
      *
      * This check ensures that elements merged with {@link module:engine/model/writer~Writer#merge `Writer#merge()`}
      * will be valid.
@@ -507,6 +507,26 @@ export default class Schema extends Schema_base {
      * @returns Ranges in which the attribute is allowed.
      */
     private _getValidRangesForRange;
+    /**
+     * Returns a model range which is optimal (in terms of UX) for inserting a widget block.
+     *
+     * For instance, if a selection is in the middle of a paragraph, the collapsed range before this paragraph
+     * will be returned so that it is not split. If the selection is at the end of a paragraph,
+     * the collapsed range after this paragraph will be returned.
+     *
+     * Note: If the selection is placed in an empty block, the range in that block will be returned. If that range
+     * is then passed to {@link module:engine/model/model~Model#insertContent}, the block will be fully replaced
+     * by the inserted widget block.
+     *
+     * @internal
+     * @param selection The selection based on which the insertion position should be calculated.
+     * @param place The place where to look for optimal insertion range.
+     * The `auto` value will determine itself the best position for insertion.
+     * The `before` value will try to find a position before selection.
+     * The `after` value will try to find a position after selection.
+     * @returns The optimal range.
+     */
+    findOptimalInsertionRange(selection: Selection | DocumentSelection, place?: 'auto' | 'before' | 'after'): Range;
 }
 /**
  * Event fired when the {@link ~Schema#checkChild} method is called. It allows plugging in
@@ -942,7 +962,7 @@ export interface SchemaCompiledItemDefinition {
     allowAttributes: Array<string>;
 }
 /**
- * A schema context &mdash; a list of ancestors of a given position in the document.
+ * A schema context &ndash; a list of ancestors of a given position in the document.
  *
  * Considering such position:
  *
@@ -1181,6 +1201,6 @@ export interface AttributeProperties {
     copyFromObject?: boolean;
     [name: string]: unknown;
 }
-export type SchemaAttributeCheckCallback = (context: SchemaContext, attributeName: string) => unknown;
-export type SchemaChildCheckCallback = (ctx: SchemaContext, def: SchemaCompiledItemDefinition) => unknown;
+export type SchemaAttributeCheckCallback = (context: SchemaContext, attributeName: string) => boolean | undefined;
+export type SchemaChildCheckCallback = (context: SchemaContext, definition: SchemaCompiledItemDefinition) => boolean | undefined;
 export {};

package/src/model/schema.js

@@ -1,16 +1,16 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 /**
  * @module engine/model/schema
  */
-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';
+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 { CKEditorError, first, ObservableMixin } from '@ckeditor/ckeditor5-utils';
 /**
  * The model's schema. It defines the allowed and disallowed structures of nodes as well as nodes' attributes.
  * The schema is usually defined by the features and based on them, the editing framework and features
@@ -326,7 +326,7 @@ export default class Schema extends ObservableMixin() {
      * ```
      *
      * Note: When verifying whether the given node can be a child of the given context, the
-     * schema also verifies the entire context — from its root to its last element. Therefore, it is possible
+     * schema also verifies the entire context – from its root to its last element. Therefore, it is possible
      * for `checkChild()` to return `false` even though the context's last element can contain the checked child.
      * It happens if one of the context's elements does not allow its child.
      *
@@ -367,7 +367,7 @@ export default class Schema extends ObservableMixin() {
     /**
      * Checks whether the given element (`elementToMerge`) can be merged with the specified base element (`positionOrBaseElement`).
      *
-     * In other words — whether `elementToMerge`'s children {@link #checkChild are allowed} in the `positionOrBaseElement`.
+     * In other words – whether `elementToMerge`'s children {@link #checkChild are allowed} in the `positionOrBaseElement`.
      *
      * This check ensures that elements merged with {@link module:engine/model/writer~Writer#merge `Writer#merge()`}
      * will be valid.
@@ -882,9 +882,54 @@ export default class Schema extends ObservableMixin() {
             yield new Range(start, end);
         }
     }
+    /**
+     * Returns a model range which is optimal (in terms of UX) for inserting a widget block.
+     *
+     * For instance, if a selection is in the middle of a paragraph, the collapsed range before this paragraph
+     * will be returned so that it is not split. If the selection is at the end of a paragraph,
+     * the collapsed range after this paragraph will be returned.
+     *
+     * Note: If the selection is placed in an empty block, the range in that block will be returned. If that range
+     * is then passed to {@link module:engine/model/model~Model#insertContent}, the block will be fully replaced
+     * by the inserted widget block.
+     *
+     * @internal
+     * @param selection The selection based on which the insertion position should be calculated.
+     * @param place The place where to look for optimal insertion range.
+     * The `auto` value will determine itself the best position for insertion.
+     * The `before` value will try to find a position before selection.
+     * The `after` value will try to find a position after selection.
+     * @returns The optimal range.
+     */
+    findOptimalInsertionRange(selection, place) {
+        const selectedElement = selection.getSelectedElement();
+        if (selectedElement && this.isObject(selectedElement) && !this.isInline(selectedElement)) {
+            if (place == 'before' || place == 'after') {
+                return new Range(Position._createAt(selectedElement, place));
+            }
+            return Range._createOn(selectedElement);
+        }
+        const firstBlock = first(selection.getSelectedBlocks());
+        // There are no block elements within ancestors (in the current limit element).
+        if (!firstBlock) {
+            return new Range(selection.focus);
+        }
+        // If inserting into an empty block – return position in that block. It will get
+        // replaced with the image by insertContent(). #42.
+        if (firstBlock.isEmpty) {
+            return new Range(Position._createAt(firstBlock, 0));
+        }
+        const positionAfter = Position._createAfter(firstBlock);
+        // If selection is at the end of the block - return position after the block.
+        if (selection.focus.isTouching(positionAfter)) {
+            return new Range(positionAfter);
+        }
+        // Otherwise, return position before the block.
+        return new Range(Position._createBefore(firstBlock));
+    }
 }
 /**
- * A schema context — a list of ancestors of a given position in the document.
+ * A schema context – a list of ancestors of a given position in the document.
  *
  * Considering such position:
  *

package/src/model/selection.d.ts

@@ -1,17 +1,17 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 /**
  * @module engine/model/selection
  */
-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';
+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';
 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

@@ -1,14 +1,14 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 /**
  * @module engine/model/selection
  */
-import TypeCheckable from './typecheckable';
-import Node from './node';
-import Position from './position';
-import Range from './range';
+import TypeCheckable from './typecheckable.js';
+import Node from './node.js';
+import Position from './position.js';
+import Range from './range.js';
 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

@@ -1,11 +1,11 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 /**
  * @module engine/model/text
  */
-import Node, { type NodeAttributes } from './node';
+import Node, { type NodeAttributes } from './node.js';
 /**
  * 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

@@ -1,11 +1,11 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 /**
  * @module engine/model/text
  */
-import Node from './node';
+import Node from './node.js';
 // @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

@@ -1,15 +1,15 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 /**
  * @module engine/model/textproxy
  */
-import TypeCheckable from './typecheckable';
-import type DocumentFragment from './documentfragment';
-import type Element from './element';
-import type Node from './node';
-import type Text from './text';
+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';
 /**
  * `TextProxy` represents a part of {@link module:engine/model/text~Text text node}.
  *

package/src/model/textproxy.js

@@ -1,11 +1,11 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 /**
  * @module engine/model/textproxy
  */
-import TypeCheckable from './typecheckable';
+import TypeCheckable from './typecheckable.js';
 import { CKEditorError } from '@ckeditor/ckeditor5-utils';
 // @if CK_DEBUG_ENGINE // const { convertMapToStringifiedObject } = require( '../dev-utils/utils' );
 /**

package/src/model/treewalker.d.ts

@@ -1,10 +1,10 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2024, 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';
-import type Item from './item';
-import type Range from './range';
+import { default as Position } from './position.js';
+import type Item from './item.js';
+import type Range from './range.js';
 /**
  * Position iterator class. It allows to iterate forward and backward over the document.
  */

package/src/model/treewalker.js

@@ -1,14 +1,14 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 /**
  * @module engine/model/treewalker
  */
-import Element from './element';
-import { default as Position, getTextNodeAtPosition, getNodeAfterPosition, getNodeBeforePosition } from './position';
-import Text from './text';
-import TextProxy from './textproxy';
+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 { CKEditorError } from '@ckeditor/ckeditor5-utils';
 /**
  * Position iterator class. It allows to iterate forward and backward over the document.

package/src/model/typecheckable.d.ts

@@ -1,23 +1,23 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 /**
  * @module engine/model/typecheckable
  */
-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';
+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';
 export default abstract class TypeCheckable {
     /**
      * Checks whether the object is of type {@link module:engine/model/node~Node} or its subclass.

package/src/model/typecheckable.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 export default class TypeCheckable {

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

@@ -1,11 +1,11 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2024, 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';
-import type Position from '../position';
-import type Schema from '../schema';
-import type Writer from '../writer';
+import type Node from '../node.js';
+import type Position from '../position.js';
+import type Schema from '../schema.js';
+import type Writer from '../writer.js';
 /**
  * @module engine/model/utils/autoparagraphing
  */

package/src/model/utils/autoparagraphing.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 /**

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

@@ -1,13 +1,13 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 /**
  * @module engine/model/utils/deletecontent
  */
-import DocumentSelection from '../documentselection';
-import type Model from '../model';
-import type Selection from '../selection';
+import DocumentSelection from '../documentselection.js';
+import type Model from '../model.js';
+import type Selection from '../selection.js';
 /**
  * Deletes content of the selection and merge siblings. The resulting selection is always collapsed.
  *

package/src/model/utils/deletecontent.js

@@ -1,13 +1,13 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 /**
  * @module engine/model/utils/deletecontent
  */
-import DocumentSelection from '../documentselection';
-import LivePosition from '../liveposition';
-import Range from '../range';
+import DocumentSelection from '../documentselection.js';
+import LivePosition from '../liveposition.js';
+import Range from '../range.js';
 /**
  * Deletes content of the selection and merge siblings. The resulting selection is always collapsed.
  *

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

@@ -1,11 +1,11 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2024, 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';
-import type DocumentSelection from '../documentselection';
-import type Model from '../model';
-import type Selection from '../selection';
+import type DocumentFragment from '../documentfragment.js';
+import type DocumentSelection from '../documentselection.js';
+import type Model from '../model.js';
+import type Selection from '../selection.js';
 /**
  * @module engine/model/utils/getselectedcontent
  */

package/src/model/utils/getselectedcontent.js

@@ -1,5 +1,5 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 /**

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

@@ -1,16 +1,16 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 /**
  * @module engine/model/utils/insertcontent
  */
-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';
+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';
 /**
  * Inserts content into the editor (specified selection) as one would expect the paste functionality to work.
  *

package/src/model/utils/insertcontent.js

@@ -1,16 +1,16 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 /**
  * @module engine/model/utils/insertcontent
  */
-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 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 { 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

@@ -1,12 +1,15 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2024, 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';
-import type Selection from '../selection';
-import type Element from '../element';
-import type Model from '../model';
-import type Range from '../range';
+/**
+ * @module engine/model/utils/insertobject
+ */
+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';
 /**
  * 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

@@ -1,11 +1,7 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
-/**
- * @module engine/model/utils/insertobject
- */
-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.
@@ -55,7 +51,7 @@ export default function insertObject(model, object, selectable, options = {}) {
     // Adjust the insertion selection.
     let insertionSelection = originalSelection;
     if (options.findOptimalPosition && model.schema.isBlock(object)) {
-        insertionSelection = model.createSelection(findOptimalInsertionRange(originalSelection, model, options.findOptimalPosition));
+        insertionSelection = model.createSelection(model.schema.findOptimalInsertionRange(originalSelection, options.findOptimalPosition));
     }
     // Collect attributes to be copied on the inserted object.
     const firstSelectedBlock = first(originalSelection.getSelectedBlocks());

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

@@ -1,13 +1,13 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 /**
  * @module engine/model/utils/modifyselection
  */
-import DocumentSelection from '../documentselection';
-import type Model from '../model';
-import type Selection from '../selection';
+import DocumentSelection from '../documentselection.js';
+import type Model from '../model.js';
+import type Selection from '../selection.js';
 /**
  * Modifies the selection. Currently, the supported modifications are:
  *

package/src/model/utils/modifyselection.js

@@ -1,14 +1,14 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2024, CKSource Holding sp. z o.o. All rights reserved.
  * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
  */
 /**
  * @module engine/model/utils/modifyselection
  */
-import DocumentSelection from '../documentselection';
-import Position from '../position';
-import Range from '../range';
-import TreeWalker from '../treewalker';
+import DocumentSelection from '../documentselection.js';
+import Position from '../position.js';
+import Range from '../range.js';
+import TreeWalker from '../treewalker.js';
 import { isInsideSurrogatePair, isInsideCombinedSymbol, isInsideEmojiSequence } from '@ckeditor/ckeditor5-utils';
 const wordBoundaryCharacters = ' ,.?!:;"-()';
 /**

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

@@ -1,10 +1,10 @@
 /**
- * @license Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * @license Copyright (c) 2003-2024, 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';
-import type Model from '../model';
-import type Schema from '../schema';
+import Range from '../range.js';
+import type Model from '../model.js';
+import type Schema from '../schema.js';
 /**
  * Injects selection post-fixer to the model.
  *