@contentful/experiences-sdk-react 3.8.0-dev-20250926T1559-e1ab24d.0 → 3.8.0-prerelease-20250926T1312-a8b5fb7.0

package/dist/src/core/preview/assemblyUtils.d.ts

@@ -1,26 +1,17 @@
 import { EntityStore } from '@contentful/experiences-core';
 import type { ComponentTreeNode, ExperienceComponentSettings, Parameter } from '@contentful/experiences-core/types';
-type ComponentTreeNodeWithPatternInformation = ComponentTreeNode & {
-    pattern?: {
-        parentPatternNodeId: string;
-        nodeIdOnPattern: string;
-        prefixedNodeId: string;
-    };
-};
 /** While unfolding the pattern definition on the instance, this function will replace all
  * ComponentValue in the definitions tree with the actual value on the instance. */
-export declare const deserializePatternNode: ({ node, rootPatternVariables, componentSettings, entityStore, rootPatternParameters, parentPatternRootNodeIdsChain, }: {
+export declare const deserializePatternNode: ({ node, componentInstanceVariables, componentSettings, parameters, entityStore, }: {
     node: ComponentTreeNode;
-    rootPatternVariables: ComponentTreeNode["variables"];
+    componentInstanceVariables: ComponentTreeNode["variables"];
     componentSettings: ExperienceComponentSettings;
+    parameters: Record<string, Parameter>;
     entityStore: EntityStore;
-    rootPatternParameters: Record<string, Parameter>;
-    parentPatternRootNodeIdsChain: string[];
-}) => ComponentTreeNodeWithPatternInformation;
-export declare const resolvePattern: ({ node, entityStore, parentPatternRootNodeIdsChain, rootPatternParameters, }: {
+}) => ComponentTreeNode;
+export declare const resolvePattern: ({ node, parentParameters, patternRootNodeIdsChain, entityStore, }: {
     node: ComponentTreeNode;
     entityStore: EntityStore;
-    parentPatternRootNodeIdsChain: string[];
-    rootPatternParameters: Record<string, Parameter>;
-}) => ComponentTreeNodeWithPatternInformation;
-export {};
+    parentParameters: Record<string, Parameter>;
+    patternRootNodeIdsChain: string;
+}) => ComponentTreeNode;

package/dist/src/core/styles/createStylesheetsForBuiltInStyles.d.ts

@@ -20,5 +20,5 @@ export declare const createStylesheetsForBuiltInStyles: ({ designPropertiesByBre
     designPropertiesByBreakpoint: Record<string, Record<string, PrimitiveValue>>;
     breakpoints: Breakpoint[];
     node: ComponentTreeNode;
-    patternRootNodeIdsChain?: Array<string>;
+    patternRootNodeIdsChain?: string;
 }) => ResolvedStylesheetData;

package/dist/src/sdkVersion.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "3.8.0-dev-20250926T1559-e1ab24d.0";
+export declare const SDK_VERSION = "3.8.0-prerelease-20250926T1312-a8b5fb7.0";

package/dist/src/utils/parseComponentProps.d.ts

@@ -15,11 +15,11 @@ type ResolveBoundValueType = (data: {
     dataType: ComponentDefinitionVariableType;
     binding: BoundValue;
 }) => BoundComponentPropertyTypes;
