@elementor/editor-global-classes 4.0.0-manual → 4.0.0

package/dist/index.mjs

@@ -1,6 +1,3 @@
-// src/mcp-integration/classes-resource.ts
-import { getMCPByDomain } from "@elementor/editor-mcp";
-
 // src/global-classes-styles-provider.ts
 import { generateId } from "@elementor/editor-styles";
 import { createStylesProvider } from "@elementor/editor-styles-repository";
@@ -359,6 +356,41 @@ var getSanitizedData = async (payload) => {
         return { ...payload, classTitle: getCssClass(payload.classId).label };
       }
       break;
+    case "classSyncToV3PopupShown":
+      return {
+        ...payload,
+        interaction_type: "popup_shown",
+        target_type: "popup",
+        target_name: "sync_to_v3_popup",
+        interaction_result: "popup_viewed",
+        target_location: "widget_panel",
+        location_l1: "class_manager"
+      };
+    case "classSyncToV3": {
+      const classLabel = getCssClass(payload.classId).label;
+      const isSync = payload.action === "sync";
+      return {
+        ...payload,
+        interaction_type: "click",
+        target_type: classLabel,
+        target_name: isSync ? "sync_to_v3" : "unsync_to_v3",
+        interaction_result: isSync ? "class_is_synced_to_V3" : "class_is_unsynced_from_V3",
+        target_location: "widget_panel",
+        location_l1: "class_manager",
+        interaction_description: isSync ? `user_synced_${classLabel}_to_v3` : `user_unsync_${classLabel}_from_v3`
+      };
+    }
+    case "classSyncToV3PopupClick": {
+      const isSyncAction = payload.action === "sync";
+      return {
+        ...payload,
+        interaction_type: "click",
+        target_type: "button",
+        target_name: isSyncAction ? "sync_to_v3" : "cancel",
+        interaction_result: isSyncAction ? "class_is_synced" : "cancel",
+        target_location: "sync_to_v3_popup"
+      };
+    }
     default:
       return payload;
   }
@@ -504,9 +536,7 @@ var updateLocalStorageCache = () => {
   const classes = globalClassesStylesProvider.actions.all();
   localStorage.setItem(STORAGE_KEY, JSON.stringify(classes));
 };
