chore: commit save point

application/example/i18n/formatter.mjs

+import {Formatter} from '@schukai/monster/source/i18n/formatter.mjs';
+import {Translations} from '@schukai/monster/source/i18n/translations.mjs';
+
+const translations = new Translations('en')
+    .assignTranslations({
+        thekey: "${animal} has eaten the ${food}!"
+    });
+
+new Formatter({}, translations).format("thekey:animal=dog::food=cake")
+// ↦ dog has eaten the cake!

application/example/i18n/providers/fetch.mjs

+import {Fetch} from '@schukai/monster/source/i18n/providers/fetch.mjs';
+
+// fetch from API
+const translation = new Fetch('https://example.com/${language}.json').getTranslation('en-GB');
+// ↦ https://example.com/en.json

application/example/i18n/translations.mjs

+import {Translations} from '@schukai/monster/source/i18n/translations.mjs';
+import {parseLocale} from '@schukai/monster/source/i18n/locale.mjs';
+
+const translation = new Translations(parseLocale('en-GB'));
+
+translation.assignTranslations({
+    text1: "click",
+    text2: {
+        'one': 'click once',
+        'other': 'click n times'
+    }
+});
+
+console.log(translation.getText('text1'));
+// ↦ click
+
+console.log(translation.getPluralRuleText('text2', 1));
+// -> click once
+console.log(translation.getPluralRuleText('text2', 2));
+// -> click n times

application/source/i18n/formatter.mjs

-
-
 /**
  * Copyright schukai GmbH and contributors 2022. All Rights Reserved.
  * Node module: @schukai/monster
@@ -7,8 +5,6 @@
  * License text available at https://www.gnu.org/licenses/agpl-3.0.en.html
  */
 
-
-
 import {internalSymbol} from "../constants.mjs";
 import {extend} from "../data/extend.mjs";
 
@@ -27,26 +23,7 @@ const internalTranslationSymbol = Symbol('internalTranslation')
 /**
  * The Formatter extends the Text.Formatter with the possibility to replace the key by a translation.
  *
- * ```
- * <script type="module">
- * import {Formatter} from '@schukai/monster/source/i18n/formatter.mjs';
- * new Formatter()
- * </script>
- * ```
- *
- * @example
- *
- * import {Formatter} from '@schukai/monster/source/i18n/formatter.mjs';
- * import {Translations} from '@schukai/monster/source/i18n/translations.mjs';
- *
- * const translations = new Translations('en')
- *     .assignTranslations({
- *         thekey: "${animal} has eaten the ${food}!"
- *     });
- *
- * new Formatter({}, translations).format("thekey:animal=dog::food=cake")
- * // ↦ dog has eaten the cake!
- *
+ * @externalExample ../../example/i18n/formatter.mjs
  * @license AGPLv3
  * @since 1.26.0
  * @copyright schukai GmbH
@@ -115,7 +92,6 @@ class Formatter extends TextFormatter {
             }
         }
         
-
         const parts = validateString(text).split('::')
         const translationKey = parts.shift().trim(); // key value delimiter
         const parameter = parts.join('::').trim();

application/source/i18n/locale.mjs

-
-
 /**
  * Copyright schukai GmbH and contributors 2022. All Rights Reserved.
  * Node module: @schukai/monster
@@ -7,7 +5,6 @@
  * License text available at https://www.gnu.org/licenses/agpl-3.0.en.html
  */
 
-
 import {Base} from "../types/base.mjs";
 import {validateString} from "../types/validate.mjs";
 import {clone} from "../util/clone.mjs";
@@ -29,13 +26,6 @@ const localeStringSymbol = Symbol('localeString');
 /**
  * The Locale class is a base class for the language classes.
  *
- * ```
- * <script type="module">
- * import {Locale} from '@schukai/monster/source/i18n/locale.mjs';
- * new Locale()
- * </script>
- * ```
- *
  * RFC
  *
  * ```

application/source/i18n/namespace.mjs

-
-
 /**
  * In this namespace you will find classes and methods for handling locale and localized texts.
  *

application/source/i18n/provider.mjs

-
-
 /**
  * Copyright schukai GmbH and contributors 2022. All Rights Reserved.
  * Node module: @schukai/monster
@@ -7,7 +5,6 @@
  * License text available at https://www.gnu.org/licenses/agpl-3.0.en.html
  */
 
