Open History to see the last commit
1import Preact from 'preact/compat'
2β
3import { InternalFormGroupApi } from '@tanstack/form-core/internals'
4import { attachPreactFormComponents } from '../PreactForm/Components.lib'
5import { useField } from '../PreactForm/useField.lib'
6import {
7 useArrayFieldSubscription,
8 useValueFieldSubscription,
9} from '../PreactForm/fieldSubscriptions.lib'
10import { Subscribe } from '../Subscribe.public'
11import { FieldContext, FormContext } from './contexts.lib'
12import type { AnyInternalFormApi } from '@tanstack/form-core/internals'
13import type { FunctionComponent } from 'preact/compat'
14import type {
15 AppFormComponent,
16 PreactAppFormApi,
17} from './PreactAppFormApi.public'
18import type { AnyPreactFormComponentMap } from './componentMap.public'
19import type { CrossVersionPreactNode } from '../preactTypes.public'
20import type {
21 PreactFormFieldProps,
22 PreactFormGroupProps,
23} from '../PreactForm/Components.public'
24import type { InternalPreactFormApi } from '../PreactForm/PreactFormApi.lib'
25β
26type AnyPreactAppFormApi = PreactAppFormApi<any, any, AnyPreactFormComponentMap>
27β
28export function attachPreactAppFormComponents(
29 form: AnyInternalFormApi,
30 formComponents: Record<string, FunctionComponent<any>>,
31 fieldComponents: Record<string, FunctionComponent<any>>,
32): AnyPreactAppFormApi {
33 const resultForm = attachPreactFormComponents(
34 form,
35 fieldComponents,
36 ) as never as AnyPreactAppFormApi
37 resultForm.AppForm = createAppForm(form)
38 resultForm.Field = createFieldWithContext(
39 form,
40 fieldComponents,
41 ) as AnyPreactAppFormApi['Field']
42 const arrayField = createFieldWithContext(
43 form,
44 fieldComponents,
45 useArrayFieldSubscription,
46 )
47 arrayField.displayName = 'TanStackForm.ArrayField'
48 resultForm.ArrayField = arrayField as AnyPreactAppFormApi['ArrayField']
49 resultForm.FormGroup = createFormGroupWithContext(
50 resultForm as any,
51 ) as AnyPreactAppFormApi['FormGroup']
52β
53 return Object.assign(resultForm, formComponents)
54}
55β
56function createAppForm(form: AnyInternalFormApi): AppFormComponent {
57 const AppForm: FunctionComponent<{
58 children: Exclude<CrossVersionPreactNode, Promise<any>>
59 }> = function AppFormComponent(props) {
60 // eslint-disable-next-line @eslint-react/no-context-provider
61 return <FormContext.Provider value={form as never} {...props} />
62 }
63β
64 AppForm.displayName = 'TanStackForm.AppForm'
65β
66 return AppForm
67}
68β
69type AnyFieldComponent = FunctionComponent<
70 PreactFormFieldProps<any, any, any, any, never, any, any, any>
71>
72β
73function createFieldWithContext(
74 form: AnyInternalFormApi,
75 fieldComponents: Record<string, FunctionComponent<any>>,
76 useFieldSubscription = useValueFieldSubscription,
77) {
78 const TanStackFormField: AnyFieldComponent = (props) => {
79 const fieldApi = useField({ ...props, form }, fieldComponents)
80 const field = useFieldSubscription(fieldApi)
81β
82 return (
83 // eslint-disable-next-line @eslint-react/no-context-provider
84 <FieldContext.Provider value={field}>
85 {props.children(field) as never}
86 </FieldContext.Provider>
87 )
88 }
89β
90 TanStackFormField.displayName = 'TanStackForm.Field'
91β
92 return TanStackFormField
93}
94β
95type AnyFormGroupComponent = FunctionComponent<
96 PreactFormGroupProps<any, any, any, any, any, any>
97>
98β
99function createFormGroupWithContext(
100 form: InternalPreactFormApi,
101): AnyFormGroupComponent {
102 const TanStackFormGroup: AnyFormGroupComponent = (props) => {
103 const groupRef =
104 Preact.useRef<InternalFormGroupApi<any, any, any, any, any>>(null)
105β
106 if (!groupRef.current) {
107 groupRef.current = attachAppFormGroupComponents(
108 new InternalFormGroupApi({ ...props, form } as never),
109 form,
110 )
111 }
112β
113 Preact.useEffect(() => groupRef.current?.update({ ...props, form }))
114β
115 Preact.useEffect(() => {
116 const group = groupRef.current!
117 group.mount()
118 return () => group._cleanup()
119 }, [])
120β
121 return props.children(groupRef.current as never)
122 }
123β
124 TanStackFormGroup.displayName = 'TanStackForm.FormGroup'
125β
126 return TanStackFormGroup
127}
128β
129function attachAppFormGroupComponents(
130 group: InternalFormGroupApi<any, any, any, any, any>,
131 form: InternalPreactFormApi,
132) {
133 type GroupWithComponents = InternalFormGroupApi<any, any, any, any, any> & {
134 Field: FunctionComponent<any>
135 ArrayField: FunctionComponent<any>
136 Subscribe: FunctionComponent<any>
137 }
138β
139 const resultGroup: GroupWithComponents = group as never
140β
141 resultGroup.Field = function Field(props) {
142 return (
143 <form.Field
144 {...(group._getFormFieldOptions(props, (base, overrides) => ({
145 ...base,
146 ...overrides,
147 })) as any)}
148 />
149 )
150 }
151 resultGroup.Field.displayName = 'TanStackForm.FormGroup.Field'
152β
153 resultGroup.ArrayField = function ArrayField(props) {
154 return (
155 <form.ArrayField
156 {...(group._getFormFieldOptions(props, (base, overrides) => ({
157 ...base,
158 ...overrides,
159 })) as any)}
160 />
161 )
162 }
163 resultGroup.ArrayField.displayName = 'TanStackForm.FormGroup.ArrayField'
164β
165 resultGroup.Subscribe = (props) => {
166 return <Subscribe source={group.atom} {...props} />
167 }
168 resultGroup.Subscribe.displayName = 'TanStackForm.FormGroup.Subscribe'
169β
170 return resultGroup
171}