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

package/lib/module/ui/primitives/Select.js

@@ -0,0 +1,205 @@
+"use strict";
+
+/**
+ * Lightweight select — uses a modal-anchored option list. Matches the rhythm
+ * of `<Input>` (label, 44 px tap target, error styling) so step forms can mix
+ * the two primitives interchangeably.
+ *
+ * Intentionally simple: no search, no virtualisation. For searchable country
+ * pickers use `CountrySelect`.
+ */
+
+import { useId, useMemo, useState } from 'react';
+import { Modal, Pressable, ScrollView, StyleSheet, Text, View } from 'react-native';
+import { useTheme, withAlpha } from '../theme';
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+export function Select({
+  label,
+  options,
+  value,
+  onChange,
+  placeholder,
+  errorMessage,
+  required,
+  disabled = false,
+  containerStyle
+}) {
+  const theme = useTheme();
+  const errorId = useId();
+  const [open, setOpen] = useState(false);
+  const hasError = Boolean(errorMessage && errorMessage.length > 0);
+  const selected = useMemo(() => options.find(o => o.value === value) ?? null, [options, value]);
+  return /*#__PURE__*/_jsxs(View, {
+    style: [styles.wrap, containerStyle],
+    children: [label ? /*#__PURE__*/_jsxs(Text, {
+      style: [styles.label, {
+        color: theme.textColor
+      }],
+      children: [label, required ? /*#__PURE__*/_jsxs(Text, {
+        style: [styles.required, {
+          color: theme.textSecondaryColor
+        }],
+        children: [' ', "*"]
+      }) : null]
+    }) : null, /*#__PURE__*/_jsxs(Pressable, {
+      accessibilityRole: "combobox",
+      accessibilityState: {
+        disabled,
+        expanded: open
+      },
+      accessibilityLabel: label,
+      disabled: disabled,
+      onPress: () => setOpen(true),
+      style: [styles.trigger, {
+        backgroundColor: theme.backgroundColor,
+        borderColor: hasError ? theme.errorColor : theme.borderColor,
+        borderRadius: theme.borderRadiusPx
+      }, disabled && styles.disabled],
+      children: [/*#__PURE__*/_jsx(Text, {
+        numberOfLines: 1,
+        style: [styles.triggerText, {
+          color: selected ? theme.textColor : theme.textSecondaryColor
+        }],
+        children: selected?.label ?? placeholder ?? ''
+      }), /*#__PURE__*/_jsx(Text, {
+        style: [styles.chevron, {
+          color: theme.textSecondaryColor
+        }],
+        children: "\u25BE"
+      })]
+    }), hasError ? /*#__PURE__*/_jsx(Text, {
+      nativeID: errorId,
+      accessibilityLiveRegion: "polite",
+      style: [styles.error, {
+        color: theme.errorColor
+      }],
+      children: errorMessage
+    }) : null, /*#__PURE__*/_jsx(Modal, {
+      visible: open,
+      transparent: true,
+      animationType: "fade",
+      onRequestClose: () => setOpen(false),
+      children: /*#__PURE__*/_jsx(Pressable, {
+        style: styles.backdrop,
+        onPress: () => setOpen(false),
+        accessibilityLabel: "Close",
+        children: /*#__PURE__*/_jsxs(Pressable, {
+          style: [styles.sheet, {
+            backgroundColor: theme.backgroundColor,
+            borderRadius: theme.borderRadiusPx,
+            borderColor: theme.borderColor
+          }],
+          onPress: () => undefined,
+          children: [label ? /*#__PURE__*/_jsx(Text, {
+            style: [styles.sheetTitle, {
+              color: theme.textColor
+            }],
+            children: label
+          }) : null, /*#__PURE__*/_jsx(ScrollView, {
+            style: styles.sheetList,
+            children: options.map(opt => {
+              const isSelected = opt.value === value;
+              return /*#__PURE__*/_jsx(Pressable, {
+                accessibilityRole: "menuitem",
+                accessibilityState: {
+                  selected: isSelected
+                },
+                onPress: () => {
+                  onChange(opt.value);
+                  setOpen(false);
+                },
+                style: ({
+                  pressed
+                }) => [styles.option, isSelected && {
+                  backgroundColor: withAlpha(theme.primaryColor, 0.12)
+                }, pressed && {
+                  backgroundColor: withAlpha(theme.primaryColor, 0.18)
+                }],
+                children: /*#__PURE__*/_jsx(Text, {
+                  style: [styles.optionText, {
+                    color: isSelected ? theme.primaryColor : theme.textColor,
+                    fontWeight: isSelected ? '600' : '400'
+                  }],
+                  children: opt.label
+                })
+              }, opt.value);
+            })
+          })]
+        })
+      })
+    })]
+  });
+}
+const styles = StyleSheet.create({
+  wrap: {
+    width: '100%',
+    marginBottom: 4
+  },
+  label: {
+    fontSize: 14,
+    fontWeight: '500',
+    marginBottom: 4
+  },
+  required: {
+    fontWeight: '400'
+  },
+  trigger: {
+    minHeight: 44,
+    paddingHorizontal: 12,
+    paddingVertical: 10,
+    borderWidth: 1,
+    flexDirection: 'row',
+    alignItems: 'center',
+    justifyContent: 'space-between'
+  },
+  triggerText: {
+    fontSize: 15,
+    flex: 1
+  },
+  chevron: {
+    fontSize: 14,
+    marginLeft: 8
+  },
+  disabled: {
+    opacity: 0.5
+  },
+  error: {
+    fontSize: 13,
+    marginTop: 4,
+    lineHeight: 18
+  },
+  backdrop: {
+    flex: 1,
+    backgroundColor: 'rgba(0,0,0,0.4)',
+    justifyContent: 'center',
+    alignItems: 'center',
+    padding: 20
+  },
+  sheet: {
+    width: '100%',
+    maxWidth: 420,
+    maxHeight: '70%',
+    borderWidth: 1,
+    paddingTop: 12,
+    paddingBottom: 6
+  },
+  sheetTitle: {
+    fontSize: 16,
+    fontWeight: '600',
+    paddingHorizontal: 16,
+    marginBottom: 8
+  },
+  sheetList: {
+    flexShrink: 1
+  },
+  option: {
+    minHeight: 44,
+    paddingHorizontal: 16,
+    paddingVertical: 12,
+    justifyContent: 'center'
+  },
+  optionText: {
+    fontSize: 15
+  }
+});
+//# sourceMappingURL=Select.js.map

