@spscommerce/ds-react 5.20.2 → 5.20.3-ie

package/dist/out-tsc/form/SpsForm.d.ts

@@ -0,0 +1,24 @@
+import * as React from "react";
+import * as PropTypes from "../prop-types";
+import type { SpsFormArray } from "./hooks/formArray";
+import type { SpsFormGroup } from "./hooks/formGroup";
+import type { SpsFormSetMeta } from "./hooks/useSpsForm";
+export declare const spsFormProps: {
+    formMeta: string;
+    onSubmit: string;
+};
+export declare const spsFormPropTypes: {
+    formArray: PropTypes.Requireable<SpsFormArray<any>>;
+    formGroup: PropTypes.Requireable<SpsFormGroup>;
+    formMeta: PropTypes.Requireable<SpsFormSetMeta<any, import("./hooks/useSpsForm").InferredSpsFormMetaSetMembers<any>>>;
+    onSubmit: PropTypes.Requireable<React.FormEventHandler<Element>>;
+    children: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+    className: PropTypes.Requireable<string>;
+    "data-testid": PropTypes.Requireable<string>;
+    unsafelyReplaceClassName: PropTypes.Requireable<string>;
+};
+export declare type SpsFormProps = PropTypes.InferTS<typeof spsFormPropTypes, HTMLFormElement>;
+declare type SpsFormForwardRefType = SpsFormProps & React.RefAttributes<HTMLFormElement>;
+declare type SpsFormForwardRefExoticComponent = React.ForwardRefExoticComponent<SpsFormForwardRefType>;
+export declare const SpsForm: SpsFormForwardRefExoticComponent;
+export {};

package/dist/out-tsc/form/SpsForm.examples.d.ts

@@ -0,0 +1,50 @@
+export declare const SpsFormExamples: {
+    a_basic: {
+        label: string;
+        description: string;
+        examples: {
+            basic: {
+                react: string;
+            };
+        };
+    };
+    b_array: {
+        label: string;
+        description: string;
+        examples: {
+            array: {
+                react: string;
+            };
+        };
+    };
+    c_dynamic_group: {
+        label: string;
+        description: string;
+        examples: {
+            basic: {
+                react: string;
+            };
+        };
+    };
+    preventative_validators: {
+        label: string;
+        examples: {
+            basic: {
+                react: string;
+            };
+            custom_text: {
+                description: () => JSX.Element;
+                react: string;
+            };
+        };
+    };
+    custom_errors: {
+        label: string;
+        description: () => JSX.Element;
+        examples: {
+            basic: {
+                react: string;
+            };
+        };
+    };
+};

package/dist/out-tsc/form/SpsForm.examples.js

@@ -0,0 +1,67 @@
+var __makeTemplateObject = (this && this.__makeTemplateObject) || function (cooked, raw) {
+    if (Object.defineProperty) { Object.defineProperty(cooked, "raw", { value: raw }); } else { cooked.raw = raw; }
+    return cooked;
+};
+import * as React from "react";
+import { code } from "@spscommerce/utils";
+export var SpsFormExamples = {
+    a_basic: {
+        label: "Basic Usage",
+        description: "",
+        examples: {
+            basic: {
+                react: code(templateObject_1 || (templateObject_1 = __makeTemplateObject(["\n                    function DemoComponent() {\n                        const COLOR_OPTIONS = [\"red\", \"blue\", \"green\"];\n                        const initValue = {\n                            name: \"Foo\",\n                            color: COLOR_OPTIONS[0],\n                        };\n                        const { formValue, formMeta, updateForm } = useSpsForm(initValue, {\n                            \"name\": value => value.color === COLOR_OPTIONS[0] ? [SpsValidators.required] : []\n                        });\n\n                        function handleSubmit() {\n                            console.log(\"submit\", formValue);\n                        }\n                        function reset() {\n                            updateForm(initValue);\n                        }\n\n                        return <>\n                            <SpsForm formMeta={formMeta} onSubmit={handleSubmit}>\n                                <div className=\"sfg-row\">\n                                    <div className=\"sfg-col-8\">\n                                        <SpsLabel for={formMeta.fields.name}>Name</SpsLabel>\n                                        <SpsTextInput\n                                            value={formValue.name}\n                                            formMeta={formMeta.fields.name}\n                                        />\n                                    </div>\n                                    <div className=\"sfg-col-4\">\n                                        <SpsLabel for={formMeta.fields.color}>Color</SpsLabel>\n                                        {COLOR_OPTIONS.map(color =>\n                                            <SpsRadioButton key={color} name={color} value={color} label={color}\n                                                checked={color === formValue.color}\n                                                formMeta={formMeta.fields.color}\n                                            />\n                                        )}\n                                    </div>\n                                </div>\n                                <div className=\"sfg-row\">\n                                    <div className=\"sfg-col-12\">\n                                        <SpsButton className=\"mr-1\" onClick={reset}>Reset</SpsButton>\n                                        <SpsButton type={ButtonType.SUBMIT} kind={ButtonKind.CONFIRM}>Submit</SpsButton>\n                                    </div>\n                                </div>\n                            </SpsForm>\n                            <br/>\n                            {JSON.stringify(formValue)}\n                        </>;\n                    }\n                "], ["\n                    function DemoComponent() {\n                        const COLOR_OPTIONS = [\"red\", \"blue\", \"green\"];\n                        const initValue = {\n                            name: \"Foo\",\n                            color: COLOR_OPTIONS[0],\n                        };\n                        const { formValue, formMeta, updateForm } = useSpsForm(initValue, {\n                            \"name\": value => value.color === COLOR_OPTIONS[0] ? [SpsValidators.required] : []\n                        });\n\n                        function handleSubmit() {\n                            console.log(\"submit\", formValue);\n                        }\n                        function reset() {\n                            updateForm(initValue);\n                        }\n\n                        return <>\n                            <SpsForm formMeta={formMeta} onSubmit={handleSubmit}>\n                                <div className=\"sfg-row\">\n                                    <div className=\"sfg-col-8\">\n                                        <SpsLabel for={formMeta.fields.name}>Name</SpsLabel>\n                                        <SpsTextInput\n                                            value={formValue.name}\n                                            formMeta={formMeta.fields.name}\n                                        />\n                                    </div>\n                                    <div className=\"sfg-col-4\">\n                                        <SpsLabel for={formMeta.fields.color}>Color</SpsLabel>\n                                        {COLOR_OPTIONS.map(color =>\n                                            <SpsRadioButton key={color} name={color} value={color} label={color}\n                                                checked={color === formValue.color}\n                                                formMeta={formMeta.fields.color}\n                                            />\n                                        )}\n                                    </div>\n                                </div>\n                                <div className=\"sfg-row\">\n                                    <div className=\"sfg-col-12\">\n                                        <SpsButton className=\"mr-1\" onClick={reset}>Reset</SpsButton>\n                                        <SpsButton type={ButtonType.SUBMIT} kind={ButtonKind.CONFIRM}>Submit</SpsButton>\n                                    </div>\n                                </div>\n                            </SpsForm>\n                            <br/>\n                            {JSON.stringify(formValue)}\n                        </>;\n                    }\n                "]))),
+            },
+        },
+    },
+    b_array: {
+        label: "Form Array",
+        description: "",
+        examples: {
+            array: {
+                react: code(templateObject_2 || (templateObject_2 = __makeTemplateObject(["\n                function DemoComponent() {\n                    const initValue = {\n                      itemList: [\"foo\"],\n                    }\n                    const { formValue, formMeta, updateForm } = useSpsForm(initValue, {\n                      \"itemList.*\": [SpsValidators.required],\n                    })\n\n                    function handleSubmit() {\n                      console.log(\"submit\", formValue)\n                    }\n                    function reset() {\n                      updateForm(initValue)\n                    }\n\n                    function addItem() {\n                      updateForm({\n                        ...formValue,\n                        itemList: [...formValue.itemList, \"\"],\n                      })\n                    }\n                    function removeItem(index) {\n                      updateForm({\n                        ...formValue,\n                        itemList: formValue.itemList.filter((_, i) => index !== i),\n                      })\n                    }\n\n                    return (\n                      <>\n                        <SpsForm formMeta={formMeta} onSubmit={handleSubmit}>\n                          {formValue.itemList.map((item, index) => (\n                            <div className=\"sfg-row\" key={index}>\n                              <div className=\"sfg-col-4\">\n                                <SpsLabel for={formMeta.fields.itemList.fields[index]}>\n                                  Item\n                                </SpsLabel>\n                                <SpsTextInput\n                                  value={item}\n                                  formMeta={formMeta.fields.itemList.fields[index]}\n                                />\n                              </div>\n                              <div className=\"sfg-col-1\">\n                                <SpsButton\n                                  kind={ButtonKind.ICON}\n                                  icon={SpsIcon.TRASH}\n                                  className=\"sps-label-spacing\"\n                                  onClick={() => removeItem(index)}\n                                />\n                              </div>\n                            </div>\n                          ))}\n                          <div className=\"sfg-row\">\n                            <div className=\"sfg-col-12\">\n                              <SpsButton\n                                className=\"mr-1\"\n                                kind={ButtonKind.KEY}\n                                icon={SpsIcon.PLUS_SIGN}\n                                onClick={addItem}\n                              >\n                                Add Item\n                              </SpsButton>\n                              <SpsButton className=\"mr-1\" onClick={reset}>\n                                Reset\n                              </SpsButton>\n                              <SpsButton\n                                type={ButtonType.SUBMIT}\n                                kind={ButtonKind.CONFIRM}\n                              >\n                                Submit\n                              </SpsButton>\n                            </div>\n                          </div>\n                        </SpsForm>\n                        <br />\n                        {JSON.stringify(formValue)}\n                      </>\n                    )\n                  }\n                "], ["\n                function DemoComponent() {\n                    const initValue = {\n                      itemList: [\"foo\"],\n                    }\n                    const { formValue, formMeta, updateForm } = useSpsForm(initValue, {\n                      \"itemList.*\": [SpsValidators.required],\n                    })\n\n                    function handleSubmit() {\n                      console.log(\"submit\", formValue)\n                    }\n                    function reset() {\n                      updateForm(initValue)\n                    }\n\n                    function addItem() {\n                      updateForm({\n                        ...formValue,\n                        itemList: [...formValue.itemList, \"\"],\n                      })\n                    }\n                    function removeItem(index) {\n                      updateForm({\n                        ...formValue,\n                        itemList: formValue.itemList.filter((_, i) => index !== i),\n                      })\n                    }\n\n                    return (\n                      <>\n                        <SpsForm formMeta={formMeta} onSubmit={handleSubmit}>\n                          {formValue.itemList.map((item, index) => (\n                            <div className=\"sfg-row\" key={index}>\n                              <div className=\"sfg-col-4\">\n                                <SpsLabel for={formMeta.fields.itemList.fields[index]}>\n                                  Item\n                                </SpsLabel>\n                                <SpsTextInput\n                                  value={item}\n                                  formMeta={formMeta.fields.itemList.fields[index]}\n                                />\n                              </div>\n                              <div className=\"sfg-col-1\">\n                                <SpsButton\n                                  kind={ButtonKind.ICON}\n                                  icon={SpsIcon.TRASH}\n                                  className=\"sps-label-spacing\"\n                                  onClick={() => removeItem(index)}\n                                />\n                              </div>\n                            </div>\n                          ))}\n                          <div className=\"sfg-row\">\n                            <div className=\"sfg-col-12\">\n                              <SpsButton\n                                className=\"mr-1\"\n                                kind={ButtonKind.KEY}\n                                icon={SpsIcon.PLUS_SIGN}\n                                onClick={addItem}\n                              >\n                                Add Item\n                              </SpsButton>\n                              <SpsButton className=\"mr-1\" onClick={reset}>\n                                Reset\n                              </SpsButton>\n                              <SpsButton\n                                type={ButtonType.SUBMIT}\n                                kind={ButtonKind.CONFIRM}\n                              >\n                                Submit\n                              </SpsButton>\n                            </div>\n                          </div>\n                        </SpsForm>\n                        <br />\n                        {JSON.stringify(formValue)}\n                      </>\n                    )\n                  }\n                "]))),
+            },
+        },
+    },
+    c_dynamic_group: {
+        label: "Dynamic Group",
+        description: "",
+        examples: {
+            basic: {
+                react: code(templateObject_3 || (templateObject_3 = __makeTemplateObject(["\n                function DemoComponent() {\n                    const initValue = {\n                      name: \"Foo\",\n                    }\n                    const { formValue, formMeta, updateForm } = useSpsForm(initValue)\n\n                    function handleFieldsetToggle(enabled) {\n                      if (enabled) {\n                        updateForm({\n                          ...formValue,\n                          other_stuff: {\n                            tagline: \"\",\n                            description: \"\",\n                          },\n                        })\n                      } else {\n                        updateForm(omit(formValue, \"other_stuff\"))\n                      }\n                    }\n\n                    function handleSubmit() {\n                      console.log(\"submit\", formValue)\n                    }\n                    function reset() {\n                      updateForm(initValue)\n                    }\n\n                    return (\n                      <>\n                        <SpsForm formMeta={formMeta} onSubmit={handleSubmit}>\n                          <div className=\"sfg-row\">\n                            <div className=\"sfg-col-8\">\n                              <SpsLabel for={formMeta.fields.name}>Name</SpsLabel>\n                              <SpsTextInput\n                                value={formValue.name}\n                                formMeta={formMeta.fields.name}\n                              />\n                            </div>\n                            <div className=\"sfg-col-4\"></div>\n                          </div>\n                          <div className=\"sfg-row\">\n                            <div className=\"sfg-col-12\">\n                              <SpsFieldset\n                                optional\n                                enabled={formMeta.fields.other_stuff}\n                                formMeta={formMeta.fields.other_stuff}\n                                onToggled={handleFieldsetToggle}\n                                legend=\"Other Stuff\"\n                              >\n                                {formMeta.fields.other_stuff && (\n                                  <>\n                                    <div className=\"sfg-row\">\n                                      <div className=\"sfg-col-12\">\n                                        <SpsLabel\n                                          for={formMeta.fields.other_stuff.fields.tagline}\n                                        >\n                                          Tagline\n                                        </SpsLabel>\n                                        <SpsTextInput\n                                          value={formValue.other_stuff.tagline}\n                                          formMeta={formMeta.fields.other_stuff.fields.tagline}\n                                        />\n                                      </div>\n                                    </div>\n                                    <div className=\"sfg-row\">\n                                      <div className=\"sfg-col-12\">\n                                        <SpsLabel\n                                          for={formMeta.fields.other_stuff.fields.description}\n                                        >\n                                          Description\n                                        </SpsLabel>\n                                        <SpsTextInput\n                                          value={formValue.other_stuff.description}\n                                          formMeta={\n                                            formMeta.fields.other_stuff.fields.description\n                                          }\n                                        />\n                                      </div>\n                                    </div>\n                                  </>\n                                )}\n                              </SpsFieldset>\n                            </div>\n                          </div>\n                          <div className=\"sfg-row\">\n                            <div className=\"sfg-col-12\">\n                              <SpsButton className=\"mr-1\" onClick={reset}>\n                                Reset\n                              </SpsButton>\n                              <SpsButton\n                                type={ButtonType.SUBMIT}\n                                kind={ButtonKind.CONFIRM}\n                              >\n                                Submit\n                              </SpsButton>\n                            </div>\n                          </div>\n                        </SpsForm>\n                        <br />\n                        {JSON.stringify(formValue)}\n                      </>\n                    )\n                  }\n                "], ["\n                function DemoComponent() {\n                    const initValue = {\n                      name: \"Foo\",\n                    }\n                    const { formValue, formMeta, updateForm } = useSpsForm(initValue)\n\n                    function handleFieldsetToggle(enabled) {\n                      if (enabled) {\n                        updateForm({\n                          ...formValue,\n                          other_stuff: {\n                            tagline: \"\",\n                            description: \"\",\n                          },\n                        })\n                      } else {\n                        updateForm(omit(formValue, \"other_stuff\"))\n                      }\n                    }\n\n                    function handleSubmit() {\n                      console.log(\"submit\", formValue)\n                    }\n                    function reset() {\n                      updateForm(initValue)\n                    }\n\n                    return (\n                      <>\n                        <SpsForm formMeta={formMeta} onSubmit={handleSubmit}>\n                          <div className=\"sfg-row\">\n                            <div className=\"sfg-col-8\">\n                              <SpsLabel for={formMeta.fields.name}>Name</SpsLabel>\n                              <SpsTextInput\n                                value={formValue.name}\n                                formMeta={formMeta.fields.name}\n                              />\n                            </div>\n                            <div className=\"sfg-col-4\"></div>\n                          </div>\n                          <div className=\"sfg-row\">\n                            <div className=\"sfg-col-12\">\n                              <SpsFieldset\n                                optional\n                                enabled={formMeta.fields.other_stuff}\n                                formMeta={formMeta.fields.other_stuff}\n                                onToggled={handleFieldsetToggle}\n                                legend=\"Other Stuff\"\n                              >\n                                {formMeta.fields.other_stuff && (\n                                  <>\n                                    <div className=\"sfg-row\">\n                                      <div className=\"sfg-col-12\">\n                                        <SpsLabel\n                                          for={formMeta.fields.other_stuff.fields.tagline}\n                                        >\n                                          Tagline\n                                        </SpsLabel>\n                                        <SpsTextInput\n                                          value={formValue.other_stuff.tagline}\n                                          formMeta={formMeta.fields.other_stuff.fields.tagline}\n                                        />\n                                      </div>\n                                    </div>\n                                    <div className=\"sfg-row\">\n                                      <div className=\"sfg-col-12\">\n                                        <SpsLabel\n                                          for={formMeta.fields.other_stuff.fields.description}\n                                        >\n                                          Description\n                                        </SpsLabel>\n                                        <SpsTextInput\n                                          value={formValue.other_stuff.description}\n                                          formMeta={\n                                            formMeta.fields.other_stuff.fields.description\n                                          }\n                                        />\n                                      </div>\n                                    </div>\n                                  </>\n                                )}\n                              </SpsFieldset>\n                            </div>\n                          </div>\n                          <div className=\"sfg-row\">\n                            <div className=\"sfg-col-12\">\n                              <SpsButton className=\"mr-1\" onClick={reset}>\n                                Reset\n                              </SpsButton>\n                              <SpsButton\n                                type={ButtonType.SUBMIT}\n                                kind={ButtonKind.CONFIRM}\n                              >\n                                Submit\n                              </SpsButton>\n                            </div>\n                          </div>\n                        </SpsForm>\n                        <br />\n                        {JSON.stringify(formValue)}\n                      </>\n                    )\n                  }\n                "]))),
+            },
+        },
+    },
+    preventative_validators: {
+        label: "Preventative validators",
+        examples: {
+            basic: {
+                react: code(templateObject_4 || (templateObject_4 = __makeTemplateObject(["\n          function DemoComponent() {\n            const initValue = {\n                maxLength: \"\",\n                alpha: \"\",\n                numeric: \"\",\n                nonNumeric: \"\"\n            };\n\n            const { formValue, formMeta, updateForm } = useSpsForm(initValue, {\n                \"maxLength\": [SpsValidators.maxLength(5)],\n                \"alpha\": [SpsValidators.alpha],\n                \"numeric\": [SpsValidators.numeric],\n                \"nonNumeric\": [SpsValidators.nonNumeric]\n            });\n          \n            function handleSubmit() {\n                console.log(\"submit\", formValue);\n            }\n\n            function reset() {\n                updateForm(initValue);\n                formMeta.markAsPristine();\n            }\n          \n            return <>\n                <SpsForm formMeta={formMeta} onSubmit={handleSubmit}>                \n                    <div className=\"sfg-row\">\n                        <div className=\"sfg-col-8\">\n                            <SpsLabel\n                            for={formMeta.fields.maxLength}\n                            >\n                              MaxLength\n                            </SpsLabel>\n                            <SpsTextInput\n                                value={formValue.maxLength}\n                                formMeta={formMeta.fields.maxLength}\n                            />\n                        </div>\n                    </div>\n                    <div className=\"sfg-row\">\n                        <div className=\"sfg-col-8\">\n                            <SpsLabel\n                            for={formMeta.fields.alpha}                        \n                            >\n                              Alpha\n                            </SpsLabel>\n                            <SpsTextInput\n                                value={formValue.alpha}\n                                formMeta={formMeta.fields.alpha}\n                            />\n                        </div>\n                    </div>\n                    <div className=\"sfg-row\">\n                        <div className=\"sfg-col-8\">\n                            <SpsLabel\n                            for={formMeta.fields.numeric}\n                            >\n                              Numeric\n                            </SpsLabel>\n                            <SpsTextInput\n                                value={formValue.numeric}\n                                formMeta={formMeta.fields.numeric}\n                            />\n                        </div>\n                    </div>\n                    <div className=\"sfg-row\">\n                        <div className=\"sfg-col-8\">\n                            <SpsLabel\n                            for={formMeta.fields.nonNumeric}\n                            >\n                              nonNumeric\n                            </SpsLabel>\n                            <SpsTextInput\n                                value={formValue.nonNumeric}\n                                formMeta={formMeta.fields.nonNumeric}\n                            />\n                        </div>\n                    </div>\n          \n                    <div className=\"sfg-row\">\n                        <div className=\"sfg-col-12\">\n                            <SpsButton className=\"mr-1\" onClick={reset}>Reset</SpsButton>\n                            <SpsButton type={ButtonType.SUBMIT} kind={ButtonKind.CONFIRM}>Submit</SpsButton>\n                        </div>\n                    </div>\n                </SpsForm>\n            </>;\n          }\n      "], ["\n          function DemoComponent() {\n            const initValue = {\n                maxLength: \"\",\n                alpha: \"\",\n                numeric: \"\",\n                nonNumeric: \"\"\n            };\n\n            const { formValue, formMeta, updateForm } = useSpsForm(initValue, {\n                \"maxLength\": [SpsValidators.maxLength(5)],\n                \"alpha\": [SpsValidators.alpha],\n                \"numeric\": [SpsValidators.numeric],\n                \"nonNumeric\": [SpsValidators.nonNumeric]\n            });\n          \n            function handleSubmit() {\n                console.log(\"submit\", formValue);\n            }\n\n            function reset() {\n                updateForm(initValue);\n                formMeta.markAsPristine();\n            }\n          \n            return <>\n                <SpsForm formMeta={formMeta} onSubmit={handleSubmit}>                \n                    <div className=\"sfg-row\">\n                        <div className=\"sfg-col-8\">\n                            <SpsLabel\n                            for={formMeta.fields.maxLength}\n                            >\n                              MaxLength\n                            </SpsLabel>\n                            <SpsTextInput\n                                value={formValue.maxLength}\n                                formMeta={formMeta.fields.maxLength}\n                            />\n                        </div>\n                    </div>\n                    <div className=\"sfg-row\">\n                        <div className=\"sfg-col-8\">\n                            <SpsLabel\n                            for={formMeta.fields.alpha}                        \n                            >\n                              Alpha\n                            </SpsLabel>\n                            <SpsTextInput\n                                value={formValue.alpha}\n                                formMeta={formMeta.fields.alpha}\n                            />\n                        </div>\n                    </div>\n                    <div className=\"sfg-row\">\n                        <div className=\"sfg-col-8\">\n                            <SpsLabel\n                            for={formMeta.fields.numeric}\n                            >\n                              Numeric\n                            </SpsLabel>\n                            <SpsTextInput\n                                value={formValue.numeric}\n                                formMeta={formMeta.fields.numeric}\n                            />\n                        </div>\n                    </div>\n                    <div className=\"sfg-row\">\n                        <div className=\"sfg-col-8\">\n                            <SpsLabel\n                            for={formMeta.fields.nonNumeric}\n                            >\n                              nonNumeric\n                            </SpsLabel>\n                            <SpsTextInput\n                                value={formValue.nonNumeric}\n                                formMeta={formMeta.fields.nonNumeric}\n                            />\n                        </div>\n                    </div>\n          \n                    <div className=\"sfg-row\">\n                        <div className=\"sfg-col-12\">\n                            <SpsButton className=\"mr-1\" onClick={reset}>Reset</SpsButton>\n                            <SpsButton type={ButtonType.SUBMIT} kind={ButtonKind.CONFIRM}>Submit</SpsButton>\n                        </div>\n                    </div>\n                </SpsForm>\n            </>;\n          }\n      "]))),
+            },
+            custom_text: {
+                description: function () { return React.createElement("p", null, "Using custom text in the tooltip"); },
+                react: code(templateObject_5 || (templateObject_5 = __makeTemplateObject(["\n          function DemoComponent() {\n            const initValue = {\n                maxLength: \"\"\n            };\n\n            const { formValue, formMeta, updateForm } = useSpsForm(initValue, {\n                \"maxLength\": [SpsValidators.maxLength(5)]\n            });\n          \n            return <>\n                <SpsForm formMeta={formMeta} >                \n                    <div className=\"sfg-row\">\n                        <div className=\"sfg-col-8\">\n                            <SpsLabel\n                            for={formMeta.fields.maxLength}\n                            errors={() => formMeta.fields.maxLength.hasPreventativeError(\"maxLength\")\n                              && \"This field accepts a maximum of 5 characters.\"}\n                            >\n                              MaxLength\n                            </SpsLabel>\n                            <SpsTextInput\n                                value={formValue.maxLength}\n                                formMeta={formMeta.fields.maxLength}\n                            />\n                        </div>\n                    </div>\n                </SpsForm>\n            </>;\n          }\n      "], ["\n          function DemoComponent() {\n            const initValue = {\n                maxLength: \"\"\n            };\n\n            const { formValue, formMeta, updateForm } = useSpsForm(initValue, {\n                \"maxLength\": [SpsValidators.maxLength(5)]\n            });\n          \n            return <>\n                <SpsForm formMeta={formMeta} >                \n                    <div className=\"sfg-row\">\n                        <div className=\"sfg-col-8\">\n                            <SpsLabel\n                            for={formMeta.fields.maxLength}\n                            errors={() => formMeta.fields.maxLength.hasPreventativeError(\"maxLength\")\n                              && \"This field accepts a maximum of 5 characters.\"}\n                            >\n                              MaxLength\n                            </SpsLabel>\n                            <SpsTextInput\n                                value={formValue.maxLength}\n                                formMeta={formMeta.fields.maxLength}\n                            />\n                        </div>\n                    </div>\n                </SpsForm>\n            </>;\n          }\n      "]))),
+            },
+        },
+    },
+    custom_errors: {
+        label: "Custom errors",
+        description: function () { return (React.createElement(React.Fragment, null,
+            React.createElement("p", null,
+                "When using custom validators you can specify when to show the errors - on Change, on Blur or on Submit.",
+                React.createElement("br", null),
+                "On Blur is the default behavior. If you want to change that behavior you can use ",
+                React.createElement("b", null, "useCustomValidator hook"),
+                ". It takes validation function as first argument, validator configuration (object containing errorKey as key and ValidationMode as value) as second argument and dependencies as third argument. useCustomValidator returns a React callback of the validation function with the given dependencies."),
+            React.createElement("p", null,
+                React.createElement("b", null, "!Note:"),
+                " useCustomValidator hook will make changes to the global scope and once you set a custom error key you can't change it."))); },
+        examples: {
+            basic: {
+                react: code(templateObject_6 || (templateObject_6 = __makeTemplateObject(["\n          function DemoComponent() {\n\n            const customValidator = useCustomValidator(\n              (value) => value < 3 ? null : { customErrorKey: true },\n              { customErrorKey: ValidationMode.ON_CHANGE }\n              // or { customErrorKey: ValidationMode.ON_SUBMIT }\n            );         \n\n            const initValue = {\n                customErrorField: \"\",\n            };\n\n            const { formValue, formMeta, updateForm } = useSpsForm(initValue, {\n                \"customErrorField\": [customValidator],\n            });\n          \n            function handleSubmit() {\n                console.log(\"submit\", formValue);\n            }\n\n            function reset() {\n                updateForm(initValue);\n                formMeta.markAsPristine();\n            }\n          \n            return <>\n                <SpsForm formMeta={formMeta} onSubmit={handleSubmit}>                \n                    <div className=\"sfg-row\">\n                        <div className=\"sfg-col-8\">\n                            <SpsLabel\n                            for={formMeta.fields.customErrorField}\n                            errors={() => formMeta.fields.customErrorField.hasError(\"customErrorKey\")\n                                && \"Custom error description\"}\n                            >\n                              Custom Error\n                            </SpsLabel>\n                            <SpsTextInput\n                                value={formValue.customErrorField}\n                                formMeta={formMeta.fields.customErrorField}\n                            />\n                        </div>\n                    </div>\n          \n                    <div className=\"sfg-row\">\n                        <div className=\"sfg-col-12\">\n                            <SpsButton className=\"mr-1\" onClick={reset}>Reset</SpsButton>\n                            <SpsButton type={ButtonType.SUBMIT} kind={ButtonKind.CONFIRM}>Submit</SpsButton>\n                        </div>\n                    </div>\n                </SpsForm>\n            </>;\n          }\n      "], ["\n          function DemoComponent() {\n\n            const customValidator = useCustomValidator(\n              (value) => value < 3 ? null : { customErrorKey: true },\n              { customErrorKey: ValidationMode.ON_CHANGE }\n              // or { customErrorKey: ValidationMode.ON_SUBMIT }\n            );         \n\n            const initValue = {\n                customErrorField: \"\",\n            };\n\n            const { formValue, formMeta, updateForm } = useSpsForm(initValue, {\n                \"customErrorField\": [customValidator],\n            });\n          \n            function handleSubmit() {\n                console.log(\"submit\", formValue);\n            }\n\n            function reset() {\n                updateForm(initValue);\n                formMeta.markAsPristine();\n            }\n          \n            return <>\n                <SpsForm formMeta={formMeta} onSubmit={handleSubmit}>                \n                    <div className=\"sfg-row\">\n                        <div className=\"sfg-col-8\">\n                            <SpsLabel\n                            for={formMeta.fields.customErrorField}\n                            errors={() => formMeta.fields.customErrorField.hasError(\"customErrorKey\")\n                                && \"Custom error description\"}\n                            >\n                              Custom Error\n                            </SpsLabel>\n                            <SpsTextInput\n                                value={formValue.customErrorField}\n                                formMeta={formMeta.fields.customErrorField}\n                            />\n                        </div>\n                    </div>\n          \n                    <div className=\"sfg-row\">\n                        <div className=\"sfg-col-12\">\n                            <SpsButton className=\"mr-1\" onClick={reset}>Reset</SpsButton>\n                            <SpsButton type={ButtonType.SUBMIT} kind={ButtonKind.CONFIRM}>Submit</SpsButton>\n                        </div>\n                    </div>\n                </SpsForm>\n            </>;\n          }\n      "]))),
+            },
+        },
+    },
+};
+var templateObject_1, templateObject_2, templateObject_3, templateObject_4, templateObject_5, templateObject_6;
+//# sourceMappingURL=SpsForm.examples.js.map

