@schukai/monster 3.65.0 → 3.65.21

package/source/dom/template.mjs

@@ -1,17 +1,26 @@
 /**
- * Copyright schukai GmbH and contributors 2023. All Rights Reserved.
+ * Copyright © schukai GmbH and all contributing authors, {{copyRightYear}}. All rights reserved.
  * Node module: @schukai/monster
- * This file is licensed under the AGPLv3 License.
- * License text available at https://www.gnu.org/licenses/agpl-3.0.en.html
+ *
+ * This source code is licensed under the GNU Affero General Public License version 3 (AGPLv3).
+ * The full text of the license can be found at: https://www.gnu.org/licenses/agpl-3.0.en.html
+ *
+ * For those who do not wish to adhere to the AGPLv3, a commercial license is available.
+ * Acquiring a commercial license allows you to use this software without complying with the AGPLv3 terms.
+ * For more information about purchasing a commercial license, please contact schukai GmbH.
+ *
+ * SPDX-License-Identifier: AGPL-3.0
  */
 
-import { Base } from "../types/base.mjs";
-import { getGlobalFunction, getGlobalObject } from "../types/global.mjs";
-import { validateInstance, validateString } from "../types/validate.mjs";
-import { ATTRIBUTE_TEMPLATE_PREFIX } from "./constants.mjs";
-import { getDocumentTheme } from "./theme.mjs";
-import { instanceSymbol } from "../constants.mjs";
-export { Template };
+import {Base} from "../types/base.mjs";
+import {getGlobalFunction, getGlobalObject} from "../types/global.mjs";
+import {validateInstance, validateString} from "../types/validate.mjs";
+import {ATTRIBUTE_TEMPLATE_PREFIX} from "./constants.mjs";
+import {getDocumentTheme} from "./theme.mjs";
+import {instanceSymbol} from "../constants.mjs";
+import {findElementWithIdUpwards} from "./util.mjs";
+
+export {Template};
 
 /**
  * The template class provides methods for creating templates.
@@ -23,45 +32,45 @@ export { Template };
  * @summary A template class
  */
 class Template extends Base {
-	/**
-	 *
-	 * @param {HTMLTemplateElement} template
-	 * @throws {TypeError} value is not an instance of
-	 * @throws {TypeError} value is not a function
-	 * @throws {Error} the function is not defined
-	 */
-	constructor(template) {
-		super();
-		const HTMLTemplateElement = getGlobalFunction("HTMLTemplateElement");
-		validateInstance(template, HTMLTemplateElement);
-		this.template = template;
-	}
-
-	/**
-	 * This method is called by the `instanceof` operator.
-	 * @returns {symbol}
-	 * @since 2.1.0
-	 */
-	static get [instanceSymbol]() {
-		return Symbol.for("@schukai/monster/dom/resource/template");
-	}
-
-	/**
-	 *
-	 * @returns {HTMLTemplateElement}
-	 */
-	getTemplateElement() {
-		return this.template;
-	}
-
-	/**
-	 *
-	 * @return {DocumentFragment}
-	 * @throws {TypeError} value is not an instance of
-	 */
-	createDocumentFragment() {
-		return this.template.content.cloneNode(true);
-	}
+    /**
+     *
+     * @param {HTMLTemplateElement} template
+     * @throws {TypeError} value is not an instance of
+     * @throws {TypeError} value is not a function
+     * @throws {Error} the function is not defined
+     */
+    constructor(template) {
+        super();
+        const HTMLTemplateElement = getGlobalFunction("HTMLTemplateElement");
+        validateInstance(template, HTMLTemplateElement);
+        this.template = template;
+    }
+
+    /**
+     * This method is called by the `instanceof` operator.
+     * @returns {symbol}
+     * @since 2.1.0
+     */
+    static get [instanceSymbol]() {
+        return Symbol.for("@schukai/monster/dom/resource/template");
+    }
+
+    /**
+     *
+     * @returns {HTMLTemplateElement}
+     */
+    getTemplateElement() {
+        return this.template;
+    }
+
+    /**
+     *
+     * @return {DocumentFragment}
+     * @throws {TypeError} value is not an instance of
+     */
+    createDocumentFragment() {
+        return this.template.content.cloneNode(true);
+    }
 }
 
 /**
@@ -128,91 +137,70 @@ class Template extends Base {
  * @throws {TypeError} value is not a string
  */
 export function findDocumentTemplate(id, currentNode) {
-	validateString(id);
-
-	const document = getGlobalObject("document");
-	const HTMLTemplateElement = getGlobalFunction("HTMLTemplateElement");
-	const DocumentFragment = getGlobalFunction("DocumentFragment");
-	const Document = getGlobalFunction("Document");
-
-	let prefixID;
-
-	if (
-		!(
-			currentNode instanceof Document || currentNode instanceof DocumentFragment
-		)
-	) {
-		if (currentNode instanceof Node) {
-			if (currentNode.hasAttribute(ATTRIBUTE_TEMPLATE_PREFIX)) {
-				prefixID = currentNode.getAttribute(ATTRIBUTE_TEMPLATE_PREFIX);
-			}
-
-			currentNode = currentNode.getRootNode();
-
-			if (
-				!(
-					currentNode instanceof Document ||
-					currentNode instanceof DocumentFragment
-				)
-			) {
-				currentNode = currentNode.ownerDocument;
-			}
-		}
-
-		if (
-			!(
-				currentNode instanceof Document ||
-				currentNode instanceof DocumentFragment
-			)
-		) {
-			currentNode = document;
-		}
-	}
-
-	let template;
-	const theme = getDocumentTheme();
-
-	if (prefixID) {
-		const themedPrefixID = `${prefixID}-${id}-${theme.getName()}`;
-
-		// current + themedPrefixID
-		template = currentNode.getElementById(themedPrefixID);
-		if (template instanceof HTMLTemplateElement) {
-			return new Template(template);
-		}
-
-		// document + themedPrefixID
-		template = document.getElementById(themedPrefixID);
-		if (template instanceof HTMLTemplateElement) {
-			return new Template(template);
-		}
-	}
-
-	const themedID = `${id}-${theme.getName()}`;
-
-	// current + themedID
-	template = currentNode.getElementById(themedID);
-	if (template instanceof HTMLTemplateElement) {
-		return new Template(template);
-	}
-
-	// document + themedID
-	template = document.getElementById(themedID);
-	if (template instanceof HTMLTemplateElement) {
-		return new Template(template);
-	}
-
-	// current + ID
-	template = currentNode.getElementById(id);
-	if (template instanceof HTMLTemplateElement) {
-		return new Template(template);
-	}
-
-	// document + ID
-	template = document.getElementById(id);
-	if (template instanceof HTMLTemplateElement) {
-		return new Template(template);
-	}
-
-	throw new Error(`template ${id} not found.`);
+    validateString(id);
+
+    const document = getGlobalObject("document");
+    const HTMLTemplateElement = getGlobalFunction("HTMLTemplateElement");
+    const DocumentFragment = getGlobalFunction("DocumentFragment");
+    const Document = getGlobalFunction("Document");
+
+    let prefixID;
+
+    if (
+        !(
+            currentNode instanceof Document || currentNode instanceof DocumentFragment
+        )
+    ) {
+        if (currentNode instanceof Node) {
+            if (currentNode.hasAttribute(ATTRIBUTE_TEMPLATE_PREFIX)) {
+                prefixID = currentNode.getAttribute(ATTRIBUTE_TEMPLATE_PREFIX);
+            }
+
+            currentNode = currentNode.getRootNode();
+
+            if (
+                !(
+                    currentNode instanceof Document ||
+                    currentNode instanceof DocumentFragment
+                )
+            ) {
+                currentNode = currentNode.ownerDocument;
+            }
+        }
+
+        if (
+            !(
+                currentNode instanceof Document ||
+                currentNode instanceof DocumentFragment
+            )
+        ) {
+            currentNode = document;
+        }
+    }
+
+    let template;
+    const theme = getDocumentTheme();
+
+    if (prefixID) {
+        const themedPrefixID = `${prefixID}-${id}-${theme.getName()}`;
+
+        template = findElementWithIdUpwards(currentNode, themedPrefixID);
+        if (template instanceof HTMLTemplateElement) {
+            return new Template(template);
+        }
+    }
+
+    const themedID = `${id}-${theme.getName()}`;
+
+    template = findElementWithIdUpwards(currentNode, themedID);
+    if (template instanceof HTMLTemplateElement) {
+        return new Template(template);
+    }
+
+    template = findElementWithIdUpwards(currentNode, id);
+    if (template instanceof HTMLTemplateElement) {
+        return new Template(template);
+    }
+
+    throw new Error(`template ${id} not found.`);
 }

