@ckeditor/ckeditor5-engine 40.2.0 → 41.0.0

package/src/view/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/view/treewalker
  */
-import Element from './element';
-import Text from './text';
-import TextProxy from './textproxy';
-import Position from './position';
+import Element from './element.js';
+import Text from './text.js';
+import TextProxy from './textproxy.js';
+import Position from './position.js';
 import { CKEditorError } from '@ckeditor/ckeditor5-utils';
 /**
  * Position iterator class. It allows to iterate forward and backward over the document.

package/src/view/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
  */
-import type AttributeElement from './attributeelement';
-import type ContainerElement from './containerelement';
-import type DocumentFragment from './documentfragment';
-import type DocumentSelection from './documentselection';
-import type EditableElement from './editableelement';
-import type Element from './element';
-import type EmptyElement from './emptyelement';
-import type Node from './node';
-import type Position from './position';
-import type Range from './range';
-import type RawElement from './rawelement';
-import type RootEditableElement from './rooteditableelement';
-import type Selection from './selection';
-import type Text from './text';
-import type TextProxy from './textproxy';
-import type UIElement from './uielement';
+import type AttributeElement from './attributeelement.js';
+import type ContainerElement from './containerelement.js';
+import type DocumentFragment from './documentfragment.js';
+import type DocumentSelection from './documentselection.js';
+import type EditableElement from './editableelement.js';
+import type Element from './element.js';
+import type EmptyElement from './emptyelement.js';
+import type Node from './node.js';
+import type Position from './position.js';
+import type Range from './range.js';
+import type RawElement from './rawelement.js';
+import type RootEditableElement from './rooteditableelement.js';
+import type Selection from './selection.js';
+import type Text from './text.js';
+import type TextProxy from './textproxy.js';
+import type UIElement from './uielement.js';
 /**
  * @module engine/view/typecheckable
  */

package/src/view/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
  */
 /**

package/src/view/uielement.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/view/uielement
  */
-import Element, { type ElementAttributes } from './element';
-import Node from './node';
-import type View from './view';
-import type Document from './document';
-import type DomConverter from './domconverter';
-import type Item from './item';
+import Element, { type ElementAttributes } from './element.js';
+import Node from './node.js';
+import type View from './view.js';
+import type Document from './document.js';
+import type DomConverter from './domconverter.js';
+import type Item from './item.js';
 type DomDocument = globalThis.Document;
 type DomElement = globalThis.HTMLElement;
 /**

package/src/view/uielement.js

@@ -1,12 +1,12 @@
 /**
- * @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/view/uielement
  */
-import Element from './element';
-import Node from './node';
+import Element from './element.js';
+import Node from './node.js';
 import { CKEditorError, keyCodes } from '@ckeditor/ckeditor5-utils';
 /**
  * UI element class. It should be used to represent editing UI which needs to be injected into the editing view

package/src/view/upcastwriter.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/view/upcastwriter
  */
-import DocumentFragment from './documentfragment';
-import Element, { type ElementAttributes } from './element';
-import Text from './text';
-import Position, { type PositionOffset } from './position';
-import Range from './range';
-import Selection, { type PlaceOrOffset, type Selectable, type SelectionOptions } from './selection';
-import type Document from './document';
-import type Item from './item';
-import type Node from './node';
+import DocumentFragment from './documentfragment.js';
+import Element, { type ElementAttributes } from './element.js';
+import Text from './text.js';
+import Position, { type PositionOffset } from './position.js';
+import Range from './range.js';
+import Selection, { type PlaceOrOffset, type Selectable, type SelectionOptions } from './selection.js';
+import type Document from './document.js';
+import type Item from './item.js';
+import type Node from './node.js';
 /**
  * View upcast writer. It provides a set of methods used to manipulate non-semantic view trees.
  *

package/src/view/upcastwriter.js

@@ -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/view/upcastwriter
  */
-import DocumentFragment from './documentfragment';
-import Element from './element';
-import Text from './text';
+import DocumentFragment from './documentfragment.js';
+import Element from './element.js';
+import Text from './text.js';
 import { isPlainObject } from 'lodash-es';
-import Position from './position';
-import Range from './range';
-import Selection from './selection';
+import Position from './position.js';
+import Range from './range.js';
+import Selection from './selection.js';
 /**
  * View upcast writer. It provides a set of methods used to manipulate non-semantic view trees.
  *

package/src/view/view.d.ts

@@ -1,31 +1,31 @@
 /**
- * @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/view/view
  */
