@schukai/monster 3.51.4 → 3.52.0

package/source/i18n/translations.mjs

@@ -11,7 +11,11 @@ import { ATTRIBUTE_OBJECTLINK } from "../dom/constants.mjs";
 import { getDocument } from "../dom/util.mjs";
 import { Base } from "../types/base.mjs";
 import { isObject, isString } from "../types/is.mjs";
-import { validateInteger, validateObject, validateString } from "../types/validate.mjs";
+import {
+	validateInteger,
+	validateObject,
+	validateString,
+} from "../types/validate.mjs";
 import { Locale, parseLocale } from "./locale.mjs";
 import { translationsLinkSymbol } from "./provider.mjs";
 
@@ -28,174 +32,176 @@ export { Translations, getDocumentTranslations };
  * @see https://datatracker.ietf.org/doc/html/rfc3066
  */
 class Translations extends Base {
-    /**
-     *
-     * @param {Locale} locale
-     */
-    constructor(locale) {
-        super();
-
-        if (locale instanceof Locale) {
-            this.locale = locale;
-        } else {
-            this.locale = parseLocale(validateString(locale));
-        }
-
-        this.storage = new Map();
-    }
-
-    /**
-     * This method is called by the `instanceof` operator.
-     * @returns {symbol}
-     * @since 3.27.0
-     */
-    static get [instanceSymbol]() {
-        return Symbol.for("@schukai/monster/i18n/translations@@instance");
-    }
-
-    /**
-     * Fetches a text using the specified key.
-     * If no suitable key is found, `defaultText` is taken.
-     *
-     * @param {string} key
-     * @param {string|undefined} defaultText
-     * @return {string}
-     * @throws {Error} key not found
-     */
-    getText(key, defaultText) {
-        if (!this.storage.has(key)) {
-            if (defaultText === undefined) {
-                throw new Error(`key ${key} not found`);
-            }
-
-            return validateString(defaultText);
-        }
-
-        let r = this.storage.get(key);
-        if (isObject(r)) {
-            return this.getPluralRuleText(key, "other", defaultText);
-        }
-
-        return this.storage.get(key);
-    }
-
-    /**
-     * A number `count` can be passed to this method. In addition to a number, one of the keywords can also be passed directly.
-     * "zero", "one", "two", "few", "many" and "other". Remember: not every language has all rules.
-     *
-     * The appropriate text for this number is then selected. If no suitable key is found, `defaultText` is taken.
-     *
-     * @param {string} key
-     * @param {integer|count} count
-     * @param {string|undefined} defaultText
-     * @return {string}
-     */
-    getPluralRuleText(key, count, defaultText) {
-        if (!this.storage.has(key)) {
-            return validateString(defaultText);
-        }
-
-        let r = validateObject(this.storage.get(key));
-
-        let keyword;
-        if (isString(count)) {
-            keyword = count.toLocaleString();
-        } else {
-            count = validateInteger(count);
-            if (count === 0) {
-                // special handling for zero count
-                if (r.hasOwnProperty("zero")) {
-                    return validateString(r["zero"]);
-                }
-            }
-
-            keyword = new Intl.PluralRules(this.locale.toString()).select(validateInteger(count));
-        }
-
-        if (r.hasOwnProperty(keyword)) {
-            return validateString(r[keyword]);
-        }
-
-        // @deprecated since 2023-03-14
-        // DEFAULT_KEY is undefined
-        // if (r.hasOwnProperty(DEFAULT_KEY)) {
-        //     return validateString(r[DEFAULT_KEY]);
-        // }
-
-        return validateString(defaultText);
-    }
-
-    /**
-     * Set a text for a key
-     *
-     * ```
-     * translations.setText("text1", "Make my day!");
-     * // plural rules
-     * translations.setText("text6", {
-     *     "zero": "There are no files on Disk.",
-     *     "one": "There is one file on Disk.",
-     *     "other": "There are files on Disk."
-     *     "default": "There are files on Disk."
-     * });
-     * ```
-     *
-     * @param {string} key
-     * @param {string|object} text
-     * @return {Translations}
-     * @throws {TypeError} value is not a string or object
-     */
-    setText(key, text) {
-        if (isString(text) || isObject(text)) {
-            this.storage.set(validateString(key), text);
-            return this;
-        }
-
-        throw new TypeError("value is not a string or object");
-    }
-
-    /**
-     * This method can be used to transfer overlays from an object. The keys are transferred, and the values are entered
-     * as text.
-     *
-     * The values can either be character strings or, in the case of texts with plural forms, objects. The plural forms
-     * must be stored as text via a standard key "zero", "one", "two", "few", "many" and "other".
-     *
-     * Additionally, the key default can be specified, which will be used if no other key fits.
-     *
-     * In some languages, like for example in German, there is no own more number at the value 0. In these languages,
-     * the function applies additionally zero.
-     *
-     * ```
-     * translations.assignTranslations({
-     *   "text1": "Make my day!",
-     *   "text2": "I'll be back!",
-     *   "text6": {
-     *     "zero": "There are no files on Disk.",
-     *     "one": "There is one file on Disk.",
-     *     "other": "There are files on Disk."
-     *     "default": "There are files on Disk."
-     * });
-     * ```
-     *
-     * @param {object} translations
-     * @return {Translations}
-     */
-    assignTranslations(translations) {
-        validateObject(translations);
-
-        if (translations instanceof Translations) {
-            translations.storage.forEach((v, k) => {
-                this.setText(k, v);
-            });
-            return this;
-        }
-
-        for (const [k, v] of Object.entries(translations)) {
-            this.setText(k, v);
-        }
-
-        return this;
-    }
+	/**
+	 *
+	 * @param {Locale} locale
+	 */
+	constructor(locale) {
+		super();
+
+		if (locale instanceof Locale) {
+			this.locale = locale;
+		} else {
+			this.locale = parseLocale(validateString(locale));
+		}
+
+		this.storage = new Map();
+	}
+
+	/**
+	 * This method is called by the `instanceof` operator.
+	 * @returns {symbol}
+	 * @since 3.27.0
+	 */
+	static get [instanceSymbol]() {
+		return Symbol.for("@schukai/monster/i18n/translations@@instance");
+	}
+
+	/**
+	 * Fetches a text using the specified key.
+	 * If no suitable key is found, `defaultText` is taken.
+	 *
+	 * @param {string} key
+	 * @param {string|undefined} defaultText
+	 * @return {string}
+	 * @throws {Error} key not found
+	 */
+	getText(key, defaultText) {
+		if (!this.storage.has(key)) {
+			if (defaultText === undefined) {
+				throw new Error(`key ${key} not found`);
+			}
+
+			return validateString(defaultText);
+		}
+
+		const r = this.storage.get(key);
+		if (isObject(r)) {
+			return this.getPluralRuleText(key, "other", defaultText);
+		}
+
+		return this.storage.get(key);
+	}
+
+	/**
+	 * A number `count` can be passed to this method. In addition to a number, one of the keywords can also be passed directly.
+	 * "zero", "one", "two", "few", "many" and "other". Remember: not every language has all rules.
+	 *
+	 * The appropriate text for this number is then selected. If no suitable key is found, `defaultText` is taken.
+	 *
+	 * @param {string} key
+	 * @param {integer|count} count
+	 * @param {string|undefined} defaultText
+	 * @return {string}
+	 */
+	getPluralRuleText(key, count, defaultText) {
+		if (!this.storage.has(key)) {
+			return validateString(defaultText);
+		}
+
+		const r = validateObject(this.storage.get(key));
+
+		let keyword;
+		if (isString(count)) {
+			keyword = count.toLocaleString();
+		} else {
+			count = validateInteger(count);
+			if (count === 0) {
+				// special handling for zero count
+				if (r.hasOwnProperty("zero")) {
+					return validateString(r["zero"]);
+				}
+			}
+
+			keyword = new Intl.PluralRules(this.locale.toString()).select(
+				validateInteger(count),
+			);
+		}
+
+		if (r.hasOwnProperty(keyword)) {
+			return validateString(r[keyword]);
+		}
+
+		// @deprecated since 2023-03-14
+		// DEFAULT_KEY is undefined
+		// if (r.hasOwnProperty(DEFAULT_KEY)) {
+		//     return validateString(r[DEFAULT_KEY]);
+		// }
+
+		return validateString(defaultText);
+	}
+
+	/**
+	 * Set a text for a key
+	 *
+	 * ```
+	 * translations.setText("text1", "Make my day!");
+	 * // plural rules
+	 * translations.setText("text6", {
+	 *     "zero": "There are no files on Disk.",
+	 *     "one": "There is one file on Disk.",
+	 *     "other": "There are files on Disk."
+	 *     "default": "There are files on Disk."
+	 * });
+	 * ```
+	 *
+	 * @param {string} key
+	 * @param {string|object} text
+	 * @return {Translations}
+	 * @throws {TypeError} value is not a string or object
+	 */
+	setText(key, text) {
+		if (isString(text) || isObject(text)) {
+			this.storage.set(validateString(key), text);
+			return this;
+		}
+
+		throw new TypeError("value is not a string or object");
+	}
+
+	/**
+	 * This method can be used to transfer overlays from an object. The keys are transferred, and the values are entered
+	 * as text.
+	 *
+	 * The values can either be character strings or, in the case of texts with plural forms, objects. The plural forms
+	 * must be stored as text via a standard key "zero", "one", "two", "few", "many" and "other".
+	 *
+	 * Additionally, the key default can be specified, which will be used if no other key fits.
+	 *
+	 * In some languages, like for example in German, there is no own more number at the value 0. In these languages,
+	 * the function applies additionally zero.
+	 *
+	 * ```
+	 * translations.assignTranslations({
+	 *   "text1": "Make my day!",
+	 *   "text2": "I'll be back!",
+	 *   "text6": {
+	 *     "zero": "There are no files on Disk.",
+	 *     "one": "There is one file on Disk.",
+	 *     "other": "There are files on Disk."
+	 *     "default": "There are files on Disk."
+	 * });
+	 * ```
+	 *
+	 * @param {object} translations
+	 * @return {Translations}
+	 */
+	assignTranslations(translations) {
+		validateObject(translations);
+
+		if (translations instanceof Translations) {
+			translations.storage.forEach((v, k) => {
+				this.setText(k, v);
+			});
+			return this;
+		}
+
+		for (const [k, v] of Object.entries(translations)) {
+			this.setText(k, v);
+		}
+
+		return this;
+	}
 }
 
 /**
@@ -210,30 +216,34 @@ class Translations extends Base {
  * @memberOf Monster.I18n
  */
 function getDocumentTranslations(element) {
-    const d = getDocument();
-
-    if (!(element instanceof HTMLElement)) {
-        element = d.querySelector(`[${ATTRIBUTE_OBJECTLINK}~="${translationsLinkSymbol.toString()}"]`);
-        if (element === null) {
-            throw new Error("Cannot find element with translations. Add a translations object to the document.");
-        }
-    }
-
-    if (!(element instanceof HTMLElement)) {
-        throw new Error("Element is not an HTMLElement.");
-    }
-
-    if (!hasObjectLink(element, translationsLinkSymbol)) {
-        throw new Error("This element has no translations.");
-    }
-
-    let obj = getLinkedObjects(element, translationsLinkSymbol);
-
-    for (const t of obj) {
-        if (t instanceof Translations) {
-            return t;
-        }
-    }
-
-    throw new Error("Missing translations.");
+	const d = getDocument();
+
+	if (!(element instanceof HTMLElement)) {
+		element = d.querySelector(
+			`[${ATTRIBUTE_OBJECTLINK}~="${translationsLinkSymbol.toString()}"]`,
+		);
+		if (element === null) {
+			throw new Error(
+				"Cannot find element with translations. Add a translations object to the document.",
+			);
+		}
+	}
+
+	if (!(element instanceof HTMLElement)) {
+		throw new Error("Element is not an HTMLElement.");
+	}
+
+	if (!hasObjectLink(element, translationsLinkSymbol)) {
+		throw new Error("This element has no translations.");
+	}
+
+	const obj = getLinkedObjects(element, translationsLinkSymbol);
+
+	for (const t of obj) {
+		if (t instanceof Translations) {
+			return t;
+		}
+	}
+
+	throw new Error("Missing translations.");
 }

