@contentful/experiences-angular 0.2.0

package/dist/inject-live-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-live-preview.d.ts","sourceRoot":"","sources":["../src/inject-live-preview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAC9F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAElF,OAAO,EAEL,KAAK,4BAA4B,EACjC,KAAK,0BAA0B,EAChC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAEL,KAAK,iCAAiC,EACvC,MAAM,qCAAqC,CAAC;AAE7C,MAAM,WAAW,wBAAwB;IACvC,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;IAC9C,cAAc,CAAC,EAAE,iBAAiB,CAAC;IACnC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,cAAc,EAAE,4BAA4B,CAAC;CAC9C;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAClD,QAAQ,CAAC,KAAK,EAAE,iCAAiC,CAAC,OAAO,CAAC,CAAC;CAC5D;AAED,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,wBAAwB,GACzC,uBAAuB,CAYzB"}

package/dist/inject-live-preview.js

@@ -0,0 +1,14 @@
+import { injectExperiencePlan, } from './inject-experience-plan.js';
+import { injectLivePreviewExperience, } from './inject-live-preview-experience.js';
+export function injectLivePreview(getOptions) {
+    const livePreview = injectLivePreviewExperience(() => {
+        const { previewSessionOptions, initialPayload } = getOptions();
+        return { previewSessionOptions, initialPayload };
+    });
+    const plan = injectExperiencePlan(() => {
+        const { initialPlan, resolveOptions } = getOptions();
+        return { payload: livePreview.data(), initialPlan, resolveOptions };
+    });
+    return { data: plan.data, error: livePreview.error };
+}
+//# sourceMappingURL=inject-live-preview.js.map

package/dist/inject-live-preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-live-preview.js","sourceRoot":"","sources":["../src/inject-live-preview.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,oBAAoB,GAGrB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,2BAA2B,GAE5B,MAAM,qCAAqC,CAAC;AAc7C,MAAM,UAAU,iBAAiB,CAC/B,UAA0C;IAE1C,MAAM,WAAW,GAAG,2BAA2B,CAAC,GAAG,EAAE;QACnD,MAAM,EAAE,qBAAqB,EAAE,cAAc,EAAE,GAAG,UAAU,EAAE,CAAC;QAC/D,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,oBAAoB,CAAC,GAAG,EAAE;QACrC,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,GAAG,UAAU,EAAE,CAAC;QACrD,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,cAAc,EAAE,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,WAAW,CAAC,KAAK,EAAE,CAAC;AACvD,CAAC"}

package/dist/missing-component.component.d.ts

