@rokt/dcui-orchestrator 0.2.1-rc.9 → 0.3.0

package/dist/libraries/domain/src/behaviors/cart-item-event.d.ts

@@ -0,0 +1,44 @@
+import { Shipping } from '../models';
+export declare const INITIATE_CART_ITEM_EVENT = "GLOBAL/CART_ITEM_EVENT/INITIATE";
+export type InitiateCartItemPayload = {
+    cartItemId: string;
+    formData?: Shipping;
+};
+export type InitiateCartItemEvent = {
+    type: typeof INITIATE_CART_ITEM_EVENT;
+    payload: InitiateCartItemPayload;
+};
+export type CartItemSuccessData = {
+    cartItemId: string;
+    totalPrice: number;
+    currencyCode: string;
+    providerData: string;
+    shipping: Shipping;
+    success: true;
+};
+export type CartItemValidationError = {
+    code: string;
+    message: string;
+};
+export type CartItemFailureData = {
+    description?: string;
+    success: false;
+    errors: CartItemValidationError[];
+};
+export type CartItemResponseData = CartItemSuccessData | CartItemFailureData;
+export type CartItemResponsePayload = {
+    success: boolean;
+    error?: string;
+    timestamp: string;
+    sessionId: string;
+    response?: CartItemResponseData;
+};
+export declare const CART_ITEM_RESPONSE = "GLOBAL/CART_ITEM_EVENT/RESPONSE";
+export type CartItemResponse = {
+    type: typeof CART_ITEM_RESPONSE;
+    payload: CartItemResponsePayload;
+};
+export declare const INITIALIZE_CART_SERVICE = "GLOBAL/CART_SERVICE/INITIALIZE";
+export type InitializeCartService = {
+    type: typeof INITIALIZE_CART_SERVICE;
+};

package/dist/libraries/domain/src/behaviors/dismiss-overlay.d.ts

@@ -0,0 +1,9 @@
+export declare const DISMISS_OVERLAY = "OVERLAY/DISMISS_OVERLAY";
+export declare const OVERLAY_ID = "plugin-overlay";
+export interface DismissOverlay {
+    type: typeof DISMISS_OVERLAY;
+    payload: {
+        id: string;
+        dismissalMethod?: string;
+    };
+}

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

@@ -1,10 +1,10 @@
-import { LayoutVariantDomainStateKey } from '@rokt/dcui-layout-schema';
+import { LayoutVariantDomainStateKey, OuterLayoutDomainStateKey } from '@rokt/dcui-layout-schema';
 export declare const SET_DOMAIN_STATE = "GLOBAL/SET_DOMAIN_STATE";
 export interface SetDomainState {
     type: typeof SET_DOMAIN_STATE;
     payload: SetDomainStatePayload;
 }
 export interface SetDomainStatePayload {
-    key: LayoutVariantDomainStateKey;
+    key: LayoutVariantDomainStateKey | OuterLayoutDomainStateKey;
     value: number;
 }

package/dist/libraries/domain/src/behaviors/form-state.d.ts

