@maggioli-design-system/magma 2.5.0 → 2.6.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 (1515) hide show
  1. package/AGENTS.md +19 -4
  2. package/CHANGELOG.md +61 -0
  3. package/LICENSE +21 -0
  4. package/agents/assets.md +1 -1
  5. package/agents/color.md +22 -4
  6. package/agents/components.md +164 -92
  7. package/agents/conventions.md +24 -7
  8. package/agents/install.md +7 -0
  9. package/agents/lint.md +270 -0
  10. package/agents/mcp.md +103 -0
  11. package/agents/theming.md +8 -0
  12. package/dist/cjs/index-BQNHYWJg.js +4 -0
  13. package/dist/cjs/{index-CWTZb9W2.js → index-Bg68W-da.js} +1 -1
  14. package/dist/cjs/loader.cjs.js +1 -1
  15. package/dist/cjs/{locale-Os4wg65H.js → locale-CaR39iYg.js} +12 -6
  16. package/dist/cjs/magma-components.cjs.js +1 -1
  17. package/dist/cjs/mds-accordion-item.cjs.entry.js +1 -1
  18. package/dist/cjs/mds-accordion-timer-item.cjs.entry.js +1 -1
  19. package/dist/cjs/mds-accordion-timer.cjs.entry.js +1 -1
  20. package/dist/cjs/mds-accordion.cjs.entry.js +1 -1
  21. package/dist/cjs/mds-author.cjs.entry.js +1 -1
  22. package/dist/cjs/mds-avatar-stack-item.cjs.entry.js +1 -1
  23. package/dist/cjs/mds-avatar-stack.cjs.entry.js +1 -1
  24. package/dist/cjs/mds-avatar.cjs.entry.js +1 -1
  25. package/dist/cjs/mds-badge.cjs.entry.js +1 -1
  26. package/dist/cjs/mds-banner_3.cjs.entry.js +4 -4
  27. package/dist/cjs/mds-benchmark-bar.cjs.entry.js +1 -1
  28. package/dist/cjs/mds-bibliography.cjs.entry.js +1 -1
  29. package/dist/cjs/mds-book.cjs.entry.js +703 -0
  30. package/dist/cjs/mds-breadcrumb-item.cjs.entry.js +1 -1
  31. package/dist/cjs/mds-breadcrumb.cjs.entry.js +2 -2
  32. package/dist/cjs/mds-button-dropdown.cjs.entry.js +2 -2
  33. package/dist/cjs/mds-button-group.cjs.entry.js +1 -1
  34. package/dist/cjs/mds-button_3.cjs.entry.js +6 -6
  35. package/dist/cjs/mds-calendar_2.cjs.entry.js +7 -7
  36. package/dist/cjs/mds-card-content.cjs.entry.js +1 -1
  37. package/dist/cjs/mds-card-footer.cjs.entry.js +1 -1
  38. package/dist/cjs/mds-card-header.cjs.entry.js +1 -1
  39. package/dist/cjs/mds-card-media.cjs.entry.js +1 -1
  40. package/dist/cjs/mds-card.cjs.entry.js +1 -1
  41. package/dist/cjs/mds-details.cjs.entry.js +1 -1
  42. package/dist/cjs/mds-dropdown.cjs.entry.js +2 -2
  43. package/dist/cjs/mds-emoji.cjs.entry.js +2 -2
  44. package/dist/cjs/mds-entity.cjs.entry.js +1 -1
  45. package/dist/cjs/mds-file-preview.cjs.entry.js +3 -3
  46. package/dist/cjs/mds-file.cjs.entry.js +2 -2
  47. package/dist/cjs/mds-filter-item.cjs.entry.js +2 -2
  48. package/dist/cjs/mds-filter.cjs.entry.js +2 -2
  49. package/dist/cjs/mds-header-bar.cjs.entry.js +2 -2
  50. package/dist/cjs/mds-header.cjs.entry.js +2 -2
  51. package/dist/cjs/mds-horizontal-scroll.cjs.entry.js +2 -2
  52. package/dist/cjs/mds-hr.cjs.entry.js +1 -1
  53. package/dist/cjs/mds-img.cjs.entry.js +1 -1
  54. package/dist/cjs/mds-input-date-range-preselection.cjs.entry.js +1 -1
  55. package/dist/cjs/mds-input-date-range.cjs.entry.js +3 -3
  56. package/dist/cjs/mds-input-date.cjs.entry.js +4 -4
  57. package/dist/cjs/mds-input-field.cjs.entry.js +1 -1
  58. package/dist/cjs/mds-input-otp.cjs.entry.js +2 -2
  59. package/dist/cjs/mds-input-range.cjs.entry.js +2 -2
  60. package/dist/cjs/mds-input-select.cjs.entry.js +9 -5
  61. package/dist/cjs/mds-input-switch_2.cjs.entry.js +3 -3
  62. package/dist/cjs/mds-input-tip_2.cjs.entry.js +4 -4
  63. package/dist/cjs/mds-input-upload.cjs.entry.js +6 -6
  64. package/dist/cjs/mds-input.cjs.entry.js +154 -37
  65. package/dist/cjs/mds-keyboard-key.cjs.entry.js +3 -3
  66. package/dist/cjs/mds-keyboard.cjs.entry.js +8 -4
  67. package/dist/cjs/mds-kpi-item.cjs.entry.js +1 -1
  68. package/dist/cjs/mds-kpi.cjs.entry.js +1 -1
  69. package/dist/cjs/mds-label.cjs.entry.js +2 -2
  70. package/dist/cjs/mds-link.cjs.entry.js +4 -4
  71. package/dist/cjs/mds-list-item.cjs.entry.js +1 -1
  72. package/dist/cjs/mds-list.cjs.entry.js +1 -1
  73. package/dist/cjs/mds-mention.cjs.entry.js +2 -2
  74. package/dist/cjs/mds-modal.cjs.entry.js +4 -4
  75. package/dist/cjs/mds-note.cjs.entry.js +2 -2
  76. package/dist/cjs/mds-notification.cjs.entry.js +1 -1
  77. package/dist/cjs/mds-paginator-item.cjs.entry.js +1 -1
  78. package/dist/cjs/mds-paginator.cjs.entry.js +2 -2
  79. package/dist/cjs/mds-policy-ai.cjs.entry.js +2 -2
  80. package/dist/cjs/mds-pref-animation.cjs.entry.js +2 -2
  81. package/dist/cjs/mds-pref-consumption.cjs.entry.js +2 -2
  82. package/dist/cjs/mds-pref-contrast.cjs.entry.js +2 -2
  83. package/dist/cjs/mds-pref-language-item.cjs.entry.js +2 -2
  84. package/dist/cjs/mds-pref-language.cjs.entry.js +2 -2
  85. package/dist/cjs/mds-pref-mode.cjs.entry.js +2 -2
  86. package/dist/cjs/mds-pref-theme-item.cjs.entry.js +1 -1
  87. package/dist/cjs/mds-pref-theme.cjs.entry.js +2 -2
  88. package/dist/cjs/mds-pref.cjs.entry.js +2 -2
  89. package/dist/cjs/mds-price-table-features-cell.cjs.entry.js +1 -1
  90. package/dist/cjs/mds-price-table-features-row.cjs.entry.js +1 -1
  91. package/dist/cjs/mds-price-table-features.cjs.entry.js +1 -1
  92. package/dist/cjs/mds-price-table-header.cjs.entry.js +1 -1
  93. package/dist/cjs/mds-price-table-list-item.cjs.entry.js +1 -1
  94. package/dist/cjs/mds-price-table-list.cjs.entry.js +1 -1
  95. package/dist/cjs/mds-price-table.cjs.entry.js +1 -1
  96. package/dist/cjs/mds-progress_2.cjs.entry.js +2 -2
  97. package/dist/cjs/mds-push-notification-item.cjs.entry.js +3 -3
  98. package/dist/cjs/mds-push-notification.cjs.entry.js +3 -3
  99. package/dist/cjs/mds-quote.cjs.entry.js +1 -1
  100. package/dist/cjs/mds-radial-menu-item.cjs.entry.js +1 -1
  101. package/dist/cjs/mds-radial-menu.cjs.entry.js +2 -2
  102. package/dist/cjs/mds-separator.cjs.entry.js +1 -1
  103. package/dist/cjs/mds-status-bar.cjs.entry.js +2 -2
  104. package/dist/cjs/mds-stepper-bar-item.cjs.entry.js +7 -5
  105. package/dist/cjs/mds-stepper-bar.cjs.entry.js +1 -1
  106. package/dist/cjs/mds-tab-bar-item.cjs.entry.js +1 -1
  107. package/dist/cjs/mds-tab-bar.cjs.entry.js +1 -1
  108. package/dist/cjs/mds-tab_2.cjs.entry.js +4 -4
  109. package/dist/cjs/mds-table-body.cjs.entry.js +1 -1
  110. package/dist/cjs/mds-table-footer.cjs.entry.js +1 -1
  111. package/dist/cjs/mds-table-header-cell.cjs.entry.js +1 -1
  112. package/dist/cjs/mds-table-header.cjs.entry.js +2 -2
  113. package/dist/cjs/mds-table-row.cjs.entry.js +3 -3
  114. package/dist/cjs/mds-table.cjs.entry.js +2 -2
  115. package/dist/cjs/mds-text.cjs.entry.js +1 -1
  116. package/dist/cjs/mds-toast-region.cjs.entry.js +1 -1
  117. package/dist/cjs/mds-toast.cjs.entry.js +2 -2
  118. package/dist/cjs/mds-tooltip.cjs.entry.js +2 -2
  119. package/dist/cjs/mds-tree-item.cjs.entry.js +2 -2
  120. package/dist/cjs/mds-tree.cjs.entry.js +1 -1
  121. package/dist/cjs/mds-url-view.cjs.entry.js +2 -2
  122. package/dist/cjs/mds-usage.cjs.entry.js +2 -2
  123. package/dist/cjs/mds-video-wall.cjs.entry.js +1 -1
  124. package/dist/cjs/mds-zero.cjs.entry.js +1 -1
  125. package/dist/collection/collection-manifest.json +1 -0
  126. package/dist/collection/common/locale.js +12 -6
  127. package/dist/collection/components/mds-accordion/AGENTS.md +3 -5
  128. package/dist/collection/components/mds-accordion/antipattern.md +1 -2
  129. package/dist/collection/components/mds-accordion/documentation.json +21 -10
  130. package/dist/collection/components/mds-accordion/mds-accordion.css +3 -3
  131. package/dist/collection/components/mds-accordion/mds-accordion.js +2 -1
  132. package/dist/collection/components/mds-accordion/pattern.md +1 -4
  133. package/dist/collection/components/mds-accordion-item/AGENTS.md +3 -7
  134. package/dist/collection/components/mds-accordion-item/documentation.json +20 -9
  135. package/dist/collection/components/mds-accordion-item/mds-accordion-item.css +1 -1
  136. package/dist/collection/components/mds-accordion-item/mds-accordion-item.js +2 -1
  137. package/dist/collection/components/mds-accordion-item/pattern.md +3 -5
  138. package/dist/collection/components/mds-accordion-timer/AGENTS.md +3 -5
  139. package/dist/collection/components/mds-accordion-timer/antipattern.md +5 -3
  140. package/dist/collection/components/mds-accordion-timer/documentation.json +17 -8
  141. package/dist/collection/components/mds-accordion-timer/mds-accordion-timer.css +1 -1
  142. package/dist/collection/components/mds-accordion-timer/mds-accordion-timer.js +2 -1
  143. package/dist/collection/components/mds-accordion-timer/pattern.md +6 -6
  144. package/dist/collection/components/mds-accordion-timer-item/AGENTS.md +3 -5
  145. package/dist/collection/components/mds-accordion-timer-item/antipattern.md +1 -2
  146. package/dist/collection/components/mds-accordion-timer-item/documentation.json +17 -8
  147. package/dist/collection/components/mds-accordion-timer-item/mds-accordion-timer-item.css +1 -1
  148. package/dist/collection/components/mds-accordion-timer-item/mds-accordion-timer-item.js +2 -1
  149. package/dist/collection/components/mds-accordion-timer-item/pattern.md +1 -5
  150. package/dist/collection/components/mds-author/AGENTS.md +1 -1
  151. package/dist/collection/components/mds-author/documentation.json +5 -1
  152. package/dist/collection/components/mds-author/mds-author.js +2 -1
  153. package/dist/collection/components/mds-avatar/AGENTS.md +3 -3
  154. package/dist/collection/components/mds-avatar/antipattern.md +1 -1
  155. package/dist/collection/components/mds-avatar/documentation.json +17 -8
  156. package/dist/collection/components/mds-avatar/mds-avatar.css +3 -3
  157. package/dist/collection/components/mds-avatar/mds-avatar.js +2 -1
  158. package/dist/collection/components/mds-avatar/pattern.md +1 -2
  159. package/dist/collection/components/mds-avatar-stack/AGENTS.md +3 -12
  160. package/dist/collection/components/mds-avatar-stack/antipattern.md +1 -2
  161. package/dist/collection/components/mds-avatar-stack/documentation.json +31 -15
  162. package/dist/collection/components/mds-avatar-stack/mds-avatar-stack.css +1 -1
  163. package/dist/collection/components/mds-avatar-stack/mds-avatar-stack.js +2 -1
  164. package/dist/collection/components/mds-avatar-stack/pattern.md +2 -5
  165. package/dist/collection/components/mds-avatar-stack-item/AGENTS.md +3 -6
  166. package/dist/collection/components/mds-avatar-stack-item/documentation.json +22 -10
  167. package/dist/collection/components/mds-avatar-stack-item/mds-avatar-stack-item.css +2 -2
  168. package/dist/collection/components/mds-avatar-stack-item/mds-avatar-stack-item.js +4 -1
  169. package/dist/collection/components/mds-avatar-stack-item/pattern.md +4 -5
  170. package/dist/collection/components/mds-badge/AGENTS.md +3 -3
  171. package/dist/collection/components/mds-badge/antipattern.md +1 -1
  172. package/dist/collection/components/mds-badge/documentation.json +17 -8
  173. package/dist/collection/components/mds-badge/mds-badge.css +3 -3
  174. package/dist/collection/components/mds-badge/mds-badge.js +2 -1
  175. package/dist/collection/components/mds-badge/pattern.md +4 -7
  176. package/dist/collection/components/mds-banner/AGENTS.md +3 -8
  177. package/dist/collection/components/mds-banner/antipattern.md +1 -2
  178. package/dist/collection/components/mds-banner/documentation.json +29 -14
  179. package/dist/collection/components/mds-banner/mds-banner.css +4 -4
  180. package/dist/collection/components/mds-banner/mds-banner.js +2 -1
  181. package/dist/collection/components/mds-banner/pattern.md +1 -2
  182. package/dist/collection/components/mds-benchmark-bar/AGENTS.md +1 -1
  183. package/dist/collection/components/mds-benchmark-bar/documentation.json +5 -1
  184. package/dist/collection/components/mds-benchmark-bar/mds-benchmark-bar.js +2 -1
  185. package/dist/collection/components/mds-bibliography/AGENTS.md +3 -3
  186. package/dist/collection/components/mds-bibliography/antipattern.md +1 -3
  187. package/dist/collection/components/mds-bibliography/documentation.json +15 -7
  188. package/dist/collection/components/mds-bibliography/mds-bibliography.css +1 -1
  189. package/dist/collection/components/mds-bibliography/mds-bibliography.js +4 -1
  190. package/dist/collection/components/mds-bibliography/pattern.md +1 -3
  191. package/dist/collection/components/mds-book/AGENTS.md +79 -0
  192. package/dist/collection/components/mds-book/antipattern.md +88 -0
  193. package/dist/collection/components/mds-book/documentation.json +482 -0
  194. package/dist/collection/components/mds-book/mds-book.css +901 -0
  195. package/dist/collection/components/mds-book/mds-book.js +731 -0
  196. package/dist/collection/components/mds-book/meta/dictionary.js +5 -0
  197. package/dist/collection/components/mds-book/meta/format.js +57 -0
  198. package/dist/collection/components/mds-book/meta/pose.js +107 -0
  199. package/dist/collection/components/mds-book/meta/spine.js +61 -0
  200. package/dist/collection/components/mds-book/meta/types.js +1 -0
  201. package/dist/collection/components/mds-book/meta/volume.js +23 -0
  202. package/dist/collection/components/mds-book/pattern.md +111 -0
  203. package/dist/collection/components/mds-breadcrumb/AGENTS.md +3 -14
  204. package/dist/collection/components/mds-breadcrumb/antipattern.md +1 -1
  205. package/dist/collection/components/mds-breadcrumb/documentation.json +28 -14
  206. package/dist/collection/components/mds-breadcrumb/mds-breadcrumb.js +2 -1
  207. package/dist/collection/components/mds-breadcrumb/pattern.md +6 -6
  208. package/dist/collection/components/mds-breadcrumb-item/AGENTS.md +3 -11
  209. package/dist/collection/components/mds-breadcrumb-item/antipattern.md +3 -3
  210. package/dist/collection/components/mds-breadcrumb-item/documentation.json +22 -11
  211. package/dist/collection/components/mds-breadcrumb-item/mds-breadcrumb-item.js +2 -1
  212. package/dist/collection/components/mds-breadcrumb-item/pattern.md +12 -14
  213. package/dist/collection/components/mds-button/AGENTS.md +3 -12
  214. package/dist/collection/components/mds-button/documentation.json +37 -17
  215. package/dist/collection/components/mds-button/mds-button.css +5 -5
  216. package/dist/collection/components/mds-button/mds-button.js +5 -4
  217. package/dist/collection/components/mds-button-dropdown/AGENTS.md +1 -1
  218. package/dist/collection/components/mds-button-dropdown/documentation.json +7 -2
  219. package/dist/collection/components/mds-button-dropdown/mds-button-dropdown.css +1 -1
  220. package/dist/collection/components/mds-button-dropdown/mds-button-dropdown.js +2 -1
  221. package/dist/collection/components/mds-button-group/AGENTS.md +1 -1
  222. package/dist/collection/components/mds-button-group/documentation.json +5 -1
  223. package/dist/collection/components/mds-button-group/mds-button-group.js +2 -1
  224. package/dist/collection/components/mds-calendar/AGENTS.md +3 -6
  225. package/dist/collection/components/mds-calendar/antipattern.md +1 -1
  226. package/dist/collection/components/mds-calendar/documentation.json +25 -12
  227. package/dist/collection/components/mds-calendar/mds-calendar.css +4 -4
  228. package/dist/collection/components/mds-calendar/mds-calendar.js +6 -5
  229. package/dist/collection/components/mds-calendar/pattern.md +1 -3
  230. package/dist/collection/components/mds-calendar-cell/AGENTS.md +3 -35
  231. package/dist/collection/components/mds-calendar-cell/antipattern.md +1 -2
  232. package/dist/collection/components/mds-calendar-cell/documentation.json +81 -40
  233. package/dist/collection/components/mds-calendar-cell/mds-calendar-cell.css +2 -2
  234. package/dist/collection/components/mds-calendar-cell/mds-calendar-cell.js +4 -1
  235. package/dist/collection/components/mds-calendar-cell/pattern.md +4 -5
  236. package/dist/collection/components/mds-card/AGENTS.md +1 -1
  237. package/dist/collection/components/mds-card/antipattern.md +2 -2
  238. package/dist/collection/components/mds-card/documentation.json +13 -6
  239. package/dist/collection/components/mds-card/mds-card.css +3 -3
  240. package/dist/collection/components/mds-card/mds-card.js +2 -1
  241. package/dist/collection/components/mds-card/pattern.md +4 -4
  242. package/dist/collection/components/mds-card-content/AGENTS.md +1 -1
  243. package/dist/collection/components/mds-card-content/documentation.json +5 -1
  244. package/dist/collection/components/mds-card-content/mds-card-content.js +2 -1
  245. package/dist/collection/components/mds-card-footer/AGENTS.md +1 -1
  246. package/dist/collection/components/mds-card-footer/documentation.json +5 -1
  247. package/dist/collection/components/mds-card-footer/mds-card-footer.js +2 -1
  248. package/dist/collection/components/mds-card-header/AGENTS.md +1 -1
  249. package/dist/collection/components/mds-card-header/documentation.json +5 -1
  250. package/dist/collection/components/mds-card-header/mds-card-header.js +2 -1
  251. package/dist/collection/components/mds-card-media/AGENTS.md +1 -1
  252. package/dist/collection/components/mds-card-media/documentation.json +5 -1
  253. package/dist/collection/components/mds-card-media/mds-card-media.js +2 -1
  254. package/dist/collection/components/mds-chip/AGENTS.md +3 -10
  255. package/dist/collection/components/mds-chip/antipattern.md +2 -3
  256. package/dist/collection/components/mds-chip/documentation.json +35 -17
  257. package/dist/collection/components/mds-chip/mds-chip.css +4 -4
  258. package/dist/collection/components/mds-chip/mds-chip.js +4 -1
  259. package/dist/collection/components/mds-chip/pattern.md +4 -6
  260. package/dist/collection/components/mds-details/AGENTS.md +3 -7
  261. package/dist/collection/components/mds-details/antipattern.md +1 -5
  262. package/dist/collection/components/mds-details/documentation.json +14 -7
  263. package/dist/collection/components/mds-details/mds-details.js +2 -1
  264. package/dist/collection/components/mds-details/pattern.md +4 -6
  265. package/dist/collection/components/mds-dropdown/AGENTS.md +3 -9
  266. package/dist/collection/components/mds-dropdown/antipattern.md +1 -1
  267. package/dist/collection/components/mds-dropdown/documentation.json +31 -15
  268. package/dist/collection/components/mds-dropdown/mds-dropdown.css +4 -4
  269. package/dist/collection/components/mds-dropdown/mds-dropdown.js +3 -2
  270. package/dist/collection/components/mds-dropdown/pattern.md +2 -4
  271. package/dist/collection/components/mds-emoji/AGENTS.md +8 -32
  272. package/dist/collection/components/mds-emoji/antipattern.md +0 -18
  273. package/dist/collection/components/mds-emoji/documentation.json +73 -35
  274. package/dist/collection/components/mds-emoji/mds-emoji.css +8 -5
  275. package/dist/collection/components/mds-emoji/mds-emoji.js +4 -1
  276. package/dist/collection/components/mds-emoji/pattern.md +9 -25
  277. package/dist/collection/components/mds-entity/AGENTS.md +3 -4
  278. package/dist/collection/components/mds-entity/antipattern.md +10 -3
  279. package/dist/collection/components/mds-entity/documentation.json +17 -8
  280. package/dist/collection/components/mds-entity/mds-entity.css +2 -2
  281. package/dist/collection/components/mds-entity/mds-entity.js +2 -1
  282. package/dist/collection/components/mds-entity/pattern.md +1 -4
  283. package/dist/collection/components/mds-file/AGENTS.md +3 -3
  284. package/dist/collection/components/mds-file/antipattern.md +2 -3
  285. package/dist/collection/components/mds-file/documentation.json +15 -7
  286. package/dist/collection/components/mds-file/mds-file.css +1 -1
  287. package/dist/collection/components/mds-file/mds-file.js +4 -1
  288. package/dist/collection/components/mds-file/pattern.md +1 -3
  289. package/dist/collection/components/mds-file-preview/AGENTS.md +3 -3
  290. package/dist/collection/components/mds-file-preview/antipattern.md +1 -1
  291. package/dist/collection/components/mds-file-preview/documentation.json +17 -8
  292. package/dist/collection/components/mds-file-preview/mds-file-preview.css +3 -3
  293. package/dist/collection/components/mds-file-preview/mds-file-preview.js +3 -2
  294. package/dist/collection/components/mds-file-preview/pattern.md +2 -3
  295. package/dist/collection/components/mds-filter/AGENTS.md +3 -8
  296. package/dist/collection/components/mds-filter/antipattern.md +2 -2
  297. package/dist/collection/components/mds-filter/documentation.json +27 -13
  298. package/dist/collection/components/mds-filter/mds-filter.css +3 -3
  299. package/dist/collection/components/mds-filter/mds-filter.js +2 -1
  300. package/dist/collection/components/mds-filter/pattern.md +2 -5
  301. package/dist/collection/components/mds-filter-item/AGENTS.md +2 -7
  302. package/dist/collection/components/mds-filter-item/antipattern.md +4 -4
  303. package/dist/collection/components/mds-filter-item/documentation.json +17 -8
  304. package/dist/collection/components/mds-filter-item/mds-filter-item.js +4 -1
  305. package/dist/collection/components/mds-filter-item/pattern.md +5 -7
  306. package/dist/collection/components/mds-header/AGENTS.md +4 -8
  307. package/dist/collection/components/mds-header/documentation.json +28 -13
  308. package/dist/collection/components/mds-header/mds-header.css +7 -7
  309. package/dist/collection/components/mds-header/mds-header.js +2 -1
  310. package/dist/collection/components/mds-header/pattern.md +1 -3
  311. package/dist/collection/components/mds-header-bar/AGENTS.md +2 -4
  312. package/dist/collection/components/mds-header-bar/antipattern.md +6 -8
  313. package/dist/collection/components/mds-header-bar/documentation.json +9 -4
  314. package/dist/collection/components/mds-header-bar/mds-header-bar.js +2 -1
  315. package/dist/collection/components/mds-header-bar/pattern.md +10 -6
  316. package/dist/collection/components/mds-help/AGENTS.md +1 -1
  317. package/dist/collection/components/mds-help/documentation.json +13 -5
  318. package/dist/collection/components/mds-help/mds-help.css +4 -4
  319. package/dist/collection/components/mds-help/mds-help.js +2 -1
  320. package/dist/collection/components/mds-horizontal-scroll/AGENTS.md +5 -11
  321. package/dist/collection/components/mds-horizontal-scroll/antipattern.md +2 -2
  322. package/dist/collection/components/mds-horizontal-scroll/documentation.json +34 -14
  323. package/dist/collection/components/mds-horizontal-scroll/mds-horizontal-scroll.css +2 -1
  324. package/dist/collection/components/mds-horizontal-scroll/mds-horizontal-scroll.js +2 -1
  325. package/dist/collection/components/mds-horizontal-scroll/pattern.md +4 -15
  326. package/dist/collection/components/mds-hr/AGENTS.md +1 -1
  327. package/dist/collection/components/mds-hr/documentation.json +7 -2
  328. package/dist/collection/components/mds-hr/mds-hr.js +4 -1
  329. package/dist/collection/components/mds-icon/AGENTS.md +1 -1
  330. package/dist/collection/components/mds-icon/documentation.json +5 -1
  331. package/dist/collection/components/mds-icon/mds-icon.js +2 -1
  332. package/dist/collection/components/mds-img/AGENTS.md +3 -5
  333. package/dist/collection/components/mds-img/antipattern.md +1 -1
  334. package/dist/collection/components/mds-img/documentation.json +19 -9
  335. package/dist/collection/components/mds-img/mds-img.css +2 -2
  336. package/dist/collection/components/mds-img/mds-img.js +1 -0
  337. package/dist/collection/components/mds-img/pattern.md +1 -4
  338. package/dist/collection/components/mds-input/AGENTS.md +6 -10
  339. package/dist/collection/components/mds-input/antipattern.md +1 -1
  340. package/dist/collection/components/mds-input/documentation.json +40 -20
  341. package/dist/collection/components/mds-input/mds-input.css +8 -8
  342. package/dist/collection/components/mds-input/mds-input.js +13 -7
  343. package/dist/collection/components/mds-input/meta/input-type/InputValidationManager.js +3 -3
  344. package/dist/collection/components/mds-input/meta/validators.js +28 -13
  345. package/dist/collection/components/mds-input/meta/validity.js +8 -10
  346. package/dist/collection/components/mds-input/pattern.md +1 -3
  347. package/dist/collection/components/mds-input-date/AGENTS.md +3 -8
  348. package/dist/collection/components/mds-input-date/antipattern.md +1 -1
  349. package/dist/collection/components/mds-input-date/documentation.json +31 -15
  350. package/dist/collection/components/mds-input-date/mds-input-date.css +5 -5
  351. package/dist/collection/components/mds-input-date/mds-input-date.js +3 -2
  352. package/dist/collection/components/mds-input-date/pattern.md +1 -2
  353. package/dist/collection/components/mds-input-date-range/AGENTS.md +3 -4
  354. package/dist/collection/components/mds-input-date-range/documentation.json +22 -10
  355. package/dist/collection/components/mds-input-date-range/mds-input-date-range.css +5 -5
  356. package/dist/collection/components/mds-input-date-range/mds-input-date-range.js +3 -2
  357. package/dist/collection/components/mds-input-date-range/pattern.md +1 -2
  358. package/dist/collection/components/mds-input-date-range-preselection/AGENTS.md +3 -13
  359. package/dist/collection/components/mds-input-date-range-preselection/antipattern.md +11 -6
  360. package/dist/collection/components/mds-input-date-range-preselection/documentation.json +26 -13
  361. package/dist/collection/components/mds-input-date-range-preselection/mds-input-date-range-preselection.js +2 -1
  362. package/dist/collection/components/mds-input-date-range-preselection/pattern.md +1 -11
  363. package/dist/collection/components/mds-input-field/AGENTS.md +1 -1
  364. package/dist/collection/components/mds-input-field/documentation.json +9 -3
  365. package/dist/collection/components/mds-input-field/mds-input-field.css +2 -2
  366. package/dist/collection/components/mds-input-field/mds-input-field.js +2 -1
  367. package/dist/collection/components/mds-input-otp/AGENTS.md +1 -1
  368. package/dist/collection/components/mds-input-otp/documentation.json +7 -2
  369. package/dist/collection/components/mds-input-otp/mds-input-otp.js +4 -1
  370. package/dist/collection/components/mds-input-range/AGENTS.md +3 -13
  371. package/dist/collection/components/mds-input-range/antipattern.md +1 -5
  372. package/dist/collection/components/mds-input-range/documentation.json +26 -13
  373. package/dist/collection/components/mds-input-range/mds-input-range.css +26 -19
  374. package/dist/collection/components/mds-input-range/mds-input-range.js +2 -1
  375. package/dist/collection/components/mds-input-range/pattern.md +2 -12
  376. package/dist/collection/components/mds-input-select/AGENTS.md +4 -8
  377. package/dist/collection/components/mds-input-select/antipattern.md +1 -1
  378. package/dist/collection/components/mds-input-select/documentation.json +26 -13
  379. package/dist/collection/components/mds-input-select/mds-input-select.css +3 -3
  380. package/dist/collection/components/mds-input-select/mds-input-select.js +8 -3
  381. package/dist/collection/components/mds-input-select/pattern.md +1 -3
  382. package/dist/collection/components/mds-input-switch/AGENTS.md +2 -30
  383. package/dist/collection/components/mds-input-switch/antipattern.md +5 -6
  384. package/dist/collection/components/mds-input-switch/documentation.json +61 -30
  385. package/dist/collection/components/mds-input-switch/mds-input-switch.js +2 -1
  386. package/dist/collection/components/mds-input-switch/pattern.md +2 -11
  387. package/dist/collection/components/mds-input-tip/AGENTS.md +3 -5
  388. package/dist/collection/components/mds-input-tip/antipattern.md +10 -6
  389. package/dist/collection/components/mds-input-tip/documentation.json +17 -8
  390. package/dist/collection/components/mds-input-tip/mds-input-tip.css +1 -1
  391. package/dist/collection/components/mds-input-tip/mds-input-tip.js +2 -1
  392. package/dist/collection/components/mds-input-tip/pattern.md +1 -4
  393. package/dist/collection/components/mds-input-tip-item/AGENTS.md +4 -3
  394. package/dist/collection/components/mds-input-tip-item/antipattern.md +2 -2
  395. package/dist/collection/components/mds-input-tip-item/documentation.json +14 -7
  396. package/dist/collection/components/mds-input-tip-item/mds-input-tip-item.css +2 -2
  397. package/dist/collection/components/mds-input-tip-item/mds-input-tip-item.js +3 -2
  398. package/dist/collection/components/mds-input-tip-item/pattern.md +1 -2
  399. package/dist/collection/components/mds-input-upload/AGENTS.md +3 -5
  400. package/dist/collection/components/mds-input-upload/antipattern.md +2 -3
  401. package/dist/collection/components/mds-input-upload/documentation.json +19 -9
  402. package/dist/collection/components/mds-input-upload/mds-input-upload.css +1 -1
  403. package/dist/collection/components/mds-input-upload/mds-input-upload.js +8 -5
  404. package/dist/collection/components/mds-input-upload/pattern.md +1 -5
  405. package/dist/collection/components/mds-keyboard/AGENTS.md +4 -19
  406. package/dist/collection/components/mds-keyboard/antipattern.md +3 -3
  407. package/dist/collection/components/mds-keyboard/documentation.json +48 -24
  408. package/dist/collection/components/mds-keyboard/mds-keyboard.css +17 -5
  409. package/dist/collection/components/mds-keyboard/mds-keyboard.js +7 -2
  410. package/dist/collection/components/mds-keyboard/pattern.md +1 -2
  411. package/dist/collection/components/mds-keyboard-key/AGENTS.md +3 -6
  412. package/dist/collection/components/mds-keyboard-key/antipattern.md +1 -2
  413. package/dist/collection/components/mds-keyboard-key/documentation.json +21 -10
  414. package/dist/collection/components/mds-keyboard-key/mds-keyboard-key.css +7 -3
  415. package/dist/collection/components/mds-keyboard-key/mds-keyboard-key.js +4 -1
  416. package/dist/collection/components/mds-keyboard-key/pattern.md +1 -12
  417. package/dist/collection/components/mds-kpi/AGENTS.md +1 -1
  418. package/dist/collection/components/mds-kpi/documentation.json +10 -4
  419. package/dist/collection/components/mds-kpi/mds-kpi.css +2 -2
  420. package/dist/collection/components/mds-kpi/mds-kpi.js +2 -1
  421. package/dist/collection/components/mds-kpi/pattern.md +7 -4
  422. package/dist/collection/components/mds-kpi-item/AGENTS.md +3 -8
  423. package/dist/collection/components/mds-kpi-item/antipattern.md +2 -4
  424. package/dist/collection/components/mds-kpi-item/documentation.json +16 -8
  425. package/dist/collection/components/mds-kpi-item/mds-kpi-item.js +2 -1
  426. package/dist/collection/components/mds-kpi-item/pattern.md +9 -7
  427. package/dist/collection/components/mds-label/AGENTS.md +3 -7
  428. package/dist/collection/components/mds-label/documentation.json +24 -11
  429. package/dist/collection/components/mds-label/mds-label.css +2 -2
  430. package/dist/collection/components/mds-label/mds-label.js +4 -1
  431. package/dist/collection/components/mds-label/pattern.md +1 -3
  432. package/dist/collection/components/mds-link/AGENTS.md +4 -9
  433. package/dist/collection/components/mds-link/documentation.json +22 -10
  434. package/dist/collection/components/mds-link/mds-link.css +1 -1
  435. package/dist/collection/components/mds-link/mds-link.js +4 -3
  436. package/dist/collection/components/mds-list/AGENTS.md +1 -1
  437. package/dist/collection/components/mds-list/documentation.json +6 -2
  438. package/dist/collection/components/mds-list/mds-list.js +2 -1
  439. package/dist/collection/components/mds-list/pattern.md +5 -5
  440. package/dist/collection/components/mds-list-item/AGENTS.md +2 -4
  441. package/dist/collection/components/mds-list-item/antipattern.md +1 -1
  442. package/dist/collection/components/mds-list-item/documentation.json +9 -4
  443. package/dist/collection/components/mds-list-item/mds-list-item.js +2 -1
  444. package/dist/collection/components/mds-list-item/pattern.md +4 -4
  445. package/dist/collection/components/mds-mention/AGENTS.md +2 -4
  446. package/dist/collection/components/mds-mention/antipattern.md +5 -5
  447. package/dist/collection/components/mds-mention/documentation.json +11 -5
  448. package/dist/collection/components/mds-mention/mds-mention.js +4 -1
  449. package/dist/collection/components/mds-mention/pattern.md +3 -5
  450. package/dist/collection/components/mds-modal/AGENTS.md +3 -9
  451. package/dist/collection/components/mds-modal/antipattern.md +1 -3
  452. package/dist/collection/components/mds-modal/documentation.json +37 -18
  453. package/dist/collection/components/mds-modal/mds-modal.css +7 -7
  454. package/dist/collection/components/mds-modal/mds-modal.js +4 -3
  455. package/dist/collection/components/mds-modal/pattern.md +2 -6
  456. package/dist/collection/components/mds-note/AGENTS.md +3 -5
  457. package/dist/collection/components/mds-note/documentation.json +18 -8
  458. package/dist/collection/components/mds-note/mds-note.css +2 -2
  459. package/dist/collection/components/mds-note/mds-note.js +2 -1
  460. package/dist/collection/components/mds-note/pattern.md +1 -3
  461. package/dist/collection/components/mds-notification/AGENTS.md +3 -11
  462. package/dist/collection/components/mds-notification/antipattern.md +2 -2
  463. package/dist/collection/components/mds-notification/documentation.json +33 -16
  464. package/dist/collection/components/mds-notification/mds-notification.css +2 -2
  465. package/dist/collection/components/mds-notification/mds-notification.js +4 -1
  466. package/dist/collection/components/mds-notification/pattern.md +3 -5
  467. package/dist/collection/components/mds-paginator/AGENTS.md +1 -1
  468. package/dist/collection/components/mds-paginator/documentation.json +12 -5
  469. package/dist/collection/components/mds-paginator/mds-paginator.css +2 -2
  470. package/dist/collection/components/mds-paginator/mds-paginator.js +4 -1
  471. package/dist/collection/components/mds-paginator/pattern.md +1 -3
  472. package/dist/collection/components/mds-paginator-item/AGENTS.md +3 -10
  473. package/dist/collection/components/mds-paginator-item/documentation.json +34 -16
  474. package/dist/collection/components/mds-paginator-item/mds-paginator-item.css +5 -5
  475. package/dist/collection/components/mds-paginator-item/mds-paginator-item.js +2 -1
  476. package/dist/collection/components/mds-paginator-item/pattern.md +5 -6
  477. package/dist/collection/components/mds-policy-ai/AGENTS.md +1 -1
  478. package/dist/collection/components/mds-policy-ai/documentation.json +6 -2
  479. package/dist/collection/components/mds-policy-ai/mds-policy-ai.js +2 -1
  480. package/dist/collection/components/mds-policy-ai/pattern.md +4 -4
  481. package/dist/collection/components/mds-pref/AGENTS.md +1 -1
  482. package/dist/collection/components/mds-pref/documentation.json +5 -5
  483. package/dist/collection/components/mds-pref/mds-pref.js +2 -2
  484. package/dist/collection/components/mds-pref-animation/AGENTS.md +1 -1
  485. package/dist/collection/components/mds-pref-animation/documentation.json +7 -2
  486. package/dist/collection/components/mds-pref-animation/mds-pref-animation.js +4 -1
  487. package/dist/collection/components/mds-pref-consumption/AGENTS.md +1 -1
  488. package/dist/collection/components/mds-pref-consumption/documentation.json +7 -2
  489. package/dist/collection/components/mds-pref-consumption/mds-pref-consumption.js +4 -1
  490. package/dist/collection/components/mds-pref-contrast/AGENTS.md +1 -1
  491. package/dist/collection/components/mds-pref-contrast/documentation.json +7 -2
  492. package/dist/collection/components/mds-pref-contrast/mds-pref-contrast.js +4 -1
  493. package/dist/collection/components/mds-pref-language/AGENTS.md +1 -1
  494. package/dist/collection/components/mds-pref-language/documentation.json +5 -1
  495. package/dist/collection/components/mds-pref-language/mds-pref-language.js +2 -1
  496. package/dist/collection/components/mds-pref-language-item/AGENTS.md +1 -1
  497. package/dist/collection/components/mds-pref-language-item/documentation.json +7 -2
  498. package/dist/collection/components/mds-pref-language-item/mds-pref-language-item.js +4 -1
  499. package/dist/collection/components/mds-pref-mode/AGENTS.md +3 -3
  500. package/dist/collection/components/mds-pref-mode/antipattern.md +1 -2
  501. package/dist/collection/components/mds-pref-mode/documentation.json +15 -7
  502. package/dist/collection/components/mds-pref-mode/mds-pref-mode.css +1 -1
  503. package/dist/collection/components/mds-pref-mode/mds-pref-mode.js +4 -1
  504. package/dist/collection/components/mds-pref-mode/pattern.md +1 -3
  505. package/dist/collection/components/mds-pref-theme/AGENTS.md +1 -1
  506. package/dist/collection/components/mds-pref-theme/documentation.json +6 -2
  507. package/dist/collection/components/mds-pref-theme/mds-pref-theme.js +2 -1
  508. package/dist/collection/components/mds-pref-theme/pattern.md +1 -2
  509. package/dist/collection/components/mds-pref-theme-item/AGENTS.md +3 -5
  510. package/dist/collection/components/mds-pref-theme-item/antipattern.md +1 -2
  511. package/dist/collection/components/mds-pref-theme-item/documentation.json +19 -9
  512. package/dist/collection/components/mds-pref-theme-item/mds-pref-theme-item.css +1 -1
  513. package/dist/collection/components/mds-pref-theme-item/mds-pref-theme-item.js +4 -1
  514. package/dist/collection/components/mds-pref-theme-item/pattern.md +2 -6
  515. package/dist/collection/components/mds-price-table/AGENTS.md +1 -1
  516. package/dist/collection/components/mds-price-table/documentation.json +6 -2
  517. package/dist/collection/components/mds-price-table/mds-price-table.js +2 -1
  518. package/dist/collection/components/mds-price-table/pattern.md +4 -4
  519. package/dist/collection/components/mds-price-table-features/AGENTS.md +4 -3
  520. package/dist/collection/components/mds-price-table-features/antipattern.md +0 -1
  521. package/dist/collection/components/mds-price-table-features/documentation.json +12 -6
  522. package/dist/collection/components/mds-price-table-features/mds-price-table-features.css +1 -1
  523. package/dist/collection/components/mds-price-table-features/mds-price-table-features.js +2 -1
  524. package/dist/collection/components/mds-price-table-features/pattern.md +2 -3
  525. package/dist/collection/components/mds-price-table-features-cell/AGENTS.md +3 -6
  526. package/dist/collection/components/mds-price-table-features-cell/antipattern.md +3 -3
  527. package/dist/collection/components/mds-price-table-features-cell/documentation.json +19 -9
  528. package/dist/collection/components/mds-price-table-features-cell/mds-price-table-features-cell.css +1 -1
  529. package/dist/collection/components/mds-price-table-features-cell/mds-price-table-features-cell.js +2 -1
  530. package/dist/collection/components/mds-price-table-features-cell/pattern.md +1 -6
  531. package/dist/collection/components/mds-price-table-features-row/AGENTS.md +3 -3
  532. package/dist/collection/components/mds-price-table-features-row/documentation.json +14 -6
  533. package/dist/collection/components/mds-price-table-features-row/mds-price-table-features-row.css +2 -2
  534. package/dist/collection/components/mds-price-table-features-row/mds-price-table-features-row.js +2 -1
  535. package/dist/collection/components/mds-price-table-features-row/pattern.md +1 -3
  536. package/dist/collection/components/mds-price-table-header/AGENTS.md +1 -1
  537. package/dist/collection/components/mds-price-table-header/documentation.json +5 -1
  538. package/dist/collection/components/mds-price-table-header/mds-price-table-header.js +2 -1
  539. package/dist/collection/components/mds-price-table-list/AGENTS.md +3 -5
  540. package/dist/collection/components/mds-price-table-list/antipattern.md +1 -4
  541. package/dist/collection/components/mds-price-table-list/documentation.json +10 -5
  542. package/dist/collection/components/mds-price-table-list/mds-price-table-list.js +2 -1
  543. package/dist/collection/components/mds-price-table-list/pattern.md +12 -7
  544. package/dist/collection/components/mds-price-table-list-item/AGENTS.md +2 -6
  545. package/dist/collection/components/mds-price-table-list-item/antipattern.md +1 -5
  546. package/dist/collection/components/mds-price-table-list-item/documentation.json +13 -6
  547. package/dist/collection/components/mds-price-table-list-item/mds-price-table-list-item.js +2 -1
  548. package/dist/collection/components/mds-price-table-list-item/pattern.md +7 -4
  549. package/dist/collection/components/mds-progress/AGENTS.md +1 -1
  550. package/dist/collection/components/mds-progress/documentation.json +15 -6
  551. package/dist/collection/components/mds-progress/mds-progress.css +5 -5
  552. package/dist/collection/components/mds-progress/mds-progress.js +2 -1
  553. package/dist/collection/components/mds-push-notification/AGENTS.md +4 -7
  554. package/dist/collection/components/mds-push-notification/antipattern.md +2 -2
  555. package/dist/collection/components/mds-push-notification/documentation.json +24 -12
  556. package/dist/collection/components/mds-push-notification/mds-push-notification.css +11 -11
  557. package/dist/collection/components/mds-push-notification/mds-push-notification.js +2 -1
  558. package/dist/collection/components/mds-push-notification/pattern.md +2 -5
  559. package/dist/collection/components/mds-push-notification-item/AGENTS.md +3 -5
  560. package/dist/collection/components/mds-push-notification-item/documentation.json +20 -9
  561. package/dist/collection/components/mds-push-notification-item/mds-push-notification-item.css +3 -3
  562. package/dist/collection/components/mds-push-notification-item/mds-push-notification-item.js +3 -2
  563. package/dist/collection/components/mds-push-notification-item/pattern.md +1 -3
  564. package/dist/collection/components/mds-quote/AGENTS.md +1 -1
  565. package/dist/collection/components/mds-quote/documentation.json +5 -1
  566. package/dist/collection/components/mds-quote/mds-quote.js +2 -1
  567. package/dist/collection/components/mds-radial-menu/AGENTS.md +4 -11
  568. package/dist/collection/components/mds-radial-menu/documentation.json +31 -15
  569. package/dist/collection/components/mds-radial-menu/mds-radial-menu.css +3 -3
  570. package/dist/collection/components/mds-radial-menu/mds-radial-menu.js +2 -1
  571. package/dist/collection/components/mds-radial-menu/pattern.md +2 -6
  572. package/dist/collection/components/mds-radial-menu-item/AGENTS.md +2 -5
  573. package/dist/collection/components/mds-radial-menu-item/antipattern.md +7 -5
  574. package/dist/collection/components/mds-radial-menu-item/documentation.json +13 -6
  575. package/dist/collection/components/mds-radial-menu-item/mds-radial-menu-item.js +4 -1
  576. package/dist/collection/components/mds-radial-menu-item/pattern.md +6 -8
  577. package/dist/collection/components/mds-radial-progress/AGENTS.md +3 -3
  578. package/dist/collection/components/mds-radial-progress/documentation.json +15 -6
  579. package/dist/collection/components/mds-radial-progress/mds-radial-progress.css +3 -3
  580. package/dist/collection/components/mds-radial-progress/mds-radial-progress.js +2 -1
  581. package/dist/collection/components/mds-separator/AGENTS.md +1 -1
  582. package/dist/collection/components/mds-separator/documentation.json +9 -3
  583. package/dist/collection/components/mds-separator/mds-separator.css +1 -1
  584. package/dist/collection/components/mds-separator/mds-separator.js +4 -1
  585. package/dist/collection/components/mds-spinner/AGENTS.md +1 -1
  586. package/dist/collection/components/mds-spinner/documentation.json +9 -3
  587. package/dist/collection/components/mds-spinner/mds-spinner.css +1 -1
  588. package/dist/collection/components/mds-spinner/mds-spinner.js +4 -1
  589. package/dist/collection/components/mds-status-bar/AGENTS.md +3 -3
  590. package/dist/collection/components/mds-status-bar/antipattern.md +0 -1
  591. package/dist/collection/components/mds-status-bar/documentation.json +13 -6
  592. package/dist/collection/components/mds-status-bar/mds-status-bar.css +2 -1
  593. package/dist/collection/components/mds-status-bar/mds-status-bar.js +2 -1
  594. package/dist/collection/components/mds-status-bar/pattern.md +1 -3
  595. package/dist/collection/components/mds-stepper-bar/AGENTS.md +3 -7
  596. package/dist/collection/components/mds-stepper-bar/documentation.json +22 -10
  597. package/dist/collection/components/mds-stepper-bar/mds-stepper-bar.css +2 -2
  598. package/dist/collection/components/mds-stepper-bar/mds-stepper-bar.js +2 -1
  599. package/dist/collection/components/mds-stepper-bar/pattern.md +2 -6
  600. package/dist/collection/components/mds-stepper-bar-item/AGENTS.md +3 -11
  601. package/dist/collection/components/mds-stepper-bar-item/antipattern.md +3 -3
  602. package/dist/collection/components/mds-stepper-bar-item/documentation.json +31 -15
  603. package/dist/collection/components/mds-stepper-bar-item/mds-stepper-bar-item.css +2 -2
  604. package/dist/collection/components/mds-stepper-bar-item/mds-stepper-bar-item.js +7 -4
  605. package/dist/collection/components/mds-stepper-bar-item/pattern.md +2 -5
  606. package/dist/collection/components/mds-tab/AGENTS.md +3 -27
  607. package/dist/collection/components/mds-tab/antipattern.md +1 -3
  608. package/dist/collection/components/mds-tab/documentation.json +67 -33
  609. package/dist/collection/components/mds-tab/mds-tab.css +5 -5
  610. package/dist/collection/components/mds-tab/mds-tab.js +3 -2
  611. package/dist/collection/components/mds-tab/pattern.md +3 -13
  612. package/dist/collection/components/mds-tab-bar/AGENTS.md +1 -1
  613. package/dist/collection/components/mds-tab-bar/antipattern.md +2 -2
  614. package/dist/collection/components/mds-tab-bar/documentation.json +7 -3
  615. package/dist/collection/components/mds-tab-bar/mds-tab-bar.js +2 -1
  616. package/dist/collection/components/mds-tab-bar/pattern.md +3 -3
  617. package/dist/collection/components/mds-tab-bar-item/AGENTS.md +4 -4
  618. package/dist/collection/components/mds-tab-bar-item/documentation.json +15 -7
  619. package/dist/collection/components/mds-tab-bar-item/mds-tab-bar-item.css +2 -2
  620. package/dist/collection/components/mds-tab-bar-item/mds-tab-bar-item.js +2 -1
  621. package/dist/collection/components/mds-tab-bar-item/pattern.md +1 -3
  622. package/dist/collection/components/mds-tab-item/AGENTS.md +2 -8
  623. package/dist/collection/components/mds-tab-item/antipattern.md +3 -3
  624. package/dist/collection/components/mds-tab-item/documentation.json +17 -8
  625. package/dist/collection/components/mds-tab-item/mds-tab-item.js +2 -1
  626. package/dist/collection/components/mds-tab-item/pattern.md +6 -5
  627. package/dist/collection/components/mds-table/AGENTS.md +3 -7
  628. package/dist/collection/components/mds-table/documentation.json +24 -11
  629. package/dist/collection/components/mds-table/mds-table.css +3 -3
  630. package/dist/collection/components/mds-table/mds-table.js +2 -1
  631. package/dist/collection/components/mds-table/pattern.md +2 -6
  632. package/dist/collection/components/mds-table-body/AGENTS.md +3 -4
  633. package/dist/collection/components/mds-table-body/antipattern.md +1 -2
  634. package/dist/collection/components/mds-table-body/documentation.json +17 -8
  635. package/dist/collection/components/mds-table-body/mds-table-body.css +2 -2
  636. package/dist/collection/components/mds-table-body/mds-table-body.js +2 -1
  637. package/dist/collection/components/mds-table-body/pattern.md +1 -4
  638. package/dist/collection/components/mds-table-cell/AGENTS.md +4 -4
  639. package/dist/collection/components/mds-table-cell/antipattern.md +1 -1
  640. package/dist/collection/components/mds-table-cell/documentation.json +16 -8
  641. package/dist/collection/components/mds-table-cell/mds-table-cell.css +2 -2
  642. package/dist/collection/components/mds-table-cell/mds-table-cell.js +2 -1
  643. package/dist/collection/components/mds-table-cell/pattern.md +1 -7
  644. package/dist/collection/components/mds-table-footer/AGENTS.md +1 -1
  645. package/dist/collection/components/mds-table-footer/antipattern.md +2 -2
  646. package/dist/collection/components/mds-table-footer/documentation.json +7 -3
  647. package/dist/collection/components/mds-table-footer/mds-table-footer.js +2 -1
  648. package/dist/collection/components/mds-table-footer/pattern.md +2 -4
  649. package/dist/collection/components/mds-table-header/AGENTS.md +1 -1
  650. package/dist/collection/components/mds-table-header/documentation.json +5 -1
  651. package/dist/collection/components/mds-table-header/mds-table-header.js +2 -1
  652. package/dist/collection/components/mds-table-header-cell/AGENTS.md +1 -1
  653. package/dist/collection/components/mds-table-header-cell/documentation.json +5 -1
  654. package/dist/collection/components/mds-table-header-cell/mds-table-header-cell.js +2 -1
  655. package/dist/collection/components/mds-table-row/AGENTS.md +2 -8
  656. package/dist/collection/components/mds-table-row/antipattern.md +4 -5
  657. package/dist/collection/components/mds-table-row/documentation.json +17 -8
  658. package/dist/collection/components/mds-table-row/mds-table-row.js +4 -3
  659. package/dist/collection/components/mds-table-row/pattern.md +5 -8
  660. package/dist/collection/components/mds-text/AGENTS.md +3 -3
  661. package/dist/collection/components/mds-text/antipattern.md +1 -2
  662. package/dist/collection/components/mds-text/documentation.json +17 -8
  663. package/dist/collection/components/mds-text/mds-text.css +3 -3
  664. package/dist/collection/components/mds-text/mds-text.js +2 -1
  665. package/dist/collection/components/mds-text/pattern.md +0 -11
  666. package/dist/collection/components/mds-toast/AGENTS.md +3 -3
  667. package/dist/collection/components/mds-toast/antipattern.md +2 -2
  668. package/dist/collection/components/mds-toast/documentation.json +19 -9
  669. package/dist/collection/components/mds-toast/mds-toast.css +4 -4
  670. package/dist/collection/components/mds-toast/mds-toast.js +2 -1
  671. package/dist/collection/components/mds-toast/pattern.md +2 -3
  672. package/dist/collection/components/mds-toast-region/AGENTS.md +1 -1
  673. package/dist/collection/components/mds-toast-region/documentation.json +7 -2
  674. package/dist/collection/components/mds-toast-region/mds-toast-region.css +1 -1
  675. package/dist/collection/components/mds-toast-region/mds-toast-region.js +2 -1
  676. package/dist/collection/components/mds-tooltip/AGENTS.md +3 -8
  677. package/dist/collection/components/mds-tooltip/antipattern.md +1 -1
  678. package/dist/collection/components/mds-tooltip/documentation.json +27 -13
  679. package/dist/collection/components/mds-tooltip/mds-tooltip.css +5 -5
  680. package/dist/collection/components/mds-tooltip/mds-tooltip.js +2 -1
  681. package/dist/collection/components/mds-tooltip/pattern.md +1 -3
  682. package/dist/collection/components/mds-tree/AGENTS.md +3 -28
  683. package/dist/collection/components/mds-tree/antipattern.md +3 -4
  684. package/dist/collection/components/mds-tree/documentation.json +63 -31
  685. package/dist/collection/components/mds-tree/mds-tree.css +1 -1
  686. package/dist/collection/components/mds-tree/mds-tree.js +2 -1
  687. package/dist/collection/components/mds-tree/pattern.md +3 -9
  688. package/dist/collection/components/mds-tree-item/AGENTS.md +2 -33
  689. package/dist/collection/components/mds-tree-item/antipattern.md +1 -5
  690. package/dist/collection/components/mds-tree-item/documentation.json +67 -33
  691. package/dist/collection/components/mds-tree-item/mds-tree-item.js +2 -1
  692. package/dist/collection/components/mds-tree-item/pattern.md +5 -10
  693. package/dist/collection/components/mds-url-view/AGENTS.md +3 -2
  694. package/dist/collection/components/mds-url-view/antipattern.md +1 -2
  695. package/dist/collection/components/mds-url-view/documentation.json +19 -9
  696. package/dist/collection/components/mds-url-view/mds-url-view.css +4 -4
  697. package/dist/collection/components/mds-url-view/mds-url-view.js +4 -1
  698. package/dist/collection/components/mds-url-view/pattern.md +1 -2
  699. package/dist/collection/components/mds-usage/AGENTS.md +2 -6
  700. package/dist/collection/components/mds-usage/antipattern.md +6 -4
  701. package/dist/collection/components/mds-usage/documentation.json +13 -6
  702. package/dist/collection/components/mds-usage/mds-usage.js +2 -1
  703. package/dist/collection/components/mds-usage/pattern.md +10 -6
  704. package/dist/collection/components/mds-video-wall/AGENTS.md +3 -4
  705. package/dist/collection/components/mds-video-wall/antipattern.md +5 -5
  706. package/dist/collection/components/mds-video-wall/documentation.json +15 -7
  707. package/dist/collection/components/mds-video-wall/mds-video-wall.css +1 -1
  708. package/dist/collection/components/mds-video-wall/mds-video-wall.js +2 -1
  709. package/dist/collection/components/mds-video-wall/pattern.md +2 -4
  710. package/dist/collection/components/mds-zero/AGENTS.md +1 -1
  711. package/dist/collection/components/mds-zero/antipattern.md +6 -6
  712. package/dist/collection/components/mds-zero/documentation.json +9 -4
  713. package/dist/collection/components/mds-zero/mds-zero.css +1 -1
  714. package/dist/collection/components/mds-zero/mds-zero.js +2 -1
  715. package/dist/collection/components/mds-zero/pattern.md +3 -3
  716. package/dist/components/index.d.ts +2 -0
  717. package/dist/components/index.js +1 -1
  718. package/dist/components/mds-accordion-item.js +1 -1
  719. package/dist/components/mds-accordion-timer-item.js +1 -1
  720. package/dist/components/mds-accordion-timer.js +1 -1
  721. package/dist/components/mds-accordion.js +1 -1
  722. package/dist/components/mds-author.js +1 -1
  723. package/dist/components/mds-avatar-stack-item.js +1 -1
  724. package/dist/components/mds-avatar-stack.js +1 -1
  725. package/dist/components/mds-avatar.js +1 -1
  726. package/dist/components/mds-badge.js +1 -1
  727. package/dist/components/mds-banner.js +1 -1
  728. package/dist/components/mds-benchmark-bar.js +1 -1
  729. package/dist/components/mds-bibliography.js +1 -1
  730. package/dist/components/mds-book.d.ts +11 -0
  731. package/dist/components/mds-book.js +1 -0
  732. package/dist/components/mds-breadcrumb-item.js +1 -1
  733. package/dist/components/mds-breadcrumb.js +1 -1
  734. package/dist/components/mds-button-dropdown.js +1 -1
  735. package/dist/components/mds-button-group.js +1 -1
  736. package/dist/components/mds-button.js +1 -1
  737. package/dist/components/mds-calendar-cell.js +1 -1
  738. package/dist/components/mds-calendar.js +1 -1
  739. package/dist/components/mds-card-content.js +1 -1
  740. package/dist/components/mds-card-footer.js +1 -1
  741. package/dist/components/mds-card-header.js +1 -1
  742. package/dist/components/mds-card-media.js +1 -1
  743. package/dist/components/mds-card.js +1 -1
  744. package/dist/components/mds-chip.js +1 -1
  745. package/dist/components/mds-details.js +1 -1
  746. package/dist/components/mds-dropdown.js +1 -1
  747. package/dist/components/mds-emoji.js +2 -2
  748. package/dist/components/mds-entity.js +1 -1
  749. package/dist/components/mds-file-preview.js +1 -1
  750. package/dist/components/mds-file.js +1 -1
  751. package/dist/components/mds-filter-item.js +1 -1
  752. package/dist/components/mds-filter.js +1 -1
  753. package/dist/components/mds-header-bar.js +1 -1
  754. package/dist/components/mds-header.js +1 -1
  755. package/dist/components/mds-help.js +1 -1
  756. package/dist/components/mds-horizontal-scroll.js +1 -1
  757. package/dist/components/mds-hr.js +1 -1
  758. package/dist/components/mds-icon.js +1 -1
  759. package/dist/components/mds-img.js +1 -1
  760. package/dist/components/mds-input-date-range-preselection.js +1 -1
  761. package/dist/components/mds-input-date-range.js +1 -1
  762. package/dist/components/mds-input-date.js +1 -1
  763. package/dist/components/mds-input-field.js +1 -1
  764. package/dist/components/mds-input-otp.js +1 -1
  765. package/dist/components/mds-input-range.js +1 -1
  766. package/dist/components/mds-input-select.js +1 -1
  767. package/dist/components/mds-input-switch.js +1 -1
  768. package/dist/components/mds-input-tip-item.js +1 -1
  769. package/dist/components/mds-input-tip.js +1 -1
  770. package/dist/components/mds-input-upload.js +1 -1
  771. package/dist/components/mds-input.js +1 -1
  772. package/dist/components/mds-keyboard-key.js +1 -1
  773. package/dist/components/mds-keyboard.js +1 -1
  774. package/dist/components/mds-kpi-item.js +1 -1
  775. package/dist/components/mds-kpi.js +1 -1
  776. package/dist/components/mds-label.js +1 -1
  777. package/dist/components/mds-link.js +1 -1
  778. package/dist/components/mds-list-item.js +1 -1
  779. package/dist/components/mds-list.js +1 -1
  780. package/dist/components/mds-mention.js +1 -1
  781. package/dist/components/mds-modal.js +1 -1
  782. package/dist/components/mds-note.js +1 -1
  783. package/dist/components/mds-notification.js +1 -1
  784. package/dist/components/mds-paginator-item.js +1 -1
  785. package/dist/components/mds-paginator.js +1 -1
  786. package/dist/components/mds-policy-ai.js +1 -1
  787. package/dist/components/mds-pref-animation.js +1 -1
  788. package/dist/components/mds-pref-consumption.js +1 -1
  789. package/dist/components/mds-pref-contrast.js +1 -1
  790. package/dist/components/mds-pref-language-item.js +1 -1
  791. package/dist/components/mds-pref-language.js +1 -1
  792. package/dist/components/mds-pref-mode.js +1 -1
  793. package/dist/components/mds-pref-theme-item.js +1 -1
  794. package/dist/components/mds-pref-theme.js +1 -1
  795. package/dist/components/mds-pref.js +1 -1
  796. package/dist/components/mds-price-table-features-cell.js +1 -1
  797. package/dist/components/mds-price-table-features-row.js +1 -1
  798. package/dist/components/mds-price-table-features.js +1 -1
  799. package/dist/components/mds-price-table-header.js +1 -1
  800. package/dist/components/mds-price-table-list-item.js +1 -1
  801. package/dist/components/mds-price-table-list.js +1 -1
  802. package/dist/components/mds-price-table.js +1 -1
  803. package/dist/components/mds-progress.js +1 -1
  804. package/dist/components/mds-push-notification-item.js +1 -1
  805. package/dist/components/mds-push-notification.js +1 -1
  806. package/dist/components/mds-quote.js +1 -1
  807. package/dist/components/mds-radial-menu-item.js +1 -1
  808. package/dist/components/mds-radial-menu.js +1 -1
  809. package/dist/components/mds-radial-progress.js +1 -1
  810. package/dist/components/mds-separator.js +1 -1
  811. package/dist/components/mds-spinner.js +1 -1
  812. package/dist/components/mds-status-bar.js +1 -1
  813. package/dist/components/mds-stepper-bar-item.js +1 -1
  814. package/dist/components/mds-stepper-bar.js +1 -1
  815. package/dist/components/mds-tab-bar-item.js +1 -1
  816. package/dist/components/mds-tab-bar.js +1 -1
  817. package/dist/components/mds-tab-item.js +1 -1
  818. package/dist/components/mds-tab.js +1 -1
  819. package/dist/components/mds-table-body.js +1 -1
  820. package/dist/components/mds-table-cell.js +1 -1
  821. package/dist/components/mds-table-footer.js +1 -1
  822. package/dist/components/mds-table-header-cell.js +1 -1
  823. package/dist/components/mds-table-header.js +1 -1
  824. package/dist/components/mds-table-row.js +1 -1
  825. package/dist/components/mds-table.js +1 -1
  826. package/dist/components/mds-text.js +1 -1
  827. package/dist/components/mds-toast-region.js +1 -1
  828. package/dist/components/mds-toast.js +1 -1
  829. package/dist/components/mds-tooltip.js +1 -1
  830. package/dist/components/mds-tree-item.js +1 -1
  831. package/dist/components/mds-tree.js +1 -1
  832. package/dist/components/mds-url-view.js +1 -1
  833. package/dist/components/mds-usage.js +1 -1
  834. package/dist/components/mds-video-wall.js +1 -1
  835. package/dist/components/mds-zero.js +1 -1
  836. package/dist/components/p-B8hgyXdE.js +1 -0
  837. package/dist/components/{p-DkUdrGHq.js → p-BBO_llcO.js} +1 -1
  838. package/dist/components/{p-nsbhb0lz.js → p-BM7joOdq.js} +1 -1
  839. package/dist/components/{p-DNeEn8Rr.js → p-BMIaZ4HY.js} +1 -1
  840. package/dist/components/{p-BwJQB6rG.js → p-BOJQ3tkp.js} +1 -1
  841. package/dist/components/{p-DCrdKrky.js → p-BU1O2DcC.js} +1 -1
  842. package/dist/components/{p-Cd8id3Br.js → p-Bo6ezD1p.js} +1 -1
  843. package/dist/components/p-C0H8bZpf.js +1 -0
  844. package/dist/components/{p-s1CktmPS.js → p-C1YH20BL.js} +1 -1
  845. package/dist/components/{p-Cmn1DJAB.js → p-CEw7GvM-.js} +1 -1
  846. package/dist/components/{p-D-DdDIb9.js → p-CNUWS_Mg.js} +1 -1
  847. package/dist/components/{p-uqwixjju.js → p-CNpL55c-.js} +1 -1
  848. package/dist/components/{p-DnySYX0L.js → p-CV7wjM1c.js} +1 -1
  849. package/dist/components/{p-BU3bsIX2.js → p-CWSIl1jl.js} +1 -1
  850. package/dist/components/{p-C99SMdU_.js → p-CYK2Xr_v.js} +1 -1
  851. package/dist/components/{p-B8x-d2fx.js → p-CZjwSwe5.js} +1 -1
  852. package/dist/components/p-Czqtt8kO.js +1 -0
  853. package/dist/components/{p-Dm-OUwDe.js → p-DD2muCqG.js} +1 -1
  854. package/dist/components/{p-ZuubAcA3.js → p-DDTJwlAd.js} +1 -1
  855. package/dist/components/{p-DF3PrYBI.js → p-DJ401QTd.js} +1 -1
  856. package/dist/components/{p-BbK4qeM7.js → p-DMyL4CYh.js} +1 -1
  857. package/dist/components/{p-DiUUZ7ZA.js → p-DTtmr_Y9.js} +1 -1
  858. package/dist/components/{p-CfQETwAK.js → p-DbVGGhs_.js} +1 -1
  859. package/dist/components/{p-C4XdTZQ-.js → p-DccBbfK8.js} +1 -1
  860. package/dist/components/{p-CNZ8_QvE.js → p-H0YXZ5fD.js} +2 -2
  861. package/dist/components/p-IaXq1Xsc.js +1 -0
  862. package/dist/components/{p-ClPv-Ljc.js → p-M8dGB4KH.js} +1 -1
  863. package/dist/components/{p-C1CTahjH.js → p-TNn_HE5x.js} +1 -1
  864. package/dist/components/{p-CNF3u0Li.js → p-aujz-VM9.js} +1 -1
  865. package/dist/components/{p-CSxW5f2f.js → p-e9NGNm7d.js} +1 -1
  866. package/dist/components/{p-D2d9eOLi.js → p-kZBPId_x.js} +1 -1
  867. package/dist/components/{p-CLe_N2_H.js → p-qnCVkeGX.js} +1 -1
  868. package/dist/documentation.json +2616 -921
  869. package/dist/esm/{index-D2_gI0qp.js → index-BJVvHlvf.js} +1 -1
  870. package/dist/esm/index-CvLLN-QH.js +4 -0
  871. package/dist/esm/loader.js +1 -1
  872. package/dist/esm/{locale-BQmO6K_S.js → locale-B6cOkl4I.js} +12 -6
  873. package/dist/esm/magma-components.js +1 -1
  874. package/dist/esm/mds-accordion-item.entry.js +1 -1
  875. package/dist/esm/mds-accordion-timer-item.entry.js +1 -1
  876. package/dist/esm/mds-accordion-timer.entry.js +1 -1
  877. package/dist/esm/mds-accordion.entry.js +1 -1
  878. package/dist/esm/mds-author.entry.js +1 -1
  879. package/dist/esm/mds-avatar-stack-item.entry.js +1 -1
  880. package/dist/esm/mds-avatar-stack.entry.js +1 -1
  881. package/dist/esm/mds-avatar.entry.js +1 -1
  882. package/dist/esm/mds-badge.entry.js +1 -1
  883. package/dist/esm/mds-banner_3.entry.js +4 -4
  884. package/dist/esm/mds-benchmark-bar.entry.js +1 -1
  885. package/dist/esm/mds-bibliography.entry.js +1 -1
  886. package/dist/esm/mds-book.entry.js +701 -0
  887. package/dist/esm/mds-breadcrumb-item.entry.js +1 -1
  888. package/dist/esm/mds-breadcrumb.entry.js +2 -2
  889. package/dist/esm/mds-button-dropdown.entry.js +2 -2
  890. package/dist/esm/mds-button-group.entry.js +1 -1
  891. package/dist/esm/mds-button_3.entry.js +6 -6
  892. package/dist/esm/mds-calendar_2.entry.js +7 -7
  893. package/dist/esm/mds-card-content.entry.js +1 -1
  894. package/dist/esm/mds-card-footer.entry.js +1 -1
  895. package/dist/esm/mds-card-header.entry.js +1 -1
  896. package/dist/esm/mds-card-media.entry.js +1 -1
  897. package/dist/esm/mds-card.entry.js +1 -1
  898. package/dist/esm/mds-details.entry.js +1 -1
  899. package/dist/esm/mds-dropdown.entry.js +2 -2
  900. package/dist/esm/mds-emoji.entry.js +2 -2
  901. package/dist/esm/mds-entity.entry.js +1 -1
  902. package/dist/esm/mds-file-preview.entry.js +3 -3
  903. package/dist/esm/mds-file.entry.js +2 -2
  904. package/dist/esm/mds-filter-item.entry.js +2 -2
  905. package/dist/esm/mds-filter.entry.js +2 -2
  906. package/dist/esm/mds-header-bar.entry.js +2 -2
  907. package/dist/esm/mds-header.entry.js +2 -2
  908. package/dist/esm/mds-horizontal-scroll.entry.js +2 -2
  909. package/dist/esm/mds-hr.entry.js +1 -1
  910. package/dist/esm/mds-img.entry.js +1 -1
  911. package/dist/esm/mds-input-date-range-preselection.entry.js +1 -1
  912. package/dist/esm/mds-input-date-range.entry.js +3 -3
  913. package/dist/esm/mds-input-date.entry.js +4 -4
  914. package/dist/esm/mds-input-field.entry.js +1 -1
  915. package/dist/esm/mds-input-otp.entry.js +2 -2
  916. package/dist/esm/mds-input-range.entry.js +2 -2
  917. package/dist/esm/mds-input-select.entry.js +9 -5
  918. package/dist/esm/mds-input-switch_2.entry.js +3 -3
  919. package/dist/esm/mds-input-tip_2.entry.js +4 -4
  920. package/dist/esm/mds-input-upload.entry.js +6 -6
  921. package/dist/esm/mds-input.entry.js +154 -37
  922. package/dist/esm/mds-keyboard-key.entry.js +3 -3
  923. package/dist/esm/mds-keyboard.entry.js +8 -4
  924. package/dist/esm/mds-kpi-item.entry.js +1 -1
  925. package/dist/esm/mds-kpi.entry.js +1 -1
  926. package/dist/esm/mds-label.entry.js +2 -2
  927. package/dist/esm/mds-link.entry.js +4 -4
  928. package/dist/esm/mds-list-item.entry.js +1 -1
  929. package/dist/esm/mds-list.entry.js +1 -1
  930. package/dist/esm/mds-mention.entry.js +2 -2
  931. package/dist/esm/mds-modal.entry.js +4 -4
  932. package/dist/esm/mds-note.entry.js +2 -2
  933. package/dist/esm/mds-notification.entry.js +1 -1
  934. package/dist/esm/mds-paginator-item.entry.js +1 -1
  935. package/dist/esm/mds-paginator.entry.js +2 -2
  936. package/dist/esm/mds-policy-ai.entry.js +2 -2
  937. package/dist/esm/mds-pref-animation.entry.js +2 -2
  938. package/dist/esm/mds-pref-consumption.entry.js +2 -2
  939. package/dist/esm/mds-pref-contrast.entry.js +2 -2
  940. package/dist/esm/mds-pref-language-item.entry.js +2 -2
  941. package/dist/esm/mds-pref-language.entry.js +2 -2
  942. package/dist/esm/mds-pref-mode.entry.js +2 -2
  943. package/dist/esm/mds-pref-theme-item.entry.js +1 -1
  944. package/dist/esm/mds-pref-theme.entry.js +2 -2
  945. package/dist/esm/mds-pref.entry.js +2 -2
  946. package/dist/esm/mds-price-table-features-cell.entry.js +1 -1
  947. package/dist/esm/mds-price-table-features-row.entry.js +1 -1
  948. package/dist/esm/mds-price-table-features.entry.js +1 -1
  949. package/dist/esm/mds-price-table-header.entry.js +1 -1
  950. package/dist/esm/mds-price-table-list-item.entry.js +1 -1
  951. package/dist/esm/mds-price-table-list.entry.js +1 -1
  952. package/dist/esm/mds-price-table.entry.js +1 -1
  953. package/dist/esm/mds-progress_2.entry.js +2 -2
  954. package/dist/esm/mds-push-notification-item.entry.js +3 -3
  955. package/dist/esm/mds-push-notification.entry.js +3 -3
  956. package/dist/esm/mds-quote.entry.js +1 -1
  957. package/dist/esm/mds-radial-menu-item.entry.js +1 -1
  958. package/dist/esm/mds-radial-menu.entry.js +2 -2
  959. package/dist/esm/mds-separator.entry.js +1 -1
  960. package/dist/esm/mds-status-bar.entry.js +2 -2
  961. package/dist/esm/mds-stepper-bar-item.entry.js +7 -5
  962. package/dist/esm/mds-stepper-bar.entry.js +1 -1
  963. package/dist/esm/mds-tab-bar-item.entry.js +1 -1
  964. package/dist/esm/mds-tab-bar.entry.js +1 -1
  965. package/dist/esm/mds-tab_2.entry.js +4 -4
  966. package/dist/esm/mds-table-body.entry.js +1 -1
  967. package/dist/esm/mds-table-footer.entry.js +1 -1
  968. package/dist/esm/mds-table-header-cell.entry.js +1 -1
  969. package/dist/esm/mds-table-header.entry.js +2 -2
  970. package/dist/esm/mds-table-row.entry.js +3 -3
  971. package/dist/esm/mds-table.entry.js +2 -2
  972. package/dist/esm/mds-text.entry.js +1 -1
  973. package/dist/esm/mds-toast-region.entry.js +1 -1
  974. package/dist/esm/mds-toast.entry.js +2 -2
  975. package/dist/esm/mds-tooltip.entry.js +2 -2
  976. package/dist/esm/mds-tree-item.entry.js +2 -2
  977. package/dist/esm/mds-tree.entry.js +1 -1
  978. package/dist/esm/mds-url-view.entry.js +2 -2
  979. package/dist/esm/mds-usage.entry.js +2 -2
  980. package/dist/esm/mds-video-wall.entry.js +1 -1
  981. package/dist/esm/mds-zero.entry.js +1 -1
  982. package/dist/esm-es5/{index-D2_gI0qp.js → index-BJVvHlvf.js} +1 -1
  983. package/dist/esm-es5/index-CvLLN-QH.js +8 -6
  984. package/dist/esm-es5/loader.js +1 -1
  985. package/dist/esm-es5/{locale-BQmO6K_S.js → locale-B6cOkl4I.js} +22 -18
  986. package/dist/esm-es5/magma-components.js +2 -2
  987. package/dist/esm-es5/mds-accordion-item.entry.js +1 -1
  988. package/dist/esm-es5/mds-accordion-timer-item.entry.js +1 -1
  989. package/dist/esm-es5/mds-accordion-timer.entry.js +1 -1
  990. package/dist/esm-es5/mds-accordion.entry.js +2 -2
  991. package/dist/esm-es5/mds-author.entry.js +1 -1
  992. package/dist/esm-es5/mds-avatar-stack-item.entry.js +1 -1
  993. package/dist/esm-es5/mds-avatar-stack.entry.js +1 -1
  994. package/dist/esm-es5/mds-avatar.entry.js +5 -5
  995. package/dist/esm-es5/mds-badge.entry.js +1 -1
  996. package/dist/esm-es5/mds-banner_3.entry.js +4 -4
  997. package/dist/esm-es5/mds-benchmark-bar.entry.js +3 -3
  998. package/dist/esm-es5/mds-bibliography.entry.js +2 -2
  999. package/dist/esm-es5/mds-book.entry.js +207 -0
  1000. package/dist/esm-es5/mds-breadcrumb-item.entry.js +1 -1
  1001. package/dist/esm-es5/mds-breadcrumb.entry.js +4 -4
  1002. package/dist/esm-es5/mds-button-dropdown.entry.js +2 -2
  1003. package/dist/esm-es5/mds-button-group.entry.js +1 -1
  1004. package/dist/esm-es5/mds-button_3.entry.js +5 -5
  1005. package/dist/esm-es5/mds-calendar_2.entry.js +4 -4
  1006. package/dist/esm-es5/mds-card-content.entry.js +1 -1
  1007. package/dist/esm-es5/mds-card-footer.entry.js +1 -1
  1008. package/dist/esm-es5/mds-card-header.entry.js +1 -1
  1009. package/dist/esm-es5/mds-card-media.entry.js +1 -1
  1010. package/dist/esm-es5/mds-card.entry.js +1 -1
  1011. package/dist/esm-es5/mds-details.entry.js +1 -1
  1012. package/dist/esm-es5/mds-dropdown.entry.js +1 -1
  1013. package/dist/esm-es5/mds-emoji.entry.js +2 -2
  1014. package/dist/esm-es5/mds-entity.entry.js +1 -1
  1015. package/dist/esm-es5/mds-file-preview.entry.js +8 -8
  1016. package/dist/esm-es5/mds-file.entry.js +2 -2
  1017. package/dist/esm-es5/mds-filter-item.entry.js +2 -2
  1018. package/dist/esm-es5/mds-filter.entry.js +2 -2
  1019. package/dist/esm-es5/mds-header-bar.entry.js +2 -2
  1020. package/dist/esm-es5/mds-header.entry.js +2 -2
  1021. package/dist/esm-es5/mds-horizontal-scroll.entry.js +2 -2
  1022. package/dist/esm-es5/mds-hr.entry.js +1 -1
  1023. package/dist/esm-es5/mds-img.entry.js +1 -1
  1024. package/dist/esm-es5/mds-input-date-range-preselection.entry.js +1 -1
  1025. package/dist/esm-es5/mds-input-date-range.entry.js +3 -3
  1026. package/dist/esm-es5/mds-input-date.entry.js +3 -3
  1027. package/dist/esm-es5/mds-input-field.entry.js +1 -1
  1028. package/dist/esm-es5/mds-input-otp.entry.js +2 -2
  1029. package/dist/esm-es5/mds-input-range.entry.js +7 -7
  1030. package/dist/esm-es5/mds-input-select.entry.js +5 -4
  1031. package/dist/esm-es5/mds-input-switch_2.entry.js +2 -2
  1032. package/dist/esm-es5/mds-input-tip_2.entry.js +3 -3
  1033. package/dist/esm-es5/mds-input-upload.entry.js +2 -2
  1034. package/dist/esm-es5/mds-input.entry.js +53 -50
  1035. package/dist/esm-es5/mds-keyboard-key.entry.js +2 -2
  1036. package/dist/esm-es5/mds-keyboard.entry.js +6 -3
  1037. package/dist/esm-es5/mds-kpi-item.entry.js +3 -3
  1038. package/dist/esm-es5/mds-kpi.entry.js +1 -1
  1039. package/dist/esm-es5/mds-label.entry.js +2 -2
  1040. package/dist/esm-es5/mds-link.entry.js +2 -2
  1041. package/dist/esm-es5/mds-list-item.entry.js +1 -1
  1042. package/dist/esm-es5/mds-list.entry.js +1 -1
  1043. package/dist/esm-es5/mds-mention.entry.js +2 -2
  1044. package/dist/esm-es5/mds-modal.entry.js +2 -2
  1045. package/dist/esm-es5/mds-note.entry.js +2 -2
  1046. package/dist/esm-es5/mds-notification.entry.js +1 -1
  1047. package/dist/esm-es5/mds-paginator-item.entry.js +1 -1
  1048. package/dist/esm-es5/mds-paginator.entry.js +3 -3
  1049. package/dist/esm-es5/mds-policy-ai.entry.js +2 -2
  1050. package/dist/esm-es5/mds-pref-animation.entry.js +2 -2
  1051. package/dist/esm-es5/mds-pref-consumption.entry.js +2 -2
  1052. package/dist/esm-es5/mds-pref-contrast.entry.js +2 -2
  1053. package/dist/esm-es5/mds-pref-language-item.entry.js +2 -2
  1054. package/dist/esm-es5/mds-pref-language.entry.js +2 -2
  1055. package/dist/esm-es5/mds-pref-mode.entry.js +2 -2
  1056. package/dist/esm-es5/mds-pref-theme-item.entry.js +3 -3
  1057. package/dist/esm-es5/mds-pref-theme.entry.js +6 -6
  1058. package/dist/esm-es5/mds-pref.entry.js +2 -2
  1059. package/dist/esm-es5/mds-price-table-features-cell.entry.js +1 -1
  1060. package/dist/esm-es5/mds-price-table-features-row.entry.js +1 -1
  1061. package/dist/esm-es5/mds-price-table-features.entry.js +1 -1
  1062. package/dist/esm-es5/mds-price-table-header.entry.js +1 -1
  1063. package/dist/esm-es5/mds-price-table-list-item.entry.js +1 -1
  1064. package/dist/esm-es5/mds-price-table-list.entry.js +1 -1
  1065. package/dist/esm-es5/mds-price-table.entry.js +1 -1
  1066. package/dist/esm-es5/mds-progress_2.entry.js +2 -2
  1067. package/dist/esm-es5/mds-push-notification-item.entry.js +2 -2
  1068. package/dist/esm-es5/mds-push-notification.entry.js +2 -2
  1069. package/dist/esm-es5/mds-quote.entry.js +1 -1
  1070. package/dist/esm-es5/mds-radial-menu-item.entry.js +1 -1
  1071. package/dist/esm-es5/mds-radial-menu.entry.js +2 -2
  1072. package/dist/esm-es5/mds-separator.entry.js +1 -1
  1073. package/dist/esm-es5/mds-status-bar.entry.js +2 -2
  1074. package/dist/esm-es5/mds-stepper-bar-item.entry.js +6 -3
  1075. package/dist/esm-es5/mds-stepper-bar.entry.js +1 -1
  1076. package/dist/esm-es5/mds-tab-bar-item.entry.js +1 -1
  1077. package/dist/esm-es5/mds-tab-bar.entry.js +1 -1
  1078. package/dist/esm-es5/mds-tab_2.entry.js +3 -3
  1079. package/dist/esm-es5/mds-table-body.entry.js +1 -1
  1080. package/dist/esm-es5/mds-table-footer.entry.js +1 -1
  1081. package/dist/esm-es5/mds-table-header-cell.entry.js +1 -1
  1082. package/dist/esm-es5/mds-table-header.entry.js +4 -4
  1083. package/dist/esm-es5/mds-table-row.entry.js +2 -2
  1084. package/dist/esm-es5/mds-table.entry.js +2 -2
  1085. package/dist/esm-es5/mds-text.entry.js +1 -1
  1086. package/dist/esm-es5/mds-toast-region.entry.js +1 -1
  1087. package/dist/esm-es5/mds-toast.entry.js +2 -2
  1088. package/dist/esm-es5/mds-tooltip.entry.js +2 -2
  1089. package/dist/esm-es5/mds-tree-item.entry.js +2 -2
  1090. package/dist/esm-es5/mds-tree.entry.js +1 -1
  1091. package/dist/esm-es5/mds-url-view.entry.js +2 -2
  1092. package/dist/esm-es5/mds-usage.entry.js +2 -2
  1093. package/dist/esm-es5/mds-video-wall.entry.js +1 -1
  1094. package/dist/esm-es5/mds-zero.entry.js +1 -1
  1095. package/dist/hydrate/index.js +1228 -207
  1096. package/dist/hydrate/index.mjs +1228 -207
  1097. package/dist/lint/core/checks.d.ts +26 -0
  1098. package/dist/lint/core/checks.js +135 -0
  1099. package/dist/lint/core/colors.d.ts +2 -0
  1100. package/dist/lint/core/colors.js +40 -0
  1101. package/dist/lint/core/data.d.ts +82 -0
  1102. package/dist/lint/core/data.js +171 -0
  1103. package/dist/lint/core/element.d.ts +55 -0
  1104. package/dist/lint/core/element.js +19 -0
  1105. package/dist/lint/eslint/adapters.d.ts +53 -0
  1106. package/dist/lint/eslint/adapters.js +217 -0
  1107. package/dist/lint/eslint/index.d.ts +7 -0
  1108. package/dist/lint/eslint/index.js +86 -0
  1109. package/dist/lint/index.d.ts +4 -0
  1110. package/dist/lint/index.js +10 -0
  1111. package/dist/lint/mcp/checks.d.ts +15 -0
  1112. package/dist/lint/mcp/checks.js +407 -0
  1113. package/dist/lint/mcp/cli.d.ts +2 -0
  1114. package/dist/lint/mcp/cli.js +29 -0
  1115. package/dist/lint/mcp/color.d.ts +12 -0
  1116. package/dist/lint/mcp/color.js +87 -0
  1117. package/dist/lint/mcp/components.d.ts +5 -0
  1118. package/dist/lint/mcp/components.js +362 -0
  1119. package/dist/lint/mcp/context.d.ts +25 -0
  1120. package/dist/lint/mcp/context.js +87 -0
  1121. package/dist/lint/mcp/guides.d.ts +3 -0
  1122. package/dist/lint/mcp/guides.js +137 -0
  1123. package/dist/lint/mcp/icon.svg +11 -0
  1124. package/dist/lint/mcp/icons.d.ts +3 -0
  1125. package/dist/lint/mcp/icons.js +170 -0
  1126. package/dist/lint/mcp/protocol.d.ts +42 -0
  1127. package/dist/lint/mcp/protocol.js +106 -0
  1128. package/dist/lint/mcp/server.d.ts +20 -0
  1129. package/dist/lint/mcp/server.js +67 -0
  1130. package/dist/lint/mcp/tokens.d.ts +22 -0
  1131. package/dist/lint/mcp/tokens.js +507 -0
  1132. package/dist/lint/package.json +3 -0
  1133. package/dist/lint/stylelint/index.d.ts +3 -0
  1134. package/dist/lint/stylelint/index.js +137 -0
  1135. package/dist/lint/stylelint/recommended.d.ts +3 -0
  1136. package/dist/lint/stylelint/recommended.js +10 -0
  1137. package/dist/lint/stylelint/strict.d.ts +3 -0
  1138. package/dist/lint/stylelint/strict.js +10 -0
  1139. package/dist/magma-components/magma-components.esm.js +1 -1
  1140. package/dist/magma-components/{p-26451eb6.entry.js → p-00aa9a51.entry.js} +1 -1
  1141. package/dist/magma-components/{p-5533b60d.system.entry.js → p-00acb2e1.system.entry.js} +3 -3
  1142. package/dist/magma-components/{p-4bc3335f.system.entry.js → p-037126b7.system.entry.js} +1 -1
  1143. package/dist/magma-components/{p-e5d41024.system.entry.js → p-03da0376.system.entry.js} +1 -1
  1144. package/dist/magma-components/{p-25a6e977.entry.js → p-0417391b.entry.js} +1 -1
  1145. package/dist/magma-components/{p-377d0661.entry.js → p-05ef91a5.entry.js} +1 -1
  1146. package/dist/magma-components/{p-336f56a4.entry.js → p-07d35da6.entry.js} +1 -1
  1147. package/dist/magma-components/{p-f4d80d9a.entry.js → p-09c80fdb.entry.js} +1 -1
  1148. package/dist/magma-components/{p-5cfa0dce.entry.js → p-0b0ca53c.entry.js} +1 -1
  1149. package/dist/magma-components/{p-617370e7.system.entry.js → p-0babf674.system.entry.js} +7 -7
  1150. package/dist/magma-components/{p-29162c98.entry.js → p-0d90c991.entry.js} +1 -1
  1151. package/dist/magma-components/{p-9745dc51.entry.js → p-103465cf.entry.js} +1 -1
  1152. package/dist/magma-components/{p-919f9dce.entry.js → p-10983da0.entry.js} +1 -1
  1153. package/dist/magma-components/{p-52d905fe.system.entry.js → p-109926ce.system.entry.js} +2 -2
  1154. package/dist/magma-components/{p-70d38284.entry.js → p-14b13850.entry.js} +1 -1
  1155. package/dist/magma-components/{p-bf0cb77d.system.entry.js → p-154ba354.system.entry.js} +2 -2
  1156. package/dist/magma-components/{p-73833405.entry.js → p-160cd923.entry.js} +1 -1
  1157. package/dist/magma-components/{p-5ef0fb69.system.entry.js → p-1685e74c.system.entry.js} +1 -1
  1158. package/dist/magma-components/p-1748ca8b.system.entry.js +1 -0
  1159. package/dist/magma-components/{p-729c89f9.system.entry.js → p-17a43cb6.system.entry.js} +2 -2
  1160. package/dist/magma-components/p-17ccfc01.system.entry.js +208 -0
  1161. package/dist/magma-components/{p-f670ed20.entry.js → p-198ea5d8.entry.js} +1 -1
  1162. package/dist/magma-components/{p-d561062f.system.entry.js → p-1b415625.system.entry.js} +3 -3
  1163. package/dist/magma-components/{p-4bc47ff0.system.entry.js → p-1b67b149.system.entry.js} +2 -2
  1164. package/dist/magma-components/p-1c00d0f7.entry.js +1 -0
  1165. package/dist/magma-components/{p-05ed801b.system.entry.js → p-1cd75adf.system.entry.js} +3 -3
  1166. package/dist/magma-components/{p-244676d3.system.entry.js → p-1d8485de.system.entry.js} +4 -4
  1167. package/dist/magma-components/{p-23c057a9.entry.js → p-2006cfeb.entry.js} +1 -1
  1168. package/dist/magma-components/{p-02fe26b4.system.entry.js → p-2216f207.system.entry.js} +2 -2
  1169. package/dist/magma-components/{p-edf003f1.system.entry.js → p-22f24125.system.entry.js} +1 -1
  1170. package/dist/magma-components/{p-6560b426.system.entry.js → p-25c07b67.system.entry.js} +1 -1
  1171. package/dist/magma-components/{p-e3a65644.entry.js → p-29fbb7cf.entry.js} +1 -1
  1172. package/dist/magma-components/{p-f7147d05.entry.js → p-2a26b614.entry.js} +1 -1
  1173. package/dist/magma-components/p-2a6c2a41.entry.js +1 -0
  1174. package/dist/magma-components/{p-06fde29d.entry.js → p-2c28056d.entry.js} +1 -1
  1175. package/dist/magma-components/{p-23722401.entry.js → p-2c5e5cd1.entry.js} +1 -1
  1176. package/dist/magma-components/{p-d92ccce5.system.entry.js → p-2c7d091e.system.entry.js} +3 -3
  1177. package/dist/magma-components/{p-3abaa053.entry.js → p-2c997b47.entry.js} +1 -1
  1178. package/dist/magma-components/{p-0a8e8525.entry.js → p-2f39f4e4.entry.js} +1 -1
  1179. package/dist/magma-components/{p-02298ed0.system.entry.js → p-31370fdb.system.entry.js} +1 -1
  1180. package/dist/magma-components/{p-3df07021.system.entry.js → p-3139988c.system.entry.js} +1 -1
  1181. package/dist/magma-components/p-32418266.entry.js +1 -0
  1182. package/dist/magma-components/{p-cc9659e1.system.entry.js → p-33c80de3.system.entry.js} +1 -1
  1183. package/dist/magma-components/{p-09a7b578.system.entry.js → p-34c0e63c.system.entry.js} +1 -1
  1184. package/dist/magma-components/{p-ca1969c5.entry.js → p-354a5b47.entry.js} +1 -1
  1185. package/dist/magma-components/{p-81e02997.system.entry.js → p-35c6341a.system.entry.js} +3 -3
  1186. package/dist/magma-components/{p-b476435f.entry.js → p-379f51a6.entry.js} +1 -1
  1187. package/dist/magma-components/{p-7c217aa5.entry.js → p-381f49ea.entry.js} +1 -1
  1188. package/dist/magma-components/{p-221c2f0d.entry.js → p-384ab014.entry.js} +1 -1
  1189. package/dist/magma-components/{p-29ab84bf.system.entry.js → p-386bb24e.system.entry.js} +4 -4
  1190. package/dist/magma-components/{p-1e18fcc5.system.entry.js → p-39a2df98.system.entry.js} +1 -1
  1191. package/dist/magma-components/{p-5c4e41d3.system.entry.js → p-3a7c4314.system.entry.js} +3 -3
  1192. package/dist/magma-components/{p-e5950aee.entry.js → p-3a9a75e5.entry.js} +1 -1
  1193. package/dist/magma-components/{p-5435f2a9.entry.js → p-3b691cc3.entry.js} +1 -1
  1194. package/dist/magma-components/{p-3fd8ff0e.system.entry.js → p-3bdb541f.system.entry.js} +2 -2
  1195. package/dist/magma-components/{p-dbd34e3b.entry.js → p-3ca004c3.entry.js} +1 -1
  1196. package/dist/magma-components/{p-4776ac1f.entry.js → p-3caf6a26.entry.js} +1 -1
  1197. package/dist/magma-components/{p-1faa4f71.entry.js → p-3dccd446.entry.js} +1 -1
  1198. package/dist/magma-components/{p-396d95a1.system.entry.js → p-3dde41b0.system.entry.js} +3 -3
  1199. package/dist/magma-components/{p-6f81c9ef.system.entry.js → p-3e8e0003.system.entry.js} +2 -2
  1200. package/dist/magma-components/{p-21547758.system.entry.js → p-3f0e6729.system.entry.js} +3 -3
  1201. package/dist/magma-components/{p-481897a7.entry.js → p-42ab27de.entry.js} +1 -1
  1202. package/dist/magma-components/{p-80eea067.system.entry.js → p-430a4c4b.system.entry.js} +2 -2
  1203. package/dist/magma-components/{p-d48c40ab.system.entry.js → p-47b05fa1.system.entry.js} +1 -1
  1204. package/dist/magma-components/{p-e5eb2390.entry.js → p-47db3155.entry.js} +1 -1
  1205. package/dist/magma-components/{p-2c845743.system.entry.js → p-48f86057.system.entry.js} +1 -1
  1206. package/dist/magma-components/{p-7961c335.system.entry.js → p-4a72d72c.system.entry.js} +1 -1
  1207. package/dist/magma-components/{p-2d3b5eb5.entry.js → p-4aa94380.entry.js} +1 -1
  1208. package/dist/magma-components/{p-ab00b7b9.entry.js → p-4ab2eb7e.entry.js} +1 -1
  1209. package/dist/magma-components/{p-c3c487aa.system.entry.js → p-4bea91e1.system.entry.js} +1 -1
  1210. package/dist/magma-components/{p-f588cf9e.entry.js → p-4cd21f19.entry.js} +1 -1
  1211. package/dist/magma-components/{p-287601bb.entry.js → p-4de89d1b.entry.js} +1 -1
  1212. package/dist/magma-components/{p-23fabd66.system.entry.js → p-50c8f36c.system.entry.js} +1 -1
  1213. package/dist/magma-components/{p-d0bfdb44.system.entry.js → p-5200ab23.system.entry.js} +2 -2
  1214. package/dist/magma-components/{p-f35608b2.entry.js → p-52211fa3.entry.js} +1 -1
  1215. package/dist/magma-components/{p-74f515c3.system.entry.js → p-53981624.system.entry.js} +2 -2
  1216. package/dist/magma-components/p-53acdc6b.entry.js +1 -0
  1217. package/dist/magma-components/p-5660182a.system.entry.js +1 -0
  1218. package/dist/magma-components/{p-464e6431.entry.js → p-56c5ca6f.entry.js} +1 -1
  1219. package/dist/magma-components/p-57e92942.system.entry.js +20 -0
  1220. package/dist/magma-components/{p-63b10a6e.entry.js → p-59aa4994.entry.js} +1 -1
  1221. package/dist/magma-components/{p-9a3ddc91.entry.js → p-59f06b9c.entry.js} +1 -1
  1222. package/dist/magma-components/{p-3d95e688.system.entry.js → p-5aa78075.system.entry.js} +3 -3
  1223. package/dist/magma-components/p-5cf87a7f.entry.js +1 -0
  1224. package/dist/magma-components/{p-5da14e81.entry.js → p-5e8df58d.entry.js} +1 -1
  1225. package/dist/magma-components/{p-880f3eac.system.entry.js → p-5ed74216.system.entry.js} +1 -1
  1226. package/dist/magma-components/{p-84777b38.system.entry.js → p-5f064376.system.entry.js} +2 -2
  1227. package/dist/magma-components/{p-8173ed07.entry.js → p-60727165.entry.js} +2 -2
  1228. package/dist/magma-components/{p-278c362d.entry.js → p-6093aa8e.entry.js} +1 -1
  1229. package/dist/magma-components/{p-29450db3.entry.js → p-62d9eaca.entry.js} +1 -1
  1230. package/dist/magma-components/{p-4c6da1db.system.entry.js → p-6b402a09.system.entry.js} +9 -9
  1231. package/dist/magma-components/p-6b55c5fe.system.entry.js +1 -0
  1232. package/dist/magma-components/{p-3d162e99.system.entry.js → p-6d57674c.system.entry.js} +2 -2
  1233. package/dist/magma-components/p-6d96d223.entry.js +1 -0
  1234. package/dist/magma-components/{p-47717251.system.entry.js → p-6df26141.system.entry.js} +4 -4
  1235. package/dist/magma-components/{p-5f8db04c.system.entry.js → p-6df7da52.system.entry.js} +1 -1
  1236. package/dist/magma-components/{p-9250ec26.system.entry.js → p-6e751bcc.system.entry.js} +2 -2
  1237. package/dist/magma-components/{p-656b00df.system.entry.js → p-718d6384.system.entry.js} +8 -8
  1238. package/dist/magma-components/{p-8279056b.system.entry.js → p-71dab494.system.entry.js} +3 -3
  1239. package/dist/magma-components/{p-b5789a7c.entry.js → p-732d09b6.entry.js} +1 -1
  1240. package/dist/magma-components/{p-fac6f123.entry.js → p-73f4f67e.entry.js} +1 -1
  1241. package/dist/magma-components/{p-772c18f4.entry.js → p-785fa112.entry.js} +1 -1
  1242. package/dist/magma-components/{p-26b9f2b7.system.entry.js → p-79fd07e7.system.entry.js} +2 -2
  1243. package/dist/magma-components/{p-0033cb92.system.entry.js → p-7acbc6ea.system.entry.js} +1 -1
  1244. package/dist/magma-components/{p-67eb3881.entry.js → p-7dd0364b.entry.js} +1 -1
  1245. package/dist/magma-components/{p-cbb80188.entry.js → p-7e7391fd.entry.js} +1 -1
  1246. package/dist/magma-components/{p-f889d413.system.entry.js → p-7ec28ff1.system.entry.js} +2 -2
  1247. package/dist/magma-components/{p-71cbc840.entry.js → p-7f74ec99.entry.js} +1 -1
  1248. package/dist/magma-components/{p-0679c988.system.entry.js → p-7ffce9e8.system.entry.js} +1 -1
  1249. package/dist/magma-components/{p-06ccc40d.entry.js → p-81212e34.entry.js} +1 -1
  1250. package/dist/magma-components/{p-cf6f54e5.system.entry.js → p-8219e58f.system.entry.js} +2 -2
  1251. package/dist/magma-components/{p-860bce85.system.entry.js → p-84711ab6.system.entry.js} +3 -3
  1252. package/dist/magma-components/p-84bf333b.entry.js +1 -0
  1253. package/dist/magma-components/{p-4792ff7f.entry.js → p-84d0d701.entry.js} +1 -1
  1254. package/dist/magma-components/{p-30be5c39.entry.js → p-857ae762.entry.js} +1 -1
  1255. package/dist/magma-components/{p-8f63f1a1.system.entry.js → p-87395a4d.system.entry.js} +1 -1
  1256. package/dist/magma-components/{p-2431fbfa.system.entry.js → p-87831da2.system.entry.js} +1 -1
  1257. package/dist/magma-components/{p-e39518b4.system.entry.js → p-896310aa.system.entry.js} +2 -2
  1258. package/dist/magma-components/{p-dc1a5826.system.entry.js → p-8ac1ba5c.system.entry.js} +1 -1
  1259. package/dist/magma-components/{p-86cf87fb.entry.js → p-8b8a6662.entry.js} +1 -1
  1260. package/dist/magma-components/{p-62fc9695.entry.js → p-8d7093af.entry.js} +1 -1
  1261. package/dist/magma-components/{p-8ab9ff37.system.entry.js → p-8e15c151.system.entry.js} +1 -1
  1262. package/dist/magma-components/{p-a9ba496d.entry.js → p-8f1c529f.entry.js} +1 -1
  1263. package/dist/magma-components/{p-94289f3d.system.entry.js → p-8f1e9021.system.entry.js} +5 -5
  1264. package/dist/magma-components/{p-69abd1d1.entry.js → p-904c1222.entry.js} +1 -1
  1265. package/dist/magma-components/{p-a70fb4fb.system.entry.js → p-907f06cd.system.entry.js} +9 -9
  1266. package/dist/magma-components/{p-000c315c.entry.js → p-9332358d.entry.js} +1 -1
  1267. package/dist/magma-components/{p-2eb4efcd.system.entry.js → p-93b9d39d.system.entry.js} +2 -2
  1268. package/dist/magma-components/{p-d8ae0f02.system.entry.js → p-965e7a82.system.entry.js} +1 -1
  1269. package/dist/magma-components/{p-c50e20cf.system.entry.js → p-96dfb60e.system.entry.js} +1 -1
  1270. package/dist/magma-components/{p-835d79e5.system.entry.js → p-99bfa07e.system.entry.js} +1 -1
  1271. package/dist/magma-components/{p-3beea731.system.entry.js → p-9c408768.system.entry.js} +1 -1
  1272. package/dist/magma-components/{p-1d2220f0.system.entry.js → p-9e792bed.system.entry.js} +1 -1
  1273. package/dist/magma-components/{p-8258733b.entry.js → p-9fdd477a.entry.js} +1 -1
  1274. package/dist/magma-components/{p-f82c2b7e.system.entry.js → p-9fefa077.system.entry.js} +1 -1
  1275. package/dist/magma-components/p-B8zYiZQY.system.js +2 -2
  1276. package/dist/magma-components/{p-OOCOFWC0.system.js → p-CuHZXISO.system.js} +7 -3
  1277. package/dist/magma-components/{p-DXAjcaHM.system.js → p-CxTugGM9.system.js} +1 -1
  1278. package/dist/magma-components/{p-U5iXN1wy.js → p-Dx_cCOTw.js} +1 -1
  1279. package/dist/magma-components/{p-Raj-urIN.js → p-OafT80hV.js} +1 -1
  1280. package/dist/magma-components/{p-458eb34c.system.entry.js → p-a0d637b6.system.entry.js} +2 -2
  1281. package/dist/magma-components/p-a26c05b6.entry.js +1 -0
  1282. package/dist/magma-components/{p-ccc40c6a.system.entry.js → p-a7baf451.system.entry.js} +2 -2
  1283. package/dist/magma-components/p-ac9feb04.entry.js +1 -0
  1284. package/dist/magma-components/p-ad383f92.entry.js +1 -0
  1285. package/dist/magma-components/{p-42e50f25.system.entry.js → p-ae4736a0.system.entry.js} +4 -4
  1286. package/dist/magma-components/{p-9fc385aa.entry.js → p-b3332c5f.entry.js} +1 -1
  1287. package/dist/magma-components/{p-d37fe692.system.entry.js → p-b3e2b68a.system.entry.js} +2 -2
  1288. package/dist/magma-components/{p-808b9277.entry.js → p-b86144d4.entry.js} +1 -1
  1289. package/dist/magma-components/{p-2cbd532a.system.entry.js → p-bbde5701.system.entry.js} +2 -2
  1290. package/dist/magma-components/{p-577ae081.system.entry.js → p-bc075b3b.system.entry.js} +2 -2
  1291. package/dist/magma-components/{p-068e30a5.entry.js → p-bc19b136.entry.js} +1 -1
  1292. package/dist/magma-components/{p-254ee71d.entry.js → p-bcca26d9.entry.js} +1 -1
  1293. package/dist/magma-components/{p-fc2d1134.entry.js → p-bf35627d.entry.js} +1 -1
  1294. package/dist/magma-components/p-bfd95736.entry.js +1 -0
  1295. package/dist/magma-components/{p-6a2d67d1.system.entry.js → p-c086a5a4.system.entry.js} +1 -1
  1296. package/dist/magma-components/{p-41a0f896.entry.js → p-c27206ca.entry.js} +1 -1
  1297. package/dist/magma-components/{p-762a6b7b.entry.js → p-c2758b81.entry.js} +1 -1
  1298. package/dist/magma-components/{p-a76a9f92.system.entry.js → p-c2c693ed.system.entry.js} +2 -2
  1299. package/dist/magma-components/{p-642925b7.system.entry.js → p-c4a5ab6e.system.entry.js} +1 -1
  1300. package/dist/magma-components/{p-b23bee0c.entry.js → p-c58157cf.entry.js} +1 -1
  1301. package/dist/magma-components/{p-8a9544aa.entry.js → p-c597ad47.entry.js} +1 -1
  1302. package/dist/magma-components/{p-295d8fab.entry.js → p-c7b2ebb5.entry.js} +1 -1
  1303. package/dist/magma-components/{p-ae3bf24c.system.entry.js → p-c8b06821.system.entry.js} +2 -2
  1304. package/dist/magma-components/p-ca1143bc.entry.js +1 -0
  1305. package/dist/magma-components/p-cb88fa71.entry.js +1 -0
  1306. package/dist/magma-components/{p-471227f2.system.entry.js → p-cd783f9e.system.entry.js} +2 -2
  1307. package/dist/magma-components/{p-bd97e368.system.entry.js → p-cd955bc7.system.entry.js} +1 -1
  1308. package/dist/magma-components/{p-1f623b75.entry.js → p-ce42e251.entry.js} +1 -1
  1309. package/dist/magma-components/{p-7bf46d43.entry.js → p-cf4f4561.entry.js} +1 -1
  1310. package/dist/magma-components/{p-0d32e196.system.entry.js → p-d0a15a3a.system.entry.js} +5 -4
  1311. package/dist/magma-components/{p-96bb36b9.entry.js → p-d218ae47.entry.js} +1 -1
  1312. package/dist/magma-components/{p-b738d3c1.entry.js → p-d331ff5c.entry.js} +1 -1
  1313. package/dist/magma-components/{p-34c2daa9.system.entry.js → p-d3844c9a.system.entry.js} +4 -4
  1314. package/dist/magma-components/{p-837d31b8.entry.js → p-d3ac9a1a.entry.js} +1 -1
  1315. package/dist/magma-components/{p-8740403e.system.entry.js → p-d4c3250f.system.entry.js} +2 -2
  1316. package/dist/magma-components/p-d638bbb0.entry.js +1 -0
  1317. package/dist/magma-components/{p-72ad419d.system.entry.js → p-d65e9f0a.system.entry.js} +1 -1
  1318. package/dist/magma-components/{p-358aa5e7.entry.js → p-d87ecd68.entry.js} +1 -1
  1319. package/dist/magma-components/{p-2e48f88d.system.entry.js → p-d93b48b4.system.entry.js} +1 -1
  1320. package/dist/magma-components/{p-9855b517.entry.js → p-d94281cb.entry.js} +1 -1
  1321. package/dist/magma-components/{p-55746791.entry.js → p-d9f92ff8.entry.js} +1 -1
  1322. package/dist/magma-components/{p-4cabfdbc.entry.js → p-da9bc02a.entry.js} +1 -1
  1323. package/dist/magma-components/{p-0148cf0a.entry.js → p-dc618cae.entry.js} +1 -1
  1324. package/dist/magma-components/p-de38f745.entry.js +1 -0
  1325. package/dist/magma-components/{p-0b3e4a97.system.entry.js → p-dee123c7.system.entry.js} +2 -2
  1326. package/dist/magma-components/p-df387755.entry.js +1 -0
  1327. package/dist/magma-components/p-dfab370b.entry.js +1 -0
  1328. package/dist/magma-components/{p-0e887379.system.entry.js → p-e30d0684.system.entry.js} +2 -2
  1329. package/dist/magma-components/{p-f66675f5.system.entry.js → p-e371f9e1.system.entry.js} +1 -1
  1330. package/dist/magma-components/{p-8f7daab1.system.entry.js → p-e3b9ea0b.system.entry.js} +1 -1
  1331. package/dist/magma-components/{p-104ba54e.system.entry.js → p-e3d262d9.system.entry.js} +2 -2
  1332. package/dist/magma-components/{p-7fde3025.system.entry.js → p-e54587e7.system.entry.js} +3 -3
  1333. package/dist/magma-components/{p-2cdf450c.system.entry.js → p-e5f893f9.system.entry.js} +2 -2
  1334. package/dist/magma-components/{p-d0a93a14.system.entry.js → p-e709a52e.system.entry.js} +6 -3
  1335. package/dist/magma-components/{p-8680f63e.entry.js → p-e8452cce.entry.js} +1 -1
  1336. package/dist/magma-components/{p-09f621ea.entry.js → p-ea503851.entry.js} +1 -1
  1337. package/dist/magma-components/{p-3dc81ab9.system.entry.js → p-ec44a4ea.system.entry.js} +4 -4
  1338. package/dist/magma-components/{p-8645533a.entry.js → p-ed133270.entry.js} +1 -1
  1339. package/dist/magma-components/{p-77939a25.system.entry.js → p-ee780f82.system.entry.js} +2 -2
  1340. package/dist/magma-components/p-ef4ee9ca.entry.js +1 -0
  1341. package/dist/magma-components/{p-15ffdcf6.entry.js → p-f045b018.entry.js} +1 -1
  1342. package/dist/magma-components/{p-87ce9d6c.entry.js → p-f2211b1f.entry.js} +1 -1
  1343. package/dist/magma-components/{p-2aac4003.entry.js → p-f267ff68.entry.js} +1 -1
  1344. package/dist/magma-components/{p-41a28f2a.system.entry.js → p-f27de6cb.system.entry.js} +3 -3
  1345. package/dist/magma-components/{p-1908f808.entry.js → p-f2ef884c.entry.js} +1 -1
  1346. package/dist/magma-components/{p-9f8ce68f.entry.js → p-f3f88f32.entry.js} +1 -1
  1347. package/dist/magma-components/{p-1eee93c8.system.entry.js → p-f40e3918.system.entry.js} +2 -2
  1348. package/dist/magma-components/{p-6e32bf99.entry.js → p-f4181b35.entry.js} +1 -1
  1349. package/dist/magma-components/{p-8a76097f.entry.js → p-f4351160.entry.js} +1 -1
  1350. package/dist/magma-components/{p-c3a3caae.system.entry.js → p-f4fc9f29.system.entry.js} +1 -1
  1351. package/dist/magma-components/{p-f2f992c2.system.entry.js → p-f5c7b147.system.entry.js} +2 -2
  1352. package/dist/magma-components/{p-84ed22ea.system.entry.js → p-f7d5445c.system.entry.js} +1 -1
  1353. package/dist/magma-components/{p-08370fc2.system.entry.js → p-f7e9af99.system.entry.js} +1 -1
  1354. package/dist/magma-components/{p-95478664.system.entry.js → p-f8c85ad7.system.entry.js} +1 -1
  1355. package/dist/magma-components/{p-c6819aad.entry.js → p-f9b601de.entry.js} +1 -1
  1356. package/dist/magma-components/{p-357724ab.entry.js → p-fa44d0d2.entry.js} +1 -1
  1357. package/dist/magma-components/{p-d3d74616.entry.js → p-fba648e0.entry.js} +1 -1
  1358. package/dist/magma-components/p-fe8e3721.system.entry.js +225 -0
  1359. package/dist/magma-components/{p-8d6470fb.system.entry.js → p-fe98a77e.system.entry.js} +2 -2
  1360. package/dist/magma-components/{p-d980c3d2.system.entry.js → p-ff7fc1f6.system.entry.js} +2 -2
  1361. package/dist/stats.json +3498 -1516
  1362. package/dist/types/common/locale.d.ts +5 -0
  1363. package/dist/types/components/mds-accordion/mds-accordion.d.ts +1 -0
  1364. package/dist/types/components/mds-accordion-item/mds-accordion-item.d.ts +1 -0
  1365. package/dist/types/components/mds-accordion-timer/mds-accordion-timer.d.ts +1 -0
  1366. package/dist/types/components/mds-accordion-timer-item/mds-accordion-timer-item.d.ts +1 -0
  1367. package/dist/types/components/mds-author/mds-author.d.ts +1 -0
  1368. package/dist/types/components/mds-avatar/mds-avatar.d.ts +1 -0
  1369. package/dist/types/components/mds-avatar-stack/mds-avatar-stack.d.ts +1 -0
  1370. package/dist/types/components/mds-avatar-stack-item/mds-avatar-stack-item.d.ts +3 -0
  1371. package/dist/types/components/mds-badge/mds-badge.d.ts +1 -0
  1372. package/dist/types/components/mds-banner/mds-banner.d.ts +1 -0
  1373. package/dist/types/components/mds-benchmark-bar/mds-benchmark-bar.d.ts +1 -0
  1374. package/dist/types/components/mds-bibliography/mds-bibliography.d.ts +3 -0
  1375. package/dist/types/components/mds-book/mds-book.d.ts +114 -0
  1376. package/dist/types/components/mds-book/meta/dictionary.d.ts +4 -0
  1377. package/dist/types/components/mds-book/meta/format.d.ts +30 -0
  1378. package/dist/types/components/mds-book/meta/pose.d.ts +64 -0
  1379. package/dist/types/components/mds-book/meta/spine.d.ts +33 -0
  1380. package/dist/types/components/mds-book/meta/types.d.ts +3 -0
  1381. package/dist/types/components/mds-book/meta/volume.d.ts +22 -0
  1382. package/dist/types/components/mds-breadcrumb/mds-breadcrumb.d.ts +1 -0
  1383. package/dist/types/components/mds-breadcrumb-item/mds-breadcrumb-item.d.ts +1 -0
  1384. package/dist/types/components/mds-button/mds-button.d.ts +1 -0
  1385. package/dist/types/components/mds-button-dropdown/mds-button-dropdown.d.ts +1 -0
  1386. package/dist/types/components/mds-button-group/mds-button-group.d.ts +1 -0
  1387. package/dist/types/components/mds-calendar/mds-calendar.d.ts +1 -0
  1388. package/dist/types/components/mds-calendar-cell/mds-calendar-cell.d.ts +3 -0
  1389. package/dist/types/components/mds-card/mds-card.d.ts +1 -0
  1390. package/dist/types/components/mds-card-content/mds-card-content.d.ts +1 -0
  1391. package/dist/types/components/mds-card-footer/mds-card-footer.d.ts +1 -0
  1392. package/dist/types/components/mds-card-header/mds-card-header.d.ts +1 -0
  1393. package/dist/types/components/mds-card-media/mds-card-media.d.ts +1 -0
  1394. package/dist/types/components/mds-chip/mds-chip.d.ts +3 -0
  1395. package/dist/types/components/mds-details/mds-details.d.ts +1 -0
  1396. package/dist/types/components/mds-dropdown/mds-dropdown.d.ts +1 -0
  1397. package/dist/types/components/mds-emoji/mds-emoji.d.ts +3 -0
  1398. package/dist/types/components/mds-entity/mds-entity.d.ts +1 -0
  1399. package/dist/types/components/mds-file/mds-file.d.ts +3 -0
  1400. package/dist/types/components/mds-file-preview/mds-file-preview.d.ts +1 -0
  1401. package/dist/types/components/mds-filter/mds-filter.d.ts +1 -0
  1402. package/dist/types/components/mds-filter-item/mds-filter-item.d.ts +3 -0
  1403. package/dist/types/components/mds-header/mds-header.d.ts +1 -0
  1404. package/dist/types/components/mds-header-bar/mds-header-bar.d.ts +1 -0
  1405. package/dist/types/components/mds-help/mds-help.d.ts +1 -0
  1406. package/dist/types/components/mds-horizontal-scroll/mds-horizontal-scroll.d.ts +1 -0
  1407. package/dist/types/components/mds-hr/mds-hr.d.ts +3 -0
  1408. package/dist/types/components/mds-icon/mds-icon.d.ts +1 -0
  1409. package/dist/types/components/mds-img/mds-img.d.ts +1 -0
  1410. package/dist/types/components/mds-input/mds-input.d.ts +1 -0
  1411. package/dist/types/components/mds-input/meta/validators.d.ts +7 -2
  1412. package/dist/types/components/mds-input/meta/validity.d.ts +3 -2
  1413. package/dist/types/components/mds-input-date/mds-input-date.d.ts +1 -0
  1414. package/dist/types/components/mds-input-date-range/mds-input-date-range.d.ts +1 -0
  1415. package/dist/types/components/mds-input-date-range-preselection/mds-input-date-range-preselection.d.ts +1 -0
  1416. package/dist/types/components/mds-input-field/mds-input-field.d.ts +1 -0
  1417. package/dist/types/components/mds-input-otp/mds-input-otp.d.ts +3 -0
  1418. package/dist/types/components/mds-input-range/mds-input-range.d.ts +1 -0
  1419. package/dist/types/components/mds-input-select/mds-input-select.d.ts +3 -1
  1420. package/dist/types/components/mds-input-switch/mds-input-switch.d.ts +1 -0
  1421. package/dist/types/components/mds-input-tip/mds-input-tip.d.ts +1 -0
  1422. package/dist/types/components/mds-input-tip-item/mds-input-tip-item.d.ts +1 -0
  1423. package/dist/types/components/mds-input-upload/mds-input-upload.d.ts +3 -0
  1424. package/dist/types/components/mds-keyboard/mds-keyboard.d.ts +1 -0
  1425. package/dist/types/components/mds-keyboard-key/mds-keyboard-key.d.ts +3 -0
  1426. package/dist/types/components/mds-kpi/mds-kpi.d.ts +1 -0
  1427. package/dist/types/components/mds-kpi-item/mds-kpi-item.d.ts +1 -0
  1428. package/dist/types/components/mds-label/mds-label.d.ts +3 -0
  1429. package/dist/types/components/mds-link/mds-link.d.ts +1 -0
  1430. package/dist/types/components/mds-list/mds-list.d.ts +1 -0
  1431. package/dist/types/components/mds-list-item/mds-list-item.d.ts +1 -0
  1432. package/dist/types/components/mds-mention/mds-mention.d.ts +3 -0
  1433. package/dist/types/components/mds-modal/mds-modal.d.ts +1 -0
  1434. package/dist/types/components/mds-note/mds-note.d.ts +1 -0
  1435. package/dist/types/components/mds-notification/mds-notification.d.ts +3 -0
  1436. package/dist/types/components/mds-paginator/mds-paginator.d.ts +3 -0
  1437. package/dist/types/components/mds-paginator-item/mds-paginator-item.d.ts +1 -0
  1438. package/dist/types/components/mds-policy-ai/mds-policy-ai.d.ts +1 -0
  1439. package/dist/types/components/mds-pref/mds-pref.d.ts +1 -1
  1440. package/dist/types/components/mds-pref-animation/mds-pref-animation.d.ts +3 -0
  1441. package/dist/types/components/mds-pref-consumption/mds-pref-consumption.d.ts +3 -0
  1442. package/dist/types/components/mds-pref-contrast/mds-pref-contrast.d.ts +3 -0
  1443. package/dist/types/components/mds-pref-language/mds-pref-language.d.ts +1 -0
  1444. package/dist/types/components/mds-pref-language-item/mds-pref-language-item.d.ts +3 -0
  1445. package/dist/types/components/mds-pref-mode/mds-pref-mode.d.ts +3 -0
  1446. package/dist/types/components/mds-pref-theme/mds-pref-theme.d.ts +1 -0
  1447. package/dist/types/components/mds-pref-theme-item/mds-pref-theme-item.d.ts +3 -0
  1448. package/dist/types/components/mds-price-table/mds-price-table.d.ts +1 -0
  1449. package/dist/types/components/mds-price-table-features/mds-price-table-features.d.ts +1 -0
  1450. package/dist/types/components/mds-price-table-features-cell/mds-price-table-features-cell.d.ts +1 -0
  1451. package/dist/types/components/mds-price-table-features-row/mds-price-table-features-row.d.ts +1 -0
  1452. package/dist/types/components/mds-price-table-header/mds-price-table-header.d.ts +1 -0
  1453. package/dist/types/components/mds-price-table-list/mds-price-table-list.d.ts +1 -0
  1454. package/dist/types/components/mds-price-table-list-item/mds-price-table-list-item.d.ts +1 -0
  1455. package/dist/types/components/mds-progress/mds-progress.d.ts +1 -0
  1456. package/dist/types/components/mds-push-notification/mds-push-notification.d.ts +1 -0
  1457. package/dist/types/components/mds-push-notification-item/mds-push-notification-item.d.ts +1 -0
  1458. package/dist/types/components/mds-quote/mds-quote.d.ts +1 -0
  1459. package/dist/types/components/mds-radial-menu/mds-radial-menu.d.ts +1 -0
  1460. package/dist/types/components/mds-radial-menu-item/mds-radial-menu-item.d.ts +3 -0
  1461. package/dist/types/components/mds-radial-progress/mds-radial-progress.d.ts +1 -0
  1462. package/dist/types/components/mds-separator/mds-separator.d.ts +3 -0
  1463. package/dist/types/components/mds-spinner/mds-spinner.d.ts +3 -0
  1464. package/dist/types/components/mds-status-bar/mds-status-bar.d.ts +1 -0
  1465. package/dist/types/components/mds-stepper-bar/mds-stepper-bar.d.ts +1 -0
  1466. package/dist/types/components/mds-stepper-bar-item/mds-stepper-bar-item.d.ts +1 -0
  1467. package/dist/types/components/mds-tab/mds-tab.d.ts +1 -0
  1468. package/dist/types/components/mds-tab-bar/mds-tab-bar.d.ts +1 -0
  1469. package/dist/types/components/mds-tab-bar-item/mds-tab-bar-item.d.ts +1 -0
  1470. package/dist/types/components/mds-tab-item/mds-tab-item.d.ts +1 -0
  1471. package/dist/types/components/mds-table/mds-table.d.ts +1 -0
  1472. package/dist/types/components/mds-table-body/mds-table-body.d.ts +1 -0
  1473. package/dist/types/components/mds-table-cell/mds-table-cell.d.ts +1 -0
  1474. package/dist/types/components/mds-table-footer/mds-table-footer.d.ts +1 -0
  1475. package/dist/types/components/mds-table-header/mds-table-header.d.ts +1 -0
  1476. package/dist/types/components/mds-table-header-cell/mds-table-header-cell.d.ts +1 -0
  1477. package/dist/types/components/mds-table-row/mds-table-row.d.ts +1 -0
  1478. package/dist/types/components/mds-text/mds-text.d.ts +1 -0
  1479. package/dist/types/components/mds-toast/mds-toast.d.ts +1 -0
  1480. package/dist/types/components/mds-toast-region/mds-toast-region.d.ts +1 -0
  1481. package/dist/types/components/mds-tooltip/mds-tooltip.d.ts +1 -0
  1482. package/dist/types/components/mds-tree/mds-tree.d.ts +1 -0
  1483. package/dist/types/components/mds-tree-item/mds-tree-item.d.ts +1 -0
  1484. package/dist/types/components/mds-url-view/mds-url-view.d.ts +3 -0
  1485. package/dist/types/components/mds-usage/mds-usage.d.ts +1 -0
  1486. package/dist/types/components/mds-video-wall/mds-video-wall.d.ts +1 -0
  1487. package/dist/types/components/mds-zero/mds-zero.d.ts +1 -0
  1488. package/dist/types/components.d.ts +1517 -6
  1489. package/package.json +42 -5
  1490. package/dist/components/p-B0AnE3sA.js +0 -1
  1491. package/dist/components/p-BbTcXgbr.js +0 -1
  1492. package/dist/components/p-CHHEp_7y.js +0 -1
  1493. package/dist/components/p-D8wd-EZX.js +0 -1
  1494. package/dist/magma-components/p-083dceb8.system.entry.js +0 -1
  1495. package/dist/magma-components/p-0eb3558a.entry.js +0 -1
  1496. package/dist/magma-components/p-2a964578.entry.js +0 -1
  1497. package/dist/magma-components/p-335244bb.entry.js +0 -1
  1498. package/dist/magma-components/p-3fb46ab9.system.entry.js +0 -1
  1499. package/dist/magma-components/p-4d485e1f.system.entry.js +0 -1
  1500. package/dist/magma-components/p-57839384.system.entry.js +0 -17
  1501. package/dist/magma-components/p-632ad925.system.entry.js +0 -222
  1502. package/dist/magma-components/p-6436178a.entry.js +0 -1
  1503. package/dist/magma-components/p-644e64a0.entry.js +0 -1
  1504. package/dist/magma-components/p-791a6a6f.entry.js +0 -1
  1505. package/dist/magma-components/p-7ec1ea2e.entry.js +0 -1
  1506. package/dist/magma-components/p-89d4b6e9.entry.js +0 -1
  1507. package/dist/magma-components/p-984dd850.entry.js +0 -1
  1508. package/dist/magma-components/p-a7c01334.entry.js +0 -1
  1509. package/dist/magma-components/p-a8e1ce2f.entry.js +0 -1
  1510. package/dist/magma-components/p-ab4b617d.entry.js +0 -1
  1511. package/dist/magma-components/p-d6b38d8a.entry.js +0 -1
  1512. package/dist/magma-components/p-da24a265.entry.js +0 -1
  1513. package/dist/magma-components/p-e1383302.entry.js +0 -1
  1514. package/dist/magma-components/p-f1aafe07.entry.js +0 -1
  1515. package/dist/magma-components/p-f78c1699.entry.js +0 -1
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-horizontal-scroll
8
8
 
