@momentum-design/components 0.129.45 → 0.129.47

package/dist/custom-elements.json

@@ -2525,13 +2525,12 @@
             {
               "kind": "field",
               "name": "zIndex",
+              "description": "IMPLEMENT THIS IN YOUR COMPONENT.\n\nThe z-index of the component where the backdrop will be attached to.\n\nThe backdrop itself will have a z-index of `zIndex - OVERLAY_BACKDROP_Z_INDEX_OFFSET`.\nThe trigger element of the backdrop will have a z-index of `zIndex - OVERLAY_TRIGGER_Z_INDEX_OFFSET`,\nto make sure that it is above the backdrop and clickable.",
+              "attribute": "z-index",
+              "reflects": true,
               "type": {
                 "text": "number"
               },
-              "description": "IMPLEMENT THIS IN YOUR COMPONENT.\n\nThe z-index of the component where the backdrop will be attached to.\n\nThe backdrop itself will have a z-index of `zIndex - 2`.\nThe trigger element of the backdrop will have a z-index of `zIndex - 1`,\nto make sure that it is above the backdrop and clickable.",
-              "default": "1000",
-              "attribute": "z-index",
-              "reflects": true,
               "inheritedFrom": {
                 "name": "Dialog",
                 "module": "components/dialog/dialog.component.js"
@@ -2648,11 +2647,7 @@
             },
             {
               "name": "z-index",
-              "type": {
-                "text": "number"
-              },
-              "description": "The z-index of the dialog\n\nThe backdrop will have z-index of `zIndex - 1`",
-              "default": "1000",
+              "description": "The effective z-index of the dialog.\n\nIf no explicit `z-index` value is provided, then it automatically calculated\nto ensure proper stacking order among multiple overlays.",
               "fieldName": "zIndex",
               "inheritedFrom": {
                 "name": "Dialog",
@@ -5054,6 +5049,21 @@
               "attribute": "inverted",
               "reflects": true
             },
+            {
+              "kind": "method",
+              "name": "isWidthOverflowing",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              },
+              "description": "Determines if the content of the overflow element is overflowing its width.",
+              "inheritedFrom": {
+                "name": "OverflowMixin",
+                "module": "utils/mixins/OverflowMixin.js"
+              }
+            },
             {
               "kind": "field",
               "name": "name",
@@ -5549,6 +5559,10 @@
             }
           ],
           "mixins": [
+            {
+              "name": "OverflowMixin",
+              "module": "/src/utils/mixins/OverflowMixin"
+            },
             {
               "name": "ButtonComponentMixin",
               "module": "/src/utils/mixins/ButtonComponentMixin"
@@ -5559,7 +5573,7 @@
             "module": "/src/components/buttonsimple/buttonsimple.component"
           },
           "tagName": "mdc-button",
-          "jsDoc": "/**\n * `mdc-button` is a component that can be configured in various ways to suit different use cases.\n *\n * ## Button configuration\n *\n * The appearance of the button depends on combination of multiple attributes.\n *\n * ### Button Types\n * \n * The type of button is inferred based on the presence of slot and/or prefix and postfix icons/slots:\n * \n * - **Pill button**: Contains text value, commonly used for call to action, tags, or filters\n * - **Pill button with icons**: Contains an icon on the left or right side of the button\n * - **Icon button**: Represented by just an icon without any text\n * \n * ### Button Variants:\n *\n * Options for button backgrounds and borders:\n * \n * - **Primary**: Solid background color\n * - **Secondary**: Transparent background with solid border\n * - **Tertiary**: No background or border, text-only appearance\n *\n * ### Button Colors\n * \n * Color options for **Primary** and **Secondary** buttons:\n *\n * - **Default**: For standard actions\n * - **Positive**: For success or confirmation actions\n * - **Negative**: For destructive or error actions\n * - **Accent**: For informational actions\n * - **Promotional**: For promotional actions\n *\n * ### Button Sizes\n * \n * Size options for different button configurations in REM:\n * \n * - **Pill button**: 40, 32, 28, 24\n * - **Icon button**: 64, 52, 40, 32, 28, 24\n * - **Tertiary icon button**: 20\n *\n * @dependency mdc-icon\n *\n * @tagname mdc-button\n *\n * @slot - Text label of the button.\n * @slot prefix - Content to be displayed before the text label.\n * @slot postfix - Content to be displayed after the text label.\n *\n * @csspart button-text - Text label of the button, passed in default slot\n * @csspart prefix - Content before the text label, passed in `prefix` slot\n * @csspart postfix - Content after the text label, passed in `postfix` slot\n * @csspart prefix-icon - Icon element displayed before the text label when `prefix-icon` attribute is set\n * @csspart postfix-icon - Icon element displayed after the text label when `postfix-icon` attribute is set\n *\n * @cssproperty --mdc-button-height - Height for button size\n * @cssproperty --mdc-button-background - Background of the button\n * @cssproperty --mdc-button-border-color - Borer color of the button\n * @cssproperty --mdc-button-text-color - Text color of the button\n * @cssproperty --mdc-button-prefix-icon-size - Size of the prefix icon\n * @cssproperty --mdc-button-postfix-icon-size - Size of the postfix icon\n * @cssproperty --mdc-button-line-height - Line height of the button text\n */",
+          "jsDoc": "/**\n * `mdc-button` is a component that can be configured in various ways to suit different use cases.\n *\n * ## Button configuration\n *\n * The appearance of the button depends on combination of multiple attributes.\n *\n * ### Button Types\n *\n * The type of button is inferred based on the presence of slot and/or prefix and postfix icons/slots:\n *\n * - **Pill button**: Contains text value, commonly used for call to action, tags, or filters\n * - **Pill button with icons**: Contains an icon on the left or right side of the button\n * - **Icon button**: Represented by just an icon without any text\n *\n * ### Button Variants:\n *\n * Options for button backgrounds and borders:\n *\n * - **Primary**: Solid background color\n * - **Secondary**: Transparent background with solid border\n * - **Tertiary**: No background or border, text-only appearance\n *\n * ### Button Colors\n *\n * Color options for **Primary** and **Secondary** buttons:\n *\n * - **Default**: For standard actions\n * - **Positive**: For success or confirmation actions\n * - **Negative**: For destructive or error actions\n * - **Accent**: For informational actions\n * - **Promotional**: For promotional actions\n *\n * ### Button Sizes\n *\n * Size options for different button configurations in REM:\n *\n * - **Pill button**: 40, 32, 28, 24\n * - **Icon button**: 64, 52, 40, 32, 28, 24\n * - **Tertiary icon button**: 20\n *\n * @dependency mdc-icon\n *\n * @tagname mdc-button\n *\n * @slot - Text label of the button.\n * @slot prefix - Content to be displayed before the text label.\n * @slot postfix - Content to be displayed after the text label.\n *\n * @csspart button-text - Text label of the button, passed in default slot\n * @csspart prefix - Content before the text label, passed in `prefix` slot\n * @csspart postfix - Content after the text label, passed in `postfix` slot\n * @csspart prefix-icon - Icon element displayed before the text label when `prefix-icon` attribute is set\n * @csspart postfix-icon - Icon element displayed after the text label when `postfix-icon` attribute is set\n *\n * @cssproperty --mdc-button-height - Height for button size\n * @cssproperty --mdc-button-background - Background of the button\n * @cssproperty --mdc-button-border-color - Borer color of the button\n * @cssproperty --mdc-button-text-color - Text color of the button\n * @cssproperty --mdc-button-prefix-icon-size - Size of the prefix icon\n * @cssproperty --mdc-button-postfix-icon-size - Size of the postfix icon\n * @cssproperty --mdc-button-line-height - Line height of the button text\n */",
           "customElement": true,
           "events": [
             {
@@ -12304,7 +12318,7 @@
               }
             },
             {
-              "kind": "field",
+              "kind": "method",
               "name": "show",
               "privacy": "public",
               "description": "Shows the popover.",
@@ -12439,7 +12453,7 @@
             {
               "kind": "field",
               "name": "zIndex",
-              "description": "IMPLEMENT THIS IN YOUR COMPONENT.\n\nThe z-index of the component where the backdrop will be attached to.\n\nThe backdrop itself will have a z-index of `zIndex - 2`.\nThe trigger element of the backdrop will have a z-index of `zIndex - 1`,\nto make sure that it is above the backdrop and clickable.",
+              "description": "IMPLEMENT THIS IN YOUR COMPONENT.\n\nThe z-index of the component where the backdrop will be attached to.\n\nThe backdrop itself will have a z-index of `zIndex - OVERLAY_BACKDROP_Z_INDEX_OFFSET`.\nThe trigger element of the backdrop will have a z-index of `zIndex - OVERLAY_TRIGGER_Z_INDEX_OFFSET`,\nto make sure that it is above the backdrop and clickable.",
               "attribute": "z-index",
               "reflects": true,
               "type": {
@@ -12843,7 +12857,7 @@
             },
             {
               "name": "z-index",
-              "description": "The effective z-index of the popover.\n\nIf no explicit `z-index` value is provided, then we calculate\nz-index based on the popover’s nesting depth (`popoverDepth`)\nto ensure proper stacking order among multiple popovers.\n\nThe formula used is: `DEFAULTS.Z_INDEX + (popoverDepth * 3)`.\nThis approach guarantees that each nested popover appears above its parent.\nEx: A root-level popover has a z-index of 1000,\n   its first-level child popover will have a z-index of 1003,\n   and a second-level child popover will have a z-index of 1006, and so on.\n\nWhen a value is explicitly set, it overrides the internally computed value.",
+              "description": "The effective z-index of the popover.\n\nIf no explicit `z-index` value is provided, then it automatically calculated\nto ensure proper stacking order among multiple overlays.",
               "fieldName": "zIndex",
               "inheritedFrom": {
                 "name": "Popover",
@@ -13647,10 +13661,10 @@
               "kind": "field",
               "name": "popoverZIndex",
               "type": {
-                "text": "number"
+                "text": "number | undefined"
               },
+              "default": "undefined",
               "description": "The z-index of the popover within Combobox.\n\nOverride this to make sure this stays on top of other components.",
-              "default": "1000",
               "attribute": "popover-z-index",
               "reflects": true
             },
@@ -14175,10 +14189,10 @@
             {
               "name": "popover-z-index",
               "type": {
-                "text": "number"
+                "text": "number | undefined"
               },
+              "default": "undefined",
               "description": "The z-index of the popover within Combobox.\n\nOverride this to make sure this stays on top of other components.",
-              "default": "1000",
               "fieldName": "popoverZIndex"
             },
             {
@@ -14858,8 +14872,7 @@
               "type": {
                 "text": "number"
               },
-              "description": "The z-index of the dialog\n\nThe backdrop will have z-index of `zIndex - 1`",
-              "default": "1000",
+              "description": "The effective z-index of the dialog.\n\nIf no explicit `z-index` value is provided, then it automatically calculated\nto ensure proper stacking order among multiple overlays.",
               "attribute": "z-index",
               "reflects": true,
               "inheritedFrom": {
@@ -14925,11 +14938,7 @@
             },
             {
               "name": "z-index",
-              "type": {
-                "text": "number"
-              },
-              "description": "The z-index of the dialog\n\nThe backdrop will have z-index of `zIndex - 1`",
-              "default": "1000",
+              "description": "The effective z-index of the dialog.\n\nIf no explicit `z-index` value is provided, then it automatically calculated\nto ensure proper stacking order among multiple overlays.",
               "fieldName": "zIndex"
             },
             {
@@ -22658,27 +22667,16 @@
               ]
             },
             {
-              "kind": "method",
+              "kind": "field",
               "name": "handleClick",
               "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
+              "description": "Closes all other submenus on the top level.\nThis method is used to ensure that only one topolevel submenu is open at a time.\nIt finds all other menu items with submenus and closes their submenus.",
               "parameters": [
-                {
-                  "name": "event",
-                  "type": {
-                    "text": "MouseEvent"
-                  }
-                },
                 {
                   "description": "The target menu item that was clicked.",
                   "name": "target"
                 }
-              ],
-              "description": "Closes all other submenus on the top level.\nThis method is used to ensure that only one topolevel submenu is open at a time.\nIt finds all other menu items with submenus and closes their submenus."
+              ]
             },
             {
               "kind": "method",
@@ -26253,7 +26251,7 @@
                   "description": "The popover to close until."
                 }
               ],
-              "description": "Closes all menu popovers in the stack.\nThis method is used to ensure that when a menu item is clicked,\nall other open popovers are closed, maintaining a clean user interface.\nIt iterates through the `popoverStack` and hides each popover until the stack is empty."
+              "description": "Closes all menu popovers in the stack.\nThis method is used to ensure that when a menu item is clicked,\nall other open popovers are closed, maintaining a clean user interface.\nIt iterates through the overlay stack and hides each popover until the stack is empty."
             },
             {
               "kind": "field",
@@ -26529,7 +26527,7 @@
                 {
                   "name": "event",
                   "type": {
-                    "text": "MouseEvent"
+                    "text": "Event"
                   },
                   "description": "The mouse event that triggered the click."
                 }
@@ -26853,7 +26851,7 @@
               }
             },
             {
-              "kind": "field",
+              "kind": "method",
               "name": "show",
               "privacy": "public",
               "description": "Shows the popover.",
@@ -26993,7 +26991,7 @@
             {
               "kind": "field",
               "name": "zIndex",
-              "description": "IMPLEMENT THIS IN YOUR COMPONENT.\n\nThe z-index of the component where the backdrop will be attached to.\n\nThe backdrop itself will have a z-index of `zIndex - 2`.\nThe trigger element of the backdrop will have a z-index of `zIndex - 1`,\nto make sure that it is above the backdrop and clickable.",
+              "description": "IMPLEMENT THIS IN YOUR COMPONENT.\n\nThe z-index of the component where the backdrop will be attached to.\n\nThe backdrop itself will have a z-index of `zIndex - OVERLAY_BACKDROP_Z_INDEX_OFFSET`.\nThe trigger element of the backdrop will have a z-index of `zIndex - OVERLAY_TRIGGER_Z_INDEX_OFFSET`,\nto make sure that it is above the backdrop and clickable.",
               "attribute": "z-index",
               "reflects": true,
               "type": {
@@ -27394,7 +27392,7 @@
             },
             {
               "name": "z-index",
-              "description": "The effective z-index of the popover.\n\nIf no explicit `z-index` value is provided, then we calculate\nz-index based on the popover’s nesting depth (`popoverDepth`)\nto ensure proper stacking order among multiple popovers.\n\nThe formula used is: `DEFAULTS.Z_INDEX + (popoverDepth * 3)`.\nThis approach guarantees that each nested popover appears above its parent.\nEx: A root-level popover has a z-index of 1000,\n   its first-level child popover will have a z-index of 1003,\n   and a second-level child popover will have a z-index of 1006, and so on.\n\nWhen a value is explicitly set, it overrides the internally computed value.",
+              "description": "The effective z-index of the popover.\n\nIf no explicit `z-index` value is provided, then it automatically calculated\nto ensure proper stacking order among multiple overlays.",
               "fieldName": "zIndex",
               "inheritedFrom": {
                 "name": "Popover",
@@ -32452,7 +32450,7 @@
               "reflects": true
             },
             {
-              "kind": "field",
+              "kind": "method",
               "name": "show",
               "privacy": "public",
               "description": "Shows the popover."
@@ -32550,7 +32548,7 @@
               "type": {
                 "text": "number"
               },
-              "description": "The effective z-index of the popover.\n\nIf no explicit `z-index` value is provided, then we calculate\nz-index based on the popover’s nesting depth (`popoverDepth`)\nto ensure proper stacking order among multiple popovers.\n\nThe formula used is: `DEFAULTS.Z_INDEX + (popoverDepth * 3)`.\nThis approach guarantees that each nested popover appears above its parent.\nEx: A root-level popover has a z-index of 1000,\n   its first-level child popover will have a z-index of 1003,\n   and a second-level child popover will have a z-index of 1006, and so on.\n\nWhen a value is explicitly set, it overrides the internally computed value.",
+              "description": "The effective z-index of the popover.\n\nIf no explicit `z-index` value is provided, then it automatically calculated\nto ensure proper stacking order among multiple overlays.",
               "attribute": "z-index",
               "reflects": true,
               "inheritedFrom": {
@@ -32818,7 +32816,7 @@
             },
             {
               "name": "z-index",
-              "description": "The effective z-index of the popover.\n\nIf no explicit `z-index` value is provided, then we calculate\nz-index based on the popover’s nesting depth (`popoverDepth`)\nto ensure proper stacking order among multiple popovers.\n\nThe formula used is: `DEFAULTS.Z_INDEX + (popoverDepth * 3)`.\nThis approach guarantees that each nested popover appears above its parent.\nEx: A root-level popover has a z-index of 1000,\n   its first-level child popover will have a z-index of 1003,\n   and a second-level child popover will have a z-index of 1006, and so on.\n\nWhen a value is explicitly set, it overrides the internally computed value.",
+              "description": "The effective z-index of the popover.\n\nIf no explicit `z-index` value is provided, then it automatically calculated\nto ensure proper stacking order among multiple overlays.",
               "fieldName": "zIndex"
             },
             {
@@ -38796,10 +38794,10 @@
               "kind": "field",
               "name": "popoverZIndex",
               "type": {
-                "text": "number"
+                "text": "number | undefined"
               },
+              "default": "undefined",
               "description": "The z-index of the popover within Searchpopover.\n\nOverride this to make sure this stays on top of other components.",
-              "default": "1000",
               "attribute": "popover-z-index",
               "reflects": true
             },
@@ -39268,10 +39266,10 @@
             {
               "name": "popover-z-index",
               "type": {
-                "text": "number"
+                "text": "number | undefined"
               },
+              "default": "undefined",
               "description": "The z-index of the popover within Searchpopover.\n\nOverride this to make sure this stays on top of other components.",
-              "default": "1000",
               "fieldName": "popoverZIndex"
             },
             {
@@ -40343,10 +40341,10 @@
               "kind": "field",
               "name": "popoverZIndex",
               "type": {
-                "text": "number"
+                "text": "number | undefined"
               },
+              "default": "undefined",
               "description": "The z-index of the popover within Select.\n\nOverride this to make sure this stays on top of other components.",
-              "default": "1000",
               "attribute": "popover-z-index",
               "reflects": true
             },
@@ -40821,10 +40819,10 @@
             {
               "name": "popover-z-index",
               "type": {
-                "text": "number"
+                "text": "number | undefined"
               },
+              "default": "undefined",
               "description": "The z-index of the popover within Select.\n\nOverride this to make sure this stays on top of other components.",
-              "default": "1000",
               "fieldName": "popoverZIndex"
             },
             {
@@ -44597,11 +44595,26 @@
             }
           ],
           "members": [
+            {
+              "kind": "method",
+              "name": "isWidthOverflowing",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              },
+              "description": "Determines if the content of the overflow element is overflowing its width.",
+              "inheritedFrom": {
+                "name": "OverflowMixin",
+                "module": "utils/mixins/OverflowMixin.js"
+              }
+            },
             {
               "kind": "field",
               "name": "tagname",
               "type": {
-                "text": "TagName | undefined"
+                "text": "TagName"
               },
               "privacy": "public",
               "description": "Specifies the HTML tag name for the text element. The default tag name is `p`.\nThis attribute is optional. When set, it changes the tag name of the text element.\n\nAcceptable values include:\n\n- 'h1'\n- 'h2'\n- 'h3'\n- 'h4'\n- 'h5'\n- 'h6'\n- 'p'\n- 'small'\n- 'span'\n- 'div'\n\nFor instance, setting this attribute to `h2` will render the text element as an `h2` element.\nNote that the styling is determined by the `type` attribute.",
@@ -44634,12 +44647,18 @@
             {
               "name": "tagname",
               "type": {
-                "text": "TagName | undefined"
+                "text": "TagName"
               },
               "description": "Specifies the HTML tag name for the text element. The default tag name is `p`.\nThis attribute is optional. When set, it changes the tag name of the text element.\n\nAcceptable values include:\n\n- 'h1'\n- 'h2'\n- 'h3'\n- 'h4'\n- 'h5'\n- 'h6'\n- 'p'\n- 'small'\n- 'span'\n- 'div'\n\nFor instance, setting this attribute to `h2` will render the text element as an `h2` element.\nNote that the styling is determined by the `type` attribute.",
               "fieldName": "tagname"
             }
           ],
+          "mixins": [
+            {
+              "name": "OverflowMixin",
+              "module": "/src/utils/mixins/OverflowMixin"
+            }
+          ],
           "superclass": {
             "name": "Component",
             "module": "/src/models"
@@ -48101,7 +48120,7 @@
               "reflects": true
             },
             {
-              "kind": "field",
+              "kind": "method",
               "name": "show",
               "privacy": "public",
               "description": "Shows the popover.",
@@ -48239,7 +48258,7 @@
               "type": {
                 "text": "number"
               },
-              "description": "IMPLEMENT THIS IN YOUR COMPONENT.\n\nThe z-index of the component where the backdrop will be attached to.\n\nThe backdrop itself will have a z-index of `zIndex - 2`.\nThe trigger element of the backdrop will have a z-index of `zIndex - 1`,\nto make sure that it is above the backdrop and clickable.",
+              "description": "IMPLEMENT THIS IN YOUR COMPONENT.\n\nThe z-index of the component where the backdrop will be attached to.\n\nThe backdrop itself will have a z-index of `zIndex - OVERLAY_BACKDROP_Z_INDEX_OFFSET`.\nThe trigger element of the backdrop will have a z-index of `zIndex - OVERLAY_TRIGGER_Z_INDEX_OFFSET`,\nto make sure that it is above the backdrop and clickable.",
               "attribute": "z-index",
               "reflects": true,
               "inheritedFrom": {
@@ -48635,7 +48654,7 @@
             },
             {
               "name": "z-index",
-              "description": "The effective z-index of the popover.\n\nIf no explicit `z-index` value is provided, then we calculate\nz-index based on the popover’s nesting depth (`popoverDepth`)\nto ensure proper stacking order among multiple popovers.\n\nThe formula used is: `DEFAULTS.Z_INDEX + (popoverDepth * 3)`.\nThis approach guarantees that each nested popover appears above its parent.\nEx: A root-level popover has a z-index of 1000,\n   its first-level child popover will have a z-index of 1003,\n   and a second-level child popover will have a z-index of 1006, and so on.\n\nWhen a value is explicitly set, it overrides the internally computed value.",
+              "description": "The effective z-index of the popover.\n\nIf no explicit `z-index` value is provided, then it automatically calculated\nto ensure proper stacking order among multiple overlays.",
               "fieldName": "zIndex",
               "inheritedFrom": {
                 "name": "Popover",
@@ -49372,15 +49391,13 @@
                   "name": "oldValue",
                   "type": {
                     "text": "boolean"
-                  },
-                  "description": "The old value of the visible property."
+                  }
                 },
                 {
                   "name": "newValue",
                   "type": {
                     "text": "boolean"
-                  },
-                  "description": "The new value of the visible property."
+                  }
                 }
               ],
               "description": "Handles the popover visibility change and position the popover.\nHandles the exit event to close the popover.",
@@ -49429,6 +49446,17 @@
               },
               "description": "Updates the tooltip id if it is empty."
             },
