@velion-la/onboarding-sdk-react-native 1.0.0-beta.2

package/lib/module/ui/VelionOnboardingScreen.js

@@ -0,0 +1,212 @@
+"use strict";
+
+/**
+ * @fileoverview Top-level React component the host app mounts.
+ *
+ * Owns the `VelionOnboarding` instance lifecycle, mounts the `ThemeProvider`,
+ * and renders the orchestrator's view bridge: a sticky `ProgressBar`, the
+ * active step's React node, and (when a step is between transitions or the
+ * flow finishes) a themed `LoadingOverlay` / final-result message.
+ */
+
+import React, { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { StyleSheet, Text, View } from 'react-native';
+import { VelionOnboarding } from '../core/VelionOnboarding';
+import { ThemeProvider, useTheme } from './theme';
+import { LoadingOverlay } from './overlays/LoadingOverlay';
+import { PROGRESS_BAR, ProgressBar } from './overlays/ProgressBar';
+import { getStrings } from '../i18n';
+import { activateScreenKeepAwake, deactivateScreenKeepAwake } from '../utils/keepAwake';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+const INITIAL_STATE = {
+  loading: null,
+  stepNode: null,
+  error: null,
+  result: null
+};
+export function VelionOnboardingScreen({
+  config,
+  onComplete,
+  onFail
+}) {
+  return /*#__PURE__*/_jsx(ThemeProvider, {
+    themeOverrides: config.theme,
+    colorMode: config.colorMode ?? 'auto',
+    children: /*#__PURE__*/_jsx(VelionOnboardingInner, {
+      config: config,
+      onComplete: onComplete,
+      onFail: onFail
+    })
+  });
+}
+function VelionOnboardingInner({
+  config,
+  onComplete,
+  onFail
+}) {
+  const theme = useTheme();
+  const t = getStrings(config.locale);
+  const [state, setState] = useState(INITIAL_STATE);
+  const [progress, setProgress] = useState(0);
+  const [progressHidden, setProgressHidden] = useState(false);
+  const sdk = useMemo(() => new VelionOnboarding(config),
+  // Recreate the SDK only when the session changes — host must keep
+  // callbacks stable (or wrap them in refs).
+  // eslint-disable-next-line react-hooks/exhaustive-deps
+  [config.sessionId, config.apiUrl]);
+  const sdkRef = useRef(sdk);
+  sdkRef.current = sdk;
+  const onCompleteRef = useRef(onComplete);
+  const onFailRef = useRef(onFail);
+  onCompleteRef.current = onComplete;
+  onFailRef.current = onFail;
+  useEffect(() => {
+    // Hold a wake lock for the full duration of the flow. Camera-heavy steps
+    // (LIVENESS_MATCH, DOCUMENTS_OCR) involve the user holding still, so the
+    // OS screen-timeout would otherwise dim and lock the device mid-session.
+    activateScreenKeepAwake();
+    sdk.attachView({
+      setLoading: text => setState(s => ({
+        ...s,
+        loading: text
+      })),
+      setStepNode: node => setState(s => ({
+        ...s,
+        stepNode: node
+      })),
+      setError: err => {
+        setState(s => ({
+          ...s,
+          error: err,
+          loading: null,
+          stepNode: null
+        }));
+        setProgressHidden(true);
+        onFailRef.current?.(err);
+      },
+      setResult: result => {
+        setState(s => ({
+          ...s,
+          result,
+          loading: null,
+          stepNode: null
+        }));
+        setProgress(PROGRESS_BAR.complete());
+        // Fade after a small delay so the "100%" jump is visible.
+        setTimeout(() => setProgressHidden(true), 400);
+        onCompleteRef.current?.(result);
+      }
+    });
+    const unsubStepChange = sdk.on('step:change', () => {
+      setProgress(curr => PROGRESS_BAR.tick(curr));
+    });
+    void sdk.start();
+    return () => {
+      unsubStepChange();
+      sdk.detachView();
+      sdk.destroy();
+      deactivateScreenKeepAwake();
+    };
+  }, [sdk]);
+  const renderBody = useCallback(() => {
+    if (state.error) {
+      return /*#__PURE__*/_jsxs(View, {
+        style: styles.message,
+        children: [/*#__PURE__*/_jsx(Text, {
+          style: [styles.title, {
+            color: theme.errorColor
+          }],
+          children: state.error.declineTitle ?? t.result.declineHeadline
+        }), /*#__PURE__*/_jsx(Text, {
+          style: [styles.body, {
+            color: theme.textColor
+          }],
+          children: state.error.declineMessage ?? state.error.message
+        })]
+      });
+    }
+    if (state.result) {
+      const status = state.result.status;
+      let title = t.result.approvedTitle;
+      let body = t.result.approvedBody;
+      if (status === 'MANUAL_REVIEW') {
+        title = t.result.manualReviewTitle;
+        body = t.result.manualReviewBody;
+      } else if (status === 'REJECTED' || status === 'DECLINED') {
+        title = t.result.rejectedTitle;
+        body = t.result.rejectedBody;
+      }
+      return /*#__PURE__*/_jsxs(View, {
+        style: styles.message,
+        children: [/*#__PURE__*/_jsx(Text, {
+          style: [styles.title, {
+            color: theme.textColor
+          }],
+          children: title
+        }), /*#__PURE__*/_jsx(Text, {
+          style: [styles.body, {
+            color: theme.textSecondaryColor
+          }],
+          children: body
+        })]
+      });
+    }
+    if (state.stepNode) {
+      return state.stepNode;
+    }
+    return null;
+  }, [state, theme, t]);
+  const showLoadingOverlay = !state.error && !state.result && !state.stepNode;
+  const loadingText = state.loading ?? t.common.loading;
+  // Progress bar is shown unless EITHER `config.showProgressBar === false`
+  // OR `theme.hideProgressBar === true`. Both paths exist for parity with
+  // `hideStepIcons` (theme-side) and for hosts that already wire the
+  // legacy `showProgressBar` flag (config-side).
+  const showProgress = config.showProgressBar !== false && !theme.hideProgressBar;
+  return /*#__PURE__*/_jsxs(View, {
+    style: [styles.root, {
+      backgroundColor: theme.backgroundColor
+    }],
+    children: [showProgress ? /*#__PURE__*/_jsx(ProgressBar, {
+      value: progress,
+      hidden: progressHidden
+    }) : null, /*#__PURE__*/_jsx(View, {
+      style: styles.content,
+      children: renderBody()
+    }), showLoadingOverlay ? /*#__PURE__*/_jsx(LoadingOverlay, {
+      message: loadingText
+    }) : null]
+  });
+}
+const styles = StyleSheet.create({
+  root: {
+    flex: 1
+  },
+  content: {
+    flex: 1,
+    overflow: 'hidden'
+  },
+  message: {
+    flex: 1,
+    alignItems: 'center',
+    justifyContent: 'center',
+    paddingHorizontal: 24,
+    gap: 12
+  },
+  title: {
+    fontSize: 20,
+    fontWeight: '600',
+    textAlign: 'center'
+  },
+  body: {
+    fontSize: 15,
+    lineHeight: 22,
+    textAlign: 'center',
+    maxWidth: 360
+  }
+});
+
+// Type tag used so consumers can identify the step that triggered an event.
+// Currently unused but kept here so future adapters (e.g. analytics wrappers)
+// can hook into orchestrator events without re-exporting types.
+//# sourceMappingURL=VelionOnboardingScreen.js.map

package/lib/module/ui/VelionOnboardingScreen.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","useCallback","useEffect","useMemo","useRef","useState","StyleSheet","Text","View","VelionOnboarding","ThemeProvider","useTheme","LoadingOverlay","PROGRESS_BAR","ProgressBar","getStrings","activateScreenKeepAwake","deactivateScreenKeepAwake","jsx","_jsx","jsxs","_jsxs","INITIAL_STATE","loading","stepNode","error","result","VelionOnboardingScreen","config","onComplete","onFail","themeOverrides","theme","colorMode","children","VelionOnboardingInner","t","locale","state","setState","progress","setProgress","progressHidden","setProgressHidden","sdk","sessionId","apiUrl","sdkRef","current","onCompleteRef","onFailRef","attachView","setLoading","text","s","setStepNode","node","setError","err","setResult","complete","setTimeout","unsubStepChange","on","curr","tick","start","detachView","destroy","renderBody","style","styles","message","title","color","errorColor","declineTitle","declineHeadline","body","textColor","declineMessage","status","approvedTitle","approvedBody","manualReviewTitle","manualReviewBody","rejectedTitle","rejectedBody","textSecondaryColor","showLoadingOverlay","loadingText","common","showProgress","showProgressBar","hideProgressBar","root","backgroundColor","value","hidden","content","create","flex","overflow","alignItems","justifyContent","paddingHorizontal","gap","fontSize","fontWeight","textAlign","lineHeight","maxWidth"],"sourceRoot":"../../../src","sources":["ui/VelionOnboardingScreen.tsx"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAOA,KAAK,IACVC,WAAW,EACXC,SAAS,EACTC,OAAO,EACPC,MAAM,EACNC,QAAQ,QAEH,OAAO;AACd,SAASC,UAAU,EAAEC,IAAI,EAAEC,IAAI,QAAQ,cAAc;AACrD,SAASC,gBAAgB,QAA2B,0BAA0B;AAE9E,SAASC,aAAa,EAAEC,QAAQ,QAAQ,SAAS;AACjD,SAASC,cAAc,QAAQ,2BAA2B;AAC1D,SAASC,YAAY,EAAEC,WAAW,QAAQ,wBAAwB;AAClE,SAASC,UAAU,QAAQ,SAAS;AACpC,SACEC,uBAAuB,EACvBC,yBAAyB,QACpB,oBAAoB;AAAC,SAAAC,GAAA,IAAAC,IAAA,EAAAC,IAAA,IAAAC,KAAA;AAe5B,MAAMC,aAAwB,GAAG;EAC/BC,OAAO,EAAE,IAAI;EACbC,QAAQ,EAAE,IAAI;EACdC,KAAK,EAAE,IAAI;EACXC,MAAM,EAAE;AACV,CAAC;AAED,OAAO,SAASC,sBAAsBA,CAAC;EACrCC,MAAM;EACNC,UAAU;EACVC;AAC2B,CAAC,EAAE;EAC9B,oBACEX,IAAA,CAACT,aAAa;IACZqB,cAAc,EAAEH,MAAM,CAACI,KAAM;IAC7BC,SAAS,EAAEL,MAAM,CAACK,SAAS,IAAI,MAAO;IAAAC,QAAA,eAEtCf,IAAA,CAACgB,qBAAqB;MACpBP,MAAM,EAAEA,MAAO;MACfC,UAAU,EAAEA,UAAW;MACvBC,MAAM,EAAEA;IAAO,CAChB;EAAC,CACW,CAAC;AAEpB;AAEA,SAASK,qBAAqBA,CAAC;EAC7BP,MAAM;EACNC,UAAU;EACVC;AAC2B,CAAC,EAAE;EAC9B,MAAME,KAAK,GAAGrB,QAAQ,CAAC,CAAC;EACxB,MAAMyB,CAAC,GAAGrB,UAAU,CAACa,MAAM,CAACS,MAAM,CAAC;EACnC,MAAM,CAACC,KAAK,EAAEC,QAAQ,CAAC,GAAGlC,QAAQ,CAAYiB,aAAa,CAAC;EAC5D,MAAM,CAACkB,QAAQ,EAAEC,WAAW,CAAC,GAAGpC,QAAQ,CAAC,CAAC,CAAC;EAC3C,MAAM,CAACqC,cAAc,EAAEC,iBAAiB,CAAC,GAAGtC,QAAQ,CAAC,KAAK,CAAC;EAE3D,MAAMuC,GAAG,GAAGzC,OAAO,CACjB,MAAM,IAAIM,gBAAgB,CAACmB,MAAM,CAAC;EAClC;EACA;EACA;EACA,CAACA,MAAM,CAACiB,SAAS,EAAEjB,MAAM,CAACkB,MAAM,CAClC,CAAC;EACD,MAAMC,MAAM,GAAG3C,MAAM,CAACwC,GAAG,CAAC;EAC1BG,MAAM,CAACC,OAAO,GAAGJ,GAAG;EAEpB,MAAMK,aAAa,GAAG7C,MAAM,CAACyB,UAAU,CAAC;EACxC,MAAMqB,SAAS,GAAG9C,MAAM,CAAC0B,MAAM,CAAC;EAChCmB,aAAa,CAACD,OAAO,GAAGnB,UAAU;EAClCqB,SAAS,CAACF,OAAO,GAAGlB,MAAM;EAE1B5B,SAAS,CAAC,MAAM;IACd;IACA;IACA;IACAc,uBAAuB,CAAC,CAAC;IAEzB4B,GAAG,CAACO,UAAU,CAAC;MACbC,UAAU,EAAGC,IAAI,IAAKd,QAAQ,CAAEe,CAAC,KAAM;QAAE,GAAGA,CAAC;QAAE/B,OAAO,EAAE8B;MAAK,CAAC,CAAC,CAAC;MAChEE,WAAW,EAAGC,IAAI,IAAKjB,QAAQ,CAAEe,CAAC,KAAM;QAAE,GAAGA,CAAC;QAAE9B,QAAQ,EAAEgC;MAAK,CAAC,CAAC,CAAC;MAClEC,QAAQ,EAAGC,GAAG,IAAK;QACjBnB,QAAQ,CAAEe,CAAC,KAAM;UAAE,GAAGA,CAAC;UAAE7B,KAAK,EAAEiC,GAAG;UAAEnC,OAAO,EAAE,IAAI;UAAEC,QAAQ,EAAE;QAAK,CAAC,CAAC,CAAC;QACtEmB,iBAAiB,CAAC,IAAI,CAAC;QACvBO,SAAS,CAACF,OAAO,GAAGU,GAAG,CAAC;MAC1B,CAAC;MACDC,SAAS,EAAGjC,MAAM,IAAK;QACrBa,QAAQ,CAAEe,CAAC,KAAM;UAAE,GAAGA,CAAC;UAAE5B,MAAM;UAAEH,OAAO,EAAE,IAAI;UAAEC,QAAQ,EAAE;QAAK,CAAC,CAAC,CAAC;QAClEiB,WAAW,CAAC5B,YAAY,CAAC+C,QAAQ,CAAC,CAAC,CAAC;QACpC;QACAC,UAAU,CAAC,MAAMlB,iBAAiB,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC;QAC9CM,aAAa,CAACD,OAAO,GAAGtB,MAAM,CAAC;MACjC;IACF,CAAC,CAAC;IAEF,MAAMoC,eAAe,GAAGlB,GAAG,CAACmB,EAAE,CAAC,aAAa,EAAE,MAAM;MAClDtB,WAAW,CAAEuB,IAAI,IAAKnD,YAAY,CAACoD,IAAI,CAACD,IAAI,CAAC,CAAC;IAChD,CAAC,CAAC;IAEF,KAAKpB,GAAG,CAACsB,KAAK,CAAC,CAAC;IAEhB,OAAO,MAAM;MACXJ,eAAe,CAAC,CAAC;MACjBlB,GAAG,CAACuB,UAAU,CAAC,CAAC;MAChBvB,GAAG,CAACwB,OAAO,CAAC,CAAC;MACbnD,yBAAyB,CAAC,CAAC;IAC7B,CAAC;EACH,CAAC,EAAE,CAAC2B,GAAG,CAAC,CAAC;EAET,MAAMyB,UAAU,GAAGpE,WAAW,CAAC,MAAiB;IAC9C,IAAIqC,KAAK,CAACb,KAAK,EAAE;MACf,oBACEJ,KAAA,CAACb,IAAI;QAAC8D,KAAK,EAAEC,MAAM,CAACC,OAAQ;QAAAtC,QAAA,gBAC1Bf,IAAA,CAACZ,IAAI;UAAC+D,KAAK,EAAE,CAACC,MAAM,CAACE,KAAK,EAAE;YAAEC,KAAK,EAAE1C,KAAK,CAAC2C;UAAW,CAAC,CAAE;UAAAzC,QAAA,EACtDI,KAAK,CAACb,KAAK,CAACmD,YAAY,IAAIxC,CAAC,CAACV,MAAM,CAACmD;QAAe,CACjD,CAAC,eACP1D,IAAA,CAACZ,IAAI;UAAC+D,KAAK,EAAE,CAACC,MAAM,CAACO,IAAI,EAAE;YAAEJ,KAAK,EAAE1C,KAAK,CAAC+C;UAAU,CAAC,CAAE;UAAA7C,QAAA,EACpDI,KAAK,CAACb,KAAK,CAACuD,cAAc,IAAI1C,KAAK,CAACb,KAAK,CAAC+C;QAAO,CAC9C,CAAC;MAAA,CACH,CAAC;IAEX;IACA,IAAIlC,KAAK,CAACZ,MAAM,EAAE;MAChB,MAAMuD,MAAM,GAAG3C,KAAK,CAACZ,MAAM,CAACuD,MAAM;MAClC,IAAIR,KAAK,GAAGrC,CAAC,CAACV,MAAM,CAACwD,aAAa;MAClC,IAAIJ,IAAI,GAAG1C,CAAC,CAACV,MAAM,CAACyD,YAAY;MAChC,IAAIF,MAAM,KAAK,eAAe,EAAE;QAC9BR,KAAK,GAAGrC,CAAC,CAACV,MAAM,CAAC0D,iBAAiB;QAClCN,IAAI,GAAG1C,CAAC,CAACV,MAAM,CAAC2D,gBAAgB;MAClC,CAAC,MAAM,IAAIJ,MAAM,KAAK,UAAU,IAAIA,MAAM,KAAK,UAAU,EAAE;QACzDR,KAAK,GAAGrC,CAAC,CAACV,MAAM,CAAC4D,aAAa;QAC9BR,IAAI,GAAG1C,CAAC,CAACV,MAAM,CAAC6D,YAAY;MAC9B;MACA,oBACElE,KAAA,CAACb,IAAI;QAAC8D,KAAK,EAAEC,MAAM,CAACC,OAAQ;QAAAtC,QAAA,gBAC1Bf,IAAA,CAACZ,IAAI;UAAC+D,KAAK,EAAE,CAACC,MAAM,CAACE,KAAK,EAAE;YAAEC,KAAK,EAAE1C,KAAK,CAAC+C;UAAU,CAAC,CAAE;UAAA7C,QAAA,EAAEuC;QAAK,CAAO,CAAC,eACvEtD,IAAA,CAACZ,IAAI;UAAC+D,KAAK,EAAE,CAACC,MAAM,CAACO,IAAI,EAAE;YAAEJ,KAAK,EAAE1C,KAAK,CAACwD;UAAmB,CAAC,CAAE;UAAAtD,QAAA,EAC7D4C;QAAI,CACD,CAAC;MAAA,CACH,CAAC;IAEX;IACA,IAAIxC,KAAK,CAACd,QAAQ,EAAE;MAClB,OAAOc,KAAK,CAACd,QAAQ;IACvB;IACA,OAAO,IAAI;EACb,CAAC,EAAE,CAACc,KAAK,EAAEN,KAAK,EAAEI,CAAC,CAAC,CAAC;EAErB,MAAMqD,kBAAkB,GACtB,CAACnD,KAAK,CAACb,KAAK,IAAI,CAACa,KAAK,CAACZ,MAAM,IAAI,CAACY,KAAK,CAACd,QAAQ;EAClD,MAAMkE,WAAW,GAAGpD,KAAK,CAACf,OAAO,IAAIa,CAAC,CAACuD,MAAM,CAACpE,OAAO;EACrD;EACA;EACA;EACA;EACA,MAAMqE,YAAY,GAChBhE,MAAM,CAACiE,eAAe,KAAK,KAAK,IAAI,CAAC7D,KAAK,CAAC8D,eAAe;EAE5D,oBACEzE,KAAA,CAACb,IAAI;IAAC8D,KAAK,EAAE,CAACC,MAAM,CAACwB,IAAI,EAAE;MAAEC,eAAe,EAAEhE,KAAK,CAACgE;IAAgB,CAAC,CAAE;IAAA9D,QAAA,GACpE0D,YAAY,gBACXzE,IAAA,CAACL,WAAW;MAACmF,KAAK,EAAEzD,QAAS;MAAC0D,MAAM,EAAExD;IAAe,CAAE,CAAC,GACtD,IAAI,eACRvB,IAAA,CAACX,IAAI;MAAC8D,KAAK,EAAEC,MAAM,CAAC4B,OAAQ;MAAAjE,QAAA,EAAEmC,UAAU,CAAC;IAAC,CAAO,CAAC,EACjDoB,kBAAkB,gBAAGtE,IAAA,CAACP,cAAc;MAAC4D,OAAO,EAAEkB;IAAY,CAAE,CAAC,GAAG,IAAI;EAAA,CACjE,CAAC;AAEX;AAEA,MAAMnB,MAAM,GAAGjE,UAAU,CAAC8F,MAAM,CAAC;EAC/BL,IAAI,EAAE;IACJM,IAAI,EAAE;EACR,CAAC;EACDF,OAAO,EAAE;IACPE,IAAI,EAAE,CAAC;IACPC,QAAQ,EAAE;EACZ,CAAC;EACD9B,OAAO,EAAE;IACP6B,IAAI,EAAE,CAAC;IACPE,UAAU,EAAE,QAAQ;IACpBC,cAAc,EAAE,QAAQ;IACxBC,iBAAiB,EAAE,EAAE;IACrBC,GAAG,EAAE;EACP,CAAC;EACDjC,KAAK,EAAE;IACLkC,QAAQ,EAAE,EAAE;IACZC,UAAU,EAAE,KAAK;IACjBC,SAAS,EAAE;EACb,CAAC;EACD/B,IAAI,EAAE;IACJ6B,QAAQ,EAAE,EAAE;IACZG,UAAU,EAAE,EAAE;IACdD,SAAS,EAAE,QAAQ;IACnBE,QAAQ,EAAE;EACZ;AACF,CAAC,CAAC;;AAEF;AACA;AACA","ignoreList":[]}

