@abgov/react-components 6.11.0 → 7.0.0-dev.10

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 (134) hide show
  1. package/index.d.ts +5 -0
  2. package/index.js +3736 -1776
  3. package/index.js.map +1 -1
  4. package/index.mjs +3676 -1716
  5. package/index.mjs.map +1 -1
  6. package/lib/accordion/accordion.d.ts +13 -2
  7. package/lib/app-header/app-header.d.ts +14 -2
  8. package/lib/app-header-menu/app-header-menu.d.ts +14 -7
  9. package/lib/badge/badge.d.ts +32 -18
  10. package/lib/block/block.d.ts +9 -0
  11. package/lib/button/button.d.ts +37 -0
  12. package/lib/button-group/button-group.d.ts +5 -0
  13. package/lib/calendar/calendar.d.ts +25 -1
  14. package/lib/callout/callout.d.ts +31 -2
  15. package/lib/card/card-actions.d.ts +2 -0
  16. package/lib/card/card-content.d.ts +2 -0
  17. package/lib/card/card-group.d.ts +2 -0
  18. package/lib/card/card-image.d.ts +3 -0
  19. package/lib/card/card.d.ts +5 -0
  20. package/lib/checkbox/checkbox.d.ts +49 -3
  21. package/lib/checkbox-list/checkbox-list.d.ts +21 -8
  22. package/lib/chip/chip.d.ts +11 -2
  23. package/lib/circular-progress/circular-progress.d.ts +7 -0
  24. package/lib/container/container.d.ts +18 -5
  25. package/lib/data-grid/data-grid.d.ts +6 -1
  26. package/lib/date-picker/date-picker.d.ts +35 -4
  27. package/lib/details/details.d.ts +7 -1
  28. package/lib/divider/divider.d.ts +2 -0
  29. package/lib/drawer/drawer.d.ts +27 -2
  30. package/lib/dropdown/dropdown-item.d.ts +23 -0
  31. package/lib/dropdown/dropdown.d.ts +56 -5
  32. package/lib/file-upload-card/file-upload-card.d.ts +27 -0
  33. package/lib/file-upload-input/file-upload-input.d.ts +23 -1
  34. package/lib/filter-chip/filter-chip.d.ts +31 -3
  35. package/lib/footer/footer.d.ts +20 -3
  36. package/lib/footer-meta-section/footer-meta-section.d.ts +13 -0
  37. package/lib/footer-nav-section/footer-nav-section.d.ts +18 -1
  38. package/lib/form/fieldset.d.ts +7 -1
  39. package/lib/form/public-form-page.d.ts +13 -5
  40. package/lib/form/public-form-summary.d.ts +2 -0
  41. package/lib/form/public-form.d.ts +8 -1
  42. package/lib/form/public-subform-index.d.ts +7 -1
  43. package/lib/form/public-subform.d.ts +8 -1
  44. package/lib/form/task-list.d.ts +4 -1
  45. package/lib/form/task.d.ts +4 -1
  46. package/lib/form-item/form-item.d.ts +37 -8
  47. package/lib/form-step/form-step.d.ts +3 -0
  48. package/lib/form-stepper/form-stepper.d.ts +5 -0
  49. package/lib/grid/grid.d.ts +6 -1
  50. package/lib/hero-banner/hero-banner-actions.d.ts +2 -0
  51. package/lib/hero-banner/hero-banner.d.ts +9 -0
  52. package/lib/icon/icon.d.ts +13 -0
  53. package/lib/icon-button/icon-button.d.ts +18 -2
  54. package/lib/input/input.d.ts +89 -4
  55. package/lib/linear-progress/linear-progress.d.ts +6 -0
  56. package/lib/link/link.d.ts +33 -4
  57. package/lib/menu-button/menu-action.d.ts +5 -0
  58. package/lib/menu-button/menu-button.d.ts +20 -52
  59. package/lib/microsite-header/microsite-header.d.ts +9 -0
  60. package/lib/modal/modal.d.ts +34 -1
  61. package/lib/notification/notification.d.ts +30 -2
  62. package/lib/one-column-layout/one-column-layout.d.ts +2 -0
  63. package/lib/page-block/page-block.d.ts +4 -0
  64. package/lib/pages/pages.d.ts +3 -0
  65. package/lib/pagination/pagination.d.ts +25 -2
  66. package/lib/popover/popover.d.ts +11 -5
  67. package/lib/push-drawer/push-drawer.d.ts +17 -8
  68. package/lib/radio-group/radio-group.d.ts +36 -2
  69. package/lib/radio-group/radio.d.ts +38 -1
  70. package/lib/side-menu/side-menu.d.ts +16 -2
  71. package/lib/side-menu-group/side-menu-group.d.ts +19 -1
  72. package/lib/side-menu-heading/side-menu-heading.d.ts +19 -2
  73. package/lib/skeleton/skeleton.d.ts +7 -1
  74. package/lib/spacer/spacer.d.ts +4 -0
  75. package/lib/spinner/spinner.d.ts +6 -0
  76. package/lib/tab/tab.d.ts +6 -1
  77. package/lib/table/table-sort-header.d.ts +20 -2
  78. package/lib/table/table.d.ts +31 -2
  79. package/lib/tabs/tabs.d.ts +29 -2
  80. package/lib/temporary-notification-ctrl/temporary-notification-ctrl.d.ts +4 -0
  81. package/lib/text/text.d.ts +8 -1
  82. package/lib/textarea/textarea.d.ts +49 -1
  83. package/lib/three-column-layout/three-column-layout.d.ts +11 -1
  84. package/lib/tooltip/tooltip.d.ts +7 -0
  85. package/lib/two-column-layout/two-column-layout.d.ts +9 -2
  86. package/lib/work-side-menu/work-side-menu.d.ts +47 -0
  87. package/lib/work-side-menu-group/work-side-menu-group.d.ts +30 -0
  88. package/lib/work-side-menu-item/work-side-menu-item.d.ts +44 -0
  89. package/lib/work-side-notification-item/work-side-notification-item.d.ts +40 -0
  90. package/lib/work-side-notification-panel/work-side-notification-panel.d.ts +32 -0
  91. package/package.json +1 -6
  92. package/experimental/badge/badge.d.ts +0 -33
  93. package/experimental/button/button.d.ts +0 -43
  94. package/experimental/calendar/calendar.d.ts +0 -30
  95. package/experimental/callout/callout.d.ts +0 -33
  96. package/experimental/checkbox/checkbox.d.ts +0 -52
  97. package/experimental/date-picker/date-picker.d.ts +0 -43
  98. package/experimental/drawer/drawer.d.ts +0 -31
  99. package/experimental/dropdown/dropdown-item.d.ts +0 -26
  100. package/experimental/dropdown/dropdown.d.ts +0 -62
  101. package/experimental/file-upload-card/file-upload-card.d.ts +0 -32
  102. package/experimental/file-upload-input/file-upload-input.d.ts +0 -27
  103. package/experimental/filter-chip/filter-chip.d.ts +0 -31
  104. package/experimental/footer/footer.d.ts +0 -24
  105. package/experimental/footer-meta-section/footer-meta-section.d.ts +0 -18
  106. package/experimental/footer-nav-section/footer-nav-section.d.ts +0 -22
  107. package/experimental/form-hook.d.ts +0 -8
  108. package/experimental/form-item/form-item.d.ts +0 -46
  109. package/experimental/index.d.ts +0 -32
  110. package/experimental/input/input.d.ts +0 -124
  111. package/experimental/link/link.d.ts +0 -32
  112. package/experimental/modal/modal.d.ts +0 -44
  113. package/experimental/notification/notification.d.ts +0 -31
  114. package/experimental/pagination/pagination.d.ts +0 -29
  115. package/experimental/radio-group/radio-group.d.ts +0 -40
  116. package/experimental/radio-group/radio.d.ts +0 -42
  117. package/experimental/side-menu/side-menu.d.ts +0 -19
  118. package/experimental/side-menu-group/side-menu-group.d.ts +0 -24
  119. package/experimental/side-menu-heading/side-menu-heading.d.ts +0 -23
  120. package/experimental/table/table-sort-header.d.ts +0 -20
  121. package/experimental/table/table.d.ts +0 -30
  122. package/experimental/tabs/tabs.d.ts +0 -27
  123. package/experimental/textarea/textarea.d.ts +0 -53
  124. package/experimental/work-side-menu/work-side-menu.d.ts +0 -34
  125. package/experimental/work-side-menu-group/work-side-menu-group.d.ts +0 -22
  126. package/experimental/work-side-menu-item/work-side-menu-item.d.ts +0 -32
  127. package/experimental.js +0 -1245
  128. package/experimental.js.map +0 -1
  129. package/experimental.mjs +0 -1245
  130. package/experimental.mjs.map +0 -1
  131. package/parseISO-BHUUf1QW.mjs +0 -1693
  132. package/parseISO-BHUUf1QW.mjs.map +0 -1
  133. package/parseISO-Dj57mwuH.js +0 -1692
  134. package/parseISO-Dj57mwuH.js.map +0 -1
