@elementor/editor-props 4.2.0-924 → 4.2.0-925

package/dist/index.mjs

@@ -879,7 +879,13 @@ function convertJsonSchemaToPropType(schema, key) {
 }
 
 // src/utils/props-to-llm-schema.ts
-function propTypeToJsonSchema(propType) {
+var DYNAMIC_PROP_TYPE_KEY = "dynamic";
+var OVERRIDABLE_PROP_TYPE_KEY = "overridable";
+var dynamicTagNamesResolver = null;
+function setDynamicTagNamesResolver(resolver) {
+  dynamicTagNamesResolver = resolver;
+}
+function propTypeToJsonSchema(propType, suppressDynamic = false) {
   const description = propType.meta?.description;
   const schema = {};
   if (description) {
@@ -890,11 +896,11 @@ function propTypeToJsonSchema(propType) {
   }
   switch (propType.kind) {
     case "union":
-      return convertUnionPropType(propType, schema);
+      return convertUnionPropType(propType, schema, suppressDynamic);
     case "object":
-      return convertObjectPropType(propType, schema);
+      return convertObjectPropType(propType, schema, suppressDynamic);
     case "array":
-      return convertArrayPropType(propType, schema);
+      return convertArrayPropType(propType, schema, suppressDynamic);
     default:
       return convertPlainPropType(propType, schema);
   }
@@ -935,16 +941,23 @@ function convertPlainPropType(propType, baseSchema) {
       };
   }
 }
-function convertUnionPropType(propType, baseSchema) {
+function convertUnionPropType(propType, baseSchema, suppressDynamic) {
   const schema = structuredClone(baseSchema);
   const propTypes = propType.prop_types || {};
+  const offersDynamic = !suppressDynamic && Boolean(propTypes[DYNAMIC_PROP_TYPE_KEY]);
+  const suppressNestedDynamic = suppressDynamic || offersDynamic;
   const schemas = [];
   for (const [typeKey, subPropType] of Object.entries(propTypes)) {
-    if (typeKey === "dynamic" || typeKey === "overridable") {
+    if (typeKey === OVERRIDABLE_PROP_TYPE_KEY) {
       continue;
     }
-    const subSchema = convertPropTypeToJsonSchema(subPropType);
-    schemas.push(subSchema);
+    if (typeKey === DYNAMIC_PROP_TYPE_KEY) {
+      if (offersDynamic) {
+        schemas.push(convertDynamicPropType(subPropType));
+      }
+      continue;
+    }
+    schemas.push(propTypeToJsonSchema(subPropType, suppressNestedDynamic));
   }
   if (schemas.length > 0) {
     schema.anyOf = schemas;
@@ -955,7 +968,34 @@ function convertUnionPropType(propType, baseSchema) {
   }
   return schema;
 }
-function convertObjectPropType(propType, baseSchema) {
+function convertDynamicPropType(propType) {
+  const categories = Array.isArray(propType.settings?.categories) ? propType.settings.categories : [];
+  const allowedTagNames = dynamicTagNamesResolver?.(categories) ?? [];
+  return {
+    type: "object",
+    description: `Bind THIS value to a dynamic tag instead of a static value (this may be a nested field, e.g. an image's "src"). Look up the chosen tag in the "elementor://dynamic-tags" resource and populate "settings" exactly as its schema requires.`,
+    properties: {
+      $$type: { type: "string", const: DYNAMIC_PROP_TYPE_KEY },
+      value: {
+        type: "object",
+        properties: {
+          name: {
+            type: "string",
+            description: 'Dynamic tag name from "elementor://dynamic-tags".',
+            ...allowedTagNames.length ? { enum: allowedTagNames } : {}
+          },
+          settings: {
+            type: "object",
+            description: "Tag settings matching the chosen tag's schema in the resource."
+          }
+        },
+        required: ["name"]
+      }
+    },
+    required: ["$$type", "value"]
+  };
+}
+function convertObjectPropType(propType, baseSchema, suppressDynamic) {
   const schema = structuredClone(baseSchema);
   schema.type = "object";
   const internalStructure = {
@@ -975,7 +1015,7 @@ function convertObjectPropType(propType, baseSchema) {
   const valueRequired = [];
   const shape = propType.shape || {};
   for (const [key, subPropType] of Object.entries(shape)) {
-    const propSchema = propTypeToJsonSchema(subPropType);
+    const propSchema = propTypeToJsonSchema(subPropType, suppressDynamic);
     if (subPropType.settings?.required === true) {
       valueRequired.push(key);
     }
@@ -992,13 +1032,13 @@ function convertObjectPropType(propType, baseSchema) {
     ...internalStructure
   };
 }
-function convertArrayPropType(propType, baseSchema) {
+function convertArrayPropType(propType, baseSchema, suppressDynamic) {
   const schema = structuredClone(baseSchema);
   schema.type = "object";
   let items;
   const itemPropType = propType.item_prop_type;
   if (itemPropType) {
-    items = convertPropTypeToJsonSchema(itemPropType);
+    items = propTypeToJsonSchema(itemPropType, suppressDynamic);
   }
   schema.properties = {
     $$type: {
@@ -1012,9 +1052,6 @@ function convertArrayPropType(propType, baseSchema) {
   };
   return schema;
 }
-function convertPropTypeToJsonSchema(propType) {
-  return propTypeToJsonSchema(propType);
-}
 var nonConfigurablePropKeys = ["_cssid", "classes", "attributes"];
 function isPropKeyConfigurable(propKey, propType) {
   if (!nonConfigurablePropKeys.includes(propKey)) {
@@ -1363,7 +1400,8 @@ var Schema = {
   configurableKeys,
   validatePropValue,
   enrichWithIntention,
-  removeIntention
+  removeIntention,
+  setDynamicTagNamesResolver
 };
 export {
   CLASSES_PROP_KEY,