@elementor/editor-canvas 4.3.3 → 4.3.5

package/dist/index.js

@@ -195,7 +195,7 @@ var convertCssToAtomic = async (style) => {
 
 // src/init.tsx
 var import_editor = require("@elementor/editor");
-var import_editor_mcp4 = require("@elementor/editor-mcp");
+var import_editor_mcp5 = require("@elementor/editor-mcp");
 
 // src/components/classes-rename.tsx
 var import_react = require("react");
@@ -2131,32 +2131,101 @@ function processSvgContent(svgText) {
   return svgElement.outerHTML;
 }
 
+// src/transformers/shared/svg-src-transformer.ts
+var import_wp_media = require("@elementor/wp-media");
+async function fetchSvgContent(url, signal) {
+  try {
+    const response = await fetch(url, { signal });
+    if (!response.ok) {
+      return null;
+    }
+    const contentType = response.headers.get("content-type") ?? "";
+    const isSvg = contentType.includes("svg") || contentType.includes("xml") || url.endsWith(".svg");
+    if (!isSvg) {
+      return null;
+    }
+    return await response.text();
+  } catch {
+    return null;
+  }
+}
+function resolveSvgSrcId(id) {
+  if (typeof id !== "number" || id <= 0) {
+    return null;
+  }
+  return id;
+}
+var svgSrcTransformer = createTransformer(async (value, { signal }) => {
+  const id = resolveSvgSrcId(value.id);
+  const urlFromValue = typeof value.url === "string" ? value.url : null;
+  let url = urlFromValue;
+  if (id && !urlFromValue) {
+    const attachment = await (0, import_wp_media.getMediaAttachment)({ id });
+    url = attachment?.url ?? null;
+  }
+  const resolvedUrl = typeof url === "string" ? url : null;
+  if (!resolvedUrl) {
+    return { html: null, url: null };
+  }
+  const svgText = await fetchSvgContent(resolvedUrl, signal);
+  const html = svgText ? processSvgContent(svgText) : null;
+  return { html, url: resolvedUrl };
+});
+
 // src/transformers/shared/icon-transformer.ts
 var EMPTY_ICON_RESULT = { html: null, url: null };
 var ICON_SVG_SIZE = "100%";
 var ICON_SVG_OVERFLOW = "visible";
+var DEFAULT_SVG_RELATIVE_PATH = "images/default-svg.svg";
 var iconTransformer = createTransformer(async (value, { signal }) => {
   const iconValue = typeof value.value === "string" ? value.value : null;
   const library = typeof value.library === "string" ? value.library : null;
   if (!iconValue || !library) {
     return EMPTY_ICON_RESULT;
   }
+  const fontAwesomeHtml = await resolveFontAwesomeSvg(library, iconValue, signal);
+  if (fontAwesomeHtml) {
+    return { html: fontAwesomeHtml, url: null };
+  }
+  if ((0, import_editor_controls.isDeletedCustomIconLibrary)(library, iconValue)) {
+    return resolveDefaultSvg(signal);
+  }
+  const customHtml = await resolveCustomSvg(library, iconValue, signal);
+  if (customHtml) {
+    return { html: customHtml, url: null };
+  }
+  return EMPTY_ICON_RESULT;
+});
+async function resolveDefaultSvg(signal) {
+  const assetsUrl = window.elementorCommon?.config?.urls?.assets;
+  if (typeof assetsUrl !== "string" || assetsUrl === "") {
+    return EMPTY_ICON_RESULT;
+  }
+  return svgSrcTransformer(
+    {
+      id: null,
+      url: `${assetsUrl}${DEFAULT_SVG_RELATIVE_PATH}`
+    },
+    { key: "svg", signal }
+  );
+}
+async function resolveCustomSvg(library, iconValue, signal) {
+  const markup = await (0, import_editor_controls.resolveCustomIconSvg)(library, iconValue, signal);
+  return markup ? processIconSvgContent(markup) : null;
+}
+async function resolveFontAwesomeSvg(library, iconValue, signal) {
   const iconName = (0, import_editor_controls.getFontAwesome7IconName)(iconValue);
   if (!iconName) {
-    return EMPTY_ICON_RESULT;
+    return null;
   }
   const iconData = await (0, import_editor_controls.resolveFontAwesome7Icon)(library, iconName, signal);
   if (!iconData) {
-    return EMPTY_ICON_RESULT;
-  }
-  const svgText = buildFontAwesomeSvg(iconData);
-  if (!svgText) {
-    return EMPTY_ICON_RESULT;
+    return null;
   }
-  const html = processIconSvgContent(svgText);
-  return { html, url: null };
-});
-function buildFontAwesomeSvg(iconData) {
+  const svgText = buildPathSvg(iconData);
+  return svgText ? processIconSvgContent(svgText) : null;
+}
+function buildPathSvg(iconData) {
   if (iconData.paths.length === 0) {
     return null;
   }
@@ -2192,13 +2261,13 @@ var imageSrcTransformer = createTransformer((value) => ({
 }));
 
 // src/transformers/shared/image-transformer.ts
-var import_wp_media = require("@elementor/wp-media");
+var import_wp_media2 = require("@elementor/wp-media");
 var imageTransformer = createTransformer(async (value) => {
   const { src, size: size2 } = value;
   if (!src?.id) {
     return src?.url ? { src: src.url, alt: src.alt ?? "" } : null;
   }
-  const attachment = await (0, import_wp_media.getMediaAttachment)({ id: src.id });
+  const attachment = await (0, import_wp_media2.getMediaAttachment)({ id: src.id });
   const sizedAttachment = attachment?.sizes?.[size2 ?? ""];
   if (sizedAttachment) {
     return {
@@ -2224,47 +2293,6 @@ var plainTransformer = createTransformer((value) => {
   return value;
 });
 
-// src/transformers/shared/svg-src-transformer.ts
-var import_wp_media2 = require("@elementor/wp-media");
-async function fetchSvgContent(url, signal) {
-  try {
-    const response = await fetch(url, { signal });
-    if (!response.ok) {
-      return null;
-    }
-    const contentType = response.headers.get("content-type") ?? "";
-    const isSvg = contentType.includes("svg") || contentType.includes("xml") || url.endsWith(".svg");
-    if (!isSvg) {
-      return null;
-    }
-    return await response.text();
-  } catch {
-    return null;
-  }
-}
-function resolveSvgSrcId(id) {
-  if (typeof id !== "number" || id <= 0) {
-    return null;
-  }
-  return id;
-}
-var svgSrcTransformer = createTransformer(async (value, { signal }) => {
-  const id = resolveSvgSrcId(value.id);
-  const urlFromValue = typeof value.url === "string" ? value.url : null;
-  let url = urlFromValue;
-  if (id && !urlFromValue) {
-    const attachment = await (0, import_wp_media2.getMediaAttachment)({ id });
-    url = attachment?.url ?? null;
-  }
-  const resolvedUrl = typeof url === "string" ? url : null;
-  if (!resolvedUrl) {
-    return { html: null, url: null };
-  }
-  const svgText = await fetchSvgContent(resolvedUrl, signal);
-  const html = svgText ? processSvgContent(svgText) : null;
-  return { html, url: resolvedUrl };
-});
-
 // src/transformers/shared/video-src-transformer.ts
 var import_wp_media3 = require("@elementor/wp-media");
 var videoSrcTransformer = createTransformer(async (value) => {
@@ -2544,11 +2572,11 @@ function getVal2(val) {
 var transformOriginTransformer = createTransformer((value) => {
   const x = getVal2(value.x);
   const y = getVal2(value.y);
-  const z3 = getVal2(value.z);
-  if (x === DEFAULT_XY && y === DEFAULT_XY && z3 === DEFAULT_Z) {
+  const z4 = getVal2(value.z);
+  if (x === DEFAULT_XY && y === DEFAULT_XY && z4 === DEFAULT_Z) {
     return null;
   }
-  return `${x} ${y} ${z3}`;
+  return `${x} ${y} ${z4}`;
 });
 
 // src/transformers/styles/transform-rotate-transformer.ts
@@ -2807,14 +2835,17 @@ function isRecord(value) {
 var import_editor_elements5 = require("@elementor/editor-elements");
 function createPendingElement(wrapperView, data, options = {}) {
   const parentContainer = wrapperView.getContainer();
-  const model = { ...data };
-  if (!model.id) {
+  const model = options.clone ? (0, import_editor_elements5.cloneElementTree)(data) : { ...data };
+  if (!options.clone && !model.id) {
     model.id = (0, import_editor_elements5.generateElementId)();
   }
   if (!model.elements) {
     model.elements = [];
   }
-  const added = (0, import_editor_elements5.addModelToParent)(parentContainer.id, model, options);
+  const added = (0, import_editor_elements5.addModelToParent)(parentContainer.id, model, {
+    ...options,
+    clone: false
+  });
   if (!added) {
     return void 0;
   }
@@ -2975,6 +3006,7 @@ function createTemplatedElementView({
         this._domUpdateWasSkipped = false;
         this._lastResolvedSettingsHash = settingsHash;
         const context = {
+          ...element.template_context ?? {},
           id: this.model.get("id"),
           interaction_id: this.getInteractionId(),
           type,
@@ -3053,10 +3085,12 @@ function buildEditorAttributes(model) {
   const id = model.get("id");
   const originId = model.get("originId");
   const cid = model.cid ?? "";
+  const isDecorative = model.get("editor_settings")?.decorative === true;
   const attrs = {
     "data-model-cid": cid,
     "data-interaction-id": originId ?? id,
-    "x-ignore": "true"
+    "x-ignore": "true",
+    ...isDecorative ? { "data-e-decorative": "true" } : {}
   };
   return Object.entries(attrs).map(([key, value]) => `${key}="${value}"`).join(" ");
 }
@@ -4151,6 +4185,11 @@ function initTabsModelExtensions() {
 // src/mcp/canvas-mcp.ts
 var import_editor_props8 = require("@elementor/editor-props");
 
+// src/mcp/icon-library-experiment.ts
+var import_editor_v1_adapters15 = require("@elementor/editor-v1-adapters");
+var ICON_LIBRARY_EXPERIMENT = "e_svg_library";
+var isIconLibraryActive = () => (0, import_editor_v1_adapters15.isExperimentActive)(ICON_LIBRARY_EXPERIMENT);
+
 // src/mcp/resources/available-widgets-resource.ts
 var import_http_client3 = require("@elementor/http-client");
 var MCP_PROXY_URL2 = "elementor/v1/mcp-proxy";
@@ -4227,7 +4266,7 @@ var initBestPracticesResource = (reg) => {
 
 // src/mcp/resources/document-structure-resource.ts
 var import_editor_elements9 = require("@elementor/editor-elements");
-var import_editor_v1_adapters15 = require("@elementor/editor-v1-adapters");
+var import_editor_v1_adapters16 = require("@elementor/editor-v1-adapters");
 var DOCUMENT_STRUCTURE_URI = "elementor://document/structure";
 var initDocumentStructureResource = (reg) => {
   const { resource, sendResourceUpdated } = reg;
@@ -4240,15 +4279,15 @@ var initDocumentStructureResource = (reg) => {
       sendResourceUpdated({ uri: DOCUMENT_STRUCTURE_URI });
     }
   };
-  (0, import_editor_v1_adapters15.__privateListenTo)(
+  (0, import_editor_v1_adapters16.__privateListenTo)(
     [
-      (0, import_editor_v1_adapters15.commandEndEvent)("document/elements/create"),
-      (0, import_editor_v1_adapters15.commandEndEvent)("document/elements/delete"),
-      (0, import_editor_v1_adapters15.commandEndEvent)("document/elements/move"),
-      (0, import_editor_v1_adapters15.commandEndEvent)("document/elements/copy"),
-      (0, import_editor_v1_adapters15.commandEndEvent)("document/elements/paste"),
-      (0, import_editor_v1_adapters15.commandEndEvent)("editor/documents/attach-preview"),
-      (0, import_editor_v1_adapters15.commandEndEvent)("editor/documents/switch")
+      (0, import_editor_v1_adapters16.commandEndEvent)("document/elements/create"),
+      (0, import_editor_v1_adapters16.commandEndEvent)("document/elements/delete"),
+      (0, import_editor_v1_adapters16.commandEndEvent)("document/elements/move"),
+      (0, import_editor_v1_adapters16.commandEndEvent)("document/elements/copy"),
+      (0, import_editor_v1_adapters16.commandEndEvent)("document/elements/paste"),
+      (0, import_editor_v1_adapters16.commandEndEvent)("editor/documents/attach-preview"),
+      (0, import_editor_v1_adapters16.commandEndEvent)("editor/documents/switch")
     ],
     updateDocumentStructure
   );
@@ -4351,7 +4390,7 @@ var initDynamicTagsResource = (reg) => {
 };
 
 // src/mcp/resources/editor-state-resource.ts
-var import_editor_v1_adapters16 = require("@elementor/editor-v1-adapters");
+var import_editor_v1_adapters17 = require("@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;
@@ -4372,8 +4411,8 @@ var initEditorStateResource = (reg) => {
     lastSerializedState = serialized;
     sendResourceUpdated({ uri: EDITOR_STATE_URI });
   };
-  (0, import_editor_v1_adapters16.__privateListenTo)(
-    [(0, import_editor_v1_adapters16.commandEndEvent)("editor/documents/switch"), (0, import_editor_v1_adapters16.commandEndEvent)("editor/documents/attach-preview")],
+  (0, import_editor_v1_adapters17.__privateListenTo)(
+    [(0, import_editor_v1_adapters17.commandEndEvent)("editor/documents/switch"), (0, import_editor_v1_adapters17.commandEndEvent)("editor/documents/attach-preview")],
     notifyIfChanged
   );
   lastSerializedState = JSON.stringify(buildState());
@@ -4447,7 +4486,7 @@ function getPageTitle() {
 }
 
 // src/mcp/resources/general-context-resource.ts
-var import_editor_v1_adapters17 = require("@elementor/editor-v1-adapters");
+var import_editor_v1_adapters18 = require("@elementor/editor-v1-adapters");
 var GENERAL_CONTEXT_URI = "elementor://context/general";
 var initGeneralContextResource = (reg) => {
   const { resource, sendResourceUpdated } = reg;
@@ -4508,11 +4547,11 @@ var initGeneralContextResource = (reg) => {
       };
     }
   );
-  (0, import_editor_v1_adapters17.__privateListenTo)(
+  (0, import_editor_v1_adapters18.__privateListenTo)(
     [
-      (0, import_editor_v1_adapters17.commandEndEvent)("editor/documents/switch"),
-      (0, import_editor_v1_adapters17.commandEndEvent)("editor/documents/attach-preview"),
-      (0, import_editor_v1_adapters17.commandEndEvent)("document/elements/settings")
+      (0, import_editor_v1_adapters18.commandEndEvent)("editor/documents/switch"),
+      (0, import_editor_v1_adapters18.commandEndEvent)("editor/documents/attach-preview"),
+      (0, import_editor_v1_adapters18.commandEndEvent)("document/elements/settings")
     ],
     pushUpdateIfChanged
   );
@@ -4521,7 +4560,7 @@ var initGeneralContextResource = (reg) => {
 
 // src/mcp/resources/selected-element-resource.ts
 var import_editor_elements10 = require("@elementor/editor-elements");
-var import_editor_v1_adapters18 = require("@elementor/editor-v1-adapters");
+var import_editor_v1_adapters19 = require("@elementor/editor-v1-adapters");
 var SELECTED_ELEMENT_URI = "elementor://context/selected-element";
 var initSelectedElementResource = (reg) => {
   const { resource, sendResourceUpdated } = reg;
@@ -4552,11 +4591,11 @@ var initSelectedElementResource = (reg) => {
     }
     publishIfChanged(readSelectionFromEditor());
   };
-  (0, import_editor_v1_adapters18.__privateListenTo)(
+  (0, import_editor_v1_adapters19.__privateListenTo)(
     [
-      (0, import_editor_v1_adapters18.commandEndEvent)("document/elements/select"),
-      (0, import_editor_v1_adapters18.commandEndEvent)("document/elements/deselect-all"),
-      (0, import_editor_v1_adapters18.commandEndEvent)("document/elements/settings")
+      (0, import_editor_v1_adapters19.commandEndEvent)("document/elements/select"),
+      (0, import_editor_v1_adapters19.commandEndEvent)("document/elements/deselect-all"),
+      (0, import_editor_v1_adapters19.commandEndEvent)("document/elements/settings")
     ],
     onCommand
   );
@@ -4674,7 +4713,7 @@ var import_editor_props7 = require("@elementor/editor-props");
 var import_editor_elements12 = require("@elementor/editor-elements");
 var import_editor_props6 = require("@elementor/editor-props");
 var import_editor_styles4 = require("@elementor/editor-styles");
-var import_editor_v1_adapters20 = require("@elementor/editor-v1-adapters");
+var import_editor_v1_adapters21 = require("@elementor/editor-v1-adapters");
 
 // src/mcp/utils/merge-custom-css.ts
 var CUSTOM_CSS_SEPARATOR = "\n";
@@ -4743,11 +4782,11 @@ function resolveCanonicalPropKeys(elementType, props) {
 }
 
 // src/mcp/utils/resolve-dynamic-tag.ts
-var import_editor_v1_adapters19 = require("@elementor/editor-v1-adapters");
+var import_editor_v1_adapters20 = require("@elementor/editor-v1-adapters");
 var DYNAMIC_PROP_TYPE_KEY = "dynamic";
 var OMITTED_DYNAMIC_SETTING_KEYS = ["fallback"];
 var getAtomicDynamicTags = () => {
-  const config = (0, import_editor_v1_adapters19.getElementorConfig)();
+  const config = (0, import_editor_v1_adapters20.getElementorConfig)();
   return config.atomicDynamicTags?.tags ?? {};
 };
 var getDynamicTagNamesByCategories = (categories) => {
@@ -4948,13 +4987,51 @@ Expected Schema: ${jsonSchema}`
     },
     withHistory: false
   });
-  (0, import_editor_v1_adapters20.__privateRunCommandSync)("document/save/set-is-modified", { status: true }, { internal: true });
+  (0, import_editor_v1_adapters21.__privateRunCommandSync)("document/save/set-is-modified", { status: true }, { internal: true });
 };
 
 // src/mcp/tools/configure-element/prompt.ts
 var import_editor_mcp2 = require("@elementor/editor-mcp");
+var ICONS_SECTION = `# Icons (the \`svg\` property on e-svg)
+The \`svg\` property accepts two variants. Prefer a library icon for iconography (carts, arrows, social marks, check marks) \u2014 it needs no upload and inherits \`color\` via \`currentColor\`. Use an uploaded file only for custom artwork such as a brand logo.
+
+Resolve the icon with the \`find-icons\` tool FIRST, then copy its \`value\` and \`library\` verbatim. Never assemble those strings yourself: Font Awesome renamed many icons between major versions (\`shopping-cart\` became \`cart-shopping\`), so a plausible guess renders nothing. \`find-icons\` matches on names, aliases, human search terms, and categories, so describe the intent \u2014 "add to cart" finds \`cart-shopping\`. It takes a batch of \`queries\`, so resolve every icon you need in one call.
+
+Library icon (note the nested PropValues \u2014 \`value\` and \`library\` are each a \`string\` PropValue):
+{ "$$type": "icon", "value": { "value": { "$$type": "string", "value": "fa-solid fa-cart-shopping" }, "library": { "$$type": "string", "value": "fa-solid" } } }
+
+Uploaded SVG file:
+{ "$$type": "svg-src", "value": { "id": { "$$type": "image-attachment-id", "value": 123 } } }
+
+Size and colour an e-svg through \`style\` (\`width\`, \`height\`, \`color\`), never through \`propertiesToChange\`.
+`;
+var ICON_EXAMPLE = `
+Setting a Font Awesome icon on an e-svg, after resolving it with \`find-icons\`:
+
+\`\`\`json
+{
+  propertiesToChange: {
+    svg: {
+      $$type: 'icon',
+      value: {
+        value: { $$type: 'string', value: 'fa-solid fa-cart-shopping' },
+        library: { $$type: 'string', value: 'fa-solid' }
+      }
+    }
+  },
+  style: {
+    'width': '1.25rem',
+    'height': '1.25rem',
+    'color': '#1a1a1a'
+  },
+  elementId: 'element-id',
+  elementType: 'e-svg'
+};
+\`\`\`
+`;
 var CONFIGURE_ELEMENT_GUIDE_URI = "elementor://canvas/tools/configure-element-guide";
 var generatePrompt = () => {
+  const iconLibraryActive = isIconLibraryActive();
   const configureElementToolPrompt = (0, import_editor_mcp2.toolPrompts)("configure-element");
   configureElementToolPrompt.description(`
 Configure an existing element on the page.
@@ -5012,7 +5089,8 @@ Put the dynamic object EXACTLY at the node whose schema offers the "dynamic" var
 }
 Image example: { "$$type": "image", "value": { "src": { "$$type": "dynamic", "value": { "name": "<image tag>", "settings": { ... } } } } }
 Do NOT send "group" (it is resolved automatically). Use { "settings": {} } only when the tag has no settings.
-`);
+
+${iconLibraryActive ? ICONS_SECTION : ""}`);
   configureElementToolPrompt.parameter("elementId", "The ID of the element to configure. MANDATORY.");
   configureElementToolPrompt.parameter(
     "elementType",
@@ -5049,6 +5127,9 @@ Do NOT send "group" (it is resolved automatically). Use { "settings": {} } only
 };
 \`\`\`
 `);
+  if (iconLibraryActive) {
+    configureElementToolPrompt.example(ICON_EXAMPLE);
+  }
   configureElementToolPrompt.instruction(
     "The $$type property is MANDATORY for every value in propertiesToChange; it is not used in the style parameter (raw CSS only)."
   );
@@ -5222,8 +5303,7 @@ Provide styling as raw CSS via the "style" parameter (a flat map of CSS property
 }`;
 }
 
-// src/mcp/tools/get-page-structure/tool.ts
-var import_editor_documents2 = require("@elementor/editor-documents");
+// src/mcp/tools/find-icons/tool.ts
 var import_http_client7 = require("@elementor/http-client");
 var import_schema3 = require("@elementor/schema");
 
@@ -5242,24 +5322,137 @@ function getMcpErrorMessage(error, toolName) {
   return `${toolName} failed with an unknown error.`;
 }
 
-// src/mcp/tools/get-page-structure/tool.ts
+// src/mcp/tools/find-icons/prompt.ts
+var import_editor_mcp4 = require("@elementor/editor-mcp");
+var findIconsToolPrompt = (0, import_editor_mcp4.toolPrompts)("find-icons");
+findIconsToolPrompt.description(
+  "Finds icons for the `svg` property of an `e-svg` element, across Font Awesome and any icon packs uploaded to this site. Returns the exact `value` and `library` pair to write - never assemble those strings yourself, and never guess an icon name. Call this before placing or configuring an `e-svg`. Nothing has to be uploaded to the Media Library for an icon to work."
+);
+findIconsToolPrompt.instruction(
+  'Call it when the user names an icon ("use the cart-shopping icon") and take the first exact `name` match, and also when the user describes a page and you decide icons belong in it ("create a product page") - in that case pass one query per icon you intend to place, in a single call.'
+);
+findIconsToolPrompt.instruction(
+  'Write queries the way a person would describe the icon ("shopping cart", "credit card", "phone"). Icons are matched on their name, aliases, Font Awesome search terms and category, so plain language works better than guessed icon names.'
+);
+findIconsToolPrompt.instruction(
+  'Results are ordered best first; `matched_on: "name"` is a stronger signal than `matched_on: "term"`. Check each result\'s `license` and only use `free` icons; skip any `pro` entry. Prefer `fa-solid` for UI iconography and keep one style across a page; brand marks only exist in `fa-brands`. An empty `matches` array means no match was found: broaden the phrase instead of inventing a value.'
+);
+findIconsToolPrompt.instruction(
+  'Pass the chosen pair to `configure-element` as the `svg` property: { "$$type": "icon", "value": { "value": { "$$type": "string", "value": "fa-solid fa-cart-shopping" }, "library": { "$$type": "string", "value": "fa-solid" } } }. An `e-svg` has no colour or size of its own, so set `width`, `height` and `color` in the same `configure-element` call.'
+);
+findIconsToolPrompt.example(`Icon named by the user:
+{ "queries": ["cart-shopping"] }`);
+findIconsToolPrompt.example(`Every icon a product page needs, in one call:
+{ "queries": ["add to cart", "free shipping", "secure payment", "instagram"] }`);
+findIconsToolPrompt.example(`Browse a category, one style only:
+{ "category": "shopping", "library": "fa-solid", "perPage": 25 }`);
+
+// src/mcp/tools/find-icons/tool.ts
 var MCP_PROXY_URL5 = "elementor/v1/mcp-proxy";
+var MAX_QUERIES = 10;
+var MAX_PER_PAGE = 25;
+var initFindIconsTool = (reg) => {
+  const { addTool } = reg;
+  addTool({
+    name: "find-icons",
+    description: findIconsToolPrompt.prompt(),
+    schema: {
+      queries: import_schema3.z.array(import_schema3.z.string()).max(MAX_QUERIES).optional().describe(
+        'One plain-language phrase per icon you need, for example ["add to cart", "free shipping"]. Batch every icon a page needs into a single call.'
+      ),
+      library: import_schema3.z.string().optional().describe(
+        'Restrict results to one library key reported in "libraries", for example "fa-solid". Omit to search every library installed on the site.'
+      ),
+      category: import_schema3.z.string().optional().describe(
+        'Restrict results to one Font Awesome category reported in "categories", for example "shopping". May be used without a query to browse that category.'
+      ),
+      page: import_schema3.z.number().int().min(1).optional(),
+      perPage: import_schema3.z.number().int().min(1).max(MAX_PER_PAGE).optional()
+    },
+    outputSchema: {
+      results: import_schema3.z.array(
+        import_schema3.z.object({
+          query: import_schema3.z.string(),
+          matches: import_schema3.z.array(
+            import_schema3.z.object({
+              value: import_schema3.z.string(),
+              library: import_schema3.z.string(),
+              name: import_schema3.z.string(),
+              label: import_schema3.z.string(),
+              matched_on: import_schema3.z.enum(["name", "alias", "term", "category", "library"]),
+              license: import_schema3.z.enum(["free", "pro"])
+            })
+          ),
+          total: import_schema3.z.number(),
+          page: import_schema3.z.number(),
+          per_page: import_schema3.z.number(),
+          truncated: import_schema3.z.boolean()
+        })
+      ).describe(
+        'One entry per query, each with ranked "matches". Every match carries the "value" and "library" pair to write on the e-svg icon prop, plus "matched_on" and "license".'
+      ),
+      libraries: import_schema3.z.array(import_schema3.z.string()).optional().describe(
+        "Icon library keys installed on this site. Only sent when nothing matched or when browsing."
+      ),
+      customLibraries: import_schema3.z.record(import_schema3.z.string(), import_schema3.z.string()).optional().describe(
+        "Custom (uploaded) icon libraries keyed by library. Only sent when nothing matched or when browsing."
+      ),
+      categories: import_schema3.z.array(import_schema3.z.string()).optional().describe(
+        'Icon categories for the "category" filter. Only sent when nothing matched or when browsing.'
+      ),
+      truncatedCustomLibraries: import_schema3.z.array(import_schema3.z.string()).optional().describe("Custom libraries with more than 250 icons; only their first 250 icons are searchable."),
+      fontAwesomeVersion: import_schema3.z.string().nullable().describe("Font Awesome version the site renders icons from."),
+      llmInstructions: import_schema3.z.string().optional().describe("Present only when nothing matched, explaining what to do next.")
+    },
+    handler: async ({ queries, library, category, page, perPage }) => {
+      try {
+        const { data } = await (0, import_http_client7.httpService)().post(MCP_PROXY_URL5, {
+          tool: "find-icons",
+          input: {
+            ...queries ? { queries } : {},
+            ...library ? { library } : {},
+            ...category ? { category } : {},
+            ...page ? { page } : {},
+            ...perPage ? { per_page: perPage } : {}
+          }
+        });
+        return {
+          results: data.data.results,
+          ...data.data.libraries ? { libraries: data.data.libraries } : {},
+          ...data.data.custom_libraries ? { customLibraries: data.data.custom_libraries } : {},
+          ...data.data.categories ? { categories: data.data.categories } : {},
+          ...data.data.truncated_custom_libraries ? { truncatedCustomLibraries: data.data.truncated_custom_libraries } : {},
+          fontAwesomeVersion: data.data.font_awesome_version,
+          ...data.data.llm_instructions ? { llmInstructions: data.data.llm_instructions } : {}
+        };
+      } catch (error) {
+        throw new Error(getMcpErrorMessage(error, "find-icons"));
+      }
+    }
+  });
+};
+
+// src/mcp/tools/get-page-structure/tool.ts
+var import_editor_documents2 = require("@elementor/editor-documents");
+var import_http_client8 = require("@elementor/http-client");
+var import_schema4 = require("@elementor/schema");
+var MCP_PROXY_URL6 = "elementor/v1/mcp-proxy";
 var initGetPageStructureTool = (reg) => {
   const { addTool } = reg;
   addTool({
     name: "get-page-structure",
     description: "Returns a lean Elementor element tree skeleton (id, elType, widgetType, title, nested elements) for a post or page. If no postId is provided, uses the currently open document. Optionally scope to a subtree with elementId. Set includeContent=true (requires elementId) to also return each node's settings and styles.",
     schema: {
-      postId: import_schema3.z.number().optional().describe(
+      postId: import_schema4.z.number().optional().describe(
         "WordPress post ID of the Elementor document. If omitted, uses the currently open document."
       ),
-      elementId: import_schema3.z.string().optional().describe("If provided, returns only the subtree rooted at that element id."),
-      includeContent: import_schema3.z.boolean().optional().describe(
+      elementId: import_schema4.z.string().optional().describe("If provided, returns only the subtree rooted at that element id."),
+      includeContent: import_schema4.z.boolean().optional().describe(
         "If true, includes each node's settings and styles (same shape build-composition accepts as input). Requires elementId."
       )
     },
     outputSchema: {
-      elements: import_schema3.z.array(import_schema3.z.any()).describe(
+      elements: import_schema4.z.array(import_schema4.z.any()).describe(
         "Skeleton of Elementor elements (id, elType, widgetType, title, nested elements). When includeContent is true, each node also includes settings and styles."
       )
     },
@@ -5269,7 +5462,7 @@ var initGetPageStructureTool = (reg) => {
         throw new Error("No post ID provided and no active document found.");
       }
       try {
-        const { data } = await (0, import_http_client7.httpService)().post(MCP_PROXY_URL5, {
+        const { data } = await (0, import_http_client8.httpService)().post(MCP_PROXY_URL6, {
           tool: "get-page-structure",
           input: {
             post_id: resolvedPostId,
@@ -5299,6 +5492,9 @@ var initCanvasMcp = (reg) => {
   initGeneralContextResource(reg);
   initBestPracticesResource(reg);
   initConfigureElementTool(reg);
+  if (isIconLibraryActive()) {
+    initFindIconsTool(reg);
+  }
   initGetPageStructureTool(reg);
   initBreakpointsResource(reg);
 };
@@ -5402,14 +5598,14 @@ Note: The "size" property controls image resolution/loading, not visual size. Se
 // src/prevent-link-in-link-commands.ts
 var import_editor_elements14 = require("@elementor/editor-elements");
 var import_editor_notifications3 = require("@elementor/editor-notifications");
-var import_editor_v1_adapters21 = require("@elementor/editor-v1-adapters");
+var import_editor_v1_adapters22 = require("@elementor/editor-v1-adapters");
 var import_i18n4 = require("@wordpress/i18n");
 function initLinkInLinkPrevention() {
-  (0, import_editor_v1_adapters21.blockCommand)({
+  (0, import_editor_v1_adapters22.blockCommand)({
     command: "document/elements/paste",
     condition: blockLinkInLinkPaste
   });
-  (0, import_editor_v1_adapters21.blockCommand)({
+  (0, import_editor_v1_adapters22.blockCommand)({
     command: "document/elements/move",
     condition: blockLinkInLinkMove
   });
@@ -5485,7 +5681,7 @@ function shouldBlock(sourceElements, targetElements) {
 // src/style-commands/paste-style.ts
 var import_editor_elements17 = require("@elementor/editor-elements");
 var import_editor_props10 = require("@elementor/editor-props");
-var import_editor_v1_adapters23 = require("@elementor/editor-v1-adapters");
+var import_editor_v1_adapters24 = require("@elementor/editor-v1-adapters");
 
 // src/utils/command-utils.ts
 var import_editor_elements15 = require("@elementor/editor-elements");
@@ -5532,9 +5728,9 @@ function getTitleForContainers(containers) {
 // src/style-commands/undoable-actions/paste-element-style.ts
 var import_editor_elements16 = require("@elementor/editor-elements");
 var import_editor_styles_repository4 = require("@elementor/editor-styles-repository");
-var import_editor_v1_adapters22 = require("@elementor/editor-v1-adapters");
+var import_editor_v1_adapters23 = require("@elementor/editor-v1-adapters");
 var import_i18n6 = require("@wordpress/i18n");
-var undoablePasteElementStyle = () => (0, import_editor_v1_adapters22.undoable)(
+var undoablePasteElementStyle = () => (0, import_editor_v1_adapters23.undoable)(
   {
     do: ({ containers, newStyle }) => {
       return containers.map((container) => {
@@ -5610,12 +5806,12 @@ var undoablePasteElementStyle = () => (0, import_editor_v1_adapters22.undoable)(
 // src/style-commands/paste-style.ts
 function initPasteStyleCommand() {
   const pasteElementStyleCommand = undoablePasteElementStyle();
-  (0, import_editor_v1_adapters23.blockCommand)({
+  (0, import_editor_v1_adapters24.blockCommand)({
     command: "document/elements/paste-style",
     condition: hasAtomicWidgets
   });
-  (0, import_editor_v1_adapters23.__privateListenTo)(
-    (0, import_editor_v1_adapters23.commandStartEvent)("document/elements/paste-style"),
+  (0, import_editor_v1_adapters24.__privateListenTo)(
+    (0, import_editor_v1_adapters24.commandStartEvent)("document/elements/paste-style"),
     (e) => pasteStyles(e.args, pasteElementStyleCommand)
   );
 }
@@ -5666,14 +5862,14 @@ function pasteClasses(containers, classes) {
 }
 
 // src/style-commands/reset-style.ts
-var import_editor_v1_adapters25 = require("@elementor/editor-v1-adapters");
+var import_editor_v1_adapters26 = require("@elementor/editor-v1-adapters");
 
 // src/style-commands/undoable-actions/reset-element-style.ts
 var import_editor_elements18 = require("@elementor/editor-elements");
 var import_editor_styles_repository5 = require("@elementor/editor-styles-repository");
-var import_editor_v1_adapters24 = require("@elementor/editor-v1-adapters");
+var import_editor_v1_adapters25 = require("@elementor/editor-v1-adapters");
 var import_i18n7 = require("@wordpress/i18n");
-var undoableResetElementStyle = () => (0, import_editor_v1_adapters24.undoable)(
+var undoableResetElementStyle = () => (0, import_editor_v1_adapters25.undoable)(
   {
     do: ({ containers }) => {
       return containers.map((container) => {
@@ -5717,12 +5913,12 @@ var undoableResetElementStyle = () => (0, import_editor_v1_adapters24.undoable)(
 // src/style-commands/reset-style.ts
 function initResetStyleCommand() {
   const resetElementStyles = undoableResetElementStyle();
-  (0, import_editor_v1_adapters25.blockCommand)({
+  (0, import_editor_v1_adapters26.blockCommand)({
     command: "document/elements/reset-style",
     condition: hasAtomicWidgets
   });
-  (0, import_editor_v1_adapters25.__privateListenTo)(
-    (0, import_editor_v1_adapters25.commandStartEvent)("document/elements/reset-style"),
+  (0, import_editor_v1_adapters26.__privateListenTo)(
+    (0, import_editor_v1_adapters26.commandStartEvent)("document/elements/reset-style"),
     (e) => resetStyles(e.args, resetElementStyles)
   );
 }
@@ -5768,7 +5964,7 @@ function init() {
     component: ClassesRename
   });
   initCanvasMcp(
-    (0, import_editor_mcp4.getMCPByDomain)("canvas", {
+    (0, import_editor_mcp5.getMCPByDomain)("canvas", {
       instructions: `Everything related to V4 ( Atomic ) canvas.
 # Canvas workflow
 - Configure element settings and styles with configure-element
@@ -5871,9 +6067,9 @@ function getRectClipPath(rect, viewport) {
 }
 
 // src/hooks/use-canvas-document.ts
-var import_editor_v1_adapters26 = require("@elementor/editor-v1-adapters");
+var import_editor_v1_adapters27 = require("@elementor/editor-v1-adapters");
 function useCanvasDocument() {
-  return (0, import_editor_v1_adapters26.__privateUseListenTo)((0, import_editor_v1_adapters26.commandEndEvent)("editor/documents/attach-preview"), () => (0, import_editor_v1_adapters26.getCanvasIframeDocument)());
+  return (0, import_editor_v1_adapters27.__privateUseListenTo)((0, import_editor_v1_adapters27.commandEndEvent)("editor/documents/attach-preview"), () => (0, import_editor_v1_adapters27.getCanvasIframeDocument)());
 }
 
 // src/hooks/use-escape-on-canvas.ts