@xqmsg/ui-core 0.23.1 → 0.23.2

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 (190) hide show
  1. package/CHANGELOG.md +468 -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 -2
  6. package/dist/ui-core.cjs.development.js.map +1 -1
  7. package/dist/ui-core.cjs.production.min.js.map +1 -1
  8. package/dist/ui-core.esm.js.map +1 -1
  9. package/package.json +118 -118
  10. package/src/components/banner/Banner.stories.tsx +100 -100
  11. package/src/components/banner/index.tsx +73 -73
  12. package/src/components/breadcrumbs/Breadcrumbs.stories.tsx +66 -66
  13. package/src/components/breadcrumbs/components/icon/index.tsx +38 -38
  14. package/src/components/breadcrumbs/components/label/index.tsx +20 -20
  15. package/src/components/breadcrumbs/index.tsx +48 -48
  16. package/src/components/button/Button.stories.tsx +140 -140
  17. package/src/components/button/google/GoogleButton.stories.tsx +23 -23
  18. package/src/components/button/google/index.tsx +29 -29
  19. package/src/components/button/index.tsx +51 -51
  20. package/src/components/button/microsoft/MicrosoftButton.stories.tsx +25 -25
  21. package/src/components/button/microsoft/index.tsx +29 -29
  22. package/src/components/button/spinner/SpinnerButton.stories.tsx +60 -60
  23. package/src/components/button/spinner/index.tsx +36 -36
  24. package/src/components/card/Card.stories.tsx +56 -56
  25. package/src/components/card/index.tsx +78 -78
  26. package/src/components/form/Form.stories.tsx +62 -62
  27. package/src/components/form/FormTypes.ts +20 -20
  28. package/src/components/form/hooks/useFormHandler.tsx +74 -74
  29. package/src/components/form/index.tsx +25 -25
  30. package/src/components/form/section/FormSection.stories.tsx +109 -109
  31. package/src/components/form/section/index.tsx +87 -87
  32. package/src/components/form/utils/formErrors.ts +34 -34
  33. package/src/components/icons/checkmark/checkmark.svg +3 -3
  34. package/src/components/icons/checkmark/index.tsx +13 -13
  35. package/src/components/icons/chevron/down/chevron-down.svg +3 -3
  36. package/src/components/icons/chevron/down/index.tsx +14 -14
  37. package/src/components/icons/chevron/right/chevron-right.svg +3 -3
  38. package/src/components/icons/chevron/right/index.tsx +13 -13
  39. package/src/components/icons/clock/clock.svg +3 -3
  40. package/src/components/icons/clock/index.tsx +13 -13
  41. package/src/components/icons/close/close.svg +3 -3
  42. package/src/components/icons/close/index.tsx +21 -21
  43. package/src/components/icons/dropdown/dropdown.svg +3 -3
  44. package/src/components/icons/dropdown/index.tsx +16 -16
  45. package/src/components/icons/error/error.svg +3 -3
  46. package/src/components/icons/error/index.tsx +13 -13
  47. package/src/components/icons/file/fill/file-fill.svg +4 -4
  48. package/src/components/icons/file/fill/index.tsx +13 -13
  49. package/src/components/icons/file/outline/file-outline.svg +3 -3
  50. package/src/components/icons/file/outline/index.tsx +13 -13
  51. package/src/components/icons/folder/add/fill/folder-add-fill.svg +3 -3
  52. package/src/components/icons/folder/add/fill/index.tsx +13 -13
  53. package/src/components/icons/folder/add/outline/folder-add-outline.svg +3 -3
  54. package/src/components/icons/folder/add/outline/index.tsx +15 -15
  55. package/src/components/icons/folder/fill/folder-fill-gradient.svg +33 -33
  56. package/src/components/icons/folder/fill/folder-fill.svg +4 -4
  57. package/src/components/icons/folder/fill/index.tsx +21 -21
  58. package/src/components/icons/folder/outline/folder-outline.svg +3 -3
  59. package/src/components/icons/folder/outline/index.tsx +13 -13
  60. package/src/components/icons/gear/GearIcon.tsx +36 -36
  61. package/src/components/icons/google/drive/index.tsx +13 -13
  62. package/src/components/icons/google/google.svg +13 -13
  63. package/src/components/icons/google/index.tsx +13 -13
  64. package/src/components/icons/group/group.svg +3 -3
  65. package/src/components/icons/group/index.tsx +13 -13
  66. package/src/components/icons/home/home.svg +3 -3
  67. package/src/components/icons/home/index.tsx +13 -13
  68. package/src/components/icons/image/image.svg +3 -3
  69. package/src/components/icons/image/index.tsx +13 -13
  70. package/src/components/icons/index.tsx +101 -101
  71. package/src/components/icons/link/index.tsx +13 -13
  72. package/src/components/icons/link/link.svg +4 -4
  73. package/src/components/icons/menu/index.tsx +13 -13
  74. package/src/components/icons/menu/menu.svg +3 -3
  75. package/src/components/icons/microsoft/index.tsx +13 -13
  76. package/src/components/icons/microsoft/microsoft.svg +9 -9
  77. package/src/components/icons/microsoft/onedrive/index.tsx +16 -16
  78. package/src/components/icons/neutral/index.tsx +14 -14
  79. package/src/components/icons/neutral/neutral.svg +3 -3
  80. package/src/components/icons/page/index.tsx +13 -13
  81. package/src/components/icons/page/page.svg +3 -3
  82. package/src/components/icons/positive/index.tsx +13 -13
  83. package/src/components/icons/positive/positive.svg +3 -3
  84. package/src/components/icons/question/index.tsx +13 -13
  85. package/src/components/icons/question/question.svg +3 -3
  86. package/src/components/icons/search/index.tsx +13 -13
  87. package/src/components/icons/search/search.svg +3 -3
  88. package/src/components/icons/services/index.tsx +13 -13
  89. package/src/components/icons/services/services.svg +3 -3
  90. package/src/components/icons/settings/index.tsx +14 -14
  91. package/src/components/icons/settings/settings.svg +6 -6
  92. package/src/components/icons/table/fill/index.tsx +13 -13
  93. package/src/components/icons/table/fill/table-fill.svg +3 -3
  94. package/src/components/icons/table/outline/index.tsx +13 -13
  95. package/src/components/icons/table/outline/table-outline.svg +3 -3
  96. package/src/components/icons/task/index.tsx +10 -10
  97. package/src/components/icons/task/task.svg +11 -11
  98. package/src/components/icons/trash/index.tsx +13 -13
  99. package/src/components/icons/trash/trash.svg +3 -3
  100. package/src/components/icons/vault/index.tsx +14 -14
  101. package/src/components/icons/video/index.tsx +13 -13
  102. package/src/components/icons/video/video.svg +3 -3
  103. package/src/components/icons/warning/index.tsx +13 -13
  104. package/src/components/icons/warning/warning.svg +3 -3
  105. package/src/components/icons/workspace/index.tsx +14 -14
  106. package/src/components/input/Input.stories.tsx +287 -287
  107. package/src/components/input/InputTypes.ts +77 -77
  108. package/src/components/input/StackedCheckbox/StackedCheckbox.tsx +44 -44
  109. package/src/components/input/StackedInput/StackedInput.tsx +60 -60
  110. package/src/components/input/StackedMultiSelect/index.tsx +349 -349
  111. package/src/components/input/StackedPilledInput/index.tsx +386 -386
  112. package/src/components/input/StackedRadio/StackedRadioGroup.tsx +38 -38
  113. package/src/components/input/StackedSelect/index.tsx +232 -232
  114. package/src/components/input/StackedSwitch/index.tsx +33 -33
  115. package/src/components/input/StackedTextarea/StackedTextarea.tsx +55 -55
  116. package/src/components/input/components/dropdown/index.tsx +111 -111
  117. package/src/components/input/components/label/index.tsx +35 -35
  118. package/src/components/input/components/token/Token.stories.tsx +25 -25
  119. package/src/components/input/components/token/index.tsx +45 -45
  120. package/src/components/input/index.tsx +298 -298
  121. package/src/components/layout/BorderedBox/index.tsx +30 -30
  122. package/src/components/layout/Layout.stories.tsx +40 -40
  123. package/src/components/layout/index.tsx +100 -100
  124. package/src/components/link/Link.stories.tsx +23 -23
  125. package/src/components/link/index.tsx +34 -34
  126. package/src/components/loading/LoadingIndicator.stories.tsx +45 -45
  127. package/src/components/loading/index.tsx +45 -45
  128. package/src/components/modal/Modal.stories.tsx +36 -36
  129. package/src/components/modal/components/action/index.tsx +37 -37
  130. package/src/components/modal/index.tsx +41 -41
  131. package/src/components/navigation/NavigationMenu.stories.tsx +85 -85
  132. package/src/components/navigation/components/header/index.tsx +27 -27
  133. package/src/components/navigation/components/items/index.tsx +76 -76
  134. package/src/components/navigation/index.tsx +87 -87
  135. package/src/components/select/index.tsx +140 -140
  136. package/src/components/table/Table.stories.tsx +63 -63
  137. package/src/components/table/TableTypes.ts +15 -15
  138. package/src/components/table/components/loading/index.tsx +45 -45
  139. package/src/components/table/components/text/index.tsx +23 -23
  140. package/src/components/table/empty/index.tsx +47 -47
  141. package/src/components/table/index.tsx +84 -84
  142. package/src/components/table/utils/generateTableColumns.ts +9 -9
  143. package/src/components/tabs/TabsWrapper.stories.tsx +85 -85
  144. package/src/components/tabs/index.tsx +39 -39
  145. package/src/components/text/Text.stories.tsx +59 -59
  146. package/src/components/text/index.tsx +16 -16
  147. package/src/components/toast/Toast.stories.tsx +52 -52
  148. package/src/components/toast/index.tsx +78 -78
  149. package/src/components/toolbar/Toolbar.stories.tsx +59 -59
  150. package/src/components/toolbar/components/actions/add/index.tsx +18 -18
  151. package/src/components/toolbar/components/actions/search/index.tsx +38 -38
  152. package/src/components/toolbar/components/actions/sort/index.tsx +49 -49
  153. package/src/components/toolbar/components/breadcrumbs/index.tsx +63 -63
  154. package/src/components/toolbar/components/breadcrumbs/item/index.tsx +72 -72
  155. package/src/components/toolbar/components/dropdown/index.tsx +107 -107
  156. package/src/components/toolbar/components/navigation/components/button/left/index.tsx +28 -28
  157. package/src/components/toolbar/components/navigation/components/button/left/left-arrow.svg +3 -3
  158. package/src/components/toolbar/components/navigation/components/button/right/index.tsx +27 -27
  159. package/src/components/toolbar/components/navigation/components/button/right/right-arrow.svg +3 -3
  160. package/src/components/toolbar/components/navigation/index.tsx +36 -36
  161. package/src/components/toolbar/index.tsx +55 -55
  162. package/src/hooks/useDeepEffect.tsx +22 -22
  163. package/src/hooks/useDidMountEffect.tsx +13 -13
  164. package/src/hooks/useOnOutsideClick.tsx +31 -31
  165. package/src/hooks/useToast.tsx +16 -16
  166. package/src/index.tsx +78 -78
  167. package/src/theme/components/alert.ts +60 -60
  168. package/src/theme/components/badge.ts +59 -59
  169. package/src/theme/components/button.ts +163 -163
  170. package/src/theme/components/checkbox.ts +28 -28
  171. package/src/theme/components/code.ts +16 -16
  172. package/src/theme/components/form-error.ts +31 -31
  173. package/src/theme/components/form-label.ts +17 -17
  174. package/src/theme/components/form.ts +29 -29
  175. package/src/theme/components/input.ts +65 -65
  176. package/src/theme/components/link.ts +118 -118
  177. package/src/theme/components/modal.ts +45 -45
  178. package/src/theme/components/select.ts +36 -36
  179. package/src/theme/components/switch.ts +89 -89
  180. package/src/theme/components/table.ts +42 -42
  181. package/src/theme/components/tabs.ts +255 -255
  182. package/src/theme/components/text.ts +93 -93
  183. package/src/theme/components/textarea.ts +42 -42
  184. package/src/theme/customXQChakraTheme.ts +54 -54
  185. package/src/theme/foundations/breakpoints.ts +18 -18
  186. package/src/theme/foundations/colors.ts +165 -165
  187. package/src/theme/foundations/shadows.ts +23 -23
  188. package/src/theme/foundations/typography.ts +62 -62
  189. package/src/theme/provider/index.tsx +21 -21
  190. 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
+ }