package/lib/module/ui/forms/index.js

@@ -0,0 +1,5 @@
+"use strict";
+
+export { useInlineValidation } from './useInlineValidation';
+export { required, minLength, pattern, compose } from './validators';
+//# sourceMappingURL=index.js.map

package/lib/module/ui/forms/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useInlineValidation","required","minLength","pattern","compose"],"sourceRoot":"../../../../src","sources":["ui/forms/index.ts"],"mappings":";;AAAA,SACEA,mBAAmB,QAGd,uBAAuB;AAC9B,SACEC,QAAQ,EACRC,SAAS,EACTC,OAAO,EACPC,OAAO,QAEF,cAAc","ignoreList":[]}

package/lib/module/ui/forms/useInlineValidation.js

@@ -0,0 +1,84 @@
+"use strict";
+
+/**
+ * @fileoverview Inline form validation hook.
+ *
+ * Implements the on-blur validation heuristic from Material Design's
+ * `inline-validation` guidelines — error appears on blur (not keystroke),
+ * clears optimistically when the user resumes typing, and re-evaluates on
+ * the next blur. The form's submit handler can call `validateAll()` to gate.
+ *
+ * Returns plain handlers + an errors map that step modules feed into
+ * `<Input errorMessage={…} />` props.
+ */
+
+import { useCallback, useMemo, useRef, useState } from 'react';
+export function useInlineValidation(rules, onChange) {
+  const [errors, setErrors] = useState({});
+  const rulesRef = useRef(rules);
+  rulesRef.current = rules;
+  const validateOne = useCallback((name, value) => {
+    const rule = rulesRef.current.find(r => r.name === name);
+    if (!rule) return null;
+    return rule.validate(value);
+  }, []);
+  const setFieldError = useCallback((name, message) => {
+    setErrors(prev => {
+      if (message) {
+        if (prev[name] === message) return prev;
+        return {
+          ...prev,
+          [name]: message
+        };
+      }
+      if (!(name in prev)) return prev;
+      const next = {
+        ...prev
+      };
+      delete next[name];
+      return next;
+    });
+  }, []);
+  const bind = useCallback((name, value) => ({
+    onBlur: () => {
+      const message = validateOne(name, value);
+      setFieldError(name, message);
+    },
+    onChangeText: text => {
+      onChange?.(name, text);
+      // Optimistic clear while editing — equivalent to the input listener
+      // in the web inlineValidation helper.
+      setErrors(prev => {
+        if (!(name in prev)) return prev;
+        const next = {
+          ...prev
+        };
+        delete next[name];
+        return next;
+      });
+    },
+    errorMessage: errors[name] ?? null
+  }), [errors, onChange, setFieldError, validateOne]);
+  const validateAll = useCallback(values => {
+    const next = {};
+    let allOk = true;
+    for (const rule of rulesRef.current) {
+      const message = rule.validate(values[rule.name] ?? '');
+      if (message) {
+        next[rule.name] = message;
+        allOk = false;
+      }
+    }
+    setErrors(next);
+    return allOk;
+  }, []);
+  const reset = useCallback(() => setErrors({}), []);
+  return useMemo(() => ({
+    errors,
+    bind,
+    validateAll,
+    reset,
+    setFieldError
+  }), [errors, bind, validateAll, reset, setFieldError]);
+}
+//# sourceMappingURL=useInlineValidation.js.map

