@momentum-design/components 0.85.3 → 0.85.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (46) hide show
  1. package/dist/browser/index.js +238 -229
  2. package/dist/browser/index.js.map +4 -4
  3. package/dist/components/alertchip/alertchip.component.d.ts +2 -0
  4. package/dist/components/alertchip/alertchip.component.js +2 -0
  5. package/dist/components/avatar/avatar.component.d.ts +6 -0
  6. package/dist/components/avatar/avatar.component.js +6 -0
  7. package/dist/components/avatarbutton/avatarbutton.component.d.ts +9 -0
  8. package/dist/components/avatarbutton/avatarbutton.component.js +10 -0
  9. package/dist/components/formfieldwrapper/formfieldwrapper.component.d.ts +1 -1
  10. package/dist/components/formfieldwrapper/formfieldwrapper.component.js +1 -1
  11. package/dist/components/icon/icon.component.d.ts +2 -0
  12. package/dist/components/icon/icon.component.js +2 -0
  13. package/dist/components/listitem/listitem.component.d.ts +11 -0
  14. package/dist/components/listitem/listitem.component.js +11 -3
  15. package/dist/components/listitem/listitem.constants.d.ts +2 -2
  16. package/dist/components/listitem/listitem.constants.js +3 -2
  17. package/dist/components/listitem/listitem.styles.js +9 -1
  18. package/dist/components/menubar/menubar.component.d.ts +31 -5
  19. package/dist/components/menubar/menubar.component.js +198 -9
  20. package/dist/components/menubar/menubar.constants.d.ts +3 -4
  21. package/dist/components/menubar/menubar.constants.js +3 -4
  22. package/dist/components/menupopover/menupopover.component.d.ts +1 -0
  23. package/dist/components/menupopover/menupopover.component.js +13 -2
  24. package/dist/components/menupopover/menupopover.constants.d.ts +1 -0
  25. package/dist/components/menupopover/menupopover.constants.js +1 -0
  26. package/dist/components/navitemlist/navitemlist.component.d.ts +1 -2
  27. package/dist/components/navitemlist/navitemlist.component.js +1 -4
  28. package/dist/components/popover/popover.component.js +8 -2
  29. package/dist/custom-elements.json +942 -1997
  30. package/dist/react/alertchip/index.d.ts +2 -0
  31. package/dist/react/alertchip/index.js +2 -0
  32. package/dist/react/avatar/index.d.ts +6 -0
  33. package/dist/react/avatar/index.js +6 -0
  34. package/dist/react/avatarbutton/index.d.ts +9 -0
  35. package/dist/react/avatarbutton/index.js +9 -0
  36. package/dist/react/icon/index.d.ts +2 -0
  37. package/dist/react/icon/index.js +2 -0
  38. package/dist/react/index.d.ts +1 -1
  39. package/dist/react/index.js +1 -1
  40. package/dist/react/menubar/index.d.ts +6 -3
  41. package/dist/react/menubar/index.js +6 -3
  42. package/package.json +1 -1
  43. package/dist/components/menubar/menubar.types.d.ts +0 -4
  44. package/dist/components/menubar/menubar.types.js +0 -1
  45. package/dist/utils/mixins/MenuMixin.d.ts +0 -10
  46. package/dist/utils/mixins/MenuMixin.js +0 -479
@@ -28,6 +28,16 @@
28
28
  "name": "--mdc-chip-background-color"
29
29
  }
30
30
  ],
31
+ "cssParts": [
32
+ {
33
+ "description": "The alert icon",
34
+ "name": "icon"
35
+ },
36
+ {
37
+ "description": "The text label of the alertchip",
38
+ "name": "label"
39
+ }
40
+ ],
31
41
  "members": [
32
42
  {
33
43
  "kind": "field",
@@ -467,7 +477,7 @@
467
477
  "module": "/src/components/buttonsimple/buttonsimple.component"
468
478
  },
469
479
  "tagName": "mdc-alertchip",
470
- "jsDoc": "/**\n * mdc-alertchip component is an interactive chip that consumers can use to represent an alert.\n *\n * - It supports a leading icon along with label.\n * - It supports 5 variants of alerts - neutral, warning, error, success, and informational\n *\n * This component is built by extending Buttonsimple.\n *\n * @tagname mdc-alertchip\n *\n * @dependency mdc-icon\n * @dependency mdc-text\n *\n * @cssproperty --mdc-chip-color - The color of the label text\n * @cssproperty --mdc-chip-icon-color - The color of the icon\n * @cssproperty --mdc-chip-border-color - The border color of the alertchip\n * @cssproperty --mdc-chip-background-color - The background color of the alertchip\n *\n */",
480
+ "jsDoc": "/**\n * mdc-alertchip component is an interactive chip that consumers can use to represent an alert.\n *\n * - It supports a leading icon along with label.\n * - It supports 5 variants of alerts - neutral, warning, error, success, and informational\n *\n * This component is built by extending Buttonsimple.\n *\n * @tagname mdc-alertchip\n *\n * @dependency mdc-icon\n * @dependency mdc-text\n *\n * @cssproperty --mdc-chip-color - The color of the label text\n * @cssproperty --mdc-chip-icon-color - The color of the icon\n * @cssproperty --mdc-chip-border-color - The border color of the alertchip\n * @cssproperty --mdc-chip-background-color - The background color of the alertchip\n *\n * @csspart icon - The alert icon\n * @csspart label - The text label of the alertchip\n */",
471
481
  "customElement": true,
472
482
  "events": [
473
483
  {
@@ -823,266 +833,29 @@
823
833
  "name": "--mdc-avatar-loading-overlay-background-color"
824
834
  }
825
835
  ],
826
- "members": [
827
- {
828
- "kind": "field",
829
- "name": "src",
830
- "type": {
831
- "text": "string | undefined"
832
- },
833
- "description": "The src is the url which will be used to display the avatar.\nWhen the src is loading, we will display the initials as a placeholder.",
834
- "attribute": "src",
835
- "inheritedFrom": {
836
- "name": "AvatarComponentMixin",
837
- "module": "utils/mixins/AvatarComponentMixin.js"
838
- }
839
- },
840
- {
841
- "kind": "field",
842
- "name": "initials",
843
- "type": {
844
- "text": "string | undefined"
845
- },
846
- "description": "The initials to be displayed for the avatar.",
847
- "attribute": "initials",
848
- "inheritedFrom": {
849
- "name": "AvatarComponentMixin",
850
- "module": "utils/mixins/AvatarComponentMixin.js"
851
- }
852
- },
853
- {
854
- "kind": "field",
855
- "name": "presence",
856
- "type": {
857
- "text": "PresenceType | undefined"
858
- },
859
- "description": "The presence is the status which can be used to display the\nactivity state of a user or a space within an avatar component.\n\nAcceptable values include:\n- `active`\n- `away`\n- `away-calling`\n- `busy`\n- `dnd`\n- `meeting`\n- `on-call`\n- `on-device`\n- `on-mobile`\n- `pause`\n- `pto`\n- `presenting`\n- `quiet`\n- `scheduled`",
860
- "attribute": "presence",
861
- "inheritedFrom": {
862
- "name": "AvatarComponentMixin",
863
- "module": "utils/mixins/AvatarComponentMixin.js"
864
- }
865
- },
866
- {
867
- "kind": "field",
868
- "name": "size",
869
- "type": {
870
- "text": "AvatarSize"
871
- },
872
- "description": "Acceptable values include (size in px unit):\n- 24\n- 32\n- 48\n- 64\n- 72\n- 88\n- 124",
873
- "default": "32",
874
- "attribute": "size",
875
- "reflects": true,
876
- "inheritedFrom": {
877
- "name": "AvatarComponentMixin",
878
- "module": "utils/mixins/AvatarComponentMixin.js"
879
- }
880
- },
881
- {
882
- "kind": "field",
883
- "name": "counter",
884
- "type": {
885
- "text": "number | undefined"
886
- },
887
- "description": "The counter is the number which can be displayed on the avatar.\nThe maximum number is 99 and if the given number is greater than 99,\nthen the avatar will be displayed as `99+`.\nIf the given number is a negative number,\nthen the avatar will be displayed as `0`.",
888
- "attribute": "counter",
889
- "inheritedFrom": {
890
- "name": "AvatarComponentMixin",
891
- "module": "utils/mixins/AvatarComponentMixin.js"
892
- }
893
- },
894
- {
895
- "kind": "field",
896
- "name": "isTyping",
897
- "type": {
898
- "text": "boolean"
899
- },
900
- "default": "false",
901
- "description": "Represents the typing indicator when the user is typing.",
902
- "attribute": "is-typing",
903
- "inheritedFrom": {
904
- "name": "AvatarComponentMixin",
905
- "module": "utils/mixins/AvatarComponentMixin.js"
906
- }
907
- },
908
- {
909
- "kind": "field",
910
- "name": "iconName",
911
- "type": {
912
- "text": "IconNames | undefined"
913
- },
914
- "description": "Name of the icon (= filename).\n\nIf no `icon-name` is provided, no icon will be rendered.",
915
- "attribute": "icon-name",
916
- "inheritedFrom": {
917
- "name": "IconNameMixin",
918
- "module": "utils/mixins/IconNameMixin.js"
919
- }
920
- }
921
- ],
922
- "mixins": [
923
- {
924
- "name": "AvatarComponentMixin",
925
- "module": "/src/utils/mixins/AvatarComponentMixin"
926
- },
927
- {
928
- "name": "IconNameMixin",
929
- "module": "/src/utils/mixins/IconNameMixin"
930
- }
931
- ],
932
- "superclass": {
933
- "name": "Component",
934
- "module": "/src/models"
935
- },
936
- "tagName": "mdc-avatar",
937
- "jsDoc": "/**\n * The `mdc-avatar` component is used to represent a person or a space.\n * An avatar can be an icon, initials, counter and photo.\n *\n * To set the photo of an avatar,\n * you need to set \"src\" attribute.\n *\n * While the avatar image is loading, as a placeholder,\n * we will show the initials text.\n * If the initials are not specified then,\n * we will show `user-regular` icon as a placeholder.\n *\n * By default, if there are no attributes specified,\n * then the default avatar will be an icon with `user-regular` name.\n *\n * The avatar component is non clickable and non interactive/focusable component.\n * If the avatar is typing, then the loading indicator will be displayed.\n * If the counter type avatar is set to a negative number, then we will display 0.\n * The presence indicator will be hidden when the counter property is set.\n *\n * @dependency mdc-icon\n * @dependency mdc-presence\n * @dependency mdc-text\n *\n * @tagname mdc-avatar\n *\n * @cssproperty --mdc-avatar-default-background-color - Allows customization of the default background color.\n * @cssproperty --mdc-avatar-default-foreground-color - Allows customization of the default foreground color.\n * @cssproperty --mdc-avatar-loading-indicator-background-color -\n * Allows customization of the loading indicator background color.\n * @cssproperty --mdc-avatar-loading-indicator-foreground-color -\n * Allows customization of the loading indicator foreground color.\n * @cssproperty --mdc-avatar-loading-overlay-background-color -\n * Allows customization of the loading overlay background color.\n */",
938
- "customElement": true,
939
- "attributes": [
940
- {
941
- "name": "src",
942
- "type": {
943
- "text": "string | undefined"
944
- },
945
- "description": "The src is the url which will be used to display the avatar.\nWhen the src is loading, we will display the initials as a placeholder.",
946
- "fieldName": "src",
947
- "inheritedFrom": {
948
- "name": "AvatarComponentMixin",
949
- "module": "src/utils/mixins/AvatarComponentMixin.ts"
950
- }
951
- },
836
+ "cssParts": [
952
837
  {
953
- "name": "initials",
954
- "type": {
955
- "text": "string | undefined"
956
- },
957
- "description": "The initials to be displayed for the avatar.",
958
- "fieldName": "initials",
959
- "inheritedFrom": {
960
- "name": "AvatarComponentMixin",
961
- "module": "src/utils/mixins/AvatarComponentMixin.ts"
962
- }
838
+ "description": "The main content of the avatar.",
839
+ "name": "content"
963
840
  },
964
841
  {
965
- "name": "presence",
966
- "type": {
967
- "text": "PresenceType | undefined"
968
- },
969
- "description": "The presence is the status which can be used to display the\nactivity state of a user or a space within an avatar component.\n\nAcceptable values include:\n- `active`\n- `away`\n- `away-calling`\n- `busy`\n- `dnd`\n- `meeting`\n- `on-call`\n- `on-device`\n- `on-mobile`\n- `pause`\n- `pto`\n- `presenting`\n- `quiet`\n- `scheduled`",
970
- "fieldName": "presence",
971
- "inheritedFrom": {
972
- "name": "AvatarComponentMixin",
973
- "module": "src/utils/mixins/AvatarComponentMixin.ts"
974
- }
842
+ "description": "The photo of the avatar.",
843
+ "name": "photo"
975
844
  },
976
845
  {
977
- "name": "size",
978
- "type": {
979
- "text": "AvatarSize"
980
- },
981
- "description": "Acceptable values include (size in px unit):\n- 24\n- 32\n- 48\n- 64\n- 72\n- 88\n- 124",
982
- "default": "32",
983
- "fieldName": "size",
984
- "inheritedFrom": {
985
- "name": "AvatarComponentMixin",
986
- "module": "src/utils/mixins/AvatarComponentMixin.ts"
987
- }
846
+ "description": "The presence indicator of the avatar.",
847
+ "name": "presence"
988
848
  },
989
849
  {
990
- "name": "counter",
991
- "type": {
992
- "text": "number | undefined"
993
- },
994
- "description": "The counter is the number which can be displayed on the avatar.\nThe maximum number is 99 and if the given number is greater than 99,\nthen the avatar will be displayed as `99+`.\nIf the given number is a negative number,\nthen the avatar will be displayed as `0`.",
995
- "fieldName": "counter",
996
- "inheritedFrom": {
997
- "name": "AvatarComponentMixin",
998
- "module": "src/utils/mixins/AvatarComponentMixin.ts"
999
- }
1000
- },
1001
- {
1002
- "name": "is-typing",
1003
- "type": {
1004
- "text": "boolean"
1005
- },
1006
- "default": "false",
1007
- "description": "Represents the typing indicator when the user is typing.",
1008
- "fieldName": "isTyping",
1009
- "inheritedFrom": {
1010
- "name": "AvatarComponentMixin",
1011
- "module": "src/utils/mixins/AvatarComponentMixin.ts"
1012
- }
850
+ "description": "The wrapper for the loading indicator.",
851
+ "name": "loading-wrapper"
1013
852
  },
1014
853
  {
1015
- "name": "icon-name",
1016
- "type": {
1017
- "text": "IconNames | undefined"
1018
- },
1019
- "description": "Name of the icon (= filename).\n\nIf no `icon-name` is provided, no icon will be rendered.",
1020
- "fieldName": "iconName",
1021
- "inheritedFrom": {
1022
- "name": "IconNameMixin",
1023
- "module": "src/utils/mixins/IconNameMixin.ts"
1024
- }
1025
- }
1026
- ]
1027
- }
1028
- ],
1029
- "exports": [
1030
- {
1031
- "kind": "js",
1032
- "name": "default",
1033
- "declaration": {
1034
- "name": "Avatar",
1035
- "module": "components/avatar/avatar.component.js"
1036
- }
1037
- }
1038
- ]
1039
- },
1040
- {
1041
- "kind": "javascript-module",
1042
- "path": "components/avatarbutton/avatarbutton.component.js",
1043
- "declarations": [
1044
- {
1045
- "kind": "class",
1046
- "description": "The `mdc-avatarbutton` component is an interactable version of the `mdc-avatar` component.\n\nThis component is made by extending `buttonsimple` class.\nThe button component acts as a wrapper for the avatar component.",
1047
- "name": "AvatarButton",
1048
- "cssProperties": [
1049
- {
1050
- "description": "Background color of the overlay in rest state",
1051
- "name": "--mdc-avatarbutton-overlay-background-color-rest"
1052
- },
1053
- {
1054
- "description": "Background color of the overlay in hover state",
1055
- "name": "--mdc-avatarbutton-overlay-background-color-hover"
1056
- },
1057
- {
1058
- "description": "Background color of the overlay in active state",
1059
- "name": "--mdc-avatarbutton-overlay-background-color-active"
854
+ "description": "The loading indicator of the avatar.",
855
+ "name": "loader"
1060
856
  }
1061
857
  ],
1062
858
  "members": [
1063
- {
1064
- "kind": "field",
1065
- "name": "ariaLabel",
1066
- "type": {
1067
- "text": "string | null"
1068
- },
1069
- "default": "null",
1070
- "description": "Aria-label attribute to be set for accessibility",
1071
- "attribute": "aria-label"
1072
- },
1073
- {
1074
- "kind": "method",
1075
- "name": "setSize",
1076
- "privacy": "private",
1077
- "parameters": [
1078
- {
1079
- "name": "size",
1080
- "type": {
1081
- "text": "AvatarSize"
1082
- }
1083
- }
1084
- ]
1085
- },
1086
859
  {
1087
860
  "kind": "field",
1088
861
  "name": "src",
@@ -1126,15 +899,300 @@
1126
899
  "kind": "field",
1127
900
  "name": "size",
1128
901
  "type": {
1129
- "text": "ButtonSize"
902
+ "text": "AvatarSize"
1130
903
  },
1131
904
  "description": "Acceptable values include (size in px unit):\n- 24\n- 32\n- 48\n- 64\n- 72\n- 88\n- 124",
1132
905
  "default": "32",
1133
906
  "attribute": "size",
1134
907
  "reflects": true,
1135
908
  "inheritedFrom": {
1136
- "name": "Buttonsimple",
1137
- "module": "components/buttonsimple/buttonsimple.component.js"
909
+ "name": "AvatarComponentMixin",
910
+ "module": "utils/mixins/AvatarComponentMixin.js"
911
+ }
912
+ },
913
+ {
914
+ "kind": "field",
915
+ "name": "counter",
916
+ "type": {
917
+ "text": "number | undefined"
918
+ },
919
+ "description": "The counter is the number which can be displayed on the avatar.\nThe maximum number is 99 and if the given number is greater than 99,\nthen the avatar will be displayed as `99+`.\nIf the given number is a negative number,\nthen the avatar will be displayed as `0`.",
920
+ "attribute": "counter",
921
+ "inheritedFrom": {
922
+ "name": "AvatarComponentMixin",
923
+ "module": "utils/mixins/AvatarComponentMixin.js"
924
+ }
925
+ },
926
+ {
927
+ "kind": "field",
928
+ "name": "isTyping",
929
+ "type": {
930
+ "text": "boolean"
931
+ },
932
+ "default": "false",
933
+ "description": "Represents the typing indicator when the user is typing.",
934
+ "attribute": "is-typing",
935
+ "inheritedFrom": {
936
+ "name": "AvatarComponentMixin",
937
+ "module": "utils/mixins/AvatarComponentMixin.js"
938
+ }
939
+ },
940
+ {
941
+ "kind": "field",
942
+ "name": "iconName",
943
+ "type": {
944
+ "text": "IconNames | undefined"
945
+ },
946
+ "description": "Name of the icon (= filename).\n\nIf no `icon-name` is provided, no icon will be rendered.",
947
+ "attribute": "icon-name",
948
+ "inheritedFrom": {
949
+ "name": "IconNameMixin",
950
+ "module": "utils/mixins/IconNameMixin.js"
951
+ }
952
+ }
953
+ ],
954
+ "mixins": [
955
+ {
956
+ "name": "AvatarComponentMixin",
957
+ "module": "/src/utils/mixins/AvatarComponentMixin"
958
+ },
959
+ {
960
+ "name": "IconNameMixin",
961
+ "module": "/src/utils/mixins/IconNameMixin"
962
+ }
963
+ ],
964
+ "superclass": {
965
+ "name": "Component",
966
+ "module": "/src/models"
967
+ },
968
+ "tagName": "mdc-avatar",
969
+ "jsDoc": "/**\n * The `mdc-avatar` component is used to represent a person or a space.\n * An avatar can be an icon, initials, counter and photo.\n *\n * To set the photo of an avatar,\n * you need to set \"src\" attribute.\n *\n * While the avatar image is loading, as a placeholder,\n * we will show the initials text.\n * If the initials are not specified then,\n * we will show `user-regular` icon as a placeholder.\n *\n * By default, if there are no attributes specified,\n * then the default avatar will be an icon with `user-regular` name.\n *\n * The avatar component is non clickable and non interactive/focusable component.\n * If the avatar is typing, then the loading indicator will be displayed.\n * If the counter type avatar is set to a negative number, then we will display 0.\n * The presence indicator will be hidden when the counter property is set.\n *\n * @dependency mdc-icon\n * @dependency mdc-presence\n * @dependency mdc-text\n *\n * @tagname mdc-avatar\n *\n * @cssproperty --mdc-avatar-default-background-color - Allows customization of the default background color.\n * @cssproperty --mdc-avatar-default-foreground-color - Allows customization of the default foreground color.\n * @cssproperty --mdc-avatar-loading-indicator-background-color -\n * Allows customization of the loading indicator background color.\n * @cssproperty --mdc-avatar-loading-indicator-foreground-color -\n * Allows customization of the loading indicator foreground color.\n * @cssproperty --mdc-avatar-loading-overlay-background-color -\n * Allows customization of the loading overlay background color.\n *\n * @csspart content - The main content of the avatar.\n * @csspart photo - The photo of the avatar.\n * @csspart presence - The presence indicator of the avatar.\n * @csspart loading-wrapper - The wrapper for the loading indicator.\n * @csspart loader - The loading indicator of the avatar.\n */",
970
+ "customElement": true,
971
+ "attributes": [
972
+ {
973
+ "name": "src",
974
+ "type": {
975
+ "text": "string | undefined"
976
+ },
977
+ "description": "The src is the url which will be used to display the avatar.\nWhen the src is loading, we will display the initials as a placeholder.",
978
+ "fieldName": "src",
979
+ "inheritedFrom": {
980
+ "name": "AvatarComponentMixin",
981
+ "module": "src/utils/mixins/AvatarComponentMixin.ts"
982
+ }
983
+ },
984
+ {
985
+ "name": "initials",
986
+ "type": {
987
+ "text": "string | undefined"
988
+ },
989
+ "description": "The initials to be displayed for the avatar.",
990
+ "fieldName": "initials",
991
+ "inheritedFrom": {
992
+ "name": "AvatarComponentMixin",
993
+ "module": "src/utils/mixins/AvatarComponentMixin.ts"
994
+ }
995
+ },
996
+ {
997
+ "name": "presence",
998
+ "type": {
999
+ "text": "PresenceType | undefined"
1000
+ },
1001
+ "description": "The presence is the status which can be used to display the\nactivity state of a user or a space within an avatar component.\n\nAcceptable values include:\n- `active`\n- `away`\n- `away-calling`\n- `busy`\n- `dnd`\n- `meeting`\n- `on-call`\n- `on-device`\n- `on-mobile`\n- `pause`\n- `pto`\n- `presenting`\n- `quiet`\n- `scheduled`",
1002
+ "fieldName": "presence",
1003
+ "inheritedFrom": {
1004
+ "name": "AvatarComponentMixin",
1005
+ "module": "src/utils/mixins/AvatarComponentMixin.ts"
1006
+ }
1007
+ },
1008
+ {
1009
+ "name": "size",
1010
+ "type": {
1011
+ "text": "AvatarSize"
1012
+ },
1013
+ "description": "Acceptable values include (size in px unit):\n- 24\n- 32\n- 48\n- 64\n- 72\n- 88\n- 124",
1014
+ "default": "32",
1015
+ "fieldName": "size",
1016
+ "inheritedFrom": {
1017
+ "name": "AvatarComponentMixin",
1018
+ "module": "src/utils/mixins/AvatarComponentMixin.ts"
1019
+ }
1020
+ },
1021
+ {
1022
+ "name": "counter",
1023
+ "type": {
1024
+ "text": "number | undefined"
1025
+ },
1026
+ "description": "The counter is the number which can be displayed on the avatar.\nThe maximum number is 99 and if the given number is greater than 99,\nthen the avatar will be displayed as `99+`.\nIf the given number is a negative number,\nthen the avatar will be displayed as `0`.",
1027
+ "fieldName": "counter",
1028
+ "inheritedFrom": {
1029
+ "name": "AvatarComponentMixin",
1030
+ "module": "src/utils/mixins/AvatarComponentMixin.ts"
1031
+ }
1032
+ },
1033
+ {
1034
+ "name": "is-typing",
1035
+ "type": {
1036
+ "text": "boolean"
1037
+ },
1038
+ "default": "false",
1039
+ "description": "Represents the typing indicator when the user is typing.",
1040
+ "fieldName": "isTyping",
1041
+ "inheritedFrom": {
1042
+ "name": "AvatarComponentMixin",
1043
+ "module": "src/utils/mixins/AvatarComponentMixin.ts"
1044
+ }
1045
+ },
1046
+ {
1047
+ "name": "icon-name",
1048
+ "type": {
1049
+ "text": "IconNames | undefined"
1050
+ },
1051
+ "description": "Name of the icon (= filename).\n\nIf no `icon-name` is provided, no icon will be rendered.",
1052
+ "fieldName": "iconName",
1053
+ "inheritedFrom": {
1054
+ "name": "IconNameMixin",
1055
+ "module": "src/utils/mixins/IconNameMixin.ts"
1056
+ }
1057
+ }
1058
+ ]
1059
+ }
1060
+ ],
1061
+ "exports": [
1062
+ {
1063
+ "kind": "js",
1064
+ "name": "default",
1065
+ "declaration": {
1066
+ "name": "Avatar",
1067
+ "module": "components/avatar/avatar.component.js"
1068
+ }
1069
+ }
1070
+ ]
1071
+ },
1072
+ {
1073
+ "kind": "javascript-module",
1074
+ "path": "components/avatarbutton/avatarbutton.component.js",
1075
+ "declarations": [
1076
+ {
1077
+ "kind": "class",
1078
+ "description": "The `mdc-avatarbutton` component is an interactable version of the `mdc-avatar` component.\n\nThis component is made by extending `buttonsimple` class.\nThe button component acts as a wrapper for the avatar component.\n\nTo override styles of the avatar inside, use the specified css parts.",
1079
+ "name": "AvatarButton",
1080
+ "cssProperties": [
1081
+ {
1082
+ "description": "Background color of the overlay in rest state",
1083
+ "name": "--mdc-avatarbutton-overlay-background-color-rest"
1084
+ },
1085
+ {
1086
+ "description": "Background color of the overlay in hover state",
1087
+ "name": "--mdc-avatarbutton-overlay-background-color-hover"
1088
+ },
1089
+ {
1090
+ "description": "Background color of the overlay in active state",
1091
+ "name": "--mdc-avatarbutton-overlay-background-color-active"
1092
+ }
1093
+ ],
1094
+ "cssParts": [
1095
+ {
1096
+ "description": "The overlay part of the avatar button.",
1097
+ "name": "overlay"
1098
+ },
1099
+ {
1100
+ "description": "The main content of the avatar.",
1101
+ "name": "content"
1102
+ },
1103
+ {
1104
+ "description": "The photo part of the avatar.",
1105
+ "name": "photo"
1106
+ },
1107
+ {
1108
+ "description": "The presence indicator part of the avatar.",
1109
+ "name": "presence"
1110
+ },
1111
+ {
1112
+ "description": "The wrapper for the loading indicator of the avatar.",
1113
+ "name": "loading-wrapper"
1114
+ },
1115
+ {
1116
+ "description": "The loading indicator part of the avatar.",
1117
+ "name": "loader"
1118
+ }
1119
+ ],
1120
+ "members": [
1121
+ {
1122
+ "kind": "field",
1123
+ "name": "ariaLabel",
1124
+ "type": {
1125
+ "text": "string | null"
1126
+ },
1127
+ "default": "null",
1128
+ "description": "Aria-label attribute to be set for accessibility",
1129
+ "attribute": "aria-label"
1130
+ },
1131
+ {
1132
+ "kind": "method",
1133
+ "name": "setSize",
1134
+ "privacy": "private",
1135
+ "parameters": [
1136
+ {
1137
+ "name": "size",
1138
+ "type": {
1139
+ "text": "AvatarSize"
1140
+ }
1141
+ }
1142
+ ]
1143
+ },
1144
+ {
1145
+ "kind": "field",
1146
+ "name": "src",
1147
+ "type": {
1148
+ "text": "string | undefined"
1149
+ },
1150
+ "description": "The src is the url which will be used to display the avatar.\nWhen the src is loading, we will display the initials as a placeholder.",
1151
+ "attribute": "src",
1152
+ "inheritedFrom": {
1153
+ "name": "AvatarComponentMixin",
1154
+ "module": "utils/mixins/AvatarComponentMixin.js"
1155
+ }
1156
+ },
1157
+ {
1158
+ "kind": "field",
1159
+ "name": "initials",
1160
+ "type": {
1161
+ "text": "string | undefined"
1162
+ },
1163
+ "description": "The initials to be displayed for the avatar.",
1164
+ "attribute": "initials",
1165
+ "inheritedFrom": {
1166
+ "name": "AvatarComponentMixin",
1167
+ "module": "utils/mixins/AvatarComponentMixin.js"
1168
+ }
1169
+ },
1170
+ {
1171
+ "kind": "field",
1172
+ "name": "presence",
1173
+ "type": {
1174
+ "text": "PresenceType | undefined"
1175
+ },
1176
+ "description": "The presence is the status which can be used to display the\nactivity state of a user or a space within an avatar component.\n\nAcceptable values include:\n- `active`\n- `away`\n- `away-calling`\n- `busy`\n- `dnd`\n- `meeting`\n- `on-call`\n- `on-device`\n- `on-mobile`\n- `pause`\n- `pto`\n- `presenting`\n- `quiet`\n- `scheduled`",
1177
+ "attribute": "presence",
1178
+ "inheritedFrom": {
1179
+ "name": "AvatarComponentMixin",
1180
+ "module": "utils/mixins/AvatarComponentMixin.js"
1181
+ }
1182
+ },
1183
+ {
1184
+ "kind": "field",
1185
+ "name": "size",
1186
+ "type": {
1187
+ "text": "ButtonSize"
1188
+ },
1189
+ "description": "Acceptable values include (size in px unit):\n- 24\n- 32\n- 48\n- 64\n- 72\n- 88\n- 124",
1190
+ "default": "32",
1191
+ "attribute": "size",
1192
+ "reflects": true,
1193
+ "inheritedFrom": {
1194
+ "name": "Buttonsimple",
1195
+ "module": "components/buttonsimple/buttonsimple.component.js"
1138
1196
  }
1139
1197
  },
1140
1198
  {
@@ -1692,7 +1750,7 @@
1692
1750
  "module": "/src/components/buttonsimple/buttonsimple.component"
1693
1751
  },
1694
1752
  "tagName": "mdc-avatarbutton",
1695
- "jsDoc": "/**\n * The `mdc-avatarbutton` component is an interactable version of the `mdc-avatar` component.\n *\n * This component is made by extending `buttonsimple` class.\n * The button component acts as a wrapper for the avatar component.\n *\n * @dependency mdc-avatar\n *\n * @event click - (React: onClick) This event is dispatched when the avatarbutton is clicked.\n * @event keydown - (React: onKeyDown) This event is dispatched when a key is pressed down on the avatarbutton.\n * @event keyup - (React: onKeyUp) This event is dispatched when a key is released on the avatarbutton.\n * @event focus - (React: onFocus) This event is dispatched when the avatarbutton receives focus.\n *\n * @tagname mdc-avatarbutton\n *\n * @cssproperty --mdc-avatarbutton-overlay-background-color-rest - Background color of the overlay in rest state\n * @cssproperty --mdc-avatarbutton-overlay-background-color-hover - Background color of the overlay in hover state\n * @cssproperty --mdc-avatarbutton-overlay-background-color-active - Background color of the overlay in active state\n */",
1753
+ "jsDoc": "/**\n * The `mdc-avatarbutton` component is an interactable version of the `mdc-avatar` component.\n *\n * This component is made by extending `buttonsimple` class.\n * The button component acts as a wrapper for the avatar component.\n *\n * To override styles of the avatar inside, use the specified css parts.\n *\n * @dependency mdc-avatar\n *\n * @event click - (React: onClick) This event is dispatched when the avatarbutton is clicked.\n * @event keydown - (React: onKeyDown) This event is dispatched when a key is pressed down on the avatarbutton.\n * @event keyup - (React: onKeyUp) This event is dispatched when a key is released on the avatarbutton.\n * @event focus - (React: onFocus) This event is dispatched when the avatarbutton receives focus.\n *\n * @tagname mdc-avatarbutton\n *\n * @cssproperty --mdc-avatarbutton-overlay-background-color-rest - Background color of the overlay in rest state\n * @cssproperty --mdc-avatarbutton-overlay-background-color-hover - Background color of the overlay in hover state\n * @cssproperty --mdc-avatarbutton-overlay-background-color-active - Background color of the overlay in active state\n *\n * @csspart overlay - The overlay part of the avatar button.\n * @csspart content - The main content of the avatar.\n * @csspart photo - The photo part of the avatar.\n * @csspart presence - The presence indicator part of the avatar.\n * @csspart loading-wrapper - The wrapper for the loading indicator of the avatar.\n * @csspart loader - The loading indicator part of the avatar.\n */",
1696
1754
  "customElement": true
1697
1755
  }
1698
1756
  ],
@@ -12034,6 +12092,12 @@
12034
12092
  "name": "--mdc-icon-border-radius"
12035
12093
  }
12036
12094
  ],
