@schukai/monster 1.13.0 → 1.15.2

package/source/data/pathfinder.js

@@ -3,12 +3,11 @@
 /**
  * @author schukai GmbH
  */
-
-import {Monster} from '../namespace.js';
-import {isObject, isArray, isInteger} from '../types/is.js';
-import {validateString, validateInteger} from '../types/validate.js';
+import {assignToNamespace, Monster} from '../namespace.js';
 import {Base} from '../types/base.js';
+import {isArray, isInteger, isObject} from '../types/is.js';
 import {Stack} from "../types/stack.js";
+import {validateInteger, validateString} from '../types/validate.js';
 
 /**
  * path separator
@@ -28,7 +27,7 @@ const WILDCARD = '*';
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.13.0/dist/modules/data/pathfinder.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.2/dist/modules/data/pathfinder.js';
  * console.log(new Monster.Data.Pathfinder())
  * </script>
  * ```
@@ -37,7 +36,7 @@ const WILDCARD = '*';
  *
  * ```
  * <script type="module">
- * import {Pathfinder} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.13.0/dist/modules/data/pathfinder.js';
+ * import {Pathfinder} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.2/dist/modules/data/pathfinder.js';
  * console.log(new Pathfinder())
  * </script>
  * ```
@@ -79,7 +78,7 @@ const WILDCARD = '*';
  *
  * @example
  *
- * import {Pathfinder} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.13.0/dist/modules/data/pathfinder.js';
+ * import {Pathfinder} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.2/dist/modules/data/pathfinder.js';
  *
  * let value = new Pathfinder({
  * a: {
@@ -105,7 +104,7 @@ const WILDCARD = '*';
  *
  * @example
  *
- * import {Pathfinder} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.13.0/dist/modules/data/pathfinder.js';
+ * import {Pathfinder} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.2/dist/modules/data/pathfinder.js';
  *
  * let p = new Pathfinder({
  *                a: {
@@ -226,7 +225,7 @@ class Pathfinder extends Base {
 
 }
 
-Monster.assignToNamespace('Monster.Data', Pathfinder);
+assignToNamespace('Monster.Data', Pathfinder);
 export {Monster, Pathfinder}
 
 /**
@@ -399,7 +398,7 @@ function setValueViaPath(object, path, value) {
         assignProperty(anchor, last, value);
     }
 
-    return;
+    
 
 }
 
@@ -412,7 +411,7 @@ function setValueViaPath(object, path, value) {
 function assignProperty(object, key, value) {
 
     if (!object.hasOwnProperty(key)) {
-        object[key]=value;
+        object[key] = value;
         return;
     }
 
@@ -420,8 +419,8 @@ function assignProperty(object, key, value) {
         delete object[key];
     }
 
-    object[key]=value;
-    return;
+    object[key] = value;
+    
 }
 
 /**
@@ -457,6 +456,6 @@ function deleteValueViaPath(object, path) {
         delete anchor[last];
     }
 
-    return;
+    
 
 }

package/source/data/pipe.js

@@ -4,10 +4,10 @@
  * @author schukai GmbH
  */
 
-import {Monster} from '../namespace.js';
-import {Transformer} from './transformer.js';
+import {assignToNamespace, Monster} from '../namespace.js';
 import {Base} from '../types/base.js';
-import {validateFunction, validateString} from '../types/validate.js';
+import {validateString} from '../types/validate.js';
+import {Transformer} from './transformer.js';
 
 
 const DELIMITER = '|';
@@ -18,8 +18,8 @@ const DELIMITER = '|';
  * You can call the method via the monster namespace `new Monster.Data.Pipe()`.
  *
  * ```
- * <script type="module"> 
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.13.0/dist/modules/data/pipe.js';
+ * <script type="module">
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.2/dist/modules/data/pipe.js';
  * console.log(new Monster.Data.Pipe())
  * </script>
  * ```
@@ -28,7 +28,7 @@ const DELIMITER = '|';
  *
  * ```
  * <script type="module">
- * import {Pipe} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.13.0/dist/modules/data/pipe.js';
+ * import {Pipe} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.2/dist/modules/data/pipe.js';
  * console.log(new Pipe())
  * </script>
  * ```
@@ -39,7 +39,7 @@ const DELIMITER = '|';
  * the word is then converted to uppercase letters and a prefix Hello is added. the two backslash safe the space char.
  *
  * @example
