@elementor/editor-canvas 4.3.0-1003 → 4.3.0-1004

package/dist/index.js

@@ -4522,6 +4522,9 @@ var initBuildCompositionTool = (reg) => {
         "Map configuration-id \u2192 raw CSS declarations (property \u2192 value strings; no selectors). Server converts to native styles; unconvertible declarations become the element custom CSS."
       ),
       parentId: import_schema.z.string().optional().describe("ID of the parent container. Omit or pass 'document' to insert at document root."),
+      mode: import_schema.z.enum(["append", "replace_children"]).optional().describe(
+        "'append' (default) inserts under parentId; 'replace_children' removes existing direct children of parentId first, then inserts."
+      ),
       dryRun: import_schema.z.boolean().optional().describe("If true, validate and return the resolved tree without persisting.")
     },
     outputSchema: {
@@ -4530,9 +4533,10 @@ var initBuildCompositionTool = (reg) => {
       version: import_schema.z.string(),
       resolvedXml: import_schema.z.string(),
       llmInstructions: import_schema.z.string(),
-      warnings: import_schema.z.array(import_schema.z.string()).optional()
+      warnings: import_schema.z.array(import_schema.z.string()).optional(),
+      removedElementIds: import_schema.z.array(import_schema.z.string()).optional()
     },
-    handler: async ({ xmlStructure, elementConfig, style, parentId, dryRun }) => {
+    handler: async ({ xmlStructure, elementConfig, style, parentId, mode, dryRun }) => {
       const document2 = (0, import_editor_documents2.getCurrentDocument)();
       if (!document2?.id) {
         throw new Error("No active document found.");
@@ -4546,6 +4550,7 @@ var initBuildCompositionTool = (reg) => {
             element_config: elementConfig ?? {},
             style: style ?? {},
             parent_id: parentId ?? "document",
+            mode: mode ?? "append",
             dry_run: dryRun ?? false
           }
         });
@@ -4566,7 +4571,8 @@ var initBuildCompositionTool = (reg) => {
           version: data.data.version,
           resolvedXml: data.data.resolved_xml,
           llmInstructions: data.data.llm_instructions,
-          warnings: data.data.warnings
+          warnings: data.data.warnings,
+          removedElementIds: data.data.removed_element_ids
         };
       } catch (error) {
         throw new Error(getMcpErrorMessage(error, "build-composition"));

package/dist/index.mjs

@@ -4488,6 +4488,9 @@ var initBuildCompositionTool = (reg) => {
         "Map configuration-id \u2192 raw CSS declarations (property \u2192 value strings; no selectors). Server converts to native styles; unconvertible declarations become the element custom CSS."
       ),
       parentId: z.string().optional().describe("ID of the parent container. Omit or pass 'document' to insert at document root."),
+      mode: z.enum(["append", "replace_children"]).optional().describe(
+        "'append' (default) inserts under parentId; 'replace_children' removes existing direct children of parentId first, then inserts."
+      ),
       dryRun: z.boolean().optional().describe("If true, validate and return the resolved tree without persisting.")
     },
     outputSchema: {
@@ -4496,9 +4499,10 @@ var initBuildCompositionTool = (reg) => {
       version: z.string(),
       resolvedXml: z.string(),
       llmInstructions: z.string(),
-      warnings: z.array(z.string()).optional()
+      warnings: z.array(z.string()).optional(),
+      removedElementIds: z.array(z.string()).optional()
     },
-    handler: async ({ xmlStructure, elementConfig, style, parentId, dryRun }) => {
+    handler: async ({ xmlStructure, elementConfig, style, parentId, mode, dryRun }) => {
       const document2 = getCurrentDocument();
       if (!document2?.id) {
         throw new Error("No active document found.");
@@ -4512,6 +4516,7 @@ var initBuildCompositionTool = (reg) => {
             element_config: elementConfig ?? {},
             style: style ?? {},
             parent_id: parentId ?? "document",
+            mode: mode ?? "append",
             dry_run: dryRun ?? false
           }
         });
@@ -4532,7 +4537,8 @@ var initBuildCompositionTool = (reg) => {
           version: data.data.version,
           resolvedXml: data.data.resolved_xml,
           llmInstructions: data.data.llm_instructions,
-          warnings: data.data.warnings
+          warnings: data.data.warnings,
+          removedElementIds: data.data.removed_element_ids
         };
       } catch (error) {
         throw new Error(getMcpErrorMessage(error, "build-composition"));

package/package.json

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

package/src/mcp/tools/build-composition/tool.ts

@@ -17,6 +17,7 @@ type BuildCompositionResponse = {
 	resolved_xml: string;
 	llm_instructions: string;
 	warnings?: string[];
+	removed_element_ids?: string[];
 };
 
 export const initBuildCompositionTool = ( reg: MCPRegistryEntry ) => {
@@ -58,6 +59,12 @@ export const initBuildCompositionTool = ( reg: MCPRegistryEntry ) => {
 				.string()
 				.optional()
 				.describe( "ID of the parent container. Omit or pass 'document' to insert at document root." ),
+			mode: z
+				.enum( [ 'append', 'replace_children' ] )
+				.optional()
+				.describe(
+					"'append' (default) inserts under parentId; 'replace_children' removes existing direct children of parentId first, then inserts."
+				),
 			dryRun: z
 				.boolean()
 				.optional()
@@ -70,8 +77,9 @@ export const initBuildCompositionTool = ( reg: MCPRegistryEntry ) => {
 			resolvedXml: z.string(),
 			llmInstructions: z.string(),
 			warnings: z.array( z.string() ).optional(),
+			removedElementIds: z.array( z.string() ).optional(),
 		},
-		handler: async ( { xmlStructure, elementConfig, style, parentId, dryRun } ) => {
+		handler: async ( { xmlStructure, elementConfig, style, parentId, mode, dryRun } ) => {
 			const document = getCurrentDocument();
 
 			if ( ! document?.id ) {
@@ -87,6 +95,7 @@ export const initBuildCompositionTool = ( reg: MCPRegistryEntry ) => {
 						element_config: elementConfig ?? {},
 						style: style ?? {},
 						parent_id: parentId ?? 'document',
+						mode: mode ?? 'append',
 						dry_run: dryRun ?? false,
 					},
 				} );
@@ -111,6 +120,7 @@ export const initBuildCompositionTool = ( reg: MCPRegistryEntry ) => {
 					resolvedXml: data.data.resolved_xml,
 					llmInstructions: data.data.llm_instructions,
 					warnings: data.data.warnings,
+					removedElementIds: data.data.removed_element_ids,
 				};
 			} catch ( error ) {
 				throw new Error( getMcpErrorMessage( error, 'build-composition' ) );