@contentful/experiences-core 3.3.0-dev-20250820T0950-c569ea0.0 → 3.3.0-dev-20250820T1056-fd92026.0

package/dist/deep-binding/DeepReference.d.ts

@@ -1,5 +1,5 @@
 import { DataSourceEntryValueType, Link, ExperienceEntry, ExperienceTreeNode } from '../types.js';
-import { EntityFromLink } from '../entity/EntityStoreBase.js';
+import { EntityFromLink, EntityStoreBase } from '../entity/EntityStoreBase.js';
 import { ExperienceDataSource } from '@contentful/experiences-validators';
 
 type DeepReferenceOpts = {
@@ -22,6 +22,6 @@ declare class DeepReference {
     static from(opt: DeepReferenceOpts): DeepReference;
 }
 declare function gatherDeepReferencesFromExperienceEntry(experienceEntry: ExperienceEntry): DeepReference[];
-declare function gatherDeepReferencesFromTree(startingNode: ExperienceTreeNode, dataSource: ExperienceDataSource): DeepReference[];
+declare function gatherDeepReferencesFromTree(startingNode: ExperienceTreeNode, dataSource: ExperienceDataSource, getEntityFromLink: EntityStoreBase['getEntityFromLink']): DeepReference[];
 
 export { DeepReference, gatherDeepReferencesFromExperienceEntry, gatherDeepReferencesFromTree };

package/dist/index.d.ts

@@ -6,7 +6,7 @@ export { isLinkToAsset } from './utils/isLinkToAsset.js';
 export { isLinkToEntry } from './utils/isLinkToEntry.js';
 export { isLink } from './utils/isLink.js';
 export { localizeEntity } from './utils/localizeEntity.js';
-export { Fieldset, UnresolvedFieldset, isDeepPath, lastPathNamedSegmentEq, parseDataSourcePathIntoFieldset, parseDataSourcePathWithL1DeepBindings } from './utils/pathSchema.js';
+export { Fieldset, PreboundVariable, UnresolvedFieldset, getPrebindingPathBySourceEntry, isDeepPath, isDeepPrebinding, isPreboundProp, lastPathNamedSegmentEq, parseDataSourcePathIntoFieldset, parseDataSourcePathWithL1DeepBindings } from './utils/pathSchema.js';
 export { addLocale, buildTemplate, getTemplateValue, resolveHyperlinkPattern } from './utils/resolveHyperlinkPattern.js';
 export { sanitizeNodeProps } from './utils/sanitizeNodeProps.js';
 export { addMinHeightForEmptyStructures, buildCfStyles, buildStyleTag, calculateNodeDefaultHeight, stringifyCssProperties, toCSSAttribute } from './utils/styleUtils/stylesUtils.js';

package/dist/index.js

@@ -1756,6 +1756,11 @@ function localizeEntity(entity, locale) {
 /**
  * This module encapsulates format of the path to a deep reference.
  */
+const isPreboundProp = (variable) => {
+    return (variable.type === 'BoundValue' &&
+        typeof variable.isPrebound === 'boolean' &&
+        !!variable.pathsByContentType);
+};
 const parseDataSourcePathIntoFieldset = (path) => {
     const parsedPath = parseDeepPath(path);
     if (null === parsedPath) {
@@ -1794,6 +1799,35 @@ const isDeepPath = (deepPathCandidate) => {
     }
     return deepPathParsed.fields.length > 1;
 };
+const isDeepPrebinding = (boundValueProperty) => {
+    if (!boundValueProperty?.path || boundValueProperty.type !== 'BoundValue') {
+        return false;
+    }
+    if (!isPreboundProp(boundValueProperty)) {
+        return false;
+    }
+    if (isDeepPath(boundValueProperty.path)) {
+        return true;
+    }
+    const hasDeepPathByContentType = Object.values(boundValueProperty.pathsByContentType || {}).some((val) => isDeepPath(val.path));
+    return hasDeepPathByContentType;
+};
+const getPrebindingPathBySourceEntry = (preboundValueProperty, getHeadEntityByDataSourceKey) => {
+    if (!isPreboundProp(preboundValueProperty)) {
+        return undefined;
+    }
+    // incomplete path due to several content types and not known default source
+    const [, dataSourceKey] = preboundValueProperty.path.split('/');
+    if (!dataSourceKey) {
+        return undefined;
+    }
+    const headEntity = getHeadEntityByDataSourceKey(dataSourceKey);
+    if (headEntity?.sys.type !== 'Entry') {
+        return undefined;
+    }
+    const contentTypeId = headEntity.sys.contentType.sys.id;
+    return preboundValueProperty.pathsByContentType?.[contentTypeId]?.path;
+};
 const parseDeepPath = (deepPathCandidate) => {
     // ALGORITHM:
     // We start with deep path in form:
@@ -4231,7 +4265,7 @@ function gatherDeepReferencesFromExperienceEntry(experienceEntry) {
     });
     return deepReferences;
 }
-function gatherDeepReferencesFromTree(startingNode, dataSource) {
+function gatherDeepReferencesFromTree(startingNode, dataSource, getEntityFromLink) {
     const deepReferences = [];
     treeVisit(startingNode, (node) => {
         if (!node.data.props)
@@ -4239,12 +4273,27 @@ function gatherDeepReferencesFromTree(startingNode, dataSource) {
         for (const [, variableMapping] of Object.entries(node.data.props)) {
             if (variableMapping.type !== 'BoundValue')
                 continue;
-            if (!isDeepPath(variableMapping.path))
-                continue;
-            deepReferences.push(DeepReference.from({
-                path: variableMapping.path,
-                dataSource,
-            }));
+            if (isDeepPath(variableMapping.path)) {
+                deepReferences.push(DeepReference.from({
+                    path: variableMapping.path,
+                    dataSource,
+                }));
+            }
+            else if (isPreboundProp(variableMapping) && isDeepPrebinding(variableMapping)) {
+                const getEntityByDataSourceKey = (dataSourceKey) => {
+                    const entityLink = dataSource[dataSourceKey];
+                    if (!entityLink)
+                        return undefined;
+                    return getEntityFromLink(entityLink);
+                };
+                const deepPrebindingPath = getPrebindingPathBySourceEntry(variableMapping, getEntityByDataSourceKey);
+                if (!deepPrebindingPath)
+                    continue;
+                deepReferences.push(DeepReference.from({
+                    path: deepPrebindingPath,
+                    dataSource,
+                }));
+            }
         }
     });
     return deepReferences;
@@ -4725,5 +4774,5 @@ async function fetchById({ client, experienceTypeId, id, localeCode, isEditorMod
     }
 }
 
-export { BREAKPOINTS_STRATEGY_DESKTOP_FIRST, BREAKPOINTS_STRATEGY_MOBILE_FIRST, DebugLogger, DeepReference, EditorModeEntityStore, EntityStore, EntityStoreBase, MEDIA_QUERY_REGEXP, VisualEditorMode, addLocale, addMinHeightForEmptyStructures, breakpointsRegistry, buildCfStyles, buildStyleTag, buildTemplate, builtInStyles, calculateNodeDefaultHeight, checkIsAssemblyDefinition, checkIsAssemblyEntry, checkIsAssemblyNode, columnsBuiltInStyles, containerBuiltInStyles, createExperience, debug, defineBreakpoints, defineDesignTokens, designTokensRegistry, detachExperienceStyles, detectBreakpointsStrategy, disableDebug, dividerBuiltInStyles, doesMismatchMessageSchema, enableDebug, extractLeafLinksReferencedFromExperience, extractReferencesFromEntries, extractReferencesFromEntriesAsIds, fetchAllAssets, fetchAllEntries, fetchById, fetchBySlug, fetchExperienceEntry, fetchReferencedEntities, findOutermostCoordinates, flattenDesignTokenRegistry, gatherDeepReferencesFromExperienceEntry, gatherDeepReferencesFromTree, generateRandomId, getActiveBreakpointIndex, getBreakpointRegistration, getDataFromTree, getDesignTokenRegistration, getElementCoordinates, getFallbackBreakpointIndex, getTargetValueInPixels, getTemplateValue, getValueForBreakpoint, inMemoryEntities, inMemoryEntitiesStore, indexByBreakpoint, isArrayOfLinks, isAsset, isCfStyleAttribute, isComponentAllowedOnRoot, isContentfulComponent, isContentfulStructureComponent, isDeepPath, isElementHidden, isEntry, isExperienceEntry, isLink, isLinkToAsset, isLinkToEntry, isPatternComponent, isPatternEntry, isStructureWithRelativeHeight, isValidBreakpointValue, lastPathNamedSegmentEq, localizeEntity, maybePopulateDesignTokenValue, mediaQueryMatcher, mergeDesignValuesByBreakpoint, optionalBuiltInStyles, parseCSSValue, parseDataSourcePathIntoFieldset, parseDataSourcePathWithL1DeepBindings, referencesOf, resetBreakpointsRegistry, resetDesignTokenRegistry, resolveBackgroundImageBinding, resolveHyperlinkPattern, runBreakpointsValidation, sanitizeNodeProps, sectionBuiltInStyles, sendMessage, singleColumnBuiltInStyles, stringifyCssProperties, toCSSAttribute, toMediaQuery, transformBoundContentValue, transformVisibility, treeMap, treeVisit, tryParseMessage, uniqueById, useInMemoryEntities, validateExperienceBuilderConfig };
+export { BREAKPOINTS_STRATEGY_DESKTOP_FIRST, BREAKPOINTS_STRATEGY_MOBILE_FIRST, DebugLogger, DeepReference, EditorModeEntityStore, EntityStore, EntityStoreBase, MEDIA_QUERY_REGEXP, VisualEditorMode, addLocale, addMinHeightForEmptyStructures, breakpointsRegistry, buildCfStyles, buildStyleTag, buildTemplate, builtInStyles, calculateNodeDefaultHeight, checkIsAssemblyDefinition, checkIsAssemblyEntry, checkIsAssemblyNode, columnsBuiltInStyles, containerBuiltInStyles, createExperience, debug, defineBreakpoints, defineDesignTokens, designTokensRegistry, detachExperienceStyles, detectBreakpointsStrategy, disableDebug, dividerBuiltInStyles, doesMismatchMessageSchema, enableDebug, extractLeafLinksReferencedFromExperience, extractReferencesFromEntries, extractReferencesFromEntriesAsIds, fetchAllAssets, fetchAllEntries, fetchById, fetchBySlug, fetchExperienceEntry, fetchReferencedEntities, findOutermostCoordinates, flattenDesignTokenRegistry, gatherDeepReferencesFromExperienceEntry, gatherDeepReferencesFromTree, generateRandomId, getActiveBreakpointIndex, getBreakpointRegistration, getDataFromTree, getDesignTokenRegistration, getElementCoordinates, getFallbackBreakpointIndex, getPrebindingPathBySourceEntry, getTargetValueInPixels, getTemplateValue, getValueForBreakpoint, inMemoryEntities, inMemoryEntitiesStore, indexByBreakpoint, isArrayOfLinks, isAsset, isCfStyleAttribute, isComponentAllowedOnRoot, isContentfulComponent, isContentfulStructureComponent, isDeepPath, isDeepPrebinding, isElementHidden, isEntry, isExperienceEntry, isLink, isLinkToAsset, isLinkToEntry, isPatternComponent, isPatternEntry, isPreboundProp, isStructureWithRelativeHeight, isValidBreakpointValue, lastPathNamedSegmentEq, localizeEntity, maybePopulateDesignTokenValue, mediaQueryMatcher, mergeDesignValuesByBreakpoint, optionalBuiltInStyles, parseCSSValue, parseDataSourcePathIntoFieldset, parseDataSourcePathWithL1DeepBindings, referencesOf, resetBreakpointsRegistry, resetDesignTokenRegistry, resolveBackgroundImageBinding, resolveHyperlinkPattern, runBreakpointsValidation, sanitizeNodeProps, sectionBuiltInStyles, sendMessage, singleColumnBuiltInStyles, stringifyCssProperties, toCSSAttribute, toMediaQuery, transformBoundContentValue, transformVisibility, treeMap, treeVisit, tryParseMessage, uniqueById, useInMemoryEntities, validateExperienceBuilderConfig };
 //# sourceMappingURL=index.js.map