rn-inputforge 0.4.0 → 0.5.0

package/lib/module/hooks/useFormIntelligence.js

@@ -0,0 +1,126 @@
+"use strict";
+
+import { useCallback, useMemo, useRef } from 'react';
+import { announceForAccessibility, buildValidationAnnouncement, focusFirstError } from '../intelligence/formAccessibility';
+function emptyStats() {
+  return {
+    focusCount: 0,
+    totalFocusMs: 0,
+    errorCount: 0,
+    changeCount: 0,
+    blurCount: 0
+  };
+}
+/**
+ * Tracks per-field friction and runs accessibility autopilot on failed validation.
+ * Designed to plug into `useFieldFlowForm({ intelligence: true })` or be used standalone.
+ */
+export function useFormIntelligence(options = {}) {
+  const {
+    onReport,
+    focusFirstError: shouldFocus = true,
+    announceErrors = true
+  } = options;
+  const sessionStartedAt = useRef(Date.now());
+  const statsRef = useRef({});
+  const refsRef = useRef({});
+  const submitAttempts = useRef(0);
+  const successfulSubmits = useRef(0);
+  const ensure = useCallback(field => {
+    const key = String(field);
+    if (!statsRef.current[key]) statsRef.current[key] = emptyStats();
+    return statsRef.current[key];
+  }, []);
+  const registerFieldRef = useCallback((field, ref) => {
+    refsRef.current[field] = ref;
+  }, []);
+  const trackFocus = useCallback(field => {
+    const s = ensure(field);
+    s.focusCount += 1;
+    s.focusStartedAt = Date.now();
+    s.lastFocusedAt = s.focusStartedAt;
+  }, [ensure]);
+  const trackBlur = useCallback(field => {
+    const s = ensure(field);
+    s.blurCount += 1;
+    if (s.focusStartedAt) {
+      s.totalFocusMs += Date.now() - s.focusStartedAt;
+      s.focusStartedAt = undefined;
+    }
+  }, [ensure]);
+  const trackChange = useCallback(field => {
+    ensure(field).changeCount += 1;
+  }, [ensure]);
+  const trackError = useCallback(field => {
+    ensure(field).errorCount += 1;
+  }, [ensure]);
+  const buildReport = useCallback(() => {
+    const fields = {
+      ...statsRef.current
+    };
+    // Close any open focus sessions for accurate totals
+    const now = Date.now();
+    for (const s of Object.values(fields)) {
+      if (s.focusStartedAt) {
+        s.totalFocusMs += now - s.focusStartedAt;
+        s.focusStartedAt = undefined;
+      }
+    }
+    const mostFriction = Object.entries(fields).map(([field, s]) => ({
+      field,
+      score: s.errorCount * 3 + s.focusCount + Math.floor(s.changeCount / 10) + Math.floor(s.totalFocusMs / 5000)
+    })).sort((a, b) => b.score - a.score);
+    return {
+      sessionMs: now - sessionStartedAt.current,
+      submitAttempts: submitAttempts.current,
+      successfulSubmits: successfulSubmits.current,
+      fields,
+      mostFriction,
+      generatedAt: now
+    };
+  }, []);
+  const onValidationResult = useCallback((valid, errors, fieldOrder) => {
+    submitAttempts.current += 1;
+    for (const [field, message] of Object.entries(errors)) {
+      if (message) trackError(field);
+    }
+    if (!valid) {
+      if (shouldFocus) {
+        focusFirstError(errors, refsRef.current, fieldOrder);
+      }
+      if (announceErrors) {
+        announceForAccessibility(buildValidationAnnouncement(errors));
+      }
+    }
+    onReport?.(buildReport());
+  }, [announceErrors, buildReport, onReport, shouldFocus, trackError]);
+  const trackSubmitSuccess = useCallback(() => {
+    successfulSubmits.current += 1;
+    onReport?.(buildReport());
+  }, [buildReport, onReport]);
+  const getReport = useCallback(() => buildReport(), [buildReport]);
+  const flush = useCallback(() => {
+    const report = buildReport();
+    onReport?.(report);
+    return report;
+  }, [buildReport, onReport]);
+  const reset = useCallback(() => {
+    statsRef.current = {};
+    submitAttempts.current = 0;
+    successfulSubmits.current = 0;
+    sessionStartedAt.current = Date.now();
+  }, []);
+  return useMemo(() => ({
+    registerFieldRef,
+    trackFocus,
+    trackBlur,
+    trackChange,
+    trackError,
+    onValidationResult,
+    trackSubmitSuccess,
+    getReport,
+    flush,
+    reset
+  }), [registerFieldRef, trackFocus, trackBlur, trackChange, trackError, onValidationResult, trackSubmitSuccess, getReport, flush, reset]);
+}
+//# sourceMappingURL=useFormIntelligence.js.map