package/lib/module/ui/forms/useInlineValidation.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useMemo","useRef","useState","useInlineValidation","rules","onChange","errors","setErrors","rulesRef","current","validateOne","name","value","rule","find","r","validate","setFieldError","message","prev","next","bind","onBlur","onChangeText","text","errorMessage","validateAll","values","allOk","reset"],"sourceRoot":"../../../../src","sources":["ui/forms/useInlineValidation.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/ui/forms/validators.js

@@ -0,0 +1,27 @@
+"use strict";
+
+/**
+ * Reusable field validators. Each validator returns either an error message or
+ * `null` when valid — same contract as `InlineFieldRule.validate` in the web
+ * SDK so step authors can move logic between platforms with minimal churn.
+ */
+
+export function required(message) {
+  return value => value.trim().length > 0 ? null : message;
+}
+export function minLength(min, message) {
+  return value => value.trim().length >= min ? null : message;
+}
+export function pattern(regex, message) {
+  return value => regex.test(value) ? null : message;
+}
+export function compose(...validators) {
+  return value => {
+    for (const v of validators) {
+      const msg = v(value);
+      if (msg) return msg;
+    }
+    return null;
+  };
+}
+//# sourceMappingURL=validators.js.map

package/lib/module/ui/forms/validators.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["required","message","value","trim","length","minLength","min","pattern","regex","test","compose","validators","v","msg"],"sourceRoot":"../../../../src","sources":["ui/forms/validators.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;;AAIA,OAAO,SAASA,QAAQA,CAACC,OAAe,EAAkB;EACxD,OAAQC,KAAK,IAAMA,KAAK,CAACC,IAAI,CAAC,CAAC,CAACC,MAAM,GAAG,CAAC,GAAG,IAAI,GAAGH,OAAQ;AAC9D;AAEA,OAAO,SAASI,SAASA,CAACC,GAAW,EAAEL,OAAe,EAAkB;EACtE,OAAQC,KAAK,IAAMA,KAAK,CAACC,IAAI,CAAC,CAAC,CAACC,MAAM,IAAIE,GAAG,GAAG,IAAI,GAAGL,OAAQ;AACjE;AAEA,OAAO,SAASM,OAAOA,CAACC,KAAa,EAAEP,OAAe,EAAkB;EACtE,OAAQC,KAAK,IAAMM,KAAK,CAACC,IAAI,CAACP,KAAK,CAAC,GAAG,IAAI,GAAGD,OAAQ;AACxD;AAEA,OAAO,SAASS,OAAOA,CAAC,GAAGC,UAA4B,EAAkB;EACvE,OAAQT,KAAK,IAAK;IAChB,KAAK,MAAMU,CAAC,IAAID,UAAU,EAAE;MAC1B,MAAME,GAAG,GAAGD,CAAC,CAACV,KAAK,CAAC;MACpB,IAAIW,GAAG,EAAE,OAAOA,GAAG;IACrB;IACA,OAAO,IAAI;EACb,CAAC;AACH","ignoreList":[]}

