Open History to see the last commit
1'use client'
2β
3import { useMemo, useState } from 'react'
4import { useSelector } from '@tanstack/react-store'
5import { FormGroupApi, functionalUpdate } from '@tanstack/form-core'
6import { useIsomorphicLayoutEffect } from './useIsomorphicLayoutEffect'
7import type {
8 DeepKeys,
9 DeepValue,
10 FormAsyncValidateOrFn,
11 FormGroupApiOptions,
12 FormGroupAsyncValidateOrFn,
13 FormGroupOptions,
14 FormGroupValidateOrFn,
15 FormValidateOrFn,
16} from '@tanstack/form-core'
17import type { FunctionComponent, ReactNode } from 'react'
18β
19export type UseFormGroup<
20 TParentData,
21 TFormOnMount extends undefined | FormValidateOrFn<TParentData>,
22 TFormOnChange extends undefined | FormValidateOrFn<TParentData>,
23 TFormOnChangeAsync extends undefined | FormAsyncValidateOrFn<TParentData>,
24 TFormOnBlur extends undefined | FormValidateOrFn<TParentData>,
25 TFormOnBlurAsync extends undefined | FormAsyncValidateOrFn<TParentData>,
26 TFormOnSubmit extends undefined | FormValidateOrFn<TParentData>,
27 TFormOnSubmitAsync extends undefined | FormAsyncValidateOrFn<TParentData>,
28 TFormOnDynamic extends undefined | FormValidateOrFn<TParentData>,
29 TFormOnDynamicAsync extends undefined | FormAsyncValidateOrFn<TParentData>,
30 TFormOnServer extends undefined | FormAsyncValidateOrFn<TParentData>,
31 TParentSubmitMeta,
32> = <
33 TName extends DeepKeys<TParentData>,
34 TData extends DeepValue<TParentData, TName>,
35 TOnMount extends undefined | FormGroupValidateOrFn<TParentData, TName, TData>,
36 TOnChange extends
37 | undefined
38 | FormGroupValidateOrFn<TParentData, TName, TData>,
39 TOnChangeAsync extends
40 | undefined
41 | FormGroupAsyncValidateOrFn<TParentData, TName, TData>,
42 TOnBlur extends undefined | FormGroupValidateOrFn<TParentData, TName, TData>,
43 TOnBlurAsync extends
44 | undefined
45 | FormGroupAsyncValidateOrFn<TParentData, TName, TData>,
46 TOnSubmit extends
47 | undefined
48 | FormGroupValidateOrFn<TParentData, TName, TData>,
49 TOnSubmitAsync extends
50 | undefined
51 | FormGroupAsyncValidateOrFn<TParentData, TName, TData>,
52 TOnDynamic extends
53 | undefined
54 | FormGroupValidateOrFn<TParentData, TName, TData>,
55 TOnDynamicAsync extends
56 | undefined
57 | FormGroupAsyncValidateOrFn<TParentData, TName, TData>,
58 TSubmitMeta,
59>(
60 opts: FormGroupApiOptions<
61 TParentData,
62 TName,
63 TData,
64 TOnMount,
65 TOnChange,
66 TOnChangeAsync,
67 TOnBlur,
68 TOnBlurAsync,
69 TOnSubmit,
70 TOnSubmitAsync,
71 TOnDynamic,
72 TOnDynamicAsync,
73 TSubmitMeta,
74 TFormOnMount,
75 TFormOnChange,
76 TFormOnChangeAsync,
77 TFormOnBlur,
78 TFormOnBlurAsync,
79 TFormOnSubmit,
80 TFormOnSubmitAsync,
81 TFormOnDynamic,
82 TFormOnDynamicAsync,
83 TFormOnServer,
84 TParentSubmitMeta
85 >,
86) => FormGroupApi<
87 TParentData,
88 TName,
89 TData,
90 TOnMount,
91 TOnChange,
92 TOnChangeAsync,
93 TOnBlur,
94 TOnBlurAsync,
95 TOnSubmit,
96 TOnSubmitAsync,
97 TOnDynamic,
98 TOnDynamicAsync,
99 TSubmitMeta,
100 TFormOnMount,
101 TFormOnChange,
102 TFormOnChangeAsync,
103 TFormOnBlur,
104 TFormOnBlurAsync,
105 TFormOnSubmit,
106 TFormOnSubmitAsync,
107 TFormOnDynamic,
108 TFormOnDynamicAsync,
109 TFormOnServer,
110 TParentSubmitMeta
111>
112β
113export function useFormGroup<
114 TParentData,
115 TName extends DeepKeys<TParentData>,
116 TData extends DeepValue<TParentData, TName>,
117 TOnMount extends undefined | FormGroupValidateOrFn<TParentData, TName, TData>,
118 TOnChange extends
119 | undefined
120 | FormGroupValidateOrFn<TParentData, TName, TData>,
121 TOnChangeAsync extends
122 | undefined
123 | FormGroupAsyncValidateOrFn<TParentData, TName, TData>,
124 TOnBlur extends undefined | FormGroupValidateOrFn<TParentData, TName, TData>,
125 TOnBlurAsync extends
126 | undefined
127 | FormGroupAsyncValidateOrFn<TParentData, TName, TData>,
128 TOnSubmit extends
129 | undefined
130 | FormGroupValidateOrFn<TParentData, TName, TData>,
131 TOnSubmitAsync extends
132 | undefined
133 | FormGroupAsyncValidateOrFn<TParentData, TName, TData>,
134 TOnDynamic extends
135 | undefined
136 | FormGroupValidateOrFn<TParentData, TName, TData>,
137 TOnDynamicAsync extends
138 | undefined
139 | FormGroupAsyncValidateOrFn<TParentData, TName, TData>,
140 TSubmitMeta,
141 TFormOnMount extends undefined | FormValidateOrFn<TParentData>,
142 TFormOnChange extends undefined | FormValidateOrFn<TParentData>,
143 TFormOnChangeAsync extends undefined | FormAsyncValidateOrFn<TParentData>,
144 TFormOnBlur extends undefined | FormValidateOrFn<TParentData>,
145 TFormOnBlurAsync extends undefined | FormAsyncValidateOrFn<TParentData>,
146 TFormOnSubmit extends undefined | FormValidateOrFn<TParentData>,
147 TFormOnSubmitAsync extends undefined | FormAsyncValidateOrFn<TParentData>,
148 TFormOnDynamic extends undefined | FormValidateOrFn<TParentData>,
149 TFormOnDynamicAsync extends undefined | FormAsyncValidateOrFn<TParentData>,
150 TFormOnServer extends undefined | FormAsyncValidateOrFn<TParentData>,
151 TParentSubmitMeta,
152>(
153 opts: FormGroupApiOptions<
154 TParentData,
155 TName,
156 TData,
157 TOnMount,
158 TOnChange,
159 TOnChangeAsync,
160 TOnBlur,
161 TOnBlurAsync,
162 TOnSubmit,
163 TOnSubmitAsync,
164 TOnDynamic,
165 TOnDynamicAsync,
166 TSubmitMeta,
167 TFormOnMount,
168 TFormOnChange,
169 TFormOnChangeAsync,
170 TFormOnBlur,
171 TFormOnBlurAsync,
172 TFormOnSubmit,
173 TFormOnSubmitAsync,
174 TFormOnDynamic,
175 TFormOnDynamicAsync,
176 TFormOnServer,
177 TParentSubmitMeta
178 >,
179) {
180 // Keep a snapshot of options so that React Compiler doesn't
181 // wrongly optimize formGroupApi.
182 const [prevOptions, setPrevOptions] = useState(() => ({
183 form: opts.form,
184 name: opts.name,
185 }))
186β
187 const [formGroupApi, setFormGroupApi] = useState(() => {
188 return new FormGroupApi({
189 ...opts,
190 })
191 })
192β
193 // We only want to
194 // update on name changes since those are at risk of becoming stale. The field
195 // state must be up to date for the internal JSX render.
196 // The other options can freely be in `fieldApi.update`
197 if (prevOptions.form !== opts.form || prevOptions.name !== opts.name) {
198 setFormGroupApi(
199 new FormGroupApi({
200 ...opts,
201 }),
202 )
203 setPrevOptions({ form: opts.form, name: opts.name })
204 }
205β
206 const reactiveStateValue = useSelector(
207 formGroupApi.store,
208 (state) => state.value,
209 )
210β
211 const reactiveMetaIsTouched = useSelector(
212 formGroupApi.store,
213 (state) => state.meta.isTouched,
214 )
215 const reactiveMetaIsBlurred = useSelector(
216 formGroupApi.store,
217 (state) => state.meta.isBlurred,
218 )
219 const reactiveMetaIsDirty = useSelector(
220 formGroupApi.store,
221 (state) => state.meta.isDirty,
222 )
223 const reactiveMetaErrorMap = useSelector(
224 formGroupApi.store,
225 (state) => state.meta.errorMap,
226 )
227 const reactiveMetaErrorSourceMap = useSelector(
228 formGroupApi.store,
229 (state) => state.meta.errorSourceMap,
230 )
231 const reactiveMetaIsValidating = useSelector(
232 formGroupApi.store,
233 (state) => state.meta.isValidating,
234 )
235β
236 // Submission lifecycle and aggregated validity now live on `state.meta`
237 // (mirroring `FieldApi.state.meta`). Subscribe to the fields callers
238 // typically read so React Compiler picks them up as dependencies.
239 const reactiveMetaIsSubmitting = useSelector(
240 formGroupApi.store,
241 (state) => state.meta.isSubmitting,
242 )
243 const reactiveMetaIsSubmitted = useSelector(
244 formGroupApi.store,
245 (state) => state.meta.isSubmitted,
246 )
247 const reactiveMetaSubmissionAttempts = useSelector(
248 formGroupApi.store,
249 (state) => state.meta.submissionAttempts,
250 )
251 const reactiveMetaIsSubmitSuccessful = useSelector(
252 formGroupApi.store,
253 (state) => state.meta.isSubmitSuccessful,
254 )
255 const reactiveMetaCanSubmit = useSelector(
256 formGroupApi.store,
257 (state) => state.meta.canSubmit,
258 )
259 const reactiveMetaIsValid = useSelector(
260 formGroupApi.store,
261 (state) => state.meta.isValid,
262 )
263 const reactiveMetaIsFieldsValid = useSelector(
264 formGroupApi.store,
265 (state) => state.meta.isFieldsValid,
266 )
267 const reactiveMetaIsFieldsValidating = useSelector(
268 formGroupApi.store,
269 (state) => state.meta.isFieldsValidating,
270 )
271 const reactiveMetaIsGroupValid = useSelector(
272 formGroupApi.store,
273 (state) => state.meta.isGroupValid,
274 )
275β
276 // This makes me sad, but if I understand correctly, this is what we have to do for reactivity to work properly with React compiler.
277 const extendedFieldApi = useMemo(() => {
278 const reactiveFieldApi = {
279 ...formGroupApi,
280 handleSubmit: ((...props: never[]) => {
281 return formGroupApi._handleSubmit(...props)
282 }) as typeof formGroupApi.handleSubmit,
283 get state() {
284 return {
285 ...formGroupApi.state,
286 value: reactiveStateValue,
287 get meta() {
288 return {
289 ...formGroupApi.state.meta,
290 isTouched: reactiveMetaIsTouched,
291 isBlurred: reactiveMetaIsBlurred,
292 isDirty: reactiveMetaIsDirty,
293 errorMap: reactiveMetaErrorMap,
294 errorSourceMap: reactiveMetaErrorSourceMap,
295 isValidating: reactiveMetaIsValidating,
296 isSubmitting: reactiveMetaIsSubmitting,
297 isSubmitted: reactiveMetaIsSubmitted,
298 submissionAttempts: reactiveMetaSubmissionAttempts,
299 isSubmitSuccessful: reactiveMetaIsSubmitSuccessful,
300 canSubmit: reactiveMetaCanSubmit,
301 isValid: reactiveMetaIsValid,
302 isFieldsValid: reactiveMetaIsFieldsValid,
303 isFieldsValidating: reactiveMetaIsFieldsValidating,
304 isGroupValid: reactiveMetaIsGroupValid,
305 } satisfies typeof formGroupApi.state.meta
306 },
307 } satisfies typeof formGroupApi.state
308 },
309 }
310β
311 const extendedApi: FormGroupApi<
312 TParentData,
313 TName,
314 TData,
315 TOnMount,
316 TOnChange,
317 TOnChangeAsync,
318 TOnBlur,
319 TOnBlurAsync,
320 TOnSubmit,
321 TOnSubmitAsync,
322 TOnDynamic,
323 TOnDynamicAsync,
324 TSubmitMeta,
325 TFormOnMount,
326 TFormOnChange,
327 TFormOnChangeAsync,
328 TFormOnBlur,
329 TFormOnBlurAsync,
330 TFormOnSubmit,
331 TFormOnSubmitAsync,
332 TFormOnDynamic,
333 TFormOnDynamicAsync,
334 TFormOnServer,
335 TParentSubmitMeta
336 > = reactiveFieldApi as never
337β
338 return extendedApi
339 }, [
340 formGroupApi,
341 reactiveStateValue,
342 reactiveMetaIsTouched,
343 reactiveMetaIsBlurred,
344 reactiveMetaIsDirty,
345 reactiveMetaErrorMap,
346 reactiveMetaErrorSourceMap,
347 reactiveMetaIsValidating,
348 reactiveMetaIsSubmitting,
349 reactiveMetaIsSubmitted,
350 reactiveMetaSubmissionAttempts,
351 reactiveMetaIsSubmitSuccessful,
352 reactiveMetaCanSubmit,
353 reactiveMetaIsValid,
354 reactiveMetaIsFieldsValid,
355 reactiveMetaIsFieldsValidating,
356 reactiveMetaIsGroupValid,
357 ])
358β
359 useIsomorphicLayoutEffect(formGroupApi.mount, [formGroupApi])
360β
361 useIsomorphicLayoutEffect(() => {
362 formGroupApi.update(opts)
363 })
364β
365 return extendedFieldApi
366}
367β
368interface FormGroupComponentProps<
369 TParentData,
370 TName extends DeepKeys<TParentData>,
371 TData extends DeepValue<TParentData, TName>,
372 TOnMount extends undefined | FormGroupValidateOrFn<TParentData, TName, TData>,
373 TOnChange extends
374 | undefined
375 | FormGroupValidateOrFn<TParentData, TName, TData>,
376 TOnChangeAsync extends
377 | undefined
378 | FormGroupAsyncValidateOrFn<TParentData, TName, TData>,
379 TOnBlur extends undefined | FormGroupValidateOrFn<TParentData, TName, TData>,
380 TOnBlurAsync extends
381 | undefined
382 | FormGroupAsyncValidateOrFn<TParentData, TName, TData>,
383 TOnSubmit extends
384 | undefined
385 | FormGroupValidateOrFn<TParentData, TName, TData>,
386 TOnSubmitAsync extends
387 | undefined
388 | FormGroupAsyncValidateOrFn<TParentData, TName, TData>,
389 TOnDynamic extends
390 | undefined
391 | FormGroupValidateOrFn<TParentData, TName, TData>,
392 TOnDynamicAsync extends
393 | undefined
394 | FormGroupAsyncValidateOrFn<TParentData, TName, TData>,
395 TSubmitMeta,
396 TFormOnMount extends undefined | FormValidateOrFn<TParentData>,
397 TFormOnChange extends undefined | FormValidateOrFn<TParentData>,
398 TFormOnChangeAsync extends undefined | FormAsyncValidateOrFn<TParentData>,
399 TFormOnBlur extends undefined | FormValidateOrFn<TParentData>,
400 TFormOnBlurAsync extends undefined | FormAsyncValidateOrFn<TParentData>,
401 TFormOnSubmit extends undefined | FormValidateOrFn<TParentData>,
402 TFormOnSubmitAsync extends undefined | FormAsyncValidateOrFn<TParentData>,
403 TFormOnDynamic extends undefined | FormValidateOrFn<TParentData>,
404 TFormOnDynamicAsync extends undefined | FormAsyncValidateOrFn<TParentData>,
405 TFormOnServer extends undefined | FormAsyncValidateOrFn<TParentData>,
406 TParentSubmitMeta,
407 ExtendedApi = {},
408> extends FormGroupApiOptions<
409 TParentData,
410 TName,
411 TData,
412 TOnMount,
413 TOnChange,
414 TOnChangeAsync,
415 TOnBlur,
416 TOnBlurAsync,
417 TOnSubmit,
418 TOnSubmitAsync,
419 TOnDynamic,
420 TOnDynamicAsync,
421 TSubmitMeta,
422 TFormOnMount,
423 TFormOnChange,
424 TFormOnChangeAsync,
425 TFormOnBlur,
426 TFormOnBlurAsync,
427 TFormOnSubmit,
428 TFormOnSubmitAsync,
429 TFormOnDynamic,
430 TFormOnDynamicAsync,
431 TFormOnServer,
432 TParentSubmitMeta
433> {
434 children: (
435 formGroupApi: FormGroupApi<
436 TParentData,
437 TName,
438 TData,
439 TOnMount,
440 TOnChange,
441 TOnChangeAsync,
442 TOnBlur,
443 TOnBlurAsync,
444 TOnSubmit,
445 TOnSubmitAsync,
446 TOnDynamic,
447 TOnDynamicAsync,
448 TSubmitMeta,
449 TFormOnMount,
450 TFormOnChange,
451 TFormOnChangeAsync,
452 TFormOnBlur,
453 TFormOnBlurAsync,
454 TFormOnSubmit,
455 TFormOnSubmitAsync,
456 TFormOnDynamic,
457 TFormOnDynamicAsync,
458 TFormOnServer,
459 TParentSubmitMeta
460 > &
461 ExtendedApi,
462 ) => ReactNode
463}
464β
465interface FormGroupComponentBoundProps<
466 TParentData,
467 TName extends DeepKeys<TParentData>,
468 TData extends DeepValue<TParentData, TName>,
469 TOnMount extends undefined | FormGroupValidateOrFn<TParentData, TName, TData>,
470 TOnChange extends
471 | undefined
472 | FormGroupValidateOrFn<TParentData, TName, TData>,
473 TOnChangeAsync extends
474 | undefined
475 | FormGroupAsyncValidateOrFn<TParentData, TName, TData>,
476 TOnBlur extends undefined | FormGroupValidateOrFn<TParentData, TName, TData>,
477 TOnBlurAsync extends
478 | undefined
479 | FormGroupAsyncValidateOrFn<TParentData, TName, TData>,
480 TOnSubmit extends
481 | undefined
482 | FormGroupValidateOrFn<TParentData, TName, TData>,
483 TOnSubmitAsync extends
484 | undefined
485 | FormGroupAsyncValidateOrFn<TParentData, TName, TData>,
486 TOnDynamic extends
487 | undefined
488 | FormGroupValidateOrFn<TParentData, TName, TData>,
489 TOnDynamicAsync extends
490 | undefined
491 | FormGroupAsyncValidateOrFn<TParentData, TName, TData>,
492 TSubmitMeta,
493 TFormOnMount extends undefined | FormValidateOrFn<TParentData>,
494 TFormOnChange extends undefined | FormValidateOrFn<TParentData>,
495 TFormOnChangeAsync extends undefined | FormAsyncValidateOrFn<TParentData>,
496 TFormOnBlur extends undefined | FormValidateOrFn<TParentData>,
497 TFormOnBlurAsync extends undefined | FormAsyncValidateOrFn<TParentData>,
498 TFormOnSubmit extends undefined | FormValidateOrFn<TParentData>,
499 TFormOnSubmitAsync extends undefined | FormAsyncValidateOrFn<TParentData>,
500 TFormOnDynamic extends undefined | FormValidateOrFn<TParentData>,
501 TFormOnDynamicAsync extends undefined | FormAsyncValidateOrFn<TParentData>,
502 TFormOnServer extends undefined | FormAsyncValidateOrFn<TParentData>,
503 TParentSubmitMeta,
504 ExtendedApi = {},
505> extends FormGroupOptions<
506 TParentData,
507 TName,
508 TData,
509 TOnMount,
510 TOnChange,
511 TOnChangeAsync,
512 TOnBlur,
513 TOnBlurAsync,
514 TOnSubmit,
515 TOnSubmitAsync,
516 TOnDynamic,
517 TOnDynamicAsync,
518 TSubmitMeta,
519 TFormOnMount,
520 TFormOnChange,
521 TFormOnChangeAsync,
522 TFormOnBlur,
523 TFormOnBlurAsync,
524 TFormOnSubmit,
525 TFormOnSubmitAsync,
526 TFormOnDynamic,
527 TFormOnDynamicAsync,
528 TFormOnServer,
529 TParentSubmitMeta
530> {
531 children: (
532 formGroupApi: FormGroupApi<
533 TParentData,
534 TName,
535 TData,
536 TOnMount,
537 TOnChange,
538 TOnChangeAsync,
539 TOnBlur,
540 TOnBlurAsync,
541 TOnSubmit,
542 TOnSubmitAsync,
543 TOnDynamic,
544 TOnDynamicAsync,
545 TSubmitMeta,
546 TFormOnMount,
547 TFormOnChange,
548 TFormOnChangeAsync,
549 TFormOnBlur,
550 TFormOnBlurAsync,
551 TFormOnSubmit,
552 TFormOnSubmitAsync,
553 TFormOnDynamic,
554 TFormOnDynamicAsync,
555 TFormOnServer,
556 TParentSubmitMeta
557 > &
558 ExtendedApi,
559 ) => ReactNode
560}
561β
562export type FormGroupComponent<
563 in out TParentData,
564 in out TFormOnMount extends undefined | FormValidateOrFn<TParentData>,
565 in out TFormOnChange extends undefined | FormValidateOrFn<TParentData>,
566 in out TFormOnChangeAsync extends
567 | undefined
568 | FormAsyncValidateOrFn<TParentData>,
569 in out TFormOnBlur extends undefined | FormValidateOrFn<TParentData>,
570 in out TFormOnBlurAsync extends
571 | undefined
572 | FormAsyncValidateOrFn<TParentData>,
573 in out TFormOnSubmit extends undefined | FormValidateOrFn<TParentData>,
574 in out TFormOnSubmitAsync extends
575 | undefined
576 | FormAsyncValidateOrFn<TParentData>,
577 in out TFormOnDynamic extends undefined | FormValidateOrFn<TParentData>,
578 in out TFormOnDynamicAsync extends
579 | undefined
580 | FormAsyncValidateOrFn<TParentData>,
581 in out TFormOnServer extends undefined | FormAsyncValidateOrFn<TParentData>,
582 in out TParentSubmitMeta,
583 in out ExtendedApi = {},
584> = <
585 const TName extends DeepKeys<TParentData>,
586 TData extends DeepValue<TParentData, TName>,
587 TOnMount extends undefined | FormGroupValidateOrFn<TParentData, TName, TData>,
588 TOnChange extends
589 | undefined
590 | FormGroupValidateOrFn<TParentData, TName, TData>,
591 TOnChangeAsync extends
592 | undefined
593 | FormGroupAsyncValidateOrFn<TParentData, TName, TData>,
594 TOnBlur extends undefined | FormGroupValidateOrFn<TParentData, TName, TData>,
595 TOnBlurAsync extends
596 | undefined
597 | FormGroupAsyncValidateOrFn<TParentData, TName, TData>,
598 TOnSubmit extends
599 | undefined
600 | FormGroupValidateOrFn<TParentData, TName, TData>,
601 TOnSubmitAsync extends
602 | undefined
603 | FormGroupAsyncValidateOrFn<TParentData, TName, TData>,
604 TOnDynamic extends
605 | undefined
606 | FormGroupValidateOrFn<TParentData, TName, TData>,
607 TOnDynamicAsync extends
608 | undefined
609 | FormGroupAsyncValidateOrFn<TParentData, TName, TData>,
610 TSubmitMeta,
611>({
612 children,
613 ...formGroupOptions
614}: FormGroupComponentBoundProps<
615 TParentData,
616 TName,
617 TData,
618 TOnMount,
619 TOnChange,
620 TOnChangeAsync,
621 TOnBlur,
622 TOnBlurAsync,
623 TOnSubmit,
624 TOnSubmitAsync,
625 TOnDynamic,
626 TOnDynamicAsync,
627 TSubmitMeta,
628 TFormOnMount,
629 TFormOnChange,
630 TFormOnChangeAsync,
631 TFormOnBlur,
632 TFormOnBlurAsync,
633 TFormOnSubmit,
634 TFormOnSubmitAsync,
635 TFormOnDynamic,
636 TFormOnDynamicAsync,
637 TFormOnServer,
638 TParentSubmitMeta,
639 ExtendedApi
640>) => ReturnType<FunctionComponent>
641β
642export const FormGroup = (<
643 TParentData,
644 TName extends DeepKeys<TParentData>,
645 TData extends DeepValue<TParentData, TName>,
646 TOnMount extends undefined | FormGroupValidateOrFn<TParentData, TName, TData>,
647 TOnChange extends
648 | undefined
649 | FormGroupValidateOrFn<TParentData, TName, TData>,
650 TOnChangeAsync extends
651 | undefined
652 | FormGroupAsyncValidateOrFn<TParentData, TName, TData>,
653 TOnBlur extends undefined | FormGroupValidateOrFn<TParentData, TName, TData>,
654 TOnBlurAsync extends
655 | undefined
656 | FormGroupAsyncValidateOrFn<TParentData, TName, TData>,
657 TOnSubmit extends
658 | undefined
659 | FormGroupValidateOrFn<TParentData, TName, TData>,
660 TOnSubmitAsync extends
661 | undefined
662 | FormGroupAsyncValidateOrFn<TParentData, TName, TData>,
663 TOnDynamic extends
664 | undefined
665 | FormGroupValidateOrFn<TParentData, TName, TData>,
666 TOnDynamicAsync extends
667 | undefined
668 | FormGroupAsyncValidateOrFn<TParentData, TName, TData>,
669 TSubmitMeta,
670 TFormOnMount extends undefined | FormValidateOrFn<TParentData>,
671 TFormOnChange extends undefined | FormValidateOrFn<TParentData>,
672 TFormOnChangeAsync extends undefined | FormAsyncValidateOrFn<TParentData>,
673 TFormOnBlur extends undefined | FormValidateOrFn<TParentData>,
674 TFormOnBlurAsync extends undefined | FormAsyncValidateOrFn<TParentData>,
675 TFormOnSubmit extends undefined | FormValidateOrFn<TParentData>,
676 TFormOnSubmitAsync extends undefined | FormAsyncValidateOrFn<TParentData>,
677 TFormOnDynamic extends undefined | FormValidateOrFn<TParentData>,
678 TFormOnDynamicAsync extends undefined | FormAsyncValidateOrFn<TParentData>,
679 TFormOnServer extends undefined | FormAsyncValidateOrFn<TParentData>,
680 TParentSubmitMeta,
681>({
682 children,
683 ...formGroupOptions
684}: FormGroupComponentProps<
685 TParentData,
686 TName,
687 TData,
688 TOnMount,
689 TOnChange,
690 TOnChangeAsync,
691 TOnBlur,
692 TOnBlurAsync,
693 TOnSubmit,
694 TOnSubmitAsync,
695 TOnDynamic,
696 TOnDynamicAsync,
697 TSubmitMeta,
698 TFormOnMount,
699 TFormOnChange,
700 TFormOnChangeAsync,
701 TFormOnBlur,
702 TFormOnBlurAsync,
703 TFormOnSubmit,
704 TFormOnSubmitAsync,
705 TFormOnDynamic,
706 TFormOnDynamicAsync,
707 TFormOnServer,
708 TParentSubmitMeta
709>): ReturnType<FunctionComponent> => {
710 const formGroupApi = useFormGroup(formGroupOptions as any)
711β
712 const jsxToDisplay = useMemo(
713 () => functionalUpdate(children, formGroupApi as any),
714 [children, formGroupApi],
715 )
716 return (<>{jsxToDisplay}</>) as never
717}) satisfies FunctionComponent<
718 FormGroupComponentProps<
719 any,
720 any,
721 any,
722 any,
723 any,
724 any,
725 any,
726 any,
727 any,
728 any,
729 any,
730 any,
731 any,
732 any,
733 any,
734 any,
735 any,
736 any,
737 any,
738 any,
739 any,
740 any,
741 any,
742 any
743 >
744>