@atlaskit/form 10.3.0 → 10.4.0

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 (53) hide show
  1. package/CHANGELOG.md +20 -1
  2. package/README.md +2 -1
  3. package/__perf__/default.tsx +46 -57
  4. package/dist/cjs/field.js +3 -1
  5. package/dist/cjs/fieldset.js +6 -1
  6. package/dist/cjs/form-footer.js +7 -2
  7. package/dist/cjs/form-header.js +6 -1
  8. package/dist/cjs/form-section.js +5 -0
  9. package/dist/cjs/label.js +11 -2
  10. package/dist/cjs/messages.js +5 -0
  11. package/dist/cjs/required-asterisk.js +4 -0
  12. package/dist/es2019/field.js +5 -0
  13. package/dist/es2019/fieldset.js +5 -1
  14. package/dist/es2019/form-footer.js +6 -2
  15. package/dist/es2019/form-header.js +5 -1
  16. package/dist/es2019/form-section.js +4 -0
  17. package/dist/es2019/label.js +10 -2
  18. package/dist/es2019/messages.js +4 -0
  19. package/dist/es2019/required-asterisk.js +4 -0
  20. package/dist/esm/field.js +5 -0
  21. package/dist/esm/fieldset.js +5 -1
  22. package/dist/esm/form-footer.js +6 -2
  23. package/dist/esm/form-header.js +5 -1
  24. package/dist/esm/form-section.js +4 -0
  25. package/dist/esm/label.js +10 -2
  26. package/dist/esm/messages.js +4 -0
  27. package/dist/esm/required-asterisk.js +4 -0
  28. package/dist/types/field.d.ts +3 -0
  29. package/dist/types/fieldset.d.ts +3 -0
  30. package/dist/types/form-footer.d.ts +4 -1
  31. package/dist/types/form-header.d.ts +3 -0
  32. package/dist/types/form-section.d.ts +3 -0
  33. package/dist/types/label.d.ts +3 -0
  34. package/dist/types/messages.d.ts +3 -0
  35. package/dist/types/required-asterisk.d.ts +3 -0
  36. package/dist/types-ts4.5/field.d.ts +3 -0
  37. package/dist/types-ts4.5/fieldset.d.ts +3 -0
  38. package/dist/types-ts4.5/form-footer.d.ts +4 -1
  39. package/dist/types-ts4.5/form-header.d.ts +3 -0
  40. package/dist/types-ts4.5/form-section.d.ts +3 -0
  41. package/dist/types-ts4.5/label.d.ts +3 -0
  42. package/dist/types-ts4.5/messages.d.ts +3 -0
  43. package/dist/types-ts4.5/required-asterisk.d.ts +3 -0
  44. package/extract-react-types/checkbox-field-props.tsx +1 -1
  45. package/extract-react-types/field-props.tsx +1 -1
  46. package/extract-react-types/fieldset-props.tsx +1 -1
  47. package/extract-react-types/form-footer-props.tsx +1 -1
  48. package/extract-react-types/form-header-props.tsx +1 -1
  49. package/extract-react-types/form-props.tsx +1 -1
  50. package/extract-react-types/form-section-props.tsx +1 -1
  51. package/extract-react-types/range-field-props.tsx +1 -1
  52. package/package.json +133 -133
  53. package/report.api.md +144 -181
package/report.api.md CHANGED
@@ -2,7 +2,8 @@
2
2
 
3
3
  ## API Report File for "@atlaskit/form"
4
4
 