9
- > `@maggioli-design-system/magma` 2.5.0. Shadow DOM: style it only through the CSS custom properties and parts below.
9
+ > `@maggioli-design-system/magma` 2.6.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
10
10
 
11
11
  The `<mds-horizontal-scroll>` web component is a horizontally scrolling container of the Magma Design System. It wraps any slotted content in a snap-scrolling viewport and overlays optional navigation controls, replacing the manual overflow/scroll-snap CSS plumbing you would otherwise write around a `<div>`.
12
12
 
@@ -24,7 +24,7 @@ The `<mds-horizontal-scroll>` web component is a horizontally scrolling containe
24
24
  - **`navigation`** chooses the scroll-progress affordance: `'position'` renders the translating dot indicator, `'scrollbar'` defers to the styled native browser scrollbar, and `'none'` shows neither.
25
25
  - **`snap`** sets the scroll-snap alignment of each item against the viewport - `'start'` (default) aligns items to the leading edge, `'center'` keeps them centred, `'end'` to the trailing edge, and `'none'` disables snapping for free scrolling.
26
26
 
27
- This component does not use the shared `variant` / `tone` ladders defined in [`agents/variants.md`](../../../../agents/variants.md); appearance is tuned entirely through its CSS custom properties (see [`AGENTS.md`](AGENTS.md)).
27
+ This component does not use the shared `variant` / `tone` ladders defined in [`agents/variants.md`](../../../../agents/variants.md); its public CSS custom properties set the layout (the width of the items area and the margin of the controls) and its colours follow the theme (see [`AGENTS.md`](AGENTS.md)).
28
28
 
