@elementor/editor-interactions 4.1.0-838 → 4.1.0-beta2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elementor/editor-interactions",
-  "version": "4.1.0-838",
+  "version": "4.1.0-beta2",
   "private": false,
   "author": "Elementor Team",
   "homepage": "https://elementor.com/",
@@ -39,19 +39,19 @@
     "dev": "tsup --config=../../tsup.dev.ts"
   },
   "dependencies": {
-    "@elementor/editor-controls": "4.1.0-838",
-    "@elementor/editor-elements": "4.1.0-838",
-    "@elementor/editor-mcp": "4.1.0-838",
-    "@elementor/editor-props": "4.1.0-838",
-    "@elementor/editor-responsive": "4.1.0-838",
-    "@elementor/editor-ui": "4.1.0-838",
-    "@elementor/editor-v1-adapters": "4.1.0-838",
+    "@elementor/editor-controls": "4.1.0-beta2",
+    "@elementor/editor-elements": "4.1.0-beta2",
+    "@elementor/editor-mcp": "4.1.0-beta2",
+    "@elementor/editor-props": "4.1.0-beta2",
+    "@elementor/editor-responsive": "4.1.0-beta2",
+    "@elementor/editor-ui": "4.1.0-beta2",
+    "@elementor/editor-v1-adapters": "4.1.0-beta2",
     "@elementor/icons": "~1.75.1",
-    "@elementor/schema": "4.1.0-838",
-    "@elementor/session": "4.1.0-838",
+    "@elementor/schema": "4.1.0-beta2",
+    "@elementor/session": "4.1.0-beta2",
     "@elementor/ui": "1.37.5",
-    "@elementor/utils": "4.1.0-838",
-    "@elementor/events": "4.1.0-838",
+    "@elementor/utils": "4.1.0-beta2",
+    "@elementor/events": "4.1.0-beta2",
     "@wordpress/i18n": "^5.13.0"
   },
   "peerDependencies": {

package/src/init.ts

@@ -11,7 +11,11 @@ import { Trigger } from './components/controls/trigger';
 import { initCleanInteractionIdsOnDuplicate } from './hooks/on-duplicate';
 import { registerInteractionsControl } from './interactions-controls-registry';
 import { interactionsRepository } from './interactions-repository';
-import { EDITOR_INTERACTIONS_MCP_INSTRUCTIONS, initMcpInteractions } from './mcp';
+import {
+	EDITOR_INTERACTIONS_MCP_DESCRIPTION,
+	EDITOR_INTERACTIONS_MCP_SHORT_DESCRIPTION,
+	initMcpInteractions,
+} from './mcp';
 import { documentElementsInteractionsProvider } from './providers/document-elements-interactions-provider';
 
 export function init() {
@@ -62,7 +66,12 @@ export function init() {
 			component: Repeat,
 		} );
 
-		initMcpInteractions( getMCPByDomain( 'interactions', { instructions: EDITOR_INTERACTIONS_MCP_INSTRUCTIONS } ) );
+		initMcpInteractions(
+			getMCPByDomain( 'interactions', {
+				docs: EDITOR_INTERACTIONS_MCP_DESCRIPTION,
+				instructions: EDITOR_INTERACTIONS_MCP_SHORT_DESCRIPTION,
+			} )
+		);
 	} catch ( error ) {
 		throw error;
 	}

package/src/mcp/constants.ts

@@ -1,5 +1,11 @@
 export const MAX_INTERACTIONS_PER_ELEMENT = 5;
