@elementor/editor-canvas 4.1.0-801 → 4.1.0-803

package/dist/index.mjs

@@ -45,12 +45,81 @@ var initBreakpointsResource = (reg) => {
 };
 
 // src/mcp/resources/widgets-schema-resource.ts
-import { getWidgetsCache } from "@elementor/editor-elements";
+import { getWidgetsCache as getWidgetsCache2 } from "@elementor/editor-elements";
 import { ResourceTemplate } from "@elementor/editor-mcp";
 import {
   Schema
 } from "@elementor/editor-props";
 import { getStylesSchema } from "@elementor/editor-styles";
+
+// src/mcp/utils/element-data-util.ts
+import { getWidgetsCache } from "@elementor/editor-elements";
+function hasV3Controls(controls) {
+  return typeof controls === "object" && controls !== null && Object.keys(controls).length > 0;
+}
+function isWidgetAvailableForLLM(config) {
+  if (!config) {
+    return false;
+  }
+  if (config.meta?.llm_support === false) {
+    return false;
+  }
+  if (config.atomic_props_schema) {
+    return true;
+  }
+  return hasV3Controls(config.controls);
+}
+function getWidgetVersion(config) {
+  return config?.atomic_props_schema ? "v4" : "v3";
+}
+function getAvailableWidgets() {
+  const cache = getWidgetsCache() ?? {};
+  return Object.keys(cache).filter((widgetType) => isWidgetAvailableForLLM(cache[widgetType])).sort().map((widgetType) => {
+    const config = cache[widgetType];
+    const description = typeof config?.meta?.description === "string" ? config.meta.description : void 0;
+    return {
+      type: widgetType,
+      version: getWidgetVersion(config),
+      ...description && { description }
+    };
+  });
+}
+
+// src/mcp/resources/widgets-schema-resource.ts
+var V3_LAYOUT_CONTROL_TYPES = /* @__PURE__ */ new Set(["section", "tab", "tabs"]);
+function extractV3ControlsMetadata(controls) {
+  if (!hasV3Controls(controls)) {
+    return {};
+  }
+  const result = {};
+  for (const [controlKey, raw] of Object.entries(controls)) {
+    if (!raw || typeof raw !== "object") {
+      continue;
+    }
+    const control = raw;
+    const controlType = typeof control.type === "string" ? control.type : void 0;
+    if (controlType && V3_LAYOUT_CONTROL_TYPES.has(controlType)) {
+      continue;
+    }
+    const entry = {};
+    if (Object.prototype.hasOwnProperty.call(control, "default")) {
+      entry.default = control.default;
+    }
+    if (controlType) {
+      entry.type = controlType;
+    }
+    if (Object.prototype.hasOwnProperty.call(control, "options") && control.options !== void 0) {
+      const options = control.options;
+      if (options && typeof options === "object" && !Array.isArray(options)) {
+        entry.options = Object.keys(options);
+      } else {
+        entry.options = options;
+      }
+    }
+    result[controlKey] = entry;
+  }
+  return result;
+}
 var WIDGET_SCHEMA_URI = "elementor://widgets/schema/{widgetType}";
 var STYLE_SCHEMA_URI = "elementor://styles/schema/{category}";
 var BEST_PRACTICES_URI = "elementor://styles/best-practices";
