@wise/dynamic-flow-client 4.20.2 → 4.21.1

package/build/types/revamp/domain/components/BooleanInputComponent.d.ts

@@ -1,13 +1,16 @@
 import type { SchemaOnChange } from '../features/schema-on-change/getSchemaOnChange';
 import type { PerformValidationAsync } from '../features/validationAsync/getPerformValidationAsync';
-import type { BaseInputComponent, OnPersistAsync, OnValueChange, RepeatableSummary, UpdateComponent, ValidationAsyncState } from '../types';
+import type { BaseInputComponent, InlineAlert, OnPersistAsync, OnValueChange, RepeatableSummary, UpdateComponent, ValidationAsyncState, SupportingValues } from '../types';
 export type BooleanInputComponent = BaseInputComponent<boolean> & {
     type: 'boolean';
     kind: 'input';
+    additionalText?: string;
+    inlineAlert?: InlineAlert;
+    supportingValues?: SupportingValues;
     validationAsyncState: ValidationAsyncState;
     onChange: (value: boolean) => void;
 };
-export declare const createBooleanInputComponent: (booleanInputProps: Pick<BooleanInputComponent, "uid" | "id" | "analyticsId" | "alert" | "control" | "description" | "disabled" | "errors" | "help" | "hidden" | "media" | "required" | "title" | "tags" | "value" | "validationAsyncState"> & {
+export declare const createBooleanInputComponent: (booleanInputProps: Pick<BooleanInputComponent, "uid" | "id" | "additionalText" | "analyticsId" | "alert" | "control" | "description" | "disabled" | "errors" | "help" | "hidden" | "inlineAlert" | "media" | "required" | "supportingValues" | "title" | "tags" | "value" | "validationAsyncState"> & {
     schemaOnChange: SchemaOnChange | undefined;
     performValidationAsync: PerformValidationAsync | undefined;
     summariser: (value: boolean) => RepeatableSummary;

package/build/types/revamp/domain/components/RootDomainComponent.d.ts

@@ -7,6 +7,10 @@ export type RootDomainComponent = BaseComponent & {
     type: 'root';
     kind: 'step';
     stepComponent: StepDomainComponent | null;
+    stepStack: StepDomainComponent[];
+    isNativeBackEnabled: boolean;
+    isFlowCancellable: boolean;
+    canPerformBack: () => boolean;
     dismissAllModals: () => void;
     dismissModal: () => void;
     showModal: (modal: ModalComponent) => void;
@@ -21,8 +25,16 @@ export type RootDomainComponent = BaseComponent & {
     getTrackEvent: () => AnalyticsEventDispatcher<string> | null;
     setLoadingState: (loadingState: LoadingState) => void;
     hasStep: () => boolean;
+    start: () => void;
     stop: () => void;
-    setStep: (stepComponent: StepDomainComponent) => void;
+    getStep: () => StepDomainComponent | null;
+    pushStep: (stepComponent: StepDomainComponent) => void;
+    updateStep: (stepComponent: StepDomainComponent) => void;
+    clearStack: () => void;
+    navigateBack: () => void;
     getRefreshUrl: () => string | null;
 };
-export declare const createRootDomainComponent: (updateComponent: UpdateComponent, scrollToTop: ScrollToTop) => RootDomainComponent;
+export declare const createRootDomainComponent: (updateComponent: UpdateComponent, scrollToTop: ScrollToTop, backConfig: {
+    isNativeBackEnabled: boolean;
+    isFlowCancellable: boolean;
+}) => RootDomainComponent;

package/build/types/revamp/domain/components/SelectInputComponent.d.ts

@@ -1,6 +1,7 @@
 import type { Model } from '@wise/dynamic-flow-types/build/next';
 import type { AnalyticsEventDispatcher } from '../features/events';
 import type { SchemaOnChange } from '../features/schema-on-change/getSchemaOnChange';
+import type { InlineAlert, SupportingValues } from '../types';
 import type { IsInvalidCheck } from '../features/validation/value-checks';
 import type { BaseInputComponent, LocalValue, Media, OnValueChange, RepeatableSummary, SchemaComponent, UpdateComponent } from '../types';
 export type SelectInputComponent = BaseInputComponent<LocalValue | null> & {
@@ -15,13 +16,16 @@ export type SelectInputComponent = BaseInputComponent<LocalValue | null> & {
     getSelectedChild: () => SchemaComponent | null;
 };
 export type SelectInputOption = {
+    additionalText?: string;
     analyticsId?: string;
-    title: string;
     description?: string;
-    media?: Media;
-    keywords: string[];
     disabled: boolean;
+    inlineAlert?: InlineAlert;
+    keywords: string[];
+    media?: Media;
+    supportingValues?: SupportingValues;
     tags?: string[];
+    title: string;
 };
 export declare const createSelectInputComponent: (selectProps: Pick<SelectInputComponent, "uid" | "id" | "analyticsId" | "alert" | "autoComplete" | "control" | "errors" | "description" | "disabled" | "help" | "hidden" | "placeholder" | "required" | "title" | "tags"> & {
     initialModel: Model;

package/build/types/revamp/domain/components/step/StepDomainComponent.d.ts

@@ -1,6 +1,6 @@
 import type { BaseComponent, DomainComponent, LayoutComponent, LoadingState, LocalValue, OnBehavior, SchemaComponent, UpdateComponent } from '../../types';
 import { Model } from '@wise/dynamic-flow-types';
-import type { Step } from '@wise/dynamic-flow-types/build/next';
+import type { NavigationStackBehavior, Step } from '@wise/dynamic-flow-types/build/next';
 import type { AnalyticsEventDispatcher } from '../../features/events';
 import type { StepPolling } from '../../features/polling/getStepPolling';
 import { StepRefreshAfter } from '../../features/refreshAfter/getStepRefreshAfter';
@@ -20,7 +20,9 @@ export type StepDomainComponent = BaseComponent & {
     error?: string;
     externalConfirmation?: ExternalConfirmationComponent;
     loadingState: LoadingState;
+    stackBehavior: NavigationStackBehavior;
     step: Step;
+    etag: string | null;
     title?: string;
     modals: ModalComponent[];
     tags?: string[];
@@ -35,16 +37,16 @@ export type StepDomainComponent = BaseComponent & {
     validate: () => boolean;
     setLoadingState: (loadingState: LoadingState) => void;
     onBehavior: OnBehavior;
+    start: () => void;
     stop: () => void;
     trackEvent: AnalyticsEventDispatcher<string>;
 };
-type BackNavigation = {
+export type BackNavigation = {
     title?: string;
     onClick: () => void;
 };
-export declare const createStepComponent: (stepProps: Pick<StepDomainComponent, "uid" | "back" | "toolbar" | "layoutComponents" | "schemaComponents" | "footerComponents" | "control" | "description" | "error" | "externalConfirmation" | "loadingState" | "step" | "title" | "tags" | "trackEvent" | "onBehavior"> & {
+export declare const createStepComponent: (stepProps: Pick<StepDomainComponent, "uid" | "back" | "toolbar" | "layoutComponents" | "schemaComponents" | "footerComponents" | "control" | "description" | "error" | "externalConfirmation" | "loadingState" | "stackBehavior" | "etag" | "step" | "title" | "tags" | "trackEvent" | "onBehavior"> & {
     stepPolling?: StepPolling;
     stepRefreshAfter?: StepRefreshAfter;
     updateComponent: UpdateComponent;
 }) => StepDomainComponent;
-export {};

package/build/types/revamp/domain/features/events.d.ts

@@ -1,6 +1,6 @@
 export type AnalyticsEventHandler = (eventName: string, properties?: Record<string, unknown>) => void;
 export type AnalyticsEventDispatcher<E extends string = EventName> = (eventName: E, properties?: Record<string, unknown>) => void;
-export type EventName = 'Initiated' | 'Succeeded' | 'Failed' | 'Step Shown' | 'Action Triggered' | 'Action Succeeded' | 'Action Aborted' | 'Action Failed' | 'Refresh Triggered' | 'Refresh Succeeded' | 'Refresh Aborted' | 'Refresh Failed' | 'OneOf Selected' | 'PersistAsync Triggered' | 'PersistAsync Succeeded' | 'PersistAsync Failed' | 'Polling Failed' | 'ValidationAsync Triggered' | 'ValidationAsync Succeeded' | 'ValidationAsync Failed' | 'Value Changed';
+export type EventName = 'Initiated' | 'Succeeded' | 'Failed' | 'Cancelled' | 'Step Shown' | 'Action Triggered' | 'Action Succeeded' | 'Action Aborted' | 'Action Failed' | 'Refresh Triggered' | 'Refresh Succeeded' | 'Refresh Aborted' | 'Refresh Failed' | 'OneOf Selected' | 'PersistAsync Triggered' | 'PersistAsync Succeeded' | 'PersistAsync Failed' | 'Polling Failed' | 'ValidationAsync Triggered' | 'ValidationAsync Succeeded' | 'ValidationAsync Failed' | 'Value Changed';
 export type LogLevel = 'info' | 'warning' | 'error';
 export type LoggingEventHandler = (level: LogLevel, message: string, extra: Record<string, unknown>) => void;
 export type LoggingEventDispatcher = (level: LogLevel, message: string, extra?: Record<string, unknown>) => void;

package/build/types/revamp/domain/features/polling/getStepPolling.d.ts

@@ -1,11 +1,14 @@
 import type { Polling } from '@wise/dynamic-flow-types/build/next';
 import type { OnBehavior, OnPoll } from '../../types';
+import { LoggingEventDispatcher } from '../events';
 export type StepPollingProps = {
     pollingConfig: Polling;
+    logEvent: LoggingEventDispatcher;
     onBehavior: OnBehavior;
     onPoll: OnPoll;
 };
 export type StepPolling = {
+    start: () => void;
     stop: () => void;
 };
-export declare const getStepPolling: ({ pollingConfig, onBehavior, onPoll, }: StepPollingProps) => StepPolling;
+export declare const getStepPolling: ({ pollingConfig, logEvent, onBehavior, onPoll, }: StepPollingProps) => StepPolling;

package/build/types/revamp/domain/features/refreshAfter/getStepRefreshAfter.d.ts

@@ -1,10 +1,13 @@
 import { OnBehavior } from '../../types';
+import { LoggingEventDispatcher } from '../events';
 export type StepRefreshAfter = {
+    start: () => void;
     stop: () => void;
 };
 type Props = {
     refreshAfter: string;
+    logEvent: LoggingEventDispatcher;
     onBehavior: OnBehavior;
 };
-export declare const getStepRefreshAfter: ({ refreshAfter, onBehavior }: Props) => StepRefreshAfter;
+export declare const getStepRefreshAfter: ({ refreshAfter, logEvent, onBehavior, }: Props) => StepRefreshAfter;
 export {};

package/build/types/revamp/domain/mappers/mapStepToComponent.d.ts

@@ -3,10 +3,11 @@ import type { LoadingState, OnPoll } from '../types';
 import type { MapperProps } from './schema/types';
 export type StepMapperProps = Omit<MapperProps, 'trackEvent'> & {
     uid: string;
+    etag: string | null;
     displayStepTitle: boolean;
     loadingState: LoadingState;
     trackEvent: AnalyticsEventDispatcher<string>;
-    onPoll: OnPoll;
     features: Record<string, unknown>;
+    onPoll: OnPoll;
 };
 export declare const mapStepToComponent: ({ uid: rootUid, loadingState, displayStepTitle, features, trackEvent, onPoll, onBehavior, ...restProps }: StepMapperProps) => import("../components/step/StepDomainComponent").StepDomainComponent;

package/build/types/revamp/domain/mappers/schema/oneOfSchemaToComponent/oneOfSchemaToComponent.d.ts

@@ -82,6 +82,9 @@ export declare const oneOfSchemaToComponent: (schemaMapperProps: SchemaMapperPro
 } & {
     type: "boolean";
     kind: "input";
+    additionalText?: string;
+    inlineAlert?: import("../../../types").InlineAlert;
+    supportingValues?: import("../../../types").SupportingValues;
     validationAsyncState: import("../../../types").ValidationAsyncState;
     onChange: (value: boolean) => void;
 } & {

package/build/types/revamp/domain/mappers/schema/persistAsyncSchemaToComponent.d.ts

@@ -56,6 +56,9 @@ export declare const persistAsyncSchemaToComponent: (schemaMapperProps: SchemaMa
 } & {
     type: "boolean";
     kind: "input";
+    additionalText?: string;
+    inlineAlert?: import("../../types").InlineAlert;
+    supportingValues?: import("../../types").SupportingValues;
     validationAsyncState: import("../../types").ValidationAsyncState;
     onChange: (value: boolean) => void;
 } & {

package/build/types/revamp/domain/mappers/utils/feature-utils.d.ts

@@ -1,3 +1,3 @@
-type Feature = 'pinnedButtons';
+type Feature = 'pinnedButtons' | 'nativeBack';
 export declare const isFeatureEnabled: (features: Record<string, unknown>, featureName: Feature) => boolean;
 export {};

package/build/types/revamp/domain/types.d.ts

@@ -1,4 +1,4 @@
-import type { ActionBehavior, CopyBehavior, DismissBehavior, Icon, JsonElement, LinkBehavior, Margin, ModalBehavior, Model } from '@wise/dynamic-flow-types/build/next';
+import type { Action, ActionBehavior, CopyBehavior, DismissBehavior, Icon, JsonElement, LinkBehavior, Margin, ModalBehavior, Model } from '@wise/dynamic-flow-types/build/next';
 import type { AlertComponent } from './components/AlertComponent';
 import type { AllOfComponent } from './components/AllOfComponent';
 import type { BooleanInputComponent } from './components/BooleanInputComponent';
@@ -66,13 +66,17 @@ export type CallToAction = {
     href: string;
     onClick: () => void;
 };
-export type Behavior = (ActionBehavior | CopyBehavior | DismissBehavior | LinkBehavior | ModalBehavior | NonMergingActionBehaviour | NullAction | RefreshBehavior) & {
+export type Behavior = (ActionBehavior | CopyBehavior | DismissBehavior | LinkBehavior | ModalBehavior | NonMergingActionBehaviour | NullBehavior | RefreshBehavior | BackBehaviour) & {
     analytics?: Record<string, unknown>;
 };
 type NonMergingActionBehaviour = Omit<ActionBehavior, 'type'> & {
     type: 'non-merging-action';
 };
-type NullAction = {
+type BackBehaviour = {
+    type: 'back';
+    action?: Action;
+};
+type NullBehavior = {
     type: 'none';
 };
 type RefreshBehavior = {
@@ -161,6 +165,7 @@ export type OnBehavior = (behavior: Behavior) => Promise<BehaviorController>;
 export type BehaviorController = {
     abort: () => void;
 };
+export type OnBack = (action: Action | undefined) => void;
 export type OnPoll = (url: string, errorBehavior: Behavior, signal: AbortSignal) => Promise<boolean>;
 export type OnLink = (url: string) => boolean;
 export type OnValueChange = () => void;

package/build/types/revamp/renderers/stepComponentToProps.d.ts

@@ -1,4 +1,6 @@
 import type { StepRendererProps } from '@wise/dynamic-flow-types/build/renderers';
 import type { StepDomainComponent } from '../domain/components/step/StepDomainComponent';
 import { type RendererMapperProps } from './mappers/componentToRendererProps';
-export declare const stepComponentToProps: (component: StepDomainComponent, rendererMapperProps: RendererMapperProps) => StepRendererProps;
+export declare const stepComponentToProps: (component: StepDomainComponent, rendererMapperProps: RendererMapperProps & {
+    showBack: boolean;
+}) => StepRendererProps;

package/build/types/revamp/types.d.ts

@@ -7,6 +7,7 @@ type DynamicFlowCorePropsBasic = {
     httpClient: HttpClient;
     renderers: Renderers;
     features?: Record<string, unknown>;
+    onCancellation?: () => void;
     onCompletion: (result: Model) => void;
     onCopy?: (copiedString: string | null) => void;
     onError: (error: unknown, status?: number) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wise/dynamic-flow-client",
-  "version": "4.20.2",
+  "version": "4.21.1",
   "description": "Dynamic Flow web client",
   "license": "Apache-2.0",
   "main": "./build/main.js",
@@ -36,12 +36,12 @@
     "@babel/preset-env": "7.28.5",
     "@babel/preset-react": "7.28.5",
     "@babel/preset-typescript": "7.28.5",
-    "@chromatic-com/storybook": "4.1.1",
+    "@chromatic-com/storybook": "4.1.2",
     "@formatjs/cli": "^6.7.4",
-    "@storybook/addon-a11y": "^9.1.15",
-    "@storybook/addon-docs": "^9.1.15",
-    "@storybook/addon-links": "^9.1.15",
-    "@storybook/react-vite": "9.1.15",
+    "@storybook/addon-a11y": "^9.1.16",
+    "@storybook/addon-docs": "^9.1.16",
+    "@storybook/addon-links": "^9.1.16",
+    "@storybook/react-vite": "9.1.16",
     "@testing-library/dom": "10.4.1",
     "@testing-library/jest-dom": "6.9.1",
     "@testing-library/react": "16.3.0",
@@ -52,7 +52,7 @@
     "@transferwise/navigation-ui": "4.40.0",
     "@transferwise/neptune-css": "14.25.1",
     "@types/jest": "30.0.0",
-    "@types/node": "22.18.12",
+    "@types/node": "22.19.0",
     "@types/react": "18.3.26",
     "@types/react-dom": "18.3.7",
     "@types/react-intl": "3.0.0",
@@ -60,8 +60,8 @@
     "@wise/components-theming": "^1.7.0",
     "babel-jest": "30.2.0",
     "esbuild": "0.25.9",
-    "eslint-plugin-storybook": "9.1.15",
-    "framer-motion": "^12.23.22",
+    "eslint-plugin-storybook": "9.1.16",
+    "framer-motion": "^12.23.24",
     "jest": "30.2.0",
     "jest-environment-jsdom": "30.2.0",
     "jest-fetch-mock": "^3.0.3",
@@ -73,7 +73,7 @@
     "react": "18.3.1",
     "react-dom": "18.3.1",
     "react-intl": "6.8.9",
-    "storybook": "^9.1.15",
+    "storybook": "^9.1.16",
     "stylelint": "16.25.0",
     "stylelint-config-standard": "36.0.1",
     "stylelint-no-unsupported-browser-features": "8.0.5",
@@ -97,7 +97,7 @@
     "classnames": "2.5.1",
     "react-webcam": "^7.2.0",
     "screenfull": "^5.2.0",
-    "@wise/dynamic-flow-types": "3.18.0"
+    "@wise/dynamic-flow-types": "3.19.0"
   },
   "scripts": {
     "dev": "EXCLUDE_VISUAL_TESTS=true pnpm storybook dev -p 3003",