@elementor/editor-canvas 4.2.0-861 → 4.2.0-863

package/dist/index.js

@@ -4083,6 +4083,7 @@ var validateInput = {
 };
 
 // src/composition-builder/composition-builder.ts
+var CREATE_ELEMENT_INVALID_CONTAINER_MESSAGE = "createElement did not return an element container with a model.";
 var CompositionBuilder = class _CompositionBuilder {
   elementConfig = {};
   elementStylesConfig = {};
@@ -4301,6 +4302,9 @@ ${childTypeErrors.join("\n")}`);
           model: modelTree,
           options: { useHistory: false }
         });
+        if (!newElement?.model) {
+          throw new Error(CREATE_ELEMENT_INVALID_CONTAINER_MESSAGE);
+        }
         this.rootContainers.push(newElement);
         await this.awaitViewRender(newElement);
       } catch (e) {
@@ -4766,6 +4770,13 @@ Use the EXACT "PROP-TYPE" Schema given, and ALWAYS include the "key" property fr
   configureElementToolPrompt.instruction(
     "The $$type property is MANDATORY for every value; it is required to parse the value and apply application-level effects."
   );
+  configureElementToolPrompt.instruction(`
+V4 only: If MCP fails, give manual steps using V4 UI.
+
+V4 Editor structure:
+Panel tabs: General (\u2192 Settings section: ID, Tag, Link), Style, Interactions.
+NO Advanced tab. Never mention Advanced tab.
+`);
   return configureElementToolPrompt.prompt();
 };
 var CONFIGURE_ELEMENT_GUIDE_TEXT = generatePrompt2();

package/dist/index.mjs

@@ -4078,6 +4078,7 @@ var validateInput = {
 };
 
 // src/composition-builder/composition-builder.ts
+var CREATE_ELEMENT_INVALID_CONTAINER_MESSAGE = "createElement did not return an element container with a model.";
 var CompositionBuilder = class _CompositionBuilder {
   elementConfig = {};
   elementStylesConfig = {};
@@ -4296,6 +4297,9 @@ ${childTypeErrors.join("\n")}`);
           model: modelTree,
           options: { useHistory: false }
         });
+        if (!newElement?.model) {
+          throw new Error(CREATE_ELEMENT_INVALID_CONTAINER_MESSAGE);
+        }
         this.rootContainers.push(newElement);
         await this.awaitViewRender(newElement);
       } catch (e) {
@@ -4761,6 +4765,13 @@ Use the EXACT "PROP-TYPE" Schema given, and ALWAYS include the "key" property fr
   configureElementToolPrompt.instruction(
     "The $$type property is MANDATORY for every value; it is required to parse the value and apply application-level effects."
   );
+  configureElementToolPrompt.instruction(`
+V4 only: If MCP fails, give manual steps using V4 UI.
+
+V4 Editor structure:
+Panel tabs: General (\u2192 Settings section: ID, Tag, Link), Style, Interactions.
+NO Advanced tab. Never mention Advanced tab.
+`);
   return configureElementToolPrompt.prompt();
 };
 var CONFIGURE_ELEMENT_GUIDE_TEXT = generatePrompt2();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@elementor/editor-canvas",
   "description": "Elementor Editor Canvas",
-  "version": "4.2.0-861",
+  "version": "4.2.0-863",
   "private": false,
   "author": "Elementor Team",
   "homepage": "https://elementor.com/",
