@rxap/forms 19.2.0-dev.1 → 21.0.1-dev.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 (462) hide show
  1. package/CHANGELOG.md +27 -0
  2. package/compodoc/changelog.html +24 -0
  3. package/compodoc/classes/FormArrayControlManager.html +13 -10
  4. package/compodoc/classes/RxapFormArray.html +3 -1
  5. package/compodoc/classes/RxapFormBuilder.html +13 -10
  6. package/compodoc/classes/RxapFormControl.html +3 -1
  7. package/compodoc/classes/RxapFormGroup.html +3 -1
  8. package/compodoc/dependencies.html +13 -13
  9. package/compodoc/js/search/search_index.js +2 -2
  10. package/compodoc/properties.html +1 -1
  11. package/docs/documentation.json +12279 -9865
  12. package/docs/html/assets/hierarchy.js +1 -1
  13. package/docs/html/classes/ControlValueAccessor.html +5 -5
  14. package/docs/html/classes/FormArrayControlManager.html +2 -2
  15. package/docs/html/classes/FormControlErrorDirective.html +5 -5
  16. package/docs/html/classes/FormControlMarkDirtyDirective.html +2 -2
  17. package/docs/html/classes/FormControlMarkPristineDirective.html +2 -2
  18. package/docs/html/classes/FormControlMarkTouchedDirective.html +2 -2
  19. package/docs/html/classes/FormControlMarkUntouchedDirective.html +2 -2
  20. package/docs/html/classes/FormControlNameDirective.html +33 -33
  21. package/docs/html/classes/FormDirective.html +47 -47
  22. package/docs/html/classes/FormGroupNameDirective.html +28 -28
  23. package/docs/html/classes/FormLoadedDirective.html +4 -4
  24. package/docs/html/classes/FormLoadingDirective.html +4 -4
  25. package/docs/html/classes/FormLoadingErrorDirective.html +4 -4
  26. package/docs/html/classes/FormResetDirective.html +2 -2
  27. package/docs/html/classes/FormSubmitDirective.html +3 -3
  28. package/docs/html/classes/FormSubmitFailedDirective.html +4 -4
  29. package/docs/html/classes/FormSubmitInvalidDirective.html +4 -4
  30. package/docs/html/classes/FormSubmitSuccessfulDirective.html +4 -4
  31. package/docs/html/classes/FormSubmittingDirective.html +4 -4
  32. package/docs/html/classes/ParentControlContainerDirective.html +2 -2
  33. package/docs/html/classes/RxapFormArray.html +96 -79
  34. package/docs/html/classes/RxapFormBuilder.html +2 -2
  35. package/docs/html/classes/RxapFormControl.html +92 -75
  36. package/docs/html/classes/RxapFormGroup.html +93 -77
  37. package/docs/html/classes/RxapFormsModule.html +2 -2
  38. package/docs/html/enums/MetadataKeys.html +2 -2
  39. package/docs/html/functions/ControlAsyncValidator.html +1 -1
  40. package/docs/html/functions/ControlChange.html +1 -1
  41. package/docs/html/functions/ControlSetValue.html +1 -1
  42. package/docs/html/functions/ControlValidator.html +1 -1
  43. package/docs/html/functions/IsArray.html +1 -1
  44. package/docs/html/functions/IsBoolean.html +1 -1
  45. package/docs/html/functions/IsComplex.html +1 -1
  46. package/docs/html/functions/IsDate.html +1 -1
  47. package/docs/html/functions/IsEmail.html +1 -1
  48. package/docs/html/functions/IsEnum.html +1 -1
  49. package/docs/html/functions/IsIP.html +1 -1
  50. package/docs/html/functions/IsInt.html +1 -1
  51. package/docs/html/functions/IsNumber-1.html +2 -2
  52. package/docs/html/functions/IsObject.html +1 -1
  53. package/docs/html/functions/IsPhoneNumber.html +1 -1
  54. package/docs/html/functions/IsPort.html +1 -1
  55. package/docs/html/functions/IsString.html +1 -1
  56. package/docs/html/functions/IsUUID.html +1 -1
  57. package/docs/html/functions/IsUrl.html +1 -1
  58. package/docs/html/functions/RxapForm.html +1 -1
  59. package/docs/html/functions/ToFormMethod.html +1 -1
  60. package/docs/html/functions/ToFormSubmitMethod.html +2 -2
  61. package/docs/html/functions/UseFormArrayControl.html +1 -1
  62. package/docs/html/functions/UseFormArrayGroup.html +1 -1
  63. package/docs/html/functions/UseFormControl.html +1 -1
  64. package/docs/html/functions/UseFormGroup.html +1 -1
  65. package/docs/html/functions/_IsNumber.html +1 -1
  66. package/docs/html/functions/controlDisabledWhile.html +1 -1
  67. package/docs/html/functions/controlDisabled_.html +1 -1
  68. package/docs/html/functions/controlEnabledWhile.html +1 -1
  69. package/docs/html/functions/controlEnabled_.html +1 -1
  70. package/docs/html/functions/controlErrorChanges_.html +1 -1
  71. package/docs/html/functions/controlReadonly_.html +1 -1
  72. package/docs/html/functions/controlStatusChanges_.html +1 -1
  73. package/docs/html/functions/controlValueChanges_.html +1 -1
  74. package/docs/html/functions/disableControl.html +1 -1
  75. package/docs/html/functions/enableControl.html +1 -1
  76. package/docs/html/functions/hasErrorAndDirty.html +1 -1
  77. package/docs/html/functions/hasErrorAndTouched.html +1 -1
  78. package/docs/html/functions/isNumber.html +2 -2
  79. package/docs/html/functions/markAllDirty.html +1 -1
  80. package/docs/html/functions/markAllPristine.html +1 -1
  81. package/docs/html/functions/markAllUntouched.html +1 -1
  82. package/docs/html/functions/mergeControlValidators.html +1 -1
  83. package/docs/html/functions/selectControlValue_.html +1 -1
  84. package/docs/html/functions/validateControlOn.html +1 -1
  85. package/docs/html/hierarchy.html +1 -1
  86. package/docs/html/index.html +2 -2
  87. package/docs/html/interfaces/AbstractControl.html +95 -71
  88. package/docs/html/interfaces/AbstractControlOptions.html +4 -4
  89. package/docs/html/interfaces/BoxedValue.html +2 -2
  90. package/docs/html/interfaces/ComplexityOptions.html +2 -2
  91. package/docs/html/interfaces/ControlOptions.html +3 -3
  92. package/docs/html/interfaces/ControlSetValueOptions.html +2 -2
  93. package/docs/html/interfaces/FormArrayOptions.html +4 -4
  94. package/docs/html/interfaces/FormDefinition.html +6 -6
  95. package/docs/html/interfaces/FormDefinitionArray.html +43 -36
  96. package/docs/html/interfaces/FormDefinitionMetadata.html +5 -5
  97. package/docs/html/interfaces/FormGroupOptions.html +4 -4
  98. package/docs/html/interfaces/FormLoadFailedMethod.html +2 -2
  99. package/docs/html/interfaces/FormLoadMethod.html +2 -2
  100. package/docs/html/interfaces/FormLoadSuccessfulMethod.html +2 -2
  101. package/docs/html/interfaces/FormOptions.html +4 -4
  102. package/docs/html/interfaces/FormSubmitFailedMethod.html +2 -2
  103. package/docs/html/interfaces/FormSubmitMethod.html +2 -2
  104. package/docs/html/interfaces/FormSubmitSuccessfulMethod.html +2 -2
  105. package/docs/html/interfaces/InjectableValidator.html +2 -2
  106. package/docs/html/interfaces/IsNumberOptions.html +3 -3
  107. package/docs/html/interfaces/NgValidatorsErrors.html +2 -2
  108. package/docs/html/interfaces/RxapAbstractControlOptionsWithDefinition.html +4 -4
  109. package/docs/html/interfaces/_RxapAbstractControlOptions.html +4 -4
  110. package/docs/html/modules.html +1 -1
  111. package/docs/html/types/AsyncValidator.html +1 -1
  112. package/docs/html/types/AsyncValidatorFn.html +1 -1
  113. package/docs/html/types/ChangeFn.html +1 -1
  114. package/docs/html/types/ControlEventOptions.html +1 -1
  115. package/docs/html/types/ControlInsertedFn.html +1 -1
  116. package/docs/html/types/ControlPath.html +1 -1
  117. package/docs/html/types/ControlRemovedFn.html +1 -1
  118. package/docs/html/types/ControlState.html +1 -1
  119. package/docs/html/types/EmitEvent.html +1 -1
  120. package/docs/html/types/ExtractAbstractControl.html +1 -1
  121. package/docs/html/types/ExtractStrings.html +1 -1
  122. package/docs/html/types/FormBuilderFn.html +1 -1
  123. package/docs/html/types/FormType.html +1 -1
  124. package/docs/html/types/KeyValueControls.html +1 -1
  125. package/docs/html/types/OnlySelf.html +1 -1
  126. package/docs/html/types/OrBoxedValue.html +1 -1
  127. package/docs/html/types/RxapAbstractControlOptions.html +1 -1
  128. package/docs/html/types/SetValueFn.html +1 -1
  129. package/docs/html/types/ValidationErrors.html +1 -1
  130. package/docs/html/types/Validator.html +1 -1
  131. package/docs/html/types/ValidatorFn.html +1 -1
  132. package/docs/html/types/ValidatorOrOpts.html +1 -1
  133. package/docs/html/variables/RXAP_FORM_CONTEXT.html +1 -1
  134. package/docs/html/variables/RXAP_FORM_DEFINITION.html +1 -1
  135. package/docs/html/variables/RXAP_FORM_DEFINITION_BUILDER.html +1 -1
  136. package/docs/html/variables/RXAP_FORM_INITIAL_STATE.html +1 -1
  137. package/docs/html/variables/RXAP_FORM_LOAD_FAILED_METHOD.html +1 -1
  138. package/docs/html/variables/RXAP_FORM_LOAD_METHOD.html +1 -1
  139. package/docs/html/variables/RXAP_FORM_LOAD_SUCCESSFUL_METHOD.html +1 -1
  140. package/docs/html/variables/RXAP_FORM_SUBMIT_FAILED_METHOD.html +1 -1
  141. package/docs/html/variables/RXAP_FORM_SUBMIT_METHOD.html +1 -1
  142. package/docs/html/variables/RXAP_FORM_SUBMIT_SUCCESSFUL_METHOD.html +1 -1
  143. package/docs/html/variables/RxapValidators.html +1 -1
  144. package/docs/markdown/README.md +1 -1
  145. package/docs/markdown/classes/ControlValueAccessor.md +8 -8
  146. package/docs/markdown/classes/FormArrayControlManager.md +6 -6
  147. package/docs/markdown/classes/FormControlErrorDirective.md +7 -7
  148. package/docs/markdown/classes/FormControlMarkDirtyDirective.md +4 -4
  149. package/docs/markdown/classes/FormControlMarkPristineDirective.md +4 -4
  150. package/docs/markdown/classes/FormControlMarkTouchedDirective.md +4 -4
  151. package/docs/markdown/classes/FormControlMarkUntouchedDirective.md +4 -4
  152. package/docs/markdown/classes/FormControlNameDirective.md +36 -38
  153. package/docs/markdown/classes/FormDirective.md +139 -91
  154. package/docs/markdown/classes/FormGroupNameDirective.md +31 -31
  155. package/docs/markdown/classes/FormLoadedDirective.md +5 -5
  156. package/docs/markdown/classes/FormLoadingDirective.md +5 -5
  157. package/docs/markdown/classes/FormLoadingErrorDirective.md +5 -5
  158. package/docs/markdown/classes/FormResetDirective.md +8 -8
  159. package/docs/markdown/classes/FormSubmitDirective.md +15 -15
  160. package/docs/markdown/classes/FormSubmitFailedDirective.md +5 -5
  161. package/docs/markdown/classes/FormSubmitInvalidDirective.md +5 -5
  162. package/docs/markdown/classes/FormSubmitSuccessfulDirective.md +5 -5
  163. package/docs/markdown/classes/FormSubmittingDirective.md +5 -5
  164. package/docs/markdown/classes/ParentControlContainerDirective.md +2 -2
  165. package/docs/markdown/classes/RxapFormArray.md +132 -103
  166. package/docs/markdown/classes/RxapFormBuilder.md +4 -4
  167. package/docs/markdown/classes/RxapFormControl.md +127 -103
  168. package/docs/markdown/classes/RxapFormGroup.md +140 -117
  169. package/docs/markdown/classes/RxapFormsModule.md +2 -2
  170. package/docs/markdown/enumerations/MetadataKeys.md +10 -10
  171. package/docs/markdown/functions/ControlAsyncValidator.md +2 -2
  172. package/docs/markdown/functions/ControlChange.md +2 -2
  173. package/docs/markdown/functions/ControlSetValue.md +2 -2
  174. package/docs/markdown/functions/ControlValidator.md +2 -2
  175. package/docs/markdown/functions/IsArray.md +2 -2
  176. package/docs/markdown/functions/IsBoolean.md +2 -2
  177. package/docs/markdown/functions/IsComplex.md +2 -2
  178. package/docs/markdown/functions/IsDate.md +2 -2
  179. package/docs/markdown/functions/IsEmail.md +2 -2
  180. package/docs/markdown/functions/IsEnum.md +2 -2
  181. package/docs/markdown/functions/IsIP.md +2 -2
  182. package/docs/markdown/functions/IsInt.md +2 -2
  183. package/docs/markdown/functions/IsNumber-2.md +2 -2
  184. package/docs/markdown/functions/IsNumber.md +2 -2
  185. package/docs/markdown/functions/IsObject.md +2 -2
  186. package/docs/markdown/functions/IsPhoneNumber.md +2 -2
  187. package/docs/markdown/functions/IsPort.md +2 -2
  188. package/docs/markdown/functions/IsString.md +2 -2
  189. package/docs/markdown/functions/IsUUID.md +2 -2
  190. package/docs/markdown/functions/IsUrl.md +2 -2
  191. package/docs/markdown/functions/RxapForm.md +2 -2
  192. package/docs/markdown/functions/ToFormMethod.md +2 -2
  193. package/docs/markdown/functions/ToFormSubmitMethod.md +2 -2
  194. package/docs/markdown/functions/UseFormArrayControl.md +2 -2
  195. package/docs/markdown/functions/UseFormArrayGroup.md +2 -2
  196. package/docs/markdown/functions/UseFormControl.md +2 -2
  197. package/docs/markdown/functions/UseFormGroup.md +2 -2
  198. package/docs/markdown/functions/controlDisabled$.md +2 -2
  199. package/docs/markdown/functions/controlDisabledWhile.md +2 -2
  200. package/docs/markdown/functions/controlEnabled$.md +2 -2
  201. package/docs/markdown/functions/controlEnabledWhile.md +2 -2
  202. package/docs/markdown/functions/controlErrorChanges$.md +2 -2
  203. package/docs/markdown/functions/controlReadonly$.md +2 -2
  204. package/docs/markdown/functions/controlStatusChanges$.md +2 -2
  205. package/docs/markdown/functions/controlValueChanges$.md +2 -2
  206. package/docs/markdown/functions/disableControl.md +2 -2
  207. package/docs/markdown/functions/enableControl.md +2 -2
  208. package/docs/markdown/functions/hasErrorAndDirty.md +2 -2
  209. package/docs/markdown/functions/hasErrorAndTouched.md +2 -2
  210. package/docs/markdown/functions/isNumber-1.md +2 -2
  211. package/docs/markdown/functions/markAllDirty.md +2 -2
  212. package/docs/markdown/functions/markAllPristine.md +2 -2
  213. package/docs/markdown/functions/markAllUntouched.md +2 -2
  214. package/docs/markdown/functions/mergeControlValidators.md +2 -2
  215. package/docs/markdown/functions/selectControlValue$.md +2 -2
  216. package/docs/markdown/functions/validateControlOn.md +2 -2
  217. package/docs/markdown/globals.md +2 -2
  218. package/docs/markdown/interfaces/AbstractControl.md +122 -73
  219. package/docs/markdown/interfaces/AbstractControlOptions.md +5 -5
  220. package/docs/markdown/interfaces/BoxedValue.md +4 -4
  221. package/docs/markdown/interfaces/ComplexityOptions.md +12 -12
  222. package/docs/markdown/interfaces/ControlOptions.md +10 -10
  223. package/docs/markdown/interfaces/ControlSetValueOptions.md +4 -4
  224. package/docs/markdown/interfaces/FormArrayOptions.md +15 -15
  225. package/docs/markdown/interfaces/FormDefinition.md +7 -7
  226. package/docs/markdown/interfaces/FormDefinitionArray.md +70 -36
  227. package/docs/markdown/interfaces/FormDefinitionMetadata.md +14 -14
  228. package/docs/markdown/interfaces/FormGroupOptions.md +12 -12
  229. package/docs/markdown/interfaces/FormLoadFailedMethod.md +4 -4
  230. package/docs/markdown/interfaces/FormLoadMethod.md +4 -4
  231. package/docs/markdown/interfaces/FormLoadSuccessfulMethod.md +4 -4
  232. package/docs/markdown/interfaces/FormOptions.md +12 -12
  233. package/docs/markdown/interfaces/FormSubmitFailedMethod.md +4 -4
  234. package/docs/markdown/interfaces/FormSubmitMethod.md +4 -4
  235. package/docs/markdown/interfaces/FormSubmitSuccessfulMethod.md +4 -4
  236. package/docs/markdown/interfaces/InjectableValidator.md +4 -4
  237. package/docs/markdown/interfaces/IsNumberOptions.md +6 -6
  238. package/docs/markdown/interfaces/NgValidatorsErrors.md +9 -9
  239. package/docs/markdown/interfaces/RxapAbstractControlOptions.md +11 -11
  240. package/docs/markdown/interfaces/RxapAbstractControlOptionsWithDefinition.md +12 -12
  241. package/docs/markdown/type-aliases/AsyncValidator.md +2 -2
  242. package/docs/markdown/type-aliases/AsyncValidatorFn.md +2 -2
  243. package/docs/markdown/type-aliases/ChangeFn.md +2 -2
  244. package/docs/markdown/type-aliases/ControlEventOptions.md +2 -2
  245. package/docs/markdown/type-aliases/ControlInsertedFn.md +2 -2
  246. package/docs/markdown/type-aliases/ControlPath.md +2 -2
  247. package/docs/markdown/type-aliases/ControlRemovedFn.md +2 -2
  248. package/docs/markdown/type-aliases/ControlState.md +2 -2
  249. package/docs/markdown/type-aliases/EmitEvent.md +2 -2
  250. package/docs/markdown/type-aliases/ExtractAbstractControl.md +2 -2
  251. package/docs/markdown/type-aliases/ExtractStrings.md +2 -2
  252. package/docs/markdown/type-aliases/FormBuilderFn.md +2 -2
  253. package/docs/markdown/type-aliases/FormType.md +2 -2
  254. package/docs/markdown/type-aliases/KeyValueControls.md +2 -2
  255. package/docs/markdown/type-aliases/OnlySelf.md +2 -2
  256. package/docs/markdown/type-aliases/OrBoxedValue.md +2 -2
  257. package/docs/markdown/type-aliases/RxapAbstractControlOptions.md +2 -2
  258. package/docs/markdown/type-aliases/SetValueFn.md +2 -2
  259. package/docs/markdown/type-aliases/ValidationErrors.md +2 -2
  260. package/docs/markdown/type-aliases/Validator.md +2 -2
  261. package/docs/markdown/type-aliases/ValidatorFn.md +2 -2
  262. package/docs/markdown/type-aliases/ValidatorOrOpts.md +2 -2
  263. package/docs/markdown/variables/RXAP_FORM_CONTEXT.md +2 -2
  264. package/docs/markdown/variables/RXAP_FORM_DEFINITION.md +2 -2
  265. package/docs/markdown/variables/RXAP_FORM_DEFINITION_BUILDER.md +2 -2
  266. package/docs/markdown/variables/RXAP_FORM_INITIAL_STATE.md +2 -2
  267. package/docs/markdown/variables/RXAP_FORM_LOAD_FAILED_METHOD.md +2 -2
  268. package/docs/markdown/variables/RXAP_FORM_LOAD_METHOD.md +2 -2
  269. package/docs/markdown/variables/RXAP_FORM_LOAD_SUCCESSFUL_METHOD.md +2 -2
  270. package/docs/markdown/variables/RXAP_FORM_SUBMIT_FAILED_METHOD.md +2 -2
  271. package/docs/markdown/variables/RXAP_FORM_SUBMIT_METHOD.md +2 -2
  272. package/docs/markdown/variables/RXAP_FORM_SUBMIT_SUCCESSFUL_METHOD.md +2 -2
  273. package/docs/markdown/variables/RxapValidators.md +2 -2
  274. package/docs/wiki/Class.ControlValueAccessor.md +7 -7
  275. package/docs/wiki/Class.FormArrayControlManager.md +5 -5
  276. package/docs/wiki/Class.FormControlErrorDirective.md +6 -6
  277. package/docs/wiki/Class.FormControlMarkDirtyDirective.md +3 -3
  278. package/docs/wiki/Class.FormControlMarkPristineDirective.md +3 -3
  279. package/docs/wiki/Class.FormControlMarkTouchedDirective.md +3 -3
  280. package/docs/wiki/Class.FormControlMarkUntouchedDirective.md +3 -3
  281. package/docs/wiki/Class.FormControlNameDirective.md +35 -37
  282. package/docs/wiki/Class.FormDirective.md +138 -90
  283. package/docs/wiki/Class.FormGroupNameDirective.md +30 -30
  284. package/docs/wiki/Class.FormLoadedDirective.md +4 -4
  285. package/docs/wiki/Class.FormLoadingDirective.md +4 -4
  286. package/docs/wiki/Class.FormLoadingErrorDirective.md +4 -4
  287. package/docs/wiki/Class.FormResetDirective.md +7 -7
  288. package/docs/wiki/Class.FormSubmitDirective.md +14 -14
  289. package/docs/wiki/Class.FormSubmitFailedDirective.md +4 -4
  290. package/docs/wiki/Class.FormSubmitInvalidDirective.md +4 -4
  291. package/docs/wiki/Class.FormSubmitSuccessfulDirective.md +4 -4
  292. package/docs/wiki/Class.FormSubmittingDirective.md +4 -4
  293. package/docs/wiki/Class.ParentControlContainerDirective.md +1 -1
  294. package/docs/wiki/Class.RxapFormArray.md +131 -102
  295. package/docs/wiki/Class.RxapFormBuilder.md +3 -3
  296. package/docs/wiki/Class.RxapFormControl.md +126 -102
  297. package/docs/wiki/Class.RxapFormGroup.md +139 -116
  298. package/docs/wiki/Class.RxapFormsModule.md +1 -1
  299. package/docs/wiki/Enumeration.MetadataKeys.md +9 -9
  300. package/docs/wiki/Function.ControlAsyncValidator.md +1 -1
  301. package/docs/wiki/Function.ControlChange.md +1 -1
  302. package/docs/wiki/Function.ControlSetValue.md +1 -1
  303. package/docs/wiki/Function.ControlValidator.md +1 -1
  304. package/docs/wiki/Function.IsArray.md +1 -1
  305. package/docs/wiki/Function.IsBoolean.md +1 -1
  306. package/docs/wiki/Function.IsComplex.md +1 -1
  307. package/docs/wiki/Function.IsDate.md +1 -1
  308. package/docs/wiki/Function.IsEmail.md +1 -1
  309. package/docs/wiki/Function.IsEnum.md +1 -1
  310. package/docs/wiki/Function.IsIP.md +1 -1
  311. package/docs/wiki/Function.IsInt.md +1 -1
  312. package/docs/wiki/Function.IsNumber.md +1 -1
  313. package/docs/wiki/Function.IsObject.md +1 -1
  314. package/docs/wiki/Function.IsPhoneNumber.md +1 -1
  315. package/docs/wiki/Function.IsPort.md +1 -1
  316. package/docs/wiki/Function.IsString.md +1 -1
  317. package/docs/wiki/Function.IsUUID.md +1 -1
  318. package/docs/wiki/Function.IsUrl.md +1 -1
  319. package/docs/wiki/Function.RxapForm.md +1 -1
  320. package/docs/wiki/Function.ToFormMethod.md +1 -1
  321. package/docs/wiki/Function.ToFormSubmitMethod.md +1 -1
  322. package/docs/wiki/Function.UseFormArrayControl.md +1 -1
  323. package/docs/wiki/Function.UseFormArrayGroup.md +1 -1
  324. package/docs/wiki/Function.UseFormControl.md +1 -1
  325. package/docs/wiki/Function.UseFormGroup.md +1 -1
  326. package/docs/wiki/Function._IsNumber.md +1 -1
  327. package/docs/wiki/Function.controlDisabled$.md +1 -1
  328. package/docs/wiki/Function.controlDisabledWhile.md +1 -1
  329. package/docs/wiki/Function.controlEnabled$.md +1 -1
  330. package/docs/wiki/Function.controlEnabledWhile.md +1 -1
  331. package/docs/wiki/Function.controlErrorChanges$.md +1 -1
  332. package/docs/wiki/Function.controlReadonly$.md +1 -1
  333. package/docs/wiki/Function.controlStatusChanges$.md +1 -1
  334. package/docs/wiki/Function.controlValueChanges$.md +1 -1
  335. package/docs/wiki/Function.disableControl.md +1 -1
  336. package/docs/wiki/Function.enableControl.md +1 -1
  337. package/docs/wiki/Function.hasErrorAndDirty.md +1 -1
  338. package/docs/wiki/Function.hasErrorAndTouched.md +1 -1
  339. package/docs/wiki/Function.isNumber.md +1 -1
  340. package/docs/wiki/Function.markAllDirty.md +1 -1
  341. package/docs/wiki/Function.markAllPristine.md +1 -1
  342. package/docs/wiki/Function.markAllUntouched.md +1 -1
  343. package/docs/wiki/Function.mergeControlValidators.md +1 -1
  344. package/docs/wiki/Function.selectControlValue$.md +1 -1
  345. package/docs/wiki/Function.validateControlOn.md +1 -1
  346. package/docs/wiki/Interface.AbstractControl.md +121 -72
  347. package/docs/wiki/Interface.AbstractControlOptions.md +4 -4
  348. package/docs/wiki/Interface.BoxedValue.md +3 -3
  349. package/docs/wiki/Interface.ComplexityOptions.md +11 -11
  350. package/docs/wiki/Interface.ControlOptions.md +9 -9
  351. package/docs/wiki/Interface.ControlSetValueOptions.md +3 -3
  352. package/docs/wiki/Interface.FormArrayOptions.md +14 -14
  353. package/docs/wiki/Interface.FormDefinition.md +6 -6
  354. package/docs/wiki/Interface.FormDefinitionArray.md +69 -35
  355. package/docs/wiki/Interface.FormDefinitionMetadata.md +13 -13
  356. package/docs/wiki/Interface.FormGroupOptions.md +11 -11
  357. package/docs/wiki/Interface.FormLoadFailedMethod.md +3 -3
  358. package/docs/wiki/Interface.FormLoadMethod.md +3 -3
  359. package/docs/wiki/Interface.FormLoadSuccessfulMethod.md +3 -3
  360. package/docs/wiki/Interface.FormOptions.md +11 -11
  361. package/docs/wiki/Interface.FormSubmitFailedMethod.md +3 -3
  362. package/docs/wiki/Interface.FormSubmitMethod.md +3 -3
  363. package/docs/wiki/Interface.FormSubmitSuccessfulMethod.md +3 -3
  364. package/docs/wiki/Interface.InjectableValidator.md +3 -3
  365. package/docs/wiki/Interface.IsNumberOptions.md +5 -5
  366. package/docs/wiki/Interface.NgValidatorsErrors.md +8 -8
  367. package/docs/wiki/Interface.RxapAbstractControlOptionsWithDefinition.md +11 -11
  368. package/docs/wiki/Interface._RxapAbstractControlOptions.md +10 -10
  369. package/docs/wiki/TypeAlias.AsyncValidator.md +1 -1
  370. package/docs/wiki/TypeAlias.AsyncValidatorFn.md +1 -1
  371. package/docs/wiki/TypeAlias.ChangeFn.md +1 -1
  372. package/docs/wiki/TypeAlias.ControlEventOptions.md +1 -1
  373. package/docs/wiki/TypeAlias.ControlInsertedFn.md +1 -1
  374. package/docs/wiki/TypeAlias.ControlPath.md +1 -1
  375. package/docs/wiki/TypeAlias.ControlRemovedFn.md +1 -1
  376. package/docs/wiki/TypeAlias.ControlState.md +1 -1
  377. package/docs/wiki/TypeAlias.EmitEvent.md +1 -1
  378. package/docs/wiki/TypeAlias.ExtractAbstractControl.md +1 -1
  379. package/docs/wiki/TypeAlias.ExtractStrings.md +1 -1
  380. package/docs/wiki/TypeAlias.FormBuilderFn.md +1 -1
  381. package/docs/wiki/TypeAlias.FormType.md +1 -1
  382. package/docs/wiki/TypeAlias.KeyValueControls.md +1 -1
  383. package/docs/wiki/TypeAlias.OnlySelf.md +1 -1
  384. package/docs/wiki/TypeAlias.OrBoxedValue.md +1 -1
  385. package/docs/wiki/TypeAlias.RxapAbstractControlOptions.md +1 -1
  386. package/docs/wiki/TypeAlias.SetValueFn.md +1 -1
  387. package/docs/wiki/TypeAlias.ValidationErrors.md +1 -1
  388. package/docs/wiki/TypeAlias.Validator.md +1 -1
  389. package/docs/wiki/TypeAlias.ValidatorFn.md +1 -1
  390. package/docs/wiki/TypeAlias.ValidatorOrOpts.md +1 -1
  391. package/docs/wiki/Variable.RXAP_FORM_CONTEXT.md +1 -1
  392. package/docs/wiki/Variable.RXAP_FORM_DEFINITION.md +1 -1
  393. package/docs/wiki/Variable.RXAP_FORM_DEFINITION_BUILDER.md +1 -1
  394. package/docs/wiki/Variable.RXAP_FORM_INITIAL_STATE.md +1 -1
  395. package/docs/wiki/Variable.RXAP_FORM_LOAD_FAILED_METHOD.md +1 -1
  396. package/docs/wiki/Variable.RXAP_FORM_LOAD_METHOD.md +1 -1
  397. package/docs/wiki/Variable.RXAP_FORM_LOAD_SUCCESSFUL_METHOD.md +1 -1
  398. package/docs/wiki/Variable.RXAP_FORM_SUBMIT_FAILED_METHOD.md +1 -1
  399. package/docs/wiki/Variable.RXAP_FORM_SUBMIT_METHOD.md +1 -1
  400. package/docs/wiki/Variable.RXAP_FORM_SUBMIT_SUCCESSFUL_METHOD.md +1 -1
  401. package/docs/wiki/Variable.RxapValidators.md +1 -1
  402. package/docs/wiki/globals.md +1 -1
  403. package/fesm2022/rxap-forms.mjs +79 -78
  404. package/fesm2022/rxap-forms.mjs.map +1 -1
  405. package/package.json +35 -30
  406. package/types/rxap-forms.d.ts +979 -0
  407. package/index.d.ts +0 -55
  408. package/lib/control-actions.d.ts +0 -23
  409. package/lib/control-value-accessor.d.ts +0 -9
  410. package/lib/decorators/control-async-validator.d.ts +0 -1
  411. package/lib/decorators/control-change.d.ts +0 -1
  412. package/lib/decorators/control-set-value.d.ts +0 -5
  413. package/lib/decorators/control-validator.d.ts +0 -1
  414. package/lib/decorators/form.d.ts +0 -2
  415. package/lib/decorators/metadata-keys.d.ts +0 -10
  416. package/lib/decorators/use-form-array.d.ts +0 -4
  417. package/lib/decorators/use-form-control.d.ts +0 -2
  418. package/lib/decorators/use-form-group.d.ts +0 -3
  419. package/lib/directives/form-control-error.directive.d.ts +0 -22
  420. package/lib/directives/form-control-mark-dirty.directive.d.ts +0 -9
  421. package/lib/directives/form-control-mark-pristine.directive.d.ts +0 -9
  422. package/lib/directives/form-control-mark-touched.directive.d.ts +0 -9
  423. package/lib/directives/form-control-mark-untouched.directive.d.ts +0 -9
  424. package/lib/directives/form-control-name.directive.d.ts +0 -16
  425. package/lib/directives/form-group-name.directive.d.ts +0 -16
  426. package/lib/directives/form-loaded.directive.d.ts +0 -14
  427. package/lib/directives/form-loading-error.directive.d.ts +0 -16
  428. package/lib/directives/form-loading.directive.d.ts +0 -14
  429. package/lib/directives/form-reset.directive.d.ts +0 -11
  430. package/lib/directives/form-submit-failed.directive.d.ts +0 -16
  431. package/lib/directives/form-submit-invalid.directive.d.ts +0 -16
  432. package/lib/directives/form-submit-successful.directive.d.ts +0 -16
  433. package/lib/directives/form-submit.directive.d.ts +0 -22
  434. package/lib/directives/form-submitting.directive.d.ts +0 -14
  435. package/lib/directives/form.directive.d.ts +0 -62
  436. package/lib/directives/forms.module.d.ts +0 -23
  437. package/lib/directives/models.d.ts +0 -29
  438. package/lib/directives/parent-control-container.directive.d.ts +0 -5
  439. package/lib/directives/tokens.d.ts +0 -12
  440. package/lib/form-array.d.ts +0 -76
  441. package/lib/form-builder.d.ts +0 -96
  442. package/lib/form-control.d.ts +0 -64
  443. package/lib/form-group.d.ts +0 -89
  444. package/lib/model.d.ts +0 -81
  445. package/lib/tokens.d.ts +0 -3
  446. package/lib/types.d.ts +0 -100
  447. package/lib/validators/index.d.ts +0 -32
  448. package/lib/validators/is-array.d.ts +0 -4
  449. package/lib/validators/is-boolean.d.ts +0 -4
  450. package/lib/validators/is-complex.d.ts +0 -17
  451. package/lib/validators/is-date.d.ts +0 -4
  452. package/lib/validators/is-email.d.ts +0 -6
  453. package/lib/validators/is-enum.d.ts +0 -5
  454. package/lib/validators/is-int.d.ts +0 -6
  455. package/lib/validators/is-ip.d.ts +0 -5
  456. package/lib/validators/is-number.d.ts +0 -24
  457. package/lib/validators/is-object.d.ts +0 -4
  458. package/lib/validators/is-phone-number.d.ts +0 -7
  459. package/lib/validators/is-port.d.ts +0 -4
  460. package/lib/validators/is-string.d.ts +0 -4
  461. package/lib/validators/is-url.d.ts +0 -6
  462. package/lib/validators/is-uuid.d.ts +0 -5