@@ -1,20 +1,51 @@
1
1
  import { JSX } from 'react';
2
2
  import { GoabDatePickerInputType, GoabDatePickerOnChangeDetail, Margins, DataAttributes } from '@abgov/ui-components-common';
3
+ interface WCProps extends Margins {
4
+ name?: string;
5
+ value?: string;
6
+ error?: string;
7
+ min?: string;
8
+ max?: string;
9
+ type?: string;
10
+ relative?: string;
11
+ disabled?: string;
12
+ testid?: string;
13
+ width?: string;
14
+ version?: string;
15
+ }
16
+ declare module "react" {
17
+ namespace JSX {
18
+ interface IntrinsicElements {
19
+ "goa-date-picker": WCProps & React.HTMLAttributes<HTMLElement> & {
20
+ ref: React.RefObject<HTMLElement | null>;
21
+ };
22
+ }
23
+ }
24
+ }
3
25
  export interface GoabDatePickerProps extends Margins, DataAttributes {
26
+ /** Sets the date picker type. 'calendar' shows a calendar popup, 'input' shows just a date input. @default "calendar" */
27
+ type?: GoabDatePickerInputType;
28
+ /** Name of the date field. */
4
29
  name?: string;
30
+ /** Value of the calendar date, as a Date object or an ISO date string (yyyy-mm-dd). */
5
31
  value?: Date | string | undefined;
32
+ /** Sets the input to an error state. */
6
33
  error?: boolean;
34
+ /** Minimum date value allowed. */
7
35
  min?: Date | string;
36
+ /** Maximum date value allowed. */
8
37
  max?: Date | string;
9
- type?: GoabDatePickerInputType;
38
+ /** Sets a data-testid attribute for automated testing. */
10
39
  testId?: string;
11
- /***
12
- * @deprecated This property has no effect and will be removed in a future version
13
- */
40
+ /** @deprecated This property has no effect and will be removed in a future version. */
14
41
  relative?: boolean;
42
+ /** Disables the date picker. */
15
43
  disabled?: boolean;
44
+ /** Sets the width of the date picker input. */
16
45
  width?: string;
46
+ /** Callback fired when the selected date changes. */
17
47
  onChange?: (detail: GoabDatePickerOnChangeDetail) => void;
18
48
  }
