@schukai/monster 3.64.1 → 3.65.20

package/example/types/queue.mjs

@@ -1,20 +0,0 @@
-import {Queue} from '@schukai/monster/source/types/queue.mjs';
-
-const queue = new Queue;
-
-queue.add(2);
-queue.add(true);
-queue.add("Hello");
-queue.add(4.5);
-
-console.log(queue.poll());
-// ↦ 2
-console.log(queue.poll());
-// ↦ true
-console.log(queue.poll());
-// ↦ "Hello"
-console.log(queue.poll());
-// ↦ 4.5
-console.log(queue.poll());
-// ↦ undefined
-

package/example/types/tokenlist-1.mjs

@@ -1,4 +0,0 @@
-import {TokenList} from '@schukai/monster/source/types/tokenlist.mjs';
-
-typeof new TokenList("myclass row")[Symbol.iterator];
-// ↦ "function"

package/example/types/tokenlist-2.mjs

@@ -1,7 +0,0 @@
-import {TokenList} from '@schukai/monster/source/types/tokenlist.mjs';
-
-new TokenList("start middle end").contains('start'); // ↦ true
-new TokenList("start middle end").contains('end'); // ↦ true
-new TokenList("start middle end").contains('xyz'); // ↦ false
-new TokenList("start middle end").contains(['end','start','middle']); // ↦ true
-new TokenList("start middle end").contains(['end','start','xyz']); // ↦ false

package/example/types/tokenlist-3.mjs

@@ -1,5 +0,0 @@
-import {TokenList} from '@schukai/monster/source/types/tokenlist.mjs';
-
-new TokenList().add("abc xyz").toString(); // ↦ "abc xyz"
-new TokenList().add(["abc", "xyz"]).toString(); // ↦ "abc xyz"
-new TokenList().add(undefined); // ↦ add nothing

package/example/types/tokenlist-4.mjs

@@ -1,5 +0,0 @@
-import {TokenList} from '@schukai/monster/source/types/tokenlist.mjs';
-
-new TokenList("abc xyz").remove("xyz").toString(); // ↦ "abc"
-new TokenList("abc xyz").remove(["xyz"]).toString(); // ↦ "abc"
-new TokenList("abc xyz").remove(undefined); // ↦ remove nothing

package/example/types/tokenlist-5.mjs

@@ -1,5 +0,0 @@
-import {TokenList} from '@schukai/monster/source/types/tokenlist.mjs';
-
-new TokenList("abc def ghi").toggle("def xyz").toString(); // ↦ "abc ghi xyz"
-new TokenList("abc def ghi").toggle(["abc", "xyz"]).toString(); // ↦ "def ghi xyz"
-new TokenList().toggle(undefined); // ↦ nothing

package/example/types/typeof.mjs

@@ -1,9 +0,0 @@
-import {typeOf} from '@schukai/monster/source/types/typeof.mjs';
-
-typeOf(undefined); // ↦ undefined
-typeOf(""); // ↦ string
-typeOf(5); // ↦ number
-typeOf({}); // ↦ object
-typeOf([]); // ↦ array
-typeOf(new Map); // ↦ map
-typeOf(true); // ↦ boolean

package/example/types/version-1.mjs

@@ -1,6 +0,0 @@
-import {Version} from '@schukai/monster/source/types/version.mjs';
-
-new Version('1.0.0') // ↦ 1.0.0
-new Version(1)  // ↦ 1.0.0
-new Version(1, 0, 0) // ↦ 1.0.0
-new Version('1.2.3', 4, 5) // ↦ 1.4.5

package/example/types/version-2.mjs

@@ -1,3 +0,0 @@
-import {getMonsterVersion} from '@schukai/monster/source/types/version.mjs';
-
-getMonsterVersion(); 

package/example/util/comparator.mjs

@@ -1,10 +0,0 @@
-import {Comparator} from '@schukai/monster/source/util/comparator.mjs';
-
-console.log(new Comparator().lessThanOrEqual(2, 5))
-// ↦ true
-console.log(new Comparator().greaterThan(4, 2))
-// ↦ true
-console.log(new Comparator().equal(4, 4))
-// ↦ true
-console.log(new Comparator().equal(4, 5))
-// ↦ false