@@ -0,0 +1,66 @@
+import { InputValidation } from '@rokt/dcui-layout-schema';
+/**
+ * Global form-state behaviors. These are dispatched by the TextInput and
+ * ActionButton nodes via the GlobalActions context and translated into
+ * offer-scoped store actions by the GlobalStoreProxy (which injects the
+ * `offerPositionIndex`), mirroring how SET_CUSTOM_STATE works.
+ *
+ * The form's `validationMode` is intentionally NOT stored — it is provided to
+ * descendants through the React FormContext, and the component decides whether
+ * a value change should validate via the `validate` flag below. This keeps the
+ * reducer mode-agnostic.
+ */
+export declare const REGISTER_FORM_FIELD = "GLOBAL/REGISTER_FORM_FIELD";
+export declare const UNREGISTER_FORM_FIELD = "GLOBAL/UNREGISTER_FORM_FIELD";
+export declare const SET_FORM_FIELD_VALUE = "GLOBAL/SET_FORM_FIELD_VALUE";
+export declare const SET_FORM_FIELD_TOUCHED = "GLOBAL/SET_FORM_FIELD_TOUCHED";
+export declare const VALIDATE_FORM_FIELDS = "GLOBAL/VALIDATE_FORM_FIELDS";
+export interface RegisterFormFieldPayload {
+    formKey: string;
+    fieldKey: string;
+    defaultValue: string;
+    validations: InputValidation[];
+}
+export interface SetFormFieldValuePayload {
+    formKey: string;
+    fieldKey: string;
+    value: string;
+    /**
+     * When true, the field is re-validated as part of applying the value (used
+     * for on-change mode and for fields that have already been validated).
+     */
+    validate: boolean;
+}
+export interface UnregisterFormFieldPayload {
+    formKey: string;
+    fieldKey: string;
+}
+export interface SetFormFieldTouchedPayload {
+    formKey: string;
+    fieldKey: string;
+}
+export interface ValidateFormFieldsPayload {
+    /** Raw `validates` entries — bare form keys and/or dot-notation field keys. */
+    entries: string[];
+}
+export interface RegisterFormField {
+    type: typeof REGISTER_FORM_FIELD;
+    payload: RegisterFormFieldPayload;
+}
+export interface UnregisterFormField {
+    type: typeof UNREGISTER_FORM_FIELD;
+    payload: UnregisterFormFieldPayload;
+}
+export interface SetFormFieldValue {
+    type: typeof SET_FORM_FIELD_VALUE;
+    payload: SetFormFieldValuePayload;
+}
+export interface SetFormFieldTouched {
+    type: typeof SET_FORM_FIELD_TOUCHED;
+    payload: SetFormFieldTouchedPayload;
+}
+export interface ValidateFormFields {
+    type: typeof VALIDATE_FORM_FIELDS;
+    payload: ValidateFormFieldsPayload;
+}
+export type FormStateBehaviors = RegisterFormField | UnregisterFormField | SetFormFieldValue | SetFormFieldTouched | ValidateFormFields;

package/dist/libraries/domain/src/behaviors/global-actions.d.ts

@@ -6,12 +6,17 @@ import { SetCustomState } from './custom-states';
 import { SendPartner } from './send-partner';
 import { OfferOutboundPartnerEvent } from '../models';
 import { SetDomainState } from './domain-states';
+import { LayoutEventAction } from './layout-events';
 import { PrepareSignal } from './prepare-signal';
 import { OpenLink } from './open-link';
 import { SetPartnerValidationStatus } from './partner-validation';
 import { SetGlobalOfferDataCart } from './global-offer-data-state';
 import { LaunchChildLayout } from './child-layout';
