@schukai/monster 1.21.1 → 1.25.0

package/source/data/transformer.js

@@ -5,7 +5,7 @@
  */
 import {assignToNamespace, Monster} from '../namespace.js';
 import {Base} from '../types/base.js';
-import {getGlobal} from "../types/global.js";
+import {getGlobal, getGlobalObject} from "../types/global.js";
 import {ID} from '../types/id.js';
 import {isArray, isObject, isString} from '../types/is.js';
 import {
@@ -25,8 +25,8 @@ import {Pathfinder} from "./pathfinder.js";
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.21.1/dist/modules/data/transformer.js';
- * console.log(new Monster.Data.Transformer())
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.25.0/dist/modules/data/transformer.js';
+ * new Monster.Data.Transformer()
  * </script>
  * ```
  *
@@ -34,12 +34,12 @@ import {Pathfinder} from "./pathfinder.js";
  *
  * ```
  * <script type="module">
- * import {Transformer} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.21.1/dist/modules/data/transformer.js';
- * console.log(new Transformer())
+ * import {Transformer} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.25.0/dist/modules/data/transformer.js';
+ * new Transformer()
  * </script>
  * ```
  *
- * A simple example is the conversion of all characters to lowercase. for this purpose the command tolower must be used.
+ * A simple example is the conversion of all characters to lowercase. for this purpose the command `tolower` must be used.
  *
  * ```
  * let t = new Transformer('tolower').run('ABC'); // ↦ abc
@@ -51,16 +51,23 @@ import {Pathfinder} from "./pathfinder.js";
  *
  * | command      | parameter                  | alias                   | description                                                                                                                                                                                                                                                                                                                                                |
  * |:-------------|:---------------------------|:------------------------|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
- * | base64       |                            |                         | Converts the value to base64                                                                                                                                                                                                                                                                                                                               |
+ * | to-base64    |                            | base64, btob            | Converts the value to base64                                                                                                                                                                                                                                                                                                                               |
+ * | from-base64  |                            | atob                    | Converts the value from base64                                                                                                                                                                                                                                                                                                                             |
  * | call         | function:param1:param2:... |                         | Calling a callback function. The function can be defined in three places: either globally, in the context `addCallback` or in the passed object                                                                                                                                                                                                            |
- * | default      |                            |                         | If the value is undefined the first argument is returned, otherwise the value. (since 1.12.0)                                                                                                                                                                                                                                                              |
+ * | default      | value:type                 | ??                      | If the value is undefined the first argument is returned, otherwise the value. The third optional parameter specifies the desired type. If no type is specified, string is used. Valid types are bool, string, int, float, undefined and object. An object default value must be specified as a base64 encoded json string. (since 1.12.0)                 |
+ * | debug        |                            |                         | the passed value is output (console) and returned  |
  * | empty        |                            |                         | Return empty String ""                                                                                                                                                                                                                                                                                                                                     |
+ * | first-key    | default                    |                         | Can be applied to objects and returns the value of the first key. All keys of the object are fetched and sorted.    (since 1.23.0)                                                                                                                                                                                                                         |
  * | fromjson     |                            |                         | Type conversion from a JSON string (since 1.12.0)                                                                                                                                                                                                                                                                                                          |
- * | if           | statement1:statement2      | ?                       | Is the ternary operator, the first parameter is the valid statement, the second is the false part. To use the current value in the queue, you can set the value keyword. On the other hand, if you want to have the static string "value", you have to put one backslash \\ in front of it and write value. the follow values are true: 'on', true, 'true' |
+ * | if           | statement1:statement2      | ?                       | Is the ternary operator, the first parameter is the valid statement, the second is the false part. To use the current value in the queue, you can set the value keyword. On the other hand, if you want to have the static string "value", you have to put one backslash \\ in front of it and write value. the follow values are true: 'on', true, 'true'. If you want to have a space, you also have to write \\ in front of the space.  |
  * | index        | key:default                | property, key           | Fetches a value from an object, an array, a map or a set                                                                                                                                                                                                                                                                                                   |
+ * | last-key     | default                    |                         | Can be applied to objects and returns the value of the last key. All keys of the object are fetched and sorted. (since 1.23.0)                                                                                                                                                                                                                             |
  * | length       |                            | count                   | Length of the string or entries of an array or object                                                                                                                                                                                                                                                                                                      |
  * | nop          |                            |                         | Do nothing                                                                                                                                                                                                                                                                                                                                                 |
+ * | nth-key      | index:default              |                         | Can be applied to objects and returns the value of the nth key. All keys of the object are fetched and sorted. (since 1.23.0)                                                                                                                                                                                                                              |
+ * | nth-last-key | index:default              |                         | Can be applied to objects and returns the value of the nth key from behind. All keys of the object are fetched and sorted. (since 1.23.0)                                                                                                                                                                                                                  |
  * | path         | path                       |                         | The access to an object is done via a Pathfinder object                                                                                                                                                                                                                                                                                                    |
+ * | path-exists  | path                       |                         | Check if the specified path is available in the value (since 1.24.0)    |
  * | plaintext    |                            | plain                   | All HTML tags are removed (*)                                                                                                                                                                                                                                                                                                                              |
  * | prefix       | text                       |                         | Adds a prefix                                                                                                                                                                                                                                                                                                                                              |
  * | rawurlencode |                            |                         | URL coding                                                                                                                                                                                                                                                                                                                                                 |
@@ -70,13 +77,13 @@ import {Pathfinder} from "./pathfinder.js";
  * | tointeger    |                            |                         | Type conversion to an integer value                                                                                                                                                                                                                                                                                                                        |
  * | tojson       |                            |                         | Type conversion to a JSON string (since 1.8.0)                                                                                                                                                                                                                                                                                                             |
  * | tolower      |                            | strtolower, tolowercase | The input value is converted to lowercase letters                                                                                                                                                                                                                                                                                                          |
- * | tostring     |                            |                         | Type conversion to a string                                                                                                                                                                                                                                                                                                                                |
+ * | tostring     |                            |                         | Type conversion to a string.                                                                                                                                                                                                                                                                                                                               |
  * | toupper      |                            | strtoupper, touppercase | The input value is converted to uppercase letters                                                                                                                                                                                                                                                                                                          |
  * | trim         |                            |                         | Remove spaces at the beginning and end                                                                                                                                                                                                                                                                                                                     |
  * | ucfirst      |                            |                         | First character large                                                                                                                                                                                                                                                                                                                                      |
  * | ucwords      |                            |                         | Any word beginning large                                                                                                                                                                                                                                                                                                                                   |
  * | undefined    |                            |                         | Return undefined                                                                                                                                                                                                                                                                                                                                           |
- * | uniqid       |                            |                         | Creates a string with a unique value (**)                                                                                                                                                                                                                                                                                                                  |
+ * | uniqid       |                            |                         | Creates a string with a unique value (**)
  *
  *  (*) for this functionality the extension [jsdom](https://www.npmjs.com/package/jsdom) must be loaded in the nodejs context.
  *
@@ -113,7 +120,7 @@ import {Pathfinder} from "./pathfinder.js";
  *
  * @example
  *
- * import {Transformer} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.21.1/dist/modules/data/transformer.js';
+ * import {Transformer} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.25.0/dist/modules/data/transformer.js';
  *
  * const transformer = new Transformer("tolower")
  *
@@ -134,8 +141,6 @@ class Transformer extends Base {
      */
     constructor(definition) {
         super();
-        validateString(definition);
-
         this.args = disassemble(definition);
         this.command = this.args.shift()
         this.callbacks = new Map();
@@ -196,7 +201,7 @@ function disassemble(command) {
     let placeholder = new Map;
     const regex = /((?<pattern>\\(?<char>.)){1})/mig;
 
-    // The separator for args must be quotable
+    // The separator for args must be escaped
     // undefined string which should not occur normally and is also not a regex
     let result = command.matchAll(regex)
 
@@ -256,11 +261,14 @@ function convertToString(value) {
  * @throws {Error} unknown command
  * @throws {TypeError} unsupported type
  * @throws {Error} type not supported
+ * @throws {Error} missing key parameter
  */
 function transform(value) {
 
+    const console = getGlobalObject('console');
+
     let args = clone(this.args);
-    let key
+    let key, defaultValue;
 
     switch (this.command) {
 
@@ -386,9 +394,14 @@ function transform(value) {
 
             throw new TypeError("unsupported type " + typeof value);
 
+        case 'to-base64':
+        case 'btoa':
         case 'base64':
-            convertToString(value);
-            return btoa(value);
+            return btoa(convertToString(value));
+
+        case 'atob':
+        case 'from-base64':
+            return atob(convertToString(value));
 
         case 'empty':
             return '';
@@ -396,6 +409,14 @@ function transform(value) {
         case 'undefined':
             return undefined;
 
+        case 'debug':
+
+            if (isObject(console)) {
+                console.log(value);
+            }
+
+            return value;
+
         case 'prefix':
             validateString(value);
             let prefix = args?.[0];
@@ -409,12 +430,52 @@ function transform(value) {
         case 'uniqid':
             return (new ID()).toString();
 
+        case 'first-key':
+        case 'last-key':
+        case 'nth-last-key':
+        case 'nth-key':
+
+            if (!isObject(value)) {
+                throw new Error("type not supported")
+            }
+
+            const keys = Object.keys(value).sort()
+
+            if (this.command === 'first-key') {
+                key = 0;
+            } else if (this.command === 'last-key') {
+                key = keys.length - 1;
+            } else {
+
+                key = validateInteger(parseInt(args.shift()));
+
+                if (this.command === 'nth-last-key') {
+                    key = keys.length - key - 1;
+                }
+            }
+
+            defaultValue = (args.shift() || '');
+
+            let useKey = keys?.[key];
+
+            if (value?.[useKey]) {
+                return value?.[useKey];
+            }
+
+            return defaultValue;
+
+
         case 'key':
         case 'property':
         case 'index':
 
-            key = (args.shift() || 'undefined');
-            let defaultValue = (args.shift() || '');
+            key = args.shift() || undefined;
+
+            if (key === undefined) {
+                throw new Error("missing key parameter")
+            }
+
+            defaultValue = (args.shift() || undefined);
 
             if (value instanceof Map) {
                 if (!value.has(key)) {
@@ -434,10 +495,29 @@ function transform(value) {
 
             throw new Error("type not supported")
 
+        case 'path-exists':
+
+            key = args.shift();
+            if (key === undefined) {
+                throw new Error("missing key parameter")
+            }
+
+            return new Pathfinder(value).exists(key);
+
         case 'path':
 
-            key = (args.shift() || 'undefined');
-            return new Pathfinder(value).getVia(key);
+            key = args.shift();
+            if (key === undefined) {
+                throw new Error("missing key parameter")
+            }
+
+            let pf = new Pathfinder(value);
+
+            if (!pf.exists(key)) {
+                return undefined;
+            }
+
+            return pf.getVia(key);
 
 
         case 'substring':
@@ -452,11 +532,38 @@ function transform(value) {
         case 'nop':
             return value;
 
+        case  '??':
         case 'default':
-            if (value !== undefined) {
+            if (value !== undefined && value !== null) {
                 return value;
             }
-            return args[0];
+
+            defaultValue = args.shift();
+            let defaultType = args.shift();
+            if (defaultType === undefined) {
+                defaultType = 'string';
+            }
+
+            switch (defaultType) {
+                case 'int':
+                case 'integer':
+                    return parseInt(defaultValue);
+                case 'float':
+                    return parseFloat(defaultValue);
+                case 'undefined':
+                    return undefined
+                case 'bool':
+                case 'boolean':
+                    defaultValue = defaultValue.toLowerCase()
+                    return ((defaultValue !== 'undefined' && defaultValue !== '' && defaultValue !== 'off' && defaultValue !== 'false' && defaultValue !== 'false') || defaultValue === 'on' || defaultValue === 'true' || defaultValue === 'true');
+                case 'string':
+                    return "" + defaultValue;
+                case "object":
+                    return JSON.parse(atob(defaultValue));
+            }
+
+            throw new Error("type not supported")
+
 
         default:
             throw new Error("unknown command " + this.command)

package/source/dom/assembler.js

@@ -23,7 +23,7 @@ const ATTRIBUTEPREFIX = "data-monster-";
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.21.1/dist/modules/dom/assembler.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.25.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.21.1/dist/modules/dom/assembler.js';
+ * import {Assembler} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.25.0/dist/modules/dom/assembler.js';
  * console.log(new Assembler())
  * </script>
  * ```

package/source/dom/attributes.js

@@ -20,7 +20,7 @@ import {ATTRIBUTE_OBJECTLINK} from "./constants.js";
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.21.1/dist/modules/dom/updater.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.25.0/dist/modules/dom/updater.js';
  * console.log(Monster.DOM.findClosestObjectLink())
  * </script>
  * ```
@@ -29,7 +29,7 @@ import {ATTRIBUTE_OBJECTLINK} from "./constants.js";
  *
  * ```
  * <script type="module">
- * import {getUpdaterFromNode} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.21.1/dist/modules/dom/updater.js';
+ * import {getUpdaterFromNode} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.25.0/dist/modules/dom/updater.js';
  * console.log(findClosestObjectLink())
  * </script>
  * ```
@@ -50,7 +50,7 @@ function findClosestObjectLink(element) {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.21.1/dist/modules/dom/attributes.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.25.0/dist/modules/dom/attributes.js';
  * Monster.DOM.addToObjectLink();
  * </script>
  * ```
@@ -59,7 +59,7 @@ function findClosestObjectLink(element) {
  *
  * ```
  * <script type="module">
- * import {addToObjectLink} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.21.1/dist/modules/dom/attributes.js';
+ * import {addToObjectLink} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.25.0/dist/modules/dom/attributes.js';
  * addToObjectLink();
  * </script>
  * ```
@@ -92,7 +92,7 @@ function addToObjectLink(element, symbol, object) {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.21.1/dist/modules/dom/attributes.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.25.0/dist/modules/dom/attributes.js';
  * Monster.DOM.removeObjectLink();
  * </script>
  * ```
@@ -101,7 +101,7 @@ function addToObjectLink(element, symbol, object) {
  *
  * ```
  * <script type="module">
- * import {removeObjectLink} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.21.1/dist/modules/dom/attributes.js';
+ * import {removeObjectLink} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.25.0/dist/modules/dom/attributes.js';
  * removeObjectLink();
  * </script>
  * ```
@@ -134,7 +134,7 @@ function removeObjectLink(element, symbol) {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.21.1/dist/modules/dom/attributes.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.25.0/dist/modules/dom/attributes.js';
  * Monster.DOM.hasObjectLink();
  * </script>
  * ```
@@ -143,7 +143,7 @@ function removeObjectLink(element, symbol) {
  *
  * ```
  * <script type="module">
- * import {hasObjectLink} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.21.1/dist/modules/dom/attributes.js';
+ * import {hasObjectLink} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.25.0/dist/modules/dom/attributes.js';
  * hasObjectLink();
  * </script>
  * ```
@@ -180,7 +180,7 @@ function hasObjectLink(element, symbol) {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.21.1/dist/modules/dom/attributes.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.25.0/dist/modules/dom/attributes.js';
  * Monster.DOM.getLinkedObjects();
  * </script>
  * ```
@@ -189,7 +189,7 @@ function hasObjectLink(element, symbol) {
  *
  * ```
  * <script type="module">
- * import {getLinkedObjects} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.21.1/dist/modules/dom/attributes.js';
+ * import {getLinkedObjects} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.25.0/dist/modules/dom/attributes.js';
  * getLinkedObjects();
  * </script>
  * ```
@@ -225,7 +225,7 @@ function getLinkedObjects(element, symbol) {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.21.1/dist/modules/dom/attributes.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.25.0/dist/modules/dom/attributes.js';
  * Monster.DOM.toggleAttributeToken();
  * </script>
  * ```
@@ -234,7 +234,7 @@ function getLinkedObjects(element, symbol) {
  *
  * ```
  * <script type="module">
- * import {toggleAttributeToken} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.21.1/dist/modules/dom/attributes.js';
+ * import {toggleAttributeToken} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.25.0/dist/modules/dom/attributes.js';
  * toggleAttributeToken();
  * </script>
  * ```
@@ -269,7 +269,7 @@ function toggleAttributeToken(element, key, token) {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.21.1/dist/modules/dom/attributes.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.25.0/dist/modules/dom/attributes.js';
  * Monster.DOM.addAttributeToken();
  * </script>
  * ```
@@ -278,7 +278,7 @@ function toggleAttributeToken(element, key, token) {
  *
  * ```
  * <script type="module">
- * import {addAttributeToken} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.21.1/dist/modules/dom/attributes.js';
+ * import {addAttributeToken} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.25.0/dist/modules/dom/attributes.js';
  * addAttributeToken();
  * </script>
  * ```
@@ -315,7 +315,7 @@ function addAttributeToken(element, key, token) {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.21.1/dist/modules/dom/attributes.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.25.0/dist/modules/dom/attributes.js';
  * Monster.DOM.removeAttributeToken();
  * </script>
  * ```
@@ -324,7 +324,7 @@ function addAttributeToken(element, key, token) {
  *
  * ```
  * <script type="module">
- * import {removeAttributeToken} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.21.1/dist/modules/dom/attributes.js';
+ * import {removeAttributeToken} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.25.0/dist/modules/dom/attributes.js';
  * removeAttributeToken();
  * </script>
  * ```
@@ -360,7 +360,7 @@ function removeAttributeToken(element, key, token) {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.21.1/dist/modules/dom/attributes.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.25.0/dist/modules/dom/attributes.js';
  * Monster.DOM.containsAttributeToken();
  * </script>
  * ```
@@ -369,7 +369,7 @@ function removeAttributeToken(element, key, token) {
  *
  * ```
  * <script type="module">
- * import {containsAttributeToken} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.21.1/dist/modules/dom/attributes.js';
+ * import {containsAttributeToken} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.25.0/dist/modules/dom/attributes.js';
  * containsAttributeToken();
  * </script>
  * ```
@@ -402,7 +402,7 @@ function containsAttributeToken(element, key, token) {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.21.1/dist/modules/dom/attributes.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.25.0/dist/modules/dom/attributes.js';
  * Monster.DOM.replaceAttributeToken();
  * </script>
  * ```
@@ -411,7 +411,7 @@ function containsAttributeToken(element, key, token) {
  *
  * ```
  * <script type="module">
- * import {replaceAttributeToken} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.21.1/dist/modules/dom/attributes.js';
+ * import {replaceAttributeToken} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.25.0/dist/modules/dom/attributes.js';
  * replaceAttributeToken();
  * </script>
  * ```
@@ -447,7 +447,7 @@ function replaceAttributeToken(element, key, from, to) {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.21.1/dist/modules/dom/attributes.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.25.0/dist/modules/dom/attributes.js';
  * Monster.DOM.clearAttributeTokens();
  * </script>
  * ```
@@ -456,7 +456,7 @@ function replaceAttributeToken(element, key, from, to) {
  *
  * ```
  * <script type="module">
- * import {clearAttributeTokens} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.21.1/dist/modules/dom/attributes.js';
+ * import {clearAttributeTokens} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.25.0/dist/modules/dom/attributes.js';
  * clearAttributeTokens();
  * </script>
  * ```
@@ -486,7 +486,7 @@ function clearAttributeTokens(element, key) {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.21.1/dist/modules/dom/attributes.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.25.0/dist/modules/dom/attributes.js';
  * Monster.DOM.findClosestByAttribute();
  * </script>
  * ```
@@ -495,7 +495,7 @@ function clearAttributeTokens(element, key) {
  *
  * ```
  * <script type="module">
- * import {findClosestByAttribute} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.21.1/dist/modules/dom/attributes.js';
+ * import {findClosestByAttribute} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.25.0/dist/modules/dom/attributes.js';
  * findClosestByAttribute();
  * </script>
  * ```