@maggioli-design-system/magma 2.0.0 → 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1540) hide show
  1. package/AGENTS.md +71 -0
  2. package/agents/anti-patterns.md +39 -0
  3. package/agents/assets.md +203 -0
  4. package/agents/color.md +193 -0
  5. package/agents/components.md +129 -0
  6. package/agents/conventions.md +188 -0
  7. package/agents/install.md +152 -0
  8. package/agents/theming.md +140 -0
  9. package/agents/typography.md +32 -0
  10. package/agents/variants.md +112 -0
  11. package/dist/cjs/floating-controller-uOCBLTk2.js +369 -0
  12. package/dist/cjs/form-Bk2OHlHM.js +46 -0
  13. package/dist/cjs/index-MyEb-PfD.js +198 -0
  14. package/dist/cjs/index-UmmmCMIG.js +5184 -0
  15. package/dist/cjs/index.cjs.js +65 -23
  16. package/dist/cjs/loader.cjs.js +2 -2
  17. package/dist/cjs/locale-CnorkBwF.js +816 -0
  18. package/dist/cjs/magma-components.cjs.js +2 -2
  19. package/dist/cjs/mds-accordion-item.cjs.entry.js +2 -2
  20. package/dist/cjs/mds-accordion-timer-item.cjs.entry.js +2 -2
  21. package/dist/cjs/mds-accordion-timer.cjs.entry.js +1 -1
  22. package/dist/cjs/mds-accordion.cjs.entry.js +2 -2
  23. package/dist/cjs/mds-author.cjs.entry.js +1 -1
  24. package/dist/cjs/mds-avatar-stack-item.cjs.entry.js +1 -1
  25. package/dist/cjs/mds-avatar-stack.cjs.entry.js +1 -1
  26. package/dist/cjs/mds-avatar.cjs.entry.js +29 -34
  27. package/dist/cjs/mds-badge.cjs.entry.js +5 -4
  28. package/dist/cjs/mds-banner_3.cjs.entry.js +3 -3
  29. package/dist/cjs/mds-benchmark-bar.cjs.entry.js +4 -3
  30. package/dist/cjs/mds-bibliography.cjs.entry.js +5 -4
  31. package/dist/cjs/mds-breadcrumb-item.cjs.entry.js +1 -1
  32. package/dist/cjs/mds-breadcrumb.cjs.entry.js +3 -3
  33. package/dist/cjs/mds-button-dropdown.cjs.entry.js +38 -4
  34. package/dist/cjs/mds-button-group.cjs.entry.js +1 -1
  35. package/dist/cjs/mds-button_3.cjs.entry.js +42 -15
  36. package/dist/cjs/mds-calendar_2.cjs.entry.js +2 -2
  37. package/dist/cjs/mds-card-content.cjs.entry.js +1 -1
  38. package/dist/cjs/mds-card-footer.cjs.entry.js +1 -1
  39. package/dist/cjs/mds-card-header.cjs.entry.js +1 -1
  40. package/dist/cjs/mds-card-media.cjs.entry.js +1 -1
  41. package/dist/cjs/mds-card.cjs.entry.js +2 -2
  42. package/dist/cjs/mds-details.cjs.entry.js +2 -2
  43. package/dist/cjs/mds-dropdown.cjs.entry.js +7 -6
  44. package/dist/cjs/mds-emoji.cjs.entry.js +2 -2
  45. package/dist/cjs/mds-entity.cjs.entry.js +3 -3
  46. package/dist/cjs/mds-file-preview.cjs.entry.js +20 -20
  47. package/dist/cjs/mds-file.cjs.entry.js +3 -3
  48. package/dist/cjs/mds-filter-item.cjs.entry.js +2 -2
  49. package/dist/cjs/mds-filter.cjs.entry.js +2 -2
  50. package/dist/cjs/mds-header-bar.cjs.entry.js +2 -2
  51. package/dist/cjs/mds-header.cjs.entry.js +19 -10
  52. package/dist/cjs/mds-horizontal-scroll.cjs.entry.js +1 -1
  53. package/dist/cjs/mds-hr.cjs.entry.js +2 -2
  54. package/dist/cjs/mds-img.cjs.entry.js +6 -6
  55. package/dist/cjs/mds-input-date-range-preselection.cjs.entry.js +1 -1
  56. package/dist/cjs/mds-input-date-range.cjs.entry.js +95 -13
  57. package/dist/cjs/mds-input-date.cjs.entry.js +124 -27
  58. package/dist/cjs/mds-input-field.cjs.entry.js +1 -1
  59. package/dist/cjs/mds-input-otp.cjs.entry.js +65 -19
  60. package/dist/cjs/mds-input-range.cjs.entry.js +32 -16
  61. package/dist/cjs/mds-input-select.cjs.entry.js +166 -35
  62. package/dist/cjs/mds-input-switch_2.cjs.entry.js +63 -21
  63. package/dist/cjs/mds-input-tip_2.cjs.entry.js +3 -3
  64. package/dist/cjs/mds-input-upload.cjs.entry.js +141 -68
  65. package/dist/cjs/mds-input.cjs.entry.js +320 -36
  66. package/dist/cjs/mds-keyboard-key.cjs.entry.js +11 -8
  67. package/dist/cjs/mds-keyboard.cjs.entry.js +9 -6
  68. package/dist/cjs/mds-kpi-item.cjs.entry.js +2 -2
  69. package/dist/cjs/mds-kpi.cjs.entry.js +1 -1
  70. package/dist/cjs/mds-label.cjs.entry.js +3 -3
  71. package/dist/cjs/mds-list-item.cjs.entry.js +2 -2
  72. package/dist/cjs/mds-list.cjs.entry.js +1 -1
  73. package/dist/cjs/mds-mention.cjs.entry.js +6 -5
  74. package/dist/cjs/mds-modal.cjs.entry.js +2 -2
  75. package/dist/cjs/mds-note.cjs.entry.js +3 -3
  76. package/dist/cjs/mds-notification.cjs.entry.js +13 -10
  77. package/dist/cjs/mds-paginator-item.cjs.entry.js +2 -2
  78. package/dist/cjs/mds-paginator.cjs.entry.js +2 -2
  79. package/dist/cjs/mds-policy-ai.cjs.entry.js +3 -3
  80. package/dist/cjs/mds-pref-animation.cjs.entry.js +29 -5
  81. package/dist/cjs/mds-pref-consumption.cjs.entry.js +29 -5
  82. package/dist/cjs/mds-pref-contrast.cjs.entry.js +27 -6
  83. package/dist/cjs/mds-pref-language-item.cjs.entry.js +6 -5
  84. package/dist/cjs/mds-pref-language.cjs.entry.js +3 -3
  85. package/dist/cjs/mds-pref-mode.cjs.entry.js +30 -7
  86. package/dist/cjs/mds-pref-theme-item.cjs.entry.js +4 -3
  87. package/dist/cjs/mds-pref-theme.cjs.entry.js +3 -3
  88. package/dist/cjs/mds-pref.cjs.entry.js +10 -5
  89. package/dist/cjs/mds-price-table-features-cell.cjs.entry.js +2 -2
  90. package/dist/cjs/mds-price-table-features-row.cjs.entry.js +2 -2
  91. package/dist/cjs/mds-price-table-features.cjs.entry.js +2 -2
  92. package/dist/cjs/mds-price-table-header.cjs.entry.js +1 -1
  93. package/dist/cjs/mds-price-table-list-item.cjs.entry.js +1 -1
  94. package/dist/cjs/mds-price-table-list.cjs.entry.js +2 -2
  95. package/dist/cjs/mds-price-table.cjs.entry.js +1 -1
  96. package/dist/cjs/mds-progress_2.cjs.entry.js +2 -2
  97. package/dist/cjs/mds-push-notification-item.cjs.entry.js +4 -4
  98. package/dist/cjs/mds-push-notification.cjs.entry.js +2 -2
  99. package/dist/cjs/mds-quote.cjs.entry.js +2 -2
  100. package/dist/cjs/mds-radial-menu-item.cjs.entry.js +1 -1
  101. package/dist/cjs/mds-radial-menu.cjs.entry.js +2 -2
  102. package/dist/cjs/mds-separator.cjs.entry.js +2 -2
  103. package/dist/cjs/mds-status-bar.cjs.entry.js +2 -2
  104. package/dist/cjs/mds-stepper-bar-item.cjs.entry.js +3 -3
  105. package/dist/cjs/mds-stepper-bar.cjs.entry.js +6 -4
  106. package/dist/cjs/mds-tab-bar-item.cjs.entry.js +5 -4
  107. package/dist/cjs/mds-tab-bar.cjs.entry.js +2 -2
  108. package/dist/cjs/mds-tab_2.cjs.entry.js +2 -2
  109. package/dist/cjs/mds-table-body.cjs.entry.js +2 -2
  110. package/dist/cjs/mds-table-footer.cjs.entry.js +2 -2
  111. package/dist/cjs/mds-table-header-cell.cjs.entry.js +4 -4
  112. package/dist/cjs/mds-table-header.cjs.entry.js +3 -3
  113. package/dist/cjs/mds-table-row.cjs.entry.js +3 -3
  114. package/dist/cjs/mds-table.cjs.entry.js +3 -3
  115. package/dist/cjs/mds-text.cjs.entry.js +4 -3
  116. package/dist/cjs/mds-toast.cjs.entry.js +11 -5
  117. package/dist/cjs/mds-tooltip.cjs.entry.js +7 -7
  118. package/dist/cjs/mds-tree-item.cjs.entry.js +3 -3
  119. package/dist/cjs/mds-tree.cjs.entry.js +1 -1
  120. package/dist/cjs/mds-url-view.cjs.entry.js +3 -3
  121. package/dist/cjs/mds-usage.cjs.entry.js +3 -3
  122. package/dist/cjs/mds-video-wall.cjs.entry.js +1 -1
  123. package/dist/cjs/mds-zero.cjs.entry.js +2 -2
  124. package/dist/cjs/preference-DRkzNp5a.js +389 -0
  125. package/dist/collection/common/form.js +24 -1
  126. package/dist/collection/common/validity/index.js +42 -0
  127. package/dist/collection/components/mds-accordion/AGENTS.md +65 -0
  128. package/dist/collection/components/mds-accordion/antipattern.md +123 -0
  129. package/dist/collection/components/mds-accordion/documentation.json +172 -0
  130. package/dist/collection/components/mds-accordion/pattern.md +150 -0
  131. package/dist/collection/components/mds-accordion-item/AGENTS.md +76 -0
  132. package/dist/collection/components/mds-accordion-item/antipattern.md +137 -0
  133. package/dist/collection/components/mds-accordion-item/documentation.json +288 -0
  134. package/dist/collection/components/mds-accordion-item/pattern.md +156 -0
  135. package/dist/collection/components/mds-accordion-timer/AGENTS.md +65 -0
  136. package/dist/collection/components/mds-accordion-timer/antipattern.md +133 -0
  137. package/dist/collection/components/mds-accordion-timer/documentation.json +168 -0
  138. package/dist/collection/components/mds-accordion-timer/pattern.md +137 -0
  139. package/dist/collection/components/mds-accordion-timer-item/AGENTS.md +82 -0
  140. package/dist/collection/components/mds-accordion-timer-item/antipattern.md +143 -0
  141. package/dist/collection/components/mds-accordion-timer-item/documentation.json +400 -0
  142. package/dist/collection/components/mds-accordion-timer-item/pattern.md +136 -0
  143. package/dist/collection/components/mds-author/AGENTS.md +40 -0
  144. package/dist/collection/components/mds-author/antipattern.md +106 -0
  145. package/dist/collection/components/mds-author/documentation.json +51 -0
  146. package/dist/collection/components/mds-author/pattern.md +101 -0
  147. package/dist/collection/components/mds-avatar/AGENTS.md +70 -0
  148. package/dist/collection/components/mds-avatar/antipattern.md +96 -0
  149. package/dist/collection/components/mds-avatar/documentation.json +362 -0
  150. package/dist/collection/components/mds-avatar/mds-avatar.js +27 -32
  151. package/dist/collection/components/mds-avatar/pattern.md +108 -0
  152. package/dist/collection/components/mds-avatar-stack/AGENTS.md +65 -0
  153. package/dist/collection/components/mds-avatar-stack/antipattern.md +122 -0
  154. package/dist/collection/components/mds-avatar-stack/documentation.json +196 -0
  155. package/dist/collection/components/mds-avatar-stack/pattern.md +125 -0
  156. package/dist/collection/components/mds-avatar-stack-item/AGENTS.md +60 -0
  157. package/dist/collection/components/mds-avatar-stack-item/antipattern.md +113 -0
  158. package/dist/collection/components/mds-avatar-stack-item/documentation.json +315 -0
  159. package/dist/collection/components/mds-avatar-stack-item/pattern.md +105 -0
  160. package/dist/collection/components/mds-badge/AGENTS.md +63 -0
  161. package/dist/collection/components/mds-badge/antipattern.md +104 -0
  162. package/dist/collection/components/mds-badge/documentation.json +316 -0
  163. package/dist/collection/components/mds-badge/mds-badge.js +3 -2
  164. package/dist/collection/components/mds-badge/pattern.md +130 -0
  165. package/dist/collection/components/mds-banner/AGENTS.md +87 -0
  166. package/dist/collection/components/mds-banner/antipattern.md +141 -0
  167. package/dist/collection/components/mds-banner/documentation.json +378 -0
  168. package/dist/collection/components/mds-banner/pattern.md +176 -0
  169. package/dist/collection/components/mds-benchmark-bar/AGENTS.md +59 -0
  170. package/dist/collection/components/mds-benchmark-bar/antipattern.md +77 -0
  171. package/dist/collection/components/mds-benchmark-bar/documentation.json +313 -0
  172. package/dist/collection/components/mds-benchmark-bar/mds-benchmark-bar.js +3 -2
  173. package/dist/collection/components/mds-benchmark-bar/pattern.md +102 -0
  174. package/dist/collection/components/mds-bibliography/AGENTS.md +61 -0
  175. package/dist/collection/components/mds-bibliography/antipattern.md +130 -0
  176. package/dist/collection/components/mds-bibliography/documentation.json +407 -0
  177. package/dist/collection/components/mds-bibliography/mds-bibliography.js +4 -3
  178. package/dist/collection/components/mds-bibliography/pattern.md +142 -0
  179. package/dist/collection/components/mds-breadcrumb/AGENTS.md +68 -0
  180. package/dist/collection/components/mds-breadcrumb/antipattern.md +112 -0
  181. package/dist/collection/components/mds-breadcrumb/documentation.json +156 -0
  182. package/dist/collection/components/mds-breadcrumb/pattern.md +103 -0
  183. package/dist/collection/components/mds-breadcrumb-item/AGENTS.md +67 -0
  184. package/dist/collection/components/mds-breadcrumb-item/antipattern.md +109 -0
  185. package/dist/collection/components/mds-breadcrumb-item/documentation.json +160 -0
  186. package/dist/collection/components/mds-breadcrumb-item/pattern.md +85 -0
  187. package/dist/collection/components/mds-button/AGENTS.md +102 -0
  188. package/dist/collection/components/mds-button/antipattern.md +126 -0
  189. package/dist/collection/components/mds-button/documentation.json +922 -0
  190. package/dist/collection/components/mds-button/mds-button.css +4 -1
  191. package/dist/collection/components/mds-button/mds-button.js +48 -8
  192. package/dist/collection/components/mds-button/pattern.md +172 -0
  193. package/dist/collection/components/mds-button-dropdown/AGENTS.md +88 -0
  194. package/dist/collection/components/mds-button-dropdown/antipattern.md +158 -0
  195. package/dist/collection/components/mds-button-dropdown/documentation.json +614 -0
  196. package/dist/collection/components/mds-button-dropdown/mds-button-dropdown.js +94 -6
  197. package/dist/collection/components/mds-button-dropdown/pattern.md +164 -0
  198. package/dist/collection/components/mds-button-group/AGENTS.md +33 -0
  199. package/dist/collection/components/mds-button-group/antipattern.md +105 -0
  200. package/dist/collection/components/mds-button-group/documentation.json +43 -0
  201. package/dist/collection/components/mds-button-group/pattern.md +89 -0
  202. package/dist/collection/components/mds-calendar/AGENTS.md +96 -0
  203. package/dist/collection/components/mds-calendar/antipattern.md +113 -0
  204. package/dist/collection/components/mds-calendar/documentation.json +626 -0
  205. package/dist/collection/components/mds-calendar/pattern.md +128 -0
  206. package/dist/collection/components/mds-calendar-cell/AGENTS.md +94 -0
  207. package/dist/collection/components/mds-calendar-cell/antipattern.md +58 -0
  208. package/dist/collection/components/mds-calendar-cell/documentation.json +539 -0
  209. package/dist/collection/components/mds-calendar-cell/pattern.md +82 -0
  210. package/dist/collection/components/mds-card/AGENTS.md +60 -0
  211. package/dist/collection/components/mds-card/antipattern.md +133 -0
  212. package/dist/collection/components/mds-card/documentation.json +117 -0
  213. package/dist/collection/components/mds-card/pattern.md +160 -0
  214. package/dist/collection/components/mds-card-content/AGENTS.md +34 -0
  215. package/dist/collection/components/mds-card-content/antipattern.md +110 -0
  216. package/dist/collection/components/mds-card-content/documentation.json +43 -0
  217. package/dist/collection/components/mds-card-content/pattern.md +91 -0
  218. package/dist/collection/components/mds-card-footer/AGENTS.md +34 -0
  219. package/dist/collection/components/mds-card-footer/antipattern.md +112 -0
  220. package/dist/collection/components/mds-card-footer/documentation.json +43 -0
  221. package/dist/collection/components/mds-card-footer/pattern.md +95 -0
  222. package/dist/collection/components/mds-card-header/AGENTS.md +38 -0
  223. package/dist/collection/components/mds-card-header/antipattern.md +114 -0
  224. package/dist/collection/components/mds-card-header/documentation.json +51 -0
  225. package/dist/collection/components/mds-card-header/pattern.md +143 -0
  226. package/dist/collection/components/mds-card-media/AGENTS.md +46 -0
  227. package/dist/collection/components/mds-card-media/antipattern.md +128 -0
  228. package/dist/collection/components/mds-card-media/documentation.json +56 -0
  229. package/dist/collection/components/mds-card-media/pattern.md +93 -0
  230. package/dist/collection/components/mds-chip/AGENTS.md +84 -0
  231. package/dist/collection/components/mds-chip/antipattern.md +119 -0
  232. package/dist/collection/components/mds-chip/documentation.json +535 -0
  233. package/dist/collection/components/mds-chip/pattern.md +166 -0
  234. package/dist/collection/components/mds-details/AGENTS.md +72 -0
  235. package/dist/collection/components/mds-details/antipattern.md +128 -0
  236. package/dist/collection/components/mds-details/documentation.json +153 -0
  237. package/dist/collection/components/mds-details/pattern.md +138 -0
  238. package/dist/collection/components/mds-dropdown/AGENTS.md +95 -0
  239. package/dist/collection/components/mds-dropdown/antipattern.md +137 -0
  240. package/dist/collection/components/mds-dropdown/documentation.json +701 -0
  241. package/dist/collection/components/mds-dropdown/mds-dropdown.js +4 -3
  242. package/dist/collection/components/mds-dropdown/pattern.md +201 -0
  243. package/dist/collection/components/mds-emoji/AGENTS.md +88 -0
  244. package/dist/collection/components/mds-emoji/antipattern.md +134 -0
  245. package/dist/collection/components/mds-emoji/documentation.json +506 -0
  246. package/dist/collection/components/mds-emoji/pattern.md +219 -0
  247. package/dist/collection/components/mds-entity/AGENTS.md +76 -0
  248. package/dist/collection/components/mds-entity/antipattern.md +112 -0
  249. package/dist/collection/components/mds-entity/documentation.json +365 -0
  250. package/dist/collection/components/mds-entity/pattern.md +125 -0
  251. package/dist/collection/components/mds-file/AGENTS.md +63 -0
  252. package/dist/collection/components/mds-file/antipattern.md +92 -0
  253. package/dist/collection/components/mds-file/documentation.json +484 -0
  254. package/dist/collection/components/mds-file/pattern.md +109 -0
  255. package/dist/collection/components/mds-file-preview/AGENTS.md +88 -0
  256. package/dist/collection/components/mds-file-preview/antipattern.md +129 -0
  257. package/dist/collection/components/mds-file-preview/documentation.json +780 -0
  258. package/dist/collection/components/mds-file-preview/mds-file-preview.js +6 -7
  259. package/dist/collection/components/mds-file-preview/pattern.md +164 -0
  260. package/dist/collection/components/mds-filter/AGENTS.md +72 -0
  261. package/dist/collection/components/mds-filter/antipattern.md +140 -0
  262. package/dist/collection/components/mds-filter/documentation.json +239 -0
  263. package/dist/collection/components/mds-filter/pattern.md +129 -0
  264. package/dist/collection/components/mds-filter-item/AGENTS.md +64 -0
  265. package/dist/collection/components/mds-filter-item/antipattern.md +127 -0
  266. package/dist/collection/components/mds-filter-item/documentation.json +240 -0
  267. package/dist/collection/components/mds-filter-item/pattern.md +125 -0
  268. package/dist/collection/components/mds-header/AGENTS.md +95 -0
  269. package/dist/collection/components/mds-header/antipattern.md +120 -0
  270. package/dist/collection/components/mds-header/documentation.json +491 -0
  271. package/dist/collection/components/mds-header/mds-header.js +17 -8
  272. package/dist/collection/components/mds-header/pattern.md +182 -0
  273. package/dist/collection/components/mds-header-bar/AGENTS.md +80 -0
  274. package/dist/collection/components/mds-header-bar/antipattern.md +119 -0
  275. package/dist/collection/components/mds-header-bar/documentation.json +251 -0
  276. package/dist/collection/components/mds-header-bar/pattern.md +134 -0
  277. package/dist/collection/components/mds-help/AGENTS.md +65 -0
  278. package/dist/collection/components/mds-help/antipattern.md +73 -0
  279. package/dist/collection/components/mds-help/documentation.json +228 -0
  280. package/dist/collection/components/mds-help/pattern.md +106 -0
  281. package/dist/collection/components/mds-horizontal-scroll/AGENTS.md +72 -0
  282. package/dist/collection/components/mds-horizontal-scroll/antipattern.md +120 -0
  283. package/dist/collection/components/mds-horizontal-scroll/documentation.json +279 -0
  284. package/dist/collection/components/mds-horizontal-scroll/pattern.md +154 -0
  285. package/dist/collection/components/mds-hr/AGENTS.md +27 -0
  286. package/dist/collection/components/mds-hr/antipattern.md +84 -0
  287. package/dist/collection/components/mds-hr/documentation.json +33 -0
  288. package/dist/collection/components/mds-hr/pattern.md +88 -0
  289. package/dist/collection/components/mds-icon/AGENTS.md +52 -0
  290. package/dist/collection/components/mds-icon/antipattern.md +118 -0
  291. package/dist/collection/components/mds-icon/documentation.json +205 -0
  292. package/dist/collection/components/mds-icon/mds-icon.js +29 -4
  293. package/dist/collection/components/mds-icon/pattern.md +135 -0
  294. package/dist/collection/components/mds-icon/services/icons-set.service.js +47 -18
  295. package/dist/collection/components/mds-img/AGENTS.md +78 -0
  296. package/dist/collection/components/mds-img/antipattern.md +106 -0
  297. package/dist/collection/components/mds-img/documentation.json +470 -0
  298. package/dist/collection/components/mds-img/mds-img.js +3 -3
  299. package/dist/collection/components/mds-img/pattern.md +128 -0
  300. package/dist/collection/components/mds-input/AGENTS.md +138 -0
  301. package/dist/collection/components/mds-input/antipattern.md +128 -0
  302. package/dist/collection/components/mds-input/documentation.json +1574 -0
  303. package/dist/collection/components/mds-input/mds-input.js +185 -30
  304. package/dist/collection/components/mds-input/meta/input-type/InputValidationManager.js +8 -1
  305. package/dist/collection/components/mds-input/meta/validators.js +100 -2
  306. package/dist/collection/components/mds-input/meta/validity.js +35 -0
  307. package/dist/collection/components/mds-input/pattern.md +252 -0
  308. package/dist/collection/components/mds-input-date/AGENTS.md +98 -0
  309. package/dist/collection/components/mds-input-date/antipattern.md +107 -0
  310. package/dist/collection/components/mds-input-date/documentation.json +638 -0
  311. package/dist/collection/components/mds-input-date/mds-input-date.js +130 -24
  312. package/dist/collection/components/mds-input-date/pattern.md +158 -0
  313. package/dist/collection/components/mds-input-date-range/AGENTS.md +90 -0
  314. package/dist/collection/components/mds-input-date-range/antipattern.md +168 -0
  315. package/dist/collection/components/mds-input-date-range/documentation.json +502 -0
  316. package/dist/collection/components/mds-input-date-range/mds-input-date-range.css +13 -0
  317. package/dist/collection/components/mds-input-date-range/mds-input-date-range.js +112 -9
  318. package/dist/collection/components/mds-input-date-range/pattern.md +122 -0
  319. package/dist/collection/components/mds-input-date-range-preselection/AGENTS.md +62 -0
  320. package/dist/collection/components/mds-input-date-range-preselection/antipattern.md +147 -0
  321. package/dist/collection/components/mds-input-date-range-preselection/documentation.json +176 -0
  322. package/dist/collection/components/mds-input-date-range-preselection/pattern.md +101 -0
  323. package/dist/collection/components/mds-input-field/AGENTS.md +60 -0
  324. package/dist/collection/components/mds-input-field/antipattern.md +115 -0
  325. package/dist/collection/components/mds-input-field/documentation.json +178 -0
  326. package/dist/collection/components/mds-input-field/pattern.md +95 -0
  327. package/dist/collection/components/mds-input-otp/AGENTS.md +48 -0
  328. package/dist/collection/components/mds-input-otp/antipattern.md +105 -0
  329. package/dist/collection/components/mds-input-otp/documentation.json +203 -0
  330. package/dist/collection/components/mds-input-otp/mds-input-otp.css +4 -1
  331. package/dist/collection/components/mds-input-otp/mds-input-otp.js +88 -15
  332. package/dist/collection/components/mds-input-otp/pattern.md +107 -0
  333. package/dist/collection/components/mds-input-range/AGENTS.md +84 -0
  334. package/dist/collection/components/mds-input-range/antipattern.md +127 -0
  335. package/dist/collection/components/mds-input-range/documentation.json +315 -0
  336. package/dist/collection/components/mds-input-range/mds-input-range.css +6 -2
  337. package/dist/collection/components/mds-input-range/mds-input-range.js +30 -13
  338. package/dist/collection/components/mds-input-range/pattern.md +110 -0
  339. package/dist/collection/components/mds-input-select/AGENTS.md +99 -0
  340. package/dist/collection/components/mds-input-select/antipattern.md +126 -0
  341. package/dist/collection/components/mds-input-select/documentation.json +552 -0
  342. package/dist/collection/components/mds-input-select/mds-input-select.js +171 -40
  343. package/dist/collection/components/mds-input-select/meta/event-detail.js +1 -0
  344. package/dist/collection/components/mds-input-select/pattern.md +168 -0
  345. package/dist/collection/components/mds-input-switch/AGENTS.md +106 -0
  346. package/dist/collection/components/mds-input-switch/antipattern.md +117 -0
  347. package/dist/collection/components/mds-input-switch/documentation.json +638 -0
  348. package/dist/collection/components/mds-input-switch/mds-input-switch.css +4 -1
  349. package/dist/collection/components/mds-input-switch/mds-input-switch.js +59 -16
  350. package/dist/collection/components/mds-input-switch/pattern.md +133 -0
  351. package/dist/collection/components/mds-input-tip/AGENTS.md +56 -0
  352. package/dist/collection/components/mds-input-tip/antipattern.md +108 -0
  353. package/dist/collection/components/mds-input-tip/documentation.json +160 -0
  354. package/dist/collection/components/mds-input-tip/pattern.md +125 -0
  355. package/dist/collection/components/mds-input-tip-item/AGENTS.md +58 -0
  356. package/dist/collection/components/mds-input-tip-item/antipattern.md +98 -0
  357. package/dist/collection/components/mds-input-tip-item/documentation.json +181 -0
  358. package/dist/collection/components/mds-input-tip-item/pattern.md +107 -0
  359. package/dist/collection/components/mds-input-upload/AGENTS.md +78 -0
  360. package/dist/collection/components/mds-input-upload/antipattern.md +144 -0
  361. package/dist/collection/components/mds-input-upload/documentation.json +425 -0
  362. package/dist/collection/components/mds-input-upload/mds-input-upload.css +15 -0
  363. package/dist/collection/components/mds-input-upload/mds-input-upload.js +181 -67
  364. package/dist/collection/components/mds-input-upload/pattern.md +165 -0
  365. package/dist/collection/components/mds-keyboard/AGENTS.md +76 -0
  366. package/dist/collection/components/mds-keyboard/antipattern.md +111 -0
  367. package/dist/collection/components/mds-keyboard/documentation.json +227 -0
  368. package/dist/collection/components/mds-keyboard/mds-keyboard.js +6 -3
  369. package/dist/collection/components/mds-keyboard/pattern.md +129 -0
  370. package/dist/collection/components/mds-keyboard-key/AGENTS.md +55 -0
  371. package/dist/collection/components/mds-keyboard-key/antipattern.md +117 -0
  372. package/dist/collection/components/mds-keyboard-key/documentation.json +450 -0
  373. package/dist/collection/components/mds-keyboard-key/mds-keyboard-key.js +8 -5
  374. package/dist/collection/components/mds-keyboard-key/pattern.md +98 -0
  375. package/dist/collection/components/mds-kpi/AGENTS.md +44 -0
  376. package/dist/collection/components/mds-kpi/antipattern.md +93 -0
  377. package/dist/collection/components/mds-kpi/documentation.json +54 -0
  378. package/dist/collection/components/mds-kpi/pattern.md +109 -0
  379. package/dist/collection/components/mds-kpi-item/AGENTS.md +62 -0
  380. package/dist/collection/components/mds-kpi-item/antipattern.md +119 -0
  381. package/dist/collection/components/mds-kpi-item/documentation.json +199 -0
  382. package/dist/collection/components/mds-kpi-item/pattern.md +115 -0
  383. package/dist/collection/components/mds-label/AGENTS.md +71 -0
  384. package/dist/collection/components/mds-label/antipattern.md +92 -0
  385. package/dist/collection/components/mds-label/documentation.json +388 -0
  386. package/dist/collection/components/mds-label/pattern.md +111 -0
  387. package/dist/collection/components/mds-list/AGENTS.md +33 -0
  388. package/dist/collection/components/mds-list/antipattern.md +117 -0
  389. package/dist/collection/components/mds-list/documentation.json +43 -0
  390. package/dist/collection/components/mds-list/pattern.md +104 -0
  391. package/dist/collection/components/mds-list-item/AGENTS.md +60 -0
  392. package/dist/collection/components/mds-list-item/antipattern.md +118 -0
  393. package/dist/collection/components/mds-list-item/documentation.json +200 -0
  394. package/dist/collection/components/mds-list-item/pattern.md +101 -0
  395. package/dist/collection/components/mds-mention/AGENTS.md +55 -0
  396. package/dist/collection/components/mds-mention/antipattern.md +86 -0
  397. package/dist/collection/components/mds-mention/documentation.json +203 -0
  398. package/dist/collection/components/mds-mention/mds-mention.js +3 -2
  399. package/dist/collection/components/mds-mention/pattern.md +91 -0
  400. package/dist/collection/components/mds-modal/AGENTS.md +107 -0
  401. package/dist/collection/components/mds-modal/antipattern.md +96 -0
  402. package/dist/collection/components/mds-modal/documentation.json +552 -0
  403. package/dist/collection/components/mds-modal/pattern.md +228 -0
  404. package/dist/collection/components/mds-note/AGENTS.md +68 -0
  405. package/dist/collection/components/mds-note/antipattern.md +99 -0
  406. package/dist/collection/components/mds-note/documentation.json +220 -0
  407. package/dist/collection/components/mds-note/pattern.md +108 -0
  408. package/dist/collection/components/mds-notification/AGENTS.md +67 -0
  409. package/dist/collection/components/mds-notification/antipattern.md +86 -0
  410. package/dist/collection/components/mds-notification/documentation.json +253 -0
  411. package/dist/collection/components/mds-notification/mds-notification.js +11 -8
  412. package/dist/collection/components/mds-notification/pattern.md +98 -0
  413. package/dist/collection/components/mds-paginator/AGENTS.md +57 -0
  414. package/dist/collection/components/mds-paginator/antipattern.md +95 -0
  415. package/dist/collection/components/mds-paginator/documentation.json +135 -0
  416. package/dist/collection/components/mds-paginator/pattern.md +92 -0
  417. package/dist/collection/components/mds-paginator-item/AGENTS.md +74 -0
  418. package/dist/collection/components/mds-paginator-item/antipattern.md +95 -0
  419. package/dist/collection/components/mds-paginator-item/documentation.json +206 -0
  420. package/dist/collection/components/mds-paginator-item/pattern.md +75 -0
  421. package/dist/collection/components/mds-policy-ai/AGENTS.md +58 -0
  422. package/dist/collection/components/mds-policy-ai/antipattern.md +97 -0
  423. package/dist/collection/components/mds-policy-ai/documentation.json +244 -0
  424. package/dist/collection/components/mds-policy-ai/pattern.md +102 -0
  425. package/dist/collection/components/mds-pref/AGENTS.md +50 -0
  426. package/dist/collection/components/mds-pref/antipattern.md +85 -0
  427. package/dist/collection/components/mds-pref/documentation.json +138 -0
  428. package/dist/collection/components/mds-pref/mds-pref.js +7 -2
  429. package/dist/collection/components/mds-pref/pattern.md +93 -0
  430. package/dist/collection/components/mds-pref-animation/AGENTS.md +48 -0
  431. package/dist/collection/components/mds-pref-animation/antipattern.md +67 -0
  432. package/dist/collection/components/mds-pref-animation/documentation.json +154 -0
  433. package/dist/collection/components/mds-pref-animation/mds-pref-animation.js +26 -2
  434. package/dist/collection/components/mds-pref-animation/pattern.md +86 -0
  435. package/dist/collection/components/mds-pref-consumption/AGENTS.md +47 -0
  436. package/dist/collection/components/mds-pref-consumption/antipattern.md +84 -0
  437. package/dist/collection/components/mds-pref-consumption/documentation.json +154 -0
  438. package/dist/collection/components/mds-pref-consumption/mds-pref-consumption.js +26 -2
  439. package/dist/collection/components/mds-pref-consumption/pattern.md +70 -0
  440. package/dist/collection/components/mds-pref-contrast/AGENTS.md +50 -0
  441. package/dist/collection/components/mds-pref-contrast/antipattern.md +71 -0
  442. package/dist/collection/components/mds-pref-contrast/documentation.json +154 -0
  443. package/dist/collection/components/mds-pref-contrast/mds-pref-contrast.js +24 -3
  444. package/dist/collection/components/mds-pref-contrast/pattern.md +82 -0
  445. package/dist/collection/components/mds-pref-language/AGENTS.md +56 -0
  446. package/dist/collection/components/mds-pref-language/antipattern.md +130 -0
  447. package/dist/collection/components/mds-pref-language/documentation.json +174 -0
  448. package/dist/collection/components/mds-pref-language/pattern.md +104 -0
  449. package/dist/collection/components/mds-pref-language-item/AGENTS.md +48 -0
  450. package/dist/collection/components/mds-pref-language-item/antipattern.md +99 -0
  451. package/dist/collection/components/mds-pref-language-item/documentation.json +122 -0
  452. package/dist/collection/components/mds-pref-language-item/mds-pref-language-item.js +3 -2
  453. package/dist/collection/components/mds-pref-language-item/pattern.md +85 -0
  454. package/dist/collection/components/mds-pref-mode/AGENTS.md +53 -0
  455. package/dist/collection/components/mds-pref-mode/antipattern.md +104 -0
  456. package/dist/collection/components/mds-pref-mode/documentation.json +241 -0
  457. package/dist/collection/components/mds-pref-mode/mds-pref-mode.js +27 -4
  458. package/dist/collection/components/mds-pref-mode/pattern.md +94 -0
  459. package/dist/collection/components/mds-pref-theme/AGENTS.md +60 -0
  460. package/dist/collection/components/mds-pref-theme/antipattern.md +104 -0
  461. package/dist/collection/components/mds-pref-theme/documentation.json +277 -0
  462. package/dist/collection/components/mds-pref-theme/pattern.md +97 -0
  463. package/dist/collection/components/mds-pref-theme-item/AGENTS.md +60 -0
  464. package/dist/collection/components/mds-pref-theme-item/antipattern.md +98 -0
  465. package/dist/collection/components/mds-pref-theme-item/documentation.json +228 -0
  466. package/dist/collection/components/mds-pref-theme-item/mds-pref-theme-item.js +3 -2
  467. package/dist/collection/components/mds-pref-theme-item/pattern.md +98 -0
  468. package/dist/collection/components/mds-price-table/AGENTS.md +34 -0
  469. package/dist/collection/components/mds-price-table/antipattern.md +131 -0
  470. package/dist/collection/components/mds-price-table/documentation.json +43 -0
  471. package/dist/collection/components/mds-price-table/pattern.md +182 -0
  472. package/dist/collection/components/mds-price-table-features/AGENTS.md +61 -0
  473. package/dist/collection/components/mds-price-table-features/antipattern.md +152 -0
  474. package/dist/collection/components/mds-price-table-features/documentation.json +96 -0
  475. package/dist/collection/components/mds-price-table-features/pattern.md +157 -0
  476. package/dist/collection/components/mds-price-table-features-cell/AGENTS.md +69 -0
  477. package/dist/collection/components/mds-price-table-features-cell/antipattern.md +105 -0
  478. package/dist/collection/components/mds-price-table-features-cell/documentation.json +154 -0
  479. package/dist/collection/components/mds-price-table-features-cell/pattern.md +128 -0
  480. package/dist/collection/components/mds-price-table-features-row/AGENTS.md +43 -0
  481. package/dist/collection/components/mds-price-table-features-row/antipattern.md +135 -0
  482. package/dist/collection/components/mds-price-table-features-row/documentation.json +64 -0
  483. package/dist/collection/components/mds-price-table-features-row/pattern.md +125 -0
  484. package/dist/collection/components/mds-price-table-header/AGENTS.md +34 -0
  485. package/dist/collection/components/mds-price-table-header/antipattern.md +133 -0
  486. package/dist/collection/components/mds-price-table-header/documentation.json +43 -0
  487. package/dist/collection/components/mds-price-table-header/pattern.md +176 -0
  488. package/dist/collection/components/mds-price-table-list/AGENTS.md +63 -0
  489. package/dist/collection/components/mds-price-table-list/antipattern.md +133 -0
  490. package/dist/collection/components/mds-price-table-list/documentation.json +104 -0
  491. package/dist/collection/components/mds-price-table-list/pattern.md +134 -0
  492. package/dist/collection/components/mds-price-table-list-item/AGENTS.md +61 -0
  493. package/dist/collection/components/mds-price-table-list-item/antipattern.md +90 -0
  494. package/dist/collection/components/mds-price-table-list-item/documentation.json +145 -0
  495. package/dist/collection/components/mds-price-table-list-item/pattern.md +105 -0
  496. package/dist/collection/components/mds-progress/AGENTS.md +68 -0
  497. package/dist/collection/components/mds-progress/antipattern.md +94 -0
  498. package/dist/collection/components/mds-progress/documentation.json +375 -0
  499. package/dist/collection/components/mds-progress/pattern.md +139 -0
  500. package/dist/collection/components/mds-push-notification/AGENTS.md +88 -0
  501. package/dist/collection/components/mds-push-notification/antipattern.md +154 -0
  502. package/dist/collection/components/mds-push-notification/documentation.json +306 -0
  503. package/dist/collection/components/mds-push-notification/pattern.md +203 -0
  504. package/dist/collection/components/mds-push-notification-item/AGENTS.md +91 -0
  505. package/dist/collection/components/mds-push-notification-item/antipattern.md +129 -0
  506. package/dist/collection/components/mds-push-notification-item/documentation.json +586 -0
  507. package/dist/collection/components/mds-push-notification-item/pattern.md +201 -0
  508. package/dist/collection/components/mds-quote/AGENTS.md +51 -0
  509. package/dist/collection/components/mds-quote/antipattern.md +122 -0
  510. package/dist/collection/components/mds-quote/documentation.json +176 -0
  511. package/dist/collection/components/mds-quote/pattern.md +108 -0
  512. package/dist/collection/components/mds-radial-menu/AGENTS.md +87 -0
  513. package/dist/collection/components/mds-radial-menu/antipattern.md +104 -0
  514. package/dist/collection/components/mds-radial-menu/documentation.json +581 -0
  515. package/dist/collection/components/mds-radial-menu/pattern.md +150 -0
  516. package/dist/collection/components/mds-radial-menu-item/AGENTS.md +51 -0
  517. package/dist/collection/components/mds-radial-menu-item/antipattern.md +106 -0
  518. package/dist/collection/components/mds-radial-menu-item/documentation.json +294 -0
  519. package/dist/collection/components/mds-radial-menu-item/pattern.md +98 -0
  520. package/dist/collection/components/mds-radial-progress/AGENTS.md +58 -0
  521. package/dist/collection/components/mds-radial-progress/antipattern.md +99 -0
  522. package/dist/collection/components/mds-radial-progress/documentation.json +232 -0
  523. package/dist/collection/components/mds-radial-progress/pattern.md +132 -0
  524. package/dist/collection/components/mds-separator/AGENTS.md +39 -0
  525. package/dist/collection/components/mds-separator/antipattern.md +98 -0
  526. package/dist/collection/components/mds-separator/documentation.json +45 -0
  527. package/dist/collection/components/mds-separator/pattern.md +82 -0
  528. package/dist/collection/components/mds-spinner/AGENTS.md +49 -0
  529. package/dist/collection/components/mds-spinner/antipattern.md +93 -0
  530. package/dist/collection/components/mds-spinner/documentation.json +86 -0
  531. package/dist/collection/components/mds-spinner/pattern.md +102 -0
  532. package/dist/collection/components/mds-status-bar/AGENTS.md +75 -0
  533. package/dist/collection/components/mds-status-bar/antipattern.md +128 -0
  534. package/dist/collection/components/mds-status-bar/documentation.json +262 -0
  535. package/dist/collection/components/mds-status-bar/pattern.md +123 -0
  536. package/dist/collection/components/mds-stepper-bar/AGENTS.md +74 -0
  537. package/dist/collection/components/mds-stepper-bar/antipattern.md +123 -0
  538. package/dist/collection/components/mds-stepper-bar/documentation.json +208 -0
  539. package/dist/collection/components/mds-stepper-bar/mds-stepper-bar.js +5 -3
  540. package/dist/collection/components/mds-stepper-bar/pattern.md +182 -0
  541. package/dist/collection/components/mds-stepper-bar-item/AGENTS.md +84 -0
  542. package/dist/collection/components/mds-stepper-bar-item/antipattern.md +115 -0
  543. package/dist/collection/components/mds-stepper-bar-item/documentation.json +453 -0
  544. package/dist/collection/components/mds-stepper-bar-item/pattern.md +203 -0
  545. package/dist/collection/components/mds-tab/AGENTS.md +109 -0
  546. package/dist/collection/components/mds-tab/antipattern.md +164 -0
  547. package/dist/collection/components/mds-tab/documentation.json +495 -0
  548. package/dist/collection/components/mds-tab/pattern.md +201 -0
  549. package/dist/collection/components/mds-tab-bar/AGENTS.md +46 -0
  550. package/dist/collection/components/mds-tab-bar/antipattern.md +105 -0
  551. package/dist/collection/components/mds-tab-bar/documentation.json +71 -0
  552. package/dist/collection/components/mds-tab-bar/pattern.md +87 -0
  553. package/dist/collection/components/mds-tab-bar-item/AGENTS.md +67 -0
  554. package/dist/collection/components/mds-tab-bar-item/antipattern.md +116 -0
  555. package/dist/collection/components/mds-tab-bar-item/documentation.json +210 -0
  556. package/dist/collection/components/mds-tab-bar-item/mds-tab-bar-item.js +3 -2
  557. package/dist/collection/components/mds-tab-bar-item/pattern.md +110 -0
  558. package/dist/collection/components/mds-tab-item/AGENTS.md +82 -0
  559. package/dist/collection/components/mds-tab-item/antipattern.md +138 -0
  560. package/dist/collection/components/mds-tab-item/documentation.json +577 -0
  561. package/dist/collection/components/mds-tab-item/pattern.md +155 -0
  562. package/dist/collection/components/mds-table/AGENTS.md +90 -0
  563. package/dist/collection/components/mds-table/antipattern.md +169 -0
  564. package/dist/collection/components/mds-table/documentation.json +304 -0
  565. package/dist/collection/components/mds-table/pattern.md +288 -0
  566. package/dist/collection/components/mds-table-body/AGENTS.md +55 -0
  567. package/dist/collection/components/mds-table-body/antipattern.md +118 -0
  568. package/dist/collection/components/mds-table-body/documentation.json +122 -0
  569. package/dist/collection/components/mds-table-body/pattern.md +154 -0
  570. package/dist/collection/components/mds-table-cell/AGENTS.md +56 -0
  571. package/dist/collection/components/mds-table-cell/antipattern.md +100 -0
  572. package/dist/collection/components/mds-table-cell/documentation.json +104 -0
  573. package/dist/collection/components/mds-table-cell/pattern.md +168 -0
  574. package/dist/collection/components/mds-table-footer/AGENTS.md +33 -0
  575. package/dist/collection/components/mds-table-footer/antipattern.md +114 -0
  576. package/dist/collection/components/mds-table-footer/documentation.json +43 -0
  577. package/dist/collection/components/mds-table-footer/pattern.md +116 -0
  578. package/dist/collection/components/mds-table-header/AGENTS.md +61 -0
  579. package/dist/collection/components/mds-table-header/antipattern.md +157 -0
  580. package/dist/collection/components/mds-table-header/documentation.json +156 -0
  581. package/dist/collection/components/mds-table-header/pattern.md +158 -0
  582. package/dist/collection/components/mds-table-header-cell/AGENTS.md +51 -0
  583. package/dist/collection/components/mds-table-header-cell/antipattern.md +108 -0
  584. package/dist/collection/components/mds-table-header-cell/documentation.json +158 -0
  585. package/dist/collection/components/mds-table-header-cell/mds-table-header-cell.js +2 -2
  586. package/dist/collection/components/mds-table-header-cell/pattern.md +145 -0
  587. package/dist/collection/components/mds-table-row/AGENTS.md +68 -0
  588. package/dist/collection/components/mds-table-row/antipattern.md +142 -0
  589. package/dist/collection/components/mds-table-row/documentation.json +252 -0
  590. package/dist/collection/components/mds-table-row/pattern.md +157 -0
  591. package/dist/collection/components/mds-text/AGENTS.md +64 -0
  592. package/dist/collection/components/mds-text/antipattern.md +113 -0
  593. package/dist/collection/components/mds-text/documentation.json +746 -0
  594. package/dist/collection/components/mds-text/mds-text.js +2 -1
  595. package/dist/collection/components/mds-text/pattern.md +139 -0
  596. package/dist/collection/components/mds-toast/AGENTS.md +78 -0
  597. package/dist/collection/components/mds-toast/antipattern.md +131 -0
  598. package/dist/collection/components/mds-toast/documentation.json +339 -0
  599. package/dist/collection/components/mds-toast/mds-toast.js +9 -3
  600. package/dist/collection/components/mds-toast/pattern.md +161 -0
  601. package/dist/collection/components/mds-tooltip/AGENTS.md +80 -0
  602. package/dist/collection/components/mds-tooltip/antipattern.md +108 -0
  603. package/dist/collection/components/mds-tooltip/documentation.json +483 -0
  604. package/dist/collection/components/mds-tooltip/mds-tooltip.js +4 -4
  605. package/dist/collection/components/mds-tooltip/pattern.md +128 -0
  606. package/dist/collection/components/mds-tree/AGENTS.md +88 -0
  607. package/dist/collection/components/mds-tree/antipattern.md +153 -0
  608. package/dist/collection/components/mds-tree/documentation.json +472 -0
  609. package/dist/collection/components/mds-tree/pattern.md +198 -0
  610. package/dist/collection/components/mds-tree-item/AGENTS.md +119 -0
  611. package/dist/collection/components/mds-tree-item/antipattern.md +152 -0
  612. package/dist/collection/components/mds-tree-item/documentation.json +646 -0
  613. package/dist/collection/components/mds-tree-item/pattern.md +201 -0
  614. package/dist/collection/components/mds-url-view/AGENTS.md +63 -0
  615. package/dist/collection/components/mds-url-view/antipattern.md +107 -0
  616. package/dist/collection/components/mds-url-view/documentation.json +209 -0
  617. package/dist/collection/components/mds-url-view/pattern.md +106 -0
  618. package/dist/collection/components/mds-usage/AGENTS.md +70 -0
  619. package/dist/collection/components/mds-usage/antipattern.md +87 -0
  620. package/dist/collection/components/mds-usage/documentation.json +156 -0
  621. package/dist/collection/components/mds-usage/pattern.md +117 -0
  622. package/dist/collection/components/mds-video-wall/AGENTS.md +65 -0
  623. package/dist/collection/components/mds-video-wall/antipattern.md +97 -0
  624. package/dist/collection/components/mds-video-wall/documentation.json +316 -0
  625. package/dist/collection/components/mds-video-wall/pattern.md +101 -0
  626. package/dist/collection/components/mds-zero/AGENTS.md +55 -0
  627. package/dist/collection/components/mds-zero/antipattern.md +106 -0
  628. package/dist/collection/components/mds-zero/documentation.json +82 -0
  629. package/dist/collection/components/mds-zero/pattern.md +118 -0
  630. package/dist/collection/dictionary/icon.js +1 -1
  631. package/dist/components/index.js +1 -1
  632. package/dist/components/mds-accordion-item.js +1 -1
  633. package/dist/components/mds-accordion-timer-item.js +1 -1
  634. package/dist/components/mds-accordion-timer.js +1 -1
  635. package/dist/components/mds-accordion.js +1 -1
  636. package/dist/components/mds-author.js +1 -1
  637. package/dist/components/mds-avatar-stack-item.js +1 -1
  638. package/dist/components/mds-avatar-stack.js +1 -1
  639. package/dist/components/mds-avatar.js +1 -1
  640. package/dist/components/mds-badge.js +1 -1
  641. package/dist/components/mds-banner.js +1 -1
  642. package/dist/components/mds-benchmark-bar.js +1 -1
  643. package/dist/components/mds-bibliography.js +1 -1
  644. package/dist/components/mds-breadcrumb-item.js +1 -1
  645. package/dist/components/mds-breadcrumb.js +1 -1
  646. package/dist/components/mds-button-dropdown.js +1 -1
  647. package/dist/components/mds-button-group.js +1 -1
  648. package/dist/components/mds-button.js +1 -1
  649. package/dist/components/mds-calendar-cell.js +1 -1
  650. package/dist/components/mds-calendar.js +1 -1
  651. package/dist/components/mds-card-content.js +1 -1
  652. package/dist/components/mds-card-footer.js +1 -1
  653. package/dist/components/mds-card-header.js +1 -1
  654. package/dist/components/mds-card-media.js +1 -1
  655. package/dist/components/mds-card.js +1 -1
  656. package/dist/components/mds-chip.js +1 -1
  657. package/dist/components/mds-details.js +1 -1
  658. package/dist/components/mds-dropdown.js +1 -1
  659. package/dist/components/mds-emoji.js +3 -3
  660. package/dist/components/mds-entity.js +1 -1
  661. package/dist/components/mds-file-preview.js +1 -1
  662. package/dist/components/mds-file.js +3 -3
  663. package/dist/components/mds-filter-item.js +1 -1
  664. package/dist/components/mds-filter.js +1 -1
  665. package/dist/components/mds-header-bar.js +1 -1
  666. package/dist/components/mds-header.js +1 -1
  667. package/dist/components/mds-help.js +1 -1
  668. package/dist/components/mds-horizontal-scroll.js +1 -1
  669. package/dist/components/mds-hr.js +1 -1
  670. package/dist/components/mds-icon.js +1 -1
  671. package/dist/components/mds-img.js +1 -1
  672. package/dist/components/mds-input-date-range-preselection.js +1 -1
  673. package/dist/components/mds-input-date-range.js +1 -1
  674. package/dist/components/mds-input-date.js +1 -1
  675. package/dist/components/mds-input-field.js +1 -1
  676. package/dist/components/mds-input-otp.js +1 -1
  677. package/dist/components/mds-input-range.js +1 -1
  678. package/dist/components/mds-input-select.js +1 -1
  679. package/dist/components/mds-input-switch.js +1 -1
  680. package/dist/components/mds-input-tip-item.js +1 -1
  681. package/dist/components/mds-input-tip.js +1 -1
  682. package/dist/components/mds-input-upload.js +1 -1
  683. package/dist/components/mds-input.js +1 -1
  684. package/dist/components/mds-keyboard-key.js +1 -1
  685. package/dist/components/mds-keyboard.js +1 -1
  686. package/dist/components/mds-kpi-item.js +1 -1
  687. package/dist/components/mds-kpi.js +1 -1
  688. package/dist/components/mds-label.js +1 -1
  689. package/dist/components/mds-list-item.js +1 -1
  690. package/dist/components/mds-list.js +1 -1
  691. package/dist/components/mds-mention.js +1 -1
  692. package/dist/components/mds-modal.js +1 -1
  693. package/dist/components/mds-note.js +1 -1
  694. package/dist/components/mds-notification.js +1 -1
  695. package/dist/components/mds-paginator-item.js +1 -1
  696. package/dist/components/mds-paginator.js +1 -1
  697. package/dist/components/mds-policy-ai.js +1 -1
  698. package/dist/components/mds-pref-animation.js +1 -1
  699. package/dist/components/mds-pref-consumption.js +1 -1
  700. package/dist/components/mds-pref-contrast.js +1 -1
  701. package/dist/components/mds-pref-language-item.js +1 -1
  702. package/dist/components/mds-pref-language.js +1 -1
  703. package/dist/components/mds-pref-mode.js +1 -1
  704. package/dist/components/mds-pref-theme-item.js +1 -1
  705. package/dist/components/mds-pref-theme.js +1 -1
  706. package/dist/components/mds-pref.js +1 -1
  707. package/dist/components/mds-price-table-features-cell.js +1 -1
  708. package/dist/components/mds-price-table-features-row.js +1 -1
  709. package/dist/components/mds-price-table-features.js +1 -1
  710. package/dist/components/mds-price-table-header.js +1 -1
  711. package/dist/components/mds-price-table-list-item.js +1 -1
  712. package/dist/components/mds-price-table-list.js +1 -1
  713. package/dist/components/mds-price-table.js +1 -1
  714. package/dist/components/mds-progress.js +1 -1
  715. package/dist/components/mds-push-notification-item.js +1 -1
  716. package/dist/components/mds-push-notification.js +1 -1
  717. package/dist/components/mds-quote.js +1 -1
  718. package/dist/components/mds-radial-menu-item.js +1 -1
  719. package/dist/components/mds-radial-menu.js +1 -1
  720. package/dist/components/mds-radial-progress.js +1 -1
  721. package/dist/components/mds-separator.js +1 -1
  722. package/dist/components/mds-spinner.js +1 -1
  723. package/dist/components/mds-status-bar.js +1 -1
  724. package/dist/components/mds-stepper-bar-item.js +1 -1
  725. package/dist/components/mds-stepper-bar.js +1 -1
  726. package/dist/components/mds-tab-bar-item.js +1 -1
  727. package/dist/components/mds-tab-bar.js +1 -1
  728. package/dist/components/mds-tab-item.js +1 -1
  729. package/dist/components/mds-tab.js +1 -1
  730. package/dist/components/mds-table-body.js +1 -1
  731. package/dist/components/mds-table-cell.js +1 -1
  732. package/dist/components/mds-table-footer.js +1 -1
  733. package/dist/components/mds-table-header-cell.js +1 -1
  734. package/dist/components/mds-table-header.js +1 -1
  735. package/dist/components/mds-table-row.js +1 -1
  736. package/dist/components/mds-table.js +1 -1
  737. package/dist/components/mds-text.js +1 -1
  738. package/dist/components/mds-toast.js +1 -1
  739. package/dist/components/mds-tooltip.js +1 -1
  740. package/dist/components/mds-tree-item.js +1 -1
  741. package/dist/components/mds-tree.js +1 -1
  742. package/dist/components/mds-url-view.js +1 -1
  743. package/dist/components/mds-usage.js +1 -1
  744. package/dist/components/mds-video-wall.js +1 -1
  745. package/dist/components/mds-zero.js +1 -1
  746. package/dist/components/p--miH951G.js +5 -0
  747. package/dist/components/p-1aH7xiMs.js +1 -0
  748. package/dist/components/p-B05zwjTY.js +1 -0
  749. package/dist/components/p-BOu_NOgd.js +1 -0
  750. package/dist/components/p-BTpjOy0A.js +1 -0
  751. package/dist/components/p-BVw5aqzn.js +1 -0
  752. package/dist/components/p-BW24ByN-.js +1 -0
  753. package/dist/components/p-BWpSxp3h.js +1 -0
  754. package/dist/components/p-BXPIlPIF.js +1 -0
  755. package/dist/components/p-BzvYQBdf.js +1 -0
  756. package/dist/components/p-C3Sn8bRc.js +1 -0
  757. package/dist/components/p-CGkSDkOY.js +1 -0
  758. package/dist/components/p-CIcshx6K.js +1 -0
  759. package/dist/components/p-CKS4r32k.js +1 -0
  760. package/dist/components/p-COkF_8bh.js +1 -0
  761. package/dist/components/p-CmHMhHMt.js +1 -0
  762. package/dist/components/p-Cnt6G6GK.js +1 -0
  763. package/dist/components/p-CsL9U6eU.js +1 -0
  764. package/dist/components/p-Cyj1BFxx.js +1 -0
  765. package/dist/components/p-DQqUzCGR.js +1 -0
  766. package/dist/components/p-DR46G4-6.js +1 -0
  767. package/dist/components/p-DcW0iRnZ.js +1 -0
  768. package/dist/components/p-DebgFlHq.js +1 -0
  769. package/dist/components/p-DmPLOktp.js +1 -0
  770. package/dist/components/p-Dpf8NWF9.js +1 -0
  771. package/dist/components/p-DwA-5c8G.js +1 -0
  772. package/dist/components/p-Dws02cT2.js +8 -0
  773. package/dist/components/p-K3QNYRhf.js +1 -0
  774. package/dist/components/p-PQ_EO5-U.js +1 -0
  775. package/dist/components/p-akEzGmDD.js +1 -0
  776. package/dist/components/p-bDVBqkn0.js +1 -0
  777. package/dist/components/p-faViX-qz.js +1 -0
  778. package/dist/components/p-pBvN1uAc.js +3 -0
  779. package/dist/components/p-wI0alRSO.js +1 -0
  780. package/dist/components/p-x_c_51aL.js +1 -0
  781. package/dist/components/p-zHpei4x6.js +1 -0
  782. package/dist/documentation.json +618 -360
  783. package/dist/esm/floating-controller-BTYkH_Ih.js +366 -0
  784. package/dist/esm/form-wI0alRSO.js +42 -0
  785. package/dist/esm/index-BhCZiGfL.js +196 -0
  786. package/dist/esm/index-BxPbQB28.js +5149 -0
  787. package/dist/esm/index.js +65 -23
  788. package/dist/esm/loader.js +3 -3
  789. package/dist/esm/locale-CVJm6KFD.js +814 -0
  790. package/dist/esm/magma-components.js +3 -3
  791. package/dist/esm/mds-accordion-item.entry.js +2 -2
  792. package/dist/esm/mds-accordion-timer-item.entry.js +2 -2
  793. package/dist/esm/mds-accordion-timer.entry.js +1 -1
  794. package/dist/esm/mds-accordion.entry.js +2 -2
  795. package/dist/esm/mds-author.entry.js +1 -1
  796. package/dist/esm/mds-avatar-stack-item.entry.js +1 -1
  797. package/dist/esm/mds-avatar-stack.entry.js +1 -1
  798. package/dist/esm/mds-avatar.entry.js +29 -34
  799. package/dist/esm/mds-badge.entry.js +5 -4
  800. package/dist/esm/mds-banner_3.entry.js +3 -3
  801. package/dist/esm/mds-benchmark-bar.entry.js +4 -3
  802. package/dist/esm/mds-bibliography.entry.js +5 -4
  803. package/dist/esm/mds-breadcrumb-item.entry.js +1 -1
  804. package/dist/esm/mds-breadcrumb.entry.js +3 -3
  805. package/dist/esm/mds-button-dropdown.entry.js +38 -4
  806. package/dist/esm/mds-button-group.entry.js +1 -1
  807. package/dist/esm/mds-button_3.entry.js +42 -15
  808. package/dist/esm/mds-calendar_2.entry.js +2 -2
  809. package/dist/esm/mds-card-content.entry.js +1 -1
  810. package/dist/esm/mds-card-footer.entry.js +1 -1
  811. package/dist/esm/mds-card-header.entry.js +1 -1
  812. package/dist/esm/mds-card-media.entry.js +1 -1
  813. package/dist/esm/mds-card.entry.js +2 -2
  814. package/dist/esm/mds-details.entry.js +2 -2
  815. package/dist/esm/mds-dropdown.entry.js +7 -6
  816. package/dist/esm/mds-emoji.entry.js +2 -2
  817. package/dist/esm/mds-entity.entry.js +3 -3
  818. package/dist/esm/mds-file-preview.entry.js +20 -20
  819. package/dist/esm/mds-file.entry.js +3 -3
  820. package/dist/esm/mds-filter-item.entry.js +2 -2
  821. package/dist/esm/mds-filter.entry.js +2 -2
  822. package/dist/esm/mds-header-bar.entry.js +2 -2
  823. package/dist/esm/mds-header.entry.js +19 -10
  824. package/dist/esm/mds-horizontal-scroll.entry.js +1 -1
  825. package/dist/esm/mds-hr.entry.js +2 -2
  826. package/dist/esm/mds-img.entry.js +6 -6
  827. package/dist/esm/mds-input-date-range-preselection.entry.js +1 -1
  828. package/dist/esm/mds-input-date-range.entry.js +95 -13
  829. package/dist/esm/mds-input-date.entry.js +124 -27
  830. package/dist/esm/mds-input-field.entry.js +1 -1
  831. package/dist/esm/mds-input-otp.entry.js +65 -19
  832. package/dist/esm/mds-input-range.entry.js +32 -16
  833. package/dist/esm/mds-input-select.entry.js +166 -35
  834. package/dist/esm/mds-input-switch_2.entry.js +63 -21
  835. package/dist/esm/mds-input-tip_2.entry.js +3 -3
  836. package/dist/esm/mds-input-upload.entry.js +141 -68
  837. package/dist/esm/mds-input.entry.js +320 -36
  838. package/dist/esm/mds-keyboard-key.entry.js +11 -8
  839. package/dist/esm/mds-keyboard.entry.js +9 -6
  840. package/dist/esm/mds-kpi-item.entry.js +2 -2
  841. package/dist/esm/mds-kpi.entry.js +1 -1
  842. package/dist/esm/mds-label.entry.js +3 -3
  843. package/dist/esm/mds-list-item.entry.js +2 -2
  844. package/dist/esm/mds-list.entry.js +1 -1
  845. package/dist/esm/mds-mention.entry.js +6 -5
  846. package/dist/esm/mds-modal.entry.js +2 -2
  847. package/dist/esm/mds-note.entry.js +3 -3
  848. package/dist/esm/mds-notification.entry.js +13 -10
  849. package/dist/esm/mds-paginator-item.entry.js +2 -2
  850. package/dist/esm/mds-paginator.entry.js +2 -2
  851. package/dist/esm/mds-policy-ai.entry.js +3 -3
  852. package/dist/esm/mds-pref-animation.entry.js +29 -5
  853. package/dist/esm/mds-pref-consumption.entry.js +29 -5
  854. package/dist/esm/mds-pref-contrast.entry.js +27 -6
  855. package/dist/esm/mds-pref-language-item.entry.js +6 -5
  856. package/dist/esm/mds-pref-language.entry.js +3 -3
  857. package/dist/esm/mds-pref-mode.entry.js +30 -7
  858. package/dist/esm/mds-pref-theme-item.entry.js +4 -3
  859. package/dist/esm/mds-pref-theme.entry.js +3 -3
  860. package/dist/esm/mds-pref.entry.js +10 -5
  861. package/dist/esm/mds-price-table-features-cell.entry.js +2 -2
  862. package/dist/esm/mds-price-table-features-row.entry.js +2 -2
  863. package/dist/esm/mds-price-table-features.entry.js +2 -2
  864. package/dist/esm/mds-price-table-header.entry.js +1 -1
  865. package/dist/esm/mds-price-table-list-item.entry.js +1 -1
  866. package/dist/esm/mds-price-table-list.entry.js +2 -2
  867. package/dist/esm/mds-price-table.entry.js +1 -1
  868. package/dist/esm/mds-progress_2.entry.js +2 -2
  869. package/dist/esm/mds-push-notification-item.entry.js +4 -4
  870. package/dist/esm/mds-push-notification.entry.js +2 -2
  871. package/dist/esm/mds-quote.entry.js +2 -2
  872. package/dist/esm/mds-radial-menu-item.entry.js +1 -1
  873. package/dist/esm/mds-radial-menu.entry.js +2 -2
  874. package/dist/esm/mds-separator.entry.js +2 -2
  875. package/dist/esm/mds-status-bar.entry.js +2 -2
  876. package/dist/esm/mds-stepper-bar-item.entry.js +3 -3
  877. package/dist/esm/mds-stepper-bar.entry.js +6 -4
  878. package/dist/esm/mds-tab-bar-item.entry.js +5 -4
  879. package/dist/esm/mds-tab-bar.entry.js +2 -2
  880. package/dist/esm/mds-tab_2.entry.js +2 -2
  881. package/dist/esm/mds-table-body.entry.js +2 -2
  882. package/dist/esm/mds-table-footer.entry.js +2 -2
  883. package/dist/esm/mds-table-header-cell.entry.js +4 -4
  884. package/dist/esm/mds-table-header.entry.js +3 -3
  885. package/dist/esm/mds-table-row.entry.js +3 -3
  886. package/dist/esm/mds-table.entry.js +3 -3
  887. package/dist/esm/mds-text.entry.js +4 -3
  888. package/dist/esm/mds-toast.entry.js +11 -5
  889. package/dist/esm/mds-tooltip.entry.js +7 -7
  890. package/dist/esm/mds-tree-item.entry.js +3 -3
  891. package/dist/esm/mds-tree.entry.js +1 -1
  892. package/dist/esm/mds-url-view.entry.js +3 -3
  893. package/dist/esm/mds-usage.entry.js +3 -3
  894. package/dist/esm/mds-video-wall.entry.js +1 -1
  895. package/dist/esm/mds-zero.entry.js +2 -2
  896. package/dist/esm/preference-DNNqH7BU.js +385 -0
  897. package/dist/esm-es5/floating-controller-BTYkH_Ih.js +66 -0
  898. package/dist/esm-es5/form-wI0alRSO.js +16 -0
  899. package/dist/esm-es5/index-BhCZiGfL.js +10 -0
  900. package/dist/esm-es5/index-BxPbQB28.js +371 -0
  901. package/dist/esm-es5/index.js +37 -26
  902. package/dist/esm-es5/loader.js +1 -1
  903. package/dist/esm-es5/locale-CVJm6KFD.js +230 -0
  904. package/dist/esm-es5/magma-components.js +2 -2
  905. package/dist/esm-es5/mds-accordion-item.entry.js +1 -1
  906. package/dist/esm-es5/mds-accordion-timer-item.entry.js +1 -1
  907. package/dist/esm-es5/mds-accordion-timer.entry.js +1 -1
  908. package/dist/esm-es5/mds-accordion.entry.js +1 -1
  909. package/dist/esm-es5/mds-author.entry.js +1 -1
  910. package/dist/esm-es5/mds-avatar-stack-item.entry.js +1 -1
  911. package/dist/esm-es5/mds-avatar-stack.entry.js +1 -1
  912. package/dist/esm-es5/mds-avatar.entry.js +5 -3
  913. package/dist/esm-es5/mds-badge.entry.js +3 -4
  914. package/dist/esm-es5/mds-banner_3.entry.js +1 -1
  915. package/dist/esm-es5/mds-benchmark-bar.entry.js +3 -4
  916. package/dist/esm-es5/mds-bibliography.entry.js +2 -2
  917. package/dist/esm-es5/mds-breadcrumb-item.entry.js +1 -1
  918. package/dist/esm-es5/mds-breadcrumb.entry.js +2 -2
  919. package/dist/esm-es5/mds-button-dropdown.entry.js +10 -4
  920. package/dist/esm-es5/mds-button-group.entry.js +1 -1
  921. package/dist/esm-es5/mds-button_3.entry.js +14 -9
  922. package/dist/esm-es5/mds-calendar_2.entry.js +1 -1
  923. package/dist/esm-es5/mds-card-content.entry.js +1 -1
  924. package/dist/esm-es5/mds-card-footer.entry.js +1 -1
  925. package/dist/esm-es5/mds-card-header.entry.js +1 -1
  926. package/dist/esm-es5/mds-card-media.entry.js +1 -1
  927. package/dist/esm-es5/mds-card.entry.js +1 -1
  928. package/dist/esm-es5/mds-details.entry.js +1 -1
  929. package/dist/esm-es5/mds-dropdown.entry.js +3 -3
  930. package/dist/esm-es5/mds-emoji.entry.js +1 -1
  931. package/dist/esm-es5/mds-entity.entry.js +1 -1
  932. package/dist/esm-es5/mds-file-preview.entry.js +16 -14
  933. package/dist/esm-es5/mds-file.entry.js +11 -11
  934. package/dist/esm-es5/mds-filter-item.entry.js +1 -1
  935. package/dist/esm-es5/mds-filter.entry.js +1 -1
  936. package/dist/esm-es5/mds-header-bar.entry.js +1 -1
  937. package/dist/esm-es5/mds-header.entry.js +8 -6
  938. package/dist/esm-es5/mds-horizontal-scroll.entry.js +1 -1
  939. package/dist/esm-es5/mds-hr.entry.js +1 -1
  940. package/dist/esm-es5/mds-img.entry.js +2 -2
  941. package/dist/esm-es5/mds-input-date-range-preselection.entry.js +1 -1
  942. package/dist/esm-es5/mds-input-date-range.entry.js +35 -6
  943. package/dist/esm-es5/mds-input-date.entry.js +47 -7
  944. package/dist/esm-es5/mds-input-field.entry.js +1 -1
  945. package/dist/esm-es5/mds-input-otp.entry.js +21 -4
  946. package/dist/esm-es5/mds-input-range.entry.js +15 -7
  947. package/dist/esm-es5/mds-input-select.entry.js +39 -6
  948. package/dist/esm-es5/mds-input-switch_2.entry.js +24 -4
  949. package/dist/esm-es5/mds-input-tip_2.entry.js +1 -1
  950. package/dist/esm-es5/mds-input-upload.entry.js +43 -17
  951. package/dist/esm-es5/mds-input.entry.js +105 -22
  952. package/dist/esm-es5/mds-keyboard-key.entry.js +3 -1
  953. package/dist/esm-es5/mds-keyboard.entry.js +4 -2
  954. package/dist/esm-es5/mds-kpi-item.entry.js +1 -1
  955. package/dist/esm-es5/mds-kpi.entry.js +1 -1
  956. package/dist/esm-es5/mds-label.entry.js +1 -1
  957. package/dist/esm-es5/mds-list-item.entry.js +1 -1
  958. package/dist/esm-es5/mds-list.entry.js +1 -1
  959. package/dist/esm-es5/mds-mention.entry.js +2 -2
  960. package/dist/esm-es5/mds-modal.entry.js +1 -1
  961. package/dist/esm-es5/mds-note.entry.js +1 -1
  962. package/dist/esm-es5/mds-notification.entry.js +5 -3
  963. package/dist/esm-es5/mds-paginator-item.entry.js +1 -1
  964. package/dist/esm-es5/mds-paginator.entry.js +1 -1
  965. package/dist/esm-es5/mds-policy-ai.entry.js +1 -1
  966. package/dist/esm-es5/mds-pref-animation.entry.js +7 -1
  967. package/dist/esm-es5/mds-pref-consumption.entry.js +7 -1
  968. package/dist/esm-es5/mds-pref-contrast.entry.js +8 -2
  969. package/dist/esm-es5/mds-pref-language-item.entry.js +3 -3
  970. package/dist/esm-es5/mds-pref-language.entry.js +1 -1
  971. package/dist/esm-es5/mds-pref-mode.entry.js +10 -2
  972. package/dist/esm-es5/mds-pref-theme-item.entry.js +3 -3
  973. package/dist/esm-es5/mds-pref-theme.entry.js +1 -1
  974. package/dist/esm-es5/mds-pref.entry.js +6 -3
  975. package/dist/esm-es5/mds-price-table-features-cell.entry.js +1 -1
  976. package/dist/esm-es5/mds-price-table-features-row.entry.js +1 -1
  977. package/dist/esm-es5/mds-price-table-features.entry.js +1 -1
  978. package/dist/esm-es5/mds-price-table-header.entry.js +1 -1
  979. package/dist/esm-es5/mds-price-table-list-item.entry.js +1 -1
  980. package/dist/esm-es5/mds-price-table-list.entry.js +1 -1
  981. package/dist/esm-es5/mds-price-table.entry.js +1 -1
  982. package/dist/esm-es5/mds-progress_2.entry.js +1 -1
  983. package/dist/esm-es5/mds-push-notification-item.entry.js +1 -1
  984. package/dist/esm-es5/mds-push-notification.entry.js +1 -1
  985. package/dist/esm-es5/mds-quote.entry.js +1 -1
  986. package/dist/esm-es5/mds-radial-menu-item.entry.js +1 -1
  987. package/dist/esm-es5/mds-radial-menu.entry.js +1 -1
  988. package/dist/esm-es5/mds-separator.entry.js +1 -1
  989. package/dist/esm-es5/mds-status-bar.entry.js +1 -1
  990. package/dist/esm-es5/mds-stepper-bar-item.entry.js +1 -1
  991. package/dist/esm-es5/mds-stepper-bar.entry.js +4 -4
  992. package/dist/esm-es5/mds-tab-bar-item.entry.js +3 -4
  993. package/dist/esm-es5/mds-tab-bar.entry.js +1 -1
  994. package/dist/esm-es5/mds-tab_2.entry.js +1 -1
  995. package/dist/esm-es5/mds-table-body.entry.js +1 -1
  996. package/dist/esm-es5/mds-table-footer.entry.js +1 -1
  997. package/dist/esm-es5/mds-table-header-cell.entry.js +2 -2
  998. package/dist/esm-es5/mds-table-header.entry.js +1 -1
  999. package/dist/esm-es5/mds-table-row.entry.js +1 -1
  1000. package/dist/esm-es5/mds-table.entry.js +1 -1
  1001. package/dist/esm-es5/mds-text.entry.js +2 -2
  1002. package/dist/esm-es5/mds-toast.entry.js +5 -3
  1003. package/dist/esm-es5/mds-tooltip.entry.js +3 -3
  1004. package/dist/esm-es5/mds-tree-item.entry.js +1 -1
  1005. package/dist/esm-es5/mds-tree.entry.js +1 -1
  1006. package/dist/esm-es5/mds-url-view.entry.js +1 -1
  1007. package/dist/esm-es5/mds-usage.entry.js +1 -1
  1008. package/dist/esm-es5/mds-video-wall.entry.js +1 -1
  1009. package/dist/esm-es5/mds-zero.entry.js +1 -1
  1010. package/dist/esm-es5/preference-DNNqH7BU.js +58 -0
  1011. package/dist/hydrate/index.js +1687 -459
  1012. package/dist/hydrate/index.mjs +1687 -459
  1013. package/dist/magma-components/index.esm.js +1 -1
  1014. package/dist/magma-components/magma-components.esm.js +1 -1
  1015. package/dist/magma-components/magma-components.js +1 -1
  1016. package/dist/magma-components/p-00e47e49.system.entry.js +14 -0
  1017. package/dist/magma-components/p-0141c597.system.entry.js +15 -0
  1018. package/dist/magma-components/p-021f96f8.entry.js +1 -0
  1019. package/dist/magma-components/p-0255924b.system.entry.js +22 -0
  1020. package/dist/magma-components/p-03c2060d.entry.js +1 -0
  1021. package/dist/magma-components/p-05014374.entry.js +1 -0
  1022. package/dist/magma-components/p-05f73994.entry.js +1 -0
  1023. package/dist/magma-components/p-0646392d.entry.js +1 -0
  1024. package/dist/magma-components/p-0a38e4ce.system.entry.js +1 -0
  1025. package/dist/magma-components/p-0a551e86.entry.js +1 -0
  1026. package/dist/magma-components/p-0a904a12.entry.js +1 -0
  1027. package/dist/magma-components/p-0a9fb138.system.entry.js +1 -0
  1028. package/dist/magma-components/p-106f39c6.entry.js +1 -0
  1029. package/dist/magma-components/p-10ad73e3.system.entry.js +19 -0
  1030. package/dist/magma-components/p-1150ffb8.system.entry.js +10 -0
  1031. package/dist/magma-components/p-12c5ae26.entry.js +1 -0
  1032. package/dist/magma-components/p-13a1d35f.entry.js +1 -0
  1033. package/dist/magma-components/p-15d4846d.entry.js +1 -0
  1034. package/dist/magma-components/p-1673225e.system.entry.js +8 -0
  1035. package/dist/magma-components/p-188f4b1d.system.entry.js +7 -0
  1036. package/dist/magma-components/p-18c8628c.entry.js +1 -0
  1037. package/dist/magma-components/p-1be45c75.entry.js +1 -0
  1038. package/dist/magma-components/p-1cb495d3.entry.js +1 -0
  1039. package/dist/magma-components/p-1e3d89cd.system.entry.js +1 -0
  1040. package/dist/magma-components/p-1e700f0a.entry.js +1 -0
  1041. package/dist/magma-components/p-20e4f7dd.system.entry.js +15 -0
  1042. package/dist/magma-components/p-21865dd2.entry.js +1 -0
  1043. package/dist/magma-components/p-218d8254.system.entry.js +1 -0
  1044. package/dist/magma-components/p-21c46e74.system.entry.js +4 -0
  1045. package/dist/magma-components/p-231b604f.system.entry.js +1 -0
  1046. package/dist/magma-components/p-2507f5cf.entry.js +1 -0
  1047. package/dist/magma-components/p-2723caa7.system.entry.js +13 -0
  1048. package/dist/magma-components/p-277444bc.entry.js +1 -0
  1049. package/dist/magma-components/p-283b0548.system.entry.js +102 -0
  1050. package/dist/magma-components/p-2c44c961.system.entry.js +10 -0
  1051. package/dist/magma-components/p-2ec0db8e.entry.js +1 -0
  1052. package/dist/magma-components/p-2f520704.entry.js +1 -0
  1053. package/dist/magma-components/p-30c3872d.entry.js +1 -0
  1054. package/dist/magma-components/p-314abfba.entry.js +1 -0
  1055. package/dist/magma-components/p-322a5452.entry.js +1 -0
  1056. package/dist/magma-components/p-3231a6a3.entry.js +1 -0
  1057. package/dist/magma-components/p-34401d35.entry.js +1 -0
  1058. package/dist/magma-components/p-35aa29c5.entry.js +1 -0
  1059. package/dist/magma-components/p-35ee2d77.entry.js +1 -0
  1060. package/dist/magma-components/p-36a67b51.entry.js +1 -0
  1061. package/dist/magma-components/p-3a1339bb.system.entry.js +4 -0
  1062. package/dist/magma-components/p-3d56e3f4.entry.js +1 -0
  1063. package/dist/magma-components/p-3e0eed90.system.entry.js +12 -0
  1064. package/dist/magma-components/p-3ecade3c.system.entry.js +11 -0
  1065. package/dist/magma-components/p-3eefca33.system.entry.js +16 -0
  1066. package/dist/magma-components/p-4211ce6c.system.entry.js +1 -0
  1067. package/dist/magma-components/p-436f9b27.system.entry.js +38 -0
  1068. package/dist/magma-components/p-439c9ce3.system.entry.js +10 -0
  1069. package/dist/magma-components/p-44e2a945.system.entry.js +1 -0
  1070. package/dist/magma-components/p-4658154f.entry.js +1 -0
  1071. package/dist/magma-components/p-474047fa.system.entry.js +10 -0
  1072. package/dist/magma-components/p-474c5d53.system.entry.js +11 -0
  1073. package/dist/magma-components/p-493fb2f4.system.entry.js +7 -0
  1074. package/dist/magma-components/p-4ac94b84.system.entry.js +32 -0
  1075. package/dist/magma-components/p-4c73f14b.system.entry.js +14 -0
  1076. package/dist/magma-components/p-4cb88b06.system.entry.js +1 -0
  1077. package/dist/magma-components/p-4dd6a39b.entry.js +1 -0
  1078. package/dist/magma-components/p-4e7f21ac.entry.js +1 -0
  1079. package/dist/magma-components/p-4f14a166.entry.js +1 -0
  1080. package/dist/magma-components/p-50ea11c9.system.entry.js +32 -0
  1081. package/dist/magma-components/p-514d0fcb.entry.js +1 -0
  1082. package/dist/magma-components/p-52793bdb.system.entry.js +1 -0
  1083. package/dist/magma-components/p-5299f709.system.entry.js +26 -0
  1084. package/dist/magma-components/p-57762bae.entry.js +1 -0
  1085. package/dist/magma-components/p-577db922.entry.js +1 -0
  1086. package/dist/magma-components/p-58b82b40.system.entry.js +10 -0
  1087. package/dist/magma-components/p-5a7267e8.system.entry.js +4 -0
  1088. package/dist/magma-components/p-5a911e7b.system.entry.js +13 -0
  1089. package/dist/magma-components/p-5ac9e2f4.entry.js +1 -0
  1090. package/dist/magma-components/p-5c94e0c2.system.entry.js +7 -0
  1091. package/dist/magma-components/p-5ccf493c.system.entry.js +7 -0
  1092. package/dist/magma-components/p-5d119459.entry.js +1 -0
  1093. package/dist/magma-components/p-5f1132b8.entry.js +1 -0
  1094. package/dist/magma-components/p-5fd04ce1.entry.js +1 -0
  1095. package/dist/magma-components/p-60f67c37.entry.js +1 -0
  1096. package/dist/magma-components/p-61bedbe7.system.entry.js +68 -0
  1097. package/dist/magma-components/p-632bc44c.entry.js +1 -0
  1098. package/dist/magma-components/p-64f78149.system.entry.js +1 -0
  1099. package/dist/magma-components/p-69c21eae.entry.js +1 -0
  1100. package/dist/magma-components/p-6a6326c6.entry.js +1 -0
  1101. package/dist/magma-components/p-6c18c40e.system.entry.js +89 -0
  1102. package/dist/magma-components/p-6c800411.entry.js +1 -0
  1103. package/dist/magma-components/p-6e03b83a.entry.js +1 -0
  1104. package/dist/magma-components/p-6ed05d99.entry.js +1 -0
  1105. package/dist/magma-components/p-6f74cdf5.system.entry.js +12 -0
  1106. package/dist/magma-components/p-6fdb3fe7.system.entry.js +27 -0
  1107. package/dist/magma-components/p-6ff8be3e.system.entry.js +30 -0
  1108. package/dist/magma-components/p-7-TP6wnI.js +1 -0
  1109. package/dist/magma-components/p-73fde271.system.entry.js +72 -0
  1110. package/dist/magma-components/p-74b51db8.entry.js +1 -0
  1111. package/dist/magma-components/p-76ecad2f.entry.js +18 -0
  1112. package/dist/magma-components/p-774ce1d2.entry.js +1 -0
  1113. package/dist/magma-components/p-77615947.system.entry.js +1 -0
  1114. package/dist/magma-components/p-7770b989.system.entry.js +1 -0
  1115. package/dist/magma-components/p-7787ebaf.system.entry.js +1 -0
  1116. package/dist/magma-components/p-789c1b93.system.entry.js +1 -0
  1117. package/dist/magma-components/p-7927010f.system.entry.js +25 -0
  1118. package/dist/magma-components/p-79421ee1.system.entry.js +11 -0
  1119. package/dist/magma-components/p-7ab15184.entry.js +1 -0
  1120. package/dist/magma-components/p-7afec7ee.entry.js +1 -0
  1121. package/dist/magma-components/p-7e085c82.entry.js +1 -0
  1122. package/dist/magma-components/p-7e7cf986.system.entry.js +7 -0
  1123. package/dist/magma-components/p-7ffda4f5.entry.js +1 -0
  1124. package/dist/magma-components/p-809adece.system.entry.js +17 -0
  1125. package/dist/magma-components/p-8183b7ed.entry.js +1 -0
  1126. package/dist/magma-components/p-832883c4.entry.js +1 -0
  1127. package/dist/magma-components/p-83394280.system.entry.js +32 -0
  1128. package/dist/magma-components/p-835fc007.entry.js +1 -0
  1129. package/dist/magma-components/p-837fbbf7.system.entry.js +1 -0
  1130. package/dist/magma-components/p-84645c60.system.entry.js +1 -0
  1131. package/dist/magma-components/p-86f4b6eb.system.entry.js +20 -0
  1132. package/dist/magma-components/p-87026d34.entry.js +1 -0
  1133. package/dist/magma-components/p-87faaa8e.system.entry.js +16 -0
  1134. package/dist/magma-components/p-88287207.system.entry.js +13 -0
  1135. package/dist/magma-components/p-883c223a.system.entry.js +4 -0
  1136. package/dist/magma-components/p-88f99a4f.system.entry.js +81 -0
  1137. package/dist/magma-components/p-8a3d2259.system.entry.js +17 -0
  1138. package/dist/magma-components/p-8aafbfdf.system.entry.js +49 -0
  1139. package/dist/magma-components/p-8afc9bc4.system.entry.js +2838 -0
  1140. package/dist/magma-components/p-8ca1d30d.system.entry.js +1 -0
  1141. package/dist/magma-components/p-8ccd187a.entry.js +1 -0
  1142. package/dist/magma-components/p-8d53bd61.system.entry.js +4 -0
  1143. package/dist/magma-components/p-8yWTOQiz.js +1 -0
  1144. package/dist/magma-components/p-90993b0b.system.entry.js +68 -0
  1145. package/dist/magma-components/p-915c5f06.system.entry.js +47 -0
  1146. package/dist/magma-components/p-91c4015f.system.entry.js +4 -0
  1147. package/dist/magma-components/p-91ff1560.system.entry.js +7 -0
  1148. package/dist/magma-components/p-92d9b537.entry.js +1 -0
  1149. package/dist/magma-components/p-932620b6.entry.js +1 -0
  1150. package/dist/magma-components/p-9344a234.entry.js +1 -0
  1151. package/dist/magma-components/p-93d39066.entry.js +1 -0
  1152. package/dist/magma-components/p-97f6166e.system.entry.js +28 -0
  1153. package/dist/magma-components/p-9d1cdb42.system.entry.js +15 -0
  1154. package/dist/magma-components/p-9dcfc247.entry.js +1 -0
  1155. package/dist/magma-components/p-9eb1e154.system.entry.js +14 -0
  1156. package/dist/magma-components/p-9fe14430.system.entry.js +7 -0
  1157. package/dist/magma-components/p-BPNsbMrg.system.js +67 -0
  1158. package/dist/magma-components/p-BS7eEvwu.system.js +17 -0
  1159. package/dist/magma-components/p-BTF_aRDG.system.js +231 -0
  1160. package/dist/magma-components/p-BpVYIPkx.js +1 -0
  1161. package/dist/magma-components/p-BxPbQB28.js +3 -0
  1162. package/dist/magma-components/p-CdsZyFQ-.system.js +10 -0
  1163. package/dist/magma-components/p-D7BrzK-C.system.js +90 -0
  1164. package/dist/magma-components/p-DaONbL_w.system.js +162 -0
  1165. package/dist/magma-components/p-Kv1yahtR.js +5 -0
  1166. package/dist/magma-components/p-ZDRIVCAt.system.js +5 -0
  1167. package/dist/magma-components/p-a41e52f7.entry.js +1 -0
  1168. package/dist/magma-components/p-a462aadd.entry.js +1 -0
  1169. package/dist/magma-components/p-a4a83a63.entry.js +1 -0
  1170. package/dist/magma-components/p-a64bbb36.system.entry.js +40 -0
  1171. package/dist/magma-components/p-a6af4083.system.entry.js +32 -0
  1172. package/dist/magma-components/p-a7e7f2c0.entry.js +1 -0
  1173. package/dist/magma-components/p-aba96089.entry.js +1 -0
  1174. package/dist/magma-components/p-ac81f63a.system.entry.js +913 -0
  1175. package/dist/magma-components/p-aed8b119.entry.js +1 -0
  1176. package/dist/magma-components/p-b24b5179.entry.js +1 -0
  1177. package/dist/magma-components/p-b295e4ab.system.entry.js +1 -0
  1178. package/dist/magma-components/p-b2c62b6e.system.entry.js +7 -0
  1179. package/dist/magma-components/p-b431ca8a.entry.js +1 -0
  1180. package/dist/magma-components/p-b5559b28.system.entry.js +1 -0
  1181. package/dist/magma-components/p-b626c69f.system.entry.js +1 -0
  1182. package/dist/magma-components/p-b897c97d.entry.js +1 -0
  1183. package/dist/magma-components/p-bab4c75e.system.entry.js +45 -0
  1184. package/dist/magma-components/p-bba04b08.system.entry.js +14 -0
  1185. package/dist/magma-components/p-bc53c19e.entry.js +8 -0
  1186. package/dist/magma-components/p-bf2fe278.system.entry.js +16 -0
  1187. package/dist/magma-components/p-c0136138.entry.js +1 -0
  1188. package/dist/magma-components/p-c166ec50.system.entry.js +47 -0
  1189. package/dist/magma-components/p-c22887f7.system.entry.js +90 -0
  1190. package/dist/magma-components/p-c28fce23.entry.js +1 -0
  1191. package/dist/magma-components/p-c34d9e61.system.entry.js +1 -0
  1192. package/dist/magma-components/p-c48bad95.entry.js +1 -0
  1193. package/dist/magma-components/p-cb2c5f1b.entry.js +1 -0
  1194. package/dist/magma-components/p-cc0c6ae7.entry.js +1 -0
  1195. package/dist/magma-components/p-cc2a09f2.system.entry.js +16 -0
  1196. package/dist/magma-components/p-cc9d9458.entry.js +1 -0
  1197. package/dist/magma-components/p-ccb14076.system.entry.js +217 -0
  1198. package/dist/magma-components/p-ccb6898a.system.entry.js +4 -0
  1199. package/dist/magma-components/p-d04ac65d.entry.js +1 -0
  1200. package/dist/magma-components/p-d07d227b.system.entry.js +8 -0
  1201. package/dist/magma-components/p-d1faf129.entry.js +1 -0
  1202. package/dist/magma-components/p-d282a929.entry.js +1 -0
  1203. package/dist/magma-components/p-d2f134ac.entry.js +1 -0
  1204. package/dist/magma-components/p-d47df503.system.entry.js +37 -0
  1205. package/dist/magma-components/p-d5bd6bef.entry.js +1 -0
  1206. package/dist/magma-components/p-d9804d2f.entry.js +1 -0
  1207. package/dist/magma-components/p-dc06b29e.entry.js +1 -0
  1208. package/dist/magma-components/p-dc59b764.entry.js +1 -0
  1209. package/dist/magma-components/p-dc7bada4.entry.js +1 -0
  1210. package/dist/magma-components/p-dcc3be64.system.entry.js +7 -0
  1211. package/dist/magma-components/p-dd58f9ee.entry.js +18 -0
  1212. package/dist/magma-components/p-de091be7.system.entry.js +7 -0
  1213. package/dist/magma-components/p-dfe8552c.system.entry.js +11 -0
  1214. package/dist/magma-components/p-e1e69217.system.entry.js +1 -0
  1215. package/dist/magma-components/p-e213640b.entry.js +1 -0
  1216. package/dist/magma-components/p-e2ef1d6f.entry.js +1 -0
  1217. package/dist/magma-components/p-e2ef5996.entry.js +1 -0
  1218. package/dist/magma-components/p-e7751639.entry.js +1 -0
  1219. package/dist/magma-components/p-e887a14c.entry.js +1 -0
  1220. package/dist/magma-components/p-e8cd2b93.system.entry.js +4 -0
  1221. package/dist/magma-components/p-e8ed096b.entry.js +1 -0
  1222. package/dist/magma-components/p-eaff7300.entry.js +1 -0
  1223. package/dist/magma-components/p-eb681207.system.entry.js +1 -0
  1224. package/dist/magma-components/p-ec9cc7b9.entry.js +1 -0
  1225. package/dist/magma-components/p-eca99a0a.system.entry.js +1 -0
  1226. package/dist/magma-components/p-ecd3c27f.entry.js +1 -0
  1227. package/dist/magma-components/p-ed897f9f.entry.js +1 -0
  1228. package/dist/magma-components/p-ee1e7f07.system.entry.js +3 -0
  1229. package/dist/magma-components/p-ef3424e3.entry.js +1 -0
  1230. package/dist/magma-components/p-f29a059d.system.entry.js +15 -0
  1231. package/dist/magma-components/p-f5bb8c0c.entry.js +1 -0
  1232. package/dist/magma-components/p-f654eafe.entry.js +1 -0
  1233. package/dist/magma-components/p-f733ae92.system.entry.js +16 -0
  1234. package/dist/magma-components/p-f8eb19b3.entry.js +1 -0
  1235. package/dist/magma-components/p-f8feee93.system.entry.js +4 -0
  1236. package/dist/magma-components/p-faa1f22c.entry.js +1 -0
  1237. package/dist/magma-components/p-ffa1a0b4.system.entry.js +1 -0
  1238. package/dist/magma-components/p-hVpoPUxI.system.js +58 -0
  1239. package/dist/magma-components/p-wI0alRSO.js +1 -0
  1240. package/dist/stats.json +3303 -2650
  1241. package/dist/types/common/form.d.ts +8 -1
  1242. package/dist/types/common/preference.d.ts +1 -1
  1243. package/dist/types/common/validity/index.d.ts +22 -0
  1244. package/dist/types/components/mds-avatar/mds-avatar.d.ts +2 -0
  1245. package/dist/types/components/mds-button/mds-button.d.ts +9 -0
  1246. package/dist/types/components/mds-button-dropdown/mds-button-dropdown.d.ts +23 -1
  1247. package/dist/types/components/mds-header/mds-header.d.ts +1 -0
  1248. package/dist/types/components/mds-icon/mds-icon.d.ts +5 -0
  1249. package/dist/types/components/mds-icon/services/icons-set.service.d.ts +10 -9
  1250. package/dist/types/components/mds-input/mds-input.d.ts +41 -2
  1251. package/dist/types/components/mds-input/meta/validators.d.ts +22 -0
  1252. package/dist/types/components/mds-input/meta/validity.d.ts +14 -0
  1253. package/dist/types/components/mds-input-date/mds-input-date.d.ts +38 -0
  1254. package/dist/types/components/mds-input-date-range/mds-input-date-range.d.ts +26 -0
  1255. package/dist/types/components/mds-input-otp/mds-input-otp.d.ts +21 -2
  1256. package/dist/types/components/mds-input-range/mds-input-range.d.ts +8 -1
  1257. package/dist/types/components/mds-input-select/mds-input-select.d.ts +42 -4
  1258. package/dist/types/components/mds-input-select/meta/event-detail.d.ts +8 -0
  1259. package/dist/types/components/mds-input-switch/mds-input-switch.d.ts +17 -0
  1260. package/dist/types/components/mds-input-upload/mds-input-upload.d.ts +27 -5
  1261. package/dist/types/components/mds-keyboard-key/meta/icons.d.ts +1 -1
  1262. package/dist/types/components/mds-pref-animation/mds-pref-animation.d.ts +10 -1
  1263. package/dist/types/components/mds-pref-consumption/mds-pref-consumption.d.ts +10 -1
  1264. package/dist/types/components/mds-pref-contrast/mds-pref-contrast.d.ts +10 -1
  1265. package/dist/types/components/mds-pref-mode/mds-pref-mode.d.ts +10 -1
  1266. package/dist/types/components/mds-toast/mds-toast.d.ts +1 -0
  1267. package/dist/types/components.d.ts +102 -19
  1268. package/package.json +33 -20
  1269. package/dist/cjs/floating-controller-Cd_vNLLD.js +0 -369
  1270. package/dist/cjs/form-DTCBh5WK.js +0 -22
  1271. package/dist/cjs/index--6wz7eWi.js +0 -5183
  1272. package/dist/cjs/locale-CB5_Z7PE.js +0 -816
  1273. package/dist/cjs/preference-eJcbLLAn.js +0 -389
  1274. package/dist/components/p--8aaJX-p.js +0 -1
  1275. package/dist/components/p-A9TZf0Ii.js +0 -1
  1276. package/dist/components/p-B2A_hlV2.js +0 -1
  1277. package/dist/components/p-B9DJLgwr.js +0 -1
  1278. package/dist/components/p-BH3bWzRT.js +0 -1
  1279. package/dist/components/p-BJNK4p33.js +0 -1
  1280. package/dist/components/p-BNHXZ-JR.js +0 -1
  1281. package/dist/components/p-BSxuG1vZ.js +0 -1
  1282. package/dist/components/p-BTHR4xXu.js +0 -1
  1283. package/dist/components/p-BhFTcUD0.js +0 -3
  1284. package/dist/components/p-BouRLCYL.js +0 -1
  1285. package/dist/components/p-Bss3F51Q.js +0 -5
  1286. package/dist/components/p-Bt4xX5ww.js +0 -1
  1287. package/dist/components/p-C03KYHGv.js +0 -1
  1288. package/dist/components/p-C58NKMEE.js +0 -1
  1289. package/dist/components/p-CBLAz3_J.js +0 -1
  1290. package/dist/components/p-CVgKDZPF.js +0 -1
  1291. package/dist/components/p-CVpjH8Un.js +0 -1
  1292. package/dist/components/p-Caksrfcd.js +0 -1
  1293. package/dist/components/p-CatD1iUY.js +0 -1
  1294. package/dist/components/p-CbufYCNj.js +0 -1
  1295. package/dist/components/p-Cehcn85x.js +0 -1
  1296. package/dist/components/p-ClKNADBg.js +0 -8
  1297. package/dist/components/p-CvIFS8oA.js +0 -1
  1298. package/dist/components/p-D3-GP4KF.js +0 -1
  1299. package/dist/components/p-D8I1RblC.js +0 -1
  1300. package/dist/components/p-DLE5TNTp.js +0 -1
  1301. package/dist/components/p-DaI5QqNu.js +0 -1
  1302. package/dist/components/p-Deh5Aia-.js +0 -1
  1303. package/dist/components/p-Dj_oN194.js +0 -1
  1304. package/dist/components/p-DmELzfvf.js +0 -1
  1305. package/dist/components/p-DtxB7DYE.js +0 -1
  1306. package/dist/components/p-cBZsPiMJ.js +0 -1
  1307. package/dist/components/p-sqRs6oj4.js +0 -1
  1308. package/dist/components/p-wq6nWuWE.js +0 -1
  1309. package/dist/esm/floating-controller-DVldZ5mh.js +0 -366
  1310. package/dist/esm/form-A9TZf0Ii.js +0 -19
  1311. package/dist/esm/index-DIiEV39g.js +0 -5149
  1312. package/dist/esm/locale-CbJbTW_c.js +0 -814
  1313. package/dist/esm/preference-CKerJx2M.js +0 -385
  1314. package/dist/esm-es5/floating-controller-DVldZ5mh.js +0 -66
  1315. package/dist/esm-es5/form-A9TZf0Ii.js +0 -8
  1316. package/dist/esm-es5/index-DIiEV39g.js +0 -371
  1317. package/dist/esm-es5/locale-CbJbTW_c.js +0 -230
  1318. package/dist/esm-es5/preference-CKerJx2M.js +0 -58
  1319. package/dist/magma-components/p-03be5c0c.entry.js +0 -1
  1320. package/dist/magma-components/p-0715a2cb.system.entry.js +0 -12
  1321. package/dist/magma-components/p-071f18c6.system.entry.js +0 -27
  1322. package/dist/magma-components/p-0798b0bf.system.entry.js +0 -24
  1323. package/dist/magma-components/p-07fde74d.system.entry.js +0 -39
  1324. package/dist/magma-components/p-086fb3aa.entry.js +0 -1
  1325. package/dist/magma-components/p-0a088e7d.system.entry.js +0 -10
  1326. package/dist/magma-components/p-0a691082.entry.js +0 -1
  1327. package/dist/magma-components/p-0ad3b4da.system.entry.js +0 -102
  1328. package/dist/magma-components/p-0af8d821.entry.js +0 -1
  1329. package/dist/magma-components/p-0ec21574.system.entry.js +0 -10
  1330. package/dist/magma-components/p-0f6bb54d.system.entry.js +0 -22
  1331. package/dist/magma-components/p-102d3bd3.system.entry.js +0 -1
  1332. package/dist/magma-components/p-10704ede.system.entry.js +0 -4
  1333. package/dist/magma-components/p-15f63bf3.entry.js +0 -1
  1334. package/dist/magma-components/p-16e9fb14.system.entry.js +0 -7
  1335. package/dist/magma-components/p-1780b8ba.entry.js +0 -1
  1336. package/dist/magma-components/p-181dfb04.entry.js +0 -1
  1337. package/dist/magma-components/p-184720be.system.entry.js +0 -1
  1338. package/dist/magma-components/p-18f7b970.system.entry.js +0 -4
  1339. package/dist/magma-components/p-1a8c5086.system.entry.js +0 -19
  1340. package/dist/magma-components/p-1afc0452.entry.js +0 -1
  1341. package/dist/magma-components/p-1c0a7e24.system.entry.js +0 -30
  1342. package/dist/magma-components/p-1cce738a.system.entry.js +0 -32
  1343. package/dist/magma-components/p-1dcfb13e.entry.js +0 -1
  1344. package/dist/magma-components/p-1df6ac96.system.entry.js +0 -7
  1345. package/dist/magma-components/p-209063b6.system.entry.js +0 -50
  1346. package/dist/magma-components/p-216f95cc.system.entry.js +0 -1
  1347. package/dist/magma-components/p-21891a24.entry.js +0 -1
  1348. package/dist/magma-components/p-21d6687a.system.entry.js +0 -7
  1349. package/dist/magma-components/p-231505e8.entry.js +0 -1
  1350. package/dist/magma-components/p-23e61db9.system.entry.js +0 -4
  1351. package/dist/magma-components/p-241dbf61.entry.js +0 -1
  1352. package/dist/magma-components/p-25935d33.system.entry.js +0 -1
  1353. package/dist/magma-components/p-27ea99ee.entry.js +0 -8
  1354. package/dist/magma-components/p-284c40cd.system.entry.js +0 -4
  1355. package/dist/magma-components/p-29684655.system.entry.js +0 -16
  1356. package/dist/magma-components/p-2b73fee6.entry.js +0 -1
  1357. package/dist/magma-components/p-2d5aadba.system.entry.js +0 -7
  1358. package/dist/magma-components/p-2de17848.entry.js +0 -1
  1359. package/dist/magma-components/p-34482514.entry.js +0 -1
  1360. package/dist/magma-components/p-34c0890e.entry.js +0 -1
  1361. package/dist/magma-components/p-3635eca6.system.entry.js +0 -1
  1362. package/dist/magma-components/p-3b0c1202.entry.js +0 -1
  1363. package/dist/magma-components/p-3d8e63a2.system.entry.js +0 -63
  1364. package/dist/magma-components/p-3db23b5f.system.entry.js +0 -16
  1365. package/dist/magma-components/p-3ec7d3ea.entry.js +0 -1
  1366. package/dist/magma-components/p-3f7d3060.system.entry.js +0 -42
  1367. package/dist/magma-components/p-40563e33.entry.js +0 -1
  1368. package/dist/magma-components/p-41bf6f25.system.entry.js +0 -81
  1369. package/dist/magma-components/p-421a630e.entry.js +0 -1
  1370. package/dist/magma-components/p-4297da23.system.entry.js +0 -1
  1371. package/dist/magma-components/p-4299b76b.system.entry.js +0 -4
  1372. package/dist/magma-components/p-4543501c.entry.js +0 -1
  1373. package/dist/magma-components/p-454c4774.entry.js +0 -1
  1374. package/dist/magma-components/p-4616bc07.entry.js +0 -1
  1375. package/dist/magma-components/p-46786d71.system.entry.js +0 -14
  1376. package/dist/magma-components/p-470e5ac8.system.entry.js +0 -1
  1377. package/dist/magma-components/p-481008e9.system.entry.js +0 -13
  1378. package/dist/magma-components/p-48d37230.entry.js +0 -1
  1379. package/dist/magma-components/p-4b3a8132.system.entry.js +0 -13
  1380. package/dist/magma-components/p-4c8316a8.entry.js +0 -1
  1381. package/dist/magma-components/p-4c95442e.entry.js +0 -1
  1382. package/dist/magma-components/p-4e4bdbf8.entry.js +0 -1
  1383. package/dist/magma-components/p-4e5ab0e4.system.entry.js +0 -16
  1384. package/dist/magma-components/p-4f107cb2.system.entry.js +0 -2838
  1385. package/dist/magma-components/p-54b995c2.system.entry.js +0 -4
  1386. package/dist/magma-components/p-56ad5bf2.entry.js +0 -1
  1387. package/dist/magma-components/p-59de81ac.entry.js +0 -1
  1388. package/dist/magma-components/p-5a7ead55.system.entry.js +0 -37
  1389. package/dist/magma-components/p-5e43274a.system.entry.js +0 -15
  1390. package/dist/magma-components/p-5f545f85.system.entry.js +0 -1
  1391. package/dist/magma-components/p-61a5ac3d.system.entry.js +0 -17
  1392. package/dist/magma-components/p-636cc471.entry.js +0 -1
  1393. package/dist/magma-components/p-66ce2dee.entry.js +0 -1
  1394. package/dist/magma-components/p-67d80d37.system.entry.js +0 -1
  1395. package/dist/magma-components/p-6937f340.entry.js +0 -1
  1396. package/dist/magma-components/p-69d1b815.entry.js +0 -1
  1397. package/dist/magma-components/p-6b7e449f.entry.js +0 -1
  1398. package/dist/magma-components/p-6c417ea1.system.entry.js +0 -913
  1399. package/dist/magma-components/p-6cd7cfe3.entry.js +0 -1
  1400. package/dist/magma-components/p-6ce60d59.entry.js +0 -1
  1401. package/dist/magma-components/p-6cf760ea.system.entry.js +0 -45
  1402. package/dist/magma-components/p-6dc27543.entry.js +0 -1
  1403. package/dist/magma-components/p-6de37588.entry.js +0 -1
  1404. package/dist/magma-components/p-6edc4f16.system.entry.js +0 -14
  1405. package/dist/magma-components/p-6f6b5eb5.entry.js +0 -1
  1406. package/dist/magma-components/p-7090184f.entry.js +0 -1
  1407. package/dist/magma-components/p-716ad14c.entry.js +0 -1
  1408. package/dist/magma-components/p-71804224.entry.js +0 -1
  1409. package/dist/magma-components/p-735dc594.system.entry.js +0 -1
  1410. package/dist/magma-components/p-739fdf76.system.entry.js +0 -1
  1411. package/dist/magma-components/p-74b0902a.entry.js +0 -1
  1412. package/dist/magma-components/p-7530a2f2.entry.js +0 -1
  1413. package/dist/magma-components/p-75dd012a.system.entry.js +0 -11
  1414. package/dist/magma-components/p-75fcf1a4.entry.js +0 -1
  1415. package/dist/magma-components/p-76ae22d6.entry.js +0 -1
  1416. package/dist/magma-components/p-78248693.entry.js +0 -1
  1417. package/dist/magma-components/p-78fef00a.entry.js +0 -1
  1418. package/dist/magma-components/p-7c0d202c.entry.js +0 -1
  1419. package/dist/magma-components/p-7fc29447.entry.js +0 -1
  1420. package/dist/magma-components/p-81b72b6e.entry.js +0 -1
  1421. package/dist/magma-components/p-859ab5a2.entry.js +0 -18
  1422. package/dist/magma-components/p-896ae0ee.entry.js +0 -1
  1423. package/dist/magma-components/p-89a3bc7a.system.entry.js +0 -16
  1424. package/dist/magma-components/p-8b7fa8d7.entry.js +0 -1
  1425. package/dist/magma-components/p-8c4fb7ec.system.entry.js +0 -30
  1426. package/dist/magma-components/p-8dff6606.system.entry.js +0 -11
  1427. package/dist/magma-components/p-8e40eda3.system.entry.js +0 -9
  1428. package/dist/magma-components/p-91b9d4e7.system.entry.js +0 -4
  1429. package/dist/magma-components/p-92e1001f.entry.js +0 -1
  1430. package/dist/magma-components/p-9378b373.system.entry.js +0 -49
  1431. package/dist/magma-components/p-960dc9b5.system.entry.js +0 -15
  1432. package/dist/magma-components/p-9626eaff.system.entry.js +0 -134
  1433. package/dist/magma-components/p-9741d95e.system.entry.js +0 -7
  1434. package/dist/magma-components/p-97ea9e6e.system.entry.js +0 -68
  1435. package/dist/magma-components/p-9846fe89.system.entry.js +0 -1
  1436. package/dist/magma-components/p-998721b9.system.entry.js +0 -1
  1437. package/dist/magma-components/p-9a5296c0.system.entry.js +0 -7
  1438. package/dist/magma-components/p-9b2ee3fe.entry.js +0 -1
  1439. package/dist/magma-components/p-9be4a736.entry.js +0 -1
  1440. package/dist/magma-components/p-9ca7932d.system.entry.js +0 -8
  1441. package/dist/magma-components/p-9d86477d.system.entry.js +0 -1
  1442. package/dist/magma-components/p-9e3bc553.system.entry.js +0 -26
  1443. package/dist/magma-components/p-9e58467e.system.entry.js +0 -10
  1444. package/dist/magma-components/p-9e9a1ebd.system.entry.js +0 -15
  1445. package/dist/magma-components/p-A9TZf0Ii.js +0 -1
  1446. package/dist/magma-components/p-BFnx_0hM.js +0 -5
  1447. package/dist/magma-components/p-BbMKuVem.js +0 -1
  1448. package/dist/magma-components/p-C2FHijr2.system.js +0 -231
  1449. package/dist/magma-components/p-CBam2PI8.system.js +0 -79
  1450. package/dist/magma-components/p-CDTiTqY0.system.js +0 -58
  1451. package/dist/magma-components/p-CI85vVs8.system.js +0 -9
  1452. package/dist/magma-components/p-CnXBPjmc.system.js +0 -5
  1453. package/dist/magma-components/p-DB8Rm54c.js +0 -1
  1454. package/dist/magma-components/p-DIiEV39g.js +0 -3
  1455. package/dist/magma-components/p-DmC-b-ZK.system.js +0 -67
  1456. package/dist/magma-components/p-MGv0i39Y.system.js +0 -162
  1457. package/dist/magma-components/p-a3279a73.system.entry.js +0 -11
  1458. package/dist/magma-components/p-a3b0f586.entry.js +0 -1
  1459. package/dist/magma-components/p-a3fc2ea4.system.entry.js +0 -39
  1460. package/dist/magma-components/p-a5ac5e0b.entry.js +0 -1
  1461. package/dist/magma-components/p-a8ec3080.system.entry.js +0 -27
  1462. package/dist/magma-components/p-a906a02f.system.entry.js +0 -16
  1463. package/dist/magma-components/p-a93b2a39.entry.js +0 -1
  1464. package/dist/magma-components/p-aa267e7b.entry.js +0 -1
  1465. package/dist/magma-components/p-ab9095ae.system.entry.js +0 -4
  1466. package/dist/magma-components/p-ac544ab1.entry.js +0 -1
  1467. package/dist/magma-components/p-ace198e9.entry.js +0 -1
  1468. package/dist/magma-components/p-ad3983b2.entry.js +0 -1
  1469. package/dist/magma-components/p-af41c8b8.system.entry.js +0 -1
  1470. package/dist/magma-components/p-af45f0a5.system.entry.js +0 -20
  1471. package/dist/magma-components/p-b23a6c83.entry.js +0 -1
  1472. package/dist/magma-components/p-b35c26f8.entry.js +0 -18
  1473. package/dist/magma-components/p-b3a3578c.entry.js +0 -1
  1474. package/dist/magma-components/p-b49e0321.system.entry.js +0 -1
  1475. package/dist/magma-components/p-b71e0d51.entry.js +0 -1
  1476. package/dist/magma-components/p-b8d4a14e.entry.js +0 -1
  1477. package/dist/magma-components/p-b9fecfd5.entry.js +0 -1
  1478. package/dist/magma-components/p-ba035f90.entry.js +0 -1
  1479. package/dist/magma-components/p-bc51d310.system.entry.js +0 -1
  1480. package/dist/magma-components/p-bd490a8e.entry.js +0 -1
  1481. package/dist/magma-components/p-be198039.system.entry.js +0 -4
  1482. package/dist/magma-components/p-be692266.system.entry.js +0 -13
  1483. package/dist/magma-components/p-bf7168b4.entry.js +0 -1
  1484. package/dist/magma-components/p-bf84d9fa.entry.js +0 -1
  1485. package/dist/magma-components/p-c1fb2eb7.entry.js +0 -1
  1486. package/dist/magma-components/p-c4e58240.entry.js +0 -1
  1487. package/dist/magma-components/p-c573de10.entry.js +0 -1
  1488. package/dist/magma-components/p-c6be3db7.system.entry.js +0 -1
  1489. package/dist/magma-components/p-c70d7159.entry.js +0 -1
  1490. package/dist/magma-components/p-c7517884.system.entry.js +0 -38
  1491. package/dist/magma-components/p-c9be79bd.entry.js +0 -1
  1492. package/dist/magma-components/p-c9e12c2b.system.entry.js +0 -7
  1493. package/dist/magma-components/p-cb6a1908.entry.js +0 -1
  1494. package/dist/magma-components/p-cbd5aef4.system.entry.js +0 -14
  1495. package/dist/magma-components/p-cd21137b.system.entry.js +0 -1
  1496. package/dist/magma-components/p-cd5866c8.entry.js +0 -1
  1497. package/dist/magma-components/p-ce0ecc75.system.entry.js +0 -15
  1498. package/dist/magma-components/p-ce4e1a41.system.entry.js +0 -1
  1499. package/dist/magma-components/p-d3116844.entry.js +0 -1
  1500. package/dist/magma-components/p-d38165ed.system.entry.js +0 -1
  1501. package/dist/magma-components/p-d3933a22.entry.js +0 -1
  1502. package/dist/magma-components/p-d44c49d6.system.entry.js +0 -8
  1503. package/dist/magma-components/p-d4a529ce.entry.js +0 -1
  1504. package/dist/magma-components/p-d6d4aa1a.entry.js +0 -1
  1505. package/dist/magma-components/p-d81e7100.system.entry.js +0 -15
  1506. package/dist/magma-components/p-d8c27f4b.entry.js +0 -1
  1507. package/dist/magma-components/p-d921d876.entry.js +0 -1
  1508. package/dist/magma-components/p-da1ac3e1.entry.js +0 -1
  1509. package/dist/magma-components/p-ddbdce09.entry.js +0 -1
  1510. package/dist/magma-components/p-de6bc3c8.entry.js +0 -1
  1511. package/dist/magma-components/p-df2b7607.system.entry.js +0 -4
  1512. package/dist/magma-components/p-e05d2df8.system.entry.js +0 -4
  1513. package/dist/magma-components/p-e0b2ef8f.system.entry.js +0 -1
  1514. package/dist/magma-components/p-e0c50a2d.entry.js +0 -1
  1515. package/dist/magma-components/p-e1277efe.system.entry.js +0 -1
  1516. package/dist/magma-components/p-e1e6dd97.entry.js +0 -1
  1517. package/dist/magma-components/p-e2f7a9bd.system.entry.js +0 -1
  1518. package/dist/magma-components/p-e3e893c4.entry.js +0 -1
  1519. package/dist/magma-components/p-e4868ade.entry.js +0 -1
  1520. package/dist/magma-components/p-e5c6f9a9.system.entry.js +0 -7
  1521. package/dist/magma-components/p-e5da7036.entry.js +0 -1
  1522. package/dist/magma-components/p-e6dccab5.system.entry.js +0 -1
  1523. package/dist/magma-components/p-ec59ec9a.entry.js +0 -1
  1524. package/dist/magma-components/p-eddcef53.system.entry.js +0 -1
  1525. package/dist/magma-components/p-eed00e7f.system.entry.js +0 -1
  1526. package/dist/magma-components/p-ef8cb401.entry.js +0 -1
  1527. package/dist/magma-components/p-efe8d359.entry.js +0 -1
  1528. package/dist/magma-components/p-f070a5b5.system.entry.js +0 -11
  1529. package/dist/magma-components/p-f0a168f4.system.entry.js +0 -13
  1530. package/dist/magma-components/p-f1462410.system.entry.js +0 -9
  1531. package/dist/magma-components/p-f23d4974.entry.js +0 -1
  1532. package/dist/magma-components/p-f542246f.system.entry.js +0 -1
  1533. package/dist/magma-components/p-f5c680dd.entry.js +0 -1
  1534. package/dist/magma-components/p-f60c6e8e.system.entry.js +0 -40
  1535. package/dist/magma-components/p-f8369939.entry.js +0 -1
  1536. package/dist/magma-components/p-f97ede3e.system.entry.js +0 -19
  1537. package/dist/magma-components/p-f97ff5b2.entry.js +0 -1
  1538. package/dist/magma-components/p-fe1662e8.system.entry.js +0 -28
  1539. package/dist/magma-components/p-ff133cbd.entry.js +0 -1
  1540. package/dist/magma-components/p-fff44704.entry.js +0 -1