package/dist/out-tsc/form/SpsForm.examples.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpsForm.examples.js","sourceRoot":"","sources":["../../../src/form/SpsForm.examples.tsx"],"names":[],"mappings":";;;;AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE1C,MAAM,CAAC,IAAM,eAAe,GAAG;IAC7B,OAAO,EAAE;QACP,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,EAAE;QACf,QAAQ,EAAE;YACR,KAAK,EAAE;gBACL,KAAK,EAAE,IAAI,gxFAAA,6sFAiDF,IAAA;aACV;SACF;KACF;IACD,OAAO,EAAE;QACP,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,EAAE;QACf,QAAQ,EAAE;YACR,KAAK,EAAE;gBACL,KAAK,EAAE,IAAI,ghHAAA,68GAgFF,IAAA;aACV;SACF;KACF;IACD,eAAe,EAAE;QACf,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,EAAE;QACf,QAAQ,EAAE;YACR,KAAK,EAAE;gBACL,KAAK,EAAE,IAAI,07JAAA,u3JAwGF,IAAA;aACV;SACF;KACF;IACD,uBAAuB,EAAE;QACvB,KAAK,EAAE,yBAAyB;QAChC,QAAQ,EAAE;YACR,KAAK,EAAE;gBACL,KAAK,EAAE,IAAI,2rHAAA,wnHAyFZ,IAAA;aACA;YACD,WAAW,EAAE;gBACX,WAAW,EAAE,cAAM,OAAA,kEAAuC,EAAvC,CAAuC;gBAC1D,KAAK,EAAE,IAAI,ywCAAA,ssCA8BZ,IAAA;aACA;SACF;KACF;IACD,aAAa,EAAE;QACb,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,cAAM,OAAA,CACjB;YACE;;gBAGE,+BAAM;;gBAEM,yDAA8B;uTAKxC;YACJ;gBACE,wCAAa;0IAEX,CACH,CACJ,EAlBkB,CAkBlB;QACD,QAAQ,EAAE;YACR,KAAK,EAAE;gBACL,KAAK,EAAE,IAAI,6rEAAA,0nEAqDZ,IAAA;aACA;SACF;KACF;CACF,CAAC"}