package/lib/module/hooks/useFormIntelligence.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useMemo","useRef","announceForAccessibility","buildValidationAnnouncement","focusFirstError","emptyStats","focusCount","totalFocusMs","errorCount","changeCount","blurCount","useFormIntelligence","options","onReport","shouldFocus","announceErrors","sessionStartedAt","Date","now","statsRef","refsRef","submitAttempts","successfulSubmits","ensure","field","key","String","current","registerFieldRef","ref","trackFocus","s","focusStartedAt","lastFocusedAt","trackBlur","undefined","trackChange","trackError","buildReport","fields","Object","values","mostFriction","entries","map","score","Math","floor","sort","a","b","sessionMs","generatedAt","onValidationResult","valid","errors","fieldOrder","message","trackSubmitSuccess","getReport","flush","report","reset"],"sourceRoot":"../../../src","sources":["hooks/useFormIntelligence.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/i18n/index.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export { validationMessageCatalogs, getValidationMessages, createValidationMessages } from './messages';
+//# sourceMappingURL=index.js.map

package/lib/module/i18n/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["validationMessageCatalogs","getValidationMessages","createValidationMessages"],"sourceRoot":"../../../src","sources":["i18n/index.ts"],"mappings":";;AAAA,SACEA,yBAAyB,EACzBC,qBAAqB,EACrBC,wBAAwB,QACnB,YAAY","ignoreList":[]}

package/lib/module/i18n/messages.js

@@ -0,0 +1,82 @@
+"use strict";
+
+const en = {
+  required: 'This field is required',
+  email: 'Enter a valid email address',
+  number: 'Enter a valid number',
+  phone: 'Enter a valid phone number',
+  minLength: min => `Must be at least ${min} characters`,
+  maxLength: max => `Must be at most ${max} characters`,
+  pattern: 'Invalid format',
+  invalid: 'Invalid'
+};
+const es = {
+  required: 'Este campo es obligatorio',
+  email: 'Introduce un correo válido',
+  number: 'Introduce un número válido',
+  phone: 'Introduce un teléfono válido',
+  minLength: min => `Debe tener al menos ${min} caracteres`,
+  maxLength: max => `Debe tener como máximo ${max} caracteres`,
+  pattern: 'Formato no válido',
+  invalid: 'No válido'
+};
+const fr = {
+  required: 'Ce champ est obligatoire',
+  email: 'Entrez une adresse e-mail valide',
+  number: 'Entrez un nombre valide',
+  phone: 'Entrez un numéro de téléphone valide',
+  minLength: min => `Doit contenir au moins ${min} caractères`,
+  maxLength: max => `Doit contenir au plus ${max} caractères`,
+  pattern: 'Format invalide',
+  invalid: 'Invalide'
+};
+const de = {
+  required: 'Dieses Feld ist erforderlich',
+  email: 'Gültige E-Mail-Adresse eingeben',
+  number: 'Gültige Zahl eingeben',
+  phone: 'Gültige Telefonnummer eingeben',
+  minLength: min => `Mindestens ${min} Zeichen`,
+  maxLength: max => `Höchstens ${max} Zeichen`,
+  pattern: 'Ungültiges Format',
+  invalid: 'Ungültig'
+};
+const pt = {
+  required: 'Este campo é obrigatório',
+  email: 'Introduza um e-mail válido',
+  number: 'Introduza um número válido',
+  phone: 'Introduza um telefone válido',
+  minLength: min => `Deve ter pelo menos ${min} caracteres`,
+  maxLength: max => `Deve ter no máximo ${max} caracteres`,
+  pattern: 'Formato inválido',
+  invalid: 'Inválido'
+};
+const ar = {
+  required: 'هذا الحقل مطلوب',
+  email: 'أدخل بريداً إلكترونياً صالحاً',
+  number: 'أدخل رقماً صالحاً',
+  phone: 'أدخل رقم هاتف صالحاً',
+  minLength: min => `يجب أن يكون على الأقل ${min} أحرف`,
+  maxLength: max => `يجب أن يكون على الأكثر ${max} أحرف`,
+  pattern: 'تنسيق غير صالح',
+  invalid: 'غير صالح'
+};
+export const validationMessageCatalogs = {
+  en,
+  es,
+  fr,
+  de,
+  pt,
+  ar
+};
+export function getValidationMessages(locale = 'en') {
+  return validationMessageCatalogs[locale] ?? en;
+}
+
+/** Merge a partial catalog over a locale base (default English). */
+export function createValidationMessages(overrides, locale = 'en') {
+  return {
+    ...getValidationMessages(locale),
+    ...overrides
+  };
+}
+//# sourceMappingURL=messages.js.map

