@maggioli-design-system/magma 2.10.0 → 2.11.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 (502) hide show
  1. package/AGENTS.md +1 -1
  2. package/CHANGELOG.md +21 -0
  3. package/README.md +7 -3
  4. package/agents/assets.md +1 -1
  5. package/agents/color.md +2 -2
  6. package/agents/mcp.md +1 -1
  7. package/agents/patterns/previews/actions/banner.dark.webp +0 -0
  8. package/agents/patterns/previews/actions/banner.light.webp +0 -0
  9. package/agents/patterns/previews/actions/confirm.dark.webp +0 -0
  10. package/agents/patterns/previews/actions/confirm.light.webp +0 -0
  11. package/agents/patterns/previews/actions/danger-zone.dark.webp +0 -0
  12. package/agents/patterns/previews/actions/danger-zone.light.webp +0 -0
  13. package/agents/patterns/previews/actions/destructive-in-menu.dark.webp +0 -0
  14. package/agents/patterns/previews/actions/destructive-in-menu.light.webp +0 -0
  15. package/agents/patterns/previews/actions/dismiss-message.dark.webp +0 -0
  16. package/agents/patterns/previews/actions/dismiss-message.light.webp +0 -0
  17. package/agents/patterns/previews/actions/dismiss.dark.webp +0 -0
  18. package/agents/patterns/previews/actions/dismiss.light.webp +0 -0
  19. package/agents/patterns/previews/actions/more-in-menu.dark.webp +0 -0
  20. package/agents/patterns/previews/actions/more-in-menu.light.webp +0 -0
  21. package/agents/patterns/previews/actions/part-primary.dark.webp +0 -0
  22. package/agents/patterns/previews/actions/part-primary.light.webp +0 -0
  23. package/agents/patterns/previews/actions/primary.dark.webp +0 -0
  24. package/agents/patterns/previews/actions/primary.light.webp +0 -0
  25. package/agents/patterns/previews/actions/remove.dark.webp +0 -0
  26. package/agents/patterns/previews/actions/remove.light.webp +0 -0
  27. package/agents/patterns/previews/actions/secondary.dark.webp +0 -0
  28. package/agents/patterns/previews/actions/secondary.light.webp +0 -0
  29. package/agents/patterns/previews/actions/stacked.dark.webp +0 -0
  30. package/agents/patterns/previews/actions/stacked.light.webp +0 -0
  31. package/agents/patterns/previews/actions/toast.dark.webp +0 -0
  32. package/agents/patterns/previews/actions/toast.light.webp +0 -0
  33. package/agents/patterns/previews/app-shell/back-office.dark.webp +0 -0
  34. package/agents/patterns/previews/app-shell/back-office.light.webp +0 -0
  35. package/agents/patterns/previews/app-shell/many-sections.dark.webp +0 -0
  36. package/agents/patterns/previews/app-shell/many-sections.light.webp +0 -0
  37. package/agents/patterns/previews/app-shell/public-service.dark.webp +0 -0
  38. package/agents/patterns/previews/app-shell/public-service.light.webp +0 -0
  39. package/agents/patterns/previews/confirm-action/act-then-undo.dark.webp +0 -0
  40. package/agents/patterns/previews/confirm-action/act-then-undo.light.webp +0 -0
  41. package/agents/patterns/previews/confirm-action/ask-before-sending.dark.webp +0 -0
  42. package/agents/patterns/previews/confirm-action/ask-before-sending.light.webp +0 -0
  43. package/agents/patterns/previews/confirm-action/ask-first-many.dark.webp +0 -0
  44. package/agents/patterns/previews/confirm-action/ask-first-many.light.webp +0 -0
  45. package/agents/patterns/previews/confirm-action/ask-first.dark.webp +0 -0
  46. package/agents/patterns/previews/confirm-action/ask-first.light.webp +0 -0
  47. package/agents/patterns/previews/confirm-action/make-reversible.dark.webp +0 -0
  48. package/agents/patterns/previews/confirm-action/make-reversible.light.webp +0 -0
  49. package/agents/patterns/previews/confirm-action/send-as-shown.dark.webp +0 -0
  50. package/agents/patterns/previews/confirm-action/send-as-shown.light.webp +0 -0
  51. package/agents/patterns/previews/empty-state/add-the-first.dark.webp +0 -0
  52. package/agents/patterns/previews/empty-state/add-the-first.light.webp +0 -0
  53. package/agents/patterns/previews/empty-state/all-done.dark.webp +0 -0
  54. package/agents/patterns/previews/empty-state/all-done.light.webp +0 -0
  55. package/agents/patterns/previews/empty-state/clear-filters.dark.webp +0 -0
  56. package/agents/patterns/previews/empty-state/clear-filters.light.webp +0 -0
  57. package/agents/patterns/previews/empty-state/filled-by-others.dark.webp +0 -0
  58. package/agents/patterns/previews/empty-state/filled-by-others.light.webp +0 -0
  59. package/agents/patterns/previews/empty-state/not-found.dark.webp +0 -0
  60. package/agents/patterns/previews/empty-state/not-found.light.webp +0 -0
  61. package/agents/patterns/previews/empty-state/one-line.dark.webp +0 -0
  62. package/agents/patterns/previews/empty-state/one-line.light.webp +0 -0
  63. package/agents/patterns/previews/error-recovery/action-another-way.dark.webp +0 -0
  64. package/agents/patterns/previews/error-recovery/action-another-way.light.webp +0 -0
  65. package/agents/patterns/previews/error-recovery/changed-meanwhile.dark.webp +0 -0
  66. package/agents/patterns/previews/error-recovery/changed-meanwhile.light.webp +0 -0
  67. package/agents/patterns/previews/error-recovery/check-or-repeat.dark.webp +0 -0
  68. package/agents/patterns/previews/error-recovery/check-or-repeat.light.webp +0 -0
  69. package/agents/patterns/previews/error-recovery/content-another-way.dark.webp +0 -0
  70. package/agents/patterns/previews/error-recovery/content-another-way.light.webp +0 -0
  71. package/agents/patterns/previews/error-recovery/partial.dark.webp +0 -0
  72. package/agents/patterns/previews/error-recovery/partial.light.webp +0 -0
  73. package/agents/patterns/previews/error-recovery/retry-action.dark.webp +0 -0
  74. package/agents/patterns/previews/error-recovery/retry-action.light.webp +0 -0
  75. package/agents/patterns/previews/error-recovery/retry-content.dark.webp +0 -0
  76. package/agents/patterns/previews/error-recovery/retry-content.light.webp +0 -0
  77. package/agents/patterns/previews/error-recovery/sign-in-again.dark.webp +0 -0
  78. package/agents/patterns/previews/error-recovery/sign-in-again.light.webp +0 -0
  79. package/agents/patterns/previews/item-list/documents-of-a-request.dark.webp +0 -0
  80. package/agents/patterns/previews/item-list/documents-of-a-request.light.webp +0 -0
  81. package/agents/patterns/previews/item-list/queue-of-a-desk.dark.webp +0 -0
  82. package/agents/patterns/previews/item-list/queue-of-a-desk.light.webp +0 -0
  83. package/agents/patterns/previews/item-list/requests-of-an-office.dark.webp +0 -0
  84. package/agents/patterns/previews/item-list/requests-of-an-office.light.webp +0 -0
  85. package/agents/patterns/previews/item-list/requests-to-assign.dark.webp +0 -0
  86. package/agents/patterns/previews/item-list/requests-to-assign.light.webp +0 -0
  87. package/agents/patterns/previews/labels-and-values/data-of-a-contact.dark.webp +0 -0
  88. package/agents/patterns/previews/labels-and-values/data-of-a-contact.light.webp +0 -0
  89. package/agents/patterns/previews/labels-and-values/payment-before-paying.dark.webp +0 -0
  90. package/agents/patterns/previews/labels-and-values/payment-before-paying.light.webp +0 -0
  91. package/agents/patterns/previews/labels-and-values/what-is-sent.dark.webp +0 -0
  92. package/agents/patterns/previews/labels-and-values/what-is-sent.light.webp +0 -0
  93. package/agents/patterns/previews/list-with-filters/act-on-many.dark.webp +0 -0
  94. package/agents/patterns/previews/list-with-filters/act-on-many.light.webp +0 -0
  95. package/agents/patterns/previews/list-with-filters/find-and-open.dark.webp +0 -0
  96. package/agents/patterns/previews/list-with-filters/find-and-open.light.webp +0 -0
  97. package/agents/patterns/previews/list-with-filters/show-new-items.dark.webp +0 -0
  98. package/agents/patterns/previews/list-with-filters/show-new-items.light.webp +0 -0
  99. package/agents/patterns/previews/loading/await-and-say.dark.webp +0 -0
  100. package/agents/patterns/previews/loading/await-and-say.light.webp +0 -0
  101. package/agents/patterns/previews/loading/await-the-control.dark.webp +0 -0
  102. package/agents/patterns/previews/loading/await-the-control.light.webp +0 -0
  103. package/agents/patterns/previews/loading/first-load.dark.webp +0 -0
  104. package/agents/patterns/previews/loading/first-load.light.webp +0 -0
  105. package/agents/patterns/previews/loading/keep-while-reloading.dark.webp +0 -0
  106. package/agents/patterns/previews/loading/keep-while-reloading.light.webp +0 -0
  107. package/agents/patterns/previews/loading/long-load-measured.dark.webp +0 -0
  108. package/agents/patterns/previews/loading/long-load-measured.light.webp +0 -0
  109. package/agents/patterns/previews/loading/long-load.dark.webp +0 -0
  110. package/agents/patterns/previews/loading/long-load.light.webp +0 -0
  111. package/agents/patterns/previews/loading/progress-in-place.dark.webp +0 -0
  112. package/agents/patterns/previews/loading/progress-in-place.light.webp +0 -0
  113. package/agents/patterns/previews/loading/run-in-background.dark.webp +0 -0
  114. package/agents/patterns/previews/loading/run-in-background.light.webp +0 -0
  115. package/agents/patterns/previews/message-placement/action-done-elsewhere.dark.webp +0 -0
  116. package/agents/patterns/previews/message-placement/action-done-elsewhere.light.webp +0 -0
  117. package/agents/patterns/previews/message-placement/action-done-in-page.dark.webp +0 -0
  118. package/agents/patterns/previews/message-placement/action-done-in-page.light.webp +0 -0
  119. package/agents/patterns/previews/message-placement/action-done-in-part.dark.webp +0 -0
  120. package/agents/patterns/previews/message-placement/action-done-in-part.light.webp +0 -0
  121. package/agents/patterns/previews/message-placement/action-failed-elsewhere.dark.webp +0 -0
  122. package/agents/patterns/previews/message-placement/action-failed-elsewhere.light.webp +0 -0
  123. package/agents/patterns/previews/message-placement/action-failed-in-place.dark.webp +0 -0
  124. package/agents/patterns/previews/message-placement/action-failed-in-place.light.webp +0 -0
  125. package/agents/patterns/previews/message-placement/action-later.dark.webp +0 -0
  126. package/agents/patterns/previews/message-placement/action-later.light.webp +0 -0
  127. package/agents/patterns/previews/message-placement/action-partial-elsewhere.dark.webp +0 -0
  128. package/agents/patterns/previews/message-placement/action-partial-elsewhere.light.webp +0 -0
  129. package/agents/patterns/previews/message-placement/action-partial-in-place.dark.webp +0 -0
  130. package/agents/patterns/previews/message-placement/action-partial-in-place.light.webp +0 -0
  131. package/agents/patterns/previews/message-placement/action-taken.dark.webp +0 -0
  132. package/agents/patterns/previews/message-placement/action-taken.light.webp +0 -0
  133. package/agents/patterns/previews/message-placement/app-deadline.dark.webp +0 -0
  134. package/agents/patterns/previews/message-placement/app-deadline.light.webp +0 -0
  135. package/agents/patterns/previews/message-placement/app-failed.dark.webp +0 -0
  136. package/agents/patterns/previews/message-placement/app-failed.light.webp +0 -0
  137. package/agents/patterns/previews/message-placement/app-info.dark.webp +0 -0
  138. package/agents/patterns/previews/message-placement/app-info.light.webp +0 -0
  139. package/agents/patterns/previews/message-placement/decision.dark.webp +0 -0
  140. package/agents/patterns/previews/message-placement/decision.light.webp +0 -0
  141. package/agents/patterns/previews/message-placement/field-error.dark.webp +0 -0
  142. package/agents/patterns/previews/message-placement/field-error.light.webp +0 -0
  143. package/agents/patterns/previews/message-placement/field-hint.dark.webp +0 -0
  144. package/agents/patterns/previews/message-placement/field-hint.light.webp +0 -0
  145. package/agents/patterns/previews/message-placement/field-valid.dark.webp +0 -0
  146. package/agents/patterns/previews/message-placement/field-valid.light.webp +0 -0
  147. package/agents/patterns/previews/message-placement/region-failed.dark.webp +0 -0
  148. package/agents/patterns/previews/message-placement/region-failed.light.webp +0 -0
  149. package/agents/patterns/previews/message-placement/region-info.dark.webp +0 -0
  150. package/agents/patterns/previews/message-placement/region-info.light.webp +0 -0
  151. package/agents/patterns/previews/page-header/contact-being-edited.dark.webp +0 -0
  152. package/agents/patterns/previews/page-header/contact-being-edited.light.webp +0 -0
  153. package/agents/patterns/previews/page-header/members-of-a-group.dark.webp +0 -0
  154. package/agents/patterns/previews/page-header/members-of-a-group.light.webp +0 -0
  155. package/agents/patterns/previews/page-header/own-profile.dark.webp +0 -0
  156. package/agents/patterns/previews/page-header/own-profile.light.webp +0 -0
  157. package/agents/patterns/previews/page-header/request-from-the-list.dark.webp +0 -0
  158. package/agents/patterns/previews/page-header/request-from-the-list.light.webp +0 -0
  159. package/agents/patterns/previews/page-header/requests-of-an-office.dark.webp +0 -0
  160. package/agents/patterns/previews/page-header/requests-of-an-office.light.webp +0 -0
  161. package/agents/patterns/previews/record-detail/ask-for-words.dark.webp +0 -0
  162. package/agents/patterns/previews/record-detail/ask-for-words.light.webp +0 -0
  163. package/agents/patterns/previews/record-detail/edit-data.dark.webp +0 -0
  164. package/agents/patterns/previews/record-detail/edit-data.light.webp +0 -0
  165. package/agents/patterns/previews/record-detail/read-the-data.dark.webp +0 -0
  166. package/agents/patterns/previews/record-detail/read-the-data.light.webp +0 -0
  167. package/agents/patterns/previews/record-detail/record-changed.dark.webp +0 -0
  168. package/agents/patterns/previews/record-detail/record-changed.light.webp +0 -0
  169. package/agents/patterns/previews/record-detail/run-at-once.dark.webp +0 -0
  170. package/agents/patterns/previews/record-detail/run-at-once.light.webp +0 -0
  171. package/agents/patterns/previews/record-detail/work-on-it.dark.webp +0 -0
  172. package/agents/patterns/previews/record-detail/work-on-it.light.webp +0 -0
  173. package/agents/patterns/previews/rhythm/between-containers.dark.webp +0 -0
  174. package/agents/patterns/previews/rhythm/between-containers.light.webp +0 -0
  175. package/agents/patterns/previews/rhythm/between-fields.dark.webp +0 -0
  176. package/agents/patterns/previews/rhythm/between-fields.light.webp +0 -0
  177. package/agents/patterns/previews/rhythm/between-groups.dark.webp +0 -0
  178. package/agents/patterns/previews/rhythm/between-groups.light.webp +0 -0
  179. package/agents/patterns/previews/rhythm/between-sections.dark.webp +0 -0
  180. package/agents/patterns/previews/rhythm/between-sections.light.webp +0 -0
  181. package/agents/patterns/previews/rhythm/content-actions.dark.webp +0 -0
  182. package/agents/patterns/previews/rhythm/content-actions.light.webp +0 -0
  183. package/agents/patterns/previews/rhythm/inline.dark.webp +0 -0
  184. package/agents/patterns/previews/rhythm/inline.light.webp +0 -0
  185. package/agents/patterns/previews/rhythm/inset.dark.webp +0 -0
  186. package/agents/patterns/previews/rhythm/inset.light.webp +0 -0
  187. package/agents/patterns/previews/rhythm/label-control.dark.webp +0 -0
  188. package/agents/patterns/previews/rhythm/label-control.light.webp +0 -0
  189. package/agents/patterns/previews/rhythm/title-content.dark.webp +0 -0
  190. package/agents/patterns/previews/rhythm/title-content.light.webp +0 -0
  191. package/agents/patterns/previews/surfaces/band.dark.webp +0 -0
  192. package/agents/patterns/previews/surfaces/band.light.webp +0 -0
  193. package/agents/patterns/previews/surfaces/canvas.dark.webp +0 -0
  194. package/agents/patterns/previews/surfaces/canvas.light.webp +0 -0
  195. package/agents/patterns/previews/surfaces/card.dark.webp +0 -0
  196. package/agents/patterns/previews/surfaces/card.light.webp +0 -0
  197. package/agents/patterns/previews/surfaces/dialog.dark.webp +0 -0
  198. package/agents/patterns/previews/surfaces/dialog.light.webp +0 -0
  199. package/agents/patterns/previews/surfaces/edit-actions.dark.webp +0 -0
  200. package/agents/patterns/previews/surfaces/edit-actions.light.webp +0 -0
  201. package/agents/patterns/previews/surfaces/section.dark.webp +0 -0
  202. package/agents/patterns/previews/surfaces/section.light.webp +0 -0
  203. package/agents/patterns/previews/titles/dialog.dark.webp +0 -0
  204. package/agents/patterns/previews/titles/dialog.light.webp +0 -0
  205. package/agents/patterns/previews/titles/group.dark.webp +0 -0
  206. package/agents/patterns/previews/titles/group.light.webp +0 -0
  207. package/agents/patterns/previews/titles/page.dark.webp +0 -0
  208. package/agents/patterns/previews/titles/page.light.webp +0 -0
  209. package/agents/patterns/previews/titles/part.dark.webp +0 -0
  210. package/agents/patterns/previews/titles/part.light.webp +0 -0
  211. package/agents/patterns/previews/titles/section.dark.webp +0 -0
  212. package/agents/patterns/previews/titles/section.light.webp +0 -0
  213. package/agents/patterns/previews/widths/dialog.dark.webp +0 -0
  214. package/agents/patterns/previews/widths/dialog.light.webp +0 -0
  215. package/agents/patterns/previews/widths/field.dark.webp +0 -0
  216. package/agents/patterns/previews/widths/field.light.webp +0 -0
  217. package/agents/patterns/previews/widths/form.dark.webp +0 -0
  218. package/agents/patterns/previews/widths/form.light.webp +0 -0
  219. package/agents/patterns/previews/widths/page.dark.webp +0 -0
  220. package/agents/patterns/previews/widths/page.light.webp +0 -0
  221. package/agents/patterns/previews/widths/reading.dark.webp +0 -0
  222. package/agents/patterns/previews/widths/reading.light.webp +0 -0
  223. package/agents/theming.md +14 -9
  224. package/dist/cjs/mds-emoji.cjs.entry.js +39 -10
  225. package/dist/cjs/mds-pref-theme-item.cjs.entry.js +18 -4
  226. package/dist/cjs/mds-pref-theme.cjs.entry.js +12 -3
  227. package/dist/collection/components/mds-accordion/AGENTS.md +1 -1
  228. package/dist/collection/components/mds-accordion/documentation.json +1 -1
  229. package/dist/collection/components/mds-accordion-item/AGENTS.md +1 -1
  230. package/dist/collection/components/mds-accordion-item/documentation.json +1 -1
  231. package/dist/collection/components/mds-accordion-timer/AGENTS.md +1 -1
  232. package/dist/collection/components/mds-accordion-timer/documentation.json +1 -1
  233. package/dist/collection/components/mds-accordion-timer-item/AGENTS.md +1 -1
  234. package/dist/collection/components/mds-accordion-timer-item/documentation.json +1 -1
  235. package/dist/collection/components/mds-author/AGENTS.md +1 -1
  236. package/dist/collection/components/mds-author/documentation.json +1 -1
  237. package/dist/collection/components/mds-avatar/AGENTS.md +1 -1
  238. package/dist/collection/components/mds-avatar/documentation.json +1 -1
  239. package/dist/collection/components/mds-avatar-stack/AGENTS.md +1 -1
  240. package/dist/collection/components/mds-avatar-stack/documentation.json +1 -1
  241. package/dist/collection/components/mds-avatar-stack-item/AGENTS.md +1 -1
  242. package/dist/collection/components/mds-avatar-stack-item/documentation.json +1 -1
  243. package/dist/collection/components/mds-badge/AGENTS.md +1 -1
  244. package/dist/collection/components/mds-badge/documentation.json +1 -1
  245. package/dist/collection/components/mds-banner/AGENTS.md +1 -1
  246. package/dist/collection/components/mds-banner/documentation.json +1 -1
  247. package/dist/collection/components/mds-benchmark-bar/AGENTS.md +1 -1
  248. package/dist/collection/components/mds-benchmark-bar/documentation.json +1 -1
  249. package/dist/collection/components/mds-bibliography/AGENTS.md +1 -1
  250. package/dist/collection/components/mds-bibliography/documentation.json +1 -1
  251. package/dist/collection/components/mds-book/AGENTS.md +1 -1
  252. package/dist/collection/components/mds-book/documentation.json +1 -1
  253. package/dist/collection/components/mds-breadcrumb/AGENTS.md +1 -1
  254. package/dist/collection/components/mds-breadcrumb/documentation.json +1 -1
  255. package/dist/collection/components/mds-breadcrumb-item/AGENTS.md +1 -1
  256. package/dist/collection/components/mds-breadcrumb-item/documentation.json +1 -1
  257. package/dist/collection/components/mds-button/AGENTS.md +1 -1
  258. package/dist/collection/components/mds-button/documentation.json +1 -1
  259. package/dist/collection/components/mds-button-dropdown/AGENTS.md +1 -1
  260. package/dist/collection/components/mds-button-dropdown/documentation.json +1 -1
  261. package/dist/collection/components/mds-button-group/AGENTS.md +1 -1
  262. package/dist/collection/components/mds-button-group/documentation.json +1 -1
  263. package/dist/collection/components/mds-calendar/AGENTS.md +1 -1
  264. package/dist/collection/components/mds-calendar/documentation.json +1 -1
  265. package/dist/collection/components/mds-calendar-cell/AGENTS.md +1 -1
  266. package/dist/collection/components/mds-calendar-cell/documentation.json +1 -1
  267. package/dist/collection/components/mds-card/AGENTS.md +1 -1
  268. package/dist/collection/components/mds-card/documentation.json +1 -1
  269. package/dist/collection/components/mds-card-content/AGENTS.md +1 -1
  270. package/dist/collection/components/mds-card-content/documentation.json +1 -1
  271. package/dist/collection/components/mds-card-footer/AGENTS.md +1 -1
  272. package/dist/collection/components/mds-card-footer/documentation.json +1 -1
  273. package/dist/collection/components/mds-card-header/AGENTS.md +1 -1
  274. package/dist/collection/components/mds-card-header/documentation.json +1 -1
  275. package/dist/collection/components/mds-card-media/AGENTS.md +1 -1
  276. package/dist/collection/components/mds-card-media/documentation.json +1 -1
  277. package/dist/collection/components/mds-chip/AGENTS.md +1 -1
  278. package/dist/collection/components/mds-chip/documentation.json +1 -1
  279. package/dist/collection/components/mds-details/AGENTS.md +1 -1
  280. package/dist/collection/components/mds-details/documentation.json +1 -1
  281. package/dist/collection/components/mds-dropdown/AGENTS.md +1 -1
  282. package/dist/collection/components/mds-dropdown/documentation.json +1 -1
  283. package/dist/collection/components/mds-emoji/AGENTS.md +1 -1
  284. package/dist/collection/components/mds-emoji/documentation.json +1 -1
  285. package/dist/collection/components/mds-entity/AGENTS.md +1 -1
  286. package/dist/collection/components/mds-entity/documentation.json +1 -1
  287. package/dist/collection/components/mds-file/AGENTS.md +1 -1
  288. package/dist/collection/components/mds-file/documentation.json +1 -1
  289. package/dist/collection/components/mds-file-preview/AGENTS.md +1 -1
  290. package/dist/collection/components/mds-file-preview/documentation.json +1 -1
  291. package/dist/collection/components/mds-filter/AGENTS.md +1 -1
  292. package/dist/collection/components/mds-filter/documentation.json +1 -1
  293. package/dist/collection/components/mds-filter-item/AGENTS.md +1 -1
  294. package/dist/collection/components/mds-filter-item/documentation.json +1 -1
  295. package/dist/collection/components/mds-header/AGENTS.md +1 -1
  296. package/dist/collection/components/mds-header/documentation.json +1 -1
  297. package/dist/collection/components/mds-header-bar/AGENTS.md +1 -1
  298. package/dist/collection/components/mds-header-bar/documentation.json +1 -1
  299. package/dist/collection/components/mds-help/AGENTS.md +1 -1
  300. package/dist/collection/components/mds-help/documentation.json +1 -1
  301. package/dist/collection/components/mds-horizontal-scroll/AGENTS.md +1 -1
  302. package/dist/collection/components/mds-horizontal-scroll/documentation.json +1 -1
  303. package/dist/collection/components/mds-hr/AGENTS.md +1 -1
  304. package/dist/collection/components/mds-hr/documentation.json +1 -1
  305. package/dist/collection/components/mds-icon/AGENTS.md +1 -1
  306. package/dist/collection/components/mds-icon/documentation.json +1 -1
  307. package/dist/collection/components/mds-img/AGENTS.md +1 -1
  308. package/dist/collection/components/mds-img/documentation.json +1 -1
  309. package/dist/collection/components/mds-input/AGENTS.md +1 -1
  310. package/dist/collection/components/mds-input/documentation.json +1 -1
  311. package/dist/collection/components/mds-input-date/AGENTS.md +1 -1
  312. package/dist/collection/components/mds-input-date/documentation.json +1 -1
  313. package/dist/collection/components/mds-input-date-range/AGENTS.md +1 -1
  314. package/dist/collection/components/mds-input-date-range/documentation.json +1 -1
  315. package/dist/collection/components/mds-input-date-range-preselection/AGENTS.md +1 -1
  316. package/dist/collection/components/mds-input-date-range-preselection/documentation.json +1 -1
  317. package/dist/collection/components/mds-input-field/AGENTS.md +1 -1
  318. package/dist/collection/components/mds-input-field/documentation.json +1 -1
  319. package/dist/collection/components/mds-input-otp/AGENTS.md +1 -1
  320. package/dist/collection/components/mds-input-otp/documentation.json +1 -1
  321. package/dist/collection/components/mds-input-range/AGENTS.md +1 -1
  322. package/dist/collection/components/mds-input-range/documentation.json +1 -1
  323. package/dist/collection/components/mds-input-select/AGENTS.md +1 -1
  324. package/dist/collection/components/mds-input-select/documentation.json +1 -1
  325. package/dist/collection/components/mds-input-switch/AGENTS.md +1 -1
  326. package/dist/collection/components/mds-input-switch/documentation.json +1 -1
  327. package/dist/collection/components/mds-input-tip/AGENTS.md +1 -1
  328. package/dist/collection/components/mds-input-tip/documentation.json +1 -1
  329. package/dist/collection/components/mds-input-tip-item/AGENTS.md +1 -1
  330. package/dist/collection/components/mds-input-tip-item/documentation.json +1 -1
  331. package/dist/collection/components/mds-input-upload/AGENTS.md +1 -1
  332. package/dist/collection/components/mds-input-upload/documentation.json +1 -1
  333. package/dist/collection/components/mds-keyboard/AGENTS.md +1 -1
  334. package/dist/collection/components/mds-keyboard/documentation.json +1 -1
  335. package/dist/collection/components/mds-keyboard-key/AGENTS.md +1 -1
  336. package/dist/collection/components/mds-keyboard-key/documentation.json +1 -1
  337. package/dist/collection/components/mds-kpi/AGENTS.md +1 -1
  338. package/dist/collection/components/mds-kpi/documentation.json +1 -1
  339. package/dist/collection/components/mds-kpi-item/AGENTS.md +1 -1
  340. package/dist/collection/components/mds-kpi-item/documentation.json +1 -1
  341. package/dist/collection/components/mds-label/AGENTS.md +1 -1
  342. package/dist/collection/components/mds-label/documentation.json +1 -1
  343. package/dist/collection/components/mds-link/AGENTS.md +1 -1
  344. package/dist/collection/components/mds-link/documentation.json +1 -1
  345. package/dist/collection/components/mds-list/AGENTS.md +1 -1
  346. package/dist/collection/components/mds-list/documentation.json +1 -1
  347. package/dist/collection/components/mds-list-item/AGENTS.md +1 -1
  348. package/dist/collection/components/mds-list-item/documentation.json +1 -1
  349. package/dist/collection/components/mds-mention/AGENTS.md +1 -1
  350. package/dist/collection/components/mds-mention/documentation.json +1 -1
  351. package/dist/collection/components/mds-modal/AGENTS.md +1 -1
  352. package/dist/collection/components/mds-modal/documentation.json +1 -1
  353. package/dist/collection/components/mds-note/AGENTS.md +1 -1
  354. package/dist/collection/components/mds-note/documentation.json +1 -1
  355. package/dist/collection/components/mds-notification/AGENTS.md +1 -1
  356. package/dist/collection/components/mds-notification/documentation.json +1 -1
  357. package/dist/collection/components/mds-paginator/AGENTS.md +1 -1
  358. package/dist/collection/components/mds-paginator/documentation.json +1 -1
  359. package/dist/collection/components/mds-paginator-item/AGENTS.md +1 -1
  360. package/dist/collection/components/mds-paginator-item/documentation.json +1 -1
  361. package/dist/collection/components/mds-policy-ai/AGENTS.md +1 -1
  362. package/dist/collection/components/mds-policy-ai/documentation.json +1 -1
  363. package/dist/collection/components/mds-pref/AGENTS.md +1 -1
  364. package/dist/collection/components/mds-pref/documentation.json +1 -1
  365. package/dist/collection/components/mds-pref-animation/AGENTS.md +1 -1
  366. package/dist/collection/components/mds-pref-animation/documentation.json +1 -1
  367. package/dist/collection/components/mds-pref-consumption/AGENTS.md +1 -1
  368. package/dist/collection/components/mds-pref-consumption/documentation.json +1 -1
  369. package/dist/collection/components/mds-pref-contrast/AGENTS.md +1 -1
  370. package/dist/collection/components/mds-pref-contrast/documentation.json +1 -1
  371. package/dist/collection/components/mds-pref-language/AGENTS.md +1 -1
  372. package/dist/collection/components/mds-pref-language/documentation.json +1 -1
  373. package/dist/collection/components/mds-pref-language-item/AGENTS.md +1 -1
  374. package/dist/collection/components/mds-pref-language-item/documentation.json +1 -1
  375. package/dist/collection/components/mds-pref-mode/AGENTS.md +1 -1
  376. package/dist/collection/components/mds-pref-mode/documentation.json +1 -1
  377. package/dist/collection/components/mds-pref-theme/AGENTS.md +2 -2
  378. package/dist/collection/components/mds-pref-theme/documentation.json +4 -4
  379. package/dist/collection/components/mds-pref-theme/examples.md +17 -20
  380. package/dist/collection/components/mds-pref-theme/mds-pref-theme.js +12 -3
  381. package/dist/collection/components/mds-pref-theme/mistakes.md +14 -14
  382. package/dist/collection/components/mds-pref-theme-item/AGENTS.md +5 -5
  383. package/dist/collection/components/mds-pref-theme-item/documentation.json +8 -8
  384. package/dist/collection/components/mds-pref-theme-item/examples.md +18 -24
  385. package/dist/collection/components/mds-pref-theme-item/mds-pref-theme-item.css +13 -7
  386. package/dist/collection/components/mds-pref-theme-item/mds-pref-theme-item.js +19 -5
  387. package/dist/collection/components/mds-pref-theme-item/mistakes.md +14 -16
  388. package/dist/collection/components/mds-price-table/AGENTS.md +1 -1
  389. package/dist/collection/components/mds-price-table/documentation.json +1 -1
  390. package/dist/collection/components/mds-price-table-features/AGENTS.md +1 -1
  391. package/dist/collection/components/mds-price-table-features/documentation.json +1 -1
  392. package/dist/collection/components/mds-price-table-features-cell/AGENTS.md +1 -1
  393. package/dist/collection/components/mds-price-table-features-cell/documentation.json +1 -1
  394. package/dist/collection/components/mds-price-table-features-row/AGENTS.md +1 -1
  395. package/dist/collection/components/mds-price-table-features-row/documentation.json +1 -1
  396. package/dist/collection/components/mds-price-table-header/AGENTS.md +1 -1
  397. package/dist/collection/components/mds-price-table-header/documentation.json +1 -1
  398. package/dist/collection/components/mds-price-table-list/AGENTS.md +1 -1
  399. package/dist/collection/components/mds-price-table-list/documentation.json +1 -1
  400. package/dist/collection/components/mds-price-table-list-item/AGENTS.md +1 -1
  401. package/dist/collection/components/mds-price-table-list-item/documentation.json +1 -1
  402. package/dist/collection/components/mds-progress/AGENTS.md +1 -1
  403. package/dist/collection/components/mds-progress/documentation.json +1 -1
  404. package/dist/collection/components/mds-push-notification/AGENTS.md +1 -1
  405. package/dist/collection/components/mds-push-notification/documentation.json +1 -1
  406. package/dist/collection/components/mds-push-notification-item/AGENTS.md +1 -1
  407. package/dist/collection/components/mds-push-notification-item/documentation.json +1 -1
  408. package/dist/collection/components/mds-quote/AGENTS.md +1 -1
  409. package/dist/collection/components/mds-quote/documentation.json +1 -1
  410. package/dist/collection/components/mds-radial-menu/AGENTS.md +1 -1
  411. package/dist/collection/components/mds-radial-menu/documentation.json +1 -1
  412. package/dist/collection/components/mds-radial-menu-item/AGENTS.md +1 -1
  413. package/dist/collection/components/mds-radial-menu-item/documentation.json +1 -1
  414. package/dist/collection/components/mds-radial-progress/AGENTS.md +1 -1
  415. package/dist/collection/components/mds-radial-progress/documentation.json +1 -1
  416. package/dist/collection/components/mds-separator/AGENTS.md +1 -1
  417. package/dist/collection/components/mds-separator/documentation.json +1 -1
  418. package/dist/collection/components/mds-spinner/AGENTS.md +1 -1
  419. package/dist/collection/components/mds-spinner/documentation.json +1 -1
  420. package/dist/collection/components/mds-status-bar/AGENTS.md +1 -1
  421. package/dist/collection/components/mds-status-bar/documentation.json +1 -1
  422. package/dist/collection/components/mds-stepper-bar/AGENTS.md +1 -1
  423. package/dist/collection/components/mds-stepper-bar/documentation.json +1 -1
  424. package/dist/collection/components/mds-stepper-bar-item/AGENTS.md +1 -1
  425. package/dist/collection/components/mds-stepper-bar-item/documentation.json +1 -1
  426. package/dist/collection/components/mds-tab/AGENTS.md +1 -1
  427. package/dist/collection/components/mds-tab/documentation.json +1 -1
  428. package/dist/collection/components/mds-tab-bar/AGENTS.md +1 -1
  429. package/dist/collection/components/mds-tab-bar/documentation.json +1 -1
  430. package/dist/collection/components/mds-tab-bar-item/AGENTS.md +1 -1
  431. package/dist/collection/components/mds-tab-bar-item/documentation.json +1 -1
  432. package/dist/collection/components/mds-tab-item/AGENTS.md +1 -1
  433. package/dist/collection/components/mds-tab-item/documentation.json +1 -1
  434. package/dist/collection/components/mds-table/AGENTS.md +1 -1
  435. package/dist/collection/components/mds-table/documentation.json +1 -1
  436. package/dist/collection/components/mds-table-body/AGENTS.md +1 -1
  437. package/dist/collection/components/mds-table-body/documentation.json +1 -1
  438. package/dist/collection/components/mds-table-cell/AGENTS.md +1 -1
  439. package/dist/collection/components/mds-table-cell/documentation.json +1 -1
  440. package/dist/collection/components/mds-table-footer/AGENTS.md +1 -1
  441. package/dist/collection/components/mds-table-footer/documentation.json +1 -1
  442. package/dist/collection/components/mds-table-header/AGENTS.md +1 -1
  443. package/dist/collection/components/mds-table-header/documentation.json +1 -1
  444. package/dist/collection/components/mds-table-header-cell/AGENTS.md +1 -1
  445. package/dist/collection/components/mds-table-header-cell/documentation.json +1 -1
  446. package/dist/collection/components/mds-table-row/AGENTS.md +1 -1
  447. package/dist/collection/components/mds-table-row/documentation.json +1 -1
  448. package/dist/collection/components/mds-text/AGENTS.md +1 -1
  449. package/dist/collection/components/mds-text/documentation.json +1 -1
  450. package/dist/collection/components/mds-toast/AGENTS.md +1 -1
  451. package/dist/collection/components/mds-toast/documentation.json +1 -1
  452. package/dist/collection/components/mds-toast-region/AGENTS.md +1 -1
  453. package/dist/collection/components/mds-toast-region/documentation.json +1 -1
  454. package/dist/collection/components/mds-tooltip/AGENTS.md +1 -1
  455. package/dist/collection/components/mds-tooltip/documentation.json +1 -1
  456. package/dist/collection/components/mds-tree/AGENTS.md +1 -1
  457. package/dist/collection/components/mds-tree/documentation.json +1 -1
  458. package/dist/collection/components/mds-tree-item/AGENTS.md +1 -1
  459. package/dist/collection/components/mds-tree-item/documentation.json +1 -1
  460. package/dist/collection/components/mds-url-view/AGENTS.md +1 -1
  461. package/dist/collection/components/mds-url-view/documentation.json +1 -1
  462. package/dist/collection/components/mds-usage/AGENTS.md +1 -1
  463. package/dist/collection/components/mds-usage/documentation.json +1 -1
  464. package/dist/collection/components/mds-video-wall/AGENTS.md +1 -1
  465. package/dist/collection/components/mds-video-wall/documentation.json +1 -1
  466. package/dist/collection/components/mds-zero/AGENTS.md +1 -1
  467. package/dist/collection/components/mds-zero/documentation.json +1 -1
  468. package/dist/components/mds-emoji.js +3 -3
  469. package/dist/components/mds-pref-theme-item.js +1 -1
  470. package/dist/components/mds-pref-theme.js +1 -1
  471. package/dist/documentation.json +11 -11
  472. package/dist/esm/mds-emoji.entry.js +39 -10
  473. package/dist/esm/mds-pref-theme-item.entry.js +18 -4
  474. package/dist/esm/mds-pref-theme.entry.js +12 -3
  475. package/dist/esm-es5/mds-emoji.entry.js +109 -107
  476. package/dist/esm-es5/mds-pref-theme-item.entry.js +12 -5
  477. package/dist/esm-es5/mds-pref-theme.entry.js +9 -4
  478. package/dist/hydrate/index.js +69 -17
  479. package/dist/hydrate/index.mjs +69 -17
  480. package/dist/lint/core/patterns.d.ts +30 -0
  481. package/dist/lint/core/patterns.js +90 -0
  482. package/dist/lint/mcp/patterns.js +21 -11
  483. package/dist/lint/mcp/render-page.d.ts +5 -1
  484. package/dist/lint/mcp/render-page.js +17 -0
  485. package/dist/lint/mcp/render.d.ts +22 -1
  486. package/dist/lint/mcp/render.js +101 -20
  487. package/dist/lint/mcp/tools.json +2 -2
  488. package/dist/magma-components/magma-components.esm.js +1 -1
  489. package/dist/magma-components/{p-0dcde20a.system.entry.js → p-2a445b98.system.entry.js} +15 -13
  490. package/dist/magma-components/p-97c6e10a.entry.js +1 -0
  491. package/dist/magma-components/{p-4e072e24.system.entry.js → p-9e07535e.system.entry.js} +10 -5
  492. package/dist/magma-components/{p-77001a72.entry.js → p-9ef64212.entry.js} +3 -3
  493. package/dist/magma-components/p-B8zYiZQY.system.js +1 -1
  494. package/dist/magma-components/p-c915fba5.system.entry.js +21 -0
  495. package/dist/magma-components/p-cd6dd836.entry.js +1 -0
  496. package/dist/stats.json +48 -47
  497. package/dist/types/components/mds-pref-theme-item/mds-pref-theme-item.d.ts +9 -2
  498. package/dist/types/components.d.ts +4 -4
  499. package/package.json +6 -5
  500. package/dist/magma-components/p-34d58345.entry.js +0 -1
  501. package/dist/magma-components/p-52e2b0d4.system.entry.js +0 -14
  502. package/dist/magma-components/p-f3708d1a.entry.js +0 -1
