@schukai/monster 1.26.1 → 1.29.0

package/source/types/version.js

@@ -10,7 +10,7 @@ import {Base} from './base.js';
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.26.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.0/dist/monster.js';
  * console.log(new Monster.Types.Version('1.2.3')) // ↦ 1.2.3
  * console.log(new Monster.Types.Version('1')) // ↦ 1.0.0
  * </script>
@@ -20,7 +20,7 @@ import {Base} from './base.js';
  *
  * ```
  * <script type="module">
- * import {Version} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.26.1/dist/modules/types/version.js';
+ * import {Version} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.0/dist/modules/types/version.js';
  * console.log(new Version('1.2.3')) // ↦ 1.2.3
  * console.log(new Version('1')) // ↦ 1.0.0
  * </script>
@@ -28,7 +28,7 @@ import {Base} from './base.js';
  *
  * @example
  *
- * import {Version} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.26.1/dist/modules/types/version.js';
+ * import {Version} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.0/dist/modules/types/version.js';
  *
  * new Version('1.0.0') // ↦ 1.0.0
  * new Version(1)  // ↦ 1.0.0
@@ -151,7 +151,7 @@ let monsterVersion;
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.26.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.0/dist/monster.js';
  * console.log(Monster.getVersion())
  * </script>
  * ```
@@ -160,7 +160,7 @@ let monsterVersion;
  *
  * ```
  * <script type="module">
- * import {getVersion} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.26.1/dist/modules/types/version.js';
+ * import {getVersion} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.0/dist/modules/types/version.js';
  * console.log(getVersion())
  * </script>
  * ```
@@ -176,7 +176,7 @@ function getVersion() {
         return monsterVersion;
     }
     /**#@+ dont touch, replaced by make with package.json version */
-    monsterVersion = new Version('1.26.1')
+    monsterVersion = new Version('1.29.0')
     /**#@-*/
 
     return monsterVersion;

package/source/util/clone.js

@@ -24,7 +24,7 @@ import {validateObject} from "../types/validate.js";
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.26.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.0/dist/monster.js';
  * Monster.Util.clone({})
  * </script>
  * ```
@@ -33,7 +33,7 @@ import {validateObject} from "../types/validate.js";
  *
  * ```
  * <script type="module">
- * import {clone} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.26.1/dist/modules/util/clone.js';
+ * import {clone} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.0/dist/modules/util/clone.js';
  * clone({})
  * </script>
  * ```

package/source/util/comparator.js

@@ -12,7 +12,7 @@ import {isFunction} from '../types/is.js';
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.26.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.0/dist/monster.js';
  * new Monster.Util.Comparator()
  * </script>
  * ```
@@ -21,7 +21,7 @@ import {isFunction} from '../types/is.js';
  *
  * ```
  * <script type="module">
- * import {Comparator} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.26.1/dist/modules/util/comparator.js';
+ * import {Comparator} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.0/dist/modules/util/comparator.js';
  * console.log(new Comparator())
  * </script>
  * ```
@@ -46,7 +46,7 @@ import {isFunction} from '../types/is.js';
  *
  * @example
  *
- * import {Comparator} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.26.1/dist/modules/util/comparator.js';
+ * import {Comparator} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.0/dist/modules/util/comparator.js';
  *
  * console.log(new Comparator().lessThanOrEqual(2, 5))
  * // ↦ true

package/source/util/deadmansswitch.js

