@schukai/monster 4.38.2 → 4.38.4

package/source/i18n/translations.mjs

@@ -19,13 +19,15 @@ import { getDocument } from "../dom/util.mjs";
 import { Base } from "../types/base.mjs";
 import { isObject, isString } from "../types/is.mjs";
 import {
-	validateInteger,
-	validateObject,
-	validateString,
+  validateInteger,
+  validateObject,
+  validateString,
 } from "../types/validate.mjs";
 import { Locale, parseLocale } from "./locale.mjs";
 import { translationsLinkSymbol } from "./provider.mjs";
 
+import { getLocaleOfDocument } from "../dom/locale.mjs";
+
 export { Translations, getDocumentTranslations };
 
 /**
@@ -38,178 +40,185 @@ 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 if (isString(locale)) {
-			this.locale = parseLocale(validateString(locale));
-		} else {
-			this.locale = getDocumentTranslations();
-		}
-
-		this.storage = new Map();
-	}
-
-	/**
-	 * This method is called by the `instanceof` operator.
-	 * @return {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|string} 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;
-	}
+  /**
+   *
+   * @param {Locale} locale
+   */
+  constructor(locale) {
+    super();
+
+    try {
+      if (locale instanceof Locale) {
+        this.locale = locale;
+      } else if (isString(locale)) {
+        this.locale = parseLocale(validateString(locale));
+      } else {
+        this.locale = getLocaleOfDocument();
+      }
+    } catch (e) {
+    } finally {
+      if (!(this.locale instanceof Locale)) {
+        this.locale = new Locale("en");
+      }
+    }
+
+    this.storage = new Map();
+  }
+
+  /**
+   * This method is called by the `instanceof` operator.
+   * @return {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|string} 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;
+  }
 }
 
 /**
@@ -223,34 +232,35 @@ class Translations extends Base {
  * @throws {Error} Missing translations.
  */
 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 the element with translations. Add the translation 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.");
+  const d = getDocument();
+
+  if (!(element instanceof HTMLElement)) {
+    element = d.querySelector(
+      `[${ATTRIBUTE_OBJECTLINK}~="${translationsLinkSymbol.toString()}"]`,
+    );
+
+    if (element === null) {
+      throw new Error(
+        "Cannot find the element with translations. Add the translation 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/types/version.mjs

@@ -156,7 +156,7 @@ function getMonsterVersion() {
 	}
 
 	/** don't touch, replaced by make with package.json version */
-	monsterVersion = new Version("4.38.0");
+	monsterVersion = new Version("4.38.3");
 
 	return monsterVersion;
 }

package/test/cases/monster.mjs

@@ -7,7 +7,7 @@ describe('Monster', function () {
         let monsterVersion
 
         /** don´t touch, replaced by make with package.json version */
-        monsterVersion = new Version("4.38.0")
+        monsterVersion = new Version("4.38.3")
 
         let m = getMonsterVersion();
 

package/test/web/test.html

@@ -9,8 +9,8 @@
 </head>
 <body>
 <div id="headline" style="display: flex;align-items: center;justify-content: center;flex-direction: column;">
-  <h1 style='margin-bottom: 0.1em;'>Monster 4.38.0</h1>
-  <div id="lastupdate" style='font-size:0.7em'>last update Mi 23. Jul 15:15:52 CEST 2025</div>
+  <h1 style='margin-bottom: 0.1em;'>Monster 4.38.3</h1>
+  <div id="lastupdate" style='font-size:0.7em'>last update Sa 2. Aug 18:50:27 CEST 2025</div>
 </div>
 <div id="mocha-errors"
      style="color: red;font-weight: bold;display: flex;align-items: center;justify-content: center;flex-direction: column;margin:20px;"></div>