@maggioli-design-system/magma 2.7.0 → 2.9.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 (363) hide show
  1. package/AGENTS.md +1 -1
  2. package/CHANGELOG.md +45 -0
  3. package/agents/lint.md +20 -2
  4. package/dist/cjs/loader.cjs.js +1 -1
  5. package/dist/cjs/magma-components.cjs.js +1 -1
  6. package/dist/cjs/mds-banner_3.cjs.entry.js +7 -6
  7. package/dist/cjs/mds-book.cjs.entry.js +53 -5
  8. package/dist/cjs/mds-calendar_2.cjs.entry.js +1 -1
  9. package/dist/cjs/mds-emoji.cjs.entry.js +39 -9
  10. package/dist/cjs/mds-filter.cjs.entry.js +1 -1
  11. package/dist/cjs/mds-input-range.cjs.entry.js +1 -1
  12. package/dist/cjs/mds-modal.cjs.entry.js +1 -1
  13. package/dist/cjs/mds-push-notification-item.cjs.entry.js +17 -4
  14. package/dist/cjs/mds-toast.cjs.entry.js +2 -2
  15. package/dist/collection/components/mds-accordion/AGENTS.md +2 -1
  16. package/dist/collection/components/mds-accordion/documentation.json +4 -2
  17. package/dist/collection/components/mds-accordion-item/AGENTS.md +2 -1
  18. package/dist/collection/components/mds-accordion-item/documentation.json +4 -2
  19. package/dist/collection/components/mds-accordion-timer/AGENTS.md +2 -1
  20. package/dist/collection/components/mds-accordion-timer/documentation.json +4 -2
  21. package/dist/collection/components/mds-accordion-timer-item/AGENTS.md +2 -1
  22. package/dist/collection/components/mds-accordion-timer-item/documentation.json +4 -2
  23. package/dist/collection/components/mds-author/AGENTS.md +2 -1
  24. package/dist/collection/components/mds-author/documentation.json +4 -2
  25. package/dist/collection/components/mds-avatar/AGENTS.md +2 -1
  26. package/dist/collection/components/mds-avatar/documentation.json +4 -2
  27. package/dist/collection/components/mds-avatar-stack/AGENTS.md +2 -1
  28. package/dist/collection/components/mds-avatar-stack/documentation.json +4 -2
  29. package/dist/collection/components/mds-avatar-stack-item/AGENTS.md +2 -1
  30. package/dist/collection/components/mds-avatar-stack-item/documentation.json +4 -2
  31. package/dist/collection/components/mds-badge/AGENTS.md +2 -1
  32. package/dist/collection/components/mds-badge/documentation.json +4 -2
  33. package/dist/collection/components/mds-banner/AGENTS.md +7 -4
  34. package/dist/collection/components/mds-banner/antipattern.md +5 -5
  35. package/dist/collection/components/mds-banner/documentation.json +40 -6
  36. package/dist/collection/components/mds-banner/mds-banner.css +7 -10
  37. package/dist/collection/components/mds-banner/mds-banner.js +30 -7
  38. package/dist/collection/components/mds-banner/pattern.md +4 -4
  39. package/dist/collection/components/mds-benchmark-bar/AGENTS.md +2 -1
  40. package/dist/collection/components/mds-benchmark-bar/documentation.json +4 -2
  41. package/dist/collection/components/mds-bibliography/AGENTS.md +2 -1
  42. package/dist/collection/components/mds-bibliography/documentation.json +4 -2
  43. package/dist/collection/components/mds-book/AGENTS.md +9 -4
  44. package/dist/collection/components/mds-book/documentation.json +46 -6
  45. package/dist/collection/components/mds-book/mds-book.css +91 -7
  46. package/dist/collection/components/mds-book/mds-book.js +79 -7
  47. package/dist/collection/components/mds-book/pattern.md +14 -0
  48. package/dist/collection/components/mds-breadcrumb/AGENTS.md +2 -1
  49. package/dist/collection/components/mds-breadcrumb/documentation.json +4 -2
  50. package/dist/collection/components/mds-breadcrumb-item/AGENTS.md +2 -1
  51. package/dist/collection/components/mds-breadcrumb-item/documentation.json +4 -2
  52. package/dist/collection/components/mds-button/AGENTS.md +2 -1
  53. package/dist/collection/components/mds-button/documentation.json +4 -2
  54. package/dist/collection/components/mds-button-dropdown/AGENTS.md +2 -1
  55. package/dist/collection/components/mds-button-dropdown/documentation.json +4 -2
  56. package/dist/collection/components/mds-button-group/AGENTS.md +2 -1
  57. package/dist/collection/components/mds-button-group/documentation.json +4 -2
  58. package/dist/collection/components/mds-calendar/AGENTS.md +2 -1
  59. package/dist/collection/components/mds-calendar/documentation.json +4 -2
  60. package/dist/collection/components/mds-calendar-cell/AGENTS.md +2 -1
  61. package/dist/collection/components/mds-calendar-cell/documentation.json +4 -2
  62. package/dist/collection/components/mds-calendar-cell/mds-calendar-cell.css +4 -1
  63. package/dist/collection/components/mds-card/AGENTS.md +2 -1
  64. package/dist/collection/components/mds-card/documentation.json +4 -2
  65. package/dist/collection/components/mds-card-content/AGENTS.md +2 -1
  66. package/dist/collection/components/mds-card-content/documentation.json +4 -2
  67. package/dist/collection/components/mds-card-footer/AGENTS.md +2 -1
  68. package/dist/collection/components/mds-card-footer/documentation.json +4 -2
  69. package/dist/collection/components/mds-card-header/AGENTS.md +2 -1
  70. package/dist/collection/components/mds-card-header/documentation.json +4 -2
  71. package/dist/collection/components/mds-card-media/AGENTS.md +2 -1
  72. package/dist/collection/components/mds-card-media/documentation.json +4 -2
  73. package/dist/collection/components/mds-chip/AGENTS.md +2 -1
  74. package/dist/collection/components/mds-chip/documentation.json +4 -2
  75. package/dist/collection/components/mds-details/AGENTS.md +2 -1
  76. package/dist/collection/components/mds-details/documentation.json +4 -2
  77. package/dist/collection/components/mds-dropdown/AGENTS.md +2 -1
  78. package/dist/collection/components/mds-dropdown/documentation.json +4 -2
  79. package/dist/collection/components/mds-emoji/AGENTS.md +2 -1
  80. package/dist/collection/components/mds-emoji/asset/simi.svg +1 -1
  81. package/dist/collection/components/mds-emoji/documentation.json +4 -2
  82. package/dist/collection/components/mds-emoji/mds-emoji.js +38 -8
  83. package/dist/collection/components/mds-entity/AGENTS.md +2 -1
  84. package/dist/collection/components/mds-entity/documentation.json +4 -2
  85. package/dist/collection/components/mds-file/AGENTS.md +2 -1
  86. package/dist/collection/components/mds-file/documentation.json +4 -2
  87. package/dist/collection/components/mds-file-preview/AGENTS.md +2 -1
  88. package/dist/collection/components/mds-file-preview/documentation.json +4 -2
  89. package/dist/collection/components/mds-filter/AGENTS.md +3 -2
  90. package/dist/collection/components/mds-filter/documentation.json +10 -2
  91. package/dist/collection/components/mds-filter/mds-filter.css +5 -1
  92. package/dist/collection/components/mds-filter-item/AGENTS.md +2 -1
  93. package/dist/collection/components/mds-filter-item/documentation.json +4 -2
  94. package/dist/collection/components/mds-header/AGENTS.md +2 -1
  95. package/dist/collection/components/mds-header/documentation.json +5 -3
  96. package/dist/collection/components/mds-header/pattern.md +3 -3
  97. package/dist/collection/components/mds-header-bar/AGENTS.md +2 -1
  98. package/dist/collection/components/mds-header-bar/documentation.json +4 -2
  99. package/dist/collection/components/mds-help/AGENTS.md +2 -1
  100. package/dist/collection/components/mds-help/documentation.json +4 -2
  101. package/dist/collection/components/mds-horizontal-scroll/AGENTS.md +2 -1
  102. package/dist/collection/components/mds-horizontal-scroll/documentation.json +4 -2
  103. package/dist/collection/components/mds-hr/AGENTS.md +2 -1
  104. package/dist/collection/components/mds-hr/documentation.json +4 -2
  105. package/dist/collection/components/mds-icon/AGENTS.md +2 -1
  106. package/dist/collection/components/mds-icon/documentation.json +4 -2
  107. package/dist/collection/components/mds-img/AGENTS.md +2 -1
  108. package/dist/collection/components/mds-img/documentation.json +4 -2
  109. package/dist/collection/components/mds-input/AGENTS.md +2 -1
  110. package/dist/collection/components/mds-input/documentation.json +4 -2
  111. package/dist/collection/components/mds-input-date/AGENTS.md +2 -1
  112. package/dist/collection/components/mds-input-date/documentation.json +4 -2
  113. package/dist/collection/components/mds-input-date-range/AGENTS.md +2 -1
  114. package/dist/collection/components/mds-input-date-range/documentation.json +4 -2
  115. package/dist/collection/components/mds-input-date-range-preselection/AGENTS.md +2 -1
  116. package/dist/collection/components/mds-input-date-range-preselection/documentation.json +4 -2
  117. package/dist/collection/components/mds-input-field/AGENTS.md +2 -1
  118. package/dist/collection/components/mds-input-field/documentation.json +4 -2
  119. package/dist/collection/components/mds-input-otp/AGENTS.md +2 -1
  120. package/dist/collection/components/mds-input-otp/documentation.json +5 -3
  121. package/dist/collection/components/mds-input-otp/pattern.md +1 -1
  122. package/dist/collection/components/mds-input-range/AGENTS.md +2 -1
  123. package/dist/collection/components/mds-input-range/documentation.json +4 -2
  124. package/dist/collection/components/mds-input-range/mds-input-range.css +7 -5
  125. package/dist/collection/components/mds-input-select/AGENTS.md +2 -1
  126. package/dist/collection/components/mds-input-select/documentation.json +4 -2
  127. package/dist/collection/components/mds-input-switch/AGENTS.md +2 -1
  128. package/dist/collection/components/mds-input-switch/documentation.json +4 -2
  129. package/dist/collection/components/mds-input-tip/AGENTS.md +2 -1
  130. package/dist/collection/components/mds-input-tip/documentation.json +4 -2
  131. package/dist/collection/components/mds-input-tip-item/AGENTS.md +2 -1
  132. package/dist/collection/components/mds-input-tip-item/documentation.json +4 -2
  133. package/dist/collection/components/mds-input-upload/AGENTS.md +2 -1
  134. package/dist/collection/components/mds-input-upload/documentation.json +4 -2
  135. package/dist/collection/components/mds-keyboard/AGENTS.md +2 -1
  136. package/dist/collection/components/mds-keyboard/documentation.json +4 -2
  137. package/dist/collection/components/mds-keyboard-key/AGENTS.md +2 -1
  138. package/dist/collection/components/mds-keyboard-key/documentation.json +4 -2
  139. package/dist/collection/components/mds-kpi/AGENTS.md +2 -1
  140. package/dist/collection/components/mds-kpi/documentation.json +4 -2
  141. package/dist/collection/components/mds-kpi-item/AGENTS.md +2 -1
  142. package/dist/collection/components/mds-kpi-item/documentation.json +4 -2
  143. package/dist/collection/components/mds-label/AGENTS.md +2 -1
  144. package/dist/collection/components/mds-label/documentation.json +4 -2
  145. package/dist/collection/components/mds-link/AGENTS.md +2 -1
  146. package/dist/collection/components/mds-link/documentation.json +4 -2
  147. package/dist/collection/components/mds-list/AGENTS.md +2 -1
  148. package/dist/collection/components/mds-list/documentation.json +4 -2
  149. package/dist/collection/components/mds-list-item/AGENTS.md +2 -1
  150. package/dist/collection/components/mds-list-item/documentation.json +4 -2
  151. package/dist/collection/components/mds-mention/AGENTS.md +2 -1
  152. package/dist/collection/components/mds-mention/documentation.json +4 -2
  153. package/dist/collection/components/mds-modal/AGENTS.md +5 -1
  154. package/dist/collection/components/mds-modal/documentation.json +5 -3
  155. package/dist/collection/components/mds-modal/mds-modal.css +136 -3
  156. package/dist/collection/components/mds-note/AGENTS.md +2 -1
  157. package/dist/collection/components/mds-note/documentation.json +4 -2
  158. package/dist/collection/components/mds-notification/AGENTS.md +2 -1
  159. package/dist/collection/components/mds-notification/documentation.json +4 -2
  160. package/dist/collection/components/mds-paginator/AGENTS.md +2 -1
  161. package/dist/collection/components/mds-paginator/documentation.json +4 -2
  162. package/dist/collection/components/mds-paginator-item/AGENTS.md +2 -1
  163. package/dist/collection/components/mds-paginator-item/documentation.json +4 -2
  164. package/dist/collection/components/mds-policy-ai/AGENTS.md +2 -1
  165. package/dist/collection/components/mds-policy-ai/documentation.json +4 -2
  166. package/dist/collection/components/mds-pref/AGENTS.md +2 -1
  167. package/dist/collection/components/mds-pref/documentation.json +4 -2
  168. package/dist/collection/components/mds-pref-animation/AGENTS.md +2 -1
  169. package/dist/collection/components/mds-pref-animation/documentation.json +4 -2
  170. package/dist/collection/components/mds-pref-consumption/AGENTS.md +2 -1
  171. package/dist/collection/components/mds-pref-consumption/documentation.json +4 -2
  172. package/dist/collection/components/mds-pref-contrast/AGENTS.md +2 -1
  173. package/dist/collection/components/mds-pref-contrast/documentation.json +4 -2
  174. package/dist/collection/components/mds-pref-language/AGENTS.md +2 -1
  175. package/dist/collection/components/mds-pref-language/documentation.json +4 -2
  176. package/dist/collection/components/mds-pref-language-item/AGENTS.md +2 -1
  177. package/dist/collection/components/mds-pref-language-item/documentation.json +4 -2
  178. package/dist/collection/components/mds-pref-mode/AGENTS.md +2 -1
  179. package/dist/collection/components/mds-pref-mode/documentation.json +4 -2
  180. package/dist/collection/components/mds-pref-theme/AGENTS.md +2 -1
  181. package/dist/collection/components/mds-pref-theme/documentation.json +4 -2
  182. package/dist/collection/components/mds-pref-theme-item/AGENTS.md +2 -1
  183. package/dist/collection/components/mds-pref-theme-item/documentation.json +4 -2
  184. package/dist/collection/components/mds-price-table/AGENTS.md +2 -1
  185. package/dist/collection/components/mds-price-table/documentation.json +4 -2
  186. package/dist/collection/components/mds-price-table-features/AGENTS.md +2 -1
  187. package/dist/collection/components/mds-price-table-features/documentation.json +4 -2
  188. package/dist/collection/components/mds-price-table-features-cell/AGENTS.md +2 -1
  189. package/dist/collection/components/mds-price-table-features-cell/documentation.json +4 -2
  190. package/dist/collection/components/mds-price-table-features-row/AGENTS.md +2 -1
  191. package/dist/collection/components/mds-price-table-features-row/documentation.json +4 -2
  192. package/dist/collection/components/mds-price-table-header/AGENTS.md +2 -1
  193. package/dist/collection/components/mds-price-table-header/documentation.json +4 -2
  194. package/dist/collection/components/mds-price-table-list/AGENTS.md +2 -1
  195. package/dist/collection/components/mds-price-table-list/documentation.json +4 -2
  196. package/dist/collection/components/mds-price-table-list-item/AGENTS.md +2 -1
  197. package/dist/collection/components/mds-price-table-list-item/documentation.json +4 -2
  198. package/dist/collection/components/mds-progress/AGENTS.md +2 -1
  199. package/dist/collection/components/mds-progress/documentation.json +4 -2
  200. package/dist/collection/components/mds-push-notification/AGENTS.md +3 -2
  201. package/dist/collection/components/mds-push-notification/documentation.json +6 -4
  202. package/dist/collection/components/mds-push-notification/pattern.md +2 -2
  203. package/dist/collection/components/mds-push-notification-item/AGENTS.md +6 -3
  204. package/dist/collection/components/mds-push-notification-item/documentation.json +38 -5
  205. package/dist/collection/components/mds-push-notification-item/mds-push-notification-item.css +1 -0
  206. package/dist/collection/components/mds-push-notification-item/mds-push-notification-item.js +40 -5
  207. package/dist/collection/components/mds-push-notification-item/pattern.md +3 -3
  208. package/dist/collection/components/mds-quote/AGENTS.md +2 -1
  209. package/dist/collection/components/mds-quote/documentation.json +4 -2
  210. package/dist/collection/components/mds-radial-menu/AGENTS.md +2 -1
  211. package/dist/collection/components/mds-radial-menu/documentation.json +4 -2
  212. package/dist/collection/components/mds-radial-menu-item/AGENTS.md +2 -1
  213. package/dist/collection/components/mds-radial-menu-item/documentation.json +4 -2
  214. package/dist/collection/components/mds-radial-progress/AGENTS.md +2 -1
  215. package/dist/collection/components/mds-radial-progress/documentation.json +4 -2
  216. package/dist/collection/components/mds-separator/AGENTS.md +2 -1
  217. package/dist/collection/components/mds-separator/documentation.json +4 -2
  218. package/dist/collection/components/mds-spinner/AGENTS.md +2 -1
  219. package/dist/collection/components/mds-spinner/documentation.json +5 -3
  220. package/dist/collection/components/mds-spinner/pattern.md +9 -6
  221. package/dist/collection/components/mds-status-bar/AGENTS.md +2 -1
  222. package/dist/collection/components/mds-status-bar/documentation.json +4 -2
  223. package/dist/collection/components/mds-stepper-bar/AGENTS.md +2 -1
  224. package/dist/collection/components/mds-stepper-bar/documentation.json +4 -2
  225. package/dist/collection/components/mds-stepper-bar-item/AGENTS.md +2 -1
  226. package/dist/collection/components/mds-stepper-bar-item/documentation.json +4 -2
  227. package/dist/collection/components/mds-tab/AGENTS.md +2 -1
  228. package/dist/collection/components/mds-tab/documentation.json +4 -2
  229. package/dist/collection/components/mds-tab-bar/AGENTS.md +2 -1
  230. package/dist/collection/components/mds-tab-bar/documentation.json +4 -2
  231. package/dist/collection/components/mds-tab-bar-item/AGENTS.md +2 -1
  232. package/dist/collection/components/mds-tab-bar-item/documentation.json +4 -2
  233. package/dist/collection/components/mds-tab-item/AGENTS.md +2 -1
  234. package/dist/collection/components/mds-tab-item/documentation.json +4 -2
  235. package/dist/collection/components/mds-table/AGENTS.md +2 -1
  236. package/dist/collection/components/mds-table/documentation.json +4 -2
  237. package/dist/collection/components/mds-table-body/AGENTS.md +2 -1
  238. package/dist/collection/components/mds-table-body/documentation.json +4 -2
  239. package/dist/collection/components/mds-table-cell/AGENTS.md +2 -1
  240. package/dist/collection/components/mds-table-cell/documentation.json +4 -2
  241. package/dist/collection/components/mds-table-footer/AGENTS.md +2 -1
  242. package/dist/collection/components/mds-table-footer/documentation.json +4 -2
  243. package/dist/collection/components/mds-table-header/AGENTS.md +2 -1
  244. package/dist/collection/components/mds-table-header/documentation.json +4 -2
  245. package/dist/collection/components/mds-table-header-cell/AGENTS.md +2 -1
  246. package/dist/collection/components/mds-table-header-cell/documentation.json +4 -2
  247. package/dist/collection/components/mds-table-row/AGENTS.md +7 -2
  248. package/dist/collection/components/mds-table-row/documentation.json +11 -3
  249. package/dist/collection/components/mds-table-row/mds-table-row.css +1 -0
  250. package/dist/collection/components/mds-table-row/pattern.md +14 -1
  251. package/dist/collection/components/mds-text/AGENTS.md +2 -1
  252. package/dist/collection/components/mds-text/documentation.json +4 -2
  253. package/dist/collection/components/mds-toast/AGENTS.md +8 -5
  254. package/dist/collection/components/mds-toast/antipattern.md +2 -2
  255. package/dist/collection/components/mds-toast/documentation.json +40 -6
  256. package/dist/collection/components/mds-toast/mds-toast.js +26 -4
  257. package/dist/collection/components/mds-toast/pattern.md +2 -2
  258. package/dist/collection/components/mds-toast-region/AGENTS.md +2 -1
  259. package/dist/collection/components/mds-toast-region/documentation.json +5 -3
  260. package/dist/collection/components/mds-toast-region/pattern.md +10 -2
  261. package/dist/collection/components/mds-tooltip/AGENTS.md +2 -1
  262. package/dist/collection/components/mds-tooltip/documentation.json +4 -2
  263. package/dist/collection/components/mds-tree/AGENTS.md +3 -2
  264. package/dist/collection/components/mds-tree/documentation.json +5 -3
  265. package/dist/collection/components/mds-tree/pattern.md +13 -13
  266. package/dist/collection/components/mds-tree-item/AGENTS.md +2 -1
  267. package/dist/collection/components/mds-tree-item/documentation.json +4 -2
  268. package/dist/collection/components/mds-url-view/AGENTS.md +2 -1
  269. package/dist/collection/components/mds-url-view/documentation.json +4 -2
  270. package/dist/collection/components/mds-usage/AGENTS.md +2 -1
  271. package/dist/collection/components/mds-usage/documentation.json +4 -2
  272. package/dist/collection/components/mds-video-wall/AGENTS.md +2 -1
  273. package/dist/collection/components/mds-video-wall/documentation.json +4 -2
  274. package/dist/collection/components/mds-zero/AGENTS.md +2 -1
  275. package/dist/collection/components/mds-zero/documentation.json +4 -2
  276. package/dist/components/mds-banner.js +1 -1
  277. package/dist/components/mds-book.js +1 -1
  278. package/dist/components/mds-calendar-cell.js +1 -1
  279. package/dist/components/mds-calendar.js +1 -1
  280. package/dist/components/mds-emoji.js +1 -1
  281. package/dist/components/mds-filter.js +1 -1
  282. package/dist/components/mds-header.js +1 -1
  283. package/dist/components/mds-input-date-range.js +1 -1
  284. package/dist/components/mds-input-date.js +1 -1
  285. package/dist/components/mds-input-range.js +1 -1
  286. package/dist/components/mds-modal.js +1 -1
  287. package/dist/components/mds-policy-ai.js +1 -1
  288. package/dist/components/mds-push-notification-item.js +1 -1
  289. package/dist/components/mds-status-bar.js +1 -1
  290. package/dist/components/mds-toast.js +1 -1
  291. package/dist/components/p-BeZGLnJJ.js +1 -0
  292. package/dist/components/p-Chk4rI7N.js +1 -0
  293. package/dist/components/{p-CNpL55c-.js → p-Cwg4vtOr.js} +1 -1
  294. package/dist/components/p-Dzkiu-es.js +1 -0
  295. package/dist/documentation.json +406 -143
  296. package/dist/esm/loader.js +1 -1
  297. package/dist/esm/magma-components.js +1 -1
  298. package/dist/esm/mds-banner_3.entry.js +7 -6
  299. package/dist/esm/mds-book.entry.js +53 -5
  300. package/dist/esm/mds-calendar_2.entry.js +1 -1
  301. package/dist/esm/mds-emoji.entry.js +39 -9
  302. package/dist/esm/mds-filter.entry.js +1 -1
  303. package/dist/esm/mds-input-range.entry.js +1 -1
  304. package/dist/esm/mds-modal.entry.js +1 -1
  305. package/dist/esm/mds-push-notification-item.entry.js +17 -4
  306. package/dist/esm/mds-toast.entry.js +2 -2
  307. package/dist/esm-es5/loader.js +1 -1
  308. package/dist/esm-es5/magma-components.js +1 -1
  309. package/dist/esm-es5/mds-banner_3.entry.js +2 -2
  310. package/dist/esm-es5/mds-book.entry.js +33 -26
  311. package/dist/esm-es5/mds-calendar_2.entry.js +8 -8
  312. package/dist/esm-es5/mds-emoji.entry.js +40 -31
  313. package/dist/esm-es5/mds-filter.entry.js +1 -1
  314. package/dist/esm-es5/mds-input-range.entry.js +7 -7
  315. package/dist/esm-es5/mds-modal.entry.js +15 -15
  316. package/dist/esm-es5/mds-push-notification-item.entry.js +7 -3
  317. package/dist/esm-es5/mds-toast.entry.js +2 -2
  318. package/dist/hydrate/index.js +130 -32
  319. package/dist/hydrate/index.mjs +130 -32
  320. package/dist/lint/core/checks.d.ts +5 -0
  321. package/dist/lint/core/checks.js +17 -0
  322. package/dist/lint/core/data.d.ts +4 -1
  323. package/dist/lint/core/data.js +3 -1
  324. package/dist/lint/eslint/index.js +6 -4
  325. package/dist/magma-components/magma-components.esm.js +1 -1
  326. package/dist/magma-components/{p-354a5b47.entry.js → p-02b106c2.entry.js} +1 -1
  327. package/dist/magma-components/{p-17ccfc01.system.entry.js → p-3bc65166.system.entry.js} +55 -48
  328. package/dist/magma-components/p-425ca155.entry.js +1 -0
  329. package/dist/magma-components/p-523f0c30.system.entry.js +80 -0
  330. package/dist/magma-components/{p-07d35da6.entry.js → p-5306606b.entry.js} +1 -1
  331. package/dist/magma-components/{p-1b67b149.system.entry.js → p-798f460b.system.entry.js} +1 -1
  332. package/dist/magma-components/{p-e5f893f9.system.entry.js → p-7db14777.system.entry.js} +1 -1
  333. package/dist/magma-components/{p-e8452cce.entry.js → p-8641b7b2.entry.js} +1 -1
  334. package/dist/magma-components/{p-3a7c4314.system.entry.js → p-95ccf46d.system.entry.js} +4 -4
  335. package/dist/magma-components/p-968a2237.entry.js +1 -0
  336. package/dist/magma-components/p-9dd9eadd.entry.js +1 -0
  337. package/dist/magma-components/p-B8zYiZQY.system.js +1 -1
  338. package/dist/magma-components/{p-160cd923.entry.js → p-a25327a1.entry.js} +1 -1
  339. package/dist/magma-components/p-a67381bf.entry.js +1 -0
  340. package/dist/magma-components/{p-c2c693ed.system.entry.js → p-b27cb1ac.system.entry.js} +14 -5
  341. package/dist/magma-components/{p-6df26141.system.entry.js → p-c0286dc3.system.entry.js} +1 -1
  342. package/dist/magma-components/p-c89060ec.system.entry.js +41 -0
  343. package/dist/magma-components/p-eb12be86.system.entry.js +24 -0
  344. package/dist/magma-components/p-ebeb3fff.entry.js +1 -0
  345. package/dist/stats.json +383 -139
  346. package/dist/types/components/mds-banner/mds-banner.d.ts +9 -2
  347. package/dist/types/components/mds-book/mds-book.d.ts +19 -2
  348. package/dist/types/components/mds-emoji/mds-emoji.d.ts +1 -0
  349. package/dist/types/components/mds-push-notification-item/mds-push-notification-item.d.ts +10 -1
  350. package/dist/types/components/mds-toast/mds-toast.d.ts +7 -1
  351. package/dist/types/components.d.ts +56 -12
  352. package/package.json +8 -8
  353. package/dist/components/p-B8hgyXdE.js +0 -1
  354. package/dist/components/p-CYK2Xr_v.js +0 -1
  355. package/dist/components/p-DbVGGhs_.js +0 -1
  356. package/dist/magma-components/p-14b13850.entry.js +0 -1
  357. package/dist/magma-components/p-386bb24e.system.entry.js +0 -41
  358. package/dist/magma-components/p-6d96d223.entry.js +0 -1
  359. package/dist/magma-components/p-79fd07e7.system.entry.js +0 -80
  360. package/dist/magma-components/p-7e7391fd.entry.js +0 -1
  361. package/dist/magma-components/p-df387755.entry.js +0 -1
  362. package/dist/magma-components/p-ee780f82.system.entry.js +0 -20
  363. package/dist/magma-components/p-f2211b1f.entry.js +0 -1
