@ckeditor/ckeditor5-engine 47.2.0 → 47.3.0-alpha.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-engine",
-  "version": "47.2.0",
+  "version": "47.3.0-alpha.1",
   "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": "47.2.0",
+    "@ckeditor/ckeditor5-utils": "47.3.0-alpha.1",
     "es-toolkit": "1.39.5"
   },
   "author": "CKSource (http://cksource.com/)",

package/src/engineconfig.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @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/engineconfig
+ */
+/**
+ * CKEditor engine configuration options.
+ *
+ * This is a base class for {@link module:core/editor/editorconfig~EditorConfig `EditorConfig`}.
+ */
+export interface EngineConfig {
+    /**
+     * Enables specific experimental features in the editor for testing and feedback.
+     */
+    experimentalFlags?: ExperimentalFlagsConfig;
+}
+/**
+ * The `experimentalFlags` configuration option enables integrators to turn on specific experimental
+ * or pre-release features in CKEditor 5. These flags are primarily intended for testing and feedback purposes
+ * during the development of new functionality.
+ *
+ * Each key in the `experimentalFlags` object represents a unique experimental feature identifier.
+ * Setting the flag’s value to true activates the feature, while false (or absence of the key) keeps it disabled.
+ *
+ * Example
+ *
+ * ```ts
+ * EditorClass
+ * 	.create( {
+ * 		experimentalFlags: {
+ * 			modelInsertContentDeepSchemaVerification: true
+ * 		}
+ * 	} )
+ * 	.then( ... )
+ * 	.catch( ... );
+ * ```
+ *
+ * **Notes:**
+ * * Use with caution: Experimental features are not guaranteed to be stable and may change or be removed in future releases.
+ * * No compatibility guarantees: Their APIs, behavior, and configuration may change without notice.
+ * * Intended audience: This option is mainly for developers testing upcoming features, contributors, or early adopters
+ * evaluating new editor capabilities.
+ */
+export interface ExperimentalFlagsConfig {
+    /**
+     * When enabled, the editor performs deep schema verification during
+     * {@link module:engine/model/model~Model#insertContent `model.insertContent()`} operations.
+     * This ensures that all elements and attributes in the inserted content fully conform to the schema — not just
+     * at the top level — which helps identify structural inconsistencies early.
+     *
+     * This feature may impact performance on large inserts.
+     */
+    modelInsertContentDeepSchemaVerification?: boolean;
+}

package/src/engineconfig.js

@@ -0,0 +1,5 @@
+/**
+ * @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
+ */
+export {};

package/src/index.d.ts

@@ -5,6 +5,7 @@
 /**
  * @module engine
  */
+export type { EngineConfig, ExperimentalFlagsConfig } from './engineconfig.js';
 export { type PlaceholderableViewElement, disableViewPlaceholder, enableViewPlaceholder, hideViewPlaceholder, needsViewPlaceholder, showViewPlaceholder } from './view/placeholder.js';
 export { EditingController } from './controller/editingcontroller.js';
 export { DataController, type DataControllerInitEvent, type DataControllerSetEvent, type DataControllerToModelEvent, type DataControllerToViewEvent, type DataControllerReadyEvent, type DataControllerGetEvent } from './controller/datacontroller.js';

package/src/index.js

@@ -2,9 +2,6 @@
  * @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
- */
 export { disableViewPlaceholder, enableViewPlaceholder, hideViewPlaceholder, needsViewPlaceholder, showViewPlaceholder } from './view/placeholder.js';
 // Controller.
 export { EditingController } from './controller/editingcontroller.js';

package/src/model/model.d.ts

@@ -19,7 +19,8 @@ import { type ModelDocumentFragment } from './documentfragment.js';
 import { type ModelItem } from './item.js';
 import { type ModelElement } from './element.js';
 import { type Operation } from './operation/operation.js';
