@schukai/monster 3.80.0 → 3.80.2

package/source/components/tree-menu/tree-menu.mjs

@@ -73,32 +73,9 @@ const openEntryEventHandlerSymbol = Symbol("openEntryEventHandler");
 /**
  * TreeMenu
  *
- * <img src="./images/tree-menu.png">
- *
- * You can create this control either by specifying the HTML tag `<monster-tree-menu />` directly in the HTML
- *
- * ```html
- * <monster-tree-menu></monster-tree-menu>
- * ```
- *
- * or using Javascript via the `document.createElement('monster-tree-menu');` method.
- *
- * ```javascript
- * import {TreeMenu} from 'https://cdn.jsdelivr.net/npm/@schukai/component-treemenu@0.1.0/dist/modules/treemenu.js';
- * document.createElement('monster-treemenu');
- * ```
- *
- * @startuml tree-menu.png
- * skinparam monochrome true
- * skinparam shadowing false
- * HTMLElement <|-- CustomElement
- * CustomElement <|-- CustomControl
- * CustomControl <|-- TreeMenu
- * @enduml
  * @since 1.0.0
- * @copyright schukai GmbH
  * @summary A TreeMenu control
- * @fires Monster.Components.TreeMenu.event:monster-fetched
+ * @fires monster-fetched
  */
 class TreeMenu extends CustomElement {
 	/**

package/source/data/datasource/server/restapi/data-fetch-error.mjs

@@ -41,7 +41,6 @@ class DataFetchError extends Error {
 	/**
 	 * This method is called by the `instanceof` operator.
 	 * @returns {symbol}
-	 * @since 2.1.0
 	 */
 	static get [instanceSymbol]() {
 		return Symbol.for(

package/source/dom/customcontrol.mjs

@@ -32,8 +32,6 @@ const attachedInternalSymbol = Symbol("attachedInternal");
  * After defining a `CustomElement`, the `registerCustomElement` method must be called with the new class name. Only then
  * will the tag defined via the `getTag` method be made known to the DOM.
  *
- * <img src="./images/custom-control.png">
- *
  * This control uses `attachInternals()` to integrate the control into a form. If the target environment does not support
  * this method, the [polyfill](https://www.npmjs.com/package/element-internals-polyfill) can be used.
  *
@@ -48,18 +46,9 @@ const attachedInternalSymbol = Symbol("attachedInternal");
  *
  * Read the HTML specification for Custom Element Reactions: {@link https://html.spec.whatwg.org/dev/custom-elements.html#custom-element-reactions|Custom Element Reactions}.
  *
- * @startuml custom-control.png
- * skinparam monochrome true
- * skinparam shadowing false
- * HTMLElement <|-- CustomElement
- * CustomElement <|-- CustomControl
- * @enduml
  * @summary A base class for custom controls based on CustomElement.
- * @copyright schukai GmbH
  * @license AGPLv3
  * @since 1.14.0
- * @memberOf Monster.DOM
- * @extends Monster.DOM.CustomElement
  */
 class CustomControl extends CustomElement {
 	/**
@@ -74,7 +63,6 @@ class CustomControl extends CustomElement {
 	 *
 	 * @inheritdoc
 	 * @throws {Error} the ElementInternals is not supported and a polyfill is necessary
-	 * @since 1.7.0
 	 */
 	constructor() {
 		super();
@@ -117,14 +105,12 @@ class CustomControl extends CustomElement {
 	 *
 	 * @see [attachInternals()]{@link https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/attachInternals}
 	 * @see [Custom Elements Face Example]{@link https://html.spec.whatwg.org/multipage/custom-elements.html#custom-elements-face-example}
-	 * @since 1.14.0
 	 * @return {boolean}
 	 */
 	static formAssociated = true;
 
 	/**
 	 * @inheritdoc
-	 * @since 1.14.0
 	 **/
 	get defaults() {
 		return extend({}, super.defaults);
@@ -135,7 +121,6 @@ class CustomControl extends CustomElement {
 	 *
 	 * This is a method of [internal API](https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals), which is a part of the web standard for custom elements.
 	 *
-	 * @since 1.14.0
 	 * @throws {Error} the value getter must be overwritten by the derived class
 	 */
 	get value() {
@@ -148,7 +133,6 @@ class CustomControl extends CustomElement {
 	 * This is a method of [internal API](https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals), which is a part of the web standard for custom elements.
 	 *
 	 * @param {*} value The value to set.
-	 * @since 1.14.0
 	 * @throws {Error} the value setter must be overwritten by the derived class
 	 */
 	set value(value) {
@@ -159,7 +143,6 @@ class CustomControl extends CustomElement {
 	 * This is a method of [internal api](https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals)
 	 *
 	 * @return {NodeList}
-	 * @since 1.14.0
 	 * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/labels}
 	 * @throws {Error} the ElementInternals is not supported and a polyfill is necessary
 	 */
@@ -201,7 +184,6 @@ class CustomControl extends CustomElement {
 	 * This is a method of [internal api](https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals)
 	 *
 	 * @return {string}
-	 * @since 1.14.0
 	 * @see https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/validationMessage
 	 * @throws {Error} the ElementInternals is not supported and a polyfill is necessary
 	 */
@@ -213,7 +195,6 @@ class CustomControl extends CustomElement {
 	 * This is a method of [internal api](https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals)
 	 *
 	 * @return {boolean}
-	 * @since 1.14.0
 	 * @see https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/willValidate
 	 * @throws {Error} the ElementInternals is not supported and a polyfill is necessary
 	 */
@@ -225,7 +206,6 @@ class CustomControl extends CustomElement {
 	 * This is a method of [internal api](https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals)
 	 *
 	 * @return {boolean}
-	 * @since 1.14.0
 	 * @see https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/states
 	 * @throws {Error} the ElementInternals is not supported and a polyfill is necessary
 	 */
@@ -237,7 +217,6 @@ class CustomControl extends CustomElement {
 	 * This is a method of [internal api](https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals)
 	 *
 	 * @return {HTMLFontElement|null}
-	 * @since 1.14.0
 	 * @see https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/form
 	 * @throws {Error} the ElementInternals is not supported and a polyfill is necessary
 	 */
@@ -259,7 +238,6 @@ class CustomControl extends CustomElement {
 	 *
 	 * @param {File|string|FormData} value
 	 * @param {File|string|FormData} state
-	 * @since 1.14.0
 	 * @return {undefined}
 	 * @throws {DOMException} NotSupportedError
 	 * @throws {Error} the ElementInternals is not supported and a polyfill is necessary
@@ -275,7 +253,6 @@ class CustomControl extends CustomElement {
 	 * @param {string|undefined} message
 	 * @param {HTMLElement} anchor
 	 * @see https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/setValidity
-	 * @since 1.14.0
 	 * @return {undefined}
 	 * @throws {DOMException} NotSupportedError
 	 * @throws {Error} the ElementInternals is not supported and a polyfill is necessary
@@ -288,7 +265,6 @@ class CustomControl extends CustomElement {
 	 * This is a method of [internal api](https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals)
 	 *
 	 * @see https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/checkValidity
-	 * @since 1.14.0
 	 * @return {boolean}
 	 * @throws {DOMException} NotSupportedError
 	 * @throws {Error} the ElementInternals is not supported and a polyfill is necessary
@@ -301,7 +277,6 @@ class CustomControl extends CustomElement {
 	 * This is a method of [internal api](https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals)
 	 *
 	 * @return {boolean}
-	 * @since 1.14.0
 	 * @see https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/reportValidity
 	 * @throws {Error} the ElementInternals is not supported and a polyfill is necessary
 	 * @throws {DOMException} NotSupportedError

package/source/dom/customelement.mjs

@@ -170,10 +170,6 @@ const scriptHostElementSymbol = Symbol("scriptHostElement");
  *
  * You can create an instance of the object via the `document.createElement()` function.
  *
- * ## Interaction
- *
- * <img src="./images/customelement-sequencediagram.png">
- *
  * ## Styling
  *
  * To display custom elements optimally, the `:defined` pseudo-class can be used. To prevent custom elements from being displayed and flickering until the control is registered,
@@ -234,12 +230,9 @@ const scriptHostElementSymbol = Symbol("scriptHostElement");
  * More information about Custom Elements can be found in the [MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/Web_Components/Using_custom_elements).
  * And in the [HTML Standard](https://html.spec.whatwg.org/multipage/custom-elements.html#custom-elements) or in the [WHATWG Wiki](https://wiki.whatwg.org/wiki/Custom_Elements).
  *
- * @externalExample ../../example/dom/theme.mjs
  * @license AGPLv3
  * @since 1.7.0
  * @copyright schukai GmbH
- * @memberOf Monster.DOM
- * @extends external:HTMLElement
  * @summary A base class for HTML5 custom controls.
  */
 class CustomElement extends HTMLElement {
@@ -250,7 +243,6 @@ class CustomElement extends HTMLElement {
 	 * IMPORTANT: CustomControls instances are not created via the constructor, but either via a tag in the HTML or via <code>document.createElement()</code>.
 	 *
 	 * @throws {Error} the options attribute does not contain a valid json definition.
-	 * @since 1.7.0
 	 */
 	constructor() {
 		super();
@@ -1211,7 +1203,7 @@ function initShadowRoot() {
 	const mapping = this.getOption("templateMapping", {});
 	if (isObject(mapping)) {
 		const formatter = new Formatter(mapping);
-		if (this.getOption("templateFormatter.marker.open")!==null) {
+		if (this.getOption("templateFormatter.marker.open") !== null) {
 			formatter.setMarker(
 				this.getOption("templateFormatter.marker.open"),
 				this.getOption("templateFormatter.marker.close"),

package/source/i18n/formatter.mjs

@@ -30,11 +30,9 @@ const internalTranslationSymbol = Symbol("internalTranslation");
 /**
  * The Formatter extends the Text.Formatter with the possibility to replace the key by a translation.
  *
- * @externalExample ../../example/i18n/formatter.mjs
  * @license AGPLv3
  * @since 1.26.0
  * @copyright schukai GmbH
- * @memberOf Monster.I18n
  */
 class Formatter extends TextFormatter {
 	/**

package/source/i18n/locale.mjs

@@ -20,14 +20,12 @@ import { clone } from "../util/clone.mjs";
 export { Locale, parseLocale };
 
 /**
- * @memberOf Monster.I18n
  * @type {symbol}
  */
 const propertiesSymbol = Symbol("properties");
 
 /**
  * @type {symbol}
- * @memberOf Monster.I18n
  */
 const localeStringSymbol = Symbol("localeString");
 

package/source/i18n/provider.mjs

@@ -26,7 +26,6 @@ import { Translations } from "./translations.mjs";
 export { Provider, translationsLinkSymbol };
 
 /**
- * @memberOf Monster.I18n
  * @type {symbol}
  * @license AGPLv3
  * @since 3.9.0
@@ -42,7 +41,6 @@ const translationsLinkSymbol = Symbol.for(
  * @license AGPLv3
  * @since 1.13.0
  * @copyright schukai GmbH
- * @memberOf Monster.I18n
  * @see {@link https://datatracker.ietf.org/doc/html/rfc3066}
  */
 class Provider extends BaseWithOptions {

package/source/i18n/translations.mjs

@@ -35,7 +35,6 @@ export { Translations, getDocumentTranslations };
  * @license AGPLv3
  * @since 1.13.0
  * @copyright schukai GmbH
- * @memberOf Monster.I18n
  * @see https://datatracker.ietf.org/doc/html/rfc3066
  */
 class Translations extends Base {

package/source/logging/handler/console.mjs

@@ -25,7 +25,6 @@ export { ConsoleHandler };
  * @license AGPLv3
  * @since 1.5.0
  * @copyright schukai GmbH
- * @memberOf Monster.Logging.Handler
  */
 class ConsoleHandler extends Handler {
 	/**

package/source/logging/handler.mjs

@@ -25,7 +25,6 @@ export { Handler };
  * @license AGPLv3
  * @since 1.5.0
  * @copyright schukai GmbH
- * @memberOf Monster.Logging
  */
 class Handler extends Base {
 	constructor() {

package/source/logging/logger.mjs

@@ -12,8 +12,8 @@
  * SPDX-License-Identifier: AGPL-3.0
  */
 
-import { Handler } from "../logging/handler.mjs";
-import { LogEntry } from "../logging/logentry.mjs";
+import { Handler } from "./handler.mjs";
+import { LogEntry } from "./logentry.mjs";
 
 import { Base } from "../types/base.mjs";
 import {
@@ -27,49 +27,41 @@ export { Logger, ALL, TRACE, DEBUG, INFO, WARN, ERROR, FATAL, OFF };
 /**
  * ALL > TRACE > DEBUG > INFO > WARN > ERROR > FATAL > OFF
  * @type {number}
- * @memberOf Monster.Logging
  */
 const ALL = 255;
 /**
  * ALL > TRACE > DEBUG > INFO > WARN > ERROR > FATAL > OFF
  * @type {number}
- * @memberOf Monster.Logging
  */
 const TRACE = 64;
 /**
  * ALL > TRACE > DEBUG > INFO > WARN > ERROR > FATAL > OFF
  * @type {number}
- * @memberOf Monster.Logging
  */
 const DEBUG = 32;
 /**
  * ALL > TRACE > DEBUG > INFO > WARN > ERROR > FATAL > OFF
  * @type {number}
- * @memberOf Monster.Logging
  */
 const INFO = 16;
 /**
  * ALL > TRACE > DEBUG > INFO > WARN > ERROR > FATAL > OFF
  * @type {number}
- * @memberOf Monster.Logging
  */
 const WARN = 8;
 /**
  * ALL > TRACE > DEBUG > INFO > WARN > ERROR > FATAL > OFF
  * @type {number}
- * @memberOf Monster.Logging
  */
 const ERROR = 4;
 /**
  * ALL > TRACE > DEBUG > INFO > WARN > ERROR > FATAL > OFF
  * @type {number}
- * @memberOf Monster.Logging
  */
 const FATAL = 2;
 /**
  * ALL > TRACE > DEBUG > INFO > WARN > ERROR > FATAL > OFF
  * @type {number}
- * @memberOf Monster.Logging
  */
 const OFF = 0;
 
@@ -79,7 +71,6 @@ const OFF = 0;
  * @license AGPLv3
  * @since 1.5.0
  * @copyright schukai GmbH
- * @memberOf Monster.Logging
  */
 class Logger extends Base {
 	/**

package/source/monster.mjs

@@ -56,7 +56,6 @@ export * from "./components/form/constants.mjs";
 export * from "./components/notify/message.mjs";
 export * from "./components/notify/notify.mjs";
 export * from "./components/notify/constants.mjs";
-export * from "./components/tree-menu/dragable-tree-menu.mjs";
 export * from "./components/tree-menu/tree-menu.mjs";
 export * from "./components/host/collapse.mjs";
 export * from "./components/host/config-manager.mjs";

package/source/net/webconnect/message.mjs

@@ -25,7 +25,6 @@ const dataSymbol = Symbol("@@data");
  * @license AGPLv3
  * @since 3.4.0
  * @copyright schukai GmbH
- * @memberOf Monster.Net.WebSocket
  * @summary The Message class encapsulates a WebSocket message.
  */
 class Message extends Base {

package/source/types/base.mjs

@@ -37,14 +37,12 @@ export { Base };
  *
  * The class was formerly called Object.
  *
- * @license AGPLv3
  * @since 1.5.0
  * @copyright schukai GmbH
- * @memberOf Monster.Types
+ * @summary The base class for the most classes in the monster library
  */
 class Base extends Object {
 	/**
-	 *
 	 * @returns {string}
 	 */
 	toString() {

package/source/types/basewithoptions.mjs

@@ -32,8 +32,7 @@ export { BaseWithOptions };
  * @license AGPLv3
  * @since 1.13.0
  * @copyright schukai GmbH
- * @memberOf Monster.Types
- * @deprecated since 3.15.0 use {@link Monster.Types.Base} with {@link Monster.Types.equipWithInternal} instead.
+ * @deprecated since 3.15.0 use `BaseWithOptions` instead of `BaseWithOptions`
  */
 class BaseWithOptions extends Base {
 	/**

package/source/types/nodelist.mjs

@@ -24,7 +24,6 @@ export { NodeList };
  * @license AGPLv3
  * @since 1.26.0
  * @copyright schukai GmbH
- * @memberOf Monster.Types
  * @summary A NodeList class
  */
 class NodeList extends Set {

package/source/types/noderecursiveiterator.mjs

@@ -31,11 +31,7 @@ const isNodeListSymbol = Symbol("isNodeList");
 /**
  * Represents a recursive iterator for traversing nodes in a DOM tree.
  *
- * @externalExample ../../example/types/noderecursiveiterator.mjs
- * @license AGPLv3
  * @since 1.26.0
- * @copyright schukai GmbH
- * @memberOf Monster.Types
  * @summary An iterator to run recursively through a tree of nodes
  * @extends Base
  */
@@ -91,7 +87,7 @@ class NodeRecursiveIterator extends Base {
 
 	/**
 	 * @param {function} callback
-	 * @return {Monster.Types.NodeRecursiveIterator}
+	 * @return {NodeRecursiveIterator}
 	 */
 	forEach(callback) {
 		for (const node of this) {

package/source/types/observablequeue.mjs

@@ -23,11 +23,8 @@ export { ObservableQueue };
  *
  * `Queue.add()` and `Queue.clear()` notify all observers.
  *
- * @externalExample ../../example/types/queue.mjs
- * @license AGPLv3
  * @since 3.3.0
  * @copyright schukai GmbH
- * @memberOf Monster.Types
  * @summary An observable Queue (Fifo)
  */
 class ObservableQueue extends Queue {
@@ -44,7 +41,6 @@ class ObservableQueue extends Queue {
 	/**
 	 * This method is called by the `instanceof` operator.
 	 * @returns {symbol}
-	 * @since 2.1.0
 	 */
 	static get [instanceSymbol]() {
 		return Symbol.for("@schukai/monster/types/observablequeue");

package/source/types/observer.mjs

@@ -53,11 +53,8 @@ export { Observer };
  *
  * The callback function must have as many parameters as arguments are given.
  *
- * @externalExample ../../example/types/observer.mjs
  * @license AGPLv3
  * @since 1.0.0
- * @copyright schukai GmbH
- * @memberOf Monster.Types
  */
 class Observer extends Base {
 	/**

package/source/types/observerlist.mjs

@@ -23,8 +23,6 @@ export { ObserverList };
  *
  * @license AGPLv3
  * @since 1.0.0
- * @copyright schukai GmbH
- * @memberOf Monster.Types
  */
 class ObserverList extends Base {
 	/**

package/source/types/proxyobserver.mjs

@@ -30,11 +30,9 @@ export { ProxyObserver };
  *
  * This also applies to nested objects.
  *
- * @externalExample ../../example/types/proxyobserver.mjs
  * @license AGPLv3
  * @since 1.0.0
  * @copyright schukai GmbH
- * @memberOf Monster.Types
  */
 class ProxyObserver extends Base {
 	/**

package/source/types/queue.mjs

@@ -26,11 +26,8 @@ export { Queue };
  *
  * You can create the instance via `new Queue()`.
  *
- * @externalExample ../../example/types/queue.mjs
  * @license AGPLv3
  * @since 1.4.0
- * @copyright schukai GmbH
- * @memberOf Monster.Types
  * @summary A Queue (Fifo)
  */
 class Queue extends Base {

package/source/types/randomid.mjs

@@ -30,7 +30,6 @@ let internalCounter = 0;
  * @license AGPLv3
  * @since 1.6.0
  * @copyright schukai GmbH
- * @memberOf Monster.Types
  * @summary class to generate random numbers
  */
 class RandomID extends ID {

package/source/types/regex.mjs

@@ -24,7 +24,6 @@ export { escapeString };
  * @license AGPLv3
  * @since 1.26.0
  * @copyright schukai GmbH
- * @memberOf Monster.Types
  * @throws {TypeError} value is not a string
  */
 function escapeString(value) {

package/source/types/stack.mjs

@@ -17,12 +17,11 @@ import { instanceSymbol } from "../constants.mjs";
 export { Stack };
 
 /**
- * You can call the method via the monster namespace `new Monster.Types.Queue()`.
+ * You can call the method via the monster namespace `new Queue()`.
  *
  * @license AGPLv3
  * @since 1.4.0
  * @copyright schukai GmbH
- * @memberOf Monster.Types
  */
 class Stack extends Base {
 	/**

package/source/types/tokenlist.mjs

@@ -25,11 +25,9 @@ export { TokenList };
  *
  * This class implements the [iteration protocol](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols).
  *
- * @externalExample ../../example/types/tokenlist-1.mjs
  * @license AGPLv3
  * @since 1.2.0
  * @copyright schukai GmbH
- * @memberOf Monster.Types
  */
 class TokenList extends Base {
 	/**

package/source/types/typeof.mjs

@@ -17,13 +17,11 @@ export { typeOf };
 /**
  * The built-in typeof method is known to have some historical weaknesses. This function tries to provide a better and more accurate result.
  *
- * @externalExample ../../example/types/typeof.mjs
  * @param {*} value
  * @return {string}
  * @license AGPLv3
  * @since 1.7.0
  * @copyright schukai GmbH
- * @memberOf Monster.Types
  * @throws {TypeError} value is not a primitive
  */
 function typeOf(value) {

package/source/types/uniquequeue.mjs

@@ -24,7 +24,6 @@ export { UniqueQueue };
  * @license AGPLv3
  * @since 1.4.0
  * @copyright schukai GmbH
- * @memberOf Monster.Types
  * @summary A queue for unique values
  */
 class UniqueQueue extends Queue {

package/source/types/uuid.mjs

@@ -14,7 +14,7 @@
 
 import { internalSymbol } from "../constants.mjs";
 import { random } from "../math/random.mjs";
-import { isObject } from "../types/is.mjs";
+import { isObject } from "./is.mjs";
 import { Base } from "./base.mjs";
 import { getGlobalObject } from "./global.mjs";
 
@@ -26,7 +26,6 @@ export { UUID };
  * @license AGPLv3
  * @since 1.25.0
  * @copyright schukai GmbH
- * @memberOf Monster.Types
  * @throws {Error} unsupported
  */
 class UUID extends Base {

package/source/types/version.mjs

@@ -25,8 +25,7 @@ export { Version, getMonsterVersion };
  * @since 1.0.0
  * @author schukai GmbH
  * @copyright schukai GmbH
- * @memberOf Monster.Types
- * @summary The version object contains a sematic version number
+ * @summary The version object contains a semantic version number
  */
 class Version extends Base {
 	/**
@@ -145,13 +144,11 @@ let monsterVersion;
 /**
  * Version of monster
  *
- * @externalExample ../../example/types/version-2.mjs
- * @returns {Monster.Types.Version}
+ * @returns {Version}
  * @license AGPLv3
  * @since 1.0.0
  * @copyright schukai GmbH
  * @author schukai GmbH
- * @memberOf Monster
  */
 function getMonsterVersion() {
 	if (monsterVersion instanceof Version) {