49
+ /** Lets users select a date through a calendar without the need to manually type it in a field. */
19
50
  export declare function GoabDatePicker({ value, error, min, max, disabled, relative, onChange, ...rest }: GoabDatePickerProps): JSX.Element;
20
51
  export default GoabDatePicker;
@@ -14,11 +14,17 @@ declare module "react" {
14
14
  }
15
15
  }
16
16
  export interface GoabDetailsProps extends Margins, DataAttributes {
17
+ /** @required The title heading. */
17
18
  heading: string;
19
+ /** @required Content rendered inside the details body. */
20
+ children: ReactNode;
21
+ /** Controls if details is expanded or not. */
18
22
  open?: boolean;
23
+ /** Sets the maximum width of the details. @default "75ch" */
19
24
  maxWidth?: string;
25
+ /** Sets a data-testid attribute for automated testing. */
20
26
  testId?: string;
21
- children: ReactNode;
22
27
  }
28
+ /** Let users reveal more detailed information when they need it. */
23
29
  export declare function GoabDetails({ open, children, ...rest }: GoabDetailsProps): import("react/jsx-runtime").JSX.Element;
24
30
  export default GoabDetails;
@@ -10,7 +10,9 @@ declare module "react" {
10
10
  }
11
11
  }
12
12
  export interface GoabDividerProps extends Margins {
13
+ /** Sets a data-testid attribute for automated testing. */
13
14
  testId?: string;
14
15
  }
16
+ /** Indicate a separation of layout, or to distinguish large chunks of information on a page. */
15
17
  export declare function GoabDivider(props: GoabDividerProps): import("react/jsx-runtime").JSX.Element;
16
18
  export default GoabDivider;
@@ -1,14 +1,39 @@
1
1
  import { ReactNode, JSX } from 'react';
2
2
  import { GoabDrawerPosition, GoabDrawerSize } from '@abgov/ui-components-common';
3
+ interface WCProps {
4
+ position: GoabDrawerPosition;
5
+ open?: boolean;
6
+ heading?: string;
7
+ maxsize?: GoabDrawerSize;
8
+ testid?: string;
9
+ ref: React.RefObject<HTMLElement | null>;
10
+ version?: string;
11
+ }
12
+ declare module "react" {
13
+ namespace JSX {
14
+ interface IntrinsicElements {
15
+ "goa-drawer": WCProps & React.HTMLAttributes<HTMLElement>;
16
+ }
17
+ }
18
+ }
3
19
  export interface GoabDrawerProps {
20
+ /** @required The position of the drawer. */
4
21
  position: GoabDrawerPosition;
22
+ /** @required Content rendered inside the drawer body. */
23
+ children: ReactNode;
24
+ /** @required Callback fired when the drawer requests to be closed. */
25
+ onClose: () => void;
26
+ /** Whether the drawer is open. */
5
27
  open?: boolean;
28
+ /** The heading text displayed at the top of the drawer. Accepts a string or a ReactNode for custom heading content. */
6
29
  heading?: string | ReactNode;
30
+ /** Sets max height on bottom position, sets width on left and right position. */
7
31
  maxSize?: GoabDrawerSize;
32
+ /** Sets a data-testid attribute for automated testing. */
8
33
  testId?: string;
34
+ /** Action elements rendered in the drawer footer slot. */
9
35
  actions?: ReactNode;
10
- children: ReactNode;
11
- onClose: () => void;
12
36
  }
