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

package/dist/model/history.d.ts

@@ -1,118 +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 Operation from './operation/operation.js';
-/**
- * @module engine/model/history
- */
-/**
- * `History` keeps the track of all the operations applied to the {@link module:engine/model/document~Document document}.
- */
-export default class History {
-    /**
-     * Operations added to the history.
-     */
-    private _operations;
-    /**
-     * Holds an information which {@link module:engine/model/operation/operation~Operation operation} undoes which
-     * {@link module:engine/model/operation/operation~Operation operation}.
-     *
-     * Keys of the map are "undoing operations", that is operations that undone some other operations. For each key, the
-     * value is an operation that has been undone by the "undoing operation".
-     */
-    private _undoPairs;
-    /**
-     * Holds all undone operations.
-     */
-    private _undoneOperations;
-    /**
-     * A map that allows retrieving the operations fast based on the given base version.
-     */
-    private _baseVersionToOperationIndex;
-    /**
-     * The history version.
-     */
-    private _version;
-    /**
-     * The gap pairs kept in the <from,to> format.
-     *
-     * Anytime the `history.version` is set to a version larger than `history.version + 1`,
-     * a new <lastHistoryVersion, newHistoryVersion> entry is added to the map.
-     */
-    private _gaps;
-    /**
-     * The version of the last operation in the history.
-     *
-     * The history version is incremented automatically when a new operation is added to the history.
-     * Setting the version manually should be done only in rare circumstances when a gap is planned
-     * between history versions. When doing so, a gap will be created and the history will accept adding
-     * an operation with base version equal to the new history version.
-     */
-    get version(): number;
-    set version(version: number);
-    /**
-     * The last history operation.
-     */
-    get lastOperation(): Operation | undefined;
-    /**
-     * Adds an operation to the history and increments the history version.
-     *
-     * The operation's base version should be equal to the history version. Otherwise an error is thrown.
-     */
-    addOperation(operation: Operation): void;
-    /**
-     * Returns operations from the given range of operation base versions that were added to the history.
-     *
-     * Note that there may be gaps in operations base versions.
-     *
-     * @param fromBaseVersion Base version from which operations should be returned (inclusive).
-     * @param toBaseVersion Base version up to which operations should be returned (exclusive).
-     * @returns History operations for the given range, in chronological order.
-     */
-    getOperations(fromBaseVersion?: number, toBaseVersion?: number): Array<Operation>;
-    /**
-     * Returns operation from the history that bases on given `baseVersion`.
-     *
-     * @param baseVersion Base version of the operation to get.
-     * @returns Operation with given base version or `undefined` if there is no such operation in history.
-     */
-    getOperation(baseVersion: number): Operation | undefined;
-    /**
-     * Marks in history that one operation is an operation that is undoing the other operation. By marking operation this way,
-     * history is keeping more context information about operations, which helps in operational transformation.
-     *
-     * @param undoneOperation Operation which is undone by `undoingOperation`.
-     * @param undoingOperation Operation which undoes `undoneOperation`.
-     */
-    setOperationAsUndone(undoneOperation: Operation, undoingOperation: Operation): void;
-    /**
-     * Checks whether given `operation` is undoing any other operation.
-     *
-     * @param operation Operation to check.
-     * @returns `true` if given `operation` is undoing any other operation, `false` otherwise.
-     */
-    isUndoingOperation(operation: Operation): boolean;
-    /**
-     * Checks whether given `operation` has been undone by any other operation.
-     *
-     * @param operation Operation to check.
-     * @returns `true` if given `operation` has been undone any other operation, `false` otherwise.
-     */
-    isUndoneOperation(operation: Operation): boolean;
-    /**
-     * For given `undoingOperation`, returns the operation which has been undone by it.
-     *
-     * @returns Operation that has been undone by given `undoingOperation` or `undefined`
-     * if given `undoingOperation` is not undoing any other operation.
-     */
-    getUndoneOperation(undoingOperation: Operation): Operation | undefined;
-    /**
-     * Resets the history of operations.
-     */
-    reset(): void;
-}

package/dist/model/item.d.ts

@@ -1,18 +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 Node from './node.js';
-import type TextProxy from './textproxy.js';
-/**
- * @module engine/model/item
- */
-/**
- * Item is a {@link module:engine/model/node~Node} or {@link module:engine/model/textproxy~TextProxy}.
- */
-type Item = Node | TextProxy;
-export default Item;

package/dist/model/liveposition.d.ts

