@momentum-design/components 0.118.5 → 0.119.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -477,6 +477,157 @@
477
477
  }
478
478
  ]
479
479
  },
480
+ {
481
+ "kind": "javascript-module",
482
+ "path": "components/accordiongroup/accordiongroup.component.js",
483
+ "declarations": [
484
+ {
485
+ "kind": "class",
486
+ "description": "An accordion group is a vertically stacked set of interactive headings that each contain a header and body content.\nEach heading of the accordion acts as a control that enable users to expand or hide their associated body sections of content.\nAccordions are commonly used to reduce the need to scroll when presenting multiple sections of content on a single page.\n\n- Default Slot: The accordion group component only accepts, `accordion` and `accordionbutton` components as the children, rest are ignored.\n\nThere are three types of variants:\n- Stacked - Each accordion will have a gap of 1.5rem (24px).\n- Borderless - Each accordion will not have any border and the group will also not have any border.\n- Contained - Each accordion will have no gap in between them and the border of the entire accordiongroup will be continuous.\n\nThere are two types of sizes:\n- Small: Small size has a padding of 1rem (16px) for both heading and body sections.\n- Large: Large size has a padding of 1.5rem (24px) for both heading and body sections.\n\nThe variant and size will be applied to all accordions inside this accordion group.\nTo show/expand more than one accordion at any given time, then set `allow-multiple` to `true`. By default, it's `false`.\n\nIf you don't need any controls on your accordion heading, then it's advised to use `accordionbutton` component.\n\nIf the first accordion of the accordion group is expanded by default, then the screen reader might loose focus when toggling the visibilty of the first accordion.",
487
+ "name": "AccordionGroup",
488
+ "cssProperties": [
489
+ {
490
+ "description": "The border color of the entire accordiongroup",
491
+ "name": "--mdc-accordiongroup-border-color"
492
+ }
493
+ ],
494
+ "slots": [
495
+ {
496
+ "description": "The default slot can contain the `accordion` or `accordionbutton` components.",
497
+ "name": "default"
498
+ }
499
+ ],
500
+ "members": [
501
+ {
502
+ "kind": "field",
503
+ "name": "size",
504
+ "type": {
505
+ "text": "Size"
506
+ },
507
+ "description": "The size of the accordion item.",
508
+ "default": "'small'",
509
+ "attribute": "size",
510
+ "reflects": true
511
+ },
512
+ {
513
+ "kind": "field",
514
+ "name": "variant",
515
+ "type": {
516
+ "text": "Variant"
517
+ },
518
+ "description": "The variant of the accordion item. Based on the variant, the styling of the accordion gets changed.",
519
+ "default": "'stacked'",
520
+ "attribute": "variant",
521
+ "reflects": true
522
+ },
523
+ {
524
+ "kind": "field",
525
+ "name": "allowMultiple",
526
+ "type": {
527
+ "text": "boolean"
528
+ },
529
+ "default": "false",
530
+ "description": "If true, multiple accordion items can be visible at the same time.",
531
+ "attribute": "allow-multiple",
532
+ "reflects": true
533
+ },
534
+ {
535
+ "kind": "method",
536
+ "name": "handleAccordionExpanded",
537
+ "privacy": "private",
538
+ "return": {
539
+ "type": {
540
+ "text": "void"
541
+ }
542
+ },
543
+ "parameters": [
544
+ {
545
+ "name": "event",
546
+ "type": {
547
+ "text": "Event"
548
+ },
549
+ "description": "The event object from the 'shown' event."
550
+ }
551
+ ],
552
+ "description": "Handles the 'shown' event for accordion items.\nIf `allowMultiple` is false, ensures that only one accordion item\nremains expanded by collapsing all other expanded items when a new item is expanded."
553
+ },
554
+ {
555
+ "kind": "method",
556
+ "name": "setChildrenAccordionAttributes",
557
+ "privacy": "private",
558
+ "return": {
559
+ "type": {
560
+ "text": "void"
561
+ }
562
+ },
563
+ "parameters": [
564
+ {
565
+ "name": "attributeName",
566
+ "type": {
567
+ "text": "string"
568
+ },
569
+ "description": "The name of the attribute to set."
570
+ },
571
+ {
572
+ "name": "attributeValue",
573
+ "type": {
574
+ "text": "string"
575
+ },
576
+ "description": "The value to set the attribute to."
577
+ }
578
+ ],
579
+ "description": "Sets the given attribute on all child accordion or accordionbutton components."
580
+ }
581
+ ],
582
+ "attributes": [
583
+ {
584
+ "name": "size",
585
+ "type": {
586
+ "text": "Size"
587
+ },
588
+ "description": "The size of the accordion item.",
589
+ "default": "'small'",
590
+ "fieldName": "size"
591
+ },
592
+ {
593
+ "name": "variant",
594
+ "type": {
595
+ "text": "Variant"
596
+ },
597
+ "description": "The variant of the accordion item. Based on the variant, the styling of the accordion gets changed.",
598
+ "default": "'stacked'",
599
+ "fieldName": "variant"
600
+ },
601
+ {
602
+ "name": "allow-multiple",
603
+ "type": {
604
+ "text": "boolean"
605
+ },
606
+ "default": "false",
607
+ "description": "If true, multiple accordion items can be visible at the same time.",
608
+ "fieldName": "allowMultiple"
609
+ }
610
+ ],
611
+ "superclass": {
612
+ "name": "Component",
613
+ "module": "/src/models"
614
+ },
615
+ "tagName": "mdc-accordiongroup",
616
+ "jsDoc": "/**\n * An accordion group is a vertically stacked set of interactive headings that each contain a header and body content.\n * Each heading of the accordion acts as a control that enable users to expand or hide their associated body sections of content.\n * Accordions are commonly used to reduce the need to scroll when presenting multiple sections of content on a single page.\n *\n * - Default Slot: The accordion group component only accepts, `accordion` and `accordionbutton` components as the children, rest are ignored.\n *\n * There are three types of variants:\n * - Stacked - Each accordion will have a gap of 1.5rem (24px).\n * - Borderless - Each accordion will not have any border and the group will also not have any border.\n * - Contained - Each accordion will have no gap in between them and the border of the entire accordiongroup will be continuous.\n *\n * There are two types of sizes:\n * - Small: Small size has a padding of 1rem (16px) for both heading and body sections.\n * - Large: Large size has a padding of 1.5rem (24px) for both heading and body sections.\n *\n * The variant and size will be applied to all accordions inside this accordion group.\n * To show/expand more than one accordion at any given time, then set `allow-multiple` to `true`. By default, it's `false`.\n *\n * If you don't need any controls on your accordion heading, then it's advised to use `accordionbutton` component.\n *\n * If the first accordion of the accordion group is expanded by default, then the screen reader might loose focus when toggling the visibilty of the first accordion.\n *\n * @tagname mdc-accordiongroup\n *\n * @slot default - The default slot can contain the `accordion` or `accordionbutton` components.\n *\n * @cssproperty --mdc-accordiongroup-border-color - The border color of the entire accordiongroup\n */",
617
+ "customElement": true
618
+ }
619
+ ],
620
+ "exports": [
621
+ {
622
+ "kind": "js",
623
+ "name": "default",
624
+ "declaration": {
625
+ "name": "AccordionGroup",
626
+ "module": "components/accordiongroup/accordiongroup.component.js"
627
+ }
628
+ }
629
+ ]
630
+ },
480
631
  {
481
632
  "kind": "javascript-module",
482
633
  "path": "components/accordionbutton/accordionbutton.component.js",
@@ -817,157 +968,6 @@
817
968
  }