@@ -1 +1 @@
1
- import{p as e,H as t,d as s,f as i,h as a,c as h,t as n,B as r}from"./p-TZJN-ygm.js";import{L as m}from"./p-CZjwSwe5.js";import{M as o,p as d}from"./p-CVRN4LDc.js";import{l}from"./p-6pgPWpGI.js";import{m as c}from"./p-DiWN48aq.js";import{m as p}from"./p-Ccz0jCNB.js";import{d as f}from"./p-Ic8cYsgt.js";import{d as u}from"./p-G7Udw5H5.js";import{d as b}from"./p-C7rDjrH4.js";import{d as g}from"./p-COkn4Vtq.js";import{d as v}from"./p-4LbHmDXv.js";import{d as y}from"./p-DvDB_L_5.js";import{d as C}from"./p-D8CloC8I.js";const S=["bevel","notch","round","scoop","square","squircle","default"];var k={label:"Θέμα"},w={label:"Theme"},j={label:"Tema"},x={label:"Tema"};const D=e(class extends t{constructor(e){super(),!1!==e&&this.__registerHost(),this.__attachShadow(),this.themeChangeEvent=s(this,"mdsPrefThemeChange",7),this.prefChangeEvent=s(this,"mdsPrefChange",7),this.showDropdown=!1,this.localStorageAliasThemeName="mdsPrefTheme",this.localStorageAliasThemeScheme="mdsPrefThemeScheme",this.localStorageAliasCornerShape="mdsPrefCornerShape",this.t=new m({el:k,en:w,es:j,it:x}),this.clasNameThemeNamePrefix="pref-theme-",this.previousName=null,this.customPropertyAliasThemeScheme="--magma-pref-theme-scheme",this.customPropertyAliasThemeName="--magma-pref-theme",this.schemeSet={light:"pref-theme-scheme-light",dark:"pref-theme-scheme-dark",all:"pref-theme-scheme-all"},this.name="default",this.scheme="all",this.storedChoice=(e,t)=>{const s=localStorage.getItem(e);return null===s||t(s)?s:(localStorage.removeItem(e),null)},this.isThemeName=e=>null!=e&&/^[a-z]+(-[a-z]+)*$/.test(e)&&!o.includes(e)&&"scheme"!==e&&!e.startsWith("scheme-"),this.isScheme=e=>null!=e&&{}.hasOwnProperty.call(this.schemeSet,e),this.isCornerShape=e=>S.includes(e),this.triggerLabel=()=>{const e=Array.from(this.element.querySelectorAll("mds-pref-theme-item")).find((e=>{var t,s;return(null!==(s=null!==(t=e.name)&&void 0!==t?t:e.getAttribute("name"))&&void 0!==s?s:"default")===this.name}));return(null==e?void 0:e.label)||(null==e?void 0:e.getAttribute("label"))||l(this.name)},this.toggleDropdown=()=>{this.showDropdown=!this.showDropdown},this.hideThemeDropdownSelect=()=>{this.showDropdown=!1},this.changeThemeItem=()=>{this.themeItems.forEach((e=>{e.selected=!1}))},this.checkThemeSelect=()=>{this.themeItems=this.element.querySelectorAll("mds-pref-theme-item"),this.themeItems.forEach((e=>{e.selected=e.name===this.name}))},this.setTheme=(e,t)=>{if(!this.isThemeName(e))return void console.warn(`mds-pref-theme: ignoring the invalid theme name "${e}", a kebab-case name that is no mode or scheme name`);if(!this.isScheme(t))return void console.warn(`mds-pref-theme: ignoring the invalid scheme "${t}", use one of: ${Object.keys(this.schemeSet).join(", ")}`);this.name=e,this.scheme=t;const s=`${e}/${t}`;if(s===this.appliedTheme)return;const i=void 0===this.appliedTheme;if(this.appliedTheme=s,localStorage.setItem(this.localStorageAliasThemeName,this.name),localStorage.setItem(this.localStorageAliasThemeScheme,this.scheme),"undefined"!=typeof document){const e=document.querySelector("html");for(const t in this.schemeSet)({}).hasOwnProperty.call(this.schemeSet,t)&&(null==e||e.classList.remove(this.schemeSet[t]));null!==this.previousName&&""!==this.previousName&&(null==e||e.classList.remove(this.clasNameThemeNamePrefix+this.previousName)),null==e||e.setAttribute("data-theme-name",this.name),null==e||e.classList.add(this.schemeSet[this.scheme]),null==e||e.classList.add(this.clasNameThemeNamePrefix+this.name),null==e||e.style.setProperty(this.customPropertyAliasThemeName,this.name),null==e||e.style.setProperty(this.customPropertyAliasThemeScheme,this.scheme),this.previousName=this.name}d.state["theme-scheme"]=this.scheme,i||this.prefChangeEvent.emit({preference:"theme"})},this.setCornerShape=e=>{if(null==e)return;if(!this.isCornerShape(e))return void console.warn(`mds-pref-theme: ignoring the invalid corner shape "${e}", use one of: ${S.join(", ")}`);if(this.cornerShape=e,e===this.appliedCornerShape)return;const t=void 0===this.appliedCornerShape;if(this.appliedCornerShape=e,localStorage.setItem(this.localStorageAliasCornerShape,e),"undefined"!=typeof document){const t=document.querySelector("html");"default"===e?null==t||t.removeAttribute("data-corner-shape"):null==t||t.setAttribute("data-corner-shape",e)}d.state["corner-shape"]="default"===e?void 0:e,t||this.prefChangeEvent.emit({preference:"corner-shape"})}}handleNameChange(e){null!=e&&/^[a-z]+(-[a-z]+)*$/.test(e)&&(o.includes(e)||"scheme"===e||e.startsWith("scheme-")||localStorage.setItem(this.localStorageAliasThemeName,e))}handleSchemeChange(e){null!=e&&{}.hasOwnProperty.call(this.schemeSet,e)&&localStorage.setItem(this.localStorageAliasThemeScheme,e)}handleCornerShapeChange(e){null!=e&&S.includes(e)&&localStorage.setItem(this.localStorageAliasCornerShape,e)}connectedCallback(){r.isBrowser&&(this.itemsObserver=new MutationObserver((()=>i(this.element))),this.itemsObserver.observe(this.element,{attributeFilter:["label","name"],childList:!0,subtree:!0}))}componentDidLoad(){this.checkThemeSelect()}disconnectedCallback(){var e;null===(e=this.itemsObserver)||void 0===e||e.disconnect(),this.itemsObserver=void 0}componentWillRender(){var e,t,s;this.userThemeName=this.storedChoice(this.localStorageAliasThemeName,this.isThemeName),this.userThemeScheme=this.storedChoice(this.localStorageAliasThemeScheme,this.isScheme),this.setTheme(null!==(e=this.userThemeName)&&void 0!==e?e:this.name,null!==(t=this.userThemeScheme)&&void 0!==t?t:this.scheme),this.userCornerShape=this.storedChoice(this.localStorageAliasCornerShape,this.isCornerShape),this.setCornerShape(null!==(s=this.userCornerShape)&&void 0!==s?s:this.cornerShape)}handleItemSelect(e){this.changeThemeItem(),this.currentSelectedItem=e.target,this.currentSelectedItem.selected=!0;const t=e.detail.name.toLowerCase(),s=e.detail.scheme.toLowerCase();this.themeChangeEvent.emit({name:t,scheme:s}),this.showDropdown=!1,this.setTheme(t,s)}render(){return a(h,{key:"1db386671b7cfe5dc72b394d2e6a72ec4652a6eb"},a("div",{key:"b7310d70f4070deadac9f3c6f5f388d28e001da7",class:"menu"},a("mds-text",{key:"e5745f15f5b995f07fcce81d90a66e969c768f89",class:"info",typography:"caption"},a("b",{key:"e8a3c37d04d723d93affd820bc58697885298536"},this.t.get("label"))),a("mds-tab",{key:"3ae7ba5e9228edaf52967cbf1c9f194cb78824b7",fill:!0,size:this.size},a("mds-tab-item",{key:"1e6f65a7d255450d5c20bfe413cad7dd89ea85b2",selected:!0,onClick:this.toggleDropdown,expanded:this.showDropdown,id:"mds-pref-theme-nav",class:"item item--theme","icon-position":"right",icon:this.showDropdown?p:c,label:this.triggerLabel()}))),a("mds-dropdown",{key:"763f46b624f7b5c58a487cd5290b639e00c2a86a",class:"mds-pref-theme-dropdown",target:"#mds-pref-theme-nav",interaction:"none",visible:this.showDropdown,onMdsDropdownHide:this.hideThemeDropdownSelect},a("slot",{key:"0557e6dfa086c0173c3df88fe08a8a80edf74386",onSlotchange:this.checkThemeSelect})))}get element(){return this}static get watchers(){return{name:[{handleNameChange:0}],scheme:[{handleSchemeChange:0}],cornerShape:[{handleCornerShapeChange:0}]}}static get style(){return"@layer reset,vendor,theme,base,components,utilities;:host(:not(:is([hydrated],.hydrated))),:is(mds-dropdown,mds-tab,mds-tab-item,mds-text):not(:is([hydrated],.hydrated)){animation-duration:0s;border-color:#0000;box-shadow:0 0 #0000;opacity:0;outline-color:#0000;transition-delay:.1s;transition-duration:0s;visibility:hidden}:host{display:grid;gap:calc(var(--spacing,.0025rem)*400)}.menu{display:grid;gap:calc(var(--spacing,.0025rem)*200)}.mds-pref-theme-dropdown{gap:calc(var(--spacing,.0025rem)*100);padding:calc(var(--spacing,.0025rem)*400)}.item{--mds-tab-item-default-color:rgb(var(--magma-text-disabled,var(--text-neutral-disabled,119 119 119)));flex-basis:0;flex-grow:1}.item--theme{cursor:pointer}.item--auto,.item--theme{--mds-tab-item-selected-color:rgb(var(--magma-text-muted,var(--text-neutral-muted,73 73 73)))}"}},[257,"mds-pref-theme",{size:[513],name:[1537],scheme:[1537],cornerShape:[1537,"corner-shape"],showDropdown:[32]},[[0,"mdsPrefThemeItemSelect","handleItemSelect"]],{name:[{handleNameChange:0}],scheme:[{handleSchemeChange:0}],cornerShape:[{handleCornerShapeChange:0}]}]),E=D,$=function(){"undefined"!=typeof customElements&&["mds-pref-theme","mds-button","mds-dropdown","mds-icon","mds-spinner","mds-tab","mds-tab-item","mds-text"].forEach((e=>{switch(e){case"mds-pref-theme":customElements.get(n(e))||customElements.define(n(e),D);break;case"mds-button":customElements.get(n(e))||f();break;case"mds-dropdown":customElements.get(n(e))||u();break;case"mds-icon":customElements.get(n(e))||b();break;case"mds-spinner":customElements.get(n(e))||g();break;case"mds-tab":customElements.get(n(e))||v();break;case"mds-tab-item":customElements.get(n(e))||y();break;case"mds-text":customElements.get(n(e))||C()}}))};export{E as MdsPrefTheme,$ as defineCustomElement}
1
+ import{p as e,H as t,d as s,f as i,h as a,c as h,t as n,B as r}from"./p-TZJN-ygm.js";import{L as m}from"./p-CZjwSwe5.js";import{M as o,p as d}from"./p-CVRN4LDc.js";import{l}from"./p-6pgPWpGI.js";import{m as c}from"./p-DiWN48aq.js";import{m as p}from"./p-Ccz0jCNB.js";import{d as f}from"./p-Ic8cYsgt.js";import{d as u}from"./p-G7Udw5H5.js";import{d as b}from"./p-C7rDjrH4.js";import{d as g}from"./p-COkn4Vtq.js";import{d as v}from"./p-4LbHmDXv.js";import{d as y}from"./p-DvDB_L_5.js";import{d as C}from"./p-D8CloC8I.js";const S=["bevel","notch","round","scoop","square","squircle","default"];var k={label:"Θέμα"},w={label:"Theme"},j={label:"Tema"},x={label:"Tema"};const D=(e,t)=>{const s=e=>"default"===e?"business":e;return s(e)===s(t)},E=e(class extends t{constructor(e){super(),!1!==e&&this.__registerHost(),this.__attachShadow(),this.themeChangeEvent=s(this,"mdsPrefThemeChange",7),this.prefChangeEvent=s(this,"mdsPrefChange",7),this.showDropdown=!1,this.localStorageAliasThemeName="mdsPrefTheme",this.localStorageAliasThemeScheme="mdsPrefThemeScheme",this.localStorageAliasCornerShape="mdsPrefCornerShape",this.t=new m({el:k,en:w,es:j,it:x}),this.clasNameThemeNamePrefix="pref-theme-",this.previousName=null,this.customPropertyAliasThemeScheme="--magma-pref-theme-scheme",this.customPropertyAliasThemeName="--magma-pref-theme",this.schemeSet={light:"pref-theme-scheme-light",dark:"pref-theme-scheme-dark",all:"pref-theme-scheme-all"},this.name="default",this.scheme="all",this.storedChoice=(e,t)=>{const s=localStorage.getItem(e);return null===s||t(s)?s:(localStorage.removeItem(e),null)},this.isThemeName=e=>null!=e&&/^[a-z]+(-[a-z]+)*$/.test(e)&&!o.includes(e)&&"scheme"!==e&&!e.startsWith("scheme-"),this.isScheme=e=>null!=e&&{}.hasOwnProperty.call(this.schemeSet,e),this.isCornerShape=e=>S.includes(e),this.triggerLabel=()=>{const e=Array.from(this.element.querySelectorAll("mds-pref-theme-item")).find((e=>{var t,s;return D(null!==(s=null!==(t=e.name)&&void 0!==t?t:e.getAttribute("name"))&&void 0!==s?s:"default",this.name)}));return(null==e?void 0:e.label)||(null==e?void 0:e.getAttribute("label"))||l(this.name)},this.toggleDropdown=()=>{this.showDropdown=!this.showDropdown},this.hideThemeDropdownSelect=()=>{this.showDropdown=!1},this.changeThemeItem=()=>{this.themeItems.forEach((e=>{e.selected=!1}))},this.checkThemeSelect=()=>{this.themeItems=this.element.querySelectorAll("mds-pref-theme-item"),this.themeItems.forEach((e=>{e.selected=D(e.name,this.name)}))},this.setTheme=(e,t)=>{if(!this.isThemeName(e))return void console.warn(`mds-pref-theme: ignoring the invalid theme name "${e}", a kebab-case name that is no mode or scheme name`);if(!this.isScheme(t))return void console.warn(`mds-pref-theme: ignoring the invalid scheme "${t}", use one of: ${Object.keys(this.schemeSet).join(", ")}`);this.name=e,this.scheme=t;const s=`${e}/${t}`;if(s===this.appliedTheme)return;const i=void 0===this.appliedTheme;if(this.appliedTheme=s,localStorage.setItem(this.localStorageAliasThemeName,this.name),localStorage.setItem(this.localStorageAliasThemeScheme,this.scheme),"undefined"!=typeof document){const e=document.querySelector("html");for(const t in this.schemeSet)({}).hasOwnProperty.call(this.schemeSet,t)&&(null==e||e.classList.remove(this.schemeSet[t]));null!==this.previousName&&""!==this.previousName&&(null==e||e.classList.remove(this.clasNameThemeNamePrefix+this.previousName)),null==e||e.setAttribute("data-theme-name",this.name),null==e||e.classList.add(this.schemeSet[this.scheme]),null==e||e.classList.add(this.clasNameThemeNamePrefix+this.name),null==e||e.style.setProperty(this.customPropertyAliasThemeName,this.name),null==e||e.style.setProperty(this.customPropertyAliasThemeScheme,this.scheme),this.previousName=this.name}d.state["theme-scheme"]=this.scheme,i||this.prefChangeEvent.emit({preference:"theme"})},this.setCornerShape=e=>{if(null==e)return;if(!this.isCornerShape(e))return void console.warn(`mds-pref-theme: ignoring the invalid corner shape "${e}", use one of: ${S.join(", ")}`);if(this.cornerShape=e,e===this.appliedCornerShape)return;const t=void 0===this.appliedCornerShape;if(this.appliedCornerShape=e,localStorage.setItem(this.localStorageAliasCornerShape,e),"undefined"!=typeof document){const t=document.querySelector("html");"default"===e?null==t||t.removeAttribute("data-corner-shape"):null==t||t.setAttribute("data-corner-shape",e)}d.state["corner-shape"]="default"===e?void 0:e,t||this.prefChangeEvent.emit({preference:"corner-shape"})}}handleNameChange(e){null!=e&&/^[a-z]+(-[a-z]+)*$/.test(e)&&(o.includes(e)||"scheme"===e||e.startsWith("scheme-")||localStorage.setItem(this.localStorageAliasThemeName,e))}handleSchemeChange(e){null!=e&&{}.hasOwnProperty.call(this.schemeSet,e)&&localStorage.setItem(this.localStorageAliasThemeScheme,e)}handleCornerShapeChange(e){null!=e&&S.includes(e)&&localStorage.setItem(this.localStorageAliasCornerShape,e)}connectedCallback(){r.isBrowser&&(this.itemsObserver=new MutationObserver((()=>i(this.element))),this.itemsObserver.observe(this.element,{attributeFilter:["label","name"],childList:!0,subtree:!0}))}componentDidLoad(){this.checkThemeSelect()}disconnectedCallback(){var e;null===(e=this.itemsObserver)||void 0===e||e.disconnect(),this.itemsObserver=void 0}componentWillRender(){var e,t,s;this.userThemeName=this.storedChoice(this.localStorageAliasThemeName,this.isThemeName),this.userThemeScheme=this.storedChoice(this.localStorageAliasThemeScheme,this.isScheme),this.setTheme(null!==(e=this.userThemeName)&&void 0!==e?e:this.name,null!==(t=this.userThemeScheme)&&void 0!==t?t:this.scheme),this.userCornerShape=this.storedChoice(this.localStorageAliasCornerShape,this.isCornerShape),this.setCornerShape(null!==(s=this.userCornerShape)&&void 0!==s?s:this.cornerShape)}handleItemSelect(e){this.changeThemeItem(),this.currentSelectedItem=e.target,this.currentSelectedItem.selected=!0;const t=e.detail.name.toLowerCase(),s=e.detail.scheme.toLowerCase();this.themeChangeEvent.emit({name:t,scheme:s}),this.showDropdown=!1,this.setTheme(t,s)}render(){return a(h,{key:"d43c9d9bfaac3c3f997748228db2fccafb1307d2"},a("div",{key:"ddd730c6efb781df542701cbdc21d0874caf4c0a",class:"menu"},a("mds-text",{key:"ab88bdac3ca42505844dc35ab5a587fce8596c62",class:"info",typography:"caption"},a("b",{key:"acdc9a0ba564059ef013cb547f4e2eeda63ed2f2"},this.t.get("label"))),a("mds-tab",{key:"d7c052bcd02f7858ba0e9b2640e49c91530febc5",fill:!0,size:this.size},a("mds-tab-item",{key:"5ff16c9622437ff463aa3711387a53e6dc7f5796",selected:!0,onClick:this.toggleDropdown,expanded:this.showDropdown,id:"mds-pref-theme-nav",class:"item item--theme","icon-position":"right",icon:this.showDropdown?p:c,label:this.triggerLabel()}))),a("mds-dropdown",{key:"23ee30b64e2faec6f3f40e2c6d3a6e2a31161dbe",class:"mds-pref-theme-dropdown",target:"#mds-pref-theme-nav",interaction:"none",visible:this.showDropdown,onMdsDropdownHide:this.hideThemeDropdownSelect},a("slot",{key:"d26613bc60c31fde855cfcbb2935b91b34c7db3f",onSlotchange:this.checkThemeSelect})))}get element(){return this}static get watchers(){return{name:[{handleNameChange:0}],scheme:[{handleSchemeChange:0}],cornerShape:[{handleCornerShapeChange:0}]}}static get style(){return"@layer reset,vendor,theme,base,components,utilities;:host(:not(:is([hydrated],.hydrated))),:is(mds-dropdown,mds-tab,mds-tab-item,mds-text):not(:is([hydrated],.hydrated)){animation-duration:0s;border-color:#0000;box-shadow:0 0 #0000;opacity:0;outline-color:#0000;transition-delay:.1s;transition-duration:0s;visibility:hidden}:host{display:grid;gap:calc(var(--spacing,.0025rem)*400)}.menu{display:grid;gap:calc(var(--spacing,.0025rem)*200)}.mds-pref-theme-dropdown{gap:calc(var(--spacing,.0025rem)*100);padding:calc(var(--spacing,.0025rem)*400)}.item{--mds-tab-item-default-color:rgb(var(--magma-text-disabled,var(--text-neutral-disabled,119 119 119)));flex-basis:0;flex-grow:1}.item--theme{cursor:pointer}.item--auto,.item--theme{--mds-tab-item-selected-color:rgb(var(--magma-text-muted,var(--text-neutral-muted,73 73 73)))}"}},[257,"mds-pref-theme",{size:[513],name:[1537],scheme:[1537],cornerShape:[1537,"corner-shape"],showDropdown:[32]},[[0,"mdsPrefThemeItemSelect","handleItemSelect"]],{name:[{handleNameChange:0}],scheme:[{handleSchemeChange:0}],cornerShape:[{handleCornerShapeChange:0}]}]),$=E,T=function(){"undefined"!=typeof customElements&&["mds-pref-theme","mds-button","mds-dropdown","mds-icon","mds-spinner","mds-tab","mds-tab-item","mds-text"].forEach((e=>{switch(e){case"mds-pref-theme":customElements.get(n(e))||customElements.define(n(e),E);break;case"mds-button":customElements.get(n(e))||f();break;case"mds-dropdown":customElements.get(n(e))||u();break;case"mds-icon":customElements.get(n(e))||b();break;case"mds-spinner":customElements.get(n(e))||g();break;case"mds-tab":customElements.get(n(e))||v();break;case"mds-tab-item":customElements.get(n(e))||y();break;case"mds-text":customElements.get(n(e))||C()}}))};export{$ as MdsPrefTheme,T as defineCustomElement}
@@ -1,5 +1,5 @@
1
1
  {
2
- "timestamp": "2026-11-04T07:18:11",
2
+ "timestamp": "2026-11-04T15:13:27",
3
3
  "compiler": {
4
4
  "name": "@stencil/core",
5
5
  "version": "4.45.2",
@@ -24524,9 +24524,9 @@
24524
24524
  }
24525
24525
  ],