-export type GlobalActions = RaiseMetric | PrepareSignal | OfferEngagement | RaiseSignal | OfferLifecycle | SendPartner<OfferOutboundPartnerEvent> | SetCustomState | SetDomainState | OpenLink | SetPartnerValidationStatus | SetGlobalOfferDataCart | LaunchChildLayout;
+import { DismissOverlay } from './dismiss-overlay';
+import { TriggerAction } from './trigger-action';
+import { ReportError } from './report-error';
+import { FormStateBehaviors } from './form-state';
+export type GlobalActions = RaiseMetric | PrepareSignal | OfferEngagement | RaiseSignal | OfferLifecycle | SendPartner<OfferOutboundPartnerEvent> | SetCustomState | SetDomainState | LayoutEventAction | OpenLink | SetPartnerValidationStatus | SetGlobalOfferDataCart | LaunchChildLayout | DismissOverlay | TriggerAction | FormStateBehaviors | ReportError;
 export declare const GlobalActionTypes: {
     readonly RAISE_METRIC: "GLOBAL/RAISE_METRIC";
     readonly PREPARE_SIGNAL: "GLOBAL/PREPARE_SIGNAL";
@@ -21,9 +26,20 @@ export declare const GlobalActionTypes: {
     readonly SEND_PARTNER: "GLOBAL/SEND_PARTNER";
     readonly SET_CUSTOM_STATE: "GLOBAL/SET_CUSTOM_STATE";
     readonly SET_DOMAIN_STATE: "GLOBAL/SET_DOMAIN_STATE";
+    readonly LAYOUT_EVENT: "GLOBAL/LAYOUT_EVENT";
     readonly OPEN_LINK: "GLOBAL/OPEN_LINK";
     readonly SET_PARTNER_VALIDATION_STATUS: "GLOBAL/SET_PARTNER_VALIDATION_STATUS";
     readonly SET_GLOBAL_OFFER_DATA_CART: "GLOBAL/SET_GLOBAL_OFFER_DATA_CART";
     readonly LAUNCH_CHILD_LAYOUT: "GLOBAL/LAUNCH_CHILD_LAYOUT";
+    readonly INITIATE_CART_ITEM_EVENT: "GLOBAL/CART_ITEM_EVENT/INITIATE";
+    readonly CART_ITEM_RESPONSE: "GLOBAL/CART_ITEM_EVENT/RESPONSE";
+    readonly DISMISS_OVERLAY: "OVERLAY/DISMISS_OVERLAY";
+    readonly TRIGGER_ACTION: "GLOBAL/TRIGGER_ACTION";
+    readonly REGISTER_FORM_FIELD: "GLOBAL/REGISTER_FORM_FIELD";
+    readonly UNREGISTER_FORM_FIELD: "GLOBAL/UNREGISTER_FORM_FIELD";
+    readonly SET_FORM_FIELD_VALUE: "GLOBAL/SET_FORM_FIELD_VALUE";
+    readonly SET_FORM_FIELD_TOUCHED: "GLOBAL/SET_FORM_FIELD_TOUCHED";
+    readonly VALIDATE_FORM_FIELDS: "GLOBAL/VALIDATE_FORM_FIELDS";
+    readonly REPORT_ERROR: "ERROR/REPORT";
 };
 export type GlobalActionType = GlobalActions['type'];

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

@@ -7,7 +7,13 @@ export * from './offer-lifecycle';
 export * from './send-partner';
 export * from './custom-states';
 export * from './domain-states';
+export * from './layout-events';
 export * from './open-link';
 export * from './partner-validation';
 export * from './global-offer-data-state';
 export * from './child-layout';
+export * from './cart-item-event';
+export * from './dismiss-overlay';
+export * from './trigger-action';
+export * from './form-state';
+export * from './report-error';

package/dist/libraries/domain/src/behaviors/layout-events.d.ts

@@ -0,0 +1,17 @@
+import { LayoutEvent } from '@rokt/dcui-layout-schema';
+export declare const LAYOUT_EVENT = "GLOBAL/LAYOUT_EVENT";
+export interface LayoutEventAction {
+    type: typeof LAYOUT_EVENT;
+    payload: LayoutEventPayload;
+}
+export interface LayoutEventPayload {
+    event: LayoutEvent;
+    /**
+     * The layout-variant slot the event originated from, used to scope the
+     * `firedEvents` state per slot. Injected by the store proxy from the offer
+     * context; absent for outer-layout events, which fall back to the `root`
+     * bucket.
+     */
+    offerPositionIndex?: number;
+    creativeInstanceGuid?: string;
+}

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

@@ -1,4 +1,4 @@
-import { Fulfillment, PluginCreativeFulfillmentResponseOption, PluginCreativeExternalResponseOption, PluginCreativeCaptureOnlyResponseOption, PluginCreativeUrlResponseOption } from '../models';
+import { Fulfillment, PluginCreativeFulfillmentResponseOption, PluginCreativeExternalResponseOption, PluginCreativeResponseOption, PluginOffer, PluginCreativeCaptureOnlyResponseOption, PluginCreativeUrlResponseOption } from '../models';
 export declare const OFFER_ENGAGEMENT = "GLOBAL/OFFER_ENGAGEMENT";
 export interface OfferEngagement {
     type: typeof OFFER_ENGAGEMENT;
@@ -7,6 +7,7 @@ export interface OfferEngagement {
 export type OfferProcessStatus = 'END' | 'CONTINUE';
 export type OfferEngagementState = {
     offerProcessStatus: OfferProcessStatus;
+    isNegativeResponse?: boolean;
 };
 export interface OfferEngagementFulfillmentPayload {
     responseOption: PluginCreativeFulfillmentResponseOption;
@@ -46,3 +47,4 @@ export declare function isRealTimeReferralOnly(response: OfferEngagementPayload
 };
 export declare function makeCaptureOnlyOfferEngagementPayload(offerPayload?: Partial<OfferEngagementCaptureOnlyPayload>): OfferEngagementCaptureOnlyPayload;
 export declare function makeUrlOfferEngagementPayload(offerPayload?: Partial<OfferEngagementUrlPayload>): OfferEngagementUrlPayload;
+export declare function makeResponsePayload(offer: PluginOffer, response: Exclude<PluginCreativeResponseOption, PluginCreativeExternalResponseOption>, openLinks?: string | null): OfferEngagementPayload;

package/dist/libraries/domain/src/behaviors/report-error.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Reports a diagnostic to the host plugin's error service from anywhere a
+ * global dispatch is available. The constant matches the store-level
+ * `ERROR/REPORT` action (like DISMISS_OVERLAY), so every store's existing
+ * error saga picks it up with no per-store translation: the orchestrator and
+ * child renderer handle it directly, and the GlobalStoreProxy passes
+ * non-offer-specific actions through to the orchestrator store verbatim.
+ */
+export declare const REPORT_ERROR = "ERROR/REPORT";
+/**
+ * Deliberately narrower than @rokt/plugin's ErrorLevel: the error saga
+ * treats `ERROR` as placement-fatal (it dispatches PLACEMENT_FAILURE and
+ * closes the plugin), which a component-originated diagnostic must never
+ * trigger. Fatal errors belong to the saga/store layer, not this behavior.
+ */
+export type ReportErrorLevel = 'INFO' | 'WARNING';
+export interface ReportErrorPayload {
+    level: ReportErrorLevel;
+    code?: string;
+    message?: string;
+    additionalInformation?: Record<string, unknown>;
+}
+export interface ReportError {
+    type: typeof REPORT_ERROR;
+    payload: ReportErrorPayload;
+}

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

@@ -1,9 +1,13 @@
-import { OutboundPartnerEvent, PluginCartItem, InstantPurchaseWsdkPayload } from '../models';
+import { CartItemPayload, InstantPurchaseWsdkPayload, ItemDetail, OutboundPartnerEvent, PluginCartItem, Shipping, InitiateDevicePayEventPayload, PrepareDevicePayEventPayload, PartnerUpsellItemInstantPurchasePayload, InstantPurchaseInitiateTaxAndShippingEventPayload } from '../models';
 export declare const SEND_PARTNER = "GLOBAL/SEND_PARTNER";
 export type OutboundInstantPurchaseEventPayload = {
     name: 'CART_ITEM_INSTANT_PURCHASE';
     body: Record<string, PluginCartItem | null>;
 };
+export type OutboundUpsellItemInstantPurchaseEventPayload = {
+    name: 'UPSELL_ITEM_INSTANT_PURCHASE';
+    body: PartnerUpsellItemInstantPurchasePayload;
+};
 export type OutboundRealtimeOfferFulfillmentReferralEventPayload = {
     name: 'REALTIME_OFFER_FULFILLMENT_REFERRAL';
     body: {
@@ -29,6 +33,10 @@ export type OutboundUpdateCartEventPayload = {
     name: 'V2_CART_ITEM_UPDATED';
     body: Record<string, PluginCartItem | null>;
 };
+export type OutboundUpdateCartItemMessageEventPayload = {
+    name: 'UPDATE_CART_ITEM_MESSAGE';
+    body: Record<string, PluginCartItem | null>;
+};
 export type OutboundUpsellCreativeSentEventPayload = {
     name: 'UPSELL_CREATIVE_SENT';
     body: {
@@ -37,14 +45,43 @@ export type OutboundUpsellCreativeSentEventPayload = {
         description: string;
     };
 };
+export type OutboundDeliveryDetailsSentEventPayload = {
+    name: 'DELIVERY_DETAILS_SENT';
+    body: {
+        shipping: Shipping;
+        itemDetail: ItemDetail;
+    };
+};
 export type OutboundInstantPurchaseWsdkEventPayload = {
     name: 'INITIATE_INSTANT_PURCHASE_EVENT';
     body: InstantPurchaseWsdkPayload;
 };
-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' | 'CART_ITEM_INSTANT_PURCHASE' | 'UPSELL_CREATIVE_SENT' | 'INITIATE_INSTANT_PURCHASE_EVENT' ? never : {
+export type OutboundInstantPurchaseTaxAndShippingEventPayload = {
+    name: 'INSTANT_PURCHASE_INITIATE_TAX_AND_SHIPPING_EVENT';
+    body: InstantPurchaseInitiateTaxAndShippingEventPayload;
+};
+export type OutboundCartItemEventPayload = {
+    name: 'INITIATE_CART_ITEM_EVENT';
+    body: CartItemPayload;
+};
+export type OutboundPrepareDevicePayEventPayload = {
+    name: 'PREPARE_DEVICE_PAY_EVENT';
+    body: PrepareDevicePayEventPayload;
+};
+export type OutboundDevicePayEventPayload = {
+    name: 'INITIATE_DEVICE_PAY_EVENT';
+    body: InitiateDevicePayEventPayload;
+};
+export type OutboundAbortDevicePayEventPayload = {
+    name: 'ABORT_DEVICE_PAY_EVENT';
+};
+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 : {
     name: EventType;
 };
 export type SendPartner<EventType extends OutboundPartnerEvent> = {
     type: typeof SEND_PARTNER;
-    payload: OutboundPartnerEventPayload<EventType> | OutboundUpdateCartEventPayload | OutboundInstantPurchaseEventPayload | OutboundUpsellCreativeSentEventPayload | OutboundInstantPurchaseWsdkEventPayload;
+    payload: OutboundPartnerEventPayload<EventType> | OutboundUpdateCartEventPayload | OutboundUpdateCartItemMessageEventPayload | OutboundInstantPurchaseEventPayload | OutboundUpsellItemInstantPurchaseEventPayload | OutboundUpsellCreativeSentEventPayload | OutboundInstantPurchaseWsdkEventPayload | OutboundInstantPurchaseTaxAndShippingEventPayload | OutboundCartItemEventPayload | OutboundDeliveryDetailsSentEventPayload | OutboundPrepareDevicePayEventPayload | OutboundDevicePayEventPayload | OutboundAbortDevicePayEventPayload | OutboundCompleteDevicePayEventPayload;
 };

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

@@ -0,0 +1,19 @@
+import { 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
+ * 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 interface TriggerAction {
+    type: typeof TRIGGER_ACTION;
+    payload: {
+        action: TriggerableAction;
+        offer?: PluginOffer;
+        offerPositionIndex?: number;
+    };
+}

package/dist/libraries/domain/src/models/domain-state-keys.d.ts

@@ -0,0 +1,5 @@
+export declare const DOMAIN_STATE_KEYS: {
+    readonly offerComplete: "offerComplete";
+    readonly checkout: "checkout";
+    readonly layoutMinimized: "layoutMinimized";
+};

package/dist/libraries/domain/src/models/form-state.d.ts

@@ -0,0 +1,85 @@
+import { InputValidation } from '@rokt/dcui-layout-schema';
+/**
+ * Runtime state for a single form field. Mirrors the field-level concepts in
+ * the DCUI forms design: the current value, the value it was initialised with
+ * (used to derive `dirty`), the active validation error message, and the
+ * interaction/validation flags.
+ */
+export interface FormFieldState {
+    /** The current value entered by the user. */
+    value: string;
+    /** The value the field was registered with (used to derive `dirty`). */
+    defaultValue: string;
+    /** The active validation error message, or '' when there is no error. */
+    error: string;
+    /** Whether the field has received focus at least once. */
+    touched: boolean;
+    /** Whether validation has run on this field at least once. */
+    validated: boolean;
+    /** Result of the last validation run. Only meaningful when `validated`. */
+    valid: boolean;
+    /**
+     * Whether the prerequisite for SHOWING validation errors has been met: the
+     * form was submitted (VALIDATE_FORM_FIELDS) or the user changed the value
+     * in a validating mode. Validity itself is computed eagerly (so `is-valid`
+     * predicates and button enablement work for prefilled fields), but error
+     * styling/messages and the `is-invalid` predicate stay hidden until this
+     * flips — a prefilled-but-invalid default must not render errors at first
+     * paint, matching Angular/Formik display gating.
+     */
+    errorVisible: boolean;
+    /** The validation rules registered for this field. */
+    validations: InputValidation[];
+    /**
+     * How many mounted inputs are currently registered on this field. A field
+     * whose count drops to 0 is inactive (a tombstone): it stops participating
+     * in validation, FormState predicates and templates, but retains its value
+     * so a re-mounting input (e.g. behind a When or a breakpoint flip between
+     * duplicated subtrees) restores what the user typed. Duplicated inputs
+     * sharing a field key keep the field active until the last one unmounts.
+     */
+    registrationCount: number;
+}
+/** Whether the field currently has at least one mounted input registered. */
+export declare function isFormFieldActive(field: FormFieldState): boolean;
+/**
+ * Whether the field's validation errors should currently be SHOWN. The single
+ * display-gate predicate shared by the input's error rendering, the
+ * `is-invalid` When predicate, and the error template projection, so the
+ * built-in and custom error surfaces can never disagree.
+ */
+export declare function isFormFieldErrorVisible(field: FormFieldState): boolean;
+/** All fields within a single form, keyed by `field_key`. */
+export type FormState = Record<string, FormFieldState>;
+/** All forms within a single scope, keyed by `form_key`. */
+export type FormStatesState = Record<string, FormState>;
+export declare function makeInitialFormFieldState(data?: Partial<FormFieldState>): FormFieldState;
+/**
+ * Runs the supplied validations against a value and returns the first failing
+ * validator's message, or '' when the value passes all validations. Pure — used
+ * by both the form-state reducer and the ActionButton's pre-dispatch gating so
+ * the two never diverge.
+ *
+ * Only `Required` can fail an empty value; the other validators apply solely
+ * when a value is present (matching HTML5 constraint validation, Angular, and
+ * Formik/Yup). This is what makes an optional-but-validated field
+ * expressible: a Pattern-only email field passes while blank and validates
+ * once the user types.
+ */
+export declare function firstValidationError(value: string, validations?: InputValidation[]): string;
+/** A resolved reference to a single field within a form. */
+export interface FormFieldRef {
+    formKey: string;
+    fieldKey: string;
+}
+/**
+ * Resolves a list of `validates` entries against the current form state into
+ * concrete field references. An entry is either a bare form key
+ * (`"ShippingForm"` — every ACTIVE field in that form; inactive tombstones
+ * are excluded so a field hidden by a When cannot block validation) or a
+ * dot-notation field key (`"ShippingForm.email"` — that single field,
+ * returned regardless of active status so callers can distinguish "hidden"
+ * from "never existed"). Shared by the reducer (to set errors) and the
+ * ActionButton (to gate dispatch) so both resolve entries identically.
+ */
+export declare function resolveFormFieldRefs(formStates: FormStatesState, entries: string[]): FormFieldRef[];

package/dist/libraries/domain/src/models/global-state.d.ts

@@ -1,4 +1,5 @@
-import { DomainStateKey } from '@rokt/dcui-layout-schema';
+import { DomainStateKey, LayoutEvent } from '@rokt/dcui-layout-schema';
+import { FormStatesState } from './form-state';
 export interface GlobalState {
     breakpoint: {
         breakpoints: Record<string, number>;
@@ -12,5 +13,7 @@ export interface GlobalState {
     };
     customStates: Record<string, number>;
     domainStates: Partial<Record<DomainStateKey, number>>;
+    firedEvents: Partial<Record<LayoutEvent, boolean>>;
+    formStates: FormStatesState;
 }
 export declare function makeGlobalState(state?: Partial<GlobalState>): GlobalState;

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

@@ -1,6 +1,8 @@
 export * from './layout';
 export * from './plugin';
+export * from './domain-state-keys';
 export * from './global-state';
+export * from './form-state';
 export * from './metric-name';
 export * from './metrics';
 export * from './signals';
@@ -11,3 +13,4 @@ export * from './partner-event';
 export * from './interactivity';
 export * from './child-plugin';
 export * from './purchase';
+export * from './shipping';

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

@@ -13,4 +13,5 @@ export * from './layout-creative-icon';
 export * from './layout-child-config';
 export * from './layout-child-layout';
 export * from './layout-catalog-item';
+export * from './layout-transaction-data';
 export * from './layout-conversion-type';

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

@@ -11,6 +11,8 @@ export interface LayoutCatalogItem {
     images?: Record<string, LayoutImage>;
     priceFormatted: string;
     price: number;
+    originalPriceFormatted?: string;
+    originalPrice?: number;
     providerData?: string;
     subtitle?: string;
     title: string;

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

@@ -1,4 +1,5 @@
 import { LayoutDisplayPreset, LayoutSchemaModel, LayoutSettings, ChildRootSchemaModel, WhenPredicate } from '@rokt/dcui-layout-schema';
+import { Fonts } from '@rokt/plugin';
 import { LayoutOffer } from './layout-offer';
 export interface LayoutChildConfig<ChildRootLayoutSchema> {
     instanceGuid: string;
@@ -9,5 +10,6 @@ export interface LayoutChildConfig<ChildRootLayoutSchema> {
     content?: {
         text: Record<string, string>;
     };
+    fonts?: Fonts;
 }
 export declare function makeLayoutChildConfig(data?: Partial<LayoutChildConfig<ChildRootSchemaModel<LayoutSchemaModel, LayoutDisplayPreset, LayoutSettings, WhenPredicate>>>): LayoutChildConfig<ChildRootSchemaModel<LayoutSchemaModel, LayoutDisplayPreset, LayoutSettings, WhenPredicate>>;

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

@@ -1,4 +1,4 @@
-import { LayoutDisplayPreset, LayoutSchemaModel, LayoutSettings, RootSchemaModel } from '@rokt/dcui-layout-schema';
+import { LayoutDisplayPreset, LayoutSchemaModel, LayoutSettings, LayoutAction, LayoutTimer, RootSchemaModel, WhenPredicate } from '@rokt/dcui-layout-schema';
 import { LayoutSlot } from './layout-slot';
 export interface LayoutConfig<LayoutSchema, RootLayoutSchema> {
     slots: Array<LayoutSlot<LayoutSchema>>;
@@ -6,4 +6,4 @@ export interface LayoutConfig<LayoutSchema, RootLayoutSchema> {
     layoutSchemaVersion: string;
     outerLayoutSchema: string | RootLayoutSchema;
 }
-export declare function makeLayoutConfig(data?: Partial<LayoutConfig<LayoutSchemaModel, RootSchemaModel<LayoutSchemaModel, LayoutDisplayPreset, LayoutSettings>>>): LayoutConfig<LayoutSchemaModel, RootSchemaModel<LayoutSchemaModel, LayoutDisplayPreset, LayoutSettings>>;
+export declare function makeLayoutConfig(data?: Partial<LayoutConfig<LayoutSchemaModel, RootSchemaModel<LayoutSchemaModel, LayoutDisplayPreset, LayoutSettings, LayoutTimer<WhenPredicate, LayoutAction>>>>): LayoutConfig<LayoutSchemaModel, RootSchemaModel<LayoutSchemaModel, LayoutDisplayPreset, LayoutSettings, LayoutTimer<WhenPredicate, LayoutAction>>>;

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

@@ -1,5 +1,6 @@
 import { LayoutCreative } from './layout-creative';
 import { LayoutCatalogItem } from './layout-catalog-item';
+import { LayoutTransactionData } from './layout-transaction-data';
 export interface LayoutOffer {
     campaignId: string;
     accountId: string;
@@ -7,5 +8,6 @@ export interface LayoutOffer {
     creative: LayoutCreative;
     metadata: Record<string, string>;
     catalogItems?: Array<LayoutCatalogItem>;
+    transactionData?: LayoutTransactionData;
 }
 export declare function makeLayoutOffer(data?: Partial<LayoutOffer>): LayoutOffer;

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

@@ -1,5 +1,7 @@
 export declare const enum LayoutSignalType {
     SignalResponse = "SignalResponse",
     SignalGatedResponse = "SignalGatedResponse",
-    SignalSecondaryResponse = "SignalSecondaryResponse"
+    SignalSecondaryResponse = "SignalSecondaryResponse",
+    SignalOptInResponse = "SignalOptInResponse",
+    SignalOptOutResponse = "SignalOptOutResponse"
 }

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

@@ -0,0 +1,31 @@
+export declare const enum LayoutPaymentMethodType {
+    Unspecified = "UNSPECIFIED",
+    Other = "OTHER",
+    Card = "CARD",
+    PayPal = "PAYPAL",
+    ApplePay = "APPLE_PAY",
+    GooglePay = "GOOGLE_PAY",
+    Afterpay = "AFTERPAY"
+}
+export interface LayoutPaymentMethodInfo {
+    type: LayoutPaymentMethodType;
+}
+export interface LayoutAddress {
+    address1: string;
+    address2?: string;
+    city: string;
+    state: string;
+    country: string;
+    zip?: string;
+    name?: string;
+}
+export interface LayoutTransactionData {
+    shippingAddress?: LayoutAddress;
+    billingAddress?: LayoutAddress;
+    paymentType?: string;
+    supportedPaymentMethods?: LayoutPaymentMethodInfo[];
+    isPartnerManagedPurchase: boolean;
+    partnerPaymentReference?: string;
+    confirmationRef?: string;
+    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' | 'CART_ITEM_INSTANT_PURCHASE';
-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';
+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 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/index.d.ts

@@ -11,6 +11,8 @@ export * from './plugin-url-behavior';
 export * from './plugin-layout-variant';
 export * from './plugin-creative-icon';
 export * from './plugin-catalog-item';
+export * from './plugin-catalog-item-group';
+export * from './plugin-transaction-data';
 export * from './plugin-cart-item';
 export * from './plugin-static-data';
 export * from './plugin-child-layout-model';

package/dist/libraries/domain/src/models/plugin/plugin-catalog-item-group.d.ts

@@ -0,0 +1,17 @@
+export interface CatalogItemGroupOption {
+    label: string;
+    catalogItemIds: string[];
+    metadata: Record<string, unknown>;
+}
+export interface CatalogItemGroupAttribute {
+    attributeId: string;
+    label: string;
+    options: CatalogItemGroupOption[];
+    metadata: Record<string, unknown>;
+}
+export interface CatalogItemGroup {
+    groupId: string;
+    catalogItemIds: string[];
+    attributes: CatalogItemGroupAttribute[];
+    metadata: Record<string, unknown>;
+}

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

@@ -13,6 +13,8 @@ export interface PluginCatalogItem {
     responseOptionsMap?: Record<string, PluginCreativeUrlResponseOption>;
     priceFormatted: string;
     price: number;
+    originalPrice?: number;
+    originalPriceFormatted?: string;
     providerData?: string;
     subtitle?: string;
     title: string;
@@ -26,9 +28,15 @@ export interface PluginCatalogItem {
     url?: string;
     productSku?: string;
     catalogId?: string;
+    inventoryStatus?: PluginCatalogItemInventoryStatus;
 }
 export interface PluginCatalogItemImage {
     url: string;
     altText?: string;
 }
+export declare enum PluginCatalogItemInventoryStatus {
+    Unknown = "Unknown",
+    InStock = "InStock",
+    OutOfStock = "OutOfStock"
+}
 export declare function makePluginCatalogItem(data?: Partial<PluginCatalogItem>): PluginCatalogItem;