@ckeditor/ckeditor5-engine 48.2.0 → 48.3.0-alpha.0

package/dist/view/elementdefinition.d.ts

@@ -1,86 +1,86 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
+* @license Copyright (c) 2003-2026, 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/elementdefinition
- */
-import type { ArrayOrItem } from '@ckeditor/ckeditor5-utils';
+* @module engine/view/elementdefinition
+*/
+import type { ArrayOrItem } from "@ckeditor/ckeditor5-utils";
 /**
- * A plain object that describes a view element in a way that a concrete, exact view element could be created from that description.
- *
- * ```ts
- * const viewDefinition = {
- * 	name: 'h1',
- * 	classes: [ 'foo', 'bar' ]
- * };
- * ```
- *
- * Above describes a view element:
- *
- * ```html
- * <h1 class="foo bar"></h1>
- * ```
- *
- * An example with styles and attributes:
- *
- * ```ts
- * const viewDefinition = {
- * 	name: 'span',
- * 	styles: {
- * 		'font-size': '12px',
- * 		'font-weight': 'bold'
- * 	},
- * 	attributes: {
- * 		'data-id': '123'
- * 	}
- * };
- * ```
- *
- * Describes:
- *
- * ```ts
- * <span style="font-size:12px;font-weight:bold" data-id="123"></span>
- * ```
- */
+* A plain object that describes a view element in a way that a concrete, exact view element could be created from that description.
+*
+* ```ts
+* const viewDefinition = {
+* 	name: 'h1',
+* 	classes: [ 'foo', 'bar' ]
+* };
+* ```
+*
+* Above describes a view element:
+*
+* ```html
+* <h1 class="foo bar"></h1>
+* ```
+*
+* An example with styles and attributes:
+*
+* ```ts
+* const viewDefinition = {
+* 	name: 'span',
+* 	styles: {
+* 		'font-size': '12px',
+* 		'font-weight': 'bold'
+* 	},
+* 	attributes: {
+* 		'data-id': '123'
+* 	}
+* };
+* ```
+*
+* Describes:
+*
+* ```ts
+* <span style="font-size:12px;font-weight:bold" data-id="123"></span>
+* ```
+*/
 export interface ViewElementObjectDefinition {
-    /**
-     * View element name.
-     */
-    name: string;
-    /**
-     * Class name or array of class names to match. Each name can be provided in a form of string.
-     */
-    classes?: ArrayOrItem<string>;
-    /**
-     * Object with key-value pairs representing styles. Each object key represents style name. Value under that key must be a string.
-     */
-    styles?: Record<string, string>;
-    /**
-     * Object with key-value pairs representing attributes. Each object key represents attribute name.
-     * Value under that key must be a string.
-     */
-    attributes?: Record<string, string>;
-    /**
-     * Element's {@link module:engine/view/attributeelement~ViewAttributeElement#priority priority}.
-     */
-    priority?: number;
+	/**
+	* View element name.
+	*/
+	name: string;
+	/**
+	* Class name or array of class names to match. Each name can be provided in a form of string.
+	*/
+	classes?: ArrayOrItem<string>;
+	/**
+	* Object with key-value pairs representing styles. Each object key represents style name. Value under that key must be a string.
+	*/
+	styles?: Record<string, string>;
+	/**
+	* Object with key-value pairs representing attributes. Each object key represents attribute name.
+	* Value under that key must be a string.
+	*/
+	attributes?: Record<string, string>;
+	/**
+	* Element's {@link module:engine/view/attributeelement~ViewAttributeElement#priority priority}.
+	*/
+	priority?: number;
 }
 /**
- * A plain object that describes a view element or element name.
- *
- * Elements without attributes can be given simply as a string:
- *
- * ```ts
- * const viewDefinition = 'p';
- * ```
- *
- * Which will be treated as:
- *
- * ```ts
- * const viewDefinition = {
- * 	name: 'p'
- * };
- * ```
- */
+* A plain object that describes a view element or element name.
+*
+* Elements without attributes can be given simply as a string:
+*
+* ```ts
+* const viewDefinition = 'p';
+* ```
+*
+* Which will be treated as:
+*
+* ```ts
+* const viewDefinition = {
+* 	name: 'p'
+* };
+* ```
+*/
 export type ViewElementDefinition = string | ViewElementObjectDefinition;

package/dist/view/emptyelement.d.ts