package/lib/module/ui/primitives/Select.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useId","useMemo","useState","Modal","Pressable","ScrollView","StyleSheet","Text","View","useTheme","withAlpha","jsxs","_jsxs","jsx","_jsx","Select","label","options","value","onChange","placeholder","errorMessage","required","disabled","containerStyle","theme","errorId","open","setOpen","hasError","Boolean","length","selected","find","o","style","styles","wrap","children","color","textColor","textSecondaryColor","accessibilityRole","accessibilityState","expanded","accessibilityLabel","onPress","trigger","backgroundColor","borderColor","errorColor","borderRadius","borderRadiusPx","numberOfLines","triggerText","chevron","nativeID","accessibilityLiveRegion","error","visible","transparent","animationType","onRequestClose","backdrop","sheet","undefined","sheetTitle","sheetList","map","opt","isSelected","pressed","option","primaryColor","optionText","fontWeight","create","width","marginBottom","fontSize","minHeight","paddingHorizontal","paddingVertical","borderWidth","flexDirection","alignItems","justifyContent","flex","marginLeft","opacity","marginTop","lineHeight","padding","maxWidth","maxHeight","paddingTop","paddingBottom","flexShrink"],"sourceRoot":"../../../../src","sources":["ui/primitives/Select.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/ui/primitives/Spinner.js

@@ -0,0 +1,21 @@
+"use strict";
+
+/**
+ * Activity spinner that respects reduced-motion. RN ships `ActivityIndicator`
+ * natively which already complies with platform accessibility settings.
+ */
+
+import { ActivityIndicator } from 'react-native';
+import { useTheme } from '../theme';
+import { jsx as _jsx } from "react/jsx-runtime";
+export function Spinner({
+  size = 'large',
+  color
+}) {
+  const theme = useTheme();
+  return /*#__PURE__*/_jsx(ActivityIndicator, {
+    size: size,
+    color: color ?? theme.primaryColor
+  });
+}
+//# sourceMappingURL=Spinner.js.map

