@schukai/monster 4.132.0 → 4.134.0

package/package.json

@@ -1 +1 @@
-{"author":"Volker Schukai","dependencies":{"@floating-ui/dom":"^1.7.6"},"description":"Monster is a simple library for creating fast, robust and lightweight websites.","homepage":"https://monsterjs.org/","keywords":["framework","web","dom","css","sass","mobile-first","app","front-end","templates","schukai","core","shopcloud","alvine","monster","buildmap","stack","observer","observable","uuid","node","nodelist","css-in-js","logger","log","theme"],"license":"AGPL 3.0","main":"source/monster.mjs","module":"source/monster.mjs","name":"@schukai/monster","repository":{"type":"git","url":"https://gitlab.schukai.com/oss/libraries/javascript/monster.git"},"type":"module","version":"4.132.0"}
+{"author":"Volker Schukai","dependencies":{"@floating-ui/dom":"^1.7.6"},"description":"Monster is a simple library for creating fast, robust and lightweight websites.","homepage":"https://monsterjs.org/","keywords":["framework","web","dom","css","sass","mobile-first","app","front-end","templates","schukai","core","shopcloud","alvine","monster","buildmap","stack","observer","observable","uuid","node","nodelist","css-in-js","logger","log","theme"],"license":"AGPL 3.0","main":"source/monster.mjs","module":"source/monster.mjs","name":"@schukai/monster","repository":{"type":"git","url":"https://gitlab.schukai.com/oss/libraries/javascript/monster.git"},"type":"module","version":"4.134.0"}

package/source/components/host/call-button.mjs

@@ -48,7 +48,7 @@ const ATTRIBUTE_CALL = `${ATTRIBUTE_PREFIX}call`;
  * @example /examples/components/host/call-button-simple Call button
  *
  * @copyright Volker Schukai
