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

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

@@ -0,0 +1,37 @@
+import { RegisterFormFieldPayload, UnregisterFormFieldPayload, SetFormFieldValuePayload, SetFormFieldTouchedPayload, ValidateFormFieldsPayload } from '../../../domain/src/behaviors';
+export declare const REGISTER_FORM_FIELD = "FORM_STATES/REGISTER_FIELD";
+export declare const UNREGISTER_FORM_FIELD = "FORM_STATES/UNREGISTER_FIELD";
+export declare const SET_FORM_FIELD_VALUE = "FORM_STATES/SET_FIELD_VALUE";
+export declare const SET_FORM_FIELD_TOUCHED = "FORM_STATES/SET_FIELD_TOUCHED";
+export declare const VALIDATE_FORM_FIELDS = "FORM_STATES/VALIDATE_FIELDS";
+/**
+ * Scope fields injected by the GlobalStoreProxy when translating the global
+ * form behaviors into store actions. `offerPositionIndex` is undefined for the
+ * outer (placement-scoped) layout and set for each format instance.
+ */
+interface OfferScope {
+    offerPositionIndex?: number;
+    creativeInstanceGuid?: string;
+}
+export interface RegisterFormField {
+    type: typeof REGISTER_FORM_FIELD;
+    payload: RegisterFormFieldPayload & OfferScope;
+}
+export interface UnregisterFormField {
+    type: typeof UNREGISTER_FORM_FIELD;
+    payload: UnregisterFormFieldPayload & OfferScope;
+}
+export interface SetFormFieldValue {
+    type: typeof SET_FORM_FIELD_VALUE;
+    payload: SetFormFieldValuePayload & OfferScope;
+}
+export interface SetFormFieldTouched {
+    type: typeof SET_FORM_FIELD_TOUCHED;
+    payload: SetFormFieldTouchedPayload & OfferScope;
+}
+export interface ValidateFormFields {
+    type: typeof VALIDATE_FORM_FIELDS;
+    payload: ValidateFormFieldsPayload & OfferScope;
+}
+export type FormStatesActions = RegisterFormField | UnregisterFormField | SetFormFieldValue | SetFormFieldTouched | ValidateFormFields;
+export {};

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

@@ -1,4 +1,4 @@
-import { OpenLink, PrepareSignal, RaiseMetric, RaiseSignal, SendPartner } from '../../../domain/src/behaviors';
+import { OpenLink, PrepareSignal, RaiseMetric, RaiseSignal, SendPartner, SetDomainState } from '../../../domain/src/behaviors';
 import { ActiveStateActions } from './active';
 import { BreakpointActions, SetBreakpoints } from './breakpoint';
 import { FontsActions } from './fonts';
@@ -11,7 +11,10 @@ import { DismissOverlay } from './overlay';
 import { ReportError } from './error';
 import { Log } from './log';
 import { OfferOutboundPartnerEvent } from '../../../domain/src/models';
+import { LayoutEventAction } from '../../../domain/src/behaviors';
 import { CustomStatesActions } from './custom-states';
+import { SetDomainStateReducer } from './domain-states';
+import { FormStatesActions } from './form-states';
 export * from './active';
 export * from './breakpoint';
 export * from './fonts';
@@ -23,7 +26,9 @@ export * from './log';
 export * from './overlay';
 export * from './plugin';
 export * from './custom-states';
