@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
@@ -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-push-notification>` web component is the Magma Design System container that hosts and orchestrates a stack of transient notification items, managing their show/hide lifecycle, entry/exit animations, and overall visibility. It is a compound parent: its default slot holds `mds-push-notification-item` children, and it has no direct HTML primitive equivalent.\n\n#### Semantic Behavior\n\n- **Slot-driven lifecycle**: Items placed in the default slot are animated in automatically; each item animates out and is removed when closed (an item shows its close button only with `dismissible`).\n- **Built-in clear button**: The container always renders its own clear button, labelled in the page language (\"Clear notifications\", \"Cancella notifiche\"), which animates out every item and hides the container.\n- **Auto vs. manual behavior**: With `behavior=\"auto\"` the container shows itself as soon as one or more items are added; with `behavior=\"manual\"` visibility is driven only by the `visible` prop or the imperative methods.\n- **Empty-stack auto-hide**: When the last remaining item animates out, the container hides itself regardless of behavior; the clear button and `hide()` hide it too.\n- **Emitted events**: `mdsPushNotificationShow` fires when it becomes visible, `mdsPushNotificationHide` when hidden, and `mdsPushNotificationChange` on every transition carrying a `{ visible: boolean }` detail.\n- **Imperative API**: Exposes `show()` and `hide()` methods to control visibility programmatically, plus `removeNotification()` to dismiss one or an array of `mds-push-notification-item` elements with the standard outro animation.\n- **Animation timing**: The intro and outro motion of the items is set by the component; the fade-out delay and the gap between items are read from the public CSS custom properties `--mds-push-notification-fadeout-delay` and `--mds-push-notification-gap`, so they are themeable without code changes.\n\n#### Properties & Visual Configurations\n\nThe container intentionally exposes a minimal prop surface; most configuration is structural (which items you slot in) or stylistic (via CSS custom properties).\n\n#### Other behavioral props\n\n- **`behavior`** selects the visibility strategy: pick `'auto'` (default) when the stack should appear and disappear purely as a function of how many items it contains, and `'manual'` when you want explicit control over when the container is shown via `visible` or the `show()`/`hide()` methods.\n- **`visible`** is the controlled visibility flag; set it to drive the container open or closed, while reading it returns the current visibility.\n",
31
- "2. Pattern": "Correct and idiomatic ways to use the `<mds-push-notification>` component, ordered from most common to most specialized. Patterns assume a working knowledge of the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Minimal Auto-Managed Stack\n\nThe default `behavior=\"auto\"` configuration. Drop `mds-push-notification-item` children into the default slot and the container shows itself, animates each item in, and hides itself when all items have been dismissed. Set `dismissible` on an item to give it its own close button.\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n dismissible\n subject=\"Nuovo messaggio\"\n message=\"Il documento e' pronto per la revisione.\"\n ></mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Items with Avatar Preview\n\nUse `preview=\"avatar\"` and `src` to show a user photo. Supply `initials` as a fallback when no image is available.\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n preview=\"avatar\"\n src=\"/avatars/marco.jpg\"\n initials=\"MC\"\n subject=\"Marco Cicognetti\"\n message=\"Ci sei andato poi alla riunione?\"\n ></mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Items with Icon Preview\n\nUse `icon` (an icon slug with its set prefix) instead of `src` when the notification represents an event or system action rather than a person.\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n icon=\"mi/baseline/attachment\"\n subject=\"Documento allegato\"\n message=\"E' stato caricato un nuovo allegato nella pratica 2024-1042.\"\n ></mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Item with Date and Timestamp\n\nPass an ISO 8601 datetime string to display a relative time-ago label (default) or a static formatted date.\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n subject=\"Approvazione completata\"\n message=\"La richiesta e' stata approvata.\"\n datetime=\"2024-11-12T09:30:00Z\"\n ></mds-push-notification-item>\n\n <!-- Static date format -->\n <mds-push-notification-item\n subject=\"Scadenza contratto\"\n message=\"Il contratto scade il giorno indicato.\"\n datetime=\"2024-12-31T00:00:00Z\"\n date-format=\"DD/MM/YYYY\"\n ></mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Item with Action Button\n\nSlot an `mds-button` into the `action` slot of the item to provide an inline CTA.\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n preview=\"avatar\"\n src=\"/avatars/sara.jpg\"\n subject=\"Sara Ho\"\n message=\"Hai ricevuto una nuova richiesta di collaborazione.\"\n >\n <mds-button slot=\"action\" variant=\"primary\" tone=\"weak\" size=\"sm\">\n Rispondi\n </mds-button>\n </mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Manual Behavior with Programmatic Control\n\nSet `behavior=\"manual\"` when visibility should be controlled by your application logic rather than inferred from slot contents. Toggle the `visible` attribute or call `show()` / `hide()` on the element.\n\n```html\n<mds-push-notification behavior=\"manual\" id=\"notif-panel\">\n <mds-push-notification-item\n subject=\"Aggiornamento sistema\"\n message=\"Un aggiornamento e' disponibile. Riavviare per applicarlo.\"\n ></mds-push-notification-item>\n</mds-push-notification>\n\n<script>\n const panel = document.querySelector('#notif-panel');\n\n // Show programmatically\n panel.show();\n\n // Hide programmatically\n panel.hide();\n</script>\n```\n\n#### Programmatic Dismissal of a Single Item\n\nCall `removeNotification()` with an `mds-push-notification-item` element reference to animate it out and remove it without the user interacting with the close button.\n\n```html\n<mds-push-notification id=\"notif-panel\">\n <mds-push-notification-item id=\"item-1\"\n subject=\"Avviso temporaneo\"\n message=\"Questa notifica viene rimossa dopo 5 secondi.\"\n ></mds-push-notification-item>\n</mds-push-notification>\n\n<script>\n const panel = document.querySelector('#notif-panel');\n const item = document.querySelector('#item-1');\n\n setTimeout(() => {\n panel.removeNotification(item);\n }, 5000);\n</script>\n```\n\n#### Reacting to Visibility Events\n\nListen to `mdsPushNotificationShow`, `mdsPushNotificationHide`, or `mdsPushNotificationChange` to synchronize UI state when the panel opens or closes.\n\n```javascript\nconst panel = document.querySelector('mds-push-notification');\n\npanel.addEventListener('mdsPushNotificationShow', () => {\n console.info('Pannello notifiche aperto');\n});\n\npanel.addEventListener('mdsPushNotificationHide', () => {\n console.info('Pannello notifiche chiuso');\n});\n\npanel.addEventListener('mdsPushNotificationChange', (e) => {\n console.info('Visibilita cambiata:', e.detail.visible);\n});\n```\n\n#### Item Tone and Variant\n\nUse `variant` and `tone` on the item to reflect the semantic nature of the notification (status or theme family). `tone` accepts `strong` or `weak` on this component. They paint the item's icon or avatar preview, so they show only together with `icon` (or `preview=\"avatar\"`).\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n icon=\"mi/baseline/check-circle\"\n variant=\"success\"\n tone=\"weak\"\n subject=\"Operazione completata\"\n message=\"Il file e' stato salvato con successo.\"\n ></mds-push-notification-item>\n\n <mds-push-notification-item\n icon=\"mi/baseline/error\"\n variant=\"error\"\n tone=\"strong\"\n subject=\"Errore critico\"\n message=\"Impossibile completare l'operazione. Riprovare.\"\n ></mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Styling Customization via CSS Custom Properties\n\nOverride the fade-out delay, the gap between items, and the panel background through the public `--mds-push-notification-*` properties; the intro and outro motion of the items is set by the component. Set them on the host or a parent selector; for colours name a semantic role, `rgb(var(--magma-<role>))` ([`agents/color.md`](../../../../agents/color.md)).\n\n```css\nmds-push-notification {\n --mds-push-notification-gap: calc(var(--spacing) * 300);\n --mds-push-notification-fadeout-delay: 0.5s;\n --mds-push-notification-background: linear-gradient(\n to right,\n rgb(var(--magma-surface-overlay) / 0) 0%,\n rgb(var(--magma-surface-overlay) / 0.95) 100%\n );\n}\n```\n",
32
- "3. Antipattern": "Common incorrect uses of `<mds-push-notification>`. 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 Arbitrary HTML in the Default Slot\n\nThe default slot is designed for `mds-push-notification-item` children only. Placing raw HTML or other components breaks the animation lifecycle, event wiring, and the intro/outro sequencing the container manages.\n\n```html\n<!-- INCORRECT -->\n<mds-push-notification>\n <div class=\"my-notification\">\n <strong>Avviso</strong>\n <p>Il documento e' pronto.</p>\n </div>\n</mds-push-notification>\n\n<!-- CORRECT -->\n<mds-push-notification>\n <mds-push-notification-item\n subject=\"Avviso\"\n message=\"Il documento e' pronto.\"\n ></mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Do Not Set `visible=\"false\"` to Hide the Panel\n\n`visible` is a boolean prop: a false boolean is written by removing the attribute, the convention for every Magma boolean ([`agents/conventions.md`](../../../../agents/conventions.md)). Stencil does parse `\"false\"` as `false`, but the attribute stays in the markup until the component hydrates and its reflection removes it, so a `[visible]` selector or any code reading the attribute sees it set in the meantime. Remove the attribute entirely - or call `hide()` - to close the panel.\n\n```html\n<!-- INCORRECT -->\n<mds-push-notification visible=\"false\"></mds-push-notification>\n\n<!-- CORRECT: remove the attribute -->\n<mds-push-notification></mds-push-notification>\n```\n\n```javascript\n// CORRECT: via imperative method\ndocument.querySelector('mds-push-notification').hide();\n```\n\n#### Do Not Listen to the Native `close` Event Instead of `mdsPushNotificationHide`\n\nThe component emits `mdsPushNotificationHide` when the panel hides. Listening for a native `close` event will never fire because the component does not dispatch it, and native DOM events from inside the shadow root do not reliably bubble to the light DOM.\n\n```javascript\n// INCORRECT\npanel.addEventListener('close', () => updateUI());\n\n// CORRECT\npanel.addEventListener('mdsPushNotificationHide', () => updateUI());\n```\n\n#### Do Not Use `behavior=\"manual\"` and Then Forget to Call `show()` / `hide()`\n\nWith `behavior=\"manual\"` the container never auto-shows when items are added; you must explicitly call `show()` or set `visible`. Leaving it on `manual` without wiring visibility logic means notifications are silently queued but never displayed.\n\n```html\n<!-- INCORRECT: items never appear because manual mode needs explicit show() -->\n<mds-push-notification behavior=\"manual\" id=\"notif-panel\">\n <mds-push-notification-item\n subject=\"Nuovo messaggio\"\n message=\"Messaggio ricevuto.\"\n ></mds-push-notification-item>\n</mds-push-notification>\n\n<!-- CORRECT: call show() after adding items -->\n<mds-push-notification behavior=\"manual\" id=\"notif-panel\">\n <mds-push-notification-item\n subject=\"Nuovo messaggio\"\n message=\"Messaggio ricevuto.\"\n ></mds-push-notification-item>\n</mds-push-notification>\n\n<script>\n document.querySelector('#notif-panel').show();\n</script>\n```\n\n#### Do Not Pierce Shadow DOM to Style Item Internals\n\nThe only supported customization surface for the container is the public `--mds-push-notification-*` CSS custom properties plus the documented `::part(notifications)` part. Use the public per-item CSS custom properties (prefixed `--mds-push-notification-item-*`) for item-level styling. Do not reach into shadow parts that are not documented.\n\n```css\n/* INCORRECT */\nmds-push-notification >>> .notifications {\n background: white;\n}\nmds-push-notification::part(content) {\n padding: 2rem;\n}\n\n/* CORRECT */\nmds-push-notification {\n --mds-push-notification-background: rgb(var(--magma-surface-overlay) / 0.9);\n --mds-push-notification-gap: calc(var(--spacing) * 300);\n}\nmds-push-notification::part(notifications) {\n /* documented part - safe to target */\n padding-block: calc(var(--spacing) * 200);\n}\n```\n\n#### Do Not Slot Actions in the Wrong Slot\n\nAction buttons belong in the `action` slot of `mds-push-notification-item`, not in the default slot of `mds-push-notification`. Placing a button in the parent's default slot treats it like a notification item, breaks the animation sequence, and the button will be styled and animated as if it were a notification. A clear-all button is not needed either: the container renders its own.\n\n```html\n<!-- INCORRECT: button lands in the parent's default slot -->\n<mds-push-notification>\n <mds-button variant=\"dark\">Cancella tutto</mds-button>\n <mds-push-notification-item subject=\"Avviso\" message=\"Nuovo messaggio.\"></mds-push-notification-item>\n</mds-push-notification>\n\n<!-- CORRECT: action belongs on the item's action slot -->\n<mds-push-notification>\n <mds-push-notification-item subject=\"Avviso\" message=\"Nuovo messaggio.\">\n <mds-button slot=\"action\" variant=\"primary\" tone=\"weak\" size=\"sm\">Apri</mds-button>\n </mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Do Not Apply an Unsupported `tone` Value to Item\n\n`mds-push-notification-item` accepts `tone=\"strong\"` or `tone=\"weak\"` only (`ToneMinimalVariantType`). Using `tone=\"outline\"` (a tone of `mds-button` and `mds-badge`) silently falls back to the default `weak` look and the intended visual emphasis is lost. `variant` and `tone` paint only the item's icon or avatar, so pair them with `icon`.\n\n```html\n<!-- INCORRECT: outline and text are not supported tones for this component -->\n<mds-push-notification-item\n icon=\"mi/baseline/error\"\n variant=\"error\"\n tone=\"outline\"\n subject=\"Errore\"\n message=\"Operazione fallita.\"\n></mds-push-notification-item>\n\n<!-- CORRECT -->\n<mds-push-notification-item\n icon=\"mi/baseline/error\"\n variant=\"error\"\n tone=\"strong\"\n subject=\"Errore\"\n message=\"Operazione fallita.\"\n></mds-push-notification-item>\n```\n"
31
+ "2. Examples": "Correct and idiomatic ways to use the `<mds-push-notification>` component, ordered from most common to most specialized. The examples assume a working knowledge of the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Minimal Auto-Managed Stack\n\nThe default `behavior=\"auto\"` configuration. Drop `mds-push-notification-item` children into the default slot and the container shows itself, animates each item in, and hides itself when all items have been dismissed. Set `dismissible` on an item to give it its own close button.\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n dismissible\n subject=\"Nuovo messaggio\"\n message=\"Il documento e' pronto per la revisione.\"\n ></mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Items with Avatar Preview\n\nUse `preview=\"avatar\"` and `src` to show a user photo. Supply `initials` as a fallback when no image is available.\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n preview=\"avatar\"\n src=\"/avatars/marco.jpg\"\n initials=\"MC\"\n subject=\"Marco Cicognetti\"\n message=\"Ci sei andato poi alla riunione?\"\n ></mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Items with Icon Preview\n\nUse `icon` (an icon slug with its set prefix) instead of `src` when the notification represents an event or system action rather than a person.\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n icon=\"mi/baseline/attachment\"\n subject=\"Documento allegato\"\n message=\"E' stato caricato un nuovo allegato nella pratica 2024-1042.\"\n ></mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Item with Date and Timestamp\n\nPass an ISO 8601 datetime string to display a relative time-ago label (default) or a static formatted date.\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n subject=\"Approvazione completata\"\n message=\"La richiesta e' stata approvata.\"\n datetime=\"2024-11-12T09:30:00Z\"\n ></mds-push-notification-item>\n\n <!-- Static date format -->\n <mds-push-notification-item\n subject=\"Scadenza contratto\"\n message=\"Il contratto scade il giorno indicato.\"\n datetime=\"2024-12-31T00:00:00Z\"\n date-format=\"DD/MM/YYYY\"\n ></mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Item with Action Button\n\nSlot an `mds-button` into the `action` slot of the item to provide an inline CTA.\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n preview=\"avatar\"\n src=\"/avatars/sara.jpg\"\n subject=\"Sara Ho\"\n message=\"Hai ricevuto una nuova richiesta di collaborazione.\"\n >\n <mds-button slot=\"action\" variant=\"primary\" tone=\"weak\" size=\"sm\">\n Rispondi\n </mds-button>\n </mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Manual Behavior with Programmatic Control\n\nSet `behavior=\"manual\"` when visibility should be controlled by your application logic rather than inferred from slot contents. Toggle the `visible` attribute or call `show()` / `hide()` on the element.\n\n```html\n<mds-push-notification behavior=\"manual\" id=\"notif-panel\">\n <mds-push-notification-item\n subject=\"Aggiornamento sistema\"\n message=\"Un aggiornamento e' disponibile. Riavviare per applicarlo.\"\n ></mds-push-notification-item>\n</mds-push-notification>\n\n<script>\n const panel = document.querySelector('#notif-panel');\n\n // Show programmatically\n panel.show();\n\n // Hide programmatically\n panel.hide();\n</script>\n```\n\n#### Programmatic Dismissal of a Single Item\n\nCall `removeNotification()` with an `mds-push-notification-item` element reference to animate it out and remove it without the user interacting with the close button.\n\n```html\n<mds-push-notification id=\"notif-panel\">\n <mds-push-notification-item id=\"item-1\"\n subject=\"Avviso temporaneo\"\n message=\"Questa notifica viene rimossa dopo 5 secondi.\"\n ></mds-push-notification-item>\n</mds-push-notification>\n\n<script>\n const panel = document.querySelector('#notif-panel');\n const item = document.querySelector('#item-1');\n\n setTimeout(() => {\n panel.removeNotification(item);\n }, 5000);\n</script>\n```\n\n#### Reacting to Visibility Events\n\nListen to `mdsPushNotificationShow`, `mdsPushNotificationHide`, or `mdsPushNotificationChange` to synchronize UI state when the panel opens or closes.\n\n```javascript\nconst panel = document.querySelector('mds-push-notification');\n\npanel.addEventListener('mdsPushNotificationShow', () => {\n console.info('Pannello notifiche aperto');\n});\n\npanel.addEventListener('mdsPushNotificationHide', () => {\n console.info('Pannello notifiche chiuso');\n});\n\npanel.addEventListener('mdsPushNotificationChange', (e) => {\n console.info('Visibilita cambiata:', e.detail.visible);\n});\n```\n\n#### Item Tone and Variant\n\nUse `variant` and `tone` on the item to reflect the semantic nature of the notification (status or theme family). `tone` accepts `strong` or `weak` on this component. They paint the item's icon or avatar preview, so they show only together with `icon` (or `preview=\"avatar\"`).\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n icon=\"mi/baseline/check-circle\"\n variant=\"success\"\n tone=\"weak\"\n subject=\"Operazione completata\"\n message=\"Il file e' stato salvato con successo.\"\n ></mds-push-notification-item>\n\n <mds-push-notification-item\n icon=\"mi/baseline/error\"\n variant=\"error\"\n tone=\"strong\"\n subject=\"Errore critico\"\n message=\"Impossibile completare l'operazione. Riprovare.\"\n ></mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Styling Customization via CSS Custom Properties\n\nOverride the fade-out delay, the gap between items, and the panel background through the public `--mds-push-notification-*` properties; the intro and outro motion of the items is set by the component. Set them on the host or a parent selector; for colours name a semantic role, `rgb(var(--magma-<role>))` ([`agents/color.md`](../../../../agents/color.md)).\n\n```css\nmds-push-notification {\n --mds-push-notification-gap: calc(var(--spacing) * 300);\n --mds-push-notification-fadeout-delay: 0.5s;\n --mds-push-notification-background: linear-gradient(\n to right,\n rgb(var(--magma-surface-overlay) / 0) 0%,\n rgb(var(--magma-surface-overlay) / 0.95) 100%\n );\n}\n```\n",
32
+ "3. Mistakes": "Common incorrect uses of `<mds-push-notification>`. 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 Arbitrary HTML in the Default Slot\n\nThe default slot is designed for `mds-push-notification-item` children only. Placing raw HTML or other components breaks the animation lifecycle, event wiring, and the intro/outro sequencing the container manages.\n\n```html\n<!-- INCORRECT -->\n<mds-push-notification>\n <div class=\"my-notification\">\n <strong>Avviso</strong>\n <p>Il documento e' pronto.</p>\n </div>\n</mds-push-notification>\n\n<!-- CORRECT -->\n<mds-push-notification>\n <mds-push-notification-item\n subject=\"Avviso\"\n message=\"Il documento e' pronto.\"\n ></mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Do Not Set `visible=\"false\"` to Hide the Panel\n\n`visible` is a boolean prop: a false boolean is written by removing the attribute, the convention for every Magma boolean ([`agents/conventions.md`](../../../../agents/conventions.md)). Stencil does parse `\"false\"` as `false`, but the attribute stays in the markup until the component hydrates and its reflection removes it, so a `[visible]` selector or any code reading the attribute sees it set in the meantime. Remove the attribute entirely - or call `hide()` - to close the panel.\n\n```html\n<!-- INCORRECT -->\n<mds-push-notification visible=\"false\"></mds-push-notification>\n\n<!-- CORRECT: remove the attribute -->\n<mds-push-notification></mds-push-notification>\n```\n\n```javascript\n// CORRECT: via imperative method\ndocument.querySelector('mds-push-notification').hide();\n```\n\n#### Do Not Listen to the Native `close` Event Instead of `mdsPushNotificationHide`\n\nThe component emits `mdsPushNotificationHide` when the panel hides. Listening for a native `close` event will never fire because the component does not dispatch it, and native DOM events from inside the shadow root do not reliably bubble to the light DOM.\n\n```javascript\n// INCORRECT\npanel.addEventListener('close', () => updateUI());\n\n// CORRECT\npanel.addEventListener('mdsPushNotificationHide', () => updateUI());\n```\n\n#### Do Not Use `behavior=\"manual\"` and Then Forget to Call `show()` / `hide()`\n\nWith `behavior=\"manual\"` the container never auto-shows when items are added; you must explicitly call `show()` or set `visible`. Leaving it on `manual` without wiring visibility logic means notifications are silently queued but never displayed.\n\n```html\n<!-- INCORRECT: items never appear because manual mode needs explicit show() -->\n<mds-push-notification behavior=\"manual\" id=\"notif-panel\">\n <mds-push-notification-item\n subject=\"Nuovo messaggio\"\n message=\"Messaggio ricevuto.\"\n ></mds-push-notification-item>\n</mds-push-notification>\n\n<!-- CORRECT: call show() after adding items -->\n<mds-push-notification behavior=\"manual\" id=\"notif-panel\">\n <mds-push-notification-item\n subject=\"Nuovo messaggio\"\n message=\"Messaggio ricevuto.\"\n ></mds-push-notification-item>\n</mds-push-notification>\n\n<script>\n document.querySelector('#notif-panel').show();\n</script>\n```\n\n#### Do Not Pierce Shadow DOM to Style Item Internals\n\nThe only supported customization surface for the container is the public `--mds-push-notification-*` CSS custom properties plus the documented `::part(notifications)` part. Use the public per-item CSS custom properties (prefixed `--mds-push-notification-item-*`) for item-level styling. Do not reach into shadow parts that are not documented.\n\n```css\n/* INCORRECT */\nmds-push-notification >>> .notifications {\n background: white;\n}\nmds-push-notification::part(content) {\n padding: 2rem;\n}\n\n/* CORRECT */\nmds-push-notification {\n --mds-push-notification-background: rgb(var(--magma-surface-overlay) / 0.9);\n --mds-push-notification-gap: calc(var(--spacing) * 300);\n}\nmds-push-notification::part(notifications) {\n /* documented part - safe to target */\n padding-block: calc(var(--spacing) * 200);\n}\n```\n\n#### Do Not Slot Actions in the Wrong Slot\n\nAction buttons belong in the `action` slot of `mds-push-notification-item`, not in the default slot of `mds-push-notification`. Placing a button in the parent's default slot treats it like a notification item, breaks the animation sequence, and the button will be styled and animated as if it were a notification. A clear-all button is not needed either: the container renders its own.\n\n```html\n<!-- INCORRECT: button lands in the parent's default slot -->\n<mds-push-notification>\n <mds-button variant=\"dark\">Cancella tutto</mds-button>\n <mds-push-notification-item subject=\"Avviso\" message=\"Nuovo messaggio.\"></mds-push-notification-item>\n</mds-push-notification>\n\n<!-- CORRECT: action belongs on the item's action slot -->\n<mds-push-notification>\n <mds-push-notification-item subject=\"Avviso\" message=\"Nuovo messaggio.\">\n <mds-button slot=\"action\" variant=\"primary\" tone=\"weak\" size=\"sm\">Apri</mds-button>\n </mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Do Not Apply an Unsupported `tone` Value to Item\n\n`mds-push-notification-item` accepts `tone=\"strong\"` or `tone=\"weak\"` only (`ToneMinimalVariantType`). Using `tone=\"outline\"` (a tone of `mds-button` and `mds-badge`) silently falls back to the default `weak` look and the intended visual emphasis is lost. `variant` and `tone` paint only the item's icon or avatar, so pair them with `icon`.\n\n```html\n<!-- INCORRECT: outline and text are not supported tones for this component -->\n<mds-push-notification-item\n icon=\"mi/baseline/error\"\n variant=\"error\"\n tone=\"outline\"\n subject=\"Errore\"\n message=\"Operazione fallita.\"\n></mds-push-notification-item>\n\n<!-- CORRECT -->\n<mds-push-notification-item\n icon=\"mi/baseline/error\"\n variant=\"error\"\n tone=\"strong\"\n subject=\"Errore\"\n message=\"Operazione fallita.\"\n></mds-push-notification-item>\n```\n"
33
33
  },
