@aurodesignsystem/auro-library 5.9.0 → 5.11.0

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Semantic Release Automated Changelog
 
+# [5.11.0](https://github.com/AlaskaAirlines/auro-library/compare/v5.10.0...v5.11.0) (2026-02-20)
+
+
+### Features
+
+* add function for finding closest elem with defined attr [#222](https://github.com/AlaskaAirlines/auro-library/issues/222) ([e0a311d](https://github.com/AlaskaAirlines/auro-library/commit/e0a311db4b2d112d2bcfcce437e75553b16efe3e))
+* new function to get nearest defined locale [#223](https://github.com/AlaskaAirlines/auro-library/issues/223) ([7562865](https://github.com/AlaskaAirlines/auro-library/commit/756286553b301bc679648f2764d23b4682304a40))
+
+# [5.10.0](https://github.com/AlaskaAirlines/auro-library/compare/v5.9.0...v5.10.0) (2026-02-17)
+
+
+### Features
+
+* add class for unique ID generation [#220](https://github.com/AlaskaAirlines/auro-library/issues/220) ([8b7318c](https://github.com/AlaskaAirlines/auro-library/commit/8b7318c7e08c5c5cf858352a3801a680fc63204b))
+
 # [5.9.0](https://github.com/AlaskaAirlines/auro-library/compare/v5.8.0...v5.9.0) (2026-01-28)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aurodesignsystem/auro-library",
-  "version": "5.9.0",
+  "version": "5.11.0",
   "description": "This repository holds shared scripts, utilities, and workflows utilized across repositories along the Auro Design System.",
   "repository": {
     "type": "git",

package/scripts/runtime/domHandler/domHandler.mjs

@@ -0,0 +1,85 @@
+/**
+ * Class for interaction with the DOM.
+ */
+export class DomHandler {
+  /**
+   * Walk up the DOM (including Shadow DOM boundaries) to find
+   * the closest ancestor with a given attribute.
+   *
+   * @param {Node} startNode - The node to start from
+   * @param {string} attrName - Attribute name to match
+   * @returns {Element|null}
+   */
+  closestWithAttribute(startNode, attrName) {
+    let node = startNode;
+
+    while (node) {
+      // Only check Elements
+      if (node.nodeType === Node.ELEMENT_NODE && node.hasAttribute(attrName)) {
+        return node;
+      }
+
+      // Normal DOM parent
+      if (node.parentNode) {
+        node = node.parentNode;
+        continue;
+      }
+
+      // Cross Shadow DOM boundary
+      if (node instanceof ShadowRoot) {
+        node = node.host;
+        continue;
+      }
+
+      // If we're inside a shadow tree and parentNode is null
+      if (node.getRootNode) {
+        const root = node.getRootNode();
+        if (root instanceof ShadowRoot) {
+          node = root.host;
+          continue;
+        }
+      }
+
+      // Nothing left to traverse
+      node = null;
+    }
+
+    return null;
+  }
+
+  /**
+   * If the locale wasn't set via attribute on `elem`,
+   * then use the closest `data-locale` attribute crawling up the DOM tree.
+   * If none is found, default to 'en-US'.
+   */
+  getLocale(elem) {
+    let locale = "en-US";
+
+    try {
+      if (elem.hasAttribute("locale")) {
+        locale = elem.getAttribute("locale");
+      } else {
+        const closestLocaleElement = this.closestWithAttribute(
+          elem,
+          "data-locale",
+        );
+
+        if (closestLocaleElement) {
+          locale = closestLocaleElement.getAttribute("data-locale");
+        }
+      }
+    } catch (error) {
+      if (!elem) {
+        console.debug(
+          "Auro getLocale: No element provided, defaulting to 'en-US'",
+        );
+      } else {
+        console.debug(
+          "Auro getLocale: Error accessing attributes, defaulting to 'en-US'",
+        );
+      }
+    }
+
+    return locale;
+  }
+}

package/scripts/runtime/domHandler/index.mjs

@@ -0,0 +1 @@
+export * from "./domHandler.mjs";

package/scripts/runtime/uniqueHash/index.mjs

@@ -0,0 +1 @@
+export * from "./uniqueHash.mjs";

package/scripts/runtime/uniqueHash/uniqueHash.mjs

@@ -0,0 +1,15 @@
+/**
+ * Class for generating unique hashes based on the current timestamp.
+ * This can be used to create unique identifiers for elements or data within an application,
+ * ensuring that each identifier is distinct and can be easily generated without the need
+ * for external libraries or complex algorithms.
+ */
+export class UniqueId {
+  /**
+   * Creates a unique hash based on the current timestamp.
+   * @returns {Function} Timestamp as a base-36 string
+   */
+  create() {
+    return Date.now().toString(36);
+  }
+}