@tylertech/forge 3.11.0 → 3.12.1

package/custom-elements.json

@@ -47,7 +47,7 @@
           },
           "tagName": "forge-accordion",
           "customElement": true,
-          "summary": "Accordions display a collection of panels that can be expanded or collapsed to show content.",
+          "summary": "Accordions wrap a collection of expansion panels to ensure that only one panel is expanded at a time.",
           "dependencies": [
             {
               "name": "forge-expansion-panel",
@@ -775,7 +775,7 @@
           },
           "tagName": "forge-autocomplete",
           "customElement": true,
-          "summary": "Autocomplete components provide real-time suggestions as users type in a text field."
+          "summary": "Autocomplete components provide real-time typeahead suggestions as users type in a text field. Use autocompletes to help users quickly find and select from a list of options, improving form usability and data accuracy."
         }
       ],
       "exports": [
@@ -949,7 +949,7 @@
           },
           "tagName": "forge-avatar",
           "customElement": true,
-          "summary": "Avatars represent an entity via text or image.",
+          "summary": "Avatars represent an entity via text or image. Use avatars to visually represent users, objects, or identifiers in your application.",
           "cssClasses": [
             {
               "name": "forge-avatar",
@@ -1167,7 +1167,7 @@
           },
           "tagName": "forge-backdrop",
           "customElement": true,
-          "summary": "Backdrops provide a semi-transparent overlay behind modal content like dialogs and drawers."
+          "summary": "Backdrops provide a semi-transparent overlay behind modal content like dialogs and drawers. These are building blocks for creating modal experiences, not intended to be used directly."
         }
       ],
       "exports": [
@@ -1305,7 +1305,7 @@
           },
           "tagName": "forge-badge",
           "customElement": true,
-          "summary": "Badges display small amounts of information like counts, status indicators, or notifications.",
+          "summary": "Badges display small amounts of non-interactive information like counts, status indicators, or notifications.",
           "states": [
             {
               "name": "dot",
@@ -1500,7 +1500,7 @@
           },
           "tagName": "forge-banner",
           "customElement": true,
-          "summary": "Banners are used to inform users of important information, such as errors, warnings, or success messages.",
+          "summary": "Banners are used to inform users of important information, such as errors, warnings, or success messages. Use banners for non-critical messages that require user attention but do not interrupt workflow.",
           "cssClasses": [
             {
               "name": "forge-banner",
@@ -2339,7 +2339,7 @@
           },
           "tagName": "forge-button",
           "customElement": true,
-          "summary": "Buttons represent actions that a user can take.",
+          "summary": "Buttons are used when a user needs to take an action. They can be used to trigger an action, navigate to a new location, and can be styled with a variety of themes and variants.",
           "dependencies": [
             {
               "name": "forge-icon",
@@ -2498,7 +2498,7 @@
           },
           "tagName": "forge-button-area",
           "customElement": true,
-          "summary": "Button areas are used to create a clickable area that group related information and actions about a single subject."
+          "summary": "Button areas are used to create clickable areas that group related information and actions about a single subject. The button area component wraps any arbitrary content with a `<button>` element to enable accessible, clickable interfaces including nested controls and other complex content."
         }
       ],
       "exports": [
@@ -4698,7 +4698,7 @@
           },
           "tagName": "forge-chip-field",
           "customElement": true,
-          "summary": "A specialized input field component that allows users to create and manage a collection of chips representing text values or selections.",
+          "summary": "A specialized input field component that allows users to create and manage a collection of chips representing text values or selections. Use a chip field when you want to allow users to input multiple discrete items, such as tags, categories, or selections from a predefined list. Prefer alternatives such as a select or autocomplete when dealing with a large number of options or when single selection is sufficient.",
           "slots": [
             {
               "description": "The default/unnamed slot for the field's input.",
@@ -5006,7 +5006,7 @@
           },
           "tagName": "forge-circular-progress",
           "customElement": true,
-          "summary": "Circular progress indicators display progress by animating along a circular track in a clockwise direction.",
+          "summary": "Circular progress indicators display progress by animating along a circular track in a clockwise direction. They can be used to represent both determinate and indeterminate progress.",
           "globalConfigProperties": [
             {
               "name": "track",
@@ -5719,7 +5719,7 @@
           },
           "tagName": "forge-color-picker",
           "customElement": true,
-          "summary": "An interactive color selection component with support for multiple color formats (hex, RGB, HSV) and optional opacity control."
+          "summary": "An interactive color selection component with support for multiple color formats (hex, RGB, HSV) and optional opacity control. Intended to be used either inline, or within a popover or dialog for selecting colors."
         }
       ],
       "exports": [
@@ -6330,7 +6330,7 @@
           },
           "tagName": "forge-date-picker",
           "customElement": true,
-          "summary": "A date input component with an integrated calendar popup for selecting single dates with keyboard and mouse interaction support."
+          "summary": "A date input component with an integrated calendar popup for selecting single dates."
         }
       ],
       "exports": [
@@ -7595,7 +7595,7 @@
           },
           "tagName": "forge-dialog",
           "customElement": true,
-          "summary": "Dialogs are temporary UI elements that are used to display information, ask for input, or confirm actions.",
+          "summary": "Dialogs are temporary UI elements that are used to display information, ask for input, or confirm actions. Dialogs can be modal or non-modal.",
           "dependencies": [
             {
               "name": "forge-backdrop",
@@ -7799,7 +7799,7 @@
           },
           "tagName": "forge-divider",
           "customElement": true,
-          "summary": "Divider is used to separate elements.",
+          "summary": "Dividers are used to separate elements with a thin line, either vertically or horizontally.",
           "cssClasses": [
             {
               "name": "forge-divider",
@@ -7857,7 +7857,7 @@
               "name": ""
             },
             {
-              "description": "The header of the panel.",
+              "description": "The header of the panel. This is deprecated, prefer using the trigger property instead, or manually associating a button with the panel.",
               "name": "header"
             }
           ],
@@ -8640,7 +8640,6 @@
           },
           "tagName": "forge-field",
           "customElement": true,