24526
24526
  "usage": {
24527
- "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",
24528
- "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",
24529
- "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"
24527
+ "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; 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.\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",
24528
+ "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\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=\"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",
24529
+ "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=\"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"
24530
24530
  },
24531
24531
  "props": [
24532
24532
  {
@@ -24803,9 +24803,9 @@
24803
24803
  }
24804
24804
  ],
24805
24805
  "usage": {
24806
- "1. Description": "The `<mds-pref-theme-item>` web component is a single selectable theme entry inside the [`<mds-pref-theme>`](../mds-pref-theme/AGENTS.md) preference picker. It renders as a borderless button that pairs a color-swatch preview of the theme with its label.\n\n#### Semantic Behavior\n\n- **Compound child only**: Must be placed as a direct default-slot child of `<mds-pref-theme>`; it is not used standalone or mixed with other child component types.\n- **Selection is parent-driven**: On click each item emits `mdsPrefThemeItemSelect` (carrying `{ name, scheme }`), and the parent responds by clearing the siblings and selecting the clicked one. Setting `selected` directly on a single item does not coordinate the others.\n- **Click bubbles up**: The emitted event is what the parent listens to in order to apply the theme to the document and persist the choice.\n- **Auto-derived label**: If `label` is omitted, it is generated from `name` by capitalizing the first letter and replacing hyphens with spaces (e.g. `maggioli-editore` becomes `Maggioli editore`).\n- **Static color preview**: The four swatches (primary, success, warning, error) and the preview background are painted by the `--mds-pref-theme-item-*` CSS custom properties, not by props. Their defaults are the page's current roles (accent, the status emphases, `wash-base`), so every item shows the same swatches until you set the properties per item.\n\n#### Properties & Visual Configurations\n\n- **`name`**: The theme identifier reported to the parent and matched against the parent's active `name` to compute initial selection. Use a simple or kebab-case string; the named themes are `cool` and `warm`, and `default` is the base theme ([`agents/theming.md`](../../../../agents/theming.md)). The parent validates the lowercase/kebab format and ignores an invalid name with a console warning.\n- **`scheme`**: Declares which color schemes the theme supports - `all` (default, both light and dark), or `light` / `dark` to force a single mode. This value travels with the selection event and is applied by the parent when the item is chosen.\n- **`selected`**: Reflects whether this item is the active theme. The parent sets it on every item when it loads and on each pick, so a value set by hand is overwritten.\n",
24807
- "2. Examples": "Correct and idiomatic ways to use the `<mds-pref-theme-item>` component, ordered from most common to most specialized. The examples assume a working knowledge of the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Basic Usage Inside the Parent\n\n`<mds-pref-theme-item>` must always be a direct child of [`<mds-pref-theme>`](../mds-pref-theme/AGENTS.md). Each item represents one selectable colour theme; the parent manages selection state so all siblings stay in sync.\n\n```html\n<mds-pref-theme name=\"default\" scheme=\"all\">\n <mds-pref-theme-item name=\"default\" label=\"Predefinito\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"cool\" label=\"Freddo\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"warm\" label=\"Caldo\" scheme=\"all\"></mds-pref-theme-item>\n</mds-pref-theme>\n```\n\n#### Auto-Derived Label\n\nOmit `label` and let the component generate it from `name`: the first letter is capitalised and hyphens are replaced with spaces. Use this shorthand when the theme name is already human-readable.\n\n```html\n<mds-pref-theme name=\"default\" scheme=\"all\">\n <!-- renders \"Default\", \"Cool\", \"Warm\" without explicit label props -->\n <mds-pref-theme-item name=\"default\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"cool\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"warm\" scheme=\"all\"></mds-pref-theme-item>\n</mds-pref-theme>\n```\n\n#### Scheme-Specific Themes\n\nSet `scheme` to `\"light\"` or `\"dark\"` when a theme must be offered in a single colour mode only. The parent applies the forced mode when the item is selected.\n\n```html\n<mds-pref-theme name=\"default\" scheme=\"all\">\n <!-- this theme works in both modes -->\n <mds-pref-theme-item name=\"default\" label=\"Predefinito\" scheme=\"all\"></mds-pref-theme-item>\n\n <!-- offered light-only; selecting it locks the UI in light mode -->\n <mds-pref-theme-item name=\"cool\" label=\"Freddo chiaro\" scheme=\"light\"></mds-pref-theme-item>\n\n <!-- offered dark-only; selecting it locks the UI in dark mode -->\n <mds-pref-theme-item name=\"warm\" label=\"Caldo scuro\" scheme=\"dark\"></mds-pref-theme-item>\n</mds-pref-theme>\n```\n\n#### Listening to the Selection Event\n\nAttach a listener for `mdsPrefThemeItemSelect` when you need to react to a selection at the item level - for example to log analytics. The detail carries `{ name, scheme }`. Normally the parent handles theme application automatically; only listen at this level for side-effects.\n\n```html\n<mds-pref-theme name=\"default\" scheme=\"all\">\n <mds-pref-theme-item name=\"default\" label=\"Predefinito\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"cool\" label=\"Freddo\" scheme=\"all\"></mds-pref-theme-item>\n</mds-pref-theme>\n\n<script>\n document.querySelectorAll('mds-pref-theme-item').forEach((item) => {\n item.addEventListener('mdsPrefThemeItemSelect', (e) => {\n console.log('Tema selezionato:', e.detail.name, 'schema:', e.detail.scheme);\n });\n });\n</script>\n```\n\n#### Setting the Initially Selected Item\n\nDeclare it on the parent, not with `selected`: when it loads, `<mds-pref-theme>` marks the item whose `name` matches the active theme (the stored choice, or its own `name` on a first visit) and overwrites any `selected` written in the markup.\n\n```html\n<mds-pref-theme name=\"cool\" scheme=\"all\">\n <mds-pref-theme-item name=\"default\" label=\"Predefinito\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"cool\" label=\"Freddo\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"warm\" label=\"Caldo\" scheme=\"all\"></mds-pref-theme-item>\n</mds-pref-theme>\n```\n\n#### CSS Customization via Documented Properties\n\nOverride the swatch only through the public `--mds-pref-theme-item-color-background` CSS custom property, the background behind the preview dots; the dots themselves are painted by the component. Set it on the host element or a parent selector and name a semantic role for the colour value, `rgb(var(--magma-<role>))` ([`agents/color.md`](../../../../agents/color.md)), so mode, theme and contrast keep working.\n\n```css\n/* override the swatch background of one theme item */\nmds-pref-theme-item[name=\"warm\"] {\n --mds-pref-theme-item-color-background: rgb(var(--magma-wash-strong));\n}\n```\n",
24808
- "3. Mistakes": "Common incorrect uses of `<mds-pref-theme-item>`. Each entry pairs the wrong form with the right one and a one-line reason. System-wide rules (boolean-as-string, shadow piercing, Tailwind color utilities, raw native event listening) live in [`agents/mistakes.md`](../../../../agents/mistakes.md) - they apply here too but are not repeated.\n\n#### Do Not Use the Item Outside Its Parent\n\n`<mds-pref-theme-item>` is a compound child that must be a direct slot child of [`<mds-pref-theme>`](../mds-pref-theme/AGENTS.md). Used standalone it emits selection events that are never handled, and it never receives coordinated deselection of siblings.\n\n```html\n<!-- INCORRECT -->\n<mds-pref-theme-item name=\"cool\" label=\"Freddo\" scheme=\"all\"></mds-pref-theme-item>\n\n<!-- CORRECT -->\n<mds-pref-theme name=\"default\" scheme=\"all\">\n <mds-pref-theme-item name=\"cool\" label=\"Freddo\" scheme=\"all\"></mds-pref-theme-item>\n</mds-pref-theme>\n```\n\n#### Do Not Set `selected` Manually to Coordinate Multi-Item State\n\nSetting `selected` on one item does not deselect the others - the parent is the only actor that can coordinate the whole group. When it loads it marks only the item matching the active theme, overwriting the `selected` in the markup; a value set later from script leaves several items marked. Drive initial selection through the parent's `name` prop or by letting the user click.\n\n```html\n<!-- INCORRECT - the parent overwrites both on load and marks \"default\" -->\n<mds-pref-theme name=\"default\" scheme=\"all\">\n <mds-pref-theme-item name=\"default\" label=\"Predefinito\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"cool\" label=\"Freddo\" scheme=\"all\" selected></mds-pref-theme-item>\n <mds-pref-theme-item name=\"warm\" label=\"Caldo\" scheme=\"all\" selected></mds-pref-theme-item>\n</mds-pref-theme>\n\n<!-- CORRECT - set the active theme on the parent; it marks the matching child -->\n<mds-pref-theme name=\"cool\" scheme=\"all\">\n <mds-pref-theme-item name=\"default\" label=\"Predefinito\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"cool\" label=\"Freddo\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"warm\" label=\"Caldo\" scheme=\"all\"></mds-pref-theme-item>\n</mds-pref-theme>\n```\n\n#### Do Not Listen for Native `click` Instead of the Component Event\n\nA raw `click` carries no `detail`: you have to read `name` back from the element, and you lose the `scheme`. Listen for the documented `mdsPrefThemeItemSelect` event instead, whose detail carries `{ name, scheme }`.\n\n```html\n<!-- INCORRECT -->\n<script>\n document.querySelector('mds-pref-theme-item').addEventListener('click', (e) => {\n applyTheme(e.target.getAttribute('name'));\n });\n</script>\n\n<!-- CORRECT -->\n<script>\n document.querySelector('mds-pref-theme-item').addEventListener('mdsPrefThemeItemSelect', (e) => {\n applyTheme(e.detail.name);\n });\n</script>\n```\n\n#### Do Not Pierce Shadow DOM to Style the Inner Button\n\nThe supported customization surface is the public `--mds-pref-theme-item-color-background` CSS custom property. Targeting internal selectors or `::part()` names not present in this component's public API couples your code to the implementation and will break on minor releases.\n\n```css\n/* INCORRECT */\nmds-pref-theme-item >>> mds-button {\n font-weight: bold;\n}\nmds-pref-theme-item .theme-preview {\n border: 2px solid red;\n}\n\n/* CORRECT */\nmds-pref-theme-item[name=\"warm\"] {\n --mds-pref-theme-item-color-background: rgb(var(--magma-wash-strong));\n}\n```\n\n#### Do Not Use an Invalid `scheme` Value\n\n`scheme` only accepts `\"all\"`, `\"light\"`, or `\"dark\"`. Other strings are ignored by the parent with a console warning: picking the item applies and stores nothing, so the theme does not change at all.\n\n```html\n<!-- INCORRECT -->\n<mds-pref-theme-item name=\"cool\" scheme=\"light-only\"></mds-pref-theme-item>\n<mds-pref-theme-item name=\"warm\" scheme=\"night\"></mds-pref-theme-item>\n\n<!-- CORRECT -->\n<mds-pref-theme-item name=\"cool\" scheme=\"light\"></mds-pref-theme-item>\n<mds-pref-theme-item name=\"warm\" scheme=\"dark\"></mds-pref-theme-item>\n```\n"
24806
+ "1. Description": "The `<mds-pref-theme-item>` web component is a single selectable theme entry inside the [`<mds-pref-theme>`](../mds-pref-theme/AGENTS.md) preference picker. It renders as a borderless button that pairs a color-swatch preview of the theme with its label.\n\n#### Semantic Behavior\n\n- **Compound child only**: Must be placed as a direct default-slot child of `<mds-pref-theme>`; it is not used standalone or mixed with other child component types.\n- **Selection is parent-driven**: On click each item emits `mdsPrefThemeItemSelect` (carrying `{ name, scheme }`), and the parent responds by clearing the siblings and selecting the clicked one. Setting `selected` directly on a single item does not coordinate the others.\n- **Click bubbles up**: The emitted event is what the parent listens to in order to apply the theme to the document and persist the choice.\n- **Auto-derived label**: If `label` is omitted, it is generated from `name` by capitalizing the first letter and replacing hyphens with spaces (e.g. `maggioli-editore` becomes `Maggioli editore`).\n- **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.\n\n#### Properties & Visual Configurations\n\n- **`name`**: The theme identifier reported to the parent and matched against the parent's active `name` to compute initial selection. Use a simple or kebab-case string; the named themes are `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.\n- **`scheme`**: Declares which color schemes the theme supports - `all` (default, both light and dark), or `light` / `dark` to force a single mode. This value travels with the selection event and is applied by the parent when the item is chosen.\n- **`selected`**: Reflects whether this item is the active theme. The parent sets it on every item when it loads and on each pick, so a value set by hand is overwritten.\n",
24807
+ "2. Examples": "Correct and idiomatic ways to use the `<mds-pref-theme-item>` component, ordered from most common to most specialized. The examples assume a working knowledge of the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Basic Usage Inside the Parent\n\n`<mds-pref-theme-item>` must always be a direct child of [`<mds-pref-theme>`](../mds-pref-theme/AGENTS.md). Each item represents one selectable colour theme; the parent manages selection state so all siblings stay in sync.\n\n```html\n<mds-pref-theme name=\"business\" scheme=\"all\">\n <mds-pref-theme-item name=\"business\" label=\"Gestionale\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"editorial\" label=\"Editoriale\" scheme=\"all\"></mds-pref-theme-item>\n</mds-pref-theme>\n```\n\n#### Auto-Derived Label\n\nOmit `label` and let the component generate it from `name`: the first letter is capitalised and hyphens are replaced with spaces. Use this shorthand when the theme name is already human-readable.\n\n```html\n<mds-pref-theme name=\"business\" scheme=\"all\">\n <!-- renders \"Business\" and \"Editorial\" without explicit label props -->\n <mds-pref-theme-item name=\"business\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"editorial\" scheme=\"all\"></mds-pref-theme-item>\n</mds-pref-theme>\n```\n\n#### Scheme-Specific Themes\n\nSet `scheme` to `\"light\"` or `\"dark\"` when a theme must be offered in a single colour mode only. The parent applies the forced mode when the item is selected.\n\n```html\n<mds-pref-theme name=\"business\" scheme=\"all\">\n <!-- this theme works in both modes -->\n <mds-pref-theme-item name=\"business\" label=\"Gestionale\" scheme=\"all\"></mds-pref-theme-item>\n\n <!-- offered light-only; selecting it locks the UI in light mode -->\n <mds-pref-theme-item name=\"editorial\" label=\"Editoriale chiaro\" scheme=\"light\"></mds-pref-theme-item>\n</mds-pref-theme>\n```\n\n#### Listening to the Selection Event\n\nAttach a listener for `mdsPrefThemeItemSelect` when you need to react to a selection at the item level - for example to log analytics. The detail carries `{ name, scheme }`. Normally the parent handles theme application automatically; only listen at this level for side-effects.\n\n```html\n<mds-pref-theme name=\"business\" scheme=\"all\">\n <mds-pref-theme-item name=\"business\" label=\"Gestionale\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"editorial\" label=\"Editoriale\" scheme=\"all\"></mds-pref-theme-item>\n</mds-pref-theme>\n\n<script>\n document.querySelectorAll('mds-pref-theme-item').forEach((item) => {\n item.addEventListener('mdsPrefThemeItemSelect', (e) => {\n console.log('Tema selezionato:', e.detail.name, 'schema:', e.detail.scheme);\n });\n });\n</script>\n```\n\n#### Setting the Initially Selected Item\n\nDeclare it on the parent, not with `selected`: when it loads, `<mds-pref-theme>` marks the item whose `name` matches the active theme (the stored choice, or its own `name` on a first visit) and overwrites any `selected` written in the markup.\n\n```html\n<mds-pref-theme name=\"editorial\" scheme=\"all\">\n <mds-pref-theme-item name=\"business\" label=\"Gestionale\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"editorial\" label=\"Editoriale\" scheme=\"all\"></mds-pref-theme-item>\n</mds-pref-theme>\n```\n\n#### CSS Customization via Documented Properties\n\nOverride the swatch only through the public `--mds-pref-theme-item-color-background` CSS custom property, the background behind the preview dots; the dots themselves are painted by the component. Set it on the host element or a parent selector and name a semantic role for the colour value, `rgb(var(--magma-<role>))` ([`agents/color.md`](../../../../agents/color.md)), so mode, theme and contrast keep working. It replaces the preview of the theme the item names.\n\n```css\n/* override the swatch background of one theme item */\nmds-pref-theme-item[name=\"editorial\"] {\n --mds-pref-theme-item-color-background: rgb(var(--magma-wash-strong));\n}\n```\n",
24808
+ "3. Mistakes": "Common incorrect uses of `<mds-pref-theme-item>`. Each entry pairs the wrong form with the right one and a one-line reason. System-wide rules (boolean-as-string, shadow piercing, Tailwind color utilities, raw native event listening) live in [`agents/mistakes.md`](../../../../agents/mistakes.md) - they apply here too but are not repeated.\n\n#### Do Not Use the Item Outside Its Parent\n\n`<mds-pref-theme-item>` is a compound child that must be a direct slot child of [`<mds-pref-theme>`](../mds-pref-theme/AGENTS.md). Used standalone it emits selection events that are never handled, and it never receives coordinated deselection of siblings.\n\n```html\n<!-- INCORRECT -->\n<mds-pref-theme-item name=\"editorial\" label=\"Editoriale\" scheme=\"all\"></mds-pref-theme-item>\n\n<!-- CORRECT -->\n<mds-pref-theme name=\"business\" scheme=\"all\">\n <mds-pref-theme-item name=\"editorial\" label=\"Editoriale\" scheme=\"all\"></mds-pref-theme-item>\n</mds-pref-theme>\n```\n\n#### Do Not Set `selected` Manually to Coordinate Multi-Item State\n\nSetting `selected` on one item does not deselect the others - the parent is the only actor that can coordinate the whole group. When it loads it marks only the item matching the active theme, overwriting the `selected` in the markup; a value set later from script leaves several items marked. Drive initial selection through the parent's `name` prop or by letting the user click.\n\n```html\n<!-- INCORRECT - the parent overwrites both on load and marks \"default\" -->\n<mds-pref-theme name=\"business\" scheme=\"all\">\n <mds-pref-theme-item name=\"business\" label=\"Gestionale\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"editorial\" label=\"Editoriale\" scheme=\"all\" selected></mds-pref-theme-item>\n</mds-pref-theme>\n\n<!-- CORRECT - set the active theme on the parent; it marks the matching child -->\n<mds-pref-theme name=\"editorial\" scheme=\"all\">\n <mds-pref-theme-item name=\"business\" label=\"Gestionale\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item name=\"editorial\" label=\"Editoriale\" scheme=\"all\"></mds-pref-theme-item>\n</mds-pref-theme>\n```\n\n#### Do Not Listen for Native `click` Instead of the Component Event\n\nA raw `click` carries no `detail`: you have to read `name` back from the element, and you lose the `scheme`. Listen for the documented `mdsPrefThemeItemSelect` event instead, whose detail carries `{ name, scheme }`.\n\n```html\n<!-- INCORRECT -->\n<script>\n document.querySelector('mds-pref-theme-item').addEventListener('click', (e) => {\n applyTheme(e.target.getAttribute('name'));\n });\n</script>\n\n<!-- CORRECT -->\n<script>\n document.querySelector('mds-pref-theme-item').addEventListener('mdsPrefThemeItemSelect', (e) => {\n applyTheme(e.detail.name);\n });\n</script>\n```\n\n#### Do Not Pierce Shadow DOM to Style the Inner Button\n\nThe supported customization surface is the public `--mds-pref-theme-item-color-background` CSS custom property. Targeting internal selectors or `::part()` names not present in this component's public API couples your code to the implementation and will break on minor releases.\n\n```css\n/* INCORRECT */\nmds-pref-theme-item >>> mds-button {\n font-weight: bold;\n}\nmds-pref-theme-item .theme-preview {\n border: 2px solid red;\n}\n\n/* CORRECT */\nmds-pref-theme-item[name=\"editorial\"] {\n --mds-pref-theme-item-color-background: rgb(var(--magma-wash-strong));\n}\n```\n\n#### Do Not Use an Invalid `scheme` Value\n\n`scheme` only accepts `\"all\"`, `\"light\"`, or `\"dark\"`. Other strings are ignored by the parent with a console warning: picking the item applies and stores nothing, so the theme does not change at all.\n\n```html\n<!-- INCORRECT -->\n<mds-pref-theme-item name=\"editorial\" scheme=\"light-only\"></mds-pref-theme-item>\n<mds-pref-theme-item name=\"business\" scheme=\"night\"></mds-pref-theme-item>\n\n<!-- CORRECT -->\n<mds-pref-theme-item name=\"editorial\" scheme=\"light\"></mds-pref-theme-item>\n<mds-pref-theme-item name=\"business\" scheme=\"dark\"></mds-pref-theme-item>\n```\n"
24809
24809
  },
