@rokt/dcui-orchestrator 1.2.1-rc.3 → 1.2.1-rc.31

package/dist/libraries/dcui-components/src/components/data-mapper/data-mapper.d.ts

@@ -5,9 +5,13 @@ export type DataObject = {
 export type StateOnlyObject = {
     state: object;
 };
+export type AttributeOnlyObject = {
+    attribute: object;
+};
 export type ExtendableDataMapper = ReturnType<typeof createDataMapper>;
 export declare function createDataMapper(data: object, namespace?: string): {
     (template: string): string;
     (stateObj: StateOnlyObject, namespace?: string): /*elided*/ any;
+    (attributeObj: AttributeOnlyObject, namespace?: string): /*elided*/ any;
     (dataObj: DataObject, namespace: string): /*elided*/ any;
 };

package/dist/libraries/dcui-components/src/components/index.d.ts

@@ -31,3 +31,6 @@ export * from './form';
 export * from './text-input';
 export * from './action-button';
 export * from './apple-pay-button';
+export * from './paypal-button';
+export * from './progress-indicator';
+export * from './progress-control';

package/dist/libraries/dcui-components/src/components/paypal-button/index.d.ts

@@ -0,0 +1 @@
+export * from './paypal-button';

package/dist/libraries/dcui-components/src/components/paypal-button/paypal-button.d.ts

@@ -0,0 +1,78 @@
+import React from 'react';
+import type { ThemeColor } from '@rokt/dcui-layout-schema';
+/**
+ * Renders a PayPal-branded button whose look is fixed to the options in
+ * PayPal's button style guide (colors, shapes, height range), the same way
+ * ApplePayButton only offers Apple's styles. Layout styles can pick between
+ * those options but cannot restyle the brand.
+ * @see https://developer.paypal.com/docs/multiparty/checkout/standard/customize/buttons-style-guide/
+ */
+export type PayPalButtonColor = 'gold' | 'blue' | 'silver' | 'white' | 'black';
+export type PayPalButtonStyle = {
+    color: {
+        light: PayPalButtonColor;
+        dark?: PayPalButtonColor;
+    };
+};
+export declare const PAYPAL_BUTTON_MIN_HEIGHT = 25;
+export declare const PAYPAL_BUTTON_MAX_HEIGHT = 55;
+export declare const PAYPAL_BUTTON_DEFAULT_HEIGHT = 45;
+export declare const PAYPAL_BUTTON_DEFAULT_RADIUS = 4;
+/**
+ * Base `own` styles to merge under the layout's own styles (with
+ * mergeStylesWithDefaults), so the defaults sit in the normal style cascade:
+ * layout breakpoints, pseudo-states and conditional transitions override them
+ * only where they apply.
+ */
+export declare const PAYPAL_BUTTON_DEFAULT_OWN_STYLES: {
+    readonly dimension: {
+        readonly height: {
+            readonly type: "fixed";
+            readonly value: 45;
+        };
+    };
+    readonly border: {
+        readonly borderRadius: 4;
+    };
+};
+/**
+ * Structural shape of the `own` style hints this module reads, declared
+ * structurally so any schema node with `own` styles can pass itself.
+ */
+export type PayPalButtonStyleSource = {
+    styles?: {
+        elements?: {
+            own?: ReadonlyArray<{
+                default?: {
+                    background?: {
+                        backgroundColor?: ThemeColor | null;
+                    } | null;
+                } | null;
+            } | null> | null;
+        } | null;
+    } | null;
+};
+/**
+ * Derives the PayPal button color from the schema's `own` default styles.
+ * The background color picks gold, blue, silver, white or black by exact PayPal
+ * hex (#RGB, #RRGGBB, or alpha-first #ARGB / #AARRGGBB when fully opaque);
+ * anything else falls back to gold, PayPal's recommended color. A `dark` value
+ * applies in dark mode. Colors are brand-locked, so breakpoint blocks merge
+ * with last-non-null-wins, as for Apple Pay.
+ *
+ * Height and border radius are not derived: they stay in the layout's own
+ * class, merged over PAYPAL_BUTTON_DEFAULT_OWN_STYLES, and PayPalButton only
+ * bounds the height to PayPal's 25-55px range.
+ */
+export declare function derivePayPalButtonStyle(schema: PayPalButtonStyleSource): PayPalButtonStyle;
+type PayPalButtonProps = {
+    buttonStyle?: PayPalButtonStyle;
+    ariaLabel?: string;
+    className?: string;
+    disabled?: boolean;
+    onClick?: React.MouseEventHandler<HTMLButtonElement>;
+    tabIndex?: number;
+    testId?: string;
+};
+export declare const PayPalButton: React.ForwardRefExoticComponent<PayPalButtonProps & React.RefAttributes<HTMLButtonElement>>;
+export {};

package/dist/libraries/dcui-components/src/components/paypal-button/paypal-wordmark.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+/**
+ * PLACEHOLDER wordmark. Replace with the official PayPal wordmark SVG from
+ * PayPal's Logo and Marks resources once PayPal confirms the asset for this
+ * integration. Keep the two fills driven by the CSS variables below so the
+ * blue (light buttons) and white (dark buttons) variants keep working.
+ */
+export declare function PayPalWordmark(): React.JSX.Element;

package/dist/libraries/dcui-components/src/components/progress-control/index.d.ts

@@ -0,0 +1 @@
+export * from './progress-control';

package/dist/libraries/dcui-components/src/components/progress-control/progress-control.d.ts

@@ -0,0 +1,49 @@
+import React from 'react';
+import { ProgressControlModel, NonInteractableChildren, WhenPredicate } from '@rokt/dcui-layout-schema';
+export interface ProgressControlProps {
+    /**
+     *  - `a11yLabel`: the aria-label for the button
+     *  - `direction`: 'Forward' | 'Backward'.
+     *  - `children`: it can accept below nodes,
+     *    * `Row`
+     *    * `Column`
+     *    * `ZStack`
+     *    * `BasicText`
+     *    * `StaticImage`
+     *    * `When`
+     *    * `InlineContainer`
+     *  - `styles`:
+     *    * `elements`:
+     *      * `own`:
+     *        - `container`
+     *        - `background`
+     *        - `border`
+     *        - `dimension`
+     *        - `flexChild`
+     *        - `spacing`
+     *    * `transitions`:
+     *      - `type`: 'Conditional'
+     *      - `transition`:
+     *        * `predicates`: WhenPredicate[]
+     *        * `duration`: number
+     *        * `value`:
+     *          * `own`:
+     *            - `container`
+     *            - `background`
+     *            - `border`
+     *            - `dimension`
+     *            - `flexChild`
+     *            - `spacing`
+     */
+    schema: ProgressControlModel<NonInteractableChildren, WhenPredicate>;
+    testId?: string;
+    onClick: () => void;
+    /** Additional navigation boundary imposed by the owning renderer. */
+    disabled?: boolean;
+}
+/**The ProgressControl is a progress node that facilitates navigation
+ * through sequential steps or stages of a process or content.<br>
+ * It offers users the ability to move both forward and backward
+ * within a linear progression, allowing them to review and control their journey.<br>
+ * */
+export declare function ProgressControl(props: ProgressControlProps): React.JSX.Element;

package/dist/libraries/dcui-components/src/components/progress-indicator/get-progress-indicator-state.d.ts

@@ -0,0 +1,3 @@
+import { ProgressIndicatorStateProps } from './types';
+/** Resolve the schema's one-based (or end-relative) start position. */
+export declare function getProgressIndicatorState(numberOfGroups: number, activeIndex: number, startPosition?: number | null): ProgressIndicatorStateProps;

package/dist/libraries/dcui-components/src/components/progress-indicator/index.d.ts

@@ -0,0 +1,3 @@
+export * from './progress-indicator';
+export * from './types';
+export * from './get-progress-indicator-state';

package/dist/libraries/dcui-components/src/components/progress-indicator/progress-indicator.d.ts

@@ -0,0 +1,8 @@
+import * as React from 'react';
+import { ProgressIndicatorProps } from './types';
+/** The ProgressIndicator is a progress node that provides users with real-time
+ * feedback on the status of ongoing processes or actions.<br>
+ * It's a visual representation of progress, often displayed as a bar,
+ * circle, or numerical percentage.<br>
+ * */
+export declare function ProgressIndicator({ activeIndex, startIndex, numOfIndicators, schema, ariaLabel, }: ProgressIndicatorProps): React.JSX.Element | null;

package/dist/libraries/dcui-components/src/components/progress-indicator/types.d.ts

@@ -0,0 +1,88 @@
+import { ProgressIndicatorModel, WhenPredicate } from '@rokt/dcui-layout-schema';
+export interface ProgressIndicatorStateProps {
+    /** The number of indicators */
+    numOfIndicators: number;
+    /** The currently active index. */
+    activeIndex: number;
+    /** The index of the indicator to start displaying from **/
+    startIndex: number;
+}
+export interface ProgressIndicatorSchemaProps {
+    /**
+     *  - `indicator`: The string content of the indicator.
+     *  - `styles`:
+     *    * `elements`:
+     *      * `own`:
+     *        - `container`
+     *        - `background`
+     *        - `border`
+     *        - `dimension`
+     *        - `flexChild`
+     *        - `spacing`
+     *      * `indicator`:
+     *        - `container`
+     *        - `background`
+     *        - `border`
+     *        - `dimension`
+     *        - `flexChild`
+     *        - `spacing`
+     *        - `text`
+     *      * `activeIndicator`:
+     *        - `container`
+     *        - `background`
+     *        - `border`
+     *        - `dimension`
+     *        - `flexChild`
+     *        - `spacing`
+     *        - `text`
+     *      * `seenIndicator`:
+     *        - `container`
+     *        - `background`
+     *        - `border`
+     *        - `dimension`
+     *        - `flexChild`
+     *        - `spacing`
+     *        - `text`
+     *    * `transitions`:
+     *      - `type`: 'Conditional'
+     *      - `transition`:
+     *        * `predicates`: WhenPredicate[]
+     *        * `duration`: number
+     *        * `value`:
+     *          * `own`:
+     *            - `container`
+     *            - `background`
+     *            - `border`
+     *            - `dimension`
+     *            - `flexChild`
+     *            - `spacing`
+     *          * `indicator`:
+     *            - `container`
+     *            - `background`
+     *            - `border`
+     *            - `dimension`
+     *            - `flexChild`
+     *            - `spacing`
+     *            - `text`
+     *          * `activeIndicator`:
+     *            - `container`
+     *            - `background`
+     *            - `border`
+     *            - `dimension`
+     *            - `flexChild`
+     *            - `spacing`
+     *            - `text`
+     *          * `seenIndicator`:
+     *            - `container`
+     *            - `background`
+     *            - `border`
+     *            - `dimension`
+     *            - `flexChild`
+     *            - `spacing`
+     *            - `text`
+     */
+    schema: ProgressIndicatorModel<WhenPredicate>;
+}
+export interface ProgressIndicatorProps extends ProgressIndicatorSchemaProps, ProgressIndicatorStateProps {
+    ariaLabel?: string;
+}

package/dist/libraries/dcui-components/src/contexts/data-mapper-context.d.ts

@@ -1,20 +1,24 @@
 export declare const DataMapperContext: import("react").Context<{
     (template: string): string;
     (stateObj: import("..").StateOnlyObject, namespace?: string): /*elided*/ any;
+    (attributeObj: import("..").AttributeOnlyObject, namespace?: string): /*elided*/ any;
     (dataObj: import("..").DataObject, namespace: string): /*elided*/ any;
 }>;
 export declare const DataMapperConsumer: import("react").Consumer<{
     (template: string): string;
     (stateObj: import("..").StateOnlyObject, namespace?: string): /*elided*/ any;
+    (attributeObj: import("..").AttributeOnlyObject, namespace?: string): /*elided*/ any;
     (dataObj: import("..").DataObject, namespace: string): /*elided*/ any;
 }>;
 export declare const DataMapperProvider: import("react").Provider<{
     (template: string): string;
     (stateObj: import("..").StateOnlyObject, namespace?: string): /*elided*/ any;
+    (attributeObj: import("..").AttributeOnlyObject, namespace?: string): /*elided*/ any;
     (dataObj: import("..").DataObject, namespace: string): /*elided*/ any;
 }>;
 export declare const useDataMapper: () => {
     (template: string): string;
     (stateObj: import("..").StateOnlyObject, namespace?: string): /*elided*/ any;
+    (attributeObj: import("..").AttributeOnlyObject, namespace?: string): /*elided*/ any;
     (dataObj: import("..").DataObject, namespace: string): /*elided*/ any;
 };

package/dist/libraries/dcui-components/src/contexts/index.d.ts

@@ -3,6 +3,7 @@ export * from './global-state-context';
 export * from './node-mapper-context';
 export * from './root-element-context';
 export * from './offer-data-context';
+export * from './lead-capture-offer-context';
 export * from './data-mapper-context';
 export * from './scoped-style-mapper-context';
 export * from './layout-schema-type-context';

package/dist/libraries/dcui-components/src/contexts/lead-capture-offer-context.d.ts

@@ -0,0 +1,5 @@
+import { PluginOffer } from '../../../domain/src/models';
+/** Resolves the offer whose referral response a lead form belongs to. */
+export type LeadCaptureOfferResolver = (offerPositionIndex?: number) => PluginOffer | undefined;
+export declare const LeadCaptureOfferContext: import("react").Context<LeadCaptureOfferResolver>;
+export declare const useLeadCaptureOffer: () => LeadCaptureOfferResolver;

package/dist/libraries/dcui-components/src/contexts/validators/validator-provider.d.ts

@@ -1,14 +1,16 @@
-import { ReactNode } from 'react';
+import { ReactNode, RefObject } from 'react';
 export type Validator = () => boolean;
 export interface ValidatorFieldData {
     validators: Validator[];
     isValid: boolean;
+    element?: HTMLElement;
 }
 export type ValidatorMap = Record<string, ValidatorFieldData>;
 export interface ValidatorContextType {
-    registerValidators: (validatorFieldKey: string, validators: Validator[]) => void;
+    registerValidators: (validatorFieldKey: string, validators: Validator[], element?: HTMLElement) => void;
     validateFieldKeys: (validatorFieldKey: string[]) => boolean;
     getFieldKeyValidity: (validatorFieldKey: string) => boolean;
+    focusFirstInvalidField?: () => void;
 }
 export declare const ValidatorContext: import("react").Context<ValidatorContextType | null>;
 /**
@@ -21,4 +23,4 @@ export declare function ValidatorProvider(props: {
     children: ReactNode;
 }): import("react").JSX.Element;
 export declare function useValidator(): ValidatorContextType;
-export declare function useRegisterValidators(validationFieldKey: string | undefined, validators: Validator[]): void;
+export declare function useRegisterValidators(validationFieldKey: string | undefined, validators: Validator[], targetRef?: RefObject<HTMLElement | null>): void;

package/dist/libraries/dcui-components/src/failure-codes.d.ts

@@ -5,3 +5,4 @@ export declare const FAILED_TEMPLATING_DATA = "FAILED_TEMPLATING_DATA";
 export declare const FAILED_TO_MAP_STATIC_DATA = "FAILED_TO_MAP_STATIC_DATA";
 export declare const FAILED_SANITISING_HTML = "FAILED_SANITISING_HTML";
 export declare const UNRESOLVED_FORM_VALIDATION_TARGET = "UNRESOLVED_FORM_VALIDATION_TARGET";
+export declare const MISSING_LEAD_IDENTITY = "MISSING_LEAD_IDENTITY";

package/dist/libraries/domain/src/behaviors/continuous-child.d.ts

@@ -0,0 +1,62 @@
+import { LinkOpenTarget } from '@rokt/dcui-layout-schema';
+import { PluginChildLayoutModel } from '../models';
+/** Plugin builds support explicit continuationKey opt-in; standalone consumers stay off. */
+export declare function isContinuousChildEnabled(environment: string | undefined): boolean;
+export declare const CONTINUOUS_CHILD_CAPABILITY_ENABLED: boolean;
+export declare const CONTINUOUS_CHILD_VERSION = 1;
+export declare const CONTINUOUS_CHILD_EVENTS: {
+    readonly READY: "CONTINUOUS_CHILD/READY";
+    readonly PRESENTATION: "CONTINUOUS_CHILD/PRESENTATION";
+    readonly APPLIED: "CONTINUOUS_CHILD/APPLIED";
+    readonly REQUEST: "CONTINUOUS_CHILD/REQUEST";
+    readonly EXPOSURE: "CONTINUOUS_CHILD/EXPOSURE";
+};
+/** Generated Web 1.30 child schema contract. */
+export type ContinuousChildSchema = PluginChildLayoutModel['childLayoutSchema'];
+export interface ContinuousIdentity {
+    sessionId: string;
+    revision: number;
+    position: number;
+    creativeInstanceGuid: string;
+    /** Optional serving tracking metadata; session/revision and creative identity remain required. */
+    childInstanceGuid?: string;
+}
+export interface ContinuousPresentationInput {
+    config: PluginChildLayoutModel;
+    position: number;
+    ownsViewability: boolean;
+}
+export interface ContinuousPresentation extends ContinuousPresentationInput {
+    identity: ContinuousIdentity;
+    totalCount: number;
+}
+export interface ContinuousRequest {
+    identity: ContinuousIdentity;
+    actionId: string;
+    openLinks?: LinkOpenTarget;
+    dismissalMethod?: string;
+    inferredView?: {
+        supportedByBrowser: boolean;
+    };
+    action: 'next' | 'previous' | 'positive' | 'negative' | 'close';
+}
+export interface ContinuousExposure {
+    identity: ContinuousIdentity;
+    kind: 'rendered' | 'qualified';
+    inferred: boolean;
+    supportedByBrowser: boolean;
+}
+export declare const continuousEnvelope: <T>(payload: T) => {
+    version: number;
+    payload: T;
+};
+export declare function isContinuousEnvelope(value: unknown): value is {
+    version: 1;
+    payload: unknown;
+};
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function isContinuousIdentity(value: unknown): value is ContinuousIdentity;
+export declare function sameContinuousIdentity(a: ContinuousIdentity, b: ContinuousIdentity): boolean;
+export declare function isContinuousRequest(value: unknown): value is ContinuousRequest;
+export declare function isContinuousExposure(value: unknown): value is ContinuousExposure;
+export declare function isContinuousPresentation(value: unknown): value is ContinuousPresentation;

package/dist/libraries/domain/src/behaviors/custom-states.d.ts

@@ -17,7 +17,7 @@ export declare function isValidSetCustomStatePayload(payload: unknown): payload
 export declare const DEVICE_PAY_PROCESSING_STATE_KEY = "ProcessingState";
 export declare const DEVICE_PAY_PROCESSING_IDLE = 0;
 export declare const DEVICE_PAY_PROCESSING_IN_FLIGHT = 1;
-export declare const DEVICE_PAY_AVAILABILITY_KEYS: readonly ["applePay", "afterpay"];
+export declare const DEVICE_PAY_AVAILABILITY_KEYS: readonly ["applePay", "afterpay", "paypal"];
 export type DevicePayProviderKey = (typeof DEVICE_PAY_AVAILABILITY_KEYS)[number];
 export declare const DEVICE_PAY_APPLE_PAY_AVAILABLE_STATE_KEY = "applePayAvailable";
 export declare const DEVICE_PAY_ERROR_STATE_KEY = "DevicePayErrorState";

package/dist/libraries/domain/src/behaviors/index.d.ts

@@ -18,3 +18,4 @@ export * from './dismiss-overlay';
 export * from './trigger-action';
 export * from './form-state';
 export * from './report-error';
+export * from './continuous-child';

package/dist/libraries/domain/src/behaviors/offer-engagement.d.ts

@@ -14,10 +14,12 @@ export interface OfferEngagementFulfillmentPayload {
     fulfillment: Fulfillment;
     accountID: string;
     referralCreativeID?: string;
+    adID?: string;
 }
 export interface OfferEngagementUrlPayload extends PluginCreativeUrlResponseOption {
     accountID: string;
     referralCreativeID?: string;
+    adID?: string;
     creativeInstanceGuid?: string;
 }
 export interface OfferEngagementProductItemResponsePayload extends OfferEngagementUrlPayload {
@@ -44,6 +46,15 @@ export declare function isRealTimeReferralOnly(response: OfferEngagementPayload
 })): response is OfferEngagementPayload & {
     accountID: string;
     referralCreativeID: string;
+    adID?: string;
+};
+/**
+ * `adID` is the key the Web SDK's realtime-conversion-promotion extension reads.
+ * Anything but a non-empty string yields no key, so a payload or event without
+ * an ad id keeps exactly the keys it had before.
+ */
+export declare function adIDField(adID: string | undefined): {
+    adID?: string;
 };
 export declare function makeCaptureOnlyOfferEngagementPayload(offerPayload?: Partial<OfferEngagementCaptureOnlyPayload>): OfferEngagementCaptureOnlyPayload;
 export declare function makeUrlOfferEngagementPayload(offerPayload?: Partial<OfferEngagementUrlPayload>): OfferEngagementUrlPayload;

