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

package/dist/index.d.mts

@@ -100,7 +100,9 @@ type JsonSchema7 = {
 
 declare function jsonSchemaToPropType(schema: JsonSchema7, key?: string): PropType;
 
-declare function propTypeToJsonSchema(propType: PropType): JsonSchema7;
+type DynamicTagNamesResolver = (categories: string[]) => string[];
+declare function setDynamicTagNamesResolver(resolver: DynamicTagNamesResolver | null): void;
+declare function propTypeToJsonSchema(propType: PropType, suppressDynamic?: boolean): JsonSchema7;
 declare function isPropKeyConfigurable(propKey: string, propType?: PropType): boolean;
 declare function configurableKeys(schema: PropsSchema): string[];
 declare function enrichWithIntention(jsonSchema: JsonSchema7, text?: string): JsonSchema7;
@@ -7743,6 +7745,7 @@ declare const Schema: {
     };
     enrichWithIntention: typeof enrichWithIntention;
     removeIntention: typeof removeIntention;
+    setDynamicTagNamesResolver: typeof setDynamicTagNamesResolver;
 };
 
 export { type AnyTransformable, type ArrayPropType, type ArrayPropValue, type BackdropFilterItemPropValue, type BackdropFilterPropValue, type BackgroundColorOverlayPropValue, type BackgroundGradientOverlayPropValue, type BackgroundImageOverlayPropValue, type BackgroundImagePositionOffsetPropValue, type BackgroundImageSizeScalePropValue, type BackgroundOverlayImagePropType, type BackgroundOverlayItemPropValue, type BackgroundOverlayPropType, type BackgroundOverlayPropValue, type BackgroundPropValue, type BooleanPropValue, type BorderRadiusPropValue, type BorderWidthPropValue, type BoxShadowPropValue, CLASSES_PROP_KEY, type ChildElement, type ClassesPropValue, type ColorPropValue, type ColorStopPropValue, type CreateOptions, type DateRangePropValue, type DateStringPropValue, DateTimePropTypeUtil, type DateTimePropValue, type Dependency, type DependencyOperator, type DependencyTerm, type DimensionsPropValue, type DropShadowFilterPropValue, type EmailPropValue, type EmailsPropValue, type ExtractValueOptions, type FilterItemPropValue, type FilterPropValue, type FlexPropValue, type GradientColorStopPropValue, type GridTrackSizePropValue, type HtmlPropValue, type HtmlV2PropValue, type HtmlV2Value, type HtmlV3PropValue, type HtmlV3Value, type ImageAttachmentIdPropValue, type ImagePropValue, type ImageSrcPropValue, type JsonSchema7, type KeyValuePropValue, type LayoutDirectionPropValue, type LinkPropValue, type MoveTransformPropValue, type NumberPropValue, type NumberRangePropValue, type ObjectPropType, type ObjectPropValue, type OverridableTransformable, type ParseResult, type PerspectiveOriginPropValue, type PlainPropType, type PlainPropValue, type PositionPropTypeValue, type PropKey, type PropType, type PropTypeKey, type PropTypeUtil, type PropValue, type Props, type PropsSchema, type QueryFilterKeyConfig, type QueryFilterPropValue, type QueryPropValue, type RotateTransformPropValue, type ScaleTransformPropValue, Schema, type SelectionSizePropValue, type ShadowPropValue, type SizePropValue, type SkewTransformPropValue, type SpanPropValue, type StringArrayPropValue, type StringPropValue, type StrokePropValue, type SvgSrcPropValue, type TimeRangePropValue, type TimeStringPropValue, type TransformFunctionsItemPropValue, type TransformFunctionsPropValue, type TransformOriginPropValue, type TransformPropValue, type TransformablePropType, type TransformablePropValue$1 as TransformablePropValue, type UnionPropType, type UrlPropValue, type VideoAttachmentIdPropValue, type VideoSrcPropValue, backdropFilterPropTypeUtil, backgroundColorOverlayPropTypeUtil, backgroundGradientOverlayPropTypeUtil, backgroundImageOverlayPropTypeUtil, backgroundImagePositionOffsetPropTypeUtil, backgroundImageSizeScalePropTypeUtil, backgroundOverlayItem, backgroundOverlayPropTypeUtil, backgroundPropTypeUtil, blurFilterPropTypeUtil, booleanPropTypeUtil, borderRadiusPropTypeUtil, borderWidthPropTypeUtil, boxShadowPropTypeUtil, classesPropTypeUtil, colorPropTypeUtil, colorStopPropTypeUtil, colorToneFilterPropTypeUtil, createArrayPropUtils, createPropUtils, cssFilterFunctionPropUtil, dateRangePropTypeUtil, dateStringPropTypeUtil, dimensionsPropTypeUtil, dropShadowFilterPropTypeUtil, emailPropTypeUtil, emailsPropTypeUtil, evaluateTerm, extractValue, filterEmptyValues, filterPropTypeUtil, flexPropTypeUtil, getPropSchemaFromCache, gradientColorStopPropTypeUtil, gridTrackSizePropTypeUtil, htmlPropTypeUtil, htmlV2PropTypeUtil, htmlV3PropTypeUtil, hueRotateFilterPropTypeUtil, imageAttachmentIdPropType, imagePropTypeUtil, imageSrcPropTypeUtil, intensityFilterPropTypeUtil, isDependency, isDependencyMet, isEmpty, isOverridable, isTransformable, keyValuePropTypeUtil, layoutDirectionPropTypeUtil, linkPropTypeUtil, mergeProps, moveTransformPropTypeUtil, numberPropTypeUtil, numberRangePropTypeUtil, parseHtmlChildren, perspectiveOriginPropTypeUtil, positionPropTypeUtil, queryFilterArrayPropTypeUtil, queryFilterPropTypeUtil, queryPropTypeUtil, rewrapOverridableValue, rotateTransformPropTypeUtil, scaleTransformPropTypeUtil, selectionSizePropTypeUtil, shadowPropTypeUtil, sizePropTypeUtil, skewTransformPropTypeUtil, spanPropTypeUtil, stringArrayPropTypeUtil, stringPropTypeUtil, strokePropTypeUtil, svgSrcPropTypeUtil, timeRangePropTypeUtil, timeStringPropTypeUtil, transformFunctionsPropTypeUtil, transformOriginPropTypeUtil, transformPropTypeUtil, urlPropTypeUtil, videoAttachmentIdPropType, videoSrcPropTypeUtil };