package/source/dom/theme.mjs

@@ -1,8 +1,15 @@
 /**
- * Copyright schukai GmbH and contributors 2023. All Rights Reserved.
+ * Copyright © schukai GmbH and all contributing authors, {{copyRightYear}}. All rights reserved.
  * Node module: @schukai/monster
- * This file is licensed under the AGPLv3 License.
- * License text available at https://www.gnu.org/licenses/agpl-3.0.en.html
+ *
+ * This source code is licensed under the GNU Affero General Public License version 3 (AGPLv3).
+ * The full text of the license can be found at: https://www.gnu.org/licenses/agpl-3.0.en.html
+ *
+ * For those who do not wish to adhere to the AGPLv3, a commercial license is available.
+ * Acquiring a commercial license allows you to use this software without complying with the AGPLv3 terms.
+ * For more information about purchasing a commercial license, please contact schukai GmbH.
+ *
+ * SPDX-License-Identifier: AGPL-3.0
  */
 
 import { Base } from "../types/base.mjs";

package/source/dom/updater.mjs

@@ -1,8 +1,15 @@
 /**
- * Copyright schukai GmbH and contributors 2023. All Rights Reserved.
+ * Copyright © schukai GmbH and all contributing authors, {{copyRightYear}}. All rights reserved.
  * Node module: @schukai/monster
- * This file is licensed under the AGPLv3 License.
- * License text available at https://www.gnu.org/licenses/agpl-3.0.en.html
+ *
+ * This source code is licensed under the GNU Affero General Public License version 3 (AGPLv3).
+ * The full text of the license can be found at: https://www.gnu.org/licenses/agpl-3.0.en.html
+ *
+ * For those who do not wish to adhere to the AGPLv3, a commercial license is available.
+ * Acquiring a commercial license allows you to use this software without complying with the AGPLv3 terms.
+ * For more information about purchasing a commercial license, please contact schukai GmbH.
+ *
+ * SPDX-License-Identifier: AGPL-3.0
  */
 
 import { internalSymbol } from "../constants.mjs";

