@schukai/monster 4.131.0 → 4.133.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.131.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.133.0"}

package/source/components/accessibility/locale-picker.mjs

@@ -84,7 +84,7 @@ const detectedLanguagesSymbol = Symbol("detectedLanguages");
  *
  * @since 3.97.0
  * @copyright Volker Schukai
- * @summary A beautiful LocalePicker that can make your life easier and also looks good.
+ * @summary A locale picker for choosing and resetting language decisions in multilingual interfaces.
  */
 class LocalePicker extends CustomElement {
 	/**

package/source/components/accessibility/locale-select.mjs

@@ -113,7 +113,7 @@ function getLocalizedLabel() {
  *
  * @since 3.97.0
  * @copyright Volker Schukai
- * @summary A simple language switcher as a select.
+ * @summary A select-based locale switcher for multilingual forms, apps and documentation surfaces.
  */
 class LocaleSelect extends CustomElement {
 	/**

package/source/components/content/camera-capture.mjs

@@ -82,7 +82,7 @@ const emptyHistoryStateElementSymbol = Symbol("emptyHistoryStateElement");
  *
  * @since 3.111.0
  * @copyright Volker Schukai
- * @summary A simple but powerful camera capture component. It can be used to capture images from the camera.
+ * @summary A camera capture component for taking images directly from an available device camera.
  * @fires monster-camera-capture-captured
  */
 class CameraCapture extends CustomElement {

package/source/components/content/copy.mjs

@@ -88,7 +88,7 @@ const resizeObserverSymbol = Symbol("resizeObserver");
  *
  * @since 3.77.0
  * @copyright Volker Schukai
- * @summary A beautiful Copy that can make your life easier and also looks good.
+ * @summary A copy helper that copies values or text snippets to the clipboard from a clear UI trigger.
  */
 class Copy extends CustomElement {
 	/**

package/source/components/content/fetch-box.mjs

@@ -39,7 +39,7 @@ export const fetchBoxElementSymbol = Symbol("fetchBoxElement");
  *
  * @since 3.115.0
  * @copyright Volker Schukai
- * @summary A beautiful FetchBox that can make your life easier and also looks good. Its like a box, but it fetches data from a URL.
+ * @summary A fetch-driven content box that loads remote fragments or responses into a visible UI surface.
  */
 class FetchBox extends CustomElement {
 	/**

package/source/components/content/image-editor.mjs

@@ -278,7 +278,7 @@ const rotateResetButtonElementSymbol = Symbol("rotateResetButtonElement");
  *
  * @since 4.68.0
  * @copyright Volker Schukai
- * @summary An image editor for cropping and basic filters.
+ * @summary An image editor for cropping, rotation and lightweight visual adjustments before upload or storage.
  * @fires monster-image-editor-saved
  */
 class ImageEditor extends CustomElement {

package/source/components/content/viewer.mjs

@@ -59,7 +59,7 @@ const downloadRevokeSymbol = Symbol("downloadRevoke");
  * @example /examples/components/content/html-viewer with HTML content
  *
  * @copyright Volker Schukai
- * @summary A simple viewer component for PDF, HTML, and images.
+ * @summary A viewer component for embedded PDFs, HTML documents and images inside Monster layouts.
  */
 class Viewer extends CustomElement {
 	/**

package/source/components/data/kpi-tile.mjs

@@ -32,7 +32,7 @@ export { KpiTile };
  *
  * @since 4.38.0
  * @copyright Volker Schukai
- * @summary A KPI Tile Control that displays key performance indicators in a tile format.
+ * @summary A KPI tile for highlighting one key metric with label, value and supporting context.
  */
 class KpiTile extends CustomElement {
 	static get [instanceSymbol]() {

package/source/components/data/metric-graph.mjs

@@ -49,7 +49,7 @@ export const metricGraphControlElementSymbol = Symbol(
  *
  * @since 4.11.0
  * @copyright Volker Schukai
- * @summary A beautiful MetricGraph that can make your life easier and also looks good.
+ * @summary A metric graph for showing trend direction and compact historical context around one value.
  */
 class MetricGraph extends CustomElement {
 	/**

package/source/components/data/metric.mjs

@@ -45,7 +45,7 @@ export const metricControlElementSymbol = Symbol("metricControlElement");
  *
  * @since 4.11.0
  * @copyright Volker Schukai
- * @summary A beautiful Metric that can make your life easier and also looks good.
+ * @summary A metric display for one key number with compact labeling and status-oriented emphasis.
  */
 class Metric extends CustomElement {
 	/**

package/source/components/datatable/datasource.mjs

@@ -40,7 +40,7 @@ const dataSourceSymbol = Symbol.for(
  * @issue https://localhost.alvine.dev:8440/development/issues/closed/272.html
  *
  * @copyright Volker Schukai
- * @summary A generic datasource
+ * @summary A generic datasource bridge for connecting datatables and controls to structured data providers.
  */
 class Datasource extends CustomElement {
 	/**

package/source/components/datatable/datatable.mjs

@@ -160,7 +160,7 @@ const suppressColumnConfigSaveSymbol = Symbol("suppressColumnConfigSave");
  * @issue https://localhost.alvine.dev:8440/development/issues/closed/289.html
  *
  * @copyright Volker Schukai
- * @summary A beautiful and highly customizable data table. It can be used to display data from a data source.
+ * @summary A configurable data table for datasets, datasources, filtering, sorting, pagination and row selection workflows.
  * @fires monster-datatable-row-copied
  * @fires monster-datatable-row-removed
  * @fires monster-datatable-row-added

package/source/components/datatable/filter-button.mjs

@@ -24,7 +24,7 @@ export { FilterButton };
  * A FilterButton is a button that can be used to show the filter.
  *
  * @copyright Volker Schukai
- * @summary A Button that can be used to show the filter.
+ * @summary A toggle button that opens or closes a datatable filter area.
  */
 class FilterButton extends ToggleButton {
 	/**

package/source/components/datatable/pagination.mjs

@@ -106,7 +106,7 @@ const compactNextIcon = `<svg xmlns="http://www.w3.org/2000/svg" width="16" heig
  * @example /examples/components/datatable/pagination-programmatic Programmatic pagination state
  *
  * @copyright Volker Schukai
- * @summary The Pagination component is used to show the current page and the total number of pages.
+ * @summary A pagination control for navigating multi-page result sets and synchronizing table state.
  */
 class Pagination extends CustomElement {
 	/**

package/source/components/datatable/save-button.mjs

@@ -89,7 +89,7 @@ const internalDisableVersionSymbol = Symbol("internalDisableVersion");
  * @issue https://localhost.alvine.dev:8440/development/issues/closed/274.html
  *
  * @copyright Volker Schukai
- * @summary This is a save button component that can be used to save changes to a datasource.
+ * @summary A save button for persisting datasource changes with explicit workflow feedback and update handling.
  */
 class SaveButton extends CustomElement {
 	/**

package/source/components/datatable/status.mjs

@@ -57,7 +57,7 @@ const spinnerElementSymbol = Symbol("spinnerElement");
  * @issue https://localhost.alvine.dev:8440/development/issues/closed/274.html
  *
  * @copyright Volker Schukai
- * @summary The Status component is used to show the current status of a datasource.
+ * @summary A datasource status indicator for loading, empty, error and ready states in table workflows.
  */
 class DatasourceStatus extends CustomElement {
 	/**

package/source/components/files/file-manager.mjs

@@ -140,7 +140,7 @@ const saveAllButtonSymbol = Symbol("saveAllButton");
  * @example /examples/components/files/file-manager-basic Basic file manager workflow
  *
  * @since 4.44.0
- * @summary A file manager control that builds a tree navigation from an API and opens files in tabs.
+ * @summary A file manager that loads a remote file tree and opens selected files in tabbed views.
  */
 class FileManager extends CustomElement {
 	/**

package/source/components/form/action-button.mjs

@@ -53,7 +53,7 @@ const containerElementSymbol = Symbol("containerElement");
  *
  * @since 3.32.0
  * @copyright Volker Schukai
- * @summary The ActionButton is a button that opens a popper element with possible actions
+ * @summary A button that opens a popper with contextual actions such as edit, duplicate or archive.
  */
 class ActionButton extends PopperButton {
 	/**

package/source/components/form/api-button.mjs

@@ -61,7 +61,7 @@ const containerElementSymbol = Symbol("containerElement");
  *
  * @since 3.32.0
  * @copyright Volker Schukai
- * @summary An API button that loads actions dynamically and executes follow-up requests
+ * @summary An action button that loads commands from an API and executes follow-up requests with success and failure events.
  * @fires monster-button-set
  * @fires monster-api-button-click
  * @fires monster-api-button-successful

package/source/components/form/button-bar.mjs

@@ -147,7 +147,7 @@ const ATTRIBUTE_LAYOUT_ALIGNMENT = "data-monster-layout-alignment";
  * @example /examples/components/form/button-bar-simple Button bar
  *
  * @copyright Volker Schukai
- * @summary This is a button bar control that can be used to display a set of buttons.
+ * @summary A responsive button bar that groups multiple actions and moves overflowed buttons into a menu.
  * @fires monster-fetched
  */
 class ButtonBar extends CustomElement {

package/source/components/form/button.mjs

@@ -53,7 +53,7 @@ export const buttonElementSymbol = Symbol("buttonElement");
  * @issue https://localhost.alvine.dev:8440/development/issues/closed/283.html
  *
  * @copyright Volker Schukai
- * @summary A beautiful button that can make your life easier and also looks good.
+ * @summary A form-aware button component for primary actions, event handling and consistent Monster styling.
  * @fires monster-button-clicked this event is triggered when the button is clicked. It contains the field {button} with the button instance.
  */
 class Button extends CustomControl {

package/source/components/form/buy-box.mjs

@@ -189,7 +189,7 @@ const pricingCacheSymbol = Symbol("pricingCache");
  *
  * @example /examples/components/form/buy-box-basic Basic buy box
  *
- * @summary Product buy box control with variants, quantity, pricing, and add-to-cart.
+ * @summary A commerce buy box for product variants, quantity changes, pricing updates and add-to-cart actions.
  * @since 4.65.0
  * @fires monster-buy-box-change
  * @fires monster-buy-box-valid

package/source/components/form/confirm-button.mjs

@@ -54,7 +54,7 @@ const cancelButtonElementSymbol = Symbol("cancelButtonElement");
  *
  * @since 1.5.0
  * @copyright Volker Schukai
- * @summary A confirm button control allowing the user to confirm or cancel an action
+ * @summary A two-step confirmation button for destructive or high-impact actions such as delete or publish.
  */
 class ConfirmButton extends PopperButton {
 	/**

package/source/components/form/context-error.mjs

@@ -64,7 +64,7 @@ const iconElementSymbol = Symbol("iconElement");
  *
  * @since 3.55.0
  * @copyright Volker Schukai
- * @summary A context error control
+ * @summary A contextual error message block for validation problems and inline form feedback.
  */
 class ContextError extends Popper {
 	/**

package/source/components/form/context-help.mjs

@@ -29,7 +29,7 @@ export { ContextHelp };
  *
  * @since 3.29.0
  * @copyright Volker Schukai
- * @summary A context help control
+ * @summary A contextual help block for inline guidance, field descriptions and lightweight explanations.
  */
 class ContextHelp extends ContextBase {
 	/**

package/source/components/form/credential-button.mjs

@@ -57,7 +57,7 @@ const passwordWiredSymbol = Symbol("passwordWired");
  *
  * @since 3.91.0
  * @copyright Volker Schukai
- * @summary A popper button that opens a password change form.
+ * @summary A credential action button that opens a password or secret update flow in a controlled popper.
  * @fires monster-credential-submit
  * @fires monster-credential-successful
  * @fires monster-credential-failed

package/source/components/form/dropzone.mjs

@@ -97,7 +97,7 @@ const fileTimeoutMapSymbol = Symbol("fileTimeoutMap");
  *
  * @since 4.40.0
  * @copyright Volker Schukai
- * @summary A dropzone control for uploading documents via click or drag and drop.
+ * @summary A file upload dropzone for drag-and-drop or click-based document and media uploads.
  *
  * @fires monster-dropzone-selected
  * @fires monster-dropzone-file-added

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

@@ -80,7 +80,7 @@ const extendedSwitchElementSymbol = Symbol("extendedSwitchElement");
  *
  * @since 3.65.0
  * @copyright Volker Schukai
- * @summary A field set control
+ * @summary A grouped form field set with shared legend, structure and consistent spacing for related controls.
  */
 class FieldSet extends CustomControl {
 	/**

package/source/components/form/form.mjs

@@ -56,7 +56,7 @@ const debounceBindSymbol = Symbol("debounceBind");
  *
  * @since 1.0.0
  * @copyright Volker Schukai
- * @summary A form control
+ * @summary A structured form container for Monster controls, validation flows and consistent submission handling.
  * @fires monster-options-set
  * @fires monster-selected
  * @fires monster-change

package/source/components/form/message-state-button.mjs

@@ -56,7 +56,7 @@ const MESSAGE_LAYOUT_WIDE = "wide";
  *
  * @since 2.11.0
  * @copyright Volker Schukai
- * @summary Button component with integrated message display and state management
+ * @summary A stateful button that combines action feedback, progress states and inline status messaging.
  * @fires monster-state-changed - Fired when button state changes
  * @fires monster-message-shown - Fired when message is displayed
  * @fires monster-message-hidden - Fired when message is hidden

package/source/components/form/quantity.mjs

@@ -58,7 +58,7 @@ const holdIntervalSymbol = Symbol("holdInterval");
  *
  * @since 4.41.0
  * @copyright Volker Schukai
- * @summary A beautiful quantity control with increment and decrement buttons
+ * @summary A quantity stepper with increment and decrement controls for counts, amounts and order quantities.
  * @fires monster-quantity-change
  */
 class Quantity extends CustomControl {

package/source/components/form/select.mjs

@@ -364,7 +364,7 @@ const FILTER_POSITION_INLINE = "inline";
  * @example /examples/components/form/select-summary-template Using a summary template for selections
  *
  * @copyright Volker Schukai
- * @summary A beautiful select control that can make your life easier and also looks good.
+ * @summary A searchable select control with single or multiple values, lazy loading, remote filtering and lookup support.
  * @fires monster-change
  * @fires monster-changed
  * @fires monster-options-set this event is fired when the options are set

package/source/components/form/toggle-switch.mjs

@@ -62,7 +62,7 @@ export const STATE_OFF = "off";
  *
  * @since 3.57.0
  * @copyright Volker Schukai
- * @summary A beautiful switch element
+ * @summary A toggle switch for binary settings, feature flags and compact on-off decisions.
  * @fires monster-options-set
  * @fires monster-selected
  * @fires monster-change

package/source/components/form/tree-select.mjs

@@ -66,7 +66,7 @@ const keyEventHandler = Symbol("keyEventHandler");
  *
  * @since 1.9.0
  * @copyright Volker Schukai
- * @summary A beautiful tree select control with a lot of options
+ * @summary A hierarchical select control for nested options, categories and tree-based selection workflows.
  * @fires monster-options-set
  * @fires monster-selected
  * @fires monster-change

package/source/components/form/variant-select.mjs

@@ -113,7 +113,7 @@ const initGuardSymbol = Symbol("initGuard");
  * @example /examples/components/form/variant-select-messages-off Messages off
  * @example /examples/components/form/variant-select-remote Remote data
  *
- * @summary A control to pick valid variant combinations (e.g., color/size).
+ * @summary A variant picker for valid product combinations such as color, size and availability-dependent choices.
  * @since 4.64.0
  * @fires monster-variant-select-change
  * @fires monster-variant-select-valid

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/layout/board.mjs

@@ -51,7 +51,7 @@ export const parkingElementSymbol = Symbol("parkingElement");
  *
  * @since 3.116.0
  * @copyright Volker Schukai
- * @summary A beautiful Board that can make your life easier and also looks good. You can use it to create a board, a dashboard, a kanban board, or whatever you want. It is a grid layout with drag and drop support.
+ * @summary A board layout with drag-and-drop support for dashboards, kanban views and modular content grids.
  */
 class Board extends CustomElement {
 	/**

package/source/components/layout/collapse.mjs

@@ -102,7 +102,7 @@ const nameSymbol = Symbol("name");
  *
  * @since 3.74.0
  * @copyright Volker Schukai
- * @summary  A simple collapse component.
+ * @summary A collapse component for expandable sections, progressive disclosure and accordion-style content.
  */
 class Collapse extends CustomElement {
 	/**

package/source/components/layout/details.mjs

@@ -50,8 +50,7 @@ const buttonEventHandlerSymbol = Symbol("buttonEventHandler");
  *
  * @since 3.74.0
  * @copyright Volker Schukai
- * @summary A simple but cool detail component. This is based on the collapse component and extends it with a button.
- * @summary You can also easily build an accordion from the component.
+ * @summary A details layout component for expandable content blocks and accessible accordion-like sections.
  */
 class Details extends Collapse {
 	/**

package/source/components/layout/full-screen.mjs

@@ -57,7 +57,7 @@ export const fullScreenExitElementSymbol = Symbol("fullScreenExitElement");
  *
  * @since 4.10.0
  * @copyright Volker Schukai
- * @summary A beautiful FullScreen that can make your life easier and also looks good.
+ * @summary A fullscreen wrapper for media, focused work modes and immersive single-surface interactions.
  */
 class FullScreen extends CustomElement {
 	/**

package/source/components/layout/iframe.mjs

@@ -60,7 +60,7 @@ const timerCallbackSymbol = Symbol("timerCallback");
  *
  * @since 3.76.0
  * @copyright Volker Schukai
- * @summary A cool and fancy Iframe that can make your life easier and also looks good.
+ * @summary An iframe wrapper for embedded tools, remote documents and external content inside Monster layouts.
  */
 class Iframe extends CustomElement {
 	/**

package/source/components/layout/overlay.mjs

@@ -73,7 +73,7 @@ const ATTRIBUTE_VALUE_OVERLAY_OPEN = "overlay-open";
  * @example /examples/components/layout/overlay-programmatic Programmatic Overlay Control
  *
  * @copyright Volker Schukai
- * @summary The Overlay component is used to show an overlay and a button to open the overlay.
+ * @summary A layout overlay for dialogs, confirmations and temporary detail views with programmatic open and close control.
  * @fires monster-overlay-before-open
  * @fires monster-overlay-open
  * @fires monster-overlay-before-close

package/source/components/layout/panel.mjs

@@ -53,7 +53,7 @@ const timerCallbackSymbol = Symbol("timerCallback");
  *
  * @since 3.54.0
  * @copyright Volker Schukai
- * @summary The Panel component is used to display a panel, isn't that cool?
+ * @summary A layout panel for side content, supporting information and contextual tool areas.
  */
 class Panel extends CustomElement {
 	/**

package/source/components/layout/slider.mjs

@@ -78,7 +78,7 @@ const configSymbol = Symbol("config");
  *
  * @since 3.74.0
  * @copyright Volker Schukai
- * @summary Provides a responsive, touch-enabled slider or carousel component with features like autoplay, thumbnails, and looping.
+ * @summary A responsive slider or carousel with touch support, autoplay, thumbnails and looping behavior.
  * @fires monster-slider-resized - Fired when the slider's dimensions change.
  * @fires monster-slider-moved - Fired when the slider moves to a new slide.
  */

package/source/components/layout/split-panel.mjs

@@ -77,7 +77,7 @@ const TYPE_HORIZONTAL = "horizontal";
  *
  * @since 3.54.0
  * @copyright Volker Schukai
- * @summary The SplitPanel control is a simple layout control that allows you to split the screen
+ * @summary A split-panel layout that divides available space into resizable primary and secondary areas.
  * into two parts. The split can be either vertical or horizontal. The control provides a
  * draggable handle that allows you to adjust the size of the two panels.
  */

package/source/components/layout/tabs.mjs

@@ -158,7 +158,7 @@ const resizeObserverSymbol = Symbol("resizeObserver");
  *
  * @since 3.74.0
  * @copyright Volker Schukai
- * @summary This CustomControl creates a tab element with a variety of options.
+ * @summary A tabbed layout control for switching between related views without leaving the current page context.
  */
 class Tabs extends CustomElement {
 	/**

package/source/components/layout/width-toggle.mjs

@@ -64,9 +64,7 @@ const MODE_WIDE = "wide";
  *
  * @since 3.57.0
  * @copyright Volker Schukai
- * @summary The WidthToggle component allows users to dynamically change the width of a panel by clicking a button.
- * @summary This feature improves readability and space utilization by allowing the panel width to be adjusted
- * @summary according to user preferences.
+ * @summary A width toggle control that lets users switch between compact and expanded reading or panel widths.
  */
 class WidthToggle extends CustomElement {
 	/**

package/source/components/navigation/site-navigation.mjs

@@ -48,7 +48,7 @@ const hamburgerCloseButtonSymbol = Symbol("hamburgerCloseButton");
  * A responsive site navigation that automatically moves menu items into a hamburger menu
  * when there isn't enough available space.
  *
- * @summary An adaptive navigation component that supports hover and click interactions for submenus.
+ * @summary A site navigation component for primary menus with adaptive submenu behavior.
  * @fragments /fragments/components/navigation/site-navigation/
  *
  * @example /examples/components/navigation/site-navigation-simple Simple Navigation

package/source/components/navigation/table-of-content.mjs

@@ -77,7 +77,7 @@ const scrollableEventHandlerSymbol = Symbol("scrollableEventHandler");
  *
  * @since 3.65.0
  * @copyright Volker Schukai
- * @summary A beautiful TableOfContent that can make your life easier and also looks good.
+ * @summary A table-of-content navigation that links headings and helps users scan long structured pages.
  * @fires new-top The new top position
  */
 class TableOfContent extends CustomElement {

package/source/components/navigation/wizard-navigation.mjs

@@ -28,7 +28,7 @@ const currentSubStepIndexSymbol = Symbol("currentSubStepIndex");
  * @example /examples/components/navigation/wizard-navigation-simple
  * @since 4.26.0
  * @copyright Volker Schukai
- * @summary A vertical step-by-step navigation component for wizards.
+ * @summary A step-by-step wizard navigation for multi-stage forms and guided setup flows.
  * @fires monster-wizard-step-changed - Fired when the main active step changes.
  * @fires monster-wizard-substep-changed - Fired when the active sub-step changes.
  * @fires monster-wizard-completed - Fired when the entire wizard is marked as complete via completeAll().

package/source/components/notify/message.mjs

@@ -76,7 +76,7 @@ const removeEventHandlerSymbol = Symbol("removeEventHandler");
  *
  * @since 1.0.0
  * @copyright Volker Schukai
- * @summary The message is a notification element that can be used to display messages to the user. Typically, it is only used in conjunction with the notify container.
+ * @summary A single notification message element, typically rendered inside the notify container.
  */
 class Message extends CustomElement {
 	/**

package/source/components/notify/notify.mjs

@@ -56,7 +56,7 @@ const queueSymbol = Symbol("queue");
  *
  * @since 1.0.0
  * @copyright Volker Schukai
- * @summary The Notify control is a notification container that can be used to display messages to the user.
+ * @summary A notification container for stacking, timing and managing transient user messages.
  */
 class Notify extends CustomElement {
 	constructor() {

package/source/components/state/log.mjs

@@ -64,7 +64,7 @@ const timeAgoIntervalSymbol = Symbol("timeAgoInterval");
  *
  * @since 3.74.0
  * @copyright Volker Schukai
- * @summary The log entry is a single entry in the log.
+ * @summary A log component for rendering ordered state changes, events or activity entries.
  **/
 class Log extends CustomElement {
 	/**

package/source/components/state/state.mjs

@@ -32,8 +32,7 @@ export { State };
  *
  * @since 1.5.0
  * @copyright Volker Schukai
- * @summary States tell users that there’s a state. That's it!
- * @summary The state control is used in the log control, among other things.
+ * @summary A compact state indicator for statuses such as success, warning, error or informational workflow state.
  **/
 class State extends CustomControl {
 	/**

package/source/components/state/thread.mjs

@@ -60,7 +60,7 @@ const timeAgoIntervalSymbol = Symbol("timeAgoInterval");
  *
  * @since 3.77.0
  * @copyright Volker Schukai
- * @summary The thread control visualizes nested discussion entries.
+ * @summary A threaded discussion layout for nested replies, comments and conversation-like content.
  **/
 class Thread extends CustomElement {
 	/**

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 {
 	/**