@wise/dynamic-flow-client-internal 3.8.0 → 3.9.0-experimental-90bdf26

package/README.md

@@ -58,7 +58,7 @@ import {
   translations as dynamicFlowsTranslations,
 } from '@wise/dynamic-flow-client-internal';
 
-const messages = getLocalisedMessages(locale, [componentTranslations, dynamicFlowsTranslations])
+const messages = getLocalisedMessages(locale, [componentTranslations, dynamicFlowsTranslations]);
 
 return (
   <Provider i18n={{ locale, messages }}>
@@ -73,7 +73,7 @@ return (
 
 ### For non-CRAB apps
 
-You'll need to merge the '@transferwise/components' translations with the '@wise/dynamic-flow-client' translations.  
+You'll need to merge the '@transferwise/components' translations with the '@wise/dynamic-flow-client' translations.
 
 ```js
 import {
@@ -238,6 +238,51 @@ type LoaderConfig = {
 | `initial`    | boolean | Whether or not to display the Loader component while loading the initial step. | true    |
 | `submission` | boolean | Whether or not to display the Loader component during form submissions.        | false   |
 
+## DynamicFragment
+
+If you need to get the submittable data outside of a submission, you can use the `DynamicFragment` component. This will give you access to two methods: `getValue` and `validate` via a [ref](https://react.dev/reference/react/useRef). For example:
+
+```tsx
+import type { DynamicFragmentController } from '@wise/dynamic-flow-client-internal';
+import { DynamicFragment } from '@wise/dynamic-flow-client-internal';
+import { useRef } from 'react';
+
+function DynamicFlowWithRef() {
+  const ref = useRef<DynamicFragmentController>(null);
+
+  return (
+    <>
+      <DynamicFragment
+          ref={ref}
+          flowId={"id"}
+          customFetch={fetch}
+          initialStep={selectedStep}
+          onValueChange={async () => {
+              const value = (await ref.current?.getValue()) ?? null);
+              console.log('Value changed to', JSON.stringify(value));
+          }}
+          onCompletion={(error) => console.error(error)}
+          onCompletion={() => console.log('Completed')}
+      />
+      <Button
+        onClick={async () => {
+          // This will get the value, whether or not the form is valid
+          const value = (await ref.current?.getValue()) ?? null);
+
+          // This will trigger validation of the form and show any validation messages to the user.
+          // The response is a boolean indicating whether or not the form is valid.
+          const isValid = ref.current?.validate();
+
+          // Whatever you want to do with value
+        }}
+      >
+        Log value
+      </Button>
+    </>
+  );
+}
+```
+
 ## Contributing
 
 We love contributions! Check out `CONTRIBUTING.md` for more information.

package/build/dynamicFlow/DynamicFlow.js

@@ -0,0 +1,34 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+import { jsx as _jsx } from "react/jsx-runtime";
+import { DynamicFlowRevamp as DynamicFlowCoreRevamp, DynamicFlow as DynamicFlowCoreLegacy, DynamicFragmentWise, } from '@wise/dynamic-flow-client';
+import { forwardRef } from 'react';
+export function DynamicFlowLegacy(props) {
+    var _a = props.customFetch, customFetch = _a === void 0 ? globalThis.fetch : _a;
+    var coreProps = __assign(__assign({}, props), { httpClient: customFetch });
+    return _jsx(DynamicFlowCoreLegacy, __assign({}, coreProps));
+}
+export function DynamicFlowRevamp(props) {
+    var _a = props.customFetch, customFetch = _a === void 0 ? globalThis.fetch : _a;
+    var coreProps = __assign(__assign({}, props), { httpClient: customFetch });
+    return _jsx(DynamicFlowCoreRevamp, __assign({}, coreProps));
+}
+/**
+ * DynamicFragment is like DynamicFlowRevamp, but it also accepts a ForwardedRef.
+ * This ref conforms to the DynamicFragmentController type, containing two functions: `getValue` and `validate`.
+ * @experimental This component may be changed in the future without notice.
+ */
+export var DynamicFragment = forwardRef(function DynamicFragment(props, ref) {
+    var _a = props.customFetch, customFetch = _a === void 0 ? globalThis.fetch : _a;
+    var coreProps = __assign(__assign({}, props), { httpClient: customFetch });
+    return _jsx(DynamicFragmentWise, __assign({}, coreProps, { ref: ref }));
+});

package/build/index.js

@@ -0,0 +1,4 @@
+import { makeHttpClient } from '@wise/dynamic-flow-client';
+export { translations, JsonSchemaForm, isValidSchema } from '@wise/dynamic-flow-client';
+export { DynamicFlowLegacy as DynamicFlow, DynamicFlowLegacy, DynamicFlowRevamp, DynamicFragment, } from './dynamicFlow/DynamicFlow';
+export var makeCustomFetch = makeHttpClient;

package/build/main.js

@@ -40,6 +40,7 @@ __export(src_exports, {
   DynamicFlow: () => DynamicFlowLegacy,
   DynamicFlowLegacy: () => DynamicFlowLegacy,
   DynamicFlowRevamp: () => DynamicFlowRevamp,
+  DynamicFragment: () => DynamicFragment,
   JsonSchemaForm: () => import_dynamic_flow_client3.JsonSchemaForm,
   isValidSchema: () => import_dynamic_flow_client3.isValidSchema,
   makeCustomFetch: () => makeCustomFetch,
@@ -51,6 +52,7 @@ var import_dynamic_flow_client3 = require("@wise/dynamic-flow-client");
 
 // src/dynamicFlow/DynamicFlow.tsx
 var import_dynamic_flow_client = require("@wise/dynamic-flow-client");
+var import_react = require("react");
 var import_jsx_runtime = require("react/jsx-runtime");
 function DynamicFlowLegacy(props) {
   const { customFetch = globalThis.fetch } = props;
@@ -62,6 +64,11 @@ function DynamicFlowRevamp(props) {
   const coreProps = __spreadProps(__spreadValues({}, props), { httpClient: customFetch });
   return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_dynamic_flow_client.DynamicFlowRevamp, __spreadValues({}, coreProps));
 }
+var DynamicFragment = (0, import_react.forwardRef)(function DynamicFragment2(props, ref) {
+  const { customFetch = globalThis.fetch } = props;
+  const coreProps = __spreadProps(__spreadValues({}, props), { httpClient: customFetch });
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_dynamic_flow_client.DynamicFragmentWise, __spreadProps(__spreadValues({}, coreProps), { ref }));
+});
 
 // src/index.ts
 var makeCustomFetch = import_dynamic_flow_client2.makeHttpClient;

package/build/main.min.js

@@ -1 +1 @@
-"use strict";var n=Object.defineProperty,P=Object.defineProperties,C=Object.getOwnPropertyDescriptor,f=Object.getOwnPropertyDescriptors,v=Object.getOwnPropertyNames,s=Object.getOwnPropertySymbols;var w=Object.prototype.hasOwnProperty,R=Object.prototype.propertyIsEnumerable;var F=(t,o,i)=>o in t?n(t,o,{enumerable:!0,configurable:!0,writable:!0,value:i}):t[o]=i,c=(t,o)=>{for(var i in o||(o={}))w.call(o,i)&&F(t,i,o[i]);if(s)for(var i of s(o))R.call(o,i)&&F(t,i,o[i]);return t},p=(t,o)=>P(t,f(o));var g=(t,o)=>{for(var i in o)n(t,i,{get:o[i],enumerable:!0})},L=(t,o,i,r)=>{if(o&&typeof o=="object"||typeof o=="function")for(let e of v(o))!w.call(t,e)&&e!==i&&n(t,e,{get:()=>o[e],enumerable:!(r=C(o,e))||r.enumerable});return t};var u=t=>L(n({},"__esModule",{value:!0}),t);var W={};g(W,{DynamicFlow:()=>l,DynamicFlowLegacy:()=>l,DynamicFlowRevamp:()=>D,JsonSchemaForm:()=>a.JsonSchemaForm,isValidSchema:()=>a.isValidSchema,makeCustomFetch:()=>I,translations:()=>a.translations});module.exports=u(W);var h=require("@wise/dynamic-flow-client"),a=require("@wise/dynamic-flow-client");var m=require("@wise/dynamic-flow-client");var y=require("react/jsx-runtime");function l(t){let{customFetch:o=globalThis.fetch}=t,i=p(c({},t),{httpClient:o});return(0,y.jsx)(m.DynamicFlow,c({},i))}function D(t){let{customFetch:o=globalThis.fetch}=t,i=p(c({},t),{httpClient:o});return(0,y.jsx)(m.DynamicFlowRevamp,c({},i))}var I=h.makeHttpClient;
+"use strict";var p=Object.defineProperty,g=Object.defineProperties,C=Object.getOwnPropertyDescriptor,R=Object.getOwnPropertyDescriptors,v=Object.getOwnPropertyNames,s=Object.getOwnPropertySymbols;var w=Object.prototype.hasOwnProperty,u=Object.prototype.propertyIsEnumerable;var F=(t,o,e)=>o in t?p(t,o,{enumerable:!0,configurable:!0,writable:!0,value:e}):t[o]=e,a=(t,o)=>{for(var e in o||(o={}))w.call(o,e)&&F(t,e,o[e]);if(s)for(var e of s(o))u.call(o,e)&&F(t,e,o[e]);return t},c=(t,o)=>g(t,R(o));var d=(t,o)=>{for(var e in o)p(t,e,{get:o[e],enumerable:!0})},L=(t,o,e,r)=>{if(o&&typeof o=="object"||typeof o=="function")for(let i of v(o))!w.call(t,i)&&i!==e&&p(t,i,{get:()=>o[i],enumerable:!(r=C(o,i))||r.enumerable});return t};var W=t=>L(p({},"__esModule",{value:!0}),t);var I={};d(I,{DynamicFlow:()=>y,DynamicFlowLegacy:()=>y,DynamicFlowRevamp:()=>h,DynamicFragment:()=>P,JsonSchemaForm:()=>m.JsonSchemaForm,isValidSchema:()=>m.isValidSchema,makeCustomFetch:()=>x,translations:()=>m.translations});module.exports=W(I);var f=require("@wise/dynamic-flow-client"),m=require("@wise/dynamic-flow-client");var n=require("@wise/dynamic-flow-client"),D=require("react");var l=require("react/jsx-runtime");function y(t){let{customFetch:o=globalThis.fetch}=t,e=c(a({},t),{httpClient:o});return(0,l.jsx)(n.DynamicFlow,a({},e))}function h(t){let{customFetch:o=globalThis.fetch}=t,e=c(a({},t),{httpClient:o});return(0,l.jsx)(n.DynamicFlowRevamp,a({},e))}var P=(0,D.forwardRef)(function(o,e){let{customFetch:r=globalThis.fetch}=o,i=c(a({},o),{httpClient:r});return(0,l.jsx)(n.DynamicFragmentWise,c(a({},i),{ref:e}))});var x=f.makeHttpClient;

package/build/main.mjs

@@ -25,8 +25,10 @@ import { translations, JsonSchemaForm, isValidSchema } from "@wise/dynamic-flow-
 // src/dynamicFlow/DynamicFlow.tsx
 import {
   DynamicFlowRevamp as DynamicFlowCoreRevamp,
-  DynamicFlow as DynamicFlowCoreLegacy
+  DynamicFlow as DynamicFlowCoreLegacy,
+  DynamicFragmentWise
 } from "@wise/dynamic-flow-client";
+import { forwardRef } from "react";
 import { jsx } from "react/jsx-runtime";
 function DynamicFlowLegacy(props) {
   const { customFetch = globalThis.fetch } = props;
@@ -38,6 +40,11 @@ function DynamicFlowRevamp(props) {
   const coreProps = __spreadProps(__spreadValues({}, props), { httpClient: customFetch });
   return /* @__PURE__ */ jsx(DynamicFlowCoreRevamp, __spreadValues({}, coreProps));
 }
+var DynamicFragment = forwardRef(function DynamicFragment2(props, ref) {
+  const { customFetch = globalThis.fetch } = props;
+  const coreProps = __spreadProps(__spreadValues({}, props), { httpClient: customFetch });
+  return /* @__PURE__ */ jsx(DynamicFragmentWise, __spreadProps(__spreadValues({}, coreProps), { ref }));
+});
 
 // src/index.ts
 var makeCustomFetch = makeHttpClient;
@@ -45,6 +52,7 @@ export {
   DynamicFlowLegacy as DynamicFlow,
   DynamicFlowLegacy,
   DynamicFlowRevamp,
+  DynamicFragment,
   JsonSchemaForm,
   isValidSchema,
   makeCustomFetch,

package/build/stories/DynamicFlow.story.js

@@ -0,0 +1,52 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+import { jsx as _jsx } from "react/jsx-runtime";
+import { action } from '@storybook/addon-actions';
+import { layouts, features, examples, schemas } from '@wise/dynamic-flow-fixtures';
+import { DynamicFlowLegacy, DynamicFlowRevamp } from '../index';
+import { fixtureHttpClient } from './utils/fixtureHttpClient';
+var fixtures = __assign(__assign(__assign(__assign({}, examples), schemas), layouts), features);
+function DynamicFlowRenderer(_a) {
+    var _b = _a.initialStepName, initialStepName = _b === void 0 ? '' : _b, _c = _a.revampEnabled, revampEnabled = _c === void 0 ? false : _c;
+    var selectedStep = fixtures[initialStepName] || {};
+    var props = {
+        flowId: 'storybook',
+        customFetch: fixtureHttpClient,
+        onCompletion: action('onCompletion'),
+        onError: action('onError'),
+        onEvent: action('onEvent'),
+        onLog: action('onLog'),
+    };
+    return revampEnabled ? (_jsx(DynamicFlowRevamp, __assign({}, props, { initialAction: { method: 'GET', url: "/steps/".concat(initialStepName) } }), selectedStep.id)) : (_jsx(DynamicFlowLegacy, __assign({}, props, { initialAction: { method: 'GET', url: "/steps/".concat(initialStepName) }, loaderConfig: { size: 'xl', initial: true, submission: false } }), selectedStep.id));
+}
+var meta = {
+    title: 'Multi-fixture',
+    component: DynamicFlowRenderer,
+};
+export var AllFixtures = {
+    argTypes: {
+        initialStepName: {
+            label: 'Initial Step',
+            control: 'select',
+            options: Object.keys(fixtures),
+        },
+        revampEnabled: {
+            label: 'Enable revamp',
+            control: 'boolean',
+        },
+    },
+    args: { initialStepName: Object.keys(fixtures)[1], revampEnabled: false },
+    parameters: {
+        chromatic: { disableSnapshot: true },
+    },
+};
+export default meta;

package/build/stories/DynamicFragment.story.js

@@ -0,0 +1,132 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/* eslint-disable no-nested-ternary */
+import { action } from '@storybook/addon-actions';
+import { Button } from '@transferwise/components';
+import { useRef, useState } from 'react';
+import { DynamicFragment } from '..';
+import { fixtureHttpClient } from './utils/fixtureHttpClient';
+var step = {
+    id: 'dynamic-fragment-story',
+    title: 'Dynamic Fragment',
+    schemas: [
+        {
+            $id: '#form',
+            type: 'object',
+            displayOrder: ['name', 'city'],
+            required: ['name'],
+            properties: {
+                name: { type: 'string', title: 'Name', minLength: 2 },
+                city: {
+                    title: 'City',
+                    oneOf: [
+                        { title: 'London', const: 'London', icon: { name: 'flag-gb' } },
+                        { title: 'Paris', const: 'Paris', icon: { name: 'flag-fr' } },
+                        { title: 'New York', const: 'New York', icon: { name: 'flag-us' } },
+                    ],
+                },
+            },
+        },
+    ],
+    layout: [
+        {
+            type: 'form',
+            schemaId: '#form',
+        },
+    ],
+};
+function DynamicFragmentStory() {
+    var _this = this;
+    var ref = useRef(null);
+    var props = {
+        flowId: 'storybook',
+        analyticsId: 'storybook',
+        customFetch: fixtureHttpClient,
+        onCompletion: action('onCompletion'),
+        onValueChange: action('onValueChange'),
+        onError: action('onError'),
+        onEvent: action('onEvent'),
+        onLog: action('onLog'),
+    };
+    var _a = useState(''), currentValue = _a[0], setCurrentValue = _a[1];
+    var _b = useState(null), isValid = _b[0], setValid = _b[1];
+    var backgroundColor = isValid === null ? '#eeeeee' : isValid ? '#eeffee' : '#ffeeee';
+    var validityText = isValid === null ? '' : isValid ? '✅ valid\n\n' : '❌ invalid\n\n';
+    return (_jsxs(_Fragment, { children: [_jsx(DynamicFragment, __assign({ ref: ref }, props, { initialStep: step, onValueChange: function () { return __awaiter(_this, void 0, void 0, function () {
+                    var newValue;
+                    var _a, _b;
+                    return __generator(this, function (_c) {
+                        switch (_c.label) {
+                            case 0: return [4 /*yield*/, ((_a = ref.current) === null || _a === void 0 ? void 0 : _a.getValue())];
+                            case 1:
+                                newValue = (_b = (_c.sent())) !== null && _b !== void 0 ? _b : null;
+                                setCurrentValue(JSON.stringify(newValue, null, 2));
+                                return [2 /*return*/];
+                        }
+                    });
+                }); } }), JSON.stringify(step)), _jsx(Button, { onClick: function () { return __awaiter(_this, void 0, void 0, function () {
+                    var ok;
+                    var _a, _b;
+                    return __generator(this, function (_c) {
+                        ok = (_b = (_a = ref.current) === null || _a === void 0 ? void 0 : _a.validate()) !== null && _b !== void 0 ? _b : false;
+                        setValid(ok);
+                        return [2 /*return*/];
+                    });
+                }); }, children: "validate()" }), _jsx("hr", {}), _jsxs("pre", { style: { backgroundColor: backgroundColor }, children: [validityText, currentValue] })] }));
+}
+var meta = {
+    title: 'Dynamic Fragment',
+    component: DynamicFragmentStory,
+};
+export var AllFixtures = {
+    parameters: {
+        chromatic: { disableSnapshot: true },
+    },
+};
+export default meta;

package/build/stories/Editable.story.js

@@ -0,0 +1,70 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/* eslint-disable react/forbid-dom-props */
+import { layouts, schemas, examples, features } from '@wise/dynamic-flow-fixtures';
+import { useMemo, useState } from 'react';
+import DynamicFlowSideBySide from './utils/DynamicFlowSideBySide';
+var fixtures = __assign(__assign(__assign(__assign({}, features), schemas), layouts), examples);
+export function Editable(_a) {
+    var _b = _a.initialStepName, initialStepName = _b === void 0 ? '' : _b;
+    var selectedStep = fixtures[initialStepName] || {};
+    var selectedInitialStep = JSON.stringify(selectedStep, null, 2);
+    return _jsx(InteractiveDemo, { selectedInitialStep: selectedInitialStep }, selectedInitialStep);
+}
+function InteractiveDemo(_a) {
+    var selectedInitialStep = _a.selectedInitialStep;
+    var _b = useState(200), initialStatusCode = _b[0], setInitialStatusCode = _b[1];
+    var _c = useState(selectedInitialStep), initialStep = _c[0], setInitialStep = _c[1];
+    var onTextAreaChange = function (event) {
+        setInitialStep(event.target.value);
+    };
+    return (_jsxs(_Fragment, { children: [_jsxs("div", { children: [_jsx("h3", { children: "Editable Demo" }), _jsx("p", { children: "You can specify a response status code and body, and DF will load your step below." }), _jsxs("fieldset", { children: [_jsx("label", { htmlFor: "status-code", children: "Response Status code: " }), _jsx(StatusCodeSelect, { id: "status-code", state: [initialStatusCode, setInitialStatusCode] })] }), _jsxs("fieldset", { children: [_jsx("label", { htmlFor: "textarea", children: "Response Body:" }), _jsx(InvalidJsonWarning, { initialStep: initialStep }), _jsx("textarea", { id: "textarea", wrap: "off", rows: 40, style: {
+                                    fontFamily: 'monospace',
+                                    fontSize: '0.9em',
+                                    width: '100%',
+                                    maxHeight: '200px',
+                                }, value: initialStep, onChange: onTextAreaChange })] })] }), isValidJson(initialStep) ? (_jsx(DynamicFlowSideBySide, { initialStep: JSON.parse(initialStep) }, "".concat(initialStep, "-").concat(initialStatusCode))) : null] }));
+}
+function InvalidJsonWarning(_a) {
+    var initialStep = _a.initialStep;
+    var validJson = useMemo(function () { return isValidJson(initialStep); }, [initialStep]);
+    return !validJson ? (_jsx("p", { children: "\u274C Invalid syntax or missing elements are preventing the JSON code you entered from being parsed." })) : null;
+}
+var isValidJson = function (value) {
+    try {
+        JSON.parse(value);
+        return true;
+    }
+    catch (_a) {
+        return false;
+    }
+};
+function StatusCodeSelect(_a) {
+    var id = _a.id, _b = _a.state, value = _b[0], setValue = _b[1];
+    return (_jsxs("select", { id: id, value: value, onChange: function (event) { return setValue(Number.parseInt(event.target.value, 10)); }, children: [_jsx("option", { children: "200" }), _jsx("option", { children: "400" }), _jsx("option", { children: "500" })] }));
+}
+export default {
+    component: Editable,
+    title: 'Multi-fixture',
+    parameters: {
+        chromatic: { disableSnapshot: true },
+    },
+    argTypes: {
+        initialStepName: {
+            label: 'Initial Step',
+            control: 'select',
+            options: Object.keys(fixtures),
+        },
+    },
+    args: { initialStepName: Object.keys(fixtures)[0] },
+};

package/build/stories/Examples.story.js

@@ -0,0 +1,20 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { storiesOf } from '@storybook/react';
+import { examples } from '@wise/dynamic-flow-fixtures';
+import DynamicFlowSideBySide from './utils/DynamicFlowSideBySide';
+import { getObjectKeys } from './utils/fixtureHttpClient';
+var storyMap = {};
+var allStepNames = getObjectKeys(examples);
+allStepNames.forEach(function (stepName) {
+    // eslint-disable-next-line import/namespace
+    var label = examples[stepName].id;
+    if (label) {
+        var _a = label.split('/'), group = _a[0], name_1 = _a[1];
+        storyMap[group] || (storyMap[group] = storiesOf("Examples/".concat(group), module).addParameters({
+            chromatic: { disableSnapshot: true },
+        }));
+        storyMap[group].add(name_1, function () { return (
+        // eslint-disable-next-line import/namespace
+        _jsx(DynamicFlowSideBySide, { initialStep: examples[stepName] }, stepName)); });
+    }
+});

package/build/stories/Features.story.js

@@ -0,0 +1,27 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { storiesOf } from '@storybook/react';
+import { features } from '@wise/dynamic-flow-fixtures';
+import DynamicFlowSideBySide from './utils/DynamicFlowSideBySide';
+var storyMap = {};
+var selectedStepNames = [
+    'actionResponse',
+    'arrayUploadBase64',
+    'external',
+    'persistAsync',
+    'polling',
+    'search',
+    'modal',
+];
+selectedStepNames.forEach(function (stepName) {
+    // eslint-disable-next-line import/namespace
+    var label = features[stepName].id;
+    if (label) {
+        var _a = label.split('/'), group = _a[0], name_1 = _a[1];
+        storyMap[group] || (storyMap[group] = storiesOf("Examples/".concat(group), module).addParameters({
+            chromatic: { disableSnapshot: true },
+        }));
+        storyMap[group].add(name_1, function () { return (
+        // eslint-disable-next-line import/namespace
+        _jsx(DynamicFlowSideBySide, { initialStep: features[stepName] }, stepName)); });
+    }
+});

package/build/stories/VisualTests.story.js

@@ -0,0 +1,39 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+import { jsx as _jsx } from "react/jsx-runtime";
+import { action } from '@storybook/addon-actions';
+import { storiesOf } from '@storybook/react';
+import { step, layouts, schemas, generatedJson as generatedFixtures, } from '@wise/dynamic-flow-fixtures';
+import { getObjectKeys } from './utils/fixtureHttpClient';
+import DynamicFlowSideBySide from './utils/DynamicFlowSideBySide';
+var fixtures = __assign(__assign(__assign({}, step), layouts), schemas);
+var storyMap = {};
+var allStepNames = getObjectKeys(fixtures);
+allStepNames.forEach(function (stepName) {
+    var label = fixtures[stepName].id;
+    if (label) {
+        var _a = label.split('/'), group = _a[0], name_1 = _a[1];
+        storyMap[group] || (storyMap[group] = storiesOf("Visual Tests/".concat(group), module));
+        storyMap[group].add(name_1, function () { return (_jsx(DynamicFlowSideBySide, { initialStep: fixtures[stepName] }, stepName)); });
+    }
+});
+storyMap.generated || (storyMap.generated = storiesOf("Visual Tests/Generated", module));
+Object.keys(generatedFixtures).forEach(function (fixtureName) {
+    var _a;
+    var initialStep = JSON.parse(
+    // eslint-disable-next-line import/namespace
+    generatedFixtures[fixtureName]);
+    (_a = storyMap.generated) === null || _a === void 0 ? void 0 : _a.add(initialStep.id ? initialStep.id.replaceAll(/([A-Z])/g, ' $1').trim() : 'Invalid id', function () {
+        action('Render Step')(initialStep);
+        return _jsx(DynamicFlowSideBySide, { initialStep: initialStep }, fixtureName);
+    });
+});

package/build/stories/utils/DynamicFlowSideBySide.js

@@ -0,0 +1,30 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { action } from '@storybook/addon-actions';
+import { DynamicFlowRevamp } from '../../dynamicFlow/DynamicFlow';
+import { fixtureHttpClient } from './fixtureHttpClient';
+import { DynamicFlowLegacy } from '../..';
+function DynamicFlowSideBySide(_a) {
+    var key = _a.key, initialStep = _a.initialStep;
+    var props = {
+        flowId: 'storybook',
+        customFetch: fixtureHttpClient,
+        features: [],
+        onCompletion: action('onCompletion'),
+        onError: action('onError'),
+        onEvent: action('onEvent'),
+        onLog: action('onLog'),
+    };
+    return (_jsxs("div", { className: "df-side-by-side-container", children: [_jsx("div", { className: "df-side-by-side-column", children: _jsx(DynamicFlowLegacy, __assign({}, props, { loaderConfig: { size: 'xl', initial: true, submission: false }, initialStep: initialStep }), "".concat(key, "-original")) }), _jsx("div", { className: "df-side-by-side-column", children: _jsx(DynamicFlowRevamp, __assign({}, props, { initialStep: initialStep }), "".concat(key, "-revamp")) })] }));
+}
+export default DynamicFlowSideBySide;

package/build/stories/utils/fixtureHttpClient.js

@@ -0,0 +1,119 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+import { action } from '@storybook/addon-actions';
+import { layouts, features, examples, schemas, responses } from '@wise/dynamic-flow-fixtures';
+export var getObjectKeys = Object.keys;
+var fixtures = __assign(__assign(__assign(__assign({}, examples), schemas), layouts), features);
+var isObject = function (val) {
+    return typeof val === 'object' && val !== null;
+};
+export var fixtureHttpClient = function (input, init) { return __awaiter(void 0, void 0, void 0, function () {
+    var url;
+    return __generator(this, function (_a) {
+        action('httpClient')(input, init);
+        url = getURL(input);
+        if (url.pathname.startsWith('/steps/')) {
+            return [2 /*return*/, respondWithFixture(fixtures, url, init)];
+        }
+        if (url.pathname.startsWith('/responses/')) {
+            return [2 /*return*/, respondWithFixture(responses, url, init)];
+        }
+        if (url.pathname.startsWith('/validate')) {
+            return [2 /*return*/, new Response(JSON.stringify({ message: 'Validation-async OK' }))];
+        }
+        return [2 /*return*/, new Response(null, { status: 404 })];
+    });
+}); };
+var getURL = function (input) {
+    if (input instanceof URL) {
+        return input;
+    }
+    if (input instanceof Request) {
+        return new URL(input.url, 'http://foo');
+    }
+    return new URL(input, 'http://foo');
+};
+var respondWithFixture = function (fixtureList, url, init) { return __awaiter(void 0, void 0, void 0, function () {
+    var fixtureNames, name, fixture, body;
+    var _a;
+    return __generator(this, function (_b) {
+        switch (_b.label) {
+            case 0:
+                fixtureNames = getObjectKeys(fixtureList);
+                name = url.pathname
+                    .split('/')
+                    .filter(function (part) { return Boolean(part); })
+                    .pop();
+                if (!fixtureNames.includes(name !== null && name !== void 0 ? name : '')) return [3 /*break*/, 3];
+                fixture = fixtureList[name];
+                if (!url.searchParams.has('delay')) return [3 /*break*/, 2];
+                return [4 /*yield*/, new Promise(function (resolve) {
+                        setTimeout(resolve, Number(url.searchParams.get('delay')));
+                    })];
+            case 1:
+                _b.sent();
+                _b.label = 2;
+            case 2:
+                // by convention if the url contains a "refresh"query parameterm we use the payload as model
+                if (url.searchParams.has('refresh') &&
+                    (init === null || init === void 0 ? void 0 : init.body) &&
+                    typeof init.body === 'string' &&
+                    isObject(fixture)) {
+                    body = JSON.parse(init.body);
+                    return [2 /*return*/, new Response(JSON.stringify(__assign(__assign({}, fixture), { model: __assign(__assign({}, ((_a = fixture.model) !== null && _a !== void 0 ? _a : {})), body) })))];
+                }
+                if (url.pathname.includes('exit')) {
+                    return [2 /*return*/, new Response(JSON.stringify(fixture), { headers: { 'X-DF-Exit': 'true' } })];
+                }
+                return [2 /*return*/, new Response(JSON.stringify(fixture))];
+            case 3:
+                action('ERROR 404')(url);
+                return [2 /*return*/, new Response(null, { status: 404 })];
+        }
+    });
+}); };

package/build/test-utils/NeptuneProviders.js

@@ -0,0 +1,23 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Provider as ComponentProvider, DEFAULT_LANG, DEFAULT_LOCALE, SnackbarProvider, translations as componentTranslations, getLangFromLocale, } from '@transferwise/components';
+import { ThemeProvider } from '@wise/components-theming';
+import { translations } from '@wise/dynamic-flow-client';
+var locale = DEFAULT_LOCALE;
+var lang = getLangFromLocale(locale) || DEFAULT_LANG;
+var messages = __assign(__assign({}, componentTranslations[lang]), translations[lang]);
+function NeptuneProviders(_a) {
+    var children = _a.children;
+    return (_jsx(ThemeProvider, { theme: "personal", screenMode: "light", children: _jsx(SnackbarProvider, { children: _jsx(ComponentProvider, { i18n: { locale: locale, messages: messages }, children: children }) }) }));
+}
+export default NeptuneProviders;

package/build/test-utils/rtl-utils.js

@@ -0,0 +1,20 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+import { jsx as _jsx } from "react/jsx-runtime";
+import { render } from '@testing-library/react';
+import NeptuneProviders from './NeptuneProviders';
+export var renderWithProviders = function (children, options) {
+    var renderedResult = render(_jsx(NeptuneProviders, { children: children }), options);
+    return __assign(__assign({}, renderedResult), { rerender: function (ui, renderOptions) {
+            return renderWithProviders(ui, __assign({ container: renderedResult.container }, renderOptions));
+        } });
+};

package/build/types/dynamicFlow/DynamicFlow.d.ts

@@ -1,5 +1,5 @@
 /// <reference types="react" />
-import { type DynamicFlowProps as DynamicFlowCoreLegacyProps, type DynamicFlowRevampProps as DynamicFlowCoreRevampProps, type DynamicFlowRevampPropsWithInitialAction, type DynamicFlowRevampPropsWithInitialStep } from '@wise/dynamic-flow-client';
+import { type DynamicFlowProps as DynamicFlowCoreLegacyProps, type DynamicFlowRevampProps as DynamicFlowCoreRevampProps, type DynamicFlowRevampPropsWithInitialAction, type DynamicFlowRevampPropsWithInitialStep, type DynamicFragmentController } from '@wise/dynamic-flow-client';
 import type { DynamicFlowPropsWithInitialAction, DynamicFlowPropsWithInitialStep } from '@wise/dynamic-flow-client/build/types/legacy/dynamic-flow-types';
 export type DynamicFlowLegacyProps = (Omit<DynamicFlowPropsWithInitialAction, 'httpClient'> | Omit<DynamicFlowPropsWithInitialStep, 'httpClient'>) & {
     customFetch?: DynamicFlowCoreLegacyProps['httpClient'];
@@ -9,3 +9,11 @@ export type DynamicFlowRevampProps = (Omit<DynamicFlowRevampPropsWithInitialActi
 };
 export declare function DynamicFlowLegacy(props: DynamicFlowLegacyProps): JSX.Element;
 export declare function DynamicFlowRevamp(props: DynamicFlowRevampProps): JSX.Element;
+/**
+ * DynamicFragment is like DynamicFlowRevamp, but it also accepts a ForwardedRef.
+ * This ref conforms to the DynamicFragmentController type, containing two functions: `getValue` and `validate`.
+ * @experimental This component may be changed in the future without notice.
+ */
+export declare const DynamicFragment: import("react").ForwardRefExoticComponent<(DynamicFlowRevampProps & {
+    onValueChange?: (() => void) | undefined;
+}) & import("react").RefAttributes<DynamicFragmentController>>;

package/build/types/index.d.ts

@@ -1,5 +1,5 @@
-export type { DynamicFlowProps, Step, InitialAction } from '@wise/dynamic-flow-client';
+export type { DynamicFlowProps, Step, InitialAction, DynamicFragmentController, } from '@wise/dynamic-flow-client';
 export { translations, JsonSchemaForm, isValidSchema } from '@wise/dynamic-flow-client';
 export type { DynamicFlowLegacyProps as WiseDynamicFlowProps, DynamicFlowLegacyProps, DynamicFlowRevampProps, } from './dynamicFlow/DynamicFlow';
-export { DynamicFlowLegacy as DynamicFlow, DynamicFlowLegacy, DynamicFlowRevamp, } from './dynamicFlow/DynamicFlow';
+export { DynamicFlowLegacy as DynamicFlow, DynamicFlowLegacy, DynamicFlowRevamp, DynamicFragment, } from './dynamicFlow/DynamicFlow';
 export declare const makeCustomFetch: (baseUrl: string, additionalHeaders?: HeadersInit | undefined) => typeof fetch;

package/build/types/stories/DynamicFragment.story.d.ts

@@ -0,0 +1,6 @@
+/// <reference types="react" />
+import type { Meta, StoryObj } from '@storybook/react';
+declare function DynamicFragmentStory(): JSX.Element;
+declare const meta: Meta<typeof DynamicFragmentStory>;
+export declare const AllFixtures: StoryObj<typeof DynamicFragmentStory>;
+export default meta;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wise/dynamic-flow-client-internal",
-  "version": "3.8.0",
+  "version": "3.9.0-experimental-90bdf26",
   "description": "Dynamic Flow web client for Wise",
   "license": "Apache-2.0",
   "main": "./build/main.min.js",
@@ -72,7 +72,8 @@
     "stylelint-value-no-unknown-custom-properties": "6.0.1",
     "typescript": "5.1.6",
     "webpack": "5.91.0",
-    "@wise/dynamic-flow-fixtures": "0.0.1"
+    "@wise/dynamic-flow-fixtures": "0.0.1",
+    "@wise/dynamic-flow-types": "2.14.0"
   },
   "peerDependencies": {
     "react": "^18",
@@ -80,7 +81,7 @@
     "react-intl": "^6"
   },
   "dependencies": {
-    "@wise/dynamic-flow-client": "3.8.0"
+    "@wise/dynamic-flow-client": "3.9.0-experimental-90bdf26"
   },
   "scripts": {
     "dev": "storybook dev -p 3005",