@maggioli-design-system/magma 2.5.1 → 2.7.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 (1485) hide show
  1. package/AGENTS.md +19 -4
  2. package/CHANGELOG.md +69 -0
  3. package/agents/assets.md +24 -10
  4. package/agents/color.md +22 -4
  5. package/agents/components.md +164 -92
  6. package/agents/conventions.md +19 -8
  7. package/agents/install.md +7 -0
  8. package/agents/lint.md +298 -0
  9. package/agents/mcp.md +107 -0
  10. package/agents/reporting.md +53 -2
  11. package/agents/theming.md +8 -0
  12. package/dist/cjs/index-BQNHYWJg.js +4 -0
  13. package/dist/cjs/loader.cjs.js +1 -1
  14. package/dist/cjs/magma-components.cjs.js +1 -1
  15. package/dist/cjs/mds-accordion-item.cjs.entry.js +1 -1
  16. package/dist/cjs/mds-accordion-timer-item.cjs.entry.js +1 -1
  17. package/dist/cjs/mds-accordion-timer.cjs.entry.js +1 -1
  18. package/dist/cjs/mds-accordion.cjs.entry.js +1 -1
  19. package/dist/cjs/mds-author.cjs.entry.js +1 -1
  20. package/dist/cjs/mds-avatar-stack-item.cjs.entry.js +1 -1
  21. package/dist/cjs/mds-avatar-stack.cjs.entry.js +1 -1
  22. package/dist/cjs/mds-avatar.cjs.entry.js +1 -1
  23. package/dist/cjs/mds-badge.cjs.entry.js +1 -1
  24. package/dist/cjs/mds-banner_3.cjs.entry.js +3 -3
  25. package/dist/cjs/mds-benchmark-bar.cjs.entry.js +1 -1
  26. package/dist/cjs/mds-bibliography.cjs.entry.js +1 -1
  27. package/dist/cjs/mds-book.cjs.entry.js +703 -0
  28. package/dist/cjs/mds-breadcrumb-item.cjs.entry.js +1 -1
  29. package/dist/cjs/mds-breadcrumb.cjs.entry.js +1 -1
  30. package/dist/cjs/mds-button-dropdown.cjs.entry.js +1 -1
  31. package/dist/cjs/mds-button-group.cjs.entry.js +1 -1
  32. package/dist/cjs/mds-button_3.cjs.entry.js +6 -6
  33. package/dist/cjs/mds-calendar_2.cjs.entry.js +6 -6
  34. package/dist/cjs/mds-card-content.cjs.entry.js +1 -1
  35. package/dist/cjs/mds-card-footer.cjs.entry.js +1 -1
  36. package/dist/cjs/mds-card-header.cjs.entry.js +1 -1
  37. package/dist/cjs/mds-card-media.cjs.entry.js +1 -1
  38. package/dist/cjs/mds-card.cjs.entry.js +1 -1
  39. package/dist/cjs/mds-details.cjs.entry.js +1 -1
  40. package/dist/cjs/mds-dropdown.cjs.entry.js +2 -2
  41. package/dist/cjs/mds-emoji.cjs.entry.js +1 -1
  42. package/dist/cjs/mds-entity.cjs.entry.js +1 -1
  43. package/dist/cjs/mds-file-preview.cjs.entry.js +2 -2
  44. package/dist/cjs/mds-file.cjs.entry.js +1 -1
  45. package/dist/cjs/mds-filter-item.cjs.entry.js +1 -1
  46. package/dist/cjs/mds-filter.cjs.entry.js +1 -1
  47. package/dist/cjs/mds-header-bar.cjs.entry.js +1 -1
  48. package/dist/cjs/mds-header.cjs.entry.js +2 -2
  49. package/dist/cjs/mds-horizontal-scroll.cjs.entry.js +1 -1
  50. package/dist/cjs/mds-hr.cjs.entry.js +1 -1
  51. package/dist/cjs/mds-input-date-range-preselection.cjs.entry.js +1 -1
  52. package/dist/cjs/mds-input-date-range.cjs.entry.js +2 -2
  53. package/dist/cjs/mds-input-date.cjs.entry.js +2 -2
  54. package/dist/cjs/mds-input-field.cjs.entry.js +1 -1
  55. package/dist/cjs/mds-input-otp.cjs.entry.js +1 -1
  56. package/dist/cjs/mds-input-range.cjs.entry.js +1 -1
  57. package/dist/cjs/mds-input-select.cjs.entry.js +2 -2
  58. package/dist/cjs/mds-input-switch_2.cjs.entry.js +2 -2
  59. package/dist/cjs/mds-input-tip_2.cjs.entry.js +3 -3
  60. package/dist/cjs/mds-input-upload.cjs.entry.js +5 -5
  61. package/dist/cjs/mds-input.cjs.entry.js +2 -2
  62. package/dist/cjs/mds-keyboard-key.cjs.entry.js +2 -2
  63. package/dist/cjs/mds-keyboard.cjs.entry.js +2 -2
  64. package/dist/cjs/mds-kpi-item.cjs.entry.js +1 -1
  65. package/dist/cjs/mds-kpi.cjs.entry.js +1 -1
  66. package/dist/cjs/mds-label.cjs.entry.js +1 -1
  67. package/dist/cjs/mds-link.cjs.entry.js +3 -3
  68. package/dist/cjs/mds-list-item.cjs.entry.js +1 -1
  69. package/dist/cjs/mds-list.cjs.entry.js +1 -1
  70. package/dist/cjs/mds-mention.cjs.entry.js +1 -1
  71. package/dist/cjs/mds-modal.cjs.entry.js +3 -3
  72. package/dist/cjs/mds-note.cjs.entry.js +1 -1
  73. package/dist/cjs/mds-notification.cjs.entry.js +1 -1
  74. package/dist/cjs/mds-paginator-item.cjs.entry.js +1 -1
  75. package/dist/cjs/mds-paginator.cjs.entry.js +1 -1
  76. package/dist/cjs/mds-policy-ai.cjs.entry.js +1 -1
  77. package/dist/cjs/mds-pref-animation.cjs.entry.js +1 -1
  78. package/dist/cjs/mds-pref-consumption.cjs.entry.js +1 -1
  79. package/dist/cjs/mds-pref-contrast.cjs.entry.js +1 -1
  80. package/dist/cjs/mds-pref-language-item.cjs.entry.js +1 -1
  81. package/dist/cjs/mds-pref-language.cjs.entry.js +1 -1
  82. package/dist/cjs/mds-pref-mode.cjs.entry.js +1 -1
  83. package/dist/cjs/mds-pref-theme-item.cjs.entry.js +1 -1
  84. package/dist/cjs/mds-pref-theme.cjs.entry.js +1 -1
  85. package/dist/cjs/mds-pref.cjs.entry.js +1 -1
  86. package/dist/cjs/mds-price-table-features-cell.cjs.entry.js +1 -1
  87. package/dist/cjs/mds-price-table-features-row.cjs.entry.js +1 -1
  88. package/dist/cjs/mds-price-table-features.cjs.entry.js +1 -1
  89. package/dist/cjs/mds-price-table-header.cjs.entry.js +1 -1
  90. package/dist/cjs/mds-price-table-list-item.cjs.entry.js +1 -1
  91. package/dist/cjs/mds-price-table-list.cjs.entry.js +1 -1
  92. package/dist/cjs/mds-price-table.cjs.entry.js +1 -1
  93. package/dist/cjs/mds-progress_2.cjs.entry.js +2 -2
  94. package/dist/cjs/mds-push-notification-item.cjs.entry.js +2 -2
  95. package/dist/cjs/mds-push-notification.cjs.entry.js +2 -2
  96. package/dist/cjs/mds-quote.cjs.entry.js +1 -1
  97. package/dist/cjs/mds-radial-menu-item.cjs.entry.js +1 -1
  98. package/dist/cjs/mds-radial-menu.cjs.entry.js +1 -1
  99. package/dist/cjs/mds-separator.cjs.entry.js +1 -1
  100. package/dist/cjs/mds-status-bar.cjs.entry.js +1 -1
  101. package/dist/cjs/mds-stepper-bar-item.cjs.entry.js +1 -1
  102. package/dist/cjs/mds-stepper-bar.cjs.entry.js +1 -1
  103. package/dist/cjs/mds-tab-bar-item.cjs.entry.js +1 -1
  104. package/dist/cjs/mds-tab-bar.cjs.entry.js +1 -1
  105. package/dist/cjs/mds-tab_2.cjs.entry.js +4 -4
  106. package/dist/cjs/mds-table-body.cjs.entry.js +1 -1
  107. package/dist/cjs/mds-table-footer.cjs.entry.js +1 -1
  108. package/dist/cjs/mds-table-header-cell.cjs.entry.js +1 -1
  109. package/dist/cjs/mds-table-header.cjs.entry.js +1 -1
  110. package/dist/cjs/mds-table-row.cjs.entry.js +2 -2
  111. package/dist/cjs/mds-table.cjs.entry.js +1 -1
  112. package/dist/cjs/mds-text.cjs.entry.js +1 -1
  113. package/dist/cjs/mds-toast-region.cjs.entry.js +1 -1
  114. package/dist/cjs/mds-toast.cjs.entry.js +1 -1
  115. package/dist/cjs/mds-tooltip.cjs.entry.js +2 -2
  116. package/dist/cjs/mds-tree-item.cjs.entry.js +1 -1
  117. package/dist/cjs/mds-tree.cjs.entry.js +1 -1
  118. package/dist/cjs/mds-url-view.cjs.entry.js +1 -1
  119. package/dist/cjs/mds-usage.cjs.entry.js +1 -1
  120. package/dist/cjs/mds-video-wall.cjs.entry.js +1 -1
  121. package/dist/cjs/mds-zero.cjs.entry.js +1 -1
  122. package/dist/collection/collection-manifest.json +1 -0
  123. package/dist/collection/components/mds-accordion/AGENTS.md +3 -5
  124. package/dist/collection/components/mds-accordion/antipattern.md +1 -2
  125. package/dist/collection/components/mds-accordion/documentation.json +21 -10
  126. package/dist/collection/components/mds-accordion/mds-accordion.css +3 -3
  127. package/dist/collection/components/mds-accordion/mds-accordion.js +2 -1
  128. package/dist/collection/components/mds-accordion/pattern.md +1 -4
  129. package/dist/collection/components/mds-accordion-item/AGENTS.md +3 -7
  130. package/dist/collection/components/mds-accordion-item/documentation.json +20 -9
  131. package/dist/collection/components/mds-accordion-item/mds-accordion-item.css +1 -1
  132. package/dist/collection/components/mds-accordion-item/mds-accordion-item.js +2 -1
  133. package/dist/collection/components/mds-accordion-item/pattern.md +3 -5
  134. package/dist/collection/components/mds-accordion-timer/AGENTS.md +3 -5
  135. package/dist/collection/components/mds-accordion-timer/antipattern.md +5 -3
  136. package/dist/collection/components/mds-accordion-timer/documentation.json +17 -8
  137. package/dist/collection/components/mds-accordion-timer/mds-accordion-timer.css +1 -1
  138. package/dist/collection/components/mds-accordion-timer/mds-accordion-timer.js +2 -1
  139. package/dist/collection/components/mds-accordion-timer/pattern.md +6 -6
  140. package/dist/collection/components/mds-accordion-timer-item/AGENTS.md +3 -5
  141. package/dist/collection/components/mds-accordion-timer-item/antipattern.md +1 -2
  142. package/dist/collection/components/mds-accordion-timer-item/documentation.json +17 -8
  143. package/dist/collection/components/mds-accordion-timer-item/mds-accordion-timer-item.css +1 -1
  144. package/dist/collection/components/mds-accordion-timer-item/mds-accordion-timer-item.js +2 -1
  145. package/dist/collection/components/mds-accordion-timer-item/pattern.md +1 -5
  146. package/dist/collection/components/mds-author/AGENTS.md +1 -1
  147. package/dist/collection/components/mds-author/documentation.json +5 -1
  148. package/dist/collection/components/mds-author/mds-author.js +2 -1
  149. package/dist/collection/components/mds-avatar/AGENTS.md +3 -3
  150. package/dist/collection/components/mds-avatar/antipattern.md +1 -1
  151. package/dist/collection/components/mds-avatar/documentation.json +17 -8
  152. package/dist/collection/components/mds-avatar/mds-avatar.css +3 -3
  153. package/dist/collection/components/mds-avatar/mds-avatar.js +2 -1
  154. package/dist/collection/components/mds-avatar/pattern.md +1 -2
  155. package/dist/collection/components/mds-avatar-stack/AGENTS.md +3 -12
  156. package/dist/collection/components/mds-avatar-stack/antipattern.md +1 -2
  157. package/dist/collection/components/mds-avatar-stack/documentation.json +31 -15
  158. package/dist/collection/components/mds-avatar-stack/mds-avatar-stack.css +1 -1
  159. package/dist/collection/components/mds-avatar-stack/mds-avatar-stack.js +2 -1
  160. package/dist/collection/components/mds-avatar-stack/pattern.md +2 -5
  161. package/dist/collection/components/mds-avatar-stack-item/AGENTS.md +3 -6
  162. package/dist/collection/components/mds-avatar-stack-item/documentation.json +22 -10
  163. package/dist/collection/components/mds-avatar-stack-item/mds-avatar-stack-item.css +2 -2
  164. package/dist/collection/components/mds-avatar-stack-item/mds-avatar-stack-item.js +4 -1
  165. package/dist/collection/components/mds-avatar-stack-item/pattern.md +4 -5
  166. package/dist/collection/components/mds-badge/AGENTS.md +3 -3
  167. package/dist/collection/components/mds-badge/antipattern.md +1 -1
  168. package/dist/collection/components/mds-badge/documentation.json +17 -8
  169. package/dist/collection/components/mds-badge/mds-badge.css +3 -3
  170. package/dist/collection/components/mds-badge/mds-badge.js +2 -1
  171. package/dist/collection/components/mds-badge/pattern.md +4 -7
  172. package/dist/collection/components/mds-banner/AGENTS.md +3 -8
  173. package/dist/collection/components/mds-banner/antipattern.md +1 -2
  174. package/dist/collection/components/mds-banner/documentation.json +29 -14
  175. package/dist/collection/components/mds-banner/mds-banner.css +4 -4
  176. package/dist/collection/components/mds-banner/mds-banner.js +2 -1
  177. package/dist/collection/components/mds-banner/pattern.md +1 -2
  178. package/dist/collection/components/mds-benchmark-bar/AGENTS.md +1 -1
  179. package/dist/collection/components/mds-benchmark-bar/documentation.json +5 -1
  180. package/dist/collection/components/mds-benchmark-bar/mds-benchmark-bar.js +2 -1
  181. package/dist/collection/components/mds-bibliography/AGENTS.md +3 -3
  182. package/dist/collection/components/mds-bibliography/antipattern.md +1 -3
  183. package/dist/collection/components/mds-bibliography/documentation.json +15 -7
  184. package/dist/collection/components/mds-bibliography/mds-bibliography.css +1 -1
  185. package/dist/collection/components/mds-bibliography/mds-bibliography.js +4 -1
  186. package/dist/collection/components/mds-bibliography/pattern.md +1 -3
  187. package/dist/collection/components/mds-book/AGENTS.md +79 -0
  188. package/dist/collection/components/mds-book/antipattern.md +88 -0
  189. package/dist/collection/components/mds-book/documentation.json +482 -0
  190. package/dist/collection/components/mds-book/mds-book.css +901 -0
  191. package/dist/collection/components/mds-book/mds-book.js +731 -0
  192. package/dist/collection/components/mds-book/meta/dictionary.js +5 -0
  193. package/dist/collection/components/mds-book/meta/format.js +57 -0
  194. package/dist/collection/components/mds-book/meta/pose.js +107 -0
  195. package/dist/collection/components/mds-book/meta/spine.js +61 -0
  196. package/dist/collection/components/mds-book/meta/types.js +1 -0
  197. package/dist/collection/components/mds-book/meta/volume.js +23 -0
  198. package/dist/collection/components/mds-book/pattern.md +111 -0
  199. package/dist/collection/components/mds-breadcrumb/AGENTS.md +3 -14
  200. package/dist/collection/components/mds-breadcrumb/antipattern.md +1 -1
  201. package/dist/collection/components/mds-breadcrumb/documentation.json +28 -14
  202. package/dist/collection/components/mds-breadcrumb/mds-breadcrumb.js +2 -1
  203. package/dist/collection/components/mds-breadcrumb/pattern.md +6 -6
  204. package/dist/collection/components/mds-breadcrumb-item/AGENTS.md +3 -11
  205. package/dist/collection/components/mds-breadcrumb-item/antipattern.md +3 -3
  206. package/dist/collection/components/mds-breadcrumb-item/documentation.json +22 -11
  207. package/dist/collection/components/mds-breadcrumb-item/mds-breadcrumb-item.js +2 -1
  208. package/dist/collection/components/mds-breadcrumb-item/pattern.md +12 -14
  209. package/dist/collection/components/mds-button/AGENTS.md +3 -12
  210. package/dist/collection/components/mds-button/documentation.json +37 -17
  211. package/dist/collection/components/mds-button/mds-button.css +5 -5
  212. package/dist/collection/components/mds-button/mds-button.js +5 -4
  213. package/dist/collection/components/mds-button-dropdown/AGENTS.md +1 -1
  214. package/dist/collection/components/mds-button-dropdown/documentation.json +7 -2
  215. package/dist/collection/components/mds-button-dropdown/mds-button-dropdown.css +1 -1
  216. package/dist/collection/components/mds-button-dropdown/mds-button-dropdown.js +2 -1
  217. package/dist/collection/components/mds-button-group/AGENTS.md +1 -1
  218. package/dist/collection/components/mds-button-group/documentation.json +5 -1
  219. package/dist/collection/components/mds-button-group/mds-button-group.js +2 -1
  220. package/dist/collection/components/mds-calendar/AGENTS.md +3 -6
  221. package/dist/collection/components/mds-calendar/antipattern.md +1 -1
  222. package/dist/collection/components/mds-calendar/documentation.json +25 -12
  223. package/dist/collection/components/mds-calendar/mds-calendar.css +4 -4
  224. package/dist/collection/components/mds-calendar/mds-calendar.js +6 -5
  225. package/dist/collection/components/mds-calendar/pattern.md +1 -3
  226. package/dist/collection/components/mds-calendar-cell/AGENTS.md +3 -35
  227. package/dist/collection/components/mds-calendar-cell/antipattern.md +1 -2
  228. package/dist/collection/components/mds-calendar-cell/documentation.json +81 -40
  229. package/dist/collection/components/mds-calendar-cell/mds-calendar-cell.css +2 -2
  230. package/dist/collection/components/mds-calendar-cell/mds-calendar-cell.js +4 -1
  231. package/dist/collection/components/mds-calendar-cell/pattern.md +4 -5
  232. package/dist/collection/components/mds-card/AGENTS.md +1 -1
  233. package/dist/collection/components/mds-card/antipattern.md +2 -2
  234. package/dist/collection/components/mds-card/documentation.json +13 -6
  235. package/dist/collection/components/mds-card/mds-card.css +3 -3
  236. package/dist/collection/components/mds-card/mds-card.js +2 -1
  237. package/dist/collection/components/mds-card/pattern.md +4 -4
  238. package/dist/collection/components/mds-card-content/AGENTS.md +1 -1
  239. package/dist/collection/components/mds-card-content/documentation.json +5 -1
  240. package/dist/collection/components/mds-card-content/mds-card-content.js +2 -1
  241. package/dist/collection/components/mds-card-footer/AGENTS.md +1 -1
  242. package/dist/collection/components/mds-card-footer/documentation.json +5 -1
  243. package/dist/collection/components/mds-card-footer/mds-card-footer.js +2 -1
  244. package/dist/collection/components/mds-card-header/AGENTS.md +1 -1
  245. package/dist/collection/components/mds-card-header/documentation.json +5 -1
  246. package/dist/collection/components/mds-card-header/mds-card-header.js +2 -1
  247. package/dist/collection/components/mds-card-media/AGENTS.md +1 -1
  248. package/dist/collection/components/mds-card-media/documentation.json +5 -1
  249. package/dist/collection/components/mds-card-media/mds-card-media.js +2 -1
  250. package/dist/collection/components/mds-chip/AGENTS.md +3 -10
  251. package/dist/collection/components/mds-chip/antipattern.md +2 -3
  252. package/dist/collection/components/mds-chip/documentation.json +35 -17
  253. package/dist/collection/components/mds-chip/mds-chip.css +4 -4
  254. package/dist/collection/components/mds-chip/mds-chip.js +4 -1
  255. package/dist/collection/components/mds-chip/pattern.md +4 -6
  256. package/dist/collection/components/mds-details/AGENTS.md +3 -7
  257. package/dist/collection/components/mds-details/antipattern.md +1 -5
  258. package/dist/collection/components/mds-details/documentation.json +14 -7
  259. package/dist/collection/components/mds-details/mds-details.js +2 -1
  260. package/dist/collection/components/mds-details/pattern.md +4 -6
  261. package/dist/collection/components/mds-dropdown/AGENTS.md +3 -9
  262. package/dist/collection/components/mds-dropdown/antipattern.md +1 -1
  263. package/dist/collection/components/mds-dropdown/documentation.json +31 -15
  264. package/dist/collection/components/mds-dropdown/mds-dropdown.css +4 -4
  265. package/dist/collection/components/mds-dropdown/mds-dropdown.js +3 -2
  266. package/dist/collection/components/mds-dropdown/pattern.md +2 -4
  267. package/dist/collection/components/mds-emoji/AGENTS.md +8 -32
  268. package/dist/collection/components/mds-emoji/antipattern.md +0 -18
  269. package/dist/collection/components/mds-emoji/documentation.json +73 -35
  270. package/dist/collection/components/mds-emoji/mds-emoji.css +8 -4
  271. package/dist/collection/components/mds-emoji/mds-emoji.js +4 -1
  272. package/dist/collection/components/mds-emoji/pattern.md +9 -25
  273. package/dist/collection/components/mds-entity/AGENTS.md +3 -4
  274. package/dist/collection/components/mds-entity/antipattern.md +10 -3
  275. package/dist/collection/components/mds-entity/documentation.json +17 -8
  276. package/dist/collection/components/mds-entity/mds-entity.css +2 -2
  277. package/dist/collection/components/mds-entity/mds-entity.js +2 -1
  278. package/dist/collection/components/mds-entity/pattern.md +1 -4
  279. package/dist/collection/components/mds-file/AGENTS.md +3 -3
  280. package/dist/collection/components/mds-file/antipattern.md +2 -3
  281. package/dist/collection/components/mds-file/documentation.json +15 -7
  282. package/dist/collection/components/mds-file/mds-file.css +1 -1
  283. package/dist/collection/components/mds-file/mds-file.js +4 -1
  284. package/dist/collection/components/mds-file/pattern.md +1 -3
  285. package/dist/collection/components/mds-file-preview/AGENTS.md +3 -3
  286. package/dist/collection/components/mds-file-preview/antipattern.md +1 -1
  287. package/dist/collection/components/mds-file-preview/documentation.json +17 -8
  288. package/dist/collection/components/mds-file-preview/mds-file-preview.css +3 -3
  289. package/dist/collection/components/mds-file-preview/mds-file-preview.js +3 -2
  290. package/dist/collection/components/mds-file-preview/pattern.md +2 -3
  291. package/dist/collection/components/mds-filter/AGENTS.md +3 -8
  292. package/dist/collection/components/mds-filter/antipattern.md +2 -2
  293. package/dist/collection/components/mds-filter/documentation.json +27 -13
  294. package/dist/collection/components/mds-filter/mds-filter.css +3 -3
  295. package/dist/collection/components/mds-filter/mds-filter.js +2 -1
  296. package/dist/collection/components/mds-filter/pattern.md +2 -5
  297. package/dist/collection/components/mds-filter-item/AGENTS.md +2 -7
  298. package/dist/collection/components/mds-filter-item/antipattern.md +4 -4
  299. package/dist/collection/components/mds-filter-item/documentation.json +17 -8
  300. package/dist/collection/components/mds-filter-item/mds-filter-item.js +4 -1
  301. package/dist/collection/components/mds-filter-item/pattern.md +5 -7
  302. package/dist/collection/components/mds-header/AGENTS.md +4 -8
  303. package/dist/collection/components/mds-header/documentation.json +28 -13
  304. package/dist/collection/components/mds-header/mds-header.css +7 -7
  305. package/dist/collection/components/mds-header/mds-header.js +2 -1
  306. package/dist/collection/components/mds-header/pattern.md +1 -3
  307. package/dist/collection/components/mds-header-bar/AGENTS.md +2 -4
  308. package/dist/collection/components/mds-header-bar/antipattern.md +6 -8
  309. package/dist/collection/components/mds-header-bar/documentation.json +9 -4
  310. package/dist/collection/components/mds-header-bar/mds-header-bar.js +2 -1
  311. package/dist/collection/components/mds-header-bar/pattern.md +10 -6
  312. package/dist/collection/components/mds-help/AGENTS.md +1 -1
  313. package/dist/collection/components/mds-help/documentation.json +13 -5
  314. package/dist/collection/components/mds-help/mds-help.css +4 -4
  315. package/dist/collection/components/mds-help/mds-help.js +2 -1
  316. package/dist/collection/components/mds-horizontal-scroll/AGENTS.md +5 -11
  317. package/dist/collection/components/mds-horizontal-scroll/antipattern.md +2 -2
  318. package/dist/collection/components/mds-horizontal-scroll/documentation.json +34 -14
  319. package/dist/collection/components/mds-horizontal-scroll/mds-horizontal-scroll.css +2 -1
  320. package/dist/collection/components/mds-horizontal-scroll/mds-horizontal-scroll.js +2 -1
  321. package/dist/collection/components/mds-horizontal-scroll/pattern.md +4 -15
  322. package/dist/collection/components/mds-hr/AGENTS.md +1 -1
  323. package/dist/collection/components/mds-hr/documentation.json +7 -2
  324. package/dist/collection/components/mds-hr/mds-hr.js +4 -1
  325. package/dist/collection/components/mds-icon/AGENTS.md +1 -1
  326. package/dist/collection/components/mds-icon/documentation.json +5 -1
  327. package/dist/collection/components/mds-icon/mds-icon.js +2 -1
  328. package/dist/collection/components/mds-img/AGENTS.md +3 -5
  329. package/dist/collection/components/mds-img/antipattern.md +1 -1
  330. package/dist/collection/components/mds-img/documentation.json +19 -9
  331. package/dist/collection/components/mds-img/mds-img.css +2 -2
  332. package/dist/collection/components/mds-img/mds-img.js +1 -0
  333. package/dist/collection/components/mds-img/pattern.md +1 -4
  334. package/dist/collection/components/mds-input/AGENTS.md +3 -9
  335. package/dist/collection/components/mds-input/antipattern.md +1 -1
  336. package/dist/collection/components/mds-input/documentation.json +39 -19
  337. package/dist/collection/components/mds-input/mds-input.css +8 -8
  338. package/dist/collection/components/mds-input/mds-input.js +3 -2
  339. package/dist/collection/components/mds-input/pattern.md +1 -3
  340. package/dist/collection/components/mds-input-date/AGENTS.md +3 -8
  341. package/dist/collection/components/mds-input-date/antipattern.md +1 -1
  342. package/dist/collection/components/mds-input-date/documentation.json +31 -15
  343. package/dist/collection/components/mds-input-date/mds-input-date.css +5 -5
  344. package/dist/collection/components/mds-input-date/mds-input-date.js +3 -2
  345. package/dist/collection/components/mds-input-date/pattern.md +1 -2
  346. package/dist/collection/components/mds-input-date-range/AGENTS.md +3 -4
  347. package/dist/collection/components/mds-input-date-range/documentation.json +22 -10
  348. package/dist/collection/components/mds-input-date-range/mds-input-date-range.css +5 -5
  349. package/dist/collection/components/mds-input-date-range/mds-input-date-range.js +3 -2
  350. package/dist/collection/components/mds-input-date-range/pattern.md +1 -2
  351. package/dist/collection/components/mds-input-date-range-preselection/AGENTS.md +3 -13
  352. package/dist/collection/components/mds-input-date-range-preselection/antipattern.md +11 -6
  353. package/dist/collection/components/mds-input-date-range-preselection/documentation.json +26 -13
  354. package/dist/collection/components/mds-input-date-range-preselection/mds-input-date-range-preselection.js +2 -1
  355. package/dist/collection/components/mds-input-date-range-preselection/pattern.md +1 -11
  356. package/dist/collection/components/mds-input-field/AGENTS.md +1 -1
  357. package/dist/collection/components/mds-input-field/documentation.json +9 -3
  358. package/dist/collection/components/mds-input-field/mds-input-field.css +2 -2
  359. package/dist/collection/components/mds-input-field/mds-input-field.js +2 -1
  360. package/dist/collection/components/mds-input-otp/AGENTS.md +1 -1
  361. package/dist/collection/components/mds-input-otp/documentation.json +7 -2
  362. package/dist/collection/components/mds-input-otp/mds-input-otp.js +4 -1
  363. package/dist/collection/components/mds-input-range/AGENTS.md +3 -13
  364. package/dist/collection/components/mds-input-range/antipattern.md +1 -5
  365. package/dist/collection/components/mds-input-range/documentation.json +26 -13
  366. package/dist/collection/components/mds-input-range/mds-input-range.js +2 -1
  367. package/dist/collection/components/mds-input-range/pattern.md +2 -12
  368. package/dist/collection/components/mds-input-select/AGENTS.md +3 -7
  369. package/dist/collection/components/mds-input-select/antipattern.md +1 -1
  370. package/dist/collection/components/mds-input-select/documentation.json +25 -12
  371. package/dist/collection/components/mds-input-select/mds-input-select.css +3 -3
  372. package/dist/collection/components/mds-input-select/mds-input-select.js +3 -2
  373. package/dist/collection/components/mds-input-select/pattern.md +1 -3
  374. package/dist/collection/components/mds-input-switch/AGENTS.md +2 -30
  375. package/dist/collection/components/mds-input-switch/antipattern.md +5 -6
  376. package/dist/collection/components/mds-input-switch/documentation.json +61 -30
  377. package/dist/collection/components/mds-input-switch/mds-input-switch.js +2 -1
  378. package/dist/collection/components/mds-input-switch/pattern.md +2 -11
  379. package/dist/collection/components/mds-input-tip/AGENTS.md +3 -5
  380. package/dist/collection/components/mds-input-tip/antipattern.md +10 -6
  381. package/dist/collection/components/mds-input-tip/documentation.json +17 -8
  382. package/dist/collection/components/mds-input-tip/mds-input-tip.css +1 -1
  383. package/dist/collection/components/mds-input-tip/mds-input-tip.js +2 -1
  384. package/dist/collection/components/mds-input-tip/pattern.md +1 -4
  385. package/dist/collection/components/mds-input-tip-item/AGENTS.md +4 -3
  386. package/dist/collection/components/mds-input-tip-item/antipattern.md +2 -2
  387. package/dist/collection/components/mds-input-tip-item/documentation.json +14 -7
  388. package/dist/collection/components/mds-input-tip-item/mds-input-tip-item.css +2 -2
  389. package/dist/collection/components/mds-input-tip-item/mds-input-tip-item.js +3 -2
  390. package/dist/collection/components/mds-input-tip-item/pattern.md +1 -2
  391. package/dist/collection/components/mds-input-upload/AGENTS.md +3 -5
  392. package/dist/collection/components/mds-input-upload/antipattern.md +2 -3
  393. package/dist/collection/components/mds-input-upload/documentation.json +19 -9
  394. package/dist/collection/components/mds-input-upload/mds-input-upload.css +1 -1
  395. package/dist/collection/components/mds-input-upload/mds-input-upload.js +8 -5
  396. package/dist/collection/components/mds-input-upload/pattern.md +1 -5
  397. package/dist/collection/components/mds-keyboard/AGENTS.md +3 -18
  398. package/dist/collection/components/mds-keyboard/antipattern.md +3 -3
  399. package/dist/collection/components/mds-keyboard/documentation.json +47 -23
  400. package/dist/collection/components/mds-keyboard/mds-keyboard.css +17 -5
  401. package/dist/collection/components/mds-keyboard/mds-keyboard.js +2 -1
  402. package/dist/collection/components/mds-keyboard/pattern.md +1 -2
  403. package/dist/collection/components/mds-keyboard-key/AGENTS.md +3 -6
  404. package/dist/collection/components/mds-keyboard-key/antipattern.md +1 -2
  405. package/dist/collection/components/mds-keyboard-key/documentation.json +21 -10
  406. package/dist/collection/components/mds-keyboard-key/mds-keyboard-key.css +7 -3
  407. package/dist/collection/components/mds-keyboard-key/mds-keyboard-key.js +4 -1
  408. package/dist/collection/components/mds-keyboard-key/pattern.md +1 -12
  409. package/dist/collection/components/mds-kpi/AGENTS.md +1 -1
  410. package/dist/collection/components/mds-kpi/documentation.json +10 -4
  411. package/dist/collection/components/mds-kpi/mds-kpi.css +2 -2
  412. package/dist/collection/components/mds-kpi/mds-kpi.js +2 -1
  413. package/dist/collection/components/mds-kpi/pattern.md +7 -4
  414. package/dist/collection/components/mds-kpi-item/AGENTS.md +3 -8
  415. package/dist/collection/components/mds-kpi-item/antipattern.md +2 -4
  416. package/dist/collection/components/mds-kpi-item/documentation.json +16 -8
  417. package/dist/collection/components/mds-kpi-item/mds-kpi-item.js +2 -1
  418. package/dist/collection/components/mds-kpi-item/pattern.md +9 -7
  419. package/dist/collection/components/mds-label/AGENTS.md +3 -7
  420. package/dist/collection/components/mds-label/documentation.json +24 -11
  421. package/dist/collection/components/mds-label/mds-label.css +2 -2
  422. package/dist/collection/components/mds-label/mds-label.js +4 -1
  423. package/dist/collection/components/mds-label/pattern.md +1 -3
  424. package/dist/collection/components/mds-link/AGENTS.md +4 -9
  425. package/dist/collection/components/mds-link/documentation.json +22 -10
  426. package/dist/collection/components/mds-link/mds-link.css +1 -1
  427. package/dist/collection/components/mds-link/mds-link.js +4 -3
  428. package/dist/collection/components/mds-list/AGENTS.md +1 -1
  429. package/dist/collection/components/mds-list/documentation.json +6 -2
  430. package/dist/collection/components/mds-list/mds-list.js +2 -1
  431. package/dist/collection/components/mds-list/pattern.md +5 -5
  432. package/dist/collection/components/mds-list-item/AGENTS.md +2 -4
  433. package/dist/collection/components/mds-list-item/antipattern.md +1 -1
  434. package/dist/collection/components/mds-list-item/documentation.json +9 -4
  435. package/dist/collection/components/mds-list-item/mds-list-item.js +2 -1
  436. package/dist/collection/components/mds-list-item/pattern.md +4 -4
  437. package/dist/collection/components/mds-mention/AGENTS.md +2 -4
  438. package/dist/collection/components/mds-mention/antipattern.md +5 -5
  439. package/dist/collection/components/mds-mention/documentation.json +11 -5
  440. package/dist/collection/components/mds-mention/mds-mention.js +4 -1
  441. package/dist/collection/components/mds-mention/pattern.md +3 -5
  442. package/dist/collection/components/mds-modal/AGENTS.md +3 -9
  443. package/dist/collection/components/mds-modal/antipattern.md +1 -3
  444. package/dist/collection/components/mds-modal/documentation.json +37 -18
  445. package/dist/collection/components/mds-modal/mds-modal.css +7 -7
  446. package/dist/collection/components/mds-modal/mds-modal.js +4 -3
  447. package/dist/collection/components/mds-modal/pattern.md +2 -6
  448. package/dist/collection/components/mds-note/AGENTS.md +3 -5
  449. package/dist/collection/components/mds-note/documentation.json +18 -8
  450. package/dist/collection/components/mds-note/mds-note.css +2 -2
  451. package/dist/collection/components/mds-note/mds-note.js +2 -1
  452. package/dist/collection/components/mds-note/pattern.md +1 -3
  453. package/dist/collection/components/mds-notification/AGENTS.md +3 -11
  454. package/dist/collection/components/mds-notification/antipattern.md +2 -2
  455. package/dist/collection/components/mds-notification/documentation.json +33 -16
  456. package/dist/collection/components/mds-notification/mds-notification.css +2 -2
  457. package/dist/collection/components/mds-notification/mds-notification.js +4 -1
  458. package/dist/collection/components/mds-notification/pattern.md +3 -5
  459. package/dist/collection/components/mds-paginator/AGENTS.md +1 -1
  460. package/dist/collection/components/mds-paginator/documentation.json +12 -5
  461. package/dist/collection/components/mds-paginator/mds-paginator.css +2 -2
  462. package/dist/collection/components/mds-paginator/mds-paginator.js +4 -1
  463. package/dist/collection/components/mds-paginator/pattern.md +1 -3
  464. package/dist/collection/components/mds-paginator-item/AGENTS.md +3 -10
  465. package/dist/collection/components/mds-paginator-item/documentation.json +34 -16
  466. package/dist/collection/components/mds-paginator-item/mds-paginator-item.css +5 -5
  467. package/dist/collection/components/mds-paginator-item/mds-paginator-item.js +2 -1
  468. package/dist/collection/components/mds-paginator-item/pattern.md +5 -6
  469. package/dist/collection/components/mds-policy-ai/AGENTS.md +1 -1
  470. package/dist/collection/components/mds-policy-ai/documentation.json +6 -2
  471. package/dist/collection/components/mds-policy-ai/mds-policy-ai.js +2 -1
  472. package/dist/collection/components/mds-policy-ai/pattern.md +4 -4
  473. package/dist/collection/components/mds-pref/AGENTS.md +1 -1
  474. package/dist/collection/components/mds-pref/documentation.json +5 -5
  475. package/dist/collection/components/mds-pref/mds-pref.js +2 -2
  476. package/dist/collection/components/mds-pref-animation/AGENTS.md +1 -1
  477. package/dist/collection/components/mds-pref-animation/documentation.json +7 -2
  478. package/dist/collection/components/mds-pref-animation/mds-pref-animation.js +4 -1
  479. package/dist/collection/components/mds-pref-consumption/AGENTS.md +1 -1
  480. package/dist/collection/components/mds-pref-consumption/documentation.json +7 -2
  481. package/dist/collection/components/mds-pref-consumption/mds-pref-consumption.js +4 -1
  482. package/dist/collection/components/mds-pref-contrast/AGENTS.md +1 -1
  483. package/dist/collection/components/mds-pref-contrast/documentation.json +7 -2
  484. package/dist/collection/components/mds-pref-contrast/mds-pref-contrast.js +4 -1
  485. package/dist/collection/components/mds-pref-language/AGENTS.md +1 -1
  486. package/dist/collection/components/mds-pref-language/documentation.json +5 -1
  487. package/dist/collection/components/mds-pref-language/mds-pref-language.js +2 -1
  488. package/dist/collection/components/mds-pref-language-item/AGENTS.md +1 -1
  489. package/dist/collection/components/mds-pref-language-item/documentation.json +7 -2
  490. package/dist/collection/components/mds-pref-language-item/mds-pref-language-item.js +4 -1
  491. package/dist/collection/components/mds-pref-mode/AGENTS.md +3 -3
  492. package/dist/collection/components/mds-pref-mode/antipattern.md +1 -2
  493. package/dist/collection/components/mds-pref-mode/documentation.json +15 -7
  494. package/dist/collection/components/mds-pref-mode/mds-pref-mode.css +1 -1
  495. package/dist/collection/components/mds-pref-mode/mds-pref-mode.js +4 -1
  496. package/dist/collection/components/mds-pref-mode/pattern.md +1 -3
  497. package/dist/collection/components/mds-pref-theme/AGENTS.md +1 -1
  498. package/dist/collection/components/mds-pref-theme/documentation.json +6 -2
  499. package/dist/collection/components/mds-pref-theme/mds-pref-theme.js +2 -1
  500. package/dist/collection/components/mds-pref-theme/pattern.md +1 -2
  501. package/dist/collection/components/mds-pref-theme-item/AGENTS.md +3 -5
  502. package/dist/collection/components/mds-pref-theme-item/antipattern.md +1 -2
  503. package/dist/collection/components/mds-pref-theme-item/documentation.json +19 -9
  504. package/dist/collection/components/mds-pref-theme-item/mds-pref-theme-item.css +1 -1
  505. package/dist/collection/components/mds-pref-theme-item/mds-pref-theme-item.js +4 -1
  506. package/dist/collection/components/mds-pref-theme-item/pattern.md +2 -6
  507. package/dist/collection/components/mds-price-table/AGENTS.md +1 -1
  508. package/dist/collection/components/mds-price-table/documentation.json +6 -2
  509. package/dist/collection/components/mds-price-table/mds-price-table.js +2 -1
  510. package/dist/collection/components/mds-price-table/pattern.md +4 -4
  511. package/dist/collection/components/mds-price-table-features/AGENTS.md +4 -3
  512. package/dist/collection/components/mds-price-table-features/antipattern.md +0 -1
  513. package/dist/collection/components/mds-price-table-features/documentation.json +12 -6
  514. package/dist/collection/components/mds-price-table-features/mds-price-table-features.css +1 -1
  515. package/dist/collection/components/mds-price-table-features/mds-price-table-features.js +2 -1
  516. package/dist/collection/components/mds-price-table-features/pattern.md +2 -3
  517. package/dist/collection/components/mds-price-table-features-cell/AGENTS.md +3 -6
  518. package/dist/collection/components/mds-price-table-features-cell/antipattern.md +3 -3
  519. package/dist/collection/components/mds-price-table-features-cell/documentation.json +19 -9
  520. package/dist/collection/components/mds-price-table-features-cell/mds-price-table-features-cell.css +1 -1
  521. package/dist/collection/components/mds-price-table-features-cell/mds-price-table-features-cell.js +2 -1
  522. package/dist/collection/components/mds-price-table-features-cell/pattern.md +1 -6
  523. package/dist/collection/components/mds-price-table-features-row/AGENTS.md +3 -3
  524. package/dist/collection/components/mds-price-table-features-row/documentation.json +14 -6
  525. package/dist/collection/components/mds-price-table-features-row/mds-price-table-features-row.css +2 -2
  526. package/dist/collection/components/mds-price-table-features-row/mds-price-table-features-row.js +2 -1
  527. package/dist/collection/components/mds-price-table-features-row/pattern.md +1 -3
  528. package/dist/collection/components/mds-price-table-header/AGENTS.md +1 -1
  529. package/dist/collection/components/mds-price-table-header/documentation.json +5 -1
  530. package/dist/collection/components/mds-price-table-header/mds-price-table-header.js +2 -1
  531. package/dist/collection/components/mds-price-table-list/AGENTS.md +3 -5
  532. package/dist/collection/components/mds-price-table-list/antipattern.md +1 -4
  533. package/dist/collection/components/mds-price-table-list/documentation.json +10 -5
  534. package/dist/collection/components/mds-price-table-list/mds-price-table-list.js +2 -1
  535. package/dist/collection/components/mds-price-table-list/pattern.md +12 -7
  536. package/dist/collection/components/mds-price-table-list-item/AGENTS.md +2 -6
  537. package/dist/collection/components/mds-price-table-list-item/antipattern.md +1 -5
  538. package/dist/collection/components/mds-price-table-list-item/documentation.json +13 -6
  539. package/dist/collection/components/mds-price-table-list-item/mds-price-table-list-item.js +2 -1
  540. package/dist/collection/components/mds-price-table-list-item/pattern.md +7 -4
  541. package/dist/collection/components/mds-progress/AGENTS.md +1 -1
  542. package/dist/collection/components/mds-progress/documentation.json +15 -6
  543. package/dist/collection/components/mds-progress/mds-progress.css +5 -5
  544. package/dist/collection/components/mds-progress/mds-progress.js +2 -1
  545. package/dist/collection/components/mds-push-notification/AGENTS.md +4 -7
  546. package/dist/collection/components/mds-push-notification/antipattern.md +2 -2
  547. package/dist/collection/components/mds-push-notification/documentation.json +24 -12
  548. package/dist/collection/components/mds-push-notification/mds-push-notification.css +11 -11
  549. package/dist/collection/components/mds-push-notification/mds-push-notification.js +2 -1
  550. package/dist/collection/components/mds-push-notification/pattern.md +2 -5
  551. package/dist/collection/components/mds-push-notification-item/AGENTS.md +3 -5
  552. package/dist/collection/components/mds-push-notification-item/documentation.json +20 -9
  553. package/dist/collection/components/mds-push-notification-item/mds-push-notification-item.css +3 -3
  554. package/dist/collection/components/mds-push-notification-item/mds-push-notification-item.js +3 -2
  555. package/dist/collection/components/mds-push-notification-item/pattern.md +1 -3
  556. package/dist/collection/components/mds-quote/AGENTS.md +1 -1
  557. package/dist/collection/components/mds-quote/documentation.json +5 -1
  558. package/dist/collection/components/mds-quote/mds-quote.js +2 -1
  559. package/dist/collection/components/mds-radial-menu/AGENTS.md +4 -11
  560. package/dist/collection/components/mds-radial-menu/documentation.json +31 -15
  561. package/dist/collection/components/mds-radial-menu/mds-radial-menu.css +3 -3
  562. package/dist/collection/components/mds-radial-menu/mds-radial-menu.js +2 -1
  563. package/dist/collection/components/mds-radial-menu/pattern.md +2 -6
  564. package/dist/collection/components/mds-radial-menu-item/AGENTS.md +2 -5
  565. package/dist/collection/components/mds-radial-menu-item/antipattern.md +7 -5
  566. package/dist/collection/components/mds-radial-menu-item/documentation.json +13 -6
  567. package/dist/collection/components/mds-radial-menu-item/mds-radial-menu-item.js +4 -1
  568. package/dist/collection/components/mds-radial-menu-item/pattern.md +6 -8
  569. package/dist/collection/components/mds-radial-progress/AGENTS.md +3 -3
  570. package/dist/collection/components/mds-radial-progress/documentation.json +15 -6
  571. package/dist/collection/components/mds-radial-progress/mds-radial-progress.css +3 -3
  572. package/dist/collection/components/mds-radial-progress/mds-radial-progress.js +2 -1
  573. package/dist/collection/components/mds-separator/AGENTS.md +1 -1
  574. package/dist/collection/components/mds-separator/documentation.json +9 -3
  575. package/dist/collection/components/mds-separator/mds-separator.css +1 -1
  576. package/dist/collection/components/mds-separator/mds-separator.js +4 -1
  577. package/dist/collection/components/mds-spinner/AGENTS.md +1 -1
  578. package/dist/collection/components/mds-spinner/documentation.json +9 -3
  579. package/dist/collection/components/mds-spinner/mds-spinner.css +1 -1
  580. package/dist/collection/components/mds-spinner/mds-spinner.js +4 -1
  581. package/dist/collection/components/mds-status-bar/AGENTS.md +3 -3
  582. package/dist/collection/components/mds-status-bar/antipattern.md +0 -1
  583. package/dist/collection/components/mds-status-bar/documentation.json +13 -6
  584. package/dist/collection/components/mds-status-bar/mds-status-bar.css +1 -1
  585. package/dist/collection/components/mds-status-bar/mds-status-bar.js +2 -1
  586. package/dist/collection/components/mds-status-bar/pattern.md +1 -3
  587. package/dist/collection/components/mds-stepper-bar/AGENTS.md +3 -7
  588. package/dist/collection/components/mds-stepper-bar/documentation.json +22 -10
  589. package/dist/collection/components/mds-stepper-bar/mds-stepper-bar.css +2 -2
  590. package/dist/collection/components/mds-stepper-bar/mds-stepper-bar.js +2 -1
  591. package/dist/collection/components/mds-stepper-bar/pattern.md +2 -6
  592. package/dist/collection/components/mds-stepper-bar-item/AGENTS.md +3 -11
  593. package/dist/collection/components/mds-stepper-bar-item/antipattern.md +3 -3
  594. package/dist/collection/components/mds-stepper-bar-item/documentation.json +31 -15
  595. package/dist/collection/components/mds-stepper-bar-item/mds-stepper-bar-item.css +2 -2
  596. package/dist/collection/components/mds-stepper-bar-item/mds-stepper-bar-item.js +2 -1
  597. package/dist/collection/components/mds-stepper-bar-item/pattern.md +2 -5
  598. package/dist/collection/components/mds-tab/AGENTS.md +3 -27
  599. package/dist/collection/components/mds-tab/antipattern.md +1 -3
  600. package/dist/collection/components/mds-tab/documentation.json +67 -33
  601. package/dist/collection/components/mds-tab/mds-tab.css +5 -5
  602. package/dist/collection/components/mds-tab/mds-tab.js +3 -2
  603. package/dist/collection/components/mds-tab/pattern.md +3 -13
  604. package/dist/collection/components/mds-tab-bar/AGENTS.md +1 -1
  605. package/dist/collection/components/mds-tab-bar/antipattern.md +2 -2
  606. package/dist/collection/components/mds-tab-bar/documentation.json +7 -3
  607. package/dist/collection/components/mds-tab-bar/mds-tab-bar.js +2 -1
  608. package/dist/collection/components/mds-tab-bar/pattern.md +3 -3
  609. package/dist/collection/components/mds-tab-bar-item/AGENTS.md +4 -4
  610. package/dist/collection/components/mds-tab-bar-item/documentation.json +15 -7
  611. package/dist/collection/components/mds-tab-bar-item/mds-tab-bar-item.css +2 -2
  612. package/dist/collection/components/mds-tab-bar-item/mds-tab-bar-item.js +2 -1
  613. package/dist/collection/components/mds-tab-bar-item/pattern.md +1 -3
  614. package/dist/collection/components/mds-tab-item/AGENTS.md +2 -8
  615. package/dist/collection/components/mds-tab-item/antipattern.md +3 -3
  616. package/dist/collection/components/mds-tab-item/documentation.json +17 -8
  617. package/dist/collection/components/mds-tab-item/mds-tab-item.js +2 -1
  618. package/dist/collection/components/mds-tab-item/pattern.md +6 -5
  619. package/dist/collection/components/mds-table/AGENTS.md +3 -7
  620. package/dist/collection/components/mds-table/documentation.json +24 -11
  621. package/dist/collection/components/mds-table/mds-table.css +3 -3
  622. package/dist/collection/components/mds-table/mds-table.js +2 -1
  623. package/dist/collection/components/mds-table/pattern.md +2 -6
  624. package/dist/collection/components/mds-table-body/AGENTS.md +3 -4
  625. package/dist/collection/components/mds-table-body/antipattern.md +1 -2
  626. package/dist/collection/components/mds-table-body/documentation.json +17 -8
  627. package/dist/collection/components/mds-table-body/mds-table-body.css +2 -2
  628. package/dist/collection/components/mds-table-body/mds-table-body.js +2 -1
  629. package/dist/collection/components/mds-table-body/pattern.md +1 -4
  630. package/dist/collection/components/mds-table-cell/AGENTS.md +4 -4
  631. package/dist/collection/components/mds-table-cell/antipattern.md +1 -1
  632. package/dist/collection/components/mds-table-cell/documentation.json +16 -8
  633. package/dist/collection/components/mds-table-cell/mds-table-cell.css +2 -2
  634. package/dist/collection/components/mds-table-cell/mds-table-cell.js +2 -1
  635. package/dist/collection/components/mds-table-cell/pattern.md +1 -7
  636. package/dist/collection/components/mds-table-footer/AGENTS.md +1 -1
  637. package/dist/collection/components/mds-table-footer/antipattern.md +2 -2
  638. package/dist/collection/components/mds-table-footer/documentation.json +7 -3
  639. package/dist/collection/components/mds-table-footer/mds-table-footer.js +2 -1
  640. package/dist/collection/components/mds-table-footer/pattern.md +2 -4
  641. package/dist/collection/components/mds-table-header/AGENTS.md +1 -1
  642. package/dist/collection/components/mds-table-header/documentation.json +5 -1
  643. package/dist/collection/components/mds-table-header/mds-table-header.js +2 -1
  644. package/dist/collection/components/mds-table-header-cell/AGENTS.md +1 -1
  645. package/dist/collection/components/mds-table-header-cell/documentation.json +5 -1
  646. package/dist/collection/components/mds-table-header-cell/mds-table-header-cell.js +2 -1
  647. package/dist/collection/components/mds-table-row/AGENTS.md +2 -8
  648. package/dist/collection/components/mds-table-row/antipattern.md +4 -5
  649. package/dist/collection/components/mds-table-row/documentation.json +17 -8
  650. package/dist/collection/components/mds-table-row/mds-table-row.js +4 -3
  651. package/dist/collection/components/mds-table-row/pattern.md +5 -8
  652. package/dist/collection/components/mds-text/AGENTS.md +3 -3
  653. package/dist/collection/components/mds-text/antipattern.md +1 -2
  654. package/dist/collection/components/mds-text/documentation.json +17 -8
  655. package/dist/collection/components/mds-text/mds-text.css +3 -3
  656. package/dist/collection/components/mds-text/mds-text.js +2 -1
  657. package/dist/collection/components/mds-text/pattern.md +0 -11
  658. package/dist/collection/components/mds-toast/AGENTS.md +3 -3
  659. package/dist/collection/components/mds-toast/antipattern.md +2 -2
  660. package/dist/collection/components/mds-toast/documentation.json +19 -9
  661. package/dist/collection/components/mds-toast/mds-toast.css +4 -4
  662. package/dist/collection/components/mds-toast/mds-toast.js +2 -1
  663. package/dist/collection/components/mds-toast/pattern.md +2 -3
  664. package/dist/collection/components/mds-toast-region/AGENTS.md +1 -1
  665. package/dist/collection/components/mds-toast-region/documentation.json +7 -2
  666. package/dist/collection/components/mds-toast-region/mds-toast-region.css +1 -1
  667. package/dist/collection/components/mds-toast-region/mds-toast-region.js +2 -1
  668. package/dist/collection/components/mds-tooltip/AGENTS.md +3 -8
  669. package/dist/collection/components/mds-tooltip/antipattern.md +1 -1
  670. package/dist/collection/components/mds-tooltip/documentation.json +27 -13
  671. package/dist/collection/components/mds-tooltip/mds-tooltip.css +5 -5
  672. package/dist/collection/components/mds-tooltip/mds-tooltip.js +2 -1
  673. package/dist/collection/components/mds-tooltip/pattern.md +1 -3
  674. package/dist/collection/components/mds-tree/AGENTS.md +3 -28
  675. package/dist/collection/components/mds-tree/antipattern.md +3 -4
  676. package/dist/collection/components/mds-tree/documentation.json +63 -31
  677. package/dist/collection/components/mds-tree/mds-tree.css +1 -1
  678. package/dist/collection/components/mds-tree/mds-tree.js +2 -1
  679. package/dist/collection/components/mds-tree/pattern.md +3 -9
  680. package/dist/collection/components/mds-tree-item/AGENTS.md +2 -33
  681. package/dist/collection/components/mds-tree-item/antipattern.md +1 -5
  682. package/dist/collection/components/mds-tree-item/documentation.json +67 -33
  683. package/dist/collection/components/mds-tree-item/mds-tree-item.js +2 -1
  684. package/dist/collection/components/mds-tree-item/pattern.md +5 -10
  685. package/dist/collection/components/mds-url-view/AGENTS.md +3 -2
  686. package/dist/collection/components/mds-url-view/antipattern.md +1 -2
  687. package/dist/collection/components/mds-url-view/documentation.json +19 -9
  688. package/dist/collection/components/mds-url-view/mds-url-view.css +4 -4
  689. package/dist/collection/components/mds-url-view/mds-url-view.js +4 -1
  690. package/dist/collection/components/mds-url-view/pattern.md +1 -2
  691. package/dist/collection/components/mds-usage/AGENTS.md +2 -6
  692. package/dist/collection/components/mds-usage/antipattern.md +6 -4
  693. package/dist/collection/components/mds-usage/documentation.json +13 -6
  694. package/dist/collection/components/mds-usage/mds-usage.js +2 -1
  695. package/dist/collection/components/mds-usage/pattern.md +10 -6
  696. package/dist/collection/components/mds-video-wall/AGENTS.md +3 -4
  697. package/dist/collection/components/mds-video-wall/antipattern.md +5 -5
  698. package/dist/collection/components/mds-video-wall/documentation.json +15 -7
  699. package/dist/collection/components/mds-video-wall/mds-video-wall.css +1 -1
  700. package/dist/collection/components/mds-video-wall/mds-video-wall.js +2 -1
  701. package/dist/collection/components/mds-video-wall/pattern.md +2 -4
  702. package/dist/collection/components/mds-zero/AGENTS.md +1 -1
  703. package/dist/collection/components/mds-zero/antipattern.md +6 -6
  704. package/dist/collection/components/mds-zero/documentation.json +9 -4
  705. package/dist/collection/components/mds-zero/mds-zero.css +1 -1
  706. package/dist/collection/components/mds-zero/mds-zero.js +2 -1
  707. package/dist/collection/components/mds-zero/pattern.md +3 -3
  708. package/dist/components/index.d.ts +2 -0
  709. package/dist/components/index.js +1 -1
  710. package/dist/components/mds-accordion-item.js +1 -1
  711. package/dist/components/mds-accordion-timer-item.js +1 -1
  712. package/dist/components/mds-accordion-timer.js +1 -1
  713. package/dist/components/mds-accordion.js +1 -1
  714. package/dist/components/mds-author.js +1 -1
  715. package/dist/components/mds-avatar-stack-item.js +1 -1
  716. package/dist/components/mds-avatar-stack.js +1 -1
  717. package/dist/components/mds-avatar.js +1 -1
  718. package/dist/components/mds-badge.js +1 -1
  719. package/dist/components/mds-banner.js +1 -1
  720. package/dist/components/mds-benchmark-bar.js +1 -1
  721. package/dist/components/mds-bibliography.js +1 -1
  722. package/dist/components/mds-book.d.ts +11 -0
  723. package/dist/components/mds-book.js +1 -0
  724. package/dist/components/mds-breadcrumb-item.js +1 -1
  725. package/dist/components/mds-breadcrumb.js +1 -1
  726. package/dist/components/mds-button-dropdown.js +1 -1
  727. package/dist/components/mds-button-group.js +1 -1
  728. package/dist/components/mds-button.js +1 -1
  729. package/dist/components/mds-calendar-cell.js +1 -1
  730. package/dist/components/mds-calendar.js +1 -1
  731. package/dist/components/mds-card-content.js +1 -1
  732. package/dist/components/mds-card-footer.js +1 -1
  733. package/dist/components/mds-card-header.js +1 -1
  734. package/dist/components/mds-card-media.js +1 -1
  735. package/dist/components/mds-card.js +1 -1
  736. package/dist/components/mds-chip.js +1 -1
  737. package/dist/components/mds-details.js +1 -1
  738. package/dist/components/mds-dropdown.js +1 -1
  739. package/dist/components/mds-emoji.js +2 -2
  740. package/dist/components/mds-entity.js +1 -1
  741. package/dist/components/mds-file-preview.js +1 -1
  742. package/dist/components/mds-file.js +1 -1
  743. package/dist/components/mds-filter-item.js +1 -1
  744. package/dist/components/mds-filter.js +1 -1
  745. package/dist/components/mds-header-bar.js +1 -1
  746. package/dist/components/mds-header.js +1 -1
  747. package/dist/components/mds-help.js +1 -1
  748. package/dist/components/mds-horizontal-scroll.js +1 -1
  749. package/dist/components/mds-hr.js +1 -1
  750. package/dist/components/mds-icon.js +1 -1
  751. package/dist/components/mds-img.js +1 -1
  752. package/dist/components/mds-input-date-range-preselection.js +1 -1
  753. package/dist/components/mds-input-date-range.js +1 -1
  754. package/dist/components/mds-input-date.js +1 -1
  755. package/dist/components/mds-input-field.js +1 -1
  756. package/dist/components/mds-input-otp.js +1 -1
  757. package/dist/components/mds-input-range.js +1 -1
  758. package/dist/components/mds-input-select.js +1 -1
  759. package/dist/components/mds-input-switch.js +1 -1
  760. package/dist/components/mds-input-tip-item.js +1 -1
  761. package/dist/components/mds-input-tip.js +1 -1
  762. package/dist/components/mds-input-upload.js +1 -1
  763. package/dist/components/mds-input.js +1 -1
  764. package/dist/components/mds-keyboard-key.js +1 -1
  765. package/dist/components/mds-keyboard.js +1 -1
  766. package/dist/components/mds-kpi-item.js +1 -1
  767. package/dist/components/mds-kpi.js +1 -1
  768. package/dist/components/mds-label.js +1 -1
  769. package/dist/components/mds-link.js +1 -1
  770. package/dist/components/mds-list-item.js +1 -1
  771. package/dist/components/mds-list.js +1 -1
  772. package/dist/components/mds-mention.js +1 -1
  773. package/dist/components/mds-modal.js +1 -1
  774. package/dist/components/mds-note.js +1 -1
  775. package/dist/components/mds-notification.js +1 -1
  776. package/dist/components/mds-paginator-item.js +1 -1
  777. package/dist/components/mds-paginator.js +1 -1
  778. package/dist/components/mds-policy-ai.js +1 -1
  779. package/dist/components/mds-pref-animation.js +1 -1
  780. package/dist/components/mds-pref-consumption.js +1 -1
  781. package/dist/components/mds-pref-contrast.js +1 -1
  782. package/dist/components/mds-pref-language-item.js +1 -1
  783. package/dist/components/mds-pref-language.js +1 -1
  784. package/dist/components/mds-pref-mode.js +1 -1
  785. package/dist/components/mds-pref-theme-item.js +1 -1
  786. package/dist/components/mds-pref-theme.js +1 -1
  787. package/dist/components/mds-pref.js +1 -1
  788. package/dist/components/mds-price-table-features-cell.js +1 -1
  789. package/dist/components/mds-price-table-features-row.js +1 -1
  790. package/dist/components/mds-price-table-features.js +1 -1
  791. package/dist/components/mds-price-table-header.js +1 -1
  792. package/dist/components/mds-price-table-list-item.js +1 -1
  793. package/dist/components/mds-price-table-list.js +1 -1
  794. package/dist/components/mds-price-table.js +1 -1
  795. package/dist/components/mds-progress.js +1 -1
  796. package/dist/components/mds-push-notification-item.js +1 -1
  797. package/dist/components/mds-push-notification.js +1 -1
  798. package/dist/components/mds-quote.js +1 -1
  799. package/dist/components/mds-radial-menu-item.js +1 -1
  800. package/dist/components/mds-radial-menu.js +1 -1
  801. package/dist/components/mds-radial-progress.js +1 -1
  802. package/dist/components/mds-separator.js +1 -1
  803. package/dist/components/mds-spinner.js +1 -1
  804. package/dist/components/mds-status-bar.js +1 -1
  805. package/dist/components/mds-stepper-bar-item.js +1 -1
  806. package/dist/components/mds-stepper-bar.js +1 -1
  807. package/dist/components/mds-tab-bar-item.js +1 -1
  808. package/dist/components/mds-tab-bar.js +1 -1
  809. package/dist/components/mds-tab-item.js +1 -1
  810. package/dist/components/mds-tab.js +1 -1
  811. package/dist/components/mds-table-body.js +1 -1
  812. package/dist/components/mds-table-cell.js +1 -1
  813. package/dist/components/mds-table-footer.js +1 -1
  814. package/dist/components/mds-table-header-cell.js +1 -1
  815. package/dist/components/mds-table-header.js +1 -1
  816. package/dist/components/mds-table-row.js +1 -1
  817. package/dist/components/mds-table.js +1 -1
  818. package/dist/components/mds-text.js +1 -1
  819. package/dist/components/mds-toast-region.js +1 -1
  820. package/dist/components/mds-toast.js +1 -1
  821. package/dist/components/mds-tooltip.js +1 -1
  822. package/dist/components/mds-tree-item.js +1 -1
  823. package/dist/components/mds-tree.js +1 -1
  824. package/dist/components/mds-url-view.js +1 -1
  825. package/dist/components/mds-usage.js +1 -1
  826. package/dist/components/mds-video-wall.js +1 -1
  827. package/dist/components/mds-zero.js +1 -1
  828. package/dist/components/p-B8hgyXdE.js +1 -0
  829. package/dist/components/{p-DkUdrGHq.js → p-BBO_llcO.js} +1 -1
  830. package/dist/components/{p-D0A8gS-P.js → p-BM7joOdq.js} +1 -1
  831. package/dist/components/{p-DNeEn8Rr.js → p-BMIaZ4HY.js} +1 -1
  832. package/dist/components/{p-BwJQB6rG.js → p-BOJQ3tkp.js} +1 -1
  833. package/dist/components/{p-CJYY4da7.js → p-BU1O2DcC.js} +1 -1
  834. package/dist/components/{p-CaROqeeK.js → p-Bo6ezD1p.js} +1 -1
  835. package/dist/components/p-C0H8bZpf.js +1 -0
  836. package/dist/components/{p-s1CktmPS.js → p-C1YH20BL.js} +1 -1
  837. package/dist/components/{p-Cmn1DJAB.js → p-CEw7GvM-.js} +1 -1
  838. package/dist/components/{p-D-DdDIb9.js → p-CNUWS_Mg.js} +1 -1
  839. package/dist/components/{p-DucY18_e.js → p-CNpL55c-.js} +1 -1
  840. package/dist/components/{p-DnySYX0L.js → p-CV7wjM1c.js} +1 -1
  841. package/dist/components/{p-BU3bsIX2.js → p-CWSIl1jl.js} +1 -1
  842. package/dist/components/{p-DFD4E9zJ.js → p-CYK2Xr_v.js} +1 -1
  843. package/dist/components/p-Czqtt8kO.js +1 -0
  844. package/dist/components/{p-Dm-OUwDe.js → p-DD2muCqG.js} +1 -1
  845. package/dist/components/{p-ZuubAcA3.js → p-DDTJwlAd.js} +1 -1
  846. package/dist/components/{p-5lLueiFt.js → p-DJ401QTd.js} +1 -1
  847. package/dist/components/{p-BbK4qeM7.js → p-DMyL4CYh.js} +1 -1
  848. package/dist/components/{p-Cu5nEwMu.js → p-DbVGGhs_.js} +1 -1
  849. package/dist/components/{p-C4XdTZQ-.js → p-DccBbfK8.js} +1 -1
  850. package/dist/components/{p-BbgQG1UL.js → p-H0YXZ5fD.js} +2 -2
  851. package/dist/components/{p-yNPPTJ7i.js → p-IaXq1Xsc.js} +1 -1
  852. package/dist/components/{p-ClPv-Ljc.js → p-M8dGB4KH.js} +1 -1
  853. package/dist/components/{p-CPvuXO7s.js → p-TNn_HE5x.js} +1 -1
  854. package/dist/components/{p-CNF3u0Li.js → p-aujz-VM9.js} +1 -1
  855. package/dist/components/{p-CSxW5f2f.js → p-e9NGNm7d.js} +1 -1
  856. package/dist/components/{p-DkYDXDkD.js → p-kZBPId_x.js} +1 -1
  857. package/dist/components/{p-BO-jHv-F.js → p-qnCVkeGX.js} +1 -1
  858. package/dist/documentation.json +2613 -918
  859. package/dist/esm/index-CvLLN-QH.js +4 -0
  860. package/dist/esm/loader.js +1 -1
  861. package/dist/esm/magma-components.js +1 -1
  862. package/dist/esm/mds-accordion-item.entry.js +1 -1
  863. package/dist/esm/mds-accordion-timer-item.entry.js +1 -1
  864. package/dist/esm/mds-accordion-timer.entry.js +1 -1
  865. package/dist/esm/mds-accordion.entry.js +1 -1
  866. package/dist/esm/mds-author.entry.js +1 -1
  867. package/dist/esm/mds-avatar-stack-item.entry.js +1 -1
  868. package/dist/esm/mds-avatar-stack.entry.js +1 -1
  869. package/dist/esm/mds-avatar.entry.js +1 -1
  870. package/dist/esm/mds-badge.entry.js +1 -1
  871. package/dist/esm/mds-banner_3.entry.js +3 -3
  872. package/dist/esm/mds-benchmark-bar.entry.js +1 -1
  873. package/dist/esm/mds-bibliography.entry.js +1 -1
  874. package/dist/esm/mds-book.entry.js +701 -0
  875. package/dist/esm/mds-breadcrumb-item.entry.js +1 -1
  876. package/dist/esm/mds-breadcrumb.entry.js +1 -1
  877. package/dist/esm/mds-button-dropdown.entry.js +1 -1
  878. package/dist/esm/mds-button-group.entry.js +1 -1
  879. package/dist/esm/mds-button_3.entry.js +6 -6
  880. package/dist/esm/mds-calendar_2.entry.js +6 -6
  881. package/dist/esm/mds-card-content.entry.js +1 -1
  882. package/dist/esm/mds-card-footer.entry.js +1 -1
  883. package/dist/esm/mds-card-header.entry.js +1 -1
  884. package/dist/esm/mds-card-media.entry.js +1 -1
  885. package/dist/esm/mds-card.entry.js +1 -1
  886. package/dist/esm/mds-details.entry.js +1 -1
  887. package/dist/esm/mds-dropdown.entry.js +2 -2
  888. package/dist/esm/mds-emoji.entry.js +1 -1
  889. package/dist/esm/mds-entity.entry.js +1 -1
  890. package/dist/esm/mds-file-preview.entry.js +2 -2
  891. package/dist/esm/mds-file.entry.js +1 -1
  892. package/dist/esm/mds-filter-item.entry.js +1 -1
  893. package/dist/esm/mds-filter.entry.js +1 -1
  894. package/dist/esm/mds-header-bar.entry.js +1 -1
  895. package/dist/esm/mds-header.entry.js +2 -2
  896. package/dist/esm/mds-horizontal-scroll.entry.js +1 -1
  897. package/dist/esm/mds-hr.entry.js +1 -1
  898. package/dist/esm/mds-input-date-range-preselection.entry.js +1 -1
  899. package/dist/esm/mds-input-date-range.entry.js +2 -2
  900. package/dist/esm/mds-input-date.entry.js +2 -2
  901. package/dist/esm/mds-input-field.entry.js +1 -1
  902. package/dist/esm/mds-input-otp.entry.js +1 -1
  903. package/dist/esm/mds-input-range.entry.js +1 -1
  904. package/dist/esm/mds-input-select.entry.js +2 -2
  905. package/dist/esm/mds-input-switch_2.entry.js +2 -2
  906. package/dist/esm/mds-input-tip_2.entry.js +3 -3
  907. package/dist/esm/mds-input-upload.entry.js +5 -5
  908. package/dist/esm/mds-input.entry.js +2 -2
  909. package/dist/esm/mds-keyboard-key.entry.js +2 -2
  910. package/dist/esm/mds-keyboard.entry.js +2 -2
  911. package/dist/esm/mds-kpi-item.entry.js +1 -1
  912. package/dist/esm/mds-kpi.entry.js +1 -1
  913. package/dist/esm/mds-label.entry.js +1 -1
  914. package/dist/esm/mds-link.entry.js +3 -3
  915. package/dist/esm/mds-list-item.entry.js +1 -1
  916. package/dist/esm/mds-list.entry.js +1 -1
  917. package/dist/esm/mds-mention.entry.js +1 -1
  918. package/dist/esm/mds-modal.entry.js +3 -3
  919. package/dist/esm/mds-note.entry.js +1 -1
  920. package/dist/esm/mds-notification.entry.js +1 -1
  921. package/dist/esm/mds-paginator-item.entry.js +1 -1
  922. package/dist/esm/mds-paginator.entry.js +1 -1
  923. package/dist/esm/mds-policy-ai.entry.js +1 -1
  924. package/dist/esm/mds-pref-animation.entry.js +1 -1
  925. package/dist/esm/mds-pref-consumption.entry.js +1 -1
  926. package/dist/esm/mds-pref-contrast.entry.js +1 -1
  927. package/dist/esm/mds-pref-language-item.entry.js +1 -1
  928. package/dist/esm/mds-pref-language.entry.js +1 -1
  929. package/dist/esm/mds-pref-mode.entry.js +1 -1
  930. package/dist/esm/mds-pref-theme-item.entry.js +1 -1
  931. package/dist/esm/mds-pref-theme.entry.js +1 -1
  932. package/dist/esm/mds-pref.entry.js +1 -1
  933. package/dist/esm/mds-price-table-features-cell.entry.js +1 -1
  934. package/dist/esm/mds-price-table-features-row.entry.js +1 -1
  935. package/dist/esm/mds-price-table-features.entry.js +1 -1
  936. package/dist/esm/mds-price-table-header.entry.js +1 -1
  937. package/dist/esm/mds-price-table-list-item.entry.js +1 -1
  938. package/dist/esm/mds-price-table-list.entry.js +1 -1
  939. package/dist/esm/mds-price-table.entry.js +1 -1
  940. package/dist/esm/mds-progress_2.entry.js +2 -2
  941. package/dist/esm/mds-push-notification-item.entry.js +2 -2
  942. package/dist/esm/mds-push-notification.entry.js +2 -2
  943. package/dist/esm/mds-quote.entry.js +1 -1
  944. package/dist/esm/mds-radial-menu-item.entry.js +1 -1
  945. package/dist/esm/mds-radial-menu.entry.js +1 -1
  946. package/dist/esm/mds-separator.entry.js +1 -1
  947. package/dist/esm/mds-status-bar.entry.js +1 -1
  948. package/dist/esm/mds-stepper-bar-item.entry.js +1 -1
  949. package/dist/esm/mds-stepper-bar.entry.js +1 -1
  950. package/dist/esm/mds-tab-bar-item.entry.js +1 -1
  951. package/dist/esm/mds-tab-bar.entry.js +1 -1
  952. package/dist/esm/mds-tab_2.entry.js +4 -4
  953. package/dist/esm/mds-table-body.entry.js +1 -1
  954. package/dist/esm/mds-table-footer.entry.js +1 -1
  955. package/dist/esm/mds-table-header-cell.entry.js +1 -1
  956. package/dist/esm/mds-table-header.entry.js +1 -1
  957. package/dist/esm/mds-table-row.entry.js +2 -2
  958. package/dist/esm/mds-table.entry.js +1 -1
  959. package/dist/esm/mds-text.entry.js +1 -1
  960. package/dist/esm/mds-toast-region.entry.js +1 -1
  961. package/dist/esm/mds-toast.entry.js +1 -1
  962. package/dist/esm/mds-tooltip.entry.js +2 -2
  963. package/dist/esm/mds-tree-item.entry.js +1 -1
  964. package/dist/esm/mds-tree.entry.js +1 -1
  965. package/dist/esm/mds-url-view.entry.js +1 -1
  966. package/dist/esm/mds-usage.entry.js +1 -1
  967. package/dist/esm/mds-video-wall.entry.js +1 -1
  968. package/dist/esm/mds-zero.entry.js +1 -1
  969. package/dist/esm-es5/index-CvLLN-QH.js +8 -6
  970. package/dist/esm-es5/loader.js +1 -1
  971. package/dist/esm-es5/magma-components.js +2 -2
  972. package/dist/esm-es5/mds-accordion-item.entry.js +1 -1
  973. package/dist/esm-es5/mds-accordion-timer-item.entry.js +1 -1
  974. package/dist/esm-es5/mds-accordion-timer.entry.js +1 -1
  975. package/dist/esm-es5/mds-accordion.entry.js +2 -2
  976. package/dist/esm-es5/mds-author.entry.js +1 -1
  977. package/dist/esm-es5/mds-avatar-stack-item.entry.js +1 -1
  978. package/dist/esm-es5/mds-avatar-stack.entry.js +1 -1
  979. package/dist/esm-es5/mds-avatar.entry.js +5 -5
  980. package/dist/esm-es5/mds-badge.entry.js +1 -1
  981. package/dist/esm-es5/mds-banner_3.entry.js +3 -3
  982. package/dist/esm-es5/mds-benchmark-bar.entry.js +3 -3
  983. package/dist/esm-es5/mds-bibliography.entry.js +2 -2
  984. package/dist/esm-es5/mds-book.entry.js +207 -0
  985. package/dist/esm-es5/mds-breadcrumb-item.entry.js +1 -1
  986. package/dist/esm-es5/mds-breadcrumb.entry.js +4 -4
  987. package/dist/esm-es5/mds-button-dropdown.entry.js +1 -1
  988. package/dist/esm-es5/mds-button-group.entry.js +1 -1
  989. package/dist/esm-es5/mds-button_3.entry.js +5 -5
  990. package/dist/esm-es5/mds-calendar_2.entry.js +3 -3
  991. package/dist/esm-es5/mds-card-content.entry.js +1 -1
  992. package/dist/esm-es5/mds-card-footer.entry.js +1 -1
  993. package/dist/esm-es5/mds-card-header.entry.js +1 -1
  994. package/dist/esm-es5/mds-card-media.entry.js +1 -1
  995. package/dist/esm-es5/mds-card.entry.js +1 -1
  996. package/dist/esm-es5/mds-details.entry.js +1 -1
  997. package/dist/esm-es5/mds-dropdown.entry.js +1 -1
  998. package/dist/esm-es5/mds-emoji.entry.js +1 -1
  999. package/dist/esm-es5/mds-entity.entry.js +1 -1
  1000. package/dist/esm-es5/mds-file-preview.entry.js +3 -3
  1001. package/dist/esm-es5/mds-file.entry.js +1 -1
  1002. package/dist/esm-es5/mds-filter-item.entry.js +1 -1
  1003. package/dist/esm-es5/mds-filter.entry.js +1 -1
  1004. package/dist/esm-es5/mds-header-bar.entry.js +1 -1
  1005. package/dist/esm-es5/mds-header.entry.js +2 -2
  1006. package/dist/esm-es5/mds-horizontal-scroll.entry.js +1 -1
  1007. package/dist/esm-es5/mds-hr.entry.js +1 -1
  1008. package/dist/esm-es5/mds-input-date-range-preselection.entry.js +1 -1
  1009. package/dist/esm-es5/mds-input-date-range.entry.js +2 -2
  1010. package/dist/esm-es5/mds-input-date.entry.js +2 -2
  1011. package/dist/esm-es5/mds-input-field.entry.js +1 -1
  1012. package/dist/esm-es5/mds-input-otp.entry.js +1 -1
  1013. package/dist/esm-es5/mds-input-range.entry.js +1 -1
  1014. package/dist/esm-es5/mds-input-select.entry.js +1 -1
  1015. package/dist/esm-es5/mds-input-switch_2.entry.js +1 -1
  1016. package/dist/esm-es5/mds-input-tip_2.entry.js +2 -2
  1017. package/dist/esm-es5/mds-input-upload.entry.js +1 -1
  1018. package/dist/esm-es5/mds-input.entry.js +1 -1
  1019. package/dist/esm-es5/mds-keyboard-key.entry.js +2 -2
  1020. package/dist/esm-es5/mds-keyboard.entry.js +2 -2
  1021. package/dist/esm-es5/mds-kpi-item.entry.js +3 -3
  1022. package/dist/esm-es5/mds-kpi.entry.js +1 -1
  1023. package/dist/esm-es5/mds-label.entry.js +1 -1
  1024. package/dist/esm-es5/mds-link.entry.js +1 -1
  1025. package/dist/esm-es5/mds-list-item.entry.js +1 -1
  1026. package/dist/esm-es5/mds-list.entry.js +1 -1
  1027. package/dist/esm-es5/mds-mention.entry.js +2 -2
  1028. package/dist/esm-es5/mds-modal.entry.js +1 -1
  1029. package/dist/esm-es5/mds-note.entry.js +1 -1
  1030. package/dist/esm-es5/mds-notification.entry.js +1 -1
  1031. package/dist/esm-es5/mds-paginator-item.entry.js +1 -1
  1032. package/dist/esm-es5/mds-paginator.entry.js +3 -3
  1033. package/dist/esm-es5/mds-policy-ai.entry.js +1 -1
  1034. package/dist/esm-es5/mds-pref-animation.entry.js +1 -1
  1035. package/dist/esm-es5/mds-pref-consumption.entry.js +1 -1
  1036. package/dist/esm-es5/mds-pref-contrast.entry.js +1 -1
  1037. package/dist/esm-es5/mds-pref-language-item.entry.js +1 -1
  1038. package/dist/esm-es5/mds-pref-language.entry.js +1 -1
  1039. package/dist/esm-es5/mds-pref-mode.entry.js +1 -1
  1040. package/dist/esm-es5/mds-pref-theme-item.entry.js +3 -3
  1041. package/dist/esm-es5/mds-pref-theme.entry.js +6 -6
  1042. package/dist/esm-es5/mds-pref.entry.js +1 -1
  1043. package/dist/esm-es5/mds-price-table-features-cell.entry.js +1 -1
  1044. package/dist/esm-es5/mds-price-table-features-row.entry.js +1 -1
  1045. package/dist/esm-es5/mds-price-table-features.entry.js +1 -1
  1046. package/dist/esm-es5/mds-price-table-header.entry.js +1 -1
  1047. package/dist/esm-es5/mds-price-table-list-item.entry.js +1 -1
  1048. package/dist/esm-es5/mds-price-table-list.entry.js +1 -1
  1049. package/dist/esm-es5/mds-price-table.entry.js +1 -1
  1050. package/dist/esm-es5/mds-progress_2.entry.js +2 -2
  1051. package/dist/esm-es5/mds-push-notification-item.entry.js +2 -2
  1052. package/dist/esm-es5/mds-push-notification.entry.js +2 -2
  1053. package/dist/esm-es5/mds-quote.entry.js +1 -1
  1054. package/dist/esm-es5/mds-radial-menu-item.entry.js +1 -1
  1055. package/dist/esm-es5/mds-radial-menu.entry.js +1 -1
  1056. package/dist/esm-es5/mds-separator.entry.js +1 -1
  1057. package/dist/esm-es5/mds-status-bar.entry.js +1 -1
  1058. package/dist/esm-es5/mds-stepper-bar-item.entry.js +1 -1
  1059. package/dist/esm-es5/mds-stepper-bar.entry.js +1 -1
  1060. package/dist/esm-es5/mds-tab-bar-item.entry.js +1 -1
  1061. package/dist/esm-es5/mds-tab-bar.entry.js +1 -1
  1062. package/dist/esm-es5/mds-tab_2.entry.js +3 -3
  1063. package/dist/esm-es5/mds-table-body.entry.js +1 -1
  1064. package/dist/esm-es5/mds-table-footer.entry.js +1 -1
  1065. package/dist/esm-es5/mds-table-header-cell.entry.js +1 -1
  1066. package/dist/esm-es5/mds-table-header.entry.js +4 -4
  1067. package/dist/esm-es5/mds-table-row.entry.js +1 -1
  1068. package/dist/esm-es5/mds-table.entry.js +2 -2
  1069. package/dist/esm-es5/mds-text.entry.js +1 -1
  1070. package/dist/esm-es5/mds-toast-region.entry.js +1 -1
  1071. package/dist/esm-es5/mds-toast.entry.js +1 -1
  1072. package/dist/esm-es5/mds-tooltip.entry.js +2 -2
  1073. package/dist/esm-es5/mds-tree-item.entry.js +1 -1
  1074. package/dist/esm-es5/mds-tree.entry.js +1 -1
  1075. package/dist/esm-es5/mds-url-view.entry.js +1 -1
  1076. package/dist/esm-es5/mds-usage.entry.js +1 -1
  1077. package/dist/esm-es5/mds-video-wall.entry.js +1 -1
  1078. package/dist/esm-es5/mds-zero.entry.js +1 -1
  1079. package/dist/hydrate/index.js +1044 -156
  1080. package/dist/hydrate/index.mjs +1044 -156
  1081. package/dist/lint/core/checks.d.ts +40 -0
  1082. package/dist/lint/core/checks.js +143 -0
  1083. package/dist/lint/core/colors.d.ts +2 -0
  1084. package/dist/lint/core/colors.js +40 -0
  1085. package/dist/lint/core/data.d.ts +90 -0
  1086. package/dist/lint/core/data.js +186 -0
  1087. package/dist/lint/core/element.d.ts +55 -0
  1088. package/dist/lint/core/element.js +19 -0
  1089. package/dist/lint/eslint/adapters.d.ts +55 -0
  1090. package/dist/lint/eslint/adapters.js +254 -0
  1091. package/dist/lint/eslint/index.d.ts +7 -0
  1092. package/dist/lint/eslint/index.js +87 -0
  1093. package/dist/lint/index.d.ts +4 -0
  1094. package/dist/lint/index.js +10 -0
  1095. package/dist/lint/mcp/checks.d.ts +15 -0
  1096. package/dist/lint/mcp/checks.js +443 -0
  1097. package/dist/lint/mcp/cli.d.ts +2 -0
  1098. package/dist/lint/mcp/cli.js +29 -0
  1099. package/dist/lint/mcp/color.d.ts +12 -0
  1100. package/dist/lint/mcp/color.js +87 -0
  1101. package/dist/lint/mcp/components.d.ts +5 -0
  1102. package/dist/lint/mcp/components.js +362 -0
  1103. package/dist/lint/mcp/context.d.ts +36 -0
  1104. package/dist/lint/mcp/context.js +98 -0
  1105. package/dist/lint/mcp/guides.d.ts +3 -0
  1106. package/dist/lint/mcp/guides.js +137 -0
  1107. package/dist/lint/mcp/icon.svg +11 -0
  1108. package/dist/lint/mcp/icons.d.ts +3 -0
  1109. package/dist/lint/mcp/icons.js +196 -0
  1110. package/dist/lint/mcp/protocol.d.ts +59 -0
  1111. package/dist/lint/mcp/protocol.js +111 -0
  1112. package/dist/lint/mcp/server.d.ts +37 -0
  1113. package/dist/lint/mcp/server.js +73 -0
  1114. package/dist/lint/mcp/tokens.d.ts +37 -0
  1115. package/dist/lint/mcp/tokens.js +629 -0
  1116. package/dist/lint/mcp/tools.json +962 -0
  1117. package/dist/lint/package.json +3 -0
  1118. package/dist/lint/stylelint/index.d.ts +3 -0
  1119. package/dist/lint/stylelint/index.js +203 -0
  1120. package/dist/lint/stylelint/recommended.d.ts +3 -0
  1121. package/dist/lint/stylelint/recommended.js +11 -0
  1122. package/dist/lint/stylelint/strict.d.ts +3 -0
  1123. package/dist/lint/stylelint/strict.js +11 -0
  1124. package/dist/magma-components/magma-components.esm.js +1 -1
  1125. package/dist/magma-components/{p-a8a0a9ba.entry.js → p-00aa9a51.entry.js} +1 -1
  1126. package/dist/magma-components/{p-62e94d78.system.entry.js → p-00acb2e1.system.entry.js} +2 -2
  1127. package/dist/magma-components/{p-4bc3335f.system.entry.js → p-037126b7.system.entry.js} +1 -1
  1128. package/dist/magma-components/{p-e5d41024.system.entry.js → p-03da0376.system.entry.js} +1 -1
  1129. package/dist/magma-components/{p-25a6e977.entry.js → p-0417391b.entry.js} +1 -1
  1130. package/dist/magma-components/{p-377d0661.entry.js → p-05ef91a5.entry.js} +1 -1
  1131. package/dist/magma-components/{p-7b300282.entry.js → p-07d35da6.entry.js} +1 -1
  1132. package/dist/magma-components/{p-f4d80d9a.entry.js → p-09c80fdb.entry.js} +1 -1
  1133. package/dist/magma-components/{p-5cfa0dce.entry.js → p-0b0ca53c.entry.js} +1 -1
  1134. package/dist/magma-components/{p-624a3909.system.entry.js → p-0babf674.system.entry.js} +3 -3
  1135. package/dist/magma-components/{p-b01118cc.entry.js → p-0d90c991.entry.js} +1 -1
  1136. package/dist/magma-components/{p-9745dc51.entry.js → p-103465cf.entry.js} +1 -1
  1137. package/dist/magma-components/{p-d608b79c.entry.js → p-10983da0.entry.js} +1 -1
  1138. package/dist/magma-components/{p-52d905fe.system.entry.js → p-109926ce.system.entry.js} +2 -2
  1139. package/dist/magma-components/{p-770b3c4b.entry.js → p-14b13850.entry.js} +1 -1
  1140. package/dist/magma-components/{p-b5cc09c7.system.entry.js → p-154ba354.system.entry.js} +2 -2
  1141. package/dist/magma-components/{p-f5a33058.entry.js → p-160cd923.entry.js} +1 -1
  1142. package/dist/magma-components/{p-5ef0fb69.system.entry.js → p-1685e74c.system.entry.js} +1 -1
  1143. package/dist/magma-components/p-1748ca8b.system.entry.js +1 -0
  1144. package/dist/magma-components/{p-c03fc4fe.system.entry.js → p-17a43cb6.system.entry.js} +2 -2
  1145. package/dist/magma-components/p-17ccfc01.system.entry.js +208 -0
  1146. package/dist/magma-components/{p-f0285a1e.system.entry.js → p-1b415625.system.entry.js} +3 -3
  1147. package/dist/magma-components/{p-3e18b181.system.entry.js → p-1b67b149.system.entry.js} +1 -1
  1148. package/dist/magma-components/p-1c00d0f7.entry.js +1 -0
  1149. package/dist/magma-components/{p-79f543fc.system.entry.js → p-1cd75adf.system.entry.js} +3 -3
  1150. package/dist/magma-components/{p-8f47eb63.system.entry.js → p-1d8485de.system.entry.js} +4 -4
  1151. package/dist/magma-components/{p-168d5fad.entry.js → p-2006cfeb.entry.js} +1 -1
  1152. package/dist/magma-components/{p-02fe26b4.system.entry.js → p-2216f207.system.entry.js} +2 -2
  1153. package/dist/magma-components/{p-edf003f1.system.entry.js → p-22f24125.system.entry.js} +1 -1
  1154. package/dist/magma-components/{p-6560b426.system.entry.js → p-25c07b67.system.entry.js} +1 -1
  1155. package/dist/magma-components/{p-e3a65644.entry.js → p-29fbb7cf.entry.js} +1 -1
  1156. package/dist/magma-components/{p-f7147d05.entry.js → p-2a26b614.entry.js} +1 -1
  1157. package/dist/magma-components/p-2a6c2a41.entry.js +1 -0
  1158. package/dist/magma-components/{p-06fde29d.entry.js → p-2c28056d.entry.js} +1 -1
  1159. package/dist/magma-components/{p-23722401.entry.js → p-2c5e5cd1.entry.js} +1 -1
  1160. package/dist/magma-components/{p-d92ccce5.system.entry.js → p-2c7d091e.system.entry.js} +3 -3
  1161. package/dist/magma-components/{p-3abaa053.entry.js → p-2c997b47.entry.js} +1 -1
  1162. package/dist/magma-components/{p-0a8e8525.entry.js → p-2f39f4e4.entry.js} +1 -1
  1163. package/dist/magma-components/{p-02298ed0.system.entry.js → p-31370fdb.system.entry.js} +1 -1
  1164. package/dist/magma-components/{p-3df07021.system.entry.js → p-3139988c.system.entry.js} +1 -1
  1165. package/dist/magma-components/p-32418266.entry.js +1 -0
  1166. package/dist/magma-components/{p-cc9659e1.system.entry.js → p-33c80de3.system.entry.js} +1 -1
  1167. package/dist/magma-components/{p-09a7b578.system.entry.js → p-34c0e63c.system.entry.js} +1 -1
  1168. package/dist/magma-components/{p-3c669cfb.entry.js → p-354a5b47.entry.js} +1 -1
  1169. package/dist/magma-components/{p-071f5c7b.system.entry.js → p-35c6341a.system.entry.js} +3 -3
  1170. package/dist/magma-components/{p-f09b08f9.entry.js → p-379f51a6.entry.js} +1 -1
  1171. package/dist/magma-components/{p-7c217aa5.entry.js → p-381f49ea.entry.js} +1 -1
  1172. package/dist/magma-components/{p-221c2f0d.entry.js → p-384ab014.entry.js} +1 -1
  1173. package/dist/magma-components/{p-6af00399.system.entry.js → p-386bb24e.system.entry.js} +3 -3
  1174. package/dist/magma-components/{p-1e18fcc5.system.entry.js → p-39a2df98.system.entry.js} +1 -1
  1175. package/dist/magma-components/{p-2752b45a.system.entry.js → p-3a7c4314.system.entry.js} +3 -3
  1176. package/dist/magma-components/{p-7be0d28b.entry.js → p-3a9a75e5.entry.js} +1 -1
  1177. package/dist/magma-components/{p-5435f2a9.entry.js → p-3b691cc3.entry.js} +1 -1
  1178. package/dist/magma-components/{p-88460d31.system.entry.js → p-3bdb541f.system.entry.js} +1 -1
  1179. package/dist/magma-components/{p-85fb1d08.entry.js → p-3ca004c3.entry.js} +1 -1
  1180. package/dist/magma-components/{p-4776ac1f.entry.js → p-3caf6a26.entry.js} +1 -1
  1181. package/dist/magma-components/{p-ced3ebb8.entry.js → p-3dccd446.entry.js} +1 -1
  1182. package/dist/magma-components/{p-55b10b70.system.entry.js → p-3dde41b0.system.entry.js} +1 -1
  1183. package/dist/magma-components/{p-be6e156a.system.entry.js → p-3e8e0003.system.entry.js} +2 -2
  1184. package/dist/magma-components/{p-21547758.system.entry.js → p-3f0e6729.system.entry.js} +3 -3
  1185. package/dist/magma-components/{p-f306b5c1.entry.js → p-42ab27de.entry.js} +1 -1
  1186. package/dist/magma-components/{p-803957de.system.entry.js → p-430a4c4b.system.entry.js} +1 -1
  1187. package/dist/magma-components/{p-d48c40ab.system.entry.js → p-47b05fa1.system.entry.js} +1 -1
  1188. package/dist/magma-components/{p-e5eb2390.entry.js → p-47db3155.entry.js} +1 -1
  1189. package/dist/magma-components/{p-2c845743.system.entry.js → p-48f86057.system.entry.js} +1 -1
  1190. package/dist/magma-components/{p-7961c335.system.entry.js → p-4a72d72c.system.entry.js} +1 -1
  1191. package/dist/magma-components/{p-227f57e6.entry.js → p-4aa94380.entry.js} +1 -1
  1192. package/dist/magma-components/{p-b9ca6c2e.entry.js → p-4ab2eb7e.entry.js} +1 -1
  1193. package/dist/magma-components/{p-c3c487aa.system.entry.js → p-4bea91e1.system.entry.js} +1 -1
  1194. package/dist/magma-components/{p-f588cf9e.entry.js → p-4cd21f19.entry.js} +1 -1
  1195. package/dist/magma-components/{p-dbca23af.entry.js → p-4de89d1b.entry.js} +1 -1
  1196. package/dist/magma-components/{p-23fabd66.system.entry.js → p-50c8f36c.system.entry.js} +1 -1
  1197. package/dist/magma-components/{p-f39416e9.system.entry.js → p-5200ab23.system.entry.js} +2 -2
  1198. package/dist/magma-components/{p-f35608b2.entry.js → p-52211fa3.entry.js} +1 -1
  1199. package/dist/magma-components/{p-37487e8b.system.entry.js → p-53981624.system.entry.js} +1 -1
  1200. package/dist/magma-components/p-53acdc6b.entry.js +1 -0
  1201. package/dist/magma-components/p-5660182a.system.entry.js +1 -0
  1202. package/dist/magma-components/{p-464e6431.entry.js → p-56c5ca6f.entry.js} +1 -1
  1203. package/dist/magma-components/p-57e92942.system.entry.js +20 -0
  1204. package/dist/magma-components/{p-63b10a6e.entry.js → p-59aa4994.entry.js} +1 -1
  1205. package/dist/magma-components/{p-9a3ddc91.entry.js → p-59f06b9c.entry.js} +1 -1
  1206. package/dist/magma-components/{p-3d95e688.system.entry.js → p-5aa78075.system.entry.js} +3 -3
  1207. package/dist/magma-components/{p-14635a8f.entry.js → p-5cf87a7f.entry.js} +1 -1
  1208. package/dist/magma-components/{p-87baf82a.entry.js → p-5e8df58d.entry.js} +1 -1
  1209. package/dist/magma-components/{p-880f3eac.system.entry.js → p-5ed74216.system.entry.js} +1 -1
  1210. package/dist/magma-components/{p-50705d36.system.entry.js → p-5f064376.system.entry.js} +1 -1
  1211. package/dist/magma-components/{p-93d7485d.entry.js → p-60727165.entry.js} +2 -2
  1212. package/dist/magma-components/{p-278c362d.entry.js → p-6093aa8e.entry.js} +1 -1
  1213. package/dist/magma-components/{p-b8a59768.entry.js → p-62d9eaca.entry.js} +1 -1
  1214. package/dist/magma-components/{p-947fcf74.system.entry.js → p-6b402a09.system.entry.js} +9 -9
  1215. package/dist/magma-components/p-6b55c5fe.system.entry.js +1 -0
  1216. package/dist/magma-components/{p-3d162e99.system.entry.js → p-6d57674c.system.entry.js} +2 -2
  1217. package/dist/magma-components/p-6d96d223.entry.js +1 -0
  1218. package/dist/magma-components/{p-38b16983.system.entry.js → p-6df26141.system.entry.js} +3 -3
  1219. package/dist/magma-components/{p-5f8db04c.system.entry.js → p-6df7da52.system.entry.js} +1 -1
  1220. package/dist/magma-components/{p-9250ec26.system.entry.js → p-6e751bcc.system.entry.js} +2 -2
  1221. package/dist/magma-components/{p-fc22f5e0.system.entry.js → p-718d6384.system.entry.js} +1 -1
  1222. package/dist/magma-components/{p-b4633c9c.system.entry.js → p-71dab494.system.entry.js} +3 -3
  1223. package/dist/magma-components/{p-ec635255.entry.js → p-732d09b6.entry.js} +1 -1
  1224. package/dist/magma-components/{p-fac6f123.entry.js → p-73f4f67e.entry.js} +1 -1
  1225. package/dist/magma-components/{p-772c18f4.entry.js → p-785fa112.entry.js} +1 -1
  1226. package/dist/magma-components/{p-9cf81575.system.entry.js → p-79fd07e7.system.entry.js} +1 -1
  1227. package/dist/magma-components/{p-0033cb92.system.entry.js → p-7acbc6ea.system.entry.js} +1 -1
  1228. package/dist/magma-components/{p-67eb3881.entry.js → p-7dd0364b.entry.js} +1 -1
  1229. package/dist/magma-components/{p-85a31141.entry.js → p-7e7391fd.entry.js} +1 -1
  1230. package/dist/magma-components/{p-f5326224.system.entry.js → p-7ec28ff1.system.entry.js} +2 -2
  1231. package/dist/magma-components/{p-f901c844.entry.js → p-7f74ec99.entry.js} +1 -1
  1232. package/dist/magma-components/{p-0679c988.system.entry.js → p-7ffce9e8.system.entry.js} +1 -1
  1233. package/dist/magma-components/{p-06ccc40d.entry.js → p-81212e34.entry.js} +1 -1
  1234. package/dist/magma-components/{p-cf6f54e5.system.entry.js → p-8219e58f.system.entry.js} +2 -2
  1235. package/dist/magma-components/{p-eb92312f.system.entry.js → p-84711ab6.system.entry.js} +3 -3
  1236. package/dist/magma-components/p-84bf333b.entry.js +1 -0
  1237. package/dist/magma-components/{p-4792ff7f.entry.js → p-84d0d701.entry.js} +1 -1
  1238. package/dist/magma-components/{p-30be5c39.entry.js → p-857ae762.entry.js} +1 -1
  1239. package/dist/magma-components/{p-8f63f1a1.system.entry.js → p-87395a4d.system.entry.js} +1 -1
  1240. package/dist/magma-components/{p-2431fbfa.system.entry.js → p-87831da2.system.entry.js} +1 -1
  1241. package/dist/magma-components/{p-e39518b4.system.entry.js → p-896310aa.system.entry.js} +2 -2
  1242. package/dist/magma-components/{p-dc1a5826.system.entry.js → p-8ac1ba5c.system.entry.js} +1 -1
  1243. package/dist/magma-components/{p-86cf87fb.entry.js → p-8b8a6662.entry.js} +1 -1
  1244. package/dist/magma-components/{p-62fc9695.entry.js → p-8d7093af.entry.js} +1 -1
  1245. package/dist/magma-components/{p-8ab9ff37.system.entry.js → p-8e15c151.system.entry.js} +1 -1
  1246. package/dist/magma-components/{p-075acd04.entry.js → p-8f1c529f.entry.js} +1 -1
  1247. package/dist/magma-components/{p-07a3c63c.system.entry.js → p-8f1e9021.system.entry.js} +1 -1
  1248. package/dist/magma-components/{p-69abd1d1.entry.js → p-904c1222.entry.js} +1 -1
  1249. package/dist/magma-components/{p-a70fb4fb.system.entry.js → p-907f06cd.system.entry.js} +9 -9
  1250. package/dist/magma-components/{p-3f68ddca.entry.js → p-9332358d.entry.js} +1 -1
  1251. package/dist/magma-components/{p-44998584.system.entry.js → p-93b9d39d.system.entry.js} +2 -2
  1252. package/dist/magma-components/{p-d8ae0f02.system.entry.js → p-965e7a82.system.entry.js} +1 -1
  1253. package/dist/magma-components/{p-c50e20cf.system.entry.js → p-96dfb60e.system.entry.js} +1 -1
  1254. package/dist/magma-components/{p-3beea731.system.entry.js → p-9c408768.system.entry.js} +1 -1
  1255. package/dist/magma-components/{p-1d2220f0.system.entry.js → p-9e792bed.system.entry.js} +1 -1
  1256. package/dist/magma-components/{p-8258733b.entry.js → p-9fdd477a.entry.js} +1 -1
  1257. package/dist/magma-components/{p-f82c2b7e.system.entry.js → p-9fefa077.system.entry.js} +1 -1
  1258. package/dist/magma-components/p-B8zYiZQY.system.js +2 -2
  1259. package/dist/magma-components/{p-97eb734a.system.entry.js → p-a0d637b6.system.entry.js} +1 -1
  1260. package/dist/magma-components/p-a26c05b6.entry.js +1 -0
  1261. package/dist/magma-components/{p-ccc40c6a.system.entry.js → p-a7baf451.system.entry.js} +2 -2
  1262. package/dist/magma-components/{p-77545238.entry.js → p-ac9feb04.entry.js} +1 -1
  1263. package/dist/magma-components/{p-dedbf8d6.entry.js → p-ad383f92.entry.js} +1 -1
  1264. package/dist/magma-components/{p-1ea582a9.system.entry.js → p-ae4736a0.system.entry.js} +3 -3
  1265. package/dist/magma-components/{p-9fc385aa.entry.js → p-b3332c5f.entry.js} +1 -1
  1266. package/dist/magma-components/{p-a987086b.system.entry.js → p-b3e2b68a.system.entry.js} +1 -1
  1267. package/dist/magma-components/{p-808b9277.entry.js → p-b86144d4.entry.js} +1 -1
  1268. package/dist/magma-components/{p-a0612465.system.entry.js → p-bbde5701.system.entry.js} +1 -1
  1269. package/dist/magma-components/{p-5472f18d.system.entry.js → p-bc075b3b.system.entry.js} +2 -2
  1270. package/dist/magma-components/{p-29971e1d.entry.js → p-bc19b136.entry.js} +1 -1
  1271. package/dist/magma-components/{p-17ec24dc.entry.js → p-bcca26d9.entry.js} +1 -1
  1272. package/dist/magma-components/{p-8b501f92.entry.js → p-bf35627d.entry.js} +1 -1
  1273. package/dist/magma-components/p-bfd95736.entry.js +1 -0
  1274. package/dist/magma-components/{p-6a2d67d1.system.entry.js → p-c086a5a4.system.entry.js} +1 -1
  1275. package/dist/magma-components/{p-41a0f896.entry.js → p-c27206ca.entry.js} +1 -1
  1276. package/dist/magma-components/{p-762a6b7b.entry.js → p-c2758b81.entry.js} +1 -1
  1277. package/dist/magma-components/{p-d3491226.system.entry.js → p-c2c693ed.system.entry.js} +1 -1
  1278. package/dist/magma-components/{p-642925b7.system.entry.js → p-c4a5ab6e.system.entry.js} +1 -1
  1279. package/dist/magma-components/{p-b23bee0c.entry.js → p-c58157cf.entry.js} +1 -1
  1280. package/dist/magma-components/{p-8a9544aa.entry.js → p-c597ad47.entry.js} +1 -1
  1281. package/dist/magma-components/{p-295d8fab.entry.js → p-c7b2ebb5.entry.js} +1 -1
  1282. package/dist/magma-components/{p-046697e4.system.entry.js → p-c8b06821.system.entry.js} +1 -1
  1283. package/dist/magma-components/p-ca1143bc.entry.js +1 -0
  1284. package/dist/magma-components/p-cb88fa71.entry.js +1 -0
  1285. package/dist/magma-components/{p-cc954b22.system.entry.js → p-cd783f9e.system.entry.js} +1 -1
  1286. package/dist/magma-components/{p-bd97e368.system.entry.js → p-cd955bc7.system.entry.js} +1 -1
  1287. package/dist/magma-components/{p-1f623b75.entry.js → p-ce42e251.entry.js} +1 -1
  1288. package/dist/magma-components/{p-7bf46d43.entry.js → p-cf4f4561.entry.js} +1 -1
  1289. package/dist/magma-components/{p-44333d50.system.entry.js → p-d0a15a3a.system.entry.js} +1 -1
  1290. package/dist/magma-components/{p-f616f467.entry.js → p-d218ae47.entry.js} +1 -1
  1291. package/dist/magma-components/{p-69badbba.entry.js → p-d331ff5c.entry.js} +1 -1
  1292. package/dist/magma-components/{p-f75935ed.system.entry.js → p-d3844c9a.system.entry.js} +4 -4
  1293. package/dist/magma-components/{p-837d31b8.entry.js → p-d3ac9a1a.entry.js} +1 -1
  1294. package/dist/magma-components/{p-8740403e.system.entry.js → p-d4c3250f.system.entry.js} +2 -2
  1295. package/dist/magma-components/p-d638bbb0.entry.js +1 -0
  1296. package/dist/magma-components/{p-72ad419d.system.entry.js → p-d65e9f0a.system.entry.js} +1 -1
  1297. package/dist/magma-components/{p-7d0c8177.entry.js → p-d87ecd68.entry.js} +1 -1
  1298. package/dist/magma-components/{p-2e48f88d.system.entry.js → p-d93b48b4.system.entry.js} +1 -1
  1299. package/dist/magma-components/{p-de1ae02c.entry.js → p-d94281cb.entry.js} +1 -1
  1300. package/dist/magma-components/{p-b467f737.entry.js → p-d9f92ff8.entry.js} +1 -1
  1301. package/dist/magma-components/{p-4cabfdbc.entry.js → p-da9bc02a.entry.js} +1 -1
  1302. package/dist/magma-components/{p-521ba3a8.entry.js → p-dc618cae.entry.js} +1 -1
  1303. package/dist/magma-components/p-de38f745.entry.js +1 -0
  1304. package/dist/magma-components/{p-e2fa6300.system.entry.js → p-dee123c7.system.entry.js} +1 -1
  1305. package/dist/magma-components/p-df387755.entry.js +1 -0
  1306. package/dist/magma-components/{p-b373cc32.entry.js → p-dfab370b.entry.js} +1 -1
  1307. package/dist/magma-components/{p-0e887379.system.entry.js → p-e30d0684.system.entry.js} +2 -2
  1308. package/dist/magma-components/{p-f66675f5.system.entry.js → p-e371f9e1.system.entry.js} +1 -1
  1309. package/dist/magma-components/{p-8f7daab1.system.entry.js → p-e3b9ea0b.system.entry.js} +1 -1
  1310. package/dist/magma-components/{p-104ba54e.system.entry.js → p-e3d262d9.system.entry.js} +2 -2
  1311. package/dist/magma-components/{p-7fde3025.system.entry.js → p-e54587e7.system.entry.js} +3 -3
  1312. package/dist/magma-components/{p-ad05ef26.system.entry.js → p-e5f893f9.system.entry.js} +1 -1
  1313. package/dist/magma-components/{p-2c3f518c.system.entry.js → p-e709a52e.system.entry.js} +2 -2
  1314. package/dist/magma-components/{p-8d14f146.entry.js → p-e8452cce.entry.js} +1 -1
  1315. package/dist/magma-components/{p-09f621ea.entry.js → p-ea503851.entry.js} +1 -1
  1316. package/dist/magma-components/{p-6dff107d.system.entry.js → p-ec44a4ea.system.entry.js} +2 -2
  1317. package/dist/magma-components/{p-9f6c502b.entry.js → p-ed133270.entry.js} +1 -1
  1318. package/dist/magma-components/{p-bb282bc1.system.entry.js → p-ee780f82.system.entry.js} +2 -2
  1319. package/dist/magma-components/p-ef4ee9ca.entry.js +1 -0
  1320. package/dist/magma-components/{p-7ca73c56.entry.js → p-f045b018.entry.js} +1 -1
  1321. package/dist/magma-components/{p-b69c3126.entry.js → p-f2211b1f.entry.js} +1 -1
  1322. package/dist/magma-components/{p-c40ad03a.entry.js → p-f267ff68.entry.js} +1 -1
  1323. package/dist/magma-components/{p-d254de66.system.entry.js → p-f27de6cb.system.entry.js} +1 -1
  1324. package/dist/magma-components/{p-2d9c9ef9.entry.js → p-f2ef884c.entry.js} +1 -1
  1325. package/dist/magma-components/{p-9f8ce68f.entry.js → p-f3f88f32.entry.js} +1 -1
  1326. package/dist/magma-components/{p-94439d8b.system.entry.js → p-f40e3918.system.entry.js} +2 -2
  1327. package/dist/magma-components/{p-6e32bf99.entry.js → p-f4181b35.entry.js} +1 -1
  1328. package/dist/magma-components/{p-8a76097f.entry.js → p-f4351160.entry.js} +1 -1
  1329. package/dist/magma-components/{p-c3a3caae.system.entry.js → p-f4fc9f29.system.entry.js} +1 -1
  1330. package/dist/magma-components/{p-da93a00b.system.entry.js → p-f5c7b147.system.entry.js} +1 -1
  1331. package/dist/magma-components/{p-84ed22ea.system.entry.js → p-f7d5445c.system.entry.js} +1 -1
  1332. package/dist/magma-components/{p-08370fc2.system.entry.js → p-f7e9af99.system.entry.js} +1 -1
  1333. package/dist/magma-components/{p-95478664.system.entry.js → p-f8c85ad7.system.entry.js} +1 -1
  1334. package/dist/magma-components/{p-c6819aad.entry.js → p-f9b601de.entry.js} +1 -1
  1335. package/dist/magma-components/{p-ffbf7448.entry.js → p-fa44d0d2.entry.js} +1 -1
  1336. package/dist/magma-components/{p-d3d74616.entry.js → p-fba648e0.entry.js} +1 -1
  1337. package/dist/magma-components/{p-35528bdd.system.entry.js → p-fe8e3721.system.entry.js} +1 -1
  1338. package/dist/magma-components/{p-2a4d22c9.system.entry.js → p-fe98a77e.system.entry.js} +2 -2
  1339. package/dist/magma-components/{p-8ca2e879.system.entry.js → p-ff7fc1f6.system.entry.js} +2 -2
  1340. package/dist/stats.json +3133 -1157
  1341. package/dist/types/components/mds-accordion/mds-accordion.d.ts +1 -0
  1342. package/dist/types/components/mds-accordion-item/mds-accordion-item.d.ts +1 -0
  1343. package/dist/types/components/mds-accordion-timer/mds-accordion-timer.d.ts +1 -0
  1344. package/dist/types/components/mds-accordion-timer-item/mds-accordion-timer-item.d.ts +1 -0
  1345. package/dist/types/components/mds-author/mds-author.d.ts +1 -0
  1346. package/dist/types/components/mds-avatar/mds-avatar.d.ts +1 -0
  1347. package/dist/types/components/mds-avatar-stack/mds-avatar-stack.d.ts +1 -0
  1348. package/dist/types/components/mds-avatar-stack-item/mds-avatar-stack-item.d.ts +3 -0
  1349. package/dist/types/components/mds-badge/mds-badge.d.ts +1 -0
  1350. package/dist/types/components/mds-banner/mds-banner.d.ts +1 -0
  1351. package/dist/types/components/mds-benchmark-bar/mds-benchmark-bar.d.ts +1 -0
  1352. package/dist/types/components/mds-bibliography/mds-bibliography.d.ts +3 -0
  1353. package/dist/types/components/mds-book/mds-book.d.ts +114 -0
  1354. package/dist/types/components/mds-book/meta/dictionary.d.ts +4 -0
  1355. package/dist/types/components/mds-book/meta/format.d.ts +30 -0
  1356. package/dist/types/components/mds-book/meta/pose.d.ts +64 -0
  1357. package/dist/types/components/mds-book/meta/spine.d.ts +33 -0
  1358. package/dist/types/components/mds-book/meta/types.d.ts +3 -0
  1359. package/dist/types/components/mds-book/meta/volume.d.ts +22 -0
  1360. package/dist/types/components/mds-breadcrumb/mds-breadcrumb.d.ts +1 -0
  1361. package/dist/types/components/mds-breadcrumb-item/mds-breadcrumb-item.d.ts +1 -0
  1362. package/dist/types/components/mds-button/mds-button.d.ts +1 -0
  1363. package/dist/types/components/mds-button-dropdown/mds-button-dropdown.d.ts +1 -0
  1364. package/dist/types/components/mds-button-group/mds-button-group.d.ts +1 -0
  1365. package/dist/types/components/mds-calendar/mds-calendar.d.ts +1 -0
  1366. package/dist/types/components/mds-calendar-cell/mds-calendar-cell.d.ts +3 -0
  1367. package/dist/types/components/mds-card/mds-card.d.ts +1 -0
  1368. package/dist/types/components/mds-card-content/mds-card-content.d.ts +1 -0
  1369. package/dist/types/components/mds-card-footer/mds-card-footer.d.ts +1 -0
  1370. package/dist/types/components/mds-card-header/mds-card-header.d.ts +1 -0
  1371. package/dist/types/components/mds-card-media/mds-card-media.d.ts +1 -0
  1372. package/dist/types/components/mds-chip/mds-chip.d.ts +3 -0
  1373. package/dist/types/components/mds-details/mds-details.d.ts +1 -0
  1374. package/dist/types/components/mds-dropdown/mds-dropdown.d.ts +1 -0
  1375. package/dist/types/components/mds-emoji/mds-emoji.d.ts +3 -0
  1376. package/dist/types/components/mds-entity/mds-entity.d.ts +1 -0
  1377. package/dist/types/components/mds-file/mds-file.d.ts +3 -0
  1378. package/dist/types/components/mds-file-preview/mds-file-preview.d.ts +1 -0
  1379. package/dist/types/components/mds-filter/mds-filter.d.ts +1 -0
  1380. package/dist/types/components/mds-filter-item/mds-filter-item.d.ts +3 -0
  1381. package/dist/types/components/mds-header/mds-header.d.ts +1 -0
  1382. package/dist/types/components/mds-header-bar/mds-header-bar.d.ts +1 -0
  1383. package/dist/types/components/mds-help/mds-help.d.ts +1 -0
  1384. package/dist/types/components/mds-horizontal-scroll/mds-horizontal-scroll.d.ts +1 -0
  1385. package/dist/types/components/mds-hr/mds-hr.d.ts +3 -0
  1386. package/dist/types/components/mds-icon/mds-icon.d.ts +1 -0
  1387. package/dist/types/components/mds-img/mds-img.d.ts +1 -0
  1388. package/dist/types/components/mds-input/mds-input.d.ts +1 -0
  1389. package/dist/types/components/mds-input-date/mds-input-date.d.ts +1 -0
  1390. package/dist/types/components/mds-input-date-range/mds-input-date-range.d.ts +1 -0
  1391. package/dist/types/components/mds-input-date-range-preselection/mds-input-date-range-preselection.d.ts +1 -0
  1392. package/dist/types/components/mds-input-field/mds-input-field.d.ts +1 -0
  1393. package/dist/types/components/mds-input-otp/mds-input-otp.d.ts +3 -0
  1394. package/dist/types/components/mds-input-range/mds-input-range.d.ts +1 -0
  1395. package/dist/types/components/mds-input-select/mds-input-select.d.ts +1 -0
  1396. package/dist/types/components/mds-input-switch/mds-input-switch.d.ts +1 -0
  1397. package/dist/types/components/mds-input-tip/mds-input-tip.d.ts +1 -0
  1398. package/dist/types/components/mds-input-tip-item/mds-input-tip-item.d.ts +1 -0
  1399. package/dist/types/components/mds-input-upload/mds-input-upload.d.ts +3 -0
  1400. package/dist/types/components/mds-keyboard/mds-keyboard.d.ts +1 -0
  1401. package/dist/types/components/mds-keyboard-key/mds-keyboard-key.d.ts +3 -0
  1402. package/dist/types/components/mds-kpi/mds-kpi.d.ts +1 -0
  1403. package/dist/types/components/mds-kpi-item/mds-kpi-item.d.ts +1 -0
  1404. package/dist/types/components/mds-label/mds-label.d.ts +3 -0
  1405. package/dist/types/components/mds-link/mds-link.d.ts +1 -0
  1406. package/dist/types/components/mds-list/mds-list.d.ts +1 -0
  1407. package/dist/types/components/mds-list-item/mds-list-item.d.ts +1 -0
  1408. package/dist/types/components/mds-mention/mds-mention.d.ts +3 -0
  1409. package/dist/types/components/mds-modal/mds-modal.d.ts +1 -0
  1410. package/dist/types/components/mds-note/mds-note.d.ts +1 -0
  1411. package/dist/types/components/mds-notification/mds-notification.d.ts +3 -0
  1412. package/dist/types/components/mds-paginator/mds-paginator.d.ts +3 -0
  1413. package/dist/types/components/mds-paginator-item/mds-paginator-item.d.ts +1 -0
  1414. package/dist/types/components/mds-policy-ai/mds-policy-ai.d.ts +1 -0
  1415. package/dist/types/components/mds-pref/mds-pref.d.ts +1 -1
  1416. package/dist/types/components/mds-pref-animation/mds-pref-animation.d.ts +3 -0
  1417. package/dist/types/components/mds-pref-consumption/mds-pref-consumption.d.ts +3 -0
  1418. package/dist/types/components/mds-pref-contrast/mds-pref-contrast.d.ts +3 -0
  1419. package/dist/types/components/mds-pref-language/mds-pref-language.d.ts +1 -0
  1420. package/dist/types/components/mds-pref-language-item/mds-pref-language-item.d.ts +3 -0
  1421. package/dist/types/components/mds-pref-mode/mds-pref-mode.d.ts +3 -0
  1422. package/dist/types/components/mds-pref-theme/mds-pref-theme.d.ts +1 -0
  1423. package/dist/types/components/mds-pref-theme-item/mds-pref-theme-item.d.ts +3 -0
  1424. package/dist/types/components/mds-price-table/mds-price-table.d.ts +1 -0
  1425. package/dist/types/components/mds-price-table-features/mds-price-table-features.d.ts +1 -0
  1426. package/dist/types/components/mds-price-table-features-cell/mds-price-table-features-cell.d.ts +1 -0
  1427. package/dist/types/components/mds-price-table-features-row/mds-price-table-features-row.d.ts +1 -0
  1428. package/dist/types/components/mds-price-table-header/mds-price-table-header.d.ts +1 -0
  1429. package/dist/types/components/mds-price-table-list/mds-price-table-list.d.ts +1 -0
  1430. package/dist/types/components/mds-price-table-list-item/mds-price-table-list-item.d.ts +1 -0
  1431. package/dist/types/components/mds-progress/mds-progress.d.ts +1 -0
  1432. package/dist/types/components/mds-push-notification/mds-push-notification.d.ts +1 -0
  1433. package/dist/types/components/mds-push-notification-item/mds-push-notification-item.d.ts +1 -0
  1434. package/dist/types/components/mds-quote/mds-quote.d.ts +1 -0
  1435. package/dist/types/components/mds-radial-menu/mds-radial-menu.d.ts +1 -0
  1436. package/dist/types/components/mds-radial-menu-item/mds-radial-menu-item.d.ts +3 -0
  1437. package/dist/types/components/mds-radial-progress/mds-radial-progress.d.ts +1 -0
  1438. package/dist/types/components/mds-separator/mds-separator.d.ts +3 -0
  1439. package/dist/types/components/mds-spinner/mds-spinner.d.ts +3 -0
  1440. package/dist/types/components/mds-status-bar/mds-status-bar.d.ts +1 -0
  1441. package/dist/types/components/mds-stepper-bar/mds-stepper-bar.d.ts +1 -0
  1442. package/dist/types/components/mds-stepper-bar-item/mds-stepper-bar-item.d.ts +1 -0
  1443. package/dist/types/components/mds-tab/mds-tab.d.ts +1 -0
  1444. package/dist/types/components/mds-tab-bar/mds-tab-bar.d.ts +1 -0
  1445. package/dist/types/components/mds-tab-bar-item/mds-tab-bar-item.d.ts +1 -0
  1446. package/dist/types/components/mds-tab-item/mds-tab-item.d.ts +1 -0
  1447. package/dist/types/components/mds-table/mds-table.d.ts +1 -0
  1448. package/dist/types/components/mds-table-body/mds-table-body.d.ts +1 -0
  1449. package/dist/types/components/mds-table-cell/mds-table-cell.d.ts +1 -0
  1450. package/dist/types/components/mds-table-footer/mds-table-footer.d.ts +1 -0
  1451. package/dist/types/components/mds-table-header/mds-table-header.d.ts +1 -0
  1452. package/dist/types/components/mds-table-header-cell/mds-table-header-cell.d.ts +1 -0
  1453. package/dist/types/components/mds-table-row/mds-table-row.d.ts +1 -0
  1454. package/dist/types/components/mds-text/mds-text.d.ts +1 -0
  1455. package/dist/types/components/mds-toast/mds-toast.d.ts +1 -0
  1456. package/dist/types/components/mds-toast-region/mds-toast-region.d.ts +1 -0
  1457. package/dist/types/components/mds-tooltip/mds-tooltip.d.ts +1 -0
  1458. package/dist/types/components/mds-tree/mds-tree.d.ts +1 -0
  1459. package/dist/types/components/mds-tree-item/mds-tree-item.d.ts +1 -0
  1460. package/dist/types/components/mds-url-view/mds-url-view.d.ts +3 -0
  1461. package/dist/types/components/mds-usage/mds-usage.d.ts +1 -0
  1462. package/dist/types/components/mds-video-wall/mds-video-wall.d.ts +1 -0
  1463. package/dist/types/components/mds-zero/mds-zero.d.ts +1 -0
  1464. package/dist/types/components.d.ts +1517 -6
  1465. package/package.json +43 -5
  1466. package/dist/components/p-B0AnE3sA.js +0 -1
  1467. package/dist/components/p-CHHEp_7y.js +0 -1
  1468. package/dist/components/p-D8wd-EZX.js +0 -1
  1469. package/dist/magma-components/p-0193734e.entry.js +0 -1
  1470. package/dist/magma-components/p-083dceb8.system.entry.js +0 -1
  1471. package/dist/magma-components/p-093b8fbc.system.entry.js +0 -20
  1472. package/dist/magma-components/p-0e2cd21e.entry.js +0 -1
  1473. package/dist/magma-components/p-11320427.entry.js +0 -1
  1474. package/dist/magma-components/p-1c2c4670.entry.js +0 -1
  1475. package/dist/magma-components/p-335244bb.entry.js +0 -1
  1476. package/dist/magma-components/p-3fb46ab9.system.entry.js +0 -1
  1477. package/dist/magma-components/p-4d485e1f.system.entry.js +0 -1
  1478. package/dist/magma-components/p-6436178a.entry.js +0 -1
  1479. package/dist/magma-components/p-7ad68b2f.entry.js +0 -1
  1480. package/dist/magma-components/p-89d4b6e9.entry.js +0 -1
  1481. package/dist/magma-components/p-984dd850.entry.js +0 -1
  1482. package/dist/magma-components/p-a7c01334.entry.js +0 -1
  1483. package/dist/magma-components/p-ab4b617d.entry.js +0 -1
  1484. package/dist/magma-components/p-d6b38d8a.entry.js +0 -1
  1485. package/dist/magma-components/p-e1383302.entry.js +0 -1