- * import {Pipe} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.13.0/dist/modules/data/pipe.js';
+ * import {Pipe} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.2/dist/modules/data/pipe.js';
  *
  * let obj = {
  *    a: {
@@ -106,5 +106,5 @@ class Pipe extends Base {
     }
 }
 
-Monster.assignToNamespace('Monster.Data', Pipe);
+assignToNamespace('Monster.Data', Pipe);
 export {Monster, Pipe}

package/source/data/transformer.js

@@ -3,19 +3,18 @@
 /**
  * @author schukai GmbH
  */
-
-import {Monster} from '../namespace.js';
+import {assignToNamespace, Monster} from '../namespace.js';
 import {Base} from '../types/base.js';
 import {getGlobal} from "../types/global.js";
+import {ID} from '../types/id.js';
+import {isArray, isObject, isString} from '../types/is.js';
 import {
-    validateString,
-    validatePrimitive,
     validateFunction,
     validateInteger,
-    validateObject
+    validateObject,
+    validatePrimitive,
+    validateString
 } from '../types/validate.js';
-import {isObject, isString, isArray} from '../types/is.js';
-import {ID} from '../types/id.js';
 import {clone} from "../util/clone.js";
 import {Pathfinder} from "./pathfinder.js";
 
@@ -26,7 +25,7 @@ import {Pathfinder} from "./pathfinder.js";
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.13.0/dist/modules/data/transformer.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.2/dist/modules/data/transformer.js';
  * console.log(new Monster.Data.Transformer())
  * </script>
  * ```
@@ -35,7 +34,7 @@ import {Pathfinder} from "./pathfinder.js";
  *
  * ```
  * <script type="module">
- * import {Transformer} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.13.0/dist/modules/data/transformer.js';
+ * import {Transformer} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.2/dist/modules/data/transformer.js';
  * console.log(new Transformer())
  * </script>
  * ```
@@ -114,7 +113,7 @@ import {Pathfinder} from "./pathfinder.js";
  *
  * @example
  *
- * import {Transformer} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.13.0/dist/modules/data/transformer.js';
+ * import {Transformer} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.2/dist/modules/data/transformer.js';
  *
  * const transformer = new Transformer("tolower")
  *
@@ -181,7 +180,7 @@ class Transformer extends Base {
     }
 }
 
-Monster.assignToNamespace('Monster.Data', Transformer);
+assignToNamespace('Monster.Data', Transformer);
 export {Monster, Transformer}
 
 /**
@@ -465,3 +464,4 @@ function transform(value) {
 
     return value;
 }
+

package/source/dom/assembler.js

@@ -3,16 +3,16 @@
 /**
  * @author schukai GmbH
  */
-
-import {Monster, Base} from '../types/base.js';
-import {validateInstance, validateString} from "../types/validate.js";
+import {assignToNamespace, Monster} from '../namespace.js';
+import {Base} from '../types/base.js';
 import {getGlobalFunction} from "../types/global.js";
 import {ProxyObserver} from "../types/proxyobserver.js";
+import {validateInstance, validateString} from "../types/validate.js";
 
 
 /**
  * attribute prefix
- * 
+ *
  * @type {string}
  * @memberOf Monster/DOM
  */
@@ -23,7 +23,7 @@ const ATTRIBUTEPREFIX = "data-monster-";
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.13.0/dist/modules/dom/assembler.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.2/dist/modules/dom/assembler.js';
  * console.log(new Monster.DOM.Assembler())
  * </script>
  * ```
@@ -32,7 +32,7 @@ const ATTRIBUTEPREFIX = "data-monster-";
  *
  * ```
  * <script type="module">
- * import {Assembler} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.13.0/dist/modules/dom/assembler.js';
+ * import {Assembler} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.2/dist/modules/dom/assembler.js';
  * console.log(new Assembler())
  * </script>
  * ```
@@ -95,5 +95,5 @@ class Assembler extends Base {
 
 }
 
-Monster.assignToNamespace('Monster.DOM', Assembler);
+assignToNamespace('Monster.DOM', Assembler);
 export {Monster, ATTRIBUTEPREFIX, Assembler}

package/source/dom/attributes.js

@@ -4,9 +4,8 @@
  * @author schukai GmbH
  */
 
-import {Monster} from '../namespace.js';
+import {assignToNamespace, Monster} from '../namespace.js';
 import {getGlobalFunction} from "../types/global.js";
-import {isInstance} from "../types/is.js";
 import {TokenList} from "../types/tokenlist.js";
 import {validateInstance, validateString, validateSymbol} from "../types/validate.js";
 import {ATTRIBUTE_OBJECTLINK} from "./constants.js";
@@ -21,7 +20,7 @@ import {ATTRIBUTE_OBJECTLINK} from "./constants.js";
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.13.0/dist/modules/dom/updater.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.2/dist/modules/dom/updater.js';
  * console.log(Monster.DOM.findClosestObjectLink())
  * </script>
  * ```
@@ -30,30 +29,20 @@ import {ATTRIBUTE_OBJECTLINK} from "./constants.js";
  *
  * ```
  * <script type="module">
- * import {getUpdaterFromNode} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.13.0/dist/modules/dom/updater.js';
+ * import {getUpdaterFromNode} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.2/dist/modules/dom/updater.js';
  * console.log(findClosestObjectLink())
  * </script>
  * ```
  *
- * @param {Node} node
- * @return {Node|undefined}
+ * @param {HTMLElement} element
+ * @return {HTMLElement|undefined}
  * @since 1.10.0
  * @copyright schukai GmbH
  * @memberOf Monster/DOM
- * @throws {TypeError} value is not an instance of Node
+ * @throws {TypeError} value is not an instance of HTMLElement
  */
-function findClosestObjectLink(node) {
-    validateInstance(node, getGlobalFunction('Node'));
-
-    let attribute = node.hasAttribute(ATTRIBUTE_OBJECTLINK);
-    if (attribute === false) {
-        let parentNode = node?.['parentNode'];
-        if (isInstance(parentNode, getGlobalFunction('Node'))) {
-            return findClosestObjectLink(parentNode)
-        }
-    }
-
-    return node;
+function findClosestObjectLink(element) {
+    return findClosestByAttribute(element, ATTRIBUTE_OBJECTLINK);
 }
 
 /**
@@ -61,7 +50,7 @@ function findClosestObjectLink(node) {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.13.0/dist/modules/dom/attributes.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.2/dist/modules/dom/attributes.js';
  * Monster.DOM.addToObjectLink();
  * </script>
  * ```
@@ -70,7 +59,7 @@ function findClosestObjectLink(node) {
  *
  * ```
  * <script type="module">
- * import {addToObjectLink} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.13.0/dist/modules/dom/attributes.js';
+ * import {addToObjectLink} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.2/dist/modules/dom/attributes.js';
  * addToObjectLink();
  * </script>
  * ```
@@ -103,7 +92,7 @@ function addToObjectLink(element, symbol, object) {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.13.0/dist/modules/dom/attributes.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.2/dist/modules/dom/attributes.js';
  * Monster.DOM.removeObjectLink();
  * </script>
  * ```
@@ -112,7 +101,7 @@ function addToObjectLink(element, symbol, object) {
  *
  * ```
  * <script type="module">
- * import {removeObjectLink} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.13.0/dist/modules/dom/attributes.js';
+ * import {removeObjectLink} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.2/dist/modules/dom/attributes.js';
  * removeObjectLink();
  * </script>
  * ```
@@ -145,7 +134,7 @@ function removeObjectLink(element, symbol) {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.13.0/dist/modules/dom/attributes.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.2/dist/modules/dom/attributes.js';
  * Monster.DOM.hasObjectLink();
  * </script>
  * ```
@@ -154,7 +143,7 @@ function removeObjectLink(element, symbol) {
  *
  * ```
  * <script type="module">
- * import {hasObjectLink} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.13.0/dist/modules/dom/attributes.js';
+ * import {hasObjectLink} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.2/dist/modules/dom/attributes.js';
  * hasObjectLink();
  * </script>
  * ```
@@ -180,18 +169,18 @@ function hasObjectLink(element, symbol) {
 }
 
 /**
- * The ObjectLink can be used to attach objects to HTMLElements. The elements are kept in a set under a unique 
- * symbol and can be read via an iterator {@see getLinkedObjects}. 
- * 
+ * The ObjectLink can be used to attach objects to HTMLElements. The elements are kept in a set under a unique
+ * symbol and can be read via an iterator {@see getLinkedObjects}.
+ *
  * In addition, elements with an objectLink receive the attribute `data-monster-objectlink`.
- * 
+ *
  * With the method  {@see addToObjectLink} the objects can be added.
- * 
+ *
  * You can call the method via the monster namespace `new Monster.DOM.getLinkedObjects()`.
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.13.0/dist/modules/dom/attributes.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.2/dist/modules/dom/attributes.js';
  * Monster.DOM.getLinkedObjects();
  * </script>
  * ```
@@ -200,7 +189,7 @@ function hasObjectLink(element, symbol) {
  *
  * ```
  * <script type="module">
- * import {getLinkedObjects} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.13.0/dist/modules/dom/attributes.js';
+ * import {getLinkedObjects} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.2/dist/modules/dom/attributes.js';
  * getLinkedObjects();
  * </script>
  * ```
@@ -236,7 +225,7 @@ function getLinkedObjects(element, symbol) {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.13.0/dist/modules/dom/attributes.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.2/dist/modules/dom/attributes.js';
  * Monster.DOM.toggleAttributeToken();
  * </script>
  * ```
@@ -245,7 +234,7 @@ function getLinkedObjects(element, symbol) {
  *
  * ```
  * <script type="module">
- * import {toggleAttributeToken} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.13.0/dist/modules/dom/attributes.js';
+ * import {toggleAttributeToken} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.2/dist/modules/dom/attributes.js';
  * toggleAttributeToken();
  * </script>
  * ```
@@ -280,7 +269,7 @@ function toggleAttributeToken(element, key, token) {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.13.0/dist/modules/dom/attributes.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.2/dist/modules/dom/attributes.js';
  * Monster.DOM.addAttributeToken();
  * </script>
  * ```
@@ -289,7 +278,7 @@ function toggleAttributeToken(element, key, token) {
  *
  * ```
  * <script type="module">
- * import {addAttributeToken} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.13.0/dist/modules/dom/attributes.js';
+ * import {addAttributeToken} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.2/dist/modules/dom/attributes.js';
  * addAttributeToken();
  * </script>
  * ```
@@ -326,7 +315,7 @@ function addAttributeToken(element, key, token) {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.13.0/dist/modules/dom/attributes.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.2/dist/modules/dom/attributes.js';
  * Monster.DOM.removeAttributeToken();
  * </script>
  * ```
@@ -335,7 +324,7 @@ function addAttributeToken(element, key, token) {
  *
  * ```
  * <script type="module">
- * import {removeAttributeToken} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.13.0/dist/modules/dom/attributes.js';
+ * import {removeAttributeToken} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.2/dist/modules/dom/attributes.js';
  * removeAttributeToken();
  * </script>
  * ```
@@ -371,7 +360,7 @@ function removeAttributeToken(element, key, token) {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.13.0/dist/modules/dom/attributes.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.2/dist/modules/dom/attributes.js';
  * Monster.DOM.containsAttributeToken();
  * </script>
  * ```
@@ -380,7 +369,7 @@ function removeAttributeToken(element, key, token) {
  *
  * ```
  * <script type="module">
- * import {containsAttributeToken} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.13.0/dist/modules/dom/attributes.js';
+ * import {containsAttributeToken} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.2/dist/modules/dom/attributes.js';
  * containsAttributeToken();
  * </script>
  * ```
@@ -413,7 +402,7 @@ function containsAttributeToken(element, key, token) {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.13.0/dist/modules/dom/attributes.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.2/dist/modules/dom/attributes.js';
  * Monster.DOM.replaceAttributeToken();
  * </script>
  * ```
@@ -422,7 +411,7 @@ function containsAttributeToken(element, key, token) {
  *
  * ```
  * <script type="module">
- * import {replaceAttributeToken} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.13.0/dist/modules/dom/attributes.js';
+ * import {replaceAttributeToken} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.2/dist/modules/dom/attributes.js';
  * replaceAttributeToken();
  * </script>
  * ```
@@ -458,7 +447,7 @@ function replaceAttributeToken(element, key, from, to) {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.13.0/dist/modules/dom/attributes.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.2/dist/modules/dom/attributes.js';
  * Monster.DOM.clearAttributeTokens();
  * </script>
  * ```
@@ -467,13 +456,13 @@ function replaceAttributeToken(element, key, from, to) {
  *
  * ```
  * <script type="module">
- * import {clearAttributeTokens} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.13.0/dist/modules/dom/attributes.js';
+ * import {clearAttributeTokens} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.2/dist/modules/dom/attributes.js';
  * clearAttributeTokens();
  * </script>
  * ```
  *
  * @since 1.9.0
- * @copyright schukai GmbH 
+ * @copyright schukai GmbH
  * @memberOf Monster/DOM
  * @param {HTMLElement} element
  * @param {string} key
@@ -492,13 +481,67 @@ function clearAttributeTokens(element, key) {
     return element
 }
 
+/**
+ * You can call the method via the monster namespace `new Monster.DOM.findClosestByAttribute()`.
+ *
+ * ```
+ * <script type="module">
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.2/dist/modules/dom/attributes.js';
+ * Monster.DOM.findClosestByAttribute();
+ * </script>
+ * ```
+ *
+ * Alternatively, you can also integrate this function individually.
+ *
+ * ```
+ * <script type="module">
+ * import {clearAttributeTokens} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.2/dist/modules/dom/attributes.js';
+ * findClosestByAttribute();
+ * </script>
+ * ```
+ *
+ * @since 1.14.0
+ * @copyright schukai GmbH
+ * @memberOf Monster/DOM
+ * @param {HTMLElement} element
+ * @param {string} key
+ * @return {HTMLElement|undefined}
+ * @throws {TypeError} value is not a string
+ * @throws {TypeError} value is not an instance of HTMLElement
+ */
+
+/**
+ *
+ * @since 1.14.0
+ * @param {HTMLElement} element
+ * @param {string} key
+ * @param {string|undefined} value
+ * @return {HTMLElement|undefined}
+ */
+function findClosestByAttribute(element, key, value) {
+    validateInstance(element, getGlobalFunction('HTMLElement'));
+
+    if (element.hasAttribute(key) && element.getAttribute(key) === value) {
+        return element;
+    }
+
+    let selector = validateString(key);
+    if (value !== undefined) selector += "=" + validateString(value);
+    let result = element.closest('[' + selector + ']');
+    if (result instanceof HTMLElement) {
+        return result;
+    }
+    return undefined;
+}
 
-Monster.assignToNamespace('Monster.DOM', getLinkedObjects, addToObjectLink, removeObjectLink, hasObjectLink, clearAttributeTokens, replaceAttributeToken, containsAttributeToken, removeAttributeToken, addAttributeToken, toggleAttributeToken);
+// exports
+assignToNamespace('Monster.DOM', getLinkedObjects, addToObjectLink, removeObjectLink, findClosestByAttribute, hasObjectLink, clearAttributeTokens, replaceAttributeToken, containsAttributeToken, removeAttributeToken, addAttributeToken, toggleAttributeToken);
 export {
     Monster,
     addToObjectLink,
     removeObjectLink,
     hasObjectLink,
+    findClosestByAttribute,
     clearAttributeTokens,
     replaceAttributeToken,
     containsAttributeToken,

package/source/dom/constants.js

@@ -1,7 +1,6 @@
 'use strict';
 
-import {Monster} from "../namespace.js";
-
+import {Monster} from '../namespace.js';
 /**
  * @author schukai GmbH
  */
@@ -83,6 +82,13 @@ const ATTRIBUTE_UPDATER_REMOVE = ATTRIBUTE_PREFIX + 'remove';
  */
 const ATTRIBUTE_UPDATER_BIND = ATTRIBUTE_PREFIX + 'bind';
 
+/**
+ * @memberOf Monster/DOM
+ * @type {string}
+ * @since 1.14.0
+ */
+const ATTRIBUTE_ROLE = ATTRIBUTE_PREFIX + 'role';
+
 /**
  * @memberOf Monster/DOM
  * @type {string}
@@ -104,6 +110,7 @@ export {
     ATTRIBUTE_OPTIONS,
     DEFAULT_THEME,
     ATTRIBUTE_THEME_PREFIX,
+    ATTRIBUTE_ROLE,
     ATTRIBUTE_THEME_NAME,
     ATTRIBUTE_UPDATER_ATTRIBUTES,
     ATTRIBUTE_UPDATER_REPLACE,