818
969
  ]
819
970
  },
820
- {
821
- "kind": "javascript-module",
822
- "path": "components/accordiongroup/accordiongroup.component.js",
823
- "declarations": [
824
- {
825
- "kind": "class",
826
- "description": "An accordion group is a vertically stacked set of interactive headings that each contain a header and body content.\nEach heading of the accordion acts as a control that enable users to expand or hide their associated body sections of content.\nAccordions are commonly used to reduce the need to scroll when presenting multiple sections of content on a single page.\n\n- Default Slot: The accordion group component only accepts, `accordion` and `accordionbutton` components as the children, rest are ignored.\n\nThere are three types of variants:\n- Stacked - Each accordion will have a gap of 1.5rem (24px).\n- Borderless - Each accordion will not have any border and the group will also not have any border.\n- Contained - Each accordion will have no gap in between them and the border of the entire accordiongroup will be continuous.\n\nThere are two types of sizes:\n- Small: Small size has a padding of 1rem (16px) for both heading and body sections.\n- Large: Large size has a padding of 1.5rem (24px) for both heading and body sections.\n\nThe variant and size will be applied to all accordions inside this accordion group.\nTo show/expand more than one accordion at any given time, then set `allow-multiple` to `true`. By default, it's `false`.\n\nIf you don't need any controls on your accordion heading, then it's advised to use `accordionbutton` component.\n\nIf the first accordion of the accordion group is expanded by default, then the screen reader might loose focus when toggling the visibilty of the first accordion.",
827
- "name": "AccordionGroup",
828
- "cssProperties": [
829
- {
830
- "description": "The border color of the entire accordiongroup",
831
- "name": "--mdc-accordiongroup-border-color"
832
- }
833
- ],
834
- "slots": [
835
- {
836
- "description": "The default slot can contain the `accordion` or `accordionbutton` components.",
837
- "name": "default"
838
- }
839
- ],
840
- "members": [
841
- {
842
- "kind": "field",
843
- "name": "size",
844
- "type": {
845
- "text": "Size"
846
- },
847
- "description": "The size of the accordion item.",
848
- "default": "'small'",
849
- "attribute": "size",
850
- "reflects": true
851
- },
852
- {
853
- "kind": "field",
854
- "name": "variant",
855
- "type": {
856
- "text": "Variant"
857
- },
858
- "description": "The variant of the accordion item. Based on the variant, the styling of the accordion gets changed.",
859
- "default": "'stacked'",
860
- "attribute": "variant",
861
- "reflects": true
862
- },
863
- {
864
- "kind": "field",
865
- "name": "allowMultiple",
866
- "type": {
867
- "text": "boolean"
868
- },
869
- "default": "false",
870
- "description": "If true, multiple accordion items can be visible at the same time.",
871
- "attribute": "allow-multiple",
872
- "reflects": true
873
- },
874
- {
875
- "kind": "method",
876
- "name": "handleAccordionExpanded",
877
- "privacy": "private",
878
- "return": {
879
- "type": {
880
- "text": "void"
881
- }
882
- },
883
- "parameters": [
884
- {
885
- "name": "event",
886
- "type": {
887
- "text": "Event"
888
- },
889
- "description": "The event object from the 'shown' event."
890
- }
891
- ],
892
- "description": "Handles the 'shown' event for accordion items.\nIf `allowMultiple` is false, ensures that only one accordion item\nremains expanded by collapsing all other expanded items when a new item is expanded."
893
- },
894
- {
895
- "kind": "method",
896
- "name": "setChildrenAccordionAttributes",
897
- "privacy": "private",
898
- "return": {
899
- "type": {
900
- "text": "void"
901
- }
902
- },
903
- "parameters": [
904
- {
905
- "name": "attributeName",
906
- "type": {
907
- "text": "string"
908
- },
909
- "description": "The name of the attribute to set."
910
- },
911
- {
912
- "name": "attributeValue",
913
- "type": {
914
- "text": "string"
915
- },
916
- "description": "The value to set the attribute to."
917
- }
918
- ],
919
- "description": "Sets the given attribute on all child accordion or accordionbutton components."
920
- }
921
- ],
922
- "attributes": [
923
- {
924
- "name": "size",
925
- "type": {
926
- "text": "Size"
927
- },
928
- "description": "The size of the accordion item.",
929
- "default": "'small'",
930
- "fieldName": "size"
931
- },
932
- {
933
- "name": "variant",
934
- "type": {
935
- "text": "Variant"
936
- },
937
- "description": "The variant of the accordion item. Based on the variant, the styling of the accordion gets changed.",
938
- "default": "'stacked'",
939
- "fieldName": "variant"
940
- },
941
- {
942
- "name": "allow-multiple",
943
- "type": {
944
- "text": "boolean"
945
- },
946
- "default": "false",
947
- "description": "If true, multiple accordion items can be visible at the same time.",
948
- "fieldName": "allowMultiple"
949
- }
950
- ],
951
- "superclass": {
952
- "name": "Component",
953
- "module": "/src/models"
954
- },
955
- "tagName": "mdc-accordiongroup",
956
- "jsDoc": "/**\n * An accordion group is a vertically stacked set of interactive headings that each contain a header and body content.\n * Each heading of the accordion acts as a control that enable users to expand or hide their associated body sections of content.\n * Accordions are commonly used to reduce the need to scroll when presenting multiple sections of content on a single page.\n *\n * - Default Slot: The accordion group component only accepts, `accordion` and `accordionbutton` components as the children, rest are ignored.\n *\n * There are three types of variants:\n * - Stacked - Each accordion will have a gap of 1.5rem (24px).\n * - Borderless - Each accordion will not have any border and the group will also not have any border.\n * - Contained - Each accordion will have no gap in between them and the border of the entire accordiongroup will be continuous.\n *\n * There are two types of sizes:\n * - Small: Small size has a padding of 1rem (16px) for both heading and body sections.\n * - Large: Large size has a padding of 1.5rem (24px) for both heading and body sections.\n *\n * The variant and size will be applied to all accordions inside this accordion group.\n * To show/expand more than one accordion at any given time, then set `allow-multiple` to `true`. By default, it's `false`.\n *\n * If you don't need any controls on your accordion heading, then it's advised to use `accordionbutton` component.\n *\n * If the first accordion of the accordion group is expanded by default, then the screen reader might loose focus when toggling the visibilty of the first accordion.\n *\n * @tagname mdc-accordiongroup\n *\n * @slot default - The default slot can contain the `accordion` or `accordionbutton` components.\n *\n * @cssproperty --mdc-accordiongroup-border-color - The border color of the entire accordiongroup\n */",
957
- "customElement": true
958
- }
959
- ],
960
- "exports": [
961
- {
962
- "kind": "js",
963
- "name": "default",
964
- "declaration": {
965
- "name": "AccordionGroup",
966
- "module": "components/accordiongroup/accordiongroup.component.js"
967
- }
968
- }
969
- ]
970
- },
971
971
  {
972
972
  "kind": "javascript-module",
973
973
  "path": "components/alertchip/alertchip.component.js",
@@ -4489,72 +4489,232 @@
4489
4489
  {
4490
4490
  "name": "variant",
4491
4491
  "type": {
4492
- "text": "IconVariant"
4492
+ "text": "IconVariant"
4493
+ },
4494
+ "description": "Type of the variant can be `primary` or `secondary`.\nIt defines the background and foreground color of the icon.",
4495
+ "default": "primary",
4496
+ "fieldName": "variant"
4497
+ },
4498
+ {
4499
+ "name": "counter",
4500
+ "type": {
4501
+ "text": "number | undefined"
4502
+ },
4503
+ "description": "Counter is the number which can be provided in the badge.",
4504
+ "fieldName": "counter"
4505
+ },
4506
+ {
4507
+ "name": "max-counter",
4508
+ "type": {
4509
+ "text": "number"
4510
+ },
4511
+ "description": "The maximum number can be set up to 999, anything above that will be rendered as _999+_.\nThe max counter can be `9`, `99` or `999`.",
4512
+ "default": "99",
4513
+ "fieldName": "maxCounter"
4514
+ },
4515
+ {
4516
+ "name": "overlay",
4517
+ "type": {
4518
+ "text": "boolean"
4519
+ },
4520
+ "default": "false",
4521
+ "description": "Overlay is to add a thin outline to the badge.\nThis will help distinguish between the badge and the button,\nwhere the badge will be layered on top of a button.",
4522
+ "fieldName": "overlay"
4523
+ },
4524
+ {
4525
+ "name": "aria-label",
4526
+ "type": {
4527
+ "text": "string | null"
4528
+ },
4529
+ "default": "null",
4530
+ "description": "Aria-label attribute to be set for accessibility",
4531
+ "fieldName": "ariaLabel"
4532
+ },
4533
+ {
4534
+ "name": "icon-name",
4535
+ "type": {
4536
+ "text": "IconNames | undefined"
4537
+ },
4538
+ "description": "Name of the icon (= filename).\n\nIf no `icon-name` is provided, no icon will be rendered.",
4539
+ "fieldName": "iconName",
4540
+ "inheritedFrom": {
4541
+ "name": "IconNameMixin",
4542
+ "module": "src/utils/mixins/IconNameMixin.ts"
4543
+ }
4544
+ }
4545
+ ],
4546
+ "mixins": [
4547
+ {
4548
+ "name": "IconNameMixin",
4549
+ "module": "/src/utils/mixins/IconNameMixin"
4550
+ }
4551
+ ],
4552
+ "superclass": {
4553
+ "name": "Component",
4554
+ "module": "/src/models"
4555
+ },
4556
+ "tagName": "mdc-badge",
4557
+ "jsDoc": "/**\n * The `mdc-badge` component is a versatile UI element used to\n * display dot, icons, counters, success, warning and error type badge.\n *\n * Supported badge types:\n * - `dot`: Displays a dot notification badge with a blue color.\n * - `icon`: Displays a badge with a specified icon using the `icon-name` attribute.\n * - `counter`: Displays a badge with a counter value. If the counter exceeds the `max-counter`,\n * it shows `maxCounter+`. The maximum value of the counter is 999 and anything above that will be set to `999+`.\n * - `success`: Displays a success badge with a check circle icon and green color.\n * - `warning`: Displays a warning badge with a warning icon and yellow color.\n * - `error`: Displays a error badge with a error legacy icon and red color.\n *\n * For `icon`, `success`, `warning` and `error` types, the `mdc-icon` component is used to render the icon.\n *\n * For the `counter` type, the `mdc-text` component is used to render the counter value.\n *\n * @dependency mdc-icon\n * @dependency mdc-text\n *\n * @tagname mdc-badge\n *\n * @cssproperty --mdc-badge-primary-foreground-color - The foreground color of the primary badge.\n * @cssproperty --mdc-badge-primary-background-color - The background color of the primary badge.\n * @cssproperty --mdc-badge-secondary-foreground-color - The foreground color of the secondary badge.\n * @cssproperty --mdc-badge-secondary-background-color - The background color of the secondary badge.\n * @cssproperty --mdc-badge-success-foreground-color - The foreground color of the success badge.\n * @cssproperty --mdc-badge-success-background-color - The background color of the success badge.\n * @cssproperty --mdc-badge-warning-foreground-color - The foreground color of the warning badge.\n * @cssproperty --mdc-badge-warning-background-color - The background color of the warning badge.\n * @cssproperty --mdc-badge-error-foreground-color - The foreground color of the error badge.\n * @cssproperty --mdc-badge-error-background-color - The background color of the error badge.\n * @cssproperty --mdc-badge-overlay-background-color - The background color of the badge overlay.\n *\n * @csspart badge-dot - The dot notification badge.\n * @csspart badge-icon - The icon badge.\n * @csspart badge-icon__error - The error icon badge.\n * @csspart badge-icon__primary - The primary icon badge.\n * @csspart badge-icon__secondary - The secondary icon badge.\n * @csspart badge-icon__success - The success icon badge.\n * @csspart badge-icon__warning - The warning icon badge.\n * @csspart badge-overlay - The overlay badge.\n * @csspart badge-text - The text badge.\n */",
4558
+ "customElement": true
4559
+ }
4560
+ ],
4561
+ "exports": [
4562
+ {
4563
+ "kind": "js",
4564
+ "name": "default",
4565
+ "declaration": {
4566
+ "name": "Badge",
4567
+ "module": "components/badge/badge.component.js"
4568
+ }
4569
+ }
4570
+ ]
4571
+ },
4572
+ {
4573
+ "kind": "javascript-module",
4574
+ "path": "components/banner/banner.component.js",
4575
+ "declarations": [
4576
+ {
4577
+ "kind": "class",
4578
+ "description": "`mdc-banner` is a component that allows applications to communicate important messages to users \nand requires user action to dismiss them. It supports different message types with appropriate styling \nand icons, and provides flexibility for customization through label, secondary label, icons, and actions.\n\nThey are designed to be noticeable yet non-intrusive, helping users stay informed without interrupting their workflow.\n\nThis component supports both structured content via properties and flexible customization via slots:\n- Use the properties (`label`, `secondaryLabel`, `variant`) for standard banner layouts with automatic icon selection.\n- Use slots for custom content and complete layout control.\n- Combine both approaches for maximum flexibility.\n- Create custom orientations and actions using CSS parts and slots.",
4579
+ "name": "Banner",
4580
+ "cssProperties": [
4581
+ {
4582
+ "description": "Background color of the banner.",
4583
+ "name": "--mdc-banner-background-color"
4584
+ },
4585
+ {
4586
+ "description": "Border color of the banner.",
4587
+ "name": "--mdc-banner-border-color"
4588
+ },
4589
+ {
4590
+ "description": "Color of the icon in the banner.",
4591
+ "name": "--mdc-banner-icon-color"
4592
+ },
4593
+ {
4594
+ "description": "Elevation/shadow of the banner.",
4595
+ "name": "--mdc-banner-elevation"
4596
+ },
4597
+ {
4598
+ "description": "Padding inside the banner.",
4599
+ "name": "--mdc-banner-padding"
4600
+ },
4601
+ {
4602
+ "description": "Gap between banner elements.",
4603
+ "name": "--mdc-banner-gap"
4604
+ }
4605
+ ],
4606
+ "cssParts": [
4607
+ {
4608
+ "description": "The leading section containing the icon and text.",
4609
+ "name": "leading"
4610
+ },
4611
+ {
4612
+ "description": "The icon displayed for variants or custom icon slot.",
4613
+ "name": "leading-icon"
4614
+ },
4615
+ {
4616
+ "description": "The leading section containing label and secondary label text.",
4617
+ "name": "leading-text"
4618
+ },
4619
+ {
4620
+ "description": "The trailing section containing action buttons and controls.",
4621
+ "name": "trailing"
4622
+ },
4623
+ {
4624
+ "description": "The label text of the banner.",
4625
+ "name": "leading-label"
4626
+ },
4627
+ {
4628
+ "description": "The secondary label text of the banner.",
4629
+ "name": "leading-secondary-label"
4630
+ }
4631
+ ],
4632
+ "slots": [
4633
+ {
4634
+ "description": "Complete content override. When used, it replaces all default banner content including icon, label, secondary label, and actions.",
4635
+ "name": "content"
4636
+ },
4637
+ {
4638
+ "description": "Custom icon content. Overrides the default variant-based icon.",
4639
+ "name": "leading-icon"
4640
+ },
4641
+ {
4642
+ "description": "Custom text content. Overrides the label and secondaryLabel properties.",
4643
+ "name": "leading-text"
4644
+ },
4645
+ {
4646
+ "description": "Custom action buttons and controls. Use this for dismiss buttons, reset buttons, or any other actions.",
4647
+ "name": "trailing-actions"
4648
+ }
4649
+ ],
4650
+ "members": [
4651
+ {
4652
+ "kind": "field",
4653
+ "name": "variant",
4654
+ "type": {
4655
+ "text": "BannerVariant"
4493
4656
  },
4494
- "description": "Type of the variant can be `primary` or `secondary`.\nIt defines the background and foreground color of the icon.",
4495
- "default": "primary",
4496
- "fieldName": "variant"
4657
+ "description": "The type of banner variant.\n- Can be `custom`, `informational`, `warning`, `error`, or `success`.\n\nNote: When using the `custom` variant, provide your own icon via the `leading-icon` slot; otherwise, no icon will be shown.",
4658
+ "default": "'custom'",
4659
+ "attribute": "variant",
4660
+ "reflects": true
4497
4661
  },
4498
4662
  {
4499
- "name": "counter",
4663
+ "kind": "field",
4664
+ "name": "label",
4500
4665
  "type": {
4501
- "text": "number | undefined"
4666
+ "text": "string"
4502
4667
  },
4503
- "description": "Counter is the number which can be provided in the badge.",
4504
- "fieldName": "counter"
4668
+ "default": "''",
4669
+ "description": "Banner label text",
4670
+ "attribute": "label",
4671
+ "reflects": true
4505
4672
  },
4506
4673
  {
4507
- "name": "max-counter",
4674
+ "kind": "field",
4675
+ "name": "secondaryLabel",
4508
4676
  "type": {
4509
- "text": "number"
4677
+ "text": "string | undefined"
4510
4678
  },
4511
- "description": "The maximum number can be set up to 999, anything above that will be rendered as _999+_.\nThe max counter can be `9`, `99` or `999`.",
4512
- "default": "99",
4513
- "fieldName": "maxCounter"
4514
- },
4679
+ "description": "Banner secondary label text\n\nNote: Optional supporting text that appears below the label. Only rendered when label is also provided.",
4680
+ "attribute": "secondary-label",
4681
+ "reflects": true
4682
+ }
4683
+ ],
4684
+ "attributes": [
4515
4685
  {
4516
- "name": "overlay",
4686
+ "name": "variant",
4517
4687
  "type": {
4518
- "text": "boolean"
4688
+ "text": "BannerVariant"
4519
4689
  },
4520
- "default": "false",
4521
- "description": "Overlay is to add a thin outline to the badge.\nThis will help distinguish between the badge and the button,\nwhere the badge will be layered on top of a button.",
4522
- "fieldName": "overlay"
4690
+ "description": "The type of banner variant.\n- Can be `custom`, `informational`, `warning`, `error`, or `success`.\n\nNote: When using the `custom` variant, provide your own icon via the `leading-icon` slot; otherwise, no icon will be shown.",
4691
+ "default": "'custom'",
4692
+ "fieldName": "variant"
4523
4693
  },
4524
4694
  {
4525
- "name": "aria-label",
4695
+ "name": "label",
4526
4696
  "type": {
4527
- "text": "string | null"
4697
+ "text": "string"
4528
4698
  },
4529
- "default": "null",
4530
- "description": "Aria-label attribute to be set for accessibility",
4531
- "fieldName": "ariaLabel"
4699
+ "default": "''",
4700
+ "description": "Banner label text",
4701
+ "fieldName": "label"
4532
4702
  },
4533
4703
  {
4534
- "name": "icon-name",
4704
+ "name": "secondary-label",
4535
4705
  "type": {
4536
- "text": "IconNames | undefined"
4706
+ "text": "string | undefined"
4537
4707
  },
4538
- "description": "Name of the icon (= filename).\n\nIf no `icon-name` is provided, no icon will be rendered.",
4539
- "fieldName": "iconName",
4540
- "inheritedFrom": {
4541
- "name": "IconNameMixin",
4542
- "module": "src/utils/mixins/IconNameMixin.ts"
4543
- }
4544
- }
4545
- ],
4546
- "mixins": [
4547
- {
4548
- "name": "IconNameMixin",
4549
- "module": "/src/utils/mixins/IconNameMixin"
4708
+ "description": "Banner secondary label text\n\nNote: Optional supporting text that appears below the label. Only rendered when label is also provided.",
4709
+ "fieldName": "secondaryLabel"
4550
4710
  }
4551
4711
  ],
4552
4712
  "superclass": {
4553
4713
  "name": "Component",
4554
4714
  "module": "/src/models"
4555
4715
  },
4556
- "tagName": "mdc-badge",
4557
- "jsDoc": "/**\n * The `mdc-badge` component is a versatile UI element used to\n * display dot, icons, counters, success, warning and error type badge.\n *\n * Supported badge types:\n * - `dot`: Displays a dot notification badge with a blue color.\n * - `icon`: Displays a badge with a specified icon using the `icon-name` attribute.\n * - `counter`: Displays a badge with a counter value. If the counter exceeds the `max-counter`,\n * it shows `maxCounter+`. The maximum value of the counter is 999 and anything above that will be set to `999+`.\n * - `success`: Displays a success badge with a check circle icon and green color.\n * - `warning`: Displays a warning badge with a warning icon and yellow color.\n * - `error`: Displays a error badge with a error legacy icon and red color.\n *\n * For `icon`, `success`, `warning` and `error` types, the `mdc-icon` component is used to render the icon.\n *\n * For the `counter` type, the `mdc-text` component is used to render the counter value.\n *\n * @dependency mdc-icon\n * @dependency mdc-text\n *\n * @tagname mdc-badge\n *\n * @cssproperty --mdc-badge-primary-foreground-color - The foreground color of the primary badge.\n * @cssproperty --mdc-badge-primary-background-color - The background color of the primary badge.\n * @cssproperty --mdc-badge-secondary-foreground-color - The foreground color of the secondary badge.\n * @cssproperty --mdc-badge-secondary-background-color - The background color of the secondary badge.\n * @cssproperty --mdc-badge-success-foreground-color - The foreground color of the success badge.\n * @cssproperty --mdc-badge-success-background-color - The background color of the success badge.\n * @cssproperty --mdc-badge-warning-foreground-color - The foreground color of the warning badge.\n * @cssproperty --mdc-badge-warning-background-color - The background color of the warning badge.\n * @cssproperty --mdc-badge-error-foreground-color - The foreground color of the error badge.\n * @cssproperty --mdc-badge-error-background-color - The background color of the error badge.\n * @cssproperty --mdc-badge-overlay-background-color - The background color of the badge overlay.\n *\n * @csspart badge-dot - The dot notification badge.\n * @csspart badge-icon - The icon badge.\n * @csspart badge-icon__error - The error icon badge.\n * @csspart badge-icon__primary - The primary icon badge.\n * @csspart badge-icon__secondary - The secondary icon badge.\n * @csspart badge-icon__success - The success icon badge.\n * @csspart badge-icon__warning - The warning icon badge.\n * @csspart badge-overlay - The overlay badge.\n * @csspart badge-text - The text badge.\n */",
4716
+ "tagName": "mdc-banner",
4717
+ "jsDoc": "/**\n * `mdc-banner` is a component that allows applications to communicate important messages to users \n * and requires user action to dismiss them. It supports different message types with appropriate styling \n * and icons, and provides flexibility for customization through label, secondary label, icons, and actions.\n * \n * They are designed to be noticeable yet non-intrusive, helping users stay informed without interrupting their workflow.\n *\n * This component supports both structured content via properties and flexible customization via slots:\n * - Use the properties (`label`, `secondaryLabel`, `variant`) for standard banner layouts with automatic icon selection.\n * - Use slots for custom content and complete layout control.\n * - Combine both approaches for maximum flexibility.\n * - Create custom orientations and actions using CSS parts and slots.\n * \n * @dependency mdc-icon\n * @dependency mdc-text\n *\n * @slot content - Complete content override. When used, it replaces all default banner content including icon, label, secondary label, and actions.\n * @slot leading-icon - Custom icon content. Overrides the default variant-based icon.\n * @slot leading-text - Custom text content. Overrides the label and secondaryLabel properties.\n * @slot trailing-actions - Custom action buttons and controls. Use this for dismiss buttons, reset buttons, or any other actions.\n *\n * @tagname mdc-banner\n *\n * @csspart leading - The leading section containing the icon and text.\n * @csspart leading-icon - The icon displayed for variants or custom icon slot.\n * @csspart leading-text - The leading section containing label and secondary label text.\n * @csspart trailing - The trailing section containing action buttons and controls.\n * @csspart leading-label - The label text of the banner.\n * @csspart leading-secondary-label - The secondary label text of the banner.\n *\n * @cssproperty --mdc-banner-background-color - Background color of the banner.\n * @cssproperty --mdc-banner-border-color - Border color of the banner.\n * @cssproperty --mdc-banner-icon-color - Color of the icon in the banner.\n * @cssproperty --mdc-banner-elevation - Elevation/shadow of the banner.\n * @cssproperty --mdc-banner-padding - Padding inside the banner.\n * @cssproperty --mdc-banner-gap - Gap between banner elements.\n */",
4558
4718
  "customElement": true
4559
4719
  }
4560
4720
  ],
