@maggioli-design-system/magma 2.9.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 (2067) hide show
  1. package/AGENTS.md +10 -7
  2. package/CHANGELOG.md +109 -0
  3. package/README.md +56 -0
  4. package/agents/assets.md +2 -2
  5. package/agents/color.md +7 -5
  6. package/agents/components.md +2 -2
  7. package/agents/conventions.md +1 -1
  8. package/agents/mcp.md +78 -8
  9. package/agents/mistakes.md +42 -0
  10. package/agents/patterns/actions.md +393 -0
  11. package/agents/patterns/app-shell.md +223 -0
  12. package/agents/patterns/choose-items.md +18 -0
  13. package/agents/patterns/concurrent-editing.md +17 -0
  14. package/agents/patterns/confirm-action.md +216 -0
  15. package/agents/patterns/consent-and-legal.md +16 -0
  16. package/agents/patterns/density.md +236 -0
  17. package/agents/patterns/empty-state.md +201 -0
  18. package/agents/patterns/error-recovery.md +237 -0
  19. package/agents/patterns/form-and-validation.md +16 -0
  20. package/agents/patterns/item-list.md +214 -0
  21. package/agents/patterns/labels-and-values.md +184 -0
  22. package/agents/patterns/list-with-filters.md +282 -0
  23. package/agents/patterns/loading.md +221 -0
  24. package/agents/patterns/message-placement.md +304 -0
  25. package/agents/patterns/notification-center.md +18 -0
  26. package/agents/patterns/page-header.md +201 -0
  27. package/agents/patterns/permissions.md +17 -0
  28. package/agents/patterns/previews/actions/banner.dark.webp +0 -0
  29. package/agents/patterns/previews/actions/banner.html +21 -0
  30. package/agents/patterns/previews/actions/banner.light.webp +0 -0
  31. package/agents/patterns/previews/actions/confirm.dark.webp +0 -0
  32. package/agents/patterns/previews/actions/confirm.html +11 -0
  33. package/agents/patterns/previews/actions/confirm.light.webp +0 -0
  34. package/agents/patterns/previews/actions/danger-zone.dark.webp +0 -0
  35. package/agents/patterns/previews/actions/danger-zone.html +22 -0
  36. package/agents/patterns/previews/actions/danger-zone.light.webp +0 -0
  37. package/agents/patterns/previews/actions/destructive-in-menu.dark.webp +0 -0
  38. package/agents/patterns/previews/actions/destructive-in-menu.html +19 -0
  39. package/agents/patterns/previews/actions/destructive-in-menu.light.webp +0 -0
  40. package/agents/patterns/previews/actions/dismiss-message.dark.webp +0 -0
  41. package/agents/patterns/previews/actions/dismiss-message.html +15 -0
  42. package/agents/patterns/previews/actions/dismiss-message.light.webp +0 -0
  43. package/agents/patterns/previews/actions/dismiss.dark.webp +0 -0
  44. package/agents/patterns/previews/actions/dismiss.html +25 -0
  45. package/agents/patterns/previews/actions/dismiss.light.webp +0 -0
  46. package/agents/patterns/previews/actions/more-in-menu.dark.webp +0 -0
  47. package/agents/patterns/previews/actions/more-in-menu.html +21 -0
  48. package/agents/patterns/previews/actions/more-in-menu.light.webp +0 -0
  49. package/agents/patterns/previews/actions/part-primary.dark.webp +0 -0
  50. package/agents/patterns/previews/actions/part-primary.html +28 -0
  51. package/agents/patterns/previews/actions/part-primary.light.webp +0 -0
  52. package/agents/patterns/previews/actions/primary.dark.webp +0 -0
  53. package/agents/patterns/previews/actions/primary.html +20 -0
  54. package/agents/patterns/previews/actions/primary.light.webp +0 -0
  55. package/agents/patterns/previews/actions/remove.dark.webp +0 -0
  56. package/agents/patterns/previews/actions/remove.html +44 -0
  57. package/agents/patterns/previews/actions/remove.light.webp +0 -0
  58. package/agents/patterns/previews/actions/secondary.dark.webp +0 -0
  59. package/agents/patterns/previews/actions/secondary.html +20 -0
  60. package/agents/patterns/previews/actions/secondary.light.webp +0 -0
  61. package/agents/patterns/previews/actions/stacked.dark.webp +0 -0
  62. package/agents/patterns/previews/actions/stacked.html +17 -0
  63. package/agents/patterns/previews/actions/stacked.light.webp +0 -0
  64. package/agents/patterns/previews/actions/toast.dark.webp +0 -0
  65. package/agents/patterns/previews/actions/toast.html +10 -0
  66. package/agents/patterns/previews/actions/toast.light.webp +0 -0
  67. package/agents/patterns/previews/app-shell/back-office.dark.webp +0 -0
  68. package/agents/patterns/previews/app-shell/back-office.html +41 -0
  69. package/agents/patterns/previews/app-shell/back-office.light.webp +0 -0
  70. package/agents/patterns/previews/app-shell/many-sections.dark.webp +0 -0
  71. package/agents/patterns/previews/app-shell/many-sections.html +45 -0
  72. package/agents/patterns/previews/app-shell/many-sections.light.webp +0 -0
  73. package/agents/patterns/previews/app-shell/public-service.dark.webp +0 -0
  74. package/agents/patterns/previews/app-shell/public-service.html +31 -0
  75. package/agents/patterns/previews/app-shell/public-service.light.webp +0 -0
  76. package/agents/patterns/previews/confirm-action/act-then-undo.dark.webp +0 -0
  77. package/agents/patterns/previews/confirm-action/act-then-undo.html +44 -0
  78. package/agents/patterns/previews/confirm-action/act-then-undo.light.webp +0 -0
  79. package/agents/patterns/previews/confirm-action/ask-before-sending.dark.webp +0 -0
  80. package/agents/patterns/previews/confirm-action/ask-before-sending.html +25 -0
  81. package/agents/patterns/previews/confirm-action/ask-before-sending.light.webp +0 -0
  82. package/agents/patterns/previews/confirm-action/ask-first-many.dark.webp +0 -0
  83. package/agents/patterns/previews/confirm-action/ask-first-many.html +11 -0
  84. package/agents/patterns/previews/confirm-action/ask-first-many.light.webp +0 -0
  85. package/agents/patterns/previews/confirm-action/ask-first.dark.webp +0 -0
  86. package/agents/patterns/previews/confirm-action/ask-first.html +14 -0
  87. package/agents/patterns/previews/confirm-action/ask-first.light.webp +0 -0
  88. package/agents/patterns/previews/confirm-action/make-reversible.dark.webp +0 -0
  89. package/agents/patterns/previews/confirm-action/make-reversible.html +54 -0
  90. package/agents/patterns/previews/confirm-action/make-reversible.light.webp +0 -0
  91. package/agents/patterns/previews/confirm-action/send-as-shown.dark.webp +0 -0
  92. package/agents/patterns/previews/confirm-action/send-as-shown.html +57 -0
  93. package/agents/patterns/previews/confirm-action/send-as-shown.light.webp +0 -0
  94. package/agents/patterns/previews/empty-state/add-the-first.dark.webp +0 -0
  95. package/agents/patterns/previews/empty-state/add-the-first.html +19 -0
  96. package/agents/patterns/previews/empty-state/add-the-first.light.webp +0 -0
  97. package/agents/patterns/previews/empty-state/all-done.dark.webp +0 -0
  98. package/agents/patterns/previews/empty-state/all-done.html +15 -0
  99. package/agents/patterns/previews/empty-state/all-done.light.webp +0 -0
  100. package/agents/patterns/previews/empty-state/clear-filters.dark.webp +0 -0
  101. package/agents/patterns/previews/empty-state/clear-filters.html +35 -0
  102. package/agents/patterns/previews/empty-state/clear-filters.light.webp +0 -0
  103. package/agents/patterns/previews/empty-state/filled-by-others.dark.webp +0 -0
  104. package/agents/patterns/previews/empty-state/filled-by-others.html +15 -0
  105. package/agents/patterns/previews/empty-state/filled-by-others.light.webp +0 -0
  106. package/agents/patterns/previews/empty-state/not-found.dark.webp +0 -0
  107. package/agents/patterns/previews/empty-state/not-found.html +38 -0
  108. package/agents/patterns/previews/empty-state/not-found.light.webp +0 -0
  109. package/agents/patterns/previews/empty-state/one-line.dark.webp +0 -0
  110. package/agents/patterns/previews/empty-state/one-line.html +12 -0
  111. package/agents/patterns/previews/empty-state/one-line.light.webp +0 -0
  112. package/agents/patterns/previews/error-recovery/action-another-way.dark.webp +0 -0
  113. package/agents/patterns/previews/error-recovery/action-another-way.html +35 -0
  114. package/agents/patterns/previews/error-recovery/action-another-way.light.webp +0 -0
  115. package/agents/patterns/previews/error-recovery/changed-meanwhile.dark.webp +0 -0
  116. package/agents/patterns/previews/error-recovery/changed-meanwhile.html +26 -0
  117. package/agents/patterns/previews/error-recovery/changed-meanwhile.light.webp +0 -0
  118. package/agents/patterns/previews/error-recovery/check-or-repeat.dark.webp +0 -0
  119. package/agents/patterns/previews/error-recovery/check-or-repeat.html +38 -0
  120. package/agents/patterns/previews/error-recovery/check-or-repeat.light.webp +0 -0
  121. package/agents/patterns/previews/error-recovery/content-another-way.dark.webp +0 -0
  122. package/agents/patterns/previews/error-recovery/content-another-way.html +12 -0
  123. package/agents/patterns/previews/error-recovery/content-another-way.light.webp +0 -0
  124. package/agents/patterns/previews/error-recovery/partial.dark.webp +0 -0
  125. package/agents/patterns/previews/error-recovery/partial.html +29 -0
  126. package/agents/patterns/previews/error-recovery/partial.light.webp +0 -0
  127. package/agents/patterns/previews/error-recovery/retry-action.dark.webp +0 -0
  128. package/agents/patterns/previews/error-recovery/retry-action.html +35 -0
  129. package/agents/patterns/previews/error-recovery/retry-action.light.webp +0 -0
  130. package/agents/patterns/previews/error-recovery/retry-content.dark.webp +0 -0
  131. package/agents/patterns/previews/error-recovery/retry-content.html +40 -0
  132. package/agents/patterns/previews/error-recovery/retry-content.light.webp +0 -0
  133. package/agents/patterns/previews/error-recovery/sign-in-again.dark.webp +0 -0
  134. package/agents/patterns/previews/error-recovery/sign-in-again.html +44 -0
  135. package/agents/patterns/previews/error-recovery/sign-in-again.light.webp +0 -0
  136. package/agents/patterns/previews/item-list/documents-of-a-request.dark.webp +0 -0
  137. package/agents/patterns/previews/item-list/documents-of-a-request.html +12 -0
  138. package/agents/patterns/previews/item-list/documents-of-a-request.light.webp +0 -0
  139. package/agents/patterns/previews/item-list/queue-of-a-desk.dark.webp +0 -0
  140. package/agents/patterns/previews/item-list/queue-of-a-desk.html +109 -0
  141. package/agents/patterns/previews/item-list/queue-of-a-desk.light.webp +0 -0
  142. package/agents/patterns/previews/item-list/requests-of-an-office.dark.webp +0 -0
  143. package/agents/patterns/previews/item-list/requests-of-an-office.html +74 -0
  144. package/agents/patterns/previews/item-list/requests-of-an-office.light.webp +0 -0
  145. package/agents/patterns/previews/item-list/requests-to-assign.dark.webp +0 -0
  146. package/agents/patterns/previews/item-list/requests-to-assign.html +80 -0
  147. package/agents/patterns/previews/item-list/requests-to-assign.light.webp +0 -0
  148. package/agents/patterns/previews/labels-and-values/data-of-a-contact.dark.webp +0 -0
  149. package/agents/patterns/previews/labels-and-values/data-of-a-contact.html +31 -0
  150. package/agents/patterns/previews/labels-and-values/data-of-a-contact.light.webp +0 -0
  151. package/agents/patterns/previews/labels-and-values/payment-before-paying.dark.webp +0 -0
  152. package/agents/patterns/previews/labels-and-values/payment-before-paying.html +21 -0
  153. package/agents/patterns/previews/labels-and-values/payment-before-paying.light.webp +0 -0
  154. package/agents/patterns/previews/labels-and-values/what-is-sent.dark.webp +0 -0
  155. package/agents/patterns/previews/labels-and-values/what-is-sent.html +25 -0
  156. package/agents/patterns/previews/labels-and-values/what-is-sent.light.webp +0 -0
  157. package/agents/patterns/previews/list-with-filters/act-on-many.dark.webp +0 -0
  158. package/agents/patterns/previews/list-with-filters/act-on-many.html +121 -0
  159. package/agents/patterns/previews/list-with-filters/act-on-many.light.webp +0 -0
  160. package/agents/patterns/previews/list-with-filters/find-and-open.dark.webp +0 -0
  161. package/agents/patterns/previews/list-with-filters/find-and-open.html +109 -0
  162. package/agents/patterns/previews/list-with-filters/find-and-open.light.webp +0 -0
  163. package/agents/patterns/previews/list-with-filters/show-new-items.dark.webp +0 -0
  164. package/agents/patterns/previews/list-with-filters/show-new-items.html +132 -0
  165. package/agents/patterns/previews/list-with-filters/show-new-items.light.webp +0 -0
  166. package/agents/patterns/previews/loading/await-and-say.dark.webp +0 -0
  167. package/agents/patterns/previews/loading/await-and-say.html +41 -0
  168. package/agents/patterns/previews/loading/await-and-say.light.webp +0 -0
  169. package/agents/patterns/previews/loading/await-the-control.dark.webp +0 -0
  170. package/agents/patterns/previews/loading/await-the-control.html +28 -0
  171. package/agents/patterns/previews/loading/await-the-control.light.webp +0 -0
  172. package/agents/patterns/previews/loading/first-load.dark.webp +0 -0
  173. package/agents/patterns/previews/loading/first-load.html +10 -0
  174. package/agents/patterns/previews/loading/first-load.light.webp +0 -0
  175. package/agents/patterns/previews/loading/keep-while-reloading.dark.webp +0 -0
  176. package/agents/patterns/previews/loading/keep-while-reloading.html +80 -0
  177. package/agents/patterns/previews/loading/keep-while-reloading.light.webp +0 -0
  178. package/agents/patterns/previews/loading/long-load-measured.dark.webp +0 -0
  179. package/agents/patterns/previews/loading/long-load-measured.html +16 -0
  180. package/agents/patterns/previews/loading/long-load-measured.light.webp +0 -0
  181. package/agents/patterns/previews/loading/long-load.dark.webp +0 -0
  182. package/agents/patterns/previews/loading/long-load.html +12 -0
  183. package/agents/patterns/previews/loading/long-load.light.webp +0 -0
  184. package/agents/patterns/previews/loading/progress-in-place.dark.webp +0 -0
  185. package/agents/patterns/previews/loading/progress-in-place.html +52 -0
  186. package/agents/patterns/previews/loading/progress-in-place.light.webp +0 -0
  187. package/agents/patterns/previews/loading/run-in-background.dark.webp +0 -0
  188. package/agents/patterns/previews/loading/run-in-background.html +24 -0
  189. package/agents/patterns/previews/loading/run-in-background.light.webp +0 -0
  190. package/agents/patterns/previews/message-placement/action-done-elsewhere.dark.webp +0 -0
  191. package/agents/patterns/previews/message-placement/action-done-elsewhere.html +38 -0
  192. package/agents/patterns/previews/message-placement/action-done-elsewhere.light.webp +0 -0
  193. package/agents/patterns/previews/message-placement/action-done-in-page.dark.webp +0 -0
  194. package/agents/patterns/previews/message-placement/action-done-in-page.html +53 -0
  195. package/agents/patterns/previews/message-placement/action-done-in-page.light.webp +0 -0
  196. package/agents/patterns/previews/message-placement/action-done-in-part.dark.webp +0 -0
  197. package/agents/patterns/previews/message-placement/action-done-in-part.html +42 -0
  198. package/agents/patterns/previews/message-placement/action-done-in-part.light.webp +0 -0
  199. package/agents/patterns/previews/message-placement/action-failed-elsewhere.dark.webp +0 -0
  200. package/agents/patterns/previews/message-placement/action-failed-elsewhere.html +40 -0
  201. package/agents/patterns/previews/message-placement/action-failed-elsewhere.light.webp +0 -0
  202. package/agents/patterns/previews/message-placement/action-failed-in-place.dark.webp +0 -0
  203. package/agents/patterns/previews/message-placement/action-failed-in-place.html +31 -0
  204. package/agents/patterns/previews/message-placement/action-failed-in-place.light.webp +0 -0
  205. package/agents/patterns/previews/message-placement/action-later.dark.webp +0 -0
  206. package/agents/patterns/previews/message-placement/action-later.html +24 -0
  207. package/agents/patterns/previews/message-placement/action-later.light.webp +0 -0
  208. package/agents/patterns/previews/message-placement/action-partial-elsewhere.dark.webp +0 -0
  209. package/agents/patterns/previews/message-placement/action-partial-elsewhere.html +33 -0
  210. package/agents/patterns/previews/message-placement/action-partial-elsewhere.light.webp +0 -0
  211. package/agents/patterns/previews/message-placement/action-partial-in-place.dark.webp +0 -0
  212. package/agents/patterns/previews/message-placement/action-partial-in-place.html +51 -0
  213. package/agents/patterns/previews/message-placement/action-partial-in-place.light.webp +0 -0
  214. package/agents/patterns/previews/message-placement/action-taken.dark.webp +0 -0
  215. package/agents/patterns/previews/message-placement/action-taken.html +25 -0
  216. package/agents/patterns/previews/message-placement/action-taken.light.webp +0 -0
  217. package/agents/patterns/previews/message-placement/app-deadline.dark.webp +0 -0
  218. package/agents/patterns/previews/message-placement/app-deadline.html +20 -0
  219. package/agents/patterns/previews/message-placement/app-deadline.light.webp +0 -0
  220. package/agents/patterns/previews/message-placement/app-failed.dark.webp +0 -0
  221. package/agents/patterns/previews/message-placement/app-failed.html +48 -0
  222. package/agents/patterns/previews/message-placement/app-failed.light.webp +0 -0
  223. package/agents/patterns/previews/message-placement/app-info.dark.webp +0 -0
  224. package/agents/patterns/previews/message-placement/app-info.html +39 -0
  225. package/agents/patterns/previews/message-placement/app-info.light.webp +0 -0
  226. package/agents/patterns/previews/message-placement/decision.dark.webp +0 -0
  227. package/agents/patterns/previews/message-placement/decision.html +49 -0
  228. package/agents/patterns/previews/message-placement/decision.light.webp +0 -0
  229. package/agents/patterns/previews/message-placement/field-error.dark.webp +0 -0
  230. package/agents/patterns/previews/message-placement/field-error.html +28 -0
  231. package/agents/patterns/previews/message-placement/field-error.light.webp +0 -0
  232. package/agents/patterns/previews/message-placement/field-hint.dark.webp +0 -0
  233. package/agents/patterns/previews/message-placement/field-hint.html +30 -0
  234. package/agents/patterns/previews/message-placement/field-hint.light.webp +0 -0
  235. package/agents/patterns/previews/message-placement/field-valid.dark.webp +0 -0
  236. package/agents/patterns/previews/message-placement/field-valid.html +11 -0
  237. package/agents/patterns/previews/message-placement/field-valid.light.webp +0 -0
  238. package/agents/patterns/previews/message-placement/region-failed.dark.webp +0 -0
  239. package/agents/patterns/previews/message-placement/region-failed.html +31 -0
  240. package/agents/patterns/previews/message-placement/region-failed.light.webp +0 -0
  241. package/agents/patterns/previews/message-placement/region-info.dark.webp +0 -0
  242. package/agents/patterns/previews/message-placement/region-info.html +16 -0
  243. package/agents/patterns/previews/message-placement/region-info.light.webp +0 -0
  244. package/agents/patterns/previews/page-header/contact-being-edited.dark.webp +0 -0
  245. package/agents/patterns/previews/page-header/contact-being-edited.html +25 -0
  246. package/agents/patterns/previews/page-header/contact-being-edited.light.webp +0 -0
  247. package/agents/patterns/previews/page-header/members-of-a-group.dark.webp +0 -0
  248. package/agents/patterns/previews/page-header/members-of-a-group.html +18 -0
  249. package/agents/patterns/previews/page-header/members-of-a-group.light.webp +0 -0
  250. package/agents/patterns/previews/page-header/own-profile.dark.webp +0 -0
  251. package/agents/patterns/previews/page-header/own-profile.html +17 -0
  252. package/agents/patterns/previews/page-header/own-profile.light.webp +0 -0
  253. package/agents/patterns/previews/page-header/request-from-the-list.dark.webp +0 -0
  254. package/agents/patterns/previews/page-header/request-from-the-list.html +33 -0
  255. package/agents/patterns/previews/page-header/request-from-the-list.light.webp +0 -0
  256. package/agents/patterns/previews/page-header/requests-of-an-office.dark.webp +0 -0
  257. package/agents/patterns/previews/page-header/requests-of-an-office.html +16 -0
  258. package/agents/patterns/previews/page-header/requests-of-an-office.light.webp +0 -0
  259. package/agents/patterns/previews/record-detail/ask-for-words.dark.webp +0 -0
  260. package/agents/patterns/previews/record-detail/ask-for-words.html +72 -0
  261. package/agents/patterns/previews/record-detail/ask-for-words.light.webp +0 -0
  262. package/agents/patterns/previews/record-detail/edit-data.dark.webp +0 -0
  263. package/agents/patterns/previews/record-detail/edit-data.html +104 -0
  264. package/agents/patterns/previews/record-detail/edit-data.light.webp +0 -0
  265. package/agents/patterns/previews/record-detail/read-the-data.dark.webp +0 -0
  266. package/agents/patterns/previews/record-detail/read-the-data.html +80 -0
  267. package/agents/patterns/previews/record-detail/read-the-data.light.webp +0 -0
  268. package/agents/patterns/previews/record-detail/record-changed.dark.webp +0 -0
  269. package/agents/patterns/previews/record-detail/record-changed.html +87 -0
  270. package/agents/patterns/previews/record-detail/record-changed.light.webp +0 -0
  271. package/agents/patterns/previews/record-detail/run-at-once.dark.webp +0 -0
  272. package/agents/patterns/previews/record-detail/run-at-once.html +88 -0
  273. package/agents/patterns/previews/record-detail/run-at-once.light.webp +0 -0
  274. package/agents/patterns/previews/record-detail/work-on-it.dark.webp +0 -0
  275. package/agents/patterns/previews/record-detail/work-on-it.html +106 -0
  276. package/agents/patterns/previews/record-detail/work-on-it.light.webp +0 -0
  277. package/agents/patterns/previews/rhythm/between-containers.dark.webp +0 -0
  278. package/agents/patterns/previews/rhythm/between-containers.html +29 -0
  279. package/agents/patterns/previews/rhythm/between-containers.light.webp +0 -0
  280. package/agents/patterns/previews/rhythm/between-fields.dark.webp +0 -0
  281. package/agents/patterns/previews/rhythm/between-fields.html +14 -0
  282. package/agents/patterns/previews/rhythm/between-fields.light.webp +0 -0
  283. package/agents/patterns/previews/rhythm/between-groups.dark.webp +0 -0
  284. package/agents/patterns/previews/rhythm/between-groups.html +23 -0
  285. package/agents/patterns/previews/rhythm/between-groups.light.webp +0 -0
  286. package/agents/patterns/previews/rhythm/between-sections.dark.webp +0 -0
  287. package/agents/patterns/previews/rhythm/between-sections.html +17 -0
  288. package/agents/patterns/previews/rhythm/between-sections.light.webp +0 -0
  289. package/agents/patterns/previews/rhythm/content-actions.dark.webp +0 -0
  290. package/agents/patterns/previews/rhythm/content-actions.html +14 -0
  291. package/agents/patterns/previews/rhythm/content-actions.light.webp +0 -0
  292. package/agents/patterns/previews/rhythm/inline.dark.webp +0 -0
  293. package/agents/patterns/previews/rhythm/inline.html +12 -0
  294. package/agents/patterns/previews/rhythm/inline.light.webp +0 -0
  295. package/agents/patterns/previews/rhythm/inset.dark.webp +0 -0
  296. package/agents/patterns/previews/rhythm/inset.html +11 -0
  297. package/agents/patterns/previews/rhythm/inset.light.webp +0 -0
  298. package/agents/patterns/previews/rhythm/label-control.dark.webp +0 -0
  299. package/agents/patterns/previews/rhythm/label-control.html +8 -0
  300. package/agents/patterns/previews/rhythm/label-control.light.webp +0 -0
  301. package/agents/patterns/previews/rhythm/title-content.dark.webp +0 -0
  302. package/agents/patterns/previews/rhythm/title-content.html +10 -0
  303. package/agents/patterns/previews/rhythm/title-content.light.webp +0 -0
  304. package/agents/patterns/previews/surfaces/band.dark.webp +0 -0
  305. package/agents/patterns/previews/surfaces/band.html +73 -0
  306. package/agents/patterns/previews/surfaces/band.light.webp +0 -0
  307. package/agents/patterns/previews/surfaces/canvas.dark.webp +0 -0
  308. package/agents/patterns/previews/surfaces/canvas.html +66 -0
  309. package/agents/patterns/previews/surfaces/canvas.light.webp +0 -0
  310. package/agents/patterns/previews/surfaces/card.dark.webp +0 -0
  311. package/agents/patterns/previews/surfaces/card.html +30 -0
  312. package/agents/patterns/previews/surfaces/card.light.webp +0 -0
  313. package/agents/patterns/previews/surfaces/dialog.dark.webp +0 -0
  314. package/agents/patterns/previews/surfaces/dialog.html +28 -0
  315. package/agents/patterns/previews/surfaces/dialog.light.webp +0 -0
  316. package/agents/patterns/previews/surfaces/edit-actions.dark.webp +0 -0
  317. package/agents/patterns/previews/surfaces/edit-actions.html +35 -0
  318. package/agents/patterns/previews/surfaces/edit-actions.light.webp +0 -0
  319. package/agents/patterns/previews/surfaces/section.dark.webp +0 -0
  320. package/agents/patterns/previews/surfaces/section.html +35 -0
  321. package/agents/patterns/previews/surfaces/section.light.webp +0 -0
  322. package/agents/patterns/previews/titles/dialog.dark.webp +0 -0
  323. package/agents/patterns/previews/titles/dialog.html +18 -0
  324. package/agents/patterns/previews/titles/dialog.light.webp +0 -0
  325. package/agents/patterns/previews/titles/group.dark.webp +0 -0
  326. package/agents/patterns/previews/titles/group.html +14 -0
  327. package/agents/patterns/previews/titles/group.light.webp +0 -0
  328. package/agents/patterns/previews/titles/page.dark.webp +0 -0
  329. package/agents/patterns/previews/titles/page.html +25 -0
  330. package/agents/patterns/previews/titles/page.light.webp +0 -0
  331. package/agents/patterns/previews/titles/part.dark.webp +0 -0
  332. package/agents/patterns/previews/titles/part.html +24 -0
  333. package/agents/patterns/previews/titles/part.light.webp +0 -0
  334. package/agents/patterns/previews/titles/section.dark.webp +0 -0
  335. package/agents/patterns/previews/titles/section.html +14 -0
  336. package/agents/patterns/previews/titles/section.light.webp +0 -0
  337. package/agents/patterns/previews/widths/dialog.dark.webp +0 -0
  338. package/agents/patterns/previews/widths/dialog.html +33 -0
  339. package/agents/patterns/previews/widths/dialog.light.webp +0 -0
  340. package/agents/patterns/previews/widths/field.dark.webp +0 -0
  341. package/agents/patterns/previews/widths/field.html +20 -0
  342. package/agents/patterns/previews/widths/field.light.webp +0 -0
  343. package/agents/patterns/previews/widths/form.dark.webp +0 -0
  344. package/agents/patterns/previews/widths/form.html +27 -0
  345. package/agents/patterns/previews/widths/form.light.webp +0 -0
  346. package/agents/patterns/previews/widths/page.dark.webp +0 -0
  347. package/agents/patterns/previews/widths/page.html +49 -0
  348. package/agents/patterns/previews/widths/page.light.webp +0 -0
  349. package/agents/patterns/previews/widths/reading.dark.webp +0 -0
  350. package/agents/patterns/previews/widths/reading.html +15 -0
  351. package/agents/patterns/previews/widths/reading.light.webp +0 -0
  352. package/agents/patterns/record-detail.md +268 -0
  353. package/agents/patterns/rhythm.md +212 -0
  354. package/agents/patterns/surfaces.md +212 -0
  355. package/agents/patterns/titles.md +208 -0
  356. package/agents/patterns/widths.md +202 -0
  357. package/agents/patterns.md +121 -0
  358. package/agents/reporting.md +6 -3
  359. package/agents/theming.md +36 -12
  360. package/agents/typography.md +27 -2
  361. package/agents/variants.md +1 -1
  362. package/dist/cjs/loader.cjs.js +1 -1
  363. package/dist/cjs/magma-components.cjs.js +1 -1
  364. package/dist/cjs/mds-accordion-item.cjs.entry.js +6 -3
  365. package/dist/cjs/mds-accordion-timer-item.cjs.entry.js +5 -2
  366. package/dist/cjs/mds-avatar.cjs.entry.js +1 -1
  367. package/dist/cjs/mds-banner_3.cjs.entry.js +3 -3
  368. package/dist/cjs/mds-book.cjs.entry.js +25 -9
  369. package/dist/cjs/mds-button_3.cjs.entry.js +4 -4
  370. package/dist/cjs/mds-card-content.cjs.entry.js +1 -1
  371. package/dist/cjs/mds-card-footer.cjs.entry.js +2 -2
  372. package/dist/cjs/mds-card-header.cjs.entry.js +2 -2
  373. package/dist/cjs/mds-card-media.cjs.entry.js +1 -1
  374. package/dist/cjs/mds-card.cjs.entry.js +1 -1
  375. package/dist/cjs/mds-details.cjs.entry.js +1 -1
  376. package/dist/cjs/mds-dropdown.cjs.entry.js +3 -3
  377. package/dist/cjs/mds-emoji.cjs.entry.js +40 -11
  378. package/dist/cjs/mds-entity.cjs.entry.js +1 -1
  379. package/dist/cjs/mds-file-preview.cjs.entry.js +2 -2
  380. package/dist/cjs/mds-file.cjs.entry.js +1 -1
  381. package/dist/cjs/mds-filter-item.cjs.entry.js +1 -1
  382. package/dist/cjs/mds-filter.cjs.entry.js +1 -1
  383. package/dist/cjs/mds-header-bar.cjs.entry.js +2 -2
  384. package/dist/cjs/mds-header.cjs.entry.js +2 -2
  385. package/dist/cjs/mds-horizontal-scroll.cjs.entry.js +1 -1
  386. package/dist/cjs/mds-hr.cjs.entry.js +1 -1
  387. package/dist/cjs/mds-input-date-range-preselection.cjs.entry.js +1 -1
  388. package/dist/cjs/mds-input-date-range.cjs.entry.js +1 -1
  389. package/dist/cjs/mds-input-date.cjs.entry.js +3 -3
  390. package/dist/cjs/mds-input-field.cjs.entry.js +8 -2
  391. package/dist/cjs/mds-input-otp.cjs.entry.js +1 -1
  392. package/dist/cjs/mds-input-range.cjs.entry.js +1 -1
  393. package/dist/cjs/mds-input-select.cjs.entry.js +3 -3
  394. package/dist/cjs/mds-input-switch_2.cjs.entry.js +4 -4
  395. package/dist/cjs/mds-input-tip_2.cjs.entry.js +3 -3
  396. package/dist/cjs/mds-input-upload.cjs.entry.js +13 -14
  397. package/dist/cjs/mds-input.cjs.entry.js +3 -3
  398. package/dist/cjs/mds-keyboard-key.cjs.entry.js +1 -1
  399. package/dist/cjs/mds-keyboard.cjs.entry.js +1 -1
  400. package/dist/cjs/mds-kpi-item.cjs.entry.js +2 -2
  401. package/dist/cjs/mds-kpi.cjs.entry.js +1 -1
  402. package/dist/cjs/mds-label.cjs.entry.js +1 -1
  403. package/dist/cjs/mds-link.cjs.entry.js +3 -3
  404. package/dist/cjs/mds-list-item.cjs.entry.js +1 -1
  405. package/dist/cjs/mds-list.cjs.entry.js +1 -1
  406. package/dist/cjs/mds-mention.cjs.entry.js +1 -1
  407. package/dist/cjs/mds-modal.cjs.entry.js +4 -4
  408. package/dist/cjs/mds-note.cjs.entry.js +2 -2
  409. package/dist/cjs/mds-notification.cjs.entry.js +45 -2
  410. package/dist/cjs/mds-paginator-item.cjs.entry.js +2 -2
  411. package/dist/cjs/mds-paginator.cjs.entry.js +2 -2
  412. package/dist/cjs/mds-policy-ai.cjs.entry.js +1 -1
  413. package/dist/cjs/mds-pref-animation.cjs.entry.js +1 -1
  414. package/dist/cjs/mds-pref-consumption.cjs.entry.js +1 -1
  415. package/dist/cjs/mds-pref-contrast.cjs.entry.js +1 -1
  416. package/dist/cjs/mds-pref-language-item.cjs.entry.js +1 -1
  417. package/dist/cjs/mds-pref-language.cjs.entry.js +1 -1
  418. package/dist/cjs/mds-pref-mode.cjs.entry.js +1 -1
  419. package/dist/cjs/mds-pref-theme-item.cjs.entry.js +18 -4
  420. package/dist/cjs/mds-pref-theme.cjs.entry.js +12 -3
  421. package/dist/cjs/mds-pref.cjs.entry.js +1 -1
  422. package/dist/cjs/mds-price-table-features-cell.cjs.entry.js +2 -2
  423. package/dist/cjs/mds-price-table-features-row.cjs.entry.js +2 -2
  424. package/dist/cjs/mds-price-table-features.cjs.entry.js +2 -2
  425. package/dist/cjs/mds-price-table-header.cjs.entry.js +1 -1
  426. package/dist/cjs/mds-price-table-list-item.cjs.entry.js +2 -2
  427. package/dist/cjs/mds-price-table-list.cjs.entry.js +2 -2
  428. package/dist/cjs/mds-price-table.cjs.entry.js +1 -1
  429. package/dist/cjs/mds-progress_2.cjs.entry.js +3 -3
  430. package/dist/cjs/mds-push-notification-item.cjs.entry.js +2 -2
  431. package/dist/cjs/mds-push-notification.cjs.entry.js +2 -2
  432. package/dist/cjs/mds-quote.cjs.entry.js +1 -1
  433. package/dist/cjs/mds-radial-menu-item.cjs.entry.js +1 -1
  434. package/dist/cjs/mds-radial-menu.cjs.entry.js +1 -1
  435. package/dist/cjs/mds-separator.cjs.entry.js +1 -1
  436. package/dist/cjs/mds-status-bar.cjs.entry.js +2 -2
  437. package/dist/cjs/mds-stepper-bar-item.cjs.entry.js +2 -2
  438. package/dist/cjs/mds-stepper-bar.cjs.entry.js +1 -1
  439. package/dist/cjs/mds-tab-bar-item.cjs.entry.js +2 -2
  440. package/dist/cjs/mds-tab-bar.cjs.entry.js +2 -2
  441. package/dist/cjs/mds-tab_2.cjs.entry.js +3 -3
  442. package/dist/cjs/mds-table-body.cjs.entry.js +2 -2
  443. package/dist/cjs/mds-table-footer.cjs.entry.js +2 -2
  444. package/dist/cjs/mds-table-header-cell.cjs.entry.js +2 -2
  445. package/dist/cjs/mds-table-header.cjs.entry.js +2 -2
  446. package/dist/cjs/mds-table-row.cjs.entry.js +3 -3
  447. package/dist/cjs/mds-table.cjs.entry.js +2 -2
  448. package/dist/cjs/mds-text.cjs.entry.js +45 -5
  449. package/dist/cjs/mds-toast-region.cjs.entry.js +1 -1
  450. package/dist/cjs/mds-toast.cjs.entry.js +2 -2
  451. package/dist/cjs/mds-tooltip.cjs.entry.js +2 -2
  452. package/dist/cjs/mds-tree-item.cjs.entry.js +1 -1
  453. package/dist/cjs/mds-tree.cjs.entry.js +2 -2
  454. package/dist/cjs/mds-url-view.cjs.entry.js +2 -2
  455. package/dist/cjs/mds-usage.cjs.entry.js +2 -2
  456. package/dist/cjs/mds-video-wall.cjs.entry.js +1 -1
  457. package/dist/cjs/mds-zero.cjs.entry.js +2 -2
  458. package/dist/collection/components/mds-accordion/AGENTS.md +5 -5
  459. package/dist/collection/components/mds-accordion/documentation.json +4 -4
  460. package/dist/collection/components/mds-accordion/examples.md +148 -0
  461. package/dist/collection/components/mds-accordion/mistakes.md +122 -0
  462. package/dist/collection/components/mds-accordion-item/AGENTS.md +6 -6
  463. package/dist/collection/components/mds-accordion-item/documentation.json +5 -5
  464. package/dist/collection/components/mds-accordion-item/examples.md +154 -0
  465. package/dist/collection/components/mds-accordion-item/mds-accordion-item.js +6 -3
  466. package/dist/collection/components/mds-accordion-item/mistakes.md +137 -0
  467. package/dist/collection/components/mds-accordion-timer/AGENTS.md +4 -4
  468. package/dist/collection/components/mds-accordion-timer/documentation.json +3 -3
  469. package/dist/collection/components/mds-accordion-timer/examples.md +137 -0
  470. package/dist/collection/components/mds-accordion-timer/mistakes.md +135 -0
  471. package/dist/collection/components/mds-accordion-timer-item/AGENTS.md +6 -6
  472. package/dist/collection/components/mds-accordion-timer-item/documentation.json +5 -5
  473. package/dist/collection/components/mds-accordion-timer-item/examples.md +133 -0
  474. package/dist/collection/components/mds-accordion-timer-item/mds-accordion-timer-item.js +6 -3
  475. package/dist/collection/components/mds-accordion-timer-item/mistakes.md +142 -0
  476. package/dist/collection/components/mds-author/AGENTS.md +4 -4
  477. package/dist/collection/components/mds-author/documentation.json +3 -3
  478. package/dist/collection/components/mds-author/examples.md +101 -0
  479. package/dist/collection/components/mds-author/mistakes.md +106 -0
  480. package/dist/collection/components/mds-avatar/AGENTS.md +4 -4
  481. package/dist/collection/components/mds-avatar/documentation.json +3 -3
  482. package/dist/collection/components/mds-avatar/examples.md +118 -0
  483. package/dist/collection/components/mds-avatar/mistakes.md +96 -0
  484. package/dist/collection/components/mds-avatar-stack/AGENTS.md +4 -4
  485. package/dist/collection/components/mds-avatar-stack/documentation.json +3 -3
  486. package/dist/collection/components/mds-avatar-stack/examples.md +122 -0
  487. package/dist/collection/components/mds-avatar-stack/mistakes.md +121 -0
  488. package/dist/collection/components/mds-avatar-stack-item/AGENTS.md +4 -4
  489. package/dist/collection/components/mds-avatar-stack-item/documentation.json +3 -3
  490. package/dist/collection/components/mds-avatar-stack-item/examples.md +104 -0
  491. package/dist/collection/components/mds-avatar-stack-item/mistakes.md +113 -0
  492. package/dist/collection/components/mds-badge/AGENTS.md +4 -4
  493. package/dist/collection/components/mds-badge/documentation.json +3 -3
  494. package/dist/collection/components/mds-badge/examples.md +126 -0
  495. package/dist/collection/components/mds-badge/mistakes.md +103 -0
  496. package/dist/collection/components/mds-banner/AGENTS.md +7 -4
  497. package/dist/collection/components/mds-banner/documentation.json +4 -4
  498. package/dist/collection/components/mds-banner/examples.md +175 -0
  499. package/dist/collection/components/mds-banner/mds-banner.css +19 -0
  500. package/dist/collection/components/mds-banner/mistakes.md +140 -0
  501. package/dist/collection/components/mds-benchmark-bar/AGENTS.md +4 -4
  502. package/dist/collection/components/mds-benchmark-bar/documentation.json +3 -3
  503. package/dist/collection/components/mds-benchmark-bar/examples.md +102 -0
  504. package/dist/collection/components/mds-benchmark-bar/mistakes.md +77 -0
  505. package/dist/collection/components/mds-bibliography/AGENTS.md +4 -4
  506. package/dist/collection/components/mds-bibliography/documentation.json +3 -3
  507. package/dist/collection/components/mds-bibliography/examples.md +140 -0
  508. package/dist/collection/components/mds-bibliography/mistakes.md +128 -0
  509. package/dist/collection/components/mds-book/AGENTS.md +10 -9
  510. package/dist/collection/components/mds-book/documentation.json +13 -9
  511. package/dist/collection/components/mds-book/examples.md +139 -0
  512. package/dist/collection/components/mds-book/mds-book.css +49 -9
  513. package/dist/collection/components/mds-book/mds-book.js +26 -10
  514. package/dist/collection/components/mds-book/meta/dictionary.js +1 -1
  515. package/dist/collection/components/mds-book/mistakes.md +88 -0
  516. package/dist/collection/components/mds-breadcrumb/AGENTS.md +4 -4
  517. package/dist/collection/components/mds-breadcrumb/documentation.json +3 -3
  518. package/dist/collection/components/mds-breadcrumb/examples.md +100 -0
  519. package/dist/collection/components/mds-breadcrumb/mistakes.md +112 -0
  520. package/dist/collection/components/mds-breadcrumb-item/AGENTS.md +4 -4
  521. package/dist/collection/components/mds-breadcrumb-item/documentation.json +3 -3
  522. package/dist/collection/components/mds-breadcrumb-item/examples.md +83 -0
  523. package/dist/collection/components/mds-breadcrumb-item/mistakes.md +109 -0
  524. package/dist/collection/components/mds-button/AGENTS.md +4 -4
  525. package/dist/collection/components/mds-button/documentation.json +3 -3
  526. package/dist/collection/components/mds-button/examples.md +211 -0
  527. package/dist/collection/components/mds-button/mistakes.md +160 -0
  528. package/dist/collection/components/mds-button-dropdown/AGENTS.md +4 -4
  529. package/dist/collection/components/mds-button-dropdown/documentation.json +3 -3
  530. package/dist/collection/components/mds-button-dropdown/examples.md +171 -0
  531. package/dist/collection/components/mds-button-dropdown/mistakes.md +158 -0
  532. package/dist/collection/components/mds-button-group/AGENTS.md +4 -4
  533. package/dist/collection/components/mds-button-group/documentation.json +3 -3
  534. package/dist/collection/components/mds-button-group/examples.md +89 -0
  535. package/dist/collection/components/mds-button-group/mistakes.md +105 -0
  536. package/dist/collection/components/mds-calendar/AGENTS.md +4 -4
  537. package/dist/collection/components/mds-calendar/documentation.json +3 -3
  538. package/dist/collection/components/mds-calendar/examples.md +127 -0
  539. package/dist/collection/components/mds-calendar/mistakes.md +113 -0
  540. package/dist/collection/components/mds-calendar-cell/AGENTS.md +4 -4
  541. package/dist/collection/components/mds-calendar-cell/documentation.json +3 -3
  542. package/dist/collection/components/mds-calendar-cell/examples.md +83 -0
  543. package/dist/collection/components/mds-calendar-cell/mistakes.md +58 -0
  544. package/dist/collection/components/mds-card/AGENTS.md +10 -7
  545. package/dist/collection/components/mds-card/documentation.json +6 -6
  546. package/dist/collection/components/mds-card/examples.md +160 -0
  547. package/dist/collection/components/mds-card/mds-card.css +50 -9
  548. package/dist/collection/components/mds-card/mistakes.md +157 -0
  549. package/dist/collection/components/mds-card-content/AGENTS.md +4 -4
  550. package/dist/collection/components/mds-card-content/documentation.json +3 -3
  551. package/dist/collection/components/mds-card-content/examples.md +90 -0
  552. package/dist/collection/components/mds-card-content/mds-card-content.css +5 -2
  553. package/dist/collection/components/mds-card-content/mistakes.md +109 -0
  554. package/dist/collection/components/mds-card-footer/AGENTS.md +5 -4
  555. package/dist/collection/components/mds-card-footer/documentation.json +4 -4
  556. package/dist/collection/components/mds-card-footer/examples.md +95 -0
  557. package/dist/collection/components/mds-card-footer/mds-card-footer.css +28 -5
  558. package/dist/collection/components/mds-card-footer/mds-card-footer.js +1 -1
  559. package/dist/collection/components/mds-card-footer/mistakes.md +112 -0
  560. package/dist/collection/components/mds-card-header/AGENTS.md +4 -4
  561. package/dist/collection/components/mds-card-header/documentation.json +3 -3
  562. package/dist/collection/components/mds-card-header/examples.md +143 -0
  563. package/dist/collection/components/mds-card-header/mds-card-header.css +4 -2
  564. package/dist/collection/components/mds-card-header/mds-card-header.js +1 -1
  565. package/dist/collection/components/mds-card-header/mistakes.md +114 -0
  566. package/dist/collection/components/mds-card-media/AGENTS.md +4 -4
  567. package/dist/collection/components/mds-card-media/documentation.json +3 -3
  568. package/dist/collection/components/mds-card-media/examples.md +93 -0
  569. package/dist/collection/components/mds-card-media/mds-card-media.js +1 -1
  570. package/dist/collection/components/mds-card-media/mistakes.md +128 -0
  571. package/dist/collection/components/mds-chip/AGENTS.md +4 -4
  572. package/dist/collection/components/mds-chip/documentation.json +3 -3
  573. package/dist/collection/components/mds-chip/examples.md +164 -0
  574. package/dist/collection/components/mds-chip/mds-chip.js +1 -1
  575. package/dist/collection/components/mds-chip/mistakes.md +118 -0
  576. package/dist/collection/components/mds-details/AGENTS.md +4 -4
  577. package/dist/collection/components/mds-details/documentation.json +3 -3
  578. package/dist/collection/components/mds-details/examples.md +136 -0
  579. package/dist/collection/components/mds-details/mds-details.js +1 -1
  580. package/dist/collection/components/mds-details/mistakes.md +124 -0
  581. package/dist/collection/components/mds-dropdown/AGENTS.md +4 -4
  582. package/dist/collection/components/mds-dropdown/documentation.json +3 -3
  583. package/dist/collection/components/mds-dropdown/examples.md +201 -0
  584. package/dist/collection/components/mds-dropdown/mds-dropdown.css +3 -0
  585. package/dist/collection/components/mds-dropdown/mds-dropdown.js +2 -2
  586. package/dist/collection/components/mds-dropdown/mistakes.md +137 -0
  587. package/dist/collection/components/mds-emoji/AGENTS.md +4 -4
  588. package/dist/collection/components/mds-emoji/documentation.json +3 -3
  589. package/dist/collection/components/mds-emoji/examples.md +203 -0
  590. package/dist/collection/components/mds-emoji/mds-emoji.js +1 -1
  591. package/dist/collection/components/mds-emoji/mistakes.md +116 -0
  592. package/dist/collection/components/mds-entity/AGENTS.md +4 -4
  593. package/dist/collection/components/mds-entity/documentation.json +3 -3
  594. package/dist/collection/components/mds-entity/examples.md +132 -0
  595. package/dist/collection/components/mds-entity/mds-entity.js +1 -1
  596. package/dist/collection/components/mds-entity/mistakes.md +119 -0
  597. package/dist/collection/components/mds-file/AGENTS.md +4 -4
  598. package/dist/collection/components/mds-file/documentation.json +3 -3
  599. package/dist/collection/components/mds-file/examples.md +107 -0
  600. package/dist/collection/components/mds-file/mds-file.js +1 -1
  601. package/dist/collection/components/mds-file/mistakes.md +91 -0
  602. package/dist/collection/components/mds-file-preview/AGENTS.md +4 -4
  603. package/dist/collection/components/mds-file-preview/documentation.json +3 -3
  604. package/dist/collection/components/mds-file-preview/examples.md +163 -0
  605. package/dist/collection/components/mds-file-preview/mds-file-preview.js +2 -2
  606. package/dist/collection/components/mds-file-preview/mistakes.md +129 -0
  607. package/dist/collection/components/mds-filter/AGENTS.md +4 -4
  608. package/dist/collection/components/mds-filter/documentation.json +3 -3
  609. package/dist/collection/components/mds-filter/examples.md +156 -0
  610. package/dist/collection/components/mds-filter/mds-filter.js +1 -1
  611. package/dist/collection/components/mds-filter/mistakes.md +140 -0
  612. package/dist/collection/components/mds-filter-item/AGENTS.md +4 -4
  613. package/dist/collection/components/mds-filter-item/documentation.json +3 -3
  614. package/dist/collection/components/mds-filter-item/examples.md +123 -0
  615. package/dist/collection/components/mds-filter-item/mds-filter-item.js +1 -1
  616. package/dist/collection/components/mds-filter-item/mistakes.md +127 -0
  617. package/dist/collection/components/mds-header/AGENTS.md +8 -5
  618. package/dist/collection/components/mds-header/documentation.json +4 -4
  619. package/dist/collection/components/mds-header/examples.md +180 -0
  620. package/dist/collection/components/mds-header/mds-header.css +27 -4
  621. package/dist/collection/components/mds-header/mds-header.js +1 -1
  622. package/dist/collection/components/mds-header/mistakes.md +162 -0
  623. package/dist/collection/components/mds-header-bar/AGENTS.md +5 -4
  624. package/dist/collection/components/mds-header-bar/documentation.json +4 -4
  625. package/dist/collection/components/mds-header-bar/examples.md +153 -0
  626. package/dist/collection/components/mds-header-bar/mds-header-bar.css +9 -4
  627. package/dist/collection/components/mds-header-bar/mds-header-bar.js +1 -1
  628. package/dist/collection/components/mds-header-bar/mistakes.md +117 -0
  629. package/dist/collection/components/mds-help/AGENTS.md +4 -4
  630. package/dist/collection/components/mds-help/documentation.json +3 -3
  631. package/dist/collection/components/mds-help/examples.md +106 -0
  632. package/dist/collection/components/mds-help/mds-help.js +1 -1
  633. package/dist/collection/components/mds-help/mistakes.md +73 -0
  634. package/dist/collection/components/mds-horizontal-scroll/AGENTS.md +4 -4
  635. package/dist/collection/components/mds-horizontal-scroll/documentation.json +3 -3
  636. package/dist/collection/components/mds-horizontal-scroll/examples.md +143 -0
  637. package/dist/collection/components/mds-horizontal-scroll/mds-horizontal-scroll.js +1 -1
  638. package/dist/collection/components/mds-horizontal-scroll/mistakes.md +120 -0
  639. package/dist/collection/components/mds-hr/AGENTS.md +4 -4
  640. package/dist/collection/components/mds-hr/documentation.json +3 -3
  641. package/dist/collection/components/mds-hr/examples.md +88 -0
  642. package/dist/collection/components/mds-hr/mds-hr.js +1 -1
  643. package/dist/collection/components/mds-hr/mistakes.md +84 -0
  644. package/dist/collection/components/mds-icon/AGENTS.md +4 -4
  645. package/dist/collection/components/mds-icon/documentation.json +3 -3
  646. package/dist/collection/components/mds-icon/examples.md +135 -0
  647. package/dist/collection/components/mds-icon/mds-icon.js +1 -1
  648. package/dist/collection/components/mds-icon/mistakes.md +118 -0
  649. package/dist/collection/components/mds-img/AGENTS.md +4 -4
  650. package/dist/collection/components/mds-img/documentation.json +3 -3
  651. package/dist/collection/components/mds-img/examples.md +125 -0
  652. package/dist/collection/components/mds-img/mistakes.md +106 -0
  653. package/dist/collection/components/mds-input/AGENTS.md +5 -4
  654. package/dist/collection/components/mds-input/documentation.json +4 -4
  655. package/dist/collection/components/mds-input/examples.md +265 -0
  656. package/dist/collection/components/mds-input/mds-input.css +4 -1
  657. package/dist/collection/components/mds-input/mds-input.js +2 -2
  658. package/dist/collection/components/mds-input/mistakes.md +128 -0
  659. package/dist/collection/components/mds-input-date/AGENTS.md +4 -4
  660. package/dist/collection/components/mds-input-date/documentation.json +3 -3
  661. package/dist/collection/components/mds-input-date/examples.md +157 -0
  662. package/dist/collection/components/mds-input-date/mds-input-date.css +34 -4
  663. package/dist/collection/components/mds-input-date/mds-input-date.js +2 -2
  664. package/dist/collection/components/mds-input-date/mistakes.md +107 -0
  665. package/dist/collection/components/mds-input-date-range/AGENTS.md +4 -4
  666. package/dist/collection/components/mds-input-date-range/documentation.json +3 -3
  667. package/dist/collection/components/mds-input-date-range/examples.md +121 -0
  668. package/dist/collection/components/mds-input-date-range/mds-input-date-range.css +7 -6
  669. package/dist/collection/components/mds-input-date-range/mistakes.md +168 -0
  670. package/dist/collection/components/mds-input-date-range-preselection/AGENTS.md +4 -4
  671. package/dist/collection/components/mds-input-date-range-preselection/documentation.json +3 -3
  672. package/dist/collection/components/mds-input-date-range-preselection/examples.md +91 -0
  673. package/dist/collection/components/mds-input-date-range-preselection/mds-input-date-range-preselection.js +1 -1
  674. package/dist/collection/components/mds-input-date-range-preselection/mistakes.md +152 -0
  675. package/dist/collection/components/mds-input-field/AGENTS.md +6 -4
  676. package/dist/collection/components/mds-input-field/documentation.json +36 -4
  677. package/dist/collection/components/mds-input-field/examples.md +116 -0
  678. package/dist/collection/components/mds-input-field/mds-input-field.css +3 -1
  679. package/dist/collection/components/mds-input-field/mds-input-field.js +27 -1
  680. package/dist/collection/components/mds-input-field/mistakes.md +142 -0
  681. package/dist/collection/components/mds-input-otp/AGENTS.md +4 -4
  682. package/dist/collection/components/mds-input-otp/documentation.json +3 -3
  683. package/dist/collection/components/mds-input-otp/examples.md +107 -0
  684. package/dist/collection/components/mds-input-otp/mds-input-otp.js +1 -1
  685. package/dist/collection/components/mds-input-otp/mistakes.md +105 -0
  686. package/dist/collection/components/mds-input-range/AGENTS.md +4 -4
  687. package/dist/collection/components/mds-input-range/documentation.json +3 -3
  688. package/dist/collection/components/mds-input-range/examples.md +100 -0
  689. package/dist/collection/components/mds-input-range/mds-input-range.js +1 -1
  690. package/dist/collection/components/mds-input-range/mistakes.md +123 -0
  691. package/dist/collection/components/mds-input-select/AGENTS.md +4 -4
  692. package/dist/collection/components/mds-input-select/documentation.json +3 -3
  693. package/dist/collection/components/mds-input-select/examples.md +166 -0
  694. package/dist/collection/components/mds-input-select/mds-input-select.css +4 -1
  695. package/dist/collection/components/mds-input-select/mds-input-select.js +2 -2
  696. package/dist/collection/components/mds-input-select/mistakes.md +126 -0
  697. package/dist/collection/components/mds-input-switch/AGENTS.md +4 -4
  698. package/dist/collection/components/mds-input-switch/documentation.json +3 -3
  699. package/dist/collection/components/mds-input-switch/examples.md +124 -0
  700. package/dist/collection/components/mds-input-switch/mds-input-switch.js +1 -1
  701. package/dist/collection/components/mds-input-switch/mistakes.md +116 -0
  702. package/dist/collection/components/mds-input-tip/AGENTS.md +4 -4
  703. package/dist/collection/components/mds-input-tip/documentation.json +3 -3
  704. package/dist/collection/components/mds-input-tip/examples.md +122 -0
  705. package/dist/collection/components/mds-input-tip/mds-input-tip.js +1 -1
  706. package/dist/collection/components/mds-input-tip/mistakes.md +112 -0
  707. package/dist/collection/components/mds-input-tip-item/AGENTS.md +4 -4
  708. package/dist/collection/components/mds-input-tip-item/documentation.json +3 -3
  709. package/dist/collection/components/mds-input-tip-item/examples.md +106 -0
  710. package/dist/collection/components/mds-input-tip-item/mds-input-tip-item.js +2 -2
  711. package/dist/collection/components/mds-input-tip-item/mistakes.md +98 -0
  712. package/dist/collection/components/mds-input-upload/AGENTS.md +4 -4
  713. package/dist/collection/components/mds-input-upload/documentation.json +3 -3
  714. package/dist/collection/components/mds-input-upload/examples.md +161 -0
  715. package/dist/collection/components/mds-input-upload/mds-input-upload.css +4 -1
  716. package/dist/collection/components/mds-input-upload/mds-input-upload.js +5 -5
  717. package/dist/collection/components/mds-input-upload/mistakes.md +143 -0
  718. package/dist/collection/components/mds-keyboard/AGENTS.md +4 -4
  719. package/dist/collection/components/mds-keyboard/documentation.json +3 -3
  720. package/dist/collection/components/mds-keyboard/examples.md +128 -0
  721. package/dist/collection/components/mds-keyboard/mds-keyboard.js +1 -1
  722. package/dist/collection/components/mds-keyboard/mistakes.md +111 -0
  723. package/dist/collection/components/mds-keyboard-key/AGENTS.md +4 -4
  724. package/dist/collection/components/mds-keyboard-key/documentation.json +3 -3
  725. package/dist/collection/components/mds-keyboard-key/examples.md +87 -0
  726. package/dist/collection/components/mds-keyboard-key/mds-keyboard-key.js +1 -1
  727. package/dist/collection/components/mds-keyboard-key/mistakes.md +116 -0
  728. package/dist/collection/components/mds-kpi/AGENTS.md +4 -4
  729. package/dist/collection/components/mds-kpi/documentation.json +3 -3
  730. package/dist/collection/components/mds-kpi/examples.md +112 -0
  731. package/dist/collection/components/mds-kpi/mds-kpi.js +1 -1
  732. package/dist/collection/components/mds-kpi/mistakes.md +93 -0
  733. package/dist/collection/components/mds-kpi-item/AGENTS.md +4 -4
  734. package/dist/collection/components/mds-kpi-item/documentation.json +3 -3
  735. package/dist/collection/components/mds-kpi-item/examples.md +117 -0
  736. package/dist/collection/components/mds-kpi-item/mds-kpi-item.js +1 -1
  737. package/dist/collection/components/mds-kpi-item/mistakes.md +117 -0
  738. package/dist/collection/components/mds-label/AGENTS.md +4 -4
  739. package/dist/collection/components/mds-label/documentation.json +3 -3
  740. package/dist/collection/components/mds-label/examples.md +109 -0
  741. package/dist/collection/components/mds-label/mistakes.md +92 -0
  742. package/dist/collection/components/mds-link/AGENTS.md +4 -4
  743. package/dist/collection/components/mds-link/documentation.json +3 -3
  744. package/dist/collection/components/mds-link/examples.md +100 -0
  745. package/dist/collection/components/mds-link/mds-link.js +3 -3
  746. package/dist/collection/components/mds-link/mistakes.md +96 -0
  747. package/dist/collection/components/mds-list/AGENTS.md +4 -4
  748. package/dist/collection/components/mds-list/documentation.json +3 -3
  749. package/dist/collection/components/mds-list/examples.md +104 -0
  750. package/dist/collection/components/mds-list/mds-list.js +1 -1
  751. package/dist/collection/components/mds-list/mistakes.md +117 -0
  752. package/dist/collection/components/mds-list-item/AGENTS.md +4 -4
  753. package/dist/collection/components/mds-list-item/documentation.json +3 -3
  754. package/dist/collection/components/mds-list-item/examples.md +112 -0
  755. package/dist/collection/components/mds-list-item/mds-list-item.js +1 -1
  756. package/dist/collection/components/mds-list-item/mistakes.md +118 -0
  757. package/dist/collection/components/mds-mention/AGENTS.md +4 -4
  758. package/dist/collection/components/mds-mention/documentation.json +3 -3
  759. package/dist/collection/components/mds-mention/examples.md +89 -0
  760. package/dist/collection/components/mds-mention/mds-mention.js +1 -1
  761. package/dist/collection/components/mds-mention/mistakes.md +86 -0
  762. package/dist/collection/components/mds-modal/AGENTS.md +5 -4
  763. package/dist/collection/components/mds-modal/documentation.json +4 -4
  764. package/dist/collection/components/mds-modal/examples.md +230 -0
  765. package/dist/collection/components/mds-modal/mds-modal.css +10 -0
  766. package/dist/collection/components/mds-modal/mds-modal.js +3 -3
  767. package/dist/collection/components/mds-modal/mistakes.md +114 -0
  768. package/dist/collection/components/mds-note/AGENTS.md +4 -4
  769. package/dist/collection/components/mds-note/documentation.json +3 -3
  770. package/dist/collection/components/mds-note/examples.md +107 -0
  771. package/dist/collection/components/mds-note/mds-note.js +1 -1
  772. package/dist/collection/components/mds-note/mistakes.md +99 -0
  773. package/dist/collection/components/mds-notification/AGENTS.md +10 -5
  774. package/dist/collection/components/mds-notification/documentation.json +94 -4
  775. package/dist/collection/components/mds-notification/examples.md +115 -0
  776. package/dist/collection/components/mds-notification/mds-notification.css +67 -1
  777. package/dist/collection/components/mds-notification/mds-notification.js +94 -3
  778. package/dist/collection/components/mds-notification/mistakes.md +98 -0
  779. package/dist/collection/components/mds-paginator/AGENTS.md +4 -4
  780. package/dist/collection/components/mds-paginator/documentation.json +3 -3
  781. package/dist/collection/components/mds-paginator/examples.md +98 -0
  782. package/dist/collection/components/mds-paginator/mds-paginator.js +1 -1
  783. package/dist/collection/components/mds-paginator/mistakes.md +96 -0
  784. package/dist/collection/components/mds-paginator-item/AGENTS.md +4 -4
  785. package/dist/collection/components/mds-paginator-item/documentation.json +3 -3
  786. package/dist/collection/components/mds-paginator-item/examples.md +76 -0
  787. package/dist/collection/components/mds-paginator-item/mds-paginator-item.js +1 -1
  788. package/dist/collection/components/mds-paginator-item/mistakes.md +96 -0
  789. package/dist/collection/components/mds-policy-ai/AGENTS.md +4 -4
  790. package/dist/collection/components/mds-policy-ai/documentation.json +3 -3
  791. package/dist/collection/components/mds-policy-ai/examples.md +107 -0
  792. package/dist/collection/components/mds-policy-ai/mds-policy-ai.js +1 -1
  793. package/dist/collection/components/mds-policy-ai/mistakes.md +97 -0
  794. package/dist/collection/components/mds-pref/AGENTS.md +4 -4
  795. package/dist/collection/components/mds-pref/documentation.json +3 -3
  796. package/dist/collection/components/mds-pref/examples.md +93 -0
  797. package/dist/collection/components/mds-pref/mds-pref.js +1 -1
  798. package/dist/collection/components/mds-pref/mistakes.md +85 -0
  799. package/dist/collection/components/mds-pref-animation/AGENTS.md +4 -4
  800. package/dist/collection/components/mds-pref-animation/documentation.json +3 -3
  801. package/dist/collection/components/mds-pref-animation/examples.md +86 -0
  802. package/dist/collection/components/mds-pref-animation/mds-pref-animation.js +1 -1
  803. package/dist/collection/components/mds-pref-animation/mistakes.md +67 -0
  804. package/dist/collection/components/mds-pref-consumption/AGENTS.md +4 -4
  805. package/dist/collection/components/mds-pref-consumption/documentation.json +3 -3
  806. package/dist/collection/components/mds-pref-consumption/examples.md +69 -0
  807. package/dist/collection/components/mds-pref-consumption/mds-pref-consumption.js +1 -1
  808. package/dist/collection/components/mds-pref-consumption/mistakes.md +84 -0
  809. package/dist/collection/components/mds-pref-contrast/AGENTS.md +4 -4
  810. package/dist/collection/components/mds-pref-contrast/documentation.json +3 -3
  811. package/dist/collection/components/mds-pref-contrast/examples.md +82 -0
  812. package/dist/collection/components/mds-pref-contrast/mds-pref-contrast.js +1 -1
  813. package/dist/collection/components/mds-pref-contrast/mistakes.md +71 -0
  814. package/dist/collection/components/mds-pref-language/AGENTS.md +5 -5
  815. package/dist/collection/components/mds-pref-language/documentation.json +4 -4
  816. package/dist/collection/components/mds-pref-language/examples.md +104 -0
  817. package/dist/collection/components/mds-pref-language/mds-pref-language.js +1 -1
  818. package/dist/collection/components/mds-pref-language/mistakes.md +130 -0
  819. package/dist/collection/components/mds-pref-language-item/AGENTS.md +4 -4
  820. package/dist/collection/components/mds-pref-language-item/documentation.json +3 -3
  821. package/dist/collection/components/mds-pref-language-item/examples.md +85 -0
  822. package/dist/collection/components/mds-pref-language-item/mds-pref-language-item.js +1 -1
  823. package/dist/collection/components/mds-pref-language-item/mistakes.md +99 -0
  824. package/dist/collection/components/mds-pref-mode/AGENTS.md +5 -5
  825. package/dist/collection/components/mds-pref-mode/documentation.json +4 -4
  826. package/dist/collection/components/mds-pref-mode/examples.md +92 -0
  827. package/dist/collection/components/mds-pref-mode/mds-pref-mode.js +1 -1
  828. package/dist/collection/components/mds-pref-mode/mistakes.md +103 -0
  829. package/dist/collection/components/mds-pref-theme/AGENTS.md +6 -6
  830. package/dist/collection/components/mds-pref-theme/documentation.json +4 -4
  831. package/dist/collection/components/mds-pref-theme/examples.md +93 -0
  832. package/dist/collection/components/mds-pref-theme/mds-pref-theme.js +12 -3
  833. package/dist/collection/components/mds-pref-theme/mistakes.md +104 -0
  834. package/dist/collection/components/mds-pref-theme-item/AGENTS.md +8 -8
  835. package/dist/collection/components/mds-pref-theme-item/documentation.json +8 -8
  836. package/dist/collection/components/mds-pref-theme-item/examples.md +88 -0
  837. package/dist/collection/components/mds-pref-theme-item/mds-pref-theme-item.css +13 -7
  838. package/dist/collection/components/mds-pref-theme-item/mds-pref-theme-item.js +19 -5
  839. package/dist/collection/components/mds-pref-theme-item/mistakes.md +95 -0
  840. package/dist/collection/components/mds-price-table/AGENTS.md +4 -4
  841. package/dist/collection/components/mds-price-table/documentation.json +3 -3
  842. package/dist/collection/components/mds-price-table/examples.md +182 -0
  843. package/dist/collection/components/mds-price-table/mds-price-table.js +1 -1
  844. package/dist/collection/components/mds-price-table/mistakes.md +131 -0
  845. package/dist/collection/components/mds-price-table-features/AGENTS.md +4 -4
  846. package/dist/collection/components/mds-price-table-features/documentation.json +3 -3
  847. package/dist/collection/components/mds-price-table-features/examples.md +156 -0
  848. package/dist/collection/components/mds-price-table-features/mds-price-table-features.js +1 -1
  849. package/dist/collection/components/mds-price-table-features/mistakes.md +151 -0
  850. package/dist/collection/components/mds-price-table-features-cell/AGENTS.md +4 -4
  851. package/dist/collection/components/mds-price-table-features-cell/documentation.json +3 -3
  852. package/dist/collection/components/mds-price-table-features-cell/examples.md +123 -0
  853. package/dist/collection/components/mds-price-table-features-cell/mds-price-table-features-cell.js +1 -1
  854. package/dist/collection/components/mds-price-table-features-cell/mistakes.md +105 -0
  855. package/dist/collection/components/mds-price-table-features-row/AGENTS.md +4 -4
  856. package/dist/collection/components/mds-price-table-features-row/documentation.json +3 -3
  857. package/dist/collection/components/mds-price-table-features-row/examples.md +123 -0
  858. package/dist/collection/components/mds-price-table-features-row/mds-price-table-features-row.js +1 -1
  859. package/dist/collection/components/mds-price-table-features-row/mistakes.md +135 -0
  860. package/dist/collection/components/mds-price-table-header/AGENTS.md +4 -4
  861. package/dist/collection/components/mds-price-table-header/documentation.json +3 -3
  862. package/dist/collection/components/mds-price-table-header/examples.md +176 -0
  863. package/dist/collection/components/mds-price-table-header/mds-price-table-header.js +1 -1
  864. package/dist/collection/components/mds-price-table-header/mistakes.md +133 -0
  865. package/dist/collection/components/mds-price-table-list/AGENTS.md +4 -4
  866. package/dist/collection/components/mds-price-table-list/documentation.json +3 -3
  867. package/dist/collection/components/mds-price-table-list/examples.md +139 -0
  868. package/dist/collection/components/mds-price-table-list/mds-price-table-list.js +1 -1
  869. package/dist/collection/components/mds-price-table-list/mistakes.md +130 -0
  870. package/dist/collection/components/mds-price-table-list-item/AGENTS.md +4 -4
  871. package/dist/collection/components/mds-price-table-list-item/documentation.json +3 -3
  872. package/dist/collection/components/mds-price-table-list-item/examples.md +108 -0
  873. package/dist/collection/components/mds-price-table-list-item/mds-price-table-list-item.js +1 -1
  874. package/dist/collection/components/mds-price-table-list-item/mistakes.md +86 -0
  875. package/dist/collection/components/mds-progress/AGENTS.md +4 -4
  876. package/dist/collection/components/mds-progress/documentation.json +3 -3
  877. package/dist/collection/components/mds-progress/examples.md +140 -0
  878. package/dist/collection/components/mds-progress/mds-progress.js +1 -1
  879. package/dist/collection/components/mds-progress/mistakes.md +94 -0
  880. package/dist/collection/components/mds-push-notification/AGENTS.md +4 -4
  881. package/dist/collection/components/mds-push-notification/documentation.json +3 -3
  882. package/dist/collection/components/mds-push-notification/examples.md +200 -0
  883. package/dist/collection/components/mds-push-notification/mds-push-notification.js +1 -1
  884. package/dist/collection/components/mds-push-notification/mistakes.md +154 -0
  885. package/dist/collection/components/mds-push-notification-item/AGENTS.md +4 -4
  886. package/dist/collection/components/mds-push-notification-item/documentation.json +3 -3
  887. package/dist/collection/components/mds-push-notification-item/examples.md +198 -0
  888. package/dist/collection/components/mds-push-notification-item/mds-push-notification-item.js +2 -2
  889. package/dist/collection/components/mds-push-notification-item/mistakes.md +129 -0
  890. package/dist/collection/components/mds-quote/AGENTS.md +4 -4
  891. package/dist/collection/components/mds-quote/documentation.json +3 -3
  892. package/dist/collection/components/mds-quote/examples.md +108 -0
  893. package/dist/collection/components/mds-quote/mds-quote.js +1 -1
  894. package/dist/collection/components/mds-quote/mistakes.md +122 -0
  895. package/dist/collection/components/mds-radial-menu/AGENTS.md +4 -4
  896. package/dist/collection/components/mds-radial-menu/documentation.json +3 -3
  897. package/dist/collection/components/mds-radial-menu/examples.md +159 -0
  898. package/dist/collection/components/mds-radial-menu/mds-radial-menu.js +1 -1
  899. package/dist/collection/components/mds-radial-menu/mistakes.md +104 -0
  900. package/dist/collection/components/mds-radial-menu-item/AGENTS.md +4 -4
  901. package/dist/collection/components/mds-radial-menu-item/documentation.json +3 -3
  902. package/dist/collection/components/mds-radial-menu-item/examples.md +96 -0
  903. package/dist/collection/components/mds-radial-menu-item/mds-radial-menu-item.js +1 -1
  904. package/dist/collection/components/mds-radial-menu-item/mistakes.md +108 -0
  905. package/dist/collection/components/mds-radial-progress/AGENTS.md +4 -4
  906. package/dist/collection/components/mds-radial-progress/documentation.json +3 -3
  907. package/dist/collection/components/mds-radial-progress/examples.md +144 -0
  908. package/dist/collection/components/mds-radial-progress/mds-radial-progress.js +1 -1
  909. package/dist/collection/components/mds-radial-progress/mistakes.md +106 -0
  910. package/dist/collection/components/mds-separator/AGENTS.md +4 -4
  911. package/dist/collection/components/mds-separator/documentation.json +3 -3
  912. package/dist/collection/components/mds-separator/examples.md +82 -0
  913. package/dist/collection/components/mds-separator/mds-separator.js +1 -1
  914. package/dist/collection/components/mds-separator/mistakes.md +98 -0
  915. package/dist/collection/components/mds-spinner/AGENTS.md +4 -4
  916. package/dist/collection/components/mds-spinner/documentation.json +3 -3
  917. package/dist/collection/components/mds-spinner/examples.md +105 -0
  918. package/dist/collection/components/mds-spinner/mds-spinner.js +1 -1
  919. package/dist/collection/components/mds-spinner/mistakes.md +93 -0
  920. package/dist/collection/components/mds-status-bar/AGENTS.md +6 -4
  921. package/dist/collection/components/mds-status-bar/documentation.json +4 -4
  922. package/dist/collection/components/mds-status-bar/examples.md +128 -0
  923. package/dist/collection/components/mds-status-bar/mds-status-bar.css +29 -3
  924. package/dist/collection/components/mds-status-bar/mds-status-bar.js +1 -1
  925. package/dist/collection/components/mds-status-bar/mistakes.md +127 -0
  926. package/dist/collection/components/mds-stepper-bar/AGENTS.md +4 -4
  927. package/dist/collection/components/mds-stepper-bar/documentation.json +3 -3
  928. package/dist/collection/components/mds-stepper-bar/examples.md +178 -0
  929. package/dist/collection/components/mds-stepper-bar/mds-stepper-bar.js +1 -1
  930. package/dist/collection/components/mds-stepper-bar/mistakes.md +123 -0
  931. package/dist/collection/components/mds-stepper-bar-item/AGENTS.md +4 -4
  932. package/dist/collection/components/mds-stepper-bar-item/documentation.json +3 -3
  933. package/dist/collection/components/mds-stepper-bar-item/examples.md +200 -0
  934. package/dist/collection/components/mds-stepper-bar-item/mds-stepper-bar-item.js +1 -1
  935. package/dist/collection/components/mds-stepper-bar-item/mistakes.md +115 -0
  936. package/dist/collection/components/mds-tab/AGENTS.md +4 -4
  937. package/dist/collection/components/mds-tab/documentation.json +3 -3
  938. package/dist/collection/components/mds-tab/examples.md +232 -0
  939. package/dist/collection/components/mds-tab/mds-tab.js +2 -2
  940. package/dist/collection/components/mds-tab/mistakes.md +189 -0
  941. package/dist/collection/components/mds-tab-bar/AGENTS.md +4 -4
  942. package/dist/collection/components/mds-tab-bar/documentation.json +3 -3
  943. package/dist/collection/components/mds-tab-bar/examples.md +87 -0
  944. package/dist/collection/components/mds-tab-bar/mds-tab-bar.js +1 -1
  945. package/dist/collection/components/mds-tab-bar/mistakes.md +105 -0
  946. package/dist/collection/components/mds-tab-bar-item/AGENTS.md +4 -4
  947. package/dist/collection/components/mds-tab-bar-item/documentation.json +3 -3
  948. package/dist/collection/components/mds-tab-bar-item/examples.md +108 -0
  949. package/dist/collection/components/mds-tab-bar-item/mds-tab-bar-item.js +1 -1
  950. package/dist/collection/components/mds-tab-bar-item/mistakes.md +116 -0
  951. package/dist/collection/components/mds-tab-item/AGENTS.md +4 -4
  952. package/dist/collection/components/mds-tab-item/documentation.json +3 -3
  953. package/dist/collection/components/mds-tab-item/examples.md +174 -0
  954. package/dist/collection/components/mds-tab-item/mds-tab-item.js +1 -1
  955. package/dist/collection/components/mds-tab-item/mistakes.md +159 -0
  956. package/dist/collection/components/mds-table/AGENTS.md +4 -4
  957. package/dist/collection/components/mds-table/documentation.json +3 -3
  958. package/dist/collection/components/mds-table/examples.md +317 -0
  959. package/dist/collection/components/mds-table/mds-table.css +3 -0
  960. package/dist/collection/components/mds-table/mds-table.js +1 -1
  961. package/dist/collection/components/mds-table/mistakes.md +169 -0
  962. package/dist/collection/components/mds-table-body/AGENTS.md +4 -4
  963. package/dist/collection/components/mds-table-body/documentation.json +3 -3
  964. package/dist/collection/components/mds-table-body/examples.md +151 -0
  965. package/dist/collection/components/mds-table-body/mds-table-body.js +1 -1
  966. package/dist/collection/components/mds-table-body/mistakes.md +117 -0
  967. package/dist/collection/components/mds-table-cell/AGENTS.md +4 -4
  968. package/dist/collection/components/mds-table-cell/documentation.json +3 -3
  969. package/dist/collection/components/mds-table-cell/examples.md +168 -0
  970. package/dist/collection/components/mds-table-cell/mds-table-cell.js +1 -1
  971. package/dist/collection/components/mds-table-cell/mistakes.md +100 -0
  972. package/dist/collection/components/mds-table-footer/AGENTS.md +4 -4
  973. package/dist/collection/components/mds-table-footer/documentation.json +3 -3
  974. package/dist/collection/components/mds-table-footer/examples.md +115 -0
  975. package/dist/collection/components/mds-table-footer/mds-table-footer.js +1 -1
  976. package/dist/collection/components/mds-table-footer/mistakes.md +114 -0
  977. package/dist/collection/components/mds-table-header/AGENTS.md +4 -4
  978. package/dist/collection/components/mds-table-header/documentation.json +3 -3
  979. package/dist/collection/components/mds-table-header/examples.md +158 -0
  980. package/dist/collection/components/mds-table-header/mds-table-header.js +1 -1
  981. package/dist/collection/components/mds-table-header/mistakes.md +157 -0
  982. package/dist/collection/components/mds-table-header-cell/AGENTS.md +4 -4
  983. package/dist/collection/components/mds-table-header-cell/documentation.json +3 -3
  984. package/dist/collection/components/mds-table-header-cell/examples.md +166 -0
  985. package/dist/collection/components/mds-table-header-cell/mds-table-header-cell.js +1 -1
  986. package/dist/collection/components/mds-table-header-cell/mistakes.md +115 -0
  987. package/dist/collection/components/mds-table-row/AGENTS.md +4 -4
  988. package/dist/collection/components/mds-table-row/documentation.json +3 -3
  989. package/dist/collection/components/mds-table-row/examples.md +166 -0
  990. package/dist/collection/components/mds-table-row/mds-table-row.js +2 -2
  991. package/dist/collection/components/mds-table-row/mistakes.md +141 -0
  992. package/dist/collection/components/mds-text/AGENTS.md +9 -7
  993. package/dist/collection/components/mds-text/documentation.json +33 -13
  994. package/dist/collection/components/mds-text/examples.md +148 -0
  995. package/dist/collection/components/mds-text/mds-text.css +38 -1
  996. package/dist/collection/components/mds-text/mds-text.js +14 -12
  997. package/dist/collection/components/mds-text/meta/dictionary.js +3 -1
  998. package/dist/collection/components/mds-text/meta/variants.js +38 -0
  999. package/dist/collection/components/mds-text/mistakes.md +141 -0
  1000. package/dist/collection/components/mds-toast/AGENTS.md +4 -4
  1001. package/dist/collection/components/mds-toast/documentation.json +3 -3
  1002. package/dist/collection/components/mds-toast/examples.md +174 -0
  1003. package/dist/collection/components/mds-toast/mds-toast.js +1 -1
  1004. package/dist/collection/components/mds-toast/mistakes.md +149 -0
  1005. package/dist/collection/components/mds-toast-region/AGENTS.md +4 -4
  1006. package/dist/collection/components/mds-toast-region/documentation.json +3 -3
  1007. package/dist/collection/components/mds-toast-region/examples.md +90 -0
  1008. package/dist/collection/components/mds-toast-region/mds-toast-region.js +1 -1
  1009. package/dist/collection/components/mds-toast-region/mistakes.md +62 -0
  1010. package/dist/collection/components/mds-tooltip/AGENTS.md +4 -4
  1011. package/dist/collection/components/mds-tooltip/documentation.json +3 -3
  1012. package/dist/collection/components/mds-tooltip/examples.md +135 -0
  1013. package/dist/collection/components/mds-tooltip/mds-tooltip.js +1 -1
  1014. package/dist/collection/components/mds-tooltip/mistakes.md +122 -0
  1015. package/dist/collection/components/mds-tree/AGENTS.md +4 -4
  1016. package/dist/collection/components/mds-tree/documentation.json +3 -3
  1017. package/dist/collection/components/mds-tree/examples.md +196 -0
  1018. package/dist/collection/components/mds-tree/mds-tree.js +1 -1
  1019. package/dist/collection/components/mds-tree/mistakes.md +152 -0
  1020. package/dist/collection/components/mds-tree-item/AGENTS.md +4 -4
  1021. package/dist/collection/components/mds-tree-item/documentation.json +3 -3
  1022. package/dist/collection/components/mds-tree-item/examples.md +197 -0
  1023. package/dist/collection/components/mds-tree-item/mds-tree-item.js +1 -1
  1024. package/dist/collection/components/mds-tree-item/mistakes.md +148 -0
  1025. package/dist/collection/components/mds-url-view/AGENTS.md +4 -4
  1026. package/dist/collection/components/mds-url-view/documentation.json +3 -3
  1027. package/dist/collection/components/mds-url-view/examples.md +105 -0
  1028. package/dist/collection/components/mds-url-view/mds-url-view.js +1 -1
  1029. package/dist/collection/components/mds-url-view/mistakes.md +106 -0
  1030. package/dist/collection/components/mds-usage/AGENTS.md +4 -4
  1031. package/dist/collection/components/mds-usage/documentation.json +3 -3
  1032. package/dist/collection/components/mds-usage/examples.md +131 -0
  1033. package/dist/collection/components/mds-usage/mds-usage.js +1 -1
  1034. package/dist/collection/components/mds-usage/mistakes.md +105 -0
  1035. package/dist/collection/components/mds-video-wall/AGENTS.md +4 -4
  1036. package/dist/collection/components/mds-video-wall/documentation.json +3 -3
  1037. package/dist/collection/components/mds-video-wall/examples.md +99 -0
  1038. package/dist/collection/components/mds-video-wall/mds-video-wall.js +1 -1
  1039. package/dist/collection/components/mds-video-wall/mistakes.md +97 -0
  1040. package/dist/collection/components/mds-zero/AGENTS.md +4 -4
  1041. package/dist/collection/components/mds-zero/documentation.json +3 -3
  1042. package/dist/collection/components/mds-zero/examples.md +118 -0
  1043. package/dist/collection/components/mds-zero/mds-zero.js +1 -1
  1044. package/dist/collection/components/mds-zero/mistakes.md +106 -0
  1045. package/dist/components/index.js +1 -1
  1046. package/dist/components/mds-accordion-item.js +1 -1
  1047. package/dist/components/mds-accordion-timer-item.js +1 -1
  1048. package/dist/components/mds-avatar-stack-item.js +1 -1
  1049. package/dist/components/mds-avatar-stack.js +1 -1
  1050. package/dist/components/mds-avatar.js +1 -1
  1051. package/dist/components/mds-badge.js +1 -1
  1052. package/dist/components/mds-banner.js +1 -1
  1053. package/dist/components/mds-benchmark-bar.js +1 -1
  1054. package/dist/components/mds-bibliography.js +1 -1
  1055. package/dist/components/mds-book.js +1 -1
  1056. package/dist/components/mds-breadcrumb-item.js +1 -1
  1057. package/dist/components/mds-breadcrumb.js +1 -1
  1058. package/dist/components/mds-button-dropdown.js +1 -1
  1059. package/dist/components/mds-button.js +1 -1
  1060. package/dist/components/mds-calendar-cell.js +1 -1
  1061. package/dist/components/mds-calendar.js +1 -1
  1062. package/dist/components/mds-card-content.js +1 -1
  1063. package/dist/components/mds-card-footer.js +1 -1
  1064. package/dist/components/mds-card-header.js +1 -1
  1065. package/dist/components/mds-card-media.js +1 -1
  1066. package/dist/components/mds-card.js +1 -1
  1067. package/dist/components/mds-chip.js +1 -1
  1068. package/dist/components/mds-details.js +1 -1
  1069. package/dist/components/mds-dropdown.js +1 -1
  1070. package/dist/components/mds-emoji.js +4 -4
  1071. package/dist/components/mds-entity.js +1 -1
  1072. package/dist/components/mds-file-preview.js +1 -1
  1073. package/dist/components/mds-file.js +1 -1
  1074. package/dist/components/mds-filter-item.js +1 -1
  1075. package/dist/components/mds-filter.js +1 -1
  1076. package/dist/components/mds-header-bar.js +1 -1
  1077. package/dist/components/mds-header.js +1 -1
  1078. package/dist/components/mds-help.js +1 -1
  1079. package/dist/components/mds-horizontal-scroll.js +1 -1
  1080. package/dist/components/mds-hr.js +1 -1
  1081. package/dist/components/mds-icon.js +1 -1
  1082. package/dist/components/mds-img.js +1 -1
  1083. package/dist/components/mds-input-date-range-preselection.js +1 -1
  1084. package/dist/components/mds-input-date-range.js +1 -1
  1085. package/dist/components/mds-input-date.js +1 -1
  1086. package/dist/components/mds-input-field.js +1 -1
  1087. package/dist/components/mds-input-otp.js +1 -1
  1088. package/dist/components/mds-input-range.js +1 -1
  1089. package/dist/components/mds-input-select.js +1 -1
  1090. package/dist/components/mds-input-switch.js +1 -1
  1091. package/dist/components/mds-input-tip-item.js +1 -1
  1092. package/dist/components/mds-input-tip.js +1 -1
  1093. package/dist/components/mds-input-upload.js +1 -1
  1094. package/dist/components/mds-input.js +1 -1
  1095. package/dist/components/mds-keyboard-key.js +1 -1
  1096. package/dist/components/mds-keyboard.js +1 -1
  1097. package/dist/components/mds-kpi-item.js +1 -1
  1098. package/dist/components/mds-kpi.js +1 -1
  1099. package/dist/components/mds-label.js +1 -1
  1100. package/dist/components/mds-link.js +1 -1
  1101. package/dist/components/mds-list-item.js +1 -1
  1102. package/dist/components/mds-list.js +1 -1
  1103. package/dist/components/mds-mention.js +1 -1
  1104. package/dist/components/mds-modal.js +1 -1
  1105. package/dist/components/mds-note.js +1 -1
  1106. package/dist/components/mds-notification.js +1 -1
  1107. package/dist/components/mds-paginator-item.js +1 -1
  1108. package/dist/components/mds-paginator.js +1 -1
  1109. package/dist/components/mds-policy-ai.js +1 -1
  1110. package/dist/components/mds-pref-animation.js +1 -1
  1111. package/dist/components/mds-pref-consumption.js +1 -1
  1112. package/dist/components/mds-pref-contrast.js +1 -1
  1113. package/dist/components/mds-pref-language-item.js +1 -1
  1114. package/dist/components/mds-pref-language.js +1 -1
  1115. package/dist/components/mds-pref-mode.js +1 -1
  1116. package/dist/components/mds-pref-theme-item.js +1 -1
  1117. package/dist/components/mds-pref-theme.js +1 -1
  1118. package/dist/components/mds-pref.js +1 -1
  1119. package/dist/components/mds-price-table-features-cell.js +1 -1
  1120. package/dist/components/mds-price-table-features-row.js +1 -1
  1121. package/dist/components/mds-price-table-features.js +1 -1
  1122. package/dist/components/mds-price-table-header.js +1 -1
  1123. package/dist/components/mds-price-table-list-item.js +1 -1
  1124. package/dist/components/mds-price-table-list.js +1 -1
  1125. package/dist/components/mds-price-table.js +1 -1
  1126. package/dist/components/mds-progress.js +1 -1
  1127. package/dist/components/mds-push-notification-item.js +1 -1
  1128. package/dist/components/mds-push-notification.js +1 -1
  1129. package/dist/components/mds-quote.js +1 -1
  1130. package/dist/components/mds-radial-menu-item.js +1 -1
  1131. package/dist/components/mds-radial-menu.js +1 -1
  1132. package/dist/components/mds-radial-progress.js +1 -1
  1133. package/dist/components/mds-separator.js +1 -1
  1134. package/dist/components/mds-spinner.js +1 -1
  1135. package/dist/components/mds-status-bar.js +1 -1
  1136. package/dist/components/mds-stepper-bar-item.js +1 -1
  1137. package/dist/components/mds-stepper-bar.js +1 -1
  1138. package/dist/components/mds-tab-bar-item.js +1 -1
  1139. package/dist/components/mds-tab-bar.js +1 -1
  1140. package/dist/components/mds-tab-item.js +1 -1
  1141. package/dist/components/mds-tab.js +1 -1
  1142. package/dist/components/mds-table-body.js +1 -1
  1143. package/dist/components/mds-table-cell.js +1 -1
  1144. package/dist/components/mds-table-footer.js +1 -1
  1145. package/dist/components/mds-table-header-cell.js +1 -1
  1146. package/dist/components/mds-table-header.js +1 -1
  1147. package/dist/components/mds-table-row.js +1 -1
  1148. package/dist/components/mds-table.js +1 -1
  1149. package/dist/components/mds-text.js +1 -1
  1150. package/dist/components/mds-toast-region.js +1 -1
  1151. package/dist/components/mds-toast.js +1 -1
  1152. package/dist/components/mds-tooltip.js +1 -1
  1153. package/dist/components/mds-tree-item.js +1 -1
  1154. package/dist/components/mds-tree.js +1 -1
  1155. package/dist/components/mds-url-view.js +1 -1
  1156. package/dist/components/mds-usage.js +1 -1
  1157. package/dist/components/mds-video-wall.js +1 -1
  1158. package/dist/components/mds-zero.js +1 -1
  1159. package/dist/components/p-4LbHmDXv.js +1 -0
  1160. package/dist/components/p-B6AFku7a.js +1 -0
  1161. package/dist/components/p-BFDRt7-n.js +1 -0
  1162. package/dist/components/p-BaynxVRZ.js +1 -0
  1163. package/dist/components/p-BiW6luA5.js +1 -0
  1164. package/dist/components/p-Br6-kva-.js +1 -0
  1165. package/dist/components/p-BwT0RJip.js +1 -0
  1166. package/dist/components/p-C7rDjrH4.js +1 -0
  1167. package/dist/components/p-CKnbQQUb.js +1 -0
  1168. package/dist/components/p-COUgBzJ4.js +1 -0
  1169. package/dist/components/p-COkn4Vtq.js +1 -0
  1170. package/dist/components/p-CP5Qw9_T.js +1 -0
  1171. package/dist/components/p-C_Pc94vn.js +1 -0
  1172. package/dist/components/p-D8CloC8I.js +1 -0
  1173. package/dist/components/p-DGhzWuCS.js +1 -0
  1174. package/dist/components/p-DJd8f8dz.js +1 -0
  1175. package/dist/components/p-DOdUioZq.js +1 -0
  1176. package/dist/components/p-DW6ie49j.js +1 -0
  1177. package/dist/components/p-D_RIY063.js +1 -0
  1178. package/dist/components/p-DdzJfsw7.js +1 -0
  1179. package/dist/components/p-DhpcFZrc.js +1 -0
  1180. package/dist/components/p-DlglisEn.js +1 -0
  1181. package/dist/components/p-DqdlT4UG.js +1 -0
  1182. package/dist/components/p-DvDB_L_5.js +1 -0
  1183. package/dist/components/p-FsctOap9.js +1 -0
  1184. package/dist/components/p-G7Udw5H5.js +1 -0
  1185. package/dist/components/p-Ic8cYsgt.js +1 -0
  1186. package/dist/components/p-gLo3t_qO.js +8 -0
  1187. package/dist/components/p-ikNX7XDH.js +1 -0
  1188. package/dist/components/p-l0KS6hTQ.js +1 -0
  1189. package/dist/documentation.json +429 -278
  1190. package/dist/esm/loader.js +1 -1
  1191. package/dist/esm/magma-components.js +1 -1
  1192. package/dist/esm/mds-accordion-item.entry.js +6 -3
  1193. package/dist/esm/mds-accordion-timer-item.entry.js +5 -2
  1194. package/dist/esm/mds-avatar.entry.js +1 -1
  1195. package/dist/esm/mds-banner_3.entry.js +3 -3
  1196. package/dist/esm/mds-book.entry.js +25 -9
  1197. package/dist/esm/mds-button_3.entry.js +4 -4
  1198. package/dist/esm/mds-card-content.entry.js +1 -1
  1199. package/dist/esm/mds-card-footer.entry.js +2 -2
  1200. package/dist/esm/mds-card-header.entry.js +2 -2
  1201. package/dist/esm/mds-card-media.entry.js +1 -1
  1202. package/dist/esm/mds-card.entry.js +1 -1
  1203. package/dist/esm/mds-details.entry.js +1 -1
  1204. package/dist/esm/mds-dropdown.entry.js +3 -3
  1205. package/dist/esm/mds-emoji.entry.js +40 -11
  1206. package/dist/esm/mds-entity.entry.js +1 -1
  1207. package/dist/esm/mds-file-preview.entry.js +2 -2
  1208. package/dist/esm/mds-file.entry.js +1 -1
  1209. package/dist/esm/mds-filter-item.entry.js +1 -1
  1210. package/dist/esm/mds-filter.entry.js +1 -1
  1211. package/dist/esm/mds-header-bar.entry.js +2 -2
  1212. package/dist/esm/mds-header.entry.js +2 -2
  1213. package/dist/esm/mds-horizontal-scroll.entry.js +1 -1
  1214. package/dist/esm/mds-hr.entry.js +1 -1
  1215. package/dist/esm/mds-input-date-range-preselection.entry.js +1 -1
  1216. package/dist/esm/mds-input-date-range.entry.js +1 -1
  1217. package/dist/esm/mds-input-date.entry.js +3 -3
  1218. package/dist/esm/mds-input-field.entry.js +8 -2
  1219. package/dist/esm/mds-input-otp.entry.js +1 -1
  1220. package/dist/esm/mds-input-range.entry.js +1 -1
  1221. package/dist/esm/mds-input-select.entry.js +3 -3
  1222. package/dist/esm/mds-input-switch_2.entry.js +4 -4
  1223. package/dist/esm/mds-input-tip_2.entry.js +3 -3
  1224. package/dist/esm/mds-input-upload.entry.js +13 -14
  1225. package/dist/esm/mds-input.entry.js +3 -3
  1226. package/dist/esm/mds-keyboard-key.entry.js +1 -1
  1227. package/dist/esm/mds-keyboard.entry.js +1 -1
  1228. package/dist/esm/mds-kpi-item.entry.js +2 -2
  1229. package/dist/esm/mds-kpi.entry.js +1 -1
  1230. package/dist/esm/mds-label.entry.js +1 -1
  1231. package/dist/esm/mds-link.entry.js +3 -3
  1232. package/dist/esm/mds-list-item.entry.js +1 -1
  1233. package/dist/esm/mds-list.entry.js +1 -1
  1234. package/dist/esm/mds-mention.entry.js +1 -1
  1235. package/dist/esm/mds-modal.entry.js +4 -4
  1236. package/dist/esm/mds-note.entry.js +2 -2
  1237. package/dist/esm/mds-notification.entry.js +46 -3
  1238. package/dist/esm/mds-paginator-item.entry.js +2 -2
  1239. package/dist/esm/mds-paginator.entry.js +2 -2
  1240. package/dist/esm/mds-policy-ai.entry.js +1 -1
  1241. package/dist/esm/mds-pref-animation.entry.js +1 -1
  1242. package/dist/esm/mds-pref-consumption.entry.js +1 -1
  1243. package/dist/esm/mds-pref-contrast.entry.js +1 -1
  1244. package/dist/esm/mds-pref-language-item.entry.js +1 -1
  1245. package/dist/esm/mds-pref-language.entry.js +1 -1
  1246. package/dist/esm/mds-pref-mode.entry.js +1 -1
  1247. package/dist/esm/mds-pref-theme-item.entry.js +18 -4
  1248. package/dist/esm/mds-pref-theme.entry.js +12 -3
  1249. package/dist/esm/mds-pref.entry.js +1 -1
  1250. package/dist/esm/mds-price-table-features-cell.entry.js +2 -2
  1251. package/dist/esm/mds-price-table-features-row.entry.js +2 -2
  1252. package/dist/esm/mds-price-table-features.entry.js +2 -2
  1253. package/dist/esm/mds-price-table-header.entry.js +1 -1
  1254. package/dist/esm/mds-price-table-list-item.entry.js +2 -2
  1255. package/dist/esm/mds-price-table-list.entry.js +2 -2
  1256. package/dist/esm/mds-price-table.entry.js +1 -1
  1257. package/dist/esm/mds-progress_2.entry.js +3 -3
  1258. package/dist/esm/mds-push-notification-item.entry.js +2 -2
  1259. package/dist/esm/mds-push-notification.entry.js +2 -2
  1260. package/dist/esm/mds-quote.entry.js +1 -1
  1261. package/dist/esm/mds-radial-menu-item.entry.js +1 -1
  1262. package/dist/esm/mds-radial-menu.entry.js +1 -1
  1263. package/dist/esm/mds-separator.entry.js +1 -1
  1264. package/dist/esm/mds-status-bar.entry.js +2 -2
  1265. package/dist/esm/mds-stepper-bar-item.entry.js +2 -2
  1266. package/dist/esm/mds-stepper-bar.entry.js +1 -1
  1267. package/dist/esm/mds-tab-bar-item.entry.js +2 -2
  1268. package/dist/esm/mds-tab-bar.entry.js +2 -2
  1269. package/dist/esm/mds-tab_2.entry.js +3 -3
  1270. package/dist/esm/mds-table-body.entry.js +2 -2
  1271. package/dist/esm/mds-table-footer.entry.js +2 -2
  1272. package/dist/esm/mds-table-header-cell.entry.js +2 -2
  1273. package/dist/esm/mds-table-header.entry.js +2 -2
  1274. package/dist/esm/mds-table-row.entry.js +3 -3
  1275. package/dist/esm/mds-table.entry.js +2 -2
  1276. package/dist/esm/mds-text.entry.js +45 -5
  1277. package/dist/esm/mds-toast-region.entry.js +1 -1
  1278. package/dist/esm/mds-toast.entry.js +2 -2
  1279. package/dist/esm/mds-tooltip.entry.js +2 -2
  1280. package/dist/esm/mds-tree-item.entry.js +1 -1
  1281. package/dist/esm/mds-tree.entry.js +2 -2
  1282. package/dist/esm/mds-url-view.entry.js +2 -2
  1283. package/dist/esm/mds-usage.entry.js +2 -2
  1284. package/dist/esm/mds-video-wall.entry.js +1 -1
  1285. package/dist/esm/mds-zero.entry.js +2 -2
  1286. package/dist/esm-es5/loader.js +1 -1
  1287. package/dist/esm-es5/magma-components.js +1 -1
  1288. package/dist/esm-es5/mds-accordion-item.entry.js +6 -3
  1289. package/dist/esm-es5/mds-accordion-timer-item.entry.js +5 -2
  1290. package/dist/esm-es5/mds-avatar.entry.js +1 -1
  1291. package/dist/esm-es5/mds-banner_3.entry.js +3 -3
  1292. package/dist/esm-es5/mds-book.entry.js +49 -44
  1293. package/dist/esm-es5/mds-button_3.entry.js +3 -3
  1294. package/dist/esm-es5/mds-card-content.entry.js +1 -1
  1295. package/dist/esm-es5/mds-card-footer.entry.js +1 -1
  1296. package/dist/esm-es5/mds-card-header.entry.js +1 -1
  1297. package/dist/esm-es5/mds-card-media.entry.js +1 -1
  1298. package/dist/esm-es5/mds-card.entry.js +3 -3
  1299. package/dist/esm-es5/mds-details.entry.js +1 -1
  1300. package/dist/esm-es5/mds-dropdown.entry.js +2 -2
  1301. package/dist/esm-es5/mds-emoji.entry.js +110 -108
  1302. package/dist/esm-es5/mds-entity.entry.js +1 -1
  1303. package/dist/esm-es5/mds-file-preview.entry.js +1 -1
  1304. package/dist/esm-es5/mds-file.entry.js +1 -1
  1305. package/dist/esm-es5/mds-filter-item.entry.js +1 -1
  1306. package/dist/esm-es5/mds-filter.entry.js +1 -1
  1307. package/dist/esm-es5/mds-header-bar.entry.js +2 -2
  1308. package/dist/esm-es5/mds-header.entry.js +3 -3
  1309. package/dist/esm-es5/mds-horizontal-scroll.entry.js +1 -1
  1310. package/dist/esm-es5/mds-hr.entry.js +1 -1
  1311. package/dist/esm-es5/mds-input-date-range-preselection.entry.js +1 -1
  1312. package/dist/esm-es5/mds-input-date-range.entry.js +15 -15
  1313. package/dist/esm-es5/mds-input-date.entry.js +3 -3
  1314. package/dist/esm-es5/mds-input-field.entry.js +7 -2
  1315. package/dist/esm-es5/mds-input-otp.entry.js +1 -1
  1316. package/dist/esm-es5/mds-input-range.entry.js +1 -1
  1317. package/dist/esm-es5/mds-input-select.entry.js +2 -2
  1318. package/dist/esm-es5/mds-input-switch_2.entry.js +2 -2
  1319. package/dist/esm-es5/mds-input-tip_2.entry.js +2 -2
  1320. package/dist/esm-es5/mds-input-upload.entry.js +2 -2
  1321. package/dist/esm-es5/mds-input.entry.js +2 -2
  1322. package/dist/esm-es5/mds-keyboard-key.entry.js +1 -1
  1323. package/dist/esm-es5/mds-keyboard.entry.js +1 -1
  1324. package/dist/esm-es5/mds-kpi-item.entry.js +3 -3
  1325. package/dist/esm-es5/mds-kpi.entry.js +1 -1
  1326. package/dist/esm-es5/mds-label.entry.js +1 -1
  1327. package/dist/esm-es5/mds-link.entry.js +1 -1
  1328. package/dist/esm-es5/mds-list-item.entry.js +1 -1
  1329. package/dist/esm-es5/mds-list.entry.js +1 -1
  1330. package/dist/esm-es5/mds-mention.entry.js +2 -2
  1331. package/dist/esm-es5/mds-modal.entry.js +15 -15
  1332. package/dist/esm-es5/mds-note.entry.js +2 -2
  1333. package/dist/esm-es5/mds-notification.entry.js +32 -6
  1334. package/dist/esm-es5/mds-paginator-item.entry.js +2 -2
  1335. package/dist/esm-es5/mds-paginator.entry.js +3 -3
  1336. package/dist/esm-es5/mds-policy-ai.entry.js +1 -1
  1337. package/dist/esm-es5/mds-pref-animation.entry.js +1 -1
  1338. package/dist/esm-es5/mds-pref-consumption.entry.js +1 -1
  1339. package/dist/esm-es5/mds-pref-contrast.entry.js +2 -2
  1340. package/dist/esm-es5/mds-pref-language-item.entry.js +1 -1
  1341. package/dist/esm-es5/mds-pref-language.entry.js +1 -1
  1342. package/dist/esm-es5/mds-pref-mode.entry.js +1 -1
  1343. package/dist/esm-es5/mds-pref-theme-item.entry.js +12 -5
  1344. package/dist/esm-es5/mds-pref-theme.entry.js +13 -8
  1345. package/dist/esm-es5/mds-pref.entry.js +1 -1
  1346. package/dist/esm-es5/mds-price-table-features-cell.entry.js +2 -2
  1347. package/dist/esm-es5/mds-price-table-features-row.entry.js +1 -1
  1348. package/dist/esm-es5/mds-price-table-features.entry.js +1 -1
  1349. package/dist/esm-es5/mds-price-table-header.entry.js +1 -1
  1350. package/dist/esm-es5/mds-price-table-list-item.entry.js +2 -2
  1351. package/dist/esm-es5/mds-price-table-list.entry.js +2 -2
  1352. package/dist/esm-es5/mds-price-table.entry.js +1 -1
  1353. package/dist/esm-es5/mds-progress_2.entry.js +3 -3
  1354. package/dist/esm-es5/mds-push-notification-item.entry.js +2 -2
  1355. package/dist/esm-es5/mds-push-notification.entry.js +2 -2
  1356. package/dist/esm-es5/mds-quote.entry.js +1 -1
  1357. package/dist/esm-es5/mds-radial-menu-item.entry.js +1 -1
  1358. package/dist/esm-es5/mds-radial-menu.entry.js +1 -1
  1359. package/dist/esm-es5/mds-separator.entry.js +1 -1
  1360. package/dist/esm-es5/mds-status-bar.entry.js +2 -2
  1361. package/dist/esm-es5/mds-stepper-bar-item.entry.js +2 -2
  1362. package/dist/esm-es5/mds-stepper-bar.entry.js +1 -1
  1363. package/dist/esm-es5/mds-tab-bar-item.entry.js +2 -2
  1364. package/dist/esm-es5/mds-tab-bar.entry.js +2 -2
  1365. package/dist/esm-es5/mds-tab_2.entry.js +2 -2
  1366. package/dist/esm-es5/mds-table-body.entry.js +1 -1
  1367. package/dist/esm-es5/mds-table-footer.entry.js +2 -2
  1368. package/dist/esm-es5/mds-table-header-cell.entry.js +2 -2
  1369. package/dist/esm-es5/mds-table-header.entry.js +4 -4
  1370. package/dist/esm-es5/mds-table-row.entry.js +2 -2
  1371. package/dist/esm-es5/mds-table.entry.js +2 -2
  1372. package/dist/esm-es5/mds-text.entry.js +12 -6
  1373. package/dist/esm-es5/mds-toast-region.entry.js +2 -2
  1374. package/dist/esm-es5/mds-toast.entry.js +2 -2
  1375. package/dist/esm-es5/mds-tooltip.entry.js +2 -2
  1376. package/dist/esm-es5/mds-tree-item.entry.js +1 -1
  1377. package/dist/esm-es5/mds-tree.entry.js +2 -2
  1378. package/dist/esm-es5/mds-url-view.entry.js +2 -2
  1379. package/dist/esm-es5/mds-usage.entry.js +2 -2
  1380. package/dist/esm-es5/mds-video-wall.entry.js +1 -1
  1381. package/dist/esm-es5/mds-zero.entry.js +1 -1
  1382. package/dist/hydrate/index.js +368 -202
  1383. package/dist/hydrate/index.mjs +368 -202
  1384. package/dist/lint/core/data.d.ts +23 -0
  1385. package/dist/lint/core/data.js +57 -0
  1386. package/dist/lint/core/patterns.d.ts +497 -0
  1387. package/dist/lint/core/patterns.js +1711 -0
  1388. package/dist/lint/index.d.ts +1 -0
  1389. package/dist/lint/index.js +1 -0
  1390. package/dist/lint/mcp/checks.d.ts +17 -3
  1391. package/dist/lint/mcp/checks.js +62 -12
  1392. package/dist/lint/mcp/cli.js +6 -3
  1393. package/dist/lint/mcp/components.js +11 -4
  1394. package/dist/lint/mcp/context.d.ts +11 -2
  1395. package/dist/lint/mcp/context.js +17 -3
  1396. package/dist/lint/mcp/guides.js +58 -7
  1397. package/dist/lint/mcp/icons.d.ts +6 -0
  1398. package/dist/lint/mcp/icons.js +4 -4
  1399. package/dist/lint/mcp/patterns.d.ts +75 -0
  1400. package/dist/lint/mcp/patterns.js +347 -0
  1401. package/dist/lint/mcp/protocol.d.ts +19 -1
  1402. package/dist/lint/mcp/protocol.js +16 -3
  1403. package/dist/lint/mcp/render-page.d.ts +40 -0
  1404. package/dist/lint/mcp/render-page.js +360 -0
  1405. package/dist/lint/mcp/render.d.ts +130 -0
  1406. package/dist/lint/mcp/render.js +693 -0
  1407. package/dist/lint/mcp/server.d.ts +2 -0
  1408. package/dist/lint/mcp/server.js +9 -2
  1409. package/dist/lint/mcp/tools.json +418 -6
  1410. package/dist/magma-components/magma-components.esm.js +1 -1
  1411. package/dist/magma-components/p-0384db44.system.entry.js +26 -0
  1412. package/dist/magma-components/p-03fb86a6.system.entry.js +7 -0
  1413. package/dist/magma-components/p-05455645.system.entry.js +6 -0
  1414. package/dist/magma-components/p-06691ab3.system.entry.js +27 -0
  1415. package/dist/magma-components/p-074d7b75.entry.js +1 -0
  1416. package/dist/magma-components/p-08da465d.entry.js +1 -0
  1417. package/dist/magma-components/p-0a0dfdf4.system.entry.js +4 -0
  1418. package/dist/magma-components/p-0c8f22dc.system.entry.js +5 -0
  1419. package/dist/magma-components/p-0d3da482.system.entry.js +1 -0
  1420. package/dist/magma-components/p-0d42ac4a.entry.js +1 -0
  1421. package/dist/magma-components/p-0fc41e34.system.entry.js +1 -0
  1422. package/dist/magma-components/p-10d52280.entry.js +1 -0
  1423. package/dist/magma-components/p-11210b60.system.entry.js +24 -0
  1424. package/dist/magma-components/p-12be0f43.system.entry.js +91 -0
  1425. package/dist/magma-components/p-13cfc01a.entry.js +1 -0
  1426. package/dist/magma-components/p-14122f2d.entry.js +1 -0
  1427. package/dist/magma-components/p-1467ded5.system.entry.js +7 -0
  1428. package/dist/magma-components/p-18244fd7.system.entry.js +35 -0
  1429. package/dist/magma-components/p-18b27217.entry.js +1 -0
  1430. package/dist/magma-components/p-1a20f239.system.entry.js +1 -0
  1431. package/dist/magma-components/p-1f746ad1.system.entry.js +82 -0
  1432. package/dist/magma-components/p-2111aa67.system.entry.js +1 -0
  1433. package/dist/magma-components/p-21345ecc.entry.js +1 -0
  1434. package/dist/magma-components/p-25dcbf22.entry.js +1 -0
  1435. package/dist/magma-components/p-27254fbd.entry.js +1 -0
  1436. package/dist/magma-components/p-299dab17.entry.js +1 -0
  1437. package/dist/magma-components/p-29dd6d94.entry.js +1 -0
  1438. package/dist/magma-components/p-2a445b98.system.entry.js +977 -0
  1439. package/dist/magma-components/p-2d199db0.system.entry.js +25 -0
  1440. package/dist/magma-components/p-2d2cdf0d.entry.js +1 -0
  1441. package/dist/magma-components/p-2e68180d.system.entry.js +32 -0
  1442. package/dist/magma-components/p-308a4ae5.system.entry.js +1 -0
  1443. package/dist/magma-components/p-30f95d10.entry.js +1 -0
  1444. package/dist/magma-components/p-34421ef2.system.entry.js +77 -0
  1445. package/dist/magma-components/p-35c170ba.system.entry.js +17 -0
  1446. package/dist/magma-components/p-37881115.system.entry.js +14 -0
  1447. package/dist/magma-components/p-384d93dc.system.entry.js +1 -0
  1448. package/dist/magma-components/p-387fa36d.system.entry.js +1 -0
  1449. package/dist/magma-components/p-3af8a86a.system.entry.js +111 -0
  1450. package/dist/magma-components/p-3b494de7.entry.js +1 -0
  1451. package/dist/magma-components/p-3b578659.system.entry.js +48 -0
  1452. package/dist/magma-components/p-3be9b384.system.entry.js +34 -0
  1453. package/dist/magma-components/p-445198a1.entry.js +1 -0
  1454. package/dist/magma-components/p-445bc62a.system.entry.js +1 -0
  1455. package/dist/magma-components/p-45a3e7eb.entry.js +1 -0
  1456. package/dist/magma-components/p-45b19935.system.entry.js +54 -0
  1457. package/dist/magma-components/p-4606d11f.entry.js +1 -0
  1458. package/dist/magma-components/p-4646cdc0.system.entry.js +17 -0
  1459. package/dist/magma-components/p-4669334a.system.entry.js +3 -0
  1460. package/dist/magma-components/p-46a928c3.entry.js +1 -0
  1461. package/dist/magma-components/p-4748378e.system.entry.js +220 -0
  1462. package/dist/magma-components/p-4da1c089.entry.js +1 -0
  1463. package/dist/magma-components/p-4e5b8618.system.entry.js +1 -0
  1464. package/dist/magma-components/p-4e8c5b68.entry.js +1 -0
  1465. package/dist/magma-components/p-4f0153cd.entry.js +1 -0
  1466. package/dist/magma-components/p-4f48c171.system.entry.js +1 -0
  1467. package/dist/magma-components/p-4fc0e294.entry.js +1 -0
  1468. package/dist/magma-components/p-4fd0fdb8.system.entry.js +61 -0
  1469. package/dist/magma-components/p-5575f198.entry.js +1 -0
  1470. package/dist/magma-components/p-5686da49.system.entry.js +13 -0
  1471. package/dist/magma-components/p-56a25ec6.entry.js +1 -0
  1472. package/dist/magma-components/p-57ee6e32.entry.js +1 -0
  1473. package/dist/magma-components/p-5931fdfc.system.entry.js +41 -0
  1474. package/dist/magma-components/p-5a8fa2d0.entry.js +1 -0
  1475. package/dist/magma-components/p-5aa8f150.entry.js +1 -0
  1476. package/dist/magma-components/p-5c8f408e.entry.js +1 -0
  1477. package/dist/magma-components/p-5d1cba9c.system.entry.js +1 -0
  1478. package/dist/magma-components/p-5d56a7cd.system.entry.js +47 -0
  1479. package/dist/magma-components/p-60acbc5f.system.entry.js +31 -0
  1480. package/dist/magma-components/p-60b21db7.entry.js +1 -0
  1481. package/dist/magma-components/p-60d6e60f.entry.js +1 -0
  1482. package/dist/magma-components/p-6129954d.system.entry.js +22 -0
  1483. package/dist/magma-components/p-61e11cd0.system.entry.js +16 -0
  1484. package/dist/magma-components/p-625de2e6.system.entry.js +24 -0
  1485. package/dist/magma-components/p-627c2780.entry.js +1 -0
  1486. package/dist/magma-components/p-6896786e.entry.js +1 -0
  1487. package/dist/magma-components/p-69319301.system.entry.js +10 -0
  1488. package/dist/magma-components/p-6a994dc1.entry.js +1 -0
  1489. package/dist/magma-components/p-6c73689a.system.entry.js +25 -0
  1490. package/dist/magma-components/p-6d009b42.system.entry.js +8 -0
  1491. package/dist/magma-components/p-72971cf7.system.entry.js +7 -0
  1492. package/dist/magma-components/p-741f8f45.system.entry.js +13 -0
  1493. package/dist/magma-components/p-7837856f.entry.js +1 -0
  1494. package/dist/magma-components/p-797c64f4.system.entry.js +19 -0
  1495. package/dist/magma-components/p-7a920b70.entry.js +1 -0
  1496. package/dist/magma-components/p-7b06b2f2.entry.js +1 -0
  1497. package/dist/magma-components/p-7c055074.entry.js +1 -0
  1498. package/dist/magma-components/p-7c3a7521.entry.js +1 -0
  1499. package/dist/magma-components/p-7d61f442.entry.js +1 -0
  1500. package/dist/magma-components/p-7ee31f2e.entry.js +1 -0
  1501. package/dist/magma-components/p-7f418ae1.entry.js +1 -0
  1502. package/dist/magma-components/p-7ff5552f.entry.js +1 -0
  1503. package/dist/magma-components/p-81d2582a.entry.js +1 -0
  1504. package/dist/magma-components/p-8239e526.system.entry.js +10 -0
  1505. package/dist/magma-components/p-844bce77.entry.js +1 -0
  1506. package/dist/magma-components/p-84aac233.entry.js +1 -0
  1507. package/dist/magma-components/p-85376ff5.entry.js +1 -0
  1508. package/dist/magma-components/p-85bf9c93.entry.js +1 -0
  1509. package/dist/magma-components/p-86f11a5a.entry.js +1 -0
  1510. package/dist/magma-components/p-8a8cad6c.system.entry.js +1 -0
  1511. package/dist/magma-components/p-8aa4cd10.entry.js +1 -0
  1512. package/dist/magma-components/p-8b8cd213.system.entry.js +49 -0
  1513. package/dist/magma-components/p-8bf8e032.entry.js +1 -0
  1514. package/dist/magma-components/p-8feba226.entry.js +1 -0
  1515. package/dist/magma-components/p-90d50492.system.entry.js +4 -0
  1516. package/dist/magma-components/p-9303fb16.system.entry.js +39 -0
  1517. package/dist/magma-components/p-948ecde4.entry.js +8 -0
  1518. package/dist/magma-components/p-95ddc950.system.entry.js +11 -0
  1519. package/dist/magma-components/p-97217527.system.entry.js +1 -0
  1520. package/dist/magma-components/p-97c6e10a.entry.js +1 -0
  1521. package/dist/magma-components/p-98e167e8.system.entry.js +23 -0
  1522. package/dist/magma-components/p-9a0f8eb1.entry.js +1 -0
  1523. package/dist/magma-components/p-9c2b67fc.system.entry.js +40 -0
  1524. package/dist/magma-components/p-9c784173.entry.js +1 -0
  1525. package/dist/magma-components/p-9e07535e.system.entry.js +78 -0
  1526. package/dist/magma-components/p-9e2b1a29.entry.js +1 -0
  1527. package/dist/magma-components/p-9ed54db1.entry.js +1 -0
  1528. package/dist/magma-components/p-9ef0d4e5.system.entry.js +7 -0
  1529. package/dist/magma-components/p-9ef64212.entry.js +18 -0
  1530. package/dist/magma-components/p-9f55fa7a.system.entry.js +51 -0
  1531. package/dist/magma-components/p-B8zYiZQY.system.js +1 -1
  1532. package/dist/magma-components/p-a2e3a545.entry.js +1 -0
  1533. package/dist/magma-components/p-a3156523.system.entry.js +98 -0
  1534. package/dist/magma-components/p-a3d09996.entry.js +1 -0
  1535. package/dist/magma-components/p-a65ce11a.system.entry.js +17 -0
  1536. package/dist/magma-components/p-a8206d9c.entry.js +1 -0
  1537. package/dist/magma-components/p-a9caed77.entry.js +1 -0
  1538. package/dist/magma-components/p-aac622ef.system.entry.js +1 -0
  1539. package/dist/magma-components/p-ac099ed6.entry.js +1 -0
  1540. package/dist/magma-components/p-ac161cb5.entry.js +1 -0
  1541. package/dist/magma-components/p-ad13ade5.system.entry.js +13 -0
  1542. package/dist/magma-components/p-adab176e.system.entry.js +13 -0
  1543. package/dist/magma-components/p-ae9735e4.system.entry.js +22 -0
  1544. package/dist/magma-components/p-b0749f83.system.entry.js +10 -0
  1545. package/dist/magma-components/p-b0850daa.entry.js +1 -0
  1546. package/dist/magma-components/p-b2763352.entry.js +1 -0
  1547. package/dist/magma-components/p-b30b487c.system.entry.js +55 -0
  1548. package/dist/magma-components/p-b464668b.system.entry.js +105 -0
  1549. package/dist/magma-components/p-b523fabe.system.entry.js +46 -0
  1550. package/dist/magma-components/p-b61546fd.entry.js +1 -0
  1551. package/dist/magma-components/p-b6412ddd.system.entry.js +1 -0
  1552. package/dist/magma-components/p-b781c932.system.entry.js +7 -0
  1553. package/dist/magma-components/p-b85f56d7.entry.js +1 -0
  1554. package/dist/magma-components/p-b8f4938a.entry.js +1 -0
  1555. package/dist/magma-components/p-bba4f1f0.system.entry.js +46 -0
  1556. package/dist/magma-components/p-bc054ffa.system.entry.js +19 -0
  1557. package/dist/magma-components/p-be2ca282.entry.js +1 -0
  1558. package/dist/magma-components/p-c35ea44d.system.entry.js +12 -0
  1559. package/dist/magma-components/p-c683cd13.entry.js +1 -0
  1560. package/dist/magma-components/p-c7dc17f8.entry.js +1 -0
  1561. package/dist/magma-components/p-c915fba5.system.entry.js +21 -0
  1562. package/dist/magma-components/p-c9553777.entry.js +1 -0
  1563. package/dist/magma-components/p-c9bd81c5.system.entry.js +225 -0
  1564. package/dist/magma-components/p-ccffdf0b.system.entry.js +80 -0
  1565. package/dist/magma-components/p-cd6dd836.entry.js +1 -0
  1566. package/dist/magma-components/p-cf42d6ea.system.entry.js +9 -0
  1567. package/dist/magma-components/p-cfbf3a76.system.entry.js +23 -0
  1568. package/dist/magma-components/p-d29c959d.entry.js +1 -0
  1569. package/dist/magma-components/p-d360e4c5.entry.js +1 -0
  1570. package/dist/magma-components/p-d43e2a9a.entry.js +1 -0
  1571. package/dist/magma-components/p-d50d4023.entry.js +1 -0
  1572. package/dist/magma-components/p-d81fcbde.system.entry.js +20 -0
  1573. package/dist/magma-components/p-d85f3e5e.system.entry.js +16 -0
  1574. package/dist/magma-components/p-dcb5f965.entry.js +1 -0
  1575. package/dist/magma-components/p-ddfb4da3.entry.js +1 -0
  1576. package/dist/magma-components/p-e0049e96.system.entry.js +33 -0
  1577. package/dist/magma-components/p-e059aaa9.entry.js +1 -0
  1578. package/dist/magma-components/p-e428490d.system.entry.js +5 -0
  1579. package/dist/magma-components/p-e79eb427.system.entry.js +7 -0
  1580. package/dist/magma-components/p-e7f717ab.entry.js +1 -0
  1581. package/dist/magma-components/p-e92327a2.entry.js +1 -0
  1582. package/dist/magma-components/p-ecc2893d.system.entry.js +24 -0
  1583. package/dist/magma-components/p-ed4fd7a4.entry.js +1 -0
  1584. package/dist/magma-components/p-ef1bdd44.entry.js +1 -0
  1585. package/dist/magma-components/p-efe27253.system.entry.js +27 -0
  1586. package/dist/magma-components/p-f09f3fe1.system.entry.js +52 -0
  1587. package/dist/magma-components/p-f181c679.system.entry.js +16 -0
  1588. package/dist/magma-components/p-f22b8091.entry.js +1 -0
  1589. package/dist/magma-components/p-f493fdc3.entry.js +1 -0
  1590. package/dist/magma-components/p-f5d9f625.entry.js +1 -0
  1591. package/dist/magma-components/p-f7426a75.entry.js +1 -0
  1592. package/dist/magma-components/p-fa387b74.system.entry.js +5 -0
  1593. package/dist/magma-components/p-fae9612b.system.entry.js +27 -0
  1594. package/dist/magma-components/p-fbf563c8.entry.js +1 -0
  1595. package/dist/magma-components/p-fd81c4ef.system.entry.js +29 -0
  1596. package/dist/magma-components/p-fdedc0ba.entry.js +1 -0
  1597. package/dist/magma-components/p-ff65fc97.entry.js +1 -0
  1598. package/dist/magma-components/p-ff82edad.entry.js +1 -0
  1599. package/dist/magma-components/p-fff26731.system.entry.js +15 -0
  1600. package/dist/stats.json +1292 -1091
  1601. package/dist/types/components/mds-accordion-item/mds-accordion-item.d.ts +4 -1
  1602. package/dist/types/components/mds-accordion-timer-item/mds-accordion-timer-item.d.ts +4 -1
  1603. package/dist/types/components/mds-book/mds-book.d.ts +6 -2
  1604. package/dist/types/components/mds-book/meta/types.d.ts +1 -1
  1605. package/dist/types/components/mds-input-field/mds-input-field.d.ts +6 -0
  1606. package/dist/types/components/mds-keyboard-key/meta/icons.d.ts +1 -1
  1607. package/dist/types/components/mds-notification/mds-notification.d.ts +23 -0
  1608. package/dist/types/components/mds-pref-theme-item/mds-pref-theme-item.d.ts +9 -2
  1609. package/dist/types/components/mds-text/mds-text.d.ts +8 -5
  1610. package/dist/types/components/mds-text/meta/dictionary.d.ts +2 -1
  1611. package/dist/types/components/mds-text/meta/types.d.ts +5 -0
  1612. package/dist/types/components/mds-text/meta/variants.d.ts +35 -0
  1613. package/dist/types/components.d.ts +52 -19
  1614. package/package.json +27 -18
  1615. package/agents/anti-patterns.md +0 -42
  1616. package/dist/collection/components/mds-accordion/antipattern.md +0 -122
  1617. package/dist/collection/components/mds-accordion/pattern.md +0 -147
  1618. package/dist/collection/components/mds-accordion-item/antipattern.md +0 -137
  1619. package/dist/collection/components/mds-accordion-item/pattern.md +0 -154
  1620. package/dist/collection/components/mds-accordion-timer/antipattern.md +0 -135
  1621. package/dist/collection/components/mds-accordion-timer/pattern.md +0 -137
  1622. package/dist/collection/components/mds-accordion-timer-item/antipattern.md +0 -142
  1623. package/dist/collection/components/mds-accordion-timer-item/pattern.md +0 -132
  1624. package/dist/collection/components/mds-author/antipattern.md +0 -106
  1625. package/dist/collection/components/mds-author/pattern.md +0 -101
  1626. package/dist/collection/components/mds-avatar/antipattern.md +0 -96
  1627. package/dist/collection/components/mds-avatar/pattern.md +0 -118
  1628. package/dist/collection/components/mds-avatar-stack/antipattern.md +0 -121
  1629. package/dist/collection/components/mds-avatar-stack/pattern.md +0 -122
  1630. package/dist/collection/components/mds-avatar-stack-item/antipattern.md +0 -113
  1631. package/dist/collection/components/mds-avatar-stack-item/pattern.md +0 -104
  1632. package/dist/collection/components/mds-badge/antipattern.md +0 -103
  1633. package/dist/collection/components/mds-badge/pattern.md +0 -126
  1634. package/dist/collection/components/mds-banner/antipattern.md +0 -140
  1635. package/dist/collection/components/mds-banner/pattern.md +0 -175
  1636. package/dist/collection/components/mds-benchmark-bar/antipattern.md +0 -77
  1637. package/dist/collection/components/mds-benchmark-bar/pattern.md +0 -102
  1638. package/dist/collection/components/mds-bibliography/antipattern.md +0 -128
  1639. package/dist/collection/components/mds-bibliography/pattern.md +0 -140
  1640. package/dist/collection/components/mds-book/antipattern.md +0 -88
  1641. package/dist/collection/components/mds-book/pattern.md +0 -125
  1642. package/dist/collection/components/mds-breadcrumb/antipattern.md +0 -112
  1643. package/dist/collection/components/mds-breadcrumb/pattern.md +0 -100
  1644. package/dist/collection/components/mds-breadcrumb-item/antipattern.md +0 -109
  1645. package/dist/collection/components/mds-breadcrumb-item/pattern.md +0 -83
  1646. package/dist/collection/components/mds-button/antipattern.md +0 -160
  1647. package/dist/collection/components/mds-button/pattern.md +0 -211
  1648. package/dist/collection/components/mds-button-dropdown/antipattern.md +0 -158
  1649. package/dist/collection/components/mds-button-dropdown/pattern.md +0 -171
  1650. package/dist/collection/components/mds-button-group/antipattern.md +0 -105
  1651. package/dist/collection/components/mds-button-group/pattern.md +0 -89
  1652. package/dist/collection/components/mds-calendar/antipattern.md +0 -113
  1653. package/dist/collection/components/mds-calendar/pattern.md +0 -127
  1654. package/dist/collection/components/mds-calendar-cell/antipattern.md +0 -58
  1655. package/dist/collection/components/mds-calendar-cell/pattern.md +0 -83
  1656. package/dist/collection/components/mds-card/antipattern.md +0 -133
  1657. package/dist/collection/components/mds-card/pattern.md +0 -161
  1658. package/dist/collection/components/mds-card-content/antipattern.md +0 -110
  1659. package/dist/collection/components/mds-card-content/pattern.md +0 -91
  1660. package/dist/collection/components/mds-card-footer/antipattern.md +0 -112
  1661. package/dist/collection/components/mds-card-footer/pattern.md +0 -95
  1662. package/dist/collection/components/mds-card-header/antipattern.md +0 -114
  1663. package/dist/collection/components/mds-card-header/pattern.md +0 -143
  1664. package/dist/collection/components/mds-card-media/antipattern.md +0 -128
  1665. package/dist/collection/components/mds-card-media/pattern.md +0 -93
  1666. package/dist/collection/components/mds-chip/antipattern.md +0 -118
  1667. package/dist/collection/components/mds-chip/pattern.md +0 -164
  1668. package/dist/collection/components/mds-details/antipattern.md +0 -124
  1669. package/dist/collection/components/mds-details/pattern.md +0 -136
  1670. package/dist/collection/components/mds-dropdown/antipattern.md +0 -137
  1671. package/dist/collection/components/mds-dropdown/pattern.md +0 -201
  1672. package/dist/collection/components/mds-emoji/antipattern.md +0 -116
  1673. package/dist/collection/components/mds-emoji/pattern.md +0 -203
  1674. package/dist/collection/components/mds-entity/antipattern.md +0 -119
  1675. package/dist/collection/components/mds-entity/pattern.md +0 -132
  1676. package/dist/collection/components/mds-file/antipattern.md +0 -91
  1677. package/dist/collection/components/mds-file/pattern.md +0 -107
  1678. package/dist/collection/components/mds-file-preview/antipattern.md +0 -129
  1679. package/dist/collection/components/mds-file-preview/pattern.md +0 -163
  1680. package/dist/collection/components/mds-filter/antipattern.md +0 -140
  1681. package/dist/collection/components/mds-filter/pattern.md +0 -156
  1682. package/dist/collection/components/mds-filter-item/antipattern.md +0 -127
  1683. package/dist/collection/components/mds-filter-item/pattern.md +0 -123
  1684. package/dist/collection/components/mds-header/antipattern.md +0 -120
  1685. package/dist/collection/components/mds-header/pattern.md +0 -180
  1686. package/dist/collection/components/mds-header-bar/antipattern.md +0 -117
  1687. package/dist/collection/components/mds-header-bar/pattern.md +0 -138
  1688. package/dist/collection/components/mds-help/antipattern.md +0 -73
  1689. package/dist/collection/components/mds-help/pattern.md +0 -106
  1690. package/dist/collection/components/mds-horizontal-scroll/antipattern.md +0 -120
  1691. package/dist/collection/components/mds-horizontal-scroll/pattern.md +0 -143
  1692. package/dist/collection/components/mds-hr/antipattern.md +0 -84
  1693. package/dist/collection/components/mds-hr/pattern.md +0 -88
  1694. package/dist/collection/components/mds-icon/antipattern.md +0 -118
  1695. package/dist/collection/components/mds-icon/pattern.md +0 -135
  1696. package/dist/collection/components/mds-img/antipattern.md +0 -106
  1697. package/dist/collection/components/mds-img/pattern.md +0 -125
  1698. package/dist/collection/components/mds-input/antipattern.md +0 -128
  1699. package/dist/collection/components/mds-input/pattern.md +0 -265
  1700. package/dist/collection/components/mds-input-date/antipattern.md +0 -107
  1701. package/dist/collection/components/mds-input-date/pattern.md +0 -157
  1702. package/dist/collection/components/mds-input-date-range/antipattern.md +0 -168
  1703. package/dist/collection/components/mds-input-date-range/pattern.md +0 -121
  1704. package/dist/collection/components/mds-input-date-range-preselection/antipattern.md +0 -152
  1705. package/dist/collection/components/mds-input-date-range-preselection/pattern.md +0 -91
  1706. package/dist/collection/components/mds-input-field/antipattern.md +0 -115
  1707. package/dist/collection/components/mds-input-field/pattern.md +0 -95
  1708. package/dist/collection/components/mds-input-otp/antipattern.md +0 -105
  1709. package/dist/collection/components/mds-input-otp/pattern.md +0 -107
  1710. package/dist/collection/components/mds-input-range/antipattern.md +0 -123
  1711. package/dist/collection/components/mds-input-range/pattern.md +0 -100
  1712. package/dist/collection/components/mds-input-select/antipattern.md +0 -126
  1713. package/dist/collection/components/mds-input-select/pattern.md +0 -166
  1714. package/dist/collection/components/mds-input-switch/antipattern.md +0 -116
  1715. package/dist/collection/components/mds-input-switch/pattern.md +0 -124
  1716. package/dist/collection/components/mds-input-tip/antipattern.md +0 -112
  1717. package/dist/collection/components/mds-input-tip/pattern.md +0 -122
  1718. package/dist/collection/components/mds-input-tip-item/antipattern.md +0 -98
  1719. package/dist/collection/components/mds-input-tip-item/pattern.md +0 -106
  1720. package/dist/collection/components/mds-input-upload/antipattern.md +0 -143
  1721. package/dist/collection/components/mds-input-upload/pattern.md +0 -161
  1722. package/dist/collection/components/mds-keyboard/antipattern.md +0 -111
  1723. package/dist/collection/components/mds-keyboard/pattern.md +0 -128
  1724. package/dist/collection/components/mds-keyboard-key/antipattern.md +0 -116
  1725. package/dist/collection/components/mds-keyboard-key/pattern.md +0 -87
  1726. package/dist/collection/components/mds-kpi/antipattern.md +0 -93
  1727. package/dist/collection/components/mds-kpi/pattern.md +0 -112
  1728. package/dist/collection/components/mds-kpi-item/antipattern.md +0 -117
  1729. package/dist/collection/components/mds-kpi-item/pattern.md +0 -117
  1730. package/dist/collection/components/mds-label/antipattern.md +0 -92
  1731. package/dist/collection/components/mds-label/pattern.md +0 -109
  1732. package/dist/collection/components/mds-link/antipattern.md +0 -96
  1733. package/dist/collection/components/mds-link/pattern.md +0 -100
  1734. package/dist/collection/components/mds-list/antipattern.md +0 -117
  1735. package/dist/collection/components/mds-list/pattern.md +0 -104
  1736. package/dist/collection/components/mds-list-item/antipattern.md +0 -118
  1737. package/dist/collection/components/mds-list-item/pattern.md +0 -112
  1738. package/dist/collection/components/mds-mention/antipattern.md +0 -86
  1739. package/dist/collection/components/mds-mention/pattern.md +0 -89
  1740. package/dist/collection/components/mds-modal/antipattern.md +0 -94
  1741. package/dist/collection/components/mds-modal/pattern.md +0 -224
  1742. package/dist/collection/components/mds-note/antipattern.md +0 -99
  1743. package/dist/collection/components/mds-note/pattern.md +0 -107
  1744. package/dist/collection/components/mds-notification/antipattern.md +0 -86
  1745. package/dist/collection/components/mds-notification/pattern.md +0 -96
  1746. package/dist/collection/components/mds-paginator/antipattern.md +0 -96
  1747. package/dist/collection/components/mds-paginator/pattern.md +0 -98
  1748. package/dist/collection/components/mds-paginator-item/antipattern.md +0 -96
  1749. package/dist/collection/components/mds-paginator-item/pattern.md +0 -76
  1750. package/dist/collection/components/mds-policy-ai/antipattern.md +0 -97
  1751. package/dist/collection/components/mds-policy-ai/pattern.md +0 -107
  1752. package/dist/collection/components/mds-pref/antipattern.md +0 -85
  1753. package/dist/collection/components/mds-pref/pattern.md +0 -93
  1754. package/dist/collection/components/mds-pref-animation/antipattern.md +0 -67
  1755. package/dist/collection/components/mds-pref-animation/pattern.md +0 -86
  1756. package/dist/collection/components/mds-pref-consumption/antipattern.md +0 -84
  1757. package/dist/collection/components/mds-pref-consumption/pattern.md +0 -69
  1758. package/dist/collection/components/mds-pref-contrast/antipattern.md +0 -71
  1759. package/dist/collection/components/mds-pref-contrast/pattern.md +0 -82
  1760. package/dist/collection/components/mds-pref-language/antipattern.md +0 -130
  1761. package/dist/collection/components/mds-pref-language/pattern.md +0 -104
  1762. package/dist/collection/components/mds-pref-language-item/antipattern.md +0 -99
  1763. package/dist/collection/components/mds-pref-language-item/pattern.md +0 -85
  1764. package/dist/collection/components/mds-pref-mode/antipattern.md +0 -103
  1765. package/dist/collection/components/mds-pref-mode/pattern.md +0 -92
  1766. package/dist/collection/components/mds-pref-theme/antipattern.md +0 -104
  1767. package/dist/collection/components/mds-pref-theme/pattern.md +0 -96
  1768. package/dist/collection/components/mds-pref-theme-item/antipattern.md +0 -97
  1769. package/dist/collection/components/mds-pref-theme-item/pattern.md +0 -94
  1770. package/dist/collection/components/mds-price-table/antipattern.md +0 -131
  1771. package/dist/collection/components/mds-price-table/pattern.md +0 -182
  1772. package/dist/collection/components/mds-price-table-features/antipattern.md +0 -151
  1773. package/dist/collection/components/mds-price-table-features/pattern.md +0 -156
  1774. package/dist/collection/components/mds-price-table-features-cell/antipattern.md +0 -105
  1775. package/dist/collection/components/mds-price-table-features-cell/pattern.md +0 -123
  1776. package/dist/collection/components/mds-price-table-features-row/antipattern.md +0 -135
  1777. package/dist/collection/components/mds-price-table-features-row/pattern.md +0 -123
  1778. package/dist/collection/components/mds-price-table-header/antipattern.md +0 -133
  1779. package/dist/collection/components/mds-price-table-header/pattern.md +0 -176
  1780. package/dist/collection/components/mds-price-table-list/antipattern.md +0 -130
  1781. package/dist/collection/components/mds-price-table-list/pattern.md +0 -139
  1782. package/dist/collection/components/mds-price-table-list-item/antipattern.md +0 -86
  1783. package/dist/collection/components/mds-price-table-list-item/pattern.md +0 -108
  1784. package/dist/collection/components/mds-progress/antipattern.md +0 -94
  1785. package/dist/collection/components/mds-progress/pattern.md +0 -140
  1786. package/dist/collection/components/mds-push-notification/antipattern.md +0 -154
  1787. package/dist/collection/components/mds-push-notification/pattern.md +0 -200
  1788. package/dist/collection/components/mds-push-notification-item/antipattern.md +0 -129
  1789. package/dist/collection/components/mds-push-notification-item/pattern.md +0 -198
  1790. package/dist/collection/components/mds-quote/antipattern.md +0 -122
  1791. package/dist/collection/components/mds-quote/pattern.md +0 -108
  1792. package/dist/collection/components/mds-radial-menu/antipattern.md +0 -104
  1793. package/dist/collection/components/mds-radial-menu/pattern.md +0 -159
  1794. package/dist/collection/components/mds-radial-menu-item/antipattern.md +0 -108
  1795. package/dist/collection/components/mds-radial-menu-item/pattern.md +0 -96
  1796. package/dist/collection/components/mds-radial-progress/antipattern.md +0 -106
  1797. package/dist/collection/components/mds-radial-progress/pattern.md +0 -144
  1798. package/dist/collection/components/mds-separator/antipattern.md +0 -98
  1799. package/dist/collection/components/mds-separator/pattern.md +0 -82
  1800. package/dist/collection/components/mds-spinner/antipattern.md +0 -93
  1801. package/dist/collection/components/mds-spinner/pattern.md +0 -105
  1802. package/dist/collection/components/mds-status-bar/antipattern.md +0 -127
  1803. package/dist/collection/components/mds-status-bar/pattern.md +0 -121
  1804. package/dist/collection/components/mds-stepper-bar/antipattern.md +0 -123
  1805. package/dist/collection/components/mds-stepper-bar/pattern.md +0 -178
  1806. package/dist/collection/components/mds-stepper-bar-item/antipattern.md +0 -115
  1807. package/dist/collection/components/mds-stepper-bar-item/pattern.md +0 -200
  1808. package/dist/collection/components/mds-tab/antipattern.md +0 -189
  1809. package/dist/collection/components/mds-tab/pattern.md +0 -232
  1810. package/dist/collection/components/mds-tab-bar/antipattern.md +0 -105
  1811. package/dist/collection/components/mds-tab-bar/pattern.md +0 -87
  1812. package/dist/collection/components/mds-tab-bar-item/antipattern.md +0 -116
  1813. package/dist/collection/components/mds-tab-bar-item/pattern.md +0 -108
  1814. package/dist/collection/components/mds-tab-item/antipattern.md +0 -159
  1815. package/dist/collection/components/mds-tab-item/pattern.md +0 -174
  1816. package/dist/collection/components/mds-table/antipattern.md +0 -169
  1817. package/dist/collection/components/mds-table/pattern.md +0 -317
  1818. package/dist/collection/components/mds-table-body/antipattern.md +0 -117
  1819. package/dist/collection/components/mds-table-body/pattern.md +0 -151
  1820. package/dist/collection/components/mds-table-cell/antipattern.md +0 -100
  1821. package/dist/collection/components/mds-table-cell/pattern.md +0 -168
  1822. package/dist/collection/components/mds-table-footer/antipattern.md +0 -114
  1823. package/dist/collection/components/mds-table-footer/pattern.md +0 -115
  1824. package/dist/collection/components/mds-table-header/antipattern.md +0 -157
  1825. package/dist/collection/components/mds-table-header/pattern.md +0 -158
  1826. package/dist/collection/components/mds-table-header-cell/antipattern.md +0 -115
  1827. package/dist/collection/components/mds-table-header-cell/pattern.md +0 -166
  1828. package/dist/collection/components/mds-table-row/antipattern.md +0 -141
  1829. package/dist/collection/components/mds-table-row/pattern.md +0 -166
  1830. package/dist/collection/components/mds-text/antipattern.md +0 -112
  1831. package/dist/collection/components/mds-text/pattern.md +0 -138
  1832. package/dist/collection/components/mds-toast/antipattern.md +0 -149
  1833. package/dist/collection/components/mds-toast/pattern.md +0 -174
  1834. package/dist/collection/components/mds-toast-region/antipattern.md +0 -62
  1835. package/dist/collection/components/mds-toast-region/pattern.md +0 -90
  1836. package/dist/collection/components/mds-tooltip/antipattern.md +0 -122
  1837. package/dist/collection/components/mds-tooltip/pattern.md +0 -135
  1838. package/dist/collection/components/mds-tree/antipattern.md +0 -152
  1839. package/dist/collection/components/mds-tree/pattern.md +0 -196
  1840. package/dist/collection/components/mds-tree-item/antipattern.md +0 -148
  1841. package/dist/collection/components/mds-tree-item/pattern.md +0 -197
  1842. package/dist/collection/components/mds-url-view/antipattern.md +0 -106
  1843. package/dist/collection/components/mds-url-view/pattern.md +0 -105
  1844. package/dist/collection/components/mds-usage/antipattern.md +0 -105
  1845. package/dist/collection/components/mds-usage/pattern.md +0 -131
  1846. package/dist/collection/components/mds-video-wall/antipattern.md +0 -97
  1847. package/dist/collection/components/mds-video-wall/pattern.md +0 -99
  1848. package/dist/collection/components/mds-zero/antipattern.md +0 -106
  1849. package/dist/collection/components/mds-zero/pattern.md +0 -118
  1850. package/dist/components/p-BBO_llcO.js +0 -1
  1851. package/dist/components/p-BM7joOdq.js +0 -1
  1852. package/dist/components/p-BMIaZ4HY.js +0 -1
  1853. package/dist/components/p-BOJQ3tkp.js +0 -1
  1854. package/dist/components/p-BU1O2DcC.js +0 -1
  1855. package/dist/components/p-BeZGLnJJ.js +0 -1
  1856. package/dist/components/p-Bo6ezD1p.js +0 -1
  1857. package/dist/components/p-C0H8bZpf.js +0 -1
  1858. package/dist/components/p-C1YH20BL.js +0 -1
  1859. package/dist/components/p-CEw7GvM-.js +0 -1
  1860. package/dist/components/p-CNUWS_Mg.js +0 -1
  1861. package/dist/components/p-CV7wjM1c.js +0 -1
  1862. package/dist/components/p-CWSIl1jl.js +0 -1
  1863. package/dist/components/p-Chk4rI7N.js +0 -1
  1864. package/dist/components/p-Cwg4vtOr.js +0 -1
  1865. package/dist/components/p-Czqtt8kO.js +0 -1
  1866. package/dist/components/p-DD2muCqG.js +0 -1
  1867. package/dist/components/p-DDTJwlAd.js +0 -1
  1868. package/dist/components/p-DJ401QTd.js +0 -1
  1869. package/dist/components/p-DMyL4CYh.js +0 -1
  1870. package/dist/components/p-DccBbfK8.js +0 -1
  1871. package/dist/components/p-Dzkiu-es.js +0 -1
  1872. package/dist/components/p-H0YXZ5fD.js +0 -8
  1873. package/dist/components/p-IaXq1Xsc.js +0 -1
  1874. package/dist/components/p-M8dGB4KH.js +0 -1
  1875. package/dist/components/p-TNn_HE5x.js +0 -1
  1876. package/dist/components/p-aujz-VM9.js +0 -1
  1877. package/dist/components/p-e9NGNm7d.js +0 -1
  1878. package/dist/components/p-kZBPId_x.js +0 -1
  1879. package/dist/components/p-qnCVkeGX.js +0 -1
  1880. package/dist/magma-components/p-00aa9a51.entry.js +0 -1
  1881. package/dist/magma-components/p-00acb2e1.system.entry.js +0 -10
  1882. package/dist/magma-components/p-037126b7.system.entry.js +0 -21
  1883. package/dist/magma-components/p-03da0376.system.entry.js +0 -1
  1884. package/dist/magma-components/p-05ef91a5.entry.js +0 -1
  1885. package/dist/magma-components/p-09c80fdb.entry.js +0 -1
  1886. package/dist/magma-components/p-0b0ca53c.entry.js +0 -1
  1887. package/dist/magma-components/p-0babf674.system.entry.js +0 -98
  1888. package/dist/magma-components/p-0d90c991.entry.js +0 -1
  1889. package/dist/magma-components/p-103465cf.entry.js +0 -1
  1890. package/dist/magma-components/p-10983da0.entry.js +0 -1
  1891. package/dist/magma-components/p-154ba354.system.entry.js +0 -29
  1892. package/dist/magma-components/p-1685e74c.system.entry.js +0 -33
  1893. package/dist/magma-components/p-1748ca8b.system.entry.js +0 -1
  1894. package/dist/magma-components/p-17a43cb6.system.entry.js +0 -16
  1895. package/dist/magma-components/p-1b415625.system.entry.js +0 -46
  1896. package/dist/magma-components/p-1c00d0f7.entry.js +0 -1
  1897. package/dist/magma-components/p-1cd75adf.system.entry.js +0 -14
  1898. package/dist/magma-components/p-2006cfeb.entry.js +0 -1
  1899. package/dist/magma-components/p-2216f207.system.entry.js +0 -35
  1900. package/dist/magma-components/p-25c07b67.system.entry.js +0 -4
  1901. package/dist/magma-components/p-29fbb7cf.entry.js +0 -1
  1902. package/dist/magma-components/p-2a26b614.entry.js +0 -1
  1903. package/dist/magma-components/p-2a6c2a41.entry.js +0 -1
  1904. package/dist/magma-components/p-2c28056d.entry.js +0 -1
  1905. package/dist/magma-components/p-2c5e5cd1.entry.js +0 -1
  1906. package/dist/magma-components/p-2c7d091e.system.entry.js +0 -14
  1907. package/dist/magma-components/p-2c997b47.entry.js +0 -1
  1908. package/dist/magma-components/p-2f39f4e4.entry.js +0 -1
  1909. package/dist/magma-components/p-31370fdb.system.entry.js +0 -22
  1910. package/dist/magma-components/p-32418266.entry.js +0 -1
  1911. package/dist/magma-components/p-33c80de3.system.entry.js +0 -1
  1912. package/dist/magma-components/p-34c0e63c.system.entry.js +0 -6
  1913. package/dist/magma-components/p-35c6341a.system.entry.js +0 -17
  1914. package/dist/magma-components/p-379f51a6.entry.js +0 -1
  1915. package/dist/magma-components/p-381f49ea.entry.js +0 -1
  1916. package/dist/magma-components/p-384ab014.entry.js +0 -1
  1917. package/dist/magma-components/p-39a2df98.system.entry.js +0 -4
  1918. package/dist/magma-components/p-3a9a75e5.entry.js +0 -1
  1919. package/dist/magma-components/p-3b691cc3.entry.js +0 -1
  1920. package/dist/magma-components/p-3bc65166.system.entry.js +0 -215
  1921. package/dist/magma-components/p-3bdb541f.system.entry.js +0 -46
  1922. package/dist/magma-components/p-3ca004c3.entry.js +0 -1
  1923. package/dist/magma-components/p-3caf6a26.entry.js +0 -1
  1924. package/dist/magma-components/p-3dccd446.entry.js +0 -1
  1925. package/dist/magma-components/p-3dde41b0.system.entry.js +0 -27
  1926. package/dist/magma-components/p-3e8e0003.system.entry.js +0 -7
  1927. package/dist/magma-components/p-425ca155.entry.js +0 -1
  1928. package/dist/magma-components/p-42ab27de.entry.js +0 -1
  1929. package/dist/magma-components/p-430a4c4b.system.entry.js +0 -19
  1930. package/dist/magma-components/p-47b05fa1.system.entry.js +0 -8
  1931. package/dist/magma-components/p-47db3155.entry.js +0 -1
  1932. package/dist/magma-components/p-48f86057.system.entry.js +0 -1
  1933. package/dist/magma-components/p-4aa94380.entry.js +0 -1
  1934. package/dist/magma-components/p-4ab2eb7e.entry.js +0 -1
  1935. package/dist/magma-components/p-4bea91e1.system.entry.js +0 -1
  1936. package/dist/magma-components/p-4de89d1b.entry.js +0 -1
  1937. package/dist/magma-components/p-50c8f36c.system.entry.js +0 -1
  1938. package/dist/magma-components/p-5200ab23.system.entry.js +0 -5
  1939. package/dist/magma-components/p-523f0c30.system.entry.js +0 -80
  1940. package/dist/magma-components/p-5306606b.entry.js +0 -1
  1941. package/dist/magma-components/p-53981624.system.entry.js +0 -13
  1942. package/dist/magma-components/p-53acdc6b.entry.js +0 -1
  1943. package/dist/magma-components/p-5660182a.system.entry.js +0 -1
  1944. package/dist/magma-components/p-56c5ca6f.entry.js +0 -1
  1945. package/dist/magma-components/p-57e92942.system.entry.js +0 -20
  1946. package/dist/magma-components/p-59f06b9c.entry.js +0 -1
  1947. package/dist/magma-components/p-5aa78075.system.entry.js +0 -111
  1948. package/dist/magma-components/p-5cf87a7f.entry.js +0 -1
  1949. package/dist/magma-components/p-5e8df58d.entry.js +0 -1
  1950. package/dist/magma-components/p-5ed74216.system.entry.js +0 -1
  1951. package/dist/magma-components/p-5f064376.system.entry.js +0 -7
  1952. package/dist/magma-components/p-60727165.entry.js +0 -8
  1953. package/dist/magma-components/p-6093aa8e.entry.js +0 -1
  1954. package/dist/magma-components/p-62d9eaca.entry.js +0 -1
  1955. package/dist/magma-components/p-6b402a09.system.entry.js +0 -73
  1956. package/dist/magma-components/p-6b55c5fe.system.entry.js +0 -1
  1957. package/dist/magma-components/p-6d57674c.system.entry.js +0 -52
  1958. package/dist/magma-components/p-6df7da52.system.entry.js +0 -24
  1959. package/dist/magma-components/p-6e751bcc.system.entry.js +0 -7
  1960. package/dist/magma-components/p-718d6384.system.entry.js +0 -34
  1961. package/dist/magma-components/p-71dab494.system.entry.js +0 -40
  1962. package/dist/magma-components/p-732d09b6.entry.js +0 -1
  1963. package/dist/magma-components/p-73f4f67e.entry.js +0 -1
  1964. package/dist/magma-components/p-785fa112.entry.js +0 -1
  1965. package/dist/magma-components/p-798f460b.system.entry.js +0 -31
  1966. package/dist/magma-components/p-7acbc6ea.system.entry.js +0 -45
  1967. package/dist/magma-components/p-7db14777.system.entry.js +0 -32
  1968. package/dist/magma-components/p-7dd0364b.entry.js +0 -1
  1969. package/dist/magma-components/p-7ec28ff1.system.entry.js +0 -48
  1970. package/dist/magma-components/p-7f74ec99.entry.js +0 -1
  1971. package/dist/magma-components/p-7ffce9e8.system.entry.js +0 -22
  1972. package/dist/magma-components/p-8219e58f.system.entry.js +0 -9
  1973. package/dist/magma-components/p-84711ab6.system.entry.js +0 -11
  1974. package/dist/magma-components/p-84bf333b.entry.js +0 -1
  1975. package/dist/magma-components/p-857ae762.entry.js +0 -1
  1976. package/dist/magma-components/p-8641b7b2.entry.js +0 -1
  1977. package/dist/magma-components/p-87395a4d.system.entry.js +0 -35
  1978. package/dist/magma-components/p-896310aa.system.entry.js +0 -5
  1979. package/dist/magma-components/p-8d7093af.entry.js +0 -1
  1980. package/dist/magma-components/p-8e15c151.system.entry.js +0 -1
  1981. package/dist/magma-components/p-8f1c529f.entry.js +0 -1
  1982. package/dist/magma-components/p-8f1e9021.system.entry.js +0 -91
  1983. package/dist/magma-components/p-904c1222.entry.js +0 -1
  1984. package/dist/magma-components/p-907f06cd.system.entry.js +0 -105
  1985. package/dist/magma-components/p-9332358d.entry.js +0 -1
  1986. package/dist/magma-components/p-93b9d39d.system.entry.js +0 -19
  1987. package/dist/magma-components/p-95ccf46d.system.entry.js +0 -54
  1988. package/dist/magma-components/p-965e7a82.system.entry.js +0 -15
  1989. package/dist/magma-components/p-968a2237.entry.js +0 -1
  1990. package/dist/magma-components/p-96dfb60e.system.entry.js +0 -1
  1991. package/dist/magma-components/p-9c408768.system.entry.js +0 -1
  1992. package/dist/magma-components/p-9dd9eadd.entry.js +0 -1
  1993. package/dist/magma-components/p-9e792bed.system.entry.js +0 -1
  1994. package/dist/magma-components/p-9fdd477a.entry.js +0 -1
  1995. package/dist/magma-components/p-9fefa077.system.entry.js +0 -1
  1996. package/dist/magma-components/p-a0d637b6.system.entry.js +0 -17
  1997. package/dist/magma-components/p-a25327a1.entry.js +0 -18
  1998. package/dist/magma-components/p-a26c05b6.entry.js +0 -1
  1999. package/dist/magma-components/p-a67381bf.entry.js +0 -1
  2000. package/dist/magma-components/p-a7baf451.system.entry.js +0 -7
  2001. package/dist/magma-components/p-ac9feb04.entry.js +0 -1
  2002. package/dist/magma-components/p-ad383f92.entry.js +0 -1
  2003. package/dist/magma-components/p-ae4736a0.system.entry.js +0 -55
  2004. package/dist/magma-components/p-b27cb1ac.system.entry.js +0 -975
  2005. package/dist/magma-components/p-b3332c5f.entry.js +0 -1
  2006. package/dist/magma-components/p-b3e2b68a.system.entry.js +0 -10
  2007. package/dist/magma-components/p-b86144d4.entry.js +0 -1
  2008. package/dist/magma-components/p-bbde5701.system.entry.js +0 -13
  2009. package/dist/magma-components/p-bc075b3b.system.entry.js +0 -22
  2010. package/dist/magma-components/p-bc19b136.entry.js +0 -1
  2011. package/dist/magma-components/p-bcca26d9.entry.js +0 -1
  2012. package/dist/magma-components/p-bf35627d.entry.js +0 -1
  2013. package/dist/magma-components/p-c086a5a4.system.entry.js +0 -23
  2014. package/dist/magma-components/p-c27206ca.entry.js +0 -1
  2015. package/dist/magma-components/p-c4a5ab6e.system.entry.js +0 -23
  2016. package/dist/magma-components/p-c58157cf.entry.js +0 -1
  2017. package/dist/magma-components/p-c597ad47.entry.js +0 -1
  2018. package/dist/magma-components/p-c7b2ebb5.entry.js +0 -1
  2019. package/dist/magma-components/p-c89060ec.system.entry.js +0 -41
  2020. package/dist/magma-components/p-c8b06821.system.entry.js +0 -12
  2021. package/dist/magma-components/p-ca1143bc.entry.js +0 -1
  2022. package/dist/magma-components/p-cb88fa71.entry.js +0 -1
  2023. package/dist/magma-components/p-cd783f9e.system.entry.js +0 -27
  2024. package/dist/magma-components/p-cd955bc7.system.entry.js +0 -16
  2025. package/dist/magma-components/p-ce42e251.entry.js +0 -1
  2026. package/dist/magma-components/p-cf4f4561.entry.js +0 -1
  2027. package/dist/magma-components/p-d0a15a3a.system.entry.js +0 -82
  2028. package/dist/magma-components/p-d218ae47.entry.js +0 -1
  2029. package/dist/magma-components/p-d331ff5c.entry.js +0 -1
  2030. package/dist/magma-components/p-d3844c9a.system.entry.js +0 -25
  2031. package/dist/magma-components/p-d3ac9a1a.entry.js +0 -1
  2032. package/dist/magma-components/p-d4c3250f.system.entry.js +0 -47
  2033. package/dist/magma-components/p-d638bbb0.entry.js +0 -1
  2034. package/dist/magma-components/p-d65e9f0a.system.entry.js +0 -10
  2035. package/dist/magma-components/p-d87ecd68.entry.js +0 -1
  2036. package/dist/magma-components/p-d93b48b4.system.entry.js +0 -4
  2037. package/dist/magma-components/p-d94281cb.entry.js +0 -1
  2038. package/dist/magma-components/p-d9f92ff8.entry.js +0 -1
  2039. package/dist/magma-components/p-da9bc02a.entry.js +0 -1
  2040. package/dist/magma-components/p-dc618cae.entry.js +0 -1
  2041. package/dist/magma-components/p-de38f745.entry.js +0 -1
  2042. package/dist/magma-components/p-dee123c7.system.entry.js +0 -39
  2043. package/dist/magma-components/p-e30d0684.system.entry.js +0 -16
  2044. package/dist/magma-components/p-e371f9e1.system.entry.js +0 -5
  2045. package/dist/magma-components/p-e3d262d9.system.entry.js +0 -13
  2046. package/dist/magma-components/p-e54587e7.system.entry.js +0 -49
  2047. package/dist/magma-components/p-e709a52e.system.entry.js +0 -25
  2048. package/dist/magma-components/p-ea503851.entry.js +0 -1
  2049. package/dist/magma-components/p-eb12be86.system.entry.js +0 -24
  2050. package/dist/magma-components/p-ebeb3fff.entry.js +0 -1
  2051. package/dist/magma-components/p-ec44a4ea.system.entry.js +0 -77
  2052. package/dist/magma-components/p-ed133270.entry.js +0 -1
  2053. package/dist/magma-components/p-ef4ee9ca.entry.js +0 -1
  2054. package/dist/magma-components/p-f267ff68.entry.js +0 -1
  2055. package/dist/magma-components/p-f27de6cb.system.entry.js +0 -26
  2056. package/dist/magma-components/p-f2ef884c.entry.js +0 -1
  2057. package/dist/magma-components/p-f3f88f32.entry.js +0 -1
  2058. package/dist/magma-components/p-f4181b35.entry.js +0 -1
  2059. package/dist/magma-components/p-f4351160.entry.js +0 -1
  2060. package/dist/magma-components/p-f5c7b147.system.entry.js +0 -17
  2061. package/dist/magma-components/p-f7d5445c.system.entry.js +0 -7
  2062. package/dist/magma-components/p-f8c85ad7.system.entry.js +0 -1
  2063. package/dist/magma-components/p-f9b601de.entry.js +0 -1
  2064. package/dist/magma-components/p-fa44d0d2.entry.js +0 -1
  2065. package/dist/magma-components/p-fe8e3721.system.entry.js +0 -225
  2066. package/dist/magma-components/p-fe98a77e.system.entry.js +0 -13
  2067. package/dist/magma-components/p-ff7fc1f6.system.entry.js +0 -3
