Open History to see the last commit
1import { brandComponentFactory, wrapField } from './fieldComponentHelpers.lib'
2import type { Accessor, Component, JSX } from 'solid-js'
3import type { FieldWithValue } from '@tanstack/form-core'
4β
5type ExactFieldBrand<out TValue> = {
6 readonly __tanstackFieldExactType: TValue
7}
8β
9type AcceptsFieldBrand<out TAcceptedValue> = {
10 readonly __tanstackFieldAcceptsType: TAcceptedValue
11}
12β
13type AnyFieldComponent = Component<any>
14type PropsOf<TComponent> =
15 TComponent extends Component<infer TProps> ? TProps : never
16type FieldValuePropKeys<TProps> = {
17 [K in keyof TProps]-?: TProps[K] extends Accessor<FieldWithValue<any>>
18 ? K
19 : never
20}[keyof TProps]
21type FieldValueFromProp<TProp> =
22 TProp extends Accessor<FieldWithValue<infer TValue>> ? TValue : never
23type FieldValueFromComponentProp<
24 TProps,
25 TFieldPropKey extends keyof TProps,
26> = FieldValueFromProp<TProps[TFieldPropKey]>
27type PublicPropsReplacingField<
28 TProps,
29 TFieldPropKey extends keyof TProps,
30> = Omit<TProps, TFieldPropKey>
31β
32type StrictInjectedFieldComponent<
33 TComponent extends AnyFieldComponent,
34 TProps = PropsOf<TComponent>,
35 TFieldPropKey extends FieldValuePropKeys<TProps> = FieldValuePropKeys<TProps>,
36> = ((props: PublicPropsReplacingField<TProps, TFieldPropKey>) => JSX.Element) &
37 ExactFieldBrand<FieldValueFromComponentProp<TProps, TFieldPropKey>>
38β
39type LooseInjectedFieldComponent<
40 TComponent extends AnyFieldComponent,
41 TProps = PropsOf<TComponent>,
42 TFieldPropKey extends FieldValuePropKeys<TProps> = FieldValuePropKeys<TProps>,
43> = ((props: PublicPropsReplacingField<TProps, TFieldPropKey>) => JSX.Element) &
44 AcceptsFieldBrand<FieldValueFromComponentProp<TProps, TFieldPropKey>>
45β
46type StrictBrandedFieldComponent<TComponent, TValue> = TComponent &
47 ExactFieldBrand<TValue>
48type LooseBrandedFieldComponent<TComponent, TValue> = TComponent &
49 AcceptsFieldBrand<TValue>
50β
51interface FieldComponentHelper {
52 strict: <
53 TComponent extends AnyFieldComponent,
54 TProps = PropsOf<TComponent>,
55 TFieldPropKey extends FieldValuePropKeys<TProps> =
56 FieldValuePropKeys<TProps>,
57 >(
58 Component: TComponent,
59 fieldPropKey: TFieldPropKey,
60 ) => StrictInjectedFieldComponent<TComponent, TProps, TFieldPropKey>
61 loose: <
62 TComponent extends AnyFieldComponent,
63 TProps = PropsOf<TComponent>,
64 TFieldPropKey extends FieldValuePropKeys<TProps> =
65 FieldValuePropKeys<TProps>,
66 >(
67 Component: TComponent,
68 fieldPropKey: TFieldPropKey,
69 ) => LooseInjectedFieldComponent<TComponent, TProps, TFieldPropKey>
70}
71β
72interface FieldBrandHelper {
73 strict: <TValue>() => <TComponent extends AnyFieldComponent>(
74 Component: TComponent,
75 ) => StrictBrandedFieldComponent<TComponent, TValue>
76 loose: <TValue>() => <TComponent extends AnyFieldComponent>(
77 Component: TComponent,
78 ) => LooseBrandedFieldComponent<TComponent, TValue>
79}
80β
81export interface FormHookHelpers {
82 fieldBrand: FieldBrandHelper
83 fieldComponent: FieldComponentHelper
84}
85β
86export function getFormHookHelpers(): FormHookHelpers {
87 return {
88 fieldComponent: {
89 loose: wrapField as FieldComponentHelper['loose'],
90 strict: wrapField as FieldComponentHelper['strict'],
91 },
92 fieldBrand: {
93 loose: brandComponentFactory as FieldBrandHelper['loose'],
94 strict: brandComponentFactory as FieldBrandHelper['strict'],
95 },
96 }
97}