@elementor/editor-canvas 4.4.0-1135 → 4.4.0-1137

package/dist/index.js

@@ -187,7 +187,9 @@ var SINGLE_BLOCK_KEY = "default";
 var convertBlocks = async (blocks) => {
   const { data } = await (0, import_http_client2.httpService)().post(
     CSS_TO_ATOMIC_URL,
-    { blocks }
+    {
+      blocks
+    }
   );
   return data.data;
 };
@@ -1795,6 +1797,7 @@ var import_i18n = require("@wordpress/i18n");
 // src/form-structure/utils.ts
 var import_editor_elements4 = require("@elementor/editor-elements");
 var FORM_ELEMENT_TYPE = "e-form";
+var FORM_HIDDEN_FIELD_ELEMENT_TYPE = "e-form-hidden";
 var FORM_FIELD_ELEMENT_TYPES = /* @__PURE__ */ new Set([
   "e-form-input",
   "e-form-textarea",
@@ -1805,7 +1808,8 @@ var FORM_FIELD_ELEMENT_TYPES = /* @__PURE__ */ new Set([
   "e-form-radio-button",
   "e-form-file-upload",
   "e-form-date-picker",
-  "e-form-time-picker"
+  "e-form-time-picker",
+  FORM_HIDDEN_FIELD_ELEMENT_TYPE
 ]);
 function getArgsElementType(args) {
   return args.model?.widgetType || args.model?.elType;
@@ -1922,25 +1926,49 @@ function handleBlockedFormField() {
   (0, import_editor_notifications.notify)(FORM_FIELDS_OUTSIDE_ALERT);
 }
 
-// src/form-structure/prevent-form-nesting-commands.ts
+// src/form-structure/hidden-field-hint.ts
 var import_editor_notifications2 = require("@elementor/editor-notifications");
 var import_editor_v1_adapters12 = require("@elementor/editor-v1-adapters");
 var import_i18n2 = require("@wordpress/i18n");
+var MOVE_COMMAND = "document/elements/move";
+var notificationCounter = 0;
+function createHiddenFieldNotification() {
+  return {
+    type: "default",
+    message: (0, import_i18n2.__)("Hidden field added - invisible on your form. Manage it in the Structure panel.", "elementor"),
+    id: `hidden-field-added-${++notificationCounter}`
+  };
+}
+function initHiddenFieldHint() {
+  (0, import_editor_v1_adapters12.registerDataHook)("after", "document/elements/create", (args, _result, options) => {
+    if (options?.commandsCurrentTrace?.includes(MOVE_COMMAND)) {
+      return;
+    }
+    if (getArgsElementType(args) === FORM_HIDDEN_FIELD_ELEMENT_TYPE) {
+      (0, import_editor_notifications2.notify)(createHiddenFieldNotification());
+    }
+  });
+}
+
+// src/form-structure/prevent-form-nesting-commands.ts
+var import_editor_notifications3 = require("@elementor/editor-notifications");
+var import_editor_v1_adapters13 = require("@elementor/editor-v1-adapters");
+var import_i18n3 = require("@wordpress/i18n");
 var FORM_NESTING_ALERT = {
   type: "default",
-  message: (0, import_i18n2.__)("Forms can't be nested. Create separate forms instead.", "elementor"),
+  message: (0, import_i18n3.__)("Forms can't be nested. Create separate forms instead.", "elementor"),
   id: "form-nesting-blocked"
 };
 function initFormNestingPrevention() {
-  (0, import_editor_v1_adapters12.blockCommand)({
+  (0, import_editor_v1_adapters13.blockCommand)({
     command: "document/elements/create",
     condition: blockFormCreate
   });
-  (0, import_editor_v1_adapters12.blockCommand)({
+  (0, import_editor_v1_adapters13.blockCommand)({
     command: "document/elements/move",
     condition: blockFormMove
   });
-  (0, import_editor_v1_adapters12.blockCommand)({
+  (0, import_editor_v1_adapters13.blockCommand)({
     command: "document/elements/paste",
     condition: blockFormPaste
   });
@@ -1984,7 +2012,7 @@ function blockFormPaste(args) {
   return false;
 }
 function handleBlockedFormField2() {
-  (0, import_editor_notifications2.notify)(FORM_NESTING_ALERT);
+  (0, import_editor_notifications3.notify)(FORM_NESTING_ALERT);
 }
 
 // src/settings-transformers-registry.ts
@@ -2180,6 +2208,8 @@ var svgSrcTransformer = createTransformer(async (value, { signal }) => {
 var EMPTY_ICON_RESULT = { html: null, url: null };
 var ICON_SVG_SIZE = "100%";
 var ICON_SVG_OVERFLOW = "visible";
+var FONT_AWESOME_LIBRARY_PREFIX = "fa-";
+var EICONS_LIBRARY = "eicons";
 var DEFAULT_SVG_RELATIVE_PATH = "images/default-svg.svg";
 var iconTransformer = createTransformer(async (value, { signal }) => {
   const iconValue = typeof value.value === "string" ? value.value : null;
@@ -2191,14 +2221,14 @@ var iconTransformer = createTransformer(async (value, { signal }) => {
   if (fontAwesomeHtml) {
     return { html: fontAwesomeHtml, url: null };
   }
-  if ((0, import_editor_controls.isDeletedCustomIconLibrary)(library, iconValue)) {
-    return resolveDefaultSvg(signal);
+  if (library.startsWith(FONT_AWESOME_LIBRARY_PREFIX) || EICONS_LIBRARY === library) {
+    return EMPTY_ICON_RESULT;
   }
-  const customHtml = await resolveCustomSvg(library, iconValue, signal);
-  if (customHtml) {
-    return { html: customHtml, url: null };
+  const providerHtml = await resolveProviderSvg(library, iconValue, signal);
+  if (providerHtml) {
+    return { html: providerHtml, url: null };
   }
-  return EMPTY_ICON_RESULT;
+  return resolveDefaultSvg(signal);
 });
 async function resolveDefaultSvg(signal) {
   const assetsUrl = window.elementorCommon?.config?.urls?.assets;
@@ -2213,8 +2243,8 @@ async function resolveDefaultSvg(signal) {
     { key: "svg", signal }
   );
 }
-async function resolveCustomSvg(library, iconValue, signal) {
-  const markup = await (0, import_editor_controls.resolveCustomIconSvg)(library, iconValue, signal);
+async function resolveProviderSvg(library, iconValue, signal) {
+  const markup = await (0, import_editor_controls.resolveProviderIconSvg)(library, iconValue, signal);
   return markup ? processIconSvgContent(markup) : null;
 }
 async function resolveFontAwesomeSvg(library, iconValue, signal) {
@@ -2674,7 +2704,7 @@ function initStyleTransformers() {
 
 // src/legacy/init-legacy-views.ts
 var import_editor_elements8 = require("@elementor/editor-elements");
-var import_editor_v1_adapters14 = require("@elementor/editor-v1-adapters");
+var import_editor_v1_adapters15 = require("@elementor/editor-v1-adapters");
 
 // src/renderers/create-dom-renderer.ts
 var import_twing = require("@elementor/twing");
@@ -3425,8 +3455,8 @@ var import_client = require("react-dom/client");
 var React11 = __toESM(require("react"));
 var import_editor_elements7 = require("@elementor/editor-elements");
 var import_editor_props4 = require("@elementor/editor-props");
-var import_editor_v1_adapters13 = require("@elementor/editor-v1-adapters");
-var import_i18n3 = require("@wordpress/i18n");
+var import_editor_v1_adapters14 = require("@elementor/editor-v1-adapters");
+var import_i18n4 = require("@wordpress/i18n");
 
 // src/legacy/replacements/base.ts
 var TRIGGER_TIMING = {
@@ -3743,7 +3773,7 @@ var InlineEditingReplacement = class extends ReplacementBase {
     return this.editing;
   }
   shouldRenderReplacement() {
-    return this.isInlineEditingEligible() && (0, import_editor_v1_adapters13.getCurrentEditMode)() === "edit";
+    return this.isInlineEditingEligible() && (0, import_editor_v1_adapters14.getCurrentEditMode)() === "edit";
   }
   handleRenderInlineEditor = () => {
     if (this.isEditingModeActive() || !this.isInlineEditingEligible()) {
@@ -3830,7 +3860,7 @@ var InlineEditingReplacement = class extends ReplacementBase {
   setContentValue(value) {
     const settingKey = this.getInlineEditablePropertyName();
     const valueToSave = this.createContentPropValue(value);
-    (0, import_editor_v1_adapters13.undoable)(
+    (0, import_editor_v1_adapters14.undoable)(
       {
         do: () => {
           const prevValue = this.getInlineEditablePropValue();
@@ -3844,7 +3874,7 @@ var InlineEditingReplacement = class extends ReplacementBase {
       {
         title: (0, import_editor_elements7.getElementLabel)(this.id),
         // translators: %s is the name of the property that was edited.
-        subtitle: (0, import_i18n3.__)("%s edited", "elementor").replace(
+        subtitle: (0, import_i18n4.__)("%s edited", "elementor").replace(
           "%s",
           this.getInlineEditablePropTypeKey() ?? "Inline editing"
         ),
@@ -3872,7 +3902,7 @@ var InlineEditingReplacement = class extends ReplacementBase {
     return null;
   }
   runCommand(key, value) {
-    (0, import_editor_v1_adapters13.__privateRunCommandSync)(
+    (0, import_editor_v1_adapters14.__privateRunCommandSync)(
       "document/elements/set-settings",
       {
         container: (0, import_editor_elements7.getContainer)(this.id),
@@ -3882,7 +3912,7 @@ var InlineEditingReplacement = class extends ReplacementBase {
       },
       { internal: true }
     );
-    (0, import_editor_v1_adapters13.__privateRunCommandSync)("document/save/set-is-modified", { status: true }, { internal: true });
+    (0, import_editor_v1_adapters14.__privateRunCommandSync)("document/save/set-is-modified", { status: true }, { internal: true });
   }
   getExpectedTag() {
     const tagPropType = this.getTagPropType();
@@ -4047,12 +4077,12 @@ function registerModelExtensions(type, extensions) {
 }
 function registerElementType(type, elementTypeGenerator) {
   elementsLegacyTypes[type] = elementTypeGenerator;
-  if ((0, import_editor_v1_adapters14.__privateIsReady)()) {
+  if ((0, import_editor_v1_adapters15.__privateIsReady)()) {
     registerElementInLegacyManager(type, createDomRenderer());
   }
 }
 function initLegacyViews() {
-  (0, import_editor_v1_adapters14.__privateListenTo)((0, import_editor_v1_adapters14.v1ReadyEvent)(), () => {
+  (0, import_editor_v1_adapters15.__privateListenTo)((0, import_editor_v1_adapters15.v1ReadyEvent)(), () => {
     const widgetsCache = (0, import_editor_elements8.getWidgetsCache)() ?? {};
     const renderer = createDomRenderer();
     registerProPromotionTypes(widgetsCache);
@@ -4190,9 +4220,9 @@ function initTabsModelExtensions() {
 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 import_editor_v1_adapters16 = require("@elementor/editor-v1-adapters");
 var ICON_LIBRARY_EXPERIMENT = "e_svg_library";
-var isIconLibraryActive = () => (0, import_editor_v1_adapters15.isExperimentActive)(ICON_LIBRARY_EXPERIMENT);
+var isIconLibraryActive = () => (0, import_editor_v1_adapters16.isExperimentActive)(ICON_LIBRARY_EXPERIMENT);
 
 // src/mcp/resources/available-widgets-resource.ts
 var import_http_client3 = require("@elementor/http-client");
@@ -4270,7 +4300,7 @@ var initBestPracticesResource = (reg) => {
 
 // src/mcp/resources/document-structure-resource.ts
 var import_editor_elements9 = require("@elementor/editor-elements");
-var import_editor_v1_adapters16 = require("@elementor/editor-v1-adapters");
+var import_editor_v1_adapters17 = require("@elementor/editor-v1-adapters");
 var DOCUMENT_STRUCTURE_URI = "elementor://document/structure";
 var initDocumentStructureResource = (reg) => {
   const { resource, sendResourceUpdated } = reg;
@@ -4283,15 +4313,15 @@ var initDocumentStructureResource = (reg) => {
       sendResourceUpdated({ uri: DOCUMENT_STRUCTURE_URI });
     }
   };
-  (0, import_editor_v1_adapters16.__privateListenTo)(
+  (0, import_editor_v1_adapters17.__privateListenTo)(
     [
-      (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")
+      (0, import_editor_v1_adapters17.commandEndEvent)("document/elements/create"),
+      (0, import_editor_v1_adapters17.commandEndEvent)("document/elements/delete"),
+      (0, import_editor_v1_adapters17.commandEndEvent)("document/elements/move"),
+      (0, import_editor_v1_adapters17.commandEndEvent)("document/elements/copy"),
+      (0, import_editor_v1_adapters17.commandEndEvent)("document/elements/paste"),
+      (0, import_editor_v1_adapters17.commandEndEvent)("editor/documents/attach-preview"),
+      (0, import_editor_v1_adapters17.commandEndEvent)("editor/documents/switch")
     ],
     updateDocumentStructure
   );
@@ -4394,7 +4424,7 @@ var initDynamicTagsResource = (reg) => {
 };
 
 // src/mcp/resources/editor-state-resource.ts
-var import_editor_v1_adapters17 = require("@elementor/editor-v1-adapters");
+var import_editor_v1_adapters18 = 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;
@@ -4415,8 +4445,8 @@ var initEditorStateResource = (reg) => {
     lastSerializedState = serialized;
     sendResourceUpdated({ uri: EDITOR_STATE_URI });
   };
-  (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")],
+  (0, import_editor_v1_adapters18.__privateListenTo)(
+    [(0, import_editor_v1_adapters18.commandEndEvent)("editor/documents/switch"), (0, import_editor_v1_adapters18.commandEndEvent)("editor/documents/attach-preview")],
     notifyIfChanged
   );
   lastSerializedState = JSON.stringify(buildState());
@@ -4490,7 +4520,7 @@ function getPageTitle() {
 }
 
 // src/mcp/resources/general-context-resource.ts
-var import_editor_v1_adapters18 = require("@elementor/editor-v1-adapters");
+var import_editor_v1_adapters19 = require("@elementor/editor-v1-adapters");
 var GENERAL_CONTEXT_URI = "elementor://context/general";
 var initGeneralContextResource = (reg) => {
   const { resource, sendResourceUpdated } = reg;
@@ -4551,11 +4581,11 @@ var initGeneralContextResource = (reg) => {
       };
     }
   );
-  (0, import_editor_v1_adapters18.__privateListenTo)(
+  (0, import_editor_v1_adapters19.__privateListenTo)(
     [
-      (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")
+      (0, import_editor_v1_adapters19.commandEndEvent)("editor/documents/switch"),
+      (0, import_editor_v1_adapters19.commandEndEvent)("editor/documents/attach-preview"),
+      (0, import_editor_v1_adapters19.commandEndEvent)("document/elements/settings")
     ],
     pushUpdateIfChanged
   );
@@ -4564,7 +4594,7 @@ var initGeneralContextResource = (reg) => {
 
 // src/mcp/resources/selected-element-resource.ts
 var import_editor_elements10 = require("@elementor/editor-elements");
-var import_editor_v1_adapters19 = require("@elementor/editor-v1-adapters");
+var import_editor_v1_adapters20 = require("@elementor/editor-v1-adapters");
 var SELECTED_ELEMENT_URI = "elementor://context/selected-element";
 var initSelectedElementResource = (reg) => {
   const { resource, sendResourceUpdated } = reg;
@@ -4595,11 +4625,11 @@ var initSelectedElementResource = (reg) => {
     }
     publishIfChanged(readSelectionFromEditor());
   };
-  (0, import_editor_v1_adapters19.__privateListenTo)(
+  (0, import_editor_v1_adapters20.__privateListenTo)(
     [
-      (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")
+      (0, import_editor_v1_adapters20.commandEndEvent)("document/elements/select"),
+      (0, import_editor_v1_adapters20.commandEndEvent)("document/elements/deselect-all"),
+      (0, import_editor_v1_adapters20.commandEndEvent)("document/elements/settings")
     ],
     onCommand
   );
@@ -4717,7 +4747,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_adapters21 = require("@elementor/editor-v1-adapters");
+var import_editor_v1_adapters22 = require("@elementor/editor-v1-adapters");
 
 // src/mcp/utils/merge-custom-css.ts
 var CUSTOM_CSS_SEPARATOR = "\n";
@@ -4786,11 +4816,11 @@ function resolveCanonicalPropKeys(elementType, props) {
 }
 
 // src/mcp/utils/resolve-dynamic-tag.ts
-var import_editor_v1_adapters20 = require("@elementor/editor-v1-adapters");
+var import_editor_v1_adapters21 = 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_adapters20.getElementorConfig)();
+  const config = (0, import_editor_v1_adapters21.getElementorConfig)();
   return config.atomicDynamicTags?.tags ?? {};
 };
 var getDynamicTagNamesByCategories = (categories) => {
@@ -4991,7 +5021,7 @@ Expected Schema: ${jsonSchema}`
     },
     withHistory: false
   });
-  (0, import_editor_v1_adapters21.__privateRunCommandSync)("document/save/set-is-modified", { status: true }, { internal: true });
+  (0, import_editor_v1_adapters22.__privateRunCommandSync)("document/save/set-is-modified", { status: true }, { internal: true });
 };
 
 // src/mcp/tools/configure-element/prompt.ts
@@ -5601,15 +5631,15 @@ 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_adapters22 = require("@elementor/editor-v1-adapters");
-var import_i18n4 = require("@wordpress/i18n");
+var import_editor_notifications4 = require("@elementor/editor-notifications");
+var import_editor_v1_adapters23 = require("@elementor/editor-v1-adapters");
+var import_i18n5 = require("@wordpress/i18n");
 function initLinkInLinkPrevention() {
-  (0, import_editor_v1_adapters22.blockCommand)({
+  (0, import_editor_v1_adapters23.blockCommand)({
     command: "document/elements/paste",
     condition: blockLinkInLinkPaste
   });
-  (0, import_editor_v1_adapters22.blockCommand)({
+  (0, import_editor_v1_adapters23.blockCommand)({
     command: "document/elements/move",
     condition: blockLinkInLinkMove
   });
@@ -5637,7 +5667,7 @@ function blockLinkInLinkPaste(args) {
   const sourceElements = data.clipboard.elements;
   const notification = {
     type: "default",
-    message: (0, import_i18n4.__)(
+    message: (0, import_i18n5.__)(
       "To paste a link to this element, first remove the link from it's parent container.",
       "elementor"
     ),
@@ -5646,7 +5676,7 @@ function blockLinkInLinkPaste(args) {
   };
   const blocked = shouldBlock(sourceElements, targetElements);
   if (blocked) {
-    (0, import_editor_notifications3.notify)(notification);
+    (0, import_editor_notifications4.notify)(notification);
   }
   return blocked;
 }
@@ -5656,13 +5686,13 @@ function blockLinkInLinkMove(args) {
   const targetElement = target;
   const notification = {
     type: "default",
-    message: (0, import_i18n4.__)("To drag a link to this element, first remove the link from it's parent container.", "elementor"),
+    message: (0, import_i18n5.__)("To drag a link to this element, first remove the link from it's parent container.", "elementor"),
     id: "move-in-link-blocked",
     additionalActionProps: [learnMoreActionProps]
   };
   const isBlocked = shouldBlock(sourceElements, [targetElement]);
   if (isBlocked) {
-    (0, import_editor_notifications3.notify)(notification);
+    (0, import_editor_notifications4.notify)(notification);
   }
   return isBlocked;
 }
@@ -5685,12 +5715,12 @@ 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_adapters24 = require("@elementor/editor-v1-adapters");
+var import_editor_v1_adapters25 = require("@elementor/editor-v1-adapters");
 
 // src/utils/command-utils.ts
 var import_editor_elements15 = require("@elementor/editor-elements");
 var import_editor_props9 = require("@elementor/editor-props");
-var import_i18n5 = require("@wordpress/i18n");
+var import_i18n6 = require("@wordpress/i18n");
 function hasAtomicWidgets(args) {
   const { containers = [args.container] } = args;
   return containers.some(isAtomicWidget);
@@ -5726,15 +5756,15 @@ function getClipboardElements(storageKey = "clipboard") {
   }
 }
 function getTitleForContainers(containers) {
-  return containers.length > 1 ? (0, import_i18n5.__)("Elements", "elementor") : (0, import_editor_elements15.getElementLabel)(containers[0].id);
+  return containers.length > 1 ? (0, import_i18n6.__)("Elements", "elementor") : (0, import_editor_elements15.getElementLabel)(containers[0].id);
 }
 
 // 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_adapters23 = require("@elementor/editor-v1-adapters");
-var import_i18n6 = require("@wordpress/i18n");
-var undoablePasteElementStyle = () => (0, import_editor_v1_adapters23.undoable)(
+var import_editor_v1_adapters24 = require("@elementor/editor-v1-adapters");
+var import_i18n7 = require("@wordpress/i18n");
+var undoablePasteElementStyle = () => (0, import_editor_v1_adapters24.undoable)(
   {
     do: ({ containers, newStyle }) => {
       return containers.map((container) => {
@@ -5803,19 +5833,19 @@ var undoablePasteElementStyle = () => (0, import_editor_v1_adapters23.undoable)(
   },
   {
     title: ({ containers }) => getTitleForContainers(containers),
-    subtitle: (0, import_i18n6.__)("Style Pasted", "elementor")
+    subtitle: (0, import_i18n7.__)("Style Pasted", "elementor")
   }
 );
 
 // src/style-commands/paste-style.ts
 function initPasteStyleCommand() {
   const pasteElementStyleCommand = undoablePasteElementStyle();
-  (0, import_editor_v1_adapters24.blockCommand)({
+  (0, import_editor_v1_adapters25.blockCommand)({
     command: "document/elements/paste-style",
     condition: hasAtomicWidgets
   });
-  (0, import_editor_v1_adapters24.__privateListenTo)(
-    (0, import_editor_v1_adapters24.commandStartEvent)("document/elements/paste-style"),
+  (0, import_editor_v1_adapters25.__privateListenTo)(
+    (0, import_editor_v1_adapters25.commandStartEvent)("document/elements/paste-style"),
     (e) => pasteStyles(e.args, pasteElementStyleCommand)
   );
 }
@@ -5866,14 +5896,14 @@ function pasteClasses(containers, classes) {
 }
 
 // src/style-commands/reset-style.ts
-var import_editor_v1_adapters26 = require("@elementor/editor-v1-adapters");
+var import_editor_v1_adapters27 = 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_adapters25 = require("@elementor/editor-v1-adapters");
-var import_i18n7 = require("@wordpress/i18n");
-var undoableResetElementStyle = () => (0, import_editor_v1_adapters25.undoable)(
+var import_editor_v1_adapters26 = require("@elementor/editor-v1-adapters");
+var import_i18n8 = require("@wordpress/i18n");
+var undoableResetElementStyle = () => (0, import_editor_v1_adapters26.undoable)(
   {
     do: ({ containers }) => {
       return containers.map((container) => {
@@ -5910,19 +5940,19 @@ var undoableResetElementStyle = () => (0, import_editor_v1_adapters25.undoable)(
   },
   {
     title: ({ containers }) => getTitleForContainers(containers),
-    subtitle: (0, import_i18n7.__)("Style Reset", "elementor")
+    subtitle: (0, import_i18n8.__)("Style Reset", "elementor")
   }
 );
 
 // src/style-commands/reset-style.ts
 function initResetStyleCommand() {
   const resetElementStyles = undoableResetElementStyle();
-  (0, import_editor_v1_adapters26.blockCommand)({
+  (0, import_editor_v1_adapters27.blockCommand)({
     command: "document/elements/reset-style",
     condition: hasAtomicWidgets
   });
-  (0, import_editor_v1_adapters26.__privateListenTo)(
-    (0, import_editor_v1_adapters26.commandStartEvent)("document/elements/reset-style"),
+  (0, import_editor_v1_adapters27.__privateListenTo)(
+    (0, import_editor_v1_adapters27.commandStartEvent)("document/elements/reset-style"),
     (e) => resetStyles(e.args, resetElementStyles)
   );
 }
@@ -5948,6 +5978,7 @@ function init() {
   initLinkInLinkPrevention();
   initFormNestingPrevention();
   initFormAncestorEnforcement();
+  initHiddenFieldHint();
   initViewReplacements();
   initLegacyViews();
   initSettingsTransformers();
@@ -6071,9 +6102,9 @@ function getRectClipPath(rect, viewport) {
 }
 
 // src/hooks/use-canvas-document.ts
-var import_editor_v1_adapters27 = require("@elementor/editor-v1-adapters");
+var import_editor_v1_adapters28 = require("@elementor/editor-v1-adapters");
 function useCanvasDocument() {
-  return (0, import_editor_v1_adapters27.__privateUseListenTo)((0, import_editor_v1_adapters27.commandEndEvent)("editor/documents/attach-preview"), () => (0, import_editor_v1_adapters27.getCanvasIframeDocument)());
+  return (0, import_editor_v1_adapters28.__privateUseListenTo)((0, import_editor_v1_adapters28.commandEndEvent)("editor/documents/attach-preview"), () => (0, import_editor_v1_adapters28.getCanvasIframeDocument)());
 }
 
 // src/hooks/use-escape-on-canvas.ts

package/dist/index.mjs

@@ -118,7 +118,9 @@ var SINGLE_BLOCK_KEY = "default";
 var convertBlocks = async (blocks) => {
   const { data } = await httpService2().post(
     CSS_TO_ATOMIC_URL,
-    { blocks }
+    {
+      blocks
+    }
   );
   return data.data;
 };
@@ -1747,6 +1749,7 @@ import { __ } from "@wordpress/i18n";
 // src/form-structure/utils.ts
 import { getAllDescendants } from "@elementor/editor-elements";
 var FORM_ELEMENT_TYPE = "e-form";
+var FORM_HIDDEN_FIELD_ELEMENT_TYPE = "e-form-hidden";
 var FORM_FIELD_ELEMENT_TYPES = /* @__PURE__ */ new Set([
   "e-form-input",
   "e-form-textarea",
@@ -1757,7 +1760,8 @@ var FORM_FIELD_ELEMENT_TYPES = /* @__PURE__ */ new Set([
   "e-form-radio-button",
   "e-form-file-upload",
   "e-form-date-picker",
-  "e-form-time-picker"
+  "e-form-time-picker",
+  FORM_HIDDEN_FIELD_ELEMENT_TYPE
 ]);
 function getArgsElementType(args) {
   return args.model?.widgetType || args.model?.elType;
@@ -1874,13 +1878,37 @@ function handleBlockedFormField() {
   notify(FORM_FIELDS_OUTSIDE_ALERT);
 }
 
-// src/form-structure/prevent-form-nesting-commands.ts
+// src/form-structure/hidden-field-hint.ts
 import { notify as notify2 } from "@elementor/editor-notifications";
-import { blockCommand as blockCommand2 } from "@elementor/editor-v1-adapters";
+import { registerDataHook as registerDataHook3 } from "@elementor/editor-v1-adapters";
 import { __ as __2 } from "@wordpress/i18n";
+var MOVE_COMMAND = "document/elements/move";
+var notificationCounter = 0;
+function createHiddenFieldNotification() {
+  return {
+    type: "default",
+    message: __2("Hidden field added - invisible on your form. Manage it in the Structure panel.", "elementor"),
+    id: `hidden-field-added-${++notificationCounter}`
+  };
+}
+function initHiddenFieldHint() {
+  registerDataHook3("after", "document/elements/create", (args, _result, options) => {
+    if (options?.commandsCurrentTrace?.includes(MOVE_COMMAND)) {
+      return;
+    }
+    if (getArgsElementType(args) === FORM_HIDDEN_FIELD_ELEMENT_TYPE) {
+      notify2(createHiddenFieldNotification());
+    }
+  });
+}
+
+// src/form-structure/prevent-form-nesting-commands.ts
+import { notify as notify3 } from "@elementor/editor-notifications";
+import { blockCommand as blockCommand2 } from "@elementor/editor-v1-adapters";
+import { __ as __3 } from "@wordpress/i18n";
 var FORM_NESTING_ALERT = {
   type: "default",
-  message: __2("Forms can't be nested. Create separate forms instead.", "elementor"),
+  message: __3("Forms can't be nested. Create separate forms instead.", "elementor"),
   id: "form-nesting-blocked"
 };
 function initFormNestingPrevention() {
@@ -1936,7 +1964,7 @@ function blockFormPaste(args) {
   return false;
 }
 function handleBlockedFormField2() {
-  notify2(FORM_NESTING_ALERT);
+  notify3(FORM_NESTING_ALERT);
 }
 
 // src/settings-transformers-registry.ts
@@ -2066,9 +2094,8 @@ var timeRangeTransformer = createTransformer((value) => {
 // src/transformers/shared/icon-transformer.ts
 import {
   getFontAwesome7IconName,
-  isDeletedCustomIconLibrary,
-  resolveCustomIconSvg,
-  resolveFontAwesome7Icon
+  resolveFontAwesome7Icon,
+  resolveProviderIconSvg
 } from "@elementor/editor-controls";
 
 // src/transformers/shared/process-svg-content.ts
@@ -2137,6 +2164,8 @@ var svgSrcTransformer = createTransformer(async (value, { signal }) => {
 var EMPTY_ICON_RESULT = { html: null, url: null };
 var ICON_SVG_SIZE = "100%";
 var ICON_SVG_OVERFLOW = "visible";
+var FONT_AWESOME_LIBRARY_PREFIX = "fa-";
+var EICONS_LIBRARY = "eicons";
 var DEFAULT_SVG_RELATIVE_PATH = "images/default-svg.svg";
 var iconTransformer = createTransformer(async (value, { signal }) => {
   const iconValue = typeof value.value === "string" ? value.value : null;
@@ -2148,14 +2177,14 @@ var iconTransformer = createTransformer(async (value, { signal }) => {
   if (fontAwesomeHtml) {
     return { html: fontAwesomeHtml, url: null };
   }
-  if (isDeletedCustomIconLibrary(library, iconValue)) {
-    return resolveDefaultSvg(signal);
+  if (library.startsWith(FONT_AWESOME_LIBRARY_PREFIX) || EICONS_LIBRARY === library) {
+    return EMPTY_ICON_RESULT;
   }
-  const customHtml = await resolveCustomSvg(library, iconValue, signal);
-  if (customHtml) {
-    return { html: customHtml, url: null };
+  const providerHtml = await resolveProviderSvg(library, iconValue, signal);
+  if (providerHtml) {
+    return { html: providerHtml, url: null };
   }
-  return EMPTY_ICON_RESULT;
+  return resolveDefaultSvg(signal);
 });
 async function resolveDefaultSvg(signal) {
   const assetsUrl = window.elementorCommon?.config?.urls?.assets;
@@ -2170,8 +2199,8 @@ async function resolveDefaultSvg(signal) {
     { key: "svg", signal }
   );
 }
-async function resolveCustomSvg(library, iconValue, signal) {
-  const markup = await resolveCustomIconSvg(library, iconValue, signal);
+async function resolveProviderSvg(library, iconValue, signal) {
+  const markup = await resolveProviderIconSvg(library, iconValue, signal);
   return markup ? processIconSvgContent(markup) : null;
 }
 async function resolveFontAwesomeSvg(library, iconValue, signal) {
@@ -3393,7 +3422,7 @@ import {
   stringPropTypeUtil as stringPropTypeUtil2
 } from "@elementor/editor-props";
 import { __privateRunCommandSync as runCommandSync, getCurrentEditMode, undoable } from "@elementor/editor-v1-adapters";
-import { __ as __3 } from "@wordpress/i18n";
+import { __ as __4 } from "@wordpress/i18n";
 
 // src/legacy/replacements/base.ts
 var TRIGGER_TIMING = {
@@ -3815,7 +3844,7 @@ var InlineEditingReplacement = class extends ReplacementBase {
       {
         title: getElementLabel(this.id),
         // translators: %s is the name of the property that was edited.
-        subtitle: __3("%s edited", "elementor").replace(
+        subtitle: __4("%s edited", "elementor").replace(
           "%s",
           this.getInlineEditablePropTypeKey() ?? "Inline editing"
         ),
@@ -5587,9 +5616,9 @@ import {
   getAnchoredDescendantId,
   isElementAnchored
 } from "@elementor/editor-elements";
-import { notify as notify3 } from "@elementor/editor-notifications";
+import { notify as notify4 } from "@elementor/editor-notifications";
 import { blockCommand as blockCommand3 } from "@elementor/editor-v1-adapters";
-import { __ as __4 } from "@wordpress/i18n";
+import { __ as __5 } from "@wordpress/i18n";
 function initLinkInLinkPrevention() {
   blockCommand3({
     command: "document/elements/paste",
@@ -5623,7 +5652,7 @@ function blockLinkInLinkPaste(args) {
   const sourceElements = data.clipboard.elements;
   const notification = {
     type: "default",
-    message: __4(
+    message: __5(
       "To paste a link to this element, first remove the link from it's parent container.",
       "elementor"
     ),
@@ -5632,7 +5661,7 @@ function blockLinkInLinkPaste(args) {
   };
   const blocked = shouldBlock(sourceElements, targetElements);
   if (blocked) {
-    notify3(notification);
+    notify4(notification);
   }
   return blocked;
 }
@@ -5642,13 +5671,13 @@ function blockLinkInLinkMove(args) {
   const targetElement = target;
   const notification = {
     type: "default",
-    message: __4("To drag a link to this element, first remove the link from it's parent container.", "elementor"),
+    message: __5("To drag a link to this element, first remove the link from it's parent container.", "elementor"),
     id: "move-in-link-blocked",
     additionalActionProps: [learnMoreActionProps]
   };
   const isBlocked = shouldBlock(sourceElements, [targetElement]);
   if (isBlocked) {
-    notify3(notification);
+    notify4(notification);
   }
   return isBlocked;
 }
@@ -5680,7 +5709,7 @@ import {
 // src/utils/command-utils.ts
 import { getElementLabel as getElementLabel2, getWidgetsCache as getWidgetsCache7 } from "@elementor/editor-elements";
 import { CLASSES_PROP_KEY } from "@elementor/editor-props";
-import { __ as __5 } from "@wordpress/i18n";
+import { __ as __6 } from "@wordpress/i18n";
 function hasAtomicWidgets(args) {
   const { containers = [args.container] } = args;
   return containers.some(isAtomicWidget);
@@ -5716,7 +5745,7 @@ function getClipboardElements(storageKey = "clipboard") {
   }
 }
 function getTitleForContainers(containers) {
-  return containers.length > 1 ? __5("Elements", "elementor") : getElementLabel2(containers[0].id);
+  return containers.length > 1 ? __6("Elements", "elementor") : getElementLabel2(containers[0].id);
 }
 
 // src/style-commands/undoable-actions/paste-element-style.ts
@@ -5728,7 +5757,7 @@ import {
 } from "@elementor/editor-elements";
 import { ELEMENTS_STYLES_RESERVED_LABEL } from "@elementor/editor-styles-repository";
 import { undoable as undoable2 } from "@elementor/editor-v1-adapters";
-import { __ as __6 } from "@wordpress/i18n";
+import { __ as __7 } from "@wordpress/i18n";
 var undoablePasteElementStyle = () => undoable2(
   {
     do: ({ containers, newStyle }) => {
@@ -5798,7 +5827,7 @@ var undoablePasteElementStyle = () => undoable2(
   },
   {
     title: ({ containers }) => getTitleForContainers(containers),
-    subtitle: __6("Style Pasted", "elementor")
+    subtitle: __7("Style Pasted", "elementor")
   }
 );
 
@@ -5871,7 +5900,7 @@ import {
 import { createElementStyle as createElementStyle3, deleteElementStyle as deleteElementStyle2, getElementStyles as getElementStyles3 } from "@elementor/editor-elements";
 import { ELEMENTS_STYLES_RESERVED_LABEL as ELEMENTS_STYLES_RESERVED_LABEL2 } from "@elementor/editor-styles-repository";
 import { undoable as undoable3 } from "@elementor/editor-v1-adapters";
-import { __ as __7 } from "@wordpress/i18n";
+import { __ as __8 } from "@wordpress/i18n";
 var undoableResetElementStyle = () => undoable3(
   {
     do: ({ containers }) => {
@@ -5909,7 +5938,7 @@ var undoableResetElementStyle = () => undoable3(
   },
   {
     title: ({ containers }) => getTitleForContainers(containers),
-    subtitle: __7("Style Reset", "elementor")
+    subtitle: __8("Style Reset", "elementor")
   }
 );
 
@@ -5947,6 +5976,7 @@ function init() {
   initLinkInLinkPrevention();
   initFormNestingPrevention();
   initFormAncestorEnforcement();
+  initHiddenFieldHint();
   initViewReplacements();
   initLegacyViews();
   initSettingsTransformers();

package/package.json

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

package/src/form-structure/__tests__/form-structure-utils.test.ts

@@ -114,6 +114,16 @@ describe( 'form-structure utils', () => {
 			expect( errors[ 0 ] ).toContain( 'e-form-input' );
 			expect( errors[ 0 ] ).toContain( 'e-form' );
 		} );
+		it( 'returns an error when a hidden field has no e-form ancestor (invalid)', () => {
+			const xml = parseXml( `
+				<e-flexbox>
+					<e-form-hidden />
+				</e-flexbox>
+			` );
+			const errors = collectFormAncestorErrors( xml );
+			expect( errors ).toHaveLength( 1 );
+			expect( errors[ 0 ] ).toContain( 'e-form-hidden' );
+		} );
 		it( 'returns an error for each orphaned form field', () => {
 			const xml = parseXml( `
 				<e-flexbox>

package/src/form-structure/__tests__/hidden-field-hint.test.ts

@@ -0,0 +1,137 @@
+import { createHooksRegistry, setupHooksRegistry } from 'test-utils';
+import { notify } from '@elementor/editor-notifications';
+
+import { initHiddenFieldHint } from '../hidden-field-hint';
+
+jest.mock( '@elementor/editor-notifications', () => ( {
+	notify: jest.fn(),
+} ) );
+
+const CREATE_COMMAND = 'document/elements/create';
+const MOVE_COMMAND = 'document/elements/move';
+const HIDDEN_FIELD_TYPE = 'e-form-hidden';
+
+describe( 'hidden field hint', () => {
+	const hooksRegistry = createHooksRegistry();
+
+	beforeEach( () => {
+		jest.mocked( notify ).mockClear();
+		setupHooksRegistry( hooksRegistry );
+		initHiddenFieldHint();
+	} );
+
+	it( 'should notify when a hidden field is added', () => {
+		// Arrange
+		const hook = hooksRegistry.getByCommand( CREATE_COMMAND );
+
+		// Act
+		hook?.apply( { model: { widgetType: HIDDEN_FIELD_TYPE } } );
+
+		// Assert
+		expect( notify ).toHaveBeenCalledWith(
+			expect.objectContaining( {
+				message: 'Hidden field added - invisible on your form. Manage it in the Structure panel.',
+			} )
+		);
+	} );
+
+	it( 'should use unique notification ids for back-to-back adds (not collapsed by the notification system)', () => {
+		// Arrange
+		const hook = hooksRegistry.getByCommand( CREATE_COMMAND );
+
+		// Act
+		hook?.apply( { model: { widgetType: HIDDEN_FIELD_TYPE } } );
+		hook?.apply( { model: { widgetType: HIDDEN_FIELD_TYPE } } );
+
+		// Assert
+		expect( notify ).toHaveBeenCalledTimes( 2 );
+		const firstCallId = jest.mocked( notify ).mock.calls[ 0 ][ 0 ].id;
+		const secondCallId = jest.mocked( notify ).mock.calls[ 1 ][ 0 ].id;
+		expect( firstCallId ).not.toBe( secondCallId );
+	} );
+
+	it( 'should notify again after remove and re-add (simulated by separate create calls)', () => {
+		// Arrange
+		const hook = hooksRegistry.getByCommand( CREATE_COMMAND );
+
+		// Act - first add
+		hook?.apply( { model: { widgetType: HIDDEN_FIELD_TYPE } } );
+
+		// simulate removal (no hook for delete affects this)
+
+		// Act - re-add
+		hook?.apply( { model: { widgetType: HIDDEN_FIELD_TYPE } } );
+
+		// Assert
+		expect( notify ).toHaveBeenCalledTimes( 2 );
+	} );
+
+	it( 'should not notify when another element type is created', () => {
+		// Arrange
+		const hook = hooksRegistry.getByCommand( CREATE_COMMAND );
+
+		// Act
+		hook?.apply( { model: { widgetType: 'e-form-input' } } );
+
+		// Assert
+		expect( notify ).not.toHaveBeenCalled();
+	} );
+
+	it( 'should not notify when the hidden field is created as part of a move', () => {
+		// Arrange
+		const hook = hooksRegistry.getByCommand( CREATE_COMMAND );
+		const eWindow = window as unknown as { $e: { commands?: { currentTrace?: string[] } } };
+		eWindow.$e.commands = { currentTrace: [ MOVE_COMMAND, CREATE_COMMAND ] };
+
+		// Act
+		hook?.apply( { model: { widgetType: HIDDEN_FIELD_TYPE } } );
+
+		// Assert
+		expect( notify ).not.toHaveBeenCalled();
+	} );
+
+	it( 'should not notify on selection (selection does not trigger create command)', () => {
+		// Arrange - selection uses a different command path, not document/elements/create
+		const hook = hooksRegistry.getByCommand( CREATE_COMMAND );
+
+		// Act - no create call is made for selection
+		// Selection triggers commands like document/elements/toggle-selection, not create
+
+		// Assert
+		expect( hook ).toBeDefined();
+		expect( notify ).not.toHaveBeenCalled();
+	} );
+
+	it( 'should notify on paste when it triggers create (current behavior: paste triggers toast)', () => {
+		// Arrange
+		const hook = hooksRegistry.getByCommand( CREATE_COMMAND );
+
+		// Act - paste internally calls create, so it will trigger the notification
+		hook?.apply( { model: { widgetType: HIDDEN_FIELD_TYPE } } );
+
+		// Assert
+		expect( notify ).toHaveBeenCalledTimes( 1 );
+	} );
+
+	it( 'should notify on duplicate when it triggers create (current behavior: duplicate triggers toast)', () => {
+		// Arrange
+		const hook = hooksRegistry.getByCommand( CREATE_COMMAND );
+
+		// Act - duplicate internally calls create, so it will trigger the notification
+		hook?.apply( { model: { widgetType: HIDDEN_FIELD_TYPE } } );
+
+		// Assert
+		expect( notify ).toHaveBeenCalledTimes( 1 );
+	} );
+
+	it( 'should notify on undo of delete (undo-delete triggers create, so toast shows)', () => {
+		// Arrange
+		const hook = hooksRegistry.getByCommand( CREATE_COMMAND );
+
+		// Act - undo of a delete restores via create command
+		hook?.apply( { model: { widgetType: HIDDEN_FIELD_TYPE } } );
+
+		// Assert
+		expect( notify ).toHaveBeenCalledTimes( 1 );
+	} );
+} );

package/src/form-structure/hidden-field-hint.ts

@@ -0,0 +1,29 @@
+import { type NotificationData, notify } from '@elementor/editor-notifications';
+import { type HookOptions, registerDataHook } from '@elementor/editor-v1-adapters';
+import { __ } from '@wordpress/i18n';
+
+import { type CreateArgs, FORM_HIDDEN_FIELD_ELEMENT_TYPE, getArgsElementType } from './utils';
+
+const MOVE_COMMAND = 'document/elements/move';
+
+let notificationCounter = 0;
+
+function createHiddenFieldNotification(): NotificationData {
+	return {
+		type: 'default',
+		message: __( 'Hidden field added - invisible on your form. Manage it in the Structure panel.', 'elementor' ),
+		id: `hidden-field-added-${ ++notificationCounter }`,
+	};
+}
+
+export function initHiddenFieldHint() {
+	registerDataHook( 'after', 'document/elements/create', ( args: CreateArgs, _result, options?: HookOptions ) => {
+		if ( options?.commandsCurrentTrace?.includes( MOVE_COMMAND ) ) {
+			return;
+		}
+
+		if ( getArgsElementType( args ) === FORM_HIDDEN_FIELD_ELEMENT_TYPE ) {
+			notify( createHiddenFieldNotification() );
+		}
+	} );
+}

package/src/form-structure/utils.ts

@@ -35,6 +35,7 @@ export type StorageContent = {
 };
 
 export const FORM_ELEMENT_TYPE = 'e-form';
+export const FORM_HIDDEN_FIELD_ELEMENT_TYPE = 'e-form-hidden';
 export const FORM_FIELD_ELEMENT_TYPES = new Set( [
 	'e-form-input',
 	'e-form-textarea',
@@ -46,6 +47,7 @@ export const FORM_FIELD_ELEMENT_TYPES = new Set( [
 	'e-form-file-upload',
 	'e-form-date-picker',
 	'e-form-time-picker',
+	FORM_HIDDEN_FIELD_ELEMENT_TYPE,
 ] );
 
 export function getArgsElementType( args: CreateArgs ): string | undefined {

package/src/init.tsx

@@ -6,6 +6,7 @@ import { ElementsOverlays } from './components/elements-overlays';
 import { InteractionsRenderer } from './components/interactions-renderer';
 import { StyleRenderer } from './components/style-renderer';
 import { initFormAncestorEnforcement } from './form-structure/enforce-form-ancestor-commands';
+import { initHiddenFieldHint } from './form-structure/hidden-field-hint';
 import { initFormNestingPrevention } from './form-structure/prevent-form-nesting-commands';
 import { initSettingsTransformers } from './init-settings-transformers';
 import { initStyleTransformers } from './init-style-transformers';
@@ -25,6 +26,7 @@ export function init() {
 	initLinkInLinkPrevention();
 	initFormNestingPrevention();
 	initFormAncestorEnforcement();
+	initHiddenFieldHint();
 
 	initViewReplacements();
 

package/src/mcp/utils/convert-css-to-atomic.ts

@@ -22,7 +22,9 @@ const convertBlocks = async (
 ): Promise< Record< string, CssConversionResult > > => {
 	const { data } = await httpService().post< HttpResponse< Record< string, CssConversionResult > > >(
 		CSS_TO_ATOMIC_URL,
-		{ blocks }
+		{
+			blocks,
+		}
 	);
 
 	return data.data;

package/src/transformers/shared/__tests__/icon-transformer.test.ts

@@ -1,10 +1,8 @@
-jest.mock( '@elementor/http-client', () => ( {
-	httpService: () => ( {
-		get: jest.fn().mockRejectedValue( new Error( 'no custom svg' ) ),
-	} ),
-} ) );
-
-import { resetFontAwesome7IconsCache } from '@elementor/editor-controls';
+import {
+	registerIconLibraryProvider,
+	resetFontAwesome7IconsCache,
+	unregisterIconLibraryProvider,
+} from '@elementor/editor-controls';
 import { iconPropTypeUtil, stringPropTypeUtil } from '@elementor/editor-props';
 
 import { iconPropType } from '../../../__tests__/prop-types';
@@ -186,15 +184,12 @@ describe( 'iconTransformer', () => {
 		expect( result ).toEqual( { html: null, url: null } );
 	} );
 
-	it( 'falls back to the default svg when a custom library has been deleted', async () => {
+	it( 'falls back to the default svg when no provider resolves a non-native library', async () => {
 		// Arrange.
-		window.elementor = {
-			config: {
-				icons: {
-					libraries: [ { name: 'fa-solid', prefix: 'fa-', native: true } ],
-				},
-			},
-		} as typeof window.elementor;
+		registerIconLibraryProvider( {
+			id: 'test-provider',
+			useIcons: () => ( { data: [], isLoading: false } ),
+		} );
 		const defaultSvg =
 			'<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 50 50"><path d="M24.9999 4.31543"></path></svg>';
 		global.fetch = jest.fn().mockResolvedValue( {
@@ -206,6 +201,8 @@ describe( 'iconTransformer', () => {
 		// Act.
 		const result = await resolveSavedIcon( 'missing-set missing-set-ghost', 'missing-set' );
 
+		unregisterIconLibraryProvider( 'test-provider' );
+
 		// Assert.
 		expect( global.fetch ).toHaveBeenCalledWith(
 			'https://example.com/assets/images/default-svg.svg',
@@ -217,6 +214,59 @@ describe( 'iconTransformer', () => {
 		} );
 	} );
 
+	it( 'falls back to the default svg for a non-native library when no provider is registered', async () => {
+		// Arrange.
+		const defaultSvg =
+			'<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 50 50"><path d="M24.9999 4.31543"></path></svg>';
+		global.fetch = jest.fn().mockResolvedValue( {
+			ok: true,
+			headers: new Headers( { 'content-type': 'image/svg+xml' } ),
+			text: () => Promise.resolve( defaultSvg ),
+		} );
+
+		// Act.
+		const result = await resolveSavedIcon( 'my-set my-set-star', 'my-set' );
+
+		// Assert.
+		expect( result ).toEqual( {
+			html: expect.stringContaining( 'M24.9999 4.31543' ),
+			url: 'https://example.com/assets/images/default-svg.svg',
+		} );
+	} );
+
+	it( 'does not replace PHP-managed eicons with the default svg', async () => {
+		// Arrange.
+		global.fetch = jest.fn();
+
+		// Act.
+		const result = await resolveSavedIcon( 'eicon-edit', 'eicons' );
+
+		// Assert.
+		expect( result ).toEqual( { html: null, url: null } );
+		expect( global.fetch ).not.toHaveBeenCalled();
+	} );
+
+	it( 'renders and sanitizes svg returned by a provider', async () => {
+		// Arrange.
+		registerIconLibraryProvider( {
+			id: 'test-provider',
+			useIcons: () => ( { data: [], isLoading: false } ),
+			resolveSvg: () =>
+				Promise.resolve(
+					'<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 10 10"><script>alert(1)</script><path d="M1 1h8v8H1z"></path></svg>'
+				),
+		} );
+
+		// Act.
+		const result = ( await resolveSavedIcon( 'my-set my-set-star', 'my-set' ) ) as { html: string };
+
+		unregisterIconLibraryProvider( 'test-provider' );
+
+		// Assert.
+		expect( result.html ).toContain( 'M1 1h8v8H1z' );
+		expect( result.html ).not.toContain( 'script' );
+	} );
+
 	it( 'returns null html when value or library is missing', async () => {
 		// Act.
 		const resolve = createPropsResolver( {

package/src/transformers/shared/__tests__/svg-src-transformer.test.ts

@@ -47,7 +47,10 @@ describe( 'svgSrcTransformer', () => {
 		const result = ( await svgSrcTransformer(
 			{ id: null, url: 'https://example.com/icon.svg' },
 			{ key: 'svg' }
-		) ) as { html: string; url: string };
+		) ) as {
+			html: string;
+			url: string;
+		};
 
 		// Assert.
 		expect( result.html ).toContain( 'width: 100%' );
@@ -91,7 +94,10 @@ describe( 'svgSrcTransformer', () => {
 		const result = ( await svgSrcTransformer(
 			{ id: 99, url: 'https://example.com/fallback.svg' },
 			{ key: 'svg' }
-		) ) as { html: string; url: string };
+		) ) as {
+			html: string;
+			url: string;
+		};
 
 		// Assert.
 		expect( result.url ).toBe( 'https://example.com/fallback.svg' );
@@ -146,7 +152,10 @@ describe( 'svgSrcTransformer', () => {
 		const result = ( await svgSrcTransformer(
 			{ id: null, url: 'https://example.com/styled.svg' },
 			{ key: 'svg' }
-		) ) as { html: string; url: string };
+		) ) as {
+			html: string;
+			url: string;
+		};
 
 		// Assert.
 		expect( result.html ).toContain( 'display: block' );

package/src/transformers/shared/icon-transformer.ts

@@ -1,9 +1,8 @@
 import {
 	type FontAwesome7IconDefinition,
 	getFontAwesome7IconName,
-	isDeletedCustomIconLibrary,
-	resolveCustomIconSvg,
 	resolveFontAwesome7Icon,
+	resolveProviderIconSvg,
 } from '@elementor/editor-controls';
 
 import { createTransformer } from '../create-transformer';
@@ -14,6 +13,8 @@ import { svgSrcTransformer } from './svg-src-transformer';
 const EMPTY_ICON_RESULT = { html: null, url: null };
 const ICON_SVG_SIZE = '100%';
 const ICON_SVG_OVERFLOW = 'visible';
+const FONT_AWESOME_LIBRARY_PREFIX = 'fa-';
+const EICONS_LIBRARY = 'eicons';
 const DEFAULT_SVG_RELATIVE_PATH = 'images/default-svg.svg';
 
 type IconValue = {
@@ -35,17 +36,17 @@ export const iconTransformer = createTransformer( async ( value: IconValue, { si
 		return { html: fontAwesomeHtml, url: null };
 	}
 
-	if ( isDeletedCustomIconLibrary( library, iconValue ) ) {
-		return resolveDefaultSvg( signal );
+	if ( library.startsWith( FONT_AWESOME_LIBRARY_PREFIX ) || EICONS_LIBRARY === library ) {
+		return EMPTY_ICON_RESULT;
 	}
 
-	const customHtml = await resolveCustomSvg( library, iconValue, signal );
+	const providerHtml = await resolveProviderSvg( library, iconValue, signal );
 
-	if ( customHtml ) {
-		return { html: customHtml, url: null };
+	if ( providerHtml ) {
+		return { html: providerHtml, url: null };
 	}
 
-	return EMPTY_ICON_RESULT;
+	return resolveDefaultSvg( signal );
 } );
 
 async function resolveDefaultSvg( signal?: AbortSignal ) {
@@ -64,8 +65,12 @@ async function resolveDefaultSvg( signal?: AbortSignal ) {
 	);
 }
 
-async function resolveCustomSvg( library: string, iconValue: string, signal?: AbortSignal ): Promise< string | null > {
-	const markup = await resolveCustomIconSvg( library, iconValue, signal );
+async function resolveProviderSvg(
+	library: string,
+	iconValue: string,
+	signal?: AbortSignal
+): Promise< string | null > {
+	const markup = await resolveProviderIconSvg( library, iconValue, signal );
 
 	return markup ? processIconSvgContent( markup ) : null;
 }