-
 import {BaseWithOptions} from "../types/basewithoptions.mjs";
 import {Locale} from "./locale.mjs"
 import {Translations} from "./translations.mjs"
@@ -17,13 +14,6 @@ export {Provider}
 /**
  * A provider makes a translation object available.
  *
- * ```
- * <script type="module">
- * import {Provider} from '@schukai/monster/source/i18n/provider.mjs';
- * new Provider()
- * </script>
- * ```
- *
  * @license AGPLv3
  * @since 1.13.0
  * @copyright schukai GmbH

application/source/i18n/providers/fetch.mjs

-
-
 /**
  * Copyright schukai GmbH and contributors 2022. All Rights Reserved.
  * Node module: @schukai/monster
@@ -7,7 +5,6 @@
  * License text available at https://www.gnu.org/licenses/agpl-3.0.en.html
  */
 
-
 import {internalSymbol} from "../../constants.mjs";
 import {extend} from "../../data/extend.mjs";
 import {Formatter} from "../../text/formatter.mjs";
@@ -23,21 +20,7 @@ export {Fetch}
 /**
  * The fetch provider retrieves a JSON file from the given URL and returns a translation object.
  * 
- * ```
- * <script type="module">
- * import {Fetch} from '@schukai/monster/source/i18n/providers/fetch.mjs';
- * new Fetch()
- * </script>
- * ```
- * 
- * @example <caption>das ist ein test</caption>
- * 
- * import {Fetch} from '@schukai/monster/source/i18n/providers/fetch.mjs';
- * 
- * // fetch from API
- * const translation = new Fetch('https://example.com/${language}.json').getTranslation('en-GB');
- * // ↦ https://example.com/en.json
- *
+ * @externalExample ../../example/i18n/providers/fetch.mjs
  * @license AGPLv3
  * @since 1.13.0
  * @copyright schukai GmbH

application/source/i18n/providers/namespace.mjs

-
-
 /**
  * In this namespace you will find classes and methods for handling locale and localized texts.
  *

application/source/i18n/translations.mjs

-
-
 /**
  * Copyright schukai GmbH and contributors 2022. All Rights Reserved.
  * Node module: @schukai/monster
@@ -7,7 +5,6 @@
  * License text available at https://www.gnu.org/licenses/agpl-3.0.en.html
  */
 
-
 import {Base} from "../types/base.mjs";
 import {isObject, isString} from "../types/is.mjs";
 import {validateInstance, validateInteger, validateObject, validateString} from "../types/validate.mjs";
@@ -18,36 +15,7 @@ export {Translations}
 /**
  * With this class you can manage translations and access the keys.
  *
- * ```
- * <script type="module">
- * import {Translations} from '@schukai/monster/source/i18n/translations.mjs';
- * new Translations()
- * </script>
- * ```
- *
- * @example
- *
- * import {Translations} from '@schukai/monster/source/i18n/translations.mjs';
- * import {parseLocale} from '@schukai/monster/source/i18n/locale.mjs';
- *
- * const translation = new Translations(parseLocale('en-GB'));
- *
- * translation.assignTranslations({
- *           text1: "click",
- *           text2: {
- *             'one': 'click once',
- *             'other': 'click n times'
- *           }
- *        });
- *
- * console.log(translation.getText('text1'));
- * // ↦ click
- *
- * console.log(translation.getPluralRuleText('text2',1));
- * // -> click once
- * console.log(translation.getPluralRuleText('text2',2));
- * // -> click n times
- *
+ * @externalExample ../../example/i18n/translations.mjs
  * @license AGPLv3
  * @since 1.13.0
  * @copyright schukai GmbH