package/dist/index.d.ts

@@ -100,7 +100,9 @@ type JsonSchema7 = {
 
 declare function jsonSchemaToPropType(schema: JsonSchema7, key?: string): PropType;
 
-declare function propTypeToJsonSchema(propType: PropType): JsonSchema7;
+type DynamicTagNamesResolver = (categories: string[]) => string[];
+declare function setDynamicTagNamesResolver(resolver: DynamicTagNamesResolver | null): void;
+declare function propTypeToJsonSchema(propType: PropType, suppressDynamic?: boolean): JsonSchema7;
 declare function isPropKeyConfigurable(propKey: string, propType?: PropType): boolean;
 declare function configurableKeys(schema: PropsSchema): string[];
 declare function enrichWithIntention(jsonSchema: JsonSchema7, text?: string): JsonSchema7;
@@ -7743,6 +7745,7 @@ declare const Schema: {
     };
     enrichWithIntention: typeof enrichWithIntention;
     removeIntention: typeof removeIntention;
+    setDynamicTagNamesResolver: typeof setDynamicTagNamesResolver;
 };
 
 export { type AnyTransformable, type ArrayPropType, type ArrayPropValue, type BackdropFilterItemPropValue, type BackdropFilterPropValue, type BackgroundColorOverlayPropValue, type BackgroundGradientOverlayPropValue, type BackgroundImageOverlayPropValue, type BackgroundImagePositionOffsetPropValue, type BackgroundImageSizeScalePropValue, type BackgroundOverlayImagePropType, type BackgroundOverlayItemPropValue, type BackgroundOverlayPropType, type BackgroundOverlayPropValue, type BackgroundPropValue, type BooleanPropValue, type BorderRadiusPropValue, type BorderWidthPropValue, type BoxShadowPropValue, CLASSES_PROP_KEY, type ChildElement, type ClassesPropValue, type ColorPropValue, type ColorStopPropValue, type CreateOptions, type DateRangePropValue, type DateStringPropValue, DateTimePropTypeUtil, type DateTimePropValue, type Dependency, type DependencyOperator, type DependencyTerm, type DimensionsPropValue, type DropShadowFilterPropValue, type EmailPropValue, type EmailsPropValue, type ExtractValueOptions, type FilterItemPropValue, type FilterPropValue, type FlexPropValue, type GradientColorStopPropValue, type GridTrackSizePropValue, type HtmlPropValue, type HtmlV2PropValue, type HtmlV2Value, type HtmlV3PropValue, type HtmlV3Value, type ImageAttachmentIdPropValue, type ImagePropValue, type ImageSrcPropValue, type JsonSchema7, type KeyValuePropValue, type LayoutDirectionPropValue, type LinkPropValue, type MoveTransformPropValue, type NumberPropValue, type NumberRangePropValue, type ObjectPropType, type ObjectPropValue, type OverridableTransformable, type ParseResult, type PerspectiveOriginPropValue, type PlainPropType, type PlainPropValue, type PositionPropTypeValue, type PropKey, type PropType, type PropTypeKey, type PropTypeUtil, type PropValue, type Props, type PropsSchema, type QueryFilterKeyConfig, type QueryFilterPropValue, type QueryPropValue, type RotateTransformPropValue, type ScaleTransformPropValue, Schema, type SelectionSizePropValue, type ShadowPropValue, type SizePropValue, type SkewTransformPropValue, type SpanPropValue, type StringArrayPropValue, type StringPropValue, type StrokePropValue, type SvgSrcPropValue, type TimeRangePropValue, type TimeStringPropValue, type TransformFunctionsItemPropValue, type TransformFunctionsPropValue, type TransformOriginPropValue, type TransformPropValue, type TransformablePropType, type TransformablePropValue$1 as TransformablePropValue, type UnionPropType, type UrlPropValue, type VideoAttachmentIdPropValue, type VideoSrcPropValue, backdropFilterPropTypeUtil, backgroundColorOverlayPropTypeUtil, backgroundGradientOverlayPropTypeUtil, backgroundImageOverlayPropTypeUtil, backgroundImagePositionOffsetPropTypeUtil, backgroundImageSizeScalePropTypeUtil, backgroundOverlayItem, backgroundOverlayPropTypeUtil, backgroundPropTypeUtil, blurFilterPropTypeUtil, booleanPropTypeUtil, borderRadiusPropTypeUtil, borderWidthPropTypeUtil, boxShadowPropTypeUtil, classesPropTypeUtil, colorPropTypeUtil, colorStopPropTypeUtil, colorToneFilterPropTypeUtil, createArrayPropUtils, createPropUtils, cssFilterFunctionPropUtil, dateRangePropTypeUtil, dateStringPropTypeUtil, dimensionsPropTypeUtil, dropShadowFilterPropTypeUtil, emailPropTypeUtil, emailsPropTypeUtil, evaluateTerm, extractValue, filterEmptyValues, filterPropTypeUtil, flexPropTypeUtil, getPropSchemaFromCache, gradientColorStopPropTypeUtil, gridTrackSizePropTypeUtil, htmlPropTypeUtil, htmlV2PropTypeUtil, htmlV3PropTypeUtil, hueRotateFilterPropTypeUtil, imageAttachmentIdPropType, imagePropTypeUtil, imageSrcPropTypeUtil, intensityFilterPropTypeUtil, isDependency, isDependencyMet, isEmpty, isOverridable, isTransformable, keyValuePropTypeUtil, layoutDirectionPropTypeUtil, linkPropTypeUtil, mergeProps, moveTransformPropTypeUtil, numberPropTypeUtil, numberRangePropTypeUtil, parseHtmlChildren, perspectiveOriginPropTypeUtil, positionPropTypeUtil, queryFilterArrayPropTypeUtil, queryFilterPropTypeUtil, queryPropTypeUtil, rewrapOverridableValue, rotateTransformPropTypeUtil, scaleTransformPropTypeUtil, selectionSizePropTypeUtil, shadowPropTypeUtil, sizePropTypeUtil, skewTransformPropTypeUtil, spanPropTypeUtil, stringArrayPropTypeUtil, stringPropTypeUtil, strokePropTypeUtil, svgSrcPropTypeUtil, timeRangePropTypeUtil, timeStringPropTypeUtil, transformFunctionsPropTypeUtil, transformOriginPropTypeUtil, transformPropTypeUtil, urlPropTypeUtil, videoAttachmentIdPropType, videoSrcPropTypeUtil };

package/dist/index.js

@@ -988,7 +988,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) {
@@ -999,11 +1005,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);
   }
@@ -1044,16 +1050,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;
@@ -1064,7 +1077,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 = {
@@ -1084,7 +1124,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);
     }
@@ -1101,13 +1141,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: {
@@ -1121,9 +1161,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)) {
@@ -1472,7 +1509,8 @@ var Schema = {
   configurableKeys,
   validatePropValue,
   enrichWithIntention,
-  removeIntention
+  removeIntention,
+  setDynamicTagNamesResolver
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {