@reactables/forms 0.5.4-alpha.0 → 0.7.0-alpha.0

package/README.md

@@ -1,25 +1,33 @@
-# Reactable Forms (WIP)
+# Reactable Forms
 
 ## Description
 
-State Management of reactive forms with [Reactables](https://github.com/reactables/reactables/tree/main/packages/core).
+Reactive forms with [Reactables](https://github.com/reactables/reactables/tree/main/packages/core).
 
 ## Table of Contents
 
 1. [Installation](#installation)
-1. [Examples](#examples)
-    1. [Form Control](#form-control)
-    1. [Form Array](#form-array)
-    1. [Form Group](#form-group)
-
 1. [API](#api)
     1. [RxActions](#api-actions)
+        1. [updateValues](#api-actions-update-values)
+        1. [addControl](#api-actions-add-conrtrol)
+        1. [pushControl](#api-actions-push-control)
+        1. [removeControl](#api-actions-remove-control)
+        1. [markControlAsPristine](#api-actions-mark-as-pristine)
+        1. [markControlAsTouched](#api-actions-mark-as-touched)
+        1. [markControlAsUntouched](#api-actions-mark-as-untouched)
+        1. [resetControl](#api-actions-resetControl)
     1. [build](#api-build)
+        1. [RxFormOptions](#api-form-options)
     1. [control](#api-control)
     1. [group](#api-group)
     1. [array](#api-array)
-    1. [Other Interfaces](#interfaces)
-        1. [EffectsAndSources](#effects-sources)
+    1. [Other Interfaces](#api-interfaces)
+        1. [Form](#api-form)
+        1. [FormControl](#api-form-control)
+        1. [ControlRef](#api-control-ref)
+        1. [FormErrors](#api-form-errors)
+        1. [FormReducers](#api-form-reducers)
 
 
 ## Installation <a name="installation"></a>
@@ -28,10 +36,6 @@ Installation will require [RxJS](https://rxjs.dev/) if not already installed.
 
 `npm i rxjs @reactables/forms`
 
-## Examples <a name="examples"></a>
-
-WIP
-
 ## API <a name="api"></a>
 
 The API for building Reactable Forms is very similar to [Angular FormBuilder](https://angular.io/api/forms/FormBuilder). It has been adapted to support Reactable features.
@@ -40,28 +44,130 @@ The API for building Reactable Forms is very similar to [Angular FormBuilder](ht
 
 Actions available to trigger state changes on Reactable.
 
+#### `updateValues` <a name="api-actions-update-values"></a>
+
+Updates value of a [`FormControl`](#api-form-control). For form group and form arrays, update will only occur if specified descendant controls exists. Otherwise it will throw an error.
+
+```typescript
+type updateValues = <T>(payload: UpdateValuesPayload<T>) => void;
+
+export interface UpdateValuesPayload<T> {
+  value: T;
+  controlRef: ControlRef;
+}
+
+```
+
+#### `addControl` <a name="api-actions-add-control"></a>
+
+Adds a control to a form group.
+
+```typescript
+type addControl = (payload: AddControlPayload) => void;
+
+export interface AddControlPayload {
+  config: AbstractControlConfig;
+  controlRef: ControlRef;
+}
+
+```
+
+#### `pushControl` <a name="api-actions-push-control"></a>
+
+Pushes a control to a form array.
+
+```typescript
+type pushControl = (payload: PushControlPayload) => void;
+
+export interface PushControlPayload {
+  config: AbstractControlConfig;
+  controlRef: ControlRef;
+}
+
+```
+
+#### `removeControl` <a name="api-actions-remove-control"></a>
+
+Removes a specified control from form.
+
+```typescript
+type removeControl = (payload: ControlRef) => void;
+
+```
+
+#### `markControlAsPristine` <a name="api-actions-mark-as-pristine"></a>
+
+Marks a control and all descendant controls as pristine.
+
+```typescript
+type markControlAsPristine = (payload: ControlRef) => void;
+
+```
+
+#### `markControlAsTouched` <a name="api-actions-mark-as-touched"></a>
+
+Marks a control and all ancestors as touched. Can pass a `markAll` true to mark all descendants as touched as well.
+
+```typescript
+type markControlAsTouched = (payload: MarkTouchedPayload) => void;
+
+export interface MarkTouchedPayload {
+  controlRef: ControlRef;
+  markAll?: boolean;
+}
+
+```
+
+#### `markControlAsUntouched` <a name="api-actions-mark-as-untouched"></a>
+
+Marks a control and all descendants as untouched. Will recheck ancestors controls and update touched status.
+
+```typescript
+type markControlAsUnTouched = (payload: ControlRef) => void;
+
+```
+
+#### `resetControl` <a name="api-actions-resetControl"></a>
+
+Marks a control and all descendants as untouched. Will recheck ancestors controls and update touched status.
+
 ```typescript
-type RxFormActions = {
-  updateValues: <T>(payload: ControlChange<T>) => void;
-  addControl: (payload: AddControl) => void;
-  pushControl: (payload: PushControl) => void;
-  removeControl: (payload: ControlRef) => void;
-  markControlAsPristine: (payload: ControlRef) => void;
-  markControlAsTouched: (payload: MarkTouched) => void;
-  markControlAsUntouched: (payload: ControlRef) => void;
-  resetControl: (payload: ControlRef) => void;
-};
+type resetControls = (payload: ControlRef) => void;
+
 ```
 
 ### `build` <a name="api-build"></a>
 
 ```typescript
-type build = (config: AbstractControlConfig, options?: EffectsAndSources) => Reactable<Form<unknown>, RxFormActions>
+type build = (config: AbstractControlConfig, options?: RxFormOptions) => Reactable<Form<unknown>, RxFormActions>
 ```
 
-Factory method for creating a form Reactable. Accepts a configuration object generated by one or more helper methods - [`control`](#api-control), [`group`](#api-group), [`array`](#api-array).
+Factory method for creating a form Reactable. Accepts a configuration object generated by one or more helper methods - [`control`](#api-control), [`group`](#api-group), [`array`](#api-array). Also accepts an `RxFormOptions` object.
+
+
+#### `RxFormOptions` <a name="api-form-options"></a>
+
+Options to customize RxForm behaviour.
 
-Options can also be provided to declare [Effects and Sources](#effects-sources) for the form Reactable.
+```typescript
+interface RxFormOptions {
+  reducers?: { [key:string]: CustomReducer }
+  effects?: Effect<unknown, unknown>[];
+  sources?: Observable<Action<unknown>>[] | { [key: string]: Observable<unknown> };
+}
+
+type CustomReducer = (
+  reducers: FormReducers,
+  state: BaseFormState<unknown>,
+  action: Action<unknown>,
+) => BaseFormState<unknown>;
+
+```
+| Property | Description |
+| -------- | ----------- |
+| reducers (optional) | Dictionary of `CustomReducer`s to implement custom form behaviour. The `CustomReducer` provides built in [`FormReducers`](#api-form-reducers). **Form state updates need to be made with [`FormReducers`](#api-form-reducers) to maintain integrity of the form state tree (i.e validation states of parent and child controls)**. |
+| effects (optional) | Array of [Effects](https://github.com/reactables/reactables/tree/main/packages/core#api-effect) to be registered to the Reactable. |
+| sources (optional) | Additional [Action](https://github.com/reactables/reactables/tree/main/packages/core#action-) Observables the Reactable is listening to. Can be an array or a dictionary where key is the action type and value is the Observable emitting the payload. |
 
 ### `control` <a name="api-control"></a>
 
@@ -105,16 +211,85 @@ interface FormArrayConfig {
 }
 ```
 
-### Other Interfaces <a name="interfaces"></a>
+### Other Interfaces <a name="api-interfaces"></a>
+
+#### `Form` <a name="api-form"></a>
+Form state. Dictionary of [`FormControl`](#api-form-control)(s) where the key is a period separated representation of the [`ControlRef`](#api-control-ref) tuple.
 
-#### EffectsAndSources <a name="effects-sources"></a>
 ```typescript
-interface EffectsAndSources {
-  effects?: Effect<unknown, unknown>[];
-  sources?: Observable<Action<unknown>>[] | { [key: string]: Observable<unknown> };
+export interface Form<T> {
+  root?: FormControl<T>;
+  [key: string]: FormControl<unknown>;
+}
+
+```
+
+#### `FormControl` <a name="api-form-control"></a>
+
+```typescript
+
+export interface FormControl<T> extends BaseControl<T>, Hub2Fields {
+  pristineValue: T;
+  controlRef: ControlRef;
+  value: T;
+  dirty: boolean;
+  touched: boolean;
+  validatorErrors: FormErrors;
+  key: string;
+  asyncValidatorErrors: FormErrors;
+  asyncValidateInProgress: { [key: string | number]: boolean };
+  errors: FormErrors;
+  valid: boolean;
+  childrenValid: boolean;
+  pending?: boolean;
+  config: AbstractControlConfig;
 }
 ```
 | Property | Description |
 | -------- | ----------- |
-| effects (optional) | Array of [Effects](https://github.com/reactables/reactables/tree/main/packages/core#api-effect) to be registered to the Reactable |
-| sources (optional) | Additional [Action](https://github.com/reactables/reactables/tree/main/packages/core#action-) Observables the Reactable is listening to. Can be an array or a dictionary where key is the action type and value is the Observable emitting the payload |
+| pristineValue  | Original value of control. Use to determine if control is dirty. |
+| controlRef  | Controls [`ControlRef`](#api-control-ref). |
+| value  | Control value. |
+| touched  | Touched status of control |
+| validatorErrors | [`FormErrors`](#api-form-errors) from validators (non-async) |
+| asyncValidatorErrors | [`FormErrors`](#api-form-errors) from async validators |
+| errors | [`FormErrors`](#api-form-errors) validatorErrors and asyncValidatorErrors merged. |
+| valid | Valid status of control. Also checks descendants.
+| childrenValid | Valid status of direct child controls.
+| config | Original config for form control |
+
+
+
+#### `ControlRef` <a name="api-control-ref"></a>
+
+Control Reference represented as a tuple for the [`FormControl`](#api-form-control)
+
+#### `FormErrors` <a name="api-form-errors"></a>
+
+Dictionary of errors for the control.
+
+```typescript
+export interface FormErrors {
+  [key: string]: boolean;
+}
+```
+
+#### `FormReducers` <a name="api-form-reducers"></a>
+
+Built in reducers to be used to update state of form tree. Payload and behaviour is same and descrbed in [`RxActions`](#api-actions); 
+
+```typescript
+
+export interface FormReducers {
+  updateValues: <T>(state: BaseFormState<T>, payload: UpdateValuesPayload<unknown>,
+  ) => BaseFormState<T>;
+  removeControl: <T>(state: BaseFormState<T>, payload: ControlRef) => BaseFormState<T>;
+  pushControl: <T>(state: BaseFormState<T>, payload: PushControlPayload) => BaseFormState<T>;
+  addControl: <T>(state: BaseFormState<T>, payload: AddControlPayload) => BaseFormState<T>;
+  markControlAsPristine: <T>(state: BaseFormState<T>, payload: ControlRef) => BaseFormState<T>;
+  markControlAsTouched: <T>(state: BaseFormState<T>, payload: MarkTouchedPayload) => BaseFormState<T>;
+  markControlAsUntouched: <T>(state: BaseFormState<T>, payload: ControlRef,
+  ) => BaseFormState<T>;
+  resetControl: <T>(state: BaseFormState<T>, payload: ControlRef) => BaseFormState<T>;
+}
+```

package/dist/Helpers/buildHub2Source.d.ts

@@ -1,4 +1,4 @@
 import { Observable } from 'rxjs';
-import { Action, Reactable } from '@reactables/core';
+import { Action } from '@reactables/core';
 import { BaseFormState } from '../Models/Controls';
-export declare const buildHub2Source: <T, S>(rx: Reactable<BaseFormState<T>, S>) => Observable<Action<T>>;
+export declare const buildHub2Source: <T, S>(hub1State$: Observable<BaseFormState<T>>) => Observable<Action<T>>;

package/dist/Models/Configs.d.ts

@@ -13,6 +13,7 @@ export interface FormArrayConfig extends ValidatorConfigs {
 }
 export interface FormControlConfig<T> extends ValidatorConfigs {
     initialValue: T;
+    normalizers?: ((value: T) => T)[];
 }
 export type AbstractControlConfig = (FormControlConfig<unknown> | FormArrayConfig | FormGroupConfig) & {
     controls?: AbstractControlConfig[] | {

package/dist/Models/Controls.d.ts

@@ -1,4 +1,3 @@
-import { Action } from '@reactables/core';
 import { AbstractControlConfig } from './Configs';
 import { FormErrors } from './FormErrors';
 import { ControlRef } from './ControlRef';
@@ -30,7 +29,12 @@ export interface FormControl<T> extends BaseControl<T>, Hub2Fields {
 }
 export interface BaseFormState<T> {
     form: BaseForm<T>;
-    action: Action<unknown>;
+    changedControls?: {
+        [key: string]: BaseControl<unknown>;
+    };
+    removedControls?: {
+        [key: string]: BaseControl<unknown>;
+    };
 }
 export interface BaseForm<T> {
     root?: BaseControl<T>;

package/dist/Models/Payloads.d.ts

@@ -1,15 +1,15 @@
 import { ControlRef } from './ControlRef';
 import { AbstractControlConfig } from './Configs';
 import { FormErrors } from './FormErrors';
-export interface ControlChange<T> {
+export interface UpdateValuesPayload<T> {
     value: T;
     controlRef: ControlRef;
 }
-export interface AddControl {
+export interface AddControlPayload {
     config: AbstractControlConfig;
     controlRef: ControlRef;
 }
-export interface PushControl {
+export interface PushControlPayload {
     config: AbstractControlConfig;
     controlRef: ControlRef;
 }
@@ -18,7 +18,7 @@ export interface ControlAsyncValidationResponse {
     validatorIndex: number;
     errors: FormErrors;
 }
-export interface MarkTouched {
+export interface MarkTouchedPayload {
     controlRef: ControlRef;
     markAll?: boolean;
 }

package/dist/Models/index.d.ts

@@ -2,5 +2,5 @@ export { AbstractControlConfig, FormArrayConfig, FormGroupConfig, FormControlCon
 export { ControlRef } from './ControlRef';
 export * as ControlModels from './Controls';
 export { FormErrors } from './FormErrors';
-export { ControlChange, AddControl, ControlAsyncValidationResponse, MarkTouched } from './Payloads';
+export { UpdateValuesPayload, AddControlPayload, ControlAsyncValidationResponse, MarkTouchedPayload, } from './Payloads';
 export { ValidatorAsyncFn, ValidatorFn } from './Validators';

package/dist/Reducers/Hub1/addControl.d.ts

@@ -1,4 +1,4 @@
 import { Action } from '@reactables/core';
 import { BaseFormState } from '../../Models/Controls';
-import { AddControl } from '../../Models/Payloads';
-export declare const addControl: <T>(state: BaseFormState<T>, action: Action<AddControl>) => BaseFormState<T>;
+import { AddControlPayload } from '../../Models/Payloads';
+export declare const addControl: <T>(state: BaseFormState<T>, action: Action<AddControlPayload>, mergeChanges?: boolean) => BaseFormState<T>;

package/dist/Reducers/Hub1/markControlAsPristine.d.ts

@@ -1,4 +1,4 @@
 import { Action } from '@reactables/core';
 import { BaseFormState } from '../../Models/Controls';
 import { ControlRef } from '../../Models/ControlRef';
-export declare const markControlAsPristine: <T>({ form }: BaseFormState<T>, action: Action<ControlRef>) => BaseFormState<T>;
+export declare const markControlAsPristine: <T>(state: BaseFormState<T>, action: Action<ControlRef>, mergeChanges?: boolean) => BaseFormState<T>;

package/dist/Reducers/Hub1/markControlAsTouched.d.ts

@@ -1,4 +1,4 @@
 import { Action } from '@reactables/core';
 import { BaseFormState } from '../../Models/Controls';
-import { MarkTouched } from '../../Models/Payloads';
-export declare const markControlAsTouched: <T>({ form }: BaseFormState<T>, action: Action<MarkTouched>) => BaseFormState<T>;
+import { MarkTouchedPayload } from '../../Models/Payloads';
+export declare const markControlAsTouched: <T>(state: BaseFormState<T>, action: Action<MarkTouchedPayload>, mergeChanges?: boolean) => BaseFormState<T>;

package/dist/Reducers/Hub1/markControlAsUntouched.d.ts

@@ -1,4 +1,4 @@
 import { Action } from '@reactables/core';
 import { BaseFormState } from '../../Models/Controls';
 import { ControlRef } from '../../Models/ControlRef';
-export declare const markControlAsUntouched: <T>({ form }: BaseFormState<T>, action: Action<ControlRef>) => BaseFormState<T>;
+export declare const markControlAsUntouched: <T>(state: BaseFormState<T>, action: Action<ControlRef>, mergeChanges?: boolean) => BaseFormState<T>;

package/dist/Reducers/Hub1/pushControl.d.ts

@@ -1,4 +1,4 @@
 import { Action } from '@reactables/core';
 import { BaseFormState } from '../../Models/Controls';
-import { AddControl } from '../../Models/Payloads';
-export declare const pushControl: <T>(state: BaseFormState<T>, action: Action<AddControl>) => BaseFormState<T>;
+import { AddControlPayload } from '../../Models/Payloads';
+export declare const pushControl: <T>(state: BaseFormState<T>, action: Action<AddControlPayload>, mergeChanges?: boolean) => BaseFormState<T>;

package/dist/Reducers/Hub1/removeControl.d.ts

@@ -1,4 +1,4 @@
 import { Action } from '@reactables/core';
 import { BaseFormState } from '../../Models/Controls';
 import { ControlRef } from '../../Models/ControlRef';
-export declare const removeControl: <T>({ form }: BaseFormState<T>, action: Action<ControlRef>) => BaseFormState<T>;
+export declare const removeControl: <T>(state: BaseFormState<T>, action: Action<ControlRef>, mergeChanges?: boolean) => BaseFormState<T>;

package/dist/Reducers/Hub1/resetControl.d.ts

@@ -1,4 +1,4 @@
 import { Action } from '@reactables/core';
 import { BaseFormState } from '../../Models/Controls';
 import { ControlRef } from '../../Models/ControlRef';
-export declare const resetControl: <T>({ form }: BaseFormState<T>, action: Action<ControlRef>) => BaseFormState<T>;
+export declare const resetControl: <T>(state: BaseFormState<T>, action: Action<ControlRef>, mergeChanges?: boolean) => BaseFormState<T>;

package/dist/Reducers/Hub1/updateAncestorValues.d.ts

@@ -1,5 +1,5 @@
 import { Action } from '@reactables/core';
 import { BaseForm } from '../../Models/Controls';
-import { ControlChange } from '../../Models/Payloads';
+import { UpdateValuesPayload } from '../../Models/Payloads';
 export declare const UPDATE_ANCESTOR_VALUES = "UPDATE_ANCESTOR_VALUES";
-export declare const updateAncestorValues: <T>(form: BaseForm<T>, { payload: { controlRef, value } }: Action<ControlChange<unknown>>) => BaseForm<T>;
+export declare const updateAncestorValues: <T>(form: BaseForm<T>, { payload: { controlRef, value } }: Action<UpdateValuesPayload<unknown>>) => BaseForm<T>;

package/dist/Reducers/Hub1/updateAncestorValuesAddControl.d.ts

@@ -1,5 +1,5 @@
 import { Action } from '@reactables/core';
 import { BaseForm } from '../../Models/Controls';
-import { ControlChange } from '../../Models/Payloads';
+import { UpdateValuesPayload } from '../../Models/Payloads';
 export declare const UPDATE_ANCESTOR_VALUES_ADD_CONTROL = "UPDATE_ANCESTOR_VALUES_ADD_CONTROL";
-export declare const updateAncestorValuesAddControl: <T>(form: BaseForm<T>, { payload: { controlRef, value } }: Action<ControlChange<unknown>>) => BaseForm<T>;
+export declare const updateAncestorValuesAddControl: <T>(form: BaseForm<T>, { payload: { controlRef, value } }: Action<UpdateValuesPayload<unknown>>) => BaseForm<T>;

package/dist/Reducers/Hub1/updateValues.d.ts

@@ -1,4 +1,4 @@
 import { Action } from '@reactables/core';
 import { BaseFormState } from '../../Models/Controls';
-import { ControlChange } from '../../Models/Payloads';
-export declare const updateValues: <T>({ form }: BaseFormState<T>, action: Action<ControlChange<unknown>>) => BaseFormState<T>;
+import { UpdateValuesPayload } from '../../Models/Payloads';
+export declare const updateValues: <T>({ form, changedControls, removedControls }: BaseFormState<T>, action: Action<UpdateValuesPayload<unknown>>, mergeChanges?: boolean) => BaseFormState<T>;

package/dist/Reducers/Hub2/{mergePushControl.d.ts → mergeControls.d.ts}

@@ -1,15 +1,14 @@
-import { Form, BaseForm } from '../../Models/Controls';
-import { ControlRef } from '../../Models/ControlRef';
+import { Form, FormControl, BaseFormState } from '../../Models/Controls';
 import { FormErrors } from '../../Models/FormErrors';
-export declare const mergePushControl: <T>(state: Form<T>, form: BaseForm<T>, controlRef: ControlRef) => {
-    [x: string]: import("../../Models/Controls").FormControl<unknown> | {
+export declare const mergeControls: <T>(state: Form<T>, { form, changedControls, removedControls }: BaseFormState<unknown>) => {
+    [x: string]: FormControl<unknown> | {
         errors: {
             [x: string]: boolean;
         };
         valid: boolean;
         childrenValid: boolean;
         pristineValue: unknown;
-        controlRef: ControlRef;
+        controlRef: import("../..").ControlRef;
         value: unknown;
         dirty: boolean;
         touched: boolean;
@@ -23,5 +22,5 @@ export declare const mergePushControl: <T>(state: Form<T>, form: BaseForm<T>, co
         };
         pending?: boolean;
     };
-    root?: import("../../Models/Controls").FormControl<unknown>;
+    root?: FormControl<unknown>;
 };

package/dist/RxForm/RxForm.d.ts

@@ -1,22 +1,42 @@
-import { Reactable, EffectsAndSources } from '@reactables/core';
-import { ControlChange, AddControl, MarkTouched, PushControl } from '../Models/Payloads';
+import { Reactable, EffectsAndSources, Action, Effect, ScopedEffects } from '@reactables/core';
+import { UpdateValuesPayload, AddControlPayload, MarkTouchedPayload, PushControlPayload } from '../Models/Payloads';
 import { ControlRef } from '../Models';
 import { FormControlConfig, FormArrayConfig, FormGroupConfig, AbstractControlConfig } from '../Models/Configs';
 import { ValidatorFn, ValidatorAsyncFn } from '../Models/Validators';
-import { Form } from '../Models/Controls';
+import { Form, BaseFormState } from '../Models/Controls';
 type FbControl<T> = [T, (ValidatorFn | ValidatorFn[])?, (ValidatorAsyncFn | ValidatorAsyncFn[])?];
 export declare const control: <T>(config: FormControlConfig<T> | FbControl<T>) => FormControlConfig<T>;
 export declare const array: (config: FormArrayConfig) => FormArrayConfig;
 export declare const group: (config: FormGroupConfig) => FormGroupConfig;
 export type RxFormActions = {
-    updateValues: <T>(payload: ControlChange<T>) => void;
-    addControl: (payload: AddControl) => void;
-    pushControl: (payload: PushControl) => void;
+    updateValues: <T>(payload: UpdateValuesPayload<T>) => void;
+    addControl: (payload: AddControlPayload) => void;
+    pushControl: (payload: PushControlPayload) => void;
     removeControl: (payload: ControlRef) => void;
     markControlAsPristine: (payload: ControlRef) => void;
-    markControlAsTouched: (payload: MarkTouched) => void;
+    markControlAsTouched: (payload: MarkTouchedPayload) => void;
     markControlAsUntouched: (payload: ControlRef) => void;
     resetControl: (payload: ControlRef) => void;
 };
-export declare const build: (config: AbstractControlConfig, options?: EffectsAndSources) => Reactable<Form<unknown>, RxFormActions>;
+export interface FormReducers {
+    updateValues: <T>(state: BaseFormState<T>, payload: UpdateValuesPayload<unknown>) => BaseFormState<T>;
+    removeControl: <T>(state: BaseFormState<T>, payload: ControlRef) => BaseFormState<T>;
+    pushControl: <T>(state: BaseFormState<T>, payload: PushControlPayload) => BaseFormState<T>;
+    addControl: <T>(state: BaseFormState<T>, payload: AddControlPayload) => BaseFormState<T>;
+    markControlAsPristine: <T>(state: BaseFormState<T>, payload: ControlRef) => BaseFormState<T>;
+    markControlAsTouched: <T>(state: BaseFormState<T>, payload: MarkTouchedPayload) => BaseFormState<T>;
+    markControlAsUntouched: <T>(state: BaseFormState<T>, payload: ControlRef) => BaseFormState<T>;
+    resetControl: <T>(state: BaseFormState<T>, payload: ControlRef) => BaseFormState<T>;
+}
+type CustomReducer = (reducers: FormReducers, state: BaseFormState<unknown>, action: Action<unknown>) => BaseFormState<unknown>;
+export interface CustomReducers {
+    [key: string]: CustomReducer | {
+        reducer: CustomReducer;
+        effects?: ((payload?: unknown) => ScopedEffects<unknown>) | Effect<unknown, unknown>[];
+    };
+}
+export interface RxFormOptions<T extends CustomReducers> extends EffectsAndSources {
+    reducers?: T;
+}
+export declare const build: <T extends CustomReducers>(config: AbstractControlConfig, options?: RxFormOptions<T>) => Reactable<Form<unknown>, { [K in keyof T]: (payload?: any) => void; } & RxFormActions>;
 export {};

package/dist/RxForm/Tests/customReducers.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/RxForm/Tests/initialization.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/RxForm/Tests/markControlAsPristine.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/RxForm/Tests/markControlTouchStatus.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/RxForm/Tests/pushControl.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/RxForm/Tests/removeControl.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/RxForm/Tests/resetControl.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/RxForm/Tests/updateValues.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/RxForm/index.d.ts

@@ -1 +1 @@
-export { build, group, array, control, RxFormActions } from './RxForm';
+export { build, group, array, control, RxFormActions, FormReducers } from './RxForm';