rn-inputforge 0.4.0 → 0.5.0

package/lib/module/theme/presets.js

@@ -0,0 +1,138 @@
+"use strict";
+
+import { defaultTheme, darkTheme } from './defaultTheme';
+
+/**
+ * Curated one-liner themes for demos and brand starts.
+ * Pass into `FieldFlowThemeProvider theme={themePresets.soft}`.
+ */
+export const themePresets = {
+  /** Default FieldFlow blue. */
+  default: defaultTheme,
+  /** Bundled dark palette. */
+  dark: darkTheme,
+  /** Soft rounded surfaces, indigo accent. */
+  soft: {
+    colors: {
+      background: '#F8FAFC',
+      backgroundDisabled: '#EEF2F7',
+      border: '#E2E8F0',
+      borderFocused: '#6366F1',
+      borderError: '#F43F5E',
+      borderSuccess: '#10B981',
+      text: '#0F172A',
+      placeholder: '#94A3B8',
+      label: '#475569',
+      labelFocused: '#6366F1',
+      error: '#F43F5E',
+      success: '#10B981',
+      icon: '#64748B',
+      iconFocused: '#6366F1'
+    },
+    spacing: {
+      borderRadius: 16,
+      paddingHorizontal: 16,
+      paddingVertical: 14
+    },
+    typography: {
+      fontSize: 16,
+      labelFontSize: 13,
+      helperFontSize: 12
+    }
+  },
+  /** High-contrast ink on white — docs / legal forms. */
+  contrast: {
+    colors: {
+      background: '#FFFFFF',
+      backgroundDisabled: '#F3F4F6',
+      border: '#111827',
+      borderFocused: '#111827',
+      borderError: '#B91C1C',
+      borderSuccess: '#047857',
+      text: '#111827',
+      placeholder: '#6B7280',
+      label: '#111827',
+      labelFocused: '#111827',
+      error: '#B91C1C',
+      success: '#047857',
+      icon: '#374151',
+      iconFocused: '#111827'
+    },
+    spacing: {
+      borderRadius: 4,
+      borderWidth: 1.5,
+      borderWidthFocused: 2
+    }
+  },
+  /** Warm coral accent, cream surfaces. */
+  warm: {
+    colors: {
+      background: '#FFFBF7',
+      backgroundDisabled: '#F5EDE4',
+      border: '#E8D5C4',
+      borderFocused: '#E11D48',
+      borderError: '#DC2626',
+      borderSuccess: '#059669',
+      text: '#1C1917',
+      placeholder: '#A8A29E',
+      label: '#57534E',
+      labelFocused: '#E11D48',
+      error: '#DC2626',
+      success: '#059669',
+      icon: '#78716C',
+      iconFocused: '#E11D48'
+    },
+    spacing: {
+      borderRadius: 12
+    }
+  },
+  /** Cool teal — fintech / health. */
+  teal: {
+    colors: {
+      background: '#FFFFFF',
+      backgroundDisabled: '#F0FDFA',
+      border: '#CCFBF1',
+      borderFocused: '#0D9488',
+      borderError: '#E11D48',
+      borderSuccess: '#059669',
+      text: '#134E4A',
+      placeholder: '#5EEAD4',
+      label: '#0F766E',
+      labelFocused: '#0D9488',
+      error: '#E11D48',
+      success: '#059669',
+      icon: '#14B8A6',
+      iconFocused: '#0D9488'
+    },
+    spacing: {
+      borderRadius: 14,
+      paddingHorizontal: 16
+    }
+  },
+  /** Midnight elevated cards. */
+  midnight: {
+    colors: {
+      background: '#0B1220',
+      backgroundDisabled: '#111827',
+      border: '#1F2937',
+      borderFocused: '#818CF8',
+      borderError: '#FB7185',
+      borderSuccess: '#34D399',
+      text: '#F9FAFB',
+      placeholder: '#6B7280',
+      label: '#9CA3AF',
+      labelFocused: '#A5B4FC',
+      error: '#FB7185',
+      success: '#34D399',
+      icon: '#9CA3AF',
+      iconFocused: '#A5B4FC'
+    },
+    spacing: {
+      borderRadius: 14
+    }
+  }
+};
+export function getThemePreset(name) {
+  return themePresets[name];
+}
+//# sourceMappingURL=presets.js.map

