@esri/calcite-components 1.4.0-next.7 → 1.4.0-next.9

package/dist/cjs/{dom-21aaf3f4.js → dom-059a146f.js}

@@ -1,12 +1,12 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.4.0-next.7
+ * v1.4.0-next.9
  */
 'use strict';
 
-const guid = require('./guid-43b37504.js');
-const resources = require('./resources-b46063a7.js');
+const guid = require('./guid-4fcf21f9.js');
+const resources = require('./resources-71fcd0d1.js');
 
 /*!
 * tabbable 6.1.1
@@ -545,6 +545,11 @@ var isFocusable = function isFocusable(node, options) {
   return isNodeMatchingSelectorFocusable(options, node);
 };
 
+/**
+ * The default `focus-trap/tabbable` options.
+ *
+ * See https://github.com/focus-trap/tabbable#tabbable
+ */
 const tabbableOptions = {
   getShadowRoot: true
 };
@@ -553,7 +558,7 @@ const tabbableOptions = {
  *
  * If it already has an ID, it will be preserved, otherwise a unique one will be generated and assigned.
  *
- * @param el
+ * @param {Element} el An element.
  * @returns {string} The element's ID.
  */
 function ensureId(el) {
@@ -562,27 +567,66 @@ function ensureId(el) {
   }
   return (el.id = el.id || `${el.tagName.toLowerCase()}-${guid.guid()}`);
 }
+/**
+ * This helper returns an array from a NodeList.
+ *
+ * @param {NodeList} nodeList A NodeList.
+ * @returns {Element[]} An array of elements.
+ */
 function nodeListToArray(nodeList) {
   return Array.isArray(nodeList) ? nodeList : Array.from(nodeList);
 }
+/**
+ * This helper returns the Calcite "mode" of an element.
+ *
+ * @param {HTMLElement} el An element.
+ * @returns {"light"|"dark"} The Calcite mode.
+ */
 function getModeName(el) {
   const closestElWithMode = closestElementCrossShadowBoundary(el, `.${resources.CSS_UTILITY.darkMode}, .${resources.CSS_UTILITY.lightMode}`);
   return closestElWithMode?.classList.contains("calcite-mode-dark") ? "dark" : "light";
 }
+/**
+ * This helper returns the direction of a HTML element.
+ *
+ * @param {HTMLElement} el An element.
+ * @returns {Direction} The direction.
+ */
 function getElementDir(el) {
   const prop = "dir";
   const selector = `[${prop}]`;
   const closest = closestElementCrossShadowBoundary(el, selector);
   return closest ? closest.getAttribute(prop) : "ltr";
 }
-function getElementProp(el, prop, fallbackValue) {
-  const selector = `[${prop}]`;
+/**
+ * This helper returns the value of an attribute on an element.
+ *
+ * @param {HTMLElement} el An element.
+ * @param {string} attribute An attribute name.
+ * @param {any} fallbackValue A fallback value.
+ * @returns {any} The value.
+ * @deprecated
+ */
+function getElementProp(el, attribute, fallbackValue) {
+  const selector = `[${attribute}]`;
   const closest = el.closest(selector);
-  return closest ? closest.getAttribute(prop) : fallbackValue;
+  return closest ? closest.getAttribute(attribute) : fallbackValue;
 }
+/**
+ * This helper returns the rootNode of an element.
+ *
+ * @param {Element} el An element.
+ * @returns {Document|ShadowRoot} The element's root node.
+ */
 function getRootNode(el) {
   return el.getRootNode();
 }
+/**
+ * This helper returns the host of a ShadowRoot.
+ *
+ * @param {Document | ShadowRoot} root A root element.
+ * @returns {Element | null} The host element.
+ */
 function getHost(root) {
   return root.host || null;
 }
@@ -591,11 +635,11 @@ function getHost(root) {
  *
  * If both an 'id' and 'selector' are supplied, 'id' will take precedence over 'selector'.
  *
- * @param element
+ * @param {Element} element An element.
  * @param root0
  * @param root0.selector
  * @param root0.id
- * @returns {Element} The element.
+ * @returns {Element} An element.
  */
 function queryElementRoots(element, { selector, id }) {
   // Gets the rootNode and any ancestor rootNodes (shadowRoot or document) of an element and queries them for a selector.
@@ -624,6 +668,13 @@ function queryElementRoots(element, { selector, id }) {
   }
   return queryFrom(element);
 }
+/**
+ * This helper returns the closest element matching the selector by crossing he shadow boundary if necessary.
+ *
+ * @param {Element} element The starting element.
+ * @param {string} selector The selector.
+ * @returns {Element} The targeted element.
+ */
 function closestElementCrossShadowBoundary(element, selector) {
   // based on https://stackoverflow.com/q/54520554/194216
   function closestFrom(el) {
@@ -636,8 +687,9 @@ function closestElementCrossShadowBoundary(element, selector) {
  *
  * Returning early or undefined in `onVisit` will continue traversing up the DOM tree. Otherwise, traversal will halt with the returned value as the result of the function
  *
- * @param element
- * @param onVisit
+ * @param {Element} element An element.
+ * @param {(node: Node) => Element} onVisit The callback.
+ * @returns {Element} The result.
  */
 function walkUpAncestry(element, onVisit) {
   return visit(element, onVisit);
@@ -653,12 +705,30 @@ function visit(node, onVisit) {
   const { parentNode } = node;
   return visit(parentNode instanceof ShadowRoot ? parentNode.host : parentNode, onVisit);
 }
+/**
+ * This helper returns true when an element has the descendant in question.
+ *
+ * @param {Element} element The starting element.
+ * @param {Element} maybeDescendant The descendant.
+ * @returns {boolean} The result.
+ */
 function containsCrossShadowBoundary(element, maybeDescendant) {
   return !!walkUpAncestry(maybeDescendant, (node) => (node === element ? true : undefined));
 }
+/**
+ * This helper returns true when an element has a setFocus method.
+ *
+ * @param {Element} el An element.
+ * @returns {boolean} The result.
+ */
 function isCalciteFocusable(el) {
   return typeof el?.setFocus === "function";
 }
+/**
+ * This helper focuses an element using the `setFocus` method if available and falls back to using the `focus` method if not available.
+ *
+ * @param {Element} el An element.
+ */
 async function focusElement(el) {
   if (!el) {
     return;
@@ -718,10 +788,24 @@ function querySingle(element, slotSelector, options) {
   const selector = options?.selector;
   return selector ? match?.querySelector(selector) : match;
 }
+/**
+ * Filters direct children.
+ *
+ * @param {Element} el An element.
+ * @param {string} selector The selector.
+ * @returns {Element[]} An array of elements.
+ */
 function filterDirectChildren(el, selector) {
   return Array.from(el.children).filter((child) => child.matches(selector));
 }
-// set a default icon from a defined set or allow an override with an icon name string
+/**
+ * Set a default icon from a defined set or allow an override with an icon name string
+ *
+ * @param {Record<string, string>} iconObject The icon object.
+ * @param {string | boolean} iconValue The icon value.
+ * @param {string} matchedValue The matched value.
+ * @returns {string|undefined} The resulting icon value.
+ */
 function setRequestedIcon(iconObject, iconValue, matchedValue) {
   if (typeof iconValue === "string" && iconValue !== "") {
     return iconValue;
@@ -730,6 +814,13 @@ function setRequestedIcon(iconObject, iconValue, matchedValue) {
     return iconObject[matchedValue];
   }
 }
+/**
+ * This helper returns true when two rectangles intersect.
+ *
+ * @param {DOMRect} rect1 The first rectangle.
+ * @param {DOMRect} rect2 The second rectangle.
+ * @returns {boolean} The result.
+ */
 function intersects(rect1, rect2) {
   return !(rect2.left > rect1.right ||
     rect2.right < rect1.left ||
@@ -741,7 +832,7 @@ function intersects(rect1, rect2) {
  *
  * It should only be used for aria attributes that require a string value of "true" or "false".
  *
- * @param value
+ * @param {boolean} value The value.
  * @returns {string} The string conversion of a boolean value ("true" | "false").
  */
 function toAriaBoolean(value) {
@@ -754,7 +845,7 @@ function toAriaBoolean(value) {
  * <slot onSlotchange={(event) => this.mySlotHasElement = slotChangeHasAssignedElement(event)} />}
  * ```
  *
- * @param event
+ * @param {Event} event The event.
  * @returns {boolean} Whether the slot has any assigned elements.
  */
 function slotChangeHasAssignedElement(event) {
@@ -767,7 +858,7 @@ function slotChangeHasAssignedElement(event) {
  * <slot onSlotchange={(event) => this.mySlotElements = slotChangeGetAssignedElements(event)} />}
  * ```
  *
- * @param event
+ * @param {Event} event The event.
  * @returns {boolean} Whether the slot has any assigned elements.
  */
 function slotChangeGetAssignedElements(event) {
@@ -780,12 +871,20 @@ function slotChangeGetAssignedElements(event) {
  *
  * See https://www.w3.org/TR/pointerevents/#the-button-property.
  *
- * @param event
- * @returns {boolean}
+ * @param {PointerEvent} event The pointer event.
+ * @returns {boolean} The value.
  */
 function isPrimaryPointerButton(event) {
   return !!(event.isPrimary && event.button === 0);
 }
+/**
+ * This helper sets focus on and returns a destination element from within a group of provided elements.
+ *
+ * @param {Element[]} elements An array of elements.
+ * @param {Element} currentElement The current element.
+ * @param {FocusElementInGroupDestination} destination The target destination element to focus.
+ * @returns {Element} The focused element
+ */
 const focusElementInGroup = (elements, currentElement, destination) => {
   const currentIndex = elements.indexOf(currentElement);
   const isFirstItem = currentIndex === 0;

package/dist/cjs/{filter-7b1ac325.js → filter-8c4330df.js}

@@ -1,11 +1,11 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.4.0-next.7
+ * v1.4.0-next.9
  */
 'use strict';
 
-const debounce = require('./debounce-b3ebca79.js');
+const debounce = require('./debounce-62f8d984.js');
 
 /**
  * A specialized version of `_.map` for arrays without support for iteratee

package/dist/cjs/{floating-ui-4bb47c90.js → floating-ui-4a7a6d1a.js}

@@ -1,12 +1,12 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.4.0-next.7
+ * v1.4.0-next.9
  */
 'use strict';
 
-const dom = require('./dom-21aaf3f4.js');
-const debounce = require('./debounce-b3ebca79.js');
+const dom = require('./dom-059a146f.js');
+const debounce = require('./debounce-62f8d984.js');
 
 function getAlignment(placement) {
   return placement.split('-')[1];
@@ -1551,7 +1551,7 @@ async function patchFloatingUiForNonChromiumBrowsers() {
   if (config.floatingUINonChromiumPositioningFix &&
     // ⚠️ browser-sniffing is not a best practice and should be avoided ⚠️
     (/firefox|safari/i.test(getUAString()) || isChrome109OrAbove())) {
-    const { offsetParent } = await Promise.resolve().then(function () { return require('./composed-offset-position.esm-32cef964.js'); });
+    const { offsetParent } = await Promise.resolve().then(function () { return require('./composed-offset-position.esm-4691c9a5.js'); });
     const originalGetOffsetParent = platform.getOffsetParent;
     platform.getOffsetParent = (element) => originalGetOffsetParent(element, offsetParent);
   }

package/dist/cjs/{focusTrapComponent-4fc83c52.js → focusTrapComponent-cb5d70a9.js}

@@ -1,11 +1,11 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.4.0-next.7
+ * v1.4.0-next.9
  */
 'use strict';
 
-const dom = require('./dom-21aaf3f4.js');
+const dom = require('./dom-059a146f.js');
 
 /*!
 * focus-trap 7.4.0

package/dist/cjs/{form-9cc29ef1.js → form-fb994640.js}

@@ -1,12 +1,12 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.4.0-next.7
+ * v1.4.0-next.9
  */
 'use strict';
 
-const dom = require('./dom-21aaf3f4.js');
-const index = require('./index-d0394290.js');
+const dom = require('./dom-059a146f.js');
+const index = require('./index-db070a19.js');
 
 (function(prototype) {
   if (typeof prototype.requestSubmit == "function") return

package/dist/cjs/{guid-43b37504.js → guid-4fcf21f9.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.4.0-next.7
+ * v1.4.0-next.9
  */
 'use strict';
 

package/dist/cjs/{index-d0394290.js → index-db070a19.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.4.0-next.7
+ * v1.4.0-next.9
  */
 'use strict';
 

package/dist/cjs/index.cjs.js

@@ -1,13 +1,13 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.4.0-next.7
+ * v1.4.0-next.9
  */
 'use strict';
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-const index = require('./index-d0394290.js');
+const index = require('./index-db070a19.js');
 
 
 

package/dist/cjs/{interactive-ba615a5f.js → interactive-7f63a8d1.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.4.0-next.7
+ * v1.4.0-next.9
  */
 'use strict';
 

package/dist/cjs/{key-88971126.js → key-ac843775.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.4.0-next.7
+ * v1.4.0-next.9
  */
 'use strict';
 

package/dist/cjs/{label-a63005cd.js → label-889abbdf.js}

@@ -1,11 +1,11 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.4.0-next.7
+ * v1.4.0-next.9
  */
 'use strict';
 
-const dom = require('./dom-21aaf3f4.js');
+const dom = require('./dom-059a146f.js');
 
 /**
  * Exported for testing purposes only

package/dist/cjs/{loadable-c2a58fbe.js → loadable-8566025a.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.4.0-next.7
+ * v1.4.0-next.9
  */
 'use strict';