@maggioli-design-system/magma 2.14.0 → 2.15.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 (1502) hide show
  1. package/AGENTS.md +1 -1
  2. package/CHANGELOG.md +43 -0
  3. package/agents/assets.md +1 -1
  4. package/agents/install.md +6 -1
  5. package/agents/mcp.md +3 -2
  6. package/agents/patterns/app-shell.md +18 -14
  7. package/agents/patterns/confirm-action.md +138 -15
  8. package/agents/patterns/empty-state.md +116 -15
  9. package/agents/patterns/error-recovery.md +151 -19
  10. package/agents/patterns/item-list.md +12 -11
  11. package/agents/patterns/labels-and-values.md +1 -0
  12. package/agents/patterns/list-with-filters.md +99 -9
  13. package/agents/patterns/loading.md +141 -19
  14. package/agents/patterns/message-placement.md +355 -39
  15. package/agents/patterns/page-header.md +7 -6
  16. package/agents/patterns/previews/actions/banner.dark.webp +0 -0
  17. package/agents/patterns/previews/actions/banner.light.webp +0 -0
  18. package/agents/patterns/previews/actions/confirm.dark.webp +0 -0
  19. package/agents/patterns/previews/actions/confirm.light.webp +0 -0
  20. package/agents/patterns/previews/actions/danger-zone.dark.webp +0 -0
  21. package/agents/patterns/previews/actions/danger-zone.light.webp +0 -0
  22. package/agents/patterns/previews/actions/destructive-in-menu.dark.webp +0 -0
  23. package/agents/patterns/previews/actions/destructive-in-menu.light.webp +0 -0
  24. package/agents/patterns/previews/actions/dismiss-message.dark.webp +0 -0
  25. package/agents/patterns/previews/actions/dismiss-message.light.webp +0 -0
  26. package/agents/patterns/previews/actions/dismiss.dark.webp +0 -0
  27. package/agents/patterns/previews/actions/dismiss.light.webp +0 -0
  28. package/agents/patterns/previews/actions/more-in-menu.dark.webp +0 -0
  29. package/agents/patterns/previews/actions/more-in-menu.light.webp +0 -0
  30. package/agents/patterns/previews/actions/part-primary.dark.webp +0 -0
  31. package/agents/patterns/previews/actions/part-primary.light.webp +0 -0
  32. package/agents/patterns/previews/actions/primary.dark.webp +0 -0
  33. package/agents/patterns/previews/actions/primary.light.webp +0 -0
  34. package/agents/patterns/previews/actions/remove.dark.webp +0 -0
  35. package/agents/patterns/previews/actions/secondary.dark.webp +0 -0
  36. package/agents/patterns/previews/actions/secondary.light.webp +0 -0
  37. package/agents/patterns/previews/actions/stacked.dark.webp +0 -0
  38. package/agents/patterns/previews/actions/stacked.light.webp +0 -0
  39. package/agents/patterns/previews/actions/toast.dark.webp +0 -0
  40. package/agents/patterns/previews/app-shell/back-office.dark.webp +0 -0
  41. package/agents/patterns/previews/app-shell/back-office.html +2 -2
  42. package/agents/patterns/previews/app-shell/back-office.light.webp +0 -0
  43. package/agents/patterns/previews/app-shell/many-sections.dark.webp +0 -0
  44. package/agents/patterns/previews/app-shell/many-sections.html +2 -2
  45. package/agents/patterns/previews/app-shell/many-sections.light.webp +0 -0
  46. package/agents/patterns/previews/app-shell/public-service.dark.webp +0 -0
  47. package/agents/patterns/previews/app-shell/public-service.html +2 -2
  48. package/agents/patterns/previews/app-shell/public-service.light.webp +0 -0
  49. package/agents/patterns/previews/app-shell/section-menus.dark.webp +0 -0
  50. package/agents/patterns/previews/app-shell/section-menus.html +2 -2
  51. package/agents/patterns/previews/app-shell/section-menus.light.webp +0 -0
  52. package/agents/patterns/previews/confirm-action/act-then-undo.dark.webp +0 -0
  53. package/agents/patterns/previews/confirm-action/act-then-undo.html +1 -1
  54. package/agents/patterns/previews/confirm-action/ask-before-sending.dark.webp +0 -0
  55. package/agents/patterns/previews/confirm-action/ask-before-sending.light.webp +0 -0
  56. package/agents/patterns/previews/confirm-action/ask-first-many.dark.webp +0 -0
  57. package/agents/patterns/previews/confirm-action/ask-first-many.light.webp +0 -0
  58. package/agents/patterns/previews/confirm-action/ask-first.dark.webp +0 -0
  59. package/agents/patterns/previews/confirm-action/ask-first.light.webp +0 -0
  60. package/agents/patterns/previews/confirm-action/make-reversible.dark.webp +0 -0
  61. package/agents/patterns/previews/confirm-action/make-reversible.html +1 -1
  62. package/agents/patterns/previews/confirm-action/make-reversible.light.webp +0 -0
  63. package/agents/patterns/previews/confirm-action/send-as-shown.dark.webp +0 -0
  64. package/agents/patterns/previews/confirm-action/send-as-shown.html +2 -2
  65. package/agents/patterns/previews/confirm-action/send-as-shown.light.webp +0 -0
  66. package/agents/patterns/previews/empty-state/add-the-first.dark.webp +0 -0
  67. package/agents/patterns/previews/empty-state/add-the-first.html +1 -1
  68. package/agents/patterns/previews/empty-state/add-the-first.light.webp +0 -0
  69. package/agents/patterns/previews/empty-state/all-done.dark.webp +0 -0
  70. package/agents/patterns/previews/empty-state/all-done.html +1 -1
  71. package/agents/patterns/previews/empty-state/all-done.light.webp +0 -0
  72. package/agents/patterns/previews/empty-state/clear-filters.dark.webp +0 -0
  73. package/agents/patterns/previews/empty-state/clear-filters.html +2 -2
  74. package/agents/patterns/previews/empty-state/clear-filters.light.webp +0 -0
  75. package/agents/patterns/previews/empty-state/filled-by-others.dark.webp +0 -0
  76. package/agents/patterns/previews/empty-state/filled-by-others.html +1 -1
  77. package/agents/patterns/previews/empty-state/filled-by-others.light.webp +0 -0
  78. package/agents/patterns/previews/empty-state/not-found.dark.webp +0 -0
  79. package/agents/patterns/previews/empty-state/not-found.html +2 -2
  80. package/agents/patterns/previews/empty-state/not-found.light.webp +0 -0
  81. package/agents/patterns/previews/empty-state/one-line.dark.webp +0 -0
  82. package/agents/patterns/previews/empty-state/one-line.html +1 -1
  83. package/agents/patterns/previews/error-recovery/action-another-way.dark.webp +0 -0
  84. package/agents/patterns/previews/error-recovery/action-another-way.html +3 -3
  85. package/agents/patterns/previews/error-recovery/action-another-way.light.webp +0 -0
  86. package/agents/patterns/previews/error-recovery/changed-meanwhile.dark.webp +0 -0
  87. package/agents/patterns/previews/error-recovery/changed-meanwhile.html +4 -4
  88. package/agents/patterns/previews/error-recovery/changed-meanwhile.light.webp +0 -0
  89. package/agents/patterns/previews/error-recovery/check-or-repeat.dark.webp +0 -0
  90. package/agents/patterns/previews/error-recovery/check-or-repeat.html +4 -4
  91. package/agents/patterns/previews/error-recovery/check-or-repeat.light.webp +0 -0
  92. package/agents/patterns/previews/error-recovery/content-another-way.dark.webp +0 -0
  93. package/agents/patterns/previews/error-recovery/content-another-way.html +1 -1
  94. package/agents/patterns/previews/error-recovery/content-another-way.light.webp +0 -0
  95. package/agents/patterns/previews/error-recovery/partial.dark.webp +0 -0
  96. package/agents/patterns/previews/error-recovery/partial.html +2 -2
  97. package/agents/patterns/previews/error-recovery/partial.light.webp +0 -0
  98. package/agents/patterns/previews/error-recovery/retry-action.dark.webp +0 -0
  99. package/agents/patterns/previews/error-recovery/retry-action.html +4 -4
  100. package/agents/patterns/previews/error-recovery/retry-action.light.webp +0 -0
  101. package/agents/patterns/previews/error-recovery/retry-content.dark.webp +0 -0
  102. package/agents/patterns/previews/error-recovery/retry-content.html +2 -2
  103. package/agents/patterns/previews/error-recovery/sign-in-again.dark.webp +0 -0
  104. package/agents/patterns/previews/error-recovery/sign-in-again.html +4 -4
  105. package/agents/patterns/previews/error-recovery/sign-in-again.light.webp +0 -0
  106. package/agents/patterns/previews/item-list/documents-of-a-request.dark.webp +0 -0
  107. package/agents/patterns/previews/item-list/documents-of-a-request.html +1 -1
  108. package/agents/patterns/previews/item-list/documents-of-a-request.light.webp +0 -0
  109. package/agents/patterns/previews/item-list/queue-of-a-desk.dark.webp +0 -0
  110. package/agents/patterns/previews/item-list/queue-of-a-desk.light.webp +0 -0
  111. package/agents/patterns/previews/item-list/requests-of-an-office.dark.webp +0 -0
  112. package/agents/patterns/previews/item-list/requests-of-an-office.light.webp +0 -0
  113. package/agents/patterns/previews/item-list/requests-to-assign.dark.webp +0 -0
  114. package/agents/patterns/previews/item-list/requests-to-assign.light.webp +0 -0
  115. package/agents/patterns/previews/labels-and-values/data-of-a-contact.dark.webp +0 -0
  116. package/agents/patterns/previews/labels-and-values/data-of-a-contact.html +1 -1
  117. package/agents/patterns/previews/labels-and-values/payment-before-paying.dark.webp +0 -0
  118. package/agents/patterns/previews/labels-and-values/payment-before-paying.html +2 -2
  119. package/agents/patterns/previews/labels-and-values/payment-before-paying.light.webp +0 -0
  120. package/agents/patterns/previews/labels-and-values/what-is-sent.dark.webp +0 -0
  121. package/agents/patterns/previews/labels-and-values/what-is-sent.html +4 -4
  122. package/agents/patterns/previews/labels-and-values/what-is-sent.light.webp +0 -0
  123. package/agents/patterns/previews/list-with-filters/act-on-many.dark.webp +0 -0
  124. package/agents/patterns/previews/list-with-filters/act-on-many.html +8 -8
  125. package/agents/patterns/previews/list-with-filters/act-on-many.light.webp +0 -0
  126. package/agents/patterns/previews/list-with-filters/find-and-open.dark.webp +0 -0
  127. package/agents/patterns/previews/list-with-filters/find-and-open.html +4 -4
  128. package/agents/patterns/previews/list-with-filters/find-and-open.light.webp +0 -0
  129. package/agents/patterns/previews/list-with-filters/show-new-items.dark.webp +0 -0
  130. package/agents/patterns/previews/list-with-filters/show-new-items.html +7 -7
  131. package/agents/patterns/previews/list-with-filters/show-new-items.light.webp +0 -0
  132. package/agents/patterns/previews/loading/await-and-say.dark.webp +0 -0
  133. package/agents/patterns/previews/loading/await-and-say.html +2 -2
  134. package/agents/patterns/previews/loading/await-and-say.light.webp +0 -0
  135. package/agents/patterns/previews/loading/await-the-control.dark.webp +0 -0
  136. package/agents/patterns/previews/loading/await-the-control.html +3 -3
  137. package/agents/patterns/previews/loading/await-the-control.light.webp +0 -0
  138. package/agents/patterns/previews/loading/first-load.dark.webp +0 -0
  139. package/agents/patterns/previews/loading/first-load.html +1 -1
  140. package/agents/patterns/previews/loading/first-load.light.webp +0 -0
  141. package/agents/patterns/previews/loading/keep-while-reloading.dark.webp +0 -0
  142. package/agents/patterns/previews/loading/keep-while-reloading.html +2 -2
  143. package/agents/patterns/previews/loading/keep-while-reloading.light.webp +0 -0
  144. package/agents/patterns/previews/loading/long-load-measured.dark.webp +0 -0
  145. package/agents/patterns/previews/loading/long-load-measured.html +1 -1
  146. package/agents/patterns/previews/loading/long-load-measured.light.webp +0 -0
  147. package/agents/patterns/previews/loading/long-load.dark.webp +0 -0
  148. package/agents/patterns/previews/loading/long-load.html +1 -1
  149. package/agents/patterns/previews/loading/long-load.light.webp +0 -0
  150. package/agents/patterns/previews/loading/progress-in-place.dark.webp +0 -0
  151. package/agents/patterns/previews/loading/progress-in-place.html +2 -2
  152. package/agents/patterns/previews/loading/progress-in-place.light.webp +0 -0
  153. package/agents/patterns/previews/loading/run-in-background.dark.webp +0 -0
  154. package/agents/patterns/previews/loading/run-in-background.html +2 -2
  155. package/agents/patterns/previews/loading/run-in-background.light.webp +0 -0
  156. package/agents/patterns/previews/message-placement/action-done-elsewhere.dark.webp +0 -0
  157. package/agents/patterns/previews/message-placement/action-done-elsewhere.html +2 -2
  158. package/agents/patterns/previews/message-placement/action-done-elsewhere.light.webp +0 -0
  159. package/agents/patterns/previews/message-placement/action-done-in-page.dark.webp +0 -0
  160. package/agents/patterns/previews/message-placement/action-done-in-page.html +3 -3
  161. package/agents/patterns/previews/message-placement/action-done-in-page.light.webp +0 -0
  162. package/agents/patterns/previews/message-placement/action-done-in-part.dark.webp +0 -0
  163. package/agents/patterns/previews/message-placement/action-done-in-part.html +4 -4
  164. package/agents/patterns/previews/message-placement/action-done-in-part.light.webp +0 -0
  165. package/agents/patterns/previews/message-placement/action-failed-elsewhere.dark.webp +0 -0
  166. package/agents/patterns/previews/message-placement/action-failed-elsewhere.html +3 -3
  167. package/agents/patterns/previews/message-placement/action-failed-elsewhere.light.webp +0 -0
  168. package/agents/patterns/previews/message-placement/action-failed-in-place.dark.webp +0 -0
  169. package/agents/patterns/previews/message-placement/action-failed-in-place.html +2 -2
  170. package/agents/patterns/previews/message-placement/action-failed-in-place.light.webp +0 -0
  171. package/agents/patterns/previews/message-placement/action-later.dark.webp +0 -0
  172. package/agents/patterns/previews/message-placement/action-later.html +2 -2
  173. package/agents/patterns/previews/message-placement/action-later.light.webp +0 -0
  174. package/agents/patterns/previews/message-placement/action-partial-elsewhere.dark.webp +0 -0
  175. package/agents/patterns/previews/message-placement/action-partial-elsewhere.html +3 -3
  176. package/agents/patterns/previews/message-placement/action-partial-elsewhere.light.webp +0 -0
  177. package/agents/patterns/previews/message-placement/action-partial-in-place.dark.webp +0 -0
  178. package/agents/patterns/previews/message-placement/action-partial-in-place.html +2 -2
  179. package/agents/patterns/previews/message-placement/action-partial-in-place.light.webp +0 -0
  180. package/agents/patterns/previews/message-placement/action-taken.dark.webp +0 -0
  181. package/agents/patterns/previews/message-placement/action-taken.html +1 -1
  182. package/agents/patterns/previews/message-placement/action-taken.light.webp +0 -0
  183. package/agents/patterns/previews/message-placement/app-deadline.dark.webp +0 -0
  184. package/agents/patterns/previews/message-placement/app-deadline.html +1 -1
  185. package/agents/patterns/previews/message-placement/app-failed.dark.webp +0 -0
  186. package/agents/patterns/previews/message-placement/app-failed.html +4 -4
  187. package/agents/patterns/previews/message-placement/app-failed.light.webp +0 -0
  188. package/agents/patterns/previews/message-placement/app-info.dark.webp +0 -0
  189. package/agents/patterns/previews/message-placement/app-info.html +1 -1
  190. package/agents/patterns/previews/message-placement/decision.dark.webp +0 -0
  191. package/agents/patterns/previews/message-placement/decision.html +3 -3
  192. package/agents/patterns/previews/message-placement/decision.light.webp +0 -0
  193. package/agents/patterns/previews/message-placement/field-error.dark.webp +0 -0
  194. package/agents/patterns/previews/message-placement/field-error.html +1 -1
  195. package/agents/patterns/previews/message-placement/field-error.light.webp +0 -0
  196. package/agents/patterns/previews/message-placement/field-hint.dark.webp +0 -0
  197. package/agents/patterns/previews/message-placement/field-hint.light.webp +0 -0
  198. package/agents/patterns/previews/message-placement/field-valid.dark.webp +0 -0
  199. package/agents/patterns/previews/message-placement/field-valid.html +3 -3
  200. package/agents/patterns/previews/message-placement/region-failed.dark.webp +0 -0
  201. package/agents/patterns/previews/message-placement/region-failed.html +3 -3
  202. package/agents/patterns/previews/message-placement/region-info.dark.webp +0 -0
  203. package/agents/patterns/previews/message-placement/region-info.html +2 -2
  204. package/agents/patterns/previews/message-placement/region-info.light.webp +0 -0
  205. package/agents/patterns/previews/page-header/contact-being-edited.dark.webp +0 -0
  206. package/agents/patterns/previews/page-header/contact-being-edited.html +1 -1
  207. package/agents/patterns/previews/page-header/contact-being-edited.light.webp +0 -0
  208. package/agents/patterns/previews/page-header/members-of-a-group.dark.webp +0 -0
  209. package/agents/patterns/previews/page-header/members-of-a-group.html +1 -1
  210. package/agents/patterns/previews/page-header/members-of-a-group.light.webp +0 -0
  211. package/agents/patterns/previews/page-header/own-profile.dark.webp +0 -0
  212. package/agents/patterns/previews/page-header/own-profile.html +1 -1
  213. package/agents/patterns/previews/page-header/own-profile.light.webp +0 -0
  214. package/agents/patterns/previews/page-header/request-from-the-list.dark.webp +0 -0
  215. package/agents/patterns/previews/page-header/request-from-the-list.html +1 -1
  216. package/agents/patterns/previews/page-header/request-from-the-list.light.webp +0 -0
  217. package/agents/patterns/previews/page-header/requests-of-an-office.dark.webp +0 -0
  218. package/agents/patterns/previews/page-header/requests-of-an-office.html +1 -1
  219. package/agents/patterns/previews/page-header/requests-of-an-office.light.webp +0 -0
  220. package/agents/patterns/previews/record-detail/ask-for-words.dark.webp +0 -0
  221. package/agents/patterns/previews/record-detail/ask-for-words.html +3 -3
  222. package/agents/patterns/previews/record-detail/ask-for-words.light.webp +0 -0
  223. package/agents/patterns/previews/record-detail/edit-data.dark.webp +0 -0
  224. package/agents/patterns/previews/record-detail/edit-data.html +8 -8
  225. package/agents/patterns/previews/record-detail/edit-data.light.webp +0 -0
  226. package/agents/patterns/previews/record-detail/read-the-data.dark.webp +0 -0
  227. package/agents/patterns/previews/record-detail/read-the-data.html +3 -3
  228. package/agents/patterns/previews/record-detail/read-the-data.light.webp +0 -0
  229. package/agents/patterns/previews/record-detail/record-changed.dark.webp +0 -0
  230. package/agents/patterns/previews/record-detail/record-changed.html +8 -8
  231. package/agents/patterns/previews/record-detail/record-changed.light.webp +0 -0
  232. package/agents/patterns/previews/record-detail/run-at-once.dark.webp +0 -0
  233. package/agents/patterns/previews/record-detail/run-at-once.html +7 -7
  234. package/agents/patterns/previews/record-detail/run-at-once.light.webp +0 -0
  235. package/agents/patterns/previews/record-detail/work-on-it.dark.webp +0 -0
  236. package/agents/patterns/previews/record-detail/work-on-it.html +2 -2
  237. package/agents/patterns/previews/record-detail/work-on-it.light.webp +0 -0
  238. package/agents/patterns/previews/rhythm/between-containers.dark.webp +0 -0
  239. package/agents/patterns/previews/rhythm/between-containers.light.webp +0 -0
  240. package/agents/patterns/previews/rhythm/between-fields.dark.webp +0 -0
  241. package/agents/patterns/previews/rhythm/between-fields.light.webp +0 -0
  242. package/agents/patterns/previews/rhythm/between-groups.dark.webp +0 -0
  243. package/agents/patterns/previews/rhythm/between-groups.light.webp +0 -0
  244. package/agents/patterns/previews/rhythm/between-sections.dark.webp +0 -0
  245. package/agents/patterns/previews/rhythm/between-sections.light.webp +0 -0
  246. package/agents/patterns/previews/rhythm/content-actions.dark.webp +0 -0
  247. package/agents/patterns/previews/rhythm/content-actions.light.webp +0 -0
  248. package/agents/patterns/previews/rhythm/inline.dark.webp +0 -0
  249. package/agents/patterns/previews/rhythm/inline.light.webp +0 -0
  250. package/agents/patterns/previews/rhythm/inset.dark.webp +0 -0
  251. package/agents/patterns/previews/rhythm/inset.light.webp +0 -0
  252. package/agents/patterns/previews/rhythm/label-control.dark.webp +0 -0
  253. package/agents/patterns/previews/rhythm/title-content.dark.webp +0 -0
  254. package/agents/patterns/previews/rhythm/title-content.light.webp +0 -0
  255. package/agents/patterns/previews/surfaces/band.dark.webp +0 -0
  256. package/agents/patterns/previews/surfaces/band.light.webp +0 -0
  257. package/agents/patterns/previews/surfaces/canvas.dark.webp +0 -0
  258. package/agents/patterns/previews/surfaces/canvas.light.webp +0 -0
  259. package/agents/patterns/previews/surfaces/card.dark.webp +0 -0
  260. package/agents/patterns/previews/surfaces/card.light.webp +0 -0
  261. package/agents/patterns/previews/surfaces/dialog.dark.webp +0 -0
  262. package/agents/patterns/previews/surfaces/dialog.light.webp +0 -0
  263. package/agents/patterns/previews/surfaces/edit-actions.dark.webp +0 -0
  264. package/agents/patterns/previews/surfaces/edit-actions.light.webp +0 -0
  265. package/agents/patterns/previews/surfaces/intro-band.dark.webp +0 -0
  266. package/agents/patterns/previews/surfaces/intro-band.light.webp +0 -0
  267. package/agents/patterns/previews/surfaces/section.dark.webp +0 -0
  268. package/agents/patterns/previews/surfaces/section.light.webp +0 -0
  269. package/agents/patterns/previews/titles/dialog.dark.webp +0 -0
  270. package/agents/patterns/previews/titles/dialog.light.webp +0 -0
  271. package/agents/patterns/previews/titles/group.dark.webp +0 -0
  272. package/agents/patterns/previews/titles/group.light.webp +0 -0
  273. package/agents/patterns/previews/titles/page.dark.webp +0 -0
  274. package/agents/patterns/previews/titles/page.light.webp +0 -0
  275. package/agents/patterns/previews/titles/part.dark.webp +0 -0
  276. package/agents/patterns/previews/titles/part.light.webp +0 -0
  277. package/agents/patterns/previews/titles/section.dark.webp +0 -0
  278. package/agents/patterns/previews/titles/section.light.webp +0 -0
  279. package/agents/patterns/previews/widths/dialog.dark.webp +0 -0
  280. package/agents/patterns/previews/widths/dialog.light.webp +0 -0
  281. package/agents/patterns/previews/widths/field.dark.webp +0 -0
  282. package/agents/patterns/previews/widths/field.light.webp +0 -0
  283. package/agents/patterns/previews/widths/form.dark.webp +0 -0
  284. package/agents/patterns/previews/widths/form.light.webp +0 -0
  285. package/agents/patterns/previews/widths/page.dark.webp +0 -0
  286. package/agents/patterns/previews/widths/page.light.webp +0 -0
  287. package/agents/patterns/previews/widths/reading.dark.webp +0 -0
  288. package/agents/patterns/previews/widths/reading.light.webp +0 -0
  289. package/agents/patterns/record-detail.md +179 -15
  290. package/agents/reporting.md +5 -1
  291. package/dist/cjs/{floating-controller-B21tqid0.js → floating-controller-CelMdjyj.js} +1 -1
  292. package/dist/cjs/{index-B99V_UhC.js → index-CGlQW3pX.js} +16 -6
  293. package/dist/cjs/{index-CFEj7WVH.js → index-CWkxqm6T.js} +1 -1
  294. package/dist/cjs/index.cjs.js +2 -2
  295. package/dist/cjs/loader.cjs.js +2 -2
  296. package/dist/cjs/{locale-6jikg4jE.js → locale-q_KROc3I.js} +10 -2
  297. package/dist/cjs/magma-components.cjs.js +3 -3
  298. package/dist/cjs/mds-accordion-item.cjs.entry.js +3 -3
  299. package/dist/cjs/mds-accordion-timer-item.cjs.entry.js +2 -2
  300. package/dist/cjs/mds-accordion-timer.cjs.entry.js +1 -1
  301. package/dist/cjs/mds-accordion.cjs.entry.js +3 -3
  302. package/dist/cjs/mds-author.cjs.entry.js +1 -1
  303. package/dist/cjs/mds-avatar-stack-item.cjs.entry.js +1 -1
  304. package/dist/cjs/mds-avatar-stack.cjs.entry.js +1 -1
  305. package/dist/cjs/mds-avatar.cjs.entry.js +3 -3
  306. package/dist/cjs/mds-badge.cjs.entry.js +3 -3
  307. package/dist/cjs/mds-banner_3.cjs.entry.js +5 -5
  308. package/dist/cjs/mds-benchmark-bar.cjs.entry.js +1 -1
  309. package/dist/cjs/mds-bibliography.cjs.entry.js +1 -1
  310. package/dist/cjs/mds-book.cjs.entry.js +8 -8
  311. package/dist/cjs/mds-breadcrumb-item.cjs.entry.js +1 -1
  312. package/dist/cjs/mds-breadcrumb.cjs.entry.js +3 -3
  313. package/dist/cjs/mds-button-dropdown.cjs.entry.js +27 -9
  314. package/dist/cjs/mds-button-group.cjs.entry.js +1 -1
  315. package/dist/cjs/mds-button_3.cjs.entry.js +34 -13
  316. package/dist/cjs/mds-calendar_2.cjs.entry.js +4 -4
  317. package/dist/cjs/mds-card-content.cjs.entry.js +1 -1
  318. package/dist/cjs/mds-card-footer.cjs.entry.js +1 -1
  319. package/dist/cjs/mds-card-header.cjs.entry.js +1 -1
  320. package/dist/cjs/mds-card-media.cjs.entry.js +1 -1
  321. package/dist/cjs/mds-card.cjs.entry.js +2 -2
  322. package/dist/cjs/mds-details.cjs.entry.js +3 -3
  323. package/dist/cjs/mds-dropdown.cjs.entry.js +3 -3
  324. package/dist/cjs/mds-emoji.cjs.entry.js +3 -3
  325. package/dist/cjs/mds-entity.cjs.entry.js +3 -3
  326. package/dist/cjs/mds-file-preview.cjs.entry.js +4 -4
  327. package/dist/cjs/mds-file.cjs.entry.js +4 -4
  328. package/dist/cjs/mds-filter-item.cjs.entry.js +3 -3
  329. package/dist/cjs/mds-filter.cjs.entry.js +4 -4
  330. package/dist/cjs/mds-header-bar.cjs.entry.js +3 -3
  331. package/dist/cjs/mds-header.cjs.entry.js +2 -2
  332. package/dist/cjs/mds-horizontal-scroll.cjs.entry.js +3 -3
  333. package/dist/cjs/mds-hr.cjs.entry.js +2 -2
  334. package/dist/cjs/mds-img.cjs.entry.js +13 -8
  335. package/dist/cjs/mds-input-date-range-preselection.cjs.entry.js +2 -2
  336. package/dist/cjs/mds-input-date-range.cjs.entry.js +8 -8
  337. package/dist/cjs/mds-input-date.cjs.entry.js +5 -5
  338. package/dist/cjs/mds-input-field.cjs.entry.js +4 -3
  339. package/dist/cjs/mds-input-otp.cjs.entry.js +4 -4
  340. package/dist/cjs/mds-input-range-value.cjs.entry.js +2 -2
  341. package/dist/cjs/mds-input-range.cjs.entry.js +6 -6
  342. package/dist/cjs/mds-input-select.cjs.entry.js +7 -7
  343. package/dist/cjs/mds-input-switch_2.cjs.entry.js +6 -6
  344. package/dist/cjs/mds-input-tip_2.cjs.entry.js +6 -6
  345. package/dist/cjs/mds-input-upload.cjs.entry.js +9 -9
  346. package/dist/cjs/mds-input.cjs.entry.js +9 -9
  347. package/dist/cjs/mds-keyboard-key.cjs.entry.js +4 -4
  348. package/dist/cjs/mds-keyboard.cjs.entry.js +4 -4
  349. package/dist/cjs/mds-kpi-item.cjs.entry.js +4 -4
  350. package/dist/cjs/mds-kpi.cjs.entry.js +2 -2
  351. package/dist/cjs/mds-label.cjs.entry.js +4 -4
  352. package/dist/cjs/mds-link.cjs.entry.js +32 -11
  353. package/dist/cjs/mds-list-item.cjs.entry.js +2 -2
  354. package/dist/cjs/mds-list.cjs.entry.js +2 -2
  355. package/dist/cjs/mds-mention.cjs.entry.js +4 -4
  356. package/dist/cjs/mds-modal.cjs.entry.js +5 -5
  357. package/dist/cjs/mds-note.cjs.entry.js +5 -5
  358. package/dist/cjs/mds-notification.cjs.entry.js +3 -3
  359. package/dist/cjs/mds-paginator-item.cjs.entry.js +4 -4
  360. package/dist/cjs/mds-paginator.cjs.entry.js +4 -4
  361. package/dist/cjs/mds-policy-ai.cjs.entry.js +5 -5
  362. package/dist/cjs/mds-pref-animation.cjs.entry.js +4 -4
  363. package/dist/cjs/mds-pref-consumption.cjs.entry.js +4 -4
  364. package/dist/cjs/mds-pref-contrast.cjs.entry.js +4 -4
  365. package/dist/cjs/mds-pref-language-item.cjs.entry.js +4 -4
  366. package/dist/cjs/mds-pref-language.cjs.entry.js +4 -4
  367. package/dist/cjs/mds-pref-mode.cjs.entry.js +5 -5
  368. package/dist/cjs/mds-pref-theme-item.cjs.entry.js +3 -3
  369. package/dist/cjs/mds-pref-theme.cjs.entry.js +4 -4
  370. package/dist/cjs/mds-pref.cjs.entry.js +4 -4
  371. package/dist/cjs/mds-price-table-features-cell.cjs.entry.js +4 -4
  372. package/dist/cjs/mds-price-table-features-row.cjs.entry.js +3 -3
  373. package/dist/cjs/mds-price-table-features.cjs.entry.js +4 -4
  374. package/dist/cjs/mds-price-table-header.cjs.entry.js +2 -2
  375. package/dist/cjs/mds-price-table-list-item.cjs.entry.js +2 -2
  376. package/dist/cjs/mds-price-table-list.cjs.entry.js +4 -4
  377. package/dist/cjs/mds-price-table.cjs.entry.js +2 -2
  378. package/dist/cjs/mds-progress_2.cjs.entry.js +6 -6
  379. package/dist/cjs/mds-push-notification-item.cjs.entry.js +6 -6
  380. package/dist/cjs/mds-push-notification.cjs.entry.js +5 -5
  381. package/dist/cjs/mds-quote.cjs.entry.js +3 -3
  382. package/dist/cjs/mds-radial-menu-item.cjs.entry.js +2 -2
  383. package/dist/cjs/mds-radial-menu.cjs.entry.js +5 -5
  384. package/dist/cjs/mds-separator.cjs.entry.js +4 -4
  385. package/dist/cjs/mds-status-bar.cjs.entry.js +3 -3
  386. package/dist/cjs/mds-stepper-bar-item.cjs.entry.js +17 -7
  387. package/dist/cjs/mds-stepper-bar.cjs.entry.js +9 -7
  388. package/dist/cjs/mds-tab-bar-item.cjs.entry.js +4 -4
  389. package/dist/cjs/mds-tab-bar.cjs.entry.js +3 -3
  390. package/dist/cjs/mds-tab_2.cjs.entry.js +5 -5
  391. package/dist/cjs/mds-table-body.cjs.entry.js +3 -3
  392. package/dist/cjs/mds-table-footer.cjs.entry.js +3 -3
  393. package/dist/cjs/mds-table-header-cell.cjs.entry.js +3 -3
  394. package/dist/cjs/mds-table-header.cjs.entry.js +4 -4
  395. package/dist/cjs/mds-table-row.cjs.entry.js +5 -5
  396. package/dist/cjs/mds-table.cjs.entry.js +5 -5
  397. package/dist/cjs/mds-text.cjs.entry.js +4 -4
  398. package/dist/cjs/mds-toast-region.cjs.entry.js +2 -2
  399. package/dist/cjs/mds-toast.cjs.entry.js +4 -4
  400. package/dist/cjs/mds-tooltip.cjs.entry.js +16 -9
  401. package/dist/cjs/mds-tree-item.cjs.entry.js +4 -4
  402. package/dist/cjs/mds-tree.cjs.entry.js +3 -3
  403. package/dist/cjs/mds-url-view.cjs.entry.js +4 -4
  404. package/dist/cjs/mds-usage.cjs.entry.js +4 -4
  405. package/dist/cjs/mds-video-wall.cjs.entry.js +4 -4
  406. package/dist/cjs/mds-zero.cjs.entry.js +4 -4
  407. package/dist/cjs/{navigation-Dxea9mKE.js → navigation-B2UAUx-z.js} +14 -0
  408. package/dist/cjs/{preference-DTUJPGHS.js → preference-C4QmB-PB.js} +1 -1
  409. package/dist/collection/collection-manifest.json +1 -1
  410. package/dist/collection/common/locale.js +9 -1
  411. package/dist/collection/common/navigation.js +13 -0
  412. package/dist/collection/components/mds-accordion/AGENTS.md +1 -1
  413. package/dist/collection/components/mds-accordion/documentation.json +2 -2
  414. package/dist/collection/components/mds-accordion/mds-accordion.css +1 -1
  415. package/dist/collection/components/mds-accordion-item/AGENTS.md +1 -1
  416. package/dist/collection/components/mds-accordion-item/documentation.json +2 -2
  417. package/dist/collection/components/mds-accordion-item/mds-accordion-item.css +3 -3
  418. package/dist/collection/components/mds-accordion-timer/AGENTS.md +1 -1
  419. package/dist/collection/components/mds-accordion-timer/documentation.json +2 -2
  420. package/dist/collection/components/mds-accordion-timer-item/AGENTS.md +1 -1
  421. package/dist/collection/components/mds-accordion-timer-item/documentation.json +2 -2
  422. package/dist/collection/components/mds-author/AGENTS.md +1 -1
  423. package/dist/collection/components/mds-author/documentation.json +2 -2
  424. package/dist/collection/components/mds-avatar/AGENTS.md +1 -1
  425. package/dist/collection/components/mds-avatar/documentation.json +2 -2
  426. package/dist/collection/components/mds-avatar/mds-avatar.css +44 -44
  427. package/dist/collection/components/mds-avatar-stack/AGENTS.md +1 -1
  428. package/dist/collection/components/mds-avatar-stack/documentation.json +2 -2
  429. package/dist/collection/components/mds-avatar-stack-item/AGENTS.md +1 -1
  430. package/dist/collection/components/mds-avatar-stack-item/documentation.json +2 -2
  431. package/dist/collection/components/mds-badge/AGENTS.md +1 -1
  432. package/dist/collection/components/mds-badge/documentation.json +2 -2
  433. package/dist/collection/components/mds-badge/mds-badge.css +53 -53
  434. package/dist/collection/components/mds-banner/AGENTS.md +1 -1
  435. package/dist/collection/components/mds-banner/documentation.json +2 -2
  436. package/dist/collection/components/mds-banner/mds-banner.css +13 -13
  437. package/dist/collection/components/mds-benchmark-bar/AGENTS.md +1 -1
  438. package/dist/collection/components/mds-benchmark-bar/documentation.json +2 -2
  439. package/dist/collection/components/mds-bibliography/AGENTS.md +1 -1
  440. package/dist/collection/components/mds-bibliography/documentation.json +2 -2
  441. package/dist/collection/components/mds-book/AGENTS.md +1 -1
  442. package/dist/collection/components/mds-book/documentation.json +2 -2
  443. package/dist/collection/components/mds-book/mds-book.css +2 -2
  444. package/dist/collection/components/mds-breadcrumb/AGENTS.md +1 -1
  445. package/dist/collection/components/mds-breadcrumb/documentation.json +2 -2
  446. package/dist/collection/components/mds-breadcrumb-item/AGENTS.md +1 -1
  447. package/dist/collection/components/mds-breadcrumb-item/documentation.json +2 -2
  448. package/dist/collection/components/mds-button/AGENTS.md +3 -1
  449. package/dist/collection/components/mds-button/documentation.json +33 -4
  450. package/dist/collection/components/mds-button/examples.md +15 -1
  451. package/dist/collection/components/mds-button/mds-button.css +16 -16
  452. package/dist/collection/components/mds-button/mds-button.js +48 -8
  453. package/dist/collection/components/mds-button-dropdown/AGENTS.md +5 -4
  454. package/dist/collection/components/mds-button-dropdown/documentation.json +31 -5
  455. package/dist/collection/components/mds-button-dropdown/examples.md +12 -1
  456. package/dist/collection/components/mds-button-dropdown/mds-button-dropdown.css +6 -6
  457. package/dist/collection/components/mds-button-dropdown/mds-button-dropdown.js +30 -1
  458. package/dist/collection/components/mds-button-dropdown/mistakes.md +16 -0
  459. package/dist/collection/components/mds-button-group/AGENTS.md +1 -1
  460. package/dist/collection/components/mds-button-group/documentation.json +2 -2
  461. package/dist/collection/components/mds-calendar/AGENTS.md +1 -1
  462. package/dist/collection/components/mds-calendar/documentation.json +2 -2
  463. package/dist/collection/components/mds-calendar-cell/AGENTS.md +1 -1
  464. package/dist/collection/components/mds-calendar-cell/documentation.json +2 -2
  465. package/dist/collection/components/mds-calendar-cell/mds-calendar-cell.css +12 -12
  466. package/dist/collection/components/mds-card/AGENTS.md +1 -1
  467. package/dist/collection/components/mds-card/documentation.json +2 -2
  468. package/dist/collection/components/mds-card-content/AGENTS.md +1 -1
  469. package/dist/collection/components/mds-card-content/documentation.json +2 -2
  470. package/dist/collection/components/mds-card-footer/AGENTS.md +1 -1
  471. package/dist/collection/components/mds-card-footer/documentation.json +2 -2
  472. package/dist/collection/components/mds-card-header/AGENTS.md +1 -1
  473. package/dist/collection/components/mds-card-header/documentation.json +2 -2
  474. package/dist/collection/components/mds-card-media/AGENTS.md +1 -1
  475. package/dist/collection/components/mds-card-media/documentation.json +2 -2
  476. package/dist/collection/components/mds-chip/AGENTS.md +1 -1
  477. package/dist/collection/components/mds-chip/documentation.json +2 -2
  478. package/dist/collection/components/mds-chip/mds-chip.css +103 -103
  479. package/dist/collection/components/mds-details/AGENTS.md +1 -1
  480. package/dist/collection/components/mds-details/documentation.json +2 -2
  481. package/dist/collection/components/mds-details/mds-details.css +4 -4
  482. package/dist/collection/components/mds-dropdown/AGENTS.md +1 -1
  483. package/dist/collection/components/mds-dropdown/documentation.json +2 -2
  484. package/dist/collection/components/mds-emoji/AGENTS.md +1 -1
  485. package/dist/collection/components/mds-emoji/documentation.json +2 -2
  486. package/dist/collection/components/mds-emoji/mds-emoji.css +5 -5
  487. package/dist/collection/components/mds-entity/AGENTS.md +1 -1
  488. package/dist/collection/components/mds-entity/documentation.json +2 -2
  489. package/dist/collection/components/mds-entity/mds-entity.css +9 -9
  490. package/dist/collection/components/mds-file/AGENTS.md +1 -1
  491. package/dist/collection/components/mds-file/documentation.json +2 -2
  492. package/dist/collection/components/mds-file/mds-file.css +24 -24
  493. package/dist/collection/components/mds-file-preview/AGENTS.md +1 -1
  494. package/dist/collection/components/mds-file-preview/documentation.json +2 -2
  495. package/dist/collection/components/mds-file-preview/mds-file-preview.css +118 -118
  496. package/dist/collection/components/mds-filter/AGENTS.md +1 -1
  497. package/dist/collection/components/mds-filter/documentation.json +2 -2
  498. package/dist/collection/components/mds-filter/mds-filter.css +4 -4
  499. package/dist/collection/components/mds-filter-item/AGENTS.md +1 -1
  500. package/dist/collection/components/mds-filter-item/documentation.json +2 -2
  501. package/dist/collection/components/mds-header/AGENTS.md +1 -1
  502. package/dist/collection/components/mds-header/documentation.json +2 -2
  503. package/dist/collection/components/mds-header-bar/AGENTS.md +1 -1
  504. package/dist/collection/components/mds-header-bar/documentation.json +2 -2
  505. package/dist/collection/components/mds-help/AGENTS.md +1 -1
  506. package/dist/collection/components/mds-help/documentation.json +2 -2
  507. package/dist/collection/components/mds-horizontal-scroll/AGENTS.md +1 -1
  508. package/dist/collection/components/mds-horizontal-scroll/documentation.json +2 -2
  509. package/dist/collection/components/mds-hr/AGENTS.md +1 -1
  510. package/dist/collection/components/mds-hr/documentation.json +2 -2
  511. package/dist/collection/components/mds-icon/AGENTS.md +2 -2
  512. package/dist/collection/components/mds-icon/documentation.json +6 -2
  513. package/dist/collection/components/mds-img/AGENTS.md +6 -4
  514. package/dist/collection/components/mds-img/documentation.json +48 -6
  515. package/dist/collection/components/mds-img/examples.md +15 -1
  516. package/dist/collection/components/mds-img/mds-img.css +6 -6
  517. package/dist/collection/components/mds-img/mds-img.js +37 -6
  518. package/dist/collection/components/mds-img/meta/storybook.js +7 -0
  519. package/dist/collection/components/mds-img/meta/types.js +2 -1
  520. package/dist/collection/components/mds-input/AGENTS.md +1 -1
  521. package/dist/collection/components/mds-input/documentation.json +2 -2
  522. package/dist/collection/components/mds-input/mds-input.css +12 -12
  523. package/dist/collection/components/mds-input-date/AGENTS.md +1 -1
  524. package/dist/collection/components/mds-input-date/documentation.json +2 -2
  525. package/dist/collection/components/mds-input-date/mds-input-date.css +9 -9
  526. package/dist/collection/components/mds-input-date-range/AGENTS.md +1 -1
  527. package/dist/collection/components/mds-input-date-range/documentation.json +2 -2
  528. package/dist/collection/components/mds-input-date-range/mds-input-date-range.css +9 -9
  529. package/dist/collection/components/mds-input-date-range-preselection/AGENTS.md +1 -1
  530. package/dist/collection/components/mds-input-date-range-preselection/documentation.json +2 -2
  531. package/dist/collection/components/mds-input-date-range-preselection/mds-input-date-range-preselection.css +6 -6
  532. package/dist/collection/components/mds-input-field/AGENTS.md +4 -2
  533. package/dist/collection/components/mds-input-field/documentation.json +33 -5
  534. package/dist/collection/components/mds-input-field/examples.md +18 -0
  535. package/dist/collection/components/mds-input-field/mds-input-field.css +39 -2
  536. package/dist/collection/components/mds-input-field/mds-input-field.js +21 -1
  537. package/dist/collection/components/mds-input-field/mistakes.md +21 -0
  538. package/dist/collection/components/mds-input-otp/AGENTS.md +1 -1
  539. package/dist/collection/components/mds-input-otp/documentation.json +2 -2
  540. package/dist/collection/components/mds-input-otp/mds-input-otp.js +1 -1
  541. package/dist/collection/components/mds-input-range/AGENTS.md +1 -1
  542. package/dist/collection/components/mds-input-range/documentation.json +2 -2
  543. package/dist/collection/components/mds-input-range/mds-input-range.css +3 -3
  544. package/dist/collection/components/mds-input-range/mds-input-range.js +2 -2
  545. package/dist/collection/components/mds-input-range-value/AGENTS.md +1 -1
  546. package/dist/collection/components/mds-input-range-value/documentation.json +2 -2
  547. package/dist/collection/components/mds-input-range-value/mds-input-range-value.js +1 -1
  548. package/dist/collection/components/mds-input-select/AGENTS.md +1 -1
  549. package/dist/collection/components/mds-input-select/documentation.json +2 -2
  550. package/dist/collection/components/mds-input-select/mds-input-select.css +7 -7
  551. package/dist/collection/components/mds-input-select/mds-input-select.js +2 -2
  552. package/dist/collection/components/mds-input-switch/AGENTS.md +1 -1
  553. package/dist/collection/components/mds-input-switch/documentation.json +2 -2
  554. package/dist/collection/components/mds-input-switch/mds-input-switch.css +20 -18
  555. package/dist/collection/components/mds-input-switch/mds-input-switch.js +1 -1
  556. package/dist/collection/components/mds-input-tip/AGENTS.md +1 -1
  557. package/dist/collection/components/mds-input-tip/documentation.json +2 -2
  558. package/dist/collection/components/mds-input-tip/mds-input-tip.js +1 -1
  559. package/dist/collection/components/mds-input-tip-item/AGENTS.md +1 -1
  560. package/dist/collection/components/mds-input-tip-item/documentation.json +2 -2
  561. package/dist/collection/components/mds-input-tip-item/mds-input-tip-item.js +2 -2
  562. package/dist/collection/components/mds-input-upload/AGENTS.md +1 -1
  563. package/dist/collection/components/mds-input-upload/documentation.json +2 -2
  564. package/dist/collection/components/mds-input-upload/mds-input-upload.css +1 -1
  565. package/dist/collection/components/mds-input-upload/mds-input-upload.js +5 -5
  566. package/dist/collection/components/mds-keyboard/AGENTS.md +1 -1
  567. package/dist/collection/components/mds-keyboard/documentation.json +2 -2
  568. package/dist/collection/components/mds-keyboard/mds-keyboard.js +1 -1
  569. package/dist/collection/components/mds-keyboard-key/AGENTS.md +1 -1
  570. package/dist/collection/components/mds-keyboard-key/documentation.json +2 -2
  571. package/dist/collection/components/mds-keyboard-key/mds-keyboard-key.js +1 -1
  572. package/dist/collection/components/mds-kpi/AGENTS.md +1 -1
  573. package/dist/collection/components/mds-kpi/documentation.json +2 -2
  574. package/dist/collection/components/mds-kpi/mds-kpi.js +1 -1
  575. package/dist/collection/components/mds-kpi-item/AGENTS.md +1 -1
  576. package/dist/collection/components/mds-kpi-item/documentation.json +2 -2
  577. package/dist/collection/components/mds-kpi-item/mds-kpi-item.css +4 -4
  578. package/dist/collection/components/mds-kpi-item/mds-kpi-item.js +1 -1
  579. package/dist/collection/components/mds-label/AGENTS.md +1 -1
  580. package/dist/collection/components/mds-label/documentation.json +2 -2
  581. package/dist/collection/components/mds-label/mds-label.css +158 -158
  582. package/dist/collection/components/mds-link/AGENTS.md +3 -1
  583. package/dist/collection/components/mds-link/documentation.json +33 -4
  584. package/dist/collection/components/mds-link/examples.md +12 -1
  585. package/dist/collection/components/mds-link/mds-link.css +1 -1
  586. package/dist/collection/components/mds-link/mds-link.js +47 -7
  587. package/dist/collection/components/mds-list/AGENTS.md +1 -1
  588. package/dist/collection/components/mds-list/documentation.json +2 -2
  589. package/dist/collection/components/mds-list/mds-list.js +1 -1
  590. package/dist/collection/components/mds-list-item/AGENTS.md +1 -1
  591. package/dist/collection/components/mds-list-item/documentation.json +2 -2
  592. package/dist/collection/components/mds-list-item/mds-list-item.js +1 -1
  593. package/dist/collection/components/mds-mention/AGENTS.md +1 -1
  594. package/dist/collection/components/mds-mention/documentation.json +2 -2
  595. package/dist/collection/components/mds-mention/mds-mention.js +1 -1
  596. package/dist/collection/components/mds-modal/AGENTS.md +1 -1
  597. package/dist/collection/components/mds-modal/documentation.json +2 -2
  598. package/dist/collection/components/mds-modal/mds-modal.js +2 -2
  599. package/dist/collection/components/mds-note/AGENTS.md +1 -1
  600. package/dist/collection/components/mds-note/documentation.json +2 -2
  601. package/dist/collection/components/mds-note/mds-note.css +136 -136
  602. package/dist/collection/components/mds-note/mds-note.js +1 -1
  603. package/dist/collection/components/mds-notification/AGENTS.md +1 -1
  604. package/dist/collection/components/mds-notification/documentation.json +2 -2
  605. package/dist/collection/components/mds-notification/mds-notification.js +1 -1
  606. package/dist/collection/components/mds-paginator/AGENTS.md +1 -1
  607. package/dist/collection/components/mds-paginator/documentation.json +2 -2
  608. package/dist/collection/components/mds-paginator/mds-paginator.js +1 -1
  609. package/dist/collection/components/mds-paginator-item/AGENTS.md +1 -1
  610. package/dist/collection/components/mds-paginator-item/documentation.json +2 -2
  611. package/dist/collection/components/mds-paginator-item/mds-paginator-item.css +1 -1
  612. package/dist/collection/components/mds-paginator-item/mds-paginator-item.js +1 -1
  613. package/dist/collection/components/mds-policy-ai/AGENTS.md +1 -1
  614. package/dist/collection/components/mds-policy-ai/documentation.json +2 -2
  615. package/dist/collection/components/mds-policy-ai/mds-policy-ai.css +6 -6
  616. package/dist/collection/components/mds-policy-ai/mds-policy-ai.js +1 -1
  617. package/dist/collection/components/mds-pref/AGENTS.md +1 -1
  618. package/dist/collection/components/mds-pref/documentation.json +2 -2
  619. package/dist/collection/components/mds-pref/mds-pref.js +1 -1
  620. package/dist/collection/components/mds-pref-animation/AGENTS.md +1 -1
  621. package/dist/collection/components/mds-pref-animation/documentation.json +2 -2
  622. package/dist/collection/components/mds-pref-animation/mds-pref-animation.js +1 -1
  623. package/dist/collection/components/mds-pref-consumption/AGENTS.md +1 -1
  624. package/dist/collection/components/mds-pref-consumption/documentation.json +2 -2
  625. package/dist/collection/components/mds-pref-consumption/mds-pref-consumption.js +1 -1
  626. package/dist/collection/components/mds-pref-contrast/AGENTS.md +1 -1
  627. package/dist/collection/components/mds-pref-contrast/documentation.json +2 -2
  628. package/dist/collection/components/mds-pref-contrast/mds-pref-contrast.js +1 -1
  629. package/dist/collection/components/mds-pref-language/AGENTS.md +1 -1
  630. package/dist/collection/components/mds-pref-language/documentation.json +2 -2
  631. package/dist/collection/components/mds-pref-language/mds-pref-language.js +1 -1
  632. package/dist/collection/components/mds-pref-language-item/AGENTS.md +1 -1
  633. package/dist/collection/components/mds-pref-language-item/documentation.json +2 -2
  634. package/dist/collection/components/mds-pref-language-item/mds-pref-language-item.js +1 -1
  635. package/dist/collection/components/mds-pref-mode/AGENTS.md +1 -1
  636. package/dist/collection/components/mds-pref-mode/documentation.json +2 -2
  637. package/dist/collection/components/mds-pref-mode/mds-pref-mode.css +6 -6
  638. package/dist/collection/components/mds-pref-mode/mds-pref-mode.js +1 -1
  639. package/dist/collection/components/mds-pref-theme/AGENTS.md +1 -1
  640. package/dist/collection/components/mds-pref-theme/documentation.json +2 -2
  641. package/dist/collection/components/mds-pref-theme/mds-pref-theme.js +1 -1
  642. package/dist/collection/components/mds-pref-theme-item/AGENTS.md +1 -1
  643. package/dist/collection/components/mds-pref-theme-item/documentation.json +2 -2
  644. package/dist/collection/components/mds-pref-theme-item/mds-pref-theme-item.css +2 -2
  645. package/dist/collection/components/mds-pref-theme-item/mds-pref-theme-item.js +1 -1
  646. package/dist/collection/components/mds-price-table/AGENTS.md +1 -1
  647. package/dist/collection/components/mds-price-table/documentation.json +2 -2
  648. package/dist/collection/components/mds-price-table/mds-price-table.js +1 -1
  649. package/dist/collection/components/mds-price-table-features/AGENTS.md +1 -1
  650. package/dist/collection/components/mds-price-table-features/documentation.json +2 -2
  651. package/dist/collection/components/mds-price-table-features/mds-price-table-features.css +1 -1
  652. package/dist/collection/components/mds-price-table-features/mds-price-table-features.js +1 -1
  653. package/dist/collection/components/mds-price-table-features-cell/AGENTS.md +1 -1
  654. package/dist/collection/components/mds-price-table-features-cell/documentation.json +2 -2
  655. package/dist/collection/components/mds-price-table-features-cell/mds-price-table-features-cell.css +10 -10
  656. package/dist/collection/components/mds-price-table-features-cell/mds-price-table-features-cell.js +1 -1
  657. package/dist/collection/components/mds-price-table-features-row/AGENTS.md +1 -1
  658. package/dist/collection/components/mds-price-table-features-row/documentation.json +2 -2
  659. package/dist/collection/components/mds-price-table-features-row/mds-price-table-features-row.js +1 -1
  660. package/dist/collection/components/mds-price-table-header/AGENTS.md +1 -1
  661. package/dist/collection/components/mds-price-table-header/documentation.json +2 -2
  662. package/dist/collection/components/mds-price-table-header/mds-price-table-header.js +1 -1
  663. package/dist/collection/components/mds-price-table-list/AGENTS.md +1 -1
  664. package/dist/collection/components/mds-price-table-list/documentation.json +2 -2
  665. package/dist/collection/components/mds-price-table-list/mds-price-table-list.css +3 -3
  666. package/dist/collection/components/mds-price-table-list/mds-price-table-list.js +1 -1
  667. package/dist/collection/components/mds-price-table-list-item/AGENTS.md +1 -1
  668. package/dist/collection/components/mds-price-table-list-item/documentation.json +2 -2
  669. package/dist/collection/components/mds-price-table-list-item/mds-price-table-list-item.js +1 -1
  670. package/dist/collection/components/mds-progress/AGENTS.md +1 -1
  671. package/dist/collection/components/mds-progress/documentation.json +2 -2
  672. package/dist/collection/components/mds-progress/mds-progress.css +13 -13
  673. package/dist/collection/components/mds-progress/mds-progress.js +1 -1
  674. package/dist/collection/components/mds-push-notification/AGENTS.md +1 -1
  675. package/dist/collection/components/mds-push-notification/documentation.json +2 -2
  676. package/dist/collection/components/mds-push-notification/mds-push-notification.css +2 -2
  677. package/dist/collection/components/mds-push-notification/mds-push-notification.js +1 -1
  678. package/dist/collection/components/mds-push-notification-item/AGENTS.md +1 -1
  679. package/dist/collection/components/mds-push-notification-item/documentation.json +2 -2
  680. package/dist/collection/components/mds-push-notification-item/mds-push-notification-item.css +38 -38
  681. package/dist/collection/components/mds-push-notification-item/mds-push-notification-item.js +2 -2
  682. package/dist/collection/components/mds-quote/AGENTS.md +1 -1
  683. package/dist/collection/components/mds-quote/documentation.json +2 -2
  684. package/dist/collection/components/mds-quote/mds-quote.js +1 -1
  685. package/dist/collection/components/mds-radial-menu/AGENTS.md +1 -1
  686. package/dist/collection/components/mds-radial-menu/documentation.json +2 -2
  687. package/dist/collection/components/mds-radial-menu/mds-radial-menu.js +1 -1
  688. package/dist/collection/components/mds-radial-menu-item/AGENTS.md +1 -1
  689. package/dist/collection/components/mds-radial-menu-item/documentation.json +2 -2
  690. package/dist/collection/components/mds-radial-menu-item/mds-radial-menu-item.js +1 -1
  691. package/dist/collection/components/mds-radial-progress/AGENTS.md +1 -1
  692. package/dist/collection/components/mds-radial-progress/documentation.json +2 -2
  693. package/dist/collection/components/mds-radial-progress/mds-radial-progress.css +5 -5
  694. package/dist/collection/components/mds-radial-progress/mds-radial-progress.js +1 -1
  695. package/dist/collection/components/mds-separator/AGENTS.md +1 -1
  696. package/dist/collection/components/mds-separator/documentation.json +2 -2
  697. package/dist/collection/components/mds-separator/mds-separator.css +2 -2
  698. package/dist/collection/components/mds-separator/mds-separator.js +1 -1
  699. package/dist/collection/components/mds-spinner/AGENTS.md +1 -1
  700. package/dist/collection/components/mds-spinner/documentation.json +2 -2
  701. package/dist/collection/components/mds-spinner/mds-spinner.css +1 -1
  702. package/dist/collection/components/mds-spinner/mds-spinner.js +1 -1
  703. package/dist/collection/components/mds-status-bar/AGENTS.md +1 -1
  704. package/dist/collection/components/mds-status-bar/documentation.json +2 -2
  705. package/dist/collection/components/mds-status-bar/mds-status-bar.js +1 -1
  706. package/dist/collection/components/mds-stepper-bar/AGENTS.md +2 -2
  707. package/dist/collection/components/mds-stepper-bar/documentation.json +3 -3
  708. package/dist/collection/components/mds-stepper-bar/mds-stepper-bar.js +8 -6
  709. package/dist/collection/components/mds-stepper-bar-item/AGENTS.md +6 -4
  710. package/dist/collection/components/mds-stepper-bar-item/documentation.json +30 -4
  711. package/dist/collection/components/mds-stepper-bar-item/mds-stepper-bar-item.css +2 -2
  712. package/dist/collection/components/mds-stepper-bar-item/mds-stepper-bar-item.js +31 -2
  713. package/dist/collection/components/mds-tab/AGENTS.md +1 -1
  714. package/dist/collection/components/mds-tab/documentation.json +2 -2
  715. package/dist/collection/components/mds-tab/mds-tab.js +2 -2
  716. package/dist/collection/components/mds-tab-bar/AGENTS.md +1 -1
  717. package/dist/collection/components/mds-tab-bar/documentation.json +2 -2
  718. package/dist/collection/components/mds-tab-bar/mds-tab-bar.js +1 -1
  719. package/dist/collection/components/mds-tab-bar-item/AGENTS.md +1 -1
  720. package/dist/collection/components/mds-tab-bar-item/documentation.json +2 -2
  721. package/dist/collection/components/mds-tab-bar-item/mds-tab-bar-item.css +3 -3
  722. package/dist/collection/components/mds-tab-bar-item/mds-tab-bar-item.js +1 -1
  723. package/dist/collection/components/mds-tab-item/AGENTS.md +1 -1
  724. package/dist/collection/components/mds-tab-item/documentation.json +2 -2
  725. package/dist/collection/components/mds-tab-item/mds-tab-item.js +1 -1
  726. package/dist/collection/components/mds-table/AGENTS.md +1 -1
  727. package/dist/collection/components/mds-table/documentation.json +2 -2
  728. package/dist/collection/components/mds-table/mds-table.css +7 -7
  729. package/dist/collection/components/mds-table/mds-table.js +1 -1
  730. package/dist/collection/components/mds-table-body/AGENTS.md +1 -1
  731. package/dist/collection/components/mds-table-body/documentation.json +2 -2
  732. package/dist/collection/components/mds-table-body/mds-table-body.js +1 -1
  733. package/dist/collection/components/mds-table-cell/AGENTS.md +1 -1
  734. package/dist/collection/components/mds-table-cell/documentation.json +2 -2
  735. package/dist/collection/components/mds-table-cell/mds-table-cell.js +1 -1
  736. package/dist/collection/components/mds-table-footer/AGENTS.md +1 -1
  737. package/dist/collection/components/mds-table-footer/documentation.json +2 -2
  738. package/dist/collection/components/mds-table-footer/mds-table-footer.js +1 -1
  739. package/dist/collection/components/mds-table-header/AGENTS.md +1 -1
  740. package/dist/collection/components/mds-table-header/documentation.json +2 -2
  741. package/dist/collection/components/mds-table-header/mds-table-header.js +1 -1
  742. package/dist/collection/components/mds-table-header-cell/AGENTS.md +1 -1
  743. package/dist/collection/components/mds-table-header-cell/documentation.json +2 -2
  744. package/dist/collection/components/mds-table-header-cell/mds-table-header-cell.js +1 -1
  745. package/dist/collection/components/mds-table-row/AGENTS.md +1 -1
  746. package/dist/collection/components/mds-table-row/documentation.json +2 -2
  747. package/dist/collection/components/mds-table-row/mds-table-row.js +2 -2
  748. package/dist/collection/components/mds-text/AGENTS.md +1 -1
  749. package/dist/collection/components/mds-text/documentation.json +2 -2
  750. package/dist/collection/components/mds-text/mds-text.css +5 -5
  751. package/dist/collection/components/mds-text/mds-text.js +1 -1
  752. package/dist/collection/components/mds-toast/AGENTS.md +1 -1
  753. package/dist/collection/components/mds-toast/documentation.json +2 -2
  754. package/dist/collection/components/mds-toast/mds-toast.js +1 -1
  755. package/dist/collection/components/mds-toast-region/AGENTS.md +1 -1
  756. package/dist/collection/components/mds-toast-region/documentation.json +2 -2
  757. package/dist/collection/components/mds-toast-region/mds-toast-region.js +1 -1
  758. package/dist/collection/components/mds-tooltip/AGENTS.md +2 -2
  759. package/dist/collection/components/mds-tooltip/documentation.json +4 -4
  760. package/dist/collection/components/mds-tooltip/examples.md +1 -1
  761. package/dist/collection/components/mds-tooltip/mds-tooltip.js +13 -6
  762. package/dist/collection/components/mds-tree/AGENTS.md +1 -1
  763. package/dist/collection/components/mds-tree/documentation.json +2 -2
  764. package/dist/collection/components/mds-tree/mds-tree.css +6 -6
  765. package/dist/collection/components/mds-tree/mds-tree.js +1 -1
  766. package/dist/collection/components/mds-tree-item/AGENTS.md +1 -1
  767. package/dist/collection/components/mds-tree-item/documentation.json +2 -2
  768. package/dist/collection/components/mds-tree-item/mds-tree-item.js +1 -1
  769. package/dist/collection/components/mds-url-view/AGENTS.md +1 -1
  770. package/dist/collection/components/mds-url-view/documentation.json +2 -2
  771. package/dist/collection/components/mds-url-view/mds-url-view.js +1 -1
  772. package/dist/collection/components/mds-usage/AGENTS.md +1 -1
  773. package/dist/collection/components/mds-usage/documentation.json +2 -2
  774. package/dist/collection/components/mds-usage/mds-usage.js +1 -1
  775. package/dist/collection/components/mds-video-wall/AGENTS.md +1 -1
  776. package/dist/collection/components/mds-video-wall/documentation.json +2 -2
  777. package/dist/collection/components/mds-video-wall/mds-video-wall.css +2 -2
  778. package/dist/collection/components/mds-video-wall/mds-video-wall.js +1 -1
  779. package/dist/collection/components/mds-zero/AGENTS.md +1 -1
  780. package/dist/collection/components/mds-zero/documentation.json +2 -2
  781. package/dist/collection/components/mds-zero/mds-zero.css +1 -1
  782. package/dist/collection/components/mds-zero/mds-zero.js +1 -1
  783. package/dist/collection/fixtures/states.js +35 -0
  784. package/dist/components/index.js +1 -1
  785. package/dist/components/mds-accordion-item.js +1 -1
  786. package/dist/components/mds-accordion-timer-item.js +1 -1
  787. package/dist/components/mds-accordion-timer.js +1 -1
  788. package/dist/components/mds-accordion.js +1 -1
  789. package/dist/components/mds-author.js +1 -1
  790. package/dist/components/mds-avatar-stack-item.js +1 -1
  791. package/dist/components/mds-avatar-stack.js +1 -1
  792. package/dist/components/mds-avatar.js +1 -1
  793. package/dist/components/mds-badge.js +1 -1
  794. package/dist/components/mds-banner.js +1 -1
  795. package/dist/components/mds-benchmark-bar.js +1 -1
  796. package/dist/components/mds-bibliography.js +1 -1
  797. package/dist/components/mds-book.js +1 -1
  798. package/dist/components/mds-breadcrumb-item.js +1 -1
  799. package/dist/components/mds-breadcrumb.js +1 -1
  800. package/dist/components/mds-button-dropdown.js +1 -1
  801. package/dist/components/mds-button-group.js +1 -1
  802. package/dist/components/mds-button.js +1 -1
  803. package/dist/components/mds-calendar-cell.js +1 -1
  804. package/dist/components/mds-calendar.js +1 -1
  805. package/dist/components/mds-card-content.js +1 -1
  806. package/dist/components/mds-card-footer.js +1 -1
  807. package/dist/components/mds-card-header.js +1 -1
  808. package/dist/components/mds-card-media.js +1 -1
  809. package/dist/components/mds-card.js +1 -1
  810. package/dist/components/mds-chip.js +1 -1
  811. package/dist/components/mds-details.js +1 -1
  812. package/dist/components/mds-dropdown.js +1 -1
  813. package/dist/components/mds-emoji.js +3 -3
  814. package/dist/components/mds-entity.js +1 -1
  815. package/dist/components/mds-file-preview.js +1 -1
  816. package/dist/components/mds-file.js +1 -1
  817. package/dist/components/mds-filter-item.js +1 -1
  818. package/dist/components/mds-filter.js +1 -1
  819. package/dist/components/mds-header-bar.js +1 -1
  820. package/dist/components/mds-header.js +1 -1
  821. package/dist/components/mds-help.js +1 -1
  822. package/dist/components/mds-horizontal-scroll.js +1 -1
  823. package/dist/components/mds-hr.js +1 -1
  824. package/dist/components/mds-icon.js +1 -1
  825. package/dist/components/mds-img.js +1 -1
  826. package/dist/components/mds-input-date-range-preselection.js +1 -1
  827. package/dist/components/mds-input-date-range.js +1 -1
  828. package/dist/components/mds-input-date.js +1 -1
  829. package/dist/components/mds-input-field.js +1 -1
  830. package/dist/components/mds-input-otp.js +1 -1
  831. package/dist/components/mds-input-range-value.js +1 -1
  832. package/dist/components/mds-input-range.js +1 -1
  833. package/dist/components/mds-input-select.js +1 -1
  834. package/dist/components/mds-input-switch.js +1 -1
  835. package/dist/components/mds-input-tip-item.js +1 -1
  836. package/dist/components/mds-input-tip.js +1 -1
  837. package/dist/components/mds-input-upload.js +1 -1
  838. package/dist/components/mds-input.js +1 -1
  839. package/dist/components/mds-keyboard-key.js +1 -1
  840. package/dist/components/mds-keyboard.js +1 -1
  841. package/dist/components/mds-kpi-item.js +1 -1
  842. package/dist/components/mds-kpi.js +1 -1
  843. package/dist/components/mds-label.js +1 -1
  844. package/dist/components/mds-link.js +1 -1
  845. package/dist/components/mds-list-item.js +1 -1
  846. package/dist/components/mds-list.js +1 -1
  847. package/dist/components/mds-mention.js +1 -1
  848. package/dist/components/mds-modal.js +1 -1
  849. package/dist/components/mds-note.js +1 -1
  850. package/dist/components/mds-notification.js +1 -1
  851. package/dist/components/mds-paginator-item.js +1 -1
  852. package/dist/components/mds-paginator.js +1 -1
  853. package/dist/components/mds-policy-ai.js +1 -1
  854. package/dist/components/mds-pref-animation.js +1 -1
  855. package/dist/components/mds-pref-consumption.js +1 -1
  856. package/dist/components/mds-pref-contrast.js +1 -1
  857. package/dist/components/mds-pref-language-item.js +1 -1
  858. package/dist/components/mds-pref-language.js +1 -1
  859. package/dist/components/mds-pref-mode.js +1 -1
  860. package/dist/components/mds-pref-theme-item.js +1 -1
  861. package/dist/components/mds-pref-theme.js +1 -1
  862. package/dist/components/mds-pref.js +1 -1
  863. package/dist/components/mds-price-table-features-cell.js +1 -1
  864. package/dist/components/mds-price-table-features-row.js +1 -1
  865. package/dist/components/mds-price-table-features.js +1 -1
  866. package/dist/components/mds-price-table-header.js +1 -1
  867. package/dist/components/mds-price-table-list-item.js +1 -1
  868. package/dist/components/mds-price-table-list.js +1 -1
  869. package/dist/components/mds-price-table.js +1 -1
  870. package/dist/components/mds-progress.js +1 -1
  871. package/dist/components/mds-push-notification-item.js +1 -1
  872. package/dist/components/mds-push-notification.js +1 -1
  873. package/dist/components/mds-quote.js +1 -1
  874. package/dist/components/mds-radial-menu-item.js +1 -1
  875. package/dist/components/mds-radial-menu.js +1 -1
  876. package/dist/components/mds-radial-progress.js +1 -1
  877. package/dist/components/mds-separator.js +1 -1
  878. package/dist/components/mds-spinner.js +1 -1
  879. package/dist/components/mds-status-bar.js +1 -1
  880. package/dist/components/mds-stepper-bar-item.js +1 -1
  881. package/dist/components/mds-stepper-bar.js +1 -1
  882. package/dist/components/mds-tab-bar-item.js +1 -1
  883. package/dist/components/mds-tab-bar.js +1 -1
  884. package/dist/components/mds-tab-item.js +1 -1
  885. package/dist/components/mds-tab.js +1 -1
  886. package/dist/components/mds-table-body.js +1 -1
  887. package/dist/components/mds-table-cell.js +1 -1
  888. package/dist/components/mds-table-footer.js +1 -1
  889. package/dist/components/mds-table-header-cell.js +1 -1
  890. package/dist/components/mds-table-header.js +1 -1
  891. package/dist/components/mds-table-row.js +1 -1
  892. package/dist/components/mds-table.js +1 -1
  893. package/dist/components/mds-text.js +1 -1
  894. package/dist/components/mds-toast-region.js +1 -1
  895. package/dist/components/mds-toast.js +1 -1
  896. package/dist/components/mds-tooltip.js +1 -1
  897. package/dist/components/mds-tree-item.js +1 -1
  898. package/dist/components/mds-tree.js +1 -1
  899. package/dist/components/mds-url-view.js +1 -1
  900. package/dist/components/mds-usage.js +1 -1
  901. package/dist/components/mds-video-wall.js +1 -1
  902. package/dist/components/mds-zero.js +1 -1
  903. package/dist/{magma-components/p-kW8cjKIa.js → components/p-2RxibNiL.js} +1 -1
  904. package/dist/components/p-8D5tJYCb.js +1 -0
  905. package/dist/components/p-B0YEia-F.js +1 -0
  906. package/dist/components/{p-BmlDGlcB.js → p-B3t-yAT6.js} +2 -2
  907. package/dist/components/p-B410qrmd.js +1 -0
  908. package/dist/components/{p-G8GFHw3L.js → p-B7AEyQbN.js} +1 -1
  909. package/dist/components/{p-CSw6DbKp.js → p-B8rSg0wS.js} +1 -1
  910. package/dist/components/{p-DxNrlomi.js → p-BNDlJl3j.js} +1 -1
  911. package/dist/components/p-BPnc1LgR.js +1 -0
  912. package/dist/components/{p-AWCYh8Xe.js → p-BQJgPeCf.js} +1 -1
  913. package/dist/components/p-BWCuKjFs.js +1 -0
  914. package/dist/components/{p-BFZN4zJ9.js → p-BZ0wEKOS.js} +1 -1
  915. package/dist/components/p-BgdT5eTT.js +1 -0
  916. package/dist/components/p-Bi6fFi_w.js +1 -0
  917. package/dist/components/{p-CUT9aFzz.js → p-BiOKp8qm.js} +1 -1
  918. package/dist/components/p-BpgvTr8e.js +8 -0
  919. package/dist/components/{p-BG1fjwnd.js → p-BvJpPiuN.js} +1 -1
  920. package/dist/components/{p-D7C-gjL6.js → p-BwGJqBgv.js} +1 -1
  921. package/dist/components/p-C2bmqdQ1.js +1 -0
  922. package/dist/components/p-CSEkugVv.js +1 -0
  923. package/dist/components/{p-BNl6YWNN.js → p-CbHtKU6H.js} +1 -1
  924. package/dist/components/{p-oHBGZ2Av.js → p-CbyfhFKK.js} +1 -1
  925. package/dist/components/p-ChCkQpXr.js +3 -0
  926. package/dist/components/{p-BiJ4xa4V.js → p-CkFk04x6.js} +1 -1
  927. package/dist/components/{p-WFNxKo1V.js → p-Cu7JR-NZ.js} +1 -1
  928. package/dist/components/{p-Cjy1i94z.js → p-DP8t5EZu.js} +1 -1
  929. package/dist/components/{p-B-GgEAg7.js → p-DWvmuGIQ.js} +1 -1
  930. package/dist/components/p-DXksxnFe.js +1 -0
  931. package/dist/components/{p-C0m6B_kt.js → p-DnyQyLeI.js} +1 -1
  932. package/dist/components/{p-DvccsLwr.js → p-DumA_mZd.js} +1 -1
  933. package/dist/components/p-Pwyk_BKp.js +1 -0
  934. package/dist/components/{p-Cs8RIbsQ.js → p-Y1ObmZyL.js} +1 -1
  935. package/dist/components/{p-CDcB9Zdz.js → p-cIfE1RIC.js} +1 -1
  936. package/dist/components/p-hOV1Raf4.js +1 -0
  937. package/dist/components/{p-kS9VRIWa.js → p-r1P_e7WG.js} +1 -1
  938. package/dist/components/{p-aZlZ1XB9.js → p-tI3q9MMi.js} +1 -1
  939. package/dist/documentation.json +211 -22
  940. package/dist/esm/{floating-controller-DlFrvBTG.js → floating-controller-ECQfm808.js} +1 -1
  941. package/dist/esm/{index-CPibDZjX.js → index-BQhu9Pch.js} +16 -6
  942. package/dist/esm/{index-DWniH_Ge.js → index-CiyNF8so.js} +1 -1
  943. package/dist/esm/index.js +2 -2
  944. package/dist/esm/loader.js +3 -3
  945. package/dist/esm/{locale-B7Hw4niB.js → locale-Cm8DHVsu.js} +10 -2
  946. package/dist/esm/magma-components.js +4 -4
  947. package/dist/esm/mds-accordion-item.entry.js +3 -3
  948. package/dist/esm/mds-accordion-timer-item.entry.js +2 -2
  949. package/dist/esm/mds-accordion-timer.entry.js +1 -1
  950. package/dist/esm/mds-accordion.entry.js +3 -3
  951. package/dist/esm/mds-author.entry.js +1 -1
  952. package/dist/esm/mds-avatar-stack-item.entry.js +1 -1
  953. package/dist/esm/mds-avatar-stack.entry.js +1 -1
  954. package/dist/esm/mds-avatar.entry.js +3 -3
  955. package/dist/esm/mds-badge.entry.js +3 -3
  956. package/dist/esm/mds-banner_3.entry.js +5 -5
  957. package/dist/esm/mds-benchmark-bar.entry.js +1 -1
  958. package/dist/esm/mds-bibliography.entry.js +1 -1
  959. package/dist/esm/mds-book.entry.js +8 -8
  960. package/dist/esm/mds-breadcrumb-item.entry.js +1 -1
  961. package/dist/esm/mds-breadcrumb.entry.js +3 -3
  962. package/dist/esm/mds-button-dropdown.entry.js +27 -9
  963. package/dist/esm/mds-button-group.entry.js +1 -1
  964. package/dist/esm/mds-button_3.entry.js +34 -13
  965. package/dist/esm/mds-calendar_2.entry.js +4 -4
  966. package/dist/esm/mds-card-content.entry.js +1 -1
  967. package/dist/esm/mds-card-footer.entry.js +1 -1
  968. package/dist/esm/mds-card-header.entry.js +1 -1
  969. package/dist/esm/mds-card-media.entry.js +1 -1
  970. package/dist/esm/mds-card.entry.js +2 -2
  971. package/dist/esm/mds-details.entry.js +3 -3
  972. package/dist/esm/mds-dropdown.entry.js +3 -3
  973. package/dist/esm/mds-emoji.entry.js +3 -3
  974. package/dist/esm/mds-entity.entry.js +3 -3
  975. package/dist/esm/mds-file-preview.entry.js +4 -4
  976. package/dist/esm/mds-file.entry.js +4 -4
  977. package/dist/esm/mds-filter-item.entry.js +3 -3
  978. package/dist/esm/mds-filter.entry.js +4 -4
  979. package/dist/esm/mds-header-bar.entry.js +3 -3
  980. package/dist/esm/mds-header.entry.js +2 -2
  981. package/dist/esm/mds-horizontal-scroll.entry.js +3 -3
  982. package/dist/esm/mds-hr.entry.js +2 -2
  983. package/dist/esm/mds-img.entry.js +13 -8
  984. package/dist/esm/mds-input-date-range-preselection.entry.js +2 -2
  985. package/dist/esm/mds-input-date-range.entry.js +8 -8
  986. package/dist/esm/mds-input-date.entry.js +5 -5
  987. package/dist/esm/mds-input-field.entry.js +4 -3
  988. package/dist/esm/mds-input-otp.entry.js +4 -4
  989. package/dist/esm/mds-input-range-value.entry.js +2 -2
  990. package/dist/esm/mds-input-range.entry.js +6 -6
  991. package/dist/esm/mds-input-select.entry.js +7 -7
  992. package/dist/esm/mds-input-switch_2.entry.js +6 -6
  993. package/dist/esm/mds-input-tip_2.entry.js +6 -6
  994. package/dist/esm/mds-input-upload.entry.js +9 -9
  995. package/dist/esm/mds-input.entry.js +9 -9
  996. package/dist/esm/mds-keyboard-key.entry.js +4 -4
  997. package/dist/esm/mds-keyboard.entry.js +4 -4
  998. package/dist/esm/mds-kpi-item.entry.js +4 -4
  999. package/dist/esm/mds-kpi.entry.js +2 -2
  1000. package/dist/esm/mds-label.entry.js +4 -4
  1001. package/dist/esm/mds-link.entry.js +32 -11
  1002. package/dist/esm/mds-list-item.entry.js +2 -2
  1003. package/dist/esm/mds-list.entry.js +2 -2
  1004. package/dist/esm/mds-mention.entry.js +4 -4
  1005. package/dist/esm/mds-modal.entry.js +5 -5
  1006. package/dist/esm/mds-note.entry.js +5 -5
  1007. package/dist/esm/mds-notification.entry.js +3 -3
  1008. package/dist/esm/mds-paginator-item.entry.js +4 -4
  1009. package/dist/esm/mds-paginator.entry.js +4 -4
  1010. package/dist/esm/mds-policy-ai.entry.js +5 -5
  1011. package/dist/esm/mds-pref-animation.entry.js +4 -4
  1012. package/dist/esm/mds-pref-consumption.entry.js +4 -4
  1013. package/dist/esm/mds-pref-contrast.entry.js +4 -4
  1014. package/dist/esm/mds-pref-language-item.entry.js +4 -4
  1015. package/dist/esm/mds-pref-language.entry.js +4 -4
  1016. package/dist/esm/mds-pref-mode.entry.js +5 -5
  1017. package/dist/esm/mds-pref-theme-item.entry.js +3 -3
  1018. package/dist/esm/mds-pref-theme.entry.js +4 -4
  1019. package/dist/esm/mds-pref.entry.js +4 -4
  1020. package/dist/esm/mds-price-table-features-cell.entry.js +4 -4
  1021. package/dist/esm/mds-price-table-features-row.entry.js +3 -3
  1022. package/dist/esm/mds-price-table-features.entry.js +4 -4
  1023. package/dist/esm/mds-price-table-header.entry.js +2 -2
  1024. package/dist/esm/mds-price-table-list-item.entry.js +2 -2
  1025. package/dist/esm/mds-price-table-list.entry.js +4 -4
  1026. package/dist/esm/mds-price-table.entry.js +2 -2
  1027. package/dist/esm/mds-progress_2.entry.js +6 -6
  1028. package/dist/esm/mds-push-notification-item.entry.js +6 -6
  1029. package/dist/esm/mds-push-notification.entry.js +5 -5
  1030. package/dist/esm/mds-quote.entry.js +3 -3
  1031. package/dist/esm/mds-radial-menu-item.entry.js +2 -2
  1032. package/dist/esm/mds-radial-menu.entry.js +5 -5
  1033. package/dist/esm/mds-separator.entry.js +4 -4
  1034. package/dist/esm/mds-status-bar.entry.js +3 -3
  1035. package/dist/esm/mds-stepper-bar-item.entry.js +17 -7
  1036. package/dist/esm/mds-stepper-bar.entry.js +9 -7
  1037. package/dist/esm/mds-tab-bar-item.entry.js +4 -4
  1038. package/dist/esm/mds-tab-bar.entry.js +3 -3
  1039. package/dist/esm/mds-tab_2.entry.js +5 -5
  1040. package/dist/esm/mds-table-body.entry.js +3 -3
  1041. package/dist/esm/mds-table-footer.entry.js +3 -3
  1042. package/dist/esm/mds-table-header-cell.entry.js +3 -3
  1043. package/dist/esm/mds-table-header.entry.js +4 -4
  1044. package/dist/esm/mds-table-row.entry.js +5 -5
  1045. package/dist/esm/mds-table.entry.js +5 -5
  1046. package/dist/esm/mds-text.entry.js +4 -4
  1047. package/dist/esm/mds-toast-region.entry.js +2 -2
  1048. package/dist/esm/mds-toast.entry.js +4 -4
  1049. package/dist/esm/mds-tooltip.entry.js +16 -9
  1050. package/dist/esm/mds-tree-item.entry.js +4 -4
  1051. package/dist/esm/mds-tree.entry.js +3 -3
  1052. package/dist/esm/mds-url-view.entry.js +4 -4
  1053. package/dist/esm/mds-usage.entry.js +4 -4
  1054. package/dist/esm/mds-video-wall.entry.js +4 -4
  1055. package/dist/esm/mds-zero.entry.js +4 -4
  1056. package/dist/esm/{navigation-To9IeLHs.js → navigation-Pwyk_BKp.js} +14 -1
  1057. package/dist/esm/{preference-CBMLGSf7.js → preference-B_NbXZNw.js} +1 -1
  1058. package/dist/esm-es5/{floating-controller-DlFrvBTG.js → floating-controller-ECQfm808.js} +1 -1
  1059. package/dist/esm-es5/{index-CPibDZjX.js → index-BQhu9Pch.js} +3 -3
  1060. package/dist/esm-es5/{index-DWniH_Ge.js → index-CiyNF8so.js} +1 -1
  1061. package/dist/esm-es5/index.js +1 -1
  1062. package/dist/esm-es5/loader.js +1 -1
  1063. package/dist/esm-es5/{locale-B7Hw4niB.js → locale-Cm8DHVsu.js} +28 -21
  1064. package/dist/esm-es5/magma-components.js +3 -3
  1065. package/dist/esm-es5/mds-accordion-item.entry.js +1 -1
  1066. package/dist/esm-es5/mds-accordion-timer-item.entry.js +1 -1
  1067. package/dist/esm-es5/mds-accordion-timer.entry.js +1 -1
  1068. package/dist/esm-es5/mds-accordion.entry.js +1 -1
  1069. package/dist/esm-es5/mds-author.entry.js +1 -1
  1070. package/dist/esm-es5/mds-avatar-stack-item.entry.js +1 -1
  1071. package/dist/esm-es5/mds-avatar-stack.entry.js +1 -1
  1072. package/dist/esm-es5/mds-avatar.entry.js +2 -2
  1073. package/dist/esm-es5/mds-badge.entry.js +1 -1
  1074. package/dist/esm-es5/mds-banner_3.entry.js +3 -3
  1075. package/dist/esm-es5/mds-benchmark-bar.entry.js +1 -1
  1076. package/dist/esm-es5/mds-bibliography.entry.js +1 -1
  1077. package/dist/esm-es5/mds-book.entry.js +2 -2
  1078. package/dist/esm-es5/mds-breadcrumb-item.entry.js +1 -1
  1079. package/dist/esm-es5/mds-breadcrumb.entry.js +1 -1
  1080. package/dist/esm-es5/mds-button-dropdown.entry.js +8 -5
  1081. package/dist/esm-es5/mds-button-group.entry.js +1 -1
  1082. package/dist/esm-es5/mds-button_3.entry.js +19 -9
  1083. package/dist/esm-es5/mds-calendar_2.entry.js +2 -2
  1084. package/dist/esm-es5/mds-card-content.entry.js +1 -1
  1085. package/dist/esm-es5/mds-card-footer.entry.js +1 -1
  1086. package/dist/esm-es5/mds-card-header.entry.js +1 -1
  1087. package/dist/esm-es5/mds-card-media.entry.js +1 -1
  1088. package/dist/esm-es5/mds-card.entry.js +1 -1
  1089. package/dist/esm-es5/mds-details.entry.js +1 -1
  1090. package/dist/esm-es5/mds-dropdown.entry.js +1 -1
  1091. package/dist/esm-es5/mds-emoji.entry.js +2 -2
  1092. package/dist/esm-es5/mds-entity.entry.js +1 -1
  1093. package/dist/esm-es5/mds-file-preview.entry.js +11 -11
  1094. package/dist/esm-es5/mds-file.entry.js +2 -2
  1095. package/dist/esm-es5/mds-filter-item.entry.js +2 -2
  1096. package/dist/esm-es5/mds-filter.entry.js +1 -1
  1097. package/dist/esm-es5/mds-header-bar.entry.js +1 -1
  1098. package/dist/esm-es5/mds-header.entry.js +1 -1
  1099. package/dist/esm-es5/mds-horizontal-scroll.entry.js +1 -1
  1100. package/dist/esm-es5/mds-hr.entry.js +1 -1
  1101. package/dist/esm-es5/mds-img.entry.js +9 -7
  1102. package/dist/esm-es5/mds-input-date-range-preselection.entry.js +1 -1
  1103. package/dist/esm-es5/mds-input-date-range.entry.js +1 -1
  1104. package/dist/esm-es5/mds-input-date.entry.js +1 -1
  1105. package/dist/esm-es5/mds-input-field.entry.js +7 -7
  1106. package/dist/esm-es5/mds-input-otp.entry.js +2 -2
  1107. package/dist/esm-es5/mds-input-range-value.entry.js +1 -1
  1108. package/dist/esm-es5/mds-input-range.entry.js +6 -6
  1109. package/dist/esm-es5/mds-input-select.entry.js +2 -2
  1110. package/dist/esm-es5/mds-input-switch_2.entry.js +2 -2
  1111. package/dist/esm-es5/mds-input-tip_2.entry.js +3 -3
  1112. package/dist/esm-es5/mds-input-upload.entry.js +2 -2
  1113. package/dist/esm-es5/mds-input.entry.js +2 -2
  1114. package/dist/esm-es5/mds-keyboard-key.entry.js +2 -2
  1115. package/dist/esm-es5/mds-keyboard.entry.js +2 -2
  1116. package/dist/esm-es5/mds-kpi-item.entry.js +2 -2
  1117. package/dist/esm-es5/mds-kpi.entry.js +1 -1
  1118. package/dist/esm-es5/mds-label.entry.js +1 -1
  1119. package/dist/esm-es5/mds-link.entry.js +16 -7
  1120. package/dist/esm-es5/mds-list-item.entry.js +2 -2
  1121. package/dist/esm-es5/mds-list.entry.js +1 -1
  1122. package/dist/esm-es5/mds-mention.entry.js +2 -2
  1123. package/dist/esm-es5/mds-modal.entry.js +5 -5
  1124. package/dist/esm-es5/mds-note.entry.js +2 -2
  1125. package/dist/esm-es5/mds-notification.entry.js +2 -2
  1126. package/dist/esm-es5/mds-paginator-item.entry.js +2 -2
  1127. package/dist/esm-es5/mds-paginator.entry.js +3 -3
  1128. package/dist/esm-es5/mds-policy-ai.entry.js +2 -2
  1129. package/dist/esm-es5/mds-pref-animation.entry.js +2 -2
  1130. package/dist/esm-es5/mds-pref-consumption.entry.js +2 -2
  1131. package/dist/esm-es5/mds-pref-contrast.entry.js +4 -4
  1132. package/dist/esm-es5/mds-pref-language-item.entry.js +2 -2
  1133. package/dist/esm-es5/mds-pref-language.entry.js +2 -2
  1134. package/dist/esm-es5/mds-pref-mode.entry.js +2 -2
  1135. package/dist/esm-es5/mds-pref-theme-item.entry.js +2 -2
  1136. package/dist/esm-es5/mds-pref-theme.entry.js +2 -2
  1137. package/dist/esm-es5/mds-pref.entry.js +2 -2
  1138. package/dist/esm-es5/mds-price-table-features-cell.entry.js +2 -2
  1139. package/dist/esm-es5/mds-price-table-features-row.entry.js +1 -1
  1140. package/dist/esm-es5/mds-price-table-features.entry.js +1 -1
  1141. package/dist/esm-es5/mds-price-table-header.entry.js +1 -1
  1142. package/dist/esm-es5/mds-price-table-list-item.entry.js +2 -2
  1143. package/dist/esm-es5/mds-price-table-list.entry.js +2 -2
  1144. package/dist/esm-es5/mds-price-table.entry.js +1 -1
  1145. package/dist/esm-es5/mds-progress_2.entry.js +3 -3
  1146. package/dist/esm-es5/mds-push-notification-item.entry.js +2 -2
  1147. package/dist/esm-es5/mds-push-notification.entry.js +6 -6
  1148. package/dist/esm-es5/mds-quote.entry.js +2 -2
  1149. package/dist/esm-es5/mds-radial-menu-item.entry.js +2 -2
  1150. package/dist/esm-es5/mds-radial-menu.entry.js +2 -2
  1151. package/dist/esm-es5/mds-separator.entry.js +1 -1
  1152. package/dist/esm-es5/mds-status-bar.entry.js +2 -2
  1153. package/dist/esm-es5/mds-stepper-bar-item.entry.js +6 -2
  1154. package/dist/esm-es5/mds-stepper-bar.entry.js +11 -8
  1155. package/dist/esm-es5/mds-tab-bar-item.entry.js +2 -2
  1156. package/dist/esm-es5/mds-tab-bar.entry.js +2 -2
  1157. package/dist/esm-es5/mds-tab_2.entry.js +3 -3
  1158. package/dist/esm-es5/mds-table-body.entry.js +1 -1
  1159. package/dist/esm-es5/mds-table-footer.entry.js +2 -2
  1160. package/dist/esm-es5/mds-table-header-cell.entry.js +2 -2
  1161. package/dist/esm-es5/mds-table-header.entry.js +3 -3
  1162. package/dist/esm-es5/mds-table-row.entry.js +2 -2
  1163. package/dist/esm-es5/mds-table.entry.js +2 -2
  1164. package/dist/esm-es5/mds-text.entry.js +3 -3
  1165. package/dist/esm-es5/mds-toast-region.entry.js +2 -2
  1166. package/dist/esm-es5/mds-toast.entry.js +2 -2
  1167. package/dist/esm-es5/mds-tooltip.entry.js +13 -7
  1168. package/dist/esm-es5/mds-tree-item.entry.js +2 -2
  1169. package/dist/esm-es5/mds-tree.entry.js +2 -2
  1170. package/dist/esm-es5/mds-url-view.entry.js +2 -2
  1171. package/dist/esm-es5/mds-usage.entry.js +2 -2
  1172. package/dist/esm-es5/mds-video-wall.entry.js +2 -2
  1173. package/dist/esm-es5/mds-zero.entry.js +1 -1
  1174. package/dist/esm-es5/{navigation-To9IeLHs.js → navigation-Pwyk_BKp.js} +10 -1
  1175. package/dist/esm-es5/{preference-CBMLGSf7.js → preference-B_NbXZNw.js} +1 -1
  1176. package/dist/hydrate/index.js +308 -186
  1177. package/dist/hydrate/index.mjs +308 -186
  1178. package/dist/lint/core/data.d.ts +9 -1
  1179. package/dist/lint/core/data.js +6 -2
  1180. package/dist/lint/core/patterns.d.ts +123 -2
  1181. package/dist/lint/core/patterns.js +423 -19
  1182. package/dist/lint/mcp/tools.json +1 -1
  1183. package/dist/magma-components/index.esm.js +1 -1
  1184. package/dist/magma-components/magma-components.esm.js +1 -1
  1185. package/dist/magma-components/magma-components.js +1 -1
  1186. package/dist/magma-components/{p-e63c1ba4.entry.js → p-04092a3b.entry.js} +1 -1
  1187. package/dist/magma-components/{p-b1fe6261.entry.js → p-0415056d.entry.js} +1 -1
  1188. package/dist/magma-components/{p-37470fef.system.entry.js → p-0464a230.system.entry.js} +3 -3
  1189. package/dist/magma-components/p-05098fa3.entry.js +1 -0
  1190. package/dist/magma-components/{p-825713bc.system.entry.js → p-07141f37.system.entry.js} +2 -2
  1191. package/dist/magma-components/{p-82041de2.entry.js → p-07e0564b.entry.js} +1 -1
  1192. package/dist/magma-components/{p-df70af5f.system.entry.js → p-07e3a6ae.system.entry.js} +34 -34
  1193. package/dist/magma-components/{p-8193fd71.entry.js → p-096464f6.entry.js} +1 -1
  1194. package/dist/magma-components/p-0b9dc520.system.entry.js +9 -0
  1195. package/dist/magma-components/{p-f6f6d914.system.entry.js → p-0ba59e33.system.entry.js} +3 -3
  1196. package/dist/magma-components/{p-d4452e41.entry.js → p-0d7848dc.entry.js} +1 -1
  1197. package/dist/magma-components/{p-b8e5411d.system.entry.js → p-0e67ab54.system.entry.js} +1 -1
  1198. package/dist/magma-components/{p-f01e7a7e.system.entry.js → p-0ec9ef12.system.entry.js} +1 -1
  1199. package/dist/magma-components/p-0ef36f08.entry.js +1 -0
  1200. package/dist/magma-components/{p-0d7370d8.system.entry.js → p-12785058.system.entry.js} +1 -1
  1201. package/dist/magma-components/{p-58bbada6.system.entry.js → p-13498dce.system.entry.js} +1 -1
  1202. package/dist/magma-components/{p-a0389821.entry.js → p-13a777ff.entry.js} +1 -1
  1203. package/dist/magma-components/{p-2a5223df.system.entry.js → p-165b9ee9.system.entry.js} +3 -3
  1204. package/dist/magma-components/p-16c3109f.entry.js +8 -0
  1205. package/dist/magma-components/{p-038fc1db.entry.js → p-1a0773d4.entry.js} +1 -1
  1206. package/dist/magma-components/{p-483480f9.system.entry.js → p-1ab76b57.system.entry.js} +3 -3
  1207. package/dist/magma-components/{p-e4db9ad2.entry.js → p-1e686eb7.entry.js} +1 -1
  1208. package/dist/magma-components/{p-97e55f7e.system.entry.js → p-1e938a6f.system.entry.js} +2 -2
  1209. package/dist/magma-components/{p-ae258eca.system.entry.js → p-1ee28c75.system.entry.js} +2 -2
  1210. package/dist/magma-components/{p-5c0f0517.entry.js → p-1eedb159.entry.js} +1 -1
  1211. package/dist/magma-components/{p-11312b0c.entry.js → p-1efd5b03.entry.js} +1 -1
  1212. package/dist/magma-components/{p-13e94501.entry.js → p-20e9860a.entry.js} +1 -1
  1213. package/dist/magma-components/{p-2dd32b3f.system.entry.js → p-2102e6ed.system.entry.js} +3 -3
  1214. package/dist/magma-components/p-2155889e.entry.js +1 -0
  1215. package/dist/magma-components/{p-f4e8f507.system.entry.js → p-22de70f3.system.entry.js} +2 -2
  1216. package/dist/magma-components/p-257ae152.entry.js +1 -0
  1217. package/dist/magma-components/{p-5d8cb375.system.entry.js → p-26695384.system.entry.js} +1 -1
  1218. package/dist/magma-components/{p-c902d468.entry.js → p-26e737f5.entry.js} +1 -1
  1219. package/dist/magma-components/{p-d0b45a54.entry.js → p-271fa94b.entry.js} +1 -1
  1220. package/dist/magma-components/{p-1934151b.entry.js → p-27c42c5b.entry.js} +1 -1
  1221. package/dist/magma-components/{p-a171c096.system.entry.js → p-29eab5de.system.entry.js} +1 -1
  1222. package/dist/magma-components/{p-082b787b.entry.js → p-2a367163.entry.js} +1 -1
  1223. package/dist/magma-components/{p-b95f648f.system.entry.js → p-2adc8da6.system.entry.js} +2 -2
  1224. package/dist/magma-components/p-2b0bb30a.entry.js +1 -0
  1225. package/dist/magma-components/{p-3341ac50.entry.js → p-2cb3092c.entry.js} +1 -1
  1226. package/dist/magma-components/{p-ca5867f5.system.entry.js → p-2cd10aef.system.entry.js} +9 -9
  1227. package/dist/magma-components/{p-91406af1.system.entry.js → p-2e1620ba.system.entry.js} +5 -5
  1228. package/dist/magma-components/p-2eab8fb0.entry.js +1 -0
  1229. package/dist/magma-components/{p-e009c632.entry.js → p-31503852.entry.js} +1 -1
  1230. package/dist/magma-components/{p-efcd8a1d.entry.js → p-3401be31.entry.js} +1 -1
  1231. package/dist/magma-components/{p-ccb23b6a.entry.js → p-35261a76.entry.js} +1 -1
  1232. package/dist/magma-components/p-3578ec8d.entry.js +1 -0
  1233. package/dist/magma-components/{p-a4aaf1c6.system.entry.js → p-381b00f2.system.entry.js} +3 -3
  1234. package/dist/magma-components/p-38b33f35.entry.js +1 -0
  1235. package/dist/magma-components/{p-47712df6.entry.js → p-3936265d.entry.js} +1 -1
  1236. package/dist/magma-components/{p-2dc9499c.system.entry.js → p-394560df.system.entry.js} +2 -2
  1237. package/dist/magma-components/{p-d0dfa8b5.system.entry.js → p-39866e42.system.entry.js} +2 -2
  1238. package/dist/magma-components/{p-6c6ec154.system.entry.js → p-3b1cb8ea.system.entry.js} +2 -2
  1239. package/dist/magma-components/{p-dd4b04ed.system.entry.js → p-3d1f9f06.system.entry.js} +2 -2
  1240. package/dist/magma-components/{p-1e43613e.entry.js → p-3f9b9e40.entry.js} +1 -1
  1241. package/dist/magma-components/{p-56715bbc.system.entry.js → p-401c7cff.system.entry.js} +2 -2
  1242. package/dist/magma-components/{p-ad12fa89.system.entry.js → p-40dc42b3.system.entry.js} +2 -2
  1243. package/dist/magma-components/{p-bd539dbc.entry.js → p-41740349.entry.js} +1 -1
  1244. package/dist/magma-components/p-479731de.entry.js +1 -0
  1245. package/dist/magma-components/{p-9c0d1025.system.entry.js → p-4822b172.system.entry.js} +1 -1
  1246. package/dist/magma-components/{p-03896fbd.entry.js → p-48db6553.entry.js} +1 -1
  1247. package/dist/magma-components/{p-ada93f68.entry.js → p-49918013.entry.js} +1 -1
  1248. package/dist/magma-components/p-4b5444f1.entry.js +1 -0
  1249. package/dist/magma-components/{p-420c5af4.entry.js → p-4b7249eb.entry.js} +1 -1
  1250. package/dist/magma-components/{p-f0d93b22.system.entry.js → p-4cc6c06d.system.entry.js} +3 -3
  1251. package/dist/magma-components/{p-7e87807d.entry.js → p-4e68ec48.entry.js} +1 -1
  1252. package/dist/magma-components/p-4f0c913b.system.entry.js +23 -0
  1253. package/dist/magma-components/{p-95a29fd2.entry.js → p-4f80b9be.entry.js} +1 -1
  1254. package/dist/magma-components/{p-6471c0a4.system.entry.js → p-54dfb648.system.entry.js} +2 -2
  1255. package/dist/magma-components/p-5519483d.entry.js +1 -0
  1256. package/dist/magma-components/p-56565acb.system.entry.js +10 -0
  1257. package/dist/magma-components/{p-3d60f528.system.entry.js → p-5845ebd7.system.entry.js} +2 -2
  1258. package/dist/magma-components/{p-333c0ae5.entry.js → p-58a75841.entry.js} +1 -1
  1259. package/dist/magma-components/{p-ecf29ffa.entry.js → p-59cf0c3d.entry.js} +1 -1
  1260. package/dist/magma-components/{p-c8430552.system.entry.js → p-5c3a54bf.system.entry.js} +2 -2
  1261. package/dist/magma-components/p-5c82a88a.entry.js +1 -0
  1262. package/dist/magma-components/{p-a9c7fb3f.entry.js → p-5cf09df3.entry.js} +3 -3
  1263. package/dist/magma-components/{p-756cd3dc.entry.js → p-5ec955a7.entry.js} +1 -1
  1264. package/dist/magma-components/{p-16651356.entry.js → p-5f17dc76.entry.js} +1 -1
  1265. package/dist/magma-components/p-5fd09fb5.system.entry.js +29 -0
  1266. package/dist/magma-components/{p-b4856322.entry.js → p-5fe812ee.entry.js} +1 -1
  1267. package/dist/magma-components/{p-03441f69.entry.js → p-618f8dc9.entry.js} +1 -1
  1268. package/dist/magma-components/{p-34183ce3.entry.js → p-61fb9286.entry.js} +1 -1
  1269. package/dist/magma-components/{p-6443e40f.entry.js → p-63a53b4d.entry.js} +1 -1
  1270. package/dist/magma-components/{p-52b73a95.system.entry.js → p-6436bfa8.system.entry.js} +2 -2
  1271. package/dist/magma-components/{p-73f22a7d.entry.js → p-648d77bc.entry.js} +1 -1
  1272. package/dist/magma-components/p-65acd2e8.entry.js +1 -0
  1273. package/dist/magma-components/{p-5b5d57b0.system.entry.js → p-65ed7a0f.system.entry.js} +7 -5
  1274. package/dist/magma-components/p-67e30158.entry.js +1 -0
  1275. package/dist/magma-components/{p-68d83e18.system.entry.js → p-6864cc54.system.entry.js} +1 -1
  1276. package/dist/magma-components/{p-aa601247.system.entry.js → p-69afe21e.system.entry.js} +2 -2
  1277. package/dist/magma-components/{p-1686b36a.entry.js → p-6ac46e2f.entry.js} +1 -1
  1278. package/dist/magma-components/{p-09675899.entry.js → p-6b84c7a7.entry.js} +1 -1
  1279. package/dist/magma-components/p-6ba8b2d6.entry.js +1 -0
  1280. package/dist/magma-components/{p-8928d9b5.system.entry.js → p-6c68fbe9.system.entry.js} +2 -2
  1281. package/dist/magma-components/{p-c67655fa.entry.js → p-6cca1d61.entry.js} +1 -1
  1282. package/dist/magma-components/{p-ea93721d.entry.js → p-6e5b15c5.entry.js} +1 -1
  1283. package/dist/magma-components/{p-303173d5.system.entry.js → p-6e8b3c36.system.entry.js} +3 -3
  1284. package/dist/magma-components/{p-bd4ad8c7.entry.js → p-6f7d6a3e.entry.js} +1 -1
  1285. package/dist/magma-components/{p-06ba1f71.system.entry.js → p-70a065dc.system.entry.js} +2 -2
  1286. package/dist/magma-components/{p-4564e7ad.entry.js → p-70a83504.entry.js} +1 -1
  1287. package/dist/magma-components/p-71d171a8.entry.js +1 -0
  1288. package/dist/magma-components/{p-5c4aed7e.entry.js → p-71f650fe.entry.js} +1 -1
  1289. package/dist/magma-components/{p-7cfa2415.system.entry.js → p-73ddade8.system.entry.js} +1 -1
  1290. package/dist/magma-components/p-73efbc7a.entry.js +1 -0
  1291. package/dist/magma-components/p-76fb49a1.system.entry.js +11 -0
  1292. package/dist/magma-components/{p-6d7e8240.system.entry.js → p-795215a4.system.entry.js} +1 -1
  1293. package/dist/magma-components/{p-1db5ab39.entry.js → p-79f36661.entry.js} +1 -1
  1294. package/dist/magma-components/{p-3ccc1c10.entry.js → p-79f6c73e.entry.js} +1 -1
  1295. package/dist/magma-components/{p-2e5684a0.system.entry.js → p-7cb4260c.system.entry.js} +2 -2
  1296. package/dist/magma-components/{p-a33a235e.entry.js → p-7cec80c9.entry.js} +1 -1
  1297. package/dist/magma-components/{p-d1751ff6.entry.js → p-7e717a2b.entry.js} +1 -1
  1298. package/dist/magma-components/{p-c2a883b0.system.entry.js → p-8329caf9.system.entry.js} +1 -1
  1299. package/dist/magma-components/p-85389823.system.entry.js +82 -0
  1300. package/dist/magma-components/{p-16a7e26a.system.entry.js → p-86050b72.system.entry.js} +1 -1
  1301. package/dist/magma-components/{p-4bb45501.entry.js → p-88a7d026.entry.js} +1 -1
  1302. package/dist/magma-components/p-89d47be8.system.entry.js +7 -0
  1303. package/dist/magma-components/p-89eb7b19.entry.js +1 -0
  1304. package/dist/magma-components/{p-03a2f4e7.system.entry.js → p-8a3626c7.system.entry.js} +1 -1
  1305. package/dist/magma-components/{p-9e3c1c28.system.entry.js → p-8e195423.system.entry.js} +5 -5
  1306. package/dist/magma-components/{p-522968d1.system.entry.js → p-907d8111.system.entry.js} +1 -1
  1307. package/dist/magma-components/{p-e66db408.entry.js → p-907dd338.entry.js} +1 -1
  1308. package/dist/magma-components/p-9282b1eb.system.entry.js +60 -0
  1309. package/dist/magma-components/p-92a8391c.entry.js +1 -0
  1310. package/dist/magma-components/{p-01d6d5a5.system.entry.js → p-94b46388.system.entry.js} +2 -2
  1311. package/dist/magma-components/{p-b7d90310.entry.js → p-95f07748.entry.js} +1 -1
  1312. package/dist/magma-components/p-97d431f3.system.entry.js +1 -0
  1313. package/dist/magma-components/{p-ca0f3549.entry.js → p-98048238.entry.js} +1 -1
  1314. package/dist/magma-components/{p-b47c444e.system.entry.js → p-9905ebcf.system.entry.js} +2 -2
  1315. package/dist/magma-components/{p-aa86018e.system.entry.js → p-990b3146.system.entry.js} +2 -2
  1316. package/dist/magma-components/p-9b10fdcb.system.entry.js +27 -0
  1317. package/dist/magma-components/{p-8e471af5.entry.js → p-9b4daea1.entry.js} +1 -1
  1318. package/dist/magma-components/{p-11543f44.system.entry.js → p-9c617430.system.entry.js} +4 -4
  1319. package/dist/magma-components/p-9f58805c.system.entry.js +13 -0
  1320. package/dist/magma-components/{p-c3cfbc71.system.entry.js → p-9f653320.system.entry.js} +2 -2
  1321. package/dist/magma-components/{p-1d101083.system.entry.js → p-9fa41a55.system.entry.js} +1 -1
  1322. package/dist/magma-components/{p-a9d100e5.system.entry.js → p-9fac94ff.system.entry.js} +3 -3
  1323. package/dist/{components/p-CtEHhdv4.js → magma-components/p-B0SxTwF4.js} +1 -1
  1324. package/dist/magma-components/p-B6OZspN1.system.js +5 -0
  1325. package/dist/magma-components/p-BQhu9Pch.js +3 -0
  1326. package/dist/magma-components/{p-EhfbAdzV.system.js → p-BfmjlcJL.system.js} +3 -3
  1327. package/dist/magma-components/{p-B6f9M1Bj.system.js → p-BhMNGZjh.system.js} +13 -4
  1328. package/dist/magma-components/{p-BAW1DAbr.system.js → p-CJcKfFM1.system.js} +2 -2
  1329. package/dist/magma-components/{p-H8sVzFTL.js → p-CV9cS5S1.js} +1 -1
  1330. package/dist/magma-components/{p-DGfoeZMw.system.js → p-C_jcGVti.system.js} +2 -2
  1331. package/dist/magma-components/{p-BXkIXROP.js → p-DCJuMTY7.js} +1 -1
  1332. package/dist/magma-components/{p-BkfGbFba.js → p-DDMAJPbm.js} +2 -2
  1333. package/dist/magma-components/{p-CyPLJo0p.system.js → p-DJ5-T3cU.system.js} +1 -1
  1334. package/dist/magma-components/{p-CzZWts7L.system.js → p-DQfleYtv.system.js} +23 -16
  1335. package/dist/magma-components/{p-D5Yayq7E.system.js → p-Djd8g56b.system.js} +1 -1
  1336. package/dist/magma-components/p-Pwyk_BKp.js +1 -0
  1337. package/dist/magma-components/{p-98a3802b.system.entry.js → p-a0b8c130.system.entry.js} +1 -1
  1338. package/dist/magma-components/{p-03285704.entry.js → p-a1085d6b.entry.js} +1 -1
  1339. package/dist/magma-components/{p-73a6ee3b.system.entry.js → p-a4dcc327.system.entry.js} +1 -1
  1340. package/dist/magma-components/{p-a190c325.system.entry.js → p-a6e82aa7.system.entry.js} +2 -2
  1341. package/dist/magma-components/{p-b20f811b.system.entry.js → p-a738797b.system.entry.js} +2 -2
  1342. package/dist/magma-components/{p-0c8dd132.entry.js → p-a754bd25.entry.js} +1 -1
  1343. package/dist/magma-components/p-a77cbe57.system.entry.js +55 -0
  1344. package/dist/magma-components/{p-778a46fa.entry.js → p-a7cc7459.entry.js} +1 -1
  1345. package/dist/magma-components/p-a90c4a11.entry.js +1 -0
  1346. package/dist/magma-components/{p-bca909d9.entry.js → p-aa65dfb2.entry.js} +1 -1
  1347. package/dist/magma-components/p-ad438b7b.system.entry.js +33 -0
  1348. package/dist/magma-components/{p-6de384d0.system.entry.js → p-adecc08e.system.entry.js} +1 -1
  1349. package/dist/magma-components/{p-009e4359.system.entry.js → p-b27af8ba.system.entry.js} +111 -111
  1350. package/dist/magma-components/{p-cc5518b1.entry.js → p-b2b0f738.entry.js} +1 -1
  1351. package/dist/magma-components/{p-913123e6.entry.js → p-b3aca1fa.entry.js} +1 -1
  1352. package/dist/magma-components/{p-d7813f9b.system.entry.js → p-b440fd7b.system.entry.js} +1 -1
  1353. package/dist/magma-components/{p-3d0578a7.entry.js → p-b4afd3c7.entry.js} +1 -1
  1354. package/dist/magma-components/p-b51ed8f6.entry.js +1 -0
  1355. package/dist/magma-components/{p-70cf2c28.entry.js → p-b6239109.entry.js} +1 -1
  1356. package/dist/magma-components/{p-1e5d4854.system.entry.js → p-b7a16ade.system.entry.js} +2 -2
  1357. package/dist/magma-components/p-b98025cb.system.entry.js +34 -0
  1358. package/dist/magma-components/p-ba6bb2f1.entry.js +1 -0
  1359. package/dist/magma-components/p-ba7f5d01.system.entry.js +1 -0
  1360. package/dist/magma-components/{p-c2d9cf4e.system.entry.js → p-bb3dcd13.system.entry.js} +1 -1
  1361. package/dist/magma-components/p-bb7b5f5e.entry.js +1 -0
  1362. package/dist/magma-components/p-bc0fe932.system.entry.js +7 -0
  1363. package/dist/magma-components/p-be4ff85e.entry.js +1 -0
  1364. package/dist/magma-components/{p-e497f0db.entry.js → p-bfdfba19.entry.js} +1 -1
  1365. package/dist/magma-components/{p-af1a93c6.system.entry.js → p-c021e9a3.system.entry.js} +2 -2
  1366. package/dist/magma-components/{p-cfb153b8.entry.js → p-c082daa4.entry.js} +1 -1
  1367. package/dist/magma-components/{p-1784d5fb.entry.js → p-c28c1c09.entry.js} +1 -1
  1368. package/dist/magma-components/{p-275d7968.system.entry.js → p-c31ba98a.system.entry.js} +14 -14
  1369. package/dist/magma-components/p-c4b498d4.entry.js +1 -0
  1370. package/dist/magma-components/{p-e160e4e1.entry.js → p-c5321c72.entry.js} +1 -1
  1371. package/dist/magma-components/{p-ede31d27.system.entry.js → p-c878eef8.system.entry.js} +2 -2
  1372. package/dist/magma-components/{p-555bd3f8.system.entry.js → p-c8822563.system.entry.js} +2 -2
  1373. package/dist/magma-components/p-cc51ab16.system.entry.js +16 -0
  1374. package/dist/magma-components/{p-f2e5a2c7.system.entry.js → p-cd396f69.system.entry.js} +1 -1
  1375. package/dist/magma-components/{p-a00805cd.system.entry.js → p-d05073ed.system.entry.js} +6 -6
  1376. package/dist/magma-components/{p-270e9afa.entry.js → p-d34cc848.entry.js} +1 -1
  1377. package/dist/magma-components/{p-3fb983e9.system.entry.js → p-d4ca0c40.system.entry.js} +1 -1
  1378. package/dist/magma-components/{p-757c3420.entry.js → p-d52948de.entry.js} +1 -1
  1379. package/dist/magma-components/{p-c5b7f820.system.entry.js → p-d579a012.system.entry.js} +1 -1
  1380. package/dist/magma-components/{p-14f60718.system.entry.js → p-d5bef373.system.entry.js} +1 -1
  1381. package/dist/magma-components/{p-b18b0088.system.entry.js → p-d666a86c.system.entry.js} +1 -1
  1382. package/dist/magma-components/{p-f5c82548.system.entry.js → p-d6934fc0.system.entry.js} +1 -1
  1383. package/dist/magma-components/{p-0760e8a4.entry.js → p-d69ddd73.entry.js} +1 -1
  1384. package/dist/magma-components/{p-eb4f76d8.system.entry.js → p-d7c5f9ec.system.entry.js} +7 -7
  1385. package/dist/magma-components/p-d8ac0d1f.system.entry.js +16 -0
  1386. package/dist/magma-components/{p-9be80c34.entry.js → p-d8c068be.entry.js} +1 -1
  1387. package/dist/magma-components/{p-2289423c.system.entry.js → p-d9edc7f8.system.entry.js} +1 -1
  1388. package/dist/magma-components/p-da4915d0.entry.js +1 -0
  1389. package/dist/magma-components/{p-73b0b35f.system.entry.js → p-dc99e9a9.system.entry.js} +2 -2
  1390. package/dist/magma-components/{p-c0c69807.system.entry.js → p-dd621963.system.entry.js} +1 -1
  1391. package/dist/magma-components/{p-11ee7089.system.entry.js → p-dfc31d2e.system.entry.js} +2 -2
  1392. package/dist/magma-components/p-e5b22a99.system.entry.js +48 -0
  1393. package/dist/magma-components/p-e6500bfe.system.entry.js +29 -0
  1394. package/dist/magma-components/{p-62e42a62.entry.js → p-e88a43ac.entry.js} +1 -1
  1395. package/dist/magma-components/{p-3b41f929.entry.js → p-e9f821a0.entry.js} +1 -1
  1396. package/dist/magma-components/{p-ac401f1a.entry.js → p-ec1b38c7.entry.js} +1 -1
  1397. package/dist/magma-components/{p-ee65f0eb.system.entry.js → p-eec2ae5c.system.entry.js} +2 -2
  1398. package/dist/magma-components/{p-78cced59.entry.js → p-efb4357e.entry.js} +1 -1
  1399. package/dist/magma-components/{p-586878a2.system.entry.js → p-f02972ba.system.entry.js} +4 -4
  1400. package/dist/magma-components/{p-ddc31c50.entry.js → p-f07777b0.entry.js} +1 -1
  1401. package/dist/magma-components/{p-478bbfdb.entry.js → p-f0fd6414.entry.js} +1 -1
  1402. package/dist/magma-components/p-f1d263fa.system.entry.js +137 -0
  1403. package/dist/magma-components/{p-cfcb8bb5.entry.js → p-f43ee21d.entry.js} +1 -1
  1404. package/dist/magma-components/{p-e84361ee.system.entry.js → p-f5ea4c19.system.entry.js} +12 -6
  1405. package/dist/magma-components/{p-4e4dd1c1.system.entry.js → p-f6256d26.system.entry.js} +2 -2
  1406. package/dist/magma-components/{p-8aa6524e.entry.js → p-f62ea4bc.entry.js} +1 -1
  1407. package/dist/magma-components/{p-18421a84.entry.js → p-f6638f03.entry.js} +1 -1
  1408. package/dist/magma-components/{p-41829c15.system.entry.js → p-f895695a.system.entry.js} +2 -2
  1409. package/dist/magma-components/{p-a075c069.entry.js → p-fa8482c0.entry.js} +1 -1
  1410. package/dist/magma-components/{p-857e893e.system.entry.js → p-fafb8e7b.system.entry.js} +3 -3
  1411. package/dist/magma-components/{p-d1281855.system.entry.js → p-fb3b659c.system.entry.js} +5 -5
  1412. package/dist/magma-components/{p-1f756317.entry.js → p-fc167181.entry.js} +1 -1
  1413. package/dist/magma-components/{p-33172d6f.system.entry.js → p-fc7b9e5b.system.entry.js} +11 -8
  1414. package/dist/magma-components/p-fc9a8862.entry.js +1 -0
  1415. package/dist/magma-components/{p-9b00051f.system.entry.js → p-fe6100ff.system.entry.js} +1 -1
  1416. package/dist/magma-components/{p-d173ae2f.system.entry.js → p-fe64c49c.system.entry.js} +1 -1
  1417. package/dist/magma-components/{p-f3041712.entry.js → p-fe9a8ca1.entry.js} +1 -1
  1418. package/dist/mcp/checks.js +32 -13
  1419. package/dist/mcp/patterns.js +1 -1
  1420. package/dist/mcp/tools.json +1 -1
  1421. package/dist/stats.json +2945 -2661
  1422. package/dist/types/common/navigation.d.ts +12 -2
  1423. package/dist/types/components/mds-button/mds-button.d.ts +13 -0
  1424. package/dist/types/components/mds-button-dropdown/mds-button-dropdown.d.ts +7 -0
  1425. package/dist/types/components/mds-img/mds-img.d.ts +13 -3
  1426. package/dist/types/components/mds-img/meta/storybook.d.ts +11 -0
  1427. package/dist/types/components/mds-img/meta/types.d.ts +2 -0
  1428. package/dist/types/components/mds-input-field/mds-input-field.d.ts +6 -0
  1429. package/dist/types/components/mds-keyboard-key/meta/icons.d.ts +1 -1
  1430. package/dist/types/components/mds-link/mds-link.d.ts +13 -0
  1431. package/dist/types/components/mds-stepper-bar/mds-stepper-bar.d.ts +0 -1
  1432. package/dist/types/components/mds-stepper-bar-item/mds-stepper-bar-item.d.ts +10 -1
  1433. package/dist/types/components/mds-tooltip/mds-tooltip.d.ts +5 -3
  1434. package/dist/types/components.d.ts +62 -8
  1435. package/dist/types/fixtures/states.d.ts +33 -0
  1436. package/package.json +9 -8
  1437. package/dist/components/p-B3npFzUR.js +0 -1
  1438. package/dist/components/p-BD9VWE7b.js +0 -1
  1439. package/dist/components/p-Bg11_7lt.js +0 -1
  1440. package/dist/components/p-C589Hkfn.js +0 -1
  1441. package/dist/components/p-C878c9Nu.js +0 -1
  1442. package/dist/components/p-CS8s4gRV.js +0 -1
  1443. package/dist/components/p-CfCw1XZP.js +0 -1
  1444. package/dist/components/p-Cs80Zm2b.js +0 -8
  1445. package/dist/components/p-Cty6fegI.js +0 -1
  1446. package/dist/components/p-DKYN6Ikh.js +0 -1
  1447. package/dist/components/p-MjWyZlga.js +0 -1
  1448. package/dist/components/p-To9IeLHs.js +0 -1
  1449. package/dist/components/p-VoGfNJRY.js +0 -1
  1450. package/dist/components/p-g2_CekDc.js +0 -3
  1451. package/dist/magma-components/p-09537867.entry.js +0 -1
  1452. package/dist/magma-components/p-0a914567.entry.js +0 -1
  1453. package/dist/magma-components/p-0e7bb90b.system.entry.js +0 -127
  1454. package/dist/magma-components/p-10a68a4d.system.entry.js +0 -7
  1455. package/dist/magma-components/p-193b58d0.entry.js +0 -1
  1456. package/dist/magma-components/p-19f3b524.system.entry.js +0 -55
  1457. package/dist/magma-components/p-2100343f.entry.js +0 -1
  1458. package/dist/magma-components/p-211b2675.system.entry.js +0 -1
  1459. package/dist/magma-components/p-26aad538.entry.js +0 -1
  1460. package/dist/magma-components/p-28ecae1e.system.entry.js +0 -16
  1461. package/dist/magma-components/p-2aa3e73a.system.entry.js +0 -13
  1462. package/dist/magma-components/p-2c64ec7e.entry.js +0 -1
  1463. package/dist/magma-components/p-35a77756.entry.js +0 -1
  1464. package/dist/magma-components/p-37172440.entry.js +0 -1
  1465. package/dist/magma-components/p-3d45d7a7.entry.js +0 -1
  1466. package/dist/magma-components/p-4082973c.system.entry.js +0 -30
  1467. package/dist/magma-components/p-4242100c.entry.js +0 -1
  1468. package/dist/magma-components/p-430239ca.entry.js +0 -8
  1469. package/dist/magma-components/p-478e6930.entry.js +0 -1
  1470. package/dist/magma-components/p-4e431466.entry.js +0 -1
  1471. package/dist/magma-components/p-533bb401.system.entry.js +0 -60
  1472. package/dist/magma-components/p-6619b3c0.system.entry.js +0 -34
  1473. package/dist/magma-components/p-67fa6fd7.entry.js +0 -1
  1474. package/dist/magma-components/p-6fb17347.system.entry.js +0 -1
  1475. package/dist/magma-components/p-6fdf3b37.entry.js +0 -1
  1476. package/dist/magma-components/p-73596a07.entry.js +0 -1
  1477. package/dist/magma-components/p-73c0b53e.system.entry.js +0 -82
  1478. package/dist/magma-components/p-7caf244b.system.entry.js +0 -7
  1479. package/dist/magma-components/p-851010c6.system.entry.js +0 -25
  1480. package/dist/magma-components/p-8acbf50a.entry.js +0 -1
  1481. package/dist/magma-components/p-96ece2cc.system.entry.js +0 -27
  1482. package/dist/magma-components/p-96f66b8f.entry.js +0 -1
  1483. package/dist/magma-components/p-B7Jp0tqu.system.js +0 -5
  1484. package/dist/magma-components/p-CPibDZjX.js +0 -3
  1485. package/dist/magma-components/p-To9IeLHs.js +0 -1
  1486. package/dist/magma-components/p-a025b35b.entry.js +0 -1
  1487. package/dist/magma-components/p-a02819e3.entry.js +0 -1
  1488. package/dist/magma-components/p-a0764f01.entry.js +0 -1
  1489. package/dist/magma-components/p-ab920e0b.entry.js +0 -1
  1490. package/dist/magma-components/p-ad6b5fc1.system.entry.js +0 -16
  1491. package/dist/magma-components/p-b0406c51.entry.js +0 -1
  1492. package/dist/magma-components/p-ba148b89.system.entry.js +0 -23
  1493. package/dist/magma-components/p-bbbf8b89.system.entry.js +0 -29
  1494. package/dist/magma-components/p-c6cab2cb.entry.js +0 -1
  1495. package/dist/magma-components/p-c6f56934.entry.js +0 -1
  1496. package/dist/magma-components/p-cf8cfcac.system.entry.js +0 -10
  1497. package/dist/magma-components/p-d5dec64d.entry.js +0 -1
  1498. package/dist/magma-components/p-ee247029.system.entry.js +0 -9
  1499. package/dist/magma-components/p-f3f1da06.system.entry.js +0 -39
  1500. package/dist/magma-components/p-f9d2316a.entry.js +0 -1
  1501. package/dist/magma-components/p-fe4ae251.entry.js +0 -1
  1502. package/dist/magma-components/p-ffcfa9e3.system.entry.js +0 -11
@@ -1,8 +1,8 @@
1
1
  {
2
- "timestamp": "2026-11-12T16:08:51",
2
+ "timestamp": "2026-11-19T09:33:56",
3
3
  "compiler": {
4
4
  "name": "@stencil/core",
5
- "version": "4.45.3",
5
+ "version": "4.45.4",
6
6
  "typescriptVersion": "5.8.3"
7
7
  },
8
8
  "components": [
@@ -4470,8 +4470,8 @@
4470
4470
  }
4471
4471
  ],
4472
4472
  "usage": {
4473
- "1. Description": "The `<mds-button>` web component is the primary interactive action control of the Magma Design System. It renders as a button, or as a link when `href` is set, handling form association, accessibility, loading state, and iconography natively.\n\n#### Semantic Behavior\n\n- **Button vs. link**: Providing `href` renders a real anchor inside the component and gives the host `role=\"link\"`. The browser follows the link, so a modifier or middle click opens it in a new tab and the context menu offers the link actions; `target=\"blank\"` opens a new tab on a plain click too. A `click` listener on the host cancels the navigation with `preventDefault()`, which is how a client-side router takes over. A click from the keyboard, a script or an assistive technology lands on the host and is followed the same way, unless cancelled.\n- **Form association**: Inside a `<form>` the component submits (`type=\"submit\"`, default) or resets (`type=\"reset\"`) it like a native button, with no extra wiring; use `type=\"button\"` to opt out. With `name` set, a submit sends `name=value`, so buttons that submit the same form tell the receiver which one was chosen. A custom element cannot be a submitter, so `event.submitter` is a hidden native button that stands in for the component: it carries the same `name` and `value`, but it is not the `mds-button` element.\n- **Active state**: Mirrors a visual pressed state through the `active` attribute, safe to drive from CSS attribute selectors. It is cleared when the pointer is released: it does not mark the view you are in, `current` does.\n- **Current state**: `current` marks the button that leads to the view you are in, the current section of a bar or the current view of a switcher. `current` (or `current=\"page\"`) is that view: the button takes no pointer, Enter does nothing, and a click from a script neither navigates nor submits, so going there again never reloads it; it stays in the Tab order, announced with `aria-current=\"page\"` on a link and `aria-current=\"true\"` otherwise. `current=\"section\"` is a view inside it, a record of its list: the same look, but the button stays a link that brings you back, announced with `aria-current=\"true\"`. An `aria-current` written on the host (`step`, `date`) stays as written. The look: an area that weighs less than the hover of the tone, never its ring, so the hover of the other buttons still weighs more. `weak` takes the selected wash of its family (`--magma-accent-surface-selected`, `-wash-soft` for a status variant), `strong` keeps its fill, `outline` and `text` take the wash of their hover, and a variant whose hover keeps the area (`dark` and `light` weak, `light` strong) keeps it too. The label is one weight heavier (`xl` is black already), which marks the state where the area stays under 3:1; the look holds on hover. Never mark the current button with `disabled`, `aria-disabled` or a style of your own.\n- **Disabled state**: Blocks pointer and keyboard activation and removes the host from the tab sequence. A disabled `<fieldset>` around the button disables it the same way, as it does a native button, without setting `disabled`.\n- **Await state**: Renders an inline spinner, blocks pointer and keyboard activation, and sets `aria-busy=\"true\"` for assistive tech. The button keeps the focus it had, and a click from a script or an assistive technology neither submits nor resets its form again. Remove the attribute when done - do not set `await=\"false\"`.\n- **Keyboard**: Enter activates the button as a click does, and so does Space, on release, as on a native button; a button with `href` is a link, which Enter follows and Space does not.\n- **Accessibility**: Sets `role=\"button\"` on the host, `role=\"link\"` when `href` is set, whatever the format of the icon; the `label` prop (or slotted text) is rendered as the button text, which names it. Without a label, an `aria-label` or a `title`, the component sets `title` from the last segment of the icon slug (`mi/baseline/delete` -> \"delete\"), which names the icon, not the action; an icon given as inline SVG or base64 has no slug, and leaves the button with no name at all: icon-only buttons need an explicit `aria-label` (or `title`), or an `mds-tooltip` with `relation=\"label\"`. A host with `aria-labelledby` gets no name from the slug, and loses the one it had when the attribute comes later, as it does from the tooltip.\n- **Sizing**: The `size` prop drives padding, font size, and minimum hit area. Do not override dimensions with inline `width` / `height`.\n- **Linking constraint**: `target` is effective only when `href` is set.\n\n#### Component-specific variants and tones\n\nThe shared `variant` / `tone` ladders are defined in [`agents/variants.md`](../../../../agents/variants.md). `<mds-button>` adds:\n\n- **`variant=\"google\"` / `variant=\"apple\"`**: brand-correct chrome for SSO entry points. Do not reuse them for non-SSO buttons.\n- **`tone=\"box\"`**: the `strong` fill with an embossed, raised shadow (`--shadow-box-solid-strong`) and a brighter hover: more marked than `strong`, not less.\n\n#### Other behavioral props\n\n- **`icon`** is an SVG filename slug from the Magma icon library; **`iconPosition`** places the glyph relative to the label (use `right` for forward-motion CTAs).\n- **`iconCurrent`** and **`iconHover`** take the place of `icon` in their state: `iconCurrent` on the current button, `iconHover` under the pointer, which falls back on `iconCurrent`. One attribute gives the common pair, an outline icon at rest and the filled one on the current button, which the pointer previews on the others. Set `iconHover` to the `icon` to keep the icon still under the pointer, when `iconCurrent` says something the click does not do (a check). A pointer that cannot hover, a finger, never shows `iconHover`; the current button shows `iconCurrent` under the pointer too. Both need `icon`, which gives the icon its room, and the name taken from the slug stays the one of `icon`. Write every slug out whole, as for `icon`: the icons a product serves are the ones read in its sources.\n- **`truncate`**: `word` (default) keeps the label on one line and cuts it with an ellipsis, `all` clamps it with `line-clamp` (one line in the button), `none` lets it wrap onto more lines.\n- **`animation`**: `yugop` progressively reveals characters; otherwise text renders immediately.\n- **The first letter** of the label is uppercased. For a name or an identifier that must stay as written (`rdsysadmin`), set `--mds-button-label-transform: none` on the button or on any ancestor: the property inherits, so it also reaches the buttons that other components, `mds-button-dropdown` among them, render in their shadow root.\n",
4474
- "2. Examples": "Correct and idiomatic ways to use the `<mds-button>` component, ordered from most common to most specialized. The examples assume a working knowledge of the variant / tone ladders documented in [`agents/variants.md`](../../../../agents/variants.md) and the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Text Button via `label` Prop\n\nThe canonical form. Use the `label` prop for the button's text; it is rendered inside the button and is its accessible name, so screen readers work without extra wiring.\n\n```html\n<mds-button label=\"Conferma azione\" variant=\"primary\" tone=\"strong\"></mds-button>\n```\n\n#### Variant and Tone for Emphasis\n\nPair the same `variant` with a different `tone` to express importance. Do not invent custom colors to dim or saturate.\n\n```html\n<!-- High emphasis: primary call to action -->\n<mds-button label=\"Salva\" variant=\"primary\" tone=\"strong\"></mds-button>\n\n<!-- Medium emphasis: supporting action -->\n<mds-button label=\"Modifica\" variant=\"primary\" tone=\"outline\"></mds-button>\n\n<!-- Low emphasis: in-text or destructive secondary action -->\n<mds-button label=\"Annulla\" variant=\"error\" tone=\"text\"></mds-button>\n```\n\n#### Sizing\n\nUse the `size` prop. Do not override dimensions with inline `width` / `height`.\n\n```html\n<mds-button label=\"Small\" size=\"sm\" variant=\"primary\"></mds-button>\n<mds-button label=\"Medium\" size=\"md\" variant=\"primary\"></mds-button>\n<mds-button label=\"Large\" size=\"lg\" variant=\"primary\"></mds-button>\n<mds-button label=\"Extra large\" size=\"xl\" variant=\"primary\"></mds-button>\n```\n\n#### Button with Icon\n\nReference icons by their filename slug (no `.svg` extension). `icon-position` defaults to `left`; set it to `right` for forward-motion CTAs.\n\n```html\n<!-- Left icon (default) -->\n<mds-button label=\"Aggiungi\" icon=\"mi/baseline/add\" variant=\"primary\" tone=\"weak\"></mds-button>\n\n<!-- Right icon -->\n<mds-button\n label=\"Avanti\"\n icon=\"mi/baseline/arrow-forward\"\n icon-position=\"right\"\n variant=\"primary\"\n></mds-button>\n```\n\n#### Icon-Only Button\n\nOmit `label` and provide `aria-label` (or `title`) explicitly. Without one, the component names the button after the last segment of the icon slug (\"delete\"), which names the icon, not the action.\n\n```html\n<mds-button\n icon=\"mi/baseline/delete\"\n aria-label=\"Elimina elemento\"\n variant=\"error\"\n tone=\"text\"\n></mds-button>\n```\n\nWhen an `mds-tooltip` shows the name of the button, let the tooltip be the name with `relation=\"label\"` instead: the button then needs no `aria-label`, and gets no `title` from the icon slug.\n\n```html\n<mds-button id=\"elimina-btn\" icon=\"mi/baseline/delete\" variant=\"error\" tone=\"text\"></mds-button>\n<mds-tooltip target=\"#elimina-btn\" relation=\"label\">Elimina elemento</mds-tooltip>\n```\n\n#### Hyperlink via `href`\n\nSetting `href` renders a real link: the browser follows it, in a new tab on a modifier or middle click, and the context menu offers the link actions. Use `target=\"blank\"` to open in a new tab on a plain click too; default is `self`.\n\n```html\n<mds-button\n label=\"Visita il sito\"\n href=\"https://example.com\"\n target=\"blank\"\n variant=\"primary\"\n tone=\"outline\"\n></mds-button>\n```\n\n#### Client-Side Routing via `href`\n\nIn a single-page app keep `href` for the link it gives (new tab, context menu, crawlers) and register the router once with `NavigationService`, from `@maggioli-design-system/magma/services`: every component link is then routed on the client on a plain click, with no listener per button. A modifier or middle click, `target=\"blank\"` and a link to another origin stay with the browser; return `false` from the handler for a link the browser is to load.\n\n```html\n<mds-button label=\"Pratiche\" href=\"/pratiche\" variant=\"primary\" tone=\"text\"></mds-button>\n\n<script type=\"module\">\n import { NavigationService } from '@maggioli-design-system/magma/services';\n\n NavigationService.setHandler((href) => router.navigate(href));\n</script>\n```\n\nWithout a registered router, cancel the click on the button and route by hand: the component honours `preventDefault()`. Leave a modifier click alone, so that the browser opens the link in a new tab.\n\n```html\n<script>\n document.querySelector('mds-button[href]').addEventListener('click', (event) => {\n if (event.ctrlKey || event.metaKey || event.shiftKey || event.altKey) return;\n event.preventDefault();\n router.navigate(event.currentTarget.href);\n });\n</script>\n```\n\n#### The Current Section via `current`\n\nMark the button that leads to the view you are in with `current`: the section of the bar of the page on screen, the view of a switcher. It does nothing when clicked, so it never reloads the page, and it is announced as the current page. On a page inside a section, a record of its list, write `current=\"section\"`: the same look, and the button stays a link back to the list.\n\n```html\n<!-- the list of the records: Pratiche is the page on screen -->\n<mds-header-bar>\n <mds-text typography=\"h6\" tag=\"p\">Servizi demografici</mds-text>\n <mds-button slot=\"nav\" href=\"/pratiche\" variant=\"dark\" tone=\"text\" current>Pratiche</mds-button>\n <mds-button slot=\"nav\" href=\"/contatti\" variant=\"dark\" tone=\"text\">Contatti</mds-button>\n</mds-header-bar>\n\n<!-- one record of the list: Pratiche brings you back to it -->\n<mds-button slot=\"nav\" href=\"/pratiche\" variant=\"dark\" tone=\"text\" current=\"section\">Pratiche</mds-button>\n\n<!-- the view of a switcher, with no page of its own: aria-current=\"true\" -->\n<mds-button label=\"Lista\" tone=\"weak\" type=\"button\" current></mds-button>\n<mds-button label=\"Mappa\" tone=\"weak\" type=\"button\"></mds-button>\n```\n\n#### The Icon of Each State via `icon-current` and `icon-hover`\n\n`icon-current` takes the place of `icon` on the current button, and under the pointer too, which previews it on the other buttons: one attribute gives an outline icon at rest and the filled one on the view you are in. `icon-hover` sets the icon under the pointer on its own; set it to the `icon` to keep the icon still, when the icon of the current button says something the click does not do. Write the slugs out whole.\n\n```html\n<!-- outline at rest, filled on the current section and under the pointer -->\n<mds-button\n slot=\"nav\"\n href=\"/pratiche\"\n variant=\"dark\"\n tone=\"text\"\n icon=\"mi/outline/folder\"\n icon-current=\"mi/baseline/folder\"\n current\n>Pratiche</mds-button>\n<mds-button\n slot=\"nav\"\n href=\"/contatti\"\n variant=\"dark\"\n tone=\"text\"\n icon=\"mi/outline/contacts\"\n icon-current=\"mi/baseline/contacts\"\n>Contatti</mds-button>\n\n<!-- a check on the current view, and none under the pointer: it would say the view is chosen -->\n<mds-button\n label=\"Elenco\"\n tone=\"weak\"\n type=\"button\"\n icon=\"mi/baseline/view-list\"\n icon-current=\"mi/baseline/check\"\n icon-hover=\"mi/baseline/view-list\"\n current\n></mds-button>\n<mds-button\n label=\"Griglia\"\n tone=\"weak\"\n type=\"button\"\n icon=\"mi/baseline/grid-view\"\n icon-current=\"mi/baseline/check\"\n icon-hover=\"mi/baseline/grid-view\"\n></mds-button>\n\n<!-- another icon under the pointer only -->\n<mds-button\n icon=\"mi/baseline/close\"\n icon-hover=\"mi/outline/close\"\n aria-label=\"Chiudi\"\n variant=\"dark\"\n tone=\"text\"\n></mds-button>\n```\n\n#### Async Loading via `await`\n\nSet the `await` boolean attribute while a request is in flight. The component renders an inline spinner, blocks pointer activation, and sets `aria-busy=\"true\"`. Remove the attribute when done - do not set `await=\"false\"`.\n\n```html\n<mds-button label=\"Salvataggio in corso...\" await variant=\"primary\"></mds-button>\n```\n\n#### Form Participation\n\n`<mds-button>` is form-associated. Inside a `<form>` it natively triggers submit (`type=\"submit\"`, default) or reset (`type=\"reset\"`). Use `type=\"button\"` for any action that must not submit the form.\n\n```html\n<form action=\"/save\" method=\"post\">\n <mds-input-field label=\"Titolo\">\n <mds-input name=\"title\"></mds-input>\n </mds-input-field>\n\n <mds-button type=\"submit\" label=\"Invia\" variant=\"primary\" tone=\"strong\"></mds-button>\n <mds-button type=\"reset\" label=\"Reimposta\" variant=\"dark\" tone=\"outline\"></mds-button>\n <mds-button type=\"button\" label=\"Anteprima\" variant=\"primary\" tone=\"text\"></mds-button>\n</form>\n```\n\n#### Several Actions That Submit One Form\n\nGive the buttons the same `name` and a different `value`, as with native submit buttons: the receiver reads which action was chosen from `name`.\n\n```html\n<form action=\"/mail\" method=\"post\">\n <mds-input-field label=\"Oggetto\">\n <mds-input name=\"subject\"></mds-input>\n </mds-input-field>\n\n <!-- the receiver gets action=send or action=draft -->\n <mds-button name=\"action\" value=\"send\" label=\"Invia\" variant=\"primary\"></mds-button>\n <mds-button name=\"action\" value=\"draft\" label=\"Salva come bozza\" tone=\"outline\"></mds-button>\n</form>\n```\n\nWhen your code handles the submit, build the form data with `event.submitter`, as for a native button: it carries the `name` / `value` of the button that was clicked.\n\n```js\nform.addEventListener('submit', (event) => {\n event.preventDefault();\n const data = new FormData(form, event.submitter);\n data.get('action'); // 'send' or 'draft'\n});\n```\n\nTo show one action and keep the others in a menu, use [`mds-button-dropdown`](../mds-button-dropdown/AGENTS.md) with `type=\"submit\"`: its primary action and its menu items send `name` / `value` the same way.\n\n#### Notification Badge via Named Slot\n\nThe `notification` slot accepts an `<mds-notification>`. This is the documented exception to the default-slot-is-text rule.\n\n```html\n<mds-button label=\"Notifiche\" icon=\"mi/baseline/notifications\" variant=\"primary\" tone=\"weak\">\n <mds-notification slot=\"notification\" value=\"12\"></mds-notification>\n</mds-button>\n```\n\n#### SSO Identity Variants\n\n`variant=\"google\"` and `variant=\"apple\"` apply the brand-correct chrome for SSO entry points. Do not reuse them for non-SSO buttons.\n\n```html\n<mds-button label=\"Accedi con Google\" variant=\"google\"></mds-button>\n<mds-button label=\"Accedi con Apple\" variant=\"apple\"></mds-button>\n```\n\n#### Styling Customization\n\nStyle the button only through its documented `--mds-button-*` CSS custom properties. Set them on the host or a parent selector; use the semantic color roles via `rgb(var(--magma-<role>))` so dark mode, named themes and high contrast keep working.\n\n```css\n.featured-action mds-button {\n --mds-button-background: rgb(var(--magma-accent-emphasis));\n --mds-button-color: rgb(var(--magma-accent-on-emphasis));\n --mds-button-radius: var(--magma-radius-lg);\n --mds-button-gap: calc(var(--spacing) * 300);\n}\n\n/* labels that are names or identifiers, shown as written: it inherits, so it reaches the\n buttons inside other components too */\n.tenant-switcher {\n --mds-button-label-transform: none;\n}\n```\n",
4473
+ "1. Description": "The `<mds-button>` web component is the primary interactive action control of the Magma Design System. It renders as a button, or as a link when `href` is set, handling form association, accessibility, loading state, and iconography natively.\n\n#### Semantic Behavior\n\n- **Button vs. link**: Providing `href` renders a real anchor inside the component and gives the host `role=\"link\"`. The browser follows the link, so a modifier or middle click opens it in a new tab and the context menu offers the link actions; `target=\"blank\"` opens a new tab on a plain click too. A `click` listener on the host cancels the navigation with `preventDefault()`, which is how a client-side router takes over. A click from the keyboard, a script or an assistive technology lands on the host and is followed the same way, unless cancelled.\n- **Download**: with `href`, `download` saves the file instead of opening it, as on a native `<a download>`: with no value the file keeps the name the server gives it, a value names the saved file. Browsers apply it to the URLs of the origin of the page, `blob:` and `data:` only. A download never goes to the router: the click of the pointer, of the keyboard and of a script all reach the anchor, which saves the file.\n- **Form association**: Inside a `<form>` the component submits (`type=\"submit\"`, default) or resets (`type=\"reset\"`) it like a native button, with no extra wiring; use `type=\"button\"` to opt out. With `name` set, a submit sends `name=value`, so buttons that submit the same form tell the receiver which one was chosen. A custom element cannot be a submitter, so `event.submitter` is a hidden native button that stands in for the component: it carries the same `name` and `value`, but it is not the `mds-button` element.\n- **Active state**: Mirrors a visual pressed state through the `active` attribute, safe to drive from CSS attribute selectors. It is cleared when the pointer is released: it does not mark the view you are in, `current` does.\n- **Current state**: `current` marks the button that leads to the view you are in, the current section of a bar or the current view of a switcher. `current` (or `current=\"page\"`) is that view: the button takes no pointer, Enter does nothing, and a click from a script neither navigates nor submits, so going there again never reloads it; it stays in the Tab order, announced with `aria-current=\"page\"` on a link and `aria-current=\"true\"` otherwise. `current=\"section\"` is a view inside it, a record of its list: the same look, but the button stays a link that brings you back, announced with `aria-current=\"true\"`. An `aria-current` written on the host (`step`, `date`) stays as written. The look: an area that weighs less than the hover of the tone, never its ring, so the hover of the other buttons still weighs more. `weak` takes the selected wash of its family (`--magma-accent-surface-selected`, `-wash-soft` for a status variant), `strong` keeps its fill, `outline` and `text` take the wash of their hover, and a variant whose hover keeps the area (`dark` and `light` weak, `light` strong) keeps it too. The label is one weight heavier (`xl` is black already), which marks the state where the area stays under 3:1; the look holds on hover. Never mark the current button with `disabled`, `aria-disabled` or a style of your own.\n- **Disabled state**: Blocks pointer and keyboard activation and removes the host from the tab sequence. A disabled `<fieldset>` around the button disables it the same way, as it does a native button, without setting `disabled`.\n- **Await state**: Renders an inline spinner, blocks pointer and keyboard activation, and sets `aria-busy=\"true\"` for assistive tech. The button keeps the focus it had, and a click from a script or an assistive technology neither submits nor resets its form again. Remove the attribute when done - do not set `await=\"false\"`.\n- **Keyboard**: Enter activates the button as a click does, and so does Space, on release, as on a native button; a button with `href` is a link, which Enter follows and Space does not.\n- **Accessibility**: Sets `role=\"button\"` on the host, `role=\"link\"` when `href` is set, whatever the format of the icon; the `label` prop (or slotted text) is rendered as the button text, which names it. Without a label, an `aria-label` or a `title`, the component sets `title` from the last segment of the icon slug (`mi/baseline/delete` -> \"delete\"), which names the icon, not the action; an icon given as inline SVG or base64 has no slug, and leaves the button with no name at all: icon-only buttons need an explicit `aria-label` (or `title`), or an `mds-tooltip` with `relation=\"label\"`. A host with `aria-labelledby` gets no name from the slug, and loses the one it had when the attribute comes later, as it does from the tooltip.\n- **Sizing**: The `size` prop drives padding, font size, and minimum hit area. Do not override dimensions with inline `width` / `height`.\n- **Linking constraint**: `target` is effective only when `href` is set.\n\n#### Component-specific variants and tones\n\nThe shared `variant` / `tone` ladders are defined in [`agents/variants.md`](../../../../agents/variants.md). `<mds-button>` adds:\n\n- **`variant=\"google\"` / `variant=\"apple\"`**: brand-correct chrome for SSO entry points. Do not reuse them for non-SSO buttons.\n- **`tone=\"box\"`**: the `strong` fill with an embossed, raised shadow (`--shadow-box-solid-strong`) and a brighter hover: more marked than `strong`, not less.\n\n#### Other behavioral props\n\n- **`icon`** is an SVG filename slug from the Magma icon library; **`iconPosition`** places the glyph relative to the label (use `right` for forward-motion CTAs).\n- **`iconCurrent`** and **`iconHover`** take the place of `icon` in their state: `iconCurrent` on the current button, `iconHover` under the pointer, which falls back on `iconCurrent`. One attribute gives the common pair, an outline icon at rest and the filled one on the current button, which the pointer previews on the others. Set `iconHover` to the `icon` to keep the icon still under the pointer, when `iconCurrent` says something the click does not do (a check). A pointer that cannot hover, a finger, never shows `iconHover`; the current button shows `iconCurrent` under the pointer too. Both need `icon`, which gives the icon its room, and the name taken from the slug stays the one of `icon`. Write every slug out whole, as for `icon`: the icons a product serves are the ones read in its sources.\n- **`truncate`**: `word` (default) keeps the label on one line and cuts it with an ellipsis, `all` clamps it with `line-clamp` (one line in the button), `none` lets it wrap onto more lines.\n- **`animation`**: `yugop` progressively reveals characters; otherwise text renders immediately.\n- **The first letter** of the label is uppercased. For a name or an identifier that must stay as written (`rdsysadmin`), set `--mds-button-label-transform: none` on the button or on any ancestor: the property inherits, so it also reaches the buttons that other components, `mds-button-dropdown` among them, render in their shadow root.\n",
4474
+ "2. Examples": "Correct and idiomatic ways to use the `<mds-button>` component, ordered from most common to most specialized. The examples assume a working knowledge of the variant / tone ladders documented in [`agents/variants.md`](../../../../agents/variants.md) and the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Text Button via `label` Prop\n\nThe canonical form. Use the `label` prop for the button's text; it is rendered inside the button and is its accessible name, so screen readers work without extra wiring.\n\n```html\n<mds-button label=\"Conferma azione\" variant=\"primary\" tone=\"strong\"></mds-button>\n```\n\n#### Variant and Tone for Emphasis\n\nPair the same `variant` with a different `tone` to express importance. Do not invent custom colors to dim or saturate.\n\n```html\n<!-- High emphasis: primary call to action -->\n<mds-button label=\"Salva\" variant=\"primary\" tone=\"strong\"></mds-button>\n\n<!-- Medium emphasis: supporting action -->\n<mds-button label=\"Modifica\" variant=\"primary\" tone=\"outline\"></mds-button>\n\n<!-- Low emphasis: in-text or destructive secondary action -->\n<mds-button label=\"Annulla\" variant=\"error\" tone=\"text\"></mds-button>\n```\n\n#### Sizing\n\nUse the `size` prop. Do not override dimensions with inline `width` / `height`.\n\n```html\n<mds-button label=\"Small\" size=\"sm\" variant=\"primary\"></mds-button>\n<mds-button label=\"Medium\" size=\"md\" variant=\"primary\"></mds-button>\n<mds-button label=\"Large\" size=\"lg\" variant=\"primary\"></mds-button>\n<mds-button label=\"Extra large\" size=\"xl\" variant=\"primary\"></mds-button>\n```\n\n#### Button with Icon\n\nReference icons by their filename slug (no `.svg` extension). `icon-position` defaults to `left`; set it to `right` for forward-motion CTAs.\n\n```html\n<!-- Left icon (default) -->\n<mds-button label=\"Aggiungi\" icon=\"mi/baseline/add\" variant=\"primary\" tone=\"weak\"></mds-button>\n\n<!-- Right icon -->\n<mds-button\n label=\"Avanti\"\n icon=\"mi/baseline/arrow-forward\"\n icon-position=\"right\"\n variant=\"primary\"\n></mds-button>\n```\n\n#### Icon-Only Button\n\nOmit `label` and provide `aria-label` (or `title`) explicitly. Without one, the component names the button after the last segment of the icon slug (\"delete\"), which names the icon, not the action.\n\n```html\n<mds-button\n icon=\"mi/baseline/delete\"\n aria-label=\"Elimina elemento\"\n variant=\"error\"\n tone=\"text\"\n></mds-button>\n```\n\nWhen an `mds-tooltip` shows the name of the button, let the tooltip be the name with `relation=\"label\"` instead: the button then needs no `aria-label`, and gets no `title` from the icon slug.\n\n```html\n<mds-button id=\"elimina-btn\" icon=\"mi/baseline/delete\" variant=\"error\" tone=\"text\"></mds-button>\n<mds-tooltip target=\"#elimina-btn\" relation=\"label\">Elimina elemento</mds-tooltip>\n```\n\n#### Hyperlink via `href`\n\nSetting `href` renders a real link: the browser follows it, in a new tab on a modifier or middle click, and the context menu offers the link actions. Use `target=\"blank\"` to open in a new tab on a plain click too; default is `self`.\n\n```html\n<mds-button\n label=\"Visita il sito\"\n href=\"https://example.com\"\n target=\"blank\"\n variant=\"primary\"\n tone=\"outline\"\n></mds-button>\n```\n\n#### Download via `download`\n\nWith `href`, `download` saves the file instead of opening it in the tab, a file the browser can show (JSON, XML, a PDF) included; its value is the name of the saved file. The URL has to be on the origin of the page.\n\n```html\n<mds-button\n label=\"Scarica i colori\"\n href=\"/downloads/colors.xml\"\n download=\"colors.xml\"\n icon=\"mi/baseline/download\"\n tone=\"outline\"\n></mds-button>\n```\n\n#### Client-Side Routing via `href`\n\nIn a single-page app keep `href` for the link it gives (new tab, context menu, crawlers) and register the router once with `NavigationService`, from `@maggioli-design-system/magma/services`: every component link is then routed on the client on a plain click, with no listener per button. A modifier or middle click, `target=\"blank\"`, `download` and a link to another origin stay with the browser; return `false` from the handler for a link the browser is to load.\n\n```html\n<mds-button label=\"Pratiche\" href=\"/pratiche\" variant=\"primary\" tone=\"text\"></mds-button>\n\n<script type=\"module\">\n import { NavigationService } from '@maggioli-design-system/magma/services';\n\n NavigationService.setHandler((href) => router.navigate(href));\n</script>\n```\n\nWithout a registered router, cancel the click on the button and route by hand: the component honours `preventDefault()`. Leave a modifier click alone, so that the browser opens the link in a new tab.\n\n```html\n<script>\n document.querySelector('mds-button[href]').addEventListener('click', (event) => {\n if (event.ctrlKey || event.metaKey || event.shiftKey || event.altKey) return;\n event.preventDefault();\n router.navigate(event.currentTarget.href);\n });\n</script>\n```\n\n#### The Current Section via `current`\n\nMark the button that leads to the view you are in with `current`: the section of the bar of the page on screen, the view of a switcher. It does nothing when clicked, so it never reloads the page, and it is announced as the current page. On a page inside a section, a record of its list, write `current=\"section\"`: the same look, and the button stays a link back to the list.\n\n```html\n<!-- the list of the records: Pratiche is the page on screen -->\n<mds-header-bar>\n <mds-text typography=\"h6\" tag=\"p\">Servizi demografici</mds-text>\n <mds-button slot=\"nav\" href=\"/pratiche\" variant=\"dark\" tone=\"text\" current>Pratiche</mds-button>\n <mds-button slot=\"nav\" href=\"/contatti\" variant=\"dark\" tone=\"text\">Contatti</mds-button>\n</mds-header-bar>\n\n<!-- one record of the list: Pratiche brings you back to it -->\n<mds-button slot=\"nav\" href=\"/pratiche\" variant=\"dark\" tone=\"text\" current=\"section\">Pratiche</mds-button>\n\n<!-- the view of a switcher, with no page of its own: aria-current=\"true\" -->\n<mds-button label=\"Lista\" tone=\"weak\" type=\"button\" current></mds-button>\n<mds-button label=\"Mappa\" tone=\"weak\" type=\"button\"></mds-button>\n```\n\n#### The Icon of Each State via `icon-current` and `icon-hover`\n\n`icon-current` takes the place of `icon` on the current button, and under the pointer too, which previews it on the other buttons: one attribute gives an outline icon at rest and the filled one on the view you are in. `icon-hover` sets the icon under the pointer on its own; set it to the `icon` to keep the icon still, when the icon of the current button says something the click does not do. Write the slugs out whole.\n\n```html\n<!-- outline at rest, filled on the current section and under the pointer -->\n<mds-button\n slot=\"nav\"\n href=\"/pratiche\"\n variant=\"dark\"\n tone=\"text\"\n icon=\"mi/outline/folder\"\n icon-current=\"mi/baseline/folder\"\n current\n>Pratiche</mds-button>\n<mds-button\n slot=\"nav\"\n href=\"/contatti\"\n variant=\"dark\"\n tone=\"text\"\n icon=\"mi/outline/contacts\"\n icon-current=\"mi/baseline/contacts\"\n>Contatti</mds-button>\n\n<!-- a check on the current view, and none under the pointer: it would say the view is chosen -->\n<mds-button\n label=\"Elenco\"\n tone=\"weak\"\n type=\"button\"\n icon=\"mi/baseline/view-list\"\n icon-current=\"mi/baseline/check\"\n icon-hover=\"mi/baseline/view-list\"\n current\n></mds-button>\n<mds-button\n label=\"Griglia\"\n tone=\"weak\"\n type=\"button\"\n icon=\"mi/baseline/grid-view\"\n icon-current=\"mi/baseline/check\"\n icon-hover=\"mi/baseline/grid-view\"\n></mds-button>\n\n<!-- another icon under the pointer only -->\n<mds-button\n icon=\"mi/baseline/close\"\n icon-hover=\"mi/outline/close\"\n aria-label=\"Chiudi\"\n variant=\"dark\"\n tone=\"text\"\n></mds-button>\n```\n\n#### Async Loading via `await`\n\nSet the `await` boolean attribute while a request is in flight. The component renders an inline spinner, blocks pointer activation, and sets `aria-busy=\"true\"`. Remove the attribute when done - do not set `await=\"false\"`.\n\n```html\n<mds-button label=\"Salvataggio in corso...\" await variant=\"primary\"></mds-button>\n```\n\n#### Form Participation\n\n`<mds-button>` is form-associated. Inside a `<form>` it natively triggers submit (`type=\"submit\"`, default) or reset (`type=\"reset\"`). Use `type=\"button\"` for any action that must not submit the form.\n\n```html\n<form action=\"/save\" method=\"post\">\n <mds-input-field label=\"Titolo\">\n <mds-input name=\"title\"></mds-input>\n </mds-input-field>\n\n <mds-button type=\"submit\" label=\"Invia\" variant=\"primary\" tone=\"strong\"></mds-button>\n <mds-button type=\"reset\" label=\"Reimposta\" variant=\"dark\" tone=\"outline\"></mds-button>\n <mds-button type=\"button\" label=\"Anteprima\" variant=\"primary\" tone=\"text\"></mds-button>\n</form>\n```\n\n#### Several Actions That Submit One Form\n\nGive the buttons the same `name` and a different `value`, as with native submit buttons: the receiver reads which action was chosen from `name`.\n\n```html\n<form action=\"/mail\" method=\"post\">\n <mds-input-field label=\"Oggetto\">\n <mds-input name=\"subject\"></mds-input>\n </mds-input-field>\n\n <!-- the receiver gets action=send or action=draft -->\n <mds-button name=\"action\" value=\"send\" label=\"Invia\" variant=\"primary\"></mds-button>\n <mds-button name=\"action\" value=\"draft\" label=\"Salva come bozza\" tone=\"outline\"></mds-button>\n</form>\n```\n\nWhen your code handles the submit, build the form data with `event.submitter`, as for a native button: it carries the `name` / `value` of the button that was clicked.\n\n```js\nform.addEventListener('submit', (event) => {\n event.preventDefault();\n const data = new FormData(form, event.submitter);\n data.get('action'); // 'send' or 'draft'\n});\n```\n\nTo show one action and keep the others in a menu, use [`mds-button-dropdown`](../mds-button-dropdown/AGENTS.md) with `type=\"submit\"`: its primary action and its menu items send `name` / `value` the same way.\n\n#### Notification Badge via Named Slot\n\nThe `notification` slot accepts an `<mds-notification>`. This is the documented exception to the default-slot-is-text rule.\n\n```html\n<mds-button label=\"Notifiche\" icon=\"mi/baseline/notifications\" variant=\"primary\" tone=\"weak\">\n <mds-notification slot=\"notification\" value=\"12\"></mds-notification>\n</mds-button>\n```\n\n#### SSO Identity Variants\n\n`variant=\"google\"` and `variant=\"apple\"` apply the brand-correct chrome for SSO entry points. Do not reuse them for non-SSO buttons.\n\n```html\n<mds-button label=\"Accedi con Google\" variant=\"google\"></mds-button>\n<mds-button label=\"Accedi con Apple\" variant=\"apple\"></mds-button>\n```\n\n#### Styling Customization\n\nStyle the button only through its documented `--mds-button-*` CSS custom properties. Set them on the host or a parent selector; use the semantic color roles via `rgb(var(--magma-<role>))` so dark mode, named themes and high contrast keep working.\n\n```css\n.featured-action mds-button {\n --mds-button-background: rgb(var(--magma-accent-emphasis));\n --mds-button-color: rgb(var(--magma-accent-on-emphasis));\n --mds-button-radius: var(--magma-radius-lg);\n --mds-button-gap: calc(var(--spacing) * 300);\n}\n\n/* labels that are names or identifiers, shown as written: it inherits, so it reaches the\n buttons inside other components too */\n.tenant-switcher {\n --mds-button-label-transform: none;\n}\n```\n",
4475
4475
  "3. Mistakes": "Common incorrect uses of `<mds-button>`. 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/mistakes.md`](../../../../agents/mistakes.md) - they apply here too but are not repeated.\n\n#### Do Not Put HTML in the Default Slot\n\nThe default slot accepts plain text only; nested elements are stripped or break layout. Use the `label` prop for text and the dedicated props/slots for everything else.\n\n```html\n<!-- INCORRECT -->\n<mds-button>\n <span class=\"bold\">Scarica</span>\n <small>(PDF)</small>\n</mds-button>\n\n<!-- CORRECT -->\n<mds-button label=\"Scarica (PDF)\" icon=\"mi/baseline/download\" variant=\"primary\"></mds-button>\n```\n\n#### Do Not Nest `<mds-button>` Inside an Anchor\n\nWrapping the button in `<a>` creates nested interactive controls, breaks keyboard semantics, and fails accessibility audits. Use the `href` prop on the component instead - it renders the link itself.\n\n```html\n<!-- INCORRECT -->\n<a href=\"/login\">\n <mds-button label=\"Accedi\"></mds-button>\n</a>\n\n<!-- CORRECT -->\n<mds-button label=\"Accedi\" href=\"/login\"></mds-button>\n```\n\n#### Do Not Use `mds-button` for a Link Inside a Sentence\n\n`mds-button` is a block-level control with its own typography and padding: inside a sentence it breaks the line and the font. A word or a phrase that links belongs to `<mds-link>`, which takes the font of the text around it.\n\n```html\n<!-- INCORRECT -->\n<mds-text typography=\"paragraph\">\n Leggi l'<mds-button href=\"/privacy\" tone=\"text\" label=\"informativa\"></mds-button> prima di continuare.\n</mds-text>\n\n<!-- CORRECT -->\n<mds-text typography=\"paragraph\">\n Leggi l'<mds-link href=\"/privacy\">informativa</mds-link> prima di continuare.\n</mds-text>\n```\n\n#### Do Not Follow the `href` Yourself in a Click Listener\n\nWith `href` set the component already renders a link the browser follows. Assigning `window.location` in a click listener loads the page a second time and takes a modifier click, which the browser would open in a new tab, into the current one. Either let the browser follow the link, or cancel the click and route on the client.\n\n```js\n// INCORRECT\nbutton.addEventListener('click', () => {\n window.location.href = button.href;\n});\n\n// CORRECT: a client-side router cancels the click and routes\nbutton.addEventListener('click', (event) => {\n if (event.ctrlKey || event.metaKey || event.shiftKey || event.altKey) return;\n event.preventDefault();\n router.navigate(button.href);\n});\n```\n\n#### Icon-Only Buttons Without an Accessible Name\n\nWhen `label` is empty, the component derives a `title` from the last segment of the icon slug (\"delete\"), which names the icon, not the action. Always supply an explicit `aria-label` (or `title`) for icon-only buttons, or an `mds-tooltip` with `relation=\"label\"`.\n\n```html\n<!-- INCORRECT -->\n<mds-button icon=\"mi/baseline/delete\" variant=\"error\" tone=\"text\"></mds-button>\n\n<!-- CORRECT -->\n<mds-button\n icon=\"mi/baseline/delete\"\n aria-label=\"Elimina elemento\"\n variant=\"error\"\n tone=\"text\"\n></mds-button>\n```\n\n#### Do Not Build the Form Data Without the Submitter\n\n`new FormData(form)` leaves out the `name` / `value` of the button that submitted the form, as it does for a native submit button. Pass `event.submitter` to read which action was chosen; do not track the clicked button in a variable or a hidden input.\n\n```js\n// INCORRECT: action is missing\nform.addEventListener('submit', (event) => {\n event.preventDefault();\n const data = new FormData(form);\n});\n\n// CORRECT\nform.addEventListener('submit', (event) => {\n event.preventDefault();\n const data = new FormData(form, event.submitter);\n});\n```\n\n#### Do Not Slot `<mds-icon>` to Add an Icon\n\nThe component's `icon` prop renders the SVG through the shared icon-set service and positions it correctly via `icon-position`. Slotting `<mds-icon>` puts it in the text-only default slot, where it is stripped or misaligned.\n\n```html\n<!-- INCORRECT -->\n<mds-button>\n <mds-icon name=\"mi/baseline/add\"></mds-icon>\n Aggiungi\n</mds-button>\n\n<!-- CORRECT -->\n<mds-button label=\"Aggiungi\" icon=\"mi/baseline/add\" variant=\"primary\" tone=\"weak\"></mds-button>\n```\n\n#### Do Not Mark the Current Button by Hand, Nor Disable It\n\nThe button of the view you are in takes `current`. A tone switched by hand with `aria-current` gives every product its own look (and `tone=\"weak\"` alone stays under the 3:1 of a state), `active` is the pressed look and is cleared when the pointer is released, and `disabled` takes the button out of the Tab order and announces it as unavailable, so the keyboard never learns where it is.\n\n```html\n<!-- INCORRECT -->\n<mds-button href=\"/pratiche\" variant=\"dark\" tone=\"weak\" aria-current=\"page\">Pratiche</mds-button>\n<mds-button href=\"/pratiche\" variant=\"dark\" tone=\"text\" active>Pratiche</mds-button>\n<mds-button href=\"/pratiche\" variant=\"dark\" tone=\"text\" disabled>Pratiche</mds-button>\n\n<!-- CORRECT -->\n<mds-button href=\"/pratiche\" variant=\"dark\" tone=\"text\" current>Pratiche</mds-button>\n```\n\n#### Do Not Swap the Icon by Hand\n\nA listener that changes `icon` under the pointer fetches the new icon the first time it comes, so the button shows no icon until it arrives, and leaves it on what a finger tapped. A slug built at runtime is never served: the icons a product serves are the ones written in its sources. Use `icon-current` and `icon-hover`, with the slugs written out whole.\n\n```js\n// INCORRECT\nbutton.addEventListener('mouseenter', () => (button.icon = 'mi/baseline/folder'));\nbutton.addEventListener('mouseleave', () => (button.icon = 'mi/outline/folder'));\nbutton.icon = `mi/${here ? 'baseline' : 'outline'}/folder`;\n```\n\n```html\n<!-- CORRECT -->\n<mds-button\n href=\"/pratiche\"\n icon=\"mi/outline/folder\"\n icon-current=\"mi/baseline/folder\"\n current\n>Pratiche</mds-button>\n```\n\n#### Do Not Use Legacy `ghost` or `quiet` Tone Values\n\n`tone=\"ghost\"` and `tone=\"quiet\"` were renamed in Magma 2.0 to `outline` and `text`. The old values are no longer accepted by the typed `ToneBoxVariantType` and silently fall back to the default tone.\n\n```html\n<!-- INCORRECT (Magma 1.x naming) -->\n<mds-button label=\"Modifica\" tone=\"ghost\" variant=\"primary\"></mds-button>\n<mds-button label=\"Annulla\" tone=\"quiet\" variant=\"error\"></mds-button>\n\n<!-- CORRECT (Magma 2.x) -->\n<mds-button label=\"Modifica\" tone=\"outline\" variant=\"primary\"></mds-button>\n<mds-button label=\"Annulla\" tone=\"text\" variant=\"error\"></mds-button>\n```\n\n#### Customize via Documented Vars and Parts, Not Internal Selectors\n\nThe supported customization surface is `--mds-button-*` CSS custom properties plus the two documented shadow parts (`icon`, `label`). Targeting other internals via `::part()`, `>>>`, or undocumented class names couples your code to the Shadow DOM implementation and will break on minor releases.\n\n```css\n/* INCORRECT */\nmds-button >>> .text {\n font-weight: bold;\n}\nmds-button::part(spinner) {\n color: red;\n}\n\n/* CORRECT */\nmds-button {\n --mds-button-color: rgb(var(--magma-accent-on-emphasis));\n --mds-button-radius: var(--magma-radius-lg);\n}\nmds-button::part(icon) {\n fill: rgb(var(--magma-warning-fg));\n}\n```\n"
4476
4476
  },
4477
4477
  "props": [
@@ -4658,6 +4658,35 @@
4658
4658
  "getter": false,
4659
4659
  "setter": false
4660
4660
  },
4661
+ {
4662
+ "name": "download",
4663
+ "type": "boolean | string | undefined",
4664
+ "complexType": {
4665
+ "original": "boolean | string",
4666
+ "resolved": "boolean | string | undefined",
4667
+ "references": {}
4668
+ },
4669
+ "mutable": false,
4670
+ "attr": "download",
4671
+ "reflectToAttr": false,
4672
+ "docs": "With `href`, saves its file instead of opening it, as the `download` attribute of `<a>`:\npresent with no value, or `true`, the file takes the name the server gives it; a string is\nthe name of the saved file. Browsers apply it to the URLs of the origin of the page, `blob:`\nand `data:`: a link to another origin opens the file as without it. A download never goes to\nthe router registered with `NavigationService`",
4673
+ "docsTags": [],
4674
+ "values": [
4675
+ {
4676
+ "type": "boolean"
4677
+ },
4678
+ {
4679
+ "type": "string"
4680
+ },
4681
+ {
4682
+ "type": "undefined"
4683
+ }
4684
+ ],
4685
+ "optional": true,
4686
+ "required": false,
4687
+ "getter": false,
4688
+ "setter": false
4689
+ },
4661
4690
  {
4662
4691
  "name": "href",
4663
4692
  "type": "string | undefined",
@@ -5502,9 +5531,9 @@
5502
5531
  }
5503
5532
  ],
5504
5533
  "usage": {
5505
- "1. Description": "The `<mds-button-dropdown>` web component is a split-button control of the Magma Design System: it pairs a primary `<mds-button>` action with a secondary chevron button that opens an attached `<mds-dropdown>`, giving users a default action plus a menu of related choices in a single, visually unified control.\n\n#### Semantic Behavior\n\n- **Default slot is the menu**: Whatever you place in the default slot becomes the dropdown panel content; it is not treated as the button label (the visible label comes from the `label` prop).\n- **Chevron trigger**: The second button is icon-only (chevron), named in the page language (the `lang` of `<html>`) (\"More actions\"), and toggles the dropdown; it carries `aria-haspopup` and `aria-expanded` for the menu it opens.\n- **Shared configuration**: `active`, `await`, `disabled`, `size`, `tone` and `variant` are forwarded identically to both internal buttons, so the two halves always stay visually and behaviorally in sync. `href`, `target` and `autoFocus` belong to the primary action alone: the chevron only opens the menu.\n- **Current state**: `current` marks the primary action as the one that leads to the view you are in, as on `<mds-button>`. Both halves take the look of the current button; only the primary action is announced with `aria-current` and, with `current` (or `current=\"page\"`), neither navigates, nor submits, nor fires `mdsButtonDropdownClick`. With `current=\"section\"`, a view inside it, the primary action stays a link back. The chevron keeps opening the menu either way. A menu item that leads to the view you are in takes `current` itself.\n- **Form association**: The host is form-associated. With `type=\"submit\"` the primary action submits the enclosing `<form>` (or the one its `form` attribute names) and sends `name=value`, like a native submit button; with `type=\"reset\"` it resets it. The chevron never submits. Unlike `<mds-button>`, `type` defaults to `'button'`: a dropdown in a form submits it only when asked. The menu items are slotted `<mds-button>`, so they follow their own `type` (default `'submit'`), `name` and `value`, and the receiver tells all the actions apart by `name`.\n- **Disabled / await states**: Because these flags pass through to both buttons, disabling or putting the control in an awaiting state affects the action and the trigger together. A disabled `<fieldset>` around the component disables both halves the same way, without setting `disabled`.\n- **Primary action event**: `mdsButtonDropdownClick` fires when the primary action is clicked or activated from the keyboard, and not while the component is `disabled` or awaiting. The chevron and the menu items do not fire it. A native `click` listener on the component also runs for the menu items, whose clicks bubble to it, so listen for `mdsButtonDropdownClick` to run the primary action in JavaScript.\n- **Dropdown part**: The internal dropdown is exposed as the `dropdown` shadow part for external styling of the menu surface.\n- **Corners**: The two halves take their outer corners from the host, the radius of `--mds-button-dropdown-radius`, and meet with flat inner corners. A row that joins the component flattens its corners on the host: in an `<mds-button-group>` the side that touches the next member is flat, on the primary action or on the chevron.\n- **Width**: The component keeps its own width, its primary action as wide as an `<mds-button>` with the same label. A row that stretches it, as `actions/stacked` does under `--magma-container-actions` (380px) in `<mds-card-footer>`, `<mds-banner>`, `<mds-status-bar>` or a row of your own (`align-self: stretch`, a `width`, a `flex-basis`), gives the free width to the primary action, its label in the middle, and keeps the chevron at its own size at the end: the two halves still read as one button, with no fill past them.\n\n#### Properties & Visual Configurations\n\nThe shared `variant` / `tone` / `size` ladders are defined in [`agents/variants.md`](../../../../agents/variants.md); they apply here as in `<mds-button>`, narrowed to `tone` `strong` / `weak` and without the `google` / `apple` variants, and are forwarded to both internal buttons. `variant` defaults to `'primary'`, `tone` defaults to `'strong'`, and `size` defaults to `'md'`.\n\n- **`label`** sets the text of the primary action button only; the chevron trigger is icon-only.\n- **`type`** (default `'button'`), **`name`** and **`value`** apply to the primary action only, as described under Form association. The menu items follow their own `type`: inside a `<form>`, give `type=\"button\"` to the ones that must not submit it.\n- **`href`** makes the primary action a link that navigates instead of submitting, with `target` choosing `'self'` vs `'blank'`; the chevron still opens the menu.\n\n#### Other behavioral props\n\n- **`autoFocus`** focuses the primary action once the component is loaded.\n- **`icon`** is an SVG filename slug from the Magma icon library, applied to the primary action button (the chevron icon on the trigger is fixed and not configurable).\n- **`iconCurrent`** and **`iconHover`** take the place of `icon` on the primary action, when it is current and under the pointer, as on `<mds-button>`: `iconHover` falls back on `iconCurrent`, and both need `icon`. The chevron keeps its arrow.\n- **`truncate`** sets how the label of the primary action truncates, as on `mds-button` (default `'word'`).\n",
5506
- "2. Examples": "Correct and idiomatic ways to use the `<mds-button-dropdown>` component, ordered from most common to most specialized. The examples assume a working knowledge of the variant / tone ladders documented in [`agents/variants.md`](../../../../agents/variants.md) and the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Basic Split Button with Menu Items\n\nThe canonical form: a `label` prop for the primary action and one or more [`mds-button`](../mds-button/AGENTS.md) elements in the default slot as menu choices. Give the slot items `variant=\"dark\" tone=\"text\"` to keep them visually neutral inside the dropdown panel.\n\n```html\n<mds-button-dropdown label=\"Salva come bozza\" variant=\"success\" tone=\"weak\">\n <mds-button icon=\"mi/baseline/send\" variant=\"dark\" tone=\"text\" label=\"Invia subito\"></mds-button>\n <mds-button icon=\"mi/baseline/delete\" variant=\"dark\" tone=\"text\" label=\"Elimina\"></mds-button>\n</mds-button-dropdown>\n```\n\n#### Variant and Tone for Emphasis\n\nUse `variant` to express meaning and `tone` to express weight - the same pair applies to both internal buttons automatically.\n\n```html\n<!-- High emphasis: primary action -->\n<mds-button-dropdown label=\"Pubblica\" variant=\"primary\" tone=\"strong\">\n <mds-button variant=\"dark\" tone=\"text\" label=\"Pubblica come bozza\"></mds-button>\n <mds-button variant=\"dark\" tone=\"text\" label=\"Pianifica pubblicazione\"></mds-button>\n</mds-button-dropdown>\n\n<!-- Status emphasis: destructive action group -->\n<mds-button-dropdown label=\"Elimina voce\" variant=\"error\" tone=\"weak\">\n <mds-button variant=\"dark\" tone=\"text\" label=\"Elimina e archivia\"></mds-button>\n <mds-button variant=\"dark\" tone=\"text\" label=\"Annulla eliminazione\"></mds-button>\n</mds-button-dropdown>\n```\n\n#### Sizing\n\nUse the `size` prop. Both internal buttons track it automatically.\n\n```html\n<mds-button-dropdown label=\"Azione\" size=\"sm\" variant=\"primary\" tone=\"strong\">\n <mds-button variant=\"dark\" tone=\"text\" label=\"Opzione A\"></mds-button>\n</mds-button-dropdown>\n\n<mds-button-dropdown label=\"Azione\" size=\"md\" variant=\"primary\" tone=\"strong\">\n <mds-button variant=\"dark\" tone=\"text\" label=\"Opzione A\"></mds-button>\n</mds-button-dropdown>\n\n<mds-button-dropdown label=\"Azione\" size=\"lg\" variant=\"primary\" tone=\"strong\">\n <mds-button variant=\"dark\" tone=\"text\" label=\"Opzione A\"></mds-button>\n</mds-button-dropdown>\n\n<mds-button-dropdown label=\"Azione\" size=\"xl\" variant=\"primary\" tone=\"strong\">\n <mds-button variant=\"dark\" tone=\"text\" label=\"Opzione A\"></mds-button>\n</mds-button-dropdown>\n```\n\n#### Primary Action with an Icon\n\nSupply the `icon` prop to add an icon to the primary action button. The chevron trigger icon is fixed and not configurable.\n\n```html\n<mds-button-dropdown\n label=\"Carica documento\"\n icon=\"mi/baseline/upload\"\n variant=\"primary\"\n tone=\"weak\"\n>\n <mds-button variant=\"dark\" tone=\"text\" label=\"Carica da URL\"></mds-button>\n <mds-button variant=\"dark\" tone=\"text\" label=\"Carica da Drive\"></mds-button>\n</mds-button-dropdown>\n```\n\n#### Async Loading via `await`\n\nSet the `await` boolean attribute while a request is in flight. Both the action button and the chevron trigger become unavailable simultaneously. Remove the attribute when done - do not set `await=\"false\"`.\n\n```html\n<mds-button-dropdown label=\"Salvataggio in corso...\" await variant=\"primary\" tone=\"strong\">\n <mds-button variant=\"dark\" tone=\"text\" label=\"Salva e chiudi\"></mds-button>\n <mds-button variant=\"dark\" tone=\"text\" label=\"Salva come copia\"></mds-button>\n</mds-button-dropdown>\n```\n\n#### Disabled State\n\nThe `disabled` attribute blocks both halves of the control together.\n\n```html\n<mds-button-dropdown label=\"Invia richiesta\" disabled variant=\"primary\" tone=\"strong\">\n <mds-button variant=\"dark\" tone=\"text\" label=\"Invia in bozza\"></mds-button>\n</mds-button-dropdown>\n```\n\n#### Primary Action Handled in JavaScript\n\nListen for `mdsButtonDropdownClick` to run the primary action: it comes from the primary action only, from a click or the keyboard, and not while the component is `disabled` or awaiting. Handle each menu item with its own `click`.\n\n```html\n<mds-button-dropdown id=\"save\" label=\"Salva\" variant=\"primary\">\n <mds-button id=\"save-copy\" variant=\"dark\" tone=\"text\" label=\"Salva come copia\"></mds-button>\n</mds-button-dropdown>\n\n<script>\n document.getElementById('save').addEventListener('mdsButtonDropdownClick', () => save());\n document.getElementById('save-copy').addEventListener('click', () => saveCopy());\n</script>\n```\n\n#### Several Actions That Submit One Form\n\nSet `type=\"submit\"` on the component and give the primary action and the menu items the same `name` with a different `value`: each action submits the form, and the receiver reads which one was chosen from `name`, as with native submit buttons. Give `type=\"button\"` to the menu items that must not submit.\n\n```html\n<form action=\"/mail\" method=\"post\">\n <mds-input-field label=\"Oggetto\">\n <mds-input name=\"subject\"></mds-input>\n </mds-input-field>\n\n <!-- the receiver gets action=send, action=draft or action=schedule -->\n <mds-button-dropdown type=\"submit\" name=\"action\" value=\"send\" label=\"Invia\" variant=\"primary\">\n <mds-button name=\"action\" value=\"draft\" variant=\"dark\" tone=\"text\" label=\"Salva come bozza\"></mds-button>\n <mds-button name=\"action\" value=\"schedule\" variant=\"dark\" tone=\"text\" label=\"Invio programmato\"></mds-button>\n <mds-button type=\"button\" variant=\"dark\" tone=\"text\" label=\"Anteprima\"></mds-button>\n </mds-button-dropdown>\n</form>\n```\n\nWhen your code handles the submit, build the form data with `event.submitter`, as for [`mds-button`](../mds-button/AGENTS.md): `new FormData(form, event.submitter)`.\n\n#### Hyperlink Split Button via `href`\n\n`href` and `target` on the component make the primary action a link; the chevron keeps opening the menu. Put the other links on the menu items (`target=\"blank\"` opens them in a new tab).\n\n```html\n<mds-button-dropdown\n label=\"Apri documento\"\n href=\"https://example.com/doc\"\n variant=\"primary\"\n tone=\"weak\"\n>\n <mds-button href=\"https://example.com/doc/edit\" target=\"blank\" variant=\"dark\" tone=\"text\" label=\"Modifica\"></mds-button>\n <mds-button href=\"https://example.com/doc/history\" target=\"blank\" variant=\"dark\" tone=\"text\" label=\"Cronologia\"></mds-button>\n</mds-button-dropdown>\n```\n\n#### In a Row of Actions That Stacks\n\nStretch the component as any other action of the row: under `--magma-container-actions` of its container (`@max-actions:`), `actions/stacked` puts every labelled button at the full width, and the component gives that width to its primary action, the chevron staying at the end. No part or custom property is needed.\n\n```html\n<div class=\"@container\">\n <div class=\"flex justify-end gap-inline @max-actions:flex-col @max-actions:*:self-stretch\">\n <mds-button variant=\"dark\" tone=\"outline\" label=\"Copia JSON\"></mds-button>\n <mds-button-dropdown label=\"Scarica\" icon=\"mi/baseline/download\">\n <mds-button variant=\"dark\" tone=\"text\" label=\"Scarica come CSS\"></mds-button>\n <mds-button variant=\"dark\" tone=\"text\" label=\"Scarica come JSON\"></mds-button>\n </mds-button-dropdown>\n </div>\n</div>\n```\n\n#### Styling Customization\n\nStyle the component through its documented `--mds-button-dropdown-*` CSS custom properties or the `dropdown` shadow part. Use the semantic color roles via `rgb(var(--magma-<role>))` so dark mode and named themes keep working.\n\nThe `--mds-button-*` properties that inherit reach the two inner buttons too: `--mds-button-label-transform: none` on the component keeps a label such as a tenant name as written, without the uppercase first letter.\n\n```css\n.custom-toolbar mds-button-dropdown {\n --mds-button-dropdown-radius: var(--magma-radius-md);\n}\n\n.tenant-switcher mds-button-dropdown {\n --mds-button-label-transform: none;\n}\n\n/* Style the dropdown panel surface through the documented shadow part */\n.custom-toolbar mds-button-dropdown::part(dropdown) {\n box-shadow: var(--shadow-lg);\n}\n```\n",
5507
- "3. Mistakes": "Common incorrect uses of `<mds-button-dropdown>`. 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/mistakes.md`](../../../../agents/mistakes.md) - they apply here too but are not repeated.\n\n#### Do Not Put the Label in the Default Slot\n\nThe default slot feeds the `<mds-dropdown>` panel, not the button label. Text placed in the slot ends up as menu content, not as the button's visible text. Use the `label` prop.\n\n```html\n<!-- INCORRECT -->\n<mds-button-dropdown variant=\"primary\" tone=\"strong\">\n Salva\n</mds-button-dropdown>\n\n<!-- CORRECT -->\n<mds-button-dropdown label=\"Salva\" variant=\"primary\" tone=\"strong\">\n <mds-button variant=\"dark\" tone=\"text\" label=\"Salva come bozza\"></mds-button>\n</mds-button-dropdown>\n```\n\n#### Do Not Slot Non-Button Content as Menu Items\n\nThe dropdown panel is designed for [`mds-button`](../mds-button/AGENTS.md) elements. Slotting raw `<button>`, `<a>`, or arbitrary HTML bypasses the Magma theming, focus styles and button API (`icon`, `await`, `disabled`) of the menu entries.\n\n```html\n<!-- INCORRECT -->\n<mds-button-dropdown label=\"Esporta\" variant=\"primary\" tone=\"weak\">\n <button onclick=\"exportPDF()\">PDF</button>\n <a href=\"/export/csv\">CSV</a>\n</mds-button-dropdown>\n\n<!-- CORRECT -->\n<mds-button-dropdown label=\"Esporta\" variant=\"primary\" tone=\"weak\">\n <mds-button variant=\"dark\" tone=\"text\" label=\"Esporta PDF\" icon=\"mi/baseline/picture-as-pdf\"></mds-button>\n <mds-button variant=\"dark\" tone=\"text\" label=\"Esporta CSV\" icon=\"mi/baseline/table-chart\"></mds-button>\n</mds-button-dropdown>\n```\n\n#### Do Not Count on the Default `type` to Submit a Form\n\nUnlike `<mds-button>`, the component defaults to `type=\"button\"`: inside a form, the primary action submits nothing until you set `type=\"submit\"`.\n\n```html\n<!-- INCORRECT: the primary action does not submit -->\n<form action=\"/mail\" method=\"post\">\n <mds-button-dropdown name=\"action\" value=\"send\" label=\"Invia\">\n <mds-button name=\"action\" value=\"draft\" variant=\"dark\" tone=\"text\" label=\"Salva come bozza\"></mds-button>\n </mds-button-dropdown>\n</form>\n\n<!-- CORRECT -->\n<form action=\"/mail\" method=\"post\">\n <mds-button-dropdown type=\"submit\" name=\"action\" value=\"send\" label=\"Invia\">\n <mds-button name=\"action\" value=\"draft\" variant=\"dark\" tone=\"text\" label=\"Salva come bozza\"></mds-button>\n </mds-button-dropdown>\n</form>\n```\n\n#### Do Not Submit the Form from a `click` Listener\n\nA `click` listener on the component also runs for the menu items, whose clicks bubble to it: picking a menu item that submits (\"Salva come bozza\") submits the form twice, once with its `name` / `value` and once without, and the receiver cannot tell which action was chosen. Use `type=\"submit\"` with `name` / `value`.\n\n```html\n<!-- INCORRECT -->\n<mds-button-dropdown id=\"send\" label=\"Invia\"></mds-button-dropdown>\n<script>\n document.getElementById('send').addEventListener('click', () => form.requestSubmit());\n</script>\n\n<!-- CORRECT -->\n<mds-button-dropdown type=\"submit\" name=\"action\" value=\"send\" label=\"Invia\"></mds-button-dropdown>\n```\n\n#### Do Not Listen to `click` for the Primary Action\n\nA `click` on the component also comes from the menu items, whose clicks bubble to it: the primary action would run whenever the user picks an entry of the menu. Listen for `mdsButtonDropdownClick`, which only the primary action emits.\n\n```js\n// INCORRECT: also runs for \"Salva come copia\"\ndropdown.addEventListener('click', () => save());\n\n// CORRECT\ndropdown.addEventListener('mdsButtonDropdownClick', () => save());\n```\n\n#### Do Not Leave a Menu Item That Must Not Submit on the Default `type`\n\nThe menu items are slotted `<mds-button>`, whose `type` defaults to `'submit'`: inside a form, an item that runs your own code (a preview, a copy) submits the form too. Give it `type=\"button\"`.\n\n```html\n<!-- INCORRECT: \"Anteprima\" submits the form -->\n<mds-button-dropdown type=\"submit\" name=\"action\" value=\"send\" label=\"Invia\">\n <mds-button variant=\"dark\" tone=\"text\" label=\"Anteprima\"></mds-button>\n</mds-button-dropdown>\n\n<!-- CORRECT -->\n<mds-button-dropdown type=\"submit\" name=\"action\" value=\"send\" label=\"Invia\">\n <mds-button type=\"button\" variant=\"dark\" tone=\"text\" label=\"Anteprima\"></mds-button>\n</mds-button-dropdown>\n```\n\n#### Do Not Use Unsupported `tone` Values\n\n`<mds-button-dropdown>` accepts `ToneMinimalVariantType`, which is `strong` and `weak` only. Passing `outline`, `text`, or `box` is not valid for this component: the value reaches the internal buttons unchecked, without the split-button styling that only `strong` and `weak` have.\n\n```html\n<!-- INCORRECT -->\n<mds-button-dropdown label=\"Azione\" variant=\"primary\" tone=\"outline\"></mds-button-dropdown>\n<mds-button-dropdown label=\"Azione\" variant=\"primary\" tone=\"text\"></mds-button-dropdown>\n\n<!-- CORRECT -->\n<mds-button-dropdown label=\"Azione\" variant=\"primary\" tone=\"strong\">\n <mds-button variant=\"dark\" tone=\"text\" label=\"Opzione\"></mds-button>\n</mds-button-dropdown>\n<mds-button-dropdown label=\"Azione\" variant=\"primary\" tone=\"weak\">\n <mds-button variant=\"dark\" tone=\"text\" label=\"Opzione\"></mds-button>\n</mds-button-dropdown>\n```\n\n#### Do Not Try to Customize the Chevron Icon\n\nThe chevron trigger icon is internal and fixed. There is no prop to change it. Do not attempt to override it with CSS property hacks or shadow-DOM selectors.\n\n```css\n/* INCORRECT */\nmds-button-dropdown .dropdown-action mds-icon {\n content: url('custom-arrow.svg');\n}\n\n/* CORRECT - style only through documented custom properties and the dropdown part */\nmds-button-dropdown {\n --mds-button-dropdown-radius: var(--magma-radius-md);\n}\nmds-button-dropdown::part(dropdown) {\n box-shadow: var(--shadow-lg);\n}\n```\n\n#### Do Not Set Boolean Attributes to `\"false\"`\n\n`await`, `disabled`, and `active` are boolean attributes and `mds-button-dropdown` is form-associated: as on a native control, any value turns them on, `\"false\"` included, so this markup renders a disabled button that is waiting. Remove the attribute to turn it off.\n\n```html\n<!-- INCORRECT -->\n<mds-button-dropdown label=\"Invia\" await=\"false\" disabled=\"false\" variant=\"primary\"></mds-button-dropdown>\n\n<!-- CORRECT -->\n<mds-button-dropdown label=\"Invia\" variant=\"primary\" tone=\"strong\">\n <mds-button variant=\"dark\" tone=\"text\" label=\"Invia come bozza\"></mds-button>\n</mds-button-dropdown>\n```\n"
5534
+ "1. Description": "The `<mds-button-dropdown>` web component is a split-button control of the Magma Design System: it pairs a primary `<mds-button>` action with a secondary chevron button that opens an attached `<mds-dropdown>`, giving users a default action plus a menu of related choices in a single, visually unified control.\n\n#### Semantic Behavior\n\n- **Default slot is the menu**: Whatever you place in the default slot becomes the dropdown panel content; it is not treated as the button label (the visible label comes from the `label` prop).\n- **Chevron trigger**: The second button is icon-only (chevron) and toggles the dropdown; it carries `aria-haspopup` and `aria-expanded` for the menu it opens. It is named in the page language (the `lang` of `<html>`) after the label (\"More actions for Export\", or \"More actions\" without a label), so two split buttons of one page name their chevrons apart; `dropdown-label` gives it a name of the page's instead.\n- **Shared configuration**: `active`, `disabled`, `size`, `tone` and `variant` are forwarded identically to both internal buttons, so the two halves always stay visually and behaviorally in sync. `await` belongs to the primary action, the one in progress. `href`, `target` and `autoFocus` belong to the primary action alone: the chevron only opens the menu.\n- **Current state**: `current` marks the primary action as the one that leads to the view you are in, as on `<mds-button>`. Both halves take the look of the current button; only the primary action is announced with `aria-current` and, with `current` (or `current=\"page\"`), neither navigates, nor submits, nor fires `mdsButtonDropdownClick`. With `current=\"section\"`, a view inside it, the primary action stays a link back. The chevron keeps opening the menu either way. A menu item that leads to the view you are in takes `current` itself.\n- **Form association**: The host is form-associated. With `type=\"submit\"` the primary action submits the enclosing `<form>` (or the one its `form` attribute names) and sends `name=value`, like a native submit button; with `type=\"reset\"` it resets it. The chevron never submits. Unlike `<mds-button>`, `type` defaults to `'button'`: a dropdown in a form submits it only when asked. The menu items are slotted `<mds-button>`, so they follow their own `type` (default `'submit'`), `name` and `value`, and the receiver tells all the actions apart by `name`.\n- **Disabled / await states**: `disabled` passes through to both buttons, so it disables the action and the trigger together; a disabled `<fieldset>` around the component disables both halves the same way, without setting `disabled`. `await` shows one spinner, on the primary action, which alone is announced as busy; the chevron keeps its arrow and is disabled until the component stops awaiting, so the menu does not open meanwhile.\n- **Primary action event**: `mdsButtonDropdownClick` fires when the primary action is clicked or activated from the keyboard, and not while the component is `disabled` or awaiting. The chevron and the menu items do not fire it. A native `click` listener on the component also runs for the menu items, whose clicks bubble to it, so listen for `mdsButtonDropdownClick` to run the primary action in JavaScript.\n- **Dropdown part**: The internal dropdown is exposed as the `dropdown` shadow part for external styling of the menu surface.\n- **Corners**: The two halves take their outer corners from the host, the radius of `--mds-button-dropdown-radius`, and meet with flat inner corners. A row that joins the component flattens its corners on the host: in an `<mds-button-group>` the side that touches the next member is flat, on the primary action or on the chevron.\n- **Width**: The component keeps its own width, its primary action as wide as an `<mds-button>` with the same label. A row that stretches it, as `actions/stacked` does under `--magma-container-actions` (380px) in `<mds-card-footer>`, `<mds-banner>`, `<mds-status-bar>` or a row of your own (`align-self: stretch`, a `width`, a `flex-basis`), gives the free width to the primary action, its label in the middle, and keeps the chevron at its own size at the end: the two halves still read as one button, with no fill past them.\n\n#### Properties & Visual Configurations\n\nThe shared `variant` / `tone` / `size` ladders are defined in [`agents/variants.md`](../../../../agents/variants.md); they apply here as in `<mds-button>`, narrowed to `tone` `strong` / `weak` and without the `google` / `apple` variants, and are forwarded to both internal buttons. `variant` defaults to `'primary'`, `tone` defaults to `'strong'`, and `size` defaults to `'md'`.\n\n- **`label`** sets the text of the primary action button only; the chevron trigger is icon-only.\n- **`type`** (default `'button'`), **`name`** and **`value`** apply to the primary action only, as described under Form association. The menu items follow their own `type`: inside a `<form>`, give `type=\"button\"` to the ones that must not submit it.\n- **`href`** makes the primary action a link that navigates instead of submitting, with `target` choosing `'self'` vs `'blank'`; the chevron still opens the menu.\n\n#### Other behavioral props\n\n- **`autoFocus`** focuses the primary action once the component is loaded.\n- **`icon`** is an SVG filename slug from the Magma icon library, applied to the primary action button (the chevron icon on the trigger is fixed and not configurable).\n- **`iconCurrent`** and **`iconHover`** take the place of `icon` on the primary action, when it is current and under the pointer, as on `<mds-button>`: `iconHover` falls back on `iconCurrent`, and both need `icon`. The chevron keeps its arrow.\n- **`truncate`** sets how the label of the primary action truncates, as on `mds-button` (default `'word'`).\n",
5535
+ "2. Examples": "Correct and idiomatic ways to use the `<mds-button-dropdown>` component, ordered from most common to most specialized. The examples assume a working knowledge of the variant / tone ladders documented in [`agents/variants.md`](../../../../agents/variants.md) and the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Basic Split Button with Menu Items\n\nThe canonical form: a `label` prop for the primary action and one or more [`mds-button`](../mds-button/AGENTS.md) elements in the default slot as menu choices. Give the slot items `variant=\"dark\" tone=\"text\"` to keep them visually neutral inside the dropdown panel.\n\n```html\n<mds-button-dropdown label=\"Salva come bozza\" variant=\"success\" tone=\"weak\">\n <mds-button icon=\"mi/baseline/send\" variant=\"dark\" tone=\"text\" label=\"Invia subito\"></mds-button>\n <mds-button icon=\"mi/baseline/delete\" variant=\"dark\" tone=\"text\" label=\"Elimina\"></mds-button>\n</mds-button-dropdown>\n```\n\n#### Variant and Tone for Emphasis\n\nUse `variant` to express meaning and `tone` to express weight - the same pair applies to both internal buttons automatically.\n\n```html\n<!-- High emphasis: primary action -->\n<mds-button-dropdown label=\"Pubblica\" variant=\"primary\" tone=\"strong\">\n <mds-button variant=\"dark\" tone=\"text\" label=\"Pubblica come bozza\"></mds-button>\n <mds-button variant=\"dark\" tone=\"text\" label=\"Pianifica pubblicazione\"></mds-button>\n</mds-button-dropdown>\n\n<!-- Status emphasis: destructive action group -->\n<mds-button-dropdown label=\"Elimina voce\" variant=\"error\" tone=\"weak\">\n <mds-button variant=\"dark\" tone=\"text\" label=\"Elimina e archivia\"></mds-button>\n <mds-button variant=\"dark\" tone=\"text\" label=\"Annulla eliminazione\"></mds-button>\n</mds-button-dropdown>\n```\n\n#### Sizing\n\nUse the `size` prop. Both internal buttons track it automatically.\n\n```html\n<mds-button-dropdown label=\"Azione\" size=\"sm\" variant=\"primary\" tone=\"strong\">\n <mds-button variant=\"dark\" tone=\"text\" label=\"Opzione A\"></mds-button>\n</mds-button-dropdown>\n\n<mds-button-dropdown label=\"Azione\" size=\"md\" variant=\"primary\" tone=\"strong\">\n <mds-button variant=\"dark\" tone=\"text\" label=\"Opzione A\"></mds-button>\n</mds-button-dropdown>\n\n<mds-button-dropdown label=\"Azione\" size=\"lg\" variant=\"primary\" tone=\"strong\">\n <mds-button variant=\"dark\" tone=\"text\" label=\"Opzione A\"></mds-button>\n</mds-button-dropdown>\n\n<mds-button-dropdown label=\"Azione\" size=\"xl\" variant=\"primary\" tone=\"strong\">\n <mds-button variant=\"dark\" tone=\"text\" label=\"Opzione A\"></mds-button>\n</mds-button-dropdown>\n```\n\n#### Primary Action with an Icon\n\nSupply the `icon` prop to add an icon to the primary action button. The chevron trigger icon is fixed and not configurable.\n\n```html\n<mds-button-dropdown\n label=\"Carica documento\"\n icon=\"mi/baseline/upload\"\n variant=\"primary\"\n tone=\"weak\"\n>\n <mds-button variant=\"dark\" tone=\"text\" label=\"Carica da URL\"></mds-button>\n <mds-button variant=\"dark\" tone=\"text\" label=\"Carica da Drive\"></mds-button>\n</mds-button-dropdown>\n```\n\n#### Naming the Chevron\n\nThe chevron is named after the label in the language of the page (\"Altre azioni per Esporta\" on an Italian page), so two split buttons of one page are told apart by a screen reader. Set `dropdown-label` when the menu deserves a name of its own.\n\n```html\n<mds-button-dropdown label=\"Esporta\" dropdown-label=\"Formati di esportazione\">\n <mds-button variant=\"dark\" tone=\"text\" label=\"PDF\"></mds-button>\n <mds-button variant=\"dark\" tone=\"text\" label=\"CSV\"></mds-button>\n</mds-button-dropdown>\n```\n\n#### Async Loading via `await`\n\nSet the `await` boolean attribute while a request is in flight. The primary action shows the spinner and is announced as busy; the chevron keeps its arrow and is disabled, so the menu does not open until the request ends. Remove the attribute when done - do not set `await=\"false\"`.\n\n```html\n<mds-button-dropdown label=\"Salvataggio in corso...\" await variant=\"primary\" tone=\"strong\">\n <mds-button variant=\"dark\" tone=\"text\" label=\"Salva e chiudi\"></mds-button>\n <mds-button variant=\"dark\" tone=\"text\" label=\"Salva come copia\"></mds-button>\n</mds-button-dropdown>\n```\n\n#### Disabled State\n\nThe `disabled` attribute blocks both halves of the control together.\n\n```html\n<mds-button-dropdown label=\"Invia richiesta\" disabled variant=\"primary\" tone=\"strong\">\n <mds-button variant=\"dark\" tone=\"text\" label=\"Invia in bozza\"></mds-button>\n</mds-button-dropdown>\n```\n\n#### Primary Action Handled in JavaScript\n\nListen for `mdsButtonDropdownClick` to run the primary action: it comes from the primary action only, from a click or the keyboard, and not while the component is `disabled` or awaiting. Handle each menu item with its own `click`.\n\n```html\n<mds-button-dropdown id=\"save\" label=\"Salva\" variant=\"primary\">\n <mds-button id=\"save-copy\" variant=\"dark\" tone=\"text\" label=\"Salva come copia\"></mds-button>\n</mds-button-dropdown>\n\n<script>\n document.getElementById('save').addEventListener('mdsButtonDropdownClick', () => save());\n document.getElementById('save-copy').addEventListener('click', () => saveCopy());\n</script>\n```\n\n#### Several Actions That Submit One Form\n\nSet `type=\"submit\"` on the component and give the primary action and the menu items the same `name` with a different `value`: each action submits the form, and the receiver reads which one was chosen from `name`, as with native submit buttons. Give `type=\"button\"` to the menu items that must not submit.\n\n```html\n<form action=\"/mail\" method=\"post\">\n <mds-input-field label=\"Oggetto\">\n <mds-input name=\"subject\"></mds-input>\n </mds-input-field>\n\n <!-- the receiver gets action=send, action=draft or action=schedule -->\n <mds-button-dropdown type=\"submit\" name=\"action\" value=\"send\" label=\"Invia\" variant=\"primary\">\n <mds-button name=\"action\" value=\"draft\" variant=\"dark\" tone=\"text\" label=\"Salva come bozza\"></mds-button>\n <mds-button name=\"action\" value=\"schedule\" variant=\"dark\" tone=\"text\" label=\"Invio programmato\"></mds-button>\n <mds-button type=\"button\" variant=\"dark\" tone=\"text\" label=\"Anteprima\"></mds-button>\n </mds-button-dropdown>\n</form>\n```\n\nWhen your code handles the submit, build the form data with `event.submitter`, as for [`mds-button`](../mds-button/AGENTS.md): `new FormData(form, event.submitter)`.\n\n#### Hyperlink Split Button via `href`\n\n`href` and `target` on the component make the primary action a link; the chevron keeps opening the menu. Put the other links on the menu items (`target=\"blank\"` opens them in a new tab).\n\n```html\n<mds-button-dropdown\n label=\"Apri documento\"\n href=\"https://example.com/doc\"\n variant=\"primary\"\n tone=\"weak\"\n>\n <mds-button href=\"https://example.com/doc/edit\" target=\"blank\" variant=\"dark\" tone=\"text\" label=\"Modifica\"></mds-button>\n <mds-button href=\"https://example.com/doc/history\" target=\"blank\" variant=\"dark\" tone=\"text\" label=\"Cronologia\"></mds-button>\n</mds-button-dropdown>\n```\n\n#### In a Row of Actions That Stacks\n\nStretch the component as any other action of the row: under `--magma-container-actions` of its container (`@max-actions:`), `actions/stacked` puts every labelled button at the full width, and the component gives that width to its primary action, the chevron staying at the end. No part or custom property is needed.\n\n```html\n<div class=\"@container\">\n <div class=\"flex justify-end gap-inline @max-actions:flex-col @max-actions:*:self-stretch\">\n <mds-button variant=\"dark\" tone=\"outline\" label=\"Copia JSON\"></mds-button>\n <mds-button-dropdown label=\"Scarica\" icon=\"mi/baseline/download\">\n <mds-button variant=\"dark\" tone=\"text\" label=\"Scarica come CSS\"></mds-button>\n <mds-button variant=\"dark\" tone=\"text\" label=\"Scarica come JSON\"></mds-button>\n </mds-button-dropdown>\n </div>\n</div>\n```\n\n#### Styling Customization\n\nStyle the component through its documented `--mds-button-dropdown-*` CSS custom properties or the `dropdown` shadow part. Use the semantic color roles via `rgb(var(--magma-<role>))` so dark mode and named themes keep working.\n\nThe `--mds-button-*` properties that inherit reach the two inner buttons too: `--mds-button-label-transform: none` on the component keeps a label such as a tenant name as written, without the uppercase first letter.\n\n```css\n.custom-toolbar mds-button-dropdown {\n --mds-button-dropdown-radius: var(--magma-radius-md);\n}\n\n.tenant-switcher mds-button-dropdown {\n --mds-button-label-transform: none;\n}\n\n/* Style the dropdown panel surface through the documented shadow part */\n.custom-toolbar mds-button-dropdown::part(dropdown) {\n box-shadow: var(--shadow-lg);\n}\n```\n",
5536
+ "3. Mistakes": "Common incorrect uses of `<mds-button-dropdown>`. 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/mistakes.md`](../../../../agents/mistakes.md) - they apply here too but are not repeated.\n\n#### Do Not Put the Label in the Default Slot\n\nThe default slot feeds the `<mds-dropdown>` panel, not the button label. Text placed in the slot ends up as menu content, not as the button's visible text. Use the `label` prop.\n\n```html\n<!-- INCORRECT -->\n<mds-button-dropdown variant=\"primary\" tone=\"strong\">\n Salva\n</mds-button-dropdown>\n\n<!-- CORRECT -->\n<mds-button-dropdown label=\"Salva\" variant=\"primary\" tone=\"strong\">\n <mds-button variant=\"dark\" tone=\"text\" label=\"Salva come bozza\"></mds-button>\n</mds-button-dropdown>\n```\n\n#### Do Not Slot Non-Button Content as Menu Items\n\nThe dropdown panel is designed for [`mds-button`](../mds-button/AGENTS.md) elements. Slotting raw `<button>`, `<a>`, or arbitrary HTML bypasses the Magma theming, focus styles and button API (`icon`, `await`, `disabled`) of the menu entries.\n\n```html\n<!-- INCORRECT -->\n<mds-button-dropdown label=\"Esporta\" variant=\"primary\" tone=\"weak\">\n <button onclick=\"exportPDF()\">PDF</button>\n <a href=\"/export/csv\">CSV</a>\n</mds-button-dropdown>\n\n<!-- CORRECT -->\n<mds-button-dropdown label=\"Esporta\" variant=\"primary\" tone=\"weak\">\n <mds-button variant=\"dark\" tone=\"text\" label=\"Esporta PDF\" icon=\"mi/baseline/picture-as-pdf\"></mds-button>\n <mds-button variant=\"dark\" tone=\"text\" label=\"Esporta CSV\" icon=\"mi/baseline/table-chart\"></mds-button>\n</mds-button-dropdown>\n```\n\n#### Do Not Count on the Default `type` to Submit a Form\n\nUnlike `<mds-button>`, the component defaults to `type=\"button\"`: inside a form, the primary action submits nothing until you set `type=\"submit\"`.\n\n```html\n<!-- INCORRECT: the primary action does not submit -->\n<form action=\"/mail\" method=\"post\">\n <mds-button-dropdown name=\"action\" value=\"send\" label=\"Invia\">\n <mds-button name=\"action\" value=\"draft\" variant=\"dark\" tone=\"text\" label=\"Salva come bozza\"></mds-button>\n </mds-button-dropdown>\n</form>\n\n<!-- CORRECT -->\n<form action=\"/mail\" method=\"post\">\n <mds-button-dropdown type=\"submit\" name=\"action\" value=\"send\" label=\"Invia\">\n <mds-button name=\"action\" value=\"draft\" variant=\"dark\" tone=\"text\" label=\"Salva come bozza\"></mds-button>\n </mds-button-dropdown>\n</form>\n```\n\n#### Do Not Submit the Form from a `click` Listener\n\nA `click` listener on the component also runs for the menu items, whose clicks bubble to it: picking a menu item that submits (\"Salva come bozza\") submits the form twice, once with its `name` / `value` and once without, and the receiver cannot tell which action was chosen. Use `type=\"submit\"` with `name` / `value`.\n\n```html\n<!-- INCORRECT -->\n<mds-button-dropdown id=\"send\" label=\"Invia\"></mds-button-dropdown>\n<script>\n document.getElementById('send').addEventListener('click', () => form.requestSubmit());\n</script>\n\n<!-- CORRECT -->\n<mds-button-dropdown type=\"submit\" name=\"action\" value=\"send\" label=\"Invia\"></mds-button-dropdown>\n```\n\n#### Do Not Listen to `click` for the Primary Action\n\nA `click` on the component also comes from the menu items, whose clicks bubble to it: the primary action would run whenever the user picks an entry of the menu. Listen for `mdsButtonDropdownClick`, which only the primary action emits.\n\n```js\n// INCORRECT: also runs for \"Salva come copia\"\ndropdown.addEventListener('click', () => save());\n\n// CORRECT\ndropdown.addEventListener('mdsButtonDropdownClick', () => save());\n```\n\n#### Do Not Leave a Menu Item That Must Not Submit on the Default `type`\n\nThe menu items are slotted `<mds-button>`, whose `type` defaults to `'submit'`: inside a form, an item that runs your own code (a preview, a copy) submits the form too. Give it `type=\"button\"`.\n\n```html\n<!-- INCORRECT: \"Anteprima\" submits the form -->\n<mds-button-dropdown type=\"submit\" name=\"action\" value=\"send\" label=\"Invia\">\n <mds-button variant=\"dark\" tone=\"text\" label=\"Anteprima\"></mds-button>\n</mds-button-dropdown>\n\n<!-- CORRECT -->\n<mds-button-dropdown type=\"submit\" name=\"action\" value=\"send\" label=\"Invia\">\n <mds-button type=\"button\" variant=\"dark\" tone=\"text\" label=\"Anteprima\"></mds-button>\n</mds-button-dropdown>\n```\n\n#### Do Not Use Unsupported `tone` Values\n\n`<mds-button-dropdown>` accepts `ToneMinimalVariantType`, which is `strong` and `weak` only. Passing `outline`, `text`, or `box` is not valid for this component: the value reaches the internal buttons unchecked, without the split-button styling that only `strong` and `weak` have.\n\n```html\n<!-- INCORRECT -->\n<mds-button-dropdown label=\"Azione\" variant=\"primary\" tone=\"outline\"></mds-button-dropdown>\n<mds-button-dropdown label=\"Azione\" variant=\"primary\" tone=\"text\"></mds-button-dropdown>\n\n<!-- CORRECT -->\n<mds-button-dropdown label=\"Azione\" variant=\"primary\" tone=\"strong\">\n <mds-button variant=\"dark\" tone=\"text\" label=\"Opzione\"></mds-button>\n</mds-button-dropdown>\n<mds-button-dropdown label=\"Azione\" variant=\"primary\" tone=\"weak\">\n <mds-button variant=\"dark\" tone=\"text\" label=\"Opzione\"></mds-button>\n</mds-button-dropdown>\n```\n\n#### Do Not Try to Customize the Chevron Icon\n\nThe chevron trigger icon is internal and fixed. There is no prop to change it. Do not attempt to override it with CSS property hacks or shadow-DOM selectors.\n\n```css\n/* INCORRECT */\nmds-button-dropdown .dropdown-action mds-icon {\n content: url('custom-arrow.svg');\n}\n\n/* CORRECT - style only through documented custom properties and the dropdown part */\nmds-button-dropdown {\n --mds-button-dropdown-radius: var(--magma-radius-md);\n}\nmds-button-dropdown::part(dropdown) {\n box-shadow: var(--shadow-lg);\n}\n```\n\n#### Do Not Name the Chevron with `aria-label` on the Host\n\nThe host has no role, so an `aria-label` on it names nothing, and it never reaches the chevron inside. The chevron is already named after `label` (\"Altre azioni per Esporta\"); give it a name of your own with `dropdown-label`.\n\n```html\n<!-- INCORRECT -->\n<mds-button-dropdown label=\"Esporta\" aria-label=\"Formati di esportazione\">\n <mds-button variant=\"dark\" tone=\"text\" label=\"PDF\"></mds-button>\n</mds-button-dropdown>\n\n<!-- CORRECT -->\n<mds-button-dropdown label=\"Esporta\" dropdown-label=\"Formati di esportazione\">\n <mds-button variant=\"dark\" tone=\"text\" label=\"PDF\"></mds-button>\n</mds-button-dropdown>\n```\n\n#### Do Not Set Boolean Attributes to `\"false\"`\n\n`await`, `disabled`, and `active` are boolean attributes and `mds-button-dropdown` is form-associated: as on a native control, any value turns them on, `\"false\"` included, so this markup renders a disabled button that is waiting. Remove the attribute to turn it off.\n\n```html\n<!-- INCORRECT -->\n<mds-button-dropdown label=\"Invia\" await=\"false\" disabled=\"false\" variant=\"primary\"></mds-button-dropdown>\n\n<!-- CORRECT -->\n<mds-button-dropdown label=\"Invia\" variant=\"primary\" tone=\"strong\">\n <mds-button variant=\"dark\" tone=\"text\" label=\"Invia come bozza\"></mds-button>\n</mds-button-dropdown>\n```\n"
5508
5537
  },
5509
5538
  "props": [
5510
5539
  {
@@ -5646,6 +5675,32 @@
5646
5675
  "getter": false,
5647
5676
  "setter": false
5648
5677
  },
5678
+ {
5679
+ "name": "dropdownLabel",
5680
+ "type": "string | undefined",
5681
+ "complexType": {
5682
+ "original": "string",
5683
+ "resolved": "string | undefined",
5684
+ "references": {}
5685
+ },
5686
+ "mutable": false,
5687
+ "attr": "dropdown-label",
5688
+ "reflectToAttr": false,
5689
+ "docs": "The accessible name of the chevron, the button that opens the menu, in place of the one the\ncomponent builds in the language of the page: \"More actions for\" and `label`, or \"More\nactions\" without a label. Two split buttons of one page then name their chevrons apart",
5690
+ "docsTags": [],
5691
+ "values": [
5692
+ {
5693
+ "type": "string"
5694
+ },
5695
+ {
5696
+ "type": "undefined"
5697
+ }
5698
+ ],
5699
+ "optional": true,
5700
+ "required": false,
5701
+ "getter": false,
5702
+ "setter": false
5703
+ },
5649
5704
  {
5650
5705
  "name": "href",
5651
5706
  "type": "string | undefined",
@@ -13303,6 +13358,7 @@
13303
13358
  "mds-help",
13304
13359
  "mds-img",
13305
13360
  "mds-input",
13361
+ "mds-input-field",
13306
13362
  "mds-input-select",
13307
13363
  "mds-input-switch",
13308
13364
  "mds-input-upload",
@@ -13351,6 +13407,9 @@
13351
13407
  "mds-input": [
13352
13408
  "mds-icon"
13353
13409
  ],
13410
+ "mds-input-field": [
13411
+ "mds-icon"
13412
+ ],
13354
13413
  "mds-input-select": [
13355
13414
  "mds-icon"
13356
13415
  ],
@@ -13416,8 +13475,8 @@
13416
13475
  }
13417
13476
  ],
13418
13477
  "usage": {
13419
- "1. Description": "The `<mds-img>` web component is the responsive image primitive of the Magma Design System. It wraps the native `<img>` element, adding accessible defaults, a built-in error/fallback state, and data-consumption-aware source selection driven by the user's bandwidth preference.\n\n#### Semantic Behavior\n\n- **Automatic alt fallback**: When `alt` is omitted, it is derived from the trailing filename segment of `src`. An empty `alt` (`alt=\"\"`) marks the image as decorative: the host takes `role=\"presentation\"` and no name, and assistive technologies skip it.\n- **Error state**: A failed load swaps the picture for a broken-image icon plus the `alt` text, emitting `mdsImgLoadError`; changing `src` clears the error and retries.\n- **Load events**: `mdsImgLoadSuccess` and `mdsImgLoadError` both carry the underlying `HTMLImageElement` in their detail, letting consumers read natural dimensions or react to failures.\n- **Consumption-aware loading**: When `srcsetConsumption` is set, the component reads the consumption preference the page applies, the one `mds-pref-consumption` publishes, and follows a change; on a page without that controller it reads the stored choice (the `mdsPrefConsumption` key). It picks the matching source; under the `low` preference the image is deferred behind a \"click to load\" placeholder until the user opts in.\n- **Localized placeholder**: The deferred-load placeholder label is resolved through the shared locale system (el/en/es/it).\n\n#### Properties & Visual Configurations\n\nMost props are pass-throughs to the native image attributes of the same name (`src`, `srcset`, `sizes`, `width`, `height`, `loading`, `crossorigin`, `referrerpolicy`) and behave as in HTML; pick values as you would for a plain `<img>`. `crossorigin` and `referrerpolicy` have no default: unset, the image is fetched without CORS and with the referrer policy of the page. `loading` defaults to `'lazy'`, so opt into `'eager'` only for above-the-fold imagery.\n\n#### Other behavioral props\n\n- **`srcsetConsumption`** is a comma-separated map of sources tagged `low` / `medium` / `high` (e.g. `\"img-bw.jpg low, img.jpg medium, img@2x.jpg high\"`). Unlike native `srcset`, the bucket is chosen by the stored consumption preference rather than viewport, letting low-bandwidth users save data by deferring or downgrading the image.\n- **`alt`** supply meaningful text for content images, since it doubles as both the accessible name and the visible label in the error and deferred-load states.\n",
13420
- "2. Examples": "Correct and idiomatic ways to use the `<mds-img>` component, ordered from most common to most specialized. The examples assume a working knowledge of the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Basic Image with Alt Text\n\nThe canonical form. Always supply a meaningful `alt` value for content images - it doubles as the accessible name and as the visible label in both the error state and the deferred-load placeholder.\n\n```html\n<mds-img src=\"/assets/img/copertina-corso.jpg\" alt=\"Copertina del corso di formazione\"></mds-img>\n```\n\n#### Responsive Image with `srcset` and `sizes`\n\nPass the standard `srcset` and `sizes` attributes exactly as you would on a native `<img>`. The browser picks the best source based on viewport and device pixel ratio.\n\n```html\n<mds-img\n src=\"/assets/img/hero-800.jpg\"\n srcset=\"/assets/img/hero-400.jpg 400w, /assets/img/hero-800.jpg 800w, /assets/img/hero-1600.jpg 1600w\"\n sizes=\"(max-width: 600px) 400px, (max-width: 1200px) 800px, 1600px\"\n alt=\"Vista panoramica del centro storico\"\n></mds-img>\n```\n\n#### Eager Loading for Above-the-Fold Images\n\n`loading` defaults to `\"lazy\"`. Set it to `\"eager\"` only for images that are immediately visible on page load, such as hero images or content at the top of the first screen.\n\n```html\n<mds-img\n src=\"/assets/img/hero-principale.jpg\"\n alt=\"Hero della pagina principale\"\n loading=\"eager\"\n></mds-img>\n```\n\n#### Consumption-Aware Sources with `srcset-consumption`\n\nUse `srcset-consumption` to serve a different image source depending on the user's bandwidth preference stored via `mds-pref-consumption`. Tag each source with `low`, `medium`, or `high`. Under the `low` preference the image is deferred behind a \"Carica immagine\" placeholder until the user clicks.\n\n```html\n<mds-img\n src=\"/assets/img/copertina-libro.jpg\"\n srcset-consumption=\"/assets/img/copertina-bw-1x.jpg low, /assets/img/copertina-1x.jpg medium, /assets/img/copertina-2x.jpg high\"\n alt=\"Il nuovo codice dei contratti pubblici\"\n></mds-img>\n```\n\n#### Consumption-Aware with Fallback `src`\n\nProvide `src` alongside `srcset-consumption` as the fallback used when a bucket is missing from the consumption map. Here `src` is the high-resolution file; only `low` and `medium` buckets are overridden.\n\n```html\n<mds-img\n src=\"/assets/img/copertina-2x.jpg\"\n srcset-consumption=\"/assets/img/copertina-bw-1x.jpg low, /assets/img/copertina-1x.jpg medium\"\n alt=\"Manuale pratico degli appalti pubblici\"\n></mds-img>\n```\n\n#### Reacting to Load Events\n\nListen to `mdsImgLoadSuccess` and `mdsImgLoadError` to react to image load outcomes. Both events carry the underlying `HTMLImageElement` in `event.detail.image`, allowing you to read natural dimensions or show fallback UI.\n\n```html\n<mds-img\n id=\"hero\"\n src=\"/assets/img/hero-principale.jpg\"\n alt=\"Immagine principale\"\n></mds-img>\n\n<script>\n document.getElementById('hero').addEventListener('mdsImgLoadSuccess', (event) => {\n const img = event.detail.image;\n console.log('Caricata:', img.naturalWidth, 'x', img.naturalHeight);\n });\n\n document.getElementById('hero').addEventListener('mdsImgLoadError', (event) => {\n console.warn('Immagine non disponibile:', event.detail.image.src);\n });\n</script>\n```\n\n#### Fixed Dimensions\n\nSet `width` and `height` (as string pixel values) to reserve layout space and prevent content reflow during load: they give the inner image its aspect ratio. They do not fix the rendered size - the inner image follows the host, which is `display: flex; width: 100%` by default - so size the host with CSS when a fixed pixel size is intended.\n\n```html\n<mds-img\n src=\"/assets/img/thumbnail.jpg\"\n alt=\"Anteprima documento\"\n width=\"320\"\n height=\"240\"\n></mds-img>\n```\n\n#### Styling Customization\n\nStyle the component through its public `--mds-img-*` CSS custom properties. Use the semantic color roles wrapped in `rgb(var(--magma-<role>))` so dark mode and high-contrast modes keep working.\n\n```css\n.card-copertina mds-img {\n --mds-img-background: rgb(var(--magma-accent-emphasis-hover));\n --mds-img-color: rgb(var(--magma-accent-surface));\n}\n```\n\n#### Styling the Inner `<img>` via `::part(media)`\n\nWhen a CSS property must be applied directly to the inner `<img>` element (for example `object-fit` or `border-radius`) use the documented `media` shadow part. This is the only supported way to pierce the shadow boundary.\n\n```css\n.copertina-libro mds-img::part(media) {\n border-radius: var(--magma-radius-md);\n object-fit: cover;\n}\n```\n",
13478
+ "1. Description": "The `<mds-img>` web component is the responsive image primitive of the Magma Design System. It wraps the native `<img>` element, adding accessible defaults, a built-in error/fallback state, and data-consumption-aware source selection driven by the user's bandwidth preference.\n\n#### Semantic Behavior\n\n- **Automatic alt fallback**: When `alt` is omitted, it is derived from the trailing filename segment of `src`. An empty `alt` (`alt=\"\"`) marks the image as decorative: the host takes `role=\"presentation\"` and no name, and assistive technologies skip it.\n- **Error state**: A failed load swaps the picture for a broken-image icon plus the `alt` text, emitting `mdsImgLoadError`; changing `src` clears the error and retries.\n- **Load events**: `mdsImgLoadSuccess` and `mdsImgLoadError` both carry the underlying `HTMLImageElement` in their detail, letting consumers read natural dimensions or react to failures.\n- **Consumption-aware loading**: When `srcsetConsumption` is set, the component reads the consumption preference the page applies, the one `mds-pref-consumption` publishes, and follows a change; on a page without that controller it reads the stored choice (the `mdsPrefConsumption` key). It picks the matching source; under the `low` preference the image is deferred behind a \"click to load\" placeholder until the user opts in.\n- **The box before hydration**: on a page that does not render the components on the server, `hydrated.css` gives the host its box before the component hydrates, as a native `<img>` reserves its room before the picture loads: as wide as its container, and with `width` and `height`, as tall as their ratio says. The page below it does not move when the component hydrates. The ratio needs typed `attr()`, in Chromium since 133; in a browser without it the host stays 0 px tall until it hydrates, and a page that needs the room there too gives the host the ratio itself (`aspect-ratio`).\n- **Localized placeholder**: The deferred-load placeholder label is resolved through the shared locale system (el/en/es/it).\n\n#### Properties & Visual Configurations\n\nMost props are pass-throughs to the native image attributes of the same name (`src`, `srcset`, `sizes`, `width`, `height`, `loading`, `decoding`, `crossorigin`, `referrerpolicy`) and behave as in HTML; pick values as you would for a plain `<img>`. `crossorigin`, `referrerpolicy` and `decoding` have no default: unset, the image is fetched without CORS and with the referrer policy of the page, and the browser chooses how to decode it. `loading` defaults to `'lazy'`, so opt into `'eager'` only for above-the-fold imagery.\n\n#### Other behavioral props\n\n- **`srcsetConsumption`** is a comma-separated map of sources tagged `low` / `medium` / `high` (e.g. `\"img-bw.jpg low, img.jpg medium, img@2x.jpg high\"`). Unlike native `srcset`, the bucket is chosen by the stored consumption preference rather than viewport, letting low-bandwidth users save data by deferring or downgrading the image.\n- **`alt`** supply meaningful text for content images, since it doubles as both the accessible name and the visible label in the error and deferred-load states.\n",
13479
+ "2. Examples": "Correct and idiomatic ways to use the `<mds-img>` component, ordered from most common to most specialized. The examples assume a working knowledge of the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Basic Image with Alt Text\n\nThe canonical form. Always supply a meaningful `alt` value for content images - it doubles as the accessible name and as the visible label in both the error state and the deferred-load placeholder.\n\n```html\n<mds-img src=\"/assets/img/copertina-corso.jpg\" alt=\"Copertina del corso di formazione\"></mds-img>\n```\n\n#### Responsive Image with `srcset` and `sizes`\n\nPass the standard `srcset` and `sizes` attributes exactly as you would on a native `<img>`. The browser picks the best source based on viewport and device pixel ratio.\n\n```html\n<mds-img\n src=\"/assets/img/hero-800.jpg\"\n srcset=\"/assets/img/hero-400.jpg 400w, /assets/img/hero-800.jpg 800w, /assets/img/hero-1600.jpg 1600w\"\n sizes=\"(max-width: 600px) 400px, (max-width: 1200px) 800px, 1600px\"\n alt=\"Vista panoramica del centro storico\"\n></mds-img>\n```\n\n#### Eager Loading for Above-the-Fold Images\n\n`loading` defaults to `\"lazy\"`. Set it to `\"eager\"` only for images that are immediately visible on page load, such as hero images or content at the top of the first screen.\n\n```html\n<mds-img\n src=\"/assets/img/hero-principale.jpg\"\n alt=\"Hero della pagina principale\"\n loading=\"eager\"\n></mds-img>\n```\n\n#### A Large Picture Lower on the Page\n\n`decoding=\"async\"` lets the browser decode the picture apart from the rest of the page, which then shows without waiting for it. With `width` and `height` the host keeps the room of the picture before the component hydrates and before the picture loads.\n\n```html\n<mds-img\n src=\"/assets/img/studio.webp\"\n alt=\"Magma Studio\"\n width=\"1440\"\n height=\"900\"\n decoding=\"async\"\n></mds-img>\n```\n\n#### Consumption-Aware Sources with `srcset-consumption`\n\nUse `srcset-consumption` to serve a different image source depending on the user's bandwidth preference stored via `mds-pref-consumption`. Tag each source with `low`, `medium`, or `high`. Under the `low` preference the image is deferred behind a \"Carica immagine\" placeholder until the user clicks.\n\n```html\n<mds-img\n src=\"/assets/img/copertina-libro.jpg\"\n srcset-consumption=\"/assets/img/copertina-bw-1x.jpg low, /assets/img/copertina-1x.jpg medium, /assets/img/copertina-2x.jpg high\"\n alt=\"Il nuovo codice dei contratti pubblici\"\n></mds-img>\n```\n\n#### Consumption-Aware with Fallback `src`\n\nProvide `src` alongside `srcset-consumption` as the fallback used when a bucket is missing from the consumption map. Here `src` is the high-resolution file; only `low` and `medium` buckets are overridden.\n\n```html\n<mds-img\n src=\"/assets/img/copertina-2x.jpg\"\n srcset-consumption=\"/assets/img/copertina-bw-1x.jpg low, /assets/img/copertina-1x.jpg medium\"\n alt=\"Manuale pratico degli appalti pubblici\"\n></mds-img>\n```\n\n#### Reacting to Load Events\n\nListen to `mdsImgLoadSuccess` and `mdsImgLoadError` to react to image load outcomes. Both events carry the underlying `HTMLImageElement` in `event.detail.image`, allowing you to read natural dimensions or show fallback UI.\n\n```html\n<mds-img\n id=\"hero\"\n src=\"/assets/img/hero-principale.jpg\"\n alt=\"Immagine principale\"\n></mds-img>\n\n<script>\n document.getElementById('hero').addEventListener('mdsImgLoadSuccess', (event) => {\n const img = event.detail.image;\n console.log('Caricata:', img.naturalWidth, 'x', img.naturalHeight);\n });\n\n document.getElementById('hero').addEventListener('mdsImgLoadError', (event) => {\n console.warn('Immagine non disponibile:', event.detail.image.src);\n });\n</script>\n```\n\n#### Fixed Dimensions\n\nSet `width` and `height` (as string pixel values) to reserve layout space and prevent content reflow during load: they give the inner image its aspect ratio, and the host the same box before the component hydrates. They do not fix the rendered size - the inner image follows the host, which is `display: flex; width: 100%` by default - so size the host with CSS when a fixed pixel size is intended.\n\n```html\n<mds-img\n src=\"/assets/img/thumbnail.jpg\"\n alt=\"Anteprima documento\"\n width=\"320\"\n height=\"240\"\n></mds-img>\n```\n\n#### Styling Customization\n\nStyle the component through its public `--mds-img-*` CSS custom properties. Use the semantic color roles wrapped in `rgb(var(--magma-<role>))` so dark mode and high-contrast modes keep working.\n\n```css\n.card-copertina mds-img {\n --mds-img-background: rgb(var(--magma-accent-emphasis-hover));\n --mds-img-color: rgb(var(--magma-accent-surface));\n}\n```\n\n#### Styling the Inner `<img>` via `::part(media)`\n\nWhen a CSS property must be applied directly to the inner `<img>` element (for example `object-fit` or `border-radius`) use the documented `media` shadow part. This is the only supported way to pierce the shadow boundary.\n\n```css\n.copertina-libro mds-img::part(media) {\n border-radius: var(--magma-radius-md);\n object-fit: cover;\n}\n```\n",
13421
13480
  "3. Mistakes": "Common incorrect uses of `<mds-img>`. 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/mistakes.md`](../../../../agents/mistakes.md) - they apply here too but are not repeated.\n\n#### Do Not Replace `<mds-img>` with a Raw `<img>` Element\n\nUsing a plain `<img>` bypasses the built-in error fallback, consumption-aware loading, and accessible-name defaults that `<mds-img>` provides.\n\n```html\n<!-- INCORRECT -->\n<img src=\"/assets/img/copertina.jpg\" alt=\"Copertina\" loading=\"lazy\">\n\n<!-- CORRECT -->\n<mds-img src=\"/assets/img/copertina.jpg\" alt=\"Copertina\"></mds-img>\n```\n\n#### Do Not Omit `alt` When the Image Conveys Information\n\n`<mds-img>` derives a fallback `alt` from the filename when none is supplied, but a raw filename slug is not a meaningful description. Supply a descriptive `alt` for every content image.\n\n```html\n<!-- INCORRECT -->\n<mds-img src=\"/assets/img/report-annuale-2024.jpg\"></mds-img>\n\n<!-- CORRECT -->\n<mds-img src=\"/assets/img/report-annuale-2024.jpg\" alt=\"Report annuale 2024\"></mds-img>\n```\n\n#### Do Not Listen to the Native `load` or `error` Events\n\nThe inner `<img>` lives in shadow DOM, and its native `load` and `error` events do not bubble, so a listener on the host never receives them. Use the documented `mdsImgLoadSuccess` and `mdsImgLoadError` custom events instead.\n\n```html\n<!-- INCORRECT -->\n<mds-img id=\"foto\" src=\"/assets/img/foto.jpg\" alt=\"Foto\"></mds-img>\n<script>\n document.getElementById('foto').addEventListener('load', handler);\n document.getElementById('foto').addEventListener('error', handler);\n</script>\n\n<!-- CORRECT -->\n<mds-img id=\"foto\" src=\"/assets/img/foto.jpg\" alt=\"Foto\"></mds-img>\n<script>\n document.getElementById('foto').addEventListener('mdsImgLoadSuccess', handler);\n document.getElementById('foto').addEventListener('mdsImgLoadError', handler);\n</script>\n```\n\n#### Do Not Use `srcset-consumption` Without a Meaningful Bucket Tag\n\nEach entry in `srcset-consumption` must end with `low`, `medium`, or `high`. Entries with any other tag, or none, are ignored with a console warning, leaving that consumption level without a source.\n\n```html\n<!-- INCORRECT -->\n<mds-img\n srcset-consumption=\"/assets/img/small.jpg 1x, /assets/img/large.jpg 2x\"\n alt=\"Immagine\"\n></mds-img>\n\n<!-- CORRECT -->\n<mds-img\n srcset-consumption=\"/assets/img/small.jpg low, /assets/img/medium.jpg medium, /assets/img/large.jpg high\"\n alt=\"Immagine\"\n></mds-img>\n```\n\n#### Do Not Pierce the Shadow DOM to Style the Inner `<img>`\n\nTargeting internal selectors with `>>>`, `/deep/`, or undocumented class names couples your code to the shadow DOM structure and will break on minor releases. Use the public `--mds-img-*` CSS custom properties for color theming, and the documented `::part(media)` for geometry/object-fit overrides.\n\n```css\n/* INCORRECT */\nmds-img >>> img {\n border-radius: 8px;\n object-fit: cover;\n}\n\n/* CORRECT */\nmds-img::part(media) {\n border-radius: var(--magma-radius-md);\n object-fit: cover;\n}\n```\n\n#### Do Not Set `loading=\"eager\"` for Every Image\n\n`loading` defaults to `\"lazy\"`, which is the correct behavior for most images. Setting `\"eager\"` on all images forces the browser to download every image immediately, degrading performance. Reserve `\"eager\"` for images that are visible on first paint.\n\n```html\n<!-- INCORRECT -->\n<mds-img src=\"/assets/img/thumbnail-1.jpg\" alt=\"Anteprima 1\" loading=\"eager\"></mds-img>\n<mds-img src=\"/assets/img/thumbnail-2.jpg\" alt=\"Anteprima 2\" loading=\"eager\"></mds-img>\n<mds-img src=\"/assets/img/thumbnail-3.jpg\" alt=\"Anteprima 3\" loading=\"eager\"></mds-img>\n\n<!-- CORRECT -->\n<mds-img src=\"/assets/img/hero.jpg\" alt=\"Hero principale\" loading=\"eager\"></mds-img>\n<mds-img src=\"/assets/img/thumbnail-1.jpg\" alt=\"Anteprima 1\"></mds-img>\n<mds-img src=\"/assets/img/thumbnail-2.jpg\" alt=\"Anteprima 2\"></mds-img>\n```\n"
13422
13481
  },
13423
13482
  "props": [
@@ -13482,6 +13541,48 @@
13482
13541
  "getter": false,
13483
13542
  "setter": false
13484
13543
  },
13544
+ {
13545
+ "name": "decoding",
13546
+ "type": "\"async\" | \"auto\" | \"sync\" | undefined",
13547
+ "complexType": {
13548
+ "original": "DecodingType",
13549
+ "resolved": "\"async\" | \"auto\" | \"sync\" | undefined",
13550
+ "references": {
13551
+ "DecodingType": {
13552
+ "location": "import",
13553
+ "path": "./meta/types",
13554
+ "id": "src/components/mds-img/meta/types.ts::DecodingType",
13555
+ "referenceLocation": "DecodingType"
13556
+ }
13557
+ }
13558
+ },
13559
+ "mutable": false,
13560
+ "attr": "decoding",
13561
+ "reflectToAttr": false,
13562
+ "docs": "How the browser decodes the picture, as the `decoding` attribute of `<img>`: `async` apart\nfrom the rest of the page, which then shows without waiting for it, as a large picture lower\non the page can; `sync` with it; `auto` as the browser chooses. Unset, the browser chooses",
13563
+ "docsTags": [],
13564
+ "values": [
13565
+ {
13566
+ "value": "async",
13567
+ "type": "string"
13568
+ },
13569
+ {
13570
+ "value": "auto",
13571
+ "type": "string"
13572
+ },
13573
+ {
13574
+ "value": "sync",
13575
+ "type": "string"
13576
+ },
13577
+ {
13578
+ "type": "undefined"
13579
+ }
13580
+ ],
13581
+ "optional": true,
13582
+ "required": false,
13583
+ "getter": false,
13584
+ "setter": false
13585
+ },
13485
13586
  {
13486
13587
  "name": "height",
13487
13588
  "type": "string | undefined",
@@ -13493,7 +13594,7 @@
13493
13594
  "mutable": false,
13494
13595
  "attr": "height",
13495
13596
  "reflectToAttr": false,
13496
- "docs": "The height attribute specifies the height of an image, in pixels.",
13597
+ "docs": "The height of the picture, in pixels, as the `height` attribute of `<img>`. With `width`, its\nratio gives the host its box before the component hydrates, as a native `<img>` reserves its\nroom before the picture loads (hydrated.css, where the browser supports typed `attr()`)",
13497
13598
  "docsTags": [],
13498
13599
  "values": [
13499
13600
  {
@@ -13732,7 +13833,7 @@
13732
13833
  "mutable": false,
13733
13834
  "attr": "width",
13734
13835
  "reflectToAttr": false,
13735
- "docs": "The width attribute specifies the width of an image, in pixels.",
13836
+ "docs": "The width of the picture, in pixels, as the `width` attribute of `<img>`. With `height`, its\nratio gives the host its box before the component hydrates",
13736
13837
  "docsTags": [],
13737
13838
  "values": [
13738
13839
  {
@@ -17070,11 +17171,37 @@
17070
17171
  }
17071
17172
  ],
17072
17173
  "usage": {
17073
- "1. Description": "The `<mds-input-field>` web component is the form-field wrapper of the Magma Design System. It does not render an input itself; instead it decorates a slotted `<mds-input>` (or similar control) with a top label and a bottom message area, and reacts to the control's validation lifecycle. It plays the role the native `<label>` + helper-text grouping plays around an `<input>`.\n\n#### Semantic Behavior\n\n- **Compound parent**: The interactive control is supplied through the default slot; the field is not used standalone. Validation is wired to the first slotted element; with an empty slot the field only logs a console warning at load.\n- **Form association**: The field participates in the surrounding `<form>` through the control it wraps, requiring no extra wiring.\n- **Validation-driven state**: It listens for the slotted control's `mdsInputValidation` event. When the control reports errors it switches `variant` to `'error'` and shows the joined error strings in `message`; otherwise it sets `variant` to `'success'` and clears `message`.\n- **Message rendering**: `message` is split on `;` and each segment is rendered as a separate caption line, so multiple validation messages stack vertically.\n\n#### Properties & Visual Configurations\n\n- **`message`** is the helper/error text shown under the control. It is author-set initially but is overwritten by the validation cycle once the slotted control emits validation (replaced by the errors, or cleared when there are none), so a manually set message persists only until the first validation.\n- **`short`** states that the answer of the field is short: a house number, a postcode, a tax code, a date. It says the meaning, and the `field-group` utility of the styles package lays it out: from a column of `28rem` a short field takes half of it and two in a row share it, under it each takes the whole column (`widths/field` of the design language). Out of a `field-group` the field keeps its width.\n- **`variant`** drives the field's status colouring. It is not the full theme ladder: the allowed set is the input-specific variant ladder (`'ai'`, `'primary'`, plus the status values `'error'`, `'info'`, `'success'`, `'warning'`), drawn from the families in [`agents/variants.md`](../../../../agents/variants.md). It defaults to `'primary'` and is normally managed automatically by validation rather than set by hand.\n",
17074
- "2. Examples": "Correct and idiomatic ways to use the `<mds-input-field>` component, ordered from most common to most specialized. The examples assume a working knowledge of the variant / tone ladders documented in [`agents/variants.md`](../../../../agents/variants.md) and the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Basic Labeled Input\n\nThe canonical form. Wrap [`mds-input`](../mds-input/AGENTS.md) in `<mds-input-field>` and set `label` for the visible field caption. The `<mds-input>` must be the first slotted element: the field wires validation to it, and with an empty slot it only logs a console warning.\n\n```html\n<mds-input-field label=\"Nome e cognome\">\n <mds-input name=\"fullName\" placeholder=\"Es: Mario Rossi\"></mds-input>\n</mds-input-field>\n```\n\n#### Input with a Static Helper Message\n\nSet `message` to show a persistent hint below the control. The message disappears once the slotted input emits its first `mdsInputValidation` event, so use this only for pre-validation guidance.\n\n```html\n<mds-input-field label=\"Codice fiscale\" message=\"16 caratteri alfanumerici\">\n <mds-input name=\"cf\" type=\"cf\" placeholder=\"Es: MRCRSS83B21D704L\"></mds-input>\n</mds-input-field>\n```\n\n#### Validation-Driven State\n\nWhen `<mds-input>` carries validation rules (e.g. `required`, `type=\"cf\"`, or `pattern`), `<mds-input-field>` listens for `mdsInputValidation` and automatically sets `variant` to `'error'` (showing joined error messages) or `'success'` (clearing the message). No event wiring is needed - just add the validation attributes to the slotted input.\n\n```html\n<mds-input-field label=\"Indirizzo email\">\n <mds-input name=\"email\" type=\"email\" required placeholder=\"Es: mario@esempio.it\"></mds-input>\n</mds-input-field>\n```\n\n#### Explicit Variant for Initial Status\n\nIf the field must start in a known non-default state - for example a server-side validation result rendered on page load - set `variant` directly. The validation cycle overwrites it at the first `mdsInputValidation` of the slotted input, which an `<mds-input>` emits on blur only when it has validation rules.\n\n```html\n<!-- Server returned an error before page load -->\n<mds-input-field\n label=\"Username\"\n variant=\"error\"\n message=\"Username gia in uso\"\n>\n <mds-input name=\"username\" value=\"mario.rossi\"></mds-input>\n</mds-input-field>\n```\n\n#### Field with an Action Button\n\nThe default slot accepts multiple elements. The first child grows to fill the available width; subsequent children shrink to their natural size. Use this to pair an input with a companion [`mds-button`](../mds-button/AGENTS.md).\n\n```html\n<mds-input-field label=\"Cerca per nome\">\n <mds-input name=\"query\" placeholder=\"Es: Mario Rossi\"></mds-input>\n <mds-button icon=\"mi/baseline/search\" size=\"lg\" aria-label=\"Cerca\"></mds-button>\n</mds-input-field>\n```\n\n#### Inside a Form\n\nThe slotted `<mds-input>` is itself form-associated and submits under its own `name`. Place the field inside a `<form>` with a submit button; the field requires no extra wiring.\n\n```html\n<form action=\"/registrazione\" method=\"post\">\n <mds-input-field label=\"Nome\">\n <mds-input name=\"firstName\" required placeholder=\"Es: Mario\"></mds-input>\n </mds-input-field>\n\n <mds-input-field label=\"Cognome\">\n <mds-input name=\"lastName\" required placeholder=\"Es: Rossi\"></mds-input>\n </mds-input-field>\n\n <mds-button type=\"submit\" label=\"Registrati\" variant=\"primary\" tone=\"strong\"></mds-button>\n</form>\n```\n\n#### Short Answers in a Group of Fields\n\nSet `short` on a field whose answer is short (a house number, a postcode, a tax code, a date), and put the fields of one subject in a `fieldset` with the `field-group` utility of the styles package. A short field takes half the column and two in a row share it, in reading order: number and postcode, tax code and date of birth. Every other field takes the whole column, and under a column of `28rem` the halves take it too. The group reads its direct children: a framework component that wraps the field carries `short` on its own host.\n\n```html\n<form class=\"max-w-form\">\n <fieldset class=\"field-group\">\n <legend>Residenza</legend>\n <mds-input-field label=\"Via\">\n <mds-input name=\"street\"></mds-input>\n </mds-input-field>\n <mds-input-field label=\"Numero civico\" short>\n <mds-input name=\"number\"></mds-input>\n </mds-input-field>\n <mds-input-field label=\"CAP\" short>\n <mds-input name=\"postcode\"></mds-input>\n </mds-input-field>\n </fieldset>\n</form>\n```\n\n#### Styling Customization\n\nAdjust the message area colors through the two documented `--mds-input-field-*` CSS custom properties. Use the semantic color roles via `rgb(var(--magma-<role>))` ([`agents/color.md`](../../../../agents/color.md)) so dark mode and high-contrast modes keep working.\n\n```css\n.field-highlight mds-input-field {\n --mds-input-field-message-color: rgb(var(--magma-accent-fg));\n --mds-input-field-message-background: rgb(var(--magma-accent-surface));\n}\n```\n",
17075
- "3. Mistakes": "Common incorrect uses of `<mds-input-field>`. 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/mistakes.md`](../../../../agents/mistakes.md) - they apply here too but are not repeated.\n\n#### Do Not Use It Without a Slotted Input\n\n`<mds-input-field>` requires a slotted input element. With an empty slot it only logs a console warning at load and has no control to label or validate. Always slot an [`mds-input`](../mds-input/AGENTS.md) as the first child.\n\n```html\n<!-- INCORRECT -->\n<mds-input-field label=\"Nome\"></mds-input-field>\n\n<!-- CORRECT -->\n<mds-input-field label=\"Nome\">\n <mds-input name=\"firstName\" placeholder=\"Es: Mario\"></mds-input>\n</mds-input-field>\n```\n\n#### Do Not Use a Native `<input>` in the Slot\n\nThe component binds to `mdsInputValidation`, which only the Magma inputs (`<mds-input>`, `<mds-input-date>`) emit. Slotting a raw `<input>` skips the validation lifecycle entirely - the field will never switch to `error` or `success`.\n\n```html\n<!-- INCORRECT -->\n<mds-input-field label=\"Email\">\n <input type=\"email\" name=\"email\" required>\n</mds-input-field>\n\n<!-- CORRECT -->\n<mds-input-field label=\"Email\">\n <mds-input type=\"email\" name=\"email\" required></mds-input>\n</mds-input-field>\n```\n\n#### Do Not Manage `variant` and `message` Manually During Validation\n\n`variant` and `message` are mutable and will be overwritten by the validation cycle the moment the slotted control emits `mdsInputValidation`. Trying to manage them via script in parallel leads to race conditions. Set validation attributes on `<mds-input>` and let the field drive state automatically.\n\n```html\n<!-- INCORRECT -->\n<mds-input-field id=\"nameField\" label=\"Nome\">\n <mds-input name=\"firstName\" required></mds-input>\n</mds-input-field>\n<script>\n document.getElementById('nameField').variant = 'error';\n document.getElementById('nameField').message = 'Campo obbligatorio';\n</script>\n\n<!-- CORRECT -->\n<mds-input-field label=\"Nome\">\n <mds-input name=\"firstName\" required></mds-input>\n</mds-input-field>\n```\n\n#### Do Not Listen for Native `change` or `input` Events to Detect Validation\n\nNative DOM events (`change`, `input`) do not carry validation state and may not bubble out of shadow DOM as expected. Listen for the documented `mdsInputValidation` event on the slotted `<mds-input>` if you need to react to validation results in your own code.\n\n```html\n<!-- INCORRECT -->\n<mds-input-field label=\"Codice fiscale\">\n <mds-input id=\"cfInput\" name=\"cf\" type=\"cf\" required></mds-input>\n</mds-input-field>\n<script>\n document.getElementById('cfInput').addEventListener('change', handleChange);\n</script>\n\n<!-- CORRECT -->\n<mds-input-field label=\"Codice fiscale\">\n <mds-input id=\"cfInput\" name=\"cf\" type=\"cf\" required></mds-input>\n</mds-input-field>\n<script>\n document.getElementById('cfInput').addEventListener('mdsInputValidation', handleValidation);\n</script>\n```\n\n#### Do Not Apply an Invalid `variant` Value\n\n`<mds-input-field>` uses `ThemeInputVariantType`, which only accepts `'ai'`, `'primary'`, `'error'`, `'info'`, `'success'`, and `'warning'`. Values from the broader variant ladder (e.g. `'secondary'`, `'dark'`) silently fall back to the default and produce no coloring change.\n\n```html\n<!-- INCORRECT (variant from the full theme ladder) -->\n<mds-input-field label=\"Stato\" variant=\"secondary\" message=\"Valore non valido\">\n <mds-input name=\"stato\"></mds-input>\n</mds-input-field>\n\n<!-- CORRECT -->\n<mds-input-field label=\"Stato\" variant=\"warning\" message=\"Valore non valido\">\n <mds-input name=\"stato\"></mds-input>\n</mds-input-field>\n```\n\n#### Do Not Narrow a Short Field by Hand\n\nA width written on the field, or a wrapper per pair, gives every field an edge of its own and copies the threshold under which the halves take the whole column. `short` in a `field-group` keeps two widths, the whole column and half of it, and the threshold in one place.\n\n```html\n<!-- INCORRECT -->\n<div class=\"flex flex-wrap gap-between-fields\">\n <mds-input-field label=\"Numero civico\" class=\"w-32\">\n <mds-input name=\"number\"></mds-input>\n </mds-input-field>\n <mds-input-field label=\"CAP\" class=\"w-1/2\">\n <mds-input name=\"postcode\"></mds-input>\n </mds-input-field>\n</div>\n\n<!-- CORRECT -->\n<fieldset class=\"field-group\">\n <legend>Residenza</legend>\n <mds-input-field label=\"Numero civico\" short>\n <mds-input name=\"number\"></mds-input>\n </mds-input-field>\n <mds-input-field label=\"CAP\" short>\n <mds-input name=\"postcode\"></mds-input>\n </mds-input-field>\n</fieldset>\n```\n\n#### Do Not Pierce the Shadow DOM to Style the Message Area\n\nThe only supported customization surface is `--mds-input-field-message-color` and `--mds-input-field-message-background`, plus the `content` shadow part. Targeting internal elements via `>>>` or undocumented class names couples your code to the implementation and will break on minor releases.\n\n```css\n/* INCORRECT */\nmds-input-field >>> .message {\n color: red;\n}\n\n/* CORRECT */\nmds-input-field {\n --mds-input-field-message-color: rgb(var(--magma-danger-text-muted));\n --mds-input-field-message-background: rgb(var(--magma-danger-wash-base));\n}\n```\n"
17174
+ "1. Description": "The `<mds-input-field>` web component is the form-field wrapper of the Magma Design System. It does not render an input itself; instead it decorates a slotted `<mds-input>` (or similar control) with a top label and a bottom message area, and reacts to the control's validation lifecycle. It plays the role the native `<label>` + helper-text grouping plays around an `<input>`.\n\n#### Semantic Behavior\n\n- **Compound parent**: The interactive control is supplied through the default slot; the field is not used standalone. Validation is wired to the first slotted element; with an empty slot the field only logs a console warning at load.\n- **Form association**: The field participates in the surrounding `<form>` through the control it wraps, requiring no extra wiring.\n- **Validation-driven state**: It listens for the slotted control's `mdsInputValidation` event. When the control reports errors it switches `variant` to `'error'` and shows the joined error strings in `message`; otherwise it sets `variant` to `'success'` and clears `message`.\n- **Message rendering**: `message` is split on `;` and each segment is rendered as a separate caption line, so multiple validation messages stack vertically.\n\n#### Properties & Visual Configurations\n\n- **`message`** is the helper/error text shown under the control. It is author-set initially but is overwritten by the validation cycle once the slotted control emits validation (replaced by the errors, or cleared when there are none), so a manually set message persists only until the first validation.\n- **`icon`** draws an icon before the label, in the emphasis colour of the `variant` (muted while the variant is `'primary'`): the state the message tells, seen at a glance, such as a verdict on the value the field holds. It takes the name of an icon or its SVG, as `mds-icon`. The icon is decorative and hidden from assistive technologies: the message says the state in words, and the label alone names the control. Without `icon` the label stands alone, as it always did.\n- **`short`** states that the answer of the field is short: a house number, a postcode, a tax code, a date. It says the meaning, and the `field-group` utility of the styles package lays it out: from a column of `28rem` a short field takes half of it and two in a row share it, under it each takes the whole column (`widths/field` of the design language). Out of a `field-group` the field keeps its width.\n- **`variant`** drives the field's status colouring. It is not the full theme ladder: the allowed set is the input-specific variant ladder (`'ai'`, `'primary'`, plus the status values `'error'`, `'info'`, `'success'`, `'warning'`), drawn from the families in [`agents/variants.md`](../../../../agents/variants.md). It defaults to `'primary'` and is normally managed automatically by validation rather than set by hand.\n",
17175
+ "2. Examples": "Correct and idiomatic ways to use the `<mds-input-field>` component, ordered from most common to most specialized. The examples assume a working knowledge of the variant / tone ladders documented in [`agents/variants.md`](../../../../agents/variants.md) and the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Basic Labeled Input\n\nThe canonical form. Wrap [`mds-input`](../mds-input/AGENTS.md) in `<mds-input-field>` and set `label` for the visible field caption. The `<mds-input>` must be the first slotted element: the field wires validation to it, and with an empty slot it only logs a console warning.\n\n```html\n<mds-input-field label=\"Nome e cognome\">\n <mds-input name=\"fullName\" placeholder=\"Es: Mario Rossi\"></mds-input>\n</mds-input-field>\n```\n\n#### Input with a Static Helper Message\n\nSet `message` to show a persistent hint below the control. The message disappears once the slotted input emits its first `mdsInputValidation` event, so use this only for pre-validation guidance.\n\n```html\n<mds-input-field label=\"Codice fiscale\" message=\"16 caratteri alfanumerici\">\n <mds-input name=\"cf\" type=\"cf\" placeholder=\"Es: MRCRSS83B21D704L\"></mds-input>\n</mds-input-field>\n```\n\n#### A Verdict with Its Icon\n\nWhen the page judges the value of the field (a choice that holds or not, a check the value passes), set `variant` to the verdict, say it in `message` and give `icon` the mark of the verdict: it stands before the label, in the colour of the variant. The words stay in the message; the icon only lets the eye find the state.\n\n```html\n<mds-input-field\n label=\"Spazio colore\"\n variant=\"warning\"\n icon=\"mi/baseline/warning\"\n message=\"La tonalità ruota di 25 gradi nei gradini scuri;OKLAB tiene meglio questo colore\"\n>\n <mds-input-select>\n <option value=\"OKLCH\" selected>OKLCH</option>\n <option value=\"OKLAB\">OKLAB</option>\n </mds-input-select>\n</mds-input-field>\n```\n\n#### Validation-Driven State\n\nWhen `<mds-input>` carries validation rules (e.g. `required`, `type=\"cf\"`, or `pattern`), `<mds-input-field>` listens for `mdsInputValidation` and automatically sets `variant` to `'error'` (showing joined error messages) or `'success'` (clearing the message). No event wiring is needed - just add the validation attributes to the slotted input.\n\n```html\n<mds-input-field label=\"Indirizzo email\">\n <mds-input name=\"email\" type=\"email\" required placeholder=\"Es: mario@esempio.it\"></mds-input>\n</mds-input-field>\n```\n\n#### Explicit Variant for Initial Status\n\nIf the field must start in a known non-default state - for example a server-side validation result rendered on page load - set `variant` directly. The validation cycle overwrites it at the first `mdsInputValidation` of the slotted input, which an `<mds-input>` emits on blur only when it has validation rules.\n\n```html\n<!-- Server returned an error before page load -->\n<mds-input-field\n label=\"Username\"\n variant=\"error\"\n message=\"Username gia in uso\"\n>\n <mds-input name=\"username\" value=\"mario.rossi\"></mds-input>\n</mds-input-field>\n```\n\n#### Field with an Action Button\n\nThe default slot accepts multiple elements. The first child grows to fill the available width; subsequent children shrink to their natural size. Use this to pair an input with a companion [`mds-button`](../mds-button/AGENTS.md).\n\n```html\n<mds-input-field label=\"Cerca per nome\">\n <mds-input name=\"query\" placeholder=\"Es: Mario Rossi\"></mds-input>\n <mds-button icon=\"mi/baseline/search\" size=\"lg\" aria-label=\"Cerca\"></mds-button>\n</mds-input-field>\n```\n\n#### Inside a Form\n\nThe slotted `<mds-input>` is itself form-associated and submits under its own `name`. Place the field inside a `<form>` with a submit button; the field requires no extra wiring.\n\n```html\n<form action=\"/registrazione\" method=\"post\">\n <mds-input-field label=\"Nome\">\n <mds-input name=\"firstName\" required placeholder=\"Es: Mario\"></mds-input>\n </mds-input-field>\n\n <mds-input-field label=\"Cognome\">\n <mds-input name=\"lastName\" required placeholder=\"Es: Rossi\"></mds-input>\n </mds-input-field>\n\n <mds-button type=\"submit\" label=\"Registrati\" variant=\"primary\" tone=\"strong\"></mds-button>\n</form>\n```\n\n#### Short Answers in a Group of Fields\n\nSet `short` on a field whose answer is short (a house number, a postcode, a tax code, a date), and put the fields of one subject in a `fieldset` with the `field-group` utility of the styles package. A short field takes half the column and two in a row share it, in reading order: number and postcode, tax code and date of birth. Every other field takes the whole column, and under a column of `28rem` the halves take it too. The group reads its direct children: a framework component that wraps the field carries `short` on its own host.\n\n```html\n<form class=\"max-w-form\">\n <fieldset class=\"field-group\">\n <legend>Residenza</legend>\n <mds-input-field label=\"Via\">\n <mds-input name=\"street\"></mds-input>\n </mds-input-field>\n <mds-input-field label=\"Numero civico\" short>\n <mds-input name=\"number\"></mds-input>\n </mds-input-field>\n <mds-input-field label=\"CAP\" short>\n <mds-input name=\"postcode\"></mds-input>\n </mds-input-field>\n </fieldset>\n</form>\n```\n\n#### Styling Customization\n\nAdjust the message area colors through the two documented `--mds-input-field-*` CSS custom properties. Use the semantic color roles via `rgb(var(--magma-<role>))` ([`agents/color.md`](../../../../agents/color.md)) so dark mode and high-contrast modes keep working.\n\n```css\n.field-highlight mds-input-field {\n --mds-input-field-message-color: rgb(var(--magma-accent-fg));\n --mds-input-field-message-background: rgb(var(--magma-accent-surface));\n}\n```\n",
17176
+ "3. Mistakes": "Common incorrect uses of `<mds-input-field>`. 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/mistakes.md`](../../../../agents/mistakes.md) - they apply here too but are not repeated.\n\n#### Do Not Use It Without a Slotted Input\n\n`<mds-input-field>` requires a slotted input element. With an empty slot it only logs a console warning at load and has no control to label or validate. Always slot an [`mds-input`](../mds-input/AGENTS.md) as the first child.\n\n```html\n<!-- INCORRECT -->\n<mds-input-field label=\"Nome\"></mds-input-field>\n\n<!-- CORRECT -->\n<mds-input-field label=\"Nome\">\n <mds-input name=\"firstName\" placeholder=\"Es: Mario\"></mds-input>\n</mds-input-field>\n```\n\n#### Do Not Use a Native `<input>` in the Slot\n\nThe component binds to `mdsInputValidation`, which only the Magma inputs (`<mds-input>`, `<mds-input-date>`) emit. Slotting a raw `<input>` skips the validation lifecycle entirely - the field will never switch to `error` or `success`.\n\n```html\n<!-- INCORRECT -->\n<mds-input-field label=\"Email\">\n <input type=\"email\" name=\"email\" required>\n</mds-input-field>\n\n<!-- CORRECT -->\n<mds-input-field label=\"Email\">\n <mds-input type=\"email\" name=\"email\" required></mds-input>\n</mds-input-field>\n```\n\n#### Do Not Manage `variant` and `message` Manually During Validation\n\n`variant` and `message` are mutable and will be overwritten by the validation cycle the moment the slotted control emits `mdsInputValidation`. Trying to manage them via script in parallel leads to race conditions. Set validation attributes on `<mds-input>` and let the field drive state automatically.\n\n```html\n<!-- INCORRECT -->\n<mds-input-field id=\"nameField\" label=\"Nome\">\n <mds-input name=\"firstName\" required></mds-input>\n</mds-input-field>\n<script>\n document.getElementById('nameField').variant = 'error';\n document.getElementById('nameField').message = 'Campo obbligatorio';\n</script>\n\n<!-- CORRECT -->\n<mds-input-field label=\"Nome\">\n <mds-input name=\"firstName\" required></mds-input>\n</mds-input-field>\n```\n\n#### Do Not Listen for Native `change` or `input` Events to Detect Validation\n\nNative DOM events (`change`, `input`) do not carry validation state and may not bubble out of shadow DOM as expected. Listen for the documented `mdsInputValidation` event on the slotted `<mds-input>` if you need to react to validation results in your own code.\n\n```html\n<!-- INCORRECT -->\n<mds-input-field label=\"Codice fiscale\">\n <mds-input id=\"cfInput\" name=\"cf\" type=\"cf\" required></mds-input>\n</mds-input-field>\n<script>\n document.getElementById('cfInput').addEventListener('change', handleChange);\n</script>\n\n<!-- CORRECT -->\n<mds-input-field label=\"Codice fiscale\">\n <mds-input id=\"cfInput\" name=\"cf\" type=\"cf\" required></mds-input>\n</mds-input-field>\n<script>\n document.getElementById('cfInput').addEventListener('mdsInputValidation', handleValidation);\n</script>\n```\n\n#### Do Not Apply an Invalid `variant` Value\n\n`<mds-input-field>` uses `ThemeInputVariantType`, which only accepts `'ai'`, `'primary'`, `'error'`, `'info'`, `'success'`, and `'warning'`. Values from the broader variant ladder (e.g. `'secondary'`, `'dark'`) silently fall back to the default and produce no coloring change.\n\n```html\n<!-- INCORRECT (variant from the full theme ladder) -->\n<mds-input-field label=\"Stato\" variant=\"secondary\" message=\"Valore non valido\">\n <mds-input name=\"stato\"></mds-input>\n</mds-input-field>\n\n<!-- CORRECT -->\n<mds-input-field label=\"Stato\" variant=\"warning\" message=\"Valore non valido\">\n <mds-input name=\"stato\"></mds-input>\n</mds-input-field>\n```\n\n#### Do Not Narrow a Short Field by Hand\n\nA width written on the field, or a wrapper per pair, gives every field an edge of its own and copies the threshold under which the halves take the whole column. `short` in a `field-group` keeps two widths, the whole column and half of it, and the threshold in one place.\n\n```html\n<!-- INCORRECT -->\n<div class=\"flex flex-wrap gap-between-fields\">\n <mds-input-field label=\"Numero civico\" class=\"w-32\">\n <mds-input name=\"number\"></mds-input>\n </mds-input-field>\n <mds-input-field label=\"CAP\" class=\"w-1/2\">\n <mds-input name=\"postcode\"></mds-input>\n </mds-input-field>\n</div>\n\n<!-- CORRECT -->\n<fieldset class=\"field-group\">\n <legend>Residenza</legend>\n <mds-input-field label=\"Numero civico\" short>\n <mds-input name=\"number\"></mds-input>\n </mds-input-field>\n <mds-input-field label=\"CAP\" short>\n <mds-input name=\"postcode\"></mds-input>\n </mds-input-field>\n</fieldset>\n```\n\n#### Do Not Tell the State with the Icon Alone\n\n`icon` is decorative: hidden from assistive technologies, it only lets the eye find a state the message says in words. A field that shows a warning icon with no message tells a screen reader nothing; a symbol written into `label` instead reaches the name of the control, read before its label.\n\n```html\n<!-- INCORRECT -->\n<mds-input-field label=\"Spazio colore\" variant=\"warning\" icon=\"mi/baseline/warning\">\n <mds-input-select>...</mds-input-select>\n</mds-input-field>\n\n<!-- CORRECT -->\n<mds-input-field\n label=\"Spazio colore\"\n variant=\"warning\"\n icon=\"mi/baseline/warning\"\n message=\"La tonalità ruota di 25 gradi nei gradini scuri\"\n>\n <mds-input-select>...</mds-input-select>\n</mds-input-field>\n```\n\n#### Do Not Pierce the Shadow DOM to Style the Message Area\n\nThe only supported customization surface is `--mds-input-field-message-color` and `--mds-input-field-message-background`, plus the `content` shadow part. Targeting internal elements via `>>>` or undocumented class names couples your code to the implementation and will break on minor releases.\n\n```css\n/* INCORRECT */\nmds-input-field >>> .message {\n color: red;\n}\n\n/* CORRECT */\nmds-input-field {\n --mds-input-field-message-color: rgb(var(--magma-danger-text-muted));\n --mds-input-field-message-background: rgb(var(--magma-danger-wash-base));\n}\n```\n"
17076
17177
  },
17077
17178
  "props": [
17179
+ {
17180
+ "name": "icon",
17181
+ "type": "string | undefined",
17182
+ "complexType": {
17183
+ "original": "string",
17184
+ "resolved": "string | undefined",
17185
+ "references": {}
17186
+ },
17187
+ "mutable": false,
17188
+ "attr": "icon",
17189
+ "reflectToAttr": false,
17190
+ "docs": "An icon before the label, in the colour of the variant: the state the message tells, seen at a\nglance (a verdict on the value, a check passed). Decorative: the message says the state in\nwords, and the label stays the name of the control",
17191
+ "docsTags": [],
17192
+ "values": [
17193
+ {
17194
+ "type": "string"
17195
+ },
17196
+ {
17197
+ "type": "undefined"
17198
+ }
17199
+ ],
17200
+ "optional": true,
17201
+ "required": false,
17202
+ "getter": false,
17203
+ "setter": false
17204
+ },
17078
17205
  {
17079
17206
  "name": "label",
17080
17207
  "type": "string | undefined",
@@ -17252,10 +17379,12 @@
17252
17379
  "states": [],
17253
17380
  "dependents": [],
17254
17381
  "dependencies": [
17382
+ "mds-icon",
17255
17383
  "mds-text"
17256
17384
  ],
17257
17385
  "dependencyGraph": {
17258
17386
  "mds-input-field": [
17387
+ "mds-icon",
17259
17388
  "mds-text"
17260
17389
  ]
17261
17390
  },
@@ -21280,11 +21409,40 @@
21280
21409
  }
21281
21410
  ],
21282
21411
  "usage": {
21283
- "1. Description": "The `<mds-link>` web component is the inline link of Magma: a word or a phrase inside running text, usually inside an `<mds-text>`, that opens a URL or runs an inline action. It replaces a raw `<a>` styled by hand, so links look and behave the same in every app, focus ring included.\n\n#### Semantic Behavior\n\n- **A word of the sentence**: the host is inline and has no typography of its own. It takes the font of the text around it (family, size, weight, line height, letter spacing), whatever the `typography` of the `<mds-text>` it sits in, and wraps across lines with the rest of the text.\n- **A real anchor with `href`**: the link is an `<a href>` in the shadow root, and it is the element that takes the focus. The browser gives it what it gives every link: a new tab on a modifier or middle click, the context menu, drag. A click listener on the host can cancel the navigation with `preventDefault()`, and a client-side router registered with `NavigationService.setHandler()` (from `@maggioli-design-system/magma/services`) takes the plain clicks over. A `click()` from a script follows the link too, unless a listener cancels it.\n- **An inline button without `href`**: the link becomes an element with `role=\"button\"` in the tab order; a click, Enter and Space each fire one native `click` on the host. It never submits the form it sits in. It is not a native `<button>`, which cannot wrap across lines.\n- **New tab**: `target=\"blank\"` opens the URL in a new tab without giving it access to the page (`rel=\"noopener noreferrer\"`) and adds a hidden \"(opens in a new tab)\", in the language of the page, to the name the assistive technology reads. No icon is added: pick one with `icon` if the design wants it.\n- **Icon**: `icon` draws an icon, hidden from the assistive technology, sized on a step of the spacing scale, the same in every typography. It stays on the line of the word next to it: it never wraps to a line of its own.\n- **Underline always visible**: the underline is what tells the link from the text without its color (WCAG 1.4.1), so every style keeps one, and its weight never changes. Under the pointer every link fills with a faint background that rises from the bottom, and a `weak` one also gives its line the whole color; under high contrast the tints take the full color.\n\n#### Properties & Visual Configurations\n\n- **`href`** decides what the link is: with it, a link to a page; without it, an inline action that the host's `click` listener runs. Navigation always goes through `href`, never through a click handler that changes the location.\n- **`label`** sets the text of the link; without it the link shows its default slot, which is the usual form in running text.\n- **`variant`** sets the color: `primary` (the default) paints the link with the accent, the color of links and actions on a neutral surface; `inherit` takes the color of the text around it, for a link on a colored surface (a status message, a filled banner), where the accent would lose contrast.\n- **`underline`** sets the style of the underline:\n - `solid` (the default): a thin line;\n - `dotted`: a dotted line;\n - `marker`: a tinted band under the text, lighter with `weak`, which rises under the pointer to fill the line like a highlighter, with the same faint background in both tones.\n- **`tone`** sets how much of the color the line takes: `strong` (the default) the whole color; `weak` a light tint of it, which steps back in a text dense with links and takes the whole color under the pointer. The text of the link keeps the whole color in both tones.\n- **`icon-position`** puts the icon after the text (`right`, the default: an external link, a download, a forward arrow) or before it (`left`: a back arrow).\n",
21284
- "2. Examples": "Correct and idiomatic ways to use the `<mds-link>` component, ordered from most common to most specialized. The examples assume a working knowledge of the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### A Link Inside a Sentence\n\nThe canonical form: the link sits in the default slot of an `<mds-text>`, with its text in its own default slot, and takes the font of the paragraph.\n\n```html\n<mds-text typography=\"paragraph\">\n Leggi l'<mds-link href=\"/privacy\">informativa sulla privacy</mds-link> prima di continuare.\n</mds-text>\n```\n\n#### Any Typography\n\nThe link has no typography of its own: the same markup works in a caption, a title or the reading variant.\n\n```html\n<mds-text typography=\"caption\">\n Fonte: <mds-link href=\"/report\">rapporto annuale 2025</mds-link>\n</mds-text>\n<mds-text typography=\"paragraph\" variant=\"read\">\n Il testo completo e' nell'<mds-link href=\"/regolamento\">allegato A</mds-link>.\n</mds-text>\n```\n\n#### An Inline Action\n\nWithout `href` the link is an inline button: listen for `click` on the host, which a click, Enter and Space all fire.\n\n```html\n<mds-text typography=\"paragraph\">\n Non trovi quello che cerchi? <mds-link id=\"help\">Chiedi aiuto</mds-link> al supporto.\n</mds-text>\n\n<script>\n document.getElementById('help').addEventListener('click', () => openHelp());\n</script>\n```\n\n#### A Link That Opens a New Tab\n\nWith `target=\"blank\"` the component adds `rel=\"noopener noreferrer\"` and tells the assistive technology the link opens a new tab; the icon is a choice of the design.\n\n```html\n<mds-text typography=\"detail\">\n Consulta il\n <mds-link href=\"https://example.com/report.pdf\" target=\"blank\" icon=\"mi/baseline/open-in-new\">rapporto completo</mds-link>.\n</mds-text>\n```\n\n#### An Icon Before the Text\n\nUse `icon-position=\"left\"` for an icon that leads, such as a back arrow.\n\n```html\n<mds-text typography=\"paragraph\">\n <mds-link href=\"/indice\" icon=\"mi/baseline/arrow-back\" icon-position=\"left\">Torna all'indice</mds-link>\n</mds-text>\n```\n\n#### A Link on a Colored Surface\n\nOn a status or filled surface the accent loses contrast: `variant=\"inherit\"` takes the color of the text, and the underline still marks the link.\n\n```html\n<mds-banner variant=\"error\" headline=\"Pagamento rifiutato\">\n <mds-text typography=\"detail\">\n <mds-link href=\"/carta\" variant=\"inherit\">Aggiorna la carta</mds-link> per riprovare.\n </mds-text>\n</mds-banner>\n```\n\n#### Routing in a Single-Page App\n\nRegister the router once: plain clicks on every `mds-link` (and `mds-button` with `href`) go to it, with the browser navigation already cancelled; modifier clicks, other origins and `target=\"blank\"` stay with the browser.\n\n```javascript\nimport { NavigationService } from '@maggioli-design-system/magma/services';\n\nNavigationService.setHandler((href) => router.push(href));\n```\n\n#### Styling Customization\n\nChange the color through `--mds-link-color`, with a semantic role, so dark mode, named themes and high contrast keep working - see [`agents/color.md`](../../../../agents/color.md).\n\n```css\n.legal-note mds-link {\n --mds-link-color: rgb(var(--magma-text-muted));\n}\n```\n",
21412
+ "1. Description": "The `<mds-link>` web component is the inline link of Magma: a word or a phrase inside running text, usually inside an `<mds-text>`, that opens a URL or runs an inline action. It replaces a raw `<a>` styled by hand, so links look and behave the same in every app, focus ring included.\n\n#### Semantic Behavior\n\n- **A word of the sentence**: the host is inline and has no typography of its own. It takes the font of the text around it (family, size, weight, line height, letter spacing), whatever the `typography` of the `<mds-text>` it sits in, and wraps across lines with the rest of the text.\n- **A real anchor with `href`**: the link is an `<a href>` in the shadow root, and it is the element that takes the focus. The browser gives it what it gives every link: a new tab on a modifier or middle click, the context menu, drag. A click listener on the host can cancel the navigation with `preventDefault()`, and a client-side router registered with `NavigationService.setHandler()` (from `@maggioli-design-system/magma/services`) takes the plain clicks over. A `click()` from a script follows the link too, unless a listener cancels it.\n- **An inline button without `href`**: the link becomes an element with `role=\"button\"` in the tab order; a click, Enter and Space each fire one native `click` on the host. It never submits the form it sits in. It is not a native `<button>`, which cannot wrap across lines.\n- **New tab**: `target=\"blank\"` opens the URL in a new tab without giving it access to the page (`rel=\"noopener noreferrer\"`) and adds a hidden \"(opens in a new tab)\", in the language of the page, to the name the assistive technology reads. No icon is added: pick one with `icon` if the design wants it.\n- **Download**: `download` saves the file of `href` instead of opening it, as on a native `<a download>`: with no value the file keeps the name the server gives it, a value names the saved file. A file the browser can show (JSON, XML, a PDF) opens in the tab without it. Browsers apply it to the URLs of the origin of the page, `blob:` and `data:` only: a link to another origin opens the file. A download never goes to the router: the browser saves the file on a click, on Enter and on the `click()` of a script.\n- **Icon**: `icon` draws an icon, hidden from the assistive technology, sized on a step of the spacing scale, the same in every typography. It stays on the line of the word next to it: it never wraps to a line of its own.\n- **Underline always visible**: the underline is what tells the link from the text without its color (WCAG 1.4.1), so every style keeps one, and its weight never changes. Under the pointer every link fills with a faint background that rises from the bottom, and a `weak` one also gives its line the whole color; under high contrast the tints take the full color.\n\n#### Properties & Visual Configurations\n\n- **`href`** decides what the link is: with it, a link to a page; without it, an inline action that the host's `click` listener runs. Navigation always goes through `href`, never through a click handler that changes the location.\n- **`label`** sets the text of the link; without it the link shows its default slot, which is the usual form in running text.\n- **`variant`** sets the color: `primary` (the default) paints the link with the accent, the color of links and actions on a neutral surface; `inherit` takes the color of the text around it, for a link on a colored surface (a status message, a filled banner), where the accent would lose contrast.\n- **`underline`** sets the style of the underline:\n - `solid` (the default): a thin line;\n - `dotted`: a dotted line;\n - `marker`: a tinted band under the text, lighter with `weak`, which rises under the pointer to fill the line like a highlighter, with the same faint background in both tones.\n- **`tone`** sets how much of the color the line takes: `strong` (the default) the whole color; `weak` a light tint of it, which steps back in a text dense with links and takes the whole color under the pointer. The text of the link keeps the whole color in both tones.\n- **`icon-position`** puts the icon after the text (`right`, the default: an external link, a download, a forward arrow) or before it (`left`: a back arrow).\n",
21413
+ "2. Examples": "Correct and idiomatic ways to use the `<mds-link>` component, ordered from most common to most specialized. The examples assume a working knowledge of the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### A Link Inside a Sentence\n\nThe canonical form: the link sits in the default slot of an `<mds-text>`, with its text in its own default slot, and takes the font of the paragraph.\n\n```html\n<mds-text typography=\"paragraph\">\n Leggi l'<mds-link href=\"/privacy\">informativa sulla privacy</mds-link> prima di continuare.\n</mds-text>\n```\n\n#### Any Typography\n\nThe link has no typography of its own: the same markup works in a caption, a title or the reading variant.\n\n```html\n<mds-text typography=\"caption\">\n Fonte: <mds-link href=\"/report\">rapporto annuale 2025</mds-link>\n</mds-text>\n<mds-text typography=\"paragraph\" variant=\"read\">\n Il testo completo e' nell'<mds-link href=\"/regolamento\">allegato A</mds-link>.\n</mds-text>\n```\n\n#### An Inline Action\n\nWithout `href` the link is an inline button: listen for `click` on the host, which a click, Enter and Space all fire.\n\n```html\n<mds-text typography=\"paragraph\">\n Non trovi quello che cerchi? <mds-link id=\"help\">Chiedi aiuto</mds-link> al supporto.\n</mds-text>\n\n<script>\n document.getElementById('help').addEventListener('click', () => openHelp());\n</script>\n```\n\n#### A Link That Opens a New Tab\n\nWith `target=\"blank\"` the component adds `rel=\"noopener noreferrer\"` and tells the assistive technology the link opens a new tab; the icon is a choice of the design.\n\n```html\n<mds-text typography=\"detail\">\n Consulta il\n <mds-link href=\"https://example.com/report.pdf\" target=\"blank\" icon=\"mi/baseline/open-in-new\">rapporto completo</mds-link>.\n</mds-text>\n```\n\n#### A Link That Downloads Its File\n\n`download` saves the file instead of showing it in the tab; its value is the name of the saved file. The URL has to be on the origin of the page.\n\n```html\n<mds-text typography=\"detail\">\n Scarica i colori come\n <mds-link href=\"/downloads/colors.xml\" download=\"colors.xml\" icon=\"mi/baseline/download\">file XML</mds-link>.\n</mds-text>\n```\n\n#### An Icon Before the Text\n\nUse `icon-position=\"left\"` for an icon that leads, such as a back arrow.\n\n```html\n<mds-text typography=\"paragraph\">\n <mds-link href=\"/indice\" icon=\"mi/baseline/arrow-back\" icon-position=\"left\">Torna all'indice</mds-link>\n</mds-text>\n```\n\n#### A Link on a Colored Surface\n\nOn a status or filled surface the accent loses contrast: `variant=\"inherit\"` takes the color of the text, and the underline still marks the link.\n\n```html\n<mds-banner variant=\"error\" headline=\"Pagamento rifiutato\">\n <mds-text typography=\"detail\">\n <mds-link href=\"/carta\" variant=\"inherit\">Aggiorna la carta</mds-link> per riprovare.\n </mds-text>\n</mds-banner>\n```\n\n#### Routing in a Single-Page App\n\nRegister the router once: plain clicks on every `mds-link` (and `mds-button` with `href`) go to it, with the browser navigation already cancelled; modifier clicks, other origins, `target=\"blank\"` and `download` stay with the browser.\n\n```javascript\nimport { NavigationService } from '@maggioli-design-system/magma/services';\n\nNavigationService.setHandler((href) => router.push(href));\n```\n\n#### Styling Customization\n\nChange the color through `--mds-link-color`, with a semantic role, so dark mode, named themes and high contrast keep working - see [`agents/color.md`](../../../../agents/color.md).\n\n```css\n.legal-note mds-link {\n --mds-link-color: rgb(var(--magma-text-muted));\n}\n```\n",
21285
21414
  "3. Mistakes": "Common incorrect uses of `<mds-link>`. 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/mistakes.md`](../../../../agents/mistakes.md) - they apply here too but are not repeated.\n\n#### Do Not Use `mds-button` for a Link Inside a Sentence\n\n`mds-button` is a block-level control with its own typography and padding: inside a sentence it breaks the line and the font. A word that links belongs to `mds-link`.\n\n```html\n<!-- INCORRECT -->\n<mds-text typography=\"paragraph\">\n Leggi l'<mds-button href=\"/privacy\" tone=\"text\" label=\"informativa\"></mds-button> prima di continuare.\n</mds-text>\n\n<!-- CORRECT -->\n<mds-text typography=\"paragraph\">\n Leggi l'<mds-link href=\"/privacy\">informativa</mds-link> prima di continuare.\n</mds-text>\n```\n\n#### Do Not Use `mds-link` for a Standalone Action\n\nA call to action, a form submit or a step of a flow is a control, not a word of a sentence: it needs the size, the variants and the form participation of `mds-button`.\n\n```html\n<!-- INCORRECT -->\n<form>\n <mds-link>Invia la richiesta</mds-link>\n</form>\n\n<!-- CORRECT -->\n<form>\n <mds-button type=\"submit\" label=\"Invia la richiesta\"></mds-button>\n</form>\n```\n\n#### Do Not Navigate From a Click Handler\n\nA link without `href` is a button for the browser: no new tab on a modifier click, no context menu, no address to copy, and the assistive technology announces a button. Give the URL to `href`.\n\n```html\n<!-- INCORRECT -->\n<mds-link onclick=\"location.href = '/privacy'\">informativa</mds-link>\n\n<!-- CORRECT -->\n<mds-link href=\"/privacy\">informativa</mds-link>\n```\n\n#### Do Not Style a Raw Anchor Inside `mds-text`\n\nA hand-styled `<a>` drifts from app to app in color, underline and hover, and usually loses the focus ring.\n\n```html\n<!-- INCORRECT -->\n<mds-text typography=\"paragraph\">\n Leggi l'<a href=\"/privacy\" class=\"text-accent-fg underline\">informativa</a>.\n</mds-text>\n\n<!-- CORRECT -->\n<mds-text typography=\"paragraph\">\n Leggi l'<mds-link href=\"/privacy\">informativa</mds-link>.\n</mds-text>\n```\n\n#### Do Not Write the New-Tab Notice Yourself\n\nWith `target=\"blank\"` the component already tells the assistive technology the link opens a new tab, in the language of the page: a notice in the text is read twice.\n\n```html\n<!-- INCORRECT -->\n<mds-link href=\"/report.pdf\" target=\"blank\">Rapporto (si apre in una nuova scheda)</mds-link>\n\n<!-- CORRECT -->\n<mds-link href=\"/report.pdf\" target=\"blank\">Rapporto</mds-link>\n```\n\n#### Do Not Remove the Underline\n\nWithout the underline the link is told from the text only by its color, which fails users who cannot see it (WCAG 1.4.1). For a quieter line, lower the `tone`.\n\n```css\n/* INCORRECT */\nmds-link::part(link) {\n text-decoration: none;\n}\n\n/* CORRECT */\n/* <mds-link href=\"/privacy\" tone=\"weak\">informativa</mds-link> */\n```\n"
21286
21415
  },
21287
21416
  "props": [
21417
+ {
21418
+ "name": "download",
21419
+ "type": "boolean | string | undefined",
21420
+ "complexType": {
21421
+ "original": "boolean | string",
21422
+ "resolved": "boolean | string | undefined",
21423
+ "references": {}
21424
+ },
21425
+ "mutable": false,
21426
+ "attr": "download",
21427
+ "reflectToAttr": false,
21428
+ "docs": "Saves the file of `href` instead of opening it, as the `download` attribute of `<a>`: present\nwith no value, or `true`, the file takes the name the server gives it; a string is the name\nof the saved file. Browsers apply it to the URLs of the origin of the page, `blob:` and\n`data:`: a link to another origin opens the file as without it. A download never goes to the\nrouter registered with `NavigationService`",
21429
+ "docsTags": [],
21430
+ "values": [
21431
+ {
21432
+ "type": "boolean"
21433
+ },
21434
+ {
21435
+ "type": "string"
21436
+ },
21437
+ {
21438
+ "type": "undefined"
21439
+ }
21440
+ ],
21441
+ "optional": true,
21442
+ "required": false,
21443
+ "getter": false,
21444
+ "setter": false
21445
+ },
21288
21446
  {
21289
21447
  "name": "href",
21290
21448
  "type": "string | undefined",
@@ -29226,7 +29384,7 @@
29226
29384
  }
29227
29385
  ],
29228
29386
  "usage": {
29229
- "1. Description": "The `<mds-stepper-bar>` web component is the Magma Design System container that orchestrates a multi-step progress flow, coordinating a set of slotted `<mds-stepper-bar-item>` children and revealing the matching content panel for the active step. It has no native HTML equivalent; it composes a stepper indicator track with a switchable content region.\n\n#### Semantic Behavior\n\n- **Compound parent**: It is the controlling parent of `<mds-stepper-bar-item>` children placed in the default slot, driving every child's `done`/`current` state - children do not manage their own progression.\n- **Active step derivation**: From `itemsDone` it marks all earlier items as `done`, the item at the current index as `current`, and clears the rest; the active step is `itemsDone - 1`.\n- **Content synchronization**: Each `slot=\"content\"` element is paired by position to a stepper item; only the panel matching the current index is shown. The other panels get the `hidden` attribute, so no style of the page is needed (a `display` the page sets on a panel overrides it).\n- **Child requests, page decides**: A step that is done emits `mdsStepperBarItemDone` when the user activates it; the bar does not move by itself, progress is driven by `itemsDone` only. To let the user go back, listen for the event and set `itemsDone` to the index of that item plus one.\n- **Auto-scroll**: When a step becomes current the indicator track scrolls horizontally to center the active item.\n- **Change event**: It emits `mdsStepperBarChange` when it loads and whenever `itemsDone` changes, with a detail of the active `step` index and a comma-joined `value` string collected from the completed items.\n\n#### Properties & Visual Configurations\n\n- **`itemsDone`** is the controlled entry point for progress: `0` means no step completed, `1` activates the first step, and `last + 1` marks the whole flow complete. Treat it as the single source of truth for which step is current rather than mutating children directly.\n\n#### Other behavioral props\n\n- **`navigation`** selects how the indicator track is traversed: `'none'` (default) keeps the track static, while `'scrollbar'` exposes a horizontal scrollbar (styleable through the `--mds-stepper-bar-scrollbar-*` custom properties) for flows with many steps.\n",
29387
+ "1. Description": "The `<mds-stepper-bar>` web component is the Magma Design System container that orchestrates a multi-step progress flow, coordinating a set of slotted `<mds-stepper-bar-item>` children and revealing the matching content panel for the active step. It has no native HTML equivalent; it composes a stepper indicator track with a switchable content region.\n\n#### Semantic Behavior\n\n- **Compound parent**: It is the controlling parent of `<mds-stepper-bar-item>` children placed in the default slot, driving every child's `done`/`current` state - children do not manage their own progression.\n- **Active step derivation**: From `itemsDone` it marks all earlier items as `done`, the item at the current index as `current`, and clears the rest; the active step is `itemsDone - 1`.\n- **Content synchronization**: Each `slot=\"content\"` element is paired by position to a stepper item; only the panel matching the current index is shown. The other panels get the `hidden` attribute, so no style of the page is needed (a `display` the page sets on a panel overrides it). The panels are the direct children with `slot=\"content\"`, read again at every step and whenever the slot changes: a panel that a framework renders, replaces or removes after the load (conditional rendering, a keyed list) takes the state of its step at once.\n- **Child requests, page decides**: A step that is done emits `mdsStepperBarItemDone` when the user activates it; the bar does not move by itself, progress is driven by `itemsDone` only. To let the user go back, listen for the event and set `itemsDone` to the index of that item plus one.\n- **Auto-scroll**: When a step becomes current the indicator track scrolls horizontally to center the active item.\n- **Change event**: It emits `mdsStepperBarChange` when it loads and whenever `itemsDone` changes, with a detail of the active `step` index and a comma-joined `value` string collected from the completed items.\n\n#### Properties & Visual Configurations\n\n- **`itemsDone`** is the controlled entry point for progress: `0` means no step completed, `1` activates the first step, and `last + 1` marks the whole flow complete. Treat it as the single source of truth for which step is current rather than mutating children directly.\n\n#### Other behavioral props\n\n- **`navigation`** selects how the indicator track is traversed: `'none'` (default) keeps the track static, while `'scrollbar'` exposes a horizontal scrollbar (styleable through the `--mds-stepper-bar-scrollbar-*` custom properties) for flows with many steps.\n",
29230
29388
  "2. Examples": "Correct and idiomatic ways to use the `<mds-stepper-bar>` component, ordered from most common to most specialized. The examples assume a working knowledge of the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Minimal Stepper with Step Labels\n\nThe canonical form. Place `<mds-stepper-bar-item>` elements in the default slot, one per step. Every item requires `icon` and `label`; `badge` and `step` enable the status badge and step counter visuals. Set `items-done` to control which step is active - `1` activates the first step.\n\n```html\n<mds-stepper-bar items-done=\"1\">\n <mds-stepper-bar-item\n badge\n step\n icon=\"mi/baseline/person\"\n icon-checked=\"mi/baseline/done\"\n label=\"Dati account\"\n ></mds-stepper-bar-item>\n <mds-stepper-bar-item\n badge\n step\n icon=\"mi/baseline/badge\"\n icon-checked=\"mi/baseline/done\"\n label=\"Dati personali\"\n ></mds-stepper-bar-item>\n <mds-stepper-bar-item\n badge\n step\n icon=\"mi/baseline/lock-open\"\n icon-checked=\"mi/baseline/done\"\n label=\"Attivazione\"\n ></mds-stepper-bar-item>\n</mds-stepper-bar>\n```\n\n#### Advancing Steps Programmatically\n\nDrive progress by updating `items-done` from outside. `itemsDone = 0` leaves all items pending; `itemsDone = N + 1` (where N is the total number of items) marks the whole flow as complete. Do not mutate the children's `done` or `current` attributes directly - only the parent controls those.\n\n```html\n<mds-stepper-bar id=\"reg-stepper\" items-done=\"1\">\n <mds-stepper-bar-item badge step icon=\"mi/baseline/person\" icon-checked=\"mi/baseline/done\" label=\"Account\"></mds-stepper-bar-item>\n <mds-stepper-bar-item badge step icon=\"mi/baseline/badge\" icon-checked=\"mi/baseline/done\" label=\"Profilo\"></mds-stepper-bar-item>\n <mds-stepper-bar-item badge step icon=\"mi/baseline/done\" icon-checked=\"mi/baseline/done\" label=\"Conferma\"></mds-stepper-bar-item>\n</mds-stepper-bar>\n\n<mds-button label=\"Prossimo\" variant=\"primary\" tone=\"strong\" id=\"btn-next\"></mds-button>\n\n<script>\n let step = 1;\n document.getElementById('btn-next').addEventListener('click', () => {\n step += 1;\n document.getElementById('reg-stepper').setAttribute('items-done', String(step));\n });\n</script>\n```\n\n#### Listening to the Change Event\n\nReact to step changes via `mdsStepperBarChange`. The event detail carries `step` (zero-based index of the current item) and `value` (comma-joined `value` attributes of all completed items).\n\n```html\n<mds-stepper-bar id=\"wizard\" items-done=\"1\">\n <mds-stepper-bar-item value=\"account\" badge step icon=\"mi/baseline/person\" icon-checked=\"mi/baseline/done\" label=\"Account\"></mds-stepper-bar-item>\n <mds-stepper-bar-item value=\"profilo\" badge step icon=\"mi/baseline/badge\" icon-checked=\"mi/baseline/done\" label=\"Profilo\"></mds-stepper-bar-item>\n <mds-stepper-bar-item value=\"conferma\" badge step icon=\"mi/baseline/done\" icon-checked=\"mi/baseline/done\" label=\"Conferma\"></mds-stepper-bar-item>\n</mds-stepper-bar>\n\n<script>\n document.getElementById('wizard').addEventListener('mdsStepperBarChange', (e) => {\n console.log('Step corrente:', e.detail.step);\n console.log('Passi completati:', e.detail.value); // es. \"account,profilo\"\n });\n</script>\n```\n\n#### Content Panels Synchronized with Steps\n\nAdd elements with `slot=\"content\"` - one per step in the same order as the items. The component hides all panels except the one matching the active step, with the `hidden` attribute: no style of the page is needed. Nest navigation buttons inside each panel to let users move forward and back.\n\n```html\n<mds-stepper-bar items-done=\"1\">\n <mds-stepper-bar-item badge step icon=\"mi/baseline/person\" icon-checked=\"mi/baseline/done\" label=\"Account\"></mds-stepper-bar-item>\n <mds-stepper-bar-item badge step icon=\"mi/baseline/badge\" icon-checked=\"mi/baseline/done\" label=\"Profilo\"></mds-stepper-bar-item>\n\n <div slot=\"content\">\n <mds-text>Inserisci i dati del tuo account.</mds-text>\n <mds-button\n label=\"Prossimo\"\n variant=\"primary\"\n tone=\"strong\"\n onclick=\"document.querySelector('mds-stepper-bar').setAttribute('items-done', '2')\"\n ></mds-button>\n </div>\n\n <div slot=\"content\">\n <mds-text>Completa il tuo profilo.</mds-text>\n <mds-button\n label=\"Indietro\"\n variant=\"dark\"\n tone=\"outline\"\n onclick=\"document.querySelector('mds-stepper-bar').setAttribute('items-done', '1')\"\n ></mds-button>\n <mds-button\n label=\"Conferma\"\n variant=\"primary\"\n tone=\"strong\"\n onclick=\"document.querySelector('mds-stepper-bar').setAttribute('items-done', '3')\"\n ></mds-button>\n </div>\n</mds-stepper-bar>\n```\n\n#### Scrollbar Navigation for Long Flows\n\nFor flows with many steps, set `navigation=\"scrollbar\"` to expose a styled horizontal scrollbar under the indicator track. The active item scrolls into view automatically; the scrollbar appearance is configurable through the `--mds-stepper-bar-scrollbar-*` custom properties.\n\n```html\n<mds-stepper-bar items-done=\"1\" navigation=\"scrollbar\">\n <mds-stepper-bar-item badge step icon=\"mi/baseline/person\" icon-checked=\"mi/baseline/done\" label=\"Account\"></mds-stepper-bar-item>\n <mds-stepper-bar-item badge step icon=\"mi/baseline/badge\" icon-checked=\"mi/baseline/done\" label=\"Dati personali\"></mds-stepper-bar-item>\n <mds-stepper-bar-item badge step icon=\"mi/round/email\" icon-checked=\"mi/baseline/done\" label=\"Newsletter\"></mds-stepper-bar-item>\n <mds-stepper-bar-item badge step icon=\"mi/baseline/lock-open\" icon-checked=\"mi/baseline/done\" label=\"Attivazione\"></mds-stepper-bar-item>\n <mds-stepper-bar-item badge step icon=\"mi/baseline/login\" icon-checked=\"mi/baseline/done\" label=\"Accedi\"></mds-stepper-bar-item>\n <mds-stepper-bar-item badge step icon=\"mi/baseline/done\" icon-checked=\"mi/baseline/done\" label=\"Completato\"></mds-stepper-bar-item>\n</mds-stepper-bar>\n```\n\n#### Offset Margin inside a Padded Container\n\nWhen the stepper bar lives inside a padded card or panel, use `--mds-stepper-bar-offset-margin` to let the indicator track bleed into the padding without altering the outer container's spacing.\n\n```css\n.wizard-card mds-stepper-bar {\n --mds-stepper-bar-offset-margin: 24px;\n}\n```\n\n```html\n<div class=\"wizard-card\" style=\"padding: 24px;\">\n <mds-stepper-bar items-done=\"2\">\n <mds-stepper-bar-item badge step icon=\"mi/baseline/person\" icon-checked=\"mi/baseline/done\" label=\"Account\"></mds-stepper-bar-item>\n <mds-stepper-bar-item badge step icon=\"mi/baseline/badge\" icon-checked=\"mi/baseline/done\" label=\"Profilo\"></mds-stepper-bar-item>\n <mds-stepper-bar-item badge step icon=\"mi/baseline/done\" icon-checked=\"mi/baseline/done\" label=\"Conferma\"></mds-stepper-bar-item>\n </mds-stepper-bar>\n</div>\n```\n\n#### Styling the Gap\n\nSet the item spacing through the public `--mds-stepper-bar-*` CSS custom properties; the scrollbar of the indicator track is styled by the component. Use semantic color roles via `rgb(var(--magma-<role>))` for any colour you set, so dark mode and high-contrast keep working.\n\n```css\nmds-stepper-bar {\n --mds-stepper-bar-gap: calc(var(--spacing) * 700);\n}\n```\n\n#### Targeting Shadow Parts for Deep Customization\n\nThe two documented shadow parts - `items` (the indicator track wrapper) and `contents` (the content panel wrapper) - let you apply layout overrides that CSS custom properties cannot express. Limit `::part()` use to structural needs only; prefer the `--mds-stepper-bar-*` properties for everything else.\n\n```css\nmds-stepper-bar::part(items) {\n padding-block: calc(var(--spacing) * 400);\n border-bottom: 1px solid rgb(var(--magma-border-muted));\n}\n\nmds-stepper-bar::part(contents) {\n padding-block: calc(var(--spacing) * 600);\n}\n```\n",
29231
29389
  "3. Mistakes": "Common incorrect uses of `<mds-stepper-bar>`. 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/mistakes.md`](../../../../agents/mistakes.md) - they apply here too but are not repeated.\n\n#### Do Not Mutate Child State Directly\n\n`done` and `current` on `<mds-stepper-bar-item>` are managed exclusively by the parent; writing them from outside bypasses the synchronization logic and breaks content panel visibility, scroll centering, and the `mdsStepperBarChange` event. Drive progress through `items-done` on the parent instead.\n\n```html\n<!-- INCORRECT -->\n<mds-stepper-bar>\n <mds-stepper-bar-item done icon=\"mi/baseline/person\" icon-checked=\"mi/baseline/done\" label=\"Account\"></mds-stepper-bar-item>\n <mds-stepper-bar-item current icon=\"mi/baseline/badge\" icon-checked=\"mi/baseline/done\" label=\"Profilo\"></mds-stepper-bar-item>\n</mds-stepper-bar>\n\n<!-- CORRECT -->\n<mds-stepper-bar items-done=\"2\">\n <mds-stepper-bar-item icon=\"mi/baseline/person\" icon-checked=\"mi/baseline/done\" label=\"Account\"></mds-stepper-bar-item>\n <mds-stepper-bar-item icon=\"mi/baseline/badge\" icon-checked=\"mi/baseline/done\" label=\"Profilo\"></mds-stepper-bar-item>\n</mds-stepper-bar>\n```\n\n#### Do Not Listen for Native `change` Events\n\n`<mds-stepper-bar>` emits `mdsStepperBarChange` - not a native `change` event. Native DOM events do not bubble out of shadow DOM reliably, so listening for `change` will silently never fire.\n\n```html\n<!-- INCORRECT -->\n<mds-stepper-bar id=\"stepper\" items-done=\"1\">...</mds-stepper-bar>\n<script>\n document.getElementById('stepper').addEventListener('change', handler);\n</script>\n\n<!-- CORRECT -->\n<mds-stepper-bar id=\"stepper\" items-done=\"1\">...</mds-stepper-bar>\n<script>\n document.getElementById('stepper').addEventListener('mdsStepperBarChange', handler);\n</script>\n```\n\n#### Do Not Use `<mds-stepper-bar-item>` Outside `<mds-stepper-bar>`\n\n`<mds-stepper-bar-item>` is a compound child; it relies on the parent to receive its `done`/`current` state. Outside the parent it renders without state management and will not advance any stepper.\n\n```html\n<!-- INCORRECT -->\n<div class=\"custom-steps\">\n <mds-stepper-bar-item icon=\"mi/baseline/person\" icon-checked=\"mi/baseline/done\" label=\"Account\"></mds-stepper-bar-item>\n <mds-stepper-bar-item icon=\"mi/baseline/badge\" icon-checked=\"mi/baseline/done\" label=\"Profilo\"></mds-stepper-bar-item>\n</div>\n\n<!-- CORRECT -->\n<mds-stepper-bar items-done=\"1\">\n <mds-stepper-bar-item icon=\"mi/baseline/person\" icon-checked=\"mi/baseline/done\" label=\"Account\"></mds-stepper-bar-item>\n <mds-stepper-bar-item icon=\"mi/baseline/badge\" icon-checked=\"mi/baseline/done\" label=\"Profilo\"></mds-stepper-bar-item>\n</mds-stepper-bar>\n```\n\n#### Do Not Wrap Items in Extra Elements\n\nThe indicator track lays out its direct slot children (flex row, `--mds-stepper-bar-gap`, scroll snapping): a wrapper becomes a single item of the track, so the steps lose that layout. Compound children must be direct children of the parent.\n\n```html\n<!-- INCORRECT -->\n<mds-stepper-bar items-done=\"1\">\n <div class=\"step-group\">\n <mds-stepper-bar-item icon=\"mi/baseline/person\" icon-checked=\"mi/baseline/done\" label=\"Account\"></mds-stepper-bar-item>\n <mds-stepper-bar-item icon=\"mi/baseline/badge\" icon-checked=\"mi/baseline/done\" label=\"Profilo\"></mds-stepper-bar-item>\n </div>\n</mds-stepper-bar>\n\n<!-- CORRECT -->\n<mds-stepper-bar items-done=\"1\">\n <mds-stepper-bar-item icon=\"mi/baseline/person\" icon-checked=\"mi/baseline/done\" label=\"Account\"></mds-stepper-bar-item>\n <mds-stepper-bar-item icon=\"mi/baseline/badge\" icon-checked=\"mi/baseline/done\" label=\"Profilo\"></mds-stepper-bar-item>\n</mds-stepper-bar>\n```\n\n#### Do Not Supply Fewer `slot=\"content\"` Panels than Items\n\nThe component pairs panels to items by index position; if a panel is missing for a given index, the content region for that step will be empty with no warning. Always provide exactly one `slot=\"content\"` element per `<mds-stepper-bar-item>`.\n\n```html\n<!-- INCORRECT - three items, only two content panels -->\n<mds-stepper-bar items-done=\"1\">\n <mds-stepper-bar-item icon=\"mi/baseline/person\" icon-checked=\"mi/baseline/done\" label=\"Account\"></mds-stepper-bar-item>\n <mds-stepper-bar-item icon=\"mi/baseline/badge\" icon-checked=\"mi/baseline/done\" label=\"Profilo\"></mds-stepper-bar-item>\n <mds-stepper-bar-item icon=\"mi/baseline/done\" icon-checked=\"mi/baseline/done\" label=\"Conferma\"></mds-stepper-bar-item>\n\n <div slot=\"content\"><mds-text>Account</mds-text></div>\n <div slot=\"content\"><mds-text>Profilo</mds-text></div>\n</mds-stepper-bar>\n\n<!-- CORRECT - one panel per item -->\n<mds-stepper-bar items-done=\"1\">\n <mds-stepper-bar-item icon=\"mi/baseline/person\" icon-checked=\"mi/baseline/done\" label=\"Account\"></mds-stepper-bar-item>\n <mds-stepper-bar-item icon=\"mi/baseline/badge\" icon-checked=\"mi/baseline/done\" label=\"Profilo\"></mds-stepper-bar-item>\n <mds-stepper-bar-item icon=\"mi/baseline/done\" icon-checked=\"mi/baseline/done\" label=\"Conferma\"></mds-stepper-bar-item>\n\n <div slot=\"content\"><mds-text>Account</mds-text></div>\n <div slot=\"content\"><mds-text>Profilo</mds-text></div>\n <div slot=\"content\"><mds-text>Conferma</mds-text></div>\n</mds-stepper-bar>\n```\n\n#### Do Not Set `items-done` as a Boolean\n\n`items-done` is a number, not a flag. Setting it as a bare boolean attribute sends the string `\"\"`, which parses to `NaN`: no step is marked current or done. Always pass a numeric value.\n\n```html\n<!-- INCORRECT -->\n<mds-stepper-bar items-done>...</mds-stepper-bar>\n\n<!-- CORRECT -->\n<mds-stepper-bar items-done=\"1\">...</mds-stepper-bar>\n```\n"
29232
29390
  },
@@ -29420,7 +29578,7 @@
29420
29578
  }
29421
29579
  ],
29422
29580
  "usage": {
29423
- "1. Description": "The `<mds-stepper-bar-item>` web component represents a single step inside a [`<mds-stepper-bar>`](../mds-stepper-bar/AGENTS.md) progress indicator, rendering the step's icon, optional ordinal label, descriptive text and status badge. It has no standalone meaning: it is the unit the parent stepper orchestrates to express a sequential, multi-step flow.\n\n#### Semantic Behavior\n\n- **Compound child only**: Must be placed as a direct default-slot child of `<mds-stepper-bar>`; it is not used standalone or mixed with other child types in that slot.\n- **State driven by the parent**: The `done` and `current` props are not set per item by the consumer - the parent's `itemsDone` prop drives `done`/`current` on each child, so an item's visual state is a function of its position relative to the active step.\n- **Index resolution**: The item computes its own ordinal from its position among the parent's children; this index feeds the localized \"step N\" caption rendered when `step` is enabled.\n- **Three-way status badge**: When `badge` is true the item renders a status badge whose variant and localized text reflect the resolved state - `success`/done, `info`/current, or `dark`/queued.\n- **Icon swap on completion**: The displayed icon switches from `icon` to `iconChecked` once the item is done and no longer current.\n- **Going back**: A step that is done (and not current) is a button in the tab order: a click or Enter emits `mdsStepperBarItemDone` with its `{ value }`. It asks, it does not move: the page goes back by setting `itemsDone` on the bar. The current and the following steps are not interactive.\n- **Localization**: Step, badge and status strings are localized (el/en/es/it).\n\n#### Properties & Visual Configurations\n\nMost state props are managed by the parent rather than the consumer. The props worth configuring directly on each item are:\n\n- **`icon` / `iconChecked`**: Set `icon` for the default and current appearance; set `iconChecked` only when the completed step should show a different glyph (it defaults to `icon`).\n- **`step`**: Enable to surface the auto-numbered \"step N\" caption above the label - use it for explicitly ordered flows where the number aids orientation.\n- **`badge`**: Enable to show the queued/current/done status pill; prefer it when status legibility matters more than horizontal compactness.\n- **`value`**: The token the parent collects from the completed items into the `value` of its `mdsStepperBarChange` detail (comma-joined); set it so the parent can aggregate which steps have been completed.\n- **`typography`**: Overrides the label's typography token (defaults to `h6`); lower it for denser bars.\n",
29581
+ "1. Description": "The `<mds-stepper-bar-item>` web component represents a single step inside a [`<mds-stepper-bar>`](../mds-stepper-bar/AGENTS.md) progress indicator, rendering the step's icon, optional ordinal label, descriptive text and status badge. It has no standalone meaning: it is the unit the parent stepper orchestrates to express a sequential, multi-step flow.\n\n#### Semantic Behavior\n\n- **Compound child only**: Must be placed as a direct default-slot child of `<mds-stepper-bar>`; it is not used standalone or mixed with other child types in that slot.\n- **State driven by the parent**: The `done` and `current` props are not set per item by the consumer - the parent's `itemsDone` prop drives `done`/`current` on each child, so an item's visual state is a function of its position relative to the active step.\n- **Index resolution**: The item computes its own ordinal from its position among the parent's children; this index feeds the localized \"step N\" caption rendered when `step` is enabled (\"Step 2\" in English, \"Passo 2\" in Italian), or the `{{ index }}` of the caption the page writes in `step-label`.\n- **Three-way status badge**: When `badge` is true the item renders a status badge whose variant and localized text reflect the resolved state - `success`/done, `info`/current, or `dark`/queued.\n- **Icon swap on completion**: The displayed icon switches from `icon` to `iconChecked` once the item is done and no longer current.\n- **Going back**: A step that is done (and not current) is a button in the tab order: a click or Enter emits `mdsStepperBarItemDone` with its `{ value }`. It asks, it does not move: the page goes back by setting `itemsDone` on the bar. The current and the following steps are not interactive.\n- **Localization**: Step, badge and status strings are localized (el/en/es/it); `step-label` replaces the step caption in any other language.\n\n#### Properties & Visual Configurations\n\nMost state props are managed by the parent rather than the consumer. The props worth configuring directly on each item are:\n\n- **`icon` / `iconChecked`**: Set `icon` for the default and current appearance; set `iconChecked` only when the completed step should show a different glyph (it defaults to `icon`).\n- **`step`**: Enable to surface the auto-numbered \"step N\" caption above the label - use it for explicitly ordered flows where the number aids orientation.\n- **`step-label`**: The text of that caption, when the page needs another word or a language the component has no texts for: `{{ index }}` in it becomes the position of the step (`step-label=\"Fase {{ index }}\"` gives \"Fase 1\", \"Fase 2\"), a text without it is shown as it is. `step` still decides whether the caption is shown.\n- **`badge`**: Enable to show the queued/current/done status pill; prefer it when status legibility matters more than horizontal compactness.\n- **`value`**: The token the parent collects from the completed items into the `value` of its `mdsStepperBarChange` detail (comma-joined); set it so the parent can aggregate which steps have been completed.\n- **`typography`**: Overrides the label's typography token (defaults to `h6`); lower it for denser bars.\n",
29424
29582
  "2. Examples": "Correct and idiomatic ways to use the `<mds-stepper-bar-item>` component, ordered from most common to most specialized. The examples assume a working knowledge of the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Minimal Step Inside a Stepper Bar\n\nPlace `<mds-stepper-bar-item>` elements as direct children of [`<mds-stepper-bar>`](../mds-stepper-bar/AGENTS.md). Each item requires `label` and `icon`. `items-done` on the parent drives the `done` and `current` state of each child automatically.\n\n```html\n<mds-stepper-bar items-done=\"1\">\n <mds-stepper-bar-item\n icon=\"mi/baseline/person\"\n label=\"Dati personali\"\n ></mds-stepper-bar-item>\n <mds-stepper-bar-item\n icon=\"mi/baseline/location-on\"\n label=\"Indirizzo\"\n ></mds-stepper-bar-item>\n <mds-stepper-bar-item\n icon=\"mi/baseline/payment\"\n label=\"Pagamento\"\n ></mds-stepper-bar-item>\n</mds-stepper-bar>\n```\n\n#### Distinct Icon for the Completed State\n\nSet `icon-checked` to a different slug when the done state should show a different glyph - for example a checkmark. When omitted, `icon-checked` defaults to `icon`.\n\n```html\n<mds-stepper-bar items-done=\"2\">\n <mds-stepper-bar-item\n icon=\"mi/baseline/person\"\n icon-checked=\"mi/baseline/done\"\n label=\"Dati personali\"\n ></mds-stepper-bar-item>\n <mds-stepper-bar-item\n icon=\"mi/baseline/location-on\"\n icon-checked=\"mi/baseline/done\"\n label=\"Indirizzo\"\n ></mds-stepper-bar-item>\n <mds-stepper-bar-item\n icon=\"mi/baseline/payment\"\n icon-checked=\"mi/baseline/done\"\n label=\"Pagamento\"\n ></mds-stepper-bar-item>\n</mds-stepper-bar>\n```\n\n#### Showing the Ordinal Caption with `step`\n\nSet the boolean `step` attribute to surface an auto-numbered \"Step N\" caption above the label. Use this for explicitly ordered flows where the ordinal number aids orientation.\n\n```html\n<mds-stepper-bar items-done=\"1\">\n <mds-stepper-bar-item\n step\n icon=\"mi/baseline/person\"\n icon-checked=\"mi/baseline/done\"\n label=\"Dati personali\"\n ></mds-stepper-bar-item>\n <mds-stepper-bar-item\n step\n icon=\"mi/baseline/location-on\"\n icon-checked=\"mi/baseline/done\"\n label=\"Indirizzo\"\n ></mds-stepper-bar-item>\n <mds-stepper-bar-item\n step\n icon=\"mi/baseline/payment\"\n icon-checked=\"mi/baseline/done\"\n label=\"Pagamento\"\n ></mds-stepper-bar-item>\n</mds-stepper-bar>\n```\n\n#### Status Badge via `badge`\n\nSet `badge` to show the localized status pill (Completato / In corso / In coda). Prefer this when status legibility matters more than horizontal compactness.\n\n```html\n<mds-stepper-bar items-done=\"2\">\n <mds-stepper-bar-item\n badge\n icon=\"mi/baseline/person\"\n icon-checked=\"mi/baseline/done\"\n label=\"Dati personali\"\n ></mds-stepper-bar-item>\n <mds-stepper-bar-item\n badge\n icon=\"mi/baseline/location-on\"\n icon-checked=\"mi/baseline/done\"\n label=\"Indirizzo\"\n ></mds-stepper-bar-item>\n <mds-stepper-bar-item\n badge\n icon=\"mi/baseline/payment\"\n label=\"Pagamento\"\n ></mds-stepper-bar-item>\n</mds-stepper-bar>\n```\n\n#### Carrying a Value for Event Handling\n\nSet `value` on each item: the parent collects the values of the completed items, comma-joined, into the `value` of its `mdsStepperBarChange` detail. Listen to that event on the parent or a common ancestor.\n\n```html\n<mds-stepper-bar id=\"stepper\" items-done=\"1\">\n <mds-stepper-bar-item\n value=\"dati-personali\"\n icon=\"mi/baseline/person\"\n icon-checked=\"mi/baseline/done\"\n label=\"Dati personali\"\n ></mds-stepper-bar-item>\n <mds-stepper-bar-item\n value=\"indirizzo\"\n icon=\"mi/baseline/location-on\"\n icon-checked=\"mi/baseline/done\"\n label=\"Indirizzo\"\n ></mds-stepper-bar-item>\n <mds-stepper-bar-item\n value=\"pagamento\"\n icon=\"mi/baseline/payment\"\n icon-checked=\"mi/baseline/done\"\n label=\"Pagamento\"\n ></mds-stepper-bar-item>\n</mds-stepper-bar>\n\n<script>\n document.getElementById('stepper').addEventListener('mdsStepperBarChange', (e) => {\n console.log('step completati:', e.detail.value, 'step corrente:', e.detail.step);\n });\n</script>\n```\n\n#### Pairing Step Content via the `content` Slot\n\nPlace panel elements with `slot=\"content\"` inside `<mds-stepper-bar>` - one per item in order. The parent shows only the panel matching the current step (it puts the `hidden` attribute on the others, so no style of the page is needed; a `display` the page sets on a panel overrides it).\n\n```html\n<mds-stepper-bar items-done=\"1\">\n <mds-stepper-bar-item icon=\"mi/baseline/person\" icon-checked=\"mi/baseline/done\" label=\"Dati personali\"></mds-stepper-bar-item>\n <mds-stepper-bar-item icon=\"mi/baseline/location-on\" icon-checked=\"mi/baseline/done\" label=\"Indirizzo\"></mds-stepper-bar-item>\n <mds-stepper-bar-item icon=\"mi/baseline/payment\" label=\"Pagamento\"></mds-stepper-bar-item>\n\n <div slot=\"content\">\n <p>Inserisci il tuo nome e cognome.</p>\n </div>\n <div slot=\"content\">\n <p>Inserisci il tuo indirizzo di spedizione.</p>\n </div>\n <div slot=\"content\">\n <p>Scegli il metodo di pagamento.</p>\n </div>\n</mds-stepper-bar>\n```\n\n#### Reducing Label Typography for Dense Bars\n\nLower the `typography` prop (default `h6`) when horizontal space is tight or when the label must blend with smaller surrounding text.\n\n```html\n<mds-stepper-bar items-done=\"1\">\n <mds-stepper-bar-item\n typography=\"label\"\n icon=\"mi/baseline/person\"\n icon-checked=\"mi/baseline/done\"\n label=\"Dati personali\"\n ></mds-stepper-bar-item>\n <mds-stepper-bar-item\n typography=\"label\"\n icon=\"mi/baseline/location-on\"\n icon-checked=\"mi/baseline/done\"\n label=\"Indirizzo\"\n ></mds-stepper-bar-item>\n <mds-stepper-bar-item\n typography=\"label\"\n icon=\"mi/baseline/payment\"\n label=\"Pagamento\"\n ></mds-stepper-bar-item>\n</mds-stepper-bar>\n```\n\n#### Styling Customization\n\nStyle items only through the public `--mds-stepper-bar-item-*` CSS custom properties: the text colour and the minimum width. The minimum width applies to every item but the last: the last one draws no bar after its icon, so it takes the width of its texts and the bars of the others fill the rest of the row. The icon and progress colours follow the state the parent sets (queued, current, done) and are not set by the page. Use semantic color roles via `rgb(var(--magma-<role>))` so dark mode and high-contrast modes keep working. Target the `::part(badge)` surface only when a deep visual override of the badge wrapper is required.\n\n```css\n.checkout-flow mds-stepper-bar-item {\n --mds-stepper-bar-item-color: rgb(var(--magma-text-muted));\n --mds-stepper-bar-item-min-width: 160px;\n}\n```\n",
29425
29583
  "3. Mistakes": "Common incorrect uses of `<mds-stepper-bar-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/mistakes.md`](../../../../agents/mistakes.md) - they apply here too but are not repeated.\n\n#### Do Not Use Outside `<mds-stepper-bar>`\n\n`<mds-stepper-bar-item>` is a compound child - its state (`done`, `current`, index) is resolved by the parent. Using it standalone leaves `isDone`, `isCurrent` and `index` at their defaults and produces broken visual output.\n\n```html\n<!-- INCORRECT -->\n<mds-stepper-bar-item icon=\"mi/baseline/person\" label=\"Dati personali\"></mds-stepper-bar-item>\n\n<!-- CORRECT -->\n<mds-stepper-bar items-done=\"1\">\n <mds-stepper-bar-item icon=\"mi/baseline/person\" icon-checked=\"mi/baseline/done\" label=\"Dati personali\"></mds-stepper-bar-item>\n <mds-stepper-bar-item icon=\"mi/baseline/location-on\" icon-checked=\"mi/baseline/done\" label=\"Indirizzo\"></mds-stepper-bar-item>\n</mds-stepper-bar>\n```\n\n#### Do Not Set `done=\"false\"` or `current=\"false\"` as Strings\n\n`done` and `current` are boolean props. Stencil reads `\"false\"` as `false` and, since both are reflected, removes the attribute at the first render, so this happens to work; but the markup says the opposite of what it does, and on a prop that is not reflected the attribute stays in the DOM, where `[attr]` selectors still match it. To turn them off, remove the attribute or let the parent manage state via `items-done`.\n\n```html\n<!-- INCORRECT -->\n<mds-stepper-bar-item done=\"false\" current=\"false\" icon=\"mi/baseline/payment\" label=\"Pagamento\"></mds-stepper-bar-item>\n\n<!-- CORRECT -->\n<mds-stepper-bar-item icon=\"mi/baseline/payment\" label=\"Pagamento\"></mds-stepper-bar-item>\n```\n\n#### Do Not Override State Manually When the Parent Manages It\n\n`done` and `current` are driven by `<mds-stepper-bar>`'s `items-done` prop. Setting them on individual items and also setting `items-done` creates conflicting state that the parent overwrites when it loads and whenever `items-done` changes.\n\n```html\n<!-- INCORRECT -->\n<mds-stepper-bar items-done=\"2\">\n <mds-stepper-bar-item done current icon=\"mi/baseline/person\" label=\"Dati personali\"></mds-stepper-bar-item>\n <mds-stepper-bar-item icon=\"mi/baseline/location-on\" label=\"Indirizzo\"></mds-stepper-bar-item>\n</mds-stepper-bar>\n\n<!-- CORRECT -->\n<mds-stepper-bar items-done=\"2\">\n <mds-stepper-bar-item icon=\"mi/baseline/person\" icon-checked=\"mi/baseline/done\" label=\"Dati personali\"></mds-stepper-bar-item>\n <mds-stepper-bar-item icon=\"mi/baseline/location-on\" icon-checked=\"mi/baseline/done\" label=\"Indirizzo\"></mds-stepper-bar-item>\n</mds-stepper-bar>\n```\n\n#### Do Not Wrap Items in Extra HTML Elements\n\nEach item numbers itself among its own siblings, and the parent's track lays out its direct children: a wrapper `<div>` or `<li>` turns every wrapped item into \"Step 1\" and breaks the track layout and scroll alignment.\n\n```html\n<!-- INCORRECT -->\n<mds-stepper-bar items-done=\"1\">\n <div>\n <mds-stepper-bar-item icon=\"mi/baseline/person\" label=\"Dati personali\"></mds-stepper-bar-item>\n </div>\n <div>\n <mds-stepper-bar-item icon=\"mi/baseline/location-on\" label=\"Indirizzo\"></mds-stepper-bar-item>\n </div>\n</mds-stepper-bar>\n\n<!-- CORRECT -->\n<mds-stepper-bar items-done=\"1\">\n <mds-stepper-bar-item icon=\"mi/baseline/person\" icon-checked=\"mi/baseline/done\" label=\"Dati personali\"></mds-stepper-bar-item>\n <mds-stepper-bar-item icon=\"mi/baseline/location-on\" icon-checked=\"mi/baseline/done\" label=\"Indirizzo\"></mds-stepper-bar-item>\n</mds-stepper-bar>\n```\n\n#### Do Not Use Undocumented `::part()` Targets to Style the Icon or Progress\n\nThe only documented shadow part is `badge`. Targeting internals such as `::part(icon)` or `::part(progress)` couples code to the private Shadow DOM structure and will break on minor releases. The icon and the progress line take their colours from the step state; style the item through its public `--mds-stepper-bar-item-*` CSS custom properties instead.\n\n```css\n/* INCORRECT */\nmds-stepper-bar-item::part(icon) {\n background-color: purple;\n}\nmds-stepper-bar-item::part(progress) {\n height: 6px;\n}\n\n/* CORRECT */\nmds-stepper-bar-item {\n --mds-stepper-bar-item-color: rgb(var(--magma-text-default));\n --mds-stepper-bar-item-min-width: 160px;\n}\n```\n\n#### Do Not Omit `label` or `icon`\n\nBoth are required props. An item without `label` has no accessible or visual description; an item without `icon` leaves the icon area empty and breaks the progress-line layout.\n\n```html\n<!-- INCORRECT -->\n<mds-stepper-bar items-done=\"1\">\n <mds-stepper-bar-item label=\"Dati personali\"></mds-stepper-bar-item>\n <mds-stepper-bar-item icon=\"mi/baseline/location-on\"></mds-stepper-bar-item>\n</mds-stepper-bar>\n\n<!-- CORRECT -->\n<mds-stepper-bar items-done=\"1\">\n <mds-stepper-bar-item icon=\"mi/baseline/person\" label=\"Dati personali\"></mds-stepper-bar-item>\n <mds-stepper-bar-item icon=\"mi/baseline/location-on\" label=\"Indirizzo\"></mds-stepper-bar-item>\n</mds-stepper-bar>\n```\n"
29426
29584
  },
@@ -29595,7 +29753,7 @@
29595
29753
  "mutable": false,
29596
29754
  "attr": "step",
29597
29755
  "reflectToAttr": false,
29598
- "docs": "Specifies if the step is displayed",
29756
+ "docs": "Shows the caption of the step above the label: \"Step 1\", \"Passo 1\", in the language of the\npage, or the text of `stepLabel`",
29599
29757
  "docsTags": [],
29600
29758
  "values": [
29601
29759
  {
@@ -29607,6 +29765,32 @@
29607
29765
  "getter": false,
29608
29766
  "setter": false
29609
29767
  },
29768
+ {
29769
+ "name": "stepLabel",
29770
+ "type": "string | undefined",
29771
+ "complexType": {
29772
+ "original": "string",
29773
+ "resolved": "string | undefined",
29774
+ "references": {}
29775
+ },
29776
+ "mutable": false,
29777
+ "attr": "step-label",
29778
+ "reflectToAttr": false,
29779
+ "docs": "The text of the caption that `step` shows, in place of the one the component writes in the\nlanguage of the page (\"Passo 2\"). `{{ index }}` in it becomes the position of the step, as in\nthe phrases of the component: `\"Fase {{ index }}\"` gives \"Fase 1\", \"Fase 2\"; a text without\nit is shown as it is. For another word, or a language the component has no texts for",
29780
+ "docsTags": [],
29781
+ "values": [
29782
+ {
29783
+ "type": "string"
29784
+ },
29785
+ {
29786
+ "type": "undefined"
29787
+ }
29788
+ ],
29789
+ "optional": true,
29790
+ "required": false,
29791
+ "getter": false,
29792
+ "setter": false
29793
+ },
29610
29794
  {
29611
29795
  "name": "typography",
29612
29796
  "type": "\"action\" | \"caption\" | \"detail\" | \"h1\" | \"h2\" | \"h3\" | \"h4\" | \"h5\" | \"h6\" | \"hack\" | \"label\" | \"option\" | \"paragraph\" | \"snippet\" | \"tip\" | undefined",
@@ -33940,8 +34124,8 @@
33940
34124
  }
33941
34125
  ],
33942
34126
  "usage": {
33943
- "1. Description": "The `<mds-tooltip>` web component is the floating contextual hint of the Magma Design System. It renders a small text bubble that attaches to a separate trigger element identified by a CSS selector, rather than relying on the native `title` attribute.\n\n#### Semantic Behavior\n\n- **Detached trigger model**: The tooltip is not wrapped around its trigger; the required `target` selector is resolved and the component binds itself to the first matching caller.\n- **Hover and focus visibility**: The bubble shows while the pointer is over the trigger or the trigger has the focus, and hides when neither holds; Escape hides it until the trigger is hovered or focused again. The tooltip takes `role=\"tooltip\"` and, when it shares a DOM tree with the trigger, writes `aria-describedby` on it, or `aria-labelledby` with `relation=\"label\"`; an attribute the trigger already has is left alone.\n- **Visibility is the source of truth**: Setting `visible` programmatically shows or dismisses the bubble, allowing the tooltip to be controlled without a hover.\n- **Live repositioning**: Changing any layout prop (`placement`, `offset`, `disableShift`, `shiftPadding`, `strategy`, `flip`, `disableAutoPlacement`) recomputes the floating position on the fly.\n- **Text-only default slot**: The default slot is meant for a plain text string (exposed as the `text` shadow part); HTML elements or components should not be slotted in.\n\n#### Properties & Visual Configurations\n\n- **`target`** (required) is the CSS selector of the trigger element the tooltip listens to and anchors against; the first match wins.\n- **`placement`** chooses the preferred side and alignment relative to the caller (e.g. `'top'`, `'bottom-start'`), taken whenever it has room; by default the tooltip moves to the opposite side, then to the sides across, only when it does not fit there (**`disableAutoPlacement`** opts out and pins to `placement`, and **`flip`** then allows the fallback to the opposite side only).\n- the bubble is kept inside the viewport by default (**`disableShift`** opts out), with **`shiftPadding`** reserving a safe gap from the viewport edges; **`offset`** sets the distance between the bubble and the caller.\n- **`strategy`** selects the CSS positioning strategy: `'fixed'` (default) escapes clipping ancestors, `'absolute'` anchors within the nearest positioned ancestor.\n- **`relation`** says what the tooltip is to its trigger: its `'description'` (default, `aria-describedby`), or its `'label'` (`aria-labelledby`), when the tooltip text is the only visible name of the trigger, as on an icon-only button. Changing it moves the attribute on the trigger.\n- **`typography`** picks the text scale of the bubble (`'tip'`, `'caption'`, `'detail'`), where `'tip'` is the default compact hint sizing.\n",
33944
- "2. Examples": "Correct and idiomatic ways to use the `<mds-tooltip>` component, ordered from most common to most specialized. The examples assume a working knowledge of the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Basic Tooltip on a Button\n\nThe most common form. Give the trigger element an `id` (or any unique CSS selector) and point `target` at it. The tooltip listens for hover events on the trigger and positions itself automatically.\n\n```html\n<mds-button id=\"salva-btn\" label=\"Salva documento\" variant=\"primary\" tone=\"strong\"></mds-button>\n<mds-tooltip target=\"#salva-btn\">Salva le modifiche correnti</mds-tooltip>\n```\n\n#### Naming an Icon-Only Button\n\nOn an icon-only button the tooltip usually shows the name of the button. Set `relation=\"label\"` so that the tooltip is the name (`aria-labelledby`) and not a description: the button needs no `aria-label`, and a screen reader does not read the same text twice. Use it only on an interactive trigger, a button or a link: ARIA does not allow a name on a generic element.\n\n```html\n<mds-button id=\"tokens-btn\" icon=\"mi/baseline/palette\" variant=\"dark\" tone=\"text\"></mds-button>\n<mds-tooltip target=\"#tokens-btn\" relation=\"label\">Tokens</mds-tooltip>\n```\n\n#### Tooltip on a Non-Interactive Element\n\n`target` accepts any CSS selector, not just `#id`. Use a class or attribute selector when the trigger is a static element such as a status icon.\n\n```html\n<mds-icon class=\"stato-icona\" name=\"mi/baseline/info\"></mds-icon>\n<mds-tooltip target=\".stato-icona\">Ultima sincronizzazione: oggi alle 08:30</mds-tooltip>\n```\n\n#### Placement and Preferred Side\n\nOverride the default `top` placement with `placement` when layout requires a different side. Auto placement is on by default: the tooltip takes `placement` whenever it has room and moves to another side only when it does not fit; `disable-auto-placement` locks the side.\n\n```html\n<mds-button id=\"dettagli-btn\" label=\"Dettagli\" variant=\"primary\" tone=\"outline\"></mds-button>\n<mds-tooltip target=\"#dettagli-btn\" placement=\"right\" disable-auto-placement>\n Apre il pannello laterale con i dettagli completi\n</mds-tooltip>\n```\n\nAccepted values: `top`, `top-start`, `top-end`, `bottom`, `bottom-start`, `bottom-end`, `left`, `left-start`, `left-end`, `right`, `right-start`, `right-end`.\n\n#### Flip Fallback When Space is Tight\n\nEnable `flip` together with `disable-auto-placement` so the pinned tooltip moves to the opposite side, and to no other, if the preferred placement collides with the viewport edge. Auto placement already includes that fallback.\n\n```html\n<mds-button id=\"azione-btn\" label=\"Azione\" variant=\"primary\"></mds-button>\n<mds-tooltip target=\"#azione-btn\" placement=\"top\" disable-auto-placement flip>\n Esegui l'operazione selezionata\n</mds-tooltip>\n```\n\n#### Viewport-Safe Shift\n\nBy default the tooltip slides along its axis so it stays inside the viewport (set `disable-shift` to opt out). Increase `shift-padding` to keep a wider safe margin from the viewport edges.\n\n```html\n<mds-button id=\"bordo-btn\" label=\"Vicino al bordo\" variant=\"dark\" tone=\"outline\"></mds-button>\n<mds-tooltip target=\"#bordo-btn\" shift-padding=\"24\">\n Questa azione e' irreversibile\n</mds-tooltip>\n```\n\n#### Custom Offset Distance\n\nIncrease `offset` when additional breathing room between the trigger and the bubble is required - for example inside dense toolbars or on elements with large focus rings.\n\n```html\n<mds-button id=\"info-btn\" label=\"Info\" variant=\"info\" tone=\"weak\"></mds-button>\n<mds-tooltip target=\"#info-btn\" offset=\"20\">\n Informazioni aggiuntive sul campo\n</mds-tooltip>\n```\n\n#### Programmatic Visibility\n\nSet the `visible` attribute (or property) to control the tooltip without hover. Useful for guided tours, onboarding hints, or error annotations that appear on demand.\n\n```html\n<mds-button id=\"primo-accesso\" label=\"Inizia\" variant=\"primary\"></mds-button>\n<mds-tooltip id=\"hint\" target=\"#primo-accesso\" visible>\n Benvenuto! Clicca qui per iniziare la configurazione.\n</mds-tooltip>\n\n<script>\n const hint = document.querySelector('#hint');\n // Dismiss programmatically when the user acknowledges the hint\n document.querySelector('#primo-accesso').addEventListener('click', () => {\n hint.visible = false;\n });\n</script>\n```\n\n#### Typography Scale\n\n`typography` adjusts the text scale inside the bubble. Use `'tip'` (default) for compact hints, `'caption'` for slightly larger labels, and `'detail'` for the largest, body-size text.\n\n```html\n<!-- Default compact hint -->\n<mds-tooltip target=\"#campo-nome\" typography=\"tip\">Massimo 64 caratteri</mds-tooltip>\n\n<!-- Slightly larger label -->\n<mds-tooltip target=\"#campo-data\" typography=\"caption\">Formato: GG/MM/AAAA</mds-tooltip>\n```\n\n#### Positioning Strategy\n\nUse `strategy=\"absolute\"` when the tooltip must be contained within a scrolling ancestor instead of the viewport. The default `strategy=\"fixed\"` escapes any clipping or overflow-hidden parent.\n\n```html\n<!-- Inside a scrollable panel with overflow:hidden ancestors -->\n<mds-tooltip target=\"#voce-lista\" strategy=\"absolute\">Trascina per riordinare</mds-tooltip>\n```\n\n#### Styling Customization\n\nStyle the tooltip only through its public `--mds-tooltip-*` CSS custom properties: the background (the arrow follows it), the delay and the z-index. Set them on the host element or a parent selector; use the semantic color roles via `rgb(var(--magma-<role>))` so dark mode and high-contrast modes keep working.\n\n```css\n.onboarding-hint mds-tooltip {\n --mds-tooltip-background: rgb(var(--magma-accent-surface));\n --mds-tooltip-delay: 0.25s;\n --mds-tooltip-z-index: 5000;\n}\n```\n",
34127
+ "1. Description": "The `<mds-tooltip>` web component is the floating contextual hint of the Magma Design System. It renders a small text bubble that attaches to a separate trigger element identified by a CSS selector, rather than relying on the native `title` attribute.\n\n#### Semantic Behavior\n\n- **Detached trigger model**: The tooltip is not wrapped around its trigger; the required `target` selector is resolved and the component binds itself to the first matching caller.\n- **Hover and focus visibility**: The bubble shows while the pointer is over the trigger or the trigger has a focus the browser rings (`:focus-visible`, the focus of the keyboard), and hides when neither holds; Escape hides it until the trigger is hovered or focused again. The focus of a click, or one a script moves to the trigger after a click, does not keep it open: it closes when the pointer leaves. The tooltip takes `role=\"tooltip\"` and, when it shares a DOM tree with the trigger, writes `aria-describedby` on it, or `aria-labelledby` with `relation=\"label\"`; an attribute the trigger already has is left alone.\n- **Visibility is the source of truth**: Setting `visible` programmatically shows or dismisses the bubble, allowing the tooltip to be controlled without a hover.\n- **Live repositioning**: Changing any layout prop (`placement`, `offset`, `disableShift`, `shiftPadding`, `strategy`, `flip`, `disableAutoPlacement`) recomputes the floating position on the fly.\n- **Text-only default slot**: The default slot is meant for a plain text string (exposed as the `text` shadow part); HTML elements or components should not be slotted in.\n\n#### Properties & Visual Configurations\n\n- **`target`** (required) is the CSS selector of the trigger element the tooltip listens to and anchors against; the first match wins.\n- **`placement`** chooses the preferred side and alignment relative to the caller (e.g. `'top'`, `'bottom-start'`), taken whenever it has room; by default the tooltip moves to the opposite side, then to the sides across, only when it does not fit there (**`disableAutoPlacement`** opts out and pins to `placement`, and **`flip`** then allows the fallback to the opposite side only).\n- the bubble is kept inside the viewport by default (**`disableShift`** opts out), with **`shiftPadding`** reserving a safe gap from the viewport edges; **`offset`** sets the distance between the bubble and the caller.\n- **`strategy`** selects the CSS positioning strategy: `'fixed'` (default) escapes clipping ancestors, `'absolute'` anchors within the nearest positioned ancestor.\n- **`relation`** says what the tooltip is to its trigger: its `'description'` (default, `aria-describedby`), or its `'label'` (`aria-labelledby`), when the tooltip text is the only visible name of the trigger, as on an icon-only button. Changing it moves the attribute on the trigger.\n- **`typography`** picks the text scale of the bubble (`'tip'`, `'caption'`, `'detail'`), where `'tip'` is the default compact hint sizing.\n",
34128
+ "2. Examples": "Correct and idiomatic ways to use the `<mds-tooltip>` component, ordered from most common to most specialized. The examples assume a working knowledge of the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Basic Tooltip on a Button\n\nThe most common form. Give the trigger element an `id` (or any unique CSS selector) and point `target` at it. The tooltip listens for the hover and the keyboard focus of the trigger and positions itself automatically.\n\n```html\n<mds-button id=\"salva-btn\" label=\"Salva documento\" variant=\"primary\" tone=\"strong\"></mds-button>\n<mds-tooltip target=\"#salva-btn\">Salva le modifiche correnti</mds-tooltip>\n```\n\n#### Naming an Icon-Only Button\n\nOn an icon-only button the tooltip usually shows the name of the button. Set `relation=\"label\"` so that the tooltip is the name (`aria-labelledby`) and not a description: the button needs no `aria-label`, and a screen reader does not read the same text twice. Use it only on an interactive trigger, a button or a link: ARIA does not allow a name on a generic element.\n\n```html\n<mds-button id=\"tokens-btn\" icon=\"mi/baseline/palette\" variant=\"dark\" tone=\"text\"></mds-button>\n<mds-tooltip target=\"#tokens-btn\" relation=\"label\">Tokens</mds-tooltip>\n```\n\n#### Tooltip on a Non-Interactive Element\n\n`target` accepts any CSS selector, not just `#id`. Use a class or attribute selector when the trigger is a static element such as a status icon.\n\n```html\n<mds-icon class=\"stato-icona\" name=\"mi/baseline/info\"></mds-icon>\n<mds-tooltip target=\".stato-icona\">Ultima sincronizzazione: oggi alle 08:30</mds-tooltip>\n```\n\n#### Placement and Preferred Side\n\nOverride the default `top` placement with `placement` when layout requires a different side. Auto placement is on by default: the tooltip takes `placement` whenever it has room and moves to another side only when it does not fit; `disable-auto-placement` locks the side.\n\n```html\n<mds-button id=\"dettagli-btn\" label=\"Dettagli\" variant=\"primary\" tone=\"outline\"></mds-button>\n<mds-tooltip target=\"#dettagli-btn\" placement=\"right\" disable-auto-placement>\n Apre il pannello laterale con i dettagli completi\n</mds-tooltip>\n```\n\nAccepted values: `top`, `top-start`, `top-end`, `bottom`, `bottom-start`, `bottom-end`, `left`, `left-start`, `left-end`, `right`, `right-start`, `right-end`.\n\n#### Flip Fallback When Space is Tight\n\nEnable `flip` together with `disable-auto-placement` so the pinned tooltip moves to the opposite side, and to no other, if the preferred placement collides with the viewport edge. Auto placement already includes that fallback.\n\n```html\n<mds-button id=\"azione-btn\" label=\"Azione\" variant=\"primary\"></mds-button>\n<mds-tooltip target=\"#azione-btn\" placement=\"top\" disable-auto-placement flip>\n Esegui l'operazione selezionata\n</mds-tooltip>\n```\n\n#### Viewport-Safe Shift\n\nBy default the tooltip slides along its axis so it stays inside the viewport (set `disable-shift` to opt out). Increase `shift-padding` to keep a wider safe margin from the viewport edges.\n\n```html\n<mds-button id=\"bordo-btn\" label=\"Vicino al bordo\" variant=\"dark\" tone=\"outline\"></mds-button>\n<mds-tooltip target=\"#bordo-btn\" shift-padding=\"24\">\n Questa azione e' irreversibile\n</mds-tooltip>\n```\n\n#### Custom Offset Distance\n\nIncrease `offset` when additional breathing room between the trigger and the bubble is required - for example inside dense toolbars or on elements with large focus rings.\n\n```html\n<mds-button id=\"info-btn\" label=\"Info\" variant=\"info\" tone=\"weak\"></mds-button>\n<mds-tooltip target=\"#info-btn\" offset=\"20\">\n Informazioni aggiuntive sul campo\n</mds-tooltip>\n```\n\n#### Programmatic Visibility\n\nSet the `visible` attribute (or property) to control the tooltip without hover. Useful for guided tours, onboarding hints, or error annotations that appear on demand.\n\n```html\n<mds-button id=\"primo-accesso\" label=\"Inizia\" variant=\"primary\"></mds-button>\n<mds-tooltip id=\"hint\" target=\"#primo-accesso\" visible>\n Benvenuto! Clicca qui per iniziare la configurazione.\n</mds-tooltip>\n\n<script>\n const hint = document.querySelector('#hint');\n // Dismiss programmatically when the user acknowledges the hint\n document.querySelector('#primo-accesso').addEventListener('click', () => {\n hint.visible = false;\n });\n</script>\n```\n\n#### Typography Scale\n\n`typography` adjusts the text scale inside the bubble. Use `'tip'` (default) for compact hints, `'caption'` for slightly larger labels, and `'detail'` for the largest, body-size text.\n\n```html\n<!-- Default compact hint -->\n<mds-tooltip target=\"#campo-nome\" typography=\"tip\">Massimo 64 caratteri</mds-tooltip>\n\n<!-- Slightly larger label -->\n<mds-tooltip target=\"#campo-data\" typography=\"caption\">Formato: GG/MM/AAAA</mds-tooltip>\n```\n\n#### Positioning Strategy\n\nUse `strategy=\"absolute\"` when the tooltip must be contained within a scrolling ancestor instead of the viewport. The default `strategy=\"fixed\"` escapes any clipping or overflow-hidden parent.\n\n```html\n<!-- Inside a scrollable panel with overflow:hidden ancestors -->\n<mds-tooltip target=\"#voce-lista\" strategy=\"absolute\">Trascina per riordinare</mds-tooltip>\n```\n\n#### Styling Customization\n\nStyle the tooltip only through its public `--mds-tooltip-*` CSS custom properties: the background (the arrow follows it), the delay and the z-index. Set them on the host element or a parent selector; use the semantic color roles via `rgb(var(--magma-<role>))` so dark mode and high-contrast modes keep working.\n\n```css\n.onboarding-hint mds-tooltip {\n --mds-tooltip-background: rgb(var(--magma-accent-surface));\n --mds-tooltip-delay: 0.25s;\n --mds-tooltip-z-index: 5000;\n}\n```\n",
33945
34129
  "3. Mistakes": "Common incorrect uses of `<mds-tooltip>`. 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/mistakes.md`](../../../../agents/mistakes.md) - they apply here too but are not repeated.\n\n#### Do Not Use a Bare ID String as `target`\n\nThe value of `target` is passed directly to `querySelector`, so a CSS selector is required: a bare id (`hint-trigger`) looks for an element named `<hint-trigger>`, finds nothing, and the tooltip never attaches.\n\n```html\n<!-- INCORRECT -->\n<span id=\"hint-trigger\">Aiuto</span>\n<mds-tooltip target=\"hint-trigger\">Testo di aiuto</mds-tooltip>\n\n<!-- CORRECT -->\n<span id=\"hint-trigger\">Aiuto</span>\n<mds-tooltip target=\"#hint-trigger\">Testo di aiuto</mds-tooltip>\n```\n\n#### Do Not Slot HTML Elements or Components\n\nThe default slot is text-only. Nesting HTML elements or Magma components breaks the inner layout and may produce unexpected rendering because the slot is wrapped in `<mds-text>`.\n\n```html\n<!-- INCORRECT -->\n<mds-tooltip target=\"#voce\">\n <mds-icon name=\"mi/baseline/warning\"></mds-icon>\n <strong>Attenzione:</strong> campo obbligatorio\n</mds-tooltip>\n\n<!-- CORRECT -->\n<mds-tooltip target=\"#voce\">Attenzione: campo obbligatorio</mds-tooltip>\n```\n\n#### Do Not Wrap the Trigger Inside the Tooltip\n\n`<mds-tooltip>` uses a detached trigger model - the tooltip is placed as a sibling in the DOM and linked via `target`, not wrapped around its trigger. Nesting the trigger breaks the floating position logic.\n\n```html\n<!-- INCORRECT -->\n<mds-tooltip target=\"#btn\">\n <mds-button id=\"btn\" label=\"Elimina\"></mds-button>\n Elimina il record selezionato\n</mds-tooltip>\n\n<!-- CORRECT -->\n<mds-button id=\"btn\" label=\"Elimina\" variant=\"error\" tone=\"text\"></mds-button>\n<mds-tooltip target=\"#btn\">Elimina il record selezionato</mds-tooltip>\n```\n\n#### Do Not Set `visible=\"false\"` to Hide the Tooltip\n\n`visible` is a boolean attribute; setting it to the string `\"false\"` leaves the attribute on the element. The tooltip itself reads it as hidden, but every presence check (`[visible]`, `hasAttribute('visible')`) still reads it as visible. Remove the attribute (or set the property to `false`) to hide it.\n\n```html\n<!-- INCORRECT -->\n<mds-tooltip target=\"#campo\" visible=\"false\">Testo nascosto</mds-tooltip>\n\n<!-- CORRECT -->\n<mds-tooltip target=\"#campo\">Testo nascosto</mds-tooltip>\n```\n\n```js\n// CORRECT (programmatic)\ndocument.querySelector('mds-tooltip').visible = false;\n```\n\n#### Do Not Pierce the Shadow DOM to Style Internal Parts\n\nThe only supported customization surface is the set of public `--mds-tooltip-*` CSS custom properties and the documented `text` shadow part. Targeting undocumented internal selectors couples your code to the implementation and will break on minor releases.\n\n```css\n/* INCORRECT */\nmds-tooltip >>> .text {\n font-style: italic;\n}\nmds-tooltip::part(arrow) {\n fill: red;\n}\n\n/* CORRECT */\nmds-tooltip {\n --mds-tooltip-background: rgb(var(--magma-accent-surface));\n --mds-tooltip-delay: 0.5s;\n}\nmds-tooltip::part(text) {\n font-style: italic;\n}\n```\n\n#### Do Not Repeat the Name of the Trigger as Its Description\n\nA tooltip describes its trigger by default. When its text is the name of the trigger, as on an icon-only button, an `aria-label` with the same text makes a screen reader read it twice, as the name and as the description. Make the tooltip the name instead.\n\n```html\n<!-- INCORRECT -->\n<mds-button id=\"tokens-btn\" icon=\"mi/baseline/palette\" aria-label=\"Tokens\"></mds-button>\n<mds-tooltip target=\"#tokens-btn\">Tokens</mds-tooltip>\n\n<!-- CORRECT -->\n<mds-button id=\"tokens-btn\" icon=\"mi/baseline/palette\"></mds-button>\n<mds-tooltip target=\"#tokens-btn\" relation=\"label\">Tokens</mds-tooltip>\n```\n\n#### Do Not Replace `<mds-tooltip>` with a Native `title` Attribute\n\nThe native `title` tooltip is not styleable and not announced consistently by screen readers on touch devices. Use `<mds-tooltip>` for all contextual hints.\n\n```html\n<!-- INCORRECT -->\n<mds-button label=\"Elimina\" title=\"Elimina il record selezionato\"></mds-button>\n\n<!-- CORRECT -->\n<mds-button id=\"elimina-btn\" label=\"Elimina\" variant=\"error\" tone=\"text\"></mds-button>\n<mds-tooltip target=\"#elimina-btn\">Elimina il record selezionato</mds-tooltip>\n```\n"
33946
34130
  },
33947
34131
  "props": [
@@ -36763,6 +36947,11 @@
36763
36947
  "docstring": "",
36764
36948
  "path": "src/components/mds-img/meta/types.ts"
36765
36949
  },
36950
+ "src/components/mds-img/meta/types.ts::DecodingType": {
36951
+ "declaration": "\"auto\" | \"async\" | \"sync\"",
36952
+ "docstring": "",
36953
+ "path": "src/components/mds-img/meta/types.ts"
36954
+ },
36766
36955
  "src/components/mds-img/meta/types.ts::ReferrerpolicyType": {
36767
36956
  "declaration": "export type ReferrerpolicyType =\n | 'no-referrer'\n | 'no-referrer-when-downgrade'\n | 'origin'\n | 'origin-when-cross-origin'\n | 'unsafe-url';",
36768
36957
  "docstring": "",
@@ -36879,7 +37068,7 @@
36879
37068
  "path": "src/components/mds-keyboard/meta/type.ts"
36880
37069
  },
36881
37070
  "src/type/keyboard.ts::KeyboardKeyName": {
36882
- "declaration": "\"option\" | \"b\" | \"i\" | \"p\" | \"q\" | \"s\" | \"u\" | \"a\" | \"1\" | \"2\" | \"end\" | \"0\" | \"3\" | \"4\" | \"5\" | \"6\" | \"7\" | \"v\" | \"shift\" | \"g\" | \"8\" | \"9\" | \"alt\" | \"altleft\" | \"altright\" | \"arrowdown\" | \"arrowleft\" | \"arrowright\" | \"arrowup\" | \"backspace\" | \"c\" | \"capslock\" | \"command\" | \"commandleft\" | \"commandright\" | \"control\" | \"controlleft\" | \"controlright\" | \"d\" | \"delete\" | \"e\" | \"enter\" | \"escape\" | \"f\" | \"f1\" | \"f10\" | \"f11\" | \"f12\" | \"f2\" | \"f3\" | \"f4\" | \"f5\" | \"f6\" | \"f7\" | \"f8\" | \"f9\" | \"h\" | \"home\" | \"j\" | \"k\" | \"l\" | \"m\" | \"n\" | \"o\" | \"optionleft\" | \"optionright\" | \"pagedown\" | \"pageup\" | \"r\" | \"shiftleft\" | \"shiftright\" | \"space\" | \"t\" | \"tab\" | \"w\" | \"windows\" | \"windowsleft\" | \"windowsright\" | \"x\" | \"y\" | \"z\"",
37071
+ "declaration": "\"option\" | \"b\" | \"i\" | \"p\" | \"q\" | \"s\" | \"u\" | \"a\" | \"1\" | \"2\" | \"end\" | \"0\" | \"3\" | \"4\" | \"5\" | \"6\" | \"7\" | \"escape\" | \"v\" | \"shift\" | \"g\" | \"8\" | \"9\" | \"alt\" | \"altleft\" | \"altright\" | \"arrowdown\" | \"arrowleft\" | \"arrowright\" | \"arrowup\" | \"backspace\" | \"c\" | \"capslock\" | \"command\" | \"commandleft\" | \"commandright\" | \"control\" | \"controlleft\" | \"controlright\" | \"d\" | \"delete\" | \"e\" | \"enter\" | \"f\" | \"f1\" | \"f10\" | \"f11\" | \"f12\" | \"f2\" | \"f3\" | \"f4\" | \"f5\" | \"f6\" | \"f7\" | \"f8\" | \"f9\" | \"h\" | \"home\" | \"j\" | \"k\" | \"l\" | \"m\" | \"n\" | \"o\" | \"optionleft\" | \"optionright\" | \"pagedown\" | \"pageup\" | \"r\" | \"shiftleft\" | \"shiftright\" | \"space\" | \"t\" | \"tab\" | \"w\" | \"windows\" | \"windowsleft\" | \"windowsright\" | \"x\" | \"y\" | \"z\"",
36883
37072
  "docstring": "",
36884
37073
  "path": "src/type/keyboard.ts"
36885
37074
  },