@@ -17,6 +17,7 @@ mds-table-cell {
17
17
  * @prop --mds-table-row-background-hover: Background color for table row on hover.
18
18
  * @prop --mds-table-row-background-alt: Background color of the rows while a column sorts the table.
19
19
  * @prop --mds-table-row-actions-gap: Gap spacing for actions inside table rows.
20
+ * @prop --mds-table-row-actions-background: Public. Read-only: the background the actions box paints in the current state of the row (at rest, on hover, while a column sorts a selectable table), for content of the `action` slot that paints it too when it moves out of the box. The box sets it itself, so a value set from outside changes nothing.
20
21
  */
21
22
 
22
23
  :host {
@@ -142,7 +142,7 @@ Set `interactive` on the parent `<mds-table>` to enable per-row hover highlights
142
142
 
143
143
  #### Styling Customization
144
144
 
145
- `mds-table-row` has no public CSS custom property: a row takes its colours from the parent `mds-table-body` (and `mds-table`), and its hover, selected and sorted colours and the spacing of its actions follow its states. Restyle the rows through the public `--mds-table-body-*` or `--mds-table-*` properties of the parents. Use the semantic color roles wrapped in `rgb(var(--magma-<role>))` so dark mode and high-contrast modes stay consistent.
145
+ A row takes its colours from the parent `mds-table-body` (and `mds-table`), and its hover, selected and sorted colours and the spacing of its actions follow its states. Restyle the rows through the public `--mds-table-body-*` or `--mds-table-*` properties of the parents. Use the semantic color roles wrapped in `rgb(var(--magma-<role>))` so dark mode and high-contrast modes stay consistent.
146
146
 
147
147
  ```css
148
148
  /* Branded colours for the rows of a table */
@@ -151,3 +151,16 @@ Set `interactive` on the parent `<mds-table>` to enable per-row hover highlights
151
151
  --mds-table-body-color: rgb(var(--magma-text-default));
152
152
  }
153
153
  ```
154
+
155
+ The one public custom property of the row, `--mds-table-row-actions-background`, is read-only: it is the background the actions box paints in the current state of the row (at rest, on hover, while a column sorts a selectable table). Content of the `action` slot reads it to paint the same colour when it moves out of the box, for example a status that follows the part of a tall row on screen. Read it, never set it: the box sets it itself, so a value set from outside changes nothing.
156
+
157
+ ```html
158
+ <mds-table interactive>
159
+ <mds-table-body>
160
+ <mds-table-row value="p-01">
161
+ <mds-table-cell><mds-text typography="detail">Pratica 01</mds-text></mds-table-cell>
162
+ <mds-text slot="action" typography="detail" class="bg-(--mds-table-row-actions-background)">Copiato</mds-text>
163
+ </mds-table-row>
164
+ </mds-table-body>
165
+ </mds-table>
166
+ ```
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-text
8
8
 
9
- > `@maggioli-design-system/magma` 2.7.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
9
+ > `@maggioli-design-system/magma` 2.9.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
10
10
 
11
11
  The `<mds-text>` web component is the foundational typography primitive of the Magma Design System. It decouples the _semantic typography role_ of a piece of text from the _HTML element_ that renders it, replacing raw heading, paragraph, label and inline tags (`<h1>`-`<h6>`, `<p>`, `<span>`, `<label>`, `<code>`, ...) with a single design-tokenized text node that is consumed internally by nearly every other Magma component.
12
12
 
@@ -30,6 +30,7 @@ The `<mds-text>` web component is the foundational typography primitive of the M
30
30
 
31
31
  - [`pattern.md`](pattern.md) - correct usage, with examples
32
32
  - [`antipattern.md`](antipattern.md) - mistakes to avoid
33
+ - [Storybook](https://magma-design-system.github.io/magma/storybook/?path=/docs/design-typography--docs) - the live examples, in the published Storybook of `main`
33
34
  - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`anti-patterns.md`](../../../../agents/anti-patterns.md) - the rules shared by every component
34
35
 
35
36
  ## Props
@@ -1,10 +1,11 @@
1
1
  {
2
- "timestamp": "2026-10-24T18:39:37",
2
+ "timestamp": "2026-10-27T10:28:31",
3
3
  "compiler": {
4
4
  "name": "@stencil/core",
5
5
  "version": "4.45.2",
6
6
  "typescriptVersion": "5.8.3"
7
7
  },
8
+ "storybook": "https://magma-design-system.github.io/magma/storybook/",
8
9
  "components": [
9
10
  {
10
11
  "filePath": "src/components/mds-text/mds-text.tsx",
@@ -749,7 +750,8 @@
749
750
  "mds-usage": [
750
751
  "mds-text"
751
752
  ]
752
- }
753
+ },
754
+ "storybook": "design-typography--docs"
753
755
  }
754
756
  ]
755
757
  }
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-toast
8
8
 
