@schukai/monster 1.12.0 → 1.15.0

package/source/data/pipe.js

@@ -4,7 +4,7 @@
  * @author schukai GmbH
  */
 
-import {Monster} from '../namespace.js';
+import {Monster, assignToNamespace} from '../namespace.js';
 import {Transformer} from './transformer.js';
 import {Base} from '../types/base.js';
 import {validateFunction, validateString} from '../types/validate.js';
@@ -19,7 +19,7 @@ const DELIMITER = '|';
  *
  * ```
  * <script type="module"> 
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.12.0/dist/modules/data/pipe.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.0/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.12.0/dist/modules/data/pipe.js';
+ * import {Pipe} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.0/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.12.0/dist/modules/data/pipe.js';
+ * import {Pipe} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.0/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,8 +3,7 @@
 /**
  * @author schukai GmbH
  */
-
-import {Monster} from '../namespace.js';
+import {Monster, assignToNamespace} from '../namespace.js';
 import {Base} from '../types/base.js';
 import {getGlobal} from "../types/global.js";
 import {
@@ -26,7 +25,7 @@ import {Pathfinder} from "./pathfinder.js";
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.12.0/dist/modules/data/transformer.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.0/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.12.0/dist/modules/data/transformer.js';
+ * import {Transformer} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.0/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.12.0/dist/modules/data/transformer.js';
+ * import {Transformer} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.0/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,8 +3,8 @@
 /**
  * @author schukai GmbH
  */
-
-import {Monster, Base} from '../types/base.js';
+import {Monster, assignToNamespace} from '../namespace.js';
+import { Base} from '../types/base.js';
 import {validateInstance, validateString} from "../types/validate.js";
 import {getGlobalFunction} from "../types/global.js";
 import {ProxyObserver} from "../types/proxyobserver.js";
@@ -23,7 +23,7 @@ const ATTRIBUTEPREFIX = "data-monster-";
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.12.0/dist/modules/dom/assembler.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.0/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.12.0/dist/modules/dom/assembler.js';
+ * import {Assembler} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.0/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,7 +4,7 @@
  * @author schukai GmbH
  */
 
-import {Monster} from '../namespace.js';
+import {Monster, assignToNamespace} from '../namespace.js';
 import {getGlobalFunction} from "../types/global.js";
 import {isInstance} from "../types/is.js";
 import {TokenList} from "../types/tokenlist.js";
@@ -21,7 +21,7 @@ import {ATTRIBUTE_OBJECTLINK} from "./constants.js";
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.12.0/dist/modules/dom/updater.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.0/dist/modules/dom/updater.js';
  * console.log(Monster.DOM.findClosestObjectLink())
  * </script>
  * ```
@@ -30,30 +30,20 @@ import {ATTRIBUTE_OBJECTLINK} from "./constants.js";
  *
  * ```
  * <script type="module">
- * import {getUpdaterFromNode} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.12.0/dist/modules/dom/updater.js';
+ * import {getUpdaterFromNode} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.0/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 +51,7 @@ function findClosestObjectLink(node) {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.12.0/dist/modules/dom/attributes.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.0/dist/modules/dom/attributes.js';
  * Monster.DOM.addToObjectLink();
  * </script>
  * ```