@@ -0,0 +1,124 @@
+'use strict';
+
+/**
+ * @author schukai GmbH
+ */
+
+
+import {internalSymbol} from "../constants.js";
+import {assignToNamespace, Monster} from '../namespace.js';
+import {Base} from "../types/base.js";
+import {isInteger} from "../types/is.js";
+import {validateFunction, validateInteger} from "../types/validate.js";
+
+/**
+ * The dead man's switch allows to set a timer which can be reset again and again within a defined period of time.
+ *
+ * You can create an instance via the monster namespace `Monster.Util.DeadMansSwitch()`.
+ *
+ * ```
+ * <script type="module">
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.0/dist/monster.js';
+ * new Monster.Util.DeadMansSwitch()
+ * </script>
+ * ```
+ *
+ * Alternatively, you can also integrate this class individually.
+ *
+ * ```
+ * <script type="module">
+ * import {DeadMansSwitch} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.0/dist/modules/util/deadmansswitch.js';
+ * new DeadMansSwitch();
+ * </script>
+ * ```
+ *
+ * @example
+ * import {DeadMansSwitch} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.0/dist/modules/util/deadmansswitch.js';
+ *
+ * const deadmansswitch = new DeadMansSwitch(100, ()=>{
+ *   console.log('yeah!')
+ *   // ↦ "yeah!"
+ * })
+ *
+ * deadmansswitch.touch(); // from here wait again 100 ms
+ * deadmansswitch.touch(200); // from here wait 200 ms
+ *
+ * @copyright schukai GmbH
+ * @since 1.29.0
+ * @memberOf Monster.Util
+ * @summary Class to be able to execute function chains
+ */
+class DeadMansSwitch extends Base {
+
+    /**
+     * Create new dead man's switch
+     *
+     * @param {Integer} delay
+     * @param {function} callback
+     * @throw {TypeError} the arguments must be either integer or functions
+     * @throws {TypeError} value is not an integer
+     */
+    constructor(delay, callback) {
+        super();
+
+        init.call(this, validateInteger(delay), validateFunction(callback));
+    }
+
+    /**
+     *
+     * @param {Integer|undefined} [delay]
+     */
+    touch(delay) {
+
+        if (this[internalSymbol]['isAlreadyRun'] === true) {
+            throw new Error('has already run')
+        }
+
+        if (isInteger(delay)) {
+            this[internalSymbol]['delay'] = delay
+        } else if (delay !== undefined) {
+            throw new Error('unsupported argument')
+        }
+
+        clearTimeout(this[internalSymbol]['timer']);
+
+        initCallback.call(this);
+
+        return this;
+    }
+}
+
+/**
+ * @private
+ */
+function initCallback() {
+
+    const self = this;
+
+    self[internalSymbol]['timer'] = setTimeout(() => {
+        self[internalSymbol]['isAlreadyRun'] = true;
+        self[internalSymbol]['callback']();
+    }, self[internalSymbol]['delay'])
+}
+
+/**
+ * @private
+ * @param {integer} delay
+ * @param {function} callback
+ */
+function init(delay, callback) {
+    const self = this;
+
+    self[internalSymbol] = {
+        callback,
+        delay,
+        isAlreadyRun: false,
+        timer: undefined
+    };
+
+    initCallback.call(self);
+
+}
+
+assignToNamespace('Monster.Util', DeadMansSwitch);
+export {Monster, DeadMansSwitch}

package/source/util/freeze.js

@@ -14,7 +14,7 @@ import {validateObject} from '../types/validate.js';
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.26.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.0/dist/monster.js';
  * Monster.Util.deepFreeze({})
  * </script>
  * ```
@@ -23,7 +23,7 @@ import {validateObject} from '../types/validate.js';
  *
  * ```
  * <script type="module">
- * import {deepFreeze} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.26.1/dist/modules/util/freeze.js';
+ * import {deepFreeze} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.0/dist/modules/util/freeze.js';
  * deepFreeze({})
  * </script>
  * ```

package/source/util/processing.js

@@ -77,7 +77,7 @@ class Callback {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.26.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.0/dist/monster.js';
  * new Monster.Util.Processing()
  * </script>
  * ```