package/example/util/deadmansswitch.mjs

@@ -1,9 +0,0 @@
-import {DeadMansSwitch} from '@schukai/monster/source/util/deadmansswitch.mjs';
-
-const deadmansswitch = new DeadMansSwitch(100, () => {
-    console.log('yeah!')
-    // ↦ "yeah!"
-})
-
-deadmansswitch.touch(); // from here wait again 100 ms
-deadmansswitch.touch(200); // from here wait 200 ms

package/example/util/processing.mjs

@@ -1,17 +0,0 @@
-import {Processing} from '@schukai/monster/source/util/processing.mjs';
-
-let startTime = +new Date();
-
-new Processing((url) => {
-    return fetch(url)
-}, (response) => {
-    // do something with the response
-    console.log(response.status, +new Date() - startTime)
-}, 200, () => {
-    // this function is called 200 seconds after fetch is received.
-    console.log('finished', +new Date() - startTime)
-    return 'done'
-}).run('https://monsterjs.org/assets/world.json').then(r => {
-    console.log(r)
-    // ↦ "done"
-})

package/source/components/datatable/datasource/namespace.mjs

@@ -1,13 +0,0 @@
-/**
- * Copyright 2023 schukai GmbH
- * SPDX-License-Identifier: AGPL-3.0
- */
-
-/**
- * Namespace for all datatable related functions.
- *
- * @namespace Monster.Components.Datatable.Datasource
- * @memberOf Monster
- * @author schukai GmbH
- */
-const ns = {};

package/source/components/datatable/datatable/namespace.mjs

@@ -1,13 +0,0 @@
-/**
- * Copyright 2023 schukai GmbH
- * SPDX-License-Identifier: AGPL-3.0
- */
-
-/**
- * Namespace for all datatable related functions.
- *
- * @namespace Monster.Components.Datatable.Datatable
- * @memberOf Monster
- * @author schukai GmbH
- */
-const ns = {};

package/source/components/datatable/events.mjs

@@ -1,24 +0,0 @@
-/**
- * Copyright schukai GmbH and contributors 2023. 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
- */
-
-/**
- * @memberOf Monster.Components.Form
- * @event event:monster-datatable-row-added
- * @type {number} index
- */
-
-/**
- * @memberOf Monster.Components.Form
- * @event event:monster-datatable-row-copied
- * @type {number} index
- */
-
-/**
- * @memberOf Monster.Components.Form
- * @event event:monster-datatable-row-removed
- * @type {number} index
- */

package/source/components/datatable/filter/namespace.mjs

@@ -1,13 +0,0 @@
-/**
- * Copyright 2023 schukai GmbH
- * SPDX-License-Identifier: AGPL-3.0
- */
-
-/**
- * Namespace for all datatable related functions.
- *
- * @namespace Monster.Components.Datatable.Filter
- * @memberOf Monster
- * @author schukai GmbH
- */
-const ns = {};

package/source/components/datatable/namespace.mjs

@@ -1,11 +0,0 @@
-/**
- * Copyright 2023 schukai GmbH
- * SPDX-License-Identifier: AGPL-3.0
- */
-
-/**
- * @namespace Monster.Components.Datatable
- * @memberOf Monster
- * @author schukai GmbH
- */
-const ns = {};

package/source/components/datatable/stylesheet/namespace.mjs

@@ -1,13 +0,0 @@
-/**
- * Copyright 2023 schukai GmbH
- * SPDX-License-Identifier: AGPL-3.0
- */
-
-/**
- * Namespace for all datatable stylesheets.
- *
- * @namespace Monster.Components.Datatable.StyleSheet
- * @memberOf Monster
- * @author schukai GmbH
- */
-const ns = {};

package/source/components/events.mjs

