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

package/dist/dataprocessor/basichtmlwriter.d.ts

@@ -1,20 +1,20 @@
 /**
- * @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/dataprocessor/basichtmlwriter
- */
-import { type DataProcessorHtmlWriter } from './htmlwriter.js';
+* @module engine/dataprocessor/basichtmlwriter
+*/
+import { type DataProcessorHtmlWriter } from "./htmlwriter.js";
 /**
- * Basic HTML writer. It uses the native `innerHTML` property for basic conversion
- * from a document fragment to an HTML string.
- *
- * @internal
- */
+* Basic HTML writer. It uses the native `innerHTML` property for basic conversion
+* from a document fragment to an HTML string.
+*
+* @internal
+*/
 export declare class BasicHtmlWriter implements DataProcessorHtmlWriter {
-    /**
-     * Returns an HTML string created from the document fragment.
-     */
-    getHtml(fragment: DocumentFragment): string;
+	/**
+	* Returns an HTML string created from the document fragment.
+	*/
+	getHtml(fragment: DocumentFragment): string;
 }

package/dist/dataprocessor/dataprocessor.d.ts

@@ -1,62 +1,62 @@
 /**
- * @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/dataprocessor/dataprocessor
- */
-import { type ViewDocumentFragment } from '../view/documentfragment.js';
-import type { MatcherPattern } from '../view/matcher.js';
+* @module engine/dataprocessor/dataprocessor
+*/
+import { type ViewDocumentFragment } from "../view/documentfragment.js";
+import type { MatcherPattern } from "../view/matcher.js";
 /**
- * The data processor interface. It should be implemented by actual data processors.
- *
- * Each data processor implements a certain format of the data. For example, {@glink features/markdown Markdown data processor}
- * will convert the data (a Markdown string) to a {@link module:engine/view/documentfragment~ViewDocumentFragment document fragment}
- * and back.
- *
- * **Note:** While the CKEditor 5 architecture supports changing the data format, in most scenarios we do recommend sticking to
- * the default format which is HTML (supported by the {@link module:engine/dataprocessor/htmldataprocessor~HtmlDataProcessor}).
- * HTML remains [the best standard for rich-text data](https://medium.com/content-uneditable/a-standard-for-rich-text-data-4b3a507af552).
- *
- * And please do remember – using Markdown [does not automatically make your
- * application/website secure](https://github.com/ckeditor/ckeditor5-markdown-gfm/issues/16#issuecomment-375752994).
- */
+* The data processor interface. It should be implemented by actual data processors.
+*
+* Each data processor implements a certain format of the data. For example, {@glink features/markdown Markdown data processor}
+* will convert the data (a Markdown string) to a {@link module:engine/view/documentfragment~ViewDocumentFragment document fragment}
+* and back.
+*
+* **Note:** While the CKEditor 5 architecture supports changing the data format, in most scenarios we do recommend sticking to
+* the default format which is HTML (supported by the {@link module:engine/dataprocessor/htmldataprocessor~HtmlDataProcessor}).
+* HTML remains [the best standard for rich-text data](https://medium.com/content-uneditable/a-standard-for-rich-text-data-4b3a507af552).
+*
+* And please do remember – using Markdown [does not automatically make your
+* application/website secure](https://github.com/ckeditor/ckeditor5-markdown-gfm/issues/16#issuecomment-375752994).
+*/
 export interface DataProcessor {
-    /**
-     * Converts a {@link module:engine/view/documentfragment~ViewDocumentFragment document fragment} to data.
-     *
-     * @param viewFragment The document fragment to be processed.
-     */
-    toData(viewFragment: ViewDocumentFragment): string;
-    /**
-     * Converts the data to a {@link module:engine/view/documentfragment~ViewDocumentFragment document fragment}.
-     *
-     * @param data The data to be processed.
-     */
-    toView(data: string): ViewDocumentFragment;
-    /**
-     * Registers a {@link module:engine/view/matcher~MatcherPattern} for view elements whose content should be treated as raw data
-     * and its content should be converted to a
-     * {@link module:engine/view/element~ViewElement#getCustomProperty custom property of a view element} called `"$rawContent"` while
-     * converting {@link #toView to view}.
-     *
-     * @param pattern Pattern matching all view elements whose content should be treated as plain text.
-     */
-    registerRawContentMatcher(pattern: MatcherPattern): void;
-    /**
-     * If the processor is set to use marked fillers, it will insert `&nbsp;` fillers wrapped in `<span>` elements
-     * (`<span data-cke-filler="true">&nbsp;</span>`) instead of regular `&nbsp;` characters.
-     *
-     * This mode allows for more precise handling of block fillers (so they do not leak into the editor content) but bloats the
-     * editor data with additional markup.
-     *
-     * This mode may be required by some features and will be turned on by them automatically.
-     *
-     * @param type Whether to use the default or marked `&nbsp;` block fillers.
-     */
-    useFillerType(type: 'default' | 'marked'): void;
-    /**
-     * If `false`, comment nodes will be converted to `$comment`. Otherwise comment nodes are ignored.
-     */
-    skipComments?: boolean;
+	/**
+	* Converts a {@link module:engine/view/documentfragment~ViewDocumentFragment document fragment} to data.
+	*
+	* @param viewFragment The document fragment to be processed.
+	*/
+	toData(viewFragment: ViewDocumentFragment): string;
+	/**
+	* Converts the data to a {@link module:engine/view/documentfragment~ViewDocumentFragment document fragment}.
+	*
+	* @param data The data to be processed.
+	*/
+	toView(data: string): ViewDocumentFragment;
+	/**
+	* Registers a {@link module:engine/view/matcher~MatcherPattern} for view elements whose content should be treated as raw data
+	* and its content should be converted to a
+	* {@link module:engine/view/element~ViewElement#getCustomProperty custom property of a view element} called `"$rawContent"` while
+	* converting {@link #toView to view}.
+	*
+	* @param pattern Pattern matching all view elements whose content should be treated as plain text.
+	*/
+	registerRawContentMatcher(pattern: MatcherPattern): void;
+	/**
+	* If the processor is set to use marked fillers, it will insert `&nbsp;` fillers wrapped in `<span>` elements
+	* (`<span data-cke-filler="true">&nbsp;</span>`) instead of regular `&nbsp;` characters.
+	*
+	* This mode allows for more precise handling of block fillers (so they do not leak into the editor content) but bloats the
+	* editor data with additional markup.
+	*
+	* This mode may be required by some features and will be turned on by them automatically.
+	*
+	* @param type Whether to use the default or marked `&nbsp;` block fillers.
+	*/
+	useFillerType(type: "default" | "marked"): void;
+	/**
+	* If `false`, comment nodes will be converted to `$comment`. Otherwise comment nodes are ignored.
+	*/
+	skipComments?: boolean;
 }

package/dist/dataprocessor/htmldataprocessor.d.ts

@@ -1,76 +1,76 @@
 /**
- * @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 { ViewDomConverter } from '../view/domconverter.js';
-import { type DataProcessor } from './dataprocessor.js';
-import { type DataProcessorHtmlWriter } from './htmlwriter.js';
-import { type ViewDocument } from '../view/document.js';
-import { type ViewDocumentFragment } from '../view/documentfragment.js';
-import type { MatcherPattern } from '../view/matcher.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 { ViewDomConverter } from "../view/domconverter.js";
+import { type DataProcessor } from "./dataprocessor.js";
+import { type DataProcessorHtmlWriter } from "./htmlwriter.js";
+import { type ViewDocument } from "../view/document.js";
+import { type ViewDocumentFragment } from "../view/documentfragment.js";
+import type { MatcherPattern } from "../view/matcher.js";
 /**
- * The HTML data processor class.
- * This data processor implementation uses HTML as input and output data.
- */
+* The HTML data processor class.
+* This data processor implementation uses HTML as input and output data.
+*/
 export declare class HtmlDataProcessor implements DataProcessor {
-    /**
-     * A DOM parser instance used to parse an HTML string to an HTML document.
-     */
-    domParser: DOMParser;
-    /**
-     * A DOM converter used to convert DOM elements to view elements.
-     */
-    domConverter: ViewDomConverter;
-    /**
-     * A basic HTML writer instance used to convert DOM elements to an HTML string.
-     */
-    htmlWriter: DataProcessorHtmlWriter;
-    skipComments: boolean;
-    /**
-     * Creates a new instance of the HTML data processor class.
-     *
-     * @param document The view document instance.
-     */
-    constructor(document: ViewDocument);
-    /**
-     * Converts a provided {@link module:engine/view/documentfragment~ViewDocumentFragment document fragment}
-     * to data format – in this case to an HTML string.
-     *
-     * @returns HTML string.
-     */
-    toData(viewFragment: ViewDocumentFragment): string;
-    /**
-     * Converts the provided HTML string to a view tree.
-     *
-     * @param data An HTML string.
-     * @returns A converted view element.
-     */
-    toView(data: string): ViewDocumentFragment;
-    /**
-     * Registers a {@link module:engine/view/matcher~MatcherPattern} for view elements whose content should be treated as raw data
-     * and not processed during the conversion from the DOM to the view elements.
-     *
-     * The raw data can be later accessed by a
-     * {@link module:engine/view/element~ViewElement#getCustomProperty custom property of a view element} called `"$rawContent"`.
-     *
-     * @param pattern Pattern matching all view elements whose content should be treated as raw data.
-     */
-    registerRawContentMatcher(pattern: MatcherPattern): void;
-    /**
-     * If the processor is set to use marked fillers, it will insert `&nbsp;` fillers wrapped in `<span>` elements
-     * (`<span data-cke-filler="true">&nbsp;</span>`) instead of regular `&nbsp;` characters.
-     *
-     * This mode allows for a more precise handling of the block fillers (so they do not leak into the editor content) but
-     * bloats the editor data with additional markup.
-     *
-     * This mode may be required by some features and will be turned on by them automatically.
-     *
-     * @param type Whether to use the default or the marked `&nbsp;` block fillers.
-     */
-    useFillerType(type: 'default' | 'marked'): void;
-    /**
-     * Converts an HTML string to its DOM representation. Returns a document fragment containing nodes parsed from
-     * the provided data.
-     */
-    protected _toDom(data: string): DocumentFragment;
+	/**
+	* A DOM parser instance used to parse an HTML string to an HTML document.
+	*/
+	domParser: DOMParser;
+	/**
+	* A DOM converter used to convert DOM elements to view elements.
+	*/
+	domConverter: ViewDomConverter;
+	/**
+	* A basic HTML writer instance used to convert DOM elements to an HTML string.
+	*/
+	htmlWriter: DataProcessorHtmlWriter;
+	skipComments: boolean;
+	/**
+	* Creates a new instance of the HTML data processor class.
+	*
+	* @param document The view document instance.
+	*/
+	constructor(document: ViewDocument);
+	/**
+	* Converts a provided {@link module:engine/view/documentfragment~ViewDocumentFragment document fragment}
+	* to data format &ndash; in this case to an HTML string.
+	*
+	* @returns HTML string.
+	*/
+	toData(viewFragment: ViewDocumentFragment): string;
+	/**
+	* Converts the provided HTML string to a view tree.
+	*
+	* @param data An HTML string.
+	* @returns A converted view element.
+	*/
+	toView(data: string): ViewDocumentFragment;
+	/**
+	* Registers a {@link module:engine/view/matcher~MatcherPattern} for view elements whose content should be treated as raw data
+	* and not processed during the conversion from the DOM to the view elements.
+	*
+	* The raw data can be later accessed by a
+	* {@link module:engine/view/element~ViewElement#getCustomProperty custom property of a view element} called `"$rawContent"`.
+	*
+	* @param pattern Pattern matching all view elements whose content should be treated as raw data.
+	*/
+	registerRawContentMatcher(pattern: MatcherPattern): void;
+	/**
+	* If the processor is set to use marked fillers, it will insert `&nbsp;` fillers wrapped in `<span>` elements
+	* (`<span data-cke-filler="true">&nbsp;</span>`) instead of regular `&nbsp;` characters.
+	*
+	* This mode allows for a more precise handling of the block fillers (so they do not leak into the editor content) but
+	* bloats the editor data with additional markup.
+	*
+	* This mode may be required by some features and will be turned on by them automatically.
+	*
+	* @param type Whether to use the default or the marked `&nbsp;` block fillers.
+	*/
+	useFillerType(type: "default" | "marked"): void;
+	/**
+	* Converts an HTML string to its DOM representation. Returns a document fragment containing nodes parsed from
+	* the provided data.
+	*/
+	protected _toDom(data: string): DocumentFragment;
 }

package/dist/dataprocessor/htmlwriter.d.ts

@@ -1,16 +1,16 @@
 /**
- * @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/dataprocessor/htmlwriter
- */
+* @module engine/dataprocessor/htmlwriter
+*/
 /**
- * The HTML writer interface.
- */
+* The HTML writer interface.
+*/
 export interface DataProcessorHtmlWriter {
-    /**
-     * Returns an HTML string created from a document fragment.
-     */
-    getHtml(fragment: DocumentFragment): string;
+	/**
+	* Returns an HTML string created from a document fragment.
+	*/
+	getHtml(fragment: DocumentFragment): string;
 }

package/dist/dataprocessor/xmldataprocessor.d.ts

@@ -1,90 +1,90 @@
 /**
- * @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 { ViewDomConverter } from '../view/domconverter.js';
-import { type DataProcessor } from './dataprocessor.js';
-import { type DataProcessorHtmlWriter } from './htmlwriter.js';
-import { type ViewDocument } from '../view/document.js';
-import { type ViewDocumentFragment } from '../view/documentfragment.js';
-import type { MatcherPattern } from '../view/matcher.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 { ViewDomConverter } from "../view/domconverter.js";
+import { type DataProcessor } from "./dataprocessor.js";
+import { type DataProcessorHtmlWriter } from "./htmlwriter.js";
+import { type ViewDocument } from "../view/document.js";
+import { type ViewDocumentFragment } from "../view/documentfragment.js";
+import type { MatcherPattern } from "../view/matcher.js";
 /**
- * The XML data processor class.
- * This data processor implementation uses XML as input and output data.
- * This class is needed because unlike HTML, XML allows to use any tag with any value.
- * For example, `<link>Text</link>` is a valid XML but invalid HTML.
- */
+* The XML data processor class.
+* This data processor implementation uses XML as input and output data.
+* This class is needed because unlike HTML, XML allows to use any tag with any value.
+* For example, `<link>Text</link>` is a valid XML but invalid HTML.
+*/
 export declare class XmlDataProcessor implements DataProcessor {
-    /**
-     * A list of namespaces allowed to use in the XML input.
-     *
-     * For example, registering namespaces [ 'attribute', 'container' ] allows to use `<attirbute:tagName></attribute:tagName>`
-     * and `<container:tagName></container:tagName>` input. It is mainly for debugging.
-     */
-    namespaces: Array<string>;
-    /**
-     * DOM parser instance used to parse an XML string to an XML document.
-     */
-    domParser: DOMParser;
-    /**
-     * DOM converter used to convert DOM elements to view elements.
-     */
-    domConverter: ViewDomConverter;
-    /**
-     * A basic HTML writer instance used to convert DOM elements to an XML string.
-     * There is no need to use a dedicated XML writer because the basic HTML writer works well in this case.
-     */
-    htmlWriter: DataProcessorHtmlWriter;
-    skipComments: boolean;
-    /**
-     * Creates a new instance of the XML data processor class.
-     *
-     * @param document The view document instance.
-     * @param options Configuration options.
-     * @param options.namespaces A list of namespaces allowed to use in the XML input.
-     */
-    constructor(document: ViewDocument, options?: {
-        namespaces?: Array<string>;
-    });
-    /**
-     * Converts the provided {@link module:engine/view/documentfragment~ViewDocumentFragment document fragment}
-     * to data format &ndash; in this case an XML string.
-     *
-     * @returns An XML string.
-     */
-    toData(viewFragment: ViewDocumentFragment): string;
-    /**
-     * Converts the provided XML string to a view tree.
-     *
-     * @param data An XML string.
-     * @returns A converted view element.
-     */
-    toView(data: string): ViewDocumentFragment;
-    /**
-     * Registers a {@link module:engine/view/matcher~MatcherPattern} for view elements whose content should be treated as raw data
-     * and not processed during the conversion from XML to view elements.
-     *
-     * The raw data can be later accessed by a
-     * {@link module:engine/view/element~ViewElement#getCustomProperty custom property of a view element} called `"$rawContent"`.
-     *
-     * @param pattern Pattern matching all view elements whose content should be treated as raw data.
-     */
-    registerRawContentMatcher(pattern: MatcherPattern): void;
-    /**
-     * If the processor is set to use marked fillers, it will insert `&nbsp;` fillers wrapped in `<span>` elements
-     * (`<span data-cke-filler="true">&nbsp;</span>`) instead of regular `&nbsp;` characters.
-     *
-     * This mode allows for a more precise handling of block fillers (so they do not leak into editor content) but
-     * bloats the editor data with additional markup.
-     *
-     * This mode may be required by some features and will be turned on by them automatically.
-     *
-     * @param type Whether to use the default or the marked `&nbsp;` block fillers.
-     */
-    useFillerType(type: 'default' | 'marked'): void;
-    /**
-     * Converts an XML string to its DOM representation. Returns a document fragment containing nodes parsed from
-     * the provided data.
-     */
-    private _toDom;
+	/**
+	* A list of namespaces allowed to use in the XML input.
+	*
+	* For example, registering namespaces [ 'attribute', 'container' ] allows to use `<attirbute:tagName></attribute:tagName>`
+	* and `<container:tagName></container:tagName>` input. It is mainly for debugging.
+	*/
+	namespaces: Array<string>;
+	/**
+	* DOM parser instance used to parse an XML string to an XML document.
+	*/
+	domParser: DOMParser;
+	/**
+	* DOM converter used to convert DOM elements to view elements.
+	*/
+	domConverter: ViewDomConverter;
+	/**
+	* A basic HTML writer instance used to convert DOM elements to an XML string.
+	* There is no need to use a dedicated XML writer because the basic HTML writer works well in this case.
+	*/
+	htmlWriter: DataProcessorHtmlWriter;
+	skipComments: boolean;
+	/**
+	* Creates a new instance of the XML data processor class.
+	*
+	* @param document The view document instance.
+	* @param options Configuration options.
+	* @param options.namespaces A list of namespaces allowed to use in the XML input.
+	*/
+	constructor(document: ViewDocument, options?: {
+		namespaces?: Array<string>;
+	});
+	/**
+	* Converts the provided {@link module:engine/view/documentfragment~ViewDocumentFragment document fragment}
+	* to data format &ndash; in this case an XML string.
+	*
+	* @returns An XML string.
+	*/
+	toData(viewFragment: ViewDocumentFragment): string;
+	/**
+	* Converts the provided XML string to a view tree.
+	*
+	* @param data An XML string.
+	* @returns A converted view element.
+	*/
+	toView(data: string): ViewDocumentFragment;
+	/**
+	* Registers a {@link module:engine/view/matcher~MatcherPattern} for view elements whose content should be treated as raw data
+	* and not processed during the conversion from XML to view elements.
+	*
+	* The raw data can be later accessed by a
+	* {@link module:engine/view/element~ViewElement#getCustomProperty custom property of a view element} called `"$rawContent"`.
+	*
+	* @param pattern Pattern matching all view elements whose content should be treated as raw data.
+	*/
+	registerRawContentMatcher(pattern: MatcherPattern): void;
+	/**
+	* If the processor is set to use marked fillers, it will insert `&nbsp;` fillers wrapped in `<span>` elements
+	* (`<span data-cke-filler="true">&nbsp;</span>`) instead of regular `&nbsp;` characters.
+	*
+	* This mode allows for a more precise handling of block fillers (so they do not leak into editor content) but
+	* bloats the editor data with additional markup.
+	*
+	* This mode may be required by some features and will be turned on by them automatically.
+	*
+	* @param type Whether to use the default or the marked `&nbsp;` block fillers.
+	*/
+	useFillerType(type: "default" | "marked"): void;
+	/**
+	* Converts an XML string to its DOM representation. Returns a document fragment containing nodes parsed from
+	* the provided data.
+	*/
+	private _toDom;
 }