-          "summary": "The Forge Field component is a basic component that handles the layout and theming of\nform elements that can include a label, various states, and a border around an input area.",
           "globalConfigProperties": [
             {
               "name": "labelPosition",
@@ -8959,7 +8958,7 @@
           },
           "tagName": "forge-file-picker",
           "customElement": true,
-          "summary": "The file-picker component allows for a user to upload files of their own to the system. The component provides a slot for a\nbutton, as well as drag-and-drop functionality to launch the system file chooser dialog. There are visual queues to let the\nuser know when files they are dragging can be dropped, as well as events that are relayed to the developer to handle files\nthat are legal and/or illegal based on the parameters set on the component.\n\nThe expectation of this component is that it will be used as a familiar element on the page that will let users upload files,\nwhile providing that visual and functional consistency."
+          "summary": "The file picker component allows for a user to upload files of their own to the system. The component provides a slot for a\nbutton, as well as drag-and-drop functionality to launch the system file chooser dialog. There are visual cues to let the\nuser know when files they are dragging can be dropped, as well as events that are relayed to the developer to handle files\nthat are legal and/or illegal based on the parameters set on the component.\n\nThe expectation of this component is that it will be used as a familiar element on the page that will let users upload files,\nwhile providing that visual and functional consistency."
         }
       ],
       "exports": [
@@ -9398,7 +9397,7 @@
           },
           "tagName": "forge-fab",
           "customElement": true,
-          "summary": "Floating action buttons are used to represent the most important action on a page.",
+          "summary": "Floating action buttons are used to represent the most important action on a page. They are typically used in mobile applications, and are positioned above other content in a way that draws attention to them.",
           "dependencies": [
             {
               "name": "forge-focus-indicator",
@@ -9646,22 +9645,9 @@
               }
             },
             {
-              "kind": "method",
+              "kind": "field",
               "name": "#handleTargetInteraction",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "evt",
-                  "type": {
-                    "text": "Event"
-                  }
-                }
-              ]
+              "privacy": "private"
             },
             {
               "kind": "method",
@@ -9771,7 +9757,7 @@
           },
           "tagName": "forge-focus-indicator",
           "customElement": true,
