@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",
@@ -19,6 +19,10 @@
19
19
  {
20
20
  "name": "part",
21
21
  "text": "content - The wrapper of the default slot, above the message"
22
+ },
23
+ {
24
+ "name": "category",
25
+ "text": "forms"
22
26
  }
23
27
  ],
24
28
  "usage": {
@@ -147,12 +151,14 @@
147
151
  {
148
152
  "name": "--mds-input-field-message-background",
149
153
  "annotation": "prop",
150
- "docs": "Sets the message background color of the component, will be visible only if there is a text defined by `message` component attribute"
154
+ "docs": "Sets the message background color of the component, will be visible only if there is a text defined by `message` component attribute",
155
+ "visibility": "public"
151
156
  },
152
157
  {
153
158
  "name": "--mds-input-field-message-color",
154
159
  "annotation": "prop",
155
- "docs": "Sets the message text color of the component"
160
+ "docs": "Sets the message text color of the component",
161
+ "visibility": "public"
156
162
  }
157
163
  ],
158
164
  "slots": [
@@ -11,8 +11,8 @@ mds-text {
11
11
 
12
12
 
13
13
  /**
14
- * @prop --mds-input-field-message-color: Sets the message text color of the component
15
- * @prop --mds-input-field-message-background: Sets the message background color of the component, will be visible only if there is a text defined by `message` component attribute
14
+ * @prop --mds-input-field-message-color: Public. Sets the message text color of the component
15
+ * @prop --mds-input-field-message-background: Public. Sets the message background color of the component, will be visible only if there is a text defined by `message` component attribute
16
16
  */
17
17
 
18
18
  :host {
@@ -4,6 +4,7 @@ import { Host, h } from "@stencil/core";
4
4
  * validation errors in `message`. Another control, a native `<input>` among them, gets the name
5
5
  * but no validation messages.
6
6
  * @part content - The wrapper of the default slot, above the message
7
+ * @category forms
7
8
  */
8
9
  export class MdsInputField {
9
10
  constructor() {
@@ -68,7 +69,7 @@ export class MdsInputField {
68
69
  }
69
70
  render() {
70
71
  var _a;
71
- return (h(Host, { key: 'e3cda7417a3146da6a5be81bbe30d7322712612b' }, h("mds-text", { key: 'ecec06095f556df90c393ebd9c065ed071d13385', class: "label", typography: "label" }, this.label), h("div", { key: 'e9e97898e5e24138568fc960db6757645d788683', class: "message-window" }, h("div", { key: 'c4ebb296a0a4a666773050fcd17d9b579b1f96d6', class: "content", part: "content" }, h("slot", { key: '1f651414949e41d429eeef9a53b919c54b10326c', onSlotchange: this.nameSlottedControls, ref: (i) => (this.slotInput = i) })), h("div", { key: '7c973d622fb784dd5ffdf6ee5a8b69759a43ae11', class: "message" }, (_a = this.message) === null || _a === void 0 ? void 0 : _a.split(';').map((m, i) => (h("mds-text", { typography: "caption", key: i }, m)))))));
72
+ return (h(Host, { key: '9e590cffc1b2cd840547d6922b2bb6ecfd7a4895' }, h("mds-text", { key: 'b3e1fd0c9f9aff9fdafbcea2340d3890540097ba', class: "label", typography: "label" }, this.label), h("div", { key: '047a277929f9f8313c3e4c4d5e9cfdf24a7e3338', class: "message-window" }, h("div", { key: '88a44e429a1eb9df0dc587ee0ae54ce2b2dc6a3e', class: "content", part: "content" }, h("slot", { key: 'f78ea7ee9b0512f9de3c26b096fbb274184f6cbd', onSlotchange: this.nameSlottedControls, ref: (i) => (this.slotInput = i) })), h("div", { key: 'dbd1ffd38968a882ced2ed817cb05fe7625ff980', class: "message" }, (_a = this.message) === null || _a === void 0 ? void 0 : _a.split(';').map((m, i) => (h("mds-text", { typography: "caption", key: i }, m)))))));
72
73
  }
73
74
  static get is() { return "mds-input-field"; }
74
75
  static get encapsulation() { return "shadow"; }
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-input-otp
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-input-otp>` web component is the Magma Design System control for entering one-time passcodes, rendering a row of single-digit fields that together compose a single form value. It is form-associated, so it behaves like a native input whose value is the concatenated OTP code.
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",
@@ -11,7 +11,12 @@
11
11
  "encapsulation": "shadow",
12
12
  "tag": "mds-input-otp",
13
13
  "docs": "",
14
- "docsTags": [],
14
+ "docsTags": [
15
+ {
16
+ "name": "category",
17
+ "text": "forms"
18
+ }
19
+ ],
15
20
  "usage": {
16
21
  "1. Description": "The `<mds-input-otp>` web component is the Magma Design System control for entering one-time passcodes, rendering a row of single-digit fields that together compose a single form value. It is form-associated, so it behaves like a native input whose value is the concatenated OTP code.\n\n#### Semantic Behavior\n\n- **Form association**: The joined digits are exposed as the form value, so it submits with the surrounding `<form>` with no extra wiring. A form reset brings back the code of load, in the cells and in the form, like a native input.\n- **Disabled fieldset**: A disabled `<fieldset>` around the component disables it as `disabled` does, like a native control: the code cannot be changed and is left out of the form, until the fieldset is enabled.\n- **Single-digit cells**: Renders `length` digit cells, each capped at one character; the host value is the concatenation of every cell.\n- **Numeric-only entry**: A key that writes anything but a digit (a letter, Space) changes nothing; a digit typed on a filled cell overwrites it.\n- **Keyboard**: Backspace empties the cell, or the previous one from an empty cell, and moves there; Delete empties the cell; the left and right arrows move between the cells. Tab and Shift+Tab leave the field, and the shortcuts (paste with Ctrl+V or Cmd+V among them) keep what the browser does with them.\n- **Auto-advance focus**: After a valid digit, focus moves to the next cell automatically; entering a digit in the last cell blurs it.\n- **Paste handling**: Pasting a code of digits (the spaces around it are dropped) distributes the digits across consecutive cells starting from the focused one; a paste with anything else in it, signs and decimal points included, is ignored.\n- **Completion + submit**: When a digit typed or pasted in the last cell completes all `length` digits and `autosubmit` is set, the owning form is submitted; digits pasted past the last cell are dropped.\n\n#### Properties & Visual Configurations\n\n- **`length`** sets how many digit cells are rendered and therefore the expected code length; it doubles as the completeness threshold for auto-submit. Defaults to `6`.\n- **`disabled`** disables every cell, like a disabled native input: the code cannot be changed and is left out of the form. The cells take the disabled look without the disabled tip, which a single-digit cell has no room for.\n- **`autosubmit`** opts into automatic form submission the moment the code is complete - use it for flows where the OTP is the only field and no explicit confirm button is needed; leave it off when the user should review or trigger submission manually.\n- **`value`** holds the current concatenated code; read it to observe progress. A value written in the markup or set by code fills the cells from the first one, as many digits as there are cells, and reaches the form.\n",
17
22
  "2. Pattern": "Correct and idiomatic ways to use the `<mds-input-otp>` component, ordered from most common to most specialized. Patterns assume a working knowledge of the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Default Six-Digit Code\n\nThe component renders six single-digit cells by default. Drop it into a form with a `name` attribute so the concatenated value is submitted as a named field.\n\n```html\n<form action=\"/verify\" method=\"post\">\n <mds-input-otp name=\"otp\"></mds-input-otp>\n <mds-button type=\"submit\" label=\"Verifica\" variant=\"primary\" tone=\"strong\"></mds-button>\n</form>\n```\n\n#### Custom Code Length\n\nSet `length` to match the expected OTP length - 4 digits for a short PIN, 8 for a longer token.\n\n```html\n<!-- Four-digit PIN -->\n<mds-input-otp name=\"pin\" length=\"4\"></mds-input-otp>\n\n<!-- Eight-digit token -->\n<mds-input-otp name=\"token\" length=\"8\"></mds-input-otp>\n```\n\n#### Auto-Submit on Completion\n\nAdd the `autosubmit` boolean attribute when the OTP is the only field and no explicit confirm button is needed. The owning form is submitted when a digit typed or pasted in the last cell completes the code - do not set `autosubmit=\"false\"` to disable it; remove the attribute instead.\n\n```html\n<form action=\"/verify\" method=\"post\">\n <mds-input-otp name=\"otp\" autosubmit></mds-input-otp>\n</form>\n```\n\n#### Reading the Value Programmatically\n\n`value` is a reflected attribute that updates as the user types. Read it directly from the element or listen for form data. Set it to fill the cells from code, for example to prefill a code the page already knows; a form reset brings back the value of load.\n\n```javascript\nconst otp = document.querySelector('mds-input-otp');\n\n// Poll current state\nconsole.log(otp.value); // e.g. \"124\" while in progress: empty cells add nothing\n\n// React on form submit\ndocument.querySelector('form').addEventListener('submit', (e) => {\n e.preventDefault();\n const data = new FormData(e.target);\n console.log('Codice OTP:', data.get('otp'));\n});\n```\n\n#### Full Authentication Flow\n\nCombine `autosubmit` with a submit handler to verify the code and reflect the result - pair with [`mds-button`](../mds-button/AGENTS.md) in await state while the request is in flight.\n\n```html\n<form id=\"otp-form\" action=\"/auth/otp\" method=\"post\">\n <mds-input-otp name=\"otp\" length=\"6\" autosubmit></mds-input-otp>\n\n <mds-button\n id=\"submit-btn\"\n type=\"submit\"\n label=\"Conferma codice\"\n variant=\"primary\"\n tone=\"strong\"\n disabled\n ></mds-button>\n</form>\n\n<script>\n const form = document.getElementById('otp-form');\n const btn = document.getElementById('submit-btn');\n const otpEl = form.querySelector('mds-input-otp');\n\n // Enable the button only once all digits are entered\n setInterval(() => {\n btn.disabled = otpEl.value.length < 6 ? true : undefined;\n }, 100);\n\n form.addEventListener('submit', async (e) => {\n e.preventDefault();\n btn.setAttribute('await', '');\n // ... send request, then remove await\n });\n</script>\n```\n\n#### Layout Alignment\n\nThe host is an `inline-flex` container. Use a utility class to center it inside a card or modal.\n\n```html\n<div class=\"flex justify-center py-600\">\n <mds-input-otp name=\"otp\"></mds-input-otp>\n</div>\n```\n",
@@ -5,6 +5,9 @@ import localeEl from "./meta/locale.el.json";
5
5
  import localeEn from "./meta/locale.en.json";
6
6
  import localeEs from "./meta/locale.es.json";
7
7
  import localeIt from "./meta/locale.it.json";
8
+ /**
9
+ * @category forms
10
+ */
8
11
  export class MdsInputOtp {
9
12
  constructor() {
10
13
  // the value of load, which a form reset brings back as the value attribute of a native input
@@ -165,7 +168,7 @@ export class MdsInputOtp {
165
168
  setFormValue(this.internals, this.value);
166
169
  }
167
170
  render() {
168
- return (h(Host, { key: 'c9877d93f4c68eadde74ec087c10bb7465811051' }, Array.from({ length: this.length }).map((_, index) => {
171
+ return (h(Host, { key: 'a2a249f0fb7eb2086f502bda3f83109ab9b58345' }, Array.from({ length: this.length }).map((_, index) => {
169
172
  var _a;
170
173
  return (h("mds-input", { "aria-label": this.digitName(index), class: "input", disabled: this.isDisabled(), maxlength: 1, onKeyDown: this.handleKeyDown, onPaste: this.handlePaste, value: (_a = this.digits[index]) !== null && _a !== void 0 ? _a : '' }));
171
174
  })));
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-input-range
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-input-range>` web component is the Magma Design System slider control for picking a single numeric value from a continuous interval. It wraps a native `<input type="range">`, adding a labelled header, a styled track with a live progress fill, form association, and value formatting.
12
12
 
@@ -26,7 +26,7 @@ The `<mds-input-range>` web component is the Magma Design System slider control
26
26
  - **`value`** is the committed numeric selection, kept clamped and snapped - set it programmatically to move the thumb.
27
27
  - **`formatValue`** is a function `(value: number) => string` for presentation only: use it to render the header value as currency, a percentage, or a unit-suffixed label without changing the underlying numeric `value`.
28
28
 
29
- This component does not use the shared `variant` / `tone` ladders ([`agents/variants.md`](../../../../agents/variants.md)); appearance is tuned through the documented CSS custom properties (thumb and track colors and sizes) listed in [`AGENTS.md`](AGENTS.md).
29
+ This component does not use the shared `variant` / `tone` ladders ([`agents/variants.md`](../../../../agents/variants.md)); it has no public CSS custom property: the thumb and the track follow the theme, and the `header` and `track` parts listed in [`AGENTS.md`](AGENTS.md) are its styling hooks.
30
30
 
31
31
  ## Read next
32
32
 
@@ -67,17 +67,7 @@ This component does not use the shared `variant` / `tone` ladders ([`agents/vari
67
67
 
68
68
  ## CSS custom properties
69
69
 
70
- | Property | Description |
71
- | --- | --- |
72
- | `--mds-input-range-thumb-background` | Sets the thumb background color |
73
- | `--mds-input-range-thumb-background-disabled` | Sets the thumb background color when the component is disabled |
74
- | `--mds-input-range-thumb-cursor` | Sets the thumb cursor |
75
- | `--mds-input-range-thumb-size` | Sets the thumb width and height of the component |
76
- | `--mds-input-range-track-background` | Sets the track background color |
77
- | `--mds-input-range-track-background-disabled` | Sets the track background color when the component is disabled |
78
- | `--mds-input-range-track-progress-background` | Sets the track progress background color |
79
- | `--mds-input-range-track-progress-background-disabled` | Sets the track progress background color when the component is disabled |
80
- | `--mds-input-range-track-size` | Sets the track width and height |
70
+ None is public: its 9 custom properties are internal and may change in any release. Style it with its props, its parts and the semantic roles.
81
71
 
82
72
  ## Dependencies
83
73
 
@@ -83,7 +83,7 @@ A `step` of zero or negative is invalid: as on a native input it is ignored and
83
83
 
84
84
  #### Do Not Pierce the Shadow DOM to Style the Track or Thumb
85
85
 
86
- The component exposes `::part(header)` and `::part(track)` plus the `--mds-input-range-*` CSS custom properties for all supported customization. Targeting internal class names via `>>>` or undocumented `::part()` names couples your code to the implementation and will break on minor releases.
86
+ The component exposes `::part(header)` and `::part(track)` for all supported customization; it has no public CSS custom property, and the thumb and the track take their colours from the theme. Targeting internal class names via `>>>` or undocumented `::part()` names couples your code to the implementation and will break on minor releases.
87
87
 
88
88
  ```css
89
89
  /* INCORRECT */
@@ -95,10 +95,6 @@ mds-input-range::part(thumb) { /* "thumb" is not a documented part */
95
95
  }
96
96
 
97
97
  /* CORRECT */
98
- mds-input-range {
99
- --mds-input-range-track-progress-background: rgb(var(--magma-accent-emphasis-hover));
100
- --mds-input-range-thumb-size: calc(var(--spacing) * 500);
101
- }
102
98
  mds-input-range::part(track) { /* "track" is a documented part */
103
99
  opacity: 0.8;
104
100
  }
@@ -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",
@@ -23,12 +23,16 @@
23
23
  {
24
24
  "name": "slot",
25
25
  "text": "- Add `text string`, `HTML elements` or `components` to this slot."
26
+ },
27
+ {
28
+ "name": "category",
29
+ "text": "forms"
26
30
  }
27
31
  ],
28
32
  "usage": {
29
- "1. Description": "The `<mds-input-range>` web component is the Magma Design System slider control for picking a single numeric value from a continuous interval. It wraps a native `<input type=\"range\">`, adding a labelled header, a styled track with a live progress fill, form association, and value formatting.\n\n#### Semantic Behavior\n\n- **Form association**: Inside a `<form>` the selected number is reported under `name` with no extra wiring. A form reset brings back the value of load, thumb and progress included, or the middle of the range when the markup sets no `value`, like a native input.\n- **Value clamping and snapping**: On input the value is clamped into `[min, max]` and snapped to the nearest `step` increment, so the committed `value` is always valid even when set programmatically out of range.\n- **Decimal awareness**: The number of decimal places is derived from `step`, letting fractional steps snap correctly; as on a native input, a `step` that is not a positive number, from the start or set later, falls back to the default step, `1`.\n- **Disabled state**: Blocks interaction and clears the reported form value while disabled. A disabled `<fieldset>` around the component does the same, as it does a native input.\n- **Emitted event**: `mdsInputRangeChange` carries the new numeric value whenever `value` actually changes.\n- **Accessibility**: The control takes its accessible name from the slotted label text.\n- **Default slot is the label**: The default slot holds the field's text label, rendered in the header alongside the formatted current value.\n\n#### Properties & Visual Configurations\n\n- **`min` / `max` / `step`** define the permitted interval and granularity; `step` also controls how fractional values are snapped and how many decimals are preserved.\n- **`value`** is the committed numeric selection, kept clamped and snapped - set it programmatically to move the thumb.\n- **`formatValue`** is a function `(value: number) => string` for presentation only: use it to render the header value as currency, a percentage, or a unit-suffixed label without changing the underlying numeric `value`.\n\nThis component does not use the shared `variant` / `tone` ladders ([`agents/variants.md`](../../../../agents/variants.md)); appearance is tuned through the documented CSS custom properties (thumb and track colors and sizes) listed in [`AGENTS.md`](AGENTS.md).\n",
30
- "2. Pattern": "Correct and idiomatic ways to use the `<mds-input-range>` 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 Slider with a Label\n\nThe minimum viable form. Put the field's text label in the default slot - it is rendered in the header and used as the accessible name for the underlying input. The default range is 0-100 with a step of 1.\n\n```html\n<mds-input-range name=\"volume\">Volume</mds-input-range>\n```\n\n#### Setting `min`, `max`, and `step`\n\nConstrain the range to a meaningful interval. Use `step` to enforce granularity - the component snaps the selected value to the nearest multiple automatically.\n\n```html\n<!-- Percentage slider, 5-point increments -->\n<mds-input-range name=\"completamento\" min=\"0\" max=\"100\" step=\"5\">Completamento (%)</mds-input-range>\n\n<!-- Temperature slider, half-degree steps -->\n<mds-input-range name=\"temperatura\" min=\"16\" max=\"30\" step=\"0.5\">Temperatura (C)</mds-input-range>\n```\n\n#### Pre-selected Value via `value`\n\nPass `value` to initialize the thumb at a specific position. The prop is reflected, so it also stays in sync when the user drags.\n\n```html\n<mds-input-range name=\"priorita\" min=\"1\" max=\"10\" value=\"7\">Priorita</mds-input-range>\n```\n\n#### Listening to `mdsInputRangeChange`\n\nThe component emits `mdsInputRangeChange` with the new numeric value in `event.detail` whenever the committed value changes. Do not listen to the raw `input` or `change` events - they may not bubble out of shadow DOM as expected.\n\n```html\n<mds-input-range id=\"rating\" name=\"valutazione\" min=\"1\" max=\"5\">Valutazione</mds-input-range>\n\n<script>\n document.querySelector('#rating').addEventListener('mdsInputRangeChange', (event) => {\n console.log('Nuovo valore:', event.detail);\n });\n</script>\n```\n\n#### Custom Value Display with `formatValue`\n\nSupply a `(value: number) => string` function to `formatValue` to change how the current value is shown in the header label - for example to add a unit suffix, format as currency, or humanize byte counts. The underlying numeric `value` is not affected.\n\n```html\n<mds-input-range id=\"prezzo\" name=\"prezzo\" min=\"0\" max=\"10000\" step=\"50\">Prezzo massimo</mds-input-range>\n\n<script>\n document.querySelector('#prezzo').formatValue = (v) =>\n v.toLocaleString('it-IT', { style: 'currency', currency: 'EUR' });\n</script>\n```\n\n#### Disabled Slider\n\nSet the boolean `disabled` attribute to prevent interaction. The component applies disabled visual tokens and clears the reported form value automatically. Do not use `disabled=\"false\"` to re-enable - remove the attribute instead.\n\n```html\n<mds-input-range name=\"soglia\" min=\"0\" max=\"100\" value=\"40\" disabled>Soglia (disabilitato)</mds-input-range>\n```\n\n#### Form Participation\n\n`<mds-input-range>` is form-associated. Place it inside a `<form>` with a `name` attribute and the selected value is submitted automatically alongside other fields.\n\n```html\n<form action=\"/impostazioni\" method=\"post\">\n <mds-input-range name=\"luminosita\" min=\"0\" max=\"100\" value=\"75\">Luminosita</mds-input-range>\n <mds-input-range name=\"contrasto\" min=\"0\" max=\"100\" value=\"50\">Contrasto</mds-input-range>\n\n <mds-button type=\"submit\" label=\"Salva impostazioni\" variant=\"primary\" tone=\"strong\"></mds-button>\n</form>\n```\n\n#### Hiding the Header via `::part(header)`\n\nUse `::part(header)` to hide the label-and-value header when the surrounding UI already provides that context - for example in a compact settings row where the label lives outside the component.\n\n```css\n.slider-compatto mds-input-range::part(header) {\n display: none;\n}\n```\n\n#### Styling Customization via CSS Custom Properties\n\nOverride the documented `--mds-input-range-*` custom properties on the host or a parent selector to change thumb and track appearance. Use the semantic color roles via `rgb(var(--magma-<role>))` ([`agents/color.md`](../../../../agents/color.md)) so dark mode and high-contrast work correctly. The thumb is drawn inside the track: keep `--mds-input-range-thumb-size` smaller than `--mds-input-range-track-size` (16px inside 24px by default).\n\n```css\n.slider-brand mds-input-range {\n --mds-input-range-thumb-background: rgb(var(--magma-accent-emphasis-hover));\n --mds-input-range-track-progress-background: rgb(var(--magma-accent-emphasis-hover));\n --mds-input-range-track-background: rgb(var(--magma-wash-base));\n --mds-input-range-thumb-size: calc(var(--spacing) * 500);\n --mds-input-range-track-size: calc(var(--spacing) * 700);\n}\n```\n",
31
- "3. Antipattern": "Common incorrect uses of `<mds-input-range>`. 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 a Raw `<input type=\"range\">` Instead of the Component\n\nReaching for the native element bypasses the Magma-styled track, the progress fill, the labelled header, form association wiring, and the snapping logic.\n\n```html\n<!-- INCORRECT -->\n<label for=\"v\">Volume</label>\n<input type=\"range\" id=\"v\" name=\"volume\" min=\"0\" max=\"100\">\n\n<!-- CORRECT -->\n<mds-input-range name=\"volume\" min=\"0\" max=\"100\">Volume</mds-input-range>\n```\n\n#### Do Not Omit the Label Slot\n\nWithout slotted text the slider has no accessible name - screen readers cannot announce the control's purpose. Always put a meaningful text label in the default slot.\n\n```html\n<!-- INCORRECT -->\n<mds-input-range name=\"luminosita\" min=\"0\" max=\"100\"></mds-input-range>\n\n<!-- CORRECT -->\n<mds-input-range name=\"luminosita\" min=\"0\" max=\"100\">Luminosita</mds-input-range>\n```\n\n#### Do Not Use `disabled=\"false\"` to Enable the Slider\n\n`disabled` is a boolean attribute and `mds-input-range` is form-associated: as on a native control, any value turns it on, `\"false\"` included, so this markup disables the slider. Remove the attribute entirely to enable it.\n\n```html\n<!-- INCORRECT -->\n<mds-input-range name=\"soglia\" disabled=\"false\">Soglia</mds-input-range>\n\n<!-- CORRECT -->\n<mds-input-range name=\"soglia\">Soglia</mds-input-range>\n```\n\n#### Do Not Listen to Raw `input` / `change` Events\n\nNative events may not bubble out of shadow DOM the way you expect. Listen to `mdsInputRangeChange`, which the component emits on every committed value change.\n\n```html\n<!-- INCORRECT -->\n<mds-input-range id=\"r\" name=\"valore\">Valore</mds-input-range>\n<script>\n document.querySelector('#r').addEventListener('change', (e) => {\n console.log(e.target.value); // unreliable across shadow DOM\n });\n</script>\n\n<!-- CORRECT -->\n<mds-input-range id=\"r\" name=\"valore\">Valore</mds-input-range>\n<script>\n document.querySelector('#r').addEventListener('mdsInputRangeChange', (e) => {\n console.log(e.detail); // numeric value, always reliable\n });\n</script>\n```\n\n#### Do Not Set `step` to Zero or a Negative Number\n\nA `step` of zero or negative is invalid: as on a native input it is ignored and the default step, `1`, applies instead, which is rarely the granularity you meant. Use a positive integer or decimal.\n\n```html\n<!-- INCORRECT -->\n<mds-input-range name=\"q\" step=\"0\">Quantita</mds-input-range>\n<mds-input-range name=\"q\" step=\"-1\">Quantita</mds-input-range>\n\n<!-- CORRECT -->\n<mds-input-range name=\"q\" step=\"1\">Quantita</mds-input-range>\n```\n\n#### Do Not Pierce the Shadow DOM to Style the Track or Thumb\n\nThe component exposes `::part(header)` and `::part(track)` plus the `--mds-input-range-*` CSS custom properties for all supported customization. Targeting internal class names via `>>>` or undocumented `::part()` names couples your code to the implementation and will break on minor releases.\n\n```css\n/* INCORRECT */\nmds-input-range >>> .track-progress {\n background-color: hotpink;\n}\nmds-input-range::part(thumb) { /* \"thumb\" is not a documented part */\n border-radius: 0;\n}\n\n/* CORRECT */\nmds-input-range {\n --mds-input-range-track-progress-background: rgb(var(--magma-accent-emphasis-hover));\n --mds-input-range-thumb-size: calc(var(--spacing) * 500);\n}\nmds-input-range::part(track) { /* \"track\" is a documented part */\n opacity: 0.8;\n}\n```\n\n#### Do Not Use `formatValue` to Change the Submitted Form Value\n\n`formatValue` is purely presentational - it only changes the header display string. The submitted form value is always the raw number. Do not rely on it for data transformation.\n\n```html\n<!-- INCORRECT: expecting the form to submit the formatted string -->\n<mds-input-range id=\"p\" name=\"prezzo\">Prezzo</mds-input-range>\n<script>\n // This changes what is shown but NOT what is submitted\n document.querySelector('#p').formatValue = (v) => v + ' EUR';\n // form.submit() still sends a plain number for \"prezzo\"\n</script>\n\n<!-- CORRECT: format on the server or in a submit handler using event.detail -->\n<mds-input-range id=\"p\" name=\"prezzo\">Prezzo</mds-input-range>\n<script>\n document.querySelector('#p').formatValue = (v) =>\n v.toLocaleString('it-IT', { style: 'currency', currency: 'EUR' });\n // The display is formatted; handle raw numeric value on submit separately\n</script>\n```\n"
33
+ "1. Description": "The `<mds-input-range>` web component is the Magma Design System slider control for picking a single numeric value from a continuous interval. It wraps a native `<input type=\"range\">`, adding a labelled header, a styled track with a live progress fill, form association, and value formatting.\n\n#### Semantic Behavior\n\n- **Form association**: Inside a `<form>` the selected number is reported under `name` with no extra wiring. A form reset brings back the value of load, thumb and progress included, or the middle of the range when the markup sets no `value`, like a native input.\n- **Value clamping and snapping**: On input the value is clamped into `[min, max]` and snapped to the nearest `step` increment, so the committed `value` is always valid even when set programmatically out of range.\n- **Decimal awareness**: The number of decimal places is derived from `step`, letting fractional steps snap correctly; as on a native input, a `step` that is not a positive number, from the start or set later, falls back to the default step, `1`.\n- **Disabled state**: Blocks interaction and clears the reported form value while disabled. A disabled `<fieldset>` around the component does the same, as it does a native input.\n- **Emitted event**: `mdsInputRangeChange` carries the new numeric value whenever `value` actually changes.\n- **Accessibility**: The control takes its accessible name from the slotted label text.\n- **Default slot is the label**: The default slot holds the field's text label, rendered in the header alongside the formatted current value.\n\n#### Properties & Visual Configurations\n\n- **`min` / `max` / `step`** define the permitted interval and granularity; `step` also controls how fractional values are snapped and how many decimals are preserved.\n- **`value`** is the committed numeric selection, kept clamped and snapped - set it programmatically to move the thumb.\n- **`formatValue`** is a function `(value: number) => string` for presentation only: use it to render the header value as currency, a percentage, or a unit-suffixed label without changing the underlying numeric `value`.\n\nThis component does not use the shared `variant` / `tone` ladders ([`agents/variants.md`](../../../../agents/variants.md)); it has no public CSS custom property: the thumb and the track follow the theme, and the `header` and `track` parts listed in [`AGENTS.md`](AGENTS.md) are its styling hooks.\n",
34
+ "2. Pattern": "Correct and idiomatic ways to use the `<mds-input-range>` 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 Slider with a Label\n\nThe minimum viable form. Put the field's text label in the default slot - it is rendered in the header and used as the accessible name for the underlying input. The default range is 0-100 with a step of 1.\n\n```html\n<mds-input-range name=\"volume\">Volume</mds-input-range>\n```\n\n#### Setting `min`, `max`, and `step`\n\nConstrain the range to a meaningful interval. Use `step` to enforce granularity - the component snaps the selected value to the nearest multiple automatically.\n\n```html\n<!-- Percentage slider, 5-point increments -->\n<mds-input-range name=\"completamento\" min=\"0\" max=\"100\" step=\"5\">Completamento (%)</mds-input-range>\n\n<!-- Temperature slider, half-degree steps -->\n<mds-input-range name=\"temperatura\" min=\"16\" max=\"30\" step=\"0.5\">Temperatura (C)</mds-input-range>\n```\n\n#### Pre-selected Value via `value`\n\nPass `value` to initialize the thumb at a specific position. The prop is reflected, so it also stays in sync when the user drags.\n\n```html\n<mds-input-range name=\"priorita\" min=\"1\" max=\"10\" value=\"7\">Priorita</mds-input-range>\n```\n\n#### Listening to `mdsInputRangeChange`\n\nThe component emits `mdsInputRangeChange` with the new numeric value in `event.detail` whenever the committed value changes. Do not listen to the raw `input` or `change` events - they may not bubble out of shadow DOM as expected.\n\n```html\n<mds-input-range id=\"rating\" name=\"valutazione\" min=\"1\" max=\"5\">Valutazione</mds-input-range>\n\n<script>\n document.querySelector('#rating').addEventListener('mdsInputRangeChange', (event) => {\n console.log('Nuovo valore:', event.detail);\n });\n</script>\n```\n\n#### Custom Value Display with `formatValue`\n\nSupply a `(value: number) => string` function to `formatValue` to change how the current value is shown in the header label - for example to add a unit suffix, format as currency, or humanize byte counts. The underlying numeric `value` is not affected.\n\n```html\n<mds-input-range id=\"prezzo\" name=\"prezzo\" min=\"0\" max=\"10000\" step=\"50\">Prezzo massimo</mds-input-range>\n\n<script>\n document.querySelector('#prezzo').formatValue = (v) =>\n v.toLocaleString('it-IT', { style: 'currency', currency: 'EUR' });\n</script>\n```\n\n#### Disabled Slider\n\nSet the boolean `disabled` attribute to prevent interaction. The component applies disabled visual tokens and clears the reported form value automatically. Do not use `disabled=\"false\"` to re-enable - remove the attribute instead.\n\n```html\n<mds-input-range name=\"soglia\" min=\"0\" max=\"100\" value=\"40\" disabled>Soglia (disabilitato)</mds-input-range>\n```\n\n#### Form Participation\n\n`<mds-input-range>` is form-associated. Place it inside a `<form>` with a `name` attribute and the selected value is submitted automatically alongside other fields.\n\n```html\n<form action=\"/impostazioni\" method=\"post\">\n <mds-input-range name=\"luminosita\" min=\"0\" max=\"100\" value=\"75\">Luminosita</mds-input-range>\n <mds-input-range name=\"contrasto\" min=\"0\" max=\"100\" value=\"50\">Contrasto</mds-input-range>\n\n <mds-button type=\"submit\" label=\"Salva impostazioni\" variant=\"primary\" tone=\"strong\"></mds-button>\n</form>\n```\n\n#### Hiding the Header via `::part(header)`\n\nUse `::part(header)` to hide the label-and-value header when the surrounding UI already provides that context - for example in a compact settings row where the label lives outside the component.\n\n```css\n.slider-compatto mds-input-range::part(header) {\n display: none;\n}\n```\n\n#### Styling Customization\n\n`<mds-input-range>` has no public CSS custom property: the thumb and the track take their sizes from the component and their colours from the semantic color roles ([`agents/color.md`](../../../../agents/color.md)), the progress from the accent, so themes and dark mode recolour it without overrides. Adjust the slider only through its documented `header` and `track` parts, as in the example above.\n",
35
+ "3. Antipattern": "Common incorrect uses of `<mds-input-range>`. 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 a Raw `<input type=\"range\">` Instead of the Component\n\nReaching for the native element bypasses the Magma-styled track, the progress fill, the labelled header, form association wiring, and the snapping logic.\n\n```html\n<!-- INCORRECT -->\n<label for=\"v\">Volume</label>\n<input type=\"range\" id=\"v\" name=\"volume\" min=\"0\" max=\"100\">\n\n<!-- CORRECT -->\n<mds-input-range name=\"volume\" min=\"0\" max=\"100\">Volume</mds-input-range>\n```\n\n#### Do Not Omit the Label Slot\n\nWithout slotted text the slider has no accessible name - screen readers cannot announce the control's purpose. Always put a meaningful text label in the default slot.\n\n```html\n<!-- INCORRECT -->\n<mds-input-range name=\"luminosita\" min=\"0\" max=\"100\"></mds-input-range>\n\n<!-- CORRECT -->\n<mds-input-range name=\"luminosita\" min=\"0\" max=\"100\">Luminosita</mds-input-range>\n```\n\n#### Do Not Use `disabled=\"false\"` to Enable the Slider\n\n`disabled` is a boolean attribute and `mds-input-range` is form-associated: as on a native control, any value turns it on, `\"false\"` included, so this markup disables the slider. Remove the attribute entirely to enable it.\n\n```html\n<!-- INCORRECT -->\n<mds-input-range name=\"soglia\" disabled=\"false\">Soglia</mds-input-range>\n\n<!-- CORRECT -->\n<mds-input-range name=\"soglia\">Soglia</mds-input-range>\n```\n\n#### Do Not Listen to Raw `input` / `change` Events\n\nNative events may not bubble out of shadow DOM the way you expect. Listen to `mdsInputRangeChange`, which the component emits on every committed value change.\n\n```html\n<!-- INCORRECT -->\n<mds-input-range id=\"r\" name=\"valore\">Valore</mds-input-range>\n<script>\n document.querySelector('#r').addEventListener('change', (e) => {\n console.log(e.target.value); // unreliable across shadow DOM\n });\n</script>\n\n<!-- CORRECT -->\n<mds-input-range id=\"r\" name=\"valore\">Valore</mds-input-range>\n<script>\n document.querySelector('#r').addEventListener('mdsInputRangeChange', (e) => {\n console.log(e.detail); // numeric value, always reliable\n });\n</script>\n```\n\n#### Do Not Set `step` to Zero or a Negative Number\n\nA `step` of zero or negative is invalid: as on a native input it is ignored and the default step, `1`, applies instead, which is rarely the granularity you meant. Use a positive integer or decimal.\n\n```html\n<!-- INCORRECT -->\n<mds-input-range name=\"q\" step=\"0\">Quantita</mds-input-range>\n<mds-input-range name=\"q\" step=\"-1\">Quantita</mds-input-range>\n\n<!-- CORRECT -->\n<mds-input-range name=\"q\" step=\"1\">Quantita</mds-input-range>\n```\n\n#### Do Not Pierce the Shadow DOM to Style the Track or Thumb\n\nThe component exposes `::part(header)` and `::part(track)` for all supported customization; it has no public CSS custom property, and the thumb and the track take their colours from the theme. Targeting internal class names via `>>>` or undocumented `::part()` names couples your code to the implementation and will break on minor releases.\n\n```css\n/* INCORRECT */\nmds-input-range >>> .track-progress {\n background-color: hotpink;\n}\nmds-input-range::part(thumb) { /* \"thumb\" is not a documented part */\n border-radius: 0;\n}\n\n/* CORRECT */\nmds-input-range::part(track) { /* \"track\" is a documented part */\n opacity: 0.8;\n}\n```\n\n#### Do Not Use `formatValue` to Change the Submitted Form Value\n\n`formatValue` is purely presentational - it only changes the header display string. The submitted form value is always the raw number. Do not rely on it for data transformation.\n\n```html\n<!-- INCORRECT: expecting the form to submit the formatted string -->\n<mds-input-range id=\"p\" name=\"prezzo\">Prezzo</mds-input-range>\n<script>\n // This changes what is shown but NOT what is submitted\n document.querySelector('#p').formatValue = (v) => v + ' EUR';\n // form.submit() still sends a plain number for \"prezzo\"\n</script>\n\n<!-- CORRECT: format on the server or in a submit handler using event.detail -->\n<mds-input-range id=\"p\" name=\"prezzo\">Prezzo</mds-input-range>\n<script>\n document.querySelector('#p').formatValue = (v) =>\n v.toLocaleString('it-IT', { style: 'currency', currency: 'EUR' });\n // The display is formatted; handle raw numeric value on submit separately\n</script>\n```\n"
32
36
  },
33
37
  "props": [
34
38
  {
@@ -241,47 +245,56 @@
241
245
  {
242
246
  "name": "--mds-input-range-thumb-background",
243
247
  "annotation": "prop",
244
- "docs": "Sets the thumb background color"
248
+ "docs": "Sets the thumb background color",
249
+ "visibility": "internal"
245
250
  },
246
251
  {
247
252
  "name": "--mds-input-range-thumb-background-disabled",
248
253
  "annotation": "prop",
249
- "docs": "Sets the thumb background color when the component is disabled"
254
+ "docs": "Sets the thumb background color when the component is disabled",
255
+ "visibility": "internal"
250
256
  },
251
257
  {
252
258
  "name": "--mds-input-range-thumb-cursor",
253
259
  "annotation": "prop",
254
- "docs": "Sets the thumb cursor"
260
+ "docs": "Sets the thumb cursor",
261
+ "visibility": "internal"
255
262
  },
256
263
  {
257
264
  "name": "--mds-input-range-thumb-size",
258
265
  "annotation": "prop",
259
- "docs": "Sets the thumb width and height of the component"
266
+ "docs": "Sets the thumb width and height of the component",
267
+ "visibility": "internal"
260
268
  },
261
269
  {
262
270
  "name": "--mds-input-range-track-background",
263
271
  "annotation": "prop",
264
- "docs": "Sets the track background color"
272
+ "docs": "Sets the track background color",
273
+ "visibility": "internal"
265
274
  },
266
275
  {
267
276
  "name": "--mds-input-range-track-background-disabled",
268
277
  "annotation": "prop",
269
- "docs": "Sets the track background color when the component is disabled"
278
+ "docs": "Sets the track background color when the component is disabled",
279
+ "visibility": "internal"
270
280
  },
271
281
  {
272
282
  "name": "--mds-input-range-track-progress-background",
273
283
  "annotation": "prop",
274
- "docs": "Sets the track progress background color"
284
+ "docs": "Sets the track progress background color",
285
+ "visibility": "internal"
275
286
  },
276
287
  {
277
288
  "name": "--mds-input-range-track-progress-background-disabled",
278
289
  "annotation": "prop",
279
- "docs": "Sets the track progress background color when the component is disabled"
290
+ "docs": "Sets the track progress background color when the component is disabled",
291
+ "visibility": "internal"
280
292
  },
281
293
  {
282
294
  "name": "--mds-input-range-track-size",
283
295
  "annotation": "prop",
284
- "docs": "Sets the track width and height"
296
+ "docs": "Sets the track width and height",
297
+ "visibility": "internal"
285
298
  }
286
299
  ],
287
300
  "slots": [
@@ -5,6 +5,7 @@ import { preferenceStore } from "../../common/preference";
5
5
  * @part header - The element containing the labels displayed over the input element
6
6
  * @part track - The element containing the track of the input range
7
7
  * @slot - Add `text string`, `HTML elements` or `components` to this slot.
8
+ * @category forms
8
9
  */
9
10
  export class MdsInputRange {
10
11
  constructor() {
@@ -112,7 +113,7 @@ export class MdsInputRange {
112
113
  }
113
114
  render() {
114
115
  var _a;
115
- return (h(Host, { key: '7588d9e5f1f0657ae63ba23cad5d3d8faee3ff17', "pref-animation": preferenceStore.state.animation, "pref-contrast": preferenceStore.state.contrast, "pref-mode": preferenceStore.state.mode, "pref-theme-scheme": preferenceStore.state['theme-scheme'] }, h("header", { key: 'fbd890516bc521d3dc46c63ad98ee981a08cc459', class: "header", part: "header" }, h("mds-text", { key: '361e2b3f13dfc017e873865853ef77ef47332434', class: "label", typography: "label" }, h("slot", { key: '95335d7a71e2674d95e850fa9a45074e060daff4' })), h("mds-text", { key: '6897c798d09be9f92b1295eb67177ef1bd30f98c', class: "value", typography: "label" }, this.formatValue ? this.formatValue(this.value) : this.value)), h("div", { key: '47550ba3617f33dafcf2547ad57ecedf11cffc6b', class: "range" }, h("div", { key: 'bf3c5e9a8f4b15a8c6e545670e628952fcd19393', class: "track", part: "track" }, h("div", { key: '95626574ed8adb96f06a8a321a68a2e6bbe37401', class: "contrast-area" }), h("div", { key: '6e15a6d2c583415382af4eec1e142e22698c8079', class: "track-total" }, h("div", { key: 'ea257f325270545f8f76bb6b911dfe17a5f2efd7', class: "track-progress", style: { '--mds-input-range-progress': `${(_a = this.progress) !== null && _a !== void 0 ? _a : 0}` } }))), h("input", { key: '7302c7d6348c7844c90804676c29236082204e87', ref: (el) => (this.inputElement = el), class: "field", "aria-label": this.label, disabled: this.isDisabled(), max: this.max, min: this.min, onInput: this.onInput, step: this.step, type: "range", value: this.value, name: this.name }))));
116
+ return (h(Host, { key: 'b1bb72d1ce011daf8b9789552582dc322c669c7b', "pref-animation": preferenceStore.state.animation, "pref-contrast": preferenceStore.state.contrast, "pref-mode": preferenceStore.state.mode, "pref-theme-scheme": preferenceStore.state['theme-scheme'] }, h("header", { key: 'c1d1b18c93995b14620443d6be50a082b8636944', class: "header", part: "header" }, h("mds-text", { key: '37fc5d597ed5619d77863a361405d9e9968c8a1a', class: "label", typography: "label" }, h("slot", { key: '7252b13a7883cb3b24c2ddcffa69063a851bdb6a' })), h("mds-text", { key: '8114e8abc0fa86ba7b36186c2101da009c3586e6', class: "value", typography: "label" }, this.formatValue ? this.formatValue(this.value) : this.value)), h("div", { key: '8d057e743855fb1f7319f02eb09ba9ade58e8ae0', class: "range" }, h("div", { key: 'e987fcd7360c4749cf8bc5a69d655f3a50a9ce07', class: "track", part: "track" }, h("div", { key: 'af736932ab9f24030342dc7356b2425fcc46a20b', class: "contrast-area" }), h("div", { key: '97029a596bde3c6f0d43ec3a641094a75da03f04', class: "track-total" }, h("div", { key: 'ec03d154670b09bcfac52cdc2f604c131ce15d62', class: "track-progress", style: { '--mds-input-range-progress': `${(_a = this.progress) !== null && _a !== void 0 ? _a : 0}` } }))), h("input", { key: '38652b6913977164bc43754353ab02eb3e949e3d', ref: (el) => (this.inputElement = el), class: "field", "aria-label": this.label, disabled: this.isDisabled(), max: this.max, min: this.min, onInput: this.onInput, step: this.step, type: "range", value: this.value, name: this.name }))));
116
117
  }
117
118
  static get is() { return "mds-input-range"; }
118
119
  static get encapsulation() { return "shadow"; }
@@ -95,16 +95,6 @@ Use `::part(header)` to hide the label-and-value header when the surrounding UI
95
95
  }
96
96
  ```
97
97
 
98
- #### Styling Customization via CSS Custom Properties
98
+ #### Styling Customization
99
99
 
100
- Override the documented `--mds-input-range-*` custom properties on the host or a parent selector to change thumb and track appearance. Use the semantic color roles via `rgb(var(--magma-<role>))` ([`agents/color.md`](../../../../agents/color.md)) so dark mode and high-contrast work correctly. The thumb is drawn inside the track: keep `--mds-input-range-thumb-size` smaller than `--mds-input-range-track-size` (16px inside 24px by default).
101
-
102
- ```css
103
- .slider-brand mds-input-range {
104
- --mds-input-range-thumb-background: rgb(var(--magma-accent-emphasis-hover));
105
- --mds-input-range-track-progress-background: rgb(var(--magma-accent-emphasis-hover));
106
- --mds-input-range-track-background: rgb(var(--magma-wash-base));
107
- --mds-input-range-thumb-size: calc(var(--spacing) * 500);
108
- --mds-input-range-track-size: calc(var(--spacing) * 700);
109
- }
110
- ```
100
+ `<mds-input-range>` has no public CSS custom property: the thumb and the track take their sizes from the component and their colours from the semantic color roles ([`agents/color.md`](../../../../agents/color.md)), the progress from the accent, so themes and dark mode recolour it without overrides. Adjust the slider only through its documented `header` and `track` parts, as in the example above.
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-input-select
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-input-select>` web component is the Magma Design System single- and multi-choice dropdown control. It wraps a native `<select>` element, adding form association, accessible status feedback, and themed chrome while accepting plain `<option>` elements through its default slot.
12
12
 
@@ -87,16 +87,12 @@ The `variant` prop applies a status appearance drawn from the shared status ladd
87
87
 
88
88
  | Property | Description |
89
89
  | --- | --- |
90
- | `--mds-input-select-arrow-icon-background-color` | Background color behind the arrow icon |
91
- | `--mds-input-select-arrow-icon-blur-background-color` | Transparent background used for blurred states of the arrow icon |
92
- | `--mds-input-select-arrow-icon-blur-color` | Color applied to the arrow icon in blurred states |
93
- | `--mds-input-select-arrow-icon-color` | Default arrow icon color |
94
- | `--mds-input-select-arrow-icon-hover-background-color` | Background color of the arrow icon when hovered |
95
- | `--mds-input-select-arrow-icon-hover-color` | Color of the arrow icon when hovered |
96
90
  | `--mds-input-select-ring` | Ring applied around the select at rest; hover and focus draw a 3px ring in the variant color |
97
91
  | `--mds-input-select-shadow` | Shadow applied to the select component |
98
92
  | `--mds-input-select-variant-color-rgb` | Base color used to derive all select component visual states |
99
93
 
94
+ Only these are public. Its other 6 are internal: they may change in any release, do not set them.
95
+
100
96
  ## Dependencies
101
97
 
102
98
  Uses: `mds-icon`, `mds-input-tip`, `mds-input-tip-item`.
@@ -69,7 +69,7 @@ The default slot is reserved for `<option>` and `<optgroup>` elements. The compo
69
69
 
70
70
  #### Do Not Pierce the Shadow DOM to Style the Inner `<select>`
71
71
 
72
- The supported customization surface is the documented `--mds-input-select-*` CSS custom properties and the two shadow parts (`select`, `tip-top`). Targeting internal elements with `>>>` or undocumented selectors couples your code to the implementation and breaks on minor releases.
72
+ The supported customization surface is the public `--mds-input-select-*` CSS custom properties and the two shadow parts (`select`, `tip-top`). Targeting internal elements with `>>>` or undocumented selectors couples your code to the implementation and breaks on minor releases.
73
73
 
74
74
  ```css
75
75
  /* INCORRECT */
@@ -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",
@@ -23,12 +23,16 @@
23
23
  {
24
24
  "name": "slot",
25
25
  "text": "- Add `option` `HTML elements` or `components` to this slot."
26
+ },
27
+ {
28
+ "name": "category",
29
+ "text": "forms"
26
30
  }
27
31
  ],
28
32
  "usage": {
29
33
  "1. Description": "The `<mds-input-select>` web component is the Magma Design System single- and multi-choice dropdown control. It wraps a native `<select>` element, adding form association, accessible status feedback, and themed chrome while accepting plain `<option>` elements through its default slot.\n\n#### Semantic Behavior\n\n- **Native select wrapping**: It renders a real `<select>` (exposed as the `select` part) so keyboard, type-ahead, and platform option lists work natively; the host owns theming and status only.\n- **Slotted options**: The default slot accepts `<option>` (and `<optgroup>`) markup; the current selection re-syncs whenever the slotted content changes.\n- **Form association**: The selection is pushed to the host form: a single select submits its `value`, a `multiple` one an entry per selected option under `name`, as a native select. A form reset brings back the selection of load, like a native select: the options the markup marks `selected` (or the placeholder), with the `value` of load on top. Toggling `disabled` removes the value from the submitted form data.\n- **Disabled fieldset**: A disabled `<fieldset>` around the component disables it as `disabled` does, like a native control: it cannot be changed and its value is left out of the form, until the fieldset is enabled.\n- **Form validity**: A `required` select left empty is reported to the form as a native one: it matches `:invalid` and stops the submit, with a message in the page language. A disabled select is left out, and `novalidate` on the `<form>` turns the check off.\n- **Value syncing**: Changing the selection (by user input, the `setValue()` method, or the prop) emits `mdsInputSelectChange` with `{ value, values }` in `detail`: `value` is the first selected option as a string, `values` the values of every selected option, the placeholder left out. Like a native `<select>`, it is not emitted on load: the selection the component starts with reaches the form, not the event. A `value` set by code selects its `<option>` alone, as `select.value` does, and a value cleared by code goes back to the placeholder.\n- **Placeholder option**: When `placeholder` is set, a leading empty-value `<option>` is injected as the first entry; if `required` is set that placeholder is disabled so it cannot be re-selected after a valid choice.\n- **Default selection fallback**: With no explicit value, the options the markup marks `selected` become the selection; without them, the placeholder or, with no placeholder, the first option of a single select. A `defaultValue` seeds `value` at load.\n- **Status tip**: A status tip surfaces verbose state - a disabled notice, and for required fields a `required` / `required-success` message that expands while the control has focus.\n\n#### Properties & Visual Configurations\n\nThe `variant` prop applies a status appearance drawn from the shared status ladder in [`agents/variants.md`](../../../../agents/variants.md) - use it to reflect validation outcome (`'error'`, `'success'`, `'warning'`, `'info'`) rather than decorative styling. This component exposes no separate `tone` prop.\n\n- **`size`** sets the height of the field, the same as [`<mds-button>`](../mds-button/AGENTS.md): `sm` 28px, `md` 36px, `lg` 48px (default). Match it to the buttons next to the field, or go smaller in dense layouts (filter bars, table toolbars); the text style stays the same, the padding and the inner arrow scale with it.\n\n#### Other behavioral props\n\n- **`multiple`** turns the control into a multi-select list box: the form gets an entry per selected option and `values` in the `mdsInputSelectChange` detail lists them all, while `value` holds the first one, as `select.value` does. **`rows`** sets how many option rows are visible at once, as the `size` of a native `<select>`: above `1` it shows a list box even without `multiple`. A number in `size`, the row count it used to set, still works as `rows` but warns: it is deprecated and goes in the next major.\n- **`defaultValue`** is the initial selection used to seed the value at load (notably for the React wrapper), distinct from the live `value` that reflects the current choice.\n- **`required`** both enforces a non-empty submission and locks the placeholder option so the empty entry cannot be chosen again.\n",
30
- "2. Pattern": "Correct and idiomatic ways to use the `<mds-input-select>` component, ordered from most common to most specialized. Patterns assume a working knowledge of the variant / tone ladders documented in [`agents/variants.md`](../../../../agents/variants.md) and the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Basic Select with Placeholder\n\nThe canonical form. Slot plain `<option>` elements as direct children. Set `placeholder` to inject a leading empty-value entry that prompts the user before a choice is made.\n\n```html\n<mds-input-select name=\"categoria\" placeholder=\"Seleziona una categoria...\">\n <option value=\"news\">Notizie</option>\n <option value=\"eventi\">Eventi</option>\n <option value=\"avvisi\">Avvisi</option>\n</mds-input-select>\n```\n\n#### Required Select Inside a Form\n\nAdding `required` enforces a non-empty submission - an empty select stops the submit like a native one - and disables the placeholder option once a valid choice exists, so users cannot revert to the empty entry. Place the component inside a `<form>` - it is form-associated and submits natively.\n\n```html\n<form action=\"/salva\" method=\"post\">\n <mds-input-select name=\"regione\" required placeholder=\"Scegli la regione...\">\n <option value=\"lombardia\">Lombardia</option>\n <option value=\"veneto\">Veneto</option>\n <option value=\"toscana\">Toscana</option>\n </mds-input-select>\n <mds-button type=\"submit\" label=\"Invia\" variant=\"primary\" tone=\"strong\"></mds-button>\n</form>\n```\n\n#### Pre-selected Value via `value`\n\nPass `value` to open the component with a specific option already chosen. The matching `<option>` is marked selected automatically. Use `default-value` instead when the initial selection is set once at load and you do not need live two-way binding (notably in the React wrapper).\n\n```html\n<!-- Live controlled value -->\n<mds-input-select name=\"priorita\" value=\"alta\">\n <option value=\"bassa\">Bassa</option>\n <option value=\"media\">Media</option>\n <option value=\"alta\">Alta</option>\n</mds-input-select>\n\n<!-- Initial seed value for React / SSR -->\n<mds-input-select name=\"priorita\" default-value=\"media\">\n <option value=\"bassa\">Bassa</option>\n <option value=\"media\">Media</option>\n <option value=\"alta\">Alta</option>\n</mds-input-select>\n```\n\n#### Listening to Value Changes\n\nListen to `mdsInputSelectChange` - do not rely on the native `change` event, which may not bubble out of shadow DOM reliably. The event detail carries the chosen value as a string in `value`, and the values of every selected option in `values`.\n\n```html\n<mds-input-select id=\"stato-pratica\" name=\"stato\" placeholder=\"Seleziona stato...\">\n <option value=\"bozza\">Bozza</option>\n <option value=\"in-lavorazione\">In lavorazione</option>\n <option value=\"chiusa\">Chiusa</option>\n</mds-input-select>\n\n<script>\n document.getElementById('stato-pratica')\n .addEventListener('mdsInputSelectChange', (event) => {\n console.log('Nuovo stato:', event.detail.value);\n });\n</script>\n```\n\n#### Programmatic Value via `setValue()`\n\nUse the `setValue()` async method when you need to change the selection from JavaScript after the component has rendered - for example when a related control resets the form state.\n\n```html\n<mds-input-select id=\"provincia\" name=\"provincia\" placeholder=\"Seleziona provincia...\">\n <option value=\"MI\">Milano</option>\n <option value=\"RM\">Roma</option>\n <option value=\"TO\">Torino</option>\n</mds-input-select>\n\n<script>\n async function resetSelezione() {\n const el = document.getElementById('provincia');\n await el.setValue('MI');\n }\n</script>\n```\n\n#### Disabled State\n\nSet `disabled` as a boolean attribute to block interaction and remove the value from the submitted form data. A status tip is shown automatically while the component is disabled.\n\n```html\n<mds-input-select name=\"tipo-contratto\" disabled placeholder=\"Non disponibile\">\n <option value=\"td\">Tempo determinato</option>\n <option value=\"ti\">Tempo indeterminato</option>\n</mds-input-select>\n```\n\n#### Multi-select List Box\n\n`multiple` switches the component to a scrollable list that allows zero or more simultaneous selections. Use `rows` to control how many rows are visible without scrolling (`size` sets the height of the field). Mark the options to preselect with `selected`, as in a native `<select multiple>`. The form submits an entry per selected option under `name`, and `values` in the `mdsInputSelectChange` detail lists them all; `value` holds only the first one, as `select.value` does.\n\n```html\n<mds-input-select name=\"competenze\" multiple rows=\"4\">\n <option value=\"js\" selected>JavaScript</option>\n <option value=\"ts\" selected>TypeScript</option>\n <option value=\"css\">CSS</option>\n <option value=\"html\">HTML</option>\n <option value=\"react\">React</option>\n</mds-input-select>\n```\n\n#### Grouped Options via `<optgroup>`\n\nThe default slot also accepts `<optgroup>` elements. Use them to group related options under a visible label.\n\n```html\n<mds-input-select name=\"comune\" placeholder=\"Seleziona comune...\">\n <optgroup label=\"Lombardia\">\n <option value=\"MI\">Milano</option>\n <option value=\"BS\">Brescia</option>\n </optgroup>\n <optgroup label=\"Veneto\">\n <option value=\"VE\">Venezia</option>\n <option value=\"VR\">Verona</option>\n </optgroup>\n</mds-input-select>\n```\n\n#### Variant for Validation Feedback\n\nSet `variant` to one of the status values (`error`, `success`, `warning`, `info`) to communicate the validation outcome visually. Use this after a form submission or inline validation, not as decorative styling.\n\n```html\n<!-- Errore di validazione -->\n<mds-input-select name=\"tipologia\" variant=\"error\" required placeholder=\"Seleziona tipologia...\">\n <option value=\"A\">Tipo A</option>\n <option value=\"B\">Tipo B</option>\n</mds-input-select>\n\n<!-- Selezione valida confermata -->\n<mds-input-select name=\"tipologia\" variant=\"success\" value=\"A\">\n <option value=\"A\">Tipo A</option>\n <option value=\"B\">Tipo B</option>\n</mds-input-select>\n```\n\n#### Styling Customization\n\nCustomize the component only through its documented `--mds-input-select-*` CSS custom properties. Set them on the host or a parent selector; use the semantic color roles ([`agents/color.md`](../../../../agents/color.md)) so dark mode and high-contrast modes continue to work correctly. `--mds-input-select-variant-color-rgb` takes a bare RGB triplet (`var(--magma-<role>)`, no `rgb()`); the other properties take a color (`rgb(var(--magma-<role>))`). `--mds-input-select-ring` is the ring at rest: on hover and focus the select draws its own 3px ring in the variant color, so the focus stays visible whatever the ring at rest, in dark mode and with more contrast too; change its color through `--mds-input-select-variant-color-rgb`.\n\n```css\n.sidebar-filter mds-input-select {\n --mds-input-select-variant-color-rgb: var(--magma-accent-emphasis);\n --mds-input-select-arrow-icon-hover-color: rgb(var(--magma-accent-fg));\n --mds-input-select-arrow-icon-hover-background-color: rgb(var(--magma-accent-surface-hover));\n --mds-input-select-ring: 0 0 0 2px rgb(var(--magma-accent-emphasis) / 0.8);\n}\n```\n",
31
- "3. Antipattern": "Common incorrect uses of `<mds-input-select>`. 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 Slot Non-Option Elements\n\nThe default slot is reserved for `<option>` and `<optgroup>` elements. The component clones slot children into the inner `<select>`; any other element is copied verbatim and makes the native select malformed.\n\n```html\n<!-- INCORRECT -->\n<mds-input-select name=\"categoria\">\n <div class=\"option-group\">\n <span>Notizie</span>\n <span>Eventi</span>\n </div>\n</mds-input-select>\n\n<!-- CORRECT -->\n<mds-input-select name=\"categoria\" placeholder=\"Seleziona...\">\n <option value=\"news\">Notizie</option>\n <option value=\"eventi\">Eventi</option>\n</mds-input-select>\n```\n\n#### Do Not Listen to the Native `change` Event\n\n`<mds-input-select>` wraps a shadow-DOM `<select>`; the native `change` event does not bubble out of shadow DOM reliably. Always listen to the documented `mdsInputSelectChange` custom event instead.\n\n```html\n<!-- INCORRECT -->\n<mds-input-select id=\"sel\" name=\"tipo\"></mds-input-select>\n<script>\n document.getElementById('sel').addEventListener('change', (e) => {\n console.log(e.target.value); // may be undefined or stale\n });\n</script>\n\n<!-- CORRECT -->\n<mds-input-select id=\"sel\" name=\"tipo\"></mds-input-select>\n<script>\n document.getElementById('sel').addEventListener('mdsInputSelectChange', (e) => {\n console.log(e.detail.value);\n });\n</script>\n```\n\n#### Do Not Use `variant` for Decorative Styling\n\n`variant` maps to `ThemeStatusVariantType` (`error`, `success`, `warning`, `info`). It is meant to communicate a validation outcome, not to apply a brand color. Using a status variant to make the component visually match a section's color theme misleads users about the control's validation state.\n\n```html\n<!-- INCORRECT - using 'info' just for a blue accent -->\n<mds-input-select name=\"argomento\" variant=\"info\">\n <option value=\"A\">Argomento A</option>\n</mds-input-select>\n\n<!-- CORRECT - set variant only to reflect real validation state -->\n<mds-input-select name=\"argomento\" variant=\"error\" required placeholder=\"Obbligatorio\">\n <option value=\"A\">Argomento A</option>\n</mds-input-select>\n```\n\n#### Do Not Pierce the Shadow DOM to Style the Inner `<select>`\n\nThe supported customization surface is the documented `--mds-input-select-*` CSS custom properties and the two shadow parts (`select`, `tip-top`). Targeting internal elements with `>>>` or undocumented selectors couples your code to the implementation and breaks on minor releases.\n\n```css\n/* INCORRECT */\nmds-input-select >>> select {\n font-size: 1rem;\n border: 2px solid red;\n}\n\n/* CORRECT */\nmds-input-select {\n --mds-input-select-ring: 0 0 0 2px rgb(var(--magma-danger-emphasis));\n --mds-input-select-variant-color-rgb: var(--magma-danger-emphasis);\n}\nmds-input-select::part(select) {\n font-size: 1rem;\n}\n```\n\n#### Do Not Set `placeholder` When You Need a Real Default Selection\n\n`placeholder` injects an empty-value leading option that disappears from valid choices once `required` is set. If you want the component to open with a specific option pre-selected, use `value` or `default-value` instead.\n\n```html\n<!-- INCORRECT - a real value supplied as placeholder text -->\n<mds-input-select name=\"priorita\" placeholder=\"Media\">\n <option value=\"bassa\">Bassa</option>\n <option value=\"media\">Media</option>\n <option value=\"alta\">Alta</option>\n</mds-input-select>\n\n<!-- CORRECT - use value to pre-select a real option -->\n<mds-input-select name=\"priorita\" value=\"media\">\n <option value=\"bassa\">Bassa</option>\n <option value=\"media\">Media</option>\n <option value=\"alta\">Alta</option>\n</mds-input-select>\n```\n\n#### Do Not Replace with a Raw `<select>`\n\n`<mds-input-select>` provides theming, accessible status tips, form-reset integration, and dark/high-contrast support. Reaching for a plain `<select>` bypasses all of that and breaks visual consistency across themes.\n\n```html\n<!-- INCORRECT -->\n<select name=\"categoria\" class=\"form-select\">\n <option value=\"\">Seleziona...</option>\n <option value=\"A\">Categoria A</option>\n</select>\n\n<!-- CORRECT -->\n<mds-input-select name=\"categoria\" placeholder=\"Seleziona...\">\n <option value=\"A\">Categoria A</option>\n</mds-input-select>\n```\n"
34
+ "2. Pattern": "Correct and idiomatic ways to use the `<mds-input-select>` component, ordered from most common to most specialized. Patterns assume a working knowledge of the variant / tone ladders documented in [`agents/variants.md`](../../../../agents/variants.md) and the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Basic Select with Placeholder\n\nThe canonical form. Slot plain `<option>` elements as direct children. Set `placeholder` to inject a leading empty-value entry that prompts the user before a choice is made.\n\n```html\n<mds-input-select name=\"categoria\" placeholder=\"Seleziona una categoria...\">\n <option value=\"news\">Notizie</option>\n <option value=\"eventi\">Eventi</option>\n <option value=\"avvisi\">Avvisi</option>\n</mds-input-select>\n```\n\n#### Required Select Inside a Form\n\nAdding `required` enforces a non-empty submission - an empty select stops the submit like a native one - and disables the placeholder option once a valid choice exists, so users cannot revert to the empty entry. Place the component inside a `<form>` - it is form-associated and submits natively.\n\n```html\n<form action=\"/salva\" method=\"post\">\n <mds-input-select name=\"regione\" required placeholder=\"Scegli la regione...\">\n <option value=\"lombardia\">Lombardia</option>\n <option value=\"veneto\">Veneto</option>\n <option value=\"toscana\">Toscana</option>\n </mds-input-select>\n <mds-button type=\"submit\" label=\"Invia\" variant=\"primary\" tone=\"strong\"></mds-button>\n</form>\n```\n\n#### Pre-selected Value via `value`\n\nPass `value` to open the component with a specific option already chosen. The matching `<option>` is marked selected automatically. Use `default-value` instead when the initial selection is set once at load and you do not need live two-way binding (notably in the React wrapper).\n\n```html\n<!-- Live controlled value -->\n<mds-input-select name=\"priorita\" value=\"alta\">\n <option value=\"bassa\">Bassa</option>\n <option value=\"media\">Media</option>\n <option value=\"alta\">Alta</option>\n</mds-input-select>\n\n<!-- Initial seed value for React / SSR -->\n<mds-input-select name=\"priorita\" default-value=\"media\">\n <option value=\"bassa\">Bassa</option>\n <option value=\"media\">Media</option>\n <option value=\"alta\">Alta</option>\n</mds-input-select>\n```\n\n#### Listening to Value Changes\n\nListen to `mdsInputSelectChange` - do not rely on the native `change` event, which may not bubble out of shadow DOM reliably. The event detail carries the chosen value as a string in `value`, and the values of every selected option in `values`.\n\n```html\n<mds-input-select id=\"stato-pratica\" name=\"stato\" placeholder=\"Seleziona stato...\">\n <option value=\"bozza\">Bozza</option>\n <option value=\"in-lavorazione\">In lavorazione</option>\n <option value=\"chiusa\">Chiusa</option>\n</mds-input-select>\n\n<script>\n document.getElementById('stato-pratica')\n .addEventListener('mdsInputSelectChange', (event) => {\n console.log('Nuovo stato:', event.detail.value);\n });\n</script>\n```\n\n#### Programmatic Value via `setValue()`\n\nUse the `setValue()` async method when you need to change the selection from JavaScript after the component has rendered - for example when a related control resets the form state.\n\n```html\n<mds-input-select id=\"provincia\" name=\"provincia\" placeholder=\"Seleziona provincia...\">\n <option value=\"MI\">Milano</option>\n <option value=\"RM\">Roma</option>\n <option value=\"TO\">Torino</option>\n</mds-input-select>\n\n<script>\n async function resetSelezione() {\n const el = document.getElementById('provincia');\n await el.setValue('MI');\n }\n</script>\n```\n\n#### Disabled State\n\nSet `disabled` as a boolean attribute to block interaction and remove the value from the submitted form data. A status tip is shown automatically while the component is disabled.\n\n```html\n<mds-input-select name=\"tipo-contratto\" disabled placeholder=\"Non disponibile\">\n <option value=\"td\">Tempo determinato</option>\n <option value=\"ti\">Tempo indeterminato</option>\n</mds-input-select>\n```\n\n#### Multi-select List Box\n\n`multiple` switches the component to a scrollable list that allows zero or more simultaneous selections. Use `rows` to control how many rows are visible without scrolling (`size` sets the height of the field). Mark the options to preselect with `selected`, as in a native `<select multiple>`. The form submits an entry per selected option under `name`, and `values` in the `mdsInputSelectChange` detail lists them all; `value` holds only the first one, as `select.value` does.\n\n```html\n<mds-input-select name=\"competenze\" multiple rows=\"4\">\n <option value=\"js\" selected>JavaScript</option>\n <option value=\"ts\" selected>TypeScript</option>\n <option value=\"css\">CSS</option>\n <option value=\"html\">HTML</option>\n <option value=\"react\">React</option>\n</mds-input-select>\n```\n\n#### Grouped Options via `<optgroup>`\n\nThe default slot also accepts `<optgroup>` elements. Use them to group related options under a visible label.\n\n```html\n<mds-input-select name=\"comune\" placeholder=\"Seleziona comune...\">\n <optgroup label=\"Lombardia\">\n <option value=\"MI\">Milano</option>\n <option value=\"BS\">Brescia</option>\n </optgroup>\n <optgroup label=\"Veneto\">\n <option value=\"VE\">Venezia</option>\n <option value=\"VR\">Verona</option>\n </optgroup>\n</mds-input-select>\n```\n\n#### Variant for Validation Feedback\n\nSet `variant` to one of the status values (`error`, `success`, `warning`, `info`) to communicate the validation outcome visually. Use this after a form submission or inline validation, not as decorative styling.\n\n```html\n<!-- Errore di validazione -->\n<mds-input-select name=\"tipologia\" variant=\"error\" required placeholder=\"Seleziona tipologia...\">\n <option value=\"A\">Tipo A</option>\n <option value=\"B\">Tipo B</option>\n</mds-input-select>\n\n<!-- Selezione valida confermata -->\n<mds-input-select name=\"tipologia\" variant=\"success\" value=\"A\">\n <option value=\"A\">Tipo A</option>\n <option value=\"B\">Tipo B</option>\n</mds-input-select>\n```\n\n#### Styling Customization\n\nCustomize the component only through its public `--mds-input-select-*` CSS custom properties. Set them on the host or a parent selector; use the semantic color roles ([`agents/color.md`](../../../../agents/color.md)) so dark mode and high-contrast modes continue to work correctly. `--mds-input-select-variant-color-rgb` takes a bare RGB triplet (`var(--magma-<role>)`, no `rgb()`); `--mds-input-select-ring` and `--mds-input-select-shadow` take a box-shadow, its color written as `rgb(var(--magma-<role>))`. `--mds-input-select-ring` is the ring at rest: on hover and focus the select draws its own 3px ring in the variant color, so the focus stays visible whatever the ring at rest, in dark mode and with more contrast too; change its color through `--mds-input-select-variant-color-rgb`.\n\n```css\n.sidebar-filter mds-input-select {\n --mds-input-select-variant-color-rgb: var(--magma-accent-emphasis);\n --mds-input-select-ring: 0 0 0 2px rgb(var(--magma-accent-emphasis) / 0.8);\n}\n```\n",
35
+ "3. Antipattern": "Common incorrect uses of `<mds-input-select>`. 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 Slot Non-Option Elements\n\nThe default slot is reserved for `<option>` and `<optgroup>` elements. The component clones slot children into the inner `<select>`; any other element is copied verbatim and makes the native select malformed.\n\n```html\n<!-- INCORRECT -->\n<mds-input-select name=\"categoria\">\n <div class=\"option-group\">\n <span>Notizie</span>\n <span>Eventi</span>\n </div>\n</mds-input-select>\n\n<!-- CORRECT -->\n<mds-input-select name=\"categoria\" placeholder=\"Seleziona...\">\n <option value=\"news\">Notizie</option>\n <option value=\"eventi\">Eventi</option>\n</mds-input-select>\n```\n\n#### Do Not Listen to the Native `change` Event\n\n`<mds-input-select>` wraps a shadow-DOM `<select>`; the native `change` event does not bubble out of shadow DOM reliably. Always listen to the documented `mdsInputSelectChange` custom event instead.\n\n```html\n<!-- INCORRECT -->\n<mds-input-select id=\"sel\" name=\"tipo\"></mds-input-select>\n<script>\n document.getElementById('sel').addEventListener('change', (e) => {\n console.log(e.target.value); // may be undefined or stale\n });\n</script>\n\n<!-- CORRECT -->\n<mds-input-select id=\"sel\" name=\"tipo\"></mds-input-select>\n<script>\n document.getElementById('sel').addEventListener('mdsInputSelectChange', (e) => {\n console.log(e.detail.value);\n });\n</script>\n```\n\n#### Do Not Use `variant` for Decorative Styling\n\n`variant` maps to `ThemeStatusVariantType` (`error`, `success`, `warning`, `info`). It is meant to communicate a validation outcome, not to apply a brand color. Using a status variant to make the component visually match a section's color theme misleads users about the control's validation state.\n\n```html\n<!-- INCORRECT - using 'info' just for a blue accent -->\n<mds-input-select name=\"argomento\" variant=\"info\">\n <option value=\"A\">Argomento A</option>\n</mds-input-select>\n\n<!-- CORRECT - set variant only to reflect real validation state -->\n<mds-input-select name=\"argomento\" variant=\"error\" required placeholder=\"Obbligatorio\">\n <option value=\"A\">Argomento A</option>\n</mds-input-select>\n```\n\n#### Do Not Pierce the Shadow DOM to Style the Inner `<select>`\n\nThe supported customization surface is the public `--mds-input-select-*` CSS custom properties and the two shadow parts (`select`, `tip-top`). Targeting internal elements with `>>>` or undocumented selectors couples your code to the implementation and breaks on minor releases.\n\n```css\n/* INCORRECT */\nmds-input-select >>> select {\n font-size: 1rem;\n border: 2px solid red;\n}\n\n/* CORRECT */\nmds-input-select {\n --mds-input-select-ring: 0 0 0 2px rgb(var(--magma-danger-emphasis));\n --mds-input-select-variant-color-rgb: var(--magma-danger-emphasis);\n}\nmds-input-select::part(select) {\n font-size: 1rem;\n}\n```\n\n#### Do Not Set `placeholder` When You Need a Real Default Selection\n\n`placeholder` injects an empty-value leading option that disappears from valid choices once `required` is set. If you want the component to open with a specific option pre-selected, use `value` or `default-value` instead.\n\n```html\n<!-- INCORRECT - a real value supplied as placeholder text -->\n<mds-input-select name=\"priorita\" placeholder=\"Media\">\n <option value=\"bassa\">Bassa</option>\n <option value=\"media\">Media</option>\n <option value=\"alta\">Alta</option>\n</mds-input-select>\n\n<!-- CORRECT - use value to pre-select a real option -->\n<mds-input-select name=\"priorita\" value=\"media\">\n <option value=\"bassa\">Bassa</option>\n <option value=\"media\">Media</option>\n <option value=\"alta\">Alta</option>\n</mds-input-select>\n```\n\n#### Do Not Replace with a Raw `<select>`\n\n`<mds-input-select>` provides theming, accessible status tips, form-reset integration, and dark/high-contrast support. Reaching for a plain `<select>` bypasses all of that and breaks visual consistency across themes.\n\n```html\n<!-- INCORRECT -->\n<select name=\"categoria\" class=\"form-select\">\n <option value=\"\">Seleziona...</option>\n <option value=\"A\">Categoria A</option>\n</select>\n\n<!-- CORRECT -->\n<mds-input-select name=\"categoria\" placeholder=\"Seleziona...\">\n <option value=\"A\">Categoria A</option>\n</mds-input-select>\n```\n"
32
36
  },
33
37
  "props": [
34
38
  {
@@ -522,47 +526,56 @@
522
526
  {
523
527
  "name": "--mds-input-select-arrow-icon-background-color",
524
528
  "annotation": "prop",
525
- "docs": "Background color behind the arrow icon"
529
+ "docs": "Background color behind the arrow icon",
530
+ "visibility": "internal"
526
531
  },
527
532
  {
528
533
  "name": "--mds-input-select-arrow-icon-blur-background-color",
529
534
  "annotation": "prop",
530
- "docs": "Transparent background used for blurred states of the arrow icon"
535
+ "docs": "Transparent background used for blurred states of the arrow icon",
536
+ "visibility": "internal"
531
537
  },
532
538
  {
533
539
  "name": "--mds-input-select-arrow-icon-blur-color",
534
540
  "annotation": "prop",
535
- "docs": "Color applied to the arrow icon in blurred states"
541
+ "docs": "Color applied to the arrow icon in blurred states",
542
+ "visibility": "internal"
536
543
  },
537
544
  {
538
545
  "name": "--mds-input-select-arrow-icon-color",
539
546
  "annotation": "prop",
540
- "docs": "Default arrow icon color"
547
+ "docs": "Default arrow icon color",
548
+ "visibility": "internal"
541
549
  },
542
550
  {
543
551
  "name": "--mds-input-select-arrow-icon-hover-background-color",
544
552
  "annotation": "prop",
545
- "docs": "Background color of the arrow icon when hovered"
553
+ "docs": "Background color of the arrow icon when hovered",
554
+ "visibility": "internal"
546
555
  },
547
556
  {
548
557
  "name": "--mds-input-select-arrow-icon-hover-color",
549
558
  "annotation": "prop",
550
- "docs": "Color of the arrow icon when hovered"
559
+ "docs": "Color of the arrow icon when hovered",
560
+ "visibility": "internal"
551
561
  },
552
562
  {
553
563
  "name": "--mds-input-select-ring",
554
564
  "annotation": "prop",
555
- "docs": "Ring applied around the select at rest; hover and focus draw a 3px ring in the variant color"
565
+ "docs": "Ring applied around the select at rest; hover and focus draw a 3px ring in the variant color",
566
+ "visibility": "public"
556
567
  },
557
568
  {
558
569
  "name": "--mds-input-select-shadow",
559
570
  "annotation": "prop",
560
- "docs": "Shadow applied to the select component"
571
+ "docs": "Shadow applied to the select component",
572
+ "visibility": "public"
561
573
  },
562
574
  {
563
575
  "name": "--mds-input-select-variant-color-rgb",
564
576
  "annotation": "prop",
565
- "docs": "Base color used to derive all select component visual states"
577
+ "docs": "Base color used to derive all select component visual states",
578
+ "visibility": "public"
566
579
  }
567
580
  ],
568
581
  "slots": [
@@ -12,9 +12,9 @@ mds-input-tip-item {
12
12
 
13
13
 
14
14
  /**
15
- * @prop --mds-input-select-variant-color-rgb: Base color used to derive all select component visual states
16
- * @prop --mds-input-select-ring: Ring applied around the select at rest; hover and focus draw a 3px ring in the variant color
17
- * @prop --mds-input-select-shadow: Shadow applied to the select component
15
+ * @prop --mds-input-select-variant-color-rgb: Public. Base color used to derive all select component visual states
16
+ * @prop --mds-input-select-ring: Public. Ring applied around the select at rest; hover and focus draw a 3px ring in the variant color
17
+ * @prop --mds-input-select-shadow: Public. Shadow applied to the select component
18
18
  * @prop --mds-input-select-arrow-icon-background-color: Background color behind the arrow icon
19
19
  * @prop --mds-input-select-arrow-icon-blur-background-color: Transparent background used for blurred states of the arrow icon
20
20
  * @prop --mds-input-select-arrow-icon-blur-color: Color applied to the arrow icon in blurred states