@maggioli-design-system/magma 2.10.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 (1405) hide show
  1. package/AGENTS.md +2 -2
  2. package/CHANGELOG.md +59 -0
  3. package/README.md +14 -7
  4. package/agents/assets.md +1 -1
  5. package/agents/color.md +3 -2
  6. package/agents/mcp.md +5 -5
  7. package/agents/patterns/actions.md +4 -3
  8. package/agents/patterns/app-shell.md +70 -22
  9. package/agents/patterns/density.md +4 -3
  10. package/agents/patterns/previews/actions/banner.dark.webp +0 -0
  11. package/agents/patterns/previews/actions/banner.light.webp +0 -0
  12. package/agents/patterns/previews/actions/confirm.dark.webp +0 -0
  13. package/agents/patterns/previews/actions/confirm.light.webp +0 -0
  14. package/agents/patterns/previews/actions/danger-zone.dark.webp +0 -0
  15. package/agents/patterns/previews/actions/danger-zone.light.webp +0 -0
  16. package/agents/patterns/previews/actions/destructive-in-menu.dark.webp +0 -0
  17. package/agents/patterns/previews/actions/destructive-in-menu.light.webp +0 -0
  18. package/agents/patterns/previews/actions/dismiss-message.dark.webp +0 -0
  19. package/agents/patterns/previews/actions/dismiss-message.light.webp +0 -0
  20. package/agents/patterns/previews/actions/dismiss.dark.webp +0 -0
  21. package/agents/patterns/previews/actions/dismiss.light.webp +0 -0
  22. package/agents/patterns/previews/actions/more-in-menu.dark.webp +0 -0
  23. package/agents/patterns/previews/actions/more-in-menu.light.webp +0 -0
  24. package/agents/patterns/previews/actions/part-primary.dark.webp +0 -0
  25. package/agents/patterns/previews/actions/part-primary.light.webp +0 -0
  26. package/agents/patterns/previews/actions/primary.dark.webp +0 -0
  27. package/agents/patterns/previews/actions/primary.light.webp +0 -0
  28. package/agents/patterns/previews/actions/remove.dark.webp +0 -0
  29. package/agents/patterns/previews/actions/remove.light.webp +0 -0
  30. package/agents/patterns/previews/actions/secondary.dark.webp +0 -0
  31. package/agents/patterns/previews/actions/secondary.light.webp +0 -0
  32. package/agents/patterns/previews/actions/stacked.dark.webp +0 -0
  33. package/agents/patterns/previews/actions/stacked.light.webp +0 -0
  34. package/agents/patterns/previews/actions/toast.dark.webp +0 -0
  35. package/agents/patterns/previews/actions/toast.light.webp +0 -0
  36. package/agents/patterns/previews/app-shell/back-office.dark.webp +0 -0
  37. package/agents/patterns/previews/app-shell/back-office.html +2 -2
  38. package/agents/patterns/previews/app-shell/back-office.light.webp +0 -0
  39. package/agents/patterns/previews/app-shell/many-sections.dark.webp +0 -0
  40. package/agents/patterns/previews/app-shell/many-sections.html +1 -1
  41. package/agents/patterns/previews/app-shell/many-sections.light.webp +0 -0
  42. package/agents/patterns/previews/app-shell/public-service.dark.webp +0 -0
  43. package/agents/patterns/previews/app-shell/public-service.html +2 -2
  44. package/agents/patterns/previews/app-shell/public-service.light.webp +0 -0
  45. package/agents/patterns/previews/app-shell/section-menus.dark.webp +0 -0
  46. package/agents/patterns/previews/app-shell/section-menus.html +68 -0
  47. package/agents/patterns/previews/app-shell/section-menus.light.webp +0 -0
  48. package/agents/patterns/previews/confirm-action/act-then-undo.dark.webp +0 -0
  49. package/agents/patterns/previews/confirm-action/act-then-undo.light.webp +0 -0
  50. package/agents/patterns/previews/confirm-action/ask-before-sending.dark.webp +0 -0
  51. package/agents/patterns/previews/confirm-action/ask-before-sending.light.webp +0 -0
  52. package/agents/patterns/previews/confirm-action/ask-first-many.dark.webp +0 -0
  53. package/agents/patterns/previews/confirm-action/ask-first-many.light.webp +0 -0
  54. package/agents/patterns/previews/confirm-action/ask-first.dark.webp +0 -0
  55. package/agents/patterns/previews/confirm-action/ask-first.light.webp +0 -0
  56. package/agents/patterns/previews/confirm-action/make-reversible.dark.webp +0 -0
  57. package/agents/patterns/previews/confirm-action/make-reversible.light.webp +0 -0
  58. package/agents/patterns/previews/confirm-action/send-as-shown.dark.webp +0 -0
  59. package/agents/patterns/previews/confirm-action/send-as-shown.light.webp +0 -0
  60. package/agents/patterns/previews/empty-state/add-the-first.dark.webp +0 -0
  61. package/agents/patterns/previews/empty-state/add-the-first.light.webp +0 -0
  62. package/agents/patterns/previews/empty-state/all-done.dark.webp +0 -0
  63. package/agents/patterns/previews/empty-state/all-done.light.webp +0 -0
  64. package/agents/patterns/previews/empty-state/clear-filters.dark.webp +0 -0
  65. package/agents/patterns/previews/empty-state/clear-filters.light.webp +0 -0
  66. package/agents/patterns/previews/empty-state/filled-by-others.dark.webp +0 -0
  67. package/agents/patterns/previews/empty-state/filled-by-others.light.webp +0 -0
  68. package/agents/patterns/previews/empty-state/not-found.dark.webp +0 -0
  69. package/agents/patterns/previews/empty-state/not-found.html +2 -2
  70. package/agents/patterns/previews/empty-state/not-found.light.webp +0 -0
  71. package/agents/patterns/previews/empty-state/one-line.dark.webp +0 -0
  72. package/agents/patterns/previews/empty-state/one-line.light.webp +0 -0
  73. package/agents/patterns/previews/error-recovery/action-another-way.dark.webp +0 -0
  74. package/agents/patterns/previews/error-recovery/action-another-way.light.webp +0 -0
  75. package/agents/patterns/previews/error-recovery/changed-meanwhile.dark.webp +0 -0
  76. package/agents/patterns/previews/error-recovery/changed-meanwhile.light.webp +0 -0
  77. package/agents/patterns/previews/error-recovery/check-or-repeat.dark.webp +0 -0
  78. package/agents/patterns/previews/error-recovery/check-or-repeat.light.webp +0 -0
  79. package/agents/patterns/previews/error-recovery/content-another-way.dark.webp +0 -0
  80. package/agents/patterns/previews/error-recovery/content-another-way.light.webp +0 -0
  81. package/agents/patterns/previews/error-recovery/partial.dark.webp +0 -0
  82. package/agents/patterns/previews/error-recovery/partial.light.webp +0 -0
  83. package/agents/patterns/previews/error-recovery/retry-action.dark.webp +0 -0
  84. package/agents/patterns/previews/error-recovery/retry-action.light.webp +0 -0
  85. package/agents/patterns/previews/error-recovery/retry-content.dark.webp +0 -0
  86. package/agents/patterns/previews/error-recovery/retry-content.light.webp +0 -0
  87. package/agents/patterns/previews/error-recovery/sign-in-again.dark.webp +0 -0
  88. package/agents/patterns/previews/error-recovery/sign-in-again.light.webp +0 -0
  89. package/agents/patterns/previews/item-list/documents-of-a-request.dark.webp +0 -0
  90. package/agents/patterns/previews/item-list/documents-of-a-request.light.webp +0 -0
  91. package/agents/patterns/previews/item-list/queue-of-a-desk.dark.webp +0 -0
  92. package/agents/patterns/previews/item-list/queue-of-a-desk.light.webp +0 -0
  93. package/agents/patterns/previews/item-list/requests-of-an-office.dark.webp +0 -0
  94. package/agents/patterns/previews/item-list/requests-of-an-office.light.webp +0 -0
  95. package/agents/patterns/previews/item-list/requests-to-assign.dark.webp +0 -0
  96. package/agents/patterns/previews/item-list/requests-to-assign.light.webp +0 -0
  97. package/agents/patterns/previews/labels-and-values/data-of-a-contact.dark.webp +0 -0
  98. package/agents/patterns/previews/labels-and-values/data-of-a-contact.light.webp +0 -0
  99. package/agents/patterns/previews/labels-and-values/payment-before-paying.dark.webp +0 -0
  100. package/agents/patterns/previews/labels-and-values/payment-before-paying.light.webp +0 -0
  101. package/agents/patterns/previews/labels-and-values/what-is-sent.dark.webp +0 -0
  102. package/agents/patterns/previews/labels-and-values/what-is-sent.light.webp +0 -0
  103. package/agents/patterns/previews/list-with-filters/act-on-many.dark.webp +0 -0
  104. package/agents/patterns/previews/list-with-filters/act-on-many.html +2 -2
  105. package/agents/patterns/previews/list-with-filters/act-on-many.light.webp +0 -0
  106. package/agents/patterns/previews/list-with-filters/find-and-open.dark.webp +0 -0
  107. package/agents/patterns/previews/list-with-filters/find-and-open.html +2 -2
  108. package/agents/patterns/previews/list-with-filters/find-and-open.light.webp +0 -0
  109. package/agents/patterns/previews/list-with-filters/show-new-items.dark.webp +0 -0
  110. package/agents/patterns/previews/list-with-filters/show-new-items.html +2 -2
  111. package/agents/patterns/previews/list-with-filters/show-new-items.light.webp +0 -0
  112. package/agents/patterns/previews/loading/await-and-say.dark.webp +0 -0
  113. package/agents/patterns/previews/loading/await-and-say.light.webp +0 -0
  114. package/agents/patterns/previews/loading/await-the-control.dark.webp +0 -0
  115. package/agents/patterns/previews/loading/await-the-control.light.webp +0 -0
  116. package/agents/patterns/previews/loading/first-load.dark.webp +0 -0
  117. package/agents/patterns/previews/loading/first-load.light.webp +0 -0
  118. package/agents/patterns/previews/loading/keep-while-reloading.dark.webp +0 -0
  119. package/agents/patterns/previews/loading/keep-while-reloading.light.webp +0 -0
  120. package/agents/patterns/previews/loading/long-load-measured.dark.webp +0 -0
  121. package/agents/patterns/previews/loading/long-load-measured.light.webp +0 -0
  122. package/agents/patterns/previews/loading/long-load.dark.webp +0 -0
  123. package/agents/patterns/previews/loading/long-load.light.webp +0 -0
  124. package/agents/patterns/previews/loading/progress-in-place.dark.webp +0 -0
  125. package/agents/patterns/previews/loading/progress-in-place.light.webp +0 -0
  126. package/agents/patterns/previews/loading/run-in-background.dark.webp +0 -0
  127. package/agents/patterns/previews/loading/run-in-background.light.webp +0 -0
  128. package/agents/patterns/previews/message-placement/action-done-elsewhere.dark.webp +0 -0
  129. package/agents/patterns/previews/message-placement/action-done-elsewhere.light.webp +0 -0
  130. package/agents/patterns/previews/message-placement/action-done-in-page.dark.webp +0 -0
  131. package/agents/patterns/previews/message-placement/action-done-in-page.light.webp +0 -0
  132. package/agents/patterns/previews/message-placement/action-done-in-part.dark.webp +0 -0
  133. package/agents/patterns/previews/message-placement/action-done-in-part.light.webp +0 -0
  134. package/agents/patterns/previews/message-placement/action-failed-elsewhere.dark.webp +0 -0
  135. package/agents/patterns/previews/message-placement/action-failed-elsewhere.light.webp +0 -0
  136. package/agents/patterns/previews/message-placement/action-failed-in-place.dark.webp +0 -0
  137. package/agents/patterns/previews/message-placement/action-failed-in-place.light.webp +0 -0
  138. package/agents/patterns/previews/message-placement/action-later.dark.webp +0 -0
  139. package/agents/patterns/previews/message-placement/action-later.light.webp +0 -0
  140. package/agents/patterns/previews/message-placement/action-partial-elsewhere.dark.webp +0 -0
  141. package/agents/patterns/previews/message-placement/action-partial-elsewhere.light.webp +0 -0
  142. package/agents/patterns/previews/message-placement/action-partial-in-place.dark.webp +0 -0
  143. package/agents/patterns/previews/message-placement/action-partial-in-place.light.webp +0 -0
  144. package/agents/patterns/previews/message-placement/action-taken.dark.webp +0 -0
  145. package/agents/patterns/previews/message-placement/action-taken.light.webp +0 -0
  146. package/agents/patterns/previews/message-placement/app-deadline.dark.webp +0 -0
  147. package/agents/patterns/previews/message-placement/app-deadline.light.webp +0 -0
  148. package/agents/patterns/previews/message-placement/app-failed.dark.webp +0 -0
  149. package/agents/patterns/previews/message-placement/app-failed.html +2 -2
  150. package/agents/patterns/previews/message-placement/app-failed.light.webp +0 -0
  151. package/agents/patterns/previews/message-placement/app-info.dark.webp +0 -0
  152. package/agents/patterns/previews/message-placement/app-info.light.webp +0 -0
  153. package/agents/patterns/previews/message-placement/decision.dark.webp +0 -0
  154. package/agents/patterns/previews/message-placement/decision.light.webp +0 -0
  155. package/agents/patterns/previews/message-placement/field-error.dark.webp +0 -0
  156. package/agents/patterns/previews/message-placement/field-error.light.webp +0 -0
  157. package/agents/patterns/previews/message-placement/field-hint.dark.webp +0 -0
  158. package/agents/patterns/previews/message-placement/field-hint.light.webp +0 -0
  159. package/agents/patterns/previews/message-placement/field-valid.dark.webp +0 -0
  160. package/agents/patterns/previews/message-placement/field-valid.light.webp +0 -0
  161. package/agents/patterns/previews/message-placement/region-failed.dark.webp +0 -0
  162. package/agents/patterns/previews/message-placement/region-failed.light.webp +0 -0
  163. package/agents/patterns/previews/message-placement/region-info.dark.webp +0 -0
  164. package/agents/patterns/previews/message-placement/region-info.light.webp +0 -0
  165. package/agents/patterns/previews/page-header/contact-being-edited.dark.webp +0 -0
  166. package/agents/patterns/previews/page-header/contact-being-edited.light.webp +0 -0
  167. package/agents/patterns/previews/page-header/members-of-a-group.dark.webp +0 -0
  168. package/agents/patterns/previews/page-header/members-of-a-group.light.webp +0 -0
  169. package/agents/patterns/previews/page-header/own-profile.dark.webp +0 -0
  170. package/agents/patterns/previews/page-header/own-profile.light.webp +0 -0
  171. package/agents/patterns/previews/page-header/request-from-the-list.dark.webp +0 -0
  172. package/agents/patterns/previews/page-header/request-from-the-list.light.webp +0 -0
  173. package/agents/patterns/previews/page-header/requests-of-an-office.dark.webp +0 -0
  174. package/agents/patterns/previews/page-header/requests-of-an-office.light.webp +0 -0
  175. package/agents/patterns/previews/record-detail/ask-for-words.dark.webp +0 -0
  176. package/agents/patterns/previews/record-detail/ask-for-words.html +2 -2
  177. package/agents/patterns/previews/record-detail/ask-for-words.light.webp +0 -0
  178. package/agents/patterns/previews/record-detail/edit-data.dark.webp +0 -0
  179. package/agents/patterns/previews/record-detail/edit-data.html +2 -2
  180. package/agents/patterns/previews/record-detail/edit-data.light.webp +0 -0
  181. package/agents/patterns/previews/record-detail/read-the-data.dark.webp +0 -0
  182. package/agents/patterns/previews/record-detail/read-the-data.html +2 -2
  183. package/agents/patterns/previews/record-detail/read-the-data.light.webp +0 -0
  184. package/agents/patterns/previews/record-detail/record-changed.dark.webp +0 -0
  185. package/agents/patterns/previews/record-detail/record-changed.html +2 -2
  186. package/agents/patterns/previews/record-detail/record-changed.light.webp +0 -0
  187. package/agents/patterns/previews/record-detail/run-at-once.dark.webp +0 -0
  188. package/agents/patterns/previews/record-detail/run-at-once.html +2 -2
  189. package/agents/patterns/previews/record-detail/run-at-once.light.webp +0 -0
  190. package/agents/patterns/previews/record-detail/work-on-it.dark.webp +0 -0
  191. package/agents/patterns/previews/record-detail/work-on-it.html +2 -2
  192. package/agents/patterns/previews/record-detail/work-on-it.light.webp +0 -0
  193. package/agents/patterns/previews/rhythm/between-containers.dark.webp +0 -0
  194. package/agents/patterns/previews/rhythm/between-containers.light.webp +0 -0
  195. package/agents/patterns/previews/rhythm/between-fields.dark.webp +0 -0
  196. package/agents/patterns/previews/rhythm/between-fields.light.webp +0 -0
  197. package/agents/patterns/previews/rhythm/between-groups.dark.webp +0 -0
  198. package/agents/patterns/previews/rhythm/between-groups.light.webp +0 -0
  199. package/agents/patterns/previews/rhythm/between-sections.dark.webp +0 -0
  200. package/agents/patterns/previews/rhythm/between-sections.light.webp +0 -0
  201. package/agents/patterns/previews/rhythm/content-actions.dark.webp +0 -0
  202. package/agents/patterns/previews/rhythm/content-actions.light.webp +0 -0
  203. package/agents/patterns/previews/rhythm/inline.dark.webp +0 -0
  204. package/agents/patterns/previews/rhythm/inline.light.webp +0 -0
  205. package/agents/patterns/previews/rhythm/inset.dark.webp +0 -0
  206. package/agents/patterns/previews/rhythm/inset.light.webp +0 -0
  207. package/agents/patterns/previews/rhythm/label-control.dark.webp +0 -0
  208. package/agents/patterns/previews/rhythm/label-control.light.webp +0 -0
  209. package/agents/patterns/previews/rhythm/title-content.dark.webp +0 -0
  210. package/agents/patterns/previews/rhythm/title-content.light.webp +0 -0
  211. package/agents/patterns/previews/surfaces/band.dark.webp +0 -0
  212. package/agents/patterns/previews/surfaces/band.html +2 -2
  213. package/agents/patterns/previews/surfaces/band.light.webp +0 -0
  214. package/agents/patterns/previews/surfaces/canvas.dark.webp +0 -0
  215. package/agents/patterns/previews/surfaces/canvas.html +2 -2
  216. package/agents/patterns/previews/surfaces/canvas.light.webp +0 -0
  217. package/agents/patterns/previews/surfaces/card.dark.webp +0 -0
  218. package/agents/patterns/previews/surfaces/card.light.webp +0 -0
  219. package/agents/patterns/previews/surfaces/dialog.dark.webp +0 -0
  220. package/agents/patterns/previews/surfaces/dialog.light.webp +0 -0
  221. package/agents/patterns/previews/surfaces/edit-actions.dark.webp +0 -0
  222. package/agents/patterns/previews/surfaces/edit-actions.light.webp +0 -0
  223. package/agents/patterns/previews/surfaces/section.dark.webp +0 -0
  224. package/agents/patterns/previews/surfaces/section.light.webp +0 -0
  225. package/agents/patterns/previews/titles/dialog.dark.webp +0 -0
  226. package/agents/patterns/previews/titles/dialog.light.webp +0 -0
  227. package/agents/patterns/previews/titles/group.dark.webp +0 -0
  228. package/agents/patterns/previews/titles/group.light.webp +0 -0
  229. package/agents/patterns/previews/titles/page.dark.webp +0 -0
  230. package/agents/patterns/previews/titles/page.light.webp +0 -0
  231. package/agents/patterns/previews/titles/part.dark.webp +0 -0
  232. package/agents/patterns/previews/titles/part.light.webp +0 -0
  233. package/agents/patterns/previews/titles/section.dark.webp +0 -0
  234. package/agents/patterns/previews/titles/section.light.webp +0 -0
  235. package/agents/patterns/previews/widths/dialog.dark.webp +0 -0
  236. package/agents/patterns/previews/widths/dialog.light.webp +0 -0
  237. package/agents/patterns/previews/widths/field.dark.webp +0 -0
  238. package/agents/patterns/previews/widths/field.light.webp +0 -0
  239. package/agents/patterns/previews/widths/form.dark.webp +0 -0
  240. package/agents/patterns/previews/widths/form.light.webp +0 -0
  241. package/agents/patterns/previews/widths/page.dark.webp +0 -0
  242. package/agents/patterns/previews/widths/page.html +2 -2
  243. package/agents/patterns/previews/widths/page.light.webp +0 -0
  244. package/agents/patterns/previews/widths/reading.dark.webp +0 -0
  245. package/agents/patterns/previews/widths/reading.light.webp +0 -0
  246. package/agents/patterns/rhythm.md +2 -1
  247. package/agents/patterns/surfaces.md +4 -3
  248. package/agents/patterns/titles.md +4 -3
  249. package/agents/patterns/widths.md +4 -3
  250. package/agents/patterns.md +8 -7
  251. package/agents/theming.md +21 -9
  252. package/dist/cjs/{aria-CzO5Rp1y.js → aria-r1anAHBr.js} +12 -0
  253. package/dist/cjs/{floating-controller-DaFymQCT.js → floating-controller-B4YhrWm8.js} +1 -1
  254. package/dist/cjs/{index-Bg68W-da.js → index-Csgx951d.js} +1 -1
  255. package/dist/cjs/loader.cjs.js +1 -1
  256. package/dist/cjs/{locale-CaR39iYg.js → locale-DgMC52AD.js} +1 -1
  257. package/dist/cjs/magma-components.cjs.js +1 -1
  258. package/dist/cjs/mds-accordion-item.cjs.entry.js +1 -1
  259. package/dist/cjs/mds-accordion-timer-item.cjs.entry.js +1 -1
  260. package/dist/cjs/mds-accordion.cjs.entry.js +1 -1
  261. package/dist/cjs/mds-avatar.cjs.entry.js +1 -1
  262. package/dist/cjs/mds-badge.cjs.entry.js +2 -2
  263. package/dist/cjs/mds-banner_3.cjs.entry.js +5 -5
  264. package/dist/cjs/mds-book.cjs.entry.js +2 -2
  265. package/dist/cjs/mds-breadcrumb.cjs.entry.js +2 -2
  266. package/dist/cjs/mds-button-dropdown.cjs.entry.js +6 -4
  267. package/dist/cjs/mds-button-group.cjs.entry.js +1 -1
  268. package/dist/cjs/mds-button_3.cjs.entry.js +78 -16
  269. package/dist/cjs/mds-calendar_2.cjs.entry.js +8 -8
  270. package/dist/cjs/mds-card-content.cjs.entry.js +1 -1
  271. package/dist/cjs/mds-card-footer.cjs.entry.js +1 -1
  272. package/dist/cjs/mds-card-header.cjs.entry.js +1 -1
  273. package/dist/cjs/mds-card-media.cjs.entry.js +1 -1
  274. package/dist/cjs/mds-card.cjs.entry.js +2 -2
  275. package/dist/cjs/mds-details.cjs.entry.js +2 -2
  276. package/dist/cjs/mds-dropdown.cjs.entry.js +6 -6
  277. package/dist/cjs/mds-emoji.cjs.entry.js +41 -12
  278. package/dist/cjs/mds-entity.cjs.entry.js +2 -2
  279. package/dist/cjs/mds-file-preview.cjs.entry.js +5 -5
  280. package/dist/cjs/mds-file.cjs.entry.js +5 -5
  281. package/dist/cjs/mds-filter-item.cjs.entry.js +5 -5
  282. package/dist/cjs/mds-filter.cjs.entry.js +4 -4
  283. package/dist/cjs/mds-header-bar.cjs.entry.js +3 -3
  284. package/dist/cjs/mds-header.cjs.entry.js +3 -3
  285. package/dist/cjs/mds-horizontal-scroll.cjs.entry.js +3 -3
  286. package/dist/cjs/mds-hr.cjs.entry.js +2 -2
  287. package/dist/cjs/mds-img.cjs.entry.js +2 -2
  288. package/dist/cjs/mds-input-date-range-preselection.cjs.entry.js +1 -1
  289. package/dist/cjs/mds-input-date-range.cjs.entry.js +4 -4
  290. package/dist/cjs/mds-input-date.cjs.entry.js +6 -6
  291. package/dist/cjs/mds-input-field.cjs.entry.js +1 -1
  292. package/dist/cjs/mds-input-otp.cjs.entry.js +3 -3
  293. package/dist/cjs/mds-input-range.cjs.entry.js +3 -3
  294. package/dist/cjs/mds-input-select.cjs.entry.js +6 -6
  295. package/dist/cjs/mds-input-switch_2.cjs.entry.js +6 -6
  296. package/dist/cjs/mds-input-tip_2.cjs.entry.js +5 -5
  297. package/dist/cjs/mds-input-upload.cjs.entry.js +7 -7
  298. package/dist/cjs/mds-input.cjs.entry.js +8 -8
  299. package/dist/cjs/mds-keyboard-key.cjs.entry.js +3 -3
  300. package/dist/cjs/mds-keyboard.cjs.entry.js +4 -4
  301. package/dist/cjs/mds-kpi-item.cjs.entry.js +3 -3
  302. package/dist/cjs/mds-kpi.cjs.entry.js +1 -1
  303. package/dist/cjs/mds-label.cjs.entry.js +3 -3
  304. package/dist/cjs/mds-link.cjs.entry.js +5 -5
  305. package/dist/cjs/mds-list-item.cjs.entry.js +1 -1
  306. package/dist/cjs/mds-list.cjs.entry.js +1 -1
  307. package/dist/cjs/mds-mention.cjs.entry.js +3 -3
  308. package/dist/cjs/mds-modal.cjs.entry.js +34 -15
  309. package/dist/cjs/mds-note.cjs.entry.js +4 -4
  310. package/dist/cjs/mds-notification.cjs.entry.js +3 -3
  311. package/dist/cjs/mds-paginator-item.cjs.entry.js +2 -2
  312. package/dist/cjs/mds-paginator.cjs.entry.js +4 -4
  313. package/dist/cjs/mds-policy-ai.cjs.entry.js +3 -3
  314. package/dist/cjs/mds-pref-animation.cjs.entry.js +3 -3
  315. package/dist/cjs/mds-pref-consumption.cjs.entry.js +3 -3
  316. package/dist/cjs/mds-pref-contrast.cjs.entry.js +3 -3
  317. package/dist/cjs/mds-pref-language-item.cjs.entry.js +3 -3
  318. package/dist/cjs/mds-pref-language.cjs.entry.js +3 -3
  319. package/dist/cjs/mds-pref-mode.cjs.entry.js +22 -13
  320. package/dist/cjs/mds-pref-theme-item.cjs.entry.js +18 -4
  321. package/dist/cjs/mds-pref-theme.cjs.entry.js +42 -10
  322. package/dist/cjs/mds-pref.cjs.entry.js +3 -25
  323. package/dist/cjs/mds-price-table-features-cell.cjs.entry.js +3 -3
  324. package/dist/cjs/mds-price-table-features-row.cjs.entry.js +3 -3
  325. package/dist/cjs/mds-price-table-features.cjs.entry.js +2 -2
  326. package/dist/cjs/mds-price-table-header.cjs.entry.js +1 -1
  327. package/dist/cjs/mds-price-table-list-item.cjs.entry.js +1 -1
  328. package/dist/cjs/mds-price-table-list.cjs.entry.js +3 -3
  329. package/dist/cjs/mds-price-table.cjs.entry.js +1 -1
  330. package/dist/cjs/mds-progress_2.cjs.entry.js +4 -4
  331. package/dist/cjs/mds-push-notification-item.cjs.entry.js +4 -4
  332. package/dist/cjs/mds-push-notification.cjs.entry.js +4 -4
  333. package/dist/cjs/mds-quote.cjs.entry.js +2 -2
  334. package/dist/cjs/mds-radial-menu-item.cjs.entry.js +1 -1
  335. package/dist/cjs/mds-radial-menu.cjs.entry.js +5 -5
  336. package/dist/cjs/mds-separator.cjs.entry.js +2 -2
  337. package/dist/cjs/mds-status-bar.cjs.entry.js +3 -3
  338. package/dist/cjs/mds-stepper-bar-item.cjs.entry.js +3 -3
  339. package/dist/cjs/mds-stepper-bar.cjs.entry.js +1 -1
  340. package/dist/cjs/mds-tab-bar-item.cjs.entry.js +4 -4
  341. package/dist/cjs/mds-tab-bar.cjs.entry.js +3 -3
  342. package/dist/cjs/mds-tab_2.cjs.entry.js +6 -6
  343. package/dist/cjs/mds-table-body.cjs.entry.js +2 -2
  344. package/dist/cjs/mds-table-footer.cjs.entry.js +2 -2
  345. package/dist/cjs/mds-table-header-cell.cjs.entry.js +2 -2
  346. package/dist/cjs/mds-table-header.cjs.entry.js +3 -3
  347. package/dist/cjs/mds-table-row.cjs.entry.js +4 -4
  348. package/dist/cjs/mds-table.cjs.entry.js +4 -4
  349. package/dist/cjs/mds-text.cjs.entry.js +2 -2
  350. package/dist/cjs/mds-toast-region.cjs.entry.js +1 -1
  351. package/dist/cjs/mds-toast.cjs.entry.js +3 -3
  352. package/dist/cjs/mds-tooltip.cjs.entry.js +5 -5
  353. package/dist/cjs/mds-tree-item.cjs.entry.js +3 -3
  354. package/dist/cjs/mds-tree.cjs.entry.js +1 -1
  355. package/dist/cjs/mds-url-view.cjs.entry.js +4 -4
  356. package/dist/cjs/mds-usage.cjs.entry.js +4 -4
  357. package/dist/cjs/mds-video-wall.cjs.entry.js +2 -2
  358. package/dist/cjs/mds-zero.cjs.entry.js +3 -3
  359. package/dist/cjs/{preference-CQQ3eb9W.js → preference-DhNxLZ4R.js} +20 -0
  360. package/dist/collection/common/aria.js +12 -1
  361. package/dist/collection/common/preference.js +19 -1
  362. package/dist/collection/components/mds-accordion/AGENTS.md +1 -1
  363. package/dist/collection/components/mds-accordion/documentation.json +1 -1
  364. package/dist/collection/components/mds-accordion-item/AGENTS.md +1 -1
  365. package/dist/collection/components/mds-accordion-item/documentation.json +1 -1
  366. package/dist/collection/components/mds-accordion-timer/AGENTS.md +1 -1
  367. package/dist/collection/components/mds-accordion-timer/documentation.json +1 -1
  368. package/dist/collection/components/mds-accordion-timer-item/AGENTS.md +1 -1
  369. package/dist/collection/components/mds-accordion-timer-item/documentation.json +1 -1
  370. package/dist/collection/components/mds-author/AGENTS.md +1 -1
  371. package/dist/collection/components/mds-author/documentation.json +1 -1
  372. package/dist/collection/components/mds-avatar/AGENTS.md +1 -1
  373. package/dist/collection/components/mds-avatar/documentation.json +2 -2
  374. package/dist/collection/components/mds-avatar-stack/AGENTS.md +1 -1
  375. package/dist/collection/components/mds-avatar-stack/documentation.json +2 -2
  376. package/dist/collection/components/mds-avatar-stack-item/AGENTS.md +1 -1
  377. package/dist/collection/components/mds-avatar-stack-item/documentation.json +2 -2
  378. package/dist/collection/components/mds-badge/AGENTS.md +1 -1
  379. package/dist/collection/components/mds-badge/documentation.json +1 -1
  380. package/dist/collection/components/mds-badge/mds-badge.css +15 -10
  381. package/dist/collection/components/mds-banner/AGENTS.md +1 -1
  382. package/dist/collection/components/mds-banner/documentation.json +2 -2
  383. package/dist/collection/components/mds-benchmark-bar/AGENTS.md +1 -1
  384. package/dist/collection/components/mds-benchmark-bar/documentation.json +1 -1
  385. package/dist/collection/components/mds-bibliography/AGENTS.md +1 -1
  386. package/dist/collection/components/mds-bibliography/documentation.json +1 -1
  387. package/dist/collection/components/mds-book/AGENTS.md +1 -1
  388. package/dist/collection/components/mds-book/documentation.json +1 -1
  389. package/dist/collection/components/mds-breadcrumb/AGENTS.md +1 -1
  390. package/dist/collection/components/mds-breadcrumb/documentation.json +2 -2
  391. package/dist/collection/components/mds-breadcrumb-item/AGENTS.md +1 -1
  392. package/dist/collection/components/mds-breadcrumb-item/documentation.json +2 -2
  393. package/dist/collection/components/mds-button/AGENTS.md +9 -4
  394. package/dist/collection/components/mds-button/documentation.json +100 -7
  395. package/dist/collection/components/mds-button/examples.md +73 -0
  396. package/dist/collection/components/mds-button/mds-button.css +122 -14
  397. package/dist/collection/components/mds-button/mds-button.js +139 -13
  398. package/dist/collection/components/mds-button/mistakes.md +35 -0
  399. package/dist/collection/components/mds-button-dropdown/AGENTS.md +7 -2
  400. package/dist/collection/components/mds-button-dropdown/documentation.json +97 -4
  401. package/dist/collection/components/mds-button-dropdown/mds-button-dropdown.js +69 -3
  402. package/dist/collection/components/mds-button-group/AGENTS.md +1 -1
  403. package/dist/collection/components/mds-button-group/documentation.json +1 -1
  404. package/dist/collection/components/mds-button-group/mds-button-group.js +1 -1
  405. package/dist/collection/components/mds-calendar/AGENTS.md +1 -1
  406. package/dist/collection/components/mds-calendar/documentation.json +2 -2
  407. package/dist/collection/components/mds-calendar/mds-calendar.js +5 -5
  408. package/dist/collection/components/mds-calendar-cell/AGENTS.md +1 -1
  409. package/dist/collection/components/mds-calendar-cell/documentation.json +2 -2
  410. package/dist/collection/components/mds-calendar-cell/mds-calendar-cell.js +1 -1
  411. package/dist/collection/components/mds-card/AGENTS.md +1 -1
  412. package/dist/collection/components/mds-card/documentation.json +1 -1
  413. package/dist/collection/components/mds-card/mds-card.js +1 -1
  414. package/dist/collection/components/mds-card-content/AGENTS.md +1 -1
  415. package/dist/collection/components/mds-card-content/documentation.json +1 -1
  416. package/dist/collection/components/mds-card-content/mds-card-content.js +1 -1
  417. package/dist/collection/components/mds-card-footer/AGENTS.md +1 -1
  418. package/dist/collection/components/mds-card-footer/documentation.json +1 -1
  419. package/dist/collection/components/mds-card-footer/mds-card-footer.js +1 -1
  420. package/dist/collection/components/mds-card-header/AGENTS.md +1 -1
  421. package/dist/collection/components/mds-card-header/documentation.json +1 -1
  422. package/dist/collection/components/mds-card-header/mds-card-header.js +1 -1
  423. package/dist/collection/components/mds-card-media/AGENTS.md +1 -1
  424. package/dist/collection/components/mds-card-media/documentation.json +1 -1
  425. package/dist/collection/components/mds-card-media/mds-card-media.js +1 -1
  426. package/dist/collection/components/mds-chip/AGENTS.md +1 -1
  427. package/dist/collection/components/mds-chip/documentation.json +2 -2
  428. package/dist/collection/components/mds-chip/mds-chip.css +3 -2
  429. package/dist/collection/components/mds-chip/mds-chip.js +1 -1
  430. package/dist/collection/components/mds-details/AGENTS.md +1 -1
  431. package/dist/collection/components/mds-details/documentation.json +1 -1
  432. package/dist/collection/components/mds-details/mds-details.js +1 -1
  433. package/dist/collection/components/mds-dropdown/AGENTS.md +1 -1
  434. package/dist/collection/components/mds-dropdown/documentation.json +1 -1
  435. package/dist/collection/components/mds-dropdown/mds-dropdown.css +12 -14
  436. package/dist/collection/components/mds-dropdown/mds-dropdown.js +2 -2
  437. package/dist/collection/components/mds-emoji/AGENTS.md +1 -1
  438. package/dist/collection/components/mds-emoji/documentation.json +1 -1
  439. package/dist/collection/components/mds-emoji/mds-emoji.js +1 -1
  440. package/dist/collection/components/mds-entity/AGENTS.md +1 -1
  441. package/dist/collection/components/mds-entity/documentation.json +2 -2
  442. package/dist/collection/components/mds-entity/mds-entity.js +1 -1
  443. package/dist/collection/components/mds-file/AGENTS.md +1 -1
  444. package/dist/collection/components/mds-file/documentation.json +1 -1
  445. package/dist/collection/components/mds-file/mds-file.css +3 -2
  446. package/dist/collection/components/mds-file/mds-file.js +1 -1
  447. package/dist/collection/components/mds-file-preview/AGENTS.md +1 -1
  448. package/dist/collection/components/mds-file-preview/documentation.json +2 -2
  449. package/dist/collection/components/mds-file-preview/mds-file-preview.css +3 -2
  450. package/dist/collection/components/mds-file-preview/mds-file-preview.js +2 -2
  451. package/dist/collection/components/mds-filter/AGENTS.md +1 -1
  452. package/dist/collection/components/mds-filter/documentation.json +1 -1
  453. package/dist/collection/components/mds-filter/mds-filter.css +3 -2
  454. package/dist/collection/components/mds-filter/mds-filter.js +1 -1
  455. package/dist/collection/components/mds-filter-item/AGENTS.md +1 -1
  456. package/dist/collection/components/mds-filter-item/documentation.json +1 -1
  457. package/dist/collection/components/mds-filter-item/mds-filter-item.css +3 -2
  458. package/dist/collection/components/mds-filter-item/mds-filter-item.js +1 -1
  459. package/dist/collection/components/mds-header/AGENTS.md +1 -1
  460. package/dist/collection/components/mds-header/documentation.json +2 -2
  461. package/dist/collection/components/mds-header/mds-header.css +3 -2
  462. package/dist/collection/components/mds-header/mds-header.js +1 -1
  463. package/dist/collection/components/mds-header-bar/AGENTS.md +1 -1
  464. package/dist/collection/components/mds-header-bar/documentation.json +2 -2
  465. package/dist/collection/components/mds-header-bar/mds-header-bar.js +1 -1
  466. package/dist/collection/components/mds-help/AGENTS.md +1 -1
  467. package/dist/collection/components/mds-help/documentation.json +1 -1
  468. package/dist/collection/components/mds-help/mds-help.js +1 -1
  469. package/dist/collection/components/mds-horizontal-scroll/AGENTS.md +1 -1
  470. package/dist/collection/components/mds-horizontal-scroll/documentation.json +2 -2
  471. package/dist/collection/components/mds-horizontal-scroll/mds-horizontal-scroll.js +1 -1
  472. package/dist/collection/components/mds-hr/AGENTS.md +1 -1
  473. package/dist/collection/components/mds-hr/documentation.json +1 -1
  474. package/dist/collection/components/mds-hr/mds-hr.js +1 -1
  475. package/dist/collection/components/mds-icon/AGENTS.md +1 -1
  476. package/dist/collection/components/mds-icon/documentation.json +1 -1
  477. package/dist/collection/components/mds-icon/mds-icon.js +1 -1
  478. package/dist/collection/components/mds-img/AGENTS.md +1 -1
  479. package/dist/collection/components/mds-img/documentation.json +2 -2
  480. package/dist/collection/components/mds-input/AGENTS.md +1 -1
  481. package/dist/collection/components/mds-input/documentation.json +2 -2
  482. package/dist/collection/components/mds-input/mds-input.css +16 -8
  483. package/dist/collection/components/mds-input/mds-input.js +3 -3
  484. package/dist/collection/components/mds-input-date/AGENTS.md +1 -1
  485. package/dist/collection/components/mds-input-date/documentation.json +2 -2
  486. package/dist/collection/components/mds-input-date/mds-input-date.css +3 -2
  487. package/dist/collection/components/mds-input-date/mds-input-date.js +2 -2
  488. package/dist/collection/components/mds-input-date-range/AGENTS.md +1 -1
  489. package/dist/collection/components/mds-input-date-range/documentation.json +2 -2
  490. package/dist/collection/components/mds-input-date-range/mds-input-date-range.css +3 -2
  491. package/dist/collection/components/mds-input-date-range-preselection/AGENTS.md +1 -1
  492. package/dist/collection/components/mds-input-date-range-preselection/documentation.json +2 -2
  493. package/dist/collection/components/mds-input-date-range-preselection/mds-input-date-range-preselection.js +1 -1
  494. package/dist/collection/components/mds-input-field/AGENTS.md +1 -1
  495. package/dist/collection/components/mds-input-field/documentation.json +1 -1
  496. package/dist/collection/components/mds-input-field/mds-input-field.js +1 -1
  497. package/dist/collection/components/mds-input-otp/AGENTS.md +1 -1
  498. package/dist/collection/components/mds-input-otp/documentation.json +2 -2
  499. package/dist/collection/components/mds-input-otp/mds-input-otp.js +1 -1
  500. package/dist/collection/components/mds-input-range/AGENTS.md +1 -1
  501. package/dist/collection/components/mds-input-range/documentation.json +1 -1
  502. package/dist/collection/components/mds-input-range/mds-input-range.css +3 -2
  503. package/dist/collection/components/mds-input-range/mds-input-range.js +1 -1
  504. package/dist/collection/components/mds-input-select/AGENTS.md +1 -1
  505. package/dist/collection/components/mds-input-select/documentation.json +1 -1
  506. package/dist/collection/components/mds-input-select/mds-input-select.css +15 -11
  507. package/dist/collection/components/mds-input-select/mds-input-select.js +2 -2
  508. package/dist/collection/components/mds-input-switch/AGENTS.md +1 -1
  509. package/dist/collection/components/mds-input-switch/documentation.json +1 -1
  510. package/dist/collection/components/mds-input-switch/mds-input-switch.css +3 -2
  511. package/dist/collection/components/mds-input-switch/mds-input-switch.js +1 -1
  512. package/dist/collection/components/mds-input-tip/AGENTS.md +1 -1
  513. package/dist/collection/components/mds-input-tip/documentation.json +1 -1
  514. package/dist/collection/components/mds-input-tip/mds-input-tip.js +1 -1
  515. package/dist/collection/components/mds-input-tip-item/AGENTS.md +1 -1
  516. package/dist/collection/components/mds-input-tip-item/documentation.json +1 -1
  517. package/dist/collection/components/mds-input-tip-item/mds-input-tip-item.js +2 -2
  518. package/dist/collection/components/mds-input-upload/AGENTS.md +1 -1
  519. package/dist/collection/components/mds-input-upload/documentation.json +2 -2
  520. package/dist/collection/components/mds-input-upload/mds-input-upload.js +5 -5
  521. package/dist/collection/components/mds-keyboard/AGENTS.md +1 -1
  522. package/dist/collection/components/mds-keyboard/documentation.json +2 -2
  523. package/dist/collection/components/mds-keyboard/mds-keyboard.css +3 -2
  524. package/dist/collection/components/mds-keyboard/mds-keyboard.js +1 -1
  525. package/dist/collection/components/mds-keyboard-key/AGENTS.md +1 -1
  526. package/dist/collection/components/mds-keyboard-key/documentation.json +1 -1
  527. package/dist/collection/components/mds-keyboard-key/mds-keyboard-key.js +1 -1
  528. package/dist/collection/components/mds-kpi/AGENTS.md +1 -1
  529. package/dist/collection/components/mds-kpi/documentation.json +1 -1
  530. package/dist/collection/components/mds-kpi/mds-kpi.js +1 -1
  531. package/dist/collection/components/mds-kpi-item/AGENTS.md +1 -1
  532. package/dist/collection/components/mds-kpi-item/documentation.json +1 -1
  533. package/dist/collection/components/mds-kpi-item/mds-kpi-item.css +9 -6
  534. package/dist/collection/components/mds-kpi-item/mds-kpi-item.js +1 -1
  535. package/dist/collection/components/mds-label/AGENTS.md +1 -1
  536. package/dist/collection/components/mds-label/documentation.json +2 -2
  537. package/dist/collection/components/mds-label/mds-label.css +3 -2
  538. package/dist/collection/components/mds-link/AGENTS.md +1 -1
  539. package/dist/collection/components/mds-link/documentation.json +1 -1
  540. package/dist/collection/components/mds-link/mds-link.js +3 -3
  541. package/dist/collection/components/mds-list/AGENTS.md +1 -1
  542. package/dist/collection/components/mds-list/documentation.json +1 -1
  543. package/dist/collection/components/mds-list/mds-list.js +1 -1
  544. package/dist/collection/components/mds-list-item/AGENTS.md +1 -1
  545. package/dist/collection/components/mds-list-item/documentation.json +1 -1
  546. package/dist/collection/components/mds-list-item/mds-list-item.js +1 -1
  547. package/dist/collection/components/mds-mention/AGENTS.md +1 -1
  548. package/dist/collection/components/mds-mention/documentation.json +2 -2
  549. package/dist/collection/components/mds-mention/mds-mention.js +1 -1
  550. package/dist/collection/components/mds-modal/AGENTS.md +3 -3
  551. package/dist/collection/components/mds-modal/documentation.json +4 -4
  552. package/dist/collection/components/mds-modal/mds-modal.css +3 -2
  553. package/dist/collection/components/mds-modal/mds-modal.js +32 -13
  554. package/dist/collection/components/mds-note/AGENTS.md +1 -1
  555. package/dist/collection/components/mds-note/documentation.json +2 -2
  556. package/dist/collection/components/mds-note/mds-note.css +3 -2
  557. package/dist/collection/components/mds-note/mds-note.js +1 -1
  558. package/dist/collection/components/mds-notification/AGENTS.md +1 -1
  559. package/dist/collection/components/mds-notification/documentation.json +1 -1
  560. package/dist/collection/components/mds-notification/mds-notification.js +1 -1
  561. package/dist/collection/components/mds-paginator/AGENTS.md +1 -1
  562. package/dist/collection/components/mds-paginator/documentation.json +1 -1
  563. package/dist/collection/components/mds-paginator/mds-paginator.css +3 -2
  564. package/dist/collection/components/mds-paginator/mds-paginator.js +1 -1
  565. package/dist/collection/components/mds-paginator-item/AGENTS.md +1 -1
  566. package/dist/collection/components/mds-paginator-item/documentation.json +1 -1
  567. package/dist/collection/components/mds-paginator-item/mds-paginator-item.js +1 -1
  568. package/dist/collection/components/mds-policy-ai/AGENTS.md +1 -1
  569. package/dist/collection/components/mds-policy-ai/documentation.json +2 -2
  570. package/dist/collection/components/mds-policy-ai/mds-policy-ai.js +1 -1
  571. package/dist/collection/components/mds-pref/AGENTS.md +3 -3
  572. package/dist/collection/components/mds-pref/documentation.json +4 -9
  573. package/dist/collection/components/mds-pref/examples.md +1 -1
  574. package/dist/collection/components/mds-pref/mds-pref.js +1 -29
  575. package/dist/collection/components/mds-pref/mistakes.md +1 -1
  576. package/dist/collection/components/mds-pref-animation/AGENTS.md +1 -1
  577. package/dist/collection/components/mds-pref-animation/documentation.json +2 -2
  578. package/dist/collection/components/mds-pref-animation/mds-pref-animation.js +1 -1
  579. package/dist/collection/components/mds-pref-consumption/AGENTS.md +1 -1
  580. package/dist/collection/components/mds-pref-consumption/documentation.json +2 -2
  581. package/dist/collection/components/mds-pref-consumption/mds-pref-consumption.js +1 -1
  582. package/dist/collection/components/mds-pref-contrast/AGENTS.md +1 -1
  583. package/dist/collection/components/mds-pref-contrast/documentation.json +2 -2
  584. package/dist/collection/components/mds-pref-contrast/mds-pref-contrast.js +1 -1
  585. package/dist/collection/components/mds-pref-language/AGENTS.md +1 -1
  586. package/dist/collection/components/mds-pref-language/documentation.json +2 -2
  587. package/dist/collection/components/mds-pref-language/mds-pref-language.js +1 -1
  588. package/dist/collection/components/mds-pref-language-item/AGENTS.md +1 -1
  589. package/dist/collection/components/mds-pref-language-item/documentation.json +2 -2
  590. package/dist/collection/components/mds-pref-language-item/mds-pref-language-item.js +1 -1
  591. package/dist/collection/components/mds-pref-mode/AGENTS.md +3 -2
  592. package/dist/collection/components/mds-pref-mode/documentation.json +5 -5
  593. package/dist/collection/components/mds-pref-mode/mds-pref-mode.css +2 -1
  594. package/dist/collection/components/mds-pref-mode/mds-pref-mode.js +20 -11
  595. package/dist/collection/components/mds-pref-mode/mistakes.md +1 -1
  596. package/dist/collection/components/mds-pref-theme/AGENTS.md +7 -6
  597. package/dist/collection/components/mds-pref-theme/documentation.json +7 -7
  598. package/dist/collection/components/mds-pref-theme/examples.md +18 -21
  599. package/dist/collection/components/mds-pref-theme/mds-pref-theme.js +43 -11
  600. package/dist/collection/components/mds-pref-theme/mistakes.md +15 -15
  601. package/dist/collection/components/mds-pref-theme-item/AGENTS.md +6 -6
  602. package/dist/collection/components/mds-pref-theme-item/documentation.json +9 -9
  603. package/dist/collection/components/mds-pref-theme-item/examples.md +18 -24
  604. package/dist/collection/components/mds-pref-theme-item/mds-pref-theme-item.css +13 -7
  605. package/dist/collection/components/mds-pref-theme-item/mds-pref-theme-item.js +19 -5
  606. package/dist/collection/components/mds-pref-theme-item/mistakes.md +14 -16
  607. package/dist/collection/components/mds-price-table/AGENTS.md +1 -1
  608. package/dist/collection/components/mds-price-table/documentation.json +1 -1
  609. package/dist/collection/components/mds-price-table/mds-price-table.js +1 -1
  610. package/dist/collection/components/mds-price-table-features/AGENTS.md +1 -1
  611. package/dist/collection/components/mds-price-table-features/documentation.json +1 -1
  612. package/dist/collection/components/mds-price-table-features/mds-price-table-features.js +1 -1
  613. package/dist/collection/components/mds-price-table-features-cell/AGENTS.md +1 -1
  614. package/dist/collection/components/mds-price-table-features-cell/documentation.json +1 -1
  615. package/dist/collection/components/mds-price-table-features-cell/mds-price-table-features-cell.css +3 -2
  616. package/dist/collection/components/mds-price-table-features-cell/mds-price-table-features-cell.js +1 -1
  617. package/dist/collection/components/mds-price-table-features-row/AGENTS.md +1 -1
  618. package/dist/collection/components/mds-price-table-features-row/documentation.json +1 -1
  619. package/dist/collection/components/mds-price-table-features-row/mds-price-table-features-row.css +3 -2
  620. package/dist/collection/components/mds-price-table-features-row/mds-price-table-features-row.js +1 -1
  621. package/dist/collection/components/mds-price-table-header/AGENTS.md +1 -1
  622. package/dist/collection/components/mds-price-table-header/documentation.json +1 -1
  623. package/dist/collection/components/mds-price-table-header/mds-price-table-header.js +1 -1
  624. package/dist/collection/components/mds-price-table-list/AGENTS.md +1 -1
  625. package/dist/collection/components/mds-price-table-list/documentation.json +1 -1
  626. package/dist/collection/components/mds-price-table-list/mds-price-table-list.css +3 -2
  627. package/dist/collection/components/mds-price-table-list/mds-price-table-list.js +1 -1
  628. package/dist/collection/components/mds-price-table-list-item/AGENTS.md +1 -1
  629. package/dist/collection/components/mds-price-table-list-item/documentation.json +1 -1
  630. package/dist/collection/components/mds-price-table-list-item/mds-price-table-list-item.js +1 -1
  631. package/dist/collection/components/mds-progress/AGENTS.md +1 -1
  632. package/dist/collection/components/mds-progress/documentation.json +1 -1
  633. package/dist/collection/components/mds-progress/mds-progress.css +3 -2
  634. package/dist/collection/components/mds-progress/mds-progress.js +1 -1
  635. package/dist/collection/components/mds-push-notification/AGENTS.md +1 -1
  636. package/dist/collection/components/mds-push-notification/documentation.json +2 -2
  637. package/dist/collection/components/mds-push-notification/mds-push-notification.css +3 -2
  638. package/dist/collection/components/mds-push-notification/mds-push-notification.js +1 -1
  639. package/dist/collection/components/mds-push-notification-item/AGENTS.md +1 -1
  640. package/dist/collection/components/mds-push-notification-item/documentation.json +2 -2
  641. package/dist/collection/components/mds-push-notification-item/mds-push-notification-item.js +2 -2
  642. package/dist/collection/components/mds-quote/AGENTS.md +1 -1
  643. package/dist/collection/components/mds-quote/documentation.json +1 -1
  644. package/dist/collection/components/mds-quote/mds-quote.js +1 -1
  645. package/dist/collection/components/mds-radial-menu/AGENTS.md +1 -1
  646. package/dist/collection/components/mds-radial-menu/documentation.json +2 -2
  647. package/dist/collection/components/mds-radial-menu/mds-radial-menu.js +1 -1
  648. package/dist/collection/components/mds-radial-menu-item/AGENTS.md +1 -1
  649. package/dist/collection/components/mds-radial-menu-item/documentation.json +2 -2
  650. package/dist/collection/components/mds-radial-menu-item/mds-radial-menu-item.js +1 -1
  651. package/dist/collection/components/mds-radial-progress/AGENTS.md +1 -1
  652. package/dist/collection/components/mds-radial-progress/documentation.json +1 -1
  653. package/dist/collection/components/mds-radial-progress/mds-radial-progress.js +1 -1
  654. package/dist/collection/components/mds-separator/AGENTS.md +1 -1
  655. package/dist/collection/components/mds-separator/documentation.json +1 -1
  656. package/dist/collection/components/mds-separator/mds-separator.js +1 -1
  657. package/dist/collection/components/mds-spinner/AGENTS.md +1 -1
  658. package/dist/collection/components/mds-spinner/documentation.json +1 -1
  659. package/dist/collection/components/mds-spinner/mds-spinner.js +1 -1
  660. package/dist/collection/components/mds-status-bar/AGENTS.md +1 -1
  661. package/dist/collection/components/mds-status-bar/documentation.json +2 -2
  662. package/dist/collection/components/mds-status-bar/mds-status-bar.css +3 -2
  663. package/dist/collection/components/mds-status-bar/mds-status-bar.js +1 -1
  664. package/dist/collection/components/mds-stepper-bar/AGENTS.md +1 -1
  665. package/dist/collection/components/mds-stepper-bar/documentation.json +1 -1
  666. package/dist/collection/components/mds-stepper-bar/mds-stepper-bar.js +1 -1
  667. package/dist/collection/components/mds-stepper-bar-item/AGENTS.md +1 -1
  668. package/dist/collection/components/mds-stepper-bar-item/documentation.json +1 -1
  669. package/dist/collection/components/mds-stepper-bar-item/mds-stepper-bar-item.js +1 -1
  670. package/dist/collection/components/mds-tab/AGENTS.md +1 -1
  671. package/dist/collection/components/mds-tab/documentation.json +1 -1
  672. package/dist/collection/components/mds-tab/mds-tab.css +3 -2
  673. package/dist/collection/components/mds-tab/mds-tab.js +2 -2
  674. package/dist/collection/components/mds-tab-bar/AGENTS.md +1 -1
  675. package/dist/collection/components/mds-tab-bar/documentation.json +1 -1
  676. package/dist/collection/components/mds-tab-bar/mds-tab-bar.css +3 -2
  677. package/dist/collection/components/mds-tab-bar/mds-tab-bar.js +1 -1
  678. package/dist/collection/components/mds-tab-bar-item/AGENTS.md +1 -1
  679. package/dist/collection/components/mds-tab-bar-item/documentation.json +1 -1
  680. package/dist/collection/components/mds-tab-bar-item/mds-tab-bar-item.css +3 -2
  681. package/dist/collection/components/mds-tab-bar-item/mds-tab-bar-item.js +1 -1
  682. package/dist/collection/components/mds-tab-item/AGENTS.md +1 -1
  683. package/dist/collection/components/mds-tab-item/documentation.json +2 -2
  684. package/dist/collection/components/mds-tab-item/mds-tab-item.js +1 -1
  685. package/dist/collection/components/mds-table/AGENTS.md +1 -1
  686. package/dist/collection/components/mds-table/documentation.json +1 -1
  687. package/dist/collection/components/mds-table/mds-table.css +6 -4
  688. package/dist/collection/components/mds-table/mds-table.js +1 -1
  689. package/dist/collection/components/mds-table-body/AGENTS.md +1 -1
  690. package/dist/collection/components/mds-table-body/documentation.json +1 -1
  691. package/dist/collection/components/mds-table-body/mds-table-body.js +1 -1
  692. package/dist/collection/components/mds-table-cell/AGENTS.md +1 -1
  693. package/dist/collection/components/mds-table-cell/documentation.json +1 -1
  694. package/dist/collection/components/mds-table-cell/mds-table-cell.js +1 -1
  695. package/dist/collection/components/mds-table-footer/AGENTS.md +1 -1
  696. package/dist/collection/components/mds-table-footer/documentation.json +1 -1
  697. package/dist/collection/components/mds-table-footer/mds-table-footer.js +1 -1
  698. package/dist/collection/components/mds-table-header/AGENTS.md +1 -1
  699. package/dist/collection/components/mds-table-header/documentation.json +2 -2
  700. package/dist/collection/components/mds-table-header/mds-table-header.js +1 -1
  701. package/dist/collection/components/mds-table-header-cell/AGENTS.md +1 -1
  702. package/dist/collection/components/mds-table-header-cell/documentation.json +2 -2
  703. package/dist/collection/components/mds-table-header-cell/mds-table-header-cell.js +1 -1
  704. package/dist/collection/components/mds-table-row/AGENTS.md +1 -1
  705. package/dist/collection/components/mds-table-row/documentation.json +1 -1
  706. package/dist/collection/components/mds-table-row/mds-table-row.js +2 -2
  707. package/dist/collection/components/mds-text/AGENTS.md +1 -1
  708. package/dist/collection/components/mds-text/documentation.json +1 -1
  709. package/dist/collection/components/mds-text/mds-text.js +1 -1
  710. package/dist/collection/components/mds-toast/AGENTS.md +1 -1
  711. package/dist/collection/components/mds-toast/documentation.json +2 -2
  712. package/dist/collection/components/mds-toast/mds-toast.js +1 -1
  713. package/dist/collection/components/mds-toast-region/AGENTS.md +1 -1
  714. package/dist/collection/components/mds-toast-region/documentation.json +1 -1
  715. package/dist/collection/components/mds-toast-region/mds-toast-region.js +1 -1
  716. package/dist/collection/components/mds-tooltip/AGENTS.md +1 -1
  717. package/dist/collection/components/mds-tooltip/documentation.json +1 -1
  718. package/dist/collection/components/mds-tooltip/mds-tooltip.css +4 -2
  719. package/dist/collection/components/mds-tooltip/mds-tooltip.js +1 -1
  720. package/dist/collection/components/mds-tree/AGENTS.md +1 -1
  721. package/dist/collection/components/mds-tree/documentation.json +1 -1
  722. package/dist/collection/components/mds-tree/mds-tree.js +1 -1
  723. package/dist/collection/components/mds-tree-item/AGENTS.md +1 -1
  724. package/dist/collection/components/mds-tree-item/documentation.json +2 -2
  725. package/dist/collection/components/mds-tree-item/mds-tree-item.js +1 -1
  726. package/dist/collection/components/mds-url-view/AGENTS.md +1 -1
  727. package/dist/collection/components/mds-url-view/documentation.json +2 -2
  728. package/dist/collection/components/mds-url-view/mds-url-view.css +3 -2
  729. package/dist/collection/components/mds-url-view/mds-url-view.js +1 -1
  730. package/dist/collection/components/mds-usage/AGENTS.md +1 -1
  731. package/dist/collection/components/mds-usage/documentation.json +1 -1
  732. package/dist/collection/components/mds-usage/mds-usage.css +3 -2
  733. package/dist/collection/components/mds-usage/mds-usage.js +1 -1
  734. package/dist/collection/components/mds-video-wall/AGENTS.md +1 -1
  735. package/dist/collection/components/mds-video-wall/documentation.json +1 -1
  736. package/dist/collection/components/mds-video-wall/mds-video-wall.js +1 -1
  737. package/dist/collection/components/mds-zero/AGENTS.md +1 -1
  738. package/dist/collection/components/mds-zero/documentation.json +1 -1
  739. package/dist/collection/components/mds-zero/mds-zero.css +3 -2
  740. package/dist/collection/components/mds-zero/mds-zero.js +1 -1
  741. package/dist/collection/type/button.js +3 -0
  742. package/dist/components/index.js +1 -1
  743. package/dist/components/mds-accordion-item.js +1 -1
  744. package/dist/components/mds-accordion-timer-item.js +1 -1
  745. package/dist/components/mds-accordion.js +1 -1
  746. package/dist/components/mds-avatar-stack-item.js +1 -1
  747. package/dist/components/mds-avatar-stack.js +1 -1
  748. package/dist/components/mds-avatar.js +1 -1
  749. package/dist/components/mds-badge.js +1 -1
  750. package/dist/components/mds-banner.js +1 -1
  751. package/dist/components/mds-benchmark-bar.js +1 -1
  752. package/dist/components/mds-bibliography.js +1 -1
  753. package/dist/components/mds-book.js +1 -1
  754. package/dist/components/mds-breadcrumb-item.js +1 -1
  755. package/dist/components/mds-breadcrumb.js +1 -1
  756. package/dist/components/mds-button-dropdown.js +1 -1
  757. package/dist/components/mds-button-group.js +1 -1
  758. package/dist/components/mds-button.js +1 -1
  759. package/dist/components/mds-calendar-cell.js +1 -1
  760. package/dist/components/mds-calendar.js +1 -1
  761. package/dist/components/mds-card-content.js +1 -1
  762. package/dist/components/mds-card-footer.js +1 -1
  763. package/dist/components/mds-card-header.js +1 -1
  764. package/dist/components/mds-card-media.js +1 -1
  765. package/dist/components/mds-card.js +1 -1
  766. package/dist/components/mds-chip.js +1 -1
  767. package/dist/components/mds-details.js +1 -1
  768. package/dist/components/mds-dropdown.js +1 -1
  769. package/dist/components/mds-emoji.js +5 -5
  770. package/dist/components/mds-entity.js +1 -1
  771. package/dist/components/mds-file-preview.js +1 -1
  772. package/dist/components/mds-file.js +1 -1
  773. package/dist/components/mds-filter-item.js +1 -1
  774. package/dist/components/mds-filter.js +1 -1
  775. package/dist/components/mds-header-bar.js +1 -1
  776. package/dist/components/mds-header.js +1 -1
  777. package/dist/components/mds-help.js +1 -1
  778. package/dist/components/mds-horizontal-scroll.js +1 -1
  779. package/dist/components/mds-hr.js +1 -1
  780. package/dist/components/mds-icon.js +1 -1
  781. package/dist/components/mds-img.js +1 -1
  782. package/dist/components/mds-input-date-range-preselection.js +1 -1
  783. package/dist/components/mds-input-date-range.js +1 -1
  784. package/dist/components/mds-input-date.js +1 -1
  785. package/dist/components/mds-input-field.js +1 -1
  786. package/dist/components/mds-input-otp.js +1 -1
  787. package/dist/components/mds-input-range.js +1 -1
  788. package/dist/components/mds-input-select.js +1 -1
  789. package/dist/components/mds-input-switch.js +1 -1
  790. package/dist/components/mds-input-tip-item.js +1 -1
  791. package/dist/components/mds-input-tip.js +1 -1
  792. package/dist/components/mds-input-upload.js +1 -1
  793. package/dist/components/mds-input.js +1 -1
  794. package/dist/components/mds-keyboard-key.js +1 -1
  795. package/dist/components/mds-keyboard.js +1 -1
  796. package/dist/components/mds-kpi-item.js +1 -1
  797. package/dist/components/mds-kpi.js +1 -1
  798. package/dist/components/mds-label.js +1 -1
  799. package/dist/components/mds-link.js +1 -1
  800. package/dist/components/mds-list-item.js +1 -1
  801. package/dist/components/mds-list.js +1 -1
  802. package/dist/components/mds-mention.js +1 -1
  803. package/dist/components/mds-modal.js +1 -1
  804. package/dist/components/mds-note.js +1 -1
  805. package/dist/components/mds-notification.js +1 -1
  806. package/dist/components/mds-paginator-item.js +1 -1
  807. package/dist/components/mds-paginator.js +1 -1
  808. package/dist/components/mds-policy-ai.js +1 -1
  809. package/dist/components/mds-pref-animation.js +1 -1
  810. package/dist/components/mds-pref-consumption.js +1 -1
  811. package/dist/components/mds-pref-contrast.js +1 -1
  812. package/dist/components/mds-pref-language-item.js +1 -1
  813. package/dist/components/mds-pref-language.js +1 -1
  814. package/dist/components/mds-pref-mode.js +1 -1
  815. package/dist/components/mds-pref-theme-item.js +1 -1
  816. package/dist/components/mds-pref-theme.js +1 -1
  817. package/dist/components/mds-pref.js +1 -1
  818. package/dist/components/mds-price-table-features-cell.js +1 -1
  819. package/dist/components/mds-price-table-features-row.js +1 -1
  820. package/dist/components/mds-price-table-features.js +1 -1
  821. package/dist/components/mds-price-table-header.js +1 -1
  822. package/dist/components/mds-price-table-list-item.js +1 -1
  823. package/dist/components/mds-price-table-list.js +1 -1
  824. package/dist/components/mds-price-table.js +1 -1
  825. package/dist/components/mds-progress.js +1 -1
  826. package/dist/components/mds-push-notification-item.js +1 -1
  827. package/dist/components/mds-push-notification.js +1 -1
  828. package/dist/components/mds-quote.js +1 -1
  829. package/dist/components/mds-radial-menu-item.js +1 -1
  830. package/dist/components/mds-radial-menu.js +1 -1
  831. package/dist/components/mds-radial-progress.js +1 -1
  832. package/dist/components/mds-separator.js +1 -1
  833. package/dist/components/mds-spinner.js +1 -1
  834. package/dist/components/mds-status-bar.js +1 -1
  835. package/dist/components/mds-stepper-bar-item.js +1 -1
  836. package/dist/components/mds-stepper-bar.js +1 -1
  837. package/dist/components/mds-tab-bar-item.js +1 -1
  838. package/dist/components/mds-tab-bar.js +1 -1
  839. package/dist/components/mds-tab-item.js +1 -1
  840. package/dist/components/mds-tab.js +1 -1
  841. package/dist/components/mds-table-body.js +1 -1
  842. package/dist/components/mds-table-cell.js +1 -1
  843. package/dist/components/mds-table-footer.js +1 -1
  844. package/dist/components/mds-table-header-cell.js +1 -1
  845. package/dist/components/mds-table-header.js +1 -1
  846. package/dist/components/mds-table-row.js +1 -1
  847. package/dist/components/mds-table.js +1 -1
  848. package/dist/components/mds-text.js +1 -1
  849. package/dist/components/mds-toast-region.js +1 -1
  850. package/dist/components/mds-toast.js +1 -1
  851. package/dist/components/mds-tooltip.js +1 -1
  852. package/dist/components/mds-tree-item.js +1 -1
  853. package/dist/components/mds-tree.js +1 -1
  854. package/dist/components/mds-url-view.js +1 -1
  855. package/dist/components/mds-usage.js +1 -1
  856. package/dist/components/mds-video-wall.js +1 -1
  857. package/dist/components/mds-zero.js +1 -1
  858. package/dist/components/p-3rr6yzu-.js +1 -0
  859. package/dist/components/{p-DvDB_L_5.js → p-BBZyH3mn.js} +1 -1
  860. package/dist/components/{p-C7rDjrH4.js → p-BBrPpCNK.js} +1 -1
  861. package/dist/components/p-BE05D6Pe.js +1 -0
  862. package/dist/components/{p-ikNX7XDH.js → p-BI1ShBQG.js} +1 -1
  863. package/dist/components/p-BQSO-HFx.js +1 -0
  864. package/dist/components/{p-CVRN4LDc.js → p-Bbrei_yQ.js} +1 -1
  865. package/dist/components/{p-DhpcFZrc.js → p-BpND63Kl.js} +1 -1
  866. package/dist/components/{p-DqdlT4UG.js → p-BuhoBOYR.js} +1 -1
  867. package/dist/components/p-Bw-eI2ca.js +1 -0
  868. package/dist/components/{p-DTtmr_Y9.js → p-BwwiliWt.js} +1 -1
  869. package/dist/components/{p-COkn4Vtq.js → p-C6LU1s8K.js} +1 -1
  870. package/dist/components/{p-Br6-kva-.js → p-CWOW2Vna.js} +1 -1
  871. package/dist/components/{p-B6AFku7a.js → p-CZX6N7ce.js} +1 -1
  872. package/dist/components/{p-BFDRt7-n.js → p-CZwKeFQT.js} +1 -1
  873. package/dist/components/{p-CKnbQQUb.js → p-ClvoVgmw.js} +1 -1
  874. package/dist/{magma-components/p-CLhuNxYQ.js → components/p-CpuUmvdl.js} +1 -1
  875. package/dist/components/{p-C_Pc94vn.js → p-CrOv4KdL.js} +1 -1
  876. package/dist/components/{p-CZjwSwe5.js → p-CvbuCEYD.js} +2 -2
  877. package/dist/components/{p-D8CloC8I.js → p-DN1yF-xO.js} +1 -1
  878. package/dist/components/{p-4LbHmDXv.js → p-DUgCzZw9.js} +1 -1
  879. package/dist/components/{p-DJd8f8dz.js → p-DWOg4-dH.js} +1 -1
  880. package/dist/components/{p-FsctOap9.js → p-DZ4_zLTp.js} +1 -1
  881. package/dist/components/{p-gLo3t_qO.js → p-Do7IoDLD.js} +2 -2
  882. package/dist/components/{p-BiW6luA5.js → p-DrtIqOQn.js} +1 -1
  883. package/dist/components/p-DwKxtKwS.js +1 -0
  884. package/dist/components/{p-DOdUioZq.js → p-F0qhFsF0.js} +1 -1
  885. package/dist/components/p-J48g0t65.js +1 -0
  886. package/dist/components/{p-BaynxVRZ.js → p-NNPsVjnj.js} +1 -1
  887. package/dist/components/{p-CP5Qw9_T.js → p-UfaGafRS.js} +1 -1
  888. package/dist/components/{p-DdzJfsw7.js → p-Vgo7t88R.js} +1 -1
  889. package/dist/components/{p-D_RIY063.js → p-j5Hnbfv9.js} +1 -1
  890. package/dist/components/{p-DW6ie49j.js → p-k_Ly95Tj.js} +1 -1
  891. package/dist/components/{p-DlglisEn.js → p-lXKBo6V3.js} +1 -1
  892. package/dist/components/{p-DGhzWuCS.js → p-oFHbHRLX.js} +1 -1
  893. package/dist/documentation.json +269 -83
  894. package/dist/esm/{aria-Cvhn9asj.js → aria-DwKxtKwS.js} +12 -1
  895. package/dist/esm/{floating-controller-BVlbYYkf.js → floating-controller-xixU_s1w.js} +1 -1
  896. package/dist/esm/{index-BJVvHlvf.js → index-DEL0bLpb.js} +1 -1
  897. package/dist/esm/loader.js +1 -1
  898. package/dist/esm/{locale-B6cOkl4I.js → locale-DhP1Ge2o.js} +1 -1
  899. package/dist/esm/magma-components.js +1 -1
  900. package/dist/esm/mds-accordion-item.entry.js +1 -1
  901. package/dist/esm/mds-accordion-timer-item.entry.js +1 -1
  902. package/dist/esm/mds-accordion.entry.js +1 -1
  903. package/dist/esm/mds-avatar.entry.js +1 -1
  904. package/dist/esm/mds-badge.entry.js +2 -2
  905. package/dist/esm/mds-banner_3.entry.js +5 -5
  906. package/dist/esm/mds-book.entry.js +2 -2
  907. package/dist/esm/mds-breadcrumb.entry.js +2 -2
  908. package/dist/esm/mds-button-dropdown.entry.js +6 -4
  909. package/dist/esm/mds-button-group.entry.js +1 -1
  910. package/dist/esm/mds-button_3.entry.js +78 -16
  911. package/dist/esm/mds-calendar_2.entry.js +8 -8
  912. package/dist/esm/mds-card-content.entry.js +1 -1
  913. package/dist/esm/mds-card-footer.entry.js +1 -1
  914. package/dist/esm/mds-card-header.entry.js +1 -1
  915. package/dist/esm/mds-card-media.entry.js +1 -1
  916. package/dist/esm/mds-card.entry.js +2 -2
  917. package/dist/esm/mds-details.entry.js +2 -2
  918. package/dist/esm/mds-dropdown.entry.js +6 -6
  919. package/dist/esm/mds-emoji.entry.js +41 -12
  920. package/dist/esm/mds-entity.entry.js +2 -2
  921. package/dist/esm/mds-file-preview.entry.js +5 -5
  922. package/dist/esm/mds-file.entry.js +5 -5
  923. package/dist/esm/mds-filter-item.entry.js +5 -5
  924. package/dist/esm/mds-filter.entry.js +4 -4
  925. package/dist/esm/mds-header-bar.entry.js +3 -3
  926. package/dist/esm/mds-header.entry.js +3 -3
  927. package/dist/esm/mds-horizontal-scroll.entry.js +3 -3
  928. package/dist/esm/mds-hr.entry.js +2 -2
  929. package/dist/esm/mds-img.entry.js +2 -2
  930. package/dist/esm/mds-input-date-range-preselection.entry.js +1 -1
  931. package/dist/esm/mds-input-date-range.entry.js +4 -4
  932. package/dist/esm/mds-input-date.entry.js +6 -6
  933. package/dist/esm/mds-input-field.entry.js +1 -1
  934. package/dist/esm/mds-input-otp.entry.js +3 -3
  935. package/dist/esm/mds-input-range.entry.js +3 -3
  936. package/dist/esm/mds-input-select.entry.js +6 -6
  937. package/dist/esm/mds-input-switch_2.entry.js +6 -6
  938. package/dist/esm/mds-input-tip_2.entry.js +5 -5
  939. package/dist/esm/mds-input-upload.entry.js +7 -7
  940. package/dist/esm/mds-input.entry.js +8 -8
  941. package/dist/esm/mds-keyboard-key.entry.js +3 -3
  942. package/dist/esm/mds-keyboard.entry.js +4 -4
  943. package/dist/esm/mds-kpi-item.entry.js +3 -3
  944. package/dist/esm/mds-kpi.entry.js +1 -1
  945. package/dist/esm/mds-label.entry.js +3 -3
  946. package/dist/esm/mds-link.entry.js +5 -5
  947. package/dist/esm/mds-list-item.entry.js +1 -1
  948. package/dist/esm/mds-list.entry.js +1 -1
  949. package/dist/esm/mds-mention.entry.js +3 -3
  950. package/dist/esm/mds-modal.entry.js +34 -15
  951. package/dist/esm/mds-note.entry.js +4 -4
  952. package/dist/esm/mds-notification.entry.js +3 -3
  953. package/dist/esm/mds-paginator-item.entry.js +2 -2
  954. package/dist/esm/mds-paginator.entry.js +4 -4
  955. package/dist/esm/mds-policy-ai.entry.js +3 -3
  956. package/dist/esm/mds-pref-animation.entry.js +3 -3
  957. package/dist/esm/mds-pref-consumption.entry.js +3 -3
  958. package/dist/esm/mds-pref-contrast.entry.js +3 -3
  959. package/dist/esm/mds-pref-language-item.entry.js +3 -3
  960. package/dist/esm/mds-pref-language.entry.js +3 -3
  961. package/dist/esm/mds-pref-mode.entry.js +22 -13
  962. package/dist/esm/mds-pref-theme-item.entry.js +18 -4
  963. package/dist/esm/mds-pref-theme.entry.js +42 -10
  964. package/dist/esm/mds-pref.entry.js +3 -25
  965. package/dist/esm/mds-price-table-features-cell.entry.js +3 -3
  966. package/dist/esm/mds-price-table-features-row.entry.js +3 -3
  967. package/dist/esm/mds-price-table-features.entry.js +2 -2
  968. package/dist/esm/mds-price-table-header.entry.js +1 -1
  969. package/dist/esm/mds-price-table-list-item.entry.js +1 -1
  970. package/dist/esm/mds-price-table-list.entry.js +3 -3
  971. package/dist/esm/mds-price-table.entry.js +1 -1
  972. package/dist/esm/mds-progress_2.entry.js +4 -4
  973. package/dist/esm/mds-push-notification-item.entry.js +4 -4
  974. package/dist/esm/mds-push-notification.entry.js +4 -4
  975. package/dist/esm/mds-quote.entry.js +2 -2
  976. package/dist/esm/mds-radial-menu-item.entry.js +1 -1
  977. package/dist/esm/mds-radial-menu.entry.js +5 -5
  978. package/dist/esm/mds-separator.entry.js +2 -2
  979. package/dist/esm/mds-status-bar.entry.js +3 -3
  980. package/dist/esm/mds-stepper-bar-item.entry.js +3 -3
  981. package/dist/esm/mds-stepper-bar.entry.js +1 -1
  982. package/dist/esm/mds-tab-bar-item.entry.js +4 -4
  983. package/dist/esm/mds-tab-bar.entry.js +3 -3
  984. package/dist/esm/mds-tab_2.entry.js +6 -6
  985. package/dist/esm/mds-table-body.entry.js +2 -2
  986. package/dist/esm/mds-table-footer.entry.js +2 -2
  987. package/dist/esm/mds-table-header-cell.entry.js +2 -2
  988. package/dist/esm/mds-table-header.entry.js +3 -3
  989. package/dist/esm/mds-table-row.entry.js +4 -4
  990. package/dist/esm/mds-table.entry.js +4 -4
  991. package/dist/esm/mds-text.entry.js +2 -2
  992. package/dist/esm/mds-toast-region.entry.js +1 -1
  993. package/dist/esm/mds-toast.entry.js +3 -3
  994. package/dist/esm/mds-tooltip.entry.js +5 -5
  995. package/dist/esm/mds-tree-item.entry.js +3 -3
  996. package/dist/esm/mds-tree.entry.js +1 -1
  997. package/dist/esm/mds-url-view.entry.js +4 -4
  998. package/dist/esm/mds-usage.entry.js +4 -4
  999. package/dist/esm/mds-video-wall.entry.js +2 -2
  1000. package/dist/esm/mds-zero.entry.js +3 -3
  1001. package/dist/esm/{preference-C5XjgGCb.js → preference-C8foBO86.js} +19 -1
  1002. package/dist/esm-es5/aria-DwKxtKwS.js +12 -0
  1003. package/dist/esm-es5/{floating-controller-BVlbYYkf.js → floating-controller-xixU_s1w.js} +1 -1
  1004. package/dist/esm-es5/{index-BJVvHlvf.js → index-DEL0bLpb.js} +1 -1
  1005. package/dist/esm-es5/loader.js +1 -1
  1006. package/dist/esm-es5/{locale-B6cOkl4I.js → locale-DhP1Ge2o.js} +18 -18
  1007. package/dist/esm-es5/magma-components.js +1 -1
  1008. package/dist/esm-es5/mds-accordion-item.entry.js +1 -1
  1009. package/dist/esm-es5/mds-accordion-timer-item.entry.js +1 -1
  1010. package/dist/esm-es5/mds-accordion.entry.js +1 -1
  1011. package/dist/esm-es5/mds-avatar.entry.js +2 -2
  1012. package/dist/esm-es5/mds-badge.entry.js +1 -1
  1013. package/dist/esm-es5/mds-banner_3.entry.js +4 -4
  1014. package/dist/esm-es5/mds-book.entry.js +1 -1
  1015. package/dist/esm-es5/mds-breadcrumb.entry.js +1 -1
  1016. package/dist/esm-es5/mds-button-dropdown.entry.js +6 -4
  1017. package/dist/esm-es5/mds-button-group.entry.js +1 -1
  1018. package/dist/esm-es5/mds-button_3.entry.js +39 -17
  1019. package/dist/esm-es5/mds-calendar_2.entry.js +4 -4
  1020. package/dist/esm-es5/mds-card-content.entry.js +1 -1
  1021. package/dist/esm-es5/mds-card-footer.entry.js +1 -1
  1022. package/dist/esm-es5/mds-card-header.entry.js +1 -1
  1023. package/dist/esm-es5/mds-card-media.entry.js +1 -1
  1024. package/dist/esm-es5/mds-card.entry.js +2 -2
  1025. package/dist/esm-es5/mds-details.entry.js +2 -2
  1026. package/dist/esm-es5/mds-dropdown.entry.js +13 -13
  1027. package/dist/esm-es5/mds-emoji.entry.js +111 -109
  1028. package/dist/esm-es5/mds-entity.entry.js +1 -1
  1029. package/dist/esm-es5/mds-file-preview.entry.js +7 -7
  1030. package/dist/esm-es5/mds-file.entry.js +3 -3
  1031. package/dist/esm-es5/mds-filter-item.entry.js +2 -2
  1032. package/dist/esm-es5/mds-filter.entry.js +2 -2
  1033. package/dist/esm-es5/mds-header-bar.entry.js +2 -2
  1034. package/dist/esm-es5/mds-header.entry.js +2 -2
  1035. package/dist/esm-es5/mds-horizontal-scroll.entry.js +2 -2
  1036. package/dist/esm-es5/mds-hr.entry.js +1 -1
  1037. package/dist/esm-es5/mds-img.entry.js +1 -1
  1038. package/dist/esm-es5/mds-input-date-range-preselection.entry.js +3 -3
  1039. package/dist/esm-es5/mds-input-date-range.entry.js +1 -1
  1040. package/dist/esm-es5/mds-input-date.entry.js +3 -3
  1041. package/dist/esm-es5/mds-input-field.entry.js +1 -1
  1042. package/dist/esm-es5/mds-input-otp.entry.js +2 -2
  1043. package/dist/esm-es5/mds-input-range.entry.js +2 -2
  1044. package/dist/esm-es5/mds-input-select.entry.js +10 -10
  1045. package/dist/esm-es5/mds-input-switch_2.entry.js +2 -2
  1046. package/dist/esm-es5/mds-input-tip_2.entry.js +3 -3
  1047. package/dist/esm-es5/mds-input-upload.entry.js +2 -2
  1048. package/dist/esm-es5/mds-input.entry.js +3 -3
  1049. package/dist/esm-es5/mds-keyboard-key.entry.js +2 -2
  1050. package/dist/esm-es5/mds-keyboard.entry.js +2 -2
  1051. package/dist/esm-es5/mds-kpi-item.entry.js +3 -3
  1052. package/dist/esm-es5/mds-kpi.entry.js +1 -1
  1053. package/dist/esm-es5/mds-label.entry.js +1 -1
  1054. package/dist/esm-es5/mds-link.entry.js +2 -2
  1055. package/dist/esm-es5/mds-list-item.entry.js +1 -1
  1056. package/dist/esm-es5/mds-list.entry.js +1 -1
  1057. package/dist/esm-es5/mds-mention.entry.js +2 -2
  1058. package/dist/esm-es5/mds-modal.entry.js +23 -11
  1059. package/dist/esm-es5/mds-note.entry.js +2 -2
  1060. package/dist/esm-es5/mds-notification.entry.js +2 -2
  1061. package/dist/esm-es5/mds-paginator-item.entry.js +2 -2
  1062. package/dist/esm-es5/mds-paginator.entry.js +3 -3
  1063. package/dist/esm-es5/mds-policy-ai.entry.js +2 -2
  1064. package/dist/esm-es5/mds-pref-animation.entry.js +2 -2
  1065. package/dist/esm-es5/mds-pref-consumption.entry.js +2 -2
  1066. package/dist/esm-es5/mds-pref-contrast.entry.js +3 -3
  1067. package/dist/esm-es5/mds-pref-language-item.entry.js +2 -2
  1068. package/dist/esm-es5/mds-pref-language.entry.js +2 -2
  1069. package/dist/esm-es5/mds-pref-mode.entry.js +13 -3
  1070. package/dist/esm-es5/mds-pref-theme-item.entry.js +12 -5
  1071. package/dist/esm-es5/mds-pref-theme.entry.js +26 -8
  1072. package/dist/esm-es5/mds-pref.entry.js +4 -12
  1073. package/dist/esm-es5/mds-price-table-features-cell.entry.js +2 -2
  1074. package/dist/esm-es5/mds-price-table-features-row.entry.js +1 -1
  1075. package/dist/esm-es5/mds-price-table-features.entry.js +1 -1
  1076. package/dist/esm-es5/mds-price-table-header.entry.js +1 -1
  1077. package/dist/esm-es5/mds-price-table-list-item.entry.js +1 -1
  1078. package/dist/esm-es5/mds-price-table-list.entry.js +2 -2
  1079. package/dist/esm-es5/mds-price-table.entry.js +1 -1
  1080. package/dist/esm-es5/mds-progress_2.entry.js +3 -3
  1081. package/dist/esm-es5/mds-push-notification-item.entry.js +2 -2
  1082. package/dist/esm-es5/mds-push-notification.entry.js +6 -6
  1083. package/dist/esm-es5/mds-quote.entry.js +2 -2
  1084. package/dist/esm-es5/mds-radial-menu-item.entry.js +1 -1
  1085. package/dist/esm-es5/mds-radial-menu.entry.js +4 -4
  1086. package/dist/esm-es5/mds-separator.entry.js +1 -1
  1087. package/dist/esm-es5/mds-status-bar.entry.js +3 -3
  1088. package/dist/esm-es5/mds-stepper-bar-item.entry.js +2 -2
  1089. package/dist/esm-es5/mds-stepper-bar.entry.js +1 -1
  1090. package/dist/esm-es5/mds-tab-bar-item.entry.js +2 -2
  1091. package/dist/esm-es5/mds-tab-bar.entry.js +2 -2
  1092. package/dist/esm-es5/mds-tab_2.entry.js +3 -3
  1093. package/dist/esm-es5/mds-table-body.entry.js +1 -1
  1094. package/dist/esm-es5/mds-table-footer.entry.js +2 -2
  1095. package/dist/esm-es5/mds-table-header-cell.entry.js +2 -2
  1096. package/dist/esm-es5/mds-table-header.entry.js +2 -2
  1097. package/dist/esm-es5/mds-table-row.entry.js +2 -2
  1098. package/dist/esm-es5/mds-table.entry.js +2 -2
  1099. package/dist/esm-es5/mds-text.entry.js +2 -2
  1100. package/dist/esm-es5/mds-toast-region.entry.js +1 -1
  1101. package/dist/esm-es5/mds-toast.entry.js +2 -2
  1102. package/dist/esm-es5/mds-tooltip.entry.js +2 -2
  1103. package/dist/esm-es5/mds-tree-item.entry.js +2 -2
  1104. package/dist/esm-es5/mds-tree.entry.js +1 -1
  1105. package/dist/esm-es5/mds-url-view.entry.js +2 -2
  1106. package/dist/esm-es5/mds-usage.entry.js +3 -3
  1107. package/dist/esm-es5/mds-video-wall.entry.js +2 -2
  1108. package/dist/esm-es5/mds-zero.entry.js +1 -1
  1109. package/dist/esm-es5/{preference-C5XjgGCb.js → preference-C8foBO86.js} +14 -4
  1110. package/dist/hydrate/index.js +410 -231
  1111. package/dist/hydrate/index.mjs +410 -231
  1112. package/dist/lint/core/patterns.d.ts +56 -16
  1113. package/dist/lint/core/patterns.js +145 -38
  1114. package/dist/lint/mcp/tools.json +8 -8
  1115. package/dist/magma-components/magma-components.esm.js +1 -1
  1116. package/dist/magma-components/{p-0384db44.system.entry.js → p-00d2ef14.system.entry.js} +5 -5
  1117. package/dist/magma-components/{p-ff65fc97.entry.js → p-02aed12a.entry.js} +1 -1
  1118. package/dist/magma-components/{p-7c055074.entry.js → p-08f7a84b.entry.js} +1 -1
  1119. package/dist/magma-components/{p-8239e526.system.entry.js → p-09a7c1de.system.entry.js} +1 -1
  1120. package/dist/magma-components/{p-18244fd7.system.entry.js → p-0da5c696.system.entry.js} +3 -3
  1121. package/dist/magma-components/{p-5575f198.entry.js → p-0df067b4.entry.js} +1 -1
  1122. package/dist/magma-components/{p-b6412ddd.system.entry.js → p-0e1d239b.system.entry.js} +1 -1
  1123. package/dist/magma-components/{p-ac161cb5.entry.js → p-0f4c2de6.entry.js} +1 -1
  1124. package/dist/magma-components/{p-0c8f22dc.system.entry.js → p-11456781.system.entry.js} +2 -2
  1125. package/dist/magma-components/{p-a2e3a545.entry.js → p-14de26d5.entry.js} +1 -1
  1126. package/dist/magma-components/p-163eccbd.entry.js +1 -0
  1127. package/dist/magma-components/{p-844bce77.entry.js → p-167ba07a.entry.js} +1 -1
  1128. package/dist/magma-components/{p-f4fc9f29.system.entry.js → p-16bbff4e.system.entry.js} +1 -1
  1129. package/dist/magma-components/{p-e059aaa9.entry.js → p-17249b74.entry.js} +1 -1
  1130. package/dist/magma-components/{p-95ddc950.system.entry.js → p-188a55ac.system.entry.js} +3 -3
  1131. package/dist/magma-components/{p-c9bd81c5.system.entry.js → p-1a53d9d0.system.entry.js} +7 -7
  1132. package/dist/magma-components/{p-27254fbd.entry.js → p-1cc379d6.entry.js} +1 -1
  1133. package/dist/magma-components/{p-ae9735e4.system.entry.js → p-1dc0d59c.system.entry.js} +2 -2
  1134. package/dist/magma-components/{p-384d93dc.system.entry.js → p-1e24aafa.system.entry.js} +1 -1
  1135. package/dist/magma-components/p-223efc32.entry.js +1 -0
  1136. package/dist/magma-components/{p-1467ded5.system.entry.js → p-2454e4cd.system.entry.js} +2 -2
  1137. package/dist/magma-components/{p-18b27217.entry.js → p-24a69c45.entry.js} +1 -1
  1138. package/dist/magma-components/{p-fae9612b.system.entry.js → p-24fb2c5c.system.entry.js} +2 -2
  1139. package/dist/magma-components/{p-ef1bdd44.entry.js → p-259d9380.entry.js} +1 -1
  1140. package/dist/magma-components/{p-4fc0e294.entry.js → p-26b08e33.entry.js} +1 -1
  1141. package/dist/magma-components/{p-c35ea44d.system.entry.js → p-27a32865.system.entry.js} +2 -2
  1142. package/dist/magma-components/{p-299dab17.entry.js → p-2940499f.entry.js} +1 -1
  1143. package/dist/magma-components/{p-6129954d.system.entry.js → p-2a5167e3.system.entry.js} +1 -1
  1144. package/dist/magma-components/{p-ad13ade5.system.entry.js → p-2e825656.system.entry.js} +3 -3
  1145. package/dist/magma-components/{p-308a4ae5.system.entry.js → p-2f4a7253.system.entry.js} +1 -1
  1146. package/dist/magma-components/{p-29dd6d94.entry.js → p-2ffa4d4a.entry.js} +1 -1
  1147. package/dist/magma-components/{p-d360e4c5.entry.js → p-32b3ad6f.entry.js} +1 -1
  1148. package/dist/magma-components/{p-5686da49.system.entry.js → p-33129e0c.system.entry.js} +3 -3
  1149. package/dist/magma-components/{p-9c2b67fc.system.entry.js → p-372fa5d4.system.entry.js} +3 -3
  1150. package/dist/magma-components/p-380adee8.system.entry.js +5 -0
  1151. package/dist/magma-components/{p-b0749f83.system.entry.js → p-390d0672.system.entry.js} +3 -3
  1152. package/dist/magma-components/p-397c0686.entry.js +1 -0
  1153. package/dist/magma-components/{p-e0049e96.system.entry.js → p-3a836de8.system.entry.js} +1 -1
  1154. package/dist/magma-components/{p-fff26731.system.entry.js → p-3ba14295.system.entry.js} +2 -2
  1155. package/dist/magma-components/{p-741f8f45.system.entry.js → p-3bf4f012.system.entry.js} +2 -2
  1156. package/dist/magma-components/{p-5d56a7cd.system.entry.js → p-3c911608.system.entry.js} +3 -3
  1157. package/dist/magma-components/{p-aac622ef.system.entry.js → p-3cf8ed46.system.entry.js} +1 -1
  1158. package/dist/magma-components/{p-61e11cd0.system.entry.js → p-3ddae677.system.entry.js} +3 -3
  1159. package/dist/magma-components/{p-2d2cdf0d.entry.js → p-3de37b32.entry.js} +1 -1
  1160. package/dist/magma-components/{p-90d50492.system.entry.js → p-3f17a06f.system.entry.js} +2 -2
  1161. package/dist/magma-components/{p-4f0153cd.entry.js → p-40c59c18.entry.js} +1 -1
  1162. package/dist/magma-components/p-411fca2f.system.entry.js +14 -0
  1163. package/dist/magma-components/{p-7f418ae1.entry.js → p-43c307f5.entry.js} +1 -1
  1164. package/dist/magma-components/{p-14122f2d.entry.js → p-440d7942.entry.js} +1 -1
  1165. package/dist/magma-components/{p-6a994dc1.entry.js → p-4541c233.entry.js} +1 -1
  1166. package/dist/magma-components/p-45c26a24.system.entry.js +21 -0
  1167. package/dist/magma-components/{p-948ecde4.entry.js → p-4612bc78.entry.js} +2 -2
  1168. package/dist/magma-components/{p-be2ca282.entry.js → p-4718a71d.entry.js} +1 -1
  1169. package/dist/magma-components/{p-8a8cad6c.system.entry.js → p-48a1871f.system.entry.js} +1 -1
  1170. package/dist/magma-components/{p-7ee31f2e.entry.js → p-4a1f7eb5.entry.js} +1 -1
  1171. package/dist/magma-components/{p-adab176e.system.entry.js → p-4a2ed30e.system.entry.js} +2 -2
  1172. package/dist/magma-components/{p-efe27253.system.entry.js → p-4a9ed4f7.system.entry.js} +1 -1
  1173. package/dist/magma-components/{p-2d199db0.system.entry.js → p-4c3b3913.system.entry.js} +2 -2
  1174. package/dist/magma-components/p-4c955367.entry.js +1 -0
  1175. package/dist/magma-components/p-4ebb0a9e.entry.js +1 -0
  1176. package/dist/magma-components/{p-02b106c2.entry.js → p-4f80bf37.entry.js} +1 -1
  1177. package/dist/magma-components/{p-a65ce11a.system.entry.js → p-527569a3.system.entry.js} +2 -2
  1178. package/dist/magma-components/{p-0d42ac4a.entry.js → p-52cc5a93.entry.js} +1 -1
  1179. package/dist/magma-components/{p-3139988c.system.entry.js → p-54abba52.system.entry.js} +1 -1
  1180. package/dist/magma-components/{p-4fd0fdb8.system.entry.js → p-555ba0e0.system.entry.js} +2 -2
  1181. package/dist/magma-components/{p-5c8f408e.entry.js → p-56cf1cab.entry.js} +1 -1
  1182. package/dist/magma-components/{p-bba4f1f0.system.entry.js → p-5794053b.system.entry.js} +10 -10
  1183. package/dist/magma-components/{p-57ee6e32.entry.js → p-5a754d7b.entry.js} +1 -1
  1184. package/dist/magma-components/{p-f09f3fe1.system.entry.js → p-5c6fdabd.system.entry.js} +3 -3
  1185. package/dist/magma-components/{p-c683cd13.entry.js → p-5ca6063a.entry.js} +1 -1
  1186. package/dist/magma-components/{p-ac099ed6.entry.js → p-5cb581df.entry.js} +1 -1
  1187. package/dist/magma-components/{p-445198a1.entry.js → p-5d825728.entry.js} +1 -1
  1188. package/dist/magma-components/{p-60b21db7.entry.js → p-5dfca9f0.entry.js} +1 -1
  1189. package/dist/magma-components/{p-f181c679.system.entry.js → p-5f20592f.system.entry.js} +1 -1
  1190. package/dist/magma-components/p-5f38e95b.entry.js +1 -0
  1191. package/dist/magma-components/p-5f4bec31.entry.js +1 -0
  1192. package/dist/magma-components/p-627f5956.entry.js +1 -0
  1193. package/dist/magma-components/{p-a9caed77.entry.js → p-6336d979.entry.js} +1 -1
  1194. package/dist/magma-components/{p-7837856f.entry.js → p-6352c2ea.entry.js} +1 -1
  1195. package/dist/magma-components/{p-10d52280.entry.js → p-64884d84.entry.js} +1 -1
  1196. package/dist/magma-components/{p-98e167e8.system.entry.js → p-64f86e46.system.entry.js} +2 -2
  1197. package/dist/magma-components/{p-9a0f8eb1.entry.js → p-65ea6fc9.entry.js} +1 -1
  1198. package/dist/magma-components/{p-cf42d6ea.system.entry.js → p-66f7f9b1.system.entry.js} +3 -3
  1199. package/dist/magma-components/{p-13cfc01a.entry.js → p-68b0d45a.entry.js} +1 -1
  1200. package/dist/magma-components/{p-b61546fd.entry.js → p-6a4d44e2.entry.js} +1 -1
  1201. package/dist/magma-components/p-6a90caf5.system.entry.js +1 -0
  1202. package/dist/magma-components/{p-dfab370b.entry.js → p-6c4f2de0.entry.js} +1 -1
  1203. package/dist/magma-components/{p-12be0f43.system.entry.js → p-6f90c2c9.system.entry.js} +2 -2
  1204. package/dist/magma-components/p-70faf379.entry.js +1 -0
  1205. package/dist/magma-components/{p-e7f717ab.entry.js → p-71d03e56.entry.js} +1 -1
  1206. package/dist/magma-components/{p-b30b487c.system.entry.js → p-720e9291.system.entry.js} +3 -3
  1207. package/dist/magma-components/{p-bc054ffa.system.entry.js → p-724b7fff.system.entry.js} +2 -2
  1208. package/dist/magma-components/{p-6896786e.entry.js → p-73dc7c66.entry.js} +1 -1
  1209. package/dist/magma-components/{p-34421ef2.system.entry.js → p-7476cf76.system.entry.js} +3 -3
  1210. package/dist/magma-components/{p-0fc41e34.system.entry.js → p-7701a318.system.entry.js} +1 -1
  1211. package/dist/magma-components/{p-85bf9c93.entry.js → p-77707706.entry.js} +1 -1
  1212. package/dist/magma-components/{p-c9553777.entry.js → p-78d00f88.entry.js} +1 -1
  1213. package/dist/magma-components/{p-4f48c171.system.entry.js → p-79085c46.system.entry.js} +1 -1
  1214. package/dist/magma-components/{p-ccffdf0b.system.entry.js → p-793072e1.system.entry.js} +23 -11
  1215. package/dist/magma-components/{p-b2763352.entry.js → p-79392a0a.entry.js} +1 -1
  1216. package/dist/magma-components/{p-7ff5552f.entry.js → p-7a33ab3c.entry.js} +1 -1
  1217. package/dist/magma-components/{p-625de2e6.system.entry.js → p-7a4e8bc0.system.entry.js} +4 -4
  1218. package/dist/magma-components/p-7a73fd19.system.entry.js +127 -0
  1219. package/dist/magma-components/p-7b552dbe.entry.js +1 -0
  1220. package/dist/magma-components/{p-84aac233.entry.js → p-7c13ccb0.entry.js} +1 -1
  1221. package/dist/magma-components/{p-d81fcbde.system.entry.js → p-7e0a8194.system.entry.js} +5 -5
  1222. package/dist/magma-components/{p-45b19935.system.entry.js → p-7fbdf896.system.entry.js} +3 -3
  1223. package/dist/magma-components/{p-35c170ba.system.entry.js → p-804f4794.system.entry.js} +2 -2
  1224. package/dist/magma-components/{p-6c73689a.system.entry.js → p-840c19ee.system.entry.js} +4 -4
  1225. package/dist/magma-components/p-848d1b42.system.entry.js +30 -0
  1226. package/dist/magma-components/{p-81212e34.entry.js → p-86494ea9.entry.js} +1 -1
  1227. package/dist/magma-components/p-8915347f.entry.js +1 -0
  1228. package/dist/magma-components/{p-f493fdc3.entry.js → p-8c20ac0c.entry.js} +1 -1
  1229. package/dist/magma-components/{p-f22b8091.entry.js → p-90c60c48.entry.js} +1 -1
  1230. package/dist/magma-components/{p-60d6e60f.entry.js → p-90e20ad3.entry.js} +1 -1
  1231. package/dist/magma-components/{p-797c64f4.system.entry.js → p-9228db0b.system.entry.js} +13 -3
  1232. package/dist/magma-components/p-94548d43.entry.js +1 -0
  1233. package/dist/magma-components/{p-9c784173.entry.js → p-95020326.entry.js} +1 -1
  1234. package/dist/magma-components/{p-8feba226.entry.js → p-970f45df.entry.js} +1 -1
  1235. package/dist/magma-components/{p-9303fb16.system.entry.js → p-97a501cd.system.entry.js} +2 -2
  1236. package/dist/magma-components/{p-4e072e24.system.entry.js → p-98cc6473.system.entry.js} +30 -12
  1237. package/dist/magma-components/p-99d2ace2.system.entry.js +5 -0
  1238. package/dist/magma-components/{p-627c2780.entry.js → p-9aba3769.entry.js} +1 -1
  1239. package/dist/magma-components/{p-6d009b42.system.entry.js → p-9b0b65f0.system.entry.js} +2 -2
  1240. package/dist/magma-components/{p-f40e3918.system.entry.js → p-9b0d7f7d.system.entry.js} +2 -2
  1241. package/dist/magma-components/{p-5d1cba9c.system.entry.js → p-9b8d15a8.system.entry.js} +1 -1
  1242. package/dist/magma-components/{p-5931fdfc.system.entry.js → p-9e94f4a3.system.entry.js} +4 -4
  1243. package/dist/magma-components/{p-3b578659.system.entry.js → p-9f0100f2.system.entry.js} +2 -2
  1244. package/dist/magma-components/p-B8zYiZQY.system.js +1 -1
  1245. package/dist/magma-components/{p-CuHZXISO.system.js → p-BHdlb7Fr.system.js} +19 -19
  1246. package/dist/magma-components/p-BXVzhErg.system.js +12 -0
  1247. package/dist/magma-components/{p-OafT80hV.js → p-CATyfc78.js} +2 -2
  1248. package/dist/magma-components/{p-CZuIEo2v.system.js → p-Cbabyppz.system.js} +1 -1
  1249. package/dist/magma-components/{p-Dx_cCOTw.js → p-CxzVgcYv.js} +1 -1
  1250. package/dist/magma-components/{p-CxTugGM9.system.js → p-D3J9KZKy.system.js} +1 -1
  1251. package/dist/magma-components/{p-mGgjNqBm.system.js → p-DOisMne4.system.js} +17 -7
  1252. package/dist/magma-components/p-DwKxtKwS.js +1 -0
  1253. package/dist/{components/p-jasGzfhE.js → magma-components/p-Dx7iOdVP.js} +1 -1
  1254. package/dist/magma-components/{p-iX3kcwYg.js → p-DxR4rGsw.js} +1 -1
  1255. package/dist/magma-components/{p-ecc2893d.system.entry.js → p-a112a0e2.system.entry.js} +1 -1
  1256. package/dist/magma-components/{p-86f11a5a.entry.js → p-a2767235.entry.js} +1 -1
  1257. package/dist/magma-components/{p-c0286dc3.system.entry.js → p-a2c3b294.system.entry.js} +6 -6
  1258. package/dist/magma-components/{p-4669334a.system.entry.js → p-a2d4d849.system.entry.js} +2 -2
  1259. package/dist/magma-components/{p-cfbf3a76.system.entry.js → p-a48c73b1.system.entry.js} +2 -2
  1260. package/dist/magma-components/{p-4e8c5b68.entry.js → p-a4f53c83.entry.js} +1 -1
  1261. package/dist/magma-components/{p-e92327a2.entry.js → p-a58e8a5c.entry.js} +1 -1
  1262. package/dist/magma-components/{p-1a20f239.system.entry.js → p-a5ca10ae.system.entry.js} +1 -1
  1263. package/dist/magma-components/{p-46a928c3.entry.js → p-a9a872e1.entry.js} +1 -1
  1264. package/dist/magma-components/{p-0a0dfdf4.system.entry.js → p-a9ab9eb0.system.entry.js} +2 -2
  1265. package/dist/magma-components/{p-72971cf7.system.entry.js → p-ab1c3fb0.system.entry.js} +1 -1
  1266. package/dist/magma-components/{p-074d7b75.entry.js → p-ab445c2b.entry.js} +1 -1
  1267. package/dist/magma-components/{p-45a3e7eb.entry.js → p-abe32d5b.entry.js} +1 -1
  1268. package/dist/magma-components/{p-2e68180d.system.entry.js → p-af56e3e4.system.entry.js} +2 -2
  1269. package/dist/magma-components/{p-ed4fd7a4.entry.js → p-b1238d48.entry.js} +1 -1
  1270. package/dist/magma-components/{p-4748378e.system.entry.js → p-b129b127.system.entry.js} +14 -14
  1271. package/dist/magma-components/{p-e79eb427.system.entry.js → p-b1cd3acf.system.entry.js} +2 -2
  1272. package/dist/magma-components/{p-5aa8f150.entry.js → p-b705b805.entry.js} +1 -1
  1273. package/dist/magma-components/{p-2111aa67.system.entry.js → p-b7d18d7a.system.entry.js} +1 -1
  1274. package/dist/magma-components/{p-3be9b384.system.entry.js → p-b871ad36.system.entry.js} +10 -10
  1275. package/dist/magma-components/{p-f7426a75.entry.js → p-ba871d9c.entry.js} +1 -1
  1276. package/dist/magma-components/{p-5a8fa2d0.entry.js → p-ba95bf93.entry.js} +1 -1
  1277. package/dist/magma-components/{p-3af8a86a.system.entry.js → p-bc054fa3.system.entry.js} +3 -3
  1278. package/dist/magma-components/{p-05455645.system.entry.js → p-bcc6c358.system.entry.js} +2 -2
  1279. package/dist/magma-components/{p-7c3a7521.entry.js → p-bd489df9.entry.js} +1 -1
  1280. package/dist/magma-components/{p-60acbc5f.system.entry.js → p-c0295a0e.system.entry.js} +2 -2
  1281. package/dist/magma-components/p-c06d8b5a.entry.js +1 -0
  1282. package/dist/magma-components/p-c131d726.entry.js +1 -0
  1283. package/dist/magma-components/{p-198ea5d8.entry.js → p-c49676e6.entry.js} +1 -1
  1284. package/dist/magma-components/{p-0dcde20a.system.entry.js → p-c4c1ef48.system.entry.js} +91 -89
  1285. package/dist/magma-components/{p-87831da2.system.entry.js → p-c54f2089.system.entry.js} +1 -1
  1286. package/dist/magma-components/{p-8b8cd213.system.entry.js → p-c691f27e.system.entry.js} +3 -3
  1287. package/dist/magma-components/p-c8414ee6.entry.js +1 -0
  1288. package/dist/magma-components/{p-77001a72.entry.js → p-c8c918d2.entry.js} +5 -5
  1289. package/dist/magma-components/{p-85376ff5.entry.js → p-c91cb63a.entry.js} +1 -1
  1290. package/dist/magma-components/{p-9f55fa7a.system.entry.js → p-c94e7973.system.entry.js} +2 -2
  1291. package/dist/magma-components/{p-387fa36d.system.entry.js → p-c9baa3fb.system.entry.js} +1 -1
  1292. package/dist/magma-components/{p-b781c932.system.entry.js → p-ca4e8601.system.entry.js} +1 -1
  1293. package/dist/magma-components/{p-445bc62a.system.entry.js → p-ca5427d4.system.entry.js} +1 -1
  1294. package/dist/magma-components/{p-4646cdc0.system.entry.js → p-caca78ff.system.entry.js} +2 -2
  1295. package/dist/magma-components/{p-d85f3e5e.system.entry.js → p-caf478ff.system.entry.js} +2 -2
  1296. package/dist/magma-components/{p-b8f4938a.entry.js → p-cb06839f.entry.js} +1 -1
  1297. package/dist/magma-components/{p-d29c959d.entry.js → p-ce42734f.entry.js} +1 -1
  1298. package/dist/magma-components/{p-8aa4cd10.entry.js → p-d1e4a032.entry.js} +1 -1
  1299. package/dist/magma-components/p-d25a47fa.entry.js +1 -0
  1300. package/dist/magma-components/{p-0d3da482.system.entry.js → p-d29b32b4.system.entry.js} +1 -1
  1301. package/dist/magma-components/{p-1f746ad1.system.entry.js → p-d2ba5851.system.entry.js} +9 -9
  1302. package/dist/magma-components/{p-d50d4023.entry.js → p-d365c6b6.entry.js} +1 -1
  1303. package/dist/magma-components/{p-7a920b70.entry.js → p-d3b06151.entry.js} +1 -1
  1304. package/dist/magma-components/{p-4cd21f19.entry.js → p-d45f65e0.entry.js} +1 -1
  1305. package/dist/magma-components/{p-fdedc0ba.entry.js → p-d51ec950.entry.js} +1 -1
  1306. package/dist/magma-components/{p-4606d11f.entry.js → p-d760c1fa.entry.js} +1 -1
  1307. package/dist/magma-components/p-d785d7ee.entry.js +1 -0
  1308. package/dist/magma-components/{p-08da465d.entry.js → p-d9092133.entry.js} +1 -1
  1309. package/dist/magma-components/{p-03fb86a6.system.entry.js → p-dd348171.system.entry.js} +2 -2
  1310. package/dist/magma-components/{p-dcb5f965.entry.js → p-de423b11.entry.js} +1 -1
  1311. package/dist/magma-components/{p-97217527.system.entry.js → p-df78b7ac.system.entry.js} +1 -1
  1312. package/dist/magma-components/{p-fba648e0.entry.js → p-e39b5e12.entry.js} +1 -1
  1313. package/dist/magma-components/{p-99bfa07e.system.entry.js → p-eac943e5.system.entry.js} +1 -1
  1314. package/dist/magma-components/{p-9ef0d4e5.system.entry.js → p-eb220deb.system.entry.js} +2 -2
  1315. package/dist/magma-components/{p-fd81c4ef.system.entry.js → p-eca42fe8.system.entry.js} +2 -2
  1316. package/dist/magma-components/{p-56a25ec6.entry.js → p-ecda3e45.entry.js} +1 -1
  1317. package/dist/magma-components/{p-b523fabe.system.entry.js → p-f0909679.system.entry.js} +2 -2
  1318. package/dist/magma-components/{p-8bf8e032.entry.js → p-f2649031.entry.js} +1 -1
  1319. package/dist/magma-components/{p-30f95d10.entry.js → p-f51ed098.entry.js} +1 -1
  1320. package/dist/magma-components/{p-11210b60.system.entry.js → p-f5bd5b64.system.entry.js} +3 -3
  1321. package/dist/magma-components/p-f6358241.system.entry.js +19 -0
  1322. package/dist/magma-components/{p-b0850daa.entry.js → p-f9f3ad86.entry.js} +1 -1
  1323. package/dist/magma-components/{p-a3d09996.entry.js → p-fb4b648a.entry.js} +1 -1
  1324. package/dist/magma-components/{p-81d2582a.entry.js → p-fd4588c5.entry.js} +1 -1
  1325. package/dist/magma-components/{p-3b494de7.entry.js → p-fdd17ee6.entry.js} +1 -1
  1326. package/dist/magma-components/p-fe51c0cb.system.entry.js +10 -0
  1327. package/dist/magma-components/{p-a3156523.system.entry.js → p-ff6cf4f8.system.entry.js} +3 -3
  1328. package/dist/magma-components/{p-4da1c089.entry.js → p-ff76c614.entry.js} +1 -1
  1329. package/dist/{lint/mcp → mcp}/checks.js +4 -4
  1330. package/dist/{lint/mcp → mcp}/components.js +4 -6
  1331. package/dist/{lint/mcp → mcp}/guides.js +11 -9
  1332. package/dist/{lint/mcp → mcp}/icons.js +21 -0
  1333. package/dist/mcp/package.json +3 -0
  1334. package/dist/{lint/mcp → mcp}/patterns.js +27 -18
  1335. package/dist/{lint/mcp → mcp}/protocol.js +1 -1
  1336. package/dist/{lint/mcp → mcp}/render-page.js +17 -0
  1337. package/dist/{lint/mcp → mcp}/render.js +157 -48
  1338. package/dist/{lint/mcp → mcp}/server.js +4 -4
  1339. package/dist/{lint/mcp → mcp}/tokens.js +1 -2
  1340. package/dist/mcp/tools.json +1374 -0
  1341. package/dist/stats.json +2322 -2038
  1342. package/dist/types/common/aria.d.ts +8 -1
  1343. package/dist/types/common/preference.d.ts +13 -1
  1344. package/dist/types/components/mds-button/mds-button.d.ts +50 -4
  1345. package/dist/types/components/mds-button-dropdown/mds-button-dropdown.d.ts +22 -2
  1346. package/dist/types/components/mds-modal/mds-modal.d.ts +8 -1
  1347. package/dist/types/components/mds-pref/mds-pref.d.ts +0 -9
  1348. package/dist/types/components/mds-pref-mode/mds-pref-mode.d.ts +16 -5
  1349. package/dist/types/components/mds-pref-theme/mds-pref-theme.d.ts +14 -1
  1350. package/dist/types/components/mds-pref-theme-item/mds-pref-theme-item.d.ts +9 -2
  1351. package/dist/types/components.d.ts +71 -17
  1352. package/dist/types/type/button.d.ts +2 -0
  1353. package/package.json +15 -13
  1354. package/dist/components/p-BwT0RJip.js +0 -1
  1355. package/dist/components/p-COUgBzJ4.js +0 -1
  1356. package/dist/components/p-Cvhn9asj.js +0 -1
  1357. package/dist/components/p-G7Udw5H5.js +0 -1
  1358. package/dist/components/p-Ic8cYsgt.js +0 -1
  1359. package/dist/components/p-l0KS6hTQ.js +0 -1
  1360. package/dist/esm-es5/aria-Cvhn9asj.js +0 -6
  1361. package/dist/lint/mcp/checks.d.ts +0 -29
  1362. package/dist/lint/mcp/cli.d.ts +0 -2
  1363. package/dist/lint/mcp/color.d.ts +0 -12
  1364. package/dist/lint/mcp/components.d.ts +0 -5
  1365. package/dist/lint/mcp/context.d.ts +0 -45
  1366. package/dist/lint/mcp/guides.d.ts +0 -3
  1367. package/dist/lint/mcp/icons.d.ts +0 -9
  1368. package/dist/lint/mcp/patterns.d.ts +0 -75
  1369. package/dist/lint/mcp/protocol.d.ts +0 -77
  1370. package/dist/lint/mcp/render-page.d.ts +0 -36
  1371. package/dist/lint/mcp/render.d.ts +0 -109
  1372. package/dist/lint/mcp/server.d.ts +0 -39
  1373. package/dist/lint/mcp/tokens.d.ts +0 -37
  1374. package/dist/magma-components/p-06691ab3.system.entry.js +0 -27
  1375. package/dist/magma-components/p-1d8485de.system.entry.js +0 -28
  1376. package/dist/magma-components/p-21345ecc.entry.js +0 -1
  1377. package/dist/magma-components/p-25dcbf22.entry.js +0 -1
  1378. package/dist/magma-components/p-34d58345.entry.js +0 -1
  1379. package/dist/magma-components/p-37881115.system.entry.js +0 -14
  1380. package/dist/magma-components/p-4e5b8618.system.entry.js +0 -1
  1381. package/dist/magma-components/p-52e2b0d4.system.entry.js +0 -14
  1382. package/dist/magma-components/p-69319301.system.entry.js +0 -10
  1383. package/dist/magma-components/p-7b06b2f2.entry.js +0 -1
  1384. package/dist/magma-components/p-7d61f442.entry.js +0 -1
  1385. package/dist/magma-components/p-9e2b1a29.entry.js +0 -1
  1386. package/dist/magma-components/p-9ed54db1.entry.js +0 -1
  1387. package/dist/magma-components/p-Cvhn9asj.js +0 -1
  1388. package/dist/magma-components/p-a8206d9c.entry.js +0 -1
  1389. package/dist/magma-components/p-b464668b.system.entry.js +0 -105
  1390. package/dist/magma-components/p-b85f56d7.entry.js +0 -1
  1391. package/dist/magma-components/p-c7dc17f8.entry.js +0 -1
  1392. package/dist/magma-components/p-d43e2a9a.entry.js +0 -1
  1393. package/dist/magma-components/p-ddfb4da3.entry.js +0 -1
  1394. package/dist/magma-components/p-e428490d.system.entry.js +0 -5
  1395. package/dist/magma-components/p-f045b018.entry.js +0 -1
  1396. package/dist/magma-components/p-f3708d1a.entry.js +0 -1
  1397. package/dist/magma-components/p-f5d9f625.entry.js +0 -1
  1398. package/dist/magma-components/p-fa387b74.system.entry.js +0 -5
  1399. package/dist/magma-components/p-fbf563c8.entry.js +0 -1
  1400. package/dist/magma-components/p-ff82edad.entry.js +0 -1
  1401. package/dist/magma-components/p-sm_-_oFY.system.js +0 -6
  1402. /package/dist/{lint/mcp → mcp}/cli.js +0 -0
  1403. /package/dist/{lint/mcp → mcp}/color.js +0 -0
  1404. /package/dist/{lint/mcp → mcp}/context.js +0 -0
  1405. /package/dist/{lint/mcp → mcp}/icon.svg +0 -0
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-pref-theme
8
8
 