@@ -37,25 +37,25 @@
     "react-dom": "^18.3.1"
   },
   "dependencies": {
-    "@elementor/editor": "4.2.0-861",
+    "@elementor/editor": "4.2.0-863",
     "dompurify": "^3.2.6",
-    "@elementor/editor-controls": "4.2.0-861",
-    "@elementor/editor-documents": "4.2.0-861",
-    "@elementor/editor-elements": "4.2.0-861",
-    "@elementor/editor-interactions": "4.2.0-861",
-    "@elementor/editor-mcp": "4.2.0-861",
-    "@elementor/editor-notifications": "4.2.0-861",
-    "@elementor/editor-props": "4.2.0-861",
-    "@elementor/editor-responsive": "4.2.0-861",
-    "@elementor/editor-styles": "4.2.0-861",
-    "@elementor/editor-styles-repository": "4.2.0-861",
-    "@elementor/editor-ui": "4.2.0-861",
-    "@elementor/editor-v1-adapters": "4.2.0-861",
-    "@elementor/schema": "4.2.0-861",
-    "@elementor/twing": "4.2.0-861",
+    "@elementor/editor-controls": "4.2.0-863",
+    "@elementor/editor-documents": "4.2.0-863",
+    "@elementor/editor-elements": "4.2.0-863",
+    "@elementor/editor-interactions": "4.2.0-863",
+    "@elementor/editor-mcp": "4.2.0-863",
+    "@elementor/editor-notifications": "4.2.0-863",
+    "@elementor/editor-props": "4.2.0-863",
+    "@elementor/editor-responsive": "4.2.0-863",
+    "@elementor/editor-styles": "4.2.0-863",
+    "@elementor/editor-styles-repository": "4.2.0-863",
+    "@elementor/editor-ui": "4.2.0-863",
+    "@elementor/editor-v1-adapters": "4.2.0-863",
+    "@elementor/schema": "4.2.0-863",
+    "@elementor/twing": "4.2.0-863",
     "@elementor/ui": "1.37.5",
-    "@elementor/utils": "4.2.0-861",
-    "@elementor/wp-media": "4.2.0-861",
+    "@elementor/utils": "4.2.0-863",
+    "@elementor/wp-media": "4.2.0-863",
     "@floating-ui/react": "^0.27.5",
     "@wordpress/i18n": "^5.13.0"
   },

package/src/composition-builder/__tests__/composition-builder.test.ts

