@xqmsg/ui-core 0.23.1-rc.1 → 0.23.1-rc.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (193) hide show
  1. package/CHANGELOG.md +456 -0
  2. package/LICENSE +20 -20
  3. package/README.md +40 -40
  4. package/dist/{89793640b494d7ea.svg → 78c9d6fd7766410f.svg} +9 -9
  5. package/dist/components/input/index.d.ts +2 -1
  6. package/dist/ui-core.cjs.development.js +5 -3
  7. package/dist/ui-core.cjs.development.js.map +1 -1
  8. package/dist/ui-core.cjs.production.min.js +1 -1
  9. package/dist/ui-core.cjs.production.min.js.map +1 -1
  10. package/dist/ui-core.esm.js +5 -3
  11. package/dist/ui-core.esm.js.map +1 -1
  12. package/package.json +118 -118
  13. package/src/components/banner/Banner.stories.tsx +100 -100
  14. package/src/components/banner/index.tsx +73 -73
  15. package/src/components/breadcrumbs/Breadcrumbs.stories.tsx +66 -66
  16. package/src/components/breadcrumbs/components/icon/index.tsx +38 -38
  17. package/src/components/breadcrumbs/components/label/index.tsx +20 -20
  18. package/src/components/breadcrumbs/index.tsx +48 -48
  19. package/src/components/button/Button.stories.tsx +140 -140
  20. package/src/components/button/google/GoogleButton.stories.tsx +23 -23
  21. package/src/components/button/google/index.tsx +29 -29
  22. package/src/components/button/index.tsx +51 -51
  23. package/src/components/button/microsoft/MicrosoftButton.stories.tsx +25 -25
  24. package/src/components/button/microsoft/index.tsx +29 -29
  25. package/src/components/button/spinner/SpinnerButton.stories.tsx +60 -60
  26. package/src/components/button/spinner/index.tsx +36 -36
  27. package/src/components/card/Card.stories.tsx +56 -56
  28. package/src/components/card/index.tsx +78 -78
  29. package/src/components/form/Form.stories.tsx +62 -62
  30. package/src/components/form/FormTypes.ts +20 -20
  31. package/src/components/form/hooks/useFormHandler.tsx +74 -74
  32. package/src/components/form/index.tsx +25 -25
  33. package/src/components/form/section/FormSection.stories.tsx +109 -109
  34. package/src/components/form/section/index.tsx +87 -87
  35. package/src/components/form/utils/formErrors.ts +34 -34
  36. package/src/components/icons/checkmark/checkmark.svg +3 -3
  37. package/src/components/icons/checkmark/index.tsx +13 -13
  38. package/src/components/icons/chevron/down/chevron-down.svg +3 -3
  39. package/src/components/icons/chevron/down/index.tsx +14 -14
  40. package/src/components/icons/chevron/right/chevron-right.svg +3 -3
  41. package/src/components/icons/chevron/right/index.tsx +13 -13
  42. package/src/components/icons/clock/clock.svg +3 -3
  43. package/src/components/icons/clock/index.tsx +13 -13
  44. package/src/components/icons/close/close.svg +3 -3
  45. package/src/components/icons/close/index.tsx +21 -21
  46. package/src/components/icons/dropdown/dropdown.svg +3 -3
  47. package/src/components/icons/dropdown/index.tsx +16 -16
  48. package/src/components/icons/error/error.svg +3 -3
  49. package/src/components/icons/error/index.tsx +13 -13
  50. package/src/components/icons/file/fill/file-fill.svg +4 -4
  51. package/src/components/icons/file/fill/index.tsx +13 -13
  52. package/src/components/icons/file/outline/file-outline.svg +3 -3
  53. package/src/components/icons/file/outline/index.tsx +13 -13
  54. package/src/components/icons/folder/add/fill/folder-add-fill.svg +3 -3
  55. package/src/components/icons/folder/add/fill/index.tsx +13 -13
  56. package/src/components/icons/folder/add/outline/folder-add-outline.svg +3 -3
  57. package/src/components/icons/folder/add/outline/index.tsx +15 -15
  58. package/src/components/icons/folder/fill/folder-fill-gradient.svg +33 -33
  59. package/src/components/icons/folder/fill/folder-fill.svg +4 -4
  60. package/src/components/icons/folder/fill/index.tsx +21 -21
  61. package/src/components/icons/folder/outline/folder-outline.svg +3 -3
  62. package/src/components/icons/folder/outline/index.tsx +13 -13
  63. package/src/components/icons/gear/GearIcon.tsx +36 -36
  64. package/src/components/icons/google/drive/index.tsx +13 -13
  65. package/src/components/icons/google/google.svg +13 -13
  66. package/src/components/icons/google/index.tsx +13 -13
  67. package/src/components/icons/group/group.svg +3 -3
  68. package/src/components/icons/group/index.tsx +13 -13
  69. package/src/components/icons/home/home.svg +3 -3
  70. package/src/components/icons/home/index.tsx +13 -13
  71. package/src/components/icons/image/image.svg +3 -3
  72. package/src/components/icons/image/index.tsx +13 -13
  73. package/src/components/icons/index.tsx +101 -101
  74. package/src/components/icons/link/index.tsx +13 -13
  75. package/src/components/icons/link/link.svg +4 -4
  76. package/src/components/icons/menu/index.tsx +13 -13
  77. package/src/components/icons/menu/menu.svg +3 -3
  78. package/src/components/icons/microsoft/index.tsx +13 -13
  79. package/src/components/icons/microsoft/microsoft.svg +9 -9
  80. package/src/components/icons/microsoft/onedrive/index.tsx +16 -16
  81. package/src/components/icons/neutral/index.tsx +14 -14
  82. package/src/components/icons/neutral/neutral.svg +3 -3
  83. package/src/components/icons/page/index.tsx +13 -13
  84. package/src/components/icons/page/page.svg +3 -3
  85. package/src/components/icons/positive/index.tsx +13 -13
  86. package/src/components/icons/positive/positive.svg +3 -3
  87. package/src/components/icons/question/index.tsx +13 -13
  88. package/src/components/icons/question/question.svg +3 -3
  89. package/src/components/icons/search/index.tsx +13 -13
  90. package/src/components/icons/search/search.svg +3 -3
  91. package/src/components/icons/services/index.tsx +13 -13
  92. package/src/components/icons/services/services.svg +3 -3
  93. package/src/components/icons/settings/index.tsx +14 -14
  94. package/src/components/icons/settings/settings.svg +6 -6
  95. package/src/components/icons/table/fill/index.tsx +13 -13
  96. package/src/components/icons/table/fill/table-fill.svg +3 -3
  97. package/src/components/icons/table/outline/index.tsx +13 -13
  98. package/src/components/icons/table/outline/table-outline.svg +3 -3
  99. package/src/components/icons/task/index.tsx +10 -10
  100. package/src/components/icons/task/task.svg +11 -11
  101. package/src/components/icons/trash/index.tsx +13 -13
  102. package/src/components/icons/trash/trash.svg +3 -3
  103. package/src/components/icons/vault/index.tsx +14 -14
  104. package/src/components/icons/video/index.tsx +13 -13
  105. package/src/components/icons/video/video.svg +3 -3
  106. package/src/components/icons/warning/index.tsx +13 -13
  107. package/src/components/icons/warning/warning.svg +3 -3
  108. package/src/components/icons/workspace/index.tsx +14 -14
  109. package/src/components/input/Input.stories.tsx +287 -287
  110. package/src/components/input/InputTypes.ts +77 -77
  111. package/src/components/input/StackedCheckbox/StackedCheckbox.tsx +44 -44
  112. package/src/components/input/StackedInput/StackedInput.tsx +60 -60
  113. package/src/components/input/StackedMultiSelect/index.tsx +349 -349
  114. package/src/components/input/StackedPilledInput/index.tsx +375 -386
  115. package/src/components/input/StackedRadio/StackedRadioGroup.tsx +38 -38
  116. package/src/components/input/StackedSelect/index.tsx +232 -232
  117. package/src/components/input/StackedSwitch/index.tsx +33 -33
  118. package/src/components/input/StackedTextarea/StackedTextarea.tsx +55 -55
  119. package/src/components/input/components/dropdown/index.tsx +111 -111
  120. package/src/components/input/components/label/index.tsx +35 -35
  121. package/src/components/input/components/token/Token.stories.tsx +25 -25
  122. package/src/components/input/components/token/index.tsx +45 -45
  123. package/src/components/input/index.tsx +301 -298
  124. package/src/components/layout/BorderedBox/index.tsx +30 -30
  125. package/src/components/layout/Layout.stories.tsx +40 -40
  126. package/src/components/layout/index.tsx +100 -100
  127. package/src/components/link/Link.stories.tsx +23 -23
  128. package/src/components/link/index.tsx +34 -34
  129. package/src/components/loading/LoadingIndicator.stories.tsx +45 -45
  130. package/src/components/loading/index.tsx +45 -45
  131. package/src/components/modal/Modal.stories.tsx +36 -36
  132. package/src/components/modal/components/action/index.tsx +37 -37
  133. package/src/components/modal/index.tsx +41 -41
  134. package/src/components/navigation/NavigationMenu.stories.tsx +85 -85
  135. package/src/components/navigation/components/header/index.tsx +27 -27
  136. package/src/components/navigation/components/items/index.tsx +76 -76
  137. package/src/components/navigation/index.tsx +87 -87
  138. package/src/components/select/index.tsx +140 -140
  139. package/src/components/table/Table.stories.tsx +63 -63
  140. package/src/components/table/TableTypes.ts +15 -15
  141. package/src/components/table/components/loading/index.tsx +45 -45
  142. package/src/components/table/components/text/index.tsx +23 -23
  143. package/src/components/table/empty/index.tsx +47 -47
  144. package/src/components/table/index.tsx +84 -84
  145. package/src/components/table/utils/generateTableColumns.ts +9 -9
  146. package/src/components/tabs/TabsWrapper.stories.tsx +85 -85
  147. package/src/components/tabs/index.tsx +39 -39
  148. package/src/components/text/Text.stories.tsx +59 -59
  149. package/src/components/text/index.tsx +16 -16
  150. package/src/components/toast/Toast.stories.tsx +52 -52
  151. package/src/components/toast/index.tsx +78 -78
  152. package/src/components/toolbar/Toolbar.stories.tsx +59 -59
  153. package/src/components/toolbar/components/actions/add/index.tsx +18 -18
  154. package/src/components/toolbar/components/actions/search/index.tsx +38 -38
  155. package/src/components/toolbar/components/actions/sort/index.tsx +49 -49
  156. package/src/components/toolbar/components/breadcrumbs/index.tsx +63 -63
  157. package/src/components/toolbar/components/breadcrumbs/item/index.tsx +72 -72
  158. package/src/components/toolbar/components/dropdown/index.tsx +107 -107
  159. package/src/components/toolbar/components/navigation/components/button/left/index.tsx +28 -28
  160. package/src/components/toolbar/components/navigation/components/button/left/left-arrow.svg +3 -3
  161. package/src/components/toolbar/components/navigation/components/button/right/index.tsx +27 -27
  162. package/src/components/toolbar/components/navigation/components/button/right/right-arrow.svg +3 -3
  163. package/src/components/toolbar/components/navigation/index.tsx +36 -36
  164. package/src/components/toolbar/index.tsx +55 -55
  165. package/src/hooks/useDeepEffect.tsx +22 -22
  166. package/src/hooks/useDidMountEffect.tsx +13 -13
  167. package/src/hooks/useOnOutsideClick.tsx +31 -31
  168. package/src/hooks/useToast.tsx +16 -16
  169. package/src/index.tsx +78 -78
  170. package/src/theme/components/alert.ts +60 -60
  171. package/src/theme/components/badge.ts +59 -59
  172. package/src/theme/components/button.ts +163 -163
  173. package/src/theme/components/checkbox.ts +28 -28
  174. package/src/theme/components/code.ts +16 -16
  175. package/src/theme/components/form-error.ts +31 -31
  176. package/src/theme/components/form-label.ts +17 -17
  177. package/src/theme/components/form.ts +29 -29
  178. package/src/theme/components/input.ts +65 -65
  179. package/src/theme/components/link.ts +118 -118
  180. package/src/theme/components/modal.ts +45 -45
  181. package/src/theme/components/select.ts +36 -36
  182. package/src/theme/components/switch.ts +89 -89
  183. package/src/theme/components/table.ts +42 -42
  184. package/src/theme/components/tabs.ts +255 -255
  185. package/src/theme/components/text.ts +93 -93
  186. package/src/theme/components/textarea.ts +42 -42
  187. package/src/theme/customXQChakraTheme.ts +54 -54
  188. package/src/theme/foundations/breakpoints.ts +18 -18
  189. package/src/theme/foundations/colors.ts +165 -165
  190. package/src/theme/foundations/shadows.ts +23 -23
  191. package/src/theme/foundations/typography.ts +62 -62
  192. package/src/theme/provider/index.tsx +21 -21
  193. package/src/theme/styles.ts +19 -19
