@ckeditor/ckeditor5-engine 44.1.0 → 44.2.0-alpha.0

package/dist/view/range.d.ts

@@ -1,283 +0,0 @@
-/**
- * @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
- */
-/**
- * @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-licensing-options
- */
-/**
- * @module engine/view/range
- */
-import TypeCheckable from './typecheckable.js';
-import Position from './position.js';
-import type DocumentFragment from './documentfragment.js';
-import type Element from './element.js';
-import type Item from './item.js';
-import type Node from './node.js';
-import { default as TreeWalker, type TreeWalkerValue, type TreeWalkerOptions } from './treewalker.js';
-/**
- * Range in the view tree. A range is represented by its start and end {@link module:engine/view/position~Position positions}.
- *
- * In order to create a new position instance use the `createPosition*()` factory methods available in:
- *
- * * {@link module:engine/view/view~View}
- * * {@link module:engine/view/downcastwriter~DowncastWriter}
- * * {@link module:engine/view/upcastwriter~UpcastWriter}
- */
-export default class Range extends TypeCheckable implements Iterable<TreeWalkerValue> {
-    /**
-     * Start position.
-     */
-    readonly start: Position;
-    /**
-     * End position.
-     */
-    readonly end: Position;
-    /**
-     * Creates a range spanning from `start` position to `end` position.
-     *
-     * **Note:** Constructor creates it's own {@link module:engine/view/position~Position} instances basing on passed values.
-     *
-     * @param start Start position.
-     * @param end End position. If not set, range will be collapsed at the `start` position.
-     */
-    constructor(start: Position, end?: Position | null);
-    /**
-     * Iterable interface.
-     *
-     * Iterates over all {@link module:engine/view/item~Item view items} that are in this range and returns
-     * them together with additional information like length or {@link module:engine/view/position~Position positions},
-     * grouped as {@link module:engine/view/treewalker~TreeWalkerValue}.
-     *
-     * This iterator uses {@link module:engine/view/treewalker~TreeWalker TreeWalker} with `boundaries` set to this range and
-     * `ignoreElementEnd` option
-     * set to `true`.
-     */
-    [Symbol.iterator](): IterableIterator<TreeWalkerValue>;
-    /**
-     * Returns whether the range is collapsed, that is it start and end positions are equal.
-     */
-    get isCollapsed(): boolean;
-    /**
-     * Returns whether this range is flat, that is if {@link module:engine/view/range~Range#start start} position and
-     * {@link module:engine/view/range~Range#end end} position are in the same {@link module:engine/view/position~Position#parent parent}.
-     */
-    get isFlat(): boolean;
-    /**
-     * Range root element.
-     */
-    get root(): Node | DocumentFragment;
-    /**
-     * Creates a maximal range that has the same content as this range but is expanded in both ways (at the beginning
-     * and at the end).
-     *
-     * For example:
-     *
-     * ```html
-     * <p>Foo</p><p><b>{Bar}</b></p> -> <p>Foo</p>[<p><b>Bar</b>]</p>
-     * <p><b>foo</b>{bar}<span></span></p> -> <p><b>foo[</b>bar<span></span>]</p>
-     * ```
-     *
-     * Note that in the sample above:
-     *
-     * - `<p>` have type of {@link module:engine/view/containerelement~ContainerElement},
-     * - `<b>` have type of {@link module:engine/view/attributeelement~AttributeElement},
-     * - `<span>` have type of {@link module:engine/view/uielement~UIElement}.
-     *
-     * @returns Enlarged range.
-     */
-    getEnlarged(): Range;
-    /**
-     * Creates a minimum range that has the same content as this range but is trimmed in both ways (at the beginning
-     * and at the end).
-     *
-     * For example:
-     *
-     * ```html
-     * <p>Foo</p>[<p><b>Bar</b>]</p> -> <p>Foo</p><p><b>{Bar}</b></p>
-     * <p><b>foo[</b>bar<span></span>]</p> -> <p><b>foo</b>{bar}<span></span></p>
-     * ```
-     *
-     * Note that in the sample above:
-     *
-     * - `<p>` have type of {@link module:engine/view/containerelement~ContainerElement},
-     * - `<b>` have type of {@link module:engine/view/attributeelement~AttributeElement},
-     * - `<span>` have type of {@link module:engine/view/uielement~UIElement}.
-     *
-     * @returns Shrunk range.
-     */
-    getTrimmed(): Range;
-    /**
-     * Two ranges are equal if their start and end positions are equal.
-     *
-     * @param otherRange Range to compare with.
-     * @returns `true` if ranges are equal, `false` otherwise
-     */
-    isEqual(otherRange: Range): boolean;
-    /**
-     * Checks whether this range contains given {@link module:engine/view/position~Position position}.
-     *
-     * @param position Position to check.
-     * @returns `true` if given {@link module:engine/view/position~Position position} is contained in this range, `false` otherwise.
-     */
-    containsPosition(position: Position): boolean;
-    /**
-     * Checks whether this range contains given {@link module:engine/view/range~Range range}.
-     *
-     * @param otherRange Range to check.
-     * @param loose Whether the check is loose or strict. If the check is strict (`false`), compared range cannot
-     * start or end at the same position as this range boundaries. If the check is loose (`true`), compared range can start, end or
-     * even be equal to this range. Note that collapsed ranges are always compared in strict mode.
-     * @returns `true` if given {@link module:engine/view/range~Range range} boundaries are contained by this range, `false`
-     * otherwise.
-     */
-    containsRange(otherRange: Range, loose?: boolean): boolean;
-    /**
-     * Computes which part(s) of this {@link module:engine/view/range~Range range} is not a part of given
-     * {@link module:engine/view/range~Range range}.
-     * Returned array contains zero, one or two {@link module:engine/view/range~Range ranges}.
-     *
-     * Examples:
-     *
-     * ```ts
-     * let foo = downcastWriter.createText( 'foo' );
-     * let img = downcastWriter.createContainerElement( 'img' );
-     * let bar = downcastWriter.createText( 'bar' );
-     * let p = downcastWriter.createContainerElement( 'p', null, [ foo, img, bar ] );
-     *
-     * let range = view.createRange( view.createPositionAt( foo, 2 ), view.createPositionAt( bar, 1 ); // "o", img, "b" are in range.
-     * let otherRange = view.createRange( // "oo", img, "ba" are in range.
-     * 	view.createPositionAt( foo, 1 ),
-     * 	view.createPositionAt( bar, 2 )
-     * );
-     * let transformed = range.getDifference( otherRange );
-     * // transformed array has no ranges because `otherRange` contains `range`
-     *
-     * otherRange = view.createRange( view.createPositionAt( foo, 1 ), view.createPositionAt( p, 2 ); // "oo", img are in range.
-     * transformed = range.getDifference( otherRange );
-     * // transformed array has one range: from ( p, 2 ) to ( bar, 1 )
-     *
-     * otherRange = view.createRange( view.createPositionAt( p, 1 ), view.createPositionAt( p, 2 ) ); // img is in range.
-     * transformed = range.getDifference( otherRange );
-     * // transformed array has two ranges: from ( foo, 1 ) to ( p, 1 ) and from ( p, 2 ) to ( bar, 1 )
-     * ```
-     *
-     * @param otherRange Range to differentiate against.
-     * @returns The difference between ranges.
-     */
-    getDifference(otherRange: Range): Array<Range>;
-    /**
-     * Returns an intersection of this {@link module:engine/view/range~Range range} and given {@link module:engine/view/range~Range range}.
-     * Intersection is a common part of both of those ranges. If ranges has no common part, returns `null`.
-     *
-     * Examples:
-     *
-     * ```ts
-     * let foo = downcastWriter.createText( 'foo' );
-     * let img = downcastWriter.createContainerElement( 'img' );
-     * let bar = downcastWriter.createText( 'bar' );
-     * let p = downcastWriter.createContainerElement( 'p', null, [ foo, img, bar ] );
-     *
-     * let range = view.createRange( view.createPositionAt( foo, 2 ), view.createPositionAt( bar, 1 ); // "o", img, "b" are in range.
-     * let otherRange = view.createRange( view.createPositionAt( foo, 1 ), view.createPositionAt( p, 2 ); // "oo", img are in range.
-     * let transformed = range.getIntersection( otherRange ); // range from ( foo, 1 ) to ( p, 2 ).
-     *
-     * otherRange = view.createRange( view.createPositionAt( bar, 1 ), view.createPositionAt( bar, 3 ); "ar" is in range.
-     * transformed = range.getIntersection( otherRange ); // null - no common part.
-     * ```
-     *
-     * @param otherRange Range to check for intersection.
-     * @returns A common part of given ranges or `null` if ranges have no common part.
-     */
-    getIntersection(otherRange: Range): Range | null;
-    /**
-     * Creates a {@link module:engine/view/treewalker~TreeWalker TreeWalker} instance with this range as a boundary.
-     *
-     * @param options Object with configuration options. See {@link module:engine/view/treewalker~TreeWalker}.
-     */
-    getWalker(options?: TreeWalkerOptions): TreeWalker;
-    /**
-     * Returns a {@link module:engine/view/node~Node} or {@link module:engine/view/documentfragment~DocumentFragment}
-     * which is a common ancestor of range's both ends (in which the entire range is contained).
-     */
-    getCommonAncestor(): Node | DocumentFragment | null;
-    /**
-     * Returns an {@link module:engine/view/element~Element Element} contained by the range.
-     * The element will be returned when it is the **only** node within the range and **fully–contained**
-     * at the same time.
-     */
-    getContainedElement(): Element | null;
-    /**
-     * Clones this range.
-     */
-    clone(): Range;
-    /**
-     * Returns an iterator that iterates over all {@link module:engine/view/item~Item view items} that are in this range and returns
-     * them.
-     *
-     * This method uses {@link module:engine/view/treewalker~TreeWalker} with `boundaries` set to this range and `ignoreElementEnd` option
-     * set to `true`. However it returns only {@link module:engine/view/item~Item items},
-     * not {@link module:engine/view/treewalker~TreeWalkerValue}.
-     *
-     * You may specify additional options for the tree walker. See {@link module:engine/view/treewalker~TreeWalker} for
-     * a full list of available options.
-     *
-     * @param options Object with configuration options. See {@link module:engine/view/treewalker~TreeWalker}.
-     */
-    getItems(options?: TreeWalkerOptions): IterableIterator<Item>;
-    /**
-     * Returns an iterator that iterates over all {@link module:engine/view/position~Position positions} that are boundaries or
-     * contained in this range.
-     *
-     * This method uses {@link module:engine/view/treewalker~TreeWalker} with `boundaries` set to this range. However it returns only
-     * {@link module:engine/view/position~Position positions}, not {@link module:engine/view/treewalker~TreeWalkerValue}.
-     *
-     * You may specify additional options for the tree walker. See {@link module:engine/view/treewalker~TreeWalker} for
-     * a full list of available options.
-     *
-     * @param options Object with configuration options. See {@link module:engine/view/treewalker~TreeWalker}.
-     */
-    getPositions(options?: TreeWalkerOptions): IterableIterator<Position>;
-    /**
-     * Checks and returns whether this range intersects with the given range.
-     *
-     * @param otherRange Range to compare with.
-     * @returns True if ranges intersect.
-     */
-    isIntersecting(otherRange: Range): boolean;
-    /**
-     * Creates a range from the given parents and offsets.
-     *
-     * @internal
-     * @param startElement Start position parent element.
-     * @param startOffset Start position offset.
-     * @param endElement End position parent element.
-     * @param endOffset End position offset.
-     * @returns Created range.
-     */
-    static _createFromParentsAndOffsets(startElement: Element | DocumentFragment, startOffset: number, endElement: Element | DocumentFragment, endOffset: number): Range;
-    /**
-     * Creates a new range, spreading from specified {@link module:engine/view/position~Position position} to a position moved by
-     * given `shift`. If `shift` is a negative value, shifted position is treated as the beginning of the range.
-     *
-     * @internal
-     * @param position Beginning of the range.
-     * @param shift How long the range should be.
-     */
-    static _createFromPositionAndShift(position: Position, shift: number): Range;
-    /**
-     * Creates a range inside an {@link module:engine/view/element~Element element} which starts before the first child of
-     * that element and ends after the last child of that element.
-     *
-     * @internal
-     * @param element Element which is a parent for the range.
-     */
-    static _createIn(element: Element | DocumentFragment): Range;
-    /**
-     * Creates a range that starts before given {@link module:engine/view/item~Item view item} and ends after it.
-     *
-     * @internal
-     */
-    static _createOn(item: Item): Range;
-}

