@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
@@ -42,6 +42,9 @@ mds-text {
42
42
 
43
43
  :host {
44
44
  --mds-banner-background: rgb(var(--magma-surface-overlay, var(--surface-neutral-overlay, 255 255 255)));
45
+
46
+ /* overlay: the fields inside take the step below (#1193) */
47
+ --magma-field-fill: var(--magma-surface-default, var(--surface-neutral-default, 242 242 242));
45
48
  --mds-banner-cockade-background: rgb(var(--magma-wash-base, var(--tone-neutral-09, 225 225 225)));
46
49
  --mds-banner-cockade-distance: --spacing(600);
47
50
  --mds-banner-color: rgb(var(--magma-text-default, var(--text-neutral-default, 5 5 5)));
@@ -128,6 +131,13 @@ mds-text {
128
131
  padding-right: --spacing(800);
129
132
  }
130
133
 
134
+ }
135
+
136
+ /* actions/stacked (#1189): under --magma-container-actions the row stacks, every action at the
137
+ full width in the order of the row, the main action at the bottom; the query reads its Tailwind
138
+ bridge at build time, since a container query reads no var() */
139
+
140
+ @container mds-banner (width < --theme(--container-actions)) {
131
141
  ::slotted([slot='action']) {
132
142
  flex-basis: 100%;
133
143
  flex-grow: 1;
@@ -211,6 +221,7 @@ mds-text {
211
221
  :host([variant='error']) {
212
222
  --mds-banner-headline-color: rgb(var(--magma-danger-text-subtle, var(--text-error-subtle, 165 33 40)));
213
223
  --mds-banner-background: rgb(var(--magma-danger-wash-soft, var(--status-error-10, 255 232 230)));
224
+ --magma-field-fill: var(--magma-surface-overlay, var(--surface-neutral-overlay, 255 255 255));
214
225
  --mds-banner-color: rgb(var(--magma-danger-text-muted, var(--text-error-muted, 132 0 11)));
215
226
  --mds-banner-icon-color: rgb(var(--magma-danger-text-default, var(--text-error-default, 89 0 0)));
216
227
  --mds-banner-shadow: none;
@@ -218,6 +229,7 @@ mds-text {
218
229
 
219
230
  &:host([tone='weak']) {
220
231
  --mds-banner-background: rgb(var(--magma-surface-overlay, var(--surface-neutral-overlay, 255 255 255)));
232
+ --magma-field-fill: var(--magma-surface-default, var(--surface-neutral-default, 242 242 242));
221
233
  --mds-banner-color: rgb(var(--magma-text-default, var(--text-neutral-default, 5 5 5)));
222
234
  --mds-banner-icon-color: rgb(var(--magma-danger-emphasis, var(--status-error-04, 196 64 65)));
223
235
  --mds-banner-shadow: var(--shadow-sm-sharp, 0 0 1px 1px rgb(0 0 0 / 0.06), 0 1px 3px 0 rgb(0 0 0 / 0.1));
@@ -228,6 +240,7 @@ mds-text {
228
240
  :host([variant='warning']) {
229
241
  --mds-banner-headline-color: rgb(var(--magma-warning-text-subtle, var(--text-warning-subtle, 113 85 0)));
230
242
  --mds-banner-background: rgb(var(--magma-warning-wash-soft, var(--status-warning-10, 255 237 181)));
243
+ --magma-field-fill: var(--magma-surface-overlay, var(--surface-neutral-overlay, 255 255 255));
231
244
  --mds-banner-color: rgb(var(--magma-warning-text-muted, var(--text-warning-muted, 88 66 0)));
232
245
  --mds-banner-icon-color: rgb(var(--magma-warning-text-default, var(--text-warning-default, 58 44 0)));
233
246
  --mds-banner-shadow: none;
@@ -235,6 +248,7 @@ mds-text {
235
248
 
236
249
  &:host([tone='weak']) {
237
250
  --mds-banner-background: rgb(var(--magma-surface-overlay, var(--surface-neutral-overlay, 255 255 255)));
251
+ --magma-field-fill: var(--magma-surface-default, var(--surface-neutral-default, 242 242 242));
238
252
  --mds-banner-color: rgb(var(--magma-text-default, var(--text-neutral-default, 5 5 5)));
239
253
  --mds-banner-icon-color: rgb(var(--magma-warning-emphasis, var(--status-warning-04, 142 106 0)));
240
254
  --mds-banner-shadow: var(--shadow-sm-sharp, 0 0 1px 1px rgb(0 0 0 / 0.06), 0 1px 3px 0 rgb(0 0 0 / 0.1));
@@ -245,6 +259,7 @@ mds-text {
245
259
  :host([variant='info']) {
246
260
  --mds-banner-headline-color: rgb(var(--magma-info-text-subtle, var(--text-info-subtle, 0 94 137)));
247
261
  --mds-banner-background: rgb(var(--magma-info-wash-soft, var(--status-info-10, 220 240 250)));
262
+ --magma-field-fill: var(--magma-surface-overlay, var(--surface-neutral-overlay, 255 255 255));
248
263
  --mds-banner-color: rgb(var(--magma-info-text-muted, var(--text-info-muted, 0 71 114)));
249
264
  --mds-banner-icon-color: rgb(var(--magma-info-text-default, var(--text-info-default, 0 45 86)));
250
265
  --mds-banner-shadow: none;
@@ -252,6 +267,7 @@ mds-text {
252
267
 
253
268
  &:host([tone='weak']) {
254
269
  --mds-banner-background: rgb(var(--magma-surface-overlay, var(--surface-neutral-overlay, 255 255 255)));
270
+ --magma-field-fill: var(--magma-surface-default, var(--surface-neutral-default, 242 242 242));
255
271
  --mds-banner-color: rgb(var(--magma-text-default, var(--text-neutral-default, 5 5 5)));
256
272
  --mds-banner-icon-color: rgb(var(--magma-info-emphasis, var(--status-info-04, 0 119 164)));
257
273
  --mds-banner-shadow: var(--shadow-sm-sharp, 0 0 1px 1px rgb(0 0 0 / 0.06), 0 1px 3px 0 rgb(0 0 0 / 0.1));
@@ -262,6 +278,7 @@ mds-text {
262
278
  :host([variant='success']) {
263
279
  --mds-banner-headline-color: rgb(var(--magma-success-text-subtle, var(--text-success-subtle, 0 102 32)));
264
280
  --mds-banner-background: rgb(var(--magma-success-wash-soft, var(--status-success-10, 220 243 227)));
281
+ --magma-field-fill: var(--magma-surface-overlay, var(--surface-neutral-overlay, 255 255 255));
265
282
  --mds-banner-color: rgb(var(--magma-success-text-muted, var(--text-success-muted, 0 80 7)));
266
283
  --mds-banner-icon-color: rgb(var(--magma-success-text-default, var(--text-success-default, 0 53 0)));
267
284
  --mds-banner-shadow: none;
@@ -269,6 +286,7 @@ mds-text {
269
286
 
270
287
  &:host([tone='weak']) {
271
288
  --mds-banner-background: rgb(var(--magma-surface-overlay, var(--surface-neutral-overlay, 255 255 255)));
289
+ --magma-field-fill: var(--magma-surface-default, var(--surface-neutral-default, 242 242 242));
272
290
  --mds-banner-color: rgb(var(--magma-text-default, var(--text-neutral-default, 5 5 5)));
273
291
  --mds-banner-icon-color: rgb(var(--magma-success-emphasis, var(--status-success-04, 0 128 57)));
274
292
  --mds-banner-shadow: var(--shadow-sm-sharp, 0 0 1px 1px rgb(0 0 0 / 0.06), 0 1px 3px 0 rgb(0 0 0 / 0.1));
@@ -278,6 +296,7 @@ mds-text {
278
296
 
279
297
  :host([variant='dark']) {
280
298
  --mds-banner-background: rgb(var(--magma-surface-inverse, var(--tone-neutral-02, 42 42 42)));
299
+ --magma-field-fill: var(--magma-surface-overlay, var(--surface-neutral-overlay, 255 255 255));
281
300
  --mds-banner-cockade-background: rgb(var(--magma-on-inverse, var(--tone-neutral-seed, 255 255 255)) / 0.15);
282
301
  --mds-banner-color: rgb(var(--magma-on-inverse, var(--tone-neutral-seed, 255 255 255)));
283
302
  --mds-banner-headline-color: rgb(var(--magma-on-inverse, var(--tone-neutral-seed, 255 255 255)));
@@ -0,0 +1,140 @@
1
+ <!--
2
+ GENERATED FILE - do not edit by hand.
3
+ Source of truth: src/components/mds-banner/usage/ in the magma monorepo.
4
+ -->
5
+
6
+ # mds-banner - mistakes
7
+
8
+ > The API of this component: [`AGENTS.md`](AGENTS.md).
9
+
10
+ Common incorrect uses of `<mds-banner>`. 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 an Invalid `tone` Value
13
+
14
+ `mds-banner.tone` is typed as `ToneMinimalBoxVariantType`, which allows only `weak`, `strong`, and `box`. Values like `outline` or `text` are not accepted: no tone style matches them, so the banner renders as with `strong`, not with the `weak` default.
15
+
16
+ ```html
17
+ <!-- INCORRECT -->
18
+ <mds-banner variant="info" tone="outline">
19
+ <mds-text typography="detail">Informazione di sistema.</mds-text>
20
+ </mds-banner>
21
+
22
+ <!-- CORRECT -->
23
+ <mds-banner variant="info" tone="weak">
24
+ <mds-text typography="detail">Informazione di sistema.</mds-text>
25
+ </mds-banner>
26
+ ```
27
+
28
+ #### Do Not Override the ARIA Role Manually
29
+
30
+ The component derives `role` and `aria-live` from `variant` (`error`/`warning` assertive, others polite) and writes them on the host when it renders, overwriting a manual value. To change the announcement, change the `variant`.
31
+
32
+ ```html
33
+ <!-- INCORRECT -->
34
+ <mds-banner variant="info" role="alert" aria-live="assertive">
35
+ <mds-text typography="detail">Aggiornamento disponibile.</mds-text>
36
+ </mds-banner>
37
+
38
+ <!-- CORRECT - let variant drive the ARIA behavior -->
39
+ <mds-banner variant="info">
40
+ <mds-text typography="detail">Aggiornamento disponibile.</mds-text>
41
+ </mds-banner>
42
+ ```
43
+
44
+ #### Do Not Slot an `mds-button` into the Default Slot to Add Actions
45
+
46
+ The `action` named slot is the correct place for inline controls. Placing buttons in the default slot renders them inside the text region, breaks layout, and loses the flex wrapping the action row provides.
47
+
48
+ ```html
49
+ <!-- INCORRECT -->
50
+ <mds-banner variant="warning">
51
+ <mds-text typography="detail">La licenza sta per scadere.</mds-text>
52
+ <mds-button variant="warning">Rinnova</mds-button>
53
+ </mds-banner>
54
+
55
+ <!-- CORRECT -->
56
+ <mds-banner variant="warning">
57
+ <mds-text typography="detail">La licenza sta per scadere.</mds-text>
58
+ <mds-button slot="action" variant="warning" tone="strong">Rinnova</mds-button>
59
+ </mds-banner>
60
+ ```
61
+
62
+ #### Do Not Set `dismissible="false"` to Hide the Close Button
63
+
64
+ `dismissible` is a boolean prop, and a false boolean is an absent attribute ([`agents/mistakes.md`](../../../../agents/mistakes.md)). Stencil reads the string `"false"` as `false` here, so the button is hidden, but the attribute stays on the element and any `[dismissible]` selector still matches it. Remove the attribute (or omit it) to hide the button.
65
+
66
+ ```html
67
+ <!-- INCORRECT -->
68
+ <mds-banner variant="error" dismissible="false">
69
+ <mds-text typography="detail">Errore permanente - non dismissibile.</mds-text>
70
+ </mds-banner>
71
+
72
+ <!-- CORRECT -->
73
+ <mds-banner variant="error">
74
+ <mds-text typography="detail">Errore permanente - non dismissibile.</mds-text>
75
+ </mds-banner>
76
+ ```
77
+
78
+ #### Do Not Use `dark` or `light` for Status Messages
79
+
80
+ `variant="dark"` and `variant="light"` produce `role="presentation"` with no live region - they are silent to assistive tech. Using them for error, warning, or informational content means screen reader users never receive the announcement.
81
+
82
+ ```html
83
+ <!-- INCORRECT - errore silenzioso per tecnologie assistive -->
84
+ <mds-banner variant="dark">
85
+ <mds-text typography="detail">Errore: impossibile caricare il documento.</mds-text>
86
+ </mds-banner>
87
+
88
+ <!-- CORRECT -->
89
+ <mds-banner variant="error">
90
+ <mds-text typography="detail">Errore: impossibile caricare il documento.</mds-text>
91
+ </mds-banner>
92
+ ```
93
+
94
+ #### Do Not Pierce Shadow DOM to Style Internals
95
+
96
+ The only supported customization surface is the public `--mds-banner-*` CSS custom properties plus the `::part(text)` shadow part. Targeting internal class names with `>>>` or undocumented `::part()` names couples your code to the implementation and breaks on minor releases.
97
+
98
+ ```css
99
+ /* INCORRECT */
100
+ mds-banner >>> .headline {
101
+ font-size: 1.5rem;
102
+ }
103
+ mds-banner::part(content) {
104
+ padding: 0;
105
+ }
106
+
107
+ /* CORRECT */
108
+ mds-banner {
109
+ --mds-banner-radius: var(--magma-radius-sm);
110
+ }
111
+ mds-banner::part(text) {
112
+ line-height: 1.6;
113
+ }
114
+ ```
115
+
116
+ #### Do Not Listen to the Native `click` Event for Dismissal
117
+
118
+ The component fires `mdsBannerClose` only when the close button is activated (both pointer and keyboard). A native `click` listener on the host fires for a click anywhere in the banner, body text and action buttons included.
119
+
120
+ ```html
121
+ <!-- INCORRECT -->
122
+ <mds-banner variant="info" dismissible id="notice">
123
+ <mds-text typography="detail">Avviso temporaneo.</mds-text>
124
+ </mds-banner>
125
+ <script>
126
+ document.querySelector('#notice').addEventListener('click', () => {
127
+ document.querySelector('#notice').remove();
128
+ });
129
+ </script>
130
+
131
+ <!-- CORRECT -->
132
+ <mds-banner variant="info" dismissible id="notice">
133
+ <mds-text typography="detail">Avviso temporaneo.</mds-text>
134
+ </mds-banner>
135
+ <script>
136
+ document.querySelector('#notice').addEventListener('mdsBannerClose', () => {
137
+ document.querySelector('#notice').remove();
138
+ });
139
+ </script>
140
+ ```
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-benchmark-bar
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-benchmark-bar>` web component is a read-only data-visualization element of the Magma Design System that pairs a labelled caption with a horizontal progress bar to express a single benchmark value on a 0-100 scale. It is a presentational compound that composes `<mds-text>` and `<mds-progress>`; it has no native HTML primitive equivalent.
12
12
 
@@ -27,10 +27,10 @@ The shared `variant` and `size` ladders are defined in [`agents/variants.md`](..
27
27
 
28
28
  ## Read next
29
29
 
30
- - [`pattern.md`](pattern.md) - correct usage, with examples
31
- - [`antipattern.md`](antipattern.md) - mistakes to avoid
30
+ - [`examples.md`](examples.md) - correct usage, from the most common case
31
+ - [`mistakes.md`](mistakes.md) - the wrong forms, each with the right one
32
32
  - [Storybook](https://magma-design-system.github.io/magma/storybook/?path=/docs/ui-benchmark-bar--docs) - the live examples, in the published Storybook of `main`
33
- - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`anti-patterns.md`](../../../../agents/anti-patterns.md) - the rules shared by every component
33
+ - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`mistakes.md`](../../../../agents/mistakes.md) - the rules shared by every component
34
34
 
35
35
  ## Props
36
36
 
@@ -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",
@@ -28,8 +28,8 @@
28
28
  ],
29
29
  "usage": {
30
30
  "1. Description": "The `<mds-benchmark-bar>` web component is a read-only data-visualization element of the Magma Design System that pairs a labelled caption with a horizontal progress bar to express a single benchmark value on a 0-100 scale. It is a presentational compound that composes `<mds-text>` and `<mds-progress>`; it has no native HTML primitive equivalent.\n\n#### Semantic Behavior\n\n- **Display-only**: The component is non-interactive - it emits no events, has no form association, and is not part of the tab sequence.\n- **Text-only label**: The label caption is meant to carry a plain text string, not markup; the `label` prop is the supported source of that text.\n- **Deprecated default slot**: Slotted text is still read as a legacy fallback, but only when `label` is empty - once `label` is set it always wins. HTML elements or components in the slot are unsupported.\n- **Shadow part**: The inner progress bar is exposed as the `progress-bar` part for external styling.\n\n#### Properties & Visual Configurations\n\n- **`value`** drives the rendered value text, the value screen readers announce (the same text) and the fill of the progress bar; supply it on a 0-100 scale.\n- **`alias`** overrides how the value is displayed: when present it replaces the numeric `value` in the caption (and in the announced value), letting you show formatted or qualitative text (e.g. a graded label) instead of the raw number.\n- **`typography`** selects the text scale applied to both the label and value captions, choosing between `'label'` (the default, larger caption) and `'option'` (smaller, for compact contexts).\n\nThe shared `variant` and `size` ladders are defined in [`agents/variants.md`](../../../../agents/variants.md); `variant` sets the progress bar theme colors (defaulting to `'dark'`), and `size` controls the progress bar height (defaulting to `'md'`). This component does not add values beyond the shared sets.\n",
31
- "2. Pattern": "Correct and idiomatic ways to use the `<mds-benchmark-bar>` component, ordered from most common to most specialized. Patterns assume a working knowledge of the variant / tone ladders documented in [`agents/variants.md`](../../../../agents/variants.md) and the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Basic Benchmark via `label` and `value`\n\nThe canonical form. Set `label` for the caption text and `value` (0-100) for the fill. `label` is reflected as an attribute; `value` is not, so a value set from JavaScript does not show up in attribute selectors.\n\n```html\n<mds-benchmark-bar label=\"Soddisfazione clienti\" value=\"72\"></mds-benchmark-bar>\n```\n\n#### Multiple Bars in a List\n\nRender several bars together to compare metrics. Each bar stands on its own; no parent wrapper is required.\n\n```html\n<mds-benchmark-bar label=\"Qualita del servizio\" value=\"85\"></mds-benchmark-bar>\n<mds-benchmark-bar label=\"Tempi di risposta\" value=\"61\"></mds-benchmark-bar>\n<mds-benchmark-bar label=\"Risoluzione al primo contatto\" value=\"44\"></mds-benchmark-bar>\n```\n\n#### Alias to Replace the Numeric Value\n\nUse `alias` when you need to display a formatted or qualitative string instead of the raw number. The alias also becomes the accessible `aria-valuetext` announced to screen readers; without it they announce the number, as shown.\n\n```html\n<!-- Show a grade label instead of the raw score -->\n<mds-benchmark-bar\n label=\"Punteggio complessivo\"\n value=\"68\"\n alias=\"Buono\"\n></mds-benchmark-bar>\n\n<!-- Show a ratio string -->\n<mds-benchmark-bar\n label=\"Attivita completate\"\n value=\"33\"\n alias=\"1 di 3\"\n></mds-benchmark-bar>\n```\n\n#### Variant for Semantic Color\n\n`variant` controls the color theme of the progress bar. Pick the value that matches the meaning of the metric, not the color you want.\n\n```html\n<!-- Neutral / default -->\n<mds-benchmark-bar label=\"Utilizzo CPU\" value=\"55\" variant=\"dark\"></mds-benchmark-bar>\n\n<!-- Primary brand emphasis -->\n<mds-benchmark-bar label=\"Avanzamento progetto\" value=\"70\" variant=\"primary\"></mds-benchmark-bar>\n\n<!-- Status: healthy -->\n<mds-benchmark-bar label=\"Uptime mensile\" value=\"99\" variant=\"success\"></mds-benchmark-bar>\n\n<!-- Status: under threshold -->\n<mds-benchmark-bar label=\"Scorte disponibili\" value=\"18\" variant=\"warning\"></mds-benchmark-bar>\n\n<!-- Status: critical -->\n<mds-benchmark-bar label=\"Errori rilevati\" value=\"82\" variant=\"error\"></mds-benchmark-bar>\n```\n\n#### Size\n\n`size` controls the height of the progress bar. Use `sm` for dense lists, `lg` / `xl` for hero metrics.\n\n```html\n<mds-benchmark-bar label=\"Piccolo\" value=\"40\" size=\"sm\"></mds-benchmark-bar>\n<mds-benchmark-bar label=\"Medio (default)\" value=\"40\" size=\"md\"></mds-benchmark-bar>\n<mds-benchmark-bar label=\"Grande\" value=\"40\" size=\"lg\"></mds-benchmark-bar>\n<mds-benchmark-bar label=\"Extra grande\" value=\"40\" size=\"xl\"></mds-benchmark-bar>\n```\n\n#### Typography Scale\n\n`typography` applies to both the label caption and the value text. Use `option` for compact contexts where the default `label` scale is too heavy.\n\n```html\n<!-- Default scale -->\n<mds-benchmark-bar label=\"Punteggio\" value=\"76\" typography=\"label\"></mds-benchmark-bar>\n\n<!-- Compact / denser scale -->\n<mds-benchmark-bar label=\"Punteggio\" value=\"76\" typography=\"option\"></mds-benchmark-bar>\n```\n\n#### Styling Customization via `::part(progress-bar)`\n\nThe inner progress bar is exposed as the `progress-bar` shadow part. Use it to apply targeted overrides when the documented variant colors are insufficient - for example, to enforce a brand-specific fill in a narrow context.\n\n```css\n.hero-metric mds-benchmark-bar::part(progress-bar) {\n --mds-progress-color: rgb(var(--magma-accent-ai-fg));\n}\n```\n",
32
- "3. Antipattern": "Common incorrect uses of `<mds-benchmark-bar>`. Each entry pairs the wrong form with the right one and a one-line reason. System-wide rules (boolean-as-string, shadow piercing, Tailwind color utilities, raw native event listening) live in [`agents/anti-patterns.md`](../../../../agents/anti-patterns.md) - they apply here too but are not repeated.\n\n#### Do Not Put HTML in the Default Slot\n\nThe default slot is deprecated and accepts plain text only; HTML elements are unsupported and will not render correctly. Use the `label` prop for the caption.\n\n```html\n<!-- INCORRECT -->\n<mds-benchmark-bar value=\"60\">\n <strong>Completamento attivita</strong>\n</mds-benchmark-bar>\n\n<!-- CORRECT -->\n<mds-benchmark-bar label=\"Completamento attivita\" value=\"60\"></mds-benchmark-bar>\n```\n\n#### Do Not Set `value` Outside the 0-100 Range\n\nThe inner `<mds-progress>` reads a value above 100 as 100 and a negative one as 0, but the caption still shows the raw number, which then contradicts the bar. Clamp the value in your data layer before binding.\n\n```html\n<!-- INCORRECT -->\n<mds-benchmark-bar label=\"Richieste elaborate\" value=\"1540\"></mds-benchmark-bar>\n\n<!-- CORRECT -->\n<!-- normalize to 0-100 in your controller before binding -->\n<mds-benchmark-bar label=\"Richieste elaborate\" value=\"100\"></mds-benchmark-bar>\n```\n\n#### Do Not Use `alias` for Structurally Different Content\n\n`alias` replaces the numeric value with a plain string in both the visual caption and the accessible `aria-valuetext`. It is not a slot - do not attempt to bind rich HTML or icon markup to it.\n\n```html\n<!-- INCORRECT -->\n<mds-benchmark-bar label=\"Stato\" value=\"80\" alias=\"<mds-badge variant='success'>OK</mds-badge>\"></mds-benchmark-bar>\n\n<!-- CORRECT -->\n<mds-benchmark-bar label=\"Stato\" value=\"80\" alias=\"Ottimo\"></mds-benchmark-bar>\n```\n\n#### Do Not Override `variant` to Express Visual Weight Alone\n\n`variant` is a semantic role (`primary`, `error`, `success`, `warning`, etc.). Do not choose it purely for the color it produces - choose it for what the metric means. Mixing semantic values for aesthetic reasons makes the chart misleading.\n\n```html\n<!-- INCORRECT: error red chosen because it \"looks bold\", not because it signals a problem -->\n<mds-benchmark-bar label=\"Popolarita del prodotto\" value=\"88\" variant=\"error\"></mds-benchmark-bar>\n\n<!-- CORRECT -->\n<mds-benchmark-bar label=\"Popolarita del prodotto\" value=\"88\" variant=\"success\"></mds-benchmark-bar>\n```\n\n#### Do Not Pierce the Shadow DOM to Style the Progress Bar\n\nUse the documented `::part(progress-bar)` surface to style the inner bar. Reaching into the shadow DOM via `>>>` or undocumented class selectors couples your code to the implementation and will break on minor releases.\n\n```css\n/* INCORRECT */\nmds-benchmark-bar >>> mds-progress {\n background-color: hotpink;\n}\n\n/* CORRECT */\n.my-context mds-benchmark-bar::part(progress-bar) {\n --mds-progress-color: rgb(var(--magma-accent-fg));\n}\n```\n"
31
+ "2. Examples": "Correct and idiomatic ways to use the `<mds-benchmark-bar>` component, ordered from most common to most specialized. The examples assume a working knowledge of the variant / tone ladders documented in [`agents/variants.md`](../../../../agents/variants.md) and the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Basic Benchmark via `label` and `value`\n\nThe canonical form. Set `label` for the caption text and `value` (0-100) for the fill. `label` is reflected as an attribute; `value` is not, so a value set from JavaScript does not show up in attribute selectors.\n\n```html\n<mds-benchmark-bar label=\"Soddisfazione clienti\" value=\"72\"></mds-benchmark-bar>\n```\n\n#### Multiple Bars in a List\n\nRender several bars together to compare metrics. Each bar stands on its own; no parent wrapper is required.\n\n```html\n<mds-benchmark-bar label=\"Qualita del servizio\" value=\"85\"></mds-benchmark-bar>\n<mds-benchmark-bar label=\"Tempi di risposta\" value=\"61\"></mds-benchmark-bar>\n<mds-benchmark-bar label=\"Risoluzione al primo contatto\" value=\"44\"></mds-benchmark-bar>\n```\n\n#### Alias to Replace the Numeric Value\n\nUse `alias` when you need to display a formatted or qualitative string instead of the raw number. The alias also becomes the accessible `aria-valuetext` announced to screen readers; without it they announce the number, as shown.\n\n```html\n<!-- Show a grade label instead of the raw score -->\n<mds-benchmark-bar\n label=\"Punteggio complessivo\"\n value=\"68\"\n alias=\"Buono\"\n></mds-benchmark-bar>\n\n<!-- Show a ratio string -->\n<mds-benchmark-bar\n label=\"Attivita completate\"\n value=\"33\"\n alias=\"1 di 3\"\n></mds-benchmark-bar>\n```\n\n#### Variant for Semantic Color\n\n`variant` controls the color theme of the progress bar. Pick the value that matches the meaning of the metric, not the color you want.\n\n```html\n<!-- Neutral / default -->\n<mds-benchmark-bar label=\"Utilizzo CPU\" value=\"55\" variant=\"dark\"></mds-benchmark-bar>\n\n<!-- Primary brand emphasis -->\n<mds-benchmark-bar label=\"Avanzamento progetto\" value=\"70\" variant=\"primary\"></mds-benchmark-bar>\n\n<!-- Status: healthy -->\n<mds-benchmark-bar label=\"Uptime mensile\" value=\"99\" variant=\"success\"></mds-benchmark-bar>\n\n<!-- Status: under threshold -->\n<mds-benchmark-bar label=\"Scorte disponibili\" value=\"18\" variant=\"warning\"></mds-benchmark-bar>\n\n<!-- Status: critical -->\n<mds-benchmark-bar label=\"Errori rilevati\" value=\"82\" variant=\"error\"></mds-benchmark-bar>\n```\n\n#### Size\n\n`size` controls the height of the progress bar. Use `sm` for dense lists, `lg` / `xl` for hero metrics.\n\n```html\n<mds-benchmark-bar label=\"Piccolo\" value=\"40\" size=\"sm\"></mds-benchmark-bar>\n<mds-benchmark-bar label=\"Medio (default)\" value=\"40\" size=\"md\"></mds-benchmark-bar>\n<mds-benchmark-bar label=\"Grande\" value=\"40\" size=\"lg\"></mds-benchmark-bar>\n<mds-benchmark-bar label=\"Extra grande\" value=\"40\" size=\"xl\"></mds-benchmark-bar>\n```\n\n#### Typography Scale\n\n`typography` applies to both the label caption and the value text. Use `option` for compact contexts where the default `label` scale is too heavy.\n\n```html\n<!-- Default scale -->\n<mds-benchmark-bar label=\"Punteggio\" value=\"76\" typography=\"label\"></mds-benchmark-bar>\n\n<!-- Compact / denser scale -->\n<mds-benchmark-bar label=\"Punteggio\" value=\"76\" typography=\"option\"></mds-benchmark-bar>\n```\n\n#### Styling Customization via `::part(progress-bar)`\n\nThe inner progress bar is exposed as the `progress-bar` shadow part. Use it to apply targeted overrides when the documented variant colors are insufficient - for example, to enforce a brand-specific fill in a narrow context.\n\n```css\n.hero-metric mds-benchmark-bar::part(progress-bar) {\n --mds-progress-color: rgb(var(--magma-accent-ai-fg));\n}\n```\n",
32
+ "3. Mistakes": "Common incorrect uses of `<mds-benchmark-bar>`. Each entry pairs the wrong form with the right one and a one-line reason. System-wide rules (boolean-as-string, shadow piercing, Tailwind color utilities, raw native event listening) live in [`agents/mistakes.md`](../../../../agents/mistakes.md) - they apply here too but are not repeated.\n\n#### Do Not Put HTML in the Default Slot\n\nThe default slot is deprecated and accepts plain text only; HTML elements are unsupported and will not render correctly. Use the `label` prop for the caption.\n\n```html\n<!-- INCORRECT -->\n<mds-benchmark-bar value=\"60\">\n <strong>Completamento attivita</strong>\n</mds-benchmark-bar>\n\n<!-- CORRECT -->\n<mds-benchmark-bar label=\"Completamento attivita\" value=\"60\"></mds-benchmark-bar>\n```\n\n#### Do Not Set `value` Outside the 0-100 Range\n\nThe inner `<mds-progress>` reads a value above 100 as 100 and a negative one as 0, but the caption still shows the raw number, which then contradicts the bar. Clamp the value in your data layer before binding.\n\n```html\n<!-- INCORRECT -->\n<mds-benchmark-bar label=\"Richieste elaborate\" value=\"1540\"></mds-benchmark-bar>\n\n<!-- CORRECT -->\n<!-- normalize to 0-100 in your controller before binding -->\n<mds-benchmark-bar label=\"Richieste elaborate\" value=\"100\"></mds-benchmark-bar>\n```\n\n#### Do Not Use `alias` for Structurally Different Content\n\n`alias` replaces the numeric value with a plain string in both the visual caption and the accessible `aria-valuetext`. It is not a slot - do not attempt to bind rich HTML or icon markup to it.\n\n```html\n<!-- INCORRECT -->\n<mds-benchmark-bar label=\"Stato\" value=\"80\" alias=\"<mds-badge variant='success'>OK</mds-badge>\"></mds-benchmark-bar>\n\n<!-- CORRECT -->\n<mds-benchmark-bar label=\"Stato\" value=\"80\" alias=\"Ottimo\"></mds-benchmark-bar>\n```\n\n#### Do Not Override `variant` to Express Visual Weight Alone\n\n`variant` is a semantic role (`primary`, `error`, `success`, `warning`, etc.). Do not choose it purely for the color it produces - choose it for what the metric means. Mixing semantic values for aesthetic reasons makes the chart misleading.\n\n```html\n<!-- INCORRECT: error red chosen because it \"looks bold\", not because it signals a problem -->\n<mds-benchmark-bar label=\"Popolarita del prodotto\" value=\"88\" variant=\"error\"></mds-benchmark-bar>\n\n<!-- CORRECT -->\n<mds-benchmark-bar label=\"Popolarita del prodotto\" value=\"88\" variant=\"success\"></mds-benchmark-bar>\n```\n\n#### Do Not Pierce the Shadow DOM to Style the Progress Bar\n\nUse the documented `::part(progress-bar)` surface to style the inner bar. Reaching into the shadow DOM via `>>>` or undocumented class selectors couples your code to the implementation and will break on minor releases.\n\n```css\n/* INCORRECT */\nmds-benchmark-bar >>> mds-progress {\n background-color: hotpink;\n}\n\n/* CORRECT */\n.my-context mds-benchmark-bar::part(progress-bar) {\n --mds-progress-color: rgb(var(--magma-accent-fg));\n}\n```\n"
33
33
  },
34
34
  "props": [
35
35
  {
@@ -0,0 +1,102 @@
1
+ <!--
2
+ GENERATED FILE - do not edit by hand.
3
+ Source of truth: src/components/mds-benchmark-bar/usage/ in the magma monorepo.
4
+ -->
5
+
6
+ # mds-benchmark-bar - examples
7
+
8
+ > The API of this component: [`AGENTS.md`](AGENTS.md).
9
+
10
+ Correct and idiomatic ways to use the `<mds-benchmark-bar>` component, ordered from most common to most specialized. The examples assume a working knowledge of the variant / tone ladders documented in [`agents/variants.md`](../../../../agents/variants.md) and the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).
11
+
12
+ #### Basic Benchmark via `label` and `value`
13
+
14
+ The canonical form. Set `label` for the caption text and `value` (0-100) for the fill. `label` is reflected as an attribute; `value` is not, so a value set from JavaScript does not show up in attribute selectors.
15
+
16
+ ```html
17
+ <mds-benchmark-bar label="Soddisfazione clienti" value="72"></mds-benchmark-bar>
18
+ ```
19
+
20
+ #### Multiple Bars in a List
21
+
22
+ Render several bars together to compare metrics. Each bar stands on its own; no parent wrapper is required.
23
+
24
+ ```html
25
+ <mds-benchmark-bar label="Qualita del servizio" value="85"></mds-benchmark-bar>
26
+ <mds-benchmark-bar label="Tempi di risposta" value="61"></mds-benchmark-bar>
27
+ <mds-benchmark-bar label="Risoluzione al primo contatto" value="44"></mds-benchmark-bar>
28
+ ```
29
+
30
+ #### Alias to Replace the Numeric Value
31
+
32
+ Use `alias` when you need to display a formatted or qualitative string instead of the raw number. The alias also becomes the accessible `aria-valuetext` announced to screen readers; without it they announce the number, as shown.
33
+
34
+ ```html
35
+ <!-- Show a grade label instead of the raw score -->
36
+ <mds-benchmark-bar
37
+ label="Punteggio complessivo"
38
+ value="68"
39
+ alias="Buono"
40
+ ></mds-benchmark-bar>
41
+
42
+ <!-- Show a ratio string -->
43
+ <mds-benchmark-bar
44
+ label="Attivita completate"
45
+ value="33"
46
+ alias="1 di 3"
47
+ ></mds-benchmark-bar>
48
+ ```
49
+
50
+ #### Variant for Semantic Color
51
+
52
+ `variant` controls the color theme of the progress bar. Pick the value that matches the meaning of the metric, not the color you want.
53
+
54
+ ```html
55
+ <!-- Neutral / default -->
56
+ <mds-benchmark-bar label="Utilizzo CPU" value="55" variant="dark"></mds-benchmark-bar>
57
+
58
+ <!-- Primary brand emphasis -->
59
+ <mds-benchmark-bar label="Avanzamento progetto" value="70" variant="primary"></mds-benchmark-bar>
60
+
61
+ <!-- Status: healthy -->
62
+ <mds-benchmark-bar label="Uptime mensile" value="99" variant="success"></mds-benchmark-bar>
63
+
64
+ <!-- Status: under threshold -->
65
+ <mds-benchmark-bar label="Scorte disponibili" value="18" variant="warning"></mds-benchmark-bar>
66
+
67
+ <!-- Status: critical -->
68
+ <mds-benchmark-bar label="Errori rilevati" value="82" variant="error"></mds-benchmark-bar>
69
+ ```
70
+
71
+ #### Size
72
+
73
+ `size` controls the height of the progress bar. Use `sm` for dense lists, `lg` / `xl` for hero metrics.
74
+
75
+ ```html
76
+ <mds-benchmark-bar label="Piccolo" value="40" size="sm"></mds-benchmark-bar>
77
+ <mds-benchmark-bar label="Medio (default)" value="40" size="md"></mds-benchmark-bar>
78
+ <mds-benchmark-bar label="Grande" value="40" size="lg"></mds-benchmark-bar>
79
+ <mds-benchmark-bar label="Extra grande" value="40" size="xl"></mds-benchmark-bar>
80
+ ```
81
+
82
+ #### Typography Scale
83
+
84
+ `typography` applies to both the label caption and the value text. Use `option` for compact contexts where the default `label` scale is too heavy.
85
+
86
+ ```html
87
+ <!-- Default scale -->
88
+ <mds-benchmark-bar label="Punteggio" value="76" typography="label"></mds-benchmark-bar>
89
+
90
+ <!-- Compact / denser scale -->
91
+ <mds-benchmark-bar label="Punteggio" value="76" typography="option"></mds-benchmark-bar>
92
+ ```
93
+
94
+ #### Styling Customization via `::part(progress-bar)`
95
+
96
+ The inner progress bar is exposed as the `progress-bar` shadow part. Use it to apply targeted overrides when the documented variant colors are insufficient - for example, to enforce a brand-specific fill in a narrow context.
97
+
98
+ ```css
99
+ .hero-metric mds-benchmark-bar::part(progress-bar) {
100
+ --mds-progress-color: rgb(var(--magma-accent-ai-fg));
101
+ }
102
+ ```
@@ -0,0 +1,77 @@
1
+ <!--
2
+ GENERATED FILE - do not edit by hand.
3
+ Source of truth: src/components/mds-benchmark-bar/usage/ in the magma monorepo.
4
+ -->
5
+
6
+ # mds-benchmark-bar - mistakes
7
+
8
+ > The API of this component: [`AGENTS.md`](AGENTS.md).
9
+
10
+ Common incorrect uses of `<mds-benchmark-bar>`. Each entry pairs the wrong form with the right one and a one-line reason. System-wide rules (boolean-as-string, shadow piercing, Tailwind color utilities, raw native event listening) live in [`agents/mistakes.md`](../../../../agents/mistakes.md) - they apply here too but are not repeated.
11
+
12
+ #### Do Not Put HTML in the Default Slot
13
+
14
+ The default slot is deprecated and accepts plain text only; HTML elements are unsupported and will not render correctly. Use the `label` prop for the caption.
15
+
16
+ ```html
17
+ <!-- INCORRECT -->
18
+ <mds-benchmark-bar value="60">
19
+ <strong>Completamento attivita</strong>
20
+ </mds-benchmark-bar>
21
+
22
+ <!-- CORRECT -->
23
+ <mds-benchmark-bar label="Completamento attivita" value="60"></mds-benchmark-bar>
24
+ ```
25
+
26
+ #### Do Not Set `value` Outside the 0-100 Range
27
+
28
+ The inner `<mds-progress>` reads a value above 100 as 100 and a negative one as 0, but the caption still shows the raw number, which then contradicts the bar. Clamp the value in your data layer before binding.
29
+
30
+ ```html
31
+ <!-- INCORRECT -->
32
+ <mds-benchmark-bar label="Richieste elaborate" value="1540"></mds-benchmark-bar>
33
+
34
+ <!-- CORRECT -->
35
+ <!-- normalize to 0-100 in your controller before binding -->
36
+ <mds-benchmark-bar label="Richieste elaborate" value="100"></mds-benchmark-bar>
37
+ ```
38
+
39
+ #### Do Not Use `alias` for Structurally Different Content
40
+
41
+ `alias` replaces the numeric value with a plain string in both the visual caption and the accessible `aria-valuetext`. It is not a slot - do not attempt to bind rich HTML or icon markup to it.
42
+
43
+ ```html
44
+ <!-- INCORRECT -->
45
+ <mds-benchmark-bar label="Stato" value="80" alias="<mds-badge variant='success'>OK</mds-badge>"></mds-benchmark-bar>
46
+
47
+ <!-- CORRECT -->
48
+ <mds-benchmark-bar label="Stato" value="80" alias="Ottimo"></mds-benchmark-bar>
49
+ ```
50
+
51
+ #### Do Not Override `variant` to Express Visual Weight Alone
52
+
53
+ `variant` is a semantic role (`primary`, `error`, `success`, `warning`, etc.). Do not choose it purely for the color it produces - choose it for what the metric means. Mixing semantic values for aesthetic reasons makes the chart misleading.
54
+
55
+ ```html
56
+ <!-- INCORRECT: error red chosen because it "looks bold", not because it signals a problem -->
57
+ <mds-benchmark-bar label="Popolarita del prodotto" value="88" variant="error"></mds-benchmark-bar>
58
+
59
+ <!-- CORRECT -->
60
+ <mds-benchmark-bar label="Popolarita del prodotto" value="88" variant="success"></mds-benchmark-bar>
61
+ ```
62
+
63
+ #### Do Not Pierce the Shadow DOM to Style the Progress Bar
64
+
65
+ Use the documented `::part(progress-bar)` surface to style the inner bar. Reaching into the shadow DOM via `>>>` or undocumented class selectors couples your code to the implementation and will break on minor releases.
66
+
67
+ ```css
68
+ /* INCORRECT */
69
+ mds-benchmark-bar >>> mds-progress {
70
+ background-color: hotpink;
71
+ }
72
+
73
+ /* CORRECT */
74
+ .my-context mds-benchmark-bar::part(progress-bar) {
75
+ --mds-progress-color: rgb(var(--magma-accent-fg));
76
+ }
77
+ ```
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-bibliography
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-bibliography>` web component renders a single citation entry formatted according to a recognized academic style. It is a presentational component that takes structured metadata (author, title, publisher, date, location, URL) and composes it into a styled, correctly-punctuated reference line, replacing the manual assembly of a bibliography string.
12
12
 
@@ -29,10 +29,10 @@ The `<mds-bibliography>` web component renders a single citation entry formatted
29
29
 
30
30
  ## Read next
31
31
 
32
- - [`pattern.md`](pattern.md) - correct usage, with examples
33
- - [`antipattern.md`](antipattern.md) - mistakes to avoid
32
+ - [`examples.md`](examples.md) - correct usage, from the most common case
33
+ - [`mistakes.md`](mistakes.md) - the wrong forms, each with the right one
34
34
  - [Storybook](https://magma-design-system.github.io/magma/storybook/?path=/docs/ui-bibliography--docs) - the live examples, in the published Storybook of `main`
35
- - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`anti-patterns.md`](../../../../agents/anti-patterns.md) - the rules shared by every component
35
+ - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`mistakes.md`](../../../../agents/mistakes.md) - the rules shared by every component
36
36
 
37
37
  ## Props
38
38
 
@@ -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",
@@ -20,8 +20,8 @@
20
20
  ],
21
21
  "usage": {
22
22
  "1. Description": "The `<mds-bibliography>` web component renders a single citation entry formatted according to a recognized academic style. It is a presentational component that takes structured metadata (author, title, publisher, date, location, URL) and composes it into a styled, correctly-punctuated reference line, replacing the manual assembly of a bibliography string.\n\n#### Semantic Behavior\n\n- **Citation formatting**: The `format` prop drives the entire output - field ordering, punctuation, separators, author-name abbreviation, and date layout. Switching formats re-composes the same metadata rather than just restyling it.\n- **Author parsing**: `author` is parsed, not displayed verbatim. Names are split on commas into multiple authors, first/last names are detected by position (first name first: `Mario Rossi`; the spaces around each name are ignored), and composite first or last names can be grouped with single or double quotation marks (e.g. `'Jhon Arthur' Doe`). Each author is then abbreviated per the active format (APA initials, MLA full first name).\n- **Date handling**: `date` accepts an ISO string or a numeric timestamp and renders inside a semantic `<time>` element; an invalid date renders as an empty date (APA keeps empty parentheses), and month names are localized in Italian.\n- **Link vs. plain title**: When both `name` and `url` are set, the title renders as a link (`target=\"_blank\"`) carrying the `rel` value; with `name` alone it renders as plain emphasized text, and without `name` there is no title at all.\n- **No slots**: Content is built entirely from props; the component does not project slotted children.\n\n#### Properties & Visual Configurations\n\n- **`format`** selects the citation standard (`'apa'`, `'mla'`, `'turabian'`) and is the primary behavioral switch; pick it to match the referencing convention required by the document. APA puts the date in parentheses right after the authors, MLA/Turabian place the date at the end, and each applies its own punctuation between location, publisher, and date.\n- **`rel`** sets the relationship attribute applied to the generated title link (`'external'` or `'author'`); it only takes effect when the title is rendered as a hyperlink.\n\n#### Other behavioral props\n\n- **`typography`** and **`variant`** set the text role and styling of the rendered citation; they affect appearance only, not the citation structure.\n",
23
- "2. Pattern": "Correct and idiomatic ways to use the `<mds-bibliography>` component, ordered from most common to most specialized. Patterns assume a working knowledge of the variant / tone ladders documented in [`agents/variants.md`](../../../../agents/variants.md) and the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Basic APA Citation (Default Format)\n\nThe default `format` is `'apa'`. Supply author, date, name, location, and publisher to produce a correctly punctuated APA reference line. APA places the date in parentheses immediately after the author list.\n\n```html\n<mds-bibliography\n author=\"Mario Rossi\"\n date=\"2021-03-15\"\n name=\"Fondamenti di diritto amministrativo\"\n location=\"Milano\"\n publisher=\"Maggioli Editore\"\n></mds-bibliography>\n```\n\n#### APA Citation With a Linked Title\n\nWhen both `name` and `url` are provided the title renders as a hyperlink opening in a new tab. The `rel` prop defaults to `'external'`; change it to `'author'` only when the URL points to an author profile.\n\n```html\n<mds-bibliography\n author=\"Mario Rossi\"\n date=\"2021-03-15\"\n name=\"Fondamenti di diritto amministrativo\"\n location=\"Milano\"\n publisher=\"Maggioli Editore\"\n url=\"https://www.maggioli.com/catalogo/fondamenti\"\n></mds-bibliography>\n```\n\n#### MLA Format\n\nSet `format=\"mla\"` for Modern Language Association style. The date moves to the end, after the publisher, and author names are formatted with the full first name rather than initials.\n\n```html\n<mds-bibliography\n format=\"mla\"\n author=\"Mario Rossi\"\n date=\"2021-03-15\"\n name=\"Fondamenti di diritto amministrativo\"\n location=\"Milano\"\n publisher=\"Maggioli Editore\"\n></mds-bibliography>\n```\n\n#### Turabian Format\n\n`format=\"turabian\"` follows the Kate Turabian style - same field order and punctuation as MLA when a publisher is given; without a publisher, the location ends with a comma instead of a period.\n\n```html\n<mds-bibliography\n format=\"turabian\"\n author=\"Mario Rossi\"\n date=\"2021-03-15\"\n name=\"Fondamenti di diritto amministrativo\"\n location=\"Milano\"\n publisher=\"Maggioli Editore\"\n></mds-bibliography>\n```\n\n#### Multiple Authors\n\nSeparate multiple authors with a comma, writing each name first name first; a space after the comma is fine. Composite first or last names that contain spaces must be wrapped in single or double quotation marks so the parser groups them correctly. The component joins authors with the format-appropriate separator (APA and Turabian: `&`, MLA: `e`).\n\n```html\n<!-- Two authors, both single-word first and last names -->\n<mds-bibliography\n author=\"Mario Rossi, Luigi Verdi\"\n date=\"2019-06-01\"\n name=\"Gestione del territorio\"\n publisher=\"Giuffre Editore\"\n></mds-bibliography>\n\n<!-- Composite first name and composite last name -->\n<mds-bibliography\n author=\"'Maria Grazia' Bianchi, Enrico 'De Luca'\"\n date=\"2020-11-20\"\n name=\"Appalti pubblici\"\n publisher=\"Il Sole 24 Ore\"\n></mds-bibliography>\n```\n\n#### Date From a Numeric Timestamp\n\n`date` accepts either an ISO date string or a numeric Unix timestamp (milliseconds as a string). The component parses both forms identically and renders the result inside a semantic `<time>` element.\n\n```html\n<!-- ISO string -->\n<mds-bibliography\n author=\"Luca Ferrari\"\n date=\"2018-09-10\"\n name=\"Intelligenza artificiale e diritto\"\n publisher=\"Giuffre Editore\"\n></mds-bibliography>\n\n<!-- Numeric timestamp (milliseconds) -->\n<mds-bibliography\n author=\"Luca Ferrari\"\n date=\"1536537600000\"\n name=\"Intelligenza artificiale e diritto\"\n publisher=\"Giuffre Editore\"\n></mds-bibliography>\n```\n\n#### Adjusting Typography\n\nThe `typography` prop controls the text role (`'caption'`, `'detail'` [default], `'label'`, `'option'`, `'paragraph'`, `'tip'`). Use `variant` to apply a style variant inside that role. Change these when the citation must match its surrounding body copy.\n\n```html\n<!-- Use paragraph size inside a long-form article -->\n<mds-bibliography\n format=\"apa\"\n author=\"Francesca Conti\"\n date=\"2022-05-18\"\n name=\"Sociologia del lavoro pubblico\"\n publisher=\"Laterza\"\n typography=\"paragraph\"\n variant=\"read\"\n></mds-bibliography>\n```\n\n#### Styling Customization\n\nStyle the link color through the public `--mds-bibliography-color` CSS custom property; the underline colors are not public and follow the theme. Use semantic color roles via `rgb(var(--magma-<role>))` so dark mode and high-contrast modes keep working.\n\n```css\n.riferimenti mds-bibliography {\n --mds-bibliography-color: rgb(var(--magma-accent-fg));\n}\n```\n",
24
- "3. Antipattern": "Common incorrect uses of `<mds-bibliography>`. Each entry pairs the wrong form with the right one and a one-line reason. System-wide rules (boolean-as-string, shadow piercing, Tailwind color utilities, raw native event listening) live in [`agents/anti-patterns.md`](../../../../agents/anti-patterns.md) - they apply here too but are not repeated.\n\n#### Do Not Slot Content - The Component Has No Slots\n\n`<mds-bibliography>` builds its output entirely from props; it has no default slot and no named slots. Any children placed inside the tag are ignored.\n\n```html\n<!-- INCORRECT -->\n<mds-bibliography>\n Rossi, M. (2021). <em>Fondamenti di diritto amministrativo</em>. Maggioli Editore.\n</mds-bibliography>\n\n<!-- CORRECT -->\n<mds-bibliography\n author=\"Mario Rossi\"\n date=\"2021-03-15\"\n name=\"Fondamenti di diritto amministrativo\"\n publisher=\"Maggioli Editore\"\n></mds-bibliography>\n```\n\n#### Do Not Use `url` Without `name`\n\nWhen `name` is absent the component renders no title element, so `url` has nowhere to attach and the hyperlink is never created. Always supply `name` together with `url`.\n\n```html\n<!-- INCORRECT -->\n<mds-bibliography\n author=\"Giulia Bianchi\"\n date=\"2020-06-01\"\n url=\"https://www.maggioli.com/catalogo/appalti\"\n></mds-bibliography>\n\n<!-- CORRECT -->\n<mds-bibliography\n author=\"Giulia Bianchi\"\n date=\"2020-06-01\"\n name=\"Appalti pubblici: guida pratica\"\n url=\"https://www.maggioli.com/catalogo/appalti\"\n></mds-bibliography>\n```\n\n#### Do Not Pass an Author Array as a JavaScript Array Literal in HTML\n\nThe `author` prop expects a plain comma-separated string. In HTML the bracket or JSON syntax is not a supported format, even where the parser happens to read it. Set from JavaScript, an array is read as one author per entry, but the prop is typed as a string: prefer the comma-separated form there too.\n\n```html\n<!-- INCORRECT -->\n<mds-bibliography\n author=\"['Mario Rossi', 'Luigi Verdi']\"\n name=\"Gestione del territorio\"\n></mds-bibliography>\n\n<!-- CORRECT -->\n<mds-bibliography\n author=\"Mario Rossi,Luigi Verdi\"\n name=\"Gestione del territorio\"\n></mds-bibliography>\n```\n\n#### Do Not Use `rel` Without a URL\n\nThe `rel` attribute only takes effect when the title is rendered as a hyperlink (i.e. when both `name` and `url` are set). Setting `rel=\"author\"` alone has no semantic effect and may confuse automated link checkers that scan for `rel` on anchors.\n\n```html\n<!-- INCORRECT -->\n<mds-bibliography\n author=\"Enrico 'De Luca'\"\n name=\"Sociologia delle organizzazioni\"\n rel=\"author\"\n></mds-bibliography>\n\n<!-- CORRECT -->\n<mds-bibliography\n author=\"Enrico 'De Luca'\"\n name=\"Sociologia delle organizzazioni\"\n url=\"https://www.maggioli.com/catalogo/sociologia\"\n rel=\"author\"\n></mds-bibliography>\n```\n\n#### Do Not Invent a `format` Value Outside the Three Accepted Styles\n\nOnly `'apa'`, `'mla'`, and `'turabian'` are valid. Passing an unrecognised string leaves the format branch unmatched and renders only the author portion (no date, title, location, or publisher).\n\n```html\n<!-- INCORRECT -->\n<mds-bibliography\n format=\"chicago\"\n author=\"Francesca Conti\"\n name=\"Sociologia del lavoro pubblico\"\n></mds-bibliography>\n\n<!-- CORRECT -->\n<mds-bibliography\n format=\"turabian\"\n author=\"Francesca Conti\"\n name=\"Sociologia del lavoro pubblico\"\n></mds-bibliography>\n```\n\n#### Customize via Documented CSS Vars, Not Internal Selectors\n\nThe supported customization surface is the public `--mds-bibliography-color` CSS custom property. Targeting the `.link` class or other internals via shadow-piercing selectors or undocumented `::part()` names couples your code to the implementation and will break on minor releases.\n\n```css\n/* INCORRECT */\nmds-bibliography >>> .link {\n color: blue;\n}\nmds-bibliography::part(link) {\n text-decoration: none;\n}\n\n/* CORRECT */\n.sezione-riferimenti mds-bibliography {\n --mds-bibliography-color: rgb(var(--magma-accent-fg));\n}\n```\n"
23
+ "2. Examples": "Correct and idiomatic ways to use the `<mds-bibliography>` component, ordered from most common to most specialized. The examples assume a working knowledge of the variant / tone ladders documented in [`agents/variants.md`](../../../../agents/variants.md) and the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Basic APA Citation (Default Format)\n\nThe default `format` is `'apa'`. Supply author, date, name, location, and publisher to produce a correctly punctuated APA reference line. APA places the date in parentheses immediately after the author list.\n\n```html\n<mds-bibliography\n author=\"Mario Rossi\"\n date=\"2021-03-15\"\n name=\"Fondamenti di diritto amministrativo\"\n location=\"Milano\"\n publisher=\"Maggioli Editore\"\n></mds-bibliography>\n```\n\n#### APA Citation With a Linked Title\n\nWhen both `name` and `url` are provided the title renders as a hyperlink opening in a new tab. The `rel` prop defaults to `'external'`; change it to `'author'` only when the URL points to an author profile.\n\n```html\n<mds-bibliography\n author=\"Mario Rossi\"\n date=\"2021-03-15\"\n name=\"Fondamenti di diritto amministrativo\"\n location=\"Milano\"\n publisher=\"Maggioli Editore\"\n url=\"https://www.maggioli.com/catalogo/fondamenti\"\n></mds-bibliography>\n```\n\n#### MLA Format\n\nSet `format=\"mla\"` for Modern Language Association style. The date moves to the end, after the publisher, and author names are formatted with the full first name rather than initials.\n\n```html\n<mds-bibliography\n format=\"mla\"\n author=\"Mario Rossi\"\n date=\"2021-03-15\"\n name=\"Fondamenti di diritto amministrativo\"\n location=\"Milano\"\n publisher=\"Maggioli Editore\"\n></mds-bibliography>\n```\n\n#### Turabian Format\n\n`format=\"turabian\"` follows the Kate Turabian style - same field order and punctuation as MLA when a publisher is given; without a publisher, the location ends with a comma instead of a period.\n\n```html\n<mds-bibliography\n format=\"turabian\"\n author=\"Mario Rossi\"\n date=\"2021-03-15\"\n name=\"Fondamenti di diritto amministrativo\"\n location=\"Milano\"\n publisher=\"Maggioli Editore\"\n></mds-bibliography>\n```\n\n#### Multiple Authors\n\nSeparate multiple authors with a comma, writing each name first name first; a space after the comma is fine. Composite first or last names that contain spaces must be wrapped in single or double quotation marks so the parser groups them correctly. The component joins authors with the format-appropriate separator (APA and Turabian: `&`, MLA: `e`).\n\n```html\n<!-- Two authors, both single-word first and last names -->\n<mds-bibliography\n author=\"Mario Rossi, Luigi Verdi\"\n date=\"2019-06-01\"\n name=\"Gestione del territorio\"\n publisher=\"Giuffre Editore\"\n></mds-bibliography>\n\n<!-- Composite first name and composite last name -->\n<mds-bibliography\n author=\"'Maria Grazia' Bianchi, Enrico 'De Luca'\"\n date=\"2020-11-20\"\n name=\"Appalti pubblici\"\n publisher=\"Il Sole 24 Ore\"\n></mds-bibliography>\n```\n\n#### Date From a Numeric Timestamp\n\n`date` accepts either an ISO date string or a numeric Unix timestamp (milliseconds as a string). The component parses both forms identically and renders the result inside a semantic `<time>` element.\n\n```html\n<!-- ISO string -->\n<mds-bibliography\n author=\"Luca Ferrari\"\n date=\"2018-09-10\"\n name=\"Intelligenza artificiale e diritto\"\n publisher=\"Giuffre Editore\"\n></mds-bibliography>\n\n<!-- Numeric timestamp (milliseconds) -->\n<mds-bibliography\n author=\"Luca Ferrari\"\n date=\"1536537600000\"\n name=\"Intelligenza artificiale e diritto\"\n publisher=\"Giuffre Editore\"\n></mds-bibliography>\n```\n\n#### Adjusting Typography\n\nThe `typography` prop controls the text role (`'caption'`, `'detail'` [default], `'label'`, `'option'`, `'paragraph'`, `'tip'`). Use `variant` to apply a style variant inside that role. Change these when the citation must match its surrounding body copy.\n\n```html\n<!-- Use paragraph size inside a long-form article -->\n<mds-bibliography\n format=\"apa\"\n author=\"Francesca Conti\"\n date=\"2022-05-18\"\n name=\"Sociologia del lavoro pubblico\"\n publisher=\"Laterza\"\n typography=\"paragraph\"\n variant=\"read\"\n></mds-bibliography>\n```\n\n#### Styling Customization\n\nStyle the link color through the public `--mds-bibliography-color` CSS custom property; the underline colors are not public and follow the theme. Use semantic color roles via `rgb(var(--magma-<role>))` so dark mode and high-contrast modes keep working.\n\n```css\n.riferimenti mds-bibliography {\n --mds-bibliography-color: rgb(var(--magma-accent-fg));\n}\n```\n",
24
+ "3. Mistakes": "Common incorrect uses of `<mds-bibliography>`. Each entry pairs the wrong form with the right one and a one-line reason. System-wide rules (boolean-as-string, shadow piercing, Tailwind color utilities, raw native event listening) live in [`agents/mistakes.md`](../../../../agents/mistakes.md) - they apply here too but are not repeated.\n\n#### Do Not Slot Content - The Component Has No Slots\n\n`<mds-bibliography>` builds its output entirely from props; it has no default slot and no named slots. Any children placed inside the tag are ignored.\n\n```html\n<!-- INCORRECT -->\n<mds-bibliography>\n Rossi, M. (2021). <em>Fondamenti di diritto amministrativo</em>. Maggioli Editore.\n</mds-bibliography>\n\n<!-- CORRECT -->\n<mds-bibliography\n author=\"Mario Rossi\"\n date=\"2021-03-15\"\n name=\"Fondamenti di diritto amministrativo\"\n publisher=\"Maggioli Editore\"\n></mds-bibliography>\n```\n\n#### Do Not Use `url` Without `name`\n\nWhen `name` is absent the component renders no title element, so `url` has nowhere to attach and the hyperlink is never created. Always supply `name` together with `url`.\n\n```html\n<!-- INCORRECT -->\n<mds-bibliography\n author=\"Giulia Bianchi\"\n date=\"2020-06-01\"\n url=\"https://www.maggioli.com/catalogo/appalti\"\n></mds-bibliography>\n\n<!-- CORRECT -->\n<mds-bibliography\n author=\"Giulia Bianchi\"\n date=\"2020-06-01\"\n name=\"Appalti pubblici: guida pratica\"\n url=\"https://www.maggioli.com/catalogo/appalti\"\n></mds-bibliography>\n```\n\n#### Do Not Pass an Author Array as a JavaScript Array Literal in HTML\n\nThe `author` prop expects a plain comma-separated string. In HTML the bracket or JSON syntax is not a supported format, even where the parser happens to read it. Set from JavaScript, an array is read as one author per entry, but the prop is typed as a string: prefer the comma-separated form there too.\n\n```html\n<!-- INCORRECT -->\n<mds-bibliography\n author=\"['Mario Rossi', 'Luigi Verdi']\"\n name=\"Gestione del territorio\"\n></mds-bibliography>\n\n<!-- CORRECT -->\n<mds-bibliography\n author=\"Mario Rossi,Luigi Verdi\"\n name=\"Gestione del territorio\"\n></mds-bibliography>\n```\n\n#### Do Not Use `rel` Without a URL\n\nThe `rel` attribute only takes effect when the title is rendered as a hyperlink (i.e. when both `name` and `url` are set). Setting `rel=\"author\"` alone has no semantic effect and may confuse automated link checkers that scan for `rel` on anchors.\n\n```html\n<!-- INCORRECT -->\n<mds-bibliography\n author=\"Enrico 'De Luca'\"\n name=\"Sociologia delle organizzazioni\"\n rel=\"author\"\n></mds-bibliography>\n\n<!-- CORRECT -->\n<mds-bibliography\n author=\"Enrico 'De Luca'\"\n name=\"Sociologia delle organizzazioni\"\n url=\"https://www.maggioli.com/catalogo/sociologia\"\n rel=\"author\"\n></mds-bibliography>\n```\n\n#### Do Not Invent a `format` Value Outside the Three Accepted Styles\n\nOnly `'apa'`, `'mla'`, and `'turabian'` are valid. Passing an unrecognised string leaves the format branch unmatched and renders only the author portion (no date, title, location, or publisher).\n\n```html\n<!-- INCORRECT -->\n<mds-bibliography\n format=\"chicago\"\n author=\"Francesca Conti\"\n name=\"Sociologia del lavoro pubblico\"\n></mds-bibliography>\n\n<!-- CORRECT -->\n<mds-bibliography\n format=\"turabian\"\n author=\"Francesca Conti\"\n name=\"Sociologia del lavoro pubblico\"\n></mds-bibliography>\n```\n\n#### Customize via Documented CSS Vars, Not Internal Selectors\n\nThe supported customization surface is the public `--mds-bibliography-color` CSS custom property. Targeting the `.link` class or other internals via shadow-piercing selectors or undocumented `::part()` names couples your code to the implementation and will break on minor releases.\n\n```css\n/* INCORRECT */\nmds-bibliography >>> .link {\n color: blue;\n}\nmds-bibliography::part(link) {\n text-decoration: none;\n}\n\n/* CORRECT */\n.sezione-riferimenti mds-bibliography {\n --mds-bibliography-color: rgb(var(--magma-accent-fg));\n}\n```\n"
25
25
  },
26
26
  "props": [
27
27
  {