@maggioli-design-system/magma 2.11.0 → 2.12.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 (1228) hide show
  1. package/AGENTS.md +2 -2
  2. package/CHANGELOG.md +38 -0
  3. package/README.md +9 -6
  4. package/agents/color.md +1 -0
  5. package/agents/mcp.md +5 -5
  6. package/agents/patterns/actions.md +4 -3
  7. package/agents/patterns/app-shell.md +70 -22
  8. package/agents/patterns/density.md +4 -3
  9. package/agents/patterns/previews/app-shell/back-office.dark.webp +0 -0
  10. package/agents/patterns/previews/app-shell/back-office.html +2 -2
  11. package/agents/patterns/previews/app-shell/back-office.light.webp +0 -0
  12. package/agents/patterns/previews/app-shell/many-sections.html +1 -1
  13. package/agents/patterns/previews/app-shell/public-service.dark.webp +0 -0
  14. package/agents/patterns/previews/app-shell/public-service.html +2 -2
  15. package/agents/patterns/previews/app-shell/public-service.light.webp +0 -0
  16. package/agents/patterns/previews/app-shell/section-menus.dark.webp +0 -0
  17. package/agents/patterns/previews/app-shell/section-menus.html +68 -0
  18. package/agents/patterns/previews/app-shell/section-menus.light.webp +0 -0
  19. package/agents/patterns/previews/empty-state/not-found.dark.webp +0 -0
  20. package/agents/patterns/previews/empty-state/not-found.html +2 -2
  21. package/agents/patterns/previews/empty-state/not-found.light.webp +0 -0
  22. package/agents/patterns/previews/item-list/queue-of-a-desk.dark.webp +0 -0
  23. package/agents/patterns/previews/item-list/queue-of-a-desk.light.webp +0 -0
  24. package/agents/patterns/previews/item-list/requests-of-an-office.dark.webp +0 -0
  25. package/agents/patterns/previews/item-list/requests-of-an-office.light.webp +0 -0
  26. package/agents/patterns/previews/list-with-filters/act-on-many.dark.webp +0 -0
  27. package/agents/patterns/previews/list-with-filters/act-on-many.html +2 -2
  28. package/agents/patterns/previews/list-with-filters/act-on-many.light.webp +0 -0
  29. package/agents/patterns/previews/list-with-filters/find-and-open.dark.webp +0 -0
  30. package/agents/patterns/previews/list-with-filters/find-and-open.html +2 -2
  31. package/agents/patterns/previews/list-with-filters/find-and-open.light.webp +0 -0
  32. package/agents/patterns/previews/list-with-filters/show-new-items.dark.webp +0 -0
  33. package/agents/patterns/previews/list-with-filters/show-new-items.html +2 -2
  34. package/agents/patterns/previews/list-with-filters/show-new-items.light.webp +0 -0
  35. package/agents/patterns/previews/loading/first-load.dark.webp +0 -0
  36. package/agents/patterns/previews/loading/first-load.light.webp +0 -0
  37. package/agents/patterns/previews/loading/keep-while-reloading.dark.webp +0 -0
  38. package/agents/patterns/previews/loading/keep-while-reloading.light.webp +0 -0
  39. package/agents/patterns/previews/loading/long-load-measured.dark.webp +0 -0
  40. package/agents/patterns/previews/loading/long-load-measured.light.webp +0 -0
  41. package/agents/patterns/previews/loading/long-load.dark.webp +0 -0
  42. package/agents/patterns/previews/loading/long-load.light.webp +0 -0
  43. package/agents/patterns/previews/message-placement/action-failed-elsewhere.light.webp +0 -0
  44. package/agents/patterns/previews/message-placement/app-failed.dark.webp +0 -0
  45. package/agents/patterns/previews/message-placement/app-failed.html +2 -2
  46. package/agents/patterns/previews/message-placement/app-failed.light.webp +0 -0
  47. package/agents/patterns/previews/record-detail/ask-for-words.dark.webp +0 -0
  48. package/agents/patterns/previews/record-detail/ask-for-words.html +2 -2
  49. package/agents/patterns/previews/record-detail/ask-for-words.light.webp +0 -0
  50. package/agents/patterns/previews/record-detail/edit-data.dark.webp +0 -0
  51. package/agents/patterns/previews/record-detail/edit-data.html +2 -2
  52. package/agents/patterns/previews/record-detail/edit-data.light.webp +0 -0
  53. package/agents/patterns/previews/record-detail/read-the-data.dark.webp +0 -0
  54. package/agents/patterns/previews/record-detail/read-the-data.html +2 -2
  55. package/agents/patterns/previews/record-detail/read-the-data.light.webp +0 -0
  56. package/agents/patterns/previews/record-detail/record-changed.dark.webp +0 -0
  57. package/agents/patterns/previews/record-detail/record-changed.html +2 -2
  58. package/agents/patterns/previews/record-detail/record-changed.light.webp +0 -0
  59. package/agents/patterns/previews/record-detail/run-at-once.dark.webp +0 -0
  60. package/agents/patterns/previews/record-detail/run-at-once.html +2 -2
  61. package/agents/patterns/previews/record-detail/run-at-once.light.webp +0 -0
  62. package/agents/patterns/previews/record-detail/work-on-it.dark.webp +0 -0
  63. package/agents/patterns/previews/record-detail/work-on-it.html +2 -2
  64. package/agents/patterns/previews/record-detail/work-on-it.light.webp +0 -0
  65. package/agents/patterns/previews/surfaces/band.dark.webp +0 -0
  66. package/agents/patterns/previews/surfaces/band.html +2 -2
  67. package/agents/patterns/previews/surfaces/band.light.webp +0 -0
  68. package/agents/patterns/previews/surfaces/canvas.dark.webp +0 -0
  69. package/agents/patterns/previews/surfaces/canvas.html +2 -2
  70. package/agents/patterns/previews/surfaces/canvas.light.webp +0 -0
  71. package/agents/patterns/previews/titles/page.dark.webp +0 -0
  72. package/agents/patterns/previews/widths/page.dark.webp +0 -0
  73. package/agents/patterns/previews/widths/page.html +2 -2
  74. package/agents/patterns/previews/widths/page.light.webp +0 -0
  75. package/agents/patterns/rhythm.md +2 -1
  76. package/agents/patterns/surfaces.md +4 -3
  77. package/agents/patterns/titles.md +4 -3
  78. package/agents/patterns/widths.md +4 -3
  79. package/agents/patterns.md +8 -7
  80. package/agents/theming.md +7 -0
  81. package/dist/cjs/{aria-CzO5Rp1y.js → aria-r1anAHBr.js} +12 -0
  82. package/dist/cjs/{floating-controller-DaFymQCT.js → floating-controller-B4YhrWm8.js} +1 -1
  83. package/dist/cjs/{index-Bg68W-da.js → index-Csgx951d.js} +1 -1
  84. package/dist/cjs/loader.cjs.js +1 -1
  85. package/dist/cjs/{locale-CaR39iYg.js → locale-DgMC52AD.js} +1 -1
  86. package/dist/cjs/magma-components.cjs.js +1 -1
  87. package/dist/cjs/mds-accordion-item.cjs.entry.js +1 -1
  88. package/dist/cjs/mds-accordion-timer-item.cjs.entry.js +1 -1
  89. package/dist/cjs/mds-accordion.cjs.entry.js +1 -1
  90. package/dist/cjs/mds-avatar.cjs.entry.js +1 -1
  91. package/dist/cjs/mds-badge.cjs.entry.js +2 -2
  92. package/dist/cjs/mds-banner_3.cjs.entry.js +5 -5
  93. package/dist/cjs/mds-book.cjs.entry.js +2 -2
  94. package/dist/cjs/mds-breadcrumb.cjs.entry.js +2 -2
  95. package/dist/cjs/mds-button-dropdown.cjs.entry.js +6 -4
  96. package/dist/cjs/mds-button-group.cjs.entry.js +1 -1
  97. package/dist/cjs/mds-button_3.cjs.entry.js +78 -16
  98. package/dist/cjs/mds-calendar_2.cjs.entry.js +8 -8
  99. package/dist/cjs/mds-card-content.cjs.entry.js +1 -1
  100. package/dist/cjs/mds-card-footer.cjs.entry.js +1 -1
  101. package/dist/cjs/mds-card-header.cjs.entry.js +1 -1
  102. package/dist/cjs/mds-card-media.cjs.entry.js +1 -1
  103. package/dist/cjs/mds-card.cjs.entry.js +2 -2
  104. package/dist/cjs/mds-details.cjs.entry.js +2 -2
  105. package/dist/cjs/mds-dropdown.cjs.entry.js +6 -6
  106. package/dist/cjs/mds-emoji.cjs.entry.js +2 -2
  107. package/dist/cjs/mds-entity.cjs.entry.js +2 -2
  108. package/dist/cjs/mds-file-preview.cjs.entry.js +5 -5
  109. package/dist/cjs/mds-file.cjs.entry.js +5 -5
  110. package/dist/cjs/mds-filter-item.cjs.entry.js +5 -5
  111. package/dist/cjs/mds-filter.cjs.entry.js +4 -4
  112. package/dist/cjs/mds-header-bar.cjs.entry.js +3 -3
  113. package/dist/cjs/mds-header.cjs.entry.js +3 -3
  114. package/dist/cjs/mds-horizontal-scroll.cjs.entry.js +3 -3
  115. package/dist/cjs/mds-hr.cjs.entry.js +2 -2
  116. package/dist/cjs/mds-img.cjs.entry.js +2 -2
  117. package/dist/cjs/mds-input-date-range-preselection.cjs.entry.js +1 -1
  118. package/dist/cjs/mds-input-date-range.cjs.entry.js +4 -4
  119. package/dist/cjs/mds-input-date.cjs.entry.js +6 -6
  120. package/dist/cjs/mds-input-field.cjs.entry.js +1 -1
  121. package/dist/cjs/mds-input-otp.cjs.entry.js +3 -3
  122. package/dist/cjs/mds-input-range.cjs.entry.js +3 -3
  123. package/dist/cjs/mds-input-select.cjs.entry.js +6 -6
  124. package/dist/cjs/mds-input-switch_2.cjs.entry.js +6 -6
  125. package/dist/cjs/mds-input-tip_2.cjs.entry.js +5 -5
  126. package/dist/cjs/mds-input-upload.cjs.entry.js +7 -7
  127. package/dist/cjs/mds-input.cjs.entry.js +8 -8
  128. package/dist/cjs/mds-keyboard-key.cjs.entry.js +3 -3
  129. package/dist/cjs/mds-keyboard.cjs.entry.js +4 -4
  130. package/dist/cjs/mds-kpi-item.cjs.entry.js +3 -3
  131. package/dist/cjs/mds-kpi.cjs.entry.js +1 -1
  132. package/dist/cjs/mds-label.cjs.entry.js +3 -3
  133. package/dist/cjs/mds-link.cjs.entry.js +5 -5
  134. package/dist/cjs/mds-list-item.cjs.entry.js +1 -1
  135. package/dist/cjs/mds-list.cjs.entry.js +1 -1
  136. package/dist/cjs/mds-mention.cjs.entry.js +3 -3
  137. package/dist/cjs/mds-modal.cjs.entry.js +34 -15
  138. package/dist/cjs/mds-note.cjs.entry.js +4 -4
  139. package/dist/cjs/mds-notification.cjs.entry.js +3 -3
  140. package/dist/cjs/mds-paginator-item.cjs.entry.js +2 -2
  141. package/dist/cjs/mds-paginator.cjs.entry.js +4 -4
  142. package/dist/cjs/mds-policy-ai.cjs.entry.js +3 -3
  143. package/dist/cjs/mds-pref-animation.cjs.entry.js +3 -3
  144. package/dist/cjs/mds-pref-consumption.cjs.entry.js +3 -3
  145. package/dist/cjs/mds-pref-contrast.cjs.entry.js +3 -3
  146. package/dist/cjs/mds-pref-language-item.cjs.entry.js +3 -3
  147. package/dist/cjs/mds-pref-language.cjs.entry.js +3 -3
  148. package/dist/cjs/mds-pref-mode.cjs.entry.js +22 -13
  149. package/dist/cjs/mds-pref-theme-item.cjs.entry.js +1 -1
  150. package/dist/cjs/mds-pref-theme.cjs.entry.js +31 -8
  151. package/dist/cjs/mds-pref.cjs.entry.js +3 -25
  152. package/dist/cjs/mds-price-table-features-cell.cjs.entry.js +3 -3
  153. package/dist/cjs/mds-price-table-features-row.cjs.entry.js +3 -3
  154. package/dist/cjs/mds-price-table-features.cjs.entry.js +2 -2
  155. package/dist/cjs/mds-price-table-header.cjs.entry.js +1 -1
  156. package/dist/cjs/mds-price-table-list-item.cjs.entry.js +1 -1
  157. package/dist/cjs/mds-price-table-list.cjs.entry.js +3 -3
  158. package/dist/cjs/mds-price-table.cjs.entry.js +1 -1
  159. package/dist/cjs/mds-progress_2.cjs.entry.js +4 -4
  160. package/dist/cjs/mds-push-notification-item.cjs.entry.js +4 -4
  161. package/dist/cjs/mds-push-notification.cjs.entry.js +4 -4
  162. package/dist/cjs/mds-quote.cjs.entry.js +2 -2
  163. package/dist/cjs/mds-radial-menu-item.cjs.entry.js +1 -1
  164. package/dist/cjs/mds-radial-menu.cjs.entry.js +5 -5
  165. package/dist/cjs/mds-separator.cjs.entry.js +2 -2
  166. package/dist/cjs/mds-status-bar.cjs.entry.js +3 -3
  167. package/dist/cjs/mds-stepper-bar-item.cjs.entry.js +3 -3
  168. package/dist/cjs/mds-stepper-bar.cjs.entry.js +1 -1
  169. package/dist/cjs/mds-tab-bar-item.cjs.entry.js +4 -4
  170. package/dist/cjs/mds-tab-bar.cjs.entry.js +3 -3
  171. package/dist/cjs/mds-tab_2.cjs.entry.js +6 -6
  172. package/dist/cjs/mds-table-body.cjs.entry.js +2 -2
  173. package/dist/cjs/mds-table-footer.cjs.entry.js +2 -2
  174. package/dist/cjs/mds-table-header-cell.cjs.entry.js +2 -2
  175. package/dist/cjs/mds-table-header.cjs.entry.js +3 -3
  176. package/dist/cjs/mds-table-row.cjs.entry.js +4 -4
  177. package/dist/cjs/mds-table.cjs.entry.js +4 -4
  178. package/dist/cjs/mds-text.cjs.entry.js +2 -2
  179. package/dist/cjs/mds-toast-region.cjs.entry.js +1 -1
  180. package/dist/cjs/mds-toast.cjs.entry.js +3 -3
  181. package/dist/cjs/mds-tooltip.cjs.entry.js +5 -5
  182. package/dist/cjs/mds-tree-item.cjs.entry.js +3 -3
  183. package/dist/cjs/mds-tree.cjs.entry.js +1 -1
  184. package/dist/cjs/mds-url-view.cjs.entry.js +4 -4
  185. package/dist/cjs/mds-usage.cjs.entry.js +4 -4
  186. package/dist/cjs/mds-video-wall.cjs.entry.js +2 -2
  187. package/dist/cjs/mds-zero.cjs.entry.js +3 -3
  188. package/dist/cjs/{preference-CQQ3eb9W.js → preference-DhNxLZ4R.js} +20 -0
  189. package/dist/collection/common/aria.js +12 -1
  190. package/dist/collection/common/preference.js +19 -1
  191. package/dist/collection/components/mds-accordion/AGENTS.md +1 -1
  192. package/dist/collection/components/mds-accordion/documentation.json +1 -1
  193. package/dist/collection/components/mds-accordion-item/AGENTS.md +1 -1
  194. package/dist/collection/components/mds-accordion-item/documentation.json +1 -1
  195. package/dist/collection/components/mds-accordion-timer/AGENTS.md +1 -1
  196. package/dist/collection/components/mds-accordion-timer/documentation.json +1 -1
  197. package/dist/collection/components/mds-accordion-timer-item/AGENTS.md +1 -1
  198. package/dist/collection/components/mds-accordion-timer-item/documentation.json +1 -1
  199. package/dist/collection/components/mds-author/AGENTS.md +1 -1
  200. package/dist/collection/components/mds-author/documentation.json +1 -1
  201. package/dist/collection/components/mds-avatar/AGENTS.md +1 -1
  202. package/dist/collection/components/mds-avatar/documentation.json +2 -2
  203. package/dist/collection/components/mds-avatar-stack/AGENTS.md +1 -1
  204. package/dist/collection/components/mds-avatar-stack/documentation.json +2 -2
  205. package/dist/collection/components/mds-avatar-stack-item/AGENTS.md +1 -1
  206. package/dist/collection/components/mds-avatar-stack-item/documentation.json +2 -2
  207. package/dist/collection/components/mds-badge/AGENTS.md +1 -1
  208. package/dist/collection/components/mds-badge/documentation.json +1 -1
  209. package/dist/collection/components/mds-badge/mds-badge.css +15 -10
  210. package/dist/collection/components/mds-banner/AGENTS.md +1 -1
  211. package/dist/collection/components/mds-banner/documentation.json +2 -2
  212. package/dist/collection/components/mds-benchmark-bar/AGENTS.md +1 -1
  213. package/dist/collection/components/mds-benchmark-bar/documentation.json +1 -1
  214. package/dist/collection/components/mds-bibliography/AGENTS.md +1 -1
  215. package/dist/collection/components/mds-bibliography/documentation.json +1 -1
  216. package/dist/collection/components/mds-book/AGENTS.md +1 -1
  217. package/dist/collection/components/mds-book/documentation.json +1 -1
  218. package/dist/collection/components/mds-breadcrumb/AGENTS.md +1 -1
  219. package/dist/collection/components/mds-breadcrumb/documentation.json +2 -2
  220. package/dist/collection/components/mds-breadcrumb-item/AGENTS.md +1 -1
  221. package/dist/collection/components/mds-breadcrumb-item/documentation.json +2 -2
  222. package/dist/collection/components/mds-button/AGENTS.md +9 -4
  223. package/dist/collection/components/mds-button/documentation.json +100 -7
  224. package/dist/collection/components/mds-button/examples.md +73 -0
  225. package/dist/collection/components/mds-button/mds-button.css +122 -14
  226. package/dist/collection/components/mds-button/mds-button.js +139 -13
  227. package/dist/collection/components/mds-button/mistakes.md +35 -0
  228. package/dist/collection/components/mds-button-dropdown/AGENTS.md +7 -2
  229. package/dist/collection/components/mds-button-dropdown/documentation.json +97 -4
  230. package/dist/collection/components/mds-button-dropdown/mds-button-dropdown.js +69 -3
  231. package/dist/collection/components/mds-button-group/AGENTS.md +1 -1
  232. package/dist/collection/components/mds-button-group/documentation.json +1 -1
  233. package/dist/collection/components/mds-button-group/mds-button-group.js +1 -1
  234. package/dist/collection/components/mds-calendar/AGENTS.md +1 -1
  235. package/dist/collection/components/mds-calendar/documentation.json +2 -2
  236. package/dist/collection/components/mds-calendar/mds-calendar.js +5 -5
  237. package/dist/collection/components/mds-calendar-cell/AGENTS.md +1 -1
  238. package/dist/collection/components/mds-calendar-cell/documentation.json +2 -2
  239. package/dist/collection/components/mds-calendar-cell/mds-calendar-cell.js +1 -1
  240. package/dist/collection/components/mds-card/AGENTS.md +1 -1
  241. package/dist/collection/components/mds-card/documentation.json +1 -1
  242. package/dist/collection/components/mds-card/mds-card.js +1 -1
  243. package/dist/collection/components/mds-card-content/AGENTS.md +1 -1
  244. package/dist/collection/components/mds-card-content/documentation.json +1 -1
  245. package/dist/collection/components/mds-card-content/mds-card-content.js +1 -1
  246. package/dist/collection/components/mds-card-footer/AGENTS.md +1 -1
  247. package/dist/collection/components/mds-card-footer/documentation.json +1 -1
  248. package/dist/collection/components/mds-card-footer/mds-card-footer.js +1 -1
  249. package/dist/collection/components/mds-card-header/AGENTS.md +1 -1
  250. package/dist/collection/components/mds-card-header/documentation.json +1 -1
  251. package/dist/collection/components/mds-card-header/mds-card-header.js +1 -1
  252. package/dist/collection/components/mds-card-media/AGENTS.md +1 -1
  253. package/dist/collection/components/mds-card-media/documentation.json +1 -1
  254. package/dist/collection/components/mds-card-media/mds-card-media.js +1 -1
  255. package/dist/collection/components/mds-chip/AGENTS.md +1 -1
  256. package/dist/collection/components/mds-chip/documentation.json +2 -2
  257. package/dist/collection/components/mds-chip/mds-chip.css +3 -2
  258. package/dist/collection/components/mds-chip/mds-chip.js +1 -1
  259. package/dist/collection/components/mds-details/AGENTS.md +1 -1
  260. package/dist/collection/components/mds-details/documentation.json +1 -1
  261. package/dist/collection/components/mds-details/mds-details.js +1 -1
  262. package/dist/collection/components/mds-dropdown/AGENTS.md +1 -1
  263. package/dist/collection/components/mds-dropdown/documentation.json +1 -1
  264. package/dist/collection/components/mds-dropdown/mds-dropdown.css +12 -14
  265. package/dist/collection/components/mds-dropdown/mds-dropdown.js +2 -2
  266. package/dist/collection/components/mds-emoji/AGENTS.md +1 -1
  267. package/dist/collection/components/mds-emoji/documentation.json +1 -1
  268. package/dist/collection/components/mds-emoji/mds-emoji.js +1 -1
  269. package/dist/collection/components/mds-entity/AGENTS.md +1 -1
  270. package/dist/collection/components/mds-entity/documentation.json +2 -2
  271. package/dist/collection/components/mds-entity/mds-entity.js +1 -1
  272. package/dist/collection/components/mds-file/AGENTS.md +1 -1
  273. package/dist/collection/components/mds-file/documentation.json +1 -1
  274. package/dist/collection/components/mds-file/mds-file.css +3 -2
  275. package/dist/collection/components/mds-file/mds-file.js +1 -1
  276. package/dist/collection/components/mds-file-preview/AGENTS.md +1 -1
  277. package/dist/collection/components/mds-file-preview/documentation.json +2 -2
  278. package/dist/collection/components/mds-file-preview/mds-file-preview.css +3 -2
  279. package/dist/collection/components/mds-file-preview/mds-file-preview.js +2 -2
  280. package/dist/collection/components/mds-filter/AGENTS.md +1 -1
  281. package/dist/collection/components/mds-filter/documentation.json +1 -1
  282. package/dist/collection/components/mds-filter/mds-filter.css +3 -2
  283. package/dist/collection/components/mds-filter/mds-filter.js +1 -1
  284. package/dist/collection/components/mds-filter-item/AGENTS.md +1 -1
  285. package/dist/collection/components/mds-filter-item/documentation.json +1 -1
  286. package/dist/collection/components/mds-filter-item/mds-filter-item.css +3 -2
  287. package/dist/collection/components/mds-filter-item/mds-filter-item.js +1 -1
  288. package/dist/collection/components/mds-header/AGENTS.md +1 -1
  289. package/dist/collection/components/mds-header/documentation.json +2 -2
  290. package/dist/collection/components/mds-header/mds-header.css +3 -2
  291. package/dist/collection/components/mds-header/mds-header.js +1 -1
  292. package/dist/collection/components/mds-header-bar/AGENTS.md +1 -1
  293. package/dist/collection/components/mds-header-bar/documentation.json +2 -2
  294. package/dist/collection/components/mds-header-bar/mds-header-bar.js +1 -1
  295. package/dist/collection/components/mds-help/AGENTS.md +1 -1
  296. package/dist/collection/components/mds-help/documentation.json +1 -1
  297. package/dist/collection/components/mds-help/mds-help.js +1 -1
  298. package/dist/collection/components/mds-horizontal-scroll/AGENTS.md +1 -1
  299. package/dist/collection/components/mds-horizontal-scroll/documentation.json +2 -2
  300. package/dist/collection/components/mds-horizontal-scroll/mds-horizontal-scroll.js +1 -1
  301. package/dist/collection/components/mds-hr/AGENTS.md +1 -1
  302. package/dist/collection/components/mds-hr/documentation.json +1 -1
  303. package/dist/collection/components/mds-hr/mds-hr.js +1 -1
  304. package/dist/collection/components/mds-icon/AGENTS.md +1 -1
  305. package/dist/collection/components/mds-icon/documentation.json +1 -1
  306. package/dist/collection/components/mds-icon/mds-icon.js +1 -1
  307. package/dist/collection/components/mds-img/AGENTS.md +1 -1
  308. package/dist/collection/components/mds-img/documentation.json +2 -2
  309. package/dist/collection/components/mds-input/AGENTS.md +1 -1
  310. package/dist/collection/components/mds-input/documentation.json +2 -2
  311. package/dist/collection/components/mds-input/mds-input.css +16 -8
  312. package/dist/collection/components/mds-input/mds-input.js +3 -3
  313. package/dist/collection/components/mds-input-date/AGENTS.md +1 -1
  314. package/dist/collection/components/mds-input-date/documentation.json +2 -2
  315. package/dist/collection/components/mds-input-date/mds-input-date.css +3 -2
  316. package/dist/collection/components/mds-input-date/mds-input-date.js +2 -2
  317. package/dist/collection/components/mds-input-date-range/AGENTS.md +1 -1
  318. package/dist/collection/components/mds-input-date-range/documentation.json +2 -2
  319. package/dist/collection/components/mds-input-date-range/mds-input-date-range.css +3 -2
  320. package/dist/collection/components/mds-input-date-range-preselection/AGENTS.md +1 -1
  321. package/dist/collection/components/mds-input-date-range-preselection/documentation.json +2 -2
  322. package/dist/collection/components/mds-input-date-range-preselection/mds-input-date-range-preselection.js +1 -1
  323. package/dist/collection/components/mds-input-field/AGENTS.md +1 -1
  324. package/dist/collection/components/mds-input-field/documentation.json +1 -1
  325. package/dist/collection/components/mds-input-field/mds-input-field.js +1 -1
  326. package/dist/collection/components/mds-input-otp/AGENTS.md +1 -1
  327. package/dist/collection/components/mds-input-otp/documentation.json +2 -2
  328. package/dist/collection/components/mds-input-otp/mds-input-otp.js +1 -1
  329. package/dist/collection/components/mds-input-range/AGENTS.md +1 -1
  330. package/dist/collection/components/mds-input-range/documentation.json +1 -1
  331. package/dist/collection/components/mds-input-range/mds-input-range.css +3 -2
  332. package/dist/collection/components/mds-input-range/mds-input-range.js +1 -1
  333. package/dist/collection/components/mds-input-select/AGENTS.md +1 -1
  334. package/dist/collection/components/mds-input-select/documentation.json +1 -1
  335. package/dist/collection/components/mds-input-select/mds-input-select.css +15 -11
  336. package/dist/collection/components/mds-input-select/mds-input-select.js +2 -2
  337. package/dist/collection/components/mds-input-switch/AGENTS.md +1 -1
  338. package/dist/collection/components/mds-input-switch/documentation.json +1 -1
  339. package/dist/collection/components/mds-input-switch/mds-input-switch.css +3 -2
  340. package/dist/collection/components/mds-input-switch/mds-input-switch.js +1 -1
  341. package/dist/collection/components/mds-input-tip/AGENTS.md +1 -1
  342. package/dist/collection/components/mds-input-tip/documentation.json +1 -1
  343. package/dist/collection/components/mds-input-tip/mds-input-tip.js +1 -1
  344. package/dist/collection/components/mds-input-tip-item/AGENTS.md +1 -1
  345. package/dist/collection/components/mds-input-tip-item/documentation.json +1 -1
  346. package/dist/collection/components/mds-input-tip-item/mds-input-tip-item.js +2 -2
  347. package/dist/collection/components/mds-input-upload/AGENTS.md +1 -1
  348. package/dist/collection/components/mds-input-upload/documentation.json +2 -2
  349. package/dist/collection/components/mds-input-upload/mds-input-upload.js +5 -5
  350. package/dist/collection/components/mds-keyboard/AGENTS.md +1 -1
  351. package/dist/collection/components/mds-keyboard/documentation.json +2 -2
  352. package/dist/collection/components/mds-keyboard/mds-keyboard.css +3 -2
  353. package/dist/collection/components/mds-keyboard/mds-keyboard.js +1 -1
  354. package/dist/collection/components/mds-keyboard-key/AGENTS.md +1 -1
  355. package/dist/collection/components/mds-keyboard-key/documentation.json +1 -1
  356. package/dist/collection/components/mds-keyboard-key/mds-keyboard-key.js +1 -1
  357. package/dist/collection/components/mds-kpi/AGENTS.md +1 -1
  358. package/dist/collection/components/mds-kpi/documentation.json +1 -1
  359. package/dist/collection/components/mds-kpi/mds-kpi.js +1 -1
  360. package/dist/collection/components/mds-kpi-item/AGENTS.md +1 -1
  361. package/dist/collection/components/mds-kpi-item/documentation.json +1 -1
  362. package/dist/collection/components/mds-kpi-item/mds-kpi-item.css +9 -6
  363. package/dist/collection/components/mds-kpi-item/mds-kpi-item.js +1 -1
  364. package/dist/collection/components/mds-label/AGENTS.md +1 -1
  365. package/dist/collection/components/mds-label/documentation.json +2 -2
  366. package/dist/collection/components/mds-label/mds-label.css +3 -2
  367. package/dist/collection/components/mds-link/AGENTS.md +1 -1
  368. package/dist/collection/components/mds-link/documentation.json +1 -1
  369. package/dist/collection/components/mds-link/mds-link.js +3 -3
  370. package/dist/collection/components/mds-list/AGENTS.md +1 -1
  371. package/dist/collection/components/mds-list/documentation.json +1 -1
  372. package/dist/collection/components/mds-list/mds-list.js +1 -1
  373. package/dist/collection/components/mds-list-item/AGENTS.md +1 -1
  374. package/dist/collection/components/mds-list-item/documentation.json +1 -1
  375. package/dist/collection/components/mds-list-item/mds-list-item.js +1 -1
  376. package/dist/collection/components/mds-mention/AGENTS.md +1 -1
  377. package/dist/collection/components/mds-mention/documentation.json +2 -2
  378. package/dist/collection/components/mds-mention/mds-mention.js +1 -1
  379. package/dist/collection/components/mds-modal/AGENTS.md +3 -3
  380. package/dist/collection/components/mds-modal/documentation.json +4 -4
  381. package/dist/collection/components/mds-modal/mds-modal.css +3 -2
  382. package/dist/collection/components/mds-modal/mds-modal.js +32 -13
  383. package/dist/collection/components/mds-note/AGENTS.md +1 -1
  384. package/dist/collection/components/mds-note/documentation.json +2 -2
  385. package/dist/collection/components/mds-note/mds-note.css +3 -2
  386. package/dist/collection/components/mds-note/mds-note.js +1 -1
  387. package/dist/collection/components/mds-notification/AGENTS.md +1 -1
  388. package/dist/collection/components/mds-notification/documentation.json +1 -1
  389. package/dist/collection/components/mds-notification/mds-notification.js +1 -1
  390. package/dist/collection/components/mds-paginator/AGENTS.md +1 -1
  391. package/dist/collection/components/mds-paginator/documentation.json +1 -1
  392. package/dist/collection/components/mds-paginator/mds-paginator.css +3 -2
  393. package/dist/collection/components/mds-paginator/mds-paginator.js +1 -1
  394. package/dist/collection/components/mds-paginator-item/AGENTS.md +1 -1
  395. package/dist/collection/components/mds-paginator-item/documentation.json +1 -1
  396. package/dist/collection/components/mds-paginator-item/mds-paginator-item.js +1 -1
  397. package/dist/collection/components/mds-policy-ai/AGENTS.md +1 -1
  398. package/dist/collection/components/mds-policy-ai/documentation.json +2 -2
  399. package/dist/collection/components/mds-policy-ai/mds-policy-ai.js +1 -1
  400. package/dist/collection/components/mds-pref/AGENTS.md +3 -3
  401. package/dist/collection/components/mds-pref/documentation.json +4 -9
  402. package/dist/collection/components/mds-pref/examples.md +1 -1
  403. package/dist/collection/components/mds-pref/mds-pref.js +1 -29
  404. package/dist/collection/components/mds-pref/mistakes.md +1 -1
  405. package/dist/collection/components/mds-pref-animation/AGENTS.md +1 -1
  406. package/dist/collection/components/mds-pref-animation/documentation.json +2 -2
  407. package/dist/collection/components/mds-pref-animation/mds-pref-animation.js +1 -1
  408. package/dist/collection/components/mds-pref-consumption/AGENTS.md +1 -1
  409. package/dist/collection/components/mds-pref-consumption/documentation.json +2 -2
  410. package/dist/collection/components/mds-pref-consumption/mds-pref-consumption.js +1 -1
  411. package/dist/collection/components/mds-pref-contrast/AGENTS.md +1 -1
  412. package/dist/collection/components/mds-pref-contrast/documentation.json +2 -2
  413. package/dist/collection/components/mds-pref-contrast/mds-pref-contrast.js +1 -1
  414. package/dist/collection/components/mds-pref-language/AGENTS.md +1 -1
  415. package/dist/collection/components/mds-pref-language/documentation.json +2 -2
  416. package/dist/collection/components/mds-pref-language/mds-pref-language.js +1 -1
  417. package/dist/collection/components/mds-pref-language-item/AGENTS.md +1 -1
  418. package/dist/collection/components/mds-pref-language-item/documentation.json +2 -2
  419. package/dist/collection/components/mds-pref-language-item/mds-pref-language-item.js +1 -1
  420. package/dist/collection/components/mds-pref-mode/AGENTS.md +3 -2
  421. package/dist/collection/components/mds-pref-mode/documentation.json +5 -5
  422. package/dist/collection/components/mds-pref-mode/mds-pref-mode.css +2 -1
  423. package/dist/collection/components/mds-pref-mode/mds-pref-mode.js +20 -11
  424. package/dist/collection/components/mds-pref-mode/mistakes.md +1 -1
  425. package/dist/collection/components/mds-pref-theme/AGENTS.md +6 -5
  426. package/dist/collection/components/mds-pref-theme/documentation.json +7 -7
  427. package/dist/collection/components/mds-pref-theme/examples.md +1 -1
  428. package/dist/collection/components/mds-pref-theme/mds-pref-theme.js +32 -9
  429. package/dist/collection/components/mds-pref-theme/mistakes.md +1 -1
  430. package/dist/collection/components/mds-pref-theme-item/AGENTS.md +2 -2
  431. package/dist/collection/components/mds-pref-theme-item/documentation.json +3 -3
  432. package/dist/collection/components/mds-pref-theme-item/mds-pref-theme-item.js +1 -1
  433. package/dist/collection/components/mds-price-table/AGENTS.md +1 -1
  434. package/dist/collection/components/mds-price-table/documentation.json +1 -1
  435. package/dist/collection/components/mds-price-table/mds-price-table.js +1 -1
  436. package/dist/collection/components/mds-price-table-features/AGENTS.md +1 -1
  437. package/dist/collection/components/mds-price-table-features/documentation.json +1 -1
  438. package/dist/collection/components/mds-price-table-features/mds-price-table-features.js +1 -1
  439. package/dist/collection/components/mds-price-table-features-cell/AGENTS.md +1 -1
  440. package/dist/collection/components/mds-price-table-features-cell/documentation.json +1 -1
  441. package/dist/collection/components/mds-price-table-features-cell/mds-price-table-features-cell.css +3 -2
  442. package/dist/collection/components/mds-price-table-features-cell/mds-price-table-features-cell.js +1 -1
  443. package/dist/collection/components/mds-price-table-features-row/AGENTS.md +1 -1
  444. package/dist/collection/components/mds-price-table-features-row/documentation.json +1 -1
  445. package/dist/collection/components/mds-price-table-features-row/mds-price-table-features-row.css +3 -2
  446. package/dist/collection/components/mds-price-table-features-row/mds-price-table-features-row.js +1 -1
  447. package/dist/collection/components/mds-price-table-header/AGENTS.md +1 -1
  448. package/dist/collection/components/mds-price-table-header/documentation.json +1 -1
  449. package/dist/collection/components/mds-price-table-header/mds-price-table-header.js +1 -1
  450. package/dist/collection/components/mds-price-table-list/AGENTS.md +1 -1
  451. package/dist/collection/components/mds-price-table-list/documentation.json +1 -1
  452. package/dist/collection/components/mds-price-table-list/mds-price-table-list.css +3 -2
  453. package/dist/collection/components/mds-price-table-list/mds-price-table-list.js +1 -1
  454. package/dist/collection/components/mds-price-table-list-item/AGENTS.md +1 -1
  455. package/dist/collection/components/mds-price-table-list-item/documentation.json +1 -1
  456. package/dist/collection/components/mds-price-table-list-item/mds-price-table-list-item.js +1 -1
  457. package/dist/collection/components/mds-progress/AGENTS.md +1 -1
  458. package/dist/collection/components/mds-progress/documentation.json +1 -1
  459. package/dist/collection/components/mds-progress/mds-progress.css +3 -2
  460. package/dist/collection/components/mds-progress/mds-progress.js +1 -1
  461. package/dist/collection/components/mds-push-notification/AGENTS.md +1 -1
  462. package/dist/collection/components/mds-push-notification/documentation.json +2 -2
  463. package/dist/collection/components/mds-push-notification/mds-push-notification.css +3 -2
  464. package/dist/collection/components/mds-push-notification/mds-push-notification.js +1 -1
  465. package/dist/collection/components/mds-push-notification-item/AGENTS.md +1 -1
  466. package/dist/collection/components/mds-push-notification-item/documentation.json +2 -2
  467. package/dist/collection/components/mds-push-notification-item/mds-push-notification-item.js +2 -2
  468. package/dist/collection/components/mds-quote/AGENTS.md +1 -1
  469. package/dist/collection/components/mds-quote/documentation.json +1 -1
  470. package/dist/collection/components/mds-quote/mds-quote.js +1 -1
  471. package/dist/collection/components/mds-radial-menu/AGENTS.md +1 -1
  472. package/dist/collection/components/mds-radial-menu/documentation.json +2 -2
  473. package/dist/collection/components/mds-radial-menu/mds-radial-menu.js +1 -1
  474. package/dist/collection/components/mds-radial-menu-item/AGENTS.md +1 -1
  475. package/dist/collection/components/mds-radial-menu-item/documentation.json +2 -2
  476. package/dist/collection/components/mds-radial-menu-item/mds-radial-menu-item.js +1 -1
  477. package/dist/collection/components/mds-radial-progress/AGENTS.md +1 -1
  478. package/dist/collection/components/mds-radial-progress/documentation.json +1 -1
  479. package/dist/collection/components/mds-radial-progress/mds-radial-progress.js +1 -1
  480. package/dist/collection/components/mds-separator/AGENTS.md +1 -1
  481. package/dist/collection/components/mds-separator/documentation.json +1 -1
  482. package/dist/collection/components/mds-separator/mds-separator.js +1 -1
  483. package/dist/collection/components/mds-spinner/AGENTS.md +1 -1
  484. package/dist/collection/components/mds-spinner/documentation.json +1 -1
  485. package/dist/collection/components/mds-spinner/mds-spinner.js +1 -1
  486. package/dist/collection/components/mds-status-bar/AGENTS.md +1 -1
  487. package/dist/collection/components/mds-status-bar/documentation.json +2 -2
  488. package/dist/collection/components/mds-status-bar/mds-status-bar.css +3 -2
  489. package/dist/collection/components/mds-status-bar/mds-status-bar.js +1 -1
  490. package/dist/collection/components/mds-stepper-bar/AGENTS.md +1 -1
  491. package/dist/collection/components/mds-stepper-bar/documentation.json +1 -1
  492. package/dist/collection/components/mds-stepper-bar/mds-stepper-bar.js +1 -1
  493. package/dist/collection/components/mds-stepper-bar-item/AGENTS.md +1 -1
  494. package/dist/collection/components/mds-stepper-bar-item/documentation.json +1 -1
  495. package/dist/collection/components/mds-stepper-bar-item/mds-stepper-bar-item.js +1 -1
  496. package/dist/collection/components/mds-tab/AGENTS.md +1 -1
  497. package/dist/collection/components/mds-tab/documentation.json +1 -1
  498. package/dist/collection/components/mds-tab/mds-tab.css +3 -2
  499. package/dist/collection/components/mds-tab/mds-tab.js +2 -2
  500. package/dist/collection/components/mds-tab-bar/AGENTS.md +1 -1
  501. package/dist/collection/components/mds-tab-bar/documentation.json +1 -1
  502. package/dist/collection/components/mds-tab-bar/mds-tab-bar.css +3 -2
  503. package/dist/collection/components/mds-tab-bar/mds-tab-bar.js +1 -1
  504. package/dist/collection/components/mds-tab-bar-item/AGENTS.md +1 -1
  505. package/dist/collection/components/mds-tab-bar-item/documentation.json +1 -1
  506. package/dist/collection/components/mds-tab-bar-item/mds-tab-bar-item.css +3 -2
  507. package/dist/collection/components/mds-tab-bar-item/mds-tab-bar-item.js +1 -1
  508. package/dist/collection/components/mds-tab-item/AGENTS.md +1 -1
  509. package/dist/collection/components/mds-tab-item/documentation.json +2 -2
  510. package/dist/collection/components/mds-tab-item/mds-tab-item.js +1 -1
  511. package/dist/collection/components/mds-table/AGENTS.md +1 -1
  512. package/dist/collection/components/mds-table/documentation.json +1 -1
  513. package/dist/collection/components/mds-table/mds-table.css +6 -4
  514. package/dist/collection/components/mds-table/mds-table.js +1 -1
  515. package/dist/collection/components/mds-table-body/AGENTS.md +1 -1
  516. package/dist/collection/components/mds-table-body/documentation.json +1 -1
  517. package/dist/collection/components/mds-table-body/mds-table-body.js +1 -1
  518. package/dist/collection/components/mds-table-cell/AGENTS.md +1 -1
  519. package/dist/collection/components/mds-table-cell/documentation.json +1 -1
  520. package/dist/collection/components/mds-table-cell/mds-table-cell.js +1 -1
  521. package/dist/collection/components/mds-table-footer/AGENTS.md +1 -1
  522. package/dist/collection/components/mds-table-footer/documentation.json +1 -1
  523. package/dist/collection/components/mds-table-footer/mds-table-footer.js +1 -1
  524. package/dist/collection/components/mds-table-header/AGENTS.md +1 -1
  525. package/dist/collection/components/mds-table-header/documentation.json +2 -2
  526. package/dist/collection/components/mds-table-header/mds-table-header.js +1 -1
  527. package/dist/collection/components/mds-table-header-cell/AGENTS.md +1 -1
  528. package/dist/collection/components/mds-table-header-cell/documentation.json +2 -2
  529. package/dist/collection/components/mds-table-header-cell/mds-table-header-cell.js +1 -1
  530. package/dist/collection/components/mds-table-row/AGENTS.md +1 -1
  531. package/dist/collection/components/mds-table-row/documentation.json +1 -1
  532. package/dist/collection/components/mds-table-row/mds-table-row.js +2 -2
  533. package/dist/collection/components/mds-text/AGENTS.md +1 -1
  534. package/dist/collection/components/mds-text/documentation.json +1 -1
  535. package/dist/collection/components/mds-text/mds-text.js +1 -1
  536. package/dist/collection/components/mds-toast/AGENTS.md +1 -1
  537. package/dist/collection/components/mds-toast/documentation.json +2 -2
  538. package/dist/collection/components/mds-toast/mds-toast.js +1 -1
  539. package/dist/collection/components/mds-toast-region/AGENTS.md +1 -1
  540. package/dist/collection/components/mds-toast-region/documentation.json +1 -1
  541. package/dist/collection/components/mds-toast-region/mds-toast-region.js +1 -1
  542. package/dist/collection/components/mds-tooltip/AGENTS.md +1 -1
  543. package/dist/collection/components/mds-tooltip/documentation.json +1 -1
  544. package/dist/collection/components/mds-tooltip/mds-tooltip.css +4 -2
  545. package/dist/collection/components/mds-tooltip/mds-tooltip.js +1 -1
  546. package/dist/collection/components/mds-tree/AGENTS.md +1 -1
  547. package/dist/collection/components/mds-tree/documentation.json +1 -1
  548. package/dist/collection/components/mds-tree/mds-tree.js +1 -1
  549. package/dist/collection/components/mds-tree-item/AGENTS.md +1 -1
  550. package/dist/collection/components/mds-tree-item/documentation.json +2 -2
  551. package/dist/collection/components/mds-tree-item/mds-tree-item.js +1 -1
  552. package/dist/collection/components/mds-url-view/AGENTS.md +1 -1
  553. package/dist/collection/components/mds-url-view/documentation.json +2 -2
  554. package/dist/collection/components/mds-url-view/mds-url-view.css +3 -2
  555. package/dist/collection/components/mds-url-view/mds-url-view.js +1 -1
  556. package/dist/collection/components/mds-usage/AGENTS.md +1 -1
  557. package/dist/collection/components/mds-usage/documentation.json +1 -1
  558. package/dist/collection/components/mds-usage/mds-usage.css +3 -2
  559. package/dist/collection/components/mds-usage/mds-usage.js +1 -1
  560. package/dist/collection/components/mds-video-wall/AGENTS.md +1 -1
  561. package/dist/collection/components/mds-video-wall/documentation.json +1 -1
  562. package/dist/collection/components/mds-video-wall/mds-video-wall.js +1 -1
  563. package/dist/collection/components/mds-zero/AGENTS.md +1 -1
  564. package/dist/collection/components/mds-zero/documentation.json +1 -1
  565. package/dist/collection/components/mds-zero/mds-zero.css +3 -2
  566. package/dist/collection/components/mds-zero/mds-zero.js +1 -1
  567. package/dist/collection/type/button.js +3 -0
  568. package/dist/components/index.js +1 -1
  569. package/dist/components/mds-accordion-item.js +1 -1
  570. package/dist/components/mds-accordion-timer-item.js +1 -1
  571. package/dist/components/mds-accordion.js +1 -1
  572. package/dist/components/mds-avatar-stack-item.js +1 -1
  573. package/dist/components/mds-avatar-stack.js +1 -1
  574. package/dist/components/mds-avatar.js +1 -1
  575. package/dist/components/mds-badge.js +1 -1
  576. package/dist/components/mds-banner.js +1 -1
  577. package/dist/components/mds-benchmark-bar.js +1 -1
  578. package/dist/components/mds-bibliography.js +1 -1
  579. package/dist/components/mds-book.js +1 -1
  580. package/dist/components/mds-breadcrumb-item.js +1 -1
  581. package/dist/components/mds-breadcrumb.js +1 -1
  582. package/dist/components/mds-button-dropdown.js +1 -1
  583. package/dist/components/mds-button-group.js +1 -1
  584. package/dist/components/mds-button.js +1 -1
  585. package/dist/components/mds-calendar-cell.js +1 -1
  586. package/dist/components/mds-calendar.js +1 -1
  587. package/dist/components/mds-card-content.js +1 -1
  588. package/dist/components/mds-card-footer.js +1 -1
  589. package/dist/components/mds-card-header.js +1 -1
  590. package/dist/components/mds-card-media.js +1 -1
  591. package/dist/components/mds-card.js +1 -1
  592. package/dist/components/mds-chip.js +1 -1
  593. package/dist/components/mds-details.js +1 -1
  594. package/dist/components/mds-dropdown.js +1 -1
  595. package/dist/components/mds-emoji.js +3 -3
  596. package/dist/components/mds-entity.js +1 -1
  597. package/dist/components/mds-file-preview.js +1 -1
  598. package/dist/components/mds-file.js +1 -1
  599. package/dist/components/mds-filter-item.js +1 -1
  600. package/dist/components/mds-filter.js +1 -1
  601. package/dist/components/mds-header-bar.js +1 -1
  602. package/dist/components/mds-header.js +1 -1
  603. package/dist/components/mds-help.js +1 -1
  604. package/dist/components/mds-horizontal-scroll.js +1 -1
  605. package/dist/components/mds-hr.js +1 -1
  606. package/dist/components/mds-icon.js +1 -1
  607. package/dist/components/mds-img.js +1 -1
  608. package/dist/components/mds-input-date-range-preselection.js +1 -1
  609. package/dist/components/mds-input-date-range.js +1 -1
  610. package/dist/components/mds-input-date.js +1 -1
  611. package/dist/components/mds-input-field.js +1 -1
  612. package/dist/components/mds-input-otp.js +1 -1
  613. package/dist/components/mds-input-range.js +1 -1
  614. package/dist/components/mds-input-select.js +1 -1
  615. package/dist/components/mds-input-switch.js +1 -1
  616. package/dist/components/mds-input-tip-item.js +1 -1
  617. package/dist/components/mds-input-tip.js +1 -1
  618. package/dist/components/mds-input-upload.js +1 -1
  619. package/dist/components/mds-input.js +1 -1
  620. package/dist/components/mds-keyboard-key.js +1 -1
  621. package/dist/components/mds-keyboard.js +1 -1
  622. package/dist/components/mds-kpi-item.js +1 -1
  623. package/dist/components/mds-kpi.js +1 -1
  624. package/dist/components/mds-label.js +1 -1
  625. package/dist/components/mds-link.js +1 -1
  626. package/dist/components/mds-list-item.js +1 -1
  627. package/dist/components/mds-list.js +1 -1
  628. package/dist/components/mds-mention.js +1 -1
  629. package/dist/components/mds-modal.js +1 -1
  630. package/dist/components/mds-note.js +1 -1
  631. package/dist/components/mds-notification.js +1 -1
  632. package/dist/components/mds-paginator-item.js +1 -1
  633. package/dist/components/mds-paginator.js +1 -1
  634. package/dist/components/mds-policy-ai.js +1 -1
  635. package/dist/components/mds-pref-animation.js +1 -1
  636. package/dist/components/mds-pref-consumption.js +1 -1
  637. package/dist/components/mds-pref-contrast.js +1 -1
  638. package/dist/components/mds-pref-language-item.js +1 -1
  639. package/dist/components/mds-pref-language.js +1 -1
  640. package/dist/components/mds-pref-mode.js +1 -1
  641. package/dist/components/mds-pref-theme-item.js +1 -1
  642. package/dist/components/mds-pref-theme.js +1 -1
  643. package/dist/components/mds-pref.js +1 -1
  644. package/dist/components/mds-price-table-features-cell.js +1 -1
  645. package/dist/components/mds-price-table-features-row.js +1 -1
  646. package/dist/components/mds-price-table-features.js +1 -1
  647. package/dist/components/mds-price-table-header.js +1 -1
  648. package/dist/components/mds-price-table-list-item.js +1 -1
  649. package/dist/components/mds-price-table-list.js +1 -1
  650. package/dist/components/mds-price-table.js +1 -1
  651. package/dist/components/mds-progress.js +1 -1
  652. package/dist/components/mds-push-notification-item.js +1 -1
  653. package/dist/components/mds-push-notification.js +1 -1
  654. package/dist/components/mds-quote.js +1 -1
  655. package/dist/components/mds-radial-menu-item.js +1 -1
  656. package/dist/components/mds-radial-menu.js +1 -1
  657. package/dist/components/mds-radial-progress.js +1 -1
  658. package/dist/components/mds-separator.js +1 -1
  659. package/dist/components/mds-spinner.js +1 -1
  660. package/dist/components/mds-status-bar.js +1 -1
  661. package/dist/components/mds-stepper-bar-item.js +1 -1
  662. package/dist/components/mds-stepper-bar.js +1 -1
  663. package/dist/components/mds-tab-bar-item.js +1 -1
  664. package/dist/components/mds-tab-bar.js +1 -1
  665. package/dist/components/mds-tab-item.js +1 -1
  666. package/dist/components/mds-tab.js +1 -1
  667. package/dist/components/mds-table-body.js +1 -1
  668. package/dist/components/mds-table-cell.js +1 -1
  669. package/dist/components/mds-table-footer.js +1 -1
  670. package/dist/components/mds-table-header-cell.js +1 -1
  671. package/dist/components/mds-table-header.js +1 -1
  672. package/dist/components/mds-table-row.js +1 -1
  673. package/dist/components/mds-table.js +1 -1
  674. package/dist/components/mds-text.js +1 -1
  675. package/dist/components/mds-toast-region.js +1 -1
  676. package/dist/components/mds-toast.js +1 -1
  677. package/dist/components/mds-tooltip.js +1 -1
  678. package/dist/components/mds-tree-item.js +1 -1
  679. package/dist/components/mds-tree.js +1 -1
  680. package/dist/components/mds-url-view.js +1 -1
  681. package/dist/components/mds-usage.js +1 -1
  682. package/dist/components/mds-video-wall.js +1 -1
  683. package/dist/components/mds-zero.js +1 -1
  684. package/dist/components/p-3rr6yzu-.js +1 -0
  685. package/dist/components/{p-DvDB_L_5.js → p-BBZyH3mn.js} +1 -1
  686. package/dist/components/{p-C7rDjrH4.js → p-BBrPpCNK.js} +1 -1
  687. package/dist/components/p-BE05D6Pe.js +1 -0
  688. package/dist/components/{p-ikNX7XDH.js → p-BI1ShBQG.js} +1 -1
  689. package/dist/components/p-BQSO-HFx.js +1 -0
  690. package/dist/components/{p-CVRN4LDc.js → p-Bbrei_yQ.js} +1 -1
  691. package/dist/components/{p-DhpcFZrc.js → p-BpND63Kl.js} +1 -1
  692. package/dist/components/{p-DqdlT4UG.js → p-BuhoBOYR.js} +1 -1
  693. package/dist/components/p-Bw-eI2ca.js +1 -0
  694. package/dist/components/{p-DTtmr_Y9.js → p-BwwiliWt.js} +1 -1
  695. package/dist/components/{p-COkn4Vtq.js → p-C6LU1s8K.js} +1 -1
  696. package/dist/components/{p-Br6-kva-.js → p-CWOW2Vna.js} +1 -1
  697. package/dist/components/{p-B6AFku7a.js → p-CZX6N7ce.js} +1 -1
  698. package/dist/components/{p-BFDRt7-n.js → p-CZwKeFQT.js} +1 -1
  699. package/dist/components/{p-CKnbQQUb.js → p-ClvoVgmw.js} +1 -1
  700. package/dist/{magma-components/p-CLhuNxYQ.js → components/p-CpuUmvdl.js} +1 -1
  701. package/dist/components/{p-C_Pc94vn.js → p-CrOv4KdL.js} +1 -1
  702. package/dist/components/{p-CZjwSwe5.js → p-CvbuCEYD.js} +2 -2
  703. package/dist/components/{p-D8CloC8I.js → p-DN1yF-xO.js} +1 -1
  704. package/dist/components/{p-4LbHmDXv.js → p-DUgCzZw9.js} +1 -1
  705. package/dist/components/{p-DJd8f8dz.js → p-DWOg4-dH.js} +1 -1
  706. package/dist/components/{p-FsctOap9.js → p-DZ4_zLTp.js} +1 -1
  707. package/dist/components/{p-gLo3t_qO.js → p-Do7IoDLD.js} +2 -2
  708. package/dist/components/{p-BiW6luA5.js → p-DrtIqOQn.js} +1 -1
  709. package/dist/components/p-DwKxtKwS.js +1 -0
  710. package/dist/components/{p-DOdUioZq.js → p-F0qhFsF0.js} +1 -1
  711. package/dist/components/p-J48g0t65.js +1 -0
  712. package/dist/components/{p-BaynxVRZ.js → p-NNPsVjnj.js} +1 -1
  713. package/dist/components/{p-CP5Qw9_T.js → p-UfaGafRS.js} +1 -1
  714. package/dist/components/{p-DdzJfsw7.js → p-Vgo7t88R.js} +1 -1
  715. package/dist/components/{p-D_RIY063.js → p-j5Hnbfv9.js} +1 -1
  716. package/dist/components/{p-DW6ie49j.js → p-k_Ly95Tj.js} +1 -1
  717. package/dist/components/{p-DlglisEn.js → p-lXKBo6V3.js} +1 -1
  718. package/dist/components/{p-DGhzWuCS.js → p-oFHbHRLX.js} +1 -1
  719. package/dist/documentation.json +263 -77
  720. package/dist/esm/{aria-Cvhn9asj.js → aria-DwKxtKwS.js} +12 -1
  721. package/dist/esm/{floating-controller-BVlbYYkf.js → floating-controller-xixU_s1w.js} +1 -1
  722. package/dist/esm/{index-BJVvHlvf.js → index-DEL0bLpb.js} +1 -1
  723. package/dist/esm/loader.js +1 -1
  724. package/dist/esm/{locale-B6cOkl4I.js → locale-DhP1Ge2o.js} +1 -1
  725. package/dist/esm/magma-components.js +1 -1
  726. package/dist/esm/mds-accordion-item.entry.js +1 -1
  727. package/dist/esm/mds-accordion-timer-item.entry.js +1 -1
  728. package/dist/esm/mds-accordion.entry.js +1 -1
  729. package/dist/esm/mds-avatar.entry.js +1 -1
  730. package/dist/esm/mds-badge.entry.js +2 -2
  731. package/dist/esm/mds-banner_3.entry.js +5 -5
  732. package/dist/esm/mds-book.entry.js +2 -2
  733. package/dist/esm/mds-breadcrumb.entry.js +2 -2
  734. package/dist/esm/mds-button-dropdown.entry.js +6 -4
  735. package/dist/esm/mds-button-group.entry.js +1 -1
  736. package/dist/esm/mds-button_3.entry.js +78 -16
  737. package/dist/esm/mds-calendar_2.entry.js +8 -8
  738. package/dist/esm/mds-card-content.entry.js +1 -1
  739. package/dist/esm/mds-card-footer.entry.js +1 -1
  740. package/dist/esm/mds-card-header.entry.js +1 -1
  741. package/dist/esm/mds-card-media.entry.js +1 -1
  742. package/dist/esm/mds-card.entry.js +2 -2
  743. package/dist/esm/mds-details.entry.js +2 -2
  744. package/dist/esm/mds-dropdown.entry.js +6 -6
  745. package/dist/esm/mds-emoji.entry.js +2 -2
  746. package/dist/esm/mds-entity.entry.js +2 -2
  747. package/dist/esm/mds-file-preview.entry.js +5 -5
  748. package/dist/esm/mds-file.entry.js +5 -5
  749. package/dist/esm/mds-filter-item.entry.js +5 -5
  750. package/dist/esm/mds-filter.entry.js +4 -4
  751. package/dist/esm/mds-header-bar.entry.js +3 -3
  752. package/dist/esm/mds-header.entry.js +3 -3
  753. package/dist/esm/mds-horizontal-scroll.entry.js +3 -3
  754. package/dist/esm/mds-hr.entry.js +2 -2
  755. package/dist/esm/mds-img.entry.js +2 -2
  756. package/dist/esm/mds-input-date-range-preselection.entry.js +1 -1
  757. package/dist/esm/mds-input-date-range.entry.js +4 -4
  758. package/dist/esm/mds-input-date.entry.js +6 -6
  759. package/dist/esm/mds-input-field.entry.js +1 -1
  760. package/dist/esm/mds-input-otp.entry.js +3 -3
  761. package/dist/esm/mds-input-range.entry.js +3 -3
  762. package/dist/esm/mds-input-select.entry.js +6 -6
  763. package/dist/esm/mds-input-switch_2.entry.js +6 -6
  764. package/dist/esm/mds-input-tip_2.entry.js +5 -5
  765. package/dist/esm/mds-input-upload.entry.js +7 -7
  766. package/dist/esm/mds-input.entry.js +8 -8
  767. package/dist/esm/mds-keyboard-key.entry.js +3 -3
  768. package/dist/esm/mds-keyboard.entry.js +4 -4
  769. package/dist/esm/mds-kpi-item.entry.js +3 -3
  770. package/dist/esm/mds-kpi.entry.js +1 -1
  771. package/dist/esm/mds-label.entry.js +3 -3
  772. package/dist/esm/mds-link.entry.js +5 -5
  773. package/dist/esm/mds-list-item.entry.js +1 -1
  774. package/dist/esm/mds-list.entry.js +1 -1
  775. package/dist/esm/mds-mention.entry.js +3 -3
  776. package/dist/esm/mds-modal.entry.js +34 -15
  777. package/dist/esm/mds-note.entry.js +4 -4
  778. package/dist/esm/mds-notification.entry.js +3 -3
  779. package/dist/esm/mds-paginator-item.entry.js +2 -2
  780. package/dist/esm/mds-paginator.entry.js +4 -4
  781. package/dist/esm/mds-policy-ai.entry.js +3 -3
  782. package/dist/esm/mds-pref-animation.entry.js +3 -3
  783. package/dist/esm/mds-pref-consumption.entry.js +3 -3
  784. package/dist/esm/mds-pref-contrast.entry.js +3 -3
  785. package/dist/esm/mds-pref-language-item.entry.js +3 -3
  786. package/dist/esm/mds-pref-language.entry.js +3 -3
  787. package/dist/esm/mds-pref-mode.entry.js +22 -13
  788. package/dist/esm/mds-pref-theme-item.entry.js +1 -1
  789. package/dist/esm/mds-pref-theme.entry.js +31 -8
  790. package/dist/esm/mds-pref.entry.js +3 -25
  791. package/dist/esm/mds-price-table-features-cell.entry.js +3 -3
  792. package/dist/esm/mds-price-table-features-row.entry.js +3 -3
  793. package/dist/esm/mds-price-table-features.entry.js +2 -2
  794. package/dist/esm/mds-price-table-header.entry.js +1 -1
  795. package/dist/esm/mds-price-table-list-item.entry.js +1 -1
  796. package/dist/esm/mds-price-table-list.entry.js +3 -3
  797. package/dist/esm/mds-price-table.entry.js +1 -1
  798. package/dist/esm/mds-progress_2.entry.js +4 -4
  799. package/dist/esm/mds-push-notification-item.entry.js +4 -4
  800. package/dist/esm/mds-push-notification.entry.js +4 -4
  801. package/dist/esm/mds-quote.entry.js +2 -2
  802. package/dist/esm/mds-radial-menu-item.entry.js +1 -1
  803. package/dist/esm/mds-radial-menu.entry.js +5 -5
  804. package/dist/esm/mds-separator.entry.js +2 -2
  805. package/dist/esm/mds-status-bar.entry.js +3 -3
  806. package/dist/esm/mds-stepper-bar-item.entry.js +3 -3
  807. package/dist/esm/mds-stepper-bar.entry.js +1 -1
  808. package/dist/esm/mds-tab-bar-item.entry.js +4 -4
  809. package/dist/esm/mds-tab-bar.entry.js +3 -3
  810. package/dist/esm/mds-tab_2.entry.js +6 -6
  811. package/dist/esm/mds-table-body.entry.js +2 -2
  812. package/dist/esm/mds-table-footer.entry.js +2 -2
  813. package/dist/esm/mds-table-header-cell.entry.js +2 -2
  814. package/dist/esm/mds-table-header.entry.js +3 -3
  815. package/dist/esm/mds-table-row.entry.js +4 -4
  816. package/dist/esm/mds-table.entry.js +4 -4
  817. package/dist/esm/mds-text.entry.js +2 -2
  818. package/dist/esm/mds-toast-region.entry.js +1 -1
  819. package/dist/esm/mds-toast.entry.js +3 -3
  820. package/dist/esm/mds-tooltip.entry.js +5 -5
  821. package/dist/esm/mds-tree-item.entry.js +3 -3
  822. package/dist/esm/mds-tree.entry.js +1 -1
  823. package/dist/esm/mds-url-view.entry.js +4 -4
  824. package/dist/esm/mds-usage.entry.js +4 -4
  825. package/dist/esm/mds-video-wall.entry.js +2 -2
  826. package/dist/esm/mds-zero.entry.js +3 -3
  827. package/dist/esm/{preference-C5XjgGCb.js → preference-C8foBO86.js} +19 -1
  828. package/dist/esm-es5/aria-DwKxtKwS.js +12 -0
  829. package/dist/esm-es5/{floating-controller-BVlbYYkf.js → floating-controller-xixU_s1w.js} +1 -1
  830. package/dist/esm-es5/{index-BJVvHlvf.js → index-DEL0bLpb.js} +1 -1
  831. package/dist/esm-es5/loader.js +1 -1
  832. package/dist/esm-es5/{locale-B6cOkl4I.js → locale-DhP1Ge2o.js} +18 -18
  833. package/dist/esm-es5/magma-components.js +1 -1
  834. package/dist/esm-es5/mds-accordion-item.entry.js +1 -1
  835. package/dist/esm-es5/mds-accordion-timer-item.entry.js +1 -1
  836. package/dist/esm-es5/mds-accordion.entry.js +1 -1
  837. package/dist/esm-es5/mds-avatar.entry.js +2 -2
  838. package/dist/esm-es5/mds-badge.entry.js +1 -1
  839. package/dist/esm-es5/mds-banner_3.entry.js +4 -4
  840. package/dist/esm-es5/mds-book.entry.js +1 -1
  841. package/dist/esm-es5/mds-breadcrumb.entry.js +1 -1
  842. package/dist/esm-es5/mds-button-dropdown.entry.js +6 -4
  843. package/dist/esm-es5/mds-button-group.entry.js +1 -1
  844. package/dist/esm-es5/mds-button_3.entry.js +39 -17
  845. package/dist/esm-es5/mds-calendar_2.entry.js +4 -4
  846. package/dist/esm-es5/mds-card-content.entry.js +1 -1
  847. package/dist/esm-es5/mds-card-footer.entry.js +1 -1
  848. package/dist/esm-es5/mds-card-header.entry.js +1 -1
  849. package/dist/esm-es5/mds-card-media.entry.js +1 -1
  850. package/dist/esm-es5/mds-card.entry.js +2 -2
  851. package/dist/esm-es5/mds-details.entry.js +2 -2
  852. package/dist/esm-es5/mds-dropdown.entry.js +13 -13
  853. package/dist/esm-es5/mds-emoji.entry.js +2 -2
  854. package/dist/esm-es5/mds-entity.entry.js +1 -1
  855. package/dist/esm-es5/mds-file-preview.entry.js +7 -7
  856. package/dist/esm-es5/mds-file.entry.js +3 -3
  857. package/dist/esm-es5/mds-filter-item.entry.js +2 -2
  858. package/dist/esm-es5/mds-filter.entry.js +2 -2
  859. package/dist/esm-es5/mds-header-bar.entry.js +2 -2
  860. package/dist/esm-es5/mds-header.entry.js +2 -2
  861. package/dist/esm-es5/mds-horizontal-scroll.entry.js +2 -2
  862. package/dist/esm-es5/mds-hr.entry.js +1 -1
  863. package/dist/esm-es5/mds-img.entry.js +1 -1
  864. package/dist/esm-es5/mds-input-date-range-preselection.entry.js +3 -3
  865. package/dist/esm-es5/mds-input-date-range.entry.js +1 -1
  866. package/dist/esm-es5/mds-input-date.entry.js +3 -3
  867. package/dist/esm-es5/mds-input-field.entry.js +1 -1
  868. package/dist/esm-es5/mds-input-otp.entry.js +2 -2
  869. package/dist/esm-es5/mds-input-range.entry.js +2 -2
  870. package/dist/esm-es5/mds-input-select.entry.js +10 -10
  871. package/dist/esm-es5/mds-input-switch_2.entry.js +2 -2
  872. package/dist/esm-es5/mds-input-tip_2.entry.js +3 -3
  873. package/dist/esm-es5/mds-input-upload.entry.js +2 -2
  874. package/dist/esm-es5/mds-input.entry.js +3 -3
  875. package/dist/esm-es5/mds-keyboard-key.entry.js +2 -2
  876. package/dist/esm-es5/mds-keyboard.entry.js +2 -2
  877. package/dist/esm-es5/mds-kpi-item.entry.js +3 -3
  878. package/dist/esm-es5/mds-kpi.entry.js +1 -1
  879. package/dist/esm-es5/mds-label.entry.js +1 -1
  880. package/dist/esm-es5/mds-link.entry.js +2 -2
  881. package/dist/esm-es5/mds-list-item.entry.js +1 -1
  882. package/dist/esm-es5/mds-list.entry.js +1 -1
  883. package/dist/esm-es5/mds-mention.entry.js +2 -2
  884. package/dist/esm-es5/mds-modal.entry.js +23 -11
  885. package/dist/esm-es5/mds-note.entry.js +2 -2
  886. package/dist/esm-es5/mds-notification.entry.js +2 -2
  887. package/dist/esm-es5/mds-paginator-item.entry.js +2 -2
  888. package/dist/esm-es5/mds-paginator.entry.js +3 -3
  889. package/dist/esm-es5/mds-policy-ai.entry.js +2 -2
  890. package/dist/esm-es5/mds-pref-animation.entry.js +2 -2
  891. package/dist/esm-es5/mds-pref-consumption.entry.js +2 -2
  892. package/dist/esm-es5/mds-pref-contrast.entry.js +3 -3
  893. package/dist/esm-es5/mds-pref-language-item.entry.js +2 -2
  894. package/dist/esm-es5/mds-pref-language.entry.js +2 -2
  895. package/dist/esm-es5/mds-pref-mode.entry.js +13 -3
  896. package/dist/esm-es5/mds-pref-theme-item.entry.js +1 -1
  897. package/dist/esm-es5/mds-pref-theme.entry.js +19 -6
  898. package/dist/esm-es5/mds-pref.entry.js +4 -12
  899. package/dist/esm-es5/mds-price-table-features-cell.entry.js +2 -2
  900. package/dist/esm-es5/mds-price-table-features-row.entry.js +1 -1
  901. package/dist/esm-es5/mds-price-table-features.entry.js +1 -1
  902. package/dist/esm-es5/mds-price-table-header.entry.js +1 -1
  903. package/dist/esm-es5/mds-price-table-list-item.entry.js +1 -1
  904. package/dist/esm-es5/mds-price-table-list.entry.js +2 -2
  905. package/dist/esm-es5/mds-price-table.entry.js +1 -1
  906. package/dist/esm-es5/mds-progress_2.entry.js +3 -3
  907. package/dist/esm-es5/mds-push-notification-item.entry.js +2 -2
  908. package/dist/esm-es5/mds-push-notification.entry.js +6 -6
  909. package/dist/esm-es5/mds-quote.entry.js +2 -2
  910. package/dist/esm-es5/mds-radial-menu-item.entry.js +1 -1
  911. package/dist/esm-es5/mds-radial-menu.entry.js +4 -4
  912. package/dist/esm-es5/mds-separator.entry.js +1 -1
  913. package/dist/esm-es5/mds-status-bar.entry.js +3 -3
  914. package/dist/esm-es5/mds-stepper-bar-item.entry.js +2 -2
  915. package/dist/esm-es5/mds-stepper-bar.entry.js +1 -1
  916. package/dist/esm-es5/mds-tab-bar-item.entry.js +2 -2
  917. package/dist/esm-es5/mds-tab-bar.entry.js +2 -2
  918. package/dist/esm-es5/mds-tab_2.entry.js +3 -3
  919. package/dist/esm-es5/mds-table-body.entry.js +1 -1
  920. package/dist/esm-es5/mds-table-footer.entry.js +2 -2
  921. package/dist/esm-es5/mds-table-header-cell.entry.js +2 -2
  922. package/dist/esm-es5/mds-table-header.entry.js +2 -2
  923. package/dist/esm-es5/mds-table-row.entry.js +2 -2
  924. package/dist/esm-es5/mds-table.entry.js +2 -2
  925. package/dist/esm-es5/mds-text.entry.js +2 -2
  926. package/dist/esm-es5/mds-toast-region.entry.js +1 -1
  927. package/dist/esm-es5/mds-toast.entry.js +2 -2
  928. package/dist/esm-es5/mds-tooltip.entry.js +2 -2
  929. package/dist/esm-es5/mds-tree-item.entry.js +2 -2
  930. package/dist/esm-es5/mds-tree.entry.js +1 -1
  931. package/dist/esm-es5/mds-url-view.entry.js +2 -2
  932. package/dist/esm-es5/mds-usage.entry.js +3 -3
  933. package/dist/esm-es5/mds-video-wall.entry.js +2 -2
  934. package/dist/esm-es5/mds-zero.entry.js +1 -1
  935. package/dist/esm-es5/{preference-C5XjgGCb.js → preference-C8foBO86.js} +14 -4
  936. package/dist/hydrate/index.js +343 -216
  937. package/dist/hydrate/index.mjs +343 -216
  938. package/dist/lint/core/patterns.d.ts +26 -16
  939. package/dist/lint/core/patterns.js +55 -38
  940. package/dist/lint/mcp/tools.json +7 -7
  941. package/dist/magma-components/magma-components.esm.js +1 -1
  942. package/dist/magma-components/{p-0384db44.system.entry.js → p-00d2ef14.system.entry.js} +5 -5
  943. package/dist/magma-components/{p-ff65fc97.entry.js → p-02aed12a.entry.js} +1 -1
  944. package/dist/magma-components/{p-7c055074.entry.js → p-08f7a84b.entry.js} +1 -1
  945. package/dist/magma-components/{p-8239e526.system.entry.js → p-09a7c1de.system.entry.js} +1 -1
  946. package/dist/magma-components/{p-18244fd7.system.entry.js → p-0da5c696.system.entry.js} +3 -3
  947. package/dist/magma-components/{p-5575f198.entry.js → p-0df067b4.entry.js} +1 -1
  948. package/dist/magma-components/{p-b6412ddd.system.entry.js → p-0e1d239b.system.entry.js} +1 -1
  949. package/dist/magma-components/{p-ac161cb5.entry.js → p-0f4c2de6.entry.js} +1 -1
  950. package/dist/magma-components/{p-0c8f22dc.system.entry.js → p-11456781.system.entry.js} +2 -2
  951. package/dist/magma-components/{p-a2e3a545.entry.js → p-14de26d5.entry.js} +1 -1
  952. package/dist/magma-components/p-163eccbd.entry.js +1 -0
  953. package/dist/magma-components/{p-844bce77.entry.js → p-167ba07a.entry.js} +1 -1
  954. package/dist/magma-components/{p-f4fc9f29.system.entry.js → p-16bbff4e.system.entry.js} +1 -1
  955. package/dist/magma-components/{p-e059aaa9.entry.js → p-17249b74.entry.js} +1 -1
  956. package/dist/magma-components/{p-95ddc950.system.entry.js → p-188a55ac.system.entry.js} +3 -3
  957. package/dist/magma-components/{p-c9bd81c5.system.entry.js → p-1a53d9d0.system.entry.js} +7 -7
  958. package/dist/magma-components/{p-27254fbd.entry.js → p-1cc379d6.entry.js} +1 -1
  959. package/dist/magma-components/{p-ae9735e4.system.entry.js → p-1dc0d59c.system.entry.js} +2 -2
  960. package/dist/magma-components/{p-384d93dc.system.entry.js → p-1e24aafa.system.entry.js} +1 -1
  961. package/dist/magma-components/p-223efc32.entry.js +1 -0
  962. package/dist/magma-components/{p-1467ded5.system.entry.js → p-2454e4cd.system.entry.js} +2 -2
  963. package/dist/magma-components/{p-18b27217.entry.js → p-24a69c45.entry.js} +1 -1
  964. package/dist/magma-components/{p-fae9612b.system.entry.js → p-24fb2c5c.system.entry.js} +2 -2
  965. package/dist/magma-components/{p-ef1bdd44.entry.js → p-259d9380.entry.js} +1 -1
  966. package/dist/magma-components/{p-4fc0e294.entry.js → p-26b08e33.entry.js} +1 -1
  967. package/dist/magma-components/{p-c35ea44d.system.entry.js → p-27a32865.system.entry.js} +2 -2
  968. package/dist/magma-components/{p-299dab17.entry.js → p-2940499f.entry.js} +1 -1
  969. package/dist/magma-components/{p-6129954d.system.entry.js → p-2a5167e3.system.entry.js} +1 -1
  970. package/dist/magma-components/{p-ad13ade5.system.entry.js → p-2e825656.system.entry.js} +3 -3
  971. package/dist/magma-components/{p-308a4ae5.system.entry.js → p-2f4a7253.system.entry.js} +1 -1
  972. package/dist/magma-components/{p-29dd6d94.entry.js → p-2ffa4d4a.entry.js} +1 -1
  973. package/dist/magma-components/{p-d360e4c5.entry.js → p-32b3ad6f.entry.js} +1 -1
  974. package/dist/magma-components/{p-5686da49.system.entry.js → p-33129e0c.system.entry.js} +3 -3
  975. package/dist/magma-components/{p-9c2b67fc.system.entry.js → p-372fa5d4.system.entry.js} +3 -3
  976. package/dist/magma-components/p-380adee8.system.entry.js +5 -0
  977. package/dist/magma-components/{p-b0749f83.system.entry.js → p-390d0672.system.entry.js} +3 -3
  978. package/dist/magma-components/p-397c0686.entry.js +1 -0
  979. package/dist/magma-components/{p-e0049e96.system.entry.js → p-3a836de8.system.entry.js} +1 -1
  980. package/dist/magma-components/{p-fff26731.system.entry.js → p-3ba14295.system.entry.js} +2 -2
  981. package/dist/magma-components/{p-741f8f45.system.entry.js → p-3bf4f012.system.entry.js} +2 -2
  982. package/dist/magma-components/{p-5d56a7cd.system.entry.js → p-3c911608.system.entry.js} +3 -3
  983. package/dist/magma-components/{p-aac622ef.system.entry.js → p-3cf8ed46.system.entry.js} +1 -1
  984. package/dist/magma-components/{p-61e11cd0.system.entry.js → p-3ddae677.system.entry.js} +3 -3
  985. package/dist/magma-components/{p-2d2cdf0d.entry.js → p-3de37b32.entry.js} +1 -1
  986. package/dist/magma-components/{p-90d50492.system.entry.js → p-3f17a06f.system.entry.js} +2 -2
  987. package/dist/magma-components/{p-4f0153cd.entry.js → p-40c59c18.entry.js} +1 -1
  988. package/dist/magma-components/p-411fca2f.system.entry.js +14 -0
  989. package/dist/magma-components/{p-7f418ae1.entry.js → p-43c307f5.entry.js} +1 -1
  990. package/dist/magma-components/{p-14122f2d.entry.js → p-440d7942.entry.js} +1 -1
  991. package/dist/magma-components/{p-6a994dc1.entry.js → p-4541c233.entry.js} +1 -1
  992. package/dist/magma-components/{p-c915fba5.system.entry.js → p-45c26a24.system.entry.js} +1 -1
  993. package/dist/magma-components/{p-948ecde4.entry.js → p-4612bc78.entry.js} +2 -2
  994. package/dist/magma-components/{p-be2ca282.entry.js → p-4718a71d.entry.js} +1 -1
  995. package/dist/magma-components/{p-8a8cad6c.system.entry.js → p-48a1871f.system.entry.js} +1 -1
  996. package/dist/magma-components/{p-7ee31f2e.entry.js → p-4a1f7eb5.entry.js} +1 -1
  997. package/dist/magma-components/{p-adab176e.system.entry.js → p-4a2ed30e.system.entry.js} +2 -2
  998. package/dist/magma-components/{p-efe27253.system.entry.js → p-4a9ed4f7.system.entry.js} +1 -1
  999. package/dist/magma-components/{p-2d199db0.system.entry.js → p-4c3b3913.system.entry.js} +2 -2
  1000. package/dist/magma-components/p-4c955367.entry.js +1 -0
  1001. package/dist/magma-components/p-4ebb0a9e.entry.js +1 -0
  1002. package/dist/magma-components/{p-02b106c2.entry.js → p-4f80bf37.entry.js} +1 -1
  1003. package/dist/magma-components/{p-a65ce11a.system.entry.js → p-527569a3.system.entry.js} +2 -2
  1004. package/dist/magma-components/{p-0d42ac4a.entry.js → p-52cc5a93.entry.js} +1 -1
  1005. package/dist/magma-components/{p-3139988c.system.entry.js → p-54abba52.system.entry.js} +1 -1
  1006. package/dist/magma-components/{p-4fd0fdb8.system.entry.js → p-555ba0e0.system.entry.js} +2 -2
  1007. package/dist/magma-components/{p-5c8f408e.entry.js → p-56cf1cab.entry.js} +1 -1
  1008. package/dist/magma-components/{p-bba4f1f0.system.entry.js → p-5794053b.system.entry.js} +10 -10
  1009. package/dist/magma-components/{p-57ee6e32.entry.js → p-5a754d7b.entry.js} +1 -1
  1010. package/dist/magma-components/{p-f09f3fe1.system.entry.js → p-5c6fdabd.system.entry.js} +3 -3
  1011. package/dist/magma-components/{p-c683cd13.entry.js → p-5ca6063a.entry.js} +1 -1
  1012. package/dist/magma-components/{p-ac099ed6.entry.js → p-5cb581df.entry.js} +1 -1
  1013. package/dist/magma-components/{p-445198a1.entry.js → p-5d825728.entry.js} +1 -1
  1014. package/dist/magma-components/{p-60b21db7.entry.js → p-5dfca9f0.entry.js} +1 -1
  1015. package/dist/magma-components/{p-f181c679.system.entry.js → p-5f20592f.system.entry.js} +1 -1
  1016. package/dist/magma-components/p-5f38e95b.entry.js +1 -0
  1017. package/dist/magma-components/p-5f4bec31.entry.js +1 -0
  1018. package/dist/magma-components/p-627f5956.entry.js +1 -0
  1019. package/dist/magma-components/{p-a9caed77.entry.js → p-6336d979.entry.js} +1 -1
  1020. package/dist/magma-components/{p-7837856f.entry.js → p-6352c2ea.entry.js} +1 -1
  1021. package/dist/magma-components/{p-10d52280.entry.js → p-64884d84.entry.js} +1 -1
  1022. package/dist/magma-components/{p-98e167e8.system.entry.js → p-64f86e46.system.entry.js} +2 -2
  1023. package/dist/magma-components/{p-9a0f8eb1.entry.js → p-65ea6fc9.entry.js} +1 -1
  1024. package/dist/magma-components/{p-cf42d6ea.system.entry.js → p-66f7f9b1.system.entry.js} +3 -3
  1025. package/dist/magma-components/{p-13cfc01a.entry.js → p-68b0d45a.entry.js} +1 -1
  1026. package/dist/magma-components/{p-b61546fd.entry.js → p-6a4d44e2.entry.js} +1 -1
  1027. package/dist/magma-components/p-6a90caf5.system.entry.js +1 -0
  1028. package/dist/magma-components/{p-dfab370b.entry.js → p-6c4f2de0.entry.js} +1 -1
  1029. package/dist/magma-components/{p-12be0f43.system.entry.js → p-6f90c2c9.system.entry.js} +2 -2
  1030. package/dist/magma-components/p-70faf379.entry.js +1 -0
  1031. package/dist/magma-components/{p-e7f717ab.entry.js → p-71d03e56.entry.js} +1 -1
  1032. package/dist/magma-components/{p-b30b487c.system.entry.js → p-720e9291.system.entry.js} +3 -3
  1033. package/dist/magma-components/{p-bc054ffa.system.entry.js → p-724b7fff.system.entry.js} +2 -2
  1034. package/dist/magma-components/{p-6896786e.entry.js → p-73dc7c66.entry.js} +1 -1
  1035. package/dist/magma-components/{p-34421ef2.system.entry.js → p-7476cf76.system.entry.js} +3 -3
  1036. package/dist/magma-components/{p-0fc41e34.system.entry.js → p-7701a318.system.entry.js} +1 -1
  1037. package/dist/magma-components/{p-85bf9c93.entry.js → p-77707706.entry.js} +1 -1
  1038. package/dist/magma-components/{p-c9553777.entry.js → p-78d00f88.entry.js} +1 -1
  1039. package/dist/magma-components/{p-4f48c171.system.entry.js → p-79085c46.system.entry.js} +1 -1
  1040. package/dist/magma-components/{p-ccffdf0b.system.entry.js → p-793072e1.system.entry.js} +23 -11
  1041. package/dist/magma-components/{p-b2763352.entry.js → p-79392a0a.entry.js} +1 -1
  1042. package/dist/magma-components/{p-7ff5552f.entry.js → p-7a33ab3c.entry.js} +1 -1
  1043. package/dist/magma-components/{p-625de2e6.system.entry.js → p-7a4e8bc0.system.entry.js} +4 -4
  1044. package/dist/magma-components/p-7a73fd19.system.entry.js +127 -0
  1045. package/dist/magma-components/p-7b552dbe.entry.js +1 -0
  1046. package/dist/magma-components/{p-84aac233.entry.js → p-7c13ccb0.entry.js} +1 -1
  1047. package/dist/magma-components/{p-d81fcbde.system.entry.js → p-7e0a8194.system.entry.js} +5 -5
  1048. package/dist/magma-components/{p-45b19935.system.entry.js → p-7fbdf896.system.entry.js} +3 -3
  1049. package/dist/magma-components/{p-35c170ba.system.entry.js → p-804f4794.system.entry.js} +2 -2
  1050. package/dist/magma-components/{p-6c73689a.system.entry.js → p-840c19ee.system.entry.js} +4 -4
  1051. package/dist/magma-components/p-848d1b42.system.entry.js +30 -0
  1052. package/dist/magma-components/{p-81212e34.entry.js → p-86494ea9.entry.js} +1 -1
  1053. package/dist/magma-components/p-8915347f.entry.js +1 -0
  1054. package/dist/magma-components/{p-f493fdc3.entry.js → p-8c20ac0c.entry.js} +1 -1
  1055. package/dist/magma-components/{p-f22b8091.entry.js → p-90c60c48.entry.js} +1 -1
  1056. package/dist/magma-components/{p-60d6e60f.entry.js → p-90e20ad3.entry.js} +1 -1
  1057. package/dist/magma-components/{p-797c64f4.system.entry.js → p-9228db0b.system.entry.js} +13 -3
  1058. package/dist/magma-components/p-94548d43.entry.js +1 -0
  1059. package/dist/magma-components/{p-9c784173.entry.js → p-95020326.entry.js} +1 -1
  1060. package/dist/magma-components/{p-8feba226.entry.js → p-970f45df.entry.js} +1 -1
  1061. package/dist/magma-components/{p-9303fb16.system.entry.js → p-97a501cd.system.entry.js} +2 -2
  1062. package/dist/magma-components/{p-9e07535e.system.entry.js → p-98cc6473.system.entry.js} +26 -13
  1063. package/dist/magma-components/p-99d2ace2.system.entry.js +5 -0
  1064. package/dist/magma-components/{p-627c2780.entry.js → p-9aba3769.entry.js} +1 -1
  1065. package/dist/magma-components/{p-6d009b42.system.entry.js → p-9b0b65f0.system.entry.js} +2 -2
  1066. package/dist/magma-components/{p-f40e3918.system.entry.js → p-9b0d7f7d.system.entry.js} +2 -2
  1067. package/dist/magma-components/{p-5d1cba9c.system.entry.js → p-9b8d15a8.system.entry.js} +1 -1
  1068. package/dist/magma-components/{p-5931fdfc.system.entry.js → p-9e94f4a3.system.entry.js} +4 -4
  1069. package/dist/magma-components/{p-3b578659.system.entry.js → p-9f0100f2.system.entry.js} +2 -2
  1070. package/dist/magma-components/p-B8zYiZQY.system.js +1 -1
  1071. package/dist/magma-components/{p-CuHZXISO.system.js → p-BHdlb7Fr.system.js} +19 -19
  1072. package/dist/magma-components/p-BXVzhErg.system.js +12 -0
  1073. package/dist/magma-components/{p-OafT80hV.js → p-CATyfc78.js} +2 -2
  1074. package/dist/magma-components/{p-CZuIEo2v.system.js → p-Cbabyppz.system.js} +1 -1
  1075. package/dist/magma-components/{p-Dx_cCOTw.js → p-CxzVgcYv.js} +1 -1
  1076. package/dist/magma-components/{p-CxTugGM9.system.js → p-D3J9KZKy.system.js} +1 -1
  1077. package/dist/magma-components/{p-mGgjNqBm.system.js → p-DOisMne4.system.js} +17 -7
  1078. package/dist/magma-components/p-DwKxtKwS.js +1 -0
  1079. package/dist/{components/p-jasGzfhE.js → magma-components/p-Dx7iOdVP.js} +1 -1
  1080. package/dist/magma-components/{p-iX3kcwYg.js → p-DxR4rGsw.js} +1 -1
  1081. package/dist/magma-components/{p-ecc2893d.system.entry.js → p-a112a0e2.system.entry.js} +1 -1
  1082. package/dist/magma-components/{p-86f11a5a.entry.js → p-a2767235.entry.js} +1 -1
  1083. package/dist/magma-components/{p-c0286dc3.system.entry.js → p-a2c3b294.system.entry.js} +6 -6
  1084. package/dist/magma-components/{p-4669334a.system.entry.js → p-a2d4d849.system.entry.js} +2 -2
  1085. package/dist/magma-components/{p-cfbf3a76.system.entry.js → p-a48c73b1.system.entry.js} +2 -2
  1086. package/dist/magma-components/{p-4e8c5b68.entry.js → p-a4f53c83.entry.js} +1 -1
  1087. package/dist/magma-components/{p-e92327a2.entry.js → p-a58e8a5c.entry.js} +1 -1
  1088. package/dist/magma-components/{p-1a20f239.system.entry.js → p-a5ca10ae.system.entry.js} +1 -1
  1089. package/dist/magma-components/{p-46a928c3.entry.js → p-a9a872e1.entry.js} +1 -1
  1090. package/dist/magma-components/{p-0a0dfdf4.system.entry.js → p-a9ab9eb0.system.entry.js} +2 -2
  1091. package/dist/magma-components/{p-72971cf7.system.entry.js → p-ab1c3fb0.system.entry.js} +1 -1
  1092. package/dist/magma-components/{p-074d7b75.entry.js → p-ab445c2b.entry.js} +1 -1
  1093. package/dist/magma-components/{p-45a3e7eb.entry.js → p-abe32d5b.entry.js} +1 -1
  1094. package/dist/magma-components/{p-2e68180d.system.entry.js → p-af56e3e4.system.entry.js} +2 -2
  1095. package/dist/magma-components/{p-ed4fd7a4.entry.js → p-b1238d48.entry.js} +1 -1
  1096. package/dist/magma-components/{p-4748378e.system.entry.js → p-b129b127.system.entry.js} +14 -14
  1097. package/dist/magma-components/{p-e79eb427.system.entry.js → p-b1cd3acf.system.entry.js} +2 -2
  1098. package/dist/magma-components/{p-5aa8f150.entry.js → p-b705b805.entry.js} +1 -1
  1099. package/dist/magma-components/{p-2111aa67.system.entry.js → p-b7d18d7a.system.entry.js} +1 -1
  1100. package/dist/magma-components/{p-3be9b384.system.entry.js → p-b871ad36.system.entry.js} +10 -10
  1101. package/dist/magma-components/{p-f7426a75.entry.js → p-ba871d9c.entry.js} +1 -1
  1102. package/dist/magma-components/{p-5a8fa2d0.entry.js → p-ba95bf93.entry.js} +1 -1
  1103. package/dist/magma-components/{p-3af8a86a.system.entry.js → p-bc054fa3.system.entry.js} +3 -3
  1104. package/dist/magma-components/{p-05455645.system.entry.js → p-bcc6c358.system.entry.js} +2 -2
  1105. package/dist/magma-components/{p-7c3a7521.entry.js → p-bd489df9.entry.js} +1 -1
  1106. package/dist/magma-components/{p-60acbc5f.system.entry.js → p-c0295a0e.system.entry.js} +2 -2
  1107. package/dist/magma-components/p-c06d8b5a.entry.js +1 -0
  1108. package/dist/magma-components/p-c131d726.entry.js +1 -0
  1109. package/dist/magma-components/{p-198ea5d8.entry.js → p-c49676e6.entry.js} +1 -1
  1110. package/dist/magma-components/{p-2a445b98.system.entry.js → p-c4c1ef48.system.entry.js} +78 -78
  1111. package/dist/magma-components/{p-87831da2.system.entry.js → p-c54f2089.system.entry.js} +1 -1
  1112. package/dist/magma-components/{p-8b8cd213.system.entry.js → p-c691f27e.system.entry.js} +3 -3
  1113. package/dist/magma-components/p-c8414ee6.entry.js +1 -0
  1114. package/dist/magma-components/{p-9ef64212.entry.js → p-c8c918d2.entry.js} +3 -3
  1115. package/dist/magma-components/{p-85376ff5.entry.js → p-c91cb63a.entry.js} +1 -1
  1116. package/dist/magma-components/{p-9f55fa7a.system.entry.js → p-c94e7973.system.entry.js} +2 -2
  1117. package/dist/magma-components/{p-387fa36d.system.entry.js → p-c9baa3fb.system.entry.js} +1 -1
  1118. package/dist/magma-components/{p-b781c932.system.entry.js → p-ca4e8601.system.entry.js} +1 -1
  1119. package/dist/magma-components/{p-445bc62a.system.entry.js → p-ca5427d4.system.entry.js} +1 -1
  1120. package/dist/magma-components/{p-4646cdc0.system.entry.js → p-caca78ff.system.entry.js} +2 -2
  1121. package/dist/magma-components/{p-d85f3e5e.system.entry.js → p-caf478ff.system.entry.js} +2 -2
  1122. package/dist/magma-components/{p-b8f4938a.entry.js → p-cb06839f.entry.js} +1 -1
  1123. package/dist/magma-components/{p-d29c959d.entry.js → p-ce42734f.entry.js} +1 -1
  1124. package/dist/magma-components/{p-8aa4cd10.entry.js → p-d1e4a032.entry.js} +1 -1
  1125. package/dist/magma-components/{p-cd6dd836.entry.js → p-d25a47fa.entry.js} +1 -1
  1126. package/dist/magma-components/{p-0d3da482.system.entry.js → p-d29b32b4.system.entry.js} +1 -1
  1127. package/dist/magma-components/{p-1f746ad1.system.entry.js → p-d2ba5851.system.entry.js} +9 -9
  1128. package/dist/magma-components/{p-d50d4023.entry.js → p-d365c6b6.entry.js} +1 -1
  1129. package/dist/magma-components/{p-7a920b70.entry.js → p-d3b06151.entry.js} +1 -1
  1130. package/dist/magma-components/{p-4cd21f19.entry.js → p-d45f65e0.entry.js} +1 -1
  1131. package/dist/magma-components/{p-fdedc0ba.entry.js → p-d51ec950.entry.js} +1 -1
  1132. package/dist/magma-components/{p-4606d11f.entry.js → p-d760c1fa.entry.js} +1 -1
  1133. package/dist/magma-components/p-d785d7ee.entry.js +1 -0
  1134. package/dist/magma-components/{p-08da465d.entry.js → p-d9092133.entry.js} +1 -1
  1135. package/dist/magma-components/{p-03fb86a6.system.entry.js → p-dd348171.system.entry.js} +2 -2
  1136. package/dist/magma-components/{p-dcb5f965.entry.js → p-de423b11.entry.js} +1 -1
  1137. package/dist/magma-components/{p-97217527.system.entry.js → p-df78b7ac.system.entry.js} +1 -1
  1138. package/dist/magma-components/{p-fba648e0.entry.js → p-e39b5e12.entry.js} +1 -1
  1139. package/dist/magma-components/{p-99bfa07e.system.entry.js → p-eac943e5.system.entry.js} +1 -1
  1140. package/dist/magma-components/{p-9ef0d4e5.system.entry.js → p-eb220deb.system.entry.js} +2 -2
  1141. package/dist/magma-components/{p-fd81c4ef.system.entry.js → p-eca42fe8.system.entry.js} +2 -2
  1142. package/dist/magma-components/{p-56a25ec6.entry.js → p-ecda3e45.entry.js} +1 -1
  1143. package/dist/magma-components/{p-b523fabe.system.entry.js → p-f0909679.system.entry.js} +2 -2
  1144. package/dist/magma-components/{p-8bf8e032.entry.js → p-f2649031.entry.js} +1 -1
  1145. package/dist/magma-components/{p-30f95d10.entry.js → p-f51ed098.entry.js} +1 -1
  1146. package/dist/magma-components/{p-11210b60.system.entry.js → p-f5bd5b64.system.entry.js} +3 -3
  1147. package/dist/magma-components/p-f6358241.system.entry.js +19 -0
  1148. package/dist/magma-components/{p-b0850daa.entry.js → p-f9f3ad86.entry.js} +1 -1
  1149. package/dist/magma-components/{p-a3d09996.entry.js → p-fb4b648a.entry.js} +1 -1
  1150. package/dist/magma-components/{p-81d2582a.entry.js → p-fd4588c5.entry.js} +1 -1
  1151. package/dist/magma-components/{p-3b494de7.entry.js → p-fdd17ee6.entry.js} +1 -1
  1152. package/dist/magma-components/p-fe51c0cb.system.entry.js +10 -0
  1153. package/dist/magma-components/{p-a3156523.system.entry.js → p-ff6cf4f8.system.entry.js} +3 -3
  1154. package/dist/magma-components/{p-4da1c089.entry.js → p-ff76c614.entry.js} +1 -1
  1155. package/dist/{lint/mcp → mcp}/checks.js +4 -4
  1156. package/dist/{lint/mcp → mcp}/components.js +4 -6
  1157. package/dist/{lint/mcp → mcp}/guides.js +11 -9
  1158. package/dist/{lint/mcp → mcp}/icons.js +21 -0
  1159. package/dist/mcp/package.json +3 -0
  1160. package/dist/{lint/mcp → mcp}/patterns.js +8 -9
  1161. package/dist/{lint/mcp → mcp}/protocol.js +1 -1
  1162. package/dist/{lint/mcp → mcp}/render.js +61 -33
  1163. package/dist/{lint/mcp → mcp}/server.js +4 -4
  1164. package/dist/{lint/mcp → mcp}/tokens.js +1 -2
  1165. package/dist/mcp/tools.json +1374 -0
  1166. package/dist/stats.json +2304 -2021
  1167. package/dist/types/common/aria.d.ts +8 -1
  1168. package/dist/types/common/preference.d.ts +13 -1
  1169. package/dist/types/components/mds-button/mds-button.d.ts +50 -4
  1170. package/dist/types/components/mds-button-dropdown/mds-button-dropdown.d.ts +22 -2
  1171. package/dist/types/components/mds-modal/mds-modal.d.ts +8 -1
  1172. package/dist/types/components/mds-pref/mds-pref.d.ts +0 -9
  1173. package/dist/types/components/mds-pref-mode/mds-pref-mode.d.ts +16 -5
  1174. package/dist/types/components/mds-pref-theme/mds-pref-theme.d.ts +14 -1
  1175. package/dist/types/components.d.ts +67 -13
  1176. package/dist/types/type/button.d.ts +2 -0
  1177. package/package.json +12 -11
  1178. package/dist/components/p-BwT0RJip.js +0 -1
  1179. package/dist/components/p-COUgBzJ4.js +0 -1
  1180. package/dist/components/p-Cvhn9asj.js +0 -1
  1181. package/dist/components/p-G7Udw5H5.js +0 -1
  1182. package/dist/components/p-Ic8cYsgt.js +0 -1
  1183. package/dist/components/p-l0KS6hTQ.js +0 -1
  1184. package/dist/esm-es5/aria-Cvhn9asj.js +0 -6
  1185. package/dist/lint/mcp/checks.d.ts +0 -29
  1186. package/dist/lint/mcp/cli.d.ts +0 -2
  1187. package/dist/lint/mcp/color.d.ts +0 -12
  1188. package/dist/lint/mcp/components.d.ts +0 -5
  1189. package/dist/lint/mcp/context.d.ts +0 -45
  1190. package/dist/lint/mcp/guides.d.ts +0 -3
  1191. package/dist/lint/mcp/icons.d.ts +0 -9
  1192. package/dist/lint/mcp/patterns.d.ts +0 -75
  1193. package/dist/lint/mcp/protocol.d.ts +0 -77
  1194. package/dist/lint/mcp/render-page.d.ts +0 -40
  1195. package/dist/lint/mcp/render.d.ts +0 -130
  1196. package/dist/lint/mcp/server.d.ts +0 -39
  1197. package/dist/lint/mcp/tokens.d.ts +0 -37
  1198. package/dist/magma-components/p-06691ab3.system.entry.js +0 -27
  1199. package/dist/magma-components/p-1d8485de.system.entry.js +0 -28
  1200. package/dist/magma-components/p-21345ecc.entry.js +0 -1
  1201. package/dist/magma-components/p-25dcbf22.entry.js +0 -1
  1202. package/dist/magma-components/p-37881115.system.entry.js +0 -14
  1203. package/dist/magma-components/p-4e5b8618.system.entry.js +0 -1
  1204. package/dist/magma-components/p-69319301.system.entry.js +0 -10
  1205. package/dist/magma-components/p-7b06b2f2.entry.js +0 -1
  1206. package/dist/magma-components/p-7d61f442.entry.js +0 -1
  1207. package/dist/magma-components/p-97c6e10a.entry.js +0 -1
  1208. package/dist/magma-components/p-9e2b1a29.entry.js +0 -1
  1209. package/dist/magma-components/p-9ed54db1.entry.js +0 -1
  1210. package/dist/magma-components/p-Cvhn9asj.js +0 -1
  1211. package/dist/magma-components/p-a8206d9c.entry.js +0 -1
  1212. package/dist/magma-components/p-b464668b.system.entry.js +0 -105
  1213. package/dist/magma-components/p-b85f56d7.entry.js +0 -1
  1214. package/dist/magma-components/p-c7dc17f8.entry.js +0 -1
  1215. package/dist/magma-components/p-d43e2a9a.entry.js +0 -1
  1216. package/dist/magma-components/p-ddfb4da3.entry.js +0 -1
  1217. package/dist/magma-components/p-e428490d.system.entry.js +0 -5
  1218. package/dist/magma-components/p-f045b018.entry.js +0 -1
  1219. package/dist/magma-components/p-f5d9f625.entry.js +0 -1
  1220. package/dist/magma-components/p-fa387b74.system.entry.js +0 -5
  1221. package/dist/magma-components/p-fbf563c8.entry.js +0 -1
  1222. package/dist/magma-components/p-ff82edad.entry.js +0 -1
  1223. package/dist/magma-components/p-sm_-_oFY.system.js +0 -6
  1224. /package/dist/{lint/mcp → mcp}/cli.js +0 -0
  1225. /package/dist/{lint/mcp → mcp}/color.js +0 -0
  1226. /package/dist/{lint/mcp → mcp}/context.js +0 -0
  1227. /package/dist/{lint/mcp → mcp}/icon.svg +0 -0
  1228. /package/dist/{lint/mcp → mcp}/render-page.js +0 -0