package/dist/view/rawelement.d.ts

@@ -1,77 +0,0 @@
-/**
- * @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
- */
-/**
- * @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-licensing-options
- */
-/**
- * @module engine/view/rawelement
- */
-import Element, { type ElementAttributes } from './element.js';
-import Node from './node.js';
-import type Document from './document.js';
-import type DomConverter from './domconverter.js';
-import type Item from './item.js';
-type DomElement = globalThis.HTMLElement;
-/**
- * The raw element class.
- *
- * The raw elements work as data containers ("wrappers", "sandboxes") but their children are not managed or
- * even recognized by the editor. This encapsulation allows integrations to maintain custom DOM structures
- * in the editor content without, for instance, worrying about compatibility with other editor features.
- * Raw elements are a perfect tool for integration with external frameworks and data sources.
- *
- * Unlike {@link module:engine/view/uielement~UIElement UI elements}, raw elements act like real editor
- * content (similar to {@link module:engine/view/containerelement~ContainerElement} or
- * {@link module:engine/view/emptyelement~EmptyElement}), they are considered by the editor selection and
- * {@link module:widget/utils~toWidget they can work as widgets}.
- *
- * To create a new raw element, use the
- * {@link module:engine/view/downcastwriter~DowncastWriter#createRawElement `downcastWriter#createRawElement()`} method.
- */
-export default class RawElement extends Element {
-    /**
-     * Creates a new instance of a raw element.
-     *
-     * Throws the `view-rawelement-cannot-add` {@link module:utils/ckeditorerror~CKEditorError CKEditorError} when the `children`
-     * parameter is passed to inform that the usage of `RawElement` is incorrect (adding child nodes to `RawElement` is forbidden).
-     *
-     * @see module:engine/view/downcastwriter~DowncastWriter#createRawElement
-     * @internal
-     * @param document The document instance to which this element belongs.
-     * @param name Node name.
-     * @param attrs Collection of attributes.
-     * @param children A list of nodes to be inserted into created element.
-     */
-    constructor(document: Document, name: string, attrs?: ElementAttributes, children?: Node | Iterable<Node>);
-    /**
-     * Overrides the {@link module:engine/view/element~Element#_insertChild} method.
-     * Throws the `view-rawelement-cannot-add` {@link module:utils/ckeditorerror~CKEditorError CKEditorError} to prevent
-     * adding any child nodes to a raw element.
-     *
-     * @internal
-     */
-    _insertChild(index: number, items: Item | Iterable<Item>): number;
-    /**
-     * This allows rendering the children of a {@link module:engine/view/rawelement~RawElement} on the DOM level.
-     * This method is called by the {@link module:engine/view/domconverter~DomConverter} with the raw DOM element
-     * passed as an argument, leaving the number and shape of the children up to the integrator.
-     *
-     * This method **must be defined** for the raw element to work:
-     *
-     * ```ts
-     * const myRawElement = downcastWriter.createRawElement( 'div' );
-     *
-     * myRawElement.render = function( domElement, domConverter ) {
-     * 	domConverter.setContentOf( domElement, '<b>This is the raw content of myRawElement.</b>' );
-     * };
-     * ```
-     *
-     * @param domElement The native DOM element representing the raw view element.
-     * @param domConverter Instance of the DomConverter used to optimize the output.
-     */
-    render(domElement: DomElement, domConverter: DomConverter): void;
-}
-export {};