package/dist/out-tsc/form/SpsForm.js

@@ -0,0 +1,52 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+import * as React from "react";
+import * as PropTypes from "../prop-types";
+export var spsFormProps = {
+    formMeta: "SpsFormSetMeta<any>",
+    onSubmit: "React.FormEventHandler",
+};
+export var spsFormPropTypes = __assign(__assign({}, PropTypes.spsGlobalPropTypes), { formArray: PropTypes.impl(), formGroup: PropTypes.impl(), formMeta: PropTypes.impl(), onSubmit: PropTypes.fun() });
+export var SpsForm = React.forwardRef(function (props, ref) {
+    var children = props.children, onSubmit = props.onSubmit, formArray = props.formArray, formGroup = props.formGroup, formMeta = props.formMeta, rest = __rest(props, ["children", "onSubmit", "formArray", "formGroup", "formMeta"]);
+    var form = formGroup || formArray;
+    function handleSubmit(event) {
+        event.preventDefault();
+        if (form) {
+            form.markAsDirty();
+        }
+        if (formMeta) {
+            formMeta.markAsDirty();
+            formMeta.markAsBlurred();
+            formMeta.markAsSubmitted();
+        }
+        onSubmit(event);
+    }
+    return (React.createElement("form", __assign({ ref: ref, onSubmit: handleSubmit }, rest), children));
+});
+Object.assign(SpsForm, {
+    props: spsFormProps,
+    propTypes: spsFormPropTypes,
+    displayName: "SpsForm",
+});
+//# sourceMappingURL=SpsForm.js.map