9
- > `@maggioli-design-system/magma` 2.7.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
9
+ > `@maggioli-design-system/magma` 2.9.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
10
10
 
11
11
  The `<mds-toast>` web component is the transient notification surface of the Magma Design System, used to surface brief, non-blocking feedback messages that appear over the viewport and auto-dismiss after a timeout. It has no native HTML equivalent and orchestrates its own visibility, positioning, and auto-close lifecycle.
12
12
 
@@ -16,7 +16,7 @@ The `<mds-toast>` web component is the transient notification surface of the Mag
16
16
  - **Inside a region**: In an `<mds-toast-region>` the toast is laid out by the region, in a column with the other toasts visible at the same time, instead of being fixed at its edge on its own; the region gives it its `position`. A hidden toast in a region takes no room once its exit is over, and its entrance and exit are a short fade towards the edge.
17
17
  - **Auto-dismiss timer**: When `visible` is true and `duration` is a positive number, an internal timer counts down and then sets `visible` back to `false`; setting `duration` to `0` (or falsy) keeps the toast on screen until it is closed intentionally.
18
18
  - **The timer waits for the person**: The countdown stops while the pointer is over the toast or the focus is inside it (on its action, on its hide button), and goes on with the time that was left once both have left: the toast does not take its action away while the person is reading it or reaching the action.
19
- - **Hide button**: With `deletable`, the toast shows at its end a button with an arrow towards the edge it leaves by (down at the bottom, up at the top), named in the current language and reachable with the keyboard; it hides the toast. It is an arrow and not a cross because the action next to it may itself be a cancel ("Annulla"): the arrow only sends the message away.
19
+ - **Hide button**: With `dismissible`, the toast shows at its end a button with an arrow towards the edge it leaves by (down at the bottom, up at the top), named in the current language and reachable with the keyboard; it hides the toast. It is an arrow and not a cross because the action next to it may itself be a cancel ("Annulla"): the arrow only sends the message away.
20
20
  - **Close event**: Whenever the toast hides, the component emits `mdsToastClose` once, after the outro animation - consumers should listen for this to remove the toast from the DOM or update queue state. The `reason` of its detail says who hid it: `timeout` (the `duration` ran out), `close` (the person, with the hide button) or `hide` (your code removed `visible`). A toast shown again before the outro is over emits nothing for that hiding.
21
21
  - **Reactive timer**: Showing the toast again (`visible` back to true) or changing `duration` at runtime restarts the countdown; hiding it stops the countdown, so a toast hidden by your code closes once, as `hide`, and never again as `timeout`.
22
22
  - **Conditional regions**: The text region renders only when the host has inner content, and the action region is shown only while a `[slot="action"]` child is present, following the children added or removed later - empty slots produce no layout.