-var initClassesResource = () => {
-  const canvasMcpEntry = getMCPByDomain("canvas");
-  const classesMcpEntry = getMCPByDomain("classes");
+var initClassesResource = (classesMcpEntry, canvasMcpEntry) => {
   [canvasMcpEntry, classesMcpEntry].forEach((entry) => {
     const { mcpServer, resource, waitForReady } = entry;
     resource(
@@ -538,6 +568,7 @@ import {
   injectIntoCssClassConvert,
   registerStyleProviderToColors
 } from "@elementor/editor-editing-panel";
+import { getMCPByDomain } from "@elementor/editor-mcp";
 import { __registerPanel as registerPanel } from "@elementor/editor-panels";
 import { stylesRepository } from "@elementor/editor-styles-repository";
 import { __registerSlice as registerSlice } from "@elementor/store";
@@ -576,7 +607,7 @@ var PrefetchCssClassUsage = () => {
 
 // src/components/class-manager/class-manager-panel.tsx
 import * as React19 from "react";
-import { useCallback, useEffect as useEffect3, useState as useState7 } from "react";
+import { useCallback, useEffect as useEffect4, useState as useState7 } from "react";
 import { useSuppressedMessage as useSuppressedMessage2 } from "@elementor/editor-current-user";
 import { getCurrentDocument, getV1DocumentsManager, setDocumentModifiedStatus } from "@elementor/editor-documents";
 import {
@@ -901,6 +932,7 @@ async function saveGlobalClasses({ context: context2, onApprove }) {
     changes: calculateChanges(state, currentContext(getState3()))
   });
   dispatch2(slice.actions.reset({ context: context2 }));
+  window.dispatchEvent(new CustomEvent("classes:updated", { detail: { context: context2 } }));
   if (response?.data?.data?.code === API_ERROR_CODES.DUPLICATED_LABEL) {
     dispatch2(slice.actions.updateMultiple(response.data.data.modifiedLabels));
     trackGlobalClasses({
@@ -1258,8 +1290,7 @@ import * as React15 from "react";
 import { useRef, useState as useState4 } from "react";
 import { validateStyleLabel } from "@elementor/editor-styles-repository";
 import { EditableField, EllipsisWithTooltip as EllipsisWithTooltip3, MenuListItem, useEditable, WarningInfotip } from "@elementor/editor-ui";
-import { isExperimentActive as isExperimentActive2 } from "@elementor/editor-v1-adapters";
-import { DotsVerticalIcon } from "@elementor/icons";
+import { DotsVerticalIcon, RefreshIcon, RefreshOffIcon } from "@elementor/icons";
 import {
   bindMenu,
   bindTrigger as bindTrigger2,
@@ -1754,7 +1785,7 @@ var ClassItem = ({
       },
       /* @__PURE__ */ React15.createElement(Typography6, { variant: "caption", sx: { color: "text.primary" } }, __11("Rename", "elementor"))
     ),
-    isExperimentActive2("e_design_system_sync") && onToggleSync && /* @__PURE__ */ React15.createElement(
+    onToggleSync && /* @__PURE__ */ React15.createElement(
       MenuListItem,
       {
         onClick: () => {
@@ -1762,7 +1793,7 @@ var ClassItem = ({
           onToggleSync(id2, !syncToV3);
         }
       },
-      /* @__PURE__ */ React15.createElement(Typography6, { variant: "caption", sx: { color: "text.primary" } }, syncToV3 ? __11("Stop syncing to Version 3", "elementor") : __11("Sync to Version 3", "elementor"))
+      /* @__PURE__ */ React15.createElement(Stack6, { direction: "row", alignItems: "center", gap: 1 }, syncToV3 ? /* @__PURE__ */ React15.createElement(RefreshOffIcon, { fontSize: "tiny" }) : /* @__PURE__ */ React15.createElement(RefreshIcon, { fontSize: "tiny" }), /* @__PURE__ */ React15.createElement(Typography6, { variant: "caption", sx: { color: "text.primary" } }, syncToV3 ? __11("Stop syncing to Global Fonts", "elementor") : __11("Sync to Global Fonts", "elementor")))
     ),
     /* @__PURE__ */ React15.createElement(
       MenuListItem,
@@ -2107,7 +2138,7 @@ function unblockPanelInteractions() {
 
 // src/components/class-manager/start-sync-to-v3-modal.tsx
 import * as React18 from "react";
-import { useState as useState6 } from "react";
+import { useEffect as useEffect3, useRef as useRef2, useState as useState6 } from "react";
 import {
   Box as Box10,
   Button as Button2,
@@ -2120,17 +2151,38 @@ import {
 } from "@elementor/ui";
 import { __ as __14 } from "@wordpress/i18n";
 var IMAGE_URL = "https://assets.elementor.com/packages/v1/images/class-manager-sync-modal.png";
-var StartSyncToV3Modal = ({ externalOpen, onExternalClose, onConfirm } = {}) => {
+var StartSyncToV3Modal = ({
+  externalOpen,
+  classId,
+  onExternalClose,
+  onConfirm
+} = {}) => {
   const [shouldShowAgain, setShouldShowAgain] = useState6(true);
+  const hasTrackedExposure = useRef2(false);
+  useEffect3(() => {
+    if (externalOpen && classId && !hasTrackedExposure.current) {
+      hasTrackedExposure.current = true;
+      trackGlobalClasses({ event: "classSyncToV3PopupShown", classId });
+    }
+    if (!externalOpen) {
+      hasTrackedExposure.current = false;
+    }
+  }, [externalOpen, classId]);
   const handleClose = () => {
+    if (classId) {
+      trackGlobalClasses({ event: "classSyncToV3PopupClick", classId, action: "cancel" });
+    }
     onExternalClose?.();
   };
   const handleConfirm = () => {
+    if (classId) {
+      trackGlobalClasses({ event: "classSyncToV3PopupClick", classId, action: "sync" });
+    }
     onConfirm?.();
     onExternalClose?.();
   };
-  return /* @__PURE__ */ React18.createElement(Dialog, { open: !!externalOpen, onClose: handleClose, maxWidth: "sm", fullWidth: true }, /* @__PURE__ */ React18.createElement(DialogContent2, { sx: { p: 0 } }, /* @__PURE__ */ React18.createElement(Box10, { component: "img", src: IMAGE_URL, alt: "", sx: { width: "100%", display: "block" } }), /* @__PURE__ */ React18.createElement(Box10, { sx: { px: 3, pt: 4, pb: 1 } }, /* @__PURE__ */ React18.createElement(Typography9, { variant: "h6" }, __14("Sync class to version 3 Global Fonts", "elementor")), /* @__PURE__ */ React18.createElement(Typography9, { variant: "body2", color: "secondary", sx: { mb: 2, pt: 1 } }, __14(
-    "Only typography settings supported in version 3 will be applied, including: font family, responsive font sizes, weight, text transform, decoration, line height, letter spacing, and word spacing. Changes made in the class will automatically apply to version 3.",
+  return /* @__PURE__ */ React18.createElement(Dialog, { open: !!externalOpen, onClose: handleClose, maxWidth: "sm", fullWidth: true }, /* @__PURE__ */ React18.createElement(DialogContent2, { sx: { p: 0 } }, /* @__PURE__ */ React18.createElement(Box10, { component: "img", src: IMAGE_URL, alt: "", sx: { width: "100%", display: "block" } }), /* @__PURE__ */ React18.createElement(Box10, { sx: { px: 3, pt: 4, pb: 1 } }, /* @__PURE__ */ React18.createElement(Typography9, { variant: "h6" }, __14("Sync class to Global Fonts", "elementor")), /* @__PURE__ */ React18.createElement(Typography9, { variant: "body2", color: "secondary", sx: { mb: 2, pt: 1 } }, __14(
+    "Only typography settings supported in Global Fonts will be applied, including: font family, responsive font sizes, weight, text transform, decoration, line height, letter spacing, and word spacing. Changes made in the class will automatically apply to Global Fonts.",
     "elementor"
   )))), /* @__PURE__ */ React18.createElement(DialogActions2, { sx: { justifyContent: "space-between", px: 3, pb: 2 } }, /* @__PURE__ */ React18.createElement(
     FormControlLabel,
@@ -2144,7 +2196,7 @@ var StartSyncToV3Modal = ({ externalOpen, onExternalClose, onConfirm } = {}) =>
       ),
       label: /* @__PURE__ */ React18.createElement(Typography9, { variant: "body2", color: "secondary" }, __14("Don't show again", "elementor"))
     }
-  ), /* @__PURE__ */ React18.createElement(Box10, { sx: { display: "flex", gap: 1 } }, /* @__PURE__ */ React18.createElement(Button2, { onClick: handleClose, color: "secondary", size: "small" }, __14("Cancel", "elementor")), /* @__PURE__ */ React18.createElement(Button2, { onClick: handleConfirm, variant: "contained", size: "small" }, __14("Sync to version 3", "elementor")))));
+  ), /* @__PURE__ */ React18.createElement(Box10, { sx: { display: "flex", gap: 1 } }, /* @__PURE__ */ React18.createElement(Button2, { onClick: handleClose, color: "secondary", size: "small" }, __14("Cancel", "elementor")), /* @__PURE__ */ React18.createElement(Button2, { onClick: handleConfirm, variant: "contained", size: "small" }, __14("Sync to Global Fonts", "elementor")))));
 };
 
 // src/components/class-manager/class-manager-panel.tsx
@@ -2196,6 +2248,7 @@ function ClassManagerPanel() {
         }
       })
     );
+    trackGlobalClasses({ event: "classSyncToV3", classId, action: "unsync" });
     setStopSyncConfirmation(null);
   }, []);
   const handleStartSync = useCallback((classId) => {
@@ -2207,6 +2260,7 @@ function ClassManagerPanel() {
         }
       })
     );
+    trackGlobalClasses({ event: "classSyncToV3", classId, action: "sync" });
     setStartSyncConfirmation(null);
   }, []);
   const handleStopSyncRequest = useCallback(
@@ -2278,6 +2332,7 @@ function ClassManagerPanel() {
     StartSyncToV3Modal,
     {
       externalOpen: true,
+      classId: startSyncConfirmation,
       onExternalClose: () => setStartSyncConfirmation(null),
       onConfirm: () => handleStartSync(startSyncConfirmation)
     }
@@ -2314,7 +2369,7 @@ var CloseButton = ({ onClose, ...props }) => /* @__PURE__ */ React19.createEleme
 var ErrorBoundaryFallback = () => /* @__PURE__ */ React19.createElement(Box11, { role: "alert", sx: { minHeight: "100%", p: 2 } }, /* @__PURE__ */ React19.createElement(Alert2, { severity: "error", sx: { mb: 2, maxWidth: 400, textAlign: "center" } }, /* @__PURE__ */ React19.createElement("strong", null, __15("Something went wrong", "elementor"))));
 var usePreventUnload = () => {
   const isDirty2 = useDirtyState();
-  useEffect3(() => {
+  useEffect4(() => {
     const handleBeforeUnload = (event) => {
       if (isDirty2) {
         event.preventDefault();
@@ -2350,7 +2405,7 @@ var TotalCssClassCounter = () => {
 };
 var StopSyncConfirmationDialog = ({ open, onClose, onConfirm }) => {
   const [, suppressStopSyncMessage] = useSuppressedMessage2(STOP_SYNC_MESSAGE_KEY);
-  return /* @__PURE__ */ React19.createElement(ConfirmationDialog2, { open, onClose }, /* @__PURE__ */ React19.createElement(ConfirmationDialog2.Title, { icon: FlippedColorSwatchIcon, iconColor: "primary" }, __15("Un-sync typography class", "elementor")), /* @__PURE__ */ React19.createElement(ConfirmationDialog2.Content, null, /* @__PURE__ */ React19.createElement(ConfirmationDialog2.ContentText, null, __15("You're about to stop syncing a typography class to version 3.", "elementor")), /* @__PURE__ */ React19.createElement(ConfirmationDialog2.ContentText, { sx: { mt: 1 } }, __15(
+  return /* @__PURE__ */ React19.createElement(ConfirmationDialog2, { open, onClose }, /* @__PURE__ */ React19.createElement(ConfirmationDialog2.Title, { icon: FlippedColorSwatchIcon, iconColor: "primary" }, __15("Un-sync typography class", "elementor")), /* @__PURE__ */ React19.createElement(ConfirmationDialog2.Content, null, /* @__PURE__ */ React19.createElement(ConfirmationDialog2.ContentText, null, __15("You're about to stop syncing a typography class to Global Fonts.", "elementor")), /* @__PURE__ */ React19.createElement(ConfirmationDialog2.ContentText, { sx: { mt: 1 } }, __15(
     "Note that if it's being used anywhere, the affected elements will inherit the default typography.",
     "elementor"
   ))), /* @__PURE__ */ React19.createElement(
@@ -2474,16 +2529,67 @@ function createClassName(prefix) {
   return newClassName;
 }
 
+// src/components/global-styles-import-listener.tsx
+import { useEffect as useEffect5 } from "react";
+import { __useDispatch as useDispatch2 } from "@elementor/store";
+function GlobalStylesImportListener() {
+  const dispatch5 = useDispatch2();
+  useEffect5(() => {
+    const handleGlobalStylesImported = (event) => {
+      const importedClasses = event.detail?.global_classes;
+      if (importedClasses?.items && importedClasses?.order) {
+        dispatch5(
+          slice.actions.load({
+            preview: {
+              items: importedClasses.items,
+              order: importedClasses.order
+            },
+            frontend: {
+              items: importedClasses.items,
+              order: importedClasses.order
+            }
+          })
+        );
+      }
+      Promise.all([apiClient.all("preview"), apiClient.all("frontend")]).then(([previewRes, frontendRes]) => {
+        const { data: previewData } = previewRes;
+        const { data: frontendData } = frontendRes;
+        dispatch5(
+          slice.actions.load({
+            preview: {
+              items: previewData.data,
+              order: previewData.meta.order
+            },
+            frontend: {
+              items: frontendData.data,
+              order: frontendData.meta.order
+            }
+          })
+        );
+      }).catch(() => {
+      });
+    };
+    window.addEventListener("elementor/global-styles/imported", handleGlobalStylesImported);
+    return () => {
+      window.removeEventListener(
+        "elementor/global-styles/imported",
+        handleGlobalStylesImported
+      );
+    };
+  }, [dispatch5]);
+  return null;
+}
+
 // src/components/open-panel-from-url.tsx
-import { useEffect as useEffect4, useRef as useRef2 } from "react";
+import { useEffect as useEffect6, useRef as useRef3 } from "react";
 import { __privateListenTo as listenTo, routeOpenEvent } from "@elementor/editor-v1-adapters";
 var ACTIVE_PANEL_PARAM = "active-panel";
 var PANEL_ID = "global-classes-manager";
 var DEFAULT_PANEL_ROUTE = "panel/elements";
 function OpenPanelFromUrl() {
   const { open } = usePanelActions();
-  const hasOpened = useRef2(false);
-  useEffect4(() => {
+  const hasOpened = useRef3(false);
+  useEffect6(() => {
     const urlParams = new URLSearchParams(window.location.search);
     const activePanel = urlParams.get(ACTIVE_PANEL_PARAM);
     if (activePanel !== PANEL_ID) {
@@ -2504,11 +2610,11 @@ function OpenPanelFromUrl() {
 }
 
 // src/components/populate-store.tsx
-import { useEffect as useEffect5 } from "react";
-import { __useDispatch as useDispatch2 } from "@elementor/store";
+import { useEffect as useEffect7 } from "react";
+import { __useDispatch as useDispatch3 } from "@elementor/store";
 function PopulateStore() {
-  const dispatch5 = useDispatch2();
-  useEffect5(() => {
+  const dispatch5 = useDispatch3();
+  useEffect7(() => {
     Promise.all([apiClient.all("preview"), apiClient.all("frontend")]).then(
       ([previewRes, frontendRes]) => {
         const { data: previewData } = previewRes;
@@ -2531,9 +2637,6 @@ function PopulateStore() {
   return null;
 }
 
-// src/mcp-integration/index.ts
-import { getMCPByDomain as getMCPByDomain2 } from "@elementor/editor-mcp";
-
 // src/mcp-integration/mcp-apply-unapply-global-classes.ts
 import { doApplyClasses, doGetAppliedClasses, doUnapplyClass } from "@elementor/editor-editing-panel";
 import { z } from "@elementor/schema";
@@ -2962,18 +3065,25 @@ async function attemptDelete(opts) {
 }
 
 // src/mcp-integration/index.ts
-var initMcpIntegration = () => {
-  const reg = getMCPByDomain2("classes", {
-    instructions: "MCP server for management of Elementor global classes"
-  });
+var initMcpIntegration = (reg, canvasMcpEntry) => {
+  const { setMCPDescription } = reg;
+  setMCPDescription(
+    `Everything related to V4 ( Atomic ) global classes.
+# Global classes
+- Create/update/delete global classes
+- Get list of global classes
+- Get details of a global class
+- Get details of a global class
+`
+  );
   initMcpApplyUnapplyGlobalClasses(reg);
   initMcpApplyGetGlobalClassUsages(reg);
   initManageGlobalClasses(reg);
-  initClassesResource();
+  initClassesResource(reg, canvasMcpEntry);
 };
 
 // src/sync-with-document.tsx
-import { useEffect as useEffect6 } from "react";
+import { useEffect as useEffect8 } from "react";
 import { __privateListenTo as listenTo2, v1ReadyEvent } from "@elementor/editor-v1-adapters";
 
 // src/sync-with-document-save.ts
@@ -2981,9 +3091,11 @@ import { getCurrentUser } from "@elementor/editor-current-user";
 import { setDocumentModifiedStatus as setDocumentModifiedStatus2 } from "@elementor/editor-documents";
 import { registerDataHook } from "@elementor/editor-v1-adapters";
 import { __getState as getState4, __subscribeWithSelector as subscribeWithSelector2 } from "@elementor/store";
+var pendingSave = null;
 function syncWithDocumentSave(panelActions) {
   const unsubscribe = syncDirtyState();
   bindSaveAction(panelActions);
+  bindBeforeSaveTemplateAction();
   return unsubscribe;
 }
 function syncDirtyState() {
@@ -2994,20 +3106,41 @@ function syncDirtyState() {
     setDocumentModifiedStatus2(true);
   });
 }
+function triggerSave(panelActions, context2 = "preview") {
+  const user = getCurrentUser();
+  const canEdit = user?.capabilities.includes(UPDATE_CLASS_CAPABILITY_KEY);
+  if (!canEdit) {
+    return null;
+  }
+  if (pendingSave) {
+    return pendingSave;
+  }
+  const promise = saveGlobalClasses({
+    context: context2,
+    onApprove: panelActions?.open
+  });
+  pendingSave = promise;
+  promise.finally(() => {
+    pendingSave = null;
+  });
+  return promise;
+}
 function bindSaveAction(panelActions) {
   registerDataHook("dependency", "document/save/save", (args) => {
-    const user = getCurrentUser();
-    const canEdit = user?.capabilities.includes(UPDATE_CLASS_CAPABILITY_KEY);
-    if (!canEdit) {
-      return true;
-    }
-    saveGlobalClasses({
-      context: args.status === "publish" ? "frontend" : "preview",
-      onApprove: panelActions?.open
-    });
+    triggerSave(panelActions, args.status === "publish" ? "frontend" : "preview");
     return true;
   });
 }
+function bindBeforeSaveTemplateAction() {
+  window.addEventListener("elementor/global-styles/before-save", ((event) => {
+    if (!pendingSave && isDirty()) {
+      triggerSave();
+    }
+    if (pendingSave) {
+      event.detail.promises.push(pendingSave);
+    }
+  }));
+}
 function isDirty() {
   return selectIsDirty(getState4());
 }
@@ -3015,7 +3148,7 @@ function isDirty() {
 // src/sync-with-document.tsx
 function SyncWithDocumentSave() {
   const panelActions = usePanelActions();
-  useEffect6(() => {
+  useEffect8(() => {
     listenTo2(v1ReadyEvent(), () => {
       syncWithDocumentSave(panelActions);
     });
@@ -3036,6 +3169,10 @@ function init() {
     id: "global-classes-sync-with-document",
     component: SyncWithDocumentSave
   });
+  injectIntoLogic({
+    id: "global-classes-import-listener",
+    component: GlobalStylesImportListener
+  });
   injectIntoLogic({
     id: "global-classes-prefetch-css-class-usage",
     component: PrefetchCssClassUsage
@@ -3056,7 +3193,10 @@ function init() {
     name: "global",
     getThemeColor: (theme) => theme.palette.global.dark
   });
-  initMcpIntegration();
+  initMcpIntegration(
+    getMCPByDomain("classes", { instructions: "MCP server for management of Elementor global classes" }),
+    getMCPByDomain("canvas")
+  );
 }
 export {
   GLOBAL_CLASSES_URI,