@@ -1,81 +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/model/liveposition
- */
-import Position, { type PositionOffset, type PositionStickiness } from './position.js';
-import type DocumentFragment from './documentfragment.js';
-import type Item from './item.js';
-import type RootElement from './rootelement.js';
-declare const LivePosition_base: import("@ckeditor/ckeditor5-utils").Mixed<typeof Position, import("@ckeditor/ckeditor5-utils").Emitter>;
-/**
- * `LivePosition` is a type of {@link module:engine/model/position~Position Position}
- * that updates itself as {@link module:engine/model/document~Document document}
- * is changed through operations. It may be used as a bookmark.
- *
- * **Note:** Contrary to {@link module:engine/model/position~Position}, `LivePosition` works only in roots that are
- * {@link module:engine/model/rootelement~RootElement}.
- * If {@link module:engine/model/documentfragment~DocumentFragment} is passed, error will be thrown.
- *
- * **Note:** Be very careful when dealing with `LivePosition`. Each `LivePosition` instance bind events that might
- * have to be unbound.
- * Use {@link module:engine/model/liveposition~LivePosition#detach} whenever you don't need `LivePosition` anymore.
- */
-export default class LivePosition extends /* #__PURE__ */ LivePosition_base {
-    /**
-     * Root of the position path.
-     */
-    readonly root: RootElement;
-    /**
-     * Creates a live position.
-     *
-     * @see module:engine/model/position~Position
-     */
-    constructor(root: RootElement, path: Array<number>, stickiness?: PositionStickiness);
-    /**
-     * Unbinds all events previously bound by `LivePosition`. Use it whenever you don't need `LivePosition` instance
-     * anymore (i.e. when leaving scope in which it was declared or before re-assigning variable that was
-     * referring to it).
-     */
-    detach(): void;
-    /**
-     * Creates a {@link module:engine/model/position~Position position instance}, which is equal to this live position.
-     */
-    toPosition(): Position;
-    /**
-     * Creates a `LivePosition` instance that is equal to position.
-     */
-    static fromPosition(position: Position, stickiness?: PositionStickiness): LivePosition;
-    /**
-     * @internal
-     * @see module:engine/model/position~Position._createAfter
-     */
-    static readonly _createAfter: (item: Item | DocumentFragment, stickiness?: PositionStickiness) => LivePosition;
-    /**
-     * @internal
-     * @see module:engine/model/position~Position._createBefore
-     */
-    static readonly _createBefore: (item: Item | DocumentFragment, stickiness?: PositionStickiness) => LivePosition;
-    /**
-     * @internal
-     * @see module:engine/model/position~Position._createAt
-     */
-    static readonly _createAt: (itemOrPosition: Item | Position | DocumentFragment, offset?: PositionOffset, stickiness?: PositionStickiness) => LivePosition;
-}
-/**
- * Fired when `LivePosition` instance is changed due to changes on {@link module:engine/model/document~Document}.
- *
- * @eventName ~LivePosition#change
- * @param oldPosition Position equal to this live position before it got changed.
- */
-export type LivePositionChangeEvent = {
-    name: 'change';
-    args: [oldPosition: Position];
-};
-export {};

package/dist/model/liverange.d.ts