package/source/dom/util/extract-keys.mjs

@@ -1,8 +1,15 @@
 /**
- * Copyright schukai GmbH and contributors 2023. All Rights Reserved.
+ * Copyright © schukai GmbH and all contributing authors, {{copyRightYear}}. All rights reserved.
  * Node module: @schukai/monster
- * This file is licensed under the AGPLv3 License.
- * License text available at https://www.gnu.org/licenses/agpl-3.0.en.html
+ *
+ * This source code is licensed under the GNU Affero General Public License version 3 (AGPLv3).
+ * The full text of the license can be found at: https://www.gnu.org/licenses/agpl-3.0.en.html
+ *
+ * For those who do not wish to adhere to the AGPLv3, a commercial license is available.
+ * Acquiring a commercial license allows you to use this software without complying with the AGPLv3 terms.
+ * For more information about purchasing a commercial license, please contact schukai GmbH.
+ *
+ * SPDX-License-Identifier: AGPL-3.0
  */
 
 export { extractKeys };

package/source/dom/util/init-options-from-attributes.mjs

@@ -1,22 +1,29 @@
 /**
- * Copyright schukai GmbH and contributors 2023. All Rights Reserved.
+ * Copyright © schukai GmbH and all contributing authors, {{copyRightYear}}. All rights reserved.
  * Node module: @schukai/monster
- * This file is licensed under the AGPLv3 License.
- * License text available at https://www.gnu.org/licenses/agpl-3.0.en.html
+ *
+ * This source code is licensed under the GNU Affero General Public License version 3 (AGPLv3).
+ * The full text of the license can be found at: https://www.gnu.org/licenses/agpl-3.0.en.html
+ *
+ * For those who do not wish to adhere to the AGPLv3, a commercial license is available.
+ * Acquiring a commercial license allows you to use this software without complying with the AGPLv3 terms.
+ * For more information about purchasing a commercial license, please contact schukai GmbH.
+ *
+ * SPDX-License-Identifier: AGPL-3.0
  */
 