@@ -4563,8 +4723,8 @@
4563
4723
  "kind": "js",
4564
4724
  "name": "default",
4565
4725
  "declaration": {
4566
- "name": "Badge",
4567
- "module": "components/badge/badge.component.js"
4726
+ "name": "Banner",
4727
+ "module": "components/banner/banner.component.js"
4568
4728
  }
4569
4729
  }
4570
4730
  ]
@@ -4745,166 +4905,6 @@
4745
4905
  }
4746
4906
  ]
4747
4907
  },
4748
- {
4749
- "kind": "javascript-module",
4750
- "path": "components/banner/banner.component.js",
4751
- "declarations": [
4752
- {
4753
- "kind": "class",
4754
- "description": "`mdc-banner` is a component that allows applications to communicate important messages to users \nand requires user action to dismiss them. It supports different message types with appropriate styling \nand icons, and provides flexibility for customization through label, secondary label, icons, and actions.\n\nThey are designed to be noticeable yet non-intrusive, helping users stay informed without interrupting their workflow.\n\nThis component supports both structured content via properties and flexible customization via slots:\n- Use the properties (`label`, `secondaryLabel`, `variant`) for standard banner layouts with automatic icon selection.\n- Use slots for custom content and complete layout control.\n- Combine both approaches for maximum flexibility.\n- Create custom orientations and actions using CSS parts and slots.",
4755
- "name": "Banner",
4756
- "cssProperties": [
4757
- {
4758
- "description": "Background color of the banner.",
4759
- "name": "--mdc-banner-background-color"
4760
- },
4761
- {
4762
- "description": "Border color of the banner.",
4763
- "name": "--mdc-banner-border-color"
4764
- },
4765
- {
4766
- "description": "Color of the icon in the banner.",
4767
- "name": "--mdc-banner-icon-color"
4768
- },
4769
- {
4770
- "description": "Elevation/shadow of the banner.",
4771
- "name": "--mdc-banner-elevation"
4772
- },
4773
- {
4774
- "description": "Padding inside the banner.",
4775
- "name": "--mdc-banner-padding"
4776
- },
4777
- {
4778
- "description": "Gap between banner elements.",
4779
- "name": "--mdc-banner-gap"
4780
- }
4781
- ],
4782
- "cssParts": [
4783
- {
4784
- "description": "The leading section containing the icon and text.",
4785
- "name": "leading"
4786
- },
4787
- {
4788
- "description": "The icon displayed for variants or custom icon slot.",
4789
- "name": "leading-icon"
4790
- },
4791
- {
4792
- "description": "The leading section containing label and secondary label text.",
4793
- "name": "leading-text"
4794
- },
4795
- {
4796
- "description": "The trailing section containing action buttons and controls.",
4797
- "name": "trailing"
4798
- },
4799
- {
4800
- "description": "The label text of the banner.",
4801
- "name": "leading-label"
4802
- },
4803
- {
4804
- "description": "The secondary label text of the banner.",
4805
- "name": "leading-secondary-label"
4806
- }
4807
- ],
4808
- "slots": [
4809
- {
4810
- "description": "Complete content override. When used, it replaces all default banner content including icon, label, secondary label, and actions.",
4811
- "name": "content"
4812
- },
4813
- {
4814
- "description": "Custom icon content. Overrides the default variant-based icon.",
4815
- "name": "leading-icon"
4816
- },
4817
- {
4818
- "description": "Custom text content. Overrides the label and secondaryLabel properties.",
4819
- "name": "leading-text"
4820
- },
4821
- {
4822
- "description": "Custom action buttons and controls. Use this for dismiss buttons, reset buttons, or any other actions.",
4823
- "name": "trailing-actions"
4824
- }
4825
- ],
4826
- "members": [
4827
- {
4828
- "kind": "field",
4829
- "name": "variant",
4830
- "type": {
4831
- "text": "BannerVariant"
4832
- },
4833
- "description": "The type of banner variant.\n- Can be `custom`, `informational`, `warning`, `error`, or `success`.\n\nNote: When using the `custom` variant, provide your own icon via the `leading-icon` slot; otherwise, no icon will be shown.",
4834
- "default": "'custom'",
4835
- "attribute": "variant",
4836
- "reflects": true
4837
- },
4838
- {
4839
- "kind": "field",
4840
- "name": "label",
4841
- "type": {
4842
- "text": "string"
4843
- },
4844
- "default": "''",
4845
- "description": "Banner label text",
4846
- "attribute": "label",
4847
- "reflects": true
4848
- },
4849
- {
4850
- "kind": "field",
4851
- "name": "secondaryLabel",
4852
- "type": {
4853
- "text": "string | undefined"
4854
- },
4855
- "description": "Banner secondary label text\n\nNote: Optional supporting text that appears below the label. Only rendered when label is also provided.",
4856
- "attribute": "secondary-label",
4857
- "reflects": true
4858
- }
4859
- ],
4860
- "attributes": [
4861
- {
4862
- "name": "variant",
4863
- "type": {
4864
- "text": "BannerVariant"
4865
- },
4866
- "description": "The type of banner variant.\n- Can be `custom`, `informational`, `warning`, `error`, or `success`.\n\nNote: When using the `custom` variant, provide your own icon via the `leading-icon` slot; otherwise, no icon will be shown.",
4867
- "default": "'custom'",
4868
- "fieldName": "variant"
4869
- },
4870
- {
4871
- "name": "label",
4872
- "type": {
4873
- "text": "string"
4874
- },
4875
- "default": "''",
4876
- "description": "Banner label text",
4877
- "fieldName": "label"
4878
- },
4879
- {
4880
- "name": "secondary-label",
4881
- "type": {
4882
- "text": "string | undefined"
4883
- },
4884
- "description": "Banner secondary label text\n\nNote: Optional supporting text that appears below the label. Only rendered when label is also provided.",
4885
- "fieldName": "secondaryLabel"
4886
- }
4887
- ],
4888
- "superclass": {
4889
- "name": "Component",
4890
- "module": "/src/models"
4891
- },
4892
- "tagName": "mdc-banner",
4893
- "jsDoc": "/**\n * `mdc-banner` is a component that allows applications to communicate important messages to users \n * and requires user action to dismiss them. It supports different message types with appropriate styling \n * and icons, and provides flexibility for customization through label, secondary label, icons, and actions.\n * \n * They are designed to be noticeable yet non-intrusive, helping users stay informed without interrupting their workflow.\n *\n * This component supports both structured content via properties and flexible customization via slots:\n * - Use the properties (`label`, `secondaryLabel`, `variant`) for standard banner layouts with automatic icon selection.\n * - Use slots for custom content and complete layout control.\n * - Combine both approaches for maximum flexibility.\n * - Create custom orientations and actions using CSS parts and slots.\n * \n * @dependency mdc-icon\n * @dependency mdc-text\n *\n * @slot content - Complete content override. When used, it replaces all default banner content including icon, label, secondary label, and actions.\n * @slot leading-icon - Custom icon content. Overrides the default variant-based icon.\n * @slot leading-text - Custom text content. Overrides the label and secondaryLabel properties.\n * @slot trailing-actions - Custom action buttons and controls. Use this for dismiss buttons, reset buttons, or any other actions.\n *\n * @tagname mdc-banner\n *\n * @csspart leading - The leading section containing the icon and text.\n * @csspart leading-icon - The icon displayed for variants or custom icon slot.\n * @csspart leading-text - The leading section containing label and secondary label text.\n * @csspart trailing - The trailing section containing action buttons and controls.\n * @csspart leading-label - The label text of the banner.\n * @csspart leading-secondary-label - The secondary label text of the banner.\n *\n * @cssproperty --mdc-banner-background-color - Background color of the banner.\n * @cssproperty --mdc-banner-border-color - Border color of the banner.\n * @cssproperty --mdc-banner-icon-color - Color of the icon in the banner.\n * @cssproperty --mdc-banner-elevation - Elevation/shadow of the banner.\n * @cssproperty --mdc-banner-padding - Padding inside the banner.\n * @cssproperty --mdc-banner-gap - Gap between banner elements.\n */",
4894
- "customElement": true
4895
- }
4896
- ],
4897
- "exports": [
4898
- {
4899
- "kind": "js",
4900
- "name": "default",
4901
- "declaration": {
4902
- "name": "Banner",
4903
- "module": "components/banner/banner.component.js"
4904
- }
4905
- }
4906
- ]
4907
- },
4908
4908
  {
4909
4909
  "kind": "javascript-module",
4910
4910
  "path": "components/bullet/bullet.component.js",
@@ -31276,7 +31276,7 @@
31276
31276
  "declarations": [
31277
31277
  {
31278
31278
  "kind": "class",
31279
- "description": "Popover component is a lightweight floating UI element that displays additional content when triggered.\nIt can be used for tooltips, dropdowns, or contextual menus.\nThe popover automatically positions itself based on available space and\nsupports dynamic height adjustments with scrollable content when needed。\n\nNote:\n - A component (button) can trigger more than one popover, but only one of them should change the\n aria-expanded and aria-haspopup, the rest of the popovers must have `disable-aria-expanded` attribute.",
31279
+ "description": "Popover is genric overlay which can be trigered by any actinable element.\n\nIt can be used for tooltips, dropdowns, menus or any showing any other contextual content.\n\nThe popover automatically positions itself based on available space and\nsupports dynamic height adjustments with scrollable content when needed.\nIt uses [Floating UI](https://floating-ui.com/) for maintaining the position of the popover.\n\n## Limitations\n\n### On trigger for multiple popovers\n\nA component (button, etc.) can trigger more than one popover, but only one of them should change the\naria-expanded and aria-haspopup attributes on the trigger.\n\nTo prevent unexpected attribute changes on the trigger `disable-aria-expanded` attribute must be set on all linked\nPopoers except one.\n\n### React Popover with append-to attribute\n\nReact mounts the popover based on the virtual DOM, but when the append-to attribute is set, the popover removes itself\nand mounts to the specified element. React will not know about the move and will not know about the\nnewly created mdc-popoverportal element either. This throws a `NotFoundError` error when the Popover is directly\nadded/removed by React, for example:\n\n```tsx\nconst SomeComponent = () => {\n const [isOpen, setIsOpen] = useState(false);\n return (<div>\n {isOpen && <Popover append-to=\"some-element-id\">...</mdc-popover>}\n </div>);\n}\n```\nAs a workaround Popover need to wrap with any other element/component, for example:\n```tsx\nconst SomeComponent = () => {\n const [isOpen, setIsOpen] = useState(false);\n return (<div>\n {isOpen && <div>\n <Popover append-to=\"some-element-id\">...</mdc-popover>\n <div>}\n </div>);\n}\n```\nNote the wrapper <div> around the Popover component (React.Fragment does not work).",
31280
31280
  "name": "Popover",
31281
31281
  "cssProperties": [
31282
31282
  {
@@ -32799,7 +32799,7 @@
32799
32799
  "module": "/src/models"
32800
32800
  },
32801
32801
  "tagName": "mdc-popover",
32802
- "jsDoc": "/**\n * Popover component is a lightweight floating UI element that displays additional content when triggered.\n * It can be used for tooltips, dropdowns, or contextual menus.\n * The popover automatically positions itself based on available space and\n * supports dynamic height adjustments with scrollable content when needed。\n *\n * Note:\n * - A component (button) can trigger more than one popover, but only one of them should change the\n * aria-expanded and aria-haspopup, the rest of the popovers must have `disable-aria-expanded` attribute.\n *\n * @dependency mdc-button\n *\n * @tagname mdc-popover\n *\n *\n * @event shown - (React: onShown) This event is dispatched when the popover is shown\n * @event hidden - (React: onHidden) This event is dispatched when the popover is hidden\n * @event created - (React: onCreated) This event is dispatched when the popover is created (added to the DOM)\n * @event destroyed - (React: onDestroyed) This event is dispatched when the popover is destroyed (removed from the DOM)\n *\n * @cssproperty --mdc-popover-arrow-border-radius - radius of the arrow border\n * @cssproperty --mdc-popover-arrow-border - border of the arrow\n * @cssproperty --mdc-popover-primary-background-color - primary background color of the popover\n * @cssproperty --mdc-popover-border-color - border color of the popover\n * @cssproperty --mdc-popover-inverted-background-color - inverted background color of the popover\n * @cssproperty --mdc-popover-inverted-border-color - inverted border color of the popover\n * @cssproperty --mdc-popover-inverted-text-color - inverted text color of the popover\n * @cssproperty --mdc-popover-elevation-3 - elevation of the popover\n * @cssproperty --mdc-popover-max-width - max width of the popover\n * @cssproperty --mdc-popover-max-height - max height of the popover\n * @cssproperty --mdc-popover-width - width of the popover\n *\n * @slot - Default slot for the popover content\n *\n * @csspart popover-close - The close button of the popover.\n * @csspart popover-content - The content of the popover.\n * @csspart popover-hover-bridge - The hover bridge of the popover.\n */",
32802
+ "jsDoc": "/**\n * Popover is genric overlay which can be trigered by any actinable element.\n *\n * It can be used for tooltips, dropdowns, menus or any showing any other contextual content.\n *\n * The popover automatically positions itself based on available space and\n * supports dynamic height adjustments with scrollable content when needed.\n * It uses [Floating UI](https://floating-ui.com/) for maintaining the position of the popover.\n *\n * ## Limitations\n *\n * ### On trigger for multiple popovers\n *\n * A component (button, etc.) can trigger more than one popover, but only one of them should change the\n * aria-expanded and aria-haspopup attributes on the trigger.\n *\n * To prevent unexpected attribute changes on the trigger `disable-aria-expanded` attribute must be set on all linked\n * Popoers except one.\n *\n * ### React Popover with append-to attribute\n *\n * React mounts the popover based on the virtual DOM, but when the append-to attribute is set, the popover removes itself\n * and mounts to the specified element. React will not know about the move and will not know about the\n * newly created mdc-popoverportal element either. This throws a `NotFoundError` error when the Popover is directly\n * added/removed by React, for example:\n *\n * ```tsx\n * const SomeComponent = () => {\n * const [isOpen, setIsOpen] = useState(false);\n * return (<div>\n * {isOpen && <Popover append-to=\"some-element-id\">...</mdc-popover>}\n * </div>);\n * }\n * ```\n * As a workaround Popover need to wrap with any other element/component, for example:\n * ```tsx\n * const SomeComponent = () => {\n * const [isOpen, setIsOpen] = useState(false);\n * return (<div>\n * {isOpen && <div>\n * <Popover append-to=\"some-element-id\">...</mdc-popover>\n * <div>}\n * </div>);\n * }\n * ```\n * Note the wrapper <div> around the Popover component (React.Fragment does not work).\n *\n * @dependency mdc-button\n *\n * @tagname mdc-popover\n *\n * @event shown - (React: onShown) This event is dispatched when the popover is shown\n * @event hidden - (React: onHidden) This event is dispatched when the popover is hidden\n * @event created - (React: onCreated) This event is dispatched when the popover is created (added to the DOM)\n * @event destroyed - (React: onDestroyed) This event is dispatched when the popover is destroyed (removed from the DOM)\n *\n * @cssproperty --mdc-popover-arrow-border-radius - radius of the arrow border\n * @cssproperty --mdc-popover-arrow-border - border of the arrow\n * @cssproperty --mdc-popover-primary-background-color - primary background color of the popover\n * @cssproperty --mdc-popover-border-color - border color of the popover\n * @cssproperty --mdc-popover-inverted-background-color - inverted background color of the popover\n * @cssproperty --mdc-popover-inverted-border-color - inverted border color of the popover\n * @cssproperty --mdc-popover-inverted-text-color - inverted text color of the popover\n * @cssproperty --mdc-popover-elevation-3 - elevation of the popover\n * @cssproperty --mdc-popover-max-width - max width of the popover\n * @cssproperty --mdc-popover-max-height - max height of the popover\n * @cssproperty --mdc-popover-width - width of the popover\n *\n * @slot - Default slot for the popover content\n *\n * @csspart popover-close - The close button of the popover.\n * @csspart popover-content - The content of the popover.\n * @csspart popover-hover-bridge - The hover bridge of the popover.\n */",
32803
32803
  "customElement": true
32804
32804
  }
32805
32805
  ],
@@ -32814,6 +32814,26 @@
32814
32814
  }
32815
32815
  ]
32816
32816
  },
32817
+ {
32818
+ "kind": "javascript-module",
32819
+ "path": "components/popover/popover.portal.component.js",
32820
+ "declarations": [
32821
+ {
32822
+ "kind": "variable",
32823
+ "name": "TAG_NAME"
32824
+ }
32825
+ ],
32826
+ "exports": [
32827
+ {
32828
+ "kind": "js",
32829
+ "name": "TAG_NAME",
32830
+ "declaration": {
32831
+ "name": "TAG_NAME",
32832
+ "module": "components/popover/popover.portal.component.js"
32833
+ }
32834
+ }
32835
+ ]
32836
+ },
32817
32837
  {
32818
32838
  "kind": "javascript-module",
32819
32839
  "path": "components/presence/presence.component.js",