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

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