-export declare const parseComponentProps: ({ breakpoints, componentDefinition, patternRootNodeIdsChain, node, resolveDesignValue, resolveBoundValue, resolveHyperlinkValue, resolveUnboundValue, resolveComponentValue, }: {
+export declare const parseComponentProps: ({ breakpoints, componentDefinition, patternRootNodeIdsChain, node, resolveDesignValue, resolveBoundValue, resolveHyperlinkValue, resolveUnboundValue, resolvePrebindingValue, }: {
     breakpoints: Breakpoint[];
     mainBreakpoint: Breakpoint;
     componentDefinition: ComponentDefinition;
-    patternRootNodeIdsChain: Array<string>;
+    patternRootNodeIdsChain?: string;
     node: ComponentTreeNode;
     resolveDesignValue: ResolveDesignValueType;
     resolveBoundValue: ResolveBoundValueType;
@@ -30,13 +30,7 @@ export declare const parseComponentProps: ({ breakpoints, componentDefinition, p
         mappingKey: string;
         defaultValue: ComponentDefinitionVariable["defaultValue"];
     }) => PrimitiveValue;
-    /**
-     * This method will be called to resolve the values for components that are native (not from nested pattern) to the previewed pattern
-     * Nested pattern's components are going to be resolved by the `resolvePattern` method from `assemblyUtils` file
-     * @param data
-     * @returns
-     */
-    resolveComponentValue: (data: {
+    resolvePrebindingValue: (data: {
         propertyName: string;
         mappingKey: string;
         dataType: ComponentDefinitionVariableType;

package/dist/src/utils/prebindingUtils.d.ts

@@ -1,20 +1,17 @@
 import { type EntityStore } from '@contentful/experiences-core';
 import { ExperienceComponentSettings, Parameter } from '@contentful/experiences-validators';
-export declare const shouldUsePrebinding: ({ componentValueKey, componentSettings, parameters, patternRootNodeIdsChain, }: {
+export declare const shouldUsePrebinding: ({ componentValueKey, componentSettings, parameters, }: {
     componentValueKey: string;
     componentSettings: ExperienceComponentSettings;
     parameters: Record<string, Parameter>;
-    patternRootNodeIdsChain: string[];
 }) => boolean;
-export declare const resolvePrebindingPath: ({ componentValueKey, componentSettings, parameters, entityStore, patternRootNodeIdsChain, }: {
+export declare const resolvePrebindingPath: ({ componentValueKey, componentSettings, parameters, entityStore, }: {
     componentValueKey: string;
     componentSettings: ExperienceComponentSettings;
     parameters: Record<string, Parameter>;
     entityStore: EntityStore;
-    patternRootNodeIdsChain: string[];
 }) => string;
-export declare const resolveMaybePrebindingDefaultValuePath: ({ componentValueKey, patternRootNodeIdsChain, entityStore, }: {
+export declare const resolveMaybePrebindingDefaultValuePath: ({ componentValueKey, entityStore, }: {
     componentValueKey: string;
-    patternRootNodeIdsChain: string[];
     entityStore: EntityStore;
 }) => string | undefined;

package/dist/test/__fixtures__/assembly.d.ts

@@ -1,5 +1,4 @@
-import type { ComponentTreeNode, ExperienceComponentSettings, ExperienceEntry, ExperienceTreeNode, SchemaVersions } from '@contentful/experiences-core/types';
-import { ExperienceComponentTree } from '@contentful/experiences-validators';
+import type { ComponentTreeNode, ExperienceEntry, ExperienceTreeNode, SchemaVersions } from '@contentful/experiences-core/types';
 type createAssemblyEntryArgs = {
     schemaVersion?: SchemaVersions;
     id?: string;
@@ -7,13 +6,11 @@ type createAssemblyEntryArgs = {
         entry: ExperienceEntry;
         node: ComponentTreeNode;
     }>;
-    prebindingDefinitions?: ExperienceComponentSettings['prebindingDefinitions'];
-    componentTreeChildren?: ExperienceComponentTree['children'];
 };
 export declare const defaultAssemblyId = "assembly-id";
 export declare const assemblyGeneratedVariableName = "text_uuid1Assembly";
 export declare const assemblyGeneratedDesignVariableName = "cfWidth_uuid2Assembly";
-export declare const createAssemblyEntry: ({ schemaVersion, id, nestedPatterns, prebindingDefinitions, componentTreeChildren, }?: createAssemblyEntryArgs) => ExperienceEntry;
+export declare const createAssemblyEntry: ({ schemaVersion, id, nestedPatterns, }?: createAssemblyEntryArgs) => ExperienceEntry;
 type createAssemblyNodeArgs = {
     id: string;
     blockId?: string;

package/dist/utils/parseComponentProps.js

@@ -15,7 +15,7 @@ import { createStylesheetsForBuiltInStyles } from '../core/styles/createStyleshe
 const isSpecialCaseCssProp = (propName) => {
     return propName === 'cfBackgroundImageUrl' || propName.startsWith('cfBackgroundImageUrl_');
 };
-const parseComponentProps = ({ breakpoints, componentDefinition, patternRootNodeIdsChain, node, resolveDesignValue, resolveBoundValue, resolveHyperlinkValue, resolveUnboundValue, resolveComponentValue, }) => {
+const parseComponentProps = ({ breakpoints, componentDefinition, patternRootNodeIdsChain, node, resolveDesignValue, resolveBoundValue, resolveHyperlinkValue, resolveUnboundValue, resolvePrebindingValue, }) => {
     const styleProps = {};
     const customDesignProps = {};
     const contentProps = {};
@@ -85,7 +85,7 @@ const parseComponentProps = ({ breakpoints, componentDefinition, patternRootNode
             case 'ComponentValue': {
                 // This can either be a design (style) or a content property.
                 // Where prebinding is used, we resolve like they are a BoundValue.
-                const propValue = resolveComponentValue({
+                const propValue = resolvePrebindingValue({
                     propertyName: propName,
                     mappingKey: propertyValue.key,
                     dataType: propDefinition.type,

package/dist/utils/parseComponentProps.js.map

@@ -1 +1 @@
-{"version":3,"file":"parseComponentProps.js","sources":["../../../src/utils/parseComponentProps.ts"],"sourcesContent":["import { isCfStyleAttribute, debug } from '@contentful/experiences-core';\nimport {\n  BoundComponentPropertyTypes,\n  BoundValue,\n  Breakpoint,\n  ComponentDefinition,\n  ComponentDefinitionVariable,\n  ComponentDefinitionVariableType,\n  ComponentTreeNode,\n  DesignValue,\n  PrimitiveValue,\n  ResolveDesignValueType,\n} from '@contentful/experiences-core/types';\nimport { convertResolvedDesignValuesToMediaQuery } from '../core/styles/convertResolvedDesignValuesToMediaQuery';\nimport { createStylesheetsForBuiltInStyles } from '../core/styles/createStylesheetsForBuiltInStyles';\n\n// TODO: Test this for nested patterns as the name might be just a random hash without the actual name (needs to be validated).\n/**\n * Checks if prop is a \"siamese\" prop. So far we have only one such prop: `cfBackgroundImageUrl`.\n * It is considered \"siamese\" because despite being a content variable, it always goes in pair\n * (is coupled) with the `cfBackgroundImageOptions` design variable. Without presence of the\n * `cfBackgroundImageUrl` the `cfBackgroundImageOptions` is useless (and is not going to be\n * rendered by the styleTransformers.ts#transformBackgroundImageUrl()).\n *\n * Because of this coupling, we need to create an \"ephemeral\" cfBackgroundImageUrl style(!) prop.\n */\nconst isSpecialCaseCssProp = (propName: string) => {\n  return propName === 'cfBackgroundImageUrl' || propName.startsWith('cfBackgroundImageUrl_');\n};\n\n/**\n * The previous logic of prop mapping was too complex and mixed different ues cases together.\n * In this function, I aim to simplify the logic by focusing on the following specific cases FOR PREVIEW/DELIVERY MODES\n * 1) Any non `DesignValue` props should be resolved and returned as is\n * 2) Some exceptions like `cfImageAsset` and `cfBackgroundImageUrl` (BoundValue) should be handled separately\n * and be resolved for the default breakpoint only (cause we don't allow binding per breakpoint anyway)\n * 3) Those DesignValue props which can be converted to CSS should be grouped and resolved into a CSS media query\n * for each breakpoint\n * 4) Those DesignValue props which can NOT be converted to CSS (custom design props) should be resolved dynamically\n * for each breakpoint\n */\ntype ResolveBoundValueType = (data: {\n  propertyName: string;\n  dataType: ComponentDefinitionVariableType;\n  binding: BoundValue;\n}) => BoundComponentPropertyTypes;\n\nexport const parseComponentProps = ({\n  breakpoints,\n  componentDefinition,\n  patternRootNodeIdsChain,\n  node,\n  resolveDesignValue,\n  resolveBoundValue,\n  resolveHyperlinkValue,\n  resolveUnboundValue,\n  resolveComponentValue,\n}: {\n  breakpoints: Breakpoint[];\n  mainBreakpoint: Breakpoint;\n  componentDefinition: ComponentDefinition;\n  patternRootNodeIdsChain: Array<string>;\n  node: ComponentTreeNode;\n  resolveDesignValue: ResolveDesignValueType;\n  resolveBoundValue: ResolveBoundValueType;\n  resolveHyperlinkValue: (data: { linkTargetKey: string }) => string | null;\n  resolveUnboundValue: (data: {\n    mappingKey: string;\n    defaultValue: ComponentDefinitionVariable['defaultValue'];\n  }) => PrimitiveValue;\n  /**\n   * This method will be called to resolve the values for components that are native (not from nested pattern) to the previewed pattern\n   * Nested pattern's components are going to be resolved by the `resolvePattern` method from `assemblyUtils` file\n   * @param data\n   * @returns\n   */\n  resolveComponentValue: (data: {\n    propertyName: string;\n    mappingKey: string;\n    dataType: ComponentDefinitionVariableType;\n    resolveBoundValue: ResolveBoundValueType;\n  }) => PrimitiveValue;\n}) => {\n  const styleProps: Record<string, DesignValue['valuesByBreakpoint']> = {};\n  const customDesignProps: Record<string, PrimitiveValue> = {};\n  const contentProps: Record<string, PrimitiveValue> = {};\n\n  debug.log(\n    '[experiences-sdk-react::parseComponentProps] Parsing component props for node with id: ',\n    node.id,\n  );\n\n  for (const [propName, propDefinition] of Object.entries(componentDefinition.variables)) {\n    const propertyValue = node.variables[propName];\n    if (!propertyValue) continue;\n\n    switch (propertyValue.type) {\n      case 'DesignValue': {\n        if (isCfStyleAttribute(propName)) {\n          // for such properties we know how to convert them to CSS, so we will build a media query from it below after the loop is over\n          styleProps[propName] = propertyValue.valuesByBreakpoint;\n        } else {\n          // for custom design props, the value will be resolved with the javascript per breakpoint at runtime\n          customDesignProps[propName] = resolveDesignValue(propertyValue.valuesByBreakpoint);\n        }\n        break;\n      }\n      case 'BoundValue': {\n        const boundValue = resolveBoundValue({\n          propertyName: propName,\n          dataType: propDefinition.type as ComponentDefinitionVariableType,\n          binding: propertyValue,\n        });\n\n        const propValue = boundValue ?? propDefinition.defaultValue;\n\n        if (isSpecialCaseCssProp(propName)) {\n          // styleProps[propName] = { [mainBreakpoint.id]: propValue };\n          // Here we create kind of \"fake\" style property out of a bound value.\n          // As bound values are breakpoint-universal (they apply to all breakpoints),\n          // but styleProps are breakpoint-specific, we need to ensure that\n          // semantically our \"fake\" emphemeral style property will be universall as well,\n          // by expanding it to all the breakpoints. This is important as\n          // styleTransformers.ts#transformBackgroundImageUrl() expects\n          // cfBackgroundImageUrl to be present for all breakpoints\n          // where cfBackgroundImageOptions is present.\n          styleProps[propName] = Object.fromEntries(breakpoints.map((b) => [b.id, propValue]));\n        } else {\n          contentProps[propName] = propValue;\n        }\n        break;\n      }\n\n      case 'HyperlinkValue': {\n        const hyperlink = resolveHyperlinkValue({\n          linkTargetKey: propertyValue.linkTargetKey,\n        });\n        if (hyperlink) {\n          contentProps[propName] = hyperlink;\n        }\n        break;\n      }\n      case 'UnboundValue': {\n        const unboundValue = resolveUnboundValue({\n          mappingKey: propertyValue.key,\n          defaultValue: propDefinition.defaultValue,\n        });\n\n        if (isSpecialCaseCssProp(propName)) {\n          styleProps[propName] = Object.fromEntries(breakpoints.map((b) => [b.id, unboundValue]));\n        } else {\n          contentProps[propName] = unboundValue;\n        }\n        break;\n      }\n      case 'ComponentValue': {\n        // This can either be a design (style) or a content property.\n        // Where prebinding is used, we resolve like they are a BoundValue.\n        const propValue =\n          resolveComponentValue({\n            propertyName: propName,\n            mappingKey: propertyValue.key,\n            dataType: propDefinition.type,\n            resolveBoundValue,\n          }) ?? propDefinition.defaultValue;\n\n        if (isSpecialCaseCssProp(propName)) {\n          styleProps[propName] = Object.fromEntries(breakpoints.map((b) => [b.id, propValue]));\n        } else {\n          contentProps[propName] = propValue;\n        }\n        break;\n      }\n      default:\n        break;\n    }\n  }\n  /* [Data Format] After resolving all properties, `styleProps` contains solely the plain design values\n   * styleProps = {\n   *   cfMargin: { desktop: '42px', tablet: '13px' },\n   *   cfBackgroundColor: { desktop: 'rgba(246, 246, 246, 1)' },\n   *   cfBackgroundImage: { desktop: 'url(https://example.com/image.jpg)' }\n   * }\n   */\n\n  const stylePropsIndexedByBreakpoint = Object.entries(styleProps).reduce<\n    Record<string, Record<string, PrimitiveValue>>\n  >((acc, [propName, valuesByBreakpoint]) => {\n    for (const [breakpointId, value] of Object.entries(valuesByBreakpoint)) {\n      if (!acc[breakpointId]) {\n        acc[breakpointId] = {};\n      }\n\n      acc[breakpointId][propName] = value;\n    }\n\n    return acc;\n  }, {});\n  /* [Data Format] `stylePropsIndexedByBreakpoint` contains the plain design values grouped by breakpoint\n   * stylePropsIndexedByBreakpoint = {\n   *   desktop: {\n   *     cfMargin: '42px',\n   *     cfBackgroundColor: 'rgba(246, 246, 246, 1)',\n   *     cfBackgroundImage: 'url(https://example.com/image.jpg)'\n   *   },\n   *   tablet: {\n   *     cfMargin: '13px'\n   *   }\n   * }\n   */\n\n  const stylesheetData = createStylesheetsForBuiltInStyles({\n    designPropertiesByBreakpoint: stylePropsIndexedByBreakpoint,\n    breakpoints,\n    node,\n    patternRootNodeIdsChain,\n  });\n  /* [Data Format] Stylesheet data provides objects containing `className`, `breakpointCondition`, and `css`.\n   * stylesheetData = [{\n   *    className: 'uniqueMD5Hash',\n   *    breakpointCondition: '<768px',\n   *    css: 'margin:13px;'\n   *    visibilityCss: 'display:none !important;'\n   *  }, ...]\n   */\n  const mediaQuery = convertResolvedDesignValuesToMediaQuery(stylesheetData);\n  /* [Data Format] `mediaQuery` is a joined string of all media query CSS code\n   * mediaQuery = \".cfstyles-123{margin:42px;}@media(max-width:768px){.cfstyles-456{margin:13px;}}\"\n   */\n  return {\n    styleProps,\n    mediaQuery,\n    customDesignProps,\n    contentProps,\n  };\n};\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"parseComponentProps.js","sources":["../../../src/utils/parseComponentProps.ts"],"sourcesContent":["import { isCfStyleAttribute, debug } from '@contentful/experiences-core';\nimport {\n  BoundComponentPropertyTypes,\n  BoundValue,\n  Breakpoint,\n  ComponentDefinition,\n  ComponentDefinitionVariable,\n  ComponentDefinitionVariableType,\n  ComponentTreeNode,\n  DesignValue,\n  PrimitiveValue,\n  ResolveDesignValueType,\n} from '@contentful/experiences-core/types';\nimport { convertResolvedDesignValuesToMediaQuery } from '../core/styles/convertResolvedDesignValuesToMediaQuery';\nimport { createStylesheetsForBuiltInStyles } from '../core/styles/createStylesheetsForBuiltInStyles';\n\n// TODO: Test this for nested patterns as the name might be just a random hash without the actual name (needs to be validated).\n/**\n * Checks if prop is a \"siamese\" prop. So far we have only one such prop: `cfBackgroundImageUrl`.\n * It is considered \"siamese\" because despite being a content variable, it always goes in pair\n * (is coupled) with the `cfBackgroundImageOptions` design variable. Without presence of the\n * `cfBackgroundImageUrl` the `cfBackgroundImageOptions` is useless (and is not going to be\n * rendered by the styleTransformers.ts#transformBackgroundImageUrl()).\n *\n * Because of this coupling, we need to create an \"ephemeral\" cfBackgroundImageUrl style(!) prop.\n */\nconst isSpecialCaseCssProp = (propName: string) => {\n  return propName === 'cfBackgroundImageUrl' || propName.startsWith('cfBackgroundImageUrl_');\n};\n\n/**\n * The previous logic of prop mapping was too complex and mixed different ues cases together.\n * In this function, I aim to simplify the logic by focusing on the following specific cases FOR PREVIEW/DELIVERY MODES\n * 1) Any non `DesignValue` props should be resolved and returned as is\n * 2) Some exceptions like `cfImageAsset` and `cfBackgroundImageUrl` (BoundValue) should be handled separately\n * and be resolved for the default breakpoint only (cause we don't allow binding per breakpoint anyway)\n * 3) Those DesignValue props which can be converted to CSS should be grouped and resolved into a CSS media query\n * for each breakpoint\n * 4) Those DesignValue props which can NOT be converted to CSS (custom design props) should be resolved dynamically\n * for each breakpoint\n */\ntype ResolveBoundValueType = (data: {\n  propertyName: string;\n  dataType: ComponentDefinitionVariableType;\n  binding: BoundValue;\n}) => BoundComponentPropertyTypes;\n\nexport const parseComponentProps = ({\n  breakpoints,\n  componentDefinition,\n  patternRootNodeIdsChain,\n  node,\n  resolveDesignValue,\n  resolveBoundValue,\n  resolveHyperlinkValue,\n  resolveUnboundValue,\n  resolvePrebindingValue,\n}: {\n  breakpoints: Breakpoint[];\n  mainBreakpoint: Breakpoint;\n  componentDefinition: ComponentDefinition;\n  patternRootNodeIdsChain?: string;\n  node: ComponentTreeNode;\n  resolveDesignValue: ResolveDesignValueType;\n  resolveBoundValue: ResolveBoundValueType;\n  resolveHyperlinkValue: (data: { linkTargetKey: string }) => string | null;\n  resolveUnboundValue: (data: {\n    mappingKey: string;\n    defaultValue: ComponentDefinitionVariable['defaultValue'];\n  }) => PrimitiveValue;\n  resolvePrebindingValue: (data: {\n    propertyName: string;\n    mappingKey: string;\n    dataType: ComponentDefinitionVariableType;\n    resolveBoundValue: ResolveBoundValueType;\n  }) => PrimitiveValue;\n}) => {\n  const styleProps: Record<string, DesignValue['valuesByBreakpoint']> = {};\n  const customDesignProps: Record<string, PrimitiveValue> = {};\n  const contentProps: Record<string, PrimitiveValue> = {};\n\n  debug.log(\n    '[experiences-sdk-react::parseComponentProps] Parsing component props for node with id: ',\n    node.id,\n  );\n\n  for (const [propName, propDefinition] of Object.entries(componentDefinition.variables)) {\n    const propertyValue = node.variables[propName];\n    if (!propertyValue) continue;\n\n    switch (propertyValue.type) {\n      case 'DesignValue': {\n        if (isCfStyleAttribute(propName)) {\n          // for such properties we know how to convert them to CSS, so we will build a media query from it below after the loop is over\n          styleProps[propName] = propertyValue.valuesByBreakpoint;\n        } else {\n          // for custom design props, the value will be resolved with the javascript per breakpoint at runtime\n          customDesignProps[propName] = resolveDesignValue(propertyValue.valuesByBreakpoint);\n        }\n        break;\n      }\n      case 'BoundValue': {\n        const boundValue = resolveBoundValue({\n          propertyName: propName,\n          dataType: propDefinition.type as ComponentDefinitionVariableType,\n          binding: propertyValue,\n        });\n\n        const propValue = boundValue ?? propDefinition.defaultValue;\n\n        if (isSpecialCaseCssProp(propName)) {\n          // styleProps[propName] = { [mainBreakpoint.id]: propValue };\n          // Here we create kind of \"fake\" style property out of a bound value.\n          // As bound values are breakpoint-universal (they apply to all breakpoints),\n          // but styleProps are breakpoint-specific, we need to ensure that\n          // semantically our \"fake\" emphemeral style property will be universall as well,\n          // by expanding it to all the breakpoints. This is important as\n          // styleTransformers.ts#transformBackgroundImageUrl() expects\n          // cfBackgroundImageUrl to be present for all breakpoints\n          // where cfBackgroundImageOptions is present.\n          styleProps[propName] = Object.fromEntries(breakpoints.map((b) => [b.id, propValue]));\n        } else {\n          contentProps[propName] = propValue;\n        }\n        break;\n      }\n\n      case 'HyperlinkValue': {\n        const hyperlink = resolveHyperlinkValue({\n          linkTargetKey: propertyValue.linkTargetKey,\n        });\n        if (hyperlink) {\n          contentProps[propName] = hyperlink;\n        }\n        break;\n      }\n      case 'UnboundValue': {\n        const unboundValue = resolveUnboundValue({\n          mappingKey: propertyValue.key,\n          defaultValue: propDefinition.defaultValue,\n        });\n\n        if (isSpecialCaseCssProp(propName)) {\n          styleProps[propName] = Object.fromEntries(breakpoints.map((b) => [b.id, unboundValue]));\n        } else {\n          contentProps[propName] = unboundValue;\n        }\n        break;\n      }\n      case 'ComponentValue': {\n        // This can either be a design (style) or a content property.\n        // Where prebinding is used, we resolve like they are a BoundValue.\n        const propValue =\n          resolvePrebindingValue({\n            propertyName: propName,\n            mappingKey: propertyValue.key,\n            dataType: propDefinition.type,\n            resolveBoundValue,\n          }) ?? propDefinition.defaultValue;\n\n        if (isSpecialCaseCssProp(propName)) {\n          styleProps[propName] = Object.fromEntries(breakpoints.map((b) => [b.id, propValue]));\n        } else {\n          contentProps[propName] = propValue;\n        }\n        break;\n      }\n      default:\n        break;\n    }\n  }\n  /* [Data Format] After resolving all properties, `styleProps` contains solely the plain design values\n   * styleProps = {\n   *   cfMargin: { desktop: '42px', tablet: '13px' },\n   *   cfBackgroundColor: { desktop: 'rgba(246, 246, 246, 1)' },\n   *   cfBackgroundImage: { desktop: 'url(https://example.com/image.jpg)' }\n   * }\n   */\n\n  const stylePropsIndexedByBreakpoint = Object.entries(styleProps).reduce<\n    Record<string, Record<string, PrimitiveValue>>\n  >((acc, [propName, valuesByBreakpoint]) => {\n    for (const [breakpointId, value] of Object.entries(valuesByBreakpoint)) {\n      if (!acc[breakpointId]) {\n        acc[breakpointId] = {};\n      }\n\n      acc[breakpointId][propName] = value;\n    }\n\n    return acc;\n  }, {});\n  /* [Data Format] `stylePropsIndexedByBreakpoint` contains the plain design values grouped by breakpoint\n   * stylePropsIndexedByBreakpoint = {\n   *   desktop: {\n   *     cfMargin: '42px',\n   *     cfBackgroundColor: 'rgba(246, 246, 246, 1)',\n   *     cfBackgroundImage: 'url(https://example.com/image.jpg)'\n   *   },\n   *   tablet: {\n   *     cfMargin: '13px'\n   *   }\n   * }\n   */\n\n  const stylesheetData = createStylesheetsForBuiltInStyles({\n    designPropertiesByBreakpoint: stylePropsIndexedByBreakpoint,\n    breakpoints,\n    node,\n    patternRootNodeIdsChain,\n  });\n  /* [Data Format] Stylesheet data provides objects containing `className`, `breakpointCondition`, and `css`.\n   * stylesheetData = [{\n   *    className: 'uniqueMD5Hash',\n   *    breakpointCondition: '<768px',\n   *    css: 'margin:13px;'\n   *    visibilityCss: 'display:none !important;'\n   *  }, ...]\n   */\n  const mediaQuery = convertResolvedDesignValuesToMediaQuery(stylesheetData);\n  /* [Data Format] `mediaQuery` is a joined string of all media query CSS code\n   * mediaQuery = \".cfstyles-123{margin:42px;}@media(max-width:768px){.cfstyles-456{margin:13px;}}\"\n   */\n  return {\n    styleProps,\n    mediaQuery,\n    customDesignProps,\n    contentProps,\n  };\n};\n"],"names":[],"mappings":";;;;AAgBA;AACA;;;;;;;;AAQG;AACH,MAAM,oBAAoB,GAAG,CAAC,QAAgB,KAAI;IAChD,OAAO,QAAQ,KAAK,sBAAsB,IAAI,QAAQ,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC;AAC7F,CAAC,CAAC;AAmBW,MAAA,mBAAmB,GAAG,CAAC,EAClC,WAAW,EACX,mBAAmB,EACnB,uBAAuB,EACvB,IAAI,EACJ,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,GAoBvB,KAAI;IACH,MAAM,UAAU,GAAsD,EAAE,CAAC;IACzE,MAAM,iBAAiB,GAAmC,EAAE,CAAC;IAC7D,MAAM,YAAY,GAAmC,EAAE,CAAC;IAExD,KAAK,CAAC,GAAG,CACP,yFAAyF,EACzF,IAAI,CAAC,EAAE,CACR,CAAC;AAEF,IAAA,KAAK,MAAM,CAAC,QAAQ,EAAE,cAAc,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,SAAS,CAAC,EAAE;QACtF,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;AAC/C,QAAA,IAAI,CAAC,aAAa;YAAE,SAAS;AAE7B,QAAA,QAAQ,aAAa,CAAC,IAAI;YACxB,KAAK,aAAa,EAAE;AAClB,gBAAA,IAAI,kBAAkB,CAAC,QAAQ,CAAC,EAAE;;AAEhC,oBAAA,UAAU,CAAC,QAAQ,CAAC,GAAG,aAAa,CAAC,kBAAkB,CAAC;iBACzD;qBAAM;;oBAEL,iBAAiB,CAAC,QAAQ,CAAC,GAAG,kBAAkB,CAAC,aAAa,CAAC,kBAAkB,CAAC,CAAC;iBACpF;gBACD,MAAM;aACP;YACD,KAAK,YAAY,EAAE;gBACjB,MAAM,UAAU,GAAG,iBAAiB,CAAC;AACnC,oBAAA,YAAY,EAAE,QAAQ;oBACtB,QAAQ,EAAE,cAAc,CAAC,IAAuC;AAChE,oBAAA,OAAO,EAAE,aAAa;AACvB,iBAAA,CAAC,CAAC;AAEH,gBAAA,MAAM,SAAS,GAAG,UAAU,IAAI,cAAc,CAAC,YAAY,CAAC;AAE5D,gBAAA,IAAI,oBAAoB,CAAC,QAAQ,CAAC,EAAE;;;;;;;;;;oBAUlC,UAAU,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;iBACtF;qBAAM;AACL,oBAAA,YAAY,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC;iBACpC;gBACD,MAAM;aACP;YAED,KAAK,gBAAgB,EAAE;gBACrB,MAAM,SAAS,GAAG,qBAAqB,CAAC;oBACtC,aAAa,EAAE,aAAa,CAAC,aAAa;AAC3C,iBAAA,CAAC,CAAC;gBACH,IAAI,SAAS,EAAE;AACb,oBAAA,YAAY,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC;iBACpC;gBACD,MAAM;aACP;YACD,KAAK,cAAc,EAAE;gBACnB,MAAM,YAAY,GAAG,mBAAmB,CAAC;oBACvC,UAAU,EAAE,aAAa,CAAC,GAAG;oBAC7B,YAAY,EAAE,cAAc,CAAC,YAAY;AAC1C,iBAAA,CAAC,CAAC;AAEH,gBAAA,IAAI,oBAAoB,CAAC,QAAQ,CAAC,EAAE;oBAClC,UAAU,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;iBACzF;qBAAM;AACL,oBAAA,YAAY,CAAC,QAAQ,CAAC,GAAG,YAAY,CAAC;iBACvC;gBACD,MAAM;aACP;YACD,KAAK,gBAAgB,EAAE;;;gBAGrB,MAAM,SAAS,GACb,sBAAsB,CAAC;AACrB,oBAAA,YAAY,EAAE,QAAQ;oBACtB,UAAU,EAAE,aAAa,CAAC,GAAG;oBAC7B,QAAQ,EAAE,cAAc,CAAC,IAAI;oBAC7B,iBAAiB;AAClB,iBAAA,CAAC,IAAI,cAAc,CAAC,YAAY,CAAC;AAEpC,gBAAA,IAAI,oBAAoB,CAAC,QAAQ,CAAC,EAAE;oBAClC,UAAU,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;iBACtF;qBAAM;AACL,oBAAA,YAAY,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC;iBACpC;gBACD,MAAM;aACP;SAGF;KACF;AACD;;;;;;AAMG;IAEH,MAAM,6BAA6B,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,MAAM,CAErE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,kBAAkB,CAAC,KAAI;AACxC,QAAA,KAAK,MAAM,CAAC,YAAY,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE;AACtE,YAAA,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE;AACtB,gBAAA,GAAG,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC;aACxB;YAED,GAAG,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;SACrC;AAED,QAAA,OAAO,GAAG,CAAC;KACZ,EAAE,EAAE,CAAC,CAAC;AACP;;;;;;;;;;;AAWG;IAEH,MAAM,cAAc,GAAG,iCAAiC,CAAC;AACvD,QAAA,4BAA4B,EAAE,6BAA6B;QAC3D,WAAW;QACX,IAAI;QACJ,uBAAuB;AACxB,KAAA,CAAC,CAAC;AACH;;;;;;;AAOG;AACH,IAAA,MAAM,UAAU,GAAG,uCAAuC,CAAC,cAAc,CAAC,CAAC;AAC3E;;AAEG;IACH,OAAO;QACL,UAAU;QACV,UAAU;QACV,iBAAiB;QACjB,YAAY;KACb,CAAC;AACJ;;;;"}

package/dist/utils/prebindingUtils.js

@@ -1,36 +1,28 @@
 import { isLink } from '@contentful/experiences-core';
-import { PrebindingManager } from '../core/preview/PrebindingManager.js';
+import { SIDELOADED_PREFIX } from '@contentful/experiences-core/constants';
 
-const shouldUsePrebinding = ({ componentValueKey, componentSettings, parameters, patternRootNodeIdsChain, }) => {
+const shouldUsePrebinding = ({ componentValueKey, componentSettings, parameters, }) => {
     const { prebindingDefinitions } = componentSettings;
     const { parameterDefinitions, variableMappings, allowedVariableOverrides } = prebindingDefinitions?.[0] || {};
     const variableMapping = variableMappings?.[componentValueKey];
     const parameterDefinition = parameterDefinitions?.[variableMapping?.parameterId || ''];
-    const patternRootNodeIds = patternRootNodeIdsChain.join('---');
-    const hoistedParameterId = PrebindingManager.getHoistedIdForParameterId(variableMapping?.parameterId || '', patternRootNodeIds);
-    const parameter = parameters?.[hoistedParameterId];
+    const parameter = parameters?.[variableMapping?.parameterId || ''];
     const isValidForPrebinding = !!parameterDefinition &&
         !!parameter &&
         !!variableMapping &&
         !!allowedVariableOverrides &&
         Array.isArray(allowedVariableOverrides);
-    if (!isValidForPrebinding) {
-        return false;
-    }
-    // removed 'NoValue' check
-    const isForDirectBindingOnly = allowedVariableOverrides.includes(componentValueKey);
-    return !isForDirectBindingOnly;
+    const isForDirectBindingOnly = (allowedVariableOverrides) => allowedVariableOverrides.includes(componentValueKey); // removed 'NoValue' check
+    return isValidForPrebinding && !isForDirectBindingOnly(allowedVariableOverrides);
 };
-const resolvePrebindingPath = ({ componentValueKey, componentSettings, parameters, entityStore, patternRootNodeIdsChain, }) => {
+const resolvePrebindingPath = ({ componentValueKey, componentSettings, parameters, entityStore, }) => {
     const prebindingDefinition = componentSettings.prebindingDefinitions?.[0];
     if (!prebindingDefinition)
         return '';
     const variableMapping = prebindingDefinition.variableMappings?.[componentValueKey];
     if (!variableMapping)
         return '';
-    const patternRootNodeIds = patternRootNodeIdsChain.join('---');
-    const hoistedParameterId = PrebindingManager.getHoistedIdForParameterId(variableMapping.parameterId, patternRootNodeIds);
-    const parameter = parameters?.[hoistedParameterId];
+    const parameter = parameters?.[variableMapping.parameterId];
     if (!parameter)
         return '';
     const dataSourceKey = parameter.path.split('/')[1];
@@ -41,22 +33,17 @@ const resolvePrebindingPath = ({ componentValueKey, componentSettings, parameter
     if (!entity || entity.sys.type === 'Asset')
         return '';
     const contentType = entity.sys.contentType.sys.id;
-    const hoistedParameterDefinition = entityStore.hoistedParameterDefinitions[hoistedParameterId];
-    if (!hoistedParameterDefinition || !hoistedParameterDefinition.contentTypes.includes(contentType))
-        return '';
     const fieldPath = variableMapping?.pathsByContentType?.[contentType]?.path;
     if (!fieldPath)
         return '';
     return parameter.path + fieldPath;
 };
-const resolveMaybePrebindingDefaultValuePath = ({ componentValueKey, patternRootNodeIdsChain, entityStore, }) => {
+const resolveMaybePrebindingDefaultValuePath = ({ componentValueKey, entityStore, }) => {
     const variableMapping = entityStore.hoistedVariableMappings[componentValueKey];
     if (!variableMapping)
         return;
-    const patternRootNodeIds = patternRootNodeIdsChain.join('---');
     const pdID = variableMapping.parameterId;
-    const hoistedpdID = PrebindingManager.getHoistedIdForParameterId(pdID, patternRootNodeIds);
-    const prebindingDefinition = entityStore.hoistedParameterDefinitions[hoistedpdID];
+    const prebindingDefinition = entityStore.hoistedParameterDefinitions[pdID];
     if (!prebindingDefinition) {
         // probably shouldn't happen, as if ppd is not defined, then variableMapping should not be defined either
         return;
@@ -70,7 +57,7 @@ const resolveMaybePrebindingDefaultValuePath = ({ componentValueKey, patternRoot
         // just extra safety check, defaultEntryLink should always be a link
         return;
     }
-    if (prebindingDefinition.contentTypes.includes(contentTypeId)) {
+    if (contentTypeId in prebindingDefinition.contentTypes) {
         const entity = entityStore.getEntityFromLink(defaultEntryLink);
         if (!entity) {
             // looks like sideloading of the prebinding default value didn't work as expected.
@@ -82,10 +69,9 @@ const resolveMaybePrebindingDefaultValuePath = ({ componentValueKey, patternRoot
             // Path not found or degenerate shape (e.g. empty string '')
             return;
         }
-        const fullDefaultValuePath = `/${defaultEntryLink.sys.id}${fieldPath}`;
+        const fullDefaultValuePath = `/${SIDELOADED_PREFIX}${defaultEntryLink.sys.id}${fieldPath}`;
         return fullDefaultValuePath;
     }
-    return undefined;
 };
 
 export { resolveMaybePrebindingDefaultValuePath, resolvePrebindingPath, shouldUsePrebinding };

package/dist/utils/prebindingUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"prebindingUtils.js","sources":["../../../src/utils/prebindingUtils.ts"],"sourcesContent":["import { type EntityStore, isLink } from '@contentful/experiences-core';\nimport { ExperienceComponentSettings, Parameter } from '@contentful/experiences-validators';\nimport { PrebindingManager } from '../core/preview/PrebindingManager';\n\nexport const shouldUsePrebinding = ({\n  componentValueKey,\n  componentSettings,\n  parameters,\n  patternRootNodeIdsChain,\n}: {\n  componentValueKey: string;\n  componentSettings: ExperienceComponentSettings;\n  parameters: Record<string, Parameter>;\n  patternRootNodeIdsChain: string[];\n}) => {\n  const { prebindingDefinitions } = componentSettings;\n  const { parameterDefinitions, variableMappings, allowedVariableOverrides } =\n    prebindingDefinitions?.[0] || {};\n\n  const variableMapping = variableMappings?.[componentValueKey];\n\n  const parameterDefinition = parameterDefinitions?.[variableMapping?.parameterId || ''];\n\n  const patternRootNodeIds = patternRootNodeIdsChain.join('---');\n  const hoistedParameterId = PrebindingManager.getHoistedIdForParameterId(\n    variableMapping?.parameterId || '',\n    patternRootNodeIds,\n  );\n  const parameter = parameters?.[hoistedParameterId];\n\n  const isValidForPrebinding =\n    !!parameterDefinition &&\n    !!parameter &&\n    !!variableMapping &&\n    !!allowedVariableOverrides &&\n    Array.isArray(allowedVariableOverrides);\n\n  if (!isValidForPrebinding) {\n    return false;\n  }\n\n  // removed 'NoValue' check\n  const isForDirectBindingOnly = allowedVariableOverrides.includes(componentValueKey);\n  return !isForDirectBindingOnly;\n};\n\nexport const resolvePrebindingPath = ({\n  componentValueKey,\n  componentSettings,\n  parameters,\n  entityStore,\n  patternRootNodeIdsChain,\n}: {\n  componentValueKey: string;\n  componentSettings: ExperienceComponentSettings;\n  parameters: Record<string, Parameter>;\n  entityStore: EntityStore;\n  patternRootNodeIdsChain: string[];\n}) => {\n  const prebindingDefinition = componentSettings.prebindingDefinitions?.[0];\n  if (!prebindingDefinition) return '';\n\n  const variableMapping = prebindingDefinition.variableMappings?.[componentValueKey];\n\n  if (!variableMapping) return '';\n\n  const patternRootNodeIds = patternRootNodeIdsChain.join('---');\n  const hoistedParameterId = PrebindingManager.getHoistedIdForParameterId(\n    variableMapping.parameterId,\n    patternRootNodeIds,\n  );\n  const parameter = parameters?.[hoistedParameterId];\n\n  if (!parameter) return '';\n\n  const dataSourceKey = parameter.path.split('/')[1];\n\n  const entityLink = entityStore.dataSource[dataSourceKey];\n  if (!entityLink) return '';\n\n  const entity = entityStore.getEntityFromLink(entityLink);\n  if (!entity || entity.sys.type === 'Asset') return '';\n\n  const contentType = entity.sys.contentType.sys.id;\n\n  const hoistedParameterDefinition = entityStore.hoistedParameterDefinitions[hoistedParameterId];\n  if (!hoistedParameterDefinition || !hoistedParameterDefinition.contentTypes.includes(contentType))\n    return '';\n\n  const fieldPath = variableMapping?.pathsByContentType?.[contentType]?.path;\n\n  if (!fieldPath) return '';\n\n  return parameter.path + fieldPath;\n};\n\nexport const resolveMaybePrebindingDefaultValuePath = ({\n  componentValueKey,\n  patternRootNodeIdsChain,\n  entityStore,\n}: {\n  componentValueKey: string;\n  patternRootNodeIdsChain: string[];\n  entityStore: EntityStore;\n}): string | undefined => {\n  const variableMapping = entityStore.hoistedVariableMappings[componentValueKey];\n  if (!variableMapping) return;\n\n  const patternRootNodeIds = patternRootNodeIdsChain.join('---');\n\n  const pdID = variableMapping.parameterId;\n  const hoistedpdID = PrebindingManager.getHoistedIdForParameterId(pdID, patternRootNodeIds);\n  const prebindingDefinition = entityStore.hoistedParameterDefinitions[hoistedpdID];\n\n  if (!prebindingDefinition) {\n    // probably shouldn't happen, as if ppd is not defined, then variableMapping should not be defined either\n    return;\n  }\n  if (!prebindingDefinition.defaultSource) {\n    // pretty normal, prebinding definitions are not required to have default source\n    return;\n  }\n\n  const { contentTypeId, link: defaultEntryLink } = prebindingDefinition.defaultSource;\n\n  if (!isLink(defaultEntryLink)) {\n    // just extra safety check, defaultEntryLink should always be a link\n    return;\n  }\n\n  if (prebindingDefinition.contentTypes.includes(contentTypeId)) {\n    const entity = entityStore.getEntityFromLink(defaultEntryLink);\n    if (!entity) {\n      // looks like sideloading of the prebinding default value didn't work as expected.\n      // And didn't sideload the entry into entityStore (and didn't add it's sideloaded_dsKey to the entityStore.dataSource)\n      return;\n    }\n\n    const fieldPath = variableMapping.pathsByContentType[contentTypeId].path;\n    if (!fieldPath) {\n      // Path not found or degenerate shape (e.g. empty string '')\n      return;\n    }\n\n    const fullDefaultValuePath = `/${defaultEntryLink.sys.id}${fieldPath}`;\n    return fullDefaultValuePath;\n  }\n\n  return undefined;\n};\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"prebindingUtils.js","sources":["../../../src/utils/prebindingUtils.ts"],"sourcesContent":["import { type EntityStore, isLink } from '@contentful/experiences-core';\nimport { SIDELOADED_PREFIX } from '@contentful/experiences-core/constants';\nimport { ExperienceComponentSettings, Parameter } from '@contentful/experiences-validators';\n\nexport const shouldUsePrebinding = ({\n  componentValueKey,\n  componentSettings,\n  parameters,\n}: {\n  componentValueKey: string;\n  componentSettings: ExperienceComponentSettings;\n  parameters: Record<string, Parameter>;\n}) => {\n  const { prebindingDefinitions } = componentSettings;\n  const { parameterDefinitions, variableMappings, allowedVariableOverrides } =\n    prebindingDefinitions?.[0] || {};\n\n  const variableMapping = variableMappings?.[componentValueKey];\n\n  const parameterDefinition = parameterDefinitions?.[variableMapping?.parameterId || ''];\n  const parameter = parameters?.[variableMapping?.parameterId || ''];\n\n  const isValidForPrebinding =\n    !!parameterDefinition &&\n    !!parameter &&\n    !!variableMapping &&\n    !!allowedVariableOverrides &&\n    Array.isArray(allowedVariableOverrides);\n\n  const isForDirectBindingOnly = (allowedVariableOverrides: string[]) =>\n    allowedVariableOverrides.includes(componentValueKey); // removed 'NoValue' check\n\n  return isValidForPrebinding && !isForDirectBindingOnly(allowedVariableOverrides);\n};\n\nexport const resolvePrebindingPath = ({\n  componentValueKey,\n  componentSettings,\n  parameters,\n  entityStore,\n}: {\n  componentValueKey: string;\n  componentSettings: ExperienceComponentSettings;\n  parameters: Record<string, Parameter>;\n  entityStore: EntityStore;\n}) => {\n  const prebindingDefinition = componentSettings.prebindingDefinitions?.[0];\n  if (!prebindingDefinition) return '';\n\n  const variableMapping = prebindingDefinition.variableMappings?.[componentValueKey];\n\n  if (!variableMapping) return '';\n\n  const parameter = parameters?.[variableMapping.parameterId];\n\n  if (!parameter) return '';\n\n  const dataSourceKey = parameter.path.split('/')[1];\n\n  const entityLink = entityStore.dataSource[dataSourceKey];\n  if (!entityLink) return '';\n\n  const entity = entityStore.getEntityFromLink(entityLink);\n  if (!entity || entity.sys.type === 'Asset') return '';\n\n  const contentType = entity.sys.contentType.sys.id;\n\n  const fieldPath = variableMapping?.pathsByContentType?.[contentType]?.path;\n\n  if (!fieldPath) return '';\n\n  return parameter.path + fieldPath;\n};\n\nexport const resolveMaybePrebindingDefaultValuePath = ({\n  componentValueKey,\n  entityStore,\n}: {\n  componentValueKey: string;\n  entityStore: EntityStore;\n}): string | undefined => {\n  const variableMapping = entityStore.hoistedVariableMappings[componentValueKey];\n  if (!variableMapping) return;\n\n  const pdID = variableMapping.parameterId;\n  const prebindingDefinition = entityStore.hoistedParameterDefinitions[pdID];\n\n  if (!prebindingDefinition) {\n    // probably shouldn't happen, as if ppd is not defined, then variableMapping should not be defined either\n    return;\n  }\n  if (!prebindingDefinition.defaultSource) {\n    // pretty normal, prebinding definitions are not required to have default source\n    return;\n  }\n\n  const { contentTypeId, link: defaultEntryLink } = prebindingDefinition.defaultSource;\n\n  if (!isLink(defaultEntryLink)) {\n    // just extra safety check, defaultEntryLink should always be a link\n    return;\n  }\n\n  if (contentTypeId in prebindingDefinition.contentTypes) {\n    const entity = entityStore.getEntityFromLink(defaultEntryLink);\n    if (!entity) {\n      // looks like sideloading of the prebinding default value didn't work as expected.\n      // And didn't sideload the entry into entityStore (and didn't add it's sideloaded_dsKey to the entityStore.dataSource)\n      return;\n    }\n\n    const fieldPath = variableMapping.pathsByContentType[contentTypeId].path;\n    if (!fieldPath) {\n      // Path not found or degenerate shape (e.g. empty string '')\n      return;\n    }\n\n    const fullDefaultValuePath = `/${SIDELOADED_PREFIX}${defaultEntryLink.sys.id}${fieldPath}`;\n    return fullDefaultValuePath;\n  }\n};\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experiences-sdk-react",
-  "version": "3.8.0-dev-20250926T1559-e1ab24d.0",
+  "version": "3.8.0-prerelease-20250926T1312-a8b5fb7.0",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "typings": "./dist/src/index.d.ts",
@@ -41,10 +41,10 @@
     "depcruise": "depcruise src"
   },
   "dependencies": {
-    "@contentful/experiences-components-react": "3.8.0-dev-20250926T1559-e1ab24d.0",
-    "@contentful/experiences-core": "3.8.0-dev-20250926T1559-e1ab24d.0",
-    "@contentful/experiences-validators": "3.8.0-dev-20250926T1559-e1ab24d.0",
-    "@contentful/experiences-visual-editor-react": "3.8.0-dev-20250926T1559-e1ab24d.0",
+    "@contentful/experiences-components-react": "3.8.0-prerelease-20250926T1312-a8b5fb7.0",
+    "@contentful/experiences-core": "3.8.0-prerelease-20250926T1312-a8b5fb7.0",
+    "@contentful/experiences-validators": "3.8.0-prerelease-20250926T1312-a8b5fb7.0",
+    "@contentful/experiences-visual-editor-react": "3.8.0-prerelease-20250926T1312-a8b5fb7.0",
     "@contentful/rich-text-types": "^17.0.0",
     "csstype": "^3.1.2",
     "immer": "^10.0.3",
@@ -95,5 +95,5 @@
     "dist",
     "package.json"
   ],
-  "gitHead": "f8d4de61859767b45b66ecd2d9ab5df6e899466c"
+  "gitHead": "997f59d83781aba41da311c32652d2e23720e2b9"
 }

package/dist/core/preview/PrebindingManager.js

@@ -1,249 +0,0 @@
-const NODE_ID_SEPARATOR = '---'; // separator used to separate pattern levels in deseralizePatternNode
-/**
- * PrebindingManager utility class for resolving parameter bindings across nested patterns.
- *
- * The core approach is to first resolve the top-level parameterId using `getParameterIdByNodeId`,
- * which uses the paramIdToOverwriteIdMap, set when storing pre-binding based on the passToNodes chain to determine which parameter in the parent pattern
- * overrides a given parameterId (with some additionally workaround due to node ID renaming for patterns).
- * Once the owning top-level `parameterId` is found, we can follow the `passToNodes` chain back
- * down to retrieve all nested overrides — including parameter definitions, allowed content types,
- * and default sources — up to three levels deep.
- *
- * ## Lifecycle
- * This utility class currently uses static state, with Zustand stores supplementing the “latest” data
- * for root-level patterns data — for example, when overwriting content types on nested patterns or binding
- * fields on simple patterns. If we need the override mappings to be reactive, we could easily move
- * the full override chain tracking into Zustand but currently we can rely on the pattern definition
- * stores we have currently.
- *
- * The state is populated during deserialization, where we call `storePrebindingDefinitions` for each
- * pattern node. It is ready to be consumed at each level as nodes are deserialized top-down:
- * 1. Pattern C (Template Pattern)
- * 2. Pattern B (Nested Pattern)
- * 3. Pattern A (Simple Pattern)
- *
- * At each level, accessing overrides is possible:
- * - Pattern C has everything it needs once deserialized with its own parameters
- * - Pattern B has everything it needs once deserialized, with its own parameters possibly overridden by C
- * - Pattern A has its own parameters and possiblle overrites by B and/or C
- *
- * After actions that modify patterns without re-deserializing the tree — such as duplication,
- * deletion, or detachment — this state must be kept up to date via storePrebindingDefinitions
- * or storeParameterDefinitions if only parameter definitions are updated.
- *
- * ## Core Data Structures
- *
- *  - prebindingDefinitions           - A collection of all prebinding definitions aggregated
- *                                       from the parent pattern down to all nested patterns.
- *
- *  - prebindingDefinitionIdsByNodeId - Same as above, but indexed by `nodeId`. This allows us
- *                                       to easily find the prebinding definition id for a given node ID.
- *
- *  - parameterDefinitionsById        - A collection of all parameter definitions aggregated
- *                                       from the parent pattern down to nested patterns.
- *
- *  - variableMappingByPatternId      - A collection of all variable mappings aggregated from
- *                                       the parent pattern down to nested patterns, indexed by
- *                                       `patternId` for efficient access.
- *
- *  - newToOriginalNodeIdMap          - When deserializing pattern child nodes, we replace their
- *                                       node IDs with new ones based on their location inside the
- *                                       pattern. This prevents conflicts when multiple instances
- *                                       of the same pattern exist. The issue is that prebinding
- *                                       `passToNodes` resolution requires the original node ID.
- *                                       This map allows us to retrieve it to follow the chain.
- *
- *  - paramIdToOverwriteIdMap         - Tracks parameter ID overrides through the `passToNodes`
- *                                       chain, allowing us to resolve overrides correctly from
- *                                       the top-level parameter down to the lowest-level.
- */
-class PrebindingManager {
-    static prebindingDefinitions = new Map();
-    static prebindingDefinitionIdsByNodeId = new Map();
-    static parameterDefinitionsById = new Map();
-    static parameterDefinitionsByNodeId = new Map();
-    static variableMappingByPatternId = new Map();
-    static newToOriginalNodeIdMap = new Map();
-    static paramIdToOverwriteIdMap = new Map();
-    /**
-     * Links new node IDs to original node IDs
-     * - This is used to track the original node IDs for pattern instances as we change them when deserializing pattern nodes.
-     * @param newNodeId
-     * @param originalNodeId
-     */
-    static linkOriginalNodeIds(newNodeId, originalNodeId) {
-        PrebindingManager.newToOriginalNodeIdMap.set(newNodeId, originalNodeId);
-    }
-    /**
-     * Initializes the pattern editor manager by storing the definitions during deserialization
-     * for the root pattern and all nested patterns.
-     *
-     * @param nodeId - The ID of the pattern node.
-     * @param patternEntryId - The ID of the pattern entry from the patterns store.
-     * @param prebindingDefinitions - The prebinding definitions from the current pattern's component settings.
-     */
-    static storePrebindingDefinitions(nodeId, patternEntryId, prebindingDefinitions) {
-        for (const definition of prebindingDefinitions ?? []) {
-            PrebindingManager.prebindingDefinitions.set(definition.id, { ...definition });
-            PrebindingManager.prebindingDefinitionIdsByNodeId.set(nodeId, [definition.id]); // can only be one right now
-            if (definition.variableMappings) {
-                PrebindingManager.variableMappingByPatternId.set(patternEntryId, definition.variableMappings);
-            }
-            // Store the parameter definitions for the node
-            PrebindingManager.storeParameterDefinitions(nodeId, definition.parameterDefinitions || {});
-        }
-    }
-    /**
-     * Stores parameter definitions for a given nodeId.
-     * @param nodeId - The ID of the node to store parameter definitions for.
-     * @param parameterDefinitions - The parameter definitions to store.
-     */
-    static storeParameterDefinitions(nodeId, parameterDefinitions) {
-        // Reset the list of parameter definitions for the nodeId
-        PrebindingManager.parameterDefinitionsByNodeId.set(nodeId, []);
-        const updatedParameterDefinitionsByNodeId = [];
-        for (const [parameterId, parameter] of Object.entries(parameterDefinitions || {})) {
-            PrebindingManager.parameterDefinitionsById.set(parameterId, {
-                parameterId,
-                parameter,
-            });
-            if (parameter.passToNodes) {
-                const { parameterId: paramIdToOverwrite, nodeId: targetNodeId } = parameter.passToNodes[0] ?? {};
-                if (paramIdToOverwrite) {
-                    const existing = PrebindingManager.paramIdToOverwriteIdMap.get(paramIdToOverwrite) ?? [];
-                    const hasMatchingOverride = existing.some((it) => it.overwrittenByParamId === parameterId &&
-                        it.originalNodeIdToOverride === targetNodeId &&
-                        it.indexedParentPatternNodeId === nodeId);
-                    // Only add the override if it doesn't already exist to save duplicates
-                    if (!hasMatchingOverride) {
-                        PrebindingManager.paramIdToOverwriteIdMap.set(paramIdToOverwrite, [
-                            ...existing,
-                            {
-                                overwrittenByParamId: parameterId,
-                                originalNodeIdToOverride: targetNodeId,
-                                indexedParentPatternNodeId: nodeId,
-                            },
-                        ]);
-                    }
-                }
-            }
-            updatedParameterDefinitionsByNodeId.push({ parameterId, parameter });
-        }
-        PrebindingManager.parameterDefinitionsByNodeId.set(nodeId, updatedParameterDefinitionsByNodeId);
-    }
-    /**
-     * Resolves the top-level parameterId for a given nodeId.
-     *
-     * @param nodeId - The nodeId to resolve the parameterId for
-     * @param useStoreParameters - Whether to use the zustand store parameters or not
-     * @returns string | undefined - The resolved parameterId or undefined if not found
-     **/
-    static getParameterIdByNodeId(nodeId) {
-        const nativeParameterDefinitionForNodeId = PrebindingManager.getNativeParameterDefinitionByNodeId(nodeId);
-        if (!nativeParameterDefinitionForNodeId) {
-            return undefined;
-        }
-        const hoistedParameterId = PrebindingManager.getHoistedIdForParameterId(nativeParameterDefinitionForNodeId?.parameterId, nodeId);
-        return hoistedParameterId;
-    }
-    /* Returns the parameter definitions from a parameterId
-     * @param parameterId - The parameter to resolve all levels for
-     * @param useStoreParameters - Whether to use the zustand store parameters or not
-     * @returns [l1ParameterDefinitions, l2ParameterDefinitions, l3ParameterDefinitions]: Array of parameter definitions for each level
-     */
-    static getParameterDefinitionsByParameterId(parameterId) {
-        const l1Definition = PrebindingManager.parameterDefinitionsById.get(parameterId);
-        const l1PassToNode = (l1Definition?.parameter?.passToNodes || [])[0];
-        // Level 2
-        const l2Definition = PrebindingManager.parameterDefinitionsById.get(l1PassToNode?.parameterId);
-        const l2PassToNode = (l2Definition?.parameter?.passToNodes || [])[0];
-        let l3Definition;
-        // Level 3
-        if (l2PassToNode) {
-            // If the child definition has passToNodes, we can look up the child parameter definition by its composite key
-            l3Definition = PrebindingManager.parameterDefinitionsById.get(l2PassToNode?.parameterId);
-        }
-        // Return the definitions for all three levels unless they are all empty
-        const definitions = [l1Definition, l2Definition, l3Definition];
-        if (!definitions || !definitions.filter(Boolean).length) {
-            return undefined; // No definitions found
-        }
-        return definitions;
-    }
-    /**
-     * Returns all parameter definitions defined on the pattern of the given nodeId OR the pattern, wrapping the given nodeId
-     */
-    static getAllParameterDefinitionsForNodeId(nodeId) {
-        return Object.fromEntries((PrebindingManager.parameterDefinitionsByNodeId.get(nodeId) ?? []).map(({ parameterId, parameter }) => [parameterId, parameter]));
-    }
-    /**
-     * Return all parameter ID's on a pattern by NodeId
-     * @param nodeId - The nodeId to return params for
-     * @returns string[] An array of parameter IDs or undefined
-     */
-    static getAllParameterIdsByNodeId(nodeId) {
-        return Object.keys(PrebindingManager.getAllParameterDefinitionsForNodeId(nodeId));
-    }
-    /**
-     * Get the highest level overriding parameterId for a given parameterId + nodeId combination
-     * @param parameterId - The parameter to resolve
-     * @param indexedNodeId - The indexed node ID to resolve the parameterId for
-     * @returns string - The resolved parameterId - will be from "root" in patterns or the parent pattern node in experiences
-     */
-    static getHoistedIdForParameterId(parameterId, indexedNodeId) {
-        let currentParamId = parameterId;
-        let currentIndexedNodeId = indexedNodeId;
-        let currentOriginalNodeId = PrebindingManager.newToOriginalNodeIdMap.get(indexedNodeId) ?? indexedNodeId;
-        let override;
-        do {
-            const overrides = PrebindingManager.paramIdToOverwriteIdMap.get(currentParamId) ?? [];
-            const splitByDash = currentIndexedNodeId.split(NODE_ID_SEPARATOR);
-            override = overrides.find((it) => it.originalNodeIdToOverride === currentOriginalNodeId &&
-                ((splitByDash.length > 1 &&
-                    currentIndexedNodeId.includes(it.indexedParentPatternNodeId)) ||
-                    (splitByDash.length === 1 && it.indexedParentPatternNodeId === 'root')));
-            if (override) {
-                const { overwrittenByParamId, indexedParentPatternNodeId } = override;
-                currentParamId = overwrittenByParamId;
-                currentIndexedNodeId = indexedParentPatternNodeId;
-                currentOriginalNodeId =
-                    PrebindingManager.newToOriginalNodeIdMap.get(indexedParentPatternNodeId) ??
-                        indexedParentPatternNodeId;
-            }
-        } while (override);
-        return currentParamId;
-    }
-    /**
-     * Retrieves the native parameter definition for a given nodeId. ie one without passToNodes on the node.
-     * @param nodeId - The nodeId to retrieve the native parameter definition for
-     * @returns The native parameter definition for the given nodeId, or undefined if not found
-     */
-    static getNativeParameterDefinitionByNodeId(nodeId) {
-        const parameterDefinitionsForNodeId = PrebindingManager.parameterDefinitionsByNodeId.get(nodeId);
-        return PrebindingManager.extractNativeParameterDefinition(parameterDefinitionsForNodeId);
-    }
-    static extractNativeParameterDefinition(parameterDefinitions) {
-        const { parameterId, parameter } = parameterDefinitions?.find((it) => !it.parameter.passToNodes?.length) || {};
-        if (!parameterId || !parameter)
-            return;
-        return {
-            parameterId,
-            parameter,
-        };
-    }
-    /**
-     * Resets all properties of the PrebindingManager class
-     * triggered when we leave ExperienceBuilder back to experience folder view.
-     **/
-    static reset() {
-        PrebindingManager.prebindingDefinitions = new Map();
-        PrebindingManager.parameterDefinitionsById = new Map();
-        PrebindingManager.parameterDefinitionsByNodeId = new Map();
-        PrebindingManager.variableMappingByPatternId = new Map();
-        PrebindingManager.newToOriginalNodeIdMap = new Map();
-        PrebindingManager.paramIdToOverwriteIdMap = new Map();
-    }
-}
-
-export { PrebindingManager };
-//# sourceMappingURL=PrebindingManager.js.map