@esri/calcite-components 1.0.0-next.467 → 1.0.0-next.468

package/dist/components/calcite-tooltip.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.0.0-next.467
+ * v1.0.0-next.468
  */
 import { proxyCustomElement, HTMLElement, h, Host } from '@stencil/core/internal/client';
 import { g as guid } from './guid.js';
@@ -177,6 +177,7 @@ const Tooltip = /*@__PURE__*/ proxyCustomElement(class extends HTMLElement {
     this.__attachShadow();
     /**
      * Offset the position of the tooltip away from the reference element.
+     *
      * @default 6
      */
     this.offsetDistance = defaultOffsetDistance;
@@ -192,6 +193,7 @@ const Tooltip = /*@__PURE__*/ proxyCustomElement(class extends HTMLElement {
     this.overlayPositioning = "absolute";
     /**
      * Determines where the component will be positioned relative to the referenceElement.
+     *
      * @see [PopperPlacement](https://github.com/Esri/calcite-components/blob/master/src/utils/popper.ts#L25)
      */
     this.placement = "auto";

package/dist/components/calcite-tree-item.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.0.0-next.467
+ * v1.0.0-next.468
  */
 import { proxyCustomElement, HTMLElement, createEvent, h, Host } from '@stencil/core/internal/client';
 import { T as TreeSelectionMode } from './interfaces2.js';
@@ -45,11 +45,17 @@ const TreeItem = /*@__PURE__*/ proxyCustomElement(class extends HTMLElement {
     this.selected = false;
     /** Expanded state of the item. */
     this.expanded = false;
-    /** @internal Expanded state of the parent. */
+    /**
+     * @internal
+     */
     this.parentExpanded = false;
-    /** @internal Level of depth of the item. */
+    /**
+     * @internal
+     */
     this.depth = -1;
-    /** @internal Does this tree item have a tree inside it? */
+    /**
+     * @internal
+     */
     this.hasChildren = null;
     this.iconClickHandler = (event) => {
       event.stopPropagation();

package/dist/components/calcite-tree.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.0.0-next.467
+ * v1.0.0-next.468
  */
 import { proxyCustomElement, HTMLElement, createEvent, h, Host } from '@stencil/core/internal/client';
 import { f as focusElement, n as nodeListToArray } from './dom.js';
@@ -22,13 +22,17 @@ const Tree = /*@__PURE__*/ proxyCustomElement(class extends HTMLElement {
     //--------------------------------------------------------------------------
     /** Display indentation guide lines. */
     this.lines = false;
-    /** Display input
+    /**
+     * Display input
+     *
      * @deprecated Use "ancestors" selection-mode for checkbox input.
      */
     this.inputEnabled = false;
     /** Specify the scale of the tree. */
     this.scale = "m";
-    /** Customize how tree selection works.
+    /**
+     * Customize how tree selection works.
+     *
      * @default "single"
      * @see [TreeSelectionMode](https://github.com/Esri/calcite-components/blob/master/src/components/tree/interfaces.ts#L5)
      */

package/dist/components/calcite-value-list-item.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.0.0-next.467
+ * v1.0.0-next.468
  */
 import { proxyCustomElement, HTMLElement, createEvent, h, Host } from '@stencil/core/internal/client';
 import { I as ICON_TYPES } from './resources.js';
@@ -35,7 +35,7 @@ const ValueListItem = /*@__PURE__*/ proxyCustomElement(class extends HTMLElement
      */
     this.disabled = false;
     /**
-     * @internal When false, the list item cannot be deselected by user interaction.
+     * @internal
      */
     this.disableDeselect = false;
     /**
@@ -43,11 +43,12 @@ const ValueListItem = /*@__PURE__*/ proxyCustomElement(class extends HTMLElement
      */
     this.nonInteractive = false;
     /**
-     * @internal - Stores the activated state of the drag handle.
+     * @internal
      */
     this.handleActivated = false;
     /**
      * Determines the icon SVG symbol that will be shown. Options are circle, square, grip or null.
+     *
      * @see [ICON_TYPES](https://github.com/Esri/calcite-components/blob/master/src/components/pick-list/resources.ts#L5)
      */
     this.icon = null;
@@ -101,6 +102,8 @@ const ValueListItem = /*@__PURE__*/ proxyCustomElement(class extends HTMLElement
   /**
    * 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.
+   *
+   * @param coerce
    */
   async toggleSelected(coerce) {
     this.pickListItem.toggleSelected(coerce);

package/dist/components/calcite-value-list.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.0.0-next.467
+ * v1.0.0-next.468
  */
 import { proxyCustomElement, HTMLElement, createEvent, h } from '@stencil/core/internal/client';
 import { S as Sortable } from './sortable.esm.js';
@@ -200,7 +200,11 @@ const ValueList = /*@__PURE__*/ proxyCustomElement(class extends HTMLElement {
   async getSelectedItems() {
     return this.selectedValues;
   }
-  /** Sets focus on the component. */
+  /**
+   * Sets focus on the component.
+   *
+   * @param focusId
+   */
   async setFocus(focusId) {
     return setFocus.call(this, focusId);
   }

package/dist/components/checkbox.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.0.0-next.467
+ * v1.0.0-next.468
  */
 import { proxyCustomElement, HTMLElement, createEvent, h, Host } from '@stencil/core/internal/client';
 import { g as guid } from './guid.js';
@@ -31,6 +31,7 @@ const Checkbox = /*@__PURE__*/ proxyCustomElement(class extends HTMLElement {
     this.disabled = false;
     /**
      * The hovered state of the checkbox.
+     *
      * @internal
      */
     this.hovered = false;
@@ -38,7 +39,7 @@ const Checkbox = /*@__PURE__*/ proxyCustomElement(class extends HTMLElement {
      * True if the checkbox is initially indeterminate,
      * which is independent from its checked state
      * https://css-tricks.com/indeterminate-checkboxes/
-     * */
+     */
     this.indeterminate = false;
     /**
      * When true, makes the component required for form-submission.

package/dist/components/chip.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.0.0-next.467
+ * v1.0.0-next.468
  */
 import { proxyCustomElement, HTMLElement, createEvent, h } from '@stencil/core/internal/client';
 import { b as getSlotted } from './dom.js';
@@ -45,7 +45,9 @@ const Chip = /*@__PURE__*/ proxyCustomElement(class extends HTMLElement {
     this.color = "grey";
     /** Optionally show a button the user can click to dismiss the chip */
     this.dismissible = false;
-    /** Aria label for the "x" button
+    /**
+     * Aria label for the "x" button
+     *
      * @default "Close"
      */
     this.dismissLabel = TEXT.close;

package/dist/components/color-picker-hex-input.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.0.0-next.467
+ * v1.0.0-next.468
  */
 import { proxyCustomElement, HTMLElement, createEvent, h } from '@stencil/core/internal/client';
 import { n as normalizeHex, i as isValidHex, a as isLonghandHex, r as rgbToHex, b as hexChar } from './utils.js';
@@ -140,11 +140,13 @@ const ColorPickerHexInput = /*@__PURE__*/ proxyCustomElement(class extends HTMLE
     this.allowEmpty = false;
     /**
      * Label used for the hex input.
+     *
      * @default "Hex"
      */
     this.intlHex = TEXT.hex;
     /**
      * Label used for the hex input when there is no color selected.
+     *
      * @default "No color"
      */
     this.intlNoColor = TEXT.noColor;

package/dist/components/color-picker-swatch.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.0.0-next.467
+ * v1.0.0-next.468
  */
 import { proxyCustomElement, HTMLElement, h } from '@stencil/core/internal/client';
 import { d as getThemeName } from './dom.js';

package/dist/components/conditionalSlot.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.0.0-next.467
+ * v1.0.0-next.468
  */
 import { forceUpdate } from '@stencil/core/internal/client';
 import { c as createObserver } from './observers.js';
@@ -11,6 +11,8 @@ let mutationObserver;
 const observerOptions = { childList: true };
 /**
  * Helper to set up a conditional slot component on connectedCallback.
+ *
+ * @param component
  */
 function connectConditionalSlotComponent(component) {
   if (!mutationObserver) {
@@ -20,6 +22,8 @@ function connectConditionalSlotComponent(component) {
 }
 /**
  * Helper to tear down a conditional slot component on disconnectedCallback.
+ *
+ * @param component
  */
 function disconnectConditionalSlotComponent(component) {
   observed.delete(component.el);

package/dist/components/date-picker-day.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.0.0-next.467
+ * v1.0.0-next.468
  */
 import { proxyCustomElement, HTMLElement, createEvent, h, Host } from '@stencil/core/internal/client';
 import { a as getElementDir, C as CSS_UTILITY } from './dom.js';

package/dist/components/date-picker-month-header.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.0.0-next.467
+ * v1.0.0-next.468
  */
 import { proxyCustomElement, HTMLElement, createEvent, h, Fragment } from '@stencil/core/internal/client';
 import { l as localizeNumber, c as getOrder, b as dateFromRange, n as nextMonth, p as prevMonth, e as parseNumber } from './date.js';
@@ -23,6 +23,8 @@ const DatePickerMonthHeader = /*@__PURE__*/ proxyCustomElement(class extends HTM
     //--------------------------------------------------------------------------
     /**
      * Increment year on UP/DOWN keys
+     *
+     * @param e
      */
     this.onYearKey = (e) => {
       const localizedYear = e.target.value;
@@ -122,6 +124,11 @@ const DatePickerMonthHeader = /*@__PURE__*/ proxyCustomElement(class extends HTM
   /**
    * Parse localized year string from input,
    * set to active if in range
+   *
+   * @param root0
+   * @param root0.localizedYear
+   * @param root0.commit
+   * @param root0.offset
    */
   setYear({ localizedYear, commit = true, offset = 0 }) {
     const { yearInput, activeDate, localeData } = this;

package/dist/components/date-picker-month.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.0.0-next.467
+ * v1.0.0-next.468
  */
 import { proxyCustomElement, HTMLElement, createEvent, h, Host } from '@stencil/core/internal/client';
 import { s as sameDate, b as dateFromRange, i as inRange } from './date.js';
@@ -138,6 +138,8 @@ const DatePickerMonth = /*@__PURE__*/ proxyCustomElement(class extends HTMLEleme
   //--------------------------------------------------------------------------
   /**
    * Add n months to the current month
+   *
+   * @param step
    */
   addMonths(step) {
     const nextDate = new Date(this.activeDate);
@@ -147,6 +149,8 @@ const DatePickerMonth = /*@__PURE__*/ proxyCustomElement(class extends HTMLEleme
   }
   /**
    * Add n days to the current date
+   *
+   * @param step
    */
   addDays(step = 0) {
     const nextDate = new Date(this.activeDate);
@@ -156,6 +160,10 @@ const DatePickerMonth = /*@__PURE__*/ proxyCustomElement(class extends HTMLEleme
   }
   /**
    * Get dates for last days of the previous month
+   *
+   * @param month
+   * @param year
+   * @param startOfWeek
    */
   getPrevMonthdays(month, year, startOfWeek) {
     const lastDate = new Date(year, month, 0);
@@ -172,6 +180,9 @@ const DatePickerMonth = /*@__PURE__*/ proxyCustomElement(class extends HTMLEleme
   }
   /**
    * Get dates for the current month
+   *
+   * @param month
+   * @param year
    */
   getCurrentMonthDays(month, year) {
     const num = new Date(year, month + 1, 0).getDate();
@@ -183,6 +194,10 @@ const DatePickerMonth = /*@__PURE__*/ proxyCustomElement(class extends HTMLEleme
   }
   /**
    * Get dates for first days of the next month
+   *
+   * @param month
+   * @param year
+   * @param startOfWeek
    */
   getNextMonthDays(month, year, startOfWeek) {
     const endDay = new Date(year, month + 1, 0).getDay();
@@ -197,6 +212,8 @@ const DatePickerMonth = /*@__PURE__*/ proxyCustomElement(class extends HTMLEleme
   }
   /**
    * Determine if the date is in between the start and end dates
+   *
+   * @param date
    */
   betweenSelectedRange(date) {
     return !!(this.startDate &&
@@ -207,6 +224,8 @@ const DatePickerMonth = /*@__PURE__*/ proxyCustomElement(class extends HTMLEleme
   }
   /**
    * Determine if the date should be in selected state
+   *
+   * @param date
    */
   isSelected(date) {
     return !!(sameDate(date, this.selectedDate) ||
@@ -215,6 +234,8 @@ const DatePickerMonth = /*@__PURE__*/ proxyCustomElement(class extends HTMLEleme
   }
   /**
    * Determine if the date is the start of the date range
+   *
+   * @param date
    */
   isStartOfRange(date) {
     return !!(this.startDate &&
@@ -231,6 +252,12 @@ const DatePickerMonth = /*@__PURE__*/ proxyCustomElement(class extends HTMLEleme
   }
   /**
    * Render calcite-date-picker-day
+   *
+   * @param active
+   * @param day
+   * @param date
+   * @param currentMonth
+   * @param ref
    */
   renderDateDay(active, day, date, currentMonth, ref) {
     var _a;

package/dist/components/date-picker.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.0.0-next.467
+ * v1.0.0-next.468
  */
 import { getAssetPath, proxyCustomElement, HTMLElement, createEvent, h, Host, Build } from '@stencil/core/internal/client';
 import { a as locales } from './locale.js';
@@ -14,6 +14,8 @@ import { d as defineCustomElement$1 } from './icon.js';
 /**
  * Get supported locale code from raw user input
  * Exported for testing purposes.
+ *
+ * @param lang
  * @private
  */
 function getSupportedLocale(lang = "") {
@@ -32,17 +34,21 @@ function getSupportedLocale(lang = "") {
 /**
  * CLDR cache.
  * Exported for testing purposes.
+ *
  * @private
  */
 const translationCache = {};
 /**
  * CLDR request cache.
  * Exported for testing purposes.
+ *
  * @private
  */
 const requestCache = {};
 /**
  * Fetch calendar data for a given locale from list of supported languages
+ *
+ * @param lang
  * @public
  */
 async function getLocaleData(lang) {
@@ -79,15 +85,21 @@ const DatePicker = /*@__PURE__*/ proxyCustomElement(class extends HTMLElement {
     this.__attachShadow();
     this.calciteDatePickerChange = createEvent(this, "calciteDatePickerChange", 7);
     this.calciteDatePickerRangeChange = createEvent(this, "calciteDatePickerRangeChange", 7);
-    /** Localized string for "previous month" (used for aria label)
+    /**
+     * Localized string for "previous month" (used for aria label)
+     *
      * @default "Previous month"
      */
     this.intlPrevMonth = TEXT.prevMonth;
-    /** Localized string for "next month" (used for aria label)
+    /**
+     * Localized string for "next month" (used for aria label)
+     *
      * @default "Next month"
      */
     this.intlNextMonth = TEXT.nextMonth;
-    /** Localized string for "year" (used for aria label)
+    /**
+     * Localized string for "year" (used for aria label)
+     *
      * @default "Year"
      */
     this.intlYear = TEXT.year;
@@ -229,6 +241,8 @@ const DatePicker = /*@__PURE__*/ proxyCustomElement(class extends HTMLElement {
     };
     /**
      * Event handler for when the selected date changes
+     *
+     * @param e
      */
     this.monthDateChange = (e) => {
       const date = new Date(e.detail);
@@ -398,6 +412,12 @@ const DatePicker = /*@__PURE__*/ proxyCustomElement(class extends HTMLElement {
   }
   /**
    * Render calcite-date-picker-month-header and calcite-date-picker-month
+   *
+   * @param activeDate
+   * @param maxDate
+   * @param minDate
+   * @param date
+   * @param endDate
    */
   renderCalendar(activeDate, maxDate, minDate, date, endDate) {
     return (this.localeData && [
@@ -407,6 +427,9 @@ const DatePicker = /*@__PURE__*/ proxyCustomElement(class extends HTMLElement {
   }
   /**
    * Update date instance of start if valid
+   *
+   * @param startDate
+   * @param emit
    */
   setStartAsDate(startDate, emit) {
     this.startAsDate = startDate;
@@ -420,6 +443,9 @@ const DatePicker = /*@__PURE__*/ proxyCustomElement(class extends HTMLElement {
   }
   /**
    * Update date instance of end if valid
+   *
+   * @param endDate
+   * @param emit
    */
   setEndAsDate(endDate, emit) {
     this.endAsDate = endDate;
@@ -443,6 +469,10 @@ const DatePicker = /*@__PURE__*/ proxyCustomElement(class extends HTMLElement {
   }
   /**
    * Get an active date using the value, or current date as default
+   *
+   * @param value
+   * @param min
+   * @param max
    */
   getActiveDate(value, min, max) {
     return dateFromRange(this.activeDate, min, max) || value || dateFromRange(new Date(), min, max);

package/dist/components/date.js

@@ -1,10 +1,14 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.0.0-next.467
+ * v1.0.0-next.468
  */
 /**
  * Check if date is within a min and max
+ *
+ * @param date
+ * @param min
+ * @param max
  */
 function inRange(date, min, max) {
   const time = date.getTime();
@@ -15,6 +19,10 @@ function inRange(date, min, max) {
 /**
  * Ensures date is within range,
  * returns min or max if out of bounds
+ *
+ * @param date
+ * @param min
+ * @param max
  */
 function dateFromRange(date, min, max) {
   if (!(date instanceof Date)) {
@@ -34,6 +42,8 @@ function dateFromRange(date, min, max) {
 /**
  * Parse an iso8601 string (YYYY-mm-dd) into a valid date.
  * TODO: handle time when time of day UI is added
+ *
+ * @param iso8601
  */
 function dateFromISO(iso8601) {
   if (iso8601 instanceof Date) {
@@ -52,6 +62,8 @@ function dateFromISO(iso8601) {
 }
 /**
  * Return first portion of ISO string (YYYY-mm-dd)
+ *
+ * @param date
  */
 function dateToISO(date) {
   if (typeof date === "string") {
@@ -64,6 +76,9 @@ function dateToISO(date) {
 }
 /**
  * Check if two dates are the same day, month, year
+ *
+ * @param d1
+ * @param d2
  */
 function sameDate(d1, d2) {
   return (d1 instanceof Date &&
@@ -74,6 +89,8 @@ function sameDate(d1, d2) {
 }
 /**
  * Get a date one month in the past
+ *
+ * @param date
  */
 function prevMonth(date) {
   const month = date.getMonth();
@@ -87,6 +104,8 @@ function prevMonth(date) {
 }
 /**
  * Get a date one month in the future
+ *
+ * @param date
  */
 function nextMonth(date) {
   const month = date.getMonth();
@@ -100,6 +119,9 @@ function nextMonth(date) {
 }
 /**
  * Translate a number into a given locals numeral system
+ *
+ * @param num
+ * @param localeData
  */
 function localizeNumber(num, localeData) {
   return String(num)
@@ -109,6 +131,9 @@ function localizeNumber(num, localeData) {
 }
 /**
  * Calculate actual number from localized string
+ *
+ * @param str
+ * @param localeData
  */
 function parseNumber(str, localeData) {
   const numerals = "0123456789";
@@ -121,6 +146,9 @@ function parseNumber(str, localeData) {
 /**
  * Parse numeric units for day, month, and year from a localized string
  * month starts at 0 (can pass to date constructor)
+ *
+ * @param str
+ * @param localeData
  */
 function parseDateString(str, localeData) {
   const { separator, unitOrder } = localeData;
@@ -134,6 +162,8 @@ function parseDateString(str, localeData) {
 }
 /**
  * Convert eastern arbic numerals
+ *
+ * @param str
  */
 function replaceArabicNumerals(str = "") {
   return str
@@ -142,6 +172,8 @@ function replaceArabicNumerals(str = "") {
 }
 /**
  * Based on the unitOrder string, find order of month, day, and year for locale
+ *
+ * @param unitOrder
  */
 function getOrder(unitOrder) {
   const signifiers = ["d", "m", "y"];
@@ -150,6 +182,9 @@ function getOrder(unitOrder) {
 }
 /**
  * Get number of days between two dates
+ *
+ * @param date1
+ * @param date2
  */
 function getDaysDiff(date1, date2) {
   const ts1 = date1.getTime();

package/dist/components/debounce.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.0.0-next.467
+ * v1.0.0-next.468
  */
 /** Detect free variable `global` from Node.js. */
 var freeGlobal = typeof global == 'object' && global && global.Object === Object && global;

package/dist/components/dom.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.0.0-next.467
+ * v1.0.0-next.468
  */
 import { g as guid } from './guid.js';
 
@@ -23,6 +23,7 @@ const TEXT = {
  *
  * If it already has an ID, it will be preserved, otherwise a unique one will be generated and assigned.
  *
+ * @param el
  * @returns {string} The element's ID.
  */
 function ensureId(el) {
@@ -58,6 +59,8 @@ function getHost(root) {
 /**
  * This helper queries an element's rootNodes and any ancestor rootNodes.
  *
+ * @param element
+ * @param selector
  * @returns {Element[]} The elements.
  */
 function queryElementsRoots(element, selector) {
@@ -84,6 +87,10 @@ function queryElementsRoots(element, selector) {
  *
  * If both an 'id' and 'selector' are supplied, 'id' will take precedence over 'selector'.
  *
+ * @param element
+ * @param root0
+ * @param root0.selector
+ * @param root0.id
  * @returns {Element} The element.
  */
 function queryElementRoots(element, { selector, id }) {
@@ -194,6 +201,7 @@ function intersects(rect1, rect2) {
  *
  * It should only be used for aria attributes that require a string value of "true" or "false".
  *
+ * @param value
  * @returns {string} The string conversion of a boolean value ("true" | "false").
  */
 function toAriaBoolean(value) {