@schukai/monster 1.28.1 → 1.29.3

package/source/dom/template.js

@@ -15,7 +15,7 @@ import {getDocumentTheme} from "./theme.js";
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * new Monster.DOM.Template()
  * </script>
  * ```
@@ -24,7 +24,7 @@ import {getDocumentTheme} from "./theme.js";
  *
  * ```
  * <script type="module">
- * import {Template} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/dom/template.js';
+ * import {Template} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/dom/template.js';
  * new Template()
  * </script>
  * ```
@@ -86,7 +86,7 @@ class Template extends Base {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * Monster.DOM.findDocumentTemplate()
  * </script>
  * ```
@@ -95,14 +95,14 @@ class Template extends Base {
  *
  * ```
  * <script type="module">
- * import {findTemplate} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/dom/template.js';
+ * import {findTemplate} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/dom/template.js';
  * findDocumentTemplate()
  * </script>
  * ```
  *
  * @example
  *
- * import { findDocumentTemplate } from "https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/dom/template.js";
+ * import { findDocumentTemplate } from "https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/dom/template.js";
  *
  * const template = document.createElement("template");
  * template.id = "myTemplate";

package/source/dom/theme.js

@@ -15,7 +15,7 @@ import {ATTRIBUTE_THEME_NAME, DEFAULT_THEME} from "./constants.js";
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * console.log(new Monster.DOM.Theme())
  * </script>
  * ```
@@ -24,14 +24,14 @@ import {ATTRIBUTE_THEME_NAME, DEFAULT_THEME} from "./constants.js";
  *
  * ```
  * <script type="module">
- * import {Theme} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/dom/theme.js';
+ * import {Theme} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/dom/theme.js';
  * console.log(new Theme())
  * </script>
  * ```
  *
  * @example
  *
- * import {getDocumentTheme} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/dom/theme.js';
+ * import {getDocumentTheme} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/dom/theme.js';
  *
  * const theme = getDocumentTheme();
  * console.log(theme.getName());

package/source/dom/updater.js

@@ -44,7 +44,7 @@ import {getDocument} from "./util.js";
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * new Monster.DOM.Updater()
  * </script>
  * ```
@@ -53,14 +53,14 @@ import {getDocument} from "./util.js";
  *
  * ```
  * <script type="module">
- * import {Updater} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/dom/updater.js';
+ * import {Updater} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/dom/updater.js';
  * new Updater()
  * </script>
  * ```
  *
  * @example
  *
- * import {Updater} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/dom/updater.js';
+ * import {Updater} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/dom/updater.js';
  *
  * // First we prepare the html document.
  * // This is done here via script, but can also be inserted into the document as pure html.
@@ -332,6 +332,8 @@ function getControlEventHandler() {
  * @throws {Error} the bind argument must start as a value with a path
  * @param {HTMLElement} element
  * @return void
+ * @memberOf Monster.DOM
+ * @private
  */
 function retrieveAndSetValue(element) {
 
@@ -402,6 +404,7 @@ function retrieveAndSetValue(element) {
 /**
  * @since 1.27.0
  * @return void
+ * @private
  */
 function retrieveFromBindings() {
     const self = this;
@@ -449,19 +452,34 @@ function insertElement(change) {
     let mem = new WeakSet;
     let wd = 0;
 
+    const container = self[internalSymbol].element;
 
     while (true) {
         let found = false;
         wd++;
 
         let p = clone(change?.['path']);
-        if (!isArray(p)) return this;
+        if (!isArray(p)) return self;
 
         while (p.length > 0) {
             const current = p.join('.');
-            const list = this[internalSymbol].element.querySelectorAll(':scope [' + ATTRIBUTE_UPDATER_INSERT + '*="path:' + current + '"]').entries()
 
-            for (const [, containerElement] of list) {
+            let iterator = new Set;
+            const query = '[' + ATTRIBUTE_UPDATER_INSERT + '*="path:' + current + '"]';
+
+            const e = container.querySelectorAll(query);
+
+            if (e.length > 0) {
+                iterator = new Set(
+                    [...e]
+                )
+            }
+
+            if (container.matches(query)) {
+                iterator.add(container);
+            }
+
+            for (const [, containerElement] of iterator.entries()) {
 
                 if (mem.has(containerElement)) continue;
                 mem.add(containerElement)
@@ -481,7 +499,7 @@ function insertElement(change) {
                 }
 
                 let pipe = new Pipe(cmd);
-                this[internalSymbol].callbacks.forEach((f, n) => {
+                self[internalSymbol].callbacks.forEach((f, n) => {
                     pipe.setCallback(n, f);
                 })
 
@@ -524,7 +542,12 @@ function insertElement(change) {
                 let nodes = containerElement.querySelectorAll('[' + ATTRIBUTE_UPDATER_INSERT_REFERENCE + '*="' + refPrefix + '"]');
                 for (const [, node] of Object.entries(nodes)) {
                     if (!available.has(node.getAttribute(ATTRIBUTE_UPDATER_INSERT_REFERENCE))) {
-                        containerElement.removeChild(node);
+                        try {
+                            containerElement.removeChild(node);
+                        } catch (e) {
+                            containerElement.setAttribute(ATTRIBUTE_ERRORMESSAGE, (containerElement.getAttribute(ATTRIBUTE_ERRORMESSAGE) + ", " + e.message).trim());
+                        }
+
                     }
                 }
             }
@@ -653,7 +676,10 @@ function runUpdateContent(container, parts, subject) {
             iterator.add(container);
         }
 
-        iterator.forEach((key, element) => {
+        /**
+         * @type {HTMLElement} element
+         */
+        for (const [element] of iterator.entries()) {
 
             if (mem.has(element)) return;
             mem.add(element)
@@ -678,12 +704,18 @@ function runUpdateContent(container, parts, subject) {
                 while (element.firstChild) {
                     element.removeChild(element.firstChild);
                 }
-                element.addNode(value);
+                
+                try {
+                    element.appendChild(value);
+                } catch (e) {
+                    element.setAttribute(ATTRIBUTE_ERRORMESSAGE, (element.getAttribute(ATTRIBUTE_ERRORMESSAGE) + ", " + e.message).trim());
+                }
+
             } else {
                 element.innerHTML = value;
             }
 
-        })
+        }
 
 
     }
@@ -740,7 +772,7 @@ function runUpdateAttributes(container, parts, subject) {
             iterator.add(container);
         }
 
-        iterator.forEach((key, element) => {
+        for (const [element] of iterator.entries()) {
 
             if (mem.has(element)) return;
             mem.add(element)
@@ -778,8 +810,7 @@ function runUpdateAttributes(container, parts, subject) {
                 handleInputControlAttributeUpdate.call(this, element, name, value);
 
             }
-        });
-
+        }
     }
 
 }

package/source/dom/util.js

@@ -13,7 +13,7 @@ import {validateString} from "../types/validate.js";
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * console.log(Monster.DOM.getDocument())
  * </script>
  * ```
@@ -22,7 +22,7 @@ import {validateString} from "../types/validate.js";
  *
  * ```
  * <script type="module">
- * import {getDocument} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/dom/util.js';
+ * import {getDocument} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/dom/util.js';
  * console.log(getDocument())
  * </script>
  * ```
@@ -74,7 +74,7 @@ function getDocument() {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * console.log(Monster.DOM.getWindow())
  * </script>
  * ```
@@ -83,7 +83,7 @@ function getDocument() {
  *
  * ```
  * <script type="module">
- * import {getWindow} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/dom/util.js';
+ * import {getWindow} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/dom/util.js';
  * console.log(getWindow(null))
  * </script>
  * ```
@@ -140,7 +140,7 @@ function getWindow() {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * console.log(Monster.DOM.getDocumentFragmentFromString())
  * </script>
  * ```
@@ -149,7 +149,7 @@ function getWindow() {
  *
  * ```
  * <script type="module">
- * import {getDocumentFragmentFromString} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/dom/util.js';
+ * import {getDocumentFragmentFromString} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/dom/util.js';
  * console.log(getDocumentFragmentFromString('<div></div>'))
  * </script>
  * ```

package/source/dom/worker/factory.js

@@ -20,7 +20,7 @@ import {validateInstance, validateString} from "../../types/validate.js";
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * console.log(new Monster.DOM.Worker.Factory())
  * </script>
  * ```
@@ -29,7 +29,7 @@ import {validateInstance, validateString} from "../../types/validate.js";
  *
  * ```
  * <script type="module">
- * import {Factory} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/dom/worker/factory.js';
+ * import {Factory} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/dom/worker/factory.js';
  * console.log(new Factory())
  * </script>
  * ```

package/source/i18n/formatter.js

@@ -25,7 +25,7 @@ const internalTranslationSymbol = Symbol('internalTranslation')
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * new Monster.I18n.Formatter()
  * </script>
  * ```
@@ -34,15 +34,15 @@ const internalTranslationSymbol = Symbol('internalTranslation')
  *
  * ```
  * <script type="module">
- * import {Formatter} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/i18n/formatter.js';
+ * import {Formatter} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/i18n/formatter.js';
  * new Formatter()
  * </script>
  * ```
  *
  * @example
  *
- * import {Formatter} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/i18n/formatter.js';
- * import {Translations} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/i18n/translations.js';
+ * import {Formatter} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/i18n/formatter.js';
+ * import {Translations} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/i18n/translations.js';
  *
  * const translations = new Translations('en')
  *     .assignTranslations({

package/source/i18n/locale.js

@@ -25,7 +25,7 @@ const localeStringSymbol = Symbol('localeString');
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * new Monster.I18n.Locale()
  * </script>
  * ```
@@ -34,7 +34,7 @@ const localeStringSymbol = Symbol('localeString');
  *
  * ```
  * <script type="module">
- * import {Locale} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/i18n/locale.js';
+ * import {Locale} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/i18n/locale.js';
  * new Locale()
  * </script>
  * ```
@@ -203,7 +203,7 @@ class Locale extends Base {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * new Monster.I18n.createLocale()
  * </script>
  * ```
@@ -212,7 +212,7 @@ class Locale extends Base {
  *
  * ```
  * <script type="module">
- * import {createLocale} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/i18n/locale.js';
+ * import {createLocale} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/i18n/locale.js';
  * createLocale()
  * </script>
  * ```

package/source/i18n/provider.js

@@ -15,7 +15,7 @@ import {Translations} from "./translations.js"
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * new Monster.I18n.Provider()
  * </script>
  * ```
@@ -24,7 +24,7 @@ import {Translations} from "./translations.js"
  *
  * ```
  * <script type="module">
- * import {Provider} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/i18n/provider.js';
+ * import {Provider} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/i18n/provider.js';
  * new Provider()
  * </script>
  * ```

package/source/i18n/providers/fetch.js

@@ -22,7 +22,7 @@ import {Translations} from "../translations.js";
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * new Monster.I18n.Providers.Fetch()
  * </script>
  * ```
@@ -31,14 +31,14 @@ import {Translations} from "../translations.js";
  *
  * ```
  * <script type="module">
- * import {Fetch} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/i18n/providers/fetch.js';
+ * import {Fetch} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/i18n/providers/fetch.js';
  * new Fetch()
  * </script>
  * ```
  * 
  * @example <caption>das ist ein test</caption>
  * 
- * import {Fetch} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/i18n/providers/fetch.js';
+ * import {Fetch} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/i18n/providers/fetch.js';
  * 
  * // fetch from API
  * const translation = new Fetch('https://example.com/${language}.json').getTranslation('en-GB');

package/source/i18n/translations.js

@@ -17,7 +17,7 @@ import {Locale, parseLocale} from "./locale.js";
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * new Monster.I18n.Translations()
  * </script>
  * ```
@@ -26,15 +26,15 @@ import {Locale, parseLocale} from "./locale.js";
  *
  * ```
  * <script type="module">
- * import {Translations} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/i18n/translations.js';
+ * import {Translations} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/i18n/translations.js';
  * new Translations()
  * </script>
  * ```
  *
  * @example
  *
- * import {Translations} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/i18n/translations.js';
- * import {parseLocale} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/i18n/locale.js';
+ * import {Translations} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/i18n/translations.js';
+ * import {parseLocale} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/i18n/locale.js';
  *
  * const translation = new Translations(parseLocale('en-GB'));
  *

package/source/logging/handler/console.js

@@ -15,7 +15,7 @@ import {LogEntry} from "../logentry.js";
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * console.log(new Monster.Logging.Handler.ConsoleHandler())
  * </script>
  * ```
@@ -24,7 +24,7 @@ import {LogEntry} from "../logentry.js";
  *
  * ```
  * <script type="module">
- * import {ConsoleHandler} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/logging/handler/console.js';
+ * import {ConsoleHandler} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/logging/handler/console.js';
  * console.log(new ConsoleHandler())
  * </script>
  * ```

package/source/logging/handler.js

@@ -15,7 +15,7 @@ import {ALL, DEBUG, ERROR, FATAL, INFO, OFF, TRACE, WARN} from "./logger.js";
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * console.log(new Monster.Logging.Handler())
  * </script>
  * ```
@@ -24,7 +24,7 @@ import {ALL, DEBUG, ERROR, FATAL, INFO, OFF, TRACE, WARN} from "./logger.js";
  *
  * ```
  * <script type="module">
- * import {ID} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/logging/handler.js';
+ * import {ID} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/logging/handler.js';
  * console.log(new Handler())
  * </script>
  * ```

package/source/logging/logentry.js

@@ -14,7 +14,7 @@ import {validateInteger} from '../types/validate.js';
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * console.log(new Monster.Logging.LogEntry())
  * </script>
  * ```
@@ -23,7 +23,7 @@ import {validateInteger} from '../types/validate.js';
  *
  * ```
  * <script type="module">
- * import {ID} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/logging/logentry.js';
+ * import {ID} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/logging/logentry.js';
  * console.log(new LogEntry())
  * </script>
  * ```

package/source/logging/logger.js

@@ -65,7 +65,7 @@ const OFF = 0;
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * new Monster.Logging.Logger()
  * </script>
  * ```
@@ -74,7 +74,7 @@ const OFF = 0;
  *
  * ```
  * <script type="module">
- * import {ID} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/logging/logger.js';
+ * import {ID} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/logging/logger.js';
  * new Logger()
  * </script>
  * ```

package/source/math/random.js

@@ -15,7 +15,7 @@ import {getGlobal} from '../types/global.js';
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * Monster.Math.random(1,10)
  * // ↦ 5
  * </script>
@@ -25,7 +25,7 @@ import {getGlobal} from '../types/global.js';
  *
  * ```
  * <script type="module">
- * import {random} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/math/random.js';
+ * import {random} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/math/random.js';
  * random(1,10)
  * // ↦ 5
  * </script>

package/source/namespace.js

@@ -65,7 +65,7 @@ export const Monster = new Namespace("Monster");
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * function hello() {
  *            console.log('Hello World!');
  *        }

package/source/text/formatter.js

@@ -53,7 +53,7 @@ const workingDataSymbol = Symbol('workingData');
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * new Monster.Text.Formatter()
  * </script>
  * ```
@@ -62,7 +62,7 @@ const workingDataSymbol = Symbol('workingData');
  *
  * ```
  * <script type="module">
- * import {Formatter} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/text/formatter.js';
+ * import {Formatter} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/text/formatter.js';
  * new Formatter()
  * </script>
  * ```
@@ -107,7 +107,7 @@ const workingDataSymbol = Symbol('workingData');
  *
  * @example
  *
- * import {Formatter} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/text/formatter.js';
+ * import {Formatter} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/text/formatter.js';
  *
  * new Formatter({
  *       a: {

package/source/types/base.js

@@ -13,7 +13,7 @@ import {assignToNamespace, Monster} from '../namespace.js';
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * new Monster.Types.Base()
  * </script>
  * ```
@@ -22,7 +22,7 @@ import {assignToNamespace, Monster} from '../namespace.js';
  *
  * ```
  * <script type="module">
- * import {Base} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/types/base.js';
+ * import {Base} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/types/base.js';
  * new Base()
  * </script>
  * ```

package/source/types/basewithoptions.js

@@ -14,24 +14,39 @@ import {validateObject} from "./validate.js";
 /**
  * This is the base class with options from which some monster classes are derived.
  *
- * You can call the method via the monster namespace `new Monster.Types.BaseWithOptions()`.
+ * This class is actually only used as a base class.
+ * 
+ * However, you can also create an instance directly via the monster namespace `new Monster.Types.BaseWithOptions()`.
  *
- * ```
+ * ```html
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * new Monster.Types.BaseWithOptions()
  * </script>
  * ```
  *
  * Alternatively, you can also integrate this function individually.
  *
- * ```
+ * ```html
  * <script type="module">
- * import {BaseWithOptions} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/types/basewithoptions.js';
+ * import {BaseWithOptions} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/types/basewithoptions.js';
  * new BaseWithOptions()
  * </script>
  * ```
+ * 
+ * Classes that require the possibility of options can be derived directly from this class.
+ * Derived classes almost always override the `defaul` getter with their own values.
  *
+ * ```javascript
+ * class My extends BaseWithOptions {
+ *    get defaults() {
+ *        return Object.assign({}, super.defaults, {
+ *            mykey: true
+ *        });
+ *    }  
+ * }
+ * ```
+ * 
  * The class was formerly called Object.
  *
  * @since 1.13.0
@@ -56,7 +71,18 @@ class BaseWithOptions extends Base {
     }
 
     /**
-     * can be overridden by child class values
+     * This getter provides the options. Derived classes overwrite 
+     * this getter with their own values. It is good karma to always include 
+     * the values from the parent class.
+     * 
+     * ```javascript
+     * get defaults() {
+     *     return Object.assign({}, super.defaults, {
+     *         mykey: true
+     *     });
+     * }
+     * 
+     * ```
      *
      * @return {object}
      */