package/dist/out-tsc/form/SpsForm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpsForm.js","sourceRoot":"","sources":["../../../src/form/SpsForm.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,SAAS,MAAM,eAAe,CAAC;AAM3C,MAAM,CAAC,IAAM,YAAY,GAAG;IAC1B,QAAQ,EAAE,qBAAqB;IAC/B,QAAQ,EAAE,wBAAwB;CACnC,CAAC;AAEF,MAAM,CAAC,IAAM,gBAAgB,yBACxB,SAAS,CAAC,kBAAkB,KAC/B,SAAS,EAAE,SAAS,CAAC,IAAI,EAAqB,EAC9C,SAAS,EAAE,SAAS,CAAC,IAAI,EAAgB,EACzC,QAAQ,EAAE,SAAS,CAAC,IAAI,EAAuB,EAC/C,QAAQ,EAAE,SAAS,CAAC,GAAG,EAA0B,GAClD,CAAC;AASF,MAAM,CAAC,IAAM,OAAO,GAAqC,KAAK,CAAC,UAAU,CACvE,UAAC,KAAmB,EAAE,GAA4C;IAE9D,IAAA,QAAQ,GAMN,KAAK,SANC,EACR,QAAQ,GAKN,KAAK,SALC,EACR,SAAS,GAIP,KAAK,UAJE,EACT,SAAS,GAGP,KAAK,UAHE,EACT,QAAQ,GAEN,KAAK,SAFC,EACL,IAAI,UACL,KAAK,EAPH,8DAOL,CADQ,CACC;IAEV,IAAM,IAAI,GAAkB,SAAS,IAAI,SAAS,CAAC;IAEnD,SAAS,YAAY,CAAC,KAAuC;QAC3D,KAAK,CAAC,cAAc,EAAE,CAAC;QACvB,IAAI,IAAI,EAAE;YACR,IAAI,CAAC,WAAW,EAAE,CAAC;SACpB;QACD,IAAI,QAAQ,EAAE;YACZ,QAAQ,CAAC,WAAW,EAAE,CAAC;YACvB,QAAQ,CAAC,aAAa,EAAE,CAAC;YACzB,QAAQ,CAAC,eAAe,EAAE,CAAC;SAC5B;QACD,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CACL,uCAAM,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,YAAY,IAAM,IAAI,GAC7C,QAAQ,CACJ,CACR,CAAC;AACJ,CAAC,CACF,CAAC;AAEF,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE;IACrB,KAAK,EAAE,YAAY;IACnB,SAAS,EAAE,gBAAgB;IAC3B,WAAW,EAAE,SAAS;CACvB,CAAC,CAAC"}