@@ -0,0 +1,103 @@
1
+ <!--
2
+ GENERATED FILE - do not edit by hand.
3
+ Source of truth: src/components/mds-pref-mode/usage/ in the magma monorepo.
4
+ -->
5
+
6
+ # mds-pref-mode - mistakes
7
+
8
+ > The API of this component: [`AGENTS.md`](AGENTS.md).
9
+
10
+ Common incorrect uses of `<mds-pref-mode>`. 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.
11
+
12
+ #### Do Not Use `<mds-pref-mode>` Outside `<mds-pref>`
13
+
14
+ `<mds-pref-mode>` is a compound child: `<mds-pref>` forwards `size` changes to it and locks the mode item that a scheme-constrained `<mds-pref-theme>` forbids (it sets `lockedScheme`). As a standalone widget it still applies and persists the mode, but nothing coordinates it with the theme.
15
+
16
+ ```html
17
+ <!-- INCORRECT -->
18
+ <mds-pref-mode></mds-pref-mode>
19
+
20
+ <!-- CORRECT -->
21
+ <mds-pref>
22
+ <mds-pref-mode></mds-pref-mode>
23
+ </mds-pref>
24
+ ```
25
+
26
+ #### Do Not Set `transition="false"` to Disable the Overlay
27
+
28
+ `transition` is a string enum, not a boolean. `"false"` is not a valid value: it only happens to fall through to the no-overlay branch, with no guarantee across releases. Use `transition="none"` to opt out of the overlay animation.
29
+
30
+ ```html
31
+ <!-- INCORRECT -->
32
+ <mds-pref-mode transition="false"></mds-pref-mode>
33
+
34
+ <!-- CORRECT -->
35
+ <mds-pref-mode transition="none"></mds-pref-mode>
36
+ ```
37
+
38
+ #### Do Not Listen for Native `change` Events Instead of `mdsPrefChange`
39
+
40
+ The component does not emit or bubble native `change` events out of the shadow DOM. Always listen for the documented `mdsPrefChange` custom event.
41
+
42
+ ```html
43
+ <!-- INCORRECT -->
44
+ <script>
45
+ document.querySelector('mds-pref-mode').addEventListener('change', handler);
46
+ </script>
47
+
48
+ <!-- CORRECT -->
49
+ <script>
50
+ document.querySelector('mds-pref-mode').addEventListener('mdsPrefChange', handler);
51
+ </script>
52
+ ```
53
+
54
+ #### Do Not Override Mode Classes on `<html>` Directly
55
+
56
+ The component manages `pref-mode-light`, `pref-mode-dark`, and `pref-mode-system` classes on `<html>` itself. Adding or removing these by hand races with the component and will be overwritten on the next mode change. Drive the mode exclusively through the `mode` prop.
57
+
58
+ ```html
59
+ <!-- INCORRECT -->
60
+ <script>
61
+ document.documentElement.classList.add('pref-mode-dark');
62
+ </script>
63
+
64
+ <!-- CORRECT -->
65
+ <mds-pref>
66
+ <mds-pref-mode mode="dark"></mds-pref-mode>
67
+ </mds-pref>
68
+ ```
69
+
70
+ #### Do Not Size Only One Child of the Panel
71
+
72
+ Setting `size` on `<mds-pref-mode>` alone when siblings exist produces inconsistent tab sizes across the panel. Set it on `<mds-pref>`, which forwards it to every preference child, on load and when it changes.
73
+
74
+ ```html
75
+ <!-- INCORRECT -->
76
+ <mds-pref>
77
+ <mds-pref-mode size="sm"></mds-pref-mode>
78
+ <mds-pref-contrast></mds-pref-contrast>
79
+ </mds-pref>
80
+
81
+ <!-- CORRECT -->
82
+ <mds-pref size="sm">
83
+ <mds-pref-mode></mds-pref-mode>
84
+ <mds-pref-contrast></mds-pref-contrast>
85
+ </mds-pref>
86
+ ```
87
+
88
+ #### Do Not Target the Injected Overlay to Customize It
89
+
90
+ The overlay element is injected into `document.body` at runtime with inline styles, which win over a class selector anyway. Do not target it by class name or adjust its properties through JavaScript. Use the public `--mds-pref-mode-overlay-z-index` CSS custom property instead.
91
+
92
+ ```css
93
+ /* INCORRECT */
94
+ .mds-pref-mode-overlay {
95
+ background-color: black;
96
+ z-index: 99999;
97
+ }
98
+
99
+ /* CORRECT */
100
+ mds-pref-mode {
101
+ --mds-pref-mode-overlay-z-index: 9000;
102
+ }
103
+ ```
@@ -6,13 +6,13 @@
6
6
 
