@maggioli-design-system/magma 2.5.0 → 2.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1515) hide show
  1. package/AGENTS.md +19 -4
  2. package/CHANGELOG.md +61 -0
  3. package/LICENSE +21 -0
  4. package/agents/assets.md +1 -1
  5. package/agents/color.md +22 -4
  6. package/agents/components.md +164 -92
  7. package/agents/conventions.md +24 -7
  8. package/agents/install.md +7 -0
  9. package/agents/lint.md +270 -0
  10. package/agents/mcp.md +103 -0
  11. package/agents/theming.md +8 -0
  12. package/dist/cjs/index-BQNHYWJg.js +4 -0
  13. package/dist/cjs/{index-CWTZb9W2.js → index-Bg68W-da.js} +1 -1
  14. package/dist/cjs/loader.cjs.js +1 -1
  15. package/dist/cjs/{locale-Os4wg65H.js → locale-CaR39iYg.js} +12 -6
  16. package/dist/cjs/magma-components.cjs.js +1 -1
  17. package/dist/cjs/mds-accordion-item.cjs.entry.js +1 -1
  18. package/dist/cjs/mds-accordion-timer-item.cjs.entry.js +1 -1
  19. package/dist/cjs/mds-accordion-timer.cjs.entry.js +1 -1
  20. package/dist/cjs/mds-accordion.cjs.entry.js +1 -1
  21. package/dist/cjs/mds-author.cjs.entry.js +1 -1
  22. package/dist/cjs/mds-avatar-stack-item.cjs.entry.js +1 -1
  23. package/dist/cjs/mds-avatar-stack.cjs.entry.js +1 -1
  24. package/dist/cjs/mds-avatar.cjs.entry.js +1 -1
  25. package/dist/cjs/mds-badge.cjs.entry.js +1 -1
  26. package/dist/cjs/mds-banner_3.cjs.entry.js +4 -4
  27. package/dist/cjs/mds-benchmark-bar.cjs.entry.js +1 -1
  28. package/dist/cjs/mds-bibliography.cjs.entry.js +1 -1
  29. package/dist/cjs/mds-book.cjs.entry.js +703 -0
  30. package/dist/cjs/mds-breadcrumb-item.cjs.entry.js +1 -1
  31. package/dist/cjs/mds-breadcrumb.cjs.entry.js +2 -2
  32. package/dist/cjs/mds-button-dropdown.cjs.entry.js +2 -2
  33. package/dist/cjs/mds-button-group.cjs.entry.js +1 -1
  34. package/dist/cjs/mds-button_3.cjs.entry.js +6 -6
  35. package/dist/cjs/mds-calendar_2.cjs.entry.js +7 -7
  36. package/dist/cjs/mds-card-content.cjs.entry.js +1 -1
  37. package/dist/cjs/mds-card-footer.cjs.entry.js +1 -1
  38. package/dist/cjs/mds-card-header.cjs.entry.js +1 -1
  39. package/dist/cjs/mds-card-media.cjs.entry.js +1 -1
  40. package/dist/cjs/mds-card.cjs.entry.js +1 -1
  41. package/dist/cjs/mds-details.cjs.entry.js +1 -1
  42. package/dist/cjs/mds-dropdown.cjs.entry.js +2 -2
  43. package/dist/cjs/mds-emoji.cjs.entry.js +2 -2
  44. package/dist/cjs/mds-entity.cjs.entry.js +1 -1
  45. package/dist/cjs/mds-file-preview.cjs.entry.js +3 -3
  46. package/dist/cjs/mds-file.cjs.entry.js +2 -2
  47. package/dist/cjs/mds-filter-item.cjs.entry.js +2 -2
  48. package/dist/cjs/mds-filter.cjs.entry.js +2 -2
  49. package/dist/cjs/mds-header-bar.cjs.entry.js +2 -2
  50. package/dist/cjs/mds-header.cjs.entry.js +2 -2
  51. package/dist/cjs/mds-horizontal-scroll.cjs.entry.js +2 -2
  52. package/dist/cjs/mds-hr.cjs.entry.js +1 -1
  53. package/dist/cjs/mds-img.cjs.entry.js +1 -1
  54. package/dist/cjs/mds-input-date-range-preselection.cjs.entry.js +1 -1
  55. package/dist/cjs/mds-input-date-range.cjs.entry.js +3 -3
  56. package/dist/cjs/mds-input-date.cjs.entry.js +4 -4
  57. package/dist/cjs/mds-input-field.cjs.entry.js +1 -1
  58. package/dist/cjs/mds-input-otp.cjs.entry.js +2 -2
  59. package/dist/cjs/mds-input-range.cjs.entry.js +2 -2
  60. package/dist/cjs/mds-input-select.cjs.entry.js +9 -5
  61. package/dist/cjs/mds-input-switch_2.cjs.entry.js +3 -3
  62. package/dist/cjs/mds-input-tip_2.cjs.entry.js +4 -4
  63. package/dist/cjs/mds-input-upload.cjs.entry.js +6 -6
  64. package/dist/cjs/mds-input.cjs.entry.js +154 -37
  65. package/dist/cjs/mds-keyboard-key.cjs.entry.js +3 -3
  66. package/dist/cjs/mds-keyboard.cjs.entry.js +8 -4
  67. package/dist/cjs/mds-kpi-item.cjs.entry.js +1 -1
  68. package/dist/cjs/mds-kpi.cjs.entry.js +1 -1
  69. package/dist/cjs/mds-label.cjs.entry.js +2 -2
  70. package/dist/cjs/mds-link.cjs.entry.js +4 -4
  71. package/dist/cjs/mds-list-item.cjs.entry.js +1 -1
  72. package/dist/cjs/mds-list.cjs.entry.js +1 -1
  73. package/dist/cjs/mds-mention.cjs.entry.js +2 -2
  74. package/dist/cjs/mds-modal.cjs.entry.js +4 -4
  75. package/dist/cjs/mds-note.cjs.entry.js +2 -2
  76. package/dist/cjs/mds-notification.cjs.entry.js +1 -1
  77. package/dist/cjs/mds-paginator-item.cjs.entry.js +1 -1
  78. package/dist/cjs/mds-paginator.cjs.entry.js +2 -2
  79. package/dist/cjs/mds-policy-ai.cjs.entry.js +2 -2
  80. package/dist/cjs/mds-pref-animation.cjs.entry.js +2 -2
  81. package/dist/cjs/mds-pref-consumption.cjs.entry.js +2 -2
  82. package/dist/cjs/mds-pref-contrast.cjs.entry.js +2 -2
  83. package/dist/cjs/mds-pref-language-item.cjs.entry.js +2 -2
  84. package/dist/cjs/mds-pref-language.cjs.entry.js +2 -2
  85. package/dist/cjs/mds-pref-mode.cjs.entry.js +2 -2
  86. package/dist/cjs/mds-pref-theme-item.cjs.entry.js +1 -1
  87. package/dist/cjs/mds-pref-theme.cjs.entry.js +2 -2
  88. package/dist/cjs/mds-pref.cjs.entry.js +2 -2
  89. package/dist/cjs/mds-price-table-features-cell.cjs.entry.js +1 -1
  90. package/dist/cjs/mds-price-table-features-row.cjs.entry.js +1 -1
  91. package/dist/cjs/mds-price-table-features.cjs.entry.js +1 -1
  92. package/dist/cjs/mds-price-table-header.cjs.entry.js +1 -1
  93. package/dist/cjs/mds-price-table-list-item.cjs.entry.js +1 -1
  94. package/dist/cjs/mds-price-table-list.cjs.entry.js +1 -1
  95. package/dist/cjs/mds-price-table.cjs.entry.js +1 -1
  96. package/dist/cjs/mds-progress_2.cjs.entry.js +2 -2
  97. package/dist/cjs/mds-push-notification-item.cjs.entry.js +3 -3
  98. package/dist/cjs/mds-push-notification.cjs.entry.js +3 -3
  99. package/dist/cjs/mds-quote.cjs.entry.js +1 -1
  100. package/dist/cjs/mds-radial-menu-item.cjs.entry.js +1 -1
  101. package/dist/cjs/mds-radial-menu.cjs.entry.js +2 -2
  102. package/dist/cjs/mds-separator.cjs.entry.js +1 -1
  103. package/dist/cjs/mds-status-bar.cjs.entry.js +2 -2
  104. package/dist/cjs/mds-stepper-bar-item.cjs.entry.js +7 -5
  105. package/dist/cjs/mds-stepper-bar.cjs.entry.js +1 -1
  106. package/dist/cjs/mds-tab-bar-item.cjs.entry.js +1 -1
  107. package/dist/cjs/mds-tab-bar.cjs.entry.js +1 -1
  108. package/dist/cjs/mds-tab_2.cjs.entry.js +4 -4
  109. package/dist/cjs/mds-table-body.cjs.entry.js +1 -1
  110. package/dist/cjs/mds-table-footer.cjs.entry.js +1 -1
  111. package/dist/cjs/mds-table-header-cell.cjs.entry.js +1 -1
  112. package/dist/cjs/mds-table-header.cjs.entry.js +2 -2
  113. package/dist/cjs/mds-table-row.cjs.entry.js +3 -3
  114. package/dist/cjs/mds-table.cjs.entry.js +2 -2
  115. package/dist/cjs/mds-text.cjs.entry.js +1 -1
  116. package/dist/cjs/mds-toast-region.cjs.entry.js +1 -1
  117. package/dist/cjs/mds-toast.cjs.entry.js +2 -2
  118. package/dist/cjs/mds-tooltip.cjs.entry.js +2 -2
  119. package/dist/cjs/mds-tree-item.cjs.entry.js +2 -2
  120. package/dist/cjs/mds-tree.cjs.entry.js +1 -1
  121. package/dist/cjs/mds-url-view.cjs.entry.js +2 -2
  122. package/dist/cjs/mds-usage.cjs.entry.js +2 -2
  123. package/dist/cjs/mds-video-wall.cjs.entry.js +1 -1
  124. package/dist/cjs/mds-zero.cjs.entry.js +1 -1
  125. package/dist/collection/collection-manifest.json +1 -0
  126. package/dist/collection/common/locale.js +12 -6
  127. package/dist/collection/components/mds-accordion/AGENTS.md +3 -5
  128. package/dist/collection/components/mds-accordion/antipattern.md +1 -2
  129. package/dist/collection/components/mds-accordion/documentation.json +21 -10
  130. package/dist/collection/components/mds-accordion/mds-accordion.css +3 -3
  131. package/dist/collection/components/mds-accordion/mds-accordion.js +2 -1
  132. package/dist/collection/components/mds-accordion/pattern.md +1 -4
  133. package/dist/collection/components/mds-accordion-item/AGENTS.md +3 -7
  134. package/dist/collection/components/mds-accordion-item/documentation.json +20 -9
  135. package/dist/collection/components/mds-accordion-item/mds-accordion-item.css +1 -1
  136. package/dist/collection/components/mds-accordion-item/mds-accordion-item.js +2 -1
  137. package/dist/collection/components/mds-accordion-item/pattern.md +3 -5
  138. package/dist/collection/components/mds-accordion-timer/AGENTS.md +3 -5
  139. package/dist/collection/components/mds-accordion-timer/antipattern.md +5 -3
  140. package/dist/collection/components/mds-accordion-timer/documentation.json +17 -8
  141. package/dist/collection/components/mds-accordion-timer/mds-accordion-timer.css +1 -1
  142. package/dist/collection/components/mds-accordion-timer/mds-accordion-timer.js +2 -1
  143. package/dist/collection/components/mds-accordion-timer/pattern.md +6 -6
  144. package/dist/collection/components/mds-accordion-timer-item/AGENTS.md +3 -5
  145. package/dist/collection/components/mds-accordion-timer-item/antipattern.md +1 -2
  146. package/dist/collection/components/mds-accordion-timer-item/documentation.json +17 -8
  147. package/dist/collection/components/mds-accordion-timer-item/mds-accordion-timer-item.css +1 -1
  148. package/dist/collection/components/mds-accordion-timer-item/mds-accordion-timer-item.js +2 -1
  149. package/dist/collection/components/mds-accordion-timer-item/pattern.md +1 -5
  150. package/dist/collection/components/mds-author/AGENTS.md +1 -1
  151. package/dist/collection/components/mds-author/documentation.json +5 -1
  152. package/dist/collection/components/mds-author/mds-author.js +2 -1
  153. package/dist/collection/components/mds-avatar/AGENTS.md +3 -3
  154. package/dist/collection/components/mds-avatar/antipattern.md +1 -1
  155. package/dist/collection/components/mds-avatar/documentation.json +17 -8
  156. package/dist/collection/components/mds-avatar/mds-avatar.css +3 -3
  157. package/dist/collection/components/mds-avatar/mds-avatar.js +2 -1
  158. package/dist/collection/components/mds-avatar/pattern.md +1 -2
  159. package/dist/collection/components/mds-avatar-stack/AGENTS.md +3 -12
  160. package/dist/collection/components/mds-avatar-stack/antipattern.md +1 -2
  161. package/dist/collection/components/mds-avatar-stack/documentation.json +31 -15
  162. package/dist/collection/components/mds-avatar-stack/mds-avatar-stack.css +1 -1
  163. package/dist/collection/components/mds-avatar-stack/mds-avatar-stack.js +2 -1
  164. package/dist/collection/components/mds-avatar-stack/pattern.md +2 -5
  165. package/dist/collection/components/mds-avatar-stack-item/AGENTS.md +3 -6
  166. package/dist/collection/components/mds-avatar-stack-item/documentation.json +22 -10
  167. package/dist/collection/components/mds-avatar-stack-item/mds-avatar-stack-item.css +2 -2
  168. package/dist/collection/components/mds-avatar-stack-item/mds-avatar-stack-item.js +4 -1
  169. package/dist/collection/components/mds-avatar-stack-item/pattern.md +4 -5
  170. package/dist/collection/components/mds-badge/AGENTS.md +3 -3
  171. package/dist/collection/components/mds-badge/antipattern.md +1 -1
  172. package/dist/collection/components/mds-badge/documentation.json +17 -8
  173. package/dist/collection/components/mds-badge/mds-badge.css +3 -3
  174. package/dist/collection/components/mds-badge/mds-badge.js +2 -1
  175. package/dist/collection/components/mds-badge/pattern.md +4 -7
  176. package/dist/collection/components/mds-banner/AGENTS.md +3 -8
  177. package/dist/collection/components/mds-banner/antipattern.md +1 -2
  178. package/dist/collection/components/mds-banner/documentation.json +29 -14
  179. package/dist/collection/components/mds-banner/mds-banner.css +4 -4
  180. package/dist/collection/components/mds-banner/mds-banner.js +2 -1
  181. package/dist/collection/components/mds-banner/pattern.md +1 -2
  182. package/dist/collection/components/mds-benchmark-bar/AGENTS.md +1 -1
  183. package/dist/collection/components/mds-benchmark-bar/documentation.json +5 -1
  184. package/dist/collection/components/mds-benchmark-bar/mds-benchmark-bar.js +2 -1
  185. package/dist/collection/components/mds-bibliography/AGENTS.md +3 -3
  186. package/dist/collection/components/mds-bibliography/antipattern.md +1 -3
  187. package/dist/collection/components/mds-bibliography/documentation.json +15 -7
  188. package/dist/collection/components/mds-bibliography/mds-bibliography.css +1 -1
  189. package/dist/collection/components/mds-bibliography/mds-bibliography.js +4 -1
  190. package/dist/collection/components/mds-bibliography/pattern.md +1 -3
  191. package/dist/collection/components/mds-book/AGENTS.md +79 -0
  192. package/dist/collection/components/mds-book/antipattern.md +88 -0
  193. package/dist/collection/components/mds-book/documentation.json +482 -0
  194. package/dist/collection/components/mds-book/mds-book.css +901 -0
  195. package/dist/collection/components/mds-book/mds-book.js +731 -0
  196. package/dist/collection/components/mds-book/meta/dictionary.js +5 -0
  197. package/dist/collection/components/mds-book/meta/format.js +57 -0
  198. package/dist/collection/components/mds-book/meta/pose.js +107 -0
  199. package/dist/collection/components/mds-book/meta/spine.js +61 -0
  200. package/dist/collection/components/mds-book/meta/types.js +1 -0
  201. package/dist/collection/components/mds-book/meta/volume.js +23 -0
  202. package/dist/collection/components/mds-book/pattern.md +111 -0
  203. package/dist/collection/components/mds-breadcrumb/AGENTS.md +3 -14
  204. package/dist/collection/components/mds-breadcrumb/antipattern.md +1 -1
  205. package/dist/collection/components/mds-breadcrumb/documentation.json +28 -14
  206. package/dist/collection/components/mds-breadcrumb/mds-breadcrumb.js +2 -1
  207. package/dist/collection/components/mds-breadcrumb/pattern.md +6 -6
  208. package/dist/collection/components/mds-breadcrumb-item/AGENTS.md +3 -11
  209. package/dist/collection/components/mds-breadcrumb-item/antipattern.md +3 -3
  210. package/dist/collection/components/mds-breadcrumb-item/documentation.json +22 -11
  211. package/dist/collection/components/mds-breadcrumb-item/mds-breadcrumb-item.js +2 -1
  212. package/dist/collection/components/mds-breadcrumb-item/pattern.md +12 -14
  213. package/dist/collection/components/mds-button/AGENTS.md +3 -12
  214. package/dist/collection/components/mds-button/documentation.json +37 -17
  215. package/dist/collection/components/mds-button/mds-button.css +5 -5
  216. package/dist/collection/components/mds-button/mds-button.js +5 -4
  217. package/dist/collection/components/mds-button-dropdown/AGENTS.md +1 -1
  218. package/dist/collection/components/mds-button-dropdown/documentation.json +7 -2
  219. package/dist/collection/components/mds-button-dropdown/mds-button-dropdown.css +1 -1
  220. package/dist/collection/components/mds-button-dropdown/mds-button-dropdown.js +2 -1
  221. package/dist/collection/components/mds-button-group/AGENTS.md +1 -1
  222. package/dist/collection/components/mds-button-group/documentation.json +5 -1
  223. package/dist/collection/components/mds-button-group/mds-button-group.js +2 -1
  224. package/dist/collection/components/mds-calendar/AGENTS.md +3 -6
  225. package/dist/collection/components/mds-calendar/antipattern.md +1 -1
  226. package/dist/collection/components/mds-calendar/documentation.json +25 -12
  227. package/dist/collection/components/mds-calendar/mds-calendar.css +4 -4
  228. package/dist/collection/components/mds-calendar/mds-calendar.js +6 -5
  229. package/dist/collection/components/mds-calendar/pattern.md +1 -3
  230. package/dist/collection/components/mds-calendar-cell/AGENTS.md +3 -35
  231. package/dist/collection/components/mds-calendar-cell/antipattern.md +1 -2
  232. package/dist/collection/components/mds-calendar-cell/documentation.json +81 -40
  233. package/dist/collection/components/mds-calendar-cell/mds-calendar-cell.css +2 -2
  234. package/dist/collection/components/mds-calendar-cell/mds-calendar-cell.js +4 -1
  235. package/dist/collection/components/mds-calendar-cell/pattern.md +4 -5
  236. package/dist/collection/components/mds-card/AGENTS.md +1 -1
  237. package/dist/collection/components/mds-card/antipattern.md +2 -2
  238. package/dist/collection/components/mds-card/documentation.json +13 -6
  239. package/dist/collection/components/mds-card/mds-card.css +3 -3
  240. package/dist/collection/components/mds-card/mds-card.js +2 -1
  241. package/dist/collection/components/mds-card/pattern.md +4 -4
  242. package/dist/collection/components/mds-card-content/AGENTS.md +1 -1
  243. package/dist/collection/components/mds-card-content/documentation.json +5 -1
  244. package/dist/collection/components/mds-card-content/mds-card-content.js +2 -1
  245. package/dist/collection/components/mds-card-footer/AGENTS.md +1 -1
  246. package/dist/collection/components/mds-card-footer/documentation.json +5 -1
  247. package/dist/collection/components/mds-card-footer/mds-card-footer.js +2 -1
  248. package/dist/collection/components/mds-card-header/AGENTS.md +1 -1
  249. package/dist/collection/components/mds-card-header/documentation.json +5 -1
  250. package/dist/collection/components/mds-card-header/mds-card-header.js +2 -1
  251. package/dist/collection/components/mds-card-media/AGENTS.md +1 -1
  252. package/dist/collection/components/mds-card-media/documentation.json +5 -1
  253. package/dist/collection/components/mds-card-media/mds-card-media.js +2 -1
  254. package/dist/collection/components/mds-chip/AGENTS.md +3 -10
  255. package/dist/collection/components/mds-chip/antipattern.md +2 -3
  256. package/dist/collection/components/mds-chip/documentation.json +35 -17
  257. package/dist/collection/components/mds-chip/mds-chip.css +4 -4
  258. package/dist/collection/components/mds-chip/mds-chip.js +4 -1
  259. package/dist/collection/components/mds-chip/pattern.md +4 -6
  260. package/dist/collection/components/mds-details/AGENTS.md +3 -7
  261. package/dist/collection/components/mds-details/antipattern.md +1 -5
  262. package/dist/collection/components/mds-details/documentation.json +14 -7
  263. package/dist/collection/components/mds-details/mds-details.js +2 -1
  264. package/dist/collection/components/mds-details/pattern.md +4 -6
  265. package/dist/collection/components/mds-dropdown/AGENTS.md +3 -9
  266. package/dist/collection/components/mds-dropdown/antipattern.md +1 -1
  267. package/dist/collection/components/mds-dropdown/documentation.json +31 -15
  268. package/dist/collection/components/mds-dropdown/mds-dropdown.css +4 -4
  269. package/dist/collection/components/mds-dropdown/mds-dropdown.js +3 -2
  270. package/dist/collection/components/mds-dropdown/pattern.md +2 -4
  271. package/dist/collection/components/mds-emoji/AGENTS.md +8 -32
  272. package/dist/collection/components/mds-emoji/antipattern.md +0 -18
  273. package/dist/collection/components/mds-emoji/documentation.json +73 -35
  274. package/dist/collection/components/mds-emoji/mds-emoji.css +8 -5
  275. package/dist/collection/components/mds-emoji/mds-emoji.js +4 -1
  276. package/dist/collection/components/mds-emoji/pattern.md +9 -25
  277. package/dist/collection/components/mds-entity/AGENTS.md +3 -4
  278. package/dist/collection/components/mds-entity/antipattern.md +10 -3
  279. package/dist/collection/components/mds-entity/documentation.json +17 -8
  280. package/dist/collection/components/mds-entity/mds-entity.css +2 -2
  281. package/dist/collection/components/mds-entity/mds-entity.js +2 -1
  282. package/dist/collection/components/mds-entity/pattern.md +1 -4
  283. package/dist/collection/components/mds-file/AGENTS.md +3 -3
  284. package/dist/collection/components/mds-file/antipattern.md +2 -3
  285. package/dist/collection/components/mds-file/documentation.json +15 -7
  286. package/dist/collection/components/mds-file/mds-file.css +1 -1
  287. package/dist/collection/components/mds-file/mds-file.js +4 -1
  288. package/dist/collection/components/mds-file/pattern.md +1 -3
  289. package/dist/collection/components/mds-file-preview/AGENTS.md +3 -3
  290. package/dist/collection/components/mds-file-preview/antipattern.md +1 -1
  291. package/dist/collection/components/mds-file-preview/documentation.json +17 -8
  292. package/dist/collection/components/mds-file-preview/mds-file-preview.css +3 -3
  293. package/dist/collection/components/mds-file-preview/mds-file-preview.js +3 -2
  294. package/dist/collection/components/mds-file-preview/pattern.md +2 -3
  295. package/dist/collection/components/mds-filter/AGENTS.md +3 -8
  296. package/dist/collection/components/mds-filter/antipattern.md +2 -2
  297. package/dist/collection/components/mds-filter/documentation.json +27 -13
  298. package/dist/collection/components/mds-filter/mds-filter.css +3 -3
  299. package/dist/collection/components/mds-filter/mds-filter.js +2 -1
  300. package/dist/collection/components/mds-filter/pattern.md +2 -5
  301. package/dist/collection/components/mds-filter-item/AGENTS.md +2 -7
  302. package/dist/collection/components/mds-filter-item/antipattern.md +4 -4
  303. package/dist/collection/components/mds-filter-item/documentation.json +17 -8
  304. package/dist/collection/components/mds-filter-item/mds-filter-item.js +4 -1
  305. package/dist/collection/components/mds-filter-item/pattern.md +5 -7
  306. package/dist/collection/components/mds-header/AGENTS.md +4 -8
  307. package/dist/collection/components/mds-header/documentation.json +28 -13
  308. package/dist/collection/components/mds-header/mds-header.css +7 -7
  309. package/dist/collection/components/mds-header/mds-header.js +2 -1
  310. package/dist/collection/components/mds-header/pattern.md +1 -3
  311. package/dist/collection/components/mds-header-bar/AGENTS.md +2 -4
  312. package/dist/collection/components/mds-header-bar/antipattern.md +6 -8
  313. package/dist/collection/components/mds-header-bar/documentation.json +9 -4
  314. package/dist/collection/components/mds-header-bar/mds-header-bar.js +2 -1
  315. package/dist/collection/components/mds-header-bar/pattern.md +10 -6
  316. package/dist/collection/components/mds-help/AGENTS.md +1 -1
  317. package/dist/collection/components/mds-help/documentation.json +13 -5
  318. package/dist/collection/components/mds-help/mds-help.css +4 -4
  319. package/dist/collection/components/mds-help/mds-help.js +2 -1
  320. package/dist/collection/components/mds-horizontal-scroll/AGENTS.md +5 -11
  321. package/dist/collection/components/mds-horizontal-scroll/antipattern.md +2 -2
  322. package/dist/collection/components/mds-horizontal-scroll/documentation.json +34 -14
  323. package/dist/collection/components/mds-horizontal-scroll/mds-horizontal-scroll.css +2 -1
  324. package/dist/collection/components/mds-horizontal-scroll/mds-horizontal-scroll.js +2 -1
  325. package/dist/collection/components/mds-horizontal-scroll/pattern.md +4 -15
  326. package/dist/collection/components/mds-hr/AGENTS.md +1 -1
  327. package/dist/collection/components/mds-hr/documentation.json +7 -2
  328. package/dist/collection/components/mds-hr/mds-hr.js +4 -1
  329. package/dist/collection/components/mds-icon/AGENTS.md +1 -1
  330. package/dist/collection/components/mds-icon/documentation.json +5 -1
  331. package/dist/collection/components/mds-icon/mds-icon.js +2 -1
  332. package/dist/collection/components/mds-img/AGENTS.md +3 -5
  333. package/dist/collection/components/mds-img/antipattern.md +1 -1
  334. package/dist/collection/components/mds-img/documentation.json +19 -9
  335. package/dist/collection/components/mds-img/mds-img.css +2 -2
  336. package/dist/collection/components/mds-img/mds-img.js +1 -0
  337. package/dist/collection/components/mds-img/pattern.md +1 -4
  338. package/dist/collection/components/mds-input/AGENTS.md +6 -10
  339. package/dist/collection/components/mds-input/antipattern.md +1 -1
  340. package/dist/collection/components/mds-input/documentation.json +40 -20
  341. package/dist/collection/components/mds-input/mds-input.css +8 -8
  342. package/dist/collection/components/mds-input/mds-input.js +13 -7
  343. package/dist/collection/components/mds-input/meta/input-type/InputValidationManager.js +3 -3
  344. package/dist/collection/components/mds-input/meta/validators.js +28 -13
  345. package/dist/collection/components/mds-input/meta/validity.js +8 -10
  346. package/dist/collection/components/mds-input/pattern.md +1 -3
  347. package/dist/collection/components/mds-input-date/AGENTS.md +3 -8
  348. package/dist/collection/components/mds-input-date/antipattern.md +1 -1
  349. package/dist/collection/components/mds-input-date/documentation.json +31 -15
  350. package/dist/collection/components/mds-input-date/mds-input-date.css +5 -5
  351. package/dist/collection/components/mds-input-date/mds-input-date.js +3 -2
  352. package/dist/collection/components/mds-input-date/pattern.md +1 -2
  353. package/dist/collection/components/mds-input-date-range/AGENTS.md +3 -4
  354. package/dist/collection/components/mds-input-date-range/documentation.json +22 -10
  355. package/dist/collection/components/mds-input-date-range/mds-input-date-range.css +5 -5
  356. package/dist/collection/components/mds-input-date-range/mds-input-date-range.js +3 -2
  357. package/dist/collection/components/mds-input-date-range/pattern.md +1 -2
  358. package/dist/collection/components/mds-input-date-range-preselection/AGENTS.md +3 -13
  359. package/dist/collection/components/mds-input-date-range-preselection/antipattern.md +11 -6
  360. package/dist/collection/components/mds-input-date-range-preselection/documentation.json +26 -13
  361. package/dist/collection/components/mds-input-date-range-preselection/mds-input-date-range-preselection.js +2 -1
  362. package/dist/collection/components/mds-input-date-range-preselection/pattern.md +1 -11
  363. package/dist/collection/components/mds-input-field/AGENTS.md +1 -1
  364. package/dist/collection/components/mds-input-field/documentation.json +9 -3
  365. package/dist/collection/components/mds-input-field/mds-input-field.css +2 -2
  366. package/dist/collection/components/mds-input-field/mds-input-field.js +2 -1
  367. package/dist/collection/components/mds-input-otp/AGENTS.md +1 -1
  368. package/dist/collection/components/mds-input-otp/documentation.json +7 -2
  369. package/dist/collection/components/mds-input-otp/mds-input-otp.js +4 -1
  370. package/dist/collection/components/mds-input-range/AGENTS.md +3 -13
  371. package/dist/collection/components/mds-input-range/antipattern.md +1 -5
  372. package/dist/collection/components/mds-input-range/documentation.json +26 -13
  373. package/dist/collection/components/mds-input-range/mds-input-range.css +26 -19
  374. package/dist/collection/components/mds-input-range/mds-input-range.js +2 -1
  375. package/dist/collection/components/mds-input-range/pattern.md +2 -12
  376. package/dist/collection/components/mds-input-select/AGENTS.md +4 -8
  377. package/dist/collection/components/mds-input-select/antipattern.md +1 -1
  378. package/dist/collection/components/mds-input-select/documentation.json +26 -13
  379. package/dist/collection/components/mds-input-select/mds-input-select.css +3 -3
  380. package/dist/collection/components/mds-input-select/mds-input-select.js +8 -3
  381. package/dist/collection/components/mds-input-select/pattern.md +1 -3
  382. package/dist/collection/components/mds-input-switch/AGENTS.md +2 -30
  383. package/dist/collection/components/mds-input-switch/antipattern.md +5 -6
  384. package/dist/collection/components/mds-input-switch/documentation.json +61 -30
  385. package/dist/collection/components/mds-input-switch/mds-input-switch.js +2 -1
  386. package/dist/collection/components/mds-input-switch/pattern.md +2 -11
  387. package/dist/collection/components/mds-input-tip/AGENTS.md +3 -5
  388. package/dist/collection/components/mds-input-tip/antipattern.md +10 -6
  389. package/dist/collection/components/mds-input-tip/documentation.json +17 -8
  390. package/dist/collection/components/mds-input-tip/mds-input-tip.css +1 -1
  391. package/dist/collection/components/mds-input-tip/mds-input-tip.js +2 -1
  392. package/dist/collection/components/mds-input-tip/pattern.md +1 -4
  393. package/dist/collection/components/mds-input-tip-item/AGENTS.md +4 -3
  394. package/dist/collection/components/mds-input-tip-item/antipattern.md +2 -2
  395. package/dist/collection/components/mds-input-tip-item/documentation.json +14 -7
  396. package/dist/collection/components/mds-input-tip-item/mds-input-tip-item.css +2 -2
  397. package/dist/collection/components/mds-input-tip-item/mds-input-tip-item.js +3 -2
  398. package/dist/collection/components/mds-input-tip-item/pattern.md +1 -2
  399. package/dist/collection/components/mds-input-upload/AGENTS.md +3 -5
  400. package/dist/collection/components/mds-input-upload/antipattern.md +2 -3
  401. package/dist/collection/components/mds-input-upload/documentation.json +19 -9
  402. package/dist/collection/components/mds-input-upload/mds-input-upload.css +1 -1
  403. package/dist/collection/components/mds-input-upload/mds-input-upload.js +8 -5
  404. package/dist/collection/components/mds-input-upload/pattern.md +1 -5
  405. package/dist/collection/components/mds-keyboard/AGENTS.md +4 -19
  406. package/dist/collection/components/mds-keyboard/antipattern.md +3 -3
  407. package/dist/collection/components/mds-keyboard/documentation.json +48 -24
  408. package/dist/collection/components/mds-keyboard/mds-keyboard.css +17 -5
  409. package/dist/collection/components/mds-keyboard/mds-keyboard.js +7 -2
  410. package/dist/collection/components/mds-keyboard/pattern.md +1 -2
  411. package/dist/collection/components/mds-keyboard-key/AGENTS.md +3 -6
  412. package/dist/collection/components/mds-keyboard-key/antipattern.md +1 -2
  413. package/dist/collection/components/mds-keyboard-key/documentation.json +21 -10
  414. package/dist/collection/components/mds-keyboard-key/mds-keyboard-key.css +7 -3
  415. package/dist/collection/components/mds-keyboard-key/mds-keyboard-key.js +4 -1
  416. package/dist/collection/components/mds-keyboard-key/pattern.md +1 -12
  417. package/dist/collection/components/mds-kpi/AGENTS.md +1 -1
  418. package/dist/collection/components/mds-kpi/documentation.json +10 -4
  419. package/dist/collection/components/mds-kpi/mds-kpi.css +2 -2
  420. package/dist/collection/components/mds-kpi/mds-kpi.js +2 -1
  421. package/dist/collection/components/mds-kpi/pattern.md +7 -4
  422. package/dist/collection/components/mds-kpi-item/AGENTS.md +3 -8
  423. package/dist/collection/components/mds-kpi-item/antipattern.md +2 -4
  424. package/dist/collection/components/mds-kpi-item/documentation.json +16 -8
  425. package/dist/collection/components/mds-kpi-item/mds-kpi-item.js +2 -1
  426. package/dist/collection/components/mds-kpi-item/pattern.md +9 -7
  427. package/dist/collection/components/mds-label/AGENTS.md +3 -7
  428. package/dist/collection/components/mds-label/documentation.json +24 -11
  429. package/dist/collection/components/mds-label/mds-label.css +2 -2
  430. package/dist/collection/components/mds-label/mds-label.js +4 -1
  431. package/dist/collection/components/mds-label/pattern.md +1 -3
  432. package/dist/collection/components/mds-link/AGENTS.md +4 -9
  433. package/dist/collection/components/mds-link/documentation.json +22 -10
  434. package/dist/collection/components/mds-link/mds-link.css +1 -1
  435. package/dist/collection/components/mds-link/mds-link.js +4 -3
  436. package/dist/collection/components/mds-list/AGENTS.md +1 -1
  437. package/dist/collection/components/mds-list/documentation.json +6 -2
  438. package/dist/collection/components/mds-list/mds-list.js +2 -1
  439. package/dist/collection/components/mds-list/pattern.md +5 -5
  440. package/dist/collection/components/mds-list-item/AGENTS.md +2 -4
  441. package/dist/collection/components/mds-list-item/antipattern.md +1 -1
  442. package/dist/collection/components/mds-list-item/documentation.json +9 -4
  443. package/dist/collection/components/mds-list-item/mds-list-item.js +2 -1
  444. package/dist/collection/components/mds-list-item/pattern.md +4 -4
  445. package/dist/collection/components/mds-mention/AGENTS.md +2 -4
  446. package/dist/collection/components/mds-mention/antipattern.md +5 -5
  447. package/dist/collection/components/mds-mention/documentation.json +11 -5
  448. package/dist/collection/components/mds-mention/mds-mention.js +4 -1
  449. package/dist/collection/components/mds-mention/pattern.md +3 -5
  450. package/dist/collection/components/mds-modal/AGENTS.md +3 -9
  451. package/dist/collection/components/mds-modal/antipattern.md +1 -3
  452. package/dist/collection/components/mds-modal/documentation.json +37 -18
  453. package/dist/collection/components/mds-modal/mds-modal.css +7 -7
  454. package/dist/collection/components/mds-modal/mds-modal.js +4 -3
  455. package/dist/collection/components/mds-modal/pattern.md +2 -6
  456. package/dist/collection/components/mds-note/AGENTS.md +3 -5
  457. package/dist/collection/components/mds-note/documentation.json +18 -8
  458. package/dist/collection/components/mds-note/mds-note.css +2 -2
  459. package/dist/collection/components/mds-note/mds-note.js +2 -1
  460. package/dist/collection/components/mds-note/pattern.md +1 -3
  461. package/dist/collection/components/mds-notification/AGENTS.md +3 -11
  462. package/dist/collection/components/mds-notification/antipattern.md +2 -2
  463. package/dist/collection/components/mds-notification/documentation.json +33 -16
  464. package/dist/collection/components/mds-notification/mds-notification.css +2 -2
  465. package/dist/collection/components/mds-notification/mds-notification.js +4 -1
  466. package/dist/collection/components/mds-notification/pattern.md +3 -5
  467. package/dist/collection/components/mds-paginator/AGENTS.md +1 -1
  468. package/dist/collection/components/mds-paginator/documentation.json +12 -5
  469. package/dist/collection/components/mds-paginator/mds-paginator.css +2 -2
  470. package/dist/collection/components/mds-paginator/mds-paginator.js +4 -1
  471. package/dist/collection/components/mds-paginator/pattern.md +1 -3
  472. package/dist/collection/components/mds-paginator-item/AGENTS.md +3 -10
  473. package/dist/collection/components/mds-paginator-item/documentation.json +34 -16
  474. package/dist/collection/components/mds-paginator-item/mds-paginator-item.css +5 -5
  475. package/dist/collection/components/mds-paginator-item/mds-paginator-item.js +2 -1
  476. package/dist/collection/components/mds-paginator-item/pattern.md +5 -6
  477. package/dist/collection/components/mds-policy-ai/AGENTS.md +1 -1
  478. package/dist/collection/components/mds-policy-ai/documentation.json +6 -2
  479. package/dist/collection/components/mds-policy-ai/mds-policy-ai.js +2 -1
  480. package/dist/collection/components/mds-policy-ai/pattern.md +4 -4
  481. package/dist/collection/components/mds-pref/AGENTS.md +1 -1
  482. package/dist/collection/components/mds-pref/documentation.json +5 -5
  483. package/dist/collection/components/mds-pref/mds-pref.js +2 -2
  484. package/dist/collection/components/mds-pref-animation/AGENTS.md +1 -1
  485. package/dist/collection/components/mds-pref-animation/documentation.json +7 -2
  486. package/dist/collection/components/mds-pref-animation/mds-pref-animation.js +4 -1
  487. package/dist/collection/components/mds-pref-consumption/AGENTS.md +1 -1
  488. package/dist/collection/components/mds-pref-consumption/documentation.json +7 -2
  489. package/dist/collection/components/mds-pref-consumption/mds-pref-consumption.js +4 -1
  490. package/dist/collection/components/mds-pref-contrast/AGENTS.md +1 -1
  491. package/dist/collection/components/mds-pref-contrast/documentation.json +7 -2
  492. package/dist/collection/components/mds-pref-contrast/mds-pref-contrast.js +4 -1
  493. package/dist/collection/components/mds-pref-language/AGENTS.md +1 -1
  494. package/dist/collection/components/mds-pref-language/documentation.json +5 -1
  495. package/dist/collection/components/mds-pref-language/mds-pref-language.js +2 -1
  496. package/dist/collection/components/mds-pref-language-item/AGENTS.md +1 -1
  497. package/dist/collection/components/mds-pref-language-item/documentation.json +7 -2
  498. package/dist/collection/components/mds-pref-language-item/mds-pref-language-item.js +4 -1
  499. package/dist/collection/components/mds-pref-mode/AGENTS.md +3 -3
  500. package/dist/collection/components/mds-pref-mode/antipattern.md +1 -2
  501. package/dist/collection/components/mds-pref-mode/documentation.json +15 -7
  502. package/dist/collection/components/mds-pref-mode/mds-pref-mode.css +1 -1
  503. package/dist/collection/components/mds-pref-mode/mds-pref-mode.js +4 -1
  504. package/dist/collection/components/mds-pref-mode/pattern.md +1 -3
  505. package/dist/collection/components/mds-pref-theme/AGENTS.md +1 -1
  506. package/dist/collection/components/mds-pref-theme/documentation.json +6 -2
  507. package/dist/collection/components/mds-pref-theme/mds-pref-theme.js +2 -1
  508. package/dist/collection/components/mds-pref-theme/pattern.md +1 -2
  509. package/dist/collection/components/mds-pref-theme-item/AGENTS.md +3 -5
  510. package/dist/collection/components/mds-pref-theme-item/antipattern.md +1 -2
  511. package/dist/collection/components/mds-pref-theme-item/documentation.json +19 -9
  512. package/dist/collection/components/mds-pref-theme-item/mds-pref-theme-item.css +1 -1
  513. package/dist/collection/components/mds-pref-theme-item/mds-pref-theme-item.js +4 -1
  514. package/dist/collection/components/mds-pref-theme-item/pattern.md +2 -6
  515. package/dist/collection/components/mds-price-table/AGENTS.md +1 -1
  516. package/dist/collection/components/mds-price-table/documentation.json +6 -2
  517. package/dist/collection/components/mds-price-table/mds-price-table.js +2 -1
  518. package/dist/collection/components/mds-price-table/pattern.md +4 -4
  519. package/dist/collection/components/mds-price-table-features/AGENTS.md +4 -3
  520. package/dist/collection/components/mds-price-table-features/antipattern.md +0 -1
  521. package/dist/collection/components/mds-price-table-features/documentation.json +12 -6
  522. package/dist/collection/components/mds-price-table-features/mds-price-table-features.css +1 -1
  523. package/dist/collection/components/mds-price-table-features/mds-price-table-features.js +2 -1
  524. package/dist/collection/components/mds-price-table-features/pattern.md +2 -3
  525. package/dist/collection/components/mds-price-table-features-cell/AGENTS.md +3 -6
  526. package/dist/collection/components/mds-price-table-features-cell/antipattern.md +3 -3
  527. package/dist/collection/components/mds-price-table-features-cell/documentation.json +19 -9
  528. package/dist/collection/components/mds-price-table-features-cell/mds-price-table-features-cell.css +1 -1
  529. package/dist/collection/components/mds-price-table-features-cell/mds-price-table-features-cell.js +2 -1
  530. package/dist/collection/components/mds-price-table-features-cell/pattern.md +1 -6
  531. package/dist/collection/components/mds-price-table-features-row/AGENTS.md +3 -3
  532. package/dist/collection/components/mds-price-table-features-row/documentation.json +14 -6
  533. package/dist/collection/components/mds-price-table-features-row/mds-price-table-features-row.css +2 -2
  534. package/dist/collection/components/mds-price-table-features-row/mds-price-table-features-row.js +2 -1
  535. package/dist/collection/components/mds-price-table-features-row/pattern.md +1 -3
  536. package/dist/collection/components/mds-price-table-header/AGENTS.md +1 -1
  537. package/dist/collection/components/mds-price-table-header/documentation.json +5 -1
  538. package/dist/collection/components/mds-price-table-header/mds-price-table-header.js +2 -1
  539. package/dist/collection/components/mds-price-table-list/AGENTS.md +3 -5
  540. package/dist/collection/components/mds-price-table-list/antipattern.md +1 -4
  541. package/dist/collection/components/mds-price-table-list/documentation.json +10 -5
  542. package/dist/collection/components/mds-price-table-list/mds-price-table-list.js +2 -1
  543. package/dist/collection/components/mds-price-table-list/pattern.md +12 -7
  544. package/dist/collection/components/mds-price-table-list-item/AGENTS.md +2 -6
  545. package/dist/collection/components/mds-price-table-list-item/antipattern.md +1 -5
  546. package/dist/collection/components/mds-price-table-list-item/documentation.json +13 -6
  547. package/dist/collection/components/mds-price-table-list-item/mds-price-table-list-item.js +2 -1
  548. package/dist/collection/components/mds-price-table-list-item/pattern.md +7 -4
  549. package/dist/collection/components/mds-progress/AGENTS.md +1 -1
  550. package/dist/collection/components/mds-progress/documentation.json +15 -6
  551. package/dist/collection/components/mds-progress/mds-progress.css +5 -5
  552. package/dist/collection/components/mds-progress/mds-progress.js +2 -1
  553. package/dist/collection/components/mds-push-notification/AGENTS.md +4 -7
  554. package/dist/collection/components/mds-push-notification/antipattern.md +2 -2
  555. package/dist/collection/components/mds-push-notification/documentation.json +24 -12
  556. package/dist/collection/components/mds-push-notification/mds-push-notification.css +11 -11
  557. package/dist/collection/components/mds-push-notification/mds-push-notification.js +2 -1
  558. package/dist/collection/components/mds-push-notification/pattern.md +2 -5
  559. package/dist/collection/components/mds-push-notification-item/AGENTS.md +3 -5
  560. package/dist/collection/components/mds-push-notification-item/documentation.json +20 -9
  561. package/dist/collection/components/mds-push-notification-item/mds-push-notification-item.css +3 -3
  562. package/dist/collection/components/mds-push-notification-item/mds-push-notification-item.js +3 -2
  563. package/dist/collection/components/mds-push-notification-item/pattern.md +1 -3
  564. package/dist/collection/components/mds-quote/AGENTS.md +1 -1
  565. package/dist/collection/components/mds-quote/documentation.json +5 -1
  566. package/dist/collection/components/mds-quote/mds-quote.js +2 -1
  567. package/dist/collection/components/mds-radial-menu/AGENTS.md +4 -11
  568. package/dist/collection/components/mds-radial-menu/documentation.json +31 -15
  569. package/dist/collection/components/mds-radial-menu/mds-radial-menu.css +3 -3
  570. package/dist/collection/components/mds-radial-menu/mds-radial-menu.js +2 -1
  571. package/dist/collection/components/mds-radial-menu/pattern.md +2 -6
  572. package/dist/collection/components/mds-radial-menu-item/AGENTS.md +2 -5
  573. package/dist/collection/components/mds-radial-menu-item/antipattern.md +7 -5
  574. package/dist/collection/components/mds-radial-menu-item/documentation.json +13 -6
  575. package/dist/collection/components/mds-radial-menu-item/mds-radial-menu-item.js +4 -1
  576. package/dist/collection/components/mds-radial-menu-item/pattern.md +6 -8
  577. package/dist/collection/components/mds-radial-progress/AGENTS.md +3 -3
  578. package/dist/collection/components/mds-radial-progress/documentation.json +15 -6
  579. package/dist/collection/components/mds-radial-progress/mds-radial-progress.css +3 -3
  580. package/dist/collection/components/mds-radial-progress/mds-radial-progress.js +2 -1
  581. package/dist/collection/components/mds-separator/AGENTS.md +1 -1
  582. package/dist/collection/components/mds-separator/documentation.json +9 -3
  583. package/dist/collection/components/mds-separator/mds-separator.css +1 -1
  584. package/dist/collection/components/mds-separator/mds-separator.js +4 -1
  585. package/dist/collection/components/mds-spinner/AGENTS.md +1 -1
  586. package/dist/collection/components/mds-spinner/documentation.json +9 -3
  587. package/dist/collection/components/mds-spinner/mds-spinner.css +1 -1
  588. package/dist/collection/components/mds-spinner/mds-spinner.js +4 -1
  589. package/dist/collection/components/mds-status-bar/AGENTS.md +3 -3
  590. package/dist/collection/components/mds-status-bar/antipattern.md +0 -1
  591. package/dist/collection/components/mds-status-bar/documentation.json +13 -6
  592. package/dist/collection/components/mds-status-bar/mds-status-bar.css +2 -1
  593. package/dist/collection/components/mds-status-bar/mds-status-bar.js +2 -1
  594. package/dist/collection/components/mds-status-bar/pattern.md +1 -3
  595. package/dist/collection/components/mds-stepper-bar/AGENTS.md +3 -7
  596. package/dist/collection/components/mds-stepper-bar/documentation.json +22 -10
  597. package/dist/collection/components/mds-stepper-bar/mds-stepper-bar.css +2 -2
  598. package/dist/collection/components/mds-stepper-bar/mds-stepper-bar.js +2 -1
  599. package/dist/collection/components/mds-stepper-bar/pattern.md +2 -6
  600. package/dist/collection/components/mds-stepper-bar-item/AGENTS.md +3 -11
  601. package/dist/collection/components/mds-stepper-bar-item/antipattern.md +3 -3
  602. package/dist/collection/components/mds-stepper-bar-item/documentation.json +31 -15
  603. package/dist/collection/components/mds-stepper-bar-item/mds-stepper-bar-item.css +2 -2
  604. package/dist/collection/components/mds-stepper-bar-item/mds-stepper-bar-item.js +7 -4
  605. package/dist/collection/components/mds-stepper-bar-item/pattern.md +2 -5
  606. package/dist/collection/components/mds-tab/AGENTS.md +3 -27
  607. package/dist/collection/components/mds-tab/antipattern.md +1 -3
  608. package/dist/collection/components/mds-tab/documentation.json +67 -33
  609. package/dist/collection/components/mds-tab/mds-tab.css +5 -5
  610. package/dist/collection/components/mds-tab/mds-tab.js +3 -2
  611. package/dist/collection/components/mds-tab/pattern.md +3 -13
  612. package/dist/collection/components/mds-tab-bar/AGENTS.md +1 -1
  613. package/dist/collection/components/mds-tab-bar/antipattern.md +2 -2
  614. package/dist/collection/components/mds-tab-bar/documentation.json +7 -3
  615. package/dist/collection/components/mds-tab-bar/mds-tab-bar.js +2 -1
  616. package/dist/collection/components/mds-tab-bar/pattern.md +3 -3
  617. package/dist/collection/components/mds-tab-bar-item/AGENTS.md +4 -4
  618. package/dist/collection/components/mds-tab-bar-item/documentation.json +15 -7
  619. package/dist/collection/components/mds-tab-bar-item/mds-tab-bar-item.css +2 -2
  620. package/dist/collection/components/mds-tab-bar-item/mds-tab-bar-item.js +2 -1
  621. package/dist/collection/components/mds-tab-bar-item/pattern.md +1 -3
  622. package/dist/collection/components/mds-tab-item/AGENTS.md +2 -8
  623. package/dist/collection/components/mds-tab-item/antipattern.md +3 -3
  624. package/dist/collection/components/mds-tab-item/documentation.json +17 -8
  625. package/dist/collection/components/mds-tab-item/mds-tab-item.js +2 -1
  626. package/dist/collection/components/mds-tab-item/pattern.md +6 -5
  627. package/dist/collection/components/mds-table/AGENTS.md +3 -7
  628. package/dist/collection/components/mds-table/documentation.json +24 -11
  629. package/dist/collection/components/mds-table/mds-table.css +3 -3
  630. package/dist/collection/components/mds-table/mds-table.js +2 -1
  631. package/dist/collection/components/mds-table/pattern.md +2 -6
  632. package/dist/collection/components/mds-table-body/AGENTS.md +3 -4
  633. package/dist/collection/components/mds-table-body/antipattern.md +1 -2
  634. package/dist/collection/components/mds-table-body/documentation.json +17 -8
  635. package/dist/collection/components/mds-table-body/mds-table-body.css +2 -2
  636. package/dist/collection/components/mds-table-body/mds-table-body.js +2 -1
  637. package/dist/collection/components/mds-table-body/pattern.md +1 -4
  638. package/dist/collection/components/mds-table-cell/AGENTS.md +4 -4
  639. package/dist/collection/components/mds-table-cell/antipattern.md +1 -1
  640. package/dist/collection/components/mds-table-cell/documentation.json +16 -8
  641. package/dist/collection/components/mds-table-cell/mds-table-cell.css +2 -2
  642. package/dist/collection/components/mds-table-cell/mds-table-cell.js +2 -1
  643. package/dist/collection/components/mds-table-cell/pattern.md +1 -7
  644. package/dist/collection/components/mds-table-footer/AGENTS.md +1 -1
  645. package/dist/collection/components/mds-table-footer/antipattern.md +2 -2
  646. package/dist/collection/components/mds-table-footer/documentation.json +7 -3
  647. package/dist/collection/components/mds-table-footer/mds-table-footer.js +2 -1
  648. package/dist/collection/components/mds-table-footer/pattern.md +2 -4
  649. package/dist/collection/components/mds-table-header/AGENTS.md +1 -1
  650. package/dist/collection/components/mds-table-header/documentation.json +5 -1
  651. package/dist/collection/components/mds-table-header/mds-table-header.js +2 -1
  652. package/dist/collection/components/mds-table-header-cell/AGENTS.md +1 -1
  653. package/dist/collection/components/mds-table-header-cell/documentation.json +5 -1
  654. package/dist/collection/components/mds-table-header-cell/mds-table-header-cell.js +2 -1
  655. package/dist/collection/components/mds-table-row/AGENTS.md +2 -8
  656. package/dist/collection/components/mds-table-row/antipattern.md +4 -5
  657. package/dist/collection/components/mds-table-row/documentation.json +17 -8
  658. package/dist/collection/components/mds-table-row/mds-table-row.js +4 -3
  659. package/dist/collection/components/mds-table-row/pattern.md +5 -8
  660. package/dist/collection/components/mds-text/AGENTS.md +3 -3
  661. package/dist/collection/components/mds-text/antipattern.md +1 -2
  662. package/dist/collection/components/mds-text/documentation.json +17 -8
  663. package/dist/collection/components/mds-text/mds-text.css +3 -3
  664. package/dist/collection/components/mds-text/mds-text.js +2 -1
  665. package/dist/collection/components/mds-text/pattern.md +0 -11
  666. package/dist/collection/components/mds-toast/AGENTS.md +3 -3
  667. package/dist/collection/components/mds-toast/antipattern.md +2 -2
  668. package/dist/collection/components/mds-toast/documentation.json +19 -9
  669. package/dist/collection/components/mds-toast/mds-toast.css +4 -4
  670. package/dist/collection/components/mds-toast/mds-toast.js +2 -1
  671. package/dist/collection/components/mds-toast/pattern.md +2 -3
  672. package/dist/collection/components/mds-toast-region/AGENTS.md +1 -1
  673. package/dist/collection/components/mds-toast-region/documentation.json +7 -2
  674. package/dist/collection/components/mds-toast-region/mds-toast-region.css +1 -1
  675. package/dist/collection/components/mds-toast-region/mds-toast-region.js +2 -1
  676. package/dist/collection/components/mds-tooltip/AGENTS.md +3 -8
  677. package/dist/collection/components/mds-tooltip/antipattern.md +1 -1
  678. package/dist/collection/components/mds-tooltip/documentation.json +27 -13
  679. package/dist/collection/components/mds-tooltip/mds-tooltip.css +5 -5
  680. package/dist/collection/components/mds-tooltip/mds-tooltip.js +2 -1
  681. package/dist/collection/components/mds-tooltip/pattern.md +1 -3
  682. package/dist/collection/components/mds-tree/AGENTS.md +3 -28
  683. package/dist/collection/components/mds-tree/antipattern.md +3 -4
  684. package/dist/collection/components/mds-tree/documentation.json +63 -31
  685. package/dist/collection/components/mds-tree/mds-tree.css +1 -1
  686. package/dist/collection/components/mds-tree/mds-tree.js +2 -1
  687. package/dist/collection/components/mds-tree/pattern.md +3 -9
  688. package/dist/collection/components/mds-tree-item/AGENTS.md +2 -33
  689. package/dist/collection/components/mds-tree-item/antipattern.md +1 -5
  690. package/dist/collection/components/mds-tree-item/documentation.json +67 -33
  691. package/dist/collection/components/mds-tree-item/mds-tree-item.js +2 -1
  692. package/dist/collection/components/mds-tree-item/pattern.md +5 -10
  693. package/dist/collection/components/mds-url-view/AGENTS.md +3 -2
  694. package/dist/collection/components/mds-url-view/antipattern.md +1 -2
  695. package/dist/collection/components/mds-url-view/documentation.json +19 -9
  696. package/dist/collection/components/mds-url-view/mds-url-view.css +4 -4
  697. package/dist/collection/components/mds-url-view/mds-url-view.js +4 -1
  698. package/dist/collection/components/mds-url-view/pattern.md +1 -2
  699. package/dist/collection/components/mds-usage/AGENTS.md +2 -6
  700. package/dist/collection/components/mds-usage/antipattern.md +6 -4
  701. package/dist/collection/components/mds-usage/documentation.json +13 -6
  702. package/dist/collection/components/mds-usage/mds-usage.js +2 -1
  703. package/dist/collection/components/mds-usage/pattern.md +10 -6
  704. package/dist/collection/components/mds-video-wall/AGENTS.md +3 -4
  705. package/dist/collection/components/mds-video-wall/antipattern.md +5 -5
  706. package/dist/collection/components/mds-video-wall/documentation.json +15 -7
  707. package/dist/collection/components/mds-video-wall/mds-video-wall.css +1 -1
  708. package/dist/collection/components/mds-video-wall/mds-video-wall.js +2 -1
  709. package/dist/collection/components/mds-video-wall/pattern.md +2 -4
  710. package/dist/collection/components/mds-zero/AGENTS.md +1 -1
  711. package/dist/collection/components/mds-zero/antipattern.md +6 -6
  712. package/dist/collection/components/mds-zero/documentation.json +9 -4
  713. package/dist/collection/components/mds-zero/mds-zero.css +1 -1
  714. package/dist/collection/components/mds-zero/mds-zero.js +2 -1
  715. package/dist/collection/components/mds-zero/pattern.md +3 -3
  716. package/dist/components/index.d.ts +2 -0
  717. package/dist/components/index.js +1 -1
  718. package/dist/components/mds-accordion-item.js +1 -1
  719. package/dist/components/mds-accordion-timer-item.js +1 -1
  720. package/dist/components/mds-accordion-timer.js +1 -1
  721. package/dist/components/mds-accordion.js +1 -1
  722. package/dist/components/mds-author.js +1 -1
  723. package/dist/components/mds-avatar-stack-item.js +1 -1
  724. package/dist/components/mds-avatar-stack.js +1 -1
  725. package/dist/components/mds-avatar.js +1 -1
  726. package/dist/components/mds-badge.js +1 -1
  727. package/dist/components/mds-banner.js +1 -1
  728. package/dist/components/mds-benchmark-bar.js +1 -1
  729. package/dist/components/mds-bibliography.js +1 -1
  730. package/dist/components/mds-book.d.ts +11 -0
  731. package/dist/components/mds-book.js +1 -0
  732. package/dist/components/mds-breadcrumb-item.js +1 -1
  733. package/dist/components/mds-breadcrumb.js +1 -1
  734. package/dist/components/mds-button-dropdown.js +1 -1
  735. package/dist/components/mds-button-group.js +1 -1
  736. package/dist/components/mds-button.js +1 -1
  737. package/dist/components/mds-calendar-cell.js +1 -1
  738. package/dist/components/mds-calendar.js +1 -1
  739. package/dist/components/mds-card-content.js +1 -1
  740. package/dist/components/mds-card-footer.js +1 -1
  741. package/dist/components/mds-card-header.js +1 -1
  742. package/dist/components/mds-card-media.js +1 -1
  743. package/dist/components/mds-card.js +1 -1
  744. package/dist/components/mds-chip.js +1 -1
  745. package/dist/components/mds-details.js +1 -1
  746. package/dist/components/mds-dropdown.js +1 -1
  747. package/dist/components/mds-emoji.js +2 -2
  748. package/dist/components/mds-entity.js +1 -1
  749. package/dist/components/mds-file-preview.js +1 -1
  750. package/dist/components/mds-file.js +1 -1
  751. package/dist/components/mds-filter-item.js +1 -1
  752. package/dist/components/mds-filter.js +1 -1
  753. package/dist/components/mds-header-bar.js +1 -1
  754. package/dist/components/mds-header.js +1 -1
  755. package/dist/components/mds-help.js +1 -1
  756. package/dist/components/mds-horizontal-scroll.js +1 -1
  757. package/dist/components/mds-hr.js +1 -1
  758. package/dist/components/mds-icon.js +1 -1
  759. package/dist/components/mds-img.js +1 -1
  760. package/dist/components/mds-input-date-range-preselection.js +1 -1
  761. package/dist/components/mds-input-date-range.js +1 -1
  762. package/dist/components/mds-input-date.js +1 -1
  763. package/dist/components/mds-input-field.js +1 -1
  764. package/dist/components/mds-input-otp.js +1 -1
  765. package/dist/components/mds-input-range.js +1 -1
  766. package/dist/components/mds-input-select.js +1 -1
  767. package/dist/components/mds-input-switch.js +1 -1
  768. package/dist/components/mds-input-tip-item.js +1 -1
  769. package/dist/components/mds-input-tip.js +1 -1
  770. package/dist/components/mds-input-upload.js +1 -1
  771. package/dist/components/mds-input.js +1 -1
  772. package/dist/components/mds-keyboard-key.js +1 -1
  773. package/dist/components/mds-keyboard.js +1 -1
  774. package/dist/components/mds-kpi-item.js +1 -1
  775. package/dist/components/mds-kpi.js +1 -1
  776. package/dist/components/mds-label.js +1 -1
  777. package/dist/components/mds-link.js +1 -1
  778. package/dist/components/mds-list-item.js +1 -1
  779. package/dist/components/mds-list.js +1 -1
  780. package/dist/components/mds-mention.js +1 -1
  781. package/dist/components/mds-modal.js +1 -1
  782. package/dist/components/mds-note.js +1 -1
  783. package/dist/components/mds-notification.js +1 -1
  784. package/dist/components/mds-paginator-item.js +1 -1
  785. package/dist/components/mds-paginator.js +1 -1
  786. package/dist/components/mds-policy-ai.js +1 -1
  787. package/dist/components/mds-pref-animation.js +1 -1
  788. package/dist/components/mds-pref-consumption.js +1 -1
  789. package/dist/components/mds-pref-contrast.js +1 -1
  790. package/dist/components/mds-pref-language-item.js +1 -1
  791. package/dist/components/mds-pref-language.js +1 -1
  792. package/dist/components/mds-pref-mode.js +1 -1
  793. package/dist/components/mds-pref-theme-item.js +1 -1
  794. package/dist/components/mds-pref-theme.js +1 -1
  795. package/dist/components/mds-pref.js +1 -1
  796. package/dist/components/mds-price-table-features-cell.js +1 -1
  797. package/dist/components/mds-price-table-features-row.js +1 -1
  798. package/dist/components/mds-price-table-features.js +1 -1
  799. package/dist/components/mds-price-table-header.js +1 -1
  800. package/dist/components/mds-price-table-list-item.js +1 -1
  801. package/dist/components/mds-price-table-list.js +1 -1
  802. package/dist/components/mds-price-table.js +1 -1
  803. package/dist/components/mds-progress.js +1 -1
  804. package/dist/components/mds-push-notification-item.js +1 -1
  805. package/dist/components/mds-push-notification.js +1 -1
  806. package/dist/components/mds-quote.js +1 -1
  807. package/dist/components/mds-radial-menu-item.js +1 -1
  808. package/dist/components/mds-radial-menu.js +1 -1
  809. package/dist/components/mds-radial-progress.js +1 -1
  810. package/dist/components/mds-separator.js +1 -1
  811. package/dist/components/mds-spinner.js +1 -1
  812. package/dist/components/mds-status-bar.js +1 -1
  813. package/dist/components/mds-stepper-bar-item.js +1 -1
  814. package/dist/components/mds-stepper-bar.js +1 -1
  815. package/dist/components/mds-tab-bar-item.js +1 -1
  816. package/dist/components/mds-tab-bar.js +1 -1
  817. package/dist/components/mds-tab-item.js +1 -1
  818. package/dist/components/mds-tab.js +1 -1
  819. package/dist/components/mds-table-body.js +1 -1
  820. package/dist/components/mds-table-cell.js +1 -1
  821. package/dist/components/mds-table-footer.js +1 -1
  822. package/dist/components/mds-table-header-cell.js +1 -1
  823. package/dist/components/mds-table-header.js +1 -1
  824. package/dist/components/mds-table-row.js +1 -1
  825. package/dist/components/mds-table.js +1 -1
  826. package/dist/components/mds-text.js +1 -1
  827. package/dist/components/mds-toast-region.js +1 -1
  828. package/dist/components/mds-toast.js +1 -1
  829. package/dist/components/mds-tooltip.js +1 -1
  830. package/dist/components/mds-tree-item.js +1 -1
  831. package/dist/components/mds-tree.js +1 -1
  832. package/dist/components/mds-url-view.js +1 -1
  833. package/dist/components/mds-usage.js +1 -1
  834. package/dist/components/mds-video-wall.js +1 -1
  835. package/dist/components/mds-zero.js +1 -1
  836. package/dist/components/p-B8hgyXdE.js +1 -0
  837. package/dist/components/{p-DkUdrGHq.js → p-BBO_llcO.js} +1 -1
  838. package/dist/components/{p-nsbhb0lz.js → p-BM7joOdq.js} +1 -1
  839. package/dist/components/{p-DNeEn8Rr.js → p-BMIaZ4HY.js} +1 -1
  840. package/dist/components/{p-BwJQB6rG.js → p-BOJQ3tkp.js} +1 -1
  841. package/dist/components/{p-DCrdKrky.js → p-BU1O2DcC.js} +1 -1
  842. package/dist/components/{p-Cd8id3Br.js → p-Bo6ezD1p.js} +1 -1
  843. package/dist/components/p-C0H8bZpf.js +1 -0
  844. package/dist/components/{p-s1CktmPS.js → p-C1YH20BL.js} +1 -1
  845. package/dist/components/{p-Cmn1DJAB.js → p-CEw7GvM-.js} +1 -1
  846. package/dist/components/{p-D-DdDIb9.js → p-CNUWS_Mg.js} +1 -1
  847. package/dist/components/{p-uqwixjju.js → p-CNpL55c-.js} +1 -1
  848. package/dist/components/{p-DnySYX0L.js → p-CV7wjM1c.js} +1 -1
  849. package/dist/components/{p-BU3bsIX2.js → p-CWSIl1jl.js} +1 -1
  850. package/dist/components/{p-C99SMdU_.js → p-CYK2Xr_v.js} +1 -1
  851. package/dist/components/{p-B8x-d2fx.js → p-CZjwSwe5.js} +1 -1
  852. package/dist/components/p-Czqtt8kO.js +1 -0
  853. package/dist/components/{p-Dm-OUwDe.js → p-DD2muCqG.js} +1 -1
  854. package/dist/components/{p-ZuubAcA3.js → p-DDTJwlAd.js} +1 -1
  855. package/dist/components/{p-DF3PrYBI.js → p-DJ401QTd.js} +1 -1
  856. package/dist/components/{p-BbK4qeM7.js → p-DMyL4CYh.js} +1 -1
  857. package/dist/components/{p-DiUUZ7ZA.js → p-DTtmr_Y9.js} +1 -1
  858. package/dist/components/{p-CfQETwAK.js → p-DbVGGhs_.js} +1 -1
  859. package/dist/components/{p-C4XdTZQ-.js → p-DccBbfK8.js} +1 -1
  860. package/dist/components/{p-CNZ8_QvE.js → p-H0YXZ5fD.js} +2 -2
  861. package/dist/components/p-IaXq1Xsc.js +1 -0
  862. package/dist/components/{p-ClPv-Ljc.js → p-M8dGB4KH.js} +1 -1
  863. package/dist/components/{p-C1CTahjH.js → p-TNn_HE5x.js} +1 -1
  864. package/dist/components/{p-CNF3u0Li.js → p-aujz-VM9.js} +1 -1
  865. package/dist/components/{p-CSxW5f2f.js → p-e9NGNm7d.js} +1 -1
  866. package/dist/components/{p-D2d9eOLi.js → p-kZBPId_x.js} +1 -1
  867. package/dist/components/{p-CLe_N2_H.js → p-qnCVkeGX.js} +1 -1
  868. package/dist/documentation.json +2616 -921
  869. package/dist/esm/{index-D2_gI0qp.js → index-BJVvHlvf.js} +1 -1
  870. package/dist/esm/index-CvLLN-QH.js +4 -0
  871. package/dist/esm/loader.js +1 -1
  872. package/dist/esm/{locale-BQmO6K_S.js → locale-B6cOkl4I.js} +12 -6
  873. package/dist/esm/magma-components.js +1 -1
  874. package/dist/esm/mds-accordion-item.entry.js +1 -1
  875. package/dist/esm/mds-accordion-timer-item.entry.js +1 -1
  876. package/dist/esm/mds-accordion-timer.entry.js +1 -1
  877. package/dist/esm/mds-accordion.entry.js +1 -1
  878. package/dist/esm/mds-author.entry.js +1 -1
  879. package/dist/esm/mds-avatar-stack-item.entry.js +1 -1
  880. package/dist/esm/mds-avatar-stack.entry.js +1 -1
  881. package/dist/esm/mds-avatar.entry.js +1 -1
  882. package/dist/esm/mds-badge.entry.js +1 -1
  883. package/dist/esm/mds-banner_3.entry.js +4 -4
  884. package/dist/esm/mds-benchmark-bar.entry.js +1 -1
  885. package/dist/esm/mds-bibliography.entry.js +1 -1
  886. package/dist/esm/mds-book.entry.js +701 -0
  887. package/dist/esm/mds-breadcrumb-item.entry.js +1 -1
  888. package/dist/esm/mds-breadcrumb.entry.js +2 -2
  889. package/dist/esm/mds-button-dropdown.entry.js +2 -2
  890. package/dist/esm/mds-button-group.entry.js +1 -1
  891. package/dist/esm/mds-button_3.entry.js +6 -6
  892. package/dist/esm/mds-calendar_2.entry.js +7 -7
  893. package/dist/esm/mds-card-content.entry.js +1 -1
  894. package/dist/esm/mds-card-footer.entry.js +1 -1
  895. package/dist/esm/mds-card-header.entry.js +1 -1
  896. package/dist/esm/mds-card-media.entry.js +1 -1
  897. package/dist/esm/mds-card.entry.js +1 -1
  898. package/dist/esm/mds-details.entry.js +1 -1
  899. package/dist/esm/mds-dropdown.entry.js +2 -2
  900. package/dist/esm/mds-emoji.entry.js +2 -2
  901. package/dist/esm/mds-entity.entry.js +1 -1
  902. package/dist/esm/mds-file-preview.entry.js +3 -3
  903. package/dist/esm/mds-file.entry.js +2 -2
  904. package/dist/esm/mds-filter-item.entry.js +2 -2
  905. package/dist/esm/mds-filter.entry.js +2 -2
  906. package/dist/esm/mds-header-bar.entry.js +2 -2
  907. package/dist/esm/mds-header.entry.js +2 -2
  908. package/dist/esm/mds-horizontal-scroll.entry.js +2 -2
  909. package/dist/esm/mds-hr.entry.js +1 -1
  910. package/dist/esm/mds-img.entry.js +1 -1
  911. package/dist/esm/mds-input-date-range-preselection.entry.js +1 -1
  912. package/dist/esm/mds-input-date-range.entry.js +3 -3
  913. package/dist/esm/mds-input-date.entry.js +4 -4
  914. package/dist/esm/mds-input-field.entry.js +1 -1
  915. package/dist/esm/mds-input-otp.entry.js +2 -2
  916. package/dist/esm/mds-input-range.entry.js +2 -2
  917. package/dist/esm/mds-input-select.entry.js +9 -5
  918. package/dist/esm/mds-input-switch_2.entry.js +3 -3
  919. package/dist/esm/mds-input-tip_2.entry.js +4 -4
  920. package/dist/esm/mds-input-upload.entry.js +6 -6
  921. package/dist/esm/mds-input.entry.js +154 -37
  922. package/dist/esm/mds-keyboard-key.entry.js +3 -3
  923. package/dist/esm/mds-keyboard.entry.js +8 -4
  924. package/dist/esm/mds-kpi-item.entry.js +1 -1
  925. package/dist/esm/mds-kpi.entry.js +1 -1
  926. package/dist/esm/mds-label.entry.js +2 -2
  927. package/dist/esm/mds-link.entry.js +4 -4
  928. package/dist/esm/mds-list-item.entry.js +1 -1
  929. package/dist/esm/mds-list.entry.js +1 -1
  930. package/dist/esm/mds-mention.entry.js +2 -2
  931. package/dist/esm/mds-modal.entry.js +4 -4
  932. package/dist/esm/mds-note.entry.js +2 -2
  933. package/dist/esm/mds-notification.entry.js +1 -1
  934. package/dist/esm/mds-paginator-item.entry.js +1 -1
  935. package/dist/esm/mds-paginator.entry.js +2 -2
  936. package/dist/esm/mds-policy-ai.entry.js +2 -2
  937. package/dist/esm/mds-pref-animation.entry.js +2 -2
  938. package/dist/esm/mds-pref-consumption.entry.js +2 -2
  939. package/dist/esm/mds-pref-contrast.entry.js +2 -2
  940. package/dist/esm/mds-pref-language-item.entry.js +2 -2
  941. package/dist/esm/mds-pref-language.entry.js +2 -2
  942. package/dist/esm/mds-pref-mode.entry.js +2 -2
  943. package/dist/esm/mds-pref-theme-item.entry.js +1 -1
  944. package/dist/esm/mds-pref-theme.entry.js +2 -2
  945. package/dist/esm/mds-pref.entry.js +2 -2
  946. package/dist/esm/mds-price-table-features-cell.entry.js +1 -1
  947. package/dist/esm/mds-price-table-features-row.entry.js +1 -1
  948. package/dist/esm/mds-price-table-features.entry.js +1 -1
  949. package/dist/esm/mds-price-table-header.entry.js +1 -1
  950. package/dist/esm/mds-price-table-list-item.entry.js +1 -1
  951. package/dist/esm/mds-price-table-list.entry.js +1 -1
  952. package/dist/esm/mds-price-table.entry.js +1 -1
  953. package/dist/esm/mds-progress_2.entry.js +2 -2
  954. package/dist/esm/mds-push-notification-item.entry.js +3 -3
  955. package/dist/esm/mds-push-notification.entry.js +3 -3
  956. package/dist/esm/mds-quote.entry.js +1 -1
  957. package/dist/esm/mds-radial-menu-item.entry.js +1 -1
  958. package/dist/esm/mds-radial-menu.entry.js +2 -2
  959. package/dist/esm/mds-separator.entry.js +1 -1
  960. package/dist/esm/mds-status-bar.entry.js +2 -2
  961. package/dist/esm/mds-stepper-bar-item.entry.js +7 -5
  962. package/dist/esm/mds-stepper-bar.entry.js +1 -1
  963. package/dist/esm/mds-tab-bar-item.entry.js +1 -1
  964. package/dist/esm/mds-tab-bar.entry.js +1 -1
  965. package/dist/esm/mds-tab_2.entry.js +4 -4
  966. package/dist/esm/mds-table-body.entry.js +1 -1
  967. package/dist/esm/mds-table-footer.entry.js +1 -1
  968. package/dist/esm/mds-table-header-cell.entry.js +1 -1
  969. package/dist/esm/mds-table-header.entry.js +2 -2
  970. package/dist/esm/mds-table-row.entry.js +3 -3
  971. package/dist/esm/mds-table.entry.js +2 -2
  972. package/dist/esm/mds-text.entry.js +1 -1
  973. package/dist/esm/mds-toast-region.entry.js +1 -1
  974. package/dist/esm/mds-toast.entry.js +2 -2
  975. package/dist/esm/mds-tooltip.entry.js +2 -2
  976. package/dist/esm/mds-tree-item.entry.js +2 -2
  977. package/dist/esm/mds-tree.entry.js +1 -1
  978. package/dist/esm/mds-url-view.entry.js +2 -2
  979. package/dist/esm/mds-usage.entry.js +2 -2
  980. package/dist/esm/mds-video-wall.entry.js +1 -1
  981. package/dist/esm/mds-zero.entry.js +1 -1
  982. package/dist/esm-es5/{index-D2_gI0qp.js → index-BJVvHlvf.js} +1 -1
  983. package/dist/esm-es5/index-CvLLN-QH.js +8 -6
  984. package/dist/esm-es5/loader.js +1 -1
  985. package/dist/esm-es5/{locale-BQmO6K_S.js → locale-B6cOkl4I.js} +22 -18
  986. package/dist/esm-es5/magma-components.js +2 -2
  987. package/dist/esm-es5/mds-accordion-item.entry.js +1 -1
  988. package/dist/esm-es5/mds-accordion-timer-item.entry.js +1 -1
  989. package/dist/esm-es5/mds-accordion-timer.entry.js +1 -1
  990. package/dist/esm-es5/mds-accordion.entry.js +2 -2
  991. package/dist/esm-es5/mds-author.entry.js +1 -1
  992. package/dist/esm-es5/mds-avatar-stack-item.entry.js +1 -1
  993. package/dist/esm-es5/mds-avatar-stack.entry.js +1 -1
  994. package/dist/esm-es5/mds-avatar.entry.js +5 -5
  995. package/dist/esm-es5/mds-badge.entry.js +1 -1
  996. package/dist/esm-es5/mds-banner_3.entry.js +4 -4
  997. package/dist/esm-es5/mds-benchmark-bar.entry.js +3 -3
  998. package/dist/esm-es5/mds-bibliography.entry.js +2 -2
  999. package/dist/esm-es5/mds-book.entry.js +207 -0
  1000. package/dist/esm-es5/mds-breadcrumb-item.entry.js +1 -1
  1001. package/dist/esm-es5/mds-breadcrumb.entry.js +4 -4
  1002. package/dist/esm-es5/mds-button-dropdown.entry.js +2 -2
  1003. package/dist/esm-es5/mds-button-group.entry.js +1 -1
  1004. package/dist/esm-es5/mds-button_3.entry.js +5 -5
  1005. package/dist/esm-es5/mds-calendar_2.entry.js +4 -4
  1006. package/dist/esm-es5/mds-card-content.entry.js +1 -1
  1007. package/dist/esm-es5/mds-card-footer.entry.js +1 -1
  1008. package/dist/esm-es5/mds-card-header.entry.js +1 -1
  1009. package/dist/esm-es5/mds-card-media.entry.js +1 -1
  1010. package/dist/esm-es5/mds-card.entry.js +1 -1
  1011. package/dist/esm-es5/mds-details.entry.js +1 -1
  1012. package/dist/esm-es5/mds-dropdown.entry.js +1 -1
  1013. package/dist/esm-es5/mds-emoji.entry.js +2 -2
  1014. package/dist/esm-es5/mds-entity.entry.js +1 -1
  1015. package/dist/esm-es5/mds-file-preview.entry.js +8 -8
  1016. package/dist/esm-es5/mds-file.entry.js +2 -2
  1017. package/dist/esm-es5/mds-filter-item.entry.js +2 -2
  1018. package/dist/esm-es5/mds-filter.entry.js +2 -2
  1019. package/dist/esm-es5/mds-header-bar.entry.js +2 -2
  1020. package/dist/esm-es5/mds-header.entry.js +2 -2
  1021. package/dist/esm-es5/mds-horizontal-scroll.entry.js +2 -2
  1022. package/dist/esm-es5/mds-hr.entry.js +1 -1
  1023. package/dist/esm-es5/mds-img.entry.js +1 -1
  1024. package/dist/esm-es5/mds-input-date-range-preselection.entry.js +1 -1
  1025. package/dist/esm-es5/mds-input-date-range.entry.js +3 -3
  1026. package/dist/esm-es5/mds-input-date.entry.js +3 -3
  1027. package/dist/esm-es5/mds-input-field.entry.js +1 -1
  1028. package/dist/esm-es5/mds-input-otp.entry.js +2 -2
  1029. package/dist/esm-es5/mds-input-range.entry.js +7 -7
  1030. package/dist/esm-es5/mds-input-select.entry.js +5 -4
  1031. package/dist/esm-es5/mds-input-switch_2.entry.js +2 -2
  1032. package/dist/esm-es5/mds-input-tip_2.entry.js +3 -3
  1033. package/dist/esm-es5/mds-input-upload.entry.js +2 -2
  1034. package/dist/esm-es5/mds-input.entry.js +53 -50
  1035. package/dist/esm-es5/mds-keyboard-key.entry.js +2 -2
  1036. package/dist/esm-es5/mds-keyboard.entry.js +6 -3
  1037. package/dist/esm-es5/mds-kpi-item.entry.js +3 -3
  1038. package/dist/esm-es5/mds-kpi.entry.js +1 -1
  1039. package/dist/esm-es5/mds-label.entry.js +2 -2
  1040. package/dist/esm-es5/mds-link.entry.js +2 -2
  1041. package/dist/esm-es5/mds-list-item.entry.js +1 -1
  1042. package/dist/esm-es5/mds-list.entry.js +1 -1
  1043. package/dist/esm-es5/mds-mention.entry.js +2 -2
  1044. package/dist/esm-es5/mds-modal.entry.js +2 -2
  1045. package/dist/esm-es5/mds-note.entry.js +2 -2
  1046. package/dist/esm-es5/mds-notification.entry.js +1 -1
  1047. package/dist/esm-es5/mds-paginator-item.entry.js +1 -1
  1048. package/dist/esm-es5/mds-paginator.entry.js +3 -3
  1049. package/dist/esm-es5/mds-policy-ai.entry.js +2 -2
  1050. package/dist/esm-es5/mds-pref-animation.entry.js +2 -2
  1051. package/dist/esm-es5/mds-pref-consumption.entry.js +2 -2
  1052. package/dist/esm-es5/mds-pref-contrast.entry.js +2 -2
  1053. package/dist/esm-es5/mds-pref-language-item.entry.js +2 -2
  1054. package/dist/esm-es5/mds-pref-language.entry.js +2 -2
  1055. package/dist/esm-es5/mds-pref-mode.entry.js +2 -2
  1056. package/dist/esm-es5/mds-pref-theme-item.entry.js +3 -3
  1057. package/dist/esm-es5/mds-pref-theme.entry.js +6 -6
  1058. package/dist/esm-es5/mds-pref.entry.js +2 -2
  1059. package/dist/esm-es5/mds-price-table-features-cell.entry.js +1 -1
  1060. package/dist/esm-es5/mds-price-table-features-row.entry.js +1 -1
  1061. package/dist/esm-es5/mds-price-table-features.entry.js +1 -1
  1062. package/dist/esm-es5/mds-price-table-header.entry.js +1 -1
  1063. package/dist/esm-es5/mds-price-table-list-item.entry.js +1 -1
  1064. package/dist/esm-es5/mds-price-table-list.entry.js +1 -1
  1065. package/dist/esm-es5/mds-price-table.entry.js +1 -1
  1066. package/dist/esm-es5/mds-progress_2.entry.js +2 -2
  1067. package/dist/esm-es5/mds-push-notification-item.entry.js +2 -2
  1068. package/dist/esm-es5/mds-push-notification.entry.js +2 -2
  1069. package/dist/esm-es5/mds-quote.entry.js +1 -1
  1070. package/dist/esm-es5/mds-radial-menu-item.entry.js +1 -1
  1071. package/dist/esm-es5/mds-radial-menu.entry.js +2 -2
  1072. package/dist/esm-es5/mds-separator.entry.js +1 -1
  1073. package/dist/esm-es5/mds-status-bar.entry.js +2 -2
  1074. package/dist/esm-es5/mds-stepper-bar-item.entry.js +6 -3
  1075. package/dist/esm-es5/mds-stepper-bar.entry.js +1 -1
  1076. package/dist/esm-es5/mds-tab-bar-item.entry.js +1 -1
  1077. package/dist/esm-es5/mds-tab-bar.entry.js +1 -1
  1078. package/dist/esm-es5/mds-tab_2.entry.js +3 -3
  1079. package/dist/esm-es5/mds-table-body.entry.js +1 -1
  1080. package/dist/esm-es5/mds-table-footer.entry.js +1 -1
  1081. package/dist/esm-es5/mds-table-header-cell.entry.js +1 -1
  1082. package/dist/esm-es5/mds-table-header.entry.js +4 -4
  1083. package/dist/esm-es5/mds-table-row.entry.js +2 -2
  1084. package/dist/esm-es5/mds-table.entry.js +2 -2
  1085. package/dist/esm-es5/mds-text.entry.js +1 -1
  1086. package/dist/esm-es5/mds-toast-region.entry.js +1 -1
  1087. package/dist/esm-es5/mds-toast.entry.js +2 -2
  1088. package/dist/esm-es5/mds-tooltip.entry.js +2 -2
  1089. package/dist/esm-es5/mds-tree-item.entry.js +2 -2
  1090. package/dist/esm-es5/mds-tree.entry.js +1 -1
  1091. package/dist/esm-es5/mds-url-view.entry.js +2 -2
  1092. package/dist/esm-es5/mds-usage.entry.js +2 -2
  1093. package/dist/esm-es5/mds-video-wall.entry.js +1 -1
  1094. package/dist/esm-es5/mds-zero.entry.js +1 -1
  1095. package/dist/hydrate/index.js +1228 -207
  1096. package/dist/hydrate/index.mjs +1228 -207
  1097. package/dist/lint/core/checks.d.ts +26 -0
  1098. package/dist/lint/core/checks.js +135 -0
  1099. package/dist/lint/core/colors.d.ts +2 -0
  1100. package/dist/lint/core/colors.js +40 -0
  1101. package/dist/lint/core/data.d.ts +82 -0
  1102. package/dist/lint/core/data.js +171 -0
  1103. package/dist/lint/core/element.d.ts +55 -0
  1104. package/dist/lint/core/element.js +19 -0
  1105. package/dist/lint/eslint/adapters.d.ts +53 -0
  1106. package/dist/lint/eslint/adapters.js +217 -0
  1107. package/dist/lint/eslint/index.d.ts +7 -0
  1108. package/dist/lint/eslint/index.js +86 -0
  1109. package/dist/lint/index.d.ts +4 -0
  1110. package/dist/lint/index.js +10 -0
  1111. package/dist/lint/mcp/checks.d.ts +15 -0
  1112. package/dist/lint/mcp/checks.js +407 -0
  1113. package/dist/lint/mcp/cli.d.ts +2 -0
  1114. package/dist/lint/mcp/cli.js +29 -0
  1115. package/dist/lint/mcp/color.d.ts +12 -0
  1116. package/dist/lint/mcp/color.js +87 -0
  1117. package/dist/lint/mcp/components.d.ts +5 -0
  1118. package/dist/lint/mcp/components.js +362 -0
  1119. package/dist/lint/mcp/context.d.ts +25 -0
  1120. package/dist/lint/mcp/context.js +87 -0
  1121. package/dist/lint/mcp/guides.d.ts +3 -0
  1122. package/dist/lint/mcp/guides.js +137 -0
  1123. package/dist/lint/mcp/icon.svg +11 -0
  1124. package/dist/lint/mcp/icons.d.ts +3 -0
  1125. package/dist/lint/mcp/icons.js +170 -0
  1126. package/dist/lint/mcp/protocol.d.ts +42 -0
  1127. package/dist/lint/mcp/protocol.js +106 -0
  1128. package/dist/lint/mcp/server.d.ts +20 -0
  1129. package/dist/lint/mcp/server.js +67 -0
  1130. package/dist/lint/mcp/tokens.d.ts +22 -0
  1131. package/dist/lint/mcp/tokens.js +507 -0
  1132. package/dist/lint/package.json +3 -0
  1133. package/dist/lint/stylelint/index.d.ts +3 -0
  1134. package/dist/lint/stylelint/index.js +137 -0
  1135. package/dist/lint/stylelint/recommended.d.ts +3 -0
  1136. package/dist/lint/stylelint/recommended.js +10 -0
  1137. package/dist/lint/stylelint/strict.d.ts +3 -0
  1138. package/dist/lint/stylelint/strict.js +10 -0
  1139. package/dist/magma-components/magma-components.esm.js +1 -1
  1140. package/dist/magma-components/{p-26451eb6.entry.js → p-00aa9a51.entry.js} +1 -1
  1141. package/dist/magma-components/{p-5533b60d.system.entry.js → p-00acb2e1.system.entry.js} +3 -3
  1142. package/dist/magma-components/{p-4bc3335f.system.entry.js → p-037126b7.system.entry.js} +1 -1
  1143. package/dist/magma-components/{p-e5d41024.system.entry.js → p-03da0376.system.entry.js} +1 -1
  1144. package/dist/magma-components/{p-25a6e977.entry.js → p-0417391b.entry.js} +1 -1
  1145. package/dist/magma-components/{p-377d0661.entry.js → p-05ef91a5.entry.js} +1 -1
  1146. package/dist/magma-components/{p-336f56a4.entry.js → p-07d35da6.entry.js} +1 -1
  1147. package/dist/magma-components/{p-f4d80d9a.entry.js → p-09c80fdb.entry.js} +1 -1
  1148. package/dist/magma-components/{p-5cfa0dce.entry.js → p-0b0ca53c.entry.js} +1 -1
  1149. package/dist/magma-components/{p-617370e7.system.entry.js → p-0babf674.system.entry.js} +7 -7
  1150. package/dist/magma-components/{p-29162c98.entry.js → p-0d90c991.entry.js} +1 -1
  1151. package/dist/magma-components/{p-9745dc51.entry.js → p-103465cf.entry.js} +1 -1
  1152. package/dist/magma-components/{p-919f9dce.entry.js → p-10983da0.entry.js} +1 -1
  1153. package/dist/magma-components/{p-52d905fe.system.entry.js → p-109926ce.system.entry.js} +2 -2
  1154. package/dist/magma-components/{p-70d38284.entry.js → p-14b13850.entry.js} +1 -1
  1155. package/dist/magma-components/{p-bf0cb77d.system.entry.js → p-154ba354.system.entry.js} +2 -2
  1156. package/dist/magma-components/{p-73833405.entry.js → p-160cd923.entry.js} +1 -1
  1157. package/dist/magma-components/{p-5ef0fb69.system.entry.js → p-1685e74c.system.entry.js} +1 -1
  1158. package/dist/magma-components/p-1748ca8b.system.entry.js +1 -0
  1159. package/dist/magma-components/{p-729c89f9.system.entry.js → p-17a43cb6.system.entry.js} +2 -2
  1160. package/dist/magma-components/p-17ccfc01.system.entry.js +208 -0
  1161. package/dist/magma-components/{p-f670ed20.entry.js → p-198ea5d8.entry.js} +1 -1
  1162. package/dist/magma-components/{p-d561062f.system.entry.js → p-1b415625.system.entry.js} +3 -3
  1163. package/dist/magma-components/{p-4bc47ff0.system.entry.js → p-1b67b149.system.entry.js} +2 -2
  1164. package/dist/magma-components/p-1c00d0f7.entry.js +1 -0
  1165. package/dist/magma-components/{p-05ed801b.system.entry.js → p-1cd75adf.system.entry.js} +3 -3
  1166. package/dist/magma-components/{p-244676d3.system.entry.js → p-1d8485de.system.entry.js} +4 -4
  1167. package/dist/magma-components/{p-23c057a9.entry.js → p-2006cfeb.entry.js} +1 -1
  1168. package/dist/magma-components/{p-02fe26b4.system.entry.js → p-2216f207.system.entry.js} +2 -2
  1169. package/dist/magma-components/{p-edf003f1.system.entry.js → p-22f24125.system.entry.js} +1 -1
  1170. package/dist/magma-components/{p-6560b426.system.entry.js → p-25c07b67.system.entry.js} +1 -1
  1171. package/dist/magma-components/{p-e3a65644.entry.js → p-29fbb7cf.entry.js} +1 -1
  1172. package/dist/magma-components/{p-f7147d05.entry.js → p-2a26b614.entry.js} +1 -1
  1173. package/dist/magma-components/p-2a6c2a41.entry.js +1 -0
  1174. package/dist/magma-components/{p-06fde29d.entry.js → p-2c28056d.entry.js} +1 -1
  1175. package/dist/magma-components/{p-23722401.entry.js → p-2c5e5cd1.entry.js} +1 -1
  1176. package/dist/magma-components/{p-d92ccce5.system.entry.js → p-2c7d091e.system.entry.js} +3 -3
  1177. package/dist/magma-components/{p-3abaa053.entry.js → p-2c997b47.entry.js} +1 -1
  1178. package/dist/magma-components/{p-0a8e8525.entry.js → p-2f39f4e4.entry.js} +1 -1
  1179. package/dist/magma-components/{p-02298ed0.system.entry.js → p-31370fdb.system.entry.js} +1 -1
  1180. package/dist/magma-components/{p-3df07021.system.entry.js → p-3139988c.system.entry.js} +1 -1
  1181. package/dist/magma-components/p-32418266.entry.js +1 -0
  1182. package/dist/magma-components/{p-cc9659e1.system.entry.js → p-33c80de3.system.entry.js} +1 -1
  1183. package/dist/magma-components/{p-09a7b578.system.entry.js → p-34c0e63c.system.entry.js} +1 -1
  1184. package/dist/magma-components/{p-ca1969c5.entry.js → p-354a5b47.entry.js} +1 -1
  1185. package/dist/magma-components/{p-81e02997.system.entry.js → p-35c6341a.system.entry.js} +3 -3
  1186. package/dist/magma-components/{p-b476435f.entry.js → p-379f51a6.entry.js} +1 -1
  1187. package/dist/magma-components/{p-7c217aa5.entry.js → p-381f49ea.entry.js} +1 -1
  1188. package/dist/magma-components/{p-221c2f0d.entry.js → p-384ab014.entry.js} +1 -1
  1189. package/dist/magma-components/{p-29ab84bf.system.entry.js → p-386bb24e.system.entry.js} +4 -4
  1190. package/dist/magma-components/{p-1e18fcc5.system.entry.js → p-39a2df98.system.entry.js} +1 -1
  1191. package/dist/magma-components/{p-5c4e41d3.system.entry.js → p-3a7c4314.system.entry.js} +3 -3
  1192. package/dist/magma-components/{p-e5950aee.entry.js → p-3a9a75e5.entry.js} +1 -1
  1193. package/dist/magma-components/{p-5435f2a9.entry.js → p-3b691cc3.entry.js} +1 -1
  1194. package/dist/magma-components/{p-3fd8ff0e.system.entry.js → p-3bdb541f.system.entry.js} +2 -2
  1195. package/dist/magma-components/{p-dbd34e3b.entry.js → p-3ca004c3.entry.js} +1 -1
  1196. package/dist/magma-components/{p-4776ac1f.entry.js → p-3caf6a26.entry.js} +1 -1
  1197. package/dist/magma-components/{p-1faa4f71.entry.js → p-3dccd446.entry.js} +1 -1
  1198. package/dist/magma-components/{p-396d95a1.system.entry.js → p-3dde41b0.system.entry.js} +3 -3
  1199. package/dist/magma-components/{p-6f81c9ef.system.entry.js → p-3e8e0003.system.entry.js} +2 -2
  1200. package/dist/magma-components/{p-21547758.system.entry.js → p-3f0e6729.system.entry.js} +3 -3
  1201. package/dist/magma-components/{p-481897a7.entry.js → p-42ab27de.entry.js} +1 -1
  1202. package/dist/magma-components/{p-80eea067.system.entry.js → p-430a4c4b.system.entry.js} +2 -2
  1203. package/dist/magma-components/{p-d48c40ab.system.entry.js → p-47b05fa1.system.entry.js} +1 -1
  1204. package/dist/magma-components/{p-e5eb2390.entry.js → p-47db3155.entry.js} +1 -1
  1205. package/dist/magma-components/{p-2c845743.system.entry.js → p-48f86057.system.entry.js} +1 -1
  1206. package/dist/magma-components/{p-7961c335.system.entry.js → p-4a72d72c.system.entry.js} +1 -1
  1207. package/dist/magma-components/{p-2d3b5eb5.entry.js → p-4aa94380.entry.js} +1 -1
  1208. package/dist/magma-components/{p-ab00b7b9.entry.js → p-4ab2eb7e.entry.js} +1 -1
  1209. package/dist/magma-components/{p-c3c487aa.system.entry.js → p-4bea91e1.system.entry.js} +1 -1
  1210. package/dist/magma-components/{p-f588cf9e.entry.js → p-4cd21f19.entry.js} +1 -1
  1211. package/dist/magma-components/{p-287601bb.entry.js → p-4de89d1b.entry.js} +1 -1
  1212. package/dist/magma-components/{p-23fabd66.system.entry.js → p-50c8f36c.system.entry.js} +1 -1
  1213. package/dist/magma-components/{p-d0bfdb44.system.entry.js → p-5200ab23.system.entry.js} +2 -2
  1214. package/dist/magma-components/{p-f35608b2.entry.js → p-52211fa3.entry.js} +1 -1
  1215. package/dist/magma-components/{p-74f515c3.system.entry.js → p-53981624.system.entry.js} +2 -2
  1216. package/dist/magma-components/p-53acdc6b.entry.js +1 -0
  1217. package/dist/magma-components/p-5660182a.system.entry.js +1 -0
  1218. package/dist/magma-components/{p-464e6431.entry.js → p-56c5ca6f.entry.js} +1 -1
  1219. package/dist/magma-components/p-57e92942.system.entry.js +20 -0
  1220. package/dist/magma-components/{p-63b10a6e.entry.js → p-59aa4994.entry.js} +1 -1
  1221. package/dist/magma-components/{p-9a3ddc91.entry.js → p-59f06b9c.entry.js} +1 -1
  1222. package/dist/magma-components/{p-3d95e688.system.entry.js → p-5aa78075.system.entry.js} +3 -3
  1223. package/dist/magma-components/p-5cf87a7f.entry.js +1 -0
  1224. package/dist/magma-components/{p-5da14e81.entry.js → p-5e8df58d.entry.js} +1 -1
  1225. package/dist/magma-components/{p-880f3eac.system.entry.js → p-5ed74216.system.entry.js} +1 -1
  1226. package/dist/magma-components/{p-84777b38.system.entry.js → p-5f064376.system.entry.js} +2 -2
  1227. package/dist/magma-components/{p-8173ed07.entry.js → p-60727165.entry.js} +2 -2
  1228. package/dist/magma-components/{p-278c362d.entry.js → p-6093aa8e.entry.js} +1 -1
  1229. package/dist/magma-components/{p-29450db3.entry.js → p-62d9eaca.entry.js} +1 -1
  1230. package/dist/magma-components/{p-4c6da1db.system.entry.js → p-6b402a09.system.entry.js} +9 -9
  1231. package/dist/magma-components/p-6b55c5fe.system.entry.js +1 -0
  1232. package/dist/magma-components/{p-3d162e99.system.entry.js → p-6d57674c.system.entry.js} +2 -2
  1233. package/dist/magma-components/p-6d96d223.entry.js +1 -0
  1234. package/dist/magma-components/{p-47717251.system.entry.js → p-6df26141.system.entry.js} +4 -4
  1235. package/dist/magma-components/{p-5f8db04c.system.entry.js → p-6df7da52.system.entry.js} +1 -1
  1236. package/dist/magma-components/{p-9250ec26.system.entry.js → p-6e751bcc.system.entry.js} +2 -2
  1237. package/dist/magma-components/{p-656b00df.system.entry.js → p-718d6384.system.entry.js} +8 -8
  1238. package/dist/magma-components/{p-8279056b.system.entry.js → p-71dab494.system.entry.js} +3 -3
  1239. package/dist/magma-components/{p-b5789a7c.entry.js → p-732d09b6.entry.js} +1 -1
  1240. package/dist/magma-components/{p-fac6f123.entry.js → p-73f4f67e.entry.js} +1 -1
  1241. package/dist/magma-components/{p-772c18f4.entry.js → p-785fa112.entry.js} +1 -1
  1242. package/dist/magma-components/{p-26b9f2b7.system.entry.js → p-79fd07e7.system.entry.js} +2 -2
  1243. package/dist/magma-components/{p-0033cb92.system.entry.js → p-7acbc6ea.system.entry.js} +1 -1
  1244. package/dist/magma-components/{p-67eb3881.entry.js → p-7dd0364b.entry.js} +1 -1
  1245. package/dist/magma-components/{p-cbb80188.entry.js → p-7e7391fd.entry.js} +1 -1
  1246. package/dist/magma-components/{p-f889d413.system.entry.js → p-7ec28ff1.system.entry.js} +2 -2
  1247. package/dist/magma-components/{p-71cbc840.entry.js → p-7f74ec99.entry.js} +1 -1
  1248. package/dist/magma-components/{p-0679c988.system.entry.js → p-7ffce9e8.system.entry.js} +1 -1
  1249. package/dist/magma-components/{p-06ccc40d.entry.js → p-81212e34.entry.js} +1 -1
  1250. package/dist/magma-components/{p-cf6f54e5.system.entry.js → p-8219e58f.system.entry.js} +2 -2
  1251. package/dist/magma-components/{p-860bce85.system.entry.js → p-84711ab6.system.entry.js} +3 -3
  1252. package/dist/magma-components/p-84bf333b.entry.js +1 -0
  1253. package/dist/magma-components/{p-4792ff7f.entry.js → p-84d0d701.entry.js} +1 -1
  1254. package/dist/magma-components/{p-30be5c39.entry.js → p-857ae762.entry.js} +1 -1
  1255. package/dist/magma-components/{p-8f63f1a1.system.entry.js → p-87395a4d.system.entry.js} +1 -1
  1256. package/dist/magma-components/{p-2431fbfa.system.entry.js → p-87831da2.system.entry.js} +1 -1
  1257. package/dist/magma-components/{p-e39518b4.system.entry.js → p-896310aa.system.entry.js} +2 -2
  1258. package/dist/magma-components/{p-dc1a5826.system.entry.js → p-8ac1ba5c.system.entry.js} +1 -1
  1259. package/dist/magma-components/{p-86cf87fb.entry.js → p-8b8a6662.entry.js} +1 -1
  1260. package/dist/magma-components/{p-62fc9695.entry.js → p-8d7093af.entry.js} +1 -1
  1261. package/dist/magma-components/{p-8ab9ff37.system.entry.js → p-8e15c151.system.entry.js} +1 -1
  1262. package/dist/magma-components/{p-a9ba496d.entry.js → p-8f1c529f.entry.js} +1 -1
  1263. package/dist/magma-components/{p-94289f3d.system.entry.js → p-8f1e9021.system.entry.js} +5 -5
  1264. package/dist/magma-components/{p-69abd1d1.entry.js → p-904c1222.entry.js} +1 -1
  1265. package/dist/magma-components/{p-a70fb4fb.system.entry.js → p-907f06cd.system.entry.js} +9 -9
  1266. package/dist/magma-components/{p-000c315c.entry.js → p-9332358d.entry.js} +1 -1
  1267. package/dist/magma-components/{p-2eb4efcd.system.entry.js → p-93b9d39d.system.entry.js} +2 -2
  1268. package/dist/magma-components/{p-d8ae0f02.system.entry.js → p-965e7a82.system.entry.js} +1 -1
  1269. package/dist/magma-components/{p-c50e20cf.system.entry.js → p-96dfb60e.system.entry.js} +1 -1
  1270. package/dist/magma-components/{p-835d79e5.system.entry.js → p-99bfa07e.system.entry.js} +1 -1
  1271. package/dist/magma-components/{p-3beea731.system.entry.js → p-9c408768.system.entry.js} +1 -1
  1272. package/dist/magma-components/{p-1d2220f0.system.entry.js → p-9e792bed.system.entry.js} +1 -1
  1273. package/dist/magma-components/{p-8258733b.entry.js → p-9fdd477a.entry.js} +1 -1
  1274. package/dist/magma-components/{p-f82c2b7e.system.entry.js → p-9fefa077.system.entry.js} +1 -1
  1275. package/dist/magma-components/p-B8zYiZQY.system.js +2 -2
  1276. package/dist/magma-components/{p-OOCOFWC0.system.js → p-CuHZXISO.system.js} +7 -3
  1277. package/dist/magma-components/{p-DXAjcaHM.system.js → p-CxTugGM9.system.js} +1 -1
  1278. package/dist/magma-components/{p-U5iXN1wy.js → p-Dx_cCOTw.js} +1 -1
  1279. package/dist/magma-components/{p-Raj-urIN.js → p-OafT80hV.js} +1 -1
  1280. package/dist/magma-components/{p-458eb34c.system.entry.js → p-a0d637b6.system.entry.js} +2 -2
  1281. package/dist/magma-components/p-a26c05b6.entry.js +1 -0
  1282. package/dist/magma-components/{p-ccc40c6a.system.entry.js → p-a7baf451.system.entry.js} +2 -2
  1283. package/dist/magma-components/p-ac9feb04.entry.js +1 -0
  1284. package/dist/magma-components/p-ad383f92.entry.js +1 -0
  1285. package/dist/magma-components/{p-42e50f25.system.entry.js → p-ae4736a0.system.entry.js} +4 -4
  1286. package/dist/magma-components/{p-9fc385aa.entry.js → p-b3332c5f.entry.js} +1 -1
  1287. package/dist/magma-components/{p-d37fe692.system.entry.js → p-b3e2b68a.system.entry.js} +2 -2
  1288. package/dist/magma-components/{p-808b9277.entry.js → p-b86144d4.entry.js} +1 -1
  1289. package/dist/magma-components/{p-2cbd532a.system.entry.js → p-bbde5701.system.entry.js} +2 -2
  1290. package/dist/magma-components/{p-577ae081.system.entry.js → p-bc075b3b.system.entry.js} +2 -2
  1291. package/dist/magma-components/{p-068e30a5.entry.js → p-bc19b136.entry.js} +1 -1
  1292. package/dist/magma-components/{p-254ee71d.entry.js → p-bcca26d9.entry.js} +1 -1
  1293. package/dist/magma-components/{p-fc2d1134.entry.js → p-bf35627d.entry.js} +1 -1
  1294. package/dist/magma-components/p-bfd95736.entry.js +1 -0
  1295. package/dist/magma-components/{p-6a2d67d1.system.entry.js → p-c086a5a4.system.entry.js} +1 -1
  1296. package/dist/magma-components/{p-41a0f896.entry.js → p-c27206ca.entry.js} +1 -1
  1297. package/dist/magma-components/{p-762a6b7b.entry.js → p-c2758b81.entry.js} +1 -1
  1298. package/dist/magma-components/{p-a76a9f92.system.entry.js → p-c2c693ed.system.entry.js} +2 -2
  1299. package/dist/magma-components/{p-642925b7.system.entry.js → p-c4a5ab6e.system.entry.js} +1 -1
  1300. package/dist/magma-components/{p-b23bee0c.entry.js → p-c58157cf.entry.js} +1 -1
  1301. package/dist/magma-components/{p-8a9544aa.entry.js → p-c597ad47.entry.js} +1 -1
  1302. package/dist/magma-components/{p-295d8fab.entry.js → p-c7b2ebb5.entry.js} +1 -1
  1303. package/dist/magma-components/{p-ae3bf24c.system.entry.js → p-c8b06821.system.entry.js} +2 -2
  1304. package/dist/magma-components/p-ca1143bc.entry.js +1 -0
  1305. package/dist/magma-components/p-cb88fa71.entry.js +1 -0
  1306. package/dist/magma-components/{p-471227f2.system.entry.js → p-cd783f9e.system.entry.js} +2 -2
  1307. package/dist/magma-components/{p-bd97e368.system.entry.js → p-cd955bc7.system.entry.js} +1 -1
  1308. package/dist/magma-components/{p-1f623b75.entry.js → p-ce42e251.entry.js} +1 -1
  1309. package/dist/magma-components/{p-7bf46d43.entry.js → p-cf4f4561.entry.js} +1 -1
  1310. package/dist/magma-components/{p-0d32e196.system.entry.js → p-d0a15a3a.system.entry.js} +5 -4
  1311. package/dist/magma-components/{p-96bb36b9.entry.js → p-d218ae47.entry.js} +1 -1
  1312. package/dist/magma-components/{p-b738d3c1.entry.js → p-d331ff5c.entry.js} +1 -1
  1313. package/dist/magma-components/{p-34c2daa9.system.entry.js → p-d3844c9a.system.entry.js} +4 -4
  1314. package/dist/magma-components/{p-837d31b8.entry.js → p-d3ac9a1a.entry.js} +1 -1
  1315. package/dist/magma-components/{p-8740403e.system.entry.js → p-d4c3250f.system.entry.js} +2 -2
  1316. package/dist/magma-components/p-d638bbb0.entry.js +1 -0
  1317. package/dist/magma-components/{p-72ad419d.system.entry.js → p-d65e9f0a.system.entry.js} +1 -1
  1318. package/dist/magma-components/{p-358aa5e7.entry.js → p-d87ecd68.entry.js} +1 -1
  1319. package/dist/magma-components/{p-2e48f88d.system.entry.js → p-d93b48b4.system.entry.js} +1 -1
  1320. package/dist/magma-components/{p-9855b517.entry.js → p-d94281cb.entry.js} +1 -1
  1321. package/dist/magma-components/{p-55746791.entry.js → p-d9f92ff8.entry.js} +1 -1
  1322. package/dist/magma-components/{p-4cabfdbc.entry.js → p-da9bc02a.entry.js} +1 -1
  1323. package/dist/magma-components/{p-0148cf0a.entry.js → p-dc618cae.entry.js} +1 -1
  1324. package/dist/magma-components/p-de38f745.entry.js +1 -0
  1325. package/dist/magma-components/{p-0b3e4a97.system.entry.js → p-dee123c7.system.entry.js} +2 -2
  1326. package/dist/magma-components/p-df387755.entry.js +1 -0
  1327. package/dist/magma-components/p-dfab370b.entry.js +1 -0
  1328. package/dist/magma-components/{p-0e887379.system.entry.js → p-e30d0684.system.entry.js} +2 -2
  1329. package/dist/magma-components/{p-f66675f5.system.entry.js → p-e371f9e1.system.entry.js} +1 -1
  1330. package/dist/magma-components/{p-8f7daab1.system.entry.js → p-e3b9ea0b.system.entry.js} +1 -1
  1331. package/dist/magma-components/{p-104ba54e.system.entry.js → p-e3d262d9.system.entry.js} +2 -2
  1332. package/dist/magma-components/{p-7fde3025.system.entry.js → p-e54587e7.system.entry.js} +3 -3
  1333. package/dist/magma-components/{p-2cdf450c.system.entry.js → p-e5f893f9.system.entry.js} +2 -2
  1334. package/dist/magma-components/{p-d0a93a14.system.entry.js → p-e709a52e.system.entry.js} +6 -3
  1335. package/dist/magma-components/{p-8680f63e.entry.js → p-e8452cce.entry.js} +1 -1
  1336. package/dist/magma-components/{p-09f621ea.entry.js → p-ea503851.entry.js} +1 -1
  1337. package/dist/magma-components/{p-3dc81ab9.system.entry.js → p-ec44a4ea.system.entry.js} +4 -4
  1338. package/dist/magma-components/{p-8645533a.entry.js → p-ed133270.entry.js} +1 -1
  1339. package/dist/magma-components/{p-77939a25.system.entry.js → p-ee780f82.system.entry.js} +2 -2
  1340. package/dist/magma-components/p-ef4ee9ca.entry.js +1 -0
  1341. package/dist/magma-components/{p-15ffdcf6.entry.js → p-f045b018.entry.js} +1 -1
  1342. package/dist/magma-components/{p-87ce9d6c.entry.js → p-f2211b1f.entry.js} +1 -1
  1343. package/dist/magma-components/{p-2aac4003.entry.js → p-f267ff68.entry.js} +1 -1
  1344. package/dist/magma-components/{p-41a28f2a.system.entry.js → p-f27de6cb.system.entry.js} +3 -3
  1345. package/dist/magma-components/{p-1908f808.entry.js → p-f2ef884c.entry.js} +1 -1
  1346. package/dist/magma-components/{p-9f8ce68f.entry.js → p-f3f88f32.entry.js} +1 -1
  1347. package/dist/magma-components/{p-1eee93c8.system.entry.js → p-f40e3918.system.entry.js} +2 -2
  1348. package/dist/magma-components/{p-6e32bf99.entry.js → p-f4181b35.entry.js} +1 -1
  1349. package/dist/magma-components/{p-8a76097f.entry.js → p-f4351160.entry.js} +1 -1
  1350. package/dist/magma-components/{p-c3a3caae.system.entry.js → p-f4fc9f29.system.entry.js} +1 -1
  1351. package/dist/magma-components/{p-f2f992c2.system.entry.js → p-f5c7b147.system.entry.js} +2 -2
  1352. package/dist/magma-components/{p-84ed22ea.system.entry.js → p-f7d5445c.system.entry.js} +1 -1
  1353. package/dist/magma-components/{p-08370fc2.system.entry.js → p-f7e9af99.system.entry.js} +1 -1
  1354. package/dist/magma-components/{p-95478664.system.entry.js → p-f8c85ad7.system.entry.js} +1 -1
  1355. package/dist/magma-components/{p-c6819aad.entry.js → p-f9b601de.entry.js} +1 -1
  1356. package/dist/magma-components/{p-357724ab.entry.js → p-fa44d0d2.entry.js} +1 -1
  1357. package/dist/magma-components/{p-d3d74616.entry.js → p-fba648e0.entry.js} +1 -1
  1358. package/dist/magma-components/p-fe8e3721.system.entry.js +225 -0
  1359. package/dist/magma-components/{p-8d6470fb.system.entry.js → p-fe98a77e.system.entry.js} +2 -2
  1360. package/dist/magma-components/{p-d980c3d2.system.entry.js → p-ff7fc1f6.system.entry.js} +2 -2
  1361. package/dist/stats.json +3498 -1516
  1362. package/dist/types/common/locale.d.ts +5 -0
  1363. package/dist/types/components/mds-accordion/mds-accordion.d.ts +1 -0
  1364. package/dist/types/components/mds-accordion-item/mds-accordion-item.d.ts +1 -0
  1365. package/dist/types/components/mds-accordion-timer/mds-accordion-timer.d.ts +1 -0
  1366. package/dist/types/components/mds-accordion-timer-item/mds-accordion-timer-item.d.ts +1 -0
  1367. package/dist/types/components/mds-author/mds-author.d.ts +1 -0
  1368. package/dist/types/components/mds-avatar/mds-avatar.d.ts +1 -0
  1369. package/dist/types/components/mds-avatar-stack/mds-avatar-stack.d.ts +1 -0
  1370. package/dist/types/components/mds-avatar-stack-item/mds-avatar-stack-item.d.ts +3 -0
  1371. package/dist/types/components/mds-badge/mds-badge.d.ts +1 -0
  1372. package/dist/types/components/mds-banner/mds-banner.d.ts +1 -0
  1373. package/dist/types/components/mds-benchmark-bar/mds-benchmark-bar.d.ts +1 -0
  1374. package/dist/types/components/mds-bibliography/mds-bibliography.d.ts +3 -0
  1375. package/dist/types/components/mds-book/mds-book.d.ts +114 -0
  1376. package/dist/types/components/mds-book/meta/dictionary.d.ts +4 -0
  1377. package/dist/types/components/mds-book/meta/format.d.ts +30 -0
  1378. package/dist/types/components/mds-book/meta/pose.d.ts +64 -0
  1379. package/dist/types/components/mds-book/meta/spine.d.ts +33 -0
  1380. package/dist/types/components/mds-book/meta/types.d.ts +3 -0
  1381. package/dist/types/components/mds-book/meta/volume.d.ts +22 -0
  1382. package/dist/types/components/mds-breadcrumb/mds-breadcrumb.d.ts +1 -0
  1383. package/dist/types/components/mds-breadcrumb-item/mds-breadcrumb-item.d.ts +1 -0
  1384. package/dist/types/components/mds-button/mds-button.d.ts +1 -0
  1385. package/dist/types/components/mds-button-dropdown/mds-button-dropdown.d.ts +1 -0
  1386. package/dist/types/components/mds-button-group/mds-button-group.d.ts +1 -0
  1387. package/dist/types/components/mds-calendar/mds-calendar.d.ts +1 -0
  1388. package/dist/types/components/mds-calendar-cell/mds-calendar-cell.d.ts +3 -0
  1389. package/dist/types/components/mds-card/mds-card.d.ts +1 -0
  1390. package/dist/types/components/mds-card-content/mds-card-content.d.ts +1 -0
  1391. package/dist/types/components/mds-card-footer/mds-card-footer.d.ts +1 -0
  1392. package/dist/types/components/mds-card-header/mds-card-header.d.ts +1 -0
  1393. package/dist/types/components/mds-card-media/mds-card-media.d.ts +1 -0
  1394. package/dist/types/components/mds-chip/mds-chip.d.ts +3 -0
  1395. package/dist/types/components/mds-details/mds-details.d.ts +1 -0
  1396. package/dist/types/components/mds-dropdown/mds-dropdown.d.ts +1 -0
  1397. package/dist/types/components/mds-emoji/mds-emoji.d.ts +3 -0
  1398. package/dist/types/components/mds-entity/mds-entity.d.ts +1 -0
  1399. package/dist/types/components/mds-file/mds-file.d.ts +3 -0
  1400. package/dist/types/components/mds-file-preview/mds-file-preview.d.ts +1 -0
  1401. package/dist/types/components/mds-filter/mds-filter.d.ts +1 -0
  1402. package/dist/types/components/mds-filter-item/mds-filter-item.d.ts +3 -0
  1403. package/dist/types/components/mds-header/mds-header.d.ts +1 -0
  1404. package/dist/types/components/mds-header-bar/mds-header-bar.d.ts +1 -0
  1405. package/dist/types/components/mds-help/mds-help.d.ts +1 -0
  1406. package/dist/types/components/mds-horizontal-scroll/mds-horizontal-scroll.d.ts +1 -0
  1407. package/dist/types/components/mds-hr/mds-hr.d.ts +3 -0
  1408. package/dist/types/components/mds-icon/mds-icon.d.ts +1 -0
  1409. package/dist/types/components/mds-img/mds-img.d.ts +1 -0
  1410. package/dist/types/components/mds-input/mds-input.d.ts +1 -0
  1411. package/dist/types/components/mds-input/meta/validators.d.ts +7 -2
  1412. package/dist/types/components/mds-input/meta/validity.d.ts +3 -2
  1413. package/dist/types/components/mds-input-date/mds-input-date.d.ts +1 -0
  1414. package/dist/types/components/mds-input-date-range/mds-input-date-range.d.ts +1 -0
  1415. package/dist/types/components/mds-input-date-range-preselection/mds-input-date-range-preselection.d.ts +1 -0
  1416. package/dist/types/components/mds-input-field/mds-input-field.d.ts +1 -0
  1417. package/dist/types/components/mds-input-otp/mds-input-otp.d.ts +3 -0
  1418. package/dist/types/components/mds-input-range/mds-input-range.d.ts +1 -0
  1419. package/dist/types/components/mds-input-select/mds-input-select.d.ts +3 -1
  1420. package/dist/types/components/mds-input-switch/mds-input-switch.d.ts +1 -0
  1421. package/dist/types/components/mds-input-tip/mds-input-tip.d.ts +1 -0
  1422. package/dist/types/components/mds-input-tip-item/mds-input-tip-item.d.ts +1 -0
  1423. package/dist/types/components/mds-input-upload/mds-input-upload.d.ts +3 -0
  1424. package/dist/types/components/mds-keyboard/mds-keyboard.d.ts +1 -0
  1425. package/dist/types/components/mds-keyboard-key/mds-keyboard-key.d.ts +3 -0
  1426. package/dist/types/components/mds-kpi/mds-kpi.d.ts +1 -0
  1427. package/dist/types/components/mds-kpi-item/mds-kpi-item.d.ts +1 -0
  1428. package/dist/types/components/mds-label/mds-label.d.ts +3 -0
  1429. package/dist/types/components/mds-link/mds-link.d.ts +1 -0
  1430. package/dist/types/components/mds-list/mds-list.d.ts +1 -0
  1431. package/dist/types/components/mds-list-item/mds-list-item.d.ts +1 -0
  1432. package/dist/types/components/mds-mention/mds-mention.d.ts +3 -0
  1433. package/dist/types/components/mds-modal/mds-modal.d.ts +1 -0
  1434. package/dist/types/components/mds-note/mds-note.d.ts +1 -0
  1435. package/dist/types/components/mds-notification/mds-notification.d.ts +3 -0
  1436. package/dist/types/components/mds-paginator/mds-paginator.d.ts +3 -0
  1437. package/dist/types/components/mds-paginator-item/mds-paginator-item.d.ts +1 -0
  1438. package/dist/types/components/mds-policy-ai/mds-policy-ai.d.ts +1 -0
  1439. package/dist/types/components/mds-pref/mds-pref.d.ts +1 -1
  1440. package/dist/types/components/mds-pref-animation/mds-pref-animation.d.ts +3 -0
  1441. package/dist/types/components/mds-pref-consumption/mds-pref-consumption.d.ts +3 -0
  1442. package/dist/types/components/mds-pref-contrast/mds-pref-contrast.d.ts +3 -0
  1443. package/dist/types/components/mds-pref-language/mds-pref-language.d.ts +1 -0
  1444. package/dist/types/components/mds-pref-language-item/mds-pref-language-item.d.ts +3 -0
  1445. package/dist/types/components/mds-pref-mode/mds-pref-mode.d.ts +3 -0
  1446. package/dist/types/components/mds-pref-theme/mds-pref-theme.d.ts +1 -0
  1447. package/dist/types/components/mds-pref-theme-item/mds-pref-theme-item.d.ts +3 -0
  1448. package/dist/types/components/mds-price-table/mds-price-table.d.ts +1 -0
  1449. package/dist/types/components/mds-price-table-features/mds-price-table-features.d.ts +1 -0
  1450. package/dist/types/components/mds-price-table-features-cell/mds-price-table-features-cell.d.ts +1 -0
  1451. package/dist/types/components/mds-price-table-features-row/mds-price-table-features-row.d.ts +1 -0
  1452. package/dist/types/components/mds-price-table-header/mds-price-table-header.d.ts +1 -0
  1453. package/dist/types/components/mds-price-table-list/mds-price-table-list.d.ts +1 -0
  1454. package/dist/types/components/mds-price-table-list-item/mds-price-table-list-item.d.ts +1 -0
  1455. package/dist/types/components/mds-progress/mds-progress.d.ts +1 -0
  1456. package/dist/types/components/mds-push-notification/mds-push-notification.d.ts +1 -0
  1457. package/dist/types/components/mds-push-notification-item/mds-push-notification-item.d.ts +1 -0
  1458. package/dist/types/components/mds-quote/mds-quote.d.ts +1 -0
  1459. package/dist/types/components/mds-radial-menu/mds-radial-menu.d.ts +1 -0
  1460. package/dist/types/components/mds-radial-menu-item/mds-radial-menu-item.d.ts +3 -0
  1461. package/dist/types/components/mds-radial-progress/mds-radial-progress.d.ts +1 -0
  1462. package/dist/types/components/mds-separator/mds-separator.d.ts +3 -0
  1463. package/dist/types/components/mds-spinner/mds-spinner.d.ts +3 -0
  1464. package/dist/types/components/mds-status-bar/mds-status-bar.d.ts +1 -0
  1465. package/dist/types/components/mds-stepper-bar/mds-stepper-bar.d.ts +1 -0
  1466. package/dist/types/components/mds-stepper-bar-item/mds-stepper-bar-item.d.ts +1 -0
  1467. package/dist/types/components/mds-tab/mds-tab.d.ts +1 -0
  1468. package/dist/types/components/mds-tab-bar/mds-tab-bar.d.ts +1 -0
  1469. package/dist/types/components/mds-tab-bar-item/mds-tab-bar-item.d.ts +1 -0
  1470. package/dist/types/components/mds-tab-item/mds-tab-item.d.ts +1 -0
  1471. package/dist/types/components/mds-table/mds-table.d.ts +1 -0
  1472. package/dist/types/components/mds-table-body/mds-table-body.d.ts +1 -0
  1473. package/dist/types/components/mds-table-cell/mds-table-cell.d.ts +1 -0
  1474. package/dist/types/components/mds-table-footer/mds-table-footer.d.ts +1 -0
  1475. package/dist/types/components/mds-table-header/mds-table-header.d.ts +1 -0
  1476. package/dist/types/components/mds-table-header-cell/mds-table-header-cell.d.ts +1 -0
  1477. package/dist/types/components/mds-table-row/mds-table-row.d.ts +1 -0
  1478. package/dist/types/components/mds-text/mds-text.d.ts +1 -0
  1479. package/dist/types/components/mds-toast/mds-toast.d.ts +1 -0
  1480. package/dist/types/components/mds-toast-region/mds-toast-region.d.ts +1 -0
  1481. package/dist/types/components/mds-tooltip/mds-tooltip.d.ts +1 -0
  1482. package/dist/types/components/mds-tree/mds-tree.d.ts +1 -0
  1483. package/dist/types/components/mds-tree-item/mds-tree-item.d.ts +1 -0
  1484. package/dist/types/components/mds-url-view/mds-url-view.d.ts +3 -0
  1485. package/dist/types/components/mds-usage/mds-usage.d.ts +1 -0
  1486. package/dist/types/components/mds-video-wall/mds-video-wall.d.ts +1 -0
  1487. package/dist/types/components/mds-zero/mds-zero.d.ts +1 -0
  1488. package/dist/types/components.d.ts +1517 -6
  1489. package/package.json +42 -5
  1490. package/dist/components/p-B0AnE3sA.js +0 -1
  1491. package/dist/components/p-BbTcXgbr.js +0 -1
  1492. package/dist/components/p-CHHEp_7y.js +0 -1
  1493. package/dist/components/p-D8wd-EZX.js +0 -1
  1494. package/dist/magma-components/p-083dceb8.system.entry.js +0 -1
  1495. package/dist/magma-components/p-0eb3558a.entry.js +0 -1
  1496. package/dist/magma-components/p-2a964578.entry.js +0 -1
  1497. package/dist/magma-components/p-335244bb.entry.js +0 -1
  1498. package/dist/magma-components/p-3fb46ab9.system.entry.js +0 -1
  1499. package/dist/magma-components/p-4d485e1f.system.entry.js +0 -1
  1500. package/dist/magma-components/p-57839384.system.entry.js +0 -17
  1501. package/dist/magma-components/p-632ad925.system.entry.js +0 -222
  1502. package/dist/magma-components/p-6436178a.entry.js +0 -1
  1503. package/dist/magma-components/p-644e64a0.entry.js +0 -1
  1504. package/dist/magma-components/p-791a6a6f.entry.js +0 -1
  1505. package/dist/magma-components/p-7ec1ea2e.entry.js +0 -1
  1506. package/dist/magma-components/p-89d4b6e9.entry.js +0 -1
  1507. package/dist/magma-components/p-984dd850.entry.js +0 -1
  1508. package/dist/magma-components/p-a7c01334.entry.js +0 -1
  1509. package/dist/magma-components/p-a8e1ce2f.entry.js +0 -1
  1510. package/dist/magma-components/p-ab4b617d.entry.js +0 -1
  1511. package/dist/magma-components/p-d6b38d8a.entry.js +0 -1
  1512. package/dist/magma-components/p-da24a265.entry.js +0 -1
  1513. package/dist/magma-components/p-e1383302.entry.js +0 -1
  1514. package/dist/magma-components/p-f1aafe07.entry.js +0 -1
  1515. package/dist/magma-components/p-f78c1699.entry.js +0 -1
