npm - @contentful/experiences-sdk-core - Versions diffs - 0.11.0 → 0.12.1 - Mend

@contentful/experiences-sdk-core 0.11.0 → 0.12.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (16) hide show

package/CHANGELOG.md +138 -0
package/README.md +3 -3
package/dist/design-properties.d.ts +21 -0
package/dist/design-properties.js +31 -0
package/dist/design-properties.js.map +1 -0
package/dist/index.d.ts +2 -2
package/dist/index.js +1 -8
package/dist/index.js.map +1 -1
package/dist/resolve-experience.d.ts +0 -12
package/dist/resolve-experience.js +12 -32
package/dist/resolve-experience.js.map +1 -1
package/dist/types.d.ts +16 -102
package/package.json +1 -1
package/dist/viewport.d.ts +0 -44
package/dist/viewport.js +0 -59
package/dist/viewport.js.map +0 -1

package/CHANGELOG.md CHANGED Viewed

@@ -1,3 +1,141 @@
+## 0.12.1 (2026-10-09)
+This was a version bump only for core to align it with other projects, there were no code changes.
+## 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.

package/README.md CHANGED Viewed

@@ -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 ADDED Viewed

@@ -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 ADDED Viewed

@@ -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 ADDED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

	@@ -1 +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":[]}
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 { 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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

	@@ -1 +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":[]}
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 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 CHANGED Viewed

@@ -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 CHANGED Viewed

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

package/dist/viewport.d.ts DELETED Viewed

@@ -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 DELETED Viewed

@@ -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 DELETED Viewed

@@ -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":[]}