-import {Pathfinder} from "../../data/pathfinder.mjs";
+import { Pathfinder } from "../../data/pathfinder.mjs";
 import {
-    isBoolean,
-    isString,
-    isObject,
-    isArray,
-    isFunction,
-    isInteger,
+	isBoolean,
+	isString,
+	isObject,
+	isArray,
+	isFunction,
+	isInteger,
 } from "../../types/is.mjs";
-import {extractKeys} from "./extract-keys.mjs";
+import { extractKeys } from "./extract-keys.mjs";
 
-export {initOptionsFromAttributes};
+export { initOptionsFromAttributes };
 
 /**
  * Initializes the given options object based on the attributes of the current DOM element.
@@ -28,7 +35,7 @@ export {initOptionsFromAttributes};
  * For example, the attribute 'data-monster-option-foo' maps to the 'bar' property in the options object.
  *
  * The mapping object would look like this:
- * 
+ *
  * {
  *    'foo': (value) => value + 'bar'
  *    // the value of the attribute 'data-monster-option-foo' is appended with 'bar'
@@ -39,7 +46,7 @@ export {initOptionsFromAttributes};
  *    // and assigned to the 'bar.baz' property in the options object.
  *    // e.g. <div data-monster-option-bar-baz="foo"></div>
  * }
- * 
+ *
  * Array values have to be separated by '::'.
  *
  * @since 3.38.0
@@ -51,60 +58,60 @@ export {initOptionsFromAttributes};
  * @this HTMLElement - The context of the DOM element.
  */
 function initOptionsFromAttributes(
-    element,
-    options,
-    mapping = {},
-    prefix = "data-monster-option-",
+	element,
+	options,
+	mapping = {},
+	prefix = "data-monster-option-",
 ) {
-    if (!(element instanceof HTMLElement)) return options;
-    if (!element.hasAttributes()) return options;
+	if (!(element instanceof HTMLElement)) return options;
+	if (!element.hasAttributes()) return options;
 
-    const keyMap = extractKeys(options);
-    const finder = new Pathfinder(options);
+	const keyMap = extractKeys(options);
+	const finder = new Pathfinder(options);
 
-    element.getAttributeNames().forEach((name) => {
-        if (!name.startsWith(prefix)) return;
+	element.getAttributeNames().forEach((name) => {
+		if (!name.startsWith(prefix)) return;
 
-        // check if the attribute name is a valid option.
-        // the mapping between the attribute is simple. The dash is replaced by a dot.
-        // e.g. data-monster-url => url
-        const optionName = keyMap.get(name.substring(prefix.length).toLowerCase());
-        if (!finder.exists(optionName)) return;
+		// check if the attribute name is a valid option.
+		// the mapping between the attribute is simple. The dash is replaced by a dot.
+		// e.g. data-monster-url => url
+		const optionName = keyMap.get(name.substring(prefix.length).toLowerCase());
+		if (!finder.exists(optionName)) return;
 
-        if (element.hasAttribute(name)) {
-            let value = element.getAttribute(name);
-            if (
-                mapping.hasOwnProperty(optionName) &&
-                isFunction(mapping[optionName])
-            ) {
-                value = mapping[optionName](value);
-            }
+		if (element.hasAttribute(name)) {
+			let value = element.getAttribute(name);
+			if (
+				mapping.hasOwnProperty(optionName) &&
+				isFunction(mapping[optionName])
+			) {
+				value = mapping[optionName](value);
+			}
 
-            let optionValue = finder.getVia(optionName);
-            if (optionValue === null || optionValue === undefined) {
-             	optionValue = value;
-            }
+			let optionValue = finder.getVia(optionName);
+			if (optionValue === null || optionValue === undefined) {
+				optionValue = value;
+			}
 
-            //const typeOfOptionValue = typeof optionValue;
-            if (optionValue === null || optionValue === undefined) {
-                value = null;
-            } else if (isBoolean(optionValue)) {
-                value = value === "true";
-            } else if (isInteger(optionValue)) {
-                value = Number(value);
-            } else if (isString(optionValue)) {
-                value = String(value);
-            } else if (isObject(optionValue)) {
-                value = JSON.parse(value);
-            } else if (isArray(optionValue)) {
-                value = value.split("::");
-            } else {
-                value = optionValue;
-            }
+			//const typeOfOptionValue = typeof optionValue;
+			if (optionValue === null || optionValue === undefined) {
+				value = null;
+			} else if (isBoolean(optionValue)) {
+				value = value === "true";
+			} else if (isInteger(optionValue)) {
+				value = Number(value);
+			} else if (isString(optionValue)) {
+				value = String(value);
+			} else if (isObject(optionValue)) {
+				value = JSON.parse(value);
+			} else if (isArray(optionValue)) {
+				value = value.split("::");
+			} else {
+				value = optionValue;
+			}
 
-            finder.setVia(optionName, value);
-        }
-    });
+			finder.setVia(optionName, value);
+		}
+	});
 
-    return options;
+	return options;
 }