-export type CoreStateActions = LayoutActions | BreakpointActions | ActiveStateActions | FontsActions | SignalStateActions | SerializableCacheActions | SettingsActions | CustomStatesActions;
+export * from './domain-states';
+export * from './form-states';
+export type CoreStateActions = LayoutActions | BreakpointActions | ActiveStateActions | FontsActions | SignalStateActions | SerializableCacheActions | SettingsActions | CustomStatesActions | SetDomainStateReducer | LayoutEventAction | FormStatesActions;
 export declare const coreStateActionTypes: {
     readonly LAYOUT_UPDATE: "LAYOUT/UPDATE";
     readonly UPDATE_ACTIVE_BREAKPOINT: "BREAKPOINT/UPDATE_ACTIVE";
@@ -37,7 +42,14 @@ export declare const coreStateActionTypes: {
     readonly UPDATE_CACHED_SERIALIZED_VALUE: "CACHE/UPDATE_SERIALIZED_VALUE";
     readonly CLEAR_SERIALIZED_VALUE_FROM_CACHE: "CACHE/CLEAR_SERIALIZED_VALUE";
     readonly SET_SETTINGS: "SETTINGS/SET";
+    readonly SET_BOTTOMSHEET_VISIBLE_HEIGHT: "SETTINGS/SET_BOTTOMSHEET_VISIBLE_HEIGHT";
     readonly SET_CUSTOM_STATE: "CUSTOM_STATES/SET";
+    readonly SET_DOMAIN_STATE_REDUCER: "DOMAIN_STATES/SET";
+    readonly REGISTER_FORM_FIELD: "FORM_STATES/REGISTER_FIELD";
+    readonly UNREGISTER_FORM_FIELD: "FORM_STATES/UNREGISTER_FIELD";
+    readonly SET_FORM_FIELD_VALUE: "FORM_STATES/SET_FIELD_VALUE";
+    readonly SET_FORM_FIELD_TOUCHED: "FORM_STATES/SET_FIELD_TOUCHED";
+    readonly VALIDATE_FORM_FIELDS: "FORM_STATES/VALIDATE_FIELDS";
 };
 export declare const coreSagaActionTypes: {
     readonly HANDLE_CONFIG: "CONFIG/HANDLE";
@@ -50,4 +62,4 @@ export declare const coreSagaActionTypes: {
     readonly LOG: "LOG";
     readonly OPEN_LINK: "GLOBAL/OPEN_LINK";
 };
-export type CoreSagasActions = ReportError | Log | SetBreakpoints | RaiseMetric | RaiseSignal | PrepareSignal | ProcessSignals | ClosePlugin | DismissOverlay | OpenLink | SendPartner<OfferOutboundPartnerEvent>;
+export type CoreSagasActions = ReportError | Log | SetBreakpoints | RaiseMetric | RaiseSignal | PrepareSignal | ProcessSignals | ClosePlugin | DismissOverlay | OpenLink | SendPartner<OfferOutboundPartnerEvent> | SetDomainState;

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

@@ -1,8 +1,15 @@
-export declare const DISMISS_OVERLAY = "OVERLAY/DISMISS_OVERLAY";
-export interface DismissOverlay {
-    type: typeof DISMISS_OVERLAY;
-    payload: {
-        id: string;
-        dismissalMethod?: string;
-    };
-}
+export { DISMISS_OVERLAY, OVERLAY_ID } from '../../../domain/src/behaviors';
+export type { DismissOverlay } from '../../../domain/src/behaviors';
+/**
+ * Dismissal method value for the "final negative CTA" button. When DISMISS_OVERLAY is
+ * dispatched with this dismissalMethod and the layout is MinimizableBottomSheet with
+ * minimizeOnComplete true and closeOnComplete not explicitly true (i.e. undefined or false),
+ * the overlay minimizes instead of closing.
+ * Set CloseButton's dismissalMethod to this value for minimizeOnComplete to apply.
+ */
+export declare const ROKT_MINIMIZE = "rokt_minimize";
+/**
+ * Dismissal method value for backdrop dismissals. When DISMISS_OVERLAY is dispatched
+ * with this dismissalMethod, the overlay was dismissed via a backdrop tap/click.
+ */
+export declare const ROKT_BACKDROP = "rokt_backdrop";

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

@@ -1,7 +1,14 @@
-import { LayoutSettings } from '@rokt/dcui-layout-schema';
+import { SettingsState } from '../models/state/settings';
 export declare const SET_SETTINGS = "SETTINGS/SET";
 export type SetSettingsAction = {
     type: typeof SET_SETTINGS;
-    payload: LayoutSettings;
+    payload: Partial<SettingsState>;
 };
-export type SettingsActions = SetSettingsAction;
+export declare const SET_BOTTOMSHEET_VISIBLE_HEIGHT = "SETTINGS/SET_BOTTOMSHEET_VISIBLE_HEIGHT";
+export type SetBottomsheetVisibleHeightAction = {
+    type: typeof SET_BOTTOMSHEET_VISIBLE_HEIGHT;
+    payload: {
+        height: number;
+    };
+};
+export type SettingsActions = SetSettingsAction | SetBottomsheetVisibleHeightAction;

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

@@ -1,4 +1,7 @@
-export * from './close-button';
+export { CloseButton, tryMakeCloseButton } from '../../../dcui-components/src/index';
+export type { CloseButtonProps } from '../../../dcui-components/src/index';
+export * from './minimize-button';
 export * from './overlay';
+export * from './minimizable-bottomsheet';
 export * from './bottom-sheet';
 export * from './fonts-stylesheet';

package/dist/libraries/layout-renderer-utils/src/components/minimizable-bottomsheet/connector.d.ts

@@ -0,0 +1,2 @@
+import { OwnProps, StateProps } from './types';
+export declare const connector: import("react-redux").InferableComponentEnhancerWithProps<StateProps & import("react-redux").DispatchProp<import("redux").UnknownAction>, OwnProps>;

package/dist/libraries/layout-renderer-utils/src/components/minimizable-bottomsheet/drag-handle.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+type DragHandleProps = {
+    className?: string;
+    style?: React.CSSProperties;
+};
+export declare function DragHandle({ className, style }: DragHandleProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/libraries/layout-renderer-utils/src/components/minimizable-bottomsheet/extract-border-styles.d.ts

@@ -0,0 +1,25 @@
+import type { getCssWriter } from '../../../../dcui-components/src/index';
+import type { BasicStateStylingBlock, MinimizableBottomSheetStyles } from '@rokt/dcui-layout-schema';
+/** The scoped emotion `css` writer produced by `getCssWriter`. */
+type CssWriter = ReturnType<typeof getCssWriter>;
+type StyleBlock = BasicStateStylingBlock<MinimizableBottomSheetStyles>;
+export type StylesWithOwn = {
+    elements?: {
+        own?: StyleBlock[];
+        wrapper?: unknown[];
+    } | null;
+};
+export type SchemaOwnBlocks = StyleBlock[] | null | undefined;
+export type MergedSheetAndTailStyles = {
+    mergedStyles: StylesWithOwn & {
+        elements: {
+            own: StyleBlock[];
+            wrapper?: unknown[];
+        };
+    };
+    tailClass: string;
+    backgroundColor: string;
+    darkBackgroundColor: string | undefined;
+};
+export declare function mergeSheetAndTailStyles(css: CssWriter, styles: StylesWithOwn | undefined | null, tailHeightVh: number, schemaOwnBlocks?: SchemaOwnBlocks): MergedSheetAndTailStyles;
+export {};

package/dist/libraries/layout-renderer-utils/src/components/minimizable-bottomsheet/factory.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import { LayoutSchemaModel } from '@rokt/dcui-layout-schema';
+import { MinimizableBottomSheet } from './minimizable-bottomsheet';
+export declare const ConnectedMinimizableBottomSheet: import("react-redux").ConnectedComponent<typeof MinimizableBottomSheet, {
+    schema: import("@rokt/dcui-layout-schema").MinimizableBottomSheetModel<import("@rokt/dcui-layout-schema").ModalChildren, import("@rokt/dcui-layout-schema").WhenPredicate> & {
+        startMinimized?: boolean;
+        showDragHandle?: boolean;
+    };
+    testId?: string | undefined;
+    context?: React.Context<import("react-redux").ReactReduxContextValue<any, import("redux").UnknownAction> | null> | undefined;
+    store?: import("redux").Store | undefined;
+}>;
+export declare function tryMakeMinimizableBottomSheet(schema: LayoutSchemaModel): JSX.Element | undefined;

package/dist/libraries/layout-renderer-utils/src/components/minimizable-bottomsheet/hooks.d.ts

@@ -0,0 +1,23 @@
+import { RefObject } from 'react';
+export declare const INITIAL_WRAPPER_HEIGHT = 100000;
+export declare const TAIL_HEIGHT_VH = 120;
+export declare const OFFSCREEN_HIDE_PX = 1000;
+export declare const NO_DRAG_DATA_ATTR = "data-rokt-bottomsheet-no-drag";
+export declare const MAX_UPWARD_OVERSCROLL_PX = 80;
+export declare const OVERSCROLL_RESISTANCE = 0.35;
+export declare function getMinimizedVisibleHeight(minimizedChildRef: RefObject<HTMLDivElement>, sheetRef: RefObject<HTMLDivElement>): number;
+export declare const useMinimizableBottomSheet: (startMinimized: boolean, activeBreakpoint?: string, isMinimizable?: boolean) => {
+    wrapperRef: RefObject<HTMLDivElement>;
+    containerRef: RefObject<HTMLDivElement>;
+    sheetRef: RefObject<HTMLDivElement>;
+    minimizedChildRef: RefObject<HTMLDivElement>;
+    maximizedChildRef: RefObject<HTMLDivElement>;
+    isMinimized: boolean;
+    setMinimized: (value: boolean) => void;
+};
+type CancelableCallback = (() => void) & {
+    cancel: () => void;
+};
+export declare function createResizeCallback(debounceDuration: number, callback: () => void): CancelableCallback;
+export declare function useSyncParentHeightToChildren(parentRef: RefObject<HTMLDivElement>): void;
+export {};

package/dist/libraries/layout-renderer-utils/src/components/minimizable-bottomsheet/index.d.ts

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

package/dist/libraries/layout-renderer-utils/src/components/minimizable-bottomsheet/minimizable-bottomsheet-wrapper.d.ts

@@ -0,0 +1,12 @@
+import { MinimizableBottomSheetProps } from './types';
+type MinimizableBottomSheetWrapperProps = {
+    schema: MinimizableBottomSheetProps['schema'];
+    testId?: string;
+    minimized?: boolean;
+    /** When provided and `onClose` is absent, the backdrop becomes clickable while maximized, invoking this to minimize. */
+    onMinimize?: () => void;
+    /** When provided, takes priority over `onMinimize` — the backdrop becomes clickable while maximized and invokes this to close/dismiss. */
+    onClose?: () => void;
+};
+export declare function MinimizableBottomSheetWrapper({ schema, testId, minimized, onMinimize, onClose, }: MinimizableBottomSheetWrapperProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/libraries/layout-renderer-utils/src/components/minimizable-bottomsheet/minimizable-bottomsheet.d.ts

@@ -0,0 +1,27 @@
+import React from 'react';
+import { MinimizableBottomSheetProps } from './types';
+type MinimizableBottomSheetContainerProps = {
+    schema: MinimizableBottomSheetProps['schema'];
+    ref: React.RefObject<HTMLDivElement>;
+    testId?: string;
+    sheetRef: React.RefObject<HTMLDivElement>;
+    minimizedChildRef: React.RefObject<HTMLDivElement>;
+    containerRef: React.RefObject<HTMLDivElement>;
+    maximizedChildRef: React.RefObject<HTMLDivElement>;
+    maximizedChildren: React.ReactNode;
+    minimizedChildren: React.ReactNode;
+    /** When true, minimized layout content ignores pointer events (parent `none` alone is not enough — descendants default to `auto`). */
+    isMinimized?: boolean;
+    /** From `useMinimizableBottomSheet`; expand interactions call `setMinimized(false)`. */
+    setMinimized?: (value: boolean) => void;
+};
+/**The MinimizableBottomSheet is a display node that is pinned to the bottom of the viewport, that
+ * can exist in two states: minimized and maximized.
+ * This is a Modal Bottomsheet, requiring user interaction before engaging with background content
+ * It should only be used for Mobile layouts.
+ * *Where can we use this: __outer layout__*
+ */
+export declare function MinimizableBottomSheet(props: MinimizableBottomSheetProps): import("react/jsx-runtime").JSX.Element;
+export declare const MinimizableBottomSheetContainer: React.ForwardRefExoticComponent<Omit<MinimizableBottomSheetContainerProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export declare function handleMinimizableBottomSheetTransition<RefElement extends HTMLElement>(element: RefElement): () => void;
+export {};

package/dist/libraries/layout-renderer-utils/src/components/minimizable-bottomsheet/sheet-gesture.d.ts

@@ -0,0 +1,18 @@
+/** Threshold velocity (px/ms) to snap when flicking from maximized or minimized. */
+export declare const SLIDE_THRESHOLD_PX_PER_MS = 0.2;
+/** Min downward translate (px) to minimize when dragging slowly from maximized. */
+export declare const MIN_DOWN_DRAG_PX = 48;
+/** Max samples of sheet offset while dragging; used for flick velocity. */
+export declare const MAX_OFFSET_SAMPLES = 20;
+export type OffsetSample = {
+    offsetPx: number;
+    timestamp: number;
+};
+export declare function recordOffsetSample(samples: OffsetSample[], offsetPx: number): void;
+/** Velocity of the sheet offset between the oldest and newest sample (px per ms). */
+export declare function velocityFromOffsetSamples(samples: OffsetSample[]): number;
+/** Whether a drag-down from maximized should commit to minimized (vs spring back). */
+export declare function shouldCompleteSheetGesture(args: {
+    velocityPxPerMs: number;
+    currentOffsetPx: number;
+}): boolean;

package/dist/libraries/layout-renderer-utils/src/components/minimizable-bottomsheet/types.d.ts

@@ -0,0 +1,63 @@
+import { WhenPredicate, ModalChildren, MinimizableBottomSheetModel } from '@rokt/dcui-layout-schema';
+export interface StateProps {
+    /** Whether the overlay is active or not*/
+    isOpen: boolean;
+}
+export interface OwnProps {
+    /**
+     *  - `settings`:
+     *    * `allowBackdropToClose`: Whether click backdrop will close the overlay. MUST be true when dismissible and allowBackdropToMinimize is false.
+     *    * `allowBackdropToMinimize`: Whether click backdrop will minimize the bottom sheet. If both are true, click closes.
+     *    * `minimizeOnComplete`: Whether the bottom sheet minimizes when user clicks final negative CTA button.
+     *    * `a11yLabel`: Accessibility label for screen readers. MUST describe the purpose of the bottom sheet.
+     *  - `children`: Content displayed in maximized state. Can accept all nodes except for itself.
+     *  - `minimizedChildren`: Content displayed in minimized state.
+     *  - `styles`:
+     *    * `elements`:
+     *      * `own`:
+     *        - `container`
+     *        - `background`
+     *        - `border`
+     *        - `dimension`
+     *        - `flexChild`
+     *        - `spacing`
+     *      * `wrapper`:
+     *         - `container`
+     *         - `background`
+     *      * `dragHandle`:
+     *         - `background`
+     *         - `border`
+     *         - `dimension`
+     *         - `spacing`
+     *    * `transitions`:
+     *      - `type`: 'Conditional'
+     *      - `transition`:
+     *        * `predicates`: WhenPredicate[]
+     *        * `duration`: number
+     *        * `value`:
+     *          * `own`:
+     *            - `container`
+     *            - `background`
+     *            - `border`
+     *            - `dimension`
+     *            - `flexChild`
+     *            - `spacing`
+     *          * `wrapper`:
+     *             - `container`
+     *             - `background`
+     *          * `dragHandle`:
+     *             - `background`
+     *             - `border`
+     *             - `dimension`
+     *             - `spacing`
+     */
+    schema: MinimizableBottomSheetModel<ModalChildren, WhenPredicate> & {
+        /** If true, the bottom sheet starts in minimized state. Defaults to false. */
+        startMinimized?: boolean;
+        /** If true, the drag handle is visible. If false, the drag handle is hidden. Defaults to true. */
+        showDragHandle?: boolean;
+    };
+    testId?: string;
+}
+export interface MinimizableBottomSheetProps extends OwnProps, StateProps {
+}

package/dist/libraries/layout-renderer-utils/src/components/minimize-button/factory.d.ts

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

package/dist/libraries/layout-renderer-utils/src/components/minimize-button/index.d.ts

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

package/dist/libraries/layout-renderer-utils/src/components/minimize-button/minimize-button.d.ts

@@ -0,0 +1,12 @@
+import { LayoutSchemaModel, MinimizeButtonModel, WhenPredicate } from '@rokt/dcui-layout-schema';
+export interface MinimizeButtonProps {
+    schema: MinimizeButtonModel<LayoutSchemaModel, WhenPredicate>;
+    testId?: string;
+}
+/**
+ * A button that toggles the MinimizableBottomSheet between minimized and maximized states.
+ * Unlike CloseButton, it does not dismiss the placement — it toggles the container state.
+ *
+ * *Where can we use this: __outer layout__ (inside MinimizableBottomSheet)*
+ */
+export declare function MinimizeButton(props: MinimizeButtonProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/libraries/layout-renderer-utils/src/components/overlay/overlay.d.ts

@@ -5,6 +5,7 @@ type OverlayContainerProps = {
     schema: OverlayProps['schema'];
     ref: React.RefObject<HTMLDivElement>;
     testId?: string;
+    isAttached?: boolean;
 };
 /**The Overlay is a display node that suits various purposes,
  * such as displaying modals, tooltips, informational pop-ups,

package/dist/libraries/layout-renderer-utils/src/components/overlay-wrapper/attached-overlay-wrapper.d.ts

@@ -0,0 +1,19 @@
+import React from 'react';
+import { MinimizableBottomSheetProps } from '../minimizable-bottomsheet/types';
+import { OverlayProps } from '../overlay/types';
+/**
+ * Wrapper for overlay components (Overlay, MinimizableBottomSheet) in "attached" mode,
+ * used when the active breakpoint is not 'default' (e.g. desktop). Provides full-viewport
+ * positioning, focus trapping, and Redux signal handling.
+ *
+ * The `children` prop is a render function receiving:
+ * - `containerChildren`: Schema-driven content from `schema.children`, mapped through the node mapper.
+ *   Callers should use this when displaying layout schema content, or pass their own content when
+ *   they need custom rendering (e.g. MinimizableBottomSheet with both maximized and minimized states).
+ * - `ref`: A ref to attach to the focusable container element for focus trap behavior.
+ *
+ * @param props - Combined props from OverlayProps or MinimizableBottomSheetProps
+ */
+export declare function AttachedOverlayWrapper({ isOpen, schema, testId, children: container, }: (OverlayProps | MinimizableBottomSheetProps) & {
+    children(containerChildren: React.ReactNode, ref: React.ForwardedRef<HTMLDivElement>): React.ReactNode;
+}): import("react/jsx-runtime").JSX.Element | null;

package/dist/libraries/layout-renderer-utils/src/components/overlay-wrapper/index.d.ts

@@ -1 +1,2 @@
 export * from './overlay-wrapper';
+export * from './attached-overlay-wrapper';

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

@@ -0,0 +1 @@
+export declare function hasExplicitHeightInOwnStyles(styles: unknown, activeBreakpointIndex?: number): boolean;

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

@@ -1,2 +1,2 @@
-export declare const OVERLAY_ID = "plugin-overlay";
+export { OVERLAY_ID } from '../../domain/src/behaviors';
 export declare const PLUGIN_ID = "plugin";

package/dist/libraries/layout-renderer-utils/src/hooks/useEscToClose.d.ts

@@ -0,0 +1 @@
+export declare function useEscToClose(): void;

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

@@ -0,0 +1,17 @@
+import { LayoutEvent } from '@rokt/dcui-layout-schema';
+/**
+ * Tracks which layout events have fired at least once during the placement
+ * lifecycle. A `true` value means the event has occurred; absent/false means
+ * it has not. Consumed by the `OnFirstEvent` When predicate.
+ */
+export type FiredEventsState = Partial<Record<LayoutEvent, boolean>>;
+/**
+ * Fired-events scoped per layout context. `root` holds the outer layout's
+ * events; each `module${offerPositionIndex}` bucket holds the events for one
+ * layout-variant slot, so an event firing in one slot does not leak into the
+ * others. Mirrors `CustomStatesIndexState`.
+ */
+export type FiredEventsIndexState = {
+    root: FiredEventsState;
+    [key: string]: FiredEventsState;
+};

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

@@ -0,0 +1,11 @@
+import { FormStatesState } from '../../../../domain/src/models';
+/**
+ * Form state indexed by scope, mirroring CustomStatesIndexState: `root` holds
+ * placement-scoped forms (those declared in the outer layout) and each
+ * `module<offerPositionIndex>` key holds the forms for a single format
+ * instance.
+ */
+export type FormStatesIndexState = {
+    root: FormStatesState;
+    [key: string]: FormStatesState;
+};

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

@@ -1,18 +1,23 @@
-import { LayoutSettings } from '@rokt/dcui-layout-schema';
 import { ActiveState } from './active';
 import { BreakpointState } from './breakpoint';
 import { FontsState } from './fonts';
 import { LayoutState } from './layout';
 import { SerializableCacheState } from './serializable-cache';
+import { SettingsState } from './settings';
 import { SignalState } from './signals';
 import { CustomStatesIndexState } from './custom-states';
+import { FiredEventsIndexState } from './fired-events';
+import { FormStatesIndexState } from './form-states';
 export * from './active';
 export * from './breakpoint';
 export * from './fonts';
 export * from './layout';
 export * from './serializable-cache';
+export * from './settings';
 export * from './signals';
 export * from './custom-states';
+export * from './fired-events';
+export * from './form-states';
 export type CoreAppState = {
     layout: LayoutState;
     breakpoint: BreakpointState;
@@ -20,6 +25,8 @@ export type CoreAppState = {
     fonts: FontsState;
     signal: SignalState;
     serializableCache: SerializableCacheState;
-    settings: LayoutSettings;
+    settings: SettingsState;
     customStates: CustomStatesIndexState;
+    firedEvents: FiredEventsIndexState;
+    formStates: FormStatesIndexState;
 };

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

@@ -1,7 +1,8 @@
-import { LayoutSchemaModel, LayoutSettings } from '@rokt/dcui-layout-schema';
+import { LayoutAction, LayoutSchemaModel, LayoutSettings, LayoutTimer, WhenPredicate } from '@rokt/dcui-layout-schema';
 export type LayoutState = null | {
     instanceGuid: string;
     layoutSchema: LayoutSchemaModel;
     layoutSchemaVersion: string;
     settings?: LayoutSettings;
+    timers?: Array<LayoutTimer<WhenPredicate, LayoutAction>>;
 };

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

@@ -0,0 +1,6 @@
+import { LayoutSettings } from '@rokt/dcui-layout-schema';
+export type SettingsState = LayoutSettings & {
+    minimizeOnComplete: boolean;
+    explicitCloseOnComplete: boolean;
+    bottomsheetVisibleHeight: number | null;
+};

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

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

package/dist/libraries/layout-renderer-utils/src/reducers/fired-events/reducer.d.ts

@@ -0,0 +1,5 @@
+import { AnyAction } from '@reduxjs/toolkit';
+import { FiredEventsIndexState, FiredEventsState } from '../../models';
+export declare function makeInitialFiredEventsIndexState(): FiredEventsIndexState;
+export declare function makeInitialFiredEventsState(): FiredEventsState;
+export declare function firedEventsReducer(state: FiredEventsIndexState | undefined, action: AnyAction): FiredEventsIndexState;

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

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

package/dist/libraries/layout-renderer-utils/src/reducers/form-states/reducer.d.ts

@@ -0,0 +1,4 @@
+import { AnyAction } from '@reduxjs/toolkit';
+import { FormStatesIndexState } from '../../models';
+export declare function makeInitialFormStatesIndexState(): FormStatesIndexState;
+export declare function formStatesReducer(state: FormStatesIndexState | undefined, action: AnyAction): FormStatesIndexState;

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

@@ -7,6 +7,8 @@ import { signalReducer } from './signal';
 import { serializableCacheReducer } from './serializable-cache';
 import { settingsReducer } from './settings';
 import { customStatesReducer } from './custom-states';
+import { firedEventsReducer } from './fired-events';
+import { formStatesReducer } from './form-states';
 export * from './breakpoint';
 export * from './layout';
 export * from './active';
@@ -15,6 +17,8 @@ export * from './signal';
 export * from './serializable-cache';
 export * from './settings';
 export * from './custom-states';
+export * from './fired-events';
+export * from './form-states';
 export declare const coreAppReducers: {
     layout: typeof layoutReducer;
     breakpoint: typeof breakpointReducer;
@@ -24,5 +28,7 @@ export declare const coreAppReducers: {
     serializableCache: typeof serializableCacheReducer;
     settings: typeof settingsReducer;
     customStates: typeof customStatesReducer;
+    firedEvents: typeof firedEventsReducer;
+    formStates: typeof formStatesReducer;
 };
 export declare function makeCoreAppInitialState(data?: Partial<CoreAppState>): CoreAppState;

package/dist/libraries/layout-renderer-utils/src/reducers/settings/reducer.d.ts

@@ -1,4 +1,4 @@
 import { AnyAction } from '@reduxjs/toolkit';
-import { LayoutSettings } from '@rokt/dcui-layout-schema';
-export declare function makeInitialSettingsState(): LayoutSettings;
-export declare function settingsReducer(state: LayoutSettings | undefined, action: AnyAction): LayoutSettings;
+import { SettingsState } from '../../models/state/settings';
+export declare function makeInitialSettingsState(): SettingsState;
+export declare function settingsReducer(state: SettingsState | undefined, action: AnyAction): SettingsState;

package/dist/libraries/layout-renderer-utils/src/sagas/error/error-codes.d.ts

@@ -16,3 +16,4 @@ export declare const FAILED_TO_LOAD_FONT = "FAILED_TO_LOAD_FONT";
 export declare const FAILED_TO_ESTABLISH_PARTNER_VALIDATION = "FAILED_TO_ESTABLISH_PARTNER_VALIDATION";
 export declare const PARTNER_VALIDATION_UPDATE_FAILED = "PARTNER_VALIDATION_UPDATE_FAILED";
 export declare const CART_SERVICE_RESPONSE_ERROR = "CART_SERVICE_RESPONSE_ERROR";
+export declare const UNSUPPORTED_LAYOUT_ACTION = "UNSUPPORTED_LAYOUT_ACTION";

package/dist/libraries/layout-renderer-utils/src/sagas/form-states/index.d.ts

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

package/dist/libraries/layout-renderer-utils/src/sagas/form-states/sagas.d.ts

@@ -0,0 +1,16 @@
+import { FormStateBehaviors } from '../../../../domain/src/behaviors';
+import { PutEffect } from 'redux-saga/effects';
+/**
+ * The GLOBAL/* form behaviors handled by {@link translateFormStateBehavior}.
+ * Derived from the translation map so the two cannot drift. Register with
+ * `takeEvery(formStateBehaviorTypes, translateFormStateBehavior)`.
+ */
+export declare const formStateBehaviorTypes: string[];
+/**
+ * Translates a global form behavior into its FORM_STATES/* store action, the
+ * same way `setCustomState` translates SET_CUSTOM_STATE. No
+ * `offerPositionIndex` is attached, so the reducer writes to the `root` scope
+ * — this is the outer-layout/child-layout path; on the variant path the
+ * GlobalStoreProxy performs this translation and injects the module scope.
+ */
+export declare function translateFormStateBehavior(action: FormStateBehaviors): Generator<PutEffect, void, never>;

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

@@ -6,6 +6,8 @@ export * as SagaUtils from './utils';
 export * from './signal';
 export * from './error';
 export * from './custom-states';
+export * from './form-states';
+export * from './trigger-action';
 export * from './metric';
 export * from './open-link';
 export * from './overlay';

package/dist/libraries/layout-renderer-utils/src/sagas/plugin/attached-bottomsheet.d.ts

@@ -0,0 +1,18 @@
+import { DisplayService } from '../../../../plugin-utils/src/index';
+import { DisplaySettings } from '@rokt/plugin';
+import { FrameControls } from '@rokt/dcui-layout-schema';
+import { SetDomainStateReducer } from '../../actions/domain-states';
+import { UpdateActiveBreakpointAction } from '../../actions/breakpoint';
+import { SetBottomsheetVisibleHeightAction } from '../../actions/settings';
+import { CoreAppState } from '../../models';
+export declare const selectBottomsheetVisibleHeight: (state: CoreAppState) => number | null;
+export declare const selectActiveBreakpoint: (state: CoreAppState) => string;
+export interface BottomsheetSagaContext {
+    isMinimized: boolean;
+    lastSettings: DisplaySettings | null;
+    controls: FrameControls | null;
+}
+export declare function attachedBottomsheetDisplaySaga(displayService: DisplayService, controls?: FrameControls | null): Generator<import("redux-saga/effects").AllEffect<import("redux-saga/effects").ForkEffect<never>>, void, unknown>;
+export declare function handleLayoutMinimizedChange(displayService: DisplayService, context: BottomsheetSagaContext, action: SetDomainStateReducer): Generator<import("redux-saga/effects").CallEffect<void> | import("redux-saga/effects").SelectEffect, void, never>;
+export declare function handleVisibleHeightChange(displayService: DisplayService, context: BottomsheetSagaContext, action: SetBottomsheetVisibleHeightAction): Generator<import("redux-saga/effects").CallEffect<void> | import("redux-saga/effects").SelectEffect, void, string>;
+export declare function handleBreakpointChange(displayService: DisplayService, context: BottomsheetSagaContext, action: UpdateActiveBreakpointAction): Generator<import("redux-saga/effects").CallEffect<void> | import("redux-saga/effects").SelectEffect, void, number | null>;