@@ -98,7 +167,7 @@ Variables from the user context ARE NOT SUPPORTED AND WILL RESOLVE IN ERROR.
       }
     }),
     {
-      description: "Common styles schema for the specified category"
+      description: "Common styles schema for the specified category (applicable for V4 elements only)"
     },
     async (uri, variables) => {
       const category = typeof variables.category === "string" ? variables.category : variables.category?.[0];
@@ -124,9 +193,9 @@ Variables from the user context ARE NOT SUPPORTED AND WILL RESOLVE IN ERROR.
     "widget-schema-by-type",
     new ResourceTemplate(WIDGET_SCHEMA_URI, {
       list: () => {
-        const cache = getWidgetsCache() || {};
-        const availableWidgets = Object.keys(cache || {}).filter(
-          (widgetType) => cache[widgetType]?.atomic_props_schema && cache[widgetType].meta?.llm_support !== false
+        const cache = getWidgetsCache2() || {};
+        const availableWidgets = Object.keys(cache).filter(
+          (widgetType) => isWidgetAvailableForLLM(cache[widgetType])
         );
         return {
           resources: availableWidgets.map((widgetType) => ({
@@ -141,11 +210,31 @@ Variables from the user context ARE NOT SUPPORTED AND WILL RESOLVE IN ERROR.
     },
     async (uri, variables) => {
       const widgetType = typeof variables.widgetType === "string" ? variables.widgetType : variables.widgetType?.[0];
-      const widgetData = getWidgetsCache()?.[widgetType];
-      const propSchema = widgetData?.atomic_props_schema;
-      if (!propSchema || !widgetData) {
+      const widgetData = getWidgetsCache2()?.[widgetType];
+      if (!widgetData) {
         throw new Error(`No prop schema found for element type: ${widgetType}`);
       }
+      const propSchema = widgetData.atomic_props_schema;
+      if (!propSchema) {
+        if (!hasV3Controls(widgetData.controls)) {
+          throw new Error(`No prop schema found for element type: ${widgetType}`);
+        }
+        const controlMetadata = extractV3ControlsMetadata(widgetData.controls);
+        return {
+          contents: [
+            {
+              uri: uri.toString(),
+              mimeType: "application/json",
+              text: JSON.stringify({
+                widget_version: "v3",
+                message: "This widget exists in the editor but has no atomic props schema (V4). Use control_metadata as non-authoritative hints from legacy controls.",
+                fields_note: "All settings are optional; there is no JSON schema for this widget type.",
+                properties: controlMetadata
+              })
+            }
+          ]
+        };
+      }
       const asJson = Object.fromEntries(
         Object.entries(propSchema).map(([key, propType]) => [
           key,
@@ -174,7 +263,7 @@ Variables from the user context ARE NOT SUPPORTED AND WILL RESOLVE IN ERROR.
         llmGuidance.default_styles = defaultStyles;
       }
       const allowedChildTypes = widgetData.allowed_child_types;
-      const allWidgets = getWidgetsCache() || {};
+      const allWidgets = getWidgetsCache2() || {};
       const allowedParents = Object.entries(allWidgets).filter(([, parentConfig]) => parentConfig.allowed_child_types?.includes(widgetType)).map(([parentType]) => parentType);
       if (allowedChildTypes?.length || allowedParents.length) {
         llmGuidance.nesting = {
@@ -1876,7 +1965,7 @@ function initStyleTransformers() {
 }
 
 // src/legacy/init-legacy-views.ts
-import { getWidgetsCache as getWidgetsCache2 } from "@elementor/editor-elements";
+import { getWidgetsCache as getWidgetsCache3 } from "@elementor/editor-elements";
 import { __privateListenTo, v1ReadyEvent as v1ReadyEvent2 } from "@elementor/editor-v1-adapters";
 
 // src/renderers/create-dom-renderer.ts
@@ -3121,7 +3210,7 @@ function registerElementType(type, elementTypeGenerator) {
 }
 function initLegacyViews() {
   __privateListenTo(v1ReadyEvent2(), () => {
-    const widgetsCache = getWidgetsCache2() ?? {};
+    const widgetsCache = getWidgetsCache3() ?? {};
     const legacyWindow = window;
     const renderer = createDomRenderer();
     registerProPromotionTypes(widgetsCache);
@@ -3207,7 +3296,67 @@ function initTabsModelExtensions() {
   registerModelExtensions("e-tab", tabModelExtensions);
 }
 
+// src/mcp/resources/available-widgets-resource.ts
+import { v1ReadyEvent as v1ReadyEvent3 } from "@elementor/editor-v1-adapters";
+var AVAILABLE_WIDGETS_URI = "elementor://context/available-widgets";
+var AVAILABLE_WIDGETS_URI_V4 = "elementor://context/available-widgets/v4";
+var initAvailableWidgetsResource = (reg) => {
+  const { resource, sendResourceUpdated } = reg;
+  const buildContents = (uri, filterFunction = () => true) => {
+    const widgets = getAvailableWidgets().filter(filterFunction);
+    return {
+      contents: [
+        {
+          uri,
+          mimeType: "application/json",
+          text: JSON.stringify(widgets, null, 2)
+        }
+      ]
+    };
+  };
+  const notifyResourcesUpdated = () => {
+    sendResourceUpdated({
+      uri: AVAILABLE_WIDGETS_URI,
+      ...buildContents(AVAILABLE_WIDGETS_URI)
+    });
+    sendResourceUpdated({
+      uri: AVAILABLE_WIDGETS_URI_V4,
+      ...buildContents(AVAILABLE_WIDGETS_URI_V4, (w) => w.version === "v4")
+    });
+  };
+  resource(
+    "available-widgets-v4",
+    AVAILABLE_WIDGETS_URI_V4,
+    {
+      description: "All registered v4 version widgets"
+    },
+    async () => buildContents(AVAILABLE_WIDGETS_URI_V4, (w) => w.version === "v4")
+  );
+  resource(
+    "available-widgets",
+    AVAILABLE_WIDGETS_URI,
+    {
+      description: "All registered widget types with v3/v4 version metadata and description."
+    },
+    async () => buildContents(AVAILABLE_WIDGETS_URI)
+  );
+  const eventName = v1ReadyEvent3().name;
+  const onV1Ready = () => {
+    const widgets = getAvailableWidgets();
+    if (widgets.length === 0) {
+      return;
+    }
+    window.removeEventListener(eventName, onV1Ready);
+    notifyResourcesUpdated();
+  };
+  window.addEventListener(eventName, onV1Ready);
+  onV1Ready();
+};
+
 // src/mcp/resources/document-structure-resource.ts
+import {
+  getWidgetsCache as getWidgetsCache4
+} from "@elementor/editor-elements";
 import { __privateListenTo as listenTo, commandEndEvent as commandEndEvent4 } from "@elementor/editor-v1-adapters";
 var DOCUMENT_STRUCTURE_URI = "elementor://document/structure";
 var initDocumentStructureResource = (reg) => {
@@ -3228,7 +3377,8 @@ var initDocumentStructureResource = (reg) => {
       commandEndEvent4("document/elements/move"),
       commandEndEvent4("document/elements/copy"),
       commandEndEvent4("document/elements/paste"),
-      commandEndEvent4("editor/documents/attach-preview")
+      commandEndEvent4("editor/documents/attach-preview"),
+      commandEndEvent4("editor/documents/switch")
     ],
     updateDocumentStructure
   );
@@ -3258,9 +3408,7 @@ function getDocumentStructure() {
     return { error: "No active document found" };
   }
   const containers = document2.container?.children || [];
-  const elements = containers.map(
-    (container) => extractElementData(container)
-  );
+  const elements = containers.map((container) => extractElementData(container));
   return {
     documentId: document2.id,
     documentType: document2.config.type,
@@ -3268,6 +3416,16 @@ function getDocumentStructure() {
     elements: elements.filter((el) => el !== null)
   };
 }
+function resolveElementVersion(element) {
+  if (element.model?.config?.atomic) {
+    return "v4";
+  }
+  const widgetType = element.model?.attributes?.widgetType;
+  if (widgetType && getWidgetsCache4()?.[widgetType]?.atomic_props_schema) {
+    return "v4";
+  }
+  return "v3";
+}
 function extractElementData(element) {
   if (!element || !element.model) {
     return null;
@@ -3276,7 +3434,8 @@ function extractElementData(element) {
   const result = {
     id: model.id,
     elType: model.elType,
-    widgetType: model.widgetType || void 0
+    widgetType: model.widgetType || void 0,
+    version: resolveElementVersion(element)
   };
   const title = model.title || element.model?.editor_settings?.title;
   if (title) {
@@ -3288,28 +3447,346 @@ function extractElementData(element) {
   return result;
 }
 
+// src/mcp/resources/editor-state-resource.ts
+import { __privateListenTo as listenTo2, commandEndEvent as commandEndEvent5 } from "@elementor/editor-v1-adapters";
+var CURRENTLY_VIEWED_SCREEN = "The user is currently viewing the Elementor editor";
+var PAGE_CONTENT_CHARACTER_LIMIT = 500;
+var PREVIEW_TEXT_NODE_MIN_LENGTH = 2;
+var EDITOR_STATE_URI = "elementor://context/editor-state";
+var initEditorStateResource = (reg) => {
+  const { resource, sendResourceUpdated } = reg;
+  let lastSerializedState = "";
+  const buildState = () => ({
+    currentlyViewedScreen: CURRENTLY_VIEWED_SCREEN,
+    pageContent: getPageContentFromPreview(),
+    pageTitle: getPageTitle()
+  });
+  const notifyIfChanged = () => {
+    const serialized = JSON.stringify(buildState());
+    if (serialized === lastSerializedState) {
+      return;
+    }
+    lastSerializedState = serialized;
+    sendResourceUpdated({ uri: EDITOR_STATE_URI });
+  };
+  listenTo2(
+    [commandEndEvent5("editor/documents/switch"), commandEndEvent5("editor/documents/attach-preview")],
+    notifyIfChanged
+  );
+  lastSerializedState = JSON.stringify(buildState());
+  resource(
+    "editor-state",
+    EDITOR_STATE_URI,
+    {
+      description: "Editor page title, preview text snapshot, and viewed screen label."
+    },
+    async () => {
+      return {
+        contents: [
+          {
+            uri: EDITOR_STATE_URI,
+            text: JSON.stringify(buildState(), null, 2)
+          }
+        ]
+      };
+    }
+  );
+};
+function getPageContentFromPreview() {
+  try {
+    const root = window.elementor?.$previewContents?.[0];
+    if (!root) {
+      return null;
+    }
+    const content = [];
+    const clone = root.cloneNode(true);
+    clone.querySelectorAll(".elementor-editor-element-settings, #elementor-add-new-section").forEach((el) => {
+      el.remove();
+    });
+    const walk = (node, insideElementorElement = false) => {
+      const isInside = node.classList?.contains("elementor-element") || insideElementorElement;
+      if (node.nodeType === Node.TEXT_NODE && isInside) {
+        const text2 = node.textContent?.trim().replace(/\s+/g, " ");
+        if (text2 && text2.length > PREVIEW_TEXT_NODE_MIN_LENGTH) {
+          content.push(text2);
+        }
+      } else {
+        node.childNodes.forEach((child) => {
+          walk(child, isInside);
+        });
+      }
+    };
+    walk(clone);
+    const text = content.join(" ");
+    if (text.length > PAGE_CONTENT_CHARACTER_LIMIT) {
+      return text.slice(0, PAGE_CONTENT_CHARACTER_LIMIT) + "...";
+    }
+    return text;
+  } catch {
+    return null;
+  }
+}
+function getPageTitle() {
+  try {
+    const extendedWindow = window;
+    const currentDocument = extendedWindow.elementor?.documents?.getCurrent?.();
+    const postTitle = currentDocument?.config?.settings?.post_title;
+    if (postTitle) {
+      return postTitle;
+    }
+    let title = document.title || "Page";
+    title = title.split(/\s*[‹»|–—-]\s*/)[0];
+    const trimmed = title.trim();
+    return trimmed || "Page";
+  } catch {
+    return "Page";
+  }
+}
+
+// src/mcp/resources/general-context-resource.ts
+import { __privateListenTo as listenTo3, commandEndEvent as commandEndEvent6 } from "@elementor/editor-v1-adapters";
+var GENERAL_CONTEXT_URI = "elementor://context/general";
+var initGeneralContextResource = (reg) => {
+  const { resource, sendResourceUpdated } = reg;
+  let lastSerializedPayload = null;
+  const getPageTitle2 = () => {
+    const extendedWindow = window;
+    const title = extendedWindow.elementor?.documents?.getCurrent?.()?.config?.settings?.post_title;
+    if (!title?.trim()) {
+      return null;
+    }
+    return title;
+  };
+  const buildPayload = () => {
+    const extendedWindow = window;
+    const timezone = Intl.DateTimeFormat().resolvedOptions().timeZone;
+    const postParam = new URLSearchParams(location.search).get("post");
+    const parsedPostId = postParam ? Number(postParam) : null;
+    const postId = parsedPostId !== null && Number.isFinite(parsedPostId) ? parsedPostId : null;
+    const pageTitle = getPageTitle2();
+    const urlObject = new URL(window.location.href);
+    const pageUrl = urlObject.pathname + urlObject.search;
+    const pageName = pageTitle || "Elementor Editor";
+    const plugins = extendedWindow.angieConfig?.plugins;
+    return {
+      timezone,
+      postId,
+      currentPage: {
+        pageName,
+        pageTitle,
+        pageUrl
+      },
+      ...plugins && { plugins }
+    };
+  };
+  const pushUpdateIfChanged = () => {
+    const serialized = JSON.stringify(buildPayload());
+    if (serialized === lastSerializedPayload) {
+      return;
+    }
+    lastSerializedPayload = serialized;
+    sendResourceUpdated({ uri: GENERAL_CONTEXT_URI });
+  };
+  resource(
+    "general-context",
+    GENERAL_CONTEXT_URI,
+    {
+      description: "General context: timezone, post id, and current page."
+    },
+    async () => {
+      return {
+        contents: [
+          {
+            uri: GENERAL_CONTEXT_URI,
+            mimeType: "application/json",
+            text: JSON.stringify(buildPayload(), null, 2)
+          }
+        ]
+      };
+    }
+  );
+  listenTo3(
+    [
+      commandEndEvent6("editor/documents/switch"),
+      commandEndEvent6("editor/documents/attach-preview"),
+      commandEndEvent6("document/elements/settings")
+    ],
+    pushUpdateIfChanged
+  );
+  pushUpdateIfChanged();
+};
+
+// src/mcp/resources/selected-element-resource.ts
+import { getContainer as getContainer2, getSelectedElements, getWidgetsCache as getWidgetsCache5 } from "@elementor/editor-elements";
+import {
+  __privateListenTo as listenTo4,
+  commandEndEvent as commandEndEvent7
+} from "@elementor/editor-v1-adapters";
+var SELECTED_ELEMENT_URI = "elementor://context/selected-element";
+var initSelectedElementResource = (reg) => {
+  const { resource, sendResourceUpdated } = reg;
+  let currentPayloadText = null;
+  const publishIfChanged = (payload) => {
+    const nextText = JSON.stringify(payload);
+    if (nextText !== currentPayloadText) {
+      currentPayloadText = nextText;
+      sendResourceUpdated({ uri: SELECTED_ELEMENT_URI });
+    }
+  };
+  const onCommand = (e) => {
+    if (e.type !== "command") {
+      return;
+    }
+    const commandEvent = e;
+    if (commandEvent.command === "document/elements/deselect-all") {
+      publishIfChanged(createEmptySelectedElementPayload());
+      return;
+    }
+    if (commandEvent.command !== "document/elements/select" && commandEvent.command !== "document/elements/settings") {
+      return;
+    }
+    const { container } = commandEvent.args || {};
+    if (container?.id) {
+      publishIfChanged(buildPayloadFromContainer(container));
+      return;
+    }
+    publishIfChanged(readSelectionFromEditor());
+  };
+  listenTo4(
+    [
+      commandEndEvent7("document/elements/select"),
+      commandEndEvent7("document/elements/deselect-all"),
+      commandEndEvent7("document/elements/settings")
+    ],
+    onCommand
+  );
+  publishIfChanged(readSelectionFromEditor());
+  resource(
+    "selected-element",
+    SELECTED_ELEMENT_URI,
+    {
+      description: "Currently selected Elementor element context."
+    },
+    async () => {
+      return {
+        contents: [
+          {
+            uri: SELECTED_ELEMENT_URI,
+            text: JSON.stringify(readSelectionFromEditor(), null, 2)
+          }
+        ]
+      };
+    }
+  );
+};
+function createEmptySelectedElementPayload() {
+  return {
+    elementDisplayName: null,
+    elementType: null,
+    properties: null,
+    selectedElementId: null,
+    selectedParentId: null,
+    version: null,
+    widgetType: null
+  };
+}
+function readSelectionFromEditor() {
+  const elements = getSelectedElements();
+  if (elements.length !== 1) {
+    return createEmptySelectedElementPayload();
+  }
+  const container = getContainer2(elements[0].id);
+  return buildPayloadFromContainer(container);
+}
+function buildPayloadFromContainer(container) {
+  if (!container?.id) {
+    return createEmptySelectedElementPayload();
+  }
+  const widgetType = container.model.get("widgetType") ?? null;
+  const elementType = container.type ?? "widget";
+  return {
+    elementDisplayName: getElementDisplayName(container),
+    elementType,
+    properties: getElementProperties(container, widgetType),
+    selectedElementId: container.id,
+    selectedParentId: container.parent?.id ?? null,
+    version: resolveElementVersion2(container, widgetType),
+    widgetType
+  };
+}
+function resolveElementVersion2(container, widgetType) {
+  if (container.model?.config?.atomic) {
+    return "v4";
+  }
+  if (widgetType && getWidgetsCache5()?.[widgetType]?.atomic_props_schema) {
+    return "v4";
+  }
+  return "v3";
+}
+function getElementProperties(container, widgetType) {
+  const settings = container.settings?.toJSON?.();
+  if (!settings || typeof settings !== "object") {
+    return null;
+  }
+  const widgetConfig = widgetType ? getWidgetsCache5()?.[widgetType] : null;
+  const controls = widgetConfig?.controls;
+  const filtered = {};
+  for (const [key, value] of Object.entries(settings)) {
+    if (value === void 0 || value === null || value === "") {
+      continue;
+    }
+    const controlDefault = controls?.[key]?.default;
+    if (controlDefault !== void 0 && JSON.stringify(value) === JSON.stringify(controlDefault)) {
+      continue;
+    }
+    filtered[key] = value;
+  }
+  return Object.keys(filtered).length > 0 ? filtered : null;
+}
+function getElementDisplayName(container) {
+  try {
+    if (container.label) {
+      return container.label;
+    }
+    const widgetType = container.model?.get?.("widgetType");
+    if (widgetType) {
+      const capitalizedType = widgetType.charAt(0).toUpperCase() + widgetType.slice(1);
+      return capitalizedType.replace(/-/g, " ");
+    }
+    if (container.type === "container") {
+      return "Container";
+    }
+    if (container.type === "section") {
+      return "Section";
+    }
+    return `Element ${container.id}`;
+  } catch {
+    return `Element ${container.id}`;
+  }
+}
+
 // src/mcp/tools/build-composition/tool.ts
 import { getCurrentDocument } from "@elementor/editor-documents";
 import {
   createElement as createElement8,
   deleteElement,
-  getContainer as getContainer3,
-  getWidgetsCache as getWidgetsCache6
+  getContainer as getContainer4,
+  getWidgetsCache as getWidgetsCache9
 } from "@elementor/editor-elements";
 
 // src/composition-builder/composition-builder.ts
 import {
   createElement as createElement7,
   generateElementId,
-  getContainer as getContainer2,
-  getWidgetsCache as getWidgetsCache5
+  getContainer as getContainer3,
+  getWidgetsCache as getWidgetsCache8
 } from "@elementor/editor-elements";
 
 // src/mcp/utils/do-update-element-property.ts
 import {
   createElementStyle,
   getElementStyles,
-  getWidgetsCache as getWidgetsCache3,
+  getWidgetsCache as getWidgetsCache6,
   updateElementSettings,
   updateElementStyle
 } from "@elementor/editor-elements";
@@ -3402,7 +3879,7 @@ var doUpdateElementProperty = (params) => {
     }
     return;
   }
-  const elementPropSchema = getWidgetsCache3()?.[elementType]?.atomic_props_schema;
+  const elementPropSchema = getWidgetsCache6()?.[elementType]?.atomic_props_schema;
   if (!elementPropSchema) {
     throw new Error(`No prop schema found for element type: ${elementType}`);
   }
@@ -3426,7 +3903,7 @@ var doUpdateElementProperty = (params) => {
 };
 
 // src/mcp/utils/validate-input.ts
-import { getWidgetsCache as getWidgetsCache4 } from "@elementor/editor-elements";
+import { getWidgetsCache as getWidgetsCache7 } from "@elementor/editor-elements";
 import { Schema as Schema3 } from "@elementor/editor-props";
 import { getStylesSchema as getStylesSchema4 } from "@elementor/editor-styles";
 var _widgetsSchema = null;
@@ -3434,7 +3911,7 @@ var validateInput = {
   get widgetsSchema() {
     if (!_widgetsSchema) {
       const schema2 = {};
-      const cache = getWidgetsCache4();
+      const cache = getWidgetsCache7();
       if (!cache) {
         return {};
       }
@@ -3518,9 +3995,9 @@ var CompositionBuilder = class _CompositionBuilder {
   rootContainers = [];
   api = {
     createElement: createElement7,
-    getWidgetsCache: getWidgetsCache5,
+    getWidgetsCache: getWidgetsCache8,
     generateElementId,
-    getContainer: getContainer2,
+    getContainer: getContainer3,
     doUpdateElementProperty
   };
   xml;
@@ -3763,6 +4240,10 @@ var generatePrompt = () => {
 # RESOURCES (Read before use)
 - [elementor://global-classes] - Check FIRST for reusable classes
 - [elementor://global-variables] - ONLY use variables defined here
+- [${AVAILABLE_WIDGETS_URI}/v4]
+
+# TOOL SUUPORT
+This tool support v4 elements only
 
 # WORKFLOW
 1. Check/create global classes via "create-global-class" tool
@@ -3944,24 +4425,26 @@ var initBuildCompositionsTool = (reg) => {
       { description: "Styles schema", uri: STYLE_SCHEMA_URI },
       { description: "Global Classes", uri: "elementor://global-classes" },
       { description: "Global Variables", uri: "elementor://global-variables" },
-      { description: "Styles best practices", uri: BEST_PRACTICES_URI }
+      { description: "Styles best practices", uri: BEST_PRACTICES_URI },
+      { description: "Available widgets for this tool", uri: AVAILABLE_WIDGETS_URI_V4 }
     ],
     outputSchema,
     modelPreferences: {
       hints: [{ name: "claude-sonnet-4-5" }]
     },
     handler: async (params) => {
+      assertCompositionXmlUsesV4WidgetsOnly(params.xmlStructure);
       const { xmlStructure, elementConfig, stylesConfig, customCSS } = params;
       let generatedXML = "";
       const errors = [];
       const rootContainers = [];
-      const documentContainer = getContainer3("document");
+      const documentContainer = getContainer4("document");
       const currentDocument = getCurrentDocument();
       const targetContainer = getCompositionTargetContainer(documentContainer, currentDocument?.type.value);
       try {
         const compositionBuilder = CompositionBuilder.fromXMLString(xmlStructure, {
           createElement: createElement8,
-          getWidgetsCache: getWidgetsCache6
+          getWidgetsCache: getWidgetsCache9
         });
         compositionBuilder.setElementConfig(elementConfig);
         compositionBuilder.setStylesConfig(stylesConfig);
@@ -4038,6 +4521,31 @@ Remember: Global classes ensure design consistency and reusability. Don't skip a
     }
   });
 };
+function assertCompositionXmlUsesV4WidgetsOnly(xmlStructure) {
+  const doc = new DOMParser().parseFromString(xmlStructure, "application/xml");
+  if (doc.querySelector("parsererror")) {
+    throw new Error("Failed to parse XML string: " + doc);
+  }
+  const widgetsCache = getWidgetsCache9() ?? {};
+  for (const node of doc.querySelectorAll("*")) {
+    const type = node.tagName;
+    const widgetData = widgetsCache[type];
+    if (!widgetData) {
+      continue;
+    }
+    if (widgetData.elType !== "widget") {
+      continue;
+    }
+    if (!widgetData.atomic_props_schema) {
+      throw new Error(
+        `This tool does not support V3 elements. Please use the elementor-v3-mcp tools instead for element type: ${type}`
+      );
+    }
+  }
+}
+
+// src/mcp/tools/configure-element/tool.ts
+import { getWidgetsCache as getWidgetsCache10 } from "@elementor/editor-elements";
 
 // src/mcp/tools/configure-element/prompt.ts
 var configureElementToolPrompt = `Configure an existing element on the page.
@@ -4177,6 +4685,17 @@ var initConfigureElementTool = (reg) => {
       speedPriority: 0.7
     },
     handler: ({ elementId, propertiesToChange, elementType, stylePropertiesToChange }) => {
+      const widgetData = getWidgetsCache10()?.[elementType];
+      if (!widgetData) {
+        throw new Error(
+          `Unknown element type: ${elementType}. Check the available-widgets resource for valid types.`
+        );
+      }
+      if (!widgetData.atomic_props_schema) {
+        throw new Error(
+          `This tool does not support V3 elements. Please use the elementor-v3-mcp tools instead for element type: ${elementType}`
+        );
+      }
       const toUpdate = Object.entries(propertiesToChange);
       const { valid, errors } = validateInput.validatePropSchema(elementType, propertiesToChange);
       const { valid: stylesValid, errors: stylesErrors } = validateInput.validateStyles(
@@ -4258,7 +4777,7 @@ Check the styles schema at the resource [${STYLE_SCHEMA_URI.replace(
 }
 
 // src/mcp/tools/get-element-config/tool.ts
-import { getContainer as getContainer4, getElementStyles as getElementStyles2, getWidgetsCache as getWidgetsCache7 } from "@elementor/editor-elements";
+import { getContainer as getContainer5, getElementStyles as getElementStyles2, getWidgetsCache as getWidgetsCache11 } from "@elementor/editor-elements";
 import { Schema as Schema4 } from "@elementor/editor-props";
 import { z as z3 } from "@elementor/schema";
 var schema = {
@@ -4297,12 +4816,24 @@ var initGetElementConfigTool = (reg) => {
       speedPriority: 0.9
     },
     handler: async ({ elementId }) => {
-      const element = getContainer4(elementId);
+      const element = getContainer5(elementId);
       if (!element) {
         throw new Error(`Element with ID ${elementId} not found.`);
       }
+      const elementType = element.model.get("widgetType") || element.model.get("elType") || "";
+      const widgetData = getWidgetsCache11()?.[elementType];
+      if (!widgetData) {
+        throw new Error(
+          `Unknown element type: ${elementType}. Check the available-widgets resource for valid types.`
+        );
+      }
+      if (!widgetData.atomic_props_schema) {
+        throw new Error(
+          `This tool does not support V3 elements. Please use the elementor-v3-mcp tools instead for element type: ${elementType}`
+        );
+      }
       const elementRawSettings = element.settings;
-      const propSchema = getWidgetsCache7()?.[element.model.get("widgetType") || element.model.get("elType") || ""]?.atomic_props_schema;
+      const propSchema = getWidgetsCache11()?.[elementType]?.atomic_props_schema;
       if (!elementRawSettings || !propSchema) {
         throw new Error(`No settings or prop schema found for element ID: ${elementId}`);
       }
@@ -4354,7 +4885,11 @@ var initCanvasMcp = (reg) => {
 `
   );
   initWidgetsSchemaResource(reg);
+  initAvailableWidgetsResource(reg);
   initDocumentStructureResource(reg);
+  initSelectedElementResource(reg);
+  initEditorStateResource(reg);
+  initGeneralContextResource(reg);
   initBuildCompositionsTool(reg);
   initGetElementConfigTool(reg);
   initConfigureElementTool(reg);
@@ -4561,16 +5096,16 @@ function shouldBlock(sourceElements, targetElements) {
 }
 
 // src/style-commands/paste-style.ts
-import { getContainer as getContainer5, getElementSetting, updateElementSettings as updateElementSettings2 } from "@elementor/editor-elements";
+import { getContainer as getContainer6, getElementSetting, updateElementSettings as updateElementSettings2 } from "@elementor/editor-elements";
 import { classesPropTypeUtil } from "@elementor/editor-props";
 import {
-  __privateListenTo as listenTo2,
+  __privateListenTo as listenTo5,
   blockCommand as blockCommand4,
   commandStartEvent
 } from "@elementor/editor-v1-adapters";
 
 // src/utils/command-utils.ts
-import { getElementLabel as getElementLabel2, getWidgetsCache as getWidgetsCache8 } from "@elementor/editor-elements";
+import { getElementLabel as getElementLabel2, getWidgetsCache as getWidgetsCache12 } from "@elementor/editor-elements";
 import { CLASSES_PROP_KEY } from "@elementor/editor-props";
 import { __ as __5 } from "@wordpress/i18n";
 function hasAtomicWidgets(args) {
@@ -4595,7 +5130,7 @@ function getClassesProp(container) {
 }
 function getContainerSchema(container) {
   const type = container?.model.get("widgetType") || container?.model.get("elType");
-  const widgetsCache = getWidgetsCache8();
+  const widgetsCache = getWidgetsCache12();
   const elementType = widgetsCache?.[type];
   return elementType?.atomic_props_schema ?? null;
 }
@@ -4701,7 +5236,7 @@ function initPasteStyleCommand() {
     command: "document/elements/paste-style",
     condition: hasAtomicWidgets
   });
-  listenTo2(
+  listenTo5(
     commandStartEvent("document/elements/paste-style"),
     (e) => pasteStyles(e.args, pasteElementStyleCommand)
   );
@@ -4714,7 +5249,7 @@ function pasteStyles(args, pasteLocalStyle) {
   }
   const clipboardElements = getClipboardElements(storageKey);
   const [clipboardElement] = clipboardElements ?? [];
-  const clipboardContainer = getContainer5(clipboardElement.id);
+  const clipboardContainer = getContainer6(clipboardElement.id);
   if (!clipboardElement || !clipboardContainer || !isAtomicWidget(clipboardContainer)) {
     return;
   }
@@ -4754,7 +5289,7 @@ function pasteClasses(containers, classes) {
 
 // src/style-commands/reset-style.ts
 import {
-  __privateListenTo as listenTo3,
+  __privateListenTo as listenTo6,
   blockCommand as blockCommand5,
   commandStartEvent as commandStartEvent2
 } from "@elementor/editor-v1-adapters";
@@ -4812,7 +5347,7 @@ function initResetStyleCommand() {
     command: "document/elements/reset-style",
     condition: hasAtomicWidgets
   });
-  listenTo3(
+  listenTo6(
     commandStartEvent2("document/elements/reset-style"),
     (e) => resetStyles(e.args, resetElementStyles)
   );