@maggioli-design-system/magma 2.5.1 → 2.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1483) hide show
  1. package/AGENTS.md +19 -4
  2. package/CHANGELOG.md +45 -0
  3. package/agents/assets.md +1 -1
  4. package/agents/color.md +22 -4
  5. package/agents/components.md +164 -92
  6. package/agents/conventions.md +17 -7
  7. package/agents/install.md +7 -0
  8. package/agents/lint.md +270 -0
  9. package/agents/mcp.md +103 -0
  10. package/agents/theming.md +8 -0
  11. package/dist/cjs/index-BQNHYWJg.js +4 -0
  12. package/dist/cjs/loader.cjs.js +1 -1
  13. package/dist/cjs/magma-components.cjs.js +1 -1
  14. package/dist/cjs/mds-accordion-item.cjs.entry.js +1 -1
  15. package/dist/cjs/mds-accordion-timer-item.cjs.entry.js +1 -1
  16. package/dist/cjs/mds-accordion-timer.cjs.entry.js +1 -1
  17. package/dist/cjs/mds-accordion.cjs.entry.js +1 -1
  18. package/dist/cjs/mds-author.cjs.entry.js +1 -1
  19. package/dist/cjs/mds-avatar-stack-item.cjs.entry.js +1 -1
  20. package/dist/cjs/mds-avatar-stack.cjs.entry.js +1 -1
  21. package/dist/cjs/mds-avatar.cjs.entry.js +1 -1
  22. package/dist/cjs/mds-badge.cjs.entry.js +1 -1
  23. package/dist/cjs/mds-banner_3.cjs.entry.js +3 -3
  24. package/dist/cjs/mds-benchmark-bar.cjs.entry.js +1 -1
  25. package/dist/cjs/mds-bibliography.cjs.entry.js +1 -1
  26. package/dist/cjs/mds-book.cjs.entry.js +703 -0
  27. package/dist/cjs/mds-breadcrumb-item.cjs.entry.js +1 -1
  28. package/dist/cjs/mds-breadcrumb.cjs.entry.js +1 -1
  29. package/dist/cjs/mds-button-dropdown.cjs.entry.js +1 -1
  30. package/dist/cjs/mds-button-group.cjs.entry.js +1 -1
  31. package/dist/cjs/mds-button_3.cjs.entry.js +6 -6
  32. package/dist/cjs/mds-calendar_2.cjs.entry.js +6 -6
  33. package/dist/cjs/mds-card-content.cjs.entry.js +1 -1
  34. package/dist/cjs/mds-card-footer.cjs.entry.js +1 -1
  35. package/dist/cjs/mds-card-header.cjs.entry.js +1 -1
  36. package/dist/cjs/mds-card-media.cjs.entry.js +1 -1
  37. package/dist/cjs/mds-card.cjs.entry.js +1 -1
  38. package/dist/cjs/mds-details.cjs.entry.js +1 -1
  39. package/dist/cjs/mds-dropdown.cjs.entry.js +2 -2
  40. package/dist/cjs/mds-emoji.cjs.entry.js +1 -1
  41. package/dist/cjs/mds-entity.cjs.entry.js +1 -1
  42. package/dist/cjs/mds-file-preview.cjs.entry.js +2 -2
  43. package/dist/cjs/mds-file.cjs.entry.js +1 -1
  44. package/dist/cjs/mds-filter-item.cjs.entry.js +1 -1
  45. package/dist/cjs/mds-filter.cjs.entry.js +1 -1
  46. package/dist/cjs/mds-header-bar.cjs.entry.js +1 -1
  47. package/dist/cjs/mds-header.cjs.entry.js +2 -2
  48. package/dist/cjs/mds-horizontal-scroll.cjs.entry.js +1 -1
  49. package/dist/cjs/mds-hr.cjs.entry.js +1 -1
  50. package/dist/cjs/mds-input-date-range-preselection.cjs.entry.js +1 -1
  51. package/dist/cjs/mds-input-date-range.cjs.entry.js +2 -2
  52. package/dist/cjs/mds-input-date.cjs.entry.js +2 -2
  53. package/dist/cjs/mds-input-field.cjs.entry.js +1 -1
  54. package/dist/cjs/mds-input-otp.cjs.entry.js +1 -1
  55. package/dist/cjs/mds-input-range.cjs.entry.js +1 -1
  56. package/dist/cjs/mds-input-select.cjs.entry.js +2 -2
  57. package/dist/cjs/mds-input-switch_2.cjs.entry.js +2 -2
  58. package/dist/cjs/mds-input-tip_2.cjs.entry.js +3 -3
  59. package/dist/cjs/mds-input-upload.cjs.entry.js +5 -5
  60. package/dist/cjs/mds-input.cjs.entry.js +2 -2
  61. package/dist/cjs/mds-keyboard-key.cjs.entry.js +2 -2
  62. package/dist/cjs/mds-keyboard.cjs.entry.js +2 -2
  63. package/dist/cjs/mds-kpi-item.cjs.entry.js +1 -1
  64. package/dist/cjs/mds-kpi.cjs.entry.js +1 -1
  65. package/dist/cjs/mds-label.cjs.entry.js +1 -1
  66. package/dist/cjs/mds-link.cjs.entry.js +3 -3
  67. package/dist/cjs/mds-list-item.cjs.entry.js +1 -1
  68. package/dist/cjs/mds-list.cjs.entry.js +1 -1
  69. package/dist/cjs/mds-mention.cjs.entry.js +1 -1
  70. package/dist/cjs/mds-modal.cjs.entry.js +3 -3
  71. package/dist/cjs/mds-note.cjs.entry.js +1 -1
  72. package/dist/cjs/mds-notification.cjs.entry.js +1 -1
  73. package/dist/cjs/mds-paginator-item.cjs.entry.js +1 -1
  74. package/dist/cjs/mds-paginator.cjs.entry.js +1 -1
  75. package/dist/cjs/mds-policy-ai.cjs.entry.js +1 -1
  76. package/dist/cjs/mds-pref-animation.cjs.entry.js +1 -1
  77. package/dist/cjs/mds-pref-consumption.cjs.entry.js +1 -1
  78. package/dist/cjs/mds-pref-contrast.cjs.entry.js +1 -1
  79. package/dist/cjs/mds-pref-language-item.cjs.entry.js +1 -1
  80. package/dist/cjs/mds-pref-language.cjs.entry.js +1 -1
  81. package/dist/cjs/mds-pref-mode.cjs.entry.js +1 -1
  82. package/dist/cjs/mds-pref-theme-item.cjs.entry.js +1 -1
  83. package/dist/cjs/mds-pref-theme.cjs.entry.js +1 -1
  84. package/dist/cjs/mds-pref.cjs.entry.js +1 -1
  85. package/dist/cjs/mds-price-table-features-cell.cjs.entry.js +1 -1
  86. package/dist/cjs/mds-price-table-features-row.cjs.entry.js +1 -1
  87. package/dist/cjs/mds-price-table-features.cjs.entry.js +1 -1
  88. package/dist/cjs/mds-price-table-header.cjs.entry.js +1 -1
  89. package/dist/cjs/mds-price-table-list-item.cjs.entry.js +1 -1
  90. package/dist/cjs/mds-price-table-list.cjs.entry.js +1 -1
  91. package/dist/cjs/mds-price-table.cjs.entry.js +1 -1
  92. package/dist/cjs/mds-progress_2.cjs.entry.js +2 -2
  93. package/dist/cjs/mds-push-notification-item.cjs.entry.js +2 -2
  94. package/dist/cjs/mds-push-notification.cjs.entry.js +2 -2
  95. package/dist/cjs/mds-quote.cjs.entry.js +1 -1
  96. package/dist/cjs/mds-radial-menu-item.cjs.entry.js +1 -1
  97. package/dist/cjs/mds-radial-menu.cjs.entry.js +1 -1
  98. package/dist/cjs/mds-separator.cjs.entry.js +1 -1
  99. package/dist/cjs/mds-status-bar.cjs.entry.js +1 -1
  100. package/dist/cjs/mds-stepper-bar-item.cjs.entry.js +1 -1
  101. package/dist/cjs/mds-stepper-bar.cjs.entry.js +1 -1
  102. package/dist/cjs/mds-tab-bar-item.cjs.entry.js +1 -1
  103. package/dist/cjs/mds-tab-bar.cjs.entry.js +1 -1
  104. package/dist/cjs/mds-tab_2.cjs.entry.js +4 -4
  105. package/dist/cjs/mds-table-body.cjs.entry.js +1 -1
  106. package/dist/cjs/mds-table-footer.cjs.entry.js +1 -1
  107. package/dist/cjs/mds-table-header-cell.cjs.entry.js +1 -1
  108. package/dist/cjs/mds-table-header.cjs.entry.js +1 -1
  109. package/dist/cjs/mds-table-row.cjs.entry.js +2 -2
  110. package/dist/cjs/mds-table.cjs.entry.js +1 -1
  111. package/dist/cjs/mds-text.cjs.entry.js +1 -1
  112. package/dist/cjs/mds-toast-region.cjs.entry.js +1 -1
  113. package/dist/cjs/mds-toast.cjs.entry.js +1 -1
  114. package/dist/cjs/mds-tooltip.cjs.entry.js +2 -2
  115. package/dist/cjs/mds-tree-item.cjs.entry.js +1 -1
  116. package/dist/cjs/mds-tree.cjs.entry.js +1 -1
  117. package/dist/cjs/mds-url-view.cjs.entry.js +1 -1
  118. package/dist/cjs/mds-usage.cjs.entry.js +1 -1
  119. package/dist/cjs/mds-video-wall.cjs.entry.js +1 -1
  120. package/dist/cjs/mds-zero.cjs.entry.js +1 -1
  121. package/dist/collection/collection-manifest.json +1 -0
  122. package/dist/collection/components/mds-accordion/AGENTS.md +3 -5
  123. package/dist/collection/components/mds-accordion/antipattern.md +1 -2
  124. package/dist/collection/components/mds-accordion/documentation.json +21 -10
  125. package/dist/collection/components/mds-accordion/mds-accordion.css +3 -3
  126. package/dist/collection/components/mds-accordion/mds-accordion.js +2 -1
  127. package/dist/collection/components/mds-accordion/pattern.md +1 -4
  128. package/dist/collection/components/mds-accordion-item/AGENTS.md +3 -7
  129. package/dist/collection/components/mds-accordion-item/documentation.json +20 -9
  130. package/dist/collection/components/mds-accordion-item/mds-accordion-item.css +1 -1
  131. package/dist/collection/components/mds-accordion-item/mds-accordion-item.js +2 -1
  132. package/dist/collection/components/mds-accordion-item/pattern.md +3 -5
  133. package/dist/collection/components/mds-accordion-timer/AGENTS.md +3 -5
  134. package/dist/collection/components/mds-accordion-timer/antipattern.md +5 -3
  135. package/dist/collection/components/mds-accordion-timer/documentation.json +17 -8
  136. package/dist/collection/components/mds-accordion-timer/mds-accordion-timer.css +1 -1
  137. package/dist/collection/components/mds-accordion-timer/mds-accordion-timer.js +2 -1
  138. package/dist/collection/components/mds-accordion-timer/pattern.md +6 -6
  139. package/dist/collection/components/mds-accordion-timer-item/AGENTS.md +3 -5
  140. package/dist/collection/components/mds-accordion-timer-item/antipattern.md +1 -2
  141. package/dist/collection/components/mds-accordion-timer-item/documentation.json +17 -8
  142. package/dist/collection/components/mds-accordion-timer-item/mds-accordion-timer-item.css +1 -1
  143. package/dist/collection/components/mds-accordion-timer-item/mds-accordion-timer-item.js +2 -1
  144. package/dist/collection/components/mds-accordion-timer-item/pattern.md +1 -5
  145. package/dist/collection/components/mds-author/AGENTS.md +1 -1
  146. package/dist/collection/components/mds-author/documentation.json +5 -1
  147. package/dist/collection/components/mds-author/mds-author.js +2 -1
  148. package/dist/collection/components/mds-avatar/AGENTS.md +3 -3
  149. package/dist/collection/components/mds-avatar/antipattern.md +1 -1
  150. package/dist/collection/components/mds-avatar/documentation.json +17 -8
  151. package/dist/collection/components/mds-avatar/mds-avatar.css +3 -3
  152. package/dist/collection/components/mds-avatar/mds-avatar.js +2 -1
  153. package/dist/collection/components/mds-avatar/pattern.md +1 -2
  154. package/dist/collection/components/mds-avatar-stack/AGENTS.md +3 -12
  155. package/dist/collection/components/mds-avatar-stack/antipattern.md +1 -2
  156. package/dist/collection/components/mds-avatar-stack/documentation.json +31 -15
  157. package/dist/collection/components/mds-avatar-stack/mds-avatar-stack.css +1 -1
  158. package/dist/collection/components/mds-avatar-stack/mds-avatar-stack.js +2 -1
  159. package/dist/collection/components/mds-avatar-stack/pattern.md +2 -5
  160. package/dist/collection/components/mds-avatar-stack-item/AGENTS.md +3 -6
  161. package/dist/collection/components/mds-avatar-stack-item/documentation.json +22 -10
  162. package/dist/collection/components/mds-avatar-stack-item/mds-avatar-stack-item.css +2 -2
  163. package/dist/collection/components/mds-avatar-stack-item/mds-avatar-stack-item.js +4 -1
  164. package/dist/collection/components/mds-avatar-stack-item/pattern.md +4 -5
  165. package/dist/collection/components/mds-badge/AGENTS.md +3 -3
  166. package/dist/collection/components/mds-badge/antipattern.md +1 -1
  167. package/dist/collection/components/mds-badge/documentation.json +17 -8
  168. package/dist/collection/components/mds-badge/mds-badge.css +3 -3
  169. package/dist/collection/components/mds-badge/mds-badge.js +2 -1
  170. package/dist/collection/components/mds-badge/pattern.md +4 -7
  171. package/dist/collection/components/mds-banner/AGENTS.md +3 -8
  172. package/dist/collection/components/mds-banner/antipattern.md +1 -2
  173. package/dist/collection/components/mds-banner/documentation.json +29 -14
  174. package/dist/collection/components/mds-banner/mds-banner.css +4 -4
  175. package/dist/collection/components/mds-banner/mds-banner.js +2 -1
  176. package/dist/collection/components/mds-banner/pattern.md +1 -2
  177. package/dist/collection/components/mds-benchmark-bar/AGENTS.md +1 -1
  178. package/dist/collection/components/mds-benchmark-bar/documentation.json +5 -1
  179. package/dist/collection/components/mds-benchmark-bar/mds-benchmark-bar.js +2 -1
  180. package/dist/collection/components/mds-bibliography/AGENTS.md +3 -3
  181. package/dist/collection/components/mds-bibliography/antipattern.md +1 -3
  182. package/dist/collection/components/mds-bibliography/documentation.json +15 -7
  183. package/dist/collection/components/mds-bibliography/mds-bibliography.css +1 -1
  184. package/dist/collection/components/mds-bibliography/mds-bibliography.js +4 -1
  185. package/dist/collection/components/mds-bibliography/pattern.md +1 -3
  186. package/dist/collection/components/mds-book/AGENTS.md +79 -0
  187. package/dist/collection/components/mds-book/antipattern.md +88 -0
  188. package/dist/collection/components/mds-book/documentation.json +482 -0
  189. package/dist/collection/components/mds-book/mds-book.css +901 -0
  190. package/dist/collection/components/mds-book/mds-book.js +731 -0
  191. package/dist/collection/components/mds-book/meta/dictionary.js +5 -0
  192. package/dist/collection/components/mds-book/meta/format.js +57 -0
  193. package/dist/collection/components/mds-book/meta/pose.js +107 -0
  194. package/dist/collection/components/mds-book/meta/spine.js +61 -0
  195. package/dist/collection/components/mds-book/meta/types.js +1 -0
  196. package/dist/collection/components/mds-book/meta/volume.js +23 -0
  197. package/dist/collection/components/mds-book/pattern.md +111 -0
  198. package/dist/collection/components/mds-breadcrumb/AGENTS.md +3 -14
  199. package/dist/collection/components/mds-breadcrumb/antipattern.md +1 -1
  200. package/dist/collection/components/mds-breadcrumb/documentation.json +28 -14
  201. package/dist/collection/components/mds-breadcrumb/mds-breadcrumb.js +2 -1
  202. package/dist/collection/components/mds-breadcrumb/pattern.md +6 -6
  203. package/dist/collection/components/mds-breadcrumb-item/AGENTS.md +3 -11
  204. package/dist/collection/components/mds-breadcrumb-item/antipattern.md +3 -3
  205. package/dist/collection/components/mds-breadcrumb-item/documentation.json +22 -11
  206. package/dist/collection/components/mds-breadcrumb-item/mds-breadcrumb-item.js +2 -1
  207. package/dist/collection/components/mds-breadcrumb-item/pattern.md +12 -14
  208. package/dist/collection/components/mds-button/AGENTS.md +3 -12
  209. package/dist/collection/components/mds-button/documentation.json +37 -17
  210. package/dist/collection/components/mds-button/mds-button.css +5 -5
  211. package/dist/collection/components/mds-button/mds-button.js +5 -4
  212. package/dist/collection/components/mds-button-dropdown/AGENTS.md +1 -1
  213. package/dist/collection/components/mds-button-dropdown/documentation.json +7 -2
  214. package/dist/collection/components/mds-button-dropdown/mds-button-dropdown.css +1 -1
  215. package/dist/collection/components/mds-button-dropdown/mds-button-dropdown.js +2 -1
  216. package/dist/collection/components/mds-button-group/AGENTS.md +1 -1
  217. package/dist/collection/components/mds-button-group/documentation.json +5 -1
  218. package/dist/collection/components/mds-button-group/mds-button-group.js +2 -1
  219. package/dist/collection/components/mds-calendar/AGENTS.md +3 -6
  220. package/dist/collection/components/mds-calendar/antipattern.md +1 -1
  221. package/dist/collection/components/mds-calendar/documentation.json +25 -12
  222. package/dist/collection/components/mds-calendar/mds-calendar.css +4 -4
  223. package/dist/collection/components/mds-calendar/mds-calendar.js +6 -5
  224. package/dist/collection/components/mds-calendar/pattern.md +1 -3
  225. package/dist/collection/components/mds-calendar-cell/AGENTS.md +3 -35
  226. package/dist/collection/components/mds-calendar-cell/antipattern.md +1 -2
  227. package/dist/collection/components/mds-calendar-cell/documentation.json +81 -40
  228. package/dist/collection/components/mds-calendar-cell/mds-calendar-cell.css +2 -2
  229. package/dist/collection/components/mds-calendar-cell/mds-calendar-cell.js +4 -1
  230. package/dist/collection/components/mds-calendar-cell/pattern.md +4 -5
  231. package/dist/collection/components/mds-card/AGENTS.md +1 -1
  232. package/dist/collection/components/mds-card/antipattern.md +2 -2
  233. package/dist/collection/components/mds-card/documentation.json +13 -6
  234. package/dist/collection/components/mds-card/mds-card.css +3 -3
  235. package/dist/collection/components/mds-card/mds-card.js +2 -1
  236. package/dist/collection/components/mds-card/pattern.md +4 -4
  237. package/dist/collection/components/mds-card-content/AGENTS.md +1 -1
  238. package/dist/collection/components/mds-card-content/documentation.json +5 -1
  239. package/dist/collection/components/mds-card-content/mds-card-content.js +2 -1
  240. package/dist/collection/components/mds-card-footer/AGENTS.md +1 -1
  241. package/dist/collection/components/mds-card-footer/documentation.json +5 -1
  242. package/dist/collection/components/mds-card-footer/mds-card-footer.js +2 -1
  243. package/dist/collection/components/mds-card-header/AGENTS.md +1 -1
  244. package/dist/collection/components/mds-card-header/documentation.json +5 -1
  245. package/dist/collection/components/mds-card-header/mds-card-header.js +2 -1
  246. package/dist/collection/components/mds-card-media/AGENTS.md +1 -1
  247. package/dist/collection/components/mds-card-media/documentation.json +5 -1
  248. package/dist/collection/components/mds-card-media/mds-card-media.js +2 -1
  249. package/dist/collection/components/mds-chip/AGENTS.md +3 -10
  250. package/dist/collection/components/mds-chip/antipattern.md +2 -3
  251. package/dist/collection/components/mds-chip/documentation.json +35 -17
  252. package/dist/collection/components/mds-chip/mds-chip.css +4 -4
  253. package/dist/collection/components/mds-chip/mds-chip.js +4 -1
  254. package/dist/collection/components/mds-chip/pattern.md +4 -6
  255. package/dist/collection/components/mds-details/AGENTS.md +3 -7
  256. package/dist/collection/components/mds-details/antipattern.md +1 -5
  257. package/dist/collection/components/mds-details/documentation.json +14 -7
  258. package/dist/collection/components/mds-details/mds-details.js +2 -1
  259. package/dist/collection/components/mds-details/pattern.md +4 -6
  260. package/dist/collection/components/mds-dropdown/AGENTS.md +3 -9
  261. package/dist/collection/components/mds-dropdown/antipattern.md +1 -1
  262. package/dist/collection/components/mds-dropdown/documentation.json +31 -15
  263. package/dist/collection/components/mds-dropdown/mds-dropdown.css +4 -4
  264. package/dist/collection/components/mds-dropdown/mds-dropdown.js +3 -2
  265. package/dist/collection/components/mds-dropdown/pattern.md +2 -4
  266. package/dist/collection/components/mds-emoji/AGENTS.md +8 -32
  267. package/dist/collection/components/mds-emoji/antipattern.md +0 -18
  268. package/dist/collection/components/mds-emoji/documentation.json +73 -35
  269. package/dist/collection/components/mds-emoji/mds-emoji.css +8 -4
  270. package/dist/collection/components/mds-emoji/mds-emoji.js +4 -1
  271. package/dist/collection/components/mds-emoji/pattern.md +9 -25
  272. package/dist/collection/components/mds-entity/AGENTS.md +3 -4
  273. package/dist/collection/components/mds-entity/antipattern.md +10 -3
  274. package/dist/collection/components/mds-entity/documentation.json +17 -8
  275. package/dist/collection/components/mds-entity/mds-entity.css +2 -2
  276. package/dist/collection/components/mds-entity/mds-entity.js +2 -1
  277. package/dist/collection/components/mds-entity/pattern.md +1 -4
  278. package/dist/collection/components/mds-file/AGENTS.md +3 -3
  279. package/dist/collection/components/mds-file/antipattern.md +2 -3
  280. package/dist/collection/components/mds-file/documentation.json +15 -7
  281. package/dist/collection/components/mds-file/mds-file.css +1 -1
  282. package/dist/collection/components/mds-file/mds-file.js +4 -1
  283. package/dist/collection/components/mds-file/pattern.md +1 -3
  284. package/dist/collection/components/mds-file-preview/AGENTS.md +3 -3
  285. package/dist/collection/components/mds-file-preview/antipattern.md +1 -1
  286. package/dist/collection/components/mds-file-preview/documentation.json +17 -8
  287. package/dist/collection/components/mds-file-preview/mds-file-preview.css +3 -3
  288. package/dist/collection/components/mds-file-preview/mds-file-preview.js +3 -2
  289. package/dist/collection/components/mds-file-preview/pattern.md +2 -3
  290. package/dist/collection/components/mds-filter/AGENTS.md +3 -8
  291. package/dist/collection/components/mds-filter/antipattern.md +2 -2
  292. package/dist/collection/components/mds-filter/documentation.json +27 -13
  293. package/dist/collection/components/mds-filter/mds-filter.css +3 -3
  294. package/dist/collection/components/mds-filter/mds-filter.js +2 -1
  295. package/dist/collection/components/mds-filter/pattern.md +2 -5
  296. package/dist/collection/components/mds-filter-item/AGENTS.md +2 -7
  297. package/dist/collection/components/mds-filter-item/antipattern.md +4 -4
  298. package/dist/collection/components/mds-filter-item/documentation.json +17 -8
  299. package/dist/collection/components/mds-filter-item/mds-filter-item.js +4 -1
  300. package/dist/collection/components/mds-filter-item/pattern.md +5 -7
  301. package/dist/collection/components/mds-header/AGENTS.md +4 -8
  302. package/dist/collection/components/mds-header/documentation.json +28 -13
  303. package/dist/collection/components/mds-header/mds-header.css +7 -7
  304. package/dist/collection/components/mds-header/mds-header.js +2 -1
  305. package/dist/collection/components/mds-header/pattern.md +1 -3
  306. package/dist/collection/components/mds-header-bar/AGENTS.md +2 -4
  307. package/dist/collection/components/mds-header-bar/antipattern.md +6 -8
  308. package/dist/collection/components/mds-header-bar/documentation.json +9 -4
  309. package/dist/collection/components/mds-header-bar/mds-header-bar.js +2 -1
  310. package/dist/collection/components/mds-header-bar/pattern.md +10 -6
  311. package/dist/collection/components/mds-help/AGENTS.md +1 -1
  312. package/dist/collection/components/mds-help/documentation.json +13 -5
  313. package/dist/collection/components/mds-help/mds-help.css +4 -4
  314. package/dist/collection/components/mds-help/mds-help.js +2 -1
  315. package/dist/collection/components/mds-horizontal-scroll/AGENTS.md +5 -11
  316. package/dist/collection/components/mds-horizontal-scroll/antipattern.md +2 -2
  317. package/dist/collection/components/mds-horizontal-scroll/documentation.json +34 -14
  318. package/dist/collection/components/mds-horizontal-scroll/mds-horizontal-scroll.css +2 -1
  319. package/dist/collection/components/mds-horizontal-scroll/mds-horizontal-scroll.js +2 -1
  320. package/dist/collection/components/mds-horizontal-scroll/pattern.md +4 -15
  321. package/dist/collection/components/mds-hr/AGENTS.md +1 -1
  322. package/dist/collection/components/mds-hr/documentation.json +7 -2
  323. package/dist/collection/components/mds-hr/mds-hr.js +4 -1
  324. package/dist/collection/components/mds-icon/AGENTS.md +1 -1
  325. package/dist/collection/components/mds-icon/documentation.json +5 -1
  326. package/dist/collection/components/mds-icon/mds-icon.js +2 -1
  327. package/dist/collection/components/mds-img/AGENTS.md +3 -5
  328. package/dist/collection/components/mds-img/antipattern.md +1 -1
  329. package/dist/collection/components/mds-img/documentation.json +19 -9
  330. package/dist/collection/components/mds-img/mds-img.css +2 -2
  331. package/dist/collection/components/mds-img/mds-img.js +1 -0
  332. package/dist/collection/components/mds-img/pattern.md +1 -4
  333. package/dist/collection/components/mds-input/AGENTS.md +3 -9
  334. package/dist/collection/components/mds-input/antipattern.md +1 -1
  335. package/dist/collection/components/mds-input/documentation.json +39 -19
  336. package/dist/collection/components/mds-input/mds-input.css +8 -8
  337. package/dist/collection/components/mds-input/mds-input.js +3 -2
  338. package/dist/collection/components/mds-input/pattern.md +1 -3
  339. package/dist/collection/components/mds-input-date/AGENTS.md +3 -8
  340. package/dist/collection/components/mds-input-date/antipattern.md +1 -1
  341. package/dist/collection/components/mds-input-date/documentation.json +31 -15
  342. package/dist/collection/components/mds-input-date/mds-input-date.css +5 -5
  343. package/dist/collection/components/mds-input-date/mds-input-date.js +3 -2
  344. package/dist/collection/components/mds-input-date/pattern.md +1 -2
  345. package/dist/collection/components/mds-input-date-range/AGENTS.md +3 -4
  346. package/dist/collection/components/mds-input-date-range/documentation.json +22 -10
  347. package/dist/collection/components/mds-input-date-range/mds-input-date-range.css +5 -5
  348. package/dist/collection/components/mds-input-date-range/mds-input-date-range.js +3 -2
  349. package/dist/collection/components/mds-input-date-range/pattern.md +1 -2
  350. package/dist/collection/components/mds-input-date-range-preselection/AGENTS.md +3 -13
  351. package/dist/collection/components/mds-input-date-range-preselection/antipattern.md +11 -6
  352. package/dist/collection/components/mds-input-date-range-preselection/documentation.json +26 -13
  353. package/dist/collection/components/mds-input-date-range-preselection/mds-input-date-range-preselection.js +2 -1
  354. package/dist/collection/components/mds-input-date-range-preselection/pattern.md +1 -11
  355. package/dist/collection/components/mds-input-field/AGENTS.md +1 -1
  356. package/dist/collection/components/mds-input-field/documentation.json +9 -3
  357. package/dist/collection/components/mds-input-field/mds-input-field.css +2 -2
  358. package/dist/collection/components/mds-input-field/mds-input-field.js +2 -1
  359. package/dist/collection/components/mds-input-otp/AGENTS.md +1 -1
  360. package/dist/collection/components/mds-input-otp/documentation.json +7 -2
  361. package/dist/collection/components/mds-input-otp/mds-input-otp.js +4 -1
  362. package/dist/collection/components/mds-input-range/AGENTS.md +3 -13
  363. package/dist/collection/components/mds-input-range/antipattern.md +1 -5
  364. package/dist/collection/components/mds-input-range/documentation.json +26 -13
  365. package/dist/collection/components/mds-input-range/mds-input-range.js +2 -1
  366. package/dist/collection/components/mds-input-range/pattern.md +2 -12
  367. package/dist/collection/components/mds-input-select/AGENTS.md +3 -7
  368. package/dist/collection/components/mds-input-select/antipattern.md +1 -1
  369. package/dist/collection/components/mds-input-select/documentation.json +25 -12
  370. package/dist/collection/components/mds-input-select/mds-input-select.css +3 -3
  371. package/dist/collection/components/mds-input-select/mds-input-select.js +3 -2
  372. package/dist/collection/components/mds-input-select/pattern.md +1 -3
  373. package/dist/collection/components/mds-input-switch/AGENTS.md +2 -30
  374. package/dist/collection/components/mds-input-switch/antipattern.md +5 -6
  375. package/dist/collection/components/mds-input-switch/documentation.json +61 -30
  376. package/dist/collection/components/mds-input-switch/mds-input-switch.js +2 -1
  377. package/dist/collection/components/mds-input-switch/pattern.md +2 -11
  378. package/dist/collection/components/mds-input-tip/AGENTS.md +3 -5
  379. package/dist/collection/components/mds-input-tip/antipattern.md +10 -6
  380. package/dist/collection/components/mds-input-tip/documentation.json +17 -8
  381. package/dist/collection/components/mds-input-tip/mds-input-tip.css +1 -1
  382. package/dist/collection/components/mds-input-tip/mds-input-tip.js +2 -1
  383. package/dist/collection/components/mds-input-tip/pattern.md +1 -4
  384. package/dist/collection/components/mds-input-tip-item/AGENTS.md +4 -3
  385. package/dist/collection/components/mds-input-tip-item/antipattern.md +2 -2
  386. package/dist/collection/components/mds-input-tip-item/documentation.json +14 -7
  387. package/dist/collection/components/mds-input-tip-item/mds-input-tip-item.css +2 -2
  388. package/dist/collection/components/mds-input-tip-item/mds-input-tip-item.js +3 -2
  389. package/dist/collection/components/mds-input-tip-item/pattern.md +1 -2
  390. package/dist/collection/components/mds-input-upload/AGENTS.md +3 -5
  391. package/dist/collection/components/mds-input-upload/antipattern.md +2 -3
  392. package/dist/collection/components/mds-input-upload/documentation.json +19 -9
  393. package/dist/collection/components/mds-input-upload/mds-input-upload.css +1 -1
  394. package/dist/collection/components/mds-input-upload/mds-input-upload.js +8 -5
  395. package/dist/collection/components/mds-input-upload/pattern.md +1 -5
  396. package/dist/collection/components/mds-keyboard/AGENTS.md +3 -18
  397. package/dist/collection/components/mds-keyboard/antipattern.md +3 -3
  398. package/dist/collection/components/mds-keyboard/documentation.json +47 -23
  399. package/dist/collection/components/mds-keyboard/mds-keyboard.css +17 -5
  400. package/dist/collection/components/mds-keyboard/mds-keyboard.js +2 -1
  401. package/dist/collection/components/mds-keyboard/pattern.md +1 -2
  402. package/dist/collection/components/mds-keyboard-key/AGENTS.md +3 -6
  403. package/dist/collection/components/mds-keyboard-key/antipattern.md +1 -2
  404. package/dist/collection/components/mds-keyboard-key/documentation.json +21 -10
  405. package/dist/collection/components/mds-keyboard-key/mds-keyboard-key.css +7 -3
  406. package/dist/collection/components/mds-keyboard-key/mds-keyboard-key.js +4 -1
  407. package/dist/collection/components/mds-keyboard-key/pattern.md +1 -12
  408. package/dist/collection/components/mds-kpi/AGENTS.md +1 -1
  409. package/dist/collection/components/mds-kpi/documentation.json +10 -4
  410. package/dist/collection/components/mds-kpi/mds-kpi.css +2 -2
  411. package/dist/collection/components/mds-kpi/mds-kpi.js +2 -1
  412. package/dist/collection/components/mds-kpi/pattern.md +7 -4
  413. package/dist/collection/components/mds-kpi-item/AGENTS.md +3 -8
  414. package/dist/collection/components/mds-kpi-item/antipattern.md +2 -4
  415. package/dist/collection/components/mds-kpi-item/documentation.json +16 -8
  416. package/dist/collection/components/mds-kpi-item/mds-kpi-item.js +2 -1
  417. package/dist/collection/components/mds-kpi-item/pattern.md +9 -7
  418. package/dist/collection/components/mds-label/AGENTS.md +3 -7
  419. package/dist/collection/components/mds-label/documentation.json +24 -11
  420. package/dist/collection/components/mds-label/mds-label.css +2 -2
  421. package/dist/collection/components/mds-label/mds-label.js +4 -1
  422. package/dist/collection/components/mds-label/pattern.md +1 -3
  423. package/dist/collection/components/mds-link/AGENTS.md +4 -9
  424. package/dist/collection/components/mds-link/documentation.json +22 -10
  425. package/dist/collection/components/mds-link/mds-link.css +1 -1
  426. package/dist/collection/components/mds-link/mds-link.js +4 -3
  427. package/dist/collection/components/mds-list/AGENTS.md +1 -1
  428. package/dist/collection/components/mds-list/documentation.json +6 -2
  429. package/dist/collection/components/mds-list/mds-list.js +2 -1
  430. package/dist/collection/components/mds-list/pattern.md +5 -5
  431. package/dist/collection/components/mds-list-item/AGENTS.md +2 -4
  432. package/dist/collection/components/mds-list-item/antipattern.md +1 -1
  433. package/dist/collection/components/mds-list-item/documentation.json +9 -4
  434. package/dist/collection/components/mds-list-item/mds-list-item.js +2 -1
  435. package/dist/collection/components/mds-list-item/pattern.md +4 -4
  436. package/dist/collection/components/mds-mention/AGENTS.md +2 -4
  437. package/dist/collection/components/mds-mention/antipattern.md +5 -5
  438. package/dist/collection/components/mds-mention/documentation.json +11 -5
  439. package/dist/collection/components/mds-mention/mds-mention.js +4 -1
  440. package/dist/collection/components/mds-mention/pattern.md +3 -5
  441. package/dist/collection/components/mds-modal/AGENTS.md +3 -9
  442. package/dist/collection/components/mds-modal/antipattern.md +1 -3
  443. package/dist/collection/components/mds-modal/documentation.json +37 -18
  444. package/dist/collection/components/mds-modal/mds-modal.css +7 -7
  445. package/dist/collection/components/mds-modal/mds-modal.js +4 -3
  446. package/dist/collection/components/mds-modal/pattern.md +2 -6
  447. package/dist/collection/components/mds-note/AGENTS.md +3 -5
  448. package/dist/collection/components/mds-note/documentation.json +18 -8
  449. package/dist/collection/components/mds-note/mds-note.css +2 -2
  450. package/dist/collection/components/mds-note/mds-note.js +2 -1
  451. package/dist/collection/components/mds-note/pattern.md +1 -3
  452. package/dist/collection/components/mds-notification/AGENTS.md +3 -11
  453. package/dist/collection/components/mds-notification/antipattern.md +2 -2
  454. package/dist/collection/components/mds-notification/documentation.json +33 -16
  455. package/dist/collection/components/mds-notification/mds-notification.css +2 -2
  456. package/dist/collection/components/mds-notification/mds-notification.js +4 -1
  457. package/dist/collection/components/mds-notification/pattern.md +3 -5
  458. package/dist/collection/components/mds-paginator/AGENTS.md +1 -1
  459. package/dist/collection/components/mds-paginator/documentation.json +12 -5
  460. package/dist/collection/components/mds-paginator/mds-paginator.css +2 -2
  461. package/dist/collection/components/mds-paginator/mds-paginator.js +4 -1
  462. package/dist/collection/components/mds-paginator/pattern.md +1 -3
  463. package/dist/collection/components/mds-paginator-item/AGENTS.md +3 -10
  464. package/dist/collection/components/mds-paginator-item/documentation.json +34 -16
  465. package/dist/collection/components/mds-paginator-item/mds-paginator-item.css +5 -5
  466. package/dist/collection/components/mds-paginator-item/mds-paginator-item.js +2 -1
  467. package/dist/collection/components/mds-paginator-item/pattern.md +5 -6
  468. package/dist/collection/components/mds-policy-ai/AGENTS.md +1 -1
  469. package/dist/collection/components/mds-policy-ai/documentation.json +6 -2
  470. package/dist/collection/components/mds-policy-ai/mds-policy-ai.js +2 -1
  471. package/dist/collection/components/mds-policy-ai/pattern.md +4 -4
  472. package/dist/collection/components/mds-pref/AGENTS.md +1 -1
  473. package/dist/collection/components/mds-pref/documentation.json +5 -5
  474. package/dist/collection/components/mds-pref/mds-pref.js +2 -2
  475. package/dist/collection/components/mds-pref-animation/AGENTS.md +1 -1
  476. package/dist/collection/components/mds-pref-animation/documentation.json +7 -2
  477. package/dist/collection/components/mds-pref-animation/mds-pref-animation.js +4 -1
  478. package/dist/collection/components/mds-pref-consumption/AGENTS.md +1 -1
  479. package/dist/collection/components/mds-pref-consumption/documentation.json +7 -2
  480. package/dist/collection/components/mds-pref-consumption/mds-pref-consumption.js +4 -1
  481. package/dist/collection/components/mds-pref-contrast/AGENTS.md +1 -1
  482. package/dist/collection/components/mds-pref-contrast/documentation.json +7 -2
  483. package/dist/collection/components/mds-pref-contrast/mds-pref-contrast.js +4 -1
  484. package/dist/collection/components/mds-pref-language/AGENTS.md +1 -1
  485. package/dist/collection/components/mds-pref-language/documentation.json +5 -1
  486. package/dist/collection/components/mds-pref-language/mds-pref-language.js +2 -1
  487. package/dist/collection/components/mds-pref-language-item/AGENTS.md +1 -1
  488. package/dist/collection/components/mds-pref-language-item/documentation.json +7 -2
  489. package/dist/collection/components/mds-pref-language-item/mds-pref-language-item.js +4 -1
  490. package/dist/collection/components/mds-pref-mode/AGENTS.md +3 -3
  491. package/dist/collection/components/mds-pref-mode/antipattern.md +1 -2
  492. package/dist/collection/components/mds-pref-mode/documentation.json +15 -7
  493. package/dist/collection/components/mds-pref-mode/mds-pref-mode.css +1 -1
  494. package/dist/collection/components/mds-pref-mode/mds-pref-mode.js +4 -1
  495. package/dist/collection/components/mds-pref-mode/pattern.md +1 -3
  496. package/dist/collection/components/mds-pref-theme/AGENTS.md +1 -1
  497. package/dist/collection/components/mds-pref-theme/documentation.json +6 -2
  498. package/dist/collection/components/mds-pref-theme/mds-pref-theme.js +2 -1
  499. package/dist/collection/components/mds-pref-theme/pattern.md +1 -2
  500. package/dist/collection/components/mds-pref-theme-item/AGENTS.md +3 -5
  501. package/dist/collection/components/mds-pref-theme-item/antipattern.md +1 -2
  502. package/dist/collection/components/mds-pref-theme-item/documentation.json +19 -9
  503. package/dist/collection/components/mds-pref-theme-item/mds-pref-theme-item.css +1 -1
  504. package/dist/collection/components/mds-pref-theme-item/mds-pref-theme-item.js +4 -1
  505. package/dist/collection/components/mds-pref-theme-item/pattern.md +2 -6
  506. package/dist/collection/components/mds-price-table/AGENTS.md +1 -1
  507. package/dist/collection/components/mds-price-table/documentation.json +6 -2
  508. package/dist/collection/components/mds-price-table/mds-price-table.js +2 -1
  509. package/dist/collection/components/mds-price-table/pattern.md +4 -4
  510. package/dist/collection/components/mds-price-table-features/AGENTS.md +4 -3
  511. package/dist/collection/components/mds-price-table-features/antipattern.md +0 -1
  512. package/dist/collection/components/mds-price-table-features/documentation.json +12 -6
  513. package/dist/collection/components/mds-price-table-features/mds-price-table-features.css +1 -1
  514. package/dist/collection/components/mds-price-table-features/mds-price-table-features.js +2 -1
  515. package/dist/collection/components/mds-price-table-features/pattern.md +2 -3
  516. package/dist/collection/components/mds-price-table-features-cell/AGENTS.md +3 -6
  517. package/dist/collection/components/mds-price-table-features-cell/antipattern.md +3 -3
  518. package/dist/collection/components/mds-price-table-features-cell/documentation.json +19 -9
  519. package/dist/collection/components/mds-price-table-features-cell/mds-price-table-features-cell.css +1 -1
  520. package/dist/collection/components/mds-price-table-features-cell/mds-price-table-features-cell.js +2 -1
  521. package/dist/collection/components/mds-price-table-features-cell/pattern.md +1 -6
  522. package/dist/collection/components/mds-price-table-features-row/AGENTS.md +3 -3
  523. package/dist/collection/components/mds-price-table-features-row/documentation.json +14 -6
  524. package/dist/collection/components/mds-price-table-features-row/mds-price-table-features-row.css +2 -2
  525. package/dist/collection/components/mds-price-table-features-row/mds-price-table-features-row.js +2 -1
  526. package/dist/collection/components/mds-price-table-features-row/pattern.md +1 -3
  527. package/dist/collection/components/mds-price-table-header/AGENTS.md +1 -1
  528. package/dist/collection/components/mds-price-table-header/documentation.json +5 -1
  529. package/dist/collection/components/mds-price-table-header/mds-price-table-header.js +2 -1
  530. package/dist/collection/components/mds-price-table-list/AGENTS.md +3 -5
  531. package/dist/collection/components/mds-price-table-list/antipattern.md +1 -4
  532. package/dist/collection/components/mds-price-table-list/documentation.json +10 -5
  533. package/dist/collection/components/mds-price-table-list/mds-price-table-list.js +2 -1
  534. package/dist/collection/components/mds-price-table-list/pattern.md +12 -7
  535. package/dist/collection/components/mds-price-table-list-item/AGENTS.md +2 -6
  536. package/dist/collection/components/mds-price-table-list-item/antipattern.md +1 -5
  537. package/dist/collection/components/mds-price-table-list-item/documentation.json +13 -6
  538. package/dist/collection/components/mds-price-table-list-item/mds-price-table-list-item.js +2 -1
  539. package/dist/collection/components/mds-price-table-list-item/pattern.md +7 -4
  540. package/dist/collection/components/mds-progress/AGENTS.md +1 -1
  541. package/dist/collection/components/mds-progress/documentation.json +15 -6
  542. package/dist/collection/components/mds-progress/mds-progress.css +5 -5
  543. package/dist/collection/components/mds-progress/mds-progress.js +2 -1
  544. package/dist/collection/components/mds-push-notification/AGENTS.md +4 -7
  545. package/dist/collection/components/mds-push-notification/antipattern.md +2 -2
  546. package/dist/collection/components/mds-push-notification/documentation.json +24 -12
  547. package/dist/collection/components/mds-push-notification/mds-push-notification.css +11 -11
  548. package/dist/collection/components/mds-push-notification/mds-push-notification.js +2 -1
  549. package/dist/collection/components/mds-push-notification/pattern.md +2 -5
  550. package/dist/collection/components/mds-push-notification-item/AGENTS.md +3 -5
  551. package/dist/collection/components/mds-push-notification-item/documentation.json +20 -9
  552. package/dist/collection/components/mds-push-notification-item/mds-push-notification-item.css +3 -3
  553. package/dist/collection/components/mds-push-notification-item/mds-push-notification-item.js +3 -2
  554. package/dist/collection/components/mds-push-notification-item/pattern.md +1 -3
  555. package/dist/collection/components/mds-quote/AGENTS.md +1 -1
  556. package/dist/collection/components/mds-quote/documentation.json +5 -1
  557. package/dist/collection/components/mds-quote/mds-quote.js +2 -1
  558. package/dist/collection/components/mds-radial-menu/AGENTS.md +4 -11
  559. package/dist/collection/components/mds-radial-menu/documentation.json +31 -15
  560. package/dist/collection/components/mds-radial-menu/mds-radial-menu.css +3 -3
  561. package/dist/collection/components/mds-radial-menu/mds-radial-menu.js +2 -1
  562. package/dist/collection/components/mds-radial-menu/pattern.md +2 -6
  563. package/dist/collection/components/mds-radial-menu-item/AGENTS.md +2 -5
  564. package/dist/collection/components/mds-radial-menu-item/antipattern.md +7 -5
  565. package/dist/collection/components/mds-radial-menu-item/documentation.json +13 -6
  566. package/dist/collection/components/mds-radial-menu-item/mds-radial-menu-item.js +4 -1
  567. package/dist/collection/components/mds-radial-menu-item/pattern.md +6 -8
  568. package/dist/collection/components/mds-radial-progress/AGENTS.md +3 -3
  569. package/dist/collection/components/mds-radial-progress/documentation.json +15 -6
  570. package/dist/collection/components/mds-radial-progress/mds-radial-progress.css +3 -3
  571. package/dist/collection/components/mds-radial-progress/mds-radial-progress.js +2 -1
  572. package/dist/collection/components/mds-separator/AGENTS.md +1 -1
  573. package/dist/collection/components/mds-separator/documentation.json +9 -3
  574. package/dist/collection/components/mds-separator/mds-separator.css +1 -1
  575. package/dist/collection/components/mds-separator/mds-separator.js +4 -1
  576. package/dist/collection/components/mds-spinner/AGENTS.md +1 -1
  577. package/dist/collection/components/mds-spinner/documentation.json +9 -3
  578. package/dist/collection/components/mds-spinner/mds-spinner.css +1 -1
  579. package/dist/collection/components/mds-spinner/mds-spinner.js +4 -1
  580. package/dist/collection/components/mds-status-bar/AGENTS.md +3 -3
  581. package/dist/collection/components/mds-status-bar/antipattern.md +0 -1
  582. package/dist/collection/components/mds-status-bar/documentation.json +13 -6
  583. package/dist/collection/components/mds-status-bar/mds-status-bar.css +1 -1
  584. package/dist/collection/components/mds-status-bar/mds-status-bar.js +2 -1
  585. package/dist/collection/components/mds-status-bar/pattern.md +1 -3
  586. package/dist/collection/components/mds-stepper-bar/AGENTS.md +3 -7
  587. package/dist/collection/components/mds-stepper-bar/documentation.json +22 -10
  588. package/dist/collection/components/mds-stepper-bar/mds-stepper-bar.css +2 -2
  589. package/dist/collection/components/mds-stepper-bar/mds-stepper-bar.js +2 -1
  590. package/dist/collection/components/mds-stepper-bar/pattern.md +2 -6
  591. package/dist/collection/components/mds-stepper-bar-item/AGENTS.md +3 -11
  592. package/dist/collection/components/mds-stepper-bar-item/antipattern.md +3 -3
  593. package/dist/collection/components/mds-stepper-bar-item/documentation.json +31 -15
  594. package/dist/collection/components/mds-stepper-bar-item/mds-stepper-bar-item.css +2 -2
  595. package/dist/collection/components/mds-stepper-bar-item/mds-stepper-bar-item.js +2 -1
  596. package/dist/collection/components/mds-stepper-bar-item/pattern.md +2 -5
  597. package/dist/collection/components/mds-tab/AGENTS.md +3 -27
  598. package/dist/collection/components/mds-tab/antipattern.md +1 -3
  599. package/dist/collection/components/mds-tab/documentation.json +67 -33
  600. package/dist/collection/components/mds-tab/mds-tab.css +5 -5
  601. package/dist/collection/components/mds-tab/mds-tab.js +3 -2
  602. package/dist/collection/components/mds-tab/pattern.md +3 -13
  603. package/dist/collection/components/mds-tab-bar/AGENTS.md +1 -1
  604. package/dist/collection/components/mds-tab-bar/antipattern.md +2 -2
  605. package/dist/collection/components/mds-tab-bar/documentation.json +7 -3
  606. package/dist/collection/components/mds-tab-bar/mds-tab-bar.js +2 -1
  607. package/dist/collection/components/mds-tab-bar/pattern.md +3 -3
  608. package/dist/collection/components/mds-tab-bar-item/AGENTS.md +4 -4
  609. package/dist/collection/components/mds-tab-bar-item/documentation.json +15 -7
  610. package/dist/collection/components/mds-tab-bar-item/mds-tab-bar-item.css +2 -2
  611. package/dist/collection/components/mds-tab-bar-item/mds-tab-bar-item.js +2 -1
  612. package/dist/collection/components/mds-tab-bar-item/pattern.md +1 -3
  613. package/dist/collection/components/mds-tab-item/AGENTS.md +2 -8
  614. package/dist/collection/components/mds-tab-item/antipattern.md +3 -3
  615. package/dist/collection/components/mds-tab-item/documentation.json +17 -8
  616. package/dist/collection/components/mds-tab-item/mds-tab-item.js +2 -1
  617. package/dist/collection/components/mds-tab-item/pattern.md +6 -5
  618. package/dist/collection/components/mds-table/AGENTS.md +3 -7
  619. package/dist/collection/components/mds-table/documentation.json +24 -11
  620. package/dist/collection/components/mds-table/mds-table.css +3 -3
  621. package/dist/collection/components/mds-table/mds-table.js +2 -1
  622. package/dist/collection/components/mds-table/pattern.md +2 -6
  623. package/dist/collection/components/mds-table-body/AGENTS.md +3 -4
  624. package/dist/collection/components/mds-table-body/antipattern.md +1 -2
  625. package/dist/collection/components/mds-table-body/documentation.json +17 -8
  626. package/dist/collection/components/mds-table-body/mds-table-body.css +2 -2
  627. package/dist/collection/components/mds-table-body/mds-table-body.js +2 -1
  628. package/dist/collection/components/mds-table-body/pattern.md +1 -4
  629. package/dist/collection/components/mds-table-cell/AGENTS.md +4 -4
  630. package/dist/collection/components/mds-table-cell/antipattern.md +1 -1
  631. package/dist/collection/components/mds-table-cell/documentation.json +16 -8
  632. package/dist/collection/components/mds-table-cell/mds-table-cell.css +2 -2
  633. package/dist/collection/components/mds-table-cell/mds-table-cell.js +2 -1
  634. package/dist/collection/components/mds-table-cell/pattern.md +1 -7
  635. package/dist/collection/components/mds-table-footer/AGENTS.md +1 -1
  636. package/dist/collection/components/mds-table-footer/antipattern.md +2 -2
  637. package/dist/collection/components/mds-table-footer/documentation.json +7 -3
  638. package/dist/collection/components/mds-table-footer/mds-table-footer.js +2 -1
  639. package/dist/collection/components/mds-table-footer/pattern.md +2 -4
  640. package/dist/collection/components/mds-table-header/AGENTS.md +1 -1
  641. package/dist/collection/components/mds-table-header/documentation.json +5 -1
  642. package/dist/collection/components/mds-table-header/mds-table-header.js +2 -1
  643. package/dist/collection/components/mds-table-header-cell/AGENTS.md +1 -1
  644. package/dist/collection/components/mds-table-header-cell/documentation.json +5 -1
  645. package/dist/collection/components/mds-table-header-cell/mds-table-header-cell.js +2 -1
  646. package/dist/collection/components/mds-table-row/AGENTS.md +2 -8
  647. package/dist/collection/components/mds-table-row/antipattern.md +4 -5
  648. package/dist/collection/components/mds-table-row/documentation.json +17 -8
  649. package/dist/collection/components/mds-table-row/mds-table-row.js +4 -3
  650. package/dist/collection/components/mds-table-row/pattern.md +5 -8
  651. package/dist/collection/components/mds-text/AGENTS.md +3 -3
  652. package/dist/collection/components/mds-text/antipattern.md +1 -2
  653. package/dist/collection/components/mds-text/documentation.json +17 -8
  654. package/dist/collection/components/mds-text/mds-text.css +3 -3
  655. package/dist/collection/components/mds-text/mds-text.js +2 -1
  656. package/dist/collection/components/mds-text/pattern.md +0 -11
  657. package/dist/collection/components/mds-toast/AGENTS.md +3 -3
  658. package/dist/collection/components/mds-toast/antipattern.md +2 -2
  659. package/dist/collection/components/mds-toast/documentation.json +19 -9
  660. package/dist/collection/components/mds-toast/mds-toast.css +4 -4
  661. package/dist/collection/components/mds-toast/mds-toast.js +2 -1
  662. package/dist/collection/components/mds-toast/pattern.md +2 -3
  663. package/dist/collection/components/mds-toast-region/AGENTS.md +1 -1
  664. package/dist/collection/components/mds-toast-region/documentation.json +7 -2
  665. package/dist/collection/components/mds-toast-region/mds-toast-region.css +1 -1
  666. package/dist/collection/components/mds-toast-region/mds-toast-region.js +2 -1
  667. package/dist/collection/components/mds-tooltip/AGENTS.md +3 -8
  668. package/dist/collection/components/mds-tooltip/antipattern.md +1 -1
  669. package/dist/collection/components/mds-tooltip/documentation.json +27 -13
  670. package/dist/collection/components/mds-tooltip/mds-tooltip.css +5 -5
  671. package/dist/collection/components/mds-tooltip/mds-tooltip.js +2 -1
  672. package/dist/collection/components/mds-tooltip/pattern.md +1 -3
  673. package/dist/collection/components/mds-tree/AGENTS.md +3 -28
  674. package/dist/collection/components/mds-tree/antipattern.md +3 -4
  675. package/dist/collection/components/mds-tree/documentation.json +63 -31
  676. package/dist/collection/components/mds-tree/mds-tree.css +1 -1
  677. package/dist/collection/components/mds-tree/mds-tree.js +2 -1
  678. package/dist/collection/components/mds-tree/pattern.md +3 -9
  679. package/dist/collection/components/mds-tree-item/AGENTS.md +2 -33
  680. package/dist/collection/components/mds-tree-item/antipattern.md +1 -5
  681. package/dist/collection/components/mds-tree-item/documentation.json +67 -33
  682. package/dist/collection/components/mds-tree-item/mds-tree-item.js +2 -1
  683. package/dist/collection/components/mds-tree-item/pattern.md +5 -10
  684. package/dist/collection/components/mds-url-view/AGENTS.md +3 -2
  685. package/dist/collection/components/mds-url-view/antipattern.md +1 -2
  686. package/dist/collection/components/mds-url-view/documentation.json +19 -9
  687. package/dist/collection/components/mds-url-view/mds-url-view.css +4 -4
  688. package/dist/collection/components/mds-url-view/mds-url-view.js +4 -1
  689. package/dist/collection/components/mds-url-view/pattern.md +1 -2
  690. package/dist/collection/components/mds-usage/AGENTS.md +2 -6
  691. package/dist/collection/components/mds-usage/antipattern.md +6 -4
  692. package/dist/collection/components/mds-usage/documentation.json +13 -6
  693. package/dist/collection/components/mds-usage/mds-usage.js +2 -1
  694. package/dist/collection/components/mds-usage/pattern.md +10 -6
  695. package/dist/collection/components/mds-video-wall/AGENTS.md +3 -4
  696. package/dist/collection/components/mds-video-wall/antipattern.md +5 -5
  697. package/dist/collection/components/mds-video-wall/documentation.json +15 -7
  698. package/dist/collection/components/mds-video-wall/mds-video-wall.css +1 -1
  699. package/dist/collection/components/mds-video-wall/mds-video-wall.js +2 -1
  700. package/dist/collection/components/mds-video-wall/pattern.md +2 -4
  701. package/dist/collection/components/mds-zero/AGENTS.md +1 -1
  702. package/dist/collection/components/mds-zero/antipattern.md +6 -6
  703. package/dist/collection/components/mds-zero/documentation.json +9 -4
  704. package/dist/collection/components/mds-zero/mds-zero.css +1 -1
  705. package/dist/collection/components/mds-zero/mds-zero.js +2 -1
  706. package/dist/collection/components/mds-zero/pattern.md +3 -3
  707. package/dist/components/index.d.ts +2 -0
  708. package/dist/components/index.js +1 -1
  709. package/dist/components/mds-accordion-item.js +1 -1
  710. package/dist/components/mds-accordion-timer-item.js +1 -1
  711. package/dist/components/mds-accordion-timer.js +1 -1
  712. package/dist/components/mds-accordion.js +1 -1
  713. package/dist/components/mds-author.js +1 -1
  714. package/dist/components/mds-avatar-stack-item.js +1 -1
  715. package/dist/components/mds-avatar-stack.js +1 -1
  716. package/dist/components/mds-avatar.js +1 -1
  717. package/dist/components/mds-badge.js +1 -1
  718. package/dist/components/mds-banner.js +1 -1
  719. package/dist/components/mds-benchmark-bar.js +1 -1
  720. package/dist/components/mds-bibliography.js +1 -1
  721. package/dist/components/mds-book.d.ts +11 -0
  722. package/dist/components/mds-book.js +1 -0
  723. package/dist/components/mds-breadcrumb-item.js +1 -1
  724. package/dist/components/mds-breadcrumb.js +1 -1
  725. package/dist/components/mds-button-dropdown.js +1 -1
  726. package/dist/components/mds-button-group.js +1 -1
  727. package/dist/components/mds-button.js +1 -1
  728. package/dist/components/mds-calendar-cell.js +1 -1
  729. package/dist/components/mds-calendar.js +1 -1
  730. package/dist/components/mds-card-content.js +1 -1
  731. package/dist/components/mds-card-footer.js +1 -1
  732. package/dist/components/mds-card-header.js +1 -1
  733. package/dist/components/mds-card-media.js +1 -1
  734. package/dist/components/mds-card.js +1 -1
  735. package/dist/components/mds-chip.js +1 -1
  736. package/dist/components/mds-details.js +1 -1
  737. package/dist/components/mds-dropdown.js +1 -1
  738. package/dist/components/mds-emoji.js +2 -2
  739. package/dist/components/mds-entity.js +1 -1
  740. package/dist/components/mds-file-preview.js +1 -1
  741. package/dist/components/mds-file.js +1 -1
  742. package/dist/components/mds-filter-item.js +1 -1
  743. package/dist/components/mds-filter.js +1 -1
  744. package/dist/components/mds-header-bar.js +1 -1
  745. package/dist/components/mds-header.js +1 -1
  746. package/dist/components/mds-help.js +1 -1
  747. package/dist/components/mds-horizontal-scroll.js +1 -1
  748. package/dist/components/mds-hr.js +1 -1
  749. package/dist/components/mds-icon.js +1 -1
  750. package/dist/components/mds-img.js +1 -1
  751. package/dist/components/mds-input-date-range-preselection.js +1 -1
  752. package/dist/components/mds-input-date-range.js +1 -1
  753. package/dist/components/mds-input-date.js +1 -1
  754. package/dist/components/mds-input-field.js +1 -1
  755. package/dist/components/mds-input-otp.js +1 -1
  756. package/dist/components/mds-input-range.js +1 -1
  757. package/dist/components/mds-input-select.js +1 -1
  758. package/dist/components/mds-input-switch.js +1 -1
  759. package/dist/components/mds-input-tip-item.js +1 -1
  760. package/dist/components/mds-input-tip.js +1 -1
  761. package/dist/components/mds-input-upload.js +1 -1
  762. package/dist/components/mds-input.js +1 -1
  763. package/dist/components/mds-keyboard-key.js +1 -1
  764. package/dist/components/mds-keyboard.js +1 -1
  765. package/dist/components/mds-kpi-item.js +1 -1
  766. package/dist/components/mds-kpi.js +1 -1
  767. package/dist/components/mds-label.js +1 -1
  768. package/dist/components/mds-link.js +1 -1
  769. package/dist/components/mds-list-item.js +1 -1
  770. package/dist/components/mds-list.js +1 -1
  771. package/dist/components/mds-mention.js +1 -1
  772. package/dist/components/mds-modal.js +1 -1
  773. package/dist/components/mds-note.js +1 -1
  774. package/dist/components/mds-notification.js +1 -1
  775. package/dist/components/mds-paginator-item.js +1 -1
  776. package/dist/components/mds-paginator.js +1 -1
  777. package/dist/components/mds-policy-ai.js +1 -1
  778. package/dist/components/mds-pref-animation.js +1 -1
  779. package/dist/components/mds-pref-consumption.js +1 -1
  780. package/dist/components/mds-pref-contrast.js +1 -1
  781. package/dist/components/mds-pref-language-item.js +1 -1
  782. package/dist/components/mds-pref-language.js +1 -1
  783. package/dist/components/mds-pref-mode.js +1 -1
  784. package/dist/components/mds-pref-theme-item.js +1 -1
  785. package/dist/components/mds-pref-theme.js +1 -1
  786. package/dist/components/mds-pref.js +1 -1
  787. package/dist/components/mds-price-table-features-cell.js +1 -1
  788. package/dist/components/mds-price-table-features-row.js +1 -1
  789. package/dist/components/mds-price-table-features.js +1 -1
  790. package/dist/components/mds-price-table-header.js +1 -1
  791. package/dist/components/mds-price-table-list-item.js +1 -1
  792. package/dist/components/mds-price-table-list.js +1 -1
  793. package/dist/components/mds-price-table.js +1 -1
  794. package/dist/components/mds-progress.js +1 -1
  795. package/dist/components/mds-push-notification-item.js +1 -1
  796. package/dist/components/mds-push-notification.js +1 -1
  797. package/dist/components/mds-quote.js +1 -1
  798. package/dist/components/mds-radial-menu-item.js +1 -1
  799. package/dist/components/mds-radial-menu.js +1 -1
  800. package/dist/components/mds-radial-progress.js +1 -1
  801. package/dist/components/mds-separator.js +1 -1
  802. package/dist/components/mds-spinner.js +1 -1
  803. package/dist/components/mds-status-bar.js +1 -1
  804. package/dist/components/mds-stepper-bar-item.js +1 -1
  805. package/dist/components/mds-stepper-bar.js +1 -1
  806. package/dist/components/mds-tab-bar-item.js +1 -1
  807. package/dist/components/mds-tab-bar.js +1 -1
  808. package/dist/components/mds-tab-item.js +1 -1
  809. package/dist/components/mds-tab.js +1 -1
  810. package/dist/components/mds-table-body.js +1 -1
  811. package/dist/components/mds-table-cell.js +1 -1
  812. package/dist/components/mds-table-footer.js +1 -1
  813. package/dist/components/mds-table-header-cell.js +1 -1
  814. package/dist/components/mds-table-header.js +1 -1
  815. package/dist/components/mds-table-row.js +1 -1
  816. package/dist/components/mds-table.js +1 -1
  817. package/dist/components/mds-text.js +1 -1
  818. package/dist/components/mds-toast-region.js +1 -1
  819. package/dist/components/mds-toast.js +1 -1
  820. package/dist/components/mds-tooltip.js +1 -1
  821. package/dist/components/mds-tree-item.js +1 -1
  822. package/dist/components/mds-tree.js +1 -1
  823. package/dist/components/mds-url-view.js +1 -1
  824. package/dist/components/mds-usage.js +1 -1
  825. package/dist/components/mds-video-wall.js +1 -1
  826. package/dist/components/mds-zero.js +1 -1
  827. package/dist/components/p-B8hgyXdE.js +1 -0
  828. package/dist/components/{p-DkUdrGHq.js → p-BBO_llcO.js} +1 -1
  829. package/dist/components/{p-D0A8gS-P.js → p-BM7joOdq.js} +1 -1
  830. package/dist/components/{p-DNeEn8Rr.js → p-BMIaZ4HY.js} +1 -1
  831. package/dist/components/{p-BwJQB6rG.js → p-BOJQ3tkp.js} +1 -1
  832. package/dist/components/{p-CJYY4da7.js → p-BU1O2DcC.js} +1 -1
  833. package/dist/components/{p-CaROqeeK.js → p-Bo6ezD1p.js} +1 -1
  834. package/dist/components/p-C0H8bZpf.js +1 -0
  835. package/dist/components/{p-s1CktmPS.js → p-C1YH20BL.js} +1 -1
  836. package/dist/components/{p-Cmn1DJAB.js → p-CEw7GvM-.js} +1 -1
  837. package/dist/components/{p-D-DdDIb9.js → p-CNUWS_Mg.js} +1 -1
  838. package/dist/components/{p-DucY18_e.js → p-CNpL55c-.js} +1 -1
  839. package/dist/components/{p-DnySYX0L.js → p-CV7wjM1c.js} +1 -1
  840. package/dist/components/{p-BU3bsIX2.js → p-CWSIl1jl.js} +1 -1
  841. package/dist/components/{p-DFD4E9zJ.js → p-CYK2Xr_v.js} +1 -1
  842. package/dist/components/p-Czqtt8kO.js +1 -0
  843. package/dist/components/{p-Dm-OUwDe.js → p-DD2muCqG.js} +1 -1
  844. package/dist/components/{p-ZuubAcA3.js → p-DDTJwlAd.js} +1 -1
  845. package/dist/components/{p-5lLueiFt.js → p-DJ401QTd.js} +1 -1
  846. package/dist/components/{p-BbK4qeM7.js → p-DMyL4CYh.js} +1 -1
  847. package/dist/components/{p-Cu5nEwMu.js → p-DbVGGhs_.js} +1 -1
  848. package/dist/components/{p-C4XdTZQ-.js → p-DccBbfK8.js} +1 -1
  849. package/dist/components/{p-BbgQG1UL.js → p-H0YXZ5fD.js} +2 -2
  850. package/dist/components/{p-yNPPTJ7i.js → p-IaXq1Xsc.js} +1 -1
  851. package/dist/components/{p-ClPv-Ljc.js → p-M8dGB4KH.js} +1 -1
  852. package/dist/components/{p-CPvuXO7s.js → p-TNn_HE5x.js} +1 -1
  853. package/dist/components/{p-CNF3u0Li.js → p-aujz-VM9.js} +1 -1
  854. package/dist/components/{p-CSxW5f2f.js → p-e9NGNm7d.js} +1 -1
  855. package/dist/components/{p-DkYDXDkD.js → p-kZBPId_x.js} +1 -1
  856. package/dist/components/{p-BO-jHv-F.js → p-qnCVkeGX.js} +1 -1
  857. package/dist/documentation.json +2613 -918
  858. package/dist/esm/index-CvLLN-QH.js +4 -0
  859. package/dist/esm/loader.js +1 -1
  860. package/dist/esm/magma-components.js +1 -1
  861. package/dist/esm/mds-accordion-item.entry.js +1 -1
  862. package/dist/esm/mds-accordion-timer-item.entry.js +1 -1
  863. package/dist/esm/mds-accordion-timer.entry.js +1 -1
  864. package/dist/esm/mds-accordion.entry.js +1 -1
  865. package/dist/esm/mds-author.entry.js +1 -1
  866. package/dist/esm/mds-avatar-stack-item.entry.js +1 -1
  867. package/dist/esm/mds-avatar-stack.entry.js +1 -1
  868. package/dist/esm/mds-avatar.entry.js +1 -1
  869. package/dist/esm/mds-badge.entry.js +1 -1
  870. package/dist/esm/mds-banner_3.entry.js +3 -3
  871. package/dist/esm/mds-benchmark-bar.entry.js +1 -1
  872. package/dist/esm/mds-bibliography.entry.js +1 -1
  873. package/dist/esm/mds-book.entry.js +701 -0
  874. package/dist/esm/mds-breadcrumb-item.entry.js +1 -1
  875. package/dist/esm/mds-breadcrumb.entry.js +1 -1
  876. package/dist/esm/mds-button-dropdown.entry.js +1 -1
  877. package/dist/esm/mds-button-group.entry.js +1 -1
  878. package/dist/esm/mds-button_3.entry.js +6 -6
  879. package/dist/esm/mds-calendar_2.entry.js +6 -6
  880. package/dist/esm/mds-card-content.entry.js +1 -1
  881. package/dist/esm/mds-card-footer.entry.js +1 -1
  882. package/dist/esm/mds-card-header.entry.js +1 -1
  883. package/dist/esm/mds-card-media.entry.js +1 -1
  884. package/dist/esm/mds-card.entry.js +1 -1
  885. package/dist/esm/mds-details.entry.js +1 -1
  886. package/dist/esm/mds-dropdown.entry.js +2 -2
  887. package/dist/esm/mds-emoji.entry.js +1 -1
  888. package/dist/esm/mds-entity.entry.js +1 -1
  889. package/dist/esm/mds-file-preview.entry.js +2 -2
  890. package/dist/esm/mds-file.entry.js +1 -1
  891. package/dist/esm/mds-filter-item.entry.js +1 -1
  892. package/dist/esm/mds-filter.entry.js +1 -1
  893. package/dist/esm/mds-header-bar.entry.js +1 -1
  894. package/dist/esm/mds-header.entry.js +2 -2
  895. package/dist/esm/mds-horizontal-scroll.entry.js +1 -1
  896. package/dist/esm/mds-hr.entry.js +1 -1
  897. package/dist/esm/mds-input-date-range-preselection.entry.js +1 -1
  898. package/dist/esm/mds-input-date-range.entry.js +2 -2
  899. package/dist/esm/mds-input-date.entry.js +2 -2
  900. package/dist/esm/mds-input-field.entry.js +1 -1
  901. package/dist/esm/mds-input-otp.entry.js +1 -1
  902. package/dist/esm/mds-input-range.entry.js +1 -1
  903. package/dist/esm/mds-input-select.entry.js +2 -2
  904. package/dist/esm/mds-input-switch_2.entry.js +2 -2
  905. package/dist/esm/mds-input-tip_2.entry.js +3 -3
  906. package/dist/esm/mds-input-upload.entry.js +5 -5
  907. package/dist/esm/mds-input.entry.js +2 -2
  908. package/dist/esm/mds-keyboard-key.entry.js +2 -2
  909. package/dist/esm/mds-keyboard.entry.js +2 -2
  910. package/dist/esm/mds-kpi-item.entry.js +1 -1
  911. package/dist/esm/mds-kpi.entry.js +1 -1
  912. package/dist/esm/mds-label.entry.js +1 -1
  913. package/dist/esm/mds-link.entry.js +3 -3
  914. package/dist/esm/mds-list-item.entry.js +1 -1
  915. package/dist/esm/mds-list.entry.js +1 -1
  916. package/dist/esm/mds-mention.entry.js +1 -1
  917. package/dist/esm/mds-modal.entry.js +3 -3
  918. package/dist/esm/mds-note.entry.js +1 -1
  919. package/dist/esm/mds-notification.entry.js +1 -1
  920. package/dist/esm/mds-paginator-item.entry.js +1 -1
  921. package/dist/esm/mds-paginator.entry.js +1 -1
  922. package/dist/esm/mds-policy-ai.entry.js +1 -1
  923. package/dist/esm/mds-pref-animation.entry.js +1 -1
  924. package/dist/esm/mds-pref-consumption.entry.js +1 -1
  925. package/dist/esm/mds-pref-contrast.entry.js +1 -1
  926. package/dist/esm/mds-pref-language-item.entry.js +1 -1
  927. package/dist/esm/mds-pref-language.entry.js +1 -1
  928. package/dist/esm/mds-pref-mode.entry.js +1 -1
  929. package/dist/esm/mds-pref-theme-item.entry.js +1 -1
  930. package/dist/esm/mds-pref-theme.entry.js +1 -1
  931. package/dist/esm/mds-pref.entry.js +1 -1
  932. package/dist/esm/mds-price-table-features-cell.entry.js +1 -1
  933. package/dist/esm/mds-price-table-features-row.entry.js +1 -1
  934. package/dist/esm/mds-price-table-features.entry.js +1 -1
  935. package/dist/esm/mds-price-table-header.entry.js +1 -1
  936. package/dist/esm/mds-price-table-list-item.entry.js +1 -1
  937. package/dist/esm/mds-price-table-list.entry.js +1 -1
  938. package/dist/esm/mds-price-table.entry.js +1 -1
  939. package/dist/esm/mds-progress_2.entry.js +2 -2
  940. package/dist/esm/mds-push-notification-item.entry.js +2 -2
  941. package/dist/esm/mds-push-notification.entry.js +2 -2
  942. package/dist/esm/mds-quote.entry.js +1 -1
  943. package/dist/esm/mds-radial-menu-item.entry.js +1 -1
  944. package/dist/esm/mds-radial-menu.entry.js +1 -1
  945. package/dist/esm/mds-separator.entry.js +1 -1
  946. package/dist/esm/mds-status-bar.entry.js +1 -1
  947. package/dist/esm/mds-stepper-bar-item.entry.js +1 -1
  948. package/dist/esm/mds-stepper-bar.entry.js +1 -1
  949. package/dist/esm/mds-tab-bar-item.entry.js +1 -1
  950. package/dist/esm/mds-tab-bar.entry.js +1 -1
  951. package/dist/esm/mds-tab_2.entry.js +4 -4
  952. package/dist/esm/mds-table-body.entry.js +1 -1
  953. package/dist/esm/mds-table-footer.entry.js +1 -1
  954. package/dist/esm/mds-table-header-cell.entry.js +1 -1
  955. package/dist/esm/mds-table-header.entry.js +1 -1
  956. package/dist/esm/mds-table-row.entry.js +2 -2
  957. package/dist/esm/mds-table.entry.js +1 -1
  958. package/dist/esm/mds-text.entry.js +1 -1
  959. package/dist/esm/mds-toast-region.entry.js +1 -1
  960. package/dist/esm/mds-toast.entry.js +1 -1
  961. package/dist/esm/mds-tooltip.entry.js +2 -2
  962. package/dist/esm/mds-tree-item.entry.js +1 -1
  963. package/dist/esm/mds-tree.entry.js +1 -1
  964. package/dist/esm/mds-url-view.entry.js +1 -1
  965. package/dist/esm/mds-usage.entry.js +1 -1
  966. package/dist/esm/mds-video-wall.entry.js +1 -1
  967. package/dist/esm/mds-zero.entry.js +1 -1
  968. package/dist/esm-es5/index-CvLLN-QH.js +8 -6
  969. package/dist/esm-es5/loader.js +1 -1
  970. package/dist/esm-es5/magma-components.js +2 -2
  971. package/dist/esm-es5/mds-accordion-item.entry.js +1 -1
  972. package/dist/esm-es5/mds-accordion-timer-item.entry.js +1 -1
  973. package/dist/esm-es5/mds-accordion-timer.entry.js +1 -1
  974. package/dist/esm-es5/mds-accordion.entry.js +2 -2
  975. package/dist/esm-es5/mds-author.entry.js +1 -1
  976. package/dist/esm-es5/mds-avatar-stack-item.entry.js +1 -1
  977. package/dist/esm-es5/mds-avatar-stack.entry.js +1 -1
  978. package/dist/esm-es5/mds-avatar.entry.js +5 -5
  979. package/dist/esm-es5/mds-badge.entry.js +1 -1
  980. package/dist/esm-es5/mds-banner_3.entry.js +3 -3
  981. package/dist/esm-es5/mds-benchmark-bar.entry.js +3 -3
  982. package/dist/esm-es5/mds-bibliography.entry.js +2 -2
  983. package/dist/esm-es5/mds-book.entry.js +207 -0
  984. package/dist/esm-es5/mds-breadcrumb-item.entry.js +1 -1
  985. package/dist/esm-es5/mds-breadcrumb.entry.js +4 -4
  986. package/dist/esm-es5/mds-button-dropdown.entry.js +1 -1
  987. package/dist/esm-es5/mds-button-group.entry.js +1 -1
  988. package/dist/esm-es5/mds-button_3.entry.js +5 -5
  989. package/dist/esm-es5/mds-calendar_2.entry.js +3 -3
  990. package/dist/esm-es5/mds-card-content.entry.js +1 -1
  991. package/dist/esm-es5/mds-card-footer.entry.js +1 -1
  992. package/dist/esm-es5/mds-card-header.entry.js +1 -1
  993. package/dist/esm-es5/mds-card-media.entry.js +1 -1
  994. package/dist/esm-es5/mds-card.entry.js +1 -1
  995. package/dist/esm-es5/mds-details.entry.js +1 -1
  996. package/dist/esm-es5/mds-dropdown.entry.js +1 -1
  997. package/dist/esm-es5/mds-emoji.entry.js +1 -1
  998. package/dist/esm-es5/mds-entity.entry.js +1 -1
  999. package/dist/esm-es5/mds-file-preview.entry.js +3 -3
  1000. package/dist/esm-es5/mds-file.entry.js +1 -1
  1001. package/dist/esm-es5/mds-filter-item.entry.js +1 -1
  1002. package/dist/esm-es5/mds-filter.entry.js +1 -1
  1003. package/dist/esm-es5/mds-header-bar.entry.js +1 -1
  1004. package/dist/esm-es5/mds-header.entry.js +2 -2
  1005. package/dist/esm-es5/mds-horizontal-scroll.entry.js +1 -1
  1006. package/dist/esm-es5/mds-hr.entry.js +1 -1
  1007. package/dist/esm-es5/mds-input-date-range-preselection.entry.js +1 -1
  1008. package/dist/esm-es5/mds-input-date-range.entry.js +2 -2
  1009. package/dist/esm-es5/mds-input-date.entry.js +2 -2
  1010. package/dist/esm-es5/mds-input-field.entry.js +1 -1
  1011. package/dist/esm-es5/mds-input-otp.entry.js +1 -1
  1012. package/dist/esm-es5/mds-input-range.entry.js +1 -1
  1013. package/dist/esm-es5/mds-input-select.entry.js +1 -1
  1014. package/dist/esm-es5/mds-input-switch_2.entry.js +1 -1
  1015. package/dist/esm-es5/mds-input-tip_2.entry.js +2 -2
  1016. package/dist/esm-es5/mds-input-upload.entry.js +1 -1
  1017. package/dist/esm-es5/mds-input.entry.js +1 -1
  1018. package/dist/esm-es5/mds-keyboard-key.entry.js +2 -2
  1019. package/dist/esm-es5/mds-keyboard.entry.js +2 -2
  1020. package/dist/esm-es5/mds-kpi-item.entry.js +3 -3
  1021. package/dist/esm-es5/mds-kpi.entry.js +1 -1
  1022. package/dist/esm-es5/mds-label.entry.js +1 -1
  1023. package/dist/esm-es5/mds-link.entry.js +1 -1
  1024. package/dist/esm-es5/mds-list-item.entry.js +1 -1
  1025. package/dist/esm-es5/mds-list.entry.js +1 -1
  1026. package/dist/esm-es5/mds-mention.entry.js +2 -2
  1027. package/dist/esm-es5/mds-modal.entry.js +1 -1
  1028. package/dist/esm-es5/mds-note.entry.js +1 -1
  1029. package/dist/esm-es5/mds-notification.entry.js +1 -1
  1030. package/dist/esm-es5/mds-paginator-item.entry.js +1 -1
  1031. package/dist/esm-es5/mds-paginator.entry.js +3 -3
  1032. package/dist/esm-es5/mds-policy-ai.entry.js +1 -1
  1033. package/dist/esm-es5/mds-pref-animation.entry.js +1 -1
  1034. package/dist/esm-es5/mds-pref-consumption.entry.js +1 -1
  1035. package/dist/esm-es5/mds-pref-contrast.entry.js +1 -1
  1036. package/dist/esm-es5/mds-pref-language-item.entry.js +1 -1
  1037. package/dist/esm-es5/mds-pref-language.entry.js +1 -1
  1038. package/dist/esm-es5/mds-pref-mode.entry.js +1 -1
  1039. package/dist/esm-es5/mds-pref-theme-item.entry.js +3 -3
  1040. package/dist/esm-es5/mds-pref-theme.entry.js +6 -6
  1041. package/dist/esm-es5/mds-pref.entry.js +1 -1
  1042. package/dist/esm-es5/mds-price-table-features-cell.entry.js +1 -1
  1043. package/dist/esm-es5/mds-price-table-features-row.entry.js +1 -1
  1044. package/dist/esm-es5/mds-price-table-features.entry.js +1 -1
  1045. package/dist/esm-es5/mds-price-table-header.entry.js +1 -1
  1046. package/dist/esm-es5/mds-price-table-list-item.entry.js +1 -1
  1047. package/dist/esm-es5/mds-price-table-list.entry.js +1 -1
  1048. package/dist/esm-es5/mds-price-table.entry.js +1 -1
  1049. package/dist/esm-es5/mds-progress_2.entry.js +2 -2
  1050. package/dist/esm-es5/mds-push-notification-item.entry.js +2 -2
  1051. package/dist/esm-es5/mds-push-notification.entry.js +2 -2
  1052. package/dist/esm-es5/mds-quote.entry.js +1 -1
  1053. package/dist/esm-es5/mds-radial-menu-item.entry.js +1 -1
  1054. package/dist/esm-es5/mds-radial-menu.entry.js +1 -1
  1055. package/dist/esm-es5/mds-separator.entry.js +1 -1
  1056. package/dist/esm-es5/mds-status-bar.entry.js +1 -1
  1057. package/dist/esm-es5/mds-stepper-bar-item.entry.js +1 -1
  1058. package/dist/esm-es5/mds-stepper-bar.entry.js +1 -1
  1059. package/dist/esm-es5/mds-tab-bar-item.entry.js +1 -1
  1060. package/dist/esm-es5/mds-tab-bar.entry.js +1 -1
  1061. package/dist/esm-es5/mds-tab_2.entry.js +3 -3
  1062. package/dist/esm-es5/mds-table-body.entry.js +1 -1
  1063. package/dist/esm-es5/mds-table-footer.entry.js +1 -1
  1064. package/dist/esm-es5/mds-table-header-cell.entry.js +1 -1
  1065. package/dist/esm-es5/mds-table-header.entry.js +4 -4
  1066. package/dist/esm-es5/mds-table-row.entry.js +1 -1
  1067. package/dist/esm-es5/mds-table.entry.js +2 -2
  1068. package/dist/esm-es5/mds-text.entry.js +1 -1
  1069. package/dist/esm-es5/mds-toast-region.entry.js +1 -1
  1070. package/dist/esm-es5/mds-toast.entry.js +1 -1
  1071. package/dist/esm-es5/mds-tooltip.entry.js +2 -2
  1072. package/dist/esm-es5/mds-tree-item.entry.js +1 -1
  1073. package/dist/esm-es5/mds-tree.entry.js +1 -1
  1074. package/dist/esm-es5/mds-url-view.entry.js +1 -1
  1075. package/dist/esm-es5/mds-usage.entry.js +1 -1
  1076. package/dist/esm-es5/mds-video-wall.entry.js +1 -1
  1077. package/dist/esm-es5/mds-zero.entry.js +1 -1
  1078. package/dist/hydrate/index.js +1044 -156
  1079. package/dist/hydrate/index.mjs +1044 -156
  1080. package/dist/lint/core/checks.d.ts +26 -0
  1081. package/dist/lint/core/checks.js +135 -0
  1082. package/dist/lint/core/colors.d.ts +2 -0
  1083. package/dist/lint/core/colors.js +40 -0
  1084. package/dist/lint/core/data.d.ts +82 -0
  1085. package/dist/lint/core/data.js +171 -0
  1086. package/dist/lint/core/element.d.ts +55 -0
  1087. package/dist/lint/core/element.js +19 -0
  1088. package/dist/lint/eslint/adapters.d.ts +53 -0
  1089. package/dist/lint/eslint/adapters.js +217 -0
  1090. package/dist/lint/eslint/index.d.ts +7 -0
  1091. package/dist/lint/eslint/index.js +86 -0
  1092. package/dist/lint/index.d.ts +4 -0
  1093. package/dist/lint/index.js +10 -0
  1094. package/dist/lint/mcp/checks.d.ts +15 -0
  1095. package/dist/lint/mcp/checks.js +407 -0
  1096. package/dist/lint/mcp/cli.d.ts +2 -0
  1097. package/dist/lint/mcp/cli.js +29 -0
  1098. package/dist/lint/mcp/color.d.ts +12 -0
  1099. package/dist/lint/mcp/color.js +87 -0
  1100. package/dist/lint/mcp/components.d.ts +5 -0
  1101. package/dist/lint/mcp/components.js +362 -0
  1102. package/dist/lint/mcp/context.d.ts +25 -0
  1103. package/dist/lint/mcp/context.js +87 -0
  1104. package/dist/lint/mcp/guides.d.ts +3 -0
  1105. package/dist/lint/mcp/guides.js +137 -0
  1106. package/dist/lint/mcp/icon.svg +11 -0
  1107. package/dist/lint/mcp/icons.d.ts +3 -0
  1108. package/dist/lint/mcp/icons.js +170 -0
  1109. package/dist/lint/mcp/protocol.d.ts +42 -0
  1110. package/dist/lint/mcp/protocol.js +106 -0
  1111. package/dist/lint/mcp/server.d.ts +20 -0
  1112. package/dist/lint/mcp/server.js +67 -0
  1113. package/dist/lint/mcp/tokens.d.ts +22 -0
  1114. package/dist/lint/mcp/tokens.js +507 -0
  1115. package/dist/lint/package.json +3 -0
  1116. package/dist/lint/stylelint/index.d.ts +3 -0
  1117. package/dist/lint/stylelint/index.js +137 -0
  1118. package/dist/lint/stylelint/recommended.d.ts +3 -0
  1119. package/dist/lint/stylelint/recommended.js +10 -0
  1120. package/dist/lint/stylelint/strict.d.ts +3 -0
  1121. package/dist/lint/stylelint/strict.js +10 -0
  1122. package/dist/magma-components/magma-components.esm.js +1 -1
  1123. package/dist/magma-components/{p-a8a0a9ba.entry.js → p-00aa9a51.entry.js} +1 -1
  1124. package/dist/magma-components/{p-62e94d78.system.entry.js → p-00acb2e1.system.entry.js} +2 -2
  1125. package/dist/magma-components/{p-4bc3335f.system.entry.js → p-037126b7.system.entry.js} +1 -1
  1126. package/dist/magma-components/{p-e5d41024.system.entry.js → p-03da0376.system.entry.js} +1 -1
  1127. package/dist/magma-components/{p-25a6e977.entry.js → p-0417391b.entry.js} +1 -1
  1128. package/dist/magma-components/{p-377d0661.entry.js → p-05ef91a5.entry.js} +1 -1
  1129. package/dist/magma-components/{p-7b300282.entry.js → p-07d35da6.entry.js} +1 -1
  1130. package/dist/magma-components/{p-f4d80d9a.entry.js → p-09c80fdb.entry.js} +1 -1
  1131. package/dist/magma-components/{p-5cfa0dce.entry.js → p-0b0ca53c.entry.js} +1 -1
  1132. package/dist/magma-components/{p-624a3909.system.entry.js → p-0babf674.system.entry.js} +3 -3
  1133. package/dist/magma-components/{p-b01118cc.entry.js → p-0d90c991.entry.js} +1 -1
  1134. package/dist/magma-components/{p-9745dc51.entry.js → p-103465cf.entry.js} +1 -1
  1135. package/dist/magma-components/{p-d608b79c.entry.js → p-10983da0.entry.js} +1 -1
  1136. package/dist/magma-components/{p-52d905fe.system.entry.js → p-109926ce.system.entry.js} +2 -2
  1137. package/dist/magma-components/{p-770b3c4b.entry.js → p-14b13850.entry.js} +1 -1
  1138. package/dist/magma-components/{p-b5cc09c7.system.entry.js → p-154ba354.system.entry.js} +2 -2
  1139. package/dist/magma-components/{p-f5a33058.entry.js → p-160cd923.entry.js} +1 -1
  1140. package/dist/magma-components/{p-5ef0fb69.system.entry.js → p-1685e74c.system.entry.js} +1 -1
  1141. package/dist/magma-components/p-1748ca8b.system.entry.js +1 -0
  1142. package/dist/magma-components/{p-c03fc4fe.system.entry.js → p-17a43cb6.system.entry.js} +2 -2
  1143. package/dist/magma-components/p-17ccfc01.system.entry.js +208 -0
  1144. package/dist/magma-components/{p-f0285a1e.system.entry.js → p-1b415625.system.entry.js} +3 -3
  1145. package/dist/magma-components/{p-3e18b181.system.entry.js → p-1b67b149.system.entry.js} +1 -1
  1146. package/dist/magma-components/p-1c00d0f7.entry.js +1 -0
  1147. package/dist/magma-components/{p-79f543fc.system.entry.js → p-1cd75adf.system.entry.js} +3 -3
  1148. package/dist/magma-components/{p-8f47eb63.system.entry.js → p-1d8485de.system.entry.js} +4 -4
  1149. package/dist/magma-components/{p-168d5fad.entry.js → p-2006cfeb.entry.js} +1 -1
  1150. package/dist/magma-components/{p-02fe26b4.system.entry.js → p-2216f207.system.entry.js} +2 -2
  1151. package/dist/magma-components/{p-edf003f1.system.entry.js → p-22f24125.system.entry.js} +1 -1
  1152. package/dist/magma-components/{p-6560b426.system.entry.js → p-25c07b67.system.entry.js} +1 -1
  1153. package/dist/magma-components/{p-e3a65644.entry.js → p-29fbb7cf.entry.js} +1 -1
  1154. package/dist/magma-components/{p-f7147d05.entry.js → p-2a26b614.entry.js} +1 -1
  1155. package/dist/magma-components/p-2a6c2a41.entry.js +1 -0
  1156. package/dist/magma-components/{p-06fde29d.entry.js → p-2c28056d.entry.js} +1 -1
  1157. package/dist/magma-components/{p-23722401.entry.js → p-2c5e5cd1.entry.js} +1 -1
  1158. package/dist/magma-components/{p-d92ccce5.system.entry.js → p-2c7d091e.system.entry.js} +3 -3
  1159. package/dist/magma-components/{p-3abaa053.entry.js → p-2c997b47.entry.js} +1 -1
  1160. package/dist/magma-components/{p-0a8e8525.entry.js → p-2f39f4e4.entry.js} +1 -1
  1161. package/dist/magma-components/{p-02298ed0.system.entry.js → p-31370fdb.system.entry.js} +1 -1
  1162. package/dist/magma-components/{p-3df07021.system.entry.js → p-3139988c.system.entry.js} +1 -1
  1163. package/dist/magma-components/p-32418266.entry.js +1 -0
  1164. package/dist/magma-components/{p-cc9659e1.system.entry.js → p-33c80de3.system.entry.js} +1 -1
  1165. package/dist/magma-components/{p-09a7b578.system.entry.js → p-34c0e63c.system.entry.js} +1 -1
  1166. package/dist/magma-components/{p-3c669cfb.entry.js → p-354a5b47.entry.js} +1 -1
  1167. package/dist/magma-components/{p-071f5c7b.system.entry.js → p-35c6341a.system.entry.js} +3 -3
  1168. package/dist/magma-components/{p-f09b08f9.entry.js → p-379f51a6.entry.js} +1 -1
  1169. package/dist/magma-components/{p-7c217aa5.entry.js → p-381f49ea.entry.js} +1 -1
  1170. package/dist/magma-components/{p-221c2f0d.entry.js → p-384ab014.entry.js} +1 -1
  1171. package/dist/magma-components/{p-6af00399.system.entry.js → p-386bb24e.system.entry.js} +3 -3
  1172. package/dist/magma-components/{p-1e18fcc5.system.entry.js → p-39a2df98.system.entry.js} +1 -1
  1173. package/dist/magma-components/{p-2752b45a.system.entry.js → p-3a7c4314.system.entry.js} +3 -3
  1174. package/dist/magma-components/{p-7be0d28b.entry.js → p-3a9a75e5.entry.js} +1 -1
  1175. package/dist/magma-components/{p-5435f2a9.entry.js → p-3b691cc3.entry.js} +1 -1
  1176. package/dist/magma-components/{p-88460d31.system.entry.js → p-3bdb541f.system.entry.js} +1 -1
  1177. package/dist/magma-components/{p-85fb1d08.entry.js → p-3ca004c3.entry.js} +1 -1
  1178. package/dist/magma-components/{p-4776ac1f.entry.js → p-3caf6a26.entry.js} +1 -1
  1179. package/dist/magma-components/{p-ced3ebb8.entry.js → p-3dccd446.entry.js} +1 -1
  1180. package/dist/magma-components/{p-55b10b70.system.entry.js → p-3dde41b0.system.entry.js} +1 -1
  1181. package/dist/magma-components/{p-be6e156a.system.entry.js → p-3e8e0003.system.entry.js} +2 -2
  1182. package/dist/magma-components/{p-21547758.system.entry.js → p-3f0e6729.system.entry.js} +3 -3
  1183. package/dist/magma-components/{p-f306b5c1.entry.js → p-42ab27de.entry.js} +1 -1
  1184. package/dist/magma-components/{p-803957de.system.entry.js → p-430a4c4b.system.entry.js} +1 -1
  1185. package/dist/magma-components/{p-d48c40ab.system.entry.js → p-47b05fa1.system.entry.js} +1 -1
  1186. package/dist/magma-components/{p-e5eb2390.entry.js → p-47db3155.entry.js} +1 -1
  1187. package/dist/magma-components/{p-2c845743.system.entry.js → p-48f86057.system.entry.js} +1 -1
  1188. package/dist/magma-components/{p-7961c335.system.entry.js → p-4a72d72c.system.entry.js} +1 -1
  1189. package/dist/magma-components/{p-227f57e6.entry.js → p-4aa94380.entry.js} +1 -1
  1190. package/dist/magma-components/{p-b9ca6c2e.entry.js → p-4ab2eb7e.entry.js} +1 -1
  1191. package/dist/magma-components/{p-c3c487aa.system.entry.js → p-4bea91e1.system.entry.js} +1 -1
  1192. package/dist/magma-components/{p-f588cf9e.entry.js → p-4cd21f19.entry.js} +1 -1
  1193. package/dist/magma-components/{p-dbca23af.entry.js → p-4de89d1b.entry.js} +1 -1
  1194. package/dist/magma-components/{p-23fabd66.system.entry.js → p-50c8f36c.system.entry.js} +1 -1
  1195. package/dist/magma-components/{p-f39416e9.system.entry.js → p-5200ab23.system.entry.js} +2 -2
  1196. package/dist/magma-components/{p-f35608b2.entry.js → p-52211fa3.entry.js} +1 -1
  1197. package/dist/magma-components/{p-37487e8b.system.entry.js → p-53981624.system.entry.js} +1 -1
  1198. package/dist/magma-components/p-53acdc6b.entry.js +1 -0
  1199. package/dist/magma-components/p-5660182a.system.entry.js +1 -0
  1200. package/dist/magma-components/{p-464e6431.entry.js → p-56c5ca6f.entry.js} +1 -1
  1201. package/dist/magma-components/p-57e92942.system.entry.js +20 -0
  1202. package/dist/magma-components/{p-63b10a6e.entry.js → p-59aa4994.entry.js} +1 -1
  1203. package/dist/magma-components/{p-9a3ddc91.entry.js → p-59f06b9c.entry.js} +1 -1
  1204. package/dist/magma-components/{p-3d95e688.system.entry.js → p-5aa78075.system.entry.js} +3 -3
  1205. package/dist/magma-components/{p-14635a8f.entry.js → p-5cf87a7f.entry.js} +1 -1
  1206. package/dist/magma-components/{p-87baf82a.entry.js → p-5e8df58d.entry.js} +1 -1
  1207. package/dist/magma-components/{p-880f3eac.system.entry.js → p-5ed74216.system.entry.js} +1 -1
  1208. package/dist/magma-components/{p-50705d36.system.entry.js → p-5f064376.system.entry.js} +1 -1
  1209. package/dist/magma-components/{p-93d7485d.entry.js → p-60727165.entry.js} +2 -2
  1210. package/dist/magma-components/{p-278c362d.entry.js → p-6093aa8e.entry.js} +1 -1
  1211. package/dist/magma-components/{p-b8a59768.entry.js → p-62d9eaca.entry.js} +1 -1
  1212. package/dist/magma-components/{p-947fcf74.system.entry.js → p-6b402a09.system.entry.js} +9 -9
  1213. package/dist/magma-components/p-6b55c5fe.system.entry.js +1 -0
  1214. package/dist/magma-components/{p-3d162e99.system.entry.js → p-6d57674c.system.entry.js} +2 -2
  1215. package/dist/magma-components/p-6d96d223.entry.js +1 -0
  1216. package/dist/magma-components/{p-38b16983.system.entry.js → p-6df26141.system.entry.js} +3 -3
  1217. package/dist/magma-components/{p-5f8db04c.system.entry.js → p-6df7da52.system.entry.js} +1 -1
  1218. package/dist/magma-components/{p-9250ec26.system.entry.js → p-6e751bcc.system.entry.js} +2 -2
  1219. package/dist/magma-components/{p-fc22f5e0.system.entry.js → p-718d6384.system.entry.js} +1 -1
  1220. package/dist/magma-components/{p-b4633c9c.system.entry.js → p-71dab494.system.entry.js} +3 -3
  1221. package/dist/magma-components/{p-ec635255.entry.js → p-732d09b6.entry.js} +1 -1
  1222. package/dist/magma-components/{p-fac6f123.entry.js → p-73f4f67e.entry.js} +1 -1
  1223. package/dist/magma-components/{p-772c18f4.entry.js → p-785fa112.entry.js} +1 -1
  1224. package/dist/magma-components/{p-9cf81575.system.entry.js → p-79fd07e7.system.entry.js} +1 -1
  1225. package/dist/magma-components/{p-0033cb92.system.entry.js → p-7acbc6ea.system.entry.js} +1 -1
  1226. package/dist/magma-components/{p-67eb3881.entry.js → p-7dd0364b.entry.js} +1 -1
  1227. package/dist/magma-components/{p-85a31141.entry.js → p-7e7391fd.entry.js} +1 -1
  1228. package/dist/magma-components/{p-f5326224.system.entry.js → p-7ec28ff1.system.entry.js} +2 -2
  1229. package/dist/magma-components/{p-f901c844.entry.js → p-7f74ec99.entry.js} +1 -1
  1230. package/dist/magma-components/{p-0679c988.system.entry.js → p-7ffce9e8.system.entry.js} +1 -1
  1231. package/dist/magma-components/{p-06ccc40d.entry.js → p-81212e34.entry.js} +1 -1
  1232. package/dist/magma-components/{p-cf6f54e5.system.entry.js → p-8219e58f.system.entry.js} +2 -2
  1233. package/dist/magma-components/{p-eb92312f.system.entry.js → p-84711ab6.system.entry.js} +3 -3
  1234. package/dist/magma-components/p-84bf333b.entry.js +1 -0
  1235. package/dist/magma-components/{p-4792ff7f.entry.js → p-84d0d701.entry.js} +1 -1
  1236. package/dist/magma-components/{p-30be5c39.entry.js → p-857ae762.entry.js} +1 -1
  1237. package/dist/magma-components/{p-8f63f1a1.system.entry.js → p-87395a4d.system.entry.js} +1 -1
  1238. package/dist/magma-components/{p-2431fbfa.system.entry.js → p-87831da2.system.entry.js} +1 -1
  1239. package/dist/magma-components/{p-e39518b4.system.entry.js → p-896310aa.system.entry.js} +2 -2
  1240. package/dist/magma-components/{p-dc1a5826.system.entry.js → p-8ac1ba5c.system.entry.js} +1 -1
  1241. package/dist/magma-components/{p-86cf87fb.entry.js → p-8b8a6662.entry.js} +1 -1
  1242. package/dist/magma-components/{p-62fc9695.entry.js → p-8d7093af.entry.js} +1 -1
  1243. package/dist/magma-components/{p-8ab9ff37.system.entry.js → p-8e15c151.system.entry.js} +1 -1
  1244. package/dist/magma-components/{p-075acd04.entry.js → p-8f1c529f.entry.js} +1 -1
  1245. package/dist/magma-components/{p-07a3c63c.system.entry.js → p-8f1e9021.system.entry.js} +1 -1
  1246. package/dist/magma-components/{p-69abd1d1.entry.js → p-904c1222.entry.js} +1 -1
  1247. package/dist/magma-components/{p-a70fb4fb.system.entry.js → p-907f06cd.system.entry.js} +9 -9
  1248. package/dist/magma-components/{p-3f68ddca.entry.js → p-9332358d.entry.js} +1 -1
  1249. package/dist/magma-components/{p-44998584.system.entry.js → p-93b9d39d.system.entry.js} +2 -2
  1250. package/dist/magma-components/{p-d8ae0f02.system.entry.js → p-965e7a82.system.entry.js} +1 -1
  1251. package/dist/magma-components/{p-c50e20cf.system.entry.js → p-96dfb60e.system.entry.js} +1 -1
  1252. package/dist/magma-components/{p-3beea731.system.entry.js → p-9c408768.system.entry.js} +1 -1
  1253. package/dist/magma-components/{p-1d2220f0.system.entry.js → p-9e792bed.system.entry.js} +1 -1
  1254. package/dist/magma-components/{p-8258733b.entry.js → p-9fdd477a.entry.js} +1 -1
  1255. package/dist/magma-components/{p-f82c2b7e.system.entry.js → p-9fefa077.system.entry.js} +1 -1
  1256. package/dist/magma-components/p-B8zYiZQY.system.js +2 -2
  1257. package/dist/magma-components/{p-97eb734a.system.entry.js → p-a0d637b6.system.entry.js} +1 -1
  1258. package/dist/magma-components/p-a26c05b6.entry.js +1 -0
  1259. package/dist/magma-components/{p-ccc40c6a.system.entry.js → p-a7baf451.system.entry.js} +2 -2
  1260. package/dist/magma-components/{p-77545238.entry.js → p-ac9feb04.entry.js} +1 -1
  1261. package/dist/magma-components/{p-dedbf8d6.entry.js → p-ad383f92.entry.js} +1 -1
  1262. package/dist/magma-components/{p-1ea582a9.system.entry.js → p-ae4736a0.system.entry.js} +3 -3
  1263. package/dist/magma-components/{p-9fc385aa.entry.js → p-b3332c5f.entry.js} +1 -1
  1264. package/dist/magma-components/{p-a987086b.system.entry.js → p-b3e2b68a.system.entry.js} +1 -1
  1265. package/dist/magma-components/{p-808b9277.entry.js → p-b86144d4.entry.js} +1 -1
  1266. package/dist/magma-components/{p-a0612465.system.entry.js → p-bbde5701.system.entry.js} +1 -1
  1267. package/dist/magma-components/{p-5472f18d.system.entry.js → p-bc075b3b.system.entry.js} +2 -2
  1268. package/dist/magma-components/{p-29971e1d.entry.js → p-bc19b136.entry.js} +1 -1
  1269. package/dist/magma-components/{p-17ec24dc.entry.js → p-bcca26d9.entry.js} +1 -1
  1270. package/dist/magma-components/{p-8b501f92.entry.js → p-bf35627d.entry.js} +1 -1
  1271. package/dist/magma-components/p-bfd95736.entry.js +1 -0
  1272. package/dist/magma-components/{p-6a2d67d1.system.entry.js → p-c086a5a4.system.entry.js} +1 -1
  1273. package/dist/magma-components/{p-41a0f896.entry.js → p-c27206ca.entry.js} +1 -1
  1274. package/dist/magma-components/{p-762a6b7b.entry.js → p-c2758b81.entry.js} +1 -1
  1275. package/dist/magma-components/{p-d3491226.system.entry.js → p-c2c693ed.system.entry.js} +1 -1
  1276. package/dist/magma-components/{p-642925b7.system.entry.js → p-c4a5ab6e.system.entry.js} +1 -1
  1277. package/dist/magma-components/{p-b23bee0c.entry.js → p-c58157cf.entry.js} +1 -1
  1278. package/dist/magma-components/{p-8a9544aa.entry.js → p-c597ad47.entry.js} +1 -1
  1279. package/dist/magma-components/{p-295d8fab.entry.js → p-c7b2ebb5.entry.js} +1 -1
  1280. package/dist/magma-components/{p-046697e4.system.entry.js → p-c8b06821.system.entry.js} +1 -1
  1281. package/dist/magma-components/p-ca1143bc.entry.js +1 -0
  1282. package/dist/magma-components/p-cb88fa71.entry.js +1 -0
  1283. package/dist/magma-components/{p-cc954b22.system.entry.js → p-cd783f9e.system.entry.js} +1 -1
  1284. package/dist/magma-components/{p-bd97e368.system.entry.js → p-cd955bc7.system.entry.js} +1 -1
  1285. package/dist/magma-components/{p-1f623b75.entry.js → p-ce42e251.entry.js} +1 -1
  1286. package/dist/magma-components/{p-7bf46d43.entry.js → p-cf4f4561.entry.js} +1 -1
  1287. package/dist/magma-components/{p-44333d50.system.entry.js → p-d0a15a3a.system.entry.js} +1 -1
  1288. package/dist/magma-components/{p-f616f467.entry.js → p-d218ae47.entry.js} +1 -1
  1289. package/dist/magma-components/{p-69badbba.entry.js → p-d331ff5c.entry.js} +1 -1
  1290. package/dist/magma-components/{p-f75935ed.system.entry.js → p-d3844c9a.system.entry.js} +4 -4
  1291. package/dist/magma-components/{p-837d31b8.entry.js → p-d3ac9a1a.entry.js} +1 -1
  1292. package/dist/magma-components/{p-8740403e.system.entry.js → p-d4c3250f.system.entry.js} +2 -2
  1293. package/dist/magma-components/p-d638bbb0.entry.js +1 -0
  1294. package/dist/magma-components/{p-72ad419d.system.entry.js → p-d65e9f0a.system.entry.js} +1 -1
  1295. package/dist/magma-components/{p-7d0c8177.entry.js → p-d87ecd68.entry.js} +1 -1
  1296. package/dist/magma-components/{p-2e48f88d.system.entry.js → p-d93b48b4.system.entry.js} +1 -1
  1297. package/dist/magma-components/{p-de1ae02c.entry.js → p-d94281cb.entry.js} +1 -1
  1298. package/dist/magma-components/{p-b467f737.entry.js → p-d9f92ff8.entry.js} +1 -1
  1299. package/dist/magma-components/{p-4cabfdbc.entry.js → p-da9bc02a.entry.js} +1 -1
  1300. package/dist/magma-components/{p-521ba3a8.entry.js → p-dc618cae.entry.js} +1 -1
  1301. package/dist/magma-components/p-de38f745.entry.js +1 -0
  1302. package/dist/magma-components/{p-e2fa6300.system.entry.js → p-dee123c7.system.entry.js} +1 -1
  1303. package/dist/magma-components/p-df387755.entry.js +1 -0
  1304. package/dist/magma-components/{p-b373cc32.entry.js → p-dfab370b.entry.js} +1 -1
  1305. package/dist/magma-components/{p-0e887379.system.entry.js → p-e30d0684.system.entry.js} +2 -2
  1306. package/dist/magma-components/{p-f66675f5.system.entry.js → p-e371f9e1.system.entry.js} +1 -1
  1307. package/dist/magma-components/{p-8f7daab1.system.entry.js → p-e3b9ea0b.system.entry.js} +1 -1
  1308. package/dist/magma-components/{p-104ba54e.system.entry.js → p-e3d262d9.system.entry.js} +2 -2
  1309. package/dist/magma-components/{p-7fde3025.system.entry.js → p-e54587e7.system.entry.js} +3 -3
  1310. package/dist/magma-components/{p-ad05ef26.system.entry.js → p-e5f893f9.system.entry.js} +1 -1
  1311. package/dist/magma-components/{p-2c3f518c.system.entry.js → p-e709a52e.system.entry.js} +2 -2
  1312. package/dist/magma-components/{p-8d14f146.entry.js → p-e8452cce.entry.js} +1 -1
  1313. package/dist/magma-components/{p-09f621ea.entry.js → p-ea503851.entry.js} +1 -1
  1314. package/dist/magma-components/{p-6dff107d.system.entry.js → p-ec44a4ea.system.entry.js} +2 -2
  1315. package/dist/magma-components/{p-9f6c502b.entry.js → p-ed133270.entry.js} +1 -1
  1316. package/dist/magma-components/{p-bb282bc1.system.entry.js → p-ee780f82.system.entry.js} +2 -2
  1317. package/dist/magma-components/p-ef4ee9ca.entry.js +1 -0
  1318. package/dist/magma-components/{p-7ca73c56.entry.js → p-f045b018.entry.js} +1 -1
  1319. package/dist/magma-components/{p-b69c3126.entry.js → p-f2211b1f.entry.js} +1 -1
  1320. package/dist/magma-components/{p-c40ad03a.entry.js → p-f267ff68.entry.js} +1 -1
  1321. package/dist/magma-components/{p-d254de66.system.entry.js → p-f27de6cb.system.entry.js} +1 -1
  1322. package/dist/magma-components/{p-2d9c9ef9.entry.js → p-f2ef884c.entry.js} +1 -1
  1323. package/dist/magma-components/{p-9f8ce68f.entry.js → p-f3f88f32.entry.js} +1 -1
  1324. package/dist/magma-components/{p-94439d8b.system.entry.js → p-f40e3918.system.entry.js} +2 -2
  1325. package/dist/magma-components/{p-6e32bf99.entry.js → p-f4181b35.entry.js} +1 -1
  1326. package/dist/magma-components/{p-8a76097f.entry.js → p-f4351160.entry.js} +1 -1
  1327. package/dist/magma-components/{p-c3a3caae.system.entry.js → p-f4fc9f29.system.entry.js} +1 -1
  1328. package/dist/magma-components/{p-da93a00b.system.entry.js → p-f5c7b147.system.entry.js} +1 -1
  1329. package/dist/magma-components/{p-84ed22ea.system.entry.js → p-f7d5445c.system.entry.js} +1 -1
  1330. package/dist/magma-components/{p-08370fc2.system.entry.js → p-f7e9af99.system.entry.js} +1 -1
  1331. package/dist/magma-components/{p-95478664.system.entry.js → p-f8c85ad7.system.entry.js} +1 -1
  1332. package/dist/magma-components/{p-c6819aad.entry.js → p-f9b601de.entry.js} +1 -1
  1333. package/dist/magma-components/{p-ffbf7448.entry.js → p-fa44d0d2.entry.js} +1 -1
  1334. package/dist/magma-components/{p-d3d74616.entry.js → p-fba648e0.entry.js} +1 -1
  1335. package/dist/magma-components/{p-35528bdd.system.entry.js → p-fe8e3721.system.entry.js} +1 -1
  1336. package/dist/magma-components/{p-2a4d22c9.system.entry.js → p-fe98a77e.system.entry.js} +2 -2
  1337. package/dist/magma-components/{p-8ca2e879.system.entry.js → p-ff7fc1f6.system.entry.js} +2 -2
  1338. package/dist/stats.json +3133 -1157
  1339. package/dist/types/components/mds-accordion/mds-accordion.d.ts +1 -0
  1340. package/dist/types/components/mds-accordion-item/mds-accordion-item.d.ts +1 -0
  1341. package/dist/types/components/mds-accordion-timer/mds-accordion-timer.d.ts +1 -0
  1342. package/dist/types/components/mds-accordion-timer-item/mds-accordion-timer-item.d.ts +1 -0
  1343. package/dist/types/components/mds-author/mds-author.d.ts +1 -0
  1344. package/dist/types/components/mds-avatar/mds-avatar.d.ts +1 -0
  1345. package/dist/types/components/mds-avatar-stack/mds-avatar-stack.d.ts +1 -0
  1346. package/dist/types/components/mds-avatar-stack-item/mds-avatar-stack-item.d.ts +3 -0
  1347. package/dist/types/components/mds-badge/mds-badge.d.ts +1 -0
  1348. package/dist/types/components/mds-banner/mds-banner.d.ts +1 -0
  1349. package/dist/types/components/mds-benchmark-bar/mds-benchmark-bar.d.ts +1 -0
  1350. package/dist/types/components/mds-bibliography/mds-bibliography.d.ts +3 -0
  1351. package/dist/types/components/mds-book/mds-book.d.ts +114 -0
  1352. package/dist/types/components/mds-book/meta/dictionary.d.ts +4 -0
  1353. package/dist/types/components/mds-book/meta/format.d.ts +30 -0
  1354. package/dist/types/components/mds-book/meta/pose.d.ts +64 -0
  1355. package/dist/types/components/mds-book/meta/spine.d.ts +33 -0
  1356. package/dist/types/components/mds-book/meta/types.d.ts +3 -0
  1357. package/dist/types/components/mds-book/meta/volume.d.ts +22 -0
  1358. package/dist/types/components/mds-breadcrumb/mds-breadcrumb.d.ts +1 -0
  1359. package/dist/types/components/mds-breadcrumb-item/mds-breadcrumb-item.d.ts +1 -0
  1360. package/dist/types/components/mds-button/mds-button.d.ts +1 -0
  1361. package/dist/types/components/mds-button-dropdown/mds-button-dropdown.d.ts +1 -0
  1362. package/dist/types/components/mds-button-group/mds-button-group.d.ts +1 -0
  1363. package/dist/types/components/mds-calendar/mds-calendar.d.ts +1 -0
  1364. package/dist/types/components/mds-calendar-cell/mds-calendar-cell.d.ts +3 -0
  1365. package/dist/types/components/mds-card/mds-card.d.ts +1 -0
  1366. package/dist/types/components/mds-card-content/mds-card-content.d.ts +1 -0
  1367. package/dist/types/components/mds-card-footer/mds-card-footer.d.ts +1 -0
  1368. package/dist/types/components/mds-card-header/mds-card-header.d.ts +1 -0
  1369. package/dist/types/components/mds-card-media/mds-card-media.d.ts +1 -0
  1370. package/dist/types/components/mds-chip/mds-chip.d.ts +3 -0
  1371. package/dist/types/components/mds-details/mds-details.d.ts +1 -0
  1372. package/dist/types/components/mds-dropdown/mds-dropdown.d.ts +1 -0
  1373. package/dist/types/components/mds-emoji/mds-emoji.d.ts +3 -0
  1374. package/dist/types/components/mds-entity/mds-entity.d.ts +1 -0
  1375. package/dist/types/components/mds-file/mds-file.d.ts +3 -0
  1376. package/dist/types/components/mds-file-preview/mds-file-preview.d.ts +1 -0
  1377. package/dist/types/components/mds-filter/mds-filter.d.ts +1 -0
  1378. package/dist/types/components/mds-filter-item/mds-filter-item.d.ts +3 -0
  1379. package/dist/types/components/mds-header/mds-header.d.ts +1 -0
  1380. package/dist/types/components/mds-header-bar/mds-header-bar.d.ts +1 -0
  1381. package/dist/types/components/mds-help/mds-help.d.ts +1 -0
  1382. package/dist/types/components/mds-horizontal-scroll/mds-horizontal-scroll.d.ts +1 -0
  1383. package/dist/types/components/mds-hr/mds-hr.d.ts +3 -0
  1384. package/dist/types/components/mds-icon/mds-icon.d.ts +1 -0
  1385. package/dist/types/components/mds-img/mds-img.d.ts +1 -0
  1386. package/dist/types/components/mds-input/mds-input.d.ts +1 -0
  1387. package/dist/types/components/mds-input-date/mds-input-date.d.ts +1 -0
  1388. package/dist/types/components/mds-input-date-range/mds-input-date-range.d.ts +1 -0
  1389. package/dist/types/components/mds-input-date-range-preselection/mds-input-date-range-preselection.d.ts +1 -0
  1390. package/dist/types/components/mds-input-field/mds-input-field.d.ts +1 -0
  1391. package/dist/types/components/mds-input-otp/mds-input-otp.d.ts +3 -0
  1392. package/dist/types/components/mds-input-range/mds-input-range.d.ts +1 -0
  1393. package/dist/types/components/mds-input-select/mds-input-select.d.ts +1 -0
  1394. package/dist/types/components/mds-input-switch/mds-input-switch.d.ts +1 -0
  1395. package/dist/types/components/mds-input-tip/mds-input-tip.d.ts +1 -0
  1396. package/dist/types/components/mds-input-tip-item/mds-input-tip-item.d.ts +1 -0
  1397. package/dist/types/components/mds-input-upload/mds-input-upload.d.ts +3 -0
  1398. package/dist/types/components/mds-keyboard/mds-keyboard.d.ts +1 -0
  1399. package/dist/types/components/mds-keyboard-key/mds-keyboard-key.d.ts +3 -0
  1400. package/dist/types/components/mds-kpi/mds-kpi.d.ts +1 -0
  1401. package/dist/types/components/mds-kpi-item/mds-kpi-item.d.ts +1 -0
  1402. package/dist/types/components/mds-label/mds-label.d.ts +3 -0
  1403. package/dist/types/components/mds-link/mds-link.d.ts +1 -0
  1404. package/dist/types/components/mds-list/mds-list.d.ts +1 -0
  1405. package/dist/types/components/mds-list-item/mds-list-item.d.ts +1 -0
  1406. package/dist/types/components/mds-mention/mds-mention.d.ts +3 -0
  1407. package/dist/types/components/mds-modal/mds-modal.d.ts +1 -0
  1408. package/dist/types/components/mds-note/mds-note.d.ts +1 -0
  1409. package/dist/types/components/mds-notification/mds-notification.d.ts +3 -0
  1410. package/dist/types/components/mds-paginator/mds-paginator.d.ts +3 -0
  1411. package/dist/types/components/mds-paginator-item/mds-paginator-item.d.ts +1 -0
  1412. package/dist/types/components/mds-policy-ai/mds-policy-ai.d.ts +1 -0
  1413. package/dist/types/components/mds-pref/mds-pref.d.ts +1 -1
  1414. package/dist/types/components/mds-pref-animation/mds-pref-animation.d.ts +3 -0
  1415. package/dist/types/components/mds-pref-consumption/mds-pref-consumption.d.ts +3 -0
  1416. package/dist/types/components/mds-pref-contrast/mds-pref-contrast.d.ts +3 -0
  1417. package/dist/types/components/mds-pref-language/mds-pref-language.d.ts +1 -0
  1418. package/dist/types/components/mds-pref-language-item/mds-pref-language-item.d.ts +3 -0
  1419. package/dist/types/components/mds-pref-mode/mds-pref-mode.d.ts +3 -0
  1420. package/dist/types/components/mds-pref-theme/mds-pref-theme.d.ts +1 -0
  1421. package/dist/types/components/mds-pref-theme-item/mds-pref-theme-item.d.ts +3 -0
  1422. package/dist/types/components/mds-price-table/mds-price-table.d.ts +1 -0
  1423. package/dist/types/components/mds-price-table-features/mds-price-table-features.d.ts +1 -0
  1424. package/dist/types/components/mds-price-table-features-cell/mds-price-table-features-cell.d.ts +1 -0
  1425. package/dist/types/components/mds-price-table-features-row/mds-price-table-features-row.d.ts +1 -0
  1426. package/dist/types/components/mds-price-table-header/mds-price-table-header.d.ts +1 -0
  1427. package/dist/types/components/mds-price-table-list/mds-price-table-list.d.ts +1 -0
  1428. package/dist/types/components/mds-price-table-list-item/mds-price-table-list-item.d.ts +1 -0
  1429. package/dist/types/components/mds-progress/mds-progress.d.ts +1 -0
  1430. package/dist/types/components/mds-push-notification/mds-push-notification.d.ts +1 -0
  1431. package/dist/types/components/mds-push-notification-item/mds-push-notification-item.d.ts +1 -0
  1432. package/dist/types/components/mds-quote/mds-quote.d.ts +1 -0
  1433. package/dist/types/components/mds-radial-menu/mds-radial-menu.d.ts +1 -0
  1434. package/dist/types/components/mds-radial-menu-item/mds-radial-menu-item.d.ts +3 -0
  1435. package/dist/types/components/mds-radial-progress/mds-radial-progress.d.ts +1 -0
  1436. package/dist/types/components/mds-separator/mds-separator.d.ts +3 -0
  1437. package/dist/types/components/mds-spinner/mds-spinner.d.ts +3 -0
  1438. package/dist/types/components/mds-status-bar/mds-status-bar.d.ts +1 -0
  1439. package/dist/types/components/mds-stepper-bar/mds-stepper-bar.d.ts +1 -0
  1440. package/dist/types/components/mds-stepper-bar-item/mds-stepper-bar-item.d.ts +1 -0
  1441. package/dist/types/components/mds-tab/mds-tab.d.ts +1 -0
  1442. package/dist/types/components/mds-tab-bar/mds-tab-bar.d.ts +1 -0
  1443. package/dist/types/components/mds-tab-bar-item/mds-tab-bar-item.d.ts +1 -0
  1444. package/dist/types/components/mds-tab-item/mds-tab-item.d.ts +1 -0
  1445. package/dist/types/components/mds-table/mds-table.d.ts +1 -0
  1446. package/dist/types/components/mds-table-body/mds-table-body.d.ts +1 -0
  1447. package/dist/types/components/mds-table-cell/mds-table-cell.d.ts +1 -0
  1448. package/dist/types/components/mds-table-footer/mds-table-footer.d.ts +1 -0
  1449. package/dist/types/components/mds-table-header/mds-table-header.d.ts +1 -0
  1450. package/dist/types/components/mds-table-header-cell/mds-table-header-cell.d.ts +1 -0
  1451. package/dist/types/components/mds-table-row/mds-table-row.d.ts +1 -0
  1452. package/dist/types/components/mds-text/mds-text.d.ts +1 -0
  1453. package/dist/types/components/mds-toast/mds-toast.d.ts +1 -0
  1454. package/dist/types/components/mds-toast-region/mds-toast-region.d.ts +1 -0
  1455. package/dist/types/components/mds-tooltip/mds-tooltip.d.ts +1 -0
  1456. package/dist/types/components/mds-tree/mds-tree.d.ts +1 -0
  1457. package/dist/types/components/mds-tree-item/mds-tree-item.d.ts +1 -0
  1458. package/dist/types/components/mds-url-view/mds-url-view.d.ts +3 -0
  1459. package/dist/types/components/mds-usage/mds-usage.d.ts +1 -0
  1460. package/dist/types/components/mds-video-wall/mds-video-wall.d.ts +1 -0
  1461. package/dist/types/components/mds-zero/mds-zero.d.ts +1 -0
  1462. package/dist/types/components.d.ts +1517 -6
  1463. package/package.json +42 -5
  1464. package/dist/components/p-B0AnE3sA.js +0 -1
  1465. package/dist/components/p-CHHEp_7y.js +0 -1
  1466. package/dist/components/p-D8wd-EZX.js +0 -1
  1467. package/dist/magma-components/p-0193734e.entry.js +0 -1
  1468. package/dist/magma-components/p-083dceb8.system.entry.js +0 -1
  1469. package/dist/magma-components/p-093b8fbc.system.entry.js +0 -20
  1470. package/dist/magma-components/p-0e2cd21e.entry.js +0 -1
  1471. package/dist/magma-components/p-11320427.entry.js +0 -1
  1472. package/dist/magma-components/p-1c2c4670.entry.js +0 -1
  1473. package/dist/magma-components/p-335244bb.entry.js +0 -1
  1474. package/dist/magma-components/p-3fb46ab9.system.entry.js +0 -1
  1475. package/dist/magma-components/p-4d485e1f.system.entry.js +0 -1
  1476. package/dist/magma-components/p-6436178a.entry.js +0 -1
  1477. package/dist/magma-components/p-7ad68b2f.entry.js +0 -1
  1478. package/dist/magma-components/p-89d4b6e9.entry.js +0 -1
  1479. package/dist/magma-components/p-984dd850.entry.js +0 -1
  1480. package/dist/magma-components/p-a7c01334.entry.js +0 -1
  1481. package/dist/magma-components/p-ab4b617d.entry.js +0 -1
  1482. package/dist/magma-components/p-d6b38d8a.entry.js +0 -1
  1483. package/dist/magma-components/p-e1383302.entry.js +0 -1
