@contentful/experiences-core 3.7.2-dev-20250924T1504-b27c71e.0 → 3.8.0-beta.0

package/dist/entity/EntityStore.d.ts

@@ -30,6 +30,11 @@ declare class EntityStore extends EntityStoreBase {
     }>;
     get hoistedParameterDefinitions(): Record<string, {
         contentTypes: string[];
+        passToNodes: {
+            prebindingId: string;
+            parameterId: string;
+            nodeId: string;
+        }[];
         defaultSource?: {
             type: "Entry";
             contentTypeId: string;
@@ -41,11 +46,6 @@ declare class EntityStore extends EntityStoreBase {
                 };
             };
         } | undefined;
-        passToNodes?: {
-            prebindingId: string;
-            parameterId: string;
-            nodeId: string;
-        }[] | undefined;
     }>;
     get experienceEntryFields(): ExperienceFields | undefined;
     get experienceEntryId(): string | undefined;

package/dist/index.cjs

@@ -183,7 +183,6 @@ const builtInStyles = {
         },
         type: 'Text',
         group: 'style',
-        description: 'The vertical alignment of the section',
         defaultValue: 'center',
         displayName: 'Vertical alignment',
     },
@@ -210,7 +209,6 @@ const builtInStyles = {
         },
         type: 'Text',
         group: 'style',
-        description: 'The horizontal alignment of the section',
         defaultValue: 'center',
         displayName: 'Horizontal alignment',
     },