package/dist/view/renderer.d.ts

@@ -1,281 +0,0 @@
-/**
- * @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
- */
-/**
- * @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-licensing-options
- */
-import type { ChangeType } from './document.js';
-import type DocumentSelection from './documentselection.js';
-import type DomConverter from './domconverter.js';
-import type ViewElement from './element.js';
-import type ViewNode from './node.js';
-import '../../theme/renderer.css';
-type DomDocument = globalThis.Document;
-declare const Renderer_base: {
-    new (): import("@ckeditor/ckeditor5-utils").Observable;
-    prototype: import("@ckeditor/ckeditor5-utils").Observable;
-};
-/**
- * Renderer is responsible for updating the DOM structure and the DOM selection based on
- * the {@link module:engine/view/renderer~Renderer#markToSync information about updated view nodes}.
- * In other words, it renders the view to the DOM.
- *
- * Its main responsibility is to make only the necessary, minimal changes to the DOM. However, unlike in many
- * virtual DOM implementations, the primary reason for doing minimal changes is not the performance but ensuring
- * that native editing features such as text composition, autocompletion, spell checking, selection's x-index are
- * affected as little as possible.
- *
- * Renderer uses {@link module:engine/view/domconverter~DomConverter} to transform view nodes and positions
- * to and from the DOM.
- */
-export default class Renderer extends /* #__PURE__ */ Renderer_base {
-    /**
-     * Set of DOM Documents instances.
-     */
-    readonly domDocuments: Set<DomDocument>;
-    /**
-     * Converter instance.
-     */
-    readonly domConverter: DomConverter;
-    /**
-     * Set of nodes which attributes changed and may need to be rendered.
-     */
-    readonly markedAttributes: Set<ViewElement>;
-    /**
-     * Set of elements which child lists changed and may need to be rendered.
-     */
-    readonly markedChildren: Set<ViewElement>;
-    /**
-     * Set of text nodes which text data changed and may need to be rendered.
-     */
-    readonly markedTexts: Set<ViewNode>;
-    /**
-     * View selection. Renderer updates DOM selection based on the view selection.
-     */
-    readonly selection: DocumentSelection;
-    /**
-     * Indicates if the view document is focused and selection can be rendered. Selection will not be rendered if
-     * this is set to `false`.
-     *
-     * @observable
-     */
-    readonly isFocused: boolean;
-    /**
-     * Indicates whether the user is making a selection in the document (e.g. holding the mouse button and moving the cursor).
-     * When they stop selecting, the property goes back to `false`.
-     *
-     * Note: In some browsers, the renderer will stop rendering the selection and inline fillers while the user is making
-     * a selection to avoid glitches in DOM selection
-     * (https://github.com/ckeditor/ckeditor5/issues/10562, https://github.com/ckeditor/ckeditor5/issues/10723).
-     *
-     * @observable
-     */
-    readonly isSelecting: boolean;
-    /**
-     * True if composition is in progress inside the document.
-     *
-     * This property is bound to the {@link module:engine/view/document~Document#isComposing `Document#isComposing`} property.
-     *
-     * @observable
-     */
-    readonly isComposing: boolean;
-    /**
-     * The text node in which the inline filler was rendered.
-     */
-    private _inlineFiller;
-    /**
-     * DOM element containing fake selection.
-     */
-    private _fakeSelectionContainer;
-    /**
-     * Creates a renderer instance.
-     *
-     * @param domConverter Converter instance.
-     * @param selection View selection.
-     */
-    constructor(domConverter: DomConverter, selection: DocumentSelection);
-    /**
-     * Marks a view node to be updated in the DOM by {@link #render `render()`}.
-     *
-     * Note that only view nodes whose parents have corresponding DOM elements need to be marked to be synchronized.
-     *
-     * @see #markedAttributes
-     * @see #markedChildren
-     * @see #markedTexts
-     *
-     * @param type Type of the change.
-     * @param node ViewNode to be marked.
-     */
-    markToSync(type: ChangeType, node: ViewNode): void;
-    /**
-     * Renders all buffered changes ({@link #markedAttributes}, {@link #markedChildren} and {@link #markedTexts}) and
-     * the current view selection (if needed) to the DOM by applying a minimal set of changes to it.
-     *
-     * Renderer tries not to break the text composition (e.g. IME) and x-index of the selection,
-     * so it does as little as it is needed to update the DOM.
-     *
-     * Renderer also handles {@link module:engine/view/filler fillers}. Especially, it checks if the inline filler is needed
-     * at the selection position and adds or removes it. To prevent breaking text composition inline filler will not be
-     * removed as long as the selection is in the text node which needed it at first.
-     */
-    render(): void;
-    /**
-     * Updates mappings of view element's children.
-     *
-     * Children that were replaced in the view structure by similar elements (same tag name) are treated as 'replaced'.
-     * This means that their mappings can be updated so the new view elements are mapped to the existing DOM elements.
-     * Thanks to that these elements do not need to be re-rendered completely.
-     *
-     * @param viewElement The view element whose children mappings will be updated.
-     */
-    private _updateChildrenMappings;
-    /**
-     * Updates mappings of a given view element.
-     *
-     * @param viewElement The view element whose mappings will be updated.
-     * @param domElement The DOM element representing the given view element.
-     */
-    private _updateElementMappings;
-    /**
-     * Gets the position of the inline filler based on the current selection.
-     * Here, we assume that we know that the filler is needed and
-     * {@link #_isSelectionInInlineFiller is at the selection position}, and, since it is needed,
-     * it is somewhere at the selection position.
-     *
-     * Note: The filler position cannot be restored based on the filler's DOM text node, because
-     * when this method is called (before rendering), the bindings will often be broken. View-to-DOM
-     * bindings are only dependable after rendering.
-     */
-    private _getInlineFillerPosition;
-    /**
-     * Returns `true` if the selection has not left the inline filler's text node.
-     * If it is `true`, it means that the filler had been added for a reason and the selection did not
-     * leave the filler's text node. For example, the user can be in the middle of a composition so it should not be touched.
-     *
-     * @returns `true` if the inline filler and selection are in the same place.
-     */
-    private _isSelectionInInlineFiller;
-    /**
-     * Removes the inline filler.
-     */
-    private _removeInlineFiller;
-    /**
-     * Checks if the inline {@link module:engine/view/filler filler} should be added.
-     *
-     * @returns `true` if the inline filler should be added.
-     */
-    private _needsInlineFillerAtSelection;
-    /**
-     * Checks if text needs to be updated and possibly updates it.
-     *
-     * @param viewText View text to update.
-     * @param options.inlineFillerPosition The position where the inline filler should be rendered.
-     */
-    private _updateText;
-    /**
-     * Checks if attribute list needs to be updated and possibly updates it.
-     *
-     * @param viewElement The view element to update.
-     */
-    private _updateAttrs;
-    /**
-     * Checks if elements child list needs to be updated and possibly updates it.
-     *
-     * Note that on Android, to reduce the risk of composition breaks, it tries to update data of an existing
-     * child text nodes instead of replacing them completely.
-     *
-     * @param viewElement View element to update.
-     * @param options.inlineFillerPosition The position where the inline filler should be rendered.
-     */
-    private _updateChildren;
-    /**
-     * Shorthand for diffing two arrays or node lists of DOM nodes.
-     *
-     * @param actualDomChildren Actual DOM children
-     * @param expectedDomChildren Expected DOM children.
-     * @returns The list of actions based on the {@link module:utils/diff~diff} function.
-     */
-    private _diffNodeLists;
-    /**
-     * Finds DOM nodes that were replaced with the similar nodes (same tag name) in the view. All nodes are compared
-     * within one `insert`/`delete` action group, for example:
-     *
-     * ```
-     * Actual DOM:		<p><b>Foo</b>Bar<i>Baz</i><b>Bax</b></p>
-     * Expected DOM:	<p>Bar<b>123</b><i>Baz</i><b>456</b></p>
-     * Input actions:	[ insert, insert, delete, delete, equal, insert, delete ]
-     * Output actions:	[ insert, replace, delete, equal, replace ]
-     * ```
-     *
-     * @param actions Actions array which is a result of the {@link module:utils/diff~diff} function.
-     * @param actualDom Actual DOM children
-     * @param expectedDom Expected DOM children.
-     * @param comparator A comparator function that should return `true` if the given node should be reused
-     * (either by the update of a text node data or an element children list for similar elements).
-     * @returns Actions array modified with the `update` actions.
-     */
-    private _findUpdateActions;
-    /**
-     * Checks if text needs to be updated and possibly updates it by removing and inserting only parts
-     * of the data from the existing text node to reduce impact on the IME composition.
-     *
-     * @param domText DOM text node to update.
-     * @param expectedText The expected data of a text node.
-     */
-    private _updateTextNode;
-    /**
-     * Part of the `_updateTextNode` method extracted for easier testing.
-     */
-    private _updateTextNodeInternal;
-    /**
-     * Marks text nodes to be synchronized.
-     *
-     * If a text node is passed, it will be marked. If an element is passed, all descendant text nodes inside it will be marked.
-     *
-     * @param viewNode View node to sync.
-     */
-    private _markDescendantTextToSync;
-    /**
-     * Checks if the selection needs to be updated and possibly updates it.
-     */
-    private _updateSelection;
-    /**
-     * Updates the fake selection.
-     *
-     * @param domRoot A valid DOM root where the fake selection container should be added.
-     */
-    private _updateFakeSelection;
-    /**
-     * Updates the DOM selection.
-     *
-     * @param domRoot A valid DOM root where the DOM selection should be rendered.
-     */
-    private _updateDomSelection;
-    /**
-     * Checks whether a given DOM selection needs to be updated.
-     *
-     * @param domSelection The DOM selection to check.
-     */
-    private _domSelectionNeedsUpdate;
-    /**
-     * Checks whether the fake selection needs to be updated.
-     *
-     * @param domRoot A valid DOM root where a new fake selection container should be added.
-     */
-    private _fakeSelectionNeedsUpdate;
-    /**
-     * Removes the DOM selection.
-     */
-    private _removeDomSelection;
-    /**
-     * Removes the fake selection.
-     */
-    private _removeFakeSelection;
-    /**
-     * Checks if focus needs to be updated and possibly updates it.
-     */
-    private _updateFocus;
-}
-export {};

