rn-inputforge 0.4.0 → 0.5.1

package/lib/module/hooks/useFieldFlowSubmitQueue.js

@@ -0,0 +1,141 @@
+"use strict";
+
+import { useCallback, useEffect, useRef, useState } from 'react';
+function createId() {
+  return `ffq_${Date.now()}_${Math.random().toString(36).slice(2, 9)}`;
+}
+
+/**
+ * Offline-friendly submit queue — persist failed / offline form posts and retry.
+ */
+export function useFieldFlowSubmitQueue({
+  key,
+  storage,
+  submit,
+  maxAttempts = 5,
+  flushOnOnline = true,
+  onSuccess,
+  onGiveUp
+}) {
+  const [queue, setQueue] = useState([]);
+  const [isFlushing, setIsFlushing] = useState(false);
+  const [isOnline, setIsOnline] = useState(true);
+  const queueRef = useRef(queue);
+  queueRef.current = queue;
+  const hydrated = useRef(false);
+  const persist = useCallback(async next => {
+    setQueue(next);
+    queueRef.current = next;
+    if (!storage) return;
+    if (next.length === 0) await storage.removeItem(key);else await storage.setItem(key, JSON.stringify(next));
+  }, [storage, key]);
+  useEffect(() => {
+    let cancelled = false;
+    (async () => {
+      if (!storage) {
+        hydrated.current = true;
+        return;
+      }
+      try {
+        const raw = await storage.getItem(key);
+        if (cancelled || !raw) {
+          hydrated.current = true;
+          return;
+        }
+        const parsed = JSON.parse(raw);
+        if (!cancelled && Array.isArray(parsed)) {
+          setQueue(parsed);
+          queueRef.current = parsed;
+        }
+      } catch {
+        /* ignore corrupt */
+      } finally {
+        hydrated.current = true;
+      }
+    })();
+    return () => {
+      cancelled = true;
+    };
+  }, [storage, key]);
+  useEffect(() => {
+    // NetInfo-free: use RN global if present, else assume online
+
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const NetInfo = globalThis.NetInfo;
+    if (!NetInfo?.addEventListener) return;
+    const sub = NetInfo.addEventListener(state => {
+      const online = state.isConnected !== false;
+      setIsOnline(online);
+    });
+    NetInfo.fetch?.().then(s => setIsOnline(s.isConnected !== false)).catch(() => undefined);
+    return () => sub?.remove();
+  }, []);
+  const flush = useCallback(async () => {
+    if (isFlushing) return;
+    setIsFlushing(true);
+    try {
+      let next = [...queueRef.current];
+      while (next.length > 0) {
+        const job = next[0];
+        try {
+          const result = await submit(job.payload);
+          if (result === false) throw new Error('Submit returned false');
+          onSuccess?.(job);
+          next = next.slice(1);
+          await persist(next);
+        } catch (err) {
+          const message = err instanceof Error ? err.message : 'Submit failed';
+          const updated = {
+            ...job,
+            attempts: job.attempts + 1,
+            lastError: message
+          };
+          if (updated.attempts >= maxAttempts) {
+            onGiveUp?.(updated);
+            next = next.slice(1);
+          } else {
+            next = [updated, ...next.slice(1)];
+          }
+          await persist(next);
+          break;
+        }
+      }
+    } finally {
+      setIsFlushing(false);
+    }
+  }, [isFlushing, submit, persist, maxAttempts, onSuccess, onGiveUp]);
+  useEffect(() => {
+    if (!flushOnOnline || !isOnline || !hydrated.current) return;
+    if (queueRef.current.length === 0) return;
+    void flush();
+  }, [isOnline, flushOnOnline, flush]);
+  const enqueue = useCallback(async payload => {
+    const id = createId();
+    const job = {
+      id,
+      payload,
+      createdAt: Date.now(),
+      attempts: 0
+    };
+    await persist([...queueRef.current, job]);
+    if (isOnline) void flush();
+    return id;
+  }, [persist, isOnline, flush]);
+  const clear = useCallback(async () => {
+    await persist([]);
+  }, [persist]);
+  const remove = useCallback(async id => {
+    await persist(queueRef.current.filter(j => j.id !== id));
+  }, [persist]);
+  return {
+    queue,
+    pendingCount: queue.length,
+    isFlushing,
+    isOnline,
+    enqueue,
+    flush,
+    clear,
+    remove
+  };
+}
+//# sourceMappingURL=useFieldFlowSubmitQueue.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useEffect","useRef","useState","createId","Date","now","Math","random","toString","slice","useFieldFlowSubmitQueue","key","storage","submit","maxAttempts","flushOnOnline","onSuccess","onGiveUp","queue","setQueue","isFlushing","setIsFlushing","isOnline","setIsOnline","queueRef","current","hydrated","persist","next","length","removeItem","setItem","JSON","stringify","cancelled","raw","getItem","parsed","parse","Array","isArray","NetInfo","globalThis","addEventListener","sub","state","online","isConnected","fetch","then","s","catch","undefined","remove","flush","job","result","payload","Error","err","message","updated","attempts","lastError","enqueue","id","createdAt","clear","filter","j","pendingCount"],"sourceRoot":"../../../src","sources":["hooks/useFieldFlowSubmitQueue.ts"],"mappings":"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","ignoreList":[]}

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/hooks/useKeyboardManager.js