37
+ /** A panel that slides in from the side of the screen to display additional content or actions without navigating away from the current view. */
13
38
  export declare function GoabDrawer({ position, open, heading, maxSize, testId, actions, children, onClose, }: GoabDrawerProps): JSX.Element;
14
39
  export default GoabDrawer;
@@ -1,11 +1,34 @@
1
1
  import { GoabDropdownItemMountType } from '@abgov/ui-components-common';
2
+ interface WCProps {
3
+ value: string;
4
+ label?: string;
5
+ filter?: string;
6
+ mount?: GoabDropdownItemMountType;
7
+ name?: string;
8
+ }
9
+ declare module "react" {
10
+ namespace JSX {
11
+ interface IntrinsicElements {
12
+ "goa-dropdown-item": WCProps & React.HTMLAttributes<HTMLElement>;
13
+ }
14
+ }
15
+ }
2
16
  export interface GoabDropdownItemProps {
17
+ /** @required The value submitted when this item is selected. */
3
18
  value: string;
19
+ /** Display label for the dropdown item. */
4
20
  label?: string;
21
+ /** Text used to filter and match this item in typeahead search. */
5
22
  filter?: string;
23
+ /** Sets a data-testid attribute for automated testing. */
6
24
  testId?: string;
25
+ /** Controls how the item is registered with the parent dropdown. */
7
26
  mountType?: GoabDropdownItemMountType;
27
+ /** @deprecated */
8
28
  name?: string;
9
29
  }
30
+ /** Present a list of options to the user to select from. */
10
31
  export declare function GoabDropdownOption(props: GoabDropdownItemProps): import("react/jsx-runtime").JSX.Element;
32
+ /** Present a list of options to the user to select from. */
11
33
  export declare function GoabDropdownItem({ value, label, filter, name, mountType, }: GoabDropdownItemProps): import("react/jsx-runtime").JSX.Element;
34
+ export {};
@@ -1,29 +1,80 @@
1
- import { GoabDropdownOnChangeDetail, GoabIconType, Margins, DataAttributes } from '@abgov/ui-components-common';
1
+ import { GoabDropdownOnChangeDetail, GoabDropdownSize, GoabIconType, Margins, DataAttributes } from '@abgov/ui-components-common';
2
2
  import { JSX } from 'react';
3
+ interface WCProps extends Margins {
4
+ arialabel?: string;
5
+ arialabelledby?: string;
6
+ disabled?: string;
7
+ error?: string;
8
+ filterable?: string;
9
+ leadingicon?: string;
10
+ maxheight?: string;
11
+ multiselect?: string;
12
+ name?: string;
13
+ native?: string;
14
+ placeholder?: string;
15
+ value?: string;
16
+ width?: string;
17
+ maxwidth?: string;
18
+ relative?: string;
19
+ id?: string;
20
+ autocomplete?: string;
21
+ testid?: string;
22
+ size?: GoabDropdownSize;
23
+ version?: string;
24
+ }
25
+ declare module "react" {
26
+ namespace JSX {
27
+ interface IntrinsicElements {
28
+ "goa-dropdown": WCProps & React.HTMLAttributes<HTMLElement> & {
29
+ ref: React.RefObject<HTMLElement | null>;
30
+ };
31
+ }
32
+ }
33
+ }
3
34
  export interface GoabDropdownProps extends Margins, DataAttributes {
35
+ /** Identifier for the dropdown. Should be unique. */
4
36
  name?: string;
37
+ /** The currently selected value(s) of the dropdown. */
5
38
  value?: string[] | string;
39
+ /** Callback fired when the selected value changes. */
6
40
  onChange?: (detail: GoabDropdownOnChangeDetail) => void;
41
+ /** Defines how the selected value will be translated for the screen reader. If not specified it will fall back to the name. */
7
42
  ariaLabel?: string;
43
+ /** The aria-labelledby attribute identifies the element that labels the dropdown. Normally it is the id of the label. */
8
44
  ariaLabelledBy?: string;
45
+ /** The id attribute for the dropdown element. */
9
46
  id?: string;
47
+ /** Dropdown items rendered inside the dropdown. */
10
48
  children?: React.ReactNode;
49
+ /** Disables the dropdown control. */
11
50
  disabled?: boolean;
51
+ /** Shows an error state on the dropdown. */
12
52
  error?: boolean;
53
+ /** When true, allows filtering options by typing into the input field. */
13
54
  filterable?: boolean;
55
+ /** Icon shown to the left of the dropdown input. */
14
56
  leadingIcon?: GoabIconType;
57
+ /** Maximum height of the dropdown menu. Non-native only. @default "276px" */
15
58
  maxHeight?: string;
59
+ /** When true, allows multiple items to be selected. */
16
60
  multiselect?: boolean;
61
+ /** When true, renders the native select HTML element. */
17
62
  native?: boolean;
63
+ /** The text displayed in the dropdown before a selection is made. Non-native only. */
18
64
  placeholder?: string;
65
+ /** Sets a data-testid attribute for automated testing. */
19
66
  testId?: string;
67
+ /** Overrides the autosized menu width. Non-native only. */
20
68
  width?: string;
69
+ /** Sets the maximum width of the dropdown. Use a CSS unit (px, %, ch, rem, em). */
21
70
  maxWidth?: string;
71
+ /** Specifies the autocomplete attribute for the dropdown input. Native only. */
22
72
  autoComplete?: string;
23
- /***
24
- * @deprecated This property has no effect and will be removed in a future version
25
- */
73
+ /** Sets the size of the dropdown. Compact reduces height for dense layouts. */
74
+ size?: GoabDropdownSize;
75
+ /** @deprecated This property has no effect and will be removed in a future version. */
26
76
  relative?: boolean;
27
77
  }
