@ckeditor/ckeditor5-engine 46.0.3 → 46.1.0-alpha.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-engine",
-  "version": "46.0.3",
+  "version": "46.1.0-alpha.0",
   "description": "The editing engine of CKEditor 5 – the best browser-based rich text editor.",
   "keywords": [
     "wysiwyg",
@@ -24,7 +24,7 @@
   "type": "module",
   "main": "src/index.js",
   "dependencies": {
-    "@ckeditor/ckeditor5-utils": "46.0.3",
+    "@ckeditor/ckeditor5-utils": "46.1.0-alpha.0",
     "es-toolkit": "1.39.5"
   },
   "author": "CKSource (http://cksource.com/)",

package/src/index.d.ts

@@ -15,7 +15,7 @@ export type { UpcastDispatcher, UpcastConversionApi, UpcastConversionData, Upcas
 export { UpcastHelpers } from './conversion/upcasthelpers.js';
 export { DowncastHelpers, type DowncastStructureCreatorFunction, type DowncastAttributeElementCreatorFunction, type DowncastElementCreatorFunction, type DowncastHighlightDescriptor, type DowncastSlotFilter, type DowncastAttributeDescriptor, type DowncastMarkerElementCreatorFunction, type DowncastAddHighlightCallback, type DowncastHighlightDescriptorCreatorFunction, type DowncastRemoveHighlightCallback, type DowncastMarkerDataCreatorFunction, type DowncastAttributeCreatorFunction } from './conversion/downcasthelpers.js';
 export type { UpcastElementCreatorFunction, UpcastAttributeCreatorFunction, UpcastMarkerFromElementCreatorFunction, UpcastMarkerFromAttributeCreatorFunction } from './conversion/upcasthelpers.js';
-export type { Mapper, MapperModelToViewPositionEvent, MapperViewToModelPositionEvent, MapperModelToViewPositionEventData, MapperViewToModelPositionEventData } from './conversion/mapper.js';
+export { Mapper, type MapperModelToViewPositionEvent, type MapperViewToModelPositionEvent, type MapperModelToViewPositionEventData, type MapperViewToModelPositionEventData } from './conversion/mapper.js';
 export type { ModelConsumable } from './conversion/modelconsumable.js';
 export type { Consumables, ViewConsumable } from './conversion/viewconsumable.js';
 export type { DataProcessor } from './dataprocessor/dataprocessor.js';
@@ -55,7 +55,7 @@ export type { ModelItem } from './model/item.js';
 export { ModelNode, type ModelNodeAttributes } from './model/node.js';
 export { ModelNodeList } from './model/nodelist.js';
 export { ModelRootElement } from './model/rootelement.js';
-export { ModelSchemaContext, type ModelSchema, type ModelSchemaCheckChildEvent, type ModelSchemaCheckAttributeEvent, type ModelSchemaAttributeCheckCallback, type ModelSchemaChildCheckCallback, type ModelAttributeProperties, type ModelSchemaItemDefinition, type ModelSchemaCompiledItemDefinition, type ModelSchemaContextDefinition, type ModelSchemaContextItem } from './model/schema.js';
+export { ModelSchema, ModelSchemaContext, type ModelSchemaCheckChildEvent, type ModelSchemaCheckAttributeEvent, type ModelSchemaAttributeCheckCallback, type ModelSchemaChildCheckCallback, type ModelAttributeProperties, type ModelSchemaItemDefinition, type ModelSchemaCompiledItemDefinition, type ModelSchemaContextDefinition, type ModelSchemaContextItem } from './model/schema.js';
 export { ModelSelection, type ModelSelectionChangeEvent, type ModelSelectionChangeRangeEvent, type ModelSelectionChangeAttributeEvent, type ModelSelectable, type ModelPlaceOrOffset } from './model/selection.js';
 export { ModelTypeCheckable } from './model/typecheckable.js';
 export { ModelWriter } from './model/writer.js';
@@ -95,6 +95,7 @@ export { DomEventObserver } from './view/observer/domeventobserver.js';
 export { MouseObserver } from './view/observer/mouseobserver.js';
 export { TabObserver } from './view/observer/tabobserver.js';
 export { TouchObserver } from './view/observer/touchobserver.js';
+export { PointerObserver } from './view/observer/pointerobserver.js';
 export { FakeSelectionObserver } from './view/observer/fakeselectionobserver.js';
 export { KeyObserver, type ViewDocumentKeyDownEvent, type ViewDocumentKeyUpEvent, type ViewDocumentKeyEventData } from './view/observer/keyobserver.js';
 export { MutationObserver, type ViewDocumentMutationEventData, type ObserverMutationData } from './view/observer/mutationobserver.js';
@@ -114,6 +115,7 @@ export type { ViewDocumentMutationsEvent } from './view/observer/mutationobserve
 export type { ViewDocumentLayoutChangedEvent } from './view/document.js';
 export type { ViewDocumentMouseDownEvent, ViewDocumentMouseUpEvent, ViewDocumentMouseOverEvent, ViewDocumentMouseOutEvent } from './view/observer/mouseobserver.js';
 export type { ViewDocumentTouchEndEvent, ViewDocumentTouchMoveEvent, ViewDocumentTouchStartEvent } from './view/observer/touchobserver.js';
+export type { ViewDocumentPointerDownEvent, ViewDocumentPointerMoveEvent, ViewDocumentPointerUpEvent } from './view/observer/pointerobserver.js';
 export type { ViewDocumentTabEvent } from './view/observer/tabobserver.js';
 export type { ViewDocumentClickEvent } from './view/observer/clickobserver.js';
 export type { ViewDocumentObserverSelectionChangeEvent, ViewDocumentObserverSelectionChangeDoneEvent } from './view/observer/selectionobserver.js';

package/src/index.js

@@ -14,6 +14,7 @@ export { Conversion } from './conversion/conversion.js';
 export { ConversionHelpers } from './conversion/conversionhelpers.js';
 export { UpcastHelpers } from './conversion/upcasthelpers.js';
 export { DowncastHelpers } from './conversion/downcasthelpers.js';
+export { Mapper } from './conversion/mapper.js';
 export { HtmlDataProcessor } from './dataprocessor/htmldataprocessor.js';
 export { XmlDataProcessor } from './dataprocessor/xmldataprocessor.js';
 export { InsertOperation } from './model/operation/insertoperation.js';
@@ -48,7 +49,7 @@ export { Differ } from './model/differ.js';
 export { ModelNode } from './model/node.js';
 export { ModelNodeList } from './model/nodelist.js';
 export { ModelRootElement } from './model/rootelement.js';
-export { ModelSchemaContext } from './model/schema.js';
+export { ModelSchema, ModelSchemaContext } from './model/schema.js';
 export { ModelSelection } from './model/selection.js';
 export { ModelTypeCheckable } from './model/typecheckable.js';
 export { ModelWriter } from './model/writer.js';
@@ -86,6 +87,7 @@ export { DomEventObserver } from './view/observer/domeventobserver.js';
 export { MouseObserver } from './view/observer/mouseobserver.js';
 export { TabObserver } from './view/observer/tabobserver.js';
 export { TouchObserver } from './view/observer/touchobserver.js';
+export { PointerObserver } from './view/observer/pointerobserver.js';
 export { FakeSelectionObserver } from './view/observer/fakeselectionobserver.js';
 export { KeyObserver } from './view/observer/keyobserver.js';
 export { MutationObserver } from './view/observer/mutationobserver.js';

package/src/model/documentselection.d.ts

@@ -259,6 +259,12 @@ export declare class ModelDocumentSelection extends /* #__PURE__ */ ModelDocumen
      * @param prefixOrName The marker group prefix or marker name.
      */
     observeMarkers(prefixOrName: string): void;
+    /**
+     * Converts `DocumentSelection` to plain object and returns it.
+     *
+     * @returns `DocumentSelection` converted to plain object.
+     */
+    toJSON(): unknown;
     /**
      * Moves {@link module:engine/model/documentselection~ModelDocumentSelection#focus} to the specified location.
      * Should be used only within the {@link module:engine/model/writer~ModelWriter#setSelectionFocus} method.

package/src/model/documentselection.js

@@ -311,6 +311,14 @@ export class ModelDocumentSelection extends /* #__PURE__ */ EmitterMixin(ModelTy
     observeMarkers(prefixOrName) {
         this._selection.observeMarkers(prefixOrName);
     }
+    /**
+     * Converts `DocumentSelection` to plain object and returns it.
+     *
+     * @returns `DocumentSelection` converted to plain object.
+     */
+    toJSON() {
+        return this._selection.toJSON();
+    }
     /**
      * Moves {@link module:engine/model/documentselection~ModelDocumentSelection#focus} to the specified location.
      * Should be used only within the {@link module:engine/model/writer~ModelWriter#setSelectionFocus} method.
@@ -642,6 +650,18 @@ class LiveSelection extends ModelSelection {
             this._ranges.push(liveRange);
         }
     }
+    /**
+     * Converts `LiveSelection` to plain object and returns it.
+     *
+     * @returns `LiveSelection` converted to plain object.
+     */
+    toJSON() {
+        const json = super.toJSON();
+        if (this.markers.length) {
+            json.markers = this.markers.map(marker => marker.toJSON());
+        }
+        return json;
+    }
     _validateSelectionRanges(ranges) {
         for (const range of ranges) {
             if (!this._document._validateSelectionRange(range)) {

package/src/model/markercollection.d.ts

@@ -270,6 +270,12 @@ declare class Marker extends /* #__PURE__ */ Marker_base {
      * that it's data is up-to-date.
      */
     getRange(): ModelRange;
+    /**
+     * Converts `Marker` to plain object and returns it.
+     *
+     * @returns `Marker` converted to plain object.
+     */
+    toJSON(): unknown;
     /**
      * Binds new live range to the marker and detach the old one if is attached.
      *

package/src/model/markercollection.js

@@ -381,6 +381,19 @@ class Marker extends /* #__PURE__ */ EmitterMixin(ModelTypeCheckable) {
         }
         return this._liveRange.toRange();
     }
+    /**
+     * Converts `Marker` to plain object and returns it.
+     *
+     * @returns `Marker` converted to plain object.
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            range: this._liveRange?.toJSON(),
+            usingOperations: this._managedUsingOperations,
+            affectsData: this._affectsData
+        };
+    }
     /**
      * Binds new live range to the marker and detach the old one if is attached.
      *

package/src/model/range.d.ts

@@ -308,7 +308,7 @@ export declare class ModelRange extends ModelTypeCheckable implements Iterable<M
     /**
      * Converts `Range` to plain object and returns it.
      *
-     * @returns `Node` converted to plain object.
+     * @returns `Range` converted to plain object.
      */
     toJSON(): unknown;
     /**

package/src/model/range.js

@@ -488,7 +488,7 @@ export class ModelRange extends ModelTypeCheckable {
     /**
      * Converts `Range` to plain object and returns it.
      *
-     * @returns `Node` converted to plain object.
+     * @returns `Range` converted to plain object.
      */
     toJSON() {
         return {

package/src/model/selection.d.ts

@@ -391,6 +391,12 @@ export declare class ModelSelection extends /* #__PURE__ */ ModelSelection_base
      * Useful to check if e.g. the user has just pressed <kbd>Ctrl</kbd> + <kbd>A</kbd>.
      */
     containsEntireContent(element?: ModelElement): boolean;
+    /**
+     * Converts `Selection` to plain object and returns it.
+     *
+     * @returns `Selection` converted to plain object.
+     */
+    toJSON(): unknown;
     /**
      * Adds given range to internal {@link #_ranges ranges array}. Throws an error
      * if given range is intersecting with any range that is already stored in this selection.

package/src/model/selection.js

@@ -617,6 +617,24 @@ export class ModelSelection extends /* #__PURE__ */ EmitterMixin(ModelTypeChecka
         return limitStartPosition.isTouching(this.getFirstPosition()) &&
             limitEndPosition.isTouching(this.getLastPosition());
     }
+    /**
+     * Converts `Selection` to plain object and returns it.
+     *
+     * @returns `Selection` converted to plain object.
+     */
+    toJSON() {
+        const json = {
+            ranges: Array.from(this.getRanges()).map(range => range.toJSON())
+        };
+        const attributes = Object.fromEntries(this.getAttributes());
+        if (Object.keys(attributes).length) {
+            json.attributes = attributes;
+        }
+        if (this.isBackward) {
+            json.isBackward = true;
+        }
+        return json;
+    }
     /**
      * Adds given range to internal {@link #_ranges ranges array}. Throws an error
      * if given range is intersecting with any range that is already stored in this selection.

package/src/view/attributeelement.d.ts

@@ -96,6 +96,12 @@ export declare class ViewAttributeElement extends ViewElement {
      * * etc.
      */
     isSimilar(otherElement: ViewElement): boolean;
+    /**
+     * Converts `ViewAttributeElement` instance to plain object and returns it.
+     *
+     * @returns `ViewAttributeElement` instance converted to plain object.
+     */
+    toJSON(): unknown;
     /**
      * Clones provided element with priority.
      *

package/src/view/attributeelement.js

@@ -120,6 +120,16 @@ class ViewAttributeElement extends ViewElement {
         }
         return super.isSimilar(otherElement) && this.priority == otherElement.priority;
     }
+    /**
+     * Converts `ViewAttributeElement` instance to plain object and returns it.
+     *
+     * @returns `ViewAttributeElement` instance converted to plain object.
+     */
+    toJSON() {
+        const json = super.toJSON();
+        json.type = 'AttributeElement';
+        return json;
+    }
     /**
      * Clones provided element with priority.
      *

package/src/view/containerelement.d.ts

@@ -41,6 +41,12 @@ export declare class ViewContainerElement extends ViewElement {
      * @param children A list of nodes to be inserted into created element.
      */
     constructor(document: ViewDocument, name: string, attrs?: ViewElementAttributes, children?: ViewNode | Iterable<ViewNode>);
+    /**
+     * Converts `ViewContainerElement` instance to plain object and returns it.
+     *
+     * @returns `ViewContainerElement` instance converted to plain object.
+     */
+    toJSON(): unknown;
 }
 /**
  * Returns block {@link module:engine/view/filler filler} offset or `null` if block filler is not needed.

package/src/view/containerelement.js

@@ -42,6 +42,16 @@ export class ViewContainerElement extends ViewElement {
         super(document, name, attrs, children);
         this.getFillerOffset = getViewFillerOffset;
     }
+    /**
+     * Converts `ViewContainerElement` instance to plain object and returns it.
+     *
+     * @returns `ViewContainerElement` instance converted to plain object.
+     */
+    toJSON() {
+        const json = super.toJSON();
+        json.type = 'ContainerElement';
+        return json;
+    }
 }
 // The magic of type inference using `is` method is centralized in `TypeCheckable` class.
 // Proper overload would interfere with that.

package/src/view/documentfragment.d.ts

@@ -78,6 +78,13 @@ export declare class ViewDocumentFragment extends /* #__PURE__ */ ViewDocumentFr
      * Iterator provides `[ key, value ]` pairs for each stored property.
      */
     getCustomProperties(): Iterable<[string | symbol, unknown]>;
+    /**
+     * Converts `ViewDocumentFragment` instance to plain object and returns it.
+     * Takes care of converting all of this document fragment's children.
+     *
+     * @returns `ViewDocumentFragment` instance converted to plain object.
+     */
+    toJSON(): unknown;
     /**
      * {@link module:engine/view/documentfragment~ViewDocumentFragment#_insertChild Insert} a child node or a list of child nodes at the end
      * and sets the parent of these nodes to this fragment.

package/src/view/documentfragment.js

@@ -101,6 +101,19 @@ export class ViewDocumentFragment extends /* #__PURE__ */ EmitterMixin(ViewTypeC
     *getCustomProperties() {
         yield* this._customProperties.entries();
     }
+    /**
+     * Converts `ViewDocumentFragment` instance to plain object and returns it.
+     * Takes care of converting all of this document fragment's children.
+     *
+     * @returns `ViewDocumentFragment` instance converted to plain object.
+     */
+    toJSON() {
+        const json = [];
+        for (const node of this._children) {
+            json.push(node.toJSON());
+        }
+        return json;
+    }
     /**
      * {@link module:engine/view/documentfragment~ViewDocumentFragment#_insertChild Insert} a child node or a list of child nodes at the end
      * and sets the parent of these nodes to this fragment.

package/src/view/documentselection.d.ts

@@ -222,6 +222,12 @@ export declare class ViewDocumentSelection extends /* #__PURE__ */ ViewDocumentS
      * @returns `true` if selections are similar, `false` otherwise.
      */
     isSimilar(otherSelection: ViewSelection | ViewDocumentSelection): boolean;
+    /**
+     * Converts `ViewDocumentSelection` instance to plain object and returns it.
+     *
+     * @returns `ViewDocumentSelection` instance converted to plain object.
+     */
+    toJSON(): unknown;
     /**
      * Sets this selection's ranges and direction to the specified location based on the given
      * {@link module:engine/view/selection~ViewSelectable selectable}.

package/src/view/documentselection.js

@@ -171,6 +171,14 @@ export class ViewDocumentSelection extends /* #__PURE__ */ EmitterMixin(ViewType
     isSimilar(otherSelection) {
         return this._selection.isSimilar(otherSelection);
     }
+    /**
+     * Converts `ViewDocumentSelection` instance to plain object and returns it.
+     *
+     * @returns `ViewDocumentSelection` instance converted to plain object.
+     */
+    toJSON() {
+        return this._selection.toJSON();
+    }
     /**
      * Sets this selection's ranges and direction to the specified location based on the given
      * {@link module:engine/view/selection~ViewSelectable selectable}.

package/src/view/domconverter.js

@@ -872,7 +872,7 @@ export class ViewDomConverter {
             const { scrollLeft, scrollTop } = node;
             scrollPositions.push([scrollLeft, scrollTop]);
         });
-        domEditable.focus();
+        domEditable.focus({ preventScroll: true });
         // Restore scrollLeft and scrollTop values starting from domEditable up to
         // document#documentElement.
         // https://github.com/ckeditor/ckeditor5-engine/issues/951
@@ -1412,7 +1412,9 @@ export class ViewDomConverter {
             }
             // ViewContainerElement is found on a way to next ViewText node, so given `node` was first/last
             // text node in its container element.
-            else if (item.is('containerElement')) {
+            // The ol, ul, and li elements are rendered as an attribute element so we should check list of known block elements.
+            // See: https://github.com/ckeditor/ckeditor5/issues/18960.
+            else if (item.is('containerElement') || this._isBlockViewElement(item)) {
                 return null;
             }
         }

package/src/view/editableelement.d.ts

@@ -58,5 +58,11 @@ export declare class ViewEditableElement extends /* #__PURE__ */ ViewEditableEle
      */
     constructor(document: ViewDocument, name: string, attributes?: ViewElementAttributes, children?: ViewNode | Iterable<ViewNode>);
     destroy(): void;
+    /**
+     * Converts `ViewEditableElement` instance to plain object and returns it.
+     *
+     * @returns `ViewEditableElement` instance converted to plain object.
+     */
+    toJSON(): unknown;
 }
 export {};

package/src/view/editableelement.js

@@ -42,6 +42,18 @@ export class ViewEditableElement extends /* #__PURE__ */ ObservableMixin(ViewCon
     destroy() {
         this.stopListening();
     }
+    /**
+     * Converts `ViewEditableElement` instance to plain object and returns it.
+     *
+     * @returns `ViewEditableElement` instance converted to plain object.
+     */
+    toJSON() {
+        const json = super.toJSON();
+        json.type = 'EditableElement';
+        json.isReadOnly = this.isReadOnly;
+        json.isFocused = this.isFocused;
+        return json;
+    }
 }
 // The magic of type inference using `is` method is centralized in `TypeCheckable` class.
 // Proper overload would interfere with that.

package/src/view/element.d.ts

@@ -299,6 +299,12 @@ export declare class ViewElement extends ViewNode {
      * @param attributeName The name of the attribute to be checked.
      */
     shouldRenderUnsafeAttribute(attributeName: string): boolean;
+    /**
+     * Converts `ViewElement` to plain object and returns it.
+     *
+     * @returns `ViewElement` converted to plain object.
+     */
+    toJSON(): unknown;
     /**
      * Clones provided element.
      *

package/src/view/element.js

@@ -442,6 +442,26 @@ export class ViewElement extends ViewNode {
     shouldRenderUnsafeAttribute(attributeName) {
         return this._unsafeAttributesToRender.includes(attributeName);
     }
+    /**
+     * Converts `ViewElement` to plain object and returns it.
+     *
+     * @returns `ViewElement` converted to plain object.
+     */
+    toJSON() {
+        const json = super.toJSON();
+        json.name = this.name;
+        json.type = 'Element';
+        if (this._attrs.size) {
+            json.attributes = Object.fromEntries(this.getAttributes());
+        }
+        if (this._children.length > 0) {
+            json.children = [];
+            for (const node of this._children) {
+                json.children.push(node.toJSON());
+            }
+        }
+        return json;
+    }
     /**
      * Clones provided element.
      *

package/src/view/emptyelement.d.ts

@@ -30,6 +30,12 @@ export declare class ViewEmptyElement extends ViewElement {
      * @param children A list of nodes to be inserted into created element.
      */
     constructor(document: ViewDocument, name: string, attributes?: ViewElementAttributes, children?: ViewNode | Iterable<ViewNode>);
+    /**
+     * Converts `ViewEmptyElement` instance to plain object and returns it.
+     *
+     * @returns `ViewEmptyElement` instance converted to plain object.
+     */
+    toJSON(): unknown;
     /**
      * Overrides {@link module:engine/view/element~ViewElement#_insertChild} method.
      * Throws {@link module:utils/ckeditorerror~CKEditorError CKEditorError} `view-emptyelement-cannot-add` to prevent

package/src/view/emptyelement.js

@@ -32,6 +32,16 @@ export class ViewEmptyElement extends ViewElement {
         super(document, name, attributes, children);
         this.getFillerOffset = getFillerOffset;
     }
+    /**
+     * Converts `ViewEmptyElement` instance to plain object and returns it.
+     *
+     * @returns `ViewEmptyElement` instance converted to plain object.
+     */
+    toJSON() {
+        const json = super.toJSON();
+        json.type = 'EmptyElement';
+        return json;
+    }
     /**
      * Overrides {@link module:engine/view/element~ViewElement#_insertChild} method.
      * Throws {@link module:utils/ckeditorerror~CKEditorError CKEditorError} `view-emptyelement-cannot-add` to prevent

package/src/view/node.d.ts

@@ -129,9 +129,9 @@ export declare abstract class ViewNode extends /* #__PURE__ */ ViewNode_base {
         index: number;
     }): void;
     /**
-     * Custom toJSON method to solve child-parent circular dependencies.
+     * Converts `ViewNode` to plain object and returns it.
      *
-     * @returns Clone of this object with the parent property removed.
+     * @returns `ViewNode` converted to plain object.
      */
     toJSON(): unknown;
     /**

package/src/view/node.js

@@ -7,7 +7,6 @@
  */
 import { ViewTypeCheckable } from './typecheckable.js';
 import { CKEditorError, EmitterMixin, compareArrays } from '@ckeditor/ckeditor5-utils';
-import { clone } from 'es-toolkit/compat';
 /**
  * Abstract view node class.
  *
@@ -217,14 +216,18 @@ export class ViewNode extends /* #__PURE__ */ EmitterMixin(ViewTypeCheckable) {
         }
     }
     /**
-     * Custom toJSON method to solve child-parent circular dependencies.
+     * Converts `ViewNode` to plain object and returns it.
      *
-     * @returns Clone of this object with the parent property removed.
+     * @returns `ViewNode` converted to plain object.
      */
     toJSON() {
-        const json = clone(this);
-        // Due to circular references we need to remove parent reference.
-        delete json.parent;
+        const json = {
+            path: this.getPath(),
+            type: 'Node'
+        };
+        if (this !== this.root && this.root.is('rootElement')) {
+            json.root = this.root.toJSON();
+        }
         return json;
     }
 }

package/src/view/observer/pointerobserver.d.ts

@@ -0,0 +1,76 @@
+/**
+ * @license Copyright (c) 2003-2025, 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/observer/pointerobserver
+ */
+import { DomEventObserver } from './domeventobserver.js';
+import { type ViewDocumentDomEventData } from './domeventdata.js';
+/**
+ * Pointer events observer.
+ *
+ * Note that this observer is not available by default. To make it available it needs to be added to
+ * {@link module:engine/view/view~EditingView} by {@link module:engine/view/view~EditingView#addObserver} method.
+ */
+export declare class PointerObserver extends DomEventObserver<'pointerdown' | 'pointerup' | 'pointermove'> {
+    /**
+     * @inheritDoc
+     */
+    readonly domEventType: readonly ["pointerdown", "pointerup", "pointermove"];
+    /**
+     * @inheritDoc
+     */
+    onDomEvent(domEvent: PointerEvent): void;
+}
+/**
+ * Fired when a pointer is down on one of the editing roots of the editor.
+ *
+ * Introduced by {@link module:engine/view/observer/pointerobserver~PointerObserver}.
+ *
+ * Note that this event is not available by default. To make it available,
+ * {@link module:engine/view/observer/pointerobserver~PointerObserver} needs to be added to {@link module:engine/view/view~EditingView}
+ * by the {@link module:engine/view/view~EditingView#addObserver} method.
+ *
+ * @see module:engine/view/observer/pointerobserver~PointerObserver
+ * @eventName module:engine/view/document~ViewDocument#pointerdown
+ * @param data The event data.
+ */
+export type ViewDocumentPointerDownEvent = {
+    name: 'pointerdown';
+    args: [data: ViewDocumentDomEventData<PointerEvent>];
+};
+/**
+ * Fired when a pointer is up on one of the editing roots of the editor.
+ *
+ * Introduced by {@link module:engine/view/observer/pointerobserver~PointerObserver}.
+ *
+ * Note that this event is not available by default. To make it available,
+ * {@link module:engine/view/observer/pointerobserver~PointerObserver} needs to be added to {@link module:engine/view/view~EditingView}
+ * by the {@link module:engine/view/view~EditingView#addObserver} method.
+ *
+ * @see module:engine/view/observer/pointerobserver~PointerObserver
+ * @eventName module:engine/view/document~ViewDocument#pointerup
+ * @param data The event data.
+ */
+export type ViewDocumentPointerUpEvent = {
+    name: 'pointerup';
+    args: [data: ViewDocumentDomEventData<PointerEvent>];
+};
+/**
+ * Fired when a pointer is moved on one of the editing roots of the editor.
+ *
+ * Introduced by {@link module:engine/view/observer/pointerobserver~PointerObserver}.
+ *
+ * Note that this event is not available by default. To make it available,
+ * {@link module:engine/view/observer/pointerobserver~PointerObserver} needs to be added to {@link module:engine/view/view~EditingView}
+ * by the {@link module:engine/view/view~EditingView#addObserver} method.
+ *
+ * @see module:engine/view/observer/pointerobserver~PointerObserver
+ * @eventName module:engine/view/document~ViewDocument#pointermove
+ * @param data The event data.
+ */
+export type ViewDocumentPointerMoveEvent = {
+    name: 'pointermove';
+    args: [data: ViewDocumentDomEventData<PointerEvent>];
+};

package/src/view/observer/pointerobserver.js

@@ -0,0 +1,26 @@
+/**
+ * @license Copyright (c) 2003-2025, 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/observer/pointerobserver
+ */
+import { DomEventObserver } from './domeventobserver.js';
+/**
+ * Pointer events observer.
+ *
+ * Note that this observer is not available by default. To make it available it needs to be added to
+ * {@link module:engine/view/view~EditingView} by {@link module:engine/view/view~EditingView#addObserver} method.
+ */
+export class PointerObserver extends DomEventObserver {
+    /**
+     * @inheritDoc
+     */
+    domEventType = ['pointerdown', 'pointerup', 'pointermove'];
+    /**
+     * @inheritDoc
+     */
+    onDomEvent(domEvent) {
+        this.fire(domEvent.type, domEvent);
+    }
+}

package/src/view/observer/selectionobserver.d.ts

@@ -8,10 +8,10 @@
 import { Observer } from './observer.js';
 import { MutationObserver } from './mutationobserver.js';
 import { FocusObserver } from './focusobserver.js';
-import { type EditingView } from '../view.js';
-import { type ViewDocumentSelection } from '../documentselection.js';
-import { type ViewDomConverter } from '../domconverter.js';
-import { type ViewSelection } from '../selection.js';
+import type { EditingView } from '../view.js';
+import type { ViewDocumentSelection } from '../documentselection.js';
+import type { ViewDomConverter } from '../domconverter.js';
+import type { ViewSelection } from '../selection.js';
 type DomSelection = globalThis.Selection;
 /**
  * Selection observer class observes selection changes in the document. If a selection changes on the document this