package/lib/module/ui/primitives/Spinner.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["ActivityIndicator","useTheme","jsx","_jsx","Spinner","size","color","theme","primaryColor"],"sourceRoot":"../../../../src","sources":["ui/primitives/Spinner.tsx"],"mappings":";;AAAA;AACA;AACA;AACA;;AAEA,SAASA,iBAAiB,QAAQ,cAAc;AAChD,SAASC,QAAQ,QAAQ,UAAU;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAOpC,OAAO,SAASC,OAAOA,CAAC;EAAEC,IAAI,GAAG,OAAO;EAAEC;AAAoB,CAAC,EAAE;EAC/D,MAAMC,KAAK,GAAGN,QAAQ,CAAC,CAAC;EACxB,oBAAOE,IAAA,CAACH,iBAAiB;IAACK,IAAI,EAAEA,IAAK;IAACC,KAAK,EAAEA,KAAK,IAAIC,KAAK,CAACC;EAAa,CAAE,CAAC;AAC9E","ignoreList":[]}

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

@@ -0,0 +1,12 @@
+"use strict";
+
+export { Button } from './Button';
+export { Input } from './Input';
+export { Select } from './Select';
+export { Card } from './Card';
+export { Banner } from './Banner';
+export { Spinner } from './Spinner';
+export { Checkbox } from './Checkbox';
+export { DatePicker } from './DatePicker';
+export { CountrySelect } from './CountrySelect';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["Button","Input","Select","Card","Banner","Spinner","Checkbox","DatePicker","CountrySelect"],"sourceRoot":"../../../../src","sources":["ui/primitives/index.ts"],"mappings":";;AAAA,SAASA,MAAM,QAA8C,UAAU;AACvE,SAASC,KAAK,QAAyB,SAAS;AAChD,SAASC,MAAM,QAA6C,UAAU;AACtE,SAASC,IAAI,QAAwB,QAAQ;AAC7C,SAASC,MAAM,QAA0B,UAAU;AACnD,SAASC,OAAO,QAA2B,WAAW;AACtD,SAASC,QAAQ,QAA4B,YAAY;AACzD,SAASC,UAAU,QAA8B,cAAc;AAC/D,SAASC,aAAa,QAAiC,iBAAiB","ignoreList":[]}

package/lib/module/ui/theme/ThemeProvider.js

@@ -0,0 +1,67 @@
+"use strict";
+
+/**
+ * @fileoverview ThemeProvider + hooks.
+ *
+ * - `ThemeProvider` resolves tokens from `VelionConfig.theme` + colorMode and
+ *   exposes them to descendants.
+ * - `useTheme()` returns the active `ResolvedTheme`.
+ * - `useReducedMotion()` honours the OS-level `prefers-reduced-motion` flag —
+ *   components disable animations when true.
+ */
+
+import React, { createContext, useContext, useEffect, useMemo, useState } from 'react';
+import { AccessibilityInfo, useColorScheme } from 'react-native';
+import { resolveTheme } from './tokens';
+import { jsx as _jsx } from "react/jsx-runtime";
+const ThemeContext = /*#__PURE__*/createContext(null);
+export function ThemeProvider({
+  themeOverrides,
+  colorMode = 'auto',
+  children
+}) {
+  const systemScheme = useColorScheme();
+  const reduceMotion = useReducedMotionInternal();
+  const resolvedMode = useMemo(() => {
+    if (colorMode === 'light' || colorMode === 'dark') return colorMode;
+    return systemScheme === 'dark' ? 'dark' : 'light';
+  }, [colorMode, systemScheme]);
+  const theme = useMemo(() => resolveTheme(themeOverrides, resolvedMode), [themeOverrides, resolvedMode]);
+  const value = useMemo(() => ({
+    theme,
+    reduceMotion
+  }), [theme, reduceMotion]);
+  return /*#__PURE__*/_jsx(ThemeContext.Provider, {
+    value: value,
+    children: children
+  });
+}
+export function useTheme() {
+  const ctx = useContext(ThemeContext);
+  if (!ctx) {
+    throw new Error('useTheme must be used inside <ThemeProvider>. Did you mount <VelionOnboardingScreen> at the root of your screen?');
+  }
+  return ctx.theme;
+}
+export function useReducedMotion() {
+  const ctx = useContext(ThemeContext);
+  return ctx?.reduceMotion ?? false;
+}
+function useReducedMotionInternal() {
+  const [enabled, setEnabled] = useState(false);
+  useEffect(() => {
+    let mounted = true;
+    AccessibilityInfo.isReduceMotionEnabled().then(v => {
+      if (mounted) setEnabled(v);
+    }).catch(() => {
+      // The API is best-effort on every platform; default to false on error.
+    });
+    const sub = AccessibilityInfo.addEventListener('reduceMotionChanged', v => setEnabled(v));
+    return () => {
+      mounted = false;
+      sub.remove();
+    };
+  }, []);
+  return enabled;
+}
+//# sourceMappingURL=ThemeProvider.js.map