package/lib/module/ui/icons/HomeHeartIcon.js

@@ -0,0 +1,33 @@
+"use strict";
+
+/**
+ * Custom "home with heart" step icon for the ADDRESS_INFO step.
+ *
+ * Drawn inline with react-native-svg (already in deps for the liveness oval)
+ * so we don't depend on MaterialIcons having an exact match — none of the
+ * Material set bundles a house with a heart inside.
+ */
+
+import Svg, { Path } from 'react-native-svg';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+export function HomeHeartIcon({
+  size = 28,
+  color = '#FFFFFF'
+}) {
+  return /*#__PURE__*/_jsxs(Svg, {
+    width: size,
+    height: size,
+    viewBox: "0 0 24 24",
+    children: [/*#__PURE__*/_jsx(Path, {
+      d: "M3 11.5 L12 3.5 L21 11.5 L21 20.5 A1.5 1.5 0 0 1 19.5 22 L4.5 22 A1.5 1.5 0 0 1 3 20.5 Z",
+      fill: "none",
+      stroke: color,
+      strokeWidth: 1.7,
+      strokeLinejoin: "round"
+    }), /*#__PURE__*/_jsx(Path, {
+      d: "M12 18.2 C 9.4 16.3 7.7 14.7 7.7 13.0 C 7.7 11.7 8.7 10.7 9.9 10.7 C 10.7 10.7 11.5 11.1 12 11.8 C 12.5 11.1 13.3 10.7 14.1 10.7 C 15.3 10.7 16.3 11.7 16.3 13.0 C 16.3 14.7 14.6 16.3 12 18.2 Z",
+      fill: color
+    })]
+  });
+}
+//# sourceMappingURL=HomeHeartIcon.js.map