12095
+ "cssParts": [
12096
+ {
12097
+ "description": "The svg inside the icon element.",
12098
+ "name": "icon"
12099
+ }
12100
+ ],
12037
12101
  "members": [
12038
12102
  {
12039
12103
  "kind": "field",
@@ -12239,7 +12303,7 @@
12239
12303
  "module": "/src/models"
12240
12304
  },
12241
12305
  "tagName": "mdc-icon",
12242
- "jsDoc": "/**\n * Icon component that dynamically displays SVG icons based on a valid name.\n *\n * This component must be mounted within an `IconProvider` component.\n *\n * The `IconProvider` defines the source URL from which icons are consumed.\n * The `Icon` component accepts a `name` attribute, which corresponds to\n * the file name of the icon to be loaded from the specified URL.\n *\n * Once fetched, the icon will be rendered. If the fetching process is unsuccessful,\n * no icon will be displayed.\n *\n * The `size` attribute allows for dynamic sizing of the icon based on the provided\n * `length-unit` attribute. This unit can either come from the `IconProvider`\n * or can be overridden for each individual icon. For example:\n * if `size = 1` and `length-unit = 'em'`, the dimensions of the icon will be\n * `width: 1em; height: 1em`.\n *\n * Regarding accessibility, there are three types of icons: decorative, informative and informative standalone.\n *\n * ### Decorative Icons\n * - Decorative icons do not convey any essential information to the content of a page.\n * - They should be hidden from screen readers (SR) to prevent confusion for users.\n * - For decorative icons, an `aria-label` is not required, and the `role` will be set to null.\n *\n * ### Informative Icons\n * - Informative icons convey important information that is not adequately represented\n * by surrounding text or components.\n * - They provide valuable context and must be announced by assistive technologies.\n * - For informative icons, an `aria-label` is required, and the `role` will be set to \"img\" automatically.\n * - If an `aria-label` is provided, the role will be set to 'img'; if it is absent,\n * the role will be unset.\n *\n * ### Informative Standalone Icons\n * - If an icon is informative (as mentioned above) and does not belong to a button (=standalone), it must\n * have a Tooltip that describes what it means.\n * - For informative standalone icons, an `aria-label` & `tabindex=\"0\"` is required,\n * and the `role` will be set to \"img\" automatically.\n * - **Only use this when a Icon is standalone and is not part of a button or other interactive elements.**\n *\n * @tagname mdc-icon\n *\n * @cssproperty --mdc-icon-fill-color - Allows customization of the default fill color.\n * @cssproperty --mdc-icon-size - Allows customization of the icon size.\n * @cssproperty --mdc-icon-border-radius - Allows customization of the icon border radius.\n */",
12306
+ "jsDoc": "/**\n * Icon component that dynamically displays SVG icons based on a valid name.\n *\n * This component must be mounted within an `IconProvider` component.\n *\n * The `IconProvider` defines the source URL from which icons are consumed.\n * The `Icon` component accepts a `name` attribute, which corresponds to\n * the file name of the icon to be loaded from the specified URL.\n *\n * Once fetched, the icon will be rendered. If the fetching process is unsuccessful,\n * no icon will be displayed.\n *\n * The `size` attribute allows for dynamic sizing of the icon based on the provided\n * `length-unit` attribute. This unit can either come from the `IconProvider`\n * or can be overridden for each individual icon. For example:\n * if `size = 1` and `length-unit = 'em'`, the dimensions of the icon will be\n * `width: 1em; height: 1em`.\n *\n * Regarding accessibility, there are three types of icons: decorative, informative and informative standalone.\n *\n * ### Decorative Icons\n * - Decorative icons do not convey any essential information to the content of a page.\n * - They should be hidden from screen readers (SR) to prevent confusion for users.\n * - For decorative icons, an `aria-label` is not required, and the `role` will be set to null.\n *\n * ### Informative Icons\n * - Informative icons convey important information that is not adequately represented\n * by surrounding text or components.\n * - They provide valuable context and must be announced by assistive technologies.\n * - For informative icons, an `aria-label` is required, and the `role` will be set to \"img\" automatically.\n * - If an `aria-label` is provided, the role will be set to 'img'; if it is absent,\n * the role will be unset.\n *\n * ### Informative Standalone Icons\n * - If an icon is informative (as mentioned above) and does not belong to a button (=standalone), it must\n * have a Tooltip that describes what it means.\n * - For informative standalone icons, an `aria-label` & `tabindex=\"0\"` is required,\n * and the `role` will be set to \"img\" automatically.\n * - **Only use this when a Icon is standalone and is not part of a button or other interactive elements.**\n *\n * @tagname mdc-icon\n *\n * @cssproperty --mdc-icon-fill-color - Allows customization of the default fill color.\n * @cssproperty --mdc-icon-size - Allows customization of the icon size.\n * @cssproperty --mdc-icon-border-radius - Allows customization of the icon border radius.\n *\n * @csspart icon - The svg inside the icon element.\n */",
12243
12307
  "customElement": true
12244
12308
  }
12245
12309
  ],
@@ -14698,6 +14762,17 @@
14698
14762
  "attribute": "subline-text",
14699
14763
  "reflects": true
14700
14764
  },
