@schukai/monster 1.17.1 → 1.20.0

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.17.1/dist/modules/i18n/provider.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.20.0/dist/modules/i18n/provider.js';
  * console.log(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.17.1/dist/modules/i18n/provider.js';
+ * import {Provider} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.20.0/dist/modules/i18n/provider.js';
  * console.log(new Provider())
  * </script>
  * ```
@@ -32,7 +32,7 @@ import {Translations} from "./translations.js"
  * @since 1.13.0
  * @copyright schukai GmbH
  * @memberOf Monster.I18n
- * @see https://datatracker.ietf.org/doc/html/rfc3066
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc3066}
  */
 class Provider extends BaseWithOptions {
 

package/source/i18n/providers/fetch.js

@@ -27,7 +27,7 @@ const optionsSymbol = Symbol.for(PROPERTY_KEY_INTERNALDATA);
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.17.1/dist/modules/i18n/providers/fetch.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.20.0/dist/modules/i18n/providers/fetch.js';
  * console.log(new Monster.I18n.Providers.Fetch())
  * </script>
  * ```
@@ -36,7 +36,7 @@ const optionsSymbol = Symbol.for(PROPERTY_KEY_INTERNALDATA);
  *
  * ```
  * <script type="module">
- * import {Fetch} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.17.1/dist/modules/i18n/providers/fetch.js';
+ * import {Fetch} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.20.0/dist/modules/i18n/providers/fetch.js';
  * console.log(new Fetch())
  * </script>
  * ```
@@ -44,7 +44,7 @@ const optionsSymbol = Symbol.for(PROPERTY_KEY_INTERNALDATA);
  * @since 1.13.0
  * @copyright schukai GmbH
  * @memberOf Monster.I18n.Providers
- * @see https://datatracker.ietf.org/doc/html/rfc3066
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc3066}
  */
 class Fetch extends Provider {
 
@@ -53,7 +53,7 @@ class Fetch extends Provider {
      *
      * @param {string|URL} url
      * @param {Object} options see {@link Monster.I18n.Providers.Fetch#defaults}
-     * @see https://developer.mozilla.org/en-US/docs/Web/API/fetch
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/fetch}
      */
     constructor(url, options) {
         super(options);
@@ -92,7 +92,7 @@ class Fetch extends Provider {
      * @property {String} fetch.redirect=follow
      * @property {String} fetch.referrerPolicy=no-referrer
      *
-     * @see https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API}
      */
     get defaults() {
 

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.17.1/dist/modules/i18n/translations.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.20.0/dist/modules/i18n/translations.js';
  * console.log(new Monster.I18n.Translations())
  * </script>
  * ```
@@ -26,7 +26,7 @@ import {Locale, parseLocale} from "./locale.js";
  *
  * ```
  * <script type="module">
- * import {Translations} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.17.1/dist/modules/i18n/translations.js';
+ * import {Translations} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.20.0/dist/modules/i18n/translations.js';
  * console.log(new Translations())
  * </script>
  * ```

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.17.1/dist/modules/logging/handler/console.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.20.0/dist/modules/logging/handler/console.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.17.1/dist/modules/logging/handler/console.js';
+ * import {ConsoleHandler} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.20.0/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.17.1/dist/modules/logging/handler.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.20.0/dist/modules/logging/handler.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.17.1/dist/modules/logging/handler.js';
+ * import {ID} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.20.0/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.17.1/dist/modules/logging/logentry.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.20.0/dist/modules/logging/logentry.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.17.1/dist/modules/logging/logentry.js';
+ * import {ID} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.20.0/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.17.1/dist/modules/logging/logger.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.20.0/dist/modules/logging/logger.js';
  * console.log(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.17.1/dist/modules/logging/logger.js';
+ * import {ID} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.20.0/dist/modules/logging/logger.js';
  * console.log(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.17.1/dist/modules/math/random.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.20.0/dist/modules/math/random.js';
  * console.log(Monster.Math.random(1,10)) // ↦ 5
  * </script>
  * ```
@@ -24,7 +24,7 @@ import {getGlobal} from '../types/global.js';
  *
  * ```
  * <script type="module">
- * import {random} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.17.1/dist/modules/math/random.js';
+ * import {random} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.20.0/dist/modules/math/random.js';
  * console.log(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.17.1/dist/modules/namespace.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.20.0/dist/modules/namespace.js';
  * function hello() {
  *            console.log('Hello World!');
  *        }

package/source/text/formatter.js

@@ -18,7 +18,7 @@ import {validateObject, validateString} from "../types/validate.js";
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.17.1/dist/modules/text/formatter.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.20.0/dist/modules/text/formatter.js';
  * console.log(new Monster.Text.Formatter())
  * </script>
  * ```
@@ -27,7 +27,7 @@ import {validateObject, validateString} from "../types/validate.js";
  *
  * ```
  * <script type="module">
- * import {Formatter} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.17.1/dist/modules/text/formatter.js';
+ * import {Formatter} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.20.0/dist/modules/text/formatter.js';
  * console.log(new Formatter())
  * </script>
  * ```

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.17.1/dist/modules/types/base.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.20.0/dist/modules/types/base.js';
  * console.log(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.17.1/dist/modules/types/base.js';
+ * import {Base} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.20.0/dist/modules/types/base.js';
  * console.log(new Base())
  * </script>
  * ```

package/source/types/basewithoptions.js

@@ -23,7 +23,7 @@ const optionsSymbol = Symbol.for(PROPERTY_KEY_INTERNALDATA);
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.17.1/dist/modules/types/basewithoptions.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.20.0/dist/modules/types/basewithoptions.js';
  * console.log(new Monster.Types.BaseWithOptions())
  * </script>
  * ```
@@ -32,7 +32,7 @@ const optionsSymbol = Symbol.for(PROPERTY_KEY_INTERNALDATA);
  *
  * ```
  * <script type="module">
- * import {BaseWithOptions} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.17.1/dist/modules/types/basewithoptions.js';
+ * import {BaseWithOptions} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.20.0/dist/modules/types/basewithoptions.js';
  * console.log(new BaseWithOptions())
  * </script>
  * ```

package/source/types/binary.js

@@ -0,0 +1,92 @@
+'use strict';
+
+import {assignToNamespace} from "../namespace.js";
+
+
+/**
+ * @author schukai GmbH
+ */
+import {Monster, validateString} from "./validate.js";
+
+/**
+ * You can call the function via the monster namespace `Monster.Types.toBinary()`.
+ *
+ * ```
+ * <script type="module">
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.20.0/dist/modules/types/binary.js';
+ * console.log(Monster.Types.toBinary())
+ * </script>
+ * ```
+ *
+ * Alternatively, you can also integrate this function individually.
+ *
+ * ```
+ * <script type="module">
+ * import {toBinary} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.20.0/dist/modules/types/binary.js';
+ * console.log(toBinary())
+ * </script>
+ * ```
+ *
+ * @param {String} binary
+ * @return {String}
+ * @throws {TypeError} value is not a string
+ * @memberOf Monster.Types
+ * @since 1.18.0
+ */
+function toBinary(string) {
+    const codeUnits = new Uint16Array(validateString(string).length);
+    for (let i = 0; i < codeUnits.length; i++) {
+        codeUnits[i] = string.charCodeAt(i);
+    }
+
+    const charCodes = new Uint8Array(codeUnits.buffer);
+    let result = '';
+
+    for (let i = 0; i < charCodes.byteLength; i++) {
+        result += String.fromCharCode(charCodes[i]);
+    }
+
+    return result;
+}
+
+/**
+ * You can call the function via the monster namespace `Monster.Types.fromBinary()`.
+ *
+ * ```
+ * <script type="module">
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.20.0/dist/modules/types/binary.js';
+ * console.log(Monster.Types.fromBinary())
+ * </script>
+ * ```
+ *
+ * Alternatively, you can also integrate this function individually.
+ *
+ * ```
+ * <script type="module">
+ * import {fromBinary} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.20.0/dist/modules/types/binary.js';
+ * console.log(fromBinary())
+ * </script>
+ * ```
+ *
+ * @param {String} binary
+ * @return {String}
+ * @throws {TypeError} value is not a string
+ * @memberOf Monster.Types
+ * @since 1.18.0
+ */
+function fromBinary(binary) {
+    const bytes = new Uint8Array(validateString(binary).length);
+    for (let i = 0; i < bytes.length; i++) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    const charCodes = new Uint16Array(bytes.buffer);
+    let result = '';
+    for (let i = 0; i < charCodes.length; i++) {
+        result += String.fromCharCode(charCodes[i]);
+    }
+    return result;
+}
+
+
+assignToNamespace('Monster.Types', toBinary, fromBinary);
+export {Monster, toBinary, fromBinary};

package/source/types/dataurl.js

@@ -0,0 +1,176 @@
+'use strict';
+
+import {assignToNamespace} from "../namespace.js";
+/**
+ * @author schukai GmbH
+ */
+import {Base, Monster} from "./base.js";
+import {isString} from "./is.js";
+import {MediaType, parseMediaType} from "./mediatype.js";
+import {validateBoolean, validateInstance, validateString} from "./validate.js";
+
+/**
+ * @private
+ * @type {symbol}
+ */
+const internal = Symbol('internal');
+
+/**
+ * You can create an object via the monster namespace `new Monster.Types.DataUrl()`.
+ *
+ * ```
+ * <script type="module">
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.20.0/dist/modules/types/dataurl.js';
+ * console.log(new Monster.Types.DataUrl())
+ * </script>
+ * ```
+ *
+ * Alternatively, you can also integrate this function individually.
+ *
+ * ```
+ * <script type="module">
+ * import {DataUrl} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.20.0/dist/modules/types/dataurl.js';
+ * console.log(new DataUrl())
+ * </script>
+ * ```
+ *
+ * @since 1.8.0
+ * @copyright schukai GmbH
+ * @memberOf Monster.Types
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs
+ * @see https://datatracker.ietf.org/doc/html/rfc2397
+ */
+class DataUrl extends Base {
+
+    /**
+     *
+     * @param {String} content
+     * @param {String|Monster.Types.MediaType} mediatype
+     * @param {boolean} base64=true
+     */
+    constructor(content, mediatype, base64) {
+        super();
+
+        if (isString(mediatype)) {
+            mediatype = parseMediaType(mediatype);
+        }
+
+        this[internal] = {
+            content: validateString(content),
+            mediatype: validateInstance(mediatype, MediaType),
+            base64: validateBoolean(base64 === undefined ? true : base64)
+        }
+
+
+    }
+
+    get content() {
+        return this[internal].base64 ? atob(this[internal].content) : this[internal].content;
+    }
+
+    get mediatype() {
+        return this[internal].mediatype;
+    }
+
+
+    /**
+     *
+     * @return {string}
+     * @see https://datatracker.ietf.org/doc/html/rfc2397
+     */
+    toString() {
+
+        let content = this[internal].content;
+
+        if (this[internal].base64 === true) {
+            content = ';base64,' + content;
+        } else {
+            content = ',' + encodeURIComponent(content);
+        }
+
+        return 'data:' + this[internal].mediatype.toString() + content;
+    }
+
+}
+
+/**
+ * You can call the function via the monster namespace `Monster.Types.parseDataURL()`.
+ *
+ * ```
+ * <script type="module">
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.20.0/dist/modules/types/dataurl.js';
+ * console.log(Monster.Types.parseDataURL())
+ * </script>
+ * ```
+ *
+ * Alternatively, you can also integrate this function individually.
+ *
+ * ```
+ * <script type="module">
+ * import {parseDataURL} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.20.0/dist/modules/types/dataurl.js';
+ * console.log(parseDataURL())
+ * </script>
+ * ```
+ *
+ * Specification:
+ *
+ * ```
+ * dataurl    := "data:" [ mediatype ] [ ";base64" ] "," data
+ * mediatype  := [ type "/" subtype ] *( ";" parameter )
+ * data       := *urlchar
+ * parameter  := attribute "=" value
+ * ```
+ *
+ * @param {String} dataurl
+ * @return {Monster.Types.DataUrl}
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs
+ * @see https://datatracker.ietf.org/doc/html/rfc2397
+ * @throws {TypeError} incorrect or missing data protocol
+ * @throws {TypeError} malformed data url
+ * @memberOf Monster.Types
+ */
+function parseDataURL(dataurl) {
+
+    validateString(dataurl);
+
+    dataurl = dataurl.trim();
+
+    if (dataurl.substring(0, 5) !== 'data:') {
+        throw new TypeError('incorrect or missing data protocol')
+    }
+
+    dataurl = dataurl.substring(5);
+
+    let p = dataurl.indexOf(',');
+    if (p === -1) {
+        throw new TypeError('malformed data url')
+    }
+
+    let content = dataurl.substring(p + 1);
+    let mediatypeAndBase64 = dataurl.substring(0, p).trim();
+    let mediatype = 'text/plain;charset=US-ASCII';
+    let base64Flag = false;
+
+    if (mediatypeAndBase64 !== "") {
+        mediatype = mediatypeAndBase64;
+        if (mediatypeAndBase64.endsWith('base64')) {
+            let i = mediatypeAndBase64.lastIndexOf(';');
+            mediatype = mediatypeAndBase64.substring(0, i);
+            base64Flag = true;
+        } else {
+            content = decodeURIComponent(content);
+        }
+
+        mediatype = parseMediaType(mediatype);
+    } else {
+        content = decodeURIComponent(content);
+    }
+
+    return new DataUrl(content, mediatype, base64Flag);
+
+
+}
+
+
+assignToNamespace('Monster.Types', parseDataURL, DataUrl);
+export {Monster, parseDataURL, DataUrl};

package/source/types/global.js

@@ -78,7 +78,7 @@ function getGlobal() {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.17.1/dist/modules/types/global.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.20.0/dist/modules/types/global.js';
  * console.log(Monster.Types.getGlobalObject('document')) // ↦ { }
  * </script>
  * ```
@@ -87,7 +87,7 @@ function getGlobal() {
  *
  * ```
  * <script type="module">
- * import {getGlobalObject} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.17.1/dist/modules/types/global.js';
+ * import {getGlobalObject} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.20.0/dist/modules/types/global.js';
  * console.log(getGlobalObject('document')) // ↦ { }
  * </script>
  * ```
@@ -115,7 +115,7 @@ function getGlobalObject(name) {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.17.1/dist/modules/types/global.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.20.0/dist/modules/types/global.js';
  * console.log(Monster.Types.getGlobalFunction('parseInt')) // ↦ f parseInt() { }
  * </script>
  * ```
@@ -124,7 +124,7 @@ function getGlobalObject(name) {
  *
  * ```
  * <script type="module">
- * import {getGlobalFunction} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.17.1/dist/modules/types/global.js';
+ * import {getGlobalFunction} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.20.0/dist/modules/types/global.js';
  * console.log(getGlobalFunction('parseInt')) // ↦ f parseInt() { }
  * </script>
  * ```

package/source/types/id.js

@@ -24,7 +24,7 @@ let internalCounter = new Map;
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.17.1/dist/modules/types/id.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.20.0/dist/modules/types/id.js';
  * console.log(new Monster.Types.ID())
  * </script>
  * ```
@@ -33,7 +33,7 @@ let internalCounter = new Map;
  *
  * ```
  * <script type="module">
- * import {ID} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.17.1/dist/modules/types/id.js';
+ * import {ID} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.20.0/dist/modules/types/id.js';
  * console.log(new ID())
  * </script>
  * ```