@maggioli-design-system/magma 2.2.0 → 2.4.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 (1705) hide show
  1. package/AGENTS.md +25 -10
  2. package/CHANGELOG.md +712 -0
  3. package/README.md +5 -2
  4. package/agents/anti-patterns.md +7 -4
  5. package/agents/assets.md +231 -28
  6. package/agents/color.md +7 -5
  7. package/agents/components.md +5 -4
  8. package/agents/conventions.md +16 -0
  9. package/agents/install.md +8 -4
  10. package/agents/reporting.md +11 -2
  11. package/agents/theming.md +15 -0
  12. package/dist/cjs/_commonjsHelpers-CFO10eej.js +7 -0
  13. package/dist/cjs/{aria-BbJUuU9_.js → aria-CzO5Rp1y.js} +23 -15
  14. package/dist/cjs/{floating-controller-uOCBLTk2.js → floating-controller-BxER7sig.js} +37 -14
  15. package/dist/cjs/{floating-ui.dom-DflSHZIo.js → floating-ui.dom-VQ_HnnRe.js} +146 -209
  16. package/dist/cjs/icon-BhokFNM7.js +22 -0
  17. package/dist/cjs/{index-MyEb-PfD.js → index-B5DKRaVO.js} +1 -1
  18. package/dist/cjs/{index-UmmmCMIG.js → index-B_qgSpWL.js} +125 -96
  19. package/dist/cjs/index.cjs.js +1 -1
  20. package/dist/cjs/keyboard-manager-BuCJdI8Q.js +75 -0
  21. package/dist/cjs/loader.cjs.js +2 -2
  22. package/dist/cjs/{locale-CnorkBwF.js → locale-D9XY8LN9.js} +1 -1
  23. package/dist/cjs/{locale.it-CfUV2hxK.js → locale.it-CQgfBg0W.js} +6 -1
  24. package/dist/cjs/{datetime-DHnUzK2K.js → luxon-8hyy5YD7.js} +164 -64
  25. package/dist/cjs/magma-components.cjs.js +3 -3
  26. package/dist/cjs/mds-accordion-item.cjs.entry.js +3 -3
  27. package/dist/cjs/mds-accordion-timer-item.cjs.entry.js +11 -10
  28. package/dist/cjs/mds-accordion-timer.cjs.entry.js +17 -3
  29. package/dist/cjs/mds-accordion.cjs.entry.js +37 -22
  30. package/dist/cjs/mds-author.cjs.entry.js +2 -2
  31. package/dist/cjs/mds-avatar-stack-item.cjs.entry.js +2 -2
  32. package/dist/cjs/mds-avatar-stack.cjs.entry.js +11 -5
  33. package/dist/cjs/mds-avatar.cjs.entry.js +58 -91
  34. package/dist/cjs/mds-badge.cjs.entry.js +4 -4
  35. package/dist/cjs/mds-banner_3.cjs.entry.js +51 -69
  36. package/dist/cjs/mds-benchmark-bar.cjs.entry.js +6 -3
  37. package/dist/cjs/mds-bibliography.cjs.entry.js +23 -17
  38. package/dist/cjs/mds-breadcrumb-item.cjs.entry.js +9 -5
  39. package/dist/cjs/mds-breadcrumb.cjs.entry.js +17 -33
  40. package/dist/cjs/mds-button-dropdown.cjs.entry.js +41 -4
  41. package/dist/cjs/mds-button-group.cjs.entry.js +2 -2
  42. package/dist/cjs/mds-button_3.cjs.entry.js +98 -67
  43. package/dist/cjs/mds-calendar_2.cjs.entry.js +125 -50
  44. package/dist/cjs/mds-card-content.cjs.entry.js +2 -2
  45. package/dist/cjs/mds-card-footer.cjs.entry.js +2 -2
  46. package/dist/cjs/mds-card-header.cjs.entry.js +3 -3
  47. package/dist/cjs/mds-card-media.cjs.entry.js +3 -3
  48. package/dist/cjs/mds-card.cjs.entry.js +25 -16
  49. package/dist/cjs/mds-details.cjs.entry.js +18 -8
  50. package/dist/cjs/mds-dropdown.cjs.entry.js +31 -15
  51. package/dist/cjs/mds-emoji.cjs.entry.js +192 -135
  52. package/dist/cjs/mds-entity.cjs.entry.js +4 -4
  53. package/dist/cjs/mds-file-preview.cjs.entry.js +30 -23
  54. package/dist/cjs/mds-file.cjs.entry.js +52 -7525
  55. package/dist/cjs/mds-filter-item.cjs.entry.js +81 -7
  56. package/dist/cjs/mds-filter.cjs.entry.js +120 -22
  57. package/dist/cjs/mds-header-bar.cjs.entry.js +38 -10
  58. package/dist/cjs/mds-header.cjs.entry.js +9 -11
  59. package/dist/cjs/mds-horizontal-scroll.cjs.entry.js +44 -13
  60. package/dist/cjs/mds-hr.cjs.entry.js +3 -3
  61. package/dist/cjs/mds-img.cjs.entry.js +39 -47
  62. package/dist/cjs/mds-input-date-range-preselection.cjs.entry.js +16 -8
  63. package/dist/cjs/mds-input-date-range.cjs.entry.js +44 -26
  64. package/dist/cjs/mds-input-date.cjs.entry.js +49 -14
  65. package/dist/cjs/mds-input-field.cjs.entry.js +3 -3
  66. package/dist/cjs/mds-input-otp.cjs.entry.js +57 -22
  67. package/dist/cjs/mds-input-range.cjs.entry.js +3 -3
  68. package/dist/cjs/mds-input-select.cjs.entry.js +36 -9
  69. package/dist/cjs/mds-input-switch_2.cjs.entry.js +27 -14
  70. package/dist/cjs/mds-input-tip_2.cjs.entry.js +8 -7
  71. package/dist/cjs/mds-input-upload.cjs.entry.js +1097 -15
  72. package/dist/cjs/mds-input.cjs.entry.js +17 -8
  73. package/dist/cjs/mds-keyboard-key.cjs.entry.js +4 -4
  74. package/dist/cjs/mds-keyboard.cjs.entry.js +15 -7
  75. package/dist/cjs/mds-kpi-item.cjs.entry.js +18 -4
  76. package/dist/cjs/mds-kpi.cjs.entry.js +1 -1
  77. package/dist/cjs/mds-label.cjs.entry.js +13 -30
  78. package/dist/cjs/mds-list-item.cjs.entry.js +3 -4
  79. package/dist/cjs/mds-list.cjs.entry.js +1 -1
  80. package/dist/cjs/mds-mention.cjs.entry.js +7 -6
  81. package/dist/cjs/mds-modal.cjs.entry.js +55 -11
  82. package/dist/cjs/mds-note.cjs.entry.js +18 -14
  83. package/dist/cjs/mds-notification.cjs.entry.js +72 -15
  84. package/dist/cjs/mds-paginator-item.cjs.entry.js +23 -11
  85. package/dist/cjs/mds-paginator.cjs.entry.js +39 -4
  86. package/dist/cjs/mds-policy-ai.cjs.entry.js +5 -5
  87. package/dist/cjs/mds-pref-animation.cjs.entry.js +42 -9
  88. package/dist/cjs/mds-pref-consumption.cjs.entry.js +42 -9
  89. package/dist/cjs/mds-pref-contrast.cjs.entry.js +45 -33
  90. package/dist/cjs/mds-pref-language-item.cjs.entry.js +8 -8
  91. package/dist/cjs/mds-pref-language.cjs.entry.js +44 -22
  92. package/dist/cjs/mds-pref-mode.cjs.entry.js +29 -25
  93. package/dist/cjs/mds-pref-theme-item.cjs.entry.js +6 -4
  94. package/dist/cjs/mds-pref-theme.cjs.entry.js +137 -32
  95. package/dist/cjs/mds-pref.cjs.entry.js +47 -59
  96. package/dist/cjs/mds-price-table-features-cell.cjs.entry.js +4 -4
  97. package/dist/cjs/mds-price-table-features-row.cjs.entry.js +4 -4
  98. package/dist/cjs/mds-price-table-features.cjs.entry.js +4 -4
  99. package/dist/cjs/mds-price-table-header.cjs.entry.js +2 -2
  100. package/dist/cjs/mds-price-table-list-item.cjs.entry.js +3 -3
  101. package/dist/cjs/mds-price-table-list.cjs.entry.js +14 -6
  102. package/dist/cjs/mds-price-table.cjs.entry.js +2 -2
  103. package/dist/cjs/mds-progress_2.cjs.entry.js +46 -33
  104. package/dist/cjs/mds-push-notification-item.cjs.entry.js +13 -10
  105. package/dist/cjs/mds-push-notification.cjs.entry.js +37 -14
  106. package/dist/cjs/mds-quote.cjs.entry.js +4 -4
  107. package/dist/cjs/mds-radial-menu-item.cjs.entry.js +3 -3
  108. package/dist/cjs/mds-radial-menu.cjs.entry.js +81 -36
  109. package/dist/cjs/mds-separator.cjs.entry.js +4 -4
  110. package/dist/cjs/mds-status-bar.cjs.entry.js +8 -9
  111. package/dist/cjs/mds-stepper-bar-item.cjs.entry.js +18 -6
  112. package/dist/cjs/mds-stepper-bar.cjs.entry.js +9 -18
  113. package/dist/cjs/mds-tab-bar-item.cjs.entry.js +25 -16
  114. package/dist/cjs/mds-tab-bar.cjs.entry.js +12 -6
  115. package/dist/cjs/mds-tab_2.cjs.entry.js +31 -12
  116. package/dist/cjs/mds-table-body.cjs.entry.js +4 -4
  117. package/dist/cjs/mds-table-footer.cjs.entry.js +13 -4
  118. package/dist/cjs/mds-table-header-cell.cjs.entry.js +118 -79
  119. package/dist/cjs/mds-table-header.cjs.entry.js +13 -5
  120. package/dist/cjs/mds-table-row.cjs.entry.js +35 -11
  121. package/dist/cjs/mds-table.cjs.entry.js +87 -23
  122. package/dist/cjs/mds-text.cjs.entry.js +39 -29
  123. package/dist/cjs/mds-toast-region.cjs.entry.js +119 -0
  124. package/dist/cjs/mds-toast.cjs.entry.js +163 -33
  125. package/dist/cjs/mds-tooltip.cjs.entry.js +84 -16
  126. package/dist/cjs/mds-tree-item.cjs.entry.js +24 -10
  127. package/dist/cjs/mds-tree.cjs.entry.js +37 -15
  128. package/dist/cjs/mds-url-view.cjs.entry.js +6 -6
  129. package/dist/cjs/mds-usage.cjs.entry.js +26 -7
  130. package/dist/cjs/mds-video-wall.cjs.entry.js +5 -4
  131. package/dist/cjs/mds-zero.cjs.entry.js +4 -4
  132. package/dist/cjs/{preference-DRkzNp5a.js → preference-C8BcoA3M.js} +1 -1
  133. package/dist/cjs/{slot-RmXfgH4P.js → slot-Dku0TdVg.js} +15 -0
  134. package/dist/cjs/string-RoXIuD3q.js +7 -0
  135. package/dist/collection/collection-manifest.json +2 -1
  136. package/dist/collection/common/aria.js +25 -1
  137. package/dist/collection/common/file.js +6 -1
  138. package/dist/collection/common/floating-controller.js +35 -12
  139. package/dist/collection/common/hash.js +15 -0
  140. package/dist/collection/common/icon.js +4 -1
  141. package/dist/collection/common/keyboard-manager.js +29 -6
  142. package/dist/collection/common/slot.js +15 -1
  143. package/dist/collection/common/string.js +3 -1
  144. package/dist/collection/common/yugop/random-text.js +5 -0
  145. package/dist/collection/components/mds-accordion/AGENTS.md +3 -2
  146. package/dist/collection/components/mds-accordion/antipattern.md +1 -1
  147. package/dist/collection/components/mds-accordion/documentation.json +9 -4
  148. package/dist/collection/components/mds-accordion/mds-accordion.css +6 -6
  149. package/dist/collection/components/mds-accordion/mds-accordion.js +34 -21
  150. package/dist/collection/components/mds-accordion-item/AGENTS.md +1 -1
  151. package/dist/collection/components/mds-accordion-item/antipattern.md +2 -2
  152. package/dist/collection/components/mds-accordion-item/documentation.json +3 -3
  153. package/dist/collection/components/mds-accordion-item/mds-accordion-item.css +16 -12
  154. package/dist/collection/components/mds-accordion-timer/AGENTS.md +2 -2
  155. package/dist/collection/components/mds-accordion-timer/documentation.json +3 -3
  156. package/dist/collection/components/mds-accordion-timer/mds-accordion-timer.css +2 -2
  157. package/dist/collection/components/mds-accordion-timer/mds-accordion-timer.js +15 -1
  158. package/dist/collection/components/mds-accordion-timer-item/AGENTS.md +4 -4
  159. package/dist/collection/components/mds-accordion-timer-item/documentation.json +4 -4
  160. package/dist/collection/components/mds-accordion-timer-item/mds-accordion-timer-item.css +11 -7
  161. package/dist/collection/components/mds-accordion-timer-item/mds-accordion-timer-item.js +9 -8
  162. package/dist/collection/components/mds-author/AGENTS.md +1 -1
  163. package/dist/collection/components/mds-author/documentation.json +3 -3
  164. package/dist/collection/components/mds-author/mds-author.css +2 -1
  165. package/dist/collection/components/mds-avatar/AGENTS.md +4 -4
  166. package/dist/collection/components/mds-avatar/documentation.json +5 -5
  167. package/dist/collection/components/mds-avatar/mds-avatar.css +33 -21
  168. package/dist/collection/components/mds-avatar/mds-avatar.js +56 -70
  169. package/dist/collection/components/mds-avatar/pattern.md +13 -2
  170. package/dist/collection/components/mds-avatar-stack/AGENTS.md +2 -2
  171. package/dist/collection/components/mds-avatar-stack/documentation.json +3 -3
  172. package/dist/collection/components/mds-avatar-stack/mds-avatar-stack.css +4 -4
  173. package/dist/collection/components/mds-avatar-stack/mds-avatar-stack.js +15 -2
  174. package/dist/collection/components/mds-avatar-stack-item/AGENTS.md +1 -1
  175. package/dist/collection/components/mds-avatar-stack-item/documentation.json +2 -2
  176. package/dist/collection/components/mds-avatar-stack-item/mds-avatar-stack-item.css +6 -6
  177. package/dist/collection/components/mds-badge/AGENTS.md +1 -1
  178. package/dist/collection/components/mds-badge/antipattern.md +0 -1
  179. package/dist/collection/components/mds-badge/documentation.json +4 -4
  180. package/dist/collection/components/mds-badge/mds-badge.css +17 -15
  181. package/dist/collection/components/mds-badge/pattern.md +0 -1
  182. package/dist/collection/components/mds-banner/AGENTS.md +1 -1
  183. package/dist/collection/components/mds-banner/documentation.json +2 -2
  184. package/dist/collection/components/mds-banner/mds-banner.css +63 -59
  185. package/dist/collection/components/mds-benchmark-bar/AGENTS.md +2 -2
  186. package/dist/collection/components/mds-benchmark-bar/antipattern.md +1 -1
  187. package/dist/collection/components/mds-benchmark-bar/documentation.json +5 -5
  188. package/dist/collection/components/mds-benchmark-bar/mds-benchmark-bar.js +4 -1
  189. package/dist/collection/components/mds-benchmark-bar/pattern.md +1 -1
  190. package/dist/collection/components/mds-bibliography/AGENTS.md +4 -4
  191. package/dist/collection/components/mds-bibliography/antipattern.md +1 -1
  192. package/dist/collection/components/mds-bibliography/documentation.json +17 -8
  193. package/dist/collection/components/mds-bibliography/mds-bibliography.css +11 -7
  194. package/dist/collection/components/mds-bibliography/mds-bibliography.js +29 -17
  195. package/dist/collection/components/mds-bibliography/pattern.md +2 -2
  196. package/dist/collection/components/mds-breadcrumb/AGENTS.md +8 -6
  197. package/dist/collection/components/mds-breadcrumb/antipattern.md +3 -3
  198. package/dist/collection/components/mds-breadcrumb/documentation.json +18 -8
  199. package/dist/collection/components/mds-breadcrumb/mds-breadcrumb.css +20 -9
  200. package/dist/collection/components/mds-breadcrumb/mds-breadcrumb.js +13 -29
  201. package/dist/collection/components/mds-breadcrumb/pattern.md +2 -5
  202. package/dist/collection/components/mds-breadcrumb-item/AGENTS.md +4 -4
  203. package/dist/collection/components/mds-breadcrumb-item/documentation.json +10 -5
  204. package/dist/collection/components/mds-breadcrumb-item/mds-breadcrumb-item.css +15 -14
  205. package/dist/collection/components/mds-breadcrumb-item/mds-breadcrumb-item.js +10 -3
  206. package/dist/collection/components/mds-button/AGENTS.md +11 -8
  207. package/dist/collection/components/mds-button/antipattern.md +1 -1
  208. package/dist/collection/components/mds-button/documentation.json +22 -9
  209. package/dist/collection/components/mds-button/mds-button.css +238 -423
  210. package/dist/collection/components/mds-button/mds-button.js +73 -39
  211. package/dist/collection/components/mds-button/pattern.md +13 -0
  212. package/dist/collection/components/mds-button-dropdown/AGENTS.md +10 -9
  213. package/dist/collection/components/mds-button-dropdown/antipattern.md +1 -1
  214. package/dist/collection/components/mds-button-dropdown/documentation.json +13 -9
  215. package/dist/collection/components/mds-button-dropdown/mds-button-dropdown.css +38 -17
  216. package/dist/collection/components/mds-button-dropdown/mds-button-dropdown.js +26 -5
  217. package/dist/collection/components/mds-button-dropdown/pattern.md +8 -1
  218. package/dist/collection/components/mds-button-group/AGENTS.md +1 -1
  219. package/dist/collection/components/mds-button-group/documentation.json +2 -2
  220. package/dist/collection/components/mds-button-group/mds-button-group.js +1 -1
  221. package/dist/collection/components/mds-calendar/AGENTS.md +5 -5
  222. package/dist/collection/components/mds-calendar/documentation.json +5 -5
  223. package/dist/collection/components/mds-calendar/mds-calendar.css +17 -9
  224. package/dist/collection/components/mds-calendar/mds-calendar.js +52 -19
  225. package/dist/collection/components/mds-calendar/pattern.md +4 -3
  226. package/dist/collection/components/mds-calendar-cell/AGENTS.md +8 -8
  227. package/dist/collection/components/mds-calendar-cell/antipattern.md +2 -1
  228. package/dist/collection/components/mds-calendar-cell/documentation.json +14 -10
  229. package/dist/collection/components/mds-calendar-cell/mds-calendar-cell.css +260 -109
  230. package/dist/collection/components/mds-calendar-cell/mds-calendar-cell.js +8 -3
  231. package/dist/collection/components/mds-calendar-cell/pattern.md +3 -1
  232. package/dist/collection/components/mds-card/AGENTS.md +5 -4
  233. package/dist/collection/components/mds-card/antipattern.md +1 -1
  234. package/dist/collection/components/mds-card/documentation.json +10 -5
  235. package/dist/collection/components/mds-card/mds-card.css +3 -2
  236. package/dist/collection/components/mds-card/mds-card.js +22 -13
  237. package/dist/collection/components/mds-card/pattern.md +4 -3
  238. package/dist/collection/components/mds-card-content/AGENTS.md +1 -1
  239. package/dist/collection/components/mds-card-content/documentation.json +2 -2
  240. package/dist/collection/components/mds-card-content/mds-card-content.js +1 -1
  241. package/dist/collection/components/mds-card-footer/AGENTS.md +1 -1
  242. package/dist/collection/components/mds-card-footer/documentation.json +2 -2
  243. package/dist/collection/components/mds-card-footer/mds-card-footer.js +1 -1
  244. package/dist/collection/components/mds-card-header/AGENTS.md +1 -1
  245. package/dist/collection/components/mds-card-header/documentation.json +2 -2
  246. package/dist/collection/components/mds-card-header/mds-card-header.js +1 -1
  247. package/dist/collection/components/mds-card-media/AGENTS.md +2 -2
  248. package/dist/collection/components/mds-card-media/documentation.json +7 -3
  249. package/dist/collection/components/mds-card-media/mds-card-media.js +2 -1
  250. package/dist/collection/components/mds-chip/AGENTS.md +3 -3
  251. package/dist/collection/components/mds-chip/documentation.json +6 -6
  252. package/dist/collection/components/mds-chip/mds-chip.css +98 -95
  253. package/dist/collection/components/mds-chip/mds-chip.js +40 -60
  254. package/dist/collection/components/mds-chip/pattern.md +1 -1
  255. package/dist/collection/components/mds-details/AGENTS.md +5 -4
  256. package/dist/collection/components/mds-details/documentation.json +6 -6
  257. package/dist/collection/components/mds-details/mds-details.css +20 -8
  258. package/dist/collection/components/mds-details/mds-details.js +14 -4
  259. package/dist/collection/components/mds-details/pattern.md +2 -2
  260. package/dist/collection/components/mds-dropdown/AGENTS.md +7 -7
  261. package/dist/collection/components/mds-dropdown/documentation.json +16 -11
  262. package/dist/collection/components/mds-dropdown/mds-dropdown.css +71 -38
  263. package/dist/collection/components/mds-dropdown/mds-dropdown.js +31 -12
  264. package/dist/collection/components/mds-dropdown/pattern.md +4 -2
  265. package/dist/collection/components/mds-emoji/AGENTS.md +12 -12
  266. package/dist/collection/components/mds-emoji/antipattern.md +1 -1
  267. package/dist/collection/components/mds-emoji/documentation.json +35 -65
  268. package/dist/collection/components/mds-emoji/mds-emoji.css +5 -5
  269. package/dist/collection/components/mds-emoji/mds-emoji.js +101 -77
  270. package/dist/collection/components/mds-emoji/meta/gaze.js +22 -0
  271. package/dist/collection/components/mds-entity/AGENTS.md +1 -1
  272. package/dist/collection/components/mds-entity/documentation.json +2 -2
  273. package/dist/collection/components/mds-entity/mds-entity.css +17 -12
  274. package/dist/collection/components/mds-file/AGENTS.md +6 -6
  275. package/dist/collection/components/mds-file/documentation.json +5 -5
  276. package/dist/collection/components/mds-file/mds-file.css +15 -15
  277. package/dist/collection/components/mds-file/mds-file.js +35 -11
  278. package/dist/collection/components/mds-file/pattern.md +1 -1
  279. package/dist/collection/components/mds-file-preview/AGENTS.md +5 -5
  280. package/dist/collection/components/mds-file-preview/antipattern.md +1 -1
  281. package/dist/collection/components/mds-file-preview/documentation.json +20 -10
  282. package/dist/collection/components/mds-file-preview/mds-file-preview.css +48 -22
  283. package/dist/collection/components/mds-file-preview/mds-file-preview.js +34 -21
  284. package/dist/collection/components/mds-file-preview/pattern.md +1 -1
  285. package/dist/collection/components/mds-filter/AGENTS.md +5 -3
  286. package/dist/collection/components/mds-filter/documentation.json +4 -4
  287. package/dist/collection/components/mds-filter/mds-filter.css +19 -19
  288. package/dist/collection/components/mds-filter/mds-filter.js +102 -20
  289. package/dist/collection/components/mds-filter/pattern.md +34 -4
  290. package/dist/collection/components/mds-filter-item/AGENTS.md +10 -9
  291. package/dist/collection/components/mds-filter-item/documentation.json +5 -5
  292. package/dist/collection/components/mds-filter-item/mds-filter-item.css +34 -21
  293. package/dist/collection/components/mds-filter-item/mds-filter-item.js +54 -4
  294. package/dist/collection/components/mds-filter-item/pattern.md +5 -5
  295. package/dist/collection/components/mds-header/AGENTS.md +5 -5
  296. package/dist/collection/components/mds-header/antipattern.md +2 -2
  297. package/dist/collection/components/mds-header/documentation.json +14 -9
  298. package/dist/collection/components/mds-header/mds-header.css +26 -16
  299. package/dist/collection/components/mds-header/mds-header.js +10 -9
  300. package/dist/collection/components/mds-header/pattern.md +1 -1
  301. package/dist/collection/components/mds-header-bar/AGENTS.md +6 -6
  302. package/dist/collection/components/mds-header-bar/documentation.json +14 -10
  303. package/dist/collection/components/mds-header-bar/mds-header-bar.css +15 -6
  304. package/dist/collection/components/mds-header-bar/mds-header-bar.js +22 -9
  305. package/dist/collection/components/mds-header-bar/pattern.md +2 -2
  306. package/dist/collection/components/mds-help/AGENTS.md +7 -7
  307. package/dist/collection/components/mds-help/documentation.json +12 -8
  308. package/dist/collection/components/mds-help/mds-help.css +23 -1
  309. package/dist/collection/components/mds-help/mds-help.js +8 -5
  310. package/dist/collection/components/mds-help/pattern.md +2 -2
  311. package/dist/collection/components/mds-horizontal-scroll/AGENTS.md +3 -3
  312. package/dist/collection/components/mds-horizontal-scroll/documentation.json +8 -4
  313. package/dist/collection/components/mds-horizontal-scroll/mds-horizontal-scroll.css +13 -13
  314. package/dist/collection/components/mds-horizontal-scroll/mds-horizontal-scroll.js +18 -11
  315. package/dist/collection/components/mds-hr/AGENTS.md +1 -1
  316. package/dist/collection/components/mds-hr/documentation.json +2 -2
  317. package/dist/collection/components/mds-hr/mds-hr.css +2 -2
  318. package/dist/collection/components/mds-icon/AGENTS.md +2 -2
  319. package/dist/collection/components/mds-icon/documentation.json +5 -5
  320. package/dist/collection/components/mds-icon/mds-icon.js +14 -3
  321. package/dist/collection/components/mds-icon/pattern.md +1 -1
  322. package/dist/collection/components/mds-img/AGENTS.md +9 -9
  323. package/dist/collection/components/mds-img/antipattern.md +1 -1
  324. package/dist/collection/components/mds-img/documentation.json +36 -34
  325. package/dist/collection/components/mds-img/mds-img.css +6 -6
  326. package/dist/collection/components/mds-img/mds-img.js +58 -56
  327. package/dist/collection/components/mds-input/AGENTS.md +17 -15
  328. package/dist/collection/components/mds-input/antipattern.md +1 -1
  329. package/dist/collection/components/mds-input/documentation.json +134 -25
  330. package/dist/collection/components/mds-input/mds-input.css +136 -65
  331. package/dist/collection/components/mds-input/mds-input.js +69 -9
  332. package/dist/collection/components/mds-input/pattern.md +15 -0
  333. package/dist/collection/components/mds-input-date/AGENTS.md +7 -4
  334. package/dist/collection/components/mds-input-date/antipattern.md +1 -1
  335. package/dist/collection/components/mds-input-date/documentation.json +72 -7
  336. package/dist/collection/components/mds-input-date/mds-input-date.css +53 -28
  337. package/dist/collection/components/mds-input-date/mds-input-date.js +61 -2
  338. package/dist/collection/components/mds-input-date-range/AGENTS.md +4 -2
  339. package/dist/collection/components/mds-input-date-range/documentation.json +67 -3
  340. package/dist/collection/components/mds-input-date-range/mds-input-date-range.css +51 -25
  341. package/dist/collection/components/mds-input-date-range/mds-input-date-range.js +50 -1
  342. package/dist/collection/components/mds-input-date-range-preselection/AGENTS.md +3 -3
  343. package/dist/collection/components/mds-input-date-range-preselection/antipattern.md +1 -1
  344. package/dist/collection/components/mds-input-date-range-preselection/documentation.json +26 -8
  345. package/dist/collection/components/mds-input-date-range-preselection/mds-input-date-range-preselection.css +18 -18
  346. package/dist/collection/components/mds-input-date-range-preselection/mds-input-date-range-preselection.js +31 -9
  347. package/dist/collection/components/mds-input-field/AGENTS.md +4 -4
  348. package/dist/collection/components/mds-input-field/documentation.json +10 -6
  349. package/dist/collection/components/mds-input-field/mds-input-field.css +8 -8
  350. package/dist/collection/components/mds-input-field/mds-input-field.js +5 -2
  351. package/dist/collection/components/mds-input-otp/AGENTS.md +5 -4
  352. package/dist/collection/components/mds-input-otp/antipattern.md +1 -1
  353. package/dist/collection/components/mds-input-otp/documentation.json +5 -5
  354. package/dist/collection/components/mds-input-otp/mds-input-otp.css +12 -0
  355. package/dist/collection/components/mds-input-otp/mds-input-otp.js +53 -18
  356. package/dist/collection/components/mds-input-otp/pattern.md +1 -1
  357. package/dist/collection/components/mds-input-range/AGENTS.md +1 -1
  358. package/dist/collection/components/mds-input-range/antipattern.md +1 -1
  359. package/dist/collection/components/mds-input-range/documentation.json +3 -3
  360. package/dist/collection/components/mds-input-range/mds-input-range.css +16 -15
  361. package/dist/collection/components/mds-input-select/AGENTS.md +7 -4
  362. package/dist/collection/components/mds-input-select/documentation.json +59 -8
  363. package/dist/collection/components/mds-input-select/mds-input-select.css +112 -31
  364. package/dist/collection/components/mds-input-select/mds-input-select.js +61 -7
  365. package/dist/collection/components/mds-input-select/pattern.md +3 -3
  366. package/dist/collection/components/mds-input-switch/AGENTS.md +2 -2
  367. package/dist/collection/components/mds-input-switch/antipattern.md +1 -1
  368. package/dist/collection/components/mds-input-switch/documentation.json +4 -4
  369. package/dist/collection/components/mds-input-switch/mds-input-switch.css +93 -71
  370. package/dist/collection/components/mds-input-switch/mds-input-switch.js +19 -6
  371. package/dist/collection/components/mds-input-tip/AGENTS.md +2 -2
  372. package/dist/collection/components/mds-input-tip/documentation.json +3 -3
  373. package/dist/collection/components/mds-input-tip/mds-input-tip.css +1 -1
  374. package/dist/collection/components/mds-input-tip/mds-input-tip.js +4 -3
  375. package/dist/collection/components/mds-input-tip-item/AGENTS.md +1 -1
  376. package/dist/collection/components/mds-input-tip-item/documentation.json +2 -2
  377. package/dist/collection/components/mds-input-tip-item/mds-input-tip-item.css +24 -21
  378. package/dist/collection/components/mds-input-tip-item/meta/dictionary.js +2 -8
  379. package/dist/collection/components/mds-input-upload/AGENTS.md +2 -2
  380. package/dist/collection/components/mds-input-upload/documentation.json +7 -3
  381. package/dist/collection/components/mds-input-upload/mds-input-upload.css +17 -15
  382. package/dist/collection/components/mds-input-upload/mds-input-upload.js +13 -8
  383. package/dist/collection/components/mds-keyboard/AGENTS.md +2 -2
  384. package/dist/collection/components/mds-keyboard/documentation.json +4 -4
  385. package/dist/collection/components/mds-keyboard/mds-keyboard.css +28 -16
  386. package/dist/collection/components/mds-keyboard/mds-keyboard.js +11 -3
  387. package/dist/collection/components/mds-keyboard/pattern.md +1 -1
  388. package/dist/collection/components/mds-keyboard-key/AGENTS.md +2 -2
  389. package/dist/collection/components/mds-keyboard-key/documentation.json +3 -3
  390. package/dist/collection/components/mds-keyboard-key/mds-keyboard-key.css +4 -3
  391. package/dist/collection/components/mds-kpi/AGENTS.md +1 -1
  392. package/dist/collection/components/mds-kpi/documentation.json +2 -2
  393. package/dist/collection/components/mds-kpi-item/AGENTS.md +2 -2
  394. package/dist/collection/components/mds-kpi-item/antipattern.md +1 -1
  395. package/dist/collection/components/mds-kpi-item/documentation.json +5 -5
  396. package/dist/collection/components/mds-kpi-item/mds-kpi-item.css +13 -13
  397. package/dist/collection/components/mds-kpi-item/mds-kpi-item.js +15 -1
  398. package/dist/collection/components/mds-kpi-item/pattern.md +2 -2
  399. package/dist/collection/components/mds-label/AGENTS.md +2 -2
  400. package/dist/collection/components/mds-label/documentation.json +3 -3
  401. package/dist/collection/components/mds-label/mds-label.css +18 -13
  402. package/dist/collection/components/mds-label/mds-label.js +2 -24
  403. package/dist/collection/components/mds-list/AGENTS.md +2 -2
  404. package/dist/collection/components/mds-list/documentation.json +3 -3
  405. package/dist/collection/components/mds-list-item/AGENTS.md +4 -3
  406. package/dist/collection/components/mds-list-item/documentation.json +14 -6
  407. package/dist/collection/components/mds-list-item/mds-list-item.css +0 -18
  408. package/dist/collection/components/mds-list-item/mds-list-item.js +3 -2
  409. package/dist/collection/components/mds-list-item/pattern.md +11 -0
  410. package/dist/collection/components/mds-mention/AGENTS.md +2 -2
  411. package/dist/collection/components/mds-mention/documentation.json +3 -3
  412. package/dist/collection/components/mds-mention/mds-mention.css +4 -13
  413. package/dist/collection/components/mds-mention/mds-mention.js +4 -3
  414. package/dist/collection/components/mds-modal/AGENTS.md +8 -7
  415. package/dist/collection/components/mds-modal/documentation.json +16 -7
  416. package/dist/collection/components/mds-modal/mds-modal.css +23 -14
  417. package/dist/collection/components/mds-modal/mds-modal.js +36 -7
  418. package/dist/collection/components/mds-modal/pattern.md +1 -1
  419. package/dist/collection/components/mds-note/AGENTS.md +2 -1
  420. package/dist/collection/components/mds-note/documentation.json +8 -3
  421. package/dist/collection/components/mds-note/mds-note.css +7 -15
  422. package/dist/collection/components/mds-note/mds-note.js +13 -9
  423. package/dist/collection/components/mds-note/pattern.md +1 -0
  424. package/dist/collection/components/mds-notification/AGENTS.md +5 -5
  425. package/dist/collection/components/mds-notification/documentation.json +11 -6
  426. package/dist/collection/components/mds-notification/mds-notification.css +13 -6
  427. package/dist/collection/components/mds-notification/mds-notification.js +78 -13
  428. package/dist/collection/components/mds-paginator/AGENTS.md +4 -3
  429. package/dist/collection/components/mds-paginator/antipattern.md +2 -1
  430. package/dist/collection/components/mds-paginator/documentation.json +6 -6
  431. package/dist/collection/components/mds-paginator/mds-paginator.css +8 -8
  432. package/dist/collection/components/mds-paginator/mds-paginator.js +12 -1
  433. package/dist/collection/components/mds-paginator/pattern.md +9 -1
  434. package/dist/collection/components/mds-paginator-item/AGENTS.md +4 -4
  435. package/dist/collection/components/mds-paginator-item/antipattern.md +2 -1
  436. package/dist/collection/components/mds-paginator-item/documentation.json +6 -6
  437. package/dist/collection/components/mds-paginator-item/mds-paginator-item.css +69 -71
  438. package/dist/collection/components/mds-paginator-item/mds-paginator-item.js +19 -7
  439. package/dist/collection/components/mds-paginator-item/pattern.md +3 -1
  440. package/dist/collection/components/mds-policy-ai/AGENTS.md +3 -2
  441. package/dist/collection/components/mds-policy-ai/documentation.json +13 -5
  442. package/dist/collection/components/mds-policy-ai/mds-policy-ai.css +21 -15
  443. package/dist/collection/components/mds-policy-ai/mds-policy-ai.js +3 -2
  444. package/dist/collection/components/mds-policy-ai/pattern.md +6 -1
  445. package/dist/collection/components/mds-pref/AGENTS.md +6 -6
  446. package/dist/collection/components/mds-pref/antipattern.md +1 -1
  447. package/dist/collection/components/mds-pref/documentation.json +20 -9
  448. package/dist/collection/components/mds-pref/mds-pref.js +61 -57
  449. package/dist/collection/components/mds-pref/pattern.md +5 -5
  450. package/dist/collection/components/mds-pref-animation/AGENTS.md +3 -3
  451. package/dist/collection/components/mds-pref-animation/antipattern.md +1 -1
  452. package/dist/collection/components/mds-pref-animation/documentation.json +5 -5
  453. package/dist/collection/components/mds-pref-animation/mds-pref-animation.css +7 -7
  454. package/dist/collection/components/mds-pref-animation/mds-pref-animation.js +38 -5
  455. package/dist/collection/components/mds-pref-animation/pattern.md +6 -6
  456. package/dist/collection/components/mds-pref-consumption/AGENTS.md +3 -3
  457. package/dist/collection/components/mds-pref-consumption/antipattern.md +1 -1
  458. package/dist/collection/components/mds-pref-consumption/documentation.json +5 -5
  459. package/dist/collection/components/mds-pref-consumption/mds-pref-consumption.css +4 -4
  460. package/dist/collection/components/mds-pref-consumption/mds-pref-consumption.js +38 -5
  461. package/dist/collection/components/mds-pref-consumption/pattern.md +5 -6
  462. package/dist/collection/components/mds-pref-contrast/AGENTS.md +3 -3
  463. package/dist/collection/components/mds-pref-contrast/antipattern.md +2 -2
  464. package/dist/collection/components/mds-pref-contrast/documentation.json +5 -5
  465. package/dist/collection/components/mds-pref-contrast/mds-pref-contrast.css +5 -5
  466. package/dist/collection/components/mds-pref-contrast/mds-pref-contrast.js +41 -29
  467. package/dist/collection/components/mds-pref-contrast/pattern.md +3 -3
  468. package/dist/collection/components/mds-pref-language/AGENTS.md +7 -7
  469. package/dist/collection/components/mds-pref-language/antipattern.md +2 -2
  470. package/dist/collection/components/mds-pref-language/documentation.json +17 -7
  471. package/dist/collection/components/mds-pref-language/mds-pref-language.css +10 -2
  472. package/dist/collection/components/mds-pref-language/mds-pref-language.js +54 -20
  473. package/dist/collection/components/mds-pref-language/pattern.md +3 -3
  474. package/dist/collection/components/mds-pref-language-item/AGENTS.md +2 -2
  475. package/dist/collection/components/mds-pref-language-item/antipattern.md +1 -1
  476. package/dist/collection/components/mds-pref-language-item/documentation.json +10 -5
  477. package/dist/collection/components/mds-pref-language-item/mds-pref-language-item.js +9 -6
  478. package/dist/collection/components/mds-pref-mode/AGENTS.md +13 -6
  479. package/dist/collection/components/mds-pref-mode/antipattern.md +4 -4
  480. package/dist/collection/components/mds-pref-mode/documentation.json +22 -6
  481. package/dist/collection/components/mds-pref-mode/mds-pref-mode.css +6 -6
  482. package/dist/collection/components/mds-pref-mode/mds-pref-mode.js +22 -23
  483. package/dist/collection/components/mds-pref-mode/pattern.md +5 -5
  484. package/dist/collection/components/mds-pref-theme/AGENTS.md +9 -7
  485. package/dist/collection/components/mds-pref-theme/antipattern.md +4 -4
  486. package/dist/collection/components/mds-pref-theme/documentation.json +17 -7
  487. package/dist/collection/components/mds-pref-theme/mds-pref-theme.css +10 -2
  488. package/dist/collection/components/mds-pref-theme/mds-pref-theme.js +149 -31
  489. package/dist/collection/components/mds-pref-theme/pattern.md +3 -3
  490. package/dist/collection/components/mds-pref-theme-item/AGENTS.md +2 -2
  491. package/dist/collection/components/mds-pref-theme-item/antipattern.md +1 -1
  492. package/dist/collection/components/mds-pref-theme-item/documentation.json +8 -4
  493. package/dist/collection/components/mds-pref-theme-item/mds-pref-theme-item.css +30 -12
  494. package/dist/collection/components/mds-pref-theme-item/mds-pref-theme-item.js +8 -3
  495. package/dist/collection/components/mds-price-table/AGENTS.md +1 -1
  496. package/dist/collection/components/mds-price-table/documentation.json +2 -2
  497. package/dist/collection/components/mds-price-table/mds-price-table.js +1 -1
  498. package/dist/collection/components/mds-price-table-features/AGENTS.md +3 -3
  499. package/dist/collection/components/mds-price-table-features/documentation.json +4 -4
  500. package/dist/collection/components/mds-price-table-features/mds-price-table-features.css +3 -3
  501. package/dist/collection/components/mds-price-table-features/mds-price-table-features.js +1 -1
  502. package/dist/collection/components/mds-price-table-features-cell/AGENTS.md +2 -2
  503. package/dist/collection/components/mds-price-table-features-cell/documentation.json +3 -3
  504. package/dist/collection/components/mds-price-table-features-cell/mds-price-table-features-cell.css +15 -12
  505. package/dist/collection/components/mds-price-table-features-cell/mds-price-table-features-cell.js +1 -1
  506. package/dist/collection/components/mds-price-table-features-row/AGENTS.md +1 -1
  507. package/dist/collection/components/mds-price-table-features-row/documentation.json +2 -2
  508. package/dist/collection/components/mds-price-table-features-row/mds-price-table-features-row.css +12 -12
  509. package/dist/collection/components/mds-price-table-features-row/mds-price-table-features-row.js +1 -1
  510. package/dist/collection/components/mds-price-table-header/AGENTS.md +1 -1
  511. package/dist/collection/components/mds-price-table-header/documentation.json +2 -2
  512. package/dist/collection/components/mds-price-table-header/mds-price-table-header.js +1 -1
  513. package/dist/collection/components/mds-price-table-list/AGENTS.md +3 -3
  514. package/dist/collection/components/mds-price-table-list/documentation.json +3 -3
  515. package/dist/collection/components/mds-price-table-list/mds-price-table-list.css +10 -9
  516. package/dist/collection/components/mds-price-table-list/mds-price-table-list.js +13 -3
  517. package/dist/collection/components/mds-price-table-list-item/AGENTS.md +3 -3
  518. package/dist/collection/components/mds-price-table-list-item/documentation.json +9 -5
  519. package/dist/collection/components/mds-price-table-list-item/mds-price-table-list-item.css +7 -3
  520. package/dist/collection/components/mds-price-table-list-item/mds-price-table-list-item.js +2 -1
  521. package/dist/collection/components/mds-price-table-list-item/pattern.md +1 -1
  522. package/dist/collection/components/mds-progress/AGENTS.md +3 -2
  523. package/dist/collection/components/mds-progress/documentation.json +4 -4
  524. package/dist/collection/components/mds-progress/mds-progress.css +22 -21
  525. package/dist/collection/components/mds-progress/mds-progress.js +42 -29
  526. package/dist/collection/components/mds-progress/pattern.md +1 -0
  527. package/dist/collection/components/mds-push-notification/AGENTS.md +4 -4
  528. package/dist/collection/components/mds-push-notification/documentation.json +4 -4
  529. package/dist/collection/components/mds-push-notification/mds-push-notification.js +19 -12
  530. package/dist/collection/components/mds-push-notification-item/AGENTS.md +4 -5
  531. package/dist/collection/components/mds-push-notification-item/documentation.json +18 -13
  532. package/dist/collection/components/mds-push-notification-item/mds-push-notification-item.css +20 -103
  533. package/dist/collection/components/mds-push-notification-item/mds-push-notification-item.js +17 -8
  534. package/dist/collection/components/mds-push-notification-item/pattern.md +2 -3
  535. package/dist/collection/components/mds-quote/AGENTS.md +1 -1
  536. package/dist/collection/components/mds-quote/documentation.json +2 -2
  537. package/dist/collection/components/mds-quote/mds-quote.css +6 -4
  538. package/dist/collection/components/mds-quote/mds-quote.js +1 -1
  539. package/dist/collection/components/mds-radial-menu/AGENTS.md +13 -12
  540. package/dist/collection/components/mds-radial-menu/antipattern.md +1 -1
  541. package/dist/collection/components/mds-radial-menu/documentation.json +19 -33
  542. package/dist/collection/components/mds-radial-menu/mds-radial-menu.css +29 -10
  543. package/dist/collection/components/mds-radial-menu/mds-radial-menu.js +57 -39
  544. package/dist/collection/components/mds-radial-menu/pattern.md +14 -1
  545. package/dist/collection/components/mds-radial-menu-item/AGENTS.md +1 -1
  546. package/dist/collection/components/mds-radial-menu-item/documentation.json +2 -2
  547. package/dist/collection/components/mds-radial-menu-item/mds-radial-menu-item.js +1 -1
  548. package/dist/collection/components/mds-radial-progress/AGENTS.md +11 -1
  549. package/dist/collection/components/mds-radial-progress/antipattern.md +8 -1
  550. package/dist/collection/components/mds-radial-progress/documentation.json +31 -5
  551. package/dist/collection/components/mds-radial-progress/mds-radial-progress.css +24 -16
  552. package/dist/collection/components/mds-radial-progress/mds-radial-progress.js +1 -1
  553. package/dist/collection/components/mds-radial-progress/pattern.md +13 -1
  554. package/dist/collection/components/mds-separator/AGENTS.md +1 -1
  555. package/dist/collection/components/mds-separator/documentation.json +2 -2
  556. package/dist/collection/components/mds-separator/mds-separator.css +3 -3
  557. package/dist/collection/components/mds-separator/mds-separator.js +1 -1
  558. package/dist/collection/components/mds-spinner/AGENTS.md +2 -2
  559. package/dist/collection/components/mds-spinner/documentation.json +4 -4
  560. package/dist/collection/components/mds-spinner/mds-spinner.css +67 -16
  561. package/dist/collection/components/mds-spinner/mds-spinner.js +1 -1
  562. package/dist/collection/components/mds-spinner/pattern.md +1 -1
  563. package/dist/collection/components/mds-status-bar/AGENTS.md +1 -1
  564. package/dist/collection/components/mds-status-bar/antipattern.md +1 -1
  565. package/dist/collection/components/mds-status-bar/documentation.json +4 -4
  566. package/dist/collection/components/mds-status-bar/mds-status-bar.css +14 -8
  567. package/dist/collection/components/mds-status-bar/mds-status-bar.js +5 -6
  568. package/dist/collection/components/mds-status-bar/pattern.md +1 -1
  569. package/dist/collection/components/mds-stepper-bar/AGENTS.md +5 -5
  570. package/dist/collection/components/mds-stepper-bar/documentation.json +8 -14
  571. package/dist/collection/components/mds-stepper-bar/mds-stepper-bar.css +6 -6
  572. package/dist/collection/components/mds-stepper-bar/mds-stepper-bar.js +9 -27
  573. package/dist/collection/components/mds-stepper-bar/pattern.md +1 -1
  574. package/dist/collection/components/mds-stepper-bar-item/AGENTS.md +4 -4
  575. package/dist/collection/components/mds-stepper-bar-item/documentation.json +6 -6
  576. package/dist/collection/components/mds-stepper-bar-item/mds-stepper-bar-item.css +37 -20
  577. package/dist/collection/components/mds-stepper-bar-item/mds-stepper-bar-item.js +15 -3
  578. package/dist/collection/components/mds-stepper-bar-item/pattern.md +1 -1
  579. package/dist/collection/components/mds-tab/AGENTS.md +4 -4
  580. package/dist/collection/components/mds-tab/documentation.json +5 -5
  581. package/dist/collection/components/mds-tab/mds-tab.css +55 -27
  582. package/dist/collection/components/mds-tab/mds-tab.js +25 -5
  583. package/dist/collection/components/mds-tab/pattern.md +9 -0
  584. package/dist/collection/components/mds-tab-bar/AGENTS.md +1 -1
  585. package/dist/collection/components/mds-tab-bar/antipattern.md +1 -1
  586. package/dist/collection/components/mds-tab-bar/documentation.json +3 -3
  587. package/dist/collection/components/mds-tab-bar/mds-tab-bar.css +1 -1
  588. package/dist/collection/components/mds-tab-bar/mds-tab-bar.js +9 -3
  589. package/dist/collection/components/mds-tab-bar-item/AGENTS.md +3 -3
  590. package/dist/collection/components/mds-tab-bar-item/antipattern.md +2 -2
  591. package/dist/collection/components/mds-tab-bar-item/documentation.json +5 -5
  592. package/dist/collection/components/mds-tab-bar-item/mds-tab-bar-item.css +36 -15
  593. package/dist/collection/components/mds-tab-bar-item/mds-tab-bar-item.js +22 -18
  594. package/dist/collection/components/mds-tab-bar-item/pattern.md +1 -1
  595. package/dist/collection/components/mds-tab-item/AGENTS.md +2 -2
  596. package/dist/collection/components/mds-tab-item/documentation.json +9 -4
  597. package/dist/collection/components/mds-tab-item/mds-tab-item.css +13 -3
  598. package/dist/collection/components/mds-tab-item/mds-tab-item.js +4 -1
  599. package/dist/collection/components/mds-table/AGENTS.md +12 -8
  600. package/dist/collection/components/mds-table/antipattern.md +1 -1
  601. package/dist/collection/components/mds-table/documentation.json +85 -10
  602. package/dist/collection/components/mds-table/mds-table.css +36 -26
  603. package/dist/collection/components/mds-table/mds-table.js +131 -21
  604. package/dist/collection/components/mds-table/pattern.md +34 -1
  605. package/dist/collection/components/mds-table-body/AGENTS.md +1 -1
  606. package/dist/collection/components/mds-table-body/documentation.json +2 -2
  607. package/dist/collection/components/mds-table-body/mds-table-body.css +13 -10
  608. package/dist/collection/components/mds-table-body/mds-table-body.js +1 -1
  609. package/dist/collection/components/mds-table-cell/AGENTS.md +5 -5
  610. package/dist/collection/components/mds-table-cell/antipattern.md +1 -1
  611. package/dist/collection/components/mds-table-cell/documentation.json +11 -7
  612. package/dist/collection/components/mds-table-cell/mds-table-cell.css +7 -11
  613. package/dist/collection/components/mds-table-cell/mds-table-cell.js +1 -1
  614. package/dist/collection/components/mds-table-cell/pattern.md +6 -0
  615. package/dist/collection/components/mds-table-footer/AGENTS.md +14 -4
  616. package/dist/collection/components/mds-table-footer/documentation.json +42 -9
  617. package/dist/collection/components/mds-table-footer/mds-table-footer.css +6 -1
  618. package/dist/collection/components/mds-table-footer/mds-table-footer.js +41 -2
  619. package/dist/collection/components/mds-table-footer/pattern.md +2 -1
  620. package/dist/collection/components/mds-table-header/AGENTS.md +4 -3
  621. package/dist/collection/components/mds-table-header/documentation.json +49 -6
  622. package/dist/collection/components/mds-table-header/mds-table-header.css +7 -0
  623. package/dist/collection/components/mds-table-header/mds-table-header.js +36 -2
  624. package/dist/collection/components/mds-table-header/pattern.md +1 -1
  625. package/dist/collection/components/mds-table-header-cell/AGENTS.md +16 -7
  626. package/dist/collection/components/mds-table-header-cell/antipattern.md +17 -10
  627. package/dist/collection/components/mds-table-header-cell/documentation.json +72 -10
  628. package/dist/collection/components/mds-table-header-cell/mds-table-header-cell.js +166 -82
  629. package/dist/collection/components/mds-table-header-cell/meta/event-detail.js +1 -0
  630. package/dist/collection/components/mds-table-header-cell/pattern.md +27 -6
  631. package/dist/collection/components/mds-table-row/AGENTS.md +3 -3
  632. package/dist/collection/components/mds-table-row/documentation.json +5 -5
  633. package/dist/collection/components/mds-table-row/mds-table-row.css +17 -16
  634. package/dist/collection/components/mds-table-row/mds-table-row.js +24 -5
  635. package/dist/collection/components/mds-table-row/pattern.md +1 -2
  636. package/dist/collection/components/mds-text/AGENTS.md +4 -4
  637. package/dist/collection/components/mds-text/documentation.json +3 -3
  638. package/dist/collection/components/mds-text/mds-text.css +89 -6
  639. package/dist/collection/components/mds-text/mds-text.js +31 -26
  640. package/dist/collection/components/mds-toast/AGENTS.md +13 -7
  641. package/dist/collection/components/mds-toast/antipattern.md +18 -0
  642. package/dist/collection/components/mds-toast/documentation.json +53 -13
  643. package/dist/collection/components/mds-toast/mds-toast.css +70 -21
  644. package/dist/collection/components/mds-toast/mds-toast.js +174 -35
  645. package/dist/collection/components/mds-toast/meta/event-detail.js +1 -0
  646. package/dist/collection/components/mds-toast/pattern.md +18 -4
  647. package/dist/collection/components/mds-toast-region/AGENTS.md +51 -0
  648. package/dist/collection/components/mds-toast-region/antipattern.md +62 -0
  649. package/dist/collection/components/mds-toast-region/documentation.json +136 -0
  650. package/dist/collection/components/mds-toast-region/mds-toast-region.css +31 -0
  651. package/dist/collection/components/mds-toast-region/mds-toast-region.js +177 -0
  652. package/dist/collection/components/mds-toast-region/pattern.md +82 -0
  653. package/dist/collection/components/mds-tooltip/AGENTS.md +9 -7
  654. package/dist/collection/components/mds-tooltip/antipattern.md +14 -0
  655. package/dist/collection/components/mds-tooltip/documentation.json +61 -11
  656. package/dist/collection/components/mds-tooltip/mds-tooltip.css +47 -12
  657. package/dist/collection/components/mds-tooltip/mds-tooltip.js +113 -14
  658. package/dist/collection/components/mds-tooltip/pattern.md +11 -2
  659. package/dist/collection/components/mds-tree/AGENTS.md +6 -5
  660. package/dist/collection/components/mds-tree/documentation.json +13 -7
  661. package/dist/collection/components/mds-tree/mds-tree.css +18 -17
  662. package/dist/collection/components/mds-tree/mds-tree.js +41 -16
  663. package/dist/collection/components/mds-tree/pattern.md +5 -1
  664. package/dist/collection/components/mds-tree-item/AGENTS.md +7 -7
  665. package/dist/collection/components/mds-tree-item/documentation.json +7 -7
  666. package/dist/collection/components/mds-tree-item/mds-tree-item.css +47 -15
  667. package/dist/collection/components/mds-tree-item/mds-tree-item.js +22 -8
  668. package/dist/collection/components/mds-tree-item/pattern.md +2 -1
  669. package/dist/collection/components/mds-url-view/AGENTS.md +2 -2
  670. package/dist/collection/components/mds-url-view/documentation.json +3 -3
  671. package/dist/collection/components/mds-url-view/mds-url-view.css +10 -9
  672. package/dist/collection/components/mds-url-view/mds-url-view.js +2 -2
  673. package/dist/collection/components/mds-usage/AGENTS.md +15 -11
  674. package/dist/collection/components/mds-usage/antipattern.md +17 -1
  675. package/dist/collection/components/mds-usage/documentation.json +48 -10
  676. package/dist/collection/components/mds-usage/mds-usage.css +11 -9
  677. package/dist/collection/components/mds-usage/mds-usage.js +30 -5
  678. package/dist/collection/components/mds-usage/meta/variants.js +14 -18
  679. package/dist/collection/components/mds-usage/pattern.md +13 -3
  680. package/dist/collection/components/mds-video-wall/AGENTS.md +2 -2
  681. package/dist/collection/components/mds-video-wall/documentation.json +3 -3
  682. package/dist/collection/components/mds-video-wall/mds-video-wall.css +13 -8
  683. package/dist/collection/components/mds-video-wall/mds-video-wall.js +2 -1
  684. package/dist/collection/components/mds-zero/AGENTS.md +1 -1
  685. package/dist/collection/components/mds-zero/documentation.json +2 -2
  686. package/dist/collection/components/mds-zero/mds-zero.css +5 -4
  687. package/dist/collection/components/mds-zero/mds-zero.js +1 -1
  688. package/dist/collection/type/floating-ui.js +1 -0
  689. package/dist/collection/type/input.js +2 -0
  690. package/dist/components/index.d.ts +2 -0
  691. package/dist/components/index.js +1 -1
  692. package/dist/components/mds-accordion-item.js +1 -1
  693. package/dist/components/mds-accordion-timer-item.js +1 -1
  694. package/dist/components/mds-accordion-timer.js +1 -1
  695. package/dist/components/mds-accordion.js +1 -1
  696. package/dist/components/mds-author.js +1 -1
  697. package/dist/components/mds-avatar-stack-item.js +1 -1
  698. package/dist/components/mds-avatar-stack.js +1 -1
  699. package/dist/components/mds-avatar.js +1 -1
  700. package/dist/components/mds-badge.js +1 -1
  701. package/dist/components/mds-banner.js +1 -1
  702. package/dist/components/mds-benchmark-bar.js +1 -1
  703. package/dist/components/mds-bibliography.js +1 -1
  704. package/dist/components/mds-breadcrumb-item.js +1 -1
  705. package/dist/components/mds-breadcrumb.js +1 -1
  706. package/dist/components/mds-button-dropdown.js +1 -1
  707. package/dist/components/mds-button-group.js +1 -1
  708. package/dist/components/mds-button.js +1 -1
  709. package/dist/components/mds-calendar-cell.js +1 -1
  710. package/dist/components/mds-calendar.js +1 -1
  711. package/dist/components/mds-card-content.js +1 -1
  712. package/dist/components/mds-card-footer.js +1 -1
  713. package/dist/components/mds-card-header.js +1 -1
  714. package/dist/components/mds-card-media.js +1 -1
  715. package/dist/components/mds-card.js +1 -1
  716. package/dist/components/mds-chip.js +1 -1
  717. package/dist/components/mds-details.js +1 -1
  718. package/dist/components/mds-dropdown.js +1 -1
  719. package/dist/components/mds-emoji.js +7 -7
  720. package/dist/components/mds-entity.js +1 -1
  721. package/dist/components/mds-file-preview.js +1 -1
  722. package/dist/components/mds-file.js +1 -18
  723. package/dist/components/mds-filter-item.js +1 -1
  724. package/dist/components/mds-filter.js +1 -1
  725. package/dist/components/mds-header-bar.js +1 -1
  726. package/dist/components/mds-header.js +1 -1
  727. package/dist/components/mds-help.js +1 -1
  728. package/dist/components/mds-horizontal-scroll.js +1 -1
  729. package/dist/components/mds-hr.js +1 -1
  730. package/dist/components/mds-icon.js +1 -1
  731. package/dist/components/mds-img.js +1 -1
  732. package/dist/components/mds-input-date-range-preselection.js +1 -1
  733. package/dist/components/mds-input-date-range.js +1 -1
  734. package/dist/components/mds-input-date.js +1 -1
  735. package/dist/components/mds-input-field.js +1 -1
  736. package/dist/components/mds-input-otp.js +1 -1
  737. package/dist/components/mds-input-range.js +1 -1
  738. package/dist/components/mds-input-select.js +1 -1
  739. package/dist/components/mds-input-switch.js +1 -1
  740. package/dist/components/mds-input-tip-item.js +1 -1
  741. package/dist/components/mds-input-tip.js +1 -1
  742. package/dist/components/mds-input-upload.js +1 -1
  743. package/dist/components/mds-input.js +1 -1
  744. package/dist/components/mds-keyboard-key.js +1 -1
  745. package/dist/components/mds-keyboard.js +1 -1
  746. package/dist/components/mds-kpi-item.js +1 -1
  747. package/dist/components/mds-kpi.js +1 -1
  748. package/dist/components/mds-label.js +1 -1
  749. package/dist/components/mds-list-item.js +1 -1
  750. package/dist/components/mds-list.js +1 -1
  751. package/dist/components/mds-mention.js +1 -1
  752. package/dist/components/mds-modal.js +1 -1
  753. package/dist/components/mds-note.js +1 -1
  754. package/dist/components/mds-notification.js +1 -1
  755. package/dist/components/mds-paginator-item.js +1 -1
  756. package/dist/components/mds-paginator.js +1 -1
  757. package/dist/components/mds-policy-ai.js +1 -1
  758. package/dist/components/mds-pref-animation.js +1 -1
  759. package/dist/components/mds-pref-consumption.js +1 -1
  760. package/dist/components/mds-pref-contrast.js +1 -1
  761. package/dist/components/mds-pref-language-item.js +1 -1
  762. package/dist/components/mds-pref-language.js +1 -1
  763. package/dist/components/mds-pref-mode.js +1 -1
  764. package/dist/components/mds-pref-theme-item.js +1 -1
  765. package/dist/components/mds-pref-theme.js +1 -1
  766. package/dist/components/mds-pref.js +1 -1
  767. package/dist/components/mds-price-table-features-cell.js +1 -1
  768. package/dist/components/mds-price-table-features-row.js +1 -1
  769. package/dist/components/mds-price-table-features.js +1 -1
  770. package/dist/components/mds-price-table-header.js +1 -1
  771. package/dist/components/mds-price-table-list-item.js +1 -1
  772. package/dist/components/mds-price-table-list.js +1 -1
  773. package/dist/components/mds-price-table.js +1 -1
  774. package/dist/components/mds-progress.js +1 -1
  775. package/dist/components/mds-push-notification-item.js +1 -1
  776. package/dist/components/mds-push-notification.js +1 -1
  777. package/dist/components/mds-quote.js +1 -1
  778. package/dist/components/mds-radial-menu-item.js +1 -1
  779. package/dist/components/mds-radial-menu.js +1 -1
  780. package/dist/components/mds-radial-progress.js +1 -1
  781. package/dist/components/mds-separator.js +1 -1
  782. package/dist/components/mds-spinner.js +1 -1
  783. package/dist/components/mds-status-bar.js +1 -1
  784. package/dist/components/mds-stepper-bar-item.js +1 -1
  785. package/dist/components/mds-stepper-bar.js +1 -1
  786. package/dist/components/mds-tab-bar-item.js +1 -1
  787. package/dist/components/mds-tab-bar.js +1 -1
  788. package/dist/components/mds-tab-item.js +1 -1
  789. package/dist/components/mds-tab.js +1 -1
  790. package/dist/components/mds-table-body.js +1 -1
  791. package/dist/components/mds-table-cell.js +1 -1
  792. package/dist/components/mds-table-footer.js +1 -1
  793. package/dist/components/mds-table-header-cell.js +1 -1
  794. package/dist/components/mds-table-header.js +1 -1
  795. package/dist/components/mds-table-row.js +1 -1
  796. package/dist/components/mds-table.js +1 -1
  797. package/dist/components/mds-text.js +1 -1
  798. package/dist/components/mds-toast-region.d.ts +11 -0
  799. package/dist/components/mds-toast-region.js +1 -0
  800. package/dist/components/mds-toast.js +1 -1
  801. package/dist/components/mds-tooltip.js +1 -1
  802. package/dist/components/mds-tree-item.js +1 -1
  803. package/dist/components/mds-tree.js +1 -1
  804. package/dist/components/mds-url-view.js +1 -1
  805. package/dist/components/mds-usage.js +1 -1
  806. package/dist/components/mds-video-wall.js +1 -1
  807. package/dist/components/mds-zero.js +1 -1
  808. package/dist/components/p-2gaGDQwL.js +1 -0
  809. package/dist/components/p-6pgPWpGI.js +1 -0
  810. package/dist/components/p-AFBkzOrP.js +1 -0
  811. package/dist/components/p-B1bYa-o0.js +1 -0
  812. package/dist/components/p-B2p5a1Y8.js +3 -0
  813. package/dist/components/p-B6B6q5kP.js +1 -0
  814. package/dist/components/{p--miH951G.js → p-B9dgiq4u.js} +1 -1
  815. package/dist/components/p-BFisF7aN.js +1 -0
  816. package/dist/components/p-BL220gRU.js +1 -0
  817. package/dist/components/p-BLiWCyrD.js +1 -0
  818. package/dist/components/p-BN5kmfLJ.js +8 -0
  819. package/dist/components/p-BUr3NqxM.js +1 -0
  820. package/dist/components/p-BaFfIZGB.js +1 -0
  821. package/dist/{magma-components/p-8yWTOQiz.js → components/p-Bg5E4Wnq.js} +1 -1
  822. package/dist/components/p-BjFCjSw6.js +1 -0
  823. package/dist/components/{p-zHpei4x6.js → p-BlnEiKN4.js} +1 -1
  824. package/dist/components/p-CGrPq3C4.js +1 -0
  825. package/dist/components/p-CIWWmisz.js +1 -0
  826. package/dist/components/p-CJyTL7Mj.js +1 -0
  827. package/dist/components/p-Cvhn9asj.js +1 -0
  828. package/dist/components/p-CylHulxe.js +1 -0
  829. package/dist/components/p-D3_jgpKd.js +1 -0
  830. package/dist/components/p-D4JiVIoh.js +1 -0
  831. package/dist/components/p-DACnmwad.js +1 -0
  832. package/dist/components/p-DGGk8PS_.js +1 -0
  833. package/dist/components/p-DSxDXNWp.js +1 -0
  834. package/dist/components/p-DWIIDHSa.js +1 -0
  835. package/dist/components/p-DYpfVn7a.js +1 -0
  836. package/dist/components/p-D_0rjNZp.js +1 -0
  837. package/dist/components/p-DaptTdaU.js +1 -0
  838. package/dist/components/{p-C7EyV0z3.js → p-DezdwzYQ.js} +1 -1
  839. package/dist/components/{p-s2Gu6hY7.js → p-DhIGZbIo.js} +1 -1
  840. package/dist/components/p-Didp833Z.js +1 -0
  841. package/dist/components/p-Dleapw-k.js +1 -0
  842. package/dist/components/p-JPhOaOXe.js +1 -0
  843. package/dist/components/p-NOw8-OrM.js +1 -0
  844. package/dist/components/p-NlPseOAv.js +1 -0
  845. package/dist/components/{p-Bv2IVRzI.js → p-cIZniMh0.js} +1 -1
  846. package/dist/components/p-fhAmrBfl.js +1 -0
  847. package/dist/components/p-sM-eFjwq.js +1 -0
  848. package/dist/components/p-wHQGpA62.js +1 -0
  849. package/dist/documentation.json +1503 -511
  850. package/dist/esm/_commonjsHelpers-B85MJLTf.js +5 -0
  851. package/dist/esm/aria-Cvhn9asj.js +53 -0
  852. package/dist/esm/{floating-controller-BTYkH_Ih.js → floating-controller-BV0E_Juq.js} +37 -14
  853. package/dist/esm/{floating-ui.dom-CHAGzQT-.js → floating-ui.dom-BaFfIZGB.js} +147 -209
  854. package/dist/esm/icon-B7RVWU-q.js +18 -0
  855. package/dist/esm/{index-BxPbQB28.js → index-CPRkNQdE.js} +125 -96
  856. package/dist/esm/{index-BhCZiGfL.js → index-DI_6NAg0.js} +1 -1
  857. package/dist/esm/index.js +1 -1
  858. package/dist/esm/keyboard-manager-CGrPq3C4.js +73 -0
  859. package/dist/esm/loader.js +3 -3
  860. package/dist/esm/{locale-CVJm6KFD.js → locale-DfpXg7qZ.js} +1 -1
  861. package/dist/esm/{locale.it-Cvxh7La5.js → locale.it-Diyps98n.js} +6 -1
  862. package/dist/esm/{datetime-BJtA1qmE.js → luxon-DbyXf6dF.js} +164 -64
  863. package/dist/esm/magma-components.js +4 -4
  864. package/dist/esm/mds-accordion-item.entry.js +3 -3
  865. package/dist/esm/mds-accordion-timer-item.entry.js +11 -10
  866. package/dist/esm/mds-accordion-timer.entry.js +17 -3
  867. package/dist/esm/mds-accordion.entry.js +37 -22
  868. package/dist/esm/mds-author.entry.js +2 -2
  869. package/dist/esm/mds-avatar-stack-item.entry.js +2 -2
  870. package/dist/esm/mds-avatar-stack.entry.js +11 -5
  871. package/dist/esm/mds-avatar.entry.js +58 -91
  872. package/dist/esm/mds-badge.entry.js +4 -4
  873. package/dist/esm/mds-banner_3.entry.js +51 -69
  874. package/dist/esm/mds-benchmark-bar.entry.js +6 -3
  875. package/dist/esm/mds-bibliography.entry.js +23 -17
  876. package/dist/esm/mds-breadcrumb-item.entry.js +9 -5
  877. package/dist/esm/mds-breadcrumb.entry.js +17 -33
  878. package/dist/esm/mds-button-dropdown.entry.js +41 -4
  879. package/dist/esm/mds-button-group.entry.js +2 -2
  880. package/dist/esm/mds-button_3.entry.js +96 -65
  881. package/dist/esm/mds-calendar_2.entry.js +101 -26
  882. package/dist/esm/mds-card-content.entry.js +2 -2
  883. package/dist/esm/mds-card-footer.entry.js +2 -2
  884. package/dist/esm/mds-card-header.entry.js +3 -3
  885. package/dist/esm/mds-card-media.entry.js +3 -3
  886. package/dist/esm/mds-card.entry.js +25 -16
  887. package/dist/esm/mds-details.entry.js +18 -8
  888. package/dist/esm/mds-dropdown.entry.js +31 -15
  889. package/dist/esm/mds-emoji.entry.js +192 -135
  890. package/dist/esm/mds-entity.entry.js +4 -4
  891. package/dist/esm/mds-file-preview.entry.js +30 -23
  892. package/dist/esm/mds-file.entry.js +52 -7525
  893. package/dist/esm/mds-filter-item.entry.js +81 -7
  894. package/dist/esm/mds-filter.entry.js +120 -22
  895. package/dist/esm/mds-header-bar.entry.js +38 -10
  896. package/dist/esm/mds-header.entry.js +9 -11
  897. package/dist/esm/mds-horizontal-scroll.entry.js +44 -13
  898. package/dist/esm/mds-hr.entry.js +3 -3
  899. package/dist/esm/mds-img.entry.js +39 -47
  900. package/dist/esm/mds-input-date-range-preselection.entry.js +16 -8
  901. package/dist/esm/mds-input-date-range.entry.js +25 -7
  902. package/dist/esm/mds-input-date.entry.js +43 -8
  903. package/dist/esm/mds-input-field.entry.js +3 -3
  904. package/dist/esm/mds-input-otp.entry.js +57 -22
  905. package/dist/esm/mds-input-range.entry.js +3 -3
  906. package/dist/esm/mds-input-select.entry.js +36 -9
  907. package/dist/esm/mds-input-switch_2.entry.js +27 -14
  908. package/dist/esm/mds-input-tip_2.entry.js +8 -7
  909. package/dist/esm/mds-input-upload.entry.js +1097 -15
  910. package/dist/esm/mds-input.entry.js +17 -8
  911. package/dist/esm/mds-keyboard-key.entry.js +4 -4
  912. package/dist/esm/mds-keyboard.entry.js +15 -7
  913. package/dist/esm/mds-kpi-item.entry.js +18 -4
  914. package/dist/esm/mds-kpi.entry.js +1 -1
  915. package/dist/esm/mds-label.entry.js +13 -30
  916. package/dist/esm/mds-list-item.entry.js +3 -4
  917. package/dist/esm/mds-list.entry.js +1 -1
  918. package/dist/esm/mds-mention.entry.js +7 -6
  919. package/dist/esm/mds-modal.entry.js +54 -10
  920. package/dist/esm/mds-note.entry.js +18 -14
  921. package/dist/esm/mds-notification.entry.js +72 -15
  922. package/dist/esm/mds-paginator-item.entry.js +23 -11
  923. package/dist/esm/mds-paginator.entry.js +39 -4
  924. package/dist/esm/mds-policy-ai.entry.js +5 -5
  925. package/dist/esm/mds-pref-animation.entry.js +42 -9
  926. package/dist/esm/mds-pref-consumption.entry.js +42 -9
  927. package/dist/esm/mds-pref-contrast.entry.js +45 -33
  928. package/dist/esm/mds-pref-language-item.entry.js +8 -8
  929. package/dist/esm/mds-pref-language.entry.js +44 -22
  930. package/dist/esm/mds-pref-mode.entry.js +29 -25
  931. package/dist/esm/mds-pref-theme-item.entry.js +6 -4
  932. package/dist/esm/mds-pref-theme.entry.js +137 -32
  933. package/dist/esm/mds-pref.entry.js +47 -59
  934. package/dist/esm/mds-price-table-features-cell.entry.js +4 -4
  935. package/dist/esm/mds-price-table-features-row.entry.js +4 -4
  936. package/dist/esm/mds-price-table-features.entry.js +4 -4
  937. package/dist/esm/mds-price-table-header.entry.js +2 -2
  938. package/dist/esm/mds-price-table-list-item.entry.js +3 -3
  939. package/dist/esm/mds-price-table-list.entry.js +14 -6
  940. package/dist/esm/mds-price-table.entry.js +2 -2
  941. package/dist/esm/mds-progress_2.entry.js +46 -33
  942. package/dist/esm/mds-push-notification-item.entry.js +13 -10
  943. package/dist/esm/mds-push-notification.entry.js +37 -14
  944. package/dist/esm/mds-quote.entry.js +4 -4
  945. package/dist/esm/mds-radial-menu-item.entry.js +3 -3
  946. package/dist/esm/mds-radial-menu.entry.js +81 -36
  947. package/dist/esm/mds-separator.entry.js +4 -4
  948. package/dist/esm/mds-status-bar.entry.js +8 -9
  949. package/dist/esm/mds-stepper-bar-item.entry.js +18 -6
  950. package/dist/esm/mds-stepper-bar.entry.js +9 -18
  951. package/dist/esm/mds-tab-bar-item.entry.js +25 -16
  952. package/dist/esm/mds-tab-bar.entry.js +12 -6
  953. package/dist/esm/mds-tab_2.entry.js +31 -12
  954. package/dist/esm/mds-table-body.entry.js +4 -4
  955. package/dist/esm/mds-table-footer.entry.js +13 -4
  956. package/dist/esm/mds-table-header-cell.entry.js +118 -79
  957. package/dist/esm/mds-table-header.entry.js +13 -5
  958. package/dist/esm/mds-table-row.entry.js +35 -11
  959. package/dist/esm/mds-table.entry.js +87 -23
  960. package/dist/esm/mds-text.entry.js +39 -29
  961. package/dist/esm/mds-toast-region.entry.js +117 -0
  962. package/dist/esm/mds-toast.entry.js +163 -33
  963. package/dist/esm/mds-tooltip.entry.js +84 -16
  964. package/dist/esm/mds-tree-item.entry.js +24 -10
  965. package/dist/esm/mds-tree.entry.js +37 -15
  966. package/dist/esm/mds-url-view.entry.js +6 -6
  967. package/dist/esm/mds-usage.entry.js +26 -7
  968. package/dist/esm/mds-video-wall.entry.js +5 -4
  969. package/dist/esm/mds-zero.entry.js +4 -4
  970. package/dist/esm/{preference-DNNqH7BU.js → preference-Ch1zJnqq.js} +1 -1
  971. package/dist/esm/{slot-C0o_l0td.js → slot-AEckDMXh.js} +15 -1
  972. package/dist/esm/string-6pgPWpGI.js +5 -0
  973. package/dist/esm-es5/_commonjsHelpers-B85MJLTf.js +1 -0
  974. package/dist/esm-es5/aria-Cvhn9asj.js +6 -0
  975. package/dist/esm-es5/{floating-controller-BTYkH_Ih.js → floating-controller-BV0E_Juq.js} +22 -7
  976. package/dist/esm-es5/{floating-ui.dom-CHAGzQT-.js → floating-ui.dom-BaFfIZGB.js} +69 -60
  977. package/dist/esm-es5/icon-B7RVWU-q.js +4 -0
  978. package/dist/esm-es5/{index-BxPbQB28.js → index-CPRkNQdE.js} +75 -73
  979. package/dist/esm-es5/{index-BhCZiGfL.js → index-DI_6NAg0.js} +1 -1
  980. package/dist/esm-es5/index.js +1 -1
  981. package/dist/esm-es5/keyboard-manager-CGrPq3C4.js +9 -0
  982. package/dist/esm-es5/loader.js +1 -1
  983. package/dist/esm-es5/{locale-CVJm6KFD.js → locale-DfpXg7qZ.js} +1 -1
  984. package/dist/esm-es5/locale.it-Diyps98n.js +11 -0
  985. package/dist/esm-es5/{datetime-BJtA1qmE.js → luxon-DbyXf6dF.js} +51 -20
  986. package/dist/esm-es5/magma-components.js +3 -3
  987. package/dist/esm-es5/mds-accordion-item.entry.js +2 -2
  988. package/dist/esm-es5/mds-accordion-timer-item.entry.js +7 -3
  989. package/dist/esm-es5/mds-accordion-timer.entry.js +12 -2
  990. package/dist/esm-es5/mds-accordion.entry.js +14 -2
  991. package/dist/esm-es5/mds-author.entry.js +1 -1
  992. package/dist/esm-es5/mds-avatar-stack-item.entry.js +1 -1
  993. package/dist/esm-es5/mds-avatar-stack.entry.js +4 -1
  994. package/dist/esm-es5/mds-avatar.entry.js +19 -6
  995. package/dist/esm-es5/mds-badge.entry.js +1 -1
  996. package/dist/esm-es5/mds-banner_3.entry.js +19 -18
  997. package/dist/esm-es5/mds-benchmark-bar.entry.js +5 -2
  998. package/dist/esm-es5/mds-bibliography.entry.js +13 -2
  999. package/dist/esm-es5/mds-breadcrumb-item.entry.js +4 -1
  1000. package/dist/esm-es5/mds-breadcrumb.entry.js +8 -2
  1001. package/dist/esm-es5/mds-button-dropdown.entry.js +7 -4
  1002. package/dist/esm-es5/mds-button-group.entry.js +1 -1
  1003. package/dist/esm-es5/mds-button_3.entry.js +48 -12
  1004. package/dist/esm-es5/mds-calendar_2.entry.js +21 -8
  1005. package/dist/esm-es5/mds-card-content.entry.js +1 -1
  1006. package/dist/esm-es5/mds-card-footer.entry.js +1 -1
  1007. package/dist/esm-es5/mds-card-header.entry.js +1 -1
  1008. package/dist/esm-es5/mds-card-media.entry.js +1 -1
  1009. package/dist/esm-es5/mds-card.entry.js +11 -5
  1010. package/dist/esm-es5/mds-details.entry.js +7 -2
  1011. package/dist/esm-es5/mds-dropdown.entry.js +28 -19
  1012. package/dist/esm-es5/mds-emoji.entry.js +334 -302
  1013. package/dist/esm-es5/mds-entity.entry.js +1 -1
  1014. package/dist/esm-es5/mds-file-preview.entry.js +15 -13
  1015. package/dist/esm-es5/mds-file.entry.js +22 -2835
  1016. package/dist/esm-es5/mds-filter-item.entry.js +13 -1
  1017. package/dist/esm-es5/mds-filter.entry.js +22 -2
  1018. package/dist/esm-es5/mds-header-bar.entry.js +7 -5
  1019. package/dist/esm-es5/mds-header.entry.js +10 -7
  1020. package/dist/esm-es5/mds-horizontal-scroll.entry.js +16 -13
  1021. package/dist/esm-es5/mds-hr.entry.js +1 -1
  1022. package/dist/esm-es5/mds-img.entry.js +17 -11
  1023. package/dist/esm-es5/mds-input-date-range-preselection.entry.js +6 -1
  1024. package/dist/esm-es5/mds-input-date-range.entry.js +20 -11
  1025. package/dist/esm-es5/mds-input-date.entry.js +11 -3
  1026. package/dist/esm-es5/mds-input-field.entry.js +2 -2
  1027. package/dist/esm-es5/mds-input-otp.entry.js +16 -6
  1028. package/dist/esm-es5/mds-input-range.entry.js +7 -7
  1029. package/dist/esm-es5/mds-input-select.entry.js +14 -5
  1030. package/dist/esm-es5/mds-input-switch_2.entry.js +17 -9
  1031. package/dist/esm-es5/mds-input-tip_2.entry.js +4 -3
  1032. package/dist/esm-es5/mds-input-upload.entry.js +5 -3
  1033. package/dist/esm-es5/mds-input.entry.js +30 -25
  1034. package/dist/esm-es5/mds-keyboard-key.entry.js +2 -2
  1035. package/dist/esm-es5/mds-keyboard.entry.js +7 -3
  1036. package/dist/esm-es5/mds-kpi-item.entry.js +7 -2
  1037. package/dist/esm-es5/mds-kpi.entry.js +1 -1
  1038. package/dist/esm-es5/mds-label.entry.js +2 -2
  1039. package/dist/esm-es5/mds-list-item.entry.js +2 -2
  1040. package/dist/esm-es5/mds-list.entry.js +1 -1
  1041. package/dist/esm-es5/mds-mention.entry.js +4 -3
  1042. package/dist/esm-es5/mds-modal.entry.js +20 -8
  1043. package/dist/esm-es5/mds-note.entry.js +5 -2
  1044. package/dist/esm-es5/mds-notification.entry.js +24 -4
  1045. package/dist/esm-es5/mds-paginator-item.entry.js +8 -1
  1046. package/dist/esm-es5/mds-paginator.entry.js +3 -3
  1047. package/dist/esm-es5/mds-policy-ai.entry.js +2 -2
  1048. package/dist/esm-es5/mds-pref-animation.entry.js +14 -4
  1049. package/dist/esm-es5/mds-pref-consumption.entry.js +14 -4
  1050. package/dist/esm-es5/mds-pref-contrast.entry.js +14 -7
  1051. package/dist/esm-es5/mds-pref-language-item.entry.js +5 -5
  1052. package/dist/esm-es5/mds-pref-language.entry.js +20 -6
  1053. package/dist/esm-es5/mds-pref-mode.entry.js +10 -3
  1054. package/dist/esm-es5/mds-pref-theme-item.entry.js +4 -3
  1055. package/dist/esm-es5/mds-pref-theme.entry.js +46 -11
  1056. package/dist/esm-es5/mds-pref.entry.js +21 -6
  1057. package/dist/esm-es5/mds-price-table-features-cell.entry.js +2 -2
  1058. package/dist/esm-es5/mds-price-table-features-row.entry.js +1 -1
  1059. package/dist/esm-es5/mds-price-table-features.entry.js +1 -1
  1060. package/dist/esm-es5/mds-price-table-header.entry.js +1 -1
  1061. package/dist/esm-es5/mds-price-table-list-item.entry.js +2 -2
  1062. package/dist/esm-es5/mds-price-table-list.entry.js +5 -1
  1063. package/dist/esm-es5/mds-price-table.entry.js +1 -1
  1064. package/dist/esm-es5/mds-progress_2.entry.js +18 -3
  1065. package/dist/esm-es5/mds-push-notification-item.entry.js +7 -3
  1066. package/dist/esm-es5/mds-push-notification.entry.js +9 -12
  1067. package/dist/esm-es5/mds-quote.entry.js +2 -2
  1068. package/dist/esm-es5/mds-radial-menu-item.entry.js +2 -2
  1069. package/dist/esm-es5/mds-radial-menu.entry.js +8 -11
  1070. package/dist/esm-es5/mds-separator.entry.js +1 -1
  1071. package/dist/esm-es5/mds-status-bar.entry.js +5 -3
  1072. package/dist/esm-es5/mds-stepper-bar-item.entry.js +9 -3
  1073. package/dist/esm-es5/mds-stepper-bar.entry.js +10 -5
  1074. package/dist/esm-es5/mds-tab-bar-item.entry.js +10 -3
  1075. package/dist/esm-es5/mds-tab-bar.entry.js +5 -1
  1076. package/dist/esm-es5/mds-tab_2.entry.js +16 -4
  1077. package/dist/esm-es5/mds-table-body.entry.js +1 -1
  1078. package/dist/esm-es5/mds-table-footer.entry.js +4 -1
  1079. package/dist/esm-es5/mds-table-header-cell.entry.js +22 -3
  1080. package/dist/esm-es5/mds-table-header.entry.js +10 -5
  1081. package/dist/esm-es5/mds-table-row.entry.js +12 -6
  1082. package/dist/esm-es5/mds-table.entry.js +38 -7
  1083. package/dist/esm-es5/mds-text.entry.js +26 -8
  1084. package/dist/esm-es5/mds-toast-region.entry.js +22 -0
  1085. package/dist/esm-es5/mds-toast.entry.js +42 -5
  1086. package/dist/esm-es5/mds-tooltip.entry.js +21 -6
  1087. package/dist/esm-es5/mds-tree-item.entry.js +15 -4
  1088. package/dist/esm-es5/mds-tree.entry.js +16 -3
  1089. package/dist/esm-es5/mds-url-view.entry.js +2 -2
  1090. package/dist/esm-es5/mds-usage.entry.js +9 -3
  1091. package/dist/esm-es5/mds-video-wall.entry.js +2 -2
  1092. package/dist/esm-es5/mds-zero.entry.js +1 -1
  1093. package/dist/esm-es5/{preference-DNNqH7BU.js → preference-Ch1zJnqq.js} +4 -4
  1094. package/dist/esm-es5/slot-AEckDMXh.js +30 -0
  1095. package/dist/esm-es5/string-6pgPWpGI.js +2 -0
  1096. package/dist/hydrate/index.js +5339 -9639
  1097. package/dist/hydrate/index.mjs +5339 -9639
  1098. package/dist/magma-components/index.esm.js +1 -1
  1099. package/dist/magma-components/magma-components.esm.js +1 -1
  1100. package/dist/magma-components/magma-components.js +1 -1
  1101. package/dist/magma-components/p-007968a8.system.entry.js +47 -0
  1102. package/dist/magma-components/p-028f3717.entry.js +1 -0
  1103. package/dist/magma-components/p-0727d8f9.entry.js +1 -0
  1104. package/dist/magma-components/p-0b5fe949.entry.js +1 -0
  1105. package/dist/magma-components/p-0b7a884e.system.entry.js +29 -0
  1106. package/dist/magma-components/p-0bcf3bb6.entry.js +1 -0
  1107. package/dist/magma-components/{p-a0d9e01f.system.entry.js → p-0c9bdfff.system.entry.js} +1 -1
  1108. package/dist/magma-components/p-0dd4b006.entry.js +1 -0
  1109. package/dist/magma-components/p-0f47fd37.system.entry.js +16 -0
  1110. package/dist/magma-components/p-11e50140.system.entry.js +19 -0
  1111. package/dist/magma-components/p-11feeebf.system.entry.js +4 -0
  1112. package/dist/magma-components/p-1287fb51.entry.js +1 -0
  1113. package/dist/magma-components/p-12a2f8e2.system.entry.js +13 -0
  1114. package/dist/magma-components/p-14b40c21.entry.js +1 -0
  1115. package/dist/magma-components/p-166c0190.entry.js +1 -0
  1116. package/dist/magma-components/p-176e6d9d.system.entry.js +4 -0
  1117. package/dist/magma-components/{p-91451e37.system.entry.js → p-1809e47d.system.entry.js} +455 -422
  1118. package/dist/magma-components/p-1989c0b4.entry.js +8 -0
  1119. package/dist/magma-components/p-1a5411a8.entry.js +1 -0
  1120. package/dist/magma-components/p-1f5cd2b5.entry.js +1 -0
  1121. package/dist/magma-components/p-1f9ebc0d.entry.js +1 -0
  1122. package/dist/magma-components/p-1fe66383.system.entry.js +1 -0
  1123. package/dist/magma-components/p-20469b7a.system.entry.js +1 -0
  1124. package/dist/magma-components/p-20608f69.system.entry.js +35 -0
  1125. package/dist/magma-components/p-2061e567.entry.js +1 -0
  1126. package/dist/magma-components/p-21c2d7bd.entry.js +1 -0
  1127. package/dist/magma-components/p-21fe0fef.system.entry.js +14 -0
  1128. package/dist/magma-components/p-2294945a.system.entry.js +34 -0
  1129. package/dist/magma-components/p-2362b91a.entry.js +1 -0
  1130. package/dist/magma-components/p-23bf1afa.system.entry.js +27 -0
  1131. package/dist/magma-components/{p-c48e3460.entry.js → p-23ce0824.entry.js} +1 -1
  1132. package/dist/magma-components/p-25576b51.system.entry.js +14 -0
  1133. package/dist/magma-components/p-288f3cfe.entry.js +1 -0
  1134. package/dist/magma-components/p-29d4605e.system.entry.js +10 -0
  1135. package/dist/magma-components/p-2a2b7c43.entry.js +1 -0
  1136. package/dist/magma-components/p-2aab3752.entry.js +1 -0
  1137. package/dist/magma-components/p-2abfc393.entry.js +1 -0
  1138. package/dist/magma-components/p-2c4d2717.entry.js +1 -0
  1139. package/dist/magma-components/p-2d7d9e4f.entry.js +1 -0
  1140. package/dist/magma-components/p-2f3c6105.entry.js +1 -0
  1141. package/dist/magma-components/p-3093af30.system.entry.js +4 -0
  1142. package/dist/magma-components/p-32bfb09c.entry.js +1 -0
  1143. package/dist/magma-components/p-342770d2.system.entry.js +7 -0
  1144. package/dist/magma-components/p-36ad5759.system.entry.js +10 -0
  1145. package/dist/magma-components/p-3725c2c1.entry.js +1 -0
  1146. package/dist/magma-components/p-37b801d0.system.entry.js +22 -0
  1147. package/dist/magma-components/p-3871807a.entry.js +1 -0
  1148. package/dist/magma-components/p-38a9e862.entry.js +1 -0
  1149. package/dist/magma-components/p-3a88fc9b.system.entry.js +1 -0
  1150. package/dist/magma-components/p-3ac09ace.entry.js +1 -0
  1151. package/dist/magma-components/p-3b36319a.entry.js +1 -0
  1152. package/dist/magma-components/p-3ba5ddae.entry.js +1 -0
  1153. package/dist/magma-components/p-3bb26611.entry.js +1 -0
  1154. package/dist/magma-components/p-3e1b21bd.entry.js +1 -0
  1155. package/dist/magma-components/p-3eaeb263.system.entry.js +25 -0
  1156. package/dist/magma-components/p-3fb98529.system.entry.js +28 -0
  1157. package/dist/magma-components/p-4116e328.system.entry.js +1 -0
  1158. package/dist/magma-components/p-4191bf22.entry.js +1 -0
  1159. package/dist/magma-components/p-4225484c.entry.js +1 -0
  1160. package/dist/magma-components/p-4260da67.system.entry.js +12 -0
  1161. package/dist/magma-components/p-43338a07.entry.js +1 -0
  1162. package/dist/magma-components/p-4582aa3e.system.entry.js +16 -0
  1163. package/dist/magma-components/p-47f7366c.entry.js +1 -0
  1164. package/dist/magma-components/p-495a70e2.entry.js +1 -0
  1165. package/dist/magma-components/p-4a051ef5.system.entry.js +46 -0
  1166. package/dist/magma-components/p-4c2dad1e.system.entry.js +81 -0
  1167. package/dist/magma-components/p-4d079b1a.system.entry.js +26 -0
  1168. package/dist/magma-components/p-4ea00c22.entry.js +1 -0
  1169. package/dist/magma-components/p-4f24ccf3.entry.js +1 -0
  1170. package/dist/magma-components/{p-f3dbebdd.system.entry.js → p-4fdda209.system.entry.js} +26 -8
  1171. package/dist/magma-components/p-505fb7d4.entry.js +1 -0
  1172. package/dist/magma-components/p-51a869ee.entry.js +1 -0
  1173. package/dist/magma-components/p-5219eba6.system.entry.js +4 -0
  1174. package/dist/magma-components/p-52a85b97.system.entry.js +9 -0
  1175. package/dist/magma-components/p-52d5d104.system.entry.js +17 -0
  1176. package/dist/magma-components/p-53bcfdbb.entry.js +1 -0
  1177. package/dist/magma-components/p-5439125d.system.entry.js +10 -0
  1178. package/dist/magma-components/p-547f657e.system.entry.js +91 -0
  1179. package/dist/magma-components/p-5a2deba5.entry.js +1 -0
  1180. package/dist/magma-components/p-5b21eb78.entry.js +1 -0
  1181. package/dist/magma-components/p-5d9b1fe5.entry.js +1 -0
  1182. package/dist/magma-components/p-5ea3be82.system.entry.js +23 -0
  1183. package/dist/magma-components/{p-BPNsbMrg.system.js → p-5vJawLPw.system.js} +29 -14
  1184. package/dist/magma-components/p-62e65f3b.entry.js +1 -0
  1185. package/dist/magma-components/p-648ec03b.system.entry.js +73 -0
  1186. package/dist/magma-components/p-69b37755.system.entry.js +17 -0
  1187. package/dist/magma-components/p-6b01ef3b.entry.js +1 -0
  1188. package/dist/magma-components/p-6b2fff4b.system.entry.js +11 -0
  1189. package/dist/magma-components/p-6bc4114c.system.entry.js +19 -0
  1190. package/dist/magma-components/p-6c91b00d.system.entry.js +22 -0
  1191. package/dist/magma-components/p-6da68fd5.entry.js +1 -0
  1192. package/dist/magma-components/p-6ebbcd7b.system.entry.js +14 -0
  1193. package/dist/magma-components/p-6pgPWpGI.js +1 -0
  1194. package/dist/magma-components/p-70a911e8.entry.js +1 -0
  1195. package/dist/magma-components/p-70f5536c.system.entry.js +15 -0
  1196. package/dist/magma-components/{p-61bedbe7.system.entry.js → p-721b625a.system.entry.js} +17 -8
  1197. package/dist/magma-components/p-72cc4977.system.entry.js +21 -0
  1198. package/dist/magma-components/p-7497b39d.system.entry.js +7 -0
  1199. package/dist/magma-components/p-765ff9a3.system.entry.js +98 -0
  1200. package/dist/magma-components/p-7a568cbf.entry.js +1 -0
  1201. package/dist/magma-components/p-7d548a19.entry.js +1 -0
  1202. package/dist/magma-components/p-7f776dff.entry.js +1 -0
  1203. package/dist/magma-components/p-8059aa67.system.entry.js +17 -0
  1204. package/dist/magma-components/p-811272a9.entry.js +1 -0
  1205. package/dist/magma-components/p-87b15008.entry.js +1 -0
  1206. package/dist/magma-components/p-88ac5d50.entry.js +1 -0
  1207. package/dist/magma-components/p-88be542e.system.entry.js +7 -0
  1208. package/dist/magma-components/{p-7c940015.system.entry.js → p-890bae38.system.entry.js} +1 -1
  1209. package/dist/magma-components/p-8a4a2b5a.entry.js +1 -0
  1210. package/dist/magma-components/p-8b081ba9.entry.js +1 -0
  1211. package/dist/magma-components/{p-0a9fb138.system.entry.js → p-8ba250d6.system.entry.js} +1 -1
  1212. package/dist/magma-components/p-8d8c9c90.entry.js +1 -0
  1213. package/dist/magma-components/p-8e08ae08.system.entry.js +94 -0
  1214. package/dist/magma-components/p-8f5f2dfe.system.entry.js +19 -0
  1215. package/dist/magma-components/p-90fe332f.entry.js +1 -0
  1216. package/dist/magma-components/p-911dc847.entry.js +1 -0
  1217. package/dist/magma-components/p-916a26e4.entry.js +1 -0
  1218. package/dist/magma-components/p-926ef760.entry.js +1 -0
  1219. package/dist/magma-components/p-93d8b236.system.entry.js +10 -0
  1220. package/dist/magma-components/p-95328cc7.system.entry.js +17 -0
  1221. package/dist/magma-components/p-95486c6a.system.entry.js +5 -0
  1222. package/dist/magma-components/{p-3a1a6945.entry.js → p-96f973e3.entry.js} +1 -1
  1223. package/dist/magma-components/p-972ff8a9.entry.js +18 -0
  1224. package/dist/magma-components/p-9a28bd8d.system.entry.js +20 -0
  1225. package/dist/magma-components/p-9bdca8b4.entry.js +1 -0
  1226. package/dist/magma-components/p-9caf411a.system.entry.js +13 -0
  1227. package/dist/magma-components/p-9e4e1a86.system.entry.js +111 -0
  1228. package/dist/magma-components/{p-3f05ec8a.entry.js → p-9e7d02e5.entry.js} +1 -1
  1229. package/dist/magma-components/p-AEckDMXh.js +1 -0
  1230. package/dist/magma-components/p-B7RVWU-q.js +1 -0
  1231. package/dist/magma-components/p-B85MJLTf.js +1 -0
  1232. package/dist/magma-components/{p-CKfEQ187.system.js → p-BHS0WXNt.system.js} +1 -1
  1233. package/dist/magma-components/p-BaFfIZGB.js +1 -0
  1234. package/dist/magma-components/{p-RJ5ZA1kY.system.js → p-BeNKMPXR.system.js} +9 -2
  1235. package/dist/magma-components/{p-Kv1yahtR.js → p-BmT_DEV2.js} +2 -2
  1236. package/dist/magma-components/{p-BTF_aRDG.system.js → p-C1ailvfu.system.js} +28 -28
  1237. package/dist/magma-components/{p-7-TP6wnI.js → p-C25F_FlB.js} +1 -1
  1238. package/dist/magma-components/p-CDjzBTsk.js +1 -0
  1239. package/dist/magma-components/p-CGrPq3C4.js +1 -0
  1240. package/dist/magma-components/p-CPRkNQdE.js +3 -0
  1241. package/dist/magma-components/{p-DaONbL_w.system.js → p-CmzGV0XD.system.js} +44 -44
  1242. package/dist/magma-components/p-Cvhn9asj.js +1 -0
  1243. package/dist/magma-components/p-D6-Ny6z1.system.js +1 -0
  1244. package/dist/magma-components/{p-hVpoPUxI.system.js → p-D8596ytD.system.js} +8 -8
  1245. package/dist/magma-components/p-D9J8lbUv.system.js +9 -0
  1246. package/dist/magma-components/p-DAifcgtS.system.js +4 -0
  1247. package/dist/magma-components/p-DbyXf6dF.js +1 -0
  1248. package/dist/magma-components/p-JuViHg2B.system.js +11 -0
  1249. package/dist/magma-components/{p-CdsZyFQ-.system.js → p-LUd56iG_.system.js} +1 -1
  1250. package/dist/magma-components/p-QYez4sql.system.js +5 -0
  1251. package/dist/magma-components/{p-BJKToXNf.system.js → p-WSL9tMdv.system.js} +81 -50
  1252. package/dist/magma-components/p-ZaZnuNvg.js +1 -0
  1253. package/dist/magma-components/{p-876a5fb9.system.entry.js → p-a08d20c2.system.entry.js} +1 -1
  1254. package/dist/magma-components/p-a136e6fe.system.entry.js +6 -0
  1255. package/dist/magma-components/p-a1443292.entry.js +1 -0
  1256. package/dist/magma-components/p-a1ca2441.system.entry.js +22 -0
  1257. package/dist/magma-components/{p-f8da21a1.system.entry.js → p-a2d10402.system.entry.js} +1 -1
  1258. package/dist/magma-components/p-a2ec6eac.entry.js +1 -0
  1259. package/dist/magma-components/{p-d5e53364.system.entry.js → p-a40443ca.system.entry.js} +1 -1
  1260. package/dist/magma-components/p-a47a9f11.system.entry.js +1 -0
  1261. package/dist/magma-components/p-a4f46de1.system.entry.js +24 -0
  1262. package/dist/magma-components/p-a51f849a.entry.js +1 -0
  1263. package/dist/magma-components/p-a53f6a94.system.entry.js +5 -0
  1264. package/dist/magma-components/p-a61623f9.system.entry.js +52 -0
  1265. package/dist/magma-components/p-a6fe6b4c.system.entry.js +1 -0
  1266. package/dist/magma-components/p-a7bad4e8.entry.js +1 -0
  1267. package/dist/magma-components/p-a8593847.entry.js +1 -0
  1268. package/dist/magma-components/p-aa8653b1.system.entry.js +13 -0
  1269. package/dist/magma-components/p-ac4109e3.entry.js +1 -0
  1270. package/dist/magma-components/{p-bba04b08.system.entry.js → p-af704402.system.entry.js} +5 -2
  1271. package/dist/magma-components/p-b36d54e1.system.entry.js +41 -0
  1272. package/dist/magma-components/p-b40ef7ab.system.entry.js +23 -0
  1273. package/dist/magma-components/p-b48fc62e.entry.js +1 -0
  1274. package/dist/magma-components/p-b509fb36.entry.js +1 -0
  1275. package/dist/magma-components/{p-f65e29e0.system.entry.js → p-b514bd3a.system.entry.js} +1 -1
  1276. package/dist/magma-components/p-b58363e2.system.entry.js +31 -0
  1277. package/dist/magma-components/{p-a9e4efa3.entry.js → p-b62bbd07.entry.js} +1 -1
  1278. package/dist/magma-components/p-b6b7dc40.entry.js +1 -0
  1279. package/dist/magma-components/p-b728638c.system.entry.js +46 -0
  1280. package/dist/magma-components/p-b919ce62.entry.js +1 -0
  1281. package/dist/magma-components/{p-c4beed1b.entry.js → p-b940888d.entry.js} +1 -1
  1282. package/dist/magma-components/p-b9e0b31d.entry.js +1 -0
  1283. package/dist/magma-components/p-bba4c7eb.entry.js +1 -0
  1284. package/dist/magma-components/p-bc30508b.entry.js +1 -0
  1285. package/dist/magma-components/p-be32b7a9.system.entry.js +13 -0
  1286. package/dist/magma-components/p-be741e35.entry.js +1 -0
  1287. package/dist/magma-components/p-c1d8a25e.entry.js +1 -0
  1288. package/dist/magma-components/p-c3622315.entry.js +1 -0
  1289. package/dist/magma-components/p-c4286fb7.system.entry.js +1 -0
  1290. package/dist/magma-components/p-c6db7a0f.system.entry.js +22 -0
  1291. package/dist/magma-components/p-c89c2e30.entry.js +1 -0
  1292. package/dist/magma-components/p-ca8e0927.system.entry.js +7 -0
  1293. package/dist/magma-components/p-cc0cb701.entry.js +1 -0
  1294. package/dist/magma-components/{p-dcf841d5.entry.js → p-cc109576.entry.js} +1 -1
  1295. package/dist/magma-components/p-cc88c963.system.entry.js +1 -0
  1296. package/dist/magma-components/p-ce2ef293.system.entry.js +48 -0
  1297. package/dist/magma-components/p-d0c0c195.entry.js +1 -0
  1298. package/dist/magma-components/p-d0f257d9.system.entry.js +80 -0
  1299. package/dist/magma-components/p-d3678561.system.entry.js +35 -0
  1300. package/dist/magma-components/p-d8d87750.system.entry.js +21 -0
  1301. package/dist/magma-components/p-d9551916.system.entry.js +222 -0
  1302. package/dist/magma-components/p-da532544.system.entry.js +25 -0
  1303. package/dist/magma-components/p-da6cf595.system.entry.js +7 -0
  1304. package/dist/magma-components/p-da9afc4b.system.entry.js +8 -0
  1305. package/dist/magma-components/p-daf9c8ca.system.entry.js +4 -0
  1306. package/dist/magma-components/p-db75bf05.system.entry.js +49 -0
  1307. package/dist/magma-components/p-dba5a6da.entry.js +1 -0
  1308. package/dist/magma-components/p-dbb82d72.system.entry.js +54 -0
  1309. package/dist/magma-components/p-dbf69d54.system.entry.js +5 -0
  1310. package/dist/magma-components/p-dc3ef031.system.entry.js +27 -0
  1311. package/dist/magma-components/p-dd8fb2f8.system.entry.js +105 -0
  1312. package/dist/magma-components/p-dfbecf72.system.entry.js +11 -0
  1313. package/dist/magma-components/p-e032e77f.system.entry.js +1 -0
  1314. package/dist/magma-components/p-e15a874b.entry.js +1 -0
  1315. package/dist/magma-components/p-e471decd.system.entry.js +32 -0
  1316. package/dist/magma-components/p-e49818c4.entry.js +1 -0
  1317. package/dist/magma-components/p-e5ab1f4f.entry.js +1 -0
  1318. package/dist/magma-components/p-e6ed6e12.entry.js +1 -0
  1319. package/dist/magma-components/{p-ad09a06b.entry.js → p-e8b9d639.entry.js} +1 -1
  1320. package/dist/magma-components/p-e954b5c5.entry.js +1 -0
  1321. package/dist/magma-components/p-eba7cfb3.entry.js +1 -0
  1322. package/dist/magma-components/{p-8c93550d.entry.js → p-ecb87d38.entry.js} +1 -1
  1323. package/dist/magma-components/p-eebf450c.system.entry.js +4 -0
  1324. package/dist/magma-components/p-ef4d07ba.entry.js +1 -0
  1325. package/dist/magma-components/p-f28e048b.system.entry.js +55 -0
  1326. package/dist/magma-components/p-f30cdd34.system.entry.js +1 -0
  1327. package/dist/magma-components/p-f3763382.entry.js +1 -0
  1328. package/dist/magma-components/p-f43379ef.entry.js +1 -0
  1329. package/dist/magma-components/p-f454c06b.entry.js +1 -0
  1330. package/dist/magma-components/p-f48843b7.system.entry.js +1 -0
  1331. package/dist/magma-components/p-f5a08dca.system.entry.js +40 -0
  1332. package/dist/magma-components/p-f7af41fb.system.entry.js +33 -0
  1333. package/dist/magma-components/p-f7f6881a.entry.js +1 -0
  1334. package/dist/magma-components/p-f88c202e.entry.js +1 -0
  1335. package/dist/magma-components/{p-1cb495d3.entry.js → p-f9b5a5ec.entry.js} +1 -1
  1336. package/dist/magma-components/p-fcaa81b3.entry.js +1 -0
  1337. package/dist/magma-components/{p-dc399372.entry.js → p-fd53a51c.entry.js} +1 -1
  1338. package/dist/magma-components/p-ff4276d3.system.entry.js +16 -0
  1339. package/dist/magma-components/p-nFkaC8l_.system.js +210 -0
  1340. package/dist/magma-components/p-pxyGaQ-P.system.js +2 -0
  1341. package/dist/magma-components/p-sm_-_oFY.system.js +6 -0
  1342. package/dist/{components/p-faViX-qz.js → magma-components/p-zQY2FlcD.js} +1 -1
  1343. package/dist/stats.json +6762 -4706
  1344. package/dist/types/common/aria.d.ts +8 -1
  1345. package/dist/types/common/file.d.ts +5 -0
  1346. package/dist/types/common/floating-controller.d.ts +16 -2
  1347. package/dist/types/common/hash.d.ts +8 -0
  1348. package/dist/types/common/keyboard-manager.d.ts +8 -1
  1349. package/dist/types/common/slot.d.ts +9 -1
  1350. package/dist/types/common/string.d.ts +3 -1
  1351. package/dist/types/components/mds-accordion/mds-accordion.d.ts +8 -1
  1352. package/dist/types/components/mds-accordion-timer/mds-accordion-timer.d.ts +6 -0
  1353. package/dist/types/components/mds-accordion-timer-item/mds-accordion-timer-item.d.ts +2 -1
  1354. package/dist/types/components/mds-avatar/mds-avatar.d.ts +13 -9
  1355. package/dist/types/components/mds-avatar-stack/mds-avatar-stack.d.ts +2 -1
  1356. package/dist/types/components/mds-bibliography/mds-bibliography.d.ts +10 -2
  1357. package/dist/types/components/mds-breadcrumb/mds-breadcrumb.d.ts +0 -3
  1358. package/dist/types/components/mds-breadcrumb-item/mds-breadcrumb-item.d.ts +4 -1
  1359. package/dist/types/components/mds-button/mds-button.d.ts +17 -1
  1360. package/dist/types/components/mds-button-dropdown/mds-button-dropdown.d.ts +8 -3
  1361. package/dist/types/components/mds-calendar/mds-calendar.d.ts +8 -0
  1362. package/dist/types/components/mds-calendar-cell/mds-calendar-cell.d.ts +4 -1
  1363. package/dist/types/components/mds-card/mds-card.d.ts +8 -0
  1364. package/dist/types/components/mds-card-media/mds-card-media.d.ts +1 -0
  1365. package/dist/types/components/mds-chip/mds-chip.d.ts +7 -5
  1366. package/dist/types/components/mds-details/mds-details.d.ts +3 -1
  1367. package/dist/types/components/mds-dropdown/mds-dropdown.d.ts +8 -3
  1368. package/dist/types/components/mds-emoji/mds-emoji.d.ts +18 -10
  1369. package/dist/types/components/mds-emoji/meta/gaze.d.ts +19 -0
  1370. package/dist/types/components/mds-file/mds-file.d.ts +13 -2
  1371. package/dist/types/components/mds-file-preview/mds-file-preview.d.ts +15 -4
  1372. package/dist/types/components/mds-filter/mds-filter.d.ts +15 -0
  1373. package/dist/types/components/mds-filter-item/mds-filter-item.d.ts +16 -1
  1374. package/dist/types/components/mds-header/mds-header.d.ts +7 -5
  1375. package/dist/types/components/mds-header/meta/event-detail.d.ts +2 -1
  1376. package/dist/types/components/mds-header-bar/mds-header-bar.d.ts +4 -2
  1377. package/dist/types/components/mds-help/mds-help.d.ts +5 -2
  1378. package/dist/types/components/mds-horizontal-scroll/mds-horizontal-scroll.d.ts +2 -0
  1379. package/dist/types/components/mds-icon/mds-icon.d.ts +5 -0
  1380. package/dist/types/components/mds-img/mds-img.d.ts +24 -14
  1381. package/dist/types/components/mds-input/mds-input.d.ts +30 -8
  1382. package/dist/types/components/mds-input-date/mds-input-date.d.ts +12 -0
  1383. package/dist/types/components/mds-input-date-range/mds-input-date-range.d.ts +9 -0
  1384. package/dist/types/components/mds-input-date-range-preselection/mds-input-date-range-preselection.d.ts +8 -1
  1385. package/dist/types/components/mds-input-field/mds-input-field.d.ts +4 -1
  1386. package/dist/types/components/mds-input-otp/mds-input-otp.d.ts +8 -0
  1387. package/dist/types/components/mds-input-select/mds-input-select.d.ts +15 -2
  1388. package/dist/types/components/mds-input-switch/mds-input-switch.d.ts +8 -3
  1389. package/dist/types/components/mds-input-tip/mds-input-tip.d.ts +2 -1
  1390. package/dist/types/components/mds-input-tip-item/meta/dictionary.d.ts +1 -2
  1391. package/dist/types/components/mds-input-upload/mds-input-upload.d.ts +3 -1
  1392. package/dist/types/components/mds-kpi-item/mds-kpi-item.d.ts +7 -0
  1393. package/dist/types/components/mds-label/mds-label.d.ts +0 -9
  1394. package/dist/types/components/mds-list-item/mds-list-item.d.ts +2 -0
  1395. package/dist/types/components/mds-mention/mds-mention.d.ts +2 -1
  1396. package/dist/types/components/mds-modal/mds-modal.d.ts +5 -1
  1397. package/dist/types/components/mds-note/mds-note.d.ts +1 -0
  1398. package/dist/types/components/mds-notification/mds-notification.d.ts +25 -2
  1399. package/dist/types/components/mds-paginator/mds-paginator.d.ts +1 -0
  1400. package/dist/types/components/mds-paginator-item/mds-paginator-item.d.ts +7 -0
  1401. package/dist/types/components/mds-policy-ai/mds-policy-ai.d.ts +2 -1
  1402. package/dist/types/components/mds-pref/mds-pref.d.ts +11 -9
  1403. package/dist/types/components/mds-pref-animation/mds-pref-animation.d.ts +8 -0
  1404. package/dist/types/components/mds-pref-consumption/mds-pref-consumption.d.ts +8 -0
  1405. package/dist/types/components/mds-pref-contrast/mds-pref-contrast.d.ts +8 -2
  1406. package/dist/types/components/mds-pref-language/mds-pref-language.d.ts +2 -2
  1407. package/dist/types/components/mds-pref-language-item/mds-pref-language-item.d.ts +1 -0
  1408. package/dist/types/components/mds-pref-mode/mds-pref-mode.d.ts +6 -1
  1409. package/dist/types/components/mds-pref-theme/mds-pref-theme.d.ts +24 -2
  1410. package/dist/types/components/mds-pref-theme-item/mds-pref-theme-item.d.ts +1 -0
  1411. package/dist/types/components/mds-price-table-list/mds-price-table-list.d.ts +1 -0
  1412. package/dist/types/components/mds-price-table-list-item/mds-price-table-list-item.d.ts +1 -0
  1413. package/dist/types/components/mds-progress/mds-progress.d.ts +14 -4
  1414. package/dist/types/components/mds-push-notification/mds-push-notification.d.ts +4 -9
  1415. package/dist/types/components/mds-push-notification-item/mds-push-notification-item.d.ts +5 -2
  1416. package/dist/types/components/mds-radial-menu/mds-radial-menu.d.ts +12 -5
  1417. package/dist/types/components/mds-status-bar/mds-status-bar.d.ts +1 -2
  1418. package/dist/types/components/mds-stepper-bar/mds-stepper-bar.d.ts +4 -3
  1419. package/dist/types/components/mds-stepper-bar-item/mds-stepper-bar-item.d.ts +10 -2
  1420. package/dist/types/components/mds-tab/mds-tab.d.ts +8 -0
  1421. package/dist/types/components/mds-tab-bar-item/mds-tab-bar-item.d.ts +4 -3
  1422. package/dist/types/components/mds-tab-item/mds-tab-item.d.ts +3 -0
  1423. package/dist/types/components/mds-table/mds-table.d.ts +23 -3
  1424. package/dist/types/components/mds-table/meta/type.d.ts +1 -0
  1425. package/dist/types/components/mds-table-footer/mds-table-footer.d.ts +9 -1
  1426. package/dist/types/components/mds-table-header/mds-table-header.d.ts +9 -1
  1427. package/dist/types/components/mds-table-header-cell/mds-table-header-cell.d.ts +38 -14
  1428. package/dist/types/components/mds-table-header-cell/meta/event-detail.d.ts +6 -0
  1429. package/dist/types/components/mds-table-row/mds-table-row.d.ts +1 -0
  1430. package/dist/types/components/mds-text/mds-text.d.ts +8 -4
  1431. package/dist/types/components/mds-toast/mds-toast.d.ts +39 -8
  1432. package/dist/types/components/mds-toast/meta/event-detail.d.ts +3 -0
  1433. package/dist/types/components/mds-toast-region/mds-toast-region.d.ts +36 -0
  1434. package/dist/types/components/mds-tooltip/mds-tooltip.d.ts +32 -6
  1435. package/dist/types/components/mds-tree/mds-tree.d.ts +12 -2
  1436. package/dist/types/components/mds-tree-item/mds-tree-item.d.ts +7 -3
  1437. package/dist/types/components/mds-url-view/mds-url-view.d.ts +2 -1
  1438. package/dist/types/components/mds-usage/mds-usage.d.ts +8 -1
  1439. package/dist/types/components/mds-usage/meta/variants.d.ts +7 -19
  1440. package/dist/types/components.d.ts +376 -137
  1441. package/dist/types/stencil-public-runtime.d.ts +61 -55
  1442. package/dist/types/type/floating-ui.d.ts +2 -0
  1443. package/dist/types/type/input.d.ts +3 -0
  1444. package/package.json +30 -29
  1445. package/dist/cjs/_commonjsHelpers-B83fTs8d.js +0 -36
  1446. package/dist/cjs/browser-C1BdXKu5.js +0 -10
  1447. package/dist/cjs/keyboard-manager-C_Eaxw-C.js +0 -52
  1448. package/dist/collection/components/mds-avatar/meta/variants.js +0 -20
  1449. package/dist/collection/dictionary/icon.js +0 -10
  1450. package/dist/collection/type/icon.js +0 -1
  1451. package/dist/components/p-B3Z2Goa-.js +0 -1
  1452. package/dist/components/p-B3dWp2vS.js +0 -1
  1453. package/dist/components/p-B6FOPjps.js +0 -1
  1454. package/dist/components/p-B7CR1EtF.js +0 -1
  1455. package/dist/components/p-BBPQjm8h.js +0 -1
  1456. package/dist/components/p-BCiJ4PRD.js +0 -1
  1457. package/dist/components/p-BHJDW5JC.js +0 -1
  1458. package/dist/components/p-BSs0SO-j.js +0 -1
  1459. package/dist/components/p-BTpjOy0A.js +0 -1
  1460. package/dist/components/p-BY6Qu1V4.js +0 -1
  1461. package/dist/components/p-BhmePCyA.js +0 -1
  1462. package/dist/components/p-BpGzrg1C.js +0 -1
  1463. package/dist/components/p-C-J9fW51.js +0 -1
  1464. package/dist/components/p-CAa2kI72.js +0 -1
  1465. package/dist/components/p-CBV19-8O.js +0 -1
  1466. package/dist/components/p-CCv9tBZK.js +0 -1
  1467. package/dist/components/p-CDf607TB.js +0 -1
  1468. package/dist/components/p-CEMAGNly.js +0 -1
  1469. package/dist/components/p-CGYDZBMv.js +0 -1
  1470. package/dist/components/p-CHAGzQT-.js +0 -1
  1471. package/dist/components/p-CHAvkoj3.js +0 -1
  1472. package/dist/components/p-CMFUEkte.js +0 -1
  1473. package/dist/components/p-CR2GGKXK.js +0 -1
  1474. package/dist/components/p-CSCy6TMW.js +0 -1
  1475. package/dist/components/p-Cb5kuO7B.js +0 -1
  1476. package/dist/components/p-CiNNzAa3.js +0 -1
  1477. package/dist/components/p-CsgCQiHG.js +0 -1
  1478. package/dist/components/p-DGDdPv_Y.js +0 -1
  1479. package/dist/components/p-D_wD-Pyk.js +0 -1
  1480. package/dist/components/p-Dje8Mggf.js +0 -1
  1481. package/dist/components/p-E-ZsRS8r.js +0 -1
  1482. package/dist/components/p-HR2JwDjG.js +0 -1
  1483. package/dist/components/p-KRu9I7dw.js +0 -1
  1484. package/dist/components/p-LE7qQIFR.js +0 -8
  1485. package/dist/components/p-pBvN1uAc.js +0 -3
  1486. package/dist/components/p-vgIKH234.js +0 -1
  1487. package/dist/esm/_commonjsHelpers-E-ZsRS8r.js +0 -32
  1488. package/dist/esm/aria-CSCy6TMW.js +0 -45
  1489. package/dist/esm/browser-Dje8Mggf.js +0 -8
  1490. package/dist/esm/keyboard-manager-KRu9I7dw.js +0 -50
  1491. package/dist/esm-es5/_commonjsHelpers-E-ZsRS8r.js +0 -1
  1492. package/dist/esm-es5/aria-CSCy6TMW.js +0 -1
  1493. package/dist/esm-es5/browser-Dje8Mggf.js +0 -1
  1494. package/dist/esm-es5/keyboard-manager-KRu9I7dw.js +0 -5
  1495. package/dist/esm-es5/locale.it-Cvxh7La5.js +0 -6
  1496. package/dist/esm-es5/slot-C0o_l0td.js +0 -23
  1497. package/dist/magma-components/p-019e8a95.system.entry.js +0 -13
  1498. package/dist/magma-components/p-01dd1f55.entry.js +0 -1
  1499. package/dist/magma-components/p-02119624.system.entry.js +0 -40
  1500. package/dist/magma-components/p-02fc7592.entry.js +0 -1
  1501. package/dist/magma-components/p-03cd0069.system.entry.js +0 -1
  1502. package/dist/magma-components/p-05fbca60.system.entry.js +0 -37
  1503. package/dist/magma-components/p-06d9af89.entry.js +0 -1
  1504. package/dist/magma-components/p-07e4701d.entry.js +0 -1
  1505. package/dist/magma-components/p-081a19b1.system.entry.js +0 -45
  1506. package/dist/magma-components/p-09d0b6a8.entry.js +0 -1
  1507. package/dist/magma-components/p-0b300de7.entry.js +0 -1
  1508. package/dist/magma-components/p-0d3c3de9.entry.js +0 -1
  1509. package/dist/magma-components/p-1150ffb8.system.entry.js +0 -10
  1510. package/dist/magma-components/p-115a5e47.entry.js +0 -1
  1511. package/dist/magma-components/p-1314d80e.entry.js +0 -1
  1512. package/dist/magma-components/p-133a6ffd.system.entry.js +0 -49
  1513. package/dist/magma-components/p-13db55de.entry.js +0 -1
  1514. package/dist/magma-components/p-1a2731ec.system.entry.js +0 -10
  1515. package/dist/magma-components/p-1a602906.system.entry.js +0 -13
  1516. package/dist/magma-components/p-1c975156.entry.js +0 -1
  1517. package/dist/magma-components/p-1d154234.system.entry.js +0 -12
  1518. package/dist/magma-components/p-1d9d7666.entry.js +0 -1
  1519. package/dist/magma-components/p-1ddaaa6d.system.entry.js +0 -217
  1520. package/dist/magma-components/p-21aa0a74.entry.js +0 -1
  1521. package/dist/magma-components/p-21c46e74.system.entry.js +0 -4
  1522. package/dist/magma-components/p-2399b7e8.entry.js +0 -1
  1523. package/dist/magma-components/p-25407d89.entry.js +0 -1
  1524. package/dist/magma-components/p-27547a7a.system.entry.js +0 -7
  1525. package/dist/magma-components/p-289a874e.entry.js +0 -1
  1526. package/dist/magma-components/p-2be3bd23.system.entry.js +0 -1
  1527. package/dist/magma-components/p-2c586431.entry.js +0 -1
  1528. package/dist/magma-components/p-2d324edc.entry.js +0 -1
  1529. package/dist/magma-components/p-2da2cdf3.system.entry.js +0 -7
  1530. package/dist/magma-components/p-2e01e057.system.entry.js +0 -7
  1531. package/dist/magma-components/p-2e9b80e8.entry.js +0 -1
  1532. package/dist/magma-components/p-30c3872d.entry.js +0 -1
  1533. package/dist/magma-components/p-3231a6a3.entry.js +0 -1
  1534. package/dist/magma-components/p-32361702.system.entry.js +0 -7
  1535. package/dist/magma-components/p-3448d0ce.entry.js +0 -1
  1536. package/dist/magma-components/p-367cee40.system.entry.js +0 -1
  1537. package/dist/magma-components/p-3a8870e4.system.entry.js +0 -47
  1538. package/dist/magma-components/p-3b68fbcd.system.entry.js +0 -22
  1539. package/dist/magma-components/p-3ecade3c.system.entry.js +0 -11
  1540. package/dist/magma-components/p-4073c5f2.system.entry.js +0 -90
  1541. package/dist/magma-components/p-40bd2e6d.entry.js +0 -1
  1542. package/dist/magma-components/p-423597db.system.entry.js +0 -4
  1543. package/dist/magma-components/p-443c2a29.system.entry.js +0 -10
  1544. package/dist/magma-components/p-45a91f1c.system.entry.js +0 -1
  1545. package/dist/magma-components/p-487af9d3.entry.js +0 -1
  1546. package/dist/magma-components/p-4909070e.entry.js +0 -1
  1547. package/dist/magma-components/p-4d966161.system.entry.js +0 -14
  1548. package/dist/magma-components/p-4ddf891e.system.entry.js +0 -69
  1549. package/dist/magma-components/p-4e15cde7.entry.js +0 -1
  1550. package/dist/magma-components/p-4f14a166.entry.js +0 -1
  1551. package/dist/magma-components/p-4ffec31a.system.entry.js +0 -1
  1552. package/dist/magma-components/p-4oB0woT9.system.js +0 -6
  1553. package/dist/magma-components/p-50b266e9.system.entry.js +0 -4
  1554. package/dist/magma-components/p-5165b09f.system.entry.js +0 -4
  1555. package/dist/magma-components/p-544cc9c7.system.entry.js +0 -25
  1556. package/dist/magma-components/p-562bb482.system.entry.js +0 -16
  1557. package/dist/magma-components/p-5ac9e2f4.entry.js +0 -1
  1558. package/dist/magma-components/p-5ae5ec95.entry.js +0 -1
  1559. package/dist/magma-components/p-5d2d8ffe.system.entry.js +0 -11
  1560. package/dist/magma-components/p-5e180f53.system.entry.js +0 -32
  1561. package/dist/magma-components/p-61ff1d85.system.entry.js +0 -1
  1562. package/dist/magma-components/p-62b17608.system.entry.js +0 -102
  1563. package/dist/magma-components/p-63e7c98f.entry.js +0 -1
  1564. package/dist/magma-components/p-6474c850.entry.js +0 -8
  1565. package/dist/magma-components/p-660657ac.system.entry.js +0 -15
  1566. package/dist/magma-components/p-66237a64.entry.js +0 -1
  1567. package/dist/magma-components/p-6702e489.entry.js +0 -1
  1568. package/dist/magma-components/p-694ed534.entry.js +0 -1
  1569. package/dist/magma-components/p-6b446fd9.system.entry.js +0 -81
  1570. package/dist/magma-components/p-6c414bc2.system.entry.js +0 -19
  1571. package/dist/magma-components/p-6cbd8a6d.system.entry.js +0 -12
  1572. package/dist/magma-components/p-6d0dc1fd.entry.js +0 -1
  1573. package/dist/magma-components/p-6ed05d99.entry.js +0 -1
  1574. package/dist/magma-components/p-6f2471b1.entry.js +0 -1
  1575. package/dist/magma-components/p-6fa03aab.system.entry.js +0 -7
  1576. package/dist/magma-components/p-70141ccd.entry.js +0 -1
  1577. package/dist/magma-components/p-707d8626.system.entry.js +0 -2838
  1578. package/dist/magma-components/p-71dafc3f.entry.js +0 -1
  1579. package/dist/magma-components/p-726209f4.system.entry.js +0 -1
  1580. package/dist/magma-components/p-745ee76b.system.entry.js +0 -32
  1581. package/dist/magma-components/p-761415b3.system.entry.js +0 -37
  1582. package/dist/magma-components/p-771720b7.entry.js +0 -18
  1583. package/dist/magma-components/p-7a7c308b.entry.js +0 -1
  1584. package/dist/magma-components/p-7bea6c05.system.entry.js +0 -10
  1585. package/dist/magma-components/p-7ca990d4.system.entry.js +0 -11
  1586. package/dist/magma-components/p-7d6ca97d.system.entry.js +0 -7
  1587. package/dist/magma-components/p-7ffda4f5.entry.js +0 -1
  1588. package/dist/magma-components/p-8097dfc8.system.entry.js +0 -7
  1589. package/dist/magma-components/p-809adece.system.entry.js +0 -17
  1590. package/dist/magma-components/p-843ab1b4.entry.js +0 -1
  1591. package/dist/magma-components/p-87026d34.entry.js +0 -1
  1592. package/dist/magma-components/p-8765dc11.entry.js +0 -1
  1593. package/dist/magma-components/p-87faaa8e.system.entry.js +0 -16
  1594. package/dist/magma-components/p-8a838a1a.entry.js +0 -1
  1595. package/dist/magma-components/p-8bcb2a5f.entry.js +0 -1
  1596. package/dist/magma-components/p-8ca1d30d.system.entry.js +0 -1
  1597. package/dist/magma-components/p-91c4015f.system.entry.js +0 -4
  1598. package/dist/magma-components/p-91c8960a.system.entry.js +0 -1
  1599. package/dist/magma-components/p-932620b6.entry.js +0 -1
  1600. package/dist/magma-components/p-939da879.system.entry.js +0 -8
  1601. package/dist/magma-components/p-97bde480.entry.js +0 -1
  1602. package/dist/magma-components/p-97d02403.entry.js +0 -1
  1603. package/dist/magma-components/p-983f3e40.entry.js +0 -1
  1604. package/dist/magma-components/p-99227c78.system.entry.js +0 -11
  1605. package/dist/magma-components/p-9a583f6b.system.entry.js +0 -1
  1606. package/dist/magma-components/p-9a86e0ce.system.entry.js +0 -1
  1607. package/dist/magma-components/p-9d1cdb42.system.entry.js +0 -15
  1608. package/dist/magma-components/p-9e5982b6.entry.js +0 -1
  1609. package/dist/magma-components/p-9eb1e154.system.entry.js +0 -14
  1610. package/dist/magma-components/p-9eef2f79.entry.js +0 -1
  1611. package/dist/magma-components/p-9fe14430.system.entry.js +0 -7
  1612. package/dist/magma-components/p-9fe7035a.entry.js +0 -1
  1613. package/dist/magma-components/p-B6mQg6yQ.js +0 -1
  1614. package/dist/magma-components/p-BJtA1qmE.js +0 -1
  1615. package/dist/magma-components/p-BpVYIPkx.js +0 -1
  1616. package/dist/magma-components/p-BxPbQB28.js +0 -3
  1617. package/dist/magma-components/p-C0o_l0td.js +0 -1
  1618. package/dist/magma-components/p-CHAGzQT-.js +0 -1
  1619. package/dist/magma-components/p-CSCy6TMW.js +0 -1
  1620. package/dist/magma-components/p-CYRMc5KW.system.js +0 -1
  1621. package/dist/magma-components/p-DIUTGDX_.system.js +0 -1
  1622. package/dist/magma-components/p-Dg8nxRUX.system.js +0 -201
  1623. package/dist/magma-components/p-Dje8Mggf.js +0 -1
  1624. package/dist/magma-components/p-E-ZsRS8r.js +0 -1
  1625. package/dist/magma-components/p-KRu9I7dw.js +0 -1
  1626. package/dist/magma-components/p-LerCJgfP.system.js +0 -5
  1627. package/dist/magma-components/p-ZDRIVCAt.system.js +0 -5
  1628. package/dist/magma-components/p-a0972ec9.entry.js +0 -1
  1629. package/dist/magma-components/p-a1851e6f.entry.js +0 -1
  1630. package/dist/magma-components/p-a1b5bd58.entry.js +0 -1
  1631. package/dist/magma-components/p-a2d9549d.system.entry.js +0 -32
  1632. package/dist/magma-components/p-a5a13b20.entry.js +0 -1
  1633. package/dist/magma-components/p-a6a71c77.entry.js +0 -1
  1634. package/dist/magma-components/p-a96312c1.entry.js +0 -1
  1635. package/dist/magma-components/p-aa0bd826.entry.js +0 -1
  1636. package/dist/magma-components/p-aa74169f.system.entry.js +0 -1
  1637. package/dist/magma-components/p-ab4ffbd4.system.entry.js +0 -68
  1638. package/dist/magma-components/p-ad9cb1f5.entry.js +0 -1
  1639. package/dist/magma-components/p-aed8b119.entry.js +0 -1
  1640. package/dist/magma-components/p-afbef2fc.entry.js +0 -1
  1641. package/dist/magma-components/p-b183d698.system.entry.js +0 -16
  1642. package/dist/magma-components/p-b49196da.entry.js +0 -1
  1643. package/dist/magma-components/p-b77a2832.entry.js +0 -1
  1644. package/dist/magma-components/p-b925c109.system.entry.js +0 -14
  1645. package/dist/magma-components/p-b9e3281a.system.entry.js +0 -72
  1646. package/dist/magma-components/p-bb0538b6.entry.js +0 -1
  1647. package/dist/magma-components/p-bb055583.entry.js +0 -1
  1648. package/dist/magma-components/p-bc6a41a9.system.entry.js +0 -1
  1649. package/dist/magma-components/p-bd9324f3.system.entry.js +0 -1
  1650. package/dist/magma-components/p-c4ccb710.entry.js +0 -1
  1651. package/dist/magma-components/p-c4e4ba90.system.entry.js +0 -38
  1652. package/dist/magma-components/p-c573e136.entry.js +0 -1
  1653. package/dist/magma-components/p-c5ad848f.entry.js +0 -1
  1654. package/dist/magma-components/p-c6841b21.entry.js +0 -1
  1655. package/dist/magma-components/p-c89a44b2.entry.js +0 -1
  1656. package/dist/magma-components/p-c94575de.entry.js +0 -1
  1657. package/dist/magma-components/p-cabe9133.system.entry.js +0 -4
  1658. package/dist/magma-components/p-cb2c5f1b.entry.js +0 -1
  1659. package/dist/magma-components/p-cb571b55.system.entry.js +0 -1
  1660. package/dist/magma-components/p-cbc0f01f.system.entry.js +0 -17
  1661. package/dist/magma-components/p-cc1ee10a.system.entry.js +0 -20
  1662. package/dist/magma-components/p-cd1dc29a.entry.js +0 -1
  1663. package/dist/magma-components/p-cd5cf28b.system.entry.js +0 -1
  1664. package/dist/magma-components/p-cd952369.entry.js +0 -1
  1665. package/dist/magma-components/p-d35aebe5.entry.js +0 -1
  1666. package/dist/magma-components/p-d74fa7af.entry.js +0 -1
  1667. package/dist/magma-components/p-d7515aae.entry.js +0 -1
  1668. package/dist/magma-components/p-d7a94afb.system.entry.js +0 -7
  1669. package/dist/magma-components/p-d93c9a11.system.entry.js +0 -89
  1670. package/dist/magma-components/p-d9fbbf3f.entry.js +0 -1
  1671. package/dist/magma-components/p-db492cf5.system.entry.js +0 -13
  1672. package/dist/magma-components/p-dc06b29e.entry.js +0 -1
  1673. package/dist/magma-components/p-dc7bada4.entry.js +0 -1
  1674. package/dist/magma-components/p-dfb4a965.system.entry.js +0 -28
  1675. package/dist/magma-components/p-e1a91e9e.system.entry.js +0 -1
  1676. package/dist/magma-components/p-e2ef1d6f.entry.js +0 -1
  1677. package/dist/magma-components/p-e5438280.system.entry.js +0 -10
  1678. package/dist/magma-components/p-e8cd2b93.system.entry.js +0 -4
  1679. package/dist/magma-components/p-e95f2a48.entry.js +0 -1
  1680. package/dist/magma-components/p-eb113725.system.entry.js +0 -1
  1681. package/dist/magma-components/p-ec5eccbb.entry.js +0 -1
  1682. package/dist/magma-components/p-eca99a0a.system.entry.js +0 -1
  1683. package/dist/magma-components/p-ed897f9f.entry.js +0 -1
  1684. package/dist/magma-components/p-eea815ca.system.entry.js +0 -16
  1685. package/dist/magma-components/p-ef4cd904.system.entry.js +0 -16
  1686. package/dist/magma-components/p-eff1fd6c.system.entry.js +0 -15
  1687. package/dist/magma-components/p-eff38775.entry.js +0 -1
  1688. package/dist/magma-components/p-f01874a8.entry.js +0 -1
  1689. package/dist/magma-components/p-f05d7005.entry.js +0 -1
  1690. package/dist/magma-components/p-f0c67a70.system.entry.js +0 -15
  1691. package/dist/magma-components/p-f215496c.entry.js +0 -1
  1692. package/dist/magma-components/p-f28cfb33.system.entry.js +0 -4
  1693. package/dist/magma-components/p-f830793e.entry.js +0 -1
  1694. package/dist/magma-components/p-f835c307.system.entry.js +0 -7
  1695. package/dist/magma-components/p-f89c3a01.system.entry.js +0 -32
  1696. package/dist/magma-components/p-f8eb19b3.entry.js +0 -1
  1697. package/dist/magma-components/p-f8feee93.system.entry.js +0 -4
  1698. package/dist/magma-components/p-f97b4ff4.system.entry.js +0 -16
  1699. package/dist/magma-components/p-fc8f8a0c.entry.js +0 -1
  1700. package/dist/magma-components/p-fcaa5967.entry.js +0 -18
  1701. package/dist/magma-components/p-ff970859.system.entry.js +0 -30
  1702. package/dist/magma-components/p-lozaO1BU.system.js +0 -1
  1703. package/dist/types/components/mds-avatar/meta/variants.d.ts +0 -2
  1704. package/dist/types/dictionary/icon.d.ts +0 -4
  1705. package/dist/types/type/icon.d.ts +0 -1