- * @summary A call button component that can call a method of another element.
+ * @summary A trigger button that calls a documented method on one or more referenced elements.
  */
 class CallButton extends CustomElement {
 	/**

package/source/components/host/config-manager.mjs

@@ -56,7 +56,7 @@ const MODE_READ_WRITE = "readwrite";
  * @example /examples/components/host/config-manager-simple Config manager
  *
  * @copyright Volker Schukai
- * @summary A config manager component
+ * @summary A configuration manager for persisting and retrieving client-side settings across sessions.
  */
 class ConfigManager extends CustomElement {
 	/**

package/source/components/host/toggle-button.mjs

@@ -26,7 +26,7 @@ export { ToggleButton };
  * @example /examples/components/host/toggle-button-simple Toggle button
  *
  * @copyright Volker Schukai
- * @summary A toggle button
+ * @summary A specialized call button that triggers toggle behavior on a referenced target element.
  */
 class ToggleButton extends CallButton {
 	/**

package/source/components/time/month-calendar.mjs

@@ -68,7 +68,7 @@ const calendarBodyElementSymbol = Symbol("calendarBodyElement");
  *
  * @since 3.112.0
  * @copyright Volker Schukai
- * @summary A beautiful month Calendar that can display appointments. It is possible to use a datasource to load the appointments.
+ * @summary A month calendar for appointments and date-based planning, with optional datasource-driven event loading.
  */
 class MonthCalendar extends CustomElement {
 	/**

package/source/components/time/timeline/appointment.mjs

@@ -36,7 +36,7 @@ const controlElementSymbol = Symbol("calendarElement");
  *
  * @since 3.113.0
  * @copyright Volker Schukai
- * @summary An appointment is a part of the calendar that represents a single appointment.
+ * @summary A timeline appointment block that represents one scheduled item within a calendar or timeline view.
  */
 class Appointment extends CustomElement {
 	/**

package/source/components/time/timeline/segment.mjs

@@ -49,7 +49,7 @@ const controlElementSymbol = Symbol("calendarElement");
  *
  * @since 3.112.0
  * @copyright Volker Schukai
- * @summary A calendar segment is a part of the calendar that represents a single appointment.
+ * @summary A timeline segment block for labeled schedule ranges such as shifts, phases or reserved periods.
  */
 class Segment extends CustomElement {
 	/**

package/source/data/datasource.mjs

@@ -51,7 +51,7 @@ const internalDataSymbol = Symbol.for(
  * @license AGPLv3
  * @since 1.22.0
  * @copyright Volker Schukai
- * @summary The datasource class encapsulates the access to data objects.
+ * @summary A datasource abstraction for reading, observing and writing structured application data.
  */
 class Datasource extends Base {
 	/**

package/source/data/pathfinder.mjs

@@ -87,7 +87,7 @@ const WILDCARD = "*";
  * @license AGPLv3
  * @since 1.4.0
  * @copyright Volker Schukai
- * @summary Pathfinder is a class to find a path to an object.
+ * @summary A path resolution utility for reading nested values from complex objects and records.
  */
 class Pathfinder extends Base {
 	/**

package/source/data/pipe.mjs

@@ -37,7 +37,7 @@ const DELIMITER = "|";
  * @license AGPLv3
  * @since 1.5.0
  * @copyright Volker Schukai
- * @summary The pipe class makes it possible to combine several processing steps.
+ * @summary A processing pipeline utility for chaining multiple data transformation steps.
  */
 class Pipe extends Base {
 	/**

package/source/data/transformer.mjs

@@ -52,7 +52,7 @@ export { Transformer };
  *
  * @since 1.5.0
  * @copyright Volker Schukai
- * @summary The transformer class is a swiss army knife for manipulating values. especially in combination with the pipe, processing chains can be built up.
+ * @summary A value transformation utility for formatting, mapping and reshaping data inside processing chains.
  */
 class Transformer extends Base {
 	/**

package/source/dom/assembler.mjs

@@ -32,7 +32,7 @@ const ATTRIBUTEPREFIX = "data-monster-";
  * @license AGPLv3
  * @since 1.6.0
  * @copyright Volker Schukai
- * @summary Allows you to build an html fragment
+ * @summary A DOM assembler for creating HTML fragments from templates and structured configuration.
  */
 class Assembler extends Base {
 	/**

package/source/dom/customcontrol.mjs

@@ -51,7 +51,7 @@ const attachedInternalSymbol = Symbol("attachedInternal");
  *
  * @fragments /fragments/libraries/dom/customcontrol/
  *
- * @summary A base class for custom controls based on CustomElement.
+ * @summary A form-oriented base class for Monster controls with value handling, validation and control semantics.
  * @license AGPLv3
  * @since 1.14.0
  */

package/source/dom/customelement.mjs

@@ -194,7 +194,7 @@ let hostVisibilityStyleSheet = null;
  * @license AGPLv3
  * @since 1.7.0
  * @copyright Volker Schukai
- * @summary A base class for HTML5 custom controls.
+ * @summary The core base class for building Monster custom elements with options, lifecycle hooks and templating support.
  */
 class CustomElement extends HTMLElement {
 	/**

package/source/dom/focusmanager.mjs

@@ -46,7 +46,7 @@ const stackSymbol = Symbol("stack");
  * @since 1.25.0
  * @copyright Volker Schukai
  * @throws {Error} unsupported locale
- * @summary Handle the focus
+ * @summary A focus management helper for moving and restoring focus across interactive DOM regions.
  */
 class FocusManager extends BaseWithOptions {
 	/**

package/source/dom/template.mjs

@@ -28,7 +28,7 @@ export { Template };
  * @license AGPLv3
  * @since 1.6.0
  * @copyright Volker Schukai
- * @summary A template class
+ * @summary A template helper for resolving, cloning and preparing reusable DOM templates.
  */
 class Template extends Base {
 	/**

package/source/dom/theme.mjs

@@ -26,7 +26,7 @@ export { Theme, getDocumentTheme };
  * @license AGPLv3
  * @since 1.7.0
  * @copyright Volker Schukai
- * @summary A theme class
+ * @summary A theme utility for applying and coordinating Monster theme state in the DOM.
  */
 class Theme extends Base {
 	/**

package/source/dom/updater.mjs

@@ -115,7 +115,7 @@ const queuedSnapshotSymbol = Symbol("queuedSnapshot");
  * @throws {Error} the maximum depth for the recursion is reached.
  * @throws {TypeError} value is not a object
  * @throws {TypeError} value is not an instance of HTMLElement
- * @summary The updater class connects an object with the dom
+ * @summary A DOM updater that binds structured data objects to templates and rendered document fragments.
  */
 class Updater extends Base {
 	/**

package/source/i18n/formatter.mjs

@@ -35,6 +35,7 @@ const internalTranslationSymbol = Symbol("internalTranslation");
  * @license AGPLv3
  * @since 1.26.0
  * @copyright Volker Schukai
+ * @summary An i18n formatter for locale-aware number, date and text presentation.
  */
 class Formatter extends TextFormatter {
 	/**

package/source/i18n/locale.mjs

@@ -68,6 +68,7 @@ const localeStringSymbol = Symbol("localeString");
  * @license AGPLv3
  * @since 1.13.0
  * @copyright Volker Schukai
+ * @summary A locale value object for parsing, validating and formatting language-region identifiers.
  * @see https://datatracker.ietf.org/doc/html/rfc3066
  */
 class Locale extends Base {

package/source/i18n/provider.mjs

@@ -41,6 +41,7 @@ const translationsLinkSymbol = Symbol.for(
  * @license AGPLv3
  * @since 1.13.0
  * @copyright Volker Schukai
+ * @summary A translation provider base class for loading and attaching locale-dependent text sources.
  * @see {@link https://datatracker.ietf.org/doc/html/rfc3066}
  */
 class Provider extends BaseWithOptions {

package/source/i18n/providers/embed.mjs

@@ -30,6 +30,7 @@ export { Embed };
  * @license AGPLv3
  * @since 1.13.0
  * @copyright Volker Schukai
+ * @summary A translation provider that reads embedded locale resources from the current document.
  * @see {@link https://datatracker.ietf.org/doc/html/rfc3066}
  */
 class Embed extends Provider {

package/source/i18n/providers/fetch.mjs

@@ -31,6 +31,7 @@ export { Fetch };
  * @license AGPLv3
  * @since 1.13.0
  * @copyright Volker Schukai
+ * @summary A translation provider that loads locale resources from remote endpoints via fetch.
  * @see {@link https://datatracker.ietf.org/doc/html/rfc3066}
  * @tutorial i18n-locale-and-formatter
  */

package/source/i18n/translations.mjs

@@ -39,6 +39,7 @@ export { Translations, getDocumentTranslations };
  * @license AGPLv3
  * @since 1.13.0
  * @copyright Volker Schukai
+ * @summary A translation registry for storing localized text keys and resolving plural-aware output.
  * @see https://datatracker.ietf.org/doc/html/rfc3066
  */
 class Translations extends Base {

package/source/logging/handler/console.mjs

@@ -25,6 +25,7 @@ export { ConsoleHandler };
  * @license AGPLv3
  * @since 1.5.0
  * @copyright Volker Schukai
+ * @summary A logging handler that writes Monster log entries to the browser console.
  */
 class ConsoleHandler extends Handler {
 	/**

package/source/logging/handler.mjs

@@ -25,6 +25,7 @@ export { Handler };
  * @license AGPLv3
  * @since 1.5.0
  * @copyright Volker Schukai
+ * @summary A logging handler base class for processing and exporting log entries.
  */
 class Handler extends Base {
 	constructor() {

package/source/logging/logentry.mjs

@@ -23,6 +23,7 @@ export { LogEntry };
  * @license AGPLv3
  * @since 1.5.0
  * @copyright Volker Schukai
+ * @summary A log entry value object that stores level, message, context and timestamp information.
  */
 class LogEntry extends Base {
 	/**

package/source/logging/logger.mjs

@@ -71,6 +71,7 @@ const OFF = 0;
  * @license AGPLv3
  * @since 1.5.0
  * @copyright Volker Schukai
+ * @summary A logger for collecting log entries and forwarding them to one or more handlers.
  */
 class Logger extends Base {
 	/**

package/source/net/webconnect/message.mjs

@@ -25,7 +25,7 @@ const dataSymbol = Symbol("@@data");
  * @license AGPLv3
  * @since 3.4.0
  * @copyright Volker Schukai
- * @summary The Message class encapsulates a WebSocket message.
+ * @summary A structured WebSocket message object for typed payload exchange over WebConnect.
  */
 class Message extends Base {
 	/**

package/source/net/webconnect.mjs

@@ -213,7 +213,7 @@ function connectServer(resolve, reject) {
  * @license AGPLv3
  * @since 3.1.0
  * @copyright Volker Schukai
- * @summary The LocalStorage class encapsulates the access to data objects.
+ * @summary A WebSocket connection wrapper for sending, receiving and observing structured real-time messages.
  */
 class WebConnect extends BaseWithOptions {
 	/**