29
29
  ## Read next
30
30
 
@@ -56,16 +56,10 @@ This component does not use the shared `variant` / `tone` ladders defined in [`a
56
56
 
57
57
  | Property | Description |
58
58
  | --- | --- |
59
- | `--mds-horizontal-scroll-behavior` | Sets the scroll-behavior animation |
60
- | `--mds-horizontal-scroll-dot-area-background` | Sets the dot container area color |
61
- | `--mds-horizontal-scroll-dot-background` | Sets the navigation dot color |
62
- | `--mds-horizontal-scroll-dot-max-width` | Sets the navigation dot max-width, if you want to avoid is scales in proportion of the container |
59
+ | `--mds-horizontal-scroll-controls-margin` | Sets how far the back and forward controls sit outside the area of the slotted elements, 48px by default; `0px` keeps them on its edges |
63
60
  | `--mds-horizontal-scroll-max-width` | Sets the max-width of the slotted elements container, to keep layout limited as the rest of the sections |
64
- | `--mds-horizontal-scroll-scrollbar-margin` | Sets the margin of the browser scroll bar (if supported) |
65
- | `--mds-horizontal-scroll-scrollbar-radius` | Sets the border-radius of the browser scroll bar (if supported) |
66
- | `--mds-horizontal-scroll-scrollbar-size` | Sets the height and width of the browser scroll bar (if supported) |
67
- | `--mds-horizontal-scroll-scrollbar-thumb-background` | Sets the background-color of the browser scroll bar thumb (if supported) |
68
- | `--mds-horizontal-scroll-scrollbar-track-background` | Sets the background-color of the browser scroll bar track (if supported) |
61
+
62
+ Only these are public. Its other 9 are internal: they may change in any release, do not set them.
69
63
 
70
64
  ## Dependencies
71
65
 
@@ -81,7 +81,7 @@ Replacing `<mds-horizontal-scroll>` with a manually styled `<div style="overflow
81
81
 
82
82
  #### Do Not Pierce the Shadow DOM to Style Internal Elements
83
83
 
84
- The navigation buttons and dot indicator live inside the shadow DOM. Targeting them via `>>>`, `/deep/`, or undocumented class names (`.navigation`, `.dot`) will break on future releases. Use `--mds-horizontal-scroll-*` CSS custom properties instead.
84
+ The navigation buttons and dot indicator live inside the shadow DOM. Targeting them via `>>>`, `/deep/`, or undocumented class names (`.navigation`, `.dot`) will break on future releases. Use the public `--mds-horizontal-scroll-*` CSS custom properties and the `content` part instead; the dot and the controls take their colours from the theme.
85
85
 
86
86
  ```css
87
87
  /* INCORRECT */
@@ -94,7 +94,7 @@ mds-horizontal-scroll >>> .navigation {
94
94
 
95
95
  /* CORRECT */
96
96
  mds-horizontal-scroll {
97
- --mds-horizontal-scroll-dot-background: rgb(var(--magma-accent-emphasis));
97
+ --mds-horizontal-scroll-controls-margin: 0px;
98
98
  }
99
99
  mds-horizontal-scroll::part(content) {
100
100
  padding-block: calc(var(--spacing) * 800);
@@ -1,5 +1,5 @@
1
1
  {
2
- "timestamp": "2026-10-21T16:53:07",
2
+ "timestamp": "2026-10-24T12:14:05",
3
3
  "compiler": {
4
4
  "name": "@stencil/core",
5
5
  "version": "4.45.2",
@@ -19,12 +19,16 @@
19
19
  {
20
20
  "name": "part",
21
21
  "text": "content - The track that scrolls, with the default slot inside"
22
+ },
23
+ {
24
+ "name": "category",
25
+ "text": "structure"
22
26
  }
23
27
  ],
24
28
  "usage": {
25
- "1. Description": "The `<mds-horizontal-scroll>` web component is a horizontally scrolling container of the Magma Design System. It wraps any slotted content in a snap-scrolling viewport and overlays optional navigation controls, replacing the manual overflow/scroll-snap CSS plumbing you would otherwise write around a `<div>`.\n\n#### Semantic Behavior\n\n- **Slotted children drive scrolling**: The default slot's children are the scrollable items.\n- **Navigation buttons**: When `controls` resolves to a viewport other than `'none'`, two arrow buttons are rendered, icon-only and named in the page language (the `lang` of `<html>`) (\"Scroll back\", \"Scroll forward\"); each advances the scroll position to the next/previous item not fully in the viewport. Browsers without the `scrollend` event get no arrows: the component clears `controls` there.\n- **Auto-disabled arrows**: The back arrow hides/disables when the first item is fully visible and the forward arrow when the last item is.\n- **Position indicator**: With `navigation=\"position\"` a proportional dot is rendered; its width reflects the visible/total ratio and it translates along its track as the container scrolls.\n- **No focus or form semantics**: This is a presentational scroll container - it is not form-associated, exposes no implicit ARIA role, and emits no custom events.\n\n#### Properties & Visual Configurations\n\n- **`controls`** selects the smallest viewport breakpoint at which the arrow navigation appears (default `'desktop'`); pick a wider tier like `'large'` or `'wide'` to show arrows only on big screens, or `'none'` to suppress them entirely. The chosen value is the threshold, not a single device.\n- **`navigation`** chooses the scroll-progress affordance: `'position'` renders the translating dot indicator, `'scrollbar'` defers to the styled native browser scrollbar, and `'none'` shows neither.\n- **`snap`** sets the scroll-snap alignment of each item against the viewport - `'start'` (default) aligns items to the leading edge, `'center'` keeps them centred, `'end'` to the trailing edge, and `'none'` disables snapping for free scrolling.\n\nThis component does not use the shared `variant` / `tone` ladders defined in [`agents/variants.md`](../../../../agents/variants.md); appearance is tuned entirely through its CSS custom properties (see [`AGENTS.md`](AGENTS.md)).\n",
26
- "2. Pattern": "Correct and idiomatic ways to use the `<mds-horizontal-scroll>` component, ordered from most common to most specialized. Patterns assume a working knowledge of the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Basic Horizontal Scroll with Cards\n\nThe canonical form. Slot any fixed-width children directly into the component; it wraps them in a snap-scrolling viewport with a proportional dot indicator and arrow buttons automatically.\n\n```html\n<mds-horizontal-scroll>\n <mds-card class=\"min-w-[320px]\">\n <mds-card-header>Servizio 1</mds-card-header>\n <mds-card-content>Descrizione del primo servizio.</mds-card-content>\n </mds-card>\n <mds-card class=\"min-w-[320px]\">\n <mds-card-header>Servizio 2</mds-card-header>\n <mds-card-content>Descrizione del secondo servizio.</mds-card-content>\n </mds-card>\n <mds-card class=\"min-w-[320px]\">\n <mds-card-header>Servizio 3</mds-card-header>\n <mds-card-content>Descrizione del terzo servizio.</mds-card-content>\n </mds-card>\n</mds-horizontal-scroll>\n```\n\n#### Controlling Navigation Arrow Visibility\n\nUse `controls` to restrict arrow buttons to specific viewport tiers. The value is the minimum breakpoint at which arrows appear - `'desktop'` (default) shows them only on desktop and above; `'all'` shows them at every viewport size; `'none'` suppresses them entirely.\n\n```html\n<!-- Arrows only on desktop and above (default) -->\n<mds-horizontal-scroll controls=\"desktop\">\n <!-- slotted items -->\n</mds-horizontal-scroll>\n\n<!-- Arrows on all viewports, including mobile -->\n<mds-horizontal-scroll controls=\"all\">\n <!-- slotted items -->\n</mds-horizontal-scroll>\n\n<!-- No arrows - touch / keyboard scroll only -->\n<mds-horizontal-scroll controls=\"none\">\n <!-- slotted items -->\n</mds-horizontal-scroll>\n```\n\n#### Scroll Progress Indicator\n\nUse `navigation` to choose the scroll-position affordance shown below the items. `'position'` (default) renders a proportional translating dot; `'scrollbar'` defers to the styled native browser scrollbar; `'none'` hides both.\n\n```html\n<!-- Dot indicator (default) -->\n<mds-horizontal-scroll navigation=\"position\">\n <!-- slotted items -->\n</mds-horizontal-scroll>\n\n<!-- Native scrollbar instead of dot -->\n<mds-horizontal-scroll navigation=\"scrollbar\">\n <!-- slotted items -->\n</mds-horizontal-scroll>\n\n<!-- No progress indicator -->\n<mds-horizontal-scroll navigation=\"none\">\n <!-- slotted items -->\n</mds-horizontal-scroll>\n```\n\n#### Snap Alignment\n\n`snap` controls how each item aligns to the viewport edge when the scroll settles. Use `'start'` (default) for left-aligned cards, `'center'` for centred carousels, `'end'` for right-aligned layouts, or `'none'` to allow free scrolling without snapping.\n\n```html\n<!-- Leading-edge alignment (default, most common) -->\n<mds-horizontal-scroll snap=\"start\">\n <!-- slotted items -->\n</mds-horizontal-scroll>\n\n<!-- Centred alignment - good for full-bleed hero carousels -->\n<mds-horizontal-scroll snap=\"center\">\n <!-- slotted items -->\n</mds-horizontal-scroll>\n\n<!-- Free scroll - no snapping -->\n<mds-horizontal-scroll snap=\"none\">\n <!-- slotted items -->\n</mds-horizontal-scroll>\n```\n\n#### Combining Props for a Mobile-Friendly Carousel\n\nPair `controls=\"all\"` with `snap=\"center\"` and `navigation=\"position\"` to produce a touch-and-arrow carousel that works at every breakpoint.\n\n```html\n<mds-horizontal-scroll controls=\"all\" snap=\"center\" navigation=\"position\">\n <mds-card class=\"min-w-[280px]\">\n <mds-card-media>\n <mds-img src=\"https://example.com/img1.jpg\"></mds-img>\n </mds-card-media>\n <mds-card-content>\n <mds-text typography=\"h5\">Categoria A</mds-text>\n </mds-card-content>\n </mds-card>\n <mds-card class=\"min-w-[280px]\">\n <mds-card-media>\n <mds-img src=\"https://example.com/img2.jpg\"></mds-img>\n </mds-card-media>\n <mds-card-content>\n <mds-text typography=\"h5\">Categoria B</mds-text>\n </mds-card-content>\n </mds-card>\n</mds-horizontal-scroll>\n```\n\n#### Styling Customization\n\nStyle the component only through its documented `--mds-horizontal-scroll-*` 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 and high-contrast modes keep working.\n\n```css\n.sezione-evidenza mds-horizontal-scroll {\n --mds-horizontal-scroll-dot-background: rgb(var(--magma-accent-emphasis));\n --mds-horizontal-scroll-dot-area-background: rgb(var(--magma-accent-surface-hover));\n --mds-horizontal-scroll-max-width: 1200px;\n}\n```\n\n#### Styling the Scrollbar\n\nWhen `navigation=\"scrollbar\"` is used, customize the native scrollbar appearance through the dedicated properties. All scrollbar props are browser-dependent and may have no effect on browsers that do not expose a styleable scrollbar.\n\n```css\nmds-horizontal-scroll {\n --mds-horizontal-scroll-scrollbar-size: 6px;\n --mds-horizontal-scroll-scrollbar-radius: var(--magma-radius-3xs);\n --mds-horizontal-scroll-scrollbar-thumb-background: rgb(var(--magma-accent-emphasis));\n --mds-horizontal-scroll-scrollbar-track-background: rgb(var(--magma-wash-strong));\n}\n```\n\n#### Customizing the Content Part\n\nThe inner scroll container is exposed as `::part(content)`. Use it sparingly - only when a CSS custom property cannot satisfy your requirement - to apply layout overrides without piercing undocumented internals.\n\n```css\nmds-horizontal-scroll::part(content) {\n padding-block: calc(var(--spacing) * 800);\n}\n```\n",
27
- "3. Antipattern": "Common incorrect uses of `<mds-horizontal-scroll>`. Each entry pairs the wrong form with the right one and a one-line reason. System-wide rules (boolean-as-string, shadow piercing, Tailwind color utilities, raw native event listening) live in [`agents/anti-patterns.md`](../../../../agents/anti-patterns.md) - they apply here too but are not repeated.\n\n#### Do Not Set `controls` to a Boolean\n\n`controls` is a `ViewportType` string prop, not a boolean. Setting it without a value (or as `\"\"`) gives an empty string, which renders no arrows at all - the opposite of what a bare boolean attribute suggests. Always supply an explicit string value.\n\n```html\n<!-- INCORRECT -->\n<mds-horizontal-scroll controls>\n <!-- slotted items -->\n</mds-horizontal-scroll>\n\n<!-- CORRECT -->\n<mds-horizontal-scroll controls=\"desktop\">\n <!-- slotted items -->\n</mds-horizontal-scroll>\n```\n\n#### Do Not Wrap Slotted Items in an Extra Div\n\nAdding a single wrapper `<div>` around all children collapses the scroll track to one item. The component's arrow and snap logic iterates over the direct slot children - each scrollable item must be a direct child, not grandchildren inside a wrapper.\n\n```html\n<!-- INCORRECT -->\n<mds-horizontal-scroll>\n <div>\n <mds-card class=\"min-w-[320px]\">...</mds-card>\n <mds-card class=\"min-w-[320px]\">...</mds-card>\n </div>\n</mds-horizontal-scroll>\n\n<!-- CORRECT -->\n<mds-horizontal-scroll>\n <mds-card class=\"min-w-[320px]\">...</mds-card>\n <mds-card class=\"min-w-[320px]\">...</mds-card>\n</mds-horizontal-scroll>\n```\n\n#### Do Not Set `controls=\"none\"` as Boolean False\n\n`controls` has no boolean semantic. Removing arrow buttons is done with `controls=\"none\"`, not by writing `controls=\"false\"` or `disabled`. The string `\"false\"` is not a `ViewportType`: the arrows end up hidden only because no breakpoint rule matches it, and a type check rejects it.\n\n```html\n<!-- INCORRECT -->\n<mds-horizontal-scroll controls=\"false\">\n <!-- slotted items -->\n</mds-horizontal-scroll>\n\n<!-- CORRECT -->\n<mds-horizontal-scroll controls=\"none\">\n <!-- slotted items -->\n</mds-horizontal-scroll>\n```\n\n#### Do Not Use a Raw `<div>` Scroll Container Instead\n\nReplacing `<mds-horizontal-scroll>` with a manually styled `<div style=\"overflow-x: auto\">` loses the managed arrow buttons, the dot indicator, scroll-snap wiring, and the `controls` breakpoint logic. Use the component.\n\n```html\n<!-- INCORRECT -->\n<div style=\"overflow-x: auto; display: flex; gap: 16px;\">\n <mds-card class=\"min-w-[320px]\">...</mds-card>\n <mds-card class=\"min-w-[320px]\">...</mds-card>\n</div>\n\n<!-- CORRECT -->\n<mds-horizontal-scroll>\n <mds-card class=\"min-w-[320px]\">...</mds-card>\n <mds-card class=\"min-w-[320px]\">...</mds-card>\n</mds-horizontal-scroll>\n```\n\n#### Do Not Pierce the Shadow DOM to Style Internal Elements\n\nThe navigation buttons and dot indicator live inside the shadow DOM. Targeting them via `>>>`, `/deep/`, or undocumented class names (`.navigation`, `.dot`) will break on future releases. Use `--mds-horizontal-scroll-*` CSS custom properties instead.\n\n```css\n/* INCORRECT */\nmds-horizontal-scroll >>> .dot {\n background: red;\n}\nmds-horizontal-scroll >>> .navigation {\n border-radius: 0;\n}\n\n/* CORRECT */\nmds-horizontal-scroll {\n --mds-horizontal-scroll-dot-background: rgb(var(--magma-accent-emphasis));\n}\nmds-horizontal-scroll::part(content) {\n padding-block: calc(var(--spacing) * 800);\n}\n```\n\n#### Do Not Provide Slotted Items Without a Fixed Width\n\nSlotted items without a declared width collapse to zero or stretch unpredictably. Always give direct children an explicit `min-width` or `width` so the container has measurable items to snap and scroll among.\n\n```html\n<!-- INCORRECT: card has no fixed width, items will collapse -->\n<mds-horizontal-scroll>\n <mds-card>...</mds-card>\n <mds-card>...</mds-card>\n</mds-horizontal-scroll>\n\n<!-- CORRECT: each card has a declared minimum width -->\n<mds-horizontal-scroll>\n <mds-card class=\"min-w-[320px]\">...</mds-card>\n <mds-card class=\"min-w-[320px]\">...</mds-card>\n</mds-horizontal-scroll>\n```\n"
29
+ "1. Description": "The `<mds-horizontal-scroll>` web component is a horizontally scrolling container of the Magma Design System. It wraps any slotted content in a snap-scrolling viewport and overlays optional navigation controls, replacing the manual overflow/scroll-snap CSS plumbing you would otherwise write around a `<div>`.\n\n#### Semantic Behavior\n\n- **Slotted children drive scrolling**: The default slot's children are the scrollable items.\n- **Navigation buttons**: When `controls` resolves to a viewport other than `'none'`, two arrow buttons are rendered, icon-only and named in the page language (the `lang` of `<html>`) (\"Scroll back\", \"Scroll forward\"); each advances the scroll position to the next/previous item not fully in the viewport. Browsers without the `scrollend` event get no arrows: the component clears `controls` there.\n- **Auto-disabled arrows**: The back arrow hides/disables when the first item is fully visible and the forward arrow when the last item is.\n- **Position indicator**: With `navigation=\"position\"` a proportional dot is rendered; its width reflects the visible/total ratio and it translates along its track as the container scrolls.\n- **No focus or form semantics**: This is a presentational scroll container - it is not form-associated, exposes no implicit ARIA role, and emits no custom events.\n\n#### Properties & Visual Configurations\n\n- **`controls`** selects the smallest viewport breakpoint at which the arrow navigation appears (default `'desktop'`); pick a wider tier like `'large'` or `'wide'` to show arrows only on big screens, or `'none'` to suppress them entirely. The chosen value is the threshold, not a single device.\n- **`navigation`** chooses the scroll-progress affordance: `'position'` renders the translating dot indicator, `'scrollbar'` defers to the styled native browser scrollbar, and `'none'` shows neither.\n- **`snap`** sets the scroll-snap alignment of each item against the viewport - `'start'` (default) aligns items to the leading edge, `'center'` keeps them centred, `'end'` to the trailing edge, and `'none'` disables snapping for free scrolling.\n\nThis component does not use the shared `variant` / `tone` ladders defined in [`agents/variants.md`](../../../../agents/variants.md); its public CSS custom properties set the layout (the width of the items area and the margin of the controls) and its colours follow the theme (see [`AGENTS.md`](AGENTS.md)).\n",
30
+ "2. Pattern": "Correct and idiomatic ways to use the `<mds-horizontal-scroll>` component, ordered from most common to most specialized. Patterns assume a working knowledge of the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Basic Horizontal Scroll with Cards\n\nThe canonical form. Slot any fixed-width children directly into the component; it wraps them in a snap-scrolling viewport with a proportional dot indicator and arrow buttons automatically.\n\n```html\n<mds-horizontal-scroll>\n <mds-card class=\"min-w-[320px]\">\n <mds-card-header>Servizio 1</mds-card-header>\n <mds-card-content>Descrizione del primo servizio.</mds-card-content>\n </mds-card>\n <mds-card class=\"min-w-[320px]\">\n <mds-card-header>Servizio 2</mds-card-header>\n <mds-card-content>Descrizione del secondo servizio.</mds-card-content>\n </mds-card>\n <mds-card class=\"min-w-[320px]\">\n <mds-card-header>Servizio 3</mds-card-header>\n <mds-card-content>Descrizione del terzo servizio.</mds-card-content>\n </mds-card>\n</mds-horizontal-scroll>\n```\n\n#### Controlling Navigation Arrow Visibility\n\nUse `controls` to restrict arrow buttons to specific viewport tiers. The value is the minimum breakpoint at which arrows appear - `'desktop'` (default) shows them only on desktop and above; `'all'` shows them at every viewport size; `'none'` suppresses them entirely.\n\n```html\n<!-- Arrows only on desktop and above (default) -->\n<mds-horizontal-scroll controls=\"desktop\">\n <!-- slotted items -->\n</mds-horizontal-scroll>\n\n<!-- Arrows on all viewports, including mobile -->\n<mds-horizontal-scroll controls=\"all\">\n <!-- slotted items -->\n</mds-horizontal-scroll>\n\n<!-- No arrows - touch / keyboard scroll only -->\n<mds-horizontal-scroll controls=\"none\">\n <!-- slotted items -->\n</mds-horizontal-scroll>\n```\n\n#### Scroll Progress Indicator\n\nUse `navigation` to choose the scroll-position affordance shown below the items. `'position'` (default) renders a proportional translating dot; `'scrollbar'` defers to the styled native browser scrollbar; `'none'` hides both.\n\n```html\n<!-- Dot indicator (default) -->\n<mds-horizontal-scroll navigation=\"position\">\n <!-- slotted items -->\n</mds-horizontal-scroll>\n\n<!-- Native scrollbar instead of dot -->\n<mds-horizontal-scroll navigation=\"scrollbar\">\n <!-- slotted items -->\n</mds-horizontal-scroll>\n\n<!-- No progress indicator -->\n<mds-horizontal-scroll navigation=\"none\">\n <!-- slotted items -->\n</mds-horizontal-scroll>\n```\n\n#### Snap Alignment\n\n`snap` controls how each item aligns to the viewport edge when the scroll settles. Use `'start'` (default) for left-aligned cards, `'center'` for centred carousels, `'end'` for right-aligned layouts, or `'none'` to allow free scrolling without snapping.\n\n```html\n<!-- Leading-edge alignment (default, most common) -->\n<mds-horizontal-scroll snap=\"start\">\n <!-- slotted items -->\n</mds-horizontal-scroll>\n\n<!-- Centred alignment - good for full-bleed hero carousels -->\n<mds-horizontal-scroll snap=\"center\">\n <!-- slotted items -->\n</mds-horizontal-scroll>\n\n<!-- Free scroll - no snapping -->\n<mds-horizontal-scroll snap=\"none\">\n <!-- slotted items -->\n</mds-horizontal-scroll>\n```\n\n#### Combining Props for a Mobile-Friendly Carousel\n\nPair `controls=\"all\"` with `snap=\"center\"` and `navigation=\"position\"` to produce a touch-and-arrow carousel that works at every breakpoint.\n\n```html\n<mds-horizontal-scroll controls=\"all\" snap=\"center\" navigation=\"position\">\n <mds-card class=\"min-w-[280px]\">\n <mds-card-media>\n <mds-img src=\"https://example.com/img1.jpg\" alt=\"\"></mds-img>\n </mds-card-media>\n <mds-card-content>\n <mds-text typography=\"h5\">Categoria A</mds-text>\n </mds-card-content>\n </mds-card>\n <mds-card class=\"min-w-[280px]\">\n <mds-card-media>\n <mds-img src=\"https://example.com/img2.jpg\" alt=\"\"></mds-img>\n </mds-card-media>\n <mds-card-content>\n <mds-text typography=\"h5\">Categoria B</mds-text>\n </mds-card-content>\n </mds-card>\n</mds-horizontal-scroll>\n```\n\n#### Styling Customization\n\nStyle the component only through its public `--mds-horizontal-scroll-*` CSS custom properties, which set its layout: the width of the items area and how far the controls sit outside it. Set them on the host or a parent selector. The dot indicator and the controls take their colours from the semantic roles, so they follow dark mode without overrides.\n\n```css\n.sezione-evidenza mds-horizontal-scroll {\n --mds-horizontal-scroll-max-width: 1200px;\n}\n```\n\n#### Styling the Scrollbar\n\nWhen `navigation=\"scrollbar\"` is used, the component styles the native scrollbar itself, from the semantic color roles, so it follows dark mode; its size and colours have no public custom property. When the scrollbar does not suit the layout, pick another affordance with `navigation` instead of restyling it.\n\n#### Customizing the Content Part\n\nThe inner scroll container is exposed as `::part(content)`. Use it sparingly - only when a CSS custom property cannot satisfy your requirement - to apply layout overrides without piercing undocumented internals.\n\n```css\nmds-horizontal-scroll::part(content) {\n padding-block: calc(var(--spacing) * 800);\n}\n```\n",
31
+ "3. Antipattern": "Common incorrect uses of `<mds-horizontal-scroll>`. Each entry pairs the wrong form with the right one and a one-line reason. System-wide rules (boolean-as-string, shadow piercing, Tailwind color utilities, raw native event listening) live in [`agents/anti-patterns.md`](../../../../agents/anti-patterns.md) - they apply here too but are not repeated.\n\n#### Do Not Set `controls` to a Boolean\n\n`controls` is a `ViewportType` string prop, not a boolean. Setting it without a value (or as `\"\"`) gives an empty string, which renders no arrows at all - the opposite of what a bare boolean attribute suggests. Always supply an explicit string value.\n\n```html\n<!-- INCORRECT -->\n<mds-horizontal-scroll controls>\n <!-- slotted items -->\n</mds-horizontal-scroll>\n\n<!-- CORRECT -->\n<mds-horizontal-scroll controls=\"desktop\">\n <!-- slotted items -->\n</mds-horizontal-scroll>\n```\n\n#### Do Not Wrap Slotted Items in an Extra Div\n\nAdding a single wrapper `<div>` around all children collapses the scroll track to one item. The component's arrow and snap logic iterates over the direct slot children - each scrollable item must be a direct child, not grandchildren inside a wrapper.\n\n```html\n<!-- INCORRECT -->\n<mds-horizontal-scroll>\n <div>\n <mds-card class=\"min-w-[320px]\">...</mds-card>\n <mds-card class=\"min-w-[320px]\">...</mds-card>\n </div>\n</mds-horizontal-scroll>\n\n<!-- CORRECT -->\n<mds-horizontal-scroll>\n <mds-card class=\"min-w-[320px]\">...</mds-card>\n <mds-card class=\"min-w-[320px]\">...</mds-card>\n</mds-horizontal-scroll>\n```\n\n#### Do Not Set `controls=\"none\"` as Boolean False\n\n`controls` has no boolean semantic. Removing arrow buttons is done with `controls=\"none\"`, not by writing `controls=\"false\"` or `disabled`. The string `\"false\"` is not a `ViewportType`: the arrows end up hidden only because no breakpoint rule matches it, and a type check rejects it.\n\n```html\n<!-- INCORRECT -->\n<mds-horizontal-scroll controls=\"false\">\n <!-- slotted items -->\n</mds-horizontal-scroll>\n\n<!-- CORRECT -->\n<mds-horizontal-scroll controls=\"none\">\n <!-- slotted items -->\n</mds-horizontal-scroll>\n```\n\n#### Do Not Use a Raw `<div>` Scroll Container Instead\n\nReplacing `<mds-horizontal-scroll>` with a manually styled `<div style=\"overflow-x: auto\">` loses the managed arrow buttons, the dot indicator, scroll-snap wiring, and the `controls` breakpoint logic. Use the component.\n\n```html\n<!-- INCORRECT -->\n<div style=\"overflow-x: auto; display: flex; gap: 16px;\">\n <mds-card class=\"min-w-[320px]\">...</mds-card>\n <mds-card class=\"min-w-[320px]\">...</mds-card>\n</div>\n\n<!-- CORRECT -->\n<mds-horizontal-scroll>\n <mds-card class=\"min-w-[320px]\">...</mds-card>\n <mds-card class=\"min-w-[320px]\">...</mds-card>\n</mds-horizontal-scroll>\n```\n\n#### Do Not Pierce the Shadow DOM to Style Internal Elements\n\nThe navigation buttons and dot indicator live inside the shadow DOM. Targeting them via `>>>`, `/deep/`, or undocumented class names (`.navigation`, `.dot`) will break on future releases. Use the public `--mds-horizontal-scroll-*` CSS custom properties and the `content` part instead; the dot and the controls take their colours from the theme.\n\n```css\n/* INCORRECT */\nmds-horizontal-scroll >>> .dot {\n background: red;\n}\nmds-horizontal-scroll >>> .navigation {\n border-radius: 0;\n}\n\n/* CORRECT */\nmds-horizontal-scroll {\n --mds-horizontal-scroll-controls-margin: 0px;\n}\nmds-horizontal-scroll::part(content) {\n padding-block: calc(var(--spacing) * 800);\n}\n```\n\n#### Do Not Provide Slotted Items Without a Fixed Width\n\nSlotted items without a declared width collapse to zero or stretch unpredictably. Always give direct children an explicit `min-width` or `width` so the container has measurable items to snap and scroll among.\n\n```html\n<!-- INCORRECT: card has no fixed width, items will collapse -->\n<mds-horizontal-scroll>\n <mds-card>...</mds-card>\n <mds-card>...</mds-card>\n</mds-horizontal-scroll>\n\n<!-- CORRECT: each card has a declared minimum width -->\n<mds-horizontal-scroll>\n <mds-card class=\"min-w-[320px]\">...</mds-card>\n <mds-card class=\"min-w-[320px]\">...</mds-card>\n</mds-horizontal-scroll>\n```\n"
28
32
  },