7
7
  # mds-pref-theme
8
8
 
9
- > `@maggioli-design-system/magma` 2.9.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
9
+ > `@maggioli-design-system/magma` 2.11.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
10
10
 
11
11
  The `<mds-pref-theme>` web component is the theme-switcher segment of the Magma accessibility preferences panel, usually a direct child of [`<mds-pref>`](../mds-pref/AGENTS.md). It renders a labelled tab trigger that opens a dropdown of selectable named themes and, when a theme is chosen, applies it globally to the document.
12
12
 
13
13
  #### Semantic Behavior
14
14
 
15
- - **Usually inside `<mds-pref>`**: Placed as a direct slot child of `<mds-pref>`, alongside the other `mds-pref-*` controls; it also works on its own, since it applies and stores the theme by itself. What it gives up on its own is in the antipattern docs.
15
+ - **Usually inside `<mds-pref>`**: Placed as a direct slot child of `<mds-pref>`, alongside the other `mds-pref-*` controls; it also works on its own, since it applies and stores the theme by itself. What it gives up on its own is in its mistakes.
16
16
  - **Acts as a sub-parent itself**: Its own default slot must contain one or more `mds-pref-theme-item` elements; it drives their selected state so only the active theme is marked selected.
17
17
  - **Global theme application**: Selecting an item applies the theme document-wide: it writes `data-theme-name` and the `pref-theme-scheme-*` class on `<html>`.