@@ -0,0 +1,14 @@
+import { type OnInit } from '@angular/core';
+import * as i0 from "@angular/core";
+export declare class MissingComponentComponent implements OnInit {
+    protected readonly componentIdValue: import("@angular/core").WritableSignal<string>;
+    protected readonly nodeIdValue: import("@angular/core").WritableSignal<string | undefined>;
+    set componentId(value: string);
+    set nodeId(value: string | undefined);
+    protected readonly experience: import("@angular/core").Signal<import("@contentful/experiences-sdk-core").RenderContext>;
+    protected readonly details: import("@angular/core").Signal<string>;
+    ngOnInit(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MissingComponentComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MissingComponentComponent, "cf-missing-component", never, { "componentId": { "alias": "componentId"; "required": true; }; "nodeId": { "alias": "nodeId"; "required": false; }; }, {}, never, never, true, never>;
+}
+//# sourceMappingURL=missing-component.component.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"missing-component.component.d.ts","sourceRoot":"","sources":["../src/missing-component.component.ts"],"names":[],"mappings":"AAcA,OAAO,EAIL,KAAK,MAAM,EAGZ,MAAM,eAAe,CAAC;;AAIvB,qBAmBa,yBAA0B,YAAW,MAAM;IACtD,SAAS,CAAC,QAAQ,CAAC,gBAAgB,iDAAc;IACjD,SAAS,CAAC,QAAQ,CAAC,WAAW,6DAAyC;IAEvE,IAA+B,WAAW,CAAC,KAAK,EAAE,MAAM,EAEvD;IAED,IAAa,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAE5C;IAED,SAAS,CAAC,QAAQ,CAAC,UAAU,2FAAsB;IAEnD,SAAS,CAAC,QAAQ,CAAC,OAAO,yCAMxB;IAEF,QAAQ,IAAI,IAAI;yCAtBL,yBAAyB;2CAAzB,yBAAyB;CAgCrC"}

package/dist/missing-component.component.js

@@ -0,0 +1,83 @@
+/*
+ * Fallback for a node whose component id is not in the registry. Port of
+ * adapter-svelte/src/MissingComponent.svelte.
+ *
+ * Loud in the console always, visible on the page only in debug mode: a missing
+ * registration is a developer mistake, and a red box in production would make it
+ * the visitor's problem too.
+ *
+ * The warning fires from `ngOnInit` rather than the constructor because inputs
+ * are not bound yet in the constructor, and rather than `afterNextRender`
+ * because that never runs on the server — SSR would silently drop the
+ * diagnostic. `ngOnInit` runs in both.
+ */
+import { ChangeDetectionStrategy, Component, Input, computed, signal, } from '@angular/core';
+import { injectExperience } from './context.js';
+import * as i0 from "@angular/core";
+export class MissingComponentComponent {
+    constructor() {
+        this.componentIdValue = signal('', ...(ngDevMode ? [{ debugName: "componentIdValue" }] : []));
+        this.nodeIdValue = signal(undefined, ...(ngDevMode ? [{ debugName: "nodeIdValue" }] : []));
+        this.experience = injectExperience();
+        this.details = computed(() => JSON.stringify({ componentId: this.componentIdValue(), nodeId: this.nodeIdValue() ?? null }, null, 2), ...(ngDevMode ? [{ debugName: "details" }] : []));
+    }
+    set componentId(value) {
+        this.componentIdValue.set(value);
+    }
+    set nodeId(value) {
+        this.nodeIdValue.set(value);
+    }
+    ngOnInit() {
+        if (typeof console === 'undefined')
+            return;
+        const nodeId = this.nodeIdValue();
+        const idLabel = nodeId ? ` (nodeId: ${nodeId})` : '';
+        // No framework suffix on this one: it is identical across all adapters, and
+        // customers grep for it.
+        console.warn(`[@contentful/experiences] No component registered for id "${this.componentIdValue()}"${idLabel}.`);
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.28", ngImport: i0, type: MissingComponentComponent, deps: [], target: i0.ɵɵFactoryTarget.Component }); }
+    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "20.3.28", type: MissingComponentComponent, isStandalone: true, selector: "cf-missing-component", inputs: { componentId: "componentId", nodeId: "nodeId" }, ngImport: i0, template: `
+    @if (experience().debug) {
+      <div
+        [attr.data-experiences-missing]="componentIdValue()"
+        style="border: 2px solid red; padding: 1rem; color: red; background: #fff; font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: 0.8125rem;"
+      >
+        <strong>Missing component &#8216;{{ componentIdValue() }}&#8217;</strong>
+        <p style="margin: 0.5rem 0;">
+          This node references a component id that is not in the registry. Register it under this
+          key in your <code>components</code> map:
+        </p>
+        <pre style="margin: 0; white-space: pre-wrap;">{{ details() }}</pre>
+      </div>
+    }
+  `, isInline: true, changeDetection: i0.ChangeDetectionStrategy.OnPush }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.28", ngImport: i0, type: MissingComponentComponent, decorators: [{
+            type: Component,
+            args: [{
+                    selector: 'cf-missing-component',
+                    changeDetection: ChangeDetectionStrategy.OnPush,
+                    template: `
+    @if (experience().debug) {
+      <div
+        [attr.data-experiences-missing]="componentIdValue()"
+        style="border: 2px solid red; padding: 1rem; color: red; background: #fff; font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: 0.8125rem;"
+      >
+        <strong>Missing component &#8216;{{ componentIdValue() }}&#8217;</strong>
+        <p style="margin: 0.5rem 0;">
+          This node references a component id that is not in the registry. Register it under this
+          key in your <code>components</code> map:
+        </p>
+        <pre style="margin: 0; white-space: pre-wrap;">{{ details() }}</pre>
+      </div>
+    }
+  `,
+                }]
+        }], propDecorators: { componentId: [{
+                type: Input,
+                args: [{ required: true }]
+            }], nodeId: [{
+                type: Input
+            }] } });
+//# sourceMappingURL=missing-component.component.js.map