package/lib/module/i18n/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["en","required","email","number","phone","minLength","min","maxLength","max","pattern","invalid","es","fr","de","pt","ar","validationMessageCatalogs","getValidationMessages","locale","createValidationMessages","overrides"],"sourceRoot":"../../../src","sources":["i18n/messages.ts"],"mappings":";;AAaA,MAAMA,EAA+B,GAAG;EACtCC,QAAQ,EAAE,wBAAwB;EAClCC,KAAK,EAAE,6BAA6B;EACpCC,MAAM,EAAE,sBAAsB;EAC9BC,KAAK,EAAE,4BAA4B;EACnCC,SAAS,EAAEC,GAAG,IAAI,oBAAoBA,GAAG,aAAa;EACtDC,SAAS,EAAEC,GAAG,IAAI,mBAAmBA,GAAG,aAAa;EACrDC,OAAO,EAAE,gBAAgB;EACzBC,OAAO,EAAE;AACX,CAAC;AAED,MAAMC,EAA+B,GAAG;EACtCV,QAAQ,EAAE,2BAA2B;EACrCC,KAAK,EAAE,4BAA4B;EACnCC,MAAM,EAAE,4BAA4B;EACpCC,KAAK,EAAE,8BAA8B;EACrCC,SAAS,EAAEC,GAAG,IAAI,uBAAuBA,GAAG,aAAa;EACzDC,SAAS,EAAEC,GAAG,IAAI,0BAA0BA,GAAG,aAAa;EAC5DC,OAAO,EAAE,mBAAmB;EAC5BC,OAAO,EAAE;AACX,CAAC;AAED,MAAME,EAA+B,GAAG;EACtCX,QAAQ,EAAE,0BAA0B;EACpCC,KAAK,EAAE,kCAAkC;EACzCC,MAAM,EAAE,yBAAyB;EACjCC,KAAK,EAAE,sCAAsC;EAC7CC,SAAS,EAAEC,GAAG,IAAI,0BAA0BA,GAAG,aAAa;EAC5DC,SAAS,EAAEC,GAAG,IAAI,yBAAyBA,GAAG,aAAa;EAC3DC,OAAO,EAAE,iBAAiB;EAC1BC,OAAO,EAAE;AACX,CAAC;AAED,MAAMG,EAA+B,GAAG;EACtCZ,QAAQ,EAAE,8BAA8B;EACxCC,KAAK,EAAE,iCAAiC;EACxCC,MAAM,EAAE,uBAAuB;EAC/BC,KAAK,EAAE,gCAAgC;EACvCC,SAAS,EAAEC,GAAG,IAAI,cAAcA,GAAG,UAAU;EAC7CC,SAAS,EAAEC,GAAG,IAAI,aAAaA,GAAG,UAAU;EAC5CC,OAAO,EAAE,mBAAmB;EAC5BC,OAAO,EAAE;AACX,CAAC;AAED,MAAMI,EAA+B,GAAG;EACtCb,QAAQ,EAAE,0BAA0B;EACpCC,KAAK,EAAE,4BAA4B;EACnCC,MAAM,EAAE,4BAA4B;EACpCC,KAAK,EAAE,8BAA8B;EACrCC,SAAS,EAAEC,GAAG,IAAI,uBAAuBA,GAAG,aAAa;EACzDC,SAAS,EAAEC,GAAG,IAAI,sBAAsBA,GAAG,aAAa;EACxDC,OAAO,EAAE,kBAAkB;EAC3BC,OAAO,EAAE;AACX,CAAC;AAED,MAAMK,EAA+B,GAAG;EACtCd,QAAQ,EAAE,iBAAiB;EAC3BC,KAAK,EAAE,+BAA+B;EACtCC,MAAM,EAAE,mBAAmB;EAC3BC,KAAK,EAAE,sBAAsB;EAC7BC,SAAS,EAAEC,GAAG,IAAI,yBAAyBA,GAAG,OAAO;EACrDC,SAAS,EAAEC,GAAG,IAAI,0BAA0BA,GAAG,OAAO;EACtDC,OAAO,EAAE,gBAAgB;EACzBC,OAAO,EAAE;AACX,CAAC;AAED,OAAO,MAAMM,yBAA+E,GAAG;EAC7FhB,EAAE;EACFW,EAAE;EACFC,EAAE;EACFC,EAAE;EACFC,EAAE;EACFC;AACF,CAAC;AAED,OAAO,SAASE,qBAAqBA,CACnCC,MAAuB,GAAG,IAAI,EACD;EAC7B,OAAOF,yBAAyB,CAACE,MAAM,CAAC,IAAIlB,EAAE;AAChD;;AAEA;AACA,OAAO,SAASmB,wBAAwBA,CACtCC,SAA+C,EAC/CF,MAAuB,GAAG,IAAI,EACD;EAC7B,OAAO;IAAE,GAAGD,qBAAqB,CAACC,MAAM,CAAC;IAAE,GAAGE;EAAU,CAAC;AAC3D","ignoreList":[]}

package/lib/module/index.js

@@ -12,14 +12,43 @@ export { FieldFlowCheckbox } from './components/FieldFlowCheckbox';
 export { FieldFlowRadio } from './components/FieldFlowRadio';
 export { FieldFlowSwitch } from './components/FieldFlowSwitch';
 export { FieldFlowDateTimePicker } from './components/FieldFlowDateTimePicker';
+export { FieldFlowAffordance } from './components/FieldFlowAffordance';
+export { FieldFlowDraftBanner } from './components/FieldFlowDraftBanner';
+export { FieldFlowTags } from './components/FieldFlowTags';
+export { FieldFlowPasswordStrength } from './components/FieldFlowPasswordStrength';
+export { FieldFlowSection } from './components/FieldFlowSection';
+export { FieldFlowSegmented } from './components/FieldFlowSegmented';
+export { FieldFlowStepper } from './components/FieldFlowStepper';
+export { FieldFlowPhone } from './components/FieldFlowPhone';
+export { FieldFlowUpload } from './components/FieldFlowUpload';
+export { FieldFlowTypeahead } from './components/FieldFlowTypeahead';
+export { FieldFlowRating } from './components/FieldFlowRating';
+export { FieldFlowSlider } from './components/FieldFlowSlider';
+export { FieldFlowNumberStepper } from './components/FieldFlowNumberStepper';
+export { FieldFlowCreditCard } from './components/FieldFlowCreditCard';
+export { FieldFlowSignature } from './components/FieldFlowSignature';
+// Adapters (optional peers: react-hook-form)
+export { FieldFlowController, FieldFlowTagsController, mapRhfToFieldFlowProps } from './adapters';
 // Theming
