@maggioli-design-system/magma 2.0.0 → 2.1.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 (1540) hide show
  1. package/AGENTS.md +71 -0
  2. package/agents/anti-patterns.md +39 -0
  3. package/agents/assets.md +203 -0
  4. package/agents/color.md +193 -0
  5. package/agents/components.md +129 -0
  6. package/agents/conventions.md +188 -0
  7. package/agents/install.md +152 -0
  8. package/agents/theming.md +140 -0
  9. package/agents/typography.md +32 -0
  10. package/agents/variants.md +112 -0
  11. package/dist/cjs/floating-controller-uOCBLTk2.js +369 -0
  12. package/dist/cjs/form-Bk2OHlHM.js +46 -0
  13. package/dist/cjs/index-MyEb-PfD.js +198 -0
  14. package/dist/cjs/index-UmmmCMIG.js +5184 -0
  15. package/dist/cjs/index.cjs.js +65 -23
  16. package/dist/cjs/loader.cjs.js +2 -2
  17. package/dist/cjs/locale-CnorkBwF.js +816 -0
  18. package/dist/cjs/magma-components.cjs.js +2 -2
  19. package/dist/cjs/mds-accordion-item.cjs.entry.js +2 -2
  20. package/dist/cjs/mds-accordion-timer-item.cjs.entry.js +2 -2
  21. package/dist/cjs/mds-accordion-timer.cjs.entry.js +1 -1
  22. package/dist/cjs/mds-accordion.cjs.entry.js +2 -2
  23. package/dist/cjs/mds-author.cjs.entry.js +1 -1
  24. package/dist/cjs/mds-avatar-stack-item.cjs.entry.js +1 -1
  25. package/dist/cjs/mds-avatar-stack.cjs.entry.js +1 -1
  26. package/dist/cjs/mds-avatar.cjs.entry.js +29 -34
  27. package/dist/cjs/mds-badge.cjs.entry.js +5 -4
  28. package/dist/cjs/mds-banner_3.cjs.entry.js +3 -3
  29. package/dist/cjs/mds-benchmark-bar.cjs.entry.js +4 -3
  30. package/dist/cjs/mds-bibliography.cjs.entry.js +5 -4
  31. package/dist/cjs/mds-breadcrumb-item.cjs.entry.js +1 -1
  32. package/dist/cjs/mds-breadcrumb.cjs.entry.js +3 -3
  33. package/dist/cjs/mds-button-dropdown.cjs.entry.js +38 -4
  34. package/dist/cjs/mds-button-group.cjs.entry.js +1 -1
  35. package/dist/cjs/mds-button_3.cjs.entry.js +42 -15
  36. package/dist/cjs/mds-calendar_2.cjs.entry.js +2 -2
  37. package/dist/cjs/mds-card-content.cjs.entry.js +1 -1
  38. package/dist/cjs/mds-card-footer.cjs.entry.js +1 -1
  39. package/dist/cjs/mds-card-header.cjs.entry.js +1 -1
  40. package/dist/cjs/mds-card-media.cjs.entry.js +1 -1
  41. package/dist/cjs/mds-card.cjs.entry.js +2 -2
  42. package/dist/cjs/mds-details.cjs.entry.js +2 -2
  43. package/dist/cjs/mds-dropdown.cjs.entry.js +7 -6
  44. package/dist/cjs/mds-emoji.cjs.entry.js +2 -2
  45. package/dist/cjs/mds-entity.cjs.entry.js +3 -3
  46. package/dist/cjs/mds-file-preview.cjs.entry.js +20 -20
  47. package/dist/cjs/mds-file.cjs.entry.js +3 -3
  48. package/dist/cjs/mds-filter-item.cjs.entry.js +2 -2
  49. package/dist/cjs/mds-filter.cjs.entry.js +2 -2
  50. package/dist/cjs/mds-header-bar.cjs.entry.js +2 -2
  51. package/dist/cjs/mds-header.cjs.entry.js +19 -10
  52. package/dist/cjs/mds-horizontal-scroll.cjs.entry.js +1 -1
  53. package/dist/cjs/mds-hr.cjs.entry.js +2 -2
  54. package/dist/cjs/mds-img.cjs.entry.js +6 -6
  55. package/dist/cjs/mds-input-date-range-preselection.cjs.entry.js +1 -1
  56. package/dist/cjs/mds-input-date-range.cjs.entry.js +95 -13
  57. package/dist/cjs/mds-input-date.cjs.entry.js +124 -27
  58. package/dist/cjs/mds-input-field.cjs.entry.js +1 -1
  59. package/dist/cjs/mds-input-otp.cjs.entry.js +65 -19
  60. package/dist/cjs/mds-input-range.cjs.entry.js +32 -16
  61. package/dist/cjs/mds-input-select.cjs.entry.js +166 -35
  62. package/dist/cjs/mds-input-switch_2.cjs.entry.js +63 -21
  63. package/dist/cjs/mds-input-tip_2.cjs.entry.js +3 -3
  64. package/dist/cjs/mds-input-upload.cjs.entry.js +141 -68
  65. package/dist/cjs/mds-input.cjs.entry.js +320 -36
  66. package/dist/cjs/mds-keyboard-key.cjs.entry.js +11 -8
  67. package/dist/cjs/mds-keyboard.cjs.entry.js +9 -6
  68. package/dist/cjs/mds-kpi-item.cjs.entry.js +2 -2
  69. package/dist/cjs/mds-kpi.cjs.entry.js +1 -1
  70. package/dist/cjs/mds-label.cjs.entry.js +3 -3
  71. package/dist/cjs/mds-list-item.cjs.entry.js +2 -2
  72. package/dist/cjs/mds-list.cjs.entry.js +1 -1
  73. package/dist/cjs/mds-mention.cjs.entry.js +6 -5
  74. package/dist/cjs/mds-modal.cjs.entry.js +2 -2
  75. package/dist/cjs/mds-note.cjs.entry.js +3 -3
  76. package/dist/cjs/mds-notification.cjs.entry.js +13 -10
  77. package/dist/cjs/mds-paginator-item.cjs.entry.js +2 -2
  78. package/dist/cjs/mds-paginator.cjs.entry.js +2 -2
  79. package/dist/cjs/mds-policy-ai.cjs.entry.js +3 -3
  80. package/dist/cjs/mds-pref-animation.cjs.entry.js +29 -5
  81. package/dist/cjs/mds-pref-consumption.cjs.entry.js +29 -5
  82. package/dist/cjs/mds-pref-contrast.cjs.entry.js +27 -6
  83. package/dist/cjs/mds-pref-language-item.cjs.entry.js +6 -5
  84. package/dist/cjs/mds-pref-language.cjs.entry.js +3 -3
  85. package/dist/cjs/mds-pref-mode.cjs.entry.js +30 -7
  86. package/dist/cjs/mds-pref-theme-item.cjs.entry.js +4 -3
  87. package/dist/cjs/mds-pref-theme.cjs.entry.js +3 -3
  88. package/dist/cjs/mds-pref.cjs.entry.js +10 -5
  89. package/dist/cjs/mds-price-table-features-cell.cjs.entry.js +2 -2
  90. package/dist/cjs/mds-price-table-features-row.cjs.entry.js +2 -2
  91. package/dist/cjs/mds-price-table-features.cjs.entry.js +2 -2
  92. package/dist/cjs/mds-price-table-header.cjs.entry.js +1 -1
  93. package/dist/cjs/mds-price-table-list-item.cjs.entry.js +1 -1
  94. package/dist/cjs/mds-price-table-list.cjs.entry.js +2 -2
  95. package/dist/cjs/mds-price-table.cjs.entry.js +1 -1
  96. package/dist/cjs/mds-progress_2.cjs.entry.js +2 -2
  97. package/dist/cjs/mds-push-notification-item.cjs.entry.js +4 -4
  98. package/dist/cjs/mds-push-notification.cjs.entry.js +2 -2
  99. package/dist/cjs/mds-quote.cjs.entry.js +2 -2
  100. package/dist/cjs/mds-radial-menu-item.cjs.entry.js +1 -1
  101. package/dist/cjs/mds-radial-menu.cjs.entry.js +2 -2
  102. package/dist/cjs/mds-separator.cjs.entry.js +2 -2
  103. package/dist/cjs/mds-status-bar.cjs.entry.js +2 -2
  104. package/dist/cjs/mds-stepper-bar-item.cjs.entry.js +3 -3
  105. package/dist/cjs/mds-stepper-bar.cjs.entry.js +6 -4
  106. package/dist/cjs/mds-tab-bar-item.cjs.entry.js +5 -4
  107. package/dist/cjs/mds-tab-bar.cjs.entry.js +2 -2
  108. package/dist/cjs/mds-tab_2.cjs.entry.js +2 -2
  109. package/dist/cjs/mds-table-body.cjs.entry.js +2 -2
  110. package/dist/cjs/mds-table-footer.cjs.entry.js +2 -2
  111. package/dist/cjs/mds-table-header-cell.cjs.entry.js +4 -4
  112. package/dist/cjs/mds-table-header.cjs.entry.js +3 -3
  113. package/dist/cjs/mds-table-row.cjs.entry.js +3 -3
  114. package/dist/cjs/mds-table.cjs.entry.js +3 -3
  115. package/dist/cjs/mds-text.cjs.entry.js +4 -3
  116. package/dist/cjs/mds-toast.cjs.entry.js +11 -5
  117. package/dist/cjs/mds-tooltip.cjs.entry.js +7 -7
  118. package/dist/cjs/mds-tree-item.cjs.entry.js +3 -3
  119. package/dist/cjs/mds-tree.cjs.entry.js +1 -1
  120. package/dist/cjs/mds-url-view.cjs.entry.js +3 -3
  121. package/dist/cjs/mds-usage.cjs.entry.js +3 -3
  122. package/dist/cjs/mds-video-wall.cjs.entry.js +1 -1
  123. package/dist/cjs/mds-zero.cjs.entry.js +2 -2
  124. package/dist/cjs/preference-DRkzNp5a.js +389 -0
  125. package/dist/collection/common/form.js +24 -1
  126. package/dist/collection/common/validity/index.js +42 -0
  127. package/dist/collection/components/mds-accordion/AGENTS.md +65 -0
  128. package/dist/collection/components/mds-accordion/antipattern.md +123 -0
  129. package/dist/collection/components/mds-accordion/documentation.json +172 -0
  130. package/dist/collection/components/mds-accordion/pattern.md +150 -0
  131. package/dist/collection/components/mds-accordion-item/AGENTS.md +76 -0
  132. package/dist/collection/components/mds-accordion-item/antipattern.md +137 -0
  133. package/dist/collection/components/mds-accordion-item/documentation.json +288 -0
  134. package/dist/collection/components/mds-accordion-item/pattern.md +156 -0
  135. package/dist/collection/components/mds-accordion-timer/AGENTS.md +65 -0
  136. package/dist/collection/components/mds-accordion-timer/antipattern.md +133 -0
  137. package/dist/collection/components/mds-accordion-timer/documentation.json +168 -0
  138. package/dist/collection/components/mds-accordion-timer/pattern.md +137 -0
  139. package/dist/collection/components/mds-accordion-timer-item/AGENTS.md +82 -0
  140. package/dist/collection/components/mds-accordion-timer-item/antipattern.md +143 -0
  141. package/dist/collection/components/mds-accordion-timer-item/documentation.json +400 -0
  142. package/dist/collection/components/mds-accordion-timer-item/pattern.md +136 -0
  143. package/dist/collection/components/mds-author/AGENTS.md +40 -0
  144. package/dist/collection/components/mds-author/antipattern.md +106 -0
  145. package/dist/collection/components/mds-author/documentation.json +51 -0
  146. package/dist/collection/components/mds-author/pattern.md +101 -0
  147. package/dist/collection/components/mds-avatar/AGENTS.md +70 -0
  148. package/dist/collection/components/mds-avatar/antipattern.md +96 -0
  149. package/dist/collection/components/mds-avatar/documentation.json +362 -0
  150. package/dist/collection/components/mds-avatar/mds-avatar.js +27 -32
  151. package/dist/collection/components/mds-avatar/pattern.md +108 -0
  152. package/dist/collection/components/mds-avatar-stack/AGENTS.md +65 -0
  153. package/dist/collection/components/mds-avatar-stack/antipattern.md +122 -0
  154. package/dist/collection/components/mds-avatar-stack/documentation.json +196 -0
  155. package/dist/collection/components/mds-avatar-stack/pattern.md +125 -0
  156. package/dist/collection/components/mds-avatar-stack-item/AGENTS.md +60 -0
  157. package/dist/collection/components/mds-avatar-stack-item/antipattern.md +113 -0
  158. package/dist/collection/components/mds-avatar-stack-item/documentation.json +315 -0
  159. package/dist/collection/components/mds-avatar-stack-item/pattern.md +105 -0
  160. package/dist/collection/components/mds-badge/AGENTS.md +63 -0
  161. package/dist/collection/components/mds-badge/antipattern.md +104 -0
  162. package/dist/collection/components/mds-badge/documentation.json +316 -0
  163. package/dist/collection/components/mds-badge/mds-badge.js +3 -2
  164. package/dist/collection/components/mds-badge/pattern.md +130 -0
  165. package/dist/collection/components/mds-banner/AGENTS.md +87 -0
  166. package/dist/collection/components/mds-banner/antipattern.md +141 -0
  167. package/dist/collection/components/mds-banner/documentation.json +378 -0
  168. package/dist/collection/components/mds-banner/pattern.md +176 -0
  169. package/dist/collection/components/mds-benchmark-bar/AGENTS.md +59 -0
  170. package/dist/collection/components/mds-benchmark-bar/antipattern.md +77 -0
  171. package/dist/collection/components/mds-benchmark-bar/documentation.json +313 -0
  172. package/dist/collection/components/mds-benchmark-bar/mds-benchmark-bar.js +3 -2
  173. package/dist/collection/components/mds-benchmark-bar/pattern.md +102 -0
  174. package/dist/collection/components/mds-bibliography/AGENTS.md +61 -0
  175. package/dist/collection/components/mds-bibliography/antipattern.md +130 -0
  176. package/dist/collection/components/mds-bibliography/documentation.json +407 -0
  177. package/dist/collection/components/mds-bibliography/mds-bibliography.js +4 -3
  178. package/dist/collection/components/mds-bibliography/pattern.md +142 -0
  179. package/dist/collection/components/mds-breadcrumb/AGENTS.md +68 -0
  180. package/dist/collection/components/mds-breadcrumb/antipattern.md +112 -0
  181. package/dist/collection/components/mds-breadcrumb/documentation.json +156 -0
  182. package/dist/collection/components/mds-breadcrumb/pattern.md +103 -0
  183. package/dist/collection/components/mds-breadcrumb-item/AGENTS.md +67 -0
  184. package/dist/collection/components/mds-breadcrumb-item/antipattern.md +109 -0
  185. package/dist/collection/components/mds-breadcrumb-item/documentation.json +160 -0
  186. package/dist/collection/components/mds-breadcrumb-item/pattern.md +85 -0
  187. package/dist/collection/components/mds-button/AGENTS.md +102 -0
  188. package/dist/collection/components/mds-button/antipattern.md +126 -0
  189. package/dist/collection/components/mds-button/documentation.json +922 -0
  190. package/dist/collection/components/mds-button/mds-button.css +4 -1
  191. package/dist/collection/components/mds-button/mds-button.js +48 -8
  192. package/dist/collection/components/mds-button/pattern.md +172 -0
  193. package/dist/collection/components/mds-button-dropdown/AGENTS.md +88 -0
  194. package/dist/collection/components/mds-button-dropdown/antipattern.md +158 -0
  195. package/dist/collection/components/mds-button-dropdown/documentation.json +614 -0
  196. package/dist/collection/components/mds-button-dropdown/mds-button-dropdown.js +94 -6
  197. package/dist/collection/components/mds-button-dropdown/pattern.md +164 -0
  198. package/dist/collection/components/mds-button-group/AGENTS.md +33 -0
  199. package/dist/collection/components/mds-button-group/antipattern.md +105 -0
  200. package/dist/collection/components/mds-button-group/documentation.json +43 -0
  201. package/dist/collection/components/mds-button-group/pattern.md +89 -0
  202. package/dist/collection/components/mds-calendar/AGENTS.md +96 -0
  203. package/dist/collection/components/mds-calendar/antipattern.md +113 -0
  204. package/dist/collection/components/mds-calendar/documentation.json +626 -0
  205. package/dist/collection/components/mds-calendar/pattern.md +128 -0
  206. package/dist/collection/components/mds-calendar-cell/AGENTS.md +94 -0
  207. package/dist/collection/components/mds-calendar-cell/antipattern.md +58 -0
  208. package/dist/collection/components/mds-calendar-cell/documentation.json +539 -0
  209. package/dist/collection/components/mds-calendar-cell/pattern.md +82 -0
  210. package/dist/collection/components/mds-card/AGENTS.md +60 -0
  211. package/dist/collection/components/mds-card/antipattern.md +133 -0
  212. package/dist/collection/components/mds-card/documentation.json +117 -0
  213. package/dist/collection/components/mds-card/pattern.md +160 -0
  214. package/dist/collection/components/mds-card-content/AGENTS.md +34 -0
  215. package/dist/collection/components/mds-card-content/antipattern.md +110 -0
  216. package/dist/collection/components/mds-card-content/documentation.json +43 -0
  217. package/dist/collection/components/mds-card-content/pattern.md +91 -0
  218. package/dist/collection/components/mds-card-footer/AGENTS.md +34 -0
  219. package/dist/collection/components/mds-card-footer/antipattern.md +112 -0
  220. package/dist/collection/components/mds-card-footer/documentation.json +43 -0
  221. package/dist/collection/components/mds-card-footer/pattern.md +95 -0
  222. package/dist/collection/components/mds-card-header/AGENTS.md +38 -0
  223. package/dist/collection/components/mds-card-header/antipattern.md +114 -0
  224. package/dist/collection/components/mds-card-header/documentation.json +51 -0
  225. package/dist/collection/components/mds-card-header/pattern.md +143 -0
  226. package/dist/collection/components/mds-card-media/AGENTS.md +46 -0
  227. package/dist/collection/components/mds-card-media/antipattern.md +128 -0
  228. package/dist/collection/components/mds-card-media/documentation.json +56 -0
  229. package/dist/collection/components/mds-card-media/pattern.md +93 -0
  230. package/dist/collection/components/mds-chip/AGENTS.md +84 -0
  231. package/dist/collection/components/mds-chip/antipattern.md +119 -0
  232. package/dist/collection/components/mds-chip/documentation.json +535 -0
  233. package/dist/collection/components/mds-chip/pattern.md +166 -0
  234. package/dist/collection/components/mds-details/AGENTS.md +72 -0
  235. package/dist/collection/components/mds-details/antipattern.md +128 -0
  236. package/dist/collection/components/mds-details/documentation.json +153 -0
  237. package/dist/collection/components/mds-details/pattern.md +138 -0
  238. package/dist/collection/components/mds-dropdown/AGENTS.md +95 -0
  239. package/dist/collection/components/mds-dropdown/antipattern.md +137 -0
  240. package/dist/collection/components/mds-dropdown/documentation.json +701 -0
  241. package/dist/collection/components/mds-dropdown/mds-dropdown.js +4 -3
  242. package/dist/collection/components/mds-dropdown/pattern.md +201 -0
  243. package/dist/collection/components/mds-emoji/AGENTS.md +88 -0
  244. package/dist/collection/components/mds-emoji/antipattern.md +134 -0
  245. package/dist/collection/components/mds-emoji/documentation.json +506 -0
  246. package/dist/collection/components/mds-emoji/pattern.md +219 -0
  247. package/dist/collection/components/mds-entity/AGENTS.md +76 -0
  248. package/dist/collection/components/mds-entity/antipattern.md +112 -0
  249. package/dist/collection/components/mds-entity/documentation.json +365 -0
  250. package/dist/collection/components/mds-entity/pattern.md +125 -0
  251. package/dist/collection/components/mds-file/AGENTS.md +63 -0
  252. package/dist/collection/components/mds-file/antipattern.md +92 -0
  253. package/dist/collection/components/mds-file/documentation.json +484 -0
  254. package/dist/collection/components/mds-file/pattern.md +109 -0
  255. package/dist/collection/components/mds-file-preview/AGENTS.md +88 -0
  256. package/dist/collection/components/mds-file-preview/antipattern.md +129 -0
  257. package/dist/collection/components/mds-file-preview/documentation.json +780 -0
  258. package/dist/collection/components/mds-file-preview/mds-file-preview.js +6 -7
  259. package/dist/collection/components/mds-file-preview/pattern.md +164 -0
  260. package/dist/collection/components/mds-filter/AGENTS.md +72 -0
  261. package/dist/collection/components/mds-filter/antipattern.md +140 -0
  262. package/dist/collection/components/mds-filter/documentation.json +239 -0
  263. package/dist/collection/components/mds-filter/pattern.md +129 -0
  264. package/dist/collection/components/mds-filter-item/AGENTS.md +64 -0
  265. package/dist/collection/components/mds-filter-item/antipattern.md +127 -0
  266. package/dist/collection/components/mds-filter-item/documentation.json +240 -0
  267. package/dist/collection/components/mds-filter-item/pattern.md +125 -0
  268. package/dist/collection/components/mds-header/AGENTS.md +95 -0
  269. package/dist/collection/components/mds-header/antipattern.md +120 -0
  270. package/dist/collection/components/mds-header/documentation.json +491 -0
  271. package/dist/collection/components/mds-header/mds-header.js +17 -8
  272. package/dist/collection/components/mds-header/pattern.md +182 -0
  273. package/dist/collection/components/mds-header-bar/AGENTS.md +80 -0
  274. package/dist/collection/components/mds-header-bar/antipattern.md +119 -0
  275. package/dist/collection/components/mds-header-bar/documentation.json +251 -0
  276. package/dist/collection/components/mds-header-bar/pattern.md +134 -0
  277. package/dist/collection/components/mds-help/AGENTS.md +65 -0
  278. package/dist/collection/components/mds-help/antipattern.md +73 -0
  279. package/dist/collection/components/mds-help/documentation.json +228 -0
  280. package/dist/collection/components/mds-help/pattern.md +106 -0
  281. package/dist/collection/components/mds-horizontal-scroll/AGENTS.md +72 -0
  282. package/dist/collection/components/mds-horizontal-scroll/antipattern.md +120 -0
  283. package/dist/collection/components/mds-horizontal-scroll/documentation.json +279 -0
  284. package/dist/collection/components/mds-horizontal-scroll/pattern.md +154 -0
  285. package/dist/collection/components/mds-hr/AGENTS.md +27 -0
  286. package/dist/collection/components/mds-hr/antipattern.md +84 -0
  287. package/dist/collection/components/mds-hr/documentation.json +33 -0
  288. package/dist/collection/components/mds-hr/pattern.md +88 -0
  289. package/dist/collection/components/mds-icon/AGENTS.md +52 -0
  290. package/dist/collection/components/mds-icon/antipattern.md +118 -0
  291. package/dist/collection/components/mds-icon/documentation.json +205 -0
  292. package/dist/collection/components/mds-icon/mds-icon.js +29 -4
  293. package/dist/collection/components/mds-icon/pattern.md +135 -0
  294. package/dist/collection/components/mds-icon/services/icons-set.service.js +47 -18
  295. package/dist/collection/components/mds-img/AGENTS.md +78 -0
  296. package/dist/collection/components/mds-img/antipattern.md +106 -0
  297. package/dist/collection/components/mds-img/documentation.json +470 -0
  298. package/dist/collection/components/mds-img/mds-img.js +3 -3
  299. package/dist/collection/components/mds-img/pattern.md +128 -0
  300. package/dist/collection/components/mds-input/AGENTS.md +138 -0
  301. package/dist/collection/components/mds-input/antipattern.md +128 -0
  302. package/dist/collection/components/mds-input/documentation.json +1574 -0
  303. package/dist/collection/components/mds-input/mds-input.js +185 -30
  304. package/dist/collection/components/mds-input/meta/input-type/InputValidationManager.js +8 -1
  305. package/dist/collection/components/mds-input/meta/validators.js +100 -2
  306. package/dist/collection/components/mds-input/meta/validity.js +35 -0
  307. package/dist/collection/components/mds-input/pattern.md +252 -0
  308. package/dist/collection/components/mds-input-date/AGENTS.md +98 -0
  309. package/dist/collection/components/mds-input-date/antipattern.md +107 -0
  310. package/dist/collection/components/mds-input-date/documentation.json +638 -0
  311. package/dist/collection/components/mds-input-date/mds-input-date.js +130 -24
  312. package/dist/collection/components/mds-input-date/pattern.md +158 -0
  313. package/dist/collection/components/mds-input-date-range/AGENTS.md +90 -0
  314. package/dist/collection/components/mds-input-date-range/antipattern.md +168 -0
  315. package/dist/collection/components/mds-input-date-range/documentation.json +502 -0
  316. package/dist/collection/components/mds-input-date-range/mds-input-date-range.css +13 -0
  317. package/dist/collection/components/mds-input-date-range/mds-input-date-range.js +112 -9
  318. package/dist/collection/components/mds-input-date-range/pattern.md +122 -0
  319. package/dist/collection/components/mds-input-date-range-preselection/AGENTS.md +62 -0
  320. package/dist/collection/components/mds-input-date-range-preselection/antipattern.md +147 -0
  321. package/dist/collection/components/mds-input-date-range-preselection/documentation.json +176 -0
  322. package/dist/collection/components/mds-input-date-range-preselection/pattern.md +101 -0
  323. package/dist/collection/components/mds-input-field/AGENTS.md +60 -0
  324. package/dist/collection/components/mds-input-field/antipattern.md +115 -0
  325. package/dist/collection/components/mds-input-field/documentation.json +178 -0
  326. package/dist/collection/components/mds-input-field/pattern.md +95 -0
  327. package/dist/collection/components/mds-input-otp/AGENTS.md +48 -0
  328. package/dist/collection/components/mds-input-otp/antipattern.md +105 -0
  329. package/dist/collection/components/mds-input-otp/documentation.json +203 -0
  330. package/dist/collection/components/mds-input-otp/mds-input-otp.css +4 -1
  331. package/dist/collection/components/mds-input-otp/mds-input-otp.js +88 -15
  332. package/dist/collection/components/mds-input-otp/pattern.md +107 -0
  333. package/dist/collection/components/mds-input-range/AGENTS.md +84 -0
  334. package/dist/collection/components/mds-input-range/antipattern.md +127 -0
  335. package/dist/collection/components/mds-input-range/documentation.json +315 -0
  336. package/dist/collection/components/mds-input-range/mds-input-range.css +6 -2
  337. package/dist/collection/components/mds-input-range/mds-input-range.js +30 -13
  338. package/dist/collection/components/mds-input-range/pattern.md +110 -0
  339. package/dist/collection/components/mds-input-select/AGENTS.md +99 -0
  340. package/dist/collection/components/mds-input-select/antipattern.md +126 -0
  341. package/dist/collection/components/mds-input-select/documentation.json +552 -0
  342. package/dist/collection/components/mds-input-select/mds-input-select.js +171 -40
  343. package/dist/collection/components/mds-input-select/meta/event-detail.js +1 -0
  344. package/dist/collection/components/mds-input-select/pattern.md +168 -0
  345. package/dist/collection/components/mds-input-switch/AGENTS.md +106 -0
  346. package/dist/collection/components/mds-input-switch/antipattern.md +117 -0
  347. package/dist/collection/components/mds-input-switch/documentation.json +638 -0
  348. package/dist/collection/components/mds-input-switch/mds-input-switch.css +4 -1
  349. package/dist/collection/components/mds-input-switch/mds-input-switch.js +59 -16
  350. package/dist/collection/components/mds-input-switch/pattern.md +133 -0
  351. package/dist/collection/components/mds-input-tip/AGENTS.md +56 -0
  352. package/dist/collection/components/mds-input-tip/antipattern.md +108 -0
  353. package/dist/collection/components/mds-input-tip/documentation.json +160 -0
  354. package/dist/collection/components/mds-input-tip/pattern.md +125 -0
  355. package/dist/collection/components/mds-input-tip-item/AGENTS.md +58 -0
  356. package/dist/collection/components/mds-input-tip-item/antipattern.md +98 -0
  357. package/dist/collection/components/mds-input-tip-item/documentation.json +181 -0
  358. package/dist/collection/components/mds-input-tip-item/pattern.md +107 -0
  359. package/dist/collection/components/mds-input-upload/AGENTS.md +78 -0
  360. package/dist/collection/components/mds-input-upload/antipattern.md +144 -0
  361. package/dist/collection/components/mds-input-upload/documentation.json +425 -0
  362. package/dist/collection/components/mds-input-upload/mds-input-upload.css +15 -0
  363. package/dist/collection/components/mds-input-upload/mds-input-upload.js +181 -67
  364. package/dist/collection/components/mds-input-upload/pattern.md +165 -0
  365. package/dist/collection/components/mds-keyboard/AGENTS.md +76 -0
  366. package/dist/collection/components/mds-keyboard/antipattern.md +111 -0
  367. package/dist/collection/components/mds-keyboard/documentation.json +227 -0
  368. package/dist/collection/components/mds-keyboard/mds-keyboard.js +6 -3
  369. package/dist/collection/components/mds-keyboard/pattern.md +129 -0
  370. package/dist/collection/components/mds-keyboard-key/AGENTS.md +55 -0
  371. package/dist/collection/components/mds-keyboard-key/antipattern.md +117 -0
  372. package/dist/collection/components/mds-keyboard-key/documentation.json +450 -0
  373. package/dist/collection/components/mds-keyboard-key/mds-keyboard-key.js +8 -5
  374. package/dist/collection/components/mds-keyboard-key/pattern.md +98 -0
  375. package/dist/collection/components/mds-kpi/AGENTS.md +44 -0
  376. package/dist/collection/components/mds-kpi/antipattern.md +93 -0
  377. package/dist/collection/components/mds-kpi/documentation.json +54 -0
  378. package/dist/collection/components/mds-kpi/pattern.md +109 -0
  379. package/dist/collection/components/mds-kpi-item/AGENTS.md +62 -0
  380. package/dist/collection/components/mds-kpi-item/antipattern.md +119 -0
  381. package/dist/collection/components/mds-kpi-item/documentation.json +199 -0
  382. package/dist/collection/components/mds-kpi-item/pattern.md +115 -0
  383. package/dist/collection/components/mds-label/AGENTS.md +71 -0
  384. package/dist/collection/components/mds-label/antipattern.md +92 -0
  385. package/dist/collection/components/mds-label/documentation.json +388 -0
  386. package/dist/collection/components/mds-label/pattern.md +111 -0
  387. package/dist/collection/components/mds-list/AGENTS.md +33 -0
  388. package/dist/collection/components/mds-list/antipattern.md +117 -0
  389. package/dist/collection/components/mds-list/documentation.json +43 -0
  390. package/dist/collection/components/mds-list/pattern.md +104 -0
  391. package/dist/collection/components/mds-list-item/AGENTS.md +60 -0
  392. package/dist/collection/components/mds-list-item/antipattern.md +118 -0
  393. package/dist/collection/components/mds-list-item/documentation.json +200 -0
  394. package/dist/collection/components/mds-list-item/pattern.md +101 -0
  395. package/dist/collection/components/mds-mention/AGENTS.md +55 -0
  396. package/dist/collection/components/mds-mention/antipattern.md +86 -0
  397. package/dist/collection/components/mds-mention/documentation.json +203 -0
  398. package/dist/collection/components/mds-mention/mds-mention.js +3 -2
  399. package/dist/collection/components/mds-mention/pattern.md +91 -0
  400. package/dist/collection/components/mds-modal/AGENTS.md +107 -0
  401. package/dist/collection/components/mds-modal/antipattern.md +96 -0
  402. package/dist/collection/components/mds-modal/documentation.json +552 -0
  403. package/dist/collection/components/mds-modal/pattern.md +228 -0
  404. package/dist/collection/components/mds-note/AGENTS.md +68 -0
  405. package/dist/collection/components/mds-note/antipattern.md +99 -0
  406. package/dist/collection/components/mds-note/documentation.json +220 -0
  407. package/dist/collection/components/mds-note/pattern.md +108 -0
  408. package/dist/collection/components/mds-notification/AGENTS.md +67 -0
  409. package/dist/collection/components/mds-notification/antipattern.md +86 -0
  410. package/dist/collection/components/mds-notification/documentation.json +253 -0
  411. package/dist/collection/components/mds-notification/mds-notification.js +11 -8
  412. package/dist/collection/components/mds-notification/pattern.md +98 -0
  413. package/dist/collection/components/mds-paginator/AGENTS.md +57 -0
  414. package/dist/collection/components/mds-paginator/antipattern.md +95 -0
  415. package/dist/collection/components/mds-paginator/documentation.json +135 -0
  416. package/dist/collection/components/mds-paginator/pattern.md +92 -0
  417. package/dist/collection/components/mds-paginator-item/AGENTS.md +74 -0
  418. package/dist/collection/components/mds-paginator-item/antipattern.md +95 -0
  419. package/dist/collection/components/mds-paginator-item/documentation.json +206 -0
  420. package/dist/collection/components/mds-paginator-item/pattern.md +75 -0
  421. package/dist/collection/components/mds-policy-ai/AGENTS.md +58 -0
  422. package/dist/collection/components/mds-policy-ai/antipattern.md +97 -0
  423. package/dist/collection/components/mds-policy-ai/documentation.json +244 -0
  424. package/dist/collection/components/mds-policy-ai/pattern.md +102 -0
  425. package/dist/collection/components/mds-pref/AGENTS.md +50 -0
  426. package/dist/collection/components/mds-pref/antipattern.md +85 -0
  427. package/dist/collection/components/mds-pref/documentation.json +138 -0
  428. package/dist/collection/components/mds-pref/mds-pref.js +7 -2
  429. package/dist/collection/components/mds-pref/pattern.md +93 -0
  430. package/dist/collection/components/mds-pref-animation/AGENTS.md +48 -0
  431. package/dist/collection/components/mds-pref-animation/antipattern.md +67 -0
  432. package/dist/collection/components/mds-pref-animation/documentation.json +154 -0
  433. package/dist/collection/components/mds-pref-animation/mds-pref-animation.js +26 -2
  434. package/dist/collection/components/mds-pref-animation/pattern.md +86 -0
  435. package/dist/collection/components/mds-pref-consumption/AGENTS.md +47 -0
  436. package/dist/collection/components/mds-pref-consumption/antipattern.md +84 -0
  437. package/dist/collection/components/mds-pref-consumption/documentation.json +154 -0
  438. package/dist/collection/components/mds-pref-consumption/mds-pref-consumption.js +26 -2
  439. package/dist/collection/components/mds-pref-consumption/pattern.md +70 -0
  440. package/dist/collection/components/mds-pref-contrast/AGENTS.md +50 -0
  441. package/dist/collection/components/mds-pref-contrast/antipattern.md +71 -0
  442. package/dist/collection/components/mds-pref-contrast/documentation.json +154 -0
  443. package/dist/collection/components/mds-pref-contrast/mds-pref-contrast.js +24 -3
  444. package/dist/collection/components/mds-pref-contrast/pattern.md +82 -0
  445. package/dist/collection/components/mds-pref-language/AGENTS.md +56 -0
  446. package/dist/collection/components/mds-pref-language/antipattern.md +130 -0
  447. package/dist/collection/components/mds-pref-language/documentation.json +174 -0
  448. package/dist/collection/components/mds-pref-language/pattern.md +104 -0
  449. package/dist/collection/components/mds-pref-language-item/AGENTS.md +48 -0
  450. package/dist/collection/components/mds-pref-language-item/antipattern.md +99 -0
  451. package/dist/collection/components/mds-pref-language-item/documentation.json +122 -0
  452. package/dist/collection/components/mds-pref-language-item/mds-pref-language-item.js +3 -2
  453. package/dist/collection/components/mds-pref-language-item/pattern.md +85 -0
  454. package/dist/collection/components/mds-pref-mode/AGENTS.md +53 -0
  455. package/dist/collection/components/mds-pref-mode/antipattern.md +104 -0
  456. package/dist/collection/components/mds-pref-mode/documentation.json +241 -0
  457. package/dist/collection/components/mds-pref-mode/mds-pref-mode.js +27 -4
  458. package/dist/collection/components/mds-pref-mode/pattern.md +94 -0
  459. package/dist/collection/components/mds-pref-theme/AGENTS.md +60 -0
  460. package/dist/collection/components/mds-pref-theme/antipattern.md +104 -0
  461. package/dist/collection/components/mds-pref-theme/documentation.json +277 -0
  462. package/dist/collection/components/mds-pref-theme/pattern.md +97 -0
  463. package/dist/collection/components/mds-pref-theme-item/AGENTS.md +60 -0
  464. package/dist/collection/components/mds-pref-theme-item/antipattern.md +98 -0
  465. package/dist/collection/components/mds-pref-theme-item/documentation.json +228 -0
  466. package/dist/collection/components/mds-pref-theme-item/mds-pref-theme-item.js +3 -2
  467. package/dist/collection/components/mds-pref-theme-item/pattern.md +98 -0
  468. package/dist/collection/components/mds-price-table/AGENTS.md +34 -0
  469. package/dist/collection/components/mds-price-table/antipattern.md +131 -0
  470. package/dist/collection/components/mds-price-table/documentation.json +43 -0
  471. package/dist/collection/components/mds-price-table/pattern.md +182 -0
  472. package/dist/collection/components/mds-price-table-features/AGENTS.md +61 -0
  473. package/dist/collection/components/mds-price-table-features/antipattern.md +152 -0
  474. package/dist/collection/components/mds-price-table-features/documentation.json +96 -0
  475. package/dist/collection/components/mds-price-table-features/pattern.md +157 -0
  476. package/dist/collection/components/mds-price-table-features-cell/AGENTS.md +69 -0
  477. package/dist/collection/components/mds-price-table-features-cell/antipattern.md +105 -0
  478. package/dist/collection/components/mds-price-table-features-cell/documentation.json +154 -0
  479. package/dist/collection/components/mds-price-table-features-cell/pattern.md +128 -0
  480. package/dist/collection/components/mds-price-table-features-row/AGENTS.md +43 -0
  481. package/dist/collection/components/mds-price-table-features-row/antipattern.md +135 -0
  482. package/dist/collection/components/mds-price-table-features-row/documentation.json +64 -0
  483. package/dist/collection/components/mds-price-table-features-row/pattern.md +125 -0
  484. package/dist/collection/components/mds-price-table-header/AGENTS.md +34 -0
  485. package/dist/collection/components/mds-price-table-header/antipattern.md +133 -0
  486. package/dist/collection/components/mds-price-table-header/documentation.json +43 -0
  487. package/dist/collection/components/mds-price-table-header/pattern.md +176 -0
  488. package/dist/collection/components/mds-price-table-list/AGENTS.md +63 -0
  489. package/dist/collection/components/mds-price-table-list/antipattern.md +133 -0
  490. package/dist/collection/components/mds-price-table-list/documentation.json +104 -0
  491. package/dist/collection/components/mds-price-table-list/pattern.md +134 -0
  492. package/dist/collection/components/mds-price-table-list-item/AGENTS.md +61 -0
  493. package/dist/collection/components/mds-price-table-list-item/antipattern.md +90 -0
  494. package/dist/collection/components/mds-price-table-list-item/documentation.json +145 -0
  495. package/dist/collection/components/mds-price-table-list-item/pattern.md +105 -0
  496. package/dist/collection/components/mds-progress/AGENTS.md +68 -0
  497. package/dist/collection/components/mds-progress/antipattern.md +94 -0
  498. package/dist/collection/components/mds-progress/documentation.json +375 -0
  499. package/dist/collection/components/mds-progress/pattern.md +139 -0
  500. package/dist/collection/components/mds-push-notification/AGENTS.md +88 -0
  501. package/dist/collection/components/mds-push-notification/antipattern.md +154 -0
  502. package/dist/collection/components/mds-push-notification/documentation.json +306 -0
  503. package/dist/collection/components/mds-push-notification/pattern.md +203 -0
  504. package/dist/collection/components/mds-push-notification-item/AGENTS.md +91 -0
  505. package/dist/collection/components/mds-push-notification-item/antipattern.md +129 -0
  506. package/dist/collection/components/mds-push-notification-item/documentation.json +586 -0
  507. package/dist/collection/components/mds-push-notification-item/pattern.md +201 -0
  508. package/dist/collection/components/mds-quote/AGENTS.md +51 -0
  509. package/dist/collection/components/mds-quote/antipattern.md +122 -0
  510. package/dist/collection/components/mds-quote/documentation.json +176 -0
  511. package/dist/collection/components/mds-quote/pattern.md +108 -0
  512. package/dist/collection/components/mds-radial-menu/AGENTS.md +87 -0
  513. package/dist/collection/components/mds-radial-menu/antipattern.md +104 -0
  514. package/dist/collection/components/mds-radial-menu/documentation.json +581 -0
  515. package/dist/collection/components/mds-radial-menu/pattern.md +150 -0
  516. package/dist/collection/components/mds-radial-menu-item/AGENTS.md +51 -0
  517. package/dist/collection/components/mds-radial-menu-item/antipattern.md +106 -0
  518. package/dist/collection/components/mds-radial-menu-item/documentation.json +294 -0
  519. package/dist/collection/components/mds-radial-menu-item/pattern.md +98 -0
  520. package/dist/collection/components/mds-radial-progress/AGENTS.md +58 -0
  521. package/dist/collection/components/mds-radial-progress/antipattern.md +99 -0
  522. package/dist/collection/components/mds-radial-progress/documentation.json +232 -0
  523. package/dist/collection/components/mds-radial-progress/pattern.md +132 -0
  524. package/dist/collection/components/mds-separator/AGENTS.md +39 -0
  525. package/dist/collection/components/mds-separator/antipattern.md +98 -0
  526. package/dist/collection/components/mds-separator/documentation.json +45 -0
  527. package/dist/collection/components/mds-separator/pattern.md +82 -0
  528. package/dist/collection/components/mds-spinner/AGENTS.md +49 -0
  529. package/dist/collection/components/mds-spinner/antipattern.md +93 -0
  530. package/dist/collection/components/mds-spinner/documentation.json +86 -0
  531. package/dist/collection/components/mds-spinner/pattern.md +102 -0
  532. package/dist/collection/components/mds-status-bar/AGENTS.md +75 -0
  533. package/dist/collection/components/mds-status-bar/antipattern.md +128 -0
  534. package/dist/collection/components/mds-status-bar/documentation.json +262 -0
  535. package/dist/collection/components/mds-status-bar/pattern.md +123 -0
  536. package/dist/collection/components/mds-stepper-bar/AGENTS.md +74 -0
  537. package/dist/collection/components/mds-stepper-bar/antipattern.md +123 -0
  538. package/dist/collection/components/mds-stepper-bar/documentation.json +208 -0
  539. package/dist/collection/components/mds-stepper-bar/mds-stepper-bar.js +5 -3
  540. package/dist/collection/components/mds-stepper-bar/pattern.md +182 -0
  541. package/dist/collection/components/mds-stepper-bar-item/AGENTS.md +84 -0
  542. package/dist/collection/components/mds-stepper-bar-item/antipattern.md +115 -0
  543. package/dist/collection/components/mds-stepper-bar-item/documentation.json +453 -0
  544. package/dist/collection/components/mds-stepper-bar-item/pattern.md +203 -0
  545. package/dist/collection/components/mds-tab/AGENTS.md +109 -0
  546. package/dist/collection/components/mds-tab/antipattern.md +164 -0
  547. package/dist/collection/components/mds-tab/documentation.json +495 -0
  548. package/dist/collection/components/mds-tab/pattern.md +201 -0
  549. package/dist/collection/components/mds-tab-bar/AGENTS.md +46 -0
  550. package/dist/collection/components/mds-tab-bar/antipattern.md +105 -0
  551. package/dist/collection/components/mds-tab-bar/documentation.json +71 -0
  552. package/dist/collection/components/mds-tab-bar/pattern.md +87 -0
  553. package/dist/collection/components/mds-tab-bar-item/AGENTS.md +67 -0
  554. package/dist/collection/components/mds-tab-bar-item/antipattern.md +116 -0
  555. package/dist/collection/components/mds-tab-bar-item/documentation.json +210 -0
  556. package/dist/collection/components/mds-tab-bar-item/mds-tab-bar-item.js +3 -2
  557. package/dist/collection/components/mds-tab-bar-item/pattern.md +110 -0
  558. package/dist/collection/components/mds-tab-item/AGENTS.md +82 -0
  559. package/dist/collection/components/mds-tab-item/antipattern.md +138 -0
  560. package/dist/collection/components/mds-tab-item/documentation.json +577 -0
  561. package/dist/collection/components/mds-tab-item/pattern.md +155 -0
  562. package/dist/collection/components/mds-table/AGENTS.md +90 -0
  563. package/dist/collection/components/mds-table/antipattern.md +169 -0
  564. package/dist/collection/components/mds-table/documentation.json +304 -0
  565. package/dist/collection/components/mds-table/pattern.md +288 -0
  566. package/dist/collection/components/mds-table-body/AGENTS.md +55 -0
  567. package/dist/collection/components/mds-table-body/antipattern.md +118 -0
  568. package/dist/collection/components/mds-table-body/documentation.json +122 -0
  569. package/dist/collection/components/mds-table-body/pattern.md +154 -0
  570. package/dist/collection/components/mds-table-cell/AGENTS.md +56 -0
  571. package/dist/collection/components/mds-table-cell/antipattern.md +100 -0
  572. package/dist/collection/components/mds-table-cell/documentation.json +104 -0
  573. package/dist/collection/components/mds-table-cell/pattern.md +168 -0
  574. package/dist/collection/components/mds-table-footer/AGENTS.md +33 -0
  575. package/dist/collection/components/mds-table-footer/antipattern.md +114 -0
  576. package/dist/collection/components/mds-table-footer/documentation.json +43 -0
  577. package/dist/collection/components/mds-table-footer/pattern.md +116 -0
  578. package/dist/collection/components/mds-table-header/AGENTS.md +61 -0
  579. package/dist/collection/components/mds-table-header/antipattern.md +157 -0
  580. package/dist/collection/components/mds-table-header/documentation.json +156 -0
  581. package/dist/collection/components/mds-table-header/pattern.md +158 -0
  582. package/dist/collection/components/mds-table-header-cell/AGENTS.md +51 -0
  583. package/dist/collection/components/mds-table-header-cell/antipattern.md +108 -0
  584. package/dist/collection/components/mds-table-header-cell/documentation.json +158 -0
  585. package/dist/collection/components/mds-table-header-cell/mds-table-header-cell.js +2 -2
  586. package/dist/collection/components/mds-table-header-cell/pattern.md +145 -0
  587. package/dist/collection/components/mds-table-row/AGENTS.md +68 -0
  588. package/dist/collection/components/mds-table-row/antipattern.md +142 -0
  589. package/dist/collection/components/mds-table-row/documentation.json +252 -0
  590. package/dist/collection/components/mds-table-row/pattern.md +157 -0
  591. package/dist/collection/components/mds-text/AGENTS.md +64 -0
  592. package/dist/collection/components/mds-text/antipattern.md +113 -0
  593. package/dist/collection/components/mds-text/documentation.json +746 -0
  594. package/dist/collection/components/mds-text/mds-text.js +2 -1
  595. package/dist/collection/components/mds-text/pattern.md +139 -0
  596. package/dist/collection/components/mds-toast/AGENTS.md +78 -0
  597. package/dist/collection/components/mds-toast/antipattern.md +131 -0
  598. package/dist/collection/components/mds-toast/documentation.json +339 -0
  599. package/dist/collection/components/mds-toast/mds-toast.js +9 -3
  600. package/dist/collection/components/mds-toast/pattern.md +161 -0
  601. package/dist/collection/components/mds-tooltip/AGENTS.md +80 -0
  602. package/dist/collection/components/mds-tooltip/antipattern.md +108 -0
  603. package/dist/collection/components/mds-tooltip/documentation.json +483 -0
  604. package/dist/collection/components/mds-tooltip/mds-tooltip.js +4 -4
  605. package/dist/collection/components/mds-tooltip/pattern.md +128 -0
  606. package/dist/collection/components/mds-tree/AGENTS.md +88 -0
  607. package/dist/collection/components/mds-tree/antipattern.md +153 -0
  608. package/dist/collection/components/mds-tree/documentation.json +472 -0
  609. package/dist/collection/components/mds-tree/pattern.md +198 -0
  610. package/dist/collection/components/mds-tree-item/AGENTS.md +119 -0
  611. package/dist/collection/components/mds-tree-item/antipattern.md +152 -0
  612. package/dist/collection/components/mds-tree-item/documentation.json +646 -0
  613. package/dist/collection/components/mds-tree-item/pattern.md +201 -0
  614. package/dist/collection/components/mds-url-view/AGENTS.md +63 -0
  615. package/dist/collection/components/mds-url-view/antipattern.md +107 -0
  616. package/dist/collection/components/mds-url-view/documentation.json +209 -0
  617. package/dist/collection/components/mds-url-view/pattern.md +106 -0
  618. package/dist/collection/components/mds-usage/AGENTS.md +70 -0
  619. package/dist/collection/components/mds-usage/antipattern.md +87 -0
  620. package/dist/collection/components/mds-usage/documentation.json +156 -0
  621. package/dist/collection/components/mds-usage/pattern.md +117 -0
  622. package/dist/collection/components/mds-video-wall/AGENTS.md +65 -0
  623. package/dist/collection/components/mds-video-wall/antipattern.md +97 -0
  624. package/dist/collection/components/mds-video-wall/documentation.json +316 -0
  625. package/dist/collection/components/mds-video-wall/pattern.md +101 -0
  626. package/dist/collection/components/mds-zero/AGENTS.md +55 -0
  627. package/dist/collection/components/mds-zero/antipattern.md +106 -0
  628. package/dist/collection/components/mds-zero/documentation.json +82 -0
  629. package/dist/collection/components/mds-zero/pattern.md +118 -0
  630. package/dist/collection/dictionary/icon.js +1 -1
  631. package/dist/components/index.js +1 -1
  632. package/dist/components/mds-accordion-item.js +1 -1
  633. package/dist/components/mds-accordion-timer-item.js +1 -1
  634. package/dist/components/mds-accordion-timer.js +1 -1
  635. package/dist/components/mds-accordion.js +1 -1
  636. package/dist/components/mds-author.js +1 -1
  637. package/dist/components/mds-avatar-stack-item.js +1 -1
  638. package/dist/components/mds-avatar-stack.js +1 -1
  639. package/dist/components/mds-avatar.js +1 -1
  640. package/dist/components/mds-badge.js +1 -1
  641. package/dist/components/mds-banner.js +1 -1
  642. package/dist/components/mds-benchmark-bar.js +1 -1
  643. package/dist/components/mds-bibliography.js +1 -1
  644. package/dist/components/mds-breadcrumb-item.js +1 -1
  645. package/dist/components/mds-breadcrumb.js +1 -1
  646. package/dist/components/mds-button-dropdown.js +1 -1
  647. package/dist/components/mds-button-group.js +1 -1
  648. package/dist/components/mds-button.js +1 -1
  649. package/dist/components/mds-calendar-cell.js +1 -1
  650. package/dist/components/mds-calendar.js +1 -1
  651. package/dist/components/mds-card-content.js +1 -1
  652. package/dist/components/mds-card-footer.js +1 -1
  653. package/dist/components/mds-card-header.js +1 -1
  654. package/dist/components/mds-card-media.js +1 -1
  655. package/dist/components/mds-card.js +1 -1
  656. package/dist/components/mds-chip.js +1 -1
  657. package/dist/components/mds-details.js +1 -1
  658. package/dist/components/mds-dropdown.js +1 -1
  659. package/dist/components/mds-emoji.js +3 -3
  660. package/dist/components/mds-entity.js +1 -1
  661. package/dist/components/mds-file-preview.js +1 -1
  662. package/dist/components/mds-file.js +3 -3
  663. package/dist/components/mds-filter-item.js +1 -1
  664. package/dist/components/mds-filter.js +1 -1
  665. package/dist/components/mds-header-bar.js +1 -1
  666. package/dist/components/mds-header.js +1 -1
  667. package/dist/components/mds-help.js +1 -1
  668. package/dist/components/mds-horizontal-scroll.js +1 -1
  669. package/dist/components/mds-hr.js +1 -1
  670. package/dist/components/mds-icon.js +1 -1
  671. package/dist/components/mds-img.js +1 -1
  672. package/dist/components/mds-input-date-range-preselection.js +1 -1
  673. package/dist/components/mds-input-date-range.js +1 -1
  674. package/dist/components/mds-input-date.js +1 -1
  675. package/dist/components/mds-input-field.js +1 -1
  676. package/dist/components/mds-input-otp.js +1 -1
  677. package/dist/components/mds-input-range.js +1 -1
  678. package/dist/components/mds-input-select.js +1 -1
  679. package/dist/components/mds-input-switch.js +1 -1
  680. package/dist/components/mds-input-tip-item.js +1 -1
  681. package/dist/components/mds-input-tip.js +1 -1
  682. package/dist/components/mds-input-upload.js +1 -1
  683. package/dist/components/mds-input.js +1 -1
  684. package/dist/components/mds-keyboard-key.js +1 -1
  685. package/dist/components/mds-keyboard.js +1 -1
  686. package/dist/components/mds-kpi-item.js +1 -1
  687. package/dist/components/mds-kpi.js +1 -1
  688. package/dist/components/mds-label.js +1 -1
  689. package/dist/components/mds-list-item.js +1 -1
  690. package/dist/components/mds-list.js +1 -1
  691. package/dist/components/mds-mention.js +1 -1
  692. package/dist/components/mds-modal.js +1 -1
  693. package/dist/components/mds-note.js +1 -1
  694. package/dist/components/mds-notification.js +1 -1
  695. package/dist/components/mds-paginator-item.js +1 -1
  696. package/dist/components/mds-paginator.js +1 -1
  697. package/dist/components/mds-policy-ai.js +1 -1
  698. package/dist/components/mds-pref-animation.js +1 -1
  699. package/dist/components/mds-pref-consumption.js +1 -1
  700. package/dist/components/mds-pref-contrast.js +1 -1
  701. package/dist/components/mds-pref-language-item.js +1 -1
  702. package/dist/components/mds-pref-language.js +1 -1
  703. package/dist/components/mds-pref-mode.js +1 -1
  704. package/dist/components/mds-pref-theme-item.js +1 -1
  705. package/dist/components/mds-pref-theme.js +1 -1
  706. package/dist/components/mds-pref.js +1 -1
  707. package/dist/components/mds-price-table-features-cell.js +1 -1
  708. package/dist/components/mds-price-table-features-row.js +1 -1
  709. package/dist/components/mds-price-table-features.js +1 -1
  710. package/dist/components/mds-price-table-header.js +1 -1
  711. package/dist/components/mds-price-table-list-item.js +1 -1
  712. package/dist/components/mds-price-table-list.js +1 -1
  713. package/dist/components/mds-price-table.js +1 -1
  714. package/dist/components/mds-progress.js +1 -1
  715. package/dist/components/mds-push-notification-item.js +1 -1
  716. package/dist/components/mds-push-notification.js +1 -1
  717. package/dist/components/mds-quote.js +1 -1
  718. package/dist/components/mds-radial-menu-item.js +1 -1
  719. package/dist/components/mds-radial-menu.js +1 -1
  720. package/dist/components/mds-radial-progress.js +1 -1
  721. package/dist/components/mds-separator.js +1 -1
  722. package/dist/components/mds-spinner.js +1 -1
  723. package/dist/components/mds-status-bar.js +1 -1
  724. package/dist/components/mds-stepper-bar-item.js +1 -1
  725. package/dist/components/mds-stepper-bar.js +1 -1
  726. package/dist/components/mds-tab-bar-item.js +1 -1
  727. package/dist/components/mds-tab-bar.js +1 -1
  728. package/dist/components/mds-tab-item.js +1 -1
  729. package/dist/components/mds-tab.js +1 -1
  730. package/dist/components/mds-table-body.js +1 -1
  731. package/dist/components/mds-table-cell.js +1 -1
  732. package/dist/components/mds-table-footer.js +1 -1
  733. package/dist/components/mds-table-header-cell.js +1 -1
  734. package/dist/components/mds-table-header.js +1 -1
  735. package/dist/components/mds-table-row.js +1 -1
  736. package/dist/components/mds-table.js +1 -1
  737. package/dist/components/mds-text.js +1 -1
  738. package/dist/components/mds-toast.js +1 -1
  739. package/dist/components/mds-tooltip.js +1 -1
  740. package/dist/components/mds-tree-item.js +1 -1
  741. package/dist/components/mds-tree.js +1 -1
  742. package/dist/components/mds-url-view.js +1 -1
  743. package/dist/components/mds-usage.js +1 -1
  744. package/dist/components/mds-video-wall.js +1 -1
  745. package/dist/components/mds-zero.js +1 -1
  746. package/dist/components/p--miH951G.js +5 -0
  747. package/dist/components/p-1aH7xiMs.js +1 -0
  748. package/dist/components/p-B05zwjTY.js +1 -0
  749. package/dist/components/p-BOu_NOgd.js +1 -0
  750. package/dist/components/p-BTpjOy0A.js +1 -0
  751. package/dist/components/p-BVw5aqzn.js +1 -0
  752. package/dist/components/p-BW24ByN-.js +1 -0
  753. package/dist/components/p-BWpSxp3h.js +1 -0
  754. package/dist/components/p-BXPIlPIF.js +1 -0
  755. package/dist/components/p-BzvYQBdf.js +1 -0
  756. package/dist/components/p-C3Sn8bRc.js +1 -0
  757. package/dist/components/p-CGkSDkOY.js +1 -0
  758. package/dist/components/p-CIcshx6K.js +1 -0
  759. package/dist/components/p-CKS4r32k.js +1 -0
  760. package/dist/components/p-COkF_8bh.js +1 -0
  761. package/dist/components/p-CmHMhHMt.js +1 -0
  762. package/dist/components/p-Cnt6G6GK.js +1 -0
  763. package/dist/components/p-CsL9U6eU.js +1 -0
  764. package/dist/components/p-Cyj1BFxx.js +1 -0
  765. package/dist/components/p-DQqUzCGR.js +1 -0
  766. package/dist/components/p-DR46G4-6.js +1 -0
  767. package/dist/components/p-DcW0iRnZ.js +1 -0
  768. package/dist/components/p-DebgFlHq.js +1 -0
  769. package/dist/components/p-DmPLOktp.js +1 -0
  770. package/dist/components/p-Dpf8NWF9.js +1 -0
  771. package/dist/components/p-DwA-5c8G.js +1 -0
  772. package/dist/components/p-Dws02cT2.js +8 -0
  773. package/dist/components/p-K3QNYRhf.js +1 -0
  774. package/dist/components/p-PQ_EO5-U.js +1 -0
  775. package/dist/components/p-akEzGmDD.js +1 -0
  776. package/dist/components/p-bDVBqkn0.js +1 -0
  777. package/dist/components/p-faViX-qz.js +1 -0
  778. package/dist/components/p-pBvN1uAc.js +3 -0
  779. package/dist/components/p-wI0alRSO.js +1 -0
  780. package/dist/components/p-x_c_51aL.js +1 -0
  781. package/dist/components/p-zHpei4x6.js +1 -0
  782. package/dist/documentation.json +618 -360
  783. package/dist/esm/floating-controller-BTYkH_Ih.js +366 -0
  784. package/dist/esm/form-wI0alRSO.js +42 -0
  785. package/dist/esm/index-BhCZiGfL.js +196 -0
  786. package/dist/esm/index-BxPbQB28.js +5149 -0
  787. package/dist/esm/index.js +65 -23
  788. package/dist/esm/loader.js +3 -3
  789. package/dist/esm/locale-CVJm6KFD.js +814 -0
  790. package/dist/esm/magma-components.js +3 -3
  791. package/dist/esm/mds-accordion-item.entry.js +2 -2
  792. package/dist/esm/mds-accordion-timer-item.entry.js +2 -2
  793. package/dist/esm/mds-accordion-timer.entry.js +1 -1
  794. package/dist/esm/mds-accordion.entry.js +2 -2
  795. package/dist/esm/mds-author.entry.js +1 -1
  796. package/dist/esm/mds-avatar-stack-item.entry.js +1 -1
  797. package/dist/esm/mds-avatar-stack.entry.js +1 -1
  798. package/dist/esm/mds-avatar.entry.js +29 -34
  799. package/dist/esm/mds-badge.entry.js +5 -4
  800. package/dist/esm/mds-banner_3.entry.js +3 -3
  801. package/dist/esm/mds-benchmark-bar.entry.js +4 -3
  802. package/dist/esm/mds-bibliography.entry.js +5 -4
  803. package/dist/esm/mds-breadcrumb-item.entry.js +1 -1
  804. package/dist/esm/mds-breadcrumb.entry.js +3 -3
  805. package/dist/esm/mds-button-dropdown.entry.js +38 -4
  806. package/dist/esm/mds-button-group.entry.js +1 -1
  807. package/dist/esm/mds-button_3.entry.js +42 -15
  808. package/dist/esm/mds-calendar_2.entry.js +2 -2
  809. package/dist/esm/mds-card-content.entry.js +1 -1
  810. package/dist/esm/mds-card-footer.entry.js +1 -1
  811. package/dist/esm/mds-card-header.entry.js +1 -1
  812. package/dist/esm/mds-card-media.entry.js +1 -1
  813. package/dist/esm/mds-card.entry.js +2 -2
  814. package/dist/esm/mds-details.entry.js +2 -2
  815. package/dist/esm/mds-dropdown.entry.js +7 -6
  816. package/dist/esm/mds-emoji.entry.js +2 -2
  817. package/dist/esm/mds-entity.entry.js +3 -3
  818. package/dist/esm/mds-file-preview.entry.js +20 -20
  819. package/dist/esm/mds-file.entry.js +3 -3
  820. package/dist/esm/mds-filter-item.entry.js +2 -2
  821. package/dist/esm/mds-filter.entry.js +2 -2
  822. package/dist/esm/mds-header-bar.entry.js +2 -2
  823. package/dist/esm/mds-header.entry.js +19 -10
  824. package/dist/esm/mds-horizontal-scroll.entry.js +1 -1
  825. package/dist/esm/mds-hr.entry.js +2 -2
  826. package/dist/esm/mds-img.entry.js +6 -6
  827. package/dist/esm/mds-input-date-range-preselection.entry.js +1 -1
  828. package/dist/esm/mds-input-date-range.entry.js +95 -13
  829. package/dist/esm/mds-input-date.entry.js +124 -27
  830. package/dist/esm/mds-input-field.entry.js +1 -1
  831. package/dist/esm/mds-input-otp.entry.js +65 -19
  832. package/dist/esm/mds-input-range.entry.js +32 -16
  833. package/dist/esm/mds-input-select.entry.js +166 -35
  834. package/dist/esm/mds-input-switch_2.entry.js +63 -21
  835. package/dist/esm/mds-input-tip_2.entry.js +3 -3
  836. package/dist/esm/mds-input-upload.entry.js +141 -68
  837. package/dist/esm/mds-input.entry.js +320 -36
  838. package/dist/esm/mds-keyboard-key.entry.js +11 -8
  839. package/dist/esm/mds-keyboard.entry.js +9 -6
  840. package/dist/esm/mds-kpi-item.entry.js +2 -2
  841. package/dist/esm/mds-kpi.entry.js +1 -1
  842. package/dist/esm/mds-label.entry.js +3 -3
  843. package/dist/esm/mds-list-item.entry.js +2 -2
  844. package/dist/esm/mds-list.entry.js +1 -1
  845. package/dist/esm/mds-mention.entry.js +6 -5
  846. package/dist/esm/mds-modal.entry.js +2 -2
  847. package/dist/esm/mds-note.entry.js +3 -3
  848. package/dist/esm/mds-notification.entry.js +13 -10
  849. package/dist/esm/mds-paginator-item.entry.js +2 -2
  850. package/dist/esm/mds-paginator.entry.js +2 -2
  851. package/dist/esm/mds-policy-ai.entry.js +3 -3
  852. package/dist/esm/mds-pref-animation.entry.js +29 -5
  853. package/dist/esm/mds-pref-consumption.entry.js +29 -5
  854. package/dist/esm/mds-pref-contrast.entry.js +27 -6
  855. package/dist/esm/mds-pref-language-item.entry.js +6 -5
  856. package/dist/esm/mds-pref-language.entry.js +3 -3
  857. package/dist/esm/mds-pref-mode.entry.js +30 -7
  858. package/dist/esm/mds-pref-theme-item.entry.js +4 -3
  859. package/dist/esm/mds-pref-theme.entry.js +3 -3
  860. package/dist/esm/mds-pref.entry.js +10 -5
  861. package/dist/esm/mds-price-table-features-cell.entry.js +2 -2
  862. package/dist/esm/mds-price-table-features-row.entry.js +2 -2
  863. package/dist/esm/mds-price-table-features.entry.js +2 -2
  864. package/dist/esm/mds-price-table-header.entry.js +1 -1
  865. package/dist/esm/mds-price-table-list-item.entry.js +1 -1
  866. package/dist/esm/mds-price-table-list.entry.js +2 -2
  867. package/dist/esm/mds-price-table.entry.js +1 -1
  868. package/dist/esm/mds-progress_2.entry.js +2 -2
  869. package/dist/esm/mds-push-notification-item.entry.js +4 -4
  870. package/dist/esm/mds-push-notification.entry.js +2 -2
  871. package/dist/esm/mds-quote.entry.js +2 -2
  872. package/dist/esm/mds-radial-menu-item.entry.js +1 -1
  873. package/dist/esm/mds-radial-menu.entry.js +2 -2
  874. package/dist/esm/mds-separator.entry.js +2 -2
  875. package/dist/esm/mds-status-bar.entry.js +2 -2
  876. package/dist/esm/mds-stepper-bar-item.entry.js +3 -3
  877. package/dist/esm/mds-stepper-bar.entry.js +6 -4
  878. package/dist/esm/mds-tab-bar-item.entry.js +5 -4
  879. package/dist/esm/mds-tab-bar.entry.js +2 -2
  880. package/dist/esm/mds-tab_2.entry.js +2 -2
  881. package/dist/esm/mds-table-body.entry.js +2 -2
  882. package/dist/esm/mds-table-footer.entry.js +2 -2
  883. package/dist/esm/mds-table-header-cell.entry.js +4 -4
  884. package/dist/esm/mds-table-header.entry.js +3 -3
  885. package/dist/esm/mds-table-row.entry.js +3 -3
  886. package/dist/esm/mds-table.entry.js +3 -3
  887. package/dist/esm/mds-text.entry.js +4 -3
  888. package/dist/esm/mds-toast.entry.js +11 -5
  889. package/dist/esm/mds-tooltip.entry.js +7 -7
  890. package/dist/esm/mds-tree-item.entry.js +3 -3
  891. package/dist/esm/mds-tree.entry.js +1 -1
  892. package/dist/esm/mds-url-view.entry.js +3 -3
  893. package/dist/esm/mds-usage.entry.js +3 -3
  894. package/dist/esm/mds-video-wall.entry.js +1 -1
  895. package/dist/esm/mds-zero.entry.js +2 -2
  896. package/dist/esm/preference-DNNqH7BU.js +385 -0
  897. package/dist/esm-es5/floating-controller-BTYkH_Ih.js +66 -0
  898. package/dist/esm-es5/form-wI0alRSO.js +16 -0
  899. package/dist/esm-es5/index-BhCZiGfL.js +10 -0
  900. package/dist/esm-es5/index-BxPbQB28.js +371 -0
  901. package/dist/esm-es5/index.js +37 -26
  902. package/dist/esm-es5/loader.js +1 -1
  903. package/dist/esm-es5/locale-CVJm6KFD.js +230 -0
  904. package/dist/esm-es5/magma-components.js +2 -2
  905. package/dist/esm-es5/mds-accordion-item.entry.js +1 -1
  906. package/dist/esm-es5/mds-accordion-timer-item.entry.js +1 -1
  907. package/dist/esm-es5/mds-accordion-timer.entry.js +1 -1
  908. package/dist/esm-es5/mds-accordion.entry.js +1 -1
  909. package/dist/esm-es5/mds-author.entry.js +1 -1
  910. package/dist/esm-es5/mds-avatar-stack-item.entry.js +1 -1
  911. package/dist/esm-es5/mds-avatar-stack.entry.js +1 -1
  912. package/dist/esm-es5/mds-avatar.entry.js +5 -3
  913. package/dist/esm-es5/mds-badge.entry.js +3 -4
  914. package/dist/esm-es5/mds-banner_3.entry.js +1 -1
  915. package/dist/esm-es5/mds-benchmark-bar.entry.js +3 -4
  916. package/dist/esm-es5/mds-bibliography.entry.js +2 -2
  917. package/dist/esm-es5/mds-breadcrumb-item.entry.js +1 -1
  918. package/dist/esm-es5/mds-breadcrumb.entry.js +2 -2
  919. package/dist/esm-es5/mds-button-dropdown.entry.js +10 -4
  920. package/dist/esm-es5/mds-button-group.entry.js +1 -1
  921. package/dist/esm-es5/mds-button_3.entry.js +14 -9
  922. package/dist/esm-es5/mds-calendar_2.entry.js +1 -1
  923. package/dist/esm-es5/mds-card-content.entry.js +1 -1
  924. package/dist/esm-es5/mds-card-footer.entry.js +1 -1
  925. package/dist/esm-es5/mds-card-header.entry.js +1 -1
  926. package/dist/esm-es5/mds-card-media.entry.js +1 -1
  927. package/dist/esm-es5/mds-card.entry.js +1 -1
  928. package/dist/esm-es5/mds-details.entry.js +1 -1
  929. package/dist/esm-es5/mds-dropdown.entry.js +3 -3
  930. package/dist/esm-es5/mds-emoji.entry.js +1 -1
  931. package/dist/esm-es5/mds-entity.entry.js +1 -1
  932. package/dist/esm-es5/mds-file-preview.entry.js +16 -14
  933. package/dist/esm-es5/mds-file.entry.js +11 -11
  934. package/dist/esm-es5/mds-filter-item.entry.js +1 -1
  935. package/dist/esm-es5/mds-filter.entry.js +1 -1
  936. package/dist/esm-es5/mds-header-bar.entry.js +1 -1
  937. package/dist/esm-es5/mds-header.entry.js +8 -6
  938. package/dist/esm-es5/mds-horizontal-scroll.entry.js +1 -1
  939. package/dist/esm-es5/mds-hr.entry.js +1 -1
  940. package/dist/esm-es5/mds-img.entry.js +2 -2
  941. package/dist/esm-es5/mds-input-date-range-preselection.entry.js +1 -1
  942. package/dist/esm-es5/mds-input-date-range.entry.js +35 -6
  943. package/dist/esm-es5/mds-input-date.entry.js +47 -7
  944. package/dist/esm-es5/mds-input-field.entry.js +1 -1
  945. package/dist/esm-es5/mds-input-otp.entry.js +21 -4
  946. package/dist/esm-es5/mds-input-range.entry.js +15 -7
  947. package/dist/esm-es5/mds-input-select.entry.js +39 -6
  948. package/dist/esm-es5/mds-input-switch_2.entry.js +24 -4
  949. package/dist/esm-es5/mds-input-tip_2.entry.js +1 -1
  950. package/dist/esm-es5/mds-input-upload.entry.js +43 -17
  951. package/dist/esm-es5/mds-input.entry.js +105 -22
  952. package/dist/esm-es5/mds-keyboard-key.entry.js +3 -1
  953. package/dist/esm-es5/mds-keyboard.entry.js +4 -2
  954. package/dist/esm-es5/mds-kpi-item.entry.js +1 -1
  955. package/dist/esm-es5/mds-kpi.entry.js +1 -1
  956. package/dist/esm-es5/mds-label.entry.js +1 -1
  957. package/dist/esm-es5/mds-list-item.entry.js +1 -1
  958. package/dist/esm-es5/mds-list.entry.js +1 -1
  959. package/dist/esm-es5/mds-mention.entry.js +2 -2
  960. package/dist/esm-es5/mds-modal.entry.js +1 -1
  961. package/dist/esm-es5/mds-note.entry.js +1 -1
  962. package/dist/esm-es5/mds-notification.entry.js +5 -3
  963. package/dist/esm-es5/mds-paginator-item.entry.js +1 -1
  964. package/dist/esm-es5/mds-paginator.entry.js +1 -1
  965. package/dist/esm-es5/mds-policy-ai.entry.js +1 -1
  966. package/dist/esm-es5/mds-pref-animation.entry.js +7 -1
  967. package/dist/esm-es5/mds-pref-consumption.entry.js +7 -1
  968. package/dist/esm-es5/mds-pref-contrast.entry.js +8 -2
  969. package/dist/esm-es5/mds-pref-language-item.entry.js +3 -3
  970. package/dist/esm-es5/mds-pref-language.entry.js +1 -1
  971. package/dist/esm-es5/mds-pref-mode.entry.js +10 -2
  972. package/dist/esm-es5/mds-pref-theme-item.entry.js +3 -3
  973. package/dist/esm-es5/mds-pref-theme.entry.js +1 -1
  974. package/dist/esm-es5/mds-pref.entry.js +6 -3
  975. package/dist/esm-es5/mds-price-table-features-cell.entry.js +1 -1
  976. package/dist/esm-es5/mds-price-table-features-row.entry.js +1 -1
  977. package/dist/esm-es5/mds-price-table-features.entry.js +1 -1
  978. package/dist/esm-es5/mds-price-table-header.entry.js +1 -1
  979. package/dist/esm-es5/mds-price-table-list-item.entry.js +1 -1
  980. package/dist/esm-es5/mds-price-table-list.entry.js +1 -1
  981. package/dist/esm-es5/mds-price-table.entry.js +1 -1
  982. package/dist/esm-es5/mds-progress_2.entry.js +1 -1
  983. package/dist/esm-es5/mds-push-notification-item.entry.js +1 -1
  984. package/dist/esm-es5/mds-push-notification.entry.js +1 -1
  985. package/dist/esm-es5/mds-quote.entry.js +1 -1
  986. package/dist/esm-es5/mds-radial-menu-item.entry.js +1 -1
  987. package/dist/esm-es5/mds-radial-menu.entry.js +1 -1
  988. package/dist/esm-es5/mds-separator.entry.js +1 -1
  989. package/dist/esm-es5/mds-status-bar.entry.js +1 -1
  990. package/dist/esm-es5/mds-stepper-bar-item.entry.js +1 -1
  991. package/dist/esm-es5/mds-stepper-bar.entry.js +4 -4
  992. package/dist/esm-es5/mds-tab-bar-item.entry.js +3 -4
  993. package/dist/esm-es5/mds-tab-bar.entry.js +1 -1
  994. package/dist/esm-es5/mds-tab_2.entry.js +1 -1
  995. package/dist/esm-es5/mds-table-body.entry.js +1 -1
  996. package/dist/esm-es5/mds-table-footer.entry.js +1 -1
  997. package/dist/esm-es5/mds-table-header-cell.entry.js +2 -2
  998. package/dist/esm-es5/mds-table-header.entry.js +1 -1
  999. package/dist/esm-es5/mds-table-row.entry.js +1 -1
  1000. package/dist/esm-es5/mds-table.entry.js +1 -1
  1001. package/dist/esm-es5/mds-text.entry.js +2 -2
  1002. package/dist/esm-es5/mds-toast.entry.js +5 -3
  1003. package/dist/esm-es5/mds-tooltip.entry.js +3 -3
  1004. package/dist/esm-es5/mds-tree-item.entry.js +1 -1
  1005. package/dist/esm-es5/mds-tree.entry.js +1 -1
  1006. package/dist/esm-es5/mds-url-view.entry.js +1 -1
  1007. package/dist/esm-es5/mds-usage.entry.js +1 -1
  1008. package/dist/esm-es5/mds-video-wall.entry.js +1 -1
  1009. package/dist/esm-es5/mds-zero.entry.js +1 -1
  1010. package/dist/esm-es5/preference-DNNqH7BU.js +58 -0
  1011. package/dist/hydrate/index.js +1687 -459
  1012. package/dist/hydrate/index.mjs +1687 -459
  1013. package/dist/magma-components/index.esm.js +1 -1
  1014. package/dist/magma-components/magma-components.esm.js +1 -1
  1015. package/dist/magma-components/magma-components.js +1 -1
  1016. package/dist/magma-components/p-00e47e49.system.entry.js +14 -0
  1017. package/dist/magma-components/p-0141c597.system.entry.js +15 -0
  1018. package/dist/magma-components/p-021f96f8.entry.js +1 -0
  1019. package/dist/magma-components/p-0255924b.system.entry.js +22 -0
  1020. package/dist/magma-components/p-03c2060d.entry.js +1 -0
  1021. package/dist/magma-components/p-05014374.entry.js +1 -0
  1022. package/dist/magma-components/p-05f73994.entry.js +1 -0
  1023. package/dist/magma-components/p-0646392d.entry.js +1 -0
  1024. package/dist/magma-components/p-0a38e4ce.system.entry.js +1 -0
  1025. package/dist/magma-components/p-0a551e86.entry.js +1 -0
  1026. package/dist/magma-components/p-0a904a12.entry.js +1 -0
  1027. package/dist/magma-components/p-0a9fb138.system.entry.js +1 -0
  1028. package/dist/magma-components/p-106f39c6.entry.js +1 -0
  1029. package/dist/magma-components/p-10ad73e3.system.entry.js +19 -0
  1030. package/dist/magma-components/p-1150ffb8.system.entry.js +10 -0
  1031. package/dist/magma-components/p-12c5ae26.entry.js +1 -0
  1032. package/dist/magma-components/p-13a1d35f.entry.js +1 -0
  1033. package/dist/magma-components/p-15d4846d.entry.js +1 -0
  1034. package/dist/magma-components/p-1673225e.system.entry.js +8 -0
  1035. package/dist/magma-components/p-188f4b1d.system.entry.js +7 -0
  1036. package/dist/magma-components/p-18c8628c.entry.js +1 -0
  1037. package/dist/magma-components/p-1be45c75.entry.js +1 -0
  1038. package/dist/magma-components/p-1cb495d3.entry.js +1 -0
  1039. package/dist/magma-components/p-1e3d89cd.system.entry.js +1 -0
  1040. package/dist/magma-components/p-1e700f0a.entry.js +1 -0
  1041. package/dist/magma-components/p-20e4f7dd.system.entry.js +15 -0
  1042. package/dist/magma-components/p-21865dd2.entry.js +1 -0
  1043. package/dist/magma-components/p-218d8254.system.entry.js +1 -0
  1044. package/dist/magma-components/p-21c46e74.system.entry.js +4 -0
  1045. package/dist/magma-components/p-231b604f.system.entry.js +1 -0
  1046. package/dist/magma-components/p-2507f5cf.entry.js +1 -0
  1047. package/dist/magma-components/p-2723caa7.system.entry.js +13 -0
  1048. package/dist/magma-components/p-277444bc.entry.js +1 -0
  1049. package/dist/magma-components/p-283b0548.system.entry.js +102 -0
  1050. package/dist/magma-components/p-2c44c961.system.entry.js +10 -0
  1051. package/dist/magma-components/p-2ec0db8e.entry.js +1 -0
  1052. package/dist/magma-components/p-2f520704.entry.js +1 -0
  1053. package/dist/magma-components/p-30c3872d.entry.js +1 -0
  1054. package/dist/magma-components/p-314abfba.entry.js +1 -0
  1055. package/dist/magma-components/p-322a5452.entry.js +1 -0
  1056. package/dist/magma-components/p-3231a6a3.entry.js +1 -0
  1057. package/dist/magma-components/p-34401d35.entry.js +1 -0
  1058. package/dist/magma-components/p-35aa29c5.entry.js +1 -0
  1059. package/dist/magma-components/p-35ee2d77.entry.js +1 -0
  1060. package/dist/magma-components/p-36a67b51.entry.js +1 -0
  1061. package/dist/magma-components/p-3a1339bb.system.entry.js +4 -0
  1062. package/dist/magma-components/p-3d56e3f4.entry.js +1 -0
  1063. package/dist/magma-components/p-3e0eed90.system.entry.js +12 -0
  1064. package/dist/magma-components/p-3ecade3c.system.entry.js +11 -0
  1065. package/dist/magma-components/p-3eefca33.system.entry.js +16 -0
  1066. package/dist/magma-components/p-4211ce6c.system.entry.js +1 -0
  1067. package/dist/magma-components/p-436f9b27.system.entry.js +38 -0
  1068. package/dist/magma-components/p-439c9ce3.system.entry.js +10 -0
  1069. package/dist/magma-components/p-44e2a945.system.entry.js +1 -0
  1070. package/dist/magma-components/p-4658154f.entry.js +1 -0
  1071. package/dist/magma-components/p-474047fa.system.entry.js +10 -0
  1072. package/dist/magma-components/p-474c5d53.system.entry.js +11 -0
  1073. package/dist/magma-components/p-493fb2f4.system.entry.js +7 -0
  1074. package/dist/magma-components/p-4ac94b84.system.entry.js +32 -0
  1075. package/dist/magma-components/p-4c73f14b.system.entry.js +14 -0
  1076. package/dist/magma-components/p-4cb88b06.system.entry.js +1 -0
  1077. package/dist/magma-components/p-4dd6a39b.entry.js +1 -0
  1078. package/dist/magma-components/p-4e7f21ac.entry.js +1 -0
  1079. package/dist/magma-components/p-4f14a166.entry.js +1 -0
  1080. package/dist/magma-components/p-50ea11c9.system.entry.js +32 -0
  1081. package/dist/magma-components/p-514d0fcb.entry.js +1 -0
  1082. package/dist/magma-components/p-52793bdb.system.entry.js +1 -0
  1083. package/dist/magma-components/p-5299f709.system.entry.js +26 -0
  1084. package/dist/magma-components/p-57762bae.entry.js +1 -0
  1085. package/dist/magma-components/p-577db922.entry.js +1 -0
  1086. package/dist/magma-components/p-58b82b40.system.entry.js +10 -0
  1087. package/dist/magma-components/p-5a7267e8.system.entry.js +4 -0
  1088. package/dist/magma-components/p-5a911e7b.system.entry.js +13 -0
  1089. package/dist/magma-components/p-5ac9e2f4.entry.js +1 -0
  1090. package/dist/magma-components/p-5c94e0c2.system.entry.js +7 -0
  1091. package/dist/magma-components/p-5ccf493c.system.entry.js +7 -0
  1092. package/dist/magma-components/p-5d119459.entry.js +1 -0
  1093. package/dist/magma-components/p-5f1132b8.entry.js +1 -0
  1094. package/dist/magma-components/p-5fd04ce1.entry.js +1 -0
  1095. package/dist/magma-components/p-60f67c37.entry.js +1 -0
  1096. package/dist/magma-components/p-61bedbe7.system.entry.js +68 -0
  1097. package/dist/magma-components/p-632bc44c.entry.js +1 -0
  1098. package/dist/magma-components/p-64f78149.system.entry.js +1 -0
  1099. package/dist/magma-components/p-69c21eae.entry.js +1 -0
  1100. package/dist/magma-components/p-6a6326c6.entry.js +1 -0
  1101. package/dist/magma-components/p-6c18c40e.system.entry.js +89 -0
  1102. package/dist/magma-components/p-6c800411.entry.js +1 -0
  1103. package/dist/magma-components/p-6e03b83a.entry.js +1 -0
  1104. package/dist/magma-components/p-6ed05d99.entry.js +1 -0
  1105. package/dist/magma-components/p-6f74cdf5.system.entry.js +12 -0
  1106. package/dist/magma-components/p-6fdb3fe7.system.entry.js +27 -0
  1107. package/dist/magma-components/p-6ff8be3e.system.entry.js +30 -0
  1108. package/dist/magma-components/p-7-TP6wnI.js +1 -0
  1109. package/dist/magma-components/p-73fde271.system.entry.js +72 -0
  1110. package/dist/magma-components/p-74b51db8.entry.js +1 -0
  1111. package/dist/magma-components/p-76ecad2f.entry.js +18 -0
  1112. package/dist/magma-components/p-774ce1d2.entry.js +1 -0
  1113. package/dist/magma-components/p-77615947.system.entry.js +1 -0
  1114. package/dist/magma-components/p-7770b989.system.entry.js +1 -0
  1115. package/dist/magma-components/p-7787ebaf.system.entry.js +1 -0
  1116. package/dist/magma-components/p-789c1b93.system.entry.js +1 -0
  1117. package/dist/magma-components/p-7927010f.system.entry.js +25 -0
  1118. package/dist/magma-components/p-79421ee1.system.entry.js +11 -0
  1119. package/dist/magma-components/p-7ab15184.entry.js +1 -0
  1120. package/dist/magma-components/p-7afec7ee.entry.js +1 -0
  1121. package/dist/magma-components/p-7e085c82.entry.js +1 -0
  1122. package/dist/magma-components/p-7e7cf986.system.entry.js +7 -0
  1123. package/dist/magma-components/p-7ffda4f5.entry.js +1 -0
  1124. package/dist/magma-components/p-809adece.system.entry.js +17 -0
  1125. package/dist/magma-components/p-8183b7ed.entry.js +1 -0
  1126. package/dist/magma-components/p-832883c4.entry.js +1 -0
  1127. package/dist/magma-components/p-83394280.system.entry.js +32 -0
  1128. package/dist/magma-components/p-835fc007.entry.js +1 -0
  1129. package/dist/magma-components/p-837fbbf7.system.entry.js +1 -0
  1130. package/dist/magma-components/p-84645c60.system.entry.js +1 -0
  1131. package/dist/magma-components/p-86f4b6eb.system.entry.js +20 -0
  1132. package/dist/magma-components/p-87026d34.entry.js +1 -0
  1133. package/dist/magma-components/p-87faaa8e.system.entry.js +16 -0
  1134. package/dist/magma-components/p-88287207.system.entry.js +13 -0
  1135. package/dist/magma-components/p-883c223a.system.entry.js +4 -0
  1136. package/dist/magma-components/p-88f99a4f.system.entry.js +81 -0
  1137. package/dist/magma-components/p-8a3d2259.system.entry.js +17 -0
  1138. package/dist/magma-components/p-8aafbfdf.system.entry.js +49 -0
  1139. package/dist/magma-components/p-8afc9bc4.system.entry.js +2838 -0
  1140. package/dist/magma-components/p-8ca1d30d.system.entry.js +1 -0
  1141. package/dist/magma-components/p-8ccd187a.entry.js +1 -0
  1142. package/dist/magma-components/p-8d53bd61.system.entry.js +4 -0
  1143. package/dist/magma-components/p-8yWTOQiz.js +1 -0
  1144. package/dist/magma-components/p-90993b0b.system.entry.js +68 -0
  1145. package/dist/magma-components/p-915c5f06.system.entry.js +47 -0
  1146. package/dist/magma-components/p-91c4015f.system.entry.js +4 -0
  1147. package/dist/magma-components/p-91ff1560.system.entry.js +7 -0
  1148. package/dist/magma-components/p-92d9b537.entry.js +1 -0
  1149. package/dist/magma-components/p-932620b6.entry.js +1 -0
  1150. package/dist/magma-components/p-9344a234.entry.js +1 -0
  1151. package/dist/magma-components/p-93d39066.entry.js +1 -0
  1152. package/dist/magma-components/p-97f6166e.system.entry.js +28 -0
  1153. package/dist/magma-components/p-9d1cdb42.system.entry.js +15 -0
  1154. package/dist/magma-components/p-9dcfc247.entry.js +1 -0
  1155. package/dist/magma-components/p-9eb1e154.system.entry.js +14 -0
  1156. package/dist/magma-components/p-9fe14430.system.entry.js +7 -0
  1157. package/dist/magma-components/p-BPNsbMrg.system.js +67 -0
  1158. package/dist/magma-components/p-BS7eEvwu.system.js +17 -0
  1159. package/dist/magma-components/p-BTF_aRDG.system.js +231 -0
  1160. package/dist/magma-components/p-BpVYIPkx.js +1 -0
  1161. package/dist/magma-components/p-BxPbQB28.js +3 -0
  1162. package/dist/magma-components/p-CdsZyFQ-.system.js +10 -0
  1163. package/dist/magma-components/p-D7BrzK-C.system.js +90 -0
  1164. package/dist/magma-components/p-DaONbL_w.system.js +162 -0
  1165. package/dist/magma-components/p-Kv1yahtR.js +5 -0
  1166. package/dist/magma-components/p-ZDRIVCAt.system.js +5 -0
  1167. package/dist/magma-components/p-a41e52f7.entry.js +1 -0
  1168. package/dist/magma-components/p-a462aadd.entry.js +1 -0
  1169. package/dist/magma-components/p-a4a83a63.entry.js +1 -0
  1170. package/dist/magma-components/p-a64bbb36.system.entry.js +40 -0
  1171. package/dist/magma-components/p-a6af4083.system.entry.js +32 -0
  1172. package/dist/magma-components/p-a7e7f2c0.entry.js +1 -0
  1173. package/dist/magma-components/p-aba96089.entry.js +1 -0
  1174. package/dist/magma-components/p-ac81f63a.system.entry.js +913 -0
  1175. package/dist/magma-components/p-aed8b119.entry.js +1 -0
  1176. package/dist/magma-components/p-b24b5179.entry.js +1 -0
  1177. package/dist/magma-components/p-b295e4ab.system.entry.js +1 -0
  1178. package/dist/magma-components/p-b2c62b6e.system.entry.js +7 -0
  1179. package/dist/magma-components/p-b431ca8a.entry.js +1 -0
  1180. package/dist/magma-components/p-b5559b28.system.entry.js +1 -0
  1181. package/dist/magma-components/p-b626c69f.system.entry.js +1 -0
  1182. package/dist/magma-components/p-b897c97d.entry.js +1 -0
  1183. package/dist/magma-components/p-bab4c75e.system.entry.js +45 -0
  1184. package/dist/magma-components/p-bba04b08.system.entry.js +14 -0
  1185. package/dist/magma-components/p-bc53c19e.entry.js +8 -0
  1186. package/dist/magma-components/p-bf2fe278.system.entry.js +16 -0
  1187. package/dist/magma-components/p-c0136138.entry.js +1 -0
  1188. package/dist/magma-components/p-c166ec50.system.entry.js +47 -0
  1189. package/dist/magma-components/p-c22887f7.system.entry.js +90 -0
  1190. package/dist/magma-components/p-c28fce23.entry.js +1 -0
  1191. package/dist/magma-components/p-c34d9e61.system.entry.js +1 -0
  1192. package/dist/magma-components/p-c48bad95.entry.js +1 -0
  1193. package/dist/magma-components/p-cb2c5f1b.entry.js +1 -0
  1194. package/dist/magma-components/p-cc0c6ae7.entry.js +1 -0
  1195. package/dist/magma-components/p-cc2a09f2.system.entry.js +16 -0
  1196. package/dist/magma-components/p-cc9d9458.entry.js +1 -0
  1197. package/dist/magma-components/p-ccb14076.system.entry.js +217 -0
  1198. package/dist/magma-components/p-ccb6898a.system.entry.js +4 -0
  1199. package/dist/magma-components/p-d04ac65d.entry.js +1 -0
  1200. package/dist/magma-components/p-d07d227b.system.entry.js +8 -0
  1201. package/dist/magma-components/p-d1faf129.entry.js +1 -0
  1202. package/dist/magma-components/p-d282a929.entry.js +1 -0
  1203. package/dist/magma-components/p-d2f134ac.entry.js +1 -0
  1204. package/dist/magma-components/p-d47df503.system.entry.js +37 -0
  1205. package/dist/magma-components/p-d5bd6bef.entry.js +1 -0
  1206. package/dist/magma-components/p-d9804d2f.entry.js +1 -0
  1207. package/dist/magma-components/p-dc06b29e.entry.js +1 -0
  1208. package/dist/magma-components/p-dc59b764.entry.js +1 -0
  1209. package/dist/magma-components/p-dc7bada4.entry.js +1 -0
  1210. package/dist/magma-components/p-dcc3be64.system.entry.js +7 -0
  1211. package/dist/magma-components/p-dd58f9ee.entry.js +18 -0
  1212. package/dist/magma-components/p-de091be7.system.entry.js +7 -0
  1213. package/dist/magma-components/p-dfe8552c.system.entry.js +11 -0
  1214. package/dist/magma-components/p-e1e69217.system.entry.js +1 -0
  1215. package/dist/magma-components/p-e213640b.entry.js +1 -0
  1216. package/dist/magma-components/p-e2ef1d6f.entry.js +1 -0
  1217. package/dist/magma-components/p-e2ef5996.entry.js +1 -0
  1218. package/dist/magma-components/p-e7751639.entry.js +1 -0
  1219. package/dist/magma-components/p-e887a14c.entry.js +1 -0
  1220. package/dist/magma-components/p-e8cd2b93.system.entry.js +4 -0
  1221. package/dist/magma-components/p-e8ed096b.entry.js +1 -0
  1222. package/dist/magma-components/p-eaff7300.entry.js +1 -0
  1223. package/dist/magma-components/p-eb681207.system.entry.js +1 -0
  1224. package/dist/magma-components/p-ec9cc7b9.entry.js +1 -0
  1225. package/dist/magma-components/p-eca99a0a.system.entry.js +1 -0
  1226. package/dist/magma-components/p-ecd3c27f.entry.js +1 -0
  1227. package/dist/magma-components/p-ed897f9f.entry.js +1 -0
  1228. package/dist/magma-components/p-ee1e7f07.system.entry.js +3 -0
  1229. package/dist/magma-components/p-ef3424e3.entry.js +1 -0
  1230. package/dist/magma-components/p-f29a059d.system.entry.js +15 -0
  1231. package/dist/magma-components/p-f5bb8c0c.entry.js +1 -0
  1232. package/dist/magma-components/p-f654eafe.entry.js +1 -0
  1233. package/dist/magma-components/p-f733ae92.system.entry.js +16 -0
  1234. package/dist/magma-components/p-f8eb19b3.entry.js +1 -0
  1235. package/dist/magma-components/p-f8feee93.system.entry.js +4 -0
  1236. package/dist/magma-components/p-faa1f22c.entry.js +1 -0
  1237. package/dist/magma-components/p-ffa1a0b4.system.entry.js +1 -0
  1238. package/dist/magma-components/p-hVpoPUxI.system.js +58 -0
  1239. package/dist/magma-components/p-wI0alRSO.js +1 -0
  1240. package/dist/stats.json +3303 -2650
  1241. package/dist/types/common/form.d.ts +8 -1
  1242. package/dist/types/common/preference.d.ts +1 -1
  1243. package/dist/types/common/validity/index.d.ts +22 -0
  1244. package/dist/types/components/mds-avatar/mds-avatar.d.ts +2 -0
  1245. package/dist/types/components/mds-button/mds-button.d.ts +9 -0
  1246. package/dist/types/components/mds-button-dropdown/mds-button-dropdown.d.ts +23 -1
  1247. package/dist/types/components/mds-header/mds-header.d.ts +1 -0
  1248. package/dist/types/components/mds-icon/mds-icon.d.ts +5 -0
  1249. package/dist/types/components/mds-icon/services/icons-set.service.d.ts +10 -9
  1250. package/dist/types/components/mds-input/mds-input.d.ts +41 -2
  1251. package/dist/types/components/mds-input/meta/validators.d.ts +22 -0
  1252. package/dist/types/components/mds-input/meta/validity.d.ts +14 -0
  1253. package/dist/types/components/mds-input-date/mds-input-date.d.ts +38 -0
  1254. package/dist/types/components/mds-input-date-range/mds-input-date-range.d.ts +26 -0
  1255. package/dist/types/components/mds-input-otp/mds-input-otp.d.ts +21 -2
  1256. package/dist/types/components/mds-input-range/mds-input-range.d.ts +8 -1
  1257. package/dist/types/components/mds-input-select/mds-input-select.d.ts +42 -4
  1258. package/dist/types/components/mds-input-select/meta/event-detail.d.ts +8 -0
  1259. package/dist/types/components/mds-input-switch/mds-input-switch.d.ts +17 -0
  1260. package/dist/types/components/mds-input-upload/mds-input-upload.d.ts +27 -5
  1261. package/dist/types/components/mds-keyboard-key/meta/icons.d.ts +1 -1
  1262. package/dist/types/components/mds-pref-animation/mds-pref-animation.d.ts +10 -1
  1263. package/dist/types/components/mds-pref-consumption/mds-pref-consumption.d.ts +10 -1
  1264. package/dist/types/components/mds-pref-contrast/mds-pref-contrast.d.ts +10 -1
  1265. package/dist/types/components/mds-pref-mode/mds-pref-mode.d.ts +10 -1
  1266. package/dist/types/components/mds-toast/mds-toast.d.ts +1 -0
  1267. package/dist/types/components.d.ts +102 -19
  1268. package/package.json +33 -20
  1269. package/dist/cjs/floating-controller-Cd_vNLLD.js +0 -369
  1270. package/dist/cjs/form-DTCBh5WK.js +0 -22
  1271. package/dist/cjs/index--6wz7eWi.js +0 -5183
  1272. package/dist/cjs/locale-CB5_Z7PE.js +0 -816
  1273. package/dist/cjs/preference-eJcbLLAn.js +0 -389
  1274. package/dist/components/p--8aaJX-p.js +0 -1
  1275. package/dist/components/p-A9TZf0Ii.js +0 -1
  1276. package/dist/components/p-B2A_hlV2.js +0 -1
  1277. package/dist/components/p-B9DJLgwr.js +0 -1
  1278. package/dist/components/p-BH3bWzRT.js +0 -1
  1279. package/dist/components/p-BJNK4p33.js +0 -1
  1280. package/dist/components/p-BNHXZ-JR.js +0 -1
  1281. package/dist/components/p-BSxuG1vZ.js +0 -1
  1282. package/dist/components/p-BTHR4xXu.js +0 -1
  1283. package/dist/components/p-BhFTcUD0.js +0 -3
  1284. package/dist/components/p-BouRLCYL.js +0 -1
  1285. package/dist/components/p-Bss3F51Q.js +0 -5
  1286. package/dist/components/p-Bt4xX5ww.js +0 -1
  1287. package/dist/components/p-C03KYHGv.js +0 -1
  1288. package/dist/components/p-C58NKMEE.js +0 -1
  1289. package/dist/components/p-CBLAz3_J.js +0 -1
  1290. package/dist/components/p-CVgKDZPF.js +0 -1
  1291. package/dist/components/p-CVpjH8Un.js +0 -1
  1292. package/dist/components/p-Caksrfcd.js +0 -1
  1293. package/dist/components/p-CatD1iUY.js +0 -1
  1294. package/dist/components/p-CbufYCNj.js +0 -1
  1295. package/dist/components/p-Cehcn85x.js +0 -1
  1296. package/dist/components/p-ClKNADBg.js +0 -8
  1297. package/dist/components/p-CvIFS8oA.js +0 -1
  1298. package/dist/components/p-D3-GP4KF.js +0 -1
  1299. package/dist/components/p-D8I1RblC.js +0 -1
  1300. package/dist/components/p-DLE5TNTp.js +0 -1
  1301. package/dist/components/p-DaI5QqNu.js +0 -1
  1302. package/dist/components/p-Deh5Aia-.js +0 -1
  1303. package/dist/components/p-Dj_oN194.js +0 -1
  1304. package/dist/components/p-DmELzfvf.js +0 -1
  1305. package/dist/components/p-DtxB7DYE.js +0 -1
  1306. package/dist/components/p-cBZsPiMJ.js +0 -1
  1307. package/dist/components/p-sqRs6oj4.js +0 -1
  1308. package/dist/components/p-wq6nWuWE.js +0 -1
  1309. package/dist/esm/floating-controller-DVldZ5mh.js +0 -366
  1310. package/dist/esm/form-A9TZf0Ii.js +0 -19
  1311. package/dist/esm/index-DIiEV39g.js +0 -5149
  1312. package/dist/esm/locale-CbJbTW_c.js +0 -814
  1313. package/dist/esm/preference-CKerJx2M.js +0 -385
  1314. package/dist/esm-es5/floating-controller-DVldZ5mh.js +0 -66
  1315. package/dist/esm-es5/form-A9TZf0Ii.js +0 -8
  1316. package/dist/esm-es5/index-DIiEV39g.js +0 -371
  1317. package/dist/esm-es5/locale-CbJbTW_c.js +0 -230
  1318. package/dist/esm-es5/preference-CKerJx2M.js +0 -58
  1319. package/dist/magma-components/p-03be5c0c.entry.js +0 -1
  1320. package/dist/magma-components/p-0715a2cb.system.entry.js +0 -12
  1321. package/dist/magma-components/p-071f18c6.system.entry.js +0 -27
  1322. package/dist/magma-components/p-0798b0bf.system.entry.js +0 -24
  1323. package/dist/magma-components/p-07fde74d.system.entry.js +0 -39
  1324. package/dist/magma-components/p-086fb3aa.entry.js +0 -1
  1325. package/dist/magma-components/p-0a088e7d.system.entry.js +0 -10
  1326. package/dist/magma-components/p-0a691082.entry.js +0 -1
  1327. package/dist/magma-components/p-0ad3b4da.system.entry.js +0 -102
  1328. package/dist/magma-components/p-0af8d821.entry.js +0 -1
  1329. package/dist/magma-components/p-0ec21574.system.entry.js +0 -10
  1330. package/dist/magma-components/p-0f6bb54d.system.entry.js +0 -22
  1331. package/dist/magma-components/p-102d3bd3.system.entry.js +0 -1
  1332. package/dist/magma-components/p-10704ede.system.entry.js +0 -4
  1333. package/dist/magma-components/p-15f63bf3.entry.js +0 -1
  1334. package/dist/magma-components/p-16e9fb14.system.entry.js +0 -7
  1335. package/dist/magma-components/p-1780b8ba.entry.js +0 -1
  1336. package/dist/magma-components/p-181dfb04.entry.js +0 -1
  1337. package/dist/magma-components/p-184720be.system.entry.js +0 -1
  1338. package/dist/magma-components/p-18f7b970.system.entry.js +0 -4
  1339. package/dist/magma-components/p-1a8c5086.system.entry.js +0 -19
  1340. package/dist/magma-components/p-1afc0452.entry.js +0 -1
  1341. package/dist/magma-components/p-1c0a7e24.system.entry.js +0 -30
  1342. package/dist/magma-components/p-1cce738a.system.entry.js +0 -32
  1343. package/dist/magma-components/p-1dcfb13e.entry.js +0 -1
  1344. package/dist/magma-components/p-1df6ac96.system.entry.js +0 -7
  1345. package/dist/magma-components/p-209063b6.system.entry.js +0 -50
  1346. package/dist/magma-components/p-216f95cc.system.entry.js +0 -1
  1347. package/dist/magma-components/p-21891a24.entry.js +0 -1
  1348. package/dist/magma-components/p-21d6687a.system.entry.js +0 -7
  1349. package/dist/magma-components/p-231505e8.entry.js +0 -1
  1350. package/dist/magma-components/p-23e61db9.system.entry.js +0 -4
  1351. package/dist/magma-components/p-241dbf61.entry.js +0 -1
  1352. package/dist/magma-components/p-25935d33.system.entry.js +0 -1
  1353. package/dist/magma-components/p-27ea99ee.entry.js +0 -8
  1354. package/dist/magma-components/p-284c40cd.system.entry.js +0 -4
  1355. package/dist/magma-components/p-29684655.system.entry.js +0 -16
  1356. package/dist/magma-components/p-2b73fee6.entry.js +0 -1
  1357. package/dist/magma-components/p-2d5aadba.system.entry.js +0 -7
  1358. package/dist/magma-components/p-2de17848.entry.js +0 -1
  1359. package/dist/magma-components/p-34482514.entry.js +0 -1
  1360. package/dist/magma-components/p-34c0890e.entry.js +0 -1
  1361. package/dist/magma-components/p-3635eca6.system.entry.js +0 -1
  1362. package/dist/magma-components/p-3b0c1202.entry.js +0 -1
  1363. package/dist/magma-components/p-3d8e63a2.system.entry.js +0 -63
  1364. package/dist/magma-components/p-3db23b5f.system.entry.js +0 -16
  1365. package/dist/magma-components/p-3ec7d3ea.entry.js +0 -1
  1366. package/dist/magma-components/p-3f7d3060.system.entry.js +0 -42
  1367. package/dist/magma-components/p-40563e33.entry.js +0 -1
  1368. package/dist/magma-components/p-41bf6f25.system.entry.js +0 -81
  1369. package/dist/magma-components/p-421a630e.entry.js +0 -1
  1370. package/dist/magma-components/p-4297da23.system.entry.js +0 -1
  1371. package/dist/magma-components/p-4299b76b.system.entry.js +0 -4
  1372. package/dist/magma-components/p-4543501c.entry.js +0 -1
  1373. package/dist/magma-components/p-454c4774.entry.js +0 -1
  1374. package/dist/magma-components/p-4616bc07.entry.js +0 -1
  1375. package/dist/magma-components/p-46786d71.system.entry.js +0 -14
  1376. package/dist/magma-components/p-470e5ac8.system.entry.js +0 -1
  1377. package/dist/magma-components/p-481008e9.system.entry.js +0 -13
  1378. package/dist/magma-components/p-48d37230.entry.js +0 -1
  1379. package/dist/magma-components/p-4b3a8132.system.entry.js +0 -13
  1380. package/dist/magma-components/p-4c8316a8.entry.js +0 -1
  1381. package/dist/magma-components/p-4c95442e.entry.js +0 -1
  1382. package/dist/magma-components/p-4e4bdbf8.entry.js +0 -1
  1383. package/dist/magma-components/p-4e5ab0e4.system.entry.js +0 -16
  1384. package/dist/magma-components/p-4f107cb2.system.entry.js +0 -2838
  1385. package/dist/magma-components/p-54b995c2.system.entry.js +0 -4
  1386. package/dist/magma-components/p-56ad5bf2.entry.js +0 -1
  1387. package/dist/magma-components/p-59de81ac.entry.js +0 -1
  1388. package/dist/magma-components/p-5a7ead55.system.entry.js +0 -37
  1389. package/dist/magma-components/p-5e43274a.system.entry.js +0 -15
  1390. package/dist/magma-components/p-5f545f85.system.entry.js +0 -1
  1391. package/dist/magma-components/p-61a5ac3d.system.entry.js +0 -17
  1392. package/dist/magma-components/p-636cc471.entry.js +0 -1
  1393. package/dist/magma-components/p-66ce2dee.entry.js +0 -1
  1394. package/dist/magma-components/p-67d80d37.system.entry.js +0 -1
  1395. package/dist/magma-components/p-6937f340.entry.js +0 -1
  1396. package/dist/magma-components/p-69d1b815.entry.js +0 -1
  1397. package/dist/magma-components/p-6b7e449f.entry.js +0 -1
  1398. package/dist/magma-components/p-6c417ea1.system.entry.js +0 -913
  1399. package/dist/magma-components/p-6cd7cfe3.entry.js +0 -1
  1400. package/dist/magma-components/p-6ce60d59.entry.js +0 -1
  1401. package/dist/magma-components/p-6cf760ea.system.entry.js +0 -45
  1402. package/dist/magma-components/p-6dc27543.entry.js +0 -1
  1403. package/dist/magma-components/p-6de37588.entry.js +0 -1
  1404. package/dist/magma-components/p-6edc4f16.system.entry.js +0 -14
  1405. package/dist/magma-components/p-6f6b5eb5.entry.js +0 -1
  1406. package/dist/magma-components/p-7090184f.entry.js +0 -1
  1407. package/dist/magma-components/p-716ad14c.entry.js +0 -1
  1408. package/dist/magma-components/p-71804224.entry.js +0 -1
  1409. package/dist/magma-components/p-735dc594.system.entry.js +0 -1
  1410. package/dist/magma-components/p-739fdf76.system.entry.js +0 -1
  1411. package/dist/magma-components/p-74b0902a.entry.js +0 -1
  1412. package/dist/magma-components/p-7530a2f2.entry.js +0 -1
  1413. package/dist/magma-components/p-75dd012a.system.entry.js +0 -11
  1414. package/dist/magma-components/p-75fcf1a4.entry.js +0 -1
  1415. package/dist/magma-components/p-76ae22d6.entry.js +0 -1
  1416. package/dist/magma-components/p-78248693.entry.js +0 -1
  1417. package/dist/magma-components/p-78fef00a.entry.js +0 -1
  1418. package/dist/magma-components/p-7c0d202c.entry.js +0 -1
  1419. package/dist/magma-components/p-7fc29447.entry.js +0 -1
  1420. package/dist/magma-components/p-81b72b6e.entry.js +0 -1
  1421. package/dist/magma-components/p-859ab5a2.entry.js +0 -18
  1422. package/dist/magma-components/p-896ae0ee.entry.js +0 -1
  1423. package/dist/magma-components/p-89a3bc7a.system.entry.js +0 -16
  1424. package/dist/magma-components/p-8b7fa8d7.entry.js +0 -1
  1425. package/dist/magma-components/p-8c4fb7ec.system.entry.js +0 -30
  1426. package/dist/magma-components/p-8dff6606.system.entry.js +0 -11
  1427. package/dist/magma-components/p-8e40eda3.system.entry.js +0 -9
  1428. package/dist/magma-components/p-91b9d4e7.system.entry.js +0 -4
  1429. package/dist/magma-components/p-92e1001f.entry.js +0 -1
  1430. package/dist/magma-components/p-9378b373.system.entry.js +0 -49
  1431. package/dist/magma-components/p-960dc9b5.system.entry.js +0 -15
  1432. package/dist/magma-components/p-9626eaff.system.entry.js +0 -134
  1433. package/dist/magma-components/p-9741d95e.system.entry.js +0 -7
  1434. package/dist/magma-components/p-97ea9e6e.system.entry.js +0 -68
  1435. package/dist/magma-components/p-9846fe89.system.entry.js +0 -1
  1436. package/dist/magma-components/p-998721b9.system.entry.js +0 -1
  1437. package/dist/magma-components/p-9a5296c0.system.entry.js +0 -7
  1438. package/dist/magma-components/p-9b2ee3fe.entry.js +0 -1
  1439. package/dist/magma-components/p-9be4a736.entry.js +0 -1
  1440. package/dist/magma-components/p-9ca7932d.system.entry.js +0 -8
  1441. package/dist/magma-components/p-9d86477d.system.entry.js +0 -1
  1442. package/dist/magma-components/p-9e3bc553.system.entry.js +0 -26
  1443. package/dist/magma-components/p-9e58467e.system.entry.js +0 -10
  1444. package/dist/magma-components/p-9e9a1ebd.system.entry.js +0 -15
  1445. package/dist/magma-components/p-A9TZf0Ii.js +0 -1
  1446. package/dist/magma-components/p-BFnx_0hM.js +0 -5
  1447. package/dist/magma-components/p-BbMKuVem.js +0 -1
  1448. package/dist/magma-components/p-C2FHijr2.system.js +0 -231
  1449. package/dist/magma-components/p-CBam2PI8.system.js +0 -79
  1450. package/dist/magma-components/p-CDTiTqY0.system.js +0 -58
  1451. package/dist/magma-components/p-CI85vVs8.system.js +0 -9
  1452. package/dist/magma-components/p-CnXBPjmc.system.js +0 -5
  1453. package/dist/magma-components/p-DB8Rm54c.js +0 -1
  1454. package/dist/magma-components/p-DIiEV39g.js +0 -3
  1455. package/dist/magma-components/p-DmC-b-ZK.system.js +0 -67
  1456. package/dist/magma-components/p-MGv0i39Y.system.js +0 -162
  1457. package/dist/magma-components/p-a3279a73.system.entry.js +0 -11
  1458. package/dist/magma-components/p-a3b0f586.entry.js +0 -1
  1459. package/dist/magma-components/p-a3fc2ea4.system.entry.js +0 -39
  1460. package/dist/magma-components/p-a5ac5e0b.entry.js +0 -1
  1461. package/dist/magma-components/p-a8ec3080.system.entry.js +0 -27
  1462. package/dist/magma-components/p-a906a02f.system.entry.js +0 -16
  1463. package/dist/magma-components/p-a93b2a39.entry.js +0 -1
  1464. package/dist/magma-components/p-aa267e7b.entry.js +0 -1
  1465. package/dist/magma-components/p-ab9095ae.system.entry.js +0 -4
  1466. package/dist/magma-components/p-ac544ab1.entry.js +0 -1
  1467. package/dist/magma-components/p-ace198e9.entry.js +0 -1
  1468. package/dist/magma-components/p-ad3983b2.entry.js +0 -1
  1469. package/dist/magma-components/p-af41c8b8.system.entry.js +0 -1
  1470. package/dist/magma-components/p-af45f0a5.system.entry.js +0 -20
  1471. package/dist/magma-components/p-b23a6c83.entry.js +0 -1
  1472. package/dist/magma-components/p-b35c26f8.entry.js +0 -18
  1473. package/dist/magma-components/p-b3a3578c.entry.js +0 -1
  1474. package/dist/magma-components/p-b49e0321.system.entry.js +0 -1
  1475. package/dist/magma-components/p-b71e0d51.entry.js +0 -1
  1476. package/dist/magma-components/p-b8d4a14e.entry.js +0 -1
  1477. package/dist/magma-components/p-b9fecfd5.entry.js +0 -1
  1478. package/dist/magma-components/p-ba035f90.entry.js +0 -1
  1479. package/dist/magma-components/p-bc51d310.system.entry.js +0 -1
  1480. package/dist/magma-components/p-bd490a8e.entry.js +0 -1
  1481. package/dist/magma-components/p-be198039.system.entry.js +0 -4
  1482. package/dist/magma-components/p-be692266.system.entry.js +0 -13
  1483. package/dist/magma-components/p-bf7168b4.entry.js +0 -1
  1484. package/dist/magma-components/p-bf84d9fa.entry.js +0 -1
  1485. package/dist/magma-components/p-c1fb2eb7.entry.js +0 -1
  1486. package/dist/magma-components/p-c4e58240.entry.js +0 -1
  1487. package/dist/magma-components/p-c573de10.entry.js +0 -1
  1488. package/dist/magma-components/p-c6be3db7.system.entry.js +0 -1
  1489. package/dist/magma-components/p-c70d7159.entry.js +0 -1
  1490. package/dist/magma-components/p-c7517884.system.entry.js +0 -38
  1491. package/dist/magma-components/p-c9be79bd.entry.js +0 -1
  1492. package/dist/magma-components/p-c9e12c2b.system.entry.js +0 -7
  1493. package/dist/magma-components/p-cb6a1908.entry.js +0 -1
  1494. package/dist/magma-components/p-cbd5aef4.system.entry.js +0 -14
  1495. package/dist/magma-components/p-cd21137b.system.entry.js +0 -1
  1496. package/dist/magma-components/p-cd5866c8.entry.js +0 -1
  1497. package/dist/magma-components/p-ce0ecc75.system.entry.js +0 -15
  1498. package/dist/magma-components/p-ce4e1a41.system.entry.js +0 -1
  1499. package/dist/magma-components/p-d3116844.entry.js +0 -1
  1500. package/dist/magma-components/p-d38165ed.system.entry.js +0 -1
  1501. package/dist/magma-components/p-d3933a22.entry.js +0 -1
  1502. package/dist/magma-components/p-d44c49d6.system.entry.js +0 -8
  1503. package/dist/magma-components/p-d4a529ce.entry.js +0 -1
  1504. package/dist/magma-components/p-d6d4aa1a.entry.js +0 -1
  1505. package/dist/magma-components/p-d81e7100.system.entry.js +0 -15
  1506. package/dist/magma-components/p-d8c27f4b.entry.js +0 -1
  1507. package/dist/magma-components/p-d921d876.entry.js +0 -1
  1508. package/dist/magma-components/p-da1ac3e1.entry.js +0 -1
  1509. package/dist/magma-components/p-ddbdce09.entry.js +0 -1
  1510. package/dist/magma-components/p-de6bc3c8.entry.js +0 -1
  1511. package/dist/magma-components/p-df2b7607.system.entry.js +0 -4
  1512. package/dist/magma-components/p-e05d2df8.system.entry.js +0 -4
  1513. package/dist/magma-components/p-e0b2ef8f.system.entry.js +0 -1
  1514. package/dist/magma-components/p-e0c50a2d.entry.js +0 -1
  1515. package/dist/magma-components/p-e1277efe.system.entry.js +0 -1
  1516. package/dist/magma-components/p-e1e6dd97.entry.js +0 -1
  1517. package/dist/magma-components/p-e2f7a9bd.system.entry.js +0 -1
  1518. package/dist/magma-components/p-e3e893c4.entry.js +0 -1
  1519. package/dist/magma-components/p-e4868ade.entry.js +0 -1
  1520. package/dist/magma-components/p-e5c6f9a9.system.entry.js +0 -7
  1521. package/dist/magma-components/p-e5da7036.entry.js +0 -1
  1522. package/dist/magma-components/p-e6dccab5.system.entry.js +0 -1
  1523. package/dist/magma-components/p-ec59ec9a.entry.js +0 -1
  1524. package/dist/magma-components/p-eddcef53.system.entry.js +0 -1
  1525. package/dist/magma-components/p-eed00e7f.system.entry.js +0 -1
  1526. package/dist/magma-components/p-ef8cb401.entry.js +0 -1
  1527. package/dist/magma-components/p-efe8d359.entry.js +0 -1
  1528. package/dist/magma-components/p-f070a5b5.system.entry.js +0 -11
  1529. package/dist/magma-components/p-f0a168f4.system.entry.js +0 -13
  1530. package/dist/magma-components/p-f1462410.system.entry.js +0 -9
  1531. package/dist/magma-components/p-f23d4974.entry.js +0 -1
  1532. package/dist/magma-components/p-f542246f.system.entry.js +0 -1
  1533. package/dist/magma-components/p-f5c680dd.entry.js +0 -1
  1534. package/dist/magma-components/p-f60c6e8e.system.entry.js +0 -40
  1535. package/dist/magma-components/p-f8369939.entry.js +0 -1
  1536. package/dist/magma-components/p-f97ede3e.system.entry.js +0 -19
  1537. package/dist/magma-components/p-f97ff5b2.entry.js +0 -1
  1538. package/dist/magma-components/p-fe1662e8.system.entry.js +0 -28
  1539. package/dist/magma-components/p-ff133cbd.entry.js +0 -1
  1540. package/dist/magma-components/p-fff44704.entry.js +0 -1