28
- export declare function GoabDropdown({ value, onChange, disabled, error, filterable, multiselect, native, relative, children, ...rest }: GoabDropdownProps): JSX.Element;
78
+ /** Present a list of options to the user to select from. */
79
+ export declare function GoabDropdown({ value, onChange, disabled, error, filterable, multiselect, native, relative, children, size, ...rest }: GoabDropdownProps): JSX.Element;
29
80
  export default GoabDropdown;
@@ -1,13 +1,40 @@
1
1
  import { DataAttributes, GoabFileUploadOnCancelDetail, GoabFileUploadOnDeleteDetail } from '@abgov/ui-components-common';
2
+ interface WCProps {
3
+ filename: string;
4
+ size: number;
5
+ type?: string;
6
+ progress?: number;
7
+ error?: string;
8
+ testid?: string;
9
+ version?: string;
10
+ }
11
+ declare module "react" {
12
+ namespace JSX {
13
+ interface IntrinsicElements {
14
+ "goa-file-upload-card": WCProps & React.HTMLAttributes<HTMLElement> & {
15
+ ref: React.RefObject<HTMLElement | null>;
16
+ };
17
+ }
18
+ }
19
+ }
2
20
  export interface GoabFileUploadCardProps extends DataAttributes {
21
+ /** @required The name of the uploaded file to display. */
3
22
  filename: string;
23
+ /** @required The file size in bytes. Displayed in a human-readable format (KB, MB). */
4
24
  size: number;
25
+ /** The MIME type of the file. Used to determine the file type icon. */
5
26
  type?: string;
27
+ /** Upload progress percentage from 0-100. Use -1 to indicate upload is complete. @default -1 */
6
28
  progress?: number;
29
+ /** Sets a data-testid attribute for automated testing. */
7
30
  testId?: string;
31
+ /** Error message to display. When set, the card shows an error state with a cancel button. */
8
32
  error?: string;
33
+ /** Callback fired when the user clicks the remove button on an uploaded file. */
9
34
  onDelete?: (detail: GoabFileUploadOnDeleteDetail) => void;
35
+ /** Callback fired when the user clicks the cancel button during file upload. */
10
36
  onCancel?: (detail: GoabFileUploadOnCancelDetail) => void;
11
37
  }
38
+ /** Display uploaded file with actions. */
12
39
  export declare function GoabFileUploadCard({ onDelete, onCancel, filename, ...rest }: GoabFileUploadCardProps): import("react/jsx-runtime").JSX.Element;
13
40
  export default GoabFileUploadCard;
@@ -1,10 +1,32 @@
1
1
  import { DataAttributes, GoabFileUploadInputOnSelectFileDetail, GoabFileUploadInputVariant } from '@abgov/ui-components-common';
2
+ interface WCProps {
3
+ variant?: GoabFileUploadInputVariant;
4
+ accept?: string;
5
+ maxfilesize?: string;
6
+ testid?: string;
7
+ version?: string;
8
+ }
9
+ declare module "react" {
10
+ namespace JSX {
11
+ interface IntrinsicElements {
12
+ "goa-file-upload-input": WCProps & React.HTMLAttributes<HTMLElement> & {
13
+ ref: React.RefObject<HTMLElement | null>;
14
+ };
15
+ }
16
+ }
17
+ }
2
18
  export interface GoabFileUploadInputProps extends DataAttributes {
19
+ /** @required Callback fired when a valid file is selected or dropped. */
20
+ onSelectFile: (detail: GoabFileUploadInputOnSelectFileDetail) => void;
21
+ /** The input display variant. "dragdrop" shows a drag-and-drop area, "button" shows a simple button. @default "dragdrop" */
3
22
  variant?: GoabFileUploadInputVariant;
23
+ /** Accepted file types as a comma-separated list of MIME types or file extensions (e.g., "image/*,.pdf"). */
4
24
  accept?: string;
25
+ /** Maximum file size with unit (e.g., "5MB", "100KB", "1GB"). Files exceeding this will be rejected. @default "5MB" */
5
26
  maxFileSize?: string;
27
+ /** Sets a data-testid attribute for automated testing. */
6
28
  testId?: string;
7
- onSelectFile: (detail: GoabFileUploadInputOnSelectFileDetail) => void;
8
29
  }