package/lib/module/ui/icons/HomeHeartIcon.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Svg","Path","jsx","_jsx","jsxs","_jsxs","HomeHeartIcon","size","color","width","height","viewBox","children","d","fill","stroke","strokeWidth","strokeLinejoin"],"sourceRoot":"../../../../src","sources":["ui/icons/HomeHeartIcon.tsx"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAOA,GAAG,IAAIC,IAAI,QAAQ,kBAAkB;AAAC,SAAAC,GAAA,IAAAC,IAAA,EAAAC,IAAA,IAAAC,KAAA;AAO7C,OAAO,SAASC,aAAaA,CAAC;EAAEC,IAAI,GAAG,EAAE;EAAEC,KAAK,GAAG;AAA8B,CAAC,EAAE;EAClF,oBACEH,KAAA,CAACL,GAAG;IAACS,KAAK,EAAEF,IAAK;IAACG,MAAM,EAAEH,IAAK;IAACI,OAAO,EAAC,WAAW;IAAAC,QAAA,gBAEjDT,IAAA,CAACF,IAAI;MACHY,CAAC,EAAC,0FAA0F;MAC5FC,IAAI,EAAC,MAAM;MACXC,MAAM,EAAEP,KAAM;MACdQ,WAAW,EAAE,GAAI;MACjBC,cAAc,EAAC;IAAO,CACvB,CAAC,eAEFd,IAAA,CAACF,IAAI;MACHY,CAAC,EAAC,kMAAkM;MACpMC,IAAI,EAAEN;IAAM,CACb,CAAC;EAAA,CACC,CAAC;AAEV","ignoreList":[]}