package/dist/out-tsc/form/SpsFormComponentWrapper.d.ts

@@ -0,0 +1,19 @@
+import * as React from "react";
+import * as PropTypes from "../prop-types";
+import type { SpsFormControl } from "./hooks/formControl";
+import type { SpsFormMetaBase } from "./hooks/useSpsForm";
+declare const spsFormComponentWrapperPropTypes: {
+    focusInputOnClick: PropTypes.Requireable<boolean>;
+    formMeta: PropTypes.Requireable<SpsFormMetaBase<any>>;
+    formControl: PropTypes.Requireable<SpsFormControl<any>>;
+    inputRef: PropTypes.Requireable<React.MutableRefObject<HTMLInputElement | HTMLTextAreaElement>>;
+    children: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+    className: PropTypes.Requireable<string>;
+    "data-testid": PropTypes.Requireable<string>;
+    unsafelyReplaceClassName: PropTypes.Requireable<string>;
+};
+export declare type SpsFormComponentWrapperProps = PropTypes.InferProps<typeof spsFormComponentWrapperPropTypes> & React.HTMLAttributes<HTMLDivElement>;
+declare type SpsFormComponentWrapperForwardRefType = SpsFormComponentWrapperProps & React.RefAttributes<HTMLDivElement>;
+declare type SpsFormComponentWrapperForwardRefExoticComponent = React.ForwardRefExoticComponent<SpsFormComponentWrapperForwardRefType>;
+export declare const SpsFormComponentWrapper: SpsFormComponentWrapperForwardRefExoticComponent;
+export {};

