@aurodesignsystem/auro-library 2.0.0 → 2.1.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Semantic Release Automated Changelog
 
+# [2.1.0](https://github.com/AlaskaAirlines/auro-library/compare/v2.0.0...v2.1.0) (2023-12-28)
+
+
+### Features
+
+* **closest:** add closest element function [#43](https://github.com/AlaskaAirlines/auro-library/issues/43) ([f215c74](https://github.com/AlaskaAirlines/auro-library/commit/f215c746c59d70007da2b3fcad7dfb74420bd182))
+
 # [2.0.0](https://github.com/AlaskaAirlines/auro-library/compare/v1.1.0...v2.0.0) (2023-10-05)
 
 

package/package.json

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

package/scripts/utils/auroLibraryUtils.mjs

@@ -174,5 +174,21 @@ export default class AuroLibraryUtils {
      */
     fs.writeFileSync(destination, result, { encoding: 'utf8'});
   }
+
+  /**
+   * Finds and returns the closest HTML Element based on a selector.
+   */
+  closestElement(
+    selector, // selector like in .closest()
+    base = this, // extra functionality to skip a parent
+    __Closest = (el, found = el && el.closest(selector)) =>
+      !el || el === document || el === window
+        ? null // standard .closest() returns null for non-found selectors also
+        : found
+          ? found // found a selector INside this element
+          : __Closest(el.getRootNode().host) // recursion!! break out to parent DOM
+  ) {
+    return __Closest(base);
+  }
 }