@@ -1,4 +1,4 @@
1
- [**@rxap/forms v19.2.0-dev.1**](../README.md)
1
+ [**@rxap/forms v21.0.1-dev.0**](../README.md)
2
2
 
3
3
  ***
4
4
 
@@ -6,7 +6,7 @@
6
6
 
7
7
  # Interface: AbstractControl\<T\>
8
8
 
9
- Defined in: [packages/angular/forms/src/lib/types.ts:71](https://gitlab.com/rxap/packages/-/blob/c440f5cccebab3281a30a4b253e4e1fc490fe1e4/packages/angular/forms/src/lib/types.ts#L71)
9
+ Defined in: [packages/angular/forms/src/lib/types.ts:71](https://gitlab.com/rxap/packages/-/blob/b20edab0a4af1993e07e7860064bb449d7fa067b/packages/angular/forms/src/lib/types.ts#L71)
10
10
 
11
11
  ## Extends
12
12
 
@@ -22,7 +22,7 @@ Defined in: [packages/angular/forms/src/lib/types.ts:71](https://gitlab.com/rxap
22
22
 
23
23
  > `optional` **controlId**: `string`
24
24
 
25
- Defined in: [packages/angular/forms/src/lib/types.ts:73](https://gitlab.com/rxap/packages/-/blob/c440f5cccebab3281a30a4b253e4e1fc490fe1e4/packages/angular/forms/src/lib/types.ts#L73)
25
+ Defined in: [packages/angular/forms/src/lib/types.ts:73](https://gitlab.com/rxap/packages/-/blob/b20edab0a4af1993e07e7860064bb449d7fa067b/packages/angular/forms/src/lib/types.ts#L73)
26
26
 
27
27
  ***
28
28
 
@@ -30,7 +30,7 @@ Defined in: [packages/angular/forms/src/lib/types.ts:73](https://gitlab.com/rxap
30
30
 
31
31
  > `readonly` **errors**: `null` \| `ValidationErrors`
32
32
 
33
- Defined in: node\_modules/@angular/forms/index.d.ts:2231
33
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2643
34
34
 
35
35
  An object containing any errors generated by failing validation,
36
36
  or null if there are no errors.
@@ -45,7 +45,7 @@ or null if there are no errors.
45
45
 
46
46
  > `readonly` **events**: `Observable`\<`ControlEvent`\<`any`\>\>
47
47
 
48
- Defined in: node\_modules/@angular/forms/index.d.ts:2278
48
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2691
49
49
 
50
50
  A multicasting observable that emits an event every time the state of the control changes.
51
51
  It emits for value, status, pristine or touched changes.
@@ -57,6 +57,10 @@ of this event might result in getting a value that has not been updated yet. Sub
57
57
  `events` of the parent control instead.
58
58
  For other event types, the events are emitted after the parent control has been updated.
59
59
 
60
+ #### See
61
+
62
+ [Unified control state change events](guide/forms/reactive-forms#unified-control-state-change-events)
63
+
60
64
  #### Inherited from
61
65
 
62
66
  `NgAbstractControl.events`
@@ -67,7 +71,7 @@ For other event types, the events are emitted after the parent control has been
67
71
 
68
72
  > `optional` **fullControlPath**: `string`
69
73
 
70
- Defined in: [packages/angular/forms/src/lib/types.ts:74](https://gitlab.com/rxap/packages/-/blob/c440f5cccebab3281a30a4b253e4e1fc490fe1e4/packages/angular/forms/src/lib/types.ts#L74)
74
+ Defined in: [packages/angular/forms/src/lib/types.ts:74](https://gitlab.com/rxap/packages/-/blob/b20edab0a4af1993e07e7860064bb449d7fa067b/packages/angular/forms/src/lib/types.ts#L74)
71
75
 
72
76
  ***
73
77
 
@@ -75,7 +79,7 @@ Defined in: [packages/angular/forms/src/lib/types.ts:74](https://gitlab.com/rxap
75
79
 
76
80
  > `optional` **readonly**: `boolean`
77
81
 
78
- Defined in: [packages/angular/forms/src/lib/types.ts:76](https://gitlab.com/rxap/packages/-/blob/c440f5cccebab3281a30a4b253e4e1fc490fe1e4/packages/angular/forms/src/lib/types.ts#L76)
82
+ Defined in: [packages/angular/forms/src/lib/types.ts:76](https://gitlab.com/rxap/packages/-/blob/b20edab0a4af1993e07e7860064bb449d7fa067b/packages/angular/forms/src/lib/types.ts#L76)
79
83
 
80
84
  ***
81
85
 
@@ -83,7 +87,7 @@ Defined in: [packages/angular/forms/src/lib/types.ts:76](https://gitlab.com/rxap
83
87
 
84
88
  > `optional` **rxapFormDefinition**: [`FormDefinition`](FormDefinition.md)\<`any`, `any`, `any`\>
85
89
 
86
- Defined in: [packages/angular/forms/src/lib/types.ts:75](https://gitlab.com/rxap/packages/-/blob/c440f5cccebab3281a30a4b253e4e1fc490fe1e4/packages/angular/forms/src/lib/types.ts#L75)
90
+ Defined in: [packages/angular/forms/src/lib/types.ts:75](https://gitlab.com/rxap/packages/-/blob/b20edab0a4af1993e07e7860064bb449d7fa067b/packages/angular/forms/src/lib/types.ts#L75)
87
91
 
88
92
  ***
89
93
 
@@ -91,7 +95,7 @@ Defined in: [packages/angular/forms/src/lib/types.ts:75](https://gitlab.com/rxap
91
95
 
92
96
  > `optional` **stateChanges**: `Subject`\<`any`\>
93
97
 
94
- Defined in: [packages/angular/forms/src/lib/types.ts:77](https://gitlab.com/rxap/packages/-/blob/c440f5cccebab3281a30a4b253e4e1fc490fe1e4/packages/angular/forms/src/lib/types.ts#L77)
98
+ Defined in: [packages/angular/forms/src/lib/types.ts:77](https://gitlab.com/rxap/packages/-/blob/b20edab0a4af1993e07e7860064bb449d7fa067b/packages/angular/forms/src/lib/types.ts#L77)
95
99
 
96
100
  ***
97
101
 
@@ -99,7 +103,7 @@ Defined in: [packages/angular/forms/src/lib/types.ts:77](https://gitlab.com/rxap
99
103
 
100
104
  > `readonly` **statusChanges**: `Observable`\<`FormControlStatus`\>
101
105
 
102
- Defined in: node\_modules/@angular/forms/index.d.ts:2298
106
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2711
103
107
 
104
108
  A multicasting observable that emits an event every time the validation `status` of the control
105
109
  recalculates.
@@ -119,7 +123,7 @@ recalculates.
119
123
 
120
124
  > **value**: `T`
121
125
 
122
- Defined in: [packages/angular/forms/src/lib/types.ts:72](https://gitlab.com/rxap/packages/-/blob/c440f5cccebab3281a30a4b253e4e1fc490fe1e4/packages/angular/forms/src/lib/types.ts#L72)
126
+ Defined in: [packages/angular/forms/src/lib/types.ts:72](https://gitlab.com/rxap/packages/-/blob/b20edab0a4af1993e07e7860064bb449d7fa067b/packages/angular/forms/src/lib/types.ts#L72)
123
127
 
124
128
  The current value of the control.
125
129
 
@@ -128,7 +132,8 @@ The current value of the control.
128
132
  with a key-value pair for each member of the group.
129
133
  * For a disabled `FormGroup`, the values of all controls as an object
130
134
  with a key-value pair for each member of the group.
131
- * For a `FormArray`, the values of enabled controls as an array.
135
+ * For an enabled `FormArray`, the values of enabled controls as an array.
136
+ * For a disabled `FormArray`, the values of all controls as an array.
132
137
 
133
138
  #### Overrides
134
139
 
@@ -140,7 +145,7 @@ with a key-value pair for each member of the group.
140
145
 
141
146
  > `readonly` **valueChanges**: `Observable`\<`any`\>
142
147
 
143
- Defined in: node\_modules/@angular/forms/index.d.ts:2290
148
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2703
144
149
 
145
150
  A multicasting observable that emits an event every time the value of the control changes, in
146
151
  the UI or programmatically. It also emits an event each time you call enable() or disable()
@@ -164,7 +169,7 @@ event might result in getting a value that has not been updated yet. Subscribe t
164
169
 
165
170
  > **get** **asyncValidator**(): `null` \| `AsyncValidatorFn`
166
171
 
167
- Defined in: node\_modules/@angular/forms/index.d.ts:2161
172
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2573
168
173
 
169
174
  Returns the function that is used to determine the validity of this control asynchronously.
170
175
  If multiple validators have been added, this will be a single composed function.
@@ -178,7 +183,7 @@ See `Validators.compose()` for additional information.
178
183
 
179
184
  > **set** **asyncValidator**(`asyncValidatorFn`): `void`
180
185
 
181
- Defined in: node\_modules/@angular/forms/index.d.ts:2162
186
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2574
182
187
 
183
188
  ##### Parameters
184
189
 
@@ -202,7 +207,7 @@ Defined in: node\_modules/@angular/forms/index.d.ts:2162
202
207
 
203
208
  > **get** **dirty**(): `boolean`
204
209
 
205
- Defined in: node\_modules/@angular/forms/index.d.ts:2249
210
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2661
206
211
 
207
212
  A control is `dirty` if the user has changed the value
208
213
  in the UI.
@@ -226,7 +231,7 @@ Programmatic changes to a control's value do not mark it dirty.
226
231
 
227
232
  > **get** **disabled**(): `boolean`
228
233
 
229
- Defined in: node\_modules/@angular/forms/index.d.ts:2216
234
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2628
230
235
 
231
236
  A control is `disabled` when its `status` is `DISABLED`.
232
237
 
@@ -256,7 +261,7 @@ True if the control is disabled, false otherwise.
256
261
 
257
262
  > **get** **enabled**(): `boolean`
258
263
 
259
- Defined in: node\_modules/@angular/forms/index.d.ts:2226
264
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2638
260
265
 
261
266
  A control is `enabled` as long as its `status` is not `DISABLED`.
262
267
 
@@ -283,7 +288,7 @@ false if the status is 'DISABLED'.
283
288
 
284
289
  > **get** **invalid**(): `boolean`
285
290
 
286
- Defined in: node\_modules/@angular/forms/index.d.ts:2195
291
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2607
287
292
 
288
293
  A control is `invalid` when its `status` is `INVALID`.
289
294
 
@@ -310,7 +315,7 @@ false otherwise.
310
315
 
311
316
  > **get** **parent**(): `null` \| `FormGroup`\<`any`\> \| `FormArray`\<`any`\>
312
317
 
313
- Defined in: node\_modules/@angular/forms/index.d.ts:2166
318
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2578
314
319
 
315
320
  The parent control.
316
321
 
@@ -330,7 +335,7 @@ The parent control.
330
335
 
331
336
  > **get** **pending**(): `boolean`
332
337
 
333
- Defined in: node\_modules/@angular/forms/index.d.ts:2204
338
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2616
334
339
 
335
340
  A control is `pending` when its `status` is `PENDING`.
336
341
 
@@ -357,7 +362,7 @@ false otherwise.
357
362
 
358
363
  > **get** **pristine**(): `boolean`
359
364
 
360
- Defined in: node\_modules/@angular/forms/index.d.ts:2239
365
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2651
361
366
 
362
367
  A control is `pristine` if the user has not yet changed
363
368
  the value in the UI.
@@ -373,7 +378,7 @@ Programmatic changes to a control's value do not mark it dirty.
373
378
 
374
379
  > **set** **pristine**(`value`): `void`
375
380
 
376
- Defined in: node\_modules/@angular/forms/index.d.ts:2240
381
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2652
377
382
 
378
383
  ##### Parameters
379
384
 
@@ -397,7 +402,7 @@ Defined in: node\_modules/@angular/forms/index.d.ts:2240
397
402
 
398
403
  > **get** **root**(): `AbstractControl`
399
404
 
400
- Defined in: node\_modules/@angular/forms/index.d.ts:2758
405
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:3203
401
406
 
402
407
  Retrieves the top-level ancestor of this control.
403
408
 
@@ -417,7 +422,7 @@ Retrieves the top-level ancestor of this control.
417
422
 
418
423
  > **get** **status**(): `FormControlStatus`
419
424
 
420
- Defined in: node\_modules/@angular/forms/index.d.ts:2175
425
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2587
421
426
 
422
427
  The validation status of the control.
423
428
 
@@ -436,7 +441,7 @@ both valid AND invalid or invalid AND disabled.
436
441
 
437
442
  > **set** **status**(`value`): `void`
438
443
 
439
- Defined in: node\_modules/@angular/forms/index.d.ts:2176
444
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2588
440
445
 
441
446
  ##### Parameters
442
447
 
@@ -460,7 +465,7 @@ Defined in: node\_modules/@angular/forms/index.d.ts:2176
460
465
 
461
466
  > **get** **touched**(): `boolean`
462
467
 
463
- Defined in: node\_modules/@angular/forms/index.d.ts:2256
468
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2668
464
469
 
465
470
  True if the control is marked as `touched`.
466
471
 
@@ -475,7 +480,7 @@ a `blur` event on it.
475
480
 
476
481
  > **set** **touched**(`value`): `void`
477
482
 
478
- Defined in: node\_modules/@angular/forms/index.d.ts:2257
483
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2669
479
484
 
480
485
  ##### Parameters
481
486
 
@@ -499,7 +504,7 @@ Defined in: node\_modules/@angular/forms/index.d.ts:2257
499
504
 
500
505
  > **get** **untouched**(): `boolean`
501
506
 
502
- Defined in: node\_modules/@angular/forms/index.d.ts:2265
507
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2677
503
508
 
504
509
  True if the control has not been marked as touched
505
510
 
@@ -522,7 +527,7 @@ a `blur` event on it.
522
527
 
523
528
  > **get** **updateOn**(): `FormHooks`
524
529
 
525
- Defined in: node\_modules/@angular/forms/index.d.ts:2305
530
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2718
526
531
 
527
532
  Reports the update strategy of the `AbstractControl` (meaning
528
533
  the event on which the control updates itself).
@@ -545,7 +550,7 @@ Default value: `'change'`
545
550
 
546
551
  > **get** **valid**(): `boolean`
547
552
 
548
- Defined in: node\_modules/@angular/forms/index.d.ts:2186
553
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2598
549
554
 
550
555
  A control is `valid` when its `status` is `VALID`.
551
556
 
@@ -572,7 +577,7 @@ false otherwise.
572
577
 
573
578
  > **get** **validator**(): `null` \| `ValidatorFn`
574
579
 
575
- Defined in: node\_modules/@angular/forms/index.d.ts:2154
580
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2566
576
581
 
577
582
  Returns the function that is used to determine the validity of this control synchronously.
578
583
  If multiple validators have been added, this will be a single composed function.
@@ -586,7 +591,7 @@ See `Validators.compose()` for additional information.
586
591
 
587
592
  > **set** **validator**(`validatorFn`): `void`
588
593
 
589
- Defined in: node\_modules/@angular/forms/index.d.ts:2155
594
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2567
590
595
 
591
596
  ##### Parameters
592
597
 
@@ -608,7 +613,7 @@ Defined in: node\_modules/@angular/forms/index.d.ts:2155
608
613
 
609
614
  > **addAsyncValidators**(`validators`): `void`
610
615
 
611
- Defined in: node\_modules/@angular/forms/index.d.ts:2352
616
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2765
612
617
 
613
618
  Add an asynchronous validator or validators to this control, without affecting other
614
619
  validators.
@@ -640,7 +645,7 @@ The new asynchronous validator function or functions to add to this control.
640
645
 
641
646
  > **addValidators**(`validators`): `void`
642
647
 
643
- Defined in: node\_modules/@angular/forms/index.d.ts:2340
648
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2753
644
649
 
645
650
  Add a synchronous validator or validators to this control, without affecting other validators.
646
651
 
@@ -673,7 +678,7 @@ The new validator function or functions to add to this control.
673
678
 
674
679
  > **clearAsyncValidators**(): `void`
675
680
 
676
- Defined in: node\_modules/@angular/forms/index.d.ts:2443
681
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2852
677
682
 
678
683
  Empties out the async validator list.
679
684
 
@@ -694,7 +699,7 @@ When you add or remove a validator at run time, you must call
694
699
 
695
700
  > **clearValidators**(): `void`
696
701
 
697
- Defined in: node\_modules/@angular/forms/index.d.ts:2435
702
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2844
698
703
 
699
704
  Empties out the synchronous validator list.
700
705
 
@@ -715,7 +720,7 @@ When you add or remove a validator at run time, you must call
715
720
 
716
721
  > **disable**(`opts`?): `void`
717
722
 
718
- Defined in: node\_modules/@angular/forms/index.d.ts:2580
723
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:3020
719
724
 
720
725
  Disables the control. This means the control is exempt from validation checks and
721
726
  excluded from the aggregate value of any parent. Its status is `DISABLED`.
@@ -761,7 +766,7 @@ When false, no events are emitted.
761
766
 
762
767
  > **enable**(`opts`?): `void`
763
768
 
764
- Defined in: node\_modules/@angular/forms/index.d.ts:2602
769
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:3042
765
770
 
766
771
  Enables the control. This means the control is included in validation checks and
767
772
  the aggregate value of its parent. Its status recalculates based on its value and
@@ -808,9 +813,9 @@ When false, no events are emitted.
808
813
 
809
814
  #### Call Signature
810
815
 
811
- > **get**\<`P`\>(`path`): `null` \| `AbstractControl`\<`ɵGetProperty`\<`any`, `P`\>, `ɵGetProperty`\<`any`, `P`\>\>
816
+ > **get**\<`P`\>(`path`): `null` \| `AbstractControl`\<`ɵGetProperty`\<`any`, `P`\>, `ɵGetProperty`\<`any`, `P`\>, `any`\>
812
817
 
813
- Defined in: node\_modules/@angular/forms/index.d.ts:2688
818
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:3133
814
819
 
815
820
  Retrieves a child control given the control's name or path.
816
821
 
@@ -828,7 +833,7 @@ This signature for get supports strings and `const` arrays (`.get(['foo', 'bar']
828
833
 
829
834
  ##### Returns
830
835
 
831
- `null` \| `AbstractControl`\<`ɵGetProperty`\<`any`, `P`\>, `ɵGetProperty`\<`any`, `P`\>\>
836
+ `null` \| `AbstractControl`\<`ɵGetProperty`\<`any`, `P`\>, `ɵGetProperty`\<`any`, `P`\>, `any`\>
832
837
 
833
838
  ##### Inherited from
834
839
 
@@ -836,9 +841,9 @@ This signature for get supports strings and `const` arrays (`.get(['foo', 'bar']
836
841
 
837
842
  #### Call Signature
838
843
 
839
- > **get**\<`P`\>(`path`): `null` \| `AbstractControl`\<`ɵGetProperty`\<`any`, `P`\>, `ɵGetProperty`\<`any`, `P`\>\>
844
+ > **get**\<`P`\>(`path`): `null` \| `AbstractControl`\<`ɵGetProperty`\<`any`, `P`\>, `ɵGetProperty`\<`any`, `P`\>, `any`\>
840
845
 
841
- Defined in: node\_modules/@angular/forms/index.d.ts:2695
846
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:3140
842
847
 
843
848
  Retrieves a child control given the control's name or path.
844
849
 
@@ -857,7 +862,7 @@ information will not be as robust, so prefer to pass a `readonly` array if possi
857
862
 
858
863
  ##### Returns
859
864
 
860
- `null` \| `AbstractControl`\<`ɵGetProperty`\<`any`, `P`\>, `ɵGetProperty`\<`any`, `P`\>\>
865
+ `null` \| `AbstractControl`\<`ɵGetProperty`\<`any`, `P`\>, `ɵGetProperty`\<`any`, `P`\>, `any`\>
861
866
 
862
867
  ##### Inherited from
863
868
 
@@ -869,7 +874,7 @@ information will not be as robust, so prefer to pass a `readonly` array if possi
869
874
 
870
875
  > **getError**(`errorCode`, `path`?): `any`
871
876
 
872
- Defined in: node\_modules/@angular/forms/index.d.ts:2723
877
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:3168
873
878
 
874
879
  #### Parameters
875
880
 
@@ -924,7 +929,7 @@ It can be provided to this method in one of two formats:
924
929
 
925
930
  > **getRawValue**(): `any`
926
931
 
927
- Defined in: node\_modules/@angular/forms/index.d.ts:2629
932
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:3069
928
933
 
929
934
  The raw value of this control. For most control implementations, the raw value will include
930
935
  disabled children.
@@ -943,7 +948,7 @@ disabled children.
943
948
 
944
949
  > **hasAsyncValidator**(`validator`): `boolean`
945
950
 
946
- Defined in: node\_modules/@angular/forms/index.d.ts:2427
951
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2836
947
952
 
948
953
  Check whether an asynchronous validator function is present on this control. The provided
949
954
  validator must be a reference to the exact same function that was provided.
@@ -973,7 +978,7 @@ Whether the provided asynchronous validator was found on this control.
973
978
 
974
979
  > **hasError**(`errorCode`, `path`?): `boolean`
975
980
 
976
- Defined in: node\_modules/@angular/forms/index.d.ts:2754
981
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:3199
977
982
 
978
983
  #### Parameters
979
984
 
@@ -1031,7 +1036,7 @@ If no path is given, this method checks for the error on the current control.
1031
1036
 
1032
1037
  > **hasValidator**(`validator`): `boolean`
1033
1038
 
1034
- Defined in: node\_modules/@angular/forms/index.d.ts:2418
1039
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2827
1035
1040
 
1036
1041
  Check whether a synchronous validator function is present on this control. The provided
1037
1042
  validator must be a reference to the exact same function that was provided.
@@ -1052,9 +1057,7 @@ Whether the provided validator was found on this control.
1052
1057
 
1053
1058
  #### Usage Notes
1054
1059
 
1055
- ### Reference to a ValidatorFn
1056
-
1057
- ```
1060
+ ```ts
1058
1061
  // Reference to the RequiredValidator
1059
1062
  const ctrl = new FormControl<number | null>(0, Validators.required);
1060
1063
  expect(ctrl.hasValidator(Validators.required)).toEqual(true)
@@ -1072,11 +1075,48 @@ expect(ctrl.hasValidator(Validators.min(3))).toEqual(false)
1072
1075
 
1073
1076
  ***
1074
1077
 
1078
+ ### markAllAsDirty()
1079
+
1080
+ > **markAllAsDirty**(`opts`?): `void`
1081
+
1082
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2889
1083
+
1084
+ Marks the control and all its descendant controls as `dirty`.
1085
+
1086
+ #### Parameters
1087
+
1088
+ ##### opts?
1089
+
1090
+ Configuration options that determine how the control propagates changes
1091
+ and emits events after marking is applied.
1092
+ * `emitEvent`: When true or not supplied (the default), the `events`
1093
+ observable emits a `PristineChangeEvent` with the `pristine` property being `false`.
1094
+ When false, no events are emitted.
1095
+
1096
+ ###### emitEvent?
1097
+
1098
+ `boolean`
1099
+
1100
+ #### Returns
1101
+
1102
+ `void`
1103
+
1104
+ #### See
1105
+
1106
+ - [()](AbstractControl.md#markasdirty)
1107
+ - [Managing form control state](guide/forms/reactive-forms#managing-form-control-state)
1108
+
1109
+ #### Inherited from
1110
+
1111
+ `NgAbstractControl.markAllAsDirty`
1112
+
1113
+ ***
1114
+
1075
1115
  ### markAllAsTouched()
1076
1116
 
1077
1117
  > **markAllAsTouched**(`opts`?): `void`
1078
1118
 
1079
- Defined in: node\_modules/@angular/forms/index.d.ts:2474
1119
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2905
1080
1120
 
1081
1121
  Marks the control and all its descendant controls as `touched`.
1082
1122
 
@@ -1100,7 +1140,8 @@ When false, no events are emitted.
1100
1140
 
1101
1141
  #### See
1102
1142
 
1103
- [()](AbstractControl.md#markastouched)
1143
+ - [()](AbstractControl.md#markastouched)
1144
+ - [Managing form control state](guide/forms/reactive-forms#managing-form-control-state)
1104
1145
 
1105
1146
  #### Inherited from
1106
1147
 
@@ -1112,7 +1153,7 @@ When false, no events are emitted.
1112
1153
 
1113
1154
  > **markAsDirty**(`opts`?): `void`
1114
1155
 
1115
- Defined in: node\_modules/@angular/forms/index.d.ts:2515
1156
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2952
1116
1157
 
1117
1158
  Marks the control as `dirty`. A control becomes dirty when
1118
1159
  the control's value is changed through the UI; compare `markAsTouched`.
@@ -1146,6 +1187,7 @@ When false, no events are emitted.
1146
1187
  - [()](AbstractControl.md#markastouched)
1147
1188
  - [()](AbstractControl.md#markasuntouched)
1148
1189
  - [()](AbstractControl.md#markaspristine)
1190
+ - [Managing form control state](guide/forms/reactive-forms#managing-form-control-state)
1149
1191
 
1150
1192
  #### Inherited from
1151
1193
 
@@ -1157,7 +1199,7 @@ When false, no events are emitted.
1157
1199
 
1158
1200
  > **markAsPending**(`opts`?): `void`
1159
1201
 
1160
- Defined in: node\_modules/@angular/forms/index.d.ts:2559
1202
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2999
1161
1203
 
1162
1204
  Marks the control as `pending`.
1163
1205
 
@@ -1202,7 +1244,7 @@ and the `events` observable emits a `StatusChangeEvent` with the `status` proper
1202
1244
 
1203
1245
  > **markAsPristine**(`opts`?): `void`
1204
1246
 
1205
- Defined in: node\_modules/@angular/forms/index.d.ts:2538
1247
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2978
1206
1248
 
1207
1249
  Marks the control as `pristine`.
1208
1250
 
@@ -1239,6 +1281,7 @@ When false, no events are emitted.
1239
1281
  - [()](AbstractControl.md#markastouched)
1240
1282
  - [()](AbstractControl.md#markasuntouched)
1241
1283
  - [()](AbstractControl.md#markasdirty)
1284
+ - [Managing form control state](guide/forms/reactive-forms#managing-form-control-state)
1242
1285
 
1243
1286
  #### Inherited from
1244
1287
 
@@ -1250,7 +1293,7 @@ When false, no events are emitted.
1250
1293
 
1251
1294
  > **markAsTouched**(`opts`?): `void`
1252
1295
 
1253
- Defined in: node\_modules/@angular/forms/index.d.ts:2460
1296
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2872
1254
1297
 
1255
1298
  Marks the control as `touched`. A control is touched by focus and
1256
1299
  blur events that do not change the value.
@@ -1284,6 +1327,7 @@ When false, no events are emitted.
1284
1327
  - [()](AbstractControl.md#markasuntouched)
1285
1328
  - [()](AbstractControl.md#markasdirty)
1286
1329
  - [()](AbstractControl.md#markaspristine)
1330
+ - [Managing form control state](guide/forms/reactive-forms#managing-form-control-state)
1287
1331
 
1288
1332
  #### Inherited from
1289
1333
 
@@ -1295,7 +1339,7 @@ When false, no events are emitted.
1295
1339
 
1296
1340
  > **markAsUntouched**(`opts`?): `void`
1297
1341
 
1298
- Defined in: node\_modules/@angular/forms/index.d.ts:2495
1342
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2929
1299
1343
 
1300
1344
  Marks the control as `untouched`.
1301
1345
 
@@ -1331,6 +1375,7 @@ When false, no events are emitted.
1331
1375
  - [()](AbstractControl.md#markastouched)
1332
1376
  - [()](AbstractControl.md#markasdirty)
1333
1377
  - [()](AbstractControl.md#markaspristine)
1378
+ - [Managing form control state](guide/forms/reactive-forms#managing-form-control-state)
1334
1379
 
1335
1380
  #### Inherited from
1336
1381
 
@@ -1342,7 +1387,7 @@ When false, no events are emitted.
1342
1387
 
1343
1388
  > `abstract` **patchValue**(`value`, `options`?): `void`
1344
1389
 
1345
- Defined in: node\_modules/@angular/forms/index.d.ts:2620
1390
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:3060
1346
1391
 
1347
1392
  Patches the value of the control. Abstract method (implemented in sub-classes).
1348
1393
 
@@ -1370,7 +1415,7 @@ Patches the value of the control. Abstract method (implemented in sub-classes).
1370
1415
 
1371
1416
  > **removeAsyncValidators**(`validators`): `void`
1372
1417
 
1373
- Defined in: node\_modules/@angular/forms/index.d.ts:2394
1418
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2805
1374
1419
 
1375
1420
  Remove an asynchronous validator from this control, without affecting other validators.
1376
1421
  Validators are compared by function reference; you must pass a reference to the exact same
@@ -1402,7 +1447,7 @@ The asynchronous validator or validators to remove.
1402
1447
 
1403
1448
  > **removeValidators**(`validators`): `void`
1404
1449
 
1405
- Defined in: node\_modules/@angular/forms/index.d.ts:2382
1450
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2793
1406
1451
 
1407
1452
  Remove a synchronous validator from this control, without affecting other validators.
1408
1453
  Validators are compared by function reference; you must pass a reference to the exact same
@@ -1423,9 +1468,7 @@ The validator or validators to remove.
1423
1468
 
1424
1469
  #### Usage Notes
1425
1470
 
1426
- ### Reference to a ValidatorFn
1427
-
1428
- ```
1471
+ ```ts
1429
1472
  // Reference to the RequiredValidator
1430
1473
  const ctrl = new FormControl<string | null>('', Validators.required);
1431
1474
  ctrl.removeValidators(Validators.required);
@@ -1452,7 +1495,7 @@ When you add or remove a validator at run time, you must call
1452
1495
 
1453
1496
  > `abstract` **reset**(`value`?, `options`?): `void`
1454
1497
 
1455
- Defined in: node\_modules/@angular/forms/index.d.ts:2624
1498
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:3064
1456
1499
 
1457
1500
  Resets the control. Abstract method (implemented in sub-classes).
1458
1501
 
@@ -1480,7 +1523,7 @@ Resets the control. Abstract method (implemented in sub-classes).
1480
1523
 
1481
1524
  > **setAsyncValidators**(`validators`): `void`
1482
1525
 
1483
- Defined in: node\_modules/@angular/forms/index.d.ts:2327
1526
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2740
1484
1527
 
1485
1528
  Sets the asynchronous validators that are active on this control. Calling this
1486
1529
  overwrites any existing asynchronous validators.
@@ -1511,12 +1554,14 @@ using `addAsyncValidators()` method instead.
1511
1554
 
1512
1555
  > **setErrors**(`errors`, `opts`?): `void`
1513
1556
 
1514
- Defined in: node\_modules/@angular/forms/index.d.ts:2680
1557
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:3125
1515
1558
 
1516
1559
  Sets errors on a form control when running validations manually, rather than automatically.
1517
1560
 
1518
1561
  Calling `setErrors` also updates the validity of the parent control.
1519
1562
 
1563
+ Note: Manually set errors are always overwritten by the results of the next validation run.
1564
+
1520
1565
  #### Parameters
1521
1566
 
1522
1567
  ##### errors
@@ -1566,7 +1611,7 @@ expect(login.valid).toEqual(true);
1566
1611
 
1567
1612
  > **setParent**(`parent`): `void`
1568
1613
 
1569
- Defined in: node\_modules/@angular/forms/index.d.ts:2612
1614
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:3052
1570
1615
 
1571
1616
  Sets the parent of the control
1572
1617
 
@@ -1592,7 +1637,7 @@ The new parent.
1592
1637
 
1593
1638
  > **setValidators**(`validators`): `void`
1594
1639
 
1595
- Defined in: node\_modules/@angular/forms/index.d.ts:2316
1640
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:2729
1596
1641
 
1597
1642
  Sets the synchronous validators that are active on this control. Calling
1598
1643
  this overwrites any existing synchronous validators.
@@ -1623,7 +1668,7 @@ using `addValidators()` method instead.
1623
1668
 
1624
1669
  > `abstract` **setValue**(`value`, `options`?): `void`
1625
1670
 
1626
- Defined in: node\_modules/@angular/forms/index.d.ts:2616
1671
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:3056
1627
1672
 
1628
1673
  Sets the value of the control. Abstract method (implemented in sub-classes).
1629
1674
 
@@ -1651,7 +1696,7 @@ Sets the value of the control. Abstract method (implemented in sub-classes).
1651
1696
 
1652
1697
  > **updateValueAndValidity**(`opts`?): `void`
1653
1698
 
1654
- Defined in: node\_modules/@angular/forms/index.d.ts:2644
1699
+ Defined in: node\_modules/@angular/forms/types/forms.d.ts:3087
1655
1700
 
1656
1701
  Recalculates the value and validation status of the control.
1657
1702
 
@@ -1682,6 +1727,10 @@ When false, no events are emitted.
1682
1727
 
1683
1728
  `void`
1684
1729
 
1730
+ #### See
1731
+
1732
+ [Understanding propagation control](guide/forms/reactive-forms#understanding-event-emission)
1733
+
1685
1734
  #### Inherited from
1686
1735
 
1687
1736
  `NgAbstractControl.updateValueAndValidity`