@contentful/experiences-core 3.7.0-prerelease-20250915T1724-8825648.0 → 3.7.0

package/dist/registries/breakpointsRegistry.d.ts

@@ -1,20 +1,43 @@
 import { Breakpoint } from '@contentful/experiences-validators';
 
-declare let breakpointsRegistry: Breakpoint[];
+declare const breakpointsRegistry: Breakpoint[];
 /**
- * Register custom breakpoints
- * @param breakpoints - [{[key:string]: string}]
- * @returns void
+ * Define custom breakpoints that should be used for all your experiences.
+ * A breakpoint consists of:
+ * - id: a unique identifier for this breakpoint
+ * - query: a media query string that defines when this breakpoint is active
+ * - previewSize: an optional fixed preview size to be used in the Studio editor when selecting this breakpoint
+ * - displayName: the name to be displayed in the Studio editor for this breakpoint
+ * - displayIcon: an optional icon to be displayed in the Studio editor for this breakpoint
+ *
+ * The first breakpoint must use a wildcard query (`*`) to match all sizes.
+ *
+ * Every subsequent breakpoint inherits the designs of the previous ones by default.
+ *
+ * The order of breakpoints must be either:
+ * - desktop first: from largest to smallest, using `<` operators
+ * - mobile first: from smallest to largest, using `>` operators
+ *
+ * @note changing breakpoints after you have created experiences may break those experiences
+ * @example
+ * defineBreakpoints([{
+ *    id: 'desktop',
+ *    query: '*',
+ *    displayName: 'Desktop',
+ *    displayIcon: 'desktop',
+ * }, {
+ *    id: 'tablet',
+ *    query: '<992px',
+ *    displayName: 'Tablet',
+ *    displayIcon: 'tablet',
+ * }, {
+ *    id: 'mobile',
+ *    query: '<576px',
+ *    displayName: 'Mobile',
+ *    displayIcon: 'mobile',
+ * }]);
  */
 declare const defineBreakpoints: (breakpoints: Breakpoint[]) => void;
 declare const runBreakpointsValidation: () => void;
-declare const getBreakpointRegistration: (id: string) => {
-    id: string;
-    query: "*" | `>${number}px` | `<${number}px`;
-    previewSize: string;
-    displayName: string;
-    displayIcon?: "desktop" | "tablet" | "mobile" | undefined;
-} | undefined;
-declare const resetBreakpointsRegistry: () => void;
 
-export { breakpointsRegistry, defineBreakpoints, getBreakpointRegistration, resetBreakpointsRegistry, runBreakpointsValidation };
+export { breakpointsRegistry, defineBreakpoints, runBreakpointsValidation };

package/dist/types.d.ts