@@ -1,5 +1,5 @@
1
1
  {
2
- "timestamp": "2026-10-22T13:02:36",
2
+ "timestamp": "2026-10-24T18:39:37",
3
3
  "compiler": {
4
4
  "name": "@stencil/core",
5
5
  "version": "4.45.2",
@@ -23,12 +23,16 @@
23
23
  {
24
24
  "name": "part",
25
25
  "text": "media - The media displayed"
26
+ },
27
+ {
28
+ "name": "category",
29
+ "text": "data"
26
30
  }
27
31
  ],
28
32
  "usage": {
29
33
  "1. Description": "The `<mds-avatar>` web component renders a compact, circular representation of a user or entity in the Magma Design System. It resolves a single visual from whichever input is provided - a profile image, textual initials, a numeric overflow count, or an icon - and falls back to a generic person glyph when nothing usable is supplied.\n\n#### Semantic Behavior\n\n- **Content resolution**: Exactly one visual is shown at a time, picked in one order: `count`, then the `src` image, then `initials`, then `icon`, then the generic person fallback. A source hides the ones after it, so `initials` or `icon` next to `src` are the fallbacks of the image.\n- **Deterministic identity color**: When `initials` is set, the component derives the color from its characters, so the same person always maps to the same color and stays distinguishable from others. Any explicit `variant` is ignored in this case; `count` derives no color and keeps the `variant`.\n- **Image load fallback**: If the `src` image fails to load, the avatar shows the next source in the order: `initials`, then `icon`, then the generic person fallback icon. A new `src` is tried again.\n- **Auto-fitting initials**: Initials and count text scale to fit the avatar, so they stay legible across every size.\n- **Initials display**: The first two characters of `initials` are displayed as they are, uppercased, so pass the initials (`MR`), not the full name. Non-alphanumeric characters are stripped only to compute the color.\n\n#### Properties & Visual Configurations\n\nThe shared `variant` / `tone` ladders are defined in [`agents/variants.md`](../../../../agents/variants.md). Note that `tone` is limited to the minimal set (`'strong'` / `'weak'`), and any explicit `variant` is ignored whenever `initials` is present, since identity color takes precedence.\n\n#### Other behavioral props\n\n- **`src`** is the path to a profile image; prefer it when a real photo is available. Only `count` hides it; `initials` and `icon` set as well show when the image fails to load.\n- **`initials`** carries the textual stand-in for a user when no image exists; it drives the deterministic identity color.\n- **`count`** renders a `+N` overflow badge and is intended for stacked/grouped avatar scenarios rather than individual users.\n- **`icon`** is an SVG filename slug from the Magma icon library, used when the avatar represents a non-personal entity rather than a human.\n",
30
- "2. Pattern": "Correct and idiomatic ways to use the `<mds-avatar>` component, ordered from most common to most specialized. Patterns assume a working knowledge of the variant / tone ladders documented in [`agents/variants.md`](../../../../agents/variants.md) and the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Profile Image via `src`\n\nThe most common form: supply a URL and the component loads the image lazily. If the image fails to load the component falls back to `initials` (or `icon`) when set, else to the generic person glyph - no extra wiring needed.\n\n```html\n<!-- the initials show if the photo fails to load -->\n<mds-avatar src=\"https://example.com/foto-utente.jpg\" initials=\"MR\"></mds-avatar>\n```\n\n```html\n<mds-avatar src=\"https://example.com/foto-utente.jpg\"></mds-avatar>\n```\n\n#### Initials Fallback\n\nWhen no photo is available, provide the user's initials. The component displays the first two characters, uppercased, so pass the initials rather than the full name. It also derives a deterministic color from the characters (ignoring non-alphanumeric ones) so the same person always maps to the same hue.\n\n```html\n<mds-avatar initials=\"MR\"></mds-avatar>\n<!-- displayed as \"MR\" with a stable identity color -->\n\n<mds-avatar initials=\"ab\"></mds-avatar>\n<!-- displayed as \"AB\" -->\n```\n\n#### Manual Variant and Tone (no initials)\n\nWhen `initials` is not set, you can control the avatar background and icon color through `variant` and `tone`. Use this for non-personal entity avatars where identity color is not required.\n\n```html\n<!-- Primary brand color, filled -->\n<mds-avatar variant=\"primary\" tone=\"strong\" icon=\"mi/baseline/support-agent\"></mds-avatar>\n\n<!-- Success semantic, weak tint -->\n<mds-avatar variant=\"success\" tone=\"weak\"></mds-avatar>\n```\n\n#### Icon Avatar for Non-Personal Entities\n\nUse `icon` when the avatar represents a system, service, or non-human entity. Reference icons by their slug (no `.svg` extension). The generic person fallback is replaced by the provided icon.\n\n```html\n<mds-avatar icon=\"mi/baseline/business\" variant=\"primary\"></mds-avatar>\n<mds-avatar icon=\"mi/baseline/pets\" variant=\"info\"></mds-avatar>\n```\n\n#### Overflow Count in Stacked Groups\n\nUse `count` to render a \"+N\" overflow badge for the last slot in an avatar stack (e.g. \"3 more\"). The count display overrides every other source (`src`, `initials`, `icon`) and, unlike `initials`, derives no color: it keeps the `variant`. Use inside [`mds-avatar-stack`](../mds-avatar-stack/AGENTS.md) and [`mds-avatar-stack-item`](../mds-avatar-stack-item/AGENTS.md).\n\n```html\n<mds-avatar-stack>\n <mds-avatar-stack-item src=\"https://example.com/foto-01.jpg\"></mds-avatar-stack-item>\n <mds-avatar-stack-item src=\"https://example.com/foto-02.jpg\"></mds-avatar-stack-item>\n <mds-avatar-stack-item count=\"3\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Sizing via Utility Classes\n\n`<mds-avatar>` does not expose a `size` prop - its size is controlled by the host element's `width` (the component uses `aspect-ratio: 1/1` internally). Apply a Magma spacing utility class on the host.\n\n```html\n<!-- Small avatar -->\n<mds-avatar src=\"https://example.com/foto.jpg\" class=\"w-600\"></mds-avatar>\n\n<!-- Default / medium avatar -->\n<mds-avatar src=\"https://example.com/foto.jpg\" class=\"w-1200\"></mds-avatar>\n\n<!-- Large avatar -->\n<mds-avatar src=\"https://example.com/foto.jpg\" class=\"w-2400\"></mds-avatar>\n```\n\n#### Styling Customization\n\nStyle the avatar only through its documented `--mds-avatar-*` CSS custom properties. Use semantic color roles wrapped in `rgb(var(--magma-<role>))` so dark mode and high-contrast modes work correctly.\n\n```css\n.profilo-utente mds-avatar {\n --mds-avatar-background-color: rgb(var(--magma-accent-emphasis));\n --mds-avatar-color: rgb(var(--magma-accent-on-emphasis));\n --mds-avatar-radius: var(--magma-radius-md);\n --mds-avatar-initials-padding: 15%;\n\n corner-shape: var(--magma-corner-shape);\n}\n```\n\n#### Square Avatar via `--mds-avatar-radius`\n\nThe default shape is fully circular. Override the CSS custom property to get a square or rounded-square avatar - for example when representing a product or brand logo rather than a person.\n\nThe circle stays out of the corner axis, so the host declares no corner shape. A step of the `--magma-radius-*` scale is tuned for the shape of the axis: give the host `corner-shape: var(--magma-corner-shape)` with it, and the inner image and initials follow.\n\n```css\n.logo-azienda mds-avatar {\n --mds-avatar-radius: var(--magma-radius-md);\n\n corner-shape: var(--magma-corner-shape);\n}\n```\n\n```html\n<mds-avatar\n class=\"logo-azienda w-1600\"\n src=\"https://example.com/logo-azienda.png\"\n></mds-avatar>\n```\n",
31
- "3. Antipattern": "Common incorrect uses of `<mds-avatar>`. 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 `variant` When `initials` Is Present\n\nThe component derives the background color deterministically from the characters when `initials` is set, and silently overrides any explicit `variant`. Setting `variant` alongside these props is a no-op and misleads readers of the markup.\n\n```html\n<!-- INCORRECT -->\n<mds-avatar initials=\"MR\" variant=\"error\"></mds-avatar>\n\n<!-- CORRECT -->\n<mds-avatar initials=\"MR\"></mds-avatar>\n```\n\n#### Do Not Use `count` for Individual Users\n\n`count` is designed for overflow badges in stacked avatar groups (\"+3 more\"). Using it to represent a single user's identity (e.g. an ID number) produces a \"+N\" label, which is semantically wrong. Use `initials` for individual users.\n\n```html\n<!-- INCORRECT -->\n<mds-avatar count=\"42\"></mds-avatar>\n\n<!-- CORRECT - use initials for individual users -->\n<mds-avatar initials=\"GV\"></mds-avatar>\n```\n\n#### Do Not Override Size with Inline `width` / `height` Styles\n\n`<mds-avatar>` keeps a 1:1 aspect ratio internally. Forcing `width` or `height` via inline styles or arbitrary CSS bypasses the design token grid and can distort the shape. Use a Magma spacing utility class on the host element instead.\n\n```html\n<!-- INCORRECT -->\n<mds-avatar src=\"https://example.com/foto.jpg\" style=\"width: 73px; height: 73px;\"></mds-avatar>\n\n<!-- CORRECT -->\n<mds-avatar src=\"https://example.com/foto.jpg\" class=\"w-1600\"></mds-avatar>\n```\n\n#### Do Not Slot `<img>` to Supply a Profile Photo\n\n`<mds-avatar>` has no slots - it is a self-contained shadow component. Putting a raw `<img>` inside it will have no effect; the component will ignore it and show the fallback person glyph. Use the `src` prop instead.\n\n```html\n<!-- INCORRECT -->\n<mds-avatar>\n <img src=\"https://example.com/foto.jpg\" alt=\"Mario Bianchi\" />\n</mds-avatar>\n\n<!-- CORRECT -->\n<mds-avatar src=\"https://example.com/foto.jpg\"></mds-avatar>\n```\n\n#### Do Not Pierce Shadow DOM to Change Internal Colors\n\nThe supported customization surface is the five documented `--mds-avatar-*` CSS custom properties and, for a deep customisation, the documented parts `wrapper`, `media` and `icon`. Using undocumented part names, `>>>`, or internal class names to target internals couples your code to the Shadow DOM implementation and breaks on minor releases.\n\n```css\n/* INCORRECT */\nmds-avatar::part(initials) {\n background-color: hotpink;\n}\nmds-avatar >>> .initials-text {\n color: white;\n}\n\n/* CORRECT */\nmds-avatar {\n --mds-avatar-background-color: rgb(var(--magma-accent-emphasis));\n --mds-avatar-color: rgb(var(--magma-accent-on-emphasis));\n}\n```\n\n#### Do Not Use a Raw `<img>` or `<div>` as an Avatar\n\nWhen an avatar-style UI element is needed, reach for `<mds-avatar>` rather than hand-rolling a circular `<img>` or `<div>` with CSS. The component handles lazy loading, load errors, initials fallback, pending state, dark mode, and high-contrast mode automatically.\n\n```html\n<!-- INCORRECT -->\n<img\n src=\"https://example.com/foto.jpg\"\n alt=\"Foto di Luca\"\n style=\"border-radius: 50%; width: 48px; height: 48px;\"\n/>\n\n<!-- CORRECT -->\n<mds-avatar src=\"https://example.com/foto.jpg\" class=\"w-1200\"></mds-avatar>\n```\n"
34
+ "2. Pattern": "Correct and idiomatic ways to use the `<mds-avatar>` component, ordered from most common to most specialized. Patterns assume a working knowledge of the variant / tone ladders documented in [`agents/variants.md`](../../../../agents/variants.md) and the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Profile Image via `src`\n\nThe most common form: supply a URL and the component loads the image lazily. If the image fails to load the component falls back to `initials` (or `icon`) when set, else to the generic person glyph - no extra wiring needed.\n\n```html\n<!-- the initials show if the photo fails to load -->\n<mds-avatar src=\"https://example.com/foto-utente.jpg\" initials=\"MR\"></mds-avatar>\n```\n\n```html\n<mds-avatar src=\"https://example.com/foto-utente.jpg\"></mds-avatar>\n```\n\n#### Initials Fallback\n\nWhen no photo is available, provide the user's initials. The component displays the first two characters, uppercased, so pass the initials rather than the full name. It also derives a deterministic color from the characters (ignoring non-alphanumeric ones) so the same person always maps to the same hue.\n\n```html\n<mds-avatar initials=\"MR\"></mds-avatar>\n<!-- displayed as \"MR\" with a stable identity color -->\n\n<mds-avatar initials=\"ab\"></mds-avatar>\n<!-- displayed as \"AB\" -->\n```\n\n#### Manual Variant and Tone (no initials)\n\nWhen `initials` is not set, you can control the avatar background and icon color through `variant` and `tone`. Use this for non-personal entity avatars where identity color is not required.\n\n```html\n<!-- Primary brand color, filled -->\n<mds-avatar variant=\"primary\" tone=\"strong\" icon=\"mi/baseline/support-agent\"></mds-avatar>\n\n<!-- Success semantic, weak tint -->\n<mds-avatar variant=\"success\" tone=\"weak\"></mds-avatar>\n```\n\n#### Icon Avatar for Non-Personal Entities\n\nUse `icon` when the avatar represents a system, service, or non-human entity. Reference icons by their slug (no `.svg` extension). The generic person fallback is replaced by the provided icon.\n\n```html\n<mds-avatar icon=\"mi/baseline/business\" variant=\"primary\"></mds-avatar>\n<mds-avatar icon=\"mi/baseline/pets\" variant=\"info\"></mds-avatar>\n```\n\n#### Overflow Count in Stacked Groups\n\nUse `count` to render a \"+N\" overflow badge for the last slot in an avatar stack (e.g. \"3 more\"). The count display overrides every other source (`src`, `initials`, `icon`) and, unlike `initials`, derives no color: it keeps the `variant`. Use inside [`mds-avatar-stack`](../mds-avatar-stack/AGENTS.md) and [`mds-avatar-stack-item`](../mds-avatar-stack-item/AGENTS.md).\n\n```html\n<mds-avatar-stack>\n <mds-avatar-stack-item src=\"https://example.com/foto-01.jpg\"></mds-avatar-stack-item>\n <mds-avatar-stack-item src=\"https://example.com/foto-02.jpg\"></mds-avatar-stack-item>\n <mds-avatar-stack-item count=\"3\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Sizing via Utility Classes\n\n`<mds-avatar>` does not expose a `size` prop - its size is controlled by the host element's `width` (the component uses `aspect-ratio: 1/1` internally). Apply a Magma spacing utility class on the host.\n\n```html\n<!-- Small avatar -->\n<mds-avatar src=\"https://example.com/foto.jpg\" class=\"w-600\"></mds-avatar>\n\n<!-- Default / medium avatar -->\n<mds-avatar src=\"https://example.com/foto.jpg\" class=\"w-1200\"></mds-avatar>\n\n<!-- Large avatar -->\n<mds-avatar src=\"https://example.com/foto.jpg\" class=\"w-2400\"></mds-avatar>\n```\n\n#### Styling Customization\n\nStyle the avatar only through its public `--mds-avatar-*` CSS custom properties. Use semantic color roles wrapped in `rgb(var(--magma-<role>))` so dark mode and high-contrast modes work correctly.\n\n```css\n.profilo-utente mds-avatar {\n --mds-avatar-background-color: rgb(var(--magma-accent-emphasis));\n --mds-avatar-color: rgb(var(--magma-accent-on-emphasis));\n --mds-avatar-radius: var(--magma-radius-md);\n\n corner-shape: var(--magma-corner-shape);\n}\n```\n\n#### Square Avatar via `--mds-avatar-radius`\n\nThe default shape is fully circular. Override the CSS custom property to get a square or rounded-square avatar - for example when representing a product or brand logo rather than a person.\n\nThe circle stays out of the corner axis, so the host declares no corner shape. A step of the `--magma-radius-*` scale is tuned for the shape of the axis: give the host `corner-shape: var(--magma-corner-shape)` with it, and the inner image and initials follow.\n\n```css\n.logo-azienda mds-avatar {\n --mds-avatar-radius: var(--magma-radius-md);\n\n corner-shape: var(--magma-corner-shape);\n}\n```\n\n```html\n<mds-avatar\n class=\"logo-azienda w-1600\"\n src=\"https://example.com/logo-azienda.png\"\n></mds-avatar>\n```\n",
35
+ "3. Antipattern": "Common incorrect uses of `<mds-avatar>`. 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 `variant` When `initials` Is Present\n\nThe component derives the background color deterministically from the characters when `initials` is set, and silently overrides any explicit `variant`. Setting `variant` alongside these props is a no-op and misleads readers of the markup.\n\n```html\n<!-- INCORRECT -->\n<mds-avatar initials=\"MR\" variant=\"error\"></mds-avatar>\n\n<!-- CORRECT -->\n<mds-avatar initials=\"MR\"></mds-avatar>\n```\n\n#### Do Not Use `count` for Individual Users\n\n`count` is designed for overflow badges in stacked avatar groups (\"+3 more\"). Using it to represent a single user's identity (e.g. an ID number) produces a \"+N\" label, which is semantically wrong. Use `initials` for individual users.\n\n```html\n<!-- INCORRECT -->\n<mds-avatar count=\"42\"></mds-avatar>\n\n<!-- CORRECT - use initials for individual users -->\n<mds-avatar initials=\"GV\"></mds-avatar>\n```\n\n#### Do Not Override Size with Inline `width` / `height` Styles\n\n`<mds-avatar>` keeps a 1:1 aspect ratio internally. Forcing `width` or `height` via inline styles or arbitrary CSS bypasses the design token grid and can distort the shape. Use a Magma spacing utility class on the host element instead.\n\n```html\n<!-- INCORRECT -->\n<mds-avatar src=\"https://example.com/foto.jpg\" style=\"width: 73px; height: 73px;\"></mds-avatar>\n\n<!-- CORRECT -->\n<mds-avatar src=\"https://example.com/foto.jpg\" class=\"w-1600\"></mds-avatar>\n```\n\n#### Do Not Slot `<img>` to Supply a Profile Photo\n\n`<mds-avatar>` has no slots - it is a self-contained shadow component. Putting a raw `<img>` inside it will have no effect; the component will ignore it and show the fallback person glyph. Use the `src` prop instead.\n\n```html\n<!-- INCORRECT -->\n<mds-avatar>\n <img src=\"https://example.com/foto.jpg\" alt=\"Mario Bianchi\" />\n</mds-avatar>\n\n<!-- CORRECT -->\n<mds-avatar src=\"https://example.com/foto.jpg\"></mds-avatar>\n```\n\n#### Do Not Pierce Shadow DOM to Change Internal Colors\n\nThe supported customization surface is the three public `--mds-avatar-*` CSS custom properties and, for a deep customisation, the documented parts `wrapper`, `media` and `icon`. Using undocumented part names, `>>>`, or internal class names to target internals couples your code to the Shadow DOM implementation and breaks on minor releases.\n\n```css\n/* INCORRECT */\nmds-avatar::part(initials) {\n background-color: hotpink;\n}\nmds-avatar >>> .initials-text {\n color: white;\n}\n\n/* CORRECT */\nmds-avatar {\n --mds-avatar-background-color: rgb(var(--magma-accent-emphasis));\n --mds-avatar-color: rgb(var(--magma-accent-on-emphasis));\n}\n```\n\n#### Do Not Use a Raw `<img>` or `<div>` as an Avatar\n\nWhen an avatar-style UI element is needed, reach for `<mds-avatar>` rather than hand-rolling a circular `<img>` or `<div>` with CSS. The component handles lazy loading, load errors, initials fallback, pending state, dark mode, and high-contrast mode automatically.\n\n```html\n<!-- INCORRECT -->\n<img\n src=\"https://example.com/foto.jpg\"\n alt=\"Foto di Luca\"\n style=\"border-radius: 50%; width: 48px; height: 48px;\"\n/>\n\n<!-- CORRECT -->\n<mds-avatar src=\"https://example.com/foto.jpg\" class=\"w-1200\"></mds-avatar>\n```\n"
32
36
  },
33
37
  "props": [
34
38
  {
@@ -284,27 +288,32 @@
284
288
  {
285
289
  "name": "--mds-avatar-background-color",
286
290
  "annotation": "prop",
287
- "docs": "The background-color of the component"
291
+ "docs": "The background-color of the component",
292
+ "visibility": "public"
288
293
  },
289
294
  {
290
295
  "name": "--mds-avatar-background-color-pending",
291
296
  "annotation": "prop",
292
- "docs": "The background-color when an image is loading"
297
+ "docs": "The background-color when an image is loading",
298
+ "visibility": "internal"
293
299
  },
294
300
  {
295
301
  "name": "--mds-avatar-color",
296
302
  "annotation": "prop",
297
- "docs": "The color of the placeholder icon"
303
+ "docs": "The color of the placeholder icon",
304
+ "visibility": "public"
298
305
  },
299
306
  {
300
307
  "name": "--mds-avatar-initials-padding",
301
308
  "annotation": "prop",
302
- "docs": "Sets the padding of the initials inside the avatar"
309
+ "docs": "Sets the padding of the initials inside the avatar",
310
+ "visibility": "internal"
303
311
  },
304
312
  {
305
313
  "name": "--mds-avatar-radius",
306
314
  "annotation": "prop",
307
- "docs": "The border-radius of the element"
315
+ "docs": "The border-radius of the element",
316
+ "visibility": "public"
308
317
  }
309
318
  ],
310
319
  "slots": [],
@@ -13,10 +13,10 @@ mds-img {
13
13
 
14
14
  /**
15
15
  * @prop --mds-avatar-background-color-pending: The background-color when an image is loading
16
- * @prop --mds-avatar-background-color: The background-color of the component
17
- * @prop --mds-avatar-color: The color of the placeholder icon
16
+ * @prop --mds-avatar-background-color: Public. The background-color of the component
17
+ * @prop --mds-avatar-color: Public. The color of the placeholder icon
18
18
  * @prop --mds-avatar-initials-padding: Sets the padding of the initials inside the avatar
19
- * @prop --mds-avatar-radius: The border-radius of the element
19
+ * @prop --mds-avatar-radius: Public. The border-radius of the element
20
20
  */
21
21
 
22
22
  :host {
@@ -7,6 +7,7 @@ import miBaselinePerson from "@icon/mi/baseline/person.svg";
7
7
  * @part icon - The selected icon of the avatar
8
8
  * @part wrapper - The wrapper which contains media displayed
9
9
  * @part media - The media displayed
10
+ * @category data
10
11
  */
11
12
  export class MdsAvatar {
12
13
  constructor() {
@@ -135,7 +136,7 @@ export class MdsAvatar {
135
136
  render() {
136
137
  var _a, _b;
137
138
  const content = this.content();
138
- return (h(Host, { key: '4463d6bac699d6c74c90427f35aa8bfb0877552b', "pref-animation": preferenceStore.state.animation, "pref-contrast": preferenceStore.state.contrast }, h("div", { key: '6949df259f15fd126ac40d80017cc116773d82b3', class: clsx('avatar', `avatar--${content}`, content === 'image' && !this.loaded ? 'avatar--pending' : 'avatar--loaded'), part: "wrapper" }, content === 'count' && (h("div", { key: '3cd16c145857931a8bdfd008a859e256ee411c4d', class: "initials-text" }, h("span", { key: '6c6078b9effbc62a3ebaf0646dc322e09030cb7a', class: "fit" }, "+", this.count))), content === 'image' && (h("mds-img", { key: 'c09fc248707b48adb8d60f4f296307a622d9e6dd', class: "image", loading: "lazy", onMdsImgLoadError: this.handleImgLoadError, onMdsImgLoadSuccess: this.handleImgLoadSuccess, part: "media", src: this.src })), content === 'initials' && (h("div", { key: '579f0418eb03f7625ae4940171cffb5ff316b09c', class: "initials-text" }, h("span", { key: '0fcdec1586c8cd7c650cb84d6d3293c7f0e725b9', class: "fit" }, (_a = this.initials) === null || _a === void 0 ? void 0 : _a.substring(0, 2)))), content === 'icon' && (h("mds-icon", { key: 'aabed527d77428466750b5a98a8bf57189e132f9', class: "icon", part: "icon", name: (_b = this.icon) !== null && _b !== void 0 ? _b : '' })), content === 'fallback' && h("i", { key: 'f1f06caf13adb478ddee2620a847a76a74f61b0b', class: "fallback-icon", innerHTML: miBaselinePerson }))));
139
+ return (h(Host, { key: 'bee1006e79abea8e8efdd758a164acf925f5be82', "pref-animation": preferenceStore.state.animation, "pref-contrast": preferenceStore.state.contrast }, h("div", { key: '9ed93955eb9b3c046f458f11a53ec0c80bc148f4', class: clsx('avatar', `avatar--${content}`, content === 'image' && !this.loaded ? 'avatar--pending' : 'avatar--loaded'), part: "wrapper" }, content === 'count' && (h("div", { key: '72a16e4442525b2fcbdaeabdd35cf9e740d3aa99', class: "initials-text" }, h("span", { key: 'f9667d0b7e325da0324f334870e72104b7125613', class: "fit" }, "+", this.count))), content === 'image' && (h("mds-img", { key: '324b7b601dc2f6fa77261434ce1e4bdfd37de3b1', class: "image", loading: "lazy", onMdsImgLoadError: this.handleImgLoadError, onMdsImgLoadSuccess: this.handleImgLoadSuccess, part: "media", src: this.src })), content === 'initials' && (h("div", { key: 'ae57a07ad1f6005bb15eb1c9fae34ebd437fb047', class: "initials-text" }, h("span", { key: '112ccea5ca31785598d92d0435db2cce495d7eac', class: "fit" }, (_a = this.initials) === null || _a === void 0 ? void 0 : _a.substring(0, 2)))), content === 'icon' && (h("mds-icon", { key: '24ceaddff9b0aa859e7bb540dccadcf78eae6fcf', class: "icon", part: "icon", name: (_b = this.icon) !== null && _b !== void 0 ? _b : '' })), content === 'fallback' && h("i", { key: 'bd4028f615e14e736a1fb1565b34c8d4d5d86d63', class: "fallback-icon", innerHTML: miBaselinePerson }))));
139
140
  }
140
141
  static get is() { return "mds-avatar"; }
141
142
  static get encapsulation() { return "shadow"; }
@@ -84,14 +84,13 @@ Use `count` to render a "+N" overflow badge for the last slot in an avatar stack
84
84
 
85
85
  #### Styling Customization
86
86
 
87
- Style the avatar only through its documented `--mds-avatar-*` CSS custom properties. Use semantic color roles wrapped in `rgb(var(--magma-<role>))` so dark mode and high-contrast modes work correctly.
87
+ Style the avatar only through its public `--mds-avatar-*` CSS custom properties. Use semantic color roles wrapped in `rgb(var(--magma-<role>))` so dark mode and high-contrast modes work correctly.
88
88
 
89
89
  ```css
90
90
  .profilo-utente mds-avatar {
91
91
  --mds-avatar-background-color: rgb(var(--magma-accent-emphasis));
92
92
  --mds-avatar-color: rgb(var(--magma-accent-on-emphasis));
93
93
  --mds-avatar-radius: var(--magma-radius-md);
94
- --mds-avatar-initials-padding: 15%;
95
94
 
96
95
  corner-shape: var(--magma-corner-shape);
97
96
  }
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-avatar-stack
8
8
 
9
- > `@maggioli-design-system/magma` 2.5.1. Shadow DOM: style it only through the CSS custom properties and parts below.
9
+ > `@maggioli-design-system/magma` 2.7.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
10
10
 
11
11
  The `<mds-avatar-stack>` web component groups a set of overlapping `<mds-avatar-stack-item>` children into a single horizontal cluster, the Magma Design System pattern for showing the people associated with an entity (assignees, participants, collaborators) in a compact, space-saving row.
12
12
 
@@ -48,17 +48,8 @@ This component does not use the shared `variant` / `tone` ladders; per-avatar ap
48
48
  | Property | Description |
49
49
  | --- | --- |
50
50
  | `--mds-avatar-stack-background` | Background color for the avatar stack container |
51
- | `--mds-avatar-stack-count-background-color` | Background color of the count indicator (e.g., "+3") |
52
- | `--mds-avatar-stack-count-color` | Text color of the count indicator |
53
- | `--mds-avatar-stack-lg-border` | Border width for large avatar stack items |
54
- | `--mds-avatar-stack-lg-offset` | Horizontal overlap offset for large avatars |
55
- | `--mds-avatar-stack-lg-size` | Size of large avatars in the stack |
56
- | `--mds-avatar-stack-md-border` | Border width for medium avatar stack items |
57
- | `--mds-avatar-stack-md-offset` | Horizontal overlap offset for medium avatars |
58
- | `--mds-avatar-stack-md-size` | Size of medium avatars in the stack |
59
- | `--mds-avatar-stack-sm-border` | Border width for small avatar stack items |
60
- | `--mds-avatar-stack-sm-offset` | Horizontal overlap offset for small avatars |
61
- | `--mds-avatar-stack-sm-size` | Size of small avatars in the stack |
51
+
52
+ Only these are public. Its other 11 are internal: they may change in any release, do not set them.
62
53
 
63
54
  ## Dependencies
64
55
 
@@ -106,7 +106,7 @@ When `total` does not exceed the number of slotted items, no overflow badge is r
106
106
 
107
107
  #### Customize via Documented Vars, Not Internal Selectors
108
108
 
109
- The supported customization surface is the `--mds-avatar-stack-*` CSS custom properties on the parent. Targeting shadow internals via `>>>` or undocumented `::part()` names couples your code to the implementation and will break on minor releases.
109
+ The supported customization surface is the public `--mds-avatar-stack-*` CSS custom properties on the parent. Targeting shadow internals via `>>>` or undocumented `::part()` names couples your code to the implementation and will break on minor releases.
110
110
 
111
111
  ```css
112
112
  /* INCORRECT */
@@ -117,6 +117,5 @@ mds-avatar-stack >>> .avatar {
117
117
  /* CORRECT */
118
118
  mds-avatar-stack {
119
119
  --mds-avatar-stack-background: rgb(var(--magma-accent-emphasis));
120
- --mds-avatar-stack-count-background-color: rgb(var(--magma-wash-soft));
121
120
  }
122
121
  ```
@@ -1,5 +1,5 @@
1
1
  {
2
- "timestamp": "2026-10-22T13:02:36",
2
+ "timestamp": "2026-10-24T18:39:37",
3
3
  "compiler": {
4
4
  "name": "@stencil/core",
5
5
  "version": "4.45.2",
@@ -15,12 +15,16 @@
15
15
  {
16
16
  "name": "slot",
17
17
  "text": "- Add `mds-avatar-stack-item` elements to display in the stack."
18
+ },
19
+ {
20
+ "name": "category",
21
+ "text": "data"
18
22
  }
19
23
  ],
20
24
  "usage": {
21
25
  "1. Description": "The `<mds-avatar-stack>` web component groups a set of overlapping `<mds-avatar-stack-item>` children into a single horizontal cluster, the Magma Design System pattern for showing the people associated with an entity (assignees, participants, collaborators) in a compact, space-saving row.\n\n#### Semantic Behavior\n\n- **Compound parent**: It is the container half of a compound component; its visible content is the default slot of `<mds-avatar-stack-item>` children, each of which wraps an `<mds-avatar>`.\n- **Size propagation**: `size` drives the dimensions, border, and horizontal overlap of every slotted item, so the whole stack stays visually consistent without sizing each avatar individually.\n- **Overflow counter**: When `total` is set and exceeds the number of slotted children, the stack appends one extra item rendering the remainder (e.g. \"+3\"), so it can represent a larger group than it physically shows.\n- **Live composition**: Children are counted again whenever they change: the overflow indicator follows both `total` and the items added or removed after load.\n\n#### Properties & Visual Configurations\n\n- **`size`** selects the avatar scale (`'sm'`, `'md'`, `'lg'`) for the entire stack; pick it to match the surrounding density, since it governs not just avatar diameter but also the overlap offset and ring border between stacked avatars.\n- **`total`** is the logical headcount of the represented group. Set it higher than the number of slotted avatars to surface a trailing count item for the hidden members; leave it unset (or equal to the child count) to show only the avatars in the markup with no counter.\n\nThis component does not use the shared `variant` / `tone` ladders; per-avatar appearance (tone, variant, initials, image source) is configured on each `<mds-avatar-stack-item>` instead.\n",
22
- "2. Pattern": "Correct and idiomatic ways to use the `<mds-avatar-stack>` 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 Avatar Stack\n\nThe canonical form. Slot one [`<mds-avatar-stack-item>`](../mds-avatar-stack-item/AGENTS.md) per person directly inside the stack. Each item wraps an internal avatar; no extra wrapper elements are needed.\n\n```html\n<mds-avatar-stack>\n <mds-avatar-stack-item initials=\"mr\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"er\" tone=\"weak\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Avatar Stack with Profile Images\n\nUse `src` on each item when real user photos are available. If the image fails to load, the avatar shows the generic person glyph; while `src` is set, `initials` is not displayed.\n\n```html\n<mds-avatar-stack>\n <mds-avatar-stack-item\n src=\"/avatars/mario-rossi.jpg\"\n initials=\"mr\"\n tone=\"weak\"\n ></mds-avatar-stack-item>\n <mds-avatar-stack-item\n src=\"/avatars/anna-conti.jpg\"\n initials=\"ac\"\n tone=\"weak\"\n ></mds-avatar-stack-item>\n <mds-avatar-stack-item\n src=\"/avatars/elena-ricci.jpg\"\n initials=\"er\"\n tone=\"weak\"\n ></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Sizing the Stack\n\nUse the `size` prop on the parent to scale the whole stack at once. Do not set individual sizes on the items - the parent drives dimensions, overlap, and border for all children.\n\n```html\n<!-- Small - compact lists, comment threads -->\n<mds-avatar-stack size=\"sm\">\n <mds-avatar-stack-item initials=\"mr\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\" tone=\"weak\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n\n<!-- Medium (default) -->\n<mds-avatar-stack size=\"md\">\n <mds-avatar-stack-item initials=\"mr\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\" tone=\"weak\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n\n<!-- Large - hero areas, team pages -->\n<mds-avatar-stack size=\"lg\">\n <mds-avatar-stack-item initials=\"mr\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\" tone=\"weak\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Overflow Counter via `total`\n\nWhen the represented group is larger than the number of visible avatars, set `total` to the real headcount. The component automatically appends a trailing \"+N\" badge for the hidden members.\n\n```html\n<!-- 5 visible avatars out of a team of 12: shows \"+7\" badge -->\n<mds-avatar-stack total=\"12\">\n <mds-avatar-stack-item initials=\"mr\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"er\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"mt\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"jb\" tone=\"weak\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Per-Item Variant Colors\n\nEach [`<mds-avatar-stack-item>`](../mds-avatar-stack-item/AGENTS.md) accepts its own `variant`, which colors the avatar when it has no `initials`: initials derive their own color and override it. `tone` accepts `strong` or `weak` (default).\n\n```html\n<mds-avatar-stack>\n <mds-avatar-stack-item variant=\"primary\" tone=\"strong\"></mds-avatar-stack-item>\n <mds-avatar-stack-item variant=\"success\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item variant=\"warning\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item variant=\"info\" tone=\"weak\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Size and Overflow Combined\n\nCombine `size` and `total` to produce a large, labelled stack for team-overview sections.\n\n```html\n<mds-avatar-stack size=\"lg\" total=\"25\">\n <mds-avatar-stack-item initials=\"mr\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"er\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"mt\" tone=\"weak\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Styling Customization\n\nStyle the stack only through its documented `--mds-avatar-stack-*` CSS custom properties. Set them on the host or a parent selector; use semantic color roles via `rgb(var(--magma-<role>))` so dark mode keeps working.\n\n```css\n/* Custom ring color and overlap for a card-hero section */\n.team-hero mds-avatar-stack {\n --mds-avatar-stack-background: rgb(var(--magma-accent-emphasis));\n --mds-avatar-stack-count-background-color: rgb(var(--magma-wash-soft));\n --mds-avatar-stack-count-color: rgb(var(--magma-text-default));\n --mds-avatar-stack-lg-offset: 2.5;\n}\n```\n",
23
- "3. Antipattern": "Common incorrect uses of `<mds-avatar-stack>`. Each entry pairs the wrong form with the right one and a one-line reason. System-wide rules (boolean-as-string, shadow piercing, Tailwind color utilities, raw native event listening) live in [`agents/anti-patterns.md`](../../../../agents/anti-patterns.md) - they apply here too but are not repeated.\n\n#### Do Not Place `<mds-avatar-stack-item>` Inside a Wrapper Element\n\nThe parent counts only its **direct** `mds-avatar-stack-item` children. An intermediate wrapper breaks that count, so the overflow counter is wrong, and the parent's `size` (applied with `::slotted`) does not reach the wrapped items.\n\n```html\n<!-- INCORRECT -->\n<mds-avatar-stack total=\"10\">\n <div class=\"group\">\n <mds-avatar-stack-item initials=\"mr\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\"></mds-avatar-stack-item>\n </div>\n</mds-avatar-stack>\n\n<!-- CORRECT -->\n<mds-avatar-stack total=\"10\">\n <mds-avatar-stack-item initials=\"mr\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\" tone=\"weak\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Do Not Slot a Raw `<mds-avatar>` Directly\n\n[`<mds-avatar-stack-item>`](../mds-avatar-stack-item/AGENTS.md) is the correct child for this compound component - it handles sizing, border, overlap offset, and count badge rendering. Slotting a bare `<mds-avatar>` skips all of that wiring.\n\n```html\n<!-- INCORRECT -->\n<mds-avatar-stack>\n <mds-avatar initials=\"mr\"></mds-avatar>\n <mds-avatar initials=\"ac\"></mds-avatar>\n</mds-avatar-stack>\n\n<!-- CORRECT -->\n<mds-avatar-stack>\n <mds-avatar-stack-item initials=\"mr\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\" tone=\"weak\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Do Not Set `total` Lower Than or Equal to the Child Count\n\nWhen `total` does not exceed the number of slotted items, no overflow badge is rendered. Setting `total` lower than the child count is also misleading about group size and produces no visible effect.\n\n```html\n<!-- INCORRECT - total equals child count, badge never appears -->\n<mds-avatar-stack total=\"3\">\n <mds-avatar-stack-item initials=\"mr\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"er\" tone=\"weak\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n\n<!-- CORRECT - total exceeds slotted count by the hidden members -->\n<mds-avatar-stack total=\"10\">\n <mds-avatar-stack-item initials=\"mr\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"er\" tone=\"weak\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Do Not Add `count` Manually When `total` Is Set\n\n`count` on `<mds-avatar-stack-item>` is reserved for the auto-generated overflow badge; the parent computes and appends it when `total` is provided. Adding a `count` item by hand alongside `total` results in a duplicate badge.\n\n```html\n<!-- INCORRECT -->\n<mds-avatar-stack total=\"10\">\n <mds-avatar-stack-item initials=\"mr\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item count=\"8\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n\n<!-- CORRECT - let the parent handle the badge -->\n<mds-avatar-stack total=\"10\">\n <mds-avatar-stack-item initials=\"mr\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\" tone=\"weak\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Do Not Size Individual Items - Size the Parent\n\n[`<mds-avatar-stack-item>`](../mds-avatar-stack-item/AGENTS.md) exposes no `size` prop; dimensions are driven by the parent's `size`. Overriding size with inline CSS on individual items breaks the uniform overlap geometry the component calculates.\n\n```html\n<!-- INCORRECT -->\n<mds-avatar-stack>\n <mds-avatar-stack-item initials=\"mr\" style=\"width: 48px; height: 48px;\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\" style=\"width: 48px; height: 48px;\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n\n<!-- CORRECT -->\n<mds-avatar-stack size=\"lg\">\n <mds-avatar-stack-item initials=\"mr\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\" tone=\"weak\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Customize via Documented Vars, Not Internal Selectors\n\nThe supported customization surface is the `--mds-avatar-stack-*` CSS custom properties on the parent. Targeting shadow internals via `>>>` or undocumented `::part()` names couples your code to the implementation and will break on minor releases.\n\n```css\n/* INCORRECT */\nmds-avatar-stack >>> .avatar {\n border-color: blue;\n}\n\n/* CORRECT */\nmds-avatar-stack {\n --mds-avatar-stack-background: rgb(var(--magma-accent-emphasis));\n --mds-avatar-stack-count-background-color: rgb(var(--magma-wash-soft));\n}\n```\n"
26
+ "2. Pattern": "Correct and idiomatic ways to use the `<mds-avatar-stack>` 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 Avatar Stack\n\nThe canonical form. Slot one [`<mds-avatar-stack-item>`](../mds-avatar-stack-item/AGENTS.md) per person directly inside the stack. Each item wraps an internal avatar; no extra wrapper elements are needed.\n\n```html\n<mds-avatar-stack>\n <mds-avatar-stack-item initials=\"mr\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"er\" tone=\"weak\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Avatar Stack with Profile Images\n\nUse `src` on each item when real user photos are available. If the image fails to load, the avatar shows the generic person glyph; while `src` is set, `initials` is not displayed.\n\n```html\n<mds-avatar-stack>\n <mds-avatar-stack-item\n src=\"/avatars/mario-rossi.jpg\"\n initials=\"mr\"\n tone=\"weak\"\n ></mds-avatar-stack-item>\n <mds-avatar-stack-item\n src=\"/avatars/anna-conti.jpg\"\n initials=\"ac\"\n tone=\"weak\"\n ></mds-avatar-stack-item>\n <mds-avatar-stack-item\n src=\"/avatars/elena-ricci.jpg\"\n initials=\"er\"\n tone=\"weak\"\n ></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Sizing the Stack\n\nUse the `size` prop on the parent to scale the whole stack at once. Do not set individual sizes on the items - the parent drives dimensions, overlap, and border for all children.\n\n```html\n<!-- Small - compact lists, comment threads -->\n<mds-avatar-stack size=\"sm\">\n <mds-avatar-stack-item initials=\"mr\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\" tone=\"weak\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n\n<!-- Medium (default) -->\n<mds-avatar-stack size=\"md\">\n <mds-avatar-stack-item initials=\"mr\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\" tone=\"weak\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n\n<!-- Large - hero areas, team pages -->\n<mds-avatar-stack size=\"lg\">\n <mds-avatar-stack-item initials=\"mr\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\" tone=\"weak\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Overflow Counter via `total`\n\nWhen the represented group is larger than the number of visible avatars, set `total` to the real headcount. The component automatically appends a trailing \"+N\" badge for the hidden members.\n\n```html\n<!-- 5 visible avatars out of a team of 12: shows \"+7\" badge -->\n<mds-avatar-stack total=\"12\">\n <mds-avatar-stack-item initials=\"mr\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"er\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"mt\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"jb\" tone=\"weak\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Per-Item Variant Colors\n\nEach [`<mds-avatar-stack-item>`](../mds-avatar-stack-item/AGENTS.md) accepts its own `variant`, which colors the avatar when it has no `initials`: initials derive their own color and override it. `tone` accepts `strong` or `weak` (default).\n\n```html\n<mds-avatar-stack>\n <mds-avatar-stack-item variant=\"primary\" tone=\"strong\"></mds-avatar-stack-item>\n <mds-avatar-stack-item variant=\"success\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item variant=\"warning\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item variant=\"info\" tone=\"weak\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Size and Overflow Combined\n\nCombine `size` and `total` to produce a large, labelled stack for team-overview sections.\n\n```html\n<mds-avatar-stack size=\"lg\" total=\"25\">\n <mds-avatar-stack-item initials=\"mr\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"er\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"mt\" tone=\"weak\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Styling Customization\n\nStyle the stack only through its public `--mds-avatar-stack-*` CSS custom properties. Set them on the host or a parent selector; use semantic color roles via `rgb(var(--magma-<role>))` so dark mode keeps working.\n\n```css\n/* Custom ring color for a card-hero section */\n.team-hero mds-avatar-stack {\n --mds-avatar-stack-background: rgb(var(--magma-accent-emphasis));\n}\n```\n",
27
+ "3. Antipattern": "Common incorrect uses of `<mds-avatar-stack>`. Each entry pairs the wrong form with the right one and a one-line reason. System-wide rules (boolean-as-string, shadow piercing, Tailwind color utilities, raw native event listening) live in [`agents/anti-patterns.md`](../../../../agents/anti-patterns.md) - they apply here too but are not repeated.\n\n#### Do Not Place `<mds-avatar-stack-item>` Inside a Wrapper Element\n\nThe parent counts only its **direct** `mds-avatar-stack-item` children. An intermediate wrapper breaks that count, so the overflow counter is wrong, and the parent's `size` (applied with `::slotted`) does not reach the wrapped items.\n\n```html\n<!-- INCORRECT -->\n<mds-avatar-stack total=\"10\">\n <div class=\"group\">\n <mds-avatar-stack-item initials=\"mr\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\"></mds-avatar-stack-item>\n </div>\n</mds-avatar-stack>\n\n<!-- CORRECT -->\n<mds-avatar-stack total=\"10\">\n <mds-avatar-stack-item initials=\"mr\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\" tone=\"weak\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Do Not Slot a Raw `<mds-avatar>` Directly\n\n[`<mds-avatar-stack-item>`](../mds-avatar-stack-item/AGENTS.md) is the correct child for this compound component - it handles sizing, border, overlap offset, and count badge rendering. Slotting a bare `<mds-avatar>` skips all of that wiring.\n\n```html\n<!-- INCORRECT -->\n<mds-avatar-stack>\n <mds-avatar initials=\"mr\"></mds-avatar>\n <mds-avatar initials=\"ac\"></mds-avatar>\n</mds-avatar-stack>\n\n<!-- CORRECT -->\n<mds-avatar-stack>\n <mds-avatar-stack-item initials=\"mr\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\" tone=\"weak\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Do Not Set `total` Lower Than or Equal to the Child Count\n\nWhen `total` does not exceed the number of slotted items, no overflow badge is rendered. Setting `total` lower than the child count is also misleading about group size and produces no visible effect.\n\n```html\n<!-- INCORRECT - total equals child count, badge never appears -->\n<mds-avatar-stack total=\"3\">\n <mds-avatar-stack-item initials=\"mr\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"er\" tone=\"weak\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n\n<!-- CORRECT - total exceeds slotted count by the hidden members -->\n<mds-avatar-stack total=\"10\">\n <mds-avatar-stack-item initials=\"mr\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"er\" tone=\"weak\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Do Not Add `count` Manually When `total` Is Set\n\n`count` on `<mds-avatar-stack-item>` is reserved for the auto-generated overflow badge; the parent computes and appends it when `total` is provided. Adding a `count` item by hand alongside `total` results in a duplicate badge.\n\n```html\n<!-- INCORRECT -->\n<mds-avatar-stack total=\"10\">\n <mds-avatar-stack-item initials=\"mr\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item count=\"8\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n\n<!-- CORRECT - let the parent handle the badge -->\n<mds-avatar-stack total=\"10\">\n <mds-avatar-stack-item initials=\"mr\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\" tone=\"weak\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Do Not Size Individual Items - Size the Parent\n\n[`<mds-avatar-stack-item>`](../mds-avatar-stack-item/AGENTS.md) exposes no `size` prop; dimensions are driven by the parent's `size`. Overriding size with inline CSS on individual items breaks the uniform overlap geometry the component calculates.\n\n```html\n<!-- INCORRECT -->\n<mds-avatar-stack>\n <mds-avatar-stack-item initials=\"mr\" style=\"width: 48px; height: 48px;\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\" style=\"width: 48px; height: 48px;\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n\n<!-- CORRECT -->\n<mds-avatar-stack size=\"lg\">\n <mds-avatar-stack-item initials=\"mr\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\" tone=\"weak\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Customize via Documented Vars, Not Internal Selectors\n\nThe supported customization surface is the public `--mds-avatar-stack-*` CSS custom properties on the parent. Targeting shadow internals via `>>>` or undocumented `::part()` names couples your code to the implementation and will break on minor releases.\n\n```css\n/* INCORRECT */\nmds-avatar-stack >>> .avatar {\n border-color: blue;\n}\n\n/* CORRECT */\nmds-avatar-stack {\n --mds-avatar-stack-background: rgb(var(--magma-accent-emphasis));\n}\n```\n"
24
28
  },
25
29
  "props": [
26
30
  {
@@ -99,62 +103,74 @@
99
103
  {
100
104
  "name": "--mds-avatar-stack-background",
101
105
  "annotation": "prop",
102
- "docs": "Background color for the avatar stack container"
106
+ "docs": "Background color for the avatar stack container",
107
+ "visibility": "public"
103
108
  },
104
109
  {
105
110
  "name": "--mds-avatar-stack-count-background-color",
106
111
  "annotation": "prop",
107
- "docs": "Background color of the count indicator (e.g., \"+3\")"
112
+ "docs": "Background color of the count indicator (e.g., \"+3\")",
113
+ "visibility": "internal"
108
114
  },
109
115
  {
110
116
  "name": "--mds-avatar-stack-count-color",
111
117
  "annotation": "prop",
112
- "docs": "Text color of the count indicator"
118
+ "docs": "Text color of the count indicator",
119
+ "visibility": "internal"
113
120
  },
114
121
  {
115
122
  "name": "--mds-avatar-stack-lg-border",
116
123
  "annotation": "prop",
117
- "docs": "Border width for large avatar stack items"
124
+ "docs": "Border width for large avatar stack items",
125
+ "visibility": "internal"
118
126
  },
119
127
  {
120
128
  "name": "--mds-avatar-stack-lg-offset",
121
129
  "annotation": "prop",
122
- "docs": "Horizontal overlap offset for large avatars"
130
+ "docs": "Horizontal overlap offset for large avatars",
131
+ "visibility": "internal"
123
132
  },
124
133
  {
125
134
  "name": "--mds-avatar-stack-lg-size",
126
135
  "annotation": "prop",
127
- "docs": "Size of large avatars in the stack"
136
+ "docs": "Size of large avatars in the stack",
137
+ "visibility": "internal"
128
138
  },
129
139
  {
130
140
  "name": "--mds-avatar-stack-md-border",
131
141
  "annotation": "prop",
132
- "docs": "Border width for medium avatar stack items"
142
+ "docs": "Border width for medium avatar stack items",
143
+ "visibility": "internal"
133
144
  },
134
145
  {
135
146
  "name": "--mds-avatar-stack-md-offset",
136
147
  "annotation": "prop",
137
- "docs": "Horizontal overlap offset for medium avatars"
148
+ "docs": "Horizontal overlap offset for medium avatars",
149
+ "visibility": "internal"
138
150
  },
139
151
  {
140
152
  "name": "--mds-avatar-stack-md-size",
141
153
  "annotation": "prop",
142
- "docs": "Size of medium avatars in the stack"
154
+ "docs": "Size of medium avatars in the stack",
155
+ "visibility": "internal"
143
156
  },
144
157
  {
145
158
  "name": "--mds-avatar-stack-sm-border",
146
159
  "annotation": "prop",
147
- "docs": "Border width for small avatar stack items"
160
+ "docs": "Border width for small avatar stack items",
161
+ "visibility": "internal"
148
162
  },
149
163
  {
150
164
  "name": "--mds-avatar-stack-sm-offset",
151
165
  "annotation": "prop",
152
- "docs": "Horizontal overlap offset for small avatars"
166
+ "docs": "Horizontal overlap offset for small avatars",
167
+ "visibility": "internal"
153
168
  },
154
169
  {
155
170
  "name": "--mds-avatar-stack-sm-size",
156
171
  "annotation": "prop",
157
- "docs": "Size of small avatars in the stack"
172
+ "docs": "Size of small avatars in the stack",
173
+ "visibility": "internal"
158
174
  }
159
175
  ],
160
176
  "slots": [
@@ -36,7 +36,7 @@ mds-avatar-stack-item {
36
36
 
37
37
 
38
38
  /**
39
- * @prop --mds-avatar-stack-background: Background color for the avatar stack container
39
+ * @prop --mds-avatar-stack-background: Public. Background color for the avatar stack container
40
40
  * @prop --mds-avatar-stack-count-background-color: Background color of the count indicator (e.g., "+3")
41
41
  * @prop --mds-avatar-stack-count-color: Text color of the count indicator
42
42
  * @prop --mds-avatar-stack-lg-border: Border width for large avatar stack items
@@ -2,6 +2,7 @@ import { Host, h } from "@stencil/core";
2
2
  import { queryChildrenByTag } from "../../common/slot";
3
3
  /**
4
4
  * @slot - Add `mds-avatar-stack-item` elements to display in the stack.
5
+ * @category data
5
6
  */
6
7
  export class MdsAvatarStack {
7
8
  constructor() {
@@ -16,7 +17,7 @@ export class MdsAvatarStack {
16
17
  this.updateItems();
17
18
  }
18
19
  render() {
19
- return (h(Host, { key: '55d3cbd8c8a0dea030938c5a33a0e5cc625db716' }, h("slot", { key: 'f4ab4078cc19aa24928c7493c2ebffc98e154a75', onSlotchange: this.updateItems }), this.total !== undefined && this.total - this.itemsCount > 0 && (h("mds-avatar-stack-item", { key: 'c1dd8fdd03b92d24548971465cd6b6ae31a7d17d', count: this.total - this.itemsCount }))));
20
+ return (h(Host, { key: '08fad8dca40730f4af2a354755c0076861b7b3ad' }, h("slot", { key: 'a39c875b0ad8533553e5652510694aad5968874f', onSlotchange: this.updateItems }), this.total !== undefined && this.total - this.itemsCount > 0 && (h("mds-avatar-stack-item", { key: '19b21a0e4f14ade7dbf72a34dbe310437697d9af', count: this.total - this.itemsCount }))));
20
21
  }
21
22
  static get is() { return "mds-avatar-stack"; }
22
23
  static get encapsulation() { return "shadow"; }
@@ -112,14 +112,11 @@ Combine `size` and `total` to produce a large, labelled stack for team-overview
112
112
 
113
113
  #### Styling Customization
114
114
 
115
- Style the stack only through its documented `--mds-avatar-stack-*` CSS custom properties. Set them on the host or a parent selector; use semantic color roles via `rgb(var(--magma-<role>))` so dark mode keeps working.
115
+ Style the stack only through its public `--mds-avatar-stack-*` CSS custom properties. Set them on the host or a parent selector; use semantic color roles via `rgb(var(--magma-<role>))` so dark mode keeps working.
116
116
 
117
117
  ```css
118
- /* Custom ring color and overlap for a card-hero section */
118
+ /* Custom ring color for a card-hero section */
119
119
  .team-hero mds-avatar-stack {
120
120
  --mds-avatar-stack-background: rgb(var(--magma-accent-emphasis));
121
- --mds-avatar-stack-count-background-color: rgb(var(--magma-wash-soft));
122
- --mds-avatar-stack-count-color: rgb(var(--magma-text-default));
123
- --mds-avatar-stack-lg-offset: 2.5;
124
121
  }
125
122
  ```
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-avatar-stack-item
8
8
 
9
- > `@maggioli-design-system/magma` 2.5.1. Shadow DOM: style it only through the CSS custom properties and parts below.
9
+ > `@maggioli-design-system/magma` 2.7.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
10
10
 
11
11
  The `<mds-avatar-stack-item>` web component is a compound child that represents a single avatar inside an [`<mds-avatar-stack>`](../mds-avatar-stack/AGENTS.md), wrapping an internal `<mds-avatar>` so individual avatars can be overlapped, sized, and counted as a group rather than rendered standalone.
12
12
 
@@ -47,13 +47,10 @@ The shared `tone` / `variant` ladders are defined in [`agents/variants.md`](../.
47
47
  | Property | Description |
48
48
  | --- | --- |
49
49
  | `--mds-avatar-stack-item-background` | The background color of each avatar in the stack |
50
- | `--mds-avatar-stack-item-border` | Computed active border (based on selected size) |
51
- | `--mds-avatar-stack-item-count-background-color` | Background color of the count badge in the stack |
52
- | `--mds-avatar-stack-item-count-color` | Text color for the count badge in the stack |
53
- | `--mds-avatar-stack-item-offset` | Computed active offset (based on selected size) |
54
- | `--mds-avatar-stack-item-offset-margin` | Computed margin for overlapping avatars |
55
50
  | `--mds-avatar-stack-item-size` | Computed active size (based on selected size) |
56
51
 
52
+ Only these are public. Its other 5 are internal: they may change in any release, do not set them.
53
+
57
54
  ## Dependencies
58
55
 
59
56
  Uses: `mds-avatar`.
@@ -1,5 +1,5 @@
1
1
  {
2
- "timestamp": "2026-10-22T13:02:36",
2
+ "timestamp": "2026-10-24T18:39:37",
3
3
  "compiler": {
4
4
  "name": "@stencil/core",
5
5
  "version": "4.45.2",
@@ -11,10 +11,15 @@
11
11
  "encapsulation": "shadow",
12
12
  "tag": "mds-avatar-stack-item",
13
13
  "docs": "",
14
- "docsTags": [],
14
+ "docsTags": [
15
+ {
16
+ "name": "parent",
17
+ "text": "mds-avatar-stack"
18
+ }
19
+ ],
15
20
  "usage": {
16
21
  "1. Description": "The `<mds-avatar-stack-item>` web component is a compound child that represents a single avatar inside an [`<mds-avatar-stack>`](../mds-avatar-stack/AGENTS.md), wrapping an internal `<mds-avatar>` so individual avatars can be overlapped, sized, and counted as a group rather than rendered standalone.\n\n#### Semantic Behavior\n\n- **Compound child only**: It must be a direct slot child of `<mds-avatar-stack>`. It is not meant to be used standalone or mixed with other child types in the stack.\n- **Parent-driven sizing**: The visual size of each item is governed by the parent's `size` (`sm` / `md` / `lg`) - the child exposes no `size` prop of its own.\n- **Overflow / count badge**: When `count` is set, the item renders as a numeric badge instead of a person. The parent uses this for the trailing \"+N\" indicator, computed from its `total`.\n- **Pass-through to mds-avatar**: It forwards `count`, `initials`, `src`, `tone`, and `variant` straight to its internal `<mds-avatar>`; it adds no events, state, focus, or ARIA of its own.\n- **Initials override color**: When `initials` are shown (no image available), they take precedence over `tone` and `variant` so each user stays visually distinguishable within the stack.\n\n#### Properties & Visual Configurations\n\nThe shared `tone` / `variant` ladders are defined in [`agents/variants.md`](../../../../agents/variants.md); `tone` accepts only the minimal set (`weak` default, `strong`) and `variant` accepts the avatar color set.\n\n- **`src`**: Use for the primary case - a real user photo. When absent the avatar falls back to `initials`, and only when neither is provided do `tone` / `variant` define the placeholder appearance.\n- **`initials`**: Provide a short identifier when no image exists; prefer it over relying on color alone, since it both labels and visually separates users in a dense stack.\n- **`count`**: Set only to render an explicit overflow badge manually. In most cases this is computed for you by the parent's `total`, so set it directly only when building the overflow indicator yourself.\n",
17
- "2. Pattern": "Correct and idiomatic ways to use the `<mds-avatar-stack-item>` component, ordered from most common to most specialized. Patterns assume a working knowledge of the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Basic Stack with Initials\n\nThe most common form: place one item per participant inside [`mds-avatar-stack`](../mds-avatar-stack/AGENTS.md). Use `initials` for users without a photo; the stack applies uniform sizing and overlap automatically.\n\n```html\n<mds-avatar-stack>\n <mds-avatar-stack-item initials=\"mr\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"er\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Stack with Photos\n\nUse `src` when a real user photo is available. While `src` is set, `initials` is not displayed: an image that cannot be loaded is replaced by the generic person glyph. Items without `src` show their `initials`, and the tone/variant placeholder when neither is provided.\n\n```html\n<mds-avatar-stack>\n <mds-avatar-stack-item src=\"/avatars/mario-rossi.jpg\" initials=\"mr\"></mds-avatar-stack-item>\n <mds-avatar-stack-item src=\"/avatars/anna-conti.jpg\" initials=\"ac\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"er\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Tone and Variant for Placeholder Color\n\nWhen no image or initials are provided, `tone` and `variant` determine the placeholder background. Use distinct variant values to keep users visually distinguishable. `tone` defaults to `weak`; use `strong` for higher contrast.\n\n```html\n<mds-avatar-stack>\n <mds-avatar-stack-item variant=\"blue\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item variant=\"green\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item variant=\"orchid\" tone=\"strong\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Overflow Counter via Parent `total`\n\nSet `total` on the parent to let it append the overflow badge automatically. The badge value is `total` minus the number of slotted items - do not set `count` on the items yourself for this use case.\n\n```html\n<mds-avatar-stack total=\"12\">\n <mds-avatar-stack-item initials=\"mr\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"er\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Manual Overflow Badge via `count`\n\nUse `count` directly on a trailing item only when you are building the overflow indicator yourself and the parent does not own the total. This is rarely needed outside of fully custom stacks.\n\n```html\n<mds-avatar-stack>\n <mds-avatar-stack-item initials=\"mr\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\"></mds-avatar-stack-item>\n <mds-avatar-stack-item count=\"8\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Size Controlled by the Parent\n\nSize is not set per item - it is set once on the parent with `size` (`sm`, `md`, `lg`). All items in the stack scale together.\n\n```html\n<!-- Small stack: dense lists, table cells -->\n<mds-avatar-stack size=\"sm\">\n <mds-avatar-stack-item initials=\"mr\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n\n<!-- Large stack: profile overviews, hero sections -->\n<mds-avatar-stack size=\"lg\">\n <mds-avatar-stack-item initials=\"er\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"mt\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Styling Customization\n\nStyle individual items through their documented `--mds-avatar-stack-item-*` CSS custom properties, or control the whole stack at once via the parent's `--mds-avatar-stack-*` counterparts (the item vars inherit from those). Use semantic color roles with `rgb(var(--magma-<role>))` so dark mode keeps working.\n\n```css\n/* Override the separator ring color for the whole stack */\n.collab-panel mds-avatar-stack {\n --mds-avatar-stack-background: rgb(var(--magma-surface-raised));\n}\n\n/* Override count badge colors for a specific stack */\n.collab-panel mds-avatar-stack {\n --mds-avatar-stack-count-background-color: rgb(var(--magma-accent-emphasis));\n --mds-avatar-stack-count-color: rgb(var(--magma-accent-on-emphasis));\n}\n```\n",
22
+ "2. Pattern": "Correct and idiomatic ways to use the `<mds-avatar-stack-item>` component, ordered from most common to most specialized. Patterns assume a working knowledge of the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Basic Stack with Initials\n\nThe most common form: place one item per participant inside [`mds-avatar-stack`](../mds-avatar-stack/AGENTS.md). Use `initials` for users without a photo; the stack applies uniform sizing and overlap automatically.\n\n```html\n<mds-avatar-stack>\n <mds-avatar-stack-item initials=\"mr\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"er\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Stack with Photos\n\nUse `src` when a real user photo is available. While `src` is set, `initials` is not displayed: an image that cannot be loaded is replaced by the generic person glyph. Items without `src` show their `initials`, and the tone/variant placeholder when neither is provided.\n\n```html\n<mds-avatar-stack>\n <mds-avatar-stack-item src=\"/avatars/mario-rossi.jpg\" initials=\"mr\"></mds-avatar-stack-item>\n <mds-avatar-stack-item src=\"/avatars/anna-conti.jpg\" initials=\"ac\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"er\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Tone and Variant for Placeholder Color\n\nWhen no image or initials are provided, `tone` and `variant` determine the placeholder background. Use distinct variant values to keep users visually distinguishable. `tone` defaults to `weak`; use `strong` for higher contrast.\n\n```html\n<mds-avatar-stack>\n <mds-avatar-stack-item variant=\"blue\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item variant=\"green\" tone=\"weak\"></mds-avatar-stack-item>\n <mds-avatar-stack-item variant=\"orchid\" tone=\"strong\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Overflow Counter via Parent `total`\n\nSet `total` on the parent to let it append the overflow badge automatically. The badge value is `total` minus the number of slotted items - do not set `count` on the items yourself for this use case.\n\n```html\n<mds-avatar-stack total=\"12\">\n <mds-avatar-stack-item initials=\"mr\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"er\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Manual Overflow Badge via `count`\n\nUse `count` directly on a trailing item only when you are building the overflow indicator yourself and the parent does not own the total. This is rarely needed outside of fully custom stacks.\n\n```html\n<mds-avatar-stack>\n <mds-avatar-stack-item initials=\"mr\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\"></mds-avatar-stack-item>\n <mds-avatar-stack-item count=\"8\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Size Controlled by the Parent\n\nSize is not set per item - it is set once on the parent with `size` (`sm`, `md`, `lg`). All items in the stack scale together.\n\n```html\n<!-- Small stack: dense lists, table cells -->\n<mds-avatar-stack size=\"sm\">\n <mds-avatar-stack-item initials=\"mr\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n\n<!-- Large stack: profile overviews, hero sections -->\n<mds-avatar-stack size=\"lg\">\n <mds-avatar-stack-item initials=\"er\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"mt\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Styling Customization\n\nStyle individual items through their public `--mds-avatar-stack-item-*` CSS custom properties, or control the whole stack at once via the parent's public `--mds-avatar-stack-background` (the item ring color inherits from it). Use semantic color roles with `rgb(var(--magma-<role>))` so dark mode keeps working.\n\n```css\n/* Override the separator ring color for the whole stack */\n.collab-panel mds-avatar-stack {\n --mds-avatar-stack-background: rgb(var(--magma-surface-raised));\n}\n\n/* Override the separator ring color of a single item */\n.collab-panel mds-avatar-stack-item.highlight {\n --mds-avatar-stack-item-background: rgb(var(--magma-accent-emphasis));\n}\n```\n",
18
23
  "3. Antipattern": "Common incorrect uses of `<mds-avatar-stack-item>`. Each entry pairs the wrong form with the right one and a one-line reason. System-wide rules (boolean-as-string, shadow piercing, Tailwind color utilities, raw native event listening) live in [`agents/anti-patterns.md`](../../../../agents/anti-patterns.md) - they apply here too but are not repeated.\n\n#### Do Not Use Outside `mds-avatar-stack`\n\n`<mds-avatar-stack-item>` is a compound child and relies on its parent for sizing, overlap and the overflow counter. Used standalone, it falls back to the medium size, with no stack container and no `size` / `total` control.\n\n```html\n<!-- INCORRECT -->\n<mds-avatar-stack-item initials=\"mr\"></mds-avatar-stack-item>\n\n<!-- CORRECT -->\n<mds-avatar-stack>\n <mds-avatar-stack-item initials=\"mr\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Do Not Set `size` on the Item\n\nThe child has no `size` prop; setting it as an attribute has no effect. Control the scale of every item in the stack with the `size` prop on the parent.\n\n```html\n<!-- INCORRECT -->\n<mds-avatar-stack>\n <mds-avatar-stack-item initials=\"mr\" size=\"lg\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n\n<!-- CORRECT -->\n<mds-avatar-stack size=\"lg\">\n <mds-avatar-stack-item initials=\"mr\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Do Not Duplicate `count` When Using `total`\n\nWhen `total` is set on the parent it auto-appends the overflow item. Adding a manual `count` item on top produces a double overflow indicator.\n\n```html\n<!-- INCORRECT -->\n<mds-avatar-stack total=\"12\">\n <mds-avatar-stack-item initials=\"mr\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\"></mds-avatar-stack-item>\n <mds-avatar-stack-item count=\"10\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n\n<!-- CORRECT - let the parent compute and render the overflow badge -->\n<mds-avatar-stack total=\"12\">\n <mds-avatar-stack-item initials=\"mr\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Do Not Wrap Items in a Div\n\nThe parent counts only its direct `mds-avatar-stack-item` children to compute the overflow. Wrapping items in a `<div>` or any other element breaks that count, and the parent's `size` (applied with `::slotted`) no longer reaches the items.\n\n```html\n<!-- INCORRECT -->\n<mds-avatar-stack total=\"5\">\n <div>\n <mds-avatar-stack-item initials=\"mr\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\"></mds-avatar-stack-item>\n </div>\n</mds-avatar-stack>\n\n<!-- CORRECT - items must be direct slot children -->\n<mds-avatar-stack total=\"5\">\n <mds-avatar-stack-item initials=\"mr\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Do Not Use `tone` and `variant` as the Only Differentiator\n\n`tone` and `variant` style the placeholder background but are overridden by `initials` and ignored when `src` is present. Relying on color alone to identify users is not accessible. Always provide `initials` or `src`.\n\n```html\n<!-- INCORRECT - color-only identity, no label for screen readers -->\n<mds-avatar-stack>\n <mds-avatar-stack-item variant=\"blue\"></mds-avatar-stack-item>\n <mds-avatar-stack-item variant=\"green\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n\n<!-- CORRECT - initials provide a visible and screen-reader-friendly label -->\n<mds-avatar-stack>\n <mds-avatar-stack-item initials=\"mr\"></mds-avatar-stack-item>\n <mds-avatar-stack-item initials=\"ac\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n\n#### Do Not Use an Invalid `tone` Value\n\n`tone` on this component accepts only `weak` (default) and `strong` - the `ToneMinimalVariantType` set. Values like `outline` or `text`, valid on other components, match no style here: the avatar renders as with `strong`, not with the `weak` default.\n\n```html\n<!-- INCORRECT (tone=\"outline\" is not in ToneMinimalVariantType) -->\n<mds-avatar-stack>\n <mds-avatar-stack-item initials=\"mr\" tone=\"outline\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n\n<!-- CORRECT -->\n<mds-avatar-stack>\n <mds-avatar-stack-item initials=\"mr\" tone=\"strong\"></mds-avatar-stack-item>\n</mds-avatar-stack>\n```\n"
19
24
  },
20
25
  "props": [
@@ -246,37 +251,44 @@
246
251
  {
247
252
  "name": "--mds-avatar-stack-item-background",
248
253
  "annotation": "prop",
249
- "docs": "The background color of each avatar in the stack"
254
+ "docs": "The background color of each avatar in the stack",
255
+ "visibility": "public"
250
256
  },
251
257
  {
252
258
  "name": "--mds-avatar-stack-item-border",
253
259
  "annotation": "prop",
254
- "docs": "Computed active border (based on selected size)"
260
+ "docs": "Computed active border (based on selected size)",
261
+ "visibility": "internal"
255
262
  },
256
263
  {
257
264
  "name": "--mds-avatar-stack-item-count-background-color",
258
265
  "annotation": "prop",
259
- "docs": "Background color of the count badge in the stack"
266
+ "docs": "Background color of the count badge in the stack",
267
+ "visibility": "internal"
260
268
  },
261
269
  {
262
270
  "name": "--mds-avatar-stack-item-count-color",
263
271
  "annotation": "prop",
264
- "docs": "Text color for the count badge in the stack"
272
+ "docs": "Text color for the count badge in the stack",
273
+ "visibility": "internal"
265
274
  },
266
275
  {
267
276
  "name": "--mds-avatar-stack-item-offset",
268
277
  "annotation": "prop",
269
- "docs": "Computed active offset (based on selected size)"
278
+ "docs": "Computed active offset (based on selected size)",
279
+ "visibility": "internal"
270
280
  },
271
281
  {
272
282
  "name": "--mds-avatar-stack-item-offset-margin",
273
283
  "annotation": "prop",
274
- "docs": "Computed margin for overlapping avatars"
284
+ "docs": "Computed margin for overlapping avatars",
285
+ "visibility": "internal"
275
286
  },
276
287
  {
277
288
  "name": "--mds-avatar-stack-item-size",
278
289
  "annotation": "prop",
279
- "docs": "Computed active size (based on selected size)"
290
+ "docs": "Computed active size (based on selected size)",
291
+ "visibility": "public"
280
292
  }
281
293
  ],
282
294
  "slots": [],
@@ -11,11 +11,11 @@ mds-avatar {
11
11
 
12
12
 
13
13
  /**
14
- * @prop --mds-avatar-stack-item-background: The background color of each avatar in the stack
14
+ * @prop --mds-avatar-stack-item-background: Public. The background color of each avatar in the stack
15
15
  * @prop --mds-avatar-stack-item-count-background-color: Background color of the count badge in the stack
16
16
  * @prop --mds-avatar-stack-item-count-color: Text color for the count badge in the stack
17
17
  * @prop --mds-avatar-stack-item-border: Computed active border (based on selected size)
18
- * @prop --mds-avatar-stack-item-size: Computed active size (based on selected size)
18
+ * @prop --mds-avatar-stack-item-size: Public. Computed active size (based on selected size)
19
19
  * @prop --mds-avatar-stack-item-offset: Computed active offset (based on selected size)
20
20
  * @prop --mds-avatar-stack-item-offset-margin: Computed margin for overlapping avatars
21
21
  */
@@ -1,4 +1,7 @@
1
1
  import { Host, h } from "@stencil/core";
2
+ /**
3
+ * @parent mds-avatar-stack
4
+ */
2
5
  export class MdsAvatarStackItem {
3
6
  constructor() {
4
7
  /**
@@ -7,7 +10,7 @@ export class MdsAvatarStackItem {
7
10
  this.tone = 'weak';
8
11
  }
9
12
  render() {
10
- return (h(Host, { key: '8ad5051f47c51387c968570afd0934423f8c48dd' }, h("mds-avatar", { key: '6b51faaa7960a47e919d0b486f2418d8d6acceb6', class: "avatar", count: this.count, initials: this.initials, src: this.src, tone: this.tone, variant: this.variant })));
13
+ return (h(Host, { key: '05fab51722e7e9e5e62276db93ab0f93cdb34859' }, h("mds-avatar", { key: 'f42a8842f09cb7468d9e5637d0b144815dda374c', class: "avatar", count: this.count, initials: this.initials, src: this.src, tone: this.tone, variant: this.variant })));
11
14
  }
12
15
  static get is() { return "mds-avatar-stack-item"; }
13
16
  static get encapsulation() { return "shadow"; }