@@ -1,5 +1,5 @@
1
1
  {
2
- "timestamp": "2026-10-21T16:53:07",
2
+ "timestamp": "2026-10-24T12:14:05",
3
3
  "compiler": {
4
4
  "name": "@stencil/core",
5
5
  "version": "4.45.2",
@@ -31,12 +31,16 @@
31
31
  {
32
32
  "name": "slot",
33
33
  "text": "- Add `mds-tab-item` element/s."
34
+ },
35
+ {
36
+ "name": "category",
37
+ "text": "navigation"
34
38
  }
35
39
  ],
36
40
  "usage": {
37
41
  "1. Description": "The `<mds-tab>` web component is the compound container that orchestrates a tabbed navigation in the Magma Design System. It is the parent wrapper around a set of `<mds-tab-item>` triggers and, when the component shows the content itself, their content panels, providing the ARIA `tablist` structure, selection state, scrolling and the animated selection indicator.\n\n#### Semantic Behavior\n\n- **Compound parent**: Expects `<mds-tab-item>` elements in the default slot; each panel in the named `content` slot is wired up automatically and paired by document order; a panel past the last item has no tab to open it, so it stays hidden and the component logs a console warning. The panels are optional: without them the component shows the strip alone, and the page shows the content, driven by `mdsTabChange` or by navigation.\n- **Navigation strip**: When every item has `href`, the items are links (announced as such, the selected one as current) and the strip is no longer a `tablist`: the browser follows the links, in a new tab on a modifier or middle click, and the strip keeps the selected item highlighted. A client-side router cancels the click on the item with `preventDefault()` and routes; a modifier click leaves the selection alone.\n- **Selection ownership**: The active tab is whichever `<mds-tab-item>` carries `selected`; the parent flips `selected` across siblings, shows the corresponding content panel and hides the rest.\n- **Change event**: Emits `mdsTabChange` with the selected item's index (`id`) and `value` whenever the active child changes.\n- **Focus restoration**: After a keyboard activation it re-focuses the selected item's button, so the user does not have to re-locate the tab.\n- **Auto-scroll into view**: On selection or child focus, the active tab is scrolled to the center of its strip.\n- **Overflow tracking**: When `overflow` is enabled, left/right inset shadows appear while the tabs overflow their container.\n- **Size propagation**: The parent `size` is pushed down onto every nested `<mds-tab-item>`, so children should not be sized individually.\n\n#### Properties & Visual Configurations\n\n- **`direction`** chooses whether the tab strip is laid out `'horizontal'` (default) or `'vertical'`.\n- **`animation`** governs the transition between active items: `'slide'` (default) renders the moving slider indicator, while `'fade'` cross-fades without the slider. The slider slides only when the selection changes: on load, and when the strip is shown again after being hidden, it is already under the selected tab.\n- **`fill`** makes the tab strip stretch to occupy the full available width rather than hugging its content.\n- **`overflow`** enables the inset-shadow affordance that signals more tabs exist beyond the visible edges; **`scrollbar`** instead exposes the native horizontal scrollbar for accessibility.\n\n#### Other behavioral props\n\n- **`size`** sets the scale (`'sm'` / `'md'`) for the whole group and is forwarded to the child items; it is the only way to size the tabs consistently.\n",
38
- "2. Pattern": "Correct and idiomatic ways to use the `<mds-tab>` 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 Tab Group with Managed Panels\n\nThe canonical form. Put `<mds-tab-item>` elements in the default slot and one content element per tab in the named `content` slot. Mark the initially-visible tab with `selected`. Panels are wired up by document order - the first `[slot=content]` element is paired with the first `<mds-tab-item>`.\n\n```html\n<mds-tab>\n <mds-tab-item label=\"Panoramica\" selected></mds-tab-item>\n <mds-tab-item label=\"Dettagli\"></mds-tab-item>\n <mds-tab-item label=\"Allegati\"></mds-tab-item>\n\n <div slot=\"content\">\n <mds-text>Contenuto della scheda Panoramica.</mds-text>\n </div>\n <div slot=\"content\">\n <mds-text>Contenuto della scheda Dettagli.</mds-text>\n </div>\n <div slot=\"content\">\n <mds-text>Contenuto della scheda Allegati.</mds-text>\n </div>\n</mds-tab>\n```\n\n#### Listening to Tab Changes\n\nListen to the `mdsTabChange` event to react when the active panel changes. The event detail carries the zero-based `id` (index) and the optional `value` of the newly selected `<mds-tab-item>`.\n\n```html\n<mds-tab id=\"schede-pratica\">\n <mds-tab-item label=\"Anagrafica\" value=\"anagrafica\" selected></mds-tab-item>\n <mds-tab-item label=\"Documenti\" value=\"documenti\"></mds-tab-item>\n <mds-tab-item label=\"Pagamenti\" value=\"pagamenti\"></mds-tab-item>\n</mds-tab>\n\n<script>\n document.querySelector('#schede-pratica').addEventListener('mdsTabChange', (e) => {\n console.log('scheda attiva:', e.detail.id, e.detail.value);\n });\n</script>\n```\n\n#### Tab Items with Icons\n\nPass an icon slug to `<mds-tab-item>` via the `icon` prop. Icon position defaults to `left`; use `icon-position=\"right\"` for forward-navigation tabs.\n\n```html\n<mds-tab>\n <mds-tab-item label=\"Utente\" icon=\"mi/baseline/person\" selected></mds-tab-item>\n <mds-tab-item label=\"Impostazioni\" icon=\"mi/baseline/settings\"></mds-tab-item>\n <mds-tab-item label=\"Notifiche\" icon=\"mi/baseline/notifications\"></mds-tab-item>\n\n <div slot=\"content\"><mds-text>Profilo utente.</mds-text></div>\n <div slot=\"content\"><mds-text>Impostazioni account.</mds-text></div>\n <div slot=\"content\"><mds-text>Cronologia notifiche.</mds-text></div>\n</mds-tab>\n```\n\n#### Fill the Available Width\n\nSet `fill` when the tab strip should stretch to occupy the full container width instead of hugging its content.\n\n```html\n<mds-tab fill>\n <mds-tab-item label=\"Riepilogo\" selected></mds-tab-item>\n <mds-tab-item label=\"Cronologia\"></mds-tab-item>\n <mds-tab-item label=\"Statistiche\"></mds-tab-item>\n\n <div slot=\"content\"><mds-text>Riepilogo pratica.</mds-text></div>\n <div slot=\"content\"><mds-text>Registro modifiche.</mds-text></div>\n <div slot=\"content\"><mds-text>Dati statistici.</mds-text></div>\n</mds-tab>\n```\n\n#### Vertical Direction\n\nUse `direction=\"vertical\"` to stack the tab strip on the side. Pair it with `--mds-tab-direction-vertical-columns` to control the column widths of the sidebar and the content area.\n\n```html\n<mds-tab direction=\"vertical\">\n <mds-tab-item label=\"Dati generali\" selected></mds-tab-item>\n <mds-tab-item label=\"Indirizzi\"></mds-tab-item>\n <mds-tab-item label=\"Contatti\"></mds-tab-item>\n\n <div slot=\"content\"><mds-text>Dati generali.</mds-text></div>\n <div slot=\"content\"><mds-text>Indirizzi registrati.</mds-text></div>\n <div slot=\"content\"><mds-text>Recapiti di contatto.</mds-text></div>\n</mds-tab>\n```\n\n#### Fade Animation\n\nSwitch to `animation=\"fade\"` to highlight the selected tab in place instead of moving the slider indicator. The panels switch without animation in both modes.\n\n```html\n<mds-tab animation=\"fade\">\n <mds-tab-item label=\"Prima\" selected></mds-tab-item>\n <mds-tab-item label=\"Seconda\"></mds-tab-item>\n\n <div slot=\"content\"><mds-text>Pannello 1.</mds-text></div>\n <div slot=\"content\"><mds-text>Pannello 2.</mds-text></div>\n</mds-tab>\n```\n\n#### Overflow Shadow for Many Tabs\n\nEnable `overflow` when the tab strip can contain more items than the viewport permits. Left and right inset shadows appear whenever tabs overflow their container, signalling that scrolling is possible.\n\n```html\n<mds-tab overflow>\n <mds-tab-item label=\"Gennaio\" selected></mds-tab-item>\n <mds-tab-item label=\"Febbraio\"></mds-tab-item>\n <mds-tab-item label=\"Marzo\"></mds-tab-item>\n <mds-tab-item label=\"Aprile\"></mds-tab-item>\n <mds-tab-item label=\"Maggio\"></mds-tab-item>\n <mds-tab-item label=\"Giugno\"></mds-tab-item>\n <mds-tab-item label=\"Luglio\"></mds-tab-item>\n <mds-tab-item label=\"Agosto\"></mds-tab-item>\n <mds-tab-item label=\"Settembre\"></mds-tab-item>\n <mds-tab-item label=\"Ottobre\"></mds-tab-item>\n <mds-tab-item label=\"Novembre\"></mds-tab-item>\n <mds-tab-item label=\"Dicembre\"></mds-tab-item>\n</mds-tab>\n```\n\n#### Scrollbar for Accessible Overflow\n\nUse `scrollbar` instead of (or alongside) `overflow` to expose the native horizontal scrollbar. This is the accessible complement for users who navigate via keyboard or who have motor difficulties.\n\n```html\n<mds-tab scrollbar overflow>\n <mds-tab-item label=\"Sezione A\" selected></mds-tab-item>\n <mds-tab-item label=\"Sezione B\"></mds-tab-item>\n <mds-tab-item label=\"Sezione C\"></mds-tab-item>\n <mds-tab-item label=\"Sezione D\"></mds-tab-item>\n <mds-tab-item label=\"Sezione E\"></mds-tab-item>\n</mds-tab>\n```\n\n#### Sizing\n\nSet `size` on the parent to scale all tabs uniformly. Do not set `size` on individual `<mds-tab-item>` elements - the parent propagates the value automatically.\n\n```html\n<!-- Compact strip, e.g. inside a sidebar or dense toolbar -->\n<mds-tab size=\"sm\">\n <mds-tab-item label=\"Vista elenco\" selected></mds-tab-item>\n <mds-tab-item label=\"Vista griglia\"></mds-tab-item>\n</mds-tab>\n```\n\n#### Navigation Links (href on Tab Items)\n\nWhen each tab leads to an anchor, another page or a route, set `href` on every `<mds-tab-item>` and omit the `content` slot: the items render as links, the browser follows them (in a new tab on a modifier or middle click) and the strip keeps the selected item highlighted. The page content is driven by navigation, not by the managed-panels mechanism.\n\n```html\n<mds-tab>\n <mds-tab-item href=\"#sezione-1\" label=\"Introduzione\" selected></mds-tab-item>\n <mds-tab-item href=\"#sezione-2\" label=\"Requisiti\"></mds-tab-item>\n <mds-tab-item href=\"#sezione-3\" label=\"Conclusioni\"></mds-tab-item>\n</mds-tab>\n```\n\n#### Client-Side Routing (href on Tab Items)\n\nIn a single-page app keep `href` on the items and register the router once with `NavigationService`, from `@maggioli-design-system/magma/services`: a plain click on an item is routed on the client and the selection still moves, with no listener per item. A modifier or middle click stays with the browser, which opens the link in a new tab while the strip stays as it is.\n\n```html\n<mds-tab id=\"sezioni\">\n <mds-tab-item href=\"/pratiche\" label=\"Pratiche\" selected></mds-tab-item>\n <mds-tab-item href=\"/documenti\" label=\"Documenti\"></mds-tab-item>\n <mds-tab-item href=\"/pagamenti\" label=\"Pagamenti\"></mds-tab-item>\n</mds-tab>\n\n<script type=\"module\">\n import { NavigationService } from '@maggioli-design-system/magma/services';\n\n NavigationService.setHandler((href) => router.navigate(href));\n</script>\n```\n\nWithout a registered router, cancel the click on the items and route by hand: the component honours `preventDefault()` and still moves the selection. Leave a modifier click alone.\n\n```html\n<script>\n document.querySelectorAll('#sezioni mds-tab-item').forEach((item) => {\n item.addEventListener('click', (event) => {\n if (event.ctrlKey || event.metaKey || event.shiftKey || event.altKey) return;\n event.preventDefault();\n router.navigate(item.href);\n });\n });\n</script>\n```\n\n#### Disabled Tab Item\n\nMark an individual tab as unavailable with `disabled`. The parent's selection mechanism skips it; the tab is removed from the tab order automatically.\n\n```html\n<mds-tab>\n <mds-tab-item label=\"Attivo\" selected></mds-tab-item>\n <mds-tab-item label=\"Non disponibile\" disabled></mds-tab-item>\n <mds-tab-item label=\"Altro\"></mds-tab-item>\n\n <div slot=\"content\"><mds-text>Contenuto disponibile.</mds-text></div>\n <div slot=\"content\"><mds-text>Contenuto non disponibile.</mds-text></div>\n <div slot=\"content\"><mds-text>Altro contenuto.</mds-text></div>\n</mds-tab>\n```\n\n#### Styling Customization\n\nStyle the component only through its documented `--mds-tab-*` CSS custom properties. Set them on the host or a parent selector; use semantic color roles via `rgb(var(--magma-<role>))` so dark mode and high-contrast modes keep working.\n\n```css\n.scheda-primaria mds-tab {\n --mds-tab-tabs-background: rgb(var(--magma-accent-surface));\n --mds-tab-tabs-radius: var(--magma-radius-xl);\n --mds-tab-item-selected-background: rgb(var(--magma-accent-emphasis));\n --mds-tab-item-selected-color: rgb(var(--magma-accent-on-emphasis));\n --mds-tab-transition-duration: 0.3s;\n}\n```\n\nWith `animation=\"fade\"` every item paints its own states: `--mds-tab-item-default-shadow` gives a shadow to the items that are not selected, and `--mds-tab-item-hover-shadow` to the hovered one (the default shadow when it is not set). With the slider (`animation=\"slide\"`) the items stay transparent over it, so the backgrounds and shadows set on the tab for the items do not apply.\n\n```css\n.schede-a-schedario mds-tab {\n --mds-tab-item-default-shadow: var(--shadow-xs);\n --mds-tab-item-hover-shadow: var(--shadow-sm);\n}\n```\n",
39
- "3. Antipattern": "Common incorrect uses of `<mds-tab>`. 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 Size Individual Tab Items\n\nSetting `size` on a `<mds-tab-item>` directly is overridden by the parent at render time. Use the `size` prop on `<mds-tab>` to size all tabs uniformly.\n\n```html\n<!-- INCORRECT -->\n<mds-tab>\n <mds-tab-item label=\"Elenco\" size=\"sm\" selected></mds-tab-item>\n <mds-tab-item label=\"Griglia\" size=\"sm\"></mds-tab-item>\n</mds-tab>\n\n<!-- CORRECT -->\n<mds-tab size=\"sm\">\n <mds-tab-item label=\"Elenco\" selected></mds-tab-item>\n <mds-tab-item label=\"Griglia\"></mds-tab-item>\n</mds-tab>\n```\n\n#### Do Not Mix Tab Items and Content Panels Out of Order\n\nPanels in `slot=\"content\"` are wired to `<mds-tab-item>` elements by document order. A missing panel leaves its tab with no content, a wrong ordering shows the wrong panel when a tab is selected.\n\n```html\n<!-- INCORRECT: only two content panels for three tab items -->\n<mds-tab>\n <mds-tab-item label=\"A\" selected></mds-tab-item>\n <mds-tab-item label=\"B\"></mds-tab-item>\n <mds-tab-item label=\"C\"></mds-tab-item>\n\n <div slot=\"content\"><mds-text>Pannello A.</mds-text></div>\n <div slot=\"content\"><mds-text>Pannello B.</mds-text></div>\n</mds-tab>\n\n<!-- CORRECT: one content panel per tab item, same order -->\n<mds-tab>\n <mds-tab-item label=\"A\" selected></mds-tab-item>\n <mds-tab-item label=\"B\"></mds-tab-item>\n <mds-tab-item label=\"C\"></mds-tab-item>\n\n <div slot=\"content\"><mds-text>Pannello A.</mds-text></div>\n <div slot=\"content\"><mds-text>Pannello B.</mds-text></div>\n <div slot=\"content\"><mds-text>Pannello C.</mds-text></div>\n</mds-tab>\n```\n\n#### Do Not Mix Link Items and Panel Tabs in One Strip\n\nA strip is either a `tablist` of tabs, each controlling a panel, or a navigation of links (`href` on every item): a link inside a tablist is not a child the role allows, and assistive technology announces the strip wrong. Keep the link out of the strip, as an `<mds-button>` next to it.\n\n```html\n<!-- INCORRECT -->\n<mds-tab>\n <mds-tab-item label=\"Dettagli\" selected></mds-tab-item>\n <mds-tab-item label=\"Allegati\"></mds-tab-item>\n <mds-tab-item label=\"Portale\" href=\"https://portale.example.com\"></mds-tab-item>\n\n <div slot=\"content\"><mds-text>Dettagli.</mds-text></div>\n <div slot=\"content\"><mds-text>Allegati.</mds-text></div>\n <div slot=\"content\"></div>\n</mds-tab>\n\n<!-- CORRECT -->\n<mds-tab>\n <mds-tab-item label=\"Dettagli\" selected></mds-tab-item>\n <mds-tab-item label=\"Allegati\"></mds-tab-item>\n\n <div slot=\"content\"><mds-text>Dettagli.</mds-text></div>\n <div slot=\"content\"><mds-text>Allegati.</mds-text></div>\n</mds-tab>\n<mds-button label=\"Portale\" href=\"https://portale.example.com\" target=\"blank\" tone=\"text\"></mds-button>\n```\n\n#### Do Not Put Tab Items Outside `<mds-tab>`\n\n`<mds-tab-item>` communicates with its parent through internal Stencil events. Used outside `<mds-tab>` it renders as an inert button with no selection, panel, or keyboard management.\n\n```html\n<!-- INCORRECT -->\n<div class=\"my-tab-wrapper\">\n <mds-tab-item label=\"Scheda uno\" selected></mds-tab-item>\n <mds-tab-item label=\"Scheda due\"></mds-tab-item>\n</div>\n<div>...</div>\n\n<!-- CORRECT -->\n<mds-tab>\n <mds-tab-item label=\"Scheda uno\" selected></mds-tab-item>\n <mds-tab-item label=\"Scheda due\"></mds-tab-item>\n <div slot=\"content\">...</div>\n <div slot=\"content\">...</div>\n</mds-tab>\n```\n\n#### Do Not Listen to the `mdsTabItemSelect` Event from Outside\n\n`mdsTabItemSelect` is the item-level event that `<mds-tab-item>` fires to its parent `<mds-tab>`: its `detail` carries the item element (`target`) and `value`, not the position of the tab. To react to the active tab of the group listen to `mdsTabChange` on `<mds-tab>`, whose `detail` has the tab index (`id`) and `value`.\n\n```html\n<!-- INCORRECT -->\n<mds-tab id=\"schede\">\n <mds-tab-item label=\"Prima\" selected></mds-tab-item>\n <mds-tab-item label=\"Seconda\"></mds-tab-item>\n</mds-tab>\n\n<script>\n document.querySelector('#schede').addEventListener('mdsTabItemSelect', handler);\n</script>\n\n<!-- CORRECT -->\n<mds-tab id=\"schede\">\n <mds-tab-item label=\"Prima\" selected></mds-tab-item>\n <mds-tab-item label=\"Seconda\"></mds-tab-item>\n</mds-tab>\n\n<script>\n document.querySelector('#schede').addEventListener('mdsTabChange', handler);\n</script>\n```\n\n#### Do Not Use `scrollbar=\"false\"` or `overflow=\"false\"` to Turn Off Boolean Props\n\nStencil reads `\"false\"` as `false` and, since both props are reflected, removes the attribute at the first render, so this happens to work; but the markup says the opposite of what it does, and on a prop that is not reflected the attribute stays in the DOM, where `[attr]` selectors still match it. Remove the attribute entirely to turn a prop off.\n\n```html\n<!-- INCORRECT -->\n<mds-tab scrollbar=\"false\" overflow=\"false\">\n <mds-tab-item label=\"Prima\" selected></mds-tab-item>\n</mds-tab>\n\n<!-- CORRECT -->\n<mds-tab>\n <mds-tab-item label=\"Prima\" selected></mds-tab-item>\n</mds-tab>\n```\n\n#### Do Not Place Raw HTML Instead of `<mds-tab-item>` in the Default Slot\n\nThe default slot expects `<mds-tab-item>` elements only. Placing a raw `<button>` or `<a>` there bypasses the ARIA `tablist` structure, selection management, and keyboard handling that `<mds-tab>` provides.\n\n```html\n<!-- INCORRECT -->\n<mds-tab>\n <button class=\"tab\">Documenti</button>\n <button class=\"tab\">Messaggi</button>\n <div slot=\"content\">...</div>\n <div slot=\"content\">...</div>\n</mds-tab>\n\n<!-- CORRECT -->\n<mds-tab>\n <mds-tab-item label=\"Documenti\" selected></mds-tab-item>\n <mds-tab-item label=\"Messaggi\"></mds-tab-item>\n <div slot=\"content\">...</div>\n <div slot=\"content\">...</div>\n</mds-tab>\n```\n\n#### Do Not Customize via Undocumented Shadow Parts or Internal Selectors\n\nThe supported customization surface is the `--mds-tab-*` CSS custom properties and the documented shadow parts (`tabs`, `contents`, `slider`). Targeting other internals via `>>>`, `/deep/`, or undocumented class names couples your code to the shadow DOM implementation and will break on minor releases.\n\n```css\n/* INCORRECT */\nmds-tab >>> .tabs-wrapper {\n background: red;\n}\nmds-tab::part(tabs-wrapper) {\n padding: 0;\n}\n\n/* CORRECT */\nmds-tab {\n --mds-tab-tabs-background: rgb(var(--magma-accent-surface));\n --mds-tab-tabs-padding: calc(var(--spacing) * 400);\n --mds-tab-tabs-radius: var(--magma-radius-xl);\n}\nmds-tab::part(tabs) {\n outline: 2px solid rgb(var(--magma-accent-border));\n}\n```\n"
42
+ "2. Pattern": "Correct and idiomatic ways to use the `<mds-tab>` 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 Tab Group with Managed Panels\n\nThe canonical form. Put `<mds-tab-item>` elements in the default slot and one content element per tab in the named `content` slot. Mark the initially-visible tab with `selected`. Panels are wired up by document order - the first `[slot=content]` element is paired with the first `<mds-tab-item>`.\n\n```html\n<mds-tab>\n <mds-tab-item label=\"Panoramica\" selected></mds-tab-item>\n <mds-tab-item label=\"Dettagli\"></mds-tab-item>\n <mds-tab-item label=\"Allegati\"></mds-tab-item>\n\n <div slot=\"content\">\n <mds-text>Contenuto della scheda Panoramica.</mds-text>\n </div>\n <div slot=\"content\">\n <mds-text>Contenuto della scheda Dettagli.</mds-text>\n </div>\n <div slot=\"content\">\n <mds-text>Contenuto della scheda Allegati.</mds-text>\n </div>\n</mds-tab>\n```\n\n#### Listening to Tab Changes\n\nListen to the `mdsTabChange` event to react when the active panel changes. The event detail carries the zero-based `id` (index) and the optional `value` of the newly selected `<mds-tab-item>`.\n\n```html\n<mds-tab id=\"schede-pratica\">\n <mds-tab-item label=\"Anagrafica\" value=\"anagrafica\" selected></mds-tab-item>\n <mds-tab-item label=\"Documenti\" value=\"documenti\"></mds-tab-item>\n <mds-tab-item label=\"Pagamenti\" value=\"pagamenti\"></mds-tab-item>\n</mds-tab>\n\n<script>\n document.querySelector('#schede-pratica').addEventListener('mdsTabChange', (e) => {\n console.log('scheda attiva:', e.detail.id, e.detail.value);\n });\n</script>\n```\n\n#### Tab Items with Icons\n\nPass an icon slug to `<mds-tab-item>` via the `icon` prop. Icon position defaults to `left`; use `icon-position=\"right\"` for forward-navigation tabs.\n\n```html\n<mds-tab>\n <mds-tab-item label=\"Utente\" icon=\"mi/baseline/person\" selected></mds-tab-item>\n <mds-tab-item label=\"Impostazioni\" icon=\"mi/baseline/settings\"></mds-tab-item>\n <mds-tab-item label=\"Notifiche\" icon=\"mi/baseline/notifications\"></mds-tab-item>\n\n <div slot=\"content\"><mds-text>Profilo utente.</mds-text></div>\n <div slot=\"content\"><mds-text>Impostazioni account.</mds-text></div>\n <div slot=\"content\"><mds-text>Cronologia notifiche.</mds-text></div>\n</mds-tab>\n```\n\n#### Fill the Available Width\n\nSet `fill` when the tab strip should stretch to occupy the full container width instead of hugging its content.\n\n```html\n<mds-tab fill>\n <mds-tab-item label=\"Riepilogo\" selected></mds-tab-item>\n <mds-tab-item label=\"Cronologia\"></mds-tab-item>\n <mds-tab-item label=\"Statistiche\"></mds-tab-item>\n\n <div slot=\"content\"><mds-text>Riepilogo pratica.</mds-text></div>\n <div slot=\"content\"><mds-text>Registro modifiche.</mds-text></div>\n <div slot=\"content\"><mds-text>Dati statistici.</mds-text></div>\n</mds-tab>\n```\n\n#### Vertical Direction\n\nUse `direction=\"vertical\"` to stack the tab strip on the side. Pair it with `--mds-tab-direction-vertical-columns` to control the column widths of the sidebar and the content area.\n\n```html\n<mds-tab direction=\"vertical\">\n <mds-tab-item label=\"Dati generali\" selected></mds-tab-item>\n <mds-tab-item label=\"Indirizzi\"></mds-tab-item>\n <mds-tab-item label=\"Contatti\"></mds-tab-item>\n\n <div slot=\"content\"><mds-text>Dati generali.</mds-text></div>\n <div slot=\"content\"><mds-text>Indirizzi registrati.</mds-text></div>\n <div slot=\"content\"><mds-text>Recapiti di contatto.</mds-text></div>\n</mds-tab>\n```\n\n#### Fade Animation\n\nSwitch to `animation=\"fade\"` to highlight the selected tab in place instead of moving the slider indicator. The panels switch without animation in both modes.\n\n```html\n<mds-tab animation=\"fade\">\n <mds-tab-item label=\"Prima\" selected></mds-tab-item>\n <mds-tab-item label=\"Seconda\"></mds-tab-item>\n\n <div slot=\"content\"><mds-text>Pannello 1.</mds-text></div>\n <div slot=\"content\"><mds-text>Pannello 2.</mds-text></div>\n</mds-tab>\n```\n\n#### Overflow Shadow for Many Tabs\n\nEnable `overflow` when the tab strip can contain more items than the viewport permits. Left and right inset shadows appear whenever tabs overflow their container, signalling that scrolling is possible.\n\n```html\n<mds-tab overflow>\n <mds-tab-item label=\"Gennaio\" selected></mds-tab-item>\n <mds-tab-item label=\"Febbraio\"></mds-tab-item>\n <mds-tab-item label=\"Marzo\"></mds-tab-item>\n <mds-tab-item label=\"Aprile\"></mds-tab-item>\n <mds-tab-item label=\"Maggio\"></mds-tab-item>\n <mds-tab-item label=\"Giugno\"></mds-tab-item>\n <mds-tab-item label=\"Luglio\"></mds-tab-item>\n <mds-tab-item label=\"Agosto\"></mds-tab-item>\n <mds-tab-item label=\"Settembre\"></mds-tab-item>\n <mds-tab-item label=\"Ottobre\"></mds-tab-item>\n <mds-tab-item label=\"Novembre\"></mds-tab-item>\n <mds-tab-item label=\"Dicembre\"></mds-tab-item>\n</mds-tab>\n```\n\n#### Scrollbar for Accessible Overflow\n\nUse `scrollbar` instead of (or alongside) `overflow` to expose the native horizontal scrollbar. This is the accessible complement for users who navigate via keyboard or who have motor difficulties.\n\n```html\n<mds-tab scrollbar overflow>\n <mds-tab-item label=\"Sezione A\" selected></mds-tab-item>\n <mds-tab-item label=\"Sezione B\"></mds-tab-item>\n <mds-tab-item label=\"Sezione C\"></mds-tab-item>\n <mds-tab-item label=\"Sezione D\"></mds-tab-item>\n <mds-tab-item label=\"Sezione E\"></mds-tab-item>\n</mds-tab>\n```\n\n#### Sizing\n\nSet `size` on the parent to scale all tabs uniformly. Do not set `size` on individual `<mds-tab-item>` elements - the parent propagates the value automatically.\n\n```html\n<!-- Compact strip, e.g. inside a sidebar or dense toolbar -->\n<mds-tab size=\"sm\">\n <mds-tab-item label=\"Vista elenco\" selected></mds-tab-item>\n <mds-tab-item label=\"Vista griglia\"></mds-tab-item>\n</mds-tab>\n```\n\n#### Navigation Links (href on Tab Items)\n\nWhen each tab leads to an anchor, another page or a route, set `href` on every `<mds-tab-item>` and omit the `content` slot: the items render as links, the browser follows them (in a new tab on a modifier or middle click) and the strip keeps the selected item highlighted. The page content is driven by navigation, not by the managed-panels mechanism.\n\n```html\n<mds-tab>\n <mds-tab-item href=\"#sezione-1\" label=\"Introduzione\" selected></mds-tab-item>\n <mds-tab-item href=\"#sezione-2\" label=\"Requisiti\"></mds-tab-item>\n <mds-tab-item href=\"#sezione-3\" label=\"Conclusioni\"></mds-tab-item>\n</mds-tab>\n```\n\n#### Client-Side Routing (href on Tab Items)\n\nIn a single-page app keep `href` on the items and register the router once with `NavigationService`, from `@maggioli-design-system/magma/services`: a plain click on an item is routed on the client and the selection still moves, with no listener per item. A modifier or middle click stays with the browser, which opens the link in a new tab while the strip stays as it is.\n\n```html\n<mds-tab id=\"sezioni\">\n <mds-tab-item href=\"/pratiche\" label=\"Pratiche\" selected></mds-tab-item>\n <mds-tab-item href=\"/documenti\" label=\"Documenti\"></mds-tab-item>\n <mds-tab-item href=\"/pagamenti\" label=\"Pagamenti\"></mds-tab-item>\n</mds-tab>\n\n<script type=\"module\">\n import { NavigationService } from '@maggioli-design-system/magma/services';\n\n NavigationService.setHandler((href) => router.navigate(href));\n</script>\n```\n\nWithout a registered router, cancel the click on the items and route by hand: the component honours `preventDefault()` and still moves the selection. Leave a modifier click alone.\n\n```html\n<script>\n document.querySelectorAll('#sezioni mds-tab-item').forEach((item) => {\n item.addEventListener('click', (event) => {\n if (event.ctrlKey || event.metaKey || event.shiftKey || event.altKey) return;\n event.preventDefault();\n router.navigate(item.href);\n });\n });\n</script>\n```\n\n#### Disabled Tab Item\n\nMark an individual tab as unavailable with `disabled`. The parent's selection mechanism skips it; the tab is removed from the tab order automatically.\n\n```html\n<mds-tab>\n <mds-tab-item label=\"Attivo\" selected></mds-tab-item>\n <mds-tab-item label=\"Non disponibile\" disabled></mds-tab-item>\n <mds-tab-item label=\"Altro\"></mds-tab-item>\n\n <div slot=\"content\"><mds-text>Contenuto disponibile.</mds-text></div>\n <div slot=\"content\"><mds-text>Contenuto non disponibile.</mds-text></div>\n <div slot=\"content\"><mds-text>Altro contenuto.</mds-text></div>\n</mds-tab>\n```\n\n#### Styling Customization\n\nStyle the component only through its public `--mds-tab-*` CSS custom properties: the background, margin and shadow of the tab strip and the columns of the vertical layout. The colours and shadows of the items and the timing of the transitions are not part of them. Set them on the host or a parent selector; use semantic color roles via `rgb(var(--magma-<role>))` so dark mode and high-contrast modes keep working.\n\n```css\n.scheda-primaria mds-tab {\n --mds-tab-tabs-background: rgb(var(--magma-accent-surface));\n --mds-tab-tabs-wrapper-shadow: 0 0 0 calc(var(--spacing) * 50) rgb(var(--magma-accent-border)) inset;\n}\n```\n\nWith `animation=\"fade\"` every item paints its own states (resting, hover and selected). With the slider (`animation=\"slide\"`) the items stay transparent over it, and the slider (`::part(slider)`) paints the selected one.\n",
43
+ "3. Antipattern": "Common incorrect uses of `<mds-tab>`. 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 Size Individual Tab Items\n\nSetting `size` on a `<mds-tab-item>` directly is overridden by the parent at render time. Use the `size` prop on `<mds-tab>` to size all tabs uniformly.\n\n```html\n<!-- INCORRECT -->\n<mds-tab>\n <mds-tab-item label=\"Elenco\" size=\"sm\" selected></mds-tab-item>\n <mds-tab-item label=\"Griglia\" size=\"sm\"></mds-tab-item>\n</mds-tab>\n\n<!-- CORRECT -->\n<mds-tab size=\"sm\">\n <mds-tab-item label=\"Elenco\" selected></mds-tab-item>\n <mds-tab-item label=\"Griglia\"></mds-tab-item>\n</mds-tab>\n```\n\n#### Do Not Mix Tab Items and Content Panels Out of Order\n\nPanels in `slot=\"content\"` are wired to `<mds-tab-item>` elements by document order. A missing panel leaves its tab with no content, a wrong ordering shows the wrong panel when a tab is selected.\n\n```html\n<!-- INCORRECT: only two content panels for three tab items -->\n<mds-tab>\n <mds-tab-item label=\"A\" selected></mds-tab-item>\n <mds-tab-item label=\"B\"></mds-tab-item>\n <mds-tab-item label=\"C\"></mds-tab-item>\n\n <div slot=\"content\"><mds-text>Pannello A.</mds-text></div>\n <div slot=\"content\"><mds-text>Pannello B.</mds-text></div>\n</mds-tab>\n\n<!-- CORRECT: one content panel per tab item, same order -->\n<mds-tab>\n <mds-tab-item label=\"A\" selected></mds-tab-item>\n <mds-tab-item label=\"B\"></mds-tab-item>\n <mds-tab-item label=\"C\"></mds-tab-item>\n\n <div slot=\"content\"><mds-text>Pannello A.</mds-text></div>\n <div slot=\"content\"><mds-text>Pannello B.</mds-text></div>\n <div slot=\"content\"><mds-text>Pannello C.</mds-text></div>\n</mds-tab>\n```\n\n#### Do Not Mix Link Items and Panel Tabs in One Strip\n\nA strip is either a `tablist` of tabs, each controlling a panel, or a navigation of links (`href` on every item): a link inside a tablist is not a child the role allows, and assistive technology announces the strip wrong. Keep the link out of the strip, as an `<mds-button>` next to it.\n\n```html\n<!-- INCORRECT -->\n<mds-tab>\n <mds-tab-item label=\"Dettagli\" selected></mds-tab-item>\n <mds-tab-item label=\"Allegati\"></mds-tab-item>\n <mds-tab-item label=\"Portale\" href=\"https://portale.example.com\"></mds-tab-item>\n\n <div slot=\"content\"><mds-text>Dettagli.</mds-text></div>\n <div slot=\"content\"><mds-text>Allegati.</mds-text></div>\n <div slot=\"content\"></div>\n</mds-tab>\n\n<!-- CORRECT -->\n<mds-tab>\n <mds-tab-item label=\"Dettagli\" selected></mds-tab-item>\n <mds-tab-item label=\"Allegati\"></mds-tab-item>\n\n <div slot=\"content\"><mds-text>Dettagli.</mds-text></div>\n <div slot=\"content\"><mds-text>Allegati.</mds-text></div>\n</mds-tab>\n<mds-button label=\"Portale\" href=\"https://portale.example.com\" target=\"blank\" tone=\"text\"></mds-button>\n```\n\n#### Do Not Put Tab Items Outside `<mds-tab>`\n\n`<mds-tab-item>` communicates with its parent through internal Stencil events. Used outside `<mds-tab>` it renders as an inert button with no selection, panel, or keyboard management.\n\n```html\n<!-- INCORRECT -->\n<div class=\"my-tab-wrapper\">\n <mds-tab-item label=\"Scheda uno\" selected></mds-tab-item>\n <mds-tab-item label=\"Scheda due\"></mds-tab-item>\n</div>\n<div>...</div>\n\n<!-- CORRECT -->\n<mds-tab>\n <mds-tab-item label=\"Scheda uno\" selected></mds-tab-item>\n <mds-tab-item label=\"Scheda due\"></mds-tab-item>\n <div slot=\"content\">...</div>\n <div slot=\"content\">...</div>\n</mds-tab>\n```\n\n#### Do Not Listen to the `mdsTabItemSelect` Event from Outside\n\n`mdsTabItemSelect` is the item-level event that `<mds-tab-item>` fires to its parent `<mds-tab>`: its `detail` carries the item element (`target`) and `value`, not the position of the tab. To react to the active tab of the group listen to `mdsTabChange` on `<mds-tab>`, whose `detail` has the tab index (`id`) and `value`.\n\n```html\n<!-- INCORRECT -->\n<mds-tab id=\"schede\">\n <mds-tab-item label=\"Prima\" selected></mds-tab-item>\n <mds-tab-item label=\"Seconda\"></mds-tab-item>\n</mds-tab>\n\n<script>\n document.querySelector('#schede').addEventListener('mdsTabItemSelect', handler);\n</script>\n\n<!-- CORRECT -->\n<mds-tab id=\"schede\">\n <mds-tab-item label=\"Prima\" selected></mds-tab-item>\n <mds-tab-item label=\"Seconda\"></mds-tab-item>\n</mds-tab>\n\n<script>\n document.querySelector('#schede').addEventListener('mdsTabChange', handler);\n</script>\n```\n\n#### Do Not Use `scrollbar=\"false\"` or `overflow=\"false\"` to Turn Off Boolean Props\n\nStencil reads `\"false\"` as `false` and, since both props are reflected, removes the attribute at the first render, so this happens to work; but the markup says the opposite of what it does, and on a prop that is not reflected the attribute stays in the DOM, where `[attr]` selectors still match it. Remove the attribute entirely to turn a prop off.\n\n```html\n<!-- INCORRECT -->\n<mds-tab scrollbar=\"false\" overflow=\"false\">\n <mds-tab-item label=\"Prima\" selected></mds-tab-item>\n</mds-tab>\n\n<!-- CORRECT -->\n<mds-tab>\n <mds-tab-item label=\"Prima\" selected></mds-tab-item>\n</mds-tab>\n```\n\n#### Do Not Place Raw HTML Instead of `<mds-tab-item>` in the Default Slot\n\nThe default slot expects `<mds-tab-item>` elements only. Placing a raw `<button>` or `<a>` there bypasses the ARIA `tablist` structure, selection management, and keyboard handling that `<mds-tab>` provides.\n\n```html\n<!-- INCORRECT -->\n<mds-tab>\n <button class=\"tab\">Documenti</button>\n <button class=\"tab\">Messaggi</button>\n <div slot=\"content\">...</div>\n <div slot=\"content\">...</div>\n</mds-tab>\n\n<!-- CORRECT -->\n<mds-tab>\n <mds-tab-item label=\"Documenti\" selected></mds-tab-item>\n <mds-tab-item label=\"Messaggi\"></mds-tab-item>\n <div slot=\"content\">...</div>\n <div slot=\"content\">...</div>\n</mds-tab>\n```\n\n#### Do Not Customize via Undocumented Shadow Parts or Internal Selectors\n\nThe supported customization surface is the public `--mds-tab-*` CSS custom properties and the documented shadow parts (`tabs`, `contents`, `slider`). Targeting other internals via `>>>`, `/deep/`, or undocumented class names couples your code to the shadow DOM implementation and will break on minor releases.\n\n```css\n/* INCORRECT */\nmds-tab >>> .tabs-wrapper {\n background: red;\n}\nmds-tab::part(tabs-wrapper) {\n padding: 0;\n}\n\n/* CORRECT */\nmds-tab {\n --mds-tab-tabs-background: rgb(var(--magma-accent-surface));\n}\nmds-tab::part(tabs) {\n outline: 2px solid rgb(var(--magma-accent-border));\n}\n```\n"
40
44
  },
41
45
  "props": [
42
46
  {
@@ -284,152 +288,182 @@
284
288
  {
285
289
  "name": "--mds-tab-direction-vertical-columns",
286
290
  "annotation": "prop",
287
- "docs": "Defines the column layout for vertical tabs."
291
+ "docs": "Defines the column layout for vertical tabs.",
292
+ "visibility": "public"
288
293
  },
289
294
  {
290
295
  "name": "--mds-tab-item-default-background",
291
296
  "annotation": "prop",
292
- "docs": "Background color for default tab items."
297
+ "docs": "Background color for default tab items.",
298
+ "visibility": "internal"
293
299
  },
294
300
  {
295
301
  "name": "--mds-tab-item-default-color",
296
302
  "annotation": "prop",
297
- "docs": "Text color for default tab items."
303
+ "docs": "Text color for default tab items.",
304
+ "visibility": "internal"
298
305
  },
299
306
  {
300
307
  "name": "--mds-tab-item-default-shadow",
301
308
  "annotation": "prop",
302
- "docs": "Shadow for default tab items."
309
+ "docs": "Shadow for default tab items.",
310
+ "visibility": "internal"
303
311
  },
304
312
  {
305
313
  "name": "--mds-tab-item-hover-background",
306
314
  "annotation": "prop",
307
- "docs": "Background color for hovered tab items."
315
+ "docs": "Background color for hovered tab items.",
316
+ "visibility": "internal"
308
317
  },
309
318
  {
310
319
  "name": "--mds-tab-item-hover-color",
311
320
  "annotation": "prop",
312
- "docs": "Text color for hovered tab items."
321
+ "docs": "Text color for hovered tab items.",
322
+ "visibility": "internal"
313
323
  },
314
324
  {
315
325
  "name": "--mds-tab-item-hover-shadow",
316
326
  "annotation": "prop",
317
- "docs": "Shadow for hovered tab items, the default shadow when not set."
327
+ "docs": "Shadow for hovered tab items, the default shadow when not set.",
328
+ "visibility": "internal"
318
329
  },
319
330
  {
320
331
  "name": "--mds-tab-item-radius",
321
332
  "annotation": "prop",
322
- "docs": "Border radius for tab items."
333
+ "docs": "Border radius for tab items.",
334
+ "visibility": "internal"
323
335
  },
324
336
  {
325
337
  "name": "--mds-tab-item-selected-background",
326
338
  "annotation": "prop",
327
- "docs": "Background color for selected tab items."
339
+ "docs": "Background color for selected tab items.",
340
+ "visibility": "internal"
328
341
  },
329
342
  {
330
343
  "name": "--mds-tab-item-selected-color",
331
344
  "annotation": "prop",
332
- "docs": "Text color for selected tab items."
345
+ "docs": "Text color for selected tab items.",
346
+ "visibility": "internal"
333
347
  },
334
348
  {
335
349
  "name": "--mds-tab-item-selected-shadow",
336
350
  "annotation": "prop",
337
- "docs": "Shadow for selected tab items."
351
+ "docs": "Shadow for selected tab items.",
352
+ "visibility": "internal"
338
353
  },
339
354
  {
340
355
  "name": "--mds-tab-scroll-behavior",
341
356
  "annotation": "prop",
342
- "docs": "Scroll behavior for tab container."
357
+ "docs": "Scroll behavior for tab container.",
358
+ "visibility": "internal"
343
359
  },
344
360
  {
345
361
  "name": "--mds-tab-scroll-scrollbar-margin",
346
362
  "annotation": "prop",
347
- "docs": "Margin for scrollbar."
363
+ "docs": "Margin for scrollbar.",
364
+ "visibility": "internal"
348
365
  },
349
366
  {
350
367
  "name": "--mds-tab-scroll-scrollbar-radius",
351
368
  "annotation": "prop",
352
- "docs": "Radius of scrollbar."
369
+ "docs": "Radius of scrollbar.",
370
+ "visibility": "internal"
353
371
  },
354
372
  {
355
373
  "name": "--mds-tab-scroll-scrollbar-size",
356
374
  "annotation": "prop",
357
- "docs": "Size of scrollbar."
375
+ "docs": "Size of scrollbar.",
376
+ "visibility": "internal"
358
377
  },
359
378
  {
360
379
  "name": "--mds-tab-scroll-scrollbar-thumb-background",
361
380
  "annotation": "prop",
362
- "docs": "Background color of scrollbar thumb."
381
+ "docs": "Background color of scrollbar thumb.",
382
+ "visibility": "internal"
363
383
  },
364
384
  {
365
385
  "name": "--mds-tab-scroll-scrollbar-track-background",
366
386
  "annotation": "prop",
367
- "docs": "Background color of scrollbar track."
387
+ "docs": "Background color of scrollbar track.",
388
+ "visibility": "internal"
368
389
  },
369
390
  {
370
391
  "name": "--mds-tab-slide-delay",
371
392
  "annotation": "prop",
372
- "docs": "Delay before tab slide animation."
393
+ "docs": "Delay before tab slide animation.",
394
+ "visibility": "internal"
373
395
  },
374
396
  {
375
397
  "name": "--mds-tab-tabs-background",
376
398
  "annotation": "prop",
377
- "docs": "Background color of the tabs container."
399
+ "docs": "Background color of the tabs container.",
400
+ "visibility": "public"
378
401
  },
379
402
  {
380
403
  "name": "--mds-tab-tabs-gap",
381
404
  "annotation": "prop",
382
- "docs": "Gap between tabs."
405
+ "docs": "Gap between tabs.",
406
+ "visibility": "internal"
383
407
  },
384
408
  {
385
409
  "name": "--mds-tab-tabs-overflow-shadow",
386
410
  "annotation": "prop",
387
- "docs": "Shadow applied to overflowed tabs."
411
+ "docs": "Shadow applied to overflowed tabs.",
412
+ "visibility": "internal"
388
413
  },
389
414
  {
390
415
  "name": "--mds-tab-tabs-overflow-shadow-size",
391
416
  "annotation": "prop",
392
- "docs": "Size of the overflow shadow."
417
+ "docs": "Size of the overflow shadow.",
418
+ "visibility": "internal"
393
419
  },
394
420
  {
395
421
  "name": "--mds-tab-tabs-padding",
396
422
  "annotation": "prop",
397
- "docs": "Padding inside the tabs container."
423
+ "docs": "Padding inside the tabs container.",
424
+ "visibility": "internal"
398
425
  },
399
426
  {
400
427
  "name": "--mds-tab-tabs-radius",
401
428
  "annotation": "prop",
402
- "docs": "Border radius of the tabs container."
429
+ "docs": "Border radius of the tabs container.",
430
+ "visibility": "internal"
403
431
  },
404
432
  {
405
433
  "name": "--mds-tab-tabs-wrapper-margin",
406
434
  "annotation": "prop",
407
- "docs": "Margin for the tabs wrapper."
435
+ "docs": "Margin for the tabs wrapper.",
436
+ "visibility": "public"
408
437
  },
409
438
  {
410
439
  "name": "--mds-tab-tabs-wrapper-outline-opacity",
411
440
  "annotation": "prop",
412
- "docs": "Opacity of the wrapper outline."
441
+ "docs": "Opacity of the wrapper outline.",
442
+ "visibility": "internal"
413
443
  },
414
444
  {
415
445
  "name": "--mds-tab-tabs-wrapper-shadow",
416
446
  "annotation": "prop",
417
- "docs": "Shadow for the tabs wrapper."
447
+ "docs": "Shadow for the tabs wrapper.",
448
+ "visibility": "public"
418
449
  },
419
450
  {
420
451
  "name": "--mds-tab-tabs-wrapper-shadow-color",
421
452
  "annotation": "prop",
422
- "docs": "Color of the wrapper shadow."
453
+ "docs": "Color of the wrapper shadow.",
454
+ "visibility": "internal"
423
455
  },
424
456
  {
425
457
  "name": "--mds-tab-transition-duration",
426
458
  "annotation": "prop",
427
- "docs": "Duration of tab transition animation."
459
+ "docs": "Duration of tab transition animation.",
460
+ "visibility": "internal"
428
461
  },
429
462
  {
430
463
  "name": "--mds-tab-transition-timing-function",
431
464
  "annotation": "prop",
432
- "docs": "Timing function for tab transition animation."
465
+ "docs": "Timing function for tab transition animation.",
466
+ "visibility": "internal"
433
467
  }
434
468
  ],
435
469
  "slots": [
@@ -11,7 +11,7 @@ mds-tab-item {
11
11
 
12
12
 
13
13
  /**
14
- * @prop --mds-tab-direction-vertical-columns: Defines the column layout for vertical tabs.
14
+ * @prop --mds-tab-direction-vertical-columns: Public. Defines the column layout for vertical tabs.
15
15
  * @prop --mds-tab-item-default-background: Background color for default tab items.
16
16
  * @prop --mds-tab-item-default-color: Text color for default tab items.
17
17
  * @prop --mds-tab-item-default-shadow: Shadow for default tab items.
@@ -29,16 +29,16 @@ mds-tab-item {
29
29
  * @prop --mds-tab-scroll-scrollbar-thumb-background: Background color of scrollbar thumb.
30
30
  * @prop --mds-tab-scroll-scrollbar-track-background: Background color of scrollbar track.
31
31
  * @prop --mds-tab-slide-delay: Delay before tab slide animation.
32
- * @prop --mds-tab-tabs-background: Background color of the tabs container.
32
+ * @prop --mds-tab-tabs-background: Public. Background color of the tabs container.
33
33
  * @prop --mds-tab-tabs-gap: Gap between tabs.
34
34
  * @prop --mds-tab-tabs-overflow-shadow-size: Size of the overflow shadow.
35
35
  * @prop --mds-tab-tabs-overflow-shadow: Shadow applied to overflowed tabs.
36
36
  * @prop --mds-tab-tabs-padding: Padding inside the tabs container.
37
37
  * @prop --mds-tab-tabs-radius: Border radius of the tabs container.
38
- * @prop --mds-tab-tabs-wrapper-margin: Margin for the tabs wrapper.
38
+ * @prop --mds-tab-tabs-wrapper-margin: Public. Margin for the tabs wrapper.
39
39
  * @prop --mds-tab-tabs-wrapper-outline-opacity: Opacity of the wrapper outline.
40
40
  * @prop --mds-tab-tabs-wrapper-shadow-color: Color of the wrapper shadow.
41
- * @prop --mds-tab-tabs-wrapper-shadow: Shadow for the tabs wrapper.
41
+ * @prop --mds-tab-tabs-wrapper-shadow: Public. Shadow for the tabs wrapper.
42
42
  * @prop --mds-tab-transition-duration: Duration of tab transition animation.
43
43
  * @prop --mds-tab-transition-timing-function: Timing function for tab transition animation.
44
44
  */
@@ -126,7 +126,7 @@ mds-tab-item {
126
126
  --mds-tab-tabs-gap: --spacing(200);
127
127
  --mds-tab-tabs-overflow-shadow-size: --spacing(600);
128
128
  --mds-tab-tabs-overflow-shadow: 0 0 var(--mds-tab-tabs-overflow-shadow-size, --spacing(600)) --spacing(-50)
129
- rgb(0 0 0 / 0.375);
129
+ rgb(var(--magma-shadow-ink, var(--tone-neutral-01, 5 5 5)) / 0.375);
130
130
  --mds-tab-tabs-padding: --spacing(200);
131
131
  --mds-tab-tabs-radius: min(
132
132
  var(--magma-radius-2xl, var(--radius-squircle-2xl, 40px)),
@@ -12,6 +12,7 @@ import { preferenceStore } from "../../common/preference";
12
12
  * items are links (`href`) to other pages or places and the page, not the component, shows the
13
13
  * content.
14
14
  * @slot - Add `mds-tab-item` element/s.
15
+ * @category navigation
15
16
  */
16
17
  export class MdsTab {
17
18
  constructor() {
@@ -249,12 +250,12 @@ export class MdsTab {
249
250
  });
250
251
  }
251
252
  render() {
252
- return (h(Host, { key: 'b9474219c7421526e30e8febc947b47b683357a4', "pref-animation": preferenceStore.state.animation, "pref-contrast": preferenceStore.state.contrast, "pref-mode": preferenceStore.state.mode, "pref-theme-scheme": preferenceStore.state['theme-scheme'] }, h("div", { key: 'f9aa464b8914a2cb1ae6497fcb69d52739adb762', class: clsx('tabs-wrapper', this.fill && 'tabs-wrapper--fill', !this.hasContent && 'tabs-wrapper--no-content') }, this.overflow && (h("div", { key: '9a81df0034b32064c3d94b014796e9173f4992d5', class: clsx('tabs-wrapper-overflow-left', this.overflowLeft && 'tabs-wrapper-overflow-left--show') })), this.overflow && (h("div", { key: '5bfd4224e87cfc2e5e9e9b872ef1b42aa23e5747', class: clsx('tabs-wrapper-overflow-right', this.overflowRight && 'tabs-wrapper-overflow-right--show') })), h("div", { key: '5d538912fa1178d25c59e6343937f3210a84f706', class: "tabs", part: "tabs", role: this.navigation ? undefined : 'tablist' }, h("slot", { key: '2c502d336726ce432d7b67c66753aa3ca3018ba8' }), this.animation === 'slide' && (h("div", { key: '88ed37cafc1258c08f67f17413e1a9858443da39', class: clsx('slider', !this.sliderSlides && 'slider--still'), part: "slider", style: {
253
+ return (h(Host, { key: 'e41e15dbbd47eabed43ae17abbd703a6da8b6007', "pref-animation": preferenceStore.state.animation, "pref-contrast": preferenceStore.state.contrast, "pref-mode": preferenceStore.state.mode, "pref-theme-scheme": preferenceStore.state['theme-scheme'] }, h("div", { key: '4c0fcf160e458ca25bcec4bc863ff94b07a9c983', class: clsx('tabs-wrapper', this.fill && 'tabs-wrapper--fill', !this.hasContent && 'tabs-wrapper--no-content') }, this.overflow && (h("div", { key: '0b5a123fe3098e7f4bb0c5e3d15848bec0f1695f', class: clsx('tabs-wrapper-overflow-left', this.overflowLeft && 'tabs-wrapper-overflow-left--show') })), this.overflow && (h("div", { key: '2b4f8854e9254ddaa76e05a9bc1c65a89c09a2d8', class: clsx('tabs-wrapper-overflow-right', this.overflowRight && 'tabs-wrapper-overflow-right--show') })), h("div", { key: 'ba7763d0bcebdc5efeeff1e3d4492ad4a345bec3', class: "tabs", part: "tabs", role: this.navigation ? undefined : 'tablist' }, h("slot", { key: '059b6fb51f7e089d324550366309d994ffa15cef' }), this.animation === 'slide' && (h("div", { key: 'd5e5ad377db64705ac0e7b517e8778b8fb11cb69', class: clsx('slider', !this.sliderSlides && 'slider--still'), part: "slider", style: {
253
254
  '--mds-tab-slider-width': `${this.sliderWidth}px`,
254
255
  '--mds-tab-slider-height': `${this.sliderHeight}px`,
255
256
  '--mds-tab-slider-offset-x': `${this.sliderOffsetX}px`,
256
257
  '--mds-tab-slider-offset-y': `${this.sliderOffsetY}px`,
257
- } })))), h("div", { key: '678d1e8cf009f2a34b4909c932916d4c2be209b9', class: clsx('contents', !this.hasContent && 'contents--empty'), part: "contents" }, h("slot", { key: 'c366b4abf8f5675511e78253bc6f72d16faf462f', name: "content", onSlotchange: this.updateContentItems }))));
258
+ } })))), h("div", { key: '877d854bae6e40e3d64ebbcb9e56cf743b12ad5b', class: clsx('contents', !this.hasContent && 'contents--empty'), part: "contents" }, h("slot", { key: '895b5f0c44848aad39a6083d44ca196b4fbf88d2', name: "content", onSlotchange: this.updateContentItems }))));
258
259
  }
259
260
  static get is() { return "mds-tab"; }
260
261
  static get encapsulation() { return "shadow"; }
@@ -220,23 +220,13 @@ Mark an individual tab as unavailable with `disabled`. The parent's selection me
220
220
 
221
221
  #### Styling Customization
222
222
 
223
- Style the component only through its documented `--mds-tab-*` CSS custom properties. Set them on the host or a parent selector; use semantic color roles via `rgb(var(--magma-<role>))` so dark mode and high-contrast modes keep working.
223
+ Style the component only through its public `--mds-tab-*` CSS custom properties: the background, margin and shadow of the tab strip and the columns of the vertical layout. The colours and shadows of the items and the timing of the transitions are not part of them. Set them on the host or a parent selector; use semantic color roles via `rgb(var(--magma-<role>))` so dark mode and high-contrast modes keep working.
224
224
 
225
225
  ```css
226
226
  .scheda-primaria mds-tab {
227
227
  --mds-tab-tabs-background: rgb(var(--magma-accent-surface));
228
- --mds-tab-tabs-radius: var(--magma-radius-xl);
229
- --mds-tab-item-selected-background: rgb(var(--magma-accent-emphasis));
230
- --mds-tab-item-selected-color: rgb(var(--magma-accent-on-emphasis));
231
- --mds-tab-transition-duration: 0.3s;
228
+ --mds-tab-tabs-wrapper-shadow: 0 0 0 calc(var(--spacing) * 50) rgb(var(--magma-accent-border)) inset;
232
229
  }
233
230
  ```
234
231
 
235
- With `animation="fade"` every item paints its own states: `--mds-tab-item-default-shadow` gives a shadow to the items that are not selected, and `--mds-tab-item-hover-shadow` to the hovered one (the default shadow when it is not set). With the slider (`animation="slide"`) the items stay transparent over it, so the backgrounds and shadows set on the tab for the items do not apply.
236
-
237
- ```css
238
- .schede-a-schedario mds-tab {
239
- --mds-tab-item-default-shadow: var(--shadow-xs);
240
- --mds-tab-item-hover-shadow: var(--shadow-sm);
241
- }
242
- ```
232
+ With `animation="fade"` every item paints its own states (resting, hover and selected). With the slider (`animation="slide"`) the items stay transparent over it, and the slider (`::part(slider)`) paints the selected one.
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-tab-bar
8
8
 
9
- > `@maggioli-design-system/magma` 2.5.0. Shadow DOM: style it only through the CSS custom properties and parts below.
9
+ > `@maggioli-design-system/magma` 2.6.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
10
10
 
11
11
  The `<mds-tab-bar>` web component is the compound container of the Magma Design System that groups a set of `<mds-tab-bar-item>` children into a single selectable navigation bar, owning the mutual-exclusion logic that keeps exactly one item active at a time. The bar is fixed to the bottom edge of the viewport (`position: fixed`), full width.
12
12
 
@@ -90,7 +90,7 @@ The item's `icon` prop renders the glyph through the shared icon service and pos
90
90
 
91
91
  #### Do Not Style Items by Piercing Shadow DOM
92
92
 
93
- The only supported customization surface is the four `--mds-tab-bar-item-*` CSS custom properties. Targeting internal nodes via `::part()`, `>>>`, or undocumented class names couples your code to the Shadow DOM implementation and will break on minor releases.
93
+ The only supported customization surface is the two public `--mds-tab-bar-item-*` CSS custom properties, `--mds-tab-bar-item-background` and `--mds-tab-bar-item-color` (the icon follows the text colour). Targeting internal nodes via `::part()`, `>>>`, or undocumented class names couples your code to the Shadow DOM implementation and will break on minor releases.
94
94
 
95
95
  ```css
96
96
  /* INCORRECT */
@@ -100,6 +100,6 @@ mds-tab-bar-item >>> mds-icon {
100
100
 
101
101
  /* CORRECT */
102
102
  mds-tab-bar mds-tab-bar-item {
103
- --mds-tab-bar-item-color-selected: rgb(var(--magma-accent-fg));
103
+ --mds-tab-bar-item-color: rgb(var(--magma-text-muted));
104
104
  }
105
105
  ```
@@ -1,5 +1,5 @@
1
1
  {
2
- "timestamp": "2026-10-21T16:53:07",
2
+ "timestamp": "2026-10-24T12:14:05",
3
3
  "compiler": {
4
4
  "name": "@stencil/core",
5
5
  "version": "4.45.2",
@@ -15,12 +15,16 @@
15
15
  {
16
16
  "name": "slot",
17
17
  "text": "- Add `mds-tab-bar-item` element/s."
18
+ },
19
+ {
20
+ "name": "category",
21
+ "text": "navigation"
18
22
  }
19
23
  ],
20
24
  "usage": {
21
25
  "1. Description": "The `<mds-tab-bar>` web component is the compound container of the Magma Design System that groups a set of `<mds-tab-bar-item>` children into a single selectable navigation bar, owning the mutual-exclusion logic that keeps exactly one item active at a time. The bar is fixed to the bottom edge of the viewport (`position: fixed`), full width.\n\n#### Semantic Behavior\n\n- **Compound parent/child**: It accepts only `<mds-tab-bar-item>` elements in its default slot and acts purely as their coordinator.\n- **Single active selection**: When one item reports selection, the others are deselected - enforcing one-active-at-a-time behavior.\n- **Change notification**: After resolving the new selection it emits `mdsTabBarChange` whose detail carries the zero-based `index` of the newly selected item, intended to drive panel/view switching by the consumer.\n- **Default-slot semantics**: The slot is structural (it expects components, not text); the textual label lives inside each `<mds-tab-bar-item>` instead.\n\n#### Properties & Visual Configurations\n\n`<mds-tab-bar>` itself exposes no configuration props - its appearance and content are entirely determined by the `<mds-tab-bar-item>` children it wraps. The relevant intent lives on those children:\n\n- **`selected`** marks which item is active. The parent rewrites it during selection changes; set it on a single child to define the initial active tab.\n- **`icon`** is an SVG filename slug from the Magma icon library, rendered above the item's text label.\n- **`typography`** selects the text scale of the item label from the smaller-typography ladder (defaulting to `'tip'`), letting authors match tab density to surrounding chrome.\n\nThis component does not use the shared `variant` / `tone` ladders defined in [`agents/variants.md`](../../../../agents/variants.md).\n",
22
- "2. Pattern": "Correct and idiomatic ways to use the `<mds-tab-bar>` 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 Navigation Bar\n\nThe canonical form. Place one `<mds-tab-bar-item>` per destination. Provide `icon` as a slug from the Magma icon library and the text via the `label` prop. Mark the initially active item with `selected`.\n\n```html\n<mds-tab-bar>\n <mds-tab-bar-item icon=\"mi/baseline/home\" label=\"Home\" selected></mds-tab-bar-item>\n <mds-tab-bar-item icon=\"mi/baseline/search\" label=\"Cerca\"></mds-tab-bar-item>\n <mds-tab-bar-item icon=\"mi/baseline/notifications\" label=\"Notifiche\"></mds-tab-bar-item>\n <mds-tab-bar-item icon=\"mi/baseline/person\" label=\"Profilo\"></mds-tab-bar-item>\n</mds-tab-bar>\n```\n\n#### Reacting to Tab Changes\n\nListen for `mdsTabBarChange` on the host. The event detail carries `index` - the zero-based position of the newly selected item - which you use to switch the visible view or panel.\n\n```html\n<mds-tab-bar id=\"app-nav\">\n <mds-tab-bar-item icon=\"mi/baseline/home\" label=\"Home\" selected></mds-tab-bar-item>\n <mds-tab-bar-item icon=\"mi/baseline/inbox\" label=\"Messaggi\"></mds-tab-bar-item>\n <mds-tab-bar-item icon=\"mi/baseline/settings\" label=\"Impostazioni\"></mds-tab-bar-item>\n</mds-tab-bar>\n\n<script>\n document.querySelector('#app-nav').addEventListener('mdsTabBarChange', (e) => {\n const activeIndex = e.detail.index;\n showView(activeIndex);\n });\n</script>\n```\n\n#### Setting the Initial Active Tab Programmatically\n\nSet `selected` on exactly one child to control the starting state. If you later need to change the active item from outside - for example, after a router navigation - set `selected` on the new item and remove it from the previous one yourself: the parent syncs the siblings only when an item is clicked, and emits no `mdsTabBarChange` for a change made from code.\n\n```html\n<!-- Second item active on load -->\n<mds-tab-bar>\n <mds-tab-bar-item icon=\"mi/baseline/home\" label=\"Home\"></mds-tab-bar-item>\n <mds-tab-bar-item icon=\"mi/baseline/explore\" label=\"Scopri\" selected></mds-tab-bar-item>\n <mds-tab-bar-item icon=\"mi/baseline/favorite\" label=\"Preferiti\"></mds-tab-bar-item>\n</mds-tab-bar>\n```\n\n#### Adjusting Label Typography\n\nUse `typography` on individual items to match the text density to the surrounding chrome. The prop accepts `\"tip\"` (default, smaller) or `\"option\"` (slightly larger). You can mix values if items carry different visual weight.\n\n```html\n<mds-tab-bar>\n <mds-tab-bar-item icon=\"mi/baseline/home\" label=\"Home\" typography=\"option\" selected></mds-tab-bar-item>\n <mds-tab-bar-item icon=\"mi/baseline/inbox\" label=\"Posta\" typography=\"option\"></mds-tab-bar-item>\n <mds-tab-bar-item\n icon=\"mi/baseline/settings\"\n label=\"Impostazioni\"\n typography=\"option\"\n ></mds-tab-bar-item>\n</mds-tab-bar>\n```\n\n#### Styling Customization via CSS Custom Properties\n\nStyle individual items through the documented `--mds-tab-bar-item-*` CSS custom properties. Set them on the specific item or on a parent selector. Use semantic color roles via `rgb(var(--magma-<role>))` so dark mode and high-contrast keep working.\n\n```css\n/* Brand-specific active color for the whole bar */\nmds-tab-bar mds-tab-bar-item {\n --mds-tab-bar-item-color-selected: rgb(var(--magma-accent-fg));\n}\n\n/* A single item with a distinct idle color */\nmds-tab-bar-item.priority {\n --mds-tab-bar-item-color: rgb(var(--magma-warning-text-default));\n}\n```\n",
23
- "3. Antipattern": "Common incorrect uses of `<mds-tab-bar>`. Each entry pairs the wrong form with the right one and a one-line reason. System-wide rules (boolean-as-string, shadow piercing, Tailwind color utilities, raw native event listening) live in [`agents/anti-patterns.md`](../../../../agents/anti-patterns.md) - they apply here too but are not repeated.\n\n#### Do Not Place HTML Elements or Text Directly in the Bar's Default Slot\n\n`<mds-tab-bar>` only coordinates `<mds-tab-bar-item>` children; arbitrary HTML or text in its slot breaks the mutual-exclusion logic and the change event.\n\n```html\n<!-- INCORRECT -->\n<mds-tab-bar>\n <button>Home</button>\n <a href=\"/cerca\">Cerca</a>\n</mds-tab-bar>\n\n<!-- CORRECT -->\n<mds-tab-bar>\n <mds-tab-bar-item icon=\"mi/baseline/home\" label=\"Home\" selected></mds-tab-bar-item>\n <mds-tab-bar-item icon=\"mi/baseline/search\" label=\"Cerca\"></mds-tab-bar-item>\n</mds-tab-bar>\n```\n\n#### Do Not Use the Deprecated Default Slot for an Item's Text\n\nSetting an item's text via the default slot is deprecated. Slotted text is read into `label`, and nested HTML is stripped with a console warning - use the `label` prop for the text and the `icon` prop for the glyph.\n\n```html\n<!-- INCORRECT -->\n<mds-tab-bar-item icon=\"mi/baseline/inbox\">Messaggi</mds-tab-bar-item>\n<mds-tab-bar-item>\n <span class=\"bold\">Messaggi</span>\n <small>(3)</small>\n</mds-tab-bar-item>\n\n<!-- CORRECT -->\n<mds-tab-bar-item icon=\"mi/baseline/inbox\" label=\"Messaggi\"></mds-tab-bar-item>\n```\n\n#### Do Not Slot `<mds-icon>` to Add an Icon\n\nThe item's `icon` prop renders the glyph through the shared icon service and positions it correctly above the label. Slotting `<mds-icon>` puts it in the deprecated default slot, where it is misaligned or stripped.\n\n```html\n<!-- INCORRECT -->\n<mds-tab-bar-item>\n <mds-icon name=\"mi/baseline/home\"></mds-icon>\n Home\n</mds-tab-bar-item>\n\n<!-- CORRECT -->\n<mds-tab-bar-item icon=\"mi/baseline/home\" label=\"Home\"></mds-tab-bar-item>\n```\n\n#### Do Not Set `selected=\"false\"` to Deselect an Item\n\n`selected` is a boolean attribute. The item happens to style `selected=\"false\"` as unselected, but the attribute stays on the element and contradicts the state for attribute selectors and checks. Remove the attribute entirely to deselect an item, or let the parent coordinate selection automatically.\n\n```html\n<!-- INCORRECT -->\n<mds-tab-bar-item icon=\"mi/baseline/home\" label=\"Home\" selected=\"false\"></mds-tab-bar-item>\n\n<!-- CORRECT -->\n<mds-tab-bar-item icon=\"mi/baseline/home\" label=\"Home\"></mds-tab-bar-item>\n```\n\n#### Do Not Listen for the Item's Internal Event on the Bar's Children\n\n`mdsTabBarItemSelect` is the item-level event `<mds-tab-bar>` coordinates on: its `detail` is the item's `id`, the one you gave it or the `mds-tab-bar-item-<index>` the bar gives an item without one. To react to selection changes from outside, listen for `mdsTabBarChange` on the parent instead, whose `detail.index` is the position of the selected item.\n\n```html\n<!-- INCORRECT -->\n<script>\n document.querySelector('mds-tab-bar-item').addEventListener('mdsTabBarItemSelect', handler);\n</script>\n\n<!-- CORRECT -->\n<script>\n document.querySelector('mds-tab-bar').addEventListener('mdsTabBarChange', (e) => {\n handler(e.detail.index);\n });\n</script>\n```\n\n#### Do Not Style Items by Piercing Shadow DOM\n\nThe only supported customization surface is the four `--mds-tab-bar-item-*` CSS custom properties. Targeting internal nodes via `::part()`, `>>>`, or undocumented class names couples your code to the Shadow DOM implementation and will break on minor releases.\n\n```css\n/* INCORRECT */\nmds-tab-bar-item >>> mds-icon {\n fill: hotpink;\n}\n\n/* CORRECT */\nmds-tab-bar mds-tab-bar-item {\n --mds-tab-bar-item-color-selected: rgb(var(--magma-accent-fg));\n}\n```\n"
26
+ "2. Pattern": "Correct and idiomatic ways to use the `<mds-tab-bar>` 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 Navigation Bar\n\nThe canonical form. Place one `<mds-tab-bar-item>` per destination. Provide `icon` as a slug from the Magma icon library and the text via the `label` prop. Mark the initially active item with `selected`.\n\n```html\n<mds-tab-bar>\n <mds-tab-bar-item icon=\"mi/baseline/home\" label=\"Home\" selected></mds-tab-bar-item>\n <mds-tab-bar-item icon=\"mi/baseline/search\" label=\"Cerca\"></mds-tab-bar-item>\n <mds-tab-bar-item icon=\"mi/baseline/notifications\" label=\"Notifiche\"></mds-tab-bar-item>\n <mds-tab-bar-item icon=\"mi/baseline/person\" label=\"Profilo\"></mds-tab-bar-item>\n</mds-tab-bar>\n```\n\n#### Reacting to Tab Changes\n\nListen for `mdsTabBarChange` on the host. The event detail carries `index` - the zero-based position of the newly selected item - which you use to switch the visible view or panel.\n\n```html\n<mds-tab-bar id=\"app-nav\">\n <mds-tab-bar-item icon=\"mi/baseline/home\" label=\"Home\" selected></mds-tab-bar-item>\n <mds-tab-bar-item icon=\"mi/baseline/inbox\" label=\"Messaggi\"></mds-tab-bar-item>\n <mds-tab-bar-item icon=\"mi/baseline/settings\" label=\"Impostazioni\"></mds-tab-bar-item>\n</mds-tab-bar>\n\n<script>\n document.querySelector('#app-nav').addEventListener('mdsTabBarChange', (e) => {\n const activeIndex = e.detail.index;\n showView(activeIndex);\n });\n</script>\n```\n\n#### Setting the Initial Active Tab Programmatically\n\nSet `selected` on exactly one child to control the starting state. If you later need to change the active item from outside - for example, after a router navigation - set `selected` on the new item and remove it from the previous one yourself: the parent syncs the siblings only when an item is clicked, and emits no `mdsTabBarChange` for a change made from code.\n\n```html\n<!-- Second item active on load -->\n<mds-tab-bar>\n <mds-tab-bar-item icon=\"mi/baseline/home\" label=\"Home\"></mds-tab-bar-item>\n <mds-tab-bar-item icon=\"mi/baseline/explore\" label=\"Scopri\" selected></mds-tab-bar-item>\n <mds-tab-bar-item icon=\"mi/baseline/favorite\" label=\"Preferiti\"></mds-tab-bar-item>\n</mds-tab-bar>\n```\n\n#### Adjusting Label Typography\n\nUse `typography` on individual items to match the text density to the surrounding chrome. The prop accepts `\"tip\"` (default, smaller) or `\"option\"` (slightly larger). You can mix values if items carry different visual weight.\n\n```html\n<mds-tab-bar>\n <mds-tab-bar-item icon=\"mi/baseline/home\" label=\"Home\" typography=\"option\" selected></mds-tab-bar-item>\n <mds-tab-bar-item icon=\"mi/baseline/inbox\" label=\"Posta\" typography=\"option\"></mds-tab-bar-item>\n <mds-tab-bar-item\n icon=\"mi/baseline/settings\"\n label=\"Impostazioni\"\n typography=\"option\"\n ></mds-tab-bar-item>\n</mds-tab-bar>\n```\n\n#### Styling Customization via CSS Custom Properties\n\nStyle individual items through the public `--mds-tab-bar-item-*` CSS custom properties: the background and the text colour of the item at rest (the selected item keeps its accent colouring). Set them on the specific item or on a parent selector. Use semantic color roles via `rgb(var(--magma-<role>))` so dark mode and high-contrast keep working.\n\n```css\n/* A resting background for the whole bar */\nmds-tab-bar mds-tab-bar-item {\n --mds-tab-bar-item-background: rgb(var(--magma-wash-base));\n}\n\n/* A single item with a distinct idle color */\nmds-tab-bar-item.priority {\n --mds-tab-bar-item-color: rgb(var(--magma-warning-text-default));\n}\n```\n",
27
+ "3. Antipattern": "Common incorrect uses of `<mds-tab-bar>`. Each entry pairs the wrong form with the right one and a one-line reason. System-wide rules (boolean-as-string, shadow piercing, Tailwind color utilities, raw native event listening) live in [`agents/anti-patterns.md`](../../../../agents/anti-patterns.md) - they apply here too but are not repeated.\n\n#### Do Not Place HTML Elements or Text Directly in the Bar's Default Slot\n\n`<mds-tab-bar>` only coordinates `<mds-tab-bar-item>` children; arbitrary HTML or text in its slot breaks the mutual-exclusion logic and the change event.\n\n```html\n<!-- INCORRECT -->\n<mds-tab-bar>\n <button>Home</button>\n <a href=\"/cerca\">Cerca</a>\n</mds-tab-bar>\n\n<!-- CORRECT -->\n<mds-tab-bar>\n <mds-tab-bar-item icon=\"mi/baseline/home\" label=\"Home\" selected></mds-tab-bar-item>\n <mds-tab-bar-item icon=\"mi/baseline/search\" label=\"Cerca\"></mds-tab-bar-item>\n</mds-tab-bar>\n```\n\n#### Do Not Use the Deprecated Default Slot for an Item's Text\n\nSetting an item's text via the default slot is deprecated. Slotted text is read into `label`, and nested HTML is stripped with a console warning - use the `label` prop for the text and the `icon` prop for the glyph.\n\n```html\n<!-- INCORRECT -->\n<mds-tab-bar-item icon=\"mi/baseline/inbox\">Messaggi</mds-tab-bar-item>\n<mds-tab-bar-item>\n <span class=\"bold\">Messaggi</span>\n <small>(3)</small>\n</mds-tab-bar-item>\n\n<!-- CORRECT -->\n<mds-tab-bar-item icon=\"mi/baseline/inbox\" label=\"Messaggi\"></mds-tab-bar-item>\n```\n\n#### Do Not Slot `<mds-icon>` to Add an Icon\n\nThe item's `icon` prop renders the glyph through the shared icon service and positions it correctly above the label. Slotting `<mds-icon>` puts it in the deprecated default slot, where it is misaligned or stripped.\n\n```html\n<!-- INCORRECT -->\n<mds-tab-bar-item>\n <mds-icon name=\"mi/baseline/home\"></mds-icon>\n Home\n</mds-tab-bar-item>\n\n<!-- CORRECT -->\n<mds-tab-bar-item icon=\"mi/baseline/home\" label=\"Home\"></mds-tab-bar-item>\n```\n\n#### Do Not Set `selected=\"false\"` to Deselect an Item\n\n`selected` is a boolean attribute. The item happens to style `selected=\"false\"` as unselected, but the attribute stays on the element and contradicts the state for attribute selectors and checks. Remove the attribute entirely to deselect an item, or let the parent coordinate selection automatically.\n\n```html\n<!-- INCORRECT -->\n<mds-tab-bar-item icon=\"mi/baseline/home\" label=\"Home\" selected=\"false\"></mds-tab-bar-item>\n\n<!-- CORRECT -->\n<mds-tab-bar-item icon=\"mi/baseline/home\" label=\"Home\"></mds-tab-bar-item>\n```\n\n#### Do Not Listen for the Item's Internal Event on the Bar's Children\n\n`mdsTabBarItemSelect` is the item-level event `<mds-tab-bar>` coordinates on: its `detail` is the item's `id`, the one you gave it or the `mds-tab-bar-item-<index>` the bar gives an item without one. To react to selection changes from outside, listen for `mdsTabBarChange` on the parent instead, whose `detail.index` is the position of the selected item.\n\n```html\n<!-- INCORRECT -->\n<script>\n document.querySelector('mds-tab-bar-item').addEventListener('mdsTabBarItemSelect', handler);\n</script>\n\n<!-- CORRECT -->\n<script>\n document.querySelector('mds-tab-bar').addEventListener('mdsTabBarChange', (e) => {\n handler(e.detail.index);\n });\n</script>\n```\n\n#### Do Not Style Items by Piercing Shadow DOM\n\nThe only supported customization surface is the two public `--mds-tab-bar-item-*` CSS custom properties, `--mds-tab-bar-item-background` and `--mds-tab-bar-item-color` (the icon follows the text colour). Targeting internal nodes via `::part()`, `>>>`, or undocumented class names couples your code to the Shadow DOM implementation and will break on minor releases.\n\n```css\n/* INCORRECT */\nmds-tab-bar-item >>> mds-icon {\n fill: hotpink;\n}\n\n/* CORRECT */\nmds-tab-bar mds-tab-bar-item {\n --mds-tab-bar-item-color: rgb(var(--magma-text-muted));\n}\n```\n"
24
28
  },
25
29
  "props": [],
26
30
  "methods": [],
@@ -2,6 +2,7 @@ import { Host, h } from "@stencil/core";
2
2
  import { preferenceStore } from "../../common/preference";
3
3
  /**
4
4
  * @slot - Add `mds-tab-bar-item` element/s.
5
+ * @category navigation
5
6
  */
6
7
  export class MdsTabBar {
7
8
  constructor() {
@@ -27,7 +28,7 @@ export class MdsTabBar {
27
28
  });
28
29
  }
29
30
  render() {
30
- return (h(Host, { key: 'b4e6ca24b863ae73e7676473d82baf007e75acad', "pref-animation": preferenceStore.state.animation, "pref-contrast": preferenceStore.state.contrast, "pref-mode": preferenceStore.state.mode, "pref-theme-scheme": preferenceStore.state['theme-scheme'] }, h("slot", { key: 'a919f92ebae8394fcf2bbb914fbdbfcebc677bd6' })));
31
+ return (h(Host, { key: '5a04aa368abd7d8d5edc3503695458f50c774951', "pref-animation": preferenceStore.state.animation, "pref-contrast": preferenceStore.state.contrast, "pref-mode": preferenceStore.state.mode, "pref-theme-scheme": preferenceStore.state['theme-scheme'] }, h("slot", { key: 'bea3c60dd89c0e1278cde0b223ee8c73cd350b03' })));
31
32
  }
32
33
  static get is() { return "mds-tab-bar"; }
33
34
  static get encapsulation() { return "shadow"; }
@@ -72,12 +72,12 @@ Use `typography` on individual items to match the text density to the surroundin
72
72
 
73
73
  #### Styling Customization via CSS Custom Properties
74
74
 
75
- Style individual items through the documented `--mds-tab-bar-item-*` CSS custom properties. Set them on the specific item or on a parent selector. Use semantic color roles via `rgb(var(--magma-<role>))` so dark mode and high-contrast keep working.
75
+ Style individual items through the public `--mds-tab-bar-item-*` CSS custom properties: the background and the text colour of the item at rest (the selected item keeps its accent colouring). Set them on the specific item or on a parent selector. Use semantic color roles via `rgb(var(--magma-<role>))` so dark mode and high-contrast keep working.
76
76
 
77
77
  ```css
78
- /* Brand-specific active color for the whole bar */
78
+ /* A resting background for the whole bar */
79
79
  mds-tab-bar mds-tab-bar-item {
80
- --mds-tab-bar-item-color-selected: rgb(var(--magma-accent-fg));
80
+ --mds-tab-bar-item-background: rgb(var(--magma-wash-base));
81
81
  }
82
82
 
83
83
  /* A single item with a distinct idle color */
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-tab-bar-item
8
8
 
9
- > `@maggioli-design-system/magma` 2.5.0. Shadow DOM: style it only through the CSS custom properties and parts below.
9
+ > `@maggioli-design-system/magma` 2.6.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
10
10
 
11
11
  The `<mds-tab-bar-item>` web component is a single selectable tab within the [`<mds-tab-bar>`](../mds-tab-bar/AGENTS.md) container. It renders an icon stacked over a text label and acts as one option in the bar's mutually-exclusive selection group.
12
12
 
@@ -24,7 +24,7 @@ The `<mds-tab-bar-item>` web component is a single selectable tab within the [`<
24
24
  - **`selected`**: Marks this item as the active tab. You typically do not toggle it manually at runtime - the parent manages it - but you can set it on one item as the initial active tab.
25
25
  - **`typography`**: Controls the label's text style, constrained to the smaller typography set (`tip` by default, or `option`). Pick `option` for a slightly more prominent label.
26
26
 
27
- The active vs. resting appearance is configured through the `--mds-tab-bar-item-*` CSS custom properties (background and color, each with a `-selected` variant) listed in [`AGENTS.md`](AGENTS.md).
27
+ The resting appearance is configured through the public `--mds-tab-bar-item-background` and `--mds-tab-bar-item-color` CSS custom properties listed in [`AGENTS.md`](AGENTS.md); the selected item keeps its own accent colouring.
28
28
 
29
29
  ## Read next
30
30
 
@@ -58,9 +58,9 @@ The active vs. resting appearance is configured through the `--mds-tab-bar-item-
58
58
  | Property | Description |
59
59
  | --- | --- |
60
60
  | `--mds-tab-bar-item-background` | Sets the background-color of the component |
61
- | `--mds-tab-bar-item-background-selected` | Sets the background-color of the component when it's selected |
62
61
  | `--mds-tab-bar-item-color` | Sets the text color of the component |
63
- | `--mds-tab-bar-item-color-selected` | Sets the text color of the component when it's selected |
62
+
63
+ Only these are public. Its other 2 are internal: they may change in any release, do not set them.
64
64
 
65
65
  ## Dependencies
66
66