14765
+ {
14766
+ "kind": "field",
14767
+ "name": "softDisabled",
14768
+ "type": {
14769
+ "text": "boolean | undefined"
14770
+ },
14771
+ "description": "Indicates whether the element is soft disabled.\nWhen set to `true`, the element appears visually disabled but still allows\nfocus, click, and keyboard actions to be passed through.\n\n**Important:** When using soft disabled, consumers must ensure that\nthe element behaves like a disabled element, allowing only focus and\npreventing any interactions (clicks or keyboard actions) from triggering unintended actions.",
14772
+ "default": "undefined",
14773
+ "attribute": "soft-disabled",
14774
+ "reflects": true
14775
+ },
14701
14776
  {
14702
14777
  "kind": "field",
14703
14778
  "name": "tooltipText",
@@ -14825,6 +14900,7 @@
14825
14900
  "parameters": [
14826
14901
  {
14827
14902
  "name": "disabled",
14903
+ "default": "false",
14828
14904
  "type": {
14829
14905
  "text": "boolean"
14830
14906
  },
@@ -14978,6 +15054,15 @@
14978
15054
  "description": "The subline text of the list item.\nThis appears on the trailing side of the list item.",
14979
15055
  "fieldName": "sublineText"
14980
15056
  },
15057
+ {
15058
+ "name": "soft-disabled",
15059
+ "type": {
15060
+ "text": "boolean | undefined"
15061
+ },
15062
+ "description": "Indicates whether the element is soft disabled.\nWhen set to `true`, the element appears visually disabled but still allows\nfocus, click, and keyboard actions to be passed through.\n\n**Important:** When using soft disabled, consumers must ensure that\nthe element behaves like a disabled element, allowing only focus and\npreventing any interactions (clicks or keyboard actions) from triggering unintended actions.",
15063
+ "default": "undefined",
15064
+ "fieldName": "softDisabled"
15065
+ },
14981
15066
  {
14982
15067
  "name": "tooltip-text",
14983
15068
  "type": {
@@ -15129,7 +15214,7 @@
15129
15214
  "declarations": [
15130
15215
  {
15131
15216
  "kind": "class",
15132
- "description": "Menubar is a navigational menu component that provides a horizontal (default) or vertical fixed list of menu items,\nwith support for nested submenus and keyboard navigation. It serves as a container\nfor menu items and manages their interaction patterns, including:\n- Keyboard navigation (arrow keys, Home, End)\n- Menu item activation (Enter/Space)\n- Submenu toggling (Right/Left arrow keys)\n- Focus management\n- Support for both horizontal and vertical orientations\n- Integration with MenuPopover for nested menus\n\nA menubar will contain a set of menu items and their associated popovers.\nEach menu item can have a popover for nested menus.\n\nThe component automatically handles ARIA attributes and follows WAI-ARIA menu design patterns.\nIt works in conjunction with `mdc-menuitem` and `mdc-menupopover` to create accessible menu structures.",
15217
+ "description": "Menubar is a navigational menu component that provides a vertical fixed list of menu items,\nwith support for nested submenus and keyboard navigation. It serves as a container\nfor menu items and manages their interaction patterns, including:\n- Keyboard navigation (Arrow keys, Home, End)\n- Menu item activation (Enter/Space)\n- Submenu toggling (Right/Left arrow keys)\n- Focus management\n- Integration with MenuPopover for nested menus\n\nA menubar will contain a set of menu items and their associated popovers.\nEach menu item can have a popover for nested menus.\n\nThe component automatically handles ARIA attributes and follows WAI-ARIA menu design patterns.\nIt works in conjunction with `mdc-menuitem` and `mdc-menupopover` to create accessible menu structures.\n\n**Note:** A menubar contains three types of menu items, including menuitem, menuitemradio and menuitemcheckbox. These menu items may optionally be nested in one or more group containers. Groups or items may optionally by separated with separator elements.\n\n`mdc-menubar` contains a group that wraps all its chilren passed within the default slot. This has been added to ensure the right accessibility behavior while using screen readers.",
15133
15218
  "name": "MenuBar",
15134
15219
  "slots": [
15135
15220
  {
@@ -15140,227 +15225,60 @@
15140
15225
  "members": [
15141
15226
  {
15142
15227
  "kind": "field",
15143
- "name": "ariaOrientation",
15228
+ "name": "menuItems",
15144
15229
  "type": {
15145
- "text": "Orientation"
15146
- },
15147
- "description": "Defines the orientation of the menu. This value is reflected to\nthe `aria-orientation` attribute and can be either `'horizontal'` or `'vertical'`.",
15148
- "default": "'horizontal'",
15149
- "attribute": "aria-orientation",
15150
- "reflects": true,
15151
- "inheritedFrom": {
15152
- "name": "MenuMixin",
15153
- "module": "utils/mixins/MenuMixin.js"
15154
- }
15155
- },
15156
- {
15157
- "kind": "method",
15158
- "name": "setMenuBarPopoverValue",
15159
- "privacy": "private",
15160
- "parameters": [
15161
- {
15162
- "name": "value",
15163
- "type": {
15164
- "text": "boolean"
15165
- },
15166
- "description": "The value to set."
15167
- }
15168
- ],
15169
- "description": "Sets the value of the data-menu-popover-open attribute on the menu element.",
15170
- "inheritedFrom": {
15171
- "name": "MenuMixin",
15172
- "module": "utils/mixins/MenuMixin.js"
15230
+ "text": "Array<HTMLElement>"
15173
15231
  }
15174
15232
  },
15175
15233
  {
15176
15234
  "kind": "method",
15177
- "name": "isMenuPopoverOpen",
15178
- "privacy": "private",
15179
- "return": {
15180
- "type": {
15181
- "text": "boolean"
15182
- }
15183
- },
15184
- "description": "Returns true if the data-menu-popover-open attribute on the menu element is set to 'true', false otherwise.",
15185
- "inheritedFrom": {
15186
- "name": "MenuMixin",
15187
- "module": "utils/mixins/MenuMixin.js"
15188
- }
15189
- },
15190
- {
15191
- "kind": "method",
15192
- "name": "getCurrentIndex",
15193
- "privacy": "private",
15194
- "return": {
15195
- "type": {
15196
- "text": ""
15197
- }
15198
- },
15199
- "parameters": [
15200
- {
15201
- "name": "target",
15202
- "type": {
15203
- "text": "EventTarget | null"
15204
- },
15205
- "description": "The target element to find the index of."
15206
- }
15207
- ],
15208
- "description": "Returns the index of the given target in the menuItems array.\nIf the target is not a menu item, but a child element of a menu item,\nit returns the index of the parent menu item.",
15209
- "inheritedFrom": {
15210
- "name": "MenuMixin",
15211
- "module": "utils/mixins/MenuMixin.js"
15212
- }
15213
- },
15214
- {
15215
- "kind": "method",
15216
- "name": "updatePopoverPlacementBasedOnOrientation",
15217
- "privacy": "protected",
15218
- "return": {
15219
- "type": {
15220
- "text": "void"
15221
- }
15222
- },
15223
- "description": "Updates the placement of the popover based on the aria-orientation property.",
15224
- "inheritedFrom": {
15225
- "name": "MenuMixin",
15226
- "module": "utils/mixins/MenuMixin.js"
15227
- }
15228
- },
15229
- {
15230
- "kind": "method",
15231
- "name": "updateTabIndexAndFocusNewIndex",
15235
+ "name": "resetTabIndexAndSetActiveTabIndex",
15232
15236
  "privacy": "private",
15233
15237
  "parameters": [
15234
15238
  {
15235
15239
  "name": "menuItems",
15236
15240
  "type": {
15237
15241
  "text": "Array<HTMLElement>"
15238
- },
15239
- "description": "The list of menu items."
15240
- },
15241
- {
15242
- "name": "currentIndex",
15243
- "type": {
15244
- "text": "number"
15245
- },
15246
- "description": "The current index of the focused menu item."
15242
+ }
15247
15243
  },
15248
15244
  {
15249
- "name": "newIndex",
15250
- "type": {
15251
- "text": "number"
15252
- },
15253
- "description": "The index of the new active element in the list."
15254
- }
15255
- ],
15256
- "description": "Updates the tabindex of the current index to -1 and the tabindex of the new index to 0,\neffectively setting the active element. This is used when navigating the menu via keyboard.",
15257
- "inheritedFrom": {
15258
- "name": "MenuMixin",
15259
- "module": "utils/mixins/MenuMixin.js"
15260
- }
15261
- },
15262
- {
15263
- "kind": "method",
15264
- "name": "isValidMenu",
15265
- "privacy": "private",
15266
- "return": {
15267
- "type": {
15268
- "text": ""
15269
- }
15270
- },
15271
- "parameters": [
15272
- {
15273
- "name": "tagName",
15274
- "optional": true,
15275
- "type": {
15276
- "text": "string"
15277
- },
15278
- "description": "The tag name to check."
15279
- }
15280
- ],
15281
- "description": "Checks if the given tag name is a valid menu tag name.",
15282
- "inheritedFrom": {
15283
- "name": "MenuMixin",
15284
- "module": "utils/mixins/MenuMixin.js"
15285
- }
15286
- },
15287
- {
15288
- "kind": "method",
15289
- "name": "isValidNavItemList",
15290
- "privacy": "private",
15291
- "return": {
15292
- "type": {
15293
- "text": ""
15294
- }
15295
- },
15296
- "parameters": [
15297
- {
15298
- "name": "tagName",
15299
- "optional": true,
15300
- "type": {
15301
- "text": "string"
15302
- },
15303
- "description": "The tag name to check."
15245
+ "description": "The index of the new active element in the list.",
15246
+ "name": "newIndex"
15304
15247
  }
15305
15248
  ],
15306
- "description": "Checks if the given tag name is a valid navitemlist tag name.",
15307
- "inheritedFrom": {
15308
- "name": "MenuMixin",
15309
- "module": "utils/mixins/MenuMixin.js"
15310
- }
15249
+ "description": "Resets all list items tabindex to -1 and sets the tabindex of the\nelement at the given index to 0, effectively setting the active\nelement. This is used when navigating the list via keyboard."
15311
15250
  },
15312
15251
  {
15313
15252
  "kind": "method",
15314
- "name": "isValidPopover",
15253
+ "name": "getCurrentIndex",
15315
15254
  "privacy": "private",
15316
15255
  "return": {
15317
15256
  "type": {
15318
- "text": ""
15257
+ "text": "number"
15319
15258
  }
15320
15259
  },
15321
15260
  "parameters": [
15322
15261
  {
15323
- "name": "tagName",
15324
- "optional": true,
15262
+ "name": "target",
15325
15263
  "type": {
15326
- "text": "string"
15327
- },
15328
- "description": "The tag name to check."
15264
+ "text": "EventTarget | null"
15265
+ }
15329
15266
  }
15330
- ],
15331
- "description": "Checks if the given tag name is a valid menu popover tag name.",
15332
- "inheritedFrom": {
15333
- "name": "MenuMixin",
15334
- "module": "utils/mixins/MenuMixin.js"
15335
- }
15267
+ ]
15336
15268
  },
15337
15269
  {
15338
15270
  "kind": "method",
15339
- "name": "openPopover",
15271
+ "name": "updatePopoverPlacement",
15340
15272
  "privacy": "private",
15341
15273
  "return": {
15342
15274
  "type": {
15343
- "text": ""
15344
- }
15345
- },
15346
- "parameters": [
15347
- {
15348
- "name": "index",
15349
- "type": {
15350
- "text": "number"
15351
- },
15352
- "description": "The index of the menu item to open the popover for."
15275
+ "text": "void"
15353
15276
  }
15354
- ],
15355
- "description": "Opens the popover at the given index if it exists.",
15356
- "inheritedFrom": {
15357
- "name": "MenuMixin",
15358
- "module": "utils/mixins/MenuMixin.js"
15359
15277
  }
15360
15278
  },
15361
15279
  {
15362
15280
  "kind": "method",
15363
- "name": "navigateToPrevMenuItem",
15281
+ "name": "updateTabIndexAndFocus",
15364
15282
  "privacy": "private",
15365
15283
  "return": {
15366
15284
  "type": {
@@ -15369,43 +15287,28 @@
15369
15287
  },
15370
15288
  "parameters": [
15371
15289
  {
15372
- "name": "currentIndex",
15290
+ "name": "menuItems",
15373
15291
  "type": {
15374
- "text": "number"
15375
- },
15376
- "description": "The current index of the focused menu item."
15292
+ "text": "HTMLElement[]"
15293
+ }
15377
15294
  },
15378
15295
  {
15379
- "name": "firstMenuIndex",
15296
+ "name": "currentIndex",
15380
15297
  "type": {
15381
15298
  "text": "number"
15382
- },
15383
- "description": "The index of the first menu item."
15299
+ }
15384
15300
  },
15385
15301
  {
15386
- "name": "lastMenuIndex",
15302
+ "name": "newIndex",
15387
15303
  "type": {
15388
15304
  "text": "number"
15389
- },
15390
- "description": "The index of the last menu item."
15391
- },
15392
- {
15393
- "name": "ariaOrientation",
15394
- "type": {
15395
- "text": "Orientation"
15396
- },
15397
- "description": "The orientation of the menu."
15305
+ }
15398
15306
  }
15399
- ],
15400
- "description": "Navigates to the previous menu item and updates the tabindex of the current index\nto -1 and the tabindex of the new index to 0.",
15401
- "inheritedFrom": {
15402
- "name": "MenuMixin",
15403
- "module": "utils/mixins/MenuMixin.js"
15404
- }
15307
+ ]
15405
15308
  },
15406
15309
  {
15407
15310
  "kind": "method",
15408
- "name": "navigateToNextMenuItem",
15311
+ "name": "navigateToMenuItem",
15409
15312
  "privacy": "private",
15410
15313
  "return": {
15411
15314
  "type": {
@@ -15417,72 +15320,23 @@
15417
15320
  "name": "currentIndex",
15418
15321
  "type": {
15419
15322
  "text": "number"
15420
- },
15421
- "description": "The current index of the focused menu item."
15422
- },
15423
- {
15424
- "name": "firstMenuIndex",
15425
- "type": {
15426
- "text": "number"
15427
- },
15428
- "description": "The index of the first menu item."
15429
- },
15430
- {
15431
- "name": "lastMenuIndex",
15432
- "type": {
15433
- "text": "number"
15434
- },
15435
- "description": "The index of the last menu item."
15323
+ }
15436
15324
  },
15437
15325
  {
15438
- "name": "ariaOrientation",
15439
- "type": {
15440
- "text": "Orientation"
15441
- },
15442
- "description": "The orientation of the menu."
15443
- }
15444
- ],
15445
- "description": "Navigates to the next menu item and updates the tabindex of the current index\nto -1 and the tabindex of the new index to 0.",
15446
- "inheritedFrom": {
15447
- "name": "MenuMixin",
15448
- "module": "utils/mixins/MenuMixin.js"
15449
- }
15450
- },
15451
- {
15452
- "kind": "method",
15453
- "name": "getParentMenuItemDetails",
15454
- "privacy": "private",
15455
- "return": {
15456
- "type": {
15457
- "text": ""
15458
- }
15459
- },
15460
- "parameters": [
15461
- {
15462
- "name": "menuChildId",
15326
+ "name": "direction",
15463
15327
  "type": {
15464
- "text": "string"
15465
- },
15466
- "description": "The id of the menu child element."
15328
+ "text": "'prev' | 'next'"
15329
+ }
15467
15330
  },
15468
15331
  {
15469
- "name": "menu",
15470
- "optional": true,
15471
- "type": {
15472
- "text": "HTMLElement | null"
15473
- },
15474
- "description": "The current menu element to start traversing from."
15332
+ "name": "shouldOpenSubmenu",
15333
+ "default": "false"
15475
15334
  }
15476
- ],
15477
- "description": "Returns the parent menu item details for the given menu child id.\nIt recursively traverses up the DOM tree until it finds a menu or menubar element.",
15478
- "inheritedFrom": {
15479
- "name": "MenuMixin",
15480
- "module": "utils/mixins/MenuMixin.js"
15481
- }
15335
+ ]
15482
15336
  },
15483
15337
  {
15484
15338
  "kind": "method",
15485
- "name": "hideAllPopovers",
15339
+ "name": "showSubmenu",
15486
15340
  "privacy": "private",
15487
15341
  "return": {
15488
15342
  "type": {
@@ -15491,275 +15345,161 @@
15491
15345
  },
15492
15346
  "parameters": [
15493
15347
  {
15494
- "name": "menu",
15495
- "optional": true,
15348
+ "name": "triggerId",
15496
15349
  "type": {
15497
- "text": "HTMLElement | null"
15498
- },
15499
- "description": "The current menu element to start traversing from."
15350
+ "text": "string | null"
15351
+ }
15500
15352
  }
15501
- ],
15502
- "description": "Recursively hides all the popovers up the DOM tree until it finds a menu or menubar element.",
15503
- "inheritedFrom": {
15504
- "name": "MenuMixin",
15505
- "module": "utils/mixins/MenuMixin.js"
15506
- }
15353
+ ]
15507
15354
  },
15508
15355
  {
15509
15356
  "kind": "method",
15510
- "name": "navigateToPrevParentMenuItem",
15357
+ "name": "getKeyWithDirectionFix",
15511
15358
  "privacy": "private",
15512
15359
  "return": {
15513
15360
  "type": {
15514
- "text": "void"
15361
+ "text": "string"
15515
15362
  }
15516
15363
  },
15517
15364
  "parameters": [
15518
15365
  {
15519
- "name": "currentIndex",
15520
- "type": {
15521
- "text": "number"
15522
- },
15523
- "description": "The current index of the focused menu item."
15524
- },
15525
- {
15526
- "name": "key",
15366
+ "name": "originalKey",
15527
15367
  "type": {
15528
15368
  "text": "string"
15529
15369
  }
15530
15370
  }
15531
- ],
15532
- "description": "Recursively navigates up the DOM tree until it finds the previous menu item\nand updates the tabindex of the current index to -1 and the tabindex of the new index to 0.\nAlso opens the popover of the previous menu item.",
15533
- "inheritedFrom": {
15534
- "name": "MenuMixin",
15535
- "module": "utils/mixins/MenuMixin.js"
15536
- }
15371
+ ]
15537
15372
  },
15538
15373
  {
15539
15374
  "kind": "method",
15540
- "name": "closePopoverAndNavigateToPrevParentMenuItem",
15375
+ "name": "isTopLevelMenuItem",
15541
15376
  "privacy": "private",
15542
15377
  "return": {
15543
15378
  "type": {
15544
- "text": "void"
15379
+ "text": "boolean"
15545
15380
  }
15546
15381
  },
15547
15382
  "parameters": [
15548
15383
  {
15549
- "name": "currentIndex",
15550
- "type": {
15551
- "text": "number"
15552
- },
15553
- "description": "The current index of the focused menu item."
15554
- },
15555
- {
15556
- "name": "key",
15384
+ "name": "element",
15557
15385
  "type": {
15558
- "text": "string"
15386
+ "text": "HTMLElement"
15559
15387
  }
15560
15388
  }
15561
- ],
15562
- "description": "Closes the current menu popover and navigates to the previous parent menu item.",
15563
- "inheritedFrom": {
15564
- "name": "MenuMixin",
15565
- "module": "utils/mixins/MenuMixin.js"
15566
- }
15389
+ ]
15567
15390
  },
15568
15391
  {
15569
15392
  "kind": "method",
15570
- "name": "getParentMenuContents",
15393
+ "name": "isNestedMenuItem",
15571
15394
  "privacy": "private",
15572
15395
  "return": {
15573
15396
  "type": {
15574
- "text": ""
15397
+ "text": "boolean"
15575
15398
  }
15576
15399
  },
15577
15400
  "parameters": [
15578
15401
  {
15579
- "name": "currentMenuItem",
15402
+ "name": "element",
15580
15403
  "type": {
15581
- "text": "HTMLElement | null"
15582
- },
15583
- "description": "The current menu item to start traversing from."
15404
+ "text": "HTMLElement"
15405
+ }
15584
15406
  }
15585
- ],
15586
- "description": "Gets the parent menu contents of the given current menu item.\nIt recursively traverses up the DOM tree until it finds the parent menu element\nand gets the parent menu item details and the children of the parent menu item.",
15587
- "inheritedFrom": {
15588
- "name": "MenuMixin",
15589
- "module": "utils/mixins/MenuMixin.js"
15590
- }
15407
+ ]
15591
15408
  },
15592
15409
  {
15593
15410
  "kind": "method",
15594
- "name": "openPopoverAndNavigateToNextChildrenMenuItem",
15595
- "privacy": "private",
15596
- "return": {
15597
- "type": {
15598
- "text": "void"
15599
- }
15600
- },
15601
- "parameters": [
15602
- {
15603
- "name": "currentIndex",
15604
- "type": {
15605
- "text": "number"
15606
- },
15607
- "description": "The current index of the focused menu item."
15608
- }
15609
- ],
15610
- "description": "Opens the popover of the next children menu item if there are children.\nIf there are no children, then it closes all popovers recursively and\nnavigates to the next menu item from the menu bar.\nIf the parent menu item does not have any children, then we will go to the next menu item.",
15611
- "inheritedFrom": {
15612
- "name": "MenuMixin",
15613
- "module": "utils/mixins/MenuMixin.js"
15614
- }
15411
+ "name": "closeAllMenuPopovers",
15412
+ "privacy": "private"
15615
15413
  },
15616
15414
  {
15617
15415
  "kind": "method",
15618
- "name": "isValidMenuItem",
15416
+ "name": "crossMenubarNavigationOnLeft",
15619
15417
  "privacy": "private",
15620
15418
  "return": {
15621
15419
  "type": {
15622
- "text": ""
15420
+ "text": "Promise<void>"
15623
15421
  }
15624
15422
  },
15625
15423
  "parameters": [
15626
15424
  {
15627
- "name": "menuItem",
15425
+ "name": "element",
15628
15426
  "type": {
15629
15427
  "text": "HTMLElement"
15630
- },
15631
- "description": "The menu item to check."
15632
- }
15633
- ],
15634
- "description": "Checks if the given menu item is a valid menu item.",
15635
- "inheritedFrom": {
15636
- "name": "MenuMixin",
15637
- "module": "utils/mixins/MenuMixin.js"
15638
- }
15639
- },
15640
- {
15641
- "kind": "method",
15642
- "name": "resetTabIndexAndSetActiveTabIndex",
15643
- "privacy": "private",
15644
- "parameters": [
15645
- {
15646
- "name": "menuItems",
15647
- "type": {
15648
- "text": "Array<HTMLElement>"
15649
15428
  }
15650
- },
15651
- {
15652
- "description": "The index of the new active element in the list.",
15653
- "name": "newIndex"
15654
15429
  }
15655
- ],
15656
- "description": "Resets all list items tabindex to -1 and sets the tabindex of the\nelement at the given index to 0, effectively setting the active\nelement. This is used when navigating the list via keyboard.",
15657
- "inheritedFrom": {
15658
- "name": "MenuMixin",
15659
- "module": "utils/mixins/MenuMixin.js"
15660
- }
15430
+ ]
15661
15431
  },
