@elementor/editor-global-classes 3.35.0-469 → 3.35.0-471

package/dist/index.mjs

@@ -504,22 +504,26 @@ var subscribeWithStates = (cb) => {
 // src/mcp-integration/classes-resource.ts
 var GLOBAL_CLASSES_URI = "elementor://global-classes";
 var initClassesResource = () => {
-  const { mcpServer, resource, waitForReady } = getMCPByDomain("canvas");
-  resource(
-    "global-classes",
-    GLOBAL_CLASSES_URI,
-    {
-      description: "Global classes list."
-    },
-    async () => {
-      return {
-        contents: [{ uri: GLOBAL_CLASSES_URI, text: localStorage["elementor-global-classes"] ?? {} }]
-      };
-    }
-  );
-  waitForReady().then(() => {
-    globalClassesStylesProvider.subscribe(() => {
-      mcpServer.sendResourceListChanged();
+  const canvasMcpEntry = getMCPByDomain("canvas");
+  const classesMcpEntry = getMCPByDomain("classes");
+  [canvasMcpEntry, classesMcpEntry].forEach((entry) => {
+    const { mcpServer, resource, waitForReady } = entry;
+    resource(
+      "global-classes",
+      GLOBAL_CLASSES_URI,
+      {
+        description: "Global classes list."
+      },
+      async () => {
+        return {
+          contents: [{ uri: GLOBAL_CLASSES_URI, text: localStorage["elementor-global-classes"] ?? "{}" }]
+        };
+      }
+    );
+    waitForReady().then(() => {
+      globalClassesStylesProvider.subscribe(() => {
+        mcpServer.sendResourceListChanged();
+      });
     });
   });
 };
@@ -1948,7 +1952,7 @@ var GlobalClassesList = ({ disabled }) => {
   const [classesOrder, reorderClasses] = useReorder(draggedItemId, setDraggedItemId, draggedItemLabel ?? "");
   const filteredCssClasses = useFilteredCssClasses();
   useEffect2(() => {
-    const handler3 = (event) => {
+    const handler2 = (event) => {
       if (event.key === "z" && (event.ctrlKey || event.metaKey)) {
         event.stopImmediatePropagation();
         event.preventDefault();
@@ -1959,10 +1963,10 @@ var GlobalClassesList = ({ disabled }) => {
         dispatch5(slice.actions.undo());
       }
     };
-    window.addEventListener("keydown", handler3, {
+    window.addEventListener("keydown", handler2, {
       capture: true
     });
-    return () => window.removeEventListener("keydown", handler3);
+    return () => window.removeEventListener("keydown", handler2);
   }, [dispatch5]);
   if (!cssClasses?.length) {
     return /* @__PURE__ */ React17.createElement(EmptyState, null);
@@ -2369,16 +2373,29 @@ function initMcpApplyUnapplyGlobalClasses(server) {
       intelligencePriority: 0.7,
       speedPriority: 0.8
     },
-    description: `Apply a global class to the current element
+    description: `Apply a global class to an element, enabling consistent styling through your design system.
 
 ## When to use this tool:
-- When a user requests to apply a global class or a class to an element in the Elementor editor.
-- When you need to add a specific class to an element's applied classes.
+**ALWAYS use this IMMEDIATELY AFTER building compositions** to apply the global classes you created beforehand:
+- After using "build-compositions" tool, apply semantic classes to the created elements
+- When applying consistent typography styles (heading-primary, text-body, etc.)
+- When applying theme colors or brand styles (bg-brand, button-cta, etc.)
+- When ensuring spacing consistency (spacing-section-large, etc.)
+
+**DO NOT use this tool** for:
+- Elements that don't share styles with other elements (use inline styles instead)
+- Layout-specific properties (those should remain inline in stylesConfig)
 
 ## Prerequisites:
-- Ensure you have the most up-to-date list of classes applied to the element to avoid duplicates.
-  List available at always up-to-date resource 'elementor://global-classes'.
-- Make sure you have the correct class ID that you want to apply.`,
+- **REQUIRED**: Get the list of available global classes from 'elementor://global-classes' resource
+- **REQUIRED**: Get element IDs from the composition XML returned by "build-compositions" tool
+- Ensure you have the most up-to-date list of classes applied to the element to avoid duplicates
+- Make sure you have the correct class ID that you want to apply
+
+## Best Practices:
+1. Apply multiple classes to a single element if needed (typography + color + spacing)
+2. After applying, the tool will remind you to remove duplicate inline styles from elementConfig
+3. Classes should describe purpose, not implementation (e.g., "heading-primary" not "big-red-text")`,
     handler: async (params) => {
       const { classId, elementId } = params;
       const appliedClasses = doGetAppliedClasses(elementId);
@@ -2430,168 +2447,22 @@ If the user want to unapply a class by it's name and not ID, retreive the id fro
   });
 }
 
-// src/mcp-integration/mcp-create-global-class.ts
-import { STYLE_SCHEMA_URI } from "@elementor/editor-canvas";
-import { Schema } from "@elementor/editor-props";
-import { getStylesSchema } from "@elementor/editor-styles";
-import { Utils } from "@elementor/editor-variables";
-import { z as z2 } from "@elementor/schema";
-var inputSchema = {
-  globalClassName: z2.string().describe("The name of the global class to be created"),
-  props: z2.record(z2.any()).describe(
-    'key-value of style-schema PropValues applied to the global class. Available properties at dynamic resource "elementor://styles/schema/{property-name}"'
-  ).default({}),
-  customCss: z2.string().optional().describe(
-    "Additional CSS styles associated with the global class. Use only if you fail to use the schema, specifically backgrounds"
-  ),
-  breakpoint: z2.nullable(
-    z2.enum(["desktop", "tablet", "mobile", "laptop", "widescreen", "tablet_extra", "mobile_extra"]).describe("The responsive breakpoint name for which the global class styles should be applied")
-  ).default(null).describe("The responsive breakpoint name for which the global class styles should be applied")
-};
-var outputSchema = {
-  classId: z2.string().describe("The unique identifier of the newly created global class")
-};
-var handler = async (input) => {
-  const customCss = input.customCss ? { raw: btoa(input.customCss) } : null;
-  const { delete: deleteClass2, create } = globalClassesStylesProvider.actions;
-  if (!create || !deleteClass2) {
-    throw new Error("Create action is not available");
-  }
-  const errors = [];
-  const stylesSchema = getStylesSchema();
-  const validProps = Object.keys(stylesSchema);
-  Object.keys(input.props).forEach((key) => {
-    const propType = getStylesSchema()[key];
-    if (!propType) {
-      errors.push(`Property "${key}" does not exist in styles schema.`);
-      return;
-    }
-    const { valid, jsonSchema } = Schema.validatePropValue(propType, input.props[key]);
-    if (!valid) {
-      errors.push(
-        `- Property "${key}" has invalid value
-  Exact schema: \`\`\`json
-${jsonSchema}\`\`\`
-`
-      );
-    }
-  });
-  if (errors.length > 0) {
-    throw new Error(
-      `Errors:
-${errors.join("\n")}
-Available Properties: ${validProps.join(
-        ", "
-      )}
-Now that you have this information, update your input and try again`
-    );
-  }
-  Object.keys(input.props).forEach((key) => {
-    input.props[key] = Schema.adjustLlmPropValueSchema(input.props[key], {
-      transformers: Utils.globalVariablesLLMResolvers
-    });
-  });
-  const classId = create(input.globalClassName, [
-    {
-      meta: {
-        breakpoint: input.breakpoint === null ? "desktop" : input.breakpoint,
-        state: null
-      },
-      custom_css: customCss,
-      props: input.props
-    }
-  ]);
-  try {
-    await saveGlobalClasses({ context: "frontend" });
-  } catch (err) {
-    deleteClass2(classId);
-    await saveGlobalClasses({ context: "frontend" });
-    throw new Error(`Failed to create global class, probably invalid schema values.`);
-  }
-  return {
-    classId
-  };
-};
-var initCreateGlobalClass = (reg) => {
-  const { addTool } = reg;
-  addTool({
-    requiredResources: [
-      { uri: GLOBAL_CLASSES_URI, description: "Global classes list" },
-      { uri: STYLE_SCHEMA_URI, description: "Style schema resources" }
-    ],
-    modelPreferences: {
-      intelligencePriority: 0.85,
-      speedPriority: 0.6
-    },
-    description: `Create a new global class within the Elementor editor, allowing users to define reusable styles and properties for consistent design across their website.
-      
-# Prequisites: CRITICAL
-- Read the style schema at [elementor://styles/schema/{category}] to understand the valid properties and values that can be assigned to the global class.
-- Available style properties can be found in the styles schema dynamic resources available from 'canvas' mcp. List the resources to see all available properties.
-- YOU MUST USE THE STYLE SCHEMA TO BUILD THE "props" PARAMETER CORRECTLY, OTHERWISE THE GLOBAL CLASS CREATION WILL FAIL.
-- Ensure that the global class name provided does not already exist to avoid duplication.
-- Read the styles schema resource available from 'canvas' mcp to understand the valid properties and values that can be assigned to the global class.
-
-## Parameters:
-- \`globalClassName\` (string, required): The name of the global class to be created.
-- \`props\` (object, required): A key-value map of style-schema PropValues that define the styles for the global class.
-- \`breakpoint\` (string | null, optional): The responsive breakpoint for which the styles should be applied. If null, styles apply to all breakpoints.
-
-## Example usage:
-\`\`\`json
-{
-  "globalClassName": "my-new-class",
-  "props": {
-    "color": {
-      "$$type": "color",
-      "value": "#ff0000"
-    },
-    "fontSize": {
-      "$$type": "size",
-      "value": {
-        "size": {
-          "$$type": "number",
-          "value": 2.5
-        },
-        "unit": {
-          "$$type": "string",
-          "value": "em"
-        }
-      }
-    }
-  },
-  "breakpoint": "desktop"
-}
-
-# Next steps:
-If failed, read the error message carefully, it includes the exact schema that caused the failure for each invalid property.
-Now that you have this information, update your input and try again.
-
-\`\`\`
-`,
-    name: "create-global-class",
-    schema: inputSchema,
-    outputSchema,
-    handler
-  });
-};
-
 // src/mcp-integration/mcp-get-global-class-usages.ts
-import { z as z3 } from "@elementor/schema";
+import { z as z2 } from "@elementor/schema";
 function initMcpApplyGetGlobalClassUsages(reg) {
   const { addTool } = reg;
   const globalClassesUsageSchema = {
-    usages: z3.array(
-      z3.object({
-        classId: z3.string().describe(
+    usages: z2.array(
+      z2.object({
+        classId: z2.string().describe(
           'The ID of the class, not visible to the user. To retreive the name of the class, use the "list-global-classes" tool'
         ),
-        usages: z3.array(
-          z3.object({
-            pageId: z3.string().describe("The ID of the page where the class is used"),
-            title: z3.string().describe("The title of the page where the class is used"),
-            total: z3.number().describe("The number of times the class is used on this page"),
-            elements: z3.array(z3.string()).describe("List of element IDs using this class on the page")
+        usages: z2.array(
+          z2.object({
+            pageId: z2.string().describe("The ID of the page where the class is used"),
+            title: z2.string().describe("The title of the page where the class is used"),
+            total: z2.number().describe("The number of times the class is used on this page"),
+            elements: z2.array(z2.string()).describe("List of element IDs using this class on the page")
           })
         )
       })
@@ -2647,139 +2518,247 @@ function initMcpApplyGetGlobalClassUsages(reg) {
   });
 }
 
-// src/mcp-integration/mcp-modify-global-class.ts
-import { BREAKPOINTS_SCHEMA_URI } from "@elementor/editor-canvas";
-import { Schema as Schema2 } from "@elementor/editor-props";
-import { getStylesSchema as getStylesSchema2 } from "@elementor/editor-styles";
-import { Utils as Utils2 } from "@elementor/editor-variables";
-import { z as z4 } from "@elementor/schema";
+// src/mcp-integration/mcp-manage-global-classes.ts
+import { BREAKPOINTS_SCHEMA_URI, STYLE_SCHEMA_URI } from "@elementor/editor-canvas";
+import { Schema } from "@elementor/editor-props";
+import { getStylesSchema } from "@elementor/editor-styles";
+import { z as z3 } from "@elementor/schema";
 var schema = {
-  classId: z4.string().describe("The ID of the global class to modify"),
-  props: z4.record(z4.any()).describe(
-    'key-value of style-schema PropValues to update the global class with. Available properties at dynamic resource "elementor://styles/schema/{property-name}"'
+  action: z3.enum(["create", "modify", "delete"]).describe("Operation to perform"),
+  classId: z3.string().optional().describe("Global class ID (required for modify). Get from elementor://global-classes resource."),
+  globalClassName: z3.string().optional().describe("Global class name (required for create)"),
+  props: z3.record(z3.any()).describe(
+    'key-value of style-schema PropValues. Available properties at dynamic resource "elementor://styles/schema/{property-name}"'
   ),
-  breakpoint: z4.nullable(z4.string()).default(null).describe("The responsive breakpoint name for which the global class styles should be applied"),
-  customCss: z4.string().optional().describe("The CSS styles associated with the global class.")
-};
-var handler2 = async (params) => {
-  const { classId, props } = params;
-  const customCss = params.customCss ? { raw: btoa(params.customCss) } : null;
-  const { update, delete: deleteClass2 } = globalClassesStylesProvider.actions;
-  if (!update || !deleteClass2) {
-    throw new Error("Update action is not available");
+  breakpoint: z3.nullable(z3.string().describe("Responsive breakpoint name for styles. Defaults to desktop (null).")).default(null).describe("Responsive breakpoint name for styles. Defaults to desktop (null).")
+};
+var outputSchema = {
+  status: z3.enum(["ok", "error"]).describe("Operation status"),
+  classId: z3.string().optional().describe("Class ID (returned on create success)"),
+  message: z3.string().optional().describe("Error details if status is error")
+};
+var handler = async (input) => {
+  const { action, classId, globalClassName, props, breakpoint } = input;
+  if (action === "create" && !globalClassName) {
+    return {
+      status: "error",
+      message: "Create requires globalClassName"
+    };
+  }
+  if (action === "modify" && !classId) {
+    return {
+      status: "error",
+      message: "Modify requires classId"
+    };
+  }
+  if (action === "delete" && !classId) {
+    return {
+      status: "error",
+      message: "Delete requires classId"
+    };
+  }
+  const { create, update, delete: deleteClass2 } = globalClassesStylesProvider.actions;
+  if (!create || !update || !deleteClass2) {
+    return {
+      status: "error",
+      message: "Required actions not available"
+    };
   }
   const errors = [];
-  const validProps = Object.keys(getStylesSchema2());
+  const stylesSchema = getStylesSchema();
+  const validProps = Object.keys(stylesSchema);
   Object.keys(props).forEach((key) => {
-    const propType = getStylesSchema2()[key];
+    const propType = stylesSchema[key];
     if (!propType) {
       errors.push(`Property "${key}" does not exist in styles schema.`);
       return;
     }
-    const { valid, jsonSchema } = Schema2.validatePropValue(propType, props[key]);
+    const { valid, jsonSchema } = Schema.validatePropValue(propType, props[key]);
     if (!valid) {
-      errors.push(`- Property "${key}" has invalid value:
-  expected Schema: ${jsonSchema}
+      errors.push(`- Property "${key}" has invalid value
+  Expected schema: ${jsonSchema}
 `);
     }
   });
   if (errors.length > 0) {
-    throw new Error(
-      `Errors:
+    return {
+      status: "error",
+      message: `Validation errors:
 ${errors.join("\n")}
 Available Properties: ${validProps.join(
         ", "
       )}
-Now that you have this information, update your input and try again`
-    );
+Update your input and try again.`
+    };
   }
+  const Utils = window.elementorV2.editorVariables.Utils;
   Object.keys(props).forEach((key) => {
-    props[key] = Schema2.adjustLlmPropValueSchema(props[key], {
-      transformers: Utils2.globalVariablesLLMResolvers
+    props[key] = Schema.adjustLlmPropValueSchema(props[key], {
+      transformers: Utils.globalVariablesLLMResolvers
     });
   });
-  const snapshot = structuredClone(globalClassesStylesProvider.actions.all());
+  const breakpointValue = breakpoint ?? "desktop";
   try {
-    update({
-      id: classId,
-      variants: [
-        {
-          custom_css: customCss,
+    switch (action) {
+      case "create":
+        const newClassId = await attemptCreate({
           props,
-          meta: {
-            breakpoint: params.breakpoint === null ? "desktop" : params.breakpoint,
-            state: null
-          }
-        }
-      ]
-    });
-    await saveGlobalClasses({ context: "frontend" });
+          className: globalClassName,
+          stylesProvider: globalClassesStylesProvider,
+          breakpoint: breakpointValue
+        });
+        return newClassId ? {
+          status: "ok",
+          message: `created global class with ID ${newClassId}`
+        } : {
+          status: "error",
+          message: "error creating class"
+        };
+      case "modify":
+        const updated = await attemptUpdate({
+          classId,
+          props,
+          stylesProvider: globalClassesStylesProvider,
+          breakpoint: breakpointValue
+        });
+        return updated ? { status: "ok", classId } : {
+          status: "error",
+          message: "error modifying class"
+        };
+      case "delete":
+        const deleted = await attemptDelete({
+          classId,
+          stylesProvider: globalClassesStylesProvider
+        });
+        return deleted ? { status: "ok", message: `deleted global class with ID ${classId}` } : {
+          status: "error",
+          message: "error deleting class"
+        };
+    }
   } catch (error) {
-    snapshot.forEach((style) => {
-      update({
-        id: style.id,
-        variants: style.variants
-      });
-    });
-    await saveGlobalClasses({ context: "frontend" });
-    throw new Error(`Failed to modify global class: ${error.message}`);
+    return {
+      status: "error",
+      message: `${action} failed: ${error.message || "Unknown error"}`
+    };
   }
-  return "ok";
 };
-var initModifyGlobalClass = (reg) => {
+var initManageGlobalClasses = (reg) => {
   const { addTool } = reg;
   addTool({
-    name: "modify-global-class",
+    name: "manage-global-classes",
     requiredResources: [
-      {
-        description: "Breakpoints list",
-        uri: BREAKPOINTS_SCHEMA_URI
-      },
-      {
-        description: "Global classes list",
-        uri: GLOBAL_CLASSES_URI
-      }
+      { uri: GLOBAL_CLASSES_URI, description: "Global classes list" },
+      { uri: STYLE_SCHEMA_URI, description: "Style schema resources" },
+      { uri: BREAKPOINTS_SCHEMA_URI, description: "Breakpoints list" }
     ],
     modelPreferences: {
-      hints: [{ name: "claude-sonnet-4-5" }],
       intelligencePriority: 0.85,
       speedPriority: 0.6
     },
-    description: `Modify an existing global class within the Elementor editor, allowing users to update styles and properties for consistent design across their website.
-# CRITICAL Prequisites:
-- Read the style schema at [elementor://styles/schema/{category}] to understand the valid properties and values that can be assigned to the global class.
-- Ensure that the global class ID provided exists.
-- Prefer style schema over custom_css
-
-## Parameters:
-- \`classId\` (string, required): The ID of the global class to be modified.
-- \`props\` (object, required): A key-value map of style-schema PropValues that define the new styles for the global class.
-- \`customCss\` (string, optional): The CSS styles associated with the global class.
-
-## Example usage:
-\`\`\`json
-{
-  "classId": "existing-class-id",
-  "props": {
-    "color": {
-      "$$type": "color",
-      "value": "#00ff00"
-    },
-  }
-}\`\`\`
-`,
+    description: `Manages global classes (create/modify) in Elementor editor. Check [elementor://global-classes] and style schemas first.
+
+CREATE: Requires globalClassName, props. Use semantic naming (heading-primary, button-cta, text-muted). Check existing classes to avoid duplicates. ALWAYS create global classes BEFORE compositions for reusable styles.
+MODIFY: Requires classId, props. Get classId from [elementor://global-classes] resource.
+
+Naming pattern: [element-type]-[purpose/variant]-[modifier]
+DO NOT create global classes for: one-off styles, layout-specific properties.
+
+Use style schema at [elementor://styles/schema/{category}] for valid props. Errors include exact schema mismatch details.`,
     schema,
-    handler: handler2
+    outputSchema,
+    handler
   });
 };
+async function attemptCreate(opts) {
+  const { props, breakpoint, className, stylesProvider } = opts;
+  const { create, delete: deleteClass2 } = stylesProvider.actions;
+  if (!className) {
+    throw new Error("Global class name is a required for creation");
+  }
+  if (!create || !deleteClass2) {
+    throw new Error("User is unable to create global classes");
+  }
+  const newClassId = create(className, [
+    {
+      meta: {
+        breakpoint,
+        state: null
+      },
+      custom_css: null,
+      props
+    }
+  ]);
+  try {
+    await saveGlobalClasses({ context: "frontend" });
+    return newClassId;
+  } catch {
+    deleteClass2(newClassId);
+    return null;
+  }
+}
+async function attemptUpdate(opts) {
+  const { props, breakpoint, classId, stylesProvider } = opts;
+  const { updateProps, update } = stylesProvider.actions;
+  if (!classId) {
+    throw new Error("Class ID is required for modification");
+  }
+  if (!updateProps || !update) {
+    throw new Error("User is unable to update global classes");
+  }
+  const snapshot = structuredClone(stylesProvider.actions.all());
+  try {
+    updateProps({
+      id: classId,
+      props,
+      meta: {
+        breakpoint,
+        state: null
+      }
+    });
+    await saveGlobalClasses({ context: "frontend" });
+    return true;
+  } catch {
+    snapshot.forEach((style) => {
+      update({
+        id: style.id,
+        variants: style.variants
+      });
+    });
+    await saveGlobalClasses({ context: "frontend" });
+    return false;
+  }
+}
+async function attemptDelete(opts) {
+  const { classId, stylesProvider } = opts;
+  const { delete: deleteClass2, create } = stylesProvider.actions;
+  if (!classId) {
+    throw new Error("Class ID is required for deletion");
+  }
+  if (!deleteClass2 || !create) {
+    throw new Error("User is unable to delete global classes");
+  }
+  const snapshot = structuredClone(stylesProvider.actions.all());
+  const targetClass = snapshot.find((style) => style.id === classId);
+  if (!targetClass) {
+    throw new Error(`Class with ID "${classId}" not found`);
+  }
+  try {
+    deleteClass2(classId);
+    await saveGlobalClasses({ context: "frontend" });
+    return true;
+  } catch {
+    return false;
+  }
+}
 
 // src/mcp-integration/index.ts
 var initMcpIntegration = () => {
-  const reg = getMCPByDomain2("canvas");
+  const reg = getMCPByDomain2("classes", {
+    instructions: "MCP server for management of Elementor global classes"
+  });
   initMcpApplyUnapplyGlobalClasses(reg);
   initMcpApplyGetGlobalClassUsages(reg);
-  initCreateGlobalClass(reg);
-  initModifyGlobalClass(reg);
+  initManageGlobalClasses(reg);
   initClassesResource();
 };