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