@@ -1,78 +1,78 @@
1
- import React, { Children, ReactNode } from 'react';
2
- import { Box, Flex, Text } from '@chakra-ui/react';
3
- import colors from '../../theme/foundations/colors';
4
- import typography from '../../theme/foundations/typography';
5
- import { Button } from '../button';
6
-
7
- export interface CardProps {
8
- title: string | ReactNode;
9
- leftIcon?: JSX.Element;
10
- children: ReactNode | null;
11
- height?: string | number;
12
- }
13
-
14
- /**
15
- * A functional React component utilized to render the `Card` component
16
- */
17
- export const Card: React.FC<CardProps> = ({
18
- title,
19
- leftIcon,
20
- children,
21
- height = 'auto',
22
- }) => {
23
- return (
24
- <Box
25
- bg={colors.fill.light.quaternary}
26
- borderRadius="4px"
27
- border={`.5px solid ${colors.border.default}`}
28
- py="8px"
29
- px="8px"
30
- height={height}
31
- overflowY="auto"
32
- width="206px"
33
- _notLast={{ marginBottom: '8px' }}
34
- >
35
- {title && (
36
- <Flex
37
- display="flex"
38
- alignItems="center"
39
- justifyContent="start"
40
- textDecoration="none"
41
- _hover={{ textDecoration: 'none' }}
42
- mb="8px"
43
- >
44
- <Flex alignItems="center">
45
- <Box mr="4px">{leftIcon}</Box>
46
- <Text
47
- color={colors.label.primary.light}
48
- fontSize={typography.fontSizes.sm}
49
- fontWeight={typography.fontWeights.medium}
50
- >
51
- {title}
52
- </Text>
53
- </Flex>
54
- </Flex>
55
- )}
56
- {Children.map(children, child => {
57
- if (!React.isValidElement(child)) {
58
- return;
59
- }
60
- if (child.type !== Button) {
61
- return (
62
- <Text
63
- as="div"
64
- _notLast={{ marginBottom: '8px' }}
65
- color={colors.label.primary.light}
66
- fontSize={typography.fontSizes.xs}
67
- fontWeight={typography.fontWeights.normal}
68
- >
69
- {child}
70
- </Text>
71
- );
72
- } else {
73
- return <Box mt="8px">{child}</Box>;
74
- }
75
- })}
76
- </Box>
77
- );
78
- };
1
+ import React, { Children, ReactNode } from 'react';
2
+ import { Box, Flex, Text } from '@chakra-ui/react';
3
+ import colors from '../../theme/foundations/colors';
4
+ import typography from '../../theme/foundations/typography';
5
+ import { Button } from '../button';
6
+
7
+ export interface CardProps {
8
+ title: string | ReactNode;
9
+ leftIcon?: JSX.Element;
10
+ children: ReactNode | null;
11
+ height?: string | number;
12
+ }
13
+
14
+ /**
15
+ * A functional React component utilized to render the `Card` component
16
+ */
17
+ export const Card: React.FC<CardProps> = ({
18
+ title,
19
+ leftIcon,
20
+ children,
21
+ height = 'auto',
22
+ }) => {
23
+ return (
24
+ <Box
25
+ bg={colors.fill.light.quaternary}
26
+ borderRadius="4px"
27
+ border={`.5px solid ${colors.border.default}`}
28
+ py="8px"
29
+ px="8px"
30
+ height={height}
31
+ overflowY="auto"
32
+ width="206px"
33
+ _notLast={{ marginBottom: '8px' }}
34
+ >
35
+ {title && (
36
+ <Flex
37
+ display="flex"
38
+ alignItems="center"
39
+ justifyContent="start"
40
+ textDecoration="none"
41
+ _hover={{ textDecoration: 'none' }}
42
+ mb="8px"
43
+ >
44
+ <Flex alignItems="center">
45
+ <Box mr="4px">{leftIcon}</Box>
46
+ <Text
47
+ color={colors.label.primary.light}
48
+ fontSize={typography.fontSizes.sm}
49
+ fontWeight={typography.fontWeights.medium}
50
+ >
51
+ {title}
52
+ </Text>
53
+ </Flex>
54
+ </Flex>
55
+ )}
56
+ {Children.map(children, child => {
57
+ if (!React.isValidElement(child)) {
58
+ return;
59
+ }
60
+ if (child.type !== Button) {
61
+ return (
62
+ <Text
63
+ as="div"
64
+ _notLast={{ marginBottom: '8px' }}
65
+ color={colors.label.primary.light}
66
+ fontSize={typography.fontSizes.xs}
67
+ fontWeight={typography.fontWeights.normal}
68
+ >
69
+ {child}
70
+ </Text>
71
+ );
72
+ } else {
73
+ return <Box mt="8px">{child}</Box>;
74
+ }
75
+ })}
76
+ </Box>
77
+ );
78
+ };
@@ -1,62 +1,62 @@
1
- import React from 'react';
2
- import { Meta, Story } from '@storybook/react';
3
- import * as Yup from 'yup';
4
-
5
- import { useFormHandler } from '../../../src/components/form/hooks/useFormHandler';
6
- import { Form, FormProps } from '../../../src/components/form';
7
- import { FormSection } from '../../../src/components/form/section';
8
- import { formSectionStoryArgs } from '../../../src/components/form/section/FormSection.stories';
9
- import { FormStructure } from './FormTypes';
10
-
11
- const meta: Meta<FormProps<StoryFormSchema>> = {
12
- title: 'Form example',
13
- component: Form,
14
- argTypes: {},
15
- parameters: {},
16
- };
17
-
18
- interface StoryFormSchema {
19
- prop?: string;
20
- }
21
-
22
- const onStubbedSubmit = () => null;
23
-
24
- const storyFormDefaultValues: StoryFormSchema = {
25
- prop: '',
26
- };
27
-
28
- const storyFormSchema: Yup.SchemaOf<StoryFormSchema> = Yup.object().shape({
29
- prop: Yup.string().required(),
30
- });
31
-
32
- export default meta;
33
- const Template: Story<FormProps<StoryFormSchema>> = () => {
34
- const formHandler = useFormHandler<StoryFormSchema>(
35
- onStubbedSubmit,
36
- storyFormDefaultValues,
37
- storyFormSchema,
38
- false,
39
- 'all'
40
- );
41
-
42
- const { form } = formHandler;
43
-
44
- const section = formSectionStoryArgs.section as 'story';
45
- const formStructure = formSectionStoryArgs.formStructure as FormStructure<
46
- 'story'
47
- >;
48
-
49
- return (
50
- <Form formHandler={formHandler}>
51
- <FormSection
52
- form={form}
53
- formStructure={formStructure}
54
- section={section}
55
- />
56
- </Form>
57
- );
58
- };
59
-
60
- export const Default = Template.bind({});
61
-
62
- Default.args = {};
1
+ import React from 'react';
2
+ import { Meta, Story } from '@storybook/react';
3
+ import * as Yup from 'yup';
4
+
5
+ import { useFormHandler } from '../../../src/components/form/hooks/useFormHandler';
6
+ import { Form, FormProps } from '../../../src/components/form';
7
+ import { FormSection } from '../../../src/components/form/section';
8
+ import { formSectionStoryArgs } from '../../../src/components/form/section/FormSection.stories';
9
+ import { FormStructure } from './FormTypes';
10
+
11
+ const meta: Meta<FormProps<StoryFormSchema>> = {
12
+ title: 'Form example',
13
+ component: Form,
14
+ argTypes: {},
15
+ parameters: {},
16
+ };
17
+
18
+ interface StoryFormSchema {
19
+ prop?: string;
20
+ }
21
+
22
+ const onStubbedSubmit = () => null;
23
+
24
+ const storyFormDefaultValues: StoryFormSchema = {
25
+ prop: '',
26
+ };
27
+
28
+ const storyFormSchema: Yup.SchemaOf<StoryFormSchema> = Yup.object().shape({
29
+ prop: Yup.string().required(),
30
+ });
31
+
32
+ export default meta;
33
+ const Template: Story<FormProps<StoryFormSchema>> = () => {
34
+ const formHandler = useFormHandler<StoryFormSchema>(
35
+ onStubbedSubmit,
36
+ storyFormDefaultValues,
37
+ storyFormSchema,
38
+ false,
39
+ 'all'
40
+ );
41
+
42
+ const { form } = formHandler;
43
+
44
+ const section = formSectionStoryArgs.section as 'story';
45
+ const formStructure = formSectionStoryArgs.formStructure as FormStructure<
46
+ 'story'
47
+ >;
48
+
49
+ return (
50
+ <Form formHandler={formHandler}>
51
+ <FormSection
52
+ form={form}
53
+ formStructure={formStructure}
54
+ section={section}
55
+ />
56
+ </Form>
57
+ );
58
+ };
59
+
60
+ export const Default = Template.bind({});
61
+
62
+ Default.args = {};
@@ -1,20 +1,20 @@
1
- import { FieldOptions, InputType } from '../input/InputTypes';
2
-
3
- export interface FormInput {
4
- label: string;
5
- name: string;
6
- ariaLabel: string;
7
- inputType: InputType;
8
- options?: FieldOptions;
9
- placeholder?: string;
10
- isRequired: boolean;
11
- maxLength?: number;
12
- disabled?: boolean;
13
- defaultValue?: string;
14
- variant?: string;
15
- separators?: string[];
16
- }
17
-
18
- export type FormStructure<K extends string | number | symbol> = {
19
- [key in K]: FormInput[];
20
- };
1
+ import { FieldOptions, InputType } from '../input/InputTypes';
2
+
3
+ export interface FormInput {
4
+ label: string;
5
+ name: string;
6
+ ariaLabel: string;
7
+ inputType: InputType;
8
+ options?: FieldOptions;
9
+ placeholder?: string;
10
+ isRequired: boolean;
11
+ maxLength?: number;
12
+ disabled?: boolean;
13
+ defaultValue?: string;
14
+ variant?: string;
15
+ separators?: string[];
16
+ }
17
+
18
+ export type FormStructure<K extends string | number | symbol> = {
19
+ [key in K]: FormInput[];
20
+ };
@@ -1,74 +1,74 @@
1
- import { FormEvent, useState } from 'react';
2
- import { yupResolver } from '@hookform/resolvers/yup';
3
- import {
4
- DeepPartial,
5
- FieldValues,
6
- useForm,
7
- UseFormReturn,
8
- ValidationMode,
9
- } from 'react-hook-form';
10
-
11
- import * as Yup from 'yup';
12
- import {
13
- ErrorResponse,
14
- formatErrorResponse,
15
- } from '../../../../src/components/form/utils/formErrors';
16
- import useDeepEffect from '../../../../src/hooks/useDeepEffect';
17
-
18
- // Default Yup error message for required fields
19
- Yup.setLocale({
20
- mixed: {
21
- required: 'This field is required.',
22
- },
23
- });
24
-
25
- export type FormHandler<T extends FieldValues> = {
26
- form: UseFormReturn<T, any>;
27
- error?: ErrorResponse;
28
- onSubmit: (e?: FormEvent) => Promise<void>;
29
- };
30
-
31
- export function useFormHandler<T extends FieldValues = Record<string, unknown>>(
32
- handleSubmit: (values: T) => void,
33
- defaultValues: DeepPartial<T>,
34
- schema: Yup.AnyObjectSchema,
35
- dontClearErrorsOnSuccess = false,
36
- mode: keyof ValidationMode
37
- ): FormHandler<T> {
38
- const form = useForm<T>({
39
- defaultValues,
40
- resolver: schema ? yupResolver(schema) : undefined,
41
- mode,
42
- });
43
- const [error, setError] = useState<ErrorResponse | undefined>();
44
-
45
- const onSubmit = form.handleSubmit(async values => {
46
- try {
47
- await handleSubmit(values);
48
-
49
- // Bypassing the error clearing step is useful for whenever the user gets navigated away
50
- // from the screen in the submit handler. By not bothering to clear the errors, we avoid a console error
51
- // from popping up and warning about a memory leak.
52
- if (!dontClearErrorsOnSuccess) {
53
- form.clearErrors();
54
- // eslint-disable-next-line no-throw-literal
55
- setError(undefined);
56
- }
57
- } catch (e) {
58
- if (e instanceof Error) {
59
- setError(formatErrorResponse(e));
60
- }
61
- }
62
- });
63
-
64
- useDeepEffect(() => {
65
- // Reset the form anytime the default values change
66
- form.reset(defaultValues);
67
- }, [defaultValues]);
68
-
69
- return {
70
- onSubmit,
71
- form,
72
- error,
73
- };
74
- }
1
+ import { FormEvent, useState } from 'react';
2
+ import { yupResolver } from '@hookform/resolvers/yup';
3
+ import {
4
+ DeepPartial,
5
+ FieldValues,
6
+ useForm,
7
+ UseFormReturn,
8
+ ValidationMode,
9
+ } from 'react-hook-form';
10
+
11
+ import * as Yup from 'yup';
12
+ import {
13
+ ErrorResponse,
14
+ formatErrorResponse,
15
+ } from '../../../../src/components/form/utils/formErrors';
16
+ import useDeepEffect from '../../../../src/hooks/useDeepEffect';
17
+
18
+ // Default Yup error message for required fields
19
+ Yup.setLocale({
20
+ mixed: {
21
+ required: 'This field is required.',
22
+ },
23
+ });
24
+
25
+ export type FormHandler<T extends FieldValues> = {
26
+ form: UseFormReturn<T, any>;
27
+ error?: ErrorResponse;
28
+ onSubmit: (e?: FormEvent) => Promise<void>;
29
+ };
30
+
31
+ export function useFormHandler<T extends FieldValues = Record<string, unknown>>(
32
+ handleSubmit: (values: T) => void,
33
+ defaultValues: DeepPartial<T>,
34
+ schema: Yup.AnyObjectSchema,
35
+ dontClearErrorsOnSuccess = false,
36
+ mode: keyof ValidationMode
37
+ ): FormHandler<T> {
38
+ const form = useForm<T>({
39
+ defaultValues,
40
+ resolver: schema ? yupResolver(schema) : undefined,
41
+ mode,
42
+ });
43
+ const [error, setError] = useState<ErrorResponse | undefined>();
44
+
45
+ const onSubmit = form.handleSubmit(async values => {
46
+ try {
47
+ await handleSubmit(values);
48
+
49
+ // Bypassing the error clearing step is useful for whenever the user gets navigated away
50
+ // from the screen in the submit handler. By not bothering to clear the errors, we avoid a console error
51
+ // from popping up and warning about a memory leak.
52
+ if (!dontClearErrorsOnSuccess) {
53
+ form.clearErrors();
54
+ // eslint-disable-next-line no-throw-literal
55
+ setError(undefined);
56
+ }
57
+ } catch (e) {
58
+ if (e instanceof Error) {
59
+ setError(formatErrorResponse(e));
60
+ }
61
+ }
62
+ });
63
+
64
+ useDeepEffect(() => {
65
+ // Reset the form anytime the default values change
66
+ form.reset(defaultValues);
67
+ }, [defaultValues]);
68
+
69
+ return {
70
+ onSubmit,
71
+ form,
72
+ error,
73
+ };
74
+ }
@@ -1,25 +1,25 @@
1
- import React, { PropsWithChildren } from 'react';
2
- import { FieldValues, FormProvider } from 'react-hook-form';
3
- import { FormHandler } from '../../components/form/hooks/useFormHandler';
4
-
5
- export interface FormProps<T extends FieldValues> {
6
- formHandler: FormHandler<T>;
7
- }
8
-
9
- /**
10
- * A functional React component utilized to render the `Form` component, a form wrapper for
11
- * `react-hook-form`. The `Form` component is provided a `formHandler` and is used to wrap a container
12
- * that contains a `FormSection` component.
13
- */
14
- export function Form<T extends FieldValues>({
15
- formHandler,
16
- children,
17
- }: PropsWithChildren<FormProps<T>>) {
18
- const { form, onSubmit } = formHandler;
19
-
20
- return (
21
- <FormProvider {...form}>
22
- <form onSubmit={onSubmit}>{children}</form>
23
- </FormProvider>
24
- );
25
- }
1
+ import React, { PropsWithChildren } from 'react';
2
+ import { FieldValues, FormProvider } from 'react-hook-form';
3
+ import { FormHandler } from '../../components/form/hooks/useFormHandler';
4
+
5
+ export interface FormProps<T extends FieldValues> {
6
+ formHandler: FormHandler<T>;
7
+ }
8
+
9
+ /**
10
+ * A functional React component utilized to render the `Form` component, a form wrapper for
11
+ * `react-hook-form`. The `Form` component is provided a `formHandler` and is used to wrap a container
12
+ * that contains a `FormSection` component.
13
+ */
14
+ export function Form<T extends FieldValues>({
15
+ formHandler,
16
+ children,
17
+ }: PropsWithChildren<FormProps<T>>) {
18
+ const { form, onSubmit } = formHandler;
19
+
20
+ return (
21
+ <FormProvider {...form}>
22
+ <form onSubmit={onSubmit}>{children}</form>
23
+ </FormProvider>
24
+ );
25
+ }