@schukai/monster 1.27.0 → 1.28.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@schukai/monster",
-  "version": "1.27.0",
+  "version": "1.28.0",
   "types": "./source/types/package.d.ts",
   "description": "Monster is a simple library for creating fast, robust and lightweight websites.",
   "keywords": [

package/source/constraints/andoperator.js

@@ -16,7 +16,7 @@ import {AbstractOperator} from "./abstractoperator.js";
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/monster.js';
  * new Monster.Constraint.AndOperator();
  * </script>
  * ```
@@ -25,16 +25,16 @@ import {AbstractOperator} from "./abstractoperator.js";
  *
  * ```
  * <script type="module">
- * import {AndOperator} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/modules/constraints/andoperator.js';
+ * import {AndOperator} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/modules/constraints/andoperator.js';
  * new AndOperator();
  * </script>
  * ```
  *
  * @example
  *
- * import {Valid} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/modules/constraints/valid.js';
- * import {Invalid} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/modules/constraints/invalid.js';
- * import {AndOperator} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/modules/constraints/andoperator.js';
+ * import {Valid} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/modules/constraints/valid.js';
+ * import {Invalid} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/modules/constraints/invalid.js';
+ * import {AndOperator} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/modules/constraints/andoperator.js';
  *
  * new AndOperator(
  * new Valid(), new Valid()).isValid()

package/source/constraints/invalid.js

@@ -17,7 +17,7 @@ import {AbstractConstraint} from "./abstract.js";
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/monster.js';
  * new Monster.Constraint.Invalid();
  * </script>
  * ```
@@ -26,14 +26,14 @@ import {AbstractConstraint} from "./abstract.js";
  *
  * ```
  * <script type="module">
- * import {Invalid} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/modules/constraints/invalid.js';
+ * import {Invalid} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/modules/constraints/invalid.js';
  * new Invalid();
  * </script>
  * ```
  *
  * @example
  *
- * import {Invalid} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/modules/constraints/invalid.js';
+ * import {Invalid} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/modules/constraints/invalid.js';
  *
  * new Invalid().isValid()
  * .then(()=>console.log(true))

package/source/constraints/isarray.js

@@ -16,7 +16,7 @@ import {AbstractConstraint} from "./abstract.js";
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/monster.js';
  * new Monster.Constraint.IsArray()
  * </script>
  * ```
@@ -25,14 +25,14 @@ import {AbstractConstraint} from "./abstract.js";
  *
  * ```
  * <script type="module">
- * import {IsArray} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/modules/constraints/isarray.js';
+ * import {IsArray} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/modules/constraints/isarray.js';
  * console.log(new IsArray())
  * </script>
  * ```
  *
  * @example
  *
- * import {IsArray} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/modules/constraints/isarray.js';
+ * import {IsArray} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/modules/constraints/isarray.js';
  *
  * new IsArray()
  * .isValid([])

package/source/constraints/isobject.js

@@ -16,7 +16,7 @@ import {AbstractConstraint} from "./abstract.js";
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/monster.js';
  * console.log(new Monster.Constraint.IsObject())
  * </script>
  * ```
@@ -25,14 +25,14 @@ import {AbstractConstraint} from "./abstract.js";
  *
  * ```
  * <script type="module">
- * import {IsObject} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/modules/constraints/isobject.js';
+ * import {IsObject} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/modules/constraints/isobject.js';
  * console.log(new IsObject())
  * </script>
  * ```
  *
  * @example
  *
- * import {IsObject} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/modules/constraints/isobject.js';
+ * import {IsObject} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/modules/constraints/isobject.js';
  *
  * new IsObject()
  * .isValid({})

package/source/constraints/oroperator.js

@@ -15,7 +15,7 @@ import {AbstractOperator} from "./abstractoperator.js";
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/monster.js';
  * new Monster.Constraint.OrOperator();
  * </script>
  * ```
@@ -24,16 +24,16 @@ import {AbstractOperator} from "./abstractoperator.js";
  *
  * ```
  * <script type="module">
- * import {OrOperator} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/modules/constraint/oroperator.js';
+ * import {OrOperator} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/modules/constraint/oroperator.js';
  * new OrOperator();
  * </script>
  * ```
  *
  * @example
  *
- * import {Valid} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/modules/constraints/valid.js';
- * import {Invalid} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/modules/constraints/invalid.js';
- * import {OrOperator} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/modules/constraints/oroperator.js';
+ * import {Valid} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/modules/constraints/valid.js';
+ * import {Invalid} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/modules/constraints/invalid.js';
+ * import {OrOperator} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/modules/constraints/oroperator.js';
  *
  * new OrOperator(
  * new Valid(), new Invalid()).isValid()

package/source/constraints/valid.js

@@ -17,7 +17,7 @@ import {AbstractConstraint} from "./abstract.js";
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/monster.js';
  * new Monster.Constraint.Valid();
  * </script>
  * ```
@@ -26,14 +26,14 @@ import {AbstractConstraint} from "./abstract.js";
  *
  * ```
  * <script type="module">
- * import {Valid} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/modules/constraints/valid.js';
+ * import {Valid} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/modules/constraints/valid.js';
  * new Valid();
  * </script>
  * ```
  *
  * @example
  *
- * import {Valid} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/modules/constraints/valid.js';
+ * import {Valid} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/modules/constraints/valid.js';
  *
  * new Valid().isValid()
  * .then(()=>console.log(true))

package/source/data/buildmap.js

@@ -20,7 +20,7 @@ import {DELIMITER, Pathfinder, WILDCARD} from "./pathfinder.js";
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/monster.js';
  * console.log(Monster.Data.buildMap())
  * </script>
  * ```
@@ -29,7 +29,7 @@ import {DELIMITER, Pathfinder, WILDCARD} from "./pathfinder.js";
  *
  * ```
  * <script type="module">
- * import {buildMap} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/modules/data/buildmap.js';
+ * import {buildMap} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/modules/data/buildmap.js';
  * console.log(buildMap())
  * </script>
  * ```
@@ -40,7 +40,7 @@ import {DELIMITER, Pathfinder, WILDCARD} from "./pathfinder.js";
  *
  * @example
  *
- * import {buildMap} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/modules/data/buildmap.js';
+ * import {buildMap} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/modules/data/buildmap.js';
  * // a typical data structure as reported by an api
  *
  * let map;
@@ -133,7 +133,7 @@ function buildMap(subject, selector, valueTemplate, keyTemplate, filter) {
  * @param {string|Monster.Data~exampleSelectorCallback} selector
  * @param {Monster.Data~exampleFilterCallback} [filter]
  * @param {function} callback
- * @return {*}
+ * @return {Map}
  */
 function assembleParts(subject, selector, filter, callback) {
 
@@ -156,7 +156,6 @@ function assembleParts(subject, selector, filter, callback) {
         return result;
     }
 
-
     map.forEach((v, k, m) => {
         if (isFunction(filter)) {
             if (filter.call(m, v, k) !== true) return;
@@ -164,7 +163,6 @@ function assembleParts(subject, selector, filter, callback) {
 
         callback.call(result, v, k, m);
 
-
     });
 
     return result;
@@ -197,7 +195,8 @@ function buildFlatMap(subject, selector, key, parentMap) {
         if (current === WILDCARD) {
 
             let finder = new Pathfinder(subject);
-            let map
+            let map;
+
             try {
                 map = finder.getVia(currentPath.join(DELIMITER));
             } catch (e) {
@@ -205,7 +204,6 @@ function buildFlatMap(subject, selector, key, parentMap) {
                 map = new Map();
             }
 
-
             for (const [k, o] of map) {
 
                 let copyKey = clone(key);
@@ -217,7 +215,7 @@ function buildFlatMap(subject, selector, key, parentMap) {
                 let kk = copyKey.join(DELIMITER);
                 let sub = buildFlatMap.call(result, o, parts.join(DELIMITER), copyKey, o);
 
-                if (isObject(sub)) {
+                if (isObject(sub) && parentMap !== undefined) {
                     sub['^'] = parentMap;
                 }
 
@@ -255,7 +253,7 @@ function buildFlatMap(subject, selector, key, parentMap) {
  * Alternatively to a string selector a callback can be specified. this must return a map.
  *
  * @example
- * import {buildMap} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/modules/data/buildmap.js';
+ * import {buildMap} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/modules/data/buildmap.js';
  *
  * let obj = {
  *                "data": [

package/source/data/buildtree.js

@@ -5,9 +5,11 @@
  */
 
 import {assignToNamespace, Monster} from '../namespace.js';
+import {isArray, isObject} from "../types/is.js";
 import {Node} from "../types/node.js";
 import {NodeList} from "../types/nodelist.js";
 import {assembleParts} from "./buildmap.js";
+import {extend} from "./extend.js";
 
 
 /**
@@ -22,6 +24,13 @@ const parentSymbol = Symbol('parent');
  */
 const rootSymbol = Symbol('root');
 
+/**
+ * @typedef {Object} buildTreeOptions
+ * @property {array} options.rootReferences=[null, undefined] defines the values for elements without parents
+ * @property {Monster.Data~exampleFilterCallback} options.filter filtering of the values
+ * @memberOf Monster.Data
+ */
+
 /**
  * With the help of the function `buildTree()`, nodes can be easily created from data objects.
  *
@@ -29,8 +38,8 @@ const rootSymbol = Symbol('root');
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/buildtree.js';
- * console.log(Monster.Data.buildTree())
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/buildtree.js';
+ * Monster.Data.buildTree()
  * </script>
  * ```
  *
@@ -38,38 +47,54 @@ const rootSymbol = Symbol('root');
  *
  * ```
  * <script type="module">
- * import {buildTree} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/modules/data/buildtree.js';
- * console.log(buildTree())
+ * import {buildTree} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/modules/data/buildtree.js';
+ * buildTree()
  * </script>
  * ```
  *
  * @param {*} subject
  * @param {string|Monster.Data~exampleSelectorCallback} selector
- * @param {string} id
- * @param {string} parentID
- * @param {Monster.Data~exampleFilterCallback} [filter]
+ * @param {string} idKey
+ * @param {string} parentIDKey
+ * @param {buildTreeOptions} [options]
  * @return {*}
  * @memberOf Monster.Data
  * @throws {TypeError} value is neither a string nor a function
  * @throws {TypeError} the selector callback must return a map
  * @throws {Error} the object has no value for the specified id
+ * @since 1.26.0
  */
-function buildTree(subject, selector, id, parentID, filter) {
+function buildTree(subject, selector, idKey, parentIDKey, options) {
 
     const nodes = new Map;
 
+    if (!isObject(options)) {
+        options = {}
+    }
+
+    options = extend({}, {
+        rootReferences: [null, undefined],
+        filter: undefined
+    }, options)
+
+    const filter = options?.filter;
+    let rootReferences = options.rootReferences;
+    if (!isArray(rootReferences)) {
+        rootReferences = [rootReferences];
+    }
+
     const childMap = assembleParts(subject, selector, filter, function (o, k, m) {
 
-        const key = o?.[id]
-        let ref = o?.[parentID]
-        if (ref === null|| ref===undefined) ref = rootSymbol;
+        const key = o?.[idKey]
+        let ref = o?.[parentIDKey]
+        if (rootReferences.indexOf(ref) !== -1) ref = rootSymbol;
 
         if (key === undefined) {
             throw new Error('the object has no value for the specified id')
         }
 
         o[parentSymbol] = ref;
-        
+
         const node = new Node(o);
         this.has(ref) ? this.get(ref).add(node) : this.set(ref, new NodeList().add(node));
         nodes.set(key, node);
@@ -77,17 +102,26 @@ function buildTree(subject, selector, id, parentID, filter) {
     })
 
     nodes.forEach(node => {
+        
+        let id = node?.['value']?.[idKey];
 
-        if (childMap.has(node.value.id)) {
-            node.childNodes = childMap.get(node.value.id);
+        if (childMap.has(id)) {
+            node.childNodes = childMap.get(id);
+            childMap.delete(id)
         }
     })
 
-    const r = childMap.get(rootSymbol);
-    
-    return new NodeList(childMap.get(rootSymbol));
+    const list = new NodeList;
 
+    childMap.forEach((s) => {
+        if (s instanceof Set) {
+            s.forEach((n) => {
+                list.add(n);
+            })
+        }
+    })
 
+    return list;
 }
 
 

package/source/data/datasource/restapi.js

@@ -17,7 +17,7 @@ import {WriteError} from "./restapi/writeerror.js";
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/monster.js';
  * Monster.Data.Datasource.RestAPI()
  * </script>
  * ```
@@ -26,14 +26,14 @@ import {WriteError} from "./restapi/writeerror.js";
  *
  * ```
  * <script type="module">
- * import {RestAPI} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/modules/data/datasource/restapi.js';
+ * import {RestAPI} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/modules/data/datasource/restapi.js';
  * new RestAPI()
  * </script>
  * ```
  *
  * @example
  *
- * import {RestAPI} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/modules/data/datasource/restapi.js';
+ * import {RestAPI} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/modules/data/datasource/restapi.js';
  *
  * const ds = new RestAPI({
  *   url: 'https://httpbin.org/get'

package/source/data/datasource/storage/localstorage.js

@@ -18,7 +18,7 @@ import {Storage, storageObjectSymbol} from "../storage.js";
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/monster.js';
  * Monster.Data.Datasource.Storage.LocalStorage()
  * </script>
  * ```
@@ -27,7 +27,7 @@ import {Storage, storageObjectSymbol} from "../storage.js";
  *
  * ```
  * <script type="module">
- * import {LocalStorage} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/modules/data/datasource/storage/localstorage.js';
+ * import {LocalStorage} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/modules/data/datasource/storage/localstorage.js';
  * new LocalStorage()
  * </script>
  * ```

package/source/data/datasource/storage/sessionstorage.js

@@ -15,7 +15,7 @@ import {Storage, storageObjectSymbol} from "../storage.js";
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/monster.js';
  * Monster.Data.Datasource.Storage.SessionStorage()
  * </script>
  * ```
@@ -24,7 +24,7 @@ import {Storage, storageObjectSymbol} from "../storage.js";
  *
  * ```
  * <script type="module">
- * import {SessionStorage} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/modules/data/datasource/storage/sessionstorage.js';
+ * import {SessionStorage} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/modules/data/datasource/storage/sessionstorage.js';
  * new SessionStorage()
  * </script>
  * ```

package/source/data/datasource/storage.js

@@ -20,7 +20,7 @@ const storageObjectSymbol = Symbol('storageObject');
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/monster.js';
  * Monster.Data.Datasource.Storage()
  * </script>
  * ```
@@ -29,14 +29,14 @@ const storageObjectSymbol = Symbol('storageObject');
  *
  * ```
  * <script type="module">
- * import {Storage} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/modules/data/datasource/storage.js';
+ * import {Storage} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/modules/data/datasource/storage.js';
  * new Storage()
  * </script>
  * ```
  *
  * @example
  *
- * import {Storage} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/modules/data/datasource/storage.js';
+ * import {Storage} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/modules/data/datasource/storage.js';
  *
  * new Datasource();
  *

package/source/data/datasource.js

@@ -31,7 +31,7 @@ const internalDataSymbol = Symbol('internalData');
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/monster.js';
  * Monster.Data.Datasource()
  * </script>
  * ```
@@ -40,14 +40,14 @@ const internalDataSymbol = Symbol('internalData');
  *
  * ```
  * <script type="module">
- * import {Datasource} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/modules/data/datasource.js';
+ * import {Datasource} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/modules/data/datasource.js';
  * new Datasource()
  * </script>
  * ```
  *
  * @example
  *
- * import {Datasource} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/modules/data/datasource.js'
+ * import {Datasource} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/modules/data/datasource.js'
  *
  * class MyDatasource extends Datasource {
  *  

package/source/data/diff.js

@@ -17,7 +17,7 @@ import {typeOf} from "../types/typeof.js";
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/monster.js';
  * Monster.Data.Diff(a, b)
  * </script>
  * ```
@@ -26,14 +26,14 @@ import {typeOf} from "../types/typeof.js";
  *
  * ```
  * <script type="module">
- * import {Diff} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/modules/data/diff.js';
+ * import {Diff} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/modules/data/diff.js';
  * Diff(a, b)
  * </script>
  * ```
  *
  * @example
  *
- * import {Diff} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/modules/data/diff.js';
+ * import {Diff} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/modules/data/diff.js';
  *
  * // given are two objects x and y.
  *

package/source/data/extend.js

@@ -15,7 +15,7 @@ import {typeOf} from "../types/typeof.js";
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/monster.js';
  * Monster.Data.extend(a, b)
  * </script>
  * ```
@@ -24,7 +24,7 @@ import {typeOf} from "../types/typeof.js";
  *
  * ```
  * <script type="module">
- * import {extend} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/modules/data/extend.js';
+ * import {extend} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/modules/data/extend.js';
  * extend(a, b)
  * </script>
  * ```

package/source/data/pathfinder.js

@@ -27,7 +27,7 @@ export const WILDCARD = '*';
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/monster.js';
  * console.log(new Monster.Data.Pathfinder())
  * </script>
  * ```
@@ -36,7 +36,7 @@ export const WILDCARD = '*';
  *
  * ```
  * <script type="module">
- * import {Pathfinder} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/modules/data/pathfinder.js';
+ * import {Pathfinder} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/modules/data/pathfinder.js';
  * console.log(new Pathfinder())
  * </script>
  * ```
@@ -78,7 +78,7 @@ export const WILDCARD = '*';
  *
  * @example
  *
- * import {Pathfinder} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/modules/data/pathfinder.js';
+ * import {Pathfinder} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/modules/data/pathfinder.js';
  *
  * let value = new Pathfinder({
  * a: {
@@ -104,7 +104,7 @@ export const WILDCARD = '*';
  *
  * @example
  *
- * import {Pathfinder} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/modules/data/pathfinder.js';
+ * import {Pathfinder} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/modules/data/pathfinder.js';
  *
  * let p = new Pathfinder({
  *                a: {

package/source/data/pipe.js

@@ -19,7 +19,7 @@ const DELIMITER = '|';
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/monster.js';
  * 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.27.0/dist/modules/data/pipe.js';
+ * import {Pipe} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/modules/data/pipe.js';
  * 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.27.0/dist/modules/data/pipe.js';
+ * import {Pipe} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/modules/data/pipe.js';
  *
  * let obj = {
  *    a: {

package/source/data/transformer.js

@@ -25,7 +25,7 @@ import {Pathfinder} from "./pathfinder.js";
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/monster.js';
  * new Monster.Data.Transformer()
  * </script>
  * ```
@@ -34,7 +34,7 @@ import {Pathfinder} from "./pathfinder.js";
  *
  * ```
  * <script type="module">
- * import {Transformer} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/modules/data/transformer.js';
+ * import {Transformer} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/modules/data/transformer.js';
  * new Transformer()
  * </script>
  * ```
@@ -120,7 +120,7 @@ import {Pathfinder} from "./pathfinder.js";
  *
  * @example
  *
- * import {Transformer} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.27.0/dist/modules/data/transformer.js';
+ * import {Transformer} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.0/dist/modules/data/transformer.js';
  *
  * const transformer = new Transformer("tolower")
  *