@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
@@ -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-pref-mode",
13
13
  "docs": "",
14
- "docsTags": [],
14
+ "docsTags": [
15
+ {
16
+ "name": "category",
17
+ "text": "preferences"
18
+ }
19
+ ],
15
20
  "usage": {
16
21
  "1. Description": "The `<mds-pref-mode>` web component is the mode preference control of the Magma Design System, usually a direct child of the [`<mds-pref>`](../mds-pref/AGENTS.md) panel. It renders a labelled three-way tab (light / system / dark) that lets the user pick a color-scheme mode and applies it globally to the document.\n\n#### Semantic Behavior\n\n- **Usually inside `<mds-pref>`**: Placed as a direct slot child of `<mds-pref>`, alongside the other `mds-pref-*` controls; it also works on its own, since it applies and stores the mode by itself. What it gives up on its own is in the antipattern docs.\n- **Selection follows `mode`**: The active tab reflects whichever mode is currently applied, driven by the `mode` prop.\n- **Global mode application**: Selecting a mode applies it document-wide and persists the choice.\n- **Persistence on load**: The applied mode resolves from `mode` -> the stored value -> the `system` default, so a previously chosen mode is restored without an explicit prop.\n- **`mdsPrefChange` event**: Emits `mdsPrefChange` with `{ preference: 'mode' }` once per change, after the new mode is applied; a pick of the mode already active and the first application on load do not emit it. It bubbles up to `<mds-pref>`; a mode change needs no reload, so it raises no reload notice.\n- **Instances stay in sync**: Instances mounted together (a hidden `<mds-pref controller>` and a visible settings panel) share the applied mode: a pick in one is mirrored by the others, which neither apply it again nor emit `mdsPrefChange`. A `pref-mode-*` class written on `<html>` by other code is mirrored the same way.\n- **System mode**: The `system` choice follows the OS `prefers-color-scheme` media query to resolve the effective light/dark scheme.\n\n#### Properties & Visual Configurations\n\n- **`mode`**: Sets and reflects the active mode (`light`, `dark`, `system`). Leave it unset to inherit the persisted/default mode; set it explicitly to force a starting mode.\n- **`transition`**: Controls the visual switch between schemes. Use `smooth` (default) for a fading neutral overlay that flips the mode mid-fade, `flash` for an instant switch with a brief overlay pulse, or `none` to apply the new mode with no overlay animation. The overlay timing and z-index are tunable through `--mds-pref-mode-overlay-*` CSS custom properties.\n- **`size`**: Sizes the nested tab items (`sm` / `md`). Inside `<mds-pref>`, set it on the parent instead: the parent's `size` reaches every `mds-pref-*` child on load and when it changes, and overwrites the child's own.\n",
17
- "2. Pattern": "Correct and idiomatic ways to use the `<mds-pref-mode>` component, ordered from most common to most specialized. Patterns assume a working knowledge of the shared preference system documented in [`agents/theming.md`](../../../../agents/theming.md) and the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Default Usage Inside `mds-pref`\n\nThe canonical form. Slot `<mds-pref-mode>` as a direct child of [`<mds-pref>`](../mds-pref/AGENTS.md) with no extra props. The component restores the user's previously persisted mode automatically on load.\n\n```html\n<mds-pref>\n <mds-pref-mode></mds-pref-mode>\n</mds-pref>\n```\n\n#### Setting an Initial Mode\n\nPass `mode` to force the selector to start on a specific mode rather than reading from `localStorage`. Useful when the host application controls preference state centrally. The forced mode is also written to `localStorage` on every load, replacing the user's last choice.\n\n```html\n<mds-pref>\n <mds-pref-mode mode=\"dark\"></mds-pref-mode>\n</mds-pref>\n```\n\n#### Using `system` Mode for OS-Aware Default\n\n`mode=\"system\"` resolves to light or dark based on the OS `prefers-color-scheme` media query. Use this as the explicit starting point when you want the app to follow the OS without the user having to choose.\n\n```html\n<mds-pref>\n <mds-pref-mode mode=\"system\"></mds-pref-mode>\n</mds-pref>\n```\n\n#### Choosing a Transition Style\n\n`transition` controls the visual effect when switching between schemes. Use `smooth` (default) for a mid-fade overlay that hides the color flip, `flash` for an instant switch with a brief full-screen pulse, or `none` for a hard switch with no animation.\n\n```html\n<!-- Smooth fade (default) -->\n<mds-pref-mode transition=\"smooth\"></mds-pref-mode>\n\n<!-- Instant flash pulse -->\n<mds-pref-mode transition=\"flash\"></mds-pref-mode>\n\n<!-- No animation -->\n<mds-pref-mode transition=\"none\"></mds-pref-mode>\n```\n\n#### Listening for Mode Changes\n\nThe component emits `mdsPrefChange` with `{ preference: 'mode' }` once per change, after the new mode is applied, and not on page load; another instance that mirrors the pick does not emit it. Listen for this event to react in application code - for example to sync a preference state store - and read the current value from the `mode` prop.\n\n```html\n<mds-pref>\n <mds-pref-mode id=\"mode-selector\"></mds-pref-mode>\n</mds-pref>\n\n<script>\n document.getElementById('mode-selector').addEventListener('mdsPrefChange', (e) => {\n console.log('Modalita tema cambiata:', e.detail.preference);\n });\n</script>\n```\n\n#### Controlling Size via the Parent\n\n`size` is forwarded to the internal tab items. [`<mds-pref>`](../mds-pref/AGENTS.md) forwards its own `size` to every `mds-pref-*` child, on load and when it changes: set it on the parent to keep the panel at one tab size.\n\n```html\n<mds-pref size=\"sm\">\n <mds-pref-mode></mds-pref-mode>\n <mds-pref-contrast></mds-pref-contrast>\n</mds-pref>\n```\n\n#### Customizing the Transition Overlay\n\nTune the overlay timing and stacking order via the documented `--mds-pref-mode-overlay-*` CSS custom properties. Set them on the host or a parent selector. Use Magma time tokens where available so animations stay in sync with the design system.\n\n```css\nmds-pref-mode {\n --mds-pref-mode-overlay-show-duration: 400ms;\n --mds-pref-mode-overlay-fadeout-duration: 250ms;\n --mds-pref-mode-overlay-z-index: 9000;\n}\n```\n",
18
- "3. Antipattern": "Common incorrect uses of `<mds-pref-mode>`. Each entry pairs the wrong form with the right one and a one-line reason. System-wide rules (boolean-as-string, shadow piercing, Tailwind color utilities, raw native event listening) live in [`agents/anti-patterns.md`](../../../../agents/anti-patterns.md) - they apply here too but are not repeated.\n\n#### Do Not Use `<mds-pref-mode>` Outside `<mds-pref>`\n\n`<mds-pref-mode>` is a compound child: `<mds-pref>` forwards `size` changes to it and locks the mode item that a scheme-constrained `<mds-pref-theme>` forbids (it sets `lockedScheme`). As a standalone widget it still applies and persists the mode, but nothing coordinates it with the theme.\n\n```html\n<!-- INCORRECT -->\n<mds-pref-mode></mds-pref-mode>\n\n<!-- CORRECT -->\n<mds-pref>\n <mds-pref-mode></mds-pref-mode>\n</mds-pref>\n```\n\n#### Do Not Set `transition=\"false\"` to Disable the Overlay\n\n`transition` is a string enum, not a boolean. `\"false\"` is not a valid value: it only happens to fall through to the no-overlay branch, with no guarantee across releases. Use `transition=\"none\"` to opt out of the overlay animation.\n\n```html\n<!-- INCORRECT -->\n<mds-pref-mode transition=\"false\"></mds-pref-mode>\n\n<!-- CORRECT -->\n<mds-pref-mode transition=\"none\"></mds-pref-mode>\n```\n\n#### Do Not Listen for Native `change` Events Instead of `mdsPrefChange`\n\nThe component does not emit or bubble native `change` events out of the shadow DOM. Always listen for the documented `mdsPrefChange` custom event.\n\n```html\n<!-- INCORRECT -->\n<script>\n document.querySelector('mds-pref-mode').addEventListener('change', handler);\n</script>\n\n<!-- CORRECT -->\n<script>\n document.querySelector('mds-pref-mode').addEventListener('mdsPrefChange', handler);\n</script>\n```\n\n#### Do Not Override Mode Classes on `<html>` Directly\n\nThe component manages `pref-mode-light`, `pref-mode-dark`, and `pref-mode-system` classes on `<html>` itself. Adding or removing these by hand races with the component and will be overwritten on the next mode change. Drive the mode exclusively through the `mode` prop.\n\n```html\n<!-- INCORRECT -->\n<script>\n document.documentElement.classList.add('pref-mode-dark');\n</script>\n\n<!-- CORRECT -->\n<mds-pref>\n <mds-pref-mode mode=\"dark\"></mds-pref-mode>\n</mds-pref>\n```\n\n#### Do Not Size Only One Child of the Panel\n\nSetting `size` on `<mds-pref-mode>` alone when siblings exist produces inconsistent tab sizes across the panel. Set it on `<mds-pref>`, which forwards it to every preference child, on load and when it changes.\n\n```html\n<!-- INCORRECT -->\n<mds-pref>\n <mds-pref-mode size=\"sm\"></mds-pref-mode>\n <mds-pref-contrast></mds-pref-contrast>\n</mds-pref>\n\n<!-- CORRECT -->\n<mds-pref size=\"sm\">\n <mds-pref-mode></mds-pref-mode>\n <mds-pref-contrast></mds-pref-contrast>\n</mds-pref>\n```\n\n#### Do Not Target the Injected Overlay to Customize It\n\nThe overlay element is injected into `document.body` at runtime with inline styles, which win over a class selector anyway. Do not target it by class name or adjust its properties through JavaScript. Use the documented `--mds-pref-mode-overlay-*` CSS custom properties instead.\n\n```css\n/* INCORRECT */\n.mds-pref-mode-overlay {\n background-color: black;\n z-index: 99999;\n}\n\n/* CORRECT */\nmds-pref-mode {\n --mds-pref-mode-overlay-show-duration: 400ms;\n --mds-pref-mode-overlay-z-index: 9000;\n}\n```\n"
22
+ "2. Pattern": "Correct and idiomatic ways to use the `<mds-pref-mode>` component, ordered from most common to most specialized. Patterns assume a working knowledge of the shared preference system documented in [`agents/theming.md`](../../../../agents/theming.md) and the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Default Usage Inside `mds-pref`\n\nThe canonical form. Slot `<mds-pref-mode>` as a direct child of [`<mds-pref>`](../mds-pref/AGENTS.md) with no extra props. The component restores the user's previously persisted mode automatically on load.\n\n```html\n<mds-pref>\n <mds-pref-mode></mds-pref-mode>\n</mds-pref>\n```\n\n#### Setting an Initial Mode\n\nPass `mode` to force the selector to start on a specific mode rather than reading from `localStorage`. Useful when the host application controls preference state centrally. The forced mode is also written to `localStorage` on every load, replacing the user's last choice.\n\n```html\n<mds-pref>\n <mds-pref-mode mode=\"dark\"></mds-pref-mode>\n</mds-pref>\n```\n\n#### Using `system` Mode for OS-Aware Default\n\n`mode=\"system\"` resolves to light or dark based on the OS `prefers-color-scheme` media query. Use this as the explicit starting point when you want the app to follow the OS without the user having to choose.\n\n```html\n<mds-pref>\n <mds-pref-mode mode=\"system\"></mds-pref-mode>\n</mds-pref>\n```\n\n#### Choosing a Transition Style\n\n`transition` controls the visual effect when switching between schemes. Use `smooth` (default) for a mid-fade overlay that hides the color flip, `flash` for an instant switch with a brief full-screen pulse, or `none` for a hard switch with no animation.\n\n```html\n<!-- Smooth fade (default) -->\n<mds-pref-mode transition=\"smooth\"></mds-pref-mode>\n\n<!-- Instant flash pulse -->\n<mds-pref-mode transition=\"flash\"></mds-pref-mode>\n\n<!-- No animation -->\n<mds-pref-mode transition=\"none\"></mds-pref-mode>\n```\n\n#### Listening for Mode Changes\n\nThe component emits `mdsPrefChange` with `{ preference: 'mode' }` once per change, after the new mode is applied, and not on page load; another instance that mirrors the pick does not emit it. Listen for this event to react in application code - for example to sync a preference state store - and read the current value from the `mode` prop.\n\n```html\n<mds-pref>\n <mds-pref-mode id=\"mode-selector\"></mds-pref-mode>\n</mds-pref>\n\n<script>\n document.getElementById('mode-selector').addEventListener('mdsPrefChange', (e) => {\n console.log('Modalita tema cambiata:', e.detail.preference);\n });\n</script>\n```\n\n#### Controlling Size via the Parent\n\n`size` is forwarded to the internal tab items. [`<mds-pref>`](../mds-pref/AGENTS.md) forwards its own `size` to every `mds-pref-*` child, on load and when it changes: set it on the parent to keep the panel at one tab size.\n\n```html\n<mds-pref size=\"sm\">\n <mds-pref-mode></mds-pref-mode>\n <mds-pref-contrast></mds-pref-contrast>\n</mds-pref>\n```\n\n#### Customizing the Transition Overlay\n\nTune the overlay stacking order via the public `--mds-pref-mode-overlay-z-index` CSS custom property, when the page has layers above the default one; the overlay timing is set by the component. Set it on the host or a parent selector.\n\n```css\nmds-pref-mode {\n --mds-pref-mode-overlay-z-index: 9000;\n}\n```\n",
23
+ "3. Antipattern": "Common incorrect uses of `<mds-pref-mode>`. Each entry pairs the wrong form with the right one and a one-line reason. System-wide rules (boolean-as-string, shadow piercing, Tailwind color utilities, raw native event listening) live in [`agents/anti-patterns.md`](../../../../agents/anti-patterns.md) - they apply here too but are not repeated.\n\n#### Do Not Use `<mds-pref-mode>` Outside `<mds-pref>`\n\n`<mds-pref-mode>` is a compound child: `<mds-pref>` forwards `size` changes to it and locks the mode item that a scheme-constrained `<mds-pref-theme>` forbids (it sets `lockedScheme`). As a standalone widget it still applies and persists the mode, but nothing coordinates it with the theme.\n\n```html\n<!-- INCORRECT -->\n<mds-pref-mode></mds-pref-mode>\n\n<!-- CORRECT -->\n<mds-pref>\n <mds-pref-mode></mds-pref-mode>\n</mds-pref>\n```\n\n#### Do Not Set `transition=\"false\"` to Disable the Overlay\n\n`transition` is a string enum, not a boolean. `\"false\"` is not a valid value: it only happens to fall through to the no-overlay branch, with no guarantee across releases. Use `transition=\"none\"` to opt out of the overlay animation.\n\n```html\n<!-- INCORRECT -->\n<mds-pref-mode transition=\"false\"></mds-pref-mode>\n\n<!-- CORRECT -->\n<mds-pref-mode transition=\"none\"></mds-pref-mode>\n```\n\n#### Do Not Listen for Native `change` Events Instead of `mdsPrefChange`\n\nThe component does not emit or bubble native `change` events out of the shadow DOM. Always listen for the documented `mdsPrefChange` custom event.\n\n```html\n<!-- INCORRECT -->\n<script>\n document.querySelector('mds-pref-mode').addEventListener('change', handler);\n</script>\n\n<!-- CORRECT -->\n<script>\n document.querySelector('mds-pref-mode').addEventListener('mdsPrefChange', handler);\n</script>\n```\n\n#### Do Not Override Mode Classes on `<html>` Directly\n\nThe component manages `pref-mode-light`, `pref-mode-dark`, and `pref-mode-system` classes on `<html>` itself. Adding or removing these by hand races with the component and will be overwritten on the next mode change. Drive the mode exclusively through the `mode` prop.\n\n```html\n<!-- INCORRECT -->\n<script>\n document.documentElement.classList.add('pref-mode-dark');\n</script>\n\n<!-- CORRECT -->\n<mds-pref>\n <mds-pref-mode mode=\"dark\"></mds-pref-mode>\n</mds-pref>\n```\n\n#### Do Not Size Only One Child of the Panel\n\nSetting `size` on `<mds-pref-mode>` alone when siblings exist produces inconsistent tab sizes across the panel. Set it on `<mds-pref>`, which forwards it to every preference child, on load and when it changes.\n\n```html\n<!-- INCORRECT -->\n<mds-pref>\n <mds-pref-mode size=\"sm\"></mds-pref-mode>\n <mds-pref-contrast></mds-pref-contrast>\n</mds-pref>\n\n<!-- CORRECT -->\n<mds-pref size=\"sm\">\n <mds-pref-mode></mds-pref-mode>\n <mds-pref-contrast></mds-pref-contrast>\n</mds-pref>\n```\n\n#### Do Not Target the Injected Overlay to Customize It\n\nThe overlay element is injected into `document.body` at runtime with inline styles, which win over a class selector anyway. Do not target it by class name or adjust its properties through JavaScript. Use the public `--mds-pref-mode-overlay-z-index` CSS custom property instead.\n\n```css\n/* INCORRECT */\n.mds-pref-mode-overlay {\n background-color: black;\n z-index: 99999;\n}\n\n/* CORRECT */\nmds-pref-mode {\n --mds-pref-mode-overlay-z-index: 9000;\n}\n```\n"
19
24
  },