@@ -1,17 +0,0 @@
-/**
- * Copyright schukai GmbH and contributors 2023. 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
- */
-
-
-
-/**
- * content fetched event
- *
- * @memberOf Monster.Components
- * @event event:monster-fetched
- * @type {object}
- * @property {string} url loaded uri
- */

package/source/components/form/events.mjs

@@ -1,108 +0,0 @@
-/**
- * Copyright schukai GmbH and contributors 2023. 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 event is fired when options are set
- *
- * @memberOf Monster.Components.Form
- * @event event:monster-options-set
- * @type {object}
- * @property {Object[]} options options
- * @property {string} options.value value
- * @property {string} options.label label
- */
-
-/**
- * This event is fired when something is selected
- *
- * @memberOf Monster.Components.Form
- * @event event:monster-selected
- * @type {object}
- * @property {array|string} selection
- */
-
-/**
- * This event will be fired when something will change
- *
- * @memberOf Monster.Components.Form
- * @event event:monster-change
- * @type {object}
- * @property {string} [type] event type
- * @property {string} [value] the value that was changed
- * @property {boolean} [checked] if it is a boolean value
- */
-
-/**
- * This event will be fired when a selection is removed
- *
- * @memberOf Monster.Components.Form
- * @event event:monster-selection-removed
- * @type {object}
- * @property {string} [type] event type
- * @property {string} [value] the value that was changed
- */
-
-/**
- * This event will be fired when a selection is cleared
- *
- * @memberOf Monster.Components.Form
- * @event event:monster-selection-cleared
- * @type {object}
- * @property {string} [type] event type
- */
-
-/**
- * This event will be fired if something has changed
- *
- * @memberOf Monster.Components.Form
- * @event event:monster-changed
- * @type {object}
- * @property {string} [type] event type
- * @property {string} [value] the value that was changed
- * @property {boolean} [checked] if it is a boolean value
- **/
-
-/**
- * button clicked event
- *
- * @memberOf Monster.Components.Form
- * @event event:monster-button-clicked
- * @type {object}
- */
-
-/**
- * content fetched event
- *
- * @memberOf Monster.Components.Form
- * @event event:monster-button-set
- * @type {object}
- */
-
-/**
- * content fetched event
- *
- * @memberOf Monster.Components.Form
- * @event event:monster-api-button-click
- * @type {object}
- */
-
-/**
- * content fetched event
- *
- * @memberOf Monster.Components.Form
- * @event event:monster-api-button-successful
- * @type {object}
- */
-
-/**
- * content fetched event
- *
- * @memberOf Monster.Components.Form
- * @event event:monster-api-button-failed
- * @type {object}
- */
-

package/source/components/form/form-field.mjs

