rn-inputforge 0.4.0 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (396) hide show
  1. package/README.md +723 -39
  2. package/lib/commonjs/adapters/index.js +25 -0
  3. package/lib/commonjs/adapters/index.js.map +1 -0
  4. package/lib/commonjs/adapters/reactHookForm.js +107 -0
  5. package/lib/commonjs/adapters/reactHookForm.js.map +1 -0
  6. package/lib/commonjs/components/FieldFlowAffordance/FieldFlowAffordance.js +104 -0
  7. package/lib/commonjs/components/FieldFlowAffordance/FieldFlowAffordance.js.map +1 -0
  8. package/lib/commonjs/components/FieldFlowAffordance/index.js +13 -0
  9. package/lib/commonjs/components/FieldFlowAffordance/index.js.map +1 -0
  10. package/lib/commonjs/components/FieldFlowCreditCard/FieldFlowCreditCard.js +146 -0
  11. package/lib/commonjs/components/FieldFlowCreditCard/FieldFlowCreditCard.js.map +1 -0
  12. package/lib/commonjs/components/FieldFlowCreditCard/index.js +13 -0
  13. package/lib/commonjs/components/FieldFlowCreditCard/index.js.map +1 -0
  14. package/lib/commonjs/components/FieldFlowDraftBanner/FieldFlowDraftBanner.js +156 -0
  15. package/lib/commonjs/components/FieldFlowDraftBanner/FieldFlowDraftBanner.js.map +1 -0
  16. package/lib/commonjs/components/FieldFlowDraftBanner/index.js +13 -0
  17. package/lib/commonjs/components/FieldFlowDraftBanner/index.js.map +1 -0
  18. package/lib/commonjs/components/FieldFlowInput/FieldFlowInput.js +143 -43
  19. package/lib/commonjs/components/FieldFlowInput/FieldFlowInput.js.map +1 -1
  20. package/lib/commonjs/components/FieldFlowInput/styles.js +16 -0
  21. package/lib/commonjs/components/FieldFlowInput/styles.js.map +1 -1
  22. package/lib/commonjs/components/FieldFlowNumberStepper/FieldFlowNumberStepper.js +136 -0
  23. package/lib/commonjs/components/FieldFlowNumberStepper/FieldFlowNumberStepper.js.map +1 -0
  24. package/lib/commonjs/components/FieldFlowNumberStepper/index.js +13 -0
  25. package/lib/commonjs/components/FieldFlowNumberStepper/index.js.map +1 -0
  26. package/lib/commonjs/components/FieldFlowPasswordStrength/FieldFlowPasswordStrength.js +122 -0
  27. package/lib/commonjs/components/FieldFlowPasswordStrength/FieldFlowPasswordStrength.js.map +1 -0
  28. package/lib/commonjs/components/FieldFlowPasswordStrength/index.js +13 -0
  29. package/lib/commonjs/components/FieldFlowPasswordStrength/index.js.map +1 -0
  30. package/lib/commonjs/components/FieldFlowPhone/FieldFlowPhone.js +263 -0
  31. package/lib/commonjs/components/FieldFlowPhone/FieldFlowPhone.js.map +1 -0
  32. package/lib/commonjs/components/FieldFlowPhone/index.js +13 -0
  33. package/lib/commonjs/components/FieldFlowPhone/index.js.map +1 -0
  34. package/lib/commonjs/components/FieldFlowRating/FieldFlowRating.js +106 -0
  35. package/lib/commonjs/components/FieldFlowRating/FieldFlowRating.js.map +1 -0
  36. package/lib/commonjs/components/FieldFlowRating/index.js +13 -0
  37. package/lib/commonjs/components/FieldFlowRating/index.js.map +1 -0
  38. package/lib/commonjs/components/FieldFlowSection/FieldFlowSection.js +141 -0
  39. package/lib/commonjs/components/FieldFlowSection/FieldFlowSection.js.map +1 -0
  40. package/lib/commonjs/components/FieldFlowSection/index.js +13 -0
  41. package/lib/commonjs/components/FieldFlowSection/index.js.map +1 -0
  42. package/lib/commonjs/components/FieldFlowSegmented/FieldFlowSegmented.js +195 -0
  43. package/lib/commonjs/components/FieldFlowSegmented/FieldFlowSegmented.js.map +1 -0
  44. package/lib/commonjs/components/FieldFlowSegmented/index.js +13 -0
  45. package/lib/commonjs/components/FieldFlowSegmented/index.js.map +1 -0
  46. package/lib/commonjs/components/FieldFlowSignature/FieldFlowSignature.js +200 -0
  47. package/lib/commonjs/components/FieldFlowSignature/FieldFlowSignature.js.map +1 -0
  48. package/lib/commonjs/components/FieldFlowSignature/index.js +13 -0
  49. package/lib/commonjs/components/FieldFlowSignature/index.js.map +1 -0
  50. package/lib/commonjs/components/FieldFlowSlider/FieldFlowSlider.js +178 -0
  51. package/lib/commonjs/components/FieldFlowSlider/FieldFlowSlider.js.map +1 -0
  52. package/lib/commonjs/components/FieldFlowSlider/index.js +13 -0
  53. package/lib/commonjs/components/FieldFlowSlider/index.js.map +1 -0
  54. package/lib/commonjs/components/FieldFlowStepper/FieldFlowStepper.js +166 -0
  55. package/lib/commonjs/components/FieldFlowStepper/FieldFlowStepper.js.map +1 -0
  56. package/lib/commonjs/components/FieldFlowStepper/index.js +13 -0
  57. package/lib/commonjs/components/FieldFlowStepper/index.js.map +1 -0
  58. package/lib/commonjs/components/FieldFlowTags/FieldFlowTags.js +240 -0
  59. package/lib/commonjs/components/FieldFlowTags/FieldFlowTags.js.map +1 -0
  60. package/lib/commonjs/components/FieldFlowTags/index.js +13 -0
  61. package/lib/commonjs/components/FieldFlowTags/index.js.map +1 -0
  62. package/lib/commonjs/components/FieldFlowTypeahead/FieldFlowTypeahead.js +227 -0
  63. package/lib/commonjs/components/FieldFlowTypeahead/FieldFlowTypeahead.js.map +1 -0
  64. package/lib/commonjs/components/FieldFlowTypeahead/index.js +13 -0
  65. package/lib/commonjs/components/FieldFlowTypeahead/index.js.map +1 -0
  66. package/lib/commonjs/components/FieldFlowUpload/FieldFlowUpload.js +191 -0
  67. package/lib/commonjs/components/FieldFlowUpload/FieldFlowUpload.js.map +1 -0
  68. package/lib/commonjs/components/FieldFlowUpload/index.js +13 -0
  69. package/lib/commonjs/components/FieldFlowUpload/index.js.map +1 -0
  70. package/lib/commonjs/hooks/index.js +35 -0
  71. package/lib/commonjs/hooks/index.js.map +1 -1
  72. package/lib/commonjs/hooks/useFieldFlowArray.js +110 -0
  73. package/lib/commonjs/hooks/useFieldFlowArray.js.map +1 -0
  74. package/lib/commonjs/hooks/useFieldFlowDirtyGuard.js +53 -0
  75. package/lib/commonjs/hooks/useFieldFlowDirtyGuard.js.map +1 -0
  76. package/lib/commonjs/hooks/useFieldFlowDraft.js +168 -0
  77. package/lib/commonjs/hooks/useFieldFlowDraft.js.map +1 -0
  78. package/lib/commonjs/hooks/useFieldFlowForm.js +224 -30
  79. package/lib/commonjs/hooks/useFieldFlowForm.js.map +1 -1
  80. package/lib/commonjs/hooks/useFieldFlowSteps.js +77 -0
  81. package/lib/commonjs/hooks/useFieldFlowSteps.js.map +1 -0
  82. package/lib/commonjs/hooks/useFormIntelligence.js +130 -0
  83. package/lib/commonjs/hooks/useFormIntelligence.js.map +1 -0
  84. package/lib/commonjs/i18n/index.js +25 -0
  85. package/lib/commonjs/i18n/index.js.map +1 -0
  86. package/lib/commonjs/i18n/messages.js +88 -0
  87. package/lib/commonjs/i18n/messages.js.map +1 -0
  88. package/lib/commonjs/index.js +322 -0
  89. package/lib/commonjs/index.js.map +1 -1
  90. package/lib/commonjs/intelligence/formAccessibility.js +79 -0
  91. package/lib/commonjs/intelligence/formAccessibility.js.map +1 -0
  92. package/lib/commonjs/intelligence/index.js +31 -0
  93. package/lib/commonjs/intelligence/index.js.map +1 -0
  94. package/lib/commonjs/intelligence/types.js +2 -0
  95. package/lib/commonjs/intelligence/types.js.map +1 -0
  96. package/lib/commonjs/motion/index.js +20 -0
  97. package/lib/commonjs/motion/index.js.map +1 -0
  98. package/lib/commonjs/motion/useFieldMotion.js +111 -0
  99. package/lib/commonjs/motion/useFieldMotion.js.map +1 -0
  100. package/lib/commonjs/motion/useReducedMotion.js +32 -0
  101. package/lib/commonjs/motion/useReducedMotion.js.map +1 -0
  102. package/lib/commonjs/theme/index.js +13 -0
  103. package/lib/commonjs/theme/index.js.map +1 -1
  104. package/lib/commonjs/theme/presets.js +142 -0
  105. package/lib/commonjs/theme/presets.js.map +1 -0
  106. package/lib/commonjs/utils/affordance.js +151 -0
  107. package/lib/commonjs/utils/affordance.js.map +1 -0
  108. package/lib/commonjs/utils/passwordStrength.js +79 -0
  109. package/lib/commonjs/utils/passwordStrength.js.map +1 -0
  110. package/lib/commonjs/utils/phoneCountries.js +119 -0
  111. package/lib/commonjs/utils/phoneCountries.js.map +1 -0
  112. package/lib/commonjs/validation/validators.js +10 -7
  113. package/lib/commonjs/validation/validators.js.map +1 -1
  114. package/lib/module/adapters/index.js +4 -0
  115. package/lib/module/adapters/index.js.map +1 -0
  116. package/lib/module/adapters/reactHookForm.js +100 -0
  117. package/lib/module/adapters/reactHookForm.js.map +1 -0
  118. package/lib/module/components/FieldFlowAffordance/FieldFlowAffordance.js +99 -0
  119. package/lib/module/components/FieldFlowAffordance/FieldFlowAffordance.js.map +1 -0
  120. package/lib/module/components/FieldFlowAffordance/index.js +4 -0
  121. package/lib/module/components/FieldFlowAffordance/index.js.map +1 -0
  122. package/lib/module/components/FieldFlowCreditCard/FieldFlowCreditCard.js +141 -0
  123. package/lib/module/components/FieldFlowCreditCard/FieldFlowCreditCard.js.map +1 -0
  124. package/lib/module/components/FieldFlowCreditCard/index.js +4 -0
  125. package/lib/module/components/FieldFlowCreditCard/index.js.map +1 -0
  126. package/lib/module/components/FieldFlowDraftBanner/FieldFlowDraftBanner.js +151 -0
  127. package/lib/module/components/FieldFlowDraftBanner/FieldFlowDraftBanner.js.map +1 -0
  128. package/lib/module/components/FieldFlowDraftBanner/index.js +4 -0
  129. package/lib/module/components/FieldFlowDraftBanner/index.js.map +1 -0
  130. package/lib/module/components/FieldFlowInput/FieldFlowInput.js +144 -44
  131. package/lib/module/components/FieldFlowInput/FieldFlowInput.js.map +1 -1
  132. package/lib/module/components/FieldFlowInput/styles.js +16 -0
  133. package/lib/module/components/FieldFlowInput/styles.js.map +1 -1
  134. package/lib/module/components/FieldFlowNumberStepper/FieldFlowNumberStepper.js +131 -0
  135. package/lib/module/components/FieldFlowNumberStepper/FieldFlowNumberStepper.js.map +1 -0
  136. package/lib/module/components/FieldFlowNumberStepper/index.js +4 -0
  137. package/lib/module/components/FieldFlowNumberStepper/index.js.map +1 -0
  138. package/lib/module/components/FieldFlowPasswordStrength/FieldFlowPasswordStrength.js +117 -0
  139. package/lib/module/components/FieldFlowPasswordStrength/FieldFlowPasswordStrength.js.map +1 -0
  140. package/lib/module/components/FieldFlowPasswordStrength/index.js +4 -0
  141. package/lib/module/components/FieldFlowPasswordStrength/index.js.map +1 -0
  142. package/lib/module/components/FieldFlowPhone/FieldFlowPhone.js +258 -0
  143. package/lib/module/components/FieldFlowPhone/FieldFlowPhone.js.map +1 -0
  144. package/lib/module/components/FieldFlowPhone/index.js +4 -0
  145. package/lib/module/components/FieldFlowPhone/index.js.map +1 -0
  146. package/lib/module/components/FieldFlowRating/FieldFlowRating.js +101 -0
  147. package/lib/module/components/FieldFlowRating/FieldFlowRating.js.map +1 -0
  148. package/lib/module/components/FieldFlowRating/index.js +4 -0
  149. package/lib/module/components/FieldFlowRating/index.js.map +1 -0
  150. package/lib/module/components/FieldFlowSection/FieldFlowSection.js +136 -0
  151. package/lib/module/components/FieldFlowSection/FieldFlowSection.js.map +1 -0
  152. package/lib/module/components/FieldFlowSection/index.js +4 -0
  153. package/lib/module/components/FieldFlowSection/index.js.map +1 -0
  154. package/lib/module/components/FieldFlowSegmented/FieldFlowSegmented.js +190 -0
  155. package/lib/module/components/FieldFlowSegmented/FieldFlowSegmented.js.map +1 -0
  156. package/lib/module/components/FieldFlowSegmented/index.js +4 -0
  157. package/lib/module/components/FieldFlowSegmented/index.js.map +1 -0
  158. package/lib/module/components/FieldFlowSignature/FieldFlowSignature.js +195 -0
  159. package/lib/module/components/FieldFlowSignature/FieldFlowSignature.js.map +1 -0
  160. package/lib/module/components/FieldFlowSignature/index.js +4 -0
  161. package/lib/module/components/FieldFlowSignature/index.js.map +1 -0
  162. package/lib/module/components/FieldFlowSlider/FieldFlowSlider.js +173 -0
  163. package/lib/module/components/FieldFlowSlider/FieldFlowSlider.js.map +1 -0
  164. package/lib/module/components/FieldFlowSlider/index.js +4 -0
  165. package/lib/module/components/FieldFlowSlider/index.js.map +1 -0
  166. package/lib/module/components/FieldFlowStepper/FieldFlowStepper.js +161 -0
  167. package/lib/module/components/FieldFlowStepper/FieldFlowStepper.js.map +1 -0
  168. package/lib/module/components/FieldFlowStepper/index.js +4 -0
  169. package/lib/module/components/FieldFlowStepper/index.js.map +1 -0
  170. package/lib/module/components/FieldFlowTags/FieldFlowTags.js +235 -0
  171. package/lib/module/components/FieldFlowTags/FieldFlowTags.js.map +1 -0
  172. package/lib/module/components/FieldFlowTags/index.js +4 -0
  173. package/lib/module/components/FieldFlowTags/index.js.map +1 -0
  174. package/lib/module/components/FieldFlowTypeahead/FieldFlowTypeahead.js +222 -0
  175. package/lib/module/components/FieldFlowTypeahead/FieldFlowTypeahead.js.map +1 -0
  176. package/lib/module/components/FieldFlowTypeahead/index.js +4 -0
  177. package/lib/module/components/FieldFlowTypeahead/index.js.map +1 -0
  178. package/lib/module/components/FieldFlowUpload/FieldFlowUpload.js +186 -0
  179. package/lib/module/components/FieldFlowUpload/FieldFlowUpload.js.map +1 -0
  180. package/lib/module/components/FieldFlowUpload/index.js +4 -0
  181. package/lib/module/components/FieldFlowUpload/index.js.map +1 -0
  182. package/lib/module/hooks/index.js +5 -0
  183. package/lib/module/hooks/index.js.map +1 -1
  184. package/lib/module/hooks/useFieldFlowArray.js +106 -0
  185. package/lib/module/hooks/useFieldFlowArray.js.map +1 -0
  186. package/lib/module/hooks/useFieldFlowDirtyGuard.js +49 -0
  187. package/lib/module/hooks/useFieldFlowDirtyGuard.js.map +1 -0
  188. package/lib/module/hooks/useFieldFlowDraft.js +165 -0
  189. package/lib/module/hooks/useFieldFlowDraft.js.map +1 -0
  190. package/lib/module/hooks/useFieldFlowForm.js +224 -30
  191. package/lib/module/hooks/useFieldFlowForm.js.map +1 -1
  192. package/lib/module/hooks/useFieldFlowSteps.js +73 -0
  193. package/lib/module/hooks/useFieldFlowSteps.js.map +1 -0
  194. package/lib/module/hooks/useFormIntelligence.js +126 -0
  195. package/lib/module/hooks/useFormIntelligence.js.map +1 -0
  196. package/lib/module/i18n/index.js +4 -0
  197. package/lib/module/i18n/index.js.map +1 -0
  198. package/lib/module/i18n/messages.js +82 -0
  199. package/lib/module/i18n/messages.js.map +1 -0
  200. package/lib/module/index.js +31 -2
  201. package/lib/module/index.js.map +1 -1
  202. package/lib/module/intelligence/formAccessibility.js +72 -0
  203. package/lib/module/intelligence/formAccessibility.js.map +1 -0
  204. package/lib/module/intelligence/index.js +4 -0
  205. package/lib/module/intelligence/index.js.map +1 -0
  206. package/lib/module/intelligence/types.js +2 -0
  207. package/lib/module/intelligence/types.js.map +1 -0
  208. package/lib/module/motion/index.js +5 -0
  209. package/lib/module/motion/index.js.map +1 -0
  210. package/lib/module/motion/useFieldMotion.js +107 -0
  211. package/lib/module/motion/useFieldMotion.js.map +1 -0
  212. package/lib/module/motion/useReducedMotion.js +29 -0
  213. package/lib/module/motion/useReducedMotion.js.map +1 -0
  214. package/lib/module/theme/index.js +1 -0
  215. package/lib/module/theme/index.js.map +1 -1
  216. package/lib/module/theme/presets.js +138 -0
  217. package/lib/module/theme/presets.js.map +1 -0
  218. package/lib/module/utils/affordance.js +140 -0
  219. package/lib/module/utils/affordance.js.map +1 -0
  220. package/lib/module/utils/passwordStrength.js +74 -0
  221. package/lib/module/utils/passwordStrength.js.map +1 -0
  222. package/lib/module/utils/phoneCountries.js +113 -0
  223. package/lib/module/utils/phoneCountries.js.map +1 -0
  224. package/lib/module/validation/validators.js +10 -7
  225. package/lib/module/validation/validators.js.map +1 -1
  226. package/lib/typescript/adapters/index.d.ts +3 -0
  227. package/lib/typescript/adapters/index.d.ts.map +1 -0
  228. package/lib/typescript/adapters/reactHookForm.d.ts +56 -0
  229. package/lib/typescript/adapters/reactHookForm.d.ts.map +1 -0
  230. package/lib/typescript/components/FieldFlowAffordance/FieldFlowAffordance.d.ts +29 -0
  231. package/lib/typescript/components/FieldFlowAffordance/FieldFlowAffordance.d.ts.map +1 -0
  232. package/lib/typescript/components/FieldFlowAffordance/index.d.ts +3 -0
  233. package/lib/typescript/components/FieldFlowAffordance/index.d.ts.map +1 -0
  234. package/lib/typescript/components/FieldFlowCreditCard/FieldFlowCreditCard.d.ts +27 -0
  235. package/lib/typescript/components/FieldFlowCreditCard/FieldFlowCreditCard.d.ts.map +1 -0
  236. package/lib/typescript/components/FieldFlowCreditCard/index.d.ts +3 -0
  237. package/lib/typescript/components/FieldFlowCreditCard/index.d.ts.map +1 -0
  238. package/lib/typescript/components/FieldFlowDraftBanner/FieldFlowDraftBanner.d.ts +24 -0
  239. package/lib/typescript/components/FieldFlowDraftBanner/FieldFlowDraftBanner.d.ts.map +1 -0
  240. package/lib/typescript/components/FieldFlowDraftBanner/index.d.ts +3 -0
  241. package/lib/typescript/components/FieldFlowDraftBanner/index.d.ts.map +1 -0
  242. package/lib/typescript/components/FieldFlowInput/FieldFlowInput.d.ts.map +1 -1
  243. package/lib/typescript/components/FieldFlowInput/styles.d.ts +16 -0
  244. package/lib/typescript/components/FieldFlowInput/styles.d.ts.map +1 -1
  245. package/lib/typescript/components/FieldFlowInput/types.d.ts +32 -0
  246. package/lib/typescript/components/FieldFlowInput/types.d.ts.map +1 -1
  247. package/lib/typescript/components/FieldFlowNumberStepper/FieldFlowNumberStepper.d.ts +34 -0
  248. package/lib/typescript/components/FieldFlowNumberStepper/FieldFlowNumberStepper.d.ts.map +1 -0
  249. package/lib/typescript/components/FieldFlowNumberStepper/index.d.ts +3 -0
  250. package/lib/typescript/components/FieldFlowNumberStepper/index.d.ts.map +1 -0
  251. package/lib/typescript/components/FieldFlowPasswordStrength/FieldFlowPasswordStrength.d.ts +26 -0
  252. package/lib/typescript/components/FieldFlowPasswordStrength/FieldFlowPasswordStrength.d.ts.map +1 -0
  253. package/lib/typescript/components/FieldFlowPasswordStrength/index.d.ts +3 -0
  254. package/lib/typescript/components/FieldFlowPasswordStrength/index.d.ts.map +1 -0
  255. package/lib/typescript/components/FieldFlowPhone/FieldFlowPhone.d.ts +40 -0
  256. package/lib/typescript/components/FieldFlowPhone/FieldFlowPhone.d.ts.map +1 -0
  257. package/lib/typescript/components/FieldFlowPhone/index.d.ts +3 -0
  258. package/lib/typescript/components/FieldFlowPhone/index.d.ts.map +1 -0
  259. package/lib/typescript/components/FieldFlowRating/FieldFlowRating.d.ts +30 -0
  260. package/lib/typescript/components/FieldFlowRating/FieldFlowRating.d.ts.map +1 -0
  261. package/lib/typescript/components/FieldFlowRating/index.d.ts +3 -0
  262. package/lib/typescript/components/FieldFlowRating/index.d.ts.map +1 -0
  263. package/lib/typescript/components/FieldFlowSection/FieldFlowSection.d.ts +35 -0
  264. package/lib/typescript/components/FieldFlowSection/FieldFlowSection.d.ts.map +1 -0
  265. package/lib/typescript/components/FieldFlowSection/index.d.ts +3 -0
  266. package/lib/typescript/components/FieldFlowSection/index.d.ts.map +1 -0
  267. package/lib/typescript/components/FieldFlowSegmented/FieldFlowSegmented.d.ts +28 -0
  268. package/lib/typescript/components/FieldFlowSegmented/FieldFlowSegmented.d.ts.map +1 -0
  269. package/lib/typescript/components/FieldFlowSegmented/index.d.ts +3 -0
  270. package/lib/typescript/components/FieldFlowSegmented/index.d.ts.map +1 -0
  271. package/lib/typescript/components/FieldFlowSignature/FieldFlowSignature.d.ts +41 -0
  272. package/lib/typescript/components/FieldFlowSignature/FieldFlowSignature.d.ts.map +1 -0
  273. package/lib/typescript/components/FieldFlowSignature/index.d.ts +3 -0
  274. package/lib/typescript/components/FieldFlowSignature/index.d.ts.map +1 -0
  275. package/lib/typescript/components/FieldFlowSlider/FieldFlowSlider.d.ts +30 -0
  276. package/lib/typescript/components/FieldFlowSlider/FieldFlowSlider.d.ts.map +1 -0
  277. package/lib/typescript/components/FieldFlowSlider/index.d.ts +3 -0
  278. package/lib/typescript/components/FieldFlowSlider/index.d.ts.map +1 -0
  279. package/lib/typescript/components/FieldFlowStepper/FieldFlowStepper.d.ts +31 -0
  280. package/lib/typescript/components/FieldFlowStepper/FieldFlowStepper.d.ts.map +1 -0
  281. package/lib/typescript/components/FieldFlowStepper/index.d.ts +3 -0
  282. package/lib/typescript/components/FieldFlowStepper/index.d.ts.map +1 -0
  283. package/lib/typescript/components/FieldFlowTags/FieldFlowTags.d.ts +41 -0
  284. package/lib/typescript/components/FieldFlowTags/FieldFlowTags.d.ts.map +1 -0
  285. package/lib/typescript/components/FieldFlowTags/index.d.ts +3 -0
  286. package/lib/typescript/components/FieldFlowTags/index.d.ts.map +1 -0
  287. package/lib/typescript/components/FieldFlowTypeahead/FieldFlowTypeahead.d.ts +43 -0
  288. package/lib/typescript/components/FieldFlowTypeahead/FieldFlowTypeahead.d.ts.map +1 -0
  289. package/lib/typescript/components/FieldFlowTypeahead/index.d.ts +3 -0
  290. package/lib/typescript/components/FieldFlowTypeahead/index.d.ts.map +1 -0
  291. package/lib/typescript/components/FieldFlowUpload/FieldFlowUpload.d.ts +52 -0
  292. package/lib/typescript/components/FieldFlowUpload/FieldFlowUpload.d.ts.map +1 -0
  293. package/lib/typescript/components/FieldFlowUpload/index.d.ts +3 -0
  294. package/lib/typescript/components/FieldFlowUpload/index.d.ts.map +1 -0
  295. package/lib/typescript/hooks/index.d.ts +11 -1
  296. package/lib/typescript/hooks/index.d.ts.map +1 -1
  297. package/lib/typescript/hooks/useFieldFlowArray.d.ts +54 -0
  298. package/lib/typescript/hooks/useFieldFlowArray.d.ts.map +1 -0
  299. package/lib/typescript/hooks/useFieldFlowDirtyGuard.d.ts +26 -0
  300. package/lib/typescript/hooks/useFieldFlowDirtyGuard.d.ts.map +1 -0
  301. package/lib/typescript/hooks/useFieldFlowDraft.d.ts +64 -0
  302. package/lib/typescript/hooks/useFieldFlowDraft.d.ts.map +1 -0
  303. package/lib/typescript/hooks/useFieldFlowForm.d.ts +80 -2
  304. package/lib/typescript/hooks/useFieldFlowForm.d.ts.map +1 -1
  305. package/lib/typescript/hooks/useFieldFlowSteps.d.ts +42 -0
  306. package/lib/typescript/hooks/useFieldFlowSteps.d.ts.map +1 -0
  307. package/lib/typescript/hooks/useFormIntelligence.d.ts +23 -0
  308. package/lib/typescript/hooks/useFormIntelligence.d.ts.map +1 -0
  309. package/lib/typescript/i18n/index.d.ts +3 -0
  310. package/lib/typescript/i18n/index.d.ts.map +1 -0
  311. package/lib/typescript/i18n/messages.d.ts +16 -0
  312. package/lib/typescript/i18n/messages.d.ts.map +1 -0
  313. package/lib/typescript/index.d.ts +48 -4
  314. package/lib/typescript/index.d.ts.map +1 -1
  315. package/lib/typescript/intelligence/formAccessibility.d.ts +21 -0
  316. package/lib/typescript/intelligence/formAccessibility.d.ts.map +1 -0
  317. package/lib/typescript/intelligence/index.d.ts +4 -0
  318. package/lib/typescript/intelligence/index.d.ts.map +1 -0
  319. package/lib/typescript/intelligence/types.d.ts +36 -0
  320. package/lib/typescript/intelligence/types.d.ts.map +1 -0
  321. package/lib/typescript/motion/index.d.ts +4 -0
  322. package/lib/typescript/motion/index.d.ts.map +1 -0
  323. package/lib/typescript/motion/useFieldMotion.d.ts +31 -0
  324. package/lib/typescript/motion/useFieldMotion.d.ts.map +1 -0
  325. package/lib/typescript/motion/useReducedMotion.d.ts +5 -0
  326. package/lib/typescript/motion/useReducedMotion.d.ts.map +1 -0
  327. package/lib/typescript/theme/index.d.ts +2 -0
  328. package/lib/typescript/theme/index.d.ts.map +1 -1
  329. package/lib/typescript/theme/presets.d.ts +134 -0
  330. package/lib/typescript/theme/presets.d.ts.map +1 -0
  331. package/lib/typescript/utils/affordance.d.ts +36 -0
  332. package/lib/typescript/utils/affordance.d.ts.map +1 -0
  333. package/lib/typescript/utils/passwordStrength.d.ts +26 -0
  334. package/lib/typescript/utils/passwordStrength.d.ts.map +1 -0
  335. package/lib/typescript/utils/phoneCountries.d.ts +12 -0
  336. package/lib/typescript/utils/phoneCountries.d.ts.map +1 -0
  337. package/lib/typescript/validation/validators.d.ts +3 -1
  338. package/lib/typescript/validation/validators.d.ts.map +1 -1
  339. package/package.json +19 -2
  340. package/src/adapters/index.ts +9 -0
  341. package/src/adapters/reactHookForm.tsx +152 -0
  342. package/src/components/FieldFlowAffordance/FieldFlowAffordance.tsx +143 -0
  343. package/src/components/FieldFlowAffordance/index.ts +2 -0
  344. package/src/components/FieldFlowCreditCard/FieldFlowCreditCard.tsx +152 -0
  345. package/src/components/FieldFlowCreditCard/index.ts +2 -0
  346. package/src/components/FieldFlowDraftBanner/FieldFlowDraftBanner.tsx +169 -0
  347. package/src/components/FieldFlowDraftBanner/index.ts +2 -0
  348. package/src/components/FieldFlowInput/FieldFlowInput.tsx +174 -53
  349. package/src/components/FieldFlowInput/styles.ts +16 -0
  350. package/src/components/FieldFlowInput/types.ts +33 -0
  351. package/src/components/FieldFlowNumberStepper/FieldFlowNumberStepper.tsx +156 -0
  352. package/src/components/FieldFlowNumberStepper/index.ts +2 -0
  353. package/src/components/FieldFlowPasswordStrength/FieldFlowPasswordStrength.tsx +148 -0
  354. package/src/components/FieldFlowPasswordStrength/index.ts +2 -0
  355. package/src/components/FieldFlowPhone/FieldFlowPhone.tsx +298 -0
  356. package/src/components/FieldFlowPhone/index.ts +2 -0
  357. package/src/components/FieldFlowRating/FieldFlowRating.tsx +121 -0
  358. package/src/components/FieldFlowRating/index.ts +2 -0
  359. package/src/components/FieldFlowSection/FieldFlowSection.tsx +176 -0
  360. package/src/components/FieldFlowSection/index.ts +2 -0
  361. package/src/components/FieldFlowSegmented/FieldFlowSegmented.tsx +248 -0
  362. package/src/components/FieldFlowSegmented/index.ts +2 -0
  363. package/src/components/FieldFlowSignature/FieldFlowSignature.tsx +241 -0
  364. package/src/components/FieldFlowSignature/index.ts +7 -0
  365. package/src/components/FieldFlowSlider/FieldFlowSlider.tsx +190 -0
  366. package/src/components/FieldFlowSlider/index.ts +2 -0
  367. package/src/components/FieldFlowStepper/FieldFlowStepper.tsx +190 -0
  368. package/src/components/FieldFlowStepper/index.ts +2 -0
  369. package/src/components/FieldFlowTags/FieldFlowTags.tsx +319 -0
  370. package/src/components/FieldFlowTags/index.ts +2 -0
  371. package/src/components/FieldFlowTypeahead/FieldFlowTypeahead.tsx +261 -0
  372. package/src/components/FieldFlowTypeahead/index.ts +2 -0
  373. package/src/components/FieldFlowUpload/FieldFlowUpload.tsx +226 -0
  374. package/src/components/FieldFlowUpload/index.ts +6 -0
  375. package/src/hooks/index.ts +31 -0
  376. package/src/hooks/useFieldFlowArray.ts +153 -0
  377. package/src/hooks/useFieldFlowDirtyGuard.ts +70 -0
  378. package/src/hooks/useFieldFlowDraft.ts +221 -0
  379. package/src/hooks/useFieldFlowForm.ts +357 -28
  380. package/src/hooks/useFieldFlowSteps.ts +130 -0
  381. package/src/hooks/useFormIntelligence.ts +207 -0
  382. package/src/i18n/index.ts +6 -0
  383. package/src/i18n/messages.ts +101 -0
  384. package/src/index.ts +161 -3
  385. package/src/intelligence/formAccessibility.ts +87 -0
  386. package/src/intelligence/index.ts +12 -0
  387. package/src/intelligence/types.ts +34 -0
  388. package/src/motion/index.ts +3 -0
  389. package/src/motion/useFieldMotion.ts +120 -0
  390. package/src/motion/useReducedMotion.ts +31 -0
  391. package/src/theme/index.ts +2 -0
  392. package/src/theme/presets.ts +120 -0
  393. package/src/utils/affordance.ts +138 -0
  394. package/src/utils/passwordStrength.ts +109 -0
  395. package/src/utils/phoneCountries.ts +44 -0
  396. package/src/validation/validators.ts +17 -7