9
- > `@maggioli-design-system/magma` 2.10.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-theme>` web component is the theme-switcher segment of the Magma accessibility preferences panel, usually a direct child of [`<mds-pref>`](../mds-pref/AGENTS.md). It renders a labelled tab trigger that opens a dropdown of selectable named themes and, when a theme is chosen, applies it globally to the document.
12
12
 
@@ -15,17 +15,18 @@ The `<mds-pref-theme>` web component is the theme-switcher segment of the Magma
15
15
  - **Usually inside `<mds-pref>`**: Placed as a direct slot child of `<mds-pref>`, alongside the other `mds-pref-*` controls; it also works on its own, since it applies and stores the theme by itself. What it gives up on its own is in its mistakes.
16
16
  - **Acts as a sub-parent itself**: Its own default slot must contain one or more `mds-pref-theme-item` elements; it drives their selected state so only the active theme is marked selected.
17
17
  - **Global theme application**: Selecting an item applies the theme document-wide: it writes `data-theme-name` and the `pref-theme-scheme-*` class on `<html>`.
18
+ - **The theme's own mode**: A theme file can list the colour modes it can be used in (`color.modes`); a theme of one mode declares it in its block of `themes.css`, and the component applies the theme in that mode (`pref-theme-scheme-dark` or `-light`) whatever the item's `scheme` says. The stylesheet of the theme must be on the page when the theme is applied. The storage keeps the item's `scheme`.
18
19
  - **Persistence and hydration**: The current name, scheme and corner shape are persisted and restored across reloads: a stored value outranks the matching prop.
19
20
  - **Validation**: An invalid theme name (not lowercase kebab-case matching `^[a-z]+(-[a-z]+)*$`) is ignored with a console warning when the theme is applied: nothing is written on `<html>` or stored. So are the reserved names `light`, `dark` and `system` (they are mode values) and `scheme` or `scheme-*` (they would collide with the `pref-theme-scheme-*` classes), a `scheme` other than `light`, `dark` or `all`, and a `corner-shape` outside its keywords. A stored value the component cannot apply is dropped, and the prop is used instead.
20
- - **Events bubbled up**: Emits `mdsPrefThemeChange` with the `{ name, scheme }` detail on each pick, which `<mds-pref>` listens to in order to lock the `<mds-pref-mode>` item a scheme-constrained theme forbids. It also emits `mdsPrefChange` once per change, after applying it: `preference: 'theme'` for a new name or scheme, `'corner-shape'` for a new corner shape. The first application on load and a re-render that changes nothing do not emit it.
21
+ - **Events bubbled up**: Emits `mdsPrefThemeChange` with the `{ name, scheme }` detail on each pick, `scheme` being the one the theme is applied with (the theme's own mode, when it declares one). `<mds-pref-mode>` follows the scheme from `<html>`, with no listener. It also emits `mdsPrefChange` once per change, after applying it: `preference: 'theme'` for a new name or scheme, `'corner-shape'` for a new corner shape. The first application on load and a re-render that changes nothing do not emit it.
21
22
  - **Props set after load**: A `name`, `scheme` or `cornerShape` set from a script after load is stored and applied, as a pick is: the stored value outranks the prop only on load. A value the component would not apply is not stored.
22
23
  - **Localized label**: The "Theme" heading follows the active interface language.
23
24
  - **Trigger text**: The closed control shows the `label` of the item for the active theme, the same text the open list shows (localize the items, the trigger follows); when no item matches the active theme it shows the label derived from the name (`dark-blue` -> "Dark blue").
24
25
 
25
26
  #### Properties & Visual Configurations
26
27
 
27
- - **`name`**: The active theme name (default `'default'`); it is overridden at runtime by any persisted value. Use it to declare the initial theme when no preference has been stored yet. The named themes are `cool` and `warm`; `default` is the base theme ([`agents/theming.md`](../../../../agents/theming.md)).
28
- - **`scheme`**: Constrains the colour modes of the theme to `'light'`, `'dark'`, or `'all'` (default). Pick `'all'` for themes that ship both light and dark palettes; pick `'light'` or `'dark'` to force a single mode for a theme offered in one mode only.
28
+ - **`name`**: The active theme name; it is overridden at runtime by any persisted value. Use it to declare the initial theme when no preference has been stored yet. The named themes are `business`, the base theme, and `editorial` ([`agents/theming.md`](../../../../agents/theming.md)). The default `'default'` is the old name of `business`, kept until the next major, when the default becomes `'business'`: the two names stand for the same theme, so with `name` left out the item `business` is the one marked, and an item named `default` is marked under `business`. `cool` and `warm` are deprecated.
29
+ - **`scheme`**: Constrains the colour modes of the theme to `'light'`, `'dark'`, or `'all'` (default). Pick `'all'` for themes that ship both light and dark palettes; pick `'light'` or `'dark'` to force a single mode for a theme offered in one mode only. A theme that declares its own mode (`color.modes` in its file) needs no `scheme`: its declaration wins.
29
30
  - **`size`**: Sets the size (`'sm'` / `'md'`) of the nested tab UI. Inside `<mds-pref>`, set it on the parent: it reaches every `mds-pref-*` segment on load and when it changes, and overwrites the segment's own.
30
31
  - **`cornerShape`** (attribute `corner-shape`): The corner geometry of the whole page - `round`, `squircle`, `bevel`, `notch`, `scoop`, `square`, or `default`. It writes `data-corner-shape` on `<html>` and is persisted like the theme; `default` removes the attribute, and leaving the prop unset touches nothing ([`agents/theming.md`](../../../../agents/theming.md)).
31
32
 
@@ -42,7 +43,7 @@ The `<mds-pref-theme>` web component is the theme-switcher segment of the Magma
42
43
  | --- | --- | --- | --- | --- |
43
44
  | `cornerShape` | `corner-shape` | `"bevel" \| "default" \| "notch" \| "round" \| "scoop" \| "square" \| "squircle" \| undefined` | - | Specifies the corner geometry of the whole page: one of the `corner-shape` keywords, or `default`. Corner geometry is theme appearance rather than an accessibility preference, which is why it lives here next to the theme name and scheme instead of in `mds-pref-mode`. Setting it writes `data-corner-shape` on `<html>`, where the generated axis picks both the shape and the radius scale tuned for it. Leaving it unset touches nothing. Setting it to `default` REMOVES the attribute rather than writing today's default into the page, so a project that never chose keeps following the design system when the default changes. |
44
45
  | `name` | `name` | `string` | `'default'` | Specifies the theme name attribute A string representing the theme name, in lowercase kebab-case. |
45
- | `scheme` | `scheme` | `"all" \| "dark" \| "light"` | `'all'` | Specifies the theme scheme which can be 'light', 'dark' or 'all' Default is 'all' which means this theme supporto both light and dark. If you set 'light' means this theme support only light mode and will be forced and shown light colors mode only. |
46
+ | `scheme` | `scheme` | `"all" \| "dark" \| "light"` | `'all'` | Specifies the theme scheme which can be 'light', 'dark' or 'all' Default is 'all' which means this theme supporto both light and dark. If you set 'light' means this theme support only light mode and will be forced and shown light colors mode only. A theme whose stylesheet declares one mode (`--magma-color-modes`, from `color.modes` of its file) is applied in that mode whatever this says: the theme's own lock wins. |
46
47
  | `size` | `size` | `"md" \| "sm" \| undefined` | - | Sets the size of the component items nested inside it |
47
48
 
48
49
  ## Events
@@ -50,7 +51,7 @@ The `<mds-pref-theme>` web component is the theme-switcher segment of the Magma
50
51
  | Event | Detail | Description |
51
52
  | --- | --- | --- |
52
53
  | `mdsPrefChange` | `MdsPrefChangeEventDetail` | Emits when the component is triggered |
53
- | `mdsPrefThemeChange` | `MdsPrefThemeEventDetail` | Emits when the component changes the language selected from the click event of the dropdown list item |
54
+ | `mdsPrefThemeChange` | `MdsPrefThemeEventDetail` | Emits when the component changes the language selected from the click event of the dropdown list item. Its `scheme` is the one the theme is applied with: the mode the theme declares, when it declares one, or else the scheme of the item. |
54
55
 
55
56
  ## Slots
56
57
 
@@ -1,5 +1,5 @@
1
1
  {
2
- "timestamp": "2026-11-04T07:18:11",
2
+ "timestamp": "2026-11-06T15:30:27",
3
3
  "compiler": {
4
4
  "name": "@stencil/core",
5
5
  "version": "4.45.2",
@@ -23,9 +23,9 @@
23
23
  }
24
24
  ],
25
25
  "usage": {
26
- "1. Description": "The `<mds-pref-theme>` web component is the theme-switcher segment of the Magma accessibility preferences panel, usually a direct child of [`<mds-pref>`](../mds-pref/AGENTS.md). It renders a labelled tab trigger that opens a dropdown of selectable named themes and, when a theme is chosen, applies it globally to the document.\n\n#### Semantic Behavior\n\n- **Usually inside `<mds-pref>`**: Placed as a direct slot child of `<mds-pref>`, alongside the other `mds-pref-*` controls; it also works on its own, since it applies and stores the theme by itself. What it gives up on its own is in its mistakes.\n- **Acts as a sub-parent itself**: Its own default slot must contain one or more `mds-pref-theme-item` elements; it drives their selected state so only the active theme is marked selected.\n- **Global theme application**: Selecting an item applies the theme document-wide: it writes `data-theme-name` and the `pref-theme-scheme-*` class on `<html>`.\n- **Persistence and hydration**: The current name, scheme and corner shape are persisted and restored across reloads: a stored value outranks the matching prop.\n- **Validation**: An invalid theme name (not lowercase kebab-case matching `^[a-z]+(-[a-z]+)*$`) is ignored with a console warning when the theme is applied: nothing is written on `<html>` or stored. So are the reserved names `light`, `dark` and `system` (they are mode values) and `scheme` or `scheme-*` (they would collide with the `pref-theme-scheme-*` classes), a `scheme` other than `light`, `dark` or `all`, and a `corner-shape` outside its keywords. A stored value the component cannot apply is dropped, and the prop is used instead.\n- **Events bubbled up**: Emits `mdsPrefThemeChange` with the `{ name, scheme }` detail on each pick, which `<mds-pref>` listens to in order to lock the `<mds-pref-mode>` item a scheme-constrained theme forbids. It also emits `mdsPrefChange` once per change, after applying it: `preference: 'theme'` for a new name or scheme, `'corner-shape'` for a new corner shape. The first application on load and a re-render that changes nothing do not emit it.\n- **Props set after load**: A `name`, `scheme` or `cornerShape` set from a script after load is stored and applied, as a pick is: the stored value outranks the prop only on load. A value the component would not apply is not stored.\n- **Localized label**: The \"Theme\" heading follows the active interface language.\n- **Trigger text**: The closed control shows the `label` of the item for the active theme, the same text the open list shows (localize the items, the trigger follows); when no item matches the active theme it shows the label derived from the name (`dark-blue` -> \"Dark blue\").\n\n#### Properties & Visual Configurations\n\n- **`name`**: The active theme name (default `'default'`); it is overridden at runtime by any persisted value. Use it to declare the initial theme when no preference has been stored yet. The named themes are `cool` and `warm`; `default` is the base theme ([`agents/theming.md`](../../../../agents/theming.md)).\n- **`scheme`**: Constrains the colour modes of the theme to `'light'`, `'dark'`, or `'all'` (default). Pick `'all'` for themes that ship both light and dark palettes; pick `'light'` or `'dark'` to force a single mode for a theme offered in one mode only.\n- **`size`**: Sets the size (`'sm'` / `'md'`) of the nested tab UI. Inside `<mds-pref>`, set it on the parent: it reaches every `mds-pref-*` segment on load and when it changes, and overwrites the segment's own.\n- **`cornerShape`** (attribute `corner-shape`): The corner geometry of the whole page - `round`, `squircle`, `bevel`, `notch`, `scoop`, `square`, or `default`. It writes `data-corner-shape` on `<html>` and is persisted like the theme; `default` removes the attribute, and leaving the prop unset touches nothing ([`agents/theming.md`](../../../../agents/theming.md)).\n",
27
- "2. Examples": "Correct and idiomatic ways to use the `<mds-pref-theme>` component, ordered from most common to most specialized. The examples assume a working knowledge of the preferences system documented in [`agents/theming.md`](../../../../agents/theming.md) and the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Basic Theme Chooser\n\nThe canonical form. Place `<mds-pref-theme>` inside [`<mds-pref>`](../mds-pref/AGENTS.md) and populate its default slot with one [`<mds-pref-theme-item>`](../mds-pref-theme-item/AGENTS.md) per available theme. The item whose `name` matches the active theme (the stored choice, or the parent's `name` on a first visit) starts as selected. The named themes are `cool` and `warm`; `default` is the base theme.\n\n```html\n<mds-pref>\n <mds-pref-theme name=\"default\" scheme=\"all\">\n <mds-pref-theme-item label=\"Predefinito\" name=\"default\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item label=\"Freddo\" name=\"cool\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item label=\"Caldo\" name=\"warm\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n```\n\n#### Scheme-Constrained Themes\n\nUse `scheme=\"light\"` or `scheme=\"dark\"` on a `<mds-pref-theme-item>` when the theme must be offered in one colour mode only. The parent component propagates the chosen scheme to `<html>` and forces that mode even if the user's OS or mode preference asks for the opposite; inside `<mds-pref>` the forbidden item of `<mds-pref-mode>` is locked.\n\n```html\n<mds-pref>\n <mds-pref-theme name=\"default\" scheme=\"all\">\n <mds-pref-theme-item label=\"Predefinito\" name=\"default\" scheme=\"all\"></mds-pref-theme-item>\n <!-- light only - dark mode will not activate with this item -->\n <mds-pref-theme-item label=\"Freddo chiaro\" name=\"cool\" scheme=\"light\"></mds-pref-theme-item>\n <!-- dark only -->\n <mds-pref-theme-item label=\"Caldo scuro\" name=\"warm\" scheme=\"dark\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n```\n\n#### Listening for the Change Event\n\nReact to the user's selection via `mdsPrefThemeChange`. The event detail carries `{ name, scheme }` - use them to update any app-level state that tracks the active theme.\n\n```html\n<mds-pref>\n <mds-pref-theme id=\"theme-chooser\" name=\"default\" scheme=\"all\">\n <mds-pref-theme-item label=\"Predefinito\" name=\"default\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item label=\"Freddo\" name=\"cool\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n\n<script>\n document.querySelector('#theme-chooser').addEventListener('mdsPrefThemeChange', (e) => {\n console.log('Tema attivo:', e.detail.name, '- Schema:', e.detail.scheme);\n });\n</script>\n```\n\n#### Declaring the Initial Theme\n\nUse the `name` prop to declare which theme should be active before the user makes a selection. If `localStorage` already holds a persisted value it takes precedence; otherwise the component applies `name` on first render.\n\n```html\n<mds-pref>\n <!-- First-visit default is \"warm\" -->\n <mds-pref-theme name=\"warm\" scheme=\"all\">\n <mds-pref-theme-item label=\"Predefinito\" name=\"default\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item label=\"Caldo\" name=\"warm\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n```\n\n#### Controlling Item Size\n\nPass `size=\"sm\"` when the preferences panel must fit a compact layout: on `<mds-pref>`, which forwards it to every preference control.\n\n```html\n<mds-pref size=\"sm\">\n <mds-pref-theme name=\"default\" scheme=\"all\">\n <mds-pref-theme-item label=\"Predefinito\" name=\"default\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item label=\"Freddo\" name=\"cool\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n```\n\n#### Styling Theme Items\n\nStyle theme items only through their public `--mds-pref-theme-item-*` CSS custom properties. Set them on the item host or on a parent selector; name a semantic role, `rgb(var(--magma-<role>))` ([`agents/color.md`](../../../../agents/color.md)), so the colours follow the mode, the theme and the contrast preference.\n\n```css\nmds-pref-theme-item {\n --mds-pref-theme-item-color-background: rgb(var(--magma-surface-inverse));\n}\n```\n",
28
- "3. Mistakes": "Common incorrect uses of `<mds-pref-theme>`. Each entry pairs the wrong form with the right one and a one-line reason. System-wide rules (boolean-as-string, shadow piercing, Tailwind colour utilities, raw native event listening) live in [`agents/mistakes.md`](../../../../agents/mistakes.md) - they apply here too but are not repeated.\n\n#### Do Not Use the Component Outside `<mds-pref>`\n\n`<mds-pref-theme>` is a compound sub-part designed to slot inside [`<mds-pref>`](../mds-pref/AGENTS.md). As a standalone widget it still applies and persists the theme, but it leaves the panel: `<mds-pref>` can no longer forward `size` changes to it, nor lock the `<mds-pref-mode>` item that its `scheme` forbids.\n\n```html\n<!-- INCORRECT -->\n<mds-pref-theme name=\"default\" scheme=\"all\">\n <mds-pref-theme-item label=\"Predefinito\" name=\"default\" scheme=\"all\"></mds-pref-theme-item>\n</mds-pref-theme>\n\n<!-- CORRECT -->\n<mds-pref>\n <mds-pref-theme name=\"default\" scheme=\"all\">\n <mds-pref-theme-item label=\"Predefinito\" name=\"default\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n```\n\n#### Do Not Put Plain Text or Arbitrary HTML in the Default Slot\n\nThe default slot is reserved exclusively for `<mds-pref-theme-item>` elements. Any other content bypasses the component's internal selection management and will not trigger theme application.\n\n```html\n<!-- INCORRECT -->\n<mds-pref>\n <mds-pref-theme name=\"default\" scheme=\"all\">\n <button>Predefinito</button>\n <span>Estate</span>\n </mds-pref-theme>\n</mds-pref>\n\n<!-- CORRECT -->\n<mds-pref>\n <mds-pref-theme name=\"default\" scheme=\"all\">\n <mds-pref-theme-item label=\"Predefinito\" name=\"default\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item label=\"Freddo\" name=\"cool\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n```\n\n#### Do Not Use an Invalid Theme Name\n\nThe `name` prop must match the pattern `^[a-z]+(-[a-z]+)*$` (lowercase letters and hyphens only). Any other value - including uppercase, underscores, or spaces - is ignored with a console warning when the component tries to apply the theme on `<html>`: the theme is neither applied nor stored.\n\n```html\n<!-- INCORRECT -->\n<mds-pref-theme name=\"My Theme\" scheme=\"all\">...</mds-pref-theme>\n<mds-pref-theme name=\"my_theme\" scheme=\"all\">...</mds-pref-theme>\n<mds-pref-theme name=\"MyTheme\" scheme=\"all\">...</mds-pref-theme>\n\n<!-- CORRECT -->\n<mds-pref-theme name=\"warm\" scheme=\"all\">...</mds-pref-theme>\n```\n\n#### Do Not Listen for the Native `change` Event\n\n`<mds-pref-theme>` emits `mdsPrefThemeChange` - a documented custom event with a typed `{ name, scheme }` detail. Listening for the native `change` event will not fire because theme selection is handled entirely inside shadow DOM.\n\n```html\n<!-- INCORRECT -->\n<script>\n document.querySelector('mds-pref-theme').addEventListener('change', (e) => {\n console.log(e.target.value); // undefined - wrong event, wrong detail shape\n });\n</script>\n\n<!-- CORRECT -->\n<script>\n document.querySelector('mds-pref-theme').addEventListener('mdsPrefThemeChange', (e) => {\n console.log(e.detail.name, e.detail.scheme);\n });\n</script>\n```\n\n#### Do Not Give the Parent and the Child Different Sizes\n\n`<mds-pref>` forwards its own `size` to all `mds-pref-*` children, on load and when it changes, and overwrites theirs: a `size` on `<mds-pref-theme>` that differs from the parent's is never shown. Set the size on the parent only.\n\n```html\n<!-- INCORRECT -->\n<mds-pref size=\"sm\">\n <mds-pref-theme size=\"md\" name=\"default\" scheme=\"all\">\n <mds-pref-theme-item label=\"Predefinito\" name=\"default\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n\n<!-- CORRECT -->\n<mds-pref size=\"sm\">\n <mds-pref-theme name=\"default\" scheme=\"all\">\n <mds-pref-theme-item label=\"Predefinito\" name=\"default\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n```\n"
26
+ "1. Description": "The `<mds-pref-theme>` web component is the theme-switcher segment of the Magma accessibility preferences panel, usually a direct child of [`<mds-pref>`](../mds-pref/AGENTS.md). It renders a labelled tab trigger that opens a dropdown of selectable named themes and, when a theme is chosen, applies it globally to the document.\n\n#### Semantic Behavior\n\n- **Usually inside `<mds-pref>`**: Placed as a direct slot child of `<mds-pref>`, alongside the other `mds-pref-*` controls; it also works on its own, since it applies and stores the theme by itself. What it gives up on its own is in its mistakes.\n- **Acts as a sub-parent itself**: Its own default slot must contain one or more `mds-pref-theme-item` elements; it drives their selected state so only the active theme is marked selected.\n- **Global theme application**: Selecting an item applies the theme document-wide: it writes `data-theme-name` and the `pref-theme-scheme-*` class on `<html>`.\n- **The theme's own mode**: A theme file can list the colour modes it can be used in (`color.modes`); a theme of one mode declares it in its block of `themes.css`, and the component applies the theme in that mode (`pref-theme-scheme-dark` or `-light`) whatever the item's `scheme` says. The stylesheet of the theme must be on the page when the theme is applied. The storage keeps the item's `scheme`.\n- **Persistence and hydration**: The current name, scheme and corner shape are persisted and restored across reloads: a stored value outranks the matching prop.\n- **Validation**: An invalid theme name (not lowercase kebab-case matching `^[a-z]+(-[a-z]+)*$`) is ignored with a console warning when the theme is applied: nothing is written on `<html>` or stored. So are the reserved names `light`, `dark` and `system` (they are mode values) and `scheme` or `scheme-*` (they would collide with the `pref-theme-scheme-*` classes), a `scheme` other than `light`, `dark` or `all`, and a `corner-shape` outside its keywords. A stored value the component cannot apply is dropped, and the prop is used instead.\n- **Events bubbled up**: Emits `mdsPrefThemeChange` with the `{ name, scheme }` detail on each pick, `scheme` being the one the theme is applied with (the theme's own mode, when it declares one). `<mds-pref-mode>` follows the scheme from `<html>`, with no listener. It also emits `mdsPrefChange` once per change, after applying it: `preference: 'theme'` for a new name or scheme, `'corner-shape'` for a new corner shape. The first application on load and a re-render that changes nothing do not emit it.\n- **Props set after load**: A `name`, `scheme` or `cornerShape` set from a script after load is stored and applied, as a pick is: the stored value outranks the prop only on load. A value the component would not apply is not stored.\n- **Localized label**: The \"Theme\" heading follows the active interface language.\n- **Trigger text**: The closed control shows the `label` of the item for the active theme, the same text the open list shows (localize the items, the trigger follows); when no item matches the active theme it shows the label derived from the name (`dark-blue` -> \"Dark blue\").\n\n#### Properties & Visual Configurations\n\n- **`name`**: The active theme name; it is overridden at runtime by any persisted value. Use it to declare the initial theme when no preference has been stored yet. The named themes are `business`, the base theme, and `editorial` ([`agents/theming.md`](../../../../agents/theming.md)). The default `'default'` is the old name of `business`, kept until the next major, when the default becomes `'business'`: the two names stand for the same theme, so with `name` left out the item `business` is the one marked, and an item named `default` is marked under `business`. `cool` and `warm` are deprecated.\n- **`scheme`**: Constrains the colour modes of the theme to `'light'`, `'dark'`, or `'all'` (default). Pick `'all'` for themes that ship both light and dark palettes; pick `'light'` or `'dark'` to force a single mode for a theme offered in one mode only. A theme that declares its own mode (`color.modes` in its file) needs no `scheme`: its declaration wins.\n- **`size`**: Sets the size (`'sm'` / `'md'`) of the nested tab UI. Inside `<mds-pref>`, set it on the parent: it reaches every `mds-pref-*` segment on load and when it changes, and overwrites the segment's own.\n- **`cornerShape`** (attribute `corner-shape`): The corner geometry of the whole page - `round`, `squircle`, `bevel`, `notch`, `scoop`, `square`, or `default`. It writes `data-corner-shape` on `<html>` and is persisted like the theme; `default` removes the attribute, and leaving the prop unset touches nothing ([`agents/theming.md`](../../../../agents/theming.md)).\n",
27
+ "2. Examples": "Correct and idiomatic ways to use the `<mds-pref-theme>` component, ordered from most common to most specialized. The examples assume a working knowledge of the preferences system documented in [`agents/theming.md`](../../../../agents/theming.md) and the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Basic Theme Chooser\n\nThe canonical form. Place `<mds-pref-theme>` inside [`<mds-pref>`](../mds-pref/AGENTS.md) and populate its default slot with one [`<mds-pref-theme-item>`](../mds-pref-theme-item/AGENTS.md) per available theme. The item whose `name` matches the active theme (the stored choice, or the parent's `name` on a first visit) starts as selected. The named themes are `business`, the base theme of the management software, and `editorial`, the theme of the publishing side.\n\n```html\n<mds-pref>\n <mds-pref-theme name=\"business\" scheme=\"all\">\n <mds-pref-theme-item label=\"Gestionale\" name=\"business\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item label=\"Editoriale\" name=\"editorial\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n```\n\n#### Scheme-Constrained Themes\n\nA theme made for one colour mode says so in its file (`\"modes\": [\"dark\"]` in `color`), and the component applies it in that mode with no attribute on the item. For a theme whose file says nothing, use `scheme=\"light\"` or `scheme=\"dark\"` on a `<mds-pref-theme-item>`. Either way the component writes the scheme on `<html>` and forces that mode even if the user's OS or mode preference asks for the opposite, and `<mds-pref-mode>` shows that mode with its other items locked.\n\n```html\n<mds-pref>\n <mds-pref-theme name=\"business\" scheme=\"all\">\n <mds-pref-theme-item label=\"Gestionale\" name=\"business\" scheme=\"all\"></mds-pref-theme-item>\n <!-- light only - dark mode will not activate with this item -->\n <mds-pref-theme-item label=\"Editoriale chiaro\" name=\"editorial\" scheme=\"light\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n```\n\n#### Listening for the Change Event\n\nReact to the user's selection via `mdsPrefThemeChange`. The event detail carries `{ name, scheme }` - use them to update any app-level state that tracks the active theme.\n\n```html\n<mds-pref>\n <mds-pref-theme id=\"theme-chooser\" name=\"business\" scheme=\"all\">\n <mds-pref-theme-item label=\"Gestionale\" name=\"business\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item label=\"Editoriale\" name=\"editorial\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n\n<script>\n document.querySelector('#theme-chooser').addEventListener('mdsPrefThemeChange', (e) => {\n console.log('Tema attivo:', e.detail.name, '- Schema:', e.detail.scheme);\n });\n</script>\n```\n\n#### Declaring the Initial Theme\n\nUse the `name` prop to declare which theme should be active before the user makes a selection. If `localStorage` already holds a persisted value it takes precedence; otherwise the component applies `name` on first render.\n\n```html\n<mds-pref>\n <!-- First-visit default is \"editorial\" -->\n <mds-pref-theme name=\"editorial\" scheme=\"all\">\n <mds-pref-theme-item label=\"Gestionale\" name=\"business\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item label=\"Editoriale\" name=\"editorial\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n```\n\n#### Controlling Item Size\n\nPass `size=\"sm\"` when the preferences panel must fit a compact layout: on `<mds-pref>`, which forwards it to every preference control.\n\n```html\n<mds-pref size=\"sm\">\n <mds-pref-theme name=\"business\" scheme=\"all\">\n <mds-pref-theme-item label=\"Gestionale\" name=\"business\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item label=\"Editoriale\" name=\"editorial\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n```\n\n#### Styling Theme Items\n\nStyle theme items only through their public `--mds-pref-theme-item-*` CSS custom properties. Set them on the item host or on a parent selector; name a semantic role, `rgb(var(--magma-<role>))` ([`agents/color.md`](../../../../agents/color.md)), so the colours follow the mode, the theme and the contrast preference.\n\n```css\nmds-pref-theme-item {\n --mds-pref-theme-item-color-background: rgb(var(--magma-surface-inverse));\n}\n```\n",
28
+ "3. Mistakes": "Common incorrect uses of `<mds-pref-theme>`. Each entry pairs the wrong form with the right one and a one-line reason. System-wide rules (boolean-as-string, shadow piercing, Tailwind colour utilities, raw native event listening) live in [`agents/mistakes.md`](../../../../agents/mistakes.md) - they apply here too but are not repeated.\n\n#### Do Not Use the Component Outside `<mds-pref>`\n\n`<mds-pref-theme>` is a compound sub-part designed to slot inside [`<mds-pref>`](../mds-pref/AGENTS.md). As a standalone widget it still applies and persists the theme, but it leaves the panel: `<mds-pref>` can no longer forward `size` changes to it. The lock of a single-mode theme on `<mds-pref-mode>` holds either way.\n\n```html\n<!-- INCORRECT -->\n<mds-pref-theme name=\"business\" scheme=\"all\">\n <mds-pref-theme-item label=\"Gestionale\" name=\"business\" scheme=\"all\"></mds-pref-theme-item>\n</mds-pref-theme>\n\n<!-- CORRECT -->\n<mds-pref>\n <mds-pref-theme name=\"business\" scheme=\"all\">\n <mds-pref-theme-item label=\"Gestionale\" name=\"business\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n```\n\n#### Do Not Put Plain Text or Arbitrary HTML in the Default Slot\n\nThe default slot is reserved exclusively for `<mds-pref-theme-item>` elements. Any other content bypasses the component's internal selection management and will not trigger theme application.\n\n```html\n<!-- INCORRECT -->\n<mds-pref>\n <mds-pref-theme name=\"business\" scheme=\"all\">\n <button>Gestionale</button>\n <span>Editoriale</span>\n </mds-pref-theme>\n</mds-pref>\n\n<!-- CORRECT -->\n<mds-pref>\n <mds-pref-theme name=\"business\" scheme=\"all\">\n <mds-pref-theme-item label=\"Gestionale\" name=\"business\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item label=\"Editoriale\" name=\"editorial\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n```\n\n#### Do Not Use an Invalid Theme Name\n\nThe `name` prop must match the pattern `^[a-z]+(-[a-z]+)*$` (lowercase letters and hyphens only). Any other value - including uppercase, underscores, or spaces - is ignored with a console warning when the component tries to apply the theme on `<html>`: the theme is neither applied nor stored.\n\n```html\n<!-- INCORRECT -->\n<mds-pref-theme name=\"My Theme\" scheme=\"all\">...</mds-pref-theme>\n<mds-pref-theme name=\"my_theme\" scheme=\"all\">...</mds-pref-theme>\n<mds-pref-theme name=\"MyTheme\" scheme=\"all\">...</mds-pref-theme>\n\n<!-- CORRECT -->\n<mds-pref-theme name=\"editorial\" scheme=\"all\">...</mds-pref-theme>\n```\n\n#### Do Not Listen for the Native `change` Event\n\n`<mds-pref-theme>` emits `mdsPrefThemeChange` - a documented custom event with a typed `{ name, scheme }` detail. Listening for the native `change` event will not fire because theme selection is handled entirely inside shadow DOM.\n\n```html\n<!-- INCORRECT -->\n<script>\n document.querySelector('mds-pref-theme').addEventListener('change', (e) => {\n console.log(e.target.value); // undefined - wrong event, wrong detail shape\n });\n</script>\n\n<!-- CORRECT -->\n<script>\n document.querySelector('mds-pref-theme').addEventListener('mdsPrefThemeChange', (e) => {\n console.log(e.detail.name, e.detail.scheme);\n });\n</script>\n```\n\n#### Do Not Give the Parent and the Child Different Sizes\n\n`<mds-pref>` forwards its own `size` to all `mds-pref-*` children, on load and when it changes, and overwrites theirs: a `size` on `<mds-pref-theme>` that differs from the parent's is never shown. Set the size on the parent only.\n\n```html\n<!-- INCORRECT -->\n<mds-pref size=\"sm\">\n <mds-pref-theme size=\"md\" name=\"default\" scheme=\"all\">\n <mds-pref-theme-item label=\"Gestionale\" name=\"business\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n\n<!-- CORRECT -->\n<mds-pref size=\"sm\">\n <mds-pref-theme name=\"business\" scheme=\"all\">\n <mds-pref-theme-item label=\"Gestionale\" name=\"business\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n```\n"
29
29
  },
