@elementor/editor-canvas 4.3.0-967 → 4.3.0-968

package/dist/index.js

@@ -2641,11 +2641,11 @@ function getVal2(val) {
 var transformOriginTransformer = createTransformer((value) => {
   const x = getVal2(value.x);
   const y = getVal2(value.y);
-  const z4 = getVal2(value.z);
-  if (x === DEFAULT_XY && y === DEFAULT_XY && z4 === DEFAULT_Z) {
+  const z5 = getVal2(value.z);
+  if (x === DEFAULT_XY && y === DEFAULT_XY && z5 === DEFAULT_Z) {
     return null;
   }
-  return `${x} ${y} ${z4}`;
+  return `${x} ${y} ${z5}`;
 });
 
 // src/transformers/styles/transform-rotate-transformer.ts
@@ -5911,21 +5911,62 @@ Provide styling as raw CSS via the "style" parameter (a flat map of CSS property
 }`;
 }
 
+// src/mcp/tools/create-element/tool.ts
+var import_editor_documents4 = require("@elementor/editor-documents");
+var import_http_client2 = require("@elementor/http-client");
+var import_schema5 = require("@elementor/schema");
+var MCP_PROXY_URL = "elementor/v1/mcp-proxy";
+var initCreateElementTool = (reg) => {
+  const { addTool } = reg;
+  addTool({
+    name: "create-element",
+    description: "Insert a new element into the current Elementor document via the server-side MCP ability. The document is saved as a draft. Reload the editor after calling this tool to see the result.",
+    schema: {
+      elementType: import_schema5.z.string().describe("Registry identifier of the element to create, e.g. 'e-heading', 'e-flexbox'."),
+      parentId: import_schema5.z.string().optional().describe("ID of the parent container. Omit or pass 'document' to insert at the document root.")
+    },
+    outputSchema: {
+      elementId: import_schema5.z.string(),
+      previewUrl: import_schema5.z.string(),
+      version: import_schema5.z.string()
+    },
+    handler: async ({ elementType, parentId }) => {
+      const document2 = (0, import_editor_documents4.getCurrentDocument)();
+      if (!document2?.id) {
+        throw new Error("No active document found.");
+      }
+      const { data } = await (0, import_http_client2.httpService)().post(MCP_PROXY_URL, {
+        tool: "create-element",
+        input: {
+          parent_id: parentId ?? "document",
+          element: { type: elementType },
+          post_id: document2.id
+        }
+      });
+      return {
+        elementId: data.data.element_id,
+        previewUrl: data.data.preview_url,
+        version: data.data.version
+      };
+    }
+  });
+};
+
 // src/mcp/tools/get-element-config/tool.ts
 var import_editor_elements18 = require("@elementor/editor-elements");
 var import_editor_props10 = require("@elementor/editor-props");
-var import_schema5 = require("@elementor/schema");
+var import_schema6 = require("@elementor/schema");
 var schema = {
-  elementId: import_schema5.z.string()
+  elementId: import_schema6.z.string()
 };
 var outputSchema3 = {
-  properties: import_schema5.z.record(import_schema5.z.string(), import_schema5.z.any()).describe("A record mapping PropTypes to their corresponding PropValues"),
-  style: import_schema5.z.record(import_schema5.z.string(), import_schema5.z.any()).describe("A record mapping StyleSchema properties to their corresponding PropValues"),
-  childElements: import_schema5.z.array(
-    import_schema5.z.object({
-      id: import_schema5.z.string(),
-      elementType: import_schema5.z.string(),
-      childElements: import_schema5.z.array(import_schema5.z.any()).describe("An array of child element IDs, when applicable, same structure recursively")
+  properties: import_schema6.z.record(import_schema6.z.string(), import_schema6.z.any()).describe("A record mapping PropTypes to their corresponding PropValues"),
+  style: import_schema6.z.record(import_schema6.z.string(), import_schema6.z.any()).describe("A record mapping StyleSchema properties to their corresponding PropValues"),
+  childElements: import_schema6.z.array(
+    import_schema6.z.object({
+      id: import_schema6.z.string(),
+      elementType: import_schema6.z.string(),
+      childElements: import_schema6.z.array(import_schema6.z.any()).describe("An array of child element IDs, when applicable, same structure recursively")
     })
   ).describe("An array of child element IDs, when applicable, with recursive structure")
 };
@@ -6017,6 +6058,7 @@ var initCanvasMcp = (reg) => {
   initBuildCompositionsTool(reg);
   initGetElementConfigTool(reg);
   initConfigureElementTool(reg);
+  initCreateElementTool(reg);
   initBreakpointsResource(reg);
 };
 

package/dist/index.mjs

@@ -2595,11 +2595,11 @@ function getVal2(val) {
 var transformOriginTransformer = createTransformer((value) => {
   const x = getVal2(value.x);
   const y = getVal2(value.y);
-  const z4 = getVal2(value.z);
-  if (x === DEFAULT_XY && y === DEFAULT_XY && z4 === DEFAULT_Z) {
+  const z5 = getVal2(value.z);
+  if (x === DEFAULT_XY && y === DEFAULT_XY && z5 === DEFAULT_Z) {
     return null;
   }
-  return `${x} ${y} ${z4}`;
+  return `${x} ${y} ${z5}`;
 });
 
 // src/transformers/styles/transform-rotate-transformer.ts
@@ -5896,21 +5896,62 @@ Provide styling as raw CSS via the "style" parameter (a flat map of CSS property
 }`;
 }
 
+// src/mcp/tools/create-element/tool.ts
+import { getCurrentDocument as getCurrentDocument2 } from "@elementor/editor-documents";
+import { httpService as httpService2 } from "@elementor/http-client";
+import { z as z3 } from "@elementor/schema";
+var MCP_PROXY_URL = "elementor/v1/mcp-proxy";
+var initCreateElementTool = (reg) => {
+  const { addTool } = reg;
+  addTool({
+    name: "create-element",
+    description: "Insert a new element into the current Elementor document via the server-side MCP ability. The document is saved as a draft. Reload the editor after calling this tool to see the result.",
+    schema: {
+      elementType: z3.string().describe("Registry identifier of the element to create, e.g. 'e-heading', 'e-flexbox'."),
+      parentId: z3.string().optional().describe("ID of the parent container. Omit or pass 'document' to insert at the document root.")
+    },
+    outputSchema: {
+      elementId: z3.string(),
+      previewUrl: z3.string(),
+      version: z3.string()
+    },
+    handler: async ({ elementType, parentId }) => {
+      const document2 = getCurrentDocument2();
+      if (!document2?.id) {
+        throw new Error("No active document found.");
+      }
+      const { data } = await httpService2().post(MCP_PROXY_URL, {
+        tool: "create-element",
+        input: {
+          parent_id: parentId ?? "document",
+          element: { type: elementType },
+          post_id: document2.id
+        }
+      });
+      return {
+        elementId: data.data.element_id,
+        previewUrl: data.data.preview_url,
+        version: data.data.version
+      };
+    }
+  });
+};
+
 // src/mcp/tools/get-element-config/tool.ts
 import { getContainer as getContainer7, getElementStyles as getElementStyles2, getWidgetsCache as getWidgetsCache11 } from "@elementor/editor-elements";
 import { Schema as Schema5 } from "@elementor/editor-props";
-import { z as z3 } from "@elementor/schema";
+import { z as z4 } from "@elementor/schema";
 var schema = {
-  elementId: z3.string()
+  elementId: z4.string()
 };
 var outputSchema3 = {
-  properties: z3.record(z3.string(), z3.any()).describe("A record mapping PropTypes to their corresponding PropValues"),
-  style: z3.record(z3.string(), z3.any()).describe("A record mapping StyleSchema properties to their corresponding PropValues"),
-  childElements: z3.array(
-    z3.object({
-      id: z3.string(),
-      elementType: z3.string(),
-      childElements: z3.array(z3.any()).describe("An array of child element IDs, when applicable, same structure recursively")
+  properties: z4.record(z4.string(), z4.any()).describe("A record mapping PropTypes to their corresponding PropValues"),
+  style: z4.record(z4.string(), z4.any()).describe("A record mapping StyleSchema properties to their corresponding PropValues"),
+  childElements: z4.array(
+    z4.object({
+      id: z4.string(),
+      elementType: z4.string(),
+      childElements: z4.array(z4.any()).describe("An array of child element IDs, when applicable, same structure recursively")
     })
   ).describe("An array of child element IDs, when applicable, with recursive structure")
 };
@@ -6002,6 +6043,7 @@ var initCanvasMcp = (reg) => {
   initBuildCompositionsTool(reg);
   initGetElementConfigTool(reg);
   initConfigureElementTool(reg);
+  initCreateElementTool(reg);
   initBreakpointsResource(reg);
 };
 

package/package.json

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

package/src/mcp/canvas-mcp.ts

@@ -11,6 +11,7 @@ import { initSelectedElementResource } from './resources/selected-element-resour
 import { initWidgetsSchemaResource } from './resources/widgets-schema-resource';
 import { initBuildCompositionsTool } from './tools/build-composition/tool';
 import { initConfigureElementTool } from './tools/configure-element/tool';
+import { initCreateElementTool } from './tools/create-element/tool';
 import { initGetElementConfigTool } from './tools/get-element-config/tool';
 import { getDynamicTagNamesByCategories } from './utils/resolve-dynamic-tag';
 
@@ -29,5 +30,6 @@ export const initCanvasMcp = ( reg: MCPRegistryEntry ) => {
 	initBuildCompositionsTool( reg );
 	initGetElementConfigTool( reg );
 	initConfigureElementTool( reg );
+	initCreateElementTool( reg );
 	initBreakpointsResource( reg );
 };

package/src/mcp/tools/create-element/tool.ts

@@ -0,0 +1,61 @@
+import { getCurrentDocument } from '@elementor/editor-documents';
+import { type MCPRegistryEntry } from '@elementor/editor-mcp';
+import { type HttpResponse, httpService } from '@elementor/http-client';
+import { z } from '@elementor/schema';
+
+const MCP_PROXY_URL = 'elementor/v1/mcp-proxy';
+
+type CreateElementResponse = {
+	success: boolean;
+	post_id: number;
+	element_id: string;
+	version: string;
+	preview_url: string;
+};
+
+export const initCreateElementTool = ( reg: MCPRegistryEntry ) => {
+	const { addTool } = reg;
+
+	addTool( {
+		name: 'create-element',
+		description:
+			'Insert a new element into the current Elementor document via the server-side MCP ability. ' +
+			'The document is saved as a draft. Reload the editor after calling this tool to see the result.',
+		schema: {
+			elementType: z
+				.string()
+				.describe( "Registry identifier of the element to create, e.g. 'e-heading', 'e-flexbox'." ),
+			parentId: z
+				.string()
+				.optional()
+				.describe( "ID of the parent container. Omit or pass 'document' to insert at the document root." ),
+		},
+		outputSchema: {
+			elementId: z.string(),
+			previewUrl: z.string(),
+			version: z.string(),
+		},
+		handler: async ( { elementType, parentId } ) => {
+			const document = getCurrentDocument();
+
+			if ( ! document?.id ) {
+				throw new Error( 'No active document found.' );
+			}
+
+			const { data } = await httpService().post< HttpResponse< CreateElementResponse > >( MCP_PROXY_URL, {
+				tool: 'create-element',
+				input: {
+					parent_id: parentId ?? 'document',
+					element: { type: elementType },
+					post_id: document.id,
+				},
+			} );
+
+			return {
+				elementId: data.data.element_id,
+				previewUrl: data.data.preview_url,
+				version: data.data.version,
+			};
+		},
+	} );
+};