18
18
  - **Persistence and hydration**: The current name, scheme and corner shape are persisted and restored across reloads: a stored value outranks the matching prop.
@@ -24,17 +24,17 @@ The `<mds-pref-theme>` web component is the theme-switcher segment of the Magma
24
24
 
25
25
  #### Properties & Visual Configurations
26
26
 
27
- - **`name`**: The active theme name (default `'default'`); it is overridden at runtime by any persisted value. Use it to declare the initial theme when no preference has been stored yet. The named themes are `cool` and `warm`; `default` is the base theme ([`agents/theming.md`](../../../../agents/theming.md)).
27
+ - **`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.
28
28
  - **`scheme`**: Constrains the colour modes of the theme to `'light'`, `'dark'`, or `'all'` (default). Pick `'all'` for themes that ship both light and dark palettes; pick `'light'` or `'dark'` to force a single mode for a theme offered in one mode only.
29
29
  - **`size`**: Sets the size (`'sm'` / `'md'`) of the nested tab UI. Inside `<mds-pref>`, set it on the parent: it reaches every `mds-pref-*` segment on load and when it changes, and overwrites the segment's own.
30
30
  - **`cornerShape`** (attribute `corner-shape`): The corner geometry of the whole page - `round`, `squircle`, `bevel`, `notch`, `scoop`, `square`, or `default`. It writes `data-corner-shape` on `<html>` and is persisted like the theme; `default` removes the attribute, and leaving the prop unset touches nothing ([`agents/theming.md`](../../../../agents/theming.md)).
31
31
 
32
32
  ## Read next
33
33
 
34
- - [`pattern.md`](pattern.md) - correct usage, with examples
35
- - [`antipattern.md`](antipattern.md) - mistakes to avoid
34
+ - [`examples.md`](examples.md) - correct usage, from the most common case
35
+ - [`mistakes.md`](mistakes.md) - the wrong forms, each with the right one
36
36
  - [Storybook](https://magma-design-system.github.io/magma/storybook/?path=/docs/ui-preferences-theme--docs) - the live examples, in the published Storybook of `main`
37
- - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`anti-patterns.md`](../../../../agents/anti-patterns.md) - the rules shared by every component
37
+ - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`mistakes.md`](../../../../agents/mistakes.md) - the rules shared by every component
38
38
 
39
39
  ## Props
40
40
 
@@ -1,5 +1,5 @@
1
1
  {
2
- "timestamp": "2026-10-27T10:28:31",
2
+ "timestamp": "2026-11-04T15:13:27",
3
3
  "compiler": {
4
4
  "name": "@stencil/core",
5
5
  "version": "4.45.2",
@@ -23,9 +23,9 @@
23
23
  }
24
24
  ],
25
25
  "usage": {
26
- "1. Description": "The `<mds-pref-theme>` web component is the theme-switcher segment of the Magma accessibility preferences panel, usually a direct child of [`<mds-pref>`](../mds-pref/AGENTS.md). It renders a labelled tab trigger that opens a dropdown of selectable named themes and, when a theme is chosen, applies it globally to the document.\n\n#### Semantic Behavior\n\n- **Usually inside `<mds-pref>`**: Placed as a direct slot child of `<mds-pref>`, alongside the other `mds-pref-*` controls; it also works on its own, since it applies and stores the theme by itself. What it gives up on its own is in the antipattern docs.\n- **Acts as a sub-parent itself**: Its own default slot must contain one or more `mds-pref-theme-item` elements; it drives their selected state so only the active theme is marked selected.\n- **Global theme application**: Selecting an item applies the theme document-wide: it writes `data-theme-name` and the `pref-theme-scheme-*` class on `<html>`.\n- **Persistence and hydration**: The current name, scheme and corner shape are persisted and restored across reloads: a stored value outranks the matching prop.\n- **Validation**: An invalid theme name (not lowercase kebab-case matching `^[a-z]+(-[a-z]+)*$`) is ignored with a console warning when the theme is applied: nothing is written on `<html>` or stored. So are the reserved names `light`, `dark` and `system` (they are mode values) and `scheme` or `scheme-*` (they would collide with the `pref-theme-scheme-*` classes), a `scheme` other than `light`, `dark` or `all`, and a `corner-shape` outside its keywords. A stored value the component cannot apply is dropped, and the prop is used instead.\n- **Events bubbled up**: Emits `mdsPrefThemeChange` with the `{ name, scheme }` detail on each pick, which `<mds-pref>` listens to in order to lock the `<mds-pref-mode>` item a scheme-constrained theme forbids. It also emits `mdsPrefChange` once per change, after applying it: `preference: 'theme'` for a new name or scheme, `'corner-shape'` for a new corner shape. The first application on load and a re-render that changes nothing do not emit it.\n- **Props set after load**: A `name`, `scheme` or `cornerShape` set from a script after load is stored and applied, as a pick is: the stored value outranks the prop only on load. A value the component would not apply is not stored.\n- **Localized label**: The \"Theme\" heading follows the active interface language.\n- **Trigger text**: The closed control shows the `label` of the item for the active theme, the same text the open list shows (localize the items, the trigger follows); when no item matches the active theme it shows the label derived from the name (`dark-blue` -> \"Dark blue\").\n\n#### Properties & Visual Configurations\n\n- **`name`**: The active theme name (default `'default'`); it is overridden at runtime by any persisted value. Use it to declare the initial theme when no preference has been stored yet. The named themes are `cool` and `warm`; `default` is the base theme ([`agents/theming.md`](../../../../agents/theming.md)).\n- **`scheme`**: Constrains the colour modes of the theme to `'light'`, `'dark'`, or `'all'` (default). Pick `'all'` for themes that ship both light and dark palettes; pick `'light'` or `'dark'` to force a single mode for a theme offered in one mode only.\n- **`size`**: Sets the size (`'sm'` / `'md'`) of the nested tab UI. Inside `<mds-pref>`, set it on the parent: it reaches every `mds-pref-*` segment on load and when it changes, and overwrites the segment's own.\n- **`cornerShape`** (attribute `corner-shape`): The corner geometry of the whole page - `round`, `squircle`, `bevel`, `notch`, `scoop`, `square`, or `default`. It writes `data-corner-shape` on `<html>` and is persisted like the theme; `default` removes the attribute, and leaving the prop unset touches nothing ([`agents/theming.md`](../../../../agents/theming.md)).\n",
27
- "2. Pattern": "Correct and idiomatic ways to use the `<mds-pref-theme>` component, ordered from most common to most specialized. Patterns assume a working knowledge of the preferences system documented in [`agents/theming.md`](../../../../agents/theming.md) and the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Basic Theme Chooser\n\nThe canonical form. Place `<mds-pref-theme>` inside [`<mds-pref>`](../mds-pref/AGENTS.md) and populate its default slot with one [`<mds-pref-theme-item>`](../mds-pref-theme-item/AGENTS.md) per available theme. The item whose `name` matches the active theme (the stored choice, or the parent's `name` on a first visit) starts as selected. The named themes are `cool` and `warm`; `default` is the base theme.\n\n```html\n<mds-pref>\n <mds-pref-theme name=\"default\" scheme=\"all\">\n <mds-pref-theme-item label=\"Predefinito\" name=\"default\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item label=\"Freddo\" name=\"cool\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item label=\"Caldo\" name=\"warm\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n```\n\n#### Scheme-Constrained Themes\n\nUse `scheme=\"light\"` or `scheme=\"dark\"` on a `<mds-pref-theme-item>` when the theme must be offered in one colour mode only. The parent component propagates the chosen scheme to `<html>` and forces that mode even if the user's OS or mode preference asks for the opposite; inside `<mds-pref>` the forbidden item of `<mds-pref-mode>` is locked.\n\n```html\n<mds-pref>\n <mds-pref-theme name=\"default\" scheme=\"all\">\n <mds-pref-theme-item label=\"Predefinito\" name=\"default\" scheme=\"all\"></mds-pref-theme-item>\n <!-- light only - dark mode will not activate with this item -->\n <mds-pref-theme-item label=\"Freddo chiaro\" name=\"cool\" scheme=\"light\"></mds-pref-theme-item>\n <!-- dark only -->\n <mds-pref-theme-item label=\"Caldo scuro\" name=\"warm\" scheme=\"dark\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n```\n\n#### Listening for the Change Event\n\nReact to the user's selection via `mdsPrefThemeChange`. The event detail carries `{ name, scheme }` - use them to update any app-level state that tracks the active theme.\n\n```html\n<mds-pref>\n <mds-pref-theme id=\"theme-chooser\" name=\"default\" scheme=\"all\">\n <mds-pref-theme-item label=\"Predefinito\" name=\"default\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item label=\"Freddo\" name=\"cool\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n\n<script>\n document.querySelector('#theme-chooser').addEventListener('mdsPrefThemeChange', (e) => {\n console.log('Tema attivo:', e.detail.name, '- Schema:', e.detail.scheme);\n });\n</script>\n```\n\n#### Declaring the Initial Theme\n\nUse the `name` prop to declare which theme should be active before the user makes a selection. If `localStorage` already holds a persisted value it takes precedence; otherwise the component applies `name` on first render.\n\n```html\n<mds-pref>\n <!-- First-visit default is \"warm\" -->\n <mds-pref-theme name=\"warm\" scheme=\"all\">\n <mds-pref-theme-item label=\"Predefinito\" name=\"default\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item label=\"Caldo\" name=\"warm\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n```\n\n#### Controlling Item Size\n\nPass `size=\"sm\"` when the preferences panel must fit a compact layout: on `<mds-pref>`, which forwards it to every preference control.\n\n```html\n<mds-pref size=\"sm\">\n <mds-pref-theme name=\"default\" scheme=\"all\">\n <mds-pref-theme-item label=\"Predefinito\" name=\"default\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item label=\"Freddo\" name=\"cool\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n```\n\n#### Styling Theme Items\n\nStyle theme items only through their public `--mds-pref-theme-item-*` CSS custom properties. Set them on the item host or on a parent selector; name a semantic role, `rgb(var(--magma-<role>))` ([`agents/color.md`](../../../../agents/color.md)), so the colours follow the mode, the theme and the contrast preference.\n\n```css\nmds-pref-theme-item {\n --mds-pref-theme-item-color-background: rgb(var(--magma-surface-inverse));\n}\n```\n",
28
- "3. Antipattern": "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/anti-patterns.md`](../../../../agents/anti-patterns.md) - they apply here too but are not repeated.\n\n#### Do Not Use the Component Outside `<mds-pref>`\n\n`<mds-pref-theme>` is a compound sub-part designed to slot inside [`<mds-pref>`](../mds-pref/AGENTS.md). As a standalone widget it still applies and persists the theme, but it leaves the panel: `<mds-pref>` can no longer forward `size` changes to it, nor lock the `<mds-pref-mode>` item that its `scheme` forbids.\n\n```html\n<!-- INCORRECT -->\n<mds-pref-theme name=\"default\" scheme=\"all\">\n <mds-pref-theme-item label=\"Predefinito\" name=\"default\" scheme=\"all\"></mds-pref-theme-item>\n</mds-pref-theme>\n\n<!-- CORRECT -->\n<mds-pref>\n <mds-pref-theme name=\"default\" scheme=\"all\">\n <mds-pref-theme-item label=\"Predefinito\" name=\"default\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n```\n\n#### Do Not Put Plain Text or Arbitrary HTML in the Default Slot\n\nThe default slot is reserved exclusively for `<mds-pref-theme-item>` elements. Any other content bypasses the component's internal selection management and will not trigger theme application.\n\n```html\n<!-- INCORRECT -->\n<mds-pref>\n <mds-pref-theme name=\"default\" scheme=\"all\">\n <button>Predefinito</button>\n <span>Estate</span>\n </mds-pref-theme>\n</mds-pref>\n\n<!-- CORRECT -->\n<mds-pref>\n <mds-pref-theme name=\"default\" scheme=\"all\">\n <mds-pref-theme-item label=\"Predefinito\" name=\"default\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item label=\"Freddo\" name=\"cool\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n```\n\n#### Do Not Use an Invalid Theme Name\n\nThe `name` prop must match the pattern `^[a-z]+(-[a-z]+)*$` (lowercase letters and hyphens only). Any other value - including uppercase, underscores, or spaces - is ignored with a console warning when the component tries to apply the theme on `<html>`: the theme is neither applied nor stored.\n\n```html\n<!-- INCORRECT -->\n<mds-pref-theme name=\"My Theme\" scheme=\"all\">...</mds-pref-theme>\n<mds-pref-theme name=\"my_theme\" scheme=\"all\">...</mds-pref-theme>\n<mds-pref-theme name=\"MyTheme\" scheme=\"all\">...</mds-pref-theme>\n\n<!-- CORRECT -->\n<mds-pref-theme name=\"warm\" scheme=\"all\">...</mds-pref-theme>\n```\n\n#### Do Not Listen for the Native `change` Event\n\n`<mds-pref-theme>` emits `mdsPrefThemeChange` - a documented custom event with a typed `{ name, scheme }` detail. Listening for the native `change` event will not fire because theme selection is handled entirely inside shadow DOM.\n\n```html\n<!-- INCORRECT -->\n<script>\n document.querySelector('mds-pref-theme').addEventListener('change', (e) => {\n console.log(e.target.value); // undefined - wrong event, wrong detail shape\n });\n</script>\n\n<!-- CORRECT -->\n<script>\n document.querySelector('mds-pref-theme').addEventListener('mdsPrefThemeChange', (e) => {\n console.log(e.detail.name, e.detail.scheme);\n });\n</script>\n```\n\n#### Do Not Give the Parent and the Child Different Sizes\n\n`<mds-pref>` forwards its own `size` to all `mds-pref-*` children, on load and when it changes, and overwrites theirs: a `size` on `<mds-pref-theme>` that differs from the parent's is never shown. Set the size on the parent only.\n\n```html\n<!-- INCORRECT -->\n<mds-pref size=\"sm\">\n <mds-pref-theme size=\"md\" name=\"default\" scheme=\"all\">\n <mds-pref-theme-item label=\"Predefinito\" name=\"default\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n\n<!-- CORRECT -->\n<mds-pref size=\"sm\">\n <mds-pref-theme name=\"default\" scheme=\"all\">\n <mds-pref-theme-item label=\"Predefinito\" name=\"default\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n```\n"
26
+ "1. Description": "The `<mds-pref-theme>` web component is the theme-switcher segment of the Magma accessibility preferences panel, usually a direct child of [`<mds-pref>`](../mds-pref/AGENTS.md). It renders a labelled tab trigger that opens a dropdown of selectable named themes and, when a theme is chosen, applies it globally to the document.\n\n#### Semantic Behavior\n\n- **Usually inside `<mds-pref>`**: Placed as a direct slot child of `<mds-pref>`, alongside the other `mds-pref-*` controls; it also works on its own, since it applies and stores the theme by itself. What it gives up on its own is in its mistakes.\n- **Acts as a sub-parent itself**: Its own default slot must contain one or more `mds-pref-theme-item` elements; it drives their selected state so only the active theme is marked selected.\n- **Global theme application**: Selecting an item applies the theme document-wide: it writes `data-theme-name` and the `pref-theme-scheme-*` class on `<html>`.\n- **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",
27
+ "2. Examples": "Correct and idiomatic ways to use the `<mds-pref-theme>` component, ordered from most common to most specialized. The examples assume a working knowledge of the preferences system documented in [`agents/theming.md`](../../../../agents/theming.md) and the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Basic Theme Chooser\n\nThe canonical form. Place `<mds-pref-theme>` inside [`<mds-pref>`](../mds-pref/AGENTS.md) and populate its default slot with one [`<mds-pref-theme-item>`](../mds-pref-theme-item/AGENTS.md) per available theme. The item whose `name` matches the active theme (the stored choice, or the parent's `name` on a first visit) starts as selected. The named themes are `business`, the base theme of the management software, and `editorial`, the theme of the publishing side.\n\n```html\n<mds-pref>\n <mds-pref-theme name=\"business\" scheme=\"all\">\n <mds-pref-theme-item label=\"Gestionale\" name=\"business\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item label=\"Editoriale\" name=\"editorial\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n```\n\n#### Scheme-Constrained Themes\n\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",
28
+ "3. Mistakes": "Common incorrect uses of `<mds-pref-theme>`. Each entry pairs the wrong form with the right one and a one-line reason. System-wide rules (boolean-as-string, shadow piercing, Tailwind colour utilities, raw native event listening) live in [`agents/mistakes.md`](../../../../agents/mistakes.md) - they apply here too but are not repeated.\n\n#### Do Not Use the Component Outside `<mds-pref>`\n\n`<mds-pref-theme>` is a compound sub-part designed to slot inside [`<mds-pref>`](../mds-pref/AGENTS.md). As a standalone widget it still applies and persists the theme, but it leaves the panel: `<mds-pref>` can no longer forward `size` changes to it, nor lock the `<mds-pref-mode>` item that its `scheme` forbids.\n\n```html\n<!-- INCORRECT -->\n<mds-pref-theme name=\"business\" scheme=\"all\">\n <mds-pref-theme-item label=\"Gestionale\" name=\"business\" scheme=\"all\"></mds-pref-theme-item>\n</mds-pref-theme>\n\n<!-- CORRECT -->\n<mds-pref>\n <mds-pref-theme name=\"business\" scheme=\"all\">\n <mds-pref-theme-item label=\"Gestionale\" name=\"business\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n```\n\n#### Do Not Put Plain Text or Arbitrary HTML in the Default Slot\n\nThe default slot is reserved exclusively for `<mds-pref-theme-item>` elements. Any other content bypasses the component's internal selection management and will not trigger theme application.\n\n```html\n<!-- INCORRECT -->\n<mds-pref>\n <mds-pref-theme name=\"business\" scheme=\"all\">\n <button>Gestionale</button>\n <span>Editoriale</span>\n </mds-pref-theme>\n</mds-pref>\n\n<!-- CORRECT -->\n<mds-pref>\n <mds-pref-theme name=\"business\" scheme=\"all\">\n <mds-pref-theme-item label=\"Gestionale\" name=\"business\" scheme=\"all\"></mds-pref-theme-item>\n <mds-pref-theme-item label=\"Editoriale\" name=\"editorial\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n```\n\n#### Do Not Use an Invalid Theme Name\n\nThe `name` prop must match the pattern `^[a-z]+(-[a-z]+)*$` (lowercase letters and hyphens only). Any other value - including uppercase, underscores, or spaces - is ignored with a console warning when the component tries to apply the theme on `<html>`: the theme is neither applied nor stored.\n\n```html\n<!-- INCORRECT -->\n<mds-pref-theme name=\"My Theme\" scheme=\"all\">...</mds-pref-theme>\n<mds-pref-theme name=\"my_theme\" scheme=\"all\">...</mds-pref-theme>\n<mds-pref-theme name=\"MyTheme\" scheme=\"all\">...</mds-pref-theme>\n\n<!-- CORRECT -->\n<mds-pref-theme name=\"editorial\" scheme=\"all\">...</mds-pref-theme>\n```\n\n#### Do Not Listen for the Native `change` Event\n\n`<mds-pref-theme>` emits `mdsPrefThemeChange` - a documented custom event with a typed `{ name, scheme }` detail. Listening for the native `change` event will not fire because theme selection is handled entirely inside shadow DOM.\n\n```html\n<!-- INCORRECT -->\n<script>\n document.querySelector('mds-pref-theme').addEventListener('change', (e) => {\n console.log(e.target.value); // undefined - wrong event, wrong detail shape\n });\n</script>\n\n<!-- CORRECT -->\n<script>\n document.querySelector('mds-pref-theme').addEventListener('mdsPrefThemeChange', (e) => {\n console.log(e.detail.name, e.detail.scheme);\n });\n</script>\n```\n\n#### Do Not Give the Parent and the Child Different Sizes\n\n`<mds-pref>` forwards its own `size` to all `mds-pref-*` children, on load and when it changes, and overwrites theirs: a `size` on `<mds-pref-theme>` that differs from the parent's is never shown. Set the size on the parent only.\n\n```html\n<!-- INCORRECT -->\n<mds-pref size=\"sm\">\n <mds-pref-theme size=\"md\" name=\"default\" scheme=\"all\">\n <mds-pref-theme-item label=\"Gestionale\" name=\"business\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n\n<!-- CORRECT -->\n<mds-pref size=\"sm\">\n <mds-pref-theme name=\"business\" scheme=\"all\">\n <mds-pref-theme-item label=\"Gestionale\" name=\"business\" scheme=\"all\"></mds-pref-theme-item>\n </mds-pref-theme>\n</mds-pref>\n```\n"
29
29
  },