30
+ /** Help users select and upload a file. */
9
31
  export declare function GoabFileUploadInput({ onSelectFile, ...rest }: GoabFileUploadInputProps): import("react/jsx-runtime").JSX.Element;
10
32
  export default GoabFileUploadInput;
@@ -1,10 +1,38 @@
1
- import { DataAttributes, GoabFilterChipTheme, Margins } from '@abgov/ui-components-common';
1
+ import { DataAttributes, GoabFilterChipTheme, GoabIconType, Margins } from '@abgov/ui-components-common';
2
+ interface WCProps extends Margins {
3
+ icontheme: GoabFilterChipTheme;
4
+ error?: string;
5
+ content: string;
6
+ secondarytext?: string;
7
+ leadingicon?: GoabIconType;
8
+ testid?: string;
9
+ version?: string;
10
+ }
11
+ declare module "react" {
12
+ namespace JSX {
13
+ interface IntrinsicElements {
14
+ "goa-filter-chip": WCProps & React.HTMLAttributes<HTMLElement> & {
15
+ ref: React.RefObject<HTMLElement | null>;
16
+ };
17
+ }
18
+ }
19
+ }
2
20
  export interface GoabFilterChipProps extends Margins, DataAttributes {
3
- onClick?: () => void;
21
+ /** @required Text label of the chip. */
22
+ content: string;
23
+ /** Theme style of the leading icon. @default "outline" */
4
24
  iconTheme?: GoabFilterChipTheme;
25
+ /** Shows an error state. */
5
26
  error?: boolean;
6
- content: string;
27
+ /** Secondary text displayed in a smaller size before the main content. */
28
+ secondaryText?: string;
29
+ /** Icon displayed at the start of the chip. */
30
+ leadingIcon?: GoabIconType;
31
+ /** Sets a data-testid attribute for automated testing. */
7
32
  testId?: string;
33
+ /** Callback fired when the filter chip is clicked to remove it. */
34
+ onClick?: () => void;
8
35
  }
36
+ /** Allow the user to enter information, filter content, and make selections. */
9
37
  export declare const GoabFilterChip: ({ iconTheme, error, onClick, ...rest }: GoabFilterChipProps) => import("react/jsx-runtime").JSX.Element;
10
38
  export default GoabFilterChip;
@@ -1,11 +1,28 @@
1
1
  import { ReactNode, JSX } from 'react';
2
2
  import { DataAttributes } from '@abgov/ui-components-common';
3
+ interface WCProps {
4
+ maxcontentwidth?: string;
5
+ testid?: string;
6
+ url?: string;
7
+ version?: string;
8
+ }
9
+ declare module "react" {
10
+ namespace JSX {
11
+ interface IntrinsicElements {
12
+ "goa-app-footer": WCProps & React.HTMLAttributes<HTMLElement>;
13
+ }
14
+ }
15
+ }
3
16
  export interface GoabAppFooterProps extends DataAttributes {
17
+ /** The maximum width of the main content area. */
4
18
  maxContentWidth?: string;
5
- children?: ReactNode;
6
- testId?: string;
19
+ /** URL for the Government of Alberta logo link. Set to empty string to disable the link. @default "https://alberta.ca" */
7
20
  url?: string;
21
+ /** Sets a data-testid attribute for automated testing. */
22
+ testId?: string;
23
+ /** Content rendered inside the footer, typically navigation and meta sections. */
24
+ children?: ReactNode;
8
25
  }
9
- export type FooterProps = GoabAppFooterProps;
26
+ /** Provides information related your service at the bottom of every page. */
10
27
  export declare function GoabAppFooter({ children, ...rest }: GoabAppFooterProps): JSX.Element;
11
28
  export default GoabAppFooter;
@@ -1,8 +1,21 @@
1
1
  import { ReactNode } from 'react';
2
2
  import { DataAttributes } from '@abgov/ui-components-common';
3
+ interface WCProps {
4
+ testid?: string;
5
+ }
6
+ declare module "react" {
7
+ namespace JSX {
8
+ interface IntrinsicElements {
9
+ "goa-app-footer-meta-section": WCProps & React.HTMLAttributes<HTMLElement>;
10
+ }
11
+ }
12
+ }
3
13
  export interface GoabAppFooterMetaSectionProps extends DataAttributes {
14
+ /** Sets a data-testid attribute for automated testing. */
4
15
  testId?: string;
16
+ /** Anchor link elements rendered as footer meta navigation links. */
5
17
  children?: ReactNode;
6
18
  }
