@contentful/experiences-react 0.7.9 → 0.7.11

package/CHANGELOG.md

@@ -1,3 +1,19 @@
+## 0.7.11 (2026-08-27)
+
+### 🧱 Updated Dependencies
+
+- Updated client to 0.3.10
+- Updated design to 0.7.10
+- Updated core to 0.7.10
+
+## 0.7.10 (2026-08-26)
+
+### 🧱 Updated Dependencies
+
+- Updated client to 0.3.9
+- Updated design to 0.7.9
+- Updated core to 0.7.9
+
 ## 0.7.9 (2026-08-24)
 
 ### 🧱 Updated Dependencies

package/dist/types.d.ts

@@ -51,7 +51,7 @@ interface RenderContext extends ExperienceContext {
  */
 interface ComponentConfig<Props extends object = Record<string, unknown>> {
     /**
-     * Lowest-precedence prop bag. Merged in before content / resolveData /
+     * Lowest-precedence defaults object. Merged in before content / resolveData /
      * slots. Useful for variant fallbacks the editorial layer doesn't always supply.
      */
     defaults?: Partial<Props>;
@@ -62,7 +62,7 @@ interface ComponentConfig<Props extends object = Record<string, unknown>> {
      */
     resolveData?: (ctx: ResolveContext) => Partial<Props> | Promise<Partial<Props>>;
     /**
-     * The React component to render. Receives the merged prop bag as its props.
+     * The React component to render. Receives the merged props.
      */
     component: ComponentType<Props>;
 }
@@ -84,6 +84,10 @@ type Registration<Props extends object = Record<string, unknown>> = ComponentTyp
  * there is no `children` special case.
  */
 interface ExperienceTemplateConfig<Props extends object = Record<string, unknown>> {
+    /**
+     * Lowest-precedence defaults object. Merged in before content / resolveData /
+     * slots. Useful for variant fallbacks the editorial layer doesn't always supply.
+     */
     defaults?: Partial<Props>;
     resolveData?: (ctx: ResolveContext) => Partial<Props> | Promise<Partial<Props>>;
     component: ComponentType<Props>;

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/types.ts"],"sourcesContent":["import type { ComponentType } from 'react';\n\nimport type {\n  DesignPropValue,\n  ExperienceContext,\n  ResolveContext,\n  ResolveToken,\n  ViewportDef,\n} from '@contentful/experiences-sdk-core';\n\n/**\n * Re-exported for ergonomics: customer code authoring `resolveData` doesn't\n * have to dig into the core package for the context type.\n */\nexport type { ResolveContext, ResolveToken };\n\n/**\n * The full Contentful-side payload for a single component instance, exposed\n * via `useContentfulComponent()` to any descendant of a rendered Experience\n * node. Useful for custom design-property resolution outside the SDK's\n * cascade, branching by `componentId` in a generic wrapper, keying\n * analytics on `nodeId`, or rendering a raw-payload panel in preview.\n *\n * Design properties stay in their **raw discriminated form** here (the same\n * shape `ctx.design` carries inside `resolveData`). The viewport-cascaded,\n * token-resolved values are what `useDesignValues()` returns.\n */\nexport interface ContentfulComponent {\n  componentId: string;\n  nodeId?: string;\n  content: Record<string, unknown>;\n  design: Record<string, DesignPropValue>;\n  resolved?: Record<string, unknown>;\n}\n\n/**\n * Same shape as `ContentfulComponent`, but for an Experience Template node.\n * Exposed via `useContentfulExperienceTemplate()` inside an Experience\n * Template's component tree.\n */\nexport interface ContentfulExperienceTemplate {\n  experienceTemplateId: string;\n  nodeId?: string;\n  content: Record<string, unknown>;\n  design: Record<string, DesignPropValue>;\n  resolved?: Record<string, unknown>;\n}\n\n/**\n * Render-time experience context. Extends the core `ExperienceContext` with\n * the active viewport — a render-time value that resolvers cannot see (they\n * run once before viewport resolution and are not re-triggered by viewport\n * changes). Exposed via `useExperience()` to any descendant of the renderer.\n */\nexport interface RenderContext extends ExperienceContext {\n  activeViewport: ViewportDef;\n  activeViewportIndex: number;\n}\n\n/**\n * Customer-supplied configuration for a single component. The `component`\n * receives the merged props (design + content + resolveData + slots); resolved\n * design values auto-fill matching props and are also readable via\n * `useDesignValues()`. Runtime context and raw payload come from\n * `useExperience()` / `useContentfulComponent()`.\n */\nexport interface ComponentConfig<Props extends object = Record<string, unknown>> {\n  /**\n   * Lowest-precedence prop bag. Merged in before content / resolveData /\n   * slots. Useful for variant fallbacks the editorial layer doesn't always supply.\n   */\n  defaults?: Partial<Props>;\n  /**\n   * Optional sync-or-async hook that derives final props from the raw\n   * Experience inputs. Runs once during `resolveExperience`, before render —\n   * does NOT re-fire on viewport changes.\n   */\n  resolveData?: (ctx: ResolveContext) => Partial<Props> | Promise<Partial<Props>>;\n  /**\n   * The React component to render. Receives the merged prop bag as its props.\n   */\n  component: ComponentType<Props>;\n}\n\n/**\n * Registry value. Register a bare React component for the common case, or\n * the full `ComponentConfig` shape when you need defaults or a `resolveData`\n * hook.\n *\n *   button: Button,                                  // bare\n *   header: { component: Header, defaults: {...} }, // with defaults\n *   card:   defineComponent<CardProps>({ component: Card, resolveData: ... }),\n */\nexport type Registration<Props extends object = Record<string, unknown>> =\n  ComponentType<Props> | ComponentConfig<Props>;\n\n/**\n * Customer-supplied configuration for a coded Experience Template. Identical in\n * shape and behavior to `ComponentConfig` — an Experience Template is just a\n * node whose implementation lives in the `experienceTemplates` registry. Its\n * slots arrive as named props (a `content` slot becomes a `content` prop), so\n * there is no `children` special case.\n */\nexport interface ExperienceTemplateConfig<Props extends object = Record<string, unknown>> {\n  defaults?: Partial<Props>;\n  resolveData?: (ctx: ResolveContext) => Partial<Props> | Promise<Partial<Props>>;\n  component: ComponentType<Props>;\n}\n\n/**\n * Registry value for Experience Templates. Same dual-shape as component\n * registrations.\n */\nexport type ExperienceTemplateRegistration<Props extends object = Record<string, unknown>> =\n  ComponentType<Props> | ExperienceTemplateConfig<Props>;\n\n/**\n * Identity helper — returns the config as-is, but narrows the `resolveData`\n * and `component` parameter types to your declared `Props`.\n */\nexport function defineComponent<Props extends object = Record<string, unknown>>(\n  config: ComponentConfig<Props>\n): ComponentConfig<Props> {\n  return config;\n}\n\n/**\n * Identity helper — returns the Experience Template config as-is, with `Props`\n * narrowing.\n */\nexport function defineExperienceTemplate<Props extends object = Record<string, unknown>>(\n  config: ExperienceTemplateConfig<Props>\n): ExperienceTemplateConfig<Props> {\n  return config;\n}\n\n/**\n * Component registry — keyed by `componentId` (last slash-segment of\n * `component.sys.urn`). Per-entry prop narrowing happens at\n * `defineComponent<Props>` or at the bare-component's own type.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any -- per-entry narrowing happens at the registration author's call site.\nexport type Components = Record<string, Registration<any>>;\n\n/**\n * Experience Template registry — keyed by `experienceTemplateId` (last\n * slash-segment of an Experience Template node's own\n * `experienceTemplate.sys.urn`). Not read from `payload.sys`; templates are\n * ordinary nodes.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any -- per-entry narrowing happens at the registration author's call site.\nexport type ExperienceTemplates = Record<string, ExperienceTemplateRegistration<any>>;\n\nexport interface Config {\n  components: Components;\n  experienceTemplates?: ExperienceTemplates;\n  /**\n   * Resolves `DesignToken` values to runtime values before they reach a\n   * component. If omitted, they pass through unchanged. See `ResolveToken`\n   * in `@contentful/experiences-sdk-core` for the full contract.\n   */\n  resolveToken?: ResolveToken;\n}\n\n/**\n * Normalize a registry entry — bare component OR config object — into the\n * common `ComponentConfig` shape used by the renderer.\n *\n * React function components are plain functions; `React.memo` /\n * `React.forwardRef` yield objects carrying a `$$typeof` symbol. Both count\n * as bare components; a config object is discriminated by having a\n * `component` field and no `$$typeof`.\n */\nexport function normalizeComponentRegistration<P extends object>(\n  reg: Registration<P>\n): ComponentConfig<P> {\n  if (typeof reg === 'object' && reg !== null && !('$$typeof' in reg) && 'component' in reg) {\n    return reg as ComponentConfig<P>;\n  }\n  return { component: reg as ComponentType<P> };\n}\n\nexport function normalizeExperienceTemplateRegistration<P extends object>(\n  reg: ExperienceTemplateRegistration<P>\n): ExperienceTemplateConfig<P> {\n  if (typeof reg === 'object' && reg !== null && !('$$typeof' in reg) && 'component' in reg) {\n    return reg as ExperienceTemplateConfig<P>;\n  }\n  return { component: reg as ComponentType<P> };\n}\n"],"mappings":"AAwHO,SAAS,gBACd,QACwB;AACxB,SAAO;AACT;AAMO,SAAS,yBACd,QACiC;AACjC,SAAO;AACT;AAuCO,SAAS,+BACd,KACoB;AACpB,MAAI,OAAO,QAAQ,YAAY,QAAQ,QAAQ,EAAE,cAAc,QAAQ,eAAe,KAAK;AACzF,WAAO;AAAA,EACT;AACA,SAAO,EAAE,WAAW,IAAwB;AAC9C;AAEO,SAAS,wCACd,KAC6B;AAC7B,MAAI,OAAO,QAAQ,YAAY,QAAQ,QAAQ,EAAE,cAAc,QAAQ,eAAe,KAAK;AACzF,WAAO;AAAA,EACT;AACA,SAAO,EAAE,WAAW,IAAwB;AAC9C;","names":[]}
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["import type { ComponentType } from 'react';\n\nimport type {\n  DesignPropValue,\n  ExperienceContext,\n  ResolveContext,\n  ResolveToken,\n  ViewportDef,\n} from '@contentful/experiences-sdk-core';\n\n/**\n * Re-exported for ergonomics: customer code authoring `resolveData` doesn't\n * have to dig into the core package for the context type.\n */\nexport type { ResolveContext, ResolveToken };\n\n/**\n * The full Contentful-side payload for a single component instance, exposed\n * via `useContentfulComponent()` to any descendant of a rendered Experience\n * node. Useful for custom design-property resolution outside the SDK's\n * cascade, branching by `componentId` in a generic wrapper, keying\n * analytics on `nodeId`, or rendering a raw-payload panel in preview.\n *\n * Design properties stay in their **raw discriminated form** here (the same\n * shape `ctx.design` carries inside `resolveData`). The viewport-cascaded,\n * token-resolved values are what `useDesignValues()` returns.\n */\nexport interface ContentfulComponent {\n  componentId: string;\n  nodeId?: string;\n  content: Record<string, unknown>;\n  design: Record<string, DesignPropValue>;\n  resolved?: Record<string, unknown>;\n}\n\n/**\n * Same shape as `ContentfulComponent`, but for an Experience Template node.\n * Exposed via `useContentfulExperienceTemplate()` inside an Experience\n * Template's component tree.\n */\nexport interface ContentfulExperienceTemplate {\n  experienceTemplateId: string;\n  nodeId?: string;\n  content: Record<string, unknown>;\n  design: Record<string, DesignPropValue>;\n  resolved?: Record<string, unknown>;\n}\n\n/**\n * Render-time experience context. Extends the core `ExperienceContext` with\n * the active viewport — a render-time value that resolvers cannot see (they\n * run once before viewport resolution and are not re-triggered by viewport\n * changes). Exposed via `useExperience()` to any descendant of the renderer.\n */\nexport interface RenderContext extends ExperienceContext {\n  activeViewport: ViewportDef;\n  activeViewportIndex: number;\n}\n\n/**\n * Customer-supplied configuration for a single component. The `component`\n * receives the merged props (design + content + resolveData + slots); resolved\n * design values auto-fill matching props and are also readable via\n * `useDesignValues()`. Runtime context and raw payload come from\n * `useExperience()` / `useContentfulComponent()`.\n */\nexport interface ComponentConfig<Props extends object = Record<string, unknown>> {\n  /**\n   * Lowest-precedence defaults object. Merged in before content / resolveData /\n   * slots. Useful for variant fallbacks the editorial layer doesn't always supply.\n   */\n  defaults?: Partial<Props>;\n  /**\n   * Optional sync-or-async hook that derives final props from the raw\n   * Experience inputs. Runs once during `resolveExperience`, before render —\n   * does NOT re-fire on viewport changes.\n   */\n  resolveData?: (ctx: ResolveContext) => Partial<Props> | Promise<Partial<Props>>;\n  /**\n   * The React component to render. Receives the merged props.\n   */\n  component: ComponentType<Props>;\n}\n\n/**\n * Registry value. Register a bare React component for the common case, or\n * the full `ComponentConfig` shape when you need defaults or a `resolveData`\n * hook.\n *\n *   button: Button,                                  // bare\n *   header: { component: Header, defaults: {...} }, // with defaults\n *   card:   defineComponent<CardProps>({ component: Card, resolveData: ... }),\n */\nexport type Registration<Props extends object = Record<string, unknown>> =\n  ComponentType<Props> | ComponentConfig<Props>;\n\n/**\n * Customer-supplied configuration for a coded Experience Template. Identical in\n * shape and behavior to `ComponentConfig` — an Experience Template is just a\n * node whose implementation lives in the `experienceTemplates` registry. Its\n * slots arrive as named props (a `content` slot becomes a `content` prop), so\n * there is no `children` special case.\n */\nexport interface ExperienceTemplateConfig<Props extends object = Record<string, unknown>> {\n  /**\n   * Lowest-precedence defaults object. Merged in before content / resolveData /\n   * slots. Useful for variant fallbacks the editorial layer doesn't always supply.\n   */\n  defaults?: Partial<Props>;\n  resolveData?: (ctx: ResolveContext) => Partial<Props> | Promise<Partial<Props>>;\n  component: ComponentType<Props>;\n}\n\n/**\n * Registry value for Experience Templates. Same dual-shape as component\n * registrations.\n */\nexport type ExperienceTemplateRegistration<Props extends object = Record<string, unknown>> =\n  ComponentType<Props> | ExperienceTemplateConfig<Props>;\n\n/**\n * Identity helper — returns the config as-is, but narrows the `resolveData`\n * and `component` parameter types to your declared `Props`.\n */\nexport function defineComponent<Props extends object = Record<string, unknown>>(\n  config: ComponentConfig<Props>\n): ComponentConfig<Props> {\n  return config;\n}\n\n/**\n * Identity helper — returns the Experience Template config as-is, with `Props`\n * narrowing.\n */\nexport function defineExperienceTemplate<Props extends object = Record<string, unknown>>(\n  config: ExperienceTemplateConfig<Props>\n): ExperienceTemplateConfig<Props> {\n  return config;\n}\n\n/**\n * Component registry — keyed by `componentId` (last slash-segment of\n * `component.sys.urn`). Per-entry prop narrowing happens at\n * `defineComponent<Props>` or at the bare-component's own type.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any -- per-entry narrowing happens at the registration author's call site.\nexport type Components = Record<string, Registration<any>>;\n\n/**\n * Experience Template registry — keyed by `experienceTemplateId` (last\n * slash-segment of an Experience Template node's own\n * `experienceTemplate.sys.urn`). Not read from `payload.sys`; templates are\n * ordinary nodes.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any -- per-entry narrowing happens at the registration author's call site.\nexport type ExperienceTemplates = Record<string, ExperienceTemplateRegistration<any>>;\n\nexport interface Config {\n  components: Components;\n  experienceTemplates?: ExperienceTemplates;\n  /**\n   * Resolves `DesignToken` values to runtime values before they reach a\n   * component. If omitted, they pass through unchanged. See `ResolveToken`\n   * in `@contentful/experiences-sdk-core` for the full contract.\n   */\n  resolveToken?: ResolveToken;\n}\n\n/**\n * Normalize a registry entry — bare component OR config object — into the\n * common `ComponentConfig` shape used by the renderer.\n *\n * React function components are plain functions; `React.memo` /\n * `React.forwardRef` yield objects carrying a `$$typeof` symbol. Both count\n * as bare components; a config object is discriminated by having a\n * `component` field and no `$$typeof`.\n */\nexport function normalizeComponentRegistration<P extends object>(\n  reg: Registration<P>\n): ComponentConfig<P> {\n  if (typeof reg === 'object' && reg !== null && !('$$typeof' in reg) && 'component' in reg) {\n    return reg as ComponentConfig<P>;\n  }\n  return { component: reg as ComponentType<P> };\n}\n\nexport function normalizeExperienceTemplateRegistration<P extends object>(\n  reg: ExperienceTemplateRegistration<P>\n): ExperienceTemplateConfig<P> {\n  if (typeof reg === 'object' && reg !== null && !('$$typeof' in reg) && 'component' in reg) {\n    return reg as ExperienceTemplateConfig<P>;\n  }\n  return { component: reg as ComponentType<P> };\n}\n"],"mappings":"AA4HO,SAAS,gBACd,QACwB;AACxB,SAAO;AACT;AAMO,SAAS,yBACd,QACiC;AACjC,SAAO;AACT;AAuCO,SAAS,+BACd,KACoB;AACpB,MAAI,OAAO,QAAQ,YAAY,QAAQ,QAAQ,EAAE,cAAc,QAAQ,eAAe,KAAK;AACzF,WAAO;AAAA,EACT;AACA,SAAO,EAAE,WAAW,IAAwB;AAC9C;AAEO,SAAS,wCACd,KAC6B;AAC7B,MAAI,OAAO,QAAQ,YAAY,QAAQ,QAAQ,EAAE,cAAc,QAAQ,eAAe,KAAK;AACzF,WAAO;AAAA,EACT;AACA,SAAO,EAAE,WAAW,IAAwB;AAC9C;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experiences-react",
-  "version": "0.7.9",
+  "version": "0.7.11",
   "description": "React adapter for Contentful Experiences — Server and Client renderers over a PortableRenderPlan",
   "license": "MIT",
   "type": "module",
@@ -30,9 +30,9 @@
     "directory": "packages/adapter-react"
   },
   "dependencies": {
-    "@contentful/experiences-client": "0.3.8",
-    "@contentful/experiences-sdk-core": "0.7.8",
-    "@contentful/experiences-design": "0.7.8"
+    "@contentful/experiences-client": "0.3.10",
+    "@contentful/experiences-sdk-core": "0.7.10",
+    "@contentful/experiences-design": "0.7.10"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",