package/dist/missing-component.component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"missing-component.component.js","sourceRoot":"","sources":["../src/missing-component.component.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,uBAAuB,EACvB,SAAS,EACT,KAAK,EAEL,QAAQ,EACR,MAAM,GACP,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;;AAqBhD,MAAM,OAAO,yBAAyB;IAnBtC;QAoBqB,qBAAgB,GAAG,MAAM,CAAC,EAAE,4DAAC,CAAC;QAC9B,gBAAW,GAAG,MAAM,CAAqB,SAAS,uDAAC,CAAC;QAUpD,eAAU,GAAG,gBAAgB,EAAE,CAAC;QAEhC,YAAO,GAAG,QAAQ,CAAC,GAAG,EAAE,CACzC,IAAI,CAAC,SAAS,CACZ,EAAE,WAAW,EAAE,IAAI,CAAC,gBAAgB,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,IAAI,EAAE,EAC5E,IAAI,EACJ,CAAC,CACF,mDACF,CAAC;KAYH;IA5BC,IAA+B,WAAW,CAAC,KAAa;QACtD,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAED,IAAa,MAAM,CAAC,KAAyB;QAC3C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAYD,QAAQ;QACN,IAAI,OAAO,OAAO,KAAK,WAAW;YAAE,OAAO;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,aAAa,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,4EAA4E;QAC5E,yBAAyB;QACzB,OAAO,CAAC,IAAI,CACV,6DAA6D,IAAI,CAAC,gBAAgB,EAAE,IAAI,OAAO,GAAG,CACnG,CAAC;IACJ,CAAC;+GA/BU,yBAAyB;mGAAzB,yBAAyB,0IAhB1B;;;;;;;;;;;;;;GAcT;;4FAEU,yBAAyB;kBAnBrC,SAAS;mBAAC;oBACT,QAAQ,EAAE,sBAAsB;oBAChC,eAAe,EAAE,uBAAuB,CAAC,MAAM;oBAC/C,QAAQ,EAAE;;;;;;;;;;;;;;GAcT;iBACF;;sBAKE,KAAK;uBAAC,EAAE,QAAQ,EAAE,IAAI,EAAE;;sBAIxB,KAAK"}

package/dist/node-render-engine.d.ts

