@ckeditor/ckeditor5-engine 49.0.1 → 49.1.0-alpha.1

package/dist/dataprocessor/dataprocessor.d.ts

@@ -59,4 +59,9 @@ export interface DataProcessor {
 	* If `false`, comment nodes will be converted to `$comment`. Otherwise comment nodes are ignored.
 	*/
 	skipComments?: boolean;
+	/**
+	* If `false`, processing instruction nodes (for example `<?target data?>`) will be converted.
+	* Otherwise, processing instruction nodes are ignored.
+	*/
+	skipProcessingInstructions?: boolean;
 }

package/dist/dataprocessor/htmldataprocessor.d.ts

@@ -25,8 +25,20 @@ export declare class HtmlDataProcessor implements DataProcessor {
 	* A basic HTML writer instance used to convert DOM elements to an HTML string.
 	*/
 	htmlWriter: DataProcessorHtmlWriter;
+	/**
+	* If `false`, comment nodes will be converted. Otherwise, comment nodes are ignored.
+	*
+	* @default true
+	*/
 	skipComments: boolean;
 	/**
+	* If `false`, processing instruction nodes (for example `<?target data?>`) will be converted.
+	* Otherwise, processing instruction nodes are ignored.
+	*
+	* @default true
+	*/
+	skipProcessingInstructions: boolean;
+	/**
 	* Creates a new instance of the HTML data processor class.
 	*
 	* @param document The view document instance.

package/dist/dataprocessor/xmldataprocessor.d.ts

@@ -35,8 +35,20 @@ export declare class XmlDataProcessor implements DataProcessor {
 	* There is no need to use a dedicated XML writer because the basic HTML writer works well in this case.
 	*/
 	htmlWriter: DataProcessorHtmlWriter;
+	/**
+	* If `false`, comment nodes will be converted. Otherwise, comment nodes are ignored.
+	*
+	* @default true
+	*/
 	skipComments: boolean;
 	/**
+	* If `false`, processing instruction nodes (for example `<?target data?>`) will be converted.
+	* Otherwise, processing instruction nodes are ignored.
+	*
+	* @default true
+	*/
+	skipProcessingInstructions: boolean;
+	/**
 	* Creates a new instance of the XML data processor class.
 	*
 	* @param document The view document instance.

package/dist/index.js

@@ -2,7 +2,7 @@
  * @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 { CKEditorError, Collection, DomEmitterMixin, EmitterMixin, EventInfo, ObservableMixin, _trustedAttributeValue, compareArrays, count, diff, env, fastDiff, first, getActiveElement, getAncestors, getCode, getParentElement, getParentNode, getSelection, global, indexOf, insertAt, isArrowKeyCode, isComment, isDomSelectionBackward, isInsideCombinedSymbol, isInsideEmojiSequence, isInsideSurrogatePair, isIterable, isNode, isText, isValidAttributeName, keyCodes, logWarning, priorities, remove as remove$1, scrollViewportToShowTarget, spliceArray, toArray, toMap, trustedHtml, uid } from "@ckeditor/ckeditor5-utils";
+import { CKEditorError, Collection, DomEmitterMixin, EmitterMixin, EventInfo, ObservableMixin, _trustedAttributeValue, compareArrays, count, diff, env, fastDiff, first, getActiveElement, getAncestors, getCode, getParentElement, getParentNode, getSelection, global, indexOf, insertAt, isArrowKeyCode, isComment, isDomSelectionBackward, isInsideCombinedSymbol, isInsideEmojiSequence, isInsideSurrogatePair, isIterable, isNode, isProcessingInstruction, isText, isValidAttributeName, keyCodes, logWarning, priorities, remove as remove$1, scrollViewportToShowTarget, spliceArray, toArray, toMap, trustedHtml, uid } from "@ckeditor/ckeditor5-utils";
 import { clone, cloneDeep, debounce, extend, get, isEmpty, isEqual, isEqualWith, isObject, isPlainObject, merge, set } from "es-toolkit/compat";
 
 /**
@@ -8352,7 +8352,7 @@ function addInlineFiller(domDocument, domParentOrArray, offset) {
 * Nodes are considered similar if they have the same tag name.
 */
 function areSimilarElements(node1, node2) {
-	return isNode(node1) && isNode(node2) && !isText(node1) && !isText(node2) && !isComment(node1) && !isComment(node2) && node1.tagName.toLowerCase() === node2.tagName.toLowerCase();
+	return isNode(node1) && isNode(node2) && !isText(node1) && !isText(node2) && !isComment(node1) && !isComment(node2) && !isProcessingInstruction(node1) && !isProcessingInstruction(node2) && node1.tagName.toLowerCase() === node2.tagName.toLowerCase();
 }
 /**
 * Whether two DOM nodes are text nodes.
@@ -8729,7 +8729,8 @@ var ViewDomConverter = class {
 				domElement = this._domDocument.createDocumentFragment();
 				if (options.bind) this.bindDocumentFragments(domElement, viewElementOrFragment);
 			} else if (viewElementOrFragment.is("uiElement")) {
-				if (viewElementOrFragment.name === "$comment") domElement = this._domDocument.createComment(viewElementOrFragment.getCustomProperty("$rawContent"));
+				if (viewElementOrFragment.name === "$processingInstruction") domElement = this._domDocument.createProcessingInstruction(viewElementOrFragment.getCustomProperty("$processingTarget"), viewElementOrFragment.getCustomProperty("$processingData"));
+				else if (viewElementOrFragment.name === "$comment") domElement = this._domDocument.createComment(viewElementOrFragment.getCustomProperty("$rawContent"));
 				else domElement = viewElementOrFragment.render(this._domDocument, this);
 				if (options.bind) this.bindElements(domElement, viewElementOrFragment);
 				return domElement;
@@ -8910,6 +8911,7 @@ var ViewDomConverter = class {
 	* @param options.keepOriginalCase If `false`, node's tag name will be converted to lower case. False by default.
 	* @param options.skipComments If `false`, comment nodes will be converted to `$comment`
 	* {@link module:engine/view/uielement~ViewUIElement view UI elements}. False by default.
+	* @param options.skipProcessingInstructions If `false`, processing instruction nodes will be converted to `$processingInstruction`
 	* @returns Converted node or document fragment or `null` if DOM node is a {@link module:engine/view/filler filler}
 	* or the given node is an empty text node.
 	*/
@@ -9296,6 +9298,7 @@ var ViewDomConverter = class {
 		const hostElement = this.getHostViewElement(domNode);
 		if (hostElement) return hostElement;
 		if (isComment(domNode) && options.skipComments) return null;
+		if (isProcessingInstruction(domNode) && options.skipProcessingInstructions) return null;
 		if (isText(domNode)) {
 			if (isInlineFiller(domNode)) return null;
 			else {
@@ -9328,6 +9331,11 @@ var ViewDomConverter = class {
 					viewElement._setCustomProperty("$rawContent", domNode.data);
 					return viewElement;
 				}
+				if (isProcessingInstruction(domNode)) {
+					viewElement._setCustomProperty("$processingTarget", domNode.target);
+					viewElement._setCustomProperty("$processingData", domNode.data);
+					return viewElement;
+				}
 			}
 			yield viewElement;
 			const nestedInlineNodes = [];
@@ -9509,6 +9517,7 @@ var ViewDomConverter = class {
 	*/
 	_createViewElement(node, options) {
 		if (isComment(node)) return new ViewUIElement(this.document, "$comment");
+		if (isProcessingInstruction(node)) return new ViewUIElement(this.document, "$processingInstruction");
 		const viewName = options.keepOriginalCase ? node.tagName : node.tagName.toLowerCase();
 		return new ViewElement(this.document, viewName);
 	}
@@ -22197,8 +22206,20 @@ var HtmlDataProcessor = class {
 	* A basic HTML writer instance used to convert DOM elements to an HTML string.
 	*/
 	htmlWriter;
+	/**
+	* If `false`, comment nodes will be converted. Otherwise, comment nodes are ignored.
+	*
+	* @default true
+	*/
 	skipComments = true;
 	/**
+	* If `false`, processing instruction nodes (for example `<?target data?>`) will be converted.
+	* Otherwise, processing instruction nodes are ignored.
+	*
+	* @default true
+	*/
+	skipProcessingInstructions = true;
+	/**
 	* Creates a new instance of the HTML data processor class.
 	*
 	* @param document The view document instance.
@@ -22226,7 +22247,10 @@ var HtmlDataProcessor = class {
 	*/
 	toView(data) {
 		const domFragment = this._toDom(data);
-		return this.domConverter.domToView(domFragment, { skipComments: this.skipComments });
+		return this.domConverter.domToView(domFragment, {
+			skipComments: this.skipComments,
+			skipProcessingInstructions: this.skipProcessingInstructions
+		});
 	}
 	/**
 	* Registers a {@link module:engine/view/matcher~MatcherPattern} for view elements whose content should be treated as raw data
@@ -23328,8 +23352,20 @@ var XmlDataProcessor = class {
 	* There is no need to use a dedicated XML writer because the basic HTML writer works well in this case.
 	*/
 	htmlWriter;
+	/**
+	* If `false`, comment nodes will be converted. Otherwise, comment nodes are ignored.
+	*
+	* @default true
+	*/
 	skipComments = true;
 	/**
+	* If `false`, processing instruction nodes (for example `<?target data?>`) will be converted.
+	* Otherwise, processing instruction nodes are ignored.
+	*
+	* @default true
+	*/
+	skipProcessingInstructions = true;
+	/**
 	* Creates a new instance of the XML data processor class.
 	*
 	* @param document The view document instance.
@@ -23362,7 +23398,8 @@ var XmlDataProcessor = class {
 		const domFragment = this._toDom(data);
 		return this.domConverter.domToView(domFragment, {
 			keepOriginalCase: true,
-			skipComments: this.skipComments
+			skipComments: this.skipComments,
+			skipProcessingInstructions: this.skipProcessingInstructions
 		});
 	}
 	/**