rn-inputforge 0.3.1 → 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":[]}