@contentful/experiences-sdk-core 0.10.1 → 0.12.0

package/CHANGELOG.md

@@ -1,3 +1,141 @@
+## 0.12.0 (2026-10-08)
+
+### 🚀 Features
+
+- ⚠️  remove sdk viewport surface [SPA-5275] ([#220](https://github.com/contentful/experiences/pull/220))
+
+### ⚠️  Breaking Changes
+
+- remove sdk viewport surface [SPA-5275]  ([#220](https://github.com/contentful/experiences/pull/220))
+  The SDK no longer exposes viewport definitions, viewport-aware design-value resolution, or active-viewport hooks. Use CSS media queries or application-owned matchMedia integration for responsive behavior. Delivered design property values are now flat and require no migration."
+  M	AGENTS.md
+  M	ARCHITECTURE.md
+  M	CONTRIBUTING.md
+  M	README.md
+  M	catalog-info.yaml
+  M	examples/angular/README.md
+  M	examples/angular/src/app/components/heading.component.ts
+  D	examples/angular/src/app/lib/detect-viewport.ts
+  M	examples/angular/src/app/lib/experience-config.ts
+  M	examples/angular/src/app/lib/experience-route-data.ts
+  M	examples/angular/src/app/pages/experience-page.component.ts
+  M	examples/angular/src/server.ts
+  M	examples/nextjs/README.md
+  M	examples/nextjs/app/[slug]/page.tsx
+  M	examples/nextjs/components/Heading.tsx
+  M	examples/nextjs/components/LivePreviewExperience.tsx
+  M	examples/nextjs/components/Section.tsx
+  D	examples/nextjs/lib/detect-viewport.ts
+  M	examples/nextjs/lib/experience-config.tsx
+  M	examples/scripts/bootstrap-example.ts
+  M	examples/scripts/fixture/experience.ts
+  M	examples/scripts/fixture/types.ts
+  M	examples/sveltekit/README.md
+  M	examples/sveltekit/src/lib/components/Heading.svelte
+  D	examples/sveltekit/src/lib/detect-viewport.ts
+  M	examples/sveltekit/src/lib/experience-config.ts
+  M	examples/sveltekit/src/routes/[slug]/+page.server.ts
+  M	examples/sveltekit/src/routes/[slug]/+page.svelte
+  M	examples/sveltekit/vite.config.ts
+  M	package-lock.json
+  M	packages/adapter-angular/README.md
+  M	packages/adapter-angular/src/client-experience-renderer.component.ts
+  M	packages/adapter-angular/src/context.ts
+  M	packages/adapter-angular/src/debug-experience.test.ts
+  M	packages/adapter-angular/src/debug-panel-coverage.ssr.test.ts
+  M	packages/adapter-angular/src/debug-panel-coverage.test.ts
+  M	packages/adapter-angular/src/dom-parity.test.ts
+  M	packages/adapter-angular/src/experience-defaults.ts
+  M	packages/adapter-angular/src/experience-scope.ts
+  M	packages/adapter-angular/src/index.ts
+  D	packages/adapter-angular/src/inject-active-viewport.ts
+  M	packages/adapter-angular/src/inject-design-values.ts
+  M	packages/adapter-angular/src/inject-experience-plan.ts
+  M	packages/adapter-angular/src/live-preview-experience.ssr.test.ts
+  M	packages/adapter-angular/src/live-preview-experience.test.ts
+  M	packages/adapter-angular/src/node-render-engine.test.ts
+  M	packages/adapter-angular/src/node-render-engine.ts
+  M	packages/adapter-angular/src/node-scopes.ts
+  M	packages/adapter-angular/src/nodes-renderer.ssr.test.ts
+  M	packages/adapter-angular/src/server-experience-renderer.component.ts
+  M	packages/adapter-angular/src/server-renderer.test.ts
+  M	packages/adapter-angular/src/test-fixtures/render-harness.ts
+  M	packages/adapter-angular/src/types.ts
+  M	packages/adapter-react/README.md
+  M	packages/adapter-react/src/client-renderer.tsx
+  M	packages/adapter-react/src/context.tsx
+  M	packages/adapter-react/src/debug-experience.test.tsx
+  M	packages/adapter-react/src/debug-experience.tsx
+  M	packages/adapter-react/src/debug-panel-coverage.test.tsx
+  M	packages/adapter-react/src/index.ts
+  M	packages/adapter-react/src/nodes-renderer.ssr.test.tsx
+  M	packages/adapter-react/src/nodes-renderer.test.tsx
+  M	packages/adapter-react/src/nodes-renderer.tsx
+  M	packages/adapter-react/src/server-renderer.test.tsx
+  M	packages/adapter-react/src/server-renderer.tsx
+  M	packages/adapter-react/src/types.ts
+  D	packages/adapter-react/src/use-active-viewport.ts
+  M	packages/adapter-react/src/use-design-values.tsx
+  M	packages/adapter-react/src/use-experience-plan.test.tsx
+  M	packages/adapter-react/src/use-experience-plan.ts
+  M	packages/adapter-react/src/use-live-preview-experience.test.tsx
+  M	packages/adapter-react/src/use-live-preview.test.tsx
+  M	packages/adapter-svelte/README.md
+  M	packages/adapter-svelte/src/ClientExperienceRenderer.svelte
+  M	packages/adapter-svelte/src/DebugExperience.svelte
+  M	packages/adapter-svelte/src/DebugExperience.test.ts
+  M	packages/adapter-svelte/src/NodeRenderer.svelte
+  M	packages/adapter-svelte/src/NodeRenderer.test.ts
+  M	packages/adapter-svelte/src/NodesRenderer.svelte
+  M	packages/adapter-svelte/src/ServerExperienceRenderer.svelte
+  M	packages/adapter-svelte/src/component-props.ts
+  M	packages/adapter-svelte/src/context.ts
+  M	packages/adapter-svelte/src/debug-panel-coverage.ssr.test.ts
+  M	packages/adapter-svelte/src/debug-panel-coverage.test.ts
+  M	packages/adapter-svelte/src/get-design-values.ts
+  M	packages/adapter-svelte/src/index.ts
+  M	packages/adapter-svelte/src/nodes-renderer.ssr.test.ts
+  M	packages/adapter-svelte/src/server-renderer.test.ts
+  M	packages/adapter-svelte/src/types.ts
+  D	packages/adapter-svelte/src/use-active-viewport.svelte.ts
+  M	packages/adapter-svelte/src/use-experience-plan.test.ts
+  M	packages/adapter-svelte/src/use-live-preview-experience.test.ts
+  M	packages/adapter-svelte/src/use-live-preview.test.ts
+  M	packages/client/src/contentful-experiences.test.ts
+  M	packages/client/src/contentful-experiences.ts
+  M	packages/client/src/fetch-experience.test.ts
+  M	packages/client/src/fetch-experience.ts
+  M	packages/core/README.md
+  A	packages/core/src/design-properties.test.ts
+  A	packages/core/src/design-properties.ts
+  M	packages/core/src/index.ts
+  M	packages/core/src/resolve-experience.test.ts
+  M	packages/core/src/resolve-experience.ts
+  M	packages/core/src/types.ts
+  D	packages/core/src/viewport.test.ts
+  D	packages/core/src/viewport.ts
+  M	packages/design/README.md
+  M	packages/design/package.json
+  M	packages/design/src/index.ts
+  D	packages/design/src/media-query-matchers.ts
+  D	packages/design/src/select-resolved-design.ts
+  D	packages/design/src/viewport.test.ts
+  D	packages/design/src/viewport.ts
+  M	packages/live-preview/README.md
+  M	packages/live-preview/src/experience-payload.ts
+  M	packages/live-preview/src/fetch-preview-session.test.ts
+  M	packages/live-preview/src/fetch-preview-session.ts
+  M	packages/live-preview/src/live-preview-client.test.ts
+  M	packages/node/README.md
+  M	packages/node/src/contentful-experiences.test.ts
+  M	packages/node/src/contentful-experiences.ts
+  M	packages/web/README.md
+  M	packages/web/src/contentful-experiences.test.ts
+
+## 0.11.0 (2026-10-06)
+
+This was a version bump only for core to align it with other projects, there were no code changes.
+
 ## 0.10.1 (2026-10-01)
 
 ### 🚀 Features

package/README.md

@@ -7,9 +7,9 @@ adapters. This package has no runtime dependencies.
 
 ## What lives here
 
-- **Types** — `PortableRenderPlan`, `PortableRenderNode`, `PortableRegistration`, `ExperiencePayload`, `ExperienceNode`, the discriminated `DesignPropValue` union (`ManualDesignValue` / `DesignToken` / `ValuesByViewport`), `ViewportDef`, `ExperienceContext`, `ResolveContext`.
-- **`resolveExperience(payload, config, opts)`** — single async entry that walks an XDA payload, classifies content vs. design properties, captures slots, runs any component-declared `resolveData` hooks in parallel, and emits a runtime-neutral `PortableRenderPlan` ready for any framework adapter to render. Every node in the payload becomes a `PortableRenderNode`; `registration.kind` records whether the adapter should resolve its id against `config.components` or `config.experienceTemplates`. A coded Experience Template is an ordinary node — `payload.sys.experienceTemplate` is never read.
-- **Diagnostics and design support** — `createDebugLogger`, plus the viewport and design-resolution helpers (`applyTokenResolver`, `getValueForViewport`, `getViewportIndex`, and `resolveDesignProperties`).
+- **Types** — `PortableRenderPlan`, `PortableRenderNode`, `PortableRegistration`, `ExperiencePayload`, `ExperienceNode`, the discriminated `DesignPropValue` union (`ManualDesignValue` / `DesignToken`), `ExperienceContext`, `ResolveContext`.
+- **`resolveExperience(payload, config, opts)`** — single async entry that walks an XDA payload, classifies content vs. design properties, resolves design values and tokens, captures slots, runs any component-declared `resolveData` hooks in parallel, and emits a runtime-neutral `PortableRenderPlan` ready for any framework adapter to render. Every node in the payload becomes a `PortableRenderNode`; `registration.kind` records whether the adapter should resolve its id against `config.components` or `config.experienceTemplates`. A coded Experience Template is an ordinary node — `payload.sys.experienceTemplate` is never read.
+- **Diagnostics and design support** — `createDebugLogger`, `resolveDesignProperties`, and `applyTokenResolver`.
 
 Delivery transport and event construction do not belong here. They are owned by
 Client, keeping this package usable in any runtime without pulling in a delivery

package/dist/design-properties.d.ts

@@ -0,0 +1,21 @@
+import { DesignToken, ResolveToken, DesignPropValue } from './types.js';
+
+/**
+ * Resolve every design property on a node into a record keyed by name.
+ */
+declare function resolveDesignProperties(designProperties: Record<string, DesignPropValue> | undefined): Record<string, string | number | boolean | DesignToken>;
+/**
+ * Resolve `DesignToken` values via `resolveToken`; scalars pass through.
+ * Keys that don't resolve — no `resolveToken` configured, or the resolver
+ * returns `undefined` for that particular token — pass through as the raw
+ * `DesignToken` and their id is collected in `unresolved` for the caller to
+ * warn/diagnose (see `warnUnresolvedTokens` in `resolve-experience.ts`, which
+ * already dedupes per `resolveExperience()` call, so this function carries
+ * no warn-once state of its own).
+ */
+declare function applyTokenResolver(props: Record<string, string | number | boolean | DesignToken>, resolveToken?: ResolveToken): {
+    props: Record<string, unknown>;
+    unresolved: string[];
+};
+
+export { applyTokenResolver, resolveDesignProperties };

package/dist/design-properties.js

@@ -0,0 +1,31 @@
+function resolveDesignProperties(designProperties) {
+  const out = {};
+  if (!designProperties) return out;
+  for (const [key, prop] of Object.entries(designProperties)) {
+    out[key] = prop.type === "ManualDesignValue" ? prop.value : prop;
+  }
+  return out;
+}
+function applyTokenResolver(props, resolveToken) {
+  const out = {};
+  const unresolved = [];
+  for (const [key, value] of Object.entries(props)) {
+    if (typeof value === "object" && value !== null && value.type === "DesignToken") {
+      const resolved = resolveToken?.(value);
+      if (resolved === void 0) {
+        out[key] = value;
+        unresolved.push(value.value);
+        continue;
+      }
+      out[key] = resolved;
+      continue;
+    }
+    out[key] = value;
+  }
+  return { props: out, unresolved };
+}
+export {
+  applyTokenResolver,
+  resolveDesignProperties
+};
+//# sourceMappingURL=design-properties.js.map

package/dist/design-properties.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/design-properties.ts"],"sourcesContent":["/* Design-property and token resolution for the core render-plan builder. */\n\nimport type { DesignPropValue, DesignToken, ResolveToken } from './types.js';\n\n/**\n * Resolve every design property on a node into a record keyed by name.\n */\nexport function resolveDesignProperties(\n  designProperties: Record<string, DesignPropValue> | undefined\n): Record<string, string | number | boolean | DesignToken> {\n  const out: Record<string, string | number | boolean | DesignToken> = {};\n  if (!designProperties) return out;\n  for (const [key, prop] of Object.entries(designProperties)) {\n    out[key] = prop.type === 'ManualDesignValue' ? prop.value : prop;\n  }\n  return out;\n}\n\n/**\n * Resolve `DesignToken` values via `resolveToken`; scalars pass through.\n * Keys that don't resolve — no `resolveToken` configured, or the resolver\n * returns `undefined` for that particular token — pass through as the raw\n * `DesignToken` and their id is collected in `unresolved` for the caller to\n * warn/diagnose (see `warnUnresolvedTokens` in `resolve-experience.ts`, which\n * already dedupes per `resolveExperience()` call, so this function carries\n * no warn-once state of its own).\n */\nexport function applyTokenResolver(\n  props: Record<string, string | number | boolean | DesignToken>,\n  resolveToken?: ResolveToken\n): { props: Record<string, unknown>; unresolved: string[] } {\n  const out: Record<string, unknown> = {};\n  const unresolved: string[] = [];\n  for (const [key, value] of Object.entries(props)) {\n    if (typeof value === 'object' && value !== null && value.type === 'DesignToken') {\n      const resolved = resolveToken?.(value);\n      if (resolved === undefined) {\n        out[key] = value;\n        unresolved.push(value.value);\n        continue;\n      }\n      out[key] = resolved;\n      continue;\n    }\n    out[key] = value;\n  }\n  return { props: out, unresolved };\n}\n"],"mappings":"AAOO,SAAS,wBACd,kBACyD;AACzD,QAAM,MAA+D,CAAC;AACtE,MAAI,CAAC,iBAAkB,QAAO;AAC9B,aAAW,CAAC,KAAK,IAAI,KAAK,OAAO,QAAQ,gBAAgB,GAAG;AAC1D,QAAI,GAAG,IAAI,KAAK,SAAS,sBAAsB,KAAK,QAAQ;AAAA,EAC9D;AACA,SAAO;AACT;AAWO,SAAS,mBACd,OACA,cAC0D;AAC1D,QAAM,MAA+B,CAAC;AACtC,QAAM,aAAuB,CAAC;AAC9B,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,KAAK,GAAG;AAChD,QAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,SAAS,eAAe;AAC/E,YAAM,WAAW,eAAe,KAAK;AACrC,UAAI,aAAa,QAAW;AAC1B,YAAI,GAAG,IAAI;AACX,mBAAW,KAAK,MAAM,KAAK;AAC3B;AAAA,MACF;AACA,UAAI,GAAG,IAAI;AACX;AAAA,IACF;AACA,QAAI,GAAG,IAAI;AAAA,EACb;AACA,SAAO,EAAE,OAAO,KAAK,WAAW;AAClC;","names":[]}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { ComponentNode, ComponentRef, DesignPropValue, DesignToken, ExperienceContext, ExperienceExtensions, ExperienceNode, ExperiencePayload, ExperienceSourceMap, ExperienceSys, ExperienceTemplateNode, ExperienceTemplateRef, ManualDesignValue, PortableRegistration, PortableRenderNode, PortableRenderPlan, RenderContext, ResolveContext, ResolveToken, ValuesByViewport, ViewportDef } from './types.js';
+export { ComponentNode, ComponentRef, DesignPropValue, DesignToken, ExperienceContext, ExperienceExtensions, ExperienceNode, ExperiencePayload, ExperienceSourceMap, ExperienceSys, ExperienceTemplateNode, ExperienceTemplateRef, ManualDesignValue, PortableRegistration, PortableRenderNode, PortableRenderPlan, RenderContext, ResolveContext, ResolveToken } from './types.js';
 export { ResolveExperienceOptions, ResolverConfig, resolveExperience } from './resolve-experience.js';
 export { DebugLogger, createDebugLogger } from './debug-logger.js';
-export { applyTokenResolver, getValueForViewport, getViewportIndex, resolveDesignProperties } from './viewport.js';
+export { applyTokenResolver, resolveDesignProperties } from './design-properties.js';

package/dist/index.js

@@ -1,17 +1,10 @@
 export * from "./types.js";
 import { resolveExperience } from "./resolve-experience.js";
 import { createDebugLogger } from "./debug-logger.js";
-import {
-  applyTokenResolver,
-  getValueForViewport,
-  getViewportIndex,
-  resolveDesignProperties
-} from "./viewport.js";
+import { applyTokenResolver, resolveDesignProperties } from "./design-properties.js";
 export {
   applyTokenResolver,
   createDebugLogger,
-  getValueForViewport,
-  getViewportIndex,
   resolveDesignProperties,
   resolveExperience
 };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from './types.js';\nexport { resolveExperience } from './resolve-experience.js';\nexport type { ResolverConfig, ResolveExperienceOptions } from './resolve-experience.js';\nexport { createDebugLogger } from './debug-logger.js';\nexport type { DebugLogger } from './debug-logger.js';\nexport {\n  applyTokenResolver,\n  getValueForViewport,\n  getViewportIndex,\n  resolveDesignProperties,\n} from './viewport.js';\n"],"mappings":"AAAA,cAAc;AACd,SAAS,yBAAyB;AAElC,SAAS,yBAAyB;AAElC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from './types.js';\nexport { resolveExperience } from './resolve-experience.js';\nexport type { ResolverConfig, ResolveExperienceOptions } from './resolve-experience.js';\nexport { createDebugLogger } from './debug-logger.js';\nexport type { DebugLogger } from './debug-logger.js';\nexport { applyTokenResolver, resolveDesignProperties } from './design-properties.js';\n"],"mappings":"AAAA,cAAc;AACd,SAAS,yBAAyB;AAElC,SAAS,yBAAyB;AAElC,SAAS,oBAAoB,+BAA+B;","names":[]}

package/dist/resolve-experience.d.ts

@@ -20,11 +20,6 @@ interface ResolverConfig {
      * caller re-supplying it. Used during server-side pre-resolution.
      */
     resolveToken?: ResolveToken;
-    /**
-     * Default fallback viewport for server-side design pre-resolution. When unset
-     * (and not overridden by `initialViewportId`), defaults to viewport[0].
-     */
-    fallbackViewportId?: string;
 }
 interface ResolveExperienceOptions {
     /**
@@ -38,13 +33,6 @@ interface ResolveExperienceOptions {
      * resolver context as `ctx.experience.debug`. Defaults to `false`.
      */
     debug?: boolean;
-    /**
-     * Per-request override for the design pre-resolution fallback viewport. Wins
-     * over `config.fallbackViewportId` — pass a request-time value (e.g. a
-     * User-Agent-detected viewport) so SSR targets the device's expected
-     * viewport. Defaults to viewport[0] when unset or unknown.
-     */
-    initialViewportId?: string;
     /** Carried onto the plan as-is. Omit for no source map. */
     sourceMap?: ExperienceSourceMap;
 }

package/dist/resolve-experience.js

@@ -1,5 +1,5 @@
 import { createDebugLogger } from "./debug-logger.js";
-import { applyTokenResolver, getViewportIndex, resolveDesignProperties } from "./viewport.js";
+import { applyTokenResolver, resolveDesignProperties } from "./design-properties.js";
 function getResolver(entry) {
   if (typeof entry !== "object" || entry === null) return void 0;
   const candidate = entry.resolveData;
@@ -7,8 +7,7 @@ function getResolver(entry) {
 }
 const DEFAULT_EXPERIENCE = {
   debug: false,
-  metadata: {},
-  viewports: []
+  metadata: {}
 };
 function lookupEntry(config, registration) {
   return registration.kind === "experienceTemplate" ? config.experienceTemplates?.[registration.id] : config.components[registration.id];
@@ -96,7 +95,7 @@ function buildNode(node, config, nodeRefs, log, diagnostics) {
     registration,
     props: {
       content: { ...node.contentProperties ?? {} },
-      // Resolved flat values are written by the pre-resolution pass below.
+      // Resolved design values are written by the pre-resolution pass below.
       design: {},
       designRaw: { ...node.designProperties ?? {} }
     },
@@ -108,9 +107,8 @@ function buildNode(node, config, nodeRefs, log, diagnostics) {
   }
   return built;
 }
-function preResolveDesignProperties(design, viewports, fallbackViewportIndex, resolveToken) {
-  const cascaded = resolveDesignProperties(design, viewports, fallbackViewportIndex);
-  return applyTokenResolver(cascaded, resolveToken);
+function preResolveDesignProperties(design, resolveToken) {
+  return applyTokenResolver(resolveDesignProperties(design), resolveToken);
 }
 function warnUnresolvedTokens(label, unresolved, log, diagnostics) {
   if (!unresolved.length) return;
@@ -127,13 +125,8 @@ function warnUnresolvedTokens(label, unresolved, log, diagnostics) {
     );
   }
 }
-function preResolveNodeTree(node, viewports, fallbackViewportIndex, resolveToken, log, diagnostics) {
-  const { props, unresolved } = preResolveDesignProperties(
-    node.props.designRaw,
-    viewports,
-    fallbackViewportIndex,
-    resolveToken
-  );
+function preResolveNodeTree(node, resolveToken, log, diagnostics) {
+  const { props, unresolved } = preResolveDesignProperties(node.props.designRaw, resolveToken);
   node.props.design = props;
   warnUnresolvedTokens(
     `${node.registration.kind}:${node.registration.id}`,
@@ -143,7 +136,7 @@ function preResolveNodeTree(node, viewports, fallbackViewportIndex, resolveToken
   );
   for (const children of Object.values(node.slots)) {
     for (const child of children) {
-      preResolveNodeTree(child, viewports, fallbackViewportIndex, resolveToken, log, diagnostics);
+      preResolveNodeTree(child, resolveToken, log, diagnostics);
     }
   }
 }
@@ -153,7 +146,7 @@ async function resolveExperience(payload, config, options = {}) {
   const diagnostics = [];
   const isPlainPayload = payload !== null && typeof payload === "object";
   if (!isPlainPayload) {
-    const message = `Experience payload is ${payload === null ? "null" : typeof payload}, not an object; treating it as an empty experience (no nodes, no viewports) instead of throwing. This usually means the fetch or transform pipeline handed resolveExperience a missing or malformed payload \u2014 check what produced it.`;
+    const message = `Experience payload is ${payload === null ? "null" : typeof payload}, not an object; treating it as an empty experience (no nodes) instead of throwing. This usually means the fetch or transform pipeline handed resolveExperience a missing or malformed payload \u2014 check what produced it.`;
     if (typeof console !== "undefined") {
       console.warn(`[@contentful/experiences] ${message}`);
     }
@@ -161,7 +154,6 @@ async function resolveExperience(payload, config, options = {}) {
     diagnostics.push(new Error(message));
   }
   const payloadNodes = isPlainPayload ? ensureArray(payload.nodes, "nodes", log, diagnostics) : [];
-  const viewports = isPlainPayload && payload.viewports !== void 0 ? ensureArray(payload.viewports, "viewports", log, diagnostics) : [];
   const nodeRefs = [];
   const nodes = buildNodes(payloadNodes, config, nodeRefs, log, diagnostics);
   log.log(`built ${nodes.length} top-level node(s); ${nodeRefs.length} declare resolveData`);
@@ -170,8 +162,7 @@ async function resolveExperience(payload, config, options = {}) {
     metadata: {
       ...DEFAULT_EXPERIENCE.metadata,
       ...options.metadata ?? {}
-    },
-    viewports
+    }
   };
   const tasks = [];
   for (const node of nodeRefs) {
@@ -209,23 +200,12 @@ async function resolveExperience(payload, config, options = {}) {
   if (tasks.length > 0) {
     await log.time(`${tasks.length} resolveData hook(s)`, () => Promise.all(tasks));
   }
-  const fallbackViewportId = options.initialViewportId ?? config.fallbackViewportId;
-  const fallbackViewportIndex = getViewportIndex(viewports, fallbackViewportId);
   for (const node of nodes) {
-    preResolveNodeTree(
-      node,
-      viewports,
-      fallbackViewportIndex,
-      config.resolveToken,
-      log,
-      diagnostics
-    );
+    preResolveNodeTree(node, config.resolveToken, log, diagnostics);
   }
-  log.log(`pre-resolved design against fallback viewport index ${fallbackViewportIndex}`);
+  log.log("resolved design properties");
   const plan = {
-    viewports,
     nodes,
-    fallbackViewportIndex,
     diagnostics,
     metadata: experience.metadata,
     debug: experience.debug

package/dist/resolve-experience.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/resolve-experience.ts"],"sourcesContent":["/*\n * Turns an XDA Experience payload into a runtime-neutral PortableRenderPlan.\n * Walks nodes recursively, splits content + design props, runs any registered\n * `resolveData` hooks in parallel, and pre-resolves design against a fallback\n * viewport (see `resolveExperience` below).\n */\n\nimport { createDebugLogger, type DebugLogger } from './debug-logger.js';\nimport type {\n  DesignPropValue,\n  ExperienceContext,\n  ExperienceSourceMap,\n  ExperienceNode,\n  ExperiencePayload,\n  PortableRegistration,\n  PortableRenderNode,\n  PortableRenderPlan,\n  ResolveContext,\n  ResolveToken,\n  ViewportDef,\n} from './types.js';\nimport { applyTokenResolver, getViewportIndex, resolveDesignProperties } from './viewport.js';\n\n/**\n * Structural type the resolver walker depends on. Matches the React /\n * Svelte adapter `Config` shape but doesn't require importing them —\n * render-core stays decoupled from any framework.\n *\n * Registry values are typed as `unknown` because each adapter accepts\n * either a bare framework component (function / Svelte class / etc.) OR\n * a config-object shape with `{ component, defaults?, resolveData? }`.\n * The resolver only cares about `resolveData`; it duck-types each entry\n * at runtime and ignores anything without it.\n */\nexport interface ResolverConfig {\n  components: Record<string, unknown>;\n  experienceTemplates?: Record<string, unknown>;\n  /**\n   * Resolves `DesignToken` design properties to runtime values. Mirrors the\n   * adapter `Config.resolveToken`, so server and client agree without the\n   * caller re-supplying it. Used during server-side pre-resolution.\n   */\n  resolveToken?: ResolveToken;\n  /**\n   * Default fallback viewport for server-side design pre-resolution. When unset\n   * (and not overridden by `initialViewportId`), defaults to viewport[0].\n   */\n  fallbackViewportId?: string;\n}\n\nfunction getResolver(\n  entry: unknown\n):\n  | ((ctx: ResolveContext) => Record<string, unknown> | Promise<Record<string, unknown>>)\n  | undefined {\n  if (typeof entry !== 'object' || entry === null) return undefined;\n  const candidate = (entry as { resolveData?: unknown }).resolveData;\n  return typeof candidate === 'function'\n    ? (candidate as (\n        ctx: ResolveContext\n      ) => Record<string, unknown> | Promise<Record<string, unknown>>)\n    : undefined;\n}\n\nexport interface ResolveExperienceOptions {\n  /**\n   * Arbitrary per-render metadata exposed to every resolver as\n   * `ctx.experience.metadata`. Defaults to `{}`.\n   */\n  metadata?: Record<string, unknown>;\n  /**\n   * Observability switch. When on, `resolveExperience` logs the resolution\n   * steps and per-node `resolveData` fan-out timings. Threads through to the\n   * resolver context as `ctx.experience.debug`. Defaults to `false`.\n   */\n  debug?: boolean;\n  /**\n   * Per-request override for the design pre-resolution fallback viewport. Wins\n   * over `config.fallbackViewportId` — pass a request-time value (e.g. a\n   * User-Agent-detected viewport) so SSR targets the device's expected\n   * viewport. Defaults to viewport[0] when unset or unknown.\n   */\n  initialViewportId?: string;\n  /** Carried onto the plan as-is. Omit for no source map. */\n  sourceMap?: ExperienceSourceMap;\n}\n\nconst DEFAULT_EXPERIENCE: ExperienceContext = {\n  debug: false,\n  metadata: {},\n  viewports: [],\n};\n\n/**\n * Registry lookup for a built node. A node's `kind` decides which half of the\n * customer Config owns its implementation — components and Experience\n * Templates are otherwise interchangeable at every other step.\n */\nfunction lookupEntry(config: ResolverConfig, registration: PortableRegistration): unknown {\n  return registration.kind === 'experienceTemplate'\n    ? config.experienceTemplates?.[registration.id]\n    : config.components[registration.id];\n}\n\n/**\n * Extract the flat id (component or experienceTemplate) from its\n * `ResourceLink` URN. Real URN shapes:\n *   crn:contentful:::experience:spaces/$self/environments/$self/components/<id>\n *   crn:contentful:::experience:spaces/$self/environments/$self/experienceTemplates/<id>\n *\n * The id is the final path segment. We split on `/` and take the last\n * non-empty piece so this also tolerates trailing slashes or alternative\n * prefix shapes.\n */\nfunction extractIdFromUrn(urn: string): string {\n  const segments = urn.split('/').filter((s) => s.length > 0);\n  return segments[segments.length - 1] ?? urn;\n}\n\n/**\n * Read the ResourceLink a node points at. Which key is present is the only\n * difference between the two node variants: `experienceTemplate` means the\n * implementation lives in the customer's `experienceTemplates` registry,\n * `component` in `components`. Both carry ids in the same URN shape, the same\n * props shape, and the same slots — so everything downstream is kind-agnostic.\n *\n * `ExperienceNode` is a closed union, so a typed caller cannot produce anything\n * else. Payloads, however, are untrusted JSON at runtime, and the realistic way\n * a third shape arrives is a node kind *newer than this SDK*. Returns `null`\n * for anything unidentifiable rather than letting the ref access throw — see\n * `buildNode`.\n */\nfunction readNodeRef(\n  node: ExperienceNode\n): { kind: PortableRegistration['kind']; urn: string } | null {\n  const isExperienceTemplate = 'experienceTemplate' in node;\n  const ref = isExperienceTemplate\n    ? node.experienceTemplate\n    : 'component' in node\n      ? node.component\n      : undefined;\n  // Cast because the runtime value may violate the declared type: a node can\n  // carry `component: {}`, which satisfies `'component' in node` but has no urn.\n  const urn = (ref as { sys?: { urn?: unknown } } | undefined)?.sys?.urn;\n  if (typeof urn !== 'string' || urn.length === 0) return null;\n  return { kind: isExperienceTemplate ? 'experienceTemplate' : 'component', urn };\n}\n\n/**\n * Guards a top-level payload field that must be an array. A malformed or\n * partial payload (bad JSON, a hand-authored payload with the wrong shape)\n * should degrade to an empty experience rather than throwing and failing the\n * whole render — same \"dropping beats throwing\" rationale as\n * `warnUnrenderableNode` below, just one level up the tree.\n */\nfunction ensureArray<T>(\n  value: unknown,\n  field: string,\n  log: DebugLogger,\n  diagnostics: Error[]\n): T[] {\n  if (Array.isArray(value)) return value as T[];\n  const message =\n    `Experience payload's \"${field}\" is not an array (got ${value === null ? 'null' : typeof value}); ` +\n    `treating it as empty instead of throwing. This usually means a malformed or partial payload — ` +\n    `check what produced it.`;\n  if (typeof console !== 'undefined') {\n    console.warn(`[@contentful/experiences] ${message}`);\n  }\n  log.log(message);\n  diagnostics.push(new Error(message));\n  return [];\n}\n\n/** Total node count in a payload subtree, the node itself included. */\nfunction countPayloadNodes(node: ExperienceNode): number {\n  const slots = (node as { slots?: Record<string, unknown> }).slots;\n  let total = 1;\n  if (slots && typeof slots === 'object') {\n    for (const children of Object.values(slots)) {\n      if (!Array.isArray(children)) continue;\n      for (const child of children) total += countPayloadNodes(child as ExperienceNode);\n    }\n  }\n  return total;\n}\n\n/**\n * The one case where a node is dropped. AIS-413 was the opposite failure —\n * a node kind the SDK recognized and could have rendered, skipped behind a\n * vague warning, taking its whole subtree with it — so the bar here is that\n * nothing vanishes without a diagnostic naming what was lost.\n *\n * Dropping beats throwing: a `resolveExperience` rejection fails the entire\n * experience, so one unrecognized node in a sidebar would take down every page\n * containing it, for a payload the customer does not control and cannot fix.\n */\nfunction warnUnrenderableNode(node: ExperienceNode, log: DebugLogger, diagnostics: Error[]): void {\n  const id = (node as { id?: unknown }).id;\n  const label = typeof id === 'string' ? ` \"${id}\"` : '';\n  const keys = Object.keys(node);\n  const descendants = countPayloadNodes(node) - 1;\n  const message =\n    `Skipping unidentifiable node${label}: expected a \\`component\\` or \\`experienceTemplate\\` ` +\n    `ResourceLink carrying a urn, got keys [${keys.join(', ')}]. Dropping it and ${descendants} ` +\n    `descendant node(s). A payload node kind this SDK does not know is usually a version skew — ` +\n    `upgrading @contentful/experiences-sdk-core may be all that is needed.`;\n  if (typeof console !== 'undefined') {\n    console.warn(`[@contentful/experiences] ${message}`);\n  }\n  log.log(message);\n  diagnostics.push(new Error(message));\n}\n\n/**\n * Walk a sibling list into IR nodes, dropping any node `buildNode` cannot\n * identify. Used for both the top-level list and every slot.\n */\nfunction buildNodes(\n  nodes: ExperienceNode[],\n  config: ResolverConfig,\n  nodeRefs: PortableRenderNode[],\n  log: DebugLogger,\n  diagnostics: Error[]\n): PortableRenderNode[] {\n  const built: PortableRenderNode[] = [];\n  for (const node of nodes) {\n    const one = buildNode(node, config, nodeRefs, log, diagnostics);\n    if (one !== null) built.push(one);\n  }\n  return built;\n}\n\n/**\n * Recursively turn a payload node into an IR node. The collected `nodeRefs`\n * array is for the resolver pass — every built node with a registered\n * resolver gets a reference appended so we can run them in parallel without\n * walking the tree twice.\n *\n * Returns `null` only for a node whose ResourceLink cannot be read, which\n * `warnUnrenderableNode` has already reported. Callers go through `buildNodes`.\n */\nfunction buildNode(\n  node: ExperienceNode,\n  config: ResolverConfig,\n  nodeRefs: PortableRenderNode[],\n  log: DebugLogger,\n  diagnostics: Error[]\n): PortableRenderNode | null {\n  const ref = readNodeRef(node);\n  if (ref === null) {\n    warnUnrenderableNode(node, log, diagnostics);\n    return null;\n  }\n  const registration: PortableRegistration = {\n    kind: ref.kind,\n    id: extractIdFromUrn(ref.urn),\n  };\n  const nodeId = typeof node.id === 'string' ? node.id : undefined;\n\n  const slots: Record<string, PortableRenderNode[]> = {};\n  if (node.slots) {\n    for (const [slotName, children] of Object.entries(node.slots)) {\n      if (!Array.isArray(children)) {\n        const message =\n          `Slot \"${slotName}\" on ${registration.kind} \"${registration.id}\"` +\n          `${nodeId ? ` (node \"${nodeId}\")` : ''} is not an array of nodes (got ` +\n          `${children === null ? 'null' : typeof children}); treating it as empty instead of ` +\n          `failing the whole experience. A hand-built payload with the wrong slot shape is the ` +\n          `usual cause.`;\n        if (typeof console !== 'undefined') {\n          console.warn(`[@contentful/experiences] ${message}`);\n        }\n        log.log(message);\n        diagnostics.push(new Error(message));\n        slots[slotName] = [];\n        continue;\n      }\n      slots[slotName] = buildNodes(children, config, nodeRefs, log, diagnostics);\n    }\n  }\n\n  const built: PortableRenderNode = {\n    registration,\n    props: {\n      content: { ...(node.contentProperties ?? {}) },\n      // Resolved flat values are written by the pre-resolution pass below.\n      design: {},\n      designRaw: { ...(node.designProperties ?? {}) } as Record<string, DesignPropValue>,\n    },\n    slots,\n  };\n  if (node.id) built.nodeId = node.id;\n  if (getResolver(lookupEntry(config, registration))) {\n    nodeRefs.push(built);\n  }\n  return built;\n}\n\n// Cascade a node's raw design to the fallback viewport and resolve tokens.\n// Returns the flat resolved map plus any token ids left unresolved (dropped).\nfunction preResolveDesignProperties(\n  design: Record<string, DesignPropValue>,\n  viewports: ViewportDef[],\n  fallbackViewportIndex: number,\n  resolveToken: ResolveToken | undefined\n): { props: Record<string, unknown>; unresolved: string[] } {\n  const cascaded = resolveDesignProperties(design, viewports, fallbackViewportIndex);\n  return applyTokenResolver(cascaded, resolveToken);\n}\n\n// Warn when resolveToken left tokens unresolved, so pass-through keys are diagnosable.\nfunction warnUnresolvedTokens(\n  label: string,\n  unresolved: string[],\n  log: DebugLogger,\n  diagnostics: Error[]\n): void {\n  if (!unresolved.length) return;\n  const message = `resolveToken returned undefined for token id(s) on \"${label}\": ${unresolved.join(', ')}. Resolved design (getDesignValues()) will carry the raw, unresolved DesignToken for those keys.`;\n  if (typeof console !== 'undefined') {\n    console.warn(`[@contentful/experiences] ${message}`);\n  }\n  log.log(`unresolved token id(s) on \"${label}\": ${unresolved.join(', ')}`);\n  for (const tokenId of unresolved) {\n    diagnostics.push(\n      new Error(\n        `Design token \"${tokenId}\" on ${label} has no \\`resolveToken\\` mapping; the raw token reaches the component unresolved.`\n      )\n    );\n  }\n}\n\n// Depth-first pre-resolve for a node and its slot children.\nfunction preResolveNodeTree(\n  node: PortableRenderNode,\n  viewports: ViewportDef[],\n  fallbackViewportIndex: number,\n  resolveToken: ResolveToken | undefined,\n  log: DebugLogger,\n  diagnostics: Error[]\n): void {\n  const { props, unresolved } = preResolveDesignProperties(\n    node.props.designRaw,\n    viewports,\n    fallbackViewportIndex,\n    resolveToken\n  );\n  node.props.design = props;\n  warnUnresolvedTokens(\n    `${node.registration.kind}:${node.registration.id}`,\n    unresolved,\n    log,\n    diagnostics\n  );\n  for (const children of Object.values(node.slots)) {\n    for (const child of children) {\n      preResolveNodeTree(child, viewports, fallbackViewportIndex, resolveToken, log, diagnostics);\n    }\n  }\n}\n\n/**\n * Turns an Experience payload (XDA response shape) into a PortableRenderPlan\n * ready to hand to a renderer. Walks the tree, classifies props, captures\n * slots, and runs any component-declared `resolveData` hooks (sync or async)\n * in parallel.\n *\n * Implementation note: the function is always async — even when no component\n * declares a resolver, the cost is one microtask. Customers get a single\n * uniform call site.\n */\nexport async function resolveExperience(\n  payload: ExperiencePayload,\n  config: ResolverConfig,\n  options: ResolveExperienceOptions = {}\n): Promise<PortableRenderPlan> {\n  const log = createDebugLogger(options.debug, 'core');\n  log.lazy('resolveExperience called with payload', () => payload);\n\n  const diagnostics: Error[] = [];\n\n  // A payload that isn't an object at all (missing fetch result, a raw\n  // `null`/`undefined` handed in by a broken transform step) can't be\n  // guarded field-by-field via `ensureArray` below — that only guards once\n  // we're already inside a `payload.nodes` access. Guard the whole payload\n  // first so we degrade to an empty experience instead of throwing a raw\n  // TypeError, and report exactly one diagnostic rather than double-counting\n  // once we also run `nodes`/`viewports` through `ensureArray`.\n  const isPlainPayload = payload !== null && typeof payload === 'object';\n  if (!isPlainPayload) {\n    const message =\n      `Experience payload is ${payload === null ? 'null' : typeof payload}, not an object; ` +\n      `treating it as an empty experience (no nodes, no viewports) instead of throwing. This ` +\n      `usually means the fetch or transform pipeline handed resolveExperience a missing or ` +\n      `malformed payload — check what produced it.`;\n    if (typeof console !== 'undefined') {\n      console.warn(`[@contentful/experiences] ${message}`);\n    }\n    log.log(message);\n    diagnostics.push(new Error(message));\n  }\n  const payloadNodes = isPlainPayload\n    ? ensureArray<ExperienceNode>(payload.nodes, 'nodes', log, diagnostics)\n    : [];\n  // `viewports` is being removed from the API, so its absence is expected, not\n  // malformed — only warn via `ensureArray` when the field is present but not\n  // an array. Otherwise default to `[]` silently.\n  const viewports =\n    isPlainPayload && payload.viewports !== undefined\n      ? ensureArray<ViewportDef>(payload.viewports, 'viewports', log, diagnostics)\n      : [];\n\n  // Pass 1: walk the payload into the IR. Collect refs to nodes that need\n  // resolveData so pass 2 can run them in parallel without re-walking.\n  const nodeRefs: PortableRenderNode[] = [];\n  const nodes: PortableRenderNode[] = buildNodes(payloadNodes, config, nodeRefs, log, diagnostics);\n  log.log(`built ${nodes.length} top-level node(s); ${nodeRefs.length} declare resolveData`);\n\n  // Pass 2: run every node's resolveData hook in parallel.\n  // `viewports` is always sourced from the payload — the viewport list is fact,\n  // not opinion, so it can't be overridden by the caller.\n  const experience: ExperienceContext = {\n    debug: options.debug ?? DEFAULT_EXPERIENCE.debug,\n    metadata: {\n      ...DEFAULT_EXPERIENCE.metadata,\n      ...(options.metadata ?? {}),\n    },\n    viewports,\n  };\n\n  const tasks: Array<Promise<void>> = [];\n\n  for (const node of nodeRefs) {\n    const resolver = getResolver(lookupEntry(config, node.registration));\n    if (!resolver) continue;\n    const ctx: ResolveContext = {\n      content: node.props.content,\n      design: node.props.designRaw,\n      experience,\n    };\n    tasks.push(\n      // Deferred via `.then(() => resolver(ctx))` rather than\n      // `Promise.resolve(resolver(ctx))`: the latter calls `resolver(ctx)`\n      // eagerly as an argument, so a resolver that throws *synchronously*\n      // escapes immediately instead of becoming a rejection. The `onFailure`\n      // handler below never rethrows, so one broken resolver can't fail the\n      // `Promise.all` for every other node.\n      Promise.resolve()\n        .then(() => resolver(ctx))\n        .then(\n          (resolved) => {\n            node.props.resolved = resolved;\n          },\n          (err: unknown) => {\n            const label = `${node.registration.kind}:${node.registration.id}`;\n            const reason = err instanceof Error ? err.message : String(err);\n            const message =\n              `resolveData for ${label}${node.nodeId ? ` (node \"${node.nodeId}\")` : ''} threw or ` +\n              `rejected: ${reason}. Rendering the node without resolved data instead of failing ` +\n              `the whole experience.`;\n            if (typeof console !== 'undefined') {\n              console.warn(`[@contentful/experiences] ${message}`);\n            }\n            log.log(message);\n            diagnostics.push(new Error(message, { cause: err instanceof Error ? err : undefined }));\n          }\n        )\n    );\n  }\n\n  // Time the fan-out as a whole rather than per-resolver — one aggregate line\n  // keeps the timing signal without a line per node (which gets noisy fast).\n  if (tasks.length > 0) {\n    await log.time(`${tasks.length} resolveData hook(s)`, () => Promise.all(tasks));\n  }\n\n  // Pre-resolve design against the fallback viewport so SSR paints correct\n  // values on first render. Fallback is initialViewportId, else\n  // config.fallbackViewportId, else viewport[0].\n  const fallbackViewportId = options.initialViewportId ?? config.fallbackViewportId;\n  const fallbackViewportIndex = getViewportIndex(viewports, fallbackViewportId);\n  for (const node of nodes) {\n    preResolveNodeTree(\n      node,\n      viewports,\n      fallbackViewportIndex,\n      config.resolveToken,\n      log,\n      diagnostics\n    );\n  }\n  log.log(`pre-resolved design against fallback viewport index ${fallbackViewportIndex}`);\n\n  // Reuse `experience.metadata` rather than re-merging, so resolvers and the\n  // renderer read the same object. `viewports` is the guarded local, not\n  // `payload.viewports` — a malformed payload degrades to an empty list.\n  const plan: PortableRenderPlan = {\n    viewports,\n    nodes,\n    fallbackViewportIndex,\n    diagnostics,\n    metadata: experience.metadata,\n    debug: experience.debug,\n  };\n  if (options.sourceMap !== undefined) plan.sourceMap = options.sourceMap;\n  const profileId = isPlainPayload && payload.extensions?.personalization?.profile?.id;\n  if (profileId) {\n    plan.personalization = { profileId };\n  }\n  return plan;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/resolve-experience.ts"],"sourcesContent":["/*\n * Turns an XDA Experience payload into a runtime-neutral PortableRenderPlan.\n * Walks nodes recursively, splits content + design props, runs any registered\n * `resolveData` hooks in parallel, and resolves design values for the renderer.\n */\n\nimport { createDebugLogger, type DebugLogger } from './debug-logger.js';\nimport type {\n  DesignPropValue,\n  ExperienceContext,\n  ExperienceSourceMap,\n  ExperienceNode,\n  ExperiencePayload,\n  PortableRegistration,\n  PortableRenderNode,\n  PortableRenderPlan,\n  ResolveContext,\n  ResolveToken,\n} from './types.js';\nimport { applyTokenResolver, resolveDesignProperties } from './design-properties.js';\n\n/**\n * Structural type the resolver walker depends on. Matches the React /\n * Svelte adapter `Config` shape but doesn't require importing them —\n * render-core stays decoupled from any framework.\n *\n * Registry values are typed as `unknown` because each adapter accepts\n * either a bare framework component (function / Svelte class / etc.) OR\n * a config-object shape with `{ component, defaults?, resolveData? }`.\n * The resolver only cares about `resolveData`; it duck-types each entry\n * at runtime and ignores anything without it.\n */\nexport interface ResolverConfig {\n  components: Record<string, unknown>;\n  experienceTemplates?: Record<string, unknown>;\n  /**\n   * Resolves `DesignToken` design properties to runtime values. Mirrors the\n   * adapter `Config.resolveToken`, so server and client agree without the\n   * caller re-supplying it. Used during server-side pre-resolution.\n   */\n  resolveToken?: ResolveToken;\n}\n\nfunction getResolver(\n  entry: unknown\n):\n  | ((ctx: ResolveContext) => Record<string, unknown> | Promise<Record<string, unknown>>)\n  | undefined {\n  if (typeof entry !== 'object' || entry === null) return undefined;\n  const candidate = (entry as { resolveData?: unknown }).resolveData;\n  return typeof candidate === 'function'\n    ? (candidate as (\n        ctx: ResolveContext\n      ) => Record<string, unknown> | Promise<Record<string, unknown>>)\n    : undefined;\n}\n\nexport interface ResolveExperienceOptions {\n  /**\n   * Arbitrary per-render metadata exposed to every resolver as\n   * `ctx.experience.metadata`. Defaults to `{}`.\n   */\n  metadata?: Record<string, unknown>;\n  /**\n   * Observability switch. When on, `resolveExperience` logs the resolution\n   * steps and per-node `resolveData` fan-out timings. Threads through to the\n   * resolver context as `ctx.experience.debug`. Defaults to `false`.\n   */\n  debug?: boolean;\n  /** Carried onto the plan as-is. Omit for no source map. */\n  sourceMap?: ExperienceSourceMap;\n}\n\nconst DEFAULT_EXPERIENCE: ExperienceContext = {\n  debug: false,\n  metadata: {},\n};\n\n/**\n * Registry lookup for a built node. A node's `kind` decides which half of the\n * customer Config owns its implementation — components and Experience\n * Templates are otherwise interchangeable at every other step.\n */\nfunction lookupEntry(config: ResolverConfig, registration: PortableRegistration): unknown {\n  return registration.kind === 'experienceTemplate'\n    ? config.experienceTemplates?.[registration.id]\n    : config.components[registration.id];\n}\n\n/**\n * Extract the id (component or experienceTemplate) from its\n * `ResourceLink` URN. Real URN shapes:\n *   crn:contentful:::experience:spaces/$self/environments/$self/components/<id>\n *   crn:contentful:::experience:spaces/$self/environments/$self/experienceTemplates/<id>\n *\n * The id is the final path segment. We split on `/` and take the last\n * non-empty piece so this also tolerates trailing slashes or alternative\n * prefix shapes.\n */\nfunction extractIdFromUrn(urn: string): string {\n  const segments = urn.split('/').filter((s) => s.length > 0);\n  return segments[segments.length - 1] ?? urn;\n}\n\n/**\n * Read the ResourceLink a node points at. Which key is present is the only\n * difference between the two node variants: `experienceTemplate` means the\n * implementation lives in the customer's `experienceTemplates` registry,\n * `component` in `components`. Both carry ids in the same URN shape, the same\n * props shape, and the same slots — so everything downstream is kind-agnostic.\n *\n * `ExperienceNode` is a closed union, so a typed caller cannot produce anything\n * else. Payloads, however, are untrusted JSON at runtime, and the realistic way\n * a third shape arrives is a node kind *newer than this SDK*. Returns `null`\n * for anything unidentifiable rather than letting the ref access throw — see\n * `buildNode`.\n */\nfunction readNodeRef(\n  node: ExperienceNode\n): { kind: PortableRegistration['kind']; urn: string } | null {\n  const isExperienceTemplate = 'experienceTemplate' in node;\n  const ref = isExperienceTemplate\n    ? node.experienceTemplate\n    : 'component' in node\n      ? node.component\n      : undefined;\n  // Cast because the runtime value may violate the declared type: a node can\n  // carry `component: {}`, which satisfies `'component' in node` but has no urn.\n  const urn = (ref as { sys?: { urn?: unknown } } | undefined)?.sys?.urn;\n  if (typeof urn !== 'string' || urn.length === 0) return null;\n  return { kind: isExperienceTemplate ? 'experienceTemplate' : 'component', urn };\n}\n\n/**\n * Guards a top-level payload field that must be an array. A malformed or\n * partial payload (bad JSON, a hand-authored payload with the wrong shape)\n * should degrade to an empty experience rather than throwing and failing the\n * whole render — same \"dropping beats throwing\" rationale as\n * `warnUnrenderableNode` below, just one level up the tree.\n */\nfunction ensureArray<T>(\n  value: unknown,\n  field: string,\n  log: DebugLogger,\n  diagnostics: Error[]\n): T[] {\n  if (Array.isArray(value)) return value as T[];\n  const message =\n    `Experience payload's \"${field}\" is not an array (got ${value === null ? 'null' : typeof value}); ` +\n    `treating it as empty instead of throwing. This usually means a malformed or partial payload — ` +\n    `check what produced it.`;\n  if (typeof console !== 'undefined') {\n    console.warn(`[@contentful/experiences] ${message}`);\n  }\n  log.log(message);\n  diagnostics.push(new Error(message));\n  return [];\n}\n\n/** Total node count in a payload subtree, the node itself included. */\nfunction countPayloadNodes(node: ExperienceNode): number {\n  const slots = (node as { slots?: Record<string, unknown> }).slots;\n  let total = 1;\n  if (slots && typeof slots === 'object') {\n    for (const children of Object.values(slots)) {\n      if (!Array.isArray(children)) continue;\n      for (const child of children) total += countPayloadNodes(child as ExperienceNode);\n    }\n  }\n  return total;\n}\n\n/**\n * The one case where a node is dropped. AIS-413 was the opposite failure —\n * a node kind the SDK recognized and could have rendered, skipped behind a\n * vague warning, taking its whole subtree with it — so the bar here is that\n * nothing vanishes without a diagnostic naming what was lost.\n *\n * Dropping beats throwing: a `resolveExperience` rejection fails the entire\n * experience, so one unrecognized node in a sidebar would take down every page\n * containing it, for a payload the customer does not control and cannot fix.\n */\nfunction warnUnrenderableNode(node: ExperienceNode, log: DebugLogger, diagnostics: Error[]): void {\n  const id = (node as { id?: unknown }).id;\n  const label = typeof id === 'string' ? ` \"${id}\"` : '';\n  const keys = Object.keys(node);\n  const descendants = countPayloadNodes(node) - 1;\n  const message =\n    `Skipping unidentifiable node${label}: expected a \\`component\\` or \\`experienceTemplate\\` ` +\n    `ResourceLink carrying a urn, got keys [${keys.join(', ')}]. Dropping it and ${descendants} ` +\n    `descendant node(s). A payload node kind this SDK does not know is usually a version skew — ` +\n    `upgrading @contentful/experiences-sdk-core may be all that is needed.`;\n  if (typeof console !== 'undefined') {\n    console.warn(`[@contentful/experiences] ${message}`);\n  }\n  log.log(message);\n  diagnostics.push(new Error(message));\n}\n\n/**\n * Walk a sibling list into IR nodes, dropping any node `buildNode` cannot\n * identify. Used for both the top-level list and every slot.\n */\nfunction buildNodes(\n  nodes: ExperienceNode[],\n  config: ResolverConfig,\n  nodeRefs: PortableRenderNode[],\n  log: DebugLogger,\n  diagnostics: Error[]\n): PortableRenderNode[] {\n  const built: PortableRenderNode[] = [];\n  for (const node of nodes) {\n    const one = buildNode(node, config, nodeRefs, log, diagnostics);\n    if (one !== null) built.push(one);\n  }\n  return built;\n}\n\n/**\n * Recursively turn a payload node into an IR node. The collected `nodeRefs`\n * array is for the resolver pass — every built node with a registered\n * resolver gets a reference appended so we can run them in parallel without\n * walking the tree twice.\n *\n * Returns `null` only for a node whose ResourceLink cannot be read, which\n * `warnUnrenderableNode` has already reported. Callers go through `buildNodes`.\n */\nfunction buildNode(\n  node: ExperienceNode,\n  config: ResolverConfig,\n  nodeRefs: PortableRenderNode[],\n  log: DebugLogger,\n  diagnostics: Error[]\n): PortableRenderNode | null {\n  const ref = readNodeRef(node);\n  if (ref === null) {\n    warnUnrenderableNode(node, log, diagnostics);\n    return null;\n  }\n  const registration: PortableRegistration = {\n    kind: ref.kind,\n    id: extractIdFromUrn(ref.urn),\n  };\n  const nodeId = typeof node.id === 'string' ? node.id : undefined;\n\n  const slots: Record<string, PortableRenderNode[]> = {};\n  if (node.slots) {\n    for (const [slotName, children] of Object.entries(node.slots)) {\n      if (!Array.isArray(children)) {\n        const message =\n          `Slot \"${slotName}\" on ${registration.kind} \"${registration.id}\"` +\n          `${nodeId ? ` (node \"${nodeId}\")` : ''} is not an array of nodes (got ` +\n          `${children === null ? 'null' : typeof children}); treating it as empty instead of ` +\n          `failing the whole experience. A hand-built payload with the wrong slot shape is the ` +\n          `usual cause.`;\n        if (typeof console !== 'undefined') {\n          console.warn(`[@contentful/experiences] ${message}`);\n        }\n        log.log(message);\n        diagnostics.push(new Error(message));\n        slots[slotName] = [];\n        continue;\n      }\n      slots[slotName] = buildNodes(children, config, nodeRefs, log, diagnostics);\n    }\n  }\n\n  const built: PortableRenderNode = {\n    registration,\n    props: {\n      content: { ...(node.contentProperties ?? {}) },\n      // Resolved design values are written by the pre-resolution pass below.\n      design: {},\n      designRaw: { ...(node.designProperties ?? {}) } as Record<string, DesignPropValue>,\n    },\n    slots,\n  };\n  if (node.id) built.nodeId = node.id;\n  if (getResolver(lookupEntry(config, registration))) {\n    nodeRefs.push(built);\n  }\n  return built;\n}\n\n// Resolve a node's raw design values and tokens.\nfunction preResolveDesignProperties(\n  design: Record<string, DesignPropValue>,\n  resolveToken: ResolveToken | undefined\n): { props: Record<string, unknown>; unresolved: string[] } {\n  return applyTokenResolver(resolveDesignProperties(design), resolveToken);\n}\n\n// Warn when resolveToken left tokens unresolved, so pass-through keys are diagnosable.\nfunction warnUnresolvedTokens(\n  label: string,\n  unresolved: string[],\n  log: DebugLogger,\n  diagnostics: Error[]\n): void {\n  if (!unresolved.length) return;\n  const message = `resolveToken returned undefined for token id(s) on \"${label}\": ${unresolved.join(', ')}. Resolved design (getDesignValues()) will carry the raw, unresolved DesignToken for those keys.`;\n  if (typeof console !== 'undefined') {\n    console.warn(`[@contentful/experiences] ${message}`);\n  }\n  log.log(`unresolved token id(s) on \"${label}\": ${unresolved.join(', ')}`);\n  for (const tokenId of unresolved) {\n    diagnostics.push(\n      new Error(\n        `Design token \"${tokenId}\" on ${label} has no \\`resolveToken\\` mapping; the raw token reaches the component unresolved.`\n      )\n    );\n  }\n}\n\n// Depth-first token resolution for a node and its slot children.\nfunction preResolveNodeTree(\n  node: PortableRenderNode,\n  resolveToken: ResolveToken | undefined,\n  log: DebugLogger,\n  diagnostics: Error[]\n): void {\n  const { props, unresolved } = preResolveDesignProperties(node.props.designRaw, resolveToken);\n  node.props.design = props;\n  warnUnresolvedTokens(\n    `${node.registration.kind}:${node.registration.id}`,\n    unresolved,\n    log,\n    diagnostics\n  );\n  for (const children of Object.values(node.slots)) {\n    for (const child of children) {\n      preResolveNodeTree(child, resolveToken, log, diagnostics);\n    }\n  }\n}\n\n/**\n * Turns an Experience payload (XDA response shape) into a PortableRenderPlan\n * ready to hand to a renderer. Walks the tree, classifies props, captures\n * slots, and runs any component-declared `resolveData` hooks (sync or async)\n * in parallel.\n *\n * Implementation note: the function is always async — even when no component\n * declares a resolver, the cost is one microtask. Customers get a single\n * uniform call site.\n */\nexport async function resolveExperience(\n  payload: ExperiencePayload,\n  config: ResolverConfig,\n  options: ResolveExperienceOptions = {}\n): Promise<PortableRenderPlan> {\n  const log = createDebugLogger(options.debug, 'core');\n  log.lazy('resolveExperience called with payload', () => payload);\n\n  const diagnostics: Error[] = [];\n\n  // A payload that isn't an object at all (missing fetch result, a raw\n  // `null`/`undefined` handed in by a broken transform step) can't be\n  // guarded field-by-field via `ensureArray` below — that only guards once\n  // we're already inside a `payload.nodes` access. Guard the whole payload\n  // first so we degrade to an empty experience instead of throwing a raw\n  // TypeError, and report exactly one diagnostic rather than double-counting\n  // once we also run `nodes` through `ensureArray`.\n  const isPlainPayload = payload !== null && typeof payload === 'object';\n  if (!isPlainPayload) {\n    const message =\n      `Experience payload is ${payload === null ? 'null' : typeof payload}, not an object; ` +\n      `treating it as an empty experience (no nodes) instead of throwing. This ` +\n      `usually means the fetch or transform pipeline handed resolveExperience a missing or ` +\n      `malformed payload — check what produced it.`;\n    if (typeof console !== 'undefined') {\n      console.warn(`[@contentful/experiences] ${message}`);\n    }\n    log.log(message);\n    diagnostics.push(new Error(message));\n  }\n  const payloadNodes = isPlainPayload\n    ? ensureArray<ExperienceNode>(payload.nodes, 'nodes', log, diagnostics)\n    : [];\n  // Pass 1: walk the payload into the IR. Collect refs to nodes that need\n  // resolveData so pass 2 can run them in parallel without re-walking.\n  const nodeRefs: PortableRenderNode[] = [];\n  const nodes: PortableRenderNode[] = buildNodes(payloadNodes, config, nodeRefs, log, diagnostics);\n  log.log(`built ${nodes.length} top-level node(s); ${nodeRefs.length} declare resolveData`);\n\n  // Pass 2: run every node's resolveData hook in parallel.\n  const experience: ExperienceContext = {\n    debug: options.debug ?? DEFAULT_EXPERIENCE.debug,\n    metadata: {\n      ...DEFAULT_EXPERIENCE.metadata,\n      ...(options.metadata ?? {}),\n    },\n  };\n\n  const tasks: Array<Promise<void>> = [];\n\n  for (const node of nodeRefs) {\n    const resolver = getResolver(lookupEntry(config, node.registration));\n    if (!resolver) continue;\n    const ctx: ResolveContext = {\n      content: node.props.content,\n      design: node.props.designRaw,\n      experience,\n    };\n    tasks.push(\n      // Deferred via `.then(() => resolver(ctx))` rather than\n      // `Promise.resolve(resolver(ctx))`: the latter calls `resolver(ctx)`\n      // eagerly as an argument, so a resolver that throws *synchronously*\n      // escapes immediately instead of becoming a rejection. The `onFailure`\n      // handler below never rethrows, so one broken resolver can't fail the\n      // `Promise.all` for every other node.\n      Promise.resolve()\n        .then(() => resolver(ctx))\n        .then(\n          (resolved) => {\n            node.props.resolved = resolved;\n          },\n          (err: unknown) => {\n            const label = `${node.registration.kind}:${node.registration.id}`;\n            const reason = err instanceof Error ? err.message : String(err);\n            const message =\n              `resolveData for ${label}${node.nodeId ? ` (node \"${node.nodeId}\")` : ''} threw or ` +\n              `rejected: ${reason}. Rendering the node without resolved data instead of failing ` +\n              `the whole experience.`;\n            if (typeof console !== 'undefined') {\n              console.warn(`[@contentful/experiences] ${message}`);\n            }\n            log.log(message);\n            diagnostics.push(new Error(message, { cause: err instanceof Error ? err : undefined }));\n          }\n        )\n    );\n  }\n\n  // Time the fan-out as a whole rather than per-resolver — one aggregate line\n  // keeps the timing signal without a line per node (which gets noisy fast).\n  if (tasks.length > 0) {\n    await log.time(`${tasks.length} resolveData hook(s)`, () => Promise.all(tasks));\n  }\n\n  for (const node of nodes) {\n    preResolveNodeTree(node, config.resolveToken, log, diagnostics);\n  }\n  log.log('resolved design properties');\n\n  // Reuse `experience.metadata` rather than re-merging, so resolvers and the\n  // renderer read the same object.\n  const plan: PortableRenderPlan = {\n    nodes,\n    diagnostics,\n    metadata: experience.metadata,\n    debug: experience.debug,\n  };\n  if (options.sourceMap !== undefined) plan.sourceMap = options.sourceMap;\n  const profileId = isPlainPayload && payload.extensions?.personalization?.profile?.id;\n  if (profileId) {\n    plan.personalization = { profileId };\n  }\n  return plan;\n}\n"],"mappings":"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","names":[]}

package/dist/types.d.ts

@@ -4,12 +4,6 @@
  * every `resolveData` hook as `ctx.experience`. Never spread onto component
  * props — components receive only the props they declare.
  *
- * `viewports` (the *list*) is here so customer resolvers can inspect what
- * viewports an Experience declares (e.g. "is there a mobile viewport?").
- * The *active* viewport is render-time only and lives on the framework
- * adapter's RenderContext — exposing it here would mean async resolvers
- * re-fire on every viewport change, which would be a footgun.
- *
  * `debug` is the single observability switch. When on it: emits verbose logs
  * from `resolveExperience` and `fetchExperience`; renders the visible
  * missing-component box (see the adapters' `MissingComponent`); and turns the
@@ -27,63 +21,15 @@ interface ExperienceContext {
      * crosses server/client boundaries.
      */
     metadata: Record<string, unknown>;
-    /**
-     * @deprecated Viewports are being removed from the Experiences APIs. Design
-     * property values arrive flat. Will not be removed before 2026-10-06.
-     */
-    viewports: ViewportDef[];
-}
-/**
- * `ExperienceContext` plus the viewport state that only exists at render time.
- *
- * Declared here, not per-adapter: it is plain data, so every adapter re-exports
- * this same type and a field added here reaches all three at once.
- */
-interface RenderContext extends ExperienceContext {
-    /**
-     * @deprecated Viewport state is being removed from the Experiences APIs.
-     * Will not be removed before 2026-10-06.
-     */
-    activeViewport: ViewportDef;
-    /**
-     * @deprecated Viewport state is being removed from the Experiences APIs.
-     * Will not be removed before 2026-10-06.
-     */
-    activeViewportIndex: number;
-    /**
-     * @deprecated Viewport state is being removed from the Experiences APIs.
-     * Will not be removed before 2026-10-06.
-     */
-    fallbackViewportIndex: number;
-}
-/**
- * One viewport definition from a delivered Experience. The `query` is the
- * Contentful media-query DSL ("*" | "<992px" | ">1200px"), not raw CSS.
- *
- * The first viewport in the list is conventionally the wildcard ("*") that
- * always matches. The viewport order encodes the cascade direction —
- * desktop-first (descending) or mobile-first (ascending).
- */
-/**
- * @deprecated Viewports are being removed from the Experiences APIs. No
- * customer action is needed: design property values arrive flat. Will not be
- * removed before 2026-10-06.
- */
-interface ViewportDef {
-    id: string;
-    query: string;
-    displayName: string;
-    previewSize: string;
 }
+/** Render-time context is the same plain data supplied to `resolveData`. */
+type RenderContext = ExperienceContext;
 /**
  * Discriminated design-property value as it arrives from XDA. v1 accepts:
- *  - ManualDesignValue: an explicit scalar (no viewport involved).
- *  - ValuesByViewport: a viewport-keyed map where each entry is itself a
- *                      ManualDesignValue or DesignToken.
- *  - DesignToken: a token reference, passed through to customer components
- *                 as-is for v1. Resolution lands in the future tokens package.
+ *  - ManualDesignValue: an explicit scalar.
+ *  - DesignToken: a token reference resolved while building the render plan.
  */
-type DesignPropValue = ManualDesignValue | DesignToken | ValuesByViewport;
+type DesignPropValue = ManualDesignValue | DesignToken;
 interface ManualDesignValue {
     type: 'ManualDesignValue';
     value: string | number | boolean;
@@ -94,19 +40,10 @@ interface DesignToken {
 }
 /**
  * Turns a `DesignToken` into a runtime value. `ref.value` is the
- * customer-defined token id; returning `undefined` means "not resolvable" and
- * the adapter drops the key (with a warning). Sync only — it runs at render time.
+ * customer-defined token id; returning `undefined` retains the raw token and
+ * records a diagnostic. Sync only — it runs while building the render plan.
  */
 type ResolveToken = (ref: DesignToken) => unknown;
-/**
- * @deprecated Viewports are being removed from the Experiences APIs. No
- * customer action is needed: design property values arrive flat. Will not be
- * removed before 2026-10-06.
- */
-interface ValuesByViewport {
-    type: 'ValuesByViewport';
-    values: Record<string, ManualDesignValue | DesignToken>;
-}
 /**
  * Resource-link reference to a registered Component. The `urn` carries
  * the component id; the build-plan extracts the id by taking the segment after
@@ -226,11 +163,6 @@ interface ExperienceExtensions {
  * `@contentful/experience-delivery` sends on every request.
  */
 interface ExperiencePayload {
-    /**
-     * @deprecated Absent once the API stops sending `viewports`. `resolveExperience`
-     * defaults to `[]` when this is missing. Will not be removed before 2026-10-06.
-     */
-    viewports?: ViewportDef[];
     nodes: ExperienceNode[];
     errors?: unknown[];
     extensions?: ExperienceExtensions;
@@ -238,9 +170,7 @@ interface ExperiencePayload {
 }
 /**
  * Per-node context handed to a component's `resolveData` resolver. Carries
- * the raw content + design props from the payload (design properties are NOT
- * pre-resolved against a viewport — viewport resolution stays a render-time
- * concern so client viewport changes don't re-trigger async resolvers).
+ * the raw content + design props from the payload.
  */
 interface ResolveContext {
     content: Record<string, unknown>;
@@ -268,19 +198,16 @@ interface PortableRegistration {
  * that lets non-React adapters (Angular, SwiftUI, Compose) consume the same
  * interpretation.
  *
- * Design props preserve the discriminated value shape as they arrived. Adapters
- * unwrap to plain scalars at render time, given an active viewport.
- * (DesignToken values pass through unwrapped — customer components decide
- * how to resolve them in v1.)
+ * Design props preserve the discriminated value shape as they arrived. Token
+ * resolution happens when the plan is built, before any framework renderer
+ * reads the values.
  *
  * `props.resolved` is populated by `resolveExperience` from any
  * customer-supplied `resolveData` resolver and merged into the final props
  * after content + design but before slot props.
  *
- * `props.design` is the server pre-resolution of design against the plan's
- * fallback viewport; the raw per-viewport form stays on `props.designRaw` so
- * the client can re-resolve when the active viewport differs. See the fields
- * below.
+ * `props.design` contains values ready for the renderer; `props.designRaw`
+ * preserves the source values for `resolveData` and payload context helpers.
  */
 interface PortableRenderNode {
     /**
@@ -292,13 +219,10 @@ interface PortableRenderNode {
     registration: PortableRegistration;
     props: {
         content: Record<string, unknown>;
-        /** Flat, viewport-cascaded, token-resolved design values (server-side). */
+        /** Token-resolved design values. */
         design: Record<string, unknown>;
         resolved?: Record<string, unknown>;
-        /**
-         * @deprecated Design property values are becoming flat. Will not be
-         * removed before 2026-10-06.
-         */
+        /** Design-property envelopes as delivered by XDA. */
         designRaw: Record<string, DesignPropValue>;
     };
     /**
@@ -319,17 +243,7 @@ interface PortableRenderNode {
  * is no plan-level template concept — see `PortableRegistration`.
  */
 interface PortableRenderPlan {
-    /**
-     * @deprecated Viewports are being removed from the Experiences APIs. Design
-     * property values arrive flat. Will not be removed before 2026-10-06.
-     */
-    viewports: ViewportDef[];
     nodes: PortableRenderNode[];
-    /**
-     * @deprecated Viewport state is being removed from the Experiences APIs.
-     * Will not be removed before 2026-10-06.
-     */
-    fallbackViewportIndex: number;
     /**
      * The `metadata` the resolve step ran with, so the renderer does not need it
      * passed again. The renderer's `metadata` prop merges over this. `{}` when
@@ -363,4 +277,4 @@ interface PortableRenderPlan {
     diagnostics: Error[];
 }
 
-export type { ComponentNode, ComponentRef, DesignPropValue, DesignToken, ExperienceContext, ExperienceExtensions, ExperienceNode, ExperiencePayload, ExperienceSourceMap, ExperienceSys, ExperienceTemplateNode, ExperienceTemplateRef, ManualDesignValue, PortableRegistration, PortableRenderNode, PortableRenderPlan, RenderContext, ResolveContext, ResolveToken, ValuesByViewport, ViewportDef };
+export type { ComponentNode, ComponentRef, DesignPropValue, DesignToken, ExperienceContext, ExperienceExtensions, ExperienceNode, ExperiencePayload, ExperienceSourceMap, ExperienceSys, ExperienceTemplateNode, ExperienceTemplateRef, ManualDesignValue, PortableRegistration, PortableRenderNode, PortableRenderPlan, RenderContext, ResolveContext, ResolveToken };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experiences-sdk-core",
-  "version": "0.10.1",
+  "version": "0.12.0",
   "description": "Runtime-neutral types + experience resolution for Contentful Experiences",
   "license": "MIT",
   "type": "module",

package/dist/viewport.d.ts

@@ -1,44 +0,0 @@
-import { DesignToken, ResolveToken, DesignPropValue, ViewportDef } from './types.js';
-
-/**
- * Viewport id → index. Returns 0 (the wildcard viewport) when unknown.
- *
- * @deprecated Viewports are being removed from the Experiences APIs. No
- * customer action is needed: design property values arrive flat, so this
- * resolution step is skipped automatically. Will not be removed before
- * 2026-10-06.
- */
-declare function getViewportIndex(viewports: ViewportDef[], viewportId?: string): number;
-/**
- * Resolve one design property to its render-time value (cascade + unwrap).
- *
- * @deprecated Viewports are being removed from the Experiences APIs. No
- * customer action is needed: flat values already return early here, so this
- * cascade step is skipped automatically. Will not be removed before
- * 2026-10-06.
- */
-declare function getValueForViewport(prop: DesignPropValue | undefined, viewports: ViewportDef[], activeViewportIndex: number): string | number | boolean | DesignToken | undefined;
-/**
- * Resolve every design property on a node into a flat record keyed by name.
- *
- * NOTE: once viewports are removed from the Experiences APIs, every design
- * property value arrives already flat, so the `viewports` and
- * `activeViewportIndex` parameters will be dropped. Will not happen before
- * 2026-10-06.
- */
-declare function resolveDesignProperties(designProperties: Record<string, DesignPropValue> | undefined, viewports: ViewportDef[], activeViewportIndex: number): Record<string, string | number | boolean | DesignToken>;
-/**
- * Resolve `DesignToken` values via `resolveToken`; scalars pass through.
- * Keys that don't resolve — no `resolveToken` configured, or the resolver
- * returns `undefined` for that particular token — pass through as the raw
- * `DesignToken` and their id is collected in `unresolved` for the caller to
- * warn/diagnose (see `warnUnresolvedTokens` in `resolve-experience.ts`, which
- * already dedupes per `resolveExperience()` call, so this function carries
- * no warn-once state of its own).
- */
-declare function applyTokenResolver(props: Record<string, string | number | boolean | DesignToken>, resolveToken?: ResolveToken): {
-    props: Record<string, unknown>;
-    unresolved: string[];
-};
-
-export { applyTokenResolver, getValueForViewport, getViewportIndex, resolveDesignProperties };

package/dist/viewport.js

@@ -1,59 +0,0 @@
-function getViewportIndex(viewports, viewportId) {
-  if (!viewportId) return 0;
-  const index = viewports.findIndex((v) => v.id === viewportId);
-  return index === -1 ? 0 : index;
-}
-function unwrapInner(inner) {
-  if (!inner) return void 0;
-  if (inner.type === "ManualDesignValue") return inner.value;
-  return inner;
-}
-function resolveValuesByViewport(valuesByViewport, viewports, activeViewportIndex) {
-  for (let i = activeViewportIndex; i >= 0; i--) {
-    const viewport = viewports[i];
-    if (!viewport) continue;
-    const candidate = valuesByViewport.values[viewport.id];
-    if (candidate !== void 0 && candidate !== null) return candidate;
-  }
-  return void 0;
-}
-function getValueForViewport(prop, viewports, activeViewportIndex) {
-  if (!prop) return void 0;
-  if (prop.type === "ManualDesignValue") return prop.value;
-  if (prop.type === "DesignToken") return prop;
-  return unwrapInner(resolveValuesByViewport(prop, viewports, activeViewportIndex));
-}
-function resolveDesignProperties(designProperties, viewports, activeViewportIndex) {
-  const out = {};
-  if (!designProperties) return out;
-  for (const [key, prop] of Object.entries(designProperties)) {
-    const value = getValueForViewport(prop, viewports, activeViewportIndex);
-    if (value !== void 0) out[key] = value;
-  }
-  return out;
-}
-function applyTokenResolver(props, resolveToken) {
-  const out = {};
-  const unresolved = [];
-  for (const [key, value] of Object.entries(props)) {
-    if (typeof value === "object" && value !== null && value.type === "DesignToken") {
-      const resolved = resolveToken?.(value);
-      if (resolved === void 0) {
-        out[key] = value;
-        unresolved.push(value.value);
-        continue;
-      }
-      out[key] = resolved;
-      continue;
-    }
-    out[key] = value;
-  }
-  return { props: out, unresolved };
-}
-export {
-  applyTokenResolver,
-  getValueForViewport,
-  getViewportIndex,
-  resolveDesignProperties
-};
-//# sourceMappingURL=viewport.js.map

package/dist/viewport.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/viewport.ts"],"sourcesContent":["/*\n * Viewport math + design-property resolution. Lives in core (not design) so the\n * resolve pipeline can pre-resolve design props server-side; the design package\n * re-exports these, so its public API is unchanged.\n *\n * Viewport order encodes cascade direction (desktop-first descends by width,\n * mobile-first ascends). The \"active viewport\" is the last-matching media query;\n * `getValueForViewport` walks backwards from it to viewport[0] and returns the\n * first defined value, matching CSS cascade behavior.\n */\n\nimport type {\n  DesignPropValue,\n  DesignToken,\n  ManualDesignValue,\n  ResolveToken,\n  ValuesByViewport,\n  ViewportDef,\n} from './types.js';\n\n/**\n * Viewport id → index. Returns 0 (the wildcard viewport) when unknown.\n *\n * @deprecated Viewports are being removed from the Experiences APIs. No\n * customer action is needed: design property values arrive flat, so this\n * resolution step is skipped automatically. Will not be removed before\n * 2026-10-06.\n */\nexport function getViewportIndex(viewports: ViewportDef[], viewportId?: string): number {\n  if (!viewportId) return 0;\n  const index = viewports.findIndex((v) => v.id === viewportId);\n  return index === -1 ? 0 : index;\n}\n\n// ManualDesignValue → its scalar; DesignToken → passed through (resolved later).\nfunction unwrapInner(\n  inner: ManualDesignValue | DesignToken | undefined\n): string | number | boolean | DesignToken | undefined {\n  if (!inner) return undefined;\n  if (inner.type === 'ManualDesignValue') return inner.value;\n  return inner;\n}\n\n// Cascade-lookup: walk back from activeViewportIndex to viewport[0], first defined wins.\nfunction resolveValuesByViewport(\n  valuesByViewport: ValuesByViewport,\n  viewports: ViewportDef[],\n  activeViewportIndex: number\n): ManualDesignValue | DesignToken | undefined {\n  for (let i = activeViewportIndex; i >= 0; i--) {\n    const viewport = viewports[i];\n    if (!viewport) continue;\n    const candidate = valuesByViewport.values[viewport.id];\n    if (candidate !== undefined && candidate !== null) return candidate;\n  }\n  return undefined;\n}\n\n/**\n * Resolve one design property to its render-time value (cascade + unwrap).\n *\n * @deprecated Viewports are being removed from the Experiences APIs. No\n * customer action is needed: flat values already return early here, so this\n * cascade step is skipped automatically. Will not be removed before\n * 2026-10-06.\n */\nexport function getValueForViewport(\n  prop: DesignPropValue | undefined,\n  viewports: ViewportDef[],\n  activeViewportIndex: number\n): string | number | boolean | DesignToken | undefined {\n  if (!prop) return undefined;\n  if (prop.type === 'ManualDesignValue') return prop.value;\n  if (prop.type === 'DesignToken') return prop;\n  return unwrapInner(resolveValuesByViewport(prop, viewports, activeViewportIndex));\n}\n\n/**\n * Resolve every design property on a node into a flat record keyed by name.\n *\n * NOTE: once viewports are removed from the Experiences APIs, every design\n * property value arrives already flat, so the `viewports` and\n * `activeViewportIndex` parameters will be dropped. Will not happen before\n * 2026-10-06.\n */\nexport function resolveDesignProperties(\n  designProperties: Record<string, DesignPropValue> | undefined,\n  viewports: ViewportDef[],\n  activeViewportIndex: number\n): Record<string, string | number | boolean | DesignToken> {\n  const out: Record<string, string | number | boolean | DesignToken> = {};\n  if (!designProperties) return out;\n  for (const [key, prop] of Object.entries(designProperties)) {\n    const value = getValueForViewport(prop, viewports, activeViewportIndex);\n    if (value !== undefined) out[key] = value;\n  }\n  return out;\n}\n\n/**\n * Resolve `DesignToken` values via `resolveToken`; scalars pass through.\n * Keys that don't resolve — no `resolveToken` configured, or the resolver\n * returns `undefined` for that particular token — pass through as the raw\n * `DesignToken` and their id is collected in `unresolved` for the caller to\n * warn/diagnose (see `warnUnresolvedTokens` in `resolve-experience.ts`, which\n * already dedupes per `resolveExperience()` call, so this function carries\n * no warn-once state of its own).\n */\nexport function applyTokenResolver(\n  props: Record<string, string | number | boolean | DesignToken>,\n  resolveToken?: ResolveToken\n): { props: Record<string, unknown>; unresolved: string[] } {\n  const out: Record<string, unknown> = {};\n  const unresolved: string[] = [];\n  for (const [key, value] of Object.entries(props)) {\n    if (typeof value === 'object' && value !== null && value.type === 'DesignToken') {\n      const resolved = resolveToken?.(value);\n      if (resolved === undefined) {\n        out[key] = value;\n        unresolved.push(value.value);\n        continue;\n      }\n      out[key] = resolved;\n      continue;\n    }\n    out[key] = value;\n  }\n  return { props: out, unresolved };\n}\n"],"mappings":"AA4BO,SAAS,iBAAiB,WAA0B,YAA6B;AACtF,MAAI,CAAC,WAAY,QAAO;AACxB,QAAM,QAAQ,UAAU,UAAU,CAAC,MAAM,EAAE,OAAO,UAAU;AAC5D,SAAO,UAAU,KAAK,IAAI;AAC5B;AAGA,SAAS,YACP,OACqD;AACrD,MAAI,CAAC,MAAO,QAAO;AACnB,MAAI,MAAM,SAAS,oBAAqB,QAAO,MAAM;AACrD,SAAO;AACT;AAGA,SAAS,wBACP,kBACA,WACA,qBAC6C;AAC7C,WAAS,IAAI,qBAAqB,KAAK,GAAG,KAAK;AAC7C,UAAM,WAAW,UAAU,CAAC;AAC5B,QAAI,CAAC,SAAU;AACf,UAAM,YAAY,iBAAiB,OAAO,SAAS,EAAE;AACrD,QAAI,cAAc,UAAa,cAAc,KAAM,QAAO;AAAA,EAC5D;AACA,SAAO;AACT;AAUO,SAAS,oBACd,MACA,WACA,qBACqD;AACrD,MAAI,CAAC,KAAM,QAAO;AAClB,MAAI,KAAK,SAAS,oBAAqB,QAAO,KAAK;AACnD,MAAI,KAAK,SAAS,cAAe,QAAO;AACxC,SAAO,YAAY,wBAAwB,MAAM,WAAW,mBAAmB,CAAC;AAClF;AAUO,SAAS,wBACd,kBACA,WACA,qBACyD;AACzD,QAAM,MAA+D,CAAC;AACtE,MAAI,CAAC,iBAAkB,QAAO;AAC9B,aAAW,CAAC,KAAK,IAAI,KAAK,OAAO,QAAQ,gBAAgB,GAAG;AAC1D,UAAM,QAAQ,oBAAoB,MAAM,WAAW,mBAAmB;AACtE,QAAI,UAAU,OAAW,KAAI,GAAG,IAAI;AAAA,EACtC;AACA,SAAO;AACT;AAWO,SAAS,mBACd,OACA,cAC0D;AAC1D,QAAM,MAA+B,CAAC;AACtC,QAAM,aAAuB,CAAC;AAC9B,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,KAAK,GAAG;AAChD,QAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,SAAS,eAAe;AAC/E,YAAM,WAAW,eAAe,KAAK;AACrC,UAAI,aAAa,QAAW;AAC1B,YAAI,GAAG,IAAI;AACX,mBAAW,KAAK,MAAM,KAAK;AAC3B;AAAA,MACF;AACA,UAAI,GAAG,IAAI;AACX;AAAA,IACF;AACA,QAAI,GAAG,IAAI;AAAA,EACb;AACA,SAAO,EAAE,OAAO,KAAK,WAAW;AAClC;","names":[]}