@@ -1,106 +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/model/liverange
- */
-import Range from './range.js';
-import type DocumentFragment from './documentfragment.js';
-import type Element from './element.js';
-import type Item from './item.js';
-import type Position from './position.js';
-declare const LiveRange_base: import("@ckeditor/ckeditor5-utils").Mixed<typeof Range, import("@ckeditor/ckeditor5-utils").Emitter>;
-/**
- * `LiveRange` is a type of {@link module:engine/model/range~Range Range}
- * that updates itself as {@link module:engine/model/document~Document document}
- * is changed through operations. It may be used as a bookmark.
- *
- * **Note:** Be very careful when dealing with `LiveRange`. Each `LiveRange` instance bind events that might
- * have to be unbound. Use {@link module:engine/model/liverange~LiveRange#detach detach} whenever you don't need `LiveRange` anymore.
- */
-export default class LiveRange extends /* #__PURE__ */ LiveRange_base {
-    /**
-     * Creates a live range.
-     *
-     * @see module:engine/model/range~Range
-     */
-    constructor(start: Position, end?: Position | null);
-    /**
-     * Unbinds all events previously bound by `LiveRange`. Use it whenever you don't need `LiveRange` instance
-     * anymore (i.e. when leaving scope in which it was declared or before re-assigning variable that was
-     * referring to it).
-     */
-    detach(): void;
-    /**
-     * Creates a {@link module:engine/model/range~Range range instance} that is equal to this live range.
-     */
-    toRange(): Range;
-    /**
-     * Creates a `LiveRange` instance that is equal to the given range.
-     */
-    static fromRange(range: Range): LiveRange;
-    /**
-     * @see module:engine/model/range~Range._createIn
-     * @internal
-     */
-    static readonly _createIn: (element: Element | DocumentFragment) => LiveRange;
-    /**
-     * @see module:engine/model/range~Range._createOn
-     * @internal
-     */
-    static readonly _createOn: (element: Item | DocumentFragment) => LiveRange;
-    /**
-     * @see module:engine/model/range~Range._createFromPositionAndShift
-     * @internal
-     */
-    static readonly _createFromPositionAndShift: (position: Position, shift: number) => LiveRange;
-}
-/**
- * Fired when `LiveRange` instance boundaries have changed due to changes in the
- * {@link module:engine/model/document~Document document}.
- *
- * @eventName ~LiveRange#change:range
- * @param oldRange Range with start and end position equal to start and end position of this live
- * range before it got changed.
- * @param data Object with additional information about the change.
- * @param data.deletionPosition Source position for remove and merge changes.
- * Available if the range was moved to the graveyard root, `null` otherwise.
- */
-export type LiveRangeChangeRangeEvent = {
-    name: 'change' | 'change:range';
-    args: [range: Range, data: {
-        deletionPosition: Position | null;
-    }];
-};
-/**
- * Fired when `LiveRange` instance boundaries have not changed after a change in {@link module:engine/model/document~Document document}
- * but the change took place inside the range, effectively changing its content.
- *
- * @eventName ~LiveRange#change:content
- * @param range Range with start and end position equal to start and end position of
- * change range.
- * @param data Object with additional information about the change.
- * @param data.deletionPosition Due to the nature of this event, this property is always set to `null`. It is passed
- * for compatibility with the {@link module:engine/model/liverange~LiveRange#event:change:range} event.
- */
-export type LiveRangeChangeContentEvent = {
-    name: 'change' | 'change:content';
-    args: [range: Range, data: {
-        deletionPosition: null;
-    }];
-};
-/**
- * Describes `change:range` or `change:content` event.
- */
-export type LiveRangeChangeEvent = {
-    name: 'change' | 'change:range' | 'change:content';
-    args: [range: Range, data: {
-        deletionPosition: Position | null;
-    }];
-};
-export {};

package/dist/model/markercollection.d.ts

