@rokt/dcui-orchestrator 0.2.1-rc.83 → 0.2.1-rc.84

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

@@ -0,0 +1,24 @@
+import { ActionButtonModel, LayoutAction, NonInteractableChildren, WhenPredicate } from '@rokt/dcui-layout-schema';
+export interface ActionButtonProps {
+    /**
+     *  - `actions`: LayoutActions dispatched when pressed and validation passes.
+     *  - `validates`: form/field keys to validate before dispatching. A bare form
+     *    key validates all of its fields; a dot-notation key validates one field.
+     *  - `a11yLabel`: accessibility label for screen readers.
+     *  - `children`: nodes rendered inside the button (e.g. BasicText label).
+     *  - `styles`:
+     *    * `elements`:
+     *      - `own`: `container`, `dimension`, `flexChild`, `spacing`,
+     *        `background`, `border`
+     */
+    schema: ActionButtonModel<NonInteractableChildren, LayoutAction, WhenPredicate>;
+    testId?: string;
+}
+/**
+ * A pressable container that dispatches one or more LayoutActions, optionally
+ * gated on form validation. When `validates` is provided, validation runs
+ * first: error states are applied and, if any field is invalid, actions are not
+ * dispatched.<br>
+ * *Where can we use this: __outer layout__, __layout variant__*
+ */
+export declare function ActionButton(props: ActionButtonProps): JSX.Element;

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

@@ -0,0 +1,2 @@
+import { LayoutSchemaModel } from '@rokt/dcui-layout-schema';
+export declare function tryMakeActionButton(schema: LayoutSchemaModel, testId?: string): JSX.Element | void;

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

@@ -0,0 +1,2 @@
+export * from './action-button';
+export * from './factory';

package/dist/libraries/dcui-components/src/components/catalog-carousel-collection/hooks.d.ts

@@ -0,0 +1,7 @@
+import { EmblaCarouselType } from 'embla-carousel';
+export declare function useCarouselScrollSignals(options: {
+    emblaApi?: EmblaCarouselType;
+    parentGuid: string;
+    catalogLength: number;
+    context: string;
+}): void;

package/dist/libraries/{layout-renderer-utils → dcui-components}/src/components/close-button/factory.d.ts

@@ -1,2 +1,2 @@
 import { LayoutSchemaModel } from '@rokt/dcui-layout-schema';
-export declare function tryMakeCloseButton(schema: LayoutSchemaModel): JSX.Element | undefined;
+export declare function tryMakeCloseButton(schema: LayoutSchemaModel, testId?: string): JSX.Element | undefined;

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

@@ -0,0 +1,31 @@
+import { FormStatesState } from '../../../../domain/src/models';
+import { ExtendableDataMapper } from './data-mapper';
+/**
+ * Projects runtime form state into the shape consumed by string templates.
+ * Only `value` and `error` are exposed (the only field state meaningful as
+ * rendered text), producing `STATE.form.<formKey>.<fieldKey>.value` and
+ * `.error` keys when bound under the `form` namespace. Boolean states like
+ * validity are intentionally omitted — those are conditional-rendering
+ * concerns handled by the FormState When predicate — and inactive tombstones
+ * (fields whose inputs are all unmounted) are excluded entirely.
+ *
+ * NOTE for template authors: per the data mapper's established semantics, an
+ * EMPTY value collapses the whole containing string — `'Code:
+ * %^STATE.form.F.code.value^%'` renders as '' (prefix included) while the
+ * field is empty, which is every field's initial state. Append the `|`
+ * fallback (`%^STATE.form.F.code.value|^%`) to keep the surrounding text and
+ * substitute nothing.
+ */
+export declare function projectFormStateForTemplates(formStates: FormStatesState): Record<string, Record<string, {
+    value: string;
+    error: string;
+}>>;
+/**
+ * Extends a data mapper so `%^STATE.form.<formKey>.<fieldKey>.value|.error^%`
+ * templates resolve against the given form state. The single binding point for
+ * every renderer (outer layout, layout variant, child layout) so the template
+ * namespace and projection shape cannot diverge between them. Note the
+ * namespace argument is a key *prefix*: the projection must NOT be nested
+ * under an extra `form` key or templates would resolve at `STATE.form.form.*`.
+ */
+export declare function extendDataMapperWithFormStates(dataMapper: ExtendableDataMapper, formStates: FormStatesState): ExtendableDataMapper;

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

