Skip to content
Source
Sign inSign up
TanStack/form
Open History to see the last commit

createForm.tsx

58 lines2.0 KB

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
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