-          "summary": "Renders a focus indicator when an attached element matches `:focus-visible`.",
+          "summary": "Focus indicators show a \"focus ring\" around an attached element that matches `:focus-visible`. These are building block components used by other components to show focus state, and are not typically used directly.",
           "cssClasses": [
             {
               "name": "forge-focus-indicator",
@@ -10321,7 +10307,7 @@
           },
           "tagName": "forge-icon",
           "customElement": true,
-          "summary": "Icons are used to represent information visually",
+          "summary": "Icons are used to represent information visually. The icon component is a wrapper around SVG icons that are registered in the icon registry.",
           "cssClasses": [
             {
               "name": "forge-icon",
@@ -10808,7 +10794,7 @@
           },
           "tagName": "forge-icon-button",
           "customElement": true,
-          "summary": "A clickable button component that displays an icon with support for different variants, themes, toggle states, and accessibility features.",
+          "summary": "Icon buttons are buttons that contain **only** an icon, and are used to represent actions or commands. Always provide an accessible label when using icon buttons.",
           "globalConfigProperties": [
             {
               "name": "variant",
@@ -11058,7 +11044,7 @@
           },
           "tagName": "forge-inline-message",
           "customElement": true,
-          "summary": "Inline messages are used to provide feedback to the user about a specific action or state.",
+          "summary": "Inline messages are used to provide feedback to the user about a specific action or state. Use inline messages to communicate information such as errors, warnings, or success messages in a way that is contextual to the content on the page.",
           "cssClasses": [
             {
               "name": "forge-inline-message",
@@ -11472,7 +11458,7 @@
           },
           "tagName": "forge-label",
           "customElement": true,
-          "summary": "The Forge Label component is used to associate a text label with a compatible Forge component.",
+          "summary": "The Label component is used to associate a text label with a compatible Forge component.",
           "cssClasses": [
             {
               "name": "forge-label",
@@ -11688,7 +11674,7 @@
           },
           "tagName": "forge-label-value",
           "customElement": true,
-          "summary": "Label-value pairs are used to display a label and a value in a compact format.",
+          "summary": "Label values are used to display a label and value pair in a compact format with the proper typography and spacing styles applied.",
           "cssClasses": [
             {
               "name": "forge-label-value",
@@ -11880,7 +11866,7 @@
           },
           "tagName": "forge-linear-progress",
           "customElement": true,
-          "summary": "Linear progress indicators display progress by animating along a linear track in a horizontal direction."
+          "summary": "Linear progress indicators display progress by animating along a linear track in a horizontal direction. They can be used to show determinate or indeterminate progress."
         }
       ],
       "exports": [
@@ -12636,6 +12622,17 @@
               "description": "Gets the currently active popup element when the dropdown is open.",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "popupTarget",
+              "type": {
+                "text": "string | null"
+              },
+              "privacy": "public",
+              "description": "Gets/sets the ID of the element to use as the popup anchor for positioning.\nWhen null or empty, the target element (button) is used for both interaction and positioning.\nThis is useful for cases like forge-list-item > button where the menu should be\nattached to the button for listeners but positioned relative to the list item.",
+              "default": "null",
+              "attribute": "popup-target"
+            },
             {
               "kind": "method",
               "name": "propagateKeyEvent",
@@ -12870,6 +12867,36 @@
               }
             }
           ],
+          "events": [
+            {
+              "type": {
+                "text": "CustomEvent<IMenuSelectEventData>"
+              },
+              "description": "Dispatches when a menu option is selected.",
+              "name": "forge-menu-select"
+            },
+            {
+              "type": {
+                "text": "CustomEvent<void>"
+              },
+              "description": "Dispatches when the menu is opened.",
+              "name": "forge-menu-open"
+            },
+            {
+              "type": {
+                "text": "CustomEvent<void>"
+              },
+              "description": "Dispatches when the menu is closed.",
+              "name": "forge-menu-close"
+            },
+            {
+              "type": {
+                "text": "CustomEvent<IMenuActiveChangeEventData>"
+              },
+              "description": "Dispatches when the active menu option changes.",
+              "name": "forge-menu-active-change"
+            }
+          ],
           "attributes": [
             {
               "name": "open",
@@ -12941,6 +12968,15 @@
               "default": "\"click\"",
               "fieldName": "mode"
             },
+            {
+              "name": "popup-target",
+              "type": {
+                "text": "string | null"
+              },
+              "description": "Gets/sets the ID of the element to use as the popup anchor for positioning.\nWhen null or empty, the target element (button) is used for both interaction and positioning.\nThis is useful for cases like forge-list-item > button where the menu should be\nattached to the button for listeners but positioned relative to the list item.",
+              "default": "null",
+              "fieldName": "popupTarget"
+            },
             {
               "name": "popup-classes",
               "type": {
@@ -13101,7 +13137,7 @@
           },
           "tagName": "forge-menu",
           "customElement": true,
-          "summary": "Menus display a list of options or actions that users can select from a dropdown.",
+          "summary": "Menus display a list of options or actions that users can select from a dropdown. Menus wrap button or list item elements to provide the trigger for displaying the menu options.",
           "dependencies": [
             {
               "name": "forge-popover",
@@ -13276,7 +13312,7 @@
           },
           "tagName": "forge-open-icon",
           "customElement": true,
-          "summary": "Open icons are used to indicate whether a section is open or closed."
+          "summary": "Open icons are icons used to indicate whether a section is open or closed. They provide an animated transition between the two states to enhance the user experience."
         }
       ],
       "exports": [
@@ -13695,7 +13731,7 @@
           },
           "tagName": "forge-overlay",
           "customElement": true,
-          "summary": "Overlays are used to render content in an element that rendered above all content on the page,\nand positioned around a specified anchor element.",
+          "summary": "Overlays are used to show content in an element that is rendered above all other content on the page, and positioned around a specified anchor element. This is a low-level building block component that does not provide any visual styles, but is used within other components such as popovers, and tooltips.",
           "globalConfigProperties": [
             {
               "name": "placement",
@@ -13847,7 +13883,7 @@
           },
           "tagName": "forge-page-state",
           "customElement": true,
-          "summary": "Page states display full-page messages for empty states, errors, or loading scenarios.",
+          "summary": "Page states display full-height messages for empty states, errors, or other general information. They can be used as full page content, or within smaller containers and will adapt accordingly.",
           "cssClasses": [
             {
               "name": "forge-page-state",
@@ -14060,6 +14096,94 @@
                 }
               ],
               "description": "Sets focus to the first focusable element within the paginator."
+            },
+            {
+              "kind": "method",
+              "name": "goToFirstPage",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Navigates to the first page."
+            },
+            {
+              "kind": "method",
+              "name": "goToPreviousPage",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Navigates to the previous page."
+            },
+            {
+              "kind": "method",
+              "name": "goToNextPage",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Navigates to the next page."
+            },
+            {
+              "kind": "method",
+              "name": "goToLastPage",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Navigates to the last page."
+            },
+            {
+              "kind": "method",
+              "name": "canGoToFirstPage",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              },
+              "description": "Checks if navigation to the first page is possible."
+            },
+            {
+              "kind": "method",
+              "name": "canGoToPreviousPage",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              },
+              "description": "Checks if navigation to the previous page is possible."
+            },
+            {
+              "kind": "method",
+              "name": "canGoToNextPage",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              },
+              "description": "Checks if navigation to the next page is possible."
+            },
+            {
+              "kind": "method",
+              "name": "canGoToLastPage",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              },
+              "description": "Checks if navigation to the last page is possible."
             }
           ],
           "events": [
@@ -14169,7 +14293,7 @@
           },
           "tagName": "forge-paginator",
           "customElement": true,
-          "summary": "Paginators provide navigation controls for dividing content across multiple pages."
+          "summary": "Paginators provide navigation controls for dividing content across multiple pages. Typically used alongside data tables or lists."
         }
       ],
       "exports": [
@@ -14444,6 +14568,16 @@
               "description": "Enforces that this popover should be the only one open with the same unique value.",
               "default": "null"
             },
+            {
+              "kind": "field",
+              "name": "anchorAccessibility",
+              "type": {
+                "text": "PopoverAnchorAccessibility"
+              },
+              "privacy": "public",
+              "description": "Controls whether the popover manages accessibility attributes on the anchor element.",
+              "default": "\"auto\""
+            },
             {
               "kind": "method",
               "name": "hideAsync",
@@ -14779,6 +14913,14 @@
               "name": "distinct",
               "default": "null"
             },