@@ -31,7 +31,8 @@ The shared `variant` / `tone` ladders are defined in [`agents/variants.md`](../.
31
31
  - **`position`** anchors the toast to one of the six viewport corners/edges (top or bottom, left/center/right), driving both placement and the direction of the entry/exit animation; pick the edge that matches where users expect ephemeral feedback to surface.
32
32
  - **`visible`** is the controlled on/off switch for the toast; toggling it drives the show/hide animation and the auto-dismiss timer rather than mounting or unmounting the element.
33
33
  - **`duration`** is the visibility window in milliseconds before auto-dismiss; use a longer value for messages that carry an action the user must reach, and `0` for toasts that must stay until explicitly closed.
34
- - **`deletable`** shows the hide button; give it to a toast that stays (`duration="0"`) when its action is not what every person wants ("Riprova"), so the person can send the message away without using it.
34
+ - **`dismissible`** shows the hide button; give it to a toast that stays (`duration="0"`) when its action is not what every person wants ("Riprova"), so the person can send the message away without using it.
35
+ - **`deletable`** is the old name of `dismissible`, deprecated: the button dismisses the message, it deletes nothing. It still works, and goes in the next major.
35
36
 
36
37
  #### Slots
37
38
 
@@ -41,14 +42,16 @@ The shared `variant` / `tone` ladders are defined in [`agents/variants.md`](../.
41
42
 
42
43
  - [`pattern.md`](pattern.md) - correct usage, with examples
43
44
  - [`antipattern.md`](antipattern.md) - mistakes to avoid
45
+ - [Storybook](https://magma-design-system.github.io/magma/storybook/?path=/docs/ui-toast--docs) - the live examples, in the published Storybook of `main`
44
46
  - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`anti-patterns.md`](../../../../agents/anti-patterns.md) - the rules shared by every component
45
47
 
46
48
  ## Props
47
49
 
48
50
  | Prop | Attribute | Type | Default | Description |
49
51
  | --- | --- | --- | --- | --- |
50
- | `deletable` | `deletable` | `boolean \| undefined` | - | Shows a button that hides the toast, an arrow towards the edge the toast leaves by |
51
- | `duration` | `duration` | `number \| undefined` | `5000` | If set, specifies the visibility duration in milliseconds of the element inside the viewport, when the time is up the visible property will be set to false. The countdown waits while the pointer is over the toast or the focus is inside it. If the duration is set to 0 the toast stays until it is hidden: give it `deletable` so the person can hide it too. |
52
+ | `deletable` | `deletable` | `boolean \| undefined` | - | **Deprecated**: Use `dismissible`: the button dismisses the message, it deletes nothing. Goes in the next major. Shows the hide button, as `dismissible` does. |
53
+ | `dismissible` | `dismissible` | `boolean \| undefined` | - | Shows a button that hides the toast, an arrow towards the edge the toast leaves by |
54
+ | `duration` | `duration` | `number \| undefined` | `5000` | If set, specifies the visibility duration in milliseconds of the element inside the viewport, when the time is up the visible property will be set to false. The countdown waits while the pointer is over the toast or the focus is inside it. If the duration is set to 0 the toast stays until it is hidden: give it `dismissible` so the person can hide it too. |
52
55
  | `position` | `position` | `"bottom-center" \| "bottom-left" \| "bottom-right" \| "top-center" \| "top-left" \| "top-right"` | `'bottom-center'` | Sets position of toast |
53
56
  | `tone` | `tone` | `"strong" \| "weak" \| undefined` | `'strong'` | Sets the tone of the color variant |
54
57
  | `variant` | `variant` | `"ai" \| "dark" \| "error" \| "info" \| "light" \| "primary" \| "success" \| "warning" \| undefined` | `'light'` | Sets the theme variant colours |
@@ -30,7 +30,7 @@ The default slot accepts plain text only; nested elements are rendered inside th
30
30
 
31
31
  #### Do Not Leave a Persistent Toast Without a Way to Send It Away
32
32
 
33
- A toast with `duration="0"` stays until something hides it. When its action is not what the person wants, nothing makes it go away: it covers the page until your code removes it. Add `deletable`.
33
+ A toast with `duration="0"` stays until something hides it. When its action is not what the person wants, nothing makes it go away: it covers the page until your code removes it. Add `dismissible`.
34
34
 
35
35
  ```html
36
36
  <!-- INCORRECT - only "Riprova" makes it go away -->
@@ -40,7 +40,7 @@ A toast with `duration="0"` stays until something hides it. When its action is n
40
40
  </mds-toast>
41
41
 
42
42
  <!-- CORRECT - the arrow sends the message away -->
43
- <mds-toast visible variant="error" duration="0" deletable>
43
+ <mds-toast visible variant="error" duration="0" dismissible>
44
44
  Invio non riuscito
45
45
  <mds-button slot="action" size="sm" variant="error" tone="weak">Riprova</mds-button>
46
46
  </mds-toast>
@@ -1,10 +1,11 @@
1
1
  {
2
- "timestamp": "2026-10-24T18:39:37",
2
+ "timestamp": "2026-10-27T10:28:31",
3
3
  "compiler": {
4
4
  "name": "@stencil/core",
5
5
  "version": "4.45.2",
6
6
  "typescriptVersion": "5.8.3"
7
7
  },
8
+ "storybook": "https://magma-design-system.github.io/magma/storybook/",
8
9
  "components": [
9
10
  {
10
11
  "filePath": "src/components/mds-toast/mds-toast.tsx",
@@ -30,9 +31,9 @@
30
31
  }
31
32
  ],
32
33
  "usage": {
33
- "1. Description": "The `<mds-toast>` web component is the transient notification surface of the Magma Design System, used to surface brief, non-blocking feedback messages that appear over the viewport and auto-dismiss after a timeout. It has no native HTML equivalent and orchestrates its own visibility, positioning, and auto-close lifecycle.\n\n#### Semantic Behavior\n\n- **Announced**: The host is a status region (`role=\"status\"`): the message is read out when the toast shows it, without moving the focus. While not visible, the message is hidden from assistive technologies too, not only moved out of the viewport. Inside an `<mds-toast-region>` the region is the status region and the toast has no role of its own.\n- **Inside a region**: In an `<mds-toast-region>` the toast is laid out by the region, in a column with the other toasts visible at the same time, instead of being fixed at its edge on its own; the region gives it its `position`. A hidden toast in a region takes no room once its exit is over, and its entrance and exit are a short fade towards the edge.\n- **Auto-dismiss timer**: When `visible` is true and `duration` is a positive number, an internal timer counts down and then sets `visible` back to `false`; setting `duration` to `0` (or falsy) keeps the toast on screen until it is closed intentionally.\n- **The timer waits for the person**: The countdown stops while the pointer is over the toast or the focus is inside it (on its action, on its hide button), and goes on with the time that was left once both have left: the toast does not take its action away while the person is reading it or reaching the action.\n- **Hide button**: With `deletable`, the toast shows at its end a button with an arrow towards the edge it leaves by (down at the bottom, up at the top), named in the current language and reachable with the keyboard; it hides the toast. It is an arrow and not a cross because the action next to it may itself be a cancel (\"Annulla\"): the arrow only sends the message away.\n- **Close event**: Whenever the toast hides, the component emits `mdsToastClose` once, after the outro animation - consumers should listen for this to remove the toast from the DOM or update queue state. The `reason` of its detail says who hid it: `timeout` (the `duration` ran out), `close` (the person, with the hide button) or `hide` (your code removed `visible`). A toast shown again before the outro is over emits nothing for that hiding.\n- **Reactive timer**: Showing the toast again (`visible` back to true) or changing `duration` at runtime restarts the countdown; hiding it stops the countdown, so a toast hidden by your code closes once, as `hide`, and never again as `timeout`.\n- **Conditional regions**: The text region renders only when the host has inner content, and the action region is shown only while a `[slot=\"action\"]` child is present, following the children added or removed later - empty slots produce no layout.\n- **Default-slot is text**: The default slot is intended for a plain text string only; icons go in the `icon` slot and interactive controls in the `action` slot.\n\n#### Properties & Visual Configurations\n\nThe shared `variant` / `tone` ladders are defined in [`agents/variants.md`](../../../../agents/variants.md); `<mds-toast>` consumes the theme variant set and the minimal tone set (`'strong'` / `'weak'`) without adding component-specific values.\n\n#### Other behavioral props\n\n- **`position`** anchors the toast to one of the six viewport corners/edges (top or bottom, left/center/right), driving both placement and the direction of the entry/exit animation; pick the edge that matches where users expect ephemeral feedback to surface.\n- **`visible`** is the controlled on/off switch for the toast; toggling it drives the show/hide animation and the auto-dismiss timer rather than mounting or unmounting the element.\n- **`duration`** is the visibility window in milliseconds before auto-dismiss; use a longer value for messages that carry an action the user must reach, and `0` for toasts that must stay until explicitly closed.\n- **`deletable`** shows the hide button; give it to a toast that stays (`duration=\"0\"`) when its action is not what every person wants (\"Riprova\"), so the person can send the message away without using it.\n\n#### Slots\n\n- **`icon`** holds a leading glyph (recommended `mds-icon`); **`action`** holds interactive follow-ups (recommended `mds-button`) and, when present, renders inside a dedicated actions container.\n",
34
- "2. Pattern": "Correct and idiomatic ways to use the `<mds-toast>` component, ordered from most common to most specialized. Patterns assume a working knowledge of the variant / tone ladders documented in [`agents/variants.md`](../../../../agents/variants.md) and the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Basic Text Toast\n\nThe simplest form. Set `visible` to show the toast; the default slot holds the message text only. The component auto-dismisses after the default 5000 ms.\n\n```html\n<mds-toast visible>\n Operazione completata con successo\n</mds-toast>\n```\n\n#### Status Variants\n\nUse `variant` to communicate the meaning of the feedback. The status family (`error`, `warning`, `info`, `success`) maps directly to the nature of the event. Do not pick a variant for its color alone.\n\n```html\n<!-- Conferma positiva -->\n<mds-toast visible variant=\"success\">\n Documento salvato correttamente\n</mds-toast>\n\n<!-- Errore bloccante -->\n<mds-toast visible variant=\"error\">\n Errore durante il salvataggio. Riprova.\n</mds-toast>\n\n<!-- Avviso non bloccante -->\n<mds-toast visible variant=\"warning\">\n La sessione scade tra 5 minuti\n</mds-toast>\n\n<!-- Informazione neutrale -->\n<mds-toast visible variant=\"info\">\n Aggiornamento disponibile\n</mds-toast>\n```\n\n#### Tone for Emphasis\n\nPair `variant` with `tone` to adjust visual weight. `strong` (default) uses the stronger tint of the variant and a larger shadow; `weak` uses a softer tint and a smaller shadow for lower emphasis.\n\n```html\n<!-- Forte enfasi: errore urgente -->\n<mds-toast visible variant=\"error\" tone=\"strong\">\n Connessione persa\n</mds-toast>\n\n<!-- Enfasi ridotta: info secondaria -->\n<mds-toast visible variant=\"info\" tone=\"weak\">\n Sincronizzazione in background\n</mds-toast>\n```\n\n#### Toast with Icon\n\nUse the `icon` slot with an `<mds-icon>` to add a leading glyph. The icon color is tuned per variant.\n\n```html\n<mds-toast visible variant=\"success\">\n <mds-icon slot=\"icon\" name=\"mi/baseline/check-circle\"></mds-icon>\n File caricato con successo\n</mds-toast>\n```\n\n#### Toast with Action\n\nUse the `action` slot with an `<mds-button>` to offer a follow-up. The action region appears only while a `[slot=\"action\"]` child is present, also when it is added after the first render - no empty layout is produced otherwise.\n\n```html\n<mds-toast visible variant=\"error\">\n <mds-icon slot=\"icon\" name=\"mi/baseline/error-outline\"></mds-icon>\n Invio non riuscito\n <mds-button slot=\"action\" size=\"sm\" variant=\"error\" tone=\"weak\">\n Riprova\n </mds-button>\n</mds-toast>\n```\n\n#### Persistent Toast (No Auto-Dismiss)\n\nSet `duration=\"0\"` to keep the toast visible until the user explicitly acts. Use this when the message carries an action the user must not miss. Hide it from your action handler by removing `visible`, and add `deletable` so the person can send the message away without using the action.\n\n```html\n<mds-toast visible variant=\"warning\" duration=\"0\" deletable>\n <mds-icon slot=\"icon\" name=\"mi/baseline/warning\"></mds-icon>\n Sessione in scadenza\n <mds-button slot=\"action\" size=\"sm\" variant=\"warning\" tone=\"weak\">\n Rinnova\n </mds-button>\n</mds-toast>\n```\n\n#### Custom Auto-Dismiss Duration\n\nOverride the 5000 ms default when the message needs more reading time (e.g. it carries an action) or can disappear faster (e.g. a trivial confirmation). Duration is in milliseconds.\n\n```html\n<!-- Messaggio breve: 2 secondi -->\n<mds-toast visible variant=\"success\" duration=\"2000\">\n Copiato negli appunti\n</mds-toast>\n\n<!-- Con azione: 8 secondi -->\n<mds-toast visible variant=\"info\" duration=\"8000\">\n Importazione completata con 3 avvisi\n <mds-button slot=\"action\" size=\"sm\" variant=\"info\" tone=\"weak\">\n Vedi report\n </mds-button>\n</mds-toast>\n```\n\n#### Several Toasts at Once\n\nTwo toasts visible at the same time with the same `position` are drawn at the same place, one over the other. Append the toasts of the application to one `<mds-toast-region>`, placed once in its shell: it lines them up at its edge, announces them, and makes room when too many show at once.\n\n```html\n<mds-toast-region position=\"bottom-center\">\n <mds-toast visible variant=\"success\">Documento salvato</mds-toast>\n <mds-toast visible variant=\"success\">Link copiato negli appunti</mds-toast>\n</mds-toast-region>\n```\n\n#### Positioning\n\nUse `position` to anchor the toast to one of the six viewport edges. Pick the edge that matches the application's layout convention - bottom-center is the default and works for most surfaces.\n\n```html\n<!-- Predefinito: centro in basso -->\n<mds-toast visible variant=\"info\" position=\"bottom-center\">\n Messaggio salvato\n</mds-toast>\n\n<!-- Angolo in alto a destra (toolbar / panel) -->\n<mds-toast visible variant=\"success\" position=\"top-right\">\n Impostazioni aggiornate\n</mds-toast>\n```\n\n#### Listening for the Close Event\n\nListen for `mdsToastClose` to remove the toast from the DOM or update queue state after the outro animation completes. It is emitted once for every hiding, whoever hid the toast, and `event.detail.reason` says who: `timeout`, `close` (the hide button) or `hide` (your code). Do not react to `visible` becoming `false` directly - the animation is still running at that point.\n\n```javascript\ndocument.querySelector('mds-toast').addEventListener('mdsToastClose', (event) => {\n // rimuovi il toast dalla coda o aggiorna lo stato dell'applicazione\n toastQueue.shift();\n if (event.detail.reason === 'close') {\n // la persona ha mandato via il messaggio senza usare l'azione\n }\n});\n```\n\n#### Styling Customization\n\nStyle the toast only through its public `--mds-toast-*` CSS custom properties: the background, the text colour, the width and the shadow. Set them on the host element or a parent selector; use the semantic color roles via `rgb(var(--magma-<role>))` so dark mode and high-contrast modes keep working.\n\n```css\n.app-notifications mds-toast {\n --mds-toast-background: rgb(var(--magma-surface-inverse));\n --mds-toast-color: rgb(var(--magma-on-inverse));\n --mds-toast-width: 480px;\n --mds-toast-shadow: var(--shadow-xl);\n}\n```\n",
35
- "3. Antipattern": "Common incorrect uses of `<mds-toast>`. Each entry pairs the wrong form with the right one and a one-line reason. System-wide rules (boolean-as-string, shadow piercing, Tailwind color utilities, raw native event listening) live in [`agents/anti-patterns.md`](../../../../agents/anti-patterns.md) - they apply here too but are not repeated.\n\n#### Do Not Put HTML in the Default Slot\n\nThe default slot accepts plain text only; nested elements are rendered inside the caption text and break the layout. Use the `icon` slot for an icon and the `action` slot for buttons.\n\n```html\n<!-- INCORRECT -->\n<mds-toast visible variant=\"error\">\n <strong>Errore:</strong> salvataggio fallito\n <mds-button>Riprova</mds-button>\n</mds-toast>\n\n<!-- CORRECT -->\n<mds-toast visible variant=\"error\">\n <mds-icon slot=\"icon\" name=\"mi/baseline/error-outline\"></mds-icon>\n Salvataggio fallito\n <mds-button slot=\"action\" size=\"sm\" variant=\"error\" tone=\"weak\">Riprova</mds-button>\n</mds-toast>\n```\n\n#### Do Not Leave a Persistent Toast Without a Way to Send It Away\n\nA toast with `duration=\"0\"` stays until something hides it. When its action is not what the person wants, nothing makes it go away: it covers the page until your code removes it. Add `deletable`.\n\n```html\n<!-- INCORRECT - only \"Riprova\" makes it go away -->\n<mds-toast visible variant=\"error\" duration=\"0\">\n Invio non riuscito\n <mds-button slot=\"action\" size=\"sm\" variant=\"error\" tone=\"weak\">Riprova</mds-button>\n</mds-toast>\n\n<!-- CORRECT - the arrow sends the message away -->\n<mds-toast visible variant=\"error\" duration=\"0\" deletable>\n Invio non riuscito\n <mds-button slot=\"action\" size=\"sm\" variant=\"error\" tone=\"weak\">Riprova</mds-button>\n</mds-toast>\n```\n\n#### Do Not Set `duration=\"0\"` to Mean \"Use the Default\"\n\nSetting `duration=\"0\"` explicitly disables auto-dismiss and keeps the toast on screen until the user closes it. To use the 5000 ms default, omit the attribute entirely.\n\n```html\n<!-- INCORRECT - disables auto-dismiss unintentionally -->\n<mds-toast visible variant=\"success\" duration=\"0\">\n Documento salvato\n</mds-toast>\n\n<!-- CORRECT - default 5000 ms applies -->\n<mds-toast visible variant=\"success\">\n Documento salvato\n</mds-toast>\n```\n\n#### Do Not Use `visible=\"false\"` to Hide the Toast\n\nSetting a boolean attribute to the string `\"false\"` leaves the attribute on the element. The toast itself reads it as hidden, but every presence check (`[visible]`, `hasAttribute('visible')`, as in the cleanup code below) still reads it as visible. Remove the attribute entirely (or set the prop to `undefined`) to hide the toast.\n\n```html\n<!-- INCORRECT - presence checks still read the toast as visible -->\n<mds-toast visible=\"false\" variant=\"info\">\n Sincronizzazione in corso\n</mds-toast>\n\n<!-- CORRECT - attribute absent means hidden -->\n<mds-toast variant=\"info\">\n Sincronizzazione in corso\n</mds-toast>\n```\n\n#### Do Not React to `visible` Becoming `false` to Clean Up\n\nWhen the timer fires it sets `visible` to `false`, but the outro animation is still running. Listening to that attribute change too early removes the element mid-animation. Wait for `mdsToastClose`, which fires after the animation completes.\n\n```javascript\n// INCORRECT - element may still be animating\nconst toast = document.querySelector('mds-toast');\nconst observer = new MutationObserver(() => {\n if (!toast.hasAttribute('visible')) {\n toast.remove();\n }\n});\nobserver.observe(toast, { attributes: true });\n\n// CORRECT - fires after the outro animation\ntoast.addEventListener('mdsToastClose', () => {\n toast.remove();\n});\n```\n\n#### Do Not Use a Variant Without Checking Its Acceptance\n\n`<mds-toast>` accepts `variant` values from `ThemeVariantType` but ships CSS overrides only for `light`, `dark`, `error`, `warning`, `info`, and `success`. Using `variant=\"primary\"` or `variant=\"ai\"` is valid by type but produces no themed color overrides - the toast falls back to its base inverse colors, the same as `dark`. Stick to the six variants above.\n\n```html\n<!-- INCORRECT - no color override; looks identical to variant=\"dark\" -->\n<mds-toast visible variant=\"primary\">\n Azione confermata\n</mds-toast>\n\n<!-- CORRECT - uses a variant with full CSS support -->\n<mds-toast visible variant=\"success\">\n Azione confermata\n</mds-toast>\n```\n\n#### Do Not Use `tone=\"outline\"` or `tone=\"text\"`\n\n`<mds-toast>` uses `ToneMinimalVariantType`, which accepts only `strong` and `weak`. Passing `tone=\"outline\"` or `tone=\"text\"` silently falls back to the default and produces no visual difference.\n\n```html\n<!-- INCORRECT - value not in ToneMinimalVariantType -->\n<mds-toast visible variant=\"info\" tone=\"outline\">\n Aggiornamento disponibile\n</mds-toast>\n\n<!-- CORRECT -->\n<mds-toast visible variant=\"info\" tone=\"weak\">\n Aggiornamento disponibile\n</mds-toast>\n```\n\n#### Do Not Customize via Undocumented Shadow Parts or Internal Selectors\n\nThe supported surface is the public `--mds-toast-*` CSS custom properties. There are no documented `::part()` targets for `<mds-toast>`; targeting internal class names with `::part()`, `>>>`, or attribute-selector hacks couples your code to the shadow DOM implementation and will break on minor releases.\n\n```css\n/* INCORRECT */\nmds-toast >>> .dialog {\n border-radius: 0;\n}\n\n/* CORRECT - use the public custom properties */\nmds-toast {\n --mds-toast-background: rgb(var(--magma-surface-inverse));\n --mds-toast-color: rgb(var(--magma-on-inverse));\n --mds-toast-width: 360px;\n}\n```\n"
34
+ "1. Description": "The `<mds-toast>` web component is the transient notification surface of the Magma Design System, used to surface brief, non-blocking feedback messages that appear over the viewport and auto-dismiss after a timeout. It has no native HTML equivalent and orchestrates its own visibility, positioning, and auto-close lifecycle.\n\n#### Semantic Behavior\n\n- **Announced**: The host is a status region (`role=\"status\"`): the message is read out when the toast shows it, without moving the focus. While not visible, the message is hidden from assistive technologies too, not only moved out of the viewport. Inside an `<mds-toast-region>` the region is the status region and the toast has no role of its own.\n- **Inside a region**: In an `<mds-toast-region>` the toast is laid out by the region, in a column with the other toasts visible at the same time, instead of being fixed at its edge on its own; the region gives it its `position`. A hidden toast in a region takes no room once its exit is over, and its entrance and exit are a short fade towards the edge.\n- **Auto-dismiss timer**: When `visible` is true and `duration` is a positive number, an internal timer counts down and then sets `visible` back to `false`; setting `duration` to `0` (or falsy) keeps the toast on screen until it is closed intentionally.\n- **The timer waits for the person**: The countdown stops while the pointer is over the toast or the focus is inside it (on its action, on its hide button), and goes on with the time that was left once both have left: the toast does not take its action away while the person is reading it or reaching the action.\n- **Hide button**: With `dismissible`, the toast shows at its end a button with an arrow towards the edge it leaves by (down at the bottom, up at the top), named in the current language and reachable with the keyboard; it hides the toast. It is an arrow and not a cross because the action next to it may itself be a cancel (\"Annulla\"): the arrow only sends the message away.\n- **Close event**: Whenever the toast hides, the component emits `mdsToastClose` once, after the outro animation - consumers should listen for this to remove the toast from the DOM or update queue state. The `reason` of its detail says who hid it: `timeout` (the `duration` ran out), `close` (the person, with the hide button) or `hide` (your code removed `visible`). A toast shown again before the outro is over emits nothing for that hiding.\n- **Reactive timer**: Showing the toast again (`visible` back to true) or changing `duration` at runtime restarts the countdown; hiding it stops the countdown, so a toast hidden by your code closes once, as `hide`, and never again as `timeout`.\n- **Conditional regions**: The text region renders only when the host has inner content, and the action region is shown only while a `[slot=\"action\"]` child is present, following the children added or removed later - empty slots produce no layout.\n- **Default-slot is text**: The default slot is intended for a plain text string only; icons go in the `icon` slot and interactive controls in the `action` slot.\n\n#### Properties & Visual Configurations\n\nThe shared `variant` / `tone` ladders are defined in [`agents/variants.md`](../../../../agents/variants.md); `<mds-toast>` consumes the theme variant set and the minimal tone set (`'strong'` / `'weak'`) without adding component-specific values.\n\n#### Other behavioral props\n\n- **`position`** anchors the toast to one of the six viewport corners/edges (top or bottom, left/center/right), driving both placement and the direction of the entry/exit animation; pick the edge that matches where users expect ephemeral feedback to surface.\n- **`visible`** is the controlled on/off switch for the toast; toggling it drives the show/hide animation and the auto-dismiss timer rather than mounting or unmounting the element.\n- **`duration`** is the visibility window in milliseconds before auto-dismiss; use a longer value for messages that carry an action the user must reach, and `0` for toasts that must stay until explicitly closed.\n- **`dismissible`** shows the hide button; give it to a toast that stays (`duration=\"0\"`) when its action is not what every person wants (\"Riprova\"), so the person can send the message away without using it.\n- **`deletable`** is the old name of `dismissible`, deprecated: the button dismisses the message, it deletes nothing. It still works, and goes in the next major.\n\n#### Slots\n\n- **`icon`** holds a leading glyph (recommended `mds-icon`); **`action`** holds interactive follow-ups (recommended `mds-button`) and, when present, renders inside a dedicated actions container.\n",
35
+ "2. Pattern": "Correct and idiomatic ways to use the `<mds-toast>` component, ordered from most common to most specialized. Patterns assume a working knowledge of the variant / tone ladders documented in [`agents/variants.md`](../../../../agents/variants.md) and the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Basic Text Toast\n\nThe simplest form. Set `visible` to show the toast; the default slot holds the message text only. The component auto-dismisses after the default 5000 ms.\n\n```html\n<mds-toast visible>\n Operazione completata con successo\n</mds-toast>\n```\n\n#### Status Variants\n\nUse `variant` to communicate the meaning of the feedback. The status family (`error`, `warning`, `info`, `success`) maps directly to the nature of the event. Do not pick a variant for its color alone.\n\n```html\n<!-- Conferma positiva -->\n<mds-toast visible variant=\"success\">\n Documento salvato correttamente\n</mds-toast>\n\n<!-- Errore bloccante -->\n<mds-toast visible variant=\"error\">\n Errore durante il salvataggio. Riprova.\n</mds-toast>\n\n<!-- Avviso non bloccante -->\n<mds-toast visible variant=\"warning\">\n La sessione scade tra 5 minuti\n</mds-toast>\n\n<!-- Informazione neutrale -->\n<mds-toast visible variant=\"info\">\n Aggiornamento disponibile\n</mds-toast>\n```\n\n#### Tone for Emphasis\n\nPair `variant` with `tone` to adjust visual weight. `strong` (default) uses the stronger tint of the variant and a larger shadow; `weak` uses a softer tint and a smaller shadow for lower emphasis.\n\n```html\n<!-- Forte enfasi: errore urgente -->\n<mds-toast visible variant=\"error\" tone=\"strong\">\n Connessione persa\n</mds-toast>\n\n<!-- Enfasi ridotta: info secondaria -->\n<mds-toast visible variant=\"info\" tone=\"weak\">\n Sincronizzazione in background\n</mds-toast>\n```\n\n#### Toast with Icon\n\nUse the `icon` slot with an `<mds-icon>` to add a leading glyph. The icon color is tuned per variant.\n\n```html\n<mds-toast visible variant=\"success\">\n <mds-icon slot=\"icon\" name=\"mi/baseline/check-circle\"></mds-icon>\n File caricato con successo\n</mds-toast>\n```\n\n#### Toast with Action\n\nUse the `action` slot with an `<mds-button>` to offer a follow-up. The action region appears only while a `[slot=\"action\"]` child is present, also when it is added after the first render - no empty layout is produced otherwise.\n\n```html\n<mds-toast visible variant=\"error\">\n <mds-icon slot=\"icon\" name=\"mi/baseline/error-outline\"></mds-icon>\n Invio non riuscito\n <mds-button slot=\"action\" size=\"sm\" variant=\"error\" tone=\"weak\">\n Riprova\n </mds-button>\n</mds-toast>\n```\n\n#### Persistent Toast (No Auto-Dismiss)\n\nSet `duration=\"0\"` to keep the toast visible until the user explicitly acts. Use this when the message carries an action the user must not miss. Hide it from your action handler by removing `visible`, and add `dismissible` so the person can send the message away without using the action.\n\n```html\n<mds-toast visible variant=\"warning\" duration=\"0\" dismissible>\n <mds-icon slot=\"icon\" name=\"mi/baseline/warning\"></mds-icon>\n Sessione in scadenza\n <mds-button slot=\"action\" size=\"sm\" variant=\"warning\" tone=\"weak\">\n Rinnova\n </mds-button>\n</mds-toast>\n```\n\n#### Custom Auto-Dismiss Duration\n\nOverride the 5000 ms default when the message needs more reading time (e.g. it carries an action) or can disappear faster (e.g. a trivial confirmation). Duration is in milliseconds.\n\n```html\n<!-- Messaggio breve: 2 secondi -->\n<mds-toast visible variant=\"success\" duration=\"2000\">\n Copiato negli appunti\n</mds-toast>\n\n<!-- Con azione: 8 secondi -->\n<mds-toast visible variant=\"info\" duration=\"8000\">\n Importazione completata con 3 avvisi\n <mds-button slot=\"action\" size=\"sm\" variant=\"info\" tone=\"weak\">\n Vedi report\n </mds-button>\n</mds-toast>\n```\n\n#### Several Toasts at Once\n\nTwo toasts visible at the same time with the same `position` are drawn at the same place, one over the other. Append the toasts of the application to one `<mds-toast-region>`, placed once in its shell: it lines them up at its edge, announces them, and makes room when too many show at once.\n\n```html\n<mds-toast-region position=\"bottom-center\">\n <mds-toast visible variant=\"success\">Documento salvato</mds-toast>\n <mds-toast visible variant=\"success\">Link copiato negli appunti</mds-toast>\n</mds-toast-region>\n```\n\n#### Positioning\n\nUse `position` to anchor the toast to one of the six viewport edges. Pick the edge that matches the application's layout convention - bottom-center is the default and works for most surfaces.\n\n```html\n<!-- Predefinito: centro in basso -->\n<mds-toast visible variant=\"info\" position=\"bottom-center\">\n Messaggio salvato\n</mds-toast>\n\n<!-- Angolo in alto a destra (toolbar / panel) -->\n<mds-toast visible variant=\"success\" position=\"top-right\">\n Impostazioni aggiornate\n</mds-toast>\n```\n\n#### Listening for the Close Event\n\nListen for `mdsToastClose` to remove the toast from the DOM or update queue state after the outro animation completes. It is emitted once for every hiding, whoever hid the toast, and `event.detail.reason` says who: `timeout`, `close` (the hide button) or `hide` (your code). Do not react to `visible` becoming `false` directly - the animation is still running at that point.\n\n```javascript\ndocument.querySelector('mds-toast').addEventListener('mdsToastClose', (event) => {\n // rimuovi il toast dalla coda o aggiorna lo stato dell'applicazione\n toastQueue.shift();\n if (event.detail.reason === 'close') {\n // la persona ha mandato via il messaggio senza usare l'azione\n }\n});\n```\n\n#### Styling Customization\n\nStyle the toast only through its public `--mds-toast-*` CSS custom properties: the background, the text colour, the width and the shadow. Set them on the host element or a parent selector; use the semantic color roles via `rgb(var(--magma-<role>))` so dark mode and high-contrast modes keep working.\n\n```css\n.app-notifications mds-toast {\n --mds-toast-background: rgb(var(--magma-surface-inverse));\n --mds-toast-color: rgb(var(--magma-on-inverse));\n --mds-toast-width: 480px;\n --mds-toast-shadow: var(--shadow-xl);\n}\n```\n",
36
+ "3. Antipattern": "Common incorrect uses of `<mds-toast>`. Each entry pairs the wrong form with the right one and a one-line reason. System-wide rules (boolean-as-string, shadow piercing, Tailwind color utilities, raw native event listening) live in [`agents/anti-patterns.md`](../../../../agents/anti-patterns.md) - they apply here too but are not repeated.\n\n#### Do Not Put HTML in the Default Slot\n\nThe default slot accepts plain text only; nested elements are rendered inside the caption text and break the layout. Use the `icon` slot for an icon and the `action` slot for buttons.\n\n```html\n<!-- INCORRECT -->\n<mds-toast visible variant=\"error\">\n <strong>Errore:</strong> salvataggio fallito\n <mds-button>Riprova</mds-button>\n</mds-toast>\n\n<!-- CORRECT -->\n<mds-toast visible variant=\"error\">\n <mds-icon slot=\"icon\" name=\"mi/baseline/error-outline\"></mds-icon>\n Salvataggio fallito\n <mds-button slot=\"action\" size=\"sm\" variant=\"error\" tone=\"weak\">Riprova</mds-button>\n</mds-toast>\n```\n\n#### Do Not Leave a Persistent Toast Without a Way to Send It Away\n\nA toast with `duration=\"0\"` stays until something hides it. When its action is not what the person wants, nothing makes it go away: it covers the page until your code removes it. Add `dismissible`.\n\n```html\n<!-- INCORRECT - only \"Riprova\" makes it go away -->\n<mds-toast visible variant=\"error\" duration=\"0\">\n Invio non riuscito\n <mds-button slot=\"action\" size=\"sm\" variant=\"error\" tone=\"weak\">Riprova</mds-button>\n</mds-toast>\n\n<!-- CORRECT - the arrow sends the message away -->\n<mds-toast visible variant=\"error\" duration=\"0\" dismissible>\n Invio non riuscito\n <mds-button slot=\"action\" size=\"sm\" variant=\"error\" tone=\"weak\">Riprova</mds-button>\n</mds-toast>\n```\n\n#### Do Not Set `duration=\"0\"` to Mean \"Use the Default\"\n\nSetting `duration=\"0\"` explicitly disables auto-dismiss and keeps the toast on screen until the user closes it. To use the 5000 ms default, omit the attribute entirely.\n\n```html\n<!-- INCORRECT - disables auto-dismiss unintentionally -->\n<mds-toast visible variant=\"success\" duration=\"0\">\n Documento salvato\n</mds-toast>\n\n<!-- CORRECT - default 5000 ms applies -->\n<mds-toast visible variant=\"success\">\n Documento salvato\n</mds-toast>\n```\n\n#### Do Not Use `visible=\"false\"` to Hide the Toast\n\nSetting a boolean attribute to the string `\"false\"` leaves the attribute on the element. The toast itself reads it as hidden, but every presence check (`[visible]`, `hasAttribute('visible')`, as in the cleanup code below) still reads it as visible. Remove the attribute entirely (or set the prop to `undefined`) to hide the toast.\n\n```html\n<!-- INCORRECT - presence checks still read the toast as visible -->\n<mds-toast visible=\"false\" variant=\"info\">\n Sincronizzazione in corso\n</mds-toast>\n\n<!-- CORRECT - attribute absent means hidden -->\n<mds-toast variant=\"info\">\n Sincronizzazione in corso\n</mds-toast>\n```\n\n#### Do Not React to `visible` Becoming `false` to Clean Up\n\nWhen the timer fires it sets `visible` to `false`, but the outro animation is still running. Listening to that attribute change too early removes the element mid-animation. Wait for `mdsToastClose`, which fires after the animation completes.\n\n```javascript\n// INCORRECT - element may still be animating\nconst toast = document.querySelector('mds-toast');\nconst observer = new MutationObserver(() => {\n if (!toast.hasAttribute('visible')) {\n toast.remove();\n }\n});\nobserver.observe(toast, { attributes: true });\n\n// CORRECT - fires after the outro animation\ntoast.addEventListener('mdsToastClose', () => {\n toast.remove();\n});\n```\n\n#### Do Not Use a Variant Without Checking Its Acceptance\n\n`<mds-toast>` accepts `variant` values from `ThemeVariantType` but ships CSS overrides only for `light`, `dark`, `error`, `warning`, `info`, and `success`. Using `variant=\"primary\"` or `variant=\"ai\"` is valid by type but produces no themed color overrides - the toast falls back to its base inverse colors, the same as `dark`. Stick to the six variants above.\n\n```html\n<!-- INCORRECT - no color override; looks identical to variant=\"dark\" -->\n<mds-toast visible variant=\"primary\">\n Azione confermata\n</mds-toast>\n\n<!-- CORRECT - uses a variant with full CSS support -->\n<mds-toast visible variant=\"success\">\n Azione confermata\n</mds-toast>\n```\n\n#### Do Not Use `tone=\"outline\"` or `tone=\"text\"`\n\n`<mds-toast>` uses `ToneMinimalVariantType`, which accepts only `strong` and `weak`. Passing `tone=\"outline\"` or `tone=\"text\"` silently falls back to the default and produces no visual difference.\n\n```html\n<!-- INCORRECT - value not in ToneMinimalVariantType -->\n<mds-toast visible variant=\"info\" tone=\"outline\">\n Aggiornamento disponibile\n</mds-toast>\n\n<!-- CORRECT -->\n<mds-toast visible variant=\"info\" tone=\"weak\">\n Aggiornamento disponibile\n</mds-toast>\n```\n\n#### Do Not Customize via Undocumented Shadow Parts or Internal Selectors\n\nThe supported surface is the public `--mds-toast-*` CSS custom properties. There are no documented `::part()` targets for `<mds-toast>`; targeting internal class names with `::part()`, `>>>`, or attribute-selector hacks couples your code to the shadow DOM implementation and will break on minor releases.\n\n```css\n/* INCORRECT */\nmds-toast >>> .dialog {\n border-radius: 0;\n}\n\n/* CORRECT - use the public custom properties */\nmds-toast {\n --mds-toast-background: rgb(var(--magma-surface-inverse));\n --mds-toast-color: rgb(var(--magma-on-inverse));\n --mds-toast-width: 360px;\n}\n```\n"
36
37
  },
37
38
  "props": [
38
39
  {
@@ -46,6 +47,38 @@
46
47
  "mutable": false,
47
48
  "attr": "deletable",
48
49
  "reflectToAttr": false,
50
+ "docs": "Shows the hide button, as `dismissible` does.",
51
+ "docsTags": [
52
+ {
53
+ "name": "deprecated",
54
+ "text": "Use `dismissible`: the button dismisses the message, it deletes nothing.\nGoes in the next major."
55
+ }
56
+ ],
57
+ "deprecation": "Use `dismissible`: the button dismisses the message, it deletes nothing.\nGoes in the next major.",
58
+ "values": [
59
+ {
60
+ "type": "boolean"
61
+ },
62
+ {
63
+ "type": "undefined"
64
+ }
65
+ ],
66
+ "optional": true,
67
+ "required": false,
68
+ "getter": false,
69
+ "setter": false
70
+ },
71
+ {
72
+ "name": "dismissible",
73
+ "type": "boolean | undefined",
74
+ "complexType": {
75
+ "original": "boolean",
76
+ "resolved": "boolean | undefined",
77
+ "references": {}
78
+ },
79
+ "mutable": false,
80
+ "attr": "dismissible",
81
+ "reflectToAttr": false,
49
82
  "docs": "Shows a button that hides the toast, an arrow towards the edge the toast leaves by",
50
83
  "docsTags": [],
51
84
  "values": [
@@ -72,7 +105,7 @@
72
105
  "mutable": true,
73
106
  "attr": "duration",
74
107
  "reflectToAttr": true,
75
- "docs": "If set, specifies the visibility duration in milliseconds of the element inside the viewport, when the time is up the visible property will be set to false. The countdown waits while the pointer is over the toast or the focus is inside it. If the duration is set to 0 the toast stays until it is hidden: give it `deletable` so the person can hide it too.",
108
+ "docs": "If set, specifies the visibility duration in milliseconds of the element inside the viewport, when the time is up the visible property will be set to false. The countdown waits while the pointer is over the toast or the focus is inside it. If the duration is set to 0 the toast stays until it is hidden: give it `dismissible` so the person can hide it too.",
76
109
  "docsTags": [
77
110
  {
78
111
  "name": "default",
@@ -383,7 +416,8 @@
383
416
  "mds-icon",
384
417
  "mds-text"
385
418
  ]
386
- }
419
+ },
420
+ "storybook": "ui-toast--docs"
387
421
  }
388
422
  ]
389
423
  }