-import { type DecoratedMethodEvent } from '@ckeditor/ckeditor5-utils';
+import { type DecoratedMethodEvent, type Config } from '@ckeditor/ckeditor5-utils';
+import type { EngineConfig } from '../engineconfig.js';
 declare const Model_base: {
     new (): import("@ckeditor/ckeditor5-utils").Observable;
     prototype: import("@ckeditor/ckeditor5-utils").Observable;
@@ -41,6 +42,12 @@ export declare class Model extends /* #__PURE__ */ Model_base {
      * Model's schema.
      */
     readonly schema: ModelSchema;
+    /**
+     * Stores all configurations specific to editor instance.
+     *
+     * @internal
+     */
+    readonly _config?: Config<EngineConfig>;
     /**
      * All callbacks added by {@link module:engine/model/model~Model#change} or
      * {@link module:engine/model/model~Model#enqueueChange} methods waiting to be executed.
@@ -50,7 +57,7 @@ export declare class Model extends /* #__PURE__ */ Model_base {
      * The last created and currently used writer instance.
      */
     private _currentWriter;
-    constructor();
+    constructor(config?: Config<EngineConfig>);
     /**
      * The `change()` method is the primary way of changing the model. You should use it to modify all document nodes
      * (including detached nodes – i.e. nodes not added to the {@link module:engine/model/model~Model#document model document}),

package/src/model/model.js

@@ -43,6 +43,12 @@ export class Model extends /* #__PURE__ */ ObservableMixin() {
      * Model's schema.
      */
     schema;
+    /**
+     * Stores all configurations specific to editor instance.
+     *
+     * @internal
+     */
+    _config;
     /**
      * All callbacks added by {@link module:engine/model/model~Model#change} or
      * {@link module:engine/model/model~Model#enqueueChange} methods waiting to be executed.
@@ -54,11 +60,12 @@ export class Model extends /* #__PURE__ */ ObservableMixin() {
     _currentWriter;
     // @if CK_DEBUG_ENGINE // private _operationLogs: Array<string>;
     // @if CK_DEBUG_ENGINE // private _appliedOperations: Array<Operation>;
-    constructor() {
+    constructor(config) {
         super();
         this.markers = new MarkerCollection();
         this.document = new ModelDocument(this);
         this.schema = new ModelSchema();
+        this._config = config;
         this._pendingChanges = [];
         this._currentWriter = null;
         ['deleteContent', 'modifySelection', 'getSelectedContent', 'applyOperation']

package/src/model/utils/insertcontent.js

@@ -234,9 +234,9 @@ class Insertion {
      */
     _lastAutoParagraph = null;
     /**
-     * The array of nodes that should be cleaned of not allowed attributes.
+     * The array of nodes that should be cleaned of not allowed attributes and sub-nodes.
      */
-    _filterAttributesOf = [];
+    _filterAttributesAndChildrenOf = [];
     /**
      * Beginning of the affected range. See {@link module:engine/model/utils/insertcontent~Insertion#getAffectedRange}.
      */
@@ -277,8 +277,51 @@ class Insertion {
         // Merging with the previous sibling was performed just after inserting the first node to the document.
         this._mergeOnRight();
         // TMP this will become a post-fixer.
-        this.schema.removeDisallowedAttributes(this._filterAttributesOf, this.writer);
-        this._filterAttributesOf = [];
+        this.schema.removeDisallowedAttributes(this._filterAttributesAndChildrenOf, this.writer);
+        if (this.model._config?.get('experimentalFlags.modelInsertContentDeepSchemaVerification')) {
+            this._removeDisallowedChildren(this._filterAttributesAndChildrenOf);
+        }
+        this._filterAttributesAndChildrenOf = [];
+    }
+    /**
+     * Removes disallowed children from nodes that were inserted or modified during insertion.
+     */
+    _removeDisallowedChildren(nodes) {
+        // Make sure we do not modify the original iterable.
+        const nodesArray = Array.from(nodes);
+        // Check all sub-nodes of top level inserted nodes.
+        // We do it at this point so node is already in the model tree and schema checks will be correct.
+        for (const node of nodesArray) {
+            if (!node.is('element')) {
+                continue;
+            }
+            const remove = [];
+            const unwrap = [];
+            const walker = this.writer.createRangeIn(node).getWalker({ ignoreElementEnd: true });
+            for (const { item } of walker) {
+                const itemParent = item.parent;
+                if (!this.schema.checkChild(itemParent, item)) {
+                    if (item.is('element') && !this.schema.isObject(item)) {
+                        // Unwrap non-object element.
+                        unwrap.push(item);
+                        // Store the parent for re-checking children after unwrap.
+                        nodesArray.push(itemParent);
+                    }
+                    else {
+                        // Remove object with children, or text.
+                        remove.push(item);
+                    }
+                    // Skip the whole subtree as it will be removed or processed later.
+                    walker.jumpTo(this.writer.createPositionAfter(item));
+                }
+            }
+            for (const item of unwrap) {
+                this.writer.unwrap(item);
+            }
+            for (const item of remove) {
+                this.writer.remove(item);
+            }
+        }
     }
     /**
      * Updates the last node after the auto paragraphing.
@@ -423,7 +466,7 @@ class Insertion {
         else {
             this._nodeToSelect = null;
         }
-        this._filterAttributesOf.push(node);
+        this._filterAttributesAndChildrenOf.push(node);
         return node;
     }
     /**
@@ -514,7 +557,7 @@ class Insertion {
         livePosition.detach();
         // After merge elements that were marked by _insert() to be filtered might be gone so
         // we need to mark the new container.
-        this._filterAttributesOf.push(this.position.parent);
+        this._filterAttributesAndChildrenOf.push(this.position.parent);
         mergePosLeft.detach();
     }
     /**
@@ -584,7 +627,7 @@ class Insertion {
         livePosition.detach();
         // After merge elements that were marked by _insert() to be filtered might be gone so
         // we need to mark the new container.
-        this._filterAttributesOf.push(this.position.parent);
+        this._filterAttributesAndChildrenOf.push(this.position.parent);
         mergePosRight.detach();
     }
     /**