30
30
  "props": [
31
31
  {
@@ -137,7 +137,7 @@
137
137
  "mutable": true,
138
138
  "attr": "scheme",
139
139
  "reflectToAttr": true,
140
- "docs": "Specifies the theme scheme which can be 'light', 'dark' or 'all'\nDefault is 'all' which means this theme supporto both light and dark.\nIf you set 'light' means this theme support only light mode and will be forced and shown light colors mode only.",
140
+ "docs": "Specifies the theme scheme which can be 'light', 'dark' or 'all'\nDefault is 'all' which means this theme supporto both light and dark.\nIf you set 'light' means this theme support only light mode and will be forced and shown light colors mode only.\nA theme whose stylesheet declares one mode (`--magma-color-modes`, from `color.modes` of its\nfile) is applied in that mode whatever this says: the theme's own lock wins.",
141
141
  "docsTags": [
142
142
  {
143
143
  "name": "default",
@@ -244,7 +244,7 @@
244
244
  },
245
245
  "cancelable": true,
246
246
  "composed": true,
247
- "docs": "Emits when the component changes the language selected from the click event of the dropdown list item",
247
+ "docs": "Emits when the component changes the language selected from the click event of the dropdown list item.\nIts `scheme` is the one the theme is applied with: the mode the theme declares, when it\ndeclares one, or else the scheme of the item.",
248
248
  "docsTags": []
249
249
  }
250
250
  ],
@@ -282,8 +282,8 @@
282
282
  "mds-button"
283
283
  ],
