Open History to see the last commit
1import { FormApi, functionalUpdate } from '@tanstack/form-core'
2import { createComputed, onMount } from 'solid-js'
3import { useStore } from '@tanstack/solid-store'
4import { Field, createField } from './createField'
5import type { JSXElement } from 'solid-js'
6import type { CreateField, FieldComponent } from './createField'
7import type { FormOptions, FormState, Validator } from '@tanstack/form-core'
8β
9type NoInfer<T> = [T][T extends any ? 0 : never]
10β
11export interface SolidFormApi<
12 TFormData,
13 TFormValidator extends Validator<TFormData, unknown> | undefined = undefined,
14> {
15 Field: FieldComponent<TFormData, TFormValidator>
16 createField: CreateField<TFormData, TFormValidator>
17 useStore: <TSelected = NoInfer<FormState<TFormData>>>(
18 selector?: (state: NoInfer<FormState<TFormData>>) => TSelected,
19 ) => () => TSelected
20 Subscribe: <TSelected = NoInfer<FormState<TFormData>>>(props: {
21 selector?: (state: NoInfer<FormState<TFormData>>) => TSelected
22 children: ((state: () => NoInfer<TSelected>) => JSXElement) | JSXElement
23 }) => JSXElement
24}
25β
26export function createForm<
27 TParentData,
28 TFormValidator extends
29 | Validator<TParentData, unknown>
30 | undefined = undefined,
31>(opts?: () => FormOptions<TParentData, TFormValidator>) {
32 const options = opts?.()
33 const api = new FormApi<TParentData, TFormValidator>(options)
34 const extendedApi: typeof api & SolidFormApi<TParentData, TFormValidator> =
35 api as never
36β
37 extendedApi.Field = (props) => <Field {...props} form={api} />
38 extendedApi.createField = (props) =>
39 createField(() => {
40 return { ...props(), form: api }
41 })
42 extendedApi.useStore = (selector) => useStore(api.store, selector)
43 extendedApi.Subscribe = (props) =>
44 functionalUpdate(props.children, useStore(api.store, props.selector))
45β
46 onMount(api.mount)
47β
48 /**
49 * formApi.update should not have any side effects. Think of it like a `useRef`
50 * that we need to keep updated every render with the most up-to-date information.
51 */
52 createComputed(() => api.update(opts?.()))
53β
54 return extendedApi
55}