@contentful/experiences-react 0.14.0 → 0.14.2

package/CHANGELOG.md

@@ -1,3 +1,25 @@
+## 0.14.2 (2026-10-22)
+
+### 🚀 Features
+
+- add runtime Experience parameters [ARC-2668] ([#235](https://github.com/contentful/experiences/pull/235))
+
+### 🧱 Updated Dependencies
+
+- Updated live-preview to 0.7.2
+- Updated runtime to 0.2.2
+- Updated client to 0.10.2
+
+## 0.14.1 (2026-10-22)
+
+### 🧱 Updated Dependencies
+
+- Updated live-preview to 0.7.1
+- Updated runtime to 0.2.1
+- Updated client to 0.10.1
+- Updated design to 0.13.1
+- Updated core to 0.13.1
+
 ## 0.14.0 (2026-10-22)
 
 ### 🧱 Updated Dependencies

package/README.md

@@ -237,3 +237,13 @@ For the full getting-started walkthrough, merge-precedence rules, and design rat
 ## License
 
 MIT. See the repository [`LICENSE`](../../LICENSE) and [`NOTICE`](../../NOTICE) for full attribution.
+
+## Runtime Experience parameters
+
+By-ID `fetchExperience` accepts `parameters`, for example
+`{ featuredPosts: { limit: 6, order: '-fields.title' } }`. Scalars are strings or
+numbers; Record leaves have one level. Order is one signed `fields.<apiName>` or
+`sys.<id>` path. Refetch with changed values, then replace the renderer's plan.
+Exports include `ExperienceParameters`, `ExperienceParameterValue`,
+`ExperienceParameterRecord`, and `ExperienceParameterOrder`.
+See the [collection/refetch example](../../README.md#runtime-experience-parameters).

package/dist/index.d.ts

@@ -15,5 +15,5 @@ export { ComponentConfig, Components, Config, ContentfulComponent, ContentfulExp
 export { ComponentNode, ComponentRef, DesignPropValue, DesignToken, ExperienceContext, ExperienceNode, ExperiencePayload, ExperienceSourceMap, ExperienceSys, ExperienceTemplateNode, ExperienceTemplateRef, ManualDesignValue, PortableRegistration, PortableRenderNode, PortableRenderPlan, RenderContext, ResolveContext, ResolveExperienceOptions, ResolveToken, ResolverConfig, TRACKING_CLICKABLE_ATTRIBUTE, TRACKING_SCOPES_ATTRIBUTE, TrackingAttributes, getTrackingAttributes, resolveExperience } from '@contentful/experiences-sdk-core';
 export { ANONYMOUS_ID_COOKIE, ClickBuilderArgs, DEFAULT_PAGE_PROPERTIES, EventBuilder, EventBuilderConfig, FlagViewBuilderArgs, HoverBuilderArgs, IdentifyBuilderArgs, InteractionBuilderArgsBase, PageViewBuilderArgs, TrackBuilderArgs, UniversalEventBuilderArgs, ViewBuilderArgs } from '@contentful/experiences-runtime';
 export { CSS_PROPERTIES, isCssProperty, toCssKey } from '@contentful/experiences-design';
-export { ByDestinationNodeIdExperienceOptions, ByDestinationPathExperienceOptions, ByIdExperienceOptions, ClientOptions, ContentfulViewDelivery, ContentfulViewDeliveryClient, CreateClientOptions, DELIVERY_HOST, DestinationRedirectResult, DestinationSitemapResult, ExperienceFetchError, ExperienceOptions, ExperienceResponse, FetchDestinationSitemapOptions, FetchDestinationSitemapPaginationOptions, NotFoundError, PREVIEW_HOST, ResolveOptions, SitemapPathItem, createClient, fetchDestinationSitemap, fetchExperience, readSourceMap, toExperiencePayload, toExperiencePayloadFromDestination } from '@contentful/experiences-client';
+export { ByDestinationNodeIdExperienceOptions, ByDestinationPathExperienceOptions, ByIdExperienceOptions, ClientOptions, ContentfulViewDelivery, ContentfulViewDeliveryClient, CreateClientOptions, DELIVERY_HOST, DestinationRedirectResult, DestinationSitemapResult, ExperienceFetchError, ExperienceOptions, ExperienceParameterOrder, ExperienceParameterRecord, ExperienceParameterValue, ExperienceParameters, ExperienceResponse, FetchDestinationSitemapOptions, FetchDestinationSitemapPaginationOptions, NotFoundError, PREVIEW_HOST, ResolveOptions, SitemapPathItem, createClient, fetchDestinationSitemap, fetchExperience, readSourceMap, toExperiencePayload, toExperiencePayloadFromDestination } from '@contentful/experiences-client';
 import 'react';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/*\n * Public API surface for `@contentful/experiences-react`.\n *\n * Customers add ONLY this package to their app's dependencies. Everything\n * needed to render an Experience — types, the resolver, design utilities,\n * the renderer components, the authoring helpers — is re-exported from here.\n * The internal `@contentful/experiences-sdk-core` and\n * `@contentful/experiences-design` packages are workspace-only implementation\n * details; they are not part of the public API.\n *\n * `ExperienceRenderer` is an alias for `ClientExperienceRenderer`; SSR\n * consumers explicitly import `ServerExperienceRenderer`.\n */\n\n// ─── Renderers ─────────────────────────────────────────────────────────────\nexport {\n  ClientExperienceRenderer as ExperienceRenderer,\n  ClientExperienceRenderer,\n} from './client-renderer.js';\nexport type { ClientExperienceRendererProps as ExperienceRendererProps } from './client-renderer.js';\nexport type { ClientExperienceRendererProps } from './client-renderer.js';\n\nexport { ServerExperienceRenderer } from './server-renderer.js';\nexport type { ServerExperienceRendererProps } from './server-renderer.js';\n\nexport { MissingComponent } from './missing-component.js';\nexport type { MissingComponentProps } from './missing-component.js';\n\nexport { ComponentError } from './component-error.js';\nexport type { ComponentErrorProps } from './component-error.js';\n\nexport { DebugExperience } from './debug-experience.js';\nexport type { DebugExperienceProps } from './debug-experience.js';\n\nexport type { DiagnosticReporter, RenderError, RenderUnknown } from './nodes-renderer.js';\n\nexport { useLivePreviewExperience } from './use-live-preview-experience.js';\nexport type {\n  UseLivePreviewExperienceOptions,\n  UseLivePreviewExperienceResult,\n} from './use-live-preview-experience.js';\nexport { useLivePreview } from './use-live-preview.js';\nexport type { UseLivePreviewOptions, UseLivePreviewResult } from './use-live-preview.js';\n\nexport { useExperiencePlan } from './use-experience-plan.js';\nexport type {\n  ExperiencePlanResolveOptions,\n  UseExperiencePlanOptions,\n  UseExperiencePlanResult,\n} from './use-experience-plan.js';\nexport type {\n  LivePreviewClient,\n  LivePreviewResult,\n  PreviewSessionClientOptions,\n  PreviewSessionExperienceOptions,\n  PreviewSessionOptions,\n  PreviewSessionResolveOptions,\n} from '@contentful/experiences-live-preview';\nexport {\n  fetchPreviewSession,\n  LivePreviewConnectionError,\n  PREVIEW_WEBSOCKET_HOST,\n  PreviewSessionFetchError,\n} from '@contentful/experiences-live-preview';\n\n// ─── Runtime context hooks ───────────────────────────────────────────────\nexport {\n  useExperience,\n  useContentfulComponent,\n  useContentfulExperienceTemplate,\n} from './context.js';\nexport { useDesignValues } from './use-design-values.js';\nexport { toCss } from './design-utils.js';\nexport type { ToCssOptions } from './design-utils.js';\n\n// ─── Authoring helpers + Config types ─────────────────────────────────────\nexport {\n  defineComponent,\n  defineExperienceTemplate,\n  normalizeComponentRegistration,\n  normalizeExperienceTemplateRegistration,\n} from './types.js';\nexport type {\n  ComponentConfig,\n  Components,\n  Config,\n  ContentfulComponent,\n  ContentfulExperienceTemplate,\n  ExperienceTemplateConfig,\n  ExperienceTemplateRegistration,\n  ExperienceTemplates,\n  Registration,\n  RenderContext,\n  ResolveToken,\n} from './types.js';\n\n// ─── Resolver (re-exported from render-core) ──────────────────────────────\nexport { resolveExperience } from '@contentful/experiences-sdk-core';\nexport {\n  getTrackingAttributes,\n  TRACKING_CLICKABLE_ATTRIBUTE,\n  TRACKING_SCOPES_ATTRIBUTE,\n} from '@contentful/experiences-sdk-core';\nexport type { TrackingAttributes } from '@contentful/experiences-sdk-core';\nexport type { ResolverConfig, ResolveExperienceOptions } from '@contentful/experiences-sdk-core';\n\n// ─── Event builder (re-exported from runtime) ─────────────────────────────\nexport { DEFAULT_PAGE_PROPERTIES, EventBuilder } from '@contentful/experiences-runtime';\nexport type {\n  ClickBuilderArgs,\n  EventBuilderConfig,\n  FlagViewBuilderArgs,\n  HoverBuilderArgs,\n  IdentifyBuilderArgs,\n  InteractionBuilderArgsBase,\n  PageViewBuilderArgs,\n  TrackBuilderArgs,\n  UniversalEventBuilderArgs,\n  ViewBuilderArgs,\n} from '@contentful/experiences-runtime';\n\n// ─── Core IR + payload types (re-exported from render-core) ───────────────\nexport type {\n  ComponentNode,\n  ComponentRef,\n  DesignPropValue,\n  DesignToken,\n  ExperienceContext,\n  ExperienceNode,\n  ExperiencePayload,\n  ExperienceSourceMap,\n  ExperienceSys,\n  ExperienceTemplateNode,\n  ExperienceTemplateRef,\n  ManualDesignValue,\n  PortableRegistration,\n  PortableRenderNode,\n  PortableRenderPlan,\n  ResolveContext,\n} from '@contentful/experiences-sdk-core';\n\n// ─── Design utilities (re-exported from design) ───────────────────────────\nexport { CSS_PROPERTIES, isCssProperty, toCssKey } from '@contentful/experiences-design';\n\n// ─── Delivery client + fetchExperience ────────────────────────────────────\nexport {\n  ContentfulViewDelivery,\n  ContentfulViewDeliveryClient,\n  DELIVERY_HOST,\n  ExperienceFetchError,\n  NotFoundError,\n  PREVIEW_HOST,\n  createClient,\n  fetchExperience,\n  fetchDestinationSitemap,\n  readSourceMap,\n  toExperiencePayload,\n  toExperiencePayloadFromDestination,\n} from '@contentful/experiences-client';\nexport { ANONYMOUS_ID_COOKIE } from '@contentful/experiences-runtime';\nexport type {\n  ByDestinationNodeIdExperienceOptions,\n  ByDestinationPathExperienceOptions,\n  ByIdExperienceOptions,\n  ClientOptions,\n  CreateClientOptions,\n  DestinationRedirectResult,\n  DestinationSitemapResult,\n  ExperienceOptions,\n  ExperienceResponse,\n  FetchDestinationSitemapOptions,\n  FetchDestinationSitemapPaginationOptions,\n  ResolveOptions,\n  SitemapPathItem,\n} from '@contentful/experiences-client';\n"],"mappings":"AAeA;AAAA,EAC8B;AAAA,EAC5B,4BAAAA;AAAA,OACK;AAIP,SAAS,gCAAgC;AAGzC,SAAS,wBAAwB;AAGjC,SAAS,sBAAsB;AAG/B,SAAS,uBAAuB;AAKhC,SAAS,gCAAgC;AAKzC,SAAS,sBAAsB;AAG/B,SAAS,yBAAyB;AAclC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,uBAAuB;AAChC,SAAS,aAAa;AAItB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAgBP,SAAS,yBAAyB;AAClC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAKP,SAAS,yBAAyB,oBAAoB;AAmCtD,SAAS,gBAAgB,eAAe,gBAAgB;AAGxD;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,2BAA2B;","names":["ClientExperienceRenderer"]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/*\n * Public API surface for `@contentful/experiences-react`.\n *\n * Customers add ONLY this package to their app's dependencies. Everything\n * needed to render an Experience — types, the resolver, design utilities,\n * the renderer components, the authoring helpers — is re-exported from here.\n * The internal `@contentful/experiences-sdk-core` and\n * `@contentful/experiences-design` packages are workspace-only implementation\n * details; they are not part of the public API.\n *\n * `ExperienceRenderer` is an alias for `ClientExperienceRenderer`; SSR\n * consumers explicitly import `ServerExperienceRenderer`.\n */\n\n// ─── Renderers ─────────────────────────────────────────────────────────────\nexport {\n  ClientExperienceRenderer as ExperienceRenderer,\n  ClientExperienceRenderer,\n} from './client-renderer.js';\nexport type { ClientExperienceRendererProps as ExperienceRendererProps } from './client-renderer.js';\nexport type { ClientExperienceRendererProps } from './client-renderer.js';\n\nexport { ServerExperienceRenderer } from './server-renderer.js';\nexport type { ServerExperienceRendererProps } from './server-renderer.js';\n\nexport { MissingComponent } from './missing-component.js';\nexport type { MissingComponentProps } from './missing-component.js';\n\nexport { ComponentError } from './component-error.js';\nexport type { ComponentErrorProps } from './component-error.js';\n\nexport { DebugExperience } from './debug-experience.js';\nexport type { DebugExperienceProps } from './debug-experience.js';\n\nexport type { DiagnosticReporter, RenderError, RenderUnknown } from './nodes-renderer.js';\n\nexport { useLivePreviewExperience } from './use-live-preview-experience.js';\nexport type {\n  UseLivePreviewExperienceOptions,\n  UseLivePreviewExperienceResult,\n} from './use-live-preview-experience.js';\nexport { useLivePreview } from './use-live-preview.js';\nexport type { UseLivePreviewOptions, UseLivePreviewResult } from './use-live-preview.js';\n\nexport { useExperiencePlan } from './use-experience-plan.js';\nexport type {\n  ExperiencePlanResolveOptions,\n  UseExperiencePlanOptions,\n  UseExperiencePlanResult,\n} from './use-experience-plan.js';\nexport type {\n  LivePreviewClient,\n  LivePreviewResult,\n  PreviewSessionClientOptions,\n  PreviewSessionExperienceOptions,\n  PreviewSessionOptions,\n  PreviewSessionResolveOptions,\n} from '@contentful/experiences-live-preview';\nexport {\n  fetchPreviewSession,\n  LivePreviewConnectionError,\n  PREVIEW_WEBSOCKET_HOST,\n  PreviewSessionFetchError,\n} from '@contentful/experiences-live-preview';\n\n// ─── Runtime context hooks ───────────────────────────────────────────────\nexport {\n  useExperience,\n  useContentfulComponent,\n  useContentfulExperienceTemplate,\n} from './context.js';\nexport { useDesignValues } from './use-design-values.js';\nexport { toCss } from './design-utils.js';\nexport type { ToCssOptions } from './design-utils.js';\n\n// ─── Authoring helpers + Config types ─────────────────────────────────────\nexport {\n  defineComponent,\n  defineExperienceTemplate,\n  normalizeComponentRegistration,\n  normalizeExperienceTemplateRegistration,\n} from './types.js';\nexport type {\n  ComponentConfig,\n  Components,\n  Config,\n  ContentfulComponent,\n  ContentfulExperienceTemplate,\n  ExperienceTemplateConfig,\n  ExperienceTemplateRegistration,\n  ExperienceTemplates,\n  Registration,\n  RenderContext,\n  ResolveToken,\n} from './types.js';\n\n// ─── Resolver (re-exported from render-core) ──────────────────────────────\nexport { resolveExperience } from '@contentful/experiences-sdk-core';\nexport {\n  getTrackingAttributes,\n  TRACKING_CLICKABLE_ATTRIBUTE,\n  TRACKING_SCOPES_ATTRIBUTE,\n} from '@contentful/experiences-sdk-core';\nexport type { TrackingAttributes } from '@contentful/experiences-sdk-core';\nexport type { ResolverConfig, ResolveExperienceOptions } from '@contentful/experiences-sdk-core';\n\n// ─── Event builder (re-exported from runtime) ─────────────────────────────\nexport { DEFAULT_PAGE_PROPERTIES, EventBuilder } from '@contentful/experiences-runtime';\nexport type {\n  ClickBuilderArgs,\n  EventBuilderConfig,\n  FlagViewBuilderArgs,\n  HoverBuilderArgs,\n  IdentifyBuilderArgs,\n  InteractionBuilderArgsBase,\n  PageViewBuilderArgs,\n  TrackBuilderArgs,\n  UniversalEventBuilderArgs,\n  ViewBuilderArgs,\n} from '@contentful/experiences-runtime';\n\n// ─── Core IR + payload types (re-exported from render-core) ───────────────\nexport type {\n  ComponentNode,\n  ComponentRef,\n  DesignPropValue,\n  DesignToken,\n  ExperienceContext,\n  ExperienceNode,\n  ExperiencePayload,\n  ExperienceSourceMap,\n  ExperienceSys,\n  ExperienceTemplateNode,\n  ExperienceTemplateRef,\n  ManualDesignValue,\n  PortableRegistration,\n  PortableRenderNode,\n  PortableRenderPlan,\n  ResolveContext,\n} from '@contentful/experiences-sdk-core';\n\n// ─── Design utilities (re-exported from design) ───────────────────────────\nexport { CSS_PROPERTIES, isCssProperty, toCssKey } from '@contentful/experiences-design';\n\n// ─── Delivery client + fetchExperience ────────────────────────────────────\nexport {\n  ContentfulViewDelivery,\n  ContentfulViewDeliveryClient,\n  DELIVERY_HOST,\n  ExperienceFetchError,\n  NotFoundError,\n  PREVIEW_HOST,\n  createClient,\n  fetchExperience,\n  fetchDestinationSitemap,\n  readSourceMap,\n  toExperiencePayload,\n  toExperiencePayloadFromDestination,\n} from '@contentful/experiences-client';\nexport { ANONYMOUS_ID_COOKIE } from '@contentful/experiences-runtime';\nexport type {\n  ByDestinationNodeIdExperienceOptions,\n  ByDestinationPathExperienceOptions,\n  ByIdExperienceOptions,\n  ClientOptions,\n  CreateClientOptions,\n  DestinationRedirectResult,\n  DestinationSitemapResult,\n  ExperienceOptions,\n  ExperienceParameters,\n  ExperienceParameterValue,\n  ExperienceParameterRecord,\n  ExperienceParameterOrder,\n  ExperienceResponse,\n  FetchDestinationSitemapOptions,\n  FetchDestinationSitemapPaginationOptions,\n  ResolveOptions,\n  SitemapPathItem,\n} from '@contentful/experiences-client';\n"],"mappings":"AAeA;AAAA,EAC8B;AAAA,EAC5B,4BAAAA;AAAA,OACK;AAIP,SAAS,gCAAgC;AAGzC,SAAS,wBAAwB;AAGjC,SAAS,sBAAsB;AAG/B,SAAS,uBAAuB;AAKhC,SAAS,gCAAgC;AAKzC,SAAS,sBAAsB;AAG/B,SAAS,yBAAyB;AAclC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,uBAAuB;AAChC,SAAS,aAAa;AAItB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAgBP,SAAS,yBAAyB;AAClC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAKP,SAAS,yBAAyB,oBAAoB;AAmCtD,SAAS,gBAAgB,eAAe,gBAAgB;AAGxD;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,2BAA2B;","names":["ClientExperienceRenderer"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experiences-react",
-  "version": "0.14.0",
+  "version": "0.14.2",
   "description": "React adapter for Contentful Experiences — Server and Client renderers over a PortableRenderPlan",
   "license": "MIT",
   "type": "module",
@@ -30,11 +30,11 @@
     "directory": "packages/adapter-react"
   },
   "dependencies": {
-    "@contentful/experiences-client": "0.10.0",
-    "@contentful/experiences-runtime": "0.2.0",
-    "@contentful/experiences-sdk-core": "0.13.0",
-    "@contentful/experiences-design": "0.13.0",
-    "@contentful/experiences-live-preview": "0.7.0"
+    "@contentful/experiences-client": "0.10.2",
+    "@contentful/experiences-runtime": "0.2.2",
+    "@contentful/experiences-sdk-core": "0.13.1",
+    "@contentful/experiences-design": "0.13.1",
+    "@contentful/experiences-live-preview": "0.7.2"
   },
   "devDependencies": {
     "jsdom": "^30.0.1"