@momentum-design/components 0.129.36 → 0.129.38

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 (35) hide show
  1. package/dist/browser/index.js +263 -264
  2. package/dist/browser/index.js.map +4 -4
  3. package/dist/components/bullet/bullet.component.d.ts +16 -6
  4. package/dist/components/bullet/bullet.component.js +16 -6
  5. package/dist/components/bullet/bullet.styles.js +5 -6
  6. package/dist/components/divider/divider.component.d.ts +50 -55
  7. package/dist/components/divider/divider.component.js +50 -55
  8. package/dist/components/marker/marker.component.d.ts +20 -15
  9. package/dist/components/marker/marker.component.js +20 -15
  10. package/dist/components/popover/popover.component.d.ts +5 -2
  11. package/dist/components/popover/popover.component.js +39 -21
  12. package/dist/components/popover/popover.constants.d.ts +6 -1
  13. package/dist/components/popover/popover.constants.js +6 -1
  14. package/dist/components/staticcheckbox/staticcheckbox.component.d.ts +22 -11
  15. package/dist/components/staticcheckbox/staticcheckbox.component.js +22 -11
  16. package/dist/components/staticradio/staticradio.component.d.ts +21 -11
  17. package/dist/components/staticradio/staticradio.component.js +21 -11
  18. package/dist/components/statictoggle/statictoggle.component.d.ts +25 -12
  19. package/dist/components/statictoggle/statictoggle.component.js +25 -12
  20. package/dist/custom-elements.json +169 -79
  21. package/dist/react/bullet/index.d.ts +16 -6
  22. package/dist/react/bullet/index.js +16 -6
  23. package/dist/react/divider/index.d.ts +33 -38
  24. package/dist/react/divider/index.js +33 -38
  25. package/dist/react/marker/index.d.ts +17 -12
  26. package/dist/react/marker/index.js +17 -12
  27. package/dist/react/staticcheckbox/index.d.ts +22 -11
  28. package/dist/react/staticcheckbox/index.js +22 -11
  29. package/dist/react/staticradio/index.d.ts +21 -11
  30. package/dist/react/staticradio/index.js +21 -11
  31. package/dist/react/statictoggle/index.d.ts +25 -12
  32. package/dist/react/statictoggle/index.js +25 -12
  33. package/dist/utils/controllers/Timers.d.ts +49 -0
  34. package/dist/utils/controllers/Timers.js +96 -0
  35. package/package.json +1 -1
@@ -58,4 +58,9 @@ declare const DEFAULTS: {
58
58
  readonly IS_BACKDROP_INVISIBLE: true;
59
59
  readonly ANIMATION_FRAME: false;
60
60
  };
61
- export { TAG_NAME, POPOVER_PLACEMENT, COLOR, STRATEGY, TRIGGER, DEFAULTS };
61
+ declare const TIMEOUTS: {
62
+ readonly OPEN: "open";
63
+ readonly HOVER: "hover";
64
+ readonly CLOSE: "close";
65
+ };
66
+ export { TAG_NAME, POPOVER_PLACEMENT, COLOR, STRATEGY, TRIGGER, DEFAULTS, TIMEOUTS };
@@ -60,4 +60,9 @@ const DEFAULTS = {
60
60
  IS_BACKDROP_INVISIBLE: true,
61
61
  ANIMATION_FRAME: false,
62
62
  };
63
- export { TAG_NAME, POPOVER_PLACEMENT, COLOR, STRATEGY, TRIGGER, DEFAULTS };
63
+ const TIMEOUTS = {
64
+ OPEN: 'open',
65
+ HOVER: 'hover',
66
+ CLOSE: 'close',
67
+ };
68
+ export { TAG_NAME, POPOVER_PLACEMENT, COLOR, STRATEGY, TRIGGER, DEFAULTS, TIMEOUTS };
@@ -2,25 +2,36 @@ import { CSSResult } from 'lit';
2
2
  import { Component } from '../../models';
3
3
  declare const StaticCheckbox_base: import("../../utils/mixins/index.types").Constructor<import("../../utils/mixins/DisabledMixin").DisabledMixinInterface> & typeof Component;