15662
15432
  {
15663
15433
  "kind": "method",
15664
- "name": "getKeyBasedOnDirection",
15434
+ "name": "crossMenubarNavigationOnRight",
15665
15435
  "privacy": "private",
15666
15436
  "return": {
15667
15437
  "type": {
15668
- "text": ""
15438
+ "text": "Promise<void>"
15669
15439
  }
15670
15440
  },
15671
15441
  "parameters": [
15672
15442
  {
15673
- "name": "originalKey",
15443
+ "name": "element",
15674
15444
  "type": {
15675
- "text": "string"
15676
- },
15677
- "description": "The original key pressed."
15445
+ "text": "HTMLElement"
15446
+ }
15678
15447
  }
15679
- ],
15680
- "description": "Returns the key based on the direction of the document.\nIf the document is in RTL mode and the key is ARROW_LEFT or ARROW_RIGHT,\nit will swap them to maintain the correct navigation direction.",
15681
- "inheritedFrom": {
15682
- "name": "MenuMixin",
15683
- "module": "utils/mixins/MenuMixin.js"
15684
- }
15448
+ ]
15685
15449
  },
15686
15450
  {
15687
15451
  "kind": "method",
15688
- "name": "handleKeyDown",
15689
- "privacy": "protected",
15452
+ "name": "hasSubmenu",
15453
+ "privacy": "private",
15690
15454
  "return": {
15691
15455
  "type": {
15692
- "text": "void"
15456
+ "text": "boolean"
15693
15457
  }
15694
15458
  },
15695
15459
  "parameters": [
15696
15460
  {
15697
- "name": "event",
15461
+ "name": "triggerId",
15698
15462
  "type": {
15699
- "text": "KeyboardEvent"
15700
- },
15701
- "description": "The keyboard event."
15463
+ "text": "string | null"
15464
+ }
15702
15465
  }
15703
- ],
15704
- "description": "Handles the keydown event on the menu bar.\nThe keys are as follows:\n- HOME: Sets focus to the first menu item.\n- END: Sets focus to the last menu item.\n- ARROW_LEFT:\n - If orientation is horizontal, then it navigates to the previous menu item.\n - If orientation is vertical, then it closes the popover of the current menu item and\n navigates to the previous parent menu item.\n- ARROW_RIGHT:\n - If orientation is horizontal, then it navigates to the next menu item.\n - If orientation is vertical, then it opens the popover of the current menu item and\n navigates to the next children menu item.\n- ARROW_UP:\n - If orientation is horizontal, then it opens the popover of the current menu item.\n - If orientation is vertical, then it navigates to the previous menu item.\n- ARROW_DOWN:\n - If orientation is horizontal, then it opens the popover of the current menu item.\n - If orientation is vertical, then it navigates to the next menu item.\n- SPACE:\n- ENTER:\n - If the next element sibling is a menu popover, then it opens the popover of the current\n menu item and navigates to the next children menu item.\n - If the target element is a menu item, then it closes all popovers recursively and\n navigates to the previous parent menu item.\n- ESCAPE:\n - If a popover is already open then we close it and navigate to the parent menu item.\n - If the current menuitem is a child of menubar, then we will set the value of isMenuPopoverOpen to false.,",
15705
- "inheritedFrom": {
15706
- "name": "MenuMixin",
15707
- "module": "utils/mixins/MenuMixin.js"
15708
- }
15466
+ ]
15709
15467
  },
15710
15468
  {
15711
15469
  "kind": "method",
15712
- "name": "closeAllPopoversExceptCurrent",
15470
+ "name": "getParentMenuItemIndex",
15713
15471
  "privacy": "private",
15714
15472
  "return": {
15715
15473
  "type": {
15716
- "text": "void"
15474
+ "text": "number"
15717
15475
  }
15718
15476
  },
15719
15477
  "parameters": [
15720
15478
  {
15721
- "name": "currentIndex",
15479
+ "name": "element",
15722
15480
  "type": {
15723
- "text": "number"
15724
- },
15725
- "description": "The index of the current menu item."
15481
+ "text": "HTMLElement"
15482
+ }
15726
15483
  }
15727
- ],
15728
- "description": "Closes all popovers except the current one.",
15729
- "inheritedFrom": {
15730
- "name": "MenuMixin",
15731
- "module": "utils/mixins/MenuMixin.js"
15732
- }
15484
+ ]
15733
15485
  },
15734
15486
  {
15735
15487
  "kind": "method",
15736
- "name": "handleMouseClick",
15737
- "privacy": "protected",
15488
+ "name": "handleKeyDown",
15489
+ "privacy": "private",
15738
15490
  "return": {
15739
15491
  "type": {
15740
- "text": "void"
15492
+ "text": "Promise<void>"
15741
15493
  }
15742
15494
  },
15743
15495
  "parameters": [
15744
15496
  {
15745
15497
  "name": "event",
15746
15498
  "type": {
15747
- "text": "MouseEvent"
15748
- },
15749
- "description": "The mouse click event."
15499
+ "text": "KeyboardEvent"
15500
+ }
15750
15501
  }
15751
- ],
15752
- "description": "Handles the mouse click event on the menu items.\n- If the menuitem has children, then it opens the popover of the next children menu item.\n- If the menuitem does not have children, then it closes all popovers recursively.",
15753
- "inheritedFrom": {
15754
- "name": "MenuMixin",
15755
- "module": "utils/mixins/MenuMixin.js"
15756
- }
15757
- }
15758
- ],
15759
- "mixins": [
15760
- {
15761
- "name": "MenuMixin",
15762
- "module": "/src/utils/mixins/MenuMixin"
15502
+ ]
15763
15503
  }
15764
15504
  ],
15765
15505
  "superclass": {
@@ -15767,23 +15507,8 @@
15767
15507
  "module": "/src/models"
15768
15508
  },
15769
15509
  "tagName": "mdc-menubar",
15770
- "jsDoc": "/**\n * Menubar is a navigational menu component that provides a horizontal (default) or vertical fixed list of menu items,\n * with support for nested submenus and keyboard navigation. It serves as a container\n * for menu items and manages their interaction patterns, including:\n * - Keyboard navigation (arrow keys, Home, End)\n * - Menu item activation (Enter/Space)\n * - Submenu toggling (Right/Left arrow keys)\n * - Focus management\n * - Support for both horizontal and vertical orientations\n * - Integration with MenuPopover for nested menus\n *\n * A menubar will contain a set of menu items and their associated popovers.\n * Each menu item can have a popover for nested menus.\n *\n * The component automatically handles ARIA attributes and follows WAI-ARIA menu design patterns.\n * It works in conjunction with `mdc-menuitem` and `mdc-menupopover` to create accessible menu structures.\n *\n * @tagname mdc-menubar\n * @slot default - Contains the menu items and their associated popovers\n */",
15771
- "customElement": true,
15772
- "attributes": [
15773
- {
15774
- "name": "aria-orientation",
15775
- "type": {
15776
- "text": "Orientation"
15777
- },
15778
- "description": "Defines the orientation of the menu. This value is reflected to\nthe `aria-orientation` attribute and can be either `'horizontal'` or `'vertical'`.",
15779
- "default": "'horizontal'",
15780
- "fieldName": "ariaOrientation",
15781
- "inheritedFrom": {
15782
- "name": "MenuMixin",
15783
- "module": "src/utils/mixins/MenuMixin.ts"
15784
- }
15785
- }
15786
- ]
15510
+ "jsDoc": "/**\n * Menubar is a navigational menu component that provides a vertical fixed list of menu items,\n * with support for nested submenus and keyboard navigation. It serves as a container\n * for menu items and manages their interaction patterns, including:\n * - Keyboard navigation (Arrow keys, Home, End)\n * - Menu item activation (Enter/Space)\n * - Submenu toggling (Right/Left arrow keys)\n * - Focus management\n * - Integration with MenuPopover for nested menus\n *\n * A menubar will contain a set of menu items and their associated popovers.\n * Each menu item can have a popover for nested menus.\n *\n * The component automatically handles ARIA attributes and follows WAI-ARIA menu design patterns.\n * It works in conjunction with `mdc-menuitem` and `mdc-menupopover` to create accessible menu structures.\n *\n * **Note:** A menubar contains three types of menu items, including menuitem, menuitemradio and menuitemcheckbox. These menu items may optionally be nested in one or more group containers. Groups or items may optionally by separated with separator elements.\n *\n * `mdc-menubar` contains a group that wraps all its chilren passed within the default slot. This has been added to ensure the right accessibility behavior while using screen readers.\n *\n * @tagname mdc-menubar\n * @slot default - Contains the menu items and their associated popovers\n */",
15511
+ "customElement": true
15787
15512
  }
15788
15513
  ],
15789
15514
  "exports": [
@@ -16015,6 +15740,21 @@
16015
15740
  "module": "components/listitem/listitem.component.js"
16016
15741
  }
16017
15742
  },
