@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,98 @@
1
+ <!--
2
+ GENERATED FILE - do not edit by hand.
3
+ Source of truth: src/components/mds-keyboard-key/usage/ in the magma monorepo.
4
+ -->
5
+
6
+ # mds-keyboard-key - patterns
7
+
8
+ > The API of this component: [`AGENTS.md`](AGENTS.md).
9
+
10
+ Correct and idiomatic ways to use the `<mds-keyboard-key>` 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
+ #### Single Key Inside `<mds-keyboard>`
13
+
14
+ Always nest `<mds-keyboard-key>` inside [`<mds-keyboard>`](../mds-keyboard/AGENTS.md). The parent inserts the `+` separators and wires up key-combination testing; the key is meaningless outside this context.
15
+
16
+ ```html
17
+ <mds-keyboard>
18
+ <mds-keyboard-key name="control"></mds-keyboard-key>
19
+ </mds-keyboard>
20
+ ```
21
+
22
+ #### Multi-Key Shortcut Combination
23
+
24
+ List every key in the combination as a direct child. The parent inserts `+` separators automatically - do not add them manually.
25
+
26
+ ```html
27
+ <mds-keyboard>
28
+ <mds-keyboard-key name="control"></mds-keyboard-key>
29
+ <mds-keyboard-key name="s"></mds-keyboard-key>
30
+ </mds-keyboard>
31
+
32
+ <mds-keyboard>
33
+ <mds-keyboard-key name="command"></mds-keyboard-key>
34
+ <mds-keyboard-key name="shift"></mds-keyboard-key>
35
+ <mds-keyboard-key name="z"></mds-keyboard-key>
36
+ </mds-keyboard>
37
+ ```
38
+
39
+ #### Icon-Resolved Keys
40
+
41
+ Keys such as arrows, enter, tab, space, command, shift, backspace, and others resolve to an icon automatically. No extra configuration is needed - `name` alone is sufficient.
42
+
43
+ ```html
44
+ <mds-keyboard>
45
+ <mds-keyboard-key name="arrowup"></mds-keyboard-key>
46
+ <mds-keyboard-key name="enter"></mds-keyboard-key>
47
+ </mds-keyboard>
48
+
49
+ <mds-keyboard>
50
+ <mds-keyboard-key name="tab"></mds-keyboard-key>
51
+ <mds-keyboard-key name="space"></mds-keyboard-key>
52
+ </mds-keyboard>
53
+ ```
54
+
55
+ #### Keyboard-Side Disambiguation
56
+
57
+ For keys that exist on both sides of a physical keyboard, use the directional variant (`shiftleft`, `shiftright`, `controlleft`, etc.). The component appends an `l` / `r` indicator to disambiguate.
58
+
59
+ ```html
60
+ <mds-keyboard>
61
+ <mds-keyboard-key name="shiftleft"></mds-keyboard-key>
62
+ <mds-keyboard-key name="controlleft"></mds-keyboard-key>
63
+ <mds-keyboard-key name="a"></mds-keyboard-key>
64
+ </mds-keyboard>
65
+ ```
66
+
67
+ #### Interactive Combination Test via `try`
68
+
69
+ Add `try` to `<mds-keyboard>` to let users verify they can type the shortcut. The parent drives `pressed` on child keys as the user types - do not set `pressed` yourself in this mode.
70
+
71
+ ```html
72
+ <mds-keyboard try>
73
+ <mds-keyboard-key name="control"></mds-keyboard-key>
74
+ <mds-keyboard-key name="z"></mds-keyboard-key>
75
+ </mds-keyboard>
76
+ ```
77
+
78
+ #### Styling Customization via CSS Custom Properties
79
+
80
+ Adjust the keycap appearance through the documented `--mds-keyboard-key-*` CSS custom properties. Set them on the host element or a parent selector.
81
+
82
+ ```css
83
+ /* Increase padding for a larger keycap feel */
84
+ .keycap-large mds-keyboard-key {
85
+ --mds-keyboard-key-padding: calc(var(--spacing) * 300);
86
+ }
87
+
88
+ /* Slow down the press animation */
89
+ .keycap-slow mds-keyboard-key {
90
+ --mds-keyboard-key-transition-duration: 600ms;
91
+ }
92
+
93
+ /* Deepen the bottom shadow for more three-dimensional depth */
94
+ .keycap-deep mds-keyboard-key {
95
+ --mds-keyboard-key-illumination-dark-size: calc(var(--spacing) * 400);
96
+ --mds-keyboard-key-illumination-light-size: calc(var(--spacing) * 100);
97
+ }
98
+ ```
@@ -0,0 +1,44 @@
1
+ <!--
2
+ GENERATED FILE - do not edit by hand.
3
+ Source of truth: src/components/mds-kpi/ 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-kpi
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-kpi>` web component is the layout container of the Magma Design System for presenting groups of key performance indicators. It is a compound parent with no props of its own: it establishes an accessible list region and hosts one or more `<mds-kpi-item>` children that render the actual figures.
12
+
13
+ #### Semantic Behavior
14
+
15
+ - **List semantics**: The host exposes its `<mds-kpi-item>` children as a single semantic list group to assistive technology.
16
+ - **Compound relationship**: It carries no value or configuration itself; every metric - label, description, icon, and on-scroll animation - is defined on the slotted `<mds-kpi-item>` children.
17
+ - **Default slot is content**: The default slot is meant exclusively for `<mds-kpi-item>` elements; anything else has no styled placement.
18
+
19
+ #### Properties & Visual Configurations
20
+
21
+ `<mds-kpi>` itself exposes no props. Configuration happens on the `<mds-kpi-item>` children and through the CSS custom properties this component publishes for them.
22
+
23
+ #### Other behavioral props
24
+
25
+ - **`--mds-kpi-text-animation-speed`** and **`--mds-kpi-text-animation-placeholder-char`**: tune the scramble/reveal text effect used by children. The animation only runs when a child sets a non-zero `threshold`, which animates the value in once the item scrolls into view; with the default `threshold` of `0` the figure renders statically.
26
+
27
+ ## Read next
28
+
29
+ - [`pattern.md`](pattern.md) - correct usage, with examples
30
+ - [`antipattern.md`](antipattern.md) - mistakes to avoid
31
+ - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`anti-patterns.md`](../../../../agents/anti-patterns.md) - the rules shared by every component
32
+
33
+ ## Slots
34
+
35
+ | Slot | Description |
36
+ | --- | --- |
37
+ | (default) | Add `mds-kpi-item` element/s. |
38
+
39
+ ## CSS custom properties
40
+
41
+ | Property | Description |
42
+ | --- | --- |
43
+ | `--mds-kpi-text-animation-placeholder-char` | Sets the animation placeholder char of the text |
44
+ | `--mds-kpi-text-animation-speed` | Sets the animation speed of the text |
@@ -0,0 +1,93 @@
1
+ <!--
2
+ GENERATED FILE - do not edit by hand.
3
+ Source of truth: src/components/mds-kpi/usage/ in the magma monorepo.
4
+ -->
5
+
6
+ # mds-kpi - anti-patterns
7
+
8
+ > The API of this component: [`AGENTS.md`](AGENTS.md).
9
+
10
+ Common incorrect uses of `<mds-kpi>`. 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 Raw HTML in the Default Slot
13
+
14
+ The default slot of `<mds-kpi>` is meant exclusively for [`mds-kpi-item`](../mds-kpi-item/AGENTS.md) elements. Arbitrary HTML has no styled placement inside the grid and breaks the list semantics the component exposes to assistive technology.
15
+
16
+ ```html
17
+ <!-- INCORRECT -->
18
+ <mds-kpi>
19
+ <div class="metric">
20
+ <h2>1.240</h2>
21
+ <p>Pratiche aperte</p>
22
+ </div>
23
+ </mds-kpi>
24
+
25
+ <!-- CORRECT -->
26
+ <mds-kpi>
27
+ <mds-kpi-item label="1.240" description="Pratiche aperte"></mds-kpi-item>
28
+ </mds-kpi>
29
+ ```
30
+
31
+ #### Do Not Use `mds-kpi-item` Outside `mds-kpi`
32
+
33
+ `<mds-kpi-item>` is a compound child and relies on the grid context and CSS custom property cascade provided by its parent. Using it as a standalone element loses the responsive layout and the shared animation-speed variables.
34
+
35
+ ```html
36
+ <!-- INCORRECT -->
37
+ <mds-kpi-item label="387" description="In lavorazione"></mds-kpi-item>
38
+
39
+ <!-- CORRECT -->
40
+ <mds-kpi>
41
+ <mds-kpi-item label="387" description="In lavorazione"></mds-kpi-item>
42
+ </mds-kpi>
43
+ ```
44
+
45
+ #### Do Not Set `threshold="0"` Explicitly to Disable Animation
46
+
47
+ `threshold` defaults to `0`, which means static rendering. Writing `threshold="0"` is redundant: it changes nothing. Simply omit the attribute.
48
+
49
+ ```html
50
+ <!-- INCORRECT -->
51
+ <mds-kpi-item label="56" description="Scadute" threshold="0"></mds-kpi-item>
52
+
53
+ <!-- CORRECT -->
54
+ <mds-kpi-item label="56" description="Scadute"></mds-kpi-item>
55
+ ```
56
+
57
+ #### Do Not Slot `mds-icon` to Display an Icon
58
+
59
+ The `icon` prop on `<mds-kpi-item>` renders the glyph in its own styled container above the value. `mds-kpi-item` renders no slot, so an `<mds-icon>` or any other element slotted into it is not displayed.
60
+
61
+ ```html
62
+ <!-- INCORRECT -->
63
+ <mds-kpi>
64
+ <mds-kpi-item label="75" description="Allenatori">
65
+ <mds-icon name="mi/baseline/directions-walk"></mds-icon>
66
+ </mds-kpi-item>
67
+ </mds-kpi>
68
+
69
+ <!-- CORRECT -->
70
+ <mds-kpi>
71
+ <mds-kpi-item
72
+ icon="mi/baseline/directions-walk"
73
+ label="75"
74
+ description="Allenatori"
75
+ ></mds-kpi-item>
76
+ </mds-kpi>
77
+ ```
78
+
79
+ #### Do Not Override the Animation Speed by Targeting Internal Text Components
80
+
81
+ `<mds-kpi-item>` forwards `--mds-kpi-text-animation-speed` and `--mds-kpi-text-animation-placeholder-char` to its internal `<mds-text>` elements. Setting `--mds-text-animation-speed` from outside has no effect: the item sets it on its inner texts from its own variables. Use the published `--mds-kpi-*` or `--mds-kpi-item-*` variables instead.
82
+
83
+ ```css
84
+ /* INCORRECT */
85
+ mds-kpi-item {
86
+ --mds-text-animation-speed: 0.05;
87
+ }
88
+
89
+ /* CORRECT */
90
+ mds-kpi {
91
+ --mds-kpi-text-animation-speed: 0.05;
92
+ }
93
+ ```
@@ -0,0 +1,54 @@
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-kpi/mds-kpi.tsx",
11
+ "encapsulation": "shadow",
12
+ "tag": "mds-kpi",
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
+ {
16
+ "name": "slot",
17
+ "text": "- Add `mds-kpi-item` element/s."
18
+ }
19
+ ],
20
+ "usage": {
21
+ "1. Description": "The `<mds-kpi>` web component is the layout container of the Magma Design System for presenting groups of key performance indicators. It is a compound parent with no props of its own: it establishes an accessible list region and hosts one or more `<mds-kpi-item>` children that render the actual figures.\n\n#### Semantic Behavior\n\n- **List semantics**: The host exposes its `<mds-kpi-item>` children as a single semantic list group to assistive technology.\n- **Compound relationship**: It carries no value or configuration itself; every metric - label, description, icon, and on-scroll animation - is defined on the slotted `<mds-kpi-item>` children.\n- **Default slot is content**: The default slot is meant exclusively for `<mds-kpi-item>` elements; anything else has no styled placement.\n\n#### Properties & Visual Configurations\n\n`<mds-kpi>` itself exposes no props. Configuration happens on the `<mds-kpi-item>` children and through the CSS custom properties this component publishes for them.\n\n#### Other behavioral props\n\n- **`--mds-kpi-text-animation-speed`** and **`--mds-kpi-text-animation-placeholder-char`**: tune the scramble/reveal text effect used by children. The animation only runs when a child sets a non-zero `threshold`, which animates the value in once the item scrolls into view; with the default `threshold` of `0` the figure renders statically.\n",
22
+ "2. Pattern": "Correct and idiomatic ways to use the `<mds-kpi>` 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 KPI Panel\n\nThe canonical form. Place one or more [`mds-kpi-item`](../mds-kpi-item/AGENTS.md) elements as direct children. `mds-kpi` provides the responsive grid; `mds-kpi-item` owns every visible value.\n\n```html\n<mds-kpi>\n <mds-kpi-item label=\"1.240\" description=\"Pratiche aperte\"></mds-kpi-item>\n <mds-kpi-item label=\"387\" description=\"In lavorazione\"></mds-kpi-item>\n <mds-kpi-item label=\"56\" description=\"Scadute\"></mds-kpi-item>\n</mds-kpi>\n```\n\n#### KPI Item with Icon\n\nSet `icon` to an icon slug to display a glyph above the value. Use slugs from the Magma icon library - `mi/baseline/*` for Material Icons or an `mgg/` Maggioli slug.\n\n```html\n<mds-kpi>\n <mds-kpi-item\n icon=\"mi/baseline/folder-open\"\n label=\"1.240\"\n description=\"Pratiche aperte\"\n ></mds-kpi-item>\n <mds-kpi-item\n icon=\"mi/baseline/pending-actions\"\n label=\"387\"\n description=\"In lavorazione\"\n ></mds-kpi-item>\n <mds-kpi-item\n icon=\"mi/baseline/warning\"\n label=\"56\"\n description=\"Scadute\"\n ></mds-kpi-item>\n</mds-kpi>\n```\n\n#### Scroll-Triggered Animation\n\nSet `threshold` to a value between `0` (exclusive) and `1` to activate the scramble/reveal animation when the item scrolls into the viewport. A threshold of `0.5` triggers once at least half the element is visible. Omit `threshold` (or leave it at the default `0`) for static rendering.\n\n```html\n<mds-kpi>\n <mds-kpi-item\n icon=\"mi/baseline/groups\"\n label=\"4.512\"\n description=\"Dipendenti\"\n threshold=\"0.5\"\n ></mds-kpi-item>\n <mds-kpi-item\n icon=\"mi/baseline/location-city\"\n label=\"38\"\n description=\"Sedi operative\"\n threshold=\"0.5\"\n ></mds-kpi-item>\n <mds-kpi-item\n icon=\"mi/baseline/stars\"\n label=\"12\"\n description=\"Anni di attivita\"\n threshold=\"0.5\"\n ></mds-kpi-item>\n</mds-kpi>\n```\n\n#### Tuning the Animation Speed Globally\n\nUse `--mds-kpi-text-animation-speed` on the `<mds-kpi>` host to slow down or speed up the scramble effect for all children at once. The default is `0.15`. The placeholder character during the scramble phase is controlled by `--mds-kpi-text-animation-placeholder-char` (default: a space).\n\n```css\n.hero-section mds-kpi {\n --mds-kpi-text-animation-speed: 0.08;\n --mds-kpi-text-animation-placeholder-char: '-';\n}\n```\n\n#### Styling Individual Items\n\nCustomize a single `<mds-kpi-item>` through its own CSS custom properties. Use the semantic color roles via `rgb(var(--magma-<role>))` ([`agents/color.md`](../../../../agents/color.md)) so dark mode keeps working.\n\n```css\n.progetto-kpi mds-kpi-item {\n --mds-kpi-item-icon-color: rgb(var(--magma-accent-emphasis));\n --mds-kpi-item-info-background: rgb(var(--magma-surface-overlay));\n}\n```\n\n#### Targeting Shadow Parts\n\nWhen a CSS custom property is not enough, target the documented shadow parts of `<mds-kpi-item>` - `icon`, `icon-container`, and `content` - via `::part()`. Use this only when deeper visual control is required.\n\n```css\nmds-kpi-item::part(icon) {\n width: 30%;\n}\n\nmds-kpi-item::part(content) {\n text-align: left;\n}\n```\n",
23
+ "3. Antipattern": "Common incorrect uses of `<mds-kpi>`. 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 Place Raw HTML in the Default Slot\n\nThe default slot of `<mds-kpi>` is meant exclusively for [`mds-kpi-item`](../mds-kpi-item/AGENTS.md) elements. Arbitrary HTML has no styled placement inside the grid and breaks the list semantics the component exposes to assistive technology.\n\n```html\n<!-- INCORRECT -->\n<mds-kpi>\n <div class=\"metric\">\n <h2>1.240</h2>\n <p>Pratiche aperte</p>\n </div>\n</mds-kpi>\n\n<!-- CORRECT -->\n<mds-kpi>\n <mds-kpi-item label=\"1.240\" description=\"Pratiche aperte\"></mds-kpi-item>\n</mds-kpi>\n```\n\n#### Do Not Use `mds-kpi-item` Outside `mds-kpi`\n\n`<mds-kpi-item>` is a compound child and relies on the grid context and CSS custom property cascade provided by its parent. Using it as a standalone element loses the responsive layout and the shared animation-speed variables.\n\n```html\n<!-- INCORRECT -->\n<mds-kpi-item label=\"387\" description=\"In lavorazione\"></mds-kpi-item>\n\n<!-- CORRECT -->\n<mds-kpi>\n <mds-kpi-item label=\"387\" description=\"In lavorazione\"></mds-kpi-item>\n</mds-kpi>\n```\n\n#### Do Not Set `threshold=\"0\"` Explicitly to Disable Animation\n\n`threshold` defaults to `0`, which means static rendering. Writing `threshold=\"0\"` is redundant: it changes nothing. Simply omit the attribute.\n\n```html\n<!-- INCORRECT -->\n<mds-kpi-item label=\"56\" description=\"Scadute\" threshold=\"0\"></mds-kpi-item>\n\n<!-- CORRECT -->\n<mds-kpi-item label=\"56\" description=\"Scadute\"></mds-kpi-item>\n```\n\n#### Do Not Slot `mds-icon` to Display an Icon\n\nThe `icon` prop on `<mds-kpi-item>` renders the glyph in its own styled container above the value. `mds-kpi-item` renders no slot, so an `<mds-icon>` or any other element slotted into it is not displayed.\n\n```html\n<!-- INCORRECT -->\n<mds-kpi>\n <mds-kpi-item label=\"75\" description=\"Allenatori\">\n <mds-icon name=\"mi/baseline/directions-walk\"></mds-icon>\n </mds-kpi-item>\n</mds-kpi>\n\n<!-- CORRECT -->\n<mds-kpi>\n <mds-kpi-item\n icon=\"mi/baseline/directions-walk\"\n label=\"75\"\n description=\"Allenatori\"\n ></mds-kpi-item>\n</mds-kpi>\n```\n\n#### Do Not Override the Animation Speed by Targeting Internal Text Components\n\n`<mds-kpi-item>` forwards `--mds-kpi-text-animation-speed` and `--mds-kpi-text-animation-placeholder-char` to its internal `<mds-text>` elements. Setting `--mds-text-animation-speed` from outside has no effect: the item sets it on its inner texts from its own variables. Use the published `--mds-kpi-*` or `--mds-kpi-item-*` variables instead.\n\n```css\n/* INCORRECT */\nmds-kpi-item {\n --mds-text-animation-speed: 0.05;\n}\n\n/* CORRECT */\nmds-kpi {\n --mds-kpi-text-animation-speed: 0.05;\n}\n```\n"
24
+ },
25
+ "props": [],
26
+ "methods": [],
27
+ "events": [],
28
+ "listeners": [],
29
+ "styles": [
30
+ {
31
+ "name": "--mds-kpi-text-animation-placeholder-char",
32
+ "annotation": "prop",
33
+ "docs": "Sets the animation placeholder char of the text"
34
+ },
35
+ {
36
+ "name": "--mds-kpi-text-animation-speed",
37
+ "annotation": "prop",
38
+ "docs": "Sets the animation speed of the text"
39
+ }
40
+ ],
41
+ "slots": [
42
+ {
43
+ "name": "",
44
+ "docs": "Add `mds-kpi-item` element/s."
45
+ }
46
+ ],
47
+ "parts": [],
48
+ "states": [],
49
+ "dependents": [],
50
+ "dependencies": [],
51
+ "dependencyGraph": {}
52
+ }
53
+ ]
54
+ }
@@ -0,0 +1,109 @@
1
+ <!--
2
+ GENERATED FILE - do not edit by hand.
3
+ Source of truth: src/components/mds-kpi/usage/ in the magma monorepo.
4
+ -->
5
+
6
+ # mds-kpi - patterns
7
+
8
+ > The API of this component: [`AGENTS.md`](AGENTS.md).
9
+
10
+ Correct and idiomatic ways to use the `<mds-kpi>` 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 KPI Panel
13
+
14
+ The canonical form. Place one or more [`mds-kpi-item`](../mds-kpi-item/AGENTS.md) elements as direct children. `mds-kpi` provides the responsive grid; `mds-kpi-item` owns every visible value.
15
+
16
+ ```html
17
+ <mds-kpi>
18
+ <mds-kpi-item label="1.240" description="Pratiche aperte"></mds-kpi-item>
19
+ <mds-kpi-item label="387" description="In lavorazione"></mds-kpi-item>
20
+ <mds-kpi-item label="56" description="Scadute"></mds-kpi-item>
21
+ </mds-kpi>
22
+ ```
23
+
24
+ #### KPI Item with Icon
25
+
26
+ Set `icon` to an icon slug to display a glyph above the value. Use slugs from the Magma icon library - `mi/baseline/*` for Material Icons or an `mgg/` Maggioli slug.
27
+
28
+ ```html
29
+ <mds-kpi>
30
+ <mds-kpi-item
31
+ icon="mi/baseline/folder-open"
32
+ label="1.240"
33
+ description="Pratiche aperte"
34
+ ></mds-kpi-item>
35
+ <mds-kpi-item
36
+ icon="mi/baseline/pending-actions"
37
+ label="387"
38
+ description="In lavorazione"
39
+ ></mds-kpi-item>
40
+ <mds-kpi-item
41
+ icon="mi/baseline/warning"
42
+ label="56"
43
+ description="Scadute"
44
+ ></mds-kpi-item>
45
+ </mds-kpi>
46
+ ```
47
+
48
+ #### Scroll-Triggered Animation
49
+
50
+ Set `threshold` to a value between `0` (exclusive) and `1` to activate the scramble/reveal animation when the item scrolls into the viewport. A threshold of `0.5` triggers once at least half the element is visible. Omit `threshold` (or leave it at the default `0`) for static rendering.
51
+
52
+ ```html
53
+ <mds-kpi>
54
+ <mds-kpi-item
55
+ icon="mi/baseline/groups"
56
+ label="4.512"
57
+ description="Dipendenti"
58
+ threshold="0.5"
59
+ ></mds-kpi-item>
60
+ <mds-kpi-item
61
+ icon="mi/baseline/location-city"
62
+ label="38"
63
+ description="Sedi operative"
64
+ threshold="0.5"
65
+ ></mds-kpi-item>
66
+ <mds-kpi-item
67
+ icon="mi/baseline/stars"
68
+ label="12"
69
+ description="Anni di attivita"
70
+ threshold="0.5"
71
+ ></mds-kpi-item>
72
+ </mds-kpi>
73
+ ```
74
+
75
+ #### Tuning the Animation Speed Globally
76
+
77
+ Use `--mds-kpi-text-animation-speed` on the `<mds-kpi>` host to slow down or speed up the scramble effect for all children at once. The default is `0.15`. The placeholder character during the scramble phase is controlled by `--mds-kpi-text-animation-placeholder-char` (default: a space).
78
+
79
+ ```css
80
+ .hero-section mds-kpi {
81
+ --mds-kpi-text-animation-speed: 0.08;
82
+ --mds-kpi-text-animation-placeholder-char: '-';
83
+ }
84
+ ```
85
+
86
+ #### Styling Individual Items
87
+
88
+ Customize a single `<mds-kpi-item>` through its own CSS custom properties. Use the semantic color roles via `rgb(var(--magma-<role>))` ([`agents/color.md`](../../../../agents/color.md)) so dark mode keeps working.
89
+
90
+ ```css
91
+ .progetto-kpi mds-kpi-item {
92
+ --mds-kpi-item-icon-color: rgb(var(--magma-accent-emphasis));
93
+ --mds-kpi-item-info-background: rgb(var(--magma-surface-overlay));
94
+ }
95
+ ```
96
+
97
+ #### Targeting Shadow Parts
98
+
99
+ When a CSS custom property is not enough, target the documented shadow parts of `<mds-kpi-item>` - `icon`, `icon-container`, and `content` - via `::part()`. Use this only when deeper visual control is required.
100
+
101
+ ```css
102
+ mds-kpi-item::part(icon) {
103
+ width: 30%;
104
+ }
105
+
106
+ mds-kpi-item::part(content) {
107
+ text-align: left;
108
+ }
109
+ ```
@@ -0,0 +1,62 @@
1
+ <!--
2
+ GENERATED FILE - do not edit by hand.
3
+ Source of truth: src/components/mds-kpi-item/ 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-kpi-item
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-kpi-item>` web component is a compound child that represents a single key-performance-indicator entry - a prominent numeric `label` with an optional `description` and `icon` - inside its parent container [`<mds-kpi>`](../mds-kpi/AGENTS.md). It carries no native HTML primitive of its own; it is a presentational list row that `<mds-kpi>` exposes as a list.
12
+
13
+ #### Semantic Behavior
14
+
15
+ - **Compound constraint**: Must be placed as a direct default-slot child of [`<mds-kpi>`](../mds-kpi/AGENTS.md); it is not used standalone, and the parent's list semantics only make sense when its children are `mds-kpi-item` elements (do not mix in other child types).
16
+ - **Accessible name**: Each item is announced as one list entry, with its spoken text consolidated as `"{label}: {description}"` (a missing prop reads `undefined`).
17
+ - **Scroll-triggered animation**: When `threshold` is greater than `0`, the `label`/`description` reveal with the `yugop` text animation once the item scrolls into the viewport. With `threshold === 0` (the default) the text is rendered immediately with no animation.
18
+ - **Conditional rendering**: The icon, value, and description each render only when their respective prop is provided, so an item can show any subset of icon, value, and caption.
19
+
20
+ #### Properties & Visual Configurations
21
+
22
+ - **`threshold`**: Controls the reveal-on-scroll behavior. Leave at `0` for static KPIs that should be visible immediately; set a value between `0` and `1` (the fraction of the element that must enter the viewport) to defer the scramble-in animation until the item is scrolled into view - useful for KPI strips lower on a page.
23
+ - **`label`** holds the headline figure (rendered as `h2` typography) and **`description`** the supporting caption (rendered as `label` typography); together they form the item's spoken accessible name, so prefer concise, self-explanatory values.
24
+ - **`icon`** takes an `mds-icon` name and adds a leading visual marker above the figure; omit it for text-only KPIs.
25
+
26
+ Animation pacing and colors are tunable per item via the CSS custom properties documented in [`AGENTS.md`](AGENTS.md) (`--mds-kpi-item-text-animation-speed`, `--mds-kpi-item-icon-color`, and related).
27
+
28
+ ## Read next
29
+
30
+ - [`pattern.md`](pattern.md) - correct usage, with examples
31
+ - [`antipattern.md`](antipattern.md) - mistakes to avoid
32
+ - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`anti-patterns.md`](../../../../agents/anti-patterns.md) - the rules shared by every component
33
+
34
+ ## Props
35
+
36
+ | Prop | Attribute | Type | Default | Description |
37
+ | --- | --- | --- | --- | --- |
38
+ | `description` | `description` | `string \| undefined` | - | Specifies the description under the value in the KPI element |
39
+ | `icon` | `icon` | `string \| undefined` | - | Specifies the icon on the top of the KPI element |
40
+ | `label` | `label` | `string \| undefined` | - | Specifies the number to be displayed in the KPI element |
41
+ | `threshold` | `threshold` | `number \| undefined` | `0` | Specifies the page threshold which starts the text animation |
42
+
43
+ ## Parts
44
+
45
+ | Part | Description |
46
+ | --- | --- |
47
+ | `content` | Selects the label and description wrapper element |
48
+ | `icon` | Selects the icon element |
49
+ | `icon-container` | Selects the icon wrapper element |
50
+
51
+ ## CSS custom properties
52
+
53
+ | Property | Description |
54
+ | --- | --- |
55
+ | `--mds-kpi-item-icon-color` | Set the fill color of the icon element |
56
+ | `--mds-kpi-item-info-background` | Set the `background-color` of the text area element |
57
+ | `--mds-kpi-item-text-animation-placeholder-char` | Sets the animation placeholder char of the text |
58
+ | `--mds-kpi-item-text-animation-speed` | Sets the animation speed of the text |
59
+
60
+ ## Dependencies
61
+
62
+ Uses: `mds-icon`, `mds-text`.
@@ -0,0 +1,119 @@
1
+ <!--
2
+ GENERATED FILE - do not edit by hand.
3
+ Source of truth: src/components/mds-kpi-item/usage/ in the magma monorepo.
4
+ -->
5
+
6
+ # mds-kpi-item - anti-patterns
7
+
8
+ > The API of this component: [`AGENTS.md`](AGENTS.md).
9
+
10
+ Common incorrect uses of `<mds-kpi-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.
11
+
12
+ #### Do Not Use `mds-kpi-item` Outside `mds-kpi`
13
+
14
+ `<mds-kpi-item>` is a compound child designed to be a direct slot child of [`<mds-kpi>`](../mds-kpi/AGENTS.md). Using it standalone strips the list semantics that `<mds-kpi>` provides and breaks the expected visual layout.
15
+
16
+ ```html
17
+ <!-- INCORRECT -->
18
+ <mds-kpi-item label="1.240" description="Pratiche elaborate"></mds-kpi-item>
19
+
20
+ <!-- CORRECT -->
21
+ <mds-kpi>
22
+ <mds-kpi-item label="1.240" description="Pratiche elaborate"></mds-kpi-item>
23
+ </mds-kpi>
24
+ ```
25
+
26
+ #### Do Not Slot HTML Content for the Label or Description
27
+
28
+ `<mds-kpi-item>` has no default slot - all text content is driven by the `label` and `description` props. Slotting child nodes produces no output because the component renders nothing from its slot.
29
+
30
+ ```html
31
+ <!-- INCORRECT -->
32
+ <mds-kpi>
33
+ <mds-kpi-item>
34
+ <span>1.240</span>
35
+ <small>Pratiche elaborate</small>
36
+ </mds-kpi-item>
37
+ </mds-kpi>
38
+
39
+ <!-- CORRECT -->
40
+ <mds-kpi>
41
+ <mds-kpi-item label="1.240" description="Pratiche elaborate"></mds-kpi-item>
42
+ </mds-kpi>
43
+ ```
44
+
45
+ #### Do Not Slot `<mds-icon>` to Add an Icon
46
+
47
+ The `icon` prop passes the slug to the internal `<mds-icon>` instance. Slotting an `<mds-icon>` directly has no effect because the component has no named slot for icons.
48
+
49
+ ```html
50
+ <!-- INCORRECT -->
51
+ <mds-kpi>
52
+ <mds-kpi-item label="98%" description="Soddisfazione clienti">
53
+ <mds-icon name="mi/baseline/thumb-up"></mds-icon>
54
+ </mds-kpi-item>
55
+ </mds-kpi>
56
+
57
+ <!-- CORRECT -->
58
+ <mds-kpi>
59
+ <mds-kpi-item
60
+ label="98%"
61
+ description="Soddisfazione clienti"
62
+ icon="mi/baseline/thumb-up"
63
+ ></mds-kpi-item>
64
+ </mds-kpi>
65
+ ```
66
+
67
+ #### Do Not Set `threshold="0"` to Disable Animation - Omit It
68
+
69
+ `threshold` defaults to `0`, so setting it explicitly to `"0"` is a no-op. More importantly, `threshold="false"` or `threshold="none"` is parsed to `NaN`, which the IntersectionObserver rejects with an error at runtime.
70
+
71
+ ```html
72
+ <!-- INCORRECT -->
73
+ <mds-kpi-item label="3.500" description="Utenti" threshold="false"></mds-kpi-item>
74
+ <mds-kpi-item label="3.500" description="Utenti" threshold="none"></mds-kpi-item>
75
+
76
+ <!-- CORRECT - omit threshold entirely for no animation (defaults to 0) -->
77
+ <mds-kpi-item label="3.500" description="Utenti"></mds-kpi-item>
78
+ ```
79
+
80
+ #### Do Not Pierce Shadow DOM to Style Internal Elements
81
+
82
+ The supported customization surface is `--mds-kpi-item-*` CSS custom properties and the three documented shadow parts (`icon-container`, `icon`, `content`). Reaching inside the shadow DOM via `>>>` or undocumented class names couples your code to the implementation and will break on minor releases.
83
+
84
+ ```css
85
+ /* INCORRECT */
86
+ mds-kpi-item >>> .info {
87
+ background: white;
88
+ }
89
+ mds-kpi-item >>> .value {
90
+ font-size: 3rem;
91
+ }
92
+
93
+ /* CORRECT */
94
+ mds-kpi-item {
95
+ --mds-kpi-item-info-background: rgb(var(--magma-surface-overlay));
96
+ }
97
+ mds-kpi-item::part(content) {
98
+ padding: calc(var(--spacing) * 600);
99
+ }
100
+ ```
101
+
102
+ #### Do Not Leave Icon-Only Items Without an Accessible Name
103
+
104
+ When both `label` and `description` are omitted the component's `aria-label` resolves to `"undefined: undefined"`, which is meaningless to screen-reader users. Supply an explicit `aria-label` on the host when the item carries no text props (the component keeps it at first render, but writes its own name back at its next re-render).
105
+
106
+ ```html
107
+ <!-- INCORRECT -->
108
+ <mds-kpi>
109
+ <mds-kpi-item icon="mi/baseline/star"></mds-kpi-item>
110
+ </mds-kpi>
111
+
112
+ <!-- CORRECT -->
113
+ <mds-kpi>
114
+ <mds-kpi-item
115
+ icon="mi/baseline/star"
116
+ aria-label="Valutazione eccellente"
117
+ ></mds-kpi-item>
118
+ </mds-kpi>
119
+ ```