@@ -1,341 +0,0 @@
-/**
- * Copyright schukai GmbH and contributors 2023. 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
- */
-import { instanceSymbol } from "../../constants.mjs";
-import { addAttributeToken } from "../../dom/attributes.mjs";
-import {
-	ATTRIBUTE_ERRORMESSAGE,
-	ATTRIBUTE_ROLE,
-} from "../../dom/constants.mjs";
-import { CustomControl } from "../../dom/customcontrol.mjs";
-import {
-	assembleMethodSymbol,
-	attributeObserverSymbol,
-	registerCustomElement,
-} from "../../dom/customelement.mjs";
-import { findTargetElementFromEvent } from "../../dom/events.mjs";
-import { isFunction } from "../../types/is.mjs";
-import { ATTRIBUTE_BUTTON_CLASS } from "./constants.mjs";
-import { ButtonStyleSheet } from "./stylesheet/button.mjs";
-import { RippleStyleSheet } from "../stylesheet/ripple.mjs";
-import { fireCustomEvent } from "../../dom/events.mjs";
-
-export { FormField };
-
-
-/**
- * This CustomControl creates a container for form elements.
- *
- * <img src="./images/form-field.png">
- *
- * You can create this control either by specifying the HTML tag <monster-form-field />` directly in the HTML or using
- * Javascript via the `document.createElement('monster-form-field');` method.
- *
- * ```html
- * <monster-form-field></monster-form-field>
- * ```
- *
- * Or you can create this CustomControl directly in Javascript:
- *
- * ```js
- * import {Button} from '@schukai/monster/components/form/form-field.mjs';
- * document.createElement('monster-form-field');
- * ```
- *
- * The `data-monster-button-class` attribute can be used to change the CSS class of the button.
- *
- * @startuml form-field.png
- * skinparam monochrome true
- * skinparam shadowing false
- * HTMLElement <|-- CustomElement
- * CustomElement <|-- CustomControl
- * CustomControl <|-- FormField
- * @enduml
- *
- * @since 1.5.0
- * @copyright schukai GmbH
- * @memberOf Monster.Components.Form
- * @summary A simple button
- */
-class FormField extends CustomControl {
-	/**
-	 * This method is called by the `instanceof` operator.
-	 * @returns {symbol}
-	 * @since 2.1.0
-	 */
-	static get [instanceSymbol]() {
-		return Symbol.for("@schukai/monster/components/form/button@@instance");
-	}
-
-	/**
-	 *
-	 * @return {Monster.Components.Form.Button}
-	 */
-	[assembleMethodSymbol]() {
-		super[assembleMethodSymbol]();
-		initControlReferences.call(this);
-		initEventHandler.call(this);
-		return this;
-	}
-
-	/**
-	 * The Button.click() method simulates a click on the internal button element.
-	 *
-	 * @since 3.27.0
-	 * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/click}
-	 */
-	click() {
-		if (this.getOption("disabled") === true) {
-			return;
-		}
-
-		if (
-			this[buttonElementSymbol] &&
-			isFunction(this[buttonElementSymbol].click)
-		) {
-			this[buttonElementSymbol].click();
-		}
-	}
-
-	/**
-	 * The Button.focus() method sets focus on the internal button element.
-	 *
-	 * @since 3.27.0
-	 * @param {Object} options
-	 * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/focus}
-	 */
-	focus(options) {
-		if (this.getOption("disabled") === true) {
-			return;
-		}
-
-		if (
-			this[buttonElementSymbol] &&
-			isFunction(this[buttonElementSymbol].focus)
-		) {
-			this[buttonElementSymbol].focus(options);
-		}
-	}
-
-	/**
-	 * The Button.blur() method removes focus from the internal button element.
-	 */
-	blur() {
-		if (
-			this[buttonElementSymbol] &&
-			isFunction(this[buttonElementSymbol].blur)
-		) {
-			this[buttonElementSymbol].blur();
-		}
-	}
-
-	/**
-	 * This method determines which attributes are to be monitored by `attributeChangedCallback()`.
-	 *
-	 * @return {string[]}
-	 */
-	static get observedAttributes() {
-		const attributes = super.observedAttributes;
-		attributes.push(ATTRIBUTE_BUTTON_CLASS);
-		return attributes;
-	}
-
-	/**
-	 * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/attachInternals}
-	 * @return {boolean}
-	 */
-	static get formAssociated() {
-		return true;
-	}
-
-	/**
-	 * The current selection of the Select
-	 *
-	 * ```
-	 * e = document.querySelector('monster-select');
-	 * console.log(e.value)
-	 * // ↦ 1
-	 * // ↦ ['1','2']
-	 * ```
-	 *
-	 * @property {string|array}
-	 */
-	get value() {
-		return this.getOption("value");
-	}
-
-	/**
-	 * Set selection
-	 *
-	 * ```
-	 * e = document.querySelector('monster-select');
-	 * e.value=1
-	 * ```
-	 *
-	 * @property {string|array} value
-	 * @since 1.2.0
-	 * @throws {Error} unsupported type
-	 */
-	set value(value) {
-		this.setOption("value", value);
-		try {
-			this?.setFormValue(this.value);
-		} catch (e) {
-			addAttributeToken(this, ATTRIBUTE_ERRORMESSAGE, e.message);
-		}
-	}
-
-	/**
-	 * To set the options via the html tag the attribute `data-monster-options` must be used.
-	 * @see {@link https://monsterjs.org/en/doc/#configurate-a-monster-control}
-	 *
-	 * The individual configuration values can be found in the table.
-	 *
-	 * @property {Object} templates Template definitions
-	 * @property {string} templates.main Main template
-	 * @property {Object} labels Labels
-	 * @property {string} labels.button=<slot></slot> Button label
-	 * @property {Object} actions Callbacks
-	 * @property {string} actions.click="throw Error" Callback when clicked
-	 * @property {Object} classes CSS classes
-	 * @property {string} classes.button="monster-button-primary" CSS class for the button
-	 * @property {boolean} disabled=false Disabled state
-	 * @property {Object} effects Effects
-	 * @property {boolean} effects.ripple=true Ripple effect
-	 */
-	get defaults() {
-		return Object.assign({}, super.defaults, {
-			templates: {
-				main: getTemplate(),
-			},
-			labels: {
-				button: "<slot></slot>",
-			},
-			classes: {
-				button: "monster-button-primary",
-			},
-			disabled: false,
-			actions: {
-				click: () => {
-					throw new Error("the click action is not defined");
-				},
-			},
-			effects: {
-				ripple: true,
-			},
-			value: null,
-		});
-	}
-
-	/**
-	 *
-	 * @return {string}
-	 */
-	static getTag() {
-		return "monster-form-field";
-	}
-
-	/**
-	 *
-	 * @return {Array<CSSStyleSheet>}
-	 */
-	static getCSSStyleSheet() {
-		return [FormFieldStyleSheet];
-	}
-}
-
-/**
- * @private
- * @return {initEventHandler}
- * @fires Monster.Components.Form.event:monster-button-clicked
- */
-function initEventHandler() {
-	const self = this;
-	const button = this[buttonElementSymbol];
-
-	const type = "click";
-
-	button.addEventListener(type, function (event) {
-		const callback = self.getOption("actions.click");
-
-		fireCustomEvent(self, "monster-button-clicked", {
-			button: self,
-		});
-
-		if (!isFunction(callback)) {
-			return;
-		}
-
-		const element = findTargetElementFromEvent(
-			event,
-			ATTRIBUTE_ROLE,
-			"control",
-		);
-
-		if (!(element instanceof Node && self.hasNode(element))) {
-			return;
-		}
-
-		callback.call(self, event);
-	});
-
-	if (self.getOption("effects.ripple")) {
-		button.addEventListener("click", createRipple.bind(self));
-	}
-
-	// data-monster-options
-	self[attributeObserverSymbol][ATTRIBUTE_BUTTON_CLASS] = function (value) {
-		self.setOption("classes.button", value);
-	};
-
-	return this;
-}
-
-/**
- * @private
- */
-function initControlReferences() {
-	this[buttonElementSymbol] = this.shadowRoot.querySelector(
-		`[${ATTRIBUTE_ROLE}=button]`,
-	);
-}
-
-/**
- * @private
- * @return {string}
- */
-function getTemplate() {
-	// language=HTML
-	return `
-        <div data-monster-role="control" part="control">
-            <button data-monster-attributes="disabled path:disabled | if:true, class path:classes.button"
-                    data-monster-role="button"
-                    part="button"
-                    data-monster-replace="path:labels.button"></button>
-        </div>`;
-}
-
-function createRipple(event) {
-	const button = this[buttonElementSymbol];
-
-	const circle = document.createElement("span");
-	const diameter = Math.max(button.clientWidth, button.clientHeight);
-	const radius = diameter / 2;
-
-	circle.style.width = circle.style.height = `${diameter}px`;
-	circle.style.left = `${event.clientX - button.offsetLeft - radius}px`;
-	circle.style.top = `${event.clientY - button.offsetTop - radius}px`;
-	circle.classList.add("monster-fx-ripple");
-
-	const ripples = button.getElementsByClassName("monster-fx-ripple");
-	for (const ripple of ripples) {
-		ripple.remove();
-	}
-
-	button.appendChild(circle);
-}
-
-registerCustomElement(FormField);