package/lib/module/theme/presets.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["defaultTheme","darkTheme","themePresets","default","dark","soft","colors","background","backgroundDisabled","border","borderFocused","borderError","borderSuccess","text","placeholder","label","labelFocused","error","success","icon","iconFocused","spacing","borderRadius","paddingHorizontal","paddingVertical","typography","fontSize","labelFontSize","helperFontSize","contrast","borderWidth","borderWidthFocused","warm","teal","midnight","getThemePreset","name"],"sourceRoot":"../../../src","sources":["theme/presets.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/utils/affordance.js

@@ -0,0 +1,140 @@
+"use strict";
+
+/** Popular consumer email domains for quick completion. */
+export const DEFAULT_EMAIL_DOMAINS = ['gmail.com', 'outlook.com', 'hotmail.com', 'yahoo.com', 'icloud.com', 'proton.me', 'aol.com', 'mail.com'];
+
+/** Common dial-code chips (label shown to the user). */
+export const DEFAULT_PHONE_DIAL_CODES = [{
+  label: '+1',
+  accessibilityLabel: 'United States / Canada +1'
+}, {
+  label: '+44',
+  accessibilityLabel: 'United Kingdom +44'
+}, {
+  label: '+92',
+  accessibilityLabel: 'Pakistan +92'
+}, {
+  label: '+91',
+  accessibilityLabel: 'India +91'
+}, {
+  label: '+61',
+  accessibilityLabel: 'Australia +61'
+}, {
+  label: '+49',
+  accessibilityLabel: 'Germany +49'
+}, {
+  label: '+971',
+  accessibilityLabel: 'UAE +971'
+}, {
+  label: '+966',
+  accessibilityLabel: 'Saudi Arabia +966'
+}];
+
+/** Currency symbol chips. */
+export const DEFAULT_CURRENCY_SYMBOLS = [{
+  label: '$',
+  value: '$',
+  accessibilityLabel: 'US Dollar'
+}, {
+  label: '€',
+  value: '€',
+  accessibilityLabel: 'Euro'
+}, {
+  label: '£',
+  value: '£',
+  accessibilityLabel: 'British Pound'
+}, {
+  label: '₹',
+  value: '₹',
+  accessibilityLabel: 'Indian Rupee'
+}, {
+  label: 'Rs',
+  value: 'Rs ',
+  accessibilityLabel: 'Rupee'
+}, {
+  label: 'AED',
+  value: 'AED ',
+  accessibilityLabel: 'UAE Dirham'
+}];
+export function emailDomainsToChips(domains) {
+  return domains.map(domain => ({
+    label: `@${domain}`,
+    value: domain,
+    accessibilityLabel: `Complete with ${domain}`
+  }));
+}
+
+/**
+ * Apply an email-domain suggestion to the current value.
+ * - `jane` + `gmail.com` → `jane@gmail.com`
+ * - `jane@hot` + `gmail.com` → `jane@gmail.com`
+ * - `jane@gmail.com` + `outlook.com` → `jane@outlook.com`
+ */
+export function applyEmailDomainSuggestion(current, domain) {
+  const cleanedDomain = domain.replace(/^@/, '');
+  const at = current.indexOf('@');
+  if (at === -1) {
+    const local = current.trim();
+    return local ? `${local}@${cleanedDomain}` : `@${cleanedDomain}`;
+  }
+  return `${current.slice(0, at)}@${cleanedDomain}`;
+}
+
+/**
+ * Apply a dial-code chip. Replaces an existing leading `+digits` prefix when present.
+ */
+export function applyPhoneDialSuggestion(current, dialCode) {
+  const code = dialCode.startsWith('+') ? dialCode : `+${dialCode}`;
+  const rest = current.replace(/^\s*\+?\d{0,4}\s*/, '');
+  return rest ? `${code} ${rest.trimStart()}` : code;
+}
+
+/**
+ * Ensure the value starts with the currency symbol (does not duplicate if already present).
+ */
+export function applyCurrencySymbolSuggestion(current, symbol) {
+  const trimmed = current.trimStart();
+  if (trimmed.startsWith(symbol.trim())) return current;
+  const digits = trimmed.replace(/^[^\d.-]+/, '');
+  return `${symbol}${digits}`;
+}
+export function resolveAffordanceChips(kind, custom) {
+  if (custom && custom.length > 0) {
+    return custom.map(item => typeof item === 'string' ? {
+      label: item.startsWith('@') || item.startsWith('+') ? item : item,
+      value: item
+    } : item);
+  }
+  switch (kind) {
+    case 'email':
+      return emailDomainsToChips(DEFAULT_EMAIL_DOMAINS);
+    case 'phone':
+      return DEFAULT_PHONE_DIAL_CODES;
+    case 'currency':
+      return DEFAULT_CURRENCY_SYMBOLS;
+    default:
+      return [];
+  }
+}
+export function applyAffordanceSuggestion(kind, current, chip) {
+  const value = chip.value ?? chip.label;
+  switch (kind) {
+    case 'email':
+      return applyEmailDomainSuggestion(current, value);
+    case 'phone':
+      return applyPhoneDialSuggestion(current, value);
+    case 'currency':
+      return applyCurrencySymbolSuggestion(current, value);
+    default:
+      return value;
+  }
+}
+
+/** Infer affordance kind from FieldFlow input `type`. */
+export function affordanceKindFromFieldType(type) {
+  if (type === 'email') return 'email';
+  if (type === 'phone') return 'phone';
+  if (type === 'decimal' || type === 'number') return 'currency';
+  return undefined;
+}
+//# sourceMappingURL=affordance.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["DEFAULT_EMAIL_DOMAINS","DEFAULT_PHONE_DIAL_CODES","label","accessibilityLabel","DEFAULT_CURRENCY_SYMBOLS","value","emailDomainsToChips","domains","map","domain","applyEmailDomainSuggestion","current","cleanedDomain","replace","at","indexOf","local","trim","slice","applyPhoneDialSuggestion","dialCode","code","startsWith","rest","trimStart","applyCurrencySymbolSuggestion","symbol","trimmed","digits","resolveAffordanceChips","kind","custom","length","item","applyAffordanceSuggestion","chip","affordanceKindFromFieldType","type","undefined"],"sourceRoot":"../../../src","sources":["utils/affordance.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/utils/passwordStrength.js

@@ -0,0 +1,74 @@
+"use strict";
+
+export const DEFAULT_PASSWORD_RULES = [{
+  id: 'length',
+  label: 'At least 8 characters',
+  test: p => p.length >= 8
+}, {
+  id: 'lowercase',
+  label: 'A lowercase letter',
+  test: p => /[a-z]/.test(p)
+}, {
+  id: 'uppercase',
+  label: 'An uppercase letter',
+  test: p => /[A-Z]/.test(p)
+}, {
+  id: 'number',
+  label: 'A number',
+  test: p => /\d/.test(p)
+}, {
+  id: 'symbol',
+  label: 'A symbol',
+  test: p => /[^A-Za-z0-9]/.test(p)
+}];
+const LEVEL_LABELS = {
+  empty: '',
+  weak: 'Weak',
+  fair: 'Fair',
+  good: 'Good',
+  strong: 'Strong'
+};
+
+/**
+ * Score a password against declarative rules (default NIST-ish checklist).
+ * Pure function — safe to unit test and reuse outside React.
+ */
+export function evaluatePasswordStrength(password, rules = DEFAULT_PASSWORD_RULES) {
+  if (!password) {
+    return {
+      score: 0,
+      level: 'empty',
+      progress: 0,
+      passed: [],
+      failed: [...rules],
+      label: LEVEL_LABELS.empty
+    };
+  }
+  const passed = [];
+  const failed = [];
+  for (const rule of rules) {
+    if (rule.test(password)) passed.push(rule);else failed.push(rule);
+  }
+  const score = passed.length;
+  const max = Math.max(rules.length, 1);
+  const ratio = score / max;
+  let level;
+  if (ratio < 0.4) level = 'weak';else if (ratio < 0.6) level = 'fair';else if (ratio < 0.85) level = 'good';else level = 'strong';
+  return {
+    score,
+    level,
+    progress: ratio,
+    passed,
+    failed,
+    label: LEVEL_LABELS[level]
+  };
+}
+
+/** Suggested bar colors for each level (consumers can override). */
+export const PASSWORD_STRENGTH_COLORS = {
+  weak: '#EF4444',
+  fair: '#F59E0B',
+  good: '#3B82F6',
+  strong: '#22C55E'
+};
+//# sourceMappingURL=passwordStrength.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["DEFAULT_PASSWORD_RULES","id","label","test","p","length","LEVEL_LABELS","empty","weak","fair","good","strong","evaluatePasswordStrength","password","rules","score","level","progress","passed","failed","rule","push","max","Math","ratio","PASSWORD_STRENGTH_COLORS"],"sourceRoot":"../../../src","sources":["utils/passwordStrength.ts"],"mappings":";;AAoBA,OAAO,MAAMA,sBAA8C,GAAG,CAC5D;EACEC,EAAE,EAAE,QAAQ;EACZC,KAAK,EAAE,uBAAuB;EAC9BC,IAAI,EAAEC,CAAC,IAAIA,CAAC,CAACC,MAAM,IAAI;AACzB,CAAC,EACD;EACEJ,EAAE,EAAE,WAAW;EACfC,KAAK,EAAE,oBAAoB;EAC3BC,IAAI,EAAEC,CAAC,IAAI,OAAO,CAACD,IAAI,CAACC,CAAC;AAC3B,CAAC,EACD;EACEH,EAAE,EAAE,WAAW;EACfC,KAAK,EAAE,qBAAqB;EAC5BC,IAAI,EAAEC,CAAC,IAAI,OAAO,CAACD,IAAI,CAACC,CAAC;AAC3B,CAAC,EACD;EACEH,EAAE,EAAE,QAAQ;EACZC,KAAK,EAAE,UAAU;EACjBC,IAAI,EAAEC,CAAC,IAAI,IAAI,CAACD,IAAI,CAACC,CAAC;AACxB,CAAC,EACD;EACEH,EAAE,EAAE,QAAQ;EACZC,KAAK,EAAE,UAAU;EACjBC,IAAI,EAAEC,CAAC,IAAI,cAAc,CAACD,IAAI,CAACC,CAAC;AAClC,CAAC,CACF;AAED,MAAME,YAAmD,GAAG;EAC1DC,KAAK,EAAE,EAAE;EACTC,IAAI,EAAE,MAAM;EACZC,IAAI,EAAE,MAAM;EACZC,IAAI,EAAE,MAAM;EACZC,MAAM,EAAE;AACV,CAAC;;AAED;AACA;AACA;AACA;AACA,OAAO,SAASC,wBAAwBA,CACtCC,QAAgB,EAChBC,KAA6B,GAAGd,sBAAsB,EAC9B;EACxB,IAAI,CAACa,QAAQ,EAAE;IACb,OAAO;MACLE,KAAK,EAAE,CAAC;MACRC,KAAK,EAAE,OAAO;MACdC,QAAQ,EAAE,CAAC;MACXC,MAAM,EAAE,EAAE;MACVC,MAAM,EAAE,CAAC,GAAGL,KAAK,CAAC;MAClBZ,KAAK,EAAEI,YAAY,CAACC;IACtB,CAAC;EACH;EAEA,MAAMW,MAA8B,GAAG,EAAE;EACzC,MAAMC,MAA8B,GAAG,EAAE;EACzC,KAAK,MAAMC,IAAI,IAAIN,KAAK,EAAE;IACxB,IAAIM,IAAI,CAACjB,IAAI,CAACU,QAAQ,CAAC,EAAEK,MAAM,CAACG,IAAI,CAACD,IAAI,CAAC,CAAC,KACtCD,MAAM,CAACE,IAAI,CAACD,IAAI,CAAC;EACxB;EAEA,MAAML,KAAK,GAAGG,MAAM,CAACb,MAAM;EAC3B,MAAMiB,GAAG,GAAGC,IAAI,CAACD,GAAG,CAACR,KAAK,CAACT,MAAM,EAAE,CAAC,CAAC;EACrC,MAAMmB,KAAK,GAAGT,KAAK,GAAGO,GAAG;EAEzB,IAAIN,KAA4B;EAChC,IAAIQ,KAAK,GAAG,GAAG,EAAER,KAAK,GAAG,MAAM,CAAC,KAC3B,IAAIQ,KAAK,GAAG,GAAG,EAAER,KAAK,GAAG,MAAM,CAAC,KAChC,IAAIQ,KAAK,GAAG,IAAI,EAAER,KAAK,GAAG,MAAM,CAAC,KACjCA,KAAK,GAAG,QAAQ;EAErB,OAAO;IACLD,KAAK;IACLC,KAAK;IACLC,QAAQ,EAAEO,KAAK;IACfN,MAAM;IACNC,MAAM;IACNjB,KAAK,EAAEI,YAAY,CAACU,KAAK;EAC3B,CAAC;AACH;;AAEA;AACA,OAAO,MAAMS,wBAAiF,GAAG;EAC/FjB,IAAI,EAAE,SAAS;EACfC,IAAI,EAAE,SAAS;EACfC,IAAI,EAAE,SAAS;EACfC,MAAM,EAAE;AACV,CAAC","ignoreList":[]}

package/lib/module/utils/phoneCountries.js

@@ -0,0 +1,113 @@
+"use strict";
+
+/** Common dial codes for `FieldFlowPhone`. Extend via `countries` prop. */
+export const DEFAULT_COUNTRY_DIALS = [{
+  code: 'US',
+  name: 'United States',
+  dial: '+1',
+  flag: '🇺🇸'
+}, {
+  code: 'GB',
+  name: 'United Kingdom',
+  dial: '+44',
+  flag: '🇬🇧'
+}, {
+  code: 'CA',
+  name: 'Canada',
+  dial: '+1',
+  flag: '🇨🇦'
+}, {
+  code: 'AU',
+  name: 'Australia',
+  dial: '+61',
+  flag: '🇦🇺'
+}, {
+  code: 'DE',
+  name: 'Germany',
+  dial: '+49',
+  flag: '🇩🇪'
+}, {
+  code: 'FR',
+  name: 'France',
+  dial: '+33',
+  flag: '🇫🇷'
+}, {
+  code: 'IN',
+  name: 'India',
+  dial: '+91',
+  flag: '🇮🇳'
+}, {
+  code: 'PK',
+  name: 'Pakistan',
+  dial: '+92',
+  flag: '🇵🇰'
+}, {
+  code: 'AE',
+  name: 'United Arab Emirates',
+  dial: '+971',
+  flag: '🇦🇪'
+}, {
+  code: 'SA',
+  name: 'Saudi Arabia',
+  dial: '+966',
+  flag: '🇸🇦'
+}, {
+  code: 'BR',
+  name: 'Brazil',
+  dial: '+55',
+  flag: '🇧🇷'
+}, {
+  code: 'MX',
+  name: 'Mexico',
+  dial: '+52',
+  flag: '🇲🇽'
+}, {
+  code: 'NG',
+  name: 'Nigeria',
+  dial: '+234',
+  flag: '🇳🇬'
+}, {
+  code: 'ZA',
+  name: 'South Africa',
+  dial: '+27',
+  flag: '🇿🇦'
+}, {
+  code: 'JP',
+  name: 'Japan',
+  dial: '+81',
+  flag: '🇯🇵'
+}, {
+  code: 'KR',
+  name: 'South Korea',
+  dial: '+82',
+  flag: '🇰🇷'
+}, {
+  code: 'CN',
+  name: 'China',
+  dial: '+86',
+  flag: '🇨🇳'
+}, {
+  code: 'SG',
+  name: 'Singapore',
+  dial: '+65',
+  flag: '🇸🇬'
+}, {
+  code: 'TR',
+  name: 'Turkey',
+  dial: '+90',
+  flag: '🇹🇷'
+}, {
+  code: 'ES',
+  name: 'Spain',
+  dial: '+34',
+  flag: '🇪🇸'
+}];
+export function findCountryByCode(code, list = DEFAULT_COUNTRY_DIALS) {
+  return list.find(c => c.code === code);
+}
+export function composeE164(dial, national) {
+  const digits = national.replace(/\D/g, '');
+  const dialDigits = dial.replace(/\D/g, '');
+  return `+${dialDigits}${digits}`;
+}
+//# sourceMappingURL=phoneCountries.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["DEFAULT_COUNTRY_DIALS","code","name","dial","flag","findCountryByCode","list","find","c","composeE164","national","digits","replace","dialDigits"],"sourceRoot":"../../../src","sources":["utils/phoneCountries.ts"],"mappings":";;AAQA;AACA,OAAO,MAAMA,qBAA6C,GAAG,CAC3D;EAAEC,IAAI,EAAE,IAAI;EAAEC,IAAI,EAAE,eAAe;EAAEC,IAAI,EAAE,IAAI;EAAEC,IAAI,EAAE;AAAO,CAAC,EAC/D;EAAEH,IAAI,EAAE,IAAI;EAAEC,IAAI,EAAE,gBAAgB;EAAEC,IAAI,EAAE,KAAK;EAAEC,IAAI,EAAE;AAAO,CAAC,EACjE;EAAEH,IAAI,EAAE,IAAI;EAAEC,IAAI,EAAE,QAAQ;EAAEC,IAAI,EAAE,IAAI;EAAEC,IAAI,EAAE;AAAO,CAAC,EACxD;EAAEH,IAAI,EAAE,IAAI;EAAEC,IAAI,EAAE,WAAW;EAAEC,IAAI,EAAE,KAAK;EAAEC,IAAI,EAAE;AAAO,CAAC,EAC5D;EAAEH,IAAI,EAAE,IAAI;EAAEC,IAAI,EAAE,SAAS;EAAEC,IAAI,EAAE,KAAK;EAAEC,IAAI,EAAE;AAAO,CAAC,EAC1D;EAAEH,IAAI,EAAE,IAAI;EAAEC,IAAI,EAAE,QAAQ;EAAEC,IAAI,EAAE,KAAK;EAAEC,IAAI,EAAE;AAAO,CAAC,EACzD;EAAEH,IAAI,EAAE,IAAI;EAAEC,IAAI,EAAE,OAAO;EAAEC,IAAI,EAAE,KAAK;EAAEC,IAAI,EAAE;AAAO,CAAC,EACxD;EAAEH,IAAI,EAAE,IAAI;EAAEC,IAAI,EAAE,UAAU;EAAEC,IAAI,EAAE,KAAK;EAAEC,IAAI,EAAE;AAAO,CAAC,EAC3D;EAAEH,IAAI,EAAE,IAAI;EAAEC,IAAI,EAAE,sBAAsB;EAAEC,IAAI,EAAE,MAAM;EAAEC,IAAI,EAAE;AAAO,CAAC,EACxE;EAAEH,IAAI,EAAE,IAAI;EAAEC,IAAI,EAAE,cAAc;EAAEC,IAAI,EAAE,MAAM;EAAEC,IAAI,EAAE;AAAO,CAAC,EAChE;EAAEH,IAAI,EAAE,IAAI;EAAEC,IAAI,EAAE,QAAQ;EAAEC,IAAI,EAAE,KAAK;EAAEC,IAAI,EAAE;AAAO,CAAC,EACzD;EAAEH,IAAI,EAAE,IAAI;EAAEC,IAAI,EAAE,QAAQ;EAAEC,IAAI,EAAE,KAAK;EAAEC,IAAI,EAAE;AAAO,CAAC,EACzD;EAAEH,IAAI,EAAE,IAAI;EAAEC,IAAI,EAAE,SAAS;EAAEC,IAAI,EAAE,MAAM;EAAEC,IAAI,EAAE;AAAO,CAAC,EAC3D;EAAEH,IAAI,EAAE,IAAI;EAAEC,IAAI,EAAE,cAAc;EAAEC,IAAI,EAAE,KAAK;EAAEC,IAAI,EAAE;AAAO,CAAC,EAC/D;EAAEH,IAAI,EAAE,IAAI;EAAEC,IAAI,EAAE,OAAO;EAAEC,IAAI,EAAE,KAAK;EAAEC,IAAI,EAAE;AAAO,CAAC,EACxD;EAAEH,IAAI,EAAE,IAAI;EAAEC,IAAI,EAAE,aAAa;EAAEC,IAAI,EAAE,KAAK;EAAEC,IAAI,EAAE;AAAO,CAAC,EAC9D;EAAEH,IAAI,EAAE,IAAI;EAAEC,IAAI,EAAE,OAAO;EAAEC,IAAI,EAAE,KAAK;EAAEC,IAAI,EAAE;AAAO,CAAC,EACxD;EAAEH,IAAI,EAAE,IAAI;EAAEC,IAAI,EAAE,WAAW;EAAEC,IAAI,EAAE,KAAK;EAAEC,IAAI,EAAE;AAAO,CAAC,EAC5D;EAAEH,IAAI,EAAE,IAAI;EAAEC,IAAI,EAAE,QAAQ;EAAEC,IAAI,EAAE,KAAK;EAAEC,IAAI,EAAE;AAAO,CAAC,EACzD;EAAEH,IAAI,EAAE,IAAI;EAAEC,IAAI,EAAE,OAAO;EAAEC,IAAI,EAAE,KAAK;EAAEC,IAAI,EAAE;AAAO,CAAC,CACzD;AAED,OAAO,SAASC,iBAAiBA,CAC/BJ,IAAY,EACZK,IAA4B,GAAGN,qBAAqB,EAClB;EAClC,OAAOM,IAAI,CAACC,IAAI,CAACC,CAAC,IAAIA,CAAC,CAACP,IAAI,KAAKA,IAAI,CAAC;AACxC;AAEA,OAAO,SAASQ,WAAWA,CAACN,IAAY,EAAEO,QAAgB,EAAU;EAClE,MAAMC,MAAM,GAAGD,QAAQ,CAACE,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;EAC1C,MAAMC,UAAU,GAAGV,IAAI,CAACS,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;EAC1C,OAAO,IAAIC,UAAU,GAAGF,MAAM,EAAE;AAClC","ignoreList":[]}

package/lib/module/validation/validators.js

@@ -1,5 +1,6 @@
 "use strict";
 
+import { getValidationMessages } from '../i18n/messages';
 const EMAIL_REGEX = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
 const NUMBER_REGEX = /^-?\d+(\.\d+)?$/;
 const PHONE_REGEX = /^[+]?[\d\s()-]{7,20}$/;
@@ -52,41 +53,43 @@ export const patternValidator = (pattern, message = 'Invalid format') => value =
 /**
  * Turns a declarative `FieldFlowRules` object into an ordered list of validators
  * and runs them against a value, stopping at (and returning) the first failure.
+ * Pass `messages` (or use `locale` via `useFieldFlowForm`) for localized defaults.
  */
-export function runRules(value, rules) {
+export function runRules(value, rules, messages) {
   if (!rules) return {
     valid: true
   };
+  const msg = messages ?? getValidationMessages('en');
   const validators = [];
   if (rules.required) {
-    const message = typeof rules.required === 'string' ? rules.required : undefined;
+    const message = typeof rules.required === 'string' ? rules.required : msg.required;
     validators.push(requiredValidator(message));
   }
   if (rules.email) {
-    const message = typeof rules.email === 'string' ? rules.email : undefined;
+    const message = typeof rules.email === 'string' ? rules.email : msg.email;
     validators.push(emailValidator(message));
   }
   if (rules.number) {
-    const message = typeof rules.number === 'string' ? rules.number : undefined;
+    const message = typeof rules.number === 'string' ? rules.number : msg.number;
     validators.push(numberValidator(message));
   }
   if (rules.minLength !== undefined) {
     const cfg = typeof rules.minLength === 'number' ? {
       value: rules.minLength
     } : rules.minLength;
-    validators.push(minLengthValidator(cfg.value, cfg.message));
+    validators.push(minLengthValidator(cfg.value, cfg.message ?? msg.minLength(cfg.value)));
   }
   if (rules.maxLength !== undefined) {
     const cfg = typeof rules.maxLength === 'number' ? {
       value: rules.maxLength
     } : rules.maxLength;
-    validators.push(maxLengthValidator(cfg.value, cfg.message));
+    validators.push(maxLengthValidator(cfg.value, cfg.message ?? msg.maxLength(cfg.value)));
   }
   if (rules.pattern) {
     const cfg = rules.pattern instanceof RegExp ? {
       value: rules.pattern
     } : rules.pattern;
-    validators.push(patternValidator(cfg.value, cfg.message));
+    validators.push(patternValidator(cfg.value, cfg.message ?? msg.pattern));
   }
   if (rules.custom) {
     const customs = Array.isArray(rules.custom) ? rules.custom : [rules.custom];

package/lib/module/validation/validators.js.map

@@ -1 +1 @@
-{"version":3,"names":["EMAIL_REGEX","NUMBER_REGEX","PHONE_REGEX","isValidEmail","value","test","trim","isValidNumber","isValidPhone","requiredValidator","message","undefined","length","valid","emailValidator","numberValidator","phoneValidator","minLengthValidator","min","maxLengthValidator","max","patternValidator","pattern","runRules","rules","validators","required","push","email","number","minLength","cfg","maxLength","RegExp","custom","customs","Array","isArray","validate","result"],"sourceRoot":"../../../src","sources":["validation/validators.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["getValidationMessages","EMAIL_REGEX","NUMBER_REGEX","PHONE_REGEX","isValidEmail","value","test","trim","isValidNumber","isValidPhone","requiredValidator","message","undefined","length","valid","emailValidator","numberValidator","phoneValidator","minLengthValidator","min","maxLengthValidator","max","patternValidator","pattern","runRules","rules","messages","msg","validators","required","push","email","number","minLength","cfg","maxLength","RegExp","custom","customs","Array","isArray","validate","result"],"sourceRoot":"../../../src","sources":["validation/validators.ts"],"mappings":"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","ignoreList":[]}

package/lib/typescript/adapters/index.d.ts

@@ -0,0 +1,3 @@
+export { FieldFlowController, FieldFlowTagsController, mapRhfToFieldFlowProps, } from './reactHookForm';
+export type { FieldFlowControllerProps, FieldFlowTagsControllerProps, } from './reactHookForm';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,iBAAiB,CAAC"}

package/lib/typescript/adapters/reactHookForm.d.ts

@@ -0,0 +1,56 @@
+import React from 'react';
+import { type Control, type ControllerProps, type FieldPath, type FieldValues, type RegisterOptions } from 'react-hook-form';
+import { type FieldFlowInputProps } from '../components/FieldFlowInput';
+import { type FieldFlowTagsProps } from '../components/FieldFlowTags';
+type InputPassthrough = Omit<FieldFlowInputProps, 'value' | 'defaultValue' | 'onChangeText' | 'onBlur' | 'onFocus' | 'errorText' | 'hasError' | 'rules'>;
+export interface FieldFlowControllerProps<TFieldValues extends FieldValues = FieldValues, TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>> extends InputPassthrough {
+    control: Control<TFieldValues>;
+    name: TName;
+    /** react-hook-form register/controller rules. */
+    rules?: RegisterOptions<TFieldValues, TName>;
+    defaultValue?: ControllerProps<TFieldValues, TName>['defaultValue'];
+    /** When true, show the field error message from RHF. Default: true. */
+    showError?: boolean;
+}
+/**
+ * Drop-in `Controller` wrapper that renders a themed `FieldFlowInput`
+ * wired to react-hook-form. Requires the optional `react-hook-form` peer.
+ *
+ * @example
+ * const { control, handleSubmit } = useForm({ defaultValues: { email: '' } });
+ *
+ * <FieldFlowController
+ *   control={control}
+ *   name="email"
+ *   type="email"
+ *   label="Email"
+ *   rules={{ required: 'Email is required' }}
+ *   suggestions
+ * />
+ */
+export declare function FieldFlowController<TFieldValues extends FieldValues = FieldValues, TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>>({ control, name, rules, defaultValue, showError, ...inputProps }: FieldFlowControllerProps<TFieldValues, TName>): React.JSX.Element;
+type TagsPassthrough = Omit<FieldFlowTagsProps, 'value' | 'onChange' | 'errorText' | 'hasError'>;
+export interface FieldFlowTagsControllerProps<TFieldValues extends FieldValues = FieldValues, TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>> extends TagsPassthrough {
+    control: Control<TFieldValues>;
+    name: TName;
+    rules?: RegisterOptions<TFieldValues, TName>;
+    defaultValue?: ControllerProps<TFieldValues, TName>['defaultValue'];
+    showError?: boolean;
+}
+/**
+ * RHF `Controller` for `FieldFlowTags` (string[] values).
+ */
+export declare function FieldFlowTagsController<TFieldValues extends FieldValues = FieldValues, TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>>({ control, name, rules, defaultValue, showError, ...tagsProps }: FieldFlowTagsControllerProps<TFieldValues, TName>): React.JSX.Element;
+/**
+ * Map an RHF `field` + `fieldState` onto common FieldFlow input props.
+ * Useful when you need a custom render or a non-input FieldFlow component.
+ */
+export declare function mapRhfToFieldFlowProps(args: {
+    value: unknown;
+    onChange: (...event: any[]) => void;
+    onBlur: () => void;
+    errorMessage?: string;
+    showError?: boolean;
+}): Pick<FieldFlowInputProps, 'value' | 'onChangeText' | 'onBlur' | 'errorText' | 'hasError'>;
+export {};
+//# sourceMappingURL=reactHookForm.d.ts.map

package/lib/typescript/adapters/reactHookForm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactHookForm.d.ts","sourceRoot":"","sources":["../../../src/adapters/reactHookForm.tsx"],"names":[],"mappings":"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"}