@@ -0,0 +1,190 @@
+import { type V1Element } from '@elementor/editor-elements';
+
+import { CompositionBuilder } from '../composition-builder';
+
+const ROOT_CHILD_TAG = 'column';
+const GENERATED_ELEMENT_ID = 'generated-element-id';
+const CONFIG_ID = 'cfg-a';
+const ELEMENT_CONFIG_PROPERTY = 'title';
+const ELEMENT_CONFIG_VALUE = 'configured-value';
+
+const xmlStringWithConfiguration = `<${ ROOT_CHILD_TAG } configuration-id="${ CONFIG_ID }" />`;
+
+const createElementConfigPayload = () => ( {
+	[ CONFIG_ID ]: {
+		[ ELEMENT_CONFIG_PROPERTY ]: ELEMENT_CONFIG_VALUE,
+	},
+} );
+
+const createMinimalWidgetsCache = () =>
+	( {
+		[ ROOT_CHILD_TAG ]: {
+			elType: 'column',
+		},
+	} ) as Record< string, { elType: string } >;
+
+const createMockRootContainer = (): V1Element =>
+	( {
+		id: 'root',
+		model: { get: jest.fn(), set: jest.fn(), toJSON: jest.fn() },
+		settings: { get: jest.fn(), set: jest.fn(), toJSON: jest.fn() },
+		children: [],
+	} ) as unknown as V1Element;
+
+const createMockPartialContainer = ( id: string ): V1Element =>
+	( {
+		id,
+		model: { get: jest.fn(), set: jest.fn(), toJSON: jest.fn() },
+		settings: { get: jest.fn(), set: jest.fn(), toJSON: jest.fn() },
+		children: [],
+	} ) as unknown as V1Element;
+
+describe( 'CompositionBuilder.build createElement failure cleanup', () => {
+	it( 'calls deleteElement when createElement fails and getContainer returns a container', async () => {
+		// Arrange
+		const partialContainer = createMockPartialContainer( GENERATED_ELEMENT_ID );
+		const deleteElement = jest.fn();
+		const doUpdateElementProperty = jest.fn();
+		const createElement = jest.fn().mockImplementation( () => {
+			throw new Error( 'create failed' );
+		} );
+		const getContainer = jest
+			.fn()
+			.mockImplementation( ( id: string ) => ( id === GENERATED_ELEMENT_ID ? partialContainer : undefined ) );
+		const builder = CompositionBuilder.fromXMLString( xmlStringWithConfiguration, {
+			createElement,
+			deleteElement,
+			getContainer,
+			generateElementId: jest.fn().mockReturnValue( GENERATED_ELEMENT_ID ),
+			getWidgetsCache: jest.fn().mockReturnValue( createMinimalWidgetsCache() ),
+			doUpdateElementProperty,
+		} );
+		builder.setElementConfig( createElementConfigPayload() );
+
+		// Act
+		await expect( builder.build( createMockRootContainer() ) ).rejects.toThrow( 'create failed' );
+
+		// Assert
+		expect( getContainer ).toHaveBeenCalledWith( GENERATED_ELEMENT_ID );
+		expect( deleteElement ).toHaveBeenCalledTimes( 1 );
+		expect( deleteElement ).toHaveBeenCalledWith( { container: partialContainer } );
+		expect( doUpdateElementProperty ).not.toHaveBeenCalled();
+	} );
+
+	it( 'does not call deleteElement when createElement fails and getContainer returns undefined', async () => {
+		// Arrange
+		const deleteElement = jest.fn();
+		const doUpdateElementProperty = jest.fn();
+		const createElement = jest.fn().mockImplementation( () => {
+			throw new Error( 'create failed' );
+		} );
+		const getContainer = jest.fn().mockReturnValue( undefined );
+		const builder = CompositionBuilder.fromXMLString( xmlStringWithConfiguration, {
+			createElement,
+			deleteElement,
+			getContainer,
+			generateElementId: jest.fn().mockReturnValue( GENERATED_ELEMENT_ID ),
+			getWidgetsCache: jest.fn().mockReturnValue( createMinimalWidgetsCache() ),
+			doUpdateElementProperty,
+		} );
+		builder.setElementConfig( createElementConfigPayload() );
+
+		// Act
+		await expect( builder.build( createMockRootContainer() ) ).rejects.toThrow( 'create failed' );
+
+		// Assert
+		expect( getContainer ).toHaveBeenCalledWith( GENERATED_ELEMENT_ID );
+		expect( deleteElement ).not.toHaveBeenCalled();
+		expect( doUpdateElementProperty ).not.toHaveBeenCalled();
+	} );
+
+	it( 'calls deleteElement when createElement returns without a model', async () => {
+		// Arrange
+		const partialContainer = createMockPartialContainer( GENERATED_ELEMENT_ID );
+		const deleteElement = jest.fn();
+		const doUpdateElementProperty = jest.fn();
+		const createElement = jest.fn().mockReturnValue( {} as V1Element );
+		const getContainer = jest
+			.fn()
+			.mockImplementation( ( id: string ) => ( id === GENERATED_ELEMENT_ID ? partialContainer : undefined ) );
+		const builder = CompositionBuilder.fromXMLString( xmlStringWithConfiguration, {
+			createElement,
+			deleteElement,
+			getContainer,
+			generateElementId: jest.fn().mockReturnValue( GENERATED_ELEMENT_ID ),
+			getWidgetsCache: jest.fn().mockReturnValue( createMinimalWidgetsCache() ),
+			doUpdateElementProperty,
+		} );
+		builder.setElementConfig( createElementConfigPayload() );
+
+		// Act
+		await expect( builder.build( createMockRootContainer() ) ).rejects.toThrow(
+			'createElement did not return an element container with a model.'
+		);
+
+		// Assert
+		expect( getContainer ).toHaveBeenCalledWith( GENERATED_ELEMENT_ID );
+		expect( deleteElement ).toHaveBeenCalledTimes( 1 );
+		expect( deleteElement ).toHaveBeenCalledWith( { container: partialContainer } );
+		expect( doUpdateElementProperty ).not.toHaveBeenCalled();
+	} );
+} );
+
+describe( 'CompositionBuilder.build applyProperties after create', () => {
+	it( 'calls doUpdateElementProperty when create succeeds with element config', async () => {
+		// Arrange
+		const deleteElement = jest.fn();
+		const doUpdateElementProperty = jest.fn();
+		const createdElement = createMockPartialContainer( GENERATED_ELEMENT_ID );
+		const createElement = jest.fn().mockReturnValue( createdElement );
+		const getContainer = jest
+			.fn()
+			.mockImplementation( ( id: string ) => ( id === GENERATED_ELEMENT_ID ? createdElement : undefined ) );
+		const builder = CompositionBuilder.fromXMLString( xmlStringWithConfiguration, {
+			createElement,
+			deleteElement,
+			getContainer,
+			generateElementId: jest.fn().mockReturnValue( GENERATED_ELEMENT_ID ),
+			getWidgetsCache: jest.fn().mockReturnValue( createMinimalWidgetsCache() ),
+			doUpdateElementProperty,
+		} );
+		builder.setElementConfig( createElementConfigPayload() );
+
+		// Act
+		await builder.build( createMockRootContainer() );
+
+		// Assert
+		expect( deleteElement ).not.toHaveBeenCalled();
+		expect( createElement ).toHaveBeenCalledTimes( 1 );
+		expect( doUpdateElementProperty ).toHaveBeenCalledTimes( 1 );
+		expect( doUpdateElementProperty ).toHaveBeenCalledWith( {
+			elementId: GENERATED_ELEMENT_ID,
+			propertyName: ELEMENT_CONFIG_PROPERTY,
+			propertyValue: ELEMENT_CONFIG_VALUE,
+			elementType: ROOT_CHILD_TAG,
+		} );
+	} );
+
+	it( 'does not call doUpdateElementProperty when create succeeds without element config', async () => {
+		// Arrange
+		const deleteElement = jest.fn();
+		const doUpdateElementProperty = jest.fn();
+		const createdElement = createMockPartialContainer( GENERATED_ELEMENT_ID );
+		const createElement = jest.fn().mockReturnValue( createdElement );
+		const builder = CompositionBuilder.fromXMLString( `<${ ROOT_CHILD_TAG } />`, {
+			createElement,
+			deleteElement,
+			getContainer: jest.fn(),
+			generateElementId: jest.fn().mockReturnValue( GENERATED_ELEMENT_ID ),
+			getWidgetsCache: jest.fn().mockReturnValue( createMinimalWidgetsCache() ),
+			doUpdateElementProperty,
+		} );
+
+		// Act
+		await builder.build( createMockRootContainer() );
+
+		// Assert
+		expect( deleteElement ).not.toHaveBeenCalled();
+		expect( doUpdateElementProperty ).not.toHaveBeenCalled();
+	} );
+} );