+            {
+              "kind": "field",
+              "name": "onlyShowWhenTriggerOverflows",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If true, the tooltip will only be shown when the trigger element's content is overflowing on the x-axis.\n\nSupports the following components:\n- mdc-button\n- mdc-text",
+              "default": "false",
+              "attribute": "only-show-when-trigger-overflows",
+              "reflects": true
+            },
             {
               "kind": "method",
               "name": "onPlacementUpdated",
@@ -49453,7 +49481,7 @@
                 {
                   "name": "changedProperties",
                   "type": {
-                    "text": "PropertyValues"
+                    "text": "PropertyValues<this>"
                   },
                   "description": "The changed properties."
                 }
@@ -49541,7 +49569,7 @@
               "description": "Sets the type attribute for the tooltip component.\nIf the provided type is not included in the TOOLTIP_TYPES,\nit defaults to the value specified in DEFAULTS.TOOLTIP_TYPE."
             },
             {
-              "kind": "field",
+              "kind": "method",
               "name": "show",
               "privacy": "public",
               "description": "Shows the popover.",
@@ -49690,7 +49718,7 @@
               "type": {
                 "text": "number"
               },
-              "description": "IMPLEMENT THIS IN YOUR COMPONENT.\n\nThe z-index of the component where the backdrop will be attached to.\n\nThe backdrop itself will have a z-index of `zIndex - 2`.\nThe trigger element of the backdrop will have a z-index of `zIndex - 1`,\nto make sure that it is above the backdrop and clickable.",
+              "description": "IMPLEMENT THIS IN YOUR COMPONENT.\n\nThe z-index of the component where the backdrop will be attached to.\n\nThe backdrop itself will have a z-index of `zIndex - OVERLAY_BACKDROP_Z_INDEX_OFFSET`.\nThe trigger element of the backdrop will have a z-index of `zIndex - OVERLAY_TRIGGER_Z_INDEX_OFFSET`,\nto make sure that it is above the backdrop and clickable.",
               "attribute": "z-index",
               "reflects": true,
               "inheritedFrom": {
@@ -49747,6 +49775,15 @@
               "default": "'description'",
               "fieldName": "tooltipType"
             },
+            {
+              "name": "only-show-when-trigger-overflows",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If true, the tooltip will only be shown when the trigger element's content is overflowing on the x-axis.\n\nSupports the following components:\n- mdc-button\n- mdc-text",
+              "default": "false",
+              "fieldName": "onlyShowWhenTriggerOverflows"
+            },
             {
               "name": "id",
               "type": {
@@ -50087,7 +50124,7 @@
             },
             {
               "name": "z-index",
-              "description": "The effective z-index of the popover.\n\nIf no explicit `z-index` value is provided, then we calculate\nz-index based on the popover’s nesting depth (`popoverDepth`)\nto ensure proper stacking order among multiple popovers.\n\nThe formula used is: `DEFAULTS.Z_INDEX + (popoverDepth * 3)`.\nThis approach guarantees that each nested popover appears above its parent.\nEx: A root-level popover has a z-index of 1000,\n   its first-level child popover will have a z-index of 1003,\n   and a second-level child popover will have a z-index of 1006, and so on.\n\nWhen a value is explicitly set, it overrides the internally computed value.",
+              "description": "The effective z-index of the popover.\n\nIf no explicit `z-index` value is provided, then it automatically calculated\nto ensure proper stacking order among multiple overlays.",
               "fieldName": "zIndex",
               "inheritedFrom": {
                 "name": "Popover",
@@ -51408,7 +51445,7 @@
               "type": {
                 "text": "number"
               },
-              "description": "IMPLEMENT THIS IN YOUR COMPONENT.\n\nThe z-index of the component where the backdrop will be attached to.\n\nThe backdrop itself will have a z-index of `zIndex - 2`.\nThe trigger element of the backdrop will have a z-index of `zIndex - 1`,\nto make sure that it is above the backdrop and clickable."
+              "description": "IMPLEMENT THIS IN YOUR COMPONENT.\n\nThe z-index of the component where the backdrop will be attached to.\n\nThe backdrop itself will have a z-index of `zIndex - OVERLAY_BACKDROP_Z_INDEX_OFFSET`.\nThe trigger element of the backdrop will have a z-index of `zIndex - OVERLAY_TRIGGER_Z_INDEX_OFFSET`,\nto make sure that it is above the backdrop and clickable."
             }
           ],
           "parameters": [
@@ -52335,6 +52372,12 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "utils/mixins/FocusTrapMixin.js",
+      "declarations": [],
+      "exports": []
+    },
     {
       "kind": "javascript-module",
       "path": "utils/mixins/FooterMixin.js",
@@ -53118,6 +53161,82 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "utils/mixins/OverflowMixin.js",
+      "declarations": [
+        {
+          "kind": "mixin",
+          "description": "",
+          "name": "OverflowMixin",
+          "members": [
+            {
+              "kind": "method",
+              "name": "isWidthOverflowing",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              },
+              "description": "Determines if the content of the overflow element is overflowing its width."
+            }
+          ],
+          "parameters": [
+            {
+              "name": "superClass",
+              "type": {
+                "text": "T"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "class",
+          "description": "",
+          "name": "OverflowMixinInterface",
+          "members": [
+            {
+              "kind": "method",
+              "name": "isWidthOverflowing",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              }
+            },
+            {
+              "kind": "field",
+              "name": "overflowElement",
+              "type": {
+                "text": "HTMLElement"
+              },
+              "privacy": "protected",
+              "readonly": true
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "OverflowMixin",
+          "declaration": {
+            "name": "OverflowMixin",
+            "module": "utils/mixins/OverflowMixin.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "OverflowMixinInterface",
+          "declaration": {
+            "name": "OverflowMixinInterface",
+            "module": "utils/mixins/OverflowMixin.js"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "utils/mixins/PreventScrollMixin.js",