-export { FieldFlowThemeProvider, useFieldFlowTheme, defaultTheme, darkTheme } from './theme';
+export { FieldFlowThemeProvider, useFieldFlowTheme, defaultTheme, darkTheme, themePresets, getThemePreset } from './theme';
+// Motion
+export { useFieldMotion, useReducedMotion } from './motion';
 // Hooks
-export { useFieldFlowForm, useKeyboardManager, useFieldState } from './hooks';
+export { useFieldFlowForm, useKeyboardManager, useFieldState, useFormIntelligence, useFieldFlowArray, useFieldFlowDraft, useFieldFlowSteps, useFieldFlowDirtyGuard } from './hooks';
+// i18n
+export { validationMessageCatalogs, getValidationMessages, createValidationMessages } from './i18n';
+// Phone helpers
+export { DEFAULT_COUNTRY_DIALS, findCountryByCode, composeE164 } from './utils/phoneCountries';
 // Validation
 export { useValidation, runRules, isValidEmail, isValidNumber, isValidPhone, requiredValidator, emailValidator, numberValidator, phoneValidator, minLengthValidator, maxLengthValidator, patternValidator, zodToFormErrors, zodFormValidate, createZodSubmitGuard, fieldRulesFromZodString } from './validation';
 // Masks
 export { applyMask, applyPattern, formatMasked, unmask, digitsOnly, applyPhoneMask, applyCardMask, applyDateMask, applyCurrencyMask } from './utils/masks';