package/dist/out-tsc/form/SpsFormComponentWrapper.js

@@ -0,0 +1,69 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+import clsx from "clsx";
+import * as React from "react";
+import * as PropTypes from "../prop-types";
+import { SpsFormFieldMeta } from "./hooks/useSpsForm";
+var spsFormComponentWrapperPropTypes = __assign(__assign({}, PropTypes.spsGlobalPropTypes), { focusInputOnClick: PropTypes.bool, formMeta: PropTypes.impl(), formControl: PropTypes.impl(), inputRef: PropTypes.ref() });
+export var SpsFormComponentWrapper = React.forwardRef(function (props, ref) {
+    var className = props.className, children = props.children, focusInputOnClick = props.focusInputOnClick, formControl = props.formControl, formMeta = props.formMeta, inputRefProp = props.inputRef, onClick = props.onClick, rest = __rest(props, ["className", "children", "focusInputOnClick", "formControl", "formMeta", "inputRef", "onClick"]);
+    var fallbackRef = React.useRef();
+    var rootRef = ref || fallbackRef;
+    var inputRef = inputRefProp || rootRef;
+    function doFocusInputOnClick() {
+        if (inputRef && inputRef !== ref && inputRef.current) {
+            inputRef.current.focus();
+        }
+    }
+    function focusInput() {
+        if (inputRef && inputRef !== ref && inputRef.current) {
+            if (formMeta && formMeta instanceof SpsFormFieldMeta) {
+                formMeta.markAsFocused();
+            }
+        }
+    }
+    function blurInput() {
+        if (inputRef && inputRef !== ref && inputRef.current) {
+            if (formMeta && formMeta instanceof SpsFormFieldMeta) {
+                formMeta.markAsBlurred();
+            }
+        }
+    }
+    var classes = clsx("sps-form-group", ((formControl && formControl.isRequired())
+        || (formMeta && formMeta.isRequired())) && "sps-form-group--required", ((formControl && !formControl.isValid())
+        || (formMeta && formMeta.isVisibilyInvalid())) && "sps-form-group--error", ((formMeta && formMeta.hasPreventativeErrors())) && "sps-form-group--preventative-error", className);
+    function handleOnClick(event) {
+        if (focusInputOnClick) {
+            doFocusInputOnClick();
+        }
+        if (onClick) {
+            onClick(event);
+        }
+    }
+    return (React.createElement("div", __assign({}, rest, { className: classes, ref: ref, tabIndex: -1, onClick: handleOnClick, onFocus: focusInput, onBlur: blurInput }), children));
+});
+Object.assign(SpsFormComponentWrapper, {
+    spsFormComponentWrapperPropTypes: spsFormComponentWrapperPropTypes,
+    displayName: "SpsFormComponentWrapper",
+});
+//# sourceMappingURL=SpsFormComponentWrapper.js.map

package/dist/out-tsc/form/SpsFormComponentWrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpsFormComponentWrapper.js","sourceRoot":"","sources":["../../../src/form/SpsFormComponentWrapper.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,SAAS,MAAM,eAAe,CAAC;AAG3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,IAAM,gCAAgC,yBACjC,SAAS,CAAC,kBAAkB,KAC/B,iBAAiB,EAAE,SAAS,CAAC,IAAI,EACjC,QAAQ,EAAE,SAAS,CAAC,IAAI,EAAwB,EAChD,WAAW,EAAE,SAAS,CAAC,IAAI,EAAuB,EAClD,QAAQ,EAAE,SAAS,CAAC,GAAG,EAA0C,GAClE,CAAC;AAUF,MAAM,CAAC,IAAM,uBAAuB,GACe,KAAK,CAAC,UAAU,CACjE,UAAC,KAAmC,EAAE,GAA2C;IAE7E,IAAA,SAAS,GAQP,KAAK,UARE,EACT,QAAQ,GAON,KAAK,SAPC,EACR,iBAAiB,GAMf,KAAK,kBANU,EACjB,WAAW,GAKT,KAAK,YALI,EACX,QAAQ,GAIN,KAAK,SAJC,EACE,YAAY,GAGpB,KAAK,SAHe,EACtB,OAAO,GAEL,KAAK,QAFA,EACJ,IAAI,UACL,KAAK,EATH,gGASL,CADQ,CACC;IAEV,IAAM,WAAW,GAAG,KAAK,CAAC,MAAM,EAAkB,CAAC;IACnD,IAAM,OAAO,GAAG,GAAG,IAAI,WAAW,CAAC;IACnC,IAAM,QAAQ,GAAG,YAAY,IAAI,OAAO,CAAC;IAEzC,SAAS,mBAAmB;QAC1B,IAAI,QAAQ,IAAI,QAAQ,KAAK,GAAG,IAAI,QAAQ,CAAC,OAAO,EAAE;YACpD,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;SAC1B;IACH,CAAC;IAED,SAAS,UAAU;QACjB,IAAI,QAAQ,IAAI,QAAQ,KAAK,GAAG,IAAI,QAAQ,CAAC,OAAO,EAAE;YACpD,IAAI,QAAQ,IAAI,QAAQ,YAAY,gBAAgB,EAAE;gBACpD,QAAQ,CAAC,aAAa,EAAE,CAAC;aAC1B;SACF;IACH,CAAC;IAED,SAAS,SAAS;QAChB,IAAI,QAAQ,IAAI,QAAQ,KAAK,GAAG,IAAI,QAAQ,CAAC,OAAO,EAAE;YACpD,IAAI,QAAQ,IAAI,QAAQ,YAAY,gBAAgB,EAAE;gBACpD,QAAQ,CAAC,aAAa,EAAE,CAAC;aAC1B;SACF;IACH,CAAC;IAED,IAAM,OAAO,GAAG,IAAI,CAClB,gBAAgB,EAChB,CACE,CAAC,WAAW,IAAI,WAAW,CAAC,UAAU,EAAE,CAAC;WAC9B,CAAC,QAAQ,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAC/C,IAAI,0BAA0B,EAC/B,CACE,CAAC,WAAW,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;WAC5B,CAAC,QAAQ,IAAI,QAAQ,CAAC,iBAAiB,EAAE,CAAC,CACtD,IAAI,uBAAuB,EAC5B,CACE,CAAC,QAAQ,IAAI,QAAQ,CAAC,qBAAqB,EAAE,CAAC,CAC/C,IAAI,oCAAoC,EACzC,SAAS,CACV,CAAC;IAEF,SAAS,aAAa,CAAC,KAAK;QAC1B,IAAI,iBAAiB,EAAE;YACrB,mBAAmB,EAAE,CAAC;SACvB;QAED,IAAI,OAAO,EAAE;YACX,OAAO,CAAC,KAAK,CAAC,CAAC;SAChB;IACH,CAAC;IAED,OAAO,CACL,wCACM,IAAI,IACR,SAAS,EAAE,OAAO,EAClB,GAAG,EAAE,GAAG,EACR,QAAQ,EAAE,CAAC,CAAC,EACZ,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,SAAS,KAEhB,QAAQ,CACL,CACP,CAAC;AACJ,CAAC,CACF,CAAC;AAEF,MAAM,CAAC,MAAM,CAAC,uBAAuB,EAAE;IACrC,gCAAgC,kCAAA;IAChC,WAAW,EAAE,yBAAyB;CACvC,CAAC,CAAC"}