package/source/dom/util/set-option-from-attribute.mjs

@@ -1,8 +1,15 @@
 /**
- * Copyright schukai GmbH and contributors 2023. All Rights Reserved.
+ * Copyright © schukai GmbH and all contributing authors, {{copyRightYear}}. All rights reserved.
  * Node module: @schukai/monster
- * This file is licensed under the AGPLv3 License.
- * License text available at https://www.gnu.org/licenses/agpl-3.0.en.html
+ *
+ * This source code is licensed under the GNU Affero General Public License version 3 (AGPLv3).
+ * The full text of the license can be found at: https://www.gnu.org/licenses/agpl-3.0.en.html
+ *
+ * For those who do not wish to adhere to the AGPLv3, a commercial license is available.
+ * Acquiring a commercial license allows you to use this software without complying with the AGPLv3 terms.
+ * For more information about purchasing a commercial license, please contact schukai GmbH.
+ *
+ * SPDX-License-Identifier: AGPL-3.0
  */
 
 import { Pathfinder } from "../../data/pathfinder.mjs";

package/source/dom/util.mjs

@@ -1,8 +1,15 @@
 /**
- * Copyright schukai GmbH and contributors 2023. All Rights Reserved.
+ * Copyright © schukai GmbH and all contributing authors, {{copyRightYear}}. All rights reserved.
  * Node module: @schukai/monster
- * This file is licensed under the AGPLv3 License.
- * License text available at https://www.gnu.org/licenses/agpl-3.0.en.html
+ *
+ * This source code is licensed under the GNU Affero General Public License version 3 (AGPLv3).
+ * The full text of the license can be found at: https://www.gnu.org/licenses/agpl-3.0.en.html
+ *
+ * For those who do not wish to adhere to the AGPLv3, a commercial license is available.
+ * Acquiring a commercial license allows you to use this software without complying with the AGPLv3 terms.
+ * For more information about purchasing a commercial license, please contact schukai GmbH.
+ *
+ * SPDX-License-Identifier: AGPL-3.0
  */
 
 import { getGlobal } from "../types/global.mjs";
@@ -191,7 +198,7 @@ function findElementWithIdUpwards(element, targetId) {
 	}
 
 	// If the current element is the document.documentElement, search within the main document