30
30
  "props": [
31
31
  {
@@ -0,0 +1,93 @@
1
+ <!--
2
+ GENERATED FILE - do not edit by hand.
3
+ Source of truth: src/components/mds-pref-theme/usage/ in the magma monorepo.
4
+ -->
5
+
6
+ # mds-pref-theme - examples
7
+
8
+ > The API of this component: [`AGENTS.md`](AGENTS.md).
9
+
10
+ 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).
11
+
12
+ #### Basic Theme Chooser
13
+
14
+ The canonical form. Place `<mds-pref-theme>` inside [`<mds-pref>`](../mds-pref/AGENTS.md) and populate its default slot with one [`<mds-pref-theme-item>`](../mds-pref-theme-item/AGENTS.md) per available theme. The item whose `name` matches the active theme (the stored choice, or the parent's `name` on a first visit) starts as selected. The named themes are `business`, the base theme of the management software, and `editorial`, the theme of the publishing side.
15
+
16
+ ```html
17
+ <mds-pref>
18
+ <mds-pref-theme name="business" scheme="all">
19
+ <mds-pref-theme-item label="Gestionale" name="business" scheme="all"></mds-pref-theme-item>
20
+ <mds-pref-theme-item label="Editoriale" name="editorial" scheme="all"></mds-pref-theme-item>
21
+ </mds-pref-theme>
22
+ </mds-pref>
23
+ ```
24
+
25
+ #### Scheme-Constrained Themes
26
+
27
+ Use `scheme="light"` or `scheme="dark"` on a `<mds-pref-theme-item>` when the theme must be offered in one colour mode only. The parent component propagates the chosen scheme to `<html>` and forces that mode even if the user's OS or mode preference asks for the opposite; inside `<mds-pref>` the forbidden item of `<mds-pref-mode>` is locked.
28
+
29
+ ```html
30
+ <mds-pref>
31
+ <mds-pref-theme name="business" scheme="all">
32
+ <mds-pref-theme-item label="Gestionale" name="business" scheme="all"></mds-pref-theme-item>
33
+ <!-- light only - dark mode will not activate with this item -->
34
+ <mds-pref-theme-item label="Editoriale chiaro" name="editorial" scheme="light"></mds-pref-theme-item>
35
+ </mds-pref-theme>
36
+ </mds-pref>
37
+ ```
38
+
39
+ #### Listening for the Change Event
40
+
41
+ React 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.
42
+
43
+ ```html
44
+ <mds-pref>
45
+ <mds-pref-theme id="theme-chooser" name="business" scheme="all">
46
+ <mds-pref-theme-item label="Gestionale" name="business" scheme="all"></mds-pref-theme-item>
47
+ <mds-pref-theme-item label="Editoriale" name="editorial" scheme="all"></mds-pref-theme-item>
48
+ </mds-pref-theme>
49
+ </mds-pref>
50
+
51
+ <script>
52
+ document.querySelector('#theme-chooser').addEventListener('mdsPrefThemeChange', (e) => {
53
+ console.log('Tema attivo:', e.detail.name, '- Schema:', e.detail.scheme);
54
+ });
55
+ </script>
56
+ ```
57
+
58
+ #### Declaring the Initial Theme
59
+
60
+ Use 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.
61
+
62
+ ```html
63
+ <mds-pref>
64
+ <!-- First-visit default is "editorial" -->
65
+ <mds-pref-theme name="editorial" scheme="all">
66
+ <mds-pref-theme-item label="Gestionale" name="business" scheme="all"></mds-pref-theme-item>
67
+ <mds-pref-theme-item label="Editoriale" name="editorial" scheme="all"></mds-pref-theme-item>
68
+ </mds-pref-theme>
69
+ </mds-pref>
70
+ ```
71
+
72
+ #### Controlling Item Size
73
+
74
+ Pass `size="sm"` when the preferences panel must fit a compact layout: on `<mds-pref>`, which forwards it to every preference control.
75
+
76
+ ```html
77
+ <mds-pref size="sm">
78
+ <mds-pref-theme name="business" scheme="all">
79
+ <mds-pref-theme-item label="Gestionale" name="business" scheme="all"></mds-pref-theme-item>
80
+ <mds-pref-theme-item label="Editoriale" name="editorial" scheme="all"></mds-pref-theme-item>
81
+ </mds-pref-theme>
82
+ </mds-pref>
83
+ ```
84
+
85
+ #### Styling Theme Items
86
+
87
+ Style 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.
88
+
89
+ ```css
90
+ mds-pref-theme-item {
91
+ --mds-pref-theme-item-color-background: rgb(var(--magma-surface-inverse));
92
+ }
93
+ ```
@@ -9,6 +9,15 @@ import localeEs from "./meta/locale.es.json";
9
9
  import localeIt from "./meta/locale.it.json";
10
10
  import miBaselineKeyboardArrowDown from "@icon/mi/baseline/keyboard-arrow-down.svg";
11
11
  import miBaselineKeyboardArrowUp from "@icon/mi/baseline/keyboard-arrow-up.svg";
12
+ /**
13
+ * `default` is the old name of `business`, the base theme (the `themes` map of
14
+ * semantic.config.ts, #692): the same theme, so an item of either name stands for it. The
15
+ * component keeps `default` as the default of `name` until the next major makes it `business`.
16
+ */
17
+ const sameTheme = (a, b) => {
18
+ const base = (name) => (name === 'default' ? 'business' : name);
19
+ return base(a) === base(b);
20
+ };
12
21
  /**
13
22
  * @slot - Add `mds-pref-theme-item` element/s.
14
23
  * @category preferences
@@ -71,7 +80,7 @@ export class MdsPrefTheme {
71
80
  * shows it, or, when no item matches, the label an item derives from the name.
72
81
  */
73
82
  this.triggerLabel = () => {
74
- const item = Array.from(this.element.querySelectorAll('mds-pref-theme-item')).find((element) => { var _a, _b; return ((_b = (_a = element.name) !== null && _a !== void 0 ? _a : element.getAttribute('name')) !== null && _b !== void 0 ? _b : 'default') === this.name; });
83
+ const item = Array.from(this.element.querySelectorAll('mds-pref-theme-item')).find((element) => { var _a, _b; return sameTheme((_b = (_a = element.name) !== null && _a !== void 0 ? _a : element.getAttribute('name')) !== null && _b !== void 0 ? _b : 'default', this.name); });
75
84
  return (item === null || item === void 0 ? void 0 : item.label) || (item === null || item === void 0 ? void 0 : item.getAttribute('label')) || labelFromName(this.name);
76
85
  };
77
86
  this.toggleDropdown = () => {
@@ -89,7 +98,7 @@ export class MdsPrefTheme {
89
98
  this.checkThemeSelect = () => {
90
99
  this.themeItems = this.element.querySelectorAll('mds-pref-theme-item');
91
100
  this.themeItems.forEach((element) => {
92
- element.selected = element.name === this.name;
101
+ element.selected = sameTheme(element.name, this.name);
93
102
  });
94
103
  };
95
104
  this.setTheme = (name, scheme) => {
@@ -248,7 +257,7 @@ export class MdsPrefTheme {
248
257
  this.setTheme(name, scheme);
249
258
  }
250
259
  render() {
251
- return (h(Host, { key: '2f7083702541d768d35ca35d53f69c826dd48c54' }, h("div", { key: 'bf697e45493915b806a8065ee2744440d5367891', class: "menu" }, h("mds-text", { key: 'e176eb31c64c0a126536c76c4eb1db108aacb329', class: "info", typography: "caption" }, h("b", { key: 'd166e86a8944ffa6dfbb3ffd612b3260bb6e3fe6' }, this.t.get('label'))), h("mds-tab", { key: '48e477229e5232e92559b892285c3f05823b1e20', fill: true, size: this.size }, h("mds-tab-item", { key: 'f0302e5380b09f69a6e99bc7562a765fbb2d1c4b', 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: 'e427f49597147ce8c098fdfb77eac5ebff784409', class: "mds-pref-theme-dropdown", target: "#mds-pref-theme-nav", interaction: "none", visible: this.showDropdown, onMdsDropdownHide: this.hideThemeDropdownSelect }, h("slot", { key: 'cf784a34089d3fe41fe8edc1c72a1632e9d8b843', onSlotchange: this.checkThemeSelect }))));
260
+ 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 }))));
252
261
  }
253
262
  static get is() { return "mds-pref-theme"; }
254
263
  static get encapsulation() { return "shadow"; }
@@ -0,0 +1,104 @@
1
+ <!--
2
+ GENERATED FILE - do not edit by hand.
3
+ Source of truth: src/components/mds-pref-theme/usage/ in the magma monorepo.
4
+ -->
5
+
6
+ # mds-pref-theme - mistakes
7
+
8
+ > The API of this component: [`AGENTS.md`](AGENTS.md).
9
+
10
+ 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.
11
+
12
+ #### Do Not Use the Component Outside `<mds-pref>`
13
+
14
+ `<mds-pref-theme>` is a compound sub-part designed to slot inside [`<mds-pref>`](../mds-pref/AGENTS.md). As a standalone widget it still applies and persists the theme, but it leaves the panel: `<mds-pref>` can no longer forward `size` changes to it, nor lock the `<mds-pref-mode>` item that its `scheme` forbids.
15
+
16
+ ```html
17
+ <!-- INCORRECT -->
18
+ <mds-pref-theme name="business" scheme="all">
19
+ <mds-pref-theme-item label="Gestionale" name="business" scheme="all"></mds-pref-theme-item>
20
+ </mds-pref-theme>
21
+
22
+ <!-- CORRECT -->
23
+ <mds-pref>
24
+ <mds-pref-theme name="business" scheme="all">
25
+ <mds-pref-theme-item label="Gestionale" name="business" scheme="all"></mds-pref-theme-item>
26
+ </mds-pref-theme>
27
+ </mds-pref>
28
+ ```
29
+
30
+ #### Do Not Put Plain Text or Arbitrary HTML in the Default Slot
31
+
32
+ The 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.
33
+
34
+ ```html
35
+ <!-- INCORRECT -->
36
+ <mds-pref>
37
+ <mds-pref-theme name="business" scheme="all">
38
+ <button>Gestionale</button>
39
+ <span>Editoriale</span>
40
+ </mds-pref-theme>
41
+ </mds-pref>
42
+
43
+ <!-- CORRECT -->
44
+ <mds-pref>
45
+ <mds-pref-theme name="business" scheme="all">
46
+ <mds-pref-theme-item label="Gestionale" name="business" scheme="all"></mds-pref-theme-item>
47
+ <mds-pref-theme-item label="Editoriale" name="editorial" scheme="all"></mds-pref-theme-item>
48
+ </mds-pref-theme>
49
+ </mds-pref>
50
+ ```
51
+
52
+ #### Do Not Use an Invalid Theme Name
53
+
54
+ The `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.
55
+
56
+ ```html
57
+ <!-- INCORRECT -->
58
+ <mds-pref-theme name="My Theme" scheme="all">...</mds-pref-theme>
59
+ <mds-pref-theme name="my_theme" scheme="all">...</mds-pref-theme>
60
+ <mds-pref-theme name="MyTheme" scheme="all">...</mds-pref-theme>
61
+
62
+ <!-- CORRECT -->
63
+ <mds-pref-theme name="editorial" scheme="all">...</mds-pref-theme>
64
+ ```
65
+
66
+ #### Do Not Listen for the Native `change` Event
67
+
68
+ `<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.
69
+
70
+ ```html
71
+ <!-- INCORRECT -->
72
+ <script>
73
+ document.querySelector('mds-pref-theme').addEventListener('change', (e) => {
74
+ console.log(e.target.value); // undefined - wrong event, wrong detail shape
75
+ });
76
+ </script>
77
+
78
+ <!-- CORRECT -->
79
+ <script>
80
+ document.querySelector('mds-pref-theme').addEventListener('mdsPrefThemeChange', (e) => {
81
+ console.log(e.detail.name, e.detail.scheme);
82
+ });
83
+ </script>
84
+ ```
85
+
86
+ #### Do Not Give the Parent and the Child Different Sizes
87
+
88
+ `<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.
89
+
90
+ ```html
91
+ <!-- INCORRECT -->
92
+ <mds-pref size="sm">
93
+ <mds-pref-theme size="md" name="default" scheme="all">
94
+ <mds-pref-theme-item label="Gestionale" name="business" scheme="all"></mds-pref-theme-item>
95
+ </mds-pref-theme>
96
+ </mds-pref>
97
+
98
+ <!-- CORRECT -->
99
+ <mds-pref size="sm">
100
+ <mds-pref-theme name="business" scheme="all">
101
+ <mds-pref-theme-item label="Gestionale" name="business" scheme="all"></mds-pref-theme-item>
102
+ </mds-pref-theme>
103
+ </mds-pref>
104
+ ```
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-pref-theme-item
8
8
 
9
- > `@maggioli-design-system/magma` 2.9.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
9
+ > `@maggioli-design-system/magma` 2.11.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
10
10
 
11
11
  The `<mds-pref-theme-item>` web component is a single selectable theme entry inside the [`<mds-pref-theme>`](../mds-pref-theme/AGENTS.md) preference picker. It renders as a borderless button that pairs a color-swatch preview of the theme with its label.
12
12
 
@@ -16,27 +16,27 @@ The `<mds-pref-theme-item>` web component is a single selectable theme entry ins
16
16
  - **Selection is parent-driven**: On click each item emits `mdsPrefThemeItemSelect` (carrying `{ name, scheme }`), and the parent responds by clearing the siblings and selecting the clicked one. Setting `selected` directly on a single item does not coordinate the others.
17
17
  - **Click bubbles up**: The emitted event is what the parent listens to in order to apply the theme to the document and persist the choice.
18
18
  - **Auto-derived label**: If `label` is omitted, it is generated from `name` by capitalizing the first letter and replacing hyphens with spaces (e.g. `maggioli-editore` becomes `Maggioli editore`).
19
- - **Static color preview**: The four swatches (primary, success, warning, error) and the preview background are painted by the `--mds-pref-theme-item-*` CSS custom properties, not by props. Their defaults are the page's current roles (accent, the status emphases, `wash-base`), so every item shows the same swatches until you set the properties per item.
19
+ - **Preview of the theme it names**: The preview background and the primary dot show the wash and the accent of the theme named by `name`, which the styles of that theme publish as `--magma-preview-<name>-wash` and `--magma-preview-<name>-accent` (`themes.css` does for every theme Magma ships), so each item of the picker shows its own theme whatever the active one. The success, warning and error dots are the page's status emphases, which no theme retints. A theme that publishes no preview shows the active theme. The `--mds-pref-theme-item-*` CSS custom properties paint all of it and still override it.
20
20
 
21
21
  #### Properties & Visual Configurations
22
22
 
23
- - **`name`**: The theme identifier reported to the parent and matched against the parent's active `name` to compute initial selection. Use a simple or kebab-case string; the named themes are `cool` and `warm`, and `default` is the base theme ([`agents/theming.md`](../../../../agents/theming.md)). The parent validates the lowercase/kebab format and ignores an invalid name with a console warning.
23
+ - **`name`**: The theme identifier reported to the parent and matched against the parent's active `name` to compute initial selection. Use a simple or kebab-case string; the named themes are `business`, the base theme, and `editorial` ([`agents/theming.md`](../../../../agents/theming.md)). `default`, `cool` and `warm` still work and are deprecated: they leave at the next major. The parent validates the lowercase/kebab format and ignores an invalid name with a console warning.
24
24
  - **`scheme`**: Declares which color schemes the theme supports - `all` (default, both light and dark), or `light` / `dark` to force a single mode. This value travels with the selection event and is applied by the parent when the item is chosen.
25
25
  - **`selected`**: Reflects whether this item is the active theme. The parent sets it on every item when it loads and on each pick, so a value set by hand is overwritten.
26
26
 
27
27
  ## Read next
28
28
 
29
- - [`pattern.md`](pattern.md) - correct usage, with examples
30
- - [`antipattern.md`](antipattern.md) - mistakes to avoid
29
+ - [`examples.md`](examples.md) - correct usage, from the most common case
30
+ - [`mistakes.md`](mistakes.md) - the wrong forms, each with the right one
31
31
  - [Storybook](https://magma-design-system.github.io/magma/storybook/?path=/docs/ui-preferences-theme-item--docs) - the live examples, in the published Storybook of `main`
32
- - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`anti-patterns.md`](../../../../agents/anti-patterns.md) - the rules shared by every component
32
+ - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`mistakes.md`](../../../../agents/mistakes.md) - the rules shared by every component
33
33
 
34
34
  ## Props
35
35
 
36
36
  | Prop | Attribute | Type | Default | Description |
37
37
  | --- | --- | --- | --- | --- |
38
38
  | `label` | `label` | `string \| undefined` | - | Specifies the theme name |
39
- | `name` | `name` | `string` | `'default'` | Specifies the theme name |
39
+ | `name` | `name` | `string` | `'default'` | Specifies the theme name; the swatch shows the preview that theme publishes, `--magma-preview-<name>-wash` and `--magma-preview-<name>-accent` |
40
40
  | `scheme` | `scheme` | `"all" \| "dark" \| "light" \| undefined` | `'all'` | Specifies the theme scheme which can be 'light', 'dark' or 'all' |
41
41
  | `selected` | `selected` | `boolean \| undefined` | `false` | Specifies if the element is selected |
42
42
 
@@ -50,7 +50,7 @@ The `<mds-pref-theme-item>` web component is a single selectable theme entry ins
50
50
 
51
51
  | Property | Description |
52
52
  | --- | --- |
53
- | `--mds-pref-theme-item-color-background` | Background color of a theme item. |
53
+ | `--mds-pref-theme-item-color-background` | Background color of a theme item: the wash of the theme it names. |
54
54
 
55
55
  Only these are public. Its other 4 are internal: they may change in any release, do not set them.
56
56