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