@@ -191,11 +191,6 @@ type ExperienceTreeNode = {
         id: string;
         blockId?: string;
         slotId?: string;
-        assembly?: {
-            id: string;
-            componentId: string;
-            nodeLocation: string | null;
-        };
         displayName?: string;
         props: Record<string, ComponentPropertyValue>;
         dataSource: ExperienceDataSource;
@@ -552,6 +547,7 @@ type RequestReadOnlyModePayload = undefined;
 type RequestEditorModePayload = undefined;
 type ExperienceUpdatedPayload = {
     tree: ExperienceTree;
+    /** @deprecated not needed after `patternResolution` was introduced. Will be removed in the next major version. */
     assemblies?: ExperienceUsedComponents;
     locale: string;
     changedNode?: ExperienceTreeNode;

package/dist/utils/extractPrebindingData.d.ts

@@ -0,0 +1,46 @@
+import { ExperienceEntry } from '../types.js';
+import { ParameterDefinition, VariableMapping, ExperienceComponentSettings } from '@contentful/experiences-validators';
+
+type PrebindingData = {
+    prebindingDefinitionId: string;
+    parameterIds: Array<string>;
+    nativeParameterId?: string;
+    parameterDefinitions: Record<string, ParameterDefinition>;
+    variableMappings?: Record<string, VariableMapping>;
+};
+declare const flattenNestedPatterns: (fetchedPatterns: Array<ExperienceEntry>) => ExperienceEntry[];
+/**
+ * Given a list of patterns, extract the prebinding data into a more digestable format indexed by the pattern entry id
+ * @param patterns a list of pattern entries
+ * @returns a map of pattern entry ids to their prebinding data
+ */
+declare const extractPrebindingDataByPatternId: (patterns: Array<ExperienceEntry>) => Record<string, PrebindingData>;
+declare const generateDefaultDataSourceForPrebindingDefinition: (prebindingDefinitions?: ExperienceComponentSettings["prebindingDefinitions"]) => {
+    dataSource: Record<string, {
+        sys: {
+            type: "Link";
+            id: string;
+            linkType: "Entry" | "Asset";
+        };
+    }>;
+    parameters: Record<string, {
+        path: string;
+        type: "BoundValue";
+    }>;
+};
+declare function getTargetPatternMappingsForParameter({ fetchedPatterns, prebindingDataByPatternId, patternNodeDefinitionId, parameterId, }: {
+    fetchedPatterns: Array<ExperienceEntry>;
+    prebindingDataByPatternId: Record<string, PrebindingData>;
+    patternNodeDefinitionId: string;
+    parameterId: string;
+}): {
+    [k: string]: {
+        type: "ContentTypeMapping";
+        parameterId: string;
+        pathsByContentType: Record<string, {
+            path: string;
+        }>;
+    };
+} | undefined;
+
+export { type PrebindingData, extractPrebindingDataByPatternId, flattenNestedPatterns, generateDefaultDataSourceForPrebindingDefinition, getTargetPatternMappingsForParameter };

package/dist/utils/sanitizeNodeProps.d.ts

@@ -1,6 +1,7 @@
-import * as lodash from 'lodash';
 import { PrimitiveValue } from '@contentful/experiences-validators';
 
-declare const sanitizeNodeProps: (nodeProps: Record<PropertyKey, PrimitiveValue>) => lodash.Omit<Record<PropertyKey, string | number | boolean | Record<any, any> | undefined>, string>;
+declare const sanitizeNodeProps: (nodeProps: Record<PropertyKey, PrimitiveValue>) => {
+    [k: string]: string | number | boolean | Record<any, any> | undefined;
+};
 
 export { sanitizeNodeProps };

package/dist/utils/utils.d.ts

@@ -23,5 +23,10 @@ interface ParsedValue {
 }
 declare function parseCSSValue(input: string): ParsedValue | null;
 declare function getTargetValueInPixels(targetWidthObject: ParsedValue): number;
+/**
+ * Creates a component definition for an assembly. As all assemblies use the same definition in the SDK,
+ * all should be registered via this function.
+ */
+declare const createAssemblyDefinition: (definitionId: string) => ComponentDefinition;
 
-export { checkIsAssemblyDefinition, checkIsAssemblyEntry, checkIsAssemblyNode, generateRandomId, getDataFromTree, getTargetValueInPixels, parseCSSValue };
+export { checkIsAssemblyDefinition, checkIsAssemblyEntry, checkIsAssemblyNode, createAssemblyDefinition, generateRandomId, getDataFromTree, getTargetValueInPixels, parseCSSValue };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experiences-core",
-  "version": "3.7.0-prerelease-20250915T1724-8825648.0",
+  "version": "3.7.0",
   "description": "",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -20,8 +20,22 @@
     "dist/**/*.*"
   ],
   "exports": {
-    ".": "./dist/index.js",
-    "./constants": "./dist/constants.js",
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.js",
+      "types": [
+        "./dist/index.d.ts"
+      ]
+    },
+    "./constants": {
+      "import": "./dist/constants.js",
+      "require": "./dist/constants.cjs",
+      "default": "./dist/constants.js",
+      "types": [
+        "./dist/constants.d.ts"
+      ]
+    },
     "./types": "./dist/types.d.ts"
   },
   "publishConfig": {
@@ -54,9 +68,8 @@
   "devDependencies": {
     "@rollup/plugin-commonjs": "^25.0.7",
     "@rollup/plugin-node-resolve": "^15.2.3",
-    "@rollup/plugin-terser": "^0.4.4",
     "@rollup/plugin-typescript": "^11.1.5",
-    "@types/lodash-es": "^4.17.12",
+    "@types/lodash.clonedeep": "^4.5.9",
     "@vitest/coverage-v8": "^2.1.1",
     "contentful": "^10.6.4",
     "happy-dom": "^13.3.8",
@@ -67,13 +80,13 @@
     "vitest": "^2.1.1"
   },
   "dependencies": {
-    "@contentful/experiences-validators": "3.7.0-prerelease-20250915T1724-8825648.0",
+    "@contentful/experiences-validators": "3.7.0",
     "@contentful/rich-text-types": "^17.0.0",
-    "lodash-es": "^4.17.21",
+    "lodash.clonedeep": "^4.5.0",
     "zustand": "^4.4.7"
   },
   "peerDependencies": {
     "contentful": ">=10.6.0"
   },
-  "gitHead": "19c18e11e35b9261550f0cab3b54a9427987f084"
+  "gitHead": "0c47053b29fea11ad7e116e39c380c49c1387a8f"
 }

package/dist/exports.js

@@ -1,2 +0,0 @@
-export { ASSEMBLY_BLOCK_NODE_TYPE, ASSEMBLY_DEFAULT_CATEGORY, ASSEMBLY_NODE_TYPE, ASSEMBLY_NODE_TYPES, CF_STYLE_ATTRIBUTES, CONTENTFUL_COMPONENTS, CONTENTFUL_COMPONENT_CATEGORY, CONTENTFUL_DEFAULT_CATEGORY, EMPTY_CONTAINER_SIZE, HYPERLINK_DEFAULT_PATTERN, INCOMING_EVENTS, INTERNAL_EVENTS, LATEST_SCHEMA_VERSION, OUTGOING_EVENTS, PATTERN_PROPERTY_DIVIDER, PostMessageMethods, SCROLL_STATES, SIDELOADED_PREFIX, SUPPORTED_IMAGE_FORMATS, StudioCanvasMode, VISUAL_EDITOR_CONTAINER_ID, VISUAL_EDITOR_EVENTS } from './constants.js';
-//# sourceMappingURL=exports.js.map

package/dist/exports.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"exports.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}