package/dist/out-tsc/form/hooks/SpsAbstractControl.interface.d.ts

@@ -0,0 +1,24 @@
+import type { SpsValidator, SpsValidationErrors } from "../validation/types";
+export interface SpsAbstractControlConfig<T> {
+    validators?: Array<SpsValidator<T>>;
+}
+export interface SpsAbstractControl<T> extends SpsAbstractControlConfig<T> {
+    _type: string;
+    errors: SpsValidationErrors | null;
+    invalid: boolean;
+    setInitValue: (newValue: T) => any;
+    getValue: () => T;
+    setValue: (newValue: T) => any;
+    isValid: () => boolean;
+    hasError: (errorKey: string) => boolean;
+    isFocused: () => boolean;
+    focus: () => any;
+    blur: () => any;
+    onFocus?: () => any;
+    onBlur?: () => any;
+    isPristine: () => boolean;
+    markAsPristine: () => any;
+    markAsDirty: () => any;
+    reset: (value?: T) => any;
+    update: () => any;
+}

package/dist/out-tsc/form/hooks/SpsAbstractControl.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=SpsAbstractControl.interface.js.map

package/dist/out-tsc/form/hooks/SpsAbstractControl.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpsAbstractControl.interface.js","sourceRoot":"","sources":["../../../../src/form/hooks/SpsAbstractControl.interface.ts"],"names":[],"mappings":""}

package/dist/out-tsc/form/hooks/SpsControlSet.interface.d.ts

@@ -0,0 +1,7 @@
+import type { SpsAbstractControl } from "./SpsAbstractControl.interface";
+export interface SpsControlSet extends SpsAbstractControl<any> {
+    members: any;
+    get: <T extends SpsAbstractControl<any>>(path: PropertyKey | PropertyKey[]) => T;
+    update: () => any;
+}
+export declare function getMember<T extends SpsAbstractControl<any>>(controlSet: SpsControlSet, path: PropertyKey | PropertyKey[]): T;

package/dist/out-tsc/form/hooks/SpsControlSet.interface.js

@@ -0,0 +1,24 @@
+var __read = (this && this.__read) || function (o, n) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator];
+    if (!m) return o;
+    var i = m.call(o), r, ar = [], e;
+    try {
+        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+    }
+    catch (error) { e = { error: error }; }
+    finally {
+        try {
+            if (r && !r.done && (m = i["return"])) m.call(i);
+        }
+        finally { if (e) throw e.error; }
+    }
+    return ar;
+};
+import { crumblePath } from "@spscommerce/utils";
+export function getMember(controlSet, path) {
+    var _a = __read(crumblePath(path)), name = _a[0], rest = _a.slice(1);
+    return rest.length
+        ? controlSet.members[name].get(rest)
+        : controlSet.members[name];
+}
+//# sourceMappingURL=SpsControlSet.interface.js.map

package/dist/out-tsc/form/hooks/SpsControlSet.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpsControlSet.interface.js","sourceRoot":"","sources":["../../../../src/form/hooks/SpsControlSet.interface.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AASjD,MAAM,UAAU,SAAS,CACvB,UAAyB,EACzB,IAAiC;IAE3B,IAAA,KAAA,OAAkB,WAAW,CAAC,IAAI,CAAC,CAAA,EAAlC,IAAI,QAAA,EAAK,IAAI,cAAqB,CAAC;IAC1C,OAAO,IAAI,CAAC,MAAM;QAChB,CAAC,CAAE,UAAU,CAAC,OAAO,CAAC,IAAI,CAAmB,CAAC,GAAG,CAAI,IAAI,CAAC;QAC1D,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC"}

package/dist/out-tsc/form/hooks/formArray.d.ts

@@ -0,0 +1,12 @@
+import type { SpsAbstractControl, SpsAbstractControlConfig } from "./SpsAbstractControl.interface";
+import type { SpsControlSet } from "./SpsControlSet.interface";
+export interface SpsFormArray<T> extends SpsControlSet {
+    members: Array<SpsAbstractControl<T>>;
+    length: number;
+    at: (index: number) => SpsAbstractControl<T>;
+    push: (control: SpsAbstractControl<T>) => any;
+    insert: (index: number, control: SpsAbstractControl<T>) => any;
+    removeAt: (index: number) => any;
+    setControl: (index: number, control: SpsAbstractControl<T>) => any;
+}
+export declare function formArray<T>(members?: Array<SpsAbstractControl<T>>, config?: SpsAbstractControlConfig<T>): SpsFormArray<T>;