@@ -0,0 +1,109 @@
+import { Injector, type ViewContainerRef } from '@angular/core';
+import type { PortableRenderNode } from '@contentful/experiences-sdk-core';
+import { ExperienceScope } from './experience-scope.js';
+/**
+ * Creates, reuses, reorders and destroys the views for a list of nodes in one
+ * `ViewContainerRef`. Driven by the two structural directives in
+ * node-renderer.directive.ts; not exported from the package.
+ */
+export declare class NodeRenderEngine {
+    private readonly viewContainerRef;
+    private readonly hostInjector;
+    private readonly experienceScope;
+    private readonly units;
+    private nodes;
+    private lastConfig;
+    constructor(viewContainerRef: ViewContainerRef, hostInjector: Injector, experienceScope: ExperienceScope);
+    /**
+     * Called synchronously from the directive's input setter — the same point
+     * `NgComponentOutlet` creates from in `ngOnChanges`. It has to be synchronous
+     * rather than deferred to an effect: a single `detectChanges()` (which is all
+     * the test harness and `renderApplication` give us) must produce the full
+     * tree.
+     */
+    setNodes(nodes: readonly PortableRenderNode[]): void;
+    /**
+     * Re-syncs if the registry changed under us. Which component a node resolves
+     * to depends on `config`, and nothing else the engine reads is structural —
+     * design values and content flow through the input bindings, which change
+     * detection already tracks.
+     */
+    checkConfig(): void;
+    destroy(): void;
+    private sync;
+    /**
+     * Walks `nodes` in DOM order, appending every unit that owns a view to
+     * `live`. Recurses only through orphaned experience templates: ordinary
+     * recursion happens through the customer component, which renders its own
+     * slots with its own `*cfNodes`.
+     */
+    private collect;
+    /**
+     * Reports every diagnostic in a fresh `resolution` computation exactly
+     * once. `resolution.diagnostics` is a new array only when `resolveNode`
+     * actually re-ran (a reference check, not a deep-equality one) —
+     * `collect()` reads `unit.resolution()` on every sync, including syncs
+     * where nothing about this node changed, and re-reporting on every read
+     * would spam `ExperienceScope.diagnostics` with duplicates of the same
+     * event.
+     */
+    private reportDiagnostics;
+    /**
+     * Creates the view for a `render`-mode resolution. Wrapped in try/catch: a
+     * customer component that throws while Angular constructs and first-checks
+     * it (constructor, template evaluation, `ngOnInit`) must not take down its
+     * siblings.
+     *
+     * This covers the SSR path with no separate SSR-specific code needed,
+     * unlike the React and Svelte adapters: `@angular/platform-server` runs
+     * this exact `createComponent` call, not a parallel server renderer, so a
+     * synchronous creation-time throw is caught here identically in SSR and
+     * CSR.
+     *
+     * A *later* throw — one that happens after creation succeeded, on a
+     * subsequent sync rather than this one — is a different case, covered by
+     * `collect()`'s own try/catch around `unit.resolution()`, not here. That
+     * split matters: `resolution.bindable`'s `inputBinding` getters (built by
+     * `bindings()` below) also call `unit.resolution()`, and it's tempting to
+     * wrap *those* instead — but `resolution`'s only tracked dependencies
+     * (`unit.node`, `experienceScope.config()`) are exclusively mutated from
+     * inside `collect()` (`unit.node.set(...)`, and `checkConfig()`'s call into
+     * `sync()`/`collect()`), so any throw from a genuine dependency change
+     * always reaches `collect()`'s own read first — by the time Angular's CD
+     * independently re-invokes a binding getter for that unit, the computed's
+     * error is already cached and `collect()` has already handled it. A
+     * `bindings()`-level catch would be unreachable dead code.
+     *
+     * What no fix here reaches: a throw inside the *customer* component's own
+     * internals on a later change-detection pass (its own template expression,
+     * computed, or lifecycle hook unrelated to our bindings) — that never
+     * touches adapter code at all. A per-node `ErrorHandler` provider in
+     * `unit.injector` doesn't help here either: `ApplicationRef.tick()`
+     * resolves `ErrorHandler` once, from the *root* injector, at construction,
+     * and never re-resolves it from whichever component's injector actually
+     * threw — a per-node override in a child injector is structurally
+     * unreachable from that catch. Documented gap; see the README's
+     * error-handling section.
+     */
+    private createView;
+    /**
+     * Shared by `createView`'s creation-time catch and
+     * `reportPostCreationFailure`'s later-pass catch: reports the diagnostic
+     * and mounts the customer's `renderError` override (or the built-in
+     * default) at `index`. The caller picks `index` — appending at the current
+     * end for a brand-new unit, or the unit's own prior position when
+     * replacing an already-mounted view — since this method has no way to
+     * know which situation it's in.
+     */
+    private mountErrorFallback;
+    private createUnit;
+    /**
+     * Change-detection-integrated, unlike a one-shot `setInput` record: each
+     * binding re-reads the merged props when the node, the active viewport or a
+     * design token changes, and marks the (likely `OnPush`) customer component
+     * dirty only when its own value did.
+     */
+    private bindings;
+    private detach;
+}
+//# sourceMappingURL=node-render-engine.d.ts.map

package/dist/node-render-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-render-engine.d.ts","sourceRoot":"","sources":["../src/node-render-engine.ts"],"names":[],"mappings":"AAiCA,OAAO,EAGL,QAAQ,EAIR,KAAK,gBAAgB,EAMtB,MAAM,eAAe,CAAC;AAGvB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAE3E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAyRxD;;;;GAIG;AACH,qBAAa,gBAAgB;IAMzB,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAPlC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IACjD,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,UAAU,CAAuB;gBAGtB,gBAAgB,EAAE,gBAAgB,EAClC,YAAY,EAAE,QAAQ,EACtB,eAAe,EAAE,eAAe;IAGnD;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,kBAAkB,EAAE,GAAG,IAAI;IAKpD;;;;;OAKG;IACH,WAAW,IAAI,IAAI;IAKnB,OAAO,IAAI,IAAI;IAKf,OAAO,CAAC,IAAI;IAuBZ;;;;;OAKG;IACH,OAAO,CAAC,OAAO;IA4Gf;;;;;;;;OAQG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACH,OAAO,CAAC,UAAU;IAiBlB;;;;;;;;OAQG;IACH,OAAO,CAAC,kBAAkB;IAmC1B,OAAO,CAAC,UAAU;IAwClB;;;;;OAKG;IACH,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,MAAM;CAQf"}