package/dist/view/rooteditableelement.d.ts

@@ -1,45 +0,0 @@
-/**
- * @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
- */
-/**
- * @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-licensing-options
- */
-/**
- * @module engine/view/rooteditableelement
- */
-import EditableElement from './editableelement.js';
-import type Document from './document.js';
-/**
- * Class representing a single root in the data view. A root can be either {@link ~RootEditableElement#isReadOnly editable or read-only},
- * but in both cases it is called "an editable". Roots can contain other {@link module:engine/view/editableelement~EditableElement
- * editable elements} making them "nested editables".
- */
-export default class RootEditableElement extends EditableElement {
-    /**
-     * Creates root editable element.
-     *
-     * @param document The document instance to which this element belongs.
-     * @param name Node name.
-     */
-    constructor(document: Document, name: string);
-    /**
-     * Name of this root inside {@link module:engine/view/document~Document} that is an owner of this root. If no
-     * other name is set, `main` name is used.
-     *
-     * @readonly
-     */
-    get rootName(): string;
-    set rootName(rootName: string);
-    /**
-     * Overrides old element name and sets new one.
-     * This is needed because view roots are created before they are attached to the DOM.
-     * The name of the root element is temporary at this stage. It has to be changed when the
-     * view root element is attached to the DOM element.
-     *
-     * @internal
-     * @param name The new name of element.
-     */
-    set _name(name: string);
-}