package/dist/libraries/domain/src/behaviors/send-partner.d.ts

@@ -14,6 +14,7 @@ export type OutboundRealtimeOfferFulfillmentReferralEventPayload = {
         rclid: string;
         accountID: string;
         referralCreativeID: string;
+        adID?: string;
         referralOnly?: boolean;
         rewardHandoff?: boolean;
     };
@@ -24,6 +25,7 @@ export type OutboundRealtimeOfferFulfillmentConversionEventPayload = {
         rclid: string;
         accountID: string;
         referralCreativeID: string;
+        adID?: string;
         rewardHandoff?: boolean;
     };
 };
@@ -80,10 +82,20 @@ export type OutboundAbortDevicePayEventPayload = {
 export type OutboundCompleteDevicePayEventPayload = {
     name: 'COMPLETE_DEVICE_PAY_EVENT';
 };
-export type OutboundPartnerEventPayload<EventType extends OutboundPartnerEvent> = EventType extends 'REALTIME_OFFER_FULFILLMENT_REFERRAL' ? OutboundRealtimeOfferFulfillmentReferralEventPayload : EventType extends 'REALTIME_OFFER_FULFILLMENT_CONVERSION' ? OutboundRealtimeOfferFulfillmentConversionEventPayload : EventType extends 'REALTIME_OFFER_FULFILLMENT_SUCCESS' ? OutboundRealtimeOfferFulfillmentSuccessEventPayload : EventType extends 'V2_CART_ITEM_UPDATED' | 'UPDATE_CART_ITEM_MESSAGE' | 'CART_ITEM_INSTANT_PURCHASE' | 'UPSELL_ITEM_INSTANT_PURCHASE' | 'UPSELL_CREATIVE_SENT' | 'INITIATE_INSTANT_PURCHASE_EVENT' | 'INSTANT_PURCHASE_INITIATE_TAX_AND_SHIPPING_EVENT' | 'INITIATE_CART_ITEM_EVENT' | 'DELIVERY_DETAILS_SENT' | 'PREPARE_DEVICE_PAY_EVENT' | 'INITIATE_DEVICE_PAY_EVENT' | 'ABORT_DEVICE_PAY_EVENT' | 'COMPLETE_DEVICE_PAY_EVENT' ? never : {
+export type OutboundLeadCaptureSubmittedEventPayload = {
+    name: 'LEAD_CAPTURE_SUBMITTED';
+    body: {
+        email?: string;
+        mobile_number?: string;
+        rclid?: string;
+        accountID?: string;
+        referralCreativeID?: string;
+    };
+};
+export type OutboundPartnerEventPayload<EventType extends OutboundPartnerEvent> = EventType extends 'LEAD_CAPTURE_SUBMITTED' ? OutboundLeadCaptureSubmittedEventPayload : EventType extends 'REALTIME_OFFER_FULFILLMENT_REFERRAL' ? OutboundRealtimeOfferFulfillmentReferralEventPayload : EventType extends 'REALTIME_OFFER_FULFILLMENT_CONVERSION' ? OutboundRealtimeOfferFulfillmentConversionEventPayload : EventType extends 'REALTIME_OFFER_FULFILLMENT_SUCCESS' ? OutboundRealtimeOfferFulfillmentSuccessEventPayload : EventType extends 'V2_CART_ITEM_UPDATED' | 'UPDATE_CART_ITEM_MESSAGE' | 'CART_ITEM_INSTANT_PURCHASE' | 'UPSELL_ITEM_INSTANT_PURCHASE' | 'UPSELL_CREATIVE_SENT' | 'INITIATE_INSTANT_PURCHASE_EVENT' | 'INSTANT_PURCHASE_INITIATE_TAX_AND_SHIPPING_EVENT' | 'INITIATE_CART_ITEM_EVENT' | 'DELIVERY_DETAILS_SENT' | 'PREPARE_DEVICE_PAY_EVENT' | 'INITIATE_DEVICE_PAY_EVENT' | 'ABORT_DEVICE_PAY_EVENT' | 'COMPLETE_DEVICE_PAY_EVENT' ? never : {
     name: EventType;
 };
 export type SendPartner<EventType extends OutboundPartnerEvent> = {
     type: typeof SEND_PARTNER;
-    payload: OutboundPartnerEventPayload<EventType> | OutboundUpdateCartEventPayload | OutboundUpdateCartItemMessageEventPayload | OutboundInstantPurchaseEventPayload | OutboundUpsellItemInstantPurchaseEventPayload | OutboundUpsellCreativeSentEventPayload | OutboundInstantPurchaseWsdkEventPayload | OutboundInstantPurchaseTaxAndShippingEventPayload | OutboundCartItemEventPayload | OutboundDeliveryDetailsSentEventPayload | OutboundPrepareDevicePayEventPayload | OutboundDevicePayEventPayload | OutboundAbortDevicePayEventPayload | OutboundCompleteDevicePayEventPayload;
+    payload: OutboundPartnerEventPayload<EventType> | OutboundUpdateCartEventPayload | OutboundUpdateCartItemMessageEventPayload | OutboundInstantPurchaseEventPayload | OutboundUpsellItemInstantPurchaseEventPayload | OutboundUpsellCreativeSentEventPayload | OutboundInstantPurchaseWsdkEventPayload | OutboundInstantPurchaseTaxAndShippingEventPayload | OutboundCartItemEventPayload | OutboundDeliveryDetailsSentEventPayload | OutboundPrepareDevicePayEventPayload | OutboundDevicePayEventPayload | OutboundAbortDevicePayEventPayload | OutboundCompleteDevicePayEventPayload | OutboundLeadCaptureSubmittedEventPayload;
 };

package/dist/libraries/domain/src/behaviors/trigger-action.d.ts

@@ -1,14 +1,14 @@
-import { LayoutAction, LayoutVariantAction, OuterLayoutAction } from '@rokt/dcui-layout-schema';
+import { ChildLayoutAction, LayoutAction, LayoutVariantAction, OuterLayoutAction } from '@rokt/dcui-layout-schema';
 import { PluginOffer } from '../models';
 export declare const TRIGGER_ACTION = "GLOBAL/TRIGGER_ACTION";
 /**
  * Actions a trigger (e.g. a layout timer or button) can carry. A trigger may
- * originate in any of the three layout contexts, so the channel accepts the
+ * originate in any of the four layout contexts, so the channel accepts the
  * union of all their action sets rather than assuming one stays a superset of
  * the others. This keeps producers in every context assignable even if the
  * sets diverge in future schema versions.
  */
-export type TriggerableAction = LayoutAction | OuterLayoutAction | LayoutVariantAction;
+export type TriggerableAction = LayoutAction | OuterLayoutAction | LayoutVariantAction | ChildLayoutAction;
 export interface TriggerAction {
     type: typeof TRIGGER_ACTION;
     payload: {

package/dist/libraries/domain/src/models/child-layout-response.d.ts

@@ -0,0 +1,6 @@
+import { PluginOffer } from './plugin/plugin-offer';
+import { PluginCreativeCaptureOnlyResponseOption, PluginCreativeUrlResponseOption } from './plugin/plugin-creative-response-option';
+/** Child acceptance supports ordinary positive URLs, not deferred fulfillment. */
+export declare function getChildPositiveResponse(offer: PluginOffer | null, responseKey: string): PluginCreativeUrlResponseOption | undefined;
+/** Persistent children dispatch ordinary responses through the current parent module. */
+export declare function getContinuousChildResponse(offer: PluginOffer | null, responseKey: 'positive' | 'negative'): PluginCreativeUrlResponseOption | PluginCreativeCaptureOnlyResponseOption | undefined;

package/dist/libraries/domain/src/models/index.d.ts

@@ -14,3 +14,4 @@ export * from './interactivity';
 export * from './child-plugin';
 export * from './purchase';
 export * from './shipping';
+export * from './child-layout-response';

package/dist/libraries/domain/src/models/layout/layout-offer.d.ts

@@ -4,6 +4,8 @@ import { LayoutTransactionData } from './layout-transaction-data';
 export interface LayoutOffer {
     campaignId: string;
     accountId: string;
+    /** The rendered ad's id; absent until the transactions API sends it. */
+    adId?: string;
     maxTotalItemsQtyInOffer: number;
     creative: LayoutCreative;
     metadata: Record<string, string>;

package/dist/libraries/domain/src/models/partner-event.d.ts

@@ -1,5 +1,5 @@
 export type CatalogOutboundPartnerEvent = 'V2_CART_ITEM_UPDATED' | 'UPDATE_CART_ITEM_MESSAGE' | 'CART_ITEM_INSTANT_PURCHASE' | 'UPSELL_ITEM_INSTANT_PURCHASE' | 'DELIVERY_DETAILS_SENT';
-export type OfferOutboundPartnerEvent = CatalogOutboundPartnerEvent | 'OFFER_ENGAGEMENT' | 'POSITIVE_ENGAGEMENT' | 'UPSELL_CREATIVE_SENT' | 'REALTIME_OFFER_FULFILLMENT_REFERRAL' | 'REALTIME_OFFER_FULFILLMENT_CONVERSION' | 'REALTIME_OFFER_FULFILLMENT_SUCCESS' | 'INITIATE_INSTANT_PURCHASE_EVENT' | 'INSTANT_PURCHASE_INITIATE_TAX_AND_SHIPPING_EVENT' | 'INITIATE_CART_ITEM_EVENT' | 'PREPARE_DEVICE_PAY_EVENT' | 'INITIATE_DEVICE_PAY_EVENT' | 'ABORT_DEVICE_PAY_EVENT' | 'COMPLETE_DEVICE_PAY_EVENT';
+export type OfferOutboundPartnerEvent = CatalogOutboundPartnerEvent | 'OFFER_ENGAGEMENT' | 'POSITIVE_ENGAGEMENT' | 'UPSELL_CREATIVE_SENT' | 'REALTIME_OFFER_FULFILLMENT_REFERRAL' | 'REALTIME_OFFER_FULFILLMENT_CONVERSION' | 'REALTIME_OFFER_FULFILLMENT_SUCCESS' | 'INITIATE_INSTANT_PURCHASE_EVENT' | 'INSTANT_PURCHASE_INITIATE_TAX_AND_SHIPPING_EVENT' | 'INITIATE_CART_ITEM_EVENT' | 'PREPARE_DEVICE_PAY_EVENT' | 'INITIATE_DEVICE_PAY_EVENT' | 'ABORT_DEVICE_PAY_EVENT' | 'COMPLETE_DEVICE_PAY_EVENT' | 'LEAD_CAPTURE_SUBMITTED';
 export type OutboundPartnerEvent = OfferOutboundPartnerEvent | 'PLACEMENT_CLOSED' | 'PLACEMENT_COMPLETED' | 'PLACEMENT_INTERACTIVE' | 'PLACEMENT_FAILURE';
 export declare function isOutboundPartnerEvent(value: unknown): value is OutboundPartnerEvent;
 export declare function isOfferOutboundPartnerEvent(value: unknown): value is OfferOutboundPartnerEvent;

package/dist/libraries/domain/src/models/plugin/plugin-child-layout-model.d.ts

@@ -3,6 +3,7 @@ import { Fonts } from '@rokt/plugin';
 import { SyncedGlobalState } from '../global-state';
 import { PluginOffer } from './plugin-offer';
 export interface PluginChildLayoutModel<ChildRootLayoutSchema = ChildRootSchemaModel<LayoutSchemaModel, LayoutDisplayPreset, LayoutSettings, WhenPredicate>> {
+    continuousPresentation?: import('../../behaviors/continuous-child').ContinuousIdentity;
     instanceGuid: string;
     childLayoutId: string;
     layoutSchemaVersion: string;

package/dist/libraries/domain/src/models/plugin/plugin-offer.d.ts

@@ -5,6 +5,8 @@ import { TransactionData } from './plugin-transaction-data';
 export interface PluginOffer {
     campaignId: string;
     accountId: string;
+    /** The rendered ad's id; absent until the transactions API sends it. */
+    adId?: string;
     maxTotalItemsQtyInOffer: number;
     creative: PluginCreative;
     metadata: Record<string, string>;

package/dist/libraries/layout-renderer-utils/src/actions/attributes.d.ts

@@ -0,0 +1,7 @@
+import { AttributesState } from '../models';
+export declare const SET_ATTRIBUTES = "ATTRIBUTES/SET";
+export type SetAttributesAction = {
+    type: typeof SET_ATTRIBUTES;
+    payload: AttributesState;
+};
+export type AttributesActions = SetAttributesAction;

package/dist/libraries/layout-renderer-utils/src/actions/index.d.ts

@@ -1,6 +1,7 @@
 import { OpenLink, PrepareSignal, RaiseMetric, RaiseSignal, SendPartner, SetDomainState } from '../../../domain/src/behaviors';
 import { ActiveStateActions } from './active';
 import { BreakpointActions, SetBreakpoints } from './breakpoint';
+import { AttributesActions } from './attributes';
 import { FontsActions } from './fonts';
 import { LayoutActions } from './layout';
 import { ClosePlugin } from './plugin';
@@ -25,16 +26,18 @@ export * from './error';
 export * from './log';
 export * from './overlay';
 export * from './plugin';
+export * from './attributes';
 export * from './custom-states';
 export * from './domain-states';
 export * from './form-states';
-export type CoreStateActions = LayoutActions | BreakpointActions | ActiveStateActions | FontsActions | SignalStateActions | SerializableCacheActions | SettingsActions | CustomStatesActions | SetDomainStateReducer | LayoutEventAction | FormStatesActions;
+export type CoreStateActions = LayoutActions | BreakpointActions | ActiveStateActions | AttributesActions | FontsActions | SignalStateActions | SerializableCacheActions | SettingsActions | CustomStatesActions | SetDomainStateReducer | LayoutEventAction | FormStatesActions;
 export declare const coreStateActionTypes: {
     readonly LAYOUT_UPDATE: "LAYOUT/UPDATE";
     readonly UPDATE_ACTIVE_BREAKPOINT: "BREAKPOINT/UPDATE_ACTIVE";
     readonly INITIALISE_BREAKPOINT: "BREAKPOINT/INITIALISE";
     readonly ACTIVE_ADD: "ACTIVE/ADD";
     readonly ACTIVE_DELETE: "ACTIVE/DELETE";
+    readonly SET_ATTRIBUTES: "ATTRIBUTES/SET";
     readonly SET_FONTS: "FONTS/SET";
     readonly QUEUE_SIGNAL: "SIGNAL/QUEUE";
     readonly SIGNAL_PROCESSED: "SIGNAL/PROCESSED";

package/dist/libraries/layout-renderer-utils/src/models/state/attributes.d.ts

@@ -0,0 +1,2 @@
+import { NormalizedAttributes } from '@rokt/plugin/interface/attributes';
+export type AttributesState = NormalizedAttributes;

package/dist/libraries/layout-renderer-utils/src/models/state/index.d.ts

@@ -1,4 +1,5 @@
 import { ActiveState } from './active';
+import { AttributesState } from './attributes';
 import { BreakpointState } from './breakpoint';
 import { FontsState } from './fonts';
 import { LayoutState } from './layout';
@@ -9,6 +10,7 @@ import { CustomStatesIndexState } from './custom-states';
 import { FiredEventsIndexState } from './fired-events';
 import { FormStatesIndexState } from './form-states';
 export * from './active';
+export * from './attributes';
 export * from './breakpoint';
 export * from './fonts';
 export * from './layout';
@@ -22,6 +24,7 @@ export type CoreAppState = {
     layout: LayoutState;
     breakpoint: BreakpointState;
     active: ActiveState;
+    attributes: AttributesState;
     fonts: FontsState;
     signal: SignalState;
     serializableCache: SerializableCacheState;

package/dist/libraries/layout-renderer-utils/src/reducers/attributes/index.d.ts

@@ -0,0 +1 @@
+export * from './reducer';