15743
+ {
15744
+ "kind": "field",
15745
+ "name": "softDisabled",
15746
+ "type": {
15747
+ "text": "boolean | undefined"
15748
+ },
15749
+ "description": "Indicates whether the element is soft disabled.\nWhen set to `true`, the element appears visually disabled but still allows\nfocus, click, and keyboard actions to be passed through.\n\n**Important:** When using soft disabled, consumers must ensure that\nthe element behaves like a disabled element, allowing only focus and\npreventing any interactions (clicks or keyboard actions) from triggering unintended actions.",
15750
+ "default": "undefined",
15751
+ "attribute": "soft-disabled",
15752
+ "reflects": true,
15753
+ "inheritedFrom": {
15754
+ "name": "ListItem",
15755
+ "module": "components/listitem/listitem.component.js"
15756
+ }
15757
+ },
16018
15758
  {
16019
15759
  "kind": "field",
16020
15760
  "name": "tooltipText",
@@ -16150,6 +15890,7 @@
16150
15890
  "parameters": [
16151
15891
  {
16152
15892
  "name": "disabled",
15893
+ "default": "false",
16153
15894
  "type": {
16154
15895
  "text": "boolean"
16155
15896
  },
@@ -16341,6 +16082,19 @@
16341
16082
  "module": "src/components/listitem/listitem.component.ts"
16342
16083
  }
16343
16084
  },
16085
+ {
16086
+ "name": "soft-disabled",
16087
+ "type": {
16088
+ "text": "boolean | undefined"
16089
+ },
16090
+ "description": "Indicates whether the element is soft disabled.\nWhen set to `true`, the element appears visually disabled but still allows\nfocus, click, and keyboard actions to be passed through.\n\n**Important:** When using soft disabled, consumers must ensure that\nthe element behaves like a disabled element, allowing only focus and\npreventing any interactions (clicks or keyboard actions) from triggering unintended actions.",
16091
+ "default": "undefined",
16092
+ "fieldName": "softDisabled",
16093
+ "inheritedFrom": {
16094
+ "name": "ListItem",
16095
+ "module": "src/components/listitem/listitem.component.ts"
16096
+ }
16097
+ },
16344
16098
  {
16345
16099
  "name": "tooltip-text",
16346
16100
  "type": {
@@ -16872,6 +16626,21 @@
16872
16626
  "module": "components/listitem/listitem.component.js"
16873
16627
  }
16874
16628
  },
16629
+ {
16630
+ "kind": "field",
16631
+ "name": "softDisabled",
16632
+ "type": {
16633
+ "text": "boolean | undefined"
16634
+ },
16635
+ "description": "Indicates whether the element is soft disabled.\nWhen set to `true`, the element appears visually disabled but still allows\nfocus, click, and keyboard actions to be passed through.\n\n**Important:** When using soft disabled, consumers must ensure that\nthe element behaves like a disabled element, allowing only focus and\npreventing any interactions (clicks or keyboard actions) from triggering unintended actions.",
16636
+ "default": "undefined",
16637
+ "attribute": "soft-disabled",
16638
+ "reflects": true,
16639
+ "inheritedFrom": {
16640
+ "name": "ListItem",
16641
+ "module": "components/listitem/listitem.component.js"
16642
+ }
16643
+ },
16875
16644
  {
16876
16645
  "kind": "field",
16877
16646
  "name": "tooltipText",
@@ -17007,6 +16776,7 @@
17007
16776
  "parameters": [
17008
16777
  {
17009
16778
  "name": "disabled",
16779
+ "default": "false",
17010
16780
  "type": {
17011
16781
  "text": "boolean"
17012
16782
  },
@@ -17229,6 +16999,19 @@
17229
16999
  "module": "src/components/listitem/listitem.component.ts"
17230
17000
  }
17231
17001
  },
17002
+ {
17003
+ "name": "soft-disabled",
17004
+ "type": {
17005
+ "text": "boolean | undefined"
17006
+ },
17007
+ "description": "Indicates whether the element is soft disabled.\nWhen set to `true`, the element appears visually disabled but still allows\nfocus, click, and keyboard actions to be passed through.\n\n**Important:** When using soft disabled, consumers must ensure that\nthe element behaves like a disabled element, allowing only focus and\npreventing any interactions (clicks or keyboard actions) from triggering unintended actions.",
17008
+ "default": "undefined",
17009
+ "fieldName": "softDisabled",
17010
+ "inheritedFrom": {
17011
+ "name": "ListItem",
17012
+ "module": "src/components/listitem/listitem.component.ts"
17013
+ }
17014
+ },
17232
17015
  {
17233
17016
  "name": "tooltip-text",
17234
17017
  "type": {
@@ -17591,6 +17374,21 @@
17591
17374
  "module": "components/listitem/listitem.component.js"
17592
17375
  }
17593
17376
  },
17377
+ {
17378
+ "kind": "field",
17379
+ "name": "softDisabled",
17380
+ "type": {
17381
+ "text": "boolean | undefined"
17382
+ },
17383
+ "description": "Indicates whether the element is soft disabled.\nWhen set to `true`, the element appears visually disabled but still allows\nfocus, click, and keyboard actions to be passed through.\n\n**Important:** When using soft disabled, consumers must ensure that\nthe element behaves like a disabled element, allowing only focus and\npreventing any interactions (clicks or keyboard actions) from triggering unintended actions.",
17384
+ "default": "undefined",
17385
+ "attribute": "soft-disabled",
17386
+ "reflects": true,
17387
+ "inheritedFrom": {
17388
+ "name": "ListItem",
17389
+ "module": "components/listitem/listitem.component.js"
17390
+ }
17391
+ },
17594
17392
  {
17595
17393
  "kind": "field",
17596
17394
  "name": "tooltipText",
@@ -17726,6 +17524,7 @@
17726
17524
  "parameters": [
17727
17525
  {
17728
17526
  "name": "disabled",
17527
+ "default": "false",
17729
17528
  "type": {
17730
17529
  "text": "boolean"
17731
17530
  },
@@ -17948,6 +17747,19 @@
17948
17747
  "module": "src/components/listitem/listitem.component.ts"
17949
17748
  }
17950
17749
  },
17750
+ {
17751
+ "name": "soft-disabled",
17752
+ "type": {
17753
+ "text": "boolean | undefined"
17754
+ },
17755
+ "description": "Indicates whether the element is soft disabled.\nWhen set to `true`, the element appears visually disabled but still allows\nfocus, click, and keyboard actions to be passed through.\n\n**Important:** When using soft disabled, consumers must ensure that\nthe element behaves like a disabled element, allowing only focus and\npreventing any interactions (clicks or keyboard actions) from triggering unintended actions.",
17756
+ "default": "undefined",
17757
+ "fieldName": "softDisabled",
17758
+ "inheritedFrom": {
17759
+ "name": "ListItem",
17760
+ "module": "src/components/listitem/listitem.component.ts"
17761
+ }
17762
+ },
17951
17763
  {
17952
17764
  "name": "tooltip-text",
17953
17765
  "type": {
@@ -18255,6 +18067,16 @@
18255
18067
  ],
18256
18068
  "description": "Checks if the menu popover has a submenu with the specified trigger ID.\nThis method is used to determine if a menu item has a submenu associated with it,\nwhich is indicated by the presence of a `triggerid` attribute in the submenu popover.\nIt queries the parent element for any popover with the specified trigger ID."
18257
18069
  },
18070
+ {
18071
+ "kind": "field",
18072
+ "name": "togglePopoverVisible",
18073
+ "privacy": "public",
18074
+ "description": "Toggles the popover visibility.",
18075
+ "inheritedFrom": {
18076
+ "name": "Popover",
18077
+ "module": "components/popover/popover.component.js"
18078
+ }
18079
+ },
18258
18080
  {
18259
18081
  "kind": "method",
18260
18082
  "name": "handleMouseClick",
@@ -19432,16 +19254,6 @@
19432
19254
  "module": "components/popover/popover.component.js"
19433
19255
  }
19434
19256
  },
19435
- {
19436
- "kind": "field",
19437
- "name": "togglePopoverVisible",
19438
- "privacy": "public",
19439
- "description": "Toggles the popover visibility.",
19440
- "inheritedFrom": {
19441
- "name": "Popover",
19442
- "module": "components/popover/popover.component.js"
19443
- }
19444
- },
19445
19257
  {
19446
19258
  "kind": "method",
19447
19259
  "name": "positionPopover",
@@ -20515,6 +20327,21 @@
20515
20327
  "module": "components/listitem/listitem.component.js"
20516
20328
  }
20517
20329
  },
20330
+ {
20331
+ "kind": "field",
20332
+ "name": "softDisabled",
20333
+ "type": {
20334
+ "text": "boolean | undefined"
20335
+ },
20336
+ "description": "Indicates whether the element is soft disabled.\nWhen set to `true`, the element appears visually disabled but still allows\nfocus, click, and keyboard actions to be passed through.\n\n**Important:** When using soft disabled, consumers must ensure that\nthe element behaves like a disabled element, allowing only focus and\npreventing any interactions (clicks or keyboard actions) from triggering unintended actions.",
20337
+ "default": "undefined",
20338
+ "attribute": "soft-disabled",
20339
+ "reflects": true,
20340
+ "inheritedFrom": {
20341
+ "name": "ListItem",
20342
+ "module": "components/listitem/listitem.component.js"
20343
+ }
20344
+ },
20518
20345
  {
20519
20346
  "kind": "field",
20520
20347
  "name": "tooltipText",
@@ -20650,6 +20477,7 @@
20650
20477
  "parameters": [
20651
20478
  {
20652
20479
  "name": "disabled",
20480
+ "default": "false",
20653
20481
  "type": {
20654
20482
  "text": "boolean"
20655
20483
  },
@@ -20926,6 +20754,19 @@
20926
20754
  "module": "src/components/listitem/listitem.component.ts"
20927
20755
  }
20928
20756
  },
20757
+ {
20758
+ "name": "soft-disabled",
20759
+ "type": {
20760
+ "text": "boolean | undefined"
20761
+ },
20762
+ "description": "Indicates whether the element is soft disabled.\nWhen set to `true`, the element appears visually disabled but still allows\nfocus, click, and keyboard actions to be passed through.\n\n**Important:** When using soft disabled, consumers must ensure that\nthe element behaves like a disabled element, allowing only focus and\npreventing any interactions (clicks or keyboard actions) from triggering unintended actions.",
20763
+ "default": "undefined",
20764
+ "fieldName": "softDisabled",
20765
+ "inheritedFrom": {
20766
+ "name": "ListItem",
20767
+ "module": "src/components/listitem/listitem.component.ts"
20768
+ }
20769
+ },
20929
20770
  {
20930
20771
  "name": "tooltip-text",
20931
20772
  "type": {
@@ -21077,33 +20918,10 @@
21077
20918
  },
21078
20919
  {
21079
20920
  "kind": "field",
21080
- "name": "ariaOrientation",
20921
+ "name": "menuItems",
21081
20922
  "type": {
21082
- "text": "Orientation"
20923
+ "text": "Array<HTMLElement>"
21083
20924
  },
21084
- "description": "Defines the orientation of the menu. This value is reflected to\nthe `aria-orientation` attribute and can be either `'horizontal'` or `'vertical'`.",
21085
- "default": "'horizontal'",
21086
- "attribute": "aria-orientation",
21087
- "reflects": true,
21088
- "inheritedFrom": {
21089
- "name": "MenuBar",
21090
- "module": "components/menubar/menubar.component.js"
21091
- }
21092
- },
21093
- {
21094
- "kind": "method",
21095
- "name": "setMenuBarPopoverValue",
21096
- "privacy": "private",
21097
- "parameters": [
21098
- {
21099
- "name": "value",
21100
- "type": {
21101
- "text": "boolean"
21102
- },
21103
- "description": "The value to set."
21104
- }
21105
- ],
21106
- "description": "Sets the value of the data-menu-popover-open attribute on the menu element.",
21107
20925
  "inheritedFrom": {
21108
20926
  "name": "MenuBar",
21109
20927
  "module": "components/menubar/menubar.component.js"
@@ -21111,161 +20929,21 @@
21111
20929
  },
21112
20930
  {
21113
20931
  "kind": "method",
21114
- "name": "isMenuPopoverOpen",
21115
- "privacy": "private",
21116
- "return": {
21117
- "type": {
21118
- "text": "boolean"
21119
- }
21120
- },
21121
- "description": "Returns true if the data-menu-popover-open attribute on the menu element is set to 'true', false otherwise.",
21122
- "inheritedFrom": {
21123
- "name": "MenuBar",
21124
- "module": "components/menubar/menubar.component.js"
21125
- }
21126
- },
21127
- {
21128
- "kind": "method",
21129
- "name": "getCurrentIndex",
21130
- "privacy": "private",
21131
- "return": {
21132
- "type": {
21133
- "text": ""
21134
- }
21135
- },
21136
- "parameters": [
21137
- {
21138
- "name": "target",
21139
- "type": {
21140
- "text": "EventTarget | null"
21141
- },
21142
- "description": "The target element to find the index of."
21143
- }
21144
- ],
21145
- "description": "Returns the index of the given target in the menuItems array.\nIf the target is not a menu item, but a child element of a menu item,\nit returns the index of the parent menu item.",
21146
- "inheritedFrom": {
21147
- "name": "MenuBar",
21148
- "module": "components/menubar/menubar.component.js"
21149
- }
21150
- },
21151
- {
21152
- "kind": "method",
21153
- "name": "updatePopoverPlacementBasedOnOrientation",
21154
- "privacy": "protected",
21155
- "return": {
21156
- "type": {
21157
- "text": "void"
21158
- }
21159
- },
21160
- "description": "Updates the placement of the popover based on the aria-orientation property.",
21161
- "inheritedFrom": {
21162
- "name": "MenuBar",
21163
- "module": "components/menubar/menubar.component.js"
21164
- }
21165
- },
21166
- {
21167
- "kind": "method",
21168
- "name": "updateTabIndexAndFocusNewIndex",
20932
+ "name": "resetTabIndexAndSetActiveTabIndex",
21169
20933
  "privacy": "private",
21170
20934
  "parameters": [
21171
20935
  {
21172
20936
  "name": "menuItems",
21173
20937
  "type": {
21174
20938
  "text": "Array<HTMLElement>"
21175
- },
21176
- "description": "The list of menu items."
21177
- },
21178
- {
21179
- "name": "currentIndex",
21180
- "type": {
21181
- "text": "number"
21182
- },
21183
- "description": "The current index of the focused menu item."
20939
+ }
21184
20940
  },
21185
20941
  {
21186
- "name": "newIndex",
21187
- "type": {
21188
- "text": "number"
21189
- },
21190
- "description": "The index of the new active element in the list."
21191
- }
21192
- ],
21193
- "description": "Updates the tabindex of the current index to -1 and the tabindex of the new index to 0,\neffectively setting the active element. This is used when navigating the menu via keyboard.",
21194
- "inheritedFrom": {
21195
- "name": "MenuBar",
21196
- "module": "components/menubar/menubar.component.js"
21197
- }
21198
- },
21199
- {
21200
- "kind": "method",
21201
- "name": "isValidMenu",
21202
- "privacy": "private",
21203
- "return": {
21204
- "type": {
21205
- "text": ""
21206
- }
21207
- },
21208
- "parameters": [
21209
- {
21210
- "name": "tagName",
21211
- "optional": true,
21212
- "type": {
21213
- "text": "string"
21214
- },
21215
- "description": "The tag name to check."
21216
- }
21217
- ],
21218
- "description": "Checks if the given tag name is a valid menu tag name.",
21219
- "inheritedFrom": {
21220
- "name": "MenuBar",
21221
- "module": "components/menubar/menubar.component.js"
21222
- }
21223
- },
21224
- {
21225
- "kind": "method",
21226
- "name": "isValidNavItemList",
21227
- "privacy": "private",
21228
- "return": {
21229
- "type": {
21230
- "text": ""
21231
- }
21232
- },
21233
- "parameters": [
21234
- {
21235
- "name": "tagName",
21236
- "optional": true,
21237
- "type": {
21238
- "text": "string"
21239
- },
21240
- "description": "The tag name to check."
21241
- }
21242
- ],
21243
- "description": "Checks if the given tag name is a valid navitemlist tag name.",
21244
- "inheritedFrom": {
21245
- "name": "MenuBar",
21246
- "module": "components/menubar/menubar.component.js"
21247
- }
21248
- },
21249
- {
21250
- "kind": "method",
21251
- "name": "isValidPopover",
21252
- "privacy": "private",
21253
- "return": {
21254
- "type": {
21255
- "text": ""
21256
- }
21257
- },
21258
- "parameters": [
21259
- {
21260
- "name": "tagName",
21261
- "optional": true,
21262
- "type": {
21263
- "text": "string"
21264
- },
21265
- "description": "The tag name to check."
20942
+ "description": "The index of the new active element in the list.",
20943
+ "name": "newIndex"
21266
20944
  }
21267
20945
  ],
21268
- "description": "Checks if the given tag name is a valid menu popover tag name.",
20946
+ "description": "Resets all list items tabindex to -1 and sets the tabindex of the\nelement at the given index to 0, effectively setting the active\nelement. This is used when navigating the list via keyboard.",
21269
20947
  "inheritedFrom": {
21270
20948
  "name": "MenuBar",
21271
20949
  "module": "components/menubar/menubar.component.js"
@@ -21273,23 +20951,21 @@
21273
20951
  },
21274
20952
  {
21275
20953
  "kind": "method",
21276
- "name": "openPopover",
20954
+ "name": "getCurrentIndex",
21277
20955
  "privacy": "private",
21278
20956
  "return": {
21279
20957
  "type": {
21280
- "text": ""
20958
+ "text": "number"
21281
20959
  }
21282
20960
  },
21283
20961
  "parameters": [
21284
20962
  {
21285
- "name": "index",
20963
+ "name": "target",
21286
20964
  "type": {
21287
- "text": "number"
21288
- },
21289
- "description": "The index of the menu item to open the popover for."
20965
+ "text": "EventTarget | null"
20966
+ }
21290
20967
  }
21291
20968
  ],
21292
- "description": "Opens the popover at the given index if it exists.",
21293
20969
  "inheritedFrom": {
21294
20970
  "name": "MenuBar",
21295
20971
  "module": "components/menubar/menubar.component.js"
@@ -21297,44 +20973,13 @@
21297
20973
  },
21298
20974
  {
21299
20975
  "kind": "method",
21300
- "name": "navigateToPrevMenuItem",
20976
+ "name": "updatePopoverPlacement",
21301
20977
  "privacy": "private",
21302
20978
  "return": {
21303
20979
  "type": {
21304
20980
  "text": "void"
21305
20981
  }
21306
20982
  },
21307
- "parameters": [
21308
- {
21309
- "name": "currentIndex",
21310
- "type": {
21311
- "text": "number"
21312
- },
21313
- "description": "The current index of the focused menu item."
21314
- },
21315
- {
21316
- "name": "firstMenuIndex",
21317
- "type": {
21318
- "text": "number"
21319
- },
21320
- "description": "The index of the first menu item."
21321
- },
21322
- {
21323
- "name": "lastMenuIndex",
21324
- "type": {
21325
- "text": "number"
21326
- },
21327
- "description": "The index of the last menu item."
21328
- },
21329
- {
21330
- "name": "ariaOrientation",
21331
- "type": {
21332
- "text": "Orientation"
21333
- },
21334
- "description": "The orientation of the menu."
21335
- }
21336
- ],
21337
- "description": "Navigates to the previous menu item and updates the tabindex of the current index\nto -1 and the tabindex of the new index to 0.",
21338
20983
  "inheritedFrom": {
21339
20984
  "name": "MenuBar",
21340
20985
  "module": "components/menubar/menubar.component.js"
@@ -21342,7 +20987,7 @@
21342
20987
  },
21343
20988
  {
21344
20989
  "kind": "method",
21345
- "name": "navigateToNextMenuItem",
20990
+ "name": "updateTabIndexAndFocus",
21346
20991
  "privacy": "private",
21347
20992
  "return": {
21348
20993
  "type": {
@@ -21351,122 +20996,24 @@
21351
20996
  },
21352
20997
  "parameters": [
21353
20998
  {
21354
- "name": "currentIndex",
21355
- "type": {
21356
- "text": "number"
21357
- },
21358
- "description": "The current index of the focused menu item."
21359
- },
21360
- {
21361
- "name": "firstMenuIndex",
21362
- "type": {
21363
- "text": "number"
21364
- },
21365
- "description": "The index of the first menu item."
21366
- },
21367
- {
21368
- "name": "lastMenuIndex",
21369
- "type": {
21370
- "text": "number"
21371
- },
21372
- "description": "The index of the last menu item."
21373
- },
21374
- {
21375
- "name": "ariaOrientation",
21376
- "type": {
21377
- "text": "Orientation"
21378
- },
21379
- "description": "The orientation of the menu."
21380
- }
21381
- ],
21382
- "description": "Navigates to the next menu item and updates the tabindex of the current index\nto -1 and the tabindex of the new index to 0.",
21383
- "inheritedFrom": {
21384
- "name": "MenuBar",
21385
- "module": "components/menubar/menubar.component.js"
21386
- }
21387
- },
21388
- {
21389
- "kind": "method",
21390
- "name": "getParentMenuItemDetails",
21391
- "privacy": "private",
21392
- "return": {
21393
- "type": {
21394
- "text": ""
21395
- }
21396
- },
21397
- "parameters": [
21398
- {
21399
- "name": "menuChildId",
20999
+ "name": "menuItems",
21400
21000
  "type": {
21401
- "text": "string"
21402
- },
21403
- "description": "The id of the menu child element."
21001
+ "text": "HTMLElement[]"
21002
+ }
21404
21003
  },
21405
- {
21406
- "name": "menu",
21407
- "optional": true,
21408
- "type": {
21409
- "text": "HTMLElement | null"
21410
- },
21411
- "description": "The current menu element to start traversing from."
21412
- }
21413
- ],
21414
- "description": "Returns the parent menu item details for the given menu child id.\nIt recursively traverses up the DOM tree until it finds a menu or menubar element.",
21415
- "inheritedFrom": {
21416
- "name": "MenuBar",
21417
- "module": "components/menubar/menubar.component.js"
21418
- }
21419
- },
21420
- {
21421
- "kind": "method",
21422
- "name": "hideAllPopovers",
21423
- "privacy": "private",
21424
- "return": {
21425
- "type": {
21426
- "text": "void"
21427
- }
21428
- },
21429
- "parameters": [
21430
- {
21431
- "name": "menu",
21432
- "optional": true,
21433
- "type": {
21434
- "text": "HTMLElement | null"
21435
- },
21436
- "description": "The current menu element to start traversing from."
21437
- }
21438
- ],
21439
- "description": "Recursively hides all the popovers up the DOM tree until it finds a menu or menubar element.",
21440
- "inheritedFrom": {
21441
- "name": "MenuBar",
21442
- "module": "components/menubar/menubar.component.js"
21443
- }
21444
- },
21445
- {
21446
- "kind": "method",
21447
- "name": "navigateToPrevParentMenuItem",
21448
- "privacy": "private",
21449
- "return": {
21450
- "type": {
21451
- "text": "void"
21452
- }
21453
- },
21454
- "parameters": [
21455
21004
  {
21456
21005
  "name": "currentIndex",
21457
21006
  "type": {
21458
21007
  "text": "number"
21459
- },
21460
- "description": "The current index of the focused menu item."
21008
+ }
21461
21009
  },
21462
21010
  {
21463
- "name": "key",
21011
+ "name": "newIndex",
21464
21012
  "type": {
21465
- "text": "string"
21013
+ "text": "number"
21466
21014
  }
21467
21015
  }
21468
21016
  ],
21469
- "description": "Recursively navigates up the DOM tree until it finds the previous menu item\nand updates the tabindex of the current index to -1 and the tabindex of the new index to 0.\nAlso opens the popover of the previous menu item.",
21470
21017
  "inheritedFrom": {
21471
21018
  "name": "MenuBar",
21472
21019
  "module": "components/menubar/menubar.component.js"
@@ -21474,7 +21021,7 @@
21474
21021
  },
21475
21022
  {
21476
21023
  "kind": "method",
21477
- "name": "closePopoverAndNavigateToPrevParentMenuItem",
21024
+ "name": "navigateToMenuItem",
21478
21025
  "privacy": "private",
21479
21026
  "return": {
21480
21027
  "type": {
@@ -21486,17 +21033,19 @@
21486
21033
  "name": "currentIndex",
21487
21034
  "type": {
21488
21035
  "text": "number"
21489
- },
21490
- "description": "The current index of the focused menu item."
21036
+ }
21491
21037
  },
21492
21038
  {
21493
- "name": "key",
21039
+ "name": "direction",
21494
21040
  "type": {
21495
- "text": "string"
21041
+ "text": "'prev' | 'next'"
21496
21042
  }
21043
+ },
21044
+ {
21045
+ "name": "shouldOpenSubmenu",
21046
+ "default": "false"
21497
21047
  }
21498
21048
  ],
21499
- "description": "Closes the current menu popover and navigates to the previous parent menu item.",
21500
21049
  "inheritedFrom": {
21501
21050
  "name": "MenuBar",
21502
21051
  "module": "components/menubar/menubar.component.js"
@@ -21504,23 +21053,21 @@
21504
21053
  },
21505
21054
  {
21506
21055
  "kind": "method",
21507
- "name": "getParentMenuContents",
21056
+ "name": "showSubmenu",
21508
21057
  "privacy": "private",
21509
21058
  "return": {
21510
21059
  "type": {
21511
- "text": ""
21060
+ "text": "void"
21512
21061
  }
21513
21062
  },
21514
21063
  "parameters": [
21515
21064
  {
21516
- "name": "currentMenuItem",
21065
+ "name": "triggerId",
21517
21066
  "type": {
21518
- "text": "HTMLElement | null"
21519
- },
21520
- "description": "The current menu item to start traversing from."
21067
+ "text": "string | null"
21068
+ }
21521
21069
  }
21522
21070
  ],
21523
- "description": "Gets the parent menu contents of the given current menu item.\nIt recursively traverses up the DOM tree until it finds the parent menu element\nand gets the parent menu item details and the children of the parent menu item.",
21524
21071
  "inheritedFrom": {
21525
21072
  "name": "MenuBar",
21526
21073
  "module": "components/menubar/menubar.component.js"
@@ -21528,23 +21075,21 @@
21528
21075
  },
21529
21076
  {
21530
21077
  "kind": "method",
21531
- "name": "openPopoverAndNavigateToNextChildrenMenuItem",
21078
+ "name": "getKeyWithDirectionFix",
21532
21079
  "privacy": "private",
21533
21080
  "return": {
21534
21081
  "type": {
21535
- "text": "void"
21082
+ "text": "string"
21536
21083
  }
21537
21084
  },
21538
21085
  "parameters": [
21539
21086
  {
21540
- "name": "currentIndex",
21087
+ "name": "originalKey",
21541
21088
  "type": {
21542
- "text": "number"
21543
- },
21544
- "description": "The current index of the focused menu item."
21089
+ "text": "string"
21090
+ }
21545
21091
  }
21546
21092
  ],
21547
- "description": "Opens the popover of the next children menu item if there are children.\nIf there are no children, then it closes all popovers recursively and\nnavigates to the next menu item from the menu bar.\nIf the parent menu item does not have any children, then we will go to the next menu item.",
21548
21093
  "inheritedFrom": {
21549
21094
  "name": "MenuBar",
21550
21095
  "module": "components/menubar/menubar.component.js"
@@ -21552,23 +21097,21 @@
21552
21097
  },
21553
21098
  {
21554
21099
  "kind": "method",
21555
- "name": "isValidMenuItem",
21100
+ "name": "isTopLevelMenuItem",
21556
21101
  "privacy": "private",
21557
21102
  "return": {
21558
21103
  "type": {
21559
- "text": ""
21104
+ "text": "boolean"
21560
21105
  }
21561
21106
  },
21562
21107
  "parameters": [
21563
21108
  {
21564
- "name": "menuItem",
21109
+ "name": "element",
21565
21110
  "type": {
21566
21111
  "text": "HTMLElement"
21567
- },
21568
- "description": "The menu item to check."
21112
+ }
21569
21113
  }
21570
21114
  ],
21571
- "description": "Checks if the given menu item is a valid menu item.",
21572
21115
  "inheritedFrom": {
21573
21116
  "name": "MenuBar",
21574
21117
  "module": "components/menubar/menubar.component.js"
@@ -21576,21 +21119,52 @@
21576
21119
  },
21577
21120
  {
21578
21121
  "kind": "method",
21579
- "name": "resetTabIndexAndSetActiveTabIndex",
21122
+ "name": "isNestedMenuItem",
21580
21123
  "privacy": "private",
21124
+ "return": {
21125
+ "type": {
21126
+ "text": "boolean"
21127
+ }
21128
+ },
21581
21129
  "parameters": [
21582
21130
  {
21583
- "name": "menuItems",
21131
+ "name": "element",
21584
21132
  "type": {
21585
- "text": "Array<HTMLElement>"
21133
+ "text": "HTMLElement"
21586
21134
  }
21587
- },
21135
+ }
21136
+ ],
21137
+ "inheritedFrom": {
21138
+ "name": "MenuBar",
21139
+ "module": "components/menubar/menubar.component.js"
21140
+ }
21141
+ },
21142
+ {
21143
+ "kind": "method",
21144
+ "name": "closeAllMenuPopovers",
21145
+ "privacy": "private",
21146
+ "inheritedFrom": {
21147
+ "name": "MenuBar",
21148
+ "module": "components/menubar/menubar.component.js"
21149
+ }
21150
+ },
21151
+ {
21152
+ "kind": "method",
21153
+ "name": "crossMenubarNavigationOnLeft",
21154
+ "privacy": "private",
21155
+ "return": {
21156
+ "type": {
21157
+ "text": "Promise<void>"
21158
+ }
21159
+ },
21160
+ "parameters": [
21588
21161
  {
21589
- "description": "The index of the new active element in the list.",
21590
- "name": "newIndex"
21162
+ "name": "element",
21163
+ "type": {
21164
+ "text": "HTMLElement"
21165
+ }
21591
21166
  }
21592
21167
  ],
21593
- "description": "Resets all list items tabindex to -1 and sets the tabindex of the\nelement at the given index to 0, effectively setting the active\nelement. This is used when navigating the list via keyboard.",
21594
21168
  "inheritedFrom": {
21595
21169
  "name": "MenuBar",
21596
21170
  "module": "components/menubar/menubar.component.js"
@@ -21598,23 +21172,21 @@
21598
21172
  },
21599
21173
  {
21600
21174
  "kind": "method",
21601
- "name": "getKeyBasedOnDirection",
21175
+ "name": "crossMenubarNavigationOnRight",
21602
21176
  "privacy": "private",
21603
21177
  "return": {
21604
21178
  "type": {
21605
- "text": ""
21179
+ "text": "Promise<void>"
21606
21180
  }
21607
21181
  },
21608
21182
  "parameters": [
21609
21183
  {
21610
- "name": "originalKey",
21184
+ "name": "element",
21611
21185
  "type": {
21612
- "text": "string"
21613
- },
21614
- "description": "The original key pressed."
21186
+ "text": "HTMLElement"
21187
+ }
21615
21188
  }
21616
21189
  ],
21617
- "description": "Returns the key based on the direction of the document.\nIf the document is in RTL mode and the key is ARROW_LEFT or ARROW_RIGHT,\nit will swap them to maintain the correct navigation direction.",
21618
21190
  "inheritedFrom": {
21619
21191
  "name": "MenuBar",
21620
21192
  "module": "components/menubar/menubar.component.js"
@@ -21622,23 +21194,21 @@
21622
21194
  },
21623
21195
  {
21624
21196
  "kind": "method",
21625
- "name": "handleKeyDown",
21626
- "privacy": "protected",
21197
+ "name": "hasSubmenu",
21198
+ "privacy": "private",
21627
21199
  "return": {
21628
21200
  "type": {
21629
- "text": "void"
21201
+ "text": "boolean"
21630
21202
  }
21631
21203
  },
21632
21204
  "parameters": [
21633
21205
  {
21634
- "name": "event",
21206
+ "name": "triggerId",
21635
21207
  "type": {
21636
- "text": "KeyboardEvent"
21637
- },
21638
- "description": "The keyboard event."
21208
+ "text": "string | null"
21209
+ }
21639
21210
  }
21640
21211
  ],
21641
- "description": "Handles the keydown event on the menu bar.\nThe keys are as follows:\n- HOME: Sets focus to the first menu item.\n- END: Sets focus to the last menu item.\n- ARROW_LEFT:\n - If orientation is horizontal, then it navigates to the previous menu item.\n - If orientation is vertical, then it closes the popover of the current menu item and\n navigates to the previous parent menu item.\n- ARROW_RIGHT:\n - If orientation is horizontal, then it navigates to the next menu item.\n - If orientation is vertical, then it opens the popover of the current menu item and\n navigates to the next children menu item.\n- ARROW_UP:\n - If orientation is horizontal, then it opens the popover of the current menu item.\n - If orientation is vertical, then it navigates to the previous menu item.\n- ARROW_DOWN:\n - If orientation is horizontal, then it opens the popover of the current menu item.\n - If orientation is vertical, then it navigates to the next menu item.\n- SPACE:\n- ENTER:\n - If the next element sibling is a menu popover, then it opens the popover of the current\n menu item and navigates to the next children menu item.\n - If the target element is a menu item, then it closes all popovers recursively and\n navigates to the previous parent menu item.\n- ESCAPE:\n - If a popover is already open then we close it and navigate to the parent menu item.\n - If the current menuitem is a child of menubar, then we will set the value of isMenuPopoverOpen to false.,",
21642
21212
  "inheritedFrom": {
21643
21213
  "name": "MenuBar",
21644
21214
  "module": "components/menubar/menubar.component.js"
@@ -21646,23 +21216,21 @@
21646
21216
  },
21647
21217
  {
21648
21218
  "kind": "method",
21649
- "name": "closeAllPopoversExceptCurrent",
21219
+ "name": "getParentMenuItemIndex",
21650
21220
  "privacy": "private",
21651
21221
  "return": {
21652
21222
  "type": {
21653
- "text": "void"
21223
+ "text": "number"
21654
21224
  }
21655
21225
  },
21656
21226
  "parameters": [
21657
21227
  {
21658
- "name": "currentIndex",
21228
+ "name": "element",
21659
21229
  "type": {
21660
- "text": "number"
21661
- },
21662
- "description": "The index of the current menu item."
21230
+ "text": "HTMLElement"
21231
+ }
21663
21232
  }
21664
21233
  ],
21665
- "description": "Closes all popovers except the current one.",
21666
21234
  "inheritedFrom": {
21667
21235
  "name": "MenuBar",
21668
21236
  "module": "components/menubar/menubar.component.js"
@@ -21670,23 +21238,21 @@
21670
21238
  },
21671
21239
  {
21672
21240
  "kind": "method",
21673
- "name": "handleMouseClick",
21674
- "privacy": "protected",
21241
+ "name": "handleKeyDown",
21242
+ "privacy": "private",
21675
21243
  "return": {
21676
21244
  "type": {
21677
- "text": "void"
21245
+ "text": "Promise<void>"
21678
21246
  }
21679
21247
  },
21680
21248
  "parameters": [
21681
21249
  {
21682
21250
  "name": "event",
21683
21251
  "type": {
21684
- "text": "MouseEvent"
21685
- },
21686
- "description": "The mouse click event."
21252
+ "text": "KeyboardEvent"
21253
+ }
21687
21254
  }
21688
21255
  ],
21689
- "description": "Handles the mouse click event on the menu items.\n- If the menuitem has children, then it opens the popover of the next children menu item.\n- If the menuitem does not have children, then it closes all popovers recursively.",
21690
21256
  "inheritedFrom": {
21691
21257
  "name": "MenuBar",
21692
21258
  "module": "components/menubar/menubar.component.js"
@@ -21702,25 +21268,6 @@
21702
21268
  "default": "null",
21703
21269
  "description": "Aria-label attribute to be set for accessibility",
21704
21270
  "fieldName": "ariaLabel"
21705
- },
21706
- {
21707
- "name": "aria-orientation",
21708
- "type": {
21709
- "text": "Orientation"
21710
- },
21711
- "description": "Defines the orientation of the menu. This value is reflected to\nthe `aria-orientation` attribute and can be either `'horizontal'` or `'vertical'`.",
21712
- "default": "'horizontal'",
21713
- "fieldName": "ariaOrientation",
21714
- "inheritedFrom": {
21715
- "name": "MenuBar",
21716
- "module": "src/components/menubar/menubar.component.ts"
21717
- }
21718
- }
21719
- ],
21720
- "mixins": [
21721
- {
21722
- "name": "MenuMixin",
21723
- "module": "/src/utils/mixins/MenuMixin"
21724
21271
  }
21725
21272
  ],
21726
21273
  "superclass": {
@@ -22205,6 +21752,21 @@
22205
21752
  "module": "components/listitem/listitem.component.js"
22206
21753
  }
22207
21754
  },
21755
+ {
21756
+ "kind": "field",
21757
+ "name": "softDisabled",
21758
+ "type": {
21759
+ "text": "boolean | undefined"
21760
+ },
21761
+ "description": "Indicates whether the element is soft disabled.\nWhen set to `true`, the element appears visually disabled but still allows\nfocus, click, and keyboard actions to be passed through.\n\n**Important:** When using soft disabled, consumers must ensure that\nthe element behaves like a disabled element, allowing only focus and\npreventing any interactions (clicks or keyboard actions) from triggering unintended actions.",
21762
+ "default": "undefined",
21763
+ "attribute": "soft-disabled",
21764
+ "reflects": true,
21765
+ "inheritedFrom": {
21766
+ "name": "ListItem",
21767
+ "module": "components/listitem/listitem.component.js"
21768
+ }
21769
+ },
22208
21770
  {
22209
21771
  "kind": "field",
22210
21772
  "name": "tooltipText",
@@ -22364,6 +21926,7 @@
22364
21926
  "parameters": [
22365
21927
  {
22366
21928
  "name": "disabled",
21929
+ "default": "false",
22367
21930
  "type": {
22368
21931
  "text": "boolean"
22369
21932
  },
@@ -22633,6 +22196,19 @@
22633
22196
  "module": "src/components/listitem/listitem.component.ts"
22634
22197
  }
22635
22198
  },
22199
+ {
22200
+ "name": "soft-disabled",
22201
+ "type": {
22202
+ "text": "boolean | undefined"
22203
+ },
22204
+ "description": "Indicates whether the element is soft disabled.\nWhen set to `true`, the element appears visually disabled but still allows\nfocus, click, and keyboard actions to be passed through.\n\n**Important:** When using soft disabled, consumers must ensure that\nthe element behaves like a disabled element, allowing only focus and\npreventing any interactions (clicks or keyboard actions) from triggering unintended actions.",
22205
+ "default": "undefined",
22206
+ "fieldName": "softDisabled",
22207
+ "inheritedFrom": {
22208
+ "name": "ListItem",
22209
+ "module": "src/components/listitem/listitem.component.ts"
22210
+ }
22211
+ },
22636
22212
  {
22637
22213
  "name": "tooltip-text",
22638
22214
  "type": {
@@ -24299,144 +23875,96 @@
24299
23875
  },
24300
23876
  {
24301
23877
  "kind": "javascript-module",
24302
- "path": "components/progressspinner/progressspinner.component.js",
23878
+ "path": "components/progressbar/progressbar.component.js",
24303
23879
  "declarations": [
24304
23880
  {
24305
23881
  "kind": "class",
24306
- "description": "`mdc-progressspinner` is a customizable, circular progress indicator component.\nIt visually represents the current completion state of a process, such as loading,\nsyncing, uploading, or any ongoing task that has a measurable percentage.\n\nThe spinner is built using SVG with two concentric `<circle>` elements:\n- The `progress` arc represents the portion of work completed.\n- The `track` arc represents the remaining part.\n\nA visual gap is maintained between the progress and track arcs to clearly\ndistinguish the two segments. The component smoothly animates arc length\nand respects accessibility best practices with ARIA attributes.\n\nThe component supports different states:\n- **Default**: Circular spinner shows the progress.\n- **Success**: Displays a checkmark icon when progress reaches 100%.\n- **Error**: Displays an error icon when in an error state.",
24307
- "name": "Progressspinner",
23882
+ "description": "mdc-progressbar component visually represents a progress indicator, typically used to show\nthe completion state of an ongoing process (e.g., loading, file upload, etc.).\nIt contains an optional label and an optional helper text.\n\n- It supports mainly two types: Default and Inline\n- It supports three validation variants: Default, Success and Error.\n\nThis component is created by extending FormfieldWrapper.",
23883
+ "name": "Progressbar",
24308
23884
  "cssProperties": [
24309
- {
24310
- "description": "The size of the spinner.",
24311
- "name": "--mdc-spinner-size"
24312
- },
24313
- {
24314
- "description": "The color of the spinner track.",
24315
- "name": "--mdc-track-color"
24316
- },
24317
- {
24318
- "description": "The color of the spinner progress.",
24319
- "name": "--mdc-progress-color"
24320
- },
24321
- {
24322
- "description": "The color of the spinner when in success state.",
24323
- "name": "--mdc-progress-success-color"
24324
- },
24325
- {
24326
- "description": "The color of the spinner when in error state.",
24327
- "name": "--mdc-progress-error-color"
24328
- },
24329
23885
  {
24330
23886
  "description": "Background color of the progressbar when inactive.",
24331
- "name": "--mdc-progressbar-default-background-color",
24332
- "inheritedFrom": {
24333
- "name": "Progressbar",
24334
- "module": "src/components/progressbar/progressbar.component.ts"
24335
- }
23887
+ "name": "--mdc-progressbar-default-background-color"
24336
23888
  },
24337
23889
  {
24338
23890
  "description": "Background color of the progressbar when active.",
24339
- "name": "--mdc-progressbar-default-active-background-color",
24340
- "inheritedFrom": {
24341
- "name": "Progressbar",
24342
- "module": "src/components/progressbar/progressbar.component.ts"
24343
- }
23891
+ "name": "--mdc-progressbar-default-active-background-color"
24344
23892
  },
24345
23893
  {
24346
23894
  "description": "Background color of the progressbar when in success state.",
24347
- "name": "--mdc-progressbar-success-background-color",
24348
- "inheritedFrom": {
24349
- "name": "Progressbar",
24350
- "module": "src/components/progressbar/progressbar.component.ts"
24351
- }
23895
+ "name": "--mdc-progressbar-success-background-color"
24352
23896
  },
24353
23897
  {
24354
23898
  "description": "Background color of the progressbar when in error state.",
24355
- "name": "--mdc-progressbar-error-background-color",
24356
- "inheritedFrom": {
24357
- "name": "Progressbar",
24358
- "module": "src/components/progressbar/progressbar.component.ts"
24359
- }
23899
+ "name": "--mdc-progressbar-error-background-color"
24360
23900
  },
24361
23901
  {
24362
23902
  "description": "The height of the progressbar.",
24363
- "name": "--mdc-progressbar-height",
24364
- "inheritedFrom": {
24365
- "name": "Progressbar",
24366
- "module": "src/components/progressbar/progressbar.component.ts"
24367
- }
23903
+ "name": "--mdc-progressbar-height"
24368
23904
  },
24369
23905
  {
24370
23906
  "description": "The border radius of the progressbar.",
24371
- "name": "--mdc-progressbar-border-radius",
24372
- "inheritedFrom": {
24373
- "name": "Progressbar",
24374
- "module": "src/components/progressbar/progressbar.component.ts"
24375
- }
23907
+ "name": "--mdc-progressbar-border-radius"
24376
23908
  },
24377
23909
  {
24378
23910
  "description": "Color of the progressbar label text.",
24379
- "name": "--mdc-progressbar-label-color",
24380
- "inheritedFrom": {
24381
- "name": "Progressbar",
24382
- "module": "src/components/progressbar/progressbar.component.ts"
24383
- }
23911
+ "name": "--mdc-progressbar-label-color"
24384
23912
  },
24385
23913
  {
24386
23914
  "description": "Line height of the label text.",
24387
- "name": "--mdc-progressbar-label-lineheight",
24388
- "inheritedFrom": {
24389
- "name": "Progressbar",
24390
- "module": "src/components/progressbar/progressbar.component.ts"
24391
- }
23915
+ "name": "--mdc-progressbar-label-lineheight"
24392
23916
  },
24393
23917
  {
24394
23918
  "description": "Font size of the label text.",
24395
- "name": "--mdc-progressbar-label-fontsize",
24396
- "inheritedFrom": {
24397
- "name": "Progressbar",
24398
- "module": "src/components/progressbar/progressbar.component.ts"
24399
- }
23919
+ "name": "--mdc-progressbar-label-fontsize"
24400
23920
  },
24401
23921
  {
24402
23922
  "description": "Font weight of the label text.",
24403
- "name": "--mdc-progressbar-label-fontweight",
24404
- "inheritedFrom": {
24405
- "name": "Progressbar",
24406
- "module": "src/components/progressbar/progressbar.component.ts"
24407
- }
23923
+ "name": "--mdc-progressbar-label-fontweight"
24408
23924
  },
24409
23925
  {
24410
23926
  "description": "Color of the help text.",
24411
- "name": "--mdc-progressbar-help-text-color",
24412
- "inheritedFrom": {
24413
- "name": "Progressbar",
24414
- "module": "src/components/progressbar/progressbar.component.ts"
24415
- }
23927
+ "name": "--mdc-progressbar-help-text-color"
24416
23928
  }
24417
23929
  ],
24418
23930
  "members": [
24419
23931
  {
24420
- "kind": "method",
24421
- "name": "renderProgressSpinner",
24422
- "privacy": "private"
23932
+ "kind": "field",
23933
+ "name": "variant",
23934
+ "type": {
23935
+ "text": "Variant"
23936
+ },
23937
+ "description": "Types of the progressbar\n- **Default**\n- **Inline**",
23938
+ "default": "default",
23939
+ "attribute": "variant",
23940
+ "reflects": true
24423
23941
  },
24424
23942
  {
24425
- "kind": "method",
24426
- "name": "renderErrorState",
24427
- "privacy": "private",
24428
- "description": "Renders the error state of the progress spinner.",
24429
- "return": {
24430
- "type": {
24431
- "text": ""
24432
- }
24433
- }
23943
+ "kind": "field",
23944
+ "name": "value",
23945
+ "type": {
23946
+ "text": "string"
23947
+ },
23948
+ "default": "'0'",
23949
+ "description": "The current progress as a percentage, 0 to 100.\nThe value will be clamped between 0 and 100.",
23950
+ "attribute": "value",
23951
+ "reflects": true
23952
+ },
23953
+ {
23954
+ "kind": "field",
23955
+ "name": "error",
23956
+ "type": {
23957
+ "text": "boolean"
23958
+ },
23959
+ "default": "false",
23960
+ "description": "Define error state of the progressbar\n- **true**\n- **false**",
23961
+ "attribute": "error"
24434
23962
  },
24435
23963
  {
24436
23964
  "kind": "method",
24437
- "name": "renderSuccessState",
23965
+ "name": "getValidationVariant",
24438
23966
  "privacy": "private",
24439
- "description": "Renders the success state of the progress spinner.",
23967
+ "description": "Determines the validation state (success, error, or default) based on progress value and error state.",
24440
23968
  "return": {
24441
23969
  "type": {
24442
23970
  "text": ""
@@ -24458,65 +23986,6 @@
24458
23986
  "module": "utils/mixins/DataAriaLabelMixin.js"
24459
23987
  }
24460
23988
  },
24461
- {
24462
- "kind": "field",
24463
- "name": "variant",
24464
- "type": {
24465
- "text": "Variant"
24466
- },
24467
- "description": "Types of the progressbar\n- **Default**\n- **Inline**",
24468
- "default": "default",
24469
- "attribute": "variant",
24470
- "reflects": true,
24471
- "inheritedFrom": {
24472
- "name": "Progressbar",
24473
- "module": "components/progressbar/progressbar.component.js"
24474
- }
24475
- },
24476
- {
24477
- "kind": "field",
24478
- "name": "value",
24479
- "type": {
24480
- "text": "string"
24481
- },
24482
- "default": "'0'",
24483
- "description": "The current progress as a percentage, 0 to 100.\nThe value will be clamped between 0 and 100.",
24484
- "attribute": "value",
24485
- "reflects": true,
24486
- "inheritedFrom": {
24487
- "name": "Progressbar",
24488
- "module": "components/progressbar/progressbar.component.js"
24489
- }
24490
- },
24491
- {
24492
- "kind": "field",
24493
- "name": "error",
24494
- "type": {
24495
- "text": "boolean"
24496
- },
24497
- "default": "false",
24498
- "description": "Define error state of the progressbar\n- **true**\n- **false**",
24499
- "attribute": "error",
24500
- "inheritedFrom": {
24501
- "name": "Progressbar",
24502
- "module": "components/progressbar/progressbar.component.js"
24503
- }
24504
- },
24505
- {
24506
- "kind": "method",
24507
- "name": "getValidationVariant",
24508
- "privacy": "private",
24509
- "description": "Determines the validation state (success, error, or default) based on progress value and error state.",
24510
- "return": {
24511
- "type": {
24512
- "text": ""
24513
- }
24514
- },
24515
- "inheritedFrom": {
24516
- "name": "Progressbar",
24517
- "module": "components/progressbar/progressbar.component.js"
24518
- }
24519
- },
24520
23989
  {
24521
23990
  "kind": "field",
24522
23991
  "name": "disabled",
@@ -24722,27 +24191,7 @@
24722
24191
  }
24723
24192
  }
24724
24193
  ],
24725
- "superclass": {
24726
- "name": "Progressbar",
24727
- "module": "/src/components/progressbar/progressbar.component"
24728
- },
24729
- "tagName": "mdc-progressspinner",
24730
- "jsDoc": "/**\n * `mdc-progressspinner` is a customizable, circular progress indicator component.\n * It visually represents the current completion state of a process, such as loading,\n * syncing, uploading, or any ongoing task that has a measurable percentage.\n *\n * The spinner is built using SVG with two concentric `<circle>` elements:\n * - The `progress` arc represents the portion of work completed.\n * - The `track` arc represents the remaining part.\n *\n * A visual gap is maintained between the progress and track arcs to clearly\n * distinguish the two segments. The component smoothly animates arc length\n * and respects accessibility best practices with ARIA attributes.\n *\n * The component supports different states:\n * - **Default**: Circular spinner shows the progress.\n * - **Success**: Displays a checkmark icon when progress reaches 100%.\n * - **Error**: Displays an error icon when in an error state.\n *\n * @tagname mdc-progressspinner\n *\n * @cssproperty --mdc-spinner-size - The size of the spinner.\n * @cssproperty --mdc-track-color - The color of the spinner track.\n * @cssproperty --mdc-progress-color - The color of the spinner progress.\n * @cssproperty --mdc-progress-success-color - The color of the spinner when in success state.\n * @cssproperty --mdc-progress-error-color - The color of the spinner when in error state.\n *\n */",
24731
- "customElement": true,
24732
24194
  "attributes": [
24733
- {
24734
- "name": "data-aria-label",
24735
- "type": {
24736
- "text": "string | null"
24737
- },
24738
- "default": "null",
24739
- "description": "Defines a string value that labels the current element.\nThe Aria-Label attribute to be set for accessibility.",
24740
- "fieldName": "dataAriaLabel",
24741
- "inheritedFrom": {
24742
- "name": "DataAriaLabelMixin",
24743
- "module": "src/utils/mixins/DataAriaLabelMixin.ts"
24744
- }
24745
- },
24746
24195
  {
24747
24196
  "name": "variant",
24748
24197
  "type": {
@@ -24750,11 +24199,7 @@
24750
24199
  },
24751
24200
  "description": "Types of the progressbar\n- **Default**\n- **Inline**",
24752
24201
  "default": "default",
24753
- "fieldName": "variant",
24754
- "inheritedFrom": {
24755
- "name": "Progressbar",
24756
- "module": "src/components/progressbar/progressbar.component.ts"
24757
- }
24202
+ "fieldName": "variant"
24758
24203
  },
24759
24204
  {
24760
24205
  "name": "value",
@@ -24763,11 +24208,7 @@
24763
24208
  },
24764
24209
  "default": "'0'",
24765
24210
  "description": "The current progress as a percentage, 0 to 100.\nThe value will be clamped between 0 and 100.",
24766
- "fieldName": "value",
24767
- "inheritedFrom": {
24768
- "name": "Progressbar",
24769
- "module": "src/components/progressbar/progressbar.component.ts"
24770
- }
24211
+ "fieldName": "value"
24771
24212
  },
24772
24213
  {
24773
24214
  "name": "error",
@@ -24776,10 +24217,19 @@
24776
24217
  },
24777
24218
  "default": "false",
24778
24219
  "description": "Define error state of the progressbar\n- **true**\n- **false**",
24779
- "fieldName": "error",
24220
+ "fieldName": "error"
24221
+ },
24222
+ {
24223
+ "name": "data-aria-label",
24224
+ "type": {
24225
+ "text": "string | null"
24226
+ },
24227
+ "default": "null",
24228
+ "description": "Defines a string value that labels the current element.\nThe Aria-Label attribute to be set for accessibility.",
24229
+ "fieldName": "dataAriaLabel",
24780
24230
  "inheritedFrom": {
24781
- "name": "Progressbar",
24782
- "module": "src/components/progressbar/progressbar.component.ts"
24231
+ "name": "DataAriaLabelMixin",
24232
+ "module": "src/utils/mixins/DataAriaLabelMixin.ts"
24783
24233
  }
24784
24234
  },
24785
24235
  {
@@ -24894,7 +24344,20 @@
24894
24344
  "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
24895
24345
  }
24896
24346
  }
24897
- ]
24347
+ ],
24348
+ "mixins": [
24349
+ {
24350
+ "name": "DataAriaLabelMixin",
24351
+ "module": "/src/utils/mixins/DataAriaLabelMixin"
24352
+ }
24353
+ ],
24354
+ "superclass": {
24355
+ "name": "FormfieldWrapper",
24356
+ "module": "/src/components/formfieldwrapper"
24357
+ },
24358
+ "tagName": "mdc-progressbar",
24359
+ "jsDoc": "/**\n * mdc-progressbar component visually represents a progress indicator, typically used to show\n * the completion state of an ongoing process (e.g., loading, file upload, etc.).\n * It contains an optional label and an optional helper text.\n *\n * - It supports mainly two types: Default and Inline\n * - It supports three validation variants: Default, Success and Error.\n *\n * This component is created by extending FormfieldWrapper.\n *\n * @tagname mdc-progressbar\n *\n * @dependency mdc-icon\n * @dependency mdc-text\n *\n * @cssproperty --mdc-progressbar-default-background-color - Background color of the progressbar when inactive.\n * @cssproperty --mdc-progressbar-default-active-background-color - Background color of the progressbar when active.\n * @cssproperty --mdc-progressbar-success-background-color - Background color of the progressbar when in success state.\n * @cssproperty --mdc-progressbar-error-background-color - Background color of the progressbar when in error state.\n * @cssproperty --mdc-progressbar-height - The height of the progressbar.\n * @cssproperty --mdc-progressbar-border-radius - The border radius of the progressbar.\n * @cssproperty --mdc-progressbar-label-color - Color of the progressbar label text.\n * @cssproperty --mdc-progressbar-label-lineheight - Line height of the label text.\n * @cssproperty --mdc-progressbar-label-fontsize - Font size of the label text.\n * @cssproperty --mdc-progressbar-label-fontweight - Font weight of the label text.\n * @cssproperty --mdc-progressbar-help-text-color - Color of the help text.\n */",
24360
+ "customElement": true
24898
24361
  }
24899
24362
  ],
24900
24363
  "exports": [
@@ -24902,104 +24365,152 @@
24902
24365
  "kind": "js",
24903
24366
  "name": "default",
24904
24367
  "declaration": {
24905
- "name": "Progressspinner",
24906
- "module": "components/progressspinner/progressspinner.component.js"
24368
+ "name": "Progressbar",
24369
+ "module": "components/progressbar/progressbar.component.js"
24907
24370
  }
24908
24371
  }
24909
24372
  ]
24910
24373
  },