@@ -70,7 +60,7 @@ function findClosestObjectLink(node) {
  *
  * ```
  * <script type="module">
- * import {addToObjectLink} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.12.0/dist/modules/dom/attributes.js';
+ * import {addToObjectLink} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.0/dist/modules/dom/attributes.js';
  * addToObjectLink();
  * </script>
  * ```
@@ -103,7 +93,7 @@ function addToObjectLink(element, symbol, object) {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.12.0/dist/modules/dom/attributes.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.0/dist/modules/dom/attributes.js';
  * Monster.DOM.removeObjectLink();
  * </script>
  * ```
@@ -112,7 +102,7 @@ function addToObjectLink(element, symbol, object) {
  *
  * ```
  * <script type="module">
- * import {removeObjectLink} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.12.0/dist/modules/dom/attributes.js';
+ * import {removeObjectLink} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.0/dist/modules/dom/attributes.js';
  * removeObjectLink();
  * </script>
  * ```
@@ -145,7 +135,7 @@ function removeObjectLink(element, symbol) {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.12.0/dist/modules/dom/attributes.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.0/dist/modules/dom/attributes.js';
  * Monster.DOM.hasObjectLink();
  * </script>
  * ```
@@ -154,7 +144,7 @@ function removeObjectLink(element, symbol) {
  *
  * ```
  * <script type="module">
- * import {hasObjectLink} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.12.0/dist/modules/dom/attributes.js';
+ * import {hasObjectLink} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.0/dist/modules/dom/attributes.js';
  * hasObjectLink();
  * </script>
  * ```
@@ -180,18 +170,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.12.0/dist/modules/dom/attributes.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.0/dist/modules/dom/attributes.js';
  * Monster.DOM.getLinkedObjects();
  * </script>
  * ```
@@ -200,7 +190,7 @@ function hasObjectLink(element, symbol) {
  *
  * ```
  * <script type="module">
- * import {getLinkedObjects} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.12.0/dist/modules/dom/attributes.js';
+ * import {getLinkedObjects} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.0/dist/modules/dom/attributes.js';
  * getLinkedObjects();
  * </script>
  * ```
@@ -236,7 +226,7 @@ function getLinkedObjects(element, symbol) {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.12.0/dist/modules/dom/attributes.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.0/dist/modules/dom/attributes.js';
  * Monster.DOM.toggleAttributeToken();
  * </script>
  * ```
@@ -245,7 +235,7 @@ function getLinkedObjects(element, symbol) {
  *
  * ```
  * <script type="module">
- * import {toggleAttributeToken} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.12.0/dist/modules/dom/attributes.js';
+ * import {toggleAttributeToken} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.0/dist/modules/dom/attributes.js';
  * toggleAttributeToken();
  * </script>
  * ```
@@ -280,7 +270,7 @@ function toggleAttributeToken(element, key, token) {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.12.0/dist/modules/dom/attributes.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.0/dist/modules/dom/attributes.js';
  * Monster.DOM.addAttributeToken();
  * </script>
  * ```
@@ -289,7 +279,7 @@ function toggleAttributeToken(element, key, token) {
  *
  * ```
  * <script type="module">
- * import {addAttributeToken} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.12.0/dist/modules/dom/attributes.js';
+ * import {addAttributeToken} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.0/dist/modules/dom/attributes.js';
  * addAttributeToken();
  * </script>
  * ```
@@ -326,7 +316,7 @@ function addAttributeToken(element, key, token) {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.12.0/dist/modules/dom/attributes.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.0/dist/modules/dom/attributes.js';
  * Monster.DOM.removeAttributeToken();
  * </script>
  * ```
@@ -335,7 +325,7 @@ function addAttributeToken(element, key, token) {
  *
  * ```
  * <script type="module">
- * import {removeAttributeToken} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.12.0/dist/modules/dom/attributes.js';
+ * import {removeAttributeToken} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.0/dist/modules/dom/attributes.js';
  * removeAttributeToken();
  * </script>
  * ```
@@ -371,7 +361,7 @@ function removeAttributeToken(element, key, token) {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.12.0/dist/modules/dom/attributes.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.0/dist/modules/dom/attributes.js';
  * Monster.DOM.containsAttributeToken();
  * </script>
  * ```
@@ -380,7 +370,7 @@ function removeAttributeToken(element, key, token) {
  *
  * ```
  * <script type="module">
- * import {containsAttributeToken} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.12.0/dist/modules/dom/attributes.js';
+ * import {containsAttributeToken} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.0/dist/modules/dom/attributes.js';
  * containsAttributeToken();
  * </script>
  * ```
@@ -413,7 +403,7 @@ function containsAttributeToken(element, key, token) {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.12.0/dist/modules/dom/attributes.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.0/dist/modules/dom/attributes.js';
  * Monster.DOM.replaceAttributeToken();
  * </script>
  * ```
@@ -422,7 +412,7 @@ function containsAttributeToken(element, key, token) {
  *
  * ```
  * <script type="module">
- * import {replaceAttributeToken} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.12.0/dist/modules/dom/attributes.js';
+ * import {replaceAttributeToken} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.0/dist/modules/dom/attributes.js';
  * replaceAttributeToken();
  * </script>
  * ```
@@ -458,7 +448,7 @@ function replaceAttributeToken(element, key, from, to) {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.12.0/dist/modules/dom/attributes.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.0/dist/modules/dom/attributes.js';
  * Monster.DOM.clearAttributeTokens();
  * </script>
  * ```
@@ -467,13 +457,13 @@ function replaceAttributeToken(element, key, from, to) {
  *
  * ```
  * <script type="module">
- * import {clearAttributeTokens} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.12.0/dist/modules/dom/attributes.js';
+ * import {clearAttributeTokens} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.15.0/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 +482,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.0/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.0/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, assignToNamespace} from '../namespace.js';
 /**
  * @author schukai GmbH
  */
@@ -86,23 +85,23 @@ const ATTRIBUTE_UPDATER_BIND = ATTRIBUTE_PREFIX + 'bind';
 /**
  * @memberOf Monster/DOM
  * @type {string}
- * @since 1.9.0
+ * @since 1.14.0
  */
-const ATTRIBUTE_OBJECTLINK = ATTRIBUTE_PREFIX + 'objectlink';
+const ATTRIBUTE_ROLE = ATTRIBUTE_PREFIX + 'role';
 
 /**
  * @memberOf Monster/DOM
  * @type {string}
- * @since 1.10.0
+ * @since 1.9.0
  */
-const OBJECTLINK_KEY_UPDATER = 'monsterUpdater';
+const ATTRIBUTE_OBJECTLINK = ATTRIBUTE_PREFIX + 'objectlink';
 
 /**
  * @memberOf Monster/DOM
  * @type {string}
  * @since 1.10.0
  */
-const OBJECTLINK_KEY_OPTIONS = 'monsterOptions';
+const OBJECTLINK_KEY_UPDATER = 'monsterUpdater';
 
 
 export {
@@ -111,6 +110,7 @@ export {
     ATTRIBUTE_OPTIONS,
     DEFAULT_THEME,
     ATTRIBUTE_THEME_PREFIX,
+    ATTRIBUTE_ROLE,
     ATTRIBUTE_THEME_NAME,
     ATTRIBUTE_UPDATER_ATTRIBUTES,
     ATTRIBUTE_UPDATER_REPLACE,
@@ -119,6 +119,5 @@ export {
     ATTRIBUTE_UPDATER_REMOVE,
     ATTRIBUTE_UPDATER_BIND,
     ATTRIBUTE_OBJECTLINK,
-    OBJECTLINK_KEY_UPDATER,
-    OBJECTLINK_KEY_OPTIONS
+    OBJECTLINK_KEY_UPDATER
 }