5
- > Do not edit this file. This report is auto-generated using [API Extractor](https://api-extractor.com/).
5
+ > Do not edit this file. This report is auto-generated using
6
+ > [API Extractor](https://api-extractor.com/).
6
7
  > [Learn more about API reports](https://hello.atlassian.net/wiki/spaces/UR/pages/1825484529/Package+API+Reports)
7
8
 
8
9
  ### Table of contents
@@ -31,94 +32,82 @@ export const CheckboxField: FC<CheckboxProps>;
31
32
 
32
33
  // @public (undocumented)
33
34
  export interface CheckboxFieldProps extends FieldProps<string | undefined> {
34
- // (undocumented)
35
- isChecked: boolean;
35
+ // (undocumented)
36
+ isChecked: boolean;
36
37
  }
37
38
 
38
39
  // @public (undocumented)
39
40
  interface CheckboxProps {
40
- children: (args: {
41
- fieldProps: CheckboxFieldProps;
42
- error?: string;
43
- valid: boolean;
44
- meta: Meta;
45
- }) => ReactNode;
46
- defaultIsChecked?: boolean;
47
- isDisabled?: boolean;
48
- isRequired?: boolean;
49
- label?: ReactNode;
50
- name: string;
51
- value?: string;
41
+ children: (args: {
42
+ fieldProps: CheckboxFieldProps;
43
+ error?: string;
44
+ valid: boolean;
45
+ meta: Meta;
46
+ }) => ReactNode;
47
+ defaultIsChecked?: boolean;
48
+ isDisabled?: boolean;
49
+ isRequired?: boolean;
50
+ label?: ReactNode;
51
+ name: string;
52
+ value?: string;
52
53
  }
53
54
 
54
55
  // @public
55
- export const ErrorMessage: ({
56
- children,
57
- testId,
58
- }: MessageProps) => jsx.JSX.Element;
56
+ export const ErrorMessage: ({ children, testId }: MessageProps) => jsx.JSX.Element;
59
57
 
60
58
  // @public (undocumented)
61
- export function Field<
62
- FieldValue = string,
63
- Element extends SupportedElements = HTMLInputElement,
64
- >(props: FieldComponentProps<FieldValue, Element>): jsx.JSX.Element;
59
+ export function Field<FieldValue = string, Element extends SupportedElements = HTMLInputElement>(
60
+ props: FieldComponentProps<FieldValue, Element>,
61
+ ): jsx.JSX.Element;
65
62
 
66
63
  // @public (undocumented)
67
64
  interface FieldComponentProps<FieldValue, Element extends SupportedElements> {
68
- children: (args: {
69
- fieldProps: FieldProps<FieldValue, Element>;
70
- error?: string;
71
- valid: boolean;
72
- meta: Meta;
73
- }) => ReactNode;
74
- defaultValue?:
75
- | ((currentDefaultValue?: FieldValue) => FieldValue)
76
- | FieldValue;
77
- elementAfterLabel?: ReactNode;
78
- id?: string;
79
- isDisabled?: boolean;
80
- isRequired?: boolean;
81
- label?: ReactNode;
82
- name: string;
83
- testId?: string;
84
- transform?: (
85
- event: FieldValue | FormEvent<Element>,
86
- current: FieldValue,
87
- ) => FieldValue;
88
- validate?: (
89
- value: FieldValue | undefined,
90
- formState: Object,
91
- fieldState: Meta,
92
- ) => Promise<string | void> | string | void;
65
+ children: (args: {
66
+ fieldProps: FieldProps<FieldValue, Element>;
67
+ error?: string;
68
+ valid: boolean;
69
+ meta: Meta;
70
+ }) => ReactNode;
71
+ defaultValue?: ((currentDefaultValue?: FieldValue) => FieldValue) | FieldValue;
72
+ elementAfterLabel?: ReactNode;
73
+ id?: string;
74
+ isDisabled?: boolean;
75
+ isRequired?: boolean;
76
+ label?: ReactNode;
77
+ name: string;
78
+ testId?: string;
79
+ transform?: (event: FieldValue | FormEvent<Element>, current: FieldValue) => FieldValue;
80
+ validate?: (
81
+ value: FieldValue | undefined,
82
+ formState: Object,
83
+ fieldState: Meta,
84
+ ) => Promise<string | void> | string | void;
93
85
  }
94
86
 
95
87
  // @public (undocumented)
96
- export interface FieldProps<
97
- FieldValue,
98
- Element extends SupportedElements = HTMLInputElement,
99
- > {
100
- // (undocumented)
101
- 'aria-invalid': 'false' | 'true';
102
- // (undocumented)
103
- 'aria-labelledby': string;
104
- // (undocumented)
105
- id: string;
106
- // (undocumented)
107
- isDisabled: boolean;
108
- // (undocumented)
109
- isInvalid: boolean;
110
- // (undocumented)
111
- isRequired: boolean;
112
- // (undocumented)
113
- name: string;
114
- // (undocumented)
115
- onBlur: () => void;
116
- // (undocumented)
117
- onChange: (value: FieldValue | FormEvent<Element>) => void;
118
- // (undocumented)
119
- onFocus: () => void;
120
- // (undocumented)
121
- value: FieldValue;
88
+ export interface FieldProps<FieldValue, Element extends SupportedElements = HTMLInputElement> {
89
+ // (undocumented)
90
+ 'aria-invalid': 'false' | 'true';
91
+ // (undocumented)
92
+ 'aria-labelledby': string;
93
+ // (undocumented)
94
+ id: string;
95
+ // (undocumented)
96
+ isDisabled: boolean;
97
+ // (undocumented)
98
+ isInvalid: boolean;
99
+ // (undocumented)
100
+ isRequired: boolean;
101
+ // (undocumented)
102
+ name: string;
103
+ // (undocumented)
104
+ onBlur: () => void;
105
+ // (undocumented)
106
+ onChange: (value: FieldValue | FormEvent<Element>) => void;
107
+ // (undocumented)
108
+ onFocus: () => void;
109
+ // (undocumented)
110
+ value: FieldValue;
122
111
  }
123
112
 
124
113
  // @public
@@ -126,13 +115,13 @@ export const Fieldset: ({ children, legend }: FieldsetProps) => jsx.JSX.Element;
126
115
 
127
116
  // @public (undocumented)
128
117
  interface FieldsetProps {
129
- children: ReactNode;
130
- legend?: ReactNode;
118
+ children: ReactNode;
119
+ legend?: ReactNode;
131
120
  }
132
121
 
133
122
  // @public (undocumented)
134
123
  function Form<FormValues extends Record<string, any> = {}>(
135
- props: FormProps<FormValues>,
124
+ props: FormProps<FormValues>,
136
125
  ): JSX.Element;
137
126
  export default Form;
138
127
 
@@ -141,87 +130,71 @@ export type FormApi<FormData> = FormApi_2<FormData>;
141
130
 
142
131
  // @public (undocumented)
143
132
  interface FormChildrenProps {
144
- // (undocumented)
145
- onKeyDown: (event: React_2.KeyboardEvent<HTMLElement>) => void;
146
- // (undocumented)
147
- onSubmit: (
148
- event?:
149
- | React_2.FormEvent<HTMLFormElement>
150
- | React_2.SyntheticEvent<HTMLElement>,
151
- ) => void;
152
- // (undocumented)
153
- ref: React_2.RefObject<HTMLFormElement>;
133
+ // (undocumented)
134
+ onKeyDown: (event: React_2.KeyboardEvent<HTMLElement>) => void;
135
+ // (undocumented)
136
+ onSubmit: (
137
+ event?: React_2.FormEvent<HTMLFormElement> | React_2.SyntheticEvent<HTMLElement>,
138
+ ) => void;
139
+ // (undocumented)
140
+ ref: React_2.RefObject<HTMLFormElement>;
154
141
  }
155
142
 
156
143
  // @public
157
- export function FormFooter({
158
- align,
159
- children,
160
- }: FormFooterProps): jsx.JSX.Element;
144
+ export function FormFooter({ align, children }: FormFooterProps): jsx.JSX.Element;
161
145
 
162
146
  // @public (undocumented)
163
147
  interface FormFooterProps {
164
- align?: Align;
165
- children?: ReactNode;
148
+ align?: Align;
149
+ children?: ReactNode;
166
150
  }
167
151
 
168
152
  // @public
169
- export const FormHeader: ({
170
- children,
171
- description,
172
- title,
173
- }: FormHeaderProps) => jsx.JSX.Element;
153
+ export const FormHeader: ({ children, description, title }: FormHeaderProps) => jsx.JSX.Element;
174
154
 
175
155
  // @public (undocumented)
176
156
  interface FormHeaderProps {
177
- children?: ReactNode;
178
- description?: ReactNode;
179
- title?: ReactNode;
157
+ children?: ReactNode;
158
+ description?: ReactNode;
159
+ title?: ReactNode;
180
160
  }
181
161
 
182
162
  // @public (undocumented)
183
163
  export interface FormProps<FormValues> {
184
- children: (args: {
185
- formProps: FormChildrenProps;
186
- disabled: boolean;
187
- dirty: boolean;
188
- submitting: boolean;
189
- getState: () => FormState<FormValues>;
190
- getValues: () => FormValues;
191
- setFieldValue: (name: string, value: any) => void;
192
- reset: (initialValues?: FormValues) => void;
193
- }) => ReactNode;
194
- isDisabled?: boolean;
195
- onSubmit: OnSubmitHandler<FormValues>;
164
+ children: (args: {
165
+ formProps: FormChildrenProps;
166
+ disabled: boolean;
167
+ dirty: boolean;
168
+ submitting: boolean;
169
+ getState: () => FormState<FormValues>;
170
+ getValues: () => FormValues;
171
+ setFieldValue: (name: string, value: any) => void;
172
+ reset: (initialValues?: FormValues) => void;
173
+ }) => ReactNode;
174
+ isDisabled?: boolean;
175
+ onSubmit: OnSubmitHandler<FormValues>;
196
176
  }
197
177
 
198
178
  // @public
199
- export const FormSection: ({
200
- children,
201
- description,
202
- title,
203
- }: FormSectionProps) => jsx.JSX.Element;
179
+ export const FormSection: ({ children, description, title }: FormSectionProps) => jsx.JSX.Element;
204
180
 
205
181
  // @public (undocumented)
206
182
  interface FormSectionProps {
207
- children?: ReactNode;
208
- description?: ReactNode;
209
- title?: ReactNode;
183
+ children?: ReactNode;
184
+ description?: ReactNode;
185
+ title?: ReactNode;
210
186
  }
211
187
 
212
188
  // @public
213
- export const HelperMessage: ({
214
- children,
215
- testId,
216
- }: MessageProps) => jsx.JSX.Element;
189
+ export const HelperMessage: ({ children, testId }: MessageProps) => jsx.JSX.Element;
217
190
 
218
191
  // @public
219
192
  interface InternalMessageProps {
220
- appearance?: MessageAppearance;
221
- children: ReactNode;
222
- // (undocumented)
223
- fieldId?: string;
224
- testId?: string;
193
+ appearance?: MessageAppearance;
194
+ children: ReactNode;
195
+ // (undocumented)
196
+ fieldId?: string;
197
+ testId?: string;
225
198
  }
226
199
 
227
200
  // @public
@@ -229,14 +202,14 @@ export const Label: FC<LabelProps>;
229
202
 
230
203
  // @public (undocumented)
231
204
  export interface LabelProps {
232
- // (undocumented)
233
- children: ReactNode;
234
- // (undocumented)
235
- htmlFor: string;
236
- // (undocumented)
237
- id?: string;
238
- // (undocumented)
239
- testId?: string;
205
+ // (undocumented)
206
+ children: ReactNode;
207
+ // (undocumented)
208
+ htmlFor: string;
209
+ // (undocumented)
210
+ id?: string;
211
+ // (undocumented)
212
+ testId?: string;
240
213
  }
241
214
 
242
215
  // @public
@@ -244,8 +217,8 @@ export const Legend: FC<LegendProps>;
244
217
 
245
218
  // @public (undocumented)
246
219
  export interface LegendProps {
247
- // (undocumented)
248
- children: ReactNode;
220
+ // (undocumented)
221
+ children: ReactNode;
249
222
  }
250
223
 
251
224
  // @public (undocumented)
@@ -256,31 +229,31 @@ type MessageProps = Pick<InternalMessageProps, 'children' | 'testId'>;
256
229
 
257
230
  // @public (undocumented)
258
231
  interface Meta {
259
- // (undocumented)
260
- dirty: boolean;
261
- // (undocumented)
262
- dirtySinceLastSubmit: boolean;
263
- // (undocumented)
264
- error?: string;
265
- // (undocumented)
266
- submitError?: boolean;
267
- // (undocumented)
268
- submitFailed: boolean;
269
- // (undocumented)
270
- submitting: boolean;
271
- // (undocumented)
272
- touched: boolean;
273
- // (undocumented)
274
- valid: boolean;
275
- // (undocumented)
276
- validating?: boolean;
232
+ // (undocumented)
233
+ dirty: boolean;
234
+ // (undocumented)
235
+ dirtySinceLastSubmit: boolean;
236
+ // (undocumented)
237
+ error?: string;
238
+ // (undocumented)
239
+ submitError?: boolean;
240
+ // (undocumented)
241
+ submitFailed: boolean;
242
+ // (undocumented)
243
+ submitting: boolean;
244
+ // (undocumented)
245
+ touched: boolean;
246
+ // (undocumented)
247
+ valid: boolean;
248
+ // (undocumented)
249
+ validating?: boolean;
277
250
  }
278
251
 
279
252
  // @public (undocumented)
280
253
  export type OnSubmitHandler<FormData> = (
281
- values: FormData,
282
- form: FormApi<FormData>,
283
- callback?: (errors?: Record<string, string>) => void,
254
+ values: FormData,
255
+ form: FormApi<FormData>,
256
+ callback?: (errors?: Record<string, string>) => void,
284
257
  ) => Object | Promise<Object | void> | void;
285
258
 
286
259
  // @public
@@ -288,17 +261,13 @@ export const RangeField: FC<RangeFieldProps>;
288
261
 
289
262
  // @public (undocumented)
290
263
  export interface RangeFieldProps {
291
- // (undocumented)
292
- children: (args: {
293
- fieldProps: RangeProps;
294
- error?: string;
295
- meta: Meta;
296
- }) => React_2.ReactNode;
297
- defaultValue: ((currentDefaultValue?: number) => number) | number;
298
- id?: string;
299
- isDisabled?: boolean;
300
- label?: ReactNode;
301
- name: string;
264
+ // (undocumented)
265
+ children: (args: { fieldProps: RangeProps; error?: string; meta: Meta }) => React_2.ReactNode;
266
+ defaultValue: ((currentDefaultValue?: number) => number) | number;
267
+ id?: string;
268
+ isDisabled?: boolean;
269
+ label?: ReactNode;
270
+ name: string;
302
271
  }
303
272
 
304
273
  // @public (undocumented)
@@ -308,16 +277,10 @@ type RangeProps = Omit<FieldProps<number>, 'isInvalid' | 'isRequired'>;
308
277
  export function RequiredAsterisk(): jsx.JSX.Element;
309
278
 
310
279
  // @public (undocumented)
311
- type SupportedElements =
312
- | HTMLInputElement
313
- | HTMLSelectElement
314
- | HTMLTextAreaElement;
280
+ type SupportedElements = HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement;
315
281
 
316
282
  // @public
317
- export const ValidMessage: ({
318
- children,
319
- testId,
320
- }: MessageProps) => jsx.JSX.Element;
283
+ export const ValidMessage: ({ children, testId }: MessageProps) => jsx.JSX.Element;
321
284
 
322
285
  // (No @packageDocumentation comment for this package)
323
286
  ```
@@ -330,7 +293,7 @@ export const ValidMessage: ({
330
293
 
331
294
  ```json
332
295
  {
333
- "react": "^16.8.0"
296
+ "react": "^16.8.0"
334
297
  }
335
298
  ```
336
299