24911
24374
  {
24912
24375
  "kind": "javascript-module",
24913
- "path": "components/progressbar/progressbar.component.js",
24376
+ "path": "components/progressspinner/progressspinner.component.js",
24914
24377
  "declarations": [
24915
24378
  {
24916
24379
  "kind": "class",
24917
- "description": "mdc-progressbar component visually represents a progress indicator, typically used to show\nthe completion state of an ongoing process (e.g., loading, file upload, etc.).\nIt contains an optional label and an optional helper text.\n\n- It supports mainly two types: Default and Inline\n- It supports three validation variants: Default, Success and Error.\n\nThis component is created by extending FormfieldWrapper.",
24918
- "name": "Progressbar",
24380
+ "description": "`mdc-progressspinner` is a customizable, circular progress indicator component.\nIt visually represents the current completion state of a process, such as loading,\nsyncing, uploading, or any ongoing task that has a measurable percentage.\n\nThe spinner is built using SVG with two concentric `<circle>` elements:\n- The `progress` arc represents the portion of work completed.\n- The `track` arc represents the remaining part.\n\nA visual gap is maintained between the progress and track arcs to clearly\ndistinguish the two segments. The component smoothly animates arc length\nand respects accessibility best practices with ARIA attributes.\n\nThe component supports different states:\n- **Default**: Circular spinner shows the progress.\n- **Success**: Displays a checkmark icon when progress reaches 100%.\n- **Error**: Displays an error icon when in an error state.",
24381
+ "name": "Progressspinner",
24919
24382
  "cssProperties": [
24383
+ {
24384
+ "description": "The size of the spinner.",
24385
+ "name": "--mdc-spinner-size"
24386
+ },
24387
+ {
24388
+ "description": "The color of the spinner track.",
24389
+ "name": "--mdc-track-color"
24390
+ },
24391
+ {
24392
+ "description": "The color of the spinner progress.",
24393
+ "name": "--mdc-progress-color"
24394
+ },
24395
+ {
24396
+ "description": "The color of the spinner when in success state.",
24397
+ "name": "--mdc-progress-success-color"
24398
+ },
24399
+ {
24400
+ "description": "The color of the spinner when in error state.",
24401
+ "name": "--mdc-progress-error-color"
24402
+ },
24920
24403
  {
24921
24404
  "description": "Background color of the progressbar when inactive.",
24922
- "name": "--mdc-progressbar-default-background-color"
24405
+ "name": "--mdc-progressbar-default-background-color",
24406
+ "inheritedFrom": {
24407
+ "name": "Progressbar",
24408
+ "module": "src/components/progressbar/progressbar.component.ts"
24409
+ }
24923
24410
  },
24924
24411
  {
24925
24412
  "description": "Background color of the progressbar when active.",
24926
- "name": "--mdc-progressbar-default-active-background-color"
24413
+ "name": "--mdc-progressbar-default-active-background-color",
24414
+ "inheritedFrom": {
24415
+ "name": "Progressbar",
24416
+ "module": "src/components/progressbar/progressbar.component.ts"
24417
+ }
24927
24418
  },
24928
24419
  {
24929
24420
  "description": "Background color of the progressbar when in success state.",
24930
- "name": "--mdc-progressbar-success-background-color"
24421
+ "name": "--mdc-progressbar-success-background-color",
24422
+ "inheritedFrom": {
24423
+ "name": "Progressbar",
24424
+ "module": "src/components/progressbar/progressbar.component.ts"
24425
+ }
24931
24426
  },
24932
24427
  {
24933
24428
  "description": "Background color of the progressbar when in error state.",
24934
- "name": "--mdc-progressbar-error-background-color"
24429
+ "name": "--mdc-progressbar-error-background-color",
24430
+ "inheritedFrom": {
24431
+ "name": "Progressbar",
24432
+ "module": "src/components/progressbar/progressbar.component.ts"
24433
+ }
24935
24434
  },
24936
24435
  {
24937
24436
  "description": "The height of the progressbar.",
24938
- "name": "--mdc-progressbar-height"
24437
+ "name": "--mdc-progressbar-height",
24438
+ "inheritedFrom": {
24439
+ "name": "Progressbar",
24440
+ "module": "src/components/progressbar/progressbar.component.ts"
24441
+ }
24939
24442
  },
24940
24443
  {
24941
24444
  "description": "The border radius of the progressbar.",
24942
- "name": "--mdc-progressbar-border-radius"
24445
+ "name": "--mdc-progressbar-border-radius",
24446
+ "inheritedFrom": {
24447
+ "name": "Progressbar",
24448
+ "module": "src/components/progressbar/progressbar.component.ts"
24449
+ }
24943
24450
  },
24944
24451
  {
24945
24452
  "description": "Color of the progressbar label text.",
24946
- "name": "--mdc-progressbar-label-color"
24453
+ "name": "--mdc-progressbar-label-color",
24454
+ "inheritedFrom": {
24455
+ "name": "Progressbar",
24456
+ "module": "src/components/progressbar/progressbar.component.ts"
24457
+ }
24947
24458
  },
24948
24459
  {
24949
24460
  "description": "Line height of the label text.",
24950
- "name": "--mdc-progressbar-label-lineheight"
24461
+ "name": "--mdc-progressbar-label-lineheight",
24462
+ "inheritedFrom": {
24463
+ "name": "Progressbar",
24464
+ "module": "src/components/progressbar/progressbar.component.ts"
24465
+ }
24951
24466
  },
24952
24467
  {
24953
24468
  "description": "Font size of the label text.",
24954
- "name": "--mdc-progressbar-label-fontsize"
24469
+ "name": "--mdc-progressbar-label-fontsize",
24470
+ "inheritedFrom": {
24471
+ "name": "Progressbar",
24472
+ "module": "src/components/progressbar/progressbar.component.ts"
24473
+ }
24955
24474
  },
24956
24475
  {
24957
24476
  "description": "Font weight of the label text.",
24958
- "name": "--mdc-progressbar-label-fontweight"
24477
+ "name": "--mdc-progressbar-label-fontweight",
24478
+ "inheritedFrom": {
24479
+ "name": "Progressbar",
24480
+ "module": "src/components/progressbar/progressbar.component.ts"
24481
+ }
24959
24482
  },
24960
24483
  {
24961
24484
  "description": "Color of the help text.",
24962
- "name": "--mdc-progressbar-help-text-color"
24485
+ "name": "--mdc-progressbar-help-text-color",
24486
+ "inheritedFrom": {
24487
+ "name": "Progressbar",
24488
+ "module": "src/components/progressbar/progressbar.component.ts"
24489
+ }
24963
24490
  }
24964
24491
  ],
24965
24492
  "members": [
24966
24493
  {
24967
- "kind": "field",
24968
- "name": "variant",
24969
- "type": {
24970
- "text": "Variant"
24971
- },
24972
- "description": "Types of the progressbar\n- **Default**\n- **Inline**",
24973
- "default": "default",
24974
- "attribute": "variant",
24975
- "reflects": true
24976
- },
24977
- {
24978
- "kind": "field",
24979
- "name": "value",
24980
- "type": {
24981
- "text": "string"
24982
- },
24983
- "default": "'0'",
24984
- "description": "The current progress as a percentage, 0 to 100.\nThe value will be clamped between 0 and 100.",
24985
- "attribute": "value",
24986
- "reflects": true
24494
+ "kind": "method",
24495
+ "name": "renderProgressSpinner",
24496
+ "privacy": "private"
24987
24497
  },
24988
24498
  {
24989
- "kind": "field",
24990
- "name": "error",
24991
- "type": {
24992
- "text": "boolean"
24993
- },
24994
- "default": "false",
24995
- "description": "Define error state of the progressbar\n- **true**\n- **false**",
24996
- "attribute": "error"
24499
+ "kind": "method",
24500
+ "name": "renderErrorState",
24501
+ "privacy": "private",
24502
+ "description": "Renders the error state of the progress spinner.",
24503
+ "return": {
24504
+ "type": {
24505
+ "text": ""
24506
+ }
24507
+ }
24997
24508
  },
24998
24509
  {
24999
24510
  "kind": "method",
25000
- "name": "getValidationVariant",
24511
+ "name": "renderSuccessState",
25001
24512
  "privacy": "private",
25002
- "description": "Determines the validation state (success, error, or default) based on progress value and error state.",
24513
+ "description": "Renders the success state of the progress spinner.",
25003
24514
  "return": {
25004
24515
  "type": {
25005
24516
  "text": ""
@@ -25021,6 +24532,65 @@
25021
24532
  "module": "utils/mixins/DataAriaLabelMixin.js"
25022
24533
  }
25023
24534
  },
24535
+ {
24536
+ "kind": "field",
24537
+ "name": "variant",
24538
+ "type": {
24539
+ "text": "Variant"
24540
+ },
24541
+ "description": "Types of the progressbar\n- **Default**\n- **Inline**",
24542
+ "default": "default",
24543
+ "attribute": "variant",
24544
+ "reflects": true,
24545
+ "inheritedFrom": {
24546
+ "name": "Progressbar",
24547
+ "module": "components/progressbar/progressbar.component.js"
24548
+ }
24549
+ },
24550
+ {
24551
+ "kind": "field",
24552
+ "name": "value",
24553
+ "type": {
24554
+ "text": "string"
24555
+ },
24556
+ "default": "'0'",
24557
+ "description": "The current progress as a percentage, 0 to 100.\nThe value will be clamped between 0 and 100.",
24558
+ "attribute": "value",
24559
+ "reflects": true,
24560
+ "inheritedFrom": {
24561
+ "name": "Progressbar",
24562
+ "module": "components/progressbar/progressbar.component.js"
24563
+ }
24564
+ },
24565
+ {
24566
+ "kind": "field",
24567
+ "name": "error",
24568
+ "type": {
24569
+ "text": "boolean"
24570
+ },
24571
+ "default": "false",
24572
+ "description": "Define error state of the progressbar\n- **true**\n- **false**",
24573
+ "attribute": "error",
24574
+ "inheritedFrom": {
24575
+ "name": "Progressbar",
24576
+ "module": "components/progressbar/progressbar.component.js"
24577
+ }
24578
+ },
24579
+ {
24580
+ "kind": "method",
24581
+ "name": "getValidationVariant",
24582
+ "privacy": "private",
24583
+ "description": "Determines the validation state (success, error, or default) based on progress value and error state.",
24584
+ "return": {
24585
+ "type": {
24586
+ "text": ""
24587
+ }
24588
+ },
24589
+ "inheritedFrom": {
24590
+ "name": "Progressbar",
24591
+ "module": "components/progressbar/progressbar.component.js"
24592
+ }
24593
+ },
25024
24594
  {
25025
24595
  "kind": "field",
25026
24596
  "name": "disabled",
@@ -25226,7 +24796,27 @@
25226
24796
  }
25227
24797
  }
25228
24798
  ],
24799
+ "superclass": {
24800
+ "name": "Progressbar",
24801
+ "module": "/src/components/progressbar/progressbar.component"
24802
+ },
24803
+ "tagName": "mdc-progressspinner",
24804
+ "jsDoc": "/**\n * `mdc-progressspinner` is a customizable, circular progress indicator component.\n * It visually represents the current completion state of a process, such as loading,\n * syncing, uploading, or any ongoing task that has a measurable percentage.\n *\n * The spinner is built using SVG with two concentric `<circle>` elements:\n * - The `progress` arc represents the portion of work completed.\n * - The `track` arc represents the remaining part.\n *\n * A visual gap is maintained between the progress and track arcs to clearly\n * distinguish the two segments. The component smoothly animates arc length\n * and respects accessibility best practices with ARIA attributes.\n *\n * The component supports different states:\n * - **Default**: Circular spinner shows the progress.\n * - **Success**: Displays a checkmark icon when progress reaches 100%.\n * - **Error**: Displays an error icon when in an error state.\n *\n * @tagname mdc-progressspinner\n *\n * @cssproperty --mdc-spinner-size - The size of the spinner.\n * @cssproperty --mdc-track-color - The color of the spinner track.\n * @cssproperty --mdc-progress-color - The color of the spinner progress.\n * @cssproperty --mdc-progress-success-color - The color of the spinner when in success state.\n * @cssproperty --mdc-progress-error-color - The color of the spinner when in error state.\n *\n */",
24805
+ "customElement": true,
25229
24806
  "attributes": [
24807
+ {
24808
+ "name": "data-aria-label",
24809
+ "type": {
24810
+ "text": "string | null"
24811
+ },
24812
+ "default": "null",
24813
+ "description": "Defines a string value that labels the current element.\nThe Aria-Label attribute to be set for accessibility.",
24814
+ "fieldName": "dataAriaLabel",
24815
+ "inheritedFrom": {
24816
+ "name": "DataAriaLabelMixin",
24817
+ "module": "src/utils/mixins/DataAriaLabelMixin.ts"
24818
+ }
24819
+ },
25230
24820
  {
25231
24821
  "name": "variant",
25232
24822
  "type": {
@@ -25234,7 +24824,11 @@
25234
24824
  },
25235
24825
  "description": "Types of the progressbar\n- **Default**\n- **Inline**",
25236
24826
  "default": "default",
25237
- "fieldName": "variant"
24827
+ "fieldName": "variant",
24828
+ "inheritedFrom": {
24829
+ "name": "Progressbar",
24830
+ "module": "src/components/progressbar/progressbar.component.ts"
24831
+ }
25238
24832
  },
25239
24833
  {
25240
24834
  "name": "value",
@@ -25243,7 +24837,11 @@
25243
24837
  },
25244
24838
  "default": "'0'",
25245
24839
  "description": "The current progress as a percentage, 0 to 100.\nThe value will be clamped between 0 and 100.",
25246
- "fieldName": "value"
24840
+ "fieldName": "value",
24841
+ "inheritedFrom": {
24842
+ "name": "Progressbar",
24843
+ "module": "src/components/progressbar/progressbar.component.ts"
24844
+ }
25247
24845
  },
25248
24846
  {
25249
24847
  "name": "error",
@@ -25252,19 +24850,10 @@
25252
24850
  },
25253
24851
  "default": "false",
25254
24852
  "description": "Define error state of the progressbar\n- **true**\n- **false**",
25255
- "fieldName": "error"
25256
- },
25257
- {
25258
- "name": "data-aria-label",
25259
- "type": {
25260
- "text": "string | null"
25261
- },
25262
- "default": "null",
25263
- "description": "Defines a string value that labels the current element.\nThe Aria-Label attribute to be set for accessibility.",
25264
- "fieldName": "dataAriaLabel",
24853
+ "fieldName": "error",
25265
24854
  "inheritedFrom": {
25266
- "name": "DataAriaLabelMixin",
25267
- "module": "src/utils/mixins/DataAriaLabelMixin.ts"
24855
+ "name": "Progressbar",
24856
+ "module": "src/components/progressbar/progressbar.component.ts"
25268
24857
  }
25269
24858
  },
25270
24859
  {
@@ -25379,20 +24968,7 @@
25379
24968
  "module": "src/components/formfieldwrapper/formfieldwrapper.component.ts"
25380
24969
  }
25381
24970
  }
25382
- ],
25383
- "mixins": [
25384
- {
25385
- "name": "DataAriaLabelMixin",
25386
- "module": "/src/utils/mixins/DataAriaLabelMixin"
25387
- }
25388
- ],
25389
- "superclass": {
25390
- "name": "FormfieldWrapper",
25391
- "module": "/src/components/formfieldwrapper"
25392
- },
25393
- "tagName": "mdc-progressbar",
25394
- "jsDoc": "/**\n * mdc-progressbar component visually represents a progress indicator, typically used to show\n * the completion state of an ongoing process (e.g., loading, file upload, etc.).\n * It contains an optional label and an optional helper text.\n *\n * - It supports mainly two types: Default and Inline\n * - It supports three validation variants: Default, Success and Error.\n *\n * This component is created by extending FormfieldWrapper.\n *\n * @tagname mdc-progressbar\n *\n * @dependency mdc-icon\n * @dependency mdc-text\n *\n * @cssproperty --mdc-progressbar-default-background-color - Background color of the progressbar when inactive.\n * @cssproperty --mdc-progressbar-default-active-background-color - Background color of the progressbar when active.\n * @cssproperty --mdc-progressbar-success-background-color - Background color of the progressbar when in success state.\n * @cssproperty --mdc-progressbar-error-background-color - Background color of the progressbar when in error state.\n * @cssproperty --mdc-progressbar-height - The height of the progressbar.\n * @cssproperty --mdc-progressbar-border-radius - The border radius of the progressbar.\n * @cssproperty --mdc-progressbar-label-color - Color of the progressbar label text.\n * @cssproperty --mdc-progressbar-label-lineheight - Line height of the label text.\n * @cssproperty --mdc-progressbar-label-fontsize - Font size of the label text.\n * @cssproperty --mdc-progressbar-label-fontweight - Font weight of the label text.\n * @cssproperty --mdc-progressbar-help-text-color - Color of the help text.\n */",
25395
- "customElement": true
24971
+ ]
25396
24972
  }
