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