@abgov/angular-components 5.0.0-dev.3 → 5.0.0-dev.4

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.
@@ -61,18 +61,27 @@ declare class AngularComponentsModule {
61
61
  }
62
62
 
63
63
  declare abstract class GoabBaseComponent {
64
+ /** Sets the top margin spacing token. */
64
65
  mt?: Spacing;
66
+ /** Sets the bottom margin spacing token. */
65
67
  mb?: Spacing;
68
+ /** Sets the left margin spacing token. */
66
69
  ml?: Spacing;
70
+ /** Sets the right margin spacing token. */
67
71
  mr?: Spacing;
72
+ /** Sets the data-testid attribute for automated testing. */
68
73
  testId?: string;
69
74
  static ɵfac: i0.ɵɵFactoryDeclaration<GoabBaseComponent, never>;
70
75
  static ɵcmp: i0.ɵɵComponentDeclaration<GoabBaseComponent, "ng-component", never, { "mt": { "alias": "mt"; "required": false; }; "mb": { "alias": "mb"; "required": false; }; "ml": { "alias": "ml"; "required": false; }; "mr": { "alias": "mr"; "required": false; }; "testId": { "alias": "testId"; "required": false; }; }, {}, never, never, true, never>;
71
76
  }
72
77
  declare abstract class GoabControlValueAccessor extends GoabBaseComponent implements ControlValueAccessor {
78
+ /** Sets the id attribute of the underlying web component. */
73
79
  id?: string;
80
+ /** Sets the disabled state for the control. */
74
81
  disabled?: boolean;
82
+ /** Sets the error state for the control. */
75
83
  error?: boolean;
84
+ /** Sets the control value used by Angular forms and one-way binding. */
76
85
  value?: unknown | null | undefined;
77
86
  /**
78
87
  * Function to handle changes in the form control value.
@@ -132,13 +141,21 @@ declare abstract class GoabControlValueAccessor extends GoabBaseComponent implem
132
141
 
133
142
  declare class GoabAccordion extends GoabBaseComponent implements OnInit {
134
143
  private cdr;
144
+ /** Sets the heading text. */
135
145
  heading?: string;
146
+ /** Sets secondary text. */
136
147
  secondaryText?: string;
148
+ /** Sets the state of the accordion container open or closed. */
137
149
  open?: boolean;
150
+ /** Sets the heading size of the accordion container heading. */
138
151
  headingSize?: GoabAccordionHeadingSize;
152
+ /** Sets the heading content template reference. */
139
153
  headingContent: TemplateRef<any>;
154
+ /** Sets the maximum width of the accordion. */
140
155
  maxWidth?: string;
156
+ /** Sets the position of the expand/collapse icon. */
141
157
  iconPosition?: GoabAccordionIconPosition;
158
+ /** Emits when the accordion opens or closes. Emits the new open state as a boolean. */
142
159
  onChange: EventEmitter<boolean>;
143
160
  isReady: boolean;
144
161
  ngOnInit(): void;
@@ -150,12 +167,19 @@ declare class GoabAccordion extends GoabBaseComponent implements OnInit {
150
167
 
151
168
  declare class GoabBadge extends GoabBaseComponent implements OnInit {
152
169
  private cdr;
170
+ /** Sets the context and colour of the badge. */
153
171
  type?: GoabBadgeType;
172
+ /** Sets the text label of the badge. */
154
173
  content?: string;
174
+ /** @deprecated Use icontype instead. Includes an icon in the badge. */
155
175
  icon?: boolean;
176
+ /** Sets the icon type to display in the badge. */
156
177
  iconType?: GoabIconType;
178
+ /** Sets the size of the badge. @default "medium" */
157
179
  size?: GoabBadgeSize;
180
+ /** Sets the visual emphasis. 'subtle' for less prominent, 'strong' for more emphasis. @default "strong" */
158
181
  emphasis?: GoabBadgeEmphasis;
182
+ /** Sets the accessible label for screen readers. */
159
183
  ariaLabel?: string;
160
184
  isReady: boolean;
161
185
  version: string;
@@ -167,11 +191,17 @@ declare class GoabBadge extends GoabBaseComponent implements OnInit {
167
191
 
168
192
  declare class GoabBlock extends GoabBaseComponent implements OnInit {
169
193
  private cdr;
194
+ /** Sets the spacing between items. Uses design system spacing tokens. */
170
195
  gap?: Spacing;
196
+ /** Sets the stacking direction of child components. */
171
197
  direction?: GoabBlockDirection;
198
+ /** Sets the primary axis alignment of child components. */
172
199
  alignment?: GoabBlockAlignment;
200
+ /** Sets the width of the block container. Defaults to max-content. */
173
201
  width?: string;
202
+ /** Sets the minimum width of the block container. */
174
203
  minWidth?: string;
204
+ /** Sets the maximum width of the block container. */
175
205
  maxWidth?: string;
176
206
  isReady: boolean;
177
207
  ngOnInit(): void;
@@ -181,16 +211,27 @@ declare class GoabBlock extends GoabBaseComponent implements OnInit {
181
211
 
182
212
  declare class GoabButton extends GoabBaseComponent implements OnInit {
183
213
  private cdr;
214
+ /** Sets the visual style of the button. Use "primary" for main actions, "secondary" for alternative actions, "tertiary" for low-emphasis actions, and "start" for prominent call-to-action buttons. @default "primary" */
184
215
  type?: GoabButtonType;
216
+ /** Sets the size of the button. Use "compact" for inline actions or space-constrained layouts. @default "normal" */
185
217
  size?: GoabButtonSize;
218
+ /** Sets the color variant for semantic meaning. Use "destructive" for delete or irreversible actions, "inverse" for dark backgrounds. @default "normal" */
186
219
  variant?: GoabButtonVariant;
220
+ /** Sets the disabled state. When true, prevents user interaction and applies disabled styling. */
187
221
  disabled?: boolean;
222
+ /** Sets the icon displayed before the button text. */
188
223
  leadingIcon?: GoabIconType;
224
+ /** Icon displayed after the button text. */
189
225
  trailingIcon?: GoabIconType;
226
+ /** Sets a custom width for the button (e.g., "200px" or "100%"). */
190
227
  width?: string;
228
+ /** Action identifier passed in click events for event delegation patterns. */
191
229
  action?: string;
230
+ /** Single argument value passed with the action in click events. */
192
231
  actionArg?: string;
232
+ /** Multiple argument values passed with the action in click events. */
193
233
  actionArgs?: Record<string, unknown>;
234
+ /** Emits when the button is clicked. */
194
235
  onClick: EventEmitter<any>;
195
236
  isReady: boolean;
196
237
  version: string;
@@ -204,7 +245,9 @@ declare class GoabButton extends GoabBaseComponent implements OnInit {
204
245
 
205
246
  declare class GoabButtonGroup extends GoabBaseComponent implements OnInit {
206
247
  private cdr;
248
+ /** Positions the button group in the page layout. */
207
249
  alignment?: GoabButtonGroupAlignment;
250
+ /** Sets the spacing between buttons in the button group. */
208
251
  gap?: GoabButtonGroupGap;
209
252
  isReady: boolean;
210
253
  ngOnInit(): void;
@@ -215,10 +258,15 @@ declare class GoabButtonGroup extends GoabBaseComponent implements OnInit {
215
258
  declare class GoabCalendar extends GoabBaseComponent implements OnInit {
216
259
  private cdr;
217
260
  version: string;
261
+ /** Name identifier for the calendar, included in change events. */
218
262
  name?: string;
263
+ /** The currently selected date value in YYYY-MM-DD format. */
219
264
  value?: Date | string;
265
+ /** The minimum selectable date in YYYY-MM-DD format. Defaults to 5 years in the past. */
220
266
  min?: Date | string | undefined;
267
+ /** The maximum selectable date in YYYY-MM-DD format. Defaults to 5 years in the future. */
221
268
  max?: Date | string | undefined;
269
+ /** Emits when the selected date changes. Emits the selected date details as GoabCalendarOnChangeDetail. */
222
270
  onChange: EventEmitter<GoabCalendarOnChangeDetail>;
223
271
  isReady: boolean;
224
272
  private once;
@@ -237,12 +285,19 @@ declare class GoabCallout extends GoabBaseComponent implements OnInit {
237
285
  isReady: boolean;
238
286
  version: string;
239
287
  ngOnInit(): void;
288
+ /** Define the context and colour of the callout. @default "information" */
240
289
  type?: GoabCalloutType;
290
+ /** Callout heading text. */
241
291
  heading?: string;
292
+ /** Sets the size of the callout. 'medium' has reduced padding and type size for compact areas. @default "large" */
242
293
  size?: GoabCalloutSize;
294
+ /** Sets the maximum width of the callout. */
243
295
  maxWidth?: string;
296
+ /** Indicates how assistive technology should handle updates to the live region. @default "off" */
244
297
  ariaLive?: GoabCalloutAriaLive;
298
+ /** Sets the icon theme. 'outline' for stroked icons, 'filled' for solid icons. @default "outline" */
245
299
  iconTheme?: GoabCalloutIconTheme;
300
+ /** Sets the visual prominence. 'high' for full background, 'medium' for subtle, 'low' for minimal. @default "medium" */
246
301
  emphasis?: GoabCalloutEmphasis;
247
302
  static ɵfac: i0.ɵɵFactoryDeclaration<GoabCallout, never>;
248
303
  static ɵcmp: i0.ɵɵComponentDeclaration<GoabCallout, "goab-callout", never, { "type": { "alias": "type"; "required": false; }; "heading": { "alias": "heading"; "required": false; }; "size": { "alias": "size"; "required": false; }; "maxWidth": { "alias": "maxWidth"; "required": false; }; "ariaLive": { "alias": "ariaLive"; "required": false; }; "iconTheme": { "alias": "iconTheme"; "required": false; }; "emphasis": { "alias": "emphasis"; "required": false; }; }, {}, never, ["*"], true, never>;
@@ -252,7 +307,9 @@ declare class GoabCard extends GoabBaseComponent implements OnInit {
252
307
  private cdr;
253
308
  isReady: boolean;
254
309
  ngOnInit(): void;
310
+ /** Adds a shadow to the card. 0 shows a border, 1-3 increase shadow intensity. */
255
311
  elevation?: number;
312
+ /** Sets the width of the card. */
256
313
  width?: string;
257
314
  static ɵfac: i0.ɵɵFactoryDeclaration<GoabCard, never>;
258
315
  static ɵcmp: i0.ɵɵComponentDeclaration<GoabCard, "goab-card", never, { "elevation": { "alias": "elevation"; "required": false; }; "width": { "alias": "width"; "required": false; }; }, {}, never, ["*"], true, never>;
@@ -277,7 +334,9 @@ declare class GoabCardActions implements OnInit {
277
334
 
278
335
  declare class GoabCardImage implements OnInit {
279
336
  private cdr;
337
+ /** @required The URL of the image to display. */
280
338
  src: string;
339
+ /** @required Height of the image container. Accepts CSS values like "200px" or "100%". */
281
340
  height: string;
282
341
  isReady: boolean;
283
342
  ngOnInit(): void;
@@ -290,17 +349,29 @@ declare class GoabCheckbox extends GoabControlValueAccessor implements OnInit {
290
349
  isReady: boolean;
291
350
  version: string;
292
351
  ngOnInit(): void;
352
+ /** Sets the name of the checkbox input for form submission. */
293
353
  name?: string;
354
+ /** Marks the checkbox item as selected. */
294
355
  checked?: boolean;
356
+ /** Shows a mixed/partial selection state. Used for 'Select All' checkboxes when some items are selected. */
295
357
  indeterminate?: boolean;
358
+ /** Label shown beside the checkbox. */
296
359
  text?: string;
360
+ /** The value binding. */
297
361
  value?: string | number | boolean | null;
362
+ /** Defines how the text will be translated for the screen reader. If not specified it will fall back to the name. */
298
363
  ariaLabel?: string;
364
+ /** Sets additional description content displayed below the checkbox label. Accepts plain text or a template. */
299
365
  description: string | TemplateRef<any>;
366
+ /** Sets the template for the expandable reveal slot content. */
300
367
  reveal?: TemplateRef<any>;
368
+ /** Text announced by screen readers when the reveal slot content is displayed. */
301
369
  revealArialLabel?: string;
370
+ /** Sets the maximum width of the checkbox. */
302
371
  maxWidth?: string;
372
+ /** Sets the size of the checkbox. 'compact' reduces spacing for dense layouts. @default "default" */
303
373
  size?: GoabCheckboxSize;
374
+ /** Emits when the checkbox value changes. Emits the new checkbox state as a GoabCheckboxOnChangeDetail object. */
304
375
  onChange: EventEmitter<GoabCheckboxOnChangeDetail>;
305
376
  getDescriptionAsString(): string;
306
377
  getDescriptionAsTemplate(): TemplateRef<any> | null;
@@ -316,11 +387,16 @@ declare class GoabCheckboxList extends GoabControlValueAccessor implements OnIni
316
387
  private cdr;
317
388
  isReady: boolean;
318
389
  version: string;
390
+ /** @required The name for the checkbox list group. Used as group identifier in change events. */
319
391
  name: string;
392
+ /** Sets the maximum width of the checkbox list container. */
320
393
  maxWidth?: string;
394
+ /** Sets the size of the checkbox list. 'compact' reduces spacing between items. @default "default" */
321
395
  size?: GoabCheckboxSize;
396
+ /** Array of currently selected checkbox values. */
322
397
  value?: string[];
323
398
  ngOnInit(): void;
399
+ /** Emits when a checkbox selection changes. Emits the change detail including name, value array, and event. */
324
400
  onChange: EventEmitter<GoabCheckboxListOnChangeDetail>;
325
401
  _onChange(e: Event): void;
326
402
  writeValue(value: string[] | null): void;
@@ -332,12 +408,19 @@ declare class GoabChip extends GoabBaseComponent implements OnInit {
332
408
  private cdr;
333
409
  isReady: boolean;
334
410
  ngOnInit(): void;
411
+ /** @deprecated Use GoAFilterChip instead. Icon displayed at the start of the chip. */
335
412
  leadingIcon?: GoabIconType | null;
413
+ /** @deprecated Use GoAFilterChip instead. Shows an error state on the chip. */
336
414
  error?: boolean;
415
+ /** @deprecated Use GoAFilterChip instead. When true, shows a delete icon and makes chip clickable. */
337
416
  deletable?: boolean;
417
+ /** @deprecated Use GoAFilterChip instead. The text content displayed in the chip. */
338
418
  content?: string;
419
+ /** @deprecated Use GoAFilterChip instead. The chip variant style. */
339
420
  variant?: GoabChipVariant;
421
+ /** @deprecated Use GoAFilterChip instead. The icon theme - outline or filled. */
340
422
  iconTheme?: GoabChipTheme;
423
+ /** Emits when the chip is clicked. */
341
424
  onClick: EventEmitter<any>;
342
425
  _onClick(): void;
343
426
  static ɵfac: i0.ɵɵFactoryDeclaration<GoabChip, never>;
@@ -348,11 +431,17 @@ declare class GoabChip extends GoabBaseComponent implements OnInit {
348
431
 
349
432
  declare class GoabCircularProgress implements OnInit {
350
433
  private cdr;
434
+ /** Stretch across the full screen or use it inline. */
351
435
  variant?: GoabCircularProgressVariant;
436
+ /** Size of the progress indicator. */
352
437
  size?: GoabCircularProgressSize;
438
+ /** Loading message displayed under the progress indicator. */
353
439
  message?: string;
440
+ /** Show/hide the page loader. This allows for fade transition to be applied in each transition. */
354
441
  visible?: boolean;
442
+ /** Set the progress value. Setting this value will change the type from infinite to progress. */
355
443
  progress?: number;
444
+ /** Sets a data-testid attribute for automated testing. */
356
445
  testId?: string;
357
446
  isReady: boolean;
358
447
  ngOnInit(): void;
@@ -373,14 +462,23 @@ declare class GoabColumnLayout implements OnInit {
373
462
 
374
463
  declare class GoabContainer extends GoabBaseComponent implements OnInit {
375
464
  private cdr;
465
+ /** Sets the container and accent bar styling. @default "interactive" */
376
466
  type?: GoabContainerType;
467
+ /** Sets the style of accent on the container. @default "filled" */
377
468
  accent?: GoabContainerAccent;
469
+ /** Sets the amount of white space in the container. @default "relaxed" */
378
470
  padding?: GoabContainerPadding;
471
+ /** Sets the width of the container. @default "full" */
379
472
  width?: GoabContainerWidth;
473
+ /** Sets the maximum width of the container. */
380
474
  maxWidth?: string;
475
+ /** Sets the minimum height of the container. */
381
476
  minHeight?: string;
477
+ /** Sets the maximum height of the container. */
382
478
  maxHeight?: string;
479
+ /** Sets the template for the title slot content. */
383
480
  title: TemplateRef<any>;
481
+ /** Sets the template for the actions slot content. */
384
482
  actions: TemplateRef<any>;
385
483
  isReady: boolean;
386
484
  ngOnInit(): void;
@@ -390,8 +488,11 @@ declare class GoabContainer extends GoabBaseComponent implements OnInit {
390
488
 
391
489
  declare class GoabDataGrid implements OnInit {
392
490
  private cdr;
491
+ /** Controls visibility of the keyboard navigation indicator icon. Use "visible" to show or "hidden" to hide. @default "visible" */
393
492
  keyboardIconVisibility: "visible" | "hidden";
493
+ /** Position of the keyboard navigation indicator icon. @default "left" */
394
494
  keyboardIconPosition: "left" | "right";
495
+ /** @required Navigation mode. "table" navigates like a table (up/down between rows), "layout" allows wrapping between rows with left/right arrows. */
395
496
  keyboardNav: "layout" | "table";
396
497
  isReady: boolean;
397
498
  ngOnInit(): void;
@@ -404,16 +505,21 @@ declare class GoabDatePicker extends GoabControlValueAccessor implements OnInit
404
505
  private cdr;
405
506
  isReady: boolean;
406
507
  version: string;
508
+ /** Sets the name of the date field. */
407
509
  name?: string;
510
+ /** Sets the value of the calendar date. */
408
511
  value?: Date | string | null | undefined;
512
+ /** Sets the minimum date value allowed. */
409
513
  min?: Date | string;
514
+ /** Sets the maximum date value allowed. */
410
515
  max?: Date | string;
516
+ /** Sets the date picker type. 'calendar' shows a calendar popup, 'input' shows just a date input. @default "calendar" */
411
517
  type?: GoabDatePickerInputType;
412
- /***
413
- * @deprecated This property has no effect and will be removed in a future version
414
- */
518
+ /** @deprecated This property has no effect and will be removed in a future version. */
415
519
  relative?: boolean;
520
+ /** Sets the width of the date picker input. */
416
521
  width?: string;
522
+ /** Emits when the selected date changes. Emits the date picker change detail including name and value. */
417
523
  onChange: EventEmitter<GoabDatePickerOnChangeDetail>;
418
524
  private once;
419
525
  private formatValue;
@@ -431,8 +537,11 @@ declare class GoabDatePicker extends GoabControlValueAccessor implements OnInit
431
537
 
432
538
  declare class GoabDetails extends GoabBaseComponent implements OnInit {
433
539
  private cdr;
540
+ /** @required The title heading. */
434
541
  heading: string;
542
+ /** Controls if details is expanded or not. */
435
543
  open?: boolean;
544
+ /** Sets the maximum width of the details. */
436
545
  maxWidth?: string;
437
546
  isReady: boolean;
438
547
  ngOnInit(): void;
@@ -452,12 +561,19 @@ declare class GoabDivider extends GoabBaseComponent implements OnInit {
452
561
  declare class GoabDrawer implements OnInit {
453
562
  private cdr;
454
563
  version: string;
564
+ /** @required Whether the drawer is open. */
455
565
  open: boolean;
566
+ /** @required The position of the drawer. */
456
567
  position: GoabDrawerPosition;
568
+ /** The heading text displayed at the top of the drawer. */
457
569
  heading: string | TemplateRef<any>;
570
+ /** Sets max height on bottom position, sets width on left and right position. */
458
571
  maxSize?: GoabDrawerSize;
572
+ /** Sets a data-testid attribute for automated testing. */
459
573
  testId?: string;
574
+ /** Sets the actions area content using an Angular template reference. */
460
575
  actions: TemplateRef<any>;
576
+ /** Emits when the drawer is closed. */
461
577
  onClose: EventEmitter<any>;
462
578
  isReady: boolean;
463
579
  ngOnInit(): void;
@@ -471,23 +587,35 @@ declare class GoabDrawer implements OnInit {
471
587
 
472
588
  declare class GoabDropdown extends GoabControlValueAccessor implements OnInit {
473
589
  private cdr;
590
+ /** Identifier for the dropdown. Should be unique. */
474
591
  name?: string;
592
+ /** Defines how the selected value will be translated for the screen reader. If not specified it will fall back to the name. */
475
593
  ariaLabel?: string;
594
+ /** The aria-labelledby attribute identifies the element(or elements) that labels the dropdown it is applied to. Normally it is the id of the label. */
476
595
  ariaLabelledBy?: string;
596
+ /** When true the dropdown will have the ability to filter options by typing into the input field. */
477
597
  filterable?: boolean;
598
+ /** Icon shown to the left of the dropdown input. */
478
599
  leadingIcon?: GoabIconType;
600
+ /** Maximum height of the dropdown menu. Non-native only. */
479
601
  maxHeight?: string;
602
+ /** When true, allows multiple items to be selected. Not currently exposed. */
480
603
  multiselect?: boolean;
604
+ /** When true will render the native select HTML element. */
481
605
  native?: boolean;
606
+ /** The text displayed for the dropdown before a selection is made. Non-native only. */
482
607
  placeholder?: string;
608
+ /** Overrides the autosized menu width. Non-native only. */
483
609
  width?: string;
610
+ /** Sets the maximum width of the dropdown. Use a CSS unit (px, %, ch, rem, em). */
484
611
  maxWidth?: string;
612
+ /** Specifies the autocomplete attribute for the dropdown input. Native only. */
485
613
  autoComplete?: string;
614
+ /** Sets the size of the dropdown. Compact reduces height for dense layouts. @default "default" */
486
615
  size?: GoabDropdownSize;
487
- /***
488
- * @deprecated This property has no effect and will be removed in a future version
489
- */
616
+ /** @deprecated This property has no effect and will be removed in a future version. */
490
617
  relative?: boolean;
618
+ /** Emits when the user selects a value from the dropdown. Emits a GoabDropdownOnChangeDetail object with the new value. */
491
619
  onChange: EventEmitter<GoabDropdownOnChangeDetail>;
492
620
  isReady: boolean;
493
621
  version: string;
@@ -502,10 +630,15 @@ declare class GoabDropdown extends GoabControlValueAccessor implements OnInit {
502
630
 
503
631
  declare class GoabDropdownItem implements OnInit {
504
632
  private cdr;
633
+ /** The value submitted when this item is selected. */
505
634
  value?: string;
635
+ /** Text used to filter and match this item in typeahead search. */
506
636
  filter?: string;
637
+ /** Display label for the dropdown item. */
507
638
  label?: string;
639
+ /** Sets the name attribute of the dropdown item. */
508
640
  name?: string;
641
+ /** Controls how the item is registered with the parent dropdown. */
509
642
  mountType?: GoabDropdownItemMountType;
510
643
  isReady: boolean;
511
644
  ngOnInit(): void;
@@ -515,13 +648,21 @@ declare class GoabDropdownItem implements OnInit {
515
648
 
516
649
  declare class GoabFileUploadCard implements OnInit {
517
650
  private cdr;
651
+ /** @required The name of the uploaded file to display. */
518
652
  filename: string;
519
- size?: number;
653
+ /** @required The file size in bytes. Displayed in a human-readable format (KB, MB). */
654
+ size: number;
655
+ /** The MIME type of the file. Used to determine the file type icon. */
520
656
  type?: string;
657
+ /** Upload progress percentage from 0-100. Use -1 to indicate upload is complete. */
521
658
  progress?: number;
659
+ /** Error message to display. When set, the card shows an error state with a cancel button. */
522
660
  error?: string;
661
+ /** Sets a data-testid attribute for automated testing. */
523
662
  testId?: string;
663
+ /** Emits when the user cancels a file upload. Emits a GoabFileUploadOnCancelDetail object with the filename. */
524
664
  onCancel: EventEmitter<GoabFileUploadOnCancelDetail>;
665
+ /** Emits when the user removes an uploaded file. Emits a GoabFileUploadOnDeleteDetail object with the filename. */
525
666
  onDelete: EventEmitter<GoabFileUploadOnDeleteDetail>;
526
667
  isReady: boolean;
527
668
  version: string;
@@ -529,34 +670,46 @@ declare class GoabFileUploadCard implements OnInit {
529
670
  _onCancel(event: Event): void;
530
671
  _onDelete(event: Event): void;
531
672
  static ɵfac: i0.ɵɵFactoryDeclaration<GoabFileUploadCard, never>;
532
- static ɵcmp: i0.ɵɵComponentDeclaration<GoabFileUploadCard, "goab-file-upload-card", never, { "filename": { "alias": "filename"; "required": true; }; "size": { "alias": "size"; "required": false; }; "type": { "alias": "type"; "required": false; }; "progress": { "alias": "progress"; "required": false; }; "error": { "alias": "error"; "required": false; }; "testId": { "alias": "testId"; "required": false; }; }, { "onCancel": "onCancel"; "onDelete": "onDelete"; }, never, never, true, never>;
673
+ static ɵcmp: i0.ɵɵComponentDeclaration<GoabFileUploadCard, "goab-file-upload-card", never, { "filename": { "alias": "filename"; "required": true; }; "size": { "alias": "size"; "required": true; }; "type": { "alias": "type"; "required": false; }; "progress": { "alias": "progress"; "required": false; }; "error": { "alias": "error"; "required": false; }; "testId": { "alias": "testId"; "required": false; }; }, { "onCancel": "onCancel"; "onDelete": "onDelete"; }, never, never, true, never>;
533
674
  static ngAcceptInputType_size: unknown;
534
675
  static ngAcceptInputType_progress: unknown;
535
676
  }
536
677
 
537
678
  declare class GoabFileUploadInput extends GoabBaseComponent implements OnInit {
538
679
  private cdr;
680
+ /** Sets the id attribute on the file upload input element. */
539
681
  id?: string;
540
- variant: GoabFileUploadInputVariant;
682
+ /** The input display variant. "dragdrop" shows a drag-and-drop area, "button" shows a simple button. @default "dragdrop" */
683
+ variant?: GoabFileUploadInputVariant;
684
+ /** Maximum file size with unit (e.g., "5MB", "100KB", "1GB"). Files exceeding this will be rejected. @default "5MB" */
541
685
  maxFileSize?: string;
686
+ /** Accepted file types as a comma-separated list of MIME types or file extensions (e.g., "image/*,.pdf"). */
542
687
  accept?: string;
688
+ /** Emits when a file is selected. Emits the selected file details. */
543
689
  onSelectFile: EventEmitter<GoabFileUploadInputOnSelectFileDetail>;
544
690
  isReady: boolean;
545
691
  version: string;
546
692
  ngOnInit(): void;
547
693
  _onSelectFile(e: Event): void;
548
694
  static ɵfac: i0.ɵɵFactoryDeclaration<GoabFileUploadInput, never>;
549
- static ɵcmp: i0.ɵɵComponentDeclaration<GoabFileUploadInput, "goab-file-upload-input", never, { "id": { "alias": "id"; "required": false; }; "variant": { "alias": "variant"; "required": true; }; "maxFileSize": { "alias": "maxFileSize"; "required": false; }; "accept": { "alias": "accept"; "required": false; }; }, { "onSelectFile": "onSelectFile"; }, never, never, true, never>;
695
+ static ɵcmp: i0.ɵɵComponentDeclaration<GoabFileUploadInput, "goab-file-upload-input", never, { "id": { "alias": "id"; "required": false; }; "variant": { "alias": "variant"; "required": false; }; "maxFileSize": { "alias": "maxFileSize"; "required": false; }; "accept": { "alias": "accept"; "required": false; }; }, { "onSelectFile": "onSelectFile"; }, never, never, true, never>;
550
696
  }
551
697
 
552
698
  declare class GoabFilterChip extends GoabBaseComponent implements OnInit {
553
699
  private cdr;
700
+ /** Shows an error state. */
554
701
  error?: boolean;
702
+ /** Marks the chip as deletable. */
555
703
  deletable?: boolean;
704
+ /** Text label of the chip. */
556
705
  content?: string;
706
+ /** Sets the icon theme style for the filter chip. */
557
707
  iconTheme?: GoabChipTheme;
708
+ /** Secondary text displayed in a smaller size before the main content. */
558
709
  secondaryText?: string;
710
+ /** Icon displayed at the start of the chip. */
559
711
  leadingIcon?: GoabIconType | null;
712
+ /** Emits when the filter chip delete button is clicked. */
560
713
  onClick: EventEmitter<any>;
561
714
  isReady: boolean;
562
715
  version: string;
@@ -570,8 +723,11 @@ declare class GoabFilterChip extends GoabBaseComponent implements OnInit {
570
723
 
571
724
  declare class GoabAppFooter implements OnInit {
572
725
  private cdr;
726
+ /** The maximum width of the main content area. */
573
727
  maxContentWidth?: string;
728
+ /** Sets a data-testid attribute for automated testing. */
574
729
  testId?: string;
730
+ /** URL for the Government of Alberta logo link. Set to empty string to disable the link. */
575
731
  url?: string;
576
732
  isReady: boolean;
577
733
  version: string;
@@ -582,8 +738,9 @@ declare class GoabAppFooter implements OnInit {
582
738
 
583
739
  declare class GoabAppFooterMetaSection implements OnInit {
584
740
  private cdr;
741
+ /** Sets a data-testid attribute for automated testing. */
585
742
  testId?: string;
586
- /** "slot" is required and must equal to "meta" so it can be rendered in the correct position **/
743
+ /** @required Sets the slot to "meta" to render the section in the correct footer position. */
587
744
  slot: "meta";
588
745
  isReady: boolean;
589
746
  ngOnInit(): void;
@@ -593,10 +750,13 @@ declare class GoabAppFooterMetaSection implements OnInit {
593
750
 
594
751
  declare class GoabAppFooterNavSection implements OnInit {
595
752
  private cdr;
753
+ /** The section heading displayed above the navigation links. */
596
754
  heading?: string;
755
+ /** Maximum number of columns to display links in on larger screens. @default 1 */
597
756
  maxColumnCount?: number | undefined;
757
+ /** Sets a data-testid attribute for automated testing. */
598
758
  testId?: string;
599
- /** "slot" is required and must equal to "nav" so it can be rendered in the correct position **/
759
+ /** @required Sets the slot to "nav" to render the section in the correct footer position. */
600
760
  slot: "nav";
601
761
  isReady: boolean;
602
762
  ngOnInit(): void;
@@ -605,10 +765,15 @@ declare class GoabAppFooterNavSection implements OnInit {
605
765
  }
606
766
 
607
767
  declare class GoabPublicForm {
768
+ /** The initialization status of the form. Set to "initializing" while loading external state, then "complete" when ready. @default "complete" */
608
769
  status?: GoabPublicFormStatus;
770
+ /** A name identifier for the form. Useful for debugging complex forms with multiple nested forms. */
609
771
  name?: string;
772
+ /** Emits when the form is initialized. */
610
773
  onInit: EventEmitter<Event>;
774
+ /** Emits when the form is complete. Emits the form state. */
611
775
  onComplete: EventEmitter<GoabFormState>;
776
+ /** Emits when the form state changes. Emits the updated form state. */
612
777
  onStateChange: EventEmitter<GoabFormState>;
613
778
  _onInit(e: Event): void;
614
779
  _onComplete(e: Event): void;
@@ -618,18 +783,25 @@ declare class GoabPublicForm {
618
783
  }
619
784
 
620
785
  declare class GoabPublicFormPage extends GoabBaseComponent {
786
+ /** Sets the id of the form page. */
621
787
  id: string;
788
+ /** Sets the main heading text of the form page. */
622
789
  heading: string;
790
+ /** Sets the sub-heading text displayed below the main heading. */
623
791
  subHeading: string;
792
+ /** Sets the heading used in the summary view for this page. */
624
793
  summaryHeading: string;
794
+ /** Sets the section title displayed above the heading. */
625
795
  sectionTitle: string;
796
+ /** Sets the URL for the back navigation link. */
626
797
  backUrl: string;
798
+ /** Sets the type of the form page step. @default "step" */
627
799
  type: GoabPublicFormPageStep;
800
+ /** Sets the text for the continue or confirm button. */
628
801
  buttonText: string;
802
+ /** Sets the visibility of the continue button. @default "visible" */
629
803
  buttonVisibility: GoabPublicFormPageButtonVisibility;
630
- /**
631
- * triggers when the form page continues to the next step
632
- */
804
+ /** Emits when the form page continues to the next step. */
633
805
  onContinue: EventEmitter<Event>;
634
806
  _onContinue(event: Event): void;
635
807
  static ɵfac: i0.ɵɵFactoryDeclaration<GoabPublicFormPage, never>;
@@ -637,16 +809,22 @@ declare class GoabPublicFormPage extends GoabBaseComponent {
637
809
  }
638
810
 
639
811
  declare class GoabPublicFormSummary {
812
+ /** Sets the heading text displayed above the form summary. */
640
813
  heading?: string;
641
814
  static ɵfac: i0.ɵɵFactoryDeclaration<GoabPublicFormSummary, never>;
642
815
  static ɵcmp: i0.ɵɵComponentDeclaration<GoabPublicFormSummary, "goab-public-form-summary", never, { "heading": { "alias": "heading"; "required": false; }; }, {}, never, ["*"], true, never>;
643
816
  }
644
817
 
645
818
  declare class GoabPublicSubform extends GoabBaseComponent {
819
+ /** Sets the id of the subform. */
646
820
  id?: string;
821
+ /** Sets the name identifier for the subform. */
647
822
  name?: string;
823
+ /** Sets the text for the continue button. */
648
824
  continueMsg?: string;
825
+ /** Emits when the subform is initialized. */
649
826
  onInit: EventEmitter<Event>;
827
+ /** Emits when the subform state changes. */
650
828
  onStateChange: EventEmitter<Event>;
651
829
  _onInit(e: Event): void;
652
830
  _onStateChange(e: Event): void;
@@ -655,30 +833,40 @@ declare class GoabPublicSubform extends GoabBaseComponent {
655
833
  }
656
834
 
657
835
  declare class GoabPublicSubformIndex extends GoabBaseComponent {
836
+ /** Sets the heading text of the subform index page. */
658
837
  heading?: string;
838
+ /** Sets the section title displayed above the heading. */
659
839
  sectionTitle?: string;
840
+ /** Sets the text for the action button that navigates to the subform. */
660
841
  actionButtonText?: string;
842
+ /** Sets the visibility of the continue button. @default "hidden" */
661
843
  buttonVisibility?: "visible" | "hidden";
662
844
  static ɵfac: i0.ɵɵFactoryDeclaration<GoabPublicSubformIndex, never>;
663
845
  static ɵcmp: i0.ɵɵComponentDeclaration<GoabPublicSubformIndex, "goab-public-subform-index", never, { "heading": { "alias": "heading"; "required": false; }; "sectionTitle": { "alias": "sectionTitle"; "required": false; }; "actionButtonText": { "alias": "actionButtonText"; "required": false; }; "buttonVisibility": { "alias": "buttonVisibility"; "required": false; }; }, {}, never, ["*"], true, never>;
664
846
  }
665
847
 
666
848
  declare class GoabPublicFormTask {
849
+ /** Sets the status of the task, which determines its badge display. */
667
850
  status?: GoabPublicFormTaskStatus;
668
851
  static ɵfac: i0.ɵɵFactoryDeclaration<GoabPublicFormTask, never>;
669
852
  static ɵcmp: i0.ɵɵComponentDeclaration<GoabPublicFormTask, "goab-public-form-task", never, { "status": { "alias": "status"; "required": false; }; }, {}, never, ["*"], true, never>;
670
853
  }
671
854
 
672
855
  declare class GoabPublicFormTaskList extends GoabBaseComponent {
856
+ /** Sets the heading text displayed above the task list. */
673
857
  heading?: string;
674
858
  static ɵfac: i0.ɵɵFactoryDeclaration<GoabPublicFormTaskList, never>;
675
859
  static ɵcmp: i0.ɵɵComponentDeclaration<GoabPublicFormTaskList, "goab-public-form-task-list", never, { "heading": { "alias": "heading"; "required": false; }; }, {}, never, ["*"], true, never>;
676
860
  }
677
861
 
678
862
  declare class GoabFieldset {
863
+ /** Sets the id of the fieldset. */
679
864
  id?: string;
865
+ /** Sets the section title displayed above the fieldset content. */
680
866
  sectionTitle?: string;
867
+ /** Sets when changes will be dispatched to the form. @default "continue" */
681
868
  dispatchOn: GoabFormDispatchOn;
869
+ /** Emits when the fieldset continues to the next step. Emits the continue detail. */
682
870
  onContinue: EventEmitter<GoabFieldsetOnContinueDetail>;
683
871
  _onContinue(event: Event): void;
684
872
  static ɵfac: i0.ɵɵFactoryDeclaration<GoabFieldset, never>;
@@ -687,21 +875,25 @@ declare class GoabFieldset {
687
875
 
688
876
  declare class GoabFormItem extends GoabBaseComponent implements OnInit {
689
877
  private cdr;
878
+ /** Creates a label for the form item. */
690
879
  label?: string;
880
+ /** Sets the label size. 'regular' for standard, 'large' for emphasis. */
691
881
  labelSize?: GoabFormItemLabelSize;
882
+ /** Help text displayed under the form field to provide additional explanation. */
692
883
  helpText?: string;
884
+ /** Error text displayed under the form field. Leave blank to indicate a valid field. */
693
885
  error?: string;
886
+ /** Marks the field with an optional or required label indicator. */
694
887
  requirement?: GoabFormItemRequirement;
888
+ /** Sets the maximum width of the form item. */
695
889
  maxWidth?: string;
890
+ /** Sets the id attribute on the form item element. */
696
891
  id?: string;
892
+ /** Specifies the input type for appropriate message spacing. Used with checkbox-list or radio-group. */
697
893
  type?: GoabFormItemType;
698
- /**
699
- * Public form: to arrange fields in the summary
700
- */
894
+ /** Sets the display order within the form summary. For public-form use only. */
701
895
  publicFormSummaryOrder?: number;
702
- /**
703
- * Public form: allow to override the label value within the form-summary to provide a shorter description of the value
704
- */
896
+ /** Overrides the label value within the form-summary to provide a shorter description. For public-form use only. */
705
897
  name?: string;
706
898
  isReady: boolean;
707
899
  version: string;
@@ -711,6 +903,7 @@ declare class GoabFormItem extends GoabBaseComponent implements OnInit {
711
903
  }
712
904
 
713
905
  declare class GoabFormItemSlot {
906
+ /** @required Sets which form-item slot this content should render into. */
714
907
  slot: "helptext" | "error";
715
908
  static ɵfac: i0.ɵɵFactoryDeclaration<GoabFormItemSlot, never>;
716
909
  static ɵcmp: i0.ɵɵComponentDeclaration<GoabFormItemSlot, "goab-form-item-slot", never, { "slot": { "alias": "slot"; "required": true; }; }, {}, never, ["*"], true, never>;
@@ -718,7 +911,9 @@ declare class GoabFormItemSlot {
718
911
 
719
912
  declare class GoabFormStep implements OnInit {
720
913
  private cdr;
914
+ /** The step label text displayed to users. */
721
915
  text?: string;
916
+ /** The completion status of the step. Affects visual styling and icons. */
722
917
  status?: GoabFormStepStatus;
723
918
  isReady: boolean;
724
919
  ngOnInit(): void;
@@ -728,7 +923,9 @@ declare class GoabFormStep implements OnInit {
728
923
 
729
924
  declare class GoabFormStepper extends GoabBaseComponent implements OnInit {
730
925
  private cdr;
926
+ /** The current step state value (1-based index). Leaving it blank (-1) will allow any step to be accessed. @default -1 */
731
927
  step?: number;
928
+ /** Emits when the form stepper step changes. Emits the new step as GoabFormStepperOnChangeDetail. */
732
929
  onChange: EventEmitter<GoabFormStepperOnChangeDetail>;
733
930
  isReady: boolean;
734
931
  ngOnInit(): void;
@@ -740,7 +937,9 @@ declare class GoabFormStepper extends GoabBaseComponent implements OnInit {
740
937
  declare class GoabGrid extends GoabBaseComponent implements OnInit {
741
938
  private cdr;
742
939
  isReady: boolean;
940
+ /** @required Minimum width of the child elements. */
743
941
  minChildWidth: string;
942
+ /** Gap between child items. */
744
943
  gap?: Spacing;
745
944
  ngOnInit(): void;
746
945
  static ɵfac: i0.ɵɵFactoryDeclaration<GoabGrid, never>;
@@ -749,14 +948,20 @@ declare class GoabGrid extends GoabBaseComponent implements OnInit {
749
948
 
750
949
  declare class GoabAppHeader extends GoabBaseComponent implements OnInit {
751
950
  private cdr;
951
+ /** Sets the URL to link from the alberta.ca logo. A full url is required. */
752
952
  url?: string;
953
+ /** Sets the service name to display in the app header. */
753
954
  heading?: string;
955
+ /** V2 only: Secondary text displayed under the service name. */
754
956
  secondaryText?: string;
957
+ /** Maximum width of the content area. */
755
958
  maxContentWidth?: string;
959
+ /** Sets the breakpoint in px for the full menu to display. */
756
960
  fullMenuBreakpoint?: number;
757
961
  isReady: boolean;
758
962
  version: string;
759
963
  ngOnInit(): void;
964
+ /** Emits when the menu button is clicked. Used for custom menu handling. */
760
965
  onMenuClick: EventEmitter<any>;
761
966
  _onMenuClick(): void;
762
967
  static ɵfac: i0.ɵɵFactoryDeclaration<GoabAppHeader, never>;
@@ -766,8 +971,11 @@ declare class GoabAppHeader extends GoabBaseComponent implements OnInit {
766
971
 
767
972
  declare class GoabAppHeaderMenu extends GoabBaseComponent implements OnInit {
768
973
  private cdr;
974
+ /** Icon displayed before the heading text. */
769
975
  leadingIcon?: GoabIconType;
976
+ /** The menu heading text displayed as the dropdown trigger. */
770
977
  heading?: string;
978
+ /** Sets the slot name for the component. */
771
979
  slotName?: string;
772
980
  get hostSlot(): string | null;
773
981
  isReady: boolean;
@@ -779,13 +987,21 @@ declare class GoabAppHeaderMenu extends GoabBaseComponent implements OnInit {
779
987
  declare class GoabHeroBanner implements OnInit {
780
988
  private cdr;
781
989
  isReady: boolean;
990
+ /** Main heading text. */
782
991
  heading?: string;
992
+ /** Background image url. */
783
993
  backgroundUrl?: string;
994
+ /** Minimum height of the hero banner. Defaults to 600px when a background image is provided. */
784
995
  minHeight?: string;
996
+ /** Sets a data-testid attribute for automated testing. */
785
997
  testId?: string;
998
+ /** Maximum width of the content area. */
786
999
  maxContentWidth?: string;
1000
+ /** Hero Banner background color when no background image is provided. */
787
1001
  backgroundColor?: string;
1002
+ /** Text color within the hero banner. */
788
1003
  textColor?: string;
1004
+ /** Angular template reference for the actions slot content. */
789
1005
  actions: TemplateRef<any>;
790
1006
  ngOnInit(): void;
791
1007
  static ɵfac: i0.ɵɵFactoryDeclaration<GoabHeroBanner, never>;
@@ -794,13 +1010,21 @@ declare class GoabHeroBanner implements OnInit {
794
1010
 
795
1011
  declare class GoabIcon extends GoabBaseComponent implements OnInit {
796
1012
  private cdr;
1013
+ /** @required The icon type to display. See GoabIconType for available icons. */
797
1014
  type: GoabIconType | GoabIconOverridesType;
1015
+ /** Sets the size of the icon. Accepts numeric (1-6) or named sizes. @default "medium" */
798
1016
  size?: GoabIconSize;
1017
+ /** Sets the icon theme. 'outline' shows stroked icons, 'filled' shows solid icons. */
799
1018
  theme?: GoabIconTheme;
1019
+ /** When true, inverts the icon colors for use on dark backgrounds. */
800
1020
  inverted?: boolean;
1021
+ /** Sets a custom fill color for the icon. Accepts any valid CSS color value. */
801
1022
  fillColor?: string;
1023
+ /** Sets the opacity of the icon from 0 (transparent) to 1 (opaque). */
802
1024
  opacity?: number;
1025
+ /** Adds an accessible title to the icon SVG. Used by screen readers. */
803
1026
  title?: string;
1027
+ /** Defines how the icon will be announced by screen readers. */
804
1028
  ariaLabel?: string;
805
1029
  isReady: boolean;
806
1030
  ngOnInit(): void;
@@ -814,15 +1038,25 @@ declare class GoabIconButton extends GoabBaseComponent implements OnInit {
814
1038
  private cdr;
815
1039
  isReady: boolean;
816
1040
  protected readonly JSON: JSON;
1041
+ /** @required Sets the icon. */
817
1042
  icon: GoabIconType;
1043
+ /** Sets the size of button. @default "medium" */
818
1044
  size?: GoabIconSize;
1045
+ /** Styles the button to show color, light, dark or destructive action. */
819
1046
  variant?: GoabIconButtonVariant;
1047
+ /** Sets the title of the button. */
820
1048
  title?: string;
1049
+ /** Disables the button. */
821
1050
  disabled?: boolean;
1051
+ /** Sets the aria-label of the button. */
822
1052
  ariaLabel?: string;
1053
+ /** Action identifier passed in click events for event delegation patterns. */
823
1054
  action?: string;
1055
+ /** Single argument value passed with the action in click events. */
824
1056
  actionArg?: string;
1057
+ /** Multiple argument values passed with the action in click events. */
825
1058
  actionArgs?: Record<string, unknown>;
1059
+ /** Emits when the icon button is clicked. */
826
1060
  onClick: EventEmitter<any>;
827
1061
  ngOnInit(): void;
828
1062
  _onClick(): void;
@@ -833,35 +1067,65 @@ declare class GoabIconButton extends GoabBaseComponent implements OnInit {
833
1067
 
834
1068
  declare class GoabInput extends GoabControlValueAccessor implements OnInit {
835
1069
  private cdr;
1070
+ /** Sets the type of the input field. @default "text" */
836
1071
  type?: GoabInputType;
1072
+ /** Name of input value that is received in the onChange event. */
837
1073
  name?: string;
1074
+ /** Debounce delay in milliseconds before firing the change event. 0 means no debounce. */
838
1075
  debounce?: number;
1076
+ /** Controls whether and how text input is automatically capitalized as it is entered/edited by the user. This only works on mobile devices. */
839
1077
  autoCapitalize?: GoabInputAutoCapitalize;
1078
+ /** Specifies the autocomplete attribute for the input field. */
840
1079
  autoComplete?: string;
1080
+ /** Text displayed within the input when no value is set. */
841
1081
  placeholder?: string;
1082
+ /** Icon shown to the left of the text. */
842
1083
  leadingIcon?: GoabIconType;
1084
+ /** Icon shown to the right of the text. */
843
1085
  trailingIcon?: GoabIconType;
1086
+ /** Sets the visual style variant. 'goa' for standard GoA styling, 'bare' for minimal styling. */
844
1087
  variant?: string;
1088
+ /** Sets the cursor focus to the input. */
845
1089
  focused?: boolean;
1090
+ /** Makes the input readonly. */
846
1091
  readonly?: boolean;
1092
+ /** Sets the width of the text input area. */
847
1093
  width?: string;
1094
+ /** @deprecated Use leadingContent slot instead. */
848
1095
  prefix?: string;
1096
+ /** @deprecated Use trailingContent slot instead. */
849
1097
  suffix?: string;
1098
+ /** Defines how the input will be translated for the screen reader. If not specified it will fall back to the name. */
850
1099
  ariaLabel?: string;
1100
+ /** Sets the maximum number of characters (as UTF-16 code units) the user can enter into the input. */
851
1101
  maxLength?: number;
1102
+ /** A string value that supports any number, or an ISO 8601 format if using the date or datetime type. */
852
1103
  min?: string | number;
1104
+ /** A string value that supports any number, or an ISO 8601 format if using the date or datetime type. */
853
1105
  max?: string | number;
1106
+ /** How much a number or date should change by. */
854
1107
  step?: number;
1108
+ /** The aria-labelledby attribute identifies the element (or elements) that labels the input. */
855
1109
  ariaLabelledBy?: string;
1110
+ /** Aria label for the trailing icon. Use only when the trailing icon is interactive. */
856
1111
  trailingIconAriaLabel?: string;
1112
+ /** Sets the text alignment within the input field. @default "left" */
857
1113
  textAlign?: "left" | "right";
1114
+ /** Sets the leading content slot, accepting a string or template reference. */
858
1115
  leadingContent: string | TemplateRef<any>;
1116
+ /** Sets the trailing content slot, accepting a string or template reference. */
859
1117
  trailingContent: string | TemplateRef<any>;
1118
+ /** Sets the size of the input. 'compact' reduces height for dense layouts. @default "default" */
860
1119
  size?: GoabInputSize;
1120
+ /** Emits when the trailing icon is clicked. */
861
1121
  onTrailingIconClick: EventEmitter<any>;
1122
+ /** Emits when the input receives focus. Emits focus detail including the current value. */
862
1123
  onFocus: EventEmitter<GoabInputOnFocusDetail>;
1124
+ /** Emits when the input loses focus. Emits blur detail including the current value. */
863
1125
  onBlur: EventEmitter<GoabInputOnBlurDetail>;
1126
+ /** Emits when a key is pressed in the input. Emits key press detail including the value and key pressed. */
864
1127
  onKeyPress: EventEmitter<GoabInputOnKeyPressDetail>;
1128
+ /** Emits when the input value changes. Emits change detail including the new value. */
865
1129
  onChange: EventEmitter<GoabInputOnChangeDetail>;
866
1130
  version: string;
867
1131
  isReady: boolean;
@@ -888,42 +1152,79 @@ declare class GoabInput extends GoabControlValueAccessor implements OnInit {
888
1152
  declare class GoabInputNumber implements ControlValueAccessor, OnInit {
889
1153
  private cdr;
890
1154
  isReady: boolean;
1155
+ /** Sets the type of the input field. @default "number" */
891
1156
  type: GoabInputType;
1157
+ /** Name of input value that is received in the onChange event. */
892
1158
  name?: string;
1159
+ /** Unique identifier for the input element. Used for label associations and accessibility. */
893
1160
  id?: string;
1161
+ /** Debounce delay in milliseconds before firing the change event. 0 means no debounce. */
894
1162
  debounce?: number;
1163
+ /** Disables this input. The input will not receive focus or events. */
895
1164
  disabled?: boolean;
1165
+ /** Controls whether and how text input is automatically capitalized as it is entered/edited by the user. This only works on mobile devices. */
896
1166
  autoCapitalize?: GoabInputAutoCapitalize;
1167
+ /** Text displayed within the input when no value is set. */
897
1168
  placeholder?: string;
1169
+ /** Icon shown to the left of the text. */
898
1170
  leadingIcon?: GoabIconType;
1171
+ /** Icon shown to the right of the text. */
899
1172
  trailingIcon?: GoabIconType;
1173
+ /** Sets the visual style variant. 'goa' for standard GoA styling, 'bare' for minimal styling. */
900
1174
  variant?: string;
1175
+ /** Sets the cursor focus to the input. */
901
1176
  focused?: boolean;
1177
+ /** Makes the input readonly. */
902
1178
  readonly?: boolean;
1179
+ /** Sets the input to an error state. */
903
1180
  error?: boolean;
1181
+ /** Sets the width of the text input area. */
904
1182
  width?: string;
1183
+ /** @deprecated Use leadingContent slot instead. */
905
1184
  prefix?: string;
1185
+ /** @deprecated Use trailingContent slot instead. */
906
1186
  suffix?: string;
1187
+ /** Sets a data-testid attribute for automated testing. */
907
1188
  testId?: string;
1189
+ /** Defines how the input will be translated for the screen reader. If not specified it will fall back to the name. */
908
1190
  ariaLabel?: string;
1191
+ /** Sets the maximum number of characters (as UTF-16 code units) the user can enter into the input. */
909
1192
  maxLength?: number;
1193
+ /** A string value that supports any number, or an ISO 8601 format if using the date or datetime type. */
910
1194
  min?: string | number;
1195
+ /** A string value that supports any number, or an ISO 8601 format if using the date or datetime type. */
911
1196
  max?: string | number;
1197
+ /** How much a number or date should change by. */
912
1198
  step?: number;
1199
+ /** The aria-labelledby attribute identifies the element (or elements) that labels the input. */
913
1200
  ariaLabelledBy?: string;
1201
+ /** Top margin. */
914
1202
  mt?: Spacing;
1203
+ /** Right margin. */
915
1204
  mr?: Spacing;
1205
+ /** Bottom margin. */
916
1206
  mb?: Spacing;
1207
+ /** Left margin. */
917
1208
  ml?: Spacing;
1209
+ /** Aria label for the trailing icon. Use only when the trailing icon is interactive. */
918
1210
  trailingIconAriaLabel?: string;
1211
+ /** Sets the text alignment within the input field. @default "right" */
919
1212
  textAlign?: "left" | "right";
1213
+ /** Bound to value. */
920
1214
  value: number | null;
1215
+ /** Sets the leading content slot, accepting a string or template reference. */
921
1216
  leadingContent: string | TemplateRef<any>;
1217
+ /** Sets the trailing content slot, accepting a string or template reference. */
922
1218
  trailingContent: string | TemplateRef<any>;
1219
+ /** Emits when the trailing icon is clicked. */
923
1220
  onTrailingIconClick: EventEmitter<void>;
1221
+ /** Emits when the input receives focus. Emits focus detail including the current value. */
924
1222
  onFocus: EventEmitter<GoabInputOnFocusDetail>;
1223
+ /** Emits when the input loses focus. Emits blur detail including the current value. */
925
1224
  onBlur: EventEmitter<GoabInputOnBlurDetail>;
1225
+ /** Emits when a key is pressed in the input. Emits key press detail including the value and key pressed. */
926
1226
  onKeyPress: EventEmitter<GoabInputOnKeyPressDetail>;
1227
+ /** Emits when the input value changes. Emits change detail including the new value. */
927
1228
  onChange: EventEmitter<GoabInputOnChangeDetail>;
928
1229
  handleTrailingIconClick: boolean;
929
1230
  ngOnInit(): void;
@@ -957,10 +1258,15 @@ declare class GoabInputNumber implements ControlValueAccessor, OnInit {
957
1258
 
958
1259
  declare class GoabLinearProgress implements OnInit {
959
1260
  private cdr;
1261
+ /** Progress value (0-100). When undefined, shows an indeterminate loading animation. */
960
1262
  progress?: number | null | undefined;
1263
+ /** Controls visibility of the percentage text. */
961
1264
  percentVisibility?: "visible" | "hidden" | undefined;
1265
+ /** Accessible label for the progress bar. */
962
1266
  ariaLabel?: string;
1267
+ /** ID of the element that labels this progress bar. */
963
1268
  ariaLabelledBy?: string;
1269
+ /** Sets a data-testid attribute for automated testing. */
964
1270
  testid?: string;
965
1271
  isReady: boolean;
966
1272
  ngOnInit(): void;
@@ -971,17 +1277,29 @@ declare class GoabLinearProgress implements OnInit {
971
1277
  declare class GoabLink implements OnInit {
972
1278
  private cdr;
973
1279
  isReady: boolean;
1280
+ /** Icon displayed before the link text. */
974
1281
  leadingIcon?: GoabIconType;
1282
+ /** Icon displayed after the link text. */
975
1283
  trailingIcon?: GoabIconType;
1284
+ /** Sets a data-testid attribute for automated testing. */
976
1285
  testId?: string;
1286
+ /** Custom action event name to dispatch when the link is clicked. */
977
1287
  action?: string;
1288
+ /** Sets the color theme. 'interactive' for blue, 'dark' for black, 'light' for white text. @default "interactive" */
978
1289
  color?: GoabLinkColor;
1290
+ /** Sets the text size and corresponding icon size. @default "medium" */
979
1291
  size?: GoabLinkSize;
1292
+ /** Single argument to pass with the action event (deprecated, use actionArgs). */
980
1293
  actionArg?: string;
1294
+ /** Object of arguments to pass with the action event. */
981
1295
  actionArgs?: Record<string, unknown>;
1296
+ /** Top margin. */
982
1297
  mt?: Spacing;
1298
+ /** Bottom margin. */
983
1299
  mb?: Spacing;
1300
+ /** Left margin. */
984
1301
  ml?: Spacing;
1302
+ /** Right margin. */
985
1303
  mr?: Spacing;
986
1304
  ngOnInit(): void;
987
1305
  protected readonly JSON: JSON;
@@ -992,14 +1310,22 @@ declare class GoabLink implements OnInit {
992
1310
  declare class GoabMicrositeHeader implements OnInit {
993
1311
  private cdr;
994
1312
  isReady: boolean;
1313
+ /** @required The service type which determines the badge style. "live" shows official government site text, "alpha" and "beta" show development stage badges. */
995
1314
  type: GoabServiceLevel;
1315
+ /** @required App or service version displayed on the right side of the header. */
996
1316
  version: string | TemplateRef<any>;
1317
+ /** Url to feedback page that will be displayed when provided. */
997
1318
  feedbackUrl?: string;
1319
+ /** Sets a data-testid attribute for automated testing. */
998
1320
  testId?: string;
1321
+ /** Maximum width of the content area. */
999
1322
  maxContentWidth?: string;
1323
+ /** For internal feedback urls sets target. */
1000
1324
  feedbackUrlTarget?: GoabLinkTarget;
1325
+ /** Sets the target attribute for the header link. */
1001
1326
  headerUrlTarget?: GoabLinkTarget;
1002
1327
  ngOnInit(): void;
1328
+ /** Emits when the feedback link is clicked. */
1003
1329
  onFeedbackClick: EventEmitter<any>;
1004
1330
  getVersionAsString(): string;
1005
1331
  getVersionAsTemplate(): TemplateRef<any> | null;
@@ -1013,19 +1339,28 @@ declare class GoabModal implements OnInit {
1013
1339
  isReady: boolean;
1014
1340
  version: string;
1015
1341
  ngOnInit(): void;
1342
+ /** Define the context and colour of the callout modal. It is required when type is set to callout. */
1016
1343
  calloutVariant?: GoabModalCalloutVariant;
1344
+ /** Controls if modal is visible or not. */
1017
1345
  open?: boolean;
1346
+ /** Set the max allowed width of the modal. */
1018
1347
  maxWidth?: string;
1348
+ /** Show close icon and allow clicking the background to close the modal. */
1019
1349
  closable: boolean;
1350
+ /** Sets the animation transition when opening/closing. 'fast' or 'slow' for animated, 'none' for instant. */
1020
1351
  transition?: GoabModalTransition;
1352
+ /** Sets a data-testid attribute for automated testing. */
1021
1353
  testId?: string;
1022
1354
  /**
1023
1355
  * @deprecated The role property is deprecated and will be removed in a future version.
1024
1356
  * The modal will always use role="dialog".
1025
1357
  */
1026
1358
  role?: string;
1359
+ /** The heading text displayed at the top of the modal. */
1027
1360
  heading: string | TemplateRef<any>;
1361
+ /** Sets the template reference for the modal action buttons. */
1028
1362
  actions: TemplateRef<any>;
1363
+ /** Emits when the modal is closed. */
1029
1364
  onClose: EventEmitter<any>;
1030
1365
  getHeadingAsString(): string;
1031
1366
  getHeadingAsTemplate(): TemplateRef<any> | null;
@@ -1036,14 +1371,23 @@ declare class GoabModal implements OnInit {
1036
1371
  }
1037
1372
 
1038
1373
  declare class GoabMenuButton {
1374
+ /** The button label text. When provided, displays as a text button with a dropdown icon. */
1039
1375
  text?: string;
1376
+ /** The button style variant. */
1040
1377
  type?: GoabButtonType;
1378
+ /** Sets the size of the button. */
1041
1379
  size?: GoabButtonSize;
1380
+ /** Sets the color variant for semantic meaning. */
1042
1381
  variant?: GoabButtonVariant;
1382
+ /** Maximum width of the dropdown menu. */
1043
1383
  maxWidth?: string;
1384
+ /** Icon displayed before the button text. When no text is provided, displays as an icon button. */
1044
1385
  leadingIcon?: GoabIconType;
1386
+ /** Sets the aria-label for the icon button in icon-only mode. */
1045
1387
  ariaLabel?: string;
1388
+ /** Sets a data-testid attribute for automated testing. */
1046
1389
  testId?: string;
1390
+ /** Emits when a menu action is clicked. Emits the action detail. */
1047
1391
  onAction: EventEmitter<GoabMenuButtonOnActionDetail>;
1048
1392
  _onAction(e: Event): void;
1049
1393
  static ɵfac: i0.ɵɵFactoryDeclaration<GoabMenuButton, never>;
@@ -1051,9 +1395,13 @@ declare class GoabMenuButton {
1051
1395
  }
1052
1396
 
1053
1397
  declare class GoabMenuAction {
1398
+ /** @required Display text for the menu action. */
1054
1399
  text: string;
1400
+ /** @required Action identifier included in the click event. */
1055
1401
  action: string;
1402
+ /** Icon displayed before the text. */
1056
1403
  icon?: GoabIconType;
1404
+ /** Sets a data-testid attribute for automated testing. */
1057
1405
  testId?: string;
1058
1406
  static ɵfac: i0.ɵɵFactoryDeclaration<GoabMenuAction, never>;
1059
1407
  static ɵcmp: i0.ɵɵComponentDeclaration<GoabMenuAction, "goab-menu-action", never, { "text": { "alias": "text"; "required": true; }; "action": { "alias": "action"; "required": true; }; "icon": { "alias": "icon"; "required": false; }; "testId": { "alias": "testId"; "required": false; }; }, {}, never, never, true, never>;
@@ -1063,13 +1411,20 @@ declare class GoabNotification implements OnInit {
1063
1411
  private cdr;
1064
1412
  isReady: boolean;
1065
1413
  version: string;
1414
+ /** Define the context and colour of the notification. @default "information" */
1066
1415
  type?: GoabNotificationType;
1416
+ /** Indicates how assistive technology should handle updates to the live region. */
1067
1417
  ariaLive?: GoabAriaLiveType;
1418
+ /** Maximum width of the content area. */
1068
1419
  maxContentWidth?: string;
1420
+ /** Sets the visual prominence. 'high' for full background, 'low' for medium. @default "high" */
1069
1421
  emphasis?: GoabNotificationEmphasis;
1422
+ /** When true, reduces padding for a more compact notification. */
1070
1423
  compact?: boolean;
1424
+ /** Sets a data-testid attribute for automated testing. */
1071
1425
  testId?: string;
1072
1426
  ngOnInit(): void;
1427
+ /** Emits when the notification is dismissed. */
1073
1428
  onDismiss: EventEmitter<any>;
1074
1429
  _onDismiss(): void;
1075
1430
  static ɵfac: i0.ɵɵFactoryDeclaration<GoabNotification, never>;
@@ -1080,7 +1435,9 @@ declare class GoabNotification implements OnInit {
1080
1435
  declare class GoabPageBlock implements OnInit {
1081
1436
  private cdr;
1082
1437
  isReady: boolean;
1438
+ /** Maximum width of the content area. Use "full" for 100% width or a CSS dimension like "1200px". */
1083
1439
  width?: GoabPageBlockSize;
1440
+ /** Sets a data-testid attribute for automated testing. */
1084
1441
  testId?: string;
1085
1442
  ngOnInit(): void;
1086
1443
  static ɵfac: i0.ɵɵFactoryDeclaration<GoabPageBlock, never>;
@@ -1090,6 +1447,7 @@ declare class GoabPageBlock implements OnInit {
1090
1447
  declare class GoabPages extends GoabBaseComponent implements OnInit {
1091
1448
  private cdr;
1092
1449
  isReady: boolean;
1450
+ /** The currently visible page (1-based index). */
1093
1451
  current?: number;
1094
1452
  ngOnInit(): void;
1095
1453
  static ɵfac: i0.ɵɵFactoryDeclaration<GoabPages, never>;
@@ -1101,11 +1459,16 @@ declare class GoabPagination extends GoabBaseComponent implements OnInit {
1101
1459
  private cdr;
1102
1460
  isReady: boolean;
1103
1461
  version: string;
1462
+ /** @required Total number of data items within all pages. */
1104
1463
  itemCount: number;
1464
+ /** @required The current page being viewed (non-zero based). */
1105
1465
  pageNumber: number;
1466
+ /** Number of data items shown per page. @default 10 */
1106
1467
  perPageCount?: number;
1468
+ /** Controls which nav controls are visible. @default "all" */
1107
1469
  variant?: GoabPaginationVariant;
1108
1470
  ngOnInit(): void;
1471
+ /** Emits when the page changes. Emits the new page number as part of the change detail. */
1109
1472
  onChange: EventEmitter<GoabPaginationOnChangeDetail>;
1110
1473
  _onChange(e: Event): void;
1111
1474
  static ɵfac: i0.ɵɵFactoryDeclaration<GoabPagination, never>;
@@ -1115,14 +1478,17 @@ declare class GoabPagination extends GoabBaseComponent implements OnInit {
1115
1478
  declare class GoabPopover extends GoabBaseComponent implements OnInit {
1116
1479
  private cdr;
1117
1480
  isReady: boolean;
1481
+ /** Sets the maximum width of the popover container. @default "320px" */
1118
1482
  maxWidth: string;
1483
+ /** Sets the minimum width of the popover container. */
1119
1484
  minWidth?: string;
1485
+ /** Sets if the popover has padding. Use false when content needs to be flush with boundaries. @default true */
1120
1486
  padded: boolean;
1487
+ /** Provides control to where the popover content is positioned. */
1121
1488
  position?: GoabPopoverPosition;
1122
- /***
1123
- * @deprecated This property has no effect and will be removed in a future version
1124
- */
1489
+ /** @deprecated This property has no effect and will be removed in a future version. */
1125
1490
  relative?: boolean;
1491
+ /** @required Sets the target template reference for the popover trigger. */
1126
1492
  target: TemplateRef<any>;
1127
1493
  ngOnInit(): void;
1128
1494
  static ɵfac: i0.ɵɵFactoryDeclaration<GoabPopover, never>;
@@ -1132,11 +1498,17 @@ declare class GoabPopover extends GoabBaseComponent implements OnInit {
1132
1498
  declare class GoabPushDrawer implements OnInit {
1133
1499
  private cdr;
1134
1500
  version: string;
1501
+ /** Sets the open state of the push drawer. */
1135
1502
  open?: boolean;
1503
+ /** Sets the heading text or template for the push drawer. */
1136
1504
  heading: string | TemplateRef<any>;
1505
+ /** Sets the width of the push drawer panel. */
1137
1506
  width?: string;
1507
+ /** Sets a data-testid attribute for automated testing. */
1138
1508
  testId?: string;
1509
+ /** Sets the template reference for the actions slot content. */
1139
1510
  actions: TemplateRef<any>;
1511
+ /** Emits when the push drawer closes. */
1140
1512
  onClose: EventEmitter<any>;
1141
1513
  isReady: boolean;
1142
1514
  ngOnInit(): void;
@@ -1152,11 +1524,16 @@ declare class GoabRadioGroup extends GoabControlValueAccessor implements OnInit
1152
1524
  private cdr;
1153
1525
  isReady: boolean;
1154
1526
  version: string;
1527
+ /** The name for the radio group. Used for accessibility and change events. */
1155
1528
  name?: string;
1529
+ /** Sets the layout direction. 'vertical' stacks items, 'horizontal' places them in a row. */
1156
1530
  orientation?: GoabRadioGroupOrientation;
1531
+ /** Defines how the radio group will be announced by screen readers. */
1157
1532
  ariaLabel?: string;
1533
+ /** Sets the size of all radio items. 'compact' reduces spacing for dense layouts (V2 only). @default "default" */
1158
1534
  size?: GoabRadioGroupSize;
1159
1535
  ngOnInit(): void;
1536
+ /** Emits when the selected radio item changes. Emits the name, value, and event of the selected item. */
1160
1537
  onChange: EventEmitter<GoabRadioGroupOnChangeDetail>;
1161
1538
  _onChange(e: Event): void;
1162
1539
  static ɵfac: i0.ɵɵFactoryDeclaration<GoabRadioGroup, never>;
@@ -1165,17 +1542,29 @@ declare class GoabRadioGroup extends GoabControlValueAccessor implements OnInit
1165
1542
 
1166
1543
  declare class GoabRadioItem extends GoabBaseComponent implements OnInit {
1167
1544
  private cdr;
1545
+ /** The value of this radio option. Will be emitted when selected. */
1168
1546
  value?: string;
1547
+ /** The display label for this radio option. Falls back to value if not provided. */
1169
1548
  label?: string;
1549
+ /** The name of the radio group. Inherited from the parent RadioGroup if not set. */
1170
1550
  name?: string;
1551
+ /** Additional description text displayed below the label. */
1171
1552
  description: string | TemplateRef<any>;
1553
+ /** Sets the template reference for the reveal slot content. */
1172
1554
  reveal?: TemplateRef<any>;
1555
+ /** Defines how this option will be announced by screen readers. */
1173
1556
  ariaLabel?: string;
1557
+ /** Text announced by screen readers when the reveal slot content is displayed. */
1174
1558
  revealAriaLabel?: string;
1559
+ /** Disables this radio option. Also disabled if the parent RadioGroup is disabled. */
1175
1560
  disabled?: boolean;
1561
+ /** Sets this radio option as checked/selected. */
1176
1562
  checked?: boolean;
1563
+ /** Shows an error state on this radio option. */
1177
1564
  error?: boolean;
1565
+ /** Sets the maximum width of this radio item. */
1178
1566
  maxWidth?: string;
1567
+ /** Enables compact layout for the radio item, reducing spacing for dense layouts. */
1179
1568
  compact?: boolean;
1180
1569
  isReady: boolean;
1181
1570
  version: string;
@@ -1194,6 +1583,7 @@ declare class GoabSideMenu implements OnInit {
1194
1583
  private cdr;
1195
1584
  isReady: boolean;
1196
1585
  version: string;
1586
+ /** Sets a data-testid attribute for automated testing. */
1197
1587
  testId?: string;
1198
1588
  ngOnInit(): void;
1199
1589
  static ɵfac: i0.ɵɵFactoryDeclaration<GoabSideMenu, never>;
@@ -1204,7 +1594,9 @@ declare class GoabSideMenuGroup extends GoabBaseComponent implements OnInit {
1204
1594
  private cdr;
1205
1595
  isReady: boolean;
1206
1596
  version: string;
1597
+ /** @required The heading text for the menu group. */
1207
1598
  heading: string;
1599
+ /** Icon displayed alongside the heading. */
1208
1600
  icon?: GoabIconType;
1209
1601
  ngOnInit(): void;
1210
1602
  static ɵfac: i0.ɵɵFactoryDeclaration<GoabSideMenuGroup, never>;
@@ -1215,8 +1607,11 @@ declare class GoabSideMenuHeading implements OnInit {
1215
1607
  private cdr;
1216
1608
  isReady: boolean;
1217
1609
  version: string;
1610
+ /** @required Icon displayed before the heading text. */
1218
1611
  icon: GoabIconType;
1612
+ /** Sets a data-testid attribute for automated testing. */
1219
1613
  testId?: string;
1614
+ /** Sets the template for the meta slot content. */
1220
1615
  meta: TemplateRef<any>;
1221
1616
  ngOnInit(): void;
1222
1617
  static ɵfac: i0.ɵɵFactoryDeclaration<GoabSideMenuHeading, never>;
@@ -1226,9 +1621,13 @@ declare class GoabSideMenuHeading implements OnInit {
1226
1621
  declare class GoabSkeleton extends GoabBaseComponent implements OnInit {
1227
1622
  private cdr;
1228
1623
  isReady: boolean;
1624
+ /** @required Sets the skeleton shape to represent your content. */
1229
1625
  type: GoabSkeletonType;
1626
+ /** Sets the maximum width. Currently only used in card skeleton type. @default "300px" */
1230
1627
  maxWidth: string;
1628
+ /** Size can affect either the height, width or both for different skeleton types. */
1231
1629
  size?: GoabSkeletonSize;
1630
+ /** Used within components that contain multiple lines. Currently only used in card skeleton type. */
1232
1631
  lineCount?: number;
1233
1632
  ngOnInit(): void;
1234
1633
  static ɵfac: i0.ɵɵFactoryDeclaration<GoabSkeleton, never>;
@@ -1239,8 +1638,11 @@ declare class GoabSkeleton extends GoabBaseComponent implements OnInit {
1239
1638
  declare class GoabSpacer implements OnInit {
1240
1639
  private cdr;
1241
1640
  isReady: boolean;
1641
+ /** Horizontal spacing. */
1242
1642
  hSpacing?: GoabSpacerHorizontalSpacing;
1643
+ /** Vertical spacing. */
1243
1644
  vSpacing?: GoabSpacerVerticalSpacing;
1645
+ /** Sets a data-testid attribute for automated testing. */
1244
1646
  testId?: string;
1245
1647
  ngOnInit(): void;
1246
1648
  static ɵfac: i0.ɵɵFactoryDeclaration<GoabSpacer, never>;
@@ -1250,8 +1652,11 @@ declare class GoabSpacer implements OnInit {
1250
1652
  declare class GoabTab implements OnInit {
1251
1653
  private cdr;
1252
1654
  isReady: boolean;
1655
+ /** The text label for this tab. Can also use the heading slot for custom content. */
1253
1656
  heading: string | TemplateRef<any>;
1657
+ /** When true, disables the tab. */
1254
1658
  disabled?: boolean;
1659
+ /** Sets the URL slug for the tab. */
1255
1660
  slug?: string;
1256
1661
  ngOnInit(): void;
1257
1662
  getHeadingAsString(): string;
@@ -1265,12 +1670,18 @@ declare class GoabTable extends GoabBaseComponent implements OnInit {
1265
1670
  private cdr;
1266
1671
  isReady: boolean;
1267
1672
  version: string;
1673
+ /** Width of the table. By default it will fit the enclosed content. */
1268
1674
  width?: string;
1675
+ /** Sets a relaxed variant of the table with more vertical padding for the cells. */
1269
1676
  variant?: GoabTableVariant;
1677
+ /** Sets sort mode: "single" allows one column, "multi" allows up to 2 columns. */
1270
1678
  sortMode?: GoabTableSortMode;
1679
+ /** When true, alternates row background colors for improved readability. */
1271
1680
  striped?: boolean;
1272
1681
  ngOnInit(): void;
1682
+ /** Emits when a table column is sorted. Emits the sort column and direction as GoabTableOnSortDetail. */
1273
1683
  onSort: EventEmitter<GoabTableOnSortDetail>;
1684
+ /** Emits when multi-column sorting changes. Emits an array of sort entries as GoabTableOnMultiSortDetail. */
1274
1685
  onMultiSort: EventEmitter<GoabTableOnMultiSortDetail>;
1275
1686
  _onSort(e: Event): void;
1276
1687
  _onMultiSort(e: Event): void;
@@ -1282,8 +1693,11 @@ declare class GoabTable extends GoabBaseComponent implements OnInit {
1282
1693
  declare class GoabTableSortHeader implements OnInit {
1283
1694
  private cdr;
1284
1695
  isReady: boolean;
1696
+ /** Column name identifier for sorting. */
1285
1697
  name?: string;
1698
+ /** Sets the sort direction indicator. @default "none" */
1286
1699
  direction?: GoabTableSortDirection;
1700
+ /** Sort order number for multi-column sort display ("1", "2", etc). */
1287
1701
  sortOrder?: GoabTableSortOrder;
1288
1702
  ngOnInit(): void;
1289
1703
  static ɵfac: i0.ɵɵFactoryDeclaration<GoabTableSortHeader, never>;
@@ -1294,13 +1708,18 @@ declare class GoabTabs implements OnInit {
1294
1708
  private cdr;
1295
1709
  isReady: boolean;
1296
1710
  version: string;
1711
+ /** The initially active tab (1-based index). If not set, the first tab is active. */
1297
1712
  initialTab?: number;
1713
+ /** Sets a data-testid attribute for automated testing. */
1298
1714
  testId?: string;
1715
+ /** Visual style variant. "segmented" shows pill-style tabs with animation. */
1299
1716
  variant?: GoabTabsVariant;
1300
1717
  /** Tab layout orientation. "auto" stacks vertically on mobile (default), "horizontal" keeps horizontal on all screen sizes. */
1301
1718
  orientation?: GoabTabsOrientation;
1719
+ /** Sets the navigation mode for tab switching. "hash" updates the URL hash when switching tabs. */
1302
1720
  navigation?: GoabTabsNavigation;
1303
1721
  ngOnInit(): void;
1722
+ /** Emits when the active tab changes. Emits the new tab index as GoabTabsOnChangeDetail. */
1304
1723
  onChange: EventEmitter<GoabTabsOnChangeDetail>;
1305
1724
  _onChange(e: Event): void;
1306
1725
  static ɵfac: i0.ɵɵFactoryDeclaration<GoabTabs, never>;
@@ -1313,8 +1732,11 @@ type SnackbarHorizontalPosition = "left" | "center" | "right";
1313
1732
  declare class GoabTemporaryNotificationCtrl implements OnInit {
1314
1733
  private cdr;
1315
1734
  isReady: boolean;
1735
+ /** Vertical position of the notification container. @default "bottom" */
1316
1736
  verticalPosition: SnackbarVerticalPosition;
1737
+ /** Horizontal position of the notification container. @default "center" */
1317
1738
  horizontalPosition: SnackbarHorizontalPosition;
1739
+ /** Sets a data-testid attribute for automated testing. */
1318
1740
  testId?: string;
1319
1741
  ngOnInit(): void;
1320
1742
  static ɵfac: i0.ɵɵFactoryDeclaration<GoabTemporaryNotificationCtrl, never>;
@@ -1323,15 +1745,24 @@ declare class GoabTemporaryNotificationCtrl implements OnInit {
1323
1745
 
1324
1746
  declare class GoabText implements OnInit {
1325
1747
  private cdr;
1748
+ /** The HTML element to render. Use semantic elements like 'h1'-'h6' for headings. */
1326
1749
  tag?: GoabTextTextElement | GoabTextHeadingElement;
1750
+ /** Overrides the text size. */
1327
1751
  size?: GoabTextSize;
1752
+ /** Sets the max width. */
1328
1753
  maxWidth?: GoabTextMaxWidth;
1754
+ /** Sets the text colour. */
1329
1755
  color?: GoabTextColor;
1756
+ /** Sets the id attribute on the host element. */
1330
1757
  id?: string;
1331
1758
  get hostId(): string | undefined;
1759
+ /** Top margin. */
1332
1760
  mt?: Spacing;
1761
+ /** Bottom margin. */
1333
1762
  mb?: Spacing;
1763
+ /** Left margin. */
1334
1764
  ml?: Spacing;
1765
+ /** Right margin. */
1335
1766
  mr?: Spacing;
1336
1767
  isReady: boolean;
1337
1768
  ngOnInit(): void;
@@ -1341,19 +1772,33 @@ declare class GoabText implements OnInit {
1341
1772
 
1342
1773
  declare class GoabTextArea extends GoabControlValueAccessor implements OnInit {
1343
1774
  private cdr;
1775
+ /** Name of the input value that is received in the _change event. */
1344
1776
  name?: string;
1777
+ /** Text displayed within the input when no value is set. */
1345
1778
  placeholder?: string;
1779
+ /** Set the number of rows. @default 3 */
1346
1780
  rows?: number;
1781
+ /** Sets the input to a read only state. */
1347
1782
  readOnly?: boolean;
1783
+ /** Width of the text area. */
1348
1784
  width?: string;
1785
+ /** Defines how the text will be translated for the screen reader. If not specified it will fall back to the name. */
1349
1786
  ariaLabel?: string;
1787
+ /** Counting interval for characters or words, specifying whether to count every character or word. @default "" */
1350
1788
  countBy?: GoabTextAreaCountBy;
1789
+ /** Maximum number of characters or words allowed. @default -1 */
1351
1790
  maxCount?: number;
1791
+ /** Maximum width of the text area. */
1352
1792
  maxWidth?: string;
1793
+ /** Specifies the autocomplete attribute for the textarea input. @default "on" */
1353
1794
  autoComplete?: string;
1795
+ /** Sets the size variant of the textarea. @default "default" */
1354
1796
  size?: GoabTextAreaSize;
1797
+ /** Emits when the textarea value changes. Emits the name and new value. */
1355
1798
  onChange: EventEmitter<GoabTextAreaOnChangeDetail>;
1799
+ /** Emits when a key is pressed in the textarea. Emits the name, value, and key. */
1356
1800
  onKeyPress: EventEmitter<GoabTextAreaOnKeyPressDetail>;
1801
+ /** Emits when the textarea loses focus. Emits the name and current value. */
1357
1802
  onBlur: EventEmitter<GoabTextAreaOnBlurDetail>;
1358
1803
  isReady: boolean;
1359
1804
  version: string;
@@ -1370,9 +1815,13 @@ declare class GoabTextArea extends GoabControlValueAccessor implements OnInit {
1370
1815
  declare class GoabTooltip extends GoabBaseComponent implements OnInit {
1371
1816
  private cdr;
1372
1817
  isReady: boolean;
1818
+ /** Position with respect to the child element. @default "top" */
1373
1819
  position?: GoabTooltipPosition;
1820
+ /** The content of the tooltip. */
1374
1821
  content?: string | TemplateRef<unknown>;
1822
+ /** Horizontal alignment to the child element. @default "center" */
1375
1823
  hAlign?: GoabTooltipHorizontalAlignment;
1824
+ /** Sets the maximum width of the tooltip. Must use 'px' unit. */
1376
1825
  maxWidth?: string;
1377
1826
  ngOnInit(): void;
1378
1827
  getContentAsString(): string;
@@ -1383,16 +1832,27 @@ declare class GoabTooltip extends GoabBaseComponent implements OnInit {
1383
1832
 
1384
1833
  declare class GoabWorkSideMenu implements OnInit {
1385
1834
  private cdr;
1835
+ /** @required The application name displayed in the header. */
1386
1836
  heading: string;
1837
+ /** @required URL for the header link. Clicking the logo/heading navigates to this URL. */
1387
1838
  url: string;
1839
+ /** User's name displayed in the profile section. */
1388
1840
  userName?: string;
1841
+ /** Secondary text displayed below the user's name, such as role or email. */
1389
1842
  userSecondaryText?: string;
1843
+ /** Controls whether the side menu is expanded or collapsed. */
1390
1844
  open?: boolean;
1845
+ /** Sets a data-testid attribute for automated testing. */
1391
1846
  testId?: string;
1847
+ /** Template reference for the primary navigation slot content. */
1392
1848
  primaryContent: TemplateRef<any>;
1849
+ /** Template reference for the secondary navigation slot content. */
1393
1850
  secondaryContent: TemplateRef<any>;
1851
+ /** Template reference for the account slot content. */
1394
1852
  accountContent: TemplateRef<any>;
1853
+ /** Emits when the side menu is toggled open or closed. */
1395
1854
  onToggle: EventEmitter<any>;
1855
+ /** Emits when a navigation link is clicked. Emits the URL as a string. */
1396
1856
  onNavigate: EventEmitter<string>;
1397
1857
  isReady: boolean;
1398
1858
  ngOnInit(): void;
@@ -1405,9 +1865,13 @@ declare class GoabWorkSideMenu implements OnInit {
1405
1865
 
1406
1866
  declare class GoabWorkSideMenuGroup implements OnInit {
1407
1867
  private cdr;
1868
+ /** @required The text displayed in the group heading. */
1408
1869
  heading: string;
1870
+ /** Icon displayed before the group label. When omitted, no icon is rendered and no space is reserved. */
1409
1871
  icon?: GoabIconType;
1872
+ /** Whether the group is open. */
1410
1873
  open?: boolean;
1874
+ /** Sets a data-testid attribute for automated testing. */
1411
1875
  testId?: string;
1412
1876
  isReady: boolean;
1413
1877
  ngOnInit(): void;
@@ -1418,14 +1882,23 @@ declare class GoabWorkSideMenuGroup implements OnInit {
1418
1882
 
1419
1883
  declare class GoabWorkSideMenuItem implements OnInit {
1420
1884
  private cdr;
1885
+ /** @required The text label displayed for the menu item. */
1421
1886
  label: string;
1887
+ /** The URL the menu item links to. Optional — when absent, renders as a button instead of a link. */
1422
1888
  url?: string;
1889
+ /** Badge text displayed alongside the menu item (e.g., notification count). */
1423
1890
  badge?: string;
1891
+ /** When true, indicates this is the currently active menu item. */
1424
1892
  current?: boolean;
1893
+ /** When true, displays a divider line above this menu item. */
1425
1894
  divider?: boolean;
1895
+ /** Icon displayed before the menu item label. */
1426
1896
  icon?: string;
1897
+ /** Sets a data-testid attribute for automated testing. */
1427
1898
  testId?: string;
1899
+ /** Sets the visual style of the badge. Use "emergency" for urgent items, "success" for positive status. @default "normal" */
1428
1900
  type?: GoabWorkSideMenuItemType;
1901
+ /** Template reference for the popover content slot. */
1429
1902
  popoverContent: TemplateRef<any>;
1430
1903
  isReady: boolean;
1431
1904
  ngOnInit(): void;
@@ -1435,13 +1908,21 @@ declare class GoabWorkSideMenuItem implements OnInit {
1435
1908
 
1436
1909
  declare class GoabWorkSideNotificationItem implements OnInit {
1437
1910
  private cdr;
1911
+ /** Sets the visual style of the notification item. */
1438
1912
  type?: GoabWorkSideNotificationItemType;
1913
+ /** The timestamp for when the notification was created. */
1439
1914
  timestamp?: string;
1915
+ /** The title text of the notification item. */
1440
1916
  title?: string;
1917
+ /** @required The description text of the notification item. */
1441
1918
  description: string;
1919
+ /** Indicates whether the notification is read or unread. */
1442
1920
  readStatus?: GoabWorkSideNotificationReadStatus;
1921
+ /** Sets the priority level of the notification. */
1443
1922
  priority?: GoabWorkSideNotificationPriority;
1923
+ /** Sets a data-testid attribute for automated testing. */
1444
1924
  testId?: string;
1925
+ /** Emits when the notification item is clicked. */
1445
1926
  onClick: EventEmitter<void>;
1446
1927
  isReady: boolean;
1447
1928
  ngOnInit(): void;
@@ -1452,10 +1933,15 @@ declare class GoabWorkSideNotificationItem implements OnInit {
1452
1933
 
1453
1934
  declare class GoabWorkSideNotificationPanel implements OnInit {
1454
1935
  private cdr;
1936
+ /** The heading text displayed at the top of the notification panel. */
1455
1937
  heading?: string;
1938
+ /** Sets the initially active tab in the notification panel. */
1456
1939
  activeTab?: GoabWorkSideNotificationActiveTabType;
1940
+ /** Sets a data-testid attribute for automated testing. */
1457
1941
  testId?: string;
1942
+ /** Emits when the user clicks "Mark all as read". */
1458
1943
  onMarkAllRead: EventEmitter<void>;
1944
+ /** Emits when the user clicks "View all". */
1459
1945
  onViewAll: EventEmitter<void>;
1460
1946
  isReady: boolean;
1461
1947
  ngOnInit(): void;