@rokt/dcui-orchestrator 0.2.1-rc.9 → 0.3.1-rc.0

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-image-carousel/carousel-indicators.d.ts

@@ -0,0 +1,20 @@
+import { DataImageCarouselModel, CarouselActiveIndicatorMode, WhenPredicate } from '@rokt/dcui-layout-schema';
+type CarouselIndicatorsProps = {
+    indicatorClasses?: {
+        progressIndicatorContainer?: string;
+        indicator?: string;
+        activeIndicator?: string;
+        seenIndicator?: string;
+    };
+    activeIndicatorMode?: CarouselActiveIndicatorMode | null;
+    activeIndicatorStyles?: NonNullable<NonNullable<DataImageCarouselModel<WhenPredicate>['styles']>['elements']>['activeIndicator'];
+    activeIndex: number;
+    count: number;
+    transitionDuration?: number;
+    testId?: string;
+};
+export declare const defaultIndicatorContainerStyles: NonNullable<NonNullable<NonNullable<DataImageCarouselModel<WhenPredicate>['styles']>['elements']>['progressIndicatorContainer']>;
+export declare const defaultIndicatorStyles: NonNullable<NonNullable<NonNullable<DataImageCarouselModel<WhenPredicate>['styles']>['elements']>['indicator']>;
+export declare const defaultActiveIndicatorStyles: NonNullable<NonNullable<NonNullable<DataImageCarouselModel<WhenPredicate>['styles']>['elements']>['activeIndicator']>;
+export declare function CarouselIndicators(props: CarouselIndicatorsProps): import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -0,0 +1,100 @@
+import { DataImageCarouselModel, WhenPredicate } from '@rokt/dcui-layout-schema';
+export interface DataImageCarouselProps {
+    /**
+     *  - `imageKey`: the key prefix for the image objects of the creative images contexts.
+     *  - `indicators`:
+     *    * `show`: boolean
+     *    * `activeIndicatorMode`: 'Progress' | 'Seen'
+     *  - `duration`: number - Time in milliseconds before changing to the next image.
+     *  - `transition`:
+     *    * `type`: 'SlideInOut' | 'FadeInOut' - Transition type.
+     *    * `settings`:
+     *      * `speed`: 'fast' | 'medium' | 'slow' - Speed of the transition.
+     *  - `a11yLabel`: string
+     *  - `styles`:
+     *    * `elements`:
+     *      * `own`:
+     *        - `container`
+     *        - `background`
+     *        - `border`
+     *        - `dimension`
+     *        - `flexChild`
+     *        - `spacing`
+     *      * `progressIndicatorContainer`:
+     *        - `container`
+     *        - `background`
+     *        - `border`
+     *        - `dimension`
+     *        - `flexChild`
+     *        - `spacing`
+     *      * `indicator`:
+     *        - `container`
+     *        - `background`
+     *        - `border`
+     *        - `dimension`
+     *        - `flexChild`
+     *        - `spacing`
+     *      * `seenIndicator`:
+     *        - `container`
+     *        - `background`
+     *        - `border`
+     *        - `dimension`
+     *        - `flexChild`
+     *        - `spacing`
+     *      * `activeIndicator`:
+     *        - `container`
+     *        - `background`
+     *        - `border`
+     *        - `dimension`
+     *        - `flexChild`
+     *        - `spacing`
+     *    * `transitions`:
+     *      - `type`: 'Conditional'
+     *      - `transition`:
+     *        * `predicates`: WhenPredicate[]
+     *        * `duration`: number
+     *        * `value`:
+     *          * `own`:
+     *            - `container`
+     *            - `background`
+     *            - `border`
+     *            - `dimension`
+     *            - `flexChild`
+     *            - `spacing`
+     *          * `progressIndicatorContainer`:
+     *            - `container`
+     *            - `background`
+     *            - `border`
+     *            - `dimension`
+     *            - `flexChild`
+     *            - `spacing`
+     *          * `indicator`:
+     *            - `container`
+     *            - `background`
+     *            - `border`
+     *            - `dimension`
+     *            - `flexChild`
+     *            - `spacing`
+     *          * `seenIndicator`:
+     *            - `container`
+     *            - `background`
+     *            - `border`
+     *            - `dimension`
+     *            - `flexChild`
+     *            - `spacing`
+     *          * `activeIndicator`:
+     *            - `container`
+     *            - `background`
+     *            - `border`
+     *            - `dimension`
+     *            - `flexChild`
+     *            - `spacing`
+     */
+    schema: DataImageCarouselModel<WhenPredicate>;
+    testId?: string;
+}
+/** The DataImageCarousel is an image node that displays all images prefixed with the given key in the creative images contexts. <br>
+ * It supports various formats and sizes.<br>
+ * *Where can we use this: __layout variant__*
+ * */
+export declare function DataImageCarousel(props: DataImageCarouselProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/libraries/dcui-components/src/components/data-image-carousel/factory.d.ts

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

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

@@ -0,0 +1,2 @@
+export * from './data-image-carousel';
+export * from './factory';

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/icon-group/factory.d.ts

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

package/dist/libraries/dcui-components/src/components/icon-group/icon-group.d.ts

@@ -0,0 +1,36 @@
+import { IconGroupModel, WhenPredicate } from '@rokt/dcui-layout-schema';
+export interface IconGroupProps {
+    /**
+     *  - `name`: the unique name for an icon in a pre-defined icon sets.
+     *  - `rating`: the source of the rating number in creative, or string number.
+     *  - `styles`:
+     *    * `own`:
+     *      - `text`
+     *      - `dimension`
+     *      - `flexChild`
+     *      - `spacing`
+     *      - `background`
+     *      - `border`
+     *    * `filled`:
+     *      - `text`
+     *      - `dimension`
+     *      - `flexChild`
+     *      - `spacing`
+     *      - `background`
+     *      - `border`
+     *    * `unfilled`:
+     *      - `text`
+     *      - `dimension`
+     *      - `flexChild`
+     *      - `spacing`
+     *      - `background`
+     *      - `border`
+     */
+    schema: IconGroupModel<WhenPredicate>;
+    testId?: string;
+}
+/** The IconGroup is an icon node that displays an icon rating through the icon tag. <br>
+ * It supports various formats and sizes.<br>
+ * *Where can we use this: __outer layout__, __layout variant__*
+ * */
+export declare function IconGroup(props: IconGroupProps): import("react/jsx-runtime").JSX.Element | null;

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

@@ -0,0 +1,2 @@
+export * from './icon-group';
+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;
 }