19
+ /** Copyright and legal links in footer. */
7
20
  export declare function GoabAppFooterMetaSection({ children, ...rest }: GoabAppFooterMetaSectionProps): import("react/jsx-runtime").JSX.Element;
8
21
  export default GoabAppFooterMetaSection;
@@ -1,10 +1,27 @@
1
1
  import { ReactNode } from 'react';
2
2
  import { DataAttributes } from '@abgov/ui-components-common';
3
+ interface WCProps {
4
+ maxcolumncount?: number;
5
+ heading?: string;
6
+ testid?: string;
7
+ }
8
+ declare module "react" {
9
+ namespace JSX {
10
+ interface IntrinsicElements {
11
+ "goa-app-footer-nav-section": WCProps & React.HTMLAttributes<HTMLElement>;
12
+ }
13
+ }
14
+ }
3
15
  export interface GoabFooterNavSectionProps extends DataAttributes {
4
- maxColumnCount?: number;
16
+ /** The section heading displayed above the navigation links. */
5
17
  heading?: string;
18
+ /** Maximum number of columns to display links in on larger screens. @default 1 */
19
+ maxColumnCount?: number;
20
+ /** Sets a data-testid attribute for automated testing. */
6
21
  testId?: string;
22
+ /** Anchor link elements rendered as footer navigation links. */
7
23
  children?: ReactNode;
8
24
  }
25
+ /** Navigation links section in footer. */
9
26
  export declare function GoabAppFooterNavSection({ children, ...rest }: GoabFooterNavSectionProps): import("react/jsx-runtime").JSX.Element;
10
27
  export default GoabAppFooterNavSection;
@@ -15,11 +15,17 @@ declare module "react" {
15
15
  }
16
16
  }
17
17
  interface GoabFieldsetProps extends DataAttributes {
18
+ /** Content rendered inside the fieldset. */
19
+ children: ReactNode;
20
+ /** Sets the unique identifier for the fieldset. */
18
21
  id?: string;
22
+ /** Sets the section title of the fieldset. */
19
23
  sectionTitle?: string;
24
+ /** Sets when form field changes are dispatched to the form. @default "continue" */
20
25
  dispatchOn?: GoabFormDispatchOn;
26
+ /** Callback fired when the fieldset continue action is triggered. */
21
27
  onContinue?: (event: GoabFieldsetOnContinueDetail) => void;
22
- children: ReactNode;
23
28
  }
29
+ /** Container for form inputs and validation. */
24
30
  export declare function GoabFieldset({ onContinue, children, ...rest }: GoabFieldsetProps): JSX.Element;
25
31
  export default GoabFieldset;
@@ -21,21 +21,29 @@ declare module "react" {
21
21
  }
22
22
  }
23
23
  interface GoabPublicFormPageProps extends Margins, DataAttributes {
24
+ /** Content rendered inside the form page. */
25
+ children: ReactNode;
26
+ /** Sets the unique identifier for the form page. */
24
27
  id?: string;
28
+ /** Sets the heading text displayed at the top of the form page. */
25
29
  heading?: string;
30
+ /** Sets the subheading text displayed below the main heading. */
26
31
  subHeading?: string;
32
+ /** Sets the heading text used when this page appears in the form summary. */
27
33
  summaryHeading?: string;
34
+ /** Sets the section title displayed above the heading. */
28
35
  sectionTitle?: string;
36
+ /** Sets the URL for the back navigation link. */
29
37
  backUrl?: string;
38
+ /** Sets the type of the form page. @default "step" */
30
39
  type?: GoabPublicFormPageStep;
40
+ /** Sets the text label for the continue or confirm button. */
31
41
  buttonText?: string;
42
+ /** Sets the visibility of the continue button. @default "visible" */
32
43
  buttonVisibility?: GoabPublicFormPageButtonVisibility;
33
- /**
34
- * Triggered when the form page continues to the next step
35
- * @param event - The continue event details
36
- */
44
+ /** Callback fired when the form page continues to the next step. */
37
45
  onContinue?: (event: Event) => void;
38
- children: ReactNode;
39
46
  }
47
+ /** Container for form inputs and validation. */
40
48
  export declare function GoabPublicFormPage({ onContinue, children, ...rest }: GoabPublicFormPageProps): import("react/jsx-runtime").JSX.Element;
41
49
  export default GoabPublicFormPage;
@@ -10,7 +10,9 @@ declare module "react" {
10
10
  }
11
11
  }
12
12
  interface GoabPublicFormSummaryProps extends DataAttributes {
13
+ /** Sets the heading text displayed above the form summary content. */
13
14
  heading?: string;
14
15
  }
16
+ /** Container for form inputs and validation. */
15
17
  export declare function GoabPublicFormSummary({ heading, ...rest }: GoabPublicFormSummaryProps): import("react/jsx-runtime").JSX.Element;