@@ -1,339 +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/model/markercollection
- */
-import TypeCheckable from './typecheckable.js';
-import LiveRange, { type LiveRangeChangeContentEvent, type LiveRangeChangeRangeEvent, type LiveRangeChangeEvent } from './liverange.js';
-import type Position from './position.js';
-import type Range from './range.js';
-declare const MarkerCollection_base: {
-    new (): import("@ckeditor/ckeditor5-utils").Emitter;
-    prototype: import("@ckeditor/ckeditor5-utils").Emitter;
-};
-/**
- * The collection of all {@link module:engine/model/markercollection~Marker markers} attached to the document.
- * It lets you {@link module:engine/model/markercollection~MarkerCollection#get get} markers or track them using
- * {@link module:engine/model/markercollection~MarkerCollection#event:update} event.
- *
- * To create, change or remove makers use {@link module:engine/model/writer~Writer model writers'} methods:
- * {@link module:engine/model/writer~Writer#addMarker} or {@link module:engine/model/writer~Writer#removeMarker}. Since
- * the writer is the only proper way to change the data model it is not possible to change markers directly using this
- * collection. All markers created by the writer will be automatically added to this collection.
- *
- * By default there is one marker collection available as {@link module:engine/model/model~Model#markers model property}.
- *
- * @see module:engine/model/markercollection~Marker
- */
-export default class MarkerCollection extends /* #__PURE__ */ MarkerCollection_base implements Iterable<Marker> {
-    /**
-     * Stores {@link ~Marker markers} added to the collection.
-     */
-    private _markers;
-    /**
-     * Iterable interface.
-     *
-     * Iterates over all {@link ~Marker markers} added to the collection.
-     */
-    [Symbol.iterator](): IterableIterator<Marker>;
-    /**
-     * Checks if given {@link ~Marker marker} or marker name is in the collection.
-     *
-     * @param markerOrName Name of marker or marker instance to check.
-     * @returns `true` if marker is in the collection, `false` otherwise.
-     */
-    has(markerOrName: string | Marker): boolean;
-    /**
-     * Returns {@link ~Marker marker} with given `markerName`.
-     *
-     * @param markerName Name of marker to get.
-     * @returns Marker with given name or `null` if such marker was
-     * not added to the collection.
-     */
-    get(markerName: string): Marker | null;
-    /**
-     * Creates and adds a {@link ~Marker marker} to the `MarkerCollection` with given name on given
-     * {@link module:engine/model/range~Range range}.
-     *
-     * If `MarkerCollection` already had a marker with given name (or {@link ~Marker marker} was passed), the marker in
-     * collection is updated and {@link module:engine/model/markercollection~MarkerCollection#event:update} event is fired
-     * but only if there was a change (marker range or {@link module:engine/model/markercollection~Marker#managedUsingOperations}
-     * flag has changed.
-     *
-     * @internal
-     * @fires update
-     * @param markerOrName Name of marker to set or marker instance to update.
-     * @param range Marker range.
-     * @param managedUsingOperations Specifies whether the marker is managed using operations.
-     * @param affectsData Specifies whether the marker affects the data produced by the data pipeline
-     * (is persisted in the editor's data).
-     * @returns `Marker` instance which was added or updated.
-     */
-    _set(markerOrName: string | Marker, range: Range, managedUsingOperations?: boolean, affectsData?: boolean): Marker;
-    /**
-     * Removes given {@link ~Marker marker} or a marker with given name from the `MarkerCollection`.
-     *
-     * @internal
-     * @fires update
-     * @param markerOrName Marker or name of a marker to remove.
-     * @returns `true` if marker was found and removed, `false` otherwise.
-     */
-    _remove(markerOrName: string | Marker): boolean;
-    /**
-     * Fires an {@link module:engine/model/markercollection~MarkerCollection#event:update} event for the given {@link ~Marker marker}
-     * but does not change the marker. Useful to force {@link module:engine/conversion/downcastdispatcher~DowncastDispatcher downcast
-     * conversion} for the marker.
-     *
-     * @internal
-     * @fires update
-     * @param markerOrName Marker or name of a marker to refresh.
-     */
-    _refresh(markerOrName: string | Marker): void;
-    /**
-     * Returns iterator that iterates over all markers, which ranges contain given {@link module:engine/model/position~Position position}.
-     */
-    getMarkersAtPosition(position: Position): IterableIterator<Marker>;
-    /**
-     * Returns iterator that iterates over all markers, which intersects with given {@link module:engine/model/range~Range range}.
-     */
-    getMarkersIntersectingRange(range: Range): Iterable<Marker>;
-    /**
-     * Destroys marker collection and all markers inside it.
-     */
-    destroy(): void;
-    /**
-     * Iterates over all markers that starts with given `prefix`.
-     *
-     * ```ts
-     * const markerFooA = markersCollection._set( 'foo:a', rangeFooA );
-     * const markerFooB = markersCollection._set( 'foo:b', rangeFooB );
-     * const markerBarA = markersCollection._set( 'bar:a', rangeBarA );
-     * const markerFooBarA = markersCollection._set( 'foobar:a', rangeFooBarA );
-     * Array.from( markersCollection.getMarkersGroup( 'foo' ) ); // [ markerFooA, markerFooB ]
-     * Array.from( markersCollection.getMarkersGroup( 'a' ) ); // []
-     * ```
-     */
-    getMarkersGroup(prefix: string): IterableIterator<Marker>;
-    /**
-     * Destroys the marker.
-     */
-    private _destroyMarker;
-}
-export interface MarkerData {
-    /**
-     * Marker range. `null` if the marker was removed.
-     */
-    range: Range | null;
-    /**
-     * A property defining if the marker affects data.
-     */
-    affectsData: boolean;
-    /**
-     * A property defining if the marker is managed using operations.
-     */
-    managedUsingOperations: boolean;
-}
-declare const Marker_base: import("@ckeditor/ckeditor5-utils").Mixed<typeof TypeCheckable, import("@ckeditor/ckeditor5-utils").Emitter>;
-/**
- * `Marker` is a continuous part of the model (like a range), is named and represents some kind of information about the
- * marked part of the model document. In contrary to {@link module:engine/model/node~Node nodes}, which are building blocks of
- * the model document tree, markers are not stored directly in the document tree but in the
- * {@link module:engine/model/model~Model#markers model markers' collection}. Still, they are document data, by giving
- * additional meaning to the part of a model document between marker start and marker end.
- *
- * In this sense, markers are similar to adding and converting attributes on nodes. The difference is that attribute is
- * connected with a given node (e.g. a character is bold no matter if it gets moved or content around it changes).
- * Markers on the other hand are continuous ranges and are characterized by their start and end position. This means that
- * any character in the marker is marked by the marker. For example, if a character is moved outside of marker it stops being
- * "special" and the marker is shrunk. Similarly, when a character is moved into the marker from other place in document
- * model, it starts being "special" and the marker is enlarged.
- *
- * Another upside of markers is that finding marked part of document is fast and easy. Using attributes to mark some nodes
- * and then trying to find that part of document would require traversing whole document tree. Marker gives instant access
- * to the range which it is marking at the moment.
- *
- * Markers are built from a name and a range.
- *
- * Range of the marker is updated automatically when document changes, using
- * {@link module:engine/model/liverange~LiveRange live range} mechanism.
- *
- * Name is used to group and identify markers. Names have to be unique, but markers can be grouped by
- * using common prefixes, separated with `:`, for example: `user:john` or `search:3`. That's useful in term of creating
- * namespaces for custom elements (e.g. comments, highlights). You can use this prefixes in
- * {@link module:engine/model/markercollection~MarkerCollection#event:update} listeners to listen on changes in a group of markers.
- * For instance: `model.markers.on( 'update:user', callback );` will be called whenever any `user:*` markers changes.
- *
- * There are two types of markers.
- *
- * 1. Markers managed directly, without using operations. They are added directly by {@link module:engine/model/writer~Writer}
- * to the {@link module:engine/model/markercollection~MarkerCollection} without any additional mechanism. They can be used
- * as bookmarks or visual markers. They are great for showing results of the find, or select link when the focus is in the input.
- *
- * 1. Markers managed using operations. These markers are also stored in {@link module:engine/model/markercollection~MarkerCollection}
- * but changes in these markers is managed the same way all other changes in the model structure - using operations.
- * Therefore, they are handled in the undo stack and synchronized between clients if the collaboration plugin is enabled.
- * This type of markers is useful for solutions like spell checking or comments.
- *
- * Both type of them should be added / updated by {@link module:engine/model/writer~Writer#addMarker}
- * and removed by {@link module:engine/model/writer~Writer#removeMarker} methods.
- *
- * ```ts
- * model.change( ( writer ) => {
- * 	const marker = writer.addMarker( name, { range, usingOperation: true } );
- *
- * 	// ...
- *
- * 	writer.removeMarker( marker );
- * } );
- * ```
- *
- * See {@link module:engine/model/writer~Writer} to find more examples.
- *
- * Since markers need to track change in the document, for efficiency reasons, it is best to create and keep as little
- * markers as possible and remove them as soon as they are not needed anymore.
- *
- * Markers can be downcasted and upcasted.
- *
- * Markers downcast happens on {@link module:engine/conversion/downcastdispatcher~DowncastDispatcher#event:addMarker} and
- * {@link module:engine/conversion/downcastdispatcher~DowncastDispatcher#event:removeMarker} events.
- * Use {@link module:engine/conversion/downcasthelpers downcast converters} or attach a custom converter to mentioned events.
- * For {@link module:engine/controller/datacontroller~DataController data pipeline}, marker should be downcasted to an element.
- * Then, it can be upcasted back to a marker. Again, use {@link module:engine/conversion/upcasthelpers upcast converters} or
- * attach a custom converter to {@link module:engine/conversion/upcastdispatcher~UpcastDispatcher#event:element}.
- *
- * `Marker` instances are created and destroyed only by {@link ~MarkerCollection MarkerCollection}.
- */
-declare class Marker extends /* #__PURE__ */ Marker_base {
-    /**
-     * Marker's name.
-     */
-    readonly name: string;
-    /**
-     * Flag indicates if the marker is managed using operations or not.
-     *
-     * @internal
-     */
-    _managedUsingOperations: boolean;
-    /**
-     * Specifies whether the marker affects the data produced by the data pipeline
-     * (is persisted in the editor's data).
-     *
-     * @internal
-     */
-    _affectsData: boolean;
-    /**
-     * Range marked by the marker.
-     */
-    private _liveRange;
-    /**
-     * Creates a marker instance.
-     *
-     * @param name Marker name.
-     * @param liveRange Range marked by the marker.
-     * @param managedUsingOperations Specifies whether the marker is managed using operations.
-     * @param affectsData Specifies whether the marker affects the data produced by the data pipeline (is persisted in the editor's data).
-     */
-    constructor(name: string, liveRange: LiveRange, managedUsingOperations: boolean, affectsData: boolean);
-    /**
-     * A value indicating if the marker is managed using operations.
-     * See {@link ~Marker marker class description} to learn more about marker types.
-     * See {@link module:engine/model/writer~Writer#addMarker}.
-     */
-    get managedUsingOperations(): boolean;
-    /**
-     * A value indicating if the marker changes the data.
-     */
-    get affectsData(): boolean;
-    /**
-     * Returns the marker data (properties defining the marker).
-     */
-    getData(): MarkerData;
-    /**
-     * Returns current marker start position.
-     */
-    getStart(): Position;
-    /**
-     * Returns current marker end position.
-     */
-    getEnd(): Position;
-    /**
-     * Returns a range that represents the current state of the marker.
-     *
-     * Keep in mind that returned value is a {@link module:engine/model/range~Range Range}, not a
-     * {@link module:engine/model/liverange~LiveRange LiveRange}. This means that it is up-to-date and relevant only
-     * until next model document change. Do not store values returned by this method. Instead, store {@link ~Marker#name}
-     * and get `Marker` instance from {@link module:engine/model/markercollection~MarkerCollection MarkerCollection} every
-     * time there is a need to read marker properties. This will guarantee that the marker has not been removed and
-     * that it's data is up-to-date.
-     */
-    getRange(): Range;
-    /**
-     * Binds new live range to the marker and detach the old one if is attached.
-     *
-     * @internal
-     * @param liveRange Live range to attach
-     * @returns Attached live range.
-     */
-    _attachLiveRange(liveRange: LiveRange): LiveRange;
-    /**
-     * Unbinds and destroys currently attached live range.
-     *
-     * @internal
-     */
-    _detachLiveRange(): void;
-}
-export type { Marker };
-/**
- * Fired whenever {@link ~Marker#_liveRange marker range} is changed due to changes on {@link module:engine/model/document~Document}.
- * This is a delegated {@link module:engine/model/liverange~LiveRange#event:change:range LiveRange change:range event}.
- *
- * When marker is removed from {@link module:engine/model/markercollection~MarkerCollection MarkerCollection},
- * all event listeners listening to it should be removed. It is best to do it on
- * {@link module:engine/model/markercollection~MarkerCollection#event:update MarkerCollection update event}.
- *
- * @see module:engine/model/liverange~LiveRange#event:change:range
- * @eventName ~Marker#change:range
- */
-export type MarkerChangeRangeEvent = LiveRangeChangeRangeEvent;
-/**
- * Fired whenever change on {@link module:engine/model/document~Document} is done inside {@link ~Marker#_liveRange marker range}.
- * This is a delegated {@link module:engine/model/liverange~LiveRange#event:change:content LiveRange change:content event}.
- *
- * When marker is removed from {@link module:engine/model/markercollection~MarkerCollection MarkerCollection},
- * all event listeners listening to it should be removed. It is best to do it on
- * {@link module:engine/model/markercollection~MarkerCollection#event:update MarkerCollection update event}.
- *
- * @see module:engine/model/liverange~LiveRange#event:change:content
- * @eventName ~Marker#change:content
- */
-export type MarkerCollectionChangeContentEvent = LiveRangeChangeContentEvent;
-/**
- * Describes `change:range` or `change:content` event.
- */
-export type MarkerChangeEvent = LiveRangeChangeEvent;
-/**
- * Fired whenever marker is added, updated or removed from `MarkerCollection`.
- *
- * @eventName ~MarkerCollection#update
- * @param marker Updated Marker.
- * @param oldRange Marker range before the update. When is not defined it
- * means that marker is just added.
- * @param newRange Marker range after update. When is not defined it
- * means that marker is just removed.
- * @param oldMarkerData Data of the marker before the change.
- */
-export type MarkerCollectionUpdateEvent = {
-    name: 'update' | `update:${string}`;
-    args: [marker: Marker, oldRange: Range | null, newRange: Range | null, oldMarkerData: MarkerData];
-};
-/**
- * Cannot use a {@link module:engine/model/markercollection~MarkerCollection#destroy destroyed marker} instance.
- *
- * @error marker-destroyed
- */