@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",
@@ -24,8 +24,8 @@
24
24
  ],
25
25
  "usage": {
26
26
  "1. Description": "The `<mds-tab-item>` web component is the individual, clickable tab control of the Magma Design System, designed to be slotted into the default slot of its parent [`<mds-tab>`](../mds-tab/AGENTS.md). It acts as the trigger that switches the matching `content`-slotted panel inside the tab group.\n\n#### Semantic Behavior\n\n- **Compound child only**: Must be a direct child of `<mds-tab>` placed in its default slot; it is not used standalone, and the matching panel content is added separately into the parent's `content` slot (one per `<mds-tab-item>`, or none when the page shows the content itself). Mixing it with other child types breaks the parent's pairing.\n- **Link item**: With `href` the item renders a real link instead of a tab: it is announced as a link, with `aria-current` when selected, and the browser follows it, in a new tab on a modifier or middle click. A `click` listener on the item cancels the navigation with `preventDefault()` to route on the client; the selection still moves, except on a modifier click, which the browser opens elsewhere.\n- **Selection driven by the parent**: Clicking the item emits `mdsTabItemSelect`; `<mds-tab>` sets `selected` on the chosen item, clears it on the others, and reveals the corresponding panel.\n- **Initial selection**: Marking one item `selected` in markup tells the parent which tab is active on load.\n- **Focus reporting**: A key press emits `mdsTabItemFocus`, which the parent uses to scroll the focused tab into view; both events carry `{ target, value }` so the parent can resolve the item even with a custom `id`.\n- **Disabled guard**: When `disabled`, the item cannot be selected via pointer or keyboard.\n- **Sizing managed upstream**: `size` is pushed down from `<mds-tab>`, overriding the item's own `size` prop.\n\n#### Properties & Visual Configurations\n\nThis child does not use the shared `variant`/`tone` ladders; its props mirror the underlying `<mds-button>`.\n\n- **`value`**: Set this to identify the tab in the `mdsTabItemSelect` payload (and the parent's `mdsTabChange`) when you need to react to selection without relying on DOM index or `id`.\n- **`type`**: Defaults to `submit`; pick `button` for a plain tab that does not interact with a surrounding form. With `href` the item is a link and `type` has no effect.\n- **`icon`** / **`iconPosition`**: Add a leading (`left`, default) or trailing (`right`) glyph; use the trailing position for affordances like an external-link or dismiss hint.\n- **`await`**: Reflects the button's awaiting/loading state for tabs whose activation triggers an async operation.\n- **`size`**: Defaults to `md`, but is normally controlled by the parent's `size` prop, so set it on `<mds-tab>` for consistent sizing across all items.\n",
27
- "2. Pattern": "Correct and idiomatic ways to use the `<mds-tab-item>` 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#### Basic Tab Group\n\nThe canonical form. Place `<mds-tab-item>` elements in the default slot of [`<mds-tab>`](../mds-tab/AGENTS.md), with one matching panel element per item in the `content` slot. Mark the initially active tab with `selected`.\n\n```html\n<mds-tab>\n <mds-tab-item label=\"Dettagli\" selected></mds-tab-item>\n <mds-tab-item label=\"Allegati\"></mds-tab-item>\n <mds-tab-item label=\"Cronologia\"></mds-tab-item>\n\n <div slot=\"content\">\n <p>Contenuto della scheda Dettagli.</p>\n </div>\n <div slot=\"content\">\n <p>Elenco degli allegati.</p>\n </div>\n <div slot=\"content\">\n <p>Cronologia delle modifiche.</p>\n </div>\n</mds-tab>\n```\n\n#### Tabs with Icons\n\nUse the `icon` prop to add a glyph. `icon-position` defaults to `left`; set it to `right` for affordance glyphs such as external-link hints.\n\n```html\n<mds-tab>\n <mds-tab-item label=\"Profilo\" icon=\"mi/baseline/person\" selected></mds-tab-item>\n <mds-tab-item label=\"Impostazioni\" icon=\"mi/baseline/settings\"></mds-tab-item>\n <mds-tab-item label=\"Apri in nuova finestra\" icon=\"mi/baseline/open-in-new\" icon-position=\"right\"></mds-tab-item>\n\n <div slot=\"content\"><p>Sezione profilo.</p></div>\n <div slot=\"content\"><p>Sezione impostazioni.</p></div>\n <div slot=\"content\"><p>Sezione apertura esterna.</p></div>\n</mds-tab>\n```\n\n#### Disabled Tab\n\nSet the `disabled` boolean attribute to block selection via pointer and keyboard.\n\n```html\n<mds-tab>\n <mds-tab-item label=\"Attivo\" selected></mds-tab-item>\n <mds-tab-item label=\"Non disponibile\" disabled></mds-tab-item>\n\n <div slot=\"content\"><p>Contenuto attivo.</p></div>\n <div slot=\"content\"><p>Contenuto non ancora disponibile.</p></div>\n</mds-tab>\n```\n\n#### Controlled Selection via `value` and Event\n\nUse `value` to identify which tab was activated in the `mdsTabItemSelect` (or the parent's `mdsTabChange`) payload, instead of relying on DOM index.\n\n```html\n<mds-tab id=\"schede-pratica\">\n <mds-tab-item label=\"Dati generali\" value=\"dati\" selected></mds-tab-item>\n <mds-tab-item label=\"Documenti\" value=\"documenti\"></mds-tab-item>\n <mds-tab-item label=\"Note\" value=\"note\"></mds-tab-item>\n\n <div slot=\"content\"><p>Dati generali.</p></div>\n <div slot=\"content\"><p>Documenti allegati.</p></div>\n <div slot=\"content\"><p>Note operative.</p></div>\n</mds-tab>\n\n<script>\n document.getElementById('schede-pratica').addEventListener('mdsTabChange', (e) => {\n console.log('Tab attiva:', e.detail.value); // 'dati' | 'documenti' | 'note'\n });\n</script>\n```\n\n#### Consistent Sizing via the Parent\n\nSet `size` on `<mds-tab>` once; the parent propagates it to every child item automatically. Do not set `size` on individual items when they all share the same parent.\n\n```html\n<!-- Tutti i tab usano size=\"sm\" -->\n<mds-tab size=\"sm\">\n <mds-tab-item label=\"Riepilogo\" selected></mds-tab-item>\n <mds-tab-item label=\"Dettaglio\"></mds-tab-item>\n\n <div slot=\"content\"><p>Riepilogo.</p></div>\n <div slot=\"content\"><p>Dettaglio.</p></div>\n</mds-tab>\n```\n\n#### Link Items via `href`\n\nSet `href` on every item to make the strip a navigation: each item is a link the browser follows instead of a tab switching a panel, so omit the `content` slot. `<mds-tab-item>` has no `target` prop, so a plain click opens the link in the same window; a modifier or middle click opens it in a new tab. In a single-page app, register the router once with `NavigationService` (from `@maggioli-design-system/magma/services`): a plain click on an item is then routed on the client, and the selection still moves.\n\n```html\n<mds-tab>\n <mds-tab-item label=\"Pratiche\" href=\"/pratiche\" selected></mds-tab-item>\n <mds-tab-item label=\"Documenti\" href=\"/documenti\"></mds-tab-item>\n <mds-tab-item label=\"Pagamenti\" href=\"/pagamenti\"></mds-tab-item>\n</mds-tab>\n\n<script type=\"module\">\n import { NavigationService } from '@maggioli-design-system/magma/services';\n\n NavigationService.setHandler((href) => router.navigate(href));\n</script>\n```\n\nWithout a registered router, cancel the click on the item and route by hand: the component honours `preventDefault()`. Leave a modifier click alone, so that the browser opens the link in a new tab.\n\n```html\n<script>\n document.querySelectorAll('mds-tab-item[href]').forEach((item) => {\n item.addEventListener('click', (event) => {\n if (event.ctrlKey || event.metaKey || event.shiftKey || event.altKey) return;\n event.preventDefault();\n router.navigate(item.href);\n });\n });\n</script>\n```\n\n#### Async Loading Tab via `await`\n\nSet `await` while the tab's content is loading. The item renders an inline spinner and blocks interaction until you remove the attribute.\n\n```html\n<mds-tab>\n <mds-tab-item label=\"Anteprima\" await selected></mds-tab-item>\n <mds-tab-item label=\"Sorgente\"></mds-tab-item>\n\n <div slot=\"content\"><p>Caricamento in corso...</p></div>\n <div slot=\"content\"><p>Sorgente del documento.</p></div>\n</mds-tab>\n```\n\n#### Vertical Layout\n\nSet `direction=\"vertical\"` on the parent to stack the tabs alongside the panels.\n\n```html\n<mds-tab direction=\"vertical\">\n <mds-tab-item label=\"Generale\" selected></mds-tab-item>\n <mds-tab-item label=\"Sicurezza\"></mds-tab-item>\n <mds-tab-item label=\"Notifiche\"></mds-tab-item>\n\n <div slot=\"content\"><p>Impostazioni generali.</p></div>\n <div slot=\"content\"><p>Impostazioni di sicurezza.</p></div>\n <div slot=\"content\"><p>Preferenze notifiche.</p></div>\n</mds-tab>\n```\n\n#### CSS Customization\n\n`mds-tab-item` has no public CSS custom property: style it with its props (`size`, `icon`, `icon-position`), its `button` part and the public `--mds-tab-*` properties of the parent `mds-tab`. The resting, hover and selected states follow the parent and its `animation`. Use semantic color roles via `rgb(var(--magma-<role>))` so dark mode keeps working.\n\n```css\n.schede-contratto mds-tab {\n --mds-tab-tabs-background: rgb(var(--magma-wash-soft));\n}\n.schede-contratto mds-tab-item::part(button) {\n border-radius: var(--magma-radius-lg);\n}\n```\n",
28
- "3. Antipattern": "Common incorrect uses of `<mds-tab-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 `<mds-tab-item>` Outside `<mds-tab>`\n\nThe item communicates with its parent through Stencil's internal listener (`mdsTabItemSelect`); used standalone it has no tab-switching behavior and no aria context.\n\n```html\n<!-- INCORRECT -->\n<mds-tab-item label=\"Dettagli\" selected></mds-tab-item>\n\n<!-- CORRECT -->\n<mds-tab>\n <mds-tab-item label=\"Dettagli\" selected></mds-tab-item>\n <div slot=\"content\"><p>Contenuto dei dettagli.</p></div>\n</mds-tab>\n```\n\n#### Do Not Wrap `<mds-tab-item>` in a Div or Other Element\n\nThe parent finds the items anywhere inside it, but it lays out and styles only its direct slot children (`::slotted(mds-tab-item)`): a wrapper takes their place in the tab strip, so the items lose the strip layout and their stacking above the slider indicator.\n\n```html\n<!-- INCORRECT -->\n<mds-tab>\n <div class=\"tab-group\">\n <mds-tab-item label=\"Uno\" selected></mds-tab-item>\n <mds-tab-item label=\"Due\"></mds-tab-item>\n </div>\n <div slot=\"content\">...</div>\n <div slot=\"content\">...</div>\n</mds-tab>\n\n<!-- CORRECT -->\n<mds-tab>\n <mds-tab-item label=\"Uno\" selected></mds-tab-item>\n <mds-tab-item label=\"Due\"></mds-tab-item>\n <div slot=\"content\">...</div>\n <div slot=\"content\">...</div>\n</mds-tab>\n```\n\n#### Do Not Set `selected=\"false\"` to Deselect\n\n`selected` is a boolean attribute; `selected=\"false\"` leaves a `selected` attribute on the element that contradicts the state, so attribute selectors and checks still read the item as selected. Remove the attribute entirely to deselect.\n\n```html\n<!-- INCORRECT -->\n<mds-tab-item label=\"Archivio\" selected=\"false\"></mds-tab-item>\n\n<!-- CORRECT -->\n<mds-tab-item label=\"Archivio\"></mds-tab-item>\n```\n\n#### Do Not Slot `<mds-icon>` or HTML to Add an Icon\n\n`<mds-tab-item>` has no documented default slot for content; it is a button-like leaf element. Use the `icon` prop to add a glyph.\n\n```html\n<!-- INCORRECT -->\n<mds-tab-item>\n <mds-icon name=\"mi/baseline/settings\"></mds-icon>\n Impostazioni\n</mds-tab-item>\n\n<!-- CORRECT -->\n<mds-tab-item label=\"Impostazioni\" icon=\"mi/baseline/settings\"></mds-tab-item>\n```\n\n#### Do Not Override `size` on Individual Items When a Parent Size Is Set\n\nThe parent pushes its `size` down to every child item on load and whenever `size` changes. Setting `size` on individual items is overwritten and creates confusion about the source of truth.\n\n```html\n<!-- INCORRECT -->\n<mds-tab size=\"sm\">\n <mds-tab-item label=\"Uno\" size=\"lg\" selected></mds-tab-item>\n <mds-tab-item label=\"Due\" size=\"sm\"></mds-tab-item>\n <div slot=\"content\">...</div>\n <div slot=\"content\">...</div>\n</mds-tab>\n\n<!-- CORRECT -->\n<mds-tab size=\"sm\">\n <mds-tab-item label=\"Uno\" selected></mds-tab-item>\n <mds-tab-item label=\"Due\"></mds-tab-item>\n <div slot=\"content\">...</div>\n <div slot=\"content\">...</div>\n</mds-tab>\n```\n\n#### Do Not Pierce the Shadow DOM to Style the Inner Button\n\n`mds-tab-item` has no public CSS custom property: the only supported customization surface is the documented `button` shadow part and the public `--mds-tab-*` properties of the parent `mds-tab`. Targeting internals via `::part(button) >>> .button` or undocumented selectors couples your code to the implementation.\n\n```css\n/* INCORRECT */\nmds-tab-item::part(button) >>> .text {\n font-weight: 900;\n}\n\n/* CORRECT */\nmds-tab {\n --mds-tab-tabs-background: rgb(var(--magma-accent-surface));\n}\nmds-tab-item::part(button) {\n border-radius: var(--magma-radius-lg);\n}\n```\n\n#### Do Not Mix Content Panels and Tab Items Without a 1-to-1 Pairing\n\nThe parent resolves each content panel by index, matching it to the `mds-tab-item` at the same position. A mismatch breaks it: with fewer `slot=\"content\"` elements than tab items a tab shows no panel, with more the component throws while wiring them and no panel gets hidden. No panel at all is fine: the strip then only reports the selection, or navigates when the items have `href`.\n\n```html\n<!-- INCORRECT - two items, one content panel -->\n<mds-tab>\n <mds-tab-item label=\"Uno\" selected></mds-tab-item>\n <mds-tab-item label=\"Due\"></mds-tab-item>\n <div slot=\"content\"><p>Contenuto unico.</p></div>\n</mds-tab>\n\n<!-- CORRECT - one content panel per tab item -->\n<mds-tab>\n <mds-tab-item label=\"Uno\" selected></mds-tab-item>\n <mds-tab-item label=\"Due\"></mds-tab-item>\n <div slot=\"content\"><p>Contenuto del tab Uno.</p></div>\n <div slot=\"content\"><p>Contenuto del tab Due.</p></div>\n</mds-tab>\n```\n\n#### Do Not Mix a Link Item with Panel Tabs\n\nA strip is either a `tablist` of tabs, each controlling a panel, or a navigation of links (`href` on every item): a link inside a tablist is not a child the role allows. Keep the link out of the strip, as an `<mds-button>` next to it (see [`mds-tab`](../mds-tab/AGENTS.md)).\n\n```html\n<!-- INCORRECT -->\n<mds-tab>\n <mds-tab-item label=\"Locale\" selected></mds-tab-item>\n <mds-tab-item label=\"Portale\" href=\"https://portale.example.com\"></mds-tab-item>\n <div slot=\"content\"><p>Vista locale.</p></div>\n <div slot=\"content\"></div>\n</mds-tab>\n\n<!-- CORRECT -->\n<mds-tab>\n <mds-tab-item label=\"Locale\" selected></mds-tab-item>\n <div slot=\"content\"><p>Vista locale.</p></div>\n</mds-tab>\n<mds-button label=\"Portale\" href=\"https://portale.example.com\" target=\"blank\" tone=\"text\"></mds-button>\n```\n"
27
+ "2. Examples": "Correct and idiomatic ways to use the `<mds-tab-item>` component, ordered from most common to most specialized. The examples assume a working knowledge of the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Basic Tab Group\n\nThe canonical form. Place `<mds-tab-item>` elements in the default slot of [`<mds-tab>`](../mds-tab/AGENTS.md), with one matching panel element per item in the `content` slot. Mark the initially active tab with `selected`.\n\n```html\n<mds-tab>\n <mds-tab-item label=\"Dettagli\" selected></mds-tab-item>\n <mds-tab-item label=\"Allegati\"></mds-tab-item>\n <mds-tab-item label=\"Cronologia\"></mds-tab-item>\n\n <div slot=\"content\">\n <p>Contenuto della scheda Dettagli.</p>\n </div>\n <div slot=\"content\">\n <p>Elenco degli allegati.</p>\n </div>\n <div slot=\"content\">\n <p>Cronologia delle modifiche.</p>\n </div>\n</mds-tab>\n```\n\n#### Tabs with Icons\n\nUse the `icon` prop to add a glyph. `icon-position` defaults to `left`; set it to `right` for affordance glyphs such as external-link hints.\n\n```html\n<mds-tab>\n <mds-tab-item label=\"Profilo\" icon=\"mi/baseline/person\" selected></mds-tab-item>\n <mds-tab-item label=\"Impostazioni\" icon=\"mi/baseline/settings\"></mds-tab-item>\n <mds-tab-item label=\"Apri in nuova finestra\" icon=\"mi/baseline/open-in-new\" icon-position=\"right\"></mds-tab-item>\n\n <div slot=\"content\"><p>Sezione profilo.</p></div>\n <div slot=\"content\"><p>Sezione impostazioni.</p></div>\n <div slot=\"content\"><p>Sezione apertura esterna.</p></div>\n</mds-tab>\n```\n\n#### Disabled Tab\n\nSet the `disabled` boolean attribute to block selection via pointer and keyboard.\n\n```html\n<mds-tab>\n <mds-tab-item label=\"Attivo\" selected></mds-tab-item>\n <mds-tab-item label=\"Non disponibile\" disabled></mds-tab-item>\n\n <div slot=\"content\"><p>Contenuto attivo.</p></div>\n <div slot=\"content\"><p>Contenuto non ancora disponibile.</p></div>\n</mds-tab>\n```\n\n#### Controlled Selection via `value` and Event\n\nUse `value` to identify which tab was activated in the `mdsTabItemSelect` (or the parent's `mdsTabChange`) payload, instead of relying on DOM index.\n\n```html\n<mds-tab id=\"schede-pratica\">\n <mds-tab-item label=\"Dati generali\" value=\"dati\" selected></mds-tab-item>\n <mds-tab-item label=\"Documenti\" value=\"documenti\"></mds-tab-item>\n <mds-tab-item label=\"Note\" value=\"note\"></mds-tab-item>\n\n <div slot=\"content\"><p>Dati generali.</p></div>\n <div slot=\"content\"><p>Documenti allegati.</p></div>\n <div slot=\"content\"><p>Note operative.</p></div>\n</mds-tab>\n\n<script>\n document.getElementById('schede-pratica').addEventListener('mdsTabChange', (e) => {\n console.log('Tab attiva:', e.detail.value); // 'dati' | 'documenti' | 'note'\n });\n</script>\n```\n\n#### Consistent Sizing via the Parent\n\nSet `size` on `<mds-tab>` once; the parent propagates it to every child item automatically. Do not set `size` on individual items when they all share the same parent.\n\n```html\n<!-- Tutti i tab usano size=\"sm\" -->\n<mds-tab size=\"sm\">\n <mds-tab-item label=\"Riepilogo\" selected></mds-tab-item>\n <mds-tab-item label=\"Dettaglio\"></mds-tab-item>\n\n <div slot=\"content\"><p>Riepilogo.</p></div>\n <div slot=\"content\"><p>Dettaglio.</p></div>\n</mds-tab>\n```\n\n#### Link Items via `href`\n\nSet `href` on every item to make the strip a navigation: each item is a link the browser follows instead of a tab switching a panel, so omit the `content` slot. `<mds-tab-item>` has no `target` prop, so a plain click opens the link in the same window; a modifier or middle click opens it in a new tab. In a single-page app, register the router once with `NavigationService` (from `@maggioli-design-system/magma/services`): a plain click on an item is then routed on the client, and the selection still moves.\n\n```html\n<mds-tab>\n <mds-tab-item label=\"Pratiche\" href=\"/pratiche\" selected></mds-tab-item>\n <mds-tab-item label=\"Documenti\" href=\"/documenti\"></mds-tab-item>\n <mds-tab-item label=\"Pagamenti\" href=\"/pagamenti\"></mds-tab-item>\n</mds-tab>\n\n<script type=\"module\">\n import { NavigationService } from '@maggioli-design-system/magma/services';\n\n NavigationService.setHandler((href) => router.navigate(href));\n</script>\n```\n\nWithout a registered router, cancel the click on the item and route by hand: the component honours `preventDefault()`. Leave a modifier click alone, so that the browser opens the link in a new tab.\n\n```html\n<script>\n document.querySelectorAll('mds-tab-item[href]').forEach((item) => {\n item.addEventListener('click', (event) => {\n if (event.ctrlKey || event.metaKey || event.shiftKey || event.altKey) return;\n event.preventDefault();\n router.navigate(item.href);\n });\n });\n</script>\n```\n\n#### Async Loading Tab via `await`\n\nSet `await` while the tab's content is loading. The item renders an inline spinner and blocks interaction until you remove the attribute.\n\n```html\n<mds-tab>\n <mds-tab-item label=\"Anteprima\" await selected></mds-tab-item>\n <mds-tab-item label=\"Sorgente\"></mds-tab-item>\n\n <div slot=\"content\"><p>Caricamento in corso...</p></div>\n <div slot=\"content\"><p>Sorgente del documento.</p></div>\n</mds-tab>\n```\n\n#### Vertical Layout\n\nSet `direction=\"vertical\"` on the parent to stack the tabs alongside the panels.\n\n```html\n<mds-tab direction=\"vertical\">\n <mds-tab-item label=\"Generale\" selected></mds-tab-item>\n <mds-tab-item label=\"Sicurezza\"></mds-tab-item>\n <mds-tab-item label=\"Notifiche\"></mds-tab-item>\n\n <div slot=\"content\"><p>Impostazioni generali.</p></div>\n <div slot=\"content\"><p>Impostazioni di sicurezza.</p></div>\n <div slot=\"content\"><p>Preferenze notifiche.</p></div>\n</mds-tab>\n```\n\n#### CSS Customization\n\n`mds-tab-item` has no public CSS custom property: style it with its props (`size`, `icon`, `icon-position`), its `button` part and the public `--mds-tab-*` properties of the parent `mds-tab`. The resting, hover and selected states follow the parent and its `animation`. Use semantic color roles via `rgb(var(--magma-<role>))` so dark mode keeps working.\n\n```css\n.schede-contratto mds-tab {\n --mds-tab-tabs-background: rgb(var(--magma-wash-soft));\n}\n.schede-contratto mds-tab-item::part(button) {\n border-radius: var(--magma-radius-lg);\n}\n```\n",
28
+ "3. Mistakes": "Common incorrect uses of `<mds-tab-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 `<mds-tab-item>` Outside `<mds-tab>`\n\nThe item communicates with its parent through Stencil's internal listener (`mdsTabItemSelect`); used standalone it has no tab-switching behavior and no aria context.\n\n```html\n<!-- INCORRECT -->\n<mds-tab-item label=\"Dettagli\" selected></mds-tab-item>\n\n<!-- CORRECT -->\n<mds-tab>\n <mds-tab-item label=\"Dettagli\" selected></mds-tab-item>\n <div slot=\"content\"><p>Contenuto dei dettagli.</p></div>\n</mds-tab>\n```\n\n#### Do Not Wrap `<mds-tab-item>` in a Div or Other Element\n\nThe parent finds the items anywhere inside it, but it lays out and styles only its direct slot children (`::slotted(mds-tab-item)`): a wrapper takes their place in the tab strip, so the items lose the strip layout and their stacking above the slider indicator.\n\n```html\n<!-- INCORRECT -->\n<mds-tab>\n <div class=\"tab-group\">\n <mds-tab-item label=\"Uno\" selected></mds-tab-item>\n <mds-tab-item label=\"Due\"></mds-tab-item>\n </div>\n <div slot=\"content\">...</div>\n <div slot=\"content\">...</div>\n</mds-tab>\n\n<!-- CORRECT -->\n<mds-tab>\n <mds-tab-item label=\"Uno\" selected></mds-tab-item>\n <mds-tab-item label=\"Due\"></mds-tab-item>\n <div slot=\"content\">...</div>\n <div slot=\"content\">...</div>\n</mds-tab>\n```\n\n#### Do Not Set `selected=\"false\"` to Deselect\n\n`selected` is a boolean attribute; `selected=\"false\"` leaves a `selected` attribute on the element that contradicts the state, so attribute selectors and checks still read the item as selected. Remove the attribute entirely to deselect.\n\n```html\n<!-- INCORRECT -->\n<mds-tab-item label=\"Archivio\" selected=\"false\"></mds-tab-item>\n\n<!-- CORRECT -->\n<mds-tab-item label=\"Archivio\"></mds-tab-item>\n```\n\n#### Do Not Slot `<mds-icon>` or HTML to Add an Icon\n\n`<mds-tab-item>` has no documented default slot for content; it is a button-like leaf element. Use the `icon` prop to add a glyph.\n\n```html\n<!-- INCORRECT -->\n<mds-tab-item>\n <mds-icon name=\"mi/baseline/settings\"></mds-icon>\n Impostazioni\n</mds-tab-item>\n\n<!-- CORRECT -->\n<mds-tab-item label=\"Impostazioni\" icon=\"mi/baseline/settings\"></mds-tab-item>\n```\n\n#### Do Not Override `size` on Individual Items When a Parent Size Is Set\n\nThe parent pushes its `size` down to every child item on load and whenever `size` changes. Setting `size` on individual items is overwritten and creates confusion about the source of truth.\n\n```html\n<!-- INCORRECT -->\n<mds-tab size=\"sm\">\n <mds-tab-item label=\"Uno\" size=\"lg\" selected></mds-tab-item>\n <mds-tab-item label=\"Due\" size=\"sm\"></mds-tab-item>\n <div slot=\"content\">...</div>\n <div slot=\"content\">...</div>\n</mds-tab>\n\n<!-- CORRECT -->\n<mds-tab size=\"sm\">\n <mds-tab-item label=\"Uno\" selected></mds-tab-item>\n <mds-tab-item label=\"Due\"></mds-tab-item>\n <div slot=\"content\">...</div>\n <div slot=\"content\">...</div>\n</mds-tab>\n```\n\n#### Do Not Pierce the Shadow DOM to Style the Inner Button\n\n`mds-tab-item` has no public CSS custom property: the only supported customization surface is the documented `button` shadow part and the public `--mds-tab-*` properties of the parent `mds-tab`. Targeting internals via `::part(button) >>> .button` or undocumented selectors couples your code to the implementation.\n\n```css\n/* INCORRECT */\nmds-tab-item::part(button) >>> .text {\n font-weight: 900;\n}\n\n/* CORRECT */\nmds-tab {\n --mds-tab-tabs-background: rgb(var(--magma-accent-surface));\n}\nmds-tab-item::part(button) {\n border-radius: var(--magma-radius-lg);\n}\n```\n\n#### Do Not Mix Content Panels and Tab Items Without a 1-to-1 Pairing\n\nThe parent resolves each content panel by index, matching it to the `mds-tab-item` at the same position. A mismatch breaks it: with fewer `slot=\"content\"` elements than tab items a tab shows no panel, with more the component throws while wiring them and no panel gets hidden. No panel at all is fine: the strip then only reports the selection, or navigates when the items have `href`.\n\n```html\n<!-- INCORRECT - two items, one content panel -->\n<mds-tab>\n <mds-tab-item label=\"Uno\" selected></mds-tab-item>\n <mds-tab-item label=\"Due\"></mds-tab-item>\n <div slot=\"content\"><p>Contenuto unico.</p></div>\n</mds-tab>\n\n<!-- CORRECT - one content panel per tab item -->\n<mds-tab>\n <mds-tab-item label=\"Uno\" selected></mds-tab-item>\n <mds-tab-item label=\"Due\"></mds-tab-item>\n <div slot=\"content\"><p>Contenuto del tab Uno.</p></div>\n <div slot=\"content\"><p>Contenuto del tab Due.</p></div>\n</mds-tab>\n```\n\n#### Do Not Mix a Link Item with Panel Tabs\n\nA strip is either a `tablist` of tabs, each controlling a panel, or a navigation of links (`href` on every item): a link inside a tablist is not a child the role allows. Keep the link out of the strip, as an `<mds-button>` next to it (see [`mds-tab`](../mds-tab/AGENTS.md)).\n\n```html\n<!-- INCORRECT -->\n<mds-tab>\n <mds-tab-item label=\"Locale\" selected></mds-tab-item>\n <mds-tab-item label=\"Portale\" href=\"https://portale.example.com\"></mds-tab-item>\n <div slot=\"content\"><p>Vista locale.</p></div>\n <div slot=\"content\"></div>\n</mds-tab>\n\n<!-- CORRECT -->\n<mds-tab>\n <mds-tab-item label=\"Locale\" selected></mds-tab-item>\n <div slot=\"content\"><p>Vista locale.</p></div>\n</mds-tab>\n<mds-button label=\"Portale\" href=\"https://portale.example.com\" target=\"blank\" tone=\"text\"></mds-button>\n```\n"
29
29
  },