16
18
  export default GoabPublicFormSummary;
@@ -14,12 +14,19 @@ declare module "react" {
14
14
  }
15
15
  }
16
16
  interface GoabPublicFormProps extends DataAttributes {
17
+ /** Content rendered inside the public form. */
18
+ children: ReactNode;
19
+ /** The initialization status of the form. Set to "initializing" while loading external state, then "complete" when ready. @default "complete" */
17
20
  status?: GoabPublicFormStatus;
21
+ /** A name identifier for the form. Useful for debugging complex forms with multiple nested forms. */
18
22
  name?: string;
23
+ /** Callback fired when the form is initialized. */
19
24
  onInit?: (event: Event) => void;
25
+ /** Callback fired when the form is completed. */
20
26
  onComplete?: (event: GoabFormState) => void;
27
+ /** Callback fired when the form state changes. */
21
28
  onStateChange?: (event: GoabFormState) => void;
22
- children: ReactNode;
23
29
  }
30
+ /** Container for form inputs and validation. */
24
31
  export declare function GoabPublicForm({ onInit, onComplete, onStateChange, children, ...rest }: GoabPublicFormProps): import("react/jsx-runtime").JSX.Element;
25
32
  export default GoabPublicForm;
@@ -14,11 +14,17 @@ declare module "react" {
14
14
  }
15
15
  }
16
16
  interface GoabPublicSubformIndexProps extends Margins, DataAttributes {
17
+ /** Content rendered inside the subform index. */
18
+ children: ReactNode;
19
+ /** Sets the heading text displayed at the top of the subform index page. */
17
20
  heading?: string;
21
+ /** Sets the section title displayed above the heading. */
18
22
  sectionTitle?: string;
23
+ /** Sets the text label for the action button that adds a new subform entry. */
19
24
  actionButtonText?: string;
25
+ /** Sets the visibility of the action button. @default "hidden" */
20
26
  buttonVisibility?: "visible" | "hidden";
21
- children: ReactNode;
22
27
  }
28
+ /** Container for form inputs and validation. */
23
29
  export declare function GoabPublicSubformIndex({ heading, sectionTitle, actionButtonText, buttonVisibility, children, ...rest }: GoabPublicSubformIndexProps): import("react/jsx-runtime").JSX.Element;
24
30
  export default GoabPublicSubformIndex;
@@ -15,12 +15,19 @@ declare module "react" {
15
15
  }
16
16
  }
17
17
  interface GoabPublicSubformProps extends Margins, DataAttributes {
18
+ /** Content rendered inside the subform. */
19
+ children: ReactNode;
20
+ /** Sets the unique identifier for the subform. */
18
21
  id?: string;
22
+ /** Sets the name identifier for the subform. */
19
23
  name?: string;
24
+ /** Sets the message displayed on the continue button. */
20
25
  continueMsg?: string;
26
+ /** Callback fired when the subform is initialized. */
21
27
  onInit?: (event: Event) => void;
28
+ /** Callback fired when the subform state changes. */
22
29
  onStateChange?: (event: Event) => void;
23
- children: ReactNode;
24
30
  }
31
+ /** Container for form inputs and validation. */
25
32
  export declare function GoabPublicSubform({ id, name, continueMsg, onInit, onStateChange, children, ...rest }: GoabPublicSubformProps): import("react/jsx-runtime").JSX.Element;
26
33
  export default GoabPublicSubform;
@@ -11,8 +11,11 @@ declare module "react" {
11
11
  }
12
12
  }
13
13
  interface GoabPublicFormTaskListProps extends Margins, DataAttributes {
14
- heading?: string;
14
+ /** Content rendered inside the task list, typically GoabPublicFormTask items. */
15
15
  children: ReactNode;
16
+ /** Sets the heading text displayed above the task list. */
17
+ heading?: string;
16
18
  }
19
+ /** Container for form inputs and validation. */
17
20
  export declare function GoabPublicFormTaskList({ children, ...rest }: GoabPublicFormTaskListProps): import("react/jsx-runtime").JSX.Element;
18
21
  export default GoabPublicFormTaskList;
@@ -11,8 +11,11 @@ declare module "react" {
11
11
  }
12
12
  }
13
13
  interface GoabPublicFormTaskProps extends DataAttributes {
14
- status?: GoabPublicFormTaskStatus;
14
+ /** Content rendered inside the task item, typically the task name or description. */
15
15
  children: ReactNode;
16
+ /** Sets the status of the task, which determines the badge displayed. @default "cannot-start" */
17
+ status?: GoabPublicFormTaskStatus;
16
18
  }
19
+ /** Container for form inputs and validation. */
17
20
  export declare function GoabPublicFormTask({ status, children, ...rest }: GoabPublicFormTaskProps): import("react/jsx-runtime").JSX.Element;
18
21
  export default GoabPublicFormTask;