284
284
  "mds-button": [
285
- "mds-spinner",
286
285
  "mds-icon",
286
+ "mds-spinner",
287
287
  "mds-text"
288
288
  ]
289
289
  },
@@ -11,30 +11,27 @@ Correct and idiomatic ways to use the `<mds-pref-theme>` component, ordered from
11
11
 
12
12
  #### Basic Theme Chooser
13
13
 
14
- The canonical form. Place `<mds-pref-theme>` inside [`<mds-pref>`](../mds-pref/AGENTS.md) and populate its default slot with one [`<mds-pref-theme-item>`](../mds-pref-theme-item/AGENTS.md) per available theme. The item whose `name` matches the active theme (the stored choice, or the parent's `name` on a first visit) starts as selected. The named themes are `cool` and `warm`; `default` is the base theme.
14
+ The canonical form. Place `<mds-pref-theme>` inside [`<mds-pref>`](../mds-pref/AGENTS.md) and populate its default slot with one [`<mds-pref-theme-item>`](../mds-pref-theme-item/AGENTS.md) per available theme. The item whose `name` matches the active theme (the stored choice, or the parent's `name` on a first visit) starts as selected. The named themes are `business`, the base theme of the management software, and `editorial`, the theme of the publishing side.
15
15
 
16
16
  ```html
17
17
  <mds-pref>
18
- <mds-pref-theme name="default" scheme="all">
19
- <mds-pref-theme-item label="Predefinito" name="default" scheme="all"></mds-pref-theme-item>
20
- <mds-pref-theme-item label="Freddo" name="cool" scheme="all"></mds-pref-theme-item>
21
- <mds-pref-theme-item label="Caldo" name="warm" scheme="all"></mds-pref-theme-item>
18
+ <mds-pref-theme name="business" scheme="all">
19
+ <mds-pref-theme-item label="Gestionale" name="business" scheme="all"></mds-pref-theme-item>
20
+ <mds-pref-theme-item label="Editoriale" name="editorial" scheme="all"></mds-pref-theme-item>
22
21
  </mds-pref-theme>
23
22
  </mds-pref>
24
23
  ```
25
24
 
26
25
  #### Scheme-Constrained Themes
27
26
 
28
- Use `scheme="light"` or `scheme="dark"` on a `<mds-pref-theme-item>` when the theme must be offered in one colour mode only. The parent component propagates the chosen scheme to `<html>` and forces that mode even if the user's OS or mode preference asks for the opposite; inside `<mds-pref>` the forbidden item of `<mds-pref-mode>` is locked.
27
+ A theme made for one colour mode says so in its file (`"modes": ["dark"]` in `color`), and the component applies it in that mode with no attribute on the item. For a theme whose file says nothing, use `scheme="light"` or `scheme="dark"` on a `<mds-pref-theme-item>`. Either way the component writes the scheme on `<html>` and forces that mode even if the user's OS or mode preference asks for the opposite, and `<mds-pref-mode>` shows that mode with its other items locked.
29
28
 
30
29
  ```html
31
30
  <mds-pref>
32
- <mds-pref-theme name="default" scheme="all">
33
- <mds-pref-theme-item label="Predefinito" name="default" scheme="all"></mds-pref-theme-item>
31
+ <mds-pref-theme name="business" scheme="all">
32
+ <mds-pref-theme-item label="Gestionale" name="business" scheme="all"></mds-pref-theme-item>
34
33
  <!-- light only - dark mode will not activate with this item -->
35
- <mds-pref-theme-item label="Freddo chiaro" name="cool" scheme="light"></mds-pref-theme-item>
36
- <!-- dark only -->
37
- <mds-pref-theme-item label="Caldo scuro" name="warm" scheme="dark"></mds-pref-theme-item>
34
+ <mds-pref-theme-item label="Editoriale chiaro" name="editorial" scheme="light"></mds-pref-theme-item>
38
35
  </mds-pref-theme>
39
36
  </mds-pref>
40
37
  ```
@@ -45,9 +42,9 @@ React to the user's selection via `mdsPrefThemeChange`. The event detail carries
45
42
 
46
43
  ```html
47
44
  <mds-pref>
48
- <mds-pref-theme id="theme-chooser" name="default" scheme="all">
49
- <mds-pref-theme-item label="Predefinito" name="default" scheme="all"></mds-pref-theme-item>
50
- <mds-pref-theme-item label="Freddo" name="cool" scheme="all"></mds-pref-theme-item>
45
+ <mds-pref-theme id="theme-chooser" name="business" scheme="all">
46
+ <mds-pref-theme-item label="Gestionale" name="business" scheme="all"></mds-pref-theme-item>
47
+ <mds-pref-theme-item label="Editoriale" name="editorial" scheme="all"></mds-pref-theme-item>
51
48
  </mds-pref-theme>
52
49
  </mds-pref>
53
50
 
@@ -64,10 +61,10 @@ Use the `name` prop to declare which theme should be active before the user make
64
61
 
65
62
  ```html
66
63
  <mds-pref>
67
- <!-- First-visit default is "warm" -->
68
- <mds-pref-theme name="warm" scheme="all">
69
- <mds-pref-theme-item label="Predefinito" name="default" scheme="all"></mds-pref-theme-item>
70
- <mds-pref-theme-item label="Caldo" name="warm" scheme="all"></mds-pref-theme-item>
64
+ <!-- First-visit default is "editorial" -->
65
+ <mds-pref-theme name="editorial" scheme="all">
66
+ <mds-pref-theme-item label="Gestionale" name="business" scheme="all"></mds-pref-theme-item>
67
+ <mds-pref-theme-item label="Editoriale" name="editorial" scheme="all"></mds-pref-theme-item>
71
68
  </mds-pref-theme>
72
69
  </mds-pref>
73
70
  ```
@@ -78,9 +75,9 @@ Pass `size="sm"` when the preferences panel must fit a compact layout: on `<mds-
78
75
 
79
76
  ```html
80
77
  <mds-pref size="sm">
81
- <mds-pref-theme name="default" scheme="all">
82
- <mds-pref-theme-item label="Predefinito" name="default" scheme="all"></mds-pref-theme-item>
83
- <mds-pref-theme-item label="Freddo" name="cool" scheme="all"></mds-pref-theme-item>
78
+ <mds-pref-theme name="business" scheme="all">
79
+ <mds-pref-theme-item label="Gestionale" name="business" scheme="all"></mds-pref-theme-item>
80
+ <mds-pref-theme-item label="Editoriale" name="editorial" scheme="all"></mds-pref-theme-item>
84
81
  </mds-pref-theme>
85
82
  </mds-pref>
86
83
  ```
@@ -1,7 +1,7 @@
1
1
  import { Build, forceUpdate, Host, h, } from "@stencil/core";
2
2
  import { preferenceCornerShapeChoiceType, } from "../../type/preference";
3
3
  import { Locale } from "../../common/locale";
4
- import { MODE_VALUES, preferenceStore } from "../../common/preference";
4
+ import { COLOR_MODES_PROPERTY, MODE_VALUES, lockedSchemeOf, preferenceStore, } from "../../common/preference";
5
5
  import { labelFromName } from "../../common/string";
6
6
  import localeEl from "./meta/locale.el.json";
7
7
  import localeEn from "./meta/locale.en.json";
@@ -9,6 +9,15 @@ import localeEs from "./meta/locale.es.json";
9
9
  import localeIt from "./meta/locale.it.json";
10
10
  import miBaselineKeyboardArrowDown from "@icon/mi/baseline/keyboard-arrow-down.svg";
11
11
  import miBaselineKeyboardArrowUp from "@icon/mi/baseline/keyboard-arrow-up.svg";
12
+ /**
13
+ * `default` is the old name of `business`, the base theme (the `themes` map of
14
+ * semantic.config.ts, #692): the same theme, so an item of either name stands for it. The
15
+ * component keeps `default` as the default of `name` until the next major makes it `business`.
16
+ */
17
+ const sameTheme = (a, b) => {
18
+ const base = (name) => (name === 'default' ? 'business' : name);
19
+ return base(a) === base(b);
20
+ };
12
21
  /**
13
22
  * @slot - Add `mds-pref-theme-item` element/s.
14
23
  * @category preferences
@@ -44,6 +53,8 @@ export class MdsPrefTheme {
44
53
  * Specifies the theme scheme which can be 'light', 'dark' or 'all'
45
54
  * Default is 'all' which means this theme supporto both light and dark.
46
55
  * If you set 'light' means this theme support only light mode and will be forced and shown light colors mode only.
56
+ * A theme whose stylesheet declares one mode (`--magma-color-modes`, from `color.modes` of its
57
+ * file) is applied in that mode whatever this says: the theme's own lock wins.
47
58
  */
48
59
  this.scheme = 'all';
49
60
  /**
@@ -71,7 +82,7 @@ export class MdsPrefTheme {
71
82
  * shows it, or, when no item matches, the label an item derives from the name.
72
83
  */
73
84
  this.triggerLabel = () => {
74
- const item = Array.from(this.element.querySelectorAll('mds-pref-theme-item')).find((element) => { var _a, _b; return ((_b = (_a = element.name) !== null && _a !== void 0 ? _a : element.getAttribute('name')) !== null && _b !== void 0 ? _b : 'default') === this.name; });
85
+ const item = Array.from(this.element.querySelectorAll('mds-pref-theme-item')).find((element) => { var _a, _b; return sameTheme((_b = (_a = element.name) !== null && _a !== void 0 ? _a : element.getAttribute('name')) !== null && _b !== void 0 ? _b : 'default', this.name); });
75
86
  return (item === null || item === void 0 ? void 0 : item.label) || (item === null || item === void 0 ? void 0 : item.getAttribute('label')) || labelFromName(this.name);
76
87
  };
77
88
  this.toggleDropdown = () => {
@@ -89,9 +100,26 @@ export class MdsPrefTheme {
89
100
  this.checkThemeSelect = () => {
90
101
  this.themeItems = this.element.querySelectorAll('mds-pref-theme-item');
91
102
  this.themeItems.forEach((element) => {
92
- element.selected = element.name === this.name;
103
+ element.selected = sameTheme(element.name, this.name);
93
104
  });
94
105
  };
106
+ /**
107
+ * The scheme a theme is applied with: the one mode its stylesheet declares on `<html>`
108
+ * (`--magma-color-modes`, printed from `color.modes` of the theme file, #1274), or else the
109
+ * scheme of the item or the prop. The theme's lock wins over the item's: its colours are made
110
+ * for that mode, and a product that keeps the theme in a file does not repeat it on every
111
+ * item. The declaration lives under `:root[data-theme-name]`, so the name is written first;
112
+ * the stylesheet of the theme has to be on the page when the theme is applied.
113
+ */
114
+ this.appliedSchemeOf = (name, scheme) => {
115
+ var _a;
116
+ if (!Build.isBrowser || typeof getComputedStyle !== 'function')
117
+ return scheme;
118
+ const html = document.documentElement;
119
+ if (html.getAttribute('data-theme-name') !== name)
120
+ html.setAttribute('data-theme-name', name);
121
+ return (_a = lockedSchemeOf(getComputedStyle(html).getPropertyValue(COLOR_MODES_PROPERTY))) !== null && _a !== void 0 ? _a : scheme;
122
+ };
95
123
  this.setTheme = (name, scheme) => {
96
124
  // a theme the component cannot write is ignored, neither applied nor stored: it used to throw,
97
125
  // and an unknown scheme was written as a class named `undefined` and stored (#825)
@@ -105,10 +133,13 @@ export class MdsPrefTheme {
105
133
  }
106
134
  this.name = name;
107
135
  this.scheme = scheme;
136
+ // the scheme it is applied with; the storage keeps the pick, so a theme that stops declaring
137
+ // a mode is not held to it by an old visit
138
+ const applied = this.appliedSchemeOf(name, scheme);
108
139
  // every render comes here (the storage is read again, so a pick made in another instance is
109
140
  // followed): only a change is applied and announced, and the first application, the one of
110
141
  // load, is no change. It used to emit mdsPrefChange on every render
111
- const theme = `${name}/${scheme}`;
142
+ const theme = `${name}/${applied}`;
112
143
  if (theme === this.appliedTheme)
113
144
  return;
114
145
  const isFirstApplication = this.appliedTheme === undefined;
@@ -128,13 +159,13 @@ export class MdsPrefTheme {
128
159
  }
129
160
  // set new selection
130
161
  element === null || element === void 0 ? void 0 : element.setAttribute('data-theme-name', this.name);
131
- element === null || element === void 0 ? void 0 : element.classList.add(this.schemeSet[this.scheme]);
162
+ element === null || element === void 0 ? void 0 : element.classList.add(this.schemeSet[applied]);
132
163
  element === null || element === void 0 ? void 0 : element.classList.add(this.clasNameThemeNamePrefix + this.name);
133
164
  element === null || element === void 0 ? void 0 : element.style.setProperty(this.customPropertyAliasThemeName, this.name);
134
- element === null || element === void 0 ? void 0 : element.style.setProperty(this.customPropertyAliasThemeScheme, this.scheme);
165
+ element === null || element === void 0 ? void 0 : element.style.setProperty(this.customPropertyAliasThemeScheme, applied);
135
166
  this.previousName = this.name;
136
167
  }
137
- preferenceStore.state['theme-scheme'] = this.scheme;
168
+ preferenceStore.state['theme-scheme'] = applied;
138
169
  if (!isFirstApplication) {
139
170
  this.prefChangeEvent.emit({ preference: 'theme' });
140
171
  }
@@ -243,12 +274,13 @@ export class MdsPrefTheme {
243
274
  this.currentSelectedItem.selected = true;
244
275
  const name = e.detail.name.toLowerCase();
245
276
  const scheme = e.detail.scheme.toLowerCase();
246
- this.themeChangeEvent.emit({ name, scheme });
277
+ const applied = this.isThemeName(name) && this.isScheme(scheme) ? this.appliedSchemeOf(name, scheme) : scheme;
278
+ this.themeChangeEvent.emit({ name, scheme: applied });
247
279
  this.showDropdown = false;
248
280
  this.setTheme(name, scheme);
249
281
  }
250
282
  render() {
251
- return (h(Host, { key: '1db386671b7cfe5dc72b394d2e6a72ec4652a6eb' }, h("div", { key: 'b7310d70f4070deadac9f3c6f5f388d28e001da7', class: "menu" }, h("mds-text", { key: 'e5745f15f5b995f07fcce81d90a66e969c768f89', class: "info", typography: "caption" }, h("b", { key: 'e8a3c37d04d723d93affd820bc58697885298536' }, this.t.get('label'))), h("mds-tab", { key: '3ae7ba5e9228edaf52967cbf1c9f194cb78824b7', fill: true, size: this.size }, h("mds-tab-item", { key: '1e6f65a7d255450d5c20bfe413cad7dd89ea85b2', selected: true, onClick: this.toggleDropdown, expanded: this.showDropdown, id: "mds-pref-theme-nav", class: "item item--theme", "icon-position": "right", icon: this.showDropdown ? miBaselineKeyboardArrowUp : miBaselineKeyboardArrowDown, label: this.triggerLabel() }))), h("mds-dropdown", { key: '763f46b624f7b5c58a487cd5290b639e00c2a86a', class: "mds-pref-theme-dropdown", target: "#mds-pref-theme-nav", interaction: "none", visible: this.showDropdown, onMdsDropdownHide: this.hideThemeDropdownSelect }, h("slot", { key: '0557e6dfa086c0173c3df88fe08a8a80edf74386', onSlotchange: this.checkThemeSelect }))));
283
+ return (h(Host, { key: '26ee0d61dcf219a09423183d07744e8c55c5cb05' }, h("div", { key: '5b55c53ff22aba209b439c2d7d51c3af82895152', class: "menu" }, h("mds-text", { key: 'e5d36eda50c4b888377462f06f2ae8f827ce660d', class: "info", typography: "caption" }, h("b", { key: '345ae8662fef033984b75c60e5d486dfab191698' }, this.t.get('label'))), h("mds-tab", { key: 'b9d3bdcbe035074713a0c4b3cd228b3af795001f', fill: true, size: this.size }, h("mds-tab-item", { key: '808108b0564d2a9226f1d3c5d9a449c955b3ebc1', selected: true, onClick: this.toggleDropdown, expanded: this.showDropdown, id: "mds-pref-theme-nav", class: "item item--theme", "icon-position": "right", icon: this.showDropdown ? miBaselineKeyboardArrowUp : miBaselineKeyboardArrowDown, label: this.triggerLabel() }))), h("mds-dropdown", { key: '56773841f7f3392b5328e1df9cc42121c802654f', class: "mds-pref-theme-dropdown", target: "#mds-pref-theme-nav", interaction: "none", visible: this.showDropdown, onMdsDropdownHide: this.hideThemeDropdownSelect }, h("slot", { key: '828cbb8958e701832f6abbd840b265c086c57cd5', onSlotchange: this.checkThemeSelect }))));
252
284
  }
253
285
  static get is() { return "mds-pref-theme"; }
254
286
  static get encapsulation() { return "shadow"; }
@@ -332,7 +364,7 @@ export class MdsPrefTheme {
332
364
  "optional": false,
333
365
  "docs": {
334
366
  "tags": [],
335
- "text": "Specifies the theme scheme which can be 'light', 'dark' or 'all'\nDefault is 'all' which means this theme supporto both light and dark.\nIf you set 'light' means this theme support only light mode and will be forced and shown light colors mode only."
367
+ "text": "Specifies the theme scheme which can be 'light', 'dark' or 'all'\nDefault is 'all' which means this theme supporto both light and dark.\nIf you set 'light' means this theme support only light mode and will be forced and shown light colors mode only.\nA theme whose stylesheet declares one mode (`--magma-color-modes`, from `color.modes` of its\nfile) is applied in that mode whatever this says: the theme's own lock wins."
336
368
  },
337
369
  "getter": false,
338
370
  "setter": false,
@@ -382,7 +414,7 @@ export class MdsPrefTheme {
382
414
  "composed": true,
383
415
  "docs": {
384
416
  "tags": [],
385
- "text": "Emits when the component changes the language selected from the click event of the dropdown list item"
417
+ "text": "Emits when the component changes the language selected from the click event of the dropdown list item.\nIts `scheme` is the one the theme is applied with: the mode the theme declares, when it\ndeclares one, or else the scheme of the item."
386
418
  },
387
419
  "complexType": {
388
420
  "original": "MdsPrefThemeEventDetail",
@@ -11,18 +11,18 @@ Common incorrect uses of `<mds-pref-theme>`. Each entry pairs the wrong form wit
11
11
 
12
12
  #### Do Not Use the Component Outside `<mds-pref>`
13
13
 
14
- `<mds-pref-theme>` is a compound sub-part designed to slot inside [`<mds-pref>`](../mds-pref/AGENTS.md). As a standalone widget it still applies and persists the theme, but it leaves the panel: `<mds-pref>` can no longer forward `size` changes to it, nor lock the `<mds-pref-mode>` item that its `scheme` forbids.
14
+ `<mds-pref-theme>` is a compound sub-part designed to slot inside [`<mds-pref>`](../mds-pref/AGENTS.md). As a standalone widget it still applies and persists the theme, but it leaves the panel: `<mds-pref>` can no longer forward `size` changes to it. The lock of a single-mode theme on `<mds-pref-mode>` holds either way.
15
15
 
16
16
  ```html
17
17
  <!-- INCORRECT -->
18
- <mds-pref-theme name="default" scheme="all">
19
- <mds-pref-theme-item label="Predefinito" name="default" scheme="all"></mds-pref-theme-item>
18
+ <mds-pref-theme name="business" scheme="all">
19
+ <mds-pref-theme-item label="Gestionale" name="business" scheme="all"></mds-pref-theme-item>
20
20
  </mds-pref-theme>
21
21
 
22
22
  <!-- CORRECT -->
23
23
  <mds-pref>
24
- <mds-pref-theme name="default" scheme="all">
25
- <mds-pref-theme-item label="Predefinito" name="default" scheme="all"></mds-pref-theme-item>
24
+ <mds-pref-theme name="business" scheme="all">
25
+ <mds-pref-theme-item label="Gestionale" name="business" scheme="all"></mds-pref-theme-item>
26
26
  </mds-pref-theme>
27
27
  </mds-pref>
28
28
  ```
@@ -34,17 +34,17 @@ The default slot is reserved exclusively for `<mds-pref-theme-item>` elements. A
34
34
  ```html
35
35
  <!-- INCORRECT -->
36
36
  <mds-pref>
37
- <mds-pref-theme name="default" scheme="all">
38
- <button>Predefinito</button>
39
- <span>Estate</span>
37
+ <mds-pref-theme name="business" scheme="all">
38
+ <button>Gestionale</button>
39
+ <span>Editoriale</span>
40
40
  </mds-pref-theme>
41
41
  </mds-pref>
42
42
 
43
43
  <!-- CORRECT -->
44
44
  <mds-pref>
45
- <mds-pref-theme name="default" scheme="all">
46
- <mds-pref-theme-item label="Predefinito" name="default" scheme="all"></mds-pref-theme-item>
47
- <mds-pref-theme-item label="Freddo" name="cool" scheme="all"></mds-pref-theme-item>
45
+ <mds-pref-theme name="business" scheme="all">
46
+ <mds-pref-theme-item label="Gestionale" name="business" scheme="all"></mds-pref-theme-item>
47
+ <mds-pref-theme-item label="Editoriale" name="editorial" scheme="all"></mds-pref-theme-item>
48
48
  </mds-pref-theme>
49
49
  </mds-pref>
50
50
  ```
@@ -60,7 +60,7 @@ The `name` prop must match the pattern `^[a-z]+(-[a-z]+)*$` (lowercase letters a
60
60
  <mds-pref-theme name="MyTheme" scheme="all">...</mds-pref-theme>
61
61
 
62
62
  <!-- CORRECT -->
63
- <mds-pref-theme name="warm" scheme="all">...</mds-pref-theme>
63
+ <mds-pref-theme name="editorial" scheme="all">...</mds-pref-theme>
64
64
  ```
65
65
 
66
66
  #### Do Not Listen for the Native `change` Event
@@ -91,14 +91,14 @@ The `name` prop must match the pattern `^[a-z]+(-[a-z]+)*$` (lowercase letters a
91
91
  <!-- INCORRECT -->
92
92
  <mds-pref size="sm">
93
93
  <mds-pref-theme size="md" name="default" scheme="all">
94
- <mds-pref-theme-item label="Predefinito" name="default" scheme="all"></mds-pref-theme-item>
94
+ <mds-pref-theme-item label="Gestionale" name="business" scheme="all"></mds-pref-theme-item>
95
95
  </mds-pref-theme>
96
96
  </mds-pref>
97
97
 
98
98
  <!-- CORRECT -->
99
99
  <mds-pref size="sm">
100
- <mds-pref-theme name="default" scheme="all">
101
- <mds-pref-theme-item label="Predefinito" name="default" scheme="all"></mds-pref-theme-item>
100
+ <mds-pref-theme name="business" scheme="all">
101
+ <mds-pref-theme-item label="Gestionale" name="business" scheme="all"></mds-pref-theme-item>
102
102
  </mds-pref-theme>
103
103
  </mds-pref>
104
104
  ```
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-pref-theme-item
8
8
 
9
- > `@maggioli-design-system/magma` 2.10.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-theme-item>` web component is a single selectable theme entry inside the [`<mds-pref-theme>`](../mds-pref-theme/AGENTS.md) preference picker. It renders as a borderless button that pairs a color-swatch preview of the theme with its label.
12
12
 
@@ -16,12 +16,12 @@ The `<mds-pref-theme-item>` web component is a single selectable theme entry ins
16
16
  - **Selection is parent-driven**: On click each item emits `mdsPrefThemeItemSelect` (carrying `{ name, scheme }`), and the parent responds by clearing the siblings and selecting the clicked one. Setting `selected` directly on a single item does not coordinate the others.
17
17
  - **Click bubbles up**: The emitted event is what the parent listens to in order to apply the theme to the document and persist the choice.
18
18
  - **Auto-derived label**: If `label` is omitted, it is generated from `name` by capitalizing the first letter and replacing hyphens with spaces (e.g. `maggioli-editore` becomes `Maggioli editore`).
19
- - **Static color preview**: The four swatches (primary, success, warning, error) and the preview background are painted by the `--mds-pref-theme-item-*` CSS custom properties, not by props. Their defaults are the page's current roles (accent, the status emphases, `wash-base`), so every item shows the same swatches until you set the properties per item.
19
+ - **Preview of the theme it names**: The preview background and the primary dot show the wash and the accent of the theme named by `name`, which the styles of that theme publish as `--magma-preview-<name>-wash` and `--magma-preview-<name>-accent` (`themes.css` does for every theme Magma ships), so each item of the picker shows its own theme whatever the active one. The success, warning and error dots are the page's status emphases, which no theme retints. A theme that publishes no preview shows the active theme. The `--mds-pref-theme-item-*` CSS custom properties paint all of it and still override it.
20
20
 
21
21
  #### Properties & Visual Configurations
22
22
 
23
- - **`name`**: The theme identifier reported to the parent and matched against the parent's active `name` to compute initial selection. Use a simple or kebab-case string; the named themes are `cool` and `warm`, and `default` is the base theme ([`agents/theming.md`](../../../../agents/theming.md)). The parent validates the lowercase/kebab format and ignores an invalid name with a console warning.
24
- - **`scheme`**: Declares which color schemes the theme supports - `all` (default, both light and dark), or `light` / `dark` to force a single mode. This value travels with the selection event and is applied by the parent when the item is chosen.
23
+ - **`name`**: The theme identifier reported to the parent and matched against the parent's active `name` to compute initial selection. Use a simple or kebab-case string; the named themes are `business`, the base theme, and `editorial` ([`agents/theming.md`](../../../../agents/theming.md)). `default`, `cool` and `warm` still work and are deprecated: they leave at the next major. The parent validates the lowercase/kebab format and ignores an invalid name with a console warning.
24
+ - **`scheme`**: Declares which color schemes the theme supports - `all` (default, both light and dark), or `light` / `dark` to force a single mode. This value travels with the selection event and is applied by the parent when the item is chosen, unless the theme declares its own mode in its stylesheet (`color.modes` of its file), which wins.
25
25
  - **`selected`**: Reflects whether this item is the active theme. The parent sets it on every item when it loads and on each pick, so a value set by hand is overwritten.
26
26
 
27
27
  ## Read next
@@ -36,7 +36,7 @@ The `<mds-pref-theme-item>` web component is a single selectable theme entry ins
36
36
  | Prop | Attribute | Type | Default | Description |
37
37
  | --- | --- | --- | --- | --- |
38
38
  | `label` | `label` | `string \| undefined` | - | Specifies the theme name |
39
- | `name` | `name` | `string` | `'default'` | Specifies the theme name |
39
+ | `name` | `name` | `string` | `'default'` | Specifies the theme name; the swatch shows the preview that theme publishes, `--magma-preview-<name>-wash` and `--magma-preview-<name>-accent` |
40
40
  | `scheme` | `scheme` | `"all" \| "dark" \| "light" \| undefined` | `'all'` | Specifies the theme scheme which can be 'light', 'dark' or 'all' |
41
41
  | `selected` | `selected` | `boolean \| undefined` | `false` | Specifies if the element is selected |
42
42
 
@@ -50,7 +50,7 @@ The `<mds-pref-theme-item>` web component is a single selectable theme entry ins
50
50
 
51
51
  | Property | Description |
52
52
  | --- | --- |
53
- | `--mds-pref-theme-item-color-background` | Background color of a theme item. |
53
+ | `--mds-pref-theme-item-color-background` | Background color of a theme item: the wash of the theme it names. |
54
54
 
55
55
  Only these are public. Its other 4 are internal: they may change in any release, do not set them.
56
56