-export const EDITOR_INTERACTIONS_MCP_INSTRUCTIONS = `MCP server for managing element interactions and animations. Use this to add, modify, or remove animations and motion effects triggered by user events such as page load or scroll-into-view.
+export const EDITOR_INTERACTIONS_MCP_SHORT_DESCRIPTION = `Everything related to V4 ( Atomic ) interactions.
+# Interactions
+- Create/update/delete interactions
+- Get list of interactions
+- Get details of an interaction
+`;
+export const EDITOR_INTERACTIONS_MCP_DESCRIPTION = `MCP server for managing element interactions and animations. Use this to add, modify, or remove animations and motion effects triggered by user events such as page load or scroll-into-view.
 		** IMPORTANT **
 		Use the "interactions-schema" resource to get the schema of the interactions.
 		Actions:
@@ -8,7 +14,7 @@ export const EDITOR_INTERACTIONS_MCP_INSTRUCTIONS = `MCP server for managing ele
 		- update: Update an existing interaction by its interactionId.
 		- delete: Remove a specific interaction by its interactionId.
 		- clear: Remove all interactions from the element.
-		
+
 		For add/update, provide: trigger, effect, effectType, direction (required for slide effect), duration, delay, easing.
 		Use excludedBreakpoints to disable the animation on specific responsive breakpoints (e.g. ["mobile", "tablet"]).
 		Example Get Request:

package/src/mcp/tools/manage-element-interaction-tool.ts

@@ -23,6 +23,8 @@ const EMPTY_INTERACTIONS: ElementInteractions = {
 
 const EFFECTS_WITHOUT_TYPE = [ 'custom' ];
 
+const BREAKPOINTS_SCHEMA_URI = 'elementor://breakpoints/list';
+
 export const initManageElementInteractionTool = ( reg: MCPRegistryEntry ) => {
 	const { addTool } = reg;
 	const extendedSchema = isProActive() ? { ...baseSchema, ...proSchema } : baseSchema;
@@ -44,6 +46,7 @@ export const initManageElementInteractionTool = ( reg: MCPRegistryEntry ) => {
 		schema,
 		requiredResources: [
 			{ uri: INTERACTIONS_SCHEMA_URI, description: 'Interactions schema with all available options' },
+			{ uri: BREAKPOINTS_SCHEMA_URI, description: 'Available breakpoint IDs for excludedBreakpoints' },
 		],
 		isDestructive: true,
 		outputSchema: {

package/src/mcp/tools/schema.ts

@@ -12,12 +12,15 @@ export const baseSchema = {
 		),
 	duration: z.number().min( 0 ).max( 10000 ).optional().describe( 'Animation duration in milliseconds' ),
 	delay: z.number().min( 0 ).max( 10000 ).optional().describe( 'Animation delay in milliseconds' ),
-	easing: z.string().optional().describe( 'Easing function. See interactions schema for options.' ),
+	easing: z
+		.enum( [ 'easeIn' ] )
+		.optional()
+		.describe( 'Easing function for the animation. Use "easeIn" for free tier.' ),
 	excludedBreakpoints: z
-		.array( z.string() )
+		.array( z.enum( [ 'widescreen', 'desktop', 'laptop', 'tablet_extra', 'tablet', 'mobile_extra', 'mobile' ] ) )
 		.optional()
 		.describe(
-			'Breakpoint IDs on which this interaction is disabled (e.g. ["mobile", "tablet"]). Omit to enable on all breakpoints.'
+			'Breakpoint IDs on which this interaction is disabled (e.g. ["mobile", "tablet"]). Fetch the "elementor://breakpoints/list" resource to get the valid IDs for the current site. Omit to enable on all breakpoints.'
 		),
 };
 
@@ -27,6 +30,10 @@ export const proSchema = {
 		.optional()
 		.describe( 'Event that triggers the animation' ),
 	effect: z.enum( [ 'fade', 'slide', 'scale', 'custom' ] ).optional().describe( 'Animation effect type' ),
+	easing: z
+		.enum( [ 'easeIn', 'easeInOut', 'easeOut', 'backIn', 'backInOut', 'backOut', 'linear' ] )
+		.optional()
+		.describe( 'Easing function for the animation.' ),
 	customEffects: z
 		.object( {
 			keyframes: z