@@ -9,6 +9,7 @@ import { preferenceStore } from "../../common/preference";
9
9
  * @part spinner - The spinner element
10
10
  * @part avatar - The avatar element
11
11
  * @part infos - The column that stacks the name (default slot) and the `detail` row
12
+ * @category data
12
13
  */
13
14
  export class MdsEntity {
14
15
  constructor() {
@@ -37,7 +38,7 @@ export class MdsEntity {
37
38
  this.onSlotChange();
38
39
  }
39
40
  render() {
40
- return (h(Host, { key: 'd54946dea6ac4a5b5a6559efc14faf5a27ca7328', "pref-contrast": preferenceStore.state.contrast, "pref-mode": preferenceStore.state.mode, "pref-theme-scheme": preferenceStore.state['theme-scheme'] }, h("div", { key: '7be73903fcb31933a9e461c9f34e737f17b23d95', class: "spinner", part: "spinner" }, h("mds-spinner", { key: '39b3af311f2ec9f55166e3afafe78b251e219ccc', running: true })), this.checkAvatar() && (h("mds-avatar", { key: '296e0b1372cdf4bdd104595de6982116f84a0bb8', class: "preview", icon: this.icon, initials: this.initials, src: this.src, tone: this.tone, variant: this.variant, part: "avatar" })), h("div", { key: 'f8511118c5f1215fff4c5b905992621868539c8f', class: "infos", part: "infos" }, h("slot", { key: '1e3b509ca828b1d03da286233c75fb39947602c7' }), h("div", { key: 'b1f6ebff7af3cd07da5a321cea9033662d66d542', class: clsx('details', !this.hasDetails && 'details--hidden') }, h("slot", { key: 'fa7d7cad8910e4f659567dd15522de730e9e30ae', name: "detail", onSlotchange: this.onSlotChange }))), h("div", { key: '823ef0dd15d2a6fb77c3fba81fbd60c491c993d2', class: clsx('actions', !this.hasActions && 'actions--hidden') }, h("slot", { key: 'b4b3db7d00ff44e2117ae5173f4b7002db92f05d', name: "action", onSlotchange: this.onSlotChange }))));
41
+ return (h(Host, { key: '746cc0e5d2e9aa46c13c22dc11003aa2f904e644', "pref-contrast": preferenceStore.state.contrast, "pref-mode": preferenceStore.state.mode, "pref-theme-scheme": preferenceStore.state['theme-scheme'] }, h("div", { key: 'd00bce58e1f2b79f84d03968a41d44cded603855', class: "spinner", part: "spinner" }, h("mds-spinner", { key: '3d961c8d972f90d3e575ea2a24b4665b0d494d4e', running: true })), this.checkAvatar() && (h("mds-avatar", { key: '041579718c0f175d3b19aabf2617a696e8e18dfc', class: "preview", icon: this.icon, initials: this.initials, src: this.src, tone: this.tone, variant: this.variant, part: "avatar" })), h("div", { key: '0719e66e3a4d2c10cecdb673fc442fc7786543ee', class: "infos", part: "infos" }, h("slot", { key: 'e8ce292711d686f7baed7b16b7b4629d5ca5306f' }), h("div", { key: '289632e72502660cbe2cdc24ff1f00c4c229e3bd', class: clsx('details', !this.hasDetails && 'details--hidden') }, h("slot", { key: 'bd7c088d888bb84c04a8d5b6672d3d7bf2c78431', name: "detail", onSlotchange: this.onSlotChange }))), h("div", { key: 'ec03e4905cbd9912b19d91ff2148891d040be635', class: clsx('actions', !this.hasActions && 'actions--hidden') }, h("slot", { key: '2c3e727faa3bdc116faed2960715932fe7854279', name: "action", onSlotchange: this.onSlotChange }))));
41
42
  }
42
43
  static get is() { return "mds-entity"; }
43
44
  static get encapsulation() { return "shadow"; }
@@ -112,15 +112,12 @@ Combine `await` with `icon` and `variant` to drive a state machine: show the spi
112
112
 
113
113
  #### Styling Customization
114
114
 
115
- Style the entity only through its documented `--mds-entity-*` CSS custom properties. Set them on the host or a parent selector; use the semantic color roles via `rgb(var(--magma-<role>))` so dark mode and high-contrast modes keep working. `--mds-entity-icon-background` and `--mds-entity-icon-color` paint the avatar only while it has no `variant` (none set, and no `initials`, which derive one).
115
+ Style the entity only through its public `--mds-entity-*` CSS custom properties. Set them on the host or a parent selector; use the semantic color roles via `rgb(var(--magma-<role>))` so dark mode and high-contrast modes keep working. The avatar takes its colours from `variant` and `tone`, not from a custom property.
116
116
 
117
117
  ```css
118
118
  .entity-highlight mds-entity {
119
119
  --mds-entity-background: rgb(var(--magma-accent-surface));
120
120
  --mds-entity-color: rgb(var(--magma-accent-fg));
121
- --mds-entity-detail-color: rgb(var(--magma-text-muted));
122
- --mds-entity-icon-background: rgb(var(--magma-accent-surface-hover));
123
- --mds-entity-icon-color: rgb(var(--magma-accent-fg));
124
121
  }
125
122
  ```
126
123
 
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-file
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.6.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
10
10
 
11
11
  The `<mds-file>` web component is the Magma Design System control for representing a downloadable file as a rich, clickable card. It pairs a filename with an auto-detected file-type icon, badge, and human-readable description, and tracks whether the file has already been downloaded.
12
12
 
@@ -55,8 +55,8 @@ The `<mds-file>` web component is the Magma Design System control for representi
55
55
  | Property | Description |
56
56
  | --- | --- |
57
57
  | `--mds-file-preview-color` | Sets the text color used in the file preview |
58
- | `--mds-file-preview-icon-background` | Sets the background color of the file preview icon |
59
- | `--mds-file-preview-icon-color` | Sets the color of the file preview icon |
58
+
59
+ Only these are public. Its other 2 are internal: they may change in any release, do not set them.
60
60
 
61
61
  ## Dependencies
62
62
 
@@ -41,7 +41,7 @@ Common incorrect uses of `<mds-file>`. Each entry pairs the wrong form with the
41
41
 
42
42
  #### Do Not Pierce Shadow DOM to Style the Preview Panel
43
43
 
44
- The supported customization surface is `--mds-file-preview-*` CSS custom properties. Targeting internal elements with `>>>`, `/deep/`, or undocumented selectors couples your code to the Shadow DOM structure and will break on minor releases.
44
+ The supported customization surface is the public `--mds-file-preview-color` CSS custom property. Targeting internal elements with `>>>`, `/deep/`, or undocumented selectors couples your code to the Shadow DOM structure and will break on minor releases.
45
45
 
46
46
  ```css
47
47
  /* INCORRECT */
@@ -51,8 +51,7 @@ mds-file >>> .preview {
51
51
 
52
52
  /* CORRECT */
53
53
  mds-file {
54
- --mds-file-preview-icon-background: rgb(var(--magma-accent-surface-subtle));
55
- --mds-file-preview-icon-color: rgb(var(--magma-accent-fg));
54
+ --mds-file-preview-color: rgb(var(--magma-accent-fg));
56
55
  }
57
56
  ```
58
57
 
@@ -1,5 +1,5 @@
1
1
  {
2
- "timestamp": "2026-10-22T13:02:36",
2
+ "timestamp": "2026-10-24T12:14:05",
3
3
  "compiler": {
4
4
  "name": "@stencil/core",
5
5
  "version": "4.45.2",
@@ -11,11 +11,16 @@
11
11
  "encapsulation": "shadow",
12
12
  "tag": "mds-file",
13
13
  "docs": "This is a web-component from Maggioli Design System [Magma](https://magma.maggiolicloud.it), built with StencilJS, TypeScript, Storybook. It's based on the web-component standard and it's designed to be agnostic from the JavaScript framework you are using.",
14
- "docsTags": [],
14
+ "docsTags": [
15
+ {
16
+ "name": "category",
17
+ "text": "content"
18
+ }
19
+ ],
15
20
  "usage": {
16
21
  "1. Description": "The `<mds-file>` web component is the Magma Design System control for representing a downloadable file as a rich, clickable card. It pairs a filename with an auto-detected file-type icon, badge, and human-readable description, and tracks whether the file has already been downloaded.\n\n#### Semantic Behavior\n\n- **Clickable card**: The whole host is a button (`role=\"button\"`, unless you set another role) in the tab order: a click, Enter or Space emits `mdsFileDownload`; the component itself does not fetch or download - the consumer wires the actual download to that event.\n- **Download event payload**: `mdsFileDownload` carries `description` (the `description` prop, or else the description of the detected type in the page language, the text the card shows), `extension` (empty for a filename without one), `filename`, the host element as `target`, and the detected `type`/format.\n- **Downloaded persistence**: On click the component records the file as downloaded in `localStorage`, under a key derived from the filename with a small non-cryptographic hash. Every later render of the same filename on the same origin shows the \"done\" indicator.\n- **Automatic file-type recognition**: From `filename` it derives the format icon, badge variant, and default description; `suffix` overrides this detection.\n- **Localization**: Descriptions and the \"already downloaded\" tooltip are resolved against the active locale.\n\n#### Properties & Visual Configurations\n\n- **`filename`** is the primary input: it provides the displayed title and drives icon, badge, suffix, and description detection. The name and extension are rendered separately, split at the last dot so the dots inside the name are kept (`report.v2.final.docx` shows `report.v2.final` and `.docx`; a leading dot belongs to the name, as in `.env`); the extension is shown only when not explicitly overridden by `suffix`, and a filename without one shows no extension and no badge.\n- **`suffix`** forces a specific file type from the supported format set when the filename's extension is missing or wrong; it bypasses automatic recognition.\n- **`description`** overrides the derived, localized file-type description when a custom label is needed.\n- **`preview`** supplies an image URL (logo or thumbnail) rendered as the preview surface instead of the generic format icon - use it when a meaningful visual of the file exists.\n- **`hideDownloadedIcon`** (default `false`) suppresses the persisted \"already downloaded\" indicator; set it when that affordance is not appropriate.\n- **`format`** is normally populated by the component itself from detection rather than set by the consumer.\n",
17
- "2. Pattern": "Correct and idiomatic ways to use the `<mds-file>` 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 File Card\n\nThe minimal form. Pass `filename` with a real filename (including extension) and the component auto-detects the format icon, badge color, and localized description.\n\n```html\n<mds-file filename=\"relazione-annuale.pdf\"></mds-file>\n```\n\n#### Handling the Download Event\n\nThe component does not fetch or download anything by itself. Listen for `mdsFileDownload` and trigger the actual download in the event handler. The event detail carries `filename`, `extension`, `type`, `description`, and `target`.\n\n```html\n<mds-file filename=\"contratto-servizio.docx\" id=\"file-card\"></mds-file>\n\n<script>\n document.getElementById('file-card').addEventListener('mdsFileDownload', (event) => {\n const { filename, extension, type } = event.detail;\n console.log(`Download avviato: ${filename} (${type})`);\n // avvia il download effettivo dal server\n });\n</script>\n```\n\n#### Forcing a File Type with `suffix`\n\nWhen the filename lacks an extension or carries a misleading one, use `suffix` to force a specific format from the supported set.\n\n```html\n<!-- filename senza estensione - forza il riconoscimento come PDF -->\n<mds-file filename=\"documento-firmato\" suffix=\"pdf\"></mds-file>\n\n<!-- estensione sconosciuta - forzata come archivio ZIP -->\n<mds-file filename=\"backup.bkp\" suffix=\"zip\"></mds-file>\n```\n\n#### Custom Description\n\nOverride the localized auto-generated description with a specific label relevant to the document context. Use `description` when the default type label (e.g. \"Documento Adobe\" for a PDF) is not informative enough.\n\n```html\n<mds-file\n filename=\"verbale-cda-2024.pdf\"\n description=\"Verbale approvato dal Consiglio di Amministrazione\"\n></mds-file>\n```\n\n#### Image Preview\n\nProvide `preview` with an image URL when a meaningful visual thumbnail is available - a logo, a reduced version of an image file, or a document cover. The preview replaces the generic format icon in the left panel.\n\n```html\n<mds-file\n filename=\"logo-aziendale.png\"\n preview=\"https://cdn.example.com/thumbnails/logo-aziendale-128.png\"\n></mds-file>\n```\n\n#### Hiding the \"Already Downloaded\" Indicator\n\nThe component shows a \"done\" indicator once the file has been downloaded, on every later render of the same filename. Add `hide-downloaded-icon` to suppress it when the affordance is not appropriate for the context (e.g. a list where every file is always shown as fresh).\n\n```html\n<mds-file filename=\"modulo-richiesta.xlsx\" hide-downloaded-icon></mds-file>\n```\n\nNote: this is the only valid way to turn the indicator off. Magma 1 used `show-downloaded-icon=\"false\"`; that prop no longer exists (the codemod turns it into `hide-downloaded-icon`).\n\n#### Rendering a List of Files\n\nPlace multiple `<mds-file>` cards inside a container and attach a single delegated event listener when the file list is dynamic.\n\n```html\n<div class=\"file-list\">\n <mds-file filename=\"allegato-1.pdf\"></mds-file>\n <mds-file filename=\"allegato-2.docx\"></mds-file>\n <mds-file filename=\"allegato-3.xlsx\"></mds-file>\n</div>\n\n<script>\n document.querySelector('.file-list').addEventListener('mdsFileDownload', (event) => {\n const { filename } = event.detail;\n avviaDownload(filename);\n });\n</script>\n```\n\n#### Styling Customization\n\nStyle the preview panel only through the three documented `--mds-file-*` CSS custom properties. Use the semantic color roles via `rgb(var(--magma-<role>))` so dark mode and high-contrast modes keep working.\n\n```css\n.archivio-documenti mds-file {\n --mds-file-preview-icon-color: rgb(var(--magma-accent-fg));\n --mds-file-preview-icon-background: rgb(var(--magma-accent-surface-subtle));\n --mds-file-preview-color: rgb(var(--magma-accent-fg));\n}\n```\n",
18
- "3. Antipattern": "Common incorrect uses of `<mds-file>`. 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 Expect the Component to Perform the Download\n\n`<mds-file>` is a display card, not a download trigger: it has no `href`. It emits `mdsFileDownload` and the consumer must wire the actual download logic to that event.\n\n```html\n<!-- INCORRECT - expecting the component to handle the download itself -->\n<mds-file filename=\"report.pdf\" href=\"/files/report.pdf\"></mds-file>\n\n<!-- CORRECT - consumer listens to the event and handles the download -->\n<mds-file filename=\"report.pdf\" id=\"card-report\"></mds-file>\n\n<script>\n document.getElementById('card-report').addEventListener('mdsFileDownload', (e) => {\n window.location.href = '/files/' + e.detail.filename;\n });\n</script>\n```\n\n#### Do Not Set `format` Manually\n\n`format` is an internal reflected attribute automatically derived from the filename and suffix. Setting it directly has no guaranteed effect because the component overwrites it during `componentWillLoad` and on every `filename` change. Use `suffix` to control type detection.\n\n```html\n<!-- INCORRECT -->\n<mds-file filename=\"archivio\" format=\"document\"></mds-file>\n\n<!-- CORRECT - use suffix to override file-type detection -->\n<mds-file filename=\"archivio\" suffix=\"pdf\"></mds-file>\n```\n\n#### Do Not Pierce Shadow DOM to Style the Preview Panel\n\nThe supported customization surface is `--mds-file-preview-*` CSS custom properties. Targeting internal elements with `>>>`, `/deep/`, or undocumented selectors couples your code to the Shadow DOM structure and will break on minor releases.\n\n```css\n/* INCORRECT */\nmds-file >>> .preview {\n background-color: blue;\n}\n\n/* CORRECT */\nmds-file {\n --mds-file-preview-icon-background: rgb(var(--magma-accent-surface-subtle));\n --mds-file-preview-icon-color: rgb(var(--magma-accent-fg));\n}\n```\n\n#### Do Not Wrap `<mds-file>` in a Native Anchor or Button\n\nThe host is already focusable (`tabindex=\"0\"`) and emits its own interaction event. Wrapping it in `<a>` or `<button>` creates nested interactive controls and breaks keyboard semantics.\n\n```html\n<!-- INCORRECT -->\n<a href=\"/download/report.pdf\">\n <mds-file filename=\"report.pdf\"></mds-file>\n</a>\n\n<!-- CORRECT - use the mdsFileDownload event to trigger navigation or download -->\n<mds-file filename=\"report.pdf\" id=\"file-report\"></mds-file>\n\n<script>\n document.getElementById('file-report').addEventListener('mdsFileDownload', () => {\n window.location.href = '/download/report.pdf';\n });\n</script>\n```\n\n#### Do Not Use a Raw `<div>` or `<li>` as a File Row When `<mds-file>` Exists\n\n`<mds-file>` handles format detection, theming, accessibility focus, download persistence, and localization. Rolling a custom file row loses all of these affordances.\n\n```html\n<!-- INCORRECT -->\n<div class=\"file-row\" onclick=\"download('report.pdf')\">\n <img src=\"pdf-icon.svg\" alt=\"PDF\" />\n <span>report.pdf</span>\n</div>\n\n<!-- CORRECT -->\n<mds-file filename=\"report.pdf\"></mds-file>\n```\n"
22
+ "2. Pattern": "Correct and idiomatic ways to use the `<mds-file>` 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 File Card\n\nThe minimal form. Pass `filename` with a real filename (including extension) and the component auto-detects the format icon, badge color, and localized description.\n\n```html\n<mds-file filename=\"relazione-annuale.pdf\"></mds-file>\n```\n\n#### Handling the Download Event\n\nThe component does not fetch or download anything by itself. Listen for `mdsFileDownload` and trigger the actual download in the event handler. The event detail carries `filename`, `extension`, `type`, `description`, and `target`.\n\n```html\n<mds-file filename=\"contratto-servizio.docx\" id=\"file-card\"></mds-file>\n\n<script>\n document.getElementById('file-card').addEventListener('mdsFileDownload', (event) => {\n const { filename, extension, type } = event.detail;\n console.log(`Download avviato: ${filename} (${type})`);\n // avvia il download effettivo dal server\n });\n</script>\n```\n\n#### Forcing a File Type with `suffix`\n\nWhen the filename lacks an extension or carries a misleading one, use `suffix` to force a specific format from the supported set.\n\n```html\n<!-- filename senza estensione - forza il riconoscimento come PDF -->\n<mds-file filename=\"documento-firmato\" suffix=\"pdf\"></mds-file>\n\n<!-- estensione sconosciuta - forzata come archivio ZIP -->\n<mds-file filename=\"backup.bkp\" suffix=\"zip\"></mds-file>\n```\n\n#### Custom Description\n\nOverride the localized auto-generated description with a specific label relevant to the document context. Use `description` when the default type label (e.g. \"Documento Adobe\" for a PDF) is not informative enough.\n\n```html\n<mds-file\n filename=\"verbale-cda-2024.pdf\"\n description=\"Verbale approvato dal Consiglio di Amministrazione\"\n></mds-file>\n```\n\n#### Image Preview\n\nProvide `preview` with an image URL when a meaningful visual thumbnail is available - a logo, a reduced version of an image file, or a document cover. The preview replaces the generic format icon in the left panel.\n\n```html\n<mds-file\n filename=\"logo-aziendale.png\"\n preview=\"https://cdn.example.com/thumbnails/logo-aziendale-128.png\"\n></mds-file>\n```\n\n#### Hiding the \"Already Downloaded\" Indicator\n\nThe component shows a \"done\" indicator once the file has been downloaded, on every later render of the same filename. Add `hide-downloaded-icon` to suppress it when the affordance is not appropriate for the context (e.g. a list where every file is always shown as fresh).\n\n```html\n<mds-file filename=\"modulo-richiesta.xlsx\" hide-downloaded-icon></mds-file>\n```\n\nNote: this is the only valid way to turn the indicator off. Magma 1 used `show-downloaded-icon=\"false\"`; that prop no longer exists (the codemod turns it into `hide-downloaded-icon`).\n\n#### Rendering a List of Files\n\nPlace multiple `<mds-file>` cards inside a container and attach a single delegated event listener when the file list is dynamic.\n\n```html\n<div class=\"file-list\">\n <mds-file filename=\"allegato-1.pdf\"></mds-file>\n <mds-file filename=\"allegato-2.docx\"></mds-file>\n <mds-file filename=\"allegato-3.xlsx\"></mds-file>\n</div>\n\n<script>\n document.querySelector('.file-list').addEventListener('mdsFileDownload', (event) => {\n const { filename } = event.detail;\n avviaDownload(filename);\n });\n</script>\n```\n\n#### Styling Customization\n\nStyle the preview panel only through its public `--mds-file-preview-color` CSS custom property. Use the semantic color roles via `rgb(var(--magma-<role>))` so dark mode and high-contrast modes keep working.\n\n```css\n.archivio-documenti mds-file {\n --mds-file-preview-color: rgb(var(--magma-accent-fg));\n}\n```\n",
23
+ "3. Antipattern": "Common incorrect uses of `<mds-file>`. 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 Expect the Component to Perform the Download\n\n`<mds-file>` is a display card, not a download trigger: it has no `href`. It emits `mdsFileDownload` and the consumer must wire the actual download logic to that event.\n\n```html\n<!-- INCORRECT - expecting the component to handle the download itself -->\n<mds-file filename=\"report.pdf\" href=\"/files/report.pdf\"></mds-file>\n\n<!-- CORRECT - consumer listens to the event and handles the download -->\n<mds-file filename=\"report.pdf\" id=\"card-report\"></mds-file>\n\n<script>\n document.getElementById('card-report').addEventListener('mdsFileDownload', (e) => {\n window.location.href = '/files/' + e.detail.filename;\n });\n</script>\n```\n\n#### Do Not Set `format` Manually\n\n`format` is an internal reflected attribute automatically derived from the filename and suffix. Setting it directly has no guaranteed effect because the component overwrites it during `componentWillLoad` and on every `filename` change. Use `suffix` to control type detection.\n\n```html\n<!-- INCORRECT -->\n<mds-file filename=\"archivio\" format=\"document\"></mds-file>\n\n<!-- CORRECT - use suffix to override file-type detection -->\n<mds-file filename=\"archivio\" suffix=\"pdf\"></mds-file>\n```\n\n#### Do Not Pierce Shadow DOM to Style the Preview Panel\n\nThe supported customization surface is the public `--mds-file-preview-color` CSS custom property. Targeting internal elements with `>>>`, `/deep/`, or undocumented selectors couples your code to the Shadow DOM structure and will break on minor releases.\n\n```css\n/* INCORRECT */\nmds-file >>> .preview {\n background-color: blue;\n}\n\n/* CORRECT */\nmds-file {\n --mds-file-preview-color: rgb(var(--magma-accent-fg));\n}\n```\n\n#### Do Not Wrap `<mds-file>` in a Native Anchor or Button\n\nThe host is already focusable (`tabindex=\"0\"`) and emits its own interaction event. Wrapping it in `<a>` or `<button>` creates nested interactive controls and breaks keyboard semantics.\n\n```html\n<!-- INCORRECT -->\n<a href=\"/download/report.pdf\">\n <mds-file filename=\"report.pdf\"></mds-file>\n</a>\n\n<!-- CORRECT - use the mdsFileDownload event to trigger navigation or download -->\n<mds-file filename=\"report.pdf\" id=\"file-report\"></mds-file>\n\n<script>\n document.getElementById('file-report').addEventListener('mdsFileDownload', () => {\n window.location.href = '/download/report.pdf';\n });\n</script>\n```\n\n#### Do Not Use a Raw `<div>` or `<li>` as a File Row When `<mds-file>` Exists\n\n`<mds-file>` handles format detection, theming, accessibility focus, download persistence, and localization. Rolling a custom file row loses all of these affordances.\n\n```html\n<!-- INCORRECT -->\n<div class=\"file-row\" onclick=\"download('report.pdf')\">\n <img src=\"pdf-icon.svg\" alt=\"PDF\" />\n <span>report.pdf</span>\n</div>\n\n<!-- CORRECT -->\n<mds-file filename=\"report.pdf\"></mds-file>\n```\n"
19
24
  },
20
25
  "props": [
21
26
  {
@@ -447,17 +452,20 @@
447
452
  {
448
453
  "name": "--mds-file-preview-color",
449
454
  "annotation": "prop",
450
- "docs": "Sets the text color used in the file preview"
455
+ "docs": "Sets the text color used in the file preview",
456
+ "visibility": "public"
451
457
  },
452
458
  {
453
459
  "name": "--mds-file-preview-icon-background",
454
460
  "annotation": "prop",
455
- "docs": "Sets the background color of the file preview icon"
461
+ "docs": "Sets the background color of the file preview icon",
462
+ "visibility": "internal"
456
463
  },
457
464
  {
458
465
  "name": "--mds-file-preview-icon-color",
459
466
  "annotation": "prop",
460
- "docs": "Sets the color of the file preview icon"
467
+ "docs": "Sets the color of the file preview icon",
468
+ "visibility": "internal"
461
469
  }
462
470
  ],
463
471
  "slots": [],
@@ -26,7 +26,7 @@ mds-text {
26
26
 
27
27
  /**
28
28
  * @prop --mds-file-preview-icon-color: Sets the color of the file preview icon
29
- * @prop --mds-file-preview-color: Sets the text color used in the file preview
29
+ * @prop --mds-file-preview-color: Public. Sets the text color used in the file preview
30
30
  * @prop --mds-file-preview-icon-background: Sets the background color of the file preview icon
31
31
  */
32
32
 
@@ -16,6 +16,9 @@ import fileDescriptionLocaleEn from "../../meta/file-format/locale.en";
16
16
  import fileDescriptionLocaleEs from "../../meta/file-format/locale.es";
17
17
  import fileDescriptionLocaleIt from "../../meta/file-format/locale.it";
18
18
  // https://stackoverflow.com/questions/1106377/detect-when-a-browser-receives-a-file-download
19
+ /**
20
+ * @category content
21
+ */
19
22
  export class MdsFile {
20
23
  constructor() {
21
24
  this.t = new Locale({
@@ -82,7 +85,7 @@ export class MdsFile {
82
85
  }
83
86
  render() {
84
87
  var _a, _b;
85
- return (h(Host, { key: '53746fbb1145f4bb2bd39e725f60d2be675d5a3f', tabindex: "0", onClick: this.handleOnClick, "pref-animation": preferenceStore.state.animation, "pref-contrast": preferenceStore.state.contrast, "pref-mode": preferenceStore.state.mode, "pref-theme-scheme": preferenceStore.state['theme-scheme'] }, h("div", { key: '8d301692ca81109f7df9262880f37040b657332e', class: "preview" }, this.preview !== undefined ? (h("div", { class: "image-preview", style: { backgroundImage: `url(${this.preview})` } })) : (h("mds-icon", { class: "icon-preview", name: getFormatsVariant(this.filename, this.suffix).icon })), h("div", { key: 'a77c320d48feec69eea904a146c207cdb578efcf', class: "download-icon" }, h("mds-icon", { key: '65a27a8bcd2d7c0b9ec187fbd5ce7975e6c2b49c', name: miOutlineFileDownload }))), h("div", { key: '42e8ea27fa5db7cac80714016579b094dab27897', class: "info" }, h("div", { key: 'c9354c9d8f86f6ec1ca044fc28a053d21f777763', class: "filename", title: this.filename }, h("mds-text", { key: 'a8751ac4a3d9d18c00716bd8770ded50a7a1748d', truncate: "word", typography: "h6", class: "name" }, getName(this.filename)), this.suffix === undefined && getSuffix(this.filename, this.suffix) && (h("mds-text", { key: '37b83ff4c57be14c855603bace0cdd1e8e618f3d', typography: "h6", class: "extension" }, ".", getSuffix(this.filename, this.suffix)))), h("div", { key: '847cc026b8b0ef4a6aced6bb6399cf9a7b7c394d', class: "detail" }, getSuffix(this.filename, this.suffix) && (h("mds-badge", { key: '1dd3c5344f923c41cc540a678c7951599442fbe3', variant: getFormatsVariant(this.filename, this.suffix).variant, tone: "weak", class: "suffix" }, getSuffix(this.filename, this.suffix))), h("mds-text", { key: 'c52e5078a14e7a184813bcb6aa5453a628b58165', truncate: "word", typography: "caption", class: "description", title: (_a = this.description) !== null && _a !== void 0 ? _a : this.t.get(this.getDefaultDescription()) }, (_b = this.description) !== null && _b !== void 0 ? _b : this.t.get(this.getDefaultDescription())))), this.wasDownloaded && !this.hideDownloadedIcon && (h("div", { key: '8d87096b1ce9e8af365a8397ebfe0e820f783f56', class: "indicator" }, h("i", { key: 'c78d658d0a4b36e96d3a2db2bd13f19d984e08f5', class: "downloaded", innerHTML: miBaselineFileDownloadDone, title: this.t.get('alreadyDownloaded') })))));
88
+ return (h(Host, { key: '30c60e46f6cb17edef3b81e7dfd20df5548ef08a', tabindex: "0", onClick: this.handleOnClick, "pref-animation": preferenceStore.state.animation, "pref-contrast": preferenceStore.state.contrast, "pref-mode": preferenceStore.state.mode, "pref-theme-scheme": preferenceStore.state['theme-scheme'] }, h("div", { key: 'a024f1745c39571017e3e610f4deaa3146074b6c', class: "preview" }, this.preview !== undefined ? (h("div", { class: "image-preview", style: { backgroundImage: `url(${this.preview})` } })) : (h("mds-icon", { class: "icon-preview", name: getFormatsVariant(this.filename, this.suffix).icon })), h("div", { key: 'a15dd1bf7b3104430bb81a31852b98a150697c24', class: "download-icon" }, h("mds-icon", { key: 'ef11007fd67a4700f07d6e921a6175e14f725c7b', name: miOutlineFileDownload }))), h("div", { key: '1376715b06dda62df34b17b2dc0ec9f0c3926517', class: "info" }, h("div", { key: '20f2a80d440c1341c8e3b9f935e1db959159c849', class: "filename", title: this.filename }, h("mds-text", { key: 'a0389a8f0b347114e6581b1529b35e1bf4b3ae6d', truncate: "word", typography: "h6", class: "name" }, getName(this.filename)), this.suffix === undefined && getSuffix(this.filename, this.suffix) && (h("mds-text", { key: '4355d3c7e0d5afd0ac3d9ddf9cbc7c7f6a1af7e5', typography: "h6", class: "extension" }, ".", getSuffix(this.filename, this.suffix)))), h("div", { key: '3a46b08a5fc5a8fff303e6a4746d0d0dab868c34', class: "detail" }, getSuffix(this.filename, this.suffix) && (h("mds-badge", { key: 'bfc09f8aede695c9f923eda80393d3d1c5ce2c31', variant: getFormatsVariant(this.filename, this.suffix).variant, tone: "weak", class: "suffix" }, getSuffix(this.filename, this.suffix))), h("mds-text", { key: '63e73da12727accd2b9a56a646c11a792e43c177', truncate: "word", typography: "caption", class: "description", title: (_a = this.description) !== null && _a !== void 0 ? _a : this.t.get(this.getDefaultDescription()) }, (_b = this.description) !== null && _b !== void 0 ? _b : this.t.get(this.getDefaultDescription())))), this.wasDownloaded && !this.hideDownloadedIcon && (h("div", { key: '2222fc601e7baa37f263a733a30195ae4c253b22', class: "indicator" }, h("i", { key: '1b63300cf59d99ac8b4036e75cc804271d1ecc6f', class: "downloaded", innerHTML: miBaselineFileDownloadDone, title: this.t.get('alreadyDownloaded') })))));
86
89
  }
87
90
  static get is() { return "mds-file"; }
88
91
  static get encapsulation() { return "shadow"; }
@@ -98,12 +98,10 @@ Place multiple `<mds-file>` cards inside a container and attach a single delegat
98
98
 
99
99
  #### Styling Customization
100
100
 
101
- Style the preview panel only through the three documented `--mds-file-*` CSS custom properties. Use the semantic color roles via `rgb(var(--magma-<role>))` so dark mode and high-contrast modes keep working.
101
+ Style the preview panel only through its public `--mds-file-preview-color` CSS custom property. Use the semantic color roles via `rgb(var(--magma-<role>))` so dark mode and high-contrast modes keep working.
102
102
 
103
103
  ```css
104
104
  .archivio-documenti mds-file {
105
- --mds-file-preview-icon-color: rgb(var(--magma-accent-fg));
106
- --mds-file-preview-icon-background: rgb(var(--magma-accent-surface-subtle));
107
105
  --mds-file-preview-color: rgb(var(--magma-accent-fg));
108
106
  }
109
107
  ```
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-file-preview
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.6.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
10
10
 
11
11
  The `<mds-file-preview>` web component is the Magma Design System card that previews an uploaded or referenced file, surfacing its name, size, type, and a format-aware icon or thumbnail. It pairs with `<mds-input-upload>` to represent each attached file and adds download/delete affordances around the bare file metadata.
12
12
 
@@ -79,8 +79,8 @@ The shared `variant` / `tone` ladders are defined in [`agents/variants.md`](../.
79
79
  | `--mds-file-preview-background-color` | Sets the background color of the file preview container |
80
80
  | `--mds-file-preview-border-radius` | Sets the border-radius of the file preview container |
81
81
  | `--mds-file-preview-color` | Sets the text color used inside the file preview |
82
- | `--mds-file-preview-icon-background` | Sets the background color of the file preview icon |
83
- | `--mds-file-preview-icon-color` | Sets the color of the file preview icon |
82
+
83
+ Only these are public. Its other 2 are internal: they may change in any release, do not set them.
84
84
 
85
85
  ## Dependencies
86
86
 
@@ -120,7 +120,7 @@ mds-file-preview >>> .file-name {
120
120
 
121
121
  /* CORRECT */
122
122
  mds-file-preview {
123
- --mds-file-preview-icon-color: rgb(var(--magma-accent-fg));
123
+ --mds-file-preview-color: rgb(var(--magma-accent-fg));
124
124
  --mds-file-preview-background-color: rgb(var(--magma-accent-surface-subtle));
125
125
  }
126
126
  mds-file-preview::part(card) {
@@ -1,5 +1,5 @@
1
1
  {
2
- "timestamp": "2026-10-22T13:02:36",
2
+ "timestamp": "2026-10-24T12:14:05",
3
3
  "compiler": {
4
4
  "name": "@stencil/core",
5
5
  "version": "4.45.2",
@@ -15,12 +15,16 @@
15
15
  {
16
16
  "name": "part",
17
17
  "text": "card - The preview of the file: its thumbnail or format icon, its name and its details"
18
+ },
19
+ {
20
+ "name": "category",
21
+ "text": "content"
18
22
  }
19
23
  ],
20
24
  "usage": {
21
25
  "1. Description": "The `<mds-file-preview>` web component is the Magma Design System card that previews an uploaded or referenced file, surfacing its name, size, type, and a format-aware icon or thumbnail. It pairs with `<mds-input-upload>` to represent each attached file and adds download/delete affordances around the bare file metadata.\n\n#### Semantic Behavior\n\n- **Format auto-detection**: The `filename` extension determines the icon, badge colour, and human-readable description; `suffix` forces a specific known format and `format` is the resolved category.\n- **Download interaction**: With `downloadable` the card is a button in the tab order: a click, Enter or Space emits `mdsFileDownload` with `{ target, filename, extension }`, once. Without it the card is not interactive and emits nothing. `downloadable` renders no download icon.\n- **Delete affordance**: When `deletable` is set, a light icon button renders in the corner and emits `mdsFileDelete` with the same detail payload, leaving the actual removal to the consumer.\n- **Filesize formatting**: A numeric `filesize` string is treated as bytes and formatted automatically; any non-numeric string is shown verbatim.\n- **Preview vs. icon vs. status**: A thumbnail renders only when `src` is set, the format supports preview, and no `message` is present; otherwise a format icon is shown, and when `message` is present the card switches to a status layout displaying that feedback text.\n- **Localization**: Default type descriptions and action titles resolve through the locale system (el/en/es/it).\n\n#### Properties & Visual Configurations\n\n- **`filename`** is the source of truth: beyond being the title, it drives icon, badge, and description inference, so prefer a real name with extension over a cosmetic label.\n- **`suffix`** overrides extension detection when the filename is unreliable or missing an extension; pick from the known format set rather than passing the description directly.\n- **`description`** overrides only the textual filetype caption, leaving icon and badge inference intact. The caption is shown only without `filesize`; with a size it stays as the badge tooltip.\n- **`src`** supplies a thumbnail (e.g. a logo or downscaled image) shown in place of the generic icon when the format is previewable and no message is active.\n- **`message`** turns the card into a feedback/status state (validation, error, progress text) and suppresses the thumbnail.\n\n#### Component-specific variants and tones\n\nThe shared `variant` / `tone` ladders are defined in [`agents/variants.md`](../../../../agents/variants.md). `variant` here is an avatar-flavored value and is rendered **only when `message` is set**, coloring the status layout; the format badge derives its own colour from the detected filetype independently (its tone is always `weak`).\n\n#### Other behavioral props\n\n- **`icon`** overrides the auto-detected glyph with a Magma icon slug, an inline `<svg ...>` string or a `data:image/svg+xml;base64,` URI.\n- **`truncate`** controls how the filename is shortened when it overflows, defaulting to `'word'`.\n",
22
- "2. Pattern": "Correct and idiomatic ways to use the `<mds-file-preview>` 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#### Minimal File Card\n\nThe required prop is `filename`. The component infers icon, badge colour, and type description automatically from the extension. Always pass a real filename with extension.\n\n```html\n<mds-file-preview filename=\"relazione-annuale.pdf\"></mds-file-preview>\n```\n\n#### File Card with Size\n\nPass `filesize` as a numeric byte count and the component formats it automatically (JEDEC: KB, MB, GB). Pass a plain string to show a pre-formatted label verbatim.\n\n```html\n<!-- Numeric bytes - auto-formatted to \"9.77 MB\" -->\n<mds-file-preview filename=\"contratto.docx\" filesize=\"10248594\"></mds-file-preview>\n\n<!-- Pre-formatted string - shown verbatim -->\n<mds-file-preview filename=\"archivio.zip\" filesize=\"12 MB\"></mds-file-preview>\n```\n\n#### Download Interaction\n\nAdd `downloadable` to make the whole card a button: the component emits `mdsFileDownload` with `{ target, filename, extension }` on a click, Enter or Space. Without `downloadable` the card emits nothing. Listen to the event; do not add a click handler on a wrapper element.\n\n```html\n<mds-file-preview\n filename=\"documento.pdf\"\n filesize=\"2048000\"\n downloadable\n></mds-file-preview>\n```\n\n```javascript\ndocument.querySelector('mds-file-preview').addEventListener('mdsFileDownload', (e) => {\n const { filename, extension } = e.detail;\n console.log('Download richiesto:', filename, extension);\n});\n```\n\n#### Delete Affordance\n\nAdd `deletable` to show a dismiss button in the top-right corner. The component emits `mdsFileDelete` with `{ target, filename, extension }`. The consumer is responsible for removing the element from the DOM.\n\n```html\n<mds-file-preview\n filename=\"bozza.docx\"\n filesize=\"512000\"\n deletable\n></mds-file-preview>\n```\n\n```javascript\ndocument.querySelector('mds-file-preview').addEventListener('mdsFileDelete', (e) => {\n e.detail.target.remove();\n});\n```\n\n#### Image Thumbnail\n\nSet `src` to show a thumbnail instead of the generic icon. The thumbnail renders only when the format supports preview (images) and no `message` is set; other formats fall back to the icon.\n\n```html\n<mds-file-preview\n filename=\"foto-profilo.jpg\"\n filesize=\"84791746\"\n src=\"./thumbnails/foto-profilo-thumb.webp\"\n></mds-file-preview>\n```\n\n#### Status / Feedback State\n\nSet `message` to switch the card to a feedback layout - the thumbnail is suppressed and the text is displayed alongside the icon. Pair with `variant` to colour the status region semantically. `variant` has no visual effect without `message`.\n\n```html\n<!-- Errore di formato -->\n<mds-file-preview\n filename=\"documento.exe\"\n message=\"Formato file non consentito\"\n variant=\"error\"\n></mds-file-preview>\n\n<!-- Caricamento in corso -->\n<mds-file-preview\n filename=\"video.mp4\"\n filesize=\"52428800\"\n message=\"Caricamento in corso...\"\n variant=\"info\"\n></mds-file-preview>\n```\n\n#### Overriding Format Detection\n\nUse `suffix` to force a known extension category when the filename has no extension or the extension is ambiguous. Use `description` to override only the textual type caption while leaving icon and badge inference intact.\n\n```html\n<!-- Force suffix when filename has no extension -->\n<mds-file-preview filename=\"report\" suffix=\"pdf\"></mds-file-preview>\n\n<!-- Custom description label, icon unchanged -->\n<mds-file-preview\n filename=\"modulo.pdf\"\n description=\"Modulo di iscrizione\"\n></mds-file-preview>\n```\n\n#### Custom Icon\n\nSet `icon` to override the auto-detected glyph with any icon slug from the Magma library, or a `data:image/svg+xml;base64,` URI for a dynamic icon from an API.\n\n```html\n<!-- Named icon slug -->\n<mds-file-preview\n filename=\"report.csv\"\n filesize=\"32768\"\n icon=\"mi/baseline/table-chart\"\n></mds-file-preview>\n```\n\n#### Filename Truncation\n\n`truncate` defaults to `word`, which keeps the filename on one line with an ellipsis. Use `all` to clamp it to two lines with an ellipsis. Use `none` to allow the filename to wrap freely.\n\n```html\n<mds-file-preview\n filename=\"Questo-e-uno-dei-nomi-file-piu-lunghi-che-lumanita-abbia-mai-visto.docx\"\n filesize=\"84791746\"\n truncate=\"all\"\n></mds-file-preview>\n```\n\n#### Inside `mds-input-upload`\n\n`<mds-file-preview>` is the child card rendered by [`mds-input-upload`](../mds-input-upload/AGENTS.md). When integrating with the upload component, let `mds-input-upload` manage the cards rather than instantiating `mds-file-preview` directly.\n\n```html\n<mds-input-upload\n max-files=\"5\"\n accept=\".pdf,.docx\"\n></mds-input-upload>\n```\n\n#### Styling Customization\n\nStyle the card only through its documented `--mds-file-preview-*` CSS custom properties. Set them on the host or a parent selector; use the semantic color roles via `rgb(var(--magma-<role>))` and the `--magma-radius-*` scale so dark mode and the corner geometry keep working.\n\n```css\n.carta-allegato mds-file-preview {\n --mds-file-preview-background-color: rgb(var(--magma-accent-surface-subtle));\n --mds-file-preview-border-radius: var(--magma-radius-md);\n --mds-file-preview-icon-background: rgb(var(--magma-accent-emphasis));\n --mds-file-preview-icon-color: rgb(var(--magma-accent-on-emphasis));\n}\n```\n",
23
- "3. Antipattern": "Common incorrect uses of `<mds-file-preview>`. 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 Pass a Label Instead of a Real Filename\n\n`filename` drives automatic icon, badge, and description inference. Passing a cosmetic label without an extension produces the generic fallback icon and no badge, losing all format-aware information.\n\n```html\n<!-- INCORRECT -->\n<mds-file-preview filename=\"Contratto\"></mds-file-preview>\n\n<!-- CORRECT -->\n<mds-file-preview filename=\"contratto-2024.pdf\"></mds-file-preview>\n```\n\n#### Do Not Set `variant` Without `message`\n\n`variant` colours the status layout that is only rendered when `message` is set. Setting `variant` alone has no visual effect and misleads readers of the code into thinking the card is themed.\n\n```html\n<!-- INCORRECT -->\n<mds-file-preview filename=\"report.pdf\" variant=\"error\"></mds-file-preview>\n\n<!-- CORRECT -->\n<mds-file-preview\n filename=\"report.pdf\"\n message=\"File danneggiato\"\n variant=\"error\"\n></mds-file-preview>\n```\n\n#### Do Not Listen for Native `click` to Handle Downloads\n\nThe component emits `mdsFileDownload` with the file detail when the card is clicked. Attaching an outer `click` handler bypasses the detail payload and also fires for clicks on the delete button.\n\n```html\n<!-- INCORRECT -->\n<div onclick=\"handleClick()\">\n <mds-file-preview filename=\"documento.docx\" downloadable></mds-file-preview>\n</div>\n\n<!-- CORRECT -->\n<mds-file-preview filename=\"documento.docx\" downloadable></mds-file-preview>\n```\n\n```javascript\n// INCORRECT - native click on a wrapper\ndocument.querySelector('div').addEventListener('click', handleClick);\n\n// CORRECT - documented mdsFileDownload event\ndocument.querySelector('mds-file-preview').addEventListener('mdsFileDownload', (e) => {\n download(e.detail.filename);\n});\n```\n\n#### Do Not Remove the Element Yourself Without Listening to `mdsFileDelete`\n\n`deletable` makes the delete button visible but leaves removal to the consumer. Removing the element from a `click` listener on the host - rather than `mdsFileDelete` - fires on any click inside the card, not only on the delete button, and bypasses the detail payload.\n\n```html\n<!-- INCORRECT -->\n<mds-file-preview filename=\"allegato.zip\" deletable onclick=\"this.remove()\"></mds-file-preview>\n\n<!-- CORRECT -->\n<mds-file-preview filename=\"allegato.zip\" deletable></mds-file-preview>\n```\n\n```javascript\ndocument.querySelector('mds-file-preview').addEventListener('mdsFileDelete', (e) => {\n e.detail.target.remove();\n});\n```\n\n#### Do Not Wrap `mds-file-preview` in an Anchor to Add Download\n\nWrapping a card in `<a href=\"...\">` nests an already-interactive card (and its delete button, when `deletable`) inside a link, which fails accessibility audits. Use `downloadable` and handle `mdsFileDownload` instead.\n\n```html\n<!-- INCORRECT -->\n<a href=\"/files/documento.pdf\" download>\n <mds-file-preview filename=\"documento.pdf\"></mds-file-preview>\n</a>\n\n<!-- CORRECT -->\n<mds-file-preview filename=\"documento.pdf\" downloadable></mds-file-preview>\n```\n\n#### Do Not Use `suffix` to Pass a Free-Form String\n\n`suffix` accepts only values from the documented `ExtensionSuffixType` union (e.g. `\"pdf\"`, `\"docx\"`, `\"jpg\"`). Passing an unsupported string silently falls back to the default icon and loses format inference.\n\n```html\n<!-- INCORRECT -->\n<mds-file-preview filename=\"report\" suffix=\"documento-word\"></mds-file-preview>\n\n<!-- CORRECT -->\n<mds-file-preview filename=\"report\" suffix=\"docx\"></mds-file-preview>\n```\n\n#### Customize via Documented Vars and the `card` Part Only\n\nThe only documented shadow part is `card`. Targeting inner selectors via `::part()`, `>>>`, or attribute hacks couples code to internal Shadow DOM structure and will break on minor releases.\n\n```css\n/* INCORRECT */\nmds-file-preview::part(icon) {\n width: 48px;\n}\nmds-file-preview >>> .file-name {\n font-size: 1rem;\n}\n\n/* CORRECT */\nmds-file-preview {\n --mds-file-preview-icon-color: rgb(var(--magma-accent-fg));\n --mds-file-preview-background-color: rgb(var(--magma-accent-surface-subtle));\n}\nmds-file-preview::part(card) {\n padding: calc(var(--spacing) * 600);\n}\n```\n"
26
+ "2. Pattern": "Correct and idiomatic ways to use the `<mds-file-preview>` 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#### Minimal File Card\n\nThe required prop is `filename`. The component infers icon, badge colour, and type description automatically from the extension. Always pass a real filename with extension.\n\n```html\n<mds-file-preview filename=\"relazione-annuale.pdf\"></mds-file-preview>\n```\n\n#### File Card with Size\n\nPass `filesize` as a numeric byte count and the component formats it automatically (JEDEC: KB, MB, GB). Pass a plain string to show a pre-formatted label verbatim.\n\n```html\n<!-- Numeric bytes - auto-formatted to \"9.77 MB\" -->\n<mds-file-preview filename=\"contratto.docx\" filesize=\"10248594\"></mds-file-preview>\n\n<!-- Pre-formatted string - shown verbatim -->\n<mds-file-preview filename=\"archivio.zip\" filesize=\"12 MB\"></mds-file-preview>\n```\n\n#### Download Interaction\n\nAdd `downloadable` to make the whole card a button: the component emits `mdsFileDownload` with `{ target, filename, extension }` on a click, Enter or Space. Without `downloadable` the card emits nothing. Listen to the event; do not add a click handler on a wrapper element.\n\n```html\n<mds-file-preview\n filename=\"documento.pdf\"\n filesize=\"2048000\"\n downloadable\n></mds-file-preview>\n```\n\n```javascript\ndocument.querySelector('mds-file-preview').addEventListener('mdsFileDownload', (e) => {\n const { filename, extension } = e.detail;\n console.log('Download richiesto:', filename, extension);\n});\n```\n\n#### Delete Affordance\n\nAdd `deletable` to show a dismiss button in the top-right corner. The component emits `mdsFileDelete` with `{ target, filename, extension }`. The consumer is responsible for removing the element from the DOM.\n\n```html\n<mds-file-preview\n filename=\"bozza.docx\"\n filesize=\"512000\"\n deletable\n></mds-file-preview>\n```\n\n```javascript\ndocument.querySelector('mds-file-preview').addEventListener('mdsFileDelete', (e) => {\n e.detail.target.remove();\n});\n```\n\n#### Image Thumbnail\n\nSet `src` to show a thumbnail instead of the generic icon. The thumbnail renders only when the format supports preview (images) and no `message` is set; other formats fall back to the icon.\n\n```html\n<mds-file-preview\n filename=\"foto-profilo.jpg\"\n filesize=\"84791746\"\n src=\"./thumbnails/foto-profilo-thumb.webp\"\n></mds-file-preview>\n```\n\n#### Status / Feedback State\n\nSet `message` to switch the card to a feedback layout - the thumbnail is suppressed and the text is displayed alongside the icon. Pair with `variant` to colour the status region semantically. `variant` has no visual effect without `message`.\n\n```html\n<!-- Errore di formato -->\n<mds-file-preview\n filename=\"documento.exe\"\n message=\"Formato file non consentito\"\n variant=\"error\"\n></mds-file-preview>\n\n<!-- Caricamento in corso -->\n<mds-file-preview\n filename=\"video.mp4\"\n filesize=\"52428800\"\n message=\"Caricamento in corso...\"\n variant=\"info\"\n></mds-file-preview>\n```\n\n#### Overriding Format Detection\n\nUse `suffix` to force a known extension category when the filename has no extension or the extension is ambiguous. Use `description` to override only the textual type caption while leaving icon and badge inference intact.\n\n```html\n<!-- Force suffix when filename has no extension -->\n<mds-file-preview filename=\"report\" suffix=\"pdf\"></mds-file-preview>\n\n<!-- Custom description label, icon unchanged -->\n<mds-file-preview\n filename=\"modulo.pdf\"\n description=\"Modulo di iscrizione\"\n></mds-file-preview>\n```\n\n#### Custom Icon\n\nSet `icon` to override the auto-detected glyph with any icon slug from the Magma library, or a `data:image/svg+xml;base64,` URI for a dynamic icon from an API.\n\n```html\n<!-- Named icon slug -->\n<mds-file-preview\n filename=\"report.csv\"\n filesize=\"32768\"\n icon=\"mi/baseline/table-chart\"\n></mds-file-preview>\n```\n\n#### Filename Truncation\n\n`truncate` defaults to `word`, which keeps the filename on one line with an ellipsis. Use `all` to clamp it to two lines with an ellipsis. Use `none` to allow the filename to wrap freely.\n\n```html\n<mds-file-preview\n filename=\"Questo-e-uno-dei-nomi-file-piu-lunghi-che-lumanita-abbia-mai-visto.docx\"\n filesize=\"84791746\"\n truncate=\"all\"\n></mds-file-preview>\n```\n\n#### Inside `mds-input-upload`\n\n`<mds-file-preview>` is the child card rendered by [`mds-input-upload`](../mds-input-upload/AGENTS.md). When integrating with the upload component, let `mds-input-upload` manage the cards rather than instantiating `mds-file-preview` directly.\n\n```html\n<mds-input-upload\n max-files=\"5\"\n accept=\".pdf,.docx\"\n></mds-input-upload>\n```\n\n#### Styling Customization\n\nStyle the card only through its public `--mds-file-preview-*` CSS custom properties. Set them on the host or a parent selector; use the semantic color roles via `rgb(var(--magma-<role>))` and the `--magma-radius-*` scale so dark mode and the corner geometry keep working.\n\n```css\n.carta-allegato mds-file-preview {\n --mds-file-preview-background-color: rgb(var(--magma-accent-surface-subtle));\n --mds-file-preview-border-radius: var(--magma-radius-md);\n --mds-file-preview-color: rgb(var(--magma-accent-fg));\n}\n```\n",
27
+ "3. Antipattern": "Common incorrect uses of `<mds-file-preview>`. 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 Pass a Label Instead of a Real Filename\n\n`filename` drives automatic icon, badge, and description inference. Passing a cosmetic label without an extension produces the generic fallback icon and no badge, losing all format-aware information.\n\n```html\n<!-- INCORRECT -->\n<mds-file-preview filename=\"Contratto\"></mds-file-preview>\n\n<!-- CORRECT -->\n<mds-file-preview filename=\"contratto-2024.pdf\"></mds-file-preview>\n```\n\n#### Do Not Set `variant` Without `message`\n\n`variant` colours the status layout that is only rendered when `message` is set. Setting `variant` alone has no visual effect and misleads readers of the code into thinking the card is themed.\n\n```html\n<!-- INCORRECT -->\n<mds-file-preview filename=\"report.pdf\" variant=\"error\"></mds-file-preview>\n\n<!-- CORRECT -->\n<mds-file-preview\n filename=\"report.pdf\"\n message=\"File danneggiato\"\n variant=\"error\"\n></mds-file-preview>\n```\n\n#### Do Not Listen for Native `click` to Handle Downloads\n\nThe component emits `mdsFileDownload` with the file detail when the card is clicked. Attaching an outer `click` handler bypasses the detail payload and also fires for clicks on the delete button.\n\n```html\n<!-- INCORRECT -->\n<div onclick=\"handleClick()\">\n <mds-file-preview filename=\"documento.docx\" downloadable></mds-file-preview>\n</div>\n\n<!-- CORRECT -->\n<mds-file-preview filename=\"documento.docx\" downloadable></mds-file-preview>\n```\n\n```javascript\n// INCORRECT - native click on a wrapper\ndocument.querySelector('div').addEventListener('click', handleClick);\n\n// CORRECT - documented mdsFileDownload event\ndocument.querySelector('mds-file-preview').addEventListener('mdsFileDownload', (e) => {\n download(e.detail.filename);\n});\n```\n\n#### Do Not Remove the Element Yourself Without Listening to `mdsFileDelete`\n\n`deletable` makes the delete button visible but leaves removal to the consumer. Removing the element from a `click` listener on the host - rather than `mdsFileDelete` - fires on any click inside the card, not only on the delete button, and bypasses the detail payload.\n\n```html\n<!-- INCORRECT -->\n<mds-file-preview filename=\"allegato.zip\" deletable onclick=\"this.remove()\"></mds-file-preview>\n\n<!-- CORRECT -->\n<mds-file-preview filename=\"allegato.zip\" deletable></mds-file-preview>\n```\n\n```javascript\ndocument.querySelector('mds-file-preview').addEventListener('mdsFileDelete', (e) => {\n e.detail.target.remove();\n});\n```\n\n#### Do Not Wrap `mds-file-preview` in an Anchor to Add Download\n\nWrapping a card in `<a href=\"...\">` nests an already-interactive card (and its delete button, when `deletable`) inside a link, which fails accessibility audits. Use `downloadable` and handle `mdsFileDownload` instead.\n\n```html\n<!-- INCORRECT -->\n<a href=\"/files/documento.pdf\" download>\n <mds-file-preview filename=\"documento.pdf\"></mds-file-preview>\n</a>\n\n<!-- CORRECT -->\n<mds-file-preview filename=\"documento.pdf\" downloadable></mds-file-preview>\n```\n\n#### Do Not Use `suffix` to Pass a Free-Form String\n\n`suffix` accepts only values from the documented `ExtensionSuffixType` union (e.g. `\"pdf\"`, `\"docx\"`, `\"jpg\"`). Passing an unsupported string silently falls back to the default icon and loses format inference.\n\n```html\n<!-- INCORRECT -->\n<mds-file-preview filename=\"report\" suffix=\"documento-word\"></mds-file-preview>\n\n<!-- CORRECT -->\n<mds-file-preview filename=\"report\" suffix=\"docx\"></mds-file-preview>\n```\n\n#### Customize via Documented Vars and the `card` Part Only\n\nThe only documented shadow part is `card`. Targeting inner selectors via `::part()`, `>>>`, or attribute hacks couples code to internal Shadow DOM structure and will break on minor releases.\n\n```css\n/* INCORRECT */\nmds-file-preview::part(icon) {\n width: 48px;\n}\nmds-file-preview >>> .file-name {\n font-size: 1rem;\n}\n\n/* CORRECT */\nmds-file-preview {\n --mds-file-preview-color: rgb(var(--magma-accent-fg));\n --mds-file-preview-background-color: rgb(var(--magma-accent-surface-subtle));\n}\nmds-file-preview::part(card) {\n padding: calc(var(--spacing) * 600);\n}\n```\n"
24
28
  },
25
29
  "props": [
26
30
  {
@@ -719,27 +723,32 @@
719
723
  {
720
724
  "name": "--mds-file-preview-background-color",
721
725
  "annotation": "prop",
722
- "docs": "Sets the background color of the file preview container"
726
+ "docs": "Sets the background color of the file preview container",
727
+ "visibility": "public"
723
728
  },
724
729
  {
725
730
  "name": "--mds-file-preview-border-radius",
726
731
  "annotation": "prop",
727
- "docs": "Sets the border-radius of the file preview container"
732
+ "docs": "Sets the border-radius of the file preview container",
733
+ "visibility": "public"
728
734
  },
729
735
  {
730
736
  "name": "--mds-file-preview-color",
731
737
  "annotation": "prop",
732
- "docs": "Sets the text color used inside the file preview"
738
+ "docs": "Sets the text color used inside the file preview",
739
+ "visibility": "public"
733
740
  },
734
741
  {
735
742
  "name": "--mds-file-preview-icon-background",
736
743
  "annotation": "prop",
737
- "docs": "Sets the background color of the file preview icon"
744
+ "docs": "Sets the background color of the file preview icon",
745
+ "visibility": "internal"
738
746
  },
739
747
  {
740
748
  "name": "--mds-file-preview-icon-color",
741
749
  "annotation": "prop",
742
- "docs": "Sets the color of the file preview icon"
750
+ "docs": "Sets the color of the file preview icon",
751
+ "visibility": "internal"
743
752
  }
744
753
  ],
745
754
  "slots": [],
@@ -27,9 +27,9 @@ mds-text {
27
27
 
28
28
 
29
29
  /**
30
- * @prop --mds-file-preview-background-color: Sets the background color of the file preview container
31
- * @prop --mds-file-preview-border-radius: Sets the border-radius of the file preview container
32
- * @prop --mds-file-preview-color: Sets the text color used inside the file preview
30
+ * @prop --mds-file-preview-background-color: Public. Sets the background color of the file preview container
31
+ * @prop --mds-file-preview-border-radius: Public. Sets the border-radius of the file preview container
32
+ * @prop --mds-file-preview-color: Public. Sets the text color used inside the file preview
33
33
  * @prop --mds-file-preview-icon-background: Sets the background color of the file preview icon
34
34
  * @prop --mds-file-preview-icon-color: Sets the color of the file preview icon
35
35
  */
@@ -16,6 +16,7 @@ import fileDescriptionLocaleEs from "../../meta/file-format/locale.es";
16
16
  import fileDescriptionLocaleIt from "../../meta/file-format/locale.it";
17
17
  /**
18
18
  * @part card - The preview of the file: its thumbnail or format icon, its name and its details
19
+ * @category content
19
20
  */
20
21
  export class MdsFilePreview {
21
22
  constructor() {
@@ -78,9 +79,9 @@ export class MdsFilePreview {
78
79
  var _a, _b, _c, _d, _e, _f, _g;
79
80
  // a removed attribute or a null bound by a framework counts as not set, like an empty value
80
81
  const hasMessage = ((_a = this.message) !== null && _a !== void 0 ? _a : '') !== '';
81
- return (h(Host, { key: 'ccceeecb39e0ce014d80db8278ea827c59f7cb7e', "pref-animation": preferenceStore.state.animation, "pref-contrast": preferenceStore.state.contrast, "pref-mode": preferenceStore.state.mode, "pref-theme-scheme": preferenceStore.state['theme-scheme'] }, this.deletable && (h("mds-button", { key: '18bd3233c61809fc39e6767d6ecb49aa7cd07082', title: this.t.get('remove'), class: "action-delete", icon: miBaselineCancel, variant: "light", onClick: this.onClickDeletedEvent })), h("div", { key: '78b37a7dd81c75fa1996ff0fb75a9b1ff1abb6d0', class: "card", onClick: this.onClickDownloadEvent, part: "card", ref: this.cardRef, role: this.downloadable ? 'button' : undefined, tabindex: this.downloadable ? '0' : undefined }, ((_b = this.src) !== null && _b !== void 0 ? _b : '') !== '' &&
82
+ return (h(Host, { key: 'cf9c83a4636e4bb391dbfef53ebafa3a2c13d9ff', "pref-animation": preferenceStore.state.animation, "pref-contrast": preferenceStore.state.contrast, "pref-mode": preferenceStore.state.mode, "pref-theme-scheme": preferenceStore.state['theme-scheme'] }, this.deletable && (h("mds-button", { key: 'ef240e1c6824370a84944040a573853e8ce637ee', title: this.t.get('remove'), class: "action-delete", icon: miBaselineCancel, variant: "light", onClick: this.onClickDeletedEvent })), h("div", { key: '6880b354db8a345ea2e3411d6d06646410863d78', class: "card", onClick: this.onClickDownloadEvent, part: "card", ref: this.cardRef, role: this.downloadable ? 'button' : undefined, tabindex: this.downloadable ? '0' : undefined }, ((_b = this.src) !== null && _b !== void 0 ? _b : '') !== '' &&
82
83
  !hasMessage &&
83
- getExtensionInfos(this.filename, this.suffix).preview ? (h("mds-img", { src: this.src, class: "preview preview--image", "aspect-ratio": "1/1" })) : (h("div", { class: clsx('preview', hasMessage ? 'preview--status' : 'preview--icon') }, ((_c = this.icon) !== null && _c !== void 0 ? _c : '') !== '' ? (h("mds-icon", { class: "icon", name: this.icon })) : (h("mds-icon", { class: "icon", name: getFormatsVariant(this.filename, this.suffix).icon })), this.message && (h("mds-text", { class: "message", typography: "caption", variant: "info" }, this.message)))), h("mds-text", { key: 'b75b4c9d2a1b8b9e0ed08fdb7bea49cf1a618ada', class: "file-name", typography: "h6", variant: "title", truncate: this.truncate, title: this.filename }, this.filename), h("div", { key: '920765752c32efd20d0d5ed2f6eaa91ec7ac35ef', class: clsx('infos', this.filesize && 'infos--has-file-size') }, this.filesize && this.filesize === Number(this.filesize).toString() && (h("mds-text", { key: '8b0ff0bcf74ec1ef959460968f731799e5ff597c', class: "file-size", truncate: "word", typography: "caption", variant: "info" }, filesize(Number(this.filesize), { standard: 'jedec' }))), this.filesize && this.filesize !== Number(this.filesize).toString() && (h("mds-text", { key: 'd2744f6a13812fa0f9d6905a95adaee0694f294e', class: "file-size", truncate: "word", typography: "caption", variant: "info" }, this.filesize)), getSuffix(this.filename, this.suffix) && (h("mds-badge", { key: '7c8d72a726ce424023be53c8514101c43e92d72b', variant: getFormatsVariant(this.filename, this.suffix).variant, tone: "weak", class: "suffix", title: (_d = this.description) !== null && _d !== void 0 ? _d : this.t.get(this.getDefaultKeyDescription()) }, getSuffix(this.filename, this.suffix))), ((_e = this.filesize) !== null && _e !== void 0 ? _e : '') === '' && (h("mds-text", { key: '8c3d0edb1b594eb9b2c4e14e5f91b0f336cf80a5', class: "description", truncate: "word", typography: "caption", variant: "info", title: (_f = this.description) !== null && _f !== void 0 ? _f : this.t.get(this.getDefaultKeyDescription()) }, (_g = this.description) !== null && _g !== void 0 ? _g : this.t.get(this.getDefaultKeyDescription())))))));
84
+ getExtensionInfos(this.filename, this.suffix).preview ? (h("mds-img", { src: this.src, class: "preview preview--image", "aspect-ratio": "1/1" })) : (h("div", { class: clsx('preview', hasMessage ? 'preview--status' : 'preview--icon') }, ((_c = this.icon) !== null && _c !== void 0 ? _c : '') !== '' ? (h("mds-icon", { class: "icon", name: this.icon })) : (h("mds-icon", { class: "icon", name: getFormatsVariant(this.filename, this.suffix).icon })), this.message && (h("mds-text", { class: "message", typography: "caption", variant: "info" }, this.message)))), h("mds-text", { key: 'ec2bfe4f4738c27f0f1d99a466fa01a4d19202f0', class: "file-name", typography: "h6", variant: "title", truncate: this.truncate, title: this.filename }, this.filename), h("div", { key: '59eb8b6f5c4f466e4ec6b1a8443a5cd691916e2d', class: clsx('infos', this.filesize && 'infos--has-file-size') }, this.filesize && this.filesize === Number(this.filesize).toString() && (h("mds-text", { key: 'b8c72bfb48476b1acb106899ff518aa2aafa3eaf', class: "file-size", truncate: "word", typography: "caption", variant: "info" }, filesize(Number(this.filesize), { standard: 'jedec' }))), this.filesize && this.filesize !== Number(this.filesize).toString() && (h("mds-text", { key: '2d6874a000051b4b5d22b655b46fc1ef5e8b2018', class: "file-size", truncate: "word", typography: "caption", variant: "info" }, this.filesize)), getSuffix(this.filename, this.suffix) && (h("mds-badge", { key: '05c2e209b44033d22d986441171b23b3d4d4c556', variant: getFormatsVariant(this.filename, this.suffix).variant, tone: "weak", class: "suffix", title: (_d = this.description) !== null && _d !== void 0 ? _d : this.t.get(this.getDefaultKeyDescription()) }, getSuffix(this.filename, this.suffix))), ((_e = this.filesize) !== null && _e !== void 0 ? _e : '') === '' && (h("mds-text", { key: '8e01cb5ad8e7747ba6a99a54d8ee7735602212a3', class: "description", truncate: "word", typography: "caption", variant: "info", title: (_f = this.description) !== null && _f !== void 0 ? _f : this.t.get(this.getDefaultKeyDescription()) }, (_g = this.description) !== null && _g !== void 0 ? _g : this.t.get(this.getDefaultKeyDescription())))))));
84
85
  }
85
86
  static get is() { return "mds-file-preview"; }
86
87
  static get encapsulation() { return "shadow"; }
@@ -152,13 +152,12 @@ Set `icon` to override the auto-detected glyph with any icon slug from the Magma
152
152
 
153
153
  #### Styling Customization
154
154
 
155
- Style the card only through its documented `--mds-file-preview-*` CSS custom properties. Set them on the host or a parent selector; use the semantic color roles via `rgb(var(--magma-<role>))` and the `--magma-radius-*` scale so dark mode and the corner geometry keep working.
155
+ Style the card only through its public `--mds-file-preview-*` CSS custom properties. Set them on the host or a parent selector; use the semantic color roles via `rgb(var(--magma-<role>))` and the `--magma-radius-*` scale so dark mode and the corner geometry keep working.
156
156
 
157
157
  ```css
158
158
  .carta-allegato mds-file-preview {
159
159
  --mds-file-preview-background-color: rgb(var(--magma-accent-surface-subtle));
160
160
  --mds-file-preview-border-radius: var(--magma-radius-md);
161
- --mds-file-preview-icon-background: rgb(var(--magma-accent-emphasis));
162
- --mds-file-preview-icon-color: rgb(var(--magma-accent-on-emphasis));
161
+ --mds-file-preview-color: rgb(var(--magma-accent-fg));
163
162
  }
164
163
  ```
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-filter
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.6.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
10
10
 
11
11
  The `<mds-filter>` web component is a compound container that groups a set of `<mds-filter-item>` chips into a single, scrollable filter bar, coordinating their selection state and exposing the active values as one combined change event. It has no native HTML equivalent: it orchestrates its children rather than rendering a control of its own.
12
12
 
@@ -60,14 +60,9 @@ The `<mds-filter>` web component is a compound container that groups a set of `<
60
60
  | --- | --- |
61
61
  | `--mds-filter-items-background` | Sets the background-color of the items row area |
62
62
  | `--mds-filter-items-background-active` | Sets the background-color of the items row area when a filter is active |
63
- | `--mds-filter-items-gap` | Sets the gap between items |
64
- | `--mds-filter-items-padding` | Sets the padding of the items row area |
65
- | `--mds-filter-items-radius` | Sets the border-radius of the items row area |
66
- | `--mds-filter-items-scroll-behavior` | Sets the scroll-behavior animation; |
67
- | `--mds-filter-label-padding` | Sets the padding of the label |
68
63
  | `--mds-filter-wrapper-shadow` | Sets the shadow used as outline border |
69
- | `--mds-filter-wrapper-shadow-color` | Sets the effect of the outline border |
70
- | `--mds-filter-wrapper-shadow-opacity` | Sets the opacity of the outline border |
64
+
65
+ Only these are public. Its other 7 are internal: they may change in any release, do not set them.
71
66
 
72
67
  ## Dependencies
73
68
 
@@ -121,7 +121,7 @@ The `mdsFilterChange` event's `value` field is a comma-joined string of the sele
121
121
 
122
122
  #### Do Not Customize Via Undocumented Shadow Selectors
123
123
 
124
- The supported customization surface for `<mds-filter>` is the documented `--mds-filter-*` CSS custom properties. Piercing the shadow DOM via `>>>` or undocumented `::part()` names couples your code to the implementation and will break on minor releases.
124
+ The supported customization surface for `<mds-filter>` is its public `--mds-filter-*` CSS custom properties. Piercing the shadow DOM via `>>>` or undocumented `::part()` names couples your code to the implementation and will break on minor releases.
125
125
 
126
126
  ```css
127
127
  /* INCORRECT */
@@ -135,6 +135,6 @@ mds-filter::part(items-wrapper) {
135
135
  /* CORRECT */
136
136
  mds-filter {
137
137
  --mds-filter-items-background: rgb(var(--magma-wash-strong));
138
- --mds-filter-wrapper-shadow-color: rgb(var(--magma-accent-border));
138
+ --mds-filter-wrapper-shadow: 0 0 0 calc(var(--spacing) * 50) rgb(var(--magma-accent-border)) inset;
139
139
  }
140
140
  ```