29
33
  "props": [
30
34
  {
@@ -203,52 +207,68 @@
203
207
  {
204
208
  "name": "--mds-horizontal-scroll-behavior",
205
209
  "annotation": "prop",
206
- "docs": "Sets the scroll-behavior animation"
210
+ "docs": "Sets the scroll-behavior animation",
211
+ "visibility": "internal"
212
+ },
213
+ {
214
+ "name": "--mds-horizontal-scroll-controls-margin",
215
+ "annotation": "prop",
216
+ "docs": "Sets how far the back and forward controls sit outside the area of the slotted elements, 48px by default; `0px` keeps them on its edges",
217
+ "visibility": "public"
207
218
  },
208
219
  {
209
220
  "name": "--mds-horizontal-scroll-dot-area-background",
210
221
  "annotation": "prop",
211
- "docs": "Sets the dot container area color"
222
+ "docs": "Sets the dot container area color",
223
+ "visibility": "internal"
212
224
  },
213
225
  {
214
226
  "name": "--mds-horizontal-scroll-dot-background",
215
227
  "annotation": "prop",
216
- "docs": "Sets the navigation dot color"
228
+ "docs": "Sets the navigation dot color",
229
+ "visibility": "internal"
217
230
  },
218
231
  {
219
232
  "name": "--mds-horizontal-scroll-dot-max-width",
220
233
  "annotation": "prop",
221
- "docs": "Sets the navigation dot max-width, if you want to avoid is scales in proportion of the container"
234
+ "docs": "Sets the navigation dot max-width, if you want to avoid is scales in proportion of the container",
235
+ "visibility": "internal"
222
236
  },
223
237
  {
224
238
  "name": "--mds-horizontal-scroll-max-width",
225
239
  "annotation": "prop",
226
- "docs": "Sets the max-width of the slotted elements container, to keep layout limited as the rest of the sections"
240
+ "docs": "Sets the max-width of the slotted elements container, to keep layout limited as the rest of the sections",
241
+ "visibility": "public"
227
242
  },
228
243
  {
229
244
  "name": "--mds-horizontal-scroll-scrollbar-margin",
230
245
  "annotation": "prop",
231
- "docs": "Sets the margin of the browser scroll bar (if supported)"
246
+ "docs": "Sets the margin of the browser scroll bar (if supported)",
247
+ "visibility": "internal"
232
248
  },
233
249
  {
234
250
  "name": "--mds-horizontal-scroll-scrollbar-radius",
235
251
  "annotation": "prop",
236
- "docs": "Sets the border-radius of the browser scroll bar (if supported)"
252
+ "docs": "Sets the border-radius of the browser scroll bar (if supported)",
253
+ "visibility": "internal"
237
254
  },
238
255
  {
239
256
  "name": "--mds-horizontal-scroll-scrollbar-size",
240
257
  "annotation": "prop",
241
- "docs": "Sets the height and width of the browser scroll bar (if supported)"
258
+ "docs": "Sets the height and width of the browser scroll bar (if supported)",
259
+ "visibility": "internal"
242
260
  },
243
261
  {
244
262
  "name": "--mds-horizontal-scroll-scrollbar-thumb-background",
245
263
  "annotation": "prop",
246
- "docs": "Sets the background-color of the browser scroll bar thumb (if supported)"
264
+ "docs": "Sets the background-color of the browser scroll bar thumb (if supported)",
265
+ "visibility": "internal"
247
266
  },
248
267
  {
249
268
  "name": "--mds-horizontal-scroll-scrollbar-track-background",
250
269
  "annotation": "prop",
251
- "docs": "Sets the background-color of the browser scroll bar track (if supported)"
270
+ "docs": "Sets the background-color of the browser scroll bar track (if supported)",
271
+ "visibility": "internal"
252
272
  }
253
273
  ],
254
274
  "slots": [
@@ -12,10 +12,11 @@ mds-button {
12
12
 
13
13
  /**
14
14
  * @prop --mds-horizontal-scroll-behavior: Sets the scroll-behavior animation
15
+ * @prop --mds-horizontal-scroll-controls-margin: Public. Sets how far the back and forward controls sit outside the area of the slotted elements, 48px by default; `0px` keeps them on its edges
15
16
  * @prop --mds-horizontal-scroll-dot-area-background: Sets the dot container area color
16
17
  * @prop --mds-horizontal-scroll-dot-background: Sets the navigation dot color
17
18
  * @prop --mds-horizontal-scroll-dot-max-width: Sets the navigation dot max-width, if you want to avoid is scales in proportion of the container
18
- * @prop --mds-horizontal-scroll-max-width: Sets the max-width of the slotted elements container, to keep layout limited as the rest of the sections
19
+ * @prop --mds-horizontal-scroll-max-width: Public. Sets the max-width of the slotted elements container, to keep layout limited as the rest of the sections
19
20
  * @prop --mds-horizontal-scroll-scrollbar-margin: Sets the margin of the browser scroll bar (if supported)
20
21
  * @prop --mds-horizontal-scroll-scrollbar-radius: Sets the border-radius of the browser scroll bar (if supported)
21
22
  * @prop --mds-horizontal-scroll-scrollbar-size: Sets the height and width of the browser scroll bar (if supported)
@@ -13,6 +13,7 @@ import localeIt from "./meta/locale.it.json";
13
13
  /**
14
14
  * @slot - Add `text string`, `HTML elements` or `components` to this slot.
15
15
  * @part content - The track that scrolls, with the default slot inside
16
+ * @category structure
16
17
  */
17
18
  export class MdsHorizontalScroll {
18
19
  constructor() {
@@ -213,7 +214,7 @@ export class MdsHorizontalScroll {
213
214
  this.contents.removeEventListener('scroll', this.translateNavigationDot);
214
215
  }
215
216
  render() {
216
- return (h(Host, { key: 'bb197703381bbaecb64eab3f29593f9381bd1385' }, h("div", { key: '22e98fe39199fd5deaa4bdcd8824e623a887ba3d', class: "contents", part: "content" }, h("div", { key: 'cf59c7a2cc662169210b4a8a194d44cc7dfdcfbf', class: "spacer" }), h("slot", { key: '8266dfb68782c91333e363466a510f490008c95c', onSlotchange: this.updateElements }), h("div", { key: 'afc6023087ab16e70809a8620c18ce1973cac4da', class: "spacer" })), h("div", { key: '0a0eefae9e8687fe0d6dff4211e8080a17e34a22', class: "dot-navigation" }, h("div", { key: 'f8a3de1f76682463f5e2866bb1d33a4f71c2fbba', class: "dot" })), this.controls && this.controls !== 'none' && (h("mds-button", { key: '523bccf4a013e00913bc53fe5cd2bb79740aafd9', "aria-label": this.t.get('scrollBack'), onClick: this.moveBack, size: "lg", class: clsx('navigation navigation--back', !this.showBack && 'navigation--disabled'), icon: miBaselineArrowBack })), this.controls && this.controls !== 'none' && (h("mds-button", { key: '08ec20003cfaf33bcb3aebdd8b34577fa9956de0', "aria-label": this.t.get('scrollForward'), onClick: this.moveForward, size: "lg", class: clsx('navigation navigation--forward', !this.showForward && 'navigation--disabled'), icon: miBaselineArrowForward }))));
217
+ return (h(Host, { key: '68da4cda41b6fa8cca243e6b737a368cc029fbb7' }, h("div", { key: '9120b25ec1ce39bd2a61d578917d4344965887bd', class: "contents", part: "content" }, h("div", { key: 'e57a250642b4f25884f88e07e1a067e26463c856', class: "spacer" }), h("slot", { key: '690151dfb5b20f01a4b980c9f237b27c1bb3ed4a', onSlotchange: this.updateElements }), h("div", { key: 'e7f2d20b334008306c5b18c1b4dce66fa80796e7', class: "spacer" })), h("div", { key: '771369a5b8ba5ded81998881633f57b8d2cf1b34', class: "dot-navigation" }, h("div", { key: '89a843eb0b8c2d1da2061a21a7adcfc59169d9b9', class: "dot" })), this.controls && this.controls !== 'none' && (h("mds-button", { key: 'eb47346f7aea7f156989718d3420ff319c2ec461', "aria-label": this.t.get('scrollBack'), onClick: this.moveBack, size: "lg", class: clsx('navigation navigation--back', !this.showBack && 'navigation--disabled'), icon: miBaselineArrowBack })), this.controls && this.controls !== 'none' && (h("mds-button", { key: '5df62f7c42e1c200b7355b4422bafa576b967db3', "aria-label": this.t.get('scrollForward'), onClick: this.moveForward, size: "lg", class: clsx('navigation navigation--forward', !this.showForward && 'navigation--disabled'), icon: miBaselineArrowForward }))));
217
218
  }
218
219
  static get is() { return "mds-horizontal-scroll"; }
219
220
  static get encapsulation() { return "shadow"; }
@@ -101,7 +101,7 @@ Pair `controls="all"` with `snap="center"` and `navigation="position"` to produc
101
101
  <mds-horizontal-scroll controls="all" snap="center" navigation="position">
102
102
  <mds-card class="min-w-[280px]">
103
103
  <mds-card-media>
104
- <mds-img src="https://example.com/img1.jpg"></mds-img>
104
+ <mds-img src="https://example.com/img1.jpg" alt=""></mds-img>
105
105
  </mds-card-media>
106
106
  <mds-card-content>
107
107
  <mds-text typography="h5">Categoria A</mds-text>
@@ -109,7 +109,7 @@ Pair `controls="all"` with `snap="center"` and `navigation="position"` to produc
109
109
  </mds-card>
110
110
  <mds-card class="min-w-[280px]">
111
111
  <mds-card-media>
112
- <mds-img src="https://example.com/img2.jpg"></mds-img>
112
+ <mds-img src="https://example.com/img2.jpg" alt=""></mds-img>
113
113
  </mds-card-media>
114
114
  <mds-card-content>
115
115
  <mds-text typography="h5">Categoria B</mds-text>
@@ -120,28 +120,17 @@ Pair `controls="all"` with `snap="center"` and `navigation="position"` to produc
120
120
 
121
121
  #### Styling Customization
122
122
 
123
- Style the component only through its documented `--mds-horizontal-scroll-*` 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 and high-contrast modes keep working.
123
+ Style the component only through its public `--mds-horizontal-scroll-*` CSS custom properties, which set its layout: the width of the items area and how far the controls sit outside it. Set them on the host or a parent selector. The dot indicator and the controls take their colours from the semantic roles, so they follow dark mode without overrides.
124
124
 
125
125
  ```css
126
126
  .sezione-evidenza mds-horizontal-scroll {
127
- --mds-horizontal-scroll-dot-background: rgb(var(--magma-accent-emphasis));
128
- --mds-horizontal-scroll-dot-area-background: rgb(var(--magma-accent-surface-hover));
129
127
  --mds-horizontal-scroll-max-width: 1200px;
130
128
  }
131
129
  ```
132
130
 
133
131
  #### Styling the Scrollbar
134
132
 
135
- When `navigation="scrollbar"` is used, customize the native scrollbar appearance through the dedicated properties. All scrollbar props are browser-dependent and may have no effect on browsers that do not expose a styleable scrollbar.
136
-
137
- ```css
138
- mds-horizontal-scroll {
139
- --mds-horizontal-scroll-scrollbar-size: 6px;
140
- --mds-horizontal-scroll-scrollbar-radius: var(--magma-radius-3xs);
141
- --mds-horizontal-scroll-scrollbar-thumb-background: rgb(var(--magma-accent-emphasis));
142
- --mds-horizontal-scroll-scrollbar-track-background: rgb(var(--magma-wash-strong));
143
- }
144
- ```
133
+ When `navigation="scrollbar"` is used, the component styles the native scrollbar itself, from the semantic color roles, so it follows dark mode; its size and colours have no public custom property. When the scrollbar does not suit the layout, pick another affordance with `navigation` instead of restyling it.
145
134
 
146
135
  #### Customizing the Content Part
147
136
 
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-hr
8
8
 
9
- > `@maggioli-design-system/magma` 2.5.0. Shadow DOM: style it only through the CSS custom properties and parts below.
9
+ > `@maggioli-design-system/magma` 2.6.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
10
10
 
11
11
  The `<mds-hr>` web component is the horizontal rule of the Magma Design System. It is a purely presentational separator that replaces the native `<hr>` element, rendering a thin themed divider line to split content into visual sections.
12
12
 
@@ -1,5 +1,5 @@
1
1
  {
2
- "timestamp": "2026-10-21T16:53:07",
2
+ "timestamp": "2026-10-24T12:14:05",
3
3
  "compiler": {
4
4
  "name": "@stencil/core",
5
5
  "version": "4.45.2",
@@ -11,7 +11,12 @@
11
11
  "encapsulation": "shadow",
12
12
  "tag": "mds-hr",
13
13
  "docs": "This is a web-component from Maggioli Design System [Magma](https://magma.maggiolicloud.it), built with StencilJS, TypeScript, Storybook. It's based on the web-component standard and it's designed to be agnostic from the JavaScript framework you are using.",
14
- "docsTags": [],
14
+ "docsTags": [
15
+ {
16
+ "name": "category",
17
+ "text": "structure"
18
+ }
19
+ ],
15
20
  "usage": {
16
21
  "1. Description": "The `<mds-hr>` web component is the horizontal rule of the Magma Design System. It is a purely presentational separator that replaces the native `<hr>` element, rendering a thin themed divider line to split content into visual sections.\n\n#### Semantic Behavior\n\n- **No interactivity**: The component has no props, slots, events, or state; it is decorative and takes no part in focus order, form association, or keyboard interaction.\n- **Full-width line**: It always spans the full inline width of its container and is sized purely by layout context.\n- **Theme-aware color**: The rule is painted with the `wash-strong` neutral role and adapts automatically between light and dark preference themes, so it stays legible without configuration.\n\n#### Properties & Visual Configurations\n\n`<mds-hr>` exposes no props. Visual variation is achieved entirely through standard utility classes on the host - for example overriding the background color with a semantic color utility (`class=\"bg-border-default\"`) - rather than through component-specific attributes.\n",
17
22
  "2. Pattern": "Correct and idiomatic ways to use the `<mds-hr>` component, ordered from most common to most specialized. Patterns assume a working knowledge of the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Default Divider\n\nThe simplest use - no attributes required. Drop it between content blocks to draw a full-width neutral rule that adapts automatically to light and dark themes.\n\n```html\n<section>\n <mds-text typography=\"h4\">Dati personali</mds-text>\n <mds-text typography=\"paragraph\">Nome, cognome e data di nascita.</mds-text>\n</section>\n\n<mds-hr></mds-hr>\n\n<section>\n <mds-text typography=\"h4\">Dati di contatto</mds-text>\n <mds-text typography=\"paragraph\">Indirizzo e-mail e numero di telefono.</mds-text>\n</section>\n```\n\n#### Divider Inside a Card\n\nUse `<mds-hr>` to split regions inside a compound component such as `<mds-card>`. It stretches to the full width of its parent slot, so no extra sizing is needed.\n\n```html\n<mds-card>\n <mds-card-header slot=\"header\">\n <mds-text typography=\"h6\">Riepilogo ordine</mds-text>\n </mds-card-header>\n <mds-card-content slot=\"content\">\n <mds-text typography=\"paragraph\">Articolo 1 - Servizio annuale</mds-text>\n <mds-hr></mds-hr>\n <mds-text typography=\"paragraph\">Articolo 2 - Supporto prioritario</mds-text>\n </mds-card-content>\n</mds-card>\n```\n\n#### Color Tint via Utility Class\n\n`<mds-hr>` exposes no CSS custom properties. To change the line color, apply a semantic color utility class (`bg-<role>`) directly on the host element. Use `rgb(var(--magma-<role>))` values in CSS only when no matching utility class exists.\n\n```html\n<!-- Stronger neutral rule -->\n<mds-hr class=\"bg-border-default\"></mds-hr>\n\n<!-- Branded primary tint -->\n<mds-hr class=\"bg-accent-border\"></mds-hr>\n```\n\n#### Divider Inside a Form\n\nUse `<mds-hr>` to visually group related form fields without adding semantic structure (use `<fieldset>` for the semantic grouping; `<mds-hr>` is purely presentational).\n\n```html\n<form>\n <mds-input-field label=\"Nome\">\n <mds-input name=\"nome\"></mds-input>\n </mds-input-field>\n <mds-input-field label=\"Cognome\">\n <mds-input name=\"cognome\"></mds-input>\n </mds-input-field>\n\n <mds-hr></mds-hr>\n\n <mds-input-field label=\"E-mail\">\n <mds-input name=\"email\" type=\"email\"></mds-input>\n </mds-input-field>\n</form>\n```\n\n#### Width Constraint via Parent Layout\n\n`<mds-hr>` always fills `width: 100%` of its container. To produce an inset or centered rule, constrain it through the parent's padding or a wrapping element - do not apply `width` inline on the component itself.\n\n```html\n<div style=\"padding-inline: 2rem;\">\n <mds-hr></mds-hr>\n</div>\n```\n",
@@ -1,8 +1,11 @@
1
1
  import { Host, h } from "@stencil/core";
2
2
  import { preferenceStore } from "../../common/preference";
3
+ /**
4
+ * @category structure
5
+ */
3
6
  export class MdsHr {
4
7
  render() {
5
- return (h(Host, { key: '24837c75a65334f2219553e2f170001469da4e5a', "pref-mode": preferenceStore.state.mode, "pref-theme-scheme": preferenceStore.state['theme-scheme'] }));
8
+ return (h(Host, { key: 'f37b5fd798efd5855bb821435527e712ef4e9d5e', "pref-mode": preferenceStore.state.mode, "pref-theme-scheme": preferenceStore.state['theme-scheme'] }));
6
9
  }
7
10
  static get is() { return "mds-hr"; }
8
11
  static get encapsulation() { return "shadow"; }
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-icon
8
8
 
9
- > `@maggioli-design-system/magma` 2.5.0. Shadow DOM: style it only through the CSS custom properties and parts below.
9
+ > `@maggioli-design-system/magma` 2.6.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
10
10
 
11
11
  The `<mds-icon>` web component is the single glyph primitive of the Magma Design System: it inlines an SVG into the DOM so the artwork inherits color and sizing from CSS, and it is the building block that nearly every other component (button, chip, input, banner, list-item, etc.) composes to render its iconography. It replaces a raw `<img>`/`<svg>` tag and centralizes how icon artwork is resolved.
12
12
 
@@ -1,5 +1,5 @@
1
1
  {
2
- "timestamp": "2026-10-21T16:53:07",
2
+ "timestamp": "2026-10-24T12:14:05",
3
3
  "compiler": {
4
4
  "name": "@stencil/core",
5
5
  "version": "4.45.2",
@@ -15,6 +15,10 @@
15
15
  {
16
16
  "name": "part",
17
17
  "text": "svg - The svg container of the icon"
18
+ },
19
+ {
20
+ "name": "category",
21
+ "text": "content"
18
22
  }
19
23
  ],
20
24
  "usage": {
@@ -3,6 +3,7 @@ import { IconsSetService } from "./services/icons-set.service";
3
3
  import { isIconFormatIsBase64, isIconFormatIsSVG, BASE64_SVG_ICON } from "../../common/icon";
4
4
  /**
5
5
  * @part svg - The svg container of the icon
6
+ * @category content
6
7
  */
7
8
  export class MdsIcon {
8
9
  constructor() {
@@ -73,7 +74,7 @@ export class MdsIcon {
73
74
  }
74
75
  }
75
76
  render() {
76
- return (h(Host, { key: 'b7f622f4c93eff897cb5d67ac548dbcdce59d022' }, this.svgHTML && h("i", { key: 'be836db7e275c2a072ac72cb0f70b19a448765c3', "aria-hidden": "true", class: "icon", part: "svg", innerHTML: this.svgHTML })));
77
+ return (h(Host, { key: 'cad78449760538aff33f53ecaadc71193d7fdbb8' }, this.svgHTML && h("i", { key: '5cebc9a01a40ce5cfba4508932bf2d270f061327', "aria-hidden": "true", class: "icon", part: "svg", innerHTML: this.svgHTML })));
77
78
  }
78
79
  static get is() { return "mds-icon"; }
79
80
  static get encapsulation() { return "shadow"; }
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-img
8
8
 
9
- > `@maggioli-design-system/magma` 2.5.0. Shadow DOM: style it only through the CSS custom properties and parts below.
9
+ > `@maggioli-design-system/magma` 2.6.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
10
10
 
11
11
  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.
12
12
 
@@ -67,10 +67,8 @@ Most props are pass-throughs to the native image attributes of the same name (`s
67
67
  | --- | --- |
68
68
  | `--mds-img-background` | The background color of the image container. |
69
69
  | `--mds-img-color` | The foreground/text color used inside the image component. |
70
- | `--mds-img-error-background` | The background color shown when the image fails to load. |
71
- | `--mds-img-error-color` | The text or foreground color shown in the error state. |
72
- | `--mds-img-error-icon-color` | The icon color used in the error state. |
73
- | `--mds-img-icon-color` | The color applied to icons displayed within the image element. |
70
+
71
+ Only these are public. Its other 4 are internal: they may change in any release, do not set them.
74
72
 
75
73
  ## Dependencies
76
74
 
@@ -73,7 +73,7 @@ Each entry in `srcset-consumption` must end with `low`, `medium`, or `high`. Ent
73
73
 
74
74
  #### Do Not Pierce the Shadow DOM to Style the Inner `<img>`
75
75
 
76
- Targeting internal selectors with `>>>`, `/deep/`, or undocumented class names couples your code to the shadow DOM structure and will break on minor releases. Use `--mds-img-*` CSS custom properties for color theming, and the documented `::part(media)` for geometry/object-fit overrides.
76
+ Targeting 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.
77
77
 
78
78
  ```css
79
79
  /* INCORRECT */
@@ -1,5 +1,5 @@
1
1
  {
2
- "timestamp": "2026-10-21T16:53:07",
2
+ "timestamp": "2026-10-24T12:14:05",
3
3
  "compiler": {
4
4
  "name": "@stencil/core",
5
5
  "version": "4.45.2",
@@ -15,12 +15,16 @@
15
15
  {
16
16
  "name": "part",
17
17
  "text": "media - The native `<img>` that shows the picture"
18
+ },
19
+ {
20
+ "name": "category",
21
+ "text": "content"
18
22
  }
19
23
  ],
20
24
  "usage": {
21
25
  "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",
22
- "2. Pattern": "Correct and idiomatic ways to use the `<mds-img>` component, ordered from most common to most specialized. Patterns assume a working knowledge of the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Basic 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 documented `--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 --mds-img-icon-color: rgb(var(--magma-accent-border));\n --mds-img-error-background: rgb(var(--magma-danger-wash-base));\n --mds-img-error-color: rgb(var(--magma-danger-fg));\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",
23
- "3. Antipattern": "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/anti-patterns.md`](../../../../agents/anti-patterns.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 `--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"
26
+ "2. Pattern": "Correct and idiomatic ways to use the `<mds-img>` component, ordered from most common to most specialized. Patterns assume a working knowledge of the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Basic 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",
27
+ "3. Antipattern": "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/anti-patterns.md`](../../../../agents/anti-patterns.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"
24
28
  },
25
29
  "props": [
26
30
  {
@@ -400,32 +404,38 @@
400
404
  {
401
405
  "name": "--mds-img-background",
402
406
  "annotation": "prop",
403
- "docs": "The background color of the image container."
407
+ "docs": "The background color of the image container.",
408
+ "visibility": "public"
404
409
  },
405
410
  {
406
411
  "name": "--mds-img-color",
407
412
  "annotation": "prop",
408
- "docs": "The foreground/text color used inside the image component."
413
+ "docs": "The foreground/text color used inside the image component.",
414
+ "visibility": "public"
409
415
  },
410
416
  {
411
417
  "name": "--mds-img-error-background",
412
418
  "annotation": "prop",
413
- "docs": "The background color shown when the image fails to load."
419
+ "docs": "The background color shown when the image fails to load.",
420
+ "visibility": "internal"
414
421
  },
415
422
  {
416
423
  "name": "--mds-img-error-color",
417
424
  "annotation": "prop",
418
- "docs": "The text or foreground color shown in the error state."
425
+ "docs": "The text or foreground color shown in the error state.",
426
+ "visibility": "internal"
419
427
  },
420
428
  {
421
429
  "name": "--mds-img-error-icon-color",
422
430
  "annotation": "prop",
423
- "docs": "The icon color used in the error state."
431
+ "docs": "The icon color used in the error state.",
432
+ "visibility": "internal"
424
433
  },
425
434
  {
426
435
  "name": "--mds-img-icon-color",
427
436
  "annotation": "prop",
428
- "docs": "The color applied to icons displayed within the image element."
437
+ "docs": "The color applied to icons displayed within the image element.",
438
+ "visibility": "internal"
429
439
  }
430
440
  ],
431
441
  "slots": [],
@@ -13,8 +13,8 @@ mds-text {
13
13
 
14
14
 
15
15
  /**
16
- * @prop --mds-img-background: The background color of the image container.
17
- * @prop --mds-img-color: The foreground/text color used inside the image component.
16
+ * @prop --mds-img-background: Public. The background color of the image container.
17
+ * @prop --mds-img-color: Public. The foreground/text color used inside the image component.
18
18
  * @prop --mds-img-icon-color: The color applied to icons displayed within the image element.
19
19
  * @prop --mds-img-error-background: The background color shown when the image fails to load.
20
20
  * @prop --mds-img-error-color: The text or foreground color shown in the error state.
@@ -9,6 +9,7 @@ import localeEs from "./meta/locale.es.json";
9
9
  import localeIt from "./meta/locale.it.json";
10
10
  /**
11
11
  * @part media - The native `<img>` that shows the picture
12
+ * @category content
12
13
  */
13
14
  export class MdsImg {
14
15
  constructor() {
@@ -104,15 +104,12 @@ Set `width` and `height` (as string pixel values) to reserve layout space and pr
104
104
 
105
105
  #### Styling Customization
106
106
 
107
- Style the component through its documented `--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.
107
+ Style 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.
108
108
 
109
109
  ```css
110
110
  .card-copertina mds-img {
111
111
  --mds-img-background: rgb(var(--magma-accent-emphasis-hover));
112
112
  --mds-img-color: rgb(var(--magma-accent-surface));
113
- --mds-img-icon-color: rgb(var(--magma-accent-border));
114
- --mds-img-error-background: rgb(var(--magma-danger-wash-base));
115
- --mds-img-error-color: rgb(var(--magma-danger-fg));
116
113
  }
117
114
  ```
118
115