@@ -1,5 +1,6 @@
 import { transformLinksToAnchorText } from './utils';
 export * from './data-mapper';
+export * from './form-state-projection';
 export declare const DataMapperUtils: {
     transformLinksToAnchorText: typeof transformLinksToAnchorText;
 };

package/dist/libraries/dcui-components/src/components/extension/context.d.ts

@@ -1,12 +1,13 @@
 import React, { PropsWithChildren } from 'react';
 import { ExtensionLocator } from './models';
+import { PluginService } from '../../../../plugin-utils/src/index';
 export type ExtendStoreFn = (storeExtension: StoreExtension) => void;
 export type StoreExtension = {
     name: string;
     reducer?: Record<string, <State extends object, Action extends {
         type: string;
     }>(state: State, action: Action) => State>;
-    sagas?: () => Generator;
+    sagas?: (partnerInteractionService: Pick<PluginService<unknown>, 'partnerInteractionService'>) => Generator;
     interceptors?: Partial<Record<string, (input: {
         type: string;
         payload: unknown;

package/dist/libraries/dcui-components/src/components/extension/models.d.ts

@@ -1,7 +1,8 @@
+import { PluginService } from '../../../../plugin-utils/src/index';
 export type AppExtension = {
     name: string;
     componentFactory: (body: null | object) => JSX.Element;
-    sagas?: () => Generator;
+    sagas?: (partnerInteractionService: Pick<PluginService<unknown>, 'partnerInteractionService'>) => Generator;
     reducer?: Record<string, <State extends object, Action extends {
         type: string;
     }>(state: State, action: Action) => State>;

package/dist/libraries/dcui-components/src/components/form/factory.d.ts

@@ -0,0 +1,2 @@
+import { LayoutSchemaModel } from '@rokt/dcui-layout-schema';
+export declare function tryMakeForm(schema: LayoutSchemaModel, testId?: string): JSX.Element | void;

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

@@ -0,0 +1,24 @@
+import { FormModel, LayoutSchemaModel, WhenPredicate } from '@rokt/dcui-layout-schema';
+export interface FormProps {
+    /**
+     *  - `formKey`: unique key identifying this form's state scope. All TextInput
+     *    descendants write to `STATE.form.<formKey>.<fieldKey>`.
+     *  - `validationMode`: when field validation triggers — `on-submit` (default)
+     *    or `on-change`.
+     *  - `children`: any layout nodes (typically TextInputs, error `When` blocks
+     *    and an ActionButton).
+     *  - `styles`:
+     *    * `elements`:
+     *      - `own`: `container`, `dimension`, `flexChild`, `spacing`,
+     *        `background`, `border`
+     */
+    schema: FormModel<LayoutSchemaModel, WhenPredicate>;
+    testId?: string;
+}
+/**
+ * The Form is a non-visual-by-default container that scopes form state under a
+ * unique `formKey`. It provides the FormContext consumed by descendant
+ * TextInputs and renders its children as a flex column.<br>
+ * *Where can we use this: __outer layout__, __layout variant__*
+ */
+export declare function Form(props: FormProps): JSX.Element;

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

@@ -0,0 +1,2 @@
+export * from './form';
+export * from './factory';

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

@@ -25,3 +25,8 @@ export * from './catalog-quantity-option';
 export * from './catalog-stacked-collection';
 export * from './child-layout-handler';
 export * from './copy-to-clipboard-button';
+export * from './close-button';
+export * from './layout-timer';
+export * from './form';
+export * from './text-input';
+export * from './action-button';

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

@@ -0,0 +1,5 @@
+export { LayoutTimer } from './layout-timer';
+export type { LayoutTimerProps, VariantTimer, OuterTimer } from './layout-timer';
+export { useLayoutTimer } from './use-layout-timer';
+export { useLayoutActionDispatch } from './use-timer-action-dispatch';
+export { TimerCountdownProvider } from './timer-countdown-provider';

package/dist/libraries/dcui-components/src/components/layout-timer/layout-timer.d.ts

@@ -0,0 +1,7 @@
+import { LayoutTimer as LayoutTimerSchema, LayoutVariantAction, LayoutVariantWhenPredicate, OuterLayoutAction, OuterLayoutWhenPredicate } from '@rokt/dcui-layout-schema';
+export type VariantTimer = LayoutTimerSchema<LayoutVariantWhenPredicate, LayoutVariantAction>;
+export type OuterTimer = LayoutTimerSchema<OuterLayoutWhenPredicate, OuterLayoutAction>;
+export interface LayoutTimerProps {
+    timer: VariantTimer | OuterTimer;
+}
+export declare function LayoutTimer({ timer }: LayoutTimerProps): null;

package/dist/libraries/dcui-components/src/components/layout-timer/timer-countdown-provider.d.ts

@@ -0,0 +1,8 @@
+import { PropsWithChildren } from 'react';
+interface TimerCountdownRegister {
+    register: (key: string, duration: number) => void;
+    unregister: (key: string) => void;
+}
+export declare const useTimerCountdownRegister: () => TimerCountdownRegister;
+export declare function TimerCountdownProvider({ children }: PropsWithChildren): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/libraries/dcui-components/src/components/layout-timer/use-layout-timer.d.ts

@@ -0,0 +1,11 @@
+import { WhenPredicate } from '@rokt/dcui-layout-schema';
+interface UseLayoutTimerProps {
+    key: string;
+    startTrigger: Array<WhenPredicate>;
+    clearTrigger: Array<WhenPredicate>;
+    duration: number;
+    repeatable?: boolean;
+    onExpire: () => void;
+}
+export declare function useLayoutTimer({ key, startTrigger, clearTrigger, duration, repeatable, onExpire, }: UseLayoutTimerProps): void;
+export {};

package/dist/libraries/dcui-components/src/components/layout-timer/use-timer-action-dispatch.d.ts

@@ -0,0 +1,9 @@
+import { LayoutVariantAction } from '@rokt/dcui-layout-schema';
+/**
+ * Returns a dispatcher that fires a single LayoutAction through the
+ * TRIGGER_ACTION global behavior. The handleVariantAction saga resolves each
+ * action variant (Close, SetCustomState, CreativeResponse, CatalogResponse) to
+ * its concrete behavior, with offer + position context attached. Shared by the
+ * LayoutTimer and ActionButton nodes.
+ */
+export declare function useLayoutActionDispatch(): (layoutAction: LayoutVariantAction) => void;

package/dist/libraries/dcui-components/src/components/rich-text/rich-text.d.ts

@@ -12,6 +12,7 @@ export interface RichTextProps {
      *  - `styles`:
      *    * `elements`:
      *      - `own`:
+     *        * `container` (exposes `scrollMask` for the constrained-height "show more" pattern)
      *        * `dimension`
      *        * `flexChild`
      *        * `spacing`
@@ -26,6 +27,7 @@ export interface RichTextProps {
      *        * `duration`: number
      *        * `value`:
      *          - `own`:
+     *            * `container`
      *            * `dimension`
      *            * `flexChild`
      *            * `spacing`

package/dist/libraries/dcui-components/src/components/scrollable-column/scrollable-column.d.ts

@@ -25,7 +25,7 @@ export interface ScrollableColumnProps {
      *  - `styles`:
      *    * `elements`:
      *      - `own`:
-     *        * `container`
+     *        * `container` (includes `overflow` clipping and `scrollMask` edge gradient)
      *        * `dimension`
      *        * `flexChild`
      *        * `spacing`

package/dist/libraries/dcui-components/src/components/scrollable-row/scrollable-row.d.ts

@@ -25,7 +25,7 @@ export interface ScrollableRowProps {
      *  - `styles`:
      *    * `elements`:
      *      - `own`:
-     *        * `container`
+     *        * `container` (includes `overflow` clipping and `scrollMask` edge gradient)
      *        * `dimension`
      *        * `flexChild`
      *        * `spacing`

package/dist/libraries/dcui-components/src/components/style-mapper/get-css-writer.d.ts

@@ -1,2 +1,3 @@
 import { Emotion } from '@emotion/css/create-instance';
 export declare function getCssWriter(pluginId?: string, index?: number, container?: Node): Emotion['css'];
+export declare function getCxWriter(pluginId?: string, index?: number, container?: Node): Emotion['cx'];

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

@@ -11,3 +11,4 @@ export * from './shadow-transformer';
 export * from './blur-transformer';
 export * from './rotate-transformer';
 export * from './font-family-transform';
+export * from './scroll-mask-transformer';

package/dist/libraries/dcui-components/src/components/style-mapper/transformers/scroll-mask-transformer.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Scroll-mask gradient depends on runtime scroll position (atStart /
+ * atEnd) and is therefore owned by the component via
+ * `useScrollMaskVisibility`, which writes `mask-image` inline. The
+ * transformer here is a validating no-op — it ensures layouts cannot
+ * supply a malformed `container.scrollMask` object without emitting CSS.
+ */
+export declare function scrollMaskTransformer(_categoryKey: 'container', _propertyKey: 'scrollMask', value: unknown): string;

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

@@ -1,4 +1,4 @@
-import { BackgroundStylingProperties, BorderStylingProperties, ContainerStylingProperties, DimensionStylingProperties, FlexChildStylingProperties, SpacingStylingProperties, TextStylingProperties, LayoutStyle, BasicStateStylingBlock, StatelessStylingBlock, ConditionalStyleTransition } from '@rokt/dcui-layout-schema';
+import { BackgroundStylingProperties, BorderStylingProperties, ContainerStylingProperties, DimensionStylingProperties, FlexChildStylingProperties, SpacingStylingProperties, TextStylingProperties, LayoutStyle, BasicStateStylingBlock, StatelessStylingBlock, ErrorableStateStylingBlock, ConditionalStyleTransition } from '@rokt/dcui-layout-schema';
 export type AnyStyleProperty = {
     dimension?: null | DimensionStylingProperties;
     flexChild?: null | FlexChildStylingProperties;
@@ -8,7 +8,7 @@ export type AnyStyleProperty = {
     border?: null | BorderStylingProperties;
     container?: null | ContainerStylingProperties;
 };
-export type StyleBlockDefinition<NodeStyles> = BasicStateStylingBlock<NodeStyles> | StatelessStylingBlock<NodeStyles>;
+export type StyleBlockDefinition<NodeStyles> = BasicStateStylingBlock<NodeStyles> | StatelessStylingBlock<NodeStyles> | ErrorableStateStylingBlock<NodeStyles>;
 type NonNullableProperty<T> = {
     [P in keyof T]: NonNullable<T[P]>;
 };

package/dist/libraries/dcui-components/src/components/text-input/factory.d.ts

@@ -0,0 +1,2 @@
+import { LayoutSchemaModel } from '@rokt/dcui-layout-schema';
+export declare function tryMakeTextInput(schema: LayoutSchemaModel, testId?: string): JSX.Element | void;

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

@@ -0,0 +1,2 @@
+export * from './text-input';
+export * from './factory';

package/dist/libraries/dcui-components/src/components/text-input/text-input.d.ts

@@ -0,0 +1,23 @@
+import { TextInputModel, WhenPredicate } from '@rokt/dcui-layout-schema';
+export interface TextInputProps {
+    /**
+     *  - `fieldKey`: unique key identifying this field within its parent Form.
+     *  - `inputType`: controls keyboard behaviour/masking. Defaults to `text`.
+     *  - `placeholder`: placeholder text (supports data binding).
+     *  - `defaultValue`: initial value (supports data binding).
+     *  - `a11yLabel`: accessibility label for screen readers.
+     *  - `validations`: validation rules applied to this field.
+     *  - `showErrorMessage`: when true, renders the active error below the input.
+     *  - `styles`:
+     *    * `elements`: `own`, `inputText`, `placeholderText`, `errorText`
+     */
+    schema: TextInputModel<WhenPredicate>;
+    testId?: string;
+}
+/**
+ * A controlled text input bound to its parent Form's state. Writes to
+ * `STATE.form.<formKey>.<fieldKey>` and runs the field's validations according
+ * to the form's `validationMode`.<br>
+ * *Where can we use this: __outer layout__, __layout variant__ (inside a Form)*
+ */
+export declare function TextInput(props: TextInputProps): JSX.Element;

package/dist/libraries/dcui-components/src/components/when/form-state.d.ts

@@ -0,0 +1,9 @@
+import { FormStatePredicate } from '@rokt/dcui-layout-schema';
+import { FormStatesState } from '../../../../domain/src/models';
+/**
+ * Evaluates a FormState When predicate against the current form state. The same
+ * logic serves both field-level and form-level keys: form-level aggregates
+ * across every field (e.g. a form is valid only when all fields are valid;
+ * dirty when any field is dirty).
+ */
+export declare function evaluateFormStatePredicate(predicate: FormStatePredicate, formStates: FormStatesState): boolean;

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

@@ -0,0 +1,15 @@
+import { ValidationMode } from '@rokt/dcui-layout-schema';
+/**
+ * Identifies the Form scope a TextInput belongs to. Provided by the Form node
+ * and consumed by descendant TextInputs so they know which `form_key` to write
+ * to and when (`validationMode`) their values should validate. The
+ * `validationMode` lives here rather than in the store to keep the form-state
+ * reducer mode-agnostic.
+ */
+export interface FormContextValue {
+    formKey: string;
+    validationMode: ValidationMode;
+}
+export declare const FormContext: import("react").Context<FormContextValue | null>;
+export declare const FormContextProvider: import("react").Provider<FormContextValue | null>;
+export declare const useFormContext: () => FormContextValue | null;

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

@@ -16,3 +16,5 @@ export * from './catalog-item-context';
 export * from './plugin-id-context';
 export * from './schema-version-context';
 export * from './browser-support-context';
+export * from './minimizable-context';
+export * from './form-context';

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

@@ -0,0 +1,2 @@
+export declare const MinimizableContext: import("react").Context<boolean>;
+export declare const useIsMinimizable: () => boolean;

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

@@ -6,3 +6,4 @@ export declare const OfferDataProvider: (props: {
 }) => import("react/jsx-runtime").JSX.Element;
 export declare const useOfferData: () => PluginOffer;
 export declare const useOfferCreativeCopy: () => Record<string, string> | undefined;
+export declare const useOfferTransactionData: () => import("../../../domain/src/models").TransactionData | undefined;

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

@@ -4,3 +4,4 @@ export declare const FAILED_PARSING_STYLES = "FAILED_PARSING_STYLES";
 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";

package/dist/libraries/dcui-components/src/utils/get-scroll-mask-config.d.ts

@@ -0,0 +1,20 @@
+import { ScrollMaskStylingProperties } from '@rokt/dcui-layout-schema';
+/**
+ * Pulls the `scrollMask` config out of a node's `own.container` style block
+ * so it can be handed to `useScrollMaskVisibility`. Reads the first
+ * breakpoint's default state only — scroll-mask styling is not expected
+ * to differ across breakpoints or interaction states, and the gradient
+ * is rendered inline by the component rather than via the StyleMapper
+ * class so per-state CSS would not apply anyway.
+ */
+export declare function getScrollMaskConfig(styles: {
+    elements?: {
+        own?: Array<{
+            default?: {
+                container?: {
+                    scrollMask?: ScrollMaskStylingProperties | null;
+                } | null;
+            } | null;
+        }> | null;
+    } | null;
+} | null | undefined): ScrollMaskStylingProperties | null;

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

@@ -8,4 +8,6 @@ export * from './responsive-css';
 export * from './test-id';
 export * from './use-controlled-link-container';
 export * from './use-focus-trap';
+export * from './use-scroll-mask-visibility';
+export * from './get-scroll-mask-config';
 export * from './get-active-breakpoint-index';

package/dist/libraries/dcui-components/src/utils/use-scroll-mask-visibility.d.ts

@@ -0,0 +1,22 @@
+import { ScrollMaskStylingProperties } from '@rokt/dcui-layout-schema';
+export type ScrollMaskAxis = 'horizontal' | 'vertical';
+/**
+ * Tracks scroll state on the attached element and returns the inline
+ * style (mask-image, mask-clip, etc.) needed to render the scroll-mask
+ * gradient described by `config`. The mask collapses to `none` when the
+ * container does not overflow, the start fade is omitted when scrolled
+ * to the start, and the end fade is omitted when scrolled to the end —
+ * so the visible mask always reflects the direction of hidden content.
+ *
+ * `setRef` is a callback ref — pass it to the scrollable element. The
+ * element is held in state so attach/detach is driven by `useEffect`,
+ * keeping listeners correctly paired through Strict Mode and HMR.
+ */
+export declare function useScrollMaskVisibility<E extends HTMLElement>(axis: ScrollMaskAxis, config: ScrollMaskStylingProperties | null | undefined): {
+    hasOverflow: boolean;
+    atStart: boolean;
+    atEnd: boolean;
+    ref: import("react").MutableRefObject<E | null>;
+    setRef: (node: E | null) => void;
+    maskStyle: import("react").CSSProperties;
+};

package/dist/libraries/dcui-schema/src/models/nodes/close-button.d.ts

@@ -1,4 +1,4 @@
-import { BackgroundStylingProperties, BorderStylingProperties, ButtonPseudoClasses, ContainerStylingProperties, DimensionStylingProperties, LayoutStyle, SpacingStylingProperties } from '../styling';
+import { BackgroundStylingProperties, BorderStylingProperties, ButtonPseudoClasses, ContainerStylingProperties, DimensionStylingProperties, FlexChildStylingProperties, LayoutStyle, SpacingStylingProperties } from '../styling';
 import { BasicTextModel } from './basic-text';
 import { ColumnModel } from './column';
 import { StaticImageModel } from './static-image';
@@ -9,6 +9,7 @@ export interface CloseButtonStyles {
     dimension?: DimensionStylingProperties;
     spacing?: SpacingStylingProperties;
     border?: BorderStylingProperties;
+    flexChild?: FlexChildStylingProperties;
 }
 export type CloseButtonChildren = {
     type: 'Row';
@@ -27,4 +28,5 @@ export interface CloseButtonModel {
     children: Array<CloseButtonChildren>;
     styles?: LayoutStyle<CloseButtonStyles, ButtonPseudoClasses<CloseButtonStyles>>;
     dismissalMethod?: string;
+    a11yLabel?: string;
 }

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

@@ -1,24 +1,19 @@
-import { CartItemPayload } from '../models';
+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: CartItemPayload;
+    payload: InitiateCartItemPayload;
 };
 export type CartItemSuccessData = {
     cartItemId: string;
     totalPrice: number;
     currencyCode: string;
     providerData: string;
-    shipping: {
-        firstName: string;
-        lastName: string;
-        address1: string;
-        address2: string;
-        city: string;
-        state: string;
-        postalCode: string;
-        phoneNumber: string;
-    };
+    shipping: Shipping;
     success: true;
 };
 export type CartItemValidationError = {

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,11 +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,8 +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';