+// Affordance helpers
+export { applyEmailDomainSuggestion, applyPhoneDialSuggestion, applyCurrencySymbolSuggestion, applyAffordanceSuggestion, resolveAffordanceChips, emailDomainsToChips, affordanceKindFromFieldType, DEFAULT_EMAIL_DOMAINS, DEFAULT_PHONE_DIAL_CODES, DEFAULT_CURRENCY_SYMBOLS } from './utils/affordance';
+// Password strength
+export { evaluatePasswordStrength, DEFAULT_PASSWORD_RULES, PASSWORD_STRENGTH_COLORS } from './utils/passwordStrength';
+// Form intelligence / a11y
+export { focusFirstError, announceForAccessibility, buildValidationAnnouncement, setAccessibilityFocus } from './intelligence';
 // Icons
 export { FieldFlowIcon, renderFieldFlowIcon } from './icons';
 

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["FieldFlowInput","DescriptionField","ChatInput","KeyboardAwareFormWrapper","FieldFlowDropdown","FieldFlowOTP","FieldFlowMaskedInput","FieldFlowCheckbox","FieldFlowRadio","FieldFlowSwitch","FieldFlowDateTimePicker","FieldFlowThemeProvider","useFieldFlowTheme","defaultTheme","darkTheme","useFieldFlowForm","useKeyboardManager","useFieldState","useValidation","runRules","isValidEmail","isValidNumber","isValidPhone","requiredValidator","emailValidator","numberValidator","phoneValidator","minLengthValidator","maxLengthValidator","patternValidator","zodToFormErrors","zodFormValidate","createZodSubmitGuard","fieldRulesFromZodString","applyMask","applyPattern","formatMasked","unmask","digitsOnly","applyPhoneMask","applyCardMask","applyDateMask","applyCurrencyMask","FieldFlowIcon","renderFieldFlowIcon"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA;AACA,SAASA,cAAc,QAAQ,6BAA6B;AAG5D,SAASC,gBAAgB,QAAQ,+BAA+B;AAGhE,SAASC,SAAS,QAAQ,wBAAwB;AAGlD,SAASC,wBAAwB,QAAQ,uCAAuC;AAGhF,SAASC,iBAAiB,QAAQ,gCAAgC;AAQlE,SAASC,YAAY,QAAQ,2BAA2B;AAGxD,SAASC,oBAAoB,QAAQ,mCAAmC;AAGxE,SAASC,iBAAiB,QAAQ,gCAAgC;AAGlE,SAASC,cAAc,QAAQ,6BAA6B;AAG5D,SAASC,eAAe,QAAQ,8BAA8B;AAG9D,SAASC,uBAAuB,QAAQ,sCAAsC;AAM9E;AACA,SAASC,sBAAsB,EAAEC,iBAAiB,EAAEC,YAAY,EAAEC,SAAS,QAAQ,SAAS;AAG5F;AACA,SAASC,gBAAgB,EAAEC,kBAAkB,EAAEC,aAAa,QAAQ,SAAS;AAa7E;AACA,SACEC,aAAa,EACbC,QAAQ,EACRC,YAAY,EACZC,aAAa,EACbC,YAAY,EACZC,iBAAiB,EACjBC,cAAc,EACdC,eAAe,EACfC,cAAc,EACdC,kBAAkB,EAClBC,kBAAkB,EAClBC,gBAAgB,EAChBC,eAAe,EACfC,eAAe,EACfC,oBAAoB,EACpBC,uBAAuB,QAClB,cAAc;AAGrB;AACA,SACEC,SAAS,EACTC,YAAY,EACZC,YAAY,EACZC,MAAM,EACNC,UAAU,EACVC,cAAc,EACdC,aAAa,EACbC,aAAa,EACbC,iBAAiB,QACZ,eAAe;AAGtB;AACA,SAASC,aAAa,EAAEC,mBAAmB,QAAQ,SAAS;;AAG5D","ignoreList":[]}
+{"version":3,"names":["FieldFlowInput","DescriptionField","ChatInput","KeyboardAwareFormWrapper","FieldFlowDropdown","FieldFlowOTP","FieldFlowMaskedInput","FieldFlowCheckbox","FieldFlowRadio","FieldFlowSwitch","FieldFlowDateTimePicker","FieldFlowAffordance","FieldFlowDraftBanner","FieldFlowTags","FieldFlowPasswordStrength","FieldFlowSection","FieldFlowSegmented","FieldFlowStepper","FieldFlowPhone","FieldFlowUpload","FieldFlowTypeahead","FieldFlowRating","FieldFlowSlider","FieldFlowNumberStepper","FieldFlowCreditCard","FieldFlowSignature","FieldFlowController","FieldFlowTagsController","mapRhfToFieldFlowProps","FieldFlowThemeProvider","useFieldFlowTheme","defaultTheme","darkTheme","themePresets","getThemePreset","useFieldMotion","useReducedMotion","useFieldFlowForm","useKeyboardManager","useFieldState","useFormIntelligence","useFieldFlowArray","useFieldFlowDraft","useFieldFlowSteps","useFieldFlowDirtyGuard","validationMessageCatalogs","getValidationMessages","createValidationMessages","DEFAULT_COUNTRY_DIALS","findCountryByCode","composeE164","useValidation","runRules","isValidEmail","isValidNumber","isValidPhone","requiredValidator","emailValidator","numberValidator","phoneValidator","minLengthValidator","maxLengthValidator","patternValidator","zodToFormErrors","zodFormValidate","createZodSubmitGuard","fieldRulesFromZodString","applyMask","applyPattern","formatMasked","unmask","digitsOnly","applyPhoneMask","applyCardMask","applyDateMask","applyCurrencyMask","applyEmailDomainSuggestion","applyPhoneDialSuggestion","applyCurrencySymbolSuggestion","applyAffordanceSuggestion","resolveAffordanceChips","emailDomainsToChips","affordanceKindFromFieldType","DEFAULT_EMAIL_DOMAINS","DEFAULT_PHONE_DIAL_CODES","DEFAULT_CURRENCY_SYMBOLS","evaluatePasswordStrength","DEFAULT_PASSWORD_RULES","PASSWORD_STRENGTH_COLORS","focusFirstError","announceForAccessibility","buildValidationAnnouncement","setAccessibilityFocus","FieldFlowIcon","renderFieldFlowIcon"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA;AACA,SAASA,cAAc,QAAQ,6BAA6B;AAG5D,SAASC,gBAAgB,QAAQ,+BAA+B;AAGhE,SAASC,SAAS,QAAQ,wBAAwB;AAGlD,SAASC,wBAAwB,QAAQ,uCAAuC;AAGhF,SAASC,iBAAiB,QAAQ,gCAAgC;AAQlE,SAASC,YAAY,QAAQ,2BAA2B;AAGxD,SAASC,oBAAoB,QAAQ,mCAAmC;AAGxE,SAASC,iBAAiB,QAAQ,gCAAgC;AAGlE,SAASC,cAAc,QAAQ,6BAA6B;AAG5D,SAASC,eAAe,QAAQ,8BAA8B;AAG9D,SAASC,uBAAuB,QAAQ,sCAAsC;AAM9E,SAASC,mBAAmB,QAAQ,kCAAkC;AAGtE,SAASC,oBAAoB,QAAQ,mCAAmC;AAGxE,SAASC,aAAa,QAAQ,4BAA4B;AAG1D,SAASC,yBAAyB,QAAQ,wCAAwC;AAGlF,SAASC,gBAAgB,QAAQ,+BAA+B;AAGhE,SAASC,kBAAkB,QAAQ,iCAAiC;AAGpE,SAASC,gBAAgB,QAAQ,+BAA+B;AAGhE,SAASC,cAAc,QAAQ,6BAA6B;AAG5D,SAASC,eAAe,QAAQ,8BAA8B;AAO9D,SAASC,kBAAkB,QAAQ,iCAAiC;AAGpE,SAASC,eAAe,QAAQ,8BAA8B;AAG9D,SAASC,eAAe,QAAQ,8BAA8B;AAG9D,SAASC,sBAAsB,QAAQ,qCAAqC;AAG5E,SAASC,mBAAmB,QAAQ,kCAAkC;AAGtE,SAASC,kBAAkB,QAAQ,iCAAiC;AAQpE;AACA,SACEC,mBAAmB,EACnBC,uBAAuB,EACvBC,sBAAsB,QACjB,YAAY;AAMnB;AACA,SACEC,sBAAsB,EACtBC,iBAAiB,EACjBC,YAAY,EACZC,SAAS,EACTC,YAAY,EACZC,cAAc,QACT,SAAS;AAGhB;AACA,SAASC,cAAc,EAAEC,gBAAgB,QAAQ,UAAU;AAG3D;AACA,SACEC,gBAAgB,EAChBC,kBAAkB,EAClBC,aAAa,EACbC,mBAAmB,EACnBC,iBAAiB,EACjBC,iBAAiB,EACjBC,iBAAiB,EACjBC,sBAAsB,QACjB,SAAS;AA6BhB;AACA,SACEC,yBAAyB,EACzBC,qBAAqB,EACrBC,wBAAwB,QACnB,QAAQ;AAGf;AACA,SACEC,qBAAqB,EACrBC,iBAAiB,EACjBC,WAAW,QACN,wBAAwB;AAG/B;AACA,SACEC,aAAa,EACbC,QAAQ,EACRC,YAAY,EACZC,aAAa,EACbC,YAAY,EACZC,iBAAiB,EACjBC,cAAc,EACdC,eAAe,EACfC,cAAc,EACdC,kBAAkB,EAClBC,kBAAkB,EAClBC,gBAAgB,EAChBC,eAAe,EACfC,eAAe,EACfC,oBAAoB,EACpBC,uBAAuB,QAClB,cAAc;AAGrB;AACA,SACEC,SAAS,EACTC,YAAY,EACZC,YAAY,EACZC,MAAM,EACNC,UAAU,EACVC,cAAc,EACdC,aAAa,EACbC,aAAa,EACbC,iBAAiB,QACZ,eAAe;AAGtB;AACA,SACEC,0BAA0B,EAC1BC,wBAAwB,EACxBC,6BAA6B,EAC7BC,yBAAyB,EACzBC,sBAAsB,EACtBC,mBAAmB,EACnBC,2BAA2B,EAC3BC,qBAAqB,EACrBC,wBAAwB,EACxBC,wBAAwB,QACnB,oBAAoB;AAG3B;AACA,SACEC,wBAAwB,EACxBC,sBAAsB,EACtBC,wBAAwB,QACnB,0BAA0B;AAOjC;AACA,SACEC,eAAe,EACfC,wBAAwB,EACxBC,2BAA2B,EAC3BC,qBAAqB,QAChB,gBAAgB;AAQvB;AACA,SAASC,aAAa,EAAEC,mBAAmB,QAAQ,SAAS;;AAG5D","ignoreList":[]}

package/lib/module/intelligence/formAccessibility.js

@@ -0,0 +1,72 @@
+"use strict";
+
+import { AccessibilityInfo, findNodeHandle } from 'react-native';
+function resolveNode(ref) {
+  if (!ref) return null;
+  if (typeof ref === 'object' && 'current' in ref) return ref.current ?? null;
+  return ref;
+}
+
+/**
+ * Focus the first field (in `order` or object key order) that has an error.
+ * Returns the field key that was focused, or `undefined` if none.
+ */
+export function focusFirstError(errors, refs, order) {
+  const keys = order ?? Object.keys(errors);
+  for (const key of keys) {
+    if (!errors[key]) continue;
+    const node = resolveNode(refs[key]);
+    if (node && typeof node.focus === 'function') {
+      node.focus();
+      return key;
+    }
+  }
+  // Fallback: any field with an error that has a ref, even if not in order
+  for (const key of Object.keys(errors)) {
+    if (!errors[key]) continue;
+    const node = resolveNode(refs[key]);
+    if (node && typeof node.focus === 'function') {
+      node.focus();
+      return key;
+    }
+  }
+  return undefined;
+}
+
+/** Announce a short message to VoiceOver / TalkBack when available. */
+export function announceForAccessibility(message) {
+  if (!message) return;
+  try {
+    AccessibilityInfo.announceForAccessibility(message);
+  } catch {
+    // Older RN / platforms without announce support — silently ignore.
+  }
+}
+
+/**
+ * Build a concise announcement for failed validation, e.g.
+ * "Form has 2 errors. Email is required."
+ */
+export function buildValidationAnnouncement(errors) {
+  const entries = Object.entries(errors).filter(([, msg]) => Boolean(msg));
+  if (entries.length === 0) return '';
+  const [firstField, firstMessage] = entries[0];
+  if (entries.length === 1) {
+    return `${formatFieldName(firstField)}: ${firstMessage}`;
+  }
+  return `Form has ${entries.length} errors. ${formatFieldName(firstField)}: ${firstMessage}`;
+}
+function formatFieldName(field) {
+  return field.replace(/([A-Z])/g, ' $1').replace(/[_-]/g, ' ').replace(/^\w/, c => c.toUpperCase()).trim();
+}
+
+/** Best-effort: mark a native view as accessibility-focused (Android). */
+export function setAccessibilityFocus(ref) {
+  const node = resolveNode(ref);
+  if (!node) return;
+  const handle = findNodeHandle(node);
+  if (handle != null) {
+    AccessibilityInfo.setAccessibilityFocus?.(handle);
+  }
+}
+//# sourceMappingURL=formAccessibility.js.map

package/lib/module/intelligence/formAccessibility.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["AccessibilityInfo","findNodeHandle","resolveNode","ref","current","focusFirstError","errors","refs","order","keys","Object","key","node","focus","undefined","announceForAccessibility","message","buildValidationAnnouncement","entries","filter","msg","Boolean","length","firstField","firstMessage","formatFieldName","field","replace","c","toUpperCase","trim","setAccessibilityFocus","handle"],"sourceRoot":"../../../src","sources":["intelligence/formAccessibility.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/intelligence/index.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export { focusFirstError, announceForAccessibility, buildValidationAnnouncement, setAccessibilityFocus } from './formAccessibility';
+//# sourceMappingURL=index.js.map

package/lib/module/intelligence/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["focusFirstError","announceForAccessibility","buildValidationAnnouncement","setAccessibilityFocus"],"sourceRoot":"../../../src","sources":["intelligence/index.ts"],"mappings":";;AAAA,SACEA,eAAe,EACfC,wBAAwB,EACxBC,2BAA2B,EAC3BC,qBAAqB,QAChB,qBAAqB","ignoreList":[]}

package/lib/module/intelligence/types.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=types.js.map

package/lib/module/intelligence/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["intelligence/types.ts"],"mappings":"","ignoreList":[]}

package/lib/module/motion/index.js

@@ -0,0 +1,5 @@
+"use strict";
+
+export { useReducedMotion } from './useReducedMotion';
+export { useFieldMotion } from './useFieldMotion';
+//# sourceMappingURL=index.js.map

package/lib/module/motion/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useReducedMotion","useFieldMotion"],"sourceRoot":"../../../src","sources":["motion/index.ts"],"mappings":";;AAAA,SAASA,gBAAgB,QAAQ,oBAAoB;AACrD,SAASC,cAAc,QAAQ,kBAAkB","ignoreList":[]}

package/lib/module/motion/useFieldMotion.js

@@ -0,0 +1,107 @@
+"use strict";
+
+import { useEffect, useMemo, useRef } from 'react';
+import { Animated, Easing } from 'react-native';
+import { useReducedMotion } from './useReducedMotion';
+/**
+ * Field micro-interactions: error shake, focus glow, message cross-fade, success pop.
+ * Uses RN Animated only (no Reanimated) and respects Reduce Motion.
+ */
+export function useFieldMotion({
+  enabled = true,
+  isFocused,
+  hasError,
+  isSuccess,
+  duration = 180
+}) {
+  const reducedMotion = useReducedMotion();
+  const active = enabled && !reducedMotion;
+  const shake = useRef(new Animated.Value(0)).current;
+  const glowOpacity = useRef(new Animated.Value(0)).current;
+  const messageOpacity = useRef(new Animated.Value(1)).current;
+  const successScale = useRef(new Animated.Value(1)).current;
+  const prevError = useRef(hasError);
+
+  // Focus glow
+  useEffect(() => {
+    if (!active) {
+      glowOpacity.setValue(isFocused ? 0.35 : 0);
+      return;
+    }
+    Animated.timing(glowOpacity, {
+      toValue: isFocused ? 1 : 0,
+      duration,
+      easing: Easing.out(Easing.cubic),
+      useNativeDriver: true
+    }).start();
+  }, [active, isFocused, glowOpacity, duration]);
+
+  // Error shake when error turns on
+  useEffect(() => {
+    const justErrored = hasError && !prevError.current;
+    prevError.current = hasError;
+    if (!justErrored) return;
+    if (!active) return;
+    shake.setValue(0);
+    Animated.sequence([Animated.timing(shake, {
+      toValue: 1,
+      duration: 40,
+      useNativeDriver: true
+    }), Animated.timing(shake, {
+      toValue: -1,
+      duration: 40,
+      useNativeDriver: true
+    }), Animated.timing(shake, {
+      toValue: 1,
+      duration: 40,
+      useNativeDriver: true
+    }), Animated.timing(shake, {
+      toValue: -1,
+      duration: 40,
+      useNativeDriver: true
+    }), Animated.timing(shake, {
+      toValue: 0,
+      duration: 40,
+      useNativeDriver: true
+    })]).start();
+    messageOpacity.setValue(0);
+    Animated.timing(messageOpacity, {
+      toValue: 1,
+      duration: duration + 40,
+      easing: Easing.out(Easing.cubic),
+      useNativeDriver: true
+    }).start();
+  }, [hasError, active, shake, messageOpacity, duration]);
+
+  // Success pop
+  useEffect(() => {
+    if (!isSuccess) {
+      successScale.setValue(1);
+      return;
+    }
+    if (!active) return;
+    successScale.setValue(0.6);
+    Animated.spring(successScale, {
+      toValue: 1,
+      friction: 5,
+      tension: 140,
+      useNativeDriver: true
+    }).start();
+  }, [isSuccess, active, successScale]);
+  const translateX = shake.interpolate({
+    inputRange: [-1, 0, 1],
+    outputRange: [-6, 0, 6]
+  });
+  return useMemo(() => ({
+    containerStyle: {
+      transform: [{
+        translateX
+      }]
+    },
+    glowOpacity,
+    messageOpacity,
+    successScale,
+    reducedMotion
+  }), [translateX, glowOpacity, messageOpacity, successScale, reducedMotion]);
+}
+//# sourceMappingURL=useFieldMotion.js.map

package/lib/module/motion/useFieldMotion.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useEffect","useMemo","useRef","Animated","Easing","useReducedMotion","useFieldMotion","enabled","isFocused","hasError","isSuccess","duration","reducedMotion","active","shake","Value","current","glowOpacity","messageOpacity","successScale","prevError","setValue","timing","toValue","easing","out","cubic","useNativeDriver","start","justErrored","sequence","spring","friction","tension","translateX","interpolate","inputRange","outputRange","containerStyle","transform"],"sourceRoot":"../../../src","sources":["motion/useFieldMotion.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/motion/useReducedMotion.js

@@ -0,0 +1,29 @@
+"use strict";
+
+import { useEffect, useState } from 'react';
+import { AccessibilityInfo } from 'react-native';
+
+/**
+ * Tracks the OS “Reduce Motion” preference so FieldFlow can skip decorative animation.
+ */
+export function useReducedMotion() {
+  const [reduced, setReduced] = useState(false);
+  useEffect(() => {
+    let mounted = true;
+    AccessibilityInfo.isReduceMotionEnabled?.().then(value => {
+      if (mounted) setReduced(Boolean(value));
+    }).catch(() => {
+      /* older RN */
+    });
+    const sub = AccessibilityInfo.addEventListener?.('reduceMotionChanged', setReduced);
+    return () => {
+      mounted = false;
+      // RN versions differ: subscription may be `{ remove }` or a legacy remover fn
+      if (sub && typeof sub.remove === 'function') {
+        sub.remove();
+      }
+    };
+  }, []);
+  return reduced;
+}
+//# sourceMappingURL=useReducedMotion.js.map

package/lib/module/motion/useReducedMotion.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useEffect","useState","AccessibilityInfo","useReducedMotion","reduced","setReduced","mounted","isReduceMotionEnabled","then","value","Boolean","catch","sub","addEventListener","remove"],"sourceRoot":"../../../src","sources":["motion/useReducedMotion.ts"],"mappings":";;AAAA,SAASA,SAAS,EAAEC,QAAQ,QAAQ,OAAO;AAC3C,SAASC,iBAAiB,QAAQ,cAAc;;AAEhD;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAAA,EAAY;EAC1C,MAAM,CAACC,OAAO,EAAEC,UAAU,CAAC,GAAGJ,QAAQ,CAAC,KAAK,CAAC;EAE7CD,SAAS,CAAC,MAAM;IACd,IAAIM,OAAO,GAAG,IAAI;IAClBJ,iBAAiB,CAACK,qBAAqB,GAAG,CAAC,CACxCC,IAAI,CAACC,KAAK,IAAI;MACb,IAAIH,OAAO,EAAED,UAAU,CAACK,OAAO,CAACD,KAAK,CAAC,CAAC;IACzC,CAAC,CAAC,CACDE,KAAK,CAAC,MAAM;MACX;IAAA,CACD,CAAC;IAEJ,MAAMC,GAAG,GAAGV,iBAAiB,CAACW,gBAAgB,GAAG,qBAAqB,EAAER,UAAU,CAAC;IACnF,OAAO,MAAM;MACXC,OAAO,GAAG,KAAK;MACf;MACA,IAAIM,GAAG,IAAI,OAAQA,GAAG,CAA6BE,MAAM,KAAK,UAAU,EAAE;QACvEF,GAAG,CAA4BE,MAAM,CAAC,CAAC;MAC1C;IACF,CAAC;EACH,CAAC,EAAE,EAAE,CAAC;EAEN,OAAOV,OAAO;AAChB","ignoreList":[]}

package/lib/module/theme/index.js

@@ -2,4 +2,5 @@
 
 export { defaultTheme, darkTheme } from './defaultTheme';
 export { FieldFlowThemeProvider, useFieldFlowTheme, mergeDeep } from './ThemeProvider';
+export { themePresets, getThemePreset } from './presets';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"names":["defaultTheme","darkTheme","FieldFlowThemeProvider","useFieldFlowTheme","mergeDeep"],"sourceRoot":"../../../src","sources":["theme/index.ts"],"mappings":";;AAAA,SAASA,YAAY,EAAEC,SAAS,QAAQ,gBAAgB;AACxD,SAASC,sBAAsB,EAAEC,iBAAiB,EAAEC,SAAS,QAAQ,iBAAiB","ignoreList":[]}
+{"version":3,"names":["defaultTheme","darkTheme","FieldFlowThemeProvider","useFieldFlowTheme","mergeDeep","themePresets","getThemePreset"],"sourceRoot":"../../../src","sources":["theme/index.ts"],"mappings":";;AAAA,SAASA,YAAY,EAAEC,SAAS,QAAQ,gBAAgB;AACxD,SAASC,sBAAsB,EAAEC,iBAAiB,EAAEC,SAAS,QAAQ,iBAAiB;AAEtF,SAASC,YAAY,EAAEC,cAAc,QAAQ,WAAW","ignoreList":[]}