package/lib/module/ui/theme/ThemeProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","createContext","useContext","useEffect","useMemo","useState","AccessibilityInfo","useColorScheme","resolveTheme","jsx","_jsx","ThemeContext","ThemeProvider","themeOverrides","colorMode","children","systemScheme","reduceMotion","useReducedMotionInternal","resolvedMode","theme","value","Provider","useTheme","ctx","Error","useReducedMotion","enabled","setEnabled","mounted","isReduceMotionEnabled","then","v","catch","sub","addEventListener","remove"],"sourceRoot":"../../../../src","sources":["ui/theme/ThemeProvider.tsx"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAOA,KAAK,IACVC,aAAa,EACbC,UAAU,EACVC,SAAS,EACTC,OAAO,EACPC,QAAQ,QAEH,OAAO;AACd,SAASC,iBAAiB,EAAEC,cAAc,QAAQ,cAAc;AAEhE,SAASC,YAAY,QAA4B,UAAU;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAO5D,MAAMC,YAAY,gBAAGV,aAAa,CAA2B,IAAI,CAAC;AAUlE,OAAO,SAASW,aAAaA,CAAC;EAC5BC,cAAc;EACdC,SAAS,GAAG,MAAM;EAClBC;AACkB,CAAC,EAAE;EACrB,MAAMC,YAAY,GAAGT,cAAc,CAAC,CAAC;EACrC,MAAMU,YAAY,GAAGC,wBAAwB,CAAC,CAAC;EAE/C,MAAMC,YAA8B,GAAGf,OAAO,CAAC,MAAM;IACnD,IAAIU,SAAS,KAAK,OAAO,IAAIA,SAAS,KAAK,MAAM,EAAE,OAAOA,SAAS;IACnE,OAAOE,YAAY,KAAK,MAAM,GAAG,MAAM,GAAG,OAAO;EACnD,CAAC,EAAE,CAACF,SAAS,EAAEE,YAAY,CAAC,CAAC;EAE7B,MAAMI,KAAK,GAAGhB,OAAO,CACnB,MAAMI,YAAY,CAACK,cAAc,EAAEM,YAAY,CAAC,EAChD,CAACN,cAAc,EAAEM,YAAY,CAC/B,CAAC;EAED,MAAME,KAAK,GAAGjB,OAAO,CACnB,OAAO;IAAEgB,KAAK;IAAEH;EAAa,CAAC,CAAC,EAC/B,CAACG,KAAK,EAAEH,YAAY,CACtB,CAAC;EAED,oBACEP,IAAA,CAACC,YAAY,CAACW,QAAQ;IAACD,KAAK,EAAEA,KAAM;IAAAN,QAAA,EAAEA;EAAQ,CAAwB,CAAC;AAE3E;AAEA,OAAO,SAASQ,QAAQA,CAAA,EAAkB;EACxC,MAAMC,GAAG,GAAGtB,UAAU,CAACS,YAAY,CAAC;EACpC,IAAI,CAACa,GAAG,EAAE;IACR,MAAM,IAAIC,KAAK,CACb,kHACF,CAAC;EACH;EACA,OAAOD,GAAG,CAACJ,KAAK;AAClB;AAEA,OAAO,SAASM,gBAAgBA,CAAA,EAAY;EAC1C,MAAMF,GAAG,GAAGtB,UAAU,CAACS,YAAY,CAAC;EACpC,OAAOa,GAAG,EAAEP,YAAY,IAAI,KAAK;AACnC;AAEA,SAASC,wBAAwBA,CAAA,EAAY;EAC3C,MAAM,CAACS,OAAO,EAAEC,UAAU,CAAC,GAAGvB,QAAQ,CAAC,KAAK,CAAC;EAC7CF,SAAS,CAAC,MAAM;IACd,IAAI0B,OAAO,GAAG,IAAI;IAClBvB,iBAAiB,CAACwB,qBAAqB,CAAC,CAAC,CACtCC,IAAI,CAAEC,CAAC,IAAK;MACX,IAAIH,OAAO,EAAED,UAAU,CAACI,CAAC,CAAC;IAC5B,CAAC,CAAC,CACDC,KAAK,CAAC,MAAM;MACX;IAAA,CACD,CAAC;IACJ,MAAMC,GAAG,GAAG5B,iBAAiB,CAAC6B,gBAAgB,CAC5C,qBAAqB,EACpBH,CAAC,IAAKJ,UAAU,CAACI,CAAC,CACrB,CAAC;IACD,OAAO,MAAM;MACXH,OAAO,GAAG,KAAK;MACfK,GAAG,CAACE,MAAM,CAAC,CAAC;IACd,CAAC;EACH,CAAC,EAAE,EAAE,CAAC;EACN,OAAOT,OAAO;AAChB","ignoreList":[]}

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