-import Document from './document';
-import DowncastWriter from './downcastwriter';
-import Renderer from './renderer';
-import DomConverter from './domconverter';
-import Position, { type PositionOffset } from './position';
-import Range from './range';
-import Selection, { type PlaceOrOffset, type Selectable, type SelectionOptions } from './selection';
-import type { default as Observer, ObserverConstructor } from './observer/observer';
-import type { StylesProcessor } from './stylesmap';
-import type Element from './element';
-import type { default as Node } from './node';
-import type Item from './item';
-import KeyObserver from './observer/keyobserver';
-import FakeSelectionObserver from './observer/fakeselectionobserver';
-import MutationObserver from './observer/mutationobserver';
-import SelectionObserver from './observer/selectionobserver';
-import FocusObserver from './observer/focusobserver';
-import CompositionObserver from './observer/compositionobserver';
-import InputObserver from './observer/inputobserver';
-import ArrowKeysObserver from './observer/arrowkeysobserver';
-import TabObserver from './observer/tabobserver';
+import Document from './document.js';
+import DowncastWriter from './downcastwriter.js';
+import Renderer from './renderer.js';
+import DomConverter from './domconverter.js';
+import Position, { type PositionOffset } from './position.js';
+import Range from './range.js';
+import Selection, { type PlaceOrOffset, type Selectable, type SelectionOptions } from './selection.js';
+import type { default as Observer, ObserverConstructor } from './observer/observer.js';
+import type { StylesProcessor } from './stylesmap.js';
+import type Element from './element.js';
+import type { default as Node } from './node.js';
+import type Item from './item.js';
+import KeyObserver from './observer/keyobserver.js';
+import FakeSelectionObserver from './observer/fakeselectionobserver.js';
+import MutationObserver from './observer/mutationobserver.js';
+import SelectionObserver from './observer/selectionobserver.js';
+import FocusObserver from './observer/focusobserver.js';
+import CompositionObserver from './observer/compositionobserver.js';
+import InputObserver from './observer/inputobserver.js';
+import ArrowKeysObserver from './observer/arrowkeysobserver.js';
+import TabObserver from './observer/tabobserver.js';
 type IfTrue<T> = T extends true ? true : never;
 type DomRange = globalThis.Range;
 declare const View_base: {

package/src/view/view.js

@@ -1,29 +1,29 @@
 /**
- * @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/view/view
  */
-import Document from './document';
-import DowncastWriter from './downcastwriter';
-import Renderer from './renderer';
-import DomConverter from './domconverter';
-import Position from './position';
-import Range from './range';
-import Selection from './selection';
-import KeyObserver from './observer/keyobserver';
-import FakeSelectionObserver from './observer/fakeselectionobserver';
-import MutationObserver from './observer/mutationobserver';
-import SelectionObserver from './observer/selectionobserver';
-import FocusObserver from './observer/focusobserver';
-import CompositionObserver from './observer/compositionobserver';
-import InputObserver from './observer/inputobserver';
-import ArrowKeysObserver from './observer/arrowkeysobserver';
-import TabObserver from './observer/tabobserver';
+import Document from './document.js';
+import DowncastWriter from './downcastwriter.js';
+import Renderer from './renderer.js';
+import DomConverter from './domconverter.js';
+import Position from './position.js';
+import Range from './range.js';
+import Selection from './selection.js';
+import KeyObserver from './observer/keyobserver.js';
+import FakeSelectionObserver from './observer/fakeselectionobserver.js';
+import MutationObserver from './observer/mutationobserver.js';
+import SelectionObserver from './observer/selectionobserver.js';
+import FocusObserver from './observer/focusobserver.js';
+import CompositionObserver from './observer/compositionobserver.js';
+import InputObserver from './observer/inputobserver.js';
+import ArrowKeysObserver from './observer/arrowkeysobserver.js';
+import TabObserver from './observer/tabobserver.js';
 import { CKEditorError, env, ObservableMixin, scrollViewportToShowTarget } from '@ckeditor/ckeditor5-utils';
-import { injectUiElementHandling } from './uielement';
-import { injectQuirksHandling } from './filler';
+import { injectUiElementHandling } from './uielement.js';
+import { injectQuirksHandling } from './filler.js';
 import { cloneDeep } from 'lodash-es';
 /**
  * Editor's view controller class. Its main responsibility is DOM - View management for editing purposes, to provide

package/theme/placeholder.css

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * 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/theme/renderer.css

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2003-2023, CKSource Holding sp. z o.o. All rights reserved.
+ * 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/findoptimalinsertionrange.d.ts

@@ -1,32 +0,0 @@
-/**
- * @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';
-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.
- *
- * 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.
- *
- * **Note:** Use {@link module:widget/utils#findOptimalInsertionRange} instead of this function outside engine.
- * This function is only exposed to be used by {@link module:widget/utils#findOptimalInsertionRange findOptimalInsertionRange()}
- * in the `widget` package and inside the `engine` package.
- *
- * @param selection The selection based on which the insertion position should be calculated.
- * @param model Model instance.
- * @param place The place where to look for optimal insertion range.
- * The default `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.
- */
-export declare function findOptimalInsertionRange(selection: Selection | DocumentSelection, model: Model, place?: 'auto' | 'before' | 'after'): Range;

package/src/model/utils/findoptimalinsertionrange.js

@@ -1,57 +0,0 @@
-/**
- * @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
- */
-/**
- * @module engine/model/utils/findoptimalinsertionrange
- */
-import { first } from '@ckeditor/ckeditor5-utils';
-/**
- * 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.
- *
- * **Note:** Use {@link module:widget/utils#findOptimalInsertionRange} instead of this function outside engine.
- * This function is only exposed to be used by {@link module:widget/utils#findOptimalInsertionRange findOptimalInsertionRange()}
- * in the `widget` package and inside the `engine` package.
- *
- * @param selection The selection based on which the insertion position should be calculated.
- * @param model Model instance.
- * @param place The place where to look for optimal insertion range.
- * The default `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.
- */
-export function findOptimalInsertionRange(selection, model, place = 'auto') {
-    const selectedElement = selection.getSelectedElement();
-    if (selectedElement && model.schema.isObject(selectedElement) && !model.schema.isInline(selectedElement)) {
-        if (place == 'before' || place == 'after') {
-            return model.createRange(model.createPositionAt(selectedElement, place));
-        }
-        return model.createRangeOn(selectedElement);
-    }
-    const firstBlock = first(selection.getSelectedBlocks());
-    // There are no block elements within ancestors (in the current limit element).
-    if (!firstBlock) {
-        return model.createRange(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 model.createRange(model.createPositionAt(firstBlock, 0));
-    }
-    const positionAfter = model.createPositionAfter(firstBlock);
-    // If selection is at the end of the block - return position after the block.
-    if (selection.focus.isTouching(positionAfter)) {
-        return model.createRange(positionAfter);
-    }
-    // Otherwise, return position before the block.
-    return model.createRange(model.createPositionBefore(firstBlock));
-}