4
4
  /**
5
- * StaticCheckbox is a decorative component styled as a checkbox for visual presentation.
6
- * Unlike the interactive `mdc-checkbox`, this component does not handle user interactions or form submissions.
7
- * It is used purely for displaying checkbox states in read-only scenarios.
5
+ * The StaticCheckbox component is a decorative, non-interactive checkbox used for visual
6
+ * presentation in read-only scenarios. Unlike the interactive `mdc-checkbox`, it does not
7
+ * handle user interactions or form submissions.
8
8
  *
9
- * This component supports five display states: checked, indeterminate, disabled, readonly, and soft-disabled.
9
+ * This component supports multiple visual states: checked, indeterminate, disabled, readonly,
10
+ * and soft-disabled.
11
+ *
12
+ * ## When to use
13
+ * Use StaticCheckbox to display checkbox states in read-only contexts such as summary views,
14
+ * confirmation screens, or when showing historical form data. For interactive checkboxes, use
15
+ * `mdc-checkbox` instead.
16
+ *
17
+ * ## Accessibility
18
+ * - StaticCheckbox is decorative and non-interactive by design
19
+ * - Always pair with descriptive text labels in the default slot
20
+ * - Do not use this as a replacement for interactive checkboxes in forms
10
21
  *
11
22
  * @tagname mdc-staticcheckbox
12
23
  *
13
24
  * @dependency mdc-icon
14
25
  *
15
- * @cssproperty --mdc-staticcheckbox-border-color - The border color of the checkbox.
16
- * @cssproperty --mdc-staticcheckbox-background-color - The background color of the checkbox.
17
- * @cssproperty --mdc-staticcheckbox-icon-color - The icon color of the checkbox.
18
- * @cssproperty --mdc-staticcheckbox-size - The size of the checkbox.
26
+ * @cssproperty --mdc-staticcheckbox-border-color - Border color of the checkbox.
27
+ * @cssproperty --mdc-staticcheckbox-background-color - Background color of the checkbox.
28
+ * @cssproperty --mdc-staticcheckbox-icon-color - Icon color of the checkbox.
29
+ * @cssproperty --mdc-staticcheckbox-size - Size of the checkbox.
19
30
  *
20
- * @csspart icon-container - The container for the checkbox icon
21
- * @csspart checkbox-icon - The checkbox icon element
31
+ * @csspart icon-container - The container for the checkbox icon.
32
+ * @csspart checkbox-icon - The checkbox icon element.
22
33
  *
23
- * @slot - Default slot for adding label text
34
+ * @slot - Default slot for label text.
24
35
  */