@@ -0,0 +1,5 @@
+"use strict";
+
+export { ThemeProvider, useTheme, useReducedMotion } from './ThemeProvider';
+export { LIGHT_TOKENS, DARK_TOKENS, getDefaultThemeTokens, resolveTheme, mixHex, withAlpha, isHexDark } from './tokens';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["ThemeProvider","useTheme","useReducedMotion","LIGHT_TOKENS","DARK_TOKENS","getDefaultThemeTokens","resolveTheme","mixHex","withAlpha","isHexDark"],"sourceRoot":"../../../../src","sources":["ui/theme/index.ts"],"mappings":";;AAAA,SACEA,aAAa,EACbC,QAAQ,EACRC,gBAAgB,QAEX,iBAAiB;AACxB,SACEC,YAAY,EACZC,WAAW,EACXC,qBAAqB,EACrBC,YAAY,EACZC,MAAM,EACNC,SAAS,EACTC,SAAS,QAGJ,UAAU","ignoreList":[]}

package/lib/module/ui/theme/tokens.js

@@ -0,0 +1,145 @@
+"use strict";
+
+/**
+ * @fileoverview Theme tokens for the React Native SDK.
+ *
+ * Exposes logical tokens as a plain JS object that components consume via
+ * `useTheme()`.
+ *
+ * Light and dark are tuned independently (Material Design 3 / Apple HIG dark
+ * pairing). Consumer overrides from `VelionConfig.theme` are layered on top.
+ */
+
+/** Tonal token set. Shape matches `VelionTheme` (all required, no undefineds). */
+
+/**
+ * Resolved values that components actually read from. We keep colors as plain
+ * hex strings; consumers that want to layer translucency use `mixHex` instead
+ * of CSS `color-mix()` (which does not exist in RN).
+ */
+
+export const LIGHT_TOKENS = {
+  primaryColor: '#2563EB',
+  secondaryColor: '#1D4ED8',
+  backgroundColor: '#FFFFFF',
+  textColor: '#111827',
+  textSecondaryColor: '#6B7280',
+  borderRadius: '8px',
+  fontFamily: 'System',
+  errorColor: '#DC2626',
+  successColor: '#16A34A',
+  warningColor: '#D97706',
+  borderColor: '#E5E7EB',
+  cardShadow: '0 4px 6px -1px rgba(0,0,0,0.10), 0 2px 4px -2px rgba(0,0,0,0.10)',
+  hideStepIcons: false,
+  hideProgressBar: false
+};
+export const DARK_TOKENS = {
+  primaryColor: '#3B82F6',
+  secondaryColor: '#60A5FA',
+  backgroundColor: '#0B1220',
+  textColor: '#F1F5F9',
+  textSecondaryColor: '#94A3B8',
+  borderRadius: '8px',
+  fontFamily: 'System',
+  errorColor: '#F87171',
+  successColor: '#34D399',
+  warningColor: '#FBBF24',
+  borderColor: '#1E293B',
+  cardShadow: '0 8px 18px -4px rgba(0,0,0,0.55), 0 4px 8px -4px rgba(0,0,0,0.40)',
+  hideStepIcons: false,
+  hideProgressBar: false
+};
+export function getDefaultThemeTokens(colorMode = 'light') {
+  return colorMode === 'dark' ? {
+    ...DARK_TOKENS
+  } : {
+    ...LIGHT_TOKENS
+  };
+}
+
+/** Layers consumer overrides on top of the base tokens for the requested mode. */
+export function resolveTheme(theme, colorMode) {
+  const base = colorMode === 'dark' ? DARK_TOKENS : LIGHT_TOKENS;
+  const merged = {
+    ...base,
+    ...theme
+  };
+  // Recompute the effective mode from the resolved background luminance, so a
+  // consumer that passes `colorMode: "light"` but overrides `backgroundColor`
+  // with a dark hex still gets icons / images that branch on the mode right.
+  const effectiveMode = isHexDark(merged.backgroundColor) ? 'dark' : 'light';
+  const borderRadiusPx = parsePx(merged.borderRadius, 8);
+  return {
+    ...merged,
+    effectiveMode,
+    borderRadiusPx
+  };
+}
+
+/** WCAG relative-luminance check. Returns false on unparsable input. */
+export function isHexDark(hex) {
+  const parsed = parseHex(hex);
+  if (!parsed) return false;
+  const linearize = c => {
+    const n = c / 255;
+    return n <= 0.03928 ? n / 12.92 : Math.pow((n + 0.055) / 1.055, 2.4);
+  };
+  const luminance = 0.2126 * linearize(parsed.r) + 0.7152 * linearize(parsed.g) + 0.0722 * linearize(parsed.b);
+  return luminance < 0.5;
+}
+
+/**
+ * Mix two hex colors at the given ratio (0–100). Cheap stand-in for the web's
+ * `color-mix(in srgb, A x%, B)` so we can render the soft halos and tinted
+ * backgrounds the design system uses (.vl-retry-dialog, .vl-sworn__option).
+ */
+export function mixHex(a, b, ratioOfA) {
+  const ar = clamp(ratioOfA, 0, 100) / 100;
+  const ca = parseHex(a);
+  const cb = parseHex(b);
+  if (!ca || !cb) return a;
+  const r = Math.round(ca.r * ar + cb.r * (1 - ar));
+  const g = Math.round(ca.g * ar + cb.g * (1 - ar));
+  const blue = Math.round(ca.b * ar + cb.b * (1 - ar));
+  return `#${toHex(r)}${toHex(g)}${toHex(blue)}`;
+}
+
+/**
+ * Returns an `rgba()` string with the supplied alpha (0–1). Use for translucent
+ * borders / fills that should not blend with the host background.
+ */
+export function withAlpha(hex, alpha) {
+  const c = parseHex(hex);
+  if (!c) return hex;
+  const a = clamp(alpha, 0, 1);
+  return `rgba(${c.r}, ${c.g}, ${c.b}, ${a})`;
+}
+function parseHex(hex) {
+  const match = hex.match(/^#?([0-9a-f]{3}|[0-9a-f]{6})$/i);
+  if (!match || !match[1]) return null;
+  const raw = match[1];
+  const full = raw.length === 3 ? raw[0] + raw[0] + raw[1] + raw[1] + raw[2] + raw[2] : raw;
+  return {
+    r: parseInt(full.slice(0, 2), 16),
+    g: parseInt(full.slice(2, 4), 16),
+    b: parseInt(full.slice(4, 6), 16)
+  };
+}
+function toHex(n) {
+  return clamp(n, 0, 255).toString(16).padStart(2, '0').toUpperCase();
+}
+function clamp(n, min, max) {
+  if (n < min) return min;
+  if (n > max) return max;
+  return n;
+}
+function parsePx(value, fallback) {
+  const m = value.trim().match(/^(\d+(?:\.\d+)?)\s*px$/i);
+  if (m && m[1]) {
+    const parsed = Number(m[1]);
+    if (Number.isFinite(parsed)) return parsed;
+  }
+  return fallback;
+}
+//# sourceMappingURL=tokens.js.map

package/lib/module/ui/theme/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["LIGHT_TOKENS","primaryColor","secondaryColor","backgroundColor","textColor","textSecondaryColor","borderRadius","fontFamily","errorColor","successColor","warningColor","borderColor","cardShadow","hideStepIcons","hideProgressBar","DARK_TOKENS","getDefaultThemeTokens","colorMode","resolveTheme","theme","base","merged","effectiveMode","isHexDark","borderRadiusPx","parsePx","hex","parsed","parseHex","linearize","c","n","Math","pow","luminance","r","g","b","mixHex","a","ratioOfA","ar","clamp","ca","cb","round","blue","toHex","withAlpha","alpha","match","raw","full","length","parseInt","slice","toString","padStart","toUpperCase","min","max","value","fallback","m","trim","Number","isFinite"],"sourceRoot":"../../../../src","sources":["ui/theme/tokens.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/utils/EventEmitter.js

@@ -0,0 +1,139 @@
+"use strict";
+
+/**
+ * @fileoverview Typed, memory-safe EventEmitter for internal SDK communication.
+ *
+ * Design rationale:
+ * - Fully typed via generics — no `any` escapes at the call sites.
+ * - All `on()` calls return an unsubscribe function, which is the preferred
+ *   modern pattern over imperative `off()` calls. This makes cleanup trivial
+ *   via a collected array of disposables.
+ * - Listeners that throw are caught and logged, preventing one bad subscriber
+ *   from silently breaking the entire event chain.
+ * - `removeAllListeners()` is explicitly called in `VelionOnboarding.destroy()`
+ *   to prevent memory leaks in long-lived single-page applications.
+ */
+
+/** A strongly-typed listener function for a given event payload. */
+
+/** A function returned by `on()` that removes the registered listener when called. */
+
+/**
+ * A generic, compile-time safe EventEmitter.
+ *
+ * @typeParam TEventMap - An object type mapping event names to their payload types.
+ *
+ * @example
+ * ```typescript
+ * interface MyEvents {
+ *   'data:ready': { records: string[] };
+ *   'error': Error;
+ * }
+ *
+ * const emitter = new TypedEventEmitter<MyEvents>();
+ *
+ * const unsub = emitter.on('data:ready', ({ records }) => {
+ *   // `records` is correctly typed as string[]
+ *   console.log(records);
+ * });
+ *
+ * emitter.emit('data:ready', { records: ['a', 'b'] });
+ * unsub(); // Clean up
+ * ```
+ */
+export class TypedEventEmitter {
+  /**
+   * Internal store. Using a `Map<K, Set<Listener>>` gives O(1) lookups and
+   * avoids duplicate listeners with zero extra checks (Set semantics).
+   */
+  _listeners = new Map();
+
+  /**
+   * Registers a listener for the given event. The listener will be invoked
+   * synchronously every time `emit(event, payload)` is called.
+   *
+   * @param event - The event name to subscribe to.
+   * @param listener - The callback to invoke. Receives the typed payload.
+   * @returns An unsubscribe function. Call it to remove this specific listener.
+   */
+  on(event, listener) {
+    if (!this._listeners.has(event)) {
+      this._listeners.set(event, new Set());
+    }
+    const listeners = this._listeners.get(event);
+    if (listeners) listeners.add(listener);
+    return () => this.off(event, listener);
+  }
+
+  /**
+   * Registers a one-time listener. The listener is automatically removed
+   * after the first time the event fires.
+   *
+   * @param event - The event name to subscribe to.
+   * @param listener - The callback to invoke once.
+   * @returns An unsubscribe function. Call it to cancel before the event fires.
+   */
+  once(event, listener) {
+    const wrapper = payload => {
+      listener(payload);
+      this.off(event, wrapper);
+    };
+    return this.on(event, wrapper);
+  }
+
+  /**
+   * Emits an event, synchronously invoking all registered listeners.
+   * Errors thrown by individual listeners are caught and logged to prevent
+   * cascading failures.
+   *
+   * @param event - The event name to emit.
+   * @param payload - The data to pass to each listener.
+   */
+  emit(event, payload) {
+    const set = this._listeners.get(event);
+    if (!set || set.size === 0) return;
+    for (const listener of set) {
+      try {
+        listener(payload);
+      } catch (err) {
+        console.error(`[VelionSDK] Uncaught error in listener for event "${String(event)}":`, err);
+      }
+    }
+  }
+
+  /**
+   * Removes a specific listener for an event.
+   *
+   * @param event - The event name.
+   * @param listener - The exact listener function reference to remove.
+   */
+  off(event, listener) {
+    this._listeners.get(event)?.delete(listener);
+  }
+
+  /**
+   * Removes all listeners, optionally scoped to a single event.
+   * Called by `VelionOnboarding.destroy()` to prevent memory leaks.
+   *
+   * @param event - If provided, only clears listeners for that event.
+   *                If omitted, clears ALL listeners on ALL events.
+   */
+  removeAllListeners(event) {
+    if (event !== undefined) {
+      this._listeners.delete(event);
+    } else {
+      this._listeners.clear();
+    }
+  }
+
+  /**
+   * Returns the number of registered listeners for a given event.
+   * Useful for debugging and testing assertions.
+   *
+   * @param event - The event name to check.
+   */
+  listenerCount(event) {
+    return this._listeners.get(event)?.size ?? 0;
+  }
+}
+//# sourceMappingURL=EventEmitter.js.map

package/lib/module/utils/EventEmitter.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["TypedEventEmitter","_listeners","Map","on","event","listener","has","set","Set","listeners","get","add","off","once","wrapper","payload","emit","size","err","console","error","String","delete","removeAllListeners","undefined","clear","listenerCount"],"sourceRoot":"../../../src","sources":["utils/EventEmitter.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;;AAGA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMA,iBAAiB,CAA4C;EACxE;AACF;AACA;AACA;EACmBC,UAAU,GAAG,IAAIC,GAAG,CAGnC,CAAC;;EAEH;AACF;AACA;AACA;AACA;AACA;AACA;AACA;EACEC,EAAEA,CACAC,KAAQ,EACRC,QAAgC,EACnB;IACb,IAAI,CAAC,IAAI,CAACJ,UAAU,CAACK,GAAG,CAACF,KAAK,CAAC,EAAE;MAC/B,IAAI,CAACH,UAAU,CAACM,GAAG,CAACH,KAAK,EAAE,IAAII,GAAG,CAAC,CAAC,CAAC;IACvC;IACA,MAAMC,SAAS,GAAG,IAAI,CAACR,UAAU,CAACS,GAAG,CAACN,KAAK,CAAC;IAC5C,IAAIK,SAAS,EAAEA,SAAS,CAACE,GAAG,CAACN,QAA6B,CAAC;IAE3D,OAAO,MAAM,IAAI,CAACO,GAAG,CAACR,KAAK,EAAEC,QAAQ,CAAC;EACxC;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;EACEQ,IAAIA,CACFT,KAAQ,EACRC,QAAgC,EACnB;IACb,MAAMS,OAA+B,GAAIC,OAAO,IAAK;MACnDV,QAAQ,CAACU,OAAO,CAAC;MACjB,IAAI,CAACH,GAAG,CAACR,KAAK,EAAEU,OAAO,CAAC;IAC1B,CAAC;IACD,OAAO,IAAI,CAACX,EAAE,CAACC,KAAK,EAAEU,OAAO,CAAC;EAChC;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;EACEE,IAAIA,CAA4BZ,KAAQ,EAAEW,OAAqB,EAAQ;IACrE,MAAMR,GAAG,GAAG,IAAI,CAACN,UAAU,CAACS,GAAG,CAACN,KAAK,CAAC;IACtC,IAAI,CAACG,GAAG,IAAIA,GAAG,CAACU,IAAI,KAAK,CAAC,EAAE;IAE5B,KAAK,MAAMZ,QAAQ,IAAIE,GAAG,EAAE;MAC1B,IAAI;QACDF,QAAQ,CAA4BU,OAAO,CAAC;MAC/C,CAAC,CAAC,OAAOG,GAAG,EAAE;QACZC,OAAO,CAACC,KAAK,CACX,qDAAqDC,MAAM,CAACjB,KAAK,CAAC,IAAI,EACtEc,GACF,CAAC;MACH;IACF;EACF;;EAEA;AACF;AACA;AACA;AACA;AACA;EACEN,GAAGA,CACDR,KAAQ,EACRC,QAAgC,EAC1B;IACN,IAAI,CAACJ,UAAU,CAACS,GAAG,CAACN,KAAK,CAAC,EAAEkB,MAAM,CAACjB,QAA6B,CAAC;EACnE;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;EACEkB,kBAAkBA,CAACnB,KAAuB,EAAQ;IAChD,IAAIA,KAAK,KAAKoB,SAAS,EAAE;MACvB,IAAI,CAACvB,UAAU,CAACqB,MAAM,CAAClB,KAAK,CAAC;IAC/B,CAAC,MAAM;MACL,IAAI,CAACH,UAAU,CAACwB,KAAK,CAAC,CAAC;IACzB;EACF;;EAEA;AACF;AACA;AACA;AACA;AACA;EACEC,aAAaA,CAACtB,KAAsB,EAAU;IAC5C,OAAO,IAAI,CAACH,UAAU,CAACS,GAAG,CAACN,KAAK,CAAC,EAAEa,IAAI,IAAI,CAAC;EAC9C;AACF","ignoreList":[]}