-	if (element === document.documentElement) {
+	if (element === document.documentElement || element === document) {
 		const target = document.getElementById(targetId);
 		if (target) {
 			return target;

package/source/dom/worker/factory.mjs

@@ -1,8 +1,15 @@
 /**
- * Copyright schukai GmbH and contributors 2023. All Rights Reserved.
+ * Copyright © schukai GmbH and all contributing authors, {{copyRightYear}}. All rights reserved.
  * Node module: @schukai/monster
- * This file is licensed under the AGPLv3 License.
- * License text available at https://www.gnu.org/licenses/agpl-3.0.en.html
+ *
+ * This source code is licensed under the GNU Affero General Public License version 3 (AGPLv3).
+ * The full text of the license can be found at: https://www.gnu.org/licenses/agpl-3.0.en.html
+ *
+ * For those who do not wish to adhere to the AGPLv3, a commercial license is available.
+ * Acquiring a commercial license allows you to use this software without complying with the AGPLv3 terms.
+ * For more information about purchasing a commercial license, please contact schukai GmbH.
+ *
+ * SPDX-License-Identifier: AGPL-3.0
  */
 
 import { internalSymbol } from "../../constants.mjs";

package/source/i18n/formatter.mjs

@@ -1,8 +1,15 @@
 /**
- * Copyright schukai GmbH and contributors 2023. All Rights Reserved.
+ * Copyright © schukai GmbH and all contributing authors, {{copyRightYear}}. All rights reserved.
  * Node module: @schukai/monster
- * This file is licensed under the AGPLv3 License.
- * License text available at https://www.gnu.org/licenses/agpl-3.0.en.html
+ *
+ * This source code is licensed under the GNU Affero General Public License version 3 (AGPLv3).
+ * The full text of the license can be found at: https://www.gnu.org/licenses/agpl-3.0.en.html
+ *
+ * For those who do not wish to adhere to the AGPLv3, a commercial license is available.
+ * Acquiring a commercial license allows you to use this software without complying with the AGPLv3 terms.
+ * For more information about purchasing a commercial license, please contact schukai GmbH.
+ *
+ * SPDX-License-Identifier: AGPL-3.0
  */
 
 import { instanceSymbol, internalSymbol } from "../constants.mjs";

package/source/i18n/locale.mjs

@@ -1,8 +1,15 @@
 /**
- * Copyright schukai GmbH and contributors 2023. All Rights Reserved.
+ * Copyright © schukai GmbH and all contributing authors, {{copyRightYear}}. All rights reserved.
  * Node module: @schukai/monster
- * This file is licensed under the AGPLv3 License.
- * License text available at https://www.gnu.org/licenses/agpl-3.0.en.html
+ *
+ * This source code is licensed under the GNU Affero General Public License version 3 (AGPLv3).
+ * The full text of the license can be found at: https://www.gnu.org/licenses/agpl-3.0.en.html
+ *
+ * For those who do not wish to adhere to the AGPLv3, a commercial license is available.
+ * Acquiring a commercial license allows you to use this software without complying with the AGPLv3 terms.
+ * For more information about purchasing a commercial license, please contact schukai GmbH.
+ *
+ * SPDX-License-Identifier: AGPL-3.0
  */
 
 import { instanceSymbol } from "../constants.mjs";

package/source/i18n/provider.mjs

@@ -1,8 +1,15 @@
 /**
- * Copyright schukai GmbH and contributors 2023. All Rights Reserved.
+ * Copyright © schukai GmbH and all contributing authors, {{copyRightYear}}. All rights reserved.
  * Node module: @schukai/monster
- * This file is licensed under the AGPLv3 License.
- * License text available at https://www.gnu.org/licenses/agpl-3.0.en.html
+ *
+ * This source code is licensed under the GNU Affero General Public License version 3 (AGPLv3).
+ * The full text of the license can be found at: https://www.gnu.org/licenses/agpl-3.0.en.html
+ *
+ * For those who do not wish to adhere to the AGPLv3, a commercial license is available.
+ * Acquiring a commercial license allows you to use this software without complying with the AGPLv3 terms.
+ * For more information about purchasing a commercial license, please contact schukai GmbH.
+ *
+ * SPDX-License-Identifier: AGPL-3.0
  */
 
 import { instanceSymbol } from "../constants.mjs";

package/source/i18n/providers/embed.mjs

@@ -1,8 +1,15 @@
 /**
- * Copyright schukai GmbH and contributors 2023. All Rights Reserved.
+ * Copyright © schukai GmbH and all contributing authors, {{copyRightYear}}. All rights reserved.
  * Node module: @schukai/monster
- * This file is licensed under the AGPLv3 License.
- * License text available at https://www.gnu.org/licenses/agpl-3.0.en.html
+ *
+ * This source code is licensed under the GNU Affero General Public License version 3 (AGPLv3).
+ * The full text of the license can be found at: https://www.gnu.org/licenses/agpl-3.0.en.html
+ *
+ * For those who do not wish to adhere to the AGPLv3, a commercial license is available.
+ * Acquiring a commercial license allows you to use this software without complying with the AGPLv3 terms.
+ * For more information about purchasing a commercial license, please contact schukai GmbH.
+ *
+ * SPDX-License-Identifier: AGPL-3.0
  */
 
 import { internalSymbol } from "../../constants.mjs";