25
36
  declare class StaticCheckbox extends StaticCheckbox_base {
26
37
  /**
@@ -14,25 +14,36 @@ import { DisabledMixin } from '../../utils/mixins/DisabledMixin';
14
14
  import styles from './staticcheckbox.styles';
15
15
  import { ICON_NAME } from './staticcheckbox.constants';
16
16
  /**
17
- * StaticCheckbox is a decorative component styled as a checkbox for visual presentation.
18
- * Unlike the interactive `mdc-checkbox`, this component does not handle user interactions or form submissions.
19
- * It is used purely for displaying checkbox states in read-only scenarios.
17
+ * The StaticCheckbox component is a decorative, non-interactive checkbox used for visual
18
+ * presentation in read-only scenarios. Unlike the interactive `mdc-checkbox`, it does not
19
+ * handle user interactions or form submissions.
20
20
  *
21
- * This component supports five display states: checked, indeterminate, disabled, readonly, and soft-disabled.
21
+ * This component supports multiple visual states: checked, indeterminate, disabled, readonly,
22
+ * and soft-disabled.
23
+ *
24
+ * ## When to use
25
+ * Use StaticCheckbox to display checkbox states in read-only contexts such as summary views,
26
+ * confirmation screens, or when showing historical form data. For interactive checkboxes, use
27
+ * `mdc-checkbox` instead.
28
+ *
29
+ * ## Accessibility
30
+ * - StaticCheckbox is decorative and non-interactive by design
31
+ * - Always pair with descriptive text labels in the default slot
32
+ * - Do not use this as a replacement for interactive checkboxes in forms
22
33
  *
23
34
  * @tagname mdc-staticcheckbox
24
35
  *
25
36
  * @dependency mdc-icon
26
37
  *
27
- * @cssproperty --mdc-staticcheckbox-border-color - The border color of the checkbox.
28
- * @cssproperty --mdc-staticcheckbox-background-color - The background color of the checkbox.
29
- * @cssproperty --mdc-staticcheckbox-icon-color - The icon color of the checkbox.
30
- * @cssproperty --mdc-staticcheckbox-size - The size of the checkbox.
38
+ * @cssproperty --mdc-staticcheckbox-border-color - Border color of the checkbox.
39
+ * @cssproperty --mdc-staticcheckbox-background-color - Background color of the checkbox.
40
+ * @cssproperty --mdc-staticcheckbox-icon-color - Icon color of the checkbox.
41
+ * @cssproperty --mdc-staticcheckbox-size - Size of the checkbox.
31
42
  *
32
- * @csspart icon-container - The container for the checkbox icon
33
- * @csspart checkbox-icon - The checkbox icon element
43
+ * @csspart icon-container - The container for the checkbox icon.
44
+ * @csspart checkbox-icon - The checkbox icon element.
34
45
  *
35
- * @slot - Default slot for adding label text
46
+ * @slot - Default slot for label text.
36
47
  */
37
48
  class StaticCheckbox extends DisabledMixin(Component) {
38
49
  constructor() {
@@ -2,23 +2,33 @@ import { CSSResult } from 'lit';
2
2
  import { Component } from '../../models';
3
3
  declare const StaticRadio_base: import("../../utils/mixins/index.types").Constructor<import("../../utils/mixins/DisabledMixin").DisabledMixinInterface> & typeof Component;
4
4
  /**
5
- * StaticRadio is a decorative component styled as a radio button for visual presentation.
6
- * Unlike the interactive `mdc-radio`, this component does not handle user interactions or form submissions.
7
- * It is used purely for displaying radio button states in read-only scenarios.
5
+ * The StaticRadio component is a decorative, non-interactive radio button used for visual
6
+ * presentation in read-only scenarios. Unlike the interactive `mdc-radio`, it does not
7
+ * handle user interactions or form submissions.
8
8
  *
9
- * This component supports four display states: checked, disabled, readonly, and soft-disabled.
9
+ * This component supports multiple visual states: checked, disabled, readonly, and soft-disabled.
10
+ *
11
+ * ## When to use
12
+ * Use StaticRadio to display radio button states in read-only contexts such as summary views,
13
+ * confirmation screens, or when showing historical form data. For interactive radio buttons, use
14
+ * `mdc-radio` instead.
15
+ *
16
+ * ## Accessibility
17
+ * - StaticRadio is decorative and non-interactive by design
18
+ * - Always pair with descriptive text labels in the default slot
19
+ * - Do not use this as a replacement for interactive radio buttons in forms
10
20
  *
11
21
  * @tagname mdc-staticradio
12
22
  *
13
- * @cssproperty --mdc-staticradio-inner-circle-size - The size of the inner circle when checked.
14
- * @cssproperty --mdc-staticradio-outer-circle-size - The size of the outer circle border.
15
- * @cssproperty --mdc-staticradio-inner-circle-background-color - The background color of the inner circle when checked.
16
- * @cssproperty --mdc-staticradio-outer-circle-border-color - The border color of the outer circle.
17
- * @cssproperty --mdc-staticradio-outer-circle-background-color - The background color of the outer circle.
23
+ * @cssproperty --mdc-staticradio-inner-circle-size - Size of the inner circle when checked.
24
+ * @cssproperty --mdc-staticradio-outer-circle-size - Size of the outer circle border.
25
+ * @cssproperty --mdc-staticradio-inner-circle-background-color - Background color of the inner circle when checked.
26
+ * @cssproperty --mdc-staticradio-outer-circle-border-color - Border color of the outer circle.
27
+ * @cssproperty --mdc-staticradio-outer-circle-background-color - Background color of the outer circle.
18
28
  *
19
- * @csspart radio-icon - The radio icon element
29
+ * @csspart radio-icon - The radio icon element.
20
30
  *
21
- * @slot - Default slot for the label of the radio
31
+ * @slot - Default slot for the label of the radio.
22
32
  */
23
33
  declare class StaticRadio extends StaticRadio_base {
24
34
  /**
@@ -13,23 +13,33 @@ import { Component } from '../../models';
13
13
  import { DisabledMixin } from '../../utils/mixins/DisabledMixin';
14
14
  import styles from './staticradio.styles';
15
15
  /**
16
- * StaticRadio is a decorative component styled as a radio button for visual presentation.
17
- * Unlike the interactive `mdc-radio`, this component does not handle user interactions or form submissions.
18
- * It is used purely for displaying radio button states in read-only scenarios.
16
+ * The StaticRadio component is a decorative, non-interactive radio button used for visual
17
+ * presentation in read-only scenarios. Unlike the interactive `mdc-radio`, it does not
18
+ * handle user interactions or form submissions.
19
19
  *
20
- * This component supports four display states: checked, disabled, readonly, and soft-disabled.
20
+ * This component supports multiple visual states: checked, disabled, readonly, and soft-disabled.
21
+ *
22
+ * ## When to use
23
+ * Use StaticRadio to display radio button states in read-only contexts such as summary views,
24
+ * confirmation screens, or when showing historical form data. For interactive radio buttons, use
25
+ * `mdc-radio` instead.
26
+ *
27
+ * ## Accessibility
28
+ * - StaticRadio is decorative and non-interactive by design
29
+ * - Always pair with descriptive text labels in the default slot
30
+ * - Do not use this as a replacement for interactive radio buttons in forms
21
31
  *
22
32
  * @tagname mdc-staticradio
23
33
  *
24
- * @cssproperty --mdc-staticradio-inner-circle-size - The size of the inner circle when checked.
25
- * @cssproperty --mdc-staticradio-outer-circle-size - The size of the outer circle border.
26
- * @cssproperty --mdc-staticradio-inner-circle-background-color - The background color of the inner circle when checked.
27
- * @cssproperty --mdc-staticradio-outer-circle-border-color - The border color of the outer circle.
28
- * @cssproperty --mdc-staticradio-outer-circle-background-color - The background color of the outer circle.
34
+ * @cssproperty --mdc-staticradio-inner-circle-size - Size of the inner circle when checked.
35
+ * @cssproperty --mdc-staticradio-outer-circle-size - Size of the outer circle border.
36
+ * @cssproperty --mdc-staticradio-inner-circle-background-color - Background color of the inner circle when checked.
37
+ * @cssproperty --mdc-staticradio-outer-circle-border-color - Border color of the outer circle.
38
+ * @cssproperty --mdc-staticradio-outer-circle-background-color - Background color of the outer circle.
29
39
  *
30
- * @csspart radio-icon - The radio icon element
40
+ * @csspart radio-icon - The radio icon element.
31
41
  *
32
- * @slot - Default slot for the label of the radio
42
+ * @slot - Default slot for the label of the radio.
33
43
  */
34
44
  class StaticRadio extends DisabledMixin(Component) {
35
45
  constructor() {
@@ -3,26 +3,39 @@ import { Component } from '../../models';
3
3
  import type { ToggleSize } from './statictoggle.types';
4
4
  declare const StaticToggle_base: import("../../utils/mixins/index.types").Constructor<import("../../utils/mixins/DisabledMixin").DisabledMixinInterface> & typeof Component;
5
5
  /**
6
- * The StaticToggle is a decorative component that visually represents a toggle switch without interactive functionality.
7
- * It is primarily used for display purposes or as a building block within custom interactive components.
8
- * This component shares the same visual styling as the interactive `mdc-toggle` component.
6
+ * The StaticToggle component is a decorative, non-interactive toggle switch used for visual
7
+ * presentation. It shares the same styling as the interactive `mdc-toggle` component but does
8
+ * not provide user interaction functionality.
9
9
  *
10
- * @dependency mdc-icon
10
+ * This component supports multiple visual states: checked, disabled, readonly, soft-disabled,
11
+ * and size variations (default, compact).
12
+ *
13
+ * ## When to use
14
+ * Use StaticToggle to display toggle states in read-only contexts such as summary views,
15
+ * confirmation screens, or as a building block within custom interactive components. For
16
+ * interactive toggles, use `mdc-toggle` instead.
17
+ *
18
+ * ## Accessibility
19
+ * - StaticToggle is decorative and non-interactive by design
20
+ * - When used within parent components, ensure proper ARIA attributes are provided by the parent
21
+ * - Do not use this as a replacement for interactive toggles in forms
11
22
  *
12
23
  * @tagname mdc-statictoggle
13
24
  *
14
- * @slot - Default slot for slotted content (typically used by parent `mdc-toggle` for the checkbox input).
25
+ * @dependency mdc-icon
15
26
  *
16
- * @cssproperty --mdc-statictoggle-width - The width of the static toggle.
17
- * @cssproperty --mdc-statictoggle-height - The height of the static toggle.
18
- * @cssproperty --mdc-statictoggle-border-radius - The border radius of the static toggle.
19
- * @cssproperty --mdc-statictoggle-border-color - The border color of the static toggle.
20
- * @cssproperty --mdc-statictoggle-background-color - The background color of the static toggle.
21
- * @cssproperty --mdc-statictoggle-icon-color - The icon color of the static toggle.
22
- * @cssproperty --mdc-statictoggle-icon-background-color - The icon background color of the static toggle.
27
+ * @cssproperty --mdc-statictoggle-width - Width of the static toggle.
28
+ * @cssproperty --mdc-statictoggle-height - Height of the static toggle.
29
+ * @cssproperty --mdc-statictoggle-border-radius - Border radius of the static toggle.
30
+ * @cssproperty --mdc-statictoggle-border-color - Border color of the static toggle.
31
+ * @cssproperty --mdc-statictoggle-background-color - Background color of the static toggle.
32
+ * @cssproperty --mdc-statictoggle-icon-color - Icon color of the static toggle.
33
+ * @cssproperty --mdc-statictoggle-icon-background-color - Icon background color of the static toggle.
23
34
  *
24
35
  * @csspart slider - The slider part of the toggle.
25
36
  * @csspart toggle-icon - The icon part of the toggle.
37
+ *
38
+ * @slot - Default slot for slotted content (typically used by parent `mdc-toggle` for the checkbox input).
26
39
  */
27
40
  declare class StaticToggle extends StaticToggle_base {
28
41
  /**
@@ -14,26 +14,39 @@ import { DisabledMixin } from '../../utils/mixins/DisabledMixin';
14
14
  import { DEFAULTS, ICON_NAME, ICON_SIZE_IN_REM } from './statictoggle.constants';
15
15
  import styles from './statictoggle.styles';
16
16
  /**
17
- * The StaticToggle is a decorative component that visually represents a toggle switch without interactive functionality.
18
- * It is primarily used for display purposes or as a building block within custom interactive components.
19
- * This component shares the same visual styling as the interactive `mdc-toggle` component.
17
+ * The StaticToggle component is a decorative, non-interactive toggle switch used for visual
18
+ * presentation. It shares the same styling as the interactive `mdc-toggle` component but does
19
+ * not provide user interaction functionality.
20
20
  *
21
- * @dependency mdc-icon
21
+ * This component supports multiple visual states: checked, disabled, readonly, soft-disabled,
22
+ * and size variations (default, compact).
23
+ *
24
+ * ## When to use
25
+ * Use StaticToggle to display toggle states in read-only contexts such as summary views,
26
+ * confirmation screens, or as a building block within custom interactive components. For
27
+ * interactive toggles, use `mdc-toggle` instead.
28
+ *
29
+ * ## Accessibility
30
+ * - StaticToggle is decorative and non-interactive by design
31
+ * - When used within parent components, ensure proper ARIA attributes are provided by the parent
32
+ * - Do not use this as a replacement for interactive toggles in forms
22
33
  *
23
34
  * @tagname mdc-statictoggle
24
35
  *
25
- * @slot - Default slot for slotted content (typically used by parent `mdc-toggle` for the checkbox input).
36
+ * @dependency mdc-icon
26
37
  *
27
- * @cssproperty --mdc-statictoggle-width - The width of the static toggle.
28
- * @cssproperty --mdc-statictoggle-height - The height of the static toggle.
29
- * @cssproperty --mdc-statictoggle-border-radius - The border radius of the static toggle.
30
- * @cssproperty --mdc-statictoggle-border-color - The border color of the static toggle.
31
- * @cssproperty --mdc-statictoggle-background-color - The background color of the static toggle.
32
- * @cssproperty --mdc-statictoggle-icon-color - The icon color of the static toggle.
33
- * @cssproperty --mdc-statictoggle-icon-background-color - The icon background color of the static toggle.
38
+ * @cssproperty --mdc-statictoggle-width - Width of the static toggle.
39
+ * @cssproperty --mdc-statictoggle-height - Height of the static toggle.
40
+ * @cssproperty --mdc-statictoggle-border-radius - Border radius of the static toggle.
41
+ * @cssproperty --mdc-statictoggle-border-color - Border color of the static toggle.
42
+ * @cssproperty --mdc-statictoggle-background-color - Background color of the static toggle.
43
+ * @cssproperty --mdc-statictoggle-icon-color - Icon color of the static toggle.
44
+ * @cssproperty --mdc-statictoggle-icon-background-color - Icon background color of the static toggle.
34
45
  *
35
46
  * @csspart slider - The slider part of the toggle.
36
47
  * @csspart toggle-icon - The icon part of the toggle.
48
+ *
49
+ * @slot - Default slot for slotted content (typically used by parent `mdc-toggle` for the checkbox input).
37
50
  */
38
51
  class StaticToggle extends DisabledMixin(Component) {
39
52
  constructor() {