@esri/calcite-components 1.0.0-beta.79 → 1.0.0-beta.82

package/dist/types/components.d.ts

@@ -7,7 +7,6 @@
 import { HTMLStencilElement, JSXBase } from "./stencil-public-runtime";
 import { AccordionAppearance } from "./components/accordion/interfaces";
 import { Alignment, Appearance, Columns, FlipContext, Layout, Position, Scale, Status, Width } from "./components/interfaces";
-import { Placement } from "@popperjs/core";
 import { ComputedPlacement, MenuPlacement, OverlayPositioning, PopperPlacement } from "./utils/popper";
 import { AlertDuration, AlertPlacement, StatusColor } from "./components/alert/interfaces";
 import { HeadingLevel } from "./components/functional/Heading";
@@ -29,6 +28,7 @@ import { PaginationDetail } from "./components/pagination/pagination";
 import { ListFocusId } from "./components/pick-list/shared-list-logic";
 import { ICON_TYPES } from "./components/pick-list/resources";
 import { RadioAppearance } from "./components/radio-group/interfaces";
+import { StepperItemChangeEventDetail, StepperItemEventDetail, StepperItemKeyEventDetail } from "./components/stepper/interfaces";
 import { TabID, TabLayout, TabPosition } from "./components/tabs/interfaces";
 import { TabChangeEventDetail } from "./components/tab/interfaces";
 import { TileSelectType } from "./components/tile-select/interfaces";
