@strictly/react-form 0.0.1

package/core/mobx/types.ts

@@ -0,0 +1,54 @@
+// TODO rename/split-out this file
+import { type ToTypeOfFieldAdapter } from './field_adapter'
+import {
+  type FlattenedConvertedFieldsOf,
+  type FormPresenter,
+} from './form_presenter'
+
+/**
+ * Used to extract the supported value paths from a presenter
+ */
+export type ValuePathsOfPresenter<
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  Presenter extends FormPresenter<any, any, any, any>,
+> = Presenter extends FormPresenter<
+  infer _1,
+  infer _2,
+  infer _3,
+  infer ValuePathsToAdapters
+> ? keyof ValuePathsToAdapters
+  : never
+
+/**
+ * Used to extract the render type (so the value that is passed to the view) of a given value path
+ * from a presenter
+ */
+export type ToTypeOfPresenterValuePath<
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  Presenter extends FormPresenter<any, any, any, any>,
+  K extends ValuePathsOfPresenter<Presenter>,
+> = Presenter extends FormPresenter<
+  infer _1,
+  infer _2,
+  infer _3,
+  infer ValuePathsToAdapters
+> ? ToTypeOfFieldAdapter<ValuePathsToAdapters[K]>
+  : never
+
+/**
+ * Extracts the form fields from the presenter. The recommended way is to
+ * define the form fields explicitly and use that type to enforce the types
+ * of your converters, but generating the FormFields from your presenter
+ * is less typing, albeit at the cost of potentially getting type errors
+ * reported a long way away from the source
+ */
+export type FormFieldsOfPresenter<
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  Presenter extends FormPresenter<any, any, any, any>,
+> = Presenter extends FormPresenter<
+  infer _1,
+  infer _2,
+  infer _3,
+  infer ValuePathsToAdapters
+> ? FlattenedConvertedFieldsOf<ValuePathsToAdapters>
+  : never

package/core/props.ts

@@ -0,0 +1,21 @@
+import { type Fields } from 'types/field'
+
+export type FormProps<F extends Fields> = {
+  fields: F,
+
+  onFieldValueChange<K extends keyof F>(this: void, key: K, value: F[K]['value']): void,
+
+  onFieldFocus?(this: void, key: keyof F): void,
+
+  onFieldBlur?(this: void, key: keyof F): void,
+
+  // when the user hits enter on a field, return true if
+  // the default behavior should be suppressed
+  onFieldSubmit?(this: void, key: keyof F): boolean | void,
+}
+
+export type EditorProps<O> = {
+  value: O,
+
+  onValueChange: (value: O) => void,
+}