@contentful/experiences-svelte 0.4.1 → 0.5.0

package/CHANGELOG.md

@@ -1,3 +1,96 @@
+## 0.5.0 (2026-08-07)
+
+### 🩹 Fixes
+
+- ⚠️  bump @contentful/experience-delivery to 1.0.0-dev.6 + migrate to renamed API [AIS-339] ([#120](https://github.com/contentful/experiences/pull/120))
+
+### ⚠️  Breaking Changes
+
+- bump @contentful/experience-delivery to 1.0.0-dev.6 + migrate to renamed API [AIS-339]  ([#120](https://github.com/contentful/experiences/pull/120))
+  the public API uses the component / experienceTemplate vocabulary.
+  - `registration.componentTypeId` -> `registration.componentId`
+  - `plan.template` -> `plan.experienceTemplate`
+  - `PortableTemplate` -> `PortableExperienceTemplate` (`templateId` ->
+    `experienceTemplateId`)
+  - `Config.templates` -> `Config.experienceTemplates`; `Templates` ->
+    `ExperienceTemplates`
+  - `defineTemplate` -> `defineExperienceTemplate`; `TemplateConfig` ->
+    `ExperienceTemplateConfig`; `TemplateRegistration` ->
+    `ExperienceTemplateRegistration`; `normalizeTemplateRegistration` ->
+    `normalizeExperienceTemplateRegistration`
+  - `useContentfulTemplate()` / `getContentfulTemplate()` ->
+    `useContentfulExperienceTemplate()` / `getContentfulExperienceTemplate()`;
+    `ContentfulTemplate` -> `ContentfulExperienceTemplate`
+  - `MissingComponentProps.componentTypeId` -> `componentId`
+  - Core payload types: `ComponentTypeNode`/`ComponentTypeRef` ->
+    `ComponentNode`/`ComponentRef`; `TemplateNode`/`TemplateRef` ->
+    `ExperienceTemplateNode`/`ExperienceTemplateRef`
+  `packages/core` stays zero-dep, so its payload types are hand-mirrored from the
+  delivery package rather than imported; each carries a doc comment naming its
+  upstream counterpart, and `client:typecheck` catches drift when the delivery SDK
+  regenerates. Documented in AGENTS.md.
+  `examples/scripts/` is intentionally unchanged: it targets the management SDK
+  (`contentful-management`), which has its own entity-type surface, and adopting it
+  would require changing that dependency. The seed script therefore still
+  provisions the shapes that SDK produces.
+  Verified: build, typecheck, and 157 tests pass across all five packages.
+  Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
+  * docs: describe current state only in comments and docs
+  Drop ticket ids, tracker links, and before/after narrative from doc comments and
+  prose so they explain what the code does now rather than how it got here.
+  - `alpha-feature.ts`: state what the header selects and why it is required,
+    without the two-shapes-in-transition framing or the removal timeline.
+  - `core/src/types.ts`: keep each type's upstream counterpart in
+    `@contentful/experience-delivery` (load-bearing for maintenance) but drop the
+    "formerly known as" and old-link-type asides.
+  - README: replace the rename migration table with a description of the
+    alpha-feature header and when a caller needs to send it.
+  - AGENTS.md: reframe the rationale entries that opened on prior designs to state
+    the current design and its reason.
+  - Drop stale option-shape asides ("was nested under ...") and a test name that
+    described superseded behaviour.
+  Generated CHANGELOG.md files are untouched — they are release history.
+  Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
+  * feat!: migrate bootstrap fixture script to component/experienceTemplate entities
+  contentful-management@12.14.0 exposes the renamed ExO entities (Component,
+  ExperienceTemplate) alongside the deprecated ComponentType/Template ones. Adopt
+  the renamed shapes throughout examples/scripts so a freshly bootstrapped demo
+  Experience uses the same entity vocabulary the delivery-consuming packages now
+  read.
+  - Bump contentful-management to ^12.14.0 (existing dependency, version only —
+    no new packages).
+  - fixture/component-types.ts -> fixture/components.ts: ComponentTypeFixture ->
+    ComponentFixture.
+  - fixture/templates.ts -> fixture/experience-templates.ts:
+    TemplateFixture -> ExperienceTemplateFixture, TemplateTreeNode ->
+    ExperienceTemplateTreeNode.
+  - fixture/types.ts, fixture/experience.ts: ExperienceFixture.templateId ->
+    experienceTemplateId; node nodeType 'InlineFragment' ->
+    'InlineExperienceFragment' with componentTypeId -> componentId, matching
+    contentful-management's InlineExperienceFragmentNode.
+  - fixture/data-assemblies.ts: dataAssemblyComponentTypeLinks ->
+    dataAssemblyComponentLinks (componentTypeId -> componentId).
+  - bootstrap-example.ts: cma.componentType -> cma.component,
+    cma.template -> cma.experienceTemplate; sys.type 'ComponentType' ->
+    'Component', 'Template' -> 'ExperienceTemplate'; resource-link types
+    Contentful:ComponentType -> Contentful:Component and Contentful:Template ->
+    Contentful:ExperienceTemplate; URN segments components/ and
+    experienceTemplates/; seedComponentType -> seedComponent, seedTemplate ->
+    seedExperienceTemplate, linkDataAssembliesToComponentTypes ->
+    linkDataAssembliesToComponents.
+  The metadata.annotations.Template composed/coded-implementation marker is
+  unrelated to this rename (identical shape in 12.10.0 and 12.14.0) and is left
+  untouched.
+  Verified: examples/scripts typechecks clean; the main workspace's build,
+  typecheck, and 157 tests are unaffected.
+  Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
+
+### 🧱 Updated Dependencies
+
+- Updated client to 0.3.0
+- Updated design to 0.7.0
+- Updated core to 0.7.0
+
 ## 0.4.1 (2026-08-06)
 
 ### 🧱 Updated Dependencies

package/README.md

@@ -20,7 +20,7 @@ The public API mirrors `@contentful/experiences-react` 1:1 in shape; only the re
 
 ```ts
 defineComponent<Props>(config); // Type-narrowing identity for component-type configs
-defineTemplate<Props>(config); // Same shape, for page-level template wrappers
+defineExperienceTemplate<Props>(config); // Same shape, for page-level Experience Template wrappers
 ```
 
 ### Resolver
@@ -46,7 +46,7 @@ getDesignValues<T>(); // Resolved design values for the current node; read in a
 toCss(design, options?); // Turns a design record into a plain style object, keeping only real CSS keys
 getExperience(); // RenderContext: debug, metadata, viewports, activeViewport
 getContentfulComponent(); // Raw payload for the enclosing node (or undefined)
-getContentfulTemplate(); // Same, for the page-level template
+getContentfulExperienceTemplate(); // Same, for the page-level Experience Template
 type ToCssOptions;
 ```
 
@@ -56,12 +56,12 @@ Design is **not** injected as props; components read it via `getDesignValues()`
 
 ```ts
 // From core
-type Config, Components, Templates, Registration, TemplateRegistration,
-type ComponentConfig, TemplateConfig,
-type ContentfulComponent, ContentfulTemplate,
+type Config, Components, ExperienceTemplates, Registration, ExperienceTemplateRegistration,
+type ComponentConfig, ExperienceTemplateConfig,
+type ContentfulComponent, ContentfulExperienceTemplate,
 type RenderContext, ResolveToken,
-type ExperiencePayload, ExperienceNode, ComponentTypeNode, TemplateNode,
-type PortableRenderPlan, PortableRenderNode, PortableTemplate,
+type ExperiencePayload, ExperienceNode, ComponentNode, ExperienceTemplateNode,
+type PortableRenderPlan, PortableRenderNode, PortableExperienceTemplate,
 type DesignPropValue, ManualDesignValue, DesignToken, ValuesByViewport,
 type ViewportDef, ExperienceContext, ResolveContext,
 type ResolverConfig, ResolveExperienceOptions

package/dist/ClientExperienceRenderer.svelte

@@ -14,7 +14,7 @@
   import DebugExperience from './DebugExperience.svelte';
   import MissingComponent from './MissingComponent.svelte';
   import NodesRenderer from './NodesRenderer.svelte';
-  import WrapWithTemplate from './WrapWithTemplate.svelte';
+  import WrapWithExperienceTemplate from './WrapWithExperienceTemplate.svelte';
   import type { ClientExperienceRendererProps } from './component-props.js';
   import { setExperience } from './context.js';
   import type { RenderContext } from './types.js';
@@ -73,7 +73,7 @@
   {#if debug}
     <DebugExperience {experience} />
   {/if}
-  <WrapWithTemplate template={experience.template} {config} experience={liveContext}>
+  <WrapWithExperienceTemplate experienceTemplate={experience.experienceTemplate} {config} experience={liveContext}>
     {#snippet children()}
       <NodesRenderer
         nodes={experience.nodes}
@@ -82,5 +82,5 @@
         {renderUnknown}
       />
     {/snippet}
-  </WrapWithTemplate>
+  </WrapWithExperienceTemplate>
 {/if}

package/dist/DebugExperience.svelte

@@ -19,7 +19,9 @@
   const nodeCount = $derived(experience.nodes.length);
   const summary = $derived(
     `Experience debug — ${nodeCount} top-level node${nodeCount === 1 ? '' : 's'}${
-      experience.template ? `, template: ${experience.template.templateId}` : ''
+      experience.experienceTemplate
+        ? `, experience template: ${experience.experienceTemplate.experienceTemplateId}`
+        : ''
     }`
   );
 

package/dist/DebugExperience.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DebugExperience.svelte.d.ts","sourceRoot":"","sources":["../src/DebugExperience.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAmDjE,QAAA,MAAM,eAAe,0DAAwC,CAAC;AAC9D,KAAK,eAAe,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAC1D,eAAe,eAAe,CAAC"}
+{"version":3,"file":"DebugExperience.svelte.d.ts","sourceRoot":"","sources":["../src/DebugExperience.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAqDjE,QAAA,MAAM,eAAe,0DAAwC,CAAC;AAC9D,KAAK,eAAe,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAC1D,eAAe,eAAe,CAAC"}

package/dist/DebugExperience.test.js

@@ -2,9 +2,9 @@ import { render } from '@testing-library/svelte';
 import { describe, expect, it } from 'vitest';
 import DebugExperience from './DebugExperience.svelte';
 const emptyPlan = { nodes: [], viewports: [] };
-function node(componentTypeId, content = {}) {
+function node(componentId, content = {}) {
     return {
-        registration: { componentTypeId },
+        registration: { componentId },
         props: { content, design: {} },
         slots: {},
     };
@@ -29,14 +29,14 @@ describe('DebugExperience.svelte', () => {
         const { container } = render(DebugExperience, { props: { experience: one } });
         expect(container.innerHTML).toContain('Experience debug — 1 top-level node');
     });
-    it('names the template in the summary when present', () => {
+    it('names the experienceTemplate in the summary when present', () => {
         const plan = {
             viewports: [],
             nodes: [],
-            template: { templateId: 'page', props: { content: {}, design: {} } },
+            experienceTemplate: { experienceTemplateId: 'page', props: { content: {}, design: {} } },
         };
         const { container } = render(DebugExperience, { props: { experience: plan } });
-        expect(container.innerHTML).toContain('template: page');
+        expect(container.innerHTML).toContain('experience template: page');
     });
     it('dumps the plan as pretty JSON', () => {
         const plan = {
@@ -44,7 +44,7 @@ describe('DebugExperience.svelte', () => {
             nodes: [node('button', { label: 'Go' })],
         };
         const { container } = render(DebugExperience, { props: { experience: plan } });
-        expect(container.innerHTML).toContain('componentTypeId');
+        expect(container.innerHTML).toContain('componentId');
         expect(container.innerHTML).toContain('button');
         expect(container.innerHTML).toContain('Go');
     });

package/dist/MissingComponent.svelte

@@ -1,5 +1,5 @@
 <!--
- * Default fallback rendered when an instance references a component type
+ * Default fallback rendered when an instance references a component
  * not present in the Config.
  *
  * Behavior: a visible debug box when `debug` is on, silent null otherwise.
@@ -10,14 +10,14 @@
   import type { MissingComponentProps } from './component-props.js';
   import { getExperience } from './context.js';
 
-  let { componentTypeId, nodeId }: MissingComponentProps = $props();
+  let { componentId, nodeId }: MissingComponentProps = $props();
   const experience = getExperience();
 
   $effect(() => {
     if (typeof console !== 'undefined') {
       const idLabel = nodeId ? ` (nodeId: ${nodeId})` : '';
       console.warn(
-        `[@contentful/experiences] No component registered for type "${componentTypeId}"${idLabel}.`
+        `[@contentful/experiences] No component registered for id "${componentId}"${idLabel}.`
       );
     }
   });
@@ -26,15 +26,15 @@
 {#if experience.debug}
   <div
     style="border: 2px solid red; padding: 1rem; color: red; background: #fff; font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: 0.8125rem;"
-    data-experiences-missing={componentTypeId}
+    data-experiences-missing={componentId}
   >
-    <strong>Missing component &lsquo;{componentTypeId}&rsquo;</strong>
+    <strong>Missing component &lsquo;{componentId}&rsquo;</strong>
     <p style="margin: 0.5rem 0;">
       This component is referenced by the Experience payload but is not registered in the Config.
       Register it under this key in your <code>components</code> map:
     </p>
     <pre style="margin: 0; white-space: pre-wrap;">{JSON.stringify(
-        { componentTypeId, nodeId: nodeId ?? null },
+        { componentId, nodeId: nodeId ?? null },
         null,
         2
       )}</pre>

package/dist/NodeRenderer.svelte

@@ -28,11 +28,11 @@
 
   let { node, config, experience, renderUnknown, children }: NodeRendererProps = $props();
 
-  const entry = $derived(config.components[node.registration.componentTypeId]);
+  const entry = $derived(config.components[node.registration.componentId]);
   const componentConfig = $derived(entry ? normalizeComponentRegistration(entry) : null);
 
   const contentful: ContentfulComponent = {
-    componentTypeId: node.registration.componentTypeId,
+    componentId: node.registration.componentId,
     nodeId: node.nodeId,
     content: node.props.content,
     design: node.props.design,
@@ -52,7 +52,7 @@
     const { props, unresolved } = applyTokenResolver(resolvedDesign, config.resolveToken);
     if (unresolved.length && typeof console !== 'undefined') {
       console.warn(
-        `[@contentful/experiences-svelte] resolveToken returned undefined for token id(s) on "${node.registration.componentTypeId}": ${unresolved.join(', ')}. getDesignValues() will omit those keys.`
+        `[@contentful/experiences-svelte] resolveToken returned undefined for token id(s) on "${node.registration.componentId}": ${unresolved.join(', ')}. getDesignValues() will omit those keys.`
       );
     }
     return props;
@@ -77,7 +77,7 @@
 {:else}
   {@const Unknown = renderUnknown}
   <Unknown
-    componentTypeId={node.registration.componentTypeId}
+    componentId={node.registration.componentId}
     nodeId={node.nodeId}
   />
 {/if}

package/dist/ServerExperienceRenderer.svelte

@@ -14,7 +14,7 @@
   import DebugExperience from './DebugExperience.svelte';
   import MissingComponent from './MissingComponent.svelte';
   import NodesRenderer from './NodesRenderer.svelte';
-  import WrapWithTemplate from './WrapWithTemplate.svelte';
+  import WrapWithExperienceTemplate from './WrapWithExperienceTemplate.svelte';
   import type { ServerExperienceRendererProps } from './component-props.js';
   import { setExperience } from './context.js';
   import type { RenderContext } from './types.js';
@@ -62,7 +62,7 @@
   {#if debug}
     <DebugExperience {experience} />
   {/if}
-  <WrapWithTemplate template={experience.template} {config} experience={renderContext}>
+  <WrapWithExperienceTemplate experienceTemplate={experience.experienceTemplate} {config} experience={renderContext}>
     {#snippet children()}
       <NodesRenderer
         nodes={experience.nodes}
@@ -71,5 +71,5 @@
         {renderUnknown}
       />
     {/snippet}
-  </WrapWithTemplate>
+  </WrapWithExperienceTemplate>
 {/if}

package/dist/WrapWithExperienceTemplate.svelte

@@ -0,0 +1,87 @@
+<!--
+ * Wraps the rendered Experience nodes with the page-level Experience Template when the
+ * plan carries one and the customer registered an Experience Template config under that
+ * id. When the Experience Template is referenced but unregistered, warns once and
+ * renders children unwrapped — graceful degradation matches the
+ * unknown-component fallback story.
+-->
+<script lang="ts">
+  import type { Snippet } from 'svelte';
+
+  import type { PortableExperienceTemplate } from '@contentful/experiences-sdk-core';
+  import { applyTokenResolver, resolveDesignProperties } from '@contentful/experiences-design';
+
+  import { setContentfulExperienceTemplate, setResolvedDesign } from './context.js';
+  import {
+    normalizeExperienceTemplateRegistration,
+    type ContentfulExperienceTemplate,
+    type Config,
+    type RenderContext,
+  } from './types.js';
+
+  interface WrapWithExperienceTemplateProps {
+    experienceTemplate: PortableExperienceTemplate | undefined;
+    config: Config;
+    experience: RenderContext;
+    children: Snippet;
+  }
+
+  let { experienceTemplate, config, experience, children }: WrapWithExperienceTemplateProps = $props();
+
+  // setContext must run during synchronous component init — call once with
+  // the initial value (Experience Templates do not toggle on/off mid-mount).
+  if (experienceTemplate) {
+    setContentfulExperienceTemplate({
+      experienceTemplateId: experienceTemplate.experienceTemplateId,
+      content: experienceTemplate.props.content,
+      design: experienceTemplate.props.design,
+      resolved: experienceTemplate.props.resolved,
+    } satisfies ContentfulExperienceTemplate);
+  }
+
+  const entry = $derived(experienceTemplate ? config.experienceTemplates?.[experienceTemplate.experienceTemplateId] : undefined);
+  const experienceTemplateConfig = $derived(entry ? normalizeExperienceTemplateRegistration(entry) : null);
+
+  const tokenResolvedDesign = $derived.by(() => {
+    if (!experienceTemplate) return {};
+    const resolvedDesign = resolveDesignProperties(
+      experienceTemplate.props.design,
+      experience.viewports,
+      experience.activeViewportIndex
+    );
+    const { props, unresolved } = applyTokenResolver(resolvedDesign, config.resolveToken);
+    if (unresolved.length && typeof console !== 'undefined') {
+      console.warn(
+        `[@contentful/experiences-svelte] resolveToken returned undefined for token id(s) on experience template "${experienceTemplate.experienceTemplateId}": ${unresolved.join(', ')}. getDesignValues() will omit those keys.`
+      );
+    }
+    return props;
+  });
+
+  // A getter (not a snapshot) so getDesignValues() stays reactive; not merged into props.
+  setResolvedDesign(() => tokenResolvedDesign);
+
+  const composed = $derived.by(() => {
+    if (!experienceTemplate || !experienceTemplateConfig) return null;
+    return {
+      ...experienceTemplateConfig.defaults,
+      ...experienceTemplate.props.content,
+      ...experienceTemplate.props.resolved,
+    };
+  });
+
+  $effect(() => {
+    if (experienceTemplate && !experienceTemplateConfig && typeof console !== 'undefined') {
+      console.warn(
+        `[@contentful/experiences-svelte] No experience template registered for id "${experienceTemplate.experienceTemplateId}". Rendering nodes without the experience template wrapper.`
+      );
+    }
+  });
+</script>
+
+{#if experienceTemplate && experienceTemplateConfig && composed}
+  {@const Tpl = experienceTemplateConfig.component}
+  <Tpl {...composed} {children} />
+{:else}
+  {@render children()}
+{/if}

package/dist/WrapWithExperienceTemplate.svelte.d.ts

@@ -0,0 +1,13 @@
+import type { Snippet } from 'svelte';
+import type { PortableExperienceTemplate } from '@contentful/experiences-sdk-core';
+import { type Config, type RenderContext } from './types.js';
+interface WrapWithExperienceTemplateProps {
+    experienceTemplate: PortableExperienceTemplate | undefined;
+    config: Config;
+    experience: RenderContext;
+    children: Snippet;
+}
+declare const WrapWithExperienceTemplate: import("svelte").Component<WrapWithExperienceTemplateProps, {}, "">;
+type WrapWithExperienceTemplate = ReturnType<typeof WrapWithExperienceTemplate>;
+export default WrapWithExperienceTemplate;
+//# sourceMappingURL=WrapWithExperienceTemplate.svelte.d.ts.map

package/dist/WrapWithExperienceTemplate.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WrapWithExperienceTemplate.svelte.d.ts","sourceRoot":"","sources":["../src/WrapWithExperienceTemplate.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAInF,OAAO,EAGH,KAAK,MAAM,EACX,KAAK,aAAa,EACnB,MAAM,YAAY,CAAC;AAGpB,UAAU,+BAA+B;IACvC,kBAAkB,EAAE,0BAA0B,GAAG,SAAS,CAAC;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,aAAa,CAAC;IAC1B,QAAQ,EAAE,OAAO,CAAC;CACnB;AA0EH,QAAA,MAAM,0BAA0B,qEAAwC,CAAC;AACzE,KAAK,0BAA0B,GAAG,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAChF,eAAe,0BAA0B,CAAC"}

package/dist/component-props.d.ts

@@ -20,7 +20,7 @@ export interface ServerExperienceRendererProps {
 }
 export type ClientExperienceRendererProps = ServerExperienceRendererProps;
 export interface MissingComponentProps {
-    componentTypeId: string;
+    componentId: string;
     /** Optional — only present when the payload supplied an id for this node. */
     nodeId?: string;
 }

package/dist/component-props.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component-props.d.ts","sourceRoot":"","sources":["../src/component-props.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAExC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAE3E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,MAAM,WAAW,6BAA6B;IAC5C,UAAU,EAAE,kBAAkB,GAAG,IAAI,GAAG,SAAS,CAAC;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,MAAM,MAAM,6BAA6B,GAAG,6BAA6B,CAAC;AAE1E,MAAM,WAAW,qBAAqB;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,aAAa,GAAG,SAAS,CAAC,qBAAqB,CAAC,CAAC;AAE7D,MAAM,WAAW,oBAAoB;IACnC,+EAA+E;IAC/E,UAAU,EAAE,kBAAkB,CAAC;IAC/B,oEAAoE;IACpE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB"}
+{"version":3,"file":"component-props.d.ts","sourceRoot":"","sources":["../src/component-props.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAExC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAE3E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,MAAM,WAAW,6BAA6B;IAC5C,UAAU,EAAE,kBAAkB,GAAG,IAAI,GAAG,SAAS,CAAC;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,MAAM,MAAM,6BAA6B,GAAG,6BAA6B,CAAC;AAE1E,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,aAAa,GAAG,SAAS,CAAC,qBAAqB,CAAC,CAAC;AAE7D,MAAM,WAAW,oBAAoB;IACnC,+EAA+E;IAC/E,UAAU,EAAE,kBAAkB,CAAC;IAC/B,oEAAoE;IACpE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB"}

package/dist/context.d.ts

@@ -1,19 +1,20 @@
-import type { ContentfulComponent, ContentfulTemplate, RenderContext } from './types.js';
+import type { ContentfulComponent, ContentfulExperienceTemplate, RenderContext } from './types.js';
 export declare function setExperience(ctx: RenderContext): void;
 export declare function setContentfulComponent(node: ContentfulComponent): void;
-export declare function setContentfulTemplate(tpl: ContentfulTemplate): void;
+export declare function setContentfulExperienceTemplate(tpl: ContentfulExperienceTemplate): void;
 /**
- * Publish the resolved design values for the enclosing node/template. Takes a
+ * Publish the resolved design values for the enclosing node or experience template. Takes a
  * getter (not a snapshot) so callers reading it inside a `$derived` stay
  * reactive across viewport changes.
  */
 export declare function setResolvedDesign(getDesign: () => Record<string, unknown>): void;
 export declare function getExperience(): RenderContext;
 export declare function getContentfulComponent(): ContentfulComponent | undefined;
-export declare function getContentfulTemplate(): ContentfulTemplate | undefined;
+export declare function getContentfulExperienceTemplate(): ContentfulExperienceTemplate | undefined;
 /**
  * Read the design values the renderer resolved for the enclosing node or
- * template. Returns `undefined` outside a rendered node/template, which
+ * experience template. Returns `undefined` outside a rendered node or
+ * experience template, which
  * `getDesignValues` treats as "nothing to read."
  */
 export declare function getResolvedDesign(): Record<string, unknown> | undefined;

package/dist/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAOzF,wBAAgB,aAAa,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAEtD;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAEtE;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,kBAAkB,GAAG,IAAI,CAEnE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAEhF;AAED,wBAAgB,aAAa,IAAI,aAAa,CAQ7C;AAED,wBAAgB,sBAAsB,IAAI,mBAAmB,GAAG,SAAS,CAExE;AAED,wBAAgB,qBAAqB,IAAI,kBAAkB,GAAG,SAAS,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAGvE"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,mBAAmB,EAAE,4BAA4B,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AASnG,wBAAgB,aAAa,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAEtD;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAEtE;AAED,wBAAgB,+BAA+B,CAAC,GAAG,EAAE,4BAA4B,GAAG,IAAI,CAEvF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAEhF;AAED,wBAAgB,aAAa,IAAI,aAAa,CAQ7C;AAED,wBAAgB,sBAAsB,IAAI,mBAAmB,GAAG,SAAS,CAExE;AAED,wBAAgB,+BAA+B,IAAI,4BAA4B,GAAG,SAAS,CAE1F;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAGvE"}

package/dist/context.js

@@ -18,7 +18,7 @@
 import { getContext, setContext } from 'svelte';
 const EXPERIENCE_KEY = Symbol('@contentful/experiences-svelte::experience');
 const COMPONENT_KEY = Symbol('@contentful/experiences-svelte::contentful-component');
-const TEMPLATE_KEY = Symbol('@contentful/experiences-svelte::contentful-template');
+const EXPERIENCE_TEMPLATE_KEY = Symbol('@contentful/experiences-svelte::contentful-experience-template');
 const RESOLVED_DESIGN_KEY = Symbol('@contentful/experiences-svelte::resolved-design');
 export function setExperience(ctx) {
     setContext(EXPERIENCE_KEY, ctx);
@@ -26,11 +26,11 @@ export function setExperience(ctx) {
 export function setContentfulComponent(node) {
     setContext(COMPONENT_KEY, node);
 }
-export function setContentfulTemplate(tpl) {
-    setContext(TEMPLATE_KEY, tpl);
+export function setContentfulExperienceTemplate(tpl) {
+    setContext(EXPERIENCE_TEMPLATE_KEY, tpl);
 }
 /**
- * Publish the resolved design values for the enclosing node/template. Takes a
+ * Publish the resolved design values for the enclosing node or experience template. Takes a
  * getter (not a snapshot) so callers reading it inside a `$derived` stay
  * reactive across viewport changes.
  */
@@ -47,12 +47,13 @@ export function getExperience() {
 export function getContentfulComponent() {
     return getContext(COMPONENT_KEY);
 }
-export function getContentfulTemplate() {
-    return getContext(TEMPLATE_KEY);
+export function getContentfulExperienceTemplate() {
+    return getContext(EXPERIENCE_TEMPLATE_KEY);
 }
 /**
  * Read the design values the renderer resolved for the enclosing node or
- * template. Returns `undefined` outside a rendered node/template, which
+ * experience template. Returns `undefined` outside a rendered node or
+ * experience template, which
  * `getDesignValues` treats as "nothing to read."
  */
 export function getResolvedDesign() {

package/dist/index.d.ts

@@ -6,17 +6,17 @@ export { default as DebugExperience } from './DebugExperience.svelte';
 export { default as NodesRenderer } from './NodesRenderer.svelte';
 export { useActiveViewport } from './use-active-viewport.svelte.js';
 export type { UseActiveViewportResult } from './use-active-viewport.svelte.js';
-export { getExperience, getContentfulComponent, getContentfulTemplate } from './context.js';
+export { getExperience, getContentfulComponent, getContentfulExperienceTemplate, } from './context.js';
 export { getDesignValues } from './get-design-values.js';
 export { toCss } from './design-utils.js';
 export type { ToCssOptions } from './design-utils.js';
 export type { ClientExperienceRendererProps, ClientExperienceRendererProps as ExperienceRendererProps, DebugExperienceProps, MissingComponentProps, RenderUnknown, ServerExperienceRendererProps, } from './component-props.js';
-export { defineComponent, defineTemplate, normalizeComponentRegistration, normalizeTemplateRegistration, } from './types.js';
-export type { ComponentConfig, Components, Config, ContentfulComponent, ContentfulTemplate, Registration, RenderContext, ResolveToken, TemplateConfig, TemplateRegistration, Templates, } from './types.js';
+export { defineComponent, defineExperienceTemplate, normalizeComponentRegistration, normalizeExperienceTemplateRegistration, } from './types.js';
+export type { ComponentConfig, Components, Config, ContentfulComponent, ContentfulExperienceTemplate, ExperienceTemplateConfig, ExperienceTemplateRegistration, ExperienceTemplates, Registration, RenderContext, ResolveToken, } from './types.js';
 export { resolveExperience } from '@contentful/experiences-sdk-core';
 export type { ResolverConfig, ResolveExperienceOptions } from '@contentful/experiences-sdk-core';
-export type { ComponentTypeNode, ComponentTypeRef, DesignPropValue, DesignToken, ExperienceContext, ExperienceNode, ExperiencePayload, ExperienceSys, ManualDesignValue, PortableRegistration, PortableRenderNode, PortableRenderPlan, PortableTemplate, ResolveContext, TemplateNode, TemplateRef, ValuesByViewport, ViewportDef, } from '@contentful/experiences-sdk-core';
+export type { ComponentNode, ComponentRef, DesignPropValue, DesignToken, ExperienceContext, ExperienceNode, ExperiencePayload, ExperienceSys, ExperienceTemplateNode, ExperienceTemplateRef, ManualDesignValue, PortableExperienceTemplate, PortableRegistration, PortableRenderNode, PortableRenderPlan, ResolveContext, ValuesByViewport, ViewportDef, } from '@contentful/experiences-sdk-core';
 export { CSS_PROPERTIES, getValueForViewport, getViewportIndex, isCssProperty, resolveDesignProperties, toCssKey, toCssMediaQuery, } from '@contentful/experiences-design';
-export { ContentfulViewDelivery, ContentfulViewDeliveryClient, DELIVERY_HOST, NotFoundError, PREVIEW_HOST, createClient, fetchExperience, } from '@contentful/experiences-client';
+export { ALPHA_FEATURE_HEADER, ContentfulViewDelivery, ContentfulViewDeliveryClient, DELIVERY_HOST, NEW_EXO_ENTITY_TYPES, NEW_EXO_ENTITY_TYPES_HEADERS, NotFoundError, PREVIEW_HOST, createClient, fetchExperience, } from '@contentful/experiences-client';
 export type { ClientOptions, CreateClientOptions, ExperienceOptions, ResolveOptions, } from '@contentful/experiences-client';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AACxF,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAClF,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AACxF,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAItE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAElE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,YAAY,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAG/E,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAItD,YAAY,EACV,6BAA6B,EAC7B,6BAA6B,IAAI,uBAAuB,EACxD,oBAAoB,EACpB,qBAAqB,EACrB,aAAa,EACb,6BAA6B,GAC9B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,eAAe,EACf,cAAc,EACd,8BAA8B,EAC9B,6BAA6B,GAC9B,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,eAAe,EACf,UAAU,EACV,MAAM,EACN,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,SAAS,GACV,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,YAAY,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAGjG,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,WAAW,GACZ,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,uBAAuB,EACvB,QAAQ,EACR,eAAe,GAChB,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EACL,sBAAsB,EACtB,4BAA4B,EAC5B,aAAa,EACb,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,eAAe,GAChB,MAAM,gCAAgC,CAAC;AACxC,YAAY,EACV,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,GACf,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AACxF,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAClF,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AACxF,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAItE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAElE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,YAAY,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAG/E,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,+BAA+B,GAChC,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAItD,YAAY,EACV,6BAA6B,EAC7B,6BAA6B,IAAI,uBAAuB,EACxD,oBAAoB,EACpB,qBAAqB,EACrB,aAAa,EACb,6BAA6B,GAC9B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,eAAe,EACf,wBAAwB,EACxB,8BAA8B,EAC9B,uCAAuC,GACxC,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,eAAe,EACf,UAAU,EACV,MAAM,EACN,mBAAmB,EACnB,4BAA4B,EAC5B,wBAAwB,EACxB,8BAA8B,EAC9B,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,YAAY,GACb,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,YAAY,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAGjG,YAAY,EACV,aAAa,EACb,YAAY,EACZ,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,EACjB,0BAA0B,EAC1B,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,WAAW,GACZ,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,uBAAuB,EACvB,QAAQ,EACR,eAAe,GAChB,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,4BAA4B,EAC5B,aAAa,EACb,oBAAoB,EACpB,4BAA4B,EAC5B,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,eAAe,GAChB,MAAM,gCAAgC,CAAC;AACxC,YAAY,EACV,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,GACf,MAAM,gCAAgC,CAAC"}

package/dist/index.js

@@ -22,14 +22,14 @@ export { default as DebugExperience } from './DebugExperience.svelte';
 export { default as NodesRenderer } from './NodesRenderer.svelte';
 export { useActiveViewport } from './use-active-viewport.svelte.js';
 // ─── Runtime context helpers ─────────────────────────────────────────────
-export { getExperience, getContentfulComponent, getContentfulTemplate } from './context.js';
+export { getExperience, getContentfulComponent, getContentfulExperienceTemplate, } from './context.js';
 export { getDesignValues } from './get-design-values.js';
 export { toCss } from './design-utils.js';
 // ─── Authoring helpers + Config types ─────────────────────────────────────
-export { defineComponent, defineTemplate, normalizeComponentRegistration, normalizeTemplateRegistration, } from './types.js';
+export { defineComponent, defineExperienceTemplate, normalizeComponentRegistration, normalizeExperienceTemplateRegistration, } from './types.js';
 // ─── Resolver (re-exported from render-core) ──────────────────────────────
 export { resolveExperience } from '@contentful/experiences-sdk-core';
 // ─── Design utilities (re-exported from design) ───────────────────────────
 export { CSS_PROPERTIES, getValueForViewport, getViewportIndex, isCssProperty, resolveDesignProperties, toCssKey, toCssMediaQuery, } from '@contentful/experiences-design';
 // ─── Delivery client + fetchExperience ────────────────────────────────────
-export { ContentfulViewDelivery, ContentfulViewDeliveryClient, DELIVERY_HOST, NotFoundError, PREVIEW_HOST, createClient, fetchExperience, } from '@contentful/experiences-client';
+export { ALPHA_FEATURE_HEADER, ContentfulViewDelivery, ContentfulViewDeliveryClient, DELIVERY_HOST, NEW_EXO_ENTITY_TYPES, NEW_EXO_ENTITY_TYPES_HEADERS, NotFoundError, PREVIEW_HOST, createClient, fetchExperience, } from '@contentful/experiences-client';

package/dist/server-renderer.test.js

@@ -8,7 +8,7 @@ import ContainerFixture from './test-fixtures/ContainerFixture.svelte';
 import HeadingFixture from './test-fixtures/HeadingFixture.svelte';
 import ItemFixture from './test-fixtures/ItemFixture.svelte';
 import PrecedenceFixture from './test-fixtures/PrecedenceFixture.svelte';
-import TemplateFixture from './test-fixtures/TemplateFixture.svelte';
+import ExperienceTemplateFixture from './test-fixtures/ExperienceTemplateFixture.svelte';
 import { captureSink } from './test-fixtures/capture-sink.js';
 import { toCss } from './design-utils.js';
 const VIEWPORTS = [
@@ -24,11 +24,11 @@ const vbv = (values) => ({
 const dt = (value) => ({ type: 'DesignToken', value });
 function componentNode(typeId, rest = {}) {
     return {
-        componentType: {
+        component: {
             sys: {
                 type: 'ResourceLink',
-                linkType: 'Contentful:ComponentType',
-                urn: `crn:contentful:::experience:spaces/$self/environments/$self/componentTypes/${typeId}`,
+                linkType: 'Contentful:Component',
+                urn: `crn:contentful:::experience:spaces/$self/environments/$self/components/${typeId}`,
             },
         },
         ...rest,
@@ -156,13 +156,13 @@ describe('ServerExperienceRenderer', () => {
             nodes: [
                 {
                     nodeId: 'root',
-                    registration: { componentTypeId: 'contentful-container' },
+                    registration: { componentId: 'contentful-container' },
                     props: { content: {}, design: {} },
                     slots: {
                         children: [
                             {
                                 nodeId: 'ghost',
-                                registration: { componentTypeId: 'NotRegistered' },
+                                registration: { componentId: 'NotRegistered' },
                                 props: { content: {}, design: {} },
                                 slots: {},
                             },
@@ -244,7 +244,7 @@ describe('ServerExperienceRenderer', () => {
             nodes: [
                 {
                     nodeId: 'r',
-                    registration: { componentTypeId: 'item' },
+                    registration: { componentId: 'item' },
                     props: {
                         content: { value: 'fromContent' },
                         design: {},
@@ -259,20 +259,20 @@ describe('ServerExperienceRenderer', () => {
         });
         expect(container.innerHTML).toContain('data-value="fromResolveData"');
     });
-    it('wraps rendered nodes with the registered template', async () => {
+    it('wraps rendered nodes with the registered experienceTemplate', async () => {
         const tplConfig = {
             components: { item: PrecedenceFixture },
-            templates: {
-                page: { component: TemplateFixture, defaults: { title: 'Default Title' } },
+            experienceTemplates: {
+                page: { component: ExperienceTemplateFixture, defaults: { title: 'Default Title' } },
             },
         };
         const tplPayload = {
             sys: {
-                template: {
+                experienceTemplate: {
                     sys: {
                         type: 'ResourceLink',
-                        linkType: 'Contentful:Template',
-                        urn: 'crn:contentful:::experience:spaces/$self/environments/$self/templates/page',
+                        linkType: 'Contentful:ExperienceTemplate',
+                        urn: 'crn:contentful:::experience:spaces/$self/environments/$self/experienceTemplates/page',
                     },
                 },
             },
@@ -283,20 +283,20 @@ describe('ServerExperienceRenderer', () => {
         const { container } = render(ServerExperienceRenderer, {
             props: { experience: plan, config: tplConfig },
         });
-        expect(container.innerHTML).toContain('data-template="page"');
+        expect(container.innerHTML).toContain('data-experience-template="page"');
         expect(container.innerHTML).toContain('data-title="Default Title"');
         expect(container.innerHTML).toContain('inside');
     });
-    it('renders nodes unwrapped + warns when the template is not registered', async () => {
+    it('renders nodes unwrapped + warns when the experienceTemplate is not registered', async () => {
         const warn = vi.spyOn(console, 'warn').mockImplementation(() => { });
         const cfg = { components: { item: PrecedenceFixture } };
         const tplPayload = {
             sys: {
-                template: {
+                experienceTemplate: {
                     sys: {
                         type: 'ResourceLink',
-                        linkType: 'Contentful:Template',
-                        urn: 'crn:contentful:::experience:spaces/$self/environments/$self/templates/missing-template',
+                        linkType: 'Contentful:ExperienceTemplate',
+                        urn: 'crn:contentful:::experience:spaces/$self/environments/$self/experienceTemplates/missing-experienceTemplate',
                     },
                 },
             },
@@ -308,8 +308,8 @@ describe('ServerExperienceRenderer', () => {
             props: { experience: plan, config: cfg },
         });
         expect(container.innerHTML).toContain('data-value="unwrapped"');
-        expect(container.innerHTML).not.toContain('data-template');
-        expect(warn).toHaveBeenCalledWith(expect.stringContaining('missing-template'));
+        expect(container.innerHTML).not.toContain('data-experience-template');
+        expect(warn).toHaveBeenCalledWith(expect.stringContaining('missing-experienceTemplate'));
         warn.mockRestore();
     });
 });
@@ -365,7 +365,7 @@ describe('ServerExperienceRenderer — getContentfulComponent()', () => {
         });
         const contentful = captureSink[0].contentful;
         expect(contentful).toMatchObject({
-            componentTypeId: 'capture',
+            componentId: 'capture',
             nodeId: 'btn-1',
             content: { label: 'Buy now' },
             design: { cfPadding: vbv({ desktop: m('40px') }) },
@@ -434,7 +434,7 @@ describe('ServerExperienceRenderer — resolveToken', () => {
         expect(warn).toHaveBeenCalledWith(expect.stringContaining('contentful-button'));
         warn.mockRestore();
     });
-    it('leaves envelopes untouched when no resolver is supplied (backward-compatible)', async () => {
+    it('leaves envelopes untouched when no resolver is supplied', async () => {
         const cfg = { components: { 'contentful-button': ButtonFixture } };
         const plan = await resolveExperience({
             viewports: VIEWPORTS,
@@ -454,19 +454,19 @@ describe('ServerExperienceRenderer — resolveToken', () => {
         // unchanged, so the customer can inspect it or resolve it themselves.
         expect(container.innerHTML).toContain('data-bg="[object Object]"');
     });
-    it('runs on page-level template design props too', async () => {
+    it('runs on page-level experienceTemplate design props too', async () => {
         const tplConfig = {
             components: { item: PrecedenceFixture },
-            templates: { page: TemplateFixture },
+            experienceTemplates: { page: ExperienceTemplateFixture },
             resolveToken: (ref) => (ref.value === 'brand/canvas' ? '#111827' : undefined),
         };
         const tplPayload = {
             sys: {
-                template: {
+                experienceTemplate: {
                     sys: {
                         type: 'ResourceLink',
-                        linkType: 'Contentful:Template',
-                        urn: 'crn:contentful:::experience:spaces/$self/environments/$self/templates/page',
+                        linkType: 'Contentful:ExperienceTemplate',
+                        urn: 'crn:contentful:::experience:spaces/$self/environments/$self/experienceTemplates/page',
                     },
                 },
             },
@@ -475,8 +475,8 @@ describe('ServerExperienceRenderer — resolveToken', () => {
         };
         const plan = await resolveExperience(tplPayload, tplConfig);
         // Templates don't carry design props in the current XDA payload shape;
-        // seed one on the resolved plan so we exercise the template path.
-        plan.template.props.design = { cfBackground: dt('brand/canvas') };
+        // seed one on the resolved plan so we exercise the experienceTemplate path.
+        plan.experienceTemplate.props.design = { cfBackground: dt('brand/canvas') };
         const { container } = render(ServerExperienceRenderer, {
             props: { experience: plan, config: tplConfig },
         });

package/dist/test-fixtures/{TemplateFixture.svelte → ExperienceTemplateFixture.svelte}

@@ -13,6 +13,6 @@
   const design = $derived(getDesignValues());
 </script>
 
-<main data-template="page" data-title={title} data-bg={design.cfBackground as string}>
+<main data-experience-template="page" data-title={title} data-bg={design.cfBackground as string}>
   {@render children()}
 </main>

package/dist/test-fixtures/ExperienceTemplateFixture.svelte.d.ts

@@ -0,0 +1,9 @@
+import type { Snippet } from 'svelte';
+type $$ComponentProps = {
+    title?: string;
+    children: Snippet;
+};
+declare const ExperienceTemplateFixture: import("svelte").Component<$$ComponentProps, {}, "">;
+type ExperienceTemplateFixture = ReturnType<typeof ExperienceTemplateFixture>;
+export default ExperienceTemplateFixture;
+//# sourceMappingURL=ExperienceTemplateFixture.svelte.d.ts.map

package/dist/test-fixtures/ExperienceTemplateFixture.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExperienceTemplateFixture.svelte.d.ts","sourceRoot":"","sources":["../../src/test-fixtures/ExperienceTemplateFixture.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAIrC,KAAK,gBAAgB,GAAI;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAmBJ,QAAA,MAAM,yBAAyB,sDAAwC,CAAC;AACxE,KAAK,yBAAyB,GAAG,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC9E,eAAe,yBAAyB,CAAC"}

package/dist/types.d.ts

@@ -5,7 +5,7 @@ export type { ResolveContext, ResolveToken };
  * The full Contentful-side payload for a single component instance, exposed
  * via `getContentfulComponent()` to any descendant of a rendered Experience
  * node. Useful for custom design-property resolution outside the SDK's
- * cascade, branching by `componentTypeId` in a generic wrapper, keying
+ * cascade, branching by `componentId` in a generic wrapper, keying
  * analytics on `nodeId`, rendering a raw-payload panel in preview, or
  * rendering non-`children` slots through the exported `<NodesRenderer />`.
  *
@@ -14,7 +14,7 @@ export type { ResolveContext, ResolveToken };
  * resolved values are what `getDesignValues()` returns.
  */
 export interface ContentfulComponent {
-    componentTypeId: string;
+    componentId: string;
     nodeId?: string;
     content: Record<string, unknown>;
     design: Record<string, DesignPropValue>;
@@ -28,11 +28,12 @@ export interface ContentfulComponent {
     slots: Record<string, unknown>;
 }
 /**
- * Same shape as `ContentfulComponent`, but for the page-level template.
- * Exposed via `getContentfulTemplate()` inside a template's component tree.
+ * Same shape as `ContentfulComponent`, but for the page-level Experience
+ * Template.
+ * Exposed via `getContentfulExperienceTemplate()` inside an Experience Template's component tree.
  */
-export interface ContentfulTemplate {
-    templateId: string;
+export interface ContentfulExperienceTemplate {
+    experienceTemplateId: string;
     content: Record<string, unknown>;
     design: Record<string, DesignPropValue>;
     resolved?: Record<string, unknown>;
@@ -68,19 +69,19 @@ export interface ComponentConfig<Props extends object = Record<string, unknown>>
  *   card:   defineComponent<CardProps>({ component: Card, resolveData: ... }),
  */
 export type Registration<Props extends object = Record<string, unknown>> = Component<any> | ComponentConfig<Props>;
-export interface TemplateConfig<Props extends object = Record<string, unknown>> {
+export interface ExperienceTemplateConfig<Props extends object = Record<string, unknown>> {
     defaults?: Partial<Props>;
     resolveData?: (ctx: ResolveContext) => Partial<Props> | Promise<Partial<Props>>;
     component: Component<any>;
 }
-export type TemplateRegistration<Props extends object = Record<string, unknown>> = Component<any> | TemplateConfig<Props>;
-export declare function defineTemplate<Props extends object = Record<string, unknown>>(config: TemplateConfig<Props>): TemplateConfig<Props>;
+export type ExperienceTemplateRegistration<Props extends object = Record<string, unknown>> = Component<any> | ExperienceTemplateConfig<Props>;
+export declare function defineExperienceTemplate<Props extends object = Record<string, unknown>>(config: ExperienceTemplateConfig<Props>): ExperienceTemplateConfig<Props>;
 export declare function defineComponent<Props extends object = Record<string, unknown>>(config: ComponentConfig<Props>): ComponentConfig<Props>;
 export type Components = Record<string, Registration<any>>;
-export type Templates = Record<string, TemplateRegistration<any>>;
+export type ExperienceTemplates = Record<string, ExperienceTemplateRegistration<any>>;
 export interface Config {
     components: Components;
-    templates?: Templates;
+    experienceTemplates?: ExperienceTemplates;
     /**
      * Resolves `DesignToken` envelopes to runtime values before they reach a
      * component. If omitted, envelopes pass through unchanged. See `ResolveToken`
@@ -95,5 +96,5 @@ export interface Config {
  * a `component` field, so `typeof` is enough to discriminate.
  */
 export declare function normalizeComponentRegistration<P extends object>(reg: Registration<P>): ComponentConfig<P>;
-export declare function normalizeTemplateRegistration<P extends object>(reg: TemplateRegistration<P>): TemplateConfig<P>;
+export declare function normalizeExperienceTemplateRegistration<P extends object>(reg: ExperienceTemplateRegistration<P>): ExperienceTemplateConfig<P>;
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -1,4 +1,4 @@
-export function defineTemplate(config) {
+export function defineExperienceTemplate(config) {
     return config;
 }
 export function defineComponent(config) {
@@ -17,7 +17,7 @@ export function normalizeComponentRegistration(reg) {
     }
     return reg;
 }
-export function normalizeTemplateRegistration(reg) {
+export function normalizeExperienceTemplateRegistration(reg) {
     if (typeof reg === 'function') {
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
         return { component: reg };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experiences-svelte",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "Svelte adapter for Contentful Experiences — Server and Client renderers over a PortableRenderPlan",
   "license": "MIT",
   "type": "module",
@@ -35,9 +35,9 @@
     "check": "svelte-check --tsconfig ./tsconfig.json"
   },
   "dependencies": {
-    "@contentful/experiences-client": "0.2.1",
-    "@contentful/experiences-sdk-core": "0.6.1",
-    "@contentful/experiences-design": "0.6.1"
+    "@contentful/experiences-client": "0.3.0",
+    "@contentful/experiences-sdk-core": "0.7.0",
+    "@contentful/experiences-design": "0.7.0"
   },
   "peerDependencies": {
     "svelte": "^5.55.7"
@@ -48,7 +48,7 @@
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/svelte": "^5.4.2",
     "jsdom": "^29.1.1",
-    "publint": "^0.3.22",
+    "publint": "^0.3.23",
     "svelte": "^5.56.8",
     "svelte-check": "^4.7.4"
   }

package/dist/WrapWithTemplate.svelte

@@ -1,87 +0,0 @@
-<!--
- * Wraps the rendered Experience nodes with the page-level template when the
- * plan carries one and the customer registered a template config under that
- * id. When the template is referenced but unregistered, warns once and
- * renders children unwrapped — graceful degradation matches the
- * unknown-component fallback story.
--->
-<script lang="ts">
-  import type { Snippet } from 'svelte';
-
-  import type { PortableTemplate } from '@contentful/experiences-sdk-core';
-  import { applyTokenResolver, resolveDesignProperties } from '@contentful/experiences-design';
-
-  import { setContentfulTemplate, setResolvedDesign } from './context.js';
-  import {
-    normalizeTemplateRegistration,
-    type ContentfulTemplate,
-    type Config,
-    type RenderContext,
-  } from './types.js';
-
-  interface WrapWithTemplateProps {
-    template: PortableTemplate | undefined;
-    config: Config;
-    experience: RenderContext;
-    children: Snippet;
-  }
-
-  let { template, config, experience, children }: WrapWithTemplateProps = $props();
-
-  // setContext must run during synchronous component init — call once with
-  // the initial template value (templates don't toggle on/off mid-mount).
-  if (template) {
-    setContentfulTemplate({
-      templateId: template.templateId,
-      content: template.props.content,
-      design: template.props.design,
-      resolved: template.props.resolved,
-    } satisfies ContentfulTemplate);
-  }
-
-  const entry = $derived(template ? config.templates?.[template.templateId] : undefined);
-  const templateConfig = $derived(entry ? normalizeTemplateRegistration(entry) : null);
-
-  const tokenResolvedDesign = $derived.by(() => {
-    if (!template) return {};
-    const resolvedDesign = resolveDesignProperties(
-      template.props.design,
-      experience.viewports,
-      experience.activeViewportIndex
-    );
-    const { props, unresolved } = applyTokenResolver(resolvedDesign, config.resolveToken);
-    if (unresolved.length && typeof console !== 'undefined') {
-      console.warn(
-        `[@contentful/experiences-svelte] resolveToken returned undefined for token id(s) on template "${template.templateId}": ${unresolved.join(', ')}. getDesignValues() will omit those keys.`
-      );
-    }
-    return props;
-  });
-
-  // A getter (not a snapshot) so getDesignValues() stays reactive; not merged into props.
-  setResolvedDesign(() => tokenResolvedDesign);
-
-  const composed = $derived.by(() => {
-    if (!template || !templateConfig) return null;
-    return {
-      ...templateConfig.defaults,
-      ...template.props.content,
-      ...template.props.resolved,
-    };
-  });
-
-  $effect(() => {
-    if (template && !templateConfig && typeof console !== 'undefined') {
-      console.warn(
-        `[@contentful/experiences-svelte] No template registered for id "${template.templateId}". Rendering nodes without the template wrapper.`
-      );
-    }
-  });
-</script>
-
-{#if template && templateConfig && composed}
-  {@const Tpl = templateConfig.component}
-  <Tpl {...composed} {children} />
-{:else}
-  {@render children()}
-{/if}

package/dist/WrapWithTemplate.svelte.d.ts

@@ -1,13 +0,0 @@
-import type { Snippet } from 'svelte';
-import type { PortableTemplate } from '@contentful/experiences-sdk-core';
-import { type Config, type RenderContext } from './types.js';
-interface WrapWithTemplateProps {
-    template: PortableTemplate | undefined;
-    config: Config;
-    experience: RenderContext;
-    children: Snippet;
-}
-declare const WrapWithTemplate: import("svelte").Component<WrapWithTemplateProps, {}, "">;
-type WrapWithTemplate = ReturnType<typeof WrapWithTemplate>;
-export default WrapWithTemplate;
-//# sourceMappingURL=WrapWithTemplate.svelte.d.ts.map

package/dist/WrapWithTemplate.svelte.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"WrapWithTemplate.svelte.d.ts","sourceRoot":"","sources":["../src/WrapWithTemplate.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAIzE,OAAO,EAGH,KAAK,MAAM,EACX,KAAK,aAAa,EACnB,MAAM,YAAY,CAAC;AAGpB,UAAU,qBAAqB;IAC7B,QAAQ,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,aAAa,CAAC;IAC1B,QAAQ,EAAE,OAAO,CAAC;CACnB;AA0EH,QAAA,MAAM,gBAAgB,2DAAwC,CAAC;AAC/D,KAAK,gBAAgB,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC5D,eAAe,gBAAgB,CAAC"}

package/dist/test-fixtures/TemplateFixture.svelte.d.ts

@@ -1,9 +0,0 @@
-import type { Snippet } from 'svelte';
-type $$ComponentProps = {
-    title?: string;
-    children: Snippet;
-};
-declare const TemplateFixture: import("svelte").Component<$$ComponentProps, {}, "">;
-type TemplateFixture = ReturnType<typeof TemplateFixture>;
-export default TemplateFixture;
-//# sourceMappingURL=TemplateFixture.svelte.d.ts.map

package/dist/test-fixtures/TemplateFixture.svelte.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"TemplateFixture.svelte.d.ts","sourceRoot":"","sources":["../../src/test-fixtures/TemplateFixture.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAIrC,KAAK,gBAAgB,GAAI;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAmBJ,QAAA,MAAM,eAAe,sDAAwC,CAAC;AAC9D,KAAK,eAAe,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAC1D,eAAe,eAAe,CAAC"}