@@ -1,8 +1,8 @@
1
1
  {
2
- "timestamp": "2026-10-14T12:22:32",
2
+ "timestamp": "2026-10-20T14:19:46",
3
3
  "compiler": {
4
4
  "name": "@stencil/core",
5
- "version": "4.44.2",
5
+ "version": "4.45.2",
6
6
  "typescriptVersion": "5.8.3"
7
7
  },
8
8
  "components": [
@@ -13,9 +13,9 @@
13
13
  "docs": "",
14
14
  "docsTags": [],
15
15
  "usage": {
16
- "1. Description": "The `<mds-pref-language-item>` web component represents a single selectable language option inside the language-preference picker [`<mds-pref-language>`](../mds-pref-language/AGENTS.md). It renders one row of the parent's dropdown and reports the user's choice up to the parent rather than changing the page language itself.\n\n#### Semantic Behavior\n\n- **Compound child only**: Must be placed as a direct default-slot child of `<mds-pref-language>`; it is not used standalone or mixed with other child types.\n- **Code validation**: `code` must match an entry in the bundled language dictionary; an unknown `code` throws `Language code not found: <code>`. When `code` is empty the item renders an error-toned fallback button instead of a language label.\n- **Label is derived, not authored**: The visible language name is looked up from `code` (e.g. `it` to `Italiano`), so consumers supply only the code, not the display text.\n- **Selection is parent-driven**: The `selected` prop is owned and toggled by `<mds-pref-language>`, which clears every sibling and sets only the active item.\n- **Click emits, does not commit**: Clicking the item emits the bubbling `mdsPrefLanguageItemSelect` event carrying `{ language: code }`. The parent updates selection state, persists the preference, applies the document language, and emits its own `mdsPrefLanguageChange` - this child performs none of that.\n\n#### Properties & Visual Configurations\n\nThe only meaningful prop is `code`: the BCP 47 / RFC 5646 language tag (such as `it`, `en`, `es`) that both keys the label lookup and is the payload emitted on selection. The accepted codes are the keys of the bundled language dictionary: the two-letter ISO 639-1 codes (`it`, `en`, `fr`, `de`, `zh`, ...) plus `ceb`, `haw` and `hmn`, which the parent cannot apply (its `set` accepts only `xx` / `xx-XX` codes).\n\n`selected` is a state flag managed by the parent rather than a configuration choice. Sizing and styling are fixed by the parent's layout, so this item exposes no `variant` / `tone` of its own; the shared ladders in [`agents/variants.md`](../../../../agents/variants.md) are applied internally and are not configurable from the host.\n",
16
+ "1. Description": "The `<mds-pref-language-item>` web component represents a single selectable language option inside the language-preference picker [`<mds-pref-language>`](../mds-pref-language/AGENTS.md). It renders one row of the parent's dropdown and reports the user's choice up to the parent rather than changing the page language itself.\n\n#### Semantic Behavior\n\n- **Compound child only**: Must be placed as a direct default-slot child of `<mds-pref-language>`; it is not used standalone or mixed with other child types.\n- **Code validation**: `code` must match an entry in the bundled language dictionary; an unknown `code` logs a console warning and the item shows the code itself in place of a language name. When `code` is empty the item renders an error-toned fallback button instead of a language label.\n- **Label is derived, not authored**: The visible language name is looked up from `code` (e.g. `it` to `Italiano`), so consumers supply only the code, not the display text.\n- **Selection is parent-driven**: The `selected` prop is owned and toggled by `<mds-pref-language>`, which clears every sibling and sets only the active item.\n- **Click emits, does not commit**: Clicking the item emits the bubbling `mdsPrefLanguageItemSelect` event carrying `{ language: code }`. The parent updates selection state, persists the preference, applies the document language, and emits its own `mdsPrefLanguageChange` - this child performs none of that.\n\n#### Properties & Visual Configurations\n\nThe only meaningful prop is `code`: the BCP 47 / RFC 5646 language tag (such as `it`, `en`, `es`) that both keys the label lookup and is the payload emitted on selection. The accepted codes are the keys of the bundled language dictionary: the two-letter ISO 639-1 codes (`it`, `en`, `fr`, `de`, `zh`, ...) plus `ceb`, `haw` and `hmn`, which the parent cannot apply (its `set` accepts only `xx` / `xx-XX` codes).\n\n`selected` is a state flag managed by the parent rather than a configuration choice. Sizing and styling are fixed by the parent's layout, so this item exposes no `variant` / `tone` of its own; the shared ladders in [`agents/variants.md`](../../../../agents/variants.md) are applied internally and are not configurable from the host.\n",
17
17
  "2. Pattern": "Correct and idiomatic ways to use the `<mds-pref-language-item>` component, ordered from most common to most specialized. Patterns assume a working knowledge of the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Basic Language List Inside the Parent\n\nThe canonical form. Place one `<mds-pref-language-item>` per supported language as a direct child of [`<mds-pref-language>`](../mds-pref-language/AGENTS.md). Set `code` to a BCP 47 tag that exists in the bundled dictionary; the component resolves the display name automatically.\n\n```html\n<mds-pref-language>\n <mds-pref-language-item code=\"it\"></mds-pref-language-item>\n <mds-pref-language-item code=\"en\"></mds-pref-language-item>\n <mds-pref-language-item code=\"fr\"></mds-pref-language-item>\n</mds-pref-language>\n```\n\n#### Pre-selecting the Active Language\n\nPre-select through the parent, not through `selected`: `<mds-pref-language>` marks the item whose `code` matches its resolved language when it loads, and overwrites any `selected` written in the markup. Pass the language to the parent's `set` (or leave `set` on `auto`).\n\n```html\n<mds-pref-language set=\"it\">\n <mds-pref-language-item code=\"it\"></mds-pref-language-item>\n <mds-pref-language-item code=\"en\"></mds-pref-language-item>\n <mds-pref-language-item code=\"de\"></mds-pref-language-item>\n</mds-pref-language>\n```\n\n#### Listening for a Language Selection\n\nThe item emits `mdsPrefLanguageItemSelect` with `{ language: code }` when clicked. In most cases you should listen on the parent (`mdsPrefLanguageChange`) rather than on individual items - but listening on the item directly is valid when you need fine-grained control.\n\n```html\n<mds-pref-language>\n <mds-pref-language-item code=\"it\" id=\"lang-it\"></mds-pref-language-item>\n <mds-pref-language-item code=\"en\" id=\"lang-en\"></mds-pref-language-item>\n</mds-pref-language>\n\n<script>\n document.querySelectorAll('mds-pref-language-item').forEach((item) => {\n item.addEventListener('mdsPrefLanguageItemSelect', (e) => {\n console.log('Lingua scelta:', e.detail.language);\n });\n });\n</script>\n```\n\n#### Offering a Large Language Set\n\nAdd as many items as needed - the parent lists them all in its dropdown. Each item only needs a `code`; the visible label is derived automatically.\n\n```html\n<mds-pref-language>\n <mds-pref-language-item code=\"it\"></mds-pref-language-item>\n <mds-pref-language-item code=\"en\"></mds-pref-language-item>\n <mds-pref-language-item code=\"es\"></mds-pref-language-item>\n <mds-pref-language-item code=\"fr\"></mds-pref-language-item>\n <mds-pref-language-item code=\"de\"></mds-pref-language-item>\n <mds-pref-language-item code=\"pt\"></mds-pref-language-item>\n <mds-pref-language-item code=\"zh\"></mds-pref-language-item>\n <mds-pref-language-item code=\"ar\"></mds-pref-language-item>\n</mds-pref-language>\n```\n\n#### Inside a Full Preferences Panel\n\n`<mds-pref-language>` and its items compose inside [`<mds-pref>`](../mds-pref/AGENTS.md) alongside the other preference controls. Place them as direct children of `<mds-pref>`.\n\n```html\n<mds-pref>\n <mds-pref-mode></mds-pref-mode>\n <mds-pref-contrast></mds-pref-contrast>\n <mds-pref-language>\n <mds-pref-language-item code=\"it\"></mds-pref-language-item>\n <mds-pref-language-item code=\"en\"></mds-pref-language-item>\n </mds-pref-language>\n</mds-pref>\n```\n",
18
- "3. Antipattern": "Common incorrect uses of `<mds-pref-language-item>`. 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 Use the Item Outside Its Parent\n\n`<mds-pref-language-item>` is a compound child and relies on `<mds-pref-language>` for selection management, dropdown layout, and language persistence. Using it standalone leaves the click handler dangling and the selection state unmanaged.\n\n```html\n<!-- INCORRECT -->\n<mds-pref-language-item code=\"it\"></mds-pref-language-item>\n\n<!-- CORRECT -->\n<mds-pref-language>\n <mds-pref-language-item code=\"it\"></mds-pref-language-item>\n</mds-pref-language>\n```\n\n#### Do Not Set the Display Label Manually\n\nThe item derives its label from the `code` prop via the bundled dictionary. Attempting to pass display text in the default slot or as an attribute is not supported and will be ignored by the render function.\n\n```html\n<!-- INCORRECT -->\n<mds-pref-language-item code=\"it\">Italiano</mds-pref-language-item>\n\n<!-- CORRECT -->\n<mds-pref-language-item code=\"it\"></mds-pref-language-item>\n```\n\n#### Do Not Use an Undocumented or Misspelled Language Code\n\n`code` must exactly match a key in the bundled dictionary (e.g. `\"it\"`, `\"en\"`, `\"fr\"`). An unknown code throws `Language code not found: <code>` when the item loads or its `code` changes. Use the two-letter BCP 47 tag, not a locale variant like `\"it-IT\"`.\n\n```html\n<!-- INCORRECT -->\n<mds-pref-language-item code=\"it-IT\"></mds-pref-language-item>\n<mds-pref-language-item code=\"italian\"></mds-pref-language-item>\n\n<!-- CORRECT -->\n<mds-pref-language-item code=\"it\"></mds-pref-language-item>\n```\n\n#### Do Not Manage the `selected` Prop by Hand Across Items\n\nThe parent marks only the item matching the active language when it loads, overwriting the `selected` written in the markup, and clears every sibling on each pick. If you toggle `selected` yourself from script, several items can show as selected at once, out of step with the stored preference.\n\n```html\n<!-- INCORRECT -->\n<mds-pref-language>\n <mds-pref-language-item code=\"it\" selected></mds-pref-language-item>\n <mds-pref-language-item code=\"en\" selected></mds-pref-language-item>\n</mds-pref-language>\n\n<!-- CORRECT -->\n<mds-pref-language set=\"it\">\n <mds-pref-language-item code=\"it\"></mds-pref-language-item>\n <mds-pref-language-item code=\"en\"></mds-pref-language-item>\n</mds-pref-language>\n```\n\n#### Do Not Listen for Native `click` to Detect Language Selection\n\nThe component emits `mdsPrefLanguageItemSelect` (or the parent emits `mdsPrefLanguageChange`). A native `click` carries no `detail`, so it skips the event payload that carries the selected language code, and it does not tell you that the parent has committed the pick.\n\n```html\n<!-- INCORRECT -->\n<script>\n document.querySelector('mds-pref-language-item').addEventListener('click', () => {\n // no language code available here\n });\n</script>\n\n<!-- CORRECT -->\n<script>\n document.querySelector('mds-pref-language').addEventListener('mdsPrefLanguageChange', (e) => {\n console.log('Lingua selezionata:', e.detail.language);\n });\n</script>\n```\n\n#### Do Not Set `selected=\"false\"` to Deselect\n\n`selected` is a boolean attribute: a false boolean is written by removing the attribute ([`agents/conventions.md`](../../../../agents/conventions.md)), or by setting the prop to `false` from script. Stencil does parse `\"false\"` as `false`, but the attribute stays in the markup until the component hydrates and its reflection removes it, so a `[selected]` selector or any code reading the attribute sees it set in the meantime. Inside `<mds-pref-language>` the parent owns `selected` anyway.\n\n```html\n<!-- INCORRECT -->\n<mds-pref-language-item code=\"it\" selected=\"false\"></mds-pref-language-item>\n\n<!-- CORRECT -->\n<mds-pref-language-item code=\"it\"></mds-pref-language-item>\n```\n"
18
+ "3. Antipattern": "Common incorrect uses of `<mds-pref-language-item>`. 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 Use the Item Outside Its Parent\n\n`<mds-pref-language-item>` is a compound child and relies on `<mds-pref-language>` for selection management, dropdown layout, and language persistence. Using it standalone leaves the click handler dangling and the selection state unmanaged.\n\n```html\n<!-- INCORRECT -->\n<mds-pref-language-item code=\"it\"></mds-pref-language-item>\n\n<!-- CORRECT -->\n<mds-pref-language>\n <mds-pref-language-item code=\"it\"></mds-pref-language-item>\n</mds-pref-language>\n```\n\n#### Do Not Set the Display Label Manually\n\nThe item derives its label from the `code` prop via the bundled dictionary. Attempting to pass display text in the default slot or as an attribute is not supported and will be ignored by the render function.\n\n```html\n<!-- INCORRECT -->\n<mds-pref-language-item code=\"it\">Italiano</mds-pref-language-item>\n\n<!-- CORRECT -->\n<mds-pref-language-item code=\"it\"></mds-pref-language-item>\n```\n\n#### Do Not Use an Undocumented or Misspelled Language Code\n\n`code` must exactly match a key in the bundled dictionary (e.g. `\"it\"`, `\"en\"`, `\"fr\"`). An unknown code logs a console warning when the item loads or its `code` changes, and the item shows the raw code instead of a language name. Use the two-letter BCP 47 tag, not a locale variant like `\"it-IT\"`.\n\n```html\n<!-- INCORRECT -->\n<mds-pref-language-item code=\"it-IT\"></mds-pref-language-item>\n<mds-pref-language-item code=\"italian\"></mds-pref-language-item>\n\n<!-- CORRECT -->\n<mds-pref-language-item code=\"it\"></mds-pref-language-item>\n```\n\n#### Do Not Manage the `selected` Prop by Hand Across Items\n\nThe parent marks only the item matching the active language when it loads, overwriting the `selected` written in the markup, and clears every sibling on each pick. If you toggle `selected` yourself from script, several items can show as selected at once, out of step with the stored preference.\n\n```html\n<!-- INCORRECT -->\n<mds-pref-language>\n <mds-pref-language-item code=\"it\" selected></mds-pref-language-item>\n <mds-pref-language-item code=\"en\" selected></mds-pref-language-item>\n</mds-pref-language>\n\n<!-- CORRECT -->\n<mds-pref-language set=\"it\">\n <mds-pref-language-item code=\"it\"></mds-pref-language-item>\n <mds-pref-language-item code=\"en\"></mds-pref-language-item>\n</mds-pref-language>\n```\n\n#### Do Not Listen for Native `click` to Detect Language Selection\n\nThe component emits `mdsPrefLanguageItemSelect` (or the parent emits `mdsPrefLanguageChange`). A native `click` carries no `detail`, so it skips the event payload that carries the selected language code, and it does not tell you that the parent has committed the pick.\n\n```html\n<!-- INCORRECT -->\n<script>\n document.querySelector('mds-pref-language-item').addEventListener('click', () => {\n // no language code available here\n });\n</script>\n\n<!-- CORRECT -->\n<script>\n document.querySelector('mds-pref-language').addEventListener('mdsPrefLanguageChange', (e) => {\n console.log('Lingua selezionata:', e.detail.language);\n });\n</script>\n```\n\n#### Do Not Set `selected=\"false\"` to Deselect\n\n`selected` is a boolean attribute: a false boolean is written by removing the attribute ([`agents/conventions.md`](../../../../agents/conventions.md)), or by setting the prop to `false` from script. Stencil does parse `\"false\"` as `false`, but the attribute stays in the markup until the component hydrates and its reflection removes it, so a `[selected]` selector or any code reading the attribute sees it set in the meantime. Inside `<mds-pref-language>` the parent owns `selected` anyway.\n\n```html\n<!-- INCORRECT -->\n<mds-pref-language-item code=\"it\" selected=\"false\"></mds-pref-language-item>\n\n<!-- CORRECT -->\n<mds-pref-language-item code=\"it\"></mds-pref-language-item>\n```\n"
19
19
  },
20
20
  "props": [
21
21
  {
@@ -30,7 +30,12 @@
30
30
  "attr": "code",
31
31
  "reflectToAttr": true,
32
32
  "docs": "Specifies the language code based on HTML `lang` attribute",
33
- "docsTags": [],
33
+ "docsTags": [
34
+ {
35
+ "name": "example",
36
+ "text": "'it'"
37
+ }
38
+ ],
34
39
  "values": [
35
40
  {
36
41
  "type": "string"
@@ -18,11 +18,11 @@ export class MdsPrefLanguageItem {
18
18
  // `code` is assigned asynchronously by framework wrappers (e.g. @lit/react sets it
19
19
  // as a property after the element connects), so it is briefly undefined on the first
20
20
  // render pass and the watcher re-validates once it lands. Only a non-empty,
21
- // unrecognized code is a real error; empty codes fall back to the `noCode` branch
22
- // already handled in render().
21
+ // unrecognized code is a mistake, and the item shows the code itself in place of the name
22
+ // it has not got; empty codes fall back to the `noCode` branch already handled in render().
23
23
  this.validateCode = (code) => {
24
24
  if (code != null && code !== '' && localeDefault[code] === undefined) {
25
- throw Error(`Language code not found: ${code}`);
25
+ console.warn(`mds-pref-language-item: no language name for the code "${code}"`);
26
26
  }
27
27
  };
28
28
  this.handleClick = () => {
@@ -36,11 +36,11 @@ export class MdsPrefLanguageItem {
36
36
  this.validateCode(newValue);
37
37
  }
38
38
  render() {
39
- var _a;
39
+ var _a, _b;
40
40
  return (
41
41
  // the item is an entry of the `menu` the mds-dropdown of the controller opens:
42
42
  // without the role axe rejects it as a child of that menu (aria-required-children)
43
- h(Host, { key: '714a3e699f569f51f26bed7040591e987db1f50b', onClick: this.handleClick, role: "menuitem" }, ((_a = this.code) !== null && _a !== void 0 ? _a : '') !== '' ? (h("mds-button", { icon: this.selected ? miBaselineCheckCircle : miOutlineCircle, variant: "dark", tone: "text", label: localeDefault[this.code] })) : (h("mds-button", { icon: miBaselineCheckCircle, variant: "error", tone: "text", label: this.t.get('noCode') }))));
43
+ h(Host, { key: '8cd1db27f65ac1b3e66c43135ff9de75628cb898', onClick: this.handleClick, role: "menuitem" }, ((_a = this.code) !== null && _a !== void 0 ? _a : '') !== '' ? (h("mds-button", { icon: this.selected ? miBaselineCheckCircle : miOutlineCircle, variant: "dark", tone: "text", label: (_b = localeDefault[this.code]) !== null && _b !== void 0 ? _b : this.code })) : (h("mds-button", { icon: miBaselineCheckCircle, variant: "error", tone: "text", label: this.t.get('noCode') }))));
44
44
  }
45
45
  static get is() { return "mds-pref-language-item"; }
46
46
  static get encapsulation() { return "shadow"; }
@@ -67,7 +67,10 @@ export class MdsPrefLanguageItem {
67
67
  "required": false,
68
68
  "optional": false,
69
69
  "docs": {
70
- "tags": [],
70
+ "tags": [{
71
+ "name": "example",
72
+ "text": "'it'"
73
+ }],
71
74
  "text": "Specifies the language code based on HTML `lang` attribute"
72
75
  },
73
76
  "getter": false,
@@ -6,26 +6,25 @@
6
6
 
7
7
  # mds-pref-mode
8
8
 
9
- > `@maggioli-design-system/magma` 2.2.0. Shadow DOM: style it only through the CSS custom properties and parts below.
9
+ > `@maggioli-design-system/magma` 2.4.0. Shadow DOM: style it only through the CSS custom properties and parts below.
10
10
 
11
- The `<mds-pref-mode>` web component is the mode preference control of the Magma Design System, designed to live as a direct child of [`<mds-pref>`](../mds-pref/AGENTS.md). It renders a labelled three-way tab (light / system / dark) that lets the user pick a color-scheme mode and applies it globally to the document.
11
+ The `<mds-pref-mode>` web component is the mode preference control of the Magma Design System, usually a direct child of the [`<mds-pref>`](../mds-pref/AGENTS.md) panel. It renders a labelled three-way tab (light / system / dark) that lets the user pick a color-scheme mode and applies it globally to the document.
12
12
 
13
13
  #### Semantic Behavior
14
14
 
15
- - **Compound child only**: It is meant to be placed directly in the default slot of `<mds-pref>` alongside the other `mds-pref-*` preference children; it is not used standalone or mixed with unrelated child types.
15
+ - **Usually inside `<mds-pref>`**: Placed as a direct slot child of `<mds-pref>`, alongside the other `mds-pref-*` controls; it also works on its own, since it applies and stores the mode by itself. What it gives up on its own is in the antipattern docs.
16
16
  - **Selection follows `mode`**: The active tab reflects whichever mode is currently applied, driven by the `mode` prop.
17
17
  - **Global mode application**: Selecting a mode applies it document-wide and persists the choice.
18
18
  - **Persistence on load**: The applied mode resolves from `mode` -> the stored value -> the `system` default, so a previously chosen mode is restored without an explicit prop.
19
- - **`mdsPrefChange` event**: Emits `mdsPrefChange` with `{ preference: 'mode' }` every time the mode is applied: on load and on each pick, so one pick can emit it more than once. It bubbles up to `<mds-pref>`; a mode change needs no reload, so it raises no reload notice.
19
+ - **`mdsPrefChange` event**: Emits `mdsPrefChange` with `{ preference: 'mode' }` once per change, after the new mode is applied; a pick of the mode already active and the first application on load do not emit it. It bubbles up to `<mds-pref>`; a mode change needs no reload, so it raises no reload notice.
20
20
  - **Instances stay in sync**: Instances mounted together (a hidden `<mds-pref controller>` and a visible settings panel) share the applied mode: a pick in one is mirrored by the others, which neither apply it again nor emit `mdsPrefChange`. A `pref-mode-*` class written on `<html>` by other code is mirrored the same way.
21
- - **Safari fallback**: On Safari the control disables itself and forces `mode` to `light`, since the transition overlay technique is unsupported there.
22
21
  - **System mode**: The `system` choice follows the OS `prefers-color-scheme` media query to resolve the effective light/dark scheme.
23
22
 
24
23
  #### Properties & Visual Configurations
25
24
 
26
25
  - **`mode`**: Sets and reflects the active mode (`light`, `dark`, `system`). Leave it unset to inherit the persisted/default mode; set it explicitly to force a starting mode.
27
26
  - **`transition`**: Controls the visual switch between schemes. Use `smooth` (default) for a fading neutral overlay that flips the mode mid-fade, `flash` for an instant switch with a brief overlay pulse, or `none` to apply the new mode with no overlay animation. The overlay timing and z-index are tunable through `--mds-pref-mode-overlay-*` CSS custom properties.
28
- - **`size`**: Sizes the nested tab items (`sm` / `md`). The parent `<mds-pref>` forwards its own `size` to every `mds-pref-*` child only when that prop changes after load, not from the initial markup: in markup, set it here (with the same value on the sibling preferences, so the group stays visually consistent).
27
+ - **`size`**: Sizes the nested tab items (`sm` / `md`). Inside `<mds-pref>`, set it on the parent instead: the parent's `size` reaches every `mds-pref-*` child on load and when it changes, and overwrites the child's own.
29
28
 
30
29
  ## Read next
31
30
 
@@ -48,6 +47,14 @@ The `<mds-pref-mode>` web component is the mode preference control of the Magma
48
47
  | --- | --- | --- |
49
48
  | `mdsPrefChange` | `MdsPrefChangeEventDetail` | Emits when the component is triggered |
50
49
 
50
+ ## CSS custom properties
51
+
52
+ | Property | Description |
53
+ | --- | --- |
54
+ | `--mds-pref-mode-overlay-fadeout-duration` | Sets the fadeout duration of the overlay which hides UI color flash on theme change |
55
+ | `--mds-pref-mode-overlay-show-duration` | Sets the show duration of the overlay which hides UI color flash on theme change |
56
+ | `--mds-pref-mode-overlay-z-index` | Sets the z-index of the overlay which hides UI color flash on theme change |
57
+
51
58
  ## Dependencies
52
59
 
53
60
  Uses: `mds-text`, `mds-tab`, `mds-tab-item`.
@@ -69,7 +69,7 @@ The component manages `pref-mode-light`, `pref-mode-dark`, and `pref-mode-system
69
69
 
70
70
  #### Do Not Size Only One Child of the Panel
71
71
 
72
- `<mds-pref>` forwards its own `size` to its preference children only when that prop changes after load, not from the initial markup, so in markup each child carries its own `size`. Setting it on `<mds-pref-mode>` alone when siblings exist produces inconsistent tab sizes across the panel.
72
+ Setting `size` on `<mds-pref-mode>` alone when siblings exist produces inconsistent tab sizes across the panel. Set it on `<mds-pref>`, which forwards it to every preference child, on load and when it changes.
73
73
 
74
74
  ```html
75
75
  <!-- INCORRECT -->
@@ -79,9 +79,9 @@ The component manages `pref-mode-light`, `pref-mode-dark`, and `pref-mode-system
79
79
  </mds-pref>
80
80
 
81
81
  <!-- CORRECT -->
82
- <mds-pref>
83
- <mds-pref-mode size="sm"></mds-pref-mode>
84
- <mds-pref-contrast size="sm"></mds-pref-contrast>
82
+ <mds-pref size="sm">
83
+ <mds-pref-mode></mds-pref-mode>
84
+ <mds-pref-contrast></mds-pref-contrast>
85
85
  </mds-pref>
86
86
  ```
87
87
 
@@ -1,8 +1,8 @@
1
1
  {
2
- "timestamp": "2026-10-14T12:22:32",
2
+ "timestamp": "2026-10-20T14:19:46",
3
3
  "compiler": {
4
4
  "name": "@stencil/core",
5
- "version": "4.44.2",
5
+ "version": "4.45.2",
6
6
  "typescriptVersion": "5.8.3"
7
7
  },
8
8
  "components": [
@@ -13,9 +13,9 @@
13
13
  "docs": "",
14
14
  "docsTags": [],
15
15
  "usage": {
16
- "1. Description": "The `<mds-pref-mode>` web component is the mode preference control of the Magma Design System, designed to live as a direct child of [`<mds-pref>`](../mds-pref/AGENTS.md). It renders a labelled three-way tab (light / system / dark) that lets the user pick a color-scheme mode and applies it globally to the document.\n\n#### Semantic Behavior\n\n- **Compound child only**: It is meant to be placed directly in the default slot of `<mds-pref>` alongside the other `mds-pref-*` preference children; it is not used standalone or mixed with unrelated child types.\n- **Selection follows `mode`**: The active tab reflects whichever mode is currently applied, driven by the `mode` prop.\n- **Global mode application**: Selecting a mode applies it document-wide and persists the choice.\n- **Persistence on load**: The applied mode resolves from `mode` -> the stored value -> the `system` default, so a previously chosen mode is restored without an explicit prop.\n- **`mdsPrefChange` event**: Emits `mdsPrefChange` with `{ preference: 'mode' }` every time the mode is applied: on load and on each pick, so one pick can emit it more than once. It bubbles up to `<mds-pref>`; a mode change needs no reload, so it raises no reload notice.\n- **Instances stay in sync**: Instances mounted together (a hidden `<mds-pref controller>` and a visible settings panel) share the applied mode: a pick in one is mirrored by the others, which neither apply it again nor emit `mdsPrefChange`. A `pref-mode-*` class written on `<html>` by other code is mirrored the same way.\n- **Safari fallback**: On Safari the control disables itself and forces `mode` to `light`, since the transition overlay technique is unsupported there.\n- **System mode**: The `system` choice follows the OS `prefers-color-scheme` media query to resolve the effective light/dark scheme.\n\n#### Properties & Visual Configurations\n\n- **`mode`**: Sets and reflects the active mode (`light`, `dark`, `system`). Leave it unset to inherit the persisted/default mode; set it explicitly to force a starting mode.\n- **`transition`**: Controls the visual switch between schemes. Use `smooth` (default) for a fading neutral overlay that flips the mode mid-fade, `flash` for an instant switch with a brief overlay pulse, or `none` to apply the new mode with no overlay animation. The overlay timing and z-index are tunable through `--mds-pref-mode-overlay-*` CSS custom properties.\n- **`size`**: Sizes the nested tab items (`sm` / `md`). The parent `<mds-pref>` forwards its own `size` to every `mds-pref-*` child only when that prop changes after load, not from the initial markup: in markup, set it here (with the same value on the sibling preferences, so the group stays visually consistent).\n",
17
- "2. Pattern": "Correct and idiomatic ways to use the `<mds-pref-mode>` component, ordered from most common to most specialized. Patterns assume a working knowledge of the shared preference system documented in [`agents/theming.md`](../../../../agents/theming.md) and the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Default Usage Inside `mds-pref`\n\nThe canonical form. Slot `<mds-pref-mode>` as a direct child of [`<mds-pref>`](../mds-pref/AGENTS.md) with no extra props. The component restores the user's previously persisted mode automatically on load.\n\n```html\n<mds-pref>\n <mds-pref-mode></mds-pref-mode>\n</mds-pref>\n```\n\n#### Setting an Initial Mode\n\nPass `mode` to force the selector to start on a specific mode rather than reading from `localStorage`. Useful when the host application controls preference state centrally. The forced mode is also written to `localStorage` on every load, replacing the user's last choice.\n\n```html\n<mds-pref>\n <mds-pref-mode mode=\"dark\"></mds-pref-mode>\n</mds-pref>\n```\n\n#### Using `system` Mode for OS-Aware Default\n\n`mode=\"system\"` resolves to light or dark based on the OS `prefers-color-scheme` media query. Use this as the explicit starting point when you want the app to follow the OS without the user having to choose.\n\n```html\n<mds-pref>\n <mds-pref-mode mode=\"system\"></mds-pref-mode>\n</mds-pref>\n```\n\n#### Choosing a Transition Style\n\n`transition` controls the visual effect when switching between schemes. Use `smooth` (default) for a mid-fade overlay that hides the color flip, `flash` for an instant switch with a brief full-screen pulse, or `none` for a hard switch with no animation.\n\n```html\n<!-- Smooth fade (default) -->\n<mds-pref-mode transition=\"smooth\"></mds-pref-mode>\n\n<!-- Instant flash pulse -->\n<mds-pref-mode transition=\"flash\"></mds-pref-mode>\n\n<!-- No animation -->\n<mds-pref-mode transition=\"none\"></mds-pref-mode>\n```\n\n#### Listening for Mode Changes\n\nThe component emits `mdsPrefChange` with `{ preference: 'mode' }` each time the mode is applied, on load and on each pick, so expect repeats with the same mode; another instance that mirrors the pick does not emit it. Listen for this event to react in application code - for example to sync a preference state store - and read the current value from the `mode` prop.\n\n```html\n<mds-pref>\n <mds-pref-mode id=\"mode-selector\"></mds-pref-mode>\n</mds-pref>\n\n<script>\n document.getElementById('mode-selector').addEventListener('mdsPrefChange', (e) => {\n console.log('Modalita tema cambiata:', e.detail.preference);\n });\n</script>\n```\n\n#### Controlling Size via the Parent\n\n`size` is forwarded to the internal tab items. [`<mds-pref>`](../mds-pref/AGENTS.md) forwards its own `size` to every `mds-pref-*` child only when that prop changes after load, not from the initial markup: in markup, set the same `size` on every preference control to keep the panel at one tab size.\n\n```html\n<mds-pref>\n <mds-pref-mode size=\"sm\"></mds-pref-mode>\n <mds-pref-contrast size=\"sm\"></mds-pref-contrast>\n</mds-pref>\n```\n\n#### Customizing the Transition Overlay\n\nTune the overlay timing and stacking order via the documented `--mds-pref-mode-overlay-*` CSS custom properties. Set them on the host or a parent selector. Use Magma time tokens where available so animations stay in sync with the design system.\n\n```css\nmds-pref-mode {\n --mds-pref-mode-overlay-show-duration: 400ms;\n --mds-pref-mode-overlay-fadeout-duration: 250ms;\n --mds-pref-mode-overlay-z-index: 9000;\n}\n```\n",
18
- "3. Antipattern": "Common incorrect uses of `<mds-pref-mode>`. 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 Use `<mds-pref-mode>` Outside `<mds-pref>`\n\n`<mds-pref-mode>` is a compound child: `<mds-pref>` forwards `size` changes to it and locks the mode item that a scheme-constrained `<mds-pref-theme>` forbids (it sets `lockedScheme`). As a standalone widget it still applies and persists the mode, but nothing coordinates it with the theme.\n\n```html\n<!-- INCORRECT -->\n<mds-pref-mode></mds-pref-mode>\n\n<!-- CORRECT -->\n<mds-pref>\n <mds-pref-mode></mds-pref-mode>\n</mds-pref>\n```\n\n#### Do Not Set `transition=\"false\"` to Disable the Overlay\n\n`transition` is a string enum, not a boolean. `\"false\"` is not a valid value: it only happens to fall through to the no-overlay branch, with no guarantee across releases. Use `transition=\"none\"` to opt out of the overlay animation.\n\n```html\n<!-- INCORRECT -->\n<mds-pref-mode transition=\"false\"></mds-pref-mode>\n\n<!-- CORRECT -->\n<mds-pref-mode transition=\"none\"></mds-pref-mode>\n```\n\n#### Do Not Listen for Native `change` Events Instead of `mdsPrefChange`\n\nThe component does not emit or bubble native `change` events out of the shadow DOM. Always listen for the documented `mdsPrefChange` custom event.\n\n```html\n<!-- INCORRECT -->\n<script>\n document.querySelector('mds-pref-mode').addEventListener('change', handler);\n</script>\n\n<!-- CORRECT -->\n<script>\n document.querySelector('mds-pref-mode').addEventListener('mdsPrefChange', handler);\n</script>\n```\n\n#### Do Not Override Mode Classes on `<html>` Directly\n\nThe component manages `pref-mode-light`, `pref-mode-dark`, and `pref-mode-system` classes on `<html>` itself. Adding or removing these by hand races with the component and will be overwritten on the next mode change. Drive the mode exclusively through the `mode` prop.\n\n```html\n<!-- INCORRECT -->\n<script>\n document.documentElement.classList.add('pref-mode-dark');\n</script>\n\n<!-- CORRECT -->\n<mds-pref>\n <mds-pref-mode mode=\"dark\"></mds-pref-mode>\n</mds-pref>\n```\n\n#### Do Not Size Only One Child of the Panel\n\n`<mds-pref>` forwards its own `size` to its preference children only when that prop changes after load, not from the initial markup, so in markup each child carries its own `size`. Setting it on `<mds-pref-mode>` alone when siblings exist produces inconsistent tab sizes across the panel.\n\n```html\n<!-- INCORRECT -->\n<mds-pref>\n <mds-pref-mode size=\"sm\"></mds-pref-mode>\n <mds-pref-contrast></mds-pref-contrast>\n</mds-pref>\n\n<!-- CORRECT -->\n<mds-pref>\n <mds-pref-mode size=\"sm\"></mds-pref-mode>\n <mds-pref-contrast size=\"sm\"></mds-pref-contrast>\n</mds-pref>\n```\n\n#### Do Not Target the Injected Overlay to Customize It\n\nThe overlay element is injected into `document.body` at runtime with inline styles, which win over a class selector anyway. Do not target it by class name or adjust its properties through JavaScript. Use the documented `--mds-pref-mode-overlay-*` CSS custom properties instead.\n\n```css\n/* INCORRECT */\n.mds-pref-mode-overlay {\n background-color: black;\n z-index: 99999;\n}\n\n/* CORRECT */\nmds-pref-mode {\n --mds-pref-mode-overlay-show-duration: 400ms;\n --mds-pref-mode-overlay-z-index: 9000;\n}\n```\n"
16
+ "1. Description": "The `<mds-pref-mode>` web component is the mode preference control of the Magma Design System, usually a direct child of the [`<mds-pref>`](../mds-pref/AGENTS.md) panel. It renders a labelled three-way tab (light / system / dark) that lets the user pick a color-scheme mode and applies it globally to the document.\n\n#### Semantic Behavior\n\n- **Usually inside `<mds-pref>`**: Placed as a direct slot child of `<mds-pref>`, alongside the other `mds-pref-*` controls; it also works on its own, since it applies and stores the mode by itself. What it gives up on its own is in the antipattern docs.\n- **Selection follows `mode`**: The active tab reflects whichever mode is currently applied, driven by the `mode` prop.\n- **Global mode application**: Selecting a mode applies it document-wide and persists the choice.\n- **Persistence on load**: The applied mode resolves from `mode` -> the stored value -> the `system` default, so a previously chosen mode is restored without an explicit prop.\n- **`mdsPrefChange` event**: Emits `mdsPrefChange` with `{ preference: 'mode' }` once per change, after the new mode is applied; a pick of the mode already active and the first application on load do not emit it. It bubbles up to `<mds-pref>`; a mode change needs no reload, so it raises no reload notice.\n- **Instances stay in sync**: Instances mounted together (a hidden `<mds-pref controller>` and a visible settings panel) share the applied mode: a pick in one is mirrored by the others, which neither apply it again nor emit `mdsPrefChange`. A `pref-mode-*` class written on `<html>` by other code is mirrored the same way.\n- **System mode**: The `system` choice follows the OS `prefers-color-scheme` media query to resolve the effective light/dark scheme.\n\n#### Properties & Visual Configurations\n\n- **`mode`**: Sets and reflects the active mode (`light`, `dark`, `system`). Leave it unset to inherit the persisted/default mode; set it explicitly to force a starting mode.\n- **`transition`**: Controls the visual switch between schemes. Use `smooth` (default) for a fading neutral overlay that flips the mode mid-fade, `flash` for an instant switch with a brief overlay pulse, or `none` to apply the new mode with no overlay animation. The overlay timing and z-index are tunable through `--mds-pref-mode-overlay-*` CSS custom properties.\n- **`size`**: Sizes the nested tab items (`sm` / `md`). Inside `<mds-pref>`, set it on the parent instead: the parent's `size` reaches every `mds-pref-*` child on load and when it changes, and overwrites the child's own.\n",
17
+ "2. Pattern": "Correct and idiomatic ways to use the `<mds-pref-mode>` component, ordered from most common to most specialized. Patterns assume a working knowledge of the shared preference system documented in [`agents/theming.md`](../../../../agents/theming.md) and the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Default Usage Inside `mds-pref`\n\nThe canonical form. Slot `<mds-pref-mode>` as a direct child of [`<mds-pref>`](../mds-pref/AGENTS.md) with no extra props. The component restores the user's previously persisted mode automatically on load.\n\n```html\n<mds-pref>\n <mds-pref-mode></mds-pref-mode>\n</mds-pref>\n```\n\n#### Setting an Initial Mode\n\nPass `mode` to force the selector to start on a specific mode rather than reading from `localStorage`. Useful when the host application controls preference state centrally. The forced mode is also written to `localStorage` on every load, replacing the user's last choice.\n\n```html\n<mds-pref>\n <mds-pref-mode mode=\"dark\"></mds-pref-mode>\n</mds-pref>\n```\n\n#### Using `system` Mode for OS-Aware Default\n\n`mode=\"system\"` resolves to light or dark based on the OS `prefers-color-scheme` media query. Use this as the explicit starting point when you want the app to follow the OS without the user having to choose.\n\n```html\n<mds-pref>\n <mds-pref-mode mode=\"system\"></mds-pref-mode>\n</mds-pref>\n```\n\n#### Choosing a Transition Style\n\n`transition` controls the visual effect when switching between schemes. Use `smooth` (default) for a mid-fade overlay that hides the color flip, `flash` for an instant switch with a brief full-screen pulse, or `none` for a hard switch with no animation.\n\n```html\n<!-- Smooth fade (default) -->\n<mds-pref-mode transition=\"smooth\"></mds-pref-mode>\n\n<!-- Instant flash pulse -->\n<mds-pref-mode transition=\"flash\"></mds-pref-mode>\n\n<!-- No animation -->\n<mds-pref-mode transition=\"none\"></mds-pref-mode>\n```\n\n#### Listening for Mode Changes\n\nThe component emits `mdsPrefChange` with `{ preference: 'mode' }` once per change, after the new mode is applied, and not on page load; another instance that mirrors the pick does not emit it. Listen for this event to react in application code - for example to sync a preference state store - and read the current value from the `mode` prop.\n\n```html\n<mds-pref>\n <mds-pref-mode id=\"mode-selector\"></mds-pref-mode>\n</mds-pref>\n\n<script>\n document.getElementById('mode-selector').addEventListener('mdsPrefChange', (e) => {\n console.log('Modalita tema cambiata:', e.detail.preference);\n });\n</script>\n```\n\n#### Controlling Size via the Parent\n\n`size` is forwarded to the internal tab items. [`<mds-pref>`](../mds-pref/AGENTS.md) forwards its own `size` to every `mds-pref-*` child, on load and when it changes: set it on the parent to keep the panel at one tab size.\n\n```html\n<mds-pref size=\"sm\">\n <mds-pref-mode></mds-pref-mode>\n <mds-pref-contrast></mds-pref-contrast>\n</mds-pref>\n```\n\n#### Customizing the Transition Overlay\n\nTune the overlay timing and stacking order via the documented `--mds-pref-mode-overlay-*` CSS custom properties. Set them on the host or a parent selector. Use Magma time tokens where available so animations stay in sync with the design system.\n\n```css\nmds-pref-mode {\n --mds-pref-mode-overlay-show-duration: 400ms;\n --mds-pref-mode-overlay-fadeout-duration: 250ms;\n --mds-pref-mode-overlay-z-index: 9000;\n}\n```\n",
18
+ "3. Antipattern": "Common incorrect uses of `<mds-pref-mode>`. 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 Use `<mds-pref-mode>` Outside `<mds-pref>`\n\n`<mds-pref-mode>` is a compound child: `<mds-pref>` forwards `size` changes to it and locks the mode item that a scheme-constrained `<mds-pref-theme>` forbids (it sets `lockedScheme`). As a standalone widget it still applies and persists the mode, but nothing coordinates it with the theme.\n\n```html\n<!-- INCORRECT -->\n<mds-pref-mode></mds-pref-mode>\n\n<!-- CORRECT -->\n<mds-pref>\n <mds-pref-mode></mds-pref-mode>\n</mds-pref>\n```\n\n#### Do Not Set `transition=\"false\"` to Disable the Overlay\n\n`transition` is a string enum, not a boolean. `\"false\"` is not a valid value: it only happens to fall through to the no-overlay branch, with no guarantee across releases. Use `transition=\"none\"` to opt out of the overlay animation.\n\n```html\n<!-- INCORRECT -->\n<mds-pref-mode transition=\"false\"></mds-pref-mode>\n\n<!-- CORRECT -->\n<mds-pref-mode transition=\"none\"></mds-pref-mode>\n```\n\n#### Do Not Listen for Native `change` Events Instead of `mdsPrefChange`\n\nThe component does not emit or bubble native `change` events out of the shadow DOM. Always listen for the documented `mdsPrefChange` custom event.\n\n```html\n<!-- INCORRECT -->\n<script>\n document.querySelector('mds-pref-mode').addEventListener('change', handler);\n</script>\n\n<!-- CORRECT -->\n<script>\n document.querySelector('mds-pref-mode').addEventListener('mdsPrefChange', handler);\n</script>\n```\n\n#### Do Not Override Mode Classes on `<html>` Directly\n\nThe component manages `pref-mode-light`, `pref-mode-dark`, and `pref-mode-system` classes on `<html>` itself. Adding or removing these by hand races with the component and will be overwritten on the next mode change. Drive the mode exclusively through the `mode` prop.\n\n```html\n<!-- INCORRECT -->\n<script>\n document.documentElement.classList.add('pref-mode-dark');\n</script>\n\n<!-- CORRECT -->\n<mds-pref>\n <mds-pref-mode mode=\"dark\"></mds-pref-mode>\n</mds-pref>\n```\n\n#### Do Not Size Only One Child of the Panel\n\nSetting `size` on `<mds-pref-mode>` alone when siblings exist produces inconsistent tab sizes across the panel. Set it on `<mds-pref>`, which forwards it to every preference child, on load and when it changes.\n\n```html\n<!-- INCORRECT -->\n<mds-pref>\n <mds-pref-mode size=\"sm\"></mds-pref-mode>\n <mds-pref-contrast></mds-pref-contrast>\n</mds-pref>\n\n<!-- CORRECT -->\n<mds-pref size=\"sm\">\n <mds-pref-mode></mds-pref-mode>\n <mds-pref-contrast></mds-pref-contrast>\n</mds-pref>\n```\n\n#### Do Not Target the Injected Overlay to Customize It\n\nThe overlay element is injected into `document.body` at runtime with inline styles, which win over a class selector anyway. Do not target it by class name or adjust its properties through JavaScript. Use the documented `--mds-pref-mode-overlay-*` CSS custom properties instead.\n\n```css\n/* INCORRECT */\n.mds-pref-mode-overlay {\n background-color: black;\n z-index: 99999;\n}\n\n/* CORRECT */\nmds-pref-mode {\n --mds-pref-mode-overlay-show-duration: 400ms;\n --mds-pref-mode-overlay-z-index: 9000;\n}\n```\n"
19
19
  },
20
20
  "props": [
21
21
  {
@@ -211,7 +211,23 @@
211
211
  }
212
212
  ],
213
213
  "listeners": [],
214
- "styles": [],
214
+ "styles": [
215
+ {
216
+ "name": "--mds-pref-mode-overlay-fadeout-duration",
217
+ "annotation": "prop",
218
+ "docs": "Sets the fadeout duration of the overlay which hides UI color flash on theme change"
219
+ },
220
+ {
221
+ "name": "--mds-pref-mode-overlay-show-duration",
222
+ "annotation": "prop",
223
+ "docs": "Sets the show duration of the overlay which hides UI color flash on theme change"
224
+ },
225
+ {
226
+ "name": "--mds-pref-mode-overlay-z-index",
227
+ "annotation": "prop",
228
+ "docs": "Sets the z-index of the overlay which hides UI color flash on theme change"
229
+ }
230
+ ],
215
231
  "slots": [],
216
232
  "parts": [],
217
233
  "states": [],
@@ -12,7 +12,7 @@ mds-text {
12
12
  }
13
13
 
14
14
 
15
- /*
15
+ /**
16
16
  * @prop --mds-pref-mode-overlay-fadeout-duration: Sets the fadeout duration of the overlay which hides UI color flash on theme change
17
17
  * @prop --mds-pref-mode-overlay-show-duration: Sets the show duration of the overlay which hides UI color flash on theme change
18
18
  * @prop --mds-pref-mode-overlay-z-index: Sets the z-index of the overlay which hides UI color flash on theme change
@@ -24,18 +24,18 @@ mds-text {
24
24
  --mds-pref-mode-overlay-z-index: var(--magma-theme-overlay-z-index, 7000);
25
25
 
26
26
  display: grid;
27
- gap: --spacing(100);
27
+ gap: --spacing(200);
28
28
  }
29
29
 
30
30
  .item {
31
- --mds-tab-item-default-color: rgb(var(--magma-text-disabled, var(--magma-tint-text-disabled, var(--text-neutral-disabled, 119 119 119))));
31
+ --mds-tab-item-default-color: rgb(var(--magma-text-disabled, var(--text-neutral-disabled, 119 119 119)));
32
32
 
33
33
  flex-basis: 0;
34
34
  flex-grow: 1;
35
35
  }
36
36
 
37
37
  .item--system {
38
- --mds-tab-item-selected-color: rgb(var(--magma-text-muted, var(--magma-tint-text-muted, var(--text-neutral-muted, 73 73 73))));
38
+ --mds-tab-item-selected-color: rgb(var(--magma-text-muted, var(--text-neutral-muted, 73 73 73)));
39
39
  }
40
40
 
41
41
  .item--light {
@@ -48,7 +48,7 @@ mds-text {
48
48
 
49
49
  :host([pref-mode='dark']:not([pref-theme-scheme='light'])) {
50
50
  .item {
51
- --mds-tab-item-default-color: rgb(var(--magma-text-default, var(--magma-tint-text-default, var(--text-neutral-default, 5 5 5))));
51
+ --mds-tab-item-default-color: rgb(var(--magma-text-default, var(--text-neutral-default, 5 5 5)));
52
52
  }
53
53
 
54
54
  .item--light {
@@ -64,7 +64,7 @@ mds-text {
64
64
  :host([pref-mode='system']:not([pref-theme-scheme='light'])),
65
65
  :host(:not([pref-contrast])) {
66
66
  .item {
67
- --mds-tab-item-default-color: rgb(var(--magma-text-default, var(--magma-tint-text-default, var(--text-neutral-default, 5 5 5))));
67
+ --mds-tab-item-default-color: rgb(var(--magma-text-default, var(--text-neutral-default, 5 5 5)));
68
68
  }
69
69
 
70
70
  .item--light {
@@ -1,11 +1,10 @@
1
- import { Host, h, } from "@stencil/core";
1
+ import { Host, h } from "@stencil/core";
2
2
  import { cssDurationToMilliseconds } from "../../common/unit";
3
3
  import miBaselineLightMode from "@icon/mi/baseline/light-mode.svg";
4
4
  import miOutlineDarkMode from "@icon/mi/outline/dark-mode.svg";
5
5
  import miBaselineDarkMode from "@icon/mi/baseline/dark-mode.svg";
6
6
  import miBaselineSettings from "@icon/mi/baseline/settings.svg";
7
7
  import { Locale } from "../../common/locale";
8
- import { isSafari } from "../../common/browser";
9
8
  import { preferenceStore } from "../../common/preference";
10
9
  import localeEl from "./meta/locale.el.json";
11
10
  import localeEn from "./meta/locale.en.json";
@@ -30,7 +29,6 @@ export class MdsPrefMode {
30
29
  this.overlayId = 'mds-pref-mode-overlay';
31
30
  this.overlayShow = false;
32
31
  this.syncingFromStore = false;
33
- this.disabled = false;
34
32
  this.updateCSSCustomProps = () => {
35
33
  var _a, _b, _c;
36
34
  if (typeof window === 'undefined')
@@ -66,15 +64,26 @@ export class MdsPrefMode {
66
64
  * `<html>` classes) without applying it again: no event, no storage write.
67
65
  */
68
66
  this.syncMode = (mode) => {
69
- if (mode === undefined || mode === this.mode || this.disabled) {
67
+ if (mode === undefined || mode === this.mode) {
70
68
  return;
71
69
  }
72
70
  this.syncingFromStore = true;
73
71
  this.mode = mode;
72
+ this.appliedMode = mode;
74
73
  this.syncingFromStore = false;
75
74
  };
75
+ /**
76
+ * Applies a mode once per change, and announces it once applied: the `mode` watcher
77
+ * calls this again for the value it has just been given, which used to emit a second
78
+ * mdsPrefChange, and the first application, the one of load, is no change to announce.
79
+ */
76
80
  this.setMode = (mode) => {
77
- this.prefChangeEvent.emit({ preference: 'mode' });
81
+ if (mode === this.appliedMode) {
82
+ this.mode = mode;
83
+ return;
84
+ }
85
+ const isFirstApplication = this.appliedMode === undefined;
86
+ this.appliedMode = mode;
78
87
  this.mode = mode;
79
88
  localStorage.setItem(this.localStorageAlias, this.mode);
80
89
  if (typeof document !== 'undefined') {
@@ -88,6 +97,9 @@ export class MdsPrefMode {
88
97
  element === null || element === void 0 ? void 0 : element.style.setProperty(this.customPropertyAlias, this.mode);
89
98
  }
90
99
  preferenceStore.state.mode = mode;
100
+ if (!isFirstApplication) {
101
+ this.prefChangeEvent.emit({ preference: 'mode' });
102
+ }
91
103
  };
92
104
  this.isDarkMode = () => {
93
105
  return window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches;
@@ -146,9 +158,6 @@ export class MdsPrefMode {
146
158
  }, 1);
147
159
  };
148
160
  this.isModeDisabled = (mode) => {
149
- if (this.disabled) {
150
- return true;
151
- }
152
161
  if (this.lockedScheme === 'light') {
153
162
  return mode === 'dark';
154
163
  }
@@ -193,14 +202,11 @@ export class MdsPrefMode {
193
202
  // The stored mode is applied once, on load. After that each instance only mirrors
194
203
  // the shared store: re-applying its own `mode` on every render made a second
195
204
  // instance (a controller next to a settings page) revert what the other one chose.
205
+ // Safari is no exception any more: it used to be forced to light, written to the storage,
206
+ // while the dark refinements were Chromium-only `:host-context` rules (#960).
196
207
  componentWillLoad() {
197
208
  var _a, _b;
198
- if (!isSafari()) {
199
- this.setMode((_b = (_a = this.mode) !== null && _a !== void 0 ? _a : localStorage.getItem(this.localStorageAlias)) !== null && _b !== void 0 ? _b : this.defaultMode);
200
- return;
201
- }
202
- this.disabled = true;
203
- this.mode = 'light';
209
+ this.setMode((_b = (_a = this.mode) !== null && _a !== void 0 ? _a : localStorage.getItem(this.localStorageAlias)) !== null && _b !== void 0 ? _b : this.defaultMode);
204
210
  }
205
211
  connectedCallback() {
206
212
  this.unsubscribeStore = preferenceStore.onChange('mode', this.syncMode);
@@ -229,10 +235,8 @@ export class MdsPrefMode {
229
235
  }, cssDurationToMilliseconds(this.cssOverlayFadeoutDuration));
230
236
  }
231
237
  render() {
232
- var _a, _b;
233
- return (h(Host, { key: '7cd1902d2bbb1707f0fd08777a0e509b63ed75e7', "pref-contrast": preferenceStore.state.contrast, "pref-mode": preferenceStore.state.mode, "pref-theme-scheme": preferenceStore.state['theme-scheme'] }, h("mds-text", { key: '9be2e723c633331e0303b9d713572a0d81cc83f3', class: "info", typography: "caption" }, h("b", { key: '7e4002d2bea7c59b08eb47bb71d4b7afa40f65e7' }, this.t.get('label')), ' ', this.disabled
234
- ? this.t.get(this.modes[(_a = this.mode) !== null && _a !== void 0 ? _a : this.defaultMode].label, { forced: true })
235
- : this.t.get(this.modes[(_b = this.mode) !== null && _b !== void 0 ? _b : this.defaultMode].label, { forced: false })), h("mds-tab", { key: '59cbe510ef71c438ee1836506bb8767698bd0e2c', fill: true, size: this.size }, h("mds-tab-item", { key: 'a396dfff77f1c267e53a1427fc650691dc8a9c87', disabled: this.isModeDisabled('light'), selected: this.mode === 'light', onClick: this.handleModeClick('light'), class: "item item--light", icon: miBaselineLightMode, title: this.t.get(this.modes.light.label, { forced: false }) }), h("mds-tab-item", { key: '8448bd8e297945b9e80d3a010af13c62241d1e31', disabled: this.isModeDisabled('system'), selected: this.mode === 'system', onClick: this.handleModeClick('system'), class: "item item--system", icon: miBaselineSettings, title: this.t.get(this.modes.system.label) }), h("mds-tab-item", { key: 'e3aaf2dc231e62ab732d65dd2eb38585fb29ecbf', disabled: this.isModeDisabled('dark'), selected: this.mode === 'dark', onClick: this.handleModeClick('dark'), class: "item item--dark", icon: this.mode === 'dark' ? miBaselineDarkMode : miOutlineDarkMode, title: this.t.get(this.modes.dark.label) }))));
238
+ var _a;
239
+ return (h(Host, { key: '54942d5c0b4d9a9bd64491cf336f0781a7c2f48b', "pref-contrast": preferenceStore.state.contrast, "pref-mode": preferenceStore.state.mode, "pref-theme-scheme": preferenceStore.state['theme-scheme'] }, h("mds-text", { key: '0febf8db8b0d509c7fe8493add1adcbd51b2b685', class: "info", typography: "caption" }, h("b", { key: 'cdfe50fb106eb352ece6c95cd4849182fd3100a2' }, this.t.get('label')), " ", this.t.get(this.modes[(_a = this.mode) !== null && _a !== void 0 ? _a : this.defaultMode].label)), h("mds-tab", { key: '91b9a987e51b1723eaa9ed8dafd1eb885df7bbf4', fill: true, size: this.size }, h("mds-tab-item", { key: 'f8b02536a2ff93163881f8d8cd9487c8c1dc57d5', disabled: this.isModeDisabled('light'), selected: this.mode === 'light', onClick: this.handleModeClick('light'), class: "item item--light", icon: miBaselineLightMode, title: this.t.get(this.modes.light.label) }), h("mds-tab-item", { key: '24171536adfeacd0820757c9645563de1f104499', disabled: this.isModeDisabled('system'), selected: this.mode === 'system', onClick: this.handleModeClick('system'), class: "item item--system", icon: miBaselineSettings, title: this.t.get(this.modes.system.label) }), h("mds-tab-item", { key: 'a8a70270da474426111975d6e636f97b1c2ad0fc', disabled: this.isModeDisabled('dark'), selected: this.mode === 'dark', onClick: this.handleModeClick('dark'), class: "item item--dark", icon: this.mode === 'dark' ? miBaselineDarkMode : miOutlineDarkMode, title: this.t.get(this.modes.dark.label) }))));
236
240
  }
237
241
  static get is() { return "mds-pref-mode"; }
238
242
  static get encapsulation() { return "shadow"; }
@@ -355,11 +359,6 @@ export class MdsPrefMode {
355
359
  }
356
360
  };
357
361
  }
358
- static get states() {
359
- return {
360
- "disabled": {}
361
- };
362
- }
363
362
  static get events() {
364
363
  return [{
365
364
  "method": "prefChangeEvent",
@@ -56,7 +56,7 @@ Pass `mode` to force the selector to start on a specific mode rather than readin
56
56
 
57
57
  #### Listening for Mode Changes
58
58
 
59
- The component emits `mdsPrefChange` with `{ preference: 'mode' }` each time the mode is applied, on load and on each pick, so expect repeats with the same mode; another instance that mirrors the pick does not emit it. Listen for this event to react in application code - for example to sync a preference state store - and read the current value from the `mode` prop.
59
+ The component emits `mdsPrefChange` with `{ preference: 'mode' }` once per change, after the new mode is applied, and not on page load; another instance that mirrors the pick does not emit it. Listen for this event to react in application code - for example to sync a preference state store - and read the current value from the `mode` prop.
60
60
 
61
61
  ```html
62
62
  <mds-pref>
@@ -72,12 +72,12 @@ The component emits `mdsPrefChange` with `{ preference: 'mode' }` each time the
72
72
 
73
73
  #### Controlling Size via the Parent
74
74
 
75
- `size` is forwarded to the internal tab items. [`<mds-pref>`](../mds-pref/AGENTS.md) forwards its own `size` to every `mds-pref-*` child only when that prop changes after load, not from the initial markup: in markup, set the same `size` on every preference control to keep the panel at one tab size.
75
+ `size` is forwarded to the internal tab items. [`<mds-pref>`](../mds-pref/AGENTS.md) forwards its own `size` to every `mds-pref-*` child, on load and when it changes: set it on the parent to keep the panel at one tab size.
76
76
 
77
77
  ```html
78
- <mds-pref>
79
- <mds-pref-mode size="sm"></mds-pref-mode>
80
- <mds-pref-contrast size="sm"></mds-pref-contrast>
78
+ <mds-pref size="sm">
79
+ <mds-pref-mode></mds-pref-mode>
80
+ <mds-pref-contrast></mds-pref-contrast>
81
81
  </mds-pref>
82
82
  ```
83
83
 
@@ -6,25 +6,27 @@
6
6
 
7
7
  # mds-pref-theme
8
8
 
9
- > `@maggioli-design-system/magma` 2.2.0. Shadow DOM: style it only through the CSS custom properties and parts below.
9
+ > `@maggioli-design-system/magma` 2.4.0. Shadow DOM: style it only through the CSS custom properties and parts below.
10
10
 
11
- The `<mds-pref-theme>` web component is the theme-switcher segment of the Magma accessibility preferences panel, designed to live as a direct child of [`<mds-pref>`](../mds-pref/AGENTS.md). It renders a labelled tab trigger that opens a dropdown of selectable named themes and, when a theme is chosen, applies it globally to the document.
11
+ The `<mds-pref-theme>` web component is the theme-switcher segment of the Magma accessibility preferences panel, usually a direct child of [`<mds-pref>`](../mds-pref/AGENTS.md). It renders a labelled tab trigger that opens a dropdown of selectable named themes and, when a theme is chosen, applies it globally to the document.
12
12
 
13
13
  #### Semantic Behavior
14
14
 
15
- - **Compound positioning**: It must be a direct slot child of `<mds-pref>` and is not used standalone.
15
+ - **Usually inside `<mds-pref>`**: Placed as a direct slot child of `<mds-pref>`, alongside the other `mds-pref-*` controls; it also works on its own, since it applies and stores the theme by itself. What it gives up on its own is in the antipattern docs.
16
16
  - **Acts as a sub-parent itself**: Its own default slot must contain one or more `mds-pref-theme-item` elements; it drives their selected state so only the active theme is marked selected.
17
17
  - **Global theme application**: Selecting an item applies the theme document-wide: it writes `data-theme-name` and the `pref-theme-scheme-*` class on `<html>`.
18
18
  - **Persistence and hydration**: The current name, scheme and corner shape are persisted and restored across reloads: a stored value outranks the matching prop.
19
- - **Name validation**: An invalid theme name (not lowercase kebab-case matching `^[a-z]+(-[a-z]+)*$`) throws at runtime when the theme is applied. So do the reserved names `light`, `dark` and `system` (they are mode values) and `scheme` or `scheme-*` (they would collide with the `pref-theme-scheme-*` classes).
20
- - **Events bubbled up**: Emits `mdsPrefThemeChange` with the `{ name, scheme }` detail on each pick, which `<mds-pref>` listens to in order to lock the `<mds-pref-mode>` item a scheme-constrained theme forbids. It also emits `mdsPrefChange` (`preference: 'theme'`, and `'corner-shape'` when a corner shape is set) every time it applies them, on load and on each re-render included.
19
+ - **Validation**: An invalid theme name (not lowercase kebab-case matching `^[a-z]+(-[a-z]+)*$`) is ignored with a console warning when the theme is applied: nothing is written on `<html>` or stored. So are the reserved names `light`, `dark` and `system` (they are mode values) and `scheme` or `scheme-*` (they would collide with the `pref-theme-scheme-*` classes), a `scheme` other than `light`, `dark` or `all`, and a `corner-shape` outside its keywords. A stored value the component cannot apply is dropped, and the prop is used instead.
20
+ - **Events bubbled up**: Emits `mdsPrefThemeChange` with the `{ name, scheme }` detail on each pick, which `<mds-pref>` listens to in order to lock the `<mds-pref-mode>` item a scheme-constrained theme forbids. It also emits `mdsPrefChange` once per change, after applying it: `preference: 'theme'` for a new name or scheme, `'corner-shape'` for a new corner shape. The first application on load and a re-render that changes nothing do not emit it.
21
+ - **Props set after load**: A `name`, `scheme` or `cornerShape` set from a script after load is stored and applied, as a pick is: the stored value outranks the prop only on load. A value the component would not apply is not stored.
21
22
  - **Localized label**: The "Theme" heading follows the active interface language.
23
+ - **Trigger text**: The closed control shows the `label` of the item for the active theme, the same text the open list shows (localize the items, the trigger follows); when no item matches the active theme it shows the label derived from the name (`dark-blue` -> "Dark blue").
22
24
 
23
25
  #### Properties & Visual Configurations
24
26
 
25
27
  - **`name`**: The active theme name (default `'default'`); it is overridden at runtime by any persisted value. Use it to declare the initial theme when no preference has been stored yet. The named themes are `cool` and `warm`; `default` is the base theme ([`agents/theming.md`](../../../../agents/theming.md)).
26
28
  - **`scheme`**: Constrains the colour modes of the theme to `'light'`, `'dark'`, or `'all'` (default). Pick `'all'` for themes that ship both light and dark palettes; pick `'light'` or `'dark'` to force a single mode for a theme offered in one mode only.
27
- - **`size`**: Sets the size (`'sm'` / `'md'`) of the nested tab UI. `<mds-pref>` forwards its own `size` to every `mds-pref-*` segment only when that prop changes after load, not from the initial markup: in markup, set it here (with the same value on the sibling segments, so the panel stays visually consistent).
29
+ - **`size`**: Sets the size (`'sm'` / `'md'`) of the nested tab UI. Inside `<mds-pref>`, set it on the parent: it reaches every `mds-pref-*` segment on load and when it changes, and overwrites the segment's own.
28
30
  - **`cornerShape`** (attribute `corner-shape`): The corner geometry of the whole page - `round`, `squircle`, `bevel`, `notch`, `scoop`, `square`, or `default`. It writes `data-corner-shape` on `<html>` and is persisted like the theme; `default` removes the attribute, and leaving the prop unset touches nothing ([`agents/theming.md`](../../../../agents/theming.md)).
29
31
 
30
32
  ## Read next
@@ -38,7 +40,7 @@ The `<mds-pref-theme>` web component is the theme-switcher segment of the Magma
38
40
  | Prop | Attribute | Type | Default | Description |
39
41
  | --- | --- | --- | --- | --- |
40
42
  | `cornerShape` | `corner-shape` | `"bevel" \| "default" \| "notch" \| "round" \| "scoop" \| "square" \| "squircle" \| undefined` | - | Specifies the corner geometry of the whole page: one of the `corner-shape` keywords, or `default`. Corner geometry is theme appearance rather than an accessibility preference, which is why it lives here next to the theme name and scheme instead of in `mds-pref-mode`. Setting it writes `data-corner-shape` on `<html>`, where the generated axis picks both the shape and the radius scale tuned for it. Leaving it unset touches nothing. Setting it to `default` REMOVES the attribute rather than writing today's default into the page, so a project that never chose keeps following the design system when the default changes. |
41
- | `name` | `name` | `string` | `'default'` | Specifies the theme name attribute A string representing the theme name, should be a simple string name or kebab kase name. `Examples of valid language codes include "magma", "maggioli-editore", etc.` |
43
+ | `name` | `name` | `string` | `'default'` | Specifies the theme name attribute A string representing the theme name, in lowercase kebab-case. |
42
44
  | `scheme` | `scheme` | `"all" \| "dark" \| "light"` | `'all'` | Specifies the theme scheme which can be 'light', 'dark' or 'all' Default is 'all' which means this theme supporto both light and dark. If you set 'light' means this theme support only light mode and will be forced and shown light colors mode only. |
43
45
  | `size` | `size` | `"md" \| "sm" \| undefined` | - | Sets the size of the component items nested inside it |
44
46
 
@@ -51,7 +51,7 @@ The default slot is reserved exclusively for `<mds-pref-theme-item>` elements. A
51
51
 
52
52
  #### Do Not Use an Invalid Theme Name
53
53
 
54
- The `name` prop must match the pattern `^[a-z]+(-[a-z]+)*$` (lowercase letters and hyphens only). Any other value - including uppercase, underscores, or spaces - throws a runtime error when the component tries to apply the theme class on `<html>`.
54
+ The `name` prop must match the pattern `^[a-z]+(-[a-z]+)*$` (lowercase letters and hyphens only). Any other value - including uppercase, underscores, or spaces - is ignored with a console warning when the component tries to apply the theme on `<html>`: the theme is neither applied nor stored.
55
55
 
56
56
  ```html
57
57
  <!-- INCORRECT -->
@@ -85,7 +85,7 @@ The `name` prop must match the pattern `^[a-z]+(-[a-z]+)*$` (lowercase letters a
85
85
 
86
86
  #### Do Not Give the Parent and the Child Different Sizes
87
87
 
88
- `<mds-pref>` forwards its own `size` to all `mds-pref-*` children only when that prop changes after load, not from the initial markup, and then it overwrites theirs. A `size` on `<mds-pref-theme>` that differs from the parent's renders the child's value at load and flips to the parent's on its next change: give the children one `size`.
88
+ `<mds-pref>` forwards its own `size` to all `mds-pref-*` children, on load and when it changes, and overwrites theirs: a `size` on `<mds-pref-theme>` that differs from the parent's is never shown. Set the size on the parent only.
89
89
 
90
90
  ```html
91
91
  <!-- INCORRECT -->
@@ -96,8 +96,8 @@ The `name` prop must match the pattern `^[a-z]+(-[a-z]+)*$` (lowercase letters a
96
96
  </mds-pref>
97
97
 
98
98
  <!-- CORRECT -->
99
- <mds-pref>
100
- <mds-pref-theme size="sm" name="default" scheme="all">
99
+ <mds-pref size="sm">
100
+ <mds-pref-theme name="default" scheme="all">
101
101
  <mds-pref-theme-item label="Predefinito" name="default" scheme="all"></mds-pref-theme-item>
102
102
  </mds-pref-theme>
103
103
  </mds-pref>