25397
24973
  ],
25398
24974
  "exports": [
@@ -25400,8 +24976,8 @@
25400
24976
  "kind": "js",
25401
24977
  "name": "default",
25402
24978
  "declaration": {
25403
- "name": "Progressbar",
25404
- "module": "components/progressbar/progressbar.component.js"
24979
+ "name": "Progressspinner",
24980
+ "module": "components/progressspinner/progressspinner.component.js"
25405
24981
  }
25406
24982
  }
25407
24983
  ]
@@ -38156,637 +37732,6 @@
38156
37732
  }
38157
37733
  ]
38158
37734
  },
38159
- {
38160
- "kind": "javascript-module",
38161
- "path": "utils/mixins/MenuMixin.js",
38162
- "declarations": [
38163
- {
38164
- "kind": "class",
38165
- "description": "",
38166
- "name": "MenuMixinInterface",
38167
- "members": [
38168
- {
38169
- "kind": "field",
38170
- "name": "ariaOrientation",
38171
- "type": {
38172
- "text": "Orientation"
38173
- }
38174
- },
38175
- {
38176
- "kind": "method",
38177
- "name": "handleKeyDown",
38178
- "privacy": "protected",
38179
- "return": {
38180
- "type": {
38181
- "text": "void"
38182
- }
38183
- },
38184
- "parameters": [
38185
- {
38186
- "name": "event",
38187
- "type": {
38188
- "text": "KeyboardEvent"
38189
- }
38190
- }
38191
- ]
38192
- },
38193
- {
38194
- "kind": "method",
38195
- "name": "handleMouseClick",
38196
- "privacy": "protected",
38197
- "return": {
38198
- "type": {
38199
- "text": "void"
38200
- }
38201
- },
38202
- "parameters": [
38203
- {
38204
- "name": "event",
38205
- "type": {
38206
- "text": "MouseEvent"
38207
- }
38208
- }
38209
- ]
38210
- },
38211
- {
38212
- "kind": "method",
38213
- "name": "updatePopoverPlacementBasedOnOrientation",
38214
- "privacy": "protected",
38215
- "return": {
38216
- "type": {
38217
- "text": "void"
38218
- }
38219
- }
38220
- }
38221
- ]
38222
- },
38223
- {
38224
- "kind": "mixin",
38225
- "description": "",
38226
- "name": "MenuMixin",
38227
- "members": [
38228
- {
38229
- "kind": "field",
38230
- "name": "ariaOrientation",
38231
- "type": {
38232
- "text": "Orientation"
38233
- },
38234
- "description": "Defines the orientation of the menu. This value is reflected to\nthe `aria-orientation` attribute and can be either `'horizontal'` or `'vertical'`.",
38235
- "default": "'horizontal'",
38236
- "attribute": "aria-orientation",
38237
- "reflects": true
38238
- },
38239
- {
38240
- "kind": "method",
38241
- "name": "setMenuBarPopoverValue",
38242
- "privacy": "private",
38243
- "parameters": [
38244
- {
38245
- "name": "value",
38246
- "type": {
38247
- "text": "boolean"
38248
- },
38249
- "description": "The value to set."
38250
- }
38251
- ],
38252
- "description": "Sets the value of the data-menu-popover-open attribute on the menu element."
38253
- },
38254
- {
38255
- "kind": "method",
38256
- "name": "isMenuPopoverOpen",
38257
- "privacy": "private",
38258
- "return": {
38259
- "type": {
38260
- "text": "boolean"
38261
- }
38262
- },
38263
- "description": "Returns true if the data-menu-popover-open attribute on the menu element is set to 'true', false otherwise."
38264
- },
38265
- {
38266
- "kind": "method",
38267
- "name": "getCurrentIndex",
38268
- "privacy": "private",
38269
- "return": {
38270
- "type": {
38271
- "text": ""
38272
- }
38273
- },
38274
- "parameters": [
38275
- {
38276
- "name": "target",
38277
- "type": {
38278
- "text": "EventTarget | null"
38279
- },
38280
- "description": "The target element to find the index of."
38281
- }
38282
- ],
38283
- "description": "Returns the index of the given target in the menuItems array.\nIf the target is not a menu item, but a child element of a menu item,\nit returns the index of the parent menu item."
38284
- },
38285
- {
38286
- "kind": "method",
38287
- "name": "updatePopoverPlacementBasedOnOrientation",
38288
- "privacy": "protected",
38289
- "return": {
38290
- "type": {
38291
- "text": "void"
38292
- }
38293
- },
38294
- "description": "Updates the placement of the popover based on the aria-orientation property."
38295
- },
38296
- {
38297
- "kind": "method",
38298
- "name": "updateTabIndexAndFocusNewIndex",
38299
- "privacy": "private",
38300
- "parameters": [
38301
- {
38302
- "name": "menuItems",
38303
- "type": {
38304
- "text": "Array<HTMLElement>"
38305
- },
38306
- "description": "The list of menu items."
38307
- },
38308
- {
38309
- "name": "currentIndex",
38310
- "type": {
38311
- "text": "number"
38312
- },
38313
- "description": "The current index of the focused menu item."
38314
- },
38315
- {
38316
- "name": "newIndex",
38317
- "type": {
38318
- "text": "number"
38319
- },
38320
- "description": "The index of the new active element in the list."
38321
- }
38322
- ],
38323
- "description": "Updates the tabindex of the current index to -1 and the tabindex of the new index to 0,\neffectively setting the active element. This is used when navigating the menu via keyboard."
38324
- },
38325
- {
38326
- "kind": "method",
38327
- "name": "isValidMenu",
38328
- "privacy": "private",
38329
- "return": {
38330
- "type": {
38331
- "text": ""
38332
- }
38333
- },
38334
- "parameters": [
38335
- {
38336
- "name": "tagName",
38337
- "optional": true,
38338
- "type": {
38339
- "text": "string"
38340
- },
38341
- "description": "The tag name to check."
38342
- }
38343
- ],
38344
- "description": "Checks if the given tag name is a valid menu tag name."
38345
- },
38346
- {
38347
- "kind": "method",
38348
- "name": "isValidNavItemList",
38349
- "privacy": "private",
38350
- "return": {
38351
- "type": {
38352
- "text": ""
38353
- }
38354
- },
38355
- "parameters": [
38356
- {
38357
- "name": "tagName",
38358
- "optional": true,
38359
- "type": {
38360
- "text": "string"
38361
- },
38362
- "description": "The tag name to check."
38363
- }
38364
- ],
38365
- "description": "Checks if the given tag name is a valid navitemlist tag name."
38366
- },
38367
- {
38368
- "kind": "method",
38369
- "name": "isValidPopover",
38370
- "privacy": "private",
38371
- "return": {
38372
- "type": {
38373
- "text": ""
38374
- }
38375
- },
38376
- "parameters": [
38377
- {
38378
- "name": "tagName",
38379
- "optional": true,
38380
- "type": {
38381
- "text": "string"
38382
- },
38383
- "description": "The tag name to check."
38384
- }
38385
- ],
38386
- "description": "Checks if the given tag name is a valid menu popover tag name."
38387
- },
38388
- {
38389
- "kind": "method",
38390
- "name": "openPopover",
38391
- "privacy": "private",
38392
- "return": {
38393
- "type": {
38394
- "text": ""
38395
- }
38396
- },
38397
- "parameters": [
38398
- {
38399
- "name": "index",
38400
- "type": {
38401
- "text": "number"
38402
- },
38403
- "description": "The index of the menu item to open the popover for."
38404
- }
38405
- ],
38406
- "description": "Opens the popover at the given index if it exists."
38407
- },
38408
- {
38409
- "kind": "method",
38410
- "name": "navigateToPrevMenuItem",
38411
- "privacy": "private",
38412
- "return": {
38413
- "type": {
38414
- "text": "void"
38415
- }
38416
- },
38417
- "parameters": [
38418
- {
38419
- "name": "currentIndex",
38420
- "type": {
38421
- "text": "number"
38422
- },
38423
- "description": "The current index of the focused menu item."
38424
- },
38425
- {
38426
- "name": "firstMenuIndex",
38427
- "type": {
38428
- "text": "number"
38429
- },
38430
- "description": "The index of the first menu item."
38431
- },
38432
- {
38433
- "name": "lastMenuIndex",
38434
- "type": {
38435
- "text": "number"
38436
- },
38437
- "description": "The index of the last menu item."
38438
- },
38439
- {
38440
- "name": "ariaOrientation",
38441
- "type": {
38442
- "text": "Orientation"
38443
- },
38444
- "description": "The orientation of the menu."
38445
- }
38446
- ],
38447
- "description": "Navigates to the previous menu item and updates the tabindex of the current index\nto -1 and the tabindex of the new index to 0."
38448
- },
38449
- {
38450
- "kind": "method",
38451
- "name": "navigateToNextMenuItem",
38452
- "privacy": "private",
38453
- "return": {
38454
- "type": {
38455
- "text": "void"
38456
- }
38457
- },
38458
- "parameters": [
38459
- {
38460
- "name": "currentIndex",
38461
- "type": {
38462
- "text": "number"
38463
- },
38464
- "description": "The current index of the focused menu item."
38465
- },
38466
- {
38467
- "name": "firstMenuIndex",
38468
- "type": {
38469
- "text": "number"
38470
- },
38471
- "description": "The index of the first menu item."
38472
- },
38473
- {
38474
- "name": "lastMenuIndex",
38475
- "type": {
38476
- "text": "number"
38477
- },
38478
- "description": "The index of the last menu item."
38479
- },
38480
- {
38481
- "name": "ariaOrientation",
38482
- "type": {
38483
- "text": "Orientation"
38484
- },
38485
- "description": "The orientation of the menu."
38486
- }
38487
- ],
38488
- "description": "Navigates to the next menu item and updates the tabindex of the current index\nto -1 and the tabindex of the new index to 0."
38489
- },
38490
- {
38491
- "kind": "method",
38492
- "name": "getParentMenuItemDetails",
38493
- "privacy": "private",
38494
- "return": {
38495
- "type": {
38496
- "text": ""
38497
- }
38498
- },
38499
- "parameters": [
38500
- {
38501
- "name": "menuChildId",
38502
- "type": {
38503
- "text": "string"
38504
- },
38505
- "description": "The id of the menu child element."
38506
- },
38507
- {
38508
- "name": "menu",
38509
- "optional": true,
38510
- "type": {
38511
- "text": "HTMLElement | null"
38512
- },
38513
- "description": "The current menu element to start traversing from."
38514
- }
38515
- ],
38516
- "description": "Returns the parent menu item details for the given menu child id.\nIt recursively traverses up the DOM tree until it finds a menu or menubar element."
38517
- },
38518
- {
38519
- "kind": "method",
38520
- "name": "hideAllPopovers",
38521
- "privacy": "private",
38522
- "return": {
38523
- "type": {
38524
- "text": "void"
38525
- }
38526
- },
38527
- "parameters": [
38528
- {
38529
- "name": "menu",
38530
- "optional": true,
38531
- "type": {
38532
- "text": "HTMLElement | null"
38533
- },
38534
- "description": "The current menu element to start traversing from."
38535
- }
38536
- ],
38537
- "description": "Recursively hides all the popovers up the DOM tree until it finds a menu or menubar element."
38538
- },
38539
- {
38540
- "kind": "method",
38541
- "name": "navigateToPrevParentMenuItem",
38542
- "privacy": "private",
38543
- "return": {
38544
- "type": {
38545
- "text": "void"
38546
- }
38547
- },
38548
- "parameters": [
38549
- {
38550
- "name": "currentIndex",
38551
- "type": {
38552
- "text": "number"
38553
- },
38554
- "description": "The current index of the focused menu item."
38555
- },
38556
- {
38557
- "name": "key",
38558
- "type": {
38559
- "text": "string"
38560
- }
38561
- }
38562
- ],
38563
- "description": "Recursively navigates up the DOM tree until it finds the previous menu item\nand updates the tabindex of the current index to -1 and the tabindex of the new index to 0.\nAlso opens the popover of the previous menu item."
38564
- },
38565
- {
38566
- "kind": "method",
38567
- "name": "closePopoverAndNavigateToPrevParentMenuItem",
38568
- "privacy": "private",
38569
- "return": {
38570
- "type": {
38571
- "text": "void"
38572
- }
38573
- },
38574
- "parameters": [
38575
- {
38576
- "name": "currentIndex",
38577
- "type": {
38578
- "text": "number"
38579
- },
38580
- "description": "The current index of the focused menu item."
38581
- },
38582
- {
38583
- "name": "key",
38584
- "type": {
38585
- "text": "string"
38586
- }
38587
- }
38588
- ],
38589
- "description": "Closes the current menu popover and navigates to the previous parent menu item."
38590
- },
38591
- {
38592
- "kind": "method",
38593
- "name": "getParentMenuContents",
38594
- "privacy": "private",
38595
- "return": {
38596
- "type": {
38597
- "text": ""
38598
- }
38599
- },
38600
- "parameters": [
38601
- {
38602
- "name": "currentMenuItem",
38603
- "type": {
38604
- "text": "HTMLElement | null"
38605
- },
38606
- "description": "The current menu item to start traversing from."
38607
- }
38608
- ],
38609
- "description": "Gets the parent menu contents of the given current menu item.\nIt recursively traverses up the DOM tree until it finds the parent menu element\nand gets the parent menu item details and the children of the parent menu item."
38610
- },
38611
- {
38612
- "kind": "method",
38613
- "name": "openPopoverAndNavigateToNextChildrenMenuItem",
38614
- "privacy": "private",
38615
- "return": {
38616
- "type": {
38617
- "text": "void"
38618
- }
38619
- },
38620
- "parameters": [
38621
- {
38622
- "name": "currentIndex",
38623
- "type": {
38624
- "text": "number"
38625
- },
38626
- "description": "The current index of the focused menu item."
38627
- }
38628
- ],
38629
- "description": "Opens the popover of the next children menu item if there are children.\nIf there are no children, then it closes all popovers recursively and\nnavigates to the next menu item from the menu bar.\nIf the parent menu item does not have any children, then we will go to the next menu item."
38630
- },
38631
- {
38632
- "kind": "method",
38633
- "name": "isValidMenuItem",
38634
- "privacy": "private",
38635
- "return": {
38636
- "type": {
38637
- "text": ""
38638
- }
38639
- },
38640
- "parameters": [
38641
- {
38642
- "name": "menuItem",
38643
- "type": {
38644
- "text": "HTMLElement"
38645
- },
38646
- "description": "The menu item to check."
38647
- }
38648
- ],
38649
- "description": "Checks if the given menu item is a valid menu item."
38650
- },
38651
- {
38652
- "kind": "method",
38653
- "name": "resetTabIndexAndSetActiveTabIndex",
38654
- "privacy": "private",
38655
- "parameters": [
38656
- {
38657
- "name": "menuItems",
38658
- "type": {
38659
- "text": "Array<HTMLElement>"
38660
- }
38661
- },
38662
- {
38663
- "description": "The index of the new active element in the list.",
38664
- "name": "newIndex"
38665
- }
38666
- ],
38667
- "description": "Resets all list items tabindex to -1 and sets the tabindex of the\nelement at the given index to 0, effectively setting the active\nelement. This is used when navigating the list via keyboard."
38668
- },
38669
- {
38670
- "kind": "method",
38671
- "name": "getKeyBasedOnDirection",
38672
- "privacy": "private",
38673
- "return": {
38674
- "type": {
38675
- "text": ""
38676
- }
38677
- },
38678
- "parameters": [
38679
- {
38680
- "name": "originalKey",
38681
- "type": {
38682
- "text": "string"
38683
- },
38684
- "description": "The original key pressed."
38685
- }
38686
- ],
38687
- "description": "Returns the key based on the direction of the document.\nIf the document is in RTL mode and the key is ARROW_LEFT or ARROW_RIGHT,\nit will swap them to maintain the correct navigation direction."
38688
- },
38689
- {
38690
- "kind": "method",
38691
- "name": "handleKeyDown",
38692
- "privacy": "protected",
38693
- "return": {
38694
- "type": {
38695
- "text": "void"
38696
- }
38697
- },
38698
- "parameters": [
38699
- {
38700
- "name": "event",
38701
- "type": {
38702
- "text": "KeyboardEvent"
38703
- },
38704
- "description": "The keyboard event."
38705
- }
38706
- ],
38707
- "description": "Handles the keydown event on the menu bar.\nThe keys are as follows:\n- HOME: Sets focus to the first menu item.\n- END: Sets focus to the last menu item.\n- ARROW_LEFT:\n - If orientation is horizontal, then it navigates to the previous menu item.\n - If orientation is vertical, then it closes the popover of the current menu item and\n navigates to the previous parent menu item.\n- ARROW_RIGHT:\n - If orientation is horizontal, then it navigates to the next menu item.\n - If orientation is vertical, then it opens the popover of the current menu item and\n navigates to the next children menu item.\n- ARROW_UP:\n - If orientation is horizontal, then it opens the popover of the current menu item.\n - If orientation is vertical, then it navigates to the previous menu item.\n- ARROW_DOWN:\n - If orientation is horizontal, then it opens the popover of the current menu item.\n - If orientation is vertical, then it navigates to the next menu item.\n- SPACE:\n- ENTER:\n - If the next element sibling is a menu popover, then it opens the popover of the current\n menu item and navigates to the next children menu item.\n - If the target element is a menu item, then it closes all popovers recursively and\n navigates to the previous parent menu item.\n- ESCAPE:\n - If a popover is already open then we close it and navigate to the parent menu item.\n - If the current menuitem is a child of menubar, then we will set the value of isMenuPopoverOpen to false.,"
38708
- },
38709
- {
38710
- "kind": "method",
38711
- "name": "closeAllPopoversExceptCurrent",
38712
- "privacy": "private",
38713
- "return": {
38714
- "type": {
38715
- "text": "void"
38716
- }
38717
- },
38718
- "parameters": [
38719
- {
38720
- "name": "currentIndex",
38721
- "type": {
38722
- "text": "number"
38723
- },
38724
- "description": "The index of the current menu item."
38725
- }
38726
- ],
38727
- "description": "Closes all popovers except the current one."
38728
- },
38729
- {
38730
- "kind": "method",
38731
- "name": "handleMouseClick",
38732
- "privacy": "protected",
38733
- "return": {
38734
- "type": {
38735
- "text": "void"
38736
- }
38737
- },
38738
- "parameters": [
38739
- {
38740
- "name": "event",
38741
- "type": {
38742
- "text": "MouseEvent"
38743
- },
38744
- "description": "The mouse click event."
38745
- }
38746
- ],
38747
- "description": "Handles the mouse click event on the menu items.\n- If the menuitem has children, then it opens the popover of the next children menu item.\n- If the menuitem does not have children, then it closes all popovers recursively."
38748
- }
38749
- ],
38750
- "attributes": [
38751
- {
38752
- "name": "aria-orientation",
38753
- "type": {
38754
- "text": "Orientation"
38755
- },
38756
- "description": "Defines the orientation of the menu. This value is reflected to\nthe `aria-orientation` attribute and can be either `'horizontal'` or `'vertical'`.",
38757
- "default": "'horizontal'",
38758
- "fieldName": "ariaOrientation"
38759
- }
38760
- ],
38761
- "parameters": [
38762
- {
38763
- "name": "superClass",
38764
- "type": {
38765
- "text": "T"
38766
- }
38767
- }
38768
- ]
38769
- }
38770
- ],
38771
- "exports": [
38772
- {
38773
- "kind": "js",
38774
- "name": "MenuMixinInterface",
38775
- "declaration": {
38776
- "name": "MenuMixinInterface",
38777
- "module": "utils/mixins/MenuMixin.js"
38778
- }
38779
- },
38780
- {
38781
- "kind": "js",
38782
- "name": "MenuMixin",
38783
- "declaration": {
38784
- "name": "MenuMixin",
38785
- "module": "utils/mixins/MenuMixin.js"
38786
- }
38787
- }
38788
- ]
38789
- },
38790
37735
  {
38791
37736
  "kind": "javascript-module",
38792
37737
  "path": "utils/mixins/PreventScrollMixin.js",