package/lib/module/ui/icons/StepIcon.js

@@ -0,0 +1,55 @@
+"use strict";
+
+/**
+ * @fileoverview StepIcon — small wrapper around `MaterialIcons` (shipped with
+ * `@expo/vector-icons`, which Expo SDK 54 includes by default).
+ *
+ * Steps pass an icon by name (e.g. `<StepIcon name="badge" />`) and the
+ * shell renders it inside the colored circle next to the title. When the
+ * library can't be loaded (bare-RN host without `@expo/vector-icons`
+ * installed) we fall back silently to `null` so the circle is empty rather
+ * than crashing — the host can switch off the circle altogether via
+ * `VelionTheme.hideStepIcons`.
+ */
+
+import { Text } from 'react-native';
+import { log } from '../../utils/log';
+import { jsx as _jsx } from "react/jsx-runtime";
+let MaterialIcons = null;
+try {
+  // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires
+  const mod = require('@expo/vector-icons');
+  MaterialIcons = mod.MaterialIcons ?? null;
+} catch {
+  log.warn('[StepIcon] @expo/vector-icons is not installed — step header icons will be hidden. ' + 'Either install it (Expo SDK 54+ ships it by default) or set VelionTheme.hideStepIcons=true.');
+}
+/**
+ * Renders a Material icon centered inside the step's title circle. Returns
+ * `null` when `@expo/vector-icons` is unavailable so the SDK still mounts
+ * gracefully on hosts without it.
+ */
+export function StepIcon({
+  name,
+  size = 28,
+  color = '#FFFFFF'
+}) {
+  if (!MaterialIcons) {
+    // Plain text fallback — keeps the circle from being blank when the
+    // library is missing. Picks a neutral character; not localized.
+    return /*#__PURE__*/_jsx(Text, {
+      style: {
+        color,
+        fontSize: size,
+        fontWeight: '700'
+      },
+      children: "\u2022"
+    });
+  }
+  const Icon = MaterialIcons;
+  return /*#__PURE__*/_jsx(Icon, {
+    name: name,
+    size: size,
+    color: color
+  });
+}
+//# sourceMappingURL=StepIcon.js.map