34
34
  "props": [
35
35
  {
@@ -0,0 +1,200 @@
1
+ <!--
2
+ GENERATED FILE - do not edit by hand.
3
+ Source of truth: src/components/mds-push-notification/usage/ in the magma monorepo.
4
+ -->
5
+
6
+ # mds-push-notification - examples
7
+
8
+ > The API of this component: [`AGENTS.md`](AGENTS.md).
9
+
10
+ Correct and idiomatic ways to use the `<mds-push-notification>` component, ordered from most common to most specialized. The examples assume a working knowledge of the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).
11
+
12
+ #### Minimal Auto-Managed Stack
13
+
14
+ The default `behavior="auto"` configuration. Drop `mds-push-notification-item` children into the default slot and the container shows itself, animates each item in, and hides itself when all items have been dismissed. Set `dismissible` on an item to give it its own close button.
15
+
16
+ ```html
17
+ <mds-push-notification>
18
+ <mds-push-notification-item
19
+ dismissible
20
+ subject="Nuovo messaggio"
21
+ message="Il documento e' pronto per la revisione."
22
+ ></mds-push-notification-item>
23
+ </mds-push-notification>
24
+ ```
25
+
26
+ #### Items with Avatar Preview
27
+
28
+ Use `preview="avatar"` and `src` to show a user photo. Supply `initials` as a fallback when no image is available.
29
+
30
+ ```html
31
+ <mds-push-notification>
32
+ <mds-push-notification-item
33
+ preview="avatar"
34
+ src="/avatars/marco.jpg"
35
+ initials="MC"
36
+ subject="Marco Cicognetti"
37
+ message="Ci sei andato poi alla riunione?"
38
+ ></mds-push-notification-item>
39
+ </mds-push-notification>
40
+ ```
41
+
42
+ #### Items with Icon Preview
43
+
44
+ Use `icon` (an icon slug with its set prefix) instead of `src` when the notification represents an event or system action rather than a person.
45
+
46
+ ```html
47
+ <mds-push-notification>
48
+ <mds-push-notification-item
49
+ icon="mi/baseline/attachment"
50
+ subject="Documento allegato"
51
+ message="E' stato caricato un nuovo allegato nella pratica 2024-1042."
52
+ ></mds-push-notification-item>
53
+ </mds-push-notification>
54
+ ```
55
+
56
+ #### Item with Date and Timestamp
57
+
58
+ Pass an ISO 8601 datetime string to display a relative time-ago label (default) or a static formatted date.
59
+
60
+ ```html
61
+ <mds-push-notification>
62
+ <mds-push-notification-item
63
+ subject="Approvazione completata"
64
+ message="La richiesta e' stata approvata."
65
+ datetime="2024-11-12T09:30:00Z"
66
+ ></mds-push-notification-item>
67
+
68
+ <!-- Static date format -->
69
+ <mds-push-notification-item
70
+ subject="Scadenza contratto"
71
+ message="Il contratto scade il giorno indicato."
72
+ datetime="2024-12-31T00:00:00Z"
73
+ date-format="DD/MM/YYYY"
74
+ ></mds-push-notification-item>
75
+ </mds-push-notification>
76
+ ```
77
+
78
+ #### Item with Action Button
79
+
80
+ Slot an `mds-button` into the `action` slot of the item to provide an inline CTA.
81
+
82
+ ```html
83
+ <mds-push-notification>
84
+ <mds-push-notification-item
85
+ preview="avatar"
86
+ src="/avatars/sara.jpg"
87
+ subject="Sara Ho"
88
+ message="Hai ricevuto una nuova richiesta di collaborazione."
89
+ >
90
+ <mds-button slot="action" variant="primary" tone="weak" size="sm">
91
+ Rispondi
92
+ </mds-button>
93
+ </mds-push-notification-item>
94
+ </mds-push-notification>
95
+ ```
96
+
97
+ #### Manual Behavior with Programmatic Control
98
+
99
+ Set `behavior="manual"` when visibility should be controlled by your application logic rather than inferred from slot contents. Toggle the `visible` attribute or call `show()` / `hide()` on the element.
100
+
101
+ ```html
102
+ <mds-push-notification behavior="manual" id="notif-panel">
103
+ <mds-push-notification-item
104
+ subject="Aggiornamento sistema"
105
+ message="Un aggiornamento e' disponibile. Riavviare per applicarlo."
106
+ ></mds-push-notification-item>
107
+ </mds-push-notification>
108
+
109
+ <script>
110
+ const panel = document.querySelector('#notif-panel');
111
+
112
+ // Show programmatically
113
+ panel.show();
114
+
115
+ // Hide programmatically
116
+ panel.hide();
117
+ </script>
118
+ ```
119
+
120
+ #### Programmatic Dismissal of a Single Item
121
+
122
+ Call `removeNotification()` with an `mds-push-notification-item` element reference to animate it out and remove it without the user interacting with the close button.
123
+
124
+ ```html
125
+ <mds-push-notification id="notif-panel">
126
+ <mds-push-notification-item id="item-1"
127
+ subject="Avviso temporaneo"
128
+ message="Questa notifica viene rimossa dopo 5 secondi."
129
+ ></mds-push-notification-item>
130
+ </mds-push-notification>
131
+
132
+ <script>
133
+ const panel = document.querySelector('#notif-panel');
134
+ const item = document.querySelector('#item-1');
135
+
136
+ setTimeout(() => {
137
+ panel.removeNotification(item);
138
+ }, 5000);
139
+ </script>
140
+ ```
141
+
142
+ #### Reacting to Visibility Events
143
+
144
+ Listen to `mdsPushNotificationShow`, `mdsPushNotificationHide`, or `mdsPushNotificationChange` to synchronize UI state when the panel opens or closes.
145
+
146
+ ```javascript
147
+ const panel = document.querySelector('mds-push-notification');
148
+
149
+ panel.addEventListener('mdsPushNotificationShow', () => {
150
+ console.info('Pannello notifiche aperto');
151
+ });
152
+
153
+ panel.addEventListener('mdsPushNotificationHide', () => {
154
+ console.info('Pannello notifiche chiuso');
155
+ });
156
+
157
+ panel.addEventListener('mdsPushNotificationChange', (e) => {
158
+ console.info('Visibilita cambiata:', e.detail.visible);
159
+ });
160
+ ```
161
+
162
+ #### Item Tone and Variant
163
+
164
+ Use `variant` and `tone` on the item to reflect the semantic nature of the notification (status or theme family). `tone` accepts `strong` or `weak` on this component. They paint the item's icon or avatar preview, so they show only together with `icon` (or `preview="avatar"`).
165
+
166
+ ```html
167
+ <mds-push-notification>
168
+ <mds-push-notification-item
169
+ icon="mi/baseline/check-circle"
170
+ variant="success"
171
+ tone="weak"
172
+ subject="Operazione completata"
173
+ message="Il file e' stato salvato con successo."
174
+ ></mds-push-notification-item>
175
+
176
+ <mds-push-notification-item
177
+ icon="mi/baseline/error"
178
+ variant="error"
179
+ tone="strong"
180
+ subject="Errore critico"
181
+ message="Impossibile completare l'operazione. Riprovare."
182
+ ></mds-push-notification-item>
183
+ </mds-push-notification>
184
+ ```
185
+
186
+ #### Styling Customization via CSS Custom Properties
187
+
188
+ Override the fade-out delay, the gap between items, and the panel background through the public `--mds-push-notification-*` properties; the intro and outro motion of the items is set by the component. Set them on the host or a parent selector; for colours name a semantic role, `rgb(var(--magma-<role>))` ([`agents/color.md`](../../../../agents/color.md)).
189
+
190
+ ```css
191
+ mds-push-notification {
192
+ --mds-push-notification-gap: calc(var(--spacing) * 300);
193
+ --mds-push-notification-fadeout-delay: 0.5s;
194
+ --mds-push-notification-background: linear-gradient(
195
+ to right,
196
+ rgb(var(--magma-surface-overlay) / 0) 0%,
197
+ rgb(var(--magma-surface-overlay) / 0.95) 100%
198
+ );
199
+ }
200
+ ```
@@ -157,7 +157,7 @@ export class MdsPushNotification {
157
157
  this.visible = undefined;
158
158
  }
159
159
  render() {
160
- return (h(Host, { key: '8227ce180e0acb950b9083ab214ff9a3ab80463d', "pref-mode": preferenceStore.state.mode, "pref-theme-scheme": preferenceStore.state['theme-scheme'] }, h("mds-button", { key: '61ad1b5a60321de36f4bf88a5eeb2c2b23b80ec1', variant: "dark", onClick: this.clear, label: this.t.get('clearNotifications') }), h("div", { key: '5590c4d804403622f0e48ca46361a4c635ca8bb8', class: "notifications", part: "notifications" }, h("slot", { key: '449df6d1917f1149e980e27b9fd848da4a93155e', ref: (el) => (this.slotNotifications = el) }))));
160
+ return (h(Host, { key: 'bdf94fa26147f00b3a7993da27e8e51609220490', "pref-mode": preferenceStore.state.mode, "pref-theme-scheme": preferenceStore.state['theme-scheme'] }, h("mds-button", { key: '2e172047fedaeb721f666281ee03554bc51b841b', variant: "dark", onClick: this.clear, label: this.t.get('clearNotifications') }), h("div", { key: '09704283a8ab0aac5e1ec5b005fe28d7e5a4c3bd', class: "notifications", part: "notifications" }, h("slot", { key: '4d2998a1b89b3e82a19099b5eb68324f4ea3847f', ref: (el) => (this.slotNotifications = el) }))));
161
161
  }
162
162
  static get is() { return "mds-push-notification"; }
163
163
  static get encapsulation() { return "shadow"; }
@@ -0,0 +1,154 @@
1
+ <!--
2
+ GENERATED FILE - do not edit by hand.
3
+ Source of truth: src/components/mds-push-notification/usage/ in the magma monorepo.
4
+ -->
5
+
6
+ # mds-push-notification - mistakes
7
+
8
+ > The API of this component: [`AGENTS.md`](AGENTS.md).
9
+
10
+ Common incorrect uses of `<mds-push-notification>`. 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 Arbitrary HTML in the Default Slot
13
+
14
+ The default slot is designed for `mds-push-notification-item` children only. Placing raw HTML or other components breaks the animation lifecycle, event wiring, and the intro/outro sequencing the container manages.
15
+
16
+ ```html
17
+ <!-- INCORRECT -->
18
+ <mds-push-notification>
19
+ <div class="my-notification">
20
+ <strong>Avviso</strong>
21
+ <p>Il documento e' pronto.</p>
22
+ </div>
23
+ </mds-push-notification>
24
+
25
+ <!-- CORRECT -->
26
+ <mds-push-notification>
27
+ <mds-push-notification-item
28
+ subject="Avviso"
29
+ message="Il documento e' pronto."
30
+ ></mds-push-notification-item>
31
+ </mds-push-notification>
32
+ ```
33
+
34
+ #### Do Not Set `visible="false"` to Hide the Panel
35
+
36
+ `visible` is a boolean prop: a false boolean is written by removing the attribute, the convention for every Magma boolean ([`agents/conventions.md`](../../../../agents/conventions.md)). Stencil does parse `"false"` as `false`, but the attribute stays in the markup until the component hydrates and its reflection removes it, so a `[visible]` selector or any code reading the attribute sees it set in the meantime. Remove the attribute entirely - or call `hide()` - to close the panel.
37
+
38
+ ```html
39
+ <!-- INCORRECT -->
40
+ <mds-push-notification visible="false"></mds-push-notification>
41
+
42
+ <!-- CORRECT: remove the attribute -->
43
+ <mds-push-notification></mds-push-notification>
44
+ ```
45
+
46
+ ```javascript
47
+ // CORRECT: via imperative method
48
+ document.querySelector('mds-push-notification').hide();
49
+ ```
50
+
51
+ #### Do Not Listen to the Native `close` Event Instead of `mdsPushNotificationHide`
52
+
53
+ The component emits `mdsPushNotificationHide` when the panel hides. Listening for a native `close` event will never fire because the component does not dispatch it, and native DOM events from inside the shadow root do not reliably bubble to the light DOM.
54
+
55
+ ```javascript
56
+ // INCORRECT
57
+ panel.addEventListener('close', () => updateUI());
58
+
59
+ // CORRECT
60
+ panel.addEventListener('mdsPushNotificationHide', () => updateUI());
61
+ ```
62
+
63
+ #### Do Not Use `behavior="manual"` and Then Forget to Call `show()` / `hide()`
64
+
65
+ With `behavior="manual"` the container never auto-shows when items are added; you must explicitly call `show()` or set `visible`. Leaving it on `manual` without wiring visibility logic means notifications are silently queued but never displayed.
66
+
67
+ ```html
68
+ <!-- INCORRECT: items never appear because manual mode needs explicit show() -->
69
+ <mds-push-notification behavior="manual" id="notif-panel">
70
+ <mds-push-notification-item
71
+ subject="Nuovo messaggio"
72
+ message="Messaggio ricevuto."
73
+ ></mds-push-notification-item>
74
+ </mds-push-notification>
75
+
76
+ <!-- CORRECT: call show() after adding items -->
77
+ <mds-push-notification behavior="manual" id="notif-panel">
78
+ <mds-push-notification-item
79
+ subject="Nuovo messaggio"
80
+ message="Messaggio ricevuto."
81
+ ></mds-push-notification-item>
82
+ </mds-push-notification>
83
+
84
+ <script>
85
+ document.querySelector('#notif-panel').show();
86
+ </script>
87
+ ```
88
+
89
+ #### Do Not Pierce Shadow DOM to Style Item Internals
90
+
91
+ The only supported customization surface for the container is the public `--mds-push-notification-*` CSS custom properties plus the documented `::part(notifications)` part. Use the public per-item CSS custom properties (prefixed `--mds-push-notification-item-*`) for item-level styling. Do not reach into shadow parts that are not documented.
92
+
93
+ ```css
94
+ /* INCORRECT */
95
+ mds-push-notification >>> .notifications {
96
+ background: white;
97
+ }
98
+ mds-push-notification::part(content) {
99
+ padding: 2rem;
100
+ }
101
+
102
+ /* CORRECT */
103
+ mds-push-notification {
104
+ --mds-push-notification-background: rgb(var(--magma-surface-overlay) / 0.9);
105
+ --mds-push-notification-gap: calc(var(--spacing) * 300);
106
+ }
107
+ mds-push-notification::part(notifications) {
108
+ /* documented part - safe to target */
109
+ padding-block: calc(var(--spacing) * 200);
110
+ }
111
+ ```
112
+
113
+ #### Do Not Slot Actions in the Wrong Slot
114
+
115
+ Action buttons belong in the `action` slot of `mds-push-notification-item`, not in the default slot of `mds-push-notification`. Placing a button in the parent's default slot treats it like a notification item, breaks the animation sequence, and the button will be styled and animated as if it were a notification. A clear-all button is not needed either: the container renders its own.
116
+
117
+ ```html
118
+ <!-- INCORRECT: button lands in the parent's default slot -->
119
+ <mds-push-notification>
120
+ <mds-button variant="dark">Cancella tutto</mds-button>
121
+ <mds-push-notification-item subject="Avviso" message="Nuovo messaggio."></mds-push-notification-item>
122
+ </mds-push-notification>
123
+
124
+ <!-- CORRECT: action belongs on the item's action slot -->
125
+ <mds-push-notification>
126
+ <mds-push-notification-item subject="Avviso" message="Nuovo messaggio.">
127
+ <mds-button slot="action" variant="primary" tone="weak" size="sm">Apri</mds-button>
128
+ </mds-push-notification-item>
129
+ </mds-push-notification>
130
+ ```
131
+
132
+ #### Do Not Apply an Unsupported `tone` Value to Item
133
+
134
+ `mds-push-notification-item` accepts `tone="strong"` or `tone="weak"` only (`ToneMinimalVariantType`). Using `tone="outline"` (a tone of `mds-button` and `mds-badge`) silently falls back to the default `weak` look and the intended visual emphasis is lost. `variant` and `tone` paint only the item's icon or avatar, so pair them with `icon`.
135
+
136
+ ```html
137
+ <!-- INCORRECT: outline and text are not supported tones for this component -->
138
+ <mds-push-notification-item
139
+ icon="mi/baseline/error"
140
+ variant="error"
141
+ tone="outline"
142
+ subject="Errore"
143
+ message="Operazione fallita."
144
+ ></mds-push-notification-item>
145
+
146
+ <!-- CORRECT -->
147
+ <mds-push-notification-item
148
+ icon="mi/baseline/error"
149
+ variant="error"
150
+ tone="strong"
151
+ subject="Errore"
152
+ message="Operazione fallita."
153
+ ></mds-push-notification-item>
154
+ ```
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-push-notification-item
8
8
 
9
- > `@maggioli-design-system/magma` 2.9.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
9
+ > `@maggioli-design-system/magma` 2.11.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
10
10
 
11
11
  The `<mds-push-notification-item>` web component is a single notification card rendered inside its parent container [`<mds-push-notification>`](../mds-push-notification/AGENTS.md). It composes an avatar/image, a subject, a relative or formatted timestamp, a message body and an optional dismiss control into one toast-like row.
12
12
 
@@ -32,10 +32,10 @@ For `tone` and `variant`, this component consumes the shared color ladders defin
32
32
 
33
33
  ## Read next
34
34
 
35
- - [`pattern.md`](pattern.md) - correct usage, with examples
36
- - [`antipattern.md`](antipattern.md) - mistakes to avoid
35
+ - [`examples.md`](examples.md) - correct usage, from the most common case
36
+ - [`mistakes.md`](mistakes.md) - the wrong forms, each with the right one
37
37
  - [Storybook](https://magma-design-system.github.io/magma/storybook/?path=/docs/ui-push-notification-push-notification-item--docs) - the live examples, in the published Storybook of `main`
38
- - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`anti-patterns.md`](../../../../agents/anti-patterns.md) - the rules shared by every component
38
+ - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`mistakes.md`](../../../../agents/mistakes.md) - the rules shared by every component
39
39
 