@@ -34,7 +34,7 @@ export class MdsToast {
34
34
  // inside an mds-toast-region, which places the toast and announces it
35
35
  this.stacked = false;
36
36
  /**
37
- * If set, specifies the visibility duration in milliseconds of the element inside the viewport, when the time is up the visible property will be set to false. The countdown waits while the pointer is over the toast or the focus is inside it. If the duration is set to 0 the toast stays until it is hidden: give it `deletable` so the person can hide it too.
37
+ * If set, specifies the visibility duration in milliseconds of the element inside the viewport, when the time is up the visible property will be set to false. The countdown waits while the pointer is over the toast or the focus is inside it. If the duration is set to 0 the toast stays until it is hidden: give it `dismissible` so the person can hide it too.
38
38
  */
39
39
  this.duration = 5000;
40
40
  /**
@@ -203,7 +203,7 @@ export class MdsToast {
203
203
  // focus. The host is the region and stays in the page, so the content that appears inside
204
204
  // it is what a screen reader reads out. Inside an mds-toast-region the region is the live
205
205
  // region, already in the page before any toast: a toast of its own would nest a second one
206
- return (h(Host, { key: '78794225496c25083d6c1118325436bd6f78f920', role: this.stacked ? undefined : 'status', stacked: this.stacked, "pref-animation": preferenceStore.state.animation, "pref-contrast": preferenceStore.state.contrast, "pref-mode": preferenceStore.state.mode, "pref-theme-scheme": preferenceStore.state['theme-scheme'] }, h("div", { key: 'e145d6042004ece44479227bda7b71af55231e69', class: clsx('dialog', this.position && `to-${this.position}`, this.visible && 'dialog--visible'), onFocusin: this.onFocusIn, onFocusout: this.onFocusOut, onPointerEnter: this.onPointerEnter, onPointerLeave: this.onPointerLeave }, h("slot", { key: 'ea4143e5d1fa9098ac2b3924a65ab18e78344a21', name: "icon" }), this.hasText && (h("mds-text", { key: 'e5ccbb014439671bedc2cd9af71b82934dbb6d04', typography: "caption" }, h("slot", { key: '1d0a7c60aafce454fd5e9154a730e3232ac50c41' }))), h("div", { key: '6d25fc9ce5d851c23737b92748735f29659ab585', class: clsx('actions', !this.hasActions && 'actions--hidden') }, h("slot", { key: 'd8c3eadbd31c8512e5e4b1e8ceb442321bd2cb3d', name: "action", onSlotchange: this.onActionSlotChange })), this.deletable && (h("mds-button", { key: 'f879cd5d161aa01092d03a265a5d0ad8484c7f8d', "aria-label": this.t.get('hide'), class: "hide", icon: ((_a = this.position) === null || _a === void 0 ? void 0 : _a.startsWith('top')) ? miBaselineArrowUpward : miBaselineArrowDownward, onClick: this.onCloseClick, size: "sm", tone: "text", type: "button", variant: this.closeButtonVariant() })))));
206
+ return (h(Host, { key: '5311d740bc8ea85044462a30d426b03c1ec62cf7', role: this.stacked ? undefined : 'status', stacked: this.stacked, "pref-animation": preferenceStore.state.animation, "pref-contrast": preferenceStore.state.contrast, "pref-mode": preferenceStore.state.mode, "pref-theme-scheme": preferenceStore.state['theme-scheme'] }, h("div", { key: 'fd1c6e5c0536804c36c9823c12d40927531aada3', class: clsx('dialog', this.position && `to-${this.position}`, this.visible && 'dialog--visible'), onFocusin: this.onFocusIn, onFocusout: this.onFocusOut, onPointerEnter: this.onPointerEnter, onPointerLeave: this.onPointerLeave }, h("slot", { key: 'f55e05ae884d631e4711204aacd3d1ffed71089a', name: "icon" }), this.hasText && (h("mds-text", { key: 'efbb5965154a3a95bed0405f2fa0a4251154c1e2', typography: "caption" }, h("slot", { key: 'c5ca29ca96e8292a530f0837b59eaac856b60a76' }))), h("div", { key: '225e12ba896919744898d62988ba9c32bfabf032', class: clsx('actions', !this.hasActions && 'actions--hidden') }, h("slot", { key: 'bbe444eabf9c5abb9422e23b6f6ba9699d2ad241', name: "action", onSlotchange: this.onActionSlotChange })), (this.dismissible || this.deletable) && (h("mds-button", { key: '17b77af297b6ac009564422003bc78b34557bf2a', "aria-label": this.t.get('hide'), class: "hide", icon: ((_a = this.position) === null || _a === void 0 ? void 0 : _a.startsWith('top')) ? miBaselineArrowUpward : miBaselineArrowDownward, onClick: this.onCloseClick, size: "sm", tone: "text", type: "button", variant: this.closeButtonVariant() })))));
207
207
  }
208
208
  static get is() { return "mds-toast"; }
209
209
  static get encapsulation() { return "shadow"; }
@@ -231,7 +231,7 @@ export class MdsToast {
231
231
  "optional": true,
232
232
  "docs": {
233
233
  "tags": [],
234
- "text": "If set, specifies the visibility duration in milliseconds of the element inside the viewport, when the time is up the visible property will be set to false. The countdown waits while the pointer is over the toast or the focus is inside it. If the duration is set to 0 the toast stays until it is hidden: give it `deletable` so the person can hide it too."
234
+ "text": "If set, specifies the visibility duration in milliseconds of the element inside the viewport, when the time is up the visible property will be set to false. The countdown waits while the pointer is over the toast or the focus is inside it. If the duration is set to 0 the toast stays until it is hidden: give it `dismissible` so the person can hide it too."
235
235
  },
236
236
  "getter": false,
237
237
  "setter": false,
@@ -339,7 +339,7 @@ export class MdsToast {
339
339
  "attribute": "position",
340
340
  "defaultValue": "'bottom-center'"
341
341
  },
342
- "deletable": {
342
+ "dismissible": {
343
343
  "type": "boolean",
344
344
  "mutable": false,
345
345
  "complexType": {
@@ -356,6 +356,28 @@ export class MdsToast {
356
356
  "getter": false,
357
357
  "setter": false,
358
358
  "reflect": false,
359
+ "attribute": "dismissible"
360
+ },
361
+ "deletable": {
362
+ "type": "boolean",
363
+ "mutable": false,
364
+ "complexType": {
365
+ "original": "boolean",
366
+ "resolved": "boolean | undefined",
367
+ "references": {}
368
+ },
369
+ "required": false,
370
+ "optional": true,
371
+ "docs": {
372
+ "tags": [{
373
+ "name": "deprecated",
374
+ "text": "Use `dismissible`: the button dismisses the message, it deletes nothing.\nGoes in the next major."
375
+ }],
376
+ "text": "Shows the hide button, as `dismissible` does."
377
+ },
378
+ "getter": false,
379
+ "setter": false,
380
+ "reflect": false,
359
381
  "attribute": "deletable"
360
382
  }
361
383
  };
@@ -88,10 +88,10 @@ Use the `action` slot with an `<mds-button>` to offer a follow-up. The action re
88
88
 
89
89
  #### Persistent Toast (No Auto-Dismiss)
90
90
 
91
- Set `duration="0"` to keep the toast visible until the user explicitly acts. Use this when the message carries an action the user must not miss. Hide it from your action handler by removing `visible`, and add `deletable` so the person can send the message away without using the action.
91
+ Set `duration="0"` to keep the toast visible until the user explicitly acts. Use this when the message carries an action the user must not miss. Hide it from your action handler by removing `visible`, and add `dismissible` so the person can send the message away without using the action.
92
92
 
93
93
  ```html
94
- <mds-toast visible variant="warning" duration="0" deletable>
94
+ <mds-toast visible variant="warning" duration="0" dismissible>
95
95
  <mds-icon slot="icon" name="mi/baseline/warning"></mds-icon>
96
96
  Sessione in scadenza
97
97
  <mds-button slot="action" size="sm" variant="warning" tone="weak">
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-toast-region
8
8
 
9
- > `@maggioli-design-system/magma` 2.7.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
9
+ > `@maggioli-design-system/magma` 2.9.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
10
10
 
11
11
  The `<mds-toast-region>` web component is the place where an application shows its toasts: placed once in the application shell, at an edge of the viewport, it lines up the `<mds-toast>` elements visible at the same time, each one readable, and announces them to assistive technologies. It has no native HTML equivalent.
12
12
 
@@ -29,6 +29,7 @@ The `<mds-toast-region>` web component is the place where an application shows i
29
29
 
30
30
  - [`pattern.md`](pattern.md) - correct usage, with examples
31
31
  - [`antipattern.md`](antipattern.md) - mistakes to avoid
32
+ - [Storybook](https://magma-design-system.github.io/magma/storybook/?path=/docs/ui-toast-toast-region--docs) - the live examples, in the published Storybook of `main`
32
33
  - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`anti-patterns.md`](../../../../agents/anti-patterns.md) - the rules shared by every component
33
34
 
34
35
  ## Props
@@ -1,10 +1,11 @@
1
1
  {
2
- "timestamp": "2026-10-24T18:39:37",
2
+ "timestamp": "2026-10-27T10:28:31",
3
3
  "compiler": {
4
4
  "name": "@stencil/core",
5
5
  "version": "4.45.2",
6
6
  "typescriptVersion": "5.8.3"
7
7
  },
8
+ "storybook": "https://magma-design-system.github.io/magma/storybook/",
8
9
  "components": [
9
10
  {
10
11
  "filePath": "src/components/mds-toast-region/mds-toast-region.tsx",
@@ -23,7 +24,7 @@
23
24
  ],
24
25
  "usage": {
25
26
  "1. Description": "The `<mds-toast-region>` web component is the place where an application shows its toasts: placed once in the application shell, at an edge of the viewport, it lines up the `<mds-toast>` elements visible at the same time, each one readable, and announces them to assistive technologies. It has no native HTML equivalent.\n\n#### Semantic Behavior\n\n- **One place for the toasts**: The region is fixed at the edge named by `position`; the toasts inside it are laid out in its flow, in a column with a gap, instead of each one being fixed on its own. The newest toast (the last one in the page) sits at the edge, where the toasts come in.\n- **The others close the gap**: A hidden toast in the region takes no room once its exit is over, so the toasts left move up to the edge; the exit itself is a short fade towards the edge, not a slide over the other toasts.\n- **Position of the toasts**: The region gives its `position` to every toast inside it, the ones added later too, and again when its own `position` changes.\n- **Live region**: The host is a status region (`role=\"status\"`, `aria-live=\"polite\"`, not atomic) that is in the page before any message, so a toast added or shown inside it is read out without moving the focus, and only that toast. The toasts inside it drop their own status role.\n- **The most toasts at once**: When a toast shows while `max` toasts are already visible, the region hides the oldest ones with a `duration`, in the order they were shown, and each one emits `mdsToastClose` with `reason: 'hide'`. A toast that stays (`duration=\"0\"`) and the toast just shown are never hidden, so the region may hold more than `max` until one of them goes.\n- **Below the dialogs**: The region is a fixed layer of the page, not a top layer element: an `<mds-modal>` opened later covers it and makes it inert, toasts and announcements included. A message about an open dialog belongs inside the dialog.\n- **Toasts outside the region**: A toast that is not inside a region keeps placing itself at its own `position`, as before.\n\n#### Properties & Visual Configurations\n\n- **`position`** picks the edge and the alignment of the column: top or bottom, left, center or right. Pick the edge where the application expects transient feedback; one region per application is the rule.\n- **`max`** is how many toasts may be visible at once before the oldest one with a timer leaves to make room; keep it small, a column of toasts covers the page.\n",
26
- "2. Pattern": "Correct and idiomatic ways to use the `<mds-toast-region>` component, ordered from most common to most specialized. The toasts follow the patterns of `<mds-toast>`; the shared component rules live in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### One Region in the Application Shell\n\nPlace one region in the shell of the application, outside the content that changes from page to page, so it is in the page before any message. Every toast of the application goes into it.\n\n```html\n<body>\n <main>\n <!-- contenuto dell'applicazione -->\n </main>\n <mds-toast-region></mds-toast-region>\n</body>\n```\n\n#### Showing a Toast From Code\n\nCreate the toast, append it to the region and show it; remove it from the page once it has closed. The region places it, announces it, and makes room for it.\n\n```javascript\nconst region = document.querySelector('mds-toast-region');\n\nconst showToast = (text, variant = 'success') => {\n const toast = document.createElement('mds-toast');\n toast.variant = variant;\n toast.textContent = text;\n toast.addEventListener('mdsToastClose', () => toast.remove());\n region.append(toast);\n toast.visible = true;\n};\n\nshowToast('Documento salvato');\n```\n\n#### A Message That Stays Among Confirmations\n\nAn error that the person must act on stays (`duration=\"0\"`) with its action and the hide button, while the confirmations around it come and go: the region never hides a toast that stays to make room.\n\n```html\n<mds-toast-region>\n <mds-toast visible variant=\"error\" duration=\"0\" deletable>\n Invio non riuscito\n <mds-button slot=\"action\" size=\"sm\" variant=\"error\" tone=\"weak\">Riprova</mds-button>\n </mds-toast>\n <mds-toast visible variant=\"success\">Bozza salvata</mds-toast>\n</mds-toast-region>\n```\n\n#### At the Top Edge\n\nSet `position` on the region, not on the toasts: it lines the toasts up at that edge, the newest one at the top, and gives them the position, so they come in and leave from that edge.\n\n```html\n<mds-toast-region position=\"top-right\"></mds-toast-region>\n```\n\n#### Fewer Toasts at Once\n\nLower `max` for an application with frequent confirmations or little room: when one more toast shows, the oldest one with a timer leaves first.\n\n```html\n<mds-toast-region max=\"2\"></mds-toast-region>\n```\n\n#### Spacing Between the Toasts\n\nChange the space between the toasts with `--mds-toast-region-gap`.\n\n```css\nmds-toast-region {\n --mds-toast-region-gap: 12px;\n}\n```\n",
27
+ "2. Pattern": "Correct and idiomatic ways to use the `<mds-toast-region>` component, ordered from most common to most specialized. The toasts follow the patterns of `<mds-toast>`; the shared component rules live in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### One Region in the Application Shell\n\nThe region holds the `<mds-toast>` elements of the application: every toast of the application goes into it, and the region lines them up at its edge and announces them. A toast shown in it leaves after its `duration`.\n\n```html\n<mds-toast-region>\n <mds-toast visible variant=\"success\">Documento salvato</mds-toast>\n</mds-toast-region>\n```\n\nPlace one region in the shell of the application, outside the content that changes from page to page, so it is in the page before any message; the toasts are added to it from code (see the next pattern).\n\n```html\n<body>\n <main>\n <!-- contenuto dell'applicazione -->\n </main>\n <mds-toast-region></mds-toast-region>\n</body>\n```\n\n#### Showing a Toast From Code\n\nCreate the toast, append it to the region and show it; remove it from the page once it has closed. The region places it, announces it, and makes room for it.\n\n```javascript\nconst region = document.querySelector('mds-toast-region');\n\nconst showToast = (text, variant = 'success') => {\n const toast = document.createElement('mds-toast');\n toast.variant = variant;\n toast.textContent = text;\n toast.addEventListener('mdsToastClose', () => toast.remove());\n region.append(toast);\n toast.visible = true;\n};\n\nshowToast('Documento salvato');\n```\n\n#### A Message That Stays Among Confirmations\n\nAn error that the person must act on stays (`duration=\"0\"`) with its action and the hide button, while the confirmations around it come and go: the region never hides a toast that stays to make room.\n\n```html\n<mds-toast-region>\n <mds-toast visible variant=\"error\" duration=\"0\" dismissible>\n Invio non riuscito\n <mds-button slot=\"action\" size=\"sm\" variant=\"error\" tone=\"weak\">Riprova</mds-button>\n </mds-toast>\n <mds-toast visible variant=\"success\">Bozza salvata</mds-toast>\n</mds-toast-region>\n```\n\n#### At the Top Edge\n\nSet `position` on the region, not on the toasts: it lines the toasts up at that edge, the newest one at the top, and gives them the position, so they come in and leave from that edge.\n\n```html\n<mds-toast-region position=\"top-right\"></mds-toast-region>\n```\n\n#### Fewer Toasts at Once\n\nLower `max` for an application with frequent confirmations or little room: when one more toast shows, the oldest one with a timer leaves first.\n\n```html\n<mds-toast-region max=\"2\"></mds-toast-region>\n```\n\n#### Spacing Between the Toasts\n\nChange the space between the toasts with `--mds-toast-region-gap`.\n\n```css\nmds-toast-region {\n --mds-toast-region-gap: 12px;\n}\n```\n",
27
28
  "3. Antipattern": "Common incorrect uses of `<mds-toast-region>`. Each entry pairs the wrong form with the right one and a one-line reason. System-wide rules live in [`agents/anti-patterns.md`](../../../../agents/anti-patterns.md) - they apply here too but are not repeated.\n\n#### Do Not Place a Region in Every Page or Component\n\nTwo regions at the same edge draw their toasts at the same place, one over the other, which is the problem the region solves. A region created together with its message is also not in the page before it, so the message may not be announced.\n\n```html\n<!-- INCORRECT - one region per form, created with the message -->\n<form>\n <mds-toast-region>\n <mds-toast visible>Modulo inviato</mds-toast>\n </mds-toast-region>\n</form>\n\n<!-- CORRECT - one region in the shell, the toasts appended to it -->\n<mds-toast-region></mds-toast-region>\n```\n\n#### Do Not Set `position` on the Toasts Inside a Region\n\nThe region gives its `position` to every toast inside it, so the one set on a toast is replaced. Set it on the region.\n\n```html\n<!-- INCORRECT - replaced by the region -->\n<mds-toast-region>\n <mds-toast visible position=\"top-right\">Impostazioni aggiornate</mds-toast>\n</mds-toast-region>\n\n<!-- CORRECT -->\n<mds-toast-region position=\"top-right\">\n <mds-toast visible>Impostazioni aggiornate</mds-toast>\n</mds-toast-region>\n```\n\n#### Do Not Send a Message About an Open Dialog to the Region\n\nWhile an `mds-modal` is open, everything outside it is inert, the region included: its toast cannot be used and is not announced. Show the message inside the dialog.\n\n```html\n<!-- INCORRECT - the error of the dialog goes behind it -->\n<mds-modal opened>\n <form>...</form>\n</mds-modal>\n<mds-toast-region>\n <mds-toast visible variant=\"error\" duration=\"0\">Salvataggio non riuscito</mds-toast>\n</mds-toast-region>\n\n<!-- CORRECT - the error is in the dialog -->\n<mds-modal opened>\n <mds-banner variant=\"error\">Salvataggio non riuscito</mds-banner>\n <form></form>\n</mds-modal>\n```\n"
28
29
  },
29
30
  "props": [
@@ -135,7 +136,8 @@
135
136
  "states": [],
136
137
  "dependents": [],
137
138
  "dependencies": [],
138
- "dependencyGraph": {}
139
+ "dependencyGraph": {},
140
+ "storybook": "ui-toast-toast-region--docs"
139
141
  }
140
142
  ]
141
143
  }
@@ -11,7 +11,15 @@ Correct and idiomatic ways to use the `<mds-toast-region>` component, ordered fr
11
11
 
12
12
  #### One Region in the Application Shell
13
13
 
14
- Place one region in the shell of the application, outside the content that changes from page to page, so it is in the page before any message. Every toast of the application goes into it.
14
+ The region holds the `<mds-toast>` elements of the application: every toast of the application goes into it, and the region lines them up at its edge and announces them. A toast shown in it leaves after its `duration`.
15
+
16
+ ```html
17
+ <mds-toast-region>
18
+ <mds-toast visible variant="success">Documento salvato</mds-toast>
19
+ </mds-toast-region>
20
+ ```
21
+
22
+ Place one region in the shell of the application, outside the content that changes from page to page, so it is in the page before any message; the toasts are added to it from code (see the next pattern).
15
23
 
16
24
  ```html
17
25
  <body>
@@ -47,7 +55,7 @@ An error that the person must act on stays (`duration="0"`) with its action and
47
55
 
48
56
  ```html
49
57
  <mds-toast-region>
50
- <mds-toast visible variant="error" duration="0" deletable>
58
+ <mds-toast visible variant="error" duration="0" dismissible>
51
59
  Invio non riuscito
52
60
  <mds-button slot="action" size="sm" variant="error" tone="weak">Riprova</mds-button>
53
61
  </mds-toast>
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-tooltip
8
8
 
9
- > `@maggioli-design-system/magma` 2.7.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
9
+ > `@maggioli-design-system/magma` 2.9.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
10
10
 
11
11
  The `<mds-tooltip>` web component is the floating contextual hint of the Magma Design System. It renders a small text bubble that attaches to a separate trigger element identified by a CSS selector, rather than relying on the native `title` attribute.
12
12
 
@@ -31,6 +31,7 @@ The `<mds-tooltip>` web component is the floating contextual hint of the Magma D
31
31
 
32
32
  - [`pattern.md`](pattern.md) - correct usage, with examples
33
33
  - [`antipattern.md`](antipattern.md) - mistakes to avoid
34
+ - [Storybook](https://magma-design-system.github.io/magma/storybook/?path=/docs/ui-tooltip--docs) - the live examples, in the published Storybook of `main`
34
35
  - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`anti-patterns.md`](../../../../agents/anti-patterns.md) - the rules shared by every component
35
36
 
36
37
  ## Props
@@ -1,10 +1,11 @@
1
1
  {
2
- "timestamp": "2026-10-24T18:39:37",
2
+ "timestamp": "2026-10-27T10:28:31",
3
3
  "compiler": {
4
4
  "name": "@stencil/core",
5
5
  "version": "4.45.2",
6
6
  "typescriptVersion": "5.8.3"
7
7
  },
8
+ "storybook": "https://magma-design-system.github.io/magma/storybook/",
8
9
  "components": [
9
10
  {
10
11
  "filePath": "src/components/mds-tooltip/mds-tooltip.tsx",
@@ -541,7 +542,8 @@
541
542
  "mds-radial-menu-item": [
542
543
  "mds-tooltip"
543
544
  ]
544
- }
545
+ },
546
+ "storybook": "ui-tooltip--docs"
545
547
  }
546
548
  ]
547
549
  }
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-tree
8
8
 
9
- > `@maggioli-design-system/magma` 2.7.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
9
+ > `@maggioli-design-system/magma` 2.9.0. Shadow DOM: style it only through the public CSS custom properties and the parts below.
10
10
 
11
11
  The `<mds-tree>` web component is the root container of the Magma Design System tree view, organizing a hierarchy of slotted `<mds-tree-item>` nodes into an expandable/collapsible structure. It owns no visual row of its own: it is a compound parent that configures, stacks, and propagates state to its children.
12
12
 
@@ -34,6 +34,7 @@ The `<mds-tree>` web component is the root container of the Magma Design System
34
34
 
35
35
  - [`pattern.md`](pattern.md) - correct usage, with examples
36
36
  - [`antipattern.md`](antipattern.md) - mistakes to avoid
37
+ - [Storybook](https://magma-design-system.github.io/magma/storybook/?path=/docs/ui-tree--docs) - the live examples, in the published Storybook of `main`
37
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
39
 
39
40
  ## Props
@@ -42,7 +43,7 @@ The `<mds-tree>` web component is the root container of the Magma Design System
42
43
  | --- | --- | --- | --- | --- |
43
44
  | `actions` | `actions` | `"auto" \| "visible" \| undefined` | `'auto'` | Show actions on the every tree item on hover or by default. |
44
45
  | `appearance` | `appearance` | `"depth" \| "none"` | `'depth'` | Specifies if the branches depth decorations are visible. |
45
- | `async` | `async` | `boolean \| undefined` | - | **Deprecated**: Set `async` on the items that load their children on demand. Goes in the next major.. Has no effect on the tree: `async` is read on each `mds-tree-item`. |
46
+ | `async` | `async` | `boolean \| undefined` | - | **Deprecated**: Set `async` on the items that load their children on demand. Goes in the next major. Has no effect on the tree: `async` is read on each `mds-tree-item`. |
46
47
  | `expanded` | `expanded` | `boolean \| undefined` | - | Specifies if the tree is expanded. |
47
48
  | `label` | `label` | `string` | - | Names the tree for assistive technologies: the tree is a list of its items, and the label is what that list is called |
48
49
  | `toggle` | `toggle` | `"chevron" \| "folder"` | `'chevron'` | Specifies the toggle icon of the element |