package/lib/module/ui/icons/StepIcon.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Text","log","jsx","_jsx","MaterialIcons","mod","require","warn","StepIcon","name","size","color","style","fontSize","fontWeight","children","Icon"],"sourceRoot":"../../../../src","sources":["ui/icons/StepIcon.tsx"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA,SAASA,IAAI,QAAQ,cAAc;AACnC,SAASC,GAAG,QAAQ,iBAAiB;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAiBtC,IAAIC,aAOI,GAAG,IAAI;AAEf,IAAI;EACF;EACA,MAAMC,GAAG,GAAGC,OAAO,CAAC,oBAAoB,CAAC;EACzCF,aAAa,GAAGC,GAAG,CAACD,aAAa,IAAI,IAAI;AAC3C,CAAC,CAAC,MAAM;EACNH,GAAG,CAACM,IAAI,CACN,qFAAqF,GACnF,6FACJ,CAAC;AACH;AAUA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,QAAQA,CAAC;EAAEC,IAAI;EAAEC,IAAI,GAAG,EAAE;EAAEC,KAAK,GAAG;AAAyB,CAAC,EAAE;EAC9E,IAAI,CAACP,aAAa,EAAE;IAClB;IACA;IACA,oBAAOD,IAAA,CAACH,IAAI;MAACY,KAAK,EAAE;QAAED,KAAK;QAAEE,QAAQ,EAAEH,IAAI;QAAEI,UAAU,EAAE;MAAM,CAAE;MAAAC,QAAA,EAAC;IAAC,CAAM,CAAC;EAC5E;EACA,MAAMC,IAAI,GAAGZ,aAIK;EAClB,oBAAOD,IAAA,CAACa,IAAI;IAACP,IAAI,EAAEA,IAAK;IAACC,IAAI,EAAEA,IAAK;IAACC,KAAK,EAAEA;EAAM,CAAE,CAAC;AACvD","ignoreList":[]}