@@ -1,5 +1,5 @@
1
1
  {
2
- "timestamp": "2026-11-04T15:13:27",
2
+ "timestamp": "2026-11-06T15:30:27",
3
3
  "compiler": {
4
4
  "name": "@stencil/core",
5
5
  "version": "4.45.2",
@@ -47,7 +47,7 @@
47
47
  }
48
48
  ],
49
49
  "usage": {
50
- "1. Description": "The `<mds-modal>` web component is the Magma Design System overlay container for dialogs, presenting content in a windowed surface layered above the page with an optional backdrop. It is the system equivalent of the native `<dialog>` element, adding managed open/close animations, body scroll locking, positioning, and a built-in close affordance.\n\n#### Semantic Behavior\n\n- **Open state**: Visibility is driven by the `opened` prop. Setting it `true` runs the intro animation and emits `mdsModalOpen`; clearing it runs the outro animation and emits `mdsModalClose`.\n- **Programmatic close**: Exposes an async `close()` method that dismisses the modal regardless of `interaction`, mirroring the close-button action.\n- **Show/hide events**: `mdsModalShow` fires when the intro finishes (fully visible) and `mdsModalHide` when the outro finishes (fully hidden), the latter being the safe point to detach the modal to reclaim memory.\n- **Backdrop dismissal**: With `interaction=\"relaxed\"` (default) a click on the backdrop or `Esc` closes the modal; with `interaction=\"strict\"` both are ignored, and the touch swipe too (below): only the close button or `close()` can dismiss it.\n- **Body scroll lock**: When `overflow=\"auto\"` the component locks body scroll while open and restores it on close.\n- **Touch dismissal**: On touch devices a horizontal swipe past a threshold closes a `relaxed` modal, respecting the swipe direction implied by edge `position` values.\n- **Slot-driven layout**: With no `window` slot, the default slot renders centered content framed by optional `top` (header) and `bottom` (footer) slots, and a close button is rendered automatically, icon-only and named in the page language (the `lang` of `<html>`) (\"Close\"). Slotting a `window` element suppresses the built-in chrome and close button so the consumer supplies the entire surface.\n- **Width of a slotted window**: The `window` element stops at the width of a dialog, `--magma-width-dialog` (the column of a form plus its inset, 580px at 16px: `widths/dialog` of the design language), and shrinks with a narrower screen, its margin around it. A class on the element wins over it, for a bespoke surface.\n- **Close button placement**: The built-in close button sits on the backdrop, in a strip the window always leaves free, so a `strict` modal can be closed whatever its content. `left` and `right` leave it at their side at every width.\n- **Narrow screens**: At a viewport of 480px or less a window that would fill the screen (`center` and the four corners) leaves a strip of backdrop at the top, where the close button shows, as `left` and `right` leave one at their side; `top` and `bottom` stay as tall as their content but never taller than the screen less that strip, which stays on their free side with the close button at its edge (top right for `bottom`, bottom right for `top`).\n- **Wide screens**: Above 480px every window leaves a strip of backdrop at its side, with the close button at its top: `center`, `top` and `bottom` one on each side, the button at the top right; the corners one on the side away from their own, the button there.\n\n#### Properties & Visual Configurations\n\nThis component does not use the shared `variant` / `tone` ladders; its configuration is structural and motion-oriented.\n\n#### Other behavioral props\n\n- **`position`** sets where the window animates from and rests, from `'center'` to edge and corner anchors (`'top'`, `'bottom-left'`, etc.); edge positions also define the valid swipe-to-dismiss direction.\n- **`animation`** selects the motion style of the window: `'slide'` (default), `'3d'`, or `'custom'` (driven entirely by CSS custom properties).\n- **`interaction`** governs how forgiving dismissal is - `'relaxed'` allows backdrop clicks, `'strict'` requires the close button.\n- **`overflow`** chooses whether the component manages body scroll locking (`'auto'`) or leaves it to the consumer (`'manual'`).\n- **`hideBackdrop`** removes the dimmed overlay behind the window (shown by default).\n",
50
+ "1. Description": "The `<mds-modal>` web component is the Magma Design System overlay container for dialogs, presenting content in a windowed surface layered above the page with an optional backdrop. It is the system equivalent of the native `<dialog>` element, adding managed open/close animations, body scroll locking, positioning, and a built-in close affordance.\n\n#### Semantic Behavior\n\n- **Open state**: Visibility is driven by the `opened` prop. Setting it `true` runs the intro animation and emits `mdsModalOpen`; clearing it runs the outro animation and emits `mdsModalClose`.\n- **Programmatic close**: Exposes an async `close()` method that dismisses the modal regardless of `interaction`, mirroring the close-button action.\n- **Show/hide events**: `mdsModalShow` fires when the intro finishes (fully visible) and `mdsModalHide` when the outro finishes (fully hidden), the latter being the safe point to detach the modal to reclaim memory.\n- **Backdrop dismissal**: With `interaction=\"relaxed\"` (default) a click on the backdrop or `Esc` closes the modal. The click counts when it is pressed and released on the backdrop once the window has stopped: a text selection dragged out of a field, a drag from the backdrop into the window or a click while the window is still coming in leave the modal open. With `interaction=\"strict\"` both are ignored, and the touch swipe too (below): only the close button or `close()` can dismiss it.\n- **Body scroll lock**: When `overflow=\"auto\"` the component locks body scroll while open and restores it on close.\n- **Touch dismissal**: On touch devices a horizontal swipe past a threshold closes a `relaxed` modal, respecting the swipe direction implied by edge `position` values.\n- **Slot-driven layout**: With no `window` slot, the default slot renders centered content framed by optional `top` (header) and `bottom` (footer) slots, and a close button is rendered automatically, icon-only and named in the page language (the `lang` of `<html>`) (\"Close\"). Slotting a `window` element suppresses the built-in chrome and close button so the consumer supplies the entire surface.\n- **Width of a slotted window**: The `window` element stops at the width of a dialog, `--magma-width-dialog` (the column of a form plus its inset, 580px at 16px: `widths/dialog` of the design language), and shrinks with a narrower screen, its margin around it. A class on the element wins over it, for a bespoke surface.\n- **Close button placement**: The built-in close button sits on the backdrop, in a strip the window always leaves free, so a `strict` modal can be closed whatever its content. `left` and `right` leave it at their side at every width.\n- **Narrow screens**: At a viewport of 480px or less a window that would fill the screen (`center` and the four corners) leaves a strip of backdrop at the top, where the close button shows, as `left` and `right` leave one at their side; `top` and `bottom` stay as tall as their content but never taller than the screen less that strip, which stays on their free side with the close button at its edge (top right for `bottom`, bottom right for `top`).\n- **Wide screens**: Above 480px every window leaves a strip of backdrop at its side, with the close button at its top: `center`, `top` and `bottom` one on each side, the button at the top right; the corners one on the side away from their own, the button there.\n\n#### Properties & Visual Configurations\n\nThis component does not use the shared `variant` / `tone` ladders; its configuration is structural and motion-oriented.\n\n#### Other behavioral props\n\n- **`position`** sets where the window animates from and rests, from `'center'` to edge and corner anchors (`'top'`, `'bottom-left'`, etc.); edge positions also define the valid swipe-to-dismiss direction.\n- **`animation`** selects the motion style of the window: `'slide'` (default), `'3d'`, or `'custom'` (driven entirely by CSS custom properties).\n- **`interaction`** governs how forgiving dismissal is - `'relaxed'` allows backdrop clicks, `'strict'` requires the close button.\n- **`overflow`** chooses whether the component manages body scroll locking (`'auto'`) or leaves it to the consumer (`'manual'`).\n- **`hideBackdrop`** removes the dimmed overlay behind the window (shown by default).\n",
51
51
  "2. Examples": "Correct and idiomatic ways to use the `<mds-modal>` component, ordered from most common to most specialized. The examples assume a working knowledge of the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Basic Modal with Inline Content\n\nThe simplest form: toggle `opened` from JavaScript to show the dialog. The built-in close button and backdrop dismiss the modal automatically with `interaction=\"relaxed\"` (default). React to the `mdsModalClose` event to sync your state.\n\n```html\n<mds-button id=\"btn-apri\">Apri dialogo</mds-button>\n\n<mds-modal id=\"dialogo\">\n <div class=\"p-400\">\n <mds-text>Sei sicuro di voler continuare?</mds-text>\n </div>\n</mds-modal>\n\n<script>\n const btn = document.getElementById('btn-apri');\n const modal = document.getElementById('dialogo');\n btn.addEventListener('click', () => { modal.opened = true; });\n modal.addEventListener('mdsModalClose', () => { modal.opened = undefined; });\n</script>\n```\n\n#### Fixed Header and Footer via `top` / `bottom` Slots\n\nUse the `top` slot for a sticky header and the `bottom` slot for a sticky footer (e.g. action buttons). The default slot renders scrollable body content between them.\n\n```html\n<mds-modal id=\"modifica-utente\" position=\"right\">\n <header slot=\"top\" class=\"p-400 bg-surface-overlay shadow-ring-weak\">\n <mds-text typography=\"h5\">Modifica utente</mds-text>\n </header>\n\n <div class=\"p-400 grid gap-400\">\n <mds-input-field label=\"Nome\">\n <mds-input name=\"nome\"></mds-input>\n </mds-input-field>\n <mds-input-field label=\"Cognome\">\n <mds-input name=\"cognome\"></mds-input>\n </mds-input-field>\n </div>\n\n <footer slot=\"bottom\" class=\"p-400 flex gap-300 justify-end bg-surface-overlay shadow-ring-weak\">\n <mds-button variant=\"dark\" tone=\"outline\" id=\"btn-annulla\">Annulla</mds-button>\n <mds-button variant=\"primary\" tone=\"strong\" id=\"btn-salva\">Salva</mds-button>\n </footer>\n</mds-modal>\n```\n\n#### Edge and Corner Positions\n\n`position` anchors the window to an edge or corner and drives the slide-in direction. Use `right` or `left` for side panels, `bottom` for mobile drawers.\n\n```html\n<!-- Side panel from the right (default in most app shells) -->\n<mds-modal id=\"pannello-laterale\" position=\"right\">\n <div class=\"p-400\">\n <mds-text>Dettagli del documento</mds-text>\n </div>\n</mds-modal>\n\n<!-- Drawer from the bottom (mobile) -->\n<mds-modal id=\"drawer-mobile\" position=\"bottom\">\n <div class=\"p-400\">\n <mds-text>Azioni disponibili</mds-text>\n </div>\n</mds-modal>\n```\n\n#### Strict Interaction Mode\n\nSet `interaction=\"strict\"` when the user must explicitly confirm or cancel before the dialog closes - for example, a form with unsaved changes. Backdrop clicks, `Esc` and touch swipes are ignored; only the close button or the `close()` method can dismiss the modal.\n\n```html\n<mds-modal id=\"conferma-elimina\" interaction=\"strict\">\n <div class=\"p-400 grid gap-400\">\n <mds-text typography=\"h5\">Eliminare il documento?</mds-text>\n <mds-text>Questa operazione non e' reversibile.</mds-text>\n <div class=\"flex gap-300 justify-end\">\n <mds-button variant=\"dark\" tone=\"outline\" id=\"btn-no\">Annulla</mds-button>\n <mds-button variant=\"error\" tone=\"strong\" id=\"btn-si\">Elimina</mds-button>\n </div>\n </div>\n</mds-modal>\n\n<script>\n document.getElementById('btn-no').addEventListener('click', () => {\n document.getElementById('conferma-elimina').close();\n });\n</script>\n```\n\n#### Programmatic Close via `close()` Method\n\nCall the async `close()` method from JavaScript when you need to dismiss the modal from outside its UI - for example, after a successful async operation.\n\n```html\n<mds-modal id=\"salvataggio\">\n <div class=\"p-400\">\n <mds-text>Salvataggio in corso...</mds-text>\n </div>\n</mds-modal>\n\n<script>\n async function salva() {\n const modal = document.getElementById('salvataggio');\n modal.opened = true;\n await salvaRisorsa();\n await modal.close();\n }\n</script>\n```\n\n#### Listening to Animation Events\n\n`mdsModalShow` fires when the intro animation completes (the modal is fully visible). Use it to focus the first interactive element. `mdsModalHide` fires when the outro animation completes; use it to detach the element or reset content.\n\n```html\n<mds-modal id=\"modal-focus\" position=\"right\">\n <div class=\"p-400\">\n <mds-input-field label=\"Cerca\">\n <mds-input id=\"input-ricerca\" name=\"ricerca\"></mds-input>\n </mds-input-field>\n </div>\n</mds-modal>\n\n<script>\n const modal = document.getElementById('modal-focus');\n const input = document.getElementById('input-ricerca');\n\n modal.addEventListener('mdsModalShow', () => {\n input.setFocus();\n });\n modal.addEventListener('mdsModalHide', () => {\n // safe point to detach or reset content\n modal.opened = undefined;\n });\n</script>\n```\n\n#### Custom Animation Styles\n\n`animation` selects the motion style. `'slide'` (default) translates from the entry edge; `'3d'` adds a perspective tilt; `'custom'` delegates entirely to the CSS custom properties `--mds-modal-custom-closed-transform` and `--mds-modal-custom-window-distance`.\n\n```html\n<!-- 3D perspective tilt animation -->\n<mds-modal id=\"modal-3d\" animation=\"3d\" position=\"center\">\n <div class=\"p-400\">\n <mds-text>Animazione 3D</mds-text>\n </div>\n</mds-modal>\n\n<!-- Custom animation driven by CSS vars -->\n<mds-modal id=\"modal-custom\" animation=\"custom\" position=\"center\">\n <div class=\"p-400\">\n <mds-text>Animazione personalizzata</mds-text>\n </div>\n</mds-modal>\n```\n\n#### The Window of a Dialog via the `window` Slot\n\nSlot an element with `slot=\"window\"` to replace the built-in chrome (the window surface and the close button). A dialog slots an [`mds-banner`](../mds-banner/AGENTS.md) `variant=\"light\"` `tone=\"box\"` `dismissible`: its own close button closes the modal. The slotted element gets no `role` of its own: the `<dialog>` the component renders is already the dialog, named by the `aria-label` of the host. The actions follow the rules of a dialog: the secondary one `dark` `outline`, the main one last.\n\nThe window stops at the width of a dialog, the column of a form plus its inset (`--magma-width-dialog`, 580px at 16px, `widths/dialog` of the design language), and shrinks with a narrower screen. Write no width on it: a form keeps in the window the shape it has in the page.\n\n```html\n<mds-modal id=\"modal-banner\" aria-label=\"Azione richiesta\">\n <mds-banner slot=\"window\" variant=\"light\" tone=\"box\" dismissible headline=\"Azione richiesta\">\n <mds-text typography=\"detail\">Conferma la tua identita' per procedere.</mds-text>\n <mds-button slot=\"action\" variant=\"dark\" tone=\"outline\">Annulla</mds-button>\n <mds-button slot=\"action\" variant=\"primary\" tone=\"strong\">Conferma</mds-button>\n </mds-banner>\n</mds-modal>\n```\n\nA bespoke surface, such as a banner as wide as the screen, writes its own width with a class: from the light DOM it wins over the width of a dialog.\n\n```html\n<mds-modal id=\"modal-novita\" aria-label=\"Novita'\">\n <mds-banner slot=\"window\" class=\"max-w-none\" variant=\"light\" tone=\"box\" dismissible headline=\"Novita'\">\n <mds-text typography=\"detail\">Da oggi puoi firmare i documenti dall'app.</mds-text>\n </mds-banner>\n</mds-modal>\n```\n\n#### Disabling the Backdrop\n\nAdd `hide-backdrop` to render the modal without the dimmed overlay - useful for non-blocking side panels that coexist with interactive page content.\n\n```html\n<mds-modal id=\"pannello-info\" position=\"right\" hide-backdrop>\n <div class=\"p-400\">\n <mds-text>Informazioni contestuali</mds-text>\n </div>\n</mds-modal>\n```\n\n```javascript\n// Remove the backdrop from JavaScript (it applies from the next opening)\ndocument.getElementById('pannello-info').hideBackdrop = true;\n```\n\n#### CSS Customization\n\nSize and place the window only through the public `--mds-modal-*` CSS custom properties. Set them on the host element; the window takes its background, radius and shadow from the component. They size the built-in window: a slotted window takes the width of a dialog, or the one its class gives it.\n\n```css\n/* Narrow center modal */\n#modal-card {\n --mds-modal-window-distance: calc(var(--spacing) * 600);\n --mds-modal-window-overflow: hidden;\n --mds-modal-window-max-width: 480px;\n}\n\n/* Full-width drawer */\n#drawer-bottom {\n --mds-modal-window-max-width: 100%;\n --mds-modal-window-min-width: 100%;\n}\n```\n",
52
52
  "3. Mistakes": "Common incorrect uses of `<mds-modal>`. 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/mistakes.md`](../../../../agents/mistakes.md) - they apply here too but are not repeated.\n\n#### Do Not Set `opened=\"false\"` to Close the Modal\n\nA false boolean is an absent attribute ([`agents/conventions.md`](../../../../agents/conventions.md)). The runtime does parse the string `\"false\"` as `false`, so the modal stays closed, but the attribute is still on the element until the first render, so `[opened]` attribute selectors and any code that reads the attribute see it set. Remove the attribute; from JavaScript set the prop to `undefined` (`false` works too: the component turns it into `undefined`).\n\n```html\n<!-- INCORRECT -->\n<mds-modal id=\"dialogo\" opened=\"false\"></mds-modal>\n\n<!-- CORRECT -->\n<mds-modal id=\"dialogo\"></mds-modal>\n```\n\n#### Do Not Put Content in the `window` Slot Without Replacing the Entire Chrome\n\nThe `window` slot completely bypasses the built-in surface, header/footer regions, and close button. Do not use it to add a header element while expecting the default content area and close button to still render - they will not.\n\n```html\n<!-- INCORRECT: only the slotted header renders; default slot and close button are suppressed -->\n<mds-modal id=\"modal\">\n <header slot=\"window\" class=\"p-400\">Titolo</header>\n <div>Contenuto del dialogo</div>\n</mds-modal>\n\n<!-- CORRECT: use slot=\"top\" for a sticky header, default slot for body -->\n<mds-modal id=\"modal\">\n <header slot=\"top\" class=\"p-400 bg-surface-overlay\">Titolo</header>\n <div class=\"p-400\">Contenuto del dialogo</div>\n</mds-modal>\n```\n\n#### Do Not Size the Window of a Dialog by Hand\n\nA slotted window already stops at the width of a dialog, the column of a form plus its inset (`widths/dialog`), and shrinks with the screen. A width written by hand copies a value the theme no longer moves, and a narrower one breaks the form inside: at `max-w-md` (448px) the body of the window is under the `28rem` of `field-group`, so its short fields stack as on a phone.\n\n```html\n<!-- INCORRECT -->\n<mds-modal aria-label=\"Nuovo referente\">\n <mds-banner slot=\"window\" class=\"max-w-md w-full mx-400\" variant=\"light\" tone=\"box\" dismissible headline=\"Nuovo referente\">\n <fieldset class=\"field-group\">...</fieldset>\n </mds-banner>\n</mds-modal>\n\n<!-- CORRECT -->\n<mds-modal aria-label=\"Nuovo referente\">\n <mds-banner slot=\"window\" variant=\"light\" tone=\"box\" dismissible headline=\"Nuovo referente\">\n <fieldset class=\"field-group\">...</fieldset>\n </mds-banner>\n</mds-modal>\n```\n\n#### Do Not Reach Into Shadow Parts to Style the Window\n\nThe only supported customization surface is the public `--mds-modal-*` CSS custom properties and the documented shadow parts (`dialog`, `window`, `action-close`). Targeting internal shadow selectors couples your code to implementation details that will break on minor releases.\n\n```css\n/* INCORRECT */\nmds-modal >>> .window-content {\n padding: 0;\n}\nmds-modal::part(window) > div {\n border: 2px solid red;\n}\n\n/* CORRECT */\nmds-modal {\n --mds-modal-window-distance: calc(var(--spacing) * 400);\n}\n```\n\n#### Do Not Listen for Native `click` on the Backdrop to Close\n\n`mds-modal` emits `mdsModalClose` when it closes (and `mdsModalHide` when the animation finishes). Listening for a raw `click` on the host or backdrop is fragile - the event target varies by browser and shadow DOM boundary, and your handler ignores `interaction=\"strict\"`.\n\n```javascript\n// INCORRECT\ndocument.getElementById('modal').addEventListener('click', (e) => {\n if (e.target === e.currentTarget) modal.opened = undefined;\n});\n\n// CORRECT\ndocument.getElementById('modal').addEventListener('mdsModalClose', () => {\n modal.opened = undefined;\n});\n```\n\n#### Do Not Use `<dialog>` Directly When `<mds-modal>` Is Available\n\nUsing a raw `<dialog>` element bypasses the system's managed animation, body-scroll locking, touch-swipe dismissal, and design-token theming. Always use `<mds-modal>` for overlays in a Magma application.\n\n```html\n<!-- INCORRECT -->\n<dialog id=\"raw-dialog\">\n <p>Contenuto del dialogo</p>\n <button>Chiudi</button>\n</dialog>\n\n<!-- CORRECT -->\n<mds-modal id=\"modal\">\n <div class=\"p-400\">\n <mds-text>Contenuto del dialogo</mds-text>\n </div>\n</mds-modal>\n```\n"
53
53
  },