40
40
  ## Props
41
41
 
@@ -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",
@@ -44,8 +44,8 @@
44
44
  ],
45
45
  "usage": {
46
46
  "1. Description": "The `<mds-push-notification-item>` web component is a single notification card rendered inside its parent container [`<mds-push-notification>`](../mds-push-notification/AGENTS.md). It composes an avatar/image, a subject, a relative or formatted timestamp, a message body and an optional dismiss control into one toast-like row.\n\n#### Semantic Behavior\n\n- **Compound child only**: It must be placed as a direct default-slot child of `<mds-push-notification>`; it is not used standalone or mixed with other child types, since the parent animates intro/outro and manages stacking.\n- **Dismiss reports up, removal happens in the parent**: Clicking the built-in close button emits the bubbling `mdsPushNotificationItemClose` event, with the `id` of the item as `detail.id`; the parent runs the outro animation and removes the item. The item never removes itself.\n- **Parent-driven visibility lifecycle**: When the last item closes, the parent auto-hides the whole notification area.\n- **Timestamp rendering**: With `dateFormat=\"timeago\"` `datetime` shows a localized relative time (\"2 minutes ago\"); otherwise the value is treated as a date-format string for a static date.\n- **Localization**: The relative-time strings and the dismiss button title are localized (el/en/es/it).\n- **Conditional avatar vs. picture**: An `<mds-avatar>` is rendered when `icon` is set or `preview=\"avatar\"`; when `src` is set and `preview` is not `avatar`, an `<mds-img>` picture is rendered (next to the avatar when `icon` is also set).\n- **Slot detection**: The `badge` and `action` named slot wrappers stay hidden (`display: none`) until matching slotted children exist, so empty slots take no space.\n\n#### Properties & Visual Configurations\n\n- **`dismissible`**: Controls whether the dismiss button is shown. Add it to let the user close the notification manually; leave it off for items the user should not close.\n- **`deletable`** is the old name of `dismissible`, deprecated: the button dismisses the notification, it deletes nothing. It still works, and goes in the next major.\n- **`preview`**: Pick `avatar` to show the `src` image (or `initials`/`icon` fallback) as a compact round avatar, or `image` (default) to show `src` as a larger inline picture preview.\n- **`initials`**: Provided as the avatar fallback when no image is available; it overrides `tone`/`variant` styling so the user stays visually recognizable.\n- **`dateFormat`**: Use `timeago` for a live relative timestamp, or any date-format token string for a fixed display date.\n\nFor `tone` and `variant`, this component consumes the shared color ladders defined in [`agents/variants.md`](../../../../agents/variants.md); the values are forwarded to the underlying `<mds-avatar>` and follow the avatar tone/variant set rather than adding component-specific values.\n",
47
- "2. Pattern": "Correct and idiomatic ways to use the `<mds-push-notification-item>` 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 Message Notification\n\nThe minimal form: a message body with an icon and a relative timestamp. Always nest the item inside [`mds-push-notification`](../mds-push-notification/AGENTS.md), which manages stacking and animation.\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n icon=\"mi/baseline/email\"\n subject=\"Nuovo messaggio\"\n message=\"Hai ricevuto 3 nuovi messaggi da account diversi\"\n datetime=\"2024-06-01T10:30:00\"\n ></mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Variant for Semantic Status\n\nUse `variant` to communicate meaning - success, warning, error, info - and `tone` to set visual weight. The values are forwarded to the internal `<mds-avatar>`.\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n icon=\"mi/baseline/check-circle\"\n subject=\"Salvataggio completato\"\n message=\"Il documento e' stato salvato con successo\"\n datetime=\"2024-06-01T10:31:00\"\n variant=\"success\"\n tone=\"strong\"\n ></mds-push-notification-item>\n\n <mds-push-notification-item\n icon=\"mi/baseline/warning\"\n subject=\"Attenzione\"\n message=\"La sessione scadra' tra 5 minuti\"\n datetime=\"2024-06-01T10:32:00\"\n variant=\"warning\"\n tone=\"weak\"\n ></mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Dismissible Notification\n\nAdd the `dismissible` attribute to show the dismiss button, letting the user close the notification manually. Without it the notification cannot be dismissed by the user - keep it off for system notifications the user must not close.\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n dismissible\n icon=\"mi/baseline/email\"\n subject=\"Nuovo messaggio\"\n message=\"Hai ricevuto un nuovo messaggio\"\n datetime=\"2024-06-01T09:00:00\"\n variant=\"info\"\n ></mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Action Buttons via the `action` Slot\n\nSlot one or more `<mds-button>` elements into `slot=\"action\"` for in-notification CTAs. Use `size=\"sm\"` to keep the actions compact.\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n icon=\"mi/baseline/person\"\n subject=\"Mario Giannini\"\n message=\"Ciao, sono Mario, questo e' il mio contatto, buona giornata!\"\n datetime=\"2024-06-01T10:25:00\"\n variant=\"primary\"\n tone=\"strong\"\n >\n <mds-button slot=\"action\" variant=\"success\" tone=\"weak\" size=\"sm\" label=\"Accetta\"></mds-button>\n <mds-button slot=\"action\" variant=\"error\" tone=\"weak\" size=\"sm\" label=\"Ignora\"></mds-button>\n </mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Badge Label via the `badge` Slot\n\nSlot an `<mds-badge>` into `slot=\"badge\"` to show a category or type label above the subject line.\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n icon=\"mi/baseline/attach-file\"\n subject=\"Nuovo allegato\"\n message=\"Hai ricevuto un nuovo file allegato da Luca Bianchi\"\n datetime=\"2024-06-01T10:20:00\"\n variant=\"primary\"\n >\n <mds-badge slot=\"badge\" variant=\"amaranth\" tone=\"weak\" label=\"pdf\"></mds-badge>\n <mds-button slot=\"action\" tone=\"outline\" size=\"sm\" label=\"Scarica\"></mds-button>\n </mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Avatar Mode with Image\n\nSet `src` and `preview=\"avatar\"` to display a user photo as a round avatar instead of the default full-width image preview.\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n src=\"./avatar-sarah.jpeg\"\n preview=\"avatar\"\n subject=\"Sarah Ho\"\n message=\"Ciao, sono Sarah, questo e' il mio contatto, buona giornata!\"\n datetime=\"2024-06-01T10:15:00\"\n variant=\"primary\"\n tone=\"strong\"\n >\n <mds-button slot=\"action\" variant=\"success\" tone=\"weak\" size=\"sm\" label=\"Scrivi\"></mds-button>\n </mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Avatar Mode with Initials Fallback\n\nWhen no image is available, set `initials` and `preview=\"avatar\"`. The initials override `tone` and `variant` coloring so the user stays visually distinguishable.\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n initials=\"MG\"\n preview=\"avatar\"\n subject=\"Mario Giannini\"\n message=\"Ha modificato il documento condiviso\"\n datetime=\"2024-06-01T10:10:00\"\n ></mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Inline Image Preview\n\nOmit `preview=\"avatar\"` (or keep the default `image`) and supply `src` to show the image as a larger inline thumbnail - useful for file or media notifications.\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n src=\"./book-cover-01.webp\"\n subject=\"Anteprima immagine\"\n message=\"La copertina e' stata aggiornata\"\n datetime=\"2024-06-01T10:05:00\"\n ></mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Fixed Date Format\n\nUse any `dayjs`-compatible format string as `date-format` to show a static date instead of the default relative \"time ago\" display.\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n icon=\"mi/baseline/event\"\n subject=\"Promemoria riunione\"\n message=\"La riunione di progetto e' fissata per domani\"\n datetime=\"2024-06-01T09:00:00\"\n date-format=\"DD/MM/YYYY\"\n ></mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Listening to the Dismiss Event\n\nListen to `mdsPushNotificationItemClose` to handle cleanup when the user dismisses the item. The parent `<mds-push-notification>` does this automatically, but you can also add your own logic (e.g. marking the notification read in the server). The event carries the `id` of the item in `detail.id`.\n\n```javascript\ndocument\n .querySelector('mds-push-notification-item')\n .addEventListener('mdsPushNotificationItemClose', (event) => {\n markNotificationRead(event.detail.id);\n });\n```\n\n#### Styling Customization\n\nCustomize the item only through its public `--mds-push-notification-item-*` CSS custom properties.\n\n```css\n.app-notifications mds-push-notification-item {\n --mds-push-notification-item-shadow: var(--shadow-md-sharp);\n --mds-push-notification-item-message-line-clamp: 3;\n --mds-push-notification-item-subject-line-clamp: 2;\n}\n```\n",
48
- "3. Antipattern": "Common incorrect uses of `<mds-push-notification-item>`. Each entry pairs the wrong form with the right one and a one-line reason. System-wide rules (boolean-as-string, shadow piercing, Tailwind color utilities, raw native event listening) live in [`agents/anti-patterns.md`](../../../../agents/anti-patterns.md) - they apply here too but are not repeated.\n\n#### Do Not Use the Item Outside Its Parent\n\n`<mds-push-notification-item>` is a compound child that must live inside [`<mds-push-notification>`](../mds-push-notification/AGENTS.md). The parent drives entry / exit animation, stacking, and auto-hide when the last item closes.\n\n```html\n<!-- INCORRECT -->\n<mds-push-notification-item\n icon=\"mi/baseline/email\"\n subject=\"Nuovo messaggio\"\n message=\"Hai ricevuto un nuovo messaggio\"\n></mds-push-notification-item>\n\n<!-- CORRECT -->\n<mds-push-notification>\n <mds-push-notification-item\n icon=\"mi/baseline/email\"\n subject=\"Nuovo messaggio\"\n message=\"Hai ricevuto un nuovo messaggio\"\n ></mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Do Not Put Content in the Default Slot\n\n`<mds-push-notification-item>` has no default slot. All text content goes through the `message` and `subject` props; interactive content goes into the named `action` or `badge` slots.\n\n```html\n<!-- INCORRECT -->\n<mds-push-notification-item>\n Hai un nuovo messaggio\n</mds-push-notification-item>\n\n<!-- CORRECT -->\n<mds-push-notification-item\n message=\"Hai un nuovo messaggio\"\n subject=\"Posta in arrivo\"\n></mds-push-notification-item>\n```\n\n#### Do Not Slot Arbitrary Content Into `action` Without `mds-button`\n\nThe `action` slot is designed for `<mds-button>` elements at `size=\"sm\"`. Slotting raw `<button>` or large components breaks layout alignment and loses Magma theming and keyboard semantics.\n\n```html\n<!-- INCORRECT -->\n<mds-push-notification-item subject=\"Richiesta\" message=\"Approva la richiesta di accesso\">\n <button slot=\"action\" class=\"btn\">Approva</button>\n</mds-push-notification-item>\n\n<!-- CORRECT -->\n<mds-push-notification-item subject=\"Richiesta\" message=\"Approva la richiesta di accesso\">\n <mds-button slot=\"action\" variant=\"success\" tone=\"weak\" size=\"sm\" label=\"Approva\"></mds-button>\n</mds-push-notification-item>\n```\n\n#### Do Not Mix `icon` and `src` With `preview=\"image\"`\n\nWhen `icon` is set, the component always renders an `<mds-avatar>` for the icon. If `src` is also set and `preview` is not `\"avatar\"`, an `<mds-img>` picture is rendered as well - producing two media areas side by side, which is almost never the intended layout. Pick one visual mode per notification.\n\n```html\n<!-- INCORRECT - both an icon avatar and an image preview render simultaneously -->\n<mds-push-notification-item\n icon=\"mi/baseline/photo\"\n src=\"./cover.jpg\"\n preview=\"image\"\n subject=\"Nuova foto\"\n message=\"La copertina e' stata aggiornata\"\n></mds-push-notification-item>\n\n<!-- CORRECT - icon only, no image -->\n<mds-push-notification-item\n icon=\"mi/baseline/photo\"\n subject=\"Nuova foto\"\n message=\"La copertina e' stata aggiornata\"\n></mds-push-notification-item>\n\n<!-- CORRECT - image preview only, no icon -->\n<mds-push-notification-item\n src=\"./cover.jpg\"\n subject=\"Nuova foto\"\n message=\"La copertina e' stata aggiornata\"\n></mds-push-notification-item>\n```\n\n#### Do Not Listen for the Native `close` DOM Event\n\nThe component emits `mdsPushNotificationItemClose`, not a native `close`. Listening for `close` never fires, and the `click` of the dismiss button does not leave the component (its handler calls `stopPropagation()`).\n\n```javascript\n// INCORRECT\nelement.addEventListener('close', handler);\n\n// CORRECT\nelement.addEventListener('mdsPushNotificationItemClose', handler);\n```\n\n#### Customize via Documented Vars, Not Internal Selectors\n\nThe supported customization surface is `--mds-push-notification-item-*` CSS custom properties and documented shadow parts (`actions`, `avatar`, `content`, `picture`). Targeting shadow-DOM internals via `::part()` on undocumented parts or via `>>>` will break on minor releases.\n\n```css\n/* INCORRECT */\nmds-push-notification-item::part(header) {\n font-weight: bold;\n}\nmds-push-notification-item >>> .message {\n color: red;\n}\n\n/* CORRECT */\nmds-push-notification-item {\n --mds-push-notification-item-message-line-clamp: 3;\n --mds-push-notification-item-shadow: var(--shadow-md-sharp);\n}\nmds-push-notification-item::part(content) {\n gap: calc(var(--spacing) * 200);\n}\n```\n"
47
+ "2. Examples": "Correct and idiomatic ways to use the `<mds-push-notification-item>` 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 Message Notification\n\nThe minimal form: a message body with an icon and a relative timestamp. Always nest the item inside [`mds-push-notification`](../mds-push-notification/AGENTS.md), which manages stacking and animation.\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n icon=\"mi/baseline/email\"\n subject=\"Nuovo messaggio\"\n message=\"Hai ricevuto 3 nuovi messaggi da account diversi\"\n datetime=\"2024-06-01T10:30:00\"\n ></mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Variant for Semantic Status\n\nUse `variant` to communicate meaning - success, warning, error, info - and `tone` to set visual weight. The values are forwarded to the internal `<mds-avatar>`.\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n icon=\"mi/baseline/check-circle\"\n subject=\"Salvataggio completato\"\n message=\"Il documento e' stato salvato con successo\"\n datetime=\"2024-06-01T10:31:00\"\n variant=\"success\"\n tone=\"strong\"\n ></mds-push-notification-item>\n\n <mds-push-notification-item\n icon=\"mi/baseline/warning\"\n subject=\"Attenzione\"\n message=\"La sessione scadra' tra 5 minuti\"\n datetime=\"2024-06-01T10:32:00\"\n variant=\"warning\"\n tone=\"weak\"\n ></mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Dismissible Notification\n\nAdd the `dismissible` attribute to show the dismiss button, letting the user close the notification manually. Without it the notification cannot be dismissed by the user - keep it off for system notifications the user must not close.\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n dismissible\n icon=\"mi/baseline/email\"\n subject=\"Nuovo messaggio\"\n message=\"Hai ricevuto un nuovo messaggio\"\n datetime=\"2024-06-01T09:00:00\"\n variant=\"info\"\n ></mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Action Buttons via the `action` Slot\n\nSlot one or more `<mds-button>` elements into `slot=\"action\"` for in-notification CTAs. Use `size=\"sm\"` to keep the actions compact.\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n icon=\"mi/baseline/person\"\n subject=\"Mario Giannini\"\n message=\"Ciao, sono Mario, questo e' il mio contatto, buona giornata!\"\n datetime=\"2024-06-01T10:25:00\"\n variant=\"primary\"\n tone=\"strong\"\n >\n <mds-button slot=\"action\" variant=\"success\" tone=\"weak\" size=\"sm\" label=\"Accetta\"></mds-button>\n <mds-button slot=\"action\" variant=\"error\" tone=\"weak\" size=\"sm\" label=\"Ignora\"></mds-button>\n </mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Badge Label via the `badge` Slot\n\nSlot an `<mds-badge>` into `slot=\"badge\"` to show a category or type label above the subject line.\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n icon=\"mi/baseline/attach-file\"\n subject=\"Nuovo allegato\"\n message=\"Hai ricevuto un nuovo file allegato da Luca Bianchi\"\n datetime=\"2024-06-01T10:20:00\"\n variant=\"primary\"\n >\n <mds-badge slot=\"badge\" variant=\"amaranth\" tone=\"weak\" label=\"pdf\"></mds-badge>\n <mds-button slot=\"action\" tone=\"outline\" size=\"sm\" label=\"Scarica\"></mds-button>\n </mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Avatar Mode with Image\n\nSet `src` and `preview=\"avatar\"` to display a user photo as a round avatar instead of the default full-width image preview.\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n src=\"./avatar-sarah.jpeg\"\n preview=\"avatar\"\n subject=\"Sarah Ho\"\n message=\"Ciao, sono Sarah, questo e' il mio contatto, buona giornata!\"\n datetime=\"2024-06-01T10:15:00\"\n variant=\"primary\"\n tone=\"strong\"\n >\n <mds-button slot=\"action\" variant=\"success\" tone=\"weak\" size=\"sm\" label=\"Scrivi\"></mds-button>\n </mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Avatar Mode with Initials Fallback\n\nWhen no image is available, set `initials` and `preview=\"avatar\"`. The initials override `tone` and `variant` coloring so the user stays visually distinguishable.\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n initials=\"MG\"\n preview=\"avatar\"\n subject=\"Mario Giannini\"\n message=\"Ha modificato il documento condiviso\"\n datetime=\"2024-06-01T10:10:00\"\n ></mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Inline Image Preview\n\nOmit `preview=\"avatar\"` (or keep the default `image`) and supply `src` to show the image as a larger inline thumbnail - useful for file or media notifications.\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n src=\"./book-cover-01.webp\"\n subject=\"Anteprima immagine\"\n message=\"La copertina e' stata aggiornata\"\n datetime=\"2024-06-01T10:05:00\"\n ></mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Fixed Date Format\n\nUse any `dayjs`-compatible format string as `date-format` to show a static date instead of the default relative \"time ago\" display.\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n icon=\"mi/baseline/event\"\n subject=\"Promemoria riunione\"\n message=\"La riunione di progetto e' fissata per domani\"\n datetime=\"2024-06-01T09:00:00\"\n date-format=\"DD/MM/YYYY\"\n ></mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Listening to the Dismiss Event\n\nListen to `mdsPushNotificationItemClose` to handle cleanup when the user dismisses the item. The parent `<mds-push-notification>` does this automatically, but you can also add your own logic (e.g. marking the notification read in the server). The event carries the `id` of the item in `detail.id`.\n\n```javascript\ndocument\n .querySelector('mds-push-notification-item')\n .addEventListener('mdsPushNotificationItemClose', (event) => {\n markNotificationRead(event.detail.id);\n });\n```\n\n#### Styling Customization\n\nCustomize the item only through its public `--mds-push-notification-item-*` CSS custom properties.\n\n```css\n.app-notifications mds-push-notification-item {\n --mds-push-notification-item-shadow: var(--shadow-md-sharp);\n --mds-push-notification-item-message-line-clamp: 3;\n --mds-push-notification-item-subject-line-clamp: 2;\n}\n```\n",
48
+ "3. Mistakes": "Common incorrect uses of `<mds-push-notification-item>`. Each entry pairs the wrong form with the right one and a one-line reason. System-wide rules (boolean-as-string, shadow piercing, Tailwind color utilities, raw native event listening) live in [`agents/mistakes.md`](../../../../agents/mistakes.md) - they apply here too but are not repeated.\n\n#### Do Not Use the Item Outside Its Parent\n\n`<mds-push-notification-item>` is a compound child that must live inside [`<mds-push-notification>`](../mds-push-notification/AGENTS.md). The parent drives entry / exit animation, stacking, and auto-hide when the last item closes.\n\n```html\n<!-- INCORRECT -->\n<mds-push-notification-item\n icon=\"mi/baseline/email\"\n subject=\"Nuovo messaggio\"\n message=\"Hai ricevuto un nuovo messaggio\"\n></mds-push-notification-item>\n\n<!-- CORRECT -->\n<mds-push-notification>\n <mds-push-notification-item\n icon=\"mi/baseline/email\"\n subject=\"Nuovo messaggio\"\n message=\"Hai ricevuto un nuovo messaggio\"\n ></mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Do Not Put Content in the Default Slot\n\n`<mds-push-notification-item>` has no default slot. All text content goes through the `message` and `subject` props; interactive content goes into the named `action` or `badge` slots.\n\n```html\n<!-- INCORRECT -->\n<mds-push-notification-item>\n Hai un nuovo messaggio\n</mds-push-notification-item>\n\n<!-- CORRECT -->\n<mds-push-notification-item\n message=\"Hai un nuovo messaggio\"\n subject=\"Posta in arrivo\"\n></mds-push-notification-item>\n```\n\n#### Do Not Slot Arbitrary Content Into `action` Without `mds-button`\n\nThe `action` slot is designed for `<mds-button>` elements at `size=\"sm\"`. Slotting raw `<button>` or large components breaks layout alignment and loses Magma theming and keyboard semantics.\n\n```html\n<!-- INCORRECT -->\n<mds-push-notification-item subject=\"Richiesta\" message=\"Approva la richiesta di accesso\">\n <button slot=\"action\" class=\"btn\">Approva</button>\n</mds-push-notification-item>\n\n<!-- CORRECT -->\n<mds-push-notification-item subject=\"Richiesta\" message=\"Approva la richiesta di accesso\">\n <mds-button slot=\"action\" variant=\"success\" tone=\"weak\" size=\"sm\" label=\"Approva\"></mds-button>\n</mds-push-notification-item>\n```\n\n#### Do Not Mix `icon` and `src` With `preview=\"image\"`\n\nWhen `icon` is set, the component always renders an `<mds-avatar>` for the icon. If `src` is also set and `preview` is not `\"avatar\"`, an `<mds-img>` picture is rendered as well - producing two media areas side by side, which is almost never the intended layout. Pick one visual mode per notification.\n\n```html\n<!-- INCORRECT - both an icon avatar and an image preview render simultaneously -->\n<mds-push-notification-item\n icon=\"mi/baseline/photo\"\n src=\"./cover.jpg\"\n preview=\"image\"\n subject=\"Nuova foto\"\n message=\"La copertina e' stata aggiornata\"\n></mds-push-notification-item>\n\n<!-- CORRECT - icon only, no image -->\n<mds-push-notification-item\n icon=\"mi/baseline/photo\"\n subject=\"Nuova foto\"\n message=\"La copertina e' stata aggiornata\"\n></mds-push-notification-item>\n\n<!-- CORRECT - image preview only, no icon -->\n<mds-push-notification-item\n src=\"./cover.jpg\"\n subject=\"Nuova foto\"\n message=\"La copertina e' stata aggiornata\"\n></mds-push-notification-item>\n```\n\n#### Do Not Listen for the Native `close` DOM Event\n\nThe component emits `mdsPushNotificationItemClose`, not a native `close`. Listening for `close` never fires, and the `click` of the dismiss button does not leave the component (its handler calls `stopPropagation()`).\n\n```javascript\n// INCORRECT\nelement.addEventListener('close', handler);\n\n// CORRECT\nelement.addEventListener('mdsPushNotificationItemClose', handler);\n```\n\n#### Customize via Documented Vars, Not Internal Selectors\n\nThe supported customization surface is `--mds-push-notification-item-*` CSS custom properties and documented shadow parts (`actions`, `avatar`, `content`, `picture`). Targeting shadow-DOM internals via `::part()` on undocumented parts or via `>>>` will break on minor releases.\n\n```css\n/* INCORRECT */\nmds-push-notification-item::part(header) {\n font-weight: bold;\n}\nmds-push-notification-item >>> .message {\n color: red;\n}\n\n/* CORRECT */\nmds-push-notification-item {\n --mds-push-notification-item-message-line-clamp: 3;\n --mds-push-notification-item-shadow: var(--shadow-md-sharp);\n}\nmds-push-notification-item::part(content) {\n gap: calc(var(--spacing) * 200);\n}\n```\n"
49
49
  },
50
50
  "props": [
51
51
  {