20
25
  "props": [
21
26
  {
@@ -215,17 +220,20 @@
215
220
  {
216
221
  "name": "--mds-pref-mode-overlay-fadeout-duration",
217
222
  "annotation": "prop",
218
- "docs": "Sets the fadeout duration of the overlay which hides UI color flash on theme change"
223
+ "docs": "Sets the fadeout duration of the overlay which hides UI color flash on theme change",
224
+ "visibility": "internal"
219
225
  },
220
226
  {
221
227
  "name": "--mds-pref-mode-overlay-show-duration",
222
228
  "annotation": "prop",
223
- "docs": "Sets the show duration of the overlay which hides UI color flash on theme change"
229
+ "docs": "Sets the show duration of the overlay which hides UI color flash on theme change",
230
+ "visibility": "internal"
224
231
  },
225
232
  {
226
233
  "name": "--mds-pref-mode-overlay-z-index",
227
234
  "annotation": "prop",
228
- "docs": "Sets the z-index of the overlay which hides UI color flash on theme change"
235
+ "docs": "Sets the z-index of the overlay which hides UI color flash on theme change",
236
+ "visibility": "public"
229
237
  }
230
238
  ],
231
239
  "slots": [],
@@ -15,7 +15,7 @@ mds-text {
15
15
  /**
16
16
  * @prop --mds-pref-mode-overlay-fadeout-duration: Sets the fadeout duration of the overlay which hides UI color flash on theme change
17
17
  * @prop --mds-pref-mode-overlay-show-duration: Sets the show duration of the overlay which hides UI color flash on theme change
18
- * @prop --mds-pref-mode-overlay-z-index: Sets the z-index of the overlay which hides UI color flash on theme change
18
+ * @prop --mds-pref-mode-overlay-z-index: Public. Sets the z-index of the overlay which hides UI color flash on theme change
19
19
  */
20
20
 
21
21
  :host {
@@ -10,6 +10,9 @@ import localeEl from "./meta/locale.el.json";
10
10
  import localeEn from "./meta/locale.en.json";
11
11
  import localeEs from "./meta/locale.es.json";
12
12
  import localeIt from "./meta/locale.it.json";
13
+ /**
14
+ * @category preferences
15
+ */
13
16
  export class MdsPrefMode {
14
17
  constructor() {
15
18
  this.defaultMode = 'system';
@@ -236,7 +239,7 @@ export class MdsPrefMode {
236
239
  }
237
240
  render() {
238
241
  var _a;
239
- return (h(Host, { key: 'c90ace27bbcc9871cb2eda2bdda513a1e17a870b', "pref-contrast": preferenceStore.state.contrast, "pref-mode": preferenceStore.state.mode, "pref-theme-scheme": preferenceStore.state['theme-scheme'] }, h("mds-text", { key: 'a87034357d303ac2b7518c4678ce73145a0c1db2', class: "info", typography: "caption" }, h("b", { key: '808defa5197422f98caa05acfd8029b0c406acd8' }, this.t.get('label')), " ", this.t.get(this.modes[(_a = this.mode) !== null && _a !== void 0 ? _a : this.defaultMode].label)), h("mds-tab", { key: 'd718be92b56f2ac557bf656890b62d66a8511d98', fill: true, size: this.size }, h("mds-tab-item", { key: 'c270f7b5c97ed82197954bf602717435f3e16491', disabled: this.isModeDisabled('light'), selected: this.mode === 'light', onClick: this.handleModeClick('light'), class: "item item--light", icon: miBaselineLightMode, title: this.t.get(this.modes.light.label) }), h("mds-tab-item", { key: 'eebd2655d419493dfdd93dda350488573b52d581', disabled: this.isModeDisabled('system'), selected: this.mode === 'system', onClick: this.handleModeClick('system'), class: "item item--system", icon: miBaselineSettings, title: this.t.get(this.modes.system.label) }), h("mds-tab-item", { key: '20ac8784df7897df0ffe9e5204c89b8a64257e27', disabled: this.isModeDisabled('dark'), selected: this.mode === 'dark', onClick: this.handleModeClick('dark'), class: "item item--dark", icon: this.mode === 'dark' ? miBaselineDarkMode : miOutlineDarkMode, title: this.t.get(this.modes.dark.label) }))));
242
+ return (h(Host, { key: '8cd7d190d15c44c67b89147d4b16404f5cb95800', "pref-contrast": preferenceStore.state.contrast, "pref-mode": preferenceStore.state.mode, "pref-theme-scheme": preferenceStore.state['theme-scheme'] }, h("mds-text", { key: '14cd73bd20d61e354734a351cf991970f0ebc5ec', class: "info", typography: "caption" }, h("b", { key: '86ee2ea0a64ade8fbe329a0f96182c3b67d9ff5e' }, this.t.get('label')), " ", this.t.get(this.modes[(_a = this.mode) !== null && _a !== void 0 ? _a : this.defaultMode].label)), h("mds-tab", { key: '57b1029715dc8e06cc0c8313aef1d97b86e5862f', fill: true, size: this.size }, h("mds-tab-item", { key: '4dfba447dcefe6dbbbbfc15ab1e47431dea40ef0', disabled: this.isModeDisabled('light'), selected: this.mode === 'light', onClick: this.handleModeClick('light'), class: "item item--light", icon: miBaselineLightMode, title: this.t.get(this.modes.light.label) }), h("mds-tab-item", { key: 'ae48429db039f79a022a1888436ab55b477d0556', disabled: this.isModeDisabled('system'), selected: this.mode === 'system', onClick: this.handleModeClick('system'), class: "item item--system", icon: miBaselineSettings, title: this.t.get(this.modes.system.label) }), h("mds-tab-item", { key: '0b56971502285a300258fbebee3e4d1cb9bb11d0', disabled: this.isModeDisabled('dark'), selected: this.mode === 'dark', onClick: this.handleModeClick('dark'), class: "item item--dark", icon: this.mode === 'dark' ? miBaselineDarkMode : miOutlineDarkMode, title: this.t.get(this.modes.dark.label) }))));
240
243
  }
241
244
  static get is() { return "mds-pref-mode"; }
242
245
  static get encapsulation() { return "shadow"; }
@@ -83,12 +83,10 @@ The component emits `mdsPrefChange` with `{ preference: 'mode' }` once per chang
83
83
 
84
84
  #### Customizing the Transition Overlay
85
85
 
86
- Tune the overlay timing and stacking order via the documented `--mds-pref-mode-overlay-*` CSS custom properties. Set them on the host or a parent selector. Use Magma time tokens where available so animations stay in sync with the design system.
86
+ Tune the overlay stacking order via the public `--mds-pref-mode-overlay-z-index` CSS custom property, when the page has layers above the default one; the overlay timing is set by the component. Set it on the host or a parent selector.
87
87
 
88
88
  ```css
89
89
  mds-pref-mode {
90
- --mds-pref-mode-overlay-show-duration: 400ms;
91
- --mds-pref-mode-overlay-fadeout-duration: 250ms;
92
90
  --mds-pref-mode-overlay-z-index: 9000;
93
91
  }
94
92
  ```
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-pref-theme
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-pref-theme>` web component is the theme-switcher segment of the Magma accessibility preferences panel, usually a direct child of [`<mds-pref>`](../mds-pref/AGENTS.md). It renders a labelled tab trigger that opens a dropdown of selectable named themes and, when a theme is chosen, applies it globally to the document.
12
12
 
@@ -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,11 +15,15 @@
15
15
  {
16
16
  "name": "slot",
17
17
  "text": "- Add `mds-pref-theme-item` element/s."
18
+ },
19
+ {
20
+ "name": "category",
21
+ "text": "preferences"
18
22
  }
19
23
  ],
20
24
  "usage": {
21
25
  "1. Description": "The `<mds-pref-theme>` web component is the theme-switcher segment of the Magma accessibility preferences panel, usually a direct child of [`<mds-pref>`](../mds-pref/AGENTS.md). It renders a labelled tab trigger that opens a dropdown of selectable named themes and, when a theme is chosen, applies it globally to the document.\n\n#### Semantic Behavior\n\n- **Usually inside `<mds-pref>`**: Placed as a direct slot child of `<mds-pref>`, alongside the other `mds-pref-*` controls; it also works on its own, since it applies and stores the theme by itself. What it gives up on its own is in the antipattern docs.\n- **Acts as a sub-parent itself**: Its own default slot must contain one or more `mds-pref-theme-item` elements; it drives their selected state so only the active theme is marked selected.\n- **Global theme application**: Selecting an item applies the theme document-wide: it writes `data-theme-name` and the `pref-theme-scheme-*` class on `<html>`.\n- **Persistence and hydration**: The current name, scheme and corner shape are persisted and restored across reloads: a stored value outranks the matching prop.\n- **Validation**: An invalid theme name (not lowercase kebab-case matching `^[a-z]+(-[a-z]+)*$`) is ignored with a console warning when the theme is applied: nothing is written on `<html>` or stored. So are the reserved names `light`, `dark` and `system` (they are mode values) and `scheme` or `scheme-*` (they would collide with the `pref-theme-scheme-*` classes), a `scheme` other than `light`, `dark` or `all`, and a `corner-shape` outside its keywords. A stored value the component cannot apply is dropped, and the prop is used instead.\n- **Events bubbled up**: Emits `mdsPrefThemeChange` with the `{ name, scheme }` detail on each pick, which `<mds-pref>` listens to in order to lock the `<mds-pref-mode>` item a scheme-constrained theme forbids. It also emits `mdsPrefChange` once per change, after applying it: `preference: 'theme'` for a new name or scheme, `'corner-shape'` for a new corner shape. The first application on load and a re-render that changes nothing do not emit it.\n- **Props set after load**: A `name`, `scheme` or `cornerShape` set from a script after load is stored and applied, as a pick is: the stored value outranks the prop only on load. A value the component would not apply is not stored.\n- **Localized label**: The \"Theme\" heading follows the active interface language.\n- **Trigger text**: The closed control shows the `label` of the item for the active theme, the same text the open list shows (localize the items, the trigger follows); when no item matches the active theme it shows the label derived from the name (`dark-blue` -> \"Dark blue\").\n\n#### Properties & Visual Configurations\n\n- **`name`**: The active theme name (default `'default'`); it is overridden at runtime by any persisted value. Use it to declare the initial theme when no preference has been stored yet. The named themes are `cool` and `warm`; `default` is the base theme ([`agents/theming.md`](../../../../agents/theming.md)).\n- **`scheme`**: Constrains the colour modes of the theme to `'light'`, `'dark'`, or `'all'` (default). Pick `'all'` for themes that ship both light and dark palettes; pick `'light'` or `'dark'` to force a single mode for a theme offered in one mode only.\n- **`size`**: Sets the size (`'sm'` / `'md'`) of the nested tab UI. Inside `<mds-pref>`, set it on the parent: it reaches every `mds-pref-*` segment on load and when it changes, and overwrites the segment's own.\n- **`cornerShape`** (attribute `corner-shape`): The corner geometry of the whole page - `round`, `squircle`, `bevel`, `notch`, `scoop`, `square`, or `default`. It writes `data-corner-shape` on `<html>` and is persisted like the theme; `default` removes the attribute, and leaving the prop unset touches nothing ([`agents/theming.md`](../../../../agents/theming.md)).\n",
22
- "2. Pattern": "Correct and idiomatic ways to use the `<mds-pref-theme>` component, ordered from most common to most specialized. Patterns assume a working knowledge of the preferences system documented in [`agents/theming.md`](../../../../agents/theming.md) and the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Basic Theme Chooser\n\nThe canonical form. Place `<mds-pref-theme>` inside [`<mds-pref>`](../mds-pref/AGENTS.md) and populate its default slot with one [`<mds-pref-theme-item>`](../mds-pref-theme-item/AGENTS.md) per available theme. The item whose `name` matches the active theme (the stored choice, or the parent's `name` on a first visit) starts as selected. The named themes are `cool` and `warm`; `default` is the base theme.\n\n```html\n<mds-pref>\n <mds-pref-theme name=\"default\" scheme=\"all\">\n <mds-pref-theme-item label=\"Predefinito\" name=\"default\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item label=\"Freddo\" name=\"cool\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item label=\"Caldo\" name=\"warm\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n```\n\n#### Scheme-Constrained Themes\n\nUse `scheme=\"light\"` or `scheme=\"dark\"` on a `<mds-pref-theme-item>` when the theme must be offered in one colour mode only. The parent component propagates the chosen scheme to `<html>` and forces that mode even if the user's OS or mode preference asks for the opposite; inside `<mds-pref>` the forbidden item of `<mds-pref-mode>` is locked.\n\n```html\n<mds-pref>\n <mds-pref-theme name=\"default\" scheme=\"all\">\n <mds-pref-theme-item label=\"Predefinito\" name=\"default\" scheme=\"all\"></mds-pref-theme-item>\n <!-- light only - dark mode will not activate with this item -->\n <mds-pref-theme-item label=\"Freddo chiaro\" name=\"cool\" scheme=\"light\"></mds-pref-theme-item>\n <!-- dark only -->\n <mds-pref-theme-item label=\"Caldo scuro\" name=\"warm\" scheme=\"dark\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n```\n\n#### Listening for the Change Event\n\nReact to the user's selection via `mdsPrefThemeChange`. The event detail carries `{ name, scheme }` - use them to update any app-level state that tracks the active theme.\n\n```html\n<mds-pref>\n <mds-pref-theme id=\"theme-chooser\" name=\"default\" scheme=\"all\">\n <mds-pref-theme-item label=\"Predefinito\" name=\"default\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item label=\"Freddo\" name=\"cool\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n\n<script>\n document.querySelector('#theme-chooser').addEventListener('mdsPrefThemeChange', (e) => {\n console.log('Tema attivo:', e.detail.name, '- Schema:', e.detail.scheme);\n });\n</script>\n```\n\n#### Declaring the Initial Theme\n\nUse the `name` prop to declare which theme should be active before the user makes a selection. If `localStorage` already holds a persisted value it takes precedence; otherwise the component applies `name` on first render.\n\n```html\n<mds-pref>\n <!-- First-visit default is \"warm\" -->\n <mds-pref-theme name=\"warm\" scheme=\"all\">\n <mds-pref-theme-item label=\"Predefinito\" name=\"default\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item label=\"Caldo\" name=\"warm\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n```\n\n#### Controlling Item Size\n\nPass `size=\"sm\"` when the preferences panel must fit a compact layout: on `<mds-pref>`, which forwards it to every preference control.\n\n```html\n<mds-pref size=\"sm\">\n <mds-pref-theme name=\"default\" scheme=\"all\">\n <mds-pref-theme-item label=\"Predefinito\" name=\"default\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item label=\"Freddo\" name=\"cool\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n```\n\n#### Styling Theme Items\n\nStyle theme items only through their documented `--mds-pref-theme-item-*` CSS custom properties. Set them on the item host or on a parent selector; name a semantic role, `rgb(var(--magma-<role>))` ([`agents/color.md`](../../../../agents/color.md)), so the colours follow the mode, the theme and the contrast preference.\n\n```css\nmds-pref-theme-item {\n --mds-pref-theme-item-color-background: rgb(var(--magma-surface-inverse));\n --mds-pref-theme-item-color-variant-primary: rgb(var(--magma-accent-emphasis));\n}\n```\n",
26
+ "2. Pattern": "Correct and idiomatic ways to use the `<mds-pref-theme>` component, ordered from most common to most specialized. Patterns assume a working knowledge of the preferences system documented in [`agents/theming.md`](../../../../agents/theming.md) and the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Basic Theme Chooser\n\nThe canonical form. Place `<mds-pref-theme>` inside [`<mds-pref>`](../mds-pref/AGENTS.md) and populate its default slot with one [`<mds-pref-theme-item>`](../mds-pref-theme-item/AGENTS.md) per available theme. The item whose `name` matches the active theme (the stored choice, or the parent's `name` on a first visit) starts as selected. The named themes are `cool` and `warm`; `default` is the base theme.\n\n```html\n<mds-pref>\n <mds-pref-theme name=\"default\" scheme=\"all\">\n <mds-pref-theme-item label=\"Predefinito\" name=\"default\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item label=\"Freddo\" name=\"cool\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item label=\"Caldo\" name=\"warm\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n```\n\n#### Scheme-Constrained Themes\n\nUse `scheme=\"light\"` or `scheme=\"dark\"` on a `<mds-pref-theme-item>` when the theme must be offered in one colour mode only. The parent component propagates the chosen scheme to `<html>` and forces that mode even if the user's OS or mode preference asks for the opposite; inside `<mds-pref>` the forbidden item of `<mds-pref-mode>` is locked.\n\n```html\n<mds-pref>\n <mds-pref-theme name=\"default\" scheme=\"all\">\n <mds-pref-theme-item label=\"Predefinito\" name=\"default\" scheme=\"all\"></mds-pref-theme-item>\n <!-- light only - dark mode will not activate with this item -->\n <mds-pref-theme-item label=\"Freddo chiaro\" name=\"cool\" scheme=\"light\"></mds-pref-theme-item>\n <!-- dark only -->\n <mds-pref-theme-item label=\"Caldo scuro\" name=\"warm\" scheme=\"dark\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n```\n\n#### Listening for the Change Event\n\nReact to the user's selection via `mdsPrefThemeChange`. The event detail carries `{ name, scheme }` - use them to update any app-level state that tracks the active theme.\n\n```html\n<mds-pref>\n <mds-pref-theme id=\"theme-chooser\" name=\"default\" scheme=\"all\">\n <mds-pref-theme-item label=\"Predefinito\" name=\"default\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item label=\"Freddo\" name=\"cool\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n\n<script>\n document.querySelector('#theme-chooser').addEventListener('mdsPrefThemeChange', (e) => {\n console.log('Tema attivo:', e.detail.name, '- Schema:', e.detail.scheme);\n });\n</script>\n```\n\n#### Declaring the Initial Theme\n\nUse the `name` prop to declare which theme should be active before the user makes a selection. If `localStorage` already holds a persisted value it takes precedence; otherwise the component applies `name` on first render.\n\n```html\n<mds-pref>\n <!-- First-visit default is \"warm\" -->\n <mds-pref-theme name=\"warm\" scheme=\"all\">\n <mds-pref-theme-item label=\"Predefinito\" name=\"default\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item label=\"Caldo\" name=\"warm\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n```\n\n#### Controlling Item Size\n\nPass `size=\"sm\"` when the preferences panel must fit a compact layout: on `<mds-pref>`, which forwards it to every preference control.\n\n```html\n<mds-pref size=\"sm\">\n <mds-pref-theme name=\"default\" scheme=\"all\">\n <mds-pref-theme-item label=\"Predefinito\" name=\"default\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item label=\"Freddo\" name=\"cool\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n```\n\n#### Styling Theme Items\n\nStyle theme items only through their public `--mds-pref-theme-item-*` CSS custom properties. Set them on the item host or on a parent selector; name a semantic role, `rgb(var(--magma-<role>))` ([`agents/color.md`](../../../../agents/color.md)), so the colours follow the mode, the theme and the contrast preference.\n\n```css\nmds-pref-theme-item {\n --mds-pref-theme-item-color-background: rgb(var(--magma-surface-inverse));\n}\n```\n",
23
27
  "3. Antipattern": "Common incorrect uses of `<mds-pref-theme>`. Each entry pairs the wrong form with the right one and a one-line reason. System-wide rules (boolean-as-string, shadow piercing, Tailwind colour utilities, raw native event listening) live in [`agents/anti-patterns.md`](../../../../agents/anti-patterns.md) - they apply here too but are not repeated.\n\n#### Do Not Use the Component Outside `<mds-pref>`\n\n`<mds-pref-theme>` is a compound sub-part designed to slot inside [`<mds-pref>`](../mds-pref/AGENTS.md). As a standalone widget it still applies and persists the theme, but it leaves the panel: `<mds-pref>` can no longer forward `size` changes to it, nor lock the `<mds-pref-mode>` item that its `scheme` forbids.\n\n```html\n<!-- INCORRECT -->\n<mds-pref-theme name=\"default\" scheme=\"all\">\n <mds-pref-theme-item label=\"Predefinito\" name=\"default\" scheme=\"all\"></mds-pref-theme-item>\n</mds-pref-theme>\n\n<!-- CORRECT -->\n<mds-pref>\n <mds-pref-theme name=\"default\" scheme=\"all\">\n <mds-pref-theme-item label=\"Predefinito\" name=\"default\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n```\n\n#### Do Not Put Plain Text or Arbitrary HTML in the Default Slot\n\nThe default slot is reserved exclusively for `<mds-pref-theme-item>` elements. Any other content bypasses the component's internal selection management and will not trigger theme application.\n\n```html\n<!-- INCORRECT -->\n<mds-pref>\n <mds-pref-theme name=\"default\" scheme=\"all\">\n <button>Predefinito</button>\n <span>Estate</span>\n </mds-pref-theme>\n</mds-pref>\n\n<!-- CORRECT -->\n<mds-pref>\n <mds-pref-theme name=\"default\" scheme=\"all\">\n <mds-pref-theme-item label=\"Predefinito\" name=\"default\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item label=\"Freddo\" name=\"cool\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n```\n\n#### Do Not Use an Invalid Theme Name\n\nThe `name` prop must match the pattern `^[a-z]+(-[a-z]+)*$` (lowercase letters and hyphens only). Any other value - including uppercase, underscores, or spaces - is ignored with a console warning when the component tries to apply the theme on `<html>`: the theme is neither applied nor stored.\n\n```html\n<!-- INCORRECT -->\n<mds-pref-theme name=\"My Theme\" scheme=\"all\">...</mds-pref-theme>\n<mds-pref-theme name=\"my_theme\" scheme=\"all\">...</mds-pref-theme>\n<mds-pref-theme name=\"MyTheme\" scheme=\"all\">...</mds-pref-theme>\n\n<!-- CORRECT -->\n<mds-pref-theme name=\"warm\" scheme=\"all\">...</mds-pref-theme>\n```\n\n#### Do Not Listen for the Native `change` Event\n\n`<mds-pref-theme>` emits `mdsPrefThemeChange` - a documented custom event with a typed `{ name, scheme }` detail. Listening for the native `change` event will not fire because theme selection is handled entirely inside shadow DOM.\n\n```html\n<!-- INCORRECT -->\n<script>\n document.querySelector('mds-pref-theme').addEventListener('change', (e) => {\n console.log(e.target.value); // undefined - wrong event, wrong detail shape\n });\n</script>\n\n<!-- CORRECT -->\n<script>\n document.querySelector('mds-pref-theme').addEventListener('mdsPrefThemeChange', (e) => {\n console.log(e.detail.name, e.detail.scheme);\n });\n</script>\n```\n\n#### Do Not Give the Parent and the Child Different Sizes\n\n`<mds-pref>` forwards its own `size` to all `mds-pref-*` children, on load and when it changes, and overwrites theirs: a `size` on `<mds-pref-theme>` that differs from the parent's is never shown. Set the size on the parent only.\n\n```html\n<!-- INCORRECT -->\n<mds-pref size=\"sm\">\n <mds-pref-theme size=\"md\" name=\"default\" scheme=\"all\">\n <mds-pref-theme-item label=\"Predefinito\" name=\"default\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n\n<!-- CORRECT -->\n<mds-pref size=\"sm\">\n <mds-pref-theme name=\"default\" scheme=\"all\">\n <mds-pref-theme-item label=\"Predefinito\" name=\"default\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n```\n"
24
28
  },
25
29
  "props": [
@@ -11,6 +11,7 @@ import miBaselineKeyboardArrowDown from "@icon/mi/baseline/keyboard-arrow-down.s
11
11
  import miBaselineKeyboardArrowUp from "@icon/mi/baseline/keyboard-arrow-up.svg";
12
12
  /**
13
13
  * @slot - Add `mds-pref-theme-item` element/s.
14
+ * @category preferences
14
15
  */
15
16
  export class MdsPrefTheme {
16
17
  constructor() {
@@ -247,7 +248,7 @@ export class MdsPrefTheme {
247
248
  this.setTheme(name, scheme);
248
249
  }
249
250
  render() {
250
- return (h(Host, { key: 'b791443dbe44e7fdacdd9d6b053b9061fde94e00' }, h("div", { key: 'd15ecd2de7a96eb6738232615864908d11bb14b8', class: "menu" }, h("mds-text", { key: '00ab4d5873154e0f12cf3d4884153212d37e34a3', class: "info", typography: "caption" }, h("b", { key: 'c29fd2837733effc70e31c7d5e76f2f8d3c63843' }, this.t.get('label'))), h("mds-tab", { key: '9a861567518b31749237636b68b4ad2a3709a405', fill: true, size: this.size }, h("mds-tab-item", { key: '0c31c771324ac4cacff400e7a4eaca68abaa242e', selected: true, onClick: this.toggleDropdown, expanded: this.showDropdown, id: "mds-pref-theme-nav", class: "item item--theme", "icon-position": "right", icon: this.showDropdown ? miBaselineKeyboardArrowUp : miBaselineKeyboardArrowDown, label: this.triggerLabel() }))), h("mds-dropdown", { key: '02fd1e078b4ce374f6805b27b71b421f0cc45a2a', class: "mds-pref-theme-dropdown", target: "#mds-pref-theme-nav", interaction: "none", visible: this.showDropdown, onMdsDropdownHide: this.hideThemeDropdownSelect }, h("slot", { key: '51fce1b2ddc5325d0bead3bd539fba19315c1bae', onSlotchange: this.checkThemeSelect }))));
251
+ return (h(Host, { key: '2f7083702541d768d35ca35d53f69c826dd48c54' }, h("div", { key: 'bf697e45493915b806a8065ee2744440d5367891', class: "menu" }, h("mds-text", { key: 'e176eb31c64c0a126536c76c4eb1db108aacb329', class: "info", typography: "caption" }, h("b", { key: 'd166e86a8944ffa6dfbb3ffd612b3260bb6e3fe6' }, this.t.get('label'))), h("mds-tab", { key: '48e477229e5232e92559b892285c3f05823b1e20', fill: true, size: this.size }, h("mds-tab-item", { key: 'f0302e5380b09f69a6e99bc7562a765fbb2d1c4b', selected: true, onClick: this.toggleDropdown, expanded: this.showDropdown, id: "mds-pref-theme-nav", class: "item item--theme", "icon-position": "right", icon: this.showDropdown ? miBaselineKeyboardArrowUp : miBaselineKeyboardArrowDown, label: this.triggerLabel() }))), h("mds-dropdown", { key: 'e427f49597147ce8c098fdfb77eac5ebff784409', class: "mds-pref-theme-dropdown", target: "#mds-pref-theme-nav", interaction: "none", visible: this.showDropdown, onMdsDropdownHide: this.hideThemeDropdownSelect }, h("slot", { key: 'cf784a34089d3fe41fe8edc1c72a1632e9d8b843', onSlotchange: this.checkThemeSelect }))));
251
252
  }
252
253
  static get is() { return "mds-pref-theme"; }
253
254
  static get encapsulation() { return "shadow"; }
@@ -87,11 +87,10 @@ Pass `size="sm"` when the preferences panel must fit a compact layout: on `<mds-
87
87
 
88
88
  #### Styling Theme Items
89
89
 
90
- Style theme items only through their documented `--mds-pref-theme-item-*` CSS custom properties. Set them on the item host or on a parent selector; name a semantic role, `rgb(var(--magma-<role>))` ([`agents/color.md`](../../../../agents/color.md)), so the colours follow the mode, the theme and the contrast preference.
90
+ Style theme items only through their public `--mds-pref-theme-item-*` CSS custom properties. Set them on the item host or on a parent selector; name a semantic role, `rgb(var(--magma-<role>))` ([`agents/color.md`](../../../../agents/color.md)), so the colours follow the mode, the theme and the contrast preference.
91
91
 
92
92
  ```css
93
93
  mds-pref-theme-item {
94
94
  --mds-pref-theme-item-color-background: rgb(var(--magma-surface-inverse));
95
- --mds-pref-theme-item-color-variant-primary: rgb(var(--magma-accent-emphasis));
96
95
  }
97
96
  ```
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-pref-theme-item
8
8
 
9
- > `@maggioli-design-system/magma` 2.5.1. Shadow DOM: style it only through the CSS custom properties and parts below.
9
+ > `@maggioli-design-system/magma` 2.6.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
10
10
 
11
11
  The `<mds-pref-theme-item>` web component is a single selectable theme entry inside the [`<mds-pref-theme>`](../mds-pref-theme/AGENTS.md) preference picker. It renders as a borderless button that pairs a color-swatch preview of the theme with its label.
12
12
 
@@ -50,10 +50,8 @@ The `<mds-pref-theme-item>` web component is a single selectable theme entry ins
50
50
  | Property | Description |
51
51
  | --- | --- |
52
52
  | `--mds-pref-theme-item-color-background` | Background color of a theme item. |
53
- | `--mds-pref-theme-item-color-status-error` | Color representing an error status for a theme item. |
54
- | `--mds-pref-theme-item-color-status-success` | Color representing a success status for a theme item. |
55
- | `--mds-pref-theme-item-color-status-warning` | Color representing a warning status for a theme item. |
56
- | `--mds-pref-theme-item-color-variant-primary` | Color for the primary variant item. |
53
+
54
+ Only these are public. Its other 4 are internal: they may change in any release, do not set them.
57
55
 
58
56
  ## Dependencies
59
57
 
@@ -65,7 +65,7 @@ A raw `click` carries no `detail`: you have to read `name` back from the element
65
65
 
66
66
  #### Do Not Pierce Shadow DOM to Style the Inner Button
67
67
 
68
- The supported customization surface is the five `--mds-pref-theme-item-*` CSS custom properties. Targeting internal selectors or `::part()` names not present in this component's public API couples your code to the implementation and will break on minor releases.
68
+ The supported customization surface is the public `--mds-pref-theme-item-color-background` CSS custom property. Targeting internal selectors or `::part()` names not present in this component's public API couples your code to the implementation and will break on minor releases.
69
69
 
70
70
  ```css
71
71
  /* INCORRECT */
@@ -78,7 +78,6 @@ mds-pref-theme-item .theme-preview {
78
78
 
79
79
  /* CORRECT */
80
80
  mds-pref-theme-item[name="warm"] {
81
- --mds-pref-theme-item-color-variant-primary: rgb(var(--magma-accent-emphasis-hover));
82
81
  --mds-pref-theme-item-color-background: rgb(var(--magma-wash-strong));
83
82
  }
84
83
  ```
@@ -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-pref-theme-item",
13
13
  "docs": "",
14
- "docsTags": [],
14
+ "docsTags": [
15
+ {
16
+ "name": "parent",
17
+ "text": "mds-pref-theme"
18
+ }
19
+ ],
15
20
  "usage": {
16
21
  "1. Description": "The `<mds-pref-theme-item>` web component is a single selectable theme entry inside the [`<mds-pref-theme>`](../mds-pref-theme/AGENTS.md) preference picker. It renders as a borderless button that pairs a color-swatch preview of the theme with its label.\n\n#### Semantic Behavior\n\n- **Compound child only**: Must be placed as a direct default-slot child of `<mds-pref-theme>`; it is not used standalone or mixed with other child component types.\n- **Selection is parent-driven**: On click each item emits `mdsPrefThemeItemSelect` (carrying `{ name, scheme }`), and the parent responds by clearing the siblings and selecting the clicked one. Setting `selected` directly on a single item does not coordinate the others.\n- **Click bubbles up**: The emitted event is what the parent listens to in order to apply the theme to the document and persist the choice.\n- **Auto-derived label**: If `label` is omitted, it is generated from `name` by capitalizing the first letter and replacing hyphens with spaces (e.g. `maggioli-editore` becomes `Maggioli editore`).\n- **Static color preview**: The four swatches (primary, success, warning, error) and the preview background are painted by the `--mds-pref-theme-item-*` CSS custom properties, not by props. Their defaults are the page's current roles (accent, the status emphases, `wash-base`), so every item shows the same swatches until you set the properties per item.\n\n#### Properties & Visual Configurations\n\n- **`name`**: The theme identifier reported to the parent and matched against the parent's active `name` to compute initial selection. Use a simple or kebab-case string; the named themes are `cool` and `warm`, and `default` is the base theme ([`agents/theming.md`](../../../../agents/theming.md)). The parent validates the lowercase/kebab format and ignores an invalid name with a console warning.\n- **`scheme`**: Declares which color schemes the theme supports - `all` (default, both light and dark), or `light` / `dark` to force a single mode. This value travels with the selection event and is applied by the parent when the item is chosen.\n- **`selected`**: Reflects whether this item is the active theme. The parent sets it on every item when it loads and on each pick, so a value set by hand is overwritten.\n",
17
- "2. Pattern": "Correct and idiomatic ways to use the `<mds-pref-theme-item>` component, ordered from most common to most specialized. Patterns assume a working knowledge of the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Basic Usage Inside the Parent\n\n`<mds-pref-theme-item>` must always be a direct child of [`<mds-pref-theme>`](../mds-pref-theme/AGENTS.md). Each item represents one selectable colour theme; the parent manages selection state so all siblings stay in sync.\n\n```html\n<mds-pref-theme name=\"default\" scheme=\"all\">\n <mds-pref-theme-item name=\"default\" label=\"Predefinito\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"cool\" label=\"Freddo\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"warm\" label=\"Caldo\" scheme=\"all\"></mds-pref-theme-item>\n</mds-pref-theme>\n```\n\n#### Auto-Derived Label\n\nOmit `label` and let the component generate it from `name`: the first letter is capitalised and hyphens are replaced with spaces. Use this shorthand when the theme name is already human-readable.\n\n```html\n<mds-pref-theme name=\"default\" scheme=\"all\">\n <!-- renders \"Default\", \"Cool\", \"Warm\" without explicit label props -->\n <mds-pref-theme-item name=\"default\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"cool\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"warm\" scheme=\"all\"></mds-pref-theme-item>\n</mds-pref-theme>\n```\n\n#### Scheme-Specific Themes\n\nSet `scheme` to `\"light\"` or `\"dark\"` when a theme must be offered in a single colour mode only. The parent applies the forced mode when the item is selected.\n\n```html\n<mds-pref-theme name=\"default\" scheme=\"all\">\n <!-- this theme works in both modes -->\n <mds-pref-theme-item name=\"default\" label=\"Predefinito\" scheme=\"all\"></mds-pref-theme-item>\n\n <!-- offered light-only; selecting it locks the UI in light mode -->\n <mds-pref-theme-item name=\"cool\" label=\"Freddo chiaro\" scheme=\"light\"></mds-pref-theme-item>\n\n <!-- offered dark-only; selecting it locks the UI in dark mode -->\n <mds-pref-theme-item name=\"warm\" label=\"Caldo scuro\" scheme=\"dark\"></mds-pref-theme-item>\n</mds-pref-theme>\n```\n\n#### Listening to the Selection Event\n\nAttach a listener for `mdsPrefThemeItemSelect` when you need to react to a selection at the item level - for example to log analytics. The detail carries `{ name, scheme }`. Normally the parent handles theme application automatically; only listen at this level for side-effects.\n\n```html\n<mds-pref-theme name=\"default\" scheme=\"all\">\n <mds-pref-theme-item name=\"default\" label=\"Predefinito\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"cool\" label=\"Freddo\" scheme=\"all\"></mds-pref-theme-item>\n</mds-pref-theme>\n\n<script>\n document.querySelectorAll('mds-pref-theme-item').forEach((item) => {\n item.addEventListener('mdsPrefThemeItemSelect', (e) => {\n console.log('Tema selezionato:', e.detail.name, 'schema:', e.detail.scheme);\n });\n });\n</script>\n```\n\n#### Setting the Initially Selected Item\n\nDeclare it on the parent, not with `selected`: when it loads, `<mds-pref-theme>` marks the item whose `name` matches the active theme (the stored choice, or its own `name` on a first visit) and overwrites any `selected` written in the markup.\n\n```html\n<mds-pref-theme name=\"cool\" scheme=\"all\">\n <mds-pref-theme-item name=\"default\" label=\"Predefinito\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"cool\" label=\"Freddo\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"warm\" label=\"Caldo\" scheme=\"all\"></mds-pref-theme-item>\n</mds-pref-theme>\n```\n\n#### CSS Customization via Documented Properties\n\nOverride the swatch colours only through the documented `--mds-pref-theme-item-*` CSS custom properties. Set them on the host element or a parent selector and name a semantic role for the colour values, `rgb(var(--magma-<role>))` ([`agents/color.md`](../../../../agents/color.md)), so mode, theme and contrast keep working.\n\n```css\n/* override the colour preview dots of one theme item */\nmds-pref-theme-item[name=\"warm\"] {\n --mds-pref-theme-item-color-variant-primary: rgb(var(--magma-accent-emphasis-hover));\n --mds-pref-theme-item-color-status-success: rgb(var(--magma-success-emphasis));\n --mds-pref-theme-item-color-status-warning: rgb(var(--magma-warning-emphasis));\n --mds-pref-theme-item-color-status-error: rgb(var(--magma-danger-emphasis));\n --mds-pref-theme-item-color-background: rgb(var(--magma-wash-strong));\n}\n```\n",
18
- "3. Antipattern": "Common incorrect uses of `<mds-pref-theme-item>`. Each entry pairs the wrong form with the right one and a one-line reason. System-wide rules (boolean-as-string, shadow piercing, Tailwind color utilities, raw native event listening) live in [`agents/anti-patterns.md`](../../../../agents/anti-patterns.md) - they apply here too but are not repeated.\n\n#### Do Not Use the Item Outside Its Parent\n\n`<mds-pref-theme-item>` is a compound child that must be a direct slot child of [`<mds-pref-theme>`](../mds-pref-theme/AGENTS.md). Used standalone it emits selection events that are never handled, and it never receives coordinated deselection of siblings.\n\n```html\n<!-- INCORRECT -->\n<mds-pref-theme-item name=\"cool\" label=\"Freddo\" scheme=\"all\"></mds-pref-theme-item>\n\n<!-- CORRECT -->\n<mds-pref-theme name=\"default\" scheme=\"all\">\n <mds-pref-theme-item name=\"cool\" label=\"Freddo\" scheme=\"all\"></mds-pref-theme-item>\n</mds-pref-theme>\n```\n\n#### Do Not Set `selected` Manually to Coordinate Multi-Item State\n\nSetting `selected` on one item does not deselect the others - the parent is the only actor that can coordinate the whole group. When it loads it marks only the item matching the active theme, overwriting the `selected` in the markup; a value set later from script leaves several items marked. Drive initial selection through the parent's `name` prop or by letting the user click.\n\n```html\n<!-- INCORRECT - the parent overwrites both on load and marks \"default\" -->\n<mds-pref-theme name=\"default\" scheme=\"all\">\n <mds-pref-theme-item name=\"default\" label=\"Predefinito\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"cool\" label=\"Freddo\" scheme=\"all\" selected></mds-pref-theme-item>\n <mds-pref-theme-item name=\"warm\" label=\"Caldo\" scheme=\"all\" selected></mds-pref-theme-item>\n</mds-pref-theme>\n\n<!-- CORRECT - set the active theme on the parent; it marks the matching child -->\n<mds-pref-theme name=\"cool\" scheme=\"all\">\n <mds-pref-theme-item name=\"default\" label=\"Predefinito\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"cool\" label=\"Freddo\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"warm\" label=\"Caldo\" scheme=\"all\"></mds-pref-theme-item>\n</mds-pref-theme>\n```\n\n#### Do Not Listen for Native `click` Instead of the Component Event\n\nA raw `click` carries no `detail`: you have to read `name` back from the element, and you lose the `scheme`. Listen for the documented `mdsPrefThemeItemSelect` event instead, whose detail carries `{ name, scheme }`.\n\n```html\n<!-- INCORRECT -->\n<script>\n document.querySelector('mds-pref-theme-item').addEventListener('click', (e) => {\n applyTheme(e.target.getAttribute('name'));\n });\n</script>\n\n<!-- CORRECT -->\n<script>\n document.querySelector('mds-pref-theme-item').addEventListener('mdsPrefThemeItemSelect', (e) => {\n applyTheme(e.detail.name);\n });\n</script>\n```\n\n#### Do Not Pierce Shadow DOM to Style the Inner Button\n\nThe supported customization surface is the five `--mds-pref-theme-item-*` CSS custom properties. Targeting internal selectors or `::part()` names not present in this component's public API couples your code to the implementation and will break on minor releases.\n\n```css\n/* INCORRECT */\nmds-pref-theme-item >>> mds-button {\n font-weight: bold;\n}\nmds-pref-theme-item .theme-preview {\n border: 2px solid red;\n}\n\n/* CORRECT */\nmds-pref-theme-item[name=\"warm\"] {\n --mds-pref-theme-item-color-variant-primary: rgb(var(--magma-accent-emphasis-hover));\n --mds-pref-theme-item-color-background: rgb(var(--magma-wash-strong));\n}\n```\n\n#### Do Not Use an Invalid `scheme` Value\n\n`scheme` only accepts `\"all\"`, `\"light\"`, or `\"dark\"`. Other strings are ignored by the parent with a console warning: picking the item applies and stores nothing, so the theme does not change at all.\n\n```html\n<!-- INCORRECT -->\n<mds-pref-theme-item name=\"cool\" scheme=\"light-only\"></mds-pref-theme-item>\n<mds-pref-theme-item name=\"warm\" scheme=\"night\"></mds-pref-theme-item>\n\n<!-- CORRECT -->\n<mds-pref-theme-item name=\"cool\" scheme=\"light\"></mds-pref-theme-item>\n<mds-pref-theme-item name=\"warm\" scheme=\"dark\"></mds-pref-theme-item>\n```\n"
22
+ "2. Pattern": "Correct and idiomatic ways to use the `<mds-pref-theme-item>` component, ordered from most common to most specialized. Patterns assume a working knowledge of the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Basic Usage Inside the Parent\n\n`<mds-pref-theme-item>` must always be a direct child of [`<mds-pref-theme>`](../mds-pref-theme/AGENTS.md). Each item represents one selectable colour theme; the parent manages selection state so all siblings stay in sync.\n\n```html\n<mds-pref-theme name=\"default\" scheme=\"all\">\n <mds-pref-theme-item name=\"default\" label=\"Predefinito\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"cool\" label=\"Freddo\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"warm\" label=\"Caldo\" scheme=\"all\"></mds-pref-theme-item>\n</mds-pref-theme>\n```\n\n#### Auto-Derived Label\n\nOmit `label` and let the component generate it from `name`: the first letter is capitalised and hyphens are replaced with spaces. Use this shorthand when the theme name is already human-readable.\n\n```html\n<mds-pref-theme name=\"default\" scheme=\"all\">\n <!-- renders \"Default\", \"Cool\", \"Warm\" without explicit label props -->\n <mds-pref-theme-item name=\"default\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"cool\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"warm\" scheme=\"all\"></mds-pref-theme-item>\n</mds-pref-theme>\n```\n\n#### Scheme-Specific Themes\n\nSet `scheme` to `\"light\"` or `\"dark\"` when a theme must be offered in a single colour mode only. The parent applies the forced mode when the item is selected.\n\n```html\n<mds-pref-theme name=\"default\" scheme=\"all\">\n <!-- this theme works in both modes -->\n <mds-pref-theme-item name=\"default\" label=\"Predefinito\" scheme=\"all\"></mds-pref-theme-item>\n\n <!-- offered light-only; selecting it locks the UI in light mode -->\n <mds-pref-theme-item name=\"cool\" label=\"Freddo chiaro\" scheme=\"light\"></mds-pref-theme-item>\n\n <!-- offered dark-only; selecting it locks the UI in dark mode -->\n <mds-pref-theme-item name=\"warm\" label=\"Caldo scuro\" scheme=\"dark\"></mds-pref-theme-item>\n</mds-pref-theme>\n```\n\n#### Listening to the Selection Event\n\nAttach a listener for `mdsPrefThemeItemSelect` when you need to react to a selection at the item level - for example to log analytics. The detail carries `{ name, scheme }`. Normally the parent handles theme application automatically; only listen at this level for side-effects.\n\n```html\n<mds-pref-theme name=\"default\" scheme=\"all\">\n <mds-pref-theme-item name=\"default\" label=\"Predefinito\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"cool\" label=\"Freddo\" scheme=\"all\"></mds-pref-theme-item>\n</mds-pref-theme>\n\n<script>\n document.querySelectorAll('mds-pref-theme-item').forEach((item) => {\n item.addEventListener('mdsPrefThemeItemSelect', (e) => {\n console.log('Tema selezionato:', e.detail.name, 'schema:', e.detail.scheme);\n });\n });\n</script>\n```\n\n#### Setting the Initially Selected Item\n\nDeclare it on the parent, not with `selected`: when it loads, `<mds-pref-theme>` marks the item whose `name` matches the active theme (the stored choice, or its own `name` on a first visit) and overwrites any `selected` written in the markup.\n\n```html\n<mds-pref-theme name=\"cool\" scheme=\"all\">\n <mds-pref-theme-item name=\"default\" label=\"Predefinito\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"cool\" label=\"Freddo\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"warm\" label=\"Caldo\" scheme=\"all\"></mds-pref-theme-item>\n</mds-pref-theme>\n```\n\n#### CSS Customization via Documented Properties\n\nOverride the swatch only through the public `--mds-pref-theme-item-color-background` CSS custom property, the background behind the preview dots; the dots themselves are painted by the component. Set it on the host element or a parent selector and name a semantic role for the colour value, `rgb(var(--magma-<role>))` ([`agents/color.md`](../../../../agents/color.md)), so mode, theme and contrast keep working.\n\n```css\n/* override the swatch background of one theme item */\nmds-pref-theme-item[name=\"warm\"] {\n --mds-pref-theme-item-color-background: rgb(var(--magma-wash-strong));\n}\n```\n",
23
+ "3. Antipattern": "Common incorrect uses of `<mds-pref-theme-item>`. Each entry pairs the wrong form with the right one and a one-line reason. System-wide rules (boolean-as-string, shadow piercing, Tailwind color utilities, raw native event listening) live in [`agents/anti-patterns.md`](../../../../agents/anti-patterns.md) - they apply here too but are not repeated.\n\n#### Do Not Use the Item Outside Its Parent\n\n`<mds-pref-theme-item>` is a compound child that must be a direct slot child of [`<mds-pref-theme>`](../mds-pref-theme/AGENTS.md). Used standalone it emits selection events that are never handled, and it never receives coordinated deselection of siblings.\n\n```html\n<!-- INCORRECT -->\n<mds-pref-theme-item name=\"cool\" label=\"Freddo\" scheme=\"all\"></mds-pref-theme-item>\n\n<!-- CORRECT -->\n<mds-pref-theme name=\"default\" scheme=\"all\">\n <mds-pref-theme-item name=\"cool\" label=\"Freddo\" scheme=\"all\"></mds-pref-theme-item>\n</mds-pref-theme>\n```\n\n#### Do Not Set `selected` Manually to Coordinate Multi-Item State\n\nSetting `selected` on one item does not deselect the others - the parent is the only actor that can coordinate the whole group. When it loads it marks only the item matching the active theme, overwriting the `selected` in the markup; a value set later from script leaves several items marked. Drive initial selection through the parent's `name` prop or by letting the user click.\n\n```html\n<!-- INCORRECT - the parent overwrites both on load and marks \"default\" -->\n<mds-pref-theme name=\"default\" scheme=\"all\">\n <mds-pref-theme-item name=\"default\" label=\"Predefinito\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"cool\" label=\"Freddo\" scheme=\"all\" selected></mds-pref-theme-item>\n <mds-pref-theme-item name=\"warm\" label=\"Caldo\" scheme=\"all\" selected></mds-pref-theme-item>\n</mds-pref-theme>\n\n<!-- CORRECT - set the active theme on the parent; it marks the matching child -->\n<mds-pref-theme name=\"cool\" scheme=\"all\">\n <mds-pref-theme-item name=\"default\" label=\"Predefinito\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"cool\" label=\"Freddo\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"warm\" label=\"Caldo\" scheme=\"all\"></mds-pref-theme-item>\n</mds-pref-theme>\n```\n\n#### Do Not Listen for Native `click` Instead of the Component Event\n\nA raw `click` carries no `detail`: you have to read `name` back from the element, and you lose the `scheme`. Listen for the documented `mdsPrefThemeItemSelect` event instead, whose detail carries `{ name, scheme }`.\n\n```html\n<!-- INCORRECT -->\n<script>\n document.querySelector('mds-pref-theme-item').addEventListener('click', (e) => {\n applyTheme(e.target.getAttribute('name'));\n });\n</script>\n\n<!-- CORRECT -->\n<script>\n document.querySelector('mds-pref-theme-item').addEventListener('mdsPrefThemeItemSelect', (e) => {\n applyTheme(e.detail.name);\n });\n</script>\n```\n\n#### Do Not Pierce Shadow DOM to Style the Inner Button\n\nThe supported customization surface is the public `--mds-pref-theme-item-color-background` CSS custom property. Targeting internal selectors or `::part()` names not present in this component's public API couples your code to the implementation and will break on minor releases.\n\n```css\n/* INCORRECT */\nmds-pref-theme-item >>> mds-button {\n font-weight: bold;\n}\nmds-pref-theme-item .theme-preview {\n border: 2px solid red;\n}\n\n/* CORRECT */\nmds-pref-theme-item[name=\"warm\"] {\n --mds-pref-theme-item-color-background: rgb(var(--magma-wash-strong));\n}\n```\n\n#### Do Not Use an Invalid `scheme` Value\n\n`scheme` only accepts `\"all\"`, `\"light\"`, or `\"dark\"`. Other strings are ignored by the parent with a console warning: picking the item applies and stores nothing, so the theme does not change at all.\n\n```html\n<!-- INCORRECT -->\n<mds-pref-theme-item name=\"cool\" scheme=\"light-only\"></mds-pref-theme-item>\n<mds-pref-theme-item name=\"warm\" scheme=\"night\"></mds-pref-theme-item>\n\n<!-- CORRECT -->\n<mds-pref-theme-item name=\"cool\" scheme=\"light\"></mds-pref-theme-item>\n<mds-pref-theme-item name=\"warm\" scheme=\"dark\"></mds-pref-theme-item>\n```\n"
19
24
  },
20
25
  "props": [
21
26
  {
@@ -187,27 +192,32 @@
187
192
  {
188
193
  "name": "--mds-pref-theme-item-color-background",
189
194
  "annotation": "prop",
190
- "docs": "Background color of a theme item."
195
+ "docs": "Background color of a theme item.",
196
+ "visibility": "public"
191
197
  },
192
198
  {
193
199
  "name": "--mds-pref-theme-item-color-status-error",
194
200
  "annotation": "prop",
195
- "docs": "Color representing an error status for a theme item."
201
+ "docs": "Color representing an error status for a theme item.",
202
+ "visibility": "internal"
196
203
  },
197
204
  {
198
205
  "name": "--mds-pref-theme-item-color-status-success",
199
206
  "annotation": "prop",
200
- "docs": "Color representing a success status for a theme item."
207
+ "docs": "Color representing a success status for a theme item.",
208
+ "visibility": "internal"
201
209
  },
202
210
  {
203
211
  "name": "--mds-pref-theme-item-color-status-warning",
204
212
  "annotation": "prop",
205
- "docs": "Color representing a warning status for a theme item."
213
+ "docs": "Color representing a warning status for a theme item.",
214
+ "visibility": "internal"
206
215
  },
207
216
  {
208
217
  "name": "--mds-pref-theme-item-color-variant-primary",
209
218
  "annotation": "prop",
210
- "docs": "Color for the primary variant item."
219
+ "docs": "Color for the primary variant item.",
220
+ "visibility": "internal"
211
221
  }
212
222
  ],
213
223
  "slots": [],
@@ -11,7 +11,7 @@ mds-button {
11
11
 
12
12
 
13
13
  /**
14
- * @prop --mds-pref-theme-item-color-background: Background color of a theme item.
14
+ * @prop --mds-pref-theme-item-color-background: Public. Background color of a theme item.
15
15
  * @prop --mds-pref-theme-item-color-status-error: Color representing an error status for a theme item.
16
16
  * @prop --mds-pref-theme-item-color-status-success: Color representing a success status for a theme item.
17
17
  * @prop --mds-pref-theme-item-color-status-warning: Color representing a warning status for a theme item.
@@ -2,6 +2,9 @@ import { Host, h } from "@stencil/core";
2
2
  import miBaselineCheckCircle from "@icon/mi/baseline/check-circle.svg";
3
3
  import miOutlineCircle from "@icon/mi/outline/circle.svg";
4
4
  import { labelFromName } from "../../common/string";
5
+ /**
6
+ * @parent mds-pref-theme
7
+ */
5
8
  export class MdsPrefThemeItem {
6
9
  constructor() {
7
10
  /**
@@ -31,7 +34,7 @@ export class MdsPrefThemeItem {
31
34
  return (
32
35
  // the item is an entry of the `menu` the mds-dropdown of the controller opens:
33
36
  // without the role axe rejects it as a child of that menu (aria-required-children)
34
- h(Host, { key: '627562cca262f7312a396f5992e89b669d486479', onClick: this.handleClick, role: "menuitem" }, h("mds-button", { key: '37d57676506f68caaa3798392378d317182f1387', icon: this.selected ? miBaselineCheckCircle : miOutlineCircle, variant: "dark", tone: "text", label: this.label }), h("span", { key: '8c6efef51d3b5bf176c21016bdf01b6819592cd2', "aria-hidden": "true", class: "theme-preview" }, h("span", { key: 'ba2924fb18bb4c361879fb920976cf2114040d5c', class: "theme-color theme-color--variant-primary" }), h("span", { key: '175e3a376dcda2ecd0af5a3f80f7f868dceee3c9', class: "theme-color theme-color--status-success" }), h("span", { key: '84e1c1a78c08edeb7bf1db66e72d3e6de3f4f7eb', class: "theme-color theme-color--status-warning" }), h("span", { key: '2876be1030ec9ed45154b34ffcf49fc796d38250', class: "theme-color theme-color--status-error" }))));
37
+ h(Host, { key: '7ab7329e7b30d20901f5c6bd1a5bcc737280775c', onClick: this.handleClick, role: "menuitem" }, h("mds-button", { key: '2b7f1d8c1e41895e15af85004969d1a7381e7b1e', icon: this.selected ? miBaselineCheckCircle : miOutlineCircle, variant: "dark", tone: "text", label: this.label }), h("span", { key: '6e656b3d65de4e6f8d2a0c5b99a3ca791039e296', "aria-hidden": "true", class: "theme-preview" }, h("span", { key: '61adb19c93abff560beb89ba4a432334cc23cf36', class: "theme-color theme-color--variant-primary" }), h("span", { key: 'f54dbb0a2058820059f16011779a9ad9eb6a46fe', class: "theme-color theme-color--status-success" }), h("span", { key: 'a3bfab2e262e45a373c4cf27827f55237c0aa2a9', class: "theme-color theme-color--status-warning" }), h("span", { key: 'f6f6b7fcb29b0dc194b6986015703920d67597f8', class: "theme-color theme-color--status-error" }))));
35
38
  }
36
39
  static get is() { return "mds-pref-theme-item"; }
37
40
  static get encapsulation() { return "shadow"; }
@@ -84,15 +84,11 @@ Declare it on the parent, not with `selected`: when it loads, `<mds-pref-theme>`
84
84
 
85
85
  #### CSS Customization via Documented Properties
86
86
 
87
- Override the swatch colours only through the documented `--mds-pref-theme-item-*` CSS custom properties. Set them on the host element or a parent selector and name a semantic role for the colour values, `rgb(var(--magma-<role>))` ([`agents/color.md`](../../../../agents/color.md)), so mode, theme and contrast keep working.
87
+ Override the swatch only through the public `--mds-pref-theme-item-color-background` CSS custom property, the background behind the preview dots; the dots themselves are painted by the component. Set it on the host element or a parent selector and name a semantic role for the colour value, `rgb(var(--magma-<role>))` ([`agents/color.md`](../../../../agents/color.md)), so mode, theme and contrast keep working.
88
88
 
89
89
  ```css
90
- /* override the colour preview dots of one theme item */
90
+ /* override the swatch background of one theme item */
91
91
  mds-pref-theme-item[name="warm"] {
92
- --mds-pref-theme-item-color-variant-primary: rgb(var(--magma-accent-emphasis-hover));
93
- --mds-pref-theme-item-color-status-success: rgb(var(--magma-success-emphasis));
94
- --mds-pref-theme-item-color-status-warning: rgb(var(--magma-warning-emphasis));
95
- --mds-pref-theme-item-color-status-error: rgb(var(--magma-danger-emphasis));
96
92
  --mds-pref-theme-item-color-background: rgb(var(--magma-wash-strong));
97
93
  }
98
94
  ```
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-price-table
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-price-table>` web component is the layout container of the Magma Design System pricing-table family. It owns no logic or visual chrome of its own: it stacks its slotted compound children (the plan columns, header and feature matrix) into a coherent pricing comparison surface.
12
12
 
@@ -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,11 +15,15 @@
15
15
  {
16
16
  "name": "slot",
17
17
  "text": "- Add `mds-price-table-list` elements or `components` to this slot."
18
+ },
19
+ {
20
+ "name": "category",
21
+ "text": "data"
18
22
  }
19
23
  ],
20
24
  "usage": {
21
25
  "1. Description": "The `<mds-price-table>` web component is the layout container of the Magma Design System pricing-table family. It owns no logic or visual chrome of its own: it stacks its slotted compound children (the plan columns, header and feature matrix) into a coherent pricing comparison surface.\n\n#### Semantic Behavior\n\n- **Default slot only**: Any markup placed between the tags is projected verbatim. It expects the dedicated compound children (`mds-price-table-list`, `mds-price-table-header`, `mds-price-table-features`, which in turn holds the `mds-price-table-features-row` / `mds-price-table-features-cell` matrix) rather than free-form content.\n- **Grid layout host**: Projected blocks are spaced consistently regardless of how many plans or feature rows are supplied.\n- **Responsive composition**: It does not switch layouts internally. Two arrangements are expressed through the children and utility classes - a stacked, per-plan layout (each `mds-price-table-list` carrying its own feature matrix) for narrow viewports, and a shared `mds-price-table-header` + single `mds-price-table-features` matrix for wide viewports.\n- **No props, events, or state**: All configuration lives on the child components.\n\n#### Properties & Visual Configurations\n\nThis component is a pure compound parent and intentionally has no configurable props. Visual variation comes from the children it wraps - for example the `type` attribute on `mds-price-table-features-cell` (`'label'`, `'text'`, `'supported'`, `'unsupported'`) drives what each matrix cell renders, and the named slots on `mds-price-table-list` (`header`, `price`, `action`) position each plan's heading, price and call-to-action. Refer to those child components' own documentation for their value ladders.\n",
22
- "2. Pattern": "Correct and idiomatic ways to use the `<mds-price-table>` family, 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#### Single-Plan Card (Mobile Layout)\n\nUse one `<mds-price-table>` per plan on narrow viewports. Each instance contains one `<mds-price-table-list>` (the plan card) followed by one `<mds-price-table-features>` (its feature matrix). The `header`, `price`, and `action` slots of `<mds-price-table-list>` position plan heading, price, and call-to-action respectively.\n\n```html\n<mds-price-table>\n <mds-price-table-list>\n <mds-text typography=\"h5\" tag=\"h4\" slot=\"header\">Piano Base</mds-text>\n <mds-text typography=\"detail\" slot=\"header\">Ideale per liberi professionisti.</mds-text>\n <mds-text typography=\"h2\" tag=\"h4\" slot=\"price\">49 EUR</mds-text>\n <mds-button slot=\"action\" variant=\"dark\">Inizia ora</mds-button>\n </mds-price-table-list>\n <mds-price-table-features>\n <mds-price-table-features-row>\n <mds-price-table-features-cell type=\"label\">Utenti</mds-price-table-features-cell>\n <mds-price-table-features-cell type=\"text\">10</mds-price-table-features-cell>\n </mds-price-table-features-row>\n <mds-price-table-features-row>\n <mds-price-table-features-cell type=\"label\">Supporto</mds-price-table-features-cell>\n <mds-price-table-features-cell type=\"supported\"></mds-price-table-features-cell>\n </mds-price-table-features-row>\n <mds-price-table-features-row>\n <mds-price-table-features-cell type=\"label\">Report avanzati</mds-price-table-features-cell>\n <mds-price-table-features-cell type=\"unsupported\"></mds-price-table-features-cell>\n </mds-price-table-features-row>\n </mds-price-table-features>\n</mds-price-table>\n```\n\n#### Multi-Plan Comparison (Desktop Layout)\n\nUse a single `<mds-price-table>` wrapping one `<mds-price-table-header>` and one shared `<mds-price-table-features>`. The header holds a heading element plus one `<mds-price-table-list>` per plan. Each `<mds-price-table-features-row>` then carries one `label` cell followed by one data cell per plan - the row component distributes them evenly.\n\n```html\n<mds-price-table>\n <mds-price-table-header class=\"tablet:grid-cols-3 desktop:grid-cols-4\">\n <mds-text typography=\"h1\" tag=\"h3\" class=\"desktop:py-600\">Scegli il tuo piano</mds-text>\n\n <mds-price-table-list>\n <mds-text typography=\"h5\" tag=\"h4\" slot=\"header\">Base</mds-text>\n <mds-text typography=\"h2\" tag=\"h4\" slot=\"price\">49 EUR</mds-text>\n <mds-button slot=\"action\" variant=\"dark\">Inizia</mds-button>\n </mds-price-table-list>\n\n <mds-price-table-list class=\"bg-label-amaranth-10\">\n <mds-text typography=\"h5\" tag=\"h4\" slot=\"header\">Professional</mds-text>\n <mds-text typography=\"h2\" tag=\"h4\" slot=\"price\">99 EUR</mds-text>\n <mds-button slot=\"action\" variant=\"dark\">Inizia</mds-button>\n </mds-price-table-list>\n </mds-price-table-header>\n\n <mds-price-table-features label=\"Caratteristiche\">\n <mds-price-table-features-row>\n <mds-price-table-features-cell type=\"label\">Utenti</mds-price-table-features-cell>\n <mds-price-table-features-cell type=\"text\">10</mds-price-table-features-cell>\n <mds-price-table-features-cell type=\"text\">20</mds-price-table-features-cell>\n </mds-price-table-features-row>\n <mds-price-table-features-row>\n <mds-price-table-features-cell type=\"label\">Automazione</mds-price-table-features-cell>\n <mds-price-table-features-cell type=\"unsupported\"></mds-price-table-features-cell>\n <mds-price-table-features-cell type=\"supported\"></mds-price-table-features-cell>\n </mds-price-table-features-row>\n </mds-price-table-features>\n</mds-price-table>\n```\n\n#### Feature Matrix Section with a Label\n\nPass the `label` prop to `<mds-price-table-features>` to render a bold section heading above the feature rows. Use this when the comparison is split across multiple thematic groups (for example \"Funzionalita base\" and \"Report e analisi\").\n\n```html\n<mds-price-table-features label=\"Report e analisi\">\n <mds-price-table-features-row>\n <mds-price-table-features-cell type=\"label\">Export report</mds-price-table-features-cell>\n <mds-price-table-features-cell type=\"unsupported\"></mds-price-table-features-cell>\n <mds-price-table-features-cell type=\"supported\"></mds-price-table-features-cell>\n </mds-price-table-features-row>\n <mds-price-table-features-row>\n <mds-price-table-features-cell type=\"label\">Report avanzati</mds-price-table-features-cell>\n <mds-price-table-features-cell type=\"unsupported\"></mds-price-table-features-cell>\n <mds-price-table-features-cell type=\"supported\"></mds-price-table-features-cell>\n </mds-price-table-features-row>\n</mds-price-table-features>\n```\n\n#### Feature Cell Types\n\n`<mds-price-table-features-cell>` drives what each matrix cell renders through its `type` attribute. The five accepted values are: `label` (plain row heading), `text` (detail string), `supported` (check icon), `unsupported` (dash icon), and `custom` (arbitrary slotted content).\n\n```html\n<mds-price-table-features-row>\n <!-- Row heading - typically the first cell -->\n <mds-price-table-features-cell type=\"label\">Archiviazione</mds-price-table-features-cell>\n\n <!-- Text value cell -->\n <mds-price-table-features-cell type=\"text\">10 GB</mds-price-table-features-cell>\n\n <!-- Supported / unsupported icon cells (no slotted content needed) -->\n <mds-price-table-features-cell type=\"supported\"></mds-price-table-features-cell>\n <mds-price-table-features-cell type=\"unsupported\"></mds-price-table-features-cell>\n\n <!-- Custom cell for arbitrary content -->\n <mds-price-table-features-cell type=\"custom\">\n <mds-badge variant=\"success\" tone=\"weak\">Nuovo</mds-badge>\n </mds-price-table-features-cell>\n</mds-price-table-features-row>\n```\n\n#### Contextual Help on a Feature Cell\n\nSlot an `<mds-help>` inside a `label` or `text` cell to add an inline tooltip explaining a feature. Place it directly after the label text so the icon appears inline.\n\n```html\n<mds-price-table-features-row>\n <mds-price-table-features-cell type=\"label\">\n Funzionalita automatizzate\n <mds-help>Includono notifiche, workflow e integrazioni API.</mds-help>\n </mds-price-table-features-cell>\n <mds-price-table-features-cell type=\"unsupported\"></mds-price-table-features-cell>\n <mds-price-table-features-cell type=\"supported\"></mds-price-table-features-cell>\n</mds-price-table-features-row>\n```\n\n#### List Items Inside a Plan Card\n\nUse `<mds-price-table-list-item>` for a bulleted feature list inside a plan card: the item assigns itself to the `item` slot, so it needs no `slot` attribute. Add the boolean `supported` attribute for included features and omit it (default `false`) for excluded ones. The `typography` prop controls the text size.\n\n```html\n<mds-price-table-list>\n <mds-text typography=\"h5\" tag=\"h4\" slot=\"header\">Piano Base</mds-text>\n <mds-text typography=\"h2\" tag=\"h4\" slot=\"price\">49 EUR</mds-text>\n\n <mds-price-table-list-item supported>Accesso base</mds-price-table-list-item>\n <mds-price-table-list-item supported>Supporto clienti</mds-price-table-list-item>\n <mds-price-table-list-item>Automazione</mds-price-table-list-item>\n <mds-price-table-list-item>Export report</mds-price-table-list-item>\n\n <mds-button slot=\"action\" variant=\"dark\">Inizia ora</mds-button>\n</mds-price-table-list>\n```\n\n#### Highlighted Plan Card\n\nApply a Magma label-color utility class directly to `<mds-price-table-list>` to visually distinguish a recommended or featured plan. Do not set a background color through inline styles or custom CSS; use the documented background tokens.\n\n```html\n<mds-price-table>\n <mds-price-table-list>\n <mds-text typography=\"h5\" tag=\"h4\" slot=\"header\">Base</mds-text>\n <mds-text typography=\"h2\" tag=\"h4\" slot=\"price\">49 EUR</mds-text>\n <mds-button slot=\"action\" variant=\"dark\">Inizia</mds-button>\n </mds-price-table-list>\n\n <!-- Highlighted plan -->\n <mds-price-table-list class=\"bg-label-amaranth-10\">\n <mds-text typography=\"h5\" tag=\"h4\" slot=\"header\">Professional</mds-text>\n <mds-text typography=\"h2\" tag=\"h4\" slot=\"price\">99 EUR</mds-text>\n <mds-button slot=\"action\" variant=\"dark\">Inizia</mds-button>\n </mds-price-table-list>\n</mds-price-table>\n```\n\n#### Separator Color Customization\n\n`<mds-price-table-list>` exposes one CSS custom property, `--mds-price-table-list-separator-color`, to style the horizontal rule that separates the header from the item list. Set it on the host, naming a semantic role ([`agents/color.md`](../../../../agents/color.md)).\n\n```css\n.featured-plan mds-price-table-list {\n --mds-price-table-list-separator-color: rgb(var(--magma-accent-border));\n}\n```\n",
26
+ "2. Pattern": "Correct and idiomatic ways to use the `<mds-price-table>` family, 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#### Single-Plan Card (Mobile Layout)\n\nUse one `<mds-price-table>` per plan on narrow viewports. Each instance contains one `<mds-price-table-list>` (the plan card) followed by one `<mds-price-table-features>` (its feature matrix). The `header`, `price`, and `action` slots of `<mds-price-table-list>` position plan heading, price, and call-to-action respectively.\n\n```html\n<mds-price-table>\n <mds-price-table-list>\n <mds-text typography=\"h5\" tag=\"h4\" slot=\"header\">Piano Base</mds-text>\n <mds-text typography=\"detail\" slot=\"header\">Ideale per liberi professionisti.</mds-text>\n <mds-text typography=\"h2\" tag=\"h4\" slot=\"price\">49 EUR</mds-text>\n <mds-button slot=\"action\" variant=\"dark\">Inizia ora</mds-button>\n </mds-price-table-list>\n <mds-price-table-features>\n <mds-price-table-features-row>\n <mds-price-table-features-cell type=\"label\">Utenti</mds-price-table-features-cell>\n <mds-price-table-features-cell type=\"text\">10</mds-price-table-features-cell>\n </mds-price-table-features-row>\n <mds-price-table-features-row>\n <mds-price-table-features-cell type=\"label\">Supporto</mds-price-table-features-cell>\n <mds-price-table-features-cell type=\"supported\"></mds-price-table-features-cell>\n </mds-price-table-features-row>\n <mds-price-table-features-row>\n <mds-price-table-features-cell type=\"label\">Report avanzati</mds-price-table-features-cell>\n <mds-price-table-features-cell type=\"unsupported\"></mds-price-table-features-cell>\n </mds-price-table-features-row>\n </mds-price-table-features>\n</mds-price-table>\n```\n\n#### Multi-Plan Comparison (Desktop Layout)\n\nUse a single `<mds-price-table>` wrapping one `<mds-price-table-header>` and one shared `<mds-price-table-features>`. The header holds a heading element plus one `<mds-price-table-list>` per plan. Each `<mds-price-table-features-row>` then carries one `label` cell followed by one data cell per plan - the row component distributes them evenly.\n\n```html\n<mds-price-table>\n <mds-price-table-header class=\"tablet:grid-cols-3 desktop:grid-cols-4\">\n <mds-text typography=\"h1\" tag=\"h3\" class=\"desktop:py-600\">Scegli il tuo piano</mds-text>\n\n <mds-price-table-list>\n <mds-text typography=\"h5\" tag=\"h4\" slot=\"header\">Base</mds-text>\n <mds-text typography=\"h2\" tag=\"h4\" slot=\"price\">49 EUR</mds-text>\n <mds-button slot=\"action\" variant=\"dark\">Inizia</mds-button>\n </mds-price-table-list>\n\n <mds-price-table-list class=\"bg-label-amaranth-10\">\n <mds-text typography=\"h5\" tag=\"h4\" slot=\"header\">Professional</mds-text>\n <mds-text typography=\"h2\" tag=\"h4\" slot=\"price\">99 EUR</mds-text>\n <mds-button slot=\"action\" variant=\"dark\">Inizia</mds-button>\n </mds-price-table-list>\n </mds-price-table-header>\n\n <mds-price-table-features label=\"Caratteristiche\">\n <mds-price-table-features-row>\n <mds-price-table-features-cell type=\"label\">Utenti</mds-price-table-features-cell>\n <mds-price-table-features-cell type=\"text\">10</mds-price-table-features-cell>\n <mds-price-table-features-cell type=\"text\">20</mds-price-table-features-cell>\n </mds-price-table-features-row>\n <mds-price-table-features-row>\n <mds-price-table-features-cell type=\"label\">Automazione</mds-price-table-features-cell>\n <mds-price-table-features-cell type=\"unsupported\"></mds-price-table-features-cell>\n <mds-price-table-features-cell type=\"supported\"></mds-price-table-features-cell>\n </mds-price-table-features-row>\n </mds-price-table-features>\n</mds-price-table>\n```\n\n#### Feature Matrix Section with a Label\n\nPass the `label` prop to `<mds-price-table-features>` to render a bold section heading above the feature rows. Use this when the comparison is split across multiple thematic groups (for example \"Funzionalita base\" and \"Report e analisi\").\n\n```html\n<mds-price-table-features label=\"Report e analisi\">\n <mds-price-table-features-row>\n <mds-price-table-features-cell type=\"label\">Export report</mds-price-table-features-cell>\n <mds-price-table-features-cell type=\"unsupported\"></mds-price-table-features-cell>\n <mds-price-table-features-cell type=\"supported\"></mds-price-table-features-cell>\n </mds-price-table-features-row>\n <mds-price-table-features-row>\n <mds-price-table-features-cell type=\"label\">Report avanzati</mds-price-table-features-cell>\n <mds-price-table-features-cell type=\"unsupported\"></mds-price-table-features-cell>\n <mds-price-table-features-cell type=\"supported\"></mds-price-table-features-cell>\n </mds-price-table-features-row>\n</mds-price-table-features>\n```\n\n#### Feature Cell Types\n\n`<mds-price-table-features-cell>` drives what each matrix cell renders through its `type` attribute. The five accepted values are: `label` (plain row heading), `text` (detail string), `supported` (check icon), `unsupported` (dash icon), and `custom` (arbitrary slotted content).\n\n```html\n<mds-price-table-features-row>\n <!-- Row heading - typically the first cell -->\n <mds-price-table-features-cell type=\"label\">Archiviazione</mds-price-table-features-cell>\n\n <!-- Text value cell -->\n <mds-price-table-features-cell type=\"text\">10 GB</mds-price-table-features-cell>\n\n <!-- Supported / unsupported icon cells (no slotted content needed) -->\n <mds-price-table-features-cell type=\"supported\"></mds-price-table-features-cell>\n <mds-price-table-features-cell type=\"unsupported\"></mds-price-table-features-cell>\n\n <!-- Custom cell for arbitrary content -->\n <mds-price-table-features-cell type=\"custom\">\n <mds-badge variant=\"success\" tone=\"weak\">Nuovo</mds-badge>\n </mds-price-table-features-cell>\n</mds-price-table-features-row>\n```\n\n#### Contextual Help on a Feature Cell\n\nSlot an `<mds-help>` inside a `label` or `text` cell to add an inline tooltip explaining a feature. Place it directly after the label text so the icon appears inline.\n\n```html\n<mds-price-table-features-row>\n <mds-price-table-features-cell type=\"label\">\n Funzionalita automatizzate\n <mds-help>Includono notifiche, workflow e integrazioni API.</mds-help>\n </mds-price-table-features-cell>\n <mds-price-table-features-cell type=\"unsupported\"></mds-price-table-features-cell>\n <mds-price-table-features-cell type=\"supported\"></mds-price-table-features-cell>\n</mds-price-table-features-row>\n```\n\n#### List Items Inside a Plan Card\n\nUse `<mds-price-table-list-item>` for a bulleted feature list inside a plan card: the item assigns itself to the `item` slot, so it needs no `slot` attribute. Add the boolean `supported` attribute for included features and omit it (default `false`) for excluded ones. The `typography` prop controls the text size.\n\n```html\n<mds-price-table-list>\n <mds-text typography=\"h5\" tag=\"h4\" slot=\"header\">Piano Base</mds-text>\n <mds-text typography=\"h2\" tag=\"h4\" slot=\"price\">49 EUR</mds-text>\n\n <mds-price-table-list-item supported>Accesso base</mds-price-table-list-item>\n <mds-price-table-list-item supported>Supporto clienti</mds-price-table-list-item>\n <mds-price-table-list-item>Automazione</mds-price-table-list-item>\n <mds-price-table-list-item>Export report</mds-price-table-list-item>\n\n <mds-button slot=\"action\" variant=\"dark\">Inizia ora</mds-button>\n</mds-price-table-list>\n```\n\n#### Highlighted Plan Card\n\nApply a Magma label-color utility class directly to `<mds-price-table-list>` to visually distinguish a recommended or featured plan. Do not set a background color through inline styles or custom CSS; use the documented background tokens.\n\n```html\n<mds-price-table>\n <mds-price-table-list>\n <mds-text typography=\"h5\" tag=\"h4\" slot=\"header\">Base</mds-text>\n <mds-text typography=\"h2\" tag=\"h4\" slot=\"price\">49 EUR</mds-text>\n <mds-button slot=\"action\" variant=\"dark\">Inizia</mds-button>\n </mds-price-table-list>\n\n <!-- Highlighted plan -->\n <mds-price-table-list class=\"bg-label-amaranth-10\">\n <mds-text typography=\"h5\" tag=\"h4\" slot=\"header\">Professional</mds-text>\n <mds-text typography=\"h2\" tag=\"h4\" slot=\"price\">99 EUR</mds-text>\n <mds-button slot=\"action\" variant=\"dark\">Inizia</mds-button>\n </mds-price-table-list>\n</mds-price-table>\n```\n\n#### Styling a Plan Column\n\n`<mds-price-table-list>` has no public CSS custom property: the horizontal rule that separates the header from the item list keeps the colour the component gives it, in every mode and contrast preference. Adjust the layout of a plan through its documented `header`, `content` and `footer` shadow parts, and name a semantic role ([`agents/color.md`](../../../../agents/color.md)) for any colour you set there.\n\n```css\n.featured-plan mds-price-table-list::part(header) {\n padding-bottom: calc(var(--spacing) * 200);\n}\n```\n",
23
27
  "3. Antipattern": "Common incorrect uses of the `<mds-price-table>` family. Each entry pairs the wrong form with the right one and a one-line reason. System-wide rules (boolean-as-string, shadow piercing, Tailwind color utilities, raw native event listening) live in [`agents/anti-patterns.md`](../../../../agents/anti-patterns.md) - they apply here too but are not repeated.\n\n#### Do Not Use Child Components Outside Their Parent\n\n`<mds-price-table-features-row>` and `<mds-price-table-features-cell>` communicate with `<mds-price-table-features>` through the slot mechanism. Placing them in free-form HTML drops the `<table>` the parent renders around them (fixed layout, collapsed borders) and the cell padding it shares through `--mds-price-table-features-padding`.\n\n```html\n<!-- INCORRECT -->\n<mds-price-table-features-row>\n <mds-price-table-features-cell type=\"label\">Utenti</mds-price-table-features-cell>\n <mds-price-table-features-cell type=\"text\">10</mds-price-table-features-cell>\n</mds-price-table-features-row>\n\n<!-- CORRECT -->\n<mds-price-table-features>\n <mds-price-table-features-row>\n <mds-price-table-features-cell type=\"label\">Utenti</mds-price-table-features-cell>\n <mds-price-table-features-cell type=\"text\">10</mds-price-table-features-cell>\n </mds-price-table-features-row>\n</mds-price-table-features>\n```\n\n#### Do Not Omit the Slot Name on Plan Card Children\n\n`<mds-price-table-list>` routes content through named slots: `header`, `price`, and `action`. The component has no default slot: content without a `slot` attribute is not rendered at all (only `<mds-price-table-list-item>` assigns itself to the `item` slot).\n\n```html\n<!-- INCORRECT - none of these is rendered -->\n<mds-price-table-list>\n <mds-text typography=\"h5\" tag=\"h4\">Piano Base</mds-text>\n <mds-text typography=\"h2\" tag=\"h4\">49 EUR</mds-text>\n <mds-button variant=\"dark\">Inizia</mds-button>\n</mds-price-table-list>\n\n<!-- CORRECT -->\n<mds-price-table-list>\n <mds-text typography=\"h5\" tag=\"h4\" slot=\"header\">Piano Base</mds-text>\n <mds-text typography=\"h2\" tag=\"h4\" slot=\"price\">49 EUR</mds-text>\n <mds-button slot=\"action\" variant=\"dark\">Inizia</mds-button>\n</mds-price-table-list>\n```\n\n#### Do Not Pass `supported=\"false\"` as a String on `mds-price-table-list-item`\n\n`supported` is a boolean prop: express a missing feature by removing the attribute, the convention for every Magma boolean ([`agents/conventions.md`](../../../../agents/conventions.md)). Stencil does parse `\"false\"` as `false`, but the attribute stays in the markup until the component hydrates and its reflection removes it, so a `[supported]` selector or any code reading the attribute sees it set in the meantime.\n\n```html\n<!-- INCORRECT -->\n<mds-price-table-list-item supported=\"false\">Export report</mds-price-table-list-item>\n\n<!-- CORRECT -->\n<mds-price-table-list-item>Export report</mds-price-table-list-item>\n```\n\n#### Do Not Use an Invalid `type` on `mds-price-table-features-cell`\n\n`type` accepts exactly five values: `label`, `text`, `supported`, `unsupported`, `custom`. An unrecognised value silently renders nothing because the component matches each value with a conditional render branch.\n\n```html\n<!-- INCORRECT (not a valid type value) -->\n<mds-price-table-features-cell type=\"check\"></mds-price-table-features-cell>\n<mds-price-table-features-cell type=\"icon\"></mds-price-table-features-cell>\n\n<!-- CORRECT -->\n<mds-price-table-features-cell type=\"supported\"></mds-price-table-features-cell>\n```\n\n#### Do Not Place Free-Form HTML Directly Inside `mds-price-table`\n\n`<mds-price-table>` is a pure layout host - its slot expects the dedicated compound children. Arbitrary HTML breaks the grid spacing contract and produces unstyled content because the component applies no visual treatment to unknown children.\n\n```html\n<!-- INCORRECT -->\n<mds-price-table>\n <div class=\"piano\">\n <h3>Piano Base</h3>\n <p>49 EUR/mese</p>\n </div>\n</mds-price-table>\n\n<!-- CORRECT -->\n<mds-price-table>\n <mds-price-table-list>\n <mds-text typography=\"h5\" tag=\"h4\" slot=\"header\">Piano Base</mds-text>\n <mds-text typography=\"h2\" tag=\"h4\" slot=\"price\">49 EUR/mese</mds-text>\n <mds-button slot=\"action\" variant=\"dark\">Inizia</mds-button>\n </mds-price-table-list>\n</mds-price-table>\n```\n\n#### Do Not Put Slotted Content Inside `supported` or `unsupported` Cells\n\n`<mds-price-table-features-cell type=\"supported\">` and `type=\"unsupported\"` render a fixed icon and ignore any slotted content. Only `type=\"text\"`, `type=\"label\"`, and `type=\"custom\"` project slotted nodes.\n\n```html\n<!-- INCORRECT - slotted text is silently ignored -->\n<mds-price-table-features-cell type=\"supported\">Si</mds-price-table-features-cell>\n<mds-price-table-features-cell type=\"unsupported\">No</mds-price-table-features-cell>\n\n<!-- CORRECT - leave icon cells empty or use text/custom for values -->\n<mds-price-table-features-cell type=\"supported\"></mds-price-table-features-cell>\n<mds-price-table-features-cell type=\"text\">Non disponibile</mds-price-table-features-cell>\n```\n\n#### Do Not Pierce Shadow Parts of Child Components to Restyle Cells\n\n`<mds-price-table-features-cell>` exposes two documented shadow parts: `icon` (the check or dash icon) and `text` (the detail text wrapper). Targeting undocumented internals via `>>>` or unlisted `::part()` names couples app code to implementation details that may change.\n\n```css\n/* INCORRECT */\nmds-price-table-features-cell >>> .icon {\n fill: red;\n}\nmds-price-table-features-cell::part(cell-wrapper) {\n padding: 1rem;\n}\n\n/* CORRECT */\nmds-price-table-features-cell::part(icon) {\n fill: rgb(var(--magma-success-fg));\n}\n```\n"
24
28
  },
25
29
  "props": [],
@@ -1,10 +1,11 @@
1
1
  import { Host, h } from "@stencil/core";
2
2
  /**
3
3
  * @slot - Add `mds-price-table-list` elements or `components` to this slot.
4
+ * @category data
4
5
  */
5
6
  export class MdsPriceTable {
6
7
  render() {
7
- return (h(Host, { key: '9b2067d26b39a20aa23b5b383670fec9a3754bd6' }, h("slot", { key: '749f0a5a415db70a89a81bf3f80fcd6a6dc6335d' })));
8
+ return (h(Host, { key: '5b2c5ebe5e79a4ee796774ac55c0d868725224f4' }, h("slot", { key: 'a2bf66dfd60112fe2949cf7bc3d13f152d0934a4' })));
8
9
  }
9
10
  static get is() { return "mds-price-table"; }
10
11
  static get encapsulation() { return "shadow"; }