@schukai/monster 4.154.1 → 4.154.3

package/source/dom/sanitize-html.mjs

@@ -2,7 +2,7 @@
  * Helper function to sanitize HTML content by removing potentially dangerous content.
  * @param {string} htmlString - The HTML string to sanitize.
  * @param {Object} [options={}] - Optional configuration options.
- * @returns {string} The sanitized HTML string.
+ * @return {string} The sanitized HTML string.
  */
 export function sanitizeHtml(htmlString, options = {}) {
 	const parser = new DOMParser();

package/source/i18n/internal.mjs

@@ -23,7 +23,7 @@ getInternalTranslations();
 
 /**
  *
- * @returns {*|Translations}
+ * @return {*|Translations}
  */
 function getInternalTranslations() {
 	if (internalTranslations) {
@@ -170,7 +170,7 @@ function getInternalTranslations() {
 /**
  * Returns the internal localization message.
  * @param message
- * @returns {string}
+ * @return {string}
  */
 
 function getInternalLocalizationMessage(message) {

package/source/i18n/providers/embed.mjs

@@ -147,7 +147,7 @@ class Embed extends Provider {
 	 * `script[data-monster-role=translations]` is searched for and the translations are assigned to the element.
 	 *
 	 * @param element
-	 * @returns {Promise<Awaited<*[]>>|Promise<Awaited<unknown>[]>}
+	 * @return {Promise<Awaited<*[]>>|Promise<Awaited<unknown>[]>}
 	 */
 	static assignTranslationsToElement(element) {
 		const d = getDocument();

package/source/i18n/time-ago.mjs

@@ -19,7 +19,7 @@ export { formatTimeAgo };
  *
  * @param date
  * @param locale
- * @returns {string}
+ * @return {string}
  */
 function formatTimeAgo(date, locale) {
 	const now = new Date(Math.floor(new Date().getTime() / 1000) * 1000);

package/source/text/formatter.mjs

@@ -121,6 +121,7 @@ const workingDataSymbol = Symbol("workingData");
  * @license AGPLv3
  * @since 1.12.0
  * @copyright Volker Schukai
+ * @summary Formats placeholder-based messages from structured values and pipes.
  */
 class Formatter extends BaseWithOptions {
 	/**

package/source/types/dataurl.mjs

@@ -37,6 +37,7 @@ const internal = Symbol("internal");
  * @copyright Volker Schukai
  * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs
  * @see https://datatracker.ietf.org/doc/html/rfc2397
+ * @summary Parses and represents data URLs with media type and content.
  */
 class DataUrl extends Base {
 	/**

package/source/types/has.mjs

@@ -19,7 +19,7 @@ export { hasImplementation };
  *
  * @param object
  * @param methods
- * @returns {boolean}
+ * @return {boolean}
  */
 function hasImplementation(object, methods) {
 	return methods.every((method) => typeof object[method] === "function");

package/source/types/is.mjs

@@ -33,7 +33,7 @@ export {
 /**
  * Checks whether the value passed is a DOM Element.
  * @param {*} value
- * @returns {boolean}
+ * @return {boolean}
  */
 function isElement(value) {
 	if (typeof Element === "undefined") {
@@ -46,7 +46,7 @@ function isElement(value) {
  * Checks whether the value passed is a Proxy.
  *
  * @param {*} value
- * @returns {boolean}
+ * @return {boolean}
  */
 function isProxy(value) {
 	return value?.[proxyInstanceMarker] === proxyInstanceMarker;

package/source/types/mediatype.mjs

@@ -36,6 +36,7 @@ const internal = Symbol("internal");
  * @license AGPLv3
  * @since 1.8.0
  * @copyright Volker Schukai
+ * @summary Parses and represents media types and their parameters.
  */
 class MediaType extends Base {
 	/**

package/source/types/observer.mjs

@@ -75,7 +75,7 @@ class Observer extends Base {
 
 	/**
 	 * This method is called by the `instanceof` operator.
-	 * @returns {symbol}
+	 * @return {symbol}
 	 * @since 2.1.0
 	 */
 	static get [instanceSymbol]() {
@@ -97,7 +97,7 @@ class Observer extends Base {
 	 * the callback is only executed once. All callers will receive the same promise.
 	 *
 	 * @param {object} subject The subject object that triggered the update.
-	 * @returns {Promise<*>} A promise that resolves with the return value of the callback,
+	 * @return {Promise<*>} A promise that resolves with the return value of the callback,
 	 * or rejects if the callback throws an error.
 	 */
 	update(subject) {
@@ -129,7 +129,7 @@ class Observer extends Base {
 
 	/**
 	 * @param {string} tag
-	 * @returns {Observer}
+	 * @return {Observer}
 	 */
 	addTag(tag) {
 		this.#tags.add(tag);
@@ -138,7 +138,7 @@ class Observer extends Base {
 
 	/**
 	 * @param {string} tag
-	 * @returns {Observer}
+	 * @return {Observer}
 	 */
 	removeTag(tag) {
 		this.#tags.remove(tag);
@@ -146,7 +146,7 @@ class Observer extends Base {
 	}
 
 	/**
-	 * @returns {string[]}
+	 * @return {string[]}
 	 */
 	getTags() {
 		return this.#tags.entries();
@@ -154,7 +154,7 @@ class Observer extends Base {
 
 	/**
 	 * @param {string} tag
-	 * @returns {boolean}
+	 * @return {boolean}
 	 */
 	hasTag(tag) {
 		return this.#tags.contains(tag);

package/source/types/observerlist.mjs

@@ -23,6 +23,7 @@ export { ObserverList };
  *
  * @license AGPLv3
  * @since 1.0.0
+ * @summary Manages a collection of Observer instances.
  */
 class ObserverList extends Base {
 	/**

package/source/types/proxyobserver.mjs

@@ -33,6 +33,7 @@ export { ProxyObserver };
  * @license AGPLv3
  * @since 1.0.0
  * @copyright Volker Schukai
+ * @summary Observes nested object changes through a proxy.
  */
 class ProxyObserver extends Base {
 	/**

package/source/types/stack.mjs

@@ -22,6 +22,7 @@ export { Stack };
  * @license AGPLv3
  * @since 1.4.0
  * @copyright Volker Schukai
+ * @summary Provides a last-in, first-out collection.
  */
 class Stack extends Base {
 	/**

package/source/types/tokenlist.mjs

@@ -28,6 +28,7 @@ export { TokenList };
  * @license AGPLv3
  * @since 1.2.0
  * @copyright Volker Schukai
+ * @summary Manages a whitespace-separated set of string tokens.
  */
 class TokenList extends Base {
 	/**

package/source/types/uuid.mjs

@@ -27,6 +27,7 @@ export { UUID };
  * @since 1.25.0
  * @copyright Volker Schukai
  * @throws {Error} unsupported
+ * @summary Creates and retrieves stable UUIDs for objects.
  */
 class UUID extends Base {
 	/**

package/source/util/accessiblecolor.mjs

@@ -91,7 +91,7 @@
  *
  * @param color
  * @param minContrast
- * @returns {string|string}
+ * @return {string|string}
  * @summary This function generates a color that meets the WCAG contrast ratio requirements against a given base color.
  */
 export function accessibleColor(color, minContrast = 4.5) {
@@ -187,7 +187,7 @@ function luminance(hex) {
  *
  * @param {number} l1 - The relative luminance of the lighter element.
  * @param {number} l2 - The relative luminance of the darker element.
- * @returns {number} The contrast ratio, a value ranging from 1 to 21.
+ * @return {number} The contrast ratio, a value ranging from 1 to 21.
  */
 const contrastRatio = (l1, l2) =>
 	(Math.max(l1, l2) + 0.05) / (Math.min(l1, l2) + 0.05);

package/source/util/comparator.mjs

@@ -38,17 +38,17 @@ export { Comparator };
  *      }).equal({v: 2}, {v: 2});  // ↦ true
  * ```
  *
- * @example /example/comparator/simple/ Simple example
  * @license AGPLv3
  * @since 1.3.0
+ * @summary Wraps customizable comparison operations for arbitrary values.
  */
 class Comparator extends Base {
 	/**
 	 * create new comparator
 	 *
 	 * @param {Monster.Util~exampleCallback} [callback] Comparator callback
-	 * @throw {TypeError} unsupported type
-	 * @throw {TypeError} impractical comparison
+	 * @throws {TypeError} unsupported type
+	 * @throws {TypeError} impractical comparison
 	 */
 	constructor(callback) {
 		super();

package/source/util/deadmansswitch.mjs

@@ -24,7 +24,6 @@ export { DeadMansSwitch };
  * The dead man's switch allows setting a timer which can be reset again
  * and again within a defined period of time.
  *
- * @example /example/util/deadmansswitch/simple/ Simple example
  * @copyright Volker Schukai
  * @license AGPLv3
  * @since 1.29.0
@@ -36,7 +35,7 @@ class DeadMansSwitch extends Base {
 	 *
 	 * @param {Integer} delay
 	 * @param {function} callback
-	 * @throw {TypeError} the arguments must be either integer or functions
+	 * @throws {TypeError} the arguments must be either integer or functions
 	 * @throws {TypeError} value is not an integer
 	 */
 	constructor(delay, callback) {
@@ -47,7 +46,7 @@ class DeadMansSwitch extends Base {
 
 	/**
 	 * @param delay
-	 * @returns {DeadMansSwitch}
+	 * @return {DeadMansSwitch}
 	 * @throws {Error} has already run
 	 * @throws {Error} unsupported argument
 	 */
@@ -70,7 +69,7 @@ class DeadMansSwitch extends Base {
 
 	/**
 	 * @throws {Error} has already run
-	 * @returns {DeadMansSwitch}
+	 * @return {DeadMansSwitch}
 	 */
 	defuse() {
 		if (this[internalSymbol]["isAlreadyRun"] === true) {

package/source/util/processing.mjs

@@ -54,7 +54,7 @@ class Processing extends Base {
 	 *
 	 * So the execution time is timeout1+timeout1+timeout1+timeout2
 	 *
-	 * @throw {TypeError} the arguments must be either integer or functions
+	 * @throws {TypeError} the arguments must be either integer or functions
 	 * @param {...(int|function)} args
 	 */
 	constructor(...args) {

package/test/cases/components/datatable/drag-scroll.mjs

@@ -702,6 +702,16 @@ describe("Datatable drag scroll", function () {
 			expect(firstResizeObserver).to.exist;
 			expect(secondResizeObserver).to.exist;
 
+			// Drain initialization work from the module-level shared frame before
+			// replacing requestAnimationFrame. Otherwise a slow renderer can still
+			// have that frame pending and the observer updates correctly join it,
+			// leaving the spy below with no newly scheduled callback.
+			await new Promise((resolve) => {
+				window.requestAnimationFrame(() =>
+					window.requestAnimationFrame(resolve),
+				);
+			});
+
 			const scheduledCallbacks = [];
 			window.requestAnimationFrame = (callback) => {
 				scheduledCallbacks.push(callback);

package/test/cases/components/layout/tabs.mjs

@@ -351,6 +351,8 @@ describe("Tabs", function () {
 			expect(cssText).to.contain("--monster-tabs-nav-background-color");
 			expect(cssText).to.contain("--monster-tabs-nav-align-items");
 			expect(cssText).to.contain("--monster-tabs-button-color");
+			expect(cssText).to.contain("--monster-tabs-icon-color");
+			expect(cssText).to.contain("var(--monster-color-red-4)");
 			expect(cssText).to.contain(
 				"--monster-tabs-button-active-background-color",
 			);