@@ -1,47 +1,47 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
+* @license Copyright (c) 2003-2026, 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/emptyelement
- */
-import { ViewElement, type ViewElementAttributes } from './element.js';
-import { ViewNode } from './node.js';
-import { type ViewDocument } from './document.js';
-import { type ViewItem } from './item.js';
+* @module engine/view/emptyelement
+*/
+import { ViewElement, type ViewElementAttributes } from "./element.js";
+import { ViewNode } from "./node.js";
+import { type ViewDocument } from "./document.js";
+import { type ViewItem } from "./item.js";
 /**
- * Empty element class. It is used to represent elements that cannot contain any child nodes (for example `<img>` elements).
- *
- * To create a new empty element use the
- * {@link module:engine/view/downcastwriter~ViewDowncastWriter#createEmptyElement `downcastWriter#createEmptyElement()`} method.
- */
+* Empty element class. It is used to represent elements that cannot contain any child nodes (for example `<img>` elements).
+*
+* To create a new empty element use the
+* {@link module:engine/view/downcastwriter~ViewDowncastWriter#createEmptyElement `downcastWriter#createEmptyElement()`} method.
+*/
 export declare class ViewEmptyElement extends ViewElement {
-    /**
-     * Creates new instance of ViewEmptyElement.
-     *
-     * Throws {@link module:utils/ckeditorerror~CKEditorError CKEditorError} `view-emptyelement-cannot-add` when third parameter is passed,
-     * to inform that usage of ViewEmptyElement is incorrect (adding child nodes to ViewEmptyElement is forbidden).
-     *
-     * @see module:engine/view/downcastwriter~ViewDowncastWriter#createEmptyElement
-     * @internal
-     * @param document The document instance to which this element belongs.
-     * @param name Node name.
-     * @param attributes Collection of attributes.
-     * @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
-     * adding any child nodes to ViewEmptyElement.
-     *
-     * @internal
-     */
-    _insertChild(index: number, items: ViewItem | Iterable<ViewItem>): number;
+	/**
+	* Creates new instance of ViewEmptyElement.
+	*
+	* Throws {@link module:utils/ckeditorerror~CKEditorError CKEditorError} `view-emptyelement-cannot-add` when third parameter is passed,
+	* to inform that usage of ViewEmptyElement is incorrect (adding child nodes to ViewEmptyElement is forbidden).
+	*
+	* @see module:engine/view/downcastwriter~ViewDowncastWriter#createEmptyElement
+	* @internal
+	* @param document The document instance to which this element belongs.
+	* @param name Node name.
+	* @param attributes Collection of attributes.
+	* @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.
+	*/
+	override toJSON(): unknown;
+	/**
+	* Overrides {@link module:engine/view/element~ViewElement#_insertChild} method.
+	* Throws {@link module:utils/ckeditorerror~CKEditorError CKEditorError} `view-emptyelement-cannot-add` to prevent
+	* adding any child nodes to ViewEmptyElement.
+	*
+	* @internal
+	*/
+	override _insertChild(index: number, items: ViewItem | Iterable<ViewItem>): number;
 }

package/dist/view/filler.d.ts

@@ -1,94 +1,94 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
-import { type EditingView } from './view.js';
+* @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
+* For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
+*/
+import { type EditingView } from "./view.js";
 /**
- * Non-breaking space filler creator. This function creates the ` ` text node.
- * It defines how the filler is created.
- *
- * @see module:engine/view/filler~MARKED_NBSP_FILLER
- * @see module:engine/view/filler~BR_FILLER
- * @internal
- */
+* Non-breaking space filler creator. This function creates the ` ` text node.
+* It defines how the filler is created.
+*
+* @see module:engine/view/filler~MARKED_NBSP_FILLER
+* @see module:engine/view/filler~BR_FILLER
+* @internal
+*/
 export declare const NBSP_FILLER: (domDocument: Document) => Text;
 /**
- * Marked non-breaking space filler creator. This function creates the `<span data-cke-filler="true">&nbsp;</span>` element.
- * It defines how the filler is created.
- *
- * @see module:engine/view/filler~NBSP_FILLER
- * @see module:engine/view/filler~BR_FILLER
- * @internal
- */
+* Marked non-breaking space filler creator. This function creates the `<span data-cke-filler="true">&nbsp;</span>` element.
+* It defines how the filler is created.
+*
+* @see module:engine/view/filler~NBSP_FILLER
+* @see module:engine/view/filler~BR_FILLER
+* @internal
+*/
 export declare const MARKED_NBSP_FILLER: (domDocument: Document) => HTMLSpanElement;
 /**
- * `<br>` filler creator. This function creates the `<br data-cke-filler="true">` element.
- * It defines how the filler is created.
- *
- * @see module:engine/view/filler~NBSP_FILLER
- * @see module:engine/view/filler~MARKED_NBSP_FILLER
- * @internal
- */
+* `<br>` filler creator. This function creates the `<br data-cke-filler="true">` element.
+* It defines how the filler is created.
+*
+* @see module:engine/view/filler~NBSP_FILLER
+* @see module:engine/view/filler~MARKED_NBSP_FILLER
+* @internal
+*/
 export declare const BR_FILLER: (domDocument: Document) => HTMLBRElement;
 /**
- * Length of the {@link module:engine/view/filler~INLINE_FILLER INLINE_FILLER}.
- *
- * @internal
- */
+* Length of the {@link module:engine/view/filler~INLINE_FILLER INLINE_FILLER}.
+*
+* @internal
+*/
 export declare const INLINE_FILLER_LENGTH = 7;
 /**
- * Inline filler which is a sequence of the word joiners.
- *
- * @internal
- */
+* Inline filler which is a sequence of the word joiners.
+*
+* @internal
+*/
 export declare const INLINE_FILLER: string;
 /**
- * Checks if the node is a text node which starts with the {@link module:engine/view/filler~INLINE_FILLER inline filler}.
- *
- * ```ts
- * startsWithFiller( document.createTextNode( INLINE_FILLER ) ); // true
- * startsWithFiller( document.createTextNode( INLINE_FILLER + 'foo' ) ); // true
- * startsWithFiller( document.createTextNode( 'foo' ) ); // false
- * startsWithFiller( document.createElement( 'p' ) ); // false
- * ```
- *
- * @param domNode DOM node.
- * @returns True if the text node starts with the {@link module:engine/view/filler~INLINE_FILLER inline filler}.
- * @internal
- */
+* Checks if the node is a text node which starts with the {@link module:engine/view/filler~INLINE_FILLER inline filler}.
+*
+* ```ts
+* startsWithFiller( document.createTextNode( INLINE_FILLER ) ); // true
+* startsWithFiller( document.createTextNode( INLINE_FILLER + 'foo' ) ); // true
+* startsWithFiller( document.createTextNode( 'foo' ) ); // false
+* startsWithFiller( document.createElement( 'p' ) ); // false
+* ```
+*
+* @param domNode DOM node.
+* @returns True if the text node starts with the {@link module:engine/view/filler~INLINE_FILLER inline filler}.
+* @internal
+*/
 export declare function startsWithFiller(domNode: Node | string): boolean;
 /**
- * Checks if the text node contains only the {@link module:engine/view/filler~INLINE_FILLER inline filler}.
- *
- * ```ts
- * isInlineFiller( document.createTextNode( INLINE_FILLER ) ); // true
- * isInlineFiller( document.createTextNode( INLINE_FILLER + 'foo' ) ); // false
- * ```
- *
- * @param domText DOM text node.
- * @returns True if the text node contains only the {@link module:engine/view/filler~INLINE_FILLER inline filler}.
- * @internal
- */
+* Checks if the text node contains only the {@link module:engine/view/filler~INLINE_FILLER inline filler}.
+*
+* ```ts
+* isInlineFiller( document.createTextNode( INLINE_FILLER ) ); // true
+* isInlineFiller( document.createTextNode( INLINE_FILLER + 'foo' ) ); // false
+* ```
+*
+* @param domText DOM text node.
+* @returns True if the text node contains only the {@link module:engine/view/filler~INLINE_FILLER inline filler}.
+* @internal
+*/
 export declare function isInlineFiller(domText: Text): boolean;
 /**
- * Get string data from the text node, removing an {@link module:engine/view/filler~INLINE_FILLER inline filler} from it,
- * if text node contains it.
- *
- * ```ts
- * getDataWithoutFiller( document.createTextNode( INLINE_FILLER + 'foo' ) ) == 'foo' // true
- * getDataWithoutFiller( document.createTextNode( 'foo' ) ) == 'foo' // true
- * ```
- *
- * @param domText DOM text node, possible with inline filler.
- * @returns Data without filler.
- * @internal
- */
+* Get string data from the text node, removing an {@link module:engine/view/filler~INLINE_FILLER inline filler} from it,
+* if text node contains it.
+*
+* ```ts
+* getDataWithoutFiller( document.createTextNode( INLINE_FILLER + 'foo' ) ) == 'foo' // true
+* getDataWithoutFiller( document.createTextNode( 'foo' ) ) == 'foo' // true
+* ```
+*
+* @param domText DOM text node, possible with inline filler.
+* @returns Data without filler.
+* @internal
+*/
 export declare function getDataWithoutFiller(domText: Text | string): string;
 /**
- * Assign key observer which move cursor from the end of the inline filler to the beginning of it when
- * the left arrow is pressed, so the filler does not break navigation.
- *
- * @param view View controller instance we should inject quirks handling on.
- * @internal
- */
+* Assign key observer which move cursor from the end of the inline filler to the beginning of it when
+* the left arrow is pressed, so the filler does not break navigation.
+*
+* @param view View controller instance we should inject quirks handling on.
+* @internal
+*/
 export declare function injectQuirksHandling(view: EditingView): void;

package/dist/view/item.d.ts

@@ -1,13 +1,13 @@
 /**
- * @license Copyright (c) 2003-2026, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-licensing-options
- */
+* @license Copyright (c) 2003-2026, 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/item
- */
-import { type ViewNode } from './node.js';
-import { type ViewTextProxy } from './textproxy.js';
+* @module engine/view/item
+*/
+import { type ViewNode } from "./node.js";
+import { type ViewTextProxy } from "./textproxy.js";
 /**
- * Item is a {@link module:engine/view/node~ViewNode Node} or {@link module:engine/view/textproxy~ViewTextProxy ViewTextProxy}.
- */
+* Item is a {@link module:engine/view/node~ViewNode Node} or {@link module:engine/view/textproxy~ViewTextProxy ViewTextProxy}.
+*/
 export type ViewItem = ViewNode | ViewTextProxy;