@@ -208,7 +208,7 @@ export namespace Components {
         /**
           * Defines the available placements that can be used when a flip occurs.
          */
-        "flipPlacements"?: Placement[];
+        "flipPlacements"?: ComputedPlacement[];
         /**
           * Text string for the actions menu.
          */
@@ -356,11 +356,11 @@ export namespace Components {
          */
         "headingLevel": HeadingLevel;
         /**
-          * Tooltip used for the toggle when expanded.
+          * Aria-label for collapsing the toggle and tooltip used for the toggle when expanded.
          */
         "intlCollapse"?: string;
         /**
-          * Tooltip used for the toggle when collapsed.
+          * Aria-label for expanding the toggle and tooltip used for the toggle when collapsed.
          */
         "intlExpand"?: string;
         /**
@@ -498,7 +498,7 @@ export namespace Components {
         /**
           * The type attribute to apply to the button
          */
-        "type"?: string;
+        "type": string;
         /**
           * specify the width of the button, defaults to auto
          */
@@ -1474,6 +1474,10 @@ export namespace Components {
           * flip the icon in rtl
          */
         "iconFlipRtl": boolean;
+        /**
+          * A text label that will appear on the clear button for screen readers.
+         */
+        "intlClear"?: string;
         /**
           * string to override English loading text
           * @default "Loading"
@@ -1658,6 +1662,11 @@ export namespace Components {
           * Describes the type of positioning to use for the overlaid content. If your element is in a fixed container, use the 'fixed' value.
          */
         "overlayPositioning": OverlayPositioning;
+        /**
+          * Determines where the date-picker component will be positioned relative to the input.
+          * @default "bottom-leading"
+         */
+        "placement": MenuPlacement;
         /**
           * Disables the default behaviour on the third click of narrowing or extending the range and instead starts a new range.
          */
@@ -1789,6 +1798,15 @@ export namespace Components {
           * The name of the time input
          */
         "name": string;
+        /**
+          * Determines where the popover will be positioned relative to the input.
+          * @see [PopperPlacement](https://github.com/Esri/calcite-components/blob/master/src/utils/popper.ts#L25)
+         */
+        "placement": PopperPlacement;
+        /**
+          * Updates the position of the component.
+         */
+        "reposition": () => Promise<void>;
         /**
           * When true, makes the component required for form-submission.
          */
@@ -2302,6 +2320,10 @@ export namespace Components {
         "value": any;
     }
     interface CalcitePopover {
+        /**
+          * Automatically closes any currently open popovers when clicking outside of a popover.
+         */
+        "autoClose": boolean;
         /**
           * Display a close button within the Popover.
           * @deprecated use dismissible instead.
@@ -2322,7 +2344,7 @@ export namespace Components {
         /**
           * Defines the available placements that can be used when a flip occurs.
          */
-        "flipPlacements"?: Placement[];
+        "flipPlacements"?: ComputedPlacement[];
         /**
           * Heading text.
          */
@@ -2799,7 +2821,7 @@ export namespace Components {
         /**
           * Currently selected number (if single select)
          */
-        "value": null | number;
+        "value": null | number | number[];
     }
     interface CalciteSortableList {
         /**
@@ -2897,7 +2919,7 @@ export namespace Components {
         /**
           * set the requested step as active
          */
-        "goToStep": (num: number) => Promise<void>;
+        "goToStep": (step: number) => Promise<void>;
         /**
           * optionally display a status icon next to the step title
          */
@@ -2918,7 +2940,7 @@ export namespace Components {
           * set the previous step as active
          */
         "prevStep": () => Promise<void>;
-        "requestedContent": HTMLElement[] | NodeListOf<any>;
+        "requestedContent": Node[];
         /**
           * specify the scale of stepper, defaults to m
          */
@@ -3297,7 +3319,7 @@ export namespace Components {
     }
     interface CalciteTipManager {
         /**
-          * Alternate text for closing the `calcite-tip-manager`.
+          * Closed state of the `calcite-tip-manager`.
          */
         "closed": boolean;
         /**
@@ -3380,19 +3402,19 @@ export namespace Components {
         "child": boolean;
         /**
           * Display input
-          * @deprecated use "ancestors" selection-mode for checkbox input
+          * @deprecated Use "ancestors" selection-mode for checkbox input.
          */
         "inputEnabled": boolean;
         /**
-          * Display indentation guide lines
+          * Display indentation guide lines.
          */
         "lines": boolean;
         /**
-          * Specify the scale of the tree, defaults to m
+          * Specify the scale of the tree.
          */
         "scale": Scale;
         /**
-          * Customize how tree selection works (single, multi, children, multi-children, ancestors)
+          * Customize how tree selection works.
           * @default "single"
           * @see [TreeSelectionMode](https://github.com/Esri/calcite-components/blob/master/src/components/tree/interfaces.ts#L5)
          */
@@ -3401,40 +3423,40 @@ export namespace Components {
     interface CalciteTreeItem {
         "depth": number;
         /**
-          * True if the item is in an expanded state
+          * Expanded state of the item.
          */
         "expanded": boolean;
         "hasChildren": boolean;
         "indeterminate": boolean;
         /**
-          * Display checkboxes (set on parent)
-          * @deprecated set "ancestors" selection-mode on parent tree for checkboxes
+          * Displays checkboxes (set on parent).
+          * @deprecated Use "ancestors" selection-mode on parent for checkbox input.
          */
         "inputEnabled": boolean;
         "lines": boolean;
         "parentExpanded": boolean;
         "scale": Scale;
         /**
-          * Is the item currently selected
+          * Selected state of the item.
          */
         "selected": boolean;
         "selectionMode": TreeSelectionMode;
     }
     interface CalciteValueList {
         /**
-          * When true, disabled prevents interaction. This state shows items with lower opacity/grayed.
+          * When true, prevents user interaction. This state shows list items grayed out and with lower opacity.
          */
         "disabled": boolean;
         /**
-          * When true, the items will be sortable via drag and drop.
+          * When true, list items are sortable via a draggable button.
          */
         "dragEnabled": boolean;
         /**
-          * When true, an input appears at the top of the list that can be used by end users to filter items in the list.
+          * When true, an input appears at the top of the list that can be used by end users to filter list items.
          */
         "filterEnabled": boolean;
         /**
-          * Placeholder text for the filter input field.
+          * Placeholder text for the filter's input field.
          */
         "filterPlaceholder": string;
         /**
@@ -3450,11 +3472,11 @@ export namespace Components {
          */
         "loading": boolean;
         /**
-          * Multiple Works similar to standard radio buttons and checkboxes. When true, a user can select multiple items at a time. When false, only a single item can be selected at a time and selecting a new item will deselect any other selected items.
+          * Similar to standard radio buttons and checkboxes. When true, a user can select multiple list items at a time. When false, only a single list item can be selected at a time, and selecting a new list item will deselect any other selected list items.
          */
         "multiple": boolean;
         /**
-          * When true and single-selection is enabled, the selection will change when navigating items via the keyboard.
+          * When true and single-selection is enabled, the selection changes when navigating list items via the keyboard.
          */
         "selectionFollowsFocus": boolean;
         /**
@@ -3464,12 +3486,12 @@ export namespace Components {
     }
     interface CalciteValueListItem {
         /**
-          * An optional description for this item. Will appear below the label text.
+          * An optional description for the list item that displays below the label text.
          */
         "description"?: string;
         "disableDeselect": boolean;
         /**
-          * When true, the item cannot be clicked and is visually muted
+          * When true, the list item cannot be clicked and is visually muted.
          */
         "disabled": boolean;
         "handleActivated"?: boolean;
@@ -3479,11 +3501,11 @@ export namespace Components {
          */
         "icon"?: ICON_TYPES | null;
         /**
-          * The main label for this item. Appears next to the icon.
+          * The main label for the list item. Appears next to the icon.
          */
         "label": string;
         /**
-          * Used to provide additional metadata to an item, primarily used when the parent list has a filter.
+          * Provides additional metadata to a list item. Primary use is for a filter on the parent list.
          */
         "metadata"?: Record<string, unknown>;
         /**
@@ -3491,23 +3513,23 @@ export namespace Components {
          */
         "nonInteractive": boolean;
         /**
-          * Set this to true to display a remove action that removes the item from the list.
+          * When true, adds an action to remove the list item.
          */
         "removable": boolean;
         /**
-          * Set this to true to pre-select an item. Toggles when an item is checked/unchecked.
+          * When true, preselects the list item. Toggles when an item is checked/unchecked.
          */
         "selected": boolean;
         /**
-          * Sets focus on the component.
+          * Set focus on the component.
          */
         "setFocus": () => Promise<void>;
         /**
-          * Used to toggle the selection state. By default this won't trigger an event. The first argument allows the value to be coerced, rather than swapping values.
+          * Toggle the selection state. By default this won't trigger an event. The first argument allows the value to be coerced, rather than swapping values.
          */
         "toggleSelected": (coerce?: boolean) => Promise<void>;
         /**
-          * The item's associated value.
+          * The list item's associated value.
          */
         "value": any;
     }
@@ -4315,7 +4337,7 @@ declare namespace LocalJSX {
         /**
           * Defines the available placements that can be used when a flip occurs.
          */
-        "flipPlacements"?: Placement[];
+        "flipPlacements"?: ComputedPlacement[];
         /**
           * Text string for the actions menu.
          */
@@ -4467,11 +4489,11 @@ declare namespace LocalJSX {
          */
         "headingLevel"?: HeadingLevel;
         /**
-          * Tooltip used for the toggle when expanded.
+          * Aria-label for collapsing the toggle and tooltip used for the toggle when expanded.
          */
         "intlCollapse"?: string;
         /**
-          * Tooltip used for the toggle when collapsed.
+          * Aria-label for expanding the toggle and tooltip used for the toggle when collapsed.
          */
         "intlExpand"?: string;
         /**
@@ -5611,6 +5633,10 @@ declare namespace LocalJSX {
           * flip the icon in rtl
          */
         "iconFlipRtl"?: boolean;
+        /**
+          * A text label that will appear on the clear button for screen readers.
+         */
+        "intlClear"?: string;
         /**
           * string to override English loading text
           * @default "Loading"
@@ -5810,6 +5836,11 @@ declare namespace LocalJSX {
           * Describes the type of positioning to use for the overlaid content. If your element is in a fixed container, use the 'fixed' value.
          */
         "overlayPositioning"?: OverlayPositioning;
+        /**
+          * Determines where the date-picker component will be positioned relative to the input.
+          * @default "bottom-leading"
+         */
+        "placement"?: MenuPlacement;
         /**
           * Disables the default behaviour on the third click of narrowing or extending the range and instead starts a new range.
          */
@@ -5929,6 +5960,11 @@ declare namespace LocalJSX {
           * Fires when the time value is changed as a result of user input.
          */
         "onCalciteInputTimePickerChange"?: (event: CustomEvent<string>) => void;
+        /**
+          * Determines where the popover will be positioned relative to the input.
+          * @see [PopperPlacement](https://github.com/Esri/calcite-components/blob/master/src/utils/popper.ts#L25)
+         */
+        "placement"?: PopperPlacement;
         /**
           * The scale (size) of the time input
          */
@@ -6307,6 +6343,11 @@ declare namespace LocalJSX {
         /**
           * Emitted when the close button has been clicked.
          */
+        "onCalcitePanelDismiss"?: (event: CustomEvent<any>) => void;
+        /**
+          * Emitted when the close button has been clicked.
+          * @deprecated use calcitePanelDismiss instead.
+         */
         "onCalcitePanelDismissedChange"?: (event: CustomEvent<any>) => void;
         /**
           * Emitted when the content has been scrolled.
@@ -6427,6 +6468,10 @@ declare namespace LocalJSX {
         "value": any;
     }
     interface CalcitePopover {
+        /**
+          * Automatically closes any currently open popovers when clicking outside of a popover.
+         */
+        "autoClose"?: boolean;
         /**
           * Display a close button within the Popover.
           * @deprecated use dismissible instead.
@@ -6447,7 +6492,7 @@ declare namespace LocalJSX {
         /**
           * Defines the available placements that can be used when a flip occurs.
          */
-        "flipPlacements"?: Placement[];
+        "flipPlacements"?: ComputedPlacement[];
         /**
           * Heading text.
          */
@@ -6795,6 +6840,7 @@ declare namespace LocalJSX {
         "intlResize"?: string;
         /**
           * Emitted when collapse has been toggled.
+          * @deprecated use a resizeObserver on the shell-panel to listen for changes to its size.
          */
         "onCalciteShellPanelToggle"?: (event: CustomEvent<any>) => void;
         /**
@@ -6912,7 +6958,7 @@ declare namespace LocalJSX {
         /**
           * Currently selected number (if single select)
          */
-        "value"?: null | number;
+        "value"?: null | number | number[];
     }
     interface CalciteSortableList {
         /**
@@ -7136,7 +7182,7 @@ declare namespace LocalJSX {
          */
         "iconStart"?: string;
         /**
-          * Fires when a specific tab is activated (`event.details`)
+          * Fires when a specific tab is activated. Emits the "tab" property or the index position.
           * @see [TabChangeEventDetail](https://github.com/Esri/calcite-components/blob/master/src/components/tab/interfaces.ts#L1)
          */
         "onCalciteTabsActivate"?: (event: CustomEvent<TabChangeEventDetail>) => void;
@@ -7373,7 +7419,7 @@ declare namespace LocalJSX {
     }
     interface CalciteTipManager {
         /**
-          * Alternate text for closing the `calcite-tip-manager`.
+          * Closed state of the `calcite-tip-manager`.
          */
         "closed"?: boolean;
         /**
@@ -7400,8 +7446,13 @@ declare namespace LocalJSX {
           * Alternate text for navigating to the previous tip.
          */
         "intlPrevious"?: string;
+        /**
+          * Emitted when the `calcite-tip-manager` has been closed.
+         */
+        "onCalciteTipManagerClose"?: (event: CustomEvent<any>) => void;
         /**
           * Emitted when the `calcite-tip-manager` has been toggled open or closed.
+          * @deprecated use calciteTipManagerClose instead.
          */
         "onCalciteTipManagerToggle"?: (event: CustomEvent<any>) => void;
     }
@@ -7447,24 +7498,24 @@ declare namespace LocalJSX {
     interface CalciteTree {
         /**
           * Display input
-          * @deprecated use "ancestors" selection-mode for checkbox input
+          * @deprecated Use "ancestors" selection-mode for checkbox input.
          */
         "inputEnabled"?: boolean;
         /**
-          * Display indentation guide lines
+          * Display indentation guide lines.
          */
         "lines"?: boolean;
         /**
-          * Emitted when user selects/deselects tree items. An object including an array of selected items will be passed in the event's `detail` property.
+          * Emits when the user selects/deselects tree items. An object including an array of selected items will be passed in the event's "detail" property.
           * @see [TreeSelectDetail](https://github.com/Esri/calcite-components/blob/master/src/components/tree/interfaces.ts#L1)
          */
         "onCalciteTreeSelect"?: (event: CustomEvent<TreeSelectDetail>) => void;
         /**
-          * Specify the scale of the tree, defaults to m
+          * Specify the scale of the tree.
          */
         "scale"?: Scale;
         /**
-          * Customize how tree selection works (single, multi, children, multi-children, ancestors)
+          * Customize how tree selection works.
           * @default "single"
           * @see [TreeSelectionMode](https://github.com/Esri/calcite-components/blob/master/src/components/tree/interfaces.ts#L5)
          */
@@ -7472,29 +7523,29 @@ declare namespace LocalJSX {
     }
     interface CalciteTreeItem {
         /**
-          * True if the item is in an expanded state
+          * Expanded state of the item.
          */
         "expanded"?: boolean;
         /**
-          * Is the item currently selected
+          * Selected state of the item.
          */
         "selected"?: boolean;
     }
     interface CalciteValueList {
         /**
-          * When true, disabled prevents interaction. This state shows items with lower opacity/grayed.
+          * When true, prevents user interaction. This state shows list items grayed out and with lower opacity.
          */
         "disabled"?: boolean;
         /**
-          * When true, the items will be sortable via drag and drop.
+          * When true, list items are sortable via a draggable button.
          */
         "dragEnabled"?: boolean;
         /**
-          * When true, an input appears at the top of the list that can be used by end users to filter items in the list.
+          * When true, an input appears at the top of the list that can be used by end users to filter list items.
          */
         "filterEnabled"?: boolean;
         /**
-          * Placeholder text for the filter input field.
+          * Placeholder text for the filter's input field.
          */
         "filterPlaceholder"?: string;
         /**
@@ -7506,29 +7557,29 @@ declare namespace LocalJSX {
          */
         "loading"?: boolean;
         /**
-          * Multiple Works similar to standard radio buttons and checkboxes. When true, a user can select multiple items at a time. When false, only a single item can be selected at a time and selecting a new item will deselect any other selected items.
+          * Similar to standard radio buttons and checkboxes. When true, a user can select multiple list items at a time. When false, only a single list item can be selected at a time, and selecting a new list item will deselect any other selected list items.
          */
         "multiple"?: boolean;
         /**
-          * Emitted when any of the item selections have changed.
+          * Emits when any of the list item selections have changed.
          */
         "onCalciteListChange"?: (event: CustomEvent<Map<string, HTMLCalciteValueListItemElement>>) => void;
         /**
-          * Emitted when the order of the list has changed.
+          * Emits when the order of the list has changed.
          */
         "onCalciteListOrderChange"?: (event: CustomEvent<any[]>) => void;
         /**
-          * When true and single-selection is enabled, the selection will change when navigating items via the keyboard.
+          * When true and single-selection is enabled, the selection changes when navigating list items via the keyboard.
          */
         "selectionFollowsFocus"?: boolean;
     }
     interface CalciteValueListItem {
         /**
-          * An optional description for this item. Will appear below the label text.
+          * An optional description for the list item that displays below the label text.
          */
         "description"?: string;
         /**
-          * When true, the item cannot be clicked and is visually muted
+          * When true, the list item cannot be clicked and is visually muted.
          */
         "disabled"?: boolean;
         /**
@@ -7537,11 +7588,11 @@ declare namespace LocalJSX {
          */
         "icon"?: ICON_TYPES | null;
         /**
-          * The main label for this item. Appears next to the icon.
+          * The main label for the list item. Appears next to the icon.
          */
         "label": string;
         /**
-          * Used to provide additional metadata to an item, primarily used when the parent list has a filter.
+          * Provides additional metadata to a list item. Primary use is for a filter on the parent list.
          */
         "metadata"?: Record<string, unknown>;
         /**
@@ -7549,19 +7600,19 @@ declare namespace LocalJSX {
          */
         "nonInteractive"?: boolean;
         /**
-          * Emitted whenever the remove button is pressed.
+          * Emits when the remove button is pressed.
          */
         "onCalciteListItemRemove"?: (event: CustomEvent<void>) => void;
         /**
-          * Set this to true to display a remove action that removes the item from the list.
+          * When true, adds an action to remove the list item.
          */
         "removable"?: boolean;
         /**
-          * Set this to true to pre-select an item. Toggles when an item is checked/unchecked.
+          * When true, preselects the list item. Toggles when an item is checked/unchecked.
          */
         "selected"?: boolean;
         /**
-          * The item's associated value.
+          * The list item's associated value.
          */
         "value": any;
     }

package/dist/types/preact.d.ts

@@ -211,7 +211,8 @@ declare module "preact/src/jsx" {
         "oncalcitePaginationChange"?: (event: CustomEvent<any>) => void;
       }
 
-      "calcite-panel": Omit<JSX.CalcitePanel, "onCalcitePanelDismissedChange" | "onCalcitePanelScroll" | "onCalcitePanelBackClick"> & JSXInternal.HTMLAttributes<HTMLCalcitePanelElement> & {
+      "calcite-panel": Omit<JSX.CalcitePanel, "onCalcitePanelDismiss" | "onCalcitePanelDismissedChange" | "onCalcitePanelScroll" | "onCalcitePanelBackClick"> & JSXInternal.HTMLAttributes<HTMLCalcitePanelElement> & {
+        "oncalcitePanelDismiss"?: (event: CustomEvent<any>) => void;
         "oncalcitePanelDismissedChange"?: (event: CustomEvent<any>) => void;
         "oncalcitePanelScroll"?: (event: CustomEvent<any>) => void;
         "oncalcitePanelBackClick"?: (event: CustomEvent<any>) => void;
@@ -309,12 +310,14 @@ declare module "preact/src/jsx" {
         "oncalciteTabRegister"?: (event: CustomEvent<any>) => void;
       }
 
-      "calcite-tab-nav": Omit<JSX.CalciteTabNav, "onCalciteTabChange"> & JSXInternal.HTMLAttributes<HTMLCalciteTabNavElement> & {
+      "calcite-tab-nav": Omit<JSX.CalciteTabNav, "onCalciteTabChange" | "onCalciteInternalTabChange"> & JSXInternal.HTMLAttributes<HTMLCalciteTabNavElement> & {
         "oncalciteTabChange"?: (event: CustomEvent<any>) => void;
+        "oncalciteInternalTabChange"?: (event: CustomEvent<any>) => void;
       }
 
-      "calcite-tab-title": Omit<JSX.CalciteTabTitle, "onCalciteTabsActivate" | "onCalciteTabsFocusNext" | "onCalciteTabsFocusPrevious" | "onCalciteTabTitleRegister"> & JSXInternal.HTMLAttributes<HTMLCalciteTabTitleElement> & {
+      "calcite-tab-title": Omit<JSX.CalciteTabTitle, "onCalciteTabsActivate" | "onCalciteInternalTabsActivate" | "onCalciteTabsFocusNext" | "onCalciteTabsFocusPrevious" | "onCalciteTabTitleRegister"> & JSXInternal.HTMLAttributes<HTMLCalciteTabTitleElement> & {
         "oncalciteTabsActivate"?: (event: CustomEvent<any>) => void;
+        "oncalciteInternalTabsActivate"?: (event: CustomEvent<any>) => void;
         "oncalciteTabsFocusNext"?: (event: CustomEvent<any>) => void;
         "oncalciteTabsFocusPrevious"?: (event: CustomEvent<any>) => void;
         "oncalciteTabTitleRegister"?: (event: CustomEvent<any>) => void;
@@ -342,8 +345,9 @@ declare module "preact/src/jsx" {
 
       "calcite-tip-group": JSX.CalciteTipGroup & JSXInternal.HTMLAttributes<HTMLCalciteTipGroupElement>
 
-      "calcite-tip-manager": Omit<JSX.CalciteTipManager, "onCalciteTipManagerToggle"> & JSXInternal.HTMLAttributes<HTMLCalciteTipManagerElement> & {
+      "calcite-tip-manager": Omit<JSX.CalciteTipManager, "onCalciteTipManagerToggle" | "onCalciteTipManagerClose"> & JSXInternal.HTMLAttributes<HTMLCalciteTipManagerElement> & {
         "oncalciteTipManagerToggle"?: (event: CustomEvent<any>) => void;
+        "oncalciteTipManagerClose"?: (event: CustomEvent<any>) => void;
       }
 
       "calcite-tooltip": JSX.CalciteTooltip & JSXInternal.HTMLAttributes<HTMLCalciteTooltipElement>

package/dist/types/utils/dom.d.ts

@@ -11,8 +11,8 @@ export declare type Direction = "ltr" | "rtl";
 export declare function getThemeName(el: HTMLElement): "light" | "dark";
 export declare function getElementDir(el: HTMLElement): Direction;
 export declare function getElementProp(el: Element, prop: string, fallbackValue: any): any;
-export declare function getRootNode(el: Element): HTMLDocument | ShadowRoot;
-export declare function getHost(root: HTMLDocument | ShadowRoot): Element | null;
+export declare function getRootNode(el: Element): Document | ShadowRoot;
+export declare function getHost(root: Document | ShadowRoot): Element | null;
 /**
  * This helper queries an element's rootNodes and any ancestor rootNodes.
  *
@@ -51,4 +51,12 @@ export declare function getSlotted<T extends Element = Element>(element: Element
 export declare function filterDirectChildren<T extends Element>(el: Element, selector: string): T[];
 export declare function setRequestedIcon(iconObject: Record<string, string>, iconValue: string | boolean, matchedValue: string): string;
 export declare function intersects(rect1: DOMRect, rect2: DOMRect): boolean;
+/**
+ * This helper makes sure that boolean aria attributes are properly converted to a string.
+ *
+ * It should only be used for aria attributes that require a string value of "true" or "false".
+ *
+ * @returns {string} The string conversion of a boolean value ("true" | "false").
+ */
+export declare function toAriaBoolean(value: boolean): string;
 export {};