+            {
+              "type": {
+                "text": "string"
+              },
+              "description": "Controls whether the popover manages accessibility attributes on the anchor element.",
+              "name": "anchor-accessibility",
+              "default": "\"auto\""
+            },
             {
               "type": {
                 "text": "string | null"
@@ -14927,7 +15069,7 @@
           },
           "tagName": "forge-popover",
           "customElement": true,
-          "summary": "Popovers are used to render content in an element that is above all other content on the page.",
+          "summary": "Popovers are used to show content in an element that is rendered above all other content on the page. Use popovers to display additional information or actions related to a specific element. Popovers are typically triggered by user interaction, such as clicking a button or hovering over an element.",
           "dependencies": [
             {
               "name": "forge-overlay",
@@ -15104,7 +15246,7 @@
           },
           "tagName": "forge-profile-card",
           "customElement": true,
-          "summary": "Profile cards display user information and actions in a structured card format."
+          "summary": "Profile cards display user information and actions in a structured card format. This component is deprecated prefer using the `<forge-user-profile>` component from the extended library instead."
         }
       ],
       "exports": [
@@ -15224,7 +15366,7 @@
           },
           "tagName": "forge-scaffold",
           "customElement": true,
-          "summary": "A scaffold provides a generic layout structure for your content using common named areas.",
+          "summary": "The scaffold provides a generic layout structure for your content using common named areas. Use scaffolds for full page layouts or smaller sections within other elements where you want positioned content areas and scrollable body content.",
           "cssClasses": [
             {
               "name": "forge-scaffold",
@@ -15413,7 +15555,7 @@
           },
           "tagName": "forge-skeleton",
           "customElement": true,
-          "summary": "Skeleton is used to provide a placeholder for content that is loading.",
+          "summary": "Skeletons are used to provide a placeholder for content that is loading. They have various styles to represent different types of content.",
           "cssClasses": [
             {
               "name": "forge-skeleton",
@@ -15750,7 +15892,7 @@
           },
           "tagName": "forge-skip-link",
           "customElement": true,
-          "summary": "The Forge Skip Link component is used to provide a way for users to skip repetitive content and navigate directly to a section of the page.",
+          "summary": "The Forge Skip Link component is used to provide an accessible way for users to skip repetitive content and navigate directly to a section of the page. This is used for screen reader and keyboard users to improve the overall accessibility of web applications.",
           "dependencies": [
             {
               "name": "forge-focus-indicator",
@@ -16322,7 +16464,7 @@
           },
           "tagName": "forge-slider",
           "customElement": true,
-          "summary": "Sliders allow users to make selections from a range of values.",
+          "summary": "Sliders allow users to make selections from a range of values. You can use sliders for selecting values from either a continuous or discrete range, and they can also be used for selecting a single value or a range of values.",
           "dependencies": [
             {
               "name": "forge-focus-indicator",
@@ -16478,7 +16620,7 @@
           },
           "tagName": "forge-split-button",
           "customElement": true,
-          "summary": "Split buttons are used for splitting an action into two parts.",
+          "summary": "Split buttons are used for splitting an action into two parts, typically a primary action and a secondary action that opens a menu or performs an alternative action. Split buttons expect child Forge buttons as their content.",
           "dependencies": [
             {
               "name": "forge-button",
@@ -16670,7 +16812,7 @@
           },
           "tagName": "forge-stack",
           "customElement": true,
-          "summary": "The stack is a utility component that helps manage spacing and alignment of immediate children along a vertical or horizontal axis.",
+          "summary": "The stack is a utility component that helps manage spacing and alignment of immediate children along a vertical or horizontal axis. Use stacks sparingly to avoid unnecessary DOM complexity, and prefer CSS flexbox or grid for more complex layouts.",
           "cssClasses": [
             {
               "name": "forge-stack",
@@ -16852,7 +16994,7 @@
           },
           "tagName": "forge-state-layer",
           "customElement": true,
-          "summary": "State layers show the interaction status of an element.",
+          "summary": "State layers show the interaction status of an element. These layers are semi-transparent overlays that indicate hover, focus, press, and drag states. State layers are building blocks for components and should generally not be used directly, but part of other components that have interactive states.",
           "cssClasses": [
             {
               "name": "forge-state-layer",
@@ -18107,7 +18249,7 @@
               },
               "privacy": "public",
               "description": "Controls the visibility of the select column.",
-              "default": "true",
+              "default": "false",
               "attribute": "select"
             },
             {
@@ -18379,7 +18521,7 @@
                 "text": "boolean"
               },
               "description": "Controls the visibility of the select column.",
-              "default": "true",
+              "default": "false",
               "fieldName": "select"
             },
             {
@@ -18521,7 +18663,7 @@
           },
           "tagName": "forge-table",
           "customElement": true,
-          "summary": "A comprehensive data table component with features for selection, sorting, filtering, resizing, and row expansion functionality.",
+          "summary": "Tables are used to display sets of data. They organize information into rows and columns, making it easier to read, compare, and analyze. The Forge table provides a configuration-based approach to building data tables with means for sorting, filtering, selecting, and customizing the display of tabular data.",
           "dependencies": [
             {
               "name": "forge-expansion-panel",
@@ -19212,7 +19354,7 @@
           },
           "tagName": "forge-text-field",
           "customElement": true,
-          "summary": "The Forge Text Field component wraps and styles an input or textarea element.",
+          "summary": "The Forge Text Field component is an input field used to capture user text input. It requires a child `<input>` or `<textarea>` element to function properly, and an optional `<label>` element can be used to provide a label for the `<input>`.",
           "dependencies": [
             {
               "name": "forge-field",
@@ -20375,7 +20517,7 @@
           },
           "tagName": "forge-toast",
           "customElement": true,
-          "summary": "Toasts are non-modal notifications that appear in response to user interactions.",
+          "summary": "Toasts are non-modal notifications that appear in response to user interactions. Use toasts to provide brief messages about app processes at the bottom or top of the screen. They automatically disappear after a timeout, but can also include an action button and a dismiss button.",
           "dependencies": [
             {
               "name": "forge-overlay",
@@ -20608,7 +20750,7 @@
           },
           "tagName": "forge-toolbar",
           "customElement": true,
-          "summary": "Toolbars allow you to place titles and actions within a container and align them to the start, center, or end of the toolbar.\nThis component is useful as headers and footers within pages, dialogs, sections... etc. to ensure consistent layout and alignment.",
+          "summary": "Toolbars allow you to place titles and actions within a container and align them to the start, center, or end of the toolbar. This component is useful as headers and footers within pages, dialogs, sections... etc. to ensure consistent layout and alignment.",
           "cssClasses": [
             {
               "name": "forge-toolbar",
@@ -21007,7 +21149,7 @@
           },
           "tagName": "forge-tooltip",
           "customElement": true,
-          "summary": "Tooltips display information related to an element when the user hovers over an element.",
+          "summary": "Tooltips display information related to an element when the user focuses or hovers over an anchor element. Use tooltips to provide additional context or information about elements that may not be immediately apparent.",
           "dependencies": [
             {
               "name": "forge-overlay",
@@ -21181,7 +21323,7 @@
           },
           "tagName": "forge-view-switcher",
           "customElement": true,
-          "summary": "A container component that manages switching between multiple child views with configurable animations and programmatic navigation controls.",
+          "summary": "A container component that manages switching between multiple child `<forge-view>` elements with configurable animations and programmatic navigation controls.",
           "dependencies": [
             {
               "name": "forge-view",
@@ -21414,7 +21556,7 @@
           },
           "tagName": "forge-app-bar",
           "customElement": true,
-          "summary": "App bars are a collection of components placed as a horizontal bar at the top of the screen. They typically contain a logo, title, and optional application-wide actions.",
+          "summary": "App bars are headers used to display branding, navigation, and actions at the top of an application. They typically contain a logo, title, and various action items.",
           "cssClasses": [
             {
               "name": "forge-app-bar",
@@ -22699,7 +22841,7 @@
           },
           "tagName": "forge-button-toggle",
           "customElement": true,
-          "summary": "Toggle buttons allow users to select from a group of choices with single or multiple selection."
+          "summary": "Button toggles allow users to select from a group of choices with single or multiple selection."
         }
       ],
       "exports": [
@@ -23158,7 +23300,7 @@
           },
           "tagName": "forge-button-toggle-group",
           "customElement": true,
-          "summary": "Button toggle groups allow users to select one or more options from a set of related options."
+          "summary": "Button toggle groups allow users to select one or more options from a set of button toggles."
         }
       ],
       "exports": [
@@ -23755,6 +23897,15 @@
               },
               "privacy": "public",
               "description": "The rel of the chip."
+            },
+            {
+              "kind": "field",
+              "name": "removeButtonLabel",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "public",
+              "description": "The custom aria-label for the remove button."
             }
           ],
           "events": [
@@ -23850,6 +24001,13 @@
               },
               "description": "The rel of the chip.",
               "name": "rel"
+            },
+            {
+              "type": {
+                "text": "string"
+              },
+              "description": "The custom aria-label for the remove button.",
+              "name": "remove-button-label"
             }
           ],
           "superclass": {
@@ -24130,7 +24288,7 @@
           },
           "tagName": "forge-chip-set",
           "customElement": true,
-          "summary": "Chips sets are used to group multiple chips together and orchestrate their behavior.",
+          "summary": "Chip sets are used to group multiple chips together and orchestrate their behavior.",
           "cssFilePath": {
             "name": "chips/forge-chips.css",
             "description": ""
@@ -25241,7 +25399,7 @@
           },
           "tagName": "forge-drawer",
           "customElement": true,
-          "summary": "A persistent side navigation drawer component that provides a sliding panel for navigation content.",
+          "summary": "A persistent side navigation drawer component that provides the ability to dismiss and open the drawer with smooth animations. Use for navigation or to display additional content alongside the main application content.",
           "cssClasses": [
             {
               "name": "forge-drawer",
@@ -25688,7 +25846,7 @@
           },
           "tagName": "forge-modal-drawer",
           "customElement": true,
-          "summary": "A modal navigation drawer component that slides in from the side with a backdrop overlay, typically used for temporary navigation panels.",
+          "summary": "A modal navigation drawer component that slides in from the side with a backdrop overlay, typically used for temporary navigation panels. Prefer to use the dialog component with the preset options for sidesheet styles drawers.",
           "dependencies": [
             {
               "name": "forge-backdrop",
@@ -27205,7 +27363,7 @@
           },
           "tagName": "forge-list",
           "customElement": true,
-          "summary": "Lists are vertical groupings of related content.",
+          "summary": "Lists are vertically oriented groups of related content that allow users to select or view one or more items from a set.",
           "cssClasses": [
             {
               "name": "forge-list",
@@ -29427,7 +29585,7 @@
           },
           "tagName": "forge-radio",
           "customElement": true,
-          "summary": "The Forge Radio component is used to create a form input where only one out of a set of\nvalues should be selected.",
+          "summary": "The Forge Radio component is used to create a form input where only one out of a set of values should be selected.",
           "cssClasses": [
             {
               "name": "forge-radio",
@@ -29810,7 +29968,7 @@
           },
           "tagName": "forge-option",
           "customElement": true,
-          "summary": "Options represent individual selectable items within select components and menus."
+          "summary": "Options represent individual selectable items within `<forge-select>` components."
         }
       ],
       "exports": [
@@ -31062,7 +31220,7 @@
           },
           "tagName": "forge-select",
           "customElement": true,
-          "summary": "Selects present a list of options to users for single or multi-selection.",
+          "summary": "Select components are comboboxes that present a list of options to users for single or multi-selection.",
           "dependencies": [
             {
               "name": "forge-field",
@@ -33236,7 +33394,7 @@
           },
           "tagName": "forge-tab",
           "customElement": true,
-          "summary": "Individual tab elements that provide navigation between different content panels.",
+          "summary": "Tab components represent a single tab inside a tab bar.",
           "dependencies": [
             {
               "name": "forge-focus-indicator",
@@ -33480,7 +33638,7 @@
           },
           "tagName": "forge-tab-bar",
           "customElement": true,
-          "summary": "Tabs organize content across different screens and views.",
+          "summary": "Tab bars organize a set of tabs, holding selection state and enabling navigation between different views or sections of content.",
           "dependencies": [
             {
               "name": "forge-tab",
@@ -33522,7 +33680,7 @@
           },
           "tagName": "forge-view",
           "customElement": true,
-          "summary": "A wrapper component that represents a single view content area within a view-switcher for organizing and displaying content sections."
+          "summary": "Represents a single view content area within a view-switcher for organizing and displaying content sections."
         }
       ],
       "exports": [
@@ -33833,7 +33991,7 @@
     },
     "ButtonComponent": {
       "path": "src/lib/button/button.ts",
-      "lineNumber": 158
+      "lineNumber": 153
     },
     "IButtonAreaAdapter": {
       "path": "src/lib/button-area/button-area-adapter.ts",
@@ -33857,7 +34015,7 @@
     },
     "ButtonAreaComponent": {
       "path": "src/lib/button-area/button-area.ts",
-      "lineNumber": 47
+      "lineNumber": 44
     },
     "ICalendarAdapter": {
       "path": "src/lib/calendar/calendar-adapter.ts",
@@ -34129,7 +34287,7 @@
     },
     "CircularProgressComponent": {
       "path": "src/lib/circular-progress/circular-progress.ts",
-      "lineNumber": 63
+      "lineNumber": 62
     },
     "IColorPickerAdapter": {
       "path": "src/lib/color-picker/color-picker-adapter.ts",
@@ -34421,7 +34579,7 @@
     },
     "FieldComponent": {
       "path": "src/lib/field/field.ts",
-      "lineNumber": 183
+      "lineNumber": 182
     },
     "IFilePickerAdapter": {
       "path": "src/lib/file-picker/file-picker-adapter.ts",
@@ -34465,7 +34623,7 @@
     },
     "FilePickerComponent": {
       "path": "src/lib/file-picker/file-picker.ts",
-      "lineNumber": 82
+      "lineNumber": 81
     },
     "IFloatingActionButtonAdapter": {
       "path": "src/lib/floating-action-button/floating-action-button-adapter.ts",
@@ -34773,7 +34931,7 @@
     },
     "LinearProgressComponent": {
       "path": "src/lib/linear-progress/linear-progress.ts",
-      "lineNumber": 59
+      "lineNumber": 58
     },
     "ICascadingListDropdownAwareCore": {
       "path": "src/lib/list-dropdown/cascading-list-dropdown-aware-core.ts",
@@ -34813,67 +34971,71 @@
     },
     "ListDropdownOptionBuilder": {
       "path": "src/lib/list-dropdown/list-dropdown-constants.ts",
-      "lineNumber": 44
+      "lineNumber": 45
     },
     "ListDropdownHeaderBuilder": {
       "path": "src/lib/list-dropdown/list-dropdown-constants.ts",
-      "lineNumber": 45
+      "lineNumber": 46
     },
     "ListDropdownFooterBuilder": {
       "path": "src/lib/list-dropdown/list-dropdown-constants.ts",
-      "lineNumber": 46
+      "lineNumber": 47
     },
     "ListDropdownOptionGroupBuilder": {
       "path": "src/lib/list-dropdown/list-dropdown-constants.ts",
-      "lineNumber": 47
+      "lineNumber": 48
     },
     "ListDropdownTransformCallback": {
       "path": "src/lib/list-dropdown/list-dropdown-constants.ts",
-      "lineNumber": 48
+      "lineNumber": 49
     },
     "ListDropdownIconType": {
       "path": "src/lib/list-dropdown/list-dropdown-constants.ts",
-      "lineNumber": 49
+      "lineNumber": 50
     },
     "IBaseListDropdownOption": {
       "path": "src/lib/list-dropdown/list-dropdown-constants.ts",
-      "lineNumber": 51
+      "lineNumber": 52
     },
     "IListDropdownOption": {
       "path": "src/lib/list-dropdown/list-dropdown-constants.ts",
-      "lineNumber": 71
+      "lineNumber": 72
     },
     "IListDropdownOptionGroup": {
       "path": "src/lib/list-dropdown/list-dropdown-constants.ts",
-      "lineNumber": 76
+      "lineNumber": 77
     },
     "IListDropdownSelectEventData": {
       "path": "src/lib/list-dropdown/list-dropdown-constants.ts",
-      "lineNumber": 83
+      "lineNumber": 84
     },
     "IListDropdownConfig": {
       "path": "src/lib/list-dropdown/list-dropdown-constants.ts",
-      "lineNumber": 87
+      "lineNumber": 88
     },
     "IListDropdownCascadingElementFactoryConfig": {
       "path": "src/lib/list-dropdown/list-dropdown-constants.ts",
-      "lineNumber": 130
+      "lineNumber": 132
     },
     "IListDropdownOpenConfig": {
       "path": "src/lib/list-dropdown/list-dropdown-constants.ts",
-      "lineNumber": 143
+      "lineNumber": 145
     },
     "ListDropdownType": {
       "path": "src/lib/list-dropdown/list-dropdown-constants.ts",
-      "lineNumber": 145
+      "lineNumber": 147
     },
     "ListDropdownAsyncStyle": {
       "path": "src/lib/list-dropdown/list-dropdown-constants.ts",
-      "lineNumber": 151
+      "lineNumber": 153
     },
     "ListDropdownTooltipConfig": {
       "path": "src/lib/list-dropdown/list-dropdown-constants.ts",
-      "lineNumber": 156
+      "lineNumber": 158
+    },
+    "ListDropdownTooltipVisibilityMode": {
+      "path": "src/lib/list-dropdown/list-dropdown-constants.ts",
+      "lineNumber": 169
     },
     "IListDropdownCore": {
       "path": "src/lib/list-dropdown/list-dropdown-core.ts",
@@ -34885,7 +35047,7 @@
     },
     "ListDropdownOptionType": {
       "path": "src/lib/list-dropdown/list-dropdown-utils.ts",
-      "lineNumber": 21
+      "lineNumber": 23
     },
     "IListDropdown": {
       "path": "src/lib/list-dropdown/list-dropdown.ts",
@@ -34901,35 +35063,35 @@
     },
     "MenuAdapter": {
       "path": "src/lib/menu/menu-adapter.ts",
-      "lineNumber": 43
+      "lineNumber": 44
     },
     "IMenuSelectEventData": {
       "path": "src/lib/menu/menu-constants.ts",
-      "lineNumber": 52
+      "lineNumber": 53
     },
     "IMenuActiveChangeEventData": {
       "path": "src/lib/menu/menu-constants.ts",
-      "lineNumber": 58
+      "lineNumber": 59
     },
     "IMenuOption": {
       "path": "src/lib/menu/menu-constants.ts",
-      "lineNumber": 62
+      "lineNumber": 63
     },
     "IMenuOptionGroup": {
       "path": "src/lib/menu/menu-constants.ts",
-      "lineNumber": 67
+      "lineNumber": 68
     },
     "MenuOptionBuilder": {
       "path": "src/lib/menu/menu-constants.ts",
-      "lineNumber": 69
+      "lineNumber": 70
     },
     "MenuOptionFactory": {
       "path": "src/lib/menu/menu-constants.ts",
-      "lineNumber": 70
+      "lineNumber": 71
     },
     "MenuMode": {
       "path": "src/lib/menu/menu-constants.ts",
-      "lineNumber": 71
+      "lineNumber": 72
     },
     "IMenuCore": {
       "path": "src/lib/menu/menu-core.ts",
@@ -34937,7 +35099,7 @@
     },
     "MenuCore": {
       "path": "src/lib/menu/menu-core.ts",
-      "lineNumber": 45
+      "lineNumber": 46
     },
     "IMenuComponent": {
       "path": "src/lib/menu/menu.ts",
@@ -34945,7 +35107,7 @@
     },
     "MenuComponent": {
       "path": "src/lib/menu/menu.ts",
-      "lineNumber": 65
+      "lineNumber": 71
     },
     "OpenIconOrientation": {
       "path": "src/lib/open-icon/open-icon-constants.ts",
@@ -34961,7 +35123,7 @@
     },
     "OpenIconComponent": {
       "path": "src/lib/open-icon/open-icon.ts",
-      "lineNumber": 50
+      "lineNumber": 51
     },
     "IOverlayAdapter": {
       "path": "src/lib/overlay/overlay-adapter.ts",
@@ -35025,7 +35187,7 @@
     },
     "OverlayComponent": {
       "path": "src/lib/overlay/overlay.ts",
-      "lineNumber": 92
+      "lineNumber": 91
     },
     "IPageStateComponent": {
       "path": "src/lib/page-state/page-state.ts",
@@ -35065,7 +35227,7 @@
     },
     "PaginatorCore": {
       "path": "src/lib/paginator/paginator-core.ts",
-      "lineNumber": 21
+      "lineNumber": 29
     },
     "IPaginatorComponent": {
       "path": "src/lib/paginator/paginator.ts",
@@ -35073,7 +35235,7 @@
     },
     "PaginatorComponent": {
       "path": "src/lib/paginator/paginator.ts",
-      "lineNumber": 54
+      "lineNumber": 62
     },
     "IPopoverAdapter": {
       "path": "src/lib/popover/popover-adapter.ts",
@@ -35085,43 +35247,47 @@
     },
     "PopoverAnimationType": {
       "path": "src/lib/popover/popover-constants.ts",
-      "lineNumber": 63
+      "lineNumber": 65
     },
     "PopoverTriggerType": {
       "path": "src/lib/popover/popover-constants.ts",
-      "lineNumber": 64
+      "lineNumber": 66
     },
     "PopoverDismissReason": {
       "path": "src/lib/popover/popover-constants.ts",
-      "lineNumber": 65
+      "lineNumber": 67
     },
     "PopoverPreset": {
       "path": "src/lib/popover/popover-constants.ts",
-      "lineNumber": 66
+      "lineNumber": 68
+    },
+    "PopoverAnchorAccessibility": {
+      "path": "src/lib/popover/popover-constants.ts",
+      "lineNumber": 69
     },
     "IPopoverToggleEventData": {
       "path": "src/lib/popover/popover-constants.ts",
-      "lineNumber": 68
+      "lineNumber": 71
     },
     "IPopoverCore": {
       "path": "src/lib/popover/popover-core.ts",
-      "lineNumber": 18
+      "lineNumber": 19
     },
     "PopoverCore": {
       "path": "src/lib/popover/popover-core.ts",
-      "lineNumber": 32
+      "lineNumber": 34
     },
     "IPopoverProperties": {
       "path": "src/lib/popover/popover.ts",
-      "lineNumber": 13
+      "lineNumber": 20
     },
     "IPopoverComponent": {
       "path": "src/lib/popover/popover.ts",
-      "lineNumber": 25
+      "lineNumber": 33
     },
     "PopoverComponent": {
       "path": "src/lib/popover/popover.ts",
-      "lineNumber": 123
+      "lineNumber": 133
     },
     "IProfileCardAdapter": {
       "path": "src/lib/profile-card/profile-card-adapter.ts",
@@ -35145,7 +35311,7 @@
     },
     "ProfileCardComponent": {
       "path": "src/lib/profile-card/profile-card.ts",
-      "lineNumber": 43
+      "lineNumber": 44
     },
     "IScaffoldComponent": {
       "path": "src/lib/scaffold/scaffold.ts",
@@ -35309,7 +35475,7 @@
     },
     "StackComponent": {
       "path": "src/lib/stack/stack.ts",
-      "lineNumber": 59
+      "lineNumber": 52
     },
     "IStateLayerAdapter": {
       "path": "src/lib/state-layer/state-layer-adapter.ts",
@@ -35401,7 +35567,7 @@
     },
     "TableAdapter": {
       "path": "src/lib/table/table-adapter.ts",
-      "lineNumber": 68
+      "lineNumber": 70
     },
     "ITableCore": {
       "path": "src/lib/table/table-core.ts",
@@ -35573,7 +35739,7 @@
     },
     "TextFieldAdapter": {
       "path": "src/lib/text-field/text-field-adapter.ts",
-      "lineNumber": 25
+      "lineNumber": 26
     },
     "TextFieldComponentDelegateProps": {
       "path": "src/lib/text-field/text-field-component-delegate.ts",
@@ -35697,7 +35863,7 @@
     },
     "ToastAdapter": {
       "path": "src/lib/toast/toast-adapter.ts",
-      "lineNumber": 20
+      "lineNumber": 30
     },
     "ToastPlacement": {
       "path": "src/lib/toast/toast-constants.ts",
@@ -35709,27 +35875,27 @@
     },
     "IToastCore": {
       "path": "src/lib/toast/toast-core.ts",
-      "lineNumber": 4
+      "lineNumber": 5
     },
     "ToastCore": {
       "path": "src/lib/toast/toast-core.ts",
-      "lineNumber": 14
+      "lineNumber": 15
     },
     "IToastProperties": {
       "path": "src/lib/toast/toast.ts",
-      "lineNumber": 19
+      "lineNumber": 20
     },
     "IToastPresentConfiguration": {
       "path": "src/lib/toast/toast.ts",
-      "lineNumber": 29
+      "lineNumber": 30
     },
     "IToastComponent": {
       "path": "src/lib/toast/toast.ts",
-      "lineNumber": 37
+      "lineNumber": 38
     },
     "ToastComponent": {
       "path": "src/lib/toast/toast.ts",
-      "lineNumber": 110
+      "lineNumber": 111
     },
     "IToolbarComponent": {
       "path": "src/lib/toolbar/toolbar.ts",
@@ -35737,7 +35903,7 @@
     },
     "ToolbarComponent": {
       "path": "src/lib/toolbar/toolbar.ts",
-      "lineNumber": 72
+      "lineNumber": 70
     },
     "ITooltipAdapter": {
       "path": "src/lib/tooltip/tooltip-adapter.ts",
@@ -36129,31 +36295,31 @@
     },
     "ChipAdapter": {
       "path": "src/lib/chips/chip/chip-adapter.ts",
-      "lineNumber": 35
+      "lineNumber": 36
     },
     "ChipTheme": {
       "path": "src/lib/chips/chip/chip-constants.ts",
-      "lineNumber": 48
+      "lineNumber": 49
     },
     "ChipType": {
       "path": "src/lib/chips/chip/chip-constants.ts",
-      "lineNumber": 49
+      "lineNumber": 50
     },
     "IChipSelectEventData": {
       "path": "src/lib/chips/chip/chip-constants.ts",
-      "lineNumber": 51
+      "lineNumber": 52
     },
     "IChipDeleteEventData": {
       "path": "src/lib/chips/chip/chip-constants.ts",
-      "lineNumber": 56
+      "lineNumber": 57
     },
     "IChipState": {
       "path": "src/lib/chips/chip/chip-constants.ts",
-      "lineNumber": 60
+      "lineNumber": 61
     },
     "IChipNavigateEventData": {
       "path": "src/lib/chips/chip/chip-constants.ts",
-      "lineNumber": 66
+      "lineNumber": 67
     },
     "IChipCore": {
       "path": "src/lib/chips/chip/chip-core.ts",
@@ -36161,7 +36327,7 @@
     },
     "ChipCore": {
       "path": "src/lib/chips/chip/chip-core.ts",
-      "lineNumber": 21
+      "lineNumber": 22
     },
     "IChipComponent": {
       "path": "src/lib/chips/chip/chip.ts",
@@ -36169,7 +36335,7 @@
     },
     "ChipComponent": {
       "path": "src/lib/chips/chip/chip.ts",
-      "lineNumber": 137
+      "lineNumber": 140
     },
     "IChipSetComponent": {
       "path": "src/lib/chips/chip-set/chip-set.ts",
@@ -36311,6 +36477,10 @@
       "path": "src/lib/core/mask/time-segment-parser.ts",
       "lineNumber": 15
     },
+    "TestHarness": {
+      "path": "src/lib/core/testing/test-harness.ts",
+      "lineNumber": 1
+    },
     "CustomStateSet": {
       "path": "src/lib/core/utils/a11y-utils.ts",
       "lineNumber": 17
@@ -36553,7 +36723,7 @@
     },
     "BaseDrawerAdapter": {
       "path": "src/lib/drawer/base/base-drawer-adapter.ts",
-      "lineNumber": 16
+      "lineNumber": 17
     },
     "DrawerDirection": {
       "path": "src/lib/drawer/base/base-drawer-constants.ts",
@@ -36877,7 +37047,7 @@
     },
     "RadioComponent": {
       "path": "src/lib/radio/radio/radio.ts",
-      "lineNumber": 84
+      "lineNumber": 83
     },
     "IRadioGroupAdapter": {
       "path": "src/lib/radio/radio-group/radio-group-adapter.ts",