rn-inputforge 0.4.0 → 0.5.1

package/src/i18n/messages.ts

@@ -0,0 +1,101 @@
+export type FieldFlowLocale = 'en' | 'es' | 'fr' | 'de' | 'pt' | 'ar';
+
+export interface FieldFlowValidationMessages {
+  required: string;
+  email: string;
+  number: string;
+  phone: string;
+  minLength: (min: number) => string;
+  maxLength: (max: number) => string;
+  pattern: string;
+  invalid: string;
+}
+
+const en: FieldFlowValidationMessages = {
+  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: FieldFlowValidationMessages = {
+  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: FieldFlowValidationMessages = {
+  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: FieldFlowValidationMessages = {
+  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: FieldFlowValidationMessages = {
+  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: FieldFlowValidationMessages = {
+  required: 'هذا الحقل مطلوب',
+  email: 'أدخل بريداً إلكترونياً صالحاً',
+  number: 'أدخل رقماً صالحاً',
+  phone: 'أدخل رقم هاتف صالحاً',
+  minLength: min => `يجب أن يكون على الأقل ${min} أحرف`,
+  maxLength: max => `يجب أن يكون على الأكثر ${max} أحرف`,
+  pattern: 'تنسيق غير صالح',
+  invalid: 'غير صالح',
+};
+
+export const validationMessageCatalogs: Record<FieldFlowLocale, FieldFlowValidationMessages> = {
+  en,
+  es,
+  fr,
+  de,
+  pt,
+  ar,
+};
+
+export function getValidationMessages(
+  locale: FieldFlowLocale = 'en',
+): FieldFlowValidationMessages {
+  return validationMessageCatalogs[locale] ?? en;
+}
+
+/** Merge a partial catalog over a locale base (default English). */
+export function createValidationMessages(
+  overrides: Partial<FieldFlowValidationMessages>,
+  locale: FieldFlowLocale = 'en',
+): FieldFlowValidationMessages {
+  return { ...getValidationMessages(locale), ...overrides };
+}

package/src/index.ts

@@ -40,12 +40,144 @@ export type {
   FieldFlowDateTimeMode,
 } from './components/FieldFlowDateTimePicker';
 
+export { FieldFlowAffordance } from './components/FieldFlowAffordance';
+export type { FieldFlowAffordanceProps } from './components/FieldFlowAffordance';
+
+export { FieldFlowDraftBanner } from './components/FieldFlowDraftBanner';
+export type { FieldFlowDraftBannerProps } from './components/FieldFlowDraftBanner';
+
+export { FieldFlowTags } from './components/FieldFlowTags';
+export type { FieldFlowTagsProps } from './components/FieldFlowTags';
+
+export { FieldFlowPasswordStrength } from './components/FieldFlowPasswordStrength';
+export type { FieldFlowPasswordStrengthProps } from './components/FieldFlowPasswordStrength';
+
+export { FieldFlowSection } from './components/FieldFlowSection';
+export type { FieldFlowSectionProps } from './components/FieldFlowSection';
+
+export { FieldFlowSegmented } from './components/FieldFlowSegmented';
+export type { FieldFlowSegmentedProps } from './components/FieldFlowSegmented';
+
+export { FieldFlowStepper } from './components/FieldFlowStepper';
+export type { FieldFlowStepperProps, FieldFlowStepRenderContext } from './components/FieldFlowStepper';
+
+export { FieldFlowPhone } from './components/FieldFlowPhone';
+export type { FieldFlowPhoneProps, FieldFlowPhoneValue } from './components/FieldFlowPhone';
+
+export { FieldFlowUpload } from './components/FieldFlowUpload';
+export type {
+  FieldFlowUploadProps,
+  FieldFlowUploadFile,
+  FieldFlowUploadPicker,
+} from './components/FieldFlowUpload';
+
+export { FieldFlowTypeahead } from './components/FieldFlowTypeahead';
+export type { FieldFlowTypeaheadProps, FieldFlowTypeaheadFetcher } from './components/FieldFlowTypeahead';
+
+export { FieldFlowRating } from './components/FieldFlowRating';
+export type { FieldFlowRatingProps } from './components/FieldFlowRating';
+
+export { FieldFlowSlider } from './components/FieldFlowSlider';
+export type { FieldFlowSliderProps } from './components/FieldFlowSlider';
+
+export { FieldFlowNumberStepper } from './components/FieldFlowNumberStepper';
+export type { FieldFlowNumberStepperProps } from './components/FieldFlowNumberStepper';
+
+export { FieldFlowCreditCard } from './components/FieldFlowCreditCard';
+export type { FieldFlowCreditCardProps, FieldFlowCreditCardValue } from './components/FieldFlowCreditCard';
+
+export { FieldFlowSignature } from './components/FieldFlowSignature';
+export type {
+  FieldFlowSignatureProps,
+  FieldFlowSignatureValue,
+  FieldFlowStroke,
+  FieldFlowPoint,
+} from './components/FieldFlowSignature';
+
+export { FieldFlowCompleteness } from './components/FieldFlowCompleteness';
+export type { FieldFlowCompletenessProps } from './components/FieldFlowCompleteness';
+
+export { FieldFlowAuthActions } from './components/FieldFlowAuthActions';
+export type {
+  FieldFlowAuthActionsProps,
+  FieldFlowAuthAction,
+  FieldFlowAuthProvider,
+} from './components/FieldFlowAuthActions';
+
+export {
+  FieldFlowKeyboardToolbar,
+  FIELD_FLOW_KEYBOARD_TOOLBAR_ID,
+} from './components/FieldFlowKeyboardToolbar';
+export type { FieldFlowKeyboardToolbarProps } from './components/FieldFlowKeyboardToolbar';
+
+export { FieldFlowA11yAudit } from './components/FieldFlowA11yAudit';
+export type { FieldFlowA11yAuditProps } from './components/FieldFlowA11yAudit';
+
+export { FieldFlowInlineAlert } from './components/FieldFlowInlineAlert';
+export type { FieldFlowInlineAlertProps, FieldFlowAlertTone } from './components/FieldFlowInlineAlert';
+
+export { FieldFlowSkeleton } from './components/FieldFlowSkeleton';
+export type { FieldFlowSkeletonProps } from './components/FieldFlowSkeleton';
+
+export { FieldFlowFormHeader } from './components/FieldFlowFormHeader';
+export type { FieldFlowFormHeaderProps } from './components/FieldFlowFormHeader';
+
+export { FieldFlowInfoTip } from './components/FieldFlowInfoTip';
+export type { FieldFlowInfoTipProps } from './components/FieldFlowInfoTip';
+
+export { FieldFlowSchemaForm } from './schema';
+export type {
+  FieldFlowSchemaFormProps,
+  FieldFlowSchemaShowWhenFn,
+  FieldFlowFormSchema,
+  FieldFlowSchemaField,
+  FieldFlowSchemaFieldType,
+  FieldFlowSchemaSection,
+} from './schema';
+
+// Adapters (optional peers: react-hook-form)
+export {
+  FieldFlowController,
+  FieldFlowTagsController,
+  mapRhfToFieldFlowProps,
+} from './adapters';
+export type {
+  FieldFlowControllerProps,
+  FieldFlowTagsControllerProps,
+} from './adapters';
+
 // Theming
-export { FieldFlowThemeProvider, useFieldFlowTheme, defaultTheme, darkTheme } from './theme';
-export type { FieldFlowThemeProviderProps } from './theme';
+export {
+  FieldFlowThemeProvider,
+  useFieldFlowTheme,
+  defaultTheme,
+  darkTheme,
+  themePresets,
+  getThemePreset,
+  applyAppearance,
+  defaultAppearance,
+  surfaceShadow,
+} from './theme';
+export type { FieldFlowThemeProviderProps, FieldFlowThemePresetName } from './theme';
+
+// Motion
+export { useFieldMotion, useReducedMotion } from './motion';
+export type { UseFieldMotionOptions, UseFieldMotionResult } from './motion';
 
 // Hooks
-export { useFieldFlowForm, useKeyboardManager, useFieldState } from './hooks';
+export {
+  useFieldFlowForm,
+  useKeyboardManager,
+  useFieldState,
+  useFormIntelligence,
+  useFieldFlowArray,
+  useFieldFlowDraft,
+  useFieldFlowSteps,
+  useFieldFlowDirtyGuard,
+  useFieldFlowCompleteness,
+  useFieldFlowSubmitQueue,
+  useSmartPaste,
+} from './hooks';
 export type {
   UseFieldFlowFormOptions,
   UseFieldFlowFormResult,
@@ -53,11 +185,80 @@ export type {
   AsyncFieldValidator,
   AsyncFieldValidators,
   CrossFieldRule,
+  FieldConditionFn,
+  FieldConditionConfig,
+  FieldConditions,
+  FieldVisibilityState,
   UseKeyboardManagerOptions,
   UseKeyboardManagerResult,
   UseFieldStateOptions,
+  UseFormIntelligenceResult,
+  UseFieldFlowArrayOptions,
+  UseFieldFlowArrayResult,
+  FieldFlowDraftStorage,
+  FieldFlowDraftPayload,
+  UseFieldFlowDraftOptions,
+  UseFieldFlowDraftResult,
+  FieldFlowStepDefinition,
+  UseFieldFlowStepsOptions,
+  UseFieldFlowStepsResult,
+  UseFieldFlowDirtyGuardOptions,
+  UseFieldFlowDirtyGuardResult,
+  UseFieldFlowCompletenessOptions,
+  UseFieldFlowCompletenessResult,
+  FieldFlowSubmitJob,
+  FieldFlowSubmitQueueStorage,
+  UseFieldFlowSubmitQueueOptions,
+  UseFieldFlowSubmitQueueResult,
+  UseSmartPasteOptions,
 } from './hooks';
 
+// Autofill
+export {
+  getAutofillProps,
+  autofillRoleFromFieldType,
+  autofillProfiles,
+} from './autofill';
+export type {
+  FieldFlowAutofillRole,
+  FieldFlowAutofillProps,
+  FieldFlowAutofillProfileName,
+} from './autofill';
+
+// Smart paste
+export { routeSmartPaste, applySmartPaste } from './paste';
+export type {
+  FieldFlowPasteKind,
+  FieldFlowPasteResult,
+  FieldFlowAddressPaste,
+  FieldFlowPasteTargets,
+} from './paste';
+
+// A11y audit
+export { runA11yAudit } from './a11y';
+export type {
+  FieldFlowA11ySeverity,
+  FieldFlowA11yIssue,
+  FieldFlowA11yFieldSnapshot,
+  FieldFlowA11yAuditInput,
+} from './a11y';
+
+// i18n
+export {
+  validationMessageCatalogs,
+  getValidationMessages,
+  createValidationMessages,
+} from './i18n';
+export type { FieldFlowLocale, FieldFlowValidationMessages } from './i18n';
+
+// Phone helpers
+export {
+  DEFAULT_COUNTRY_DIALS,
+  findCountryByCode,
+  composeE164,
+} from './utils/phoneCountries';
+export type { FieldFlowCountryDial } from './utils/phoneCountries';
+
 // Validation
 export {
   useValidation,
@@ -93,6 +294,47 @@ export {
 } from './utils/masks';
 export type { FieldFlowMaskType, MaskResult, ApplyMaskOptions } 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';
+export type { FieldFlowAffordanceKind, FieldFlowAffordanceChip } from './utils/affordance';
+
+// Password strength
+export {
+  evaluatePasswordStrength,
+  DEFAULT_PASSWORD_RULES,
+  PASSWORD_STRENGTH_COLORS,
+} from './utils/passwordStrength';
+export type {
+  PasswordStrengthLevel,
+  PasswordStrengthRule,
+  PasswordStrengthResult,
+} from './utils/passwordStrength';
+
+// Form intelligence / a11y
+export {
+  focusFirstError,
+  announceForAccessibility,
+  buildValidationAnnouncement,
+  setAccessibilityFocus,
+} from './intelligence';
+export type {
+  FieldRefMap,
+  FieldFrictionStats,
+  FormHealthReport,
+  FormIntelligenceOptions,
+} from './intelligence';
+
 // Icons
 export { FieldFlowIcon, renderFieldFlowIcon } from './icons';
 export type { FieldFlowIconName, FieldFlowIconProps, FieldFlowIconSource } from './icons';
@@ -111,5 +353,11 @@ export type {
   FieldFlowTypography,
   FieldFlowAnimationConfig,
   FieldFlowTheme,
+  FieldFlowAppearance,
+  FieldFlowDensity,
+  FieldFlowControlSize,
+  FieldFlowSurface,
+  FieldFlowShape,
+  FieldFlowFocusRing,
   DeepPartial,
 } from './types';

package/src/intelligence/formAccessibility.ts

@@ -0,0 +1,87 @@
+import { AccessibilityInfo, findNodeHandle, type TextInput } from 'react-native';
+
+export type FieldRefMap<T extends string = string> = Partial<
+  Record<T, { current: TextInput | null } | TextInput | null>
+>;
+
+function resolveNode(ref: FieldRefMap[string]): TextInput | null {
+  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<T extends string>(
+  errors: Partial<Record<T, string | undefined>>,
+  refs: FieldRefMap<T>,
+  order?: T[],
+): T | undefined {
+  const keys = order ?? (Object.keys(errors) as T[]);
+  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) as T[]) {
+    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: string): void {
+  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: Partial<Record<string, string | undefined>>,
+): string {
+  const entries = Object.entries(errors).filter(([, msg]) => Boolean(msg)) as Array<
+    [string, string]
+  >;
+  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: string): string {
+  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: { current: TextInput | null } | TextInput | null): void {
+  const node = resolveNode(ref);
+  if (!node) return;
+  const handle = findNodeHandle(node);
+  if (handle != null) {
+    AccessibilityInfo.setAccessibilityFocus?.(handle);
+  }
+}

package/src/intelligence/index.ts

@@ -0,0 +1,12 @@
+export {
+  focusFirstError,
+  announceForAccessibility,
+  buildValidationAnnouncement,
+  setAccessibilityFocus,
+} from './formAccessibility';
+export type { FieldRefMap } from './formAccessibility';
+export type {
+  FieldFrictionStats,
+  FormHealthReport,
+  FormIntelligenceOptions,
+} from './types';

package/src/intelligence/types.ts

@@ -0,0 +1,34 @@
+export interface FieldFrictionStats {
+  focusCount: number;
+  /** Cumulative milliseconds the field was focused. */
+  totalFocusMs: number;
+  errorCount: number;
+  changeCount: number;
+  blurCount: number;
+  lastFocusedAt?: number;
+  /** Running focus session start (ms since epoch); cleared on blur. */
+  focusStartedAt?: number;
+}
+
+export interface FormHealthReport {
+  /** Wall-clock ms from first interaction to this report. */
+  sessionMs: number;
+  submitAttempts: number;
+  successfulSubmits: number;
+  fields: Record<string, FieldFrictionStats>;
+  /**
+   * Fields sorted by estimated friction (errors × 3 + focusCount + changeCount / 10).
+   * Useful for product analytics / debugging onboarding drop-off.
+   */
+  mostFriction: Array<{ field: string; score: number }>;
+  generatedAt: number;
+}
+
+export interface FormIntelligenceOptions {
+  /** Called whenever a new report is produced (submit attempt, or `flush()`). */
+  onReport?: (report: FormHealthReport) => void;
+  /** When true (default), failed submit focuses & announces the first invalid field. */
+  focusFirstError?: boolean;
+  /** Announce errors via `AccessibilityInfo.announceForAccessibility`. Default: true. */
+  announceErrors?: boolean;
+}

package/src/motion/index.ts

@@ -0,0 +1,3 @@
+export { useReducedMotion } from './useReducedMotion';
+export { useFieldMotion } from './useFieldMotion';
+export type { UseFieldMotionOptions, UseFieldMotionResult } from './useFieldMotion';

package/src/motion/useFieldMotion.ts

@@ -0,0 +1,120 @@
+import { useEffect, useMemo, useRef } from 'react';
+import { Animated, Easing } from 'react-native';
+import { useReducedMotion } from './useReducedMotion';
+
+export interface UseFieldMotionOptions {
+  /** Master switch. Default: true. */
+  enabled?: boolean;
+  isFocused: boolean;
+  hasError: boolean;
+  isSuccess?: boolean;
+  /** Base duration from theme. */
+  duration?: number;
+}
+
+export interface UseFieldMotionResult {
+  /** Apply to the field chrome (input container). */
+  containerStyle: {
+    transform: Array<{ translateX: Animated.AnimatedInterpolation<string | number> }>;
+  };
+  /** Soft focus glow overlay opacity (0–1). */
+  glowOpacity: Animated.Value;
+  /** Footer message fade. */
+  messageOpacity: Animated.Value;
+  /** Success check scale pop. */
+  successScale: Animated.Value;
+  reducedMotion: boolean;
+}
+
+/**
+ * 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,
+}: UseFieldMotionOptions): UseFieldMotionResult {
+  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],
+  );
+}

package/src/motion/useReducedMotion.ts

@@ -0,0 +1,31 @@
+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(): boolean {
+  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 as { remove?: () => void }).remove === 'function') {
+        (sub as { remove: () => void }).remove();
+      }
+    };
+  }, []);
+
+  return reduced;
+}

package/src/paste/index.ts

@@ -0,0 +1,7 @@
+export { routeSmartPaste, applySmartPaste } from './smartPaste';
+export type {
+  FieldFlowPasteKind,
+  FieldFlowPasteResult,
+  FieldFlowAddressPaste,
+  FieldFlowPasteTargets,
+} from './smartPaste';