@@ -86,13 +86,13 @@ class Callback {
  *
  * ```
  * <script type="module">
- * import {Processing} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.26.1/dist/modules/util/processing.js';
+ * import {Processing} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.0/dist/modules/util/processing.js';
  * new Processing();
  * </script>
  * ```
  *
  * @example
- * import {Processing} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.26.1/dist/modules/util/processing.js';
+ * import {Processing} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.0/dist/modules/util/processing.js';
  *
  * let startTime = +new Date();
  *

package/source/util/trimspaces.js

@@ -16,7 +16,7 @@ import {validateString} from "../types/validate.js";
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.26.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.0/dist/monster.js';
  * Monster.Util.trimSpaces(" hello ")
  * </script>
  * ```
@@ -25,7 +25,7 @@ import {validateString} from "../types/validate.js";
  *
  * ```
  * <script type="module">
- * import {trimSpaces} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.26.1/dist/modules/util/trimspaces.js';
+ * import {trimSpaces} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.0/dist/modules/util/trimspaces.js';
  * trimSpaces(' hello \\ ')
  * </script>
  * ```

package/test/cases/data/buildtree.js

@@ -3,7 +3,6 @@
 import {expect} from "chai"
 import {buildTree} from "../../../source/data/buildtree.js";
 import {NodeList} from "../../../source/types/nodelist.js";
-import {NodeRecursiveIterator} from "../../../source/types/noderecursiveiterator.js";
 
 
 describe('buildTree', function () {
@@ -50,18 +49,9 @@ describe('buildTree', function () {
 
             const nodes = buildTree(objects, 'dataset.*', 'id', 'parent');
 
-            let result = ""
-            nodes.forEach(node => {
-                new NodeRecursiveIterator(node).forEach(n => {
-                    result +="".padStart(n.level * 2, '.') + (n.value.name);
-                });
-
-            });
-
-            expect(result).to.be.equal('vehicle..car....SUV....sports car..truck..motorcycle');
             expect(nodes).to.be.instanceOf(NodeList);
             expect(nodes.length).to.equal(1);
-            expect(nodes.length).to.equal(1);
+            expect(nodes.toString()).to.be.equal('{"id":"1","name":"vehicle","parent":null}\n ├{"id":"2","name":"car","parent":"1"}\n | ├{"id":"5","name":"SUV","parent":"2"}\n | └{"id":"6","name":"sports car","parent":"2"}\n ├{"id":"3","name":"truck","parent":"1"}\n └{"id":"4","name":"motorcycle","parent":"1"}' );
 
 
         })
@@ -116,9 +106,9 @@ describe('buildTree', function () {
         });
 
         [
-            [obj1, 'dataset.*', '1,2,3,4,6,5'],
+            [obj1, 'dataset.*', '{"id":"1","name":"Test 1","address":"Here 1","parent":null}\n ├{"id":"2","name":"Test 2","address":"Here 2","parent":"1"}\n | ├{"id":"3","name":"Test 3","address":"Here 3","parent":"2"}\n | └{"id":"4","name":"Test 4","address":"Here 4","parent":"2"}\n | | └{"id":"6","name":"Test 6","address":"Here 6","parent":"4"}\n └{"id":"5","name":"Test 5","address":"Here 5","parent":"1"}'],
             [obj1, 'x', ''],
-            [obj1, 'dataset.*', '1,2,3,4,6,5'],
+            [obj1, 'dataset.*', '{"id":"1","name":"Test 1","address":"Here 1","parent":null}\n ├{"id":"2","name":"Test 2","address":"Here 2","parent":"1"}\n | ├{"id":"3","name":"Test 3","address":"Here 3","parent":"2"}\n | └{"id":"4","name":"Test 4","address":"Here 4","parent":"2"}\n | | └{"id":"6","name":"Test 6","address":"Here 6","parent":"4"}\n └{"id":"5","name":"Test 5","address":"Here 5","parent":"1"}'],
         ].forEach(function (data) {
 
             let a = data.shift()
@@ -127,18 +117,91 @@ describe('buildTree', function () {
 
             it('buildTree(' + JSON.stringify(a) + ',' + JSON.stringify(b) + ') should return ' + JSON.stringify(c) + ' ', function () {
                 let nodelist = buildTree(a, b, 'id', 'parent');
+                expect(nodelist.toString()).to.be.eql(c);
+            });
+        });
 
-                let result = [];
 
-                const firstNode = nodelist.toArray().shift();
-                
-                if (firstNode) {
-                    for (const node of new NodeRecursiveIterator(firstNode)) {
-                        result.push(node.value.id);
-                    }
+    });
+
+    describe('buildTree() test 2', function () {
+
+        /**
+         * 2
+         *    1
+         *    3
+         * 4
+         *    6
+         * 5
+         *
+         */
+        let obj1 = {
+            dataset: {
+                "1": {
+                    id: "1",
+                    name: "Test 1",
+                    address: "Here 1",
+                    parent: "2"
+                },
+                "2": {
+                    id: "2",
+                    name: "Test 2",
+                    address: "Here 2",
+                    parent: "0"
+                },
+                "3": {
+                    id: "3",
+                    name: "Test 3",
+                    address: "Here 3",
+                    parent: "2"
+                },
+                "4": {
+                    id: "4",
+                    name: "Test 4",
+                    address: "Here 4",
+                    parent: "0"
+                },
+                "5": {
+                    id: "5",
+                    name: "Test 5",
+                    address: "Here 5",
+                    parent: "0"
+                },
+                "6": {
+                    id: "6",
+                    name: "Test 6",
+                    address: "Here 6",
+                    parent: "4"
+                },
+                "7": {
+                    id: "7",
+                    name: "Test 7",
+                    address: "Here 7",
+                    parent: "1"
                 }
+            }
+        };
+
+        it('should return Node Instance.', function () {
+            expect(buildTree({}, '')).to.be.instanceOf(NodeList);
+        });
+
+        [
+            [obj1, 'dataset.*', '{"id":"2","name":"Test 2","address":"Here 2","parent":"0"}\n ├{"id":"1","name":"Test 1","address":"Here 1","parent":"2"}\n | └{"id":"7","name":"Test 7","address":"Here 7","parent":"1"}\n └{"id":"3","name":"Test 3","address":"Here 3","parent":"2"}\n{"id":"4","name":"Test 4","address":"Here 4","parent":"0"}\n └{"id":"6","name":"Test 6","address":"Here 6","parent":"4"}\n{"id":"5","name":"Test 5","address":"Here 5","parent":"0"}'],
+            [obj1, 'x', ''],
+        ].forEach(function (data) {
+
+            let a = data.shift()
+            let b = data.shift()
+            let c = data.shift()
+
+            it('buildTree(' + JSON.stringify(a) + ',' + JSON.stringify(b) + ') should return ' + JSON.stringify(c) + ' ', function () {
+                let nodelist = buildTree(a, b, 'id', 'parent', {
+                    rootReferences: ['0']
+                });
+
+                expect(nodelist.toString()).to.be.equal(c);
 
-                expect(result.join(',')).to.be.equal(c);
             });
         });
 

package/test/cases/dom/attributes.js

@@ -14,7 +14,8 @@ import {
     removeAttributeToken,
     removeObjectLink,
     replaceAttributeToken,
-    toggleAttributeToken
+    toggleAttributeToken,
+    findClosestByClass
 } from "../../../source/dom/attributes.js";
 
 import {initJSDOM} from "../../util/jsdom.js";
@@ -37,12 +38,13 @@ describe('Attributes', function () {
     </div>
 </div>
 `;
+        
         html3 = `<div data-monster-role="test1">
-    <div data-monster-role="sub1" id="a1">
-        <div data-monster-role="sub2" id="a2">
-            <div data-monster-role="sub3" id="a3">
-                <div data-monster-role="sub4" id="a4">
-                    <div data-monster-role="sub5" id="a5"></div>
+    <div data-monster-role="sub1" id="a1" class="sub1">
+        <div data-monster-role="sub2" id="a2" class="sub2">
+            <div data-monster-role="sub3" id="a3" class="sub3">
+                <div data-monster-role="sub4" id="a4" class="sub4">
+                    <div data-monster-role="sub5" id="a5" class="sub5"></div>
                 </div>
             </div>
         </div>
@@ -154,6 +156,27 @@ describe('Attributes', function () {
                 })
 
 
+            });
+        }); 
+        
+        describe('find closest Element with class', function () {
+
+            [
+                ['a5',  'sub3', 'sub3'],
+                ['a5',  'sub1', 'sub1'],
+                ['a4',  'sub1', 'sub1'],
+                ['a3',  'sub1', 'sub1'],
+                ['a5',  'sub5', 'sub5']
+            ].forEach(function (data) {
+
+                let a = data.shift()
+                let b = data.shift()
+                let c = data.shift()
+                it('findClosestByClass(' + a + ', ' + b + ') should return ' + c, function () {
+                    expect(findClosestByClass(document.getElementById(a), b).getAttribute('class')).to.be.equal(c);
+                })
+
+
             });
         });
     });

package/test/cases/dom/events.js

@@ -2,7 +2,7 @@
 
 import {expect} from "chai"
 
-import {fireEvent, findTargetElementFromEvent} from "../../../source/dom/events.js";
+import {fireEvent, findTargetElementFromEvent, fireCustomEvent} from "../../../source/dom/events.js";
 import {initJSDOM} from "../../util/jsdom.js";
 
 describe('Events', function () {
@@ -78,6 +78,71 @@ describe('Events', function () {
             expect(() => fireEvent({}, 'touch')).to.throw(Error);
             
         });
+    });   
+    
+    describe('fireCustomEvent()', function () {
+        it('should fire a click event', function (done) {
+            let div = document.createElement('div');
+            div.addEventListener('click', () => {
+                done();
+            })
+            fireCustomEvent(div, 'click');
+        });
+
+        it('should fire a touch event', function (done) {
+            let div = document.createElement('div');
+            div.addEventListener('touch', () => {
+                done();
+            })
+            fireCustomEvent(div, 'touch');
+        });
+
+        it('should fire a touch event on collection1', function (done) {
+            let div = document.createElement('div');
+            div.addEventListener('touch', (e) => {
+                if(e.detail.detail!=='hello world') {
+                    done('error');    
+                }
+                done();
+            })
+
+            div.appendChild(document.createElement('div'));
+            let collection = div.querySelectorAll('div');
+
+            fireCustomEvent(collection, 'touch', "hello world");
+        });
+        
+        it('should fire a touch event on collection2', function (done) {
+            let div = document.createElement('div');
+            div.addEventListener('touch', (e) => {
+                if(e.detail.a!=='hello world') {
+                    done('error');    
+                }
+                done();
+            })
+
+            div.appendChild(document.createElement('div'));
+            let collection = div.querySelectorAll('div');
+
+            fireCustomEvent(collection, 'touch', {a:"hello world"});
+        });
+
+        it('should fire a touch event', function (done) {
+            let div = document.createElement('div');
+            div.addEventListener('touch', () => {
+                done();
+            })
+
+            div.appendChild(document.createElement('div'));
+            let collection = div.querySelectorAll('div');
+
+
+            fireCustomEvent(collection, 'touch');
+        });
+
+        it('should throw error', function () {
+            expect(() => fireCustomEvent({}, 'touch')).to.throw(Error);
+        });
     });