@schukai/monster 4.130.1 → 4.132.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (55) hide show
  1. package/package.json +1 -1
  2. package/source/components/accessibility/locale-picker.mjs +1 -1
  3. package/source/components/accessibility/locale-select.mjs +1 -1
  4. package/source/components/content/camera-capture.mjs +1 -1
  5. package/source/components/content/copy.mjs +1 -1
  6. package/source/components/content/fetch-box.mjs +1 -1
  7. package/source/components/content/image-editor.mjs +1 -1
  8. package/source/components/content/viewer.mjs +1 -1
  9. package/source/components/data/kpi-tile.mjs +1 -1
  10. package/source/components/data/metric-graph.mjs +1 -1
  11. package/source/components/data/metric.mjs +1 -1
  12. package/source/components/datatable/datasource.mjs +1 -1
  13. package/source/components/datatable/datatable.mjs +1 -1
  14. package/source/components/datatable/filter-button.mjs +1 -1
  15. package/source/components/datatable/pagination.mjs +1 -1
  16. package/source/components/datatable/save-button.mjs +1 -1
  17. package/source/components/datatable/status.mjs +1 -1
  18. package/source/components/files/file-manager.mjs +1 -1
  19. package/source/components/form/action-button.mjs +1 -1
  20. package/source/components/form/api-button.mjs +1 -1
  21. package/source/components/form/button-bar.mjs +1 -1
  22. package/source/components/form/button.mjs +1 -1
  23. package/source/components/form/buy-box.mjs +1 -1
  24. package/source/components/form/confirm-button.mjs +1 -1
  25. package/source/components/form/context-error.mjs +1 -1
  26. package/source/components/form/context-help.mjs +1 -1
  27. package/source/components/form/credential-button.mjs +1 -1
  28. package/source/components/form/dropzone.mjs +1 -1
  29. package/source/components/form/field-set.mjs +1 -1
  30. package/source/components/form/form.mjs +1 -1
  31. package/source/components/form/message-state-button.mjs +1 -1
  32. package/source/components/form/quantity.mjs +1 -1
  33. package/source/components/form/select.mjs +1 -1
  34. package/source/components/form/toggle-switch.mjs +1 -1
  35. package/source/components/form/tree-select.mjs +1 -1
  36. package/source/components/form/variant-select.mjs +1 -1
  37. package/source/components/layout/board.mjs +2 -1
  38. package/source/components/layout/collapse.mjs +2 -1
  39. package/source/components/layout/details.mjs +1 -2
  40. package/source/components/layout/full-screen.mjs +2 -1
  41. package/source/components/layout/iframe.mjs +2 -1
  42. package/source/components/layout/overlay.mjs +2 -1
  43. package/source/components/layout/panel.mjs +2 -1
  44. package/source/components/layout/slider.mjs +1 -1
  45. package/source/components/layout/split-panel.mjs +2 -1
  46. package/source/components/layout/tabs.mjs +1 -1
  47. package/source/components/layout/width-toggle.mjs +2 -3
  48. package/source/components/navigation/site-navigation.mjs +1 -1
  49. package/source/components/navigation/table-of-content.mjs +1 -1
  50. package/source/components/navigation/wizard-navigation.mjs +1 -1
  51. package/source/components/notify/message.mjs +1 -1
  52. package/source/components/notify/notify.mjs +1 -1
  53. package/source/components/state/log.mjs +1 -1
  54. package/source/components/state/state.mjs +1 -2
  55. package/source/components/state/thread.mjs +1 -1
package/package.json CHANGED
@@ -1 +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.130.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"}
@@ -84,7 +84,7 @@ const detectedLanguagesSymbol = Symbol("detectedLanguages");
84
84
  *
85
85
  * @since 3.97.0
86
86
  * @copyright Volker Schukai
87
- * @summary A beautiful LocalePicker that can make your life easier and also looks good.
87
+ * @summary A locale picker for choosing and resetting language decisions in multilingual interfaces.
88
88
  */