@@ -176,7 +176,7 @@
176
176
  "mutable": false,
177
177
  "attr": "interaction",
178
178
  "reflectToAttr": true,
179
- "docs": "Specifies if the component can be closed with close button, or also if the backdrop background is cliccked.\nIf `strict` is selected only the close button can dismiss the component via UI.\nIf `relaxed` is selected the component can be dismissed also by cliccking the backdrop area.",
179
+ "docs": "Specifies if the component can be closed with close button, or also if the backdrop background is cliccked.\nIf `strict` is selected only the close button can dismiss the component via UI.\nIf `relaxed` is selected the component can be dismissed also by clicking the backdrop area: a click\npressed and released on the backdrop, once the window has finished its entry.",
180
180
  "docsTags": [
181
181
  {
182
182
  "name": "default",
@@ -565,8 +565,8 @@
565
565
  "mds-button"
566
566
  ],
567
567
  "mds-button": [
568
- "mds-spinner",
569
568
  "mds-icon",
569
+ "mds-spinner",
570
570
  "mds-text"
571
571
  ],
572
572
  "mds-header": [
@@ -1027,7 +1027,8 @@ mds-button {
1027
1027
  * The close icon still needs a dark-mode value: it sits over the dark scrim, not
1028
1028
  * over the modal surface, so it does not follow the surface flip. */
1029
1029
 
1030
- :host([pref-mode='dark']:not([pref-theme-scheme='light'])) {
1030
+ :host([pref-mode='dark']:not([pref-theme-scheme='light'])),
1031
+ :host([pref-theme-scheme='dark']) {
1031
1032
  .action-close {
1032
1033
  --mds-button-color: rgb(var(--magma-text-default, var(--text-neutral-default, 5 5 5)));
1033
1034
  }
@@ -1035,7 +1036,7 @@ mds-button {
1035
1036
 
1036
1037
  @media (prefers-color-scheme: dark) {
1037
1038
  :host([pref-mode='system']:not([pref-theme-scheme='light'])),
1038
- :host(:not([pref-mode])) {
1039
+ :host(:not([pref-mode]):not([pref-theme-scheme='light'])) {
1039
1040
  .action-close {
1040
1041
  --mds-button-color: rgb(var(--magma-text-default, var(--text-neutral-default, 5 5 5)));
1041
1042
  }
@@ -35,6 +35,12 @@ export class MdsModal {
35
35
  // set by the `opened` watcher, consumed by the render that follows it (#803)
36
36
  this.openAfterRender = false;
37
37
  this.touchMargin = 50;
38
+ // from showModal() until the window has stopped (stopIntroAnimationWindow): a press on the
39
+ // backdrop does not count, the place where the window is going to stop is still backdrop (#1266)
40
+ this.entering = false;
41
+ // the press and the release of the next click, each on the backdrop or not (#1266)
42
+ this.pressedOnBackdrop = false;
43
+ this.releasedOnBackdrop = false;
38
44
  this.hasBottom = false;
39
45
  this.hasTop = false;
40
46
  this.hasWindow = false;
@@ -63,7 +69,8 @@ export class MdsModal {
63
69
  /**
64
70
  * Specifies if the component can be closed with close button, or also if the backdrop background is cliccked.
65
71
  * If `strict` is selected only the close button can dismiss the component via UI.
66
- * If `relaxed` is selected the component can be dismissed also by cliccking the backdrop area.
72
+ * If `relaxed` is selected the component can be dismissed also by clicking the backdrop area: a click
73
+ * pressed and released on the backdrop, once the window has finished its entry.
67
74
  */
68
75
  this.interaction = 'relaxed';
69
76
  this.updateCSSCustomProps = () => {
@@ -75,6 +82,7 @@ export class MdsModal {
75
82
  (_a = elementStyles.getPropertyValue('--mds-modal-transition-duration')) !== null && _a !== void 0 ? _a : '500';
76
83
  };
77
84
  this.stopIntroAnimationWindow = () => {
85
+ this.entering = false;
78
86
  this.setContentOverflow('auto');
79
87
  this.showEvent.emit();
80
88
  clearTimeout(this.animationDelayTimeout);
@@ -124,6 +132,7 @@ export class MdsModal {
124
132
  }
125
133
  };
126
134
  this.animateOpenWindow = () => {
135
+ this.entering = true;
127
136
  this.setContentOverflow('hidden');
128
137
  clearTimeout(this.animationDelayTimeout);
129
138
  // Fallback only: `handleWindowTransitionEnd` is the primary settle. The
@@ -210,13 +219,25 @@ export class MdsModal {
210
219
  this.dialogEl.close();
211
220
  }
212
221
  };
222
+ // The target of a press or a release that is the dialog itself, not its window contents, is
223
+ // the backdrop area.
224
+ this.handleBackdropPointerDown = (e) => {
225
+ this.pressedOnBackdrop = !this.entering && e.target === this.dialogEl;
226
+ };
227
+ this.handleBackdropPointerUp = (e) => {
228
+ this.releasedOnBackdrop = e.target === this.dialogEl;
229
+ };
230
+ // The browser sends a click to the nearest common ancestor of the press and the release: a
231
+ // press in a field of the window released on the backdrop, or the other way round, is a click
232
+ // on the dialog too. The modal closes only when both were on the backdrop (#1266).
213
233
  this.handleBackdropClick = (e) => {
234
+ const fromBackdrop = this.pressedOnBackdrop && this.releasedOnBackdrop;
235
+ this.pressedOnBackdrop = false;
236
+ this.releasedOnBackdrop = false;
214
237
  if (this.interaction === 'strict') {
215
238
  return;
216
239
  }
217
- // A click whose target is the dialog itself (not its window contents) is a
218
- // click on the backdrop area.
219
- if (e.target === this.dialogEl) {
240
+ if (fromBackdrop && e.target === this.dialogEl) {
220
241
  this.opened = undefined;
221
242
  }
222
243
  };
@@ -229,6 +250,10 @@ export class MdsModal {
229
250
  }
230
251
  this.opened = undefined;
231
252
  };
253
+ // the built-in close button dismisses the modal whatever the interaction
254
+ this.handleCloseClick = () => {
255
+ this.opened = undefined;
256
+ };
232
257
  }
233
258
  componentWillLoad() {
234
259
  this.updateSlots();
@@ -313,16 +338,10 @@ export class MdsModal {
313
338
  this.opened = undefined;
314
339
  }
315
340
  render() {
316
- return (h(Host, { key: '33b60e8adfe9b434c36dcef5243f12d2a9a518c4', "pref-animation": preferenceStore.state.animation, "pref-contrast": preferenceStore.state.contrast, "pref-mode": preferenceStore.state.mode, "pref-theme-scheme": preferenceStore.state['theme-scheme'] }, h("dialog", { key: '9a29c175b7ac5fc98ca9aa4c8b5447e61bdcb43c', "aria-label": this.accessibleName, class: "dialog", part: "dialog", ref: (el) => (this.dialogEl = el), onClick: (e) => {
317
- this.handleBackdropClick(e);
318
- }, onCancel: (e) => {
319
- this.handleCancel(e);
320
- } }, h("slot", { key: 'c21c82a17916bb366ed7b4cd550a23f6d0d9890d', name: "window", onSlotchange: this.updateSlots }), !this.hasWindow && (h("div", { key: 'bdd8f7428f3a3e5b5ccc9d3d508f35e87fd47769', class: "window", part: "window" }, h("div", { key: '05e5d050dd1278e87a72527505a8a6d281544c55', class: clsx('window-header', !this.hasTop && 'window-content--empty') }, h("slot", { key: '8f116fbf980f31e98edd85ae7cd8e48b2f28f324', name: "top", onSlotchange: this.updateSlots })), h("div", { key: '22ff52ba2c2ce0680928367dd84db6ae08bd9674', class: "window-content-wrapper" }, h("div", { key: '975a56ddbfe774c69a74032b30ff6d2540cded85', class: "window-content", style: {
341
+ return (h(Host, { key: '859a966ef6a14a504731f0bc65b911328c706456', "pref-animation": preferenceStore.state.animation, "pref-contrast": preferenceStore.state.contrast, "pref-mode": preferenceStore.state.mode, "pref-theme-scheme": preferenceStore.state['theme-scheme'] }, h("dialog", { key: '7e0e4f13b003063025c109cc94e4736cf9519fae', "aria-label": this.accessibleName, class: "dialog", part: "dialog", ref: (el) => (this.dialogEl = el), onPointerDown: this.handleBackdropPointerDown, onPointerUp: this.handleBackdropPointerUp, onClick: this.handleBackdropClick, onCancel: this.handleCancel }, h("slot", { key: 'f00bdad34be891f3308d67d430e6344eac141233', name: "window", onSlotchange: this.updateSlots }), !this.hasWindow && (h("div", { key: '85297787ce2b76e50198668b94326a5fba118b63', class: "window", part: "window" }, h("div", { key: '7591b57e2408a4618c1caade71b08d34a3859c01', class: clsx('window-header', !this.hasTop && 'window-content--empty') }, h("slot", { key: 'd6b749835d178e4a9db3b6bf8d86a75da2638e91', name: "top", onSlotchange: this.updateSlots })), h("div", { key: '24a0b8cae6e52b133644d0ccfc675af52d50d704', class: "window-content-wrapper" }, h("div", { key: '2769ae97279777081393fd09bad9c717db25b523', class: "window-content", style: {
321
342
  paddingTop: `${this.windowHeaderHeight}px`,
322
343
  paddingBottom: `${this.windowFooterHeight}px`,
323
- } }, h("slot", { key: '7897bfc69d390306a2e487eb786710913f8d622f' }))), h("div", { key: '5ab13c801e7ee346243241b8371b1ad839597d8c', class: clsx('window-footer', !this.hasBottom && 'window-content--empty') }, h("slot", { key: '949d9010754a7da67a6d517ea3fbce31afa41d55', name: "bottom", onSlotchange: this.updateSlots })))), !this.hasWindow && (h("mds-button", { key: 'f0bd0f34a6ffdd6769802810a8b367b874d46cd1', "aria-label": this.t.get('close'), class: "action-close", icon: miBaselineClose, variant: "light", tone: "text", size: "xl", onClick: () => {
324
- this.opened = undefined;
325
- }, part: "action-close" })))));
344
+ } }, h("slot", { key: 'eb21eb7b76d10df369c2963845a90684f5d94963' }))), h("div", { key: '57a2917eed9c6068f8fd3e70c9b502f52ac5f1d8', class: clsx('window-footer', !this.hasBottom && 'window-content--empty') }, h("slot", { key: '60a9265a196ad8b4a84c4bce855db1c0473f0184', name: "bottom", onSlotchange: this.updateSlots })))), !this.hasWindow && (h("mds-button", { key: '38d2abbd00bbdb2b4a2df4d94cf1d31156e4cb16', "aria-label": this.t.get('close'), class: "action-close", icon: miBaselineClose, variant: "light", tone: "text", size: "xl", onClick: this.handleCloseClick, part: "action-close" })))));
326
345
  }
327
346
  static get is() { return "mds-modal"; }
328
347
  static get encapsulation() { return "shadow"; }
@@ -497,7 +516,7 @@ export class MdsModal {
497
516
  "optional": false,
498
517
  "docs": {
499
518
  "tags": [],
500
- "text": "Specifies if the component can be closed with close button, or also if the backdrop background is cliccked.\nIf `strict` is selected only the close button can dismiss the component via UI.\nIf `relaxed` is selected the component can be dismissed also by cliccking the backdrop area."
519
+ "text": "Specifies if the component can be closed with close button, or also if the backdrop background is cliccked.\nIf `strict` is selected only the close button can dismiss the component via UI.\nIf `relaxed` is selected the component can be dismissed also by clicking the backdrop area: a click\npressed and released on the backdrop, once the window has finished its entry."
501
520
  },
502
521
  "getter": false,
503
522
  "setter": false,
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-note
8
8
 
9
- > `@maggioli-design-system/magma` 2.11.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
9
+ > `@maggioli-design-system/magma` 2.12.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
10
10
 
11
11
  The `<mds-note>` web component is the annotation surface of the Magma Design System: a short, colored sticky-note block used to attach a remark, reminder, or callout to surrounding content. It has no native HTML primitive - it renders as a semantic note region with an optional title and a decorative folded corner.
12
12
 
@@ -1,5 +1,5 @@
1
1
  {
2
- "timestamp": "2026-11-04T15:13:27",
2
+ "timestamp": "2026-11-06T15:30:27",
3
3
  "compiler": {
4
4
  "name": "@stencil/core",
5
5
  "version": "4.45.2",
@@ -226,8 +226,8 @@
226
226
  "mds-button"
227
227
  ],
228
228
  "mds-button": [
229
- "mds-spinner",
230
229
  "mds-icon",
230
+ "mds-spinner",
231
231
  "mds-text"
232
232
  ]
233
233
  },
@@ -244,7 +244,8 @@ mds-button {
244
244
  * for dark. `dark` is the explicit choice; `system` and no controller follow the
245
245
  * OS via @media; the scheme axis gates it. Cross-browser, no :host-context. */
246
246
 
247
- :host([pref-mode='dark']:not([pref-theme-scheme='light'])) {
247
+ :host([pref-mode='dark']:not([pref-theme-scheme='light'])),
248
+ :host([pref-theme-scheme='dark']) {
248
249
  box-shadow: var(--shadow-ring, 0 0 0 1px rgb(var(--tone-neutral-01, 5 5 5) / 0.3)) inset;
249
250
 
250
251
  &:host([variant='amaranth']) {
@@ -330,7 +331,7 @@ mds-button {
330
331
 
331
332
  @media (prefers-color-scheme: dark) {
332
333
  :host([pref-mode='system']:not([pref-theme-scheme='light'])),
333
- :host(:not([pref-mode])) {
334
+ :host(:not([pref-mode]):not([pref-theme-scheme='light'])) {
334
335
  box-shadow: var(--shadow-ring, 0 0 0 1px rgb(var(--tone-neutral-01, 5 5 5) / 0.3)) inset;
335
336
 
336
337
  &:host([variant='amaranth']) {
@@ -53,7 +53,7 @@ export class MdsNote {
53
53
  this.km.detachClickBehavior();
54
54
  }
55
55
  render() {
56
- return (h(Host, { key: 'c35582b371682defc36ce83a07b578ea47a79bae', role: "note", "pref-animation": preferenceStore.state.animation, "pref-contrast": preferenceStore.state.contrast, "pref-mode": preferenceStore.state.mode, "pref-theme-scheme": preferenceStore.state['theme-scheme'] }, this.deletable && (h("mds-button", { key: 'f382186bccb732247b6c3f64a1ea4398cad8b3a8', title: this.t.get('deleteLabel'), icon: miBaselineClose, class: "button-close", variant: "dark", tone: "text", onClick: this.onClickClose })), h("slot", { key: 'b8ad10ac19653be29b5bf37c095621bbb4d1bc81', name: "title" }), h("slot", { key: 'bd9dcf05f15202bcc41ad9f7d014e2740228e623' }), h("div", { key: '601c649283a0923d08d14cef3fa20ffccd491b8b', "aria-hidden": "true", class: "fold" })));
56
+ return (h(Host, { key: 'a9bfcd5e936af6359ea3ec0f5927e9da8c019be8', role: "note", "pref-animation": preferenceStore.state.animation, "pref-contrast": preferenceStore.state.contrast, "pref-mode": preferenceStore.state.mode, "pref-theme-scheme": preferenceStore.state['theme-scheme'] }, this.deletable && (h("mds-button", { key: '72c2221af777320b6c809560b9d22e7c01bca115', title: this.t.get('deleteLabel'), icon: miBaselineClose, class: "button-close", variant: "dark", tone: "text", onClick: this.onClickClose })), h("slot", { key: '5b719af6a356a2a9f83b4c0fd35a5fa26cd30d7f', name: "title" }), h("slot", { key: 'eef330096a06bad54a607f5e447bff9c5b3f5449' }), h("div", { key: '1e265463246b09a4578e7ba0e339edc8f74f0c61', "aria-hidden": "true", class: "fold" })));
57
57
  }
58
58
  static get is() { return "mds-note"; }
59
59
  static get encapsulation() { return "shadow"; }
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-notification
8
8
 
9
- > `@maggioli-design-system/magma` 2.11.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
9
+ > `@maggioli-design-system/magma` 2.12.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
10
10
 
11
11
  The `<mds-notification>` web component is a numeric badge/dot indicator of the Magma Design System that attaches to another element (an icon, a button, an avatar) to signal a count of pending items. It has no HTML primitive equivalent: it positions itself relative to a target element rather than wrapping content of its own.
12
12
 
@@ -1,5 +1,5 @@
1
1
  {
2
- "timestamp": "2026-11-04T15:13:27",
2
+ "timestamp": "2026-11-06T15:30:27",
3
3
  "compiler": {
4
4
  "name": "@stencil/core",
5
5
  "version": "4.45.2",
@@ -181,7 +181,7 @@ export class MdsNotification {
181
181
  }
182
182
  }
183
183
  render() {
184
- return (h(Host, { key: '0cd7987a457c509276e22d9f915f94d68f954590', "aria-hidden": this.describing ? 'true' : undefined, "pref-animation": preferenceStore.state.animation }, h("mds-text", { key: 'f6bc061623bf46f19a6fbf98bce42f5373e93598', typography: "caption", class: { dot: true, pulse: this.pulse && this.pulsing } }, this.clean(this.value))));
184
+ return (h(Host, { key: '2804812b6d016ab36d22d5272d26ec8b9f51cffe', "aria-hidden": this.describing ? 'true' : undefined, "pref-animation": preferenceStore.state.animation }, h("mds-text", { key: '9c882c379f588a86eebc12e763ec08cb4a15faaa', typography: "caption", class: { dot: true, pulse: this.pulse && this.pulsing } }, this.clean(this.value))));
185
185
  }
186
186
  static get is() { return "mds-notification"; }
187
187
  static get encapsulation() { return "shadow"; }
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-paginator
8
8
 
9
- > `@maggioli-design-system/magma` 2.11.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
9
+ > `@maggioli-design-system/magma` 2.12.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
10
10
 
11
11
  The `<mds-paginator>` web component is the page-navigation control of the Magma Design System. It renders a horizontal strip of numbered page items framed by previous/next arrows, replacing an ad-hoc set of links or buttons with a single self-managing control.
12
12
 
@@ -1,5 +1,5 @@
1
1
  {
2
- "timestamp": "2026-11-04T15:13:27",
2
+ "timestamp": "2026-11-06T15:30:27",
3
3
  "compiler": {
4
4
  "name": "@stencil/core",
5
5
  "version": "4.45.2",
@@ -127,7 +127,8 @@ mds-paginator-item {
127
127
  * for dark. `dark` is the explicit choice; `system` and no controller follow the
128
128
  * OS via @media; the scheme axis gates it. Cross-browser, no :host-context. */
129
129
 
130
- :host([pref-mode='dark']:not([pref-theme-scheme='light'])) {
130
+ :host([pref-mode='dark']:not([pref-theme-scheme='light'])),
131
+ :host([pref-theme-scheme='dark']) {
131
132
  --mds-paginator-background: rgb(var(--magma-wash-base, var(--tone-neutral-09, 225 225 225)));
132
133
 
133
134
  .pages {
@@ -137,7 +138,7 @@ mds-paginator-item {
137
138
 
138
139
  @media (prefers-color-scheme: dark) {
139
140
  :host([pref-mode='system']:not([pref-theme-scheme='light'])),
140
- :host(:not([pref-mode])) {
141
+ :host(:not([pref-mode]):not([pref-theme-scheme='light'])) {
141
142
  --mds-paginator-background: rgb(var(--magma-wash-base, var(--tone-neutral-09, 225 225 225)));
142
143
 
143
144
  .pages {
@@ -107,7 +107,7 @@ export class MdsPaginator {
107
107
  }, 10);
108
108
  }
109
109
  render() {
110
- return (h(Host, { key: 'c6f4a5bc33acf44341b5e516ee3209f91846d11e', "pref-animation": preferenceStore.state.animation, "pref-contrast": preferenceStore.state.contrast, "pref-mode": preferenceStore.state.mode, "pref-theme-scheme": preferenceStore.state['theme-scheme'] }, h("mds-paginator-item", { key: '041df6a22ee0d7c55646a7f09672894956d02dd3', "aria-label": this.t.get('previousPage'), class: "item-icon", icon: miBaselineArrowBack, disabled: this.currentPage === 1, onClick: this.handlePrevClick }), this.pages > 0 && (h("mds-paginator-item", { key: 'c3a9b2e2b3f9d387164c91dde1298e91a32373ea', class: "item-first", selected: this.currentPage === 1, onClick: this.handleFirstClick }, "1")), this.pages > 2 && (h("div", { key: '4024d92df8b151095dd762c3d0944a9a89b0a3ea', class: "pages" }, Array.from(Array(this.pages - 2).keys()).map((i) => (h("mds-paginator-item", { key: i, class: "item", selected: this.currentPage === i + 2, onClick: this.handlePageClick(i + 2), onFocus: this.handleItemFocus }, i + 2))))), this.pages > 1 && (h("mds-paginator-item", { key: '77b855c290ac20fb52aaa5aab6f20e4a67747472', class: "item-last", selected: this.currentPage === this.pages, onClick: this.handleLastClick }, this.pages)), h("mds-paginator-item", { key: 'e07b9b3477a143ad478c1ca116fae1a2f5b5d229', "aria-label": this.t.get('nextPage'), class: "item-icon", icon: miBaselineArrowForward, disabled: this.currentPage === this.pages, onClick: this.handleNextClick })));
110
+ return (h(Host, { key: 'c799748f3c405935c1686e5e5416af2e85c602eb', "pref-animation": preferenceStore.state.animation, "pref-contrast": preferenceStore.state.contrast, "pref-mode": preferenceStore.state.mode, "pref-theme-scheme": preferenceStore.state['theme-scheme'] }, h("mds-paginator-item", { key: 'bef296cc9c72931156d7490306e5faa1f46296a4', "aria-label": this.t.get('previousPage'), class: "item-icon", icon: miBaselineArrowBack, disabled: this.currentPage === 1, onClick: this.handlePrevClick }), this.pages > 0 && (h("mds-paginator-item", { key: '70dc199eca2b93e107577fbe22453caeb55d85a2', class: "item-first", selected: this.currentPage === 1, onClick: this.handleFirstClick }, "1")), this.pages > 2 && (h("div", { key: 'cde850d3d91892a6ec9b542e2f6ae4220c5f0f0b', class: "pages" }, Array.from(Array(this.pages - 2).keys()).map((i) => (h("mds-paginator-item", { key: i, class: "item", selected: this.currentPage === i + 2, onClick: this.handlePageClick(i + 2), onFocus: this.handleItemFocus }, i + 2))))), this.pages > 1 && (h("mds-paginator-item", { key: '8eca32171d96c430f115b7503006598bf288146c', class: "item-last", selected: this.currentPage === this.pages, onClick: this.handleLastClick }, this.pages)), h("mds-paginator-item", { key: '2fc0dacd6cd6cc06669acbd2b4b33d09e09fc1e4', "aria-label": this.t.get('nextPage'), class: "item-icon", icon: miBaselineArrowForward, disabled: this.currentPage === this.pages, onClick: this.handleNextClick })));
111
111
  }
112
112
  static get is() { return "mds-paginator"; }
113
113
  static get encapsulation() { return "shadow"; }
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-paginator-item
8
8
 
9
- > `@maggioli-design-system/magma` 2.11.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
9
+ > `@maggioli-design-system/magma` 2.12.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
10
10
 
11
11
  The `<mds-paginator-item>` web component is a compound child of [`<mds-paginator>`](../mds-paginator/AGENTS.md) that renders a single clickable cell of the pagination control: either a numbered page or a navigation arrow. It has no standalone meaning and exists only to be orchestrated by its parent, which owns page state and emits the page-change event.
12
12
 
@@ -1,5 +1,5 @@
1
1
  {
2
- "timestamp": "2026-11-04T15:13:27",
2
+ "timestamp": "2026-11-06T15:30:27",
3
3
  "compiler": {
4
4
  "name": "@stencil/core",
5
5
  "version": "4.45.2",
@@ -36,7 +36,7 @@ export class MdsPaginatorItem {
36
36
  this.km.detachClickBehavior();
37
37
  }
38
38
  render() {
39
- return (h(Host, { key: 'c9d38effc2ced1fcc2a12f39760969f29693ddf3', "aria-current": this.selected ? 'page' : undefined, "aria-disabled": this.disabled ? 'true' : undefined, role: "button", tabindex: this.disabled ? undefined : '0', "pref-animation": preferenceStore.state.animation, "pref-mode": preferenceStore.state.mode, "pref-theme-scheme": preferenceStore.state['theme-scheme'] }, this.icon !== undefined ? (h("mds-icon", { class: "icon", name: this.icon })) : (h("mds-text", { class: "text", typography: "caption" }, h("b", null, h("slot", null))))));
39
+ return (h(Host, { key: '1c1e25118676b13db5fa50f88d5b23094b2097b9', "aria-current": this.selected ? 'page' : undefined, "aria-disabled": this.disabled ? 'true' : undefined, role: "button", tabindex: this.disabled ? undefined : '0', "pref-animation": preferenceStore.state.animation, "pref-mode": preferenceStore.state.mode, "pref-theme-scheme": preferenceStore.state['theme-scheme'] }, this.icon !== undefined ? (h("mds-icon", { class: "icon", name: this.icon })) : (h("mds-text", { class: "text", typography: "caption" }, h("b", null, h("slot", null))))));
40
40
  }
41
41
  static get is() { return "mds-paginator-item"; }
42
42
  static get encapsulation() { return "shadow"; }
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-policy-ai
8
8
 
9
- > `@maggioli-design-system/magma` 2.11.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
9
+ > `@maggioli-design-system/magma` 2.12.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
10
10
 
11
11
  The `<mds-policy-ai>` web component is the Magma Design System disclosure marker that flags AI-generated content as produced by MIA (Maggioli's artificial intelligence) and links to the official AI usage policy. It is a presentational compound component with no native HTML primitive, rendering one of four interchangeable surfaces (icon, chip, card, banner).
12
12
 
@@ -1,5 +1,5 @@
1
1
  {
2
- "timestamp": "2026-11-04T15:13:27",
2
+ "timestamp": "2026-11-06T15:30:27",
3
3
  "compiler": {
4
4
  "name": "@stencil/core",
5
5
  "version": "4.45.2",
@@ -242,8 +242,8 @@
242
242
  "mds-button"
243
243
  ],
244
244
  "mds-button": [
245
- "mds-spinner",
246
245
  "mds-icon",
246
+ "mds-spinner",
247
247
  "mds-text"
248
248
  ],
249
249
  "mds-banner": [
@@ -37,7 +37,7 @@ export class MdsPolicyAi {
37
37
  }
38
38
  render() {
39
39
  var _a, _b, _c, _d, _e, _f, _g;
40
- return (h(Host, { key: '77141781b0d98727b4c6f6efb0810f8395b4ad79' }, this.variant === 'icon' && (h("mds-help", { key: 'af9b17aa5d28d29ce9d8827de7a00433d2fe9079', icon: mggAiChatbot, class: "icon-help", onClick: this.handleIconClick, part: "icon" }, h("div", { key: '8c1396e6b26a47837b152182d3e75420ec652cf8', class: "icon-tip-content" }, h("mds-text", { key: 'ebe73404d525007c65dffe458bcb09700670f832', typography: "tip" }, (_a = this.headline) !== null && _a !== void 0 ? _a : this.t.get('iconTooltip')), h("mds-text", { key: '938fe4983d50b5c6744ceda8b048885cb716738e', typography: "tip" }, (_b = this.description) !== null && _b !== void 0 ? _b : this.t.get('iconLinkLabel'))))), this.variant === 'chip' && (h("div", { key: 'fa52a75dd2a66aa13c3896930dfebbb93ecab4c0', class: "chip-wrapper", part: "chip-wrapper" }, h("mds-chip", { key: 'e9e446c4fed532c27dcf785784346a119decad4a', id: "chip", icon: mggAiChatbot, class: "chip", part: "chip", variant: "ai", label: (_c = this.headline) !== null && _c !== void 0 ? _c : this.t.get('chipLabel') }), h("mds-dropdown", { key: 'c01aab8fb5e35049114da89472b127cbb5672297', target: "#chip", class: "chip-dropdown", interaction: "mouseover", role: "group" }, h("mds-text", { key: '42bbcb099c2852a4beaf78f19775d54adaabb104', typography: "tip" }, (_d = this.description) !== null && _d !== void 0 ? _d : this.t.get('cardDescription')), h("mds-button", { key: '0b6c6fd0f55fbbd6bbc0de466b5c6707ce330776', icon: miOutlinePolicy, href: this.href, variant: "ai", tone: "weak", size: "sm", label: this.t.get('linkLabel') })))), this.variant === 'card' && (h("div", { key: '1d04c9e6f17cf9d51288236df025e8a72a2c0f76', class: "mini-card", part: "card" }, h("mds-icon", { key: '7d1203d45e76a406789a728b6108bf360d02adfe', name: mggAiChatbot, class: "mini-card-icon" }), h("div", { key: '905dd9f1b298dc06d453710adddc7b19881513d9', class: "mini-card-content" }, h("mds-text", { key: '6d2d997cf9fb2e35c0e5a3f54aaf0b7b8a2a2a1b', typography: "caption" }, (_e = this.description) !== null && _e !== void 0 ? _e : this.t.get('iconTooltip')), h("mds-button", { key: '7479378a96149e749aa981fe7cf14ddf417b67f5', class: "mini-card-button", icon: miOutlinePolicy, href: this.href, variant: "ai", tone: "weak", size: "sm" }, h("span", { key: '090126434c22984923e1193058d402c9f86f1ac8', class: "link-label-long" }, this.t.get('linkLabel')), h("span", { key: '4b90f626475f912b4bd5400ea4228e369679bed8', class: "link-label-short" }, this.t.get('linkLabelShort')))))), this.variant === 'banner' && (h("mds-banner", { key: 'd3f9f515dd207af93653812df7d1529393334071', class: "banner", variant: "ai", tone: "weak", icon: mggAiChatbot, headline: (_f = this.headline) !== null && _f !== void 0 ? _f : this.t.get('bannerTitle'), part: "banner" }, h("mds-text", { key: '055cdb80dc5f911df82b8920537896aa1ff68338', typography: "caption" }, (_g = this.description) !== null && _g !== void 0 ? _g : this.t.get('bannerDescription')), h("mds-button", { key: '72ffa986e47180234ae6b861ce4f9b969281e091', icon: miOutlinePolicy, slot: "action", href: this.href, variant: "ai", tone: "weak", size: "sm" }, h("span", { key: '32d814b9a72d29cd8c235a0b28c42d53dde423bc', class: "link-label-long" }, this.t.get('linkLabel')), h("span", { key: '9f1bfeeca280ffbe0fa6fc750bfd145af036ee12', class: "link-label-short" }, this.t.get('linkLabelShort')))))));
40
+ return (h(Host, { key: 'ddad43155ac59c186b81f362759e7afac3f2605e' }, this.variant === 'icon' && (h("mds-help", { key: 'b87ea455c83cfab035379cc37e5981ff8fde662a', icon: mggAiChatbot, class: "icon-help", onClick: this.handleIconClick, part: "icon" }, h("div", { key: 'f8801c4e3d7da3ed4816df0bf25536591b9c9c5a', class: "icon-tip-content" }, h("mds-text", { key: 'e70a7946f2c402d9a5258650c84ecfe0cf7743d3', typography: "tip" }, (_a = this.headline) !== null && _a !== void 0 ? _a : this.t.get('iconTooltip')), h("mds-text", { key: '4cb70c7dc3e4d8a62f4d64f0579d682d68219edc', typography: "tip" }, (_b = this.description) !== null && _b !== void 0 ? _b : this.t.get('iconLinkLabel'))))), this.variant === 'chip' && (h("div", { key: '667d50824ba8c9a112910474767cc7c0e18238eb', class: "chip-wrapper", part: "chip-wrapper" }, h("mds-chip", { key: 'f4bc017198d9f2e8b78da179ec21821908f3d1d9', id: "chip", icon: mggAiChatbot, class: "chip", part: "chip", variant: "ai", label: (_c = this.headline) !== null && _c !== void 0 ? _c : this.t.get('chipLabel') }), h("mds-dropdown", { key: 'ee9cc2dc7d65b9b3a250a3a50a480c4ec5ea6ad6', target: "#chip", class: "chip-dropdown", interaction: "mouseover", role: "group" }, h("mds-text", { key: 'f73f190ef6096317eca5a52bc7ecf66b75ab1aac', typography: "tip" }, (_d = this.description) !== null && _d !== void 0 ? _d : this.t.get('cardDescription')), h("mds-button", { key: 'f51b775cbac689b736a842497979b6479ff8eec6', icon: miOutlinePolicy, href: this.href, variant: "ai", tone: "weak", size: "sm", label: this.t.get('linkLabel') })))), this.variant === 'card' && (h("div", { key: 'cde9a9e1062c9e9b04fe13f13bc650e1dd02ce0e', class: "mini-card", part: "card" }, h("mds-icon", { key: 'ba65a6dcc0f7f4183a705cd1e34c2db1a3ce6d19', name: mggAiChatbot, class: "mini-card-icon" }), h("div", { key: '9f9daf2c8f049d39a071592bf8d67ebbfe368753', class: "mini-card-content" }, h("mds-text", { key: '140fdadaaf522cb0643eb94b00b5b2cf91c27b76', typography: "caption" }, (_e = this.description) !== null && _e !== void 0 ? _e : this.t.get('iconTooltip')), h("mds-button", { key: 'd673e14c38ee7b31b13a0eb0b97c62b621154135', class: "mini-card-button", icon: miOutlinePolicy, href: this.href, variant: "ai", tone: "weak", size: "sm" }, h("span", { key: '1a2d00f73ace39bd1d1075394f8fdb7b9fb5340f', class: "link-label-long" }, this.t.get('linkLabel')), h("span", { key: '6f5d23895702f4d8bf049ac7c3f34b52627ece95', class: "link-label-short" }, this.t.get('linkLabelShort')))))), this.variant === 'banner' && (h("mds-banner", { key: 'e66c283da9af78447045703838aeb132dd6470b6', class: "banner", variant: "ai", tone: "weak", icon: mggAiChatbot, headline: (_f = this.headline) !== null && _f !== void 0 ? _f : this.t.get('bannerTitle'), part: "banner" }, h("mds-text", { key: '43c255578cc3b65171a40eb4b3d79fe674bf8ce2', typography: "caption" }, (_g = this.description) !== null && _g !== void 0 ? _g : this.t.get('bannerDescription')), h("mds-button", { key: '23230d5e73cebf33c783a366ec05d0fb40bdaf7f', icon: miOutlinePolicy, slot: "action", href: this.href, variant: "ai", tone: "weak", size: "sm" }, h("span", { key: '47ef7aea454dedaae6533358bb49c9bef3e6f138', class: "link-label-long" }, this.t.get('linkLabel')), h("span", { key: '74f450927ec63334fd8deb9c38c736167e925f7c', class: "link-label-short" }, this.t.get('linkLabelShort')))))));
41
41
  }
42
42
  static get is() { return "mds-policy-ai"; }
43
43
  static get encapsulation() { return "shadow"; }
@@ -6,16 +6,16 @@
6
6
 
7
7
  # mds-pref
8
8
 
9
- > `@maggioli-design-system/magma` 2.11.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
9
+ > `@maggioli-design-system/magma` 2.12.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
10
10
 
11
11
  The `<mds-pref>` web component is the accessibility-preferences panel of the Magma Design System: a compound parent that groups user-facing settings (animation, consumption, contrast, theme, language) so people can tune readability, motion, and language for their session. It acts as the coordinator for the `mds-pref-*` children slotted inside it.
12
12
 
13
13
  #### Semantic Behavior
14
14
 
15
- - **Compound parent**: Expects `mds-pref-animation`, `mds-pref-consumption`, `mds-pref-contrast`, `mds-pref-mode`, `mds-pref-theme` and/or `mds-pref-language` children in its default slot; it owns no preference UI of its own beyond coordination (a scheme-constrained `mds-pref-theme` locks the matching `mds-pref-mode` item).
15
+ - **Compound parent**: Expects `mds-pref-animation`, `mds-pref-consumption`, `mds-pref-contrast`, `mds-pref-mode`, `mds-pref-theme` and/or `mds-pref-language` children in its default slot; it owns no preference UI of its own beyond coordination (it forwards `size`, flags the document and asks for a reload). The lock of a single-mode theme on `mds-pref-mode` needs no parent: the mode control reads it from `<html>`.
16
16
  - **Size propagation**: `size` cascades down to every nested `mds-pref-*` child, on load, on every change and to the children added later; without a `size` on the panel each child keeps its own.
17
17
  - **Reload notice**: The panel shows an inline caption prompting the user to refresh the page when a preference that cannot apply live (`consumption` or `language`) changes after load. A `controller` panel, which is hidden, shows none.
18
- - **Document flag**: While at least one `<mds-pref>` is on the page, `<html>` carries `data-magma-pref`, which turns off the styles' fallback to the OS preferences; it is removed only when the last instance leaves the page, so a settings page that unmounts its own panel leaves the app controller in charge. Moving a panel in the DOM (between a sidebar and a menu, or with a client router that keeps it across pages) keeps the flag, the reload notice and the theme lock on the mode control.
18
+ - **Document flag**: While at least one `<mds-pref>` is on the page, `<html>` carries `data-magma-pref`, which turns off the styles' fallback to the OS preferences; it is removed only when the last instance leaves the page, so a settings page that unmounts its own panel leaves the app controller in charge. Moving a panel in the DOM (between a sidebar and a menu, or with a client router that keeps it across pages) keeps the flag and the reload notice.
19
19
  - **Live language sync**: When a `language` change is emitted, the panel re-resolves its own locale so the reload notice is shown in the newly selected language.
20
20
 
21
21
  #### Properties & Visual Configurations
@@ -1,5 +1,5 @@
1
1
  {
2
- "timestamp": "2026-11-04T15:13:27",
2
+ "timestamp": "2026-11-06T15:30:27",
3
3
  "compiler": {
4
4
  "name": "@stencil/core",
5
5
  "version": "4.45.2",
@@ -43,9 +43,9 @@
43
43
  }
44
44
  ],
45
45
  "usage": {
46
- "1. Description": "The `<mds-pref>` web component is the accessibility-preferences panel of the Magma Design System: a compound parent that groups user-facing settings (animation, consumption, contrast, theme, language) so people can tune readability, motion, and language for their session. It acts as the coordinator for the `mds-pref-*` children slotted inside it.\n\n#### Semantic Behavior\n\n- **Compound parent**: Expects `mds-pref-animation`, `mds-pref-consumption`, `mds-pref-contrast`, `mds-pref-mode`, `mds-pref-theme` and/or `mds-pref-language` children in its default slot; it owns no preference UI of its own beyond coordination (a scheme-constrained `mds-pref-theme` locks the matching `mds-pref-mode` item).\n- **Size propagation**: `size` cascades down to every nested `mds-pref-*` child, on load, on every change and to the children added later; without a `size` on the panel each child keeps its own.\n- **Reload notice**: The panel shows an inline caption prompting the user to refresh the page when a preference that cannot apply live (`consumption` or `language`) changes after load. A `controller` panel, which is hidden, shows none.\n- **Document flag**: While at least one `<mds-pref>` is on the page, `<html>` carries `data-magma-pref`, which turns off the styles' fallback to the OS preferences; it is removed only when the last instance leaves the page, so a settings page that unmounts its own panel leaves the app controller in charge. Moving a panel in the DOM (between a sidebar and a menu, or with a client router that keeps it across pages) keeps the flag, the reload notice and the theme lock on the mode control.\n- **Live language sync**: When a `language` change is emitted, the panel re-resolves its own locale so the reload notice is shown in the newly selected language.\n\n#### Properties & Visual Configurations\n\n`size` is one of the shared tab sizes and is forwarded to children rather than styling the host directly - set it on the parent and it reaches every child.\n\n#### Other behavioral props\n\n- **`controller`** switches the component from a visible on-DOM panel into a headless controller that applies and reacts to preferences without rendering UI; in this mode it drives document-level preference state without a visible panel.\n",
47
- "2. Examples": "Correct and idiomatic ways to use the `<mds-pref>` component, ordered from most common to most specialized. The examples assume a working knowledge of the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Full Preferences Panel\n\nThe canonical form: slot every `mds-pref-*` control directly inside `<mds-pref>`. The parent coordinates the theme and mode controls automatically (a scheme-constrained theme locks the matching mode item) - no extra wiring is needed.\n\n```html\n<mds-pref>\n <mds-pref-mode></mds-pref-mode>\n <mds-pref-theme>\n <mds-pref-theme-item name=\"default\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"cool\"></mds-pref-theme-item>\n </mds-pref-theme>\n <mds-pref-contrast></mds-pref-contrast>\n <mds-pref-animation></mds-pref-animation>\n <mds-pref-consumption></mds-pref-consumption>\n <mds-pref-language>\n <mds-pref-language-item code=\"it\"></mds-pref-language-item>\n <mds-pref-language-item code=\"en\"></mds-pref-language-item>\n </mds-pref-language>\n</mds-pref>\n```\n\n#### Partial Panel - Subset of Controls\n\nSlot only the controls your application needs. `<mds-pref>` renders whatever children are present; omitted controls are simply absent.\n\n```html\n<!-- Accessibility-only panel: contrast and animation controls -->\n<mds-pref>\n <mds-pref-contrast></mds-pref-contrast>\n <mds-pref-animation></mds-pref-animation>\n</mds-pref>\n```\n\n#### Controlling Size\n\nThe parent's `size` drives all child controls at once, on load and when it changes.\n\n```html\n<!-- Compact panel for a sidebar or popover -->\n<mds-pref size=\"sm\">\n <mds-pref-mode></mds-pref-mode>\n <mds-pref-contrast></mds-pref-contrast>\n <mds-pref-animation></mds-pref-animation>\n</mds-pref>\n```\n\n#### Headless Controller Mode\n\nSet the `controller` boolean attribute when you need the preference engine to apply saved preferences from `localStorage` on page load without rendering any visible UI. The host is hidden via CSS (`display: none`) and still activates all child preference controls.\n\n```html\n<!-- Place in <body>; the panel is invisible but activates stored preferences -->\n<mds-pref controller>\n <mds-pref-mode></mds-pref-mode>\n <mds-pref-contrast></mds-pref-contrast>\n <mds-pref-animation></mds-pref-animation>\n <mds-pref-consumption></mds-pref-consumption>\n <mds-pref-language>\n <mds-pref-language-item code=\"it\"></mds-pref-language-item>\n <mds-pref-language-item code=\"en\"></mds-pref-language-item>\n </mds-pref-language>\n</mds-pref>\n```\n\n#### Language Selector with Multiple Languages\n\n`<mds-pref-language>` requires its child `<mds-pref-language-item>` elements to be present; the items are not self-generating. Pass language codes supported by your application.\n\n```html\n<mds-pref>\n <mds-pref-language>\n <mds-pref-language-item code=\"it\"></mds-pref-language-item>\n <mds-pref-language-item code=\"en\"></mds-pref-language-item>\n <mds-pref-language-item code=\"el\"></mds-pref-language-item>\n <mds-pref-language-item code=\"es\"></mds-pref-language-item>\n </mds-pref-language>\n</mds-pref>\n```\n\n#### Reload Notice Handling\n\n`<mds-pref>` shows an inline caption telling the user to refresh the page after a `consumption` or `language` change: nothing to wire. It shows for a change made after the panel loaded, so the stored choices the controls apply on load raise no notice; a `controller` panel is hidden and shows none.\n",
48
- "3. Mistakes": "Common incorrect uses of `<mds-pref>`. 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/mistakes.md`](../../../../agents/mistakes.md) - they apply here too but are not repeated.\n\n#### Do Not Place Non-Pref Children in the Default Slot\n\nThe default slot accepts only `mds-pref-animation`, `mds-pref-consumption`, `mds-pref-contrast`, `mds-pref-language`, `mds-pref-mode` and `mds-pref-theme` children. Other elements are outside the documented content: they render as extra rows of the panel and take part in no coordination.\n\n```html\n<!-- INCORRECT -->\n<mds-pref>\n <div class=\"custom-section\">Tema</div>\n <mds-pref-mode></mds-pref-mode>\n</mds-pref>\n\n<!-- CORRECT -->\n<mds-pref>\n <mds-pref-mode></mds-pref-mode>\n</mds-pref>\n```\n\n#### Do Not Use `mds-pref-*` Children Outside `<mds-pref>`\n\nEach control applies and stores its own preference, but the coordination between the controls of a panel lives in the parent: a scheme-constrained `mds-pref-theme` item locks the matching `mds-pref-mode` item only inside `<mds-pref>`, and only the parent forwards `size` changes. Group the controls of a panel in `<mds-pref>`.\n\n```html\n<!-- INCORRECT -->\n<mds-pref-mode></mds-pref-mode>\n<mds-pref-theme>\n <mds-pref-theme-item name=\"default\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"cool\"></mds-pref-theme-item>\n</mds-pref-theme>\n\n<!-- CORRECT -->\n<mds-pref>\n <mds-pref-mode></mds-pref-mode>\n <mds-pref-theme>\n <mds-pref-theme-item name=\"default\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"cool\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n```\n\n#### Do Not Set `controller=\"false\"` to Turn Off Controller Mode\n\n`controller` is a boolean attribute, and a false boolean is an absent attribute ([`agents/conventions.md`](../../../../agents/conventions.md)). The runtime parses the string `\"false\"` as `false`, so the panel shows, but the attribute is still on the element until the first render, so `[controller]` attribute selectors (the one that hides the panel included) and any code that reads the attribute see it set. Remove the attribute entirely to switch back to visible mode.\n\n```html\n<!-- INCORRECT -->\n<mds-pref controller=\"false\">\n <mds-pref-mode></mds-pref-mode>\n</mds-pref>\n\n<!-- CORRECT -->\n<mds-pref>\n <mds-pref-mode></mds-pref-mode>\n</mds-pref>\n```\n\n#### Do Not Listen for the Native `change` Event to Detect Preference Changes\n\nThe controls fire no native `change` event. Use the documented `mdsPrefChange` event emitted by each `mds-pref-*` child: it fires once per change, not on page load, and carries only the `preference` name in `detail`, so read the new value from the child.\n\n```html\n<!-- INCORRECT -->\n<script>\n document.querySelector('mds-pref').addEventListener('change', (e) => {\n console.log(e);\n });\n</script>\n\n<!-- CORRECT -->\n<script>\n document.querySelector('mds-pref-mode').addEventListener('mdsPrefChange', (e) => {\n console.log(e.detail.preference);\n });\n</script>\n```\n"
46
+ "1. Description": "The `<mds-pref>` web component is the accessibility-preferences panel of the Magma Design System: a compound parent that groups user-facing settings (animation, consumption, contrast, theme, language) so people can tune readability, motion, and language for their session. It acts as the coordinator for the `mds-pref-*` children slotted inside it.\n\n#### Semantic Behavior\n\n- **Compound parent**: Expects `mds-pref-animation`, `mds-pref-consumption`, `mds-pref-contrast`, `mds-pref-mode`, `mds-pref-theme` and/or `mds-pref-language` children in its default slot; it owns no preference UI of its own beyond coordination (it forwards `size`, flags the document and asks for a reload). The lock of a single-mode theme on `mds-pref-mode` needs no parent: the mode control reads it from `<html>`.\n- **Size propagation**: `size` cascades down to every nested `mds-pref-*` child, on load, on every change and to the children added later; without a `size` on the panel each child keeps its own.\n- **Reload notice**: The panel shows an inline caption prompting the user to refresh the page when a preference that cannot apply live (`consumption` or `language`) changes after load. A `controller` panel, which is hidden, shows none.\n- **Document flag**: While at least one `<mds-pref>` is on the page, `<html>` carries `data-magma-pref`, which turns off the styles' fallback to the OS preferences; it is removed only when the last instance leaves the page, so a settings page that unmounts its own panel leaves the app controller in charge. Moving a panel in the DOM (between a sidebar and a menu, or with a client router that keeps it across pages) keeps the flag and the reload notice.\n- **Live language sync**: When a `language` change is emitted, the panel re-resolves its own locale so the reload notice is shown in the newly selected language.\n\n#### Properties & Visual Configurations\n\n`size` is one of the shared tab sizes and is forwarded to children rather than styling the host directly - set it on the parent and it reaches every child.\n\n#### Other behavioral props\n\n- **`controller`** switches the component from a visible on-DOM panel into a headless controller that applies and reacts to preferences without rendering UI; in this mode it drives document-level preference state without a visible panel.\n",
47
+ "2. Examples": "Correct and idiomatic ways to use the `<mds-pref>` component, ordered from most common to most specialized. The examples assume a working knowledge of the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Full Preferences Panel\n\nThe canonical form: slot every `mds-pref-*` control directly inside `<mds-pref>`. No extra wiring is needed: the mode control follows the active theme by itself (a theme of one mode locks it to that mode).\n\n```html\n<mds-pref>\n <mds-pref-mode></mds-pref-mode>\n <mds-pref-theme>\n <mds-pref-theme-item name=\"default\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"cool\"></mds-pref-theme-item>\n </mds-pref-theme>\n <mds-pref-contrast></mds-pref-contrast>\n <mds-pref-animation></mds-pref-animation>\n <mds-pref-consumption></mds-pref-consumption>\n <mds-pref-language>\n <mds-pref-language-item code=\"it\"></mds-pref-language-item>\n <mds-pref-language-item code=\"en\"></mds-pref-language-item>\n </mds-pref-language>\n</mds-pref>\n```\n\n#### Partial Panel - Subset of Controls\n\nSlot only the controls your application needs. `<mds-pref>` renders whatever children are present; omitted controls are simply absent.\n\n```html\n<!-- Accessibility-only panel: contrast and animation controls -->\n<mds-pref>\n <mds-pref-contrast></mds-pref-contrast>\n <mds-pref-animation></mds-pref-animation>\n</mds-pref>\n```\n\n#### Controlling Size\n\nThe parent's `size` drives all child controls at once, on load and when it changes.\n\n```html\n<!-- Compact panel for a sidebar or popover -->\n<mds-pref size=\"sm\">\n <mds-pref-mode></mds-pref-mode>\n <mds-pref-contrast></mds-pref-contrast>\n <mds-pref-animation></mds-pref-animation>\n</mds-pref>\n```\n\n#### Headless Controller Mode\n\nSet the `controller` boolean attribute when you need the preference engine to apply saved preferences from `localStorage` on page load without rendering any visible UI. The host is hidden via CSS (`display: none`) and still activates all child preference controls.\n\n```html\n<!-- Place in <body>; the panel is invisible but activates stored preferences -->\n<mds-pref controller>\n <mds-pref-mode></mds-pref-mode>\n <mds-pref-contrast></mds-pref-contrast>\n <mds-pref-animation></mds-pref-animation>\n <mds-pref-consumption></mds-pref-consumption>\n <mds-pref-language>\n <mds-pref-language-item code=\"it\"></mds-pref-language-item>\n <mds-pref-language-item code=\"en\"></mds-pref-language-item>\n </mds-pref-language>\n</mds-pref>\n```\n\n#### Language Selector with Multiple Languages\n\n`<mds-pref-language>` requires its child `<mds-pref-language-item>` elements to be present; the items are not self-generating. Pass language codes supported by your application.\n\n```html\n<mds-pref>\n <mds-pref-language>\n <mds-pref-language-item code=\"it\"></mds-pref-language-item>\n <mds-pref-language-item code=\"en\"></mds-pref-language-item>\n <mds-pref-language-item code=\"el\"></mds-pref-language-item>\n <mds-pref-language-item code=\"es\"></mds-pref-language-item>\n </mds-pref-language>\n</mds-pref>\n```\n\n#### Reload Notice Handling\n\n`<mds-pref>` shows an inline caption telling the user to refresh the page after a `consumption` or `language` change: nothing to wire. It shows for a change made after the panel loaded, so the stored choices the controls apply on load raise no notice; a `controller` panel is hidden and shows none.\n",
48
+ "3. Mistakes": "Common incorrect uses of `<mds-pref>`. 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/mistakes.md`](../../../../agents/mistakes.md) - they apply here too but are not repeated.\n\n#### Do Not Place Non-Pref Children in the Default Slot\n\nThe default slot accepts only `mds-pref-animation`, `mds-pref-consumption`, `mds-pref-contrast`, `mds-pref-language`, `mds-pref-mode` and `mds-pref-theme` children. Other elements are outside the documented content: they render as extra rows of the panel and take part in no coordination.\n\n```html\n<!-- INCORRECT -->\n<mds-pref>\n <div class=\"custom-section\">Tema</div>\n <mds-pref-mode></mds-pref-mode>\n</mds-pref>\n\n<!-- CORRECT -->\n<mds-pref>\n <mds-pref-mode></mds-pref-mode>\n</mds-pref>\n```\n\n#### Do Not Use `mds-pref-*` Children Outside `<mds-pref>`\n\nEach control applies and stores its own preference, but the coordination between the controls of a panel lives in the parent: only the parent forwards `size` changes and sets the `data-magma-pref` flag that turns off the fallback to the OS preferences. Group the controls of a panel in `<mds-pref>`.\n\n```html\n<!-- INCORRECT -->\n<mds-pref-mode></mds-pref-mode>\n<mds-pref-theme>\n <mds-pref-theme-item name=\"default\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"cool\"></mds-pref-theme-item>\n</mds-pref-theme>\n\n<!-- CORRECT -->\n<mds-pref>\n <mds-pref-mode></mds-pref-mode>\n <mds-pref-theme>\n <mds-pref-theme-item name=\"default\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"cool\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n```\n\n#### Do Not Set `controller=\"false\"` to Turn Off Controller Mode\n\n`controller` is a boolean attribute, and a false boolean is an absent attribute ([`agents/conventions.md`](../../../../agents/conventions.md)). The runtime parses the string `\"false\"` as `false`, so the panel shows, but the attribute is still on the element until the first render, so `[controller]` attribute selectors (the one that hides the panel included) and any code that reads the attribute see it set. Remove the attribute entirely to switch back to visible mode.\n\n```html\n<!-- INCORRECT -->\n<mds-pref controller=\"false\">\n <mds-pref-mode></mds-pref-mode>\n</mds-pref>\n\n<!-- CORRECT -->\n<mds-pref>\n <mds-pref-mode></mds-pref-mode>\n</mds-pref>\n```\n\n#### Do Not Listen for the Native `change` Event to Detect Preference Changes\n\nThe controls fire no native `change` event. Use the documented `mdsPrefChange` event emitted by each `mds-pref-*` child: it fires once per change, not on page load, and carries only the `preference` name in `detail`, so read the new value from the child.\n\n```html\n<!-- INCORRECT -->\n<script>\n document.querySelector('mds-pref').addEventListener('change', (e) => {\n console.log(e);\n });\n</script>\n\n<!-- CORRECT -->\n<script>\n document.querySelector('mds-pref-mode').addEventListener('mdsPrefChange', (e) => {\n console.log(e.detail.preference);\n });\n</script>\n```\n"
49
49
  },
50
50
  "props": [
51
51
  {
@@ -120,11 +120,6 @@
120
120
  "event": "mdsPrefChange",
121
121
  "capture": false,
122
122
  "passive": false
123
- },
124
- {
125
- "event": "mdsPrefThemeChange",
126
- "capture": false,
127
- "passive": false
128
123
  }
129
124
  ],
130
125
  "styles": [],
@@ -11,7 +11,7 @@ Correct and idiomatic ways to use the `<mds-pref>` component, ordered from most
11
11
 
12
12
  #### Full Preferences Panel
13
13
 
14
- The canonical form: slot every `mds-pref-*` control directly inside `<mds-pref>`. The parent coordinates the theme and mode controls automatically (a scheme-constrained theme locks the matching mode item) - no extra wiring is needed.
14
+ The canonical form: slot every `mds-pref-*` control directly inside `<mds-pref>`. No extra wiring is needed: the mode control follows the active theme by itself (a theme of one mode locks it to that mode).
15
15
 
16
16
  ```html
17
17
  <mds-pref>