package/source/logging/handler/console.mjs

@@ -21,44 +21,44 @@ export { ConsoleHandler };
  * @memberOf Monster.Logging.Handler
  */
 class ConsoleHandler extends Handler {
-    /**
-     * This is the central log function. this method must be
-     * overwritten by derived handlers with their own logic.
-     *
-     * ALL > TRACE > DEBUG > INFO > WARN > ERROR > FATAL > OFF  (ALL = 0xff;OFF = 0x00;
-     *
-     * @param {LogEntry} entry
-     * @returns {boolean}
-     */
-    log(entry) {
-        if (super.log(entry)) {
-            let console = getGlobalObject("console");
-            if (!console) return false;
+	/**
+	 * This is the central log function. this method must be
+	 * overwritten by derived handlers with their own logic.
+	 *
+	 * ALL > TRACE > DEBUG > INFO > WARN > ERROR > FATAL > OFF  (ALL = 0xff;OFF = 0x00;
+	 *
+	 * @param {LogEntry} entry
+	 * @returns {boolean}
+	 */
+	log(entry) {
+		if (super.log(entry)) {
+			const console = getGlobalObject("console");
+			if (!console) return false;
 
-            if (!console.error) console.error = console.log;
-            if (!console.warn) console.warn = console.log;
+			if (!console.error) console.error = console.log;
+			if (!console.warn) console.warn = console.log;
 
-            switch (entry.getLogLevel()) {
-                case TRACE:
-                case DEBUG:
-                case INFO:
-                    console.log(entry.toString());
-                    break;
-                case FATAL:
-                case ERROR:
-                    console.error(entry.toString());
-                    break;
-                case WARN:
-                    console.warn(entry.toString());
-                    break;
-                default:
-                    console.log(entry.toString());
-                    break;
-            }
+			switch (entry.getLogLevel()) {
+				case TRACE:
+				case DEBUG:
+				case INFO:
+					console.log(entry.toString());
+					break;
+				case FATAL:
+				case ERROR:
+					console.error(entry.toString());
+					break;
+				case WARN:
+					console.warn(entry.toString());
+					break;
+				default:
+					console.log(entry.toString());
+					break;
+			}
 
-            return true;
-        }
+			return true;
+		}
 
-        return false;
-    }
+		return false;
+	}
 }