89
89
  class LocalePicker extends CustomElement {
90
90
  /**
@@ -113,7 +113,7 @@ function getLocalizedLabel() {
113
113
  *
114
114
  * @since 3.97.0
115
115
  * @copyright Volker Schukai
116
- * @summary A simple language switcher as a select.
116
+ * @summary A select-based locale switcher for multilingual forms, apps and documentation surfaces.
117
117
  */
118
118
  class LocaleSelect extends CustomElement {
119
119
  /**
@@ -82,7 +82,7 @@ const emptyHistoryStateElementSymbol = Symbol("emptyHistoryStateElement");
82
82
  *
83
83
  * @since 3.111.0
84
84
  * @copyright Volker Schukai
85
- * @summary A simple but powerful camera capture component. It can be used to capture images from the camera.
85
+ * @summary A camera capture component for taking images directly from an available device camera.
86
86
  * @fires monster-camera-capture-captured
87
87
  */
88
88
  class CameraCapture extends CustomElement {
@@ -88,7 +88,7 @@ const resizeObserverSymbol = Symbol("resizeObserver");
88
88
  *
89
89
  * @since 3.77.0
90
90
  * @copyright Volker Schukai
91
- * @summary A beautiful Copy that can make your life easier and also looks good.
91
+ * @summary A copy helper that copies values or text snippets to the clipboard from a clear UI trigger.
92
92
  */
93
93
  class Copy extends CustomElement {
94
94
  /**
@@ -39,7 +39,7 @@ export const fetchBoxElementSymbol = Symbol("fetchBoxElement");
39
39
  *
40
40
  * @since 3.115.0
41
41
  * @copyright Volker Schukai
42
- * @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.
42
+ * @summary A fetch-driven content box that loads remote fragments or responses into a visible UI surface.
43
43
  */
44
44
  class FetchBox extends CustomElement {
45
45
  /**
@@ -278,7 +278,7 @@ const rotateResetButtonElementSymbol = Symbol("rotateResetButtonElement");
278
278
  *
279
279
  * @since 4.68.0
280
280
  * @copyright Volker Schukai
281
- * @summary An image editor for cropping and basic filters.
281
+ * @summary An image editor for cropping, rotation and lightweight visual adjustments before upload or storage.
282
282
  * @fires monster-image-editor-saved
283
283
  */
284
284
  class ImageEditor extends CustomElement {
@@ -59,7 +59,7 @@ const downloadRevokeSymbol = Symbol("downloadRevoke");
59
59
  * @example /examples/components/content/html-viewer with HTML content
60
60
  *
61
61
  * @copyright Volker Schukai
62
- * @summary A simple viewer component for PDF, HTML, and images.
62
+ * @summary A viewer component for embedded PDFs, HTML documents and images inside Monster layouts.
63
63
  */
64
64
  class Viewer extends CustomElement {
65
65
  /**
@@ -32,7 +32,7 @@ export { KpiTile };
32
32
  *
33
33
  * @since 4.38.0
34
34
  * @copyright Volker Schukai
35
- * @summary A KPI Tile Control that displays key performance indicators in a tile format.
35
+ * @summary A KPI tile for highlighting one key metric with label, value and supporting context.
36
36
  */
37
37
  class KpiTile extends CustomElement {
38
38
  static get [instanceSymbol]() {
@@ -49,7 +49,7 @@ export const metricGraphControlElementSymbol = Symbol(
49
49
  *
50
50
  * @since 4.11.0
51
51
  * @copyright Volker Schukai
52
- * @summary A beautiful MetricGraph that can make your life easier and also looks good.
52
+ * @summary A metric graph for showing trend direction and compact historical context around one value.
53
53
  */
54
54
  class MetricGraph extends CustomElement {
55
55
  /**
@@ -45,7 +45,7 @@ export const metricControlElementSymbol = Symbol("metricControlElement");
45
45
  *
46
46
  * @since 4.11.0
47
47
  * @copyright Volker Schukai
48
- * @summary A beautiful Metric that can make your life easier and also looks good.
48
+ * @summary A metric display for one key number with compact labeling and status-oriented emphasis.
49
49
  */
50
50
  class Metric extends CustomElement {
51
51
  /**
@@ -40,7 +40,7 @@ const dataSourceSymbol = Symbol.for(
40
40
  * @issue https://localhost.alvine.dev:8440/development/issues/closed/272.html
41
41
  *
42
42
  * @copyright Volker Schukai
43
- * @summary A generic datasource
43
+ * @summary A generic datasource bridge for connecting datatables and controls to structured data providers.
44
44
  */
45
45
  class Datasource extends CustomElement {
46
46
  /**
@@ -160,7 +160,7 @@ const suppressColumnConfigSaveSymbol = Symbol("suppressColumnConfigSave");
160
160
  * @issue https://localhost.alvine.dev:8440/development/issues/closed/289.html
161
161
  *
162
162
  * @copyright Volker Schukai
163
- * @summary A beautiful and highly customizable data table. It can be used to display data from a data source.
163
+ * @summary A configurable data table for datasets, datasources, filtering, sorting, pagination and row selection workflows.
164
164
  * @fires monster-datatable-row-copied
165
165
  * @fires monster-datatable-row-removed
166
166
  * @fires monster-datatable-row-added
@@ -24,7 +24,7 @@ export { FilterButton };
24
24
  * A FilterButton is a button that can be used to show the filter.
25
25
  *
26
26
  * @copyright Volker Schukai
27
- * @summary A Button that can be used to show the filter.
27
+ * @summary A toggle button that opens or closes a datatable filter area.
28
28
  */
29
29
  class FilterButton extends ToggleButton {
30
30
  /**
@@ -106,7 +106,7 @@ const compactNextIcon = `<svg xmlns="http://www.w3.org/2000/svg" width="16" heig
106
106
  * @example /examples/components/datatable/pagination-programmatic Programmatic pagination state
107
107
  *
108
108
  * @copyright Volker Schukai
109
- * @summary The Pagination component is used to show the current page and the total number of pages.
109
+ * @summary A pagination control for navigating multi-page result sets and synchronizing table state.
110
110
  */
111
111
  class Pagination extends CustomElement {
112
112
  /**
@@ -89,7 +89,7 @@ const internalDisableVersionSymbol = Symbol("internalDisableVersion");
89
89
  * @issue https://localhost.alvine.dev:8440/development/issues/closed/274.html
90
90
  *
91
91
  * @copyright Volker Schukai
92
- * @summary This is a save button component that can be used to save changes to a datasource.
92
+ * @summary A save button for persisting datasource changes with explicit workflow feedback and update handling.
93
93
  */
94
94
  class SaveButton extends CustomElement {
95
95
  /**
@@ -57,7 +57,7 @@ const spinnerElementSymbol = Symbol("spinnerElement");
57
57
  * @issue https://localhost.alvine.dev:8440/development/issues/closed/274.html
58
58
  *
59
59
  * @copyright Volker Schukai
60
- * @summary The Status component is used to show the current status of a datasource.
60
+ * @summary A datasource status indicator for loading, empty, error and ready states in table workflows.
61
61
  */
62
62
  class DatasourceStatus extends CustomElement {
63
63
  /**
@@ -140,7 +140,7 @@ const saveAllButtonSymbol = Symbol("saveAllButton");
140
140
  * @example /examples/components/files/file-manager-basic Basic file manager workflow
141
141
  *
142
142
  * @since 4.44.0
143
- * @summary A file manager control that builds a tree navigation from an API and opens files in tabs.
143
+ * @summary A file manager that loads a remote file tree and opens selected files in tabbed views.
144
144
  */
145
145
  class FileManager extends CustomElement {
146
146
  /**
@@ -53,7 +53,7 @@ const containerElementSymbol = Symbol("containerElement");
53
53
  *
54
54
  * @since 3.32.0
55
55
  * @copyright Volker Schukai
56
- * @summary The ActionButton is a button that opens a popper element with possible actions
56
+ * @summary A button that opens a popper with contextual actions such as edit, duplicate or archive.
57
57
  */
58
58
  class ActionButton extends PopperButton {
59
59
  /**
@@ -61,7 +61,7 @@ const containerElementSymbol = Symbol("containerElement");
61
61
  *
62
62
  * @since 3.32.0
63
63
  * @copyright Volker Schukai
64
- * @summary An API button that loads actions dynamically and executes follow-up requests
64
+ * @summary An action button that loads commands from an API and executes follow-up requests with success and failure events.
65
65
  * @fires monster-button-set
66
66
  * @fires monster-api-button-click
67
67
  * @fires monster-api-button-successful
@@ -147,7 +147,7 @@ const ATTRIBUTE_LAYOUT_ALIGNMENT = "data-monster-layout-alignment";
147
147
  * @example /examples/components/form/button-bar-simple Button bar
148
148
  *
149
149
  * @copyright Volker Schukai
150
- * @summary This is a button bar control that can be used to display a set of buttons.
150
+ * @summary A responsive button bar that groups multiple actions and moves overflowed buttons into a menu.
151
151
  * @fires monster-fetched
152
152
  */
153
153
  class ButtonBar extends CustomElement {
@@ -53,7 +53,7 @@ export const buttonElementSymbol = Symbol("buttonElement");
53
53
  * @issue https://localhost.alvine.dev:8440/development/issues/closed/283.html
54
54
  *
55
55
  * @copyright Volker Schukai
56
- * @summary A beautiful button that can make your life easier and also looks good.
56
+ * @summary A form-aware button component for primary actions, event handling and consistent Monster styling.
57
57
  * @fires monster-button-clicked this event is triggered when the button is clicked. It contains the field {button} with the button instance.
58
58
  */
59
59
  class Button extends CustomControl {
@@ -189,7 +189,7 @@ const pricingCacheSymbol = Symbol("pricingCache");
189
189
  *
190
190
  * @example /examples/components/form/buy-box-basic Basic buy box
191
191
  *
192
- * @summary Product buy box control with variants, quantity, pricing, and add-to-cart.
192
+ * @summary A commerce buy box for product variants, quantity changes, pricing updates and add-to-cart actions.
193
193
  * @since 4.65.0
194
194
  * @fires monster-buy-box-change
195
195
  * @fires monster-buy-box-valid
@@ -54,7 +54,7 @@ const cancelButtonElementSymbol = Symbol("cancelButtonElement");
54
54
  *
55
55
  * @since 1.5.0
56
56
  * @copyright Volker Schukai
57
- * @summary A confirm button control allowing the user to confirm or cancel an action
57
+ * @summary A two-step confirmation button for destructive or high-impact actions such as delete or publish.
58
58
  */
59
59
  class ConfirmButton extends PopperButton {
60
60
  /**
@@ -64,7 +64,7 @@ const iconElementSymbol = Symbol("iconElement");
64
64
  *
65
65
  * @since 3.55.0
66
66
  * @copyright Volker Schukai
67
- * @summary A context error control
67
+ * @summary A contextual error message block for validation problems and inline form feedback.
68
68
  */
69
69
  class ContextError extends Popper {
70
70
  /**
@@ -29,7 +29,7 @@ export { ContextHelp };
29
29
  *
30
30
  * @since 3.29.0
31
31
  * @copyright Volker Schukai
32
- * @summary A context help control
32
+ * @summary A contextual help block for inline guidance, field descriptions and lightweight explanations.
33
33
  */
34
34
  class ContextHelp extends ContextBase {
35
35
  /**
@@ -57,7 +57,7 @@ const passwordWiredSymbol = Symbol("passwordWired");
57
57
  *
58
58
  * @since 3.91.0
59
59
  * @copyright Volker Schukai
60
- * @summary A popper button that opens a password change form.
60
+ * @summary A credential action button that opens a password or secret update flow in a controlled popper.
61
61
  * @fires monster-credential-submit
62
62
  * @fires monster-credential-successful
63
63
  * @fires monster-credential-failed
@@ -97,7 +97,7 @@ const fileTimeoutMapSymbol = Symbol("fileTimeoutMap");
97
97
  *
98
98
  * @since 4.40.0
99
99
  * @copyright Volker Schukai
100
- * @summary A dropzone control for uploading documents via click or drag and drop.
100
+ * @summary A file upload dropzone for drag-and-drop or click-based document and media uploads.
101
101
  *
102
102
  * @fires monster-dropzone-selected
103
103
  * @fires monster-dropzone-file-added
@@ -80,7 +80,7 @@ const extendedSwitchElementSymbol = Symbol("extendedSwitchElement");
80
80
  *
81
81
  * @since 3.65.0
82
82
  * @copyright Volker Schukai
83
- * @summary A field set control
83
+ * @summary A grouped form field set with shared legend, structure and consistent spacing for related controls.
84
84
  */
85
85
  class FieldSet extends CustomControl {
86
86
  /**
@@ -56,7 +56,7 @@ const debounceBindSymbol = Symbol("debounceBind");
56
56
  *
57
57
  * @since 1.0.0
58
58
  * @copyright Volker Schukai
59
- * @summary A form control
59
+ * @summary A structured form container for Monster controls, validation flows and consistent submission handling.
60
60
  * @fires monster-options-set
61
61
  * @fires monster-selected
62
62
  * @fires monster-change
@@ -56,7 +56,7 @@ const MESSAGE_LAYOUT_WIDE = "wide";
56
56
  *
57
57
  * @since 2.11.0
58
58
  * @copyright Volker Schukai
59
- * @summary Button component with integrated message display and state management
59
+ * @summary A stateful button that combines action feedback, progress states and inline status messaging.
60
60
  * @fires monster-state-changed - Fired when button state changes
61
61
  * @fires monster-message-shown - Fired when message is displayed
62
62
  * @fires monster-message-hidden - Fired when message is hidden
@@ -58,7 +58,7 @@ const holdIntervalSymbol = Symbol("holdInterval");
58
58
  *
59
59
  * @since 4.41.0
60
60
  * @copyright Volker Schukai
61
- * @summary A beautiful quantity control with increment and decrement buttons
61
+ * @summary A quantity stepper with increment and decrement controls for counts, amounts and order quantities.
62
62
  * @fires monster-quantity-change
63
63
  */
64
64
  class Quantity extends CustomControl {
@@ -364,7 +364,7 @@ const FILTER_POSITION_INLINE = "inline";
364
364
  * @example /examples/components/form/select-summary-template Using a summary template for selections
365
365
  *
366
366
  * @copyright Volker Schukai
367
- * @summary A beautiful select control that can make your life easier and also looks good.
367
+ * @summary A searchable select control with single or multiple values, lazy loading, remote filtering and lookup support.
368
368
  * @fires monster-change
369
369
  * @fires monster-changed
370
370
  * @fires monster-options-set this event is fired when the options are set
@@ -62,7 +62,7 @@ export const STATE_OFF = "off";
62
62
  *
63
63
  * @since 3.57.0
64
64
  * @copyright Volker Schukai
65
- * @summary A beautiful switch element
65
+ * @summary A toggle switch for binary settings, feature flags and compact on-off decisions.
66
66
  * @fires monster-options-set
67
67
  * @fires monster-selected
68
68
  * @fires monster-change
@@ -66,7 +66,7 @@ const keyEventHandler = Symbol("keyEventHandler");
66
66
  *
67
67
  * @since 1.9.0
68
68
  * @copyright Volker Schukai
69
- * @summary A beautiful tree select control with a lot of options
69
+ * @summary A hierarchical select control for nested options, categories and tree-based selection workflows.
70
70
  * @fires monster-options-set
71
71
  * @fires monster-selected
72
72
  * @fires monster-change
@@ -113,7 +113,7 @@ const initGuardSymbol = Symbol("initGuard");
113
113
  * @example /examples/components/form/variant-select-messages-off Messages off
114
114
  * @example /examples/components/form/variant-select-remote Remote data
115
115
  *
116
- * @summary A control to pick valid variant combinations (e.g., color/size).
116
+ * @summary A variant picker for valid product combinations such as color, size and availability-dependent choices.
117
117
  * @since 4.64.0
118
118
  * @fires monster-variant-select-change
119
119
  * @fires monster-variant-select-valid
@@ -47,10 +47,11 @@ export const parkingElementSymbol = Symbol("parkingElement");
47
47
  * @fragments /fragments/components/layout/board/
48
48
  *
49
49
  * @example /examples/components/layout/board-simple
50
+ * @example /examples/components/layout/board-kanban Kanban Board
50
51
  *
51
52
  * @since 3.116.0
52
53
  * @copyright Volker Schukai
53
- * @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.
54
+ * @summary A board layout with drag-and-drop support for dashboards, kanban views and modular content grids.
54
55
  */
55
56
  class Board extends CustomElement {
56
57
  /**
@@ -98,10 +98,11 @@ const nameSymbol = Symbol("name");
98
98
  * @fragments /fragments/components/layout/collapse/
99
99
  *
100
100
  * @example /examples/components/layout/collapse-simple
101
+ * @example /examples/components/layout/collapse-with-events Collapse With Events
101
102
  *
102
103
  * @since 3.74.0
103
104
  * @copyright Volker Schukai
104
- * @summary A simple collapse component.
105
+ * @summary A collapse component for expandable sections, progressive disclosure and accordion-style content.
105
106
  */
106
107
  class Collapse extends CustomElement {
107
108
  /**
@@ -50,8 +50,7 @@ const buttonEventHandlerSymbol = Symbol("buttonEventHandler");
50
50
  *
51
51
  * @since 3.74.0
52
52
  * @copyright Volker Schukai
53
- * @summary A simple but cool detail component. This is based on the collapse component and extends it with a button.
54
- * @summary You can also easily build an accordion from the component.
53
+ * @summary A details layout component for expandable content blocks and accessible accordion-like sections.
55
54
  */
56
55
  class Details extends Collapse {
57
56
  /**
@@ -53,10 +53,11 @@ export const fullScreenExitElementSymbol = Symbol("fullScreenExitElement");
53
53
  * @fragments /fragments/components/layout/full-screen/
54
54
  *
55
55
  * @example /examples/components/layout/full-screen-simple
56
+ * @example /examples/components/layout/full-screen-media Focus Media View
56
57
  *
57
58
  * @since 4.10.0
58
59
  * @copyright Volker Schukai
59
- * @summary A beautiful FullScreen that can make your life easier and also looks good.
60
+ * @summary A fullscreen wrapper for media, focused work modes and immersive single-surface interactions.
60
61
  */
61
62
  class FullScreen extends CustomElement {
62
63
  /**
@@ -56,10 +56,11 @@ const timerCallbackSymbol = Symbol("timerCallback");
56
56
  * @fragments /fragments/components/layout/iframe/
57
57
  *
58
58
  * @example /examples/components/layout/iframe-simple Simple iframe
59
+ * @example /examples/components/layout/iframe-with-toolbar Iframe With Toolbar
59
60
  *
60
61
  * @since 3.76.0
61
62
  * @copyright Volker Schukai
62
- * @summary A cool and fancy Iframe that can make your life easier and also looks good.
63
+ * @summary An iframe wrapper for embedded tools, remote documents and external content inside Monster layouts.
63
64
  */
64
65
  class Iframe extends CustomElement {
65
66
  /**
@@ -70,9 +70,10 @@ const ATTRIBUTE_VALUE_OVERLAY_OPEN = "overlay-open";
70
70
  * @fragments /fragments/components/layout/overlay/
71
71
  *
72
72
  * @example /examples/components/layout/overlay-simple
73
+ * @example /examples/components/layout/overlay-programmatic Programmatic Overlay Control
73
74
  *
74
75
  * @copyright Volker Schukai
75
- * @summary The Overlay component is used to show an overlay and a button to open the overlay.
76
+ * @summary A layout overlay for dialogs, confirmations and temporary detail views with programmatic open and close control.
76
77
  * @fires monster-overlay-before-open
77
78
  * @fires monster-overlay-open
78
79
  * @fires monster-overlay-before-close
@@ -49,10 +49,11 @@ const timerCallbackSymbol = Symbol("timerCallback");
49
49
  * @fragments /fragments/components/layout/panel/
50
50
  *
51
51
  * @example /examples/components/layout/panel-simple
52
+ * @example /examples/components/layout/panel-command-center Command Center Panel
52
53
  *
53
54
  * @since 3.54.0
54
55
  * @copyright Volker Schukai
55
- * @summary The Panel component is used to display a panel, isn't that cool?
56
+ * @summary A layout panel for side content, supporting information and contextual tool areas.
56
57
  */
57
58
  class Panel extends CustomElement {
58
59
  /**
@@ -78,7 +78,7 @@ const configSymbol = Symbol("config");
78
78
  *
79
79
  * @since 3.74.0
80
80
  * @copyright Volker Schukai
81
- * @summary Provides a responsive, touch-enabled slider or carousel component with features like autoplay, thumbnails, and looping.
81
+ * @summary A responsive slider or carousel with touch support, autoplay, thumbnails and looping behavior.
82
82
  * @fires monster-slider-resized - Fired when the slider's dimensions change.
83
83
  * @fires monster-slider-moved - Fired when the slider moves to a new slide.
84
84
  */
@@ -73,10 +73,11 @@ const TYPE_HORIZONTAL = "horizontal";
73
73
  * @issue https://localhost.alvine.dev:8440/development/issues/closed/184.html
74
74
  *
75
75
  * @example /examples/components/layout/split-panel-simple
76
+ * @example /examples/components/layout/split-panel-presets Split Panel Presets
76
77
  *
77
78
  * @since 3.54.0
78
79
  * @copyright Volker Schukai
79
- * @summary The SplitPanel control is a simple layout control that allows you to split the screen
80
+ * @summary A split-panel layout that divides available space into resizable primary and secondary areas.
80
81
  * into two parts. The split can be either vertical or horizontal. The control provides a
81
82
  * draggable handle that allows you to adjust the size of the two panels.
82
83
  */
@@ -158,7 +158,7 @@ const resizeObserverSymbol = Symbol("resizeObserver");
158
158
  *
159
159
  * @since 3.74.0
160
160
  * @copyright Volker Schukai
161
- * @summary This CustomControl creates a tab element with a variety of options.
161
+ * @summary A tabbed layout control for switching between related views without leaving the current page context.
162
162
  */
163
163
  class Tabs extends CustomElement {
164
164
  /**
@@ -60,12 +60,11 @@ const MODE_WIDE = "wide";
60
60
  * @fragments /fragments/components/layout/width-toggle/
61
61
  *
62
62
  * @example /examples/components/layout/width-toggle-simple Toggle Width
63
+ * @example /examples/components/layout/width-toggle-reader Reader Width Toggle
63
64
  *
64
65
  * @since 3.57.0
65
66
  * @copyright Volker Schukai
66
- * @summary The WidthToggle component allows users to dynamically change the width of a panel by clicking a button.
67
- * @summary This feature improves readability and space utilization by allowing the panel width to be adjusted
68
- * @summary according to user preferences.
67
+ * @summary A width toggle control that lets users switch between compact and expanded reading or panel widths.
69
68
  */
70
69
  class WidthToggle extends CustomElement {
71
70
  /**
@@ -48,7 +48,7 @@ const hamburgerCloseButtonSymbol = Symbol("hamburgerCloseButton");
48
48
  * A responsive site navigation that automatically moves menu items into a hamburger menu
49
49
  * when there isn't enough available space.
50
50
  *
51
- * @summary An adaptive navigation component that supports hover and click interactions for submenus.
51
+ * @summary A site navigation component for primary menus with adaptive submenu behavior.
52
52
  * @fragments /fragments/components/navigation/site-navigation/
53
53
  *
54
54
  * @example /examples/components/navigation/site-navigation-simple Simple Navigation
@@ -77,7 +77,7 @@ const scrollableEventHandlerSymbol = Symbol("scrollableEventHandler");
77
77
  *
78
78
  * @since 3.65.0
79
79
  * @copyright Volker Schukai
80
- * @summary A beautiful TableOfContent that can make your life easier and also looks good.
80
+ * @summary A table-of-content navigation that links headings and helps users scan long structured pages.
81
81
  * @fires new-top The new top position
82
82
  */
83
83
  class TableOfContent extends CustomElement {
@@ -28,7 +28,7 @@ const currentSubStepIndexSymbol = Symbol("currentSubStepIndex");
28
28
  * @example /examples/components/navigation/wizard-navigation-simple
29
29
  * @since 4.26.0
30
30
  * @copyright Volker Schukai
31
- * @summary A vertical step-by-step navigation component for wizards.
31
+ * @summary A step-by-step wizard navigation for multi-stage forms and guided setup flows.
32
32
  * @fires monster-wizard-step-changed - Fired when the main active step changes.
33
33
  * @fires monster-wizard-substep-changed - Fired when the active sub-step changes.
34
34
  * @fires monster-wizard-completed - Fired when the entire wizard is marked as complete via completeAll().
@@ -76,7 +76,7 @@ const removeEventHandlerSymbol = Symbol("removeEventHandler");
76
76
  *
77
77
  * @since 1.0.0
78
78
  * @copyright Volker Schukai
79
- * @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.
79
+ * @summary A single notification message element, typically rendered inside the notify container.
80
80
  */
81
81
  class Message extends CustomElement {
82
82
  /**
@@ -56,7 +56,7 @@ const queueSymbol = Symbol("queue");
56
56
  *
57
57
  * @since 1.0.0
58
58
  * @copyright Volker Schukai
59
- * @summary The Notify control is a notification container that can be used to display messages to the user.
59
+ * @summary A notification container for stacking, timing and managing transient user messages.
60
60
  */
61
61
  class Notify extends CustomElement {
62
62
  constructor() {
@@ -64,7 +64,7 @@ const timeAgoIntervalSymbol = Symbol("timeAgoInterval");
64
64
  *
65
65
  * @since 3.74.0
66
66
  * @copyright Volker Schukai
67
- * @summary The log entry is a single entry in the log.
67
+ * @summary A log component for rendering ordered state changes, events or activity entries.
68
68
  **/
69
69
  class Log extends CustomElement {
70
70
  /**
@@ -32,8 +32,7 @@ export { State };
32
32
  *
33
33
  * @since 1.5.0
34
34
  * @copyright Volker Schukai
35
- * @summary States tell users that there’s a state. That's it!
36
- * @summary The state control is used in the log control, among other things.
35
+ * @summary A compact state indicator for statuses such as success, warning, error or informational workflow state.
37
36
  **/
38
37
  class State extends CustomControl {
39
38
  /**
@@ -60,7 +60,7 @@ const timeAgoIntervalSymbol = Symbol("timeAgoInterval");
60
60
  *
61
61
  * @since 3.77.0
62
62
  * @copyright Volker Schukai
63
- * @summary The thread control visualizes nested discussion entries.
63
+ * @summary A threaded discussion layout for nested replies, comments and conversation-like content.
64
64
  **/
65
65
  class Thread extends CustomElement {
66
66
  /**