@@ -7,6 +7,13 @@ import { resolveFieldConfig, implicitRulesForType } from '../../utils/keyboardTy
7
7
  import { sanitizeNumeric, sanitizePhone, truncate } from '../../utils/formatters';
8
8
  import { runRules } from '../../validation/validators';
9
9
  import { renderFieldFlowIcon } from '../../icons/renderIcon';
10
+ import { useFieldMotion } from '../../motion/useFieldMotion';
11
+ import { FieldFlowAffordance } from '../FieldFlowAffordance';
12
+ import { FieldFlowPasswordStrength } from '../FieldFlowPasswordStrength';
13
+ import {
14
+ affordanceKindFromFieldType,
15
+ type FieldFlowAffordanceKind,
16
+ } from '../../utils/affordance';
10
17
  import { createStyles, iconColorFor, labelColorFor } from './styles';
11
18
  import type { FieldFlowInputProps } from './types';
12
19
 
@@ -45,6 +52,12 @@ export const FieldFlowInput = forwardRef<TextInput, FieldFlowInputProps>(functio
45
52
  onRightIconPress,
46
53
  iconSize = 18,
47
54
  clearable,
55
+ suggestions,
56
+ suggestionsAlwaysVisible = false,
57
+ showStrength,
58
+ prefix,
59
+ suffix,
60
+ motion = true,
48
61
  maxLength,
49
62
  showCharacterCount,
50
63
  onSubmitEditing,
@@ -100,6 +113,14 @@ export const FieldFlowInput = forwardRef<TextInput, FieldFlowInputProps>(functio
100
113
  );
101
114
  const iconColor = iconColorFor(theme, state);
102
115
 
116
+ const fieldMotion = useFieldMotion({
117
+ enabled: motion,
118
+ isFocused,
119
+ hasError: Boolean(hasError || resolvedError),
120
+ isSuccess: Boolean(isSuccess || successText),
121
+ duration: theme.animation.duration,
122
+ });
123
+
103
124
  const isFloating = variant === 'floating';
104
125
  const floatUp = isFocused || currentValue.length > 0;
105
126
  const floatAnim = useRef(new Animated.Value(floatUp ? 1 : 0)).current;
@@ -138,17 +159,34 @@ export const FieldFlowInput = forwardRef<TextInput, FieldFlowInputProps>(functio
138
159
  [type, maxLength, isControlled, onChangeText, validateOnChange, runValidation],
139
160
  );
140
161
 
162
+ const blurHideTimer = useRef<ReturnType<typeof setTimeout> | null>(null);
163
+
141
164
  const handleFocus = useCallback(() => {
165
+ if (blurHideTimer.current) {
166
+ clearTimeout(blurHideTimer.current);
167
+ blurHideTimer.current = null;
168
+ }
142
169
  setIsFocused(true);
143
170
  onFocus?.();
144
171
  }, [onFocus]);
145
172
 
146
173
  const handleBlur = useCallback(() => {
147
- setIsFocused(false);
174
+ // Delay hiding suggestion chips so a chip press can register first
175
+ blurHideTimer.current = setTimeout(() => {
176
+ setIsFocused(false);
177
+ blurHideTimer.current = null;
178
+ }, 180);
148
179
  runValidation(currentValue);
149
180
  onBlur?.();
150
181
  }, [runValidation, currentValue, onBlur]);
151
182
 
183
+ useEffect(
184
+ () => () => {
185
+ if (blurHideTimer.current) clearTimeout(blurHideTimer.current);
186
+ },
187
+ [],
188
+ );
189
+
152
190
  const handleClear = useCallback(() => {
153
191
  if (!isControlled) setInternalValue('');
154
192
  onChangeText?.('');
@@ -197,6 +235,42 @@ export const FieldFlowInput = forwardRef<TextInput, FieldFlowInputProps>(functio
197
235
 
198
236
  const showExternalLabel = Boolean(label) && !isFloating;
199
237
 
238
+ const affordanceConfig = useMemo(() => {
239
+ if (!suggestions) return null;
240
+ if (suggestions === true) {
241
+ const kind = affordanceKindFromFieldType(type);
242
+ return kind ? { kind, chips: undefined as undefined } : null;
243
+ }
244
+ if (typeof suggestions === 'string') {
245
+ return { kind: suggestions as FieldFlowAffordanceKind, chips: undefined as undefined };
246
+ }
247
+ return { kind: 'custom' as FieldFlowAffordanceKind, chips: suggestions };
248
+ }, [suggestions, type]);
249
+
250
+ const showAffordance =
251
+ Boolean(affordanceConfig) &&
252
+ !disabled &&
253
+ !readOnly &&
254
+ (suggestionsAlwaysVisible || isFocused);
255
+
256
+ const renderAffix = (affix: string | React.ReactNode | undefined, side: 'left' | 'right') => {
257
+ if (affix == null || affix === false) return null;
258
+ if (typeof affix === 'string') {
259
+ return (
260
+ <Text
261
+ style={[
262
+ styles.affixText,
263
+ side === 'left' ? styles.iconSlotLeft : styles.iconSlotRight,
264
+ ]}
265
+ numberOfLines={1}
266
+ >
267
+ {affix}
268
+ </Text>
269
+ );
270
+ }
271
+ return <View style={side === 'left' ? styles.iconSlotLeft : styles.iconSlotRight}>{affix}</View>;
272
+ };
273
+
200
274
  return (
201
275
  <View style={[styles.wrapper, containerStyle]} testID={testID}>
202
276
  {showExternalLabel ? (
@@ -206,62 +280,109 @@ export const FieldFlowInput = forwardRef<TextInput, FieldFlowInputProps>(functio
206
280
  </Text>
207
281
  ) : null}
208
282
 
209
- <View style={[styles.inputContainer, inputContainerStyle]}>
210
- {isFloating && label ? (
211
- <Animated.Text style={[styles.floatingLabel, floatingLabelStyle, labelStyle]} pointerEvents="none">
212
- {label}
213
- {required ? ' *' : ''}
214
- </Animated.Text>
215
- ) : null}
216
-
217
- {resolvedLeftIcon ? (
218
- <Pressable
219
- onPress={onLeftIconPress}
220
- disabled={!onLeftIconPress}
221
- style={[styles.iconSlot, styles.iconSlotLeft]}
222
- hitSlop={8}
223
- accessibilityRole={onLeftIconPress ? 'button' : undefined}
224
- >
225
- {renderFieldFlowIcon(resolvedLeftIcon, iconColor, iconSize)}
226
- </Pressable>
227
- ) : null}
228
-
229
- <TextInput
230
- ref={innerRef}
283
+ <Animated.View style={fieldMotion.containerStyle}>
284
+ <View style={[styles.inputContainer, inputContainerStyle]}>
285
+ {motion ? (
286
+ <Animated.View
287
+ pointerEvents="none"
288
+ style={[
289
+ styles.focusGlow,
290
+ {
291
+ opacity: fieldMotion.glowOpacity.interpolate({
292
+ inputRange: [0, 1],
293
+ outputRange: [0, 0.22],
294
+ }),
295
+ borderColor: theme.colors.borderFocused,
296
+ borderRadius: theme.spacing.borderRadius + 2,
297
+ },
298
+ ]}
299
+ />
300
+ ) : null}
301
+
302
+ {isFloating && label ? (
303
+ <Animated.Text style={[styles.floatingLabel, floatingLabelStyle, labelStyle]} pointerEvents="none">
304
+ {label}
305
+ {required ? ' *' : ''}
306
+ </Animated.Text>
307
+ ) : null}
308
+
309
+ {resolvedLeftIcon ? (
310
+ <Pressable
311
+ onPress={onLeftIconPress}
312
+ disabled={!onLeftIconPress}
313
+ style={[styles.iconSlot, styles.iconSlotLeft]}
314
+ hitSlop={8}
315
+ accessibilityRole={onLeftIconPress ? 'button' : undefined}
316
+ >
317
+ {renderFieldFlowIcon(resolvedLeftIcon, iconColor, iconSize)}
318
+ </Pressable>
319
+ ) : null}
320
+
321
+ {renderAffix(prefix, 'left')}
322
+
323
+ <TextInput
324
+ ref={innerRef}
325
+ value={currentValue}
326
+ onChangeText={handleChangeText}
327
+ onFocus={handleFocus}
328
+ onBlur={handleBlur}
329
+ onSubmitEditing={onSubmitEditing}
330
+ editable={!disabled && !readOnly && !loading}
331
+ placeholder={isFloating ? (floatUp ? placeholder : undefined) : placeholder}
332
+ placeholderTextColor={theme.colors.placeholder}
333
+ keyboardType={fieldConfig.keyboardType}
334
+ secureTextEntry={fieldConfig.secureTextEntry && !showPassword}
335
+ autoCapitalize={fieldConfig.autoCapitalize}
336
+ autoCorrect={fieldConfig.autoCorrect}
337
+ multiline={fieldConfig.multiline && type !== 'chat'}
338
+ maxLength={maxLength}
339
+ returnKeyType={fieldConfig.multiline ? 'default' : 'done'}
340
+ style={[styles.input, inputStyle]}
341
+ {...rest}
342
+ />
343
+
344
+ {renderAffix(suffix, 'right')}
345
+
346
+ {resolvedRightIcon ? (
347
+ <Animated.View style={{ transform: [{ scale: fieldMotion.successScale }] }}>
348
+ <Pressable
349
+ onPress={rightIconPress}
350
+ disabled={!rightIconPress}
351
+ style={[styles.iconSlot, styles.iconSlotRight]}
352
+ hitSlop={8}
353
+ accessibilityRole={rightIconPress ? 'button' : undefined}
354
+ >
355
+ {renderFieldFlowIcon(resolvedRightIcon, iconColor, iconSize)}
356
+ </Pressable>
357
+ </Animated.View>
358
+ ) : null}
359
+ </View>
360
+ </Animated.View>
361
+
362
+ {showAffordance && affordanceConfig ? (
363
+ <FieldFlowAffordance
364
+ kind={affordanceConfig.kind}
365
+ chips={affordanceConfig.chips}
231
366
  value={currentValue}
232
- onChangeText={handleChangeText}
233
- onFocus={handleFocus}
234
- onBlur={handleBlur}
235
- onSubmitEditing={onSubmitEditing}
236
- editable={!disabled && !readOnly && !loading}
237
- placeholder={isFloating ? (floatUp ? placeholder : undefined) : placeholder}
238
- placeholderTextColor={theme.colors.placeholder}
239
- keyboardType={fieldConfig.keyboardType}
240
- secureTextEntry={fieldConfig.secureTextEntry && !showPassword}
241
- autoCapitalize={fieldConfig.autoCapitalize}
242
- autoCorrect={fieldConfig.autoCorrect}
243
- multiline={fieldConfig.multiline && type !== 'chat'}
244
- maxLength={maxLength}
245
- returnKeyType={fieldConfig.multiline ? 'default' : 'done'}
246
- style={[styles.input, inputStyle]}
247
- {...rest}
367
+ onSelect={next => {
368
+ handleChangeText(next);
369
+ innerRef.current?.focus();
370
+ }}
371
+ theme={themeOverride}
248
372
  />
373
+ ) : null}
249
374
 
250
- {resolvedRightIcon ? (
251
- <Pressable
252
- onPress={rightIconPress}
253
- disabled={!rightIconPress}
254
- style={[styles.iconSlot, styles.iconSlotRight]}
255
- hitSlop={8}
256
- accessibilityRole={rightIconPress ? 'button' : undefined}
257
- >
258
- {renderFieldFlowIcon(resolvedRightIcon, iconColor, iconSize)}
259
- </Pressable>
260
- ) : null}
261
- </View>
375
+ {type === 'password' && showStrength ? (
376
+ <FieldFlowPasswordStrength
377
+ password={currentValue}
378
+ showRules={typeof showStrength === 'object' ? showStrength.showRules : true}
379
+ rules={typeof showStrength === 'object' ? showStrength.rules : undefined}
380
+ theme={themeOverride}
381
+ />
382
+ ) : null}
262
383
 
263
384
  {(helperText || resolvedError || successText || (showCharacterCount && maxLength)) && (
264
- <View style={styles.footerRow}>
385
+ <Animated.View style={[styles.footerRow, { opacity: fieldMotion.messageOpacity }]}>
265
386
  <View style={{ flex: 1 }}>
266
387
  {resolvedError ? (
267
388
  <Text style={[styles.errorText, errorStyle, helperStyle]}>{resolvedError}</Text>
@@ -276,7 +397,7 @@ export const FieldFlowInput = forwardRef<TextInput, FieldFlowInputProps>(functio
276
397
  {currentValue.length}/{maxLength}
277
398
  </Text>
278
399
  ) : null}
279
- </View>
400
+ </Animated.View>
280
401
  )}
281
402
  </View>
282
403
  );
@@ -47,6 +47,8 @@ export function createStyles(
47
47
  fontFamily: theme.typography.fontFamily,
48
48
  },
49
49
  inputContainer: {
50
+ position: 'relative',
51
+ overflow: 'visible',
50
52
  flexDirection: 'row',
51
53
  alignItems: multiline ? 'flex-start' : 'center',
52
54
  backgroundColor: state === 'disabled'
@@ -67,6 +69,20 @@ export function createStyles(
67
69
  : theme.spacing.paddingVertical * 2 + theme.typography.fontSize + 6 + (isFloating ? 6 : 0),
68
70
  paddingTop: isFloating && !multiline ? theme.spacing.paddingVertical + 6 : undefined,
69
71
  },
72
+ focusGlow: {
73
+ position: 'absolute',
74
+ top: -3,
75
+ left: -3,
76
+ right: -3,
77
+ bottom: -3,
78
+ borderWidth: 3,
79
+ },
80
+ affixText: {
81
+ fontSize: theme.typography.fontSize,
82
+ color: theme.colors.label,
83
+ fontFamily: theme.typography.fontFamily,
84
+ fontWeight: '500',
85
+ },
70
86
  floatingLabel: {
71
87
  position: 'absolute',
72
88
  left: theme.spacing.paddingHorizontal,
@@ -1,6 +1,9 @@
1
+ import type React from 'react';
1
2
  import type { TextInputProps, ViewStyle, TextStyle } from 'react-native';
2
3
  import type { FieldFlowFieldType, FieldFlowRules, FieldFlowVariant, DeepPartial, FieldFlowTheme } from '../../types';
3
4
  import type { FieldFlowIconSource } from '../../icons';
5
+ import type { FieldFlowAffordanceChip, FieldFlowAffordanceKind } from '../../utils/affordance';
6
+ import type { PasswordStrengthRule } from '../../utils/passwordStrength';
4
7
 
5
8
  export interface FieldFlowInputProps
6
9
  extends Omit<TextInputProps, 'style' | 'onChangeText' | 'onFocus' | 'onBlur' | 'onSubmitEditing'> {
@@ -56,6 +59,36 @@ export interface FieldFlowInputProps
56
59
  /** Shows an "x" clear button when there's text (defaults to true for `search`, false otherwise). */
57
60
  clearable?: boolean;
58
61
 
62
+ /**
63
+ * Smart suggestion chips shown while the field is focused.
64
+ * - `true` — infer from `type` (email → domains, phone → dial codes, number/decimal → currency)
65
+ * - `'email' | 'phone' | 'currency'` — force a preset
66
+ * - `string[]` / chip objects — fully custom list
67
+ */
68
+ suggestions?: boolean | FieldFlowAffordanceKind | FieldFlowAffordanceChip[] | string[];
69
+ /** Keep suggestion chips visible even when blurred. Default: false. */
70
+ suggestionsAlwaysVisible?: boolean;
71
+
72
+ /**
73
+ * Show a password strength meter under the field (only meaningful for `type="password"`).
74
+ * Pass `true` for defaults, or `{ showRules?: boolean; rules?: PasswordStrengthRule[] }`.
75
+ */
76
+ showStrength?: boolean | { showRules?: boolean; rules?: PasswordStrengthRule[] };
77
+
78
+ /**
79
+ * Text or node rendered inside the field before the value (e.g. `+92`, `$`, `https://`).
80
+ * Shown in addition to `leftIcon` when both are set.
81
+ */
82
+ prefix?: string | React.ReactNode;
83
+ /** Text or node rendered inside the field after the value (e.g. `kg`, `.com`). */
84
+ suffix?: string | React.ReactNode;
85
+
86
+ /**
87
+ * Micro-interactions: focus glow, error shake, message fade, success pop.
88
+ * Respects OS Reduce Motion. Default: true.
89
+ */
90
+ motion?: boolean;
91
+
59
92
  maxLength?: number;
60
93
  showCharacterCount?: boolean;
61
94
 
@@ -0,0 +1,156 @@
1
+ import React, { useMemo } from 'react';
2
+ import { Pressable, StyleSheet, Text, View, type TextStyle, type ViewStyle } from 'react-native';
3
+ import { useFieldFlowTheme, mergeDeep } from '../../theme/ThemeProvider';
4
+ import { defaultTheme } from '../../theme/defaultTheme';
5
+ import { renderFieldFlowIcon } from '../../icons/renderIcon';
6
+ import type { DeepPartial, FieldFlowTheme } from '../../types';
7
+
8
+ export interface FieldFlowNumberStepperProps {
9
+ value: number;
10
+ onChange: (value: number) => void;
11
+ min?: number;
12
+ max?: number;
13
+ step?: number;
14
+ label?: string;
15
+ helperText?: string;
16
+ errorText?: string;
17
+ disabled?: boolean;
18
+ required?: boolean;
19
+ formatValue?: (value: number) => string;
20
+ /** Custom − button content. */
21
+ renderDecrease?: (ctx: { disabled: boolean; onPress: () => void }) => React.ReactNode;
22
+ /** Custom + button content. */
23
+ renderIncrease?: (ctx: { disabled: boolean; onPress: () => void }) => React.ReactNode;
24
+ /** Custom center value display. */
25
+ renderValue?: (value: number) => React.ReactNode;
26
+ containerStyle?: ViewStyle;
27
+ labelStyle?: TextStyle;
28
+ theme?: DeepPartial<FieldFlowTheme>;
29
+ testID?: string;
30
+ }
31
+
32
+ export function FieldFlowNumberStepper({
33
+ value,
34
+ onChange,
35
+ min = 0,
36
+ max = 99,
37
+ step = 1,
38
+ label,
39
+ helperText,
40
+ errorText,
41
+ disabled,
42
+ required,
43
+ formatValue,
44
+ renderDecrease,
45
+ renderIncrease,
46
+ renderValue,
47
+ containerStyle,
48
+ labelStyle,
49
+ theme: themeOverride,
50
+ testID,
51
+ }: FieldFlowNumberStepperProps) {
52
+ const contextTheme = useFieldFlowTheme();
53
+ const theme = useMemo(
54
+ () => (themeOverride ? mergeDeep(contextTheme ?? defaultTheme, themeOverride) : contextTheme ?? defaultTheme),
55
+ [contextTheme, themeOverride],
56
+ );
57
+ const styles = useMemo(() => createStyles(theme, Boolean(errorText), Boolean(disabled)), [theme, errorText, disabled]);
58
+
59
+ const dec = () => {
60
+ if (disabled) return;
61
+ onChange(Math.max(min, Number((value - step).toFixed(6))));
62
+ };
63
+ const inc = () => {
64
+ if (disabled) return;
65
+ onChange(Math.min(max, Number((value + step).toFixed(6))));
66
+ };
67
+
68
+ return (
69
+ <View style={[styles.wrap, containerStyle]} testID={testID}>
70
+ {label ? (
71
+ <Text style={[styles.label, labelStyle]}>
72
+ {label}
73
+ {required ? ' *' : ''}
74
+ </Text>
75
+ ) : null}
76
+
77
+ <View style={styles.row}>
78
+ {renderDecrease ? (
79
+ renderDecrease({ disabled: Boolean(disabled) || value <= min, onPress: dec })
80
+ ) : (
81
+ <Pressable
82
+ style={[styles.btn, value <= min && styles.btnDisabled]}
83
+ onPress={dec}
84
+ disabled={disabled || value <= min}
85
+ accessibilityLabel="Decrease"
86
+ >
87
+ {renderFieldFlowIcon('minus', theme.colors.text, 16)}
88
+ </Pressable>
89
+ )}
90
+ {renderValue ? (
91
+ renderValue(value)
92
+ ) : (
93
+ <Text style={styles.value}>{formatValue ? formatValue(value) : String(value)}</Text>
94
+ )}
95
+ {renderIncrease ? (
96
+ renderIncrease({ disabled: Boolean(disabled) || value >= max, onPress: inc })
97
+ ) : (
98
+ <Pressable
99
+ style={[styles.btn, value >= max && styles.btnDisabled]}
100
+ onPress={inc}
101
+ disabled={disabled || value >= max}
102
+ accessibilityLabel="Increase"
103
+ >
104
+ {renderFieldFlowIcon('plus', theme.colors.text, 16)}
105
+ </Pressable>
106
+ )}
107
+ </View>
108
+
109
+ {errorText ? (
110
+ <Text style={styles.error}>{errorText}</Text>
111
+ ) : helperText ? (
112
+ <Text style={styles.helper}>{helperText}</Text>
113
+ ) : null}
114
+ </View>
115
+ );
116
+ }
117
+
118
+ function createStyles(theme: FieldFlowTheme, hasError: boolean, disabled: boolean) {
119
+ return StyleSheet.create({
120
+ wrap: { marginBottom: theme.spacing.gap * 2, opacity: disabled ? 0.6 : 1 },
121
+ label: {
122
+ fontSize: theme.typography.labelFontSize,
123
+ marginBottom: theme.spacing.gap,
124
+ color: hasError ? theme.colors.error : theme.colors.label,
125
+ fontWeight: '500',
126
+ },
127
+ row: {
128
+ flexDirection: 'row',
129
+ alignItems: 'center',
130
+ alignSelf: 'flex-start',
131
+ borderWidth: hasError ? theme.spacing.borderWidthFocused : theme.spacing.borderWidth,
132
+ borderColor: hasError ? theme.colors.borderError : theme.colors.border,
133
+ borderRadius: theme.spacing.borderRadius,
134
+ overflow: 'hidden',
135
+ backgroundColor: theme.colors.background,
136
+ },
137
+ btn: {
138
+ width: 44,
139
+ height: 44,
140
+ alignItems: 'center',
141
+ justifyContent: 'center',
142
+ backgroundColor: theme.colors.backgroundDisabled,
143
+ },
144
+ btnDisabled: { opacity: 0.4 },
145
+ value: {
146
+ minWidth: 56,
147
+ textAlign: 'center',
148
+ fontSize: theme.typography.fontSize,
149
+ fontWeight: '600',
150
+ color: theme.colors.text,
151
+ paddingHorizontal: 8,
152
+ },
153
+ helper: { marginTop: 6, fontSize: theme.typography.helperFontSize, color: theme.colors.label },
154
+ error: { marginTop: 6, fontSize: theme.typography.helperFontSize, color: theme.colors.error },
155
+ });
156
+ }
@@ -0,0 +1,2 @@
1
+ export { FieldFlowNumberStepper } from './FieldFlowNumberStepper';
2
+ export type { FieldFlowNumberStepperProps } from './FieldFlowNumberStepper';
@@ -0,0 +1,148 @@
1
+ import React, { useMemo } from 'react';
2
+ import { StyleSheet, Text, View, type TextStyle, type ViewStyle } from 'react-native';
3
+ import { useFieldFlowTheme, mergeDeep } from '../../theme/ThemeProvider';
4
+ import { defaultTheme } from '../../theme/defaultTheme';
5
+ import { renderFieldFlowIcon } from '../../icons/renderIcon';
6
+ import type { DeepPartial, FieldFlowTheme } from '../../types';
7
+ import {
8
+ DEFAULT_PASSWORD_RULES,
9
+ evaluatePasswordStrength,
10
+ PASSWORD_STRENGTH_COLORS,
11
+ type PasswordStrengthLevel,
12
+ type PasswordStrengthRule,
13
+ } from '../../utils/passwordStrength';
14
+
15
+ export interface FieldFlowPasswordStrengthProps {
16
+ password: string;
17
+ /** Override the default rule checklist. */
18
+ rules?: PasswordStrengthRule[];
19
+ /** Show the checklist under the bar. Default: true. */
20
+ showRules?: boolean;
21
+ /** Hide entirely when password is empty. Default: true. */
22
+ hideWhenEmpty?: boolean;
23
+ /** Override bar colors per level. */
24
+ colors?: Partial<Record<Exclude<PasswordStrengthLevel, 'empty'>, string>>;
25
+ containerStyle?: ViewStyle;
26
+ labelStyle?: TextStyle;
27
+ ruleStyle?: TextStyle;
28
+ theme?: DeepPartial<FieldFlowTheme>;
29
+ testID?: string;
30
+ }
31
+
32
+ /**
33
+ * Password strength meter + optional rule checklist.
34
+ * Pair with `FieldFlowInput type="password"` or use via `showStrength` on the input.
35
+ */
36
+ export function FieldFlowPasswordStrength({
37
+ password,
38
+ rules,
39
+ showRules = true,
40
+ hideWhenEmpty = true,
41
+ colors,
42
+ containerStyle,
43
+ labelStyle,
44
+ ruleStyle,
45
+ theme: themeOverride,
46
+ testID,
47
+ }: FieldFlowPasswordStrengthProps) {
48
+ const contextTheme = useFieldFlowTheme();
49
+ const theme = useMemo(
50
+ () => (themeOverride ? mergeDeep(contextTheme ?? defaultTheme, themeOverride) : contextTheme ?? defaultTheme),
51
+ [contextTheme, themeOverride],
52
+ );
53
+ const styles = useMemo(() => createStyles(theme), [theme]);
54
+ const result = useMemo(() => evaluatePasswordStrength(password, rules), [password, rules]);
55
+
56
+ if (hideWhenEmpty && result.level === 'empty') return null;
57
+
58
+ const barColor =
59
+ result.level === 'empty'
60
+ ? theme.colors.border
61
+ : colors?.[result.level] ?? PASSWORD_STRENGTH_COLORS[result.level];
62
+
63
+ return (
64
+ <View style={[styles.wrapper, containerStyle]} testID={testID} accessibilityRole="summary">
65
+ <View style={styles.header}>
66
+ <View style={styles.track}>
67
+ <View style={[styles.fill, { width: `${Math.round(result.progress * 100)}%`, backgroundColor: barColor }]} />
68
+ </View>
69
+ {result.label ? (
70
+ <Text style={[styles.levelLabel, { color: barColor }, labelStyle]}>{result.label}</Text>
71
+ ) : null}
72
+ </View>
73
+
74
+ {showRules ? (
75
+ <View style={styles.rules}>
76
+ {(rules ?? DEFAULT_PASSWORD_RULES).map(rule => {
77
+ const ok = result.passed.some(p => p.id === rule.id);
78
+ return (
79
+ <View key={rule.id} style={styles.ruleRow}>
80
+ {renderFieldFlowIcon(ok ? 'check' : 'clear', ok ? theme.colors.success : theme.colors.placeholder, 12)}
81
+ <Text
82
+ style={[
83
+ styles.ruleText,
84
+ ok ? styles.rulePassed : styles.ruleFailed,
85
+ ruleStyle,
86
+ ]}
87
+ >
88
+ {rule.label}
89
+ </Text>
90
+ </View>
91
+ );
92
+ })}
93
+ </View>
94
+ ) : null}
95
+ </View>
96
+ );
97
+ }
98
+
99
+ function createStyles(theme: FieldFlowTheme) {
100
+ return StyleSheet.create({
101
+ wrapper: {
102
+ marginTop: theme.spacing.gap,
103
+ marginBottom: theme.spacing.gap,
104
+ },
105
+ header: {
106
+ flexDirection: 'row',
107
+ alignItems: 'center',
108
+ gap: theme.spacing.gap,
109
+ },
110
+ track: {
111
+ flex: 1,
112
+ height: 6,
113
+ borderRadius: 3,
114
+ backgroundColor: theme.colors.border,
115
+ overflow: 'hidden',
116
+ },
117
+ fill: {
118
+ height: '100%',
119
+ borderRadius: 3,
120
+ },
121
+ levelLabel: {
122
+ fontSize: theme.typography.helperFontSize,
123
+ fontWeight: '600',
124
+ minWidth: 48,
125
+ textAlign: 'right',
126
+ fontFamily: theme.typography.fontFamily,
127
+ },
128
+ rules: {
129
+ marginTop: theme.spacing.gap,
130
+ gap: 4,
131
+ },
132
+ ruleRow: {
133
+ flexDirection: 'row',
134
+ alignItems: 'center',
135
+ gap: 6,
136
+ },
137
+ ruleText: {
138
+ fontSize: theme.typography.helperFontSize,
139
+ fontFamily: theme.typography.fontFamily,
140
+ },
141
+ rulePassed: {
142
+ color: theme.colors.success,
143
+ },
144
+ ruleFailed: {
145
+ color: theme.colors.placeholder,
146
+ },
147
+ });
148
+ }
@@ -0,0 +1,2 @@
1
+ export { FieldFlowPasswordStrength } from './FieldFlowPasswordStrength';
2
+ export type { FieldFlowPasswordStrengthProps } from './FieldFlowPasswordStrength';