24810
24810
  "props": [
24811
24811
  {
@@ -24845,11 +24845,11 @@
24845
24845
  "mutable": false,
24846
24846
  "attr": "name",
24847
24847
  "reflectToAttr": true,
24848
- "docs": "Specifies the theme name",
24848
+ "docs": "Specifies the theme name; the swatch shows the preview that theme publishes,\n`--magma-preview-<name>-wash` and `--magma-preview-<name>-accent`",
24849
24849
  "docsTags": [
24850
24850
  {
24851
24851
  "name": "example",
24852
- "text": "'maggioli-editore'"
24852
+ "text": "'editorial'"
24853
24853
  },
24854
24854
  {
24855
24855
  "name": "default",
@@ -24977,7 +24977,7 @@
24977
24977
  {
24978
24978
  "name": "--mds-pref-theme-item-color-background",
24979
24979
  "annotation": "prop",
24980
- "docs": "Background color of a theme item.",
24980
+ "docs": "Background color of a theme item: the wash of the theme it names.",
24981
24981
  "visibility": "public"
24982
24982
  },
24983
24983
  {
@@ -25001,7 +25001,7 @@
25001
25001
  {
25002
25002
  "name": "--mds-pref-theme-item-color-variant-primary",
25003
25003
  "annotation": "prop",
25004
- "docs": "Color for the primary variant item.",
25004
+ "docs": "Color for the primary variant item: the accent of the theme it names.",
25005
25005
  "visibility": "internal"
25006
25006
  }
25007
25007
  ],
@@ -30,7 +30,7 @@ function _assertThisInitialized(self) { if (self === void 0) { throw new Referen
30
30
  function _inheritsLoose(subClass, superClass) { subClass.prototype = Object.create(superClass.prototype); subClass.prototype.constructor = subClass; subClass.__proto__ = superClass; }
31
31
 
32
32
  /*!
33
- * GSAP 3.15.0
33
+ * GSAP 3.15.1
34
34
  * https://gsap.com
35
35
  *
36
36
  * @license Copyright 2008-2026, GreenSock. All rights reserved.
@@ -450,7 +450,8 @@ _postAddChecks = function _postAddChecks(timeline, child) {
450
450
  },
451
451
  _addToTimeline = function _addToTimeline(timeline, child, position, skipChecks) {
452
452
  child.parent && _removeFromParent(child);
453
- child._start = _roundPrecise((_isNumber(position) ? position : position || timeline !== _globalTimeline ? _parsePosition(timeline, position, child) : timeline._time) + child._delay);
453
+ child._start = _roundPrecise((_isNumber(position) ? position : !position && _isFromOrFromStart(child) && (!timeline._last || timeline._last._start >= timeline._time) ? timeline._last ? timeline._last._start : timeline._time : position || timeline !== _globalTimeline ? _parsePosition(timeline, position, child) : timeline._time) + child._delay); // a from()/startAt tween's internal _startAt gets added and then immediately removed, so skip _parsePosition() which calls duration() (a full walk of a dirty timeline, making large from() timelines O(n²)). Dropping it at the _last child's _start keeps the sorted insert O(1), and the playhead check avoids a render in _postAddChecks().
454
+
454
455
  child._end = _roundPrecise(child._start + (child.totalDuration() / Math.abs(child.timeScale()) || 0));
455
456
 
456
457
  _addLinkedListItem(timeline, child, "_first", "_last", timeline._sort ? "_start" : 0);
@@ -1317,7 +1318,7 @@ _tickerActive,
1317
1318
  frame = ++_self.frame;
1318
1319
  _delta = time - _self.time * 1000;
1319
1320
  _self.time = time = time / 1000;
1320
- _nextTime += overlap + (overlap >= _gap ? 4 : _gap - overlap);
1321
+ _nextTime += overlap + (overlap >= _gap ? 0 : _gap - overlap);
1321
1322
  dispatch = 1;
1322
1323
  }
1323
1324
 
@@ -1761,15 +1762,17 @@ var Animation = /*#__PURE__*/function () {
1761
1762
  return this;
1762
1763
  }
1763
1764
 
1764
- var tTime = this.parent && this._ts ? _parentToChildTotalTime(this.parent._time, this) : this._tTime; // make sure to do the parentToChildTotalTime() BEFORE setting the new _ts because the old one must be used in that calculation.
1765
- // future addition? Up side: fast and minimal file size. Down side: only works on this animation; if a timeline is reversed, for example, its childrens' onReverse wouldn't get called.
1765
+ var tTime = this.parent && this._ts ? _parentToChildTotalTime(this.parent._time, this) : this._tTime,
1766
+ // make sure to do the parentToChildTotalTime() BEFORE setting the new _ts because the old one must be used in that calculation.
1767
+ wasReversed = this._rts < 0; // future addition? Up side: fast and minimal file size. Down side: only works on this animation; if a timeline is reversed, for example, its childrens' onReverse wouldn't get called.
1766
1768
  //(+value < 0 && this._rts >= 0) && _callback(this, "onReverse", true);
1767
1769
  // prioritize rendering where the parent's playhead lines up instead of this._tTime because there could be a tween that's animating another tween's timeScale in the same rendering loop (same parent), thus if the timeScale tween renders first, it would alter _start BEFORE _tTime was set on that tick (in the rendering loop), effectively freezing it until the timeScale tween finishes.
1768
1770
 
1769
1771
  this._rts = +value || 0;
1770
1772
  this._ts = this._ps || value === -_tinyNum ? 0 : this._rts; // _ts is the functional timeScale which would be 0 if the animation is paused.
1771
1773
 
1772
- this.totalTime(_clamp(-Math.abs(this._delay), this.totalDuration(), tTime), suppressEvents !== false);
1774
+ var tDur = this.totalDuration();
1775
+ if (wasReversed !== this._rts < 0 || tTime > 0 && tTime < tDur) this.totalTime(_clamp(-Math.abs(this._delay), tDur, tTime), suppressEvents !== false);
1773
1776
 
1774
1777
  _setEnd(this); // if parent.smoothChildTiming was false, the end time didn't get updated in the _alignPlayhead() method, so do it here.
1775
1778
 
@@ -1795,8 +1798,27 @@ var Animation = /*#__PURE__*/function () {
1795
1798
  _wake();
1796
1799
 
1797
1800
  this._ts = this._rts; //only defer to _pTime (pauseTime) if tTime is zero. Remember, someone could pause() an animation, then scrub the playhead and resume(). If the parent doesn't have smoothChildTiming, we render at the rawTime() because the startTime won't get updated.
1801
+ // At progress===1, nudge _tTime so the resume render runs (autoRemoveChildren / progress(1).pause().play()). Don't suppress if a never-rendered zero-duration child (e.g. delayedCall(0) scheduled while idle) sits on the playhead — suppress would complete it silently and it would never fire.
1802
+
1803
+ var tTime = this.parent && !this.parent.smoothChildTiming ? this.rawTime() : this._tTime || this._pTime,
1804
+ suppress = this.progress() === 1 && Math.abs(this._zTime) !== _tinyNum,
1805
+ child;
1798
1806
 
1799
- this.totalTime(this.parent && !this.parent.smoothChildTiming ? this.rawTime() : this._tTime || this._pTime, this.progress() === 1 && Math.abs(this._zTime) !== _tinyNum && (this._tTime -= _tinyNum)); // edge case: animation.progress(1).pause().play() wouldn't render again because the playhead is already at the end, but the call to totalTime() below will add it back to its parent...and not remove it again (since removing only happens upon rendering at a new time). Offsetting the _tTime slightly is done simply to cause the final render in totalTime() that'll pop it off its timeline (if autoRemoveChildren is true, of course). Check to make sure _zTime isn't -_tinyNum to avoid an edge case where the playhead is pushed to the end but INSIDE a tween/callback, the timeline itself is paused thus halting rendering and leaving a few unrendered. When resuming, it wouldn't render those otherwise.
1807
+ if (suppress) {
1808
+ this._tTime -= _tinyNum;
1809
+ child = this._first;
1810
+
1811
+ while (child) {
1812
+ if (!child._dur && child._zTime < 0 && child._ts && child._start <= tTime + _tinyNum) {
1813
+ suppress = false;
1814
+ break;
1815
+ }
1816
+
1817
+ child = child._next;
1818
+ }
1819
+ }
1820
+
1821
+ this.totalTime(tTime, suppress);
1800
1822
  }
1801
1823
  }
1802
1824
 
@@ -3159,13 +3181,14 @@ _parseKeyframe = function _parseKeyframe(prop, obj, allProps, easeEach) {
3159
3181
  _forEachName(_staggerTweenProps + ",id,stagger,delay,duration,paused,scrollTrigger", function (name) {
3160
3182
  return _staggerPropsToSkip[name] = 1;
3161
3183
  });
3184
+
3185
+ _staggerTweenProps = _staggerTweenProps.split(",");
3162
3186
  /*
3163
3187
  * --------------------------------------------------------------------------------------
3164
3188
  * TWEEN
3165
3189
  * --------------------------------------------------------------------------------------
3166
3190
  */
3167
3191
 
3168
-
3169
3192
  var Tween = /*#__PURE__*/function (_Animation2) {
3170
3193
  _inheritsLoose(Tween, _Animation2);
3171
3194
 
@@ -4048,6 +4071,11 @@ var Context = /*#__PURE__*/function () {
4048
4071
  // previously, we checked _media.indexOf(this), but some frameworks like Vue enforce Proxy objects that make it impossible to get the proper result that way, so we must use a unique ID number instead.
4049
4072
  _media[i].id === this.id && _media.splice(i, 1);
4050
4073
  }
4074
+
4075
+ this._mqs && this._mqs.forEach(function (mq) {
4076
+ return mq.removeListener ? mq.removeListener(_onMediaChange) : mq.removeEventListener("change", _onMediaChange);
4077
+ });
4078
+ this._mqs = null;
4051
4079
  }
4052
4080
  } // killWithCleanup() {
4053
4081
  // this.kill();
@@ -4096,6 +4124,7 @@ var MatchMedia = /*#__PURE__*/function () {
4096
4124
  _media.indexOf(context) < 0 && _media.push(context);
4097
4125
  (cond[p] = mq.matches) && (active = 1);
4098
4126
  mq.addListener ? mq.addListener(_onMediaChange) : mq.addEventListener("change", _onMediaChange);
4127
+ (context._mqs || (context._mqs = [])).push(mq);
4099
4128
  }
4100
4129
  }
4101
4130
  }
@@ -4474,12 +4503,12 @@ var gsap = _gsap.registerPlugin({
4474
4503
  }
4475
4504
  }, _buildModifierPlugin("roundProps", _roundModifier), _buildModifierPlugin("modifiers"), _buildModifierPlugin("snap", snap)) || _gsap; //to prevent the core plugins from being dropped via aggressive tree shaking, we must include them in the variable declaration in this way.
4476
4505
 
4477
- Tween.version = Timeline.version = gsap.version = "3.15.0";
4506
+ Tween.version = Timeline.version = gsap.version = "3.15.1";
4478
4507
  _coreReady = 1;
4479
4508
  _windowExists$1() && _wake();
4480
4509
 
4481
4510
  /*!
4482
- * CSSPlugin 3.15.0
4511
+ * CSSPlugin 3.15.1
4483
4512
  * https://gsap.com
4484
4513
  *
4485
4514
  * Copyright 2008-2026, GreenSock. All rights reserved.
@@ -3,15 +3,18 @@ import { m as miBaselineCheckCircle } from './check-circle-BFhO-KUe.js';
3
3
  import { m as miOutlineCircle } from './circle-lZldSMeV.js';
4
4
  import { l as labelFromName } from './string-6pgPWpGI.js';
5
5
 
6
- const mdsPrefThemeItemCss = () => `@layer reset,vendor,theme,base,components,utilities;:host(:not(:is([hydrated],.hydrated))),mds-button:not(:is([hydrated],.hydrated)){animation-duration:0s;border-color:#0000;box-shadow:0 0 #0000;opacity:0;outline-color:#0000;transition-delay:.1s;transition-duration:0s;visibility:hidden}:host{--mds-pref-theme-item-color-background:rgb(var(--magma-wash-base,var(--tone-neutral-09,225 225 225)));--mds-pref-theme-item-color-status-error:rgb(var(--magma-danger-emphasis,var(--status-error-04,196 64 65)));--mds-pref-theme-item-color-status-success:rgb(var(--magma-success-emphasis,var(--status-success-04,0 128 57)));--mds-pref-theme-item-color-status-warning:rgb(var(--magma-warning-emphasis,var(--status-warning-04,142 106 0)));--mds-pref-theme-item-color-variant-primary:rgb(var(--magma-accent-emphasis,var(--variant-primary-04,36 103 231)));align-items:center;cursor:pointer;display:flex;gap:calc(var(--spacing,.0025rem)*400);justify-content:space-between}.theme-preview{background-color:var(--mds-pref-theme-item-color-background,rgb(var(--magma-wash-base,var(--tone-neutral-09,225 225 225))));box-shadow:var(--shadow-ring-weak,0 0 0 1px rgb(var(--tone-neutral-01,5 5 5)/.15));box-sizing:border-box;display:inline-flex;flex:none;flex-wrap:wrap;gap:calc(var(--spacing,.0025rem)*100);height:calc(var(--spacing,.0025rem)*600);margin:1px;padding:calc(var(--spacing,.0025rem)*100);width:calc(var(--spacing,.0025rem)*600)}.theme-color,.theme-preview{border-radius:var(--magma-radius-full,var(--radius-full,1000px))}.theme-color{background-color:rgb(var(--magma-wash-base,var(--tone-neutral-09,225 225 225)));height:calc(var(--spacing,.0025rem)*150);position:relative;width:calc(var(--spacing,.0025rem)*150)}.theme-color:after{border-radius:inherit;box-shadow:var(--shadow-ring-weak,0 0 0 1px rgb(var(--tone-neutral-01,5 5 5)/.15)) inset;content:"";display:flex;inset:0;position:absolute}.theme-color--variant-primary{background-color:var(--mds-pref-theme-item-color-variant-primary,rgb(var(--magma-accent-emphasis,var(--variant-primary-04,36 103 231))))}.theme-color--status-success{background-color:var(--mds-pref-theme-item-color-status-success,rgb(var(--magma-success-emphasis,var(--status-success-04,0 128 57))))}.theme-color--status-warning{background-color:var(--mds-pref-theme-item-color-status-warning,rgb(var(--magma-warning-emphasis,var(--status-warning-04,142 106 0))))}.theme-color--status-error{background-color:var(--mds-pref-theme-item-color-status-error,rgb(var(--magma-danger-emphasis,var(--status-error-04,196 64 65))))}`;
6
+ const mdsPrefThemeItemCss = () => `@layer reset,vendor,theme,base,components,utilities;:host(:not(:is([hydrated],.hydrated))),mds-button:not(:is([hydrated],.hydrated)){animation-duration:0s;border-color:#0000;box-shadow:0 0 #0000;opacity:0;outline-color:#0000;transition-delay:.1s;transition-duration:0s;visibility:hidden}:host{--mds-pref-theme-item-color-background:rgb(var(--private-theme-wash,var(--magma-wash-base,var(--tone-neutral-09,225 225 225))));--mds-pref-theme-item-color-status-error:rgb(var(--magma-danger-emphasis,var(--status-error-04,196 64 65)));--mds-pref-theme-item-color-status-success:rgb(var(--magma-success-emphasis,var(--status-success-04,0 128 57)));--mds-pref-theme-item-color-status-warning:rgb(var(--magma-warning-emphasis,var(--status-warning-04,142 106 0)));--mds-pref-theme-item-color-variant-primary:rgb(var(--private-theme-accent,var(--magma-accent-emphasis,var(--variant-primary-04,36 103 231))));align-items:center;cursor:pointer;display:flex;gap:calc(var(--spacing,.0025rem)*400);justify-content:space-between}.theme-preview{box-shadow:var(--shadow-ring-weak,0 0 0 1px rgb(var(--tone-neutral-01,5 5 5)/.15));box-sizing:border-box;display:inline-flex;flex:none;flex-wrap:wrap;gap:calc(var(--spacing,.0025rem)*100);height:calc(var(--spacing,.0025rem)*600);margin:1px;padding:calc(var(--spacing,.0025rem)*100);width:calc(var(--spacing,.0025rem)*600)}.theme-color,.theme-preview{background-color:var(--mds-pref-theme-item-color-background,rgb(var(--magma-wash-base,var(--tone-neutral-09,225 225 225))));border-radius:var(--magma-radius-full,var(--radius-full,1000px))}.theme-color{height:calc(var(--spacing,.0025rem)*150);position:relative;width:calc(var(--spacing,.0025rem)*150)}.theme-color:after{border-radius:inherit;box-shadow:var(--shadow-ring-weak,0 0 0 1px rgb(var(--tone-neutral-01,5 5 5)/.15)) inset;content:"";display:flex;inset:0;position:absolute}.theme-color--variant-primary{background-color:var(--mds-pref-theme-item-color-variant-primary,rgb(var(--magma-accent-emphasis,var(--variant-primary-04,36 103 231))))}.theme-color--status-success{background-color:var(--mds-pref-theme-item-color-status-success,rgb(var(--magma-success-emphasis,var(--status-success-04,0 128 57))))}.theme-color--status-warning{background-color:var(--mds-pref-theme-item-color-status-warning,rgb(var(--magma-warning-emphasis,var(--status-warning-04,142 106 0))))}.theme-color--status-error{background-color:var(--mds-pref-theme-item-color-status-error,rgb(var(--magma-danger-emphasis,var(--status-error-04,196 64 65))))}`;
7
7
 
8
+ /** The names mds-pref-theme accepts: a theme's preview custom properties carry the name. */
9
+ const THEME_NAME = /^[a-z]+(-[a-z]+)*$/;
8
10
  const MdsPrefThemeItem = class {
9
11
  constructor(hostRef) {
10
12
  registerInstance(this, hostRef);
11
13
  this.selectThemeEvent = createEvent(this, "mdsPrefThemeItemSelect", 7);
12
14
  /**
13
- * Specifies the theme name
14
- * @example 'maggioli-editore'
15
+ * Specifies the theme name; the swatch shows the preview that theme publishes,
16
+ * `--magma-preview-<name>-wash` and `--magma-preview-<name>-accent`
17
+ * @example 'editorial'
15
18
  */
16
19
  this.name = 'default';
17
20
  /**
@@ -25,6 +28,17 @@ const MdsPrefThemeItem = class {
25
28
  this.handleClick = () => {
26
29
  this.selectThemeEvent.emit({ name: this.name, scheme: this.scheme });
27
30
  };
31
+ /**
32
+ * The preview of the theme the item names, which the styles of that theme publish on the page
33
+ * (`--magma-preview-<name>-{wash,accent}`, #692), so the item shows its own theme and not the
34
+ * active one. The stylesheet falls back to the active theme when a theme publishes none.
35
+ */
36
+ this.previewStyle = () => THEME_NAME.test(this.name)
37
+ ? {
38
+ '--private-theme-wash': `var(--magma-preview-${this.name}-wash)`,
39
+ '--private-theme-accent': `var(--magma-preview-${this.name}-accent)`,
40
+ }
41
+ : undefined;
28
42
  }
29
43
  componentWillRender() {
30
44
  var _a;
@@ -36,7 +50,7 @@ const MdsPrefThemeItem = class {
36
50
  return (
37
51
  // the item is an entry of the `menu` the mds-dropdown of the controller opens:
38
52
  // without the role axe rejects it as a child of that menu (aria-required-children)
39
- h(Host, { key: '167ef44045cb7292a32c73669516c6fb9c686686', onClick: this.handleClick, role: "menuitem" }, h("mds-button", { key: '62368f8c0500ead7f3efef7dc4464e90fa4e9c4f', icon: this.selected ? miBaselineCheckCircle : miOutlineCircle, variant: "dark", tone: "text", label: this.label }), h("span", { key: 'cca2d409f862a20476cbf2de195506c21d26faab', "aria-hidden": "true", class: "theme-preview" }, h("span", { key: 'e4d5f799fa31cbe336a18b8caeb65abc95c8ed1f', class: "theme-color theme-color--variant-primary" }), h("span", { key: 'a0d9672e7e59c86147cbe2cf0d4006c14b8b9b82', class: "theme-color theme-color--status-success" }), h("span", { key: '86f92c2637a84aa08ff6b4d2bced727e66f6533d', class: "theme-color theme-color--status-warning" }), h("span", { key: 'fc15c8e6dc928760e2aa9dbad27a8250fd194d00', class: "theme-color theme-color--status-error" }))));
53
+ h(Host, { key: '9c661ea96838a5a35e21542a8ab828de72b72232', onClick: this.handleClick, role: "menuitem", style: this.previewStyle() }, h("mds-button", { key: 'd32ad7640495df018039cee369f6d2030f4c603a', icon: this.selected ? miBaselineCheckCircle : miOutlineCircle, variant: "dark", tone: "text", label: this.label }), h("span", { key: '92454f1d894be41e1910c88ad4e87251273bc0a7', "aria-hidden": "true", class: "theme-preview" }, h("span", { key: '050ec8db2ed0e2da24d734bb35d7af76182c5863', class: "theme-color theme-color--variant-primary" }), h("span", { key: '885fb77194d5db974e6381dc63213e6fb92bf373', class: "theme-color theme-color--status-success" }), h("span", { key: '578000638746de1cee794b4eea58390052a6e36d', class: "theme-color theme-color--status-warning" }), h("span", { key: '10b15e7fd8e18327bd9c868e5b7950ec544b0e41', class: "theme-color theme-color--status-error" }))));
40
54
  }
41
55
  };
42
56
  MdsPrefThemeItem.style = mdsPrefThemeItemCss();
@@ -46,6 +46,15 @@ var localeIt = {
46
46
 
47
47
  const mdsPrefThemeCss = () => `@layer reset,vendor,theme,base,components,utilities;:host(:not(:is([hydrated],.hydrated))),:is(mds-dropdown,mds-tab,mds-tab-item,mds-text):not(:is([hydrated],.hydrated)){animation-duration:0s;border-color:#0000;box-shadow:0 0 #0000;opacity:0;outline-color:#0000;transition-delay:.1s;transition-duration:0s;visibility:hidden}:host{display:grid;gap:calc(var(--spacing,.0025rem)*400)}.menu{display:grid;gap:calc(var(--spacing,.0025rem)*200)}.mds-pref-theme-dropdown{gap:calc(var(--spacing,.0025rem)*100);padding:calc(var(--spacing,.0025rem)*400)}.item{--mds-tab-item-default-color:rgb(var(--magma-text-disabled,var(--text-neutral-disabled,119 119 119)));flex-basis:0;flex-grow:1}.item--theme{cursor:pointer}.item--auto,.item--theme{--mds-tab-item-selected-color:rgb(var(--magma-text-muted,var(--text-neutral-muted,73 73 73)))}`;
48
48
 
49
+ /**
50
+ * `default` is the old name of `business`, the base theme (the `themes` map of
51
+ * semantic.config.ts, #692): the same theme, so an item of either name stands for it. The
52
+ * component keeps `default` as the default of `name` until the next major makes it `business`.
53
+ */
54
+ const sameTheme = (a, b) => {
55
+ const base = (name) => (name === 'default' ? 'business' : name);
56
+ return base(a) === base(b);
57
+ };
49
58
  const MdsPrefTheme = class {
50
59
  constructor(hostRef) {
51
60
  registerInstance(this, hostRef);
@@ -107,7 +116,7 @@ const MdsPrefTheme = class {
107
116
  * shows it, or, when no item matches, the label an item derives from the name.
108
117
  */
109
118
  this.triggerLabel = () => {
110
- 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; });
119
+ 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); });
111
120
  return (item === null || item === void 0 ? void 0 : item.label) || (item === null || item === void 0 ? void 0 : item.getAttribute('label')) || labelFromName(this.name);
112
121
  };
113
122
  this.toggleDropdown = () => {
@@ -125,7 +134,7 @@ const MdsPrefTheme = class {
125
134
  this.checkThemeSelect = () => {
126
135
  this.themeItems = this.element.querySelectorAll('mds-pref-theme-item');
127
136
  this.themeItems.forEach((element) => {
128
- element.selected = element.name === this.name;
137
+ element.selected = sameTheme(element.name, this.name);
129
138
  });
130
139
  };
131
140
  this.setTheme = (name, scheme) => {
@@ -284,7 +293,7 @@ const MdsPrefTheme = class {
284
293
  this.setTheme(name, scheme);
285
294
  }
286
295
  render() {
287
- 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 }))));
296
+ return (h(Host, { key: 'd43c9d9bfaac3c3f997748228db2fccafb1307d2' }, h("div", { key: 'ddd730c6efb781df542701cbdc21d0874caf4c0a', class: "menu" }, h("mds-text", { key: 'ab88bdac3ca42505844dc35ab5a587fce8596c62', class: "info", typography: "caption" }, h("b", { key: 'acdc9a0ba564059ef013cb547f4e2eeda63ed2f2' }, this.t.get('label'))), h("mds-tab", { key: 'd7c052bcd02f7858ba0e9b2640e49c91530febc5', fill: true, size: this.size }, h("mds-tab-item", { key: '5ff16c9622437ff463aa3711387a53e6dc7f5796', 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: '23ee30b64e2faec6f3f40e2c6d3a6e2a31161dbe', class: "mds-pref-theme-dropdown", target: "#mds-pref-theme-nav", interaction: "none", visible: this.showDropdown, onMdsDropdownHide: this.hideThemeDropdownSelect }, h("slot", { key: 'd26613bc60c31fde855cfcbb2935b91b34c7db3f', onSlotchange: this.checkThemeSelect }))));
288
297
  }
289
298
  get element() { return getElement(this); }
290
299
  static get watchers() { return {