@@ -47,6 +47,17 @@ export function useKeyboardManager({
       onSubmit?.();
     }
   }, [order, focusField, onSubmit]);
+  const focusPrevious = useCallback(id => {
+    const currentIndex = order.indexOf(id);
+    const prevId = order[currentIndex - 1];
+    if (prevId) focusField(prevId);
+  }, [order, focusField]);
+  const getFieldIndex = useCallback(id => order.indexOf(id), [order]);
+  const canGoPrevious = useCallback(id => order.indexOf(id) > 0, [order]);
+  const canGoNext = useCallback(id => {
+    const i = order.indexOf(id);
+    return i >= 0 && i < order.length - 1;
+  }, [order]);
   const getReturnKeyType = useCallback(id => {
     const isLast = order.indexOf(id) === order.length - 1;
     return isLast ? 'done' : 'next';
@@ -55,7 +66,11 @@ export function useKeyboardManager({
     registerField,
     unregisterField,
     focusNext,
+    focusPrevious,
     focusField,
+    getFieldIndex,
+    canGoPrevious,
+    canGoNext,
     scrollViewRef,
     getReturnKeyType,
     onSubmit: () => onSubmit?.()

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

@@ -1 +1 @@
-{"version":3,"names":["useCallback","useRef","useKeyboardManager","order","onSubmit","scrollOffset","fields","Map","scrollViewRef","registerField","id","ref","offsetY","current","set","unregisterField","delete","scrollToField","field","get","undefined","scrollTo","y","Math","max","animated","focusField","focus","focusNext","currentIndex","indexOf","nextId","blur","getReturnKeyType","isLast","length"],"sourceRoot":"../../../src","sources":["hooks/useKeyboardManager.ts"],"mappings":";;AAAA,SAASA,WAAW,EAAEC,MAAM,QAAQ,OAAO;AAgC3C;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,kBAAkBA,CAAC;EACjCC,KAAK;EACLC,QAAQ;EACRC,YAAY,GAAG;AACU,CAAC,EAA4B;EACtD,MAAMC,MAAM,GAAGL,MAAM,CAAoC,IAAIM,GAAG,CAAC,CAAC,CAAC;EACnE,MAAMC,aAAa,GAAGP,MAAM,CAAa,IAAI,CAAC;EAE9C,MAAMQ,aAAa,GAAGT,WAAW,CAAC,CAACU,EAAU,EAAEC,GAAsC,EAAEC,OAAgB,KAAK;IAC1GN,MAAM,CAACO,OAAO,CAACC,GAAG,CAACJ,EAAE,EAAE;MAAEC,GAAG;MAAEC;IAAQ,CAAC,CAAC;EAC1C,CAAC,EAAE,EAAE,CAAC;EAEN,MAAMG,eAAe,GAAGf,WAAW,CAAEU,EAAU,IAAK;IAClDJ,MAAM,CAACO,OAAO,CAACG,MAAM,CAACN,EAAE,CAAC;EAC3B,CAAC,EAAE,EAAE,CAAC;EAEN,MAAMO,aAAa,GAAGjB,WAAW,CAC9BU,EAAU,IAAK;IACd,MAAMQ,KAAK,GAAGZ,MAAM,CAACO,OAAO,CAACM,GAAG,CAACT,EAAE,CAAC;IACpC,IAAIQ,KAAK,EAAEN,OAAO,KAAKQ,SAAS,IAAIZ,aAAa,CAACK,OAAO,EAAE;MACzDL,aAAa,CAACK,OAAO,CAACQ,QAAQ,CAAC;QAAEC,CAAC,EAAEC,IAAI,CAACC,GAAG,CAAC,CAAC,EAAEN,KAAK,CAACN,OAAO,GAAGP,YAAY,CAAC;QAAEoB,QAAQ,EAAE;MAAK,CAAC,CAAC;IAClG;EACF,CAAC,EACD,CAACpB,YAAY,CACf,CAAC;EAED,MAAMqB,UAAU,GAAG1B,WAAW,CAC3BU,EAAU,IAAK;IACd,MAAMQ,KAAK,GAAGZ,MAAM,CAACO,OAAO,CAACM,GAAG,CAACT,EAAE,CAAC;IACpCQ,KAAK,EAAEP,GAAG,CAACE,OAAO,EAAEc,KAAK,CAAC,CAAC;IAC3BV,aAAa,CAACP,EAAE,CAAC;EACnB,CAAC,EACD,CAACO,aAAa,CAChB,CAAC;EAED,MAAMW,SAAS,GAAG5B,WAAW,CAC1BU,EAAU,IAAK;IACd,MAAMmB,YAAY,GAAG1B,KAAK,CAAC2B,OAAO,CAACpB,EAAE,CAAC;IACtC,MAAMqB,MAAM,GAAG5B,KAAK,CAAC0B,YAAY,GAAG,CAAC,CAAC;IACtC,IAAIE,MAAM,EAAE;MACVL,UAAU,CAACK,MAAM,CAAC;IACpB,CAAC,MAAM;MACLzB,MAAM,CAACO,OAAO,CAACM,GAAG,CAACT,EAAE,CAAC,EAAEC,GAAG,CAACE,OAAO,EAAEmB,IAAI,CAAC,CAAC;MAC3C5B,QAAQ,GAAG,CAAC;IACd;EACF,CAAC,EACD,CAACD,KAAK,EAAEuB,UAAU,EAAEtB,QAAQ,CAC9B,CAAC;EAED,MAAM6B,gBAAgB,GAAGjC,WAAW,CACjCU,EAAU,IAAsB;IAC/B,MAAMwB,MAAM,GAAG/B,KAAK,CAAC2B,OAAO,CAACpB,EAAE,CAAC,KAAKP,KAAK,CAACgC,MAAM,GAAG,CAAC;IACrD,OAAOD,MAAM,GAAG,MAAM,GAAG,MAAM;EACjC,CAAC,EACD,CAAC/B,KAAK,CACR,CAAC;EAED,OAAO;IACLM,aAAa;IACbM,eAAe;IACfa,SAAS;IACTF,UAAU;IACVlB,aAAa;IACbyB,gBAAgB;IAChB7B,QAAQ,EAAEA,CAAA,KAAMA,QAAQ,GAAG;EAC7B,CAAC;AACH","ignoreList":[]}
+{"version":3,"names":["useCallback","useRef","useKeyboardManager","order","onSubmit","scrollOffset","fields","Map","scrollViewRef","registerField","id","ref","offsetY","current","set","unregisterField","delete","scrollToField","field","get","undefined","scrollTo","y","Math","max","animated","focusField","focus","focusNext","currentIndex","indexOf","nextId","blur","focusPrevious","prevId","getFieldIndex","canGoPrevious","canGoNext","i","length","getReturnKeyType","isLast"],"sourceRoot":"../../../src","sources":["hooks/useKeyboardManager.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/hooks/useSmartPaste.js

@@ -0,0 +1,23 @@
+"use strict";
+
+import { useCallback } from 'react';
+import { applySmartPaste, routeSmartPaste } from '../paste/smartPaste';
+/**
+ * Hook helper for smart paste — call `handlePaste(text)` from Clipboard or a paste event.
+ */
+export function useSmartPaste({
+  targets,
+  minConfidence = 0.7,
+  onRouted
+}) {
+  const handlePaste = useCallback(text => {
+    const result = applySmartPaste(text, targets, minConfidence);
+    onRouted?.(result);
+    return result;
+  }, [targets, minConfidence, onRouted]);
+  return {
+    handlePaste,
+    routeSmartPaste
+  };
+}
+//# sourceMappingURL=useSmartPaste.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","applySmartPaste","routeSmartPaste","useSmartPaste","targets","minConfidence","onRouted","handlePaste","text","result"],"sourceRoot":"../../../src","sources":["hooks/useSmartPaste.ts"],"mappings":";;AAAA,SAASA,WAAW,QAAQ,OAAO;AACnC,SACEC,eAAe,EACfC,eAAe,QAGV,qBAAqB;AAQ5B;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAAC;EAC5BC,OAAO;EACPC,aAAa,GAAG,GAAG;EACnBC;AACoB,CAAC,EAAE;EACvB,MAAMC,WAAW,GAAGP,WAAW,CAC5BQ,IAAY,IAAK;IAChB,MAAMC,MAAM,GAAGR,eAAe,CAACO,IAAI,EAAEJ,OAAO,EAAEC,aAAa,CAAC;IAC5DC,QAAQ,GAAGG,MAAM,CAAC;IAClB,OAAOA,MAAM;EACf,CAAC,EACD,CAACL,OAAO,EAAEC,aAAa,EAAEC,QAAQ,CACnC,CAAC;EAED,OAAO;IAAEC,WAAW;IAAEL;EAAgB,CAAC;AACzC","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,58 @@ 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';
+export { FieldFlowCompleteness } from './components/FieldFlowCompleteness';
+export { FieldFlowAuthActions } from './components/FieldFlowAuthActions';
+export { FieldFlowKeyboardToolbar, FIELD_FLOW_KEYBOARD_TOOLBAR_ID } from './components/FieldFlowKeyboardToolbar';
+export { FieldFlowA11yAudit } from './components/FieldFlowA11yAudit';
+export { FieldFlowInlineAlert } from './components/FieldFlowInlineAlert';
+export { FieldFlowSkeleton } from './components/FieldFlowSkeleton';
+export { FieldFlowFormHeader } from './components/FieldFlowFormHeader';
+export { FieldFlowInfoTip } from './components/FieldFlowInfoTip';
+export { FieldFlowSchemaForm } from './schema';
+// 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, applyAppearance, defaultAppearance, surfaceShadow } from './theme';
+// Motion
+export { useFieldMotion, useReducedMotion } from './motion';
 // Hooks
-export { useFieldFlowForm, useKeyboardManager, useFieldState } from './hooks';
+export { useFieldFlowForm, useKeyboardManager, useFieldState, useFormIntelligence, useFieldFlowArray, useFieldFlowDraft, useFieldFlowSteps, useFieldFlowDirtyGuard, useFieldFlowCompleteness, useFieldFlowSubmitQueue, useSmartPaste } from './hooks';
+// Autofill
+export { getAutofillProps, autofillRoleFromFieldType, autofillProfiles } from './autofill';
+// Smart paste
+export { routeSmartPaste, applySmartPaste } from './paste';
+// A11y audit
+export { runA11yAudit } from './a11y';
+// 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","FieldFlowCompleteness","FieldFlowAuthActions","FieldFlowKeyboardToolbar","FIELD_FLOW_KEYBOARD_TOOLBAR_ID","FieldFlowA11yAudit","FieldFlowInlineAlert","FieldFlowSkeleton","FieldFlowFormHeader","FieldFlowInfoTip","FieldFlowSchemaForm","FieldFlowController","FieldFlowTagsController","mapRhfToFieldFlowProps","FieldFlowThemeProvider","useFieldFlowTheme","defaultTheme","darkTheme","themePresets","getThemePreset","applyAppearance","defaultAppearance","surfaceShadow","useFieldMotion","useReducedMotion","useFieldFlowForm","useKeyboardManager","useFieldState","useFormIntelligence","useFieldFlowArray","useFieldFlowDraft","useFieldFlowSteps","useFieldFlowDirtyGuard","useFieldFlowCompleteness","useFieldFlowSubmitQueue","useSmartPaste","getAutofillProps","autofillRoleFromFieldType","autofillProfiles","routeSmartPaste","applySmartPaste","runA11yAudit","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":"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","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":[]}