@@ -0,0 +1,240 @@
1
+ {
2
+ "timestamp": "2026-10-10T11:47:46",
3
+ "compiler": {
4
+ "name": "@stencil/core",
5
+ "version": "4.44.2",
6
+ "typescriptVersion": "5.8.3"
7
+ },
8
+ "components": [
9
+ {
10
+ "filePath": "src/components/mds-filter-item/mds-filter-item.tsx",
11
+ "encapsulation": "shadow",
12
+ "tag": "mds-filter-item",
13
+ "docs": "This is a web-component from Maggioli Design System [Magma](https://magma.maggiolicloud.it), built with StencilJS, TypeScript, Storybook. It's based on the web-component standard and it's designed to be agnostic from the JavaScript framework you are using.",
14
+ "docsTags": [],
15
+ "usage": {
16
+ "1. Description": "The `<mds-filter-item>` web component is a single selectable option inside the [`<mds-filter>`](../mds-filter/AGENTS.md) container of the Magma Design System. It renders as an interactive menu item (icon, label, and an optional count badge) and acts as the toggleable unit that drives the parent's filter selection - it has no standalone HTML primitive equivalent.\n\n#### Semantic Behavior\n\n- **Compound child only**: `<mds-filter-item>` must be a direct slot child of `<mds-filter>`; it is not used standalone and should not be mixed with other child types.\n- **Self-toggling + event**: Clicking (or activating via the keyboard) flips `selected` and emits `mdsFilterItemSelect` with `{ id, selected }`. The `id` is the one the parent assigns on load (`item-0`, `item-1`, ...), replacing any `id` set in the markup. The parent enforces single vs. multiple selection and re-emits `mdsFilterChange` with the aggregated value list.\n- **State owned with the parent**: `selected` doubles as a styling hook and as the flag the parent reads/writes - in single-select mode the parent clears the other items' selection, and on reset it clears the whole group.\n- **Keyboard activation**: Enter (and numpad Enter) activates the item like a pointer click; Space does not.\n- **Focus management**: The item is focusable unless `disabled`, in which case it drops out of the tab order.\n\n#### Properties & Visual Configurations\n\n- **`selected`**: The selection state of the item. Set it on initial markup to pre-select a filter; at runtime it is normally driven by the parent rather than set directly.\n- **`value`**: The form/data value contributed to the parent's aggregated `mdsFilterChange` payload when the item is selected. Provide a meaningful value distinct from the human-readable `label`.\n- **`count`**: An optional badge showing how many results the filter would yield. Use it only when the count is meaningful to the user; omit it for purely categorical filters.\n- **`icon`**: Optional leading icon (an icon name string). Without a `label` the slug itself becomes the `aria-label` (`mi/baseline/map`), and the component overwrites any `aria-label` set on the host.\n- **`disabled`**: Removes the item from the tab order; in the current release a pointer click still toggles it and no disabled style is painted. The parent uses this for the reset affordance when no filter is active.\n",
17
+ "2. Pattern": "Correct and idiomatic ways to use the `<mds-filter-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 Filter Group\n\nThe canonical form. Place one or more `<mds-filter-item>` elements as direct children of `<mds-filter>`. Every item requires a `label` (the visible text) and a `value` (the machine-readable token emitted by the parent's `mdsFilterChange` event).\n\n```html\n<mds-filter label=\"Stato\">\n <mds-filter-item label=\"Attivo\" value=\"active\"></mds-filter-item>\n <mds-filter-item label=\"In attesa\" value=\"pending\"></mds-filter-item>\n <mds-filter-item label=\"Archiviato\" value=\"archived\"></mds-filter-item>\n</mds-filter>\n```\n\n#### Pre-selecting an Item on Load\n\nSet `selected` on an item in the initial markup to make it active before any user interaction. The parent reads `selected` on mount and reflects the aggregated state correctly.\n\n```html\n<mds-filter label=\"Categoria\">\n <mds-filter-item label=\"Tutti\" value=\"all\" selected></mds-filter-item>\n <mds-filter-item label=\"Notizie\" value=\"news\"></mds-filter-item>\n <mds-filter-item label=\"Eventi\" value=\"events\"></mds-filter-item>\n</mds-filter>\n```\n\n#### Count Badge\n\nPass a `count` string to show how many results each filter would yield. Use it when the number is meaningful to the user; omit it for purely categorical filters to keep the UI uncluttered.\n\n```html\n<mds-filter label=\"Priorita\">\n <mds-filter-item label=\"Alta\" value=\"high\" count=\"12\"></mds-filter-item>\n <mds-filter-item label=\"Media\" value=\"medium\" count=\"34\"></mds-filter-item>\n <mds-filter-item label=\"Bassa\" value=\"low\" count=\"5\"></mds-filter-item>\n</mds-filter>\n```\n\n#### Icon-Only Item\n\nOmit `label` and provide only `icon`. The component automatically uses the icon slug as the `aria-label` fallback, so screen readers announce the slug (`mi/baseline/grid-view`) and an `aria-label` of your own is overwritten. Use a recognizable icon so the purpose is clear without text, and prefer a `label` where the item must have a spoken name.\n\n```html\n<mds-filter label=\"Vista\">\n <mds-filter-item icon=\"mi/baseline/grid-view\" value=\"grid\"></mds-filter-item>\n <mds-filter-item icon=\"mi/baseline/view-list\" value=\"list\"></mds-filter-item>\n <mds-filter-item icon=\"mi/baseline/map\" value=\"map\"></mds-filter-item>\n</mds-filter>\n```\n\n#### Item with Icon and Label\n\nCombine `icon` and `label` for a filter item that pairs a glyph with a text description.\n\n```html\n<mds-filter label=\"Tipo documento\">\n <mds-filter-item icon=\"mi/baseline/picture-as-pdf\" label=\"PDF\" value=\"pdf\"></mds-filter-item>\n <mds-filter-item icon=\"mi/baseline/image\" label=\"Immagini\" value=\"image\"></mds-filter-item>\n <mds-filter-item icon=\"mi/baseline/video-library\" label=\"Video\" value=\"video\"></mds-filter-item>\n</mds-filter>\n```\n\n#### Multiple Selection\n\nAdd `multiple` to `<mds-filter>` to allow several items to be selected at the same time. The parent aggregates the selected `value`s into a comma-separated string and emits it via `mdsFilterChange`.\n\n```html\n<mds-filter label=\"Settore\" multiple>\n <mds-filter-item label=\"Sanita\" value=\"health\"></mds-filter-item>\n <mds-filter-item label=\"Istruzione\" value=\"education\"></mds-filter-item>\n <mds-filter-item label=\"Trasporti\" value=\"transport\"></mds-filter-item>\n <mds-filter-item label=\"Ambiente\" value=\"environment\"></mds-filter-item>\n</mds-filter>\n```\n\n#### Listening for Selection Events\n\nListen to `mdsFilterItemSelect` on a single item for per-item reactions, or to `mdsFilterChange` on the parent for the aggregated selection. The event detail for `mdsFilterItemSelect` is `{ id: string, selected: boolean }`.\n\n```html\n<mds-filter id=\"tipo-filter\" label=\"Tipo\">\n <mds-filter-item label=\"Bozza\" value=\"draft\"></mds-filter-item>\n <mds-filter-item label=\"Pubblicato\" value=\"published\"></mds-filter-item>\n</mds-filter>\n\n<script>\n document.getElementById('tipo-filter').addEventListener('mdsFilterChange', (e) => {\n console.log('Valori selezionati:', e.detail.value);\n });\n</script>\n```\n\n#### Reset Affordance\n\nAdd `reset` to `<mds-filter>` to show an automatic reset button when at least one item is active. The button is rendered by the parent internally - no extra `<mds-filter-item>` is needed.\n\n```html\n<mds-filter label=\"Regione\" reset>\n <mds-filter-item label=\"Nord\" value=\"north\"></mds-filter-item>\n <mds-filter-item label=\"Centro\" value=\"center\"></mds-filter-item>\n <mds-filter-item label=\"Sud\" value=\"south\"></mds-filter-item>\n</mds-filter>\n```\n\n#### CSS Custom Properties for the Count Badge\n\nCustomize the count badge colors through the four documented `--mds-filter-item-count-*` CSS custom properties. Set them on the host element or on a parent selector; use the semantic color roles via `rgb(var(--magma-<role>))`.\n\n```css\n.priority-filter mds-filter-item {\n --mds-filter-item-count-background-default: rgb(var(--magma-wash-strong));\n --mds-filter-item-count-color-default: rgb(var(--magma-text-default));\n --mds-filter-item-count-background-selected: rgb(var(--magma-accent-emphasis));\n --mds-filter-item-count-color-selected: rgb(var(--magma-accent-on-emphasis));\n}\n```\n",
18
+ "3. Antipattern": "Common incorrect uses of `<mds-filter-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 `<mds-filter-item>` Outside `<mds-filter>`\n\n`<mds-filter-item>` is a compound child component. Without its parent it has no selection management, no auto-scroll, and no `mdsFilterChange` aggregation. Always wrap it in `<mds-filter>`.\n\n```html\n<!-- INCORRECT -->\n<div class=\"my-filters\">\n <mds-filter-item label=\"Attivo\" value=\"active\"></mds-filter-item>\n <mds-filter-item label=\"Archiviato\" value=\"archived\"></mds-filter-item>\n</div>\n\n<!-- CORRECT -->\n<mds-filter label=\"Stato\">\n <mds-filter-item label=\"Attivo\" value=\"active\"></mds-filter-item>\n <mds-filter-item label=\"Archiviato\" value=\"archived\"></mds-filter-item>\n</mds-filter>\n```\n\n#### Do Not Set `selected=\"false\"` to Deselect\n\n`selected` is a boolean prop: remove the attribute entirely to deselect, as for every boolean. The runtime happens to read the string `\"false\"` as `false`, but the attribute stays in the markup until the component renders, and HTML, `[selected]` selectors and `hasAttribute()` read a present attribute as set.\n\n```html\n<!-- INCORRECT -->\n<mds-filter label=\"Stato\">\n <mds-filter-item label=\"Attivo\" value=\"active\" selected=\"false\"></mds-filter-item>\n</mds-filter>\n\n<!-- CORRECT -->\n<mds-filter label=\"Stato\">\n <mds-filter-item label=\"Attivo\" value=\"active\"></mds-filter-item>\n</mds-filter>\n```\n\n#### Do Not Omit `value`\n\n`value` is the machine-readable token the parent aggregates into `mdsFilterChange`. Without it the parent's event payload is empty or meaningless for consumers - always provide a distinct, meaningful value.\n\n```html\n<!-- INCORRECT -->\n<mds-filter label=\"Priorita\">\n <mds-filter-item label=\"Alta\"></mds-filter-item>\n <mds-filter-item label=\"Bassa\"></mds-filter-item>\n</mds-filter>\n\n<!-- CORRECT -->\n<mds-filter label=\"Priorita\">\n <mds-filter-item label=\"Alta\" value=\"high\"></mds-filter-item>\n <mds-filter-item label=\"Bassa\" value=\"low\"></mds-filter-item>\n</mds-filter>\n```\n\n#### Do Not Slot Content Inside `<mds-filter-item>`\n\n`<mds-filter-item>` has no publicly documented default or named slots. Icon, label, and count are all props. Slotting arbitrary HTML has no effect - use the dedicated props instead.\n\n```html\n<!-- INCORRECT -->\n<mds-filter label=\"Formato\">\n <mds-filter-item value=\"pdf\">\n <mds-icon name=\"mi/baseline/picture-as-pdf\"></mds-icon>\n PDF\n </mds-filter-item>\n</mds-filter>\n\n<!-- CORRECT -->\n<mds-filter label=\"Formato\">\n <mds-filter-item icon=\"mi/baseline/picture-as-pdf\" label=\"PDF\" value=\"pdf\"></mds-filter-item>\n</mds-filter>\n```\n\n#### Do Not Listen for Native `click` Instead of `mdsFilterItemSelect`\n\nThe component handles its own toggle internally and emits `mdsFilterItemSelect` when selection changes. A native `click` listener added before the component has loaded runs before the internal toggle (listeners run in the order they were added), so it reads the old `selected` state.\n\n```html\n<!-- INCORRECT -->\n<mds-filter label=\"Stato\">\n <mds-filter-item label=\"Attivo\" value=\"active\"></mds-filter-item>\n</mds-filter>\n<script>\n document.querySelector('mds-filter-item[value=\"active\"]').addEventListener('click', (e) => {\n console.log('selected?', e.target.selected); // state not yet updated\n });\n</script>\n\n<!-- CORRECT -->\n<mds-filter label=\"Stato\">\n <mds-filter-item label=\"Attivo\" value=\"active\"></mds-filter-item>\n</mds-filter>\n<script>\n document.querySelector('mds-filter-item[value=\"active\"]').addEventListener('mdsFilterItemSelect', (e) => {\n console.log('selected:', e.detail.selected);\n });\n</script>\n```\n\n#### Do Not Customize via Undocumented Shadow Parts or Internal Selectors\n\nThe supported customization surface is the four `--mds-filter-item-count-*` CSS custom properties. Targeting shadow internals via `::part()`, `>>>`, or other selectors couples code to the implementation and will break on minor releases.\n\n```css\n/* INCORRECT */\nmds-filter-item >>> .count {\n border-radius: 4px;\n}\nmds-filter-item::part(count) {\n background: red;\n}\n\n/* CORRECT */\nmds-filter-item {\n --mds-filter-item-count-background-default: rgb(var(--magma-accent-surface-hover));\n --mds-filter-item-count-color-default: rgb(var(--magma-accent-fg));\n}\n```\n"
19
+ },
20
+ "props": [
21
+ {
22
+ "name": "count",
23
+ "type": "string | undefined",
24
+ "complexType": {
25
+ "original": "string",
26
+ "resolved": "string | undefined",
27
+ "references": {}
28
+ },
29
+ "mutable": false,
30
+ "attr": "count",
31
+ "reflectToAttr": true,
32
+ "docs": "Shows the number of items will be filtered by the component",
33
+ "docsTags": [],
34
+ "values": [
35
+ {
36
+ "type": "string"
37
+ },
38
+ {
39
+ "type": "undefined"
40
+ }
41
+ ],
42
+ "optional": true,
43
+ "required": false,
44
+ "getter": false,
45
+ "setter": false
46
+ },
47
+ {
48
+ "name": "disabled",
49
+ "type": "boolean | undefined",
50
+ "complexType": {
51
+ "original": "boolean",
52
+ "resolved": "boolean | undefined",
53
+ "references": {}
54
+ },
55
+ "mutable": false,
56
+ "attr": "disabled",
57
+ "reflectToAttr": true,
58
+ "docs": "Sets if the component is disabled or not",
59
+ "docsTags": [],
60
+ "values": [
61
+ {
62
+ "type": "boolean"
63
+ },
64
+ {
65
+ "type": "undefined"
66
+ }
67
+ ],
68
+ "optional": true,
69
+ "required": false,
70
+ "getter": false,
71
+ "setter": false
72
+ },
73
+ {
74
+ "name": "icon",
75
+ "type": "string | undefined",
76
+ "complexType": {
77
+ "original": "string",
78
+ "resolved": "string | undefined",
79
+ "references": {}
80
+ },
81
+ "mutable": false,
82
+ "attr": "icon",
83
+ "reflectToAttr": true,
84
+ "docs": "Sets the icon of the filter item",
85
+ "docsTags": [],
86
+ "values": [
87
+ {
88
+ "type": "string"
89
+ },
90
+ {
91
+ "type": "undefined"
92
+ }
93
+ ],
94
+ "optional": true,
95
+ "required": false,
96
+ "getter": false,
97
+ "setter": false
98
+ },
99
+ {
100
+ "name": "label",
101
+ "type": "string",
102
+ "complexType": {
103
+ "original": "string",
104
+ "resolved": "string",
105
+ "references": {}
106
+ },
107
+ "mutable": false,
108
+ "attr": "label",
109
+ "reflectToAttr": true,
110
+ "docs": "Sets the label of the filter item",
111
+ "docsTags": [],
112
+ "values": [
113
+ {
114
+ "type": "string"
115
+ }
116
+ ],
117
+ "optional": false,
118
+ "required": false,
119
+ "getter": false,
120
+ "setter": false
121
+ },
122
+ {
123
+ "name": "selected",
124
+ "type": "boolean | undefined",
125
+ "complexType": {
126
+ "original": "boolean",
127
+ "resolved": "boolean | undefined",
128
+ "references": {}
129
+ },
130
+ "mutable": true,
131
+ "attr": "selected",
132
+ "reflectToAttr": true,
133
+ "docs": "Sets the component to selected state",
134
+ "docsTags": [],
135
+ "values": [
136
+ {
137
+ "type": "boolean"
138
+ },
139
+ {
140
+ "type": "undefined"
141
+ }
142
+ ],
143
+ "optional": true,
144
+ "required": false,
145
+ "getter": false,
146
+ "setter": false
147
+ },
148
+ {
149
+ "name": "value",
150
+ "type": "string",
151
+ "complexType": {
152
+ "original": "string",
153
+ "resolved": "string",
154
+ "references": {}
155
+ },
156
+ "mutable": false,
157
+ "attr": "value",
158
+ "reflectToAttr": true,
159
+ "docs": "Sets the value of the component to be used with forms",
160
+ "docsTags": [],
161
+ "values": [
162
+ {
163
+ "type": "string"
164
+ }
165
+ ],
166
+ "optional": false,
167
+ "required": false,
168
+ "getter": false,
169
+ "setter": false
170
+ }
171
+ ],
172
+ "methods": [],
173
+ "events": [
174
+ {
175
+ "event": "mdsFilterItemSelect",
176
+ "detail": "MdsFilterItemEventDetail",
177
+ "bubbles": true,
178
+ "complexType": {
179
+ "original": "MdsFilterItemEventDetail",
180
+ "resolved": "MdsFilterItemEventDetail",
181
+ "references": {
182
+ "MdsFilterItemEventDetail": {
183
+ "location": "import",
184
+ "path": "./meta/event-detail",
185
+ "id": "src/components/mds-filter-item/meta/event-detail.ts::MdsFilterItemEventDetail",
186
+ "referenceLocation": "MdsFilterItemEventDetail"
187
+ }
188
+ }
189
+ },
190
+ "cancelable": true,
191
+ "composed": true,
192
+ "docs": "Emits when the element is active",
193
+ "docsTags": []
194
+ }
195
+ ],
196
+ "listeners": [],
197
+ "styles": [
198
+ {
199
+ "name": "--mds-filter-item-count-background-default",
200
+ "annotation": "prop",
201
+ "docs": "Sets the default `background-color` of the count element"
202
+ },
203
+ {
204
+ "name": "--mds-filter-item-count-background-selected",
205
+ "annotation": "prop",
206
+ "docs": "Sets the `background-color` of the count element when it's selected"
207
+ },
208
+ {
209
+ "name": "--mds-filter-item-count-color-default",
210
+ "annotation": "prop",
211
+ "docs": "Sets the default text `color` of the count element"
212
+ },
213
+ {
214
+ "name": "--mds-filter-item-count-color-selected",
215
+ "annotation": "prop",
216
+ "docs": "Sets the `color` of the count element when it's selected"
217
+ }
218
+ ],
219
+ "slots": [],
220
+ "parts": [],
221
+ "states": [],
222
+ "dependents": [
223
+ "mds-filter"
224
+ ],
225
+ "dependencies": [
226
+ "mds-icon",
227
+ "mds-text"
228
+ ],
229
+ "dependencyGraph": {
230
+ "mds-filter-item": [
231
+ "mds-icon",
232
+ "mds-text"
233
+ ],
234
+ "mds-filter": [
235
+ "mds-filter-item"
236
+ ]
237
+ }
238
+ }
239
+ ]
240
+ }
@@ -0,0 +1,125 @@
1
+ <!--
2
+ GENERATED FILE - do not edit by hand.
3
+ Source of truth: src/components/mds-filter-item/usage/ in the magma monorepo.
4
+ -->
5
+
6
+ # mds-filter-item - patterns
7
+
8
+ > The API of this component: [`AGENTS.md`](AGENTS.md).
9
+
10
+ Correct and idiomatic ways to use the `<mds-filter-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).
11
+
12
+ #### Basic Filter Group
13
+
14
+ The canonical form. Place one or more `<mds-filter-item>` elements as direct children of `<mds-filter>`. Every item requires a `label` (the visible text) and a `value` (the machine-readable token emitted by the parent's `mdsFilterChange` event).
15
+
16
+ ```html
17
+ <mds-filter label="Stato">
18
+ <mds-filter-item label="Attivo" value="active"></mds-filter-item>
19
+ <mds-filter-item label="In attesa" value="pending"></mds-filter-item>
20
+ <mds-filter-item label="Archiviato" value="archived"></mds-filter-item>
21
+ </mds-filter>
22
+ ```
23
+
24
+ #### Pre-selecting an Item on Load
25
+
26
+ Set `selected` on an item in the initial markup to make it active before any user interaction. The parent reads `selected` on mount and reflects the aggregated state correctly.
27
+
28
+ ```html
29
+ <mds-filter label="Categoria">
30
+ <mds-filter-item label="Tutti" value="all" selected></mds-filter-item>
31
+ <mds-filter-item label="Notizie" value="news"></mds-filter-item>
32
+ <mds-filter-item label="Eventi" value="events"></mds-filter-item>
33
+ </mds-filter>
34
+ ```
35
+
36
+ #### Count Badge
37
+
38
+ Pass a `count` string to show how many results each filter would yield. Use it when the number is meaningful to the user; omit it for purely categorical filters to keep the UI uncluttered.
39
+
40
+ ```html
41
+ <mds-filter label="Priorita">
42
+ <mds-filter-item label="Alta" value="high" count="12"></mds-filter-item>
43
+ <mds-filter-item label="Media" value="medium" count="34"></mds-filter-item>
44
+ <mds-filter-item label="Bassa" value="low" count="5"></mds-filter-item>
45
+ </mds-filter>
46
+ ```
47
+
48
+ #### Icon-Only Item
49
+
50
+ Omit `label` and provide only `icon`. The component automatically uses the icon slug as the `aria-label` fallback, so screen readers announce the slug (`mi/baseline/grid-view`) and an `aria-label` of your own is overwritten. Use a recognizable icon so the purpose is clear without text, and prefer a `label` where the item must have a spoken name.
51
+
52
+ ```html
53
+ <mds-filter label="Vista">
54
+ <mds-filter-item icon="mi/baseline/grid-view" value="grid"></mds-filter-item>
55
+ <mds-filter-item icon="mi/baseline/view-list" value="list"></mds-filter-item>
56
+ <mds-filter-item icon="mi/baseline/map" value="map"></mds-filter-item>
57
+ </mds-filter>
58
+ ```
59
+
60
+ #### Item with Icon and Label
61
+
62
+ Combine `icon` and `label` for a filter item that pairs a glyph with a text description.
63
+
64
+ ```html
65
+ <mds-filter label="Tipo documento">
66
+ <mds-filter-item icon="mi/baseline/picture-as-pdf" label="PDF" value="pdf"></mds-filter-item>
67
+ <mds-filter-item icon="mi/baseline/image" label="Immagini" value="image"></mds-filter-item>
68
+ <mds-filter-item icon="mi/baseline/video-library" label="Video" value="video"></mds-filter-item>
69
+ </mds-filter>
70
+ ```
71
+
72
+ #### Multiple Selection
73
+
74
+ Add `multiple` to `<mds-filter>` to allow several items to be selected at the same time. The parent aggregates the selected `value`s into a comma-separated string and emits it via `mdsFilterChange`.
75
+
76
+ ```html
77
+ <mds-filter label="Settore" multiple>
78
+ <mds-filter-item label="Sanita" value="health"></mds-filter-item>
79
+ <mds-filter-item label="Istruzione" value="education"></mds-filter-item>
80
+ <mds-filter-item label="Trasporti" value="transport"></mds-filter-item>
81
+ <mds-filter-item label="Ambiente" value="environment"></mds-filter-item>
82
+ </mds-filter>
83
+ ```
84
+
85
+ #### Listening for Selection Events
86
+
87
+ Listen to `mdsFilterItemSelect` on a single item for per-item reactions, or to `mdsFilterChange` on the parent for the aggregated selection. The event detail for `mdsFilterItemSelect` is `{ id: string, selected: boolean }`.
88
+
89
+ ```html
90
+ <mds-filter id="tipo-filter" label="Tipo">
91
+ <mds-filter-item label="Bozza" value="draft"></mds-filter-item>
92
+ <mds-filter-item label="Pubblicato" value="published"></mds-filter-item>
93
+ </mds-filter>
94
+
95
+ <script>
96
+ document.getElementById('tipo-filter').addEventListener('mdsFilterChange', (e) => {
97
+ console.log('Valori selezionati:', e.detail.value);
98
+ });
99
+ </script>
100
+ ```
101
+
102
+ #### Reset Affordance
103
+
104
+ Add `reset` to `<mds-filter>` to show an automatic reset button when at least one item is active. The button is rendered by the parent internally - no extra `<mds-filter-item>` is needed.
105
+
106
+ ```html
107
+ <mds-filter label="Regione" reset>
108
+ <mds-filter-item label="Nord" value="north"></mds-filter-item>
109
+ <mds-filter-item label="Centro" value="center"></mds-filter-item>
110
+ <mds-filter-item label="Sud" value="south"></mds-filter-item>
111
+ </mds-filter>
112
+ ```
113
+
114
+ #### CSS Custom Properties for the Count Badge
115
+
116
+ Customize the count badge colors through the four documented `--mds-filter-item-count-*` CSS custom properties. Set them on the host element or on a parent selector; use the semantic color roles via `rgb(var(--magma-<role>))`.
117
+
118
+ ```css
119
+ .priority-filter mds-filter-item {
120
+ --mds-filter-item-count-background-default: rgb(var(--magma-wash-strong));
121
+ --mds-filter-item-count-color-default: rgb(var(--magma-text-default));
122
+ --mds-filter-item-count-background-selected: rgb(var(--magma-accent-emphasis));
123
+ --mds-filter-item-count-color-selected: rgb(var(--magma-accent-on-emphasis));
124
+ }
125
+ ```
@@ -0,0 +1,95 @@
1
+ <!--
2
+ GENERATED FILE - do not edit by hand.
3
+ Source of truth: src/components/mds-header/ in the magma monorepo (usage/*.md and the
4
+ component's JSDoc). Regenerated on every stencil build (scripts/component-docs.ts).
5
+ -->
6
+
7
+ # mds-header
8
+
9
+ > `@maggioli-design-system/magma` 2.1.0. Shadow DOM: style it only through the CSS custom properties and parts below.
10
+
11
+ The `<mds-header>` web component is the top-level page header container of the Magma Design System. It is a compound parent that wraps one or more `<mds-header-bar>` elements, orchestrating their scroll-driven appearance, auto-hide visibility, and an optional mobile menu rendered as a side modal.
12
+
13
+ #### Semantic Behavior
14
+
15
+ - **Compound parent**: Hosts `<mds-header-bar>` children in the default slot and relays its `menu` and `nav` settings down to the bar.
16
+ - **Mobile menu**: A `[slot="menu"]` child is rendered inside a right-positioned modal. When it is absent there is no modal, but the bar still receives `menu` and shows its hamburger, which then opens nothing: set `menu="none"` in that case.
17
+ - **Open/close control**: The menu modal is opened by the bar's hamburger or programmatically via the `setOpened()` method; when the user closes it, `mdsHeaderClose` is emitted (with the bound bar).
18
+ - **Scroll-driven appearance**: When `appearanceSet` names two appearances, `appearance` swaps between them as the page scrolls past its pixel threshold (300 when the third token is omitted).
19
+ - **Auto-hide on scroll**: When `autoHide` is set, scrolling down past that pixel offset hides the bar and scrolling up reveals it again, governed by `threshold` as the directional margin.
20
+ - **Visibility event**: Any change to `visibility` (`'visible'`/`'hidden'`) emits `mdsHeaderVisibilityChange`, whose `detail.visibility` is that string.
21
+
22
+ #### Properties & Visual Configurations
23
+
24
+ - **`appearance`** is the bar's current visual mode (`'stripe'` or `'inline'`) and is mutable because the component rewrites it as the page scrolls.
25
+ - **`appearanceSet`** is a space/comma-separated string declaring scroll behavior as three tokens: initial appearance, changed appearance, and the `scrollY` pixel threshold (e.g. `"stripe, inline 200"`). Use it instead of `appearance` when the header should transform on scroll; `appearance` alone keeps a fixed look.
26
+ - **`autoHide`** is the pixel offset past which the bar starts hiding on downward scroll; leave it unset to keep the bar always present.
27
+ - **`threshold`** tunes how many pixels of opposite-direction scroll are required to flip the auto-hide state - raise it to make hide/show less twitchy.
28
+ - **`menu`** and **`nav`** select on which viewports the hamburger menu and the navigation are shown (`'all'`, `'desktop'`, `'mobile'`, `'none'`); they are relayed to the child bar.
29
+ - **`hideBackdrop`** removes the blurred backdrop layer shown behind the bar when its appearance is `'inline'`.
30
+ - **`visibility`** reflects the current shown/hidden state of the bar and can be set to force it.
31
+
32
+ ## Read next
33
+
34
+ - [`pattern.md`](pattern.md) - correct usage, with examples
35
+ - [`antipattern.md`](antipattern.md) - mistakes to avoid
36
+ - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`anti-patterns.md`](../../../../agents/anti-patterns.md) - the rules shared by every component
37
+
38
+ ## Props
39
+
40
+ | Prop | Attribute | Type | Default | Description |
41
+ | --- | --- | --- | --- | --- |
42
+ | `appearance` | `appearance` | `string` | `'stripe'` | Sets the appearance of the header bar element when loaded, it can be changed depending on how `appearance-set` attribute is set |
43
+ | `appearanceSet` | `appearance-set` | `string \| undefined` | - | Sets the appearance of the header bar element depending on the scroll position you should set three different values: initial appearance, changed appearance and `window.scrollY` threshold Es: appearance-set="stripe, inline 200" means the component will start with stripe appearance that will change to inline if the page is scrolled more of 199 pixels |
44
+ | `autoHide` | `auto-hide` | `number \| undefined` | - | When the page is scrolled down, the component mds-header-bar is hidden starting from the `autoHide` attribute's value, then if the page is scrolled up it is shown again |
45
+ | `hideBackdrop` | `hide-backdrop` | `boolean \| undefined` | `false` | Hides the backdrop shown when the mds-header-bar attribute appearace is set to `inline` |
46
+ | `menu` | `menu` | `"all" \| "desktop" \| "mobile" \| "none"` | `'mobile'` | Sets the visibility type of the hamburger menu of mds-header-bar |
47
+ | `nav` | `nav` | `"all" \| "desktop" \| "mobile" \| "none"` | `'desktop'` | Sets the visibility type of the navigation menu of mds-header-bar |
48
+ | `threshold` | `threshold` | `number` | `1` | Sets the threshold margin to trigger hide or show status of the `mds-header-bar` when the page is scrolled |
49
+ | `visibility` | `visibility` | `"hidden" \| "visible" \| undefined` | `'visible'` | Sets the visibility type of the navigation menu of mds-header-bar |
50
+
51
+ ## Events
52
+
53
+ | Event | Detail | Description |
54
+ | --- | --- | --- |
55
+ | `mdsHeaderClose` | `MdsHeaderEventDetail` | Emits when the component is closed |
56
+ | `mdsHeaderVisibilityChange` | `MdsHeaderVisibilityEventDetail` | Emits when the component mds-header-bar is shown or hidden |
57
+
58
+ ## Methods
59
+
60
+ | Method | Signature | Description |
61
+ | --- | --- | --- |
62
+ | `setOpened` | `setOpened(isOpened?: boolean) => Promise<void>` | Opens or closes the header. |
63
+
64
+ ## Slots
65
+
66
+ | Slot | Description |
67
+ | --- | --- |
68
+ | (default) | Add `mds-header-bar` element/s. |
69
+ | `menu` | Put actions and other contents that will be shown as mobile menu. Add `text string`, `HTML elements` or `components` to this slot. |
70
+
71
+ ## Parts
72
+
73
+ | Part | Description |
74
+ | --- | --- |
75
+ | `menu` | The container element of the modal |
76
+
77
+ ## CSS custom properties
78
+
79
+ | Property | Description |
80
+ | --- | --- |
81
+ | `--mds-header-backdrop-background-image` | Sets the background-image of the backdrop element visibile when the component attribute `appearance` is set to `inline`, by default is shown when mds-pref-consumtion is set to `medium` |
82
+ | `--mds-header-backdrop-blur-strength` | Sets the blur strength of the backdrop element visibile when the component attribute `appearance` is set to `inline`, by default is shown when mds-pref-consumtion is set to `high` |
83
+ | `--mds-header-backdrop-height` | Sets the height of the backdrop element visibile when the component attribute `appearance` is set to `inline` |
84
+ | `--mds-header-backdrop-show` | Sets if the backdrop element is visible or not, only visible when the component attribute `appearance` is set to `inline` |
85
+ | `--mds-header-color` | Sets the text color of the header and the mobile toggler icon |
86
+ | `--mds-header-hidden-bar-translate-inline` | Sets translateY value for the appearance inline `mds-header-bar` element |
87
+ | `--mds-header-hidden-bar-translate-stripe` | Sets translateY value for the appearance stripe `mds-header-bar` element |
88
+ | `--mds-header-icon-color` | Sets the color of the icon toggler |
89
+ | `--mds-header-inline-margin` | Sets inline margin of `the mds-header-bar` when attribute `appearance` is set to `inline` |
90
+ | `--mds-header-inline-margin-mobile` | Sets inline margin on mobile viewport of `the mds-header-bar` when attribute `appearance` is set to `inline` |
91
+ | `--mds-header-z-index` | Sets the z-index of the modal |
92
+
93
+ ## Dependencies
94
+
95
+ Uses: `mds-modal`.
@@ -0,0 +1,120 @@
1
+ <!--
2
+ GENERATED FILE - do not edit by hand.
3
+ Source of truth: src/components/mds-header/usage/ in the magma monorepo.
4
+ -->
5
+
6
+ # mds-header - anti-patterns
7
+
8
+ > The API of this component: [`AGENTS.md`](AGENTS.md).
9
+
10
+ Common incorrect uses of `<mds-header>`. 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.
11
+
12
+ #### Do Not Place `<mds-header-bar>` Outside `<mds-header>`
13
+
14
+ `<mds-header-bar>` is a compound child; it must be a direct slot child of `<mds-header>`, which relays breakpoint and appearance state down to it. Using the bar standalone breaks that communication: its hamburger has no menu to open, and appearance and auto-hide do not apply.
15
+
16
+ ```html
17
+ <!-- INCORRECT -->
18
+ <mds-header-bar>
19
+ <mds-img src="/logo.svg" alt="Logo"></mds-img>
20
+ </mds-header-bar>
21
+
22
+ <!-- CORRECT -->
23
+ <mds-header>
24
+ <mds-header-bar>
25
+ <mds-img src="/logo.svg" alt="Logo"></mds-img>
26
+ </mds-header-bar>
27
+ </mds-header>
28
+ ```
29
+
30
+ #### Do Not Drive Scroll Appearance with JavaScript When `appearance-set` Is Available
31
+
32
+ Manually toggling `appearance` on a scroll listener duplicates what `appearance-set` already handles declaratively, and once `appearance-set` is also set the component's own scroll handler rewrites `appearance` on every scroll.
33
+
34
+ ```html
35
+ <!-- INCORRECT -->
36
+ <mds-header id="hdr" appearance="inline">
37
+ <mds-header-bar>...</mds-header-bar>
38
+ </mds-header>
39
+ <script>
40
+ window.addEventListener('scroll', () => {
41
+ document.getElementById('hdr').appearance = window.scrollY > 300 ? 'stripe' : 'inline';
42
+ });
43
+ </script>
44
+
45
+ <!-- CORRECT -->
46
+ <mds-header appearance-set="inline, stripe 300" appearance="inline">
47
+ <mds-header-bar>...</mds-header-bar>
48
+ </mds-header>
49
+ ```
50
+
51
+ #### Do Not Omit the `menu` Slot When Providing a Hamburger-Only Nav
52
+
53
+ If no `[slot="menu"]` child is present there is no modal to open, but the bar still shows the hamburger icon on the viewports set by `menu`, and pressing it does nothing. Always provide menu content when you want the mobile toggle to be visible, or set `menu="none"`.
54
+
55
+ ```html
56
+ <!-- INCORRECT: the hamburger icon shows but opens nothing -->
57
+ <mds-header menu="mobile">
58
+ <mds-header-bar>
59
+ <mds-img src="/logo.svg" alt="Logo"></mds-img>
60
+ <mds-button slot="nav" label="Accedi" variant="dark" tone="outline"></mds-button>
61
+ </mds-header-bar>
62
+ </mds-header>
63
+
64
+ <!-- CORRECT -->
65
+ <mds-header menu="mobile">
66
+ <mds-header-bar>
67
+ <mds-img src="/logo.svg" alt="Logo"></mds-img>
68
+ <mds-button slot="nav" label="Accedi" variant="dark" tone="outline"></mds-button>
69
+ </mds-header-bar>
70
+ <div slot="menu">
71
+ <mds-button label="Accedi" variant="dark" tone="outline"></mds-button>
72
+ </div>
73
+ </mds-header>
74
+ ```
75
+
76
+ #### Do Not Listen to Native `scroll` Events to Detect Auto-Hide State
77
+
78
+ The component already emits `mdsHeaderVisibilityChange` when the bar flips between hidden and visible. Attaching a second `scroll` listener couples your code to the same threshold logic and risks running out of sync.
79
+
80
+ ```html
81
+ <!-- INCORRECT -->
82
+ <mds-header auto-hide="300" id="hdr">
83
+ <mds-header-bar>...</mds-header-bar>
84
+ </mds-header>
85
+ <script>
86
+ window.addEventListener('scroll', () => {
87
+ const hidden = window.scrollY > 300;
88
+ document.body.classList.toggle('header-hidden', hidden);
89
+ });
90
+ </script>
91
+
92
+ <!-- CORRECT -->
93
+ <mds-header auto-hide="300" id="hdr">
94
+ <mds-header-bar>...</mds-header-bar>
95
+ </mds-header>
96
+ <script>
97
+ document.getElementById('hdr').addEventListener('mdsHeaderVisibilityChange', (e) => {
98
+ document.body.classList.toggle('header-hidden', e.detail.visibility === 'hidden');
99
+ });
100
+ </script>
101
+ ```
102
+
103
+ #### Do Not Pierce Shadow DOM to Style the Internal Modal
104
+
105
+ The side-modal container is exposed as `::part(menu)` and its stacking is controllable via `--mds-header-z-index`. Do not use `>>>`, `/deep/`, or undocumented internal selectors.
106
+
107
+ ```css
108
+ /* INCORRECT */
109
+ mds-header >>> .menu mds-modal {
110
+ background: red;
111
+ }
112
+
113
+ /* CORRECT */
114
+ mds-header {
115
+ --mds-header-z-index: 500;
116
+ }
117
+ mds-header::part(menu) {
118
+ /* documented part - safe to target */
119
+ }
120
+ ```