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

package/dist/index.js

@@ -135,6 +135,7 @@ var PostMessageMethods;
     PostMessageMethods["REQUESTED_ENTITIES"] = "REQUESTED_ENTITIES";
 })(PostMessageMethods || (PostMessageMethods = {}));
 const SUPPORTED_IMAGE_FORMATS = ['jpg', 'png', 'webp', 'gif', 'avif'];
+const SIDELOADED_PREFIX = 'sideloaded_';
 
 const structureComponentIds = new Set([
     CONTENTFUL_COMPONENTS.section.id,
@@ -1997,9 +1998,6 @@ const getPrebindingPathBySourceEntry = (preboundValueProperty, getHeadEntityByDa
         return undefined;
     }
     const contentTypeId = headEntity.sys.contentType.sys.id;
-    if (!preboundValueProperty.pathsByContentType?.[contentTypeId]) {
-        return undefined;
-    }
     return preboundValueProperty.pathsByContentType?.[contentTypeId]?.path;
 };
 const parseDeepPath = (deepPathCandidate) => {
@@ -2423,7 +2421,6 @@ const detachExperienceStyles = (experience) => {
     if (!experienceTreeRoot) {
         return;
     }
-    const isRenderingAPatternEntry = experience.entityStore?.isExperienceAPatternEntry;
     const mapOfDesignVariableKeys = flattenDesignTokenRegistry(designTokensRegistry);
     // getting breakpoints from the entry componentTree field
     const { breakpoints } = experienceTreeRoot;
@@ -2438,7 +2435,7 @@ const detachExperienceStyles = (experience) => {
     }), {});
     // getting the breakpoint ids
     const breakpointIds = Object.keys(mediaQueryDataByBreakpoint);
-    const iterateOverTreeAndExtractStyles = ({ componentTree, dataSource, unboundValues, componentSettings, componentVariablesOverwrites, patternWrapper, wrappingPatternIds, wrappingPatternNodeIds = isRenderingAPatternEntry ? ['root'] : [], }) => {
+    const iterateOverTreeAndExtractStyles = ({ componentTree, dataSource, unboundValues, componentSettings, componentVariablesOverwrites, patternWrapper, wrappingPatternIds, wrappingPatternNodeIds = [], }) => {
         // traversing the tree
         const queue = [];
         queue.push(...componentTree.children);
@@ -2529,7 +2526,7 @@ const detachExperienceStyles = (experience) => {
             // Chain IDs to avoid overwriting styles across multiple instances of the same pattern
             // e.g. `{outerPatternNodeId}{innerPatternNodeId}-{currentNodeId}`
             // (!) Notice that the chain of patterns (before the dash) follows the format of prebinding/ parameters
-            const currentNodeIdsChain = [...wrappingPatternNodeIds, currentNode.id].join('-');
+            const currentNodeIdsChain = `${wrappingPatternNodeIds.join('')}-${currentNode.id}`;
             // For each breakpoint, resolve design tokens, create the CSS and generate a unique className.
             for (const breakpointId of breakpointIds) {
                 const propsByBreakpointWithResolvedDesignTokens = Object.entries(propsByBreakpoint[breakpointId]).reduce((acc, [variableName, variableValue]) => {
@@ -3704,7 +3701,7 @@ const generateDefaultDataSourceForPrebindingDefinition = (prebindingDefinitions
     const parameters = {};
     for (const [parameterId, parameterDefinition] of Object.entries(prebindingDefinition.parameterDefinitions ?? {})) {
         if (parameterDefinition.defaultSource && isLink(parameterDefinition.defaultSource.link)) {
-            const dataSourceKey = parameterDefinition.defaultSource.link.sys.id;
+            const dataSourceKey = generateRandomId(7);
             dataSource[dataSourceKey] = parameterDefinition.defaultSource.link;
             parameters[parameterId] = {
                 type: 'BoundValue',
@@ -4245,9 +4242,6 @@ class EntityStore extends EntityStoreBase {
             this._experienceEntryId = experienceEntry.sys.id;
             this._unboundValues = experienceEntry.fields.unboundValues;
         }
-        this._isExperienceAPatternEntry = checkIsAssemblyEntry({
-            fields: this._experienceEntryFields,
-        });
         // DERIVE ENTITY STORE INSTANCE VARIBLES
         // Register prebindings
         {
@@ -4331,9 +4325,6 @@ class EntityStore extends EntityStoreBase {
     getCurrentLocale() {
         return this.locale;
     }
-    get isExperienceAPatternEntry() {
-        return this._isExperienceAPatternEntry;
-    }
     get hoistedVariableMappings() {
         return this._hoistedVariableMappings;
     }
@@ -5046,6 +5037,92 @@ const removeSelfReferencingDataSource = (experienceEntry) => {
     experienceEntry.fields.dataSource = newDataSource;
 };
 
+/**
+ * Attaches the default prebinding value (if any) to the experience entry's dataSource.
+ *
+ * This ensures that any default values defined in pattern property definitions are included
+ * in the dataSource, so that linked entities can be fetched and resolved correctly.
+ * Without this, defaults may be omitted, resulting in unresolved references during binding.
+ *
+ * @returns The number of sideloaded default values, or false if the entry is not a pattern.
+ */
+const sideloadPrebindingDefaultValues = (patternEntry) => {
+    let sideloadedCount = 0;
+    const addDefaultValueToDataSource = (_definitionId, definition) => {
+        if (!definition.defaultSource) {
+            // prebinding preset doesn't have default value, which is perfectly fine
+            return;
+        }
+        const { contentTypeId, link, type, // At the time of writing, it means that defaultSource is a link to a Contentful Entry, but in the future it could be a link to third party resource or smth.
+        // this .type enumeration will not have the same meaning as `Link#sys#linkType`.
+         } = definition.defaultSource;
+        if (!isLink(link)) {
+            // default value is not a link, maybe due to a bug
+            return;
+        }
+        if (!type || !contentTypeId) {
+            // broken data structure, unlikely to happen, only due to a bug
+            return;
+        }
+        // Throw in the link to the default-entry into the dataSource, this way
+        // we rely on the mechanism of fetchReferencedEntities() to "sideload" them.
+        // Keep in mind that dataSource will be available as EntityStore.dataSource
+        // and now will contain also key for `sideloaded_uuid` entry.
+        // When "sideloading" entries into the entityStore, we must ensure that
+        // there's corresponding entry in the dataSource, because all bound variables
+        // are resolved, via path that is indirectly referencing the dataSource,
+        // eg. { type: 'BoundValue', path: '/sideloaded_uuid/fields/title' }
+        patternEntry.fields.dataSource = {
+            ...patternEntry.fields.dataSource,
+            [`${SIDELOADED_PREFIX}${link.sys.id}`]: {
+                // to highlight that this is a sideloaded entry, we prefix it
+                sys: {
+                    type: 'Link',
+                    linkType: link.sys.linkType,
+                    id: link.sys.id,
+                },
+            },
+        };
+        sideloadedCount++;
+    };
+    if (!checkIsAssemblyEntry(patternEntry)) {
+        // Only supported for pattern entries since experience entries don't define pattern properties.
+        return false;
+    }
+    // --------------------
+    // Sideload prebinding values for the L1 parent pattern aka `pA`
+    // --------------------
+    const definitions = patternEntry.fields.componentSettings?.prebindingDefinitions?.[0].parameterDefinitions ?? {};
+    Object.entries(definitions).forEach(([id, definition]) => {
+        addDefaultValueToDataSource(id, definition);
+    });
+    // --------------------
+    // Sideload all default values for the L2 nested patterns, patterns aka`pB`
+    // --------------------
+    const nestedPatternEntriesLevel2 = (patternEntry.fields.usedComponents || []).filter((component) => component !== undefined && checkIsAssemblyEntry(component));
+    nestedPatternEntriesLevel2.forEach((patternEntry) => {
+        const parameterDefinitions = patternEntry.fields.componentSettings?.prebindingDefinitions?.[0].parameterDefinitions ?? {};
+        Object.entries(parameterDefinitions).forEach(([id, definition]) => {
+            addDefaultValueToDataSource(id, definition);
+        });
+    });
+    // --------------------
+    // Sideload all default values for the L3 nested patterns, patterns aka `pC`
+    // --------------------
+    const nestedPatternEntriesLevel3 = nestedPatternEntriesLevel2.flatMap((patternEntryLevel2) => {
+        const usedComponents = patternEntryLevel2.fields.usedComponents || [];
+        const filteredUsedComponents = usedComponents.filter((component) => component !== undefined && checkIsAssemblyEntry(component));
+        return filteredUsedComponents;
+    });
+    nestedPatternEntriesLevel3.forEach((patternEntry) => {
+        const parameterDefinitions = patternEntry.fields.componentSettings?.prebindingDefinitions?.[0].parameterDefinitions ?? {};
+        Object.entries(parameterDefinitions).forEach(([id, definition]) => {
+            addDefaultValueToDataSource(id, definition);
+        });
+    });
+    return sideloadedCount;
+};
+
 /**
  * Run additional checks on the references used in the experience entry and
  * process data required for prebinding. This must be used after fetching an
@@ -5056,6 +5133,7 @@ const removeSelfReferencingDataSource = (experienceEntry) => {
 const prepareExperienceEntry = (experienceEntry) => {
     removeCircularPatternReferences(experienceEntry);
     removeSelfReferencingDataSource(experienceEntry);
+    sideloadPrebindingDefaultValues(experienceEntry);
 };
 
 const errorMessagesWhileFetching$1 = {