package/src/composition-builder/composition-builder.ts

@@ -17,6 +17,8 @@ import { validateInput } from '../mcp/utils/validate-input';
 type AnyValue = z.infer< z.ZodTypeAny >;
 type AnyConfig = Record< string, Record< string, AnyValue > >;
 
+const CREATE_ELEMENT_INVALID_CONTAINER_MESSAGE = 'createElement did not return an element container with a model.';
+
 type API = {
 	createElement: typeof createElement;
 	deleteElement: typeof deleteElement;
@@ -296,6 +298,9 @@ export class CompositionBuilder {
 					model: modelTree as CreateElementParams[ 'model' ],
 					options: { useHistory: false },
 				} );
+				if ( ! newElement?.model ) {
+					throw new Error( CREATE_ELEMENT_INVALID_CONTAINER_MESSAGE );
+				}
 				this.rootContainers.push( newElement );
 				await this.awaitViewRender( newElement );
 			} catch ( e: unknown ) {

package/src/mcp/tools/configure-element/prompt.ts

@@ -117,6 +117,14 @@ Use the EXACT "PROP-TYPE" Schema given, and ALWAYS include the "key" property fr
 		'The $$type property is MANDATORY for every value; it is required to parse the value and apply application-level effects.'
 	);
 
+	configureElementToolPrompt.instruction( `
+V4 only: If MCP fails, give manual steps using V4 UI.
+
+V4 Editor structure:
+Panel tabs: General (→ Settings section: ID, Tag, Link), Style, Interactions.
+NO Advanced tab. Never mention Advanced tab.
+` );
+
 	return configureElementToolPrompt.prompt();
 };