@@ -0,0 +1,362 @@
1
+ {
2
+ "timestamp": "2026-10-10T11:47:46",
3
+ "compiler": {
4
+ "name": "@stencil/core",
5
+ "version": "4.44.2",
6
+ "typescriptVersion": "5.8.3"
7
+ },
8
+ "components": [
9
+ {
10
+ "filePath": "src/components/mds-avatar/mds-avatar.tsx",
11
+ "encapsulation": "shadow",
12
+ "tag": "mds-avatar",
13
+ "docs": "<!-- Start script-generated Magma Docs -->",
14
+ "docsTags": [
15
+ {
16
+ "name": "part",
17
+ "text": "icon - The selected icon of the avatar"
18
+ },
19
+ {
20
+ "name": "part",
21
+ "text": "wrapper - The wrapper which contains media displayed"
22
+ },
23
+ {
24
+ "name": "part",
25
+ "text": "media - The media displayed"
26
+ }
27
+ ],
28
+ "usage": {
29
+ "1. Description": "The `<mds-avatar>` web component renders a compact, circular representation of a user or entity in the Magma Design System. It resolves a single visual from whichever input is provided - a profile image, textual initials, a numeric overflow count, or an icon - and falls back to a generic person glyph when nothing usable is supplied.\n\n#### Semantic Behavior\n\n- **Content resolution**: Exactly one visual is shown at a time, so set one of `src`, `initials`, `count` or `icon`; the generic person fallback covers the empty case. Combinations do not follow one order: `count` hides `initials` and `icon`, `initials` hides `icon`, `icon` hides `src`, `src` hides `initials`, and `count` with `src` (or `src`, `initials` and `icon` together) renders an empty avatar.\n- **Deterministic identity color**: When `initials` is set, the component derives the color from its characters, so the same person always maps to the same color and stays distinguishable from others. Any explicit `variant` is ignored in this case; `count` derives no color and keeps the `variant`.\n- **Image load fallback**: If the `src` image fails to load, the avatar automatically swaps to the generic person fallback icon.\n- **Auto-fitting initials**: Initials and count text scale to fit the avatar, so they stay legible across every size.\n- **Initials display**: The first two characters of `initials` are displayed as they are, uppercased, so pass the initials (`MR`), not the full name. Non-alphanumeric characters are stripped only to compute the color.\n\n#### Properties & Visual Configurations\n\nThe shared `variant` / `tone` ladders are defined in [`agents/variants.md`](../../../../agents/variants.md). Note that `tone` is limited to the minimal set (`'strong'` / `'weak'`), and any explicit `variant` is ignored whenever `initials` is present, since identity color takes precedence.\n\n#### Other behavioral props\n\n- **`src`** is the path to a profile image; prefer it when a real photo is available. Setting `icon` or `count` as well hides it.\n- **`initials`** carries the textual stand-in for a user when no image exists; it drives the deterministic identity color.\n- **`count`** renders a `+N` overflow badge and is intended for stacked/grouped avatar scenarios rather than individual users.\n- **`icon`** is an SVG filename slug from the Magma icon library, used when the avatar represents a non-personal entity rather than a human.\n",
30
+ "2. Pattern": "Correct and idiomatic ways to use the `<mds-avatar>` component, ordered from most common to most specialized. Patterns assume a working knowledge of the variant / tone ladders documented in [`agents/variants.md`](../../../../agents/variants.md) and the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Profile Image via `src`\n\nThe most common form: supply a URL and the component loads the image lazily. If the image fails to load the component falls back to the generic person glyph automatically - no extra wiring needed.\n\n```html\n<mds-avatar src=\"https://example.com/foto-utente.jpg\"></mds-avatar>\n```\n\n#### Initials Fallback\n\nWhen no photo is available, provide the user's initials. The component displays the first two characters, uppercased, so pass the initials rather than the full name. It also derives a deterministic color from the characters (ignoring non-alphanumeric ones) so the same person always maps to the same hue.\n\n```html\n<mds-avatar initials=\"MR\"></mds-avatar>\n<!-- displayed as \"MR\" with a stable identity color -->\n\n<mds-avatar initials=\"ab\"></mds-avatar>\n<!-- displayed as \"AB\" -->\n```\n\n#### Manual Variant and Tone (no initials)\n\nWhen `initials` is not set, you can control the avatar background and icon color through `variant` and `tone`. Use this for non-personal entity avatars where identity color is not required.\n\n```html\n<!-- Primary brand color, filled -->\n<mds-avatar variant=\"primary\" tone=\"strong\" icon=\"mi/baseline/support-agent\"></mds-avatar>\n\n<!-- Success semantic, weak tint -->\n<mds-avatar variant=\"success\" tone=\"weak\"></mds-avatar>\n```\n\n#### Icon Avatar for Non-Personal Entities\n\nUse `icon` when the avatar represents a system, service, or non-human entity. Reference icons by their slug (no `.svg` extension). The generic person fallback is replaced by the provided icon.\n\n```html\n<mds-avatar icon=\"mi/baseline/business\" variant=\"primary\"></mds-avatar>\n<mds-avatar icon=\"mi/baseline/pets\" variant=\"info\"></mds-avatar>\n```\n\n#### Overflow Count in Stacked Groups\n\nUse `count` to render a \"+N\" overflow badge for the last slot in an avatar stack (e.g. \"3 more\"). The count display overrides `initials` and `icon` (with `src` set as well the avatar renders empty) and, unlike `initials`, derives no color: it keeps the `variant`. Use inside [`mds-avatar-stack`](../mds-avatar-stack/AGENTS.md) and [`mds-avatar-stack-item`](../mds-avatar-stack-item/AGENTS.md).\n\n```html\n<mds-avatar-stack>\n <mds-avatar-stack-item src=\"https://example.com/foto-01.jpg\"></mds-avatar-stack-item>\n <mds-avatar-stack-item src=\"https://example.com/foto-02.jpg\"></mds-avatar-stack-item>\n <mds-avatar-stack-item count=\"3\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Sizing via Utility Classes\n\n`<mds-avatar>` does not expose a `size` prop - its size is controlled by the host element's `width` (the component uses `aspect-ratio: 1/1` internally). Apply a Magma spacing utility class on the host.\n\n```html\n<!-- Small avatar -->\n<mds-avatar src=\"https://example.com/foto.jpg\" class=\"w-600\"></mds-avatar>\n\n<!-- Default / medium avatar -->\n<mds-avatar src=\"https://example.com/foto.jpg\" class=\"w-1200\"></mds-avatar>\n\n<!-- Large avatar -->\n<mds-avatar src=\"https://example.com/foto.jpg\" class=\"w-2400\"></mds-avatar>\n```\n\n#### Styling Customization\n\nStyle the avatar only through its documented `--mds-avatar-*` CSS custom properties. Use semantic color roles wrapped in `rgb(var(--magma-<role>))` so dark mode and high-contrast modes work correctly.\n\n```css\n.profilo-utente mds-avatar {\n --mds-avatar-background-color: rgb(var(--magma-accent-emphasis));\n --mds-avatar-color: rgb(var(--magma-accent-on-emphasis));\n --mds-avatar-radius: var(--magma-radius-md);\n --mds-avatar-initials-padding: 15%;\n}\n```\n\n#### Square Avatar via `--mds-avatar-radius`\n\nThe default shape is fully circular. Override the CSS custom property to get a square or rounded-square avatar - for example when representing a product or brand logo rather than a person.\n\n```css\n.logo-azienda mds-avatar {\n --mds-avatar-radius: var(--magma-radius-md);\n}\n```\n\n```html\n<mds-avatar\n class=\"logo-azienda w-1600\"\n src=\"https://example.com/logo-azienda.png\"\n></mds-avatar>\n```\n",
31
+ "3. Antipattern": "Common incorrect uses of `<mds-avatar>`. Each entry pairs the wrong form with the right one and a one-line reason. System-wide rules (boolean-as-string, shadow piercing, Tailwind color utilities, raw native event listening) live in [`agents/anti-patterns.md`](../../../../agents/anti-patterns.md) - they apply here too but are not repeated.\n\n#### Do Not Set `variant` When `initials` Is Present\n\nThe component derives the background color deterministically from the characters when `initials` is set, and silently overrides any explicit `variant`. Setting `variant` alongside these props is a no-op and misleads readers of the markup.\n\n```html\n<!-- INCORRECT -->\n<mds-avatar initials=\"MR\" variant=\"error\"></mds-avatar>\n\n<!-- CORRECT -->\n<mds-avatar initials=\"MR\"></mds-avatar>\n```\n\n#### Do Not Use `count` for Individual Users\n\n`count` is designed for overflow badges in stacked avatar groups (\"+3 more\"). Using it to represent a single user's identity (e.g. an ID number) produces a \"+N\" label, which is semantically wrong. Use `initials` for individual users.\n\n```html\n<!-- INCORRECT -->\n<mds-avatar count=\"42\"></mds-avatar>\n\n<!-- CORRECT - use initials for individual users -->\n<mds-avatar initials=\"GV\"></mds-avatar>\n```\n\n#### Do Not Override Size with Inline `width` / `height` Styles\n\n`<mds-avatar>` keeps a 1:1 aspect ratio internally. Forcing `width` or `height` via inline styles or arbitrary CSS bypasses the design token grid and can distort the shape. Use a Magma spacing utility class on the host element instead.\n\n```html\n<!-- INCORRECT -->\n<mds-avatar src=\"https://example.com/foto.jpg\" style=\"width: 73px; height: 73px;\"></mds-avatar>\n\n<!-- CORRECT -->\n<mds-avatar src=\"https://example.com/foto.jpg\" class=\"w-1600\"></mds-avatar>\n```\n\n#### Do Not Slot `<img>` to Supply a Profile Photo\n\n`<mds-avatar>` has no slots - it is a self-contained shadow component. Putting a raw `<img>` inside it will have no effect; the component will ignore it and show the fallback person glyph. Use the `src` prop instead.\n\n```html\n<!-- INCORRECT -->\n<mds-avatar>\n <img src=\"https://example.com/foto.jpg\" alt=\"Mario Bianchi\" />\n</mds-avatar>\n\n<!-- CORRECT -->\n<mds-avatar src=\"https://example.com/foto.jpg\"></mds-avatar>\n```\n\n#### Do Not Pierce Shadow DOM to Change Internal Colors\n\nThe supported customization surface is the five documented `--mds-avatar-*` CSS custom properties and, for a deep customisation, the documented parts `wrapper`, `media` and `icon`. Using undocumented part names, `>>>`, or internal class names to target internals couples your code to the Shadow DOM implementation and breaks on minor releases.\n\n```css\n/* INCORRECT */\nmds-avatar::part(initials) {\n background-color: hotpink;\n}\nmds-avatar >>> .initials-text {\n color: white;\n}\n\n/* CORRECT */\nmds-avatar {\n --mds-avatar-background-color: rgb(var(--magma-accent-emphasis));\n --mds-avatar-color: rgb(var(--magma-accent-on-emphasis));\n}\n```\n\n#### Do Not Use a Raw `<img>` or `<div>` as an Avatar\n\nWhen an avatar-style UI element is needed, reach for `<mds-avatar>` rather than hand-rolling a circular `<img>` or `<div>` with CSS. The component handles lazy loading, load errors, initials fallback, pending state, dark mode, and high-contrast mode automatically.\n\n```html\n<!-- INCORRECT -->\n<img\n src=\"https://example.com/foto.jpg\"\n alt=\"Foto di Luca\"\n style=\"border-radius: 50%; width: 48px; height: 48px;\"\n/>\n\n<!-- CORRECT -->\n<mds-avatar src=\"https://example.com/foto.jpg\" class=\"w-1200\"></mds-avatar>\n```\n"
32
+ },
33
+ "props": [
34
+ {
35
+ "name": "count",
36
+ "type": "number | undefined",
37
+ "complexType": {
38
+ "original": "number",
39
+ "resolved": "number | undefined",
40
+ "references": {}
41
+ },
42
+ "mutable": true,
43
+ "attr": "count",
44
+ "reflectToAttr": true,
45
+ "docs": "The user's inizials displayed if there's no image available, initials will override tone and variant senttings to keep user recognizable from others",
46
+ "docsTags": [],
47
+ "values": [
48
+ {
49
+ "type": "number"
50
+ },
51
+ {
52
+ "type": "undefined"
53
+ }
54
+ ],
55
+ "optional": true,
56
+ "required": false,
57
+ "getter": false,
58
+ "setter": false
59
+ },
60
+ {
61
+ "name": "icon",
62
+ "type": "string | undefined",
63
+ "complexType": {
64
+ "original": "string | undefined",
65
+ "resolved": "string | undefined",
66
+ "references": {}
67
+ },
68
+ "mutable": false,
69
+ "attr": "icon",
70
+ "reflectToAttr": true,
71
+ "docs": "Specifies the path to the icon",
72
+ "docsTags": [
73
+ {
74
+ "name": "see",
75
+ "text": "https://magma.maggiolicloud.it/storybook/?path=/story/design-icon--default"
76
+ }
77
+ ],
78
+ "values": [
79
+ {
80
+ "type": "string"
81
+ },
82
+ {
83
+ "type": "undefined"
84
+ }
85
+ ],
86
+ "optional": true,
87
+ "required": false,
88
+ "getter": false,
89
+ "setter": false
90
+ },
91
+ {
92
+ "name": "initials",
93
+ "type": "string | undefined",
94
+ "complexType": {
95
+ "original": "string",
96
+ "resolved": "string | undefined",
97
+ "references": {}
98
+ },
99
+ "mutable": true,
100
+ "attr": "initials",
101
+ "reflectToAttr": true,
102
+ "docs": "The user's inizials displayed if there's no image available, initials will override tone and variant senttings to keep user recognizable from others",
103
+ "docsTags": [],
104
+ "values": [
105
+ {
106
+ "type": "string"
107
+ },
108
+ {
109
+ "type": "undefined"
110
+ }
111
+ ],
112
+ "optional": true,
113
+ "required": false,
114
+ "getter": false,
115
+ "setter": false
116
+ },
117
+ {
118
+ "name": "src",
119
+ "type": "string | undefined",
120
+ "complexType": {
121
+ "original": "string",
122
+ "resolved": "string | undefined",
123
+ "references": {}
124
+ },
125
+ "mutable": false,
126
+ "attr": "src",
127
+ "reflectToAttr": true,
128
+ "docs": "Specifies the path to the image",
129
+ "docsTags": [],
130
+ "values": [
131
+ {
132
+ "type": "string"
133
+ },
134
+ {
135
+ "type": "undefined"
136
+ }
137
+ ],
138
+ "optional": true,
139
+ "required": false,
140
+ "getter": false,
141
+ "setter": false
142
+ },
143
+ {
144
+ "name": "tone",
145
+ "type": "\"strong\" | \"weak\" | undefined",
146
+ "complexType": {
147
+ "original": "ToneMinimalVariantType",
148
+ "resolved": "\"strong\" | \"weak\" | undefined",
149
+ "references": {
150
+ "ToneMinimalVariantType": {
151
+ "location": "import",
152
+ "path": "@type/tone",
153
+ "id": "src/type/tone.ts::ToneMinimalVariantType",
154
+ "referenceLocation": "ToneMinimalVariantType"
155
+ }
156
+ }
157
+ },
158
+ "mutable": false,
159
+ "attr": "tone",
160
+ "reflectToAttr": true,
161
+ "docs": "Specifies the color tone of the component",
162
+ "docsTags": [],
163
+ "values": [
164
+ {
165
+ "value": "strong",
166
+ "type": "string"
167
+ },
168
+ {
169
+ "value": "weak",
170
+ "type": "string"
171
+ },
172
+ {
173
+ "type": "undefined"
174
+ }
175
+ ],
176
+ "optional": true,
177
+ "required": false,
178
+ "getter": false,
179
+ "setter": false
180
+ },
181
+ {
182
+ "name": "variant",
183
+ "type": "\"amaranth\" | \"aqua\" | \"blue\" | \"error\" | \"green\" | \"info\" | \"lime\" | \"orange\" | \"orchid\" | \"primary\" | \"purple\" | \"red\" | \"sky\" | \"success\" | \"violet\" | \"warning\" | \"yellow\" | undefined",
184
+ "complexType": {
185
+ "original": "ThemeFullVariantAvatarType",
186
+ "resolved": "\"amaranth\" | \"aqua\" | \"blue\" | \"error\" | \"green\" | \"info\" | \"lime\" | \"orange\" | \"orchid\" | \"primary\" | \"purple\" | \"red\" | \"sky\" | \"success\" | \"violet\" | \"warning\" | \"yellow\" | undefined",
187
+ "references": {
188
+ "ThemeFullVariantAvatarType": {
189
+ "location": "import",
190
+ "path": "@type/variant",
191
+ "id": "src/type/variant.ts::ThemeFullVariantAvatarType",
192
+ "referenceLocation": "ThemeFullVariantAvatarType"
193
+ }
194
+ }
195
+ },
196
+ "mutable": true,
197
+ "attr": "variant",
198
+ "reflectToAttr": true,
199
+ "docs": "Specifies the color variant of the component",
200
+ "docsTags": [],
201
+ "values": [
202
+ {
203
+ "value": "amaranth",
204
+ "type": "string"
205
+ },
206
+ {
207
+ "value": "aqua",
208
+ "type": "string"
209
+ },
210
+ {
211
+ "value": "blue",
212
+ "type": "string"
213
+ },
214
+ {
215
+ "value": "error",
216
+ "type": "string"
217
+ },
218
+ {
219
+ "value": "green",
220
+ "type": "string"
221
+ },
222
+ {
223
+ "value": "info",
224
+ "type": "string"
225
+ },
226
+ {
227
+ "value": "lime",
228
+ "type": "string"
229
+ },
230
+ {
231
+ "value": "orange",
232
+ "type": "string"
233
+ },
234
+ {
235
+ "value": "orchid",
236
+ "type": "string"
237
+ },
238
+ {
239
+ "value": "primary",
240
+ "type": "string"
241
+ },
242
+ {
243
+ "value": "purple",
244
+ "type": "string"
245
+ },
246
+ {
247
+ "value": "red",
248
+ "type": "string"
249
+ },
250
+ {
251
+ "value": "sky",
252
+ "type": "string"
253
+ },
254
+ {
255
+ "value": "success",
256
+ "type": "string"
257
+ },
258
+ {
259
+ "value": "violet",
260
+ "type": "string"
261
+ },
262
+ {
263
+ "value": "warning",
264
+ "type": "string"
265
+ },
266
+ {
267
+ "value": "yellow",
268
+ "type": "string"
269
+ },
270
+ {
271
+ "type": "undefined"
272
+ }
273
+ ],
274
+ "optional": true,
275
+ "required": false,
276
+ "getter": false,
277
+ "setter": false
278
+ }
279
+ ],
280
+ "methods": [],
281
+ "events": [],
282
+ "listeners": [],
283
+ "styles": [
284
+ {
285
+ "name": "--mds-avatar-background-color",
286
+ "annotation": "prop",
287
+ "docs": "The background-color of the component"
288
+ },
289
+ {
290
+ "name": "--mds-avatar-background-color-pending",
291
+ "annotation": "prop",
292
+ "docs": "The background-color when an image is loading"
293
+ },
294
+ {
295
+ "name": "--mds-avatar-color",
296
+ "annotation": "prop",
297
+ "docs": "The color of the placeholder icon"
298
+ },
299
+ {
300
+ "name": "--mds-avatar-initials-padding",
301
+ "annotation": "prop",
302
+ "docs": "Sets the padding of the initials inside the avatar"
303
+ },
304
+ {
305
+ "name": "--mds-avatar-radius",
306
+ "annotation": "prop",
307
+ "docs": "The border-radius of the element"
308
+ }
309
+ ],
310
+ "slots": [],
311
+ "parts": [
312
+ {
313
+ "name": "icon",
314
+ "docs": "The selected icon of the avatar"
315
+ },
316
+ {
317
+ "name": "media",
318
+ "docs": "The media displayed"
319
+ },
320
+ {
321
+ "name": "wrapper",
322
+ "docs": "The wrapper which contains media displayed"
323
+ }
324
+ ],
325
+ "states": [],
326
+ "dependents": [
327
+ "mds-avatar-stack-item",
328
+ "mds-entity",
329
+ "mds-push-notification-item"
330
+ ],
331
+ "dependencies": [
332
+ "mds-img",
333
+ "mds-icon"
334
+ ],
335
+ "dependencyGraph": {
336
+ "mds-avatar": [
337
+ "mds-img",
338
+ "mds-icon"
339
+ ],
340
+ "mds-img": [
341
+ "mds-icon",
342
+ "mds-text",
343
+ "mds-button"
344
+ ],
345
+ "mds-button": [
346
+ "mds-spinner",
347
+ "mds-icon",
348
+ "mds-text"
349
+ ],
350
+ "mds-avatar-stack-item": [
351
+ "mds-avatar"
352
+ ],
353
+ "mds-entity": [
354
+ "mds-avatar"
355
+ ],
356
+ "mds-push-notification-item": [
357
+ "mds-avatar"
358
+ ]
359
+ }
360
+ }
361
+ ]
362
+ }
@@ -72,9 +72,25 @@ export class MdsAvatar {
72
72
  this.handleImgLoadSuccess = () => {
73
73
  this.loaded = true;
74
74
  };
75
+ // a removed attribute or a null bound by a framework counts as not set, like '' or 0
76
+ this.hasCount = () => {
77
+ var _a;
78
+ const count = (_a = this.count) !== null && _a !== void 0 ? _a : 0;
79
+ return count !== 0 && !Number.isNaN(count);
80
+ };
81
+ this.checkTexts = () => {
82
+ var _a;
83
+ const initials = (_a = this.initials) !== null && _a !== void 0 ? _a : '';
84
+ if (initials !== '')
85
+ this.checkText(initials);
86
+ if (this.hasCount())
87
+ this.checkText(String(this.count));
88
+ };
75
89
  this.checkInitialsVariant = () => {
76
- if (this.initials !== undefined && this.initials !== '') {
77
- let cleanedInitials = this.initials
90
+ var _a;
91
+ const initials = (_a = this.initials) !== null && _a !== void 0 ? _a : '';
92
+ if (initials !== '') {
93
+ let cleanedInitials = initials
78
94
  .toLowerCase()
79
95
  .replace(/[^a-zA-Z0-9]+/g, '')
80
96
  .substring(0, 2);
@@ -95,21 +111,13 @@ export class MdsAvatar {
95
111
  if (this.src !== undefined) {
96
112
  this.loaded = false;
97
113
  }
98
- if (this.initials !== undefined && this.initials !== '') {
99
- this.checkText(this.initials);
100
- }
101
- if (this.count !== undefined && this.count !== 0 && !Number.isNaN(this.count)) {
102
- this.checkText(this.count.toString());
103
- }
114
+ this.checkTexts();
104
115
  }
105
116
  componentDidRender() {
106
117
  if (this.textChanged) {
107
118
  // placed here becase @Watch('initials') is fired
108
119
  // BEFORE the element .fit is attached on shDOM
109
- if (this.initials !== undefined && this.initials !== '')
110
- this.checkText(this.initials);
111
- if (this.count !== undefined && this.count !== 0 && !Number.isNaN(this.count))
112
- this.checkText(this.count.toString());
120
+ this.checkTexts();
113
121
  this.textChanged = false;
114
122
  }
115
123
  }
@@ -132,26 +140,13 @@ export class MdsAvatar {
132
140
  }
133
141
  }
134
142
  render() {
135
- return (h(Host, { key: '09e30ddb558c31aa23749b4bf3d5190a30b605c7', "pref-animation": preferenceStore.state.animation, "pref-contrast": preferenceStore.state.contrast }, h("div", { key: '1d99eceedcc2dc604afcd887a2d767d61fced5e1', class: clsx('avatar', this.initials &&
136
- !this.fallback &&
137
- (this.src === undefined || this.src === '') &&
138
- 'avatar--initials', (this.fallback ||
139
- ((this.icon === undefined || this.icon === '') &&
140
- (this.initials === undefined || this.initials === '') &&
141
- (this.src === undefined || this.src === ''))) &&
142
- 'avatar--fallback', this.icon && 'avatar--icon', this.loaded ? 'avatar--loaded' : 'avatar--pending'), part: "wrapper" }, this.initials &&
143
- (this.count === undefined || this.count === 0 || Number.isNaN(this.count)) &&
144
- !this.fallback &&
145
- (this.src === undefined || this.src === '') && (h("div", { key: '08dd0918a258022793f5331a9de7b2460a2e1404', class: "initials-text" }, h("span", { key: '69379497bb9096cea56b366c52ba5372adb5506d', class: "fit" }, this.initials.substring(0, 2)))), this.count && !this.fallback && (this.src === undefined || this.src === '') && (h("div", { key: '07c1e94db40562b8a2467605591236433fd6af39', class: "initials-text" }, h("span", { key: '36c2b72540c03d140f97d64304d46583419d23df', class: "fit" }, "+", this.count))), this.src &&
146
- (this.count === undefined || this.count === 0 || Number.isNaN(this.count)) &&
147
- !this.fallback &&
148
- (this.icon === undefined || this.icon === '') && (h("mds-img", { key: '9d6a6d4a12a5142686aede6e9f9a974f592b674f', class: "image", loading: "lazy", onMdsImgLoadError: this.handleImgLoadError, onMdsImgLoadSuccess: this.handleImgLoadSuccess, part: "media", src: this.src })), this.icon &&
149
- (this.initials === undefined || this.initials === '') &&
150
- (this.count === undefined || this.count === 0 || Number.isNaN(this.count)) && (h("mds-icon", { key: 'b37eae32b77654190b14d8b046d2f9a51801ae2a', class: "icon", part: "icon", name: this.icon })), (this.fallback ||
151
- ((this.icon === undefined || this.icon === '') &&
152
- (this.initials === undefined || this.initials === '') &&
153
- (this.count === undefined || this.count === 0 || Number.isNaN(this.count)) &&
154
- (this.src === undefined || this.src === ''))) && (h("i", { key: '18d842d4aea1f73adef926ff74a896a9d8a52bc6', class: "fallback-icon", innerHTML: miBaselinePerson })))));
143
+ var _a, _b, _c, _d;
144
+ const hasCount = this.hasCount();
145
+ const icon = (_a = this.icon) !== null && _a !== void 0 ? _a : '';
146
+ const hasIcon = icon !== '';
147
+ const hasInitials = ((_b = this.initials) !== null && _b !== void 0 ? _b : '') !== '';
148
+ const hasSrc = ((_c = this.src) !== null && _c !== void 0 ? _c : '') !== '';
149
+ return (h(Host, { key: '87e19218bbfe6e9c79f5edd7b4dd0350572b4f84', "pref-animation": preferenceStore.state.animation, "pref-contrast": preferenceStore.state.contrast }, h("div", { key: 'b8775a55b682778312539df8ba0d8107075873e1', class: clsx('avatar', hasInitials && !this.fallback && !hasSrc && 'avatar--initials', (this.fallback || (!hasIcon && !hasInitials && !hasSrc)) && 'avatar--fallback', hasIcon && 'avatar--icon', this.loaded ? 'avatar--loaded' : 'avatar--pending'), part: "wrapper" }, hasInitials && !hasCount && !this.fallback && !hasSrc && (h("div", { key: 'acea5faae52d0cfaaa8f03788a22c89c8f0095ad', class: "initials-text" }, h("span", { key: 'aedd03f85b197fc6ed24b4a0238804856145aa4c', class: "fit" }, (_d = this.initials) === null || _d === void 0 ? void 0 : _d.substring(0, 2)))), hasCount && !this.fallback && !hasSrc && (h("div", { key: 'dd8af02204937c6558ab63b26d5993aa34e4df37', class: "initials-text" }, h("span", { key: 'fdf6930557054172bea785b8c6be0decb743887a', class: "fit" }, "+", this.count))), hasSrc && !hasCount && !this.fallback && !hasIcon && (h("mds-img", { key: '4519cc0bd3e701abf9d7bdaf0189f2ca3bcd86ed', class: "image", loading: "lazy", onMdsImgLoadError: this.handleImgLoadError, onMdsImgLoadSuccess: this.handleImgLoadSuccess, part: "media", src: this.src })), hasIcon && !hasInitials && !hasCount && (h("mds-icon", { key: '5958962b68d5797dd46f1322b0e12717bf70c93e', class: "icon", part: "icon", name: icon })), (this.fallback || (!hasIcon && !hasInitials && !hasCount && !hasSrc)) && (h("i", { key: 'e6509636da3e20d93144dde5f3ecce6f1cfc5506', class: "fallback-icon", innerHTML: miBaselinePerson })))));
155
150
  }
156
151
  static get is() { return "mds-avatar"; }
157
152
  static get encapsulation() { return "shadow"; }
@@ -0,0 +1,108 @@
1
+ <!--
2
+ GENERATED FILE - do not edit by hand.
3
+ Source of truth: src/components/mds-avatar/usage/ in the magma monorepo.
4
+ -->
5
+
6
+ # mds-avatar - patterns
7
+
8
+ > The API of this component: [`AGENTS.md`](AGENTS.md).
9
+
10
+ Correct and idiomatic ways to use the `<mds-avatar>` component, ordered from most common to most specialized. Patterns assume a working knowledge of the variant / tone ladders documented in [`agents/variants.md`](../../../../agents/variants.md) and the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).
11
+
12
+ #### Profile Image via `src`
13
+
14
+ The most common form: supply a URL and the component loads the image lazily. If the image fails to load the component falls back to the generic person glyph automatically - no extra wiring needed.
15
+
16
+ ```html
17
+ <mds-avatar src="https://example.com/foto-utente.jpg"></mds-avatar>
18
+ ```
19
+
20
+ #### Initials Fallback
21
+
22
+ When no photo is available, provide the user's initials. The component displays the first two characters, uppercased, so pass the initials rather than the full name. It also derives a deterministic color from the characters (ignoring non-alphanumeric ones) so the same person always maps to the same hue.
23
+
24
+ ```html
25
+ <mds-avatar initials="MR"></mds-avatar>
26
+ <!-- displayed as "MR" with a stable identity color -->
27
+
28
+ <mds-avatar initials="ab"></mds-avatar>
29
+ <!-- displayed as "AB" -->
30
+ ```
31
+
32
+ #### Manual Variant and Tone (no initials)
33
+
34
+ When `initials` is not set, you can control the avatar background and icon color through `variant` and `tone`. Use this for non-personal entity avatars where identity color is not required.
35
+
36
+ ```html
37
+ <!-- Primary brand color, filled -->
38
+ <mds-avatar variant="primary" tone="strong" icon="mi/baseline/support-agent"></mds-avatar>
39
+
40
+ <!-- Success semantic, weak tint -->
41
+ <mds-avatar variant="success" tone="weak"></mds-avatar>
42
+ ```
43
+
44
+ #### Icon Avatar for Non-Personal Entities
45
+
46
+ Use `icon` when the avatar represents a system, service, or non-human entity. Reference icons by their slug (no `.svg` extension). The generic person fallback is replaced by the provided icon.
47
+
48
+ ```html
49
+ <mds-avatar icon="mi/baseline/business" variant="primary"></mds-avatar>
50
+ <mds-avatar icon="mi/baseline/pets" variant="info"></mds-avatar>
51
+ ```
52
+
53
+ #### Overflow Count in Stacked Groups
54
+
55
+ Use `count` to render a "+N" overflow badge for the last slot in an avatar stack (e.g. "3 more"). The count display overrides `initials` and `icon` (with `src` set as well the avatar renders empty) and, unlike `initials`, derives no color: it keeps the `variant`. Use inside [`mds-avatar-stack`](../mds-avatar-stack/AGENTS.md) and [`mds-avatar-stack-item`](../mds-avatar-stack-item/AGENTS.md).
56
+
57
+ ```html
58
+ <mds-avatar-stack>
59
+ <mds-avatar-stack-item src="https://example.com/foto-01.jpg"></mds-avatar-stack-item>
60
+ <mds-avatar-stack-item src="https://example.com/foto-02.jpg"></mds-avatar-stack-item>
61
+ <mds-avatar-stack-item count="3"></mds-avatar-stack-item>
62
+ </mds-avatar-stack>
63
+ ```
64
+
65
+ #### Sizing via Utility Classes
66
+
67
+ `<mds-avatar>` does not expose a `size` prop - its size is controlled by the host element's `width` (the component uses `aspect-ratio: 1/1` internally). Apply a Magma spacing utility class on the host.
68
+
69
+ ```html
70
+ <!-- Small avatar -->
71
+ <mds-avatar src="https://example.com/foto.jpg" class="w-600"></mds-avatar>
72
+
73
+ <!-- Default / medium avatar -->
74
+ <mds-avatar src="https://example.com/foto.jpg" class="w-1200"></mds-avatar>
75
+
76
+ <!-- Large avatar -->
77
+ <mds-avatar src="https://example.com/foto.jpg" class="w-2400"></mds-avatar>
78
+ ```
79
+
80
+ #### Styling Customization
81
+
82
+ Style the avatar only through its documented `--mds-avatar-*` CSS custom properties. Use semantic color roles wrapped in `rgb(var(--magma-<role>))` so dark mode and high-contrast modes work correctly.
83
+
84
+ ```css
85
+ .profilo-utente mds-avatar {
86
+ --mds-avatar-background-color: rgb(var(--magma-accent-emphasis));
87
+ --mds-avatar-color: rgb(var(--magma-accent-on-emphasis));
88
+ --mds-avatar-radius: var(--magma-radius-md);
89
+ --mds-avatar-initials-padding: 15%;
90
+ }
91
+ ```
92
+
93
+ #### Square Avatar via `--mds-avatar-radius`
94
+
95
+ The default shape is fully circular. Override the CSS custom property to get a square or rounded-square avatar - for example when representing a product or brand logo rather than a person.
96
+
97
+ ```css
98
+ .logo-azienda mds-avatar {
99
+ --mds-avatar-radius: var(--magma-radius-md);
100
+ }
101
+ ```
102
+
103
+ ```html
104
+ <mds-avatar
105
+ class="logo-azienda w-1600"
106
+ src="https://example.com/logo-azienda.png"
107
+ ></mds-avatar>
108
+ ```
@@ -0,0 +1,65 @@
1
+ <!--
2
+ GENERATED FILE - do not edit by hand.
3
+ Source of truth: src/components/mds-avatar-stack/ in the magma monorepo (usage/*.md and the
4
+ component's JSDoc). Regenerated on every stencil build (scripts/component-docs.ts).
5
+ -->
6
+
7
+ # mds-avatar-stack
8
+
9
+ > `@maggioli-design-system/magma` 2.1.0. Shadow DOM: style it only through the CSS custom properties and parts below.
10
+
11
+ The `<mds-avatar-stack>` web component groups a set of overlapping `<mds-avatar-stack-item>` children into a single horizontal cluster, the Magma Design System pattern for showing the people associated with an entity (assignees, participants, collaborators) in a compact, space-saving row.
12
+
13
+ #### Semantic Behavior
14
+
15
+ - **Compound parent**: It is the container half of a compound component; its visible content is the default slot of `<mds-avatar-stack-item>` children, each of which wraps an `<mds-avatar>`.
16
+ - **Size propagation**: `size` drives the dimensions, border, and horizontal overlap of every slotted item, so the whole stack stays visually consistent without sizing each avatar individually.
17
+ - **Overflow counter**: When `total` is set and exceeds the number of slotted children, the stack appends one extra item rendering the remainder (e.g. "+3"), so it can represent a larger group than it physically shows.
18
+ - **Static composition**: Children are counted once, on load: the overflow indicator follows later changes of `total`, but not children added or removed afterwards.
19
+
20
+ #### Properties & Visual Configurations
21
+
22
+ - **`size`** selects the avatar scale (`'sm'`, `'md'`, `'lg'`) for the entire stack; pick it to match the surrounding density, since it governs not just avatar diameter but also the overlap offset and ring border between stacked avatars.
23
+ - **`total`** is the logical headcount of the represented group. Set it higher than the number of slotted avatars to surface a trailing count item for the hidden members; leave it unset (or equal to the child count) to show only the avatars in the markup with no counter.
24
+
25
+ This component does not use the shared `variant` / `tone` ladders; per-avatar appearance (tone, variant, initials, image source) is configured on each `<mds-avatar-stack-item>` instead.
26
+
27
+ ## Read next
28
+
29
+ - [`pattern.md`](pattern.md) - correct usage, with examples
30
+ - [`antipattern.md`](antipattern.md) - mistakes to avoid
31
+ - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`anti-patterns.md`](../../../../agents/anti-patterns.md) - the rules shared by every component
32
+
33
+ ## Props
34
+
35
+ | Prop | Attribute | Type | Default | Description |
36
+ | --- | --- | --- | --- | --- |
37
+ | `size` | `size` | `"lg" \| "md" \| "sm" \| undefined` | - | Specifies the size of the slotted avatars elements |
38
+ | `total` | `total` | `number \| undefined` | - | Specifies the size of the slotted avatars elements |
39
+
40
+ ## Slots
41
+
42
+ | Slot | Description |
43
+ | --- | --- |
44
+ | (default) | Add `mds-avatar-stack-item` elements to display in the stack. |
45
+
46
+ ## CSS custom properties
47
+
48
+ | Property | Description |
49
+ | --- | --- |
50
+ | `--mds-avatar-stack-background` | Background color for the avatar stack container |
51
+ | `--mds-avatar-stack-count-background-color` | Background color of the count indicator (e.g., "+3") |
52
+ | `--mds-avatar-stack-count-color` | Text color of the count indicator |
53
+ | `--mds-avatar-stack-lg-border` | Border width for large avatar stack items |
54
+ | `--mds-avatar-stack-lg-offset` | Horizontal overlap offset for large avatars |
55
+ | `--mds-avatar-stack-lg-size` | Size of large avatars in the stack |
56
+ | `--mds-avatar-stack-md-border` | Border width for medium avatar stack items |
57
+ | `--mds-avatar-stack-md-offset` | Horizontal overlap offset for medium avatars |
58
+ | `--mds-avatar-stack-md-size` | Size of medium avatars in the stack |
59
+ | `--mds-avatar-stack-sm-border` | Border width for small avatar stack items |
60
+ | `--mds-avatar-stack-sm-offset` | Horizontal overlap offset for small avatars |
61
+ | `--mds-avatar-stack-sm-size` | Size of small avatars in the stack |
62
+
63
+ ## Dependencies
64
+
65
+ Uses: `mds-avatar-stack-item`.