@@ -219,83 +217,71 @@ const builtInStyles = {
         type: 'Boolean',
         group: 'style',
         defaultValue: true,
-        description: 'The visibility of the component',
     },
     cfMargin: {
         displayName: 'Margin',
         type: 'Text',
         group: 'style',
-        description: 'The margin of the section',
         defaultValue: '0 0 0 0',
     },
     cfPadding: {
         displayName: 'Padding',
         type: 'Text',
         group: 'style',
-        description: 'The padding of the section',
         defaultValue: '0 0 0 0',
     },
     cfBackgroundColor: {
         displayName: 'Background color',
         type: 'Text',
         group: 'style',
-        description: 'The background color of the section',
         defaultValue: 'rgba(0, 0, 0, 0)',
     },
     cfWidth: {
         displayName: 'Width',
         type: 'Text',
         group: 'style',
-        description: 'The width of the section',
         defaultValue: '100%',
     },
     cfHeight: {
         displayName: 'Height',
         type: 'Text',
         group: 'style',
-        description: 'The height of the section',
         defaultValue: 'fit-content',
     },
     cfMaxWidth: {
         displayName: 'Max width',
         type: 'Text',
         group: 'style',
-        description: 'The max-width of the section',
         defaultValue: 'none',
     },
     cfFlexDirection: {
         displayName: 'Direction',
         type: 'Text',
         group: 'style',
-        description: 'The orientation of the section',
         defaultValue: 'column',
     },
     cfFlexReverse: {
         displayName: 'Reverse Direction',
         type: 'Boolean',
         group: 'style',
-        description: 'Toggle the flex direction to be reversed',
         defaultValue: false,
     },
     cfFlexWrap: {
         displayName: 'Wrap objects',
         type: 'Text',
         group: 'style',
-        description: 'Wrap objects',
         defaultValue: 'nowrap',
     },
     cfBorder: {
         displayName: 'Border',
         type: 'Text',
         group: 'style',
-        description: 'The border of the section',
         defaultValue: '0px solid rgba(0, 0, 0, 0)',
     },
     cfGap: {
         displayName: 'Gap',
         type: 'Text',
         group: 'style',
-        description: 'The spacing between the elements of the section',
         defaultValue: '0px',
     },
     cfHyperlink: {
@@ -306,7 +292,6 @@ const builtInStyles = {
             format: 'URL',
             bindingSourceType: ['entry', 'experience', 'manual'],
         },
-        description: 'hyperlink for section or container',
     },
     cfOpenInNewTab: {
         displayName: 'URL behaviour',
@@ -320,7 +305,6 @@ const optionalBuiltInStyles = {
         displayName: 'Font Size',
         type: 'Text',
         group: 'style',
-        description: 'The font size of the element',
         defaultValue: '16px',
     },
     cfFontWeight: {
@@ -343,13 +327,11 @@ const optionalBuiltInStyles = {
         displayName: 'Font Weight',
         type: 'Text',
         group: 'style',
-        description: 'The font weight of the element',
         defaultValue: '400',
     },
     cfImageAsset: {
         displayName: 'Image',
         type: 'Media',
-        description: 'Image to display',
         validations: {
             bindingSourceType: ['asset', 'entry', 'manual'],
         },
@@ -368,13 +350,11 @@ const optionalBuiltInStyles = {
         displayName: 'Background color',
         type: 'Text',
         group: 'style',
-        description: 'The background color of the element',
         defaultValue: 'rgba(0, 0, 0, 0)',
     },
     cfBackgroundImageUrl: {
         displayName: 'Background image',
         type: 'Media',
-        description: 'Background image for component',
         validations: {
             bindingSourceType: ['asset', 'entry', 'manual'],
         },
@@ -393,28 +373,24 @@ const optionalBuiltInStyles = {
         displayName: 'Border Radius',
         type: 'Text',
         group: 'style',
-        description: 'The border radius of the section',
         defaultValue: '0px',
     },
     cfLineHeight: {
         displayName: 'Line Height',
         type: 'Text',
         group: 'style',
-        description: 'The line height of the element',
         defaultValue: '20px',
     },
     cfLetterSpacing: {
         displayName: 'Letter Spacing',
         type: 'Text',
         group: 'style',
-        description: 'The letter spacing of the element',
         defaultValue: '0px',
     },
     cfTextColor: {
         displayName: 'Text Color',
         type: 'Text',
         group: 'style',
-        description: 'The text color of the element',
         defaultValue: 'rgba(0, 0, 0, 1)',
     },
     cfTextAlign: {
@@ -437,7 +413,6 @@ const optionalBuiltInStyles = {
         displayName: 'Text Align',
         type: 'Text',
         group: 'style',
-        description: 'The text alignment of the element',
         defaultValue: 'start',
     },
     cfTextTransform: {
@@ -464,28 +439,24 @@ const optionalBuiltInStyles = {
         displayName: 'Text Transform',
         type: 'Text',
         group: 'style',
-        description: 'The text transform of the element',
         defaultValue: 'none',
     },
     cfTextBold: {
         displayName: 'Bold',
         type: 'Boolean',
         group: 'style',
-        description: 'The text bold of the element',
         defaultValue: false,
     },
     cfTextItalic: {
         displayName: 'Italic',
         type: 'Boolean',
         group: 'style',
-        description: 'The text italic of the element',
         defaultValue: false,
     },
     cfTextUnderline: {
         displayName: 'Underline',
         type: 'Boolean',
         group: 'style',
-        description: 'The text underline of the element',
         defaultValue: false,
     },
 };
@@ -504,7 +475,6 @@ const containerBuiltInStyles = {
         displayName: 'Margin',
         type: 'Text',
         group: 'style',
-        description: 'The margin of the container',
         // Note: The UI overwrites '0 Auto 0 Auto' as the default value for top-level containers
         defaultValue: '0 0 0 0',
     },
@@ -512,7 +482,6 @@ const containerBuiltInStyles = {
         displayName: 'Max Width',
         type: 'Text',
         group: 'style',
-        description: 'The max-width of the section',
         defaultValue: '1192px',
     },
 };
@@ -523,35 +492,30 @@ const dividerBuiltInStyles = {
         displayName: 'Margin',
         type: 'Text',
         group: 'style',
-        description: 'The margin of the divider',
         defaultValue: '20px 0px 20px 0px',
     },
     cfWidth: {
         displayName: 'Width',
         type: 'Text',
         group: 'style',
-        description: 'The width of the divider',
         defaultValue: '100%',
     },
     cfHeight: {
         displayName: 'Height',
         type: 'Text',
         group: 'style',
-        description: 'The height of the divider',
         defaultValue: '1px',
     },
     cfMaxWidth: {
         displayName: 'Max width',
         type: 'Text',
         group: 'style',
-        description: 'The max-width of the divider',
         defaultValue: 'none',
     },
     cfBackgroundColor: {
         displayName: 'Background color',
         type: 'Text',
         group: 'style',
-        description: 'The background color of the divider',
         defaultValue: 'rgba(204, 204, 204, 1)',
     },
 };
@@ -584,7 +548,6 @@ const singleColumnBuiltInStyles = {
         },
         type: 'Text',
         group: 'style',
-        description: 'The vertical alignment of the column',
         defaultValue: 'center',
         displayName: 'Vertical alignment',
     },
@@ -611,7 +574,6 @@ const singleColumnBuiltInStyles = {
         },
         type: 'Text',
         group: 'style',
-        description: 'The horizontal alignment of the column',
         defaultValue: 'center',
         displayName: 'Horizontal alignment',
     },
@@ -619,35 +581,30 @@ const singleColumnBuiltInStyles = {
         displayName: 'Padding',
         type: 'Text',
         group: 'style',
-        description: 'The padding of the column',
         defaultValue: '0 0 0 0',
     },
     cfFlexDirection: {
         displayName: 'Direction',
         type: 'Text',
         group: 'style',
-        description: 'The orientation of the column',
         defaultValue: 'column',
     },
     cfFlexWrap: {
         displayName: 'Wrap objects',
         type: 'Text',
         group: 'style',
-        description: 'Wrap objects',
         defaultValue: 'nowrap',
     },
     cfBorder: {
         displayName: 'Border',
         type: 'Text',
         group: 'style',
-        description: 'The border of the column',
         defaultValue: '0px solid rgba(0, 0, 0, 0)',
     },
     cfGap: {
         displayName: 'Gap',
         type: 'Text',
         group: 'style',
-        description: 'The spacing between the elements of the column',
         defaultValue: '0px',
     },
     cfColumnSpan: {
@@ -671,7 +628,6 @@ const columnsBuiltInStyles = {
         displayName: 'Margin',
         type: 'Text',
         group: 'style',
-        description: 'The margin of the columns',
         // Note: The UI overwrites '0 Auto 0 Auto' as the default value for top-level columns
         defaultValue: '0 0 0 0',
     },
@@ -679,35 +635,30 @@ const columnsBuiltInStyles = {
         displayName: 'Width',
         type: 'Text',
         group: 'style',
-        description: 'The width of the columns',
         defaultValue: '100%',
     },
     cfMaxWidth: {
         displayName: 'Max width',
         type: 'Text',
         group: 'style',
-        description: 'The max-width of the columns',
         defaultValue: '1192px',
     },
     cfPadding: {
         displayName: 'Padding',
         type: 'Text',
         group: 'style',
-        description: 'The padding of the columns',
         defaultValue: '10px 10px 10px 10px',
     },
     cfBorder: {
         displayName: 'Border',
         type: 'Text',
         group: 'style',
-        description: 'The border of the columns',
         defaultValue: '0px solid rgba(0, 0, 0, 0)',
     },
     cfGap: {
         displayName: 'Gap',
         type: 'Text',
         group: 'style',
-        description: 'The spacing between the elements of the columns',
         defaultValue: '10px 10px',
     },
     cfColumns: {
@@ -1000,7 +951,7 @@ const BREAKPOINT_QUERY_REGEX = /^\*$|^[<>][0-9]+px$/;
 const BreakpointSchema = zod.z
     .object({
     id: propertyKeySchema,
-    // Can be replace with z.templateLiteral when upgrading to zod v4
+    // Can be replaced with z.templateLiteral when upgrading to zod v4
     query: zod.z.string().refine((s) => BREAKPOINT_QUERY_REGEX.test(s)),
     previewSize: zod.z.string().optional(),
     displayName: zod.z.string(),
@@ -1141,8 +1092,7 @@ const ParameterDefinitionSchema = zod.z.object({
     contentTypes: zod.z.array(zod.z.string()).min(1),
     passToNodes: zod.z
         .array(PassToNodeSchema)
-        .max(1, 'At most one "passToNodes" element is allowed per parameter definition.')
-        .optional(), // we might change this to be empty array for native parameter definitions, that's why we don't use .length(1)
+        .max(1, 'At most one "passToNodes" element is allowed per parameter definition.'),
 });
 const ParameterDefinitionsSchema = zod.z.record(propertyKeySchema, ParameterDefinitionSchema);
 const VariableMappingsSchema = zod.z.record(propertyKeySchema, VariableMappingSchema);
@@ -1244,7 +1194,7 @@ const validatePassToNodes = (rootChildren, componentSettings, ctx) => {
         return;
     }
     const { parameterDefinitions } = componentSettings.prebindingDefinitions[0];
-    let nodeIds = new Set();
+    const nodeIds = new Set();
     for (const paramDef of Object.values(parameterDefinitions || {})) {
         paramDef.passToNodes?.forEach((n) => nodeIds.add(n.nodeId));
     }
@@ -2268,7 +2218,7 @@ const transformTextAlign = (value) => {
         return undefined;
     const sdkOptions = getSdkOptions();
     // New behavior: translate left/right to start/end
-    // Customer can opt-out by activating this global option toggle
+    // Customer can opt out by activating this global option toggle
     if (!sdkOptions.__disableTextAlignmentTransform) {
         if (value === 'left')
             return 'start';
@@ -3720,7 +3670,7 @@ const extractPrebindingDataByPatternId = (patterns) => {
         const [prebindingDefinition] = pattern.fields.componentSettings?.prebindingDefinitions ?? [];
         if (!prebindingDefinition)
             continue;
-        const [nativeParameterId] = Object.entries(prebindingDefinition.parameterDefinitions ?? {}).find(([, value]) => value.passToNodes === undefined) ?? [];
+        const [nativeParameterId] = Object.entries(prebindingDefinition.parameterDefinitions ?? {}).find(([, value]) => !value.passToNodes?.length) ?? [];
         const prebindingData = {
             prebindingDefinitionId: prebindingDefinition.id,
             parameterIds: Object.keys(prebindingDefinition.parameterDefinitions),
@@ -3768,7 +3718,7 @@ function getTargetPatternMappingsForParameter({ fetchedPatterns, prebindingDataB
         }
         else {
             const parameterDefinition = patternPrebindingData.parameterDefinitions[parameterId];
-            if (!parameterDefinition || !parameterDefinition.passToNodes)
+            if (!parameterDefinition || !parameterDefinition.passToNodes?.length)
                 return undefined;
             const patternEntry = fetchedPatterns.find((entry) => entry.sys.id === patternNodeDefinitionId);
             if (!patternEntry)
@@ -3779,7 +3729,7 @@ function getTargetPatternMappingsForParameter({ fetchedPatterns, prebindingDataB
                 parameters: {},
                 children: patternEntry.fields.componentTree.children,
             }, (node) => {
-                if (node.id === parameterDefinition.passToNodes?.[0].nodeId) {
+                if (node.id === parameterDefinition.passToNodes?.[0]?.nodeId) {
                     nestedPatternNode = node;
                 }
                 return undefined;
@@ -3791,7 +3741,7 @@ function getTargetPatternMappingsForParameter({ fetchedPatterns, prebindingDataB
                 fetchedPatterns,
                 prebindingDataByPatternId,
                 patternNodeDefinitionId: nestedPatternNode.definitionId,
-                parameterId: parameterDefinition.passToNodes?.[0].parameterId,
+                parameterId: parameterDefinition.passToNodes?.[0]?.parameterId,
             });
         }
     }