30
30
  "props": [
31
31
  {
@@ -0,0 +1,174 @@
1
+ <!--
2
+ GENERATED FILE - do not edit by hand.
3
+ Source of truth: src/components/mds-tab-item/usage/ in the magma monorepo.
4
+ -->
5
+
6
+ # mds-tab-item - examples
7
+
8
+ > The API of this component: [`AGENTS.md`](AGENTS.md).
9
+
10
+ Correct and idiomatic ways to use the `<mds-tab-item>` component, ordered from most common to most specialized. The examples assume a working knowledge of the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).
11
+
12
+ #### Basic Tab Group
13
+
14
+ The canonical form. Place `<mds-tab-item>` elements in the default slot of [`<mds-tab>`](../mds-tab/AGENTS.md), with one matching panel element per item in the `content` slot. Mark the initially active tab with `selected`.
15
+
16
+ ```html
17
+ <mds-tab>
18
+ <mds-tab-item label="Dettagli" selected></mds-tab-item>
19
+ <mds-tab-item label="Allegati"></mds-tab-item>
20
+ <mds-tab-item label="Cronologia"></mds-tab-item>
21
+
22
+ <div slot="content">
23
+ <p>Contenuto della scheda Dettagli.</p>
24
+ </div>
25
+ <div slot="content">
26
+ <p>Elenco degli allegati.</p>
27
+ </div>
28
+ <div slot="content">
29
+ <p>Cronologia delle modifiche.</p>
30
+ </div>
31
+ </mds-tab>
32
+ ```
33
+
34
+ #### Tabs with Icons
35
+
36
+ Use the `icon` prop to add a glyph. `icon-position` defaults to `left`; set it to `right` for affordance glyphs such as external-link hints.
37
+
38
+ ```html
39
+ <mds-tab>
40
+ <mds-tab-item label="Profilo" icon="mi/baseline/person" selected></mds-tab-item>
41
+ <mds-tab-item label="Impostazioni" icon="mi/baseline/settings"></mds-tab-item>
42
+ <mds-tab-item label="Apri in nuova finestra" icon="mi/baseline/open-in-new" icon-position="right"></mds-tab-item>
43
+
44
+ <div slot="content"><p>Sezione profilo.</p></div>
45
+ <div slot="content"><p>Sezione impostazioni.</p></div>
46
+ <div slot="content"><p>Sezione apertura esterna.</p></div>
47
+ </mds-tab>
48
+ ```
49
+
50
+ #### Disabled Tab
51
+
52
+ Set the `disabled` boolean attribute to block selection via pointer and keyboard.
53
+
54
+ ```html
55
+ <mds-tab>
56
+ <mds-tab-item label="Attivo" selected></mds-tab-item>
57
+ <mds-tab-item label="Non disponibile" disabled></mds-tab-item>
58
+
59
+ <div slot="content"><p>Contenuto attivo.</p></div>
60
+ <div slot="content"><p>Contenuto non ancora disponibile.</p></div>
61
+ </mds-tab>
62
+ ```
63
+
64
+ #### Controlled Selection via `value` and Event
65
+
66
+ Use `value` to identify which tab was activated in the `mdsTabItemSelect` (or the parent's `mdsTabChange`) payload, instead of relying on DOM index.
67
+
68
+ ```html
69
+ <mds-tab id="schede-pratica">
70
+ <mds-tab-item label="Dati generali" value="dati" selected></mds-tab-item>
71
+ <mds-tab-item label="Documenti" value="documenti"></mds-tab-item>
72
+ <mds-tab-item label="Note" value="note"></mds-tab-item>
73
+
74
+ <div slot="content"><p>Dati generali.</p></div>
75
+ <div slot="content"><p>Documenti allegati.</p></div>
76
+ <div slot="content"><p>Note operative.</p></div>
77
+ </mds-tab>
78
+
79
+ <script>
80
+ document.getElementById('schede-pratica').addEventListener('mdsTabChange', (e) => {
81
+ console.log('Tab attiva:', e.detail.value); // 'dati' | 'documenti' | 'note'
82
+ });
83
+ </script>
84
+ ```
85
+
86
+ #### Consistent Sizing via the Parent
87
+
88
+ Set `size` on `<mds-tab>` once; the parent propagates it to every child item automatically. Do not set `size` on individual items when they all share the same parent.
89
+
90
+ ```html
91
+ <!-- Tutti i tab usano size="sm" -->
92
+ <mds-tab size="sm">
93
+ <mds-tab-item label="Riepilogo" selected></mds-tab-item>
94
+ <mds-tab-item label="Dettaglio"></mds-tab-item>
95
+
96
+ <div slot="content"><p>Riepilogo.</p></div>
97
+ <div slot="content"><p>Dettaglio.</p></div>
98
+ </mds-tab>
99
+ ```
100
+
101
+ #### Link Items via `href`
102
+
103
+ Set `href` on every item to make the strip a navigation: each item is a link the browser follows instead of a tab switching a panel, so omit the `content` slot. `<mds-tab-item>` has no `target` prop, so a plain click opens the link in the same window; a modifier or middle click opens it in a new tab. In a single-page app, register the router once with `NavigationService` (from `@maggioli-design-system/magma/services`): a plain click on an item is then routed on the client, and the selection still moves.
104
+
105
+ ```html
106
+ <mds-tab>
107
+ <mds-tab-item label="Pratiche" href="/pratiche" selected></mds-tab-item>
108
+ <mds-tab-item label="Documenti" href="/documenti"></mds-tab-item>
109
+ <mds-tab-item label="Pagamenti" href="/pagamenti"></mds-tab-item>
110
+ </mds-tab>
111
+
112
+ <script type="module">
113
+ import { NavigationService } from '@maggioli-design-system/magma/services';
114
+
115
+ NavigationService.setHandler((href) => router.navigate(href));
116
+ </script>
117
+ ```
118
+
119
+ Without a registered router, cancel the click on the item and route by hand: the component honours `preventDefault()`. Leave a modifier click alone, so that the browser opens the link in a new tab.
120
+
121
+ ```html
122
+ <script>
123
+ document.querySelectorAll('mds-tab-item[href]').forEach((item) => {
124
+ item.addEventListener('click', (event) => {
125
+ if (event.ctrlKey || event.metaKey || event.shiftKey || event.altKey) return;
126
+ event.preventDefault();
127
+ router.navigate(item.href);
128
+ });
129
+ });
130
+ </script>
131
+ ```
132
+
133
+ #### Async Loading Tab via `await`
134
+
135
+ Set `await` while the tab's content is loading. The item renders an inline spinner and blocks interaction until you remove the attribute.
136
+
137
+ ```html
138
+ <mds-tab>
139
+ <mds-tab-item label="Anteprima" await selected></mds-tab-item>
140
+ <mds-tab-item label="Sorgente"></mds-tab-item>
141
+
142
+ <div slot="content"><p>Caricamento in corso...</p></div>
143
+ <div slot="content"><p>Sorgente del documento.</p></div>
144
+ </mds-tab>
145
+ ```
146
+
147
+ #### Vertical Layout
148
+
149
+ Set `direction="vertical"` on the parent to stack the tabs alongside the panels.
150
+
151
+ ```html
152
+ <mds-tab direction="vertical">
153
+ <mds-tab-item label="Generale" selected></mds-tab-item>
154
+ <mds-tab-item label="Sicurezza"></mds-tab-item>
155
+ <mds-tab-item label="Notifiche"></mds-tab-item>
156
+
157
+ <div slot="content"><p>Impostazioni generali.</p></div>
158
+ <div slot="content"><p>Impostazioni di sicurezza.</p></div>
159
+ <div slot="content"><p>Preferenze notifiche.</p></div>
160
+ </mds-tab>
161
+ ```
162
+
163
+ #### CSS Customization
164
+
165
+ `mds-tab-item` has no public CSS custom property: style it with its props (`size`, `icon`, `icon-position`), its `button` part and the public `--mds-tab-*` properties of the parent `mds-tab`. The resting, hover and selected states follow the parent and its `animation`. Use semantic color roles via `rgb(var(--magma-<role>))` so dark mode keeps working.
166
+
167
+ ```css
168
+ .schede-contratto mds-tab {
169
+ --mds-tab-tabs-background: rgb(var(--magma-wash-soft));
170
+ }
171
+ .schede-contratto mds-tab-item::part(button) {
172
+ border-radius: var(--magma-radius-lg);
173
+ }
174
+ ```
@@ -52,7 +52,7 @@ export class MdsTabItem {
52
52
  }
53
53
  render() {
54
54
  var _a;
55
- return (h(Host, { key: 'b06f1e53601737f257dd54264d5a0e1f87792130', "pref-contrast": preferenceStore.state.contrast, "pref-mode": preferenceStore.state.mode, "pref-theme-scheme": preferenceStore.state['theme-scheme'] }, h("mds-button", { key: '549be08e1a94e8301931f4fdb145b77a68913df2', class: clsx('button', this.selected ? 'selected' : ''), await: this.await, disabled: (_a = this.disabled) !== null && _a !== void 0 ? _a : undefined, href: this.href, icon: this.icon, iconPosition: this.iconPosition, onKeyDown: this.focus, onClick: this.toggle, part: "button",
55
+ return (h(Host, { key: '1bd2e5db6838e13bad1315c6ea68afe6394d5d1b', "pref-contrast": preferenceStore.state.contrast, "pref-mode": preferenceStore.state.mode, "pref-theme-scheme": preferenceStore.state['theme-scheme'] }, h("mds-button", { key: 'de1bf92ee7e18246a70bbee0e7a823fc10dbaec7', class: clsx('button', this.selected ? 'selected' : ''), await: this.await, disabled: (_a = this.disabled) !== null && _a !== void 0 ? _a : undefined, href: this.href, icon: this.icon, iconPosition: this.iconPosition, onKeyDown: this.focus, onClick: this.toggle, part: "button",
56
56
  // a tab controls a panel; one with href is a link to another page or place, which
57
57
  // ARIA names as such, the selected one being the current one
58
58
  role: this.isLink() ? 'link' : 'tab', "aria-current": this.isLink() && this.selected ? 'true' : undefined, "aria-expanded": this.expanded === undefined ? undefined : `${this.expanded}`, label: this.label, size: this.size,
@@ -0,0 +1,159 @@
1
+ <!--
2
+ GENERATED FILE - do not edit by hand.
3
+ Source of truth: src/components/mds-tab-item/usage/ in the magma monorepo.
4
+ -->
5
+
6
+ # mds-tab-item - mistakes
7
+
8
+ > The API of this component: [`AGENTS.md`](AGENTS.md).
9
+
10
+ Common incorrect uses of `<mds-tab-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.
11
+
12
+ #### Do Not Use `<mds-tab-item>` Outside `<mds-tab>`
13
+
14
+ The item communicates with its parent through Stencil's internal listener (`mdsTabItemSelect`); used standalone it has no tab-switching behavior and no aria context.
15
+
16
+ ```html
17
+ <!-- INCORRECT -->
18
+ <mds-tab-item label="Dettagli" selected></mds-tab-item>
19
+
20
+ <!-- CORRECT -->
21
+ <mds-tab>
22
+ <mds-tab-item label="Dettagli" selected></mds-tab-item>
23
+ <div slot="content"><p>Contenuto dei dettagli.</p></div>
24
+ </mds-tab>
25
+ ```
26
+
27
+ #### Do Not Wrap `<mds-tab-item>` in a Div or Other Element
28
+
29
+ The parent finds the items anywhere inside it, but it lays out and styles only its direct slot children (`::slotted(mds-tab-item)`): a wrapper takes their place in the tab strip, so the items lose the strip layout and their stacking above the slider indicator.
30
+
31
+ ```html
32
+ <!-- INCORRECT -->
33
+ <mds-tab>
34
+ <div class="tab-group">
35
+ <mds-tab-item label="Uno" selected></mds-tab-item>
36
+ <mds-tab-item label="Due"></mds-tab-item>
37
+ </div>
38
+ <div slot="content">...</div>
39
+ <div slot="content">...</div>
40
+ </mds-tab>
41
+
42
+ <!-- CORRECT -->
43
+ <mds-tab>
44
+ <mds-tab-item label="Uno" selected></mds-tab-item>
45
+ <mds-tab-item label="Due"></mds-tab-item>
46
+ <div slot="content">...</div>
47
+ <div slot="content">...</div>
48
+ </mds-tab>
49
+ ```
50
+
51
+ #### Do Not Set `selected="false"` to Deselect
52
+
53
+ `selected` is a boolean attribute; `selected="false"` leaves a `selected` attribute on the element that contradicts the state, so attribute selectors and checks still read the item as selected. Remove the attribute entirely to deselect.
54
+
55
+ ```html
56
+ <!-- INCORRECT -->
57
+ <mds-tab-item label="Archivio" selected="false"></mds-tab-item>
58
+
59
+ <!-- CORRECT -->
60
+ <mds-tab-item label="Archivio"></mds-tab-item>
61
+ ```
62
+
63
+ #### Do Not Slot `<mds-icon>` or HTML to Add an Icon
64
+
65
+ `<mds-tab-item>` has no documented default slot for content; it is a button-like leaf element. Use the `icon` prop to add a glyph.
66
+
67
+ ```html
68
+ <!-- INCORRECT -->
69
+ <mds-tab-item>
70
+ <mds-icon name="mi/baseline/settings"></mds-icon>
71
+ Impostazioni
72
+ </mds-tab-item>
73
+
74
+ <!-- CORRECT -->
75
+ <mds-tab-item label="Impostazioni" icon="mi/baseline/settings"></mds-tab-item>
76
+ ```
77
+
78
+ #### Do Not Override `size` on Individual Items When a Parent Size Is Set
79
+
80
+ The parent pushes its `size` down to every child item on load and whenever `size` changes. Setting `size` on individual items is overwritten and creates confusion about the source of truth.
81
+
82
+ ```html
83
+ <!-- INCORRECT -->
84
+ <mds-tab size="sm">
85
+ <mds-tab-item label="Uno" size="lg" selected></mds-tab-item>
86
+ <mds-tab-item label="Due" size="sm"></mds-tab-item>
87
+ <div slot="content">...</div>
88
+ <div slot="content">...</div>
89
+ </mds-tab>
90
+
91
+ <!-- CORRECT -->
92
+ <mds-tab size="sm">
93
+ <mds-tab-item label="Uno" selected></mds-tab-item>
94
+ <mds-tab-item label="Due"></mds-tab-item>
95
+ <div slot="content">...</div>
96
+ <div slot="content">...</div>
97
+ </mds-tab>
98
+ ```
99
+
100
+ #### Do Not Pierce the Shadow DOM to Style the Inner Button
101
+
102
+ `mds-tab-item` has no public CSS custom property: the only supported customization surface is the documented `button` shadow part and the public `--mds-tab-*` properties of the parent `mds-tab`. Targeting internals via `::part(button) >>> .button` or undocumented selectors couples your code to the implementation.
103
+
104
+ ```css
105
+ /* INCORRECT */
106
+ mds-tab-item::part(button) >>> .text {
107
+ font-weight: 900;
108
+ }
109
+
110
+ /* CORRECT */
111
+ mds-tab {
112
+ --mds-tab-tabs-background: rgb(var(--magma-accent-surface));
113
+ }
114
+ mds-tab-item::part(button) {
115
+ border-radius: var(--magma-radius-lg);
116
+ }
117
+ ```
118
+
119
+ #### Do Not Mix Content Panels and Tab Items Without a 1-to-1 Pairing
120
+
121
+ The parent resolves each content panel by index, matching it to the `mds-tab-item` at the same position. A mismatch breaks it: with fewer `slot="content"` elements than tab items a tab shows no panel, with more the component throws while wiring them and no panel gets hidden. No panel at all is fine: the strip then only reports the selection, or navigates when the items have `href`.
122
+
123
+ ```html
124
+ <!-- INCORRECT - two items, one content panel -->
125
+ <mds-tab>
126
+ <mds-tab-item label="Uno" selected></mds-tab-item>
127
+ <mds-tab-item label="Due"></mds-tab-item>
128
+ <div slot="content"><p>Contenuto unico.</p></div>
129
+ </mds-tab>
130
+
131
+ <!-- CORRECT - one content panel per tab item -->
132
+ <mds-tab>
133
+ <mds-tab-item label="Uno" selected></mds-tab-item>
134
+ <mds-tab-item label="Due"></mds-tab-item>
135
+ <div slot="content"><p>Contenuto del tab Uno.</p></div>
136
+ <div slot="content"><p>Contenuto del tab Due.</p></div>
137
+ </mds-tab>
138
+ ```
139
+
140
+ #### Do Not Mix a Link Item with Panel Tabs
141
+
142
+ A strip is either a `tablist` of tabs, each controlling a panel, or a navigation of links (`href` on every item): a link inside a tablist is not a child the role allows. Keep the link out of the strip, as an `<mds-button>` next to it (see [`mds-tab`](../mds-tab/AGENTS.md)).
143
+
144
+ ```html
145
+ <!-- INCORRECT -->
146
+ <mds-tab>
147
+ <mds-tab-item label="Locale" selected></mds-tab-item>
148
+ <mds-tab-item label="Portale" href="https://portale.example.com"></mds-tab-item>
149
+ <div slot="content"><p>Vista locale.</p></div>
150
+ <div slot="content"></div>
151
+ </mds-tab>
152
+
153
+ <!-- CORRECT -->
154
+ <mds-tab>
155
+ <mds-tab-item label="Locale" selected></mds-tab-item>
156
+ <div slot="content"><p>Vista locale.</p></div>
157
+ </mds-tab>
158
+ <mds-button label="Portale" href="https://portale.example.com" target="blank" tone="text"></mds-button>
159
+ ```
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-table
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-table>` web component is the root container of the Magma Design System tabular data system. It wraps a native `<table>` and orchestrates a family of compound children (`mds-table-header`, `mds-table-body`, `mds-table-footer`, `mds-table-row`, `mds-table-cell`), propagating interaction, selection, and overflow state down to them.
12
12
 
@@ -32,10 +32,10 @@ The `<mds-table>` web component is the root container of the Magma Design System
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/layout-table--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-table>` web component is the root container of the Magma Design System tabular data system. It wraps a native `<table>` and orchestrates a family of compound children (`mds-table-header`, `mds-table-body`, `mds-table-footer`, `mds-table-row`, `mds-table-cell`), propagating interaction, selection, and overflow state down to them.\n\n#### Semantic Behavior\n\n- **Compound parent**: The default slot must hold `mds-table-header` / `mds-table-body` / `mds-table-footer`; `<mds-table>` pushes its own `interactive` and `selectable` state onto every `mds-table-row` and the header/body. It is not used standalone.\n- **Selection model**: When `selectable` is set, rows expose a checkbox; the component aggregates the selected rows, mirrors the count to the header's tristate control, and flags that a selection exists so it is visible to CSS and consumers.\n- **Selection event**: Emits `mdsTableSelectionChange` (bubbles, composed) carrying `{ rows }`, an array of `{ index, value }` for every selected row. It follows every change of a row's `selected`, from its checkbox or from code, and `selectAll(select?)`; changes made together are announced once. Both are no-ops unless `selectable` is true.\n- **Live children**: Rows added or removed at runtime are re-wired with the table's interactive and selectable state, so dynamically added rows behave consistently.\n- **Action overflow**: When rows carry a `[slot=\"action\"]`, rows flip into an overlaid-action mode once content exceeds the visible width. Rows and actions added after the first load are followed too: the header gains its Actions column and the new rows the overlay.\n- **Localization**: Resolves its display language from the page (`<html lang>`: `el`/`en`/`es`/`it`, otherwise `en`) for the batch-actions label.\n\n#### Properties & Visual Configurations\n\n- **`interactive`** highlights rows on mouseover; choose it for tables whose rows are clickable or navigable, not for purely static read-only data.\n- **`selectable`** turns on per-row checkbox selection and the aggregated header/batch-actions machinery; without it the selection methods and the `batch-action` slot are inert.\n- **`selection`** is a read-back flag that becomes true while at least one row is selected - it is managed internally, not something callers normally set.\n- **`sorting`** says who orders the rows when a sortable `mds-table-header-cell` changes direction. `internal` (default) moves the rows in the DOM; `external` leaves them where they are, so the application listens to `mdsTableHeaderCellSort` and renders the rows in the order asked. Choose `external` whenever the table shows one page of a larger set (with `mds-paginator`) or the order comes from a back end: sorting the DOM would only sort the page on screen.\n\n#### Other behavioral props\n\n- **`batch-action` slot** holds `mds-button` element/s; its bar renders only when `selectable` is on and at least one batch action is slotted, surfacing a live count badge of the current selection.\n",
47
- "2. Pattern": "Correct and idiomatic ways to use the `<mds-table>` 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#### Basic Read-Only Table\n\nThe minimal structure: `mds-table-header` with one `mds-table-header-cell` per column, `mds-table-body` with `mds-table-row` children each containing `mds-table-cell` elements. All four subparts are required direct children - do not replace them with raw `<thead>`, `<tr>`, or `<td>` elements.\n\n```html\n<mds-table>\n <mds-table-header>\n <mds-table-header-cell label=\"Nome\"></mds-table-header-cell>\n <mds-table-header-cell label=\"Email\"></mds-table-header-cell>\n <mds-table-header-cell label=\"Data iscrizione\"></mds-table-header-cell>\n </mds-table-header>\n <mds-table-body>\n <mds-table-row>\n <mds-table-cell><mds-text typography=\"detail\">Mario Rossi</mds-text></mds-table-cell>\n <mds-table-cell><mds-text typography=\"detail\">mario.rossi@example.com</mds-text></mds-table-cell>\n <mds-table-cell><mds-text typography=\"detail\">12 ottobre 1985</mds-text></mds-table-cell>\n </mds-table-row>\n <mds-table-row>\n <mds-table-cell><mds-text typography=\"detail\">Luigi Verdi</mds-text></mds-table-cell>\n <mds-table-cell><mds-text typography=\"detail\">luigi.verdi@example.com</mds-text></mds-table-cell>\n <mds-table-cell><mds-text typography=\"detail\">3 marzo 1993</mds-text></mds-table-cell>\n </mds-table-row>\n </mds-table-body>\n</mds-table>\n```\n\n#### Layout: Fill the Container and Let the Table Scroll\n\n`<mds-table>` scrolls on its own: its rows sit in an inner wrapper with `overflow: auto`, so when the columns are wider than the table, the table scrolls horizontally inside its own border, and the row actions (`slot=\"action\"`) stay pinned to the visible right edge. It needs no `overflow-x-auto` wrapper of yours, but it needs two things from the page:\n\n- **All the width its container offers**: `w-full` on `<mds-table>`. When that container is a flex or grid item (a `main` next to a sidebar, a `1fr` column), also give the item `min-w-0`: a flex or grid item never shrinks below its content by default, so without it the item grows to the full width of the table and the whole page scrolls instead of the table.\n- **Cells on one line**: `text-wrap: nowrap` on the cells (`[&_mds-table-cell]:text-nowrap` on the table). Wrapping cells squeeze the columns into tall rows and the table never scrolls. `mds-text` with `typography` `paragraph`, `detail` or `caption` sets its own `text-wrap: pretty`, which wins over what it inherits from the cell, so target it too (`[&_mds-text]:text-nowrap`). A long free-text column can keep wrapping if it reads better.\n\n```html\n<div class=\"flex\">\n <aside class=\"w-6400 shrink-0\">...</aside>\n <main class=\"min-w-0 flex-1\">\n <mds-table class=\"w-full [&_mds-table-cell]:text-nowrap [&_mds-text]:text-nowrap\">\n <mds-table-header>\n <mds-table-header-cell label=\"Protocollo\"></mds-table-header-cell>\n <mds-table-header-cell label=\"Oggetto\"></mds-table-header-cell>\n <mds-table-header-cell label=\"Ufficio\"></mds-table-header-cell>\n <mds-table-header-cell label=\"Data\"></mds-table-header-cell>\n </mds-table-header>\n <mds-table-body>\n <mds-table-row>\n <mds-table-cell><mds-text typography=\"detail\">2026/0412</mds-text></mds-table-cell>\n <mds-table-cell><mds-text typography=\"detail\">Contratto di fornitura servizi cloud 2026-2028</mds-text></mds-table-cell>\n <mds-table-cell><mds-text typography=\"detail\">Ufficio acquisti e gare</mds-text></mds-table-cell>\n <mds-table-cell><mds-text typography=\"detail\">12 marzo 2026</mds-text></mds-table-cell>\n </mds-table-row>\n </mds-table-body>\n </mds-table>\n </main>\n</div>\n```\n\nTo scroll vertically as well, bound the table's height: in a fixed-height panel, make the panel a flex column and give the table `flex-1 min-h-0` (or put `h-full` or a `max-h-*` on the table). The header row scrolls with the body, it is not sticky.\n\n```html\n<section class=\"flex h-9600 flex-col\">\n <mds-table class=\"min-h-0 flex-1 [&_mds-table-cell]:text-nowrap [&_mds-text]:text-nowrap\">\n ...\n </mds-table>\n</section>\n```\n\nWithout Tailwind, the same rules in CSS:\n\n```css\n.content {\n min-width: 0;\n}\n\n.content mds-table {\n width: 100%;\n}\n\n.content mds-table-cell,\n.content mds-table-cell mds-text {\n text-wrap: nowrap;\n}\n```\n\n#### Table with Footer\n\nAdd `mds-table-footer` after `mds-table-body` to show totals or summaries. Each cell inside the footer is an `mds-table-cell` - the same component used in body rows.\n\n```html\n<mds-table>\n <mds-table-header>\n <mds-table-header-cell label=\"Voce\"></mds-table-header-cell>\n <mds-table-header-cell label=\"Importo\"></mds-table-header-cell>\n </mds-table-header>\n <mds-table-body>\n <mds-table-row>\n <mds-table-cell><mds-text typography=\"detail\">Servizio A</mds-text></mds-table-cell>\n <mds-table-cell><mds-text typography=\"detail\">120,00 EUR</mds-text></mds-table-cell>\n </mds-table-row>\n <mds-table-row>\n <mds-table-cell><mds-text typography=\"detail\">Servizio B</mds-text></mds-table-cell>\n <mds-table-cell><mds-text typography=\"detail\">80,00 EUR</mds-text></mds-table-cell>\n </mds-table-row>\n </mds-table-body>\n <mds-table-footer>\n <mds-table-cell><mds-text typography=\"action\">Totale</mds-text></mds-table-cell>\n <mds-table-cell><mds-text typography=\"action\">200,00 EUR</mds-text></mds-table-cell>\n </mds-table-footer>\n</mds-table>\n```\n\n#### Interactive Rows\n\nSet `interactive` when rows are clickable or navigable. The prop propagates to every `mds-table-row` and highlights the hovered row. Do not reach into rows directly to set `interactive` - set it once on the parent.\n\n```html\n<mds-table interactive>\n <mds-table-header>\n <mds-table-header-cell label=\"Utente\"></mds-table-header-cell>\n <mds-table-header-cell label=\"Ruolo\"></mds-table-header-cell>\n </mds-table-header>\n <mds-table-body>\n <mds-table-row>\n <mds-table-cell><mds-text typography=\"detail\">Anna Bianchi</mds-text></mds-table-cell>\n <mds-table-cell><mds-text typography=\"detail\">Amministratore</mds-text></mds-table-cell>\n </mds-table-row>\n <mds-table-row>\n <mds-table-cell><mds-text typography=\"detail\">Carlo Neri</mds-text></mds-table-cell>\n <mds-table-cell><mds-text typography=\"detail\">Operatore</mds-text></mds-table-cell>\n </mds-table-row>\n </mds-table-body>\n</mds-table>\n```\n\n#### Row-Level Action Buttons\n\nSlot `mds-button` elements with `slot=\"action\"` directly inside `mds-table-row` (not inside `mds-table-cell`). The table detects the presence of action buttons and switches to overlay-action mode automatically when content overflows the visible width.\n\n```html\n<mds-table interactive>\n <mds-table-header>\n <mds-table-header-cell label=\"Documento\"></mds-table-header-cell>\n <mds-table-header-cell label=\"Stato\"></mds-table-header-cell>\n </mds-table-header>\n <mds-table-body>\n <mds-table-row>\n <mds-table-cell><mds-text typography=\"detail\">Contratto 2024.pdf</mds-text></mds-table-cell>\n <mds-table-cell><mds-text typography=\"detail\">Approvato</mds-text></mds-table-cell>\n <mds-button\n slot=\"action\"\n icon=\"mi/baseline/download\"\n title=\"Scarica documento\"\n variant=\"dark\"\n tone=\"text\"\n ></mds-button>\n <mds-button\n slot=\"action\"\n icon=\"mi/baseline/delete\"\n title=\"Elimina documento\"\n variant=\"error\"\n tone=\"text\"\n ></mds-button>\n </mds-table-row>\n </mds-table-body>\n</mds-table>\n```\n\n#### Row Selection and Selection Event\n\nSet `selectable` to add a checkbox to each row. Listen for `mdsTableSelectionChange` to receive the array of selected rows - each entry carries the row `index` and the optional `value` set on `mds-table-row`. Assign `value` to each row to distinguish selections in the event payload.\n\n```html\n<mds-table selectable id=\"tabella-utenti\">\n <mds-table-header>\n <mds-table-header-cell label=\"Nome\"></mds-table-header-cell>\n <mds-table-header-cell label=\"Reparto\"></mds-table-header-cell>\n </mds-table-header>\n <mds-table-body>\n <mds-table-row value=\"usr-001\">\n <mds-table-cell><mds-text typography=\"detail\">Giulia Russo</mds-text></mds-table-cell>\n <mds-table-cell><mds-text typography=\"detail\">Contabilita</mds-text></mds-table-cell>\n </mds-table-row>\n <mds-table-row value=\"usr-002\">\n <mds-table-cell><mds-text typography=\"detail\">Marco Ferrari</mds-text></mds-table-cell>\n <mds-table-cell><mds-text typography=\"detail\">IT</mds-text></mds-table-cell>\n </mds-table-row>\n </mds-table-body>\n</mds-table>\n\n<script>\n document.getElementById('tabella-utenti').addEventListener('mdsTableSelectionChange', (e) => {\n console.log('Righe selezionate:', e.detail.rows);\n // e.detail.rows => [{ index: 0, value: 'usr-001' }, ...]\n });\n</script>\n```\n\n#### Programmatic Select All\n\nCall the `selectAll()` method to select all rows at once; pass `false` to deselect. This is a no-op unless `selectable` is set.\n\n```html\n<mds-button id=\"btn-seleziona-tutti\" label=\"Seleziona tutti\" variant=\"primary\" tone=\"outline\"></mds-button>\n<mds-button id=\"btn-deseleziona\" label=\"Deseleziona tutti\" variant=\"dark\" tone=\"text\"></mds-button>\n\n<mds-table selectable id=\"tabella-doc\">\n <mds-table-header>\n <mds-table-header-cell label=\"Titolo\"></mds-table-header-cell>\n </mds-table-header>\n <mds-table-body>\n <mds-table-row value=\"doc-1\">\n <mds-table-cell><mds-text typography=\"detail\">Verbale assemblea</mds-text></mds-table-cell>\n </mds-table-row>\n <mds-table-row value=\"doc-2\">\n <mds-table-cell><mds-text typography=\"detail\">Bilancio 2024</mds-text></mds-table-cell>\n </mds-table-row>\n </mds-table-body>\n</mds-table>\n\n<script>\n const table = document.getElementById('tabella-doc');\n document.getElementById('btn-seleziona-tutti').addEventListener('click', () => table.selectAll());\n document.getElementById('btn-deseleziona').addEventListener('click', () => table.selectAll(false));\n</script>\n```\n\n#### Batch Actions Bar\n\nSlot `mds-button` elements with `slot=\"batch-action\"` as direct children of `mds-table` alongside the body. The bar renders only when `selectable` is set and at least one batch-action button is present, a button added after load included; it shows a live count badge of the current selection and appears once a row is checked.\n\n```html\n<mds-table selectable>\n <mds-table-header>\n <mds-table-header-cell label=\"Pratica\"></mds-table-header-cell>\n <mds-table-header-cell label=\"Stato\"></mds-table-header-cell>\n </mds-table-header>\n <mds-table-body>\n <mds-table-row value=\"prat-001\">\n <mds-table-cell><mds-text typography=\"detail\">Pratica n. 1234</mds-text></mds-table-cell>\n <mds-table-cell><mds-text typography=\"detail\">In lavorazione</mds-text></mds-table-cell>\n </mds-table-row>\n <mds-table-row value=\"prat-002\">\n <mds-table-cell><mds-text typography=\"detail\">Pratica n. 5678</mds-text></mds-table-cell>\n <mds-table-cell><mds-text typography=\"detail\">Chiusa</mds-text></mds-table-cell>\n </mds-table-row>\n </mds-table-body>\n <mds-button\n slot=\"batch-action\"\n icon=\"mi/outline/send\"\n label=\"Invia selezionati\"\n variant=\"dark\"\n tone=\"text\"\n ></mds-button>\n <mds-button\n slot=\"batch-action\"\n icon=\"mi/outline/delete\"\n label=\"Elimina selezionati\"\n variant=\"error\"\n tone=\"text\"\n ></mds-button>\n</mds-table>\n```\n\n#### Sorting by the Back End, with Pages\n\nWhen the table shows one page of a larger set, set `sorting=\"external\"`: a click on a sortable header emits `mdsTableHeaderCellSort` with the column (`index`, and `sortKey` when the cell has `sort-key`) and the `direction`, and moves no row. The application asks the back end for the first page in that order and renders it; the header shows the direction (icon and `aria-sort`). A `direction` set by the application, for example restored from the address, is shown the same way.\n\n```html\n<mds-table id=\"practices\" sorting=\"external\">\n <mds-table-header>\n <mds-table-header-cell label=\"Numero\" sortable sort-key=\"number\"></mds-table-header-cell>\n <mds-table-header-cell label=\"Ricevuta il\" sortable sort-key=\"received\"></mds-table-header-cell>\n <mds-table-header-cell label=\"Oggetto\"></mds-table-header-cell>\n </mds-table-header>\n <mds-table-body>\n <!-- the rows of the current page, rendered by the application -->\n </mds-table-body>\n</mds-table>\n<mds-paginator id=\"pages\" pages=\"12\"></mds-paginator>\n```\n\n```js\nconst table = document.querySelector('#practices');\nconst pages = document.querySelector('#pages');\n\ntable.addEventListener('mdsTableHeaderCellSort', async (event) => {\n const { sortKey, direction } = event.detail;\n // direction \"none\" asks for the order of the back end\n await loadPage({ page: 1, sort: direction === 'none' ? undefined : { sortKey, direction } });\n pages.currentPage = 1;\n});\n```\n\n#### Styling Customization\n\nCustomize the table appearance only through its public `--mds-table-*` CSS custom properties: the background, the text colour and the cell padding. Set them on the host element or a parent selector; use the semantic color roles via `rgb(var(--magma-<role>))` so dark mode and themes keep working.\n\n```css\n.tabella-contratti mds-table {\n --mds-table-background: rgb(var(--magma-surface-raised));\n --mds-table-cell-padding: calc(var(--spacing) * 500);\n --mds-table-color: rgb(var(--magma-text-default));\n}\n```\n\nThe frame of the table and the lines inside it - between the rows, under the header, above the footer and at the edge of the batch actions panel - take the `--magma-border-muted` role, so frame and grid read as one and follow the theme and the colour mode.\n",
48
- "3. Antipattern": "Common incorrect uses of `<mds-table>`. 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 Replace Compound Subparts with Raw HTML Elements\n\n`<mds-table>` orchestrates its children via internal Stencil mechanisms. Substituting any subpart (`mds-table-header`, `mds-table-body`, `mds-table-row`, `mds-table-cell`) with a raw `<thead>`, `<tbody>`, `<tr>`, or `<td>` breaks propagation of `interactive`, `selectable`, and overflow state.\n\n```html\n<!-- INCORRECT -->\n<mds-table>\n <thead>\n <tr><th>Nome</th><th>Email</th></tr>\n </thead>\n <tbody>\n <tr><td>Mario Rossi</td><td>mario.rossi@example.com</td></tr>\n </tbody>\n</mds-table>\n\n<!-- CORRECT -->\n<mds-table>\n <mds-table-header>\n <mds-table-header-cell label=\"Nome\"></mds-table-header-cell>\n <mds-table-header-cell label=\"Email\"></mds-table-header-cell>\n </mds-table-header>\n <mds-table-body>\n <mds-table-row>\n <mds-table-cell><mds-text typography=\"detail\">Mario Rossi</mds-text></mds-table-cell>\n <mds-table-cell><mds-text typography=\"detail\">mario.rossi@example.com</mds-text></mds-table-cell>\n </mds-table-row>\n </mds-table-body>\n</mds-table>\n```\n\n#### Do Not Slot Batch-Action Buttons Inside the Body\n\nThe `slot=\"batch-action\"` must be a direct child of `<mds-table>`, not nested inside `mds-table-body` or any row. The component looks for `:scope > [slot=\"batch-action\"]` on load and whenever its children change, and the bar will not appear if the slot is misplaced.\n\n```html\n<!-- INCORRECT -->\n<mds-table selectable>\n <mds-table-body>\n <mds-table-row>...</mds-table-row>\n <mds-button slot=\"batch-action\" label=\"Elimina\" variant=\"error\" tone=\"text\"></mds-button>\n </mds-table-body>\n</mds-table>\n\n<!-- CORRECT -->\n<mds-table selectable>\n <mds-table-header>...</mds-table-header>\n <mds-table-body>\n <mds-table-row>...</mds-table-row>\n </mds-table-body>\n <mds-button slot=\"batch-action\" label=\"Elimina\" variant=\"error\" tone=\"text\"></mds-button>\n</mds-table>\n```\n\n#### Do Not Slot Row Action Buttons Inside `mds-table-cell`\n\nPer-row action buttons use `slot=\"action\"` on a direct child of `mds-table-row`, not wrapped inside an `mds-table-cell`. Placing them in a cell hides them (`mds-table-cell` has no `action` slot, so the button is not rendered) and breaks the overflow-detection logic that switches rows into overlay-action mode.\n\n```html\n<!-- INCORRECT -->\n<mds-table-row>\n <mds-table-cell><mds-text typography=\"detail\">Contratto.pdf</mds-text></mds-table-cell>\n <mds-table-cell>\n <mds-button slot=\"action\" icon=\"mi/baseline/delete\" title=\"Elimina\" variant=\"error\" tone=\"text\"></mds-button>\n </mds-table-cell>\n</mds-table-row>\n\n<!-- CORRECT -->\n<mds-table-row>\n <mds-table-cell><mds-text typography=\"detail\">Contratto.pdf</mds-text></mds-table-cell>\n <mds-button slot=\"action\" icon=\"mi/baseline/delete\" title=\"Elimina\" variant=\"error\" tone=\"text\"></mds-button>\n</mds-table-row>\n```\n\n#### Do Not Enable Batch Actions Without `selectable`\n\nThe batch-action bar only renders when `selectable` is set. Slotting batch-action buttons on a non-selectable table silently produces no bar and no selection count, causing the buttons to never appear.\n\n```html\n<!-- INCORRECT -->\n<mds-table>\n <mds-table-header>...</mds-table-header>\n <mds-table-body>...</mds-table-body>\n <mds-button slot=\"batch-action\" label=\"Esporta\" variant=\"primary\"></mds-button>\n</mds-table>\n\n<!-- CORRECT -->\n<mds-table selectable>\n <mds-table-header>...</mds-table-header>\n <mds-table-body>...</mds-table-body>\n <mds-button slot=\"batch-action\" label=\"Esporta\" variant=\"primary\"></mds-button>\n</mds-table>\n```\n\n#### Do Not Set `interactive` on Individual Rows\n\n`interactive` is a table-level prop that propagates automatically to every `mds-table-row`. Setting it directly on individual rows bypasses the table's state management and leads to inconsistent behavior when rows are added or removed at runtime.\n\n```html\n<!-- INCORRECT -->\n<mds-table>\n <mds-table-body>\n <mds-table-row interactive>...</mds-table-row>\n <mds-table-row>...</mds-table-row>\n </mds-table-body>\n</mds-table>\n\n<!-- CORRECT -->\n<mds-table interactive>\n <mds-table-body>\n <mds-table-row>...</mds-table-row>\n <mds-table-row>...</mds-table-row>\n </mds-table-body>\n</mds-table>\n```\n\n#### Do Not Listen for Native `change` Events to Track Selection\n\nSelection state is communicated via the `mdsTableSelectionChange` custom event. Native `change` events from the internal checkboxes do not bubble out of the shadow DOM reliably; always use the documented Magma event.\n\n```html\n<!-- INCORRECT -->\n<mds-table selectable id=\"tbl\">...</mds-table>\n<script>\n document.getElementById('tbl').addEventListener('change', (e) => {\n // unreliable - native events do not bubble from shadow DOM\n });\n</script>\n\n<!-- CORRECT -->\n<mds-table selectable id=\"tbl\">...</mds-table>\n<script>\n document.getElementById('tbl').addEventListener('mdsTableSelectionChange', (e) => {\n console.log('Righe selezionate:', e.detail.rows);\n });\n</script>\n```\n\n#### Do Not Set `selection` Manually\n\n`selection` is a reflected read-back attribute managed internally by the table. It becomes `true` when at least one row is selected and is intended for CSS attribute selectors or conditional logic in the host app. Setting it from outside does not change which rows are selected and will be overwritten on the next selection update. The table emits `mdsTableSelectionChange` before it updates `selection`, so inside that listener read `e.detail.rows`, not the attribute.\n\n```html\n<!-- INCORRECT -->\n<mds-table selectable selection>\n ...\n</mds-table>\n\n<!-- CORRECT - read it back, do not set it -->\n<mds-table selectable id=\"tbl\">\n ...\n</mds-table>\n<script>\n document.getElementById('tbl').addEventListener('mdsTableSelectionChange', (e) => {\n const hasSelection = e.detail.rows.length > 0;\n document.getElementById('panel-azioni').hidden = !hasSelection;\n });\n</script>\n```\n"
47
+ "2. Examples": "Correct and idiomatic ways to use the `<mds-table>` component, ordered from most common to most specialized. The examples assume a working knowledge of the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Basic Read-Only Table\n\nThe minimal structure: `mds-table-header` with one `mds-table-header-cell` per column, `mds-table-body` with `mds-table-row` children each containing `mds-table-cell` elements. All four subparts are required direct children - do not replace them with raw `<thead>`, `<tr>`, or `<td>` elements.\n\n```html\n<mds-table>\n <mds-table-header>\n <mds-table-header-cell label=\"Nome\"></mds-table-header-cell>\n <mds-table-header-cell label=\"Email\"></mds-table-header-cell>\n <mds-table-header-cell label=\"Data iscrizione\"></mds-table-header-cell>\n </mds-table-header>\n <mds-table-body>\n <mds-table-row>\n <mds-table-cell><mds-text typography=\"detail\">Mario Rossi</mds-text></mds-table-cell>\n <mds-table-cell><mds-text typography=\"detail\">mario.rossi@example.com</mds-text></mds-table-cell>\n <mds-table-cell><mds-text typography=\"detail\">12 ottobre 1985</mds-text></mds-table-cell>\n </mds-table-row>\n <mds-table-row>\n <mds-table-cell><mds-text typography=\"detail\">Luigi Verdi</mds-text></mds-table-cell>\n <mds-table-cell><mds-text typography=\"detail\">luigi.verdi@example.com</mds-text></mds-table-cell>\n <mds-table-cell><mds-text typography=\"detail\">3 marzo 1993</mds-text></mds-table-cell>\n </mds-table-row>\n </mds-table-body>\n</mds-table>\n```\n\n#### Layout: Fill the Container and Let the Table Scroll\n\n`<mds-table>` scrolls on its own: its rows sit in an inner wrapper with `overflow: auto`, so when the columns are wider than the table, the table scrolls horizontally inside its own border, and the row actions (`slot=\"action\"`) stay pinned to the visible right edge. It needs no `overflow-x-auto` wrapper of yours, but it needs two things from the page:\n\n- **All the width its container offers**: `w-full` on `<mds-table>`. When that container is a flex or grid item (a `main` next to a sidebar, a `1fr` column), also give the item `min-w-0`: a flex or grid item never shrinks below its content by default, so without it the item grows to the full width of the table and the whole page scrolls instead of the table.\n- **Cells on one line**: `text-wrap: nowrap` on the cells (`[&_mds-table-cell]:text-nowrap` on the table). Wrapping cells squeeze the columns into tall rows and the table never scrolls. `mds-text` with `typography` `paragraph`, `detail` or `caption` sets its own `text-wrap: pretty`, which wins over what it inherits from the cell, so target it too (`[&_mds-text]:text-nowrap`). A long free-text column can keep wrapping if it reads better.\n\n```html\n<div class=\"flex\">\n <aside class=\"w-6400 shrink-0\">...</aside>\n <main class=\"min-w-0 flex-1\">\n <mds-table class=\"w-full [&_mds-table-cell]:text-nowrap [&_mds-text]:text-nowrap\">\n <mds-table-header>\n <mds-table-header-cell label=\"Protocollo\"></mds-table-header-cell>\n <mds-table-header-cell label=\"Oggetto\"></mds-table-header-cell>\n <mds-table-header-cell label=\"Ufficio\"></mds-table-header-cell>\n <mds-table-header-cell label=\"Data\"></mds-table-header-cell>\n </mds-table-header>\n <mds-table-body>\n <mds-table-row>\n <mds-table-cell><mds-text typography=\"detail\">2026/0412</mds-text></mds-table-cell>\n <mds-table-cell><mds-text typography=\"detail\">Contratto di fornitura servizi cloud 2026-2028</mds-text></mds-table-cell>\n <mds-table-cell><mds-text typography=\"detail\">Ufficio acquisti e gare</mds-text></mds-table-cell>\n <mds-table-cell><mds-text typography=\"detail\">12 marzo 2026</mds-text></mds-table-cell>\n </mds-table-row>\n </mds-table-body>\n </mds-table>\n </main>\n</div>\n```\n\nTo scroll vertically as well, bound the table's height: in a fixed-height panel, make the panel a flex column and give the table `flex-1 min-h-0` (or put `h-full` or a `max-h-*` on the table). The header row scrolls with the body, it is not sticky.\n\n```html\n<section class=\"flex h-9600 flex-col\">\n <mds-table class=\"min-h-0 flex-1 [&_mds-table-cell]:text-nowrap [&_mds-text]:text-nowrap\">\n ...\n </mds-table>\n</section>\n```\n\nWithout Tailwind, the same rules in CSS:\n\n```css\n.content {\n min-width: 0;\n}\n\n.content mds-table {\n width: 100%;\n}\n\n.content mds-table-cell,\n.content mds-table-cell mds-text {\n text-wrap: nowrap;\n}\n```\n\n#### Table with Footer\n\nAdd `mds-table-footer` after `mds-table-body` to show totals or summaries. Each cell inside the footer is an `mds-table-cell` - the same component used in body rows.\n\n```html\n<mds-table>\n <mds-table-header>\n <mds-table-header-cell label=\"Voce\"></mds-table-header-cell>\n <mds-table-header-cell label=\"Importo\"></mds-table-header-cell>\n </mds-table-header>\n <mds-table-body>\n <mds-table-row>\n <mds-table-cell><mds-text typography=\"detail\">Servizio A</mds-text></mds-table-cell>\n <mds-table-cell><mds-text typography=\"detail\">120,00 EUR</mds-text></mds-table-cell>\n </mds-table-row>\n <mds-table-row>\n <mds-table-cell><mds-text typography=\"detail\">Servizio B</mds-text></mds-table-cell>\n <mds-table-cell><mds-text typography=\"detail\">80,00 EUR</mds-text></mds-table-cell>\n </mds-table-row>\n </mds-table-body>\n <mds-table-footer>\n <mds-table-cell><mds-text typography=\"action\">Totale</mds-text></mds-table-cell>\n <mds-table-cell><mds-text typography=\"action\">200,00 EUR</mds-text></mds-table-cell>\n </mds-table-footer>\n</mds-table>\n```\n\n#### Interactive Rows\n\nSet `interactive` when rows are clickable or navigable. The prop propagates to every `mds-table-row` and highlights the hovered row. Do not reach into rows directly to set `interactive` - set it once on the parent.\n\n```html\n<mds-table interactive>\n <mds-table-header>\n <mds-table-header-cell label=\"Utente\"></mds-table-header-cell>\n <mds-table-header-cell label=\"Ruolo\"></mds-table-header-cell>\n </mds-table-header>\n <mds-table-body>\n <mds-table-row>\n <mds-table-cell><mds-text typography=\"detail\">Anna Bianchi</mds-text></mds-table-cell>\n <mds-table-cell><mds-text typography=\"detail\">Amministratore</mds-text></mds-table-cell>\n </mds-table-row>\n <mds-table-row>\n <mds-table-cell><mds-text typography=\"detail\">Carlo Neri</mds-text></mds-table-cell>\n <mds-table-cell><mds-text typography=\"detail\">Operatore</mds-text></mds-table-cell>\n </mds-table-row>\n </mds-table-body>\n</mds-table>\n```\n\n#### Row-Level Action Buttons\n\nSlot `mds-button` elements with `slot=\"action\"` directly inside `mds-table-row` (not inside `mds-table-cell`). The table detects the presence of action buttons and switches to overlay-action mode automatically when content overflows the visible width.\n\n```html\n<mds-table interactive>\n <mds-table-header>\n <mds-table-header-cell label=\"Documento\"></mds-table-header-cell>\n <mds-table-header-cell label=\"Stato\"></mds-table-header-cell>\n </mds-table-header>\n <mds-table-body>\n <mds-table-row>\n <mds-table-cell><mds-text typography=\"detail\">Contratto 2024.pdf</mds-text></mds-table-cell>\n <mds-table-cell><mds-text typography=\"detail\">Approvato</mds-text></mds-table-cell>\n <mds-button\n slot=\"action\"\n icon=\"mi/baseline/download\"\n title=\"Scarica documento\"\n variant=\"dark\"\n tone=\"text\"\n ></mds-button>\n <mds-button\n slot=\"action\"\n icon=\"mi/baseline/delete\"\n title=\"Elimina documento\"\n variant=\"error\"\n tone=\"text\"\n ></mds-button>\n </mds-table-row>\n </mds-table-body>\n</mds-table>\n```\n\n#### Row Selection and Selection Event\n\nSet `selectable` to add a checkbox to each row. Listen for `mdsTableSelectionChange` to receive the array of selected rows - each entry carries the row `index` and the optional `value` set on `mds-table-row`. Assign `value` to each row to distinguish selections in the event payload.\n\n```html\n<mds-table selectable id=\"tabella-utenti\">\n <mds-table-header>\n <mds-table-header-cell label=\"Nome\"></mds-table-header-cell>\n <mds-table-header-cell label=\"Reparto\"></mds-table-header-cell>\n </mds-table-header>\n <mds-table-body>\n <mds-table-row value=\"usr-001\">\n <mds-table-cell><mds-text typography=\"detail\">Giulia Russo</mds-text></mds-table-cell>\n <mds-table-cell><mds-text typography=\"detail\">Contabilita</mds-text></mds-table-cell>\n </mds-table-row>\n <mds-table-row value=\"usr-002\">\n <mds-table-cell><mds-text typography=\"detail\">Marco Ferrari</mds-text></mds-table-cell>\n <mds-table-cell><mds-text typography=\"detail\">IT</mds-text></mds-table-cell>\n </mds-table-row>\n </mds-table-body>\n</mds-table>\n\n<script>\n document.getElementById('tabella-utenti').addEventListener('mdsTableSelectionChange', (e) => {\n console.log('Righe selezionate:', e.detail.rows);\n // e.detail.rows => [{ index: 0, value: 'usr-001' }, ...]\n });\n</script>\n```\n\n#### Programmatic Select All\n\nCall the `selectAll()` method to select all rows at once; pass `false` to deselect. This is a no-op unless `selectable` is set.\n\n```html\n<mds-button id=\"btn-seleziona-tutti\" label=\"Seleziona tutti\" variant=\"primary\" tone=\"outline\"></mds-button>\n<mds-button id=\"btn-deseleziona\" label=\"Deseleziona tutti\" variant=\"dark\" tone=\"text\"></mds-button>\n\n<mds-table selectable id=\"tabella-doc\">\n <mds-table-header>\n <mds-table-header-cell label=\"Titolo\"></mds-table-header-cell>\n </mds-table-header>\n <mds-table-body>\n <mds-table-row value=\"doc-1\">\n <mds-table-cell><mds-text typography=\"detail\">Verbale assemblea</mds-text></mds-table-cell>\n </mds-table-row>\n <mds-table-row value=\"doc-2\">\n <mds-table-cell><mds-text typography=\"detail\">Bilancio 2024</mds-text></mds-table-cell>\n </mds-table-row>\n </mds-table-body>\n</mds-table>\n\n<script>\n const table = document.getElementById('tabella-doc');\n document.getElementById('btn-seleziona-tutti').addEventListener('click', () => table.selectAll());\n document.getElementById('btn-deseleziona').addEventListener('click', () => table.selectAll(false));\n</script>\n```\n\n#### Batch Actions Bar\n\nSlot `mds-button` elements with `slot=\"batch-action\"` as direct children of `mds-table` alongside the body. The bar renders only when `selectable` is set and at least one batch-action button is present, a button added after load included; it shows a live count badge of the current selection and appears once a row is checked.\n\n```html\n<mds-table selectable>\n <mds-table-header>\n <mds-table-header-cell label=\"Pratica\"></mds-table-header-cell>\n <mds-table-header-cell label=\"Stato\"></mds-table-header-cell>\n </mds-table-header>\n <mds-table-body>\n <mds-table-row value=\"prat-001\">\n <mds-table-cell><mds-text typography=\"detail\">Pratica n. 1234</mds-text></mds-table-cell>\n <mds-table-cell><mds-text typography=\"detail\">In lavorazione</mds-text></mds-table-cell>\n </mds-table-row>\n <mds-table-row value=\"prat-002\">\n <mds-table-cell><mds-text typography=\"detail\">Pratica n. 5678</mds-text></mds-table-cell>\n <mds-table-cell><mds-text typography=\"detail\">Chiusa</mds-text></mds-table-cell>\n </mds-table-row>\n </mds-table-body>\n <mds-button\n slot=\"batch-action\"\n icon=\"mi/outline/send\"\n label=\"Invia selezionati\"\n variant=\"dark\"\n tone=\"text\"\n ></mds-button>\n <mds-button\n slot=\"batch-action\"\n icon=\"mi/outline/delete\"\n label=\"Elimina selezionati\"\n variant=\"error\"\n tone=\"text\"\n ></mds-button>\n</mds-table>\n```\n\n#### Sorting by the Back End, with Pages\n\nWhen the table shows one page of a larger set, set `sorting=\"external\"`: a click on a sortable header emits `mdsTableHeaderCellSort` with the column (`index`, and `sortKey` when the cell has `sort-key`) and the `direction`, and moves no row. The application asks the back end for the first page in that order and renders it; the header shows the direction (icon and `aria-sort`). A `direction` set by the application, for example restored from the address, is shown the same way.\n\n```html\n<mds-table id=\"practices\" sorting=\"external\">\n <mds-table-header>\n <mds-table-header-cell label=\"Numero\" sortable sort-key=\"number\"></mds-table-header-cell>\n <mds-table-header-cell label=\"Ricevuta il\" sortable sort-key=\"received\"></mds-table-header-cell>\n <mds-table-header-cell label=\"Oggetto\"></mds-table-header-cell>\n </mds-table-header>\n <mds-table-body>\n <!-- the rows of the current page, rendered by the application -->\n </mds-table-body>\n</mds-table>\n<mds-paginator id=\"pages\" pages=\"12\"></mds-paginator>\n```\n\n```js\nconst table = document.querySelector('#practices');\nconst pages = document.querySelector('#pages');\n\ntable.addEventListener('mdsTableHeaderCellSort', async (event) => {\n const { sortKey, direction } = event.detail;\n // direction \"none\" asks for the order of the back end\n await loadPage({ page: 1, sort: direction === 'none' ? undefined : { sortKey, direction } });\n pages.currentPage = 1;\n});\n```\n\n#### Styling Customization\n\nCustomize the table appearance only through its public `--mds-table-*` CSS custom properties: the background, the text colour and the cell padding. Set them on the host element or a parent selector; use the semantic color roles via `rgb(var(--magma-<role>))` so dark mode and themes keep working.\n\n```css\n.tabella-contratti mds-table {\n --mds-table-background: rgb(var(--magma-surface-raised));\n --mds-table-cell-padding: calc(var(--spacing) * 500);\n --mds-table-color: rgb(var(--magma-text-default));\n}\n```\n\nThe frame of the table and the lines inside it - between the rows, under the header, above the footer and at the edge of the batch actions panel - take the `--magma-border-muted` role, so frame and grid read as one and follow the theme and the colour mode.\n",
48
+ "3. Mistakes": "Common incorrect uses of `<mds-table>`. 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 Replace Compound Subparts with Raw HTML Elements\n\n`<mds-table>` orchestrates its children via internal Stencil mechanisms. Substituting any subpart (`mds-table-header`, `mds-table-body`, `mds-table-row`, `mds-table-cell`) with a raw `<thead>`, `<tbody>`, `<tr>`, or `<td>` breaks propagation of `interactive`, `selectable`, and overflow state.\n\n```html\n<!-- INCORRECT -->\n<mds-table>\n <thead>\n <tr><th>Nome</th><th>Email</th></tr>\n </thead>\n <tbody>\n <tr><td>Mario Rossi</td><td>mario.rossi@example.com</td></tr>\n </tbody>\n</mds-table>\n\n<!-- CORRECT -->\n<mds-table>\n <mds-table-header>\n <mds-table-header-cell label=\"Nome\"></mds-table-header-cell>\n <mds-table-header-cell label=\"Email\"></mds-table-header-cell>\n </mds-table-header>\n <mds-table-body>\n <mds-table-row>\n <mds-table-cell><mds-text typography=\"detail\">Mario Rossi</mds-text></mds-table-cell>\n <mds-table-cell><mds-text typography=\"detail\">mario.rossi@example.com</mds-text></mds-table-cell>\n </mds-table-row>\n </mds-table-body>\n</mds-table>\n```\n\n#### Do Not Slot Batch-Action Buttons Inside the Body\n\nThe `slot=\"batch-action\"` must be a direct child of `<mds-table>`, not nested inside `mds-table-body` or any row. The component looks for `:scope > [slot=\"batch-action\"]` on load and whenever its children change, and the bar will not appear if the slot is misplaced.\n\n```html\n<!-- INCORRECT -->\n<mds-table selectable>\n <mds-table-body>\n <mds-table-row>...</mds-table-row>\n <mds-button slot=\"batch-action\" label=\"Elimina\" variant=\"error\" tone=\"text\"></mds-button>\n </mds-table-body>\n</mds-table>\n\n<!-- CORRECT -->\n<mds-table selectable>\n <mds-table-header>...</mds-table-header>\n <mds-table-body>\n <mds-table-row>...</mds-table-row>\n </mds-table-body>\n <mds-button slot=\"batch-action\" label=\"Elimina\" variant=\"error\" tone=\"text\"></mds-button>\n</mds-table>\n```\n\n#### Do Not Slot Row Action Buttons Inside `mds-table-cell`\n\nPer-row action buttons use `slot=\"action\"` on a direct child of `mds-table-row`, not wrapped inside an `mds-table-cell`. Placing them in a cell hides them (`mds-table-cell` has no `action` slot, so the button is not rendered) and breaks the overflow-detection logic that switches rows into overlay-action mode.\n\n```html\n<!-- INCORRECT -->\n<mds-table-row>\n <mds-table-cell><mds-text typography=\"detail\">Contratto.pdf</mds-text></mds-table-cell>\n <mds-table-cell>\n <mds-button slot=\"action\" icon=\"mi/baseline/delete\" title=\"Elimina\" variant=\"error\" tone=\"text\"></mds-button>\n </mds-table-cell>\n</mds-table-row>\n\n<!-- CORRECT -->\n<mds-table-row>\n <mds-table-cell><mds-text typography=\"detail\">Contratto.pdf</mds-text></mds-table-cell>\n <mds-button slot=\"action\" icon=\"mi/baseline/delete\" title=\"Elimina\" variant=\"error\" tone=\"text\"></mds-button>\n</mds-table-row>\n```\n\n#### Do Not Enable Batch Actions Without `selectable`\n\nThe batch-action bar only renders when `selectable` is set. Slotting batch-action buttons on a non-selectable table silently produces no bar and no selection count, causing the buttons to never appear.\n\n```html\n<!-- INCORRECT -->\n<mds-table>\n <mds-table-header>...</mds-table-header>\n <mds-table-body>...</mds-table-body>\n <mds-button slot=\"batch-action\" label=\"Esporta\" variant=\"primary\"></mds-button>\n</mds-table>\n\n<!-- CORRECT -->\n<mds-table selectable>\n <mds-table-header>...</mds-table-header>\n <mds-table-body>...</mds-table-body>\n <mds-button slot=\"batch-action\" label=\"Esporta\" variant=\"primary\"></mds-button>\n</mds-table>\n```\n\n#### Do Not Set `interactive` on Individual Rows\n\n`interactive` is a table-level prop that propagates automatically to every `mds-table-row`. Setting it directly on individual rows bypasses the table's state management and leads to inconsistent behavior when rows are added or removed at runtime.\n\n```html\n<!-- INCORRECT -->\n<mds-table>\n <mds-table-body>\n <mds-table-row interactive>...</mds-table-row>\n <mds-table-row>...</mds-table-row>\n </mds-table-body>\n</mds-table>\n\n<!-- CORRECT -->\n<mds-table interactive>\n <mds-table-body>\n <mds-table-row>...</mds-table-row>\n <mds-table-row>...</mds-table-row>\n </mds-table-body>\n</mds-table>\n```\n\n#### Do Not Listen for Native `change` Events to Track Selection\n\nSelection state is communicated via the `mdsTableSelectionChange` custom event. Native `change` events from the internal checkboxes do not bubble out of the shadow DOM reliably; always use the documented Magma event.\n\n```html\n<!-- INCORRECT -->\n<mds-table selectable id=\"tbl\">...</mds-table>\n<script>\n document.getElementById('tbl').addEventListener('change', (e) => {\n // unreliable - native events do not bubble from shadow DOM\n });\n</script>\n\n<!-- CORRECT -->\n<mds-table selectable id=\"tbl\">...</mds-table>\n<script>\n document.getElementById('tbl').addEventListener('mdsTableSelectionChange', (e) => {\n console.log('Righe selezionate:', e.detail.rows);\n });\n</script>\n```\n\n#### Do Not Set `selection` Manually\n\n`selection` is a reflected read-back attribute managed internally by the table. It becomes `true` when at least one row is selected and is intended for CSS attribute selectors or conditional logic in the host app. Setting it from outside does not change which rows are selected and will be overwritten on the next selection update. The table emits `mdsTableSelectionChange` before it updates `selection`, so inside that listener read `e.detail.rows`, not the attribute.\n\n```html\n<!-- INCORRECT -->\n<mds-table selectable selection>\n ...\n</mds-table>\n\n<!-- CORRECT - read it back, do not set it -->\n<mds-table selectable id=\"tbl\">\n ...\n</mds-table>\n<script>\n document.getElementById('tbl').addEventListener('mdsTableSelectionChange', (e) => {\n const hasSelection = e.detail.rows.length > 0;\n document.getElementById('panel-azioni').hidden = !hasSelection;\n });\n</script>\n```\n"
49
49
  },
50
50
  "props": [
51
51
  {