@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
@@ -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-pref-mode/mds-pref-mode.tsx",
@@ -259,7 +260,8 @@
259
260
  "mds-icon",
260
261
  "mds-text"
261
262
  ]
262
- }
263
+ },
264
+ "storybook": "ui-preferences-mode--docs"
263
265
  }
264
266
  ]
265
267
  }
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-pref-theme
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-pref-theme>` web component is the theme-switcher segment of the Magma accessibility preferences panel, usually a direct child of [`<mds-pref>`](../mds-pref/AGENTS.md). It renders a labelled tab trigger that opens a dropdown of selectable named themes and, when a theme is chosen, applies it globally to the document.
12
12
 
@@ -33,6 +33,7 @@ The `<mds-pref-theme>` web component is the theme-switcher segment of the Magma
33
33
 
34
34
  - [`pattern.md`](pattern.md) - correct usage, with examples
35
35
  - [`antipattern.md`](antipattern.md) - mistakes to avoid
36
+ - [Storybook](https://magma-design-system.github.io/magma/storybook/?path=/docs/ui-preferences-theme--docs) - the live examples, in the published Storybook of `main`
36
37
  - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`anti-patterns.md`](../../../../agents/anti-patterns.md) - the rules shared by every component
37
38
 
38
39
  ## 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-pref-theme/mds-pref-theme.tsx",
@@ -285,7 +286,8 @@
285
286
  "mds-icon",
286
287
  "mds-text"
287
288
  ]
288
- }
289
+ },
290
+ "storybook": "ui-preferences-theme--docs"
289
291
  }
290
292
  ]
291
293
  }
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-pref-theme-item
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-pref-theme-item>` web component is a single selectable theme entry inside the [`<mds-pref-theme>`](../mds-pref-theme/AGENTS.md) preference picker. It renders as a borderless button that pairs a color-swatch preview of the theme with its label.
12
12
 
@@ -28,6 +28,7 @@ The `<mds-pref-theme-item>` web component is a single selectable theme entry ins
28
28
 
29
29
  - [`pattern.md`](pattern.md) - correct usage, with examples
30
30
  - [`antipattern.md`](antipattern.md) - mistakes to avoid
31
+ - [Storybook](https://magma-design-system.github.io/magma/storybook/?path=/docs/ui-preferences-theme-item--docs) - the live examples, in the published Storybook of `main`
31
32
  - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`anti-patterns.md`](../../../../agents/anti-patterns.md) - the rules shared by every component
32
33
 
33
34
  ## 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-pref-theme-item/mds-pref-theme-item.tsx",
@@ -236,7 +237,8 @@
236
237
  "mds-icon",
237
238
  "mds-text"
238
239
  ]
239
- }
240
+ },
241
+ "storybook": "ui-preferences-theme-item--docs"
240
242
  }
241
243
  ]
242
244
  }
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-price-table
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-price-table>` web component is the layout container of the Magma Design System pricing-table family. It owns no logic or visual chrome of its own: it stacks its slotted compound children (the plan columns, header and feature matrix) into a coherent pricing comparison surface.
12
12
 
@@ -25,6 +25,7 @@ This component is a pure compound parent and intentionally has no configurable p
25
25
 
26
26
  - [`pattern.md`](pattern.md) - correct usage, with examples
27
27
  - [`antipattern.md`](antipattern.md) - mistakes to avoid
28
+ - [Storybook](https://magma-design-system.github.io/magma/storybook/?path=/docs/ui-price-table--docs) - the live examples, in the published Storybook of `main`
28
29
  - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`anti-patterns.md`](../../../../agents/anti-patterns.md) - the rules shared by every component
29
30
 
30
31
  ## Slots
@@ -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-price-table/mds-price-table.tsx",
@@ -41,7 +42,8 @@
41
42
  "states": [],
42
43
  "dependents": [],
43
44
  "dependencies": [],
44
- "dependencyGraph": {}
45
+ "dependencyGraph": {},
46
+ "storybook": "ui-price-table--docs"
45
47
  }
46
48
  ]
47
49
  }
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-price-table-features
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-price-table-features>` web component is the feature-matrix block of the Magma Design System pricing-table family. It is a compound child of [`<mds-price-table>`](../mds-price-table/AGENTS.md) and renders a table inside its shadow root, turning its slotted rows into the side-by-side feature comparison grid of a pricing table.
12
12
 
@@ -29,6 +29,7 @@ All other variation comes from the slotted children rather than from props. Colu
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-price-table-price-table-features--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-price-table-features/mds-price-table-features.tsx",
@@ -96,7 +97,8 @@
96
97
  "mds-price-table-features": [
97
98
  "mds-text"
98
99
  ]
99
- }
100
+ },
101
+ "storybook": "ui-price-table-price-table-features--docs"
100
102
  }
101
103
  ]
102
104
  }
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-price-table-features-cell
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-price-table-features-cell>` web component is a single cell within a feature comparison row of the Magma price table, rendering one of several visual representations (a support icon, plain text, a label, or arbitrary custom content) depending on its `type`. It is a compound child of [`<mds-price-table-features-row>`](../mds-price-table-features-row/AGENTS.md), which orchestrates a set of cells and conceptually stands in for a table cell within the row.
12
12
 
@@ -32,6 +32,7 @@ The full set of accepted values is in the Props table of [`AGENTS.md`](AGENTS.md
32
32
 
33
33
  - [`pattern.md`](pattern.md) - correct usage, with examples
34
34
  - [`antipattern.md`](antipattern.md) - mistakes to avoid
35
+ - [Storybook](https://magma-design-system.github.io/magma/storybook/?path=/docs/ui-price-table-price-table-features-cell--docs) - the live examples, in the published Storybook of `main`
35
36
  - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`anti-patterns.md`](../../../../agents/anti-patterns.md) - the rules shared by every component
36
37
 
37
38
  ## 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-price-table-features-cell/mds-price-table-features-cell.tsx",
@@ -158,7 +159,8 @@
158
159
  "mds-price-table-features-cell": [
159
160
  "mds-text"
160
161
  ]
161
- }
162
+ },
163
+ "storybook": "ui-price-table-price-table-features-cell--docs"
162
164
  }
163
165
  ]
164
166
  }
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-price-table-features-row
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-price-table-features-row>` web component is a layout child of [`<mds-price-table-features>`](../mds-price-table-features/AGENTS.md) that represents a single horizontal row inside the feature-comparison table, conceptually playing the role of a table row (`<tr>`).
12
12
 
@@ -25,6 +25,7 @@ This component has no configurable props. Its only responsibility is layout: it
25
25
 
26
26
  - [`pattern.md`](pattern.md) - correct usage, with examples
27
27
  - [`antipattern.md`](antipattern.md) - mistakes to avoid
28
+ - [Storybook](https://magma-design-system.github.io/magma/storybook/?path=/docs/ui-price-table-price-table-features-row--docs) - the live examples, in the published Storybook of `main`
28
29
  - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`anti-patterns.md`](../../../../agents/anti-patterns.md) - the rules shared by every component
29
30
 
30
31
  ## Slots
@@ -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-price-table-features-row/mds-price-table-features-row.tsx",
@@ -66,7 +67,8 @@
66
67
  "states": [],
67
68
  "dependents": [],
68
69
  "dependencies": [],
69
- "dependencyGraph": {}
70
+ "dependencyGraph": {},
71
+ "storybook": "ui-price-table-price-table-features-row--docs"
70
72
  }
71
73
  ]
72
74
  }
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-price-table-header
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-price-table-header>` web component is the layout child that forms the top band of a [`<mds-price-table>`](../mds-price-table/AGENTS.md), aligning an optional leading title cell with the per-plan `<mds-price-table-list>` columns so the header sits in the same column grid as the feature rows below it. It is a pure presentational wrapper.
12
12
 
@@ -25,6 +25,7 @@ This component exposes no configurable props. It is a layout-only child: its sol
25
25
 
26
26
  - [`pattern.md`](pattern.md) - correct usage, with examples
27
27
  - [`antipattern.md`](antipattern.md) - mistakes to avoid
28
+ - [Storybook](https://magma-design-system.github.io/magma/storybook/?path=/docs/ui-price-table-price-table-header--docs) - the live examples, in the published Storybook of `main`
28
29
  - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`anti-patterns.md`](../../../../agents/anti-patterns.md) - the rules shared by every component
29
30
 
30
31
  ## Slots
@@ -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-price-table-header/mds-price-table-header.tsx",
@@ -41,7 +42,8 @@
41
42
  "states": [],
42
43
  "dependents": [],
43
44
  "dependencies": [],
44
- "dependencyGraph": {}
45
+ "dependencyGraph": {},
46
+ "storybook": "ui-price-table-price-table-header--docs"
45
47
  }
46
48
  ]
47
49
  }
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-price-table-list
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-price-table-list>` web component is a single pricing-plan column inside the [`<mds-price-table>`](../mds-price-table/AGENTS.md) layout container. It is a compound child that arranges a plan's heading, feature list, price and call-to-action into a consistent card-like structure built entirely from slots - it has no configurable props.
12
12
 
@@ -33,6 +33,7 @@ The `<mds-price-table-list>` web component is a single pricing-plan column insid
33
33
 
34
34
  - [`pattern.md`](pattern.md) - correct usage, with examples
35
35
  - [`antipattern.md`](antipattern.md) - mistakes to avoid
36
+ - [Storybook](https://magma-design-system.github.io/magma/storybook/?path=/docs/ui-price-table-price-table-list--docs) - the live examples, in the published Storybook of `main`
36
37
  - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`anti-patterns.md`](../../../../agents/anti-patterns.md) - the rules shared by every component
37
38
 
38
39
  ## Slots
@@ -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-price-table-list/mds-price-table-list.tsx",
@@ -103,7 +104,8 @@
103
104
  "mds-price-table-list": [
104
105
  "mds-separator"
105
106
  ]
106
- }
107
+ },
108
+ "storybook": "ui-price-table-price-table-list--docs"
107
109
  }
108
110
  ]
109
111
  }
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-price-table-list-item
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-price-table-list-item>` web component represents a single feature row inside a [`<mds-price-table-list>`](../mds-price-table-list/AGENTS.md), pairing a supported/unsupported status icon with a textual feature label. It is a presentational compound child.
12
12
 
@@ -27,6 +27,7 @@ The `<mds-price-table-list-item>` web component represents a single feature row
27
27
 
28
28
  - [`pattern.md`](pattern.md) - correct usage, with examples
29
29
  - [`antipattern.md`](antipattern.md) - mistakes to avoid
30
+ - [Storybook](https://magma-design-system.github.io/magma/storybook/?path=/docs/ui-price-table-price-table-list-item--docs) - the live examples, in the published Storybook of `main`
30
31
  - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`anti-patterns.md`](../../../../agents/anti-patterns.md) - the rules shared by every component
31
32
 
32
33
  ## 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-price-table-list-item/mds-price-table-list-item.tsx",
@@ -150,7 +151,8 @@
150
151
  "mds-price-table-list-item": [
151
152
  "mds-text"
152
153
  ]
153
- }
154
+ },
155
+ "storybook": "ui-price-table-price-table-list-item--docs"
154
156
  }
155
157
  ]
156
158
  }
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-progress
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-progress>` web component is the progress indicator of the Magma Design System, rendering the completion state of a determinate task as a bar or ring. It is the system equivalent of the native HTML `<progress>` element, exposing the appropriate progressbar role and ARIA value attributes natively.
12
12
 
@@ -33,6 +33,7 @@ The `<mds-progress>` web component is the progress indicator of the Magma Design
33
33
 
34
34
  - [`pattern.md`](pattern.md) - correct usage, with examples
35
35
  - [`antipattern.md`](antipattern.md) - mistakes to avoid
36
+ - [Storybook](https://magma-design-system.github.io/magma/storybook/?path=/docs/ui-progress--docs) - the live examples, in the published Storybook of `main`
36
37
  - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`anti-patterns.md`](../../../../agents/anti-patterns.md) - the rules shared by every component
37
38
 
38
39
  ## 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-progress/mds-progress.tsx",
@@ -378,7 +379,8 @@
378
379
  "mds-stepper-bar-item": [
379
380
  "mds-progress"
380
381
  ]
381
- }
382
+ },
383
+ "storybook": "ui-progress--docs"
382
384
  }
383
385
  ]
384
386
  }
@@ -6,13 +6,13 @@
6
6
 
7
7
  # mds-push-notification
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-push-notification>` web component is the Magma Design System container that hosts and orchestrates a stack of transient notification items, managing their show/hide lifecycle, entry/exit animations, and overall visibility. It is a compound parent: its default slot holds `mds-push-notification-item` children, and it has no direct HTML primitive equivalent.
12
12
 
13
13
  #### Semantic Behavior
14
14
 
15
- - **Slot-driven lifecycle**: Items placed in the default slot are animated in automatically; each item animates out and is removed when closed (an item shows its close button only with `deletable`).
15
+ - **Slot-driven lifecycle**: Items placed in the default slot are animated in automatically; each item animates out and is removed when closed (an item shows its close button only with `dismissible`).
16
16
  - **Built-in clear button**: The container always renders its own clear button, labelled in the page language ("Clear notifications", "Cancella notifiche"), which animates out every item and hides the container.
17
17
  - **Auto vs. manual behavior**: With `behavior="auto"` the container shows itself as soon as one or more items are added; with `behavior="manual"` visibility is driven only by the `visible` prop or the imperative methods.
18
18
  - **Empty-stack auto-hide**: When the last remaining item animates out, the container hides itself regardless of behavior; the clear button and `hide()` hide it too.
@@ -33,6 +33,7 @@ The container intentionally exposes a minimal prop surface; most configuration i
33
33
 
34
34
  - [`pattern.md`](pattern.md) - correct usage, with examples
35
35
  - [`antipattern.md`](antipattern.md) - mistakes to avoid
36
+ - [Storybook](https://magma-design-system.github.io/magma/storybook/?path=/docs/ui-push-notification--docs) - the live examples, in the published Storybook of `main`
36
37
  - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`anti-patterns.md`](../../../../agents/anti-patterns.md) - the rules shared by every component
37
38
 
38
39
  ## 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-push-notification/mds-push-notification.tsx",
@@ -26,8 +27,8 @@
26
27
  }
27
28
  ],
28
29
  "usage": {
29
- "1. Description": "The `<mds-push-notification>` web component is the Magma Design System container that hosts and orchestrates a stack of transient notification items, managing their show/hide lifecycle, entry/exit animations, and overall visibility. It is a compound parent: its default slot holds `mds-push-notification-item` children, and it has no direct HTML primitive equivalent.\n\n#### Semantic Behavior\n\n- **Slot-driven lifecycle**: Items placed in the default slot are animated in automatically; each item animates out and is removed when closed (an item shows its close button only with `deletable`).\n- **Built-in clear button**: The container always renders its own clear button, labelled in the page language (\"Clear notifications\", \"Cancella notifiche\"), which animates out every item and hides the container.\n- **Auto vs. manual behavior**: With `behavior=\"auto\"` the container shows itself as soon as one or more items are added; with `behavior=\"manual\"` visibility is driven only by the `visible` prop or the imperative methods.\n- **Empty-stack auto-hide**: When the last remaining item animates out, the container hides itself regardless of behavior; the clear button and `hide()` hide it too.\n- **Emitted events**: `mdsPushNotificationShow` fires when it becomes visible, `mdsPushNotificationHide` when hidden, and `mdsPushNotificationChange` on every transition carrying a `{ visible: boolean }` detail.\n- **Imperative API**: Exposes `show()` and `hide()` methods to control visibility programmatically, plus `removeNotification()` to dismiss one or an array of `mds-push-notification-item` elements with the standard outro animation.\n- **Animation timing**: The intro and outro motion of the items is set by the component; the fade-out delay and the gap between items are read from the public CSS custom properties `--mds-push-notification-fadeout-delay` and `--mds-push-notification-gap`, so they are themeable without code changes.\n\n#### Properties & Visual Configurations\n\nThe container intentionally exposes a minimal prop surface; most configuration is structural (which items you slot in) or stylistic (via CSS custom properties).\n\n#### Other behavioral props\n\n- **`behavior`** selects the visibility strategy: pick `'auto'` (default) when the stack should appear and disappear purely as a function of how many items it contains, and `'manual'` when you want explicit control over when the container is shown via `visible` or the `show()`/`hide()` methods.\n- **`visible`** is the controlled visibility flag; set it to drive the container open or closed, while reading it returns the current visibility.\n",
30
- "2. Pattern": "Correct and idiomatic ways to use the `<mds-push-notification>` component, ordered from most common to most specialized. Patterns assume a working knowledge of the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Minimal Auto-Managed Stack\n\nThe default `behavior=\"auto\"` configuration. Drop `mds-push-notification-item` children into the default slot and the container shows itself, animates each item in, and hides itself when all items have been dismissed. Set `deletable` on an item to give it its own close button.\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n deletable\n subject=\"Nuovo messaggio\"\n message=\"Il documento e' pronto per la revisione.\"\n ></mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Items with Avatar Preview\n\nUse `preview=\"avatar\"` and `src` to show a user photo. Supply `initials` as a fallback when no image is available.\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n preview=\"avatar\"\n src=\"/avatars/marco.jpg\"\n initials=\"MC\"\n subject=\"Marco Cicognetti\"\n message=\"Ci sei andato poi alla riunione?\"\n ></mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Items with Icon Preview\n\nUse `icon` (an icon slug with its set prefix) instead of `src` when the notification represents an event or system action rather than a person.\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n icon=\"mi/baseline/attachment\"\n subject=\"Documento allegato\"\n message=\"E' stato caricato un nuovo allegato nella pratica 2024-1042.\"\n ></mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Item with Date and Timestamp\n\nPass an ISO 8601 datetime string to display a relative time-ago label (default) or a static formatted date.\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n subject=\"Approvazione completata\"\n message=\"La richiesta e' stata approvata.\"\n datetime=\"2024-11-12T09:30:00Z\"\n ></mds-push-notification-item>\n\n <!-- Static date format -->\n <mds-push-notification-item\n subject=\"Scadenza contratto\"\n message=\"Il contratto scade il giorno indicato.\"\n datetime=\"2024-12-31T00:00:00Z\"\n date-format=\"DD/MM/YYYY\"\n ></mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Item with Action Button\n\nSlot an `mds-button` into the `action` slot of the item to provide an inline CTA.\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n preview=\"avatar\"\n src=\"/avatars/sara.jpg\"\n subject=\"Sara Ho\"\n message=\"Hai ricevuto una nuova richiesta di collaborazione.\"\n >\n <mds-button slot=\"action\" variant=\"primary\" tone=\"weak\" size=\"sm\">\n Rispondi\n </mds-button>\n </mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Manual Behavior with Programmatic Control\n\nSet `behavior=\"manual\"` when visibility should be controlled by your application logic rather than inferred from slot contents. Toggle the `visible` attribute or call `show()` / `hide()` on the element.\n\n```html\n<mds-push-notification behavior=\"manual\" id=\"notif-panel\">\n <mds-push-notification-item\n subject=\"Aggiornamento sistema\"\n message=\"Un aggiornamento e' disponibile. Riavviare per applicarlo.\"\n ></mds-push-notification-item>\n</mds-push-notification>\n\n<script>\n const panel = document.querySelector('#notif-panel');\n\n // Show programmatically\n panel.show();\n\n // Hide programmatically\n panel.hide();\n</script>\n```\n\n#### Programmatic Dismissal of a Single Item\n\nCall `removeNotification()` with an `mds-push-notification-item` element reference to animate it out and remove it without the user interacting with the close button.\n\n```html\n<mds-push-notification id=\"notif-panel\">\n <mds-push-notification-item id=\"item-1\"\n subject=\"Avviso temporaneo\"\n message=\"Questa notifica viene rimossa dopo 5 secondi.\"\n ></mds-push-notification-item>\n</mds-push-notification>\n\n<script>\n const panel = document.querySelector('#notif-panel');\n const item = document.querySelector('#item-1');\n\n setTimeout(() => {\n panel.removeNotification(item);\n }, 5000);\n</script>\n```\n\n#### Reacting to Visibility Events\n\nListen to `mdsPushNotificationShow`, `mdsPushNotificationHide`, or `mdsPushNotificationChange` to synchronize UI state when the panel opens or closes.\n\n```javascript\nconst panel = document.querySelector('mds-push-notification');\n\npanel.addEventListener('mdsPushNotificationShow', () => {\n console.info('Pannello notifiche aperto');\n});\n\npanel.addEventListener('mdsPushNotificationHide', () => {\n console.info('Pannello notifiche chiuso');\n});\n\npanel.addEventListener('mdsPushNotificationChange', (e) => {\n console.info('Visibilita cambiata:', e.detail.visible);\n});\n```\n\n#### Item Tone and Variant\n\nUse `variant` and `tone` on the item to reflect the semantic nature of the notification (status or theme family). `tone` accepts `strong` or `weak` on this component. They paint the item's icon or avatar preview, so they show only together with `icon` (or `preview=\"avatar\"`).\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n icon=\"mi/baseline/check-circle\"\n variant=\"success\"\n tone=\"weak\"\n subject=\"Operazione completata\"\n message=\"Il file e' stato salvato con successo.\"\n ></mds-push-notification-item>\n\n <mds-push-notification-item\n icon=\"mi/baseline/error\"\n variant=\"error\"\n tone=\"strong\"\n subject=\"Errore critico\"\n message=\"Impossibile completare l'operazione. Riprovare.\"\n ></mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Styling Customization via CSS Custom Properties\n\nOverride the fade-out delay, the gap between items, and the panel background through the public `--mds-push-notification-*` properties; the intro and outro motion of the items is set by the component. Set them on the host or a parent selector; for colours name a semantic role, `rgb(var(--magma-<role>))` ([`agents/color.md`](../../../../agents/color.md)).\n\n```css\nmds-push-notification {\n --mds-push-notification-gap: calc(var(--spacing) * 300);\n --mds-push-notification-fadeout-delay: 0.5s;\n --mds-push-notification-background: linear-gradient(\n to right,\n rgb(var(--magma-surface-overlay) / 0) 0%,\n rgb(var(--magma-surface-overlay) / 0.95) 100%\n );\n}\n```\n",
30
+ "1. Description": "The `<mds-push-notification>` web component is the Magma Design System container that hosts and orchestrates a stack of transient notification items, managing their show/hide lifecycle, entry/exit animations, and overall visibility. It is a compound parent: its default slot holds `mds-push-notification-item` children, and it has no direct HTML primitive equivalent.\n\n#### Semantic Behavior\n\n- **Slot-driven lifecycle**: Items placed in the default slot are animated in automatically; each item animates out and is removed when closed (an item shows its close button only with `dismissible`).\n- **Built-in clear button**: The container always renders its own clear button, labelled in the page language (\"Clear notifications\", \"Cancella notifiche\"), which animates out every item and hides the container.\n- **Auto vs. manual behavior**: With `behavior=\"auto\"` the container shows itself as soon as one or more items are added; with `behavior=\"manual\"` visibility is driven only by the `visible` prop or the imperative methods.\n- **Empty-stack auto-hide**: When the last remaining item animates out, the container hides itself regardless of behavior; the clear button and `hide()` hide it too.\n- **Emitted events**: `mdsPushNotificationShow` fires when it becomes visible, `mdsPushNotificationHide` when hidden, and `mdsPushNotificationChange` on every transition carrying a `{ visible: boolean }` detail.\n- **Imperative API**: Exposes `show()` and `hide()` methods to control visibility programmatically, plus `removeNotification()` to dismiss one or an array of `mds-push-notification-item` elements with the standard outro animation.\n- **Animation timing**: The intro and outro motion of the items is set by the component; the fade-out delay and the gap between items are read from the public CSS custom properties `--mds-push-notification-fadeout-delay` and `--mds-push-notification-gap`, so they are themeable without code changes.\n\n#### Properties & Visual Configurations\n\nThe container intentionally exposes a minimal prop surface; most configuration is structural (which items you slot in) or stylistic (via CSS custom properties).\n\n#### Other behavioral props\n\n- **`behavior`** selects the visibility strategy: pick `'auto'` (default) when the stack should appear and disappear purely as a function of how many items it contains, and `'manual'` when you want explicit control over when the container is shown via `visible` or the `show()`/`hide()` methods.\n- **`visible`** is the controlled visibility flag; set it to drive the container open or closed, while reading it returns the current visibility.\n",
31
+ "2. Pattern": "Correct and idiomatic ways to use the `<mds-push-notification>` component, ordered from most common to most specialized. Patterns assume a working knowledge of the shared component rules in [`agents/conventions.md`](../../../../agents/conventions.md).\n\n#### Minimal Auto-Managed Stack\n\nThe default `behavior=\"auto\"` configuration. Drop `mds-push-notification-item` children into the default slot and the container shows itself, animates each item in, and hides itself when all items have been dismissed. Set `dismissible` on an item to give it its own close button.\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n dismissible\n subject=\"Nuovo messaggio\"\n message=\"Il documento e' pronto per la revisione.\"\n ></mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Items with Avatar Preview\n\nUse `preview=\"avatar\"` and `src` to show a user photo. Supply `initials` as a fallback when no image is available.\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n preview=\"avatar\"\n src=\"/avatars/marco.jpg\"\n initials=\"MC\"\n subject=\"Marco Cicognetti\"\n message=\"Ci sei andato poi alla riunione?\"\n ></mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Items with Icon Preview\n\nUse `icon` (an icon slug with its set prefix) instead of `src` when the notification represents an event or system action rather than a person.\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n icon=\"mi/baseline/attachment\"\n subject=\"Documento allegato\"\n message=\"E' stato caricato un nuovo allegato nella pratica 2024-1042.\"\n ></mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Item with Date and Timestamp\n\nPass an ISO 8601 datetime string to display a relative time-ago label (default) or a static formatted date.\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n subject=\"Approvazione completata\"\n message=\"La richiesta e' stata approvata.\"\n datetime=\"2024-11-12T09:30:00Z\"\n ></mds-push-notification-item>\n\n <!-- Static date format -->\n <mds-push-notification-item\n subject=\"Scadenza contratto\"\n message=\"Il contratto scade il giorno indicato.\"\n datetime=\"2024-12-31T00:00:00Z\"\n date-format=\"DD/MM/YYYY\"\n ></mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Item with Action Button\n\nSlot an `mds-button` into the `action` slot of the item to provide an inline CTA.\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n preview=\"avatar\"\n src=\"/avatars/sara.jpg\"\n subject=\"Sara Ho\"\n message=\"Hai ricevuto una nuova richiesta di collaborazione.\"\n >\n <mds-button slot=\"action\" variant=\"primary\" tone=\"weak\" size=\"sm\">\n Rispondi\n </mds-button>\n </mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Manual Behavior with Programmatic Control\n\nSet `behavior=\"manual\"` when visibility should be controlled by your application logic rather than inferred from slot contents. Toggle the `visible` attribute or call `show()` / `hide()` on the element.\n\n```html\n<mds-push-notification behavior=\"manual\" id=\"notif-panel\">\n <mds-push-notification-item\n subject=\"Aggiornamento sistema\"\n message=\"Un aggiornamento e' disponibile. Riavviare per applicarlo.\"\n ></mds-push-notification-item>\n</mds-push-notification>\n\n<script>\n const panel = document.querySelector('#notif-panel');\n\n // Show programmatically\n panel.show();\n\n // Hide programmatically\n panel.hide();\n</script>\n```\n\n#### Programmatic Dismissal of a Single Item\n\nCall `removeNotification()` with an `mds-push-notification-item` element reference to animate it out and remove it without the user interacting with the close button.\n\n```html\n<mds-push-notification id=\"notif-panel\">\n <mds-push-notification-item id=\"item-1\"\n subject=\"Avviso temporaneo\"\n message=\"Questa notifica viene rimossa dopo 5 secondi.\"\n ></mds-push-notification-item>\n</mds-push-notification>\n\n<script>\n const panel = document.querySelector('#notif-panel');\n const item = document.querySelector('#item-1');\n\n setTimeout(() => {\n panel.removeNotification(item);\n }, 5000);\n</script>\n```\n\n#### Reacting to Visibility Events\n\nListen to `mdsPushNotificationShow`, `mdsPushNotificationHide`, or `mdsPushNotificationChange` to synchronize UI state when the panel opens or closes.\n\n```javascript\nconst panel = document.querySelector('mds-push-notification');\n\npanel.addEventListener('mdsPushNotificationShow', () => {\n console.info('Pannello notifiche aperto');\n});\n\npanel.addEventListener('mdsPushNotificationHide', () => {\n console.info('Pannello notifiche chiuso');\n});\n\npanel.addEventListener('mdsPushNotificationChange', (e) => {\n console.info('Visibilita cambiata:', e.detail.visible);\n});\n```\n\n#### Item Tone and Variant\n\nUse `variant` and `tone` on the item to reflect the semantic nature of the notification (status or theme family). `tone` accepts `strong` or `weak` on this component. They paint the item's icon or avatar preview, so they show only together with `icon` (or `preview=\"avatar\"`).\n\n```html\n<mds-push-notification>\n <mds-push-notification-item\n icon=\"mi/baseline/check-circle\"\n variant=\"success\"\n tone=\"weak\"\n subject=\"Operazione completata\"\n message=\"Il file e' stato salvato con successo.\"\n ></mds-push-notification-item>\n\n <mds-push-notification-item\n icon=\"mi/baseline/error\"\n variant=\"error\"\n tone=\"strong\"\n subject=\"Errore critico\"\n message=\"Impossibile completare l'operazione. Riprovare.\"\n ></mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Styling Customization via CSS Custom Properties\n\nOverride the fade-out delay, the gap between items, and the panel background through the public `--mds-push-notification-*` properties; the intro and outro motion of the items is set by the component. Set them on the host or a parent selector; for colours name a semantic role, `rgb(var(--magma-<role>))` ([`agents/color.md`](../../../../agents/color.md)).\n\n```css\nmds-push-notification {\n --mds-push-notification-gap: calc(var(--spacing) * 300);\n --mds-push-notification-fadeout-delay: 0.5s;\n --mds-push-notification-background: linear-gradient(\n to right,\n rgb(var(--magma-surface-overlay) / 0) 0%,\n rgb(var(--magma-surface-overlay) / 0.95) 100%\n );\n}\n```\n",
31
32
  "3. Antipattern": "Common incorrect uses of `<mds-push-notification>`. Each entry pairs the wrong form with the right one and a one-line reason. System-wide rules (boolean-as-string, shadow piercing, Tailwind color utilities, raw native event listening) live in [`agents/anti-patterns.md`](../../../../agents/anti-patterns.md) - they apply here too but are not repeated.\n\n#### Do Not Put Arbitrary HTML in the Default Slot\n\nThe default slot is designed for `mds-push-notification-item` children only. Placing raw HTML or other components breaks the animation lifecycle, event wiring, and the intro/outro sequencing the container manages.\n\n```html\n<!-- INCORRECT -->\n<mds-push-notification>\n <div class=\"my-notification\">\n <strong>Avviso</strong>\n <p>Il documento e' pronto.</p>\n </div>\n</mds-push-notification>\n\n<!-- CORRECT -->\n<mds-push-notification>\n <mds-push-notification-item\n subject=\"Avviso\"\n message=\"Il documento e' pronto.\"\n ></mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Do Not Set `visible=\"false\"` to Hide the Panel\n\n`visible` is a boolean prop: a false boolean is written by removing the attribute, the convention for every Magma boolean ([`agents/conventions.md`](../../../../agents/conventions.md)). Stencil does parse `\"false\"` as `false`, but the attribute stays in the markup until the component hydrates and its reflection removes it, so a `[visible]` selector or any code reading the attribute sees it set in the meantime. Remove the attribute entirely - or call `hide()` - to close the panel.\n\n```html\n<!-- INCORRECT -->\n<mds-push-notification visible=\"false\"></mds-push-notification>\n\n<!-- CORRECT: remove the attribute -->\n<mds-push-notification></mds-push-notification>\n```\n\n```javascript\n// CORRECT: via imperative method\ndocument.querySelector('mds-push-notification').hide();\n```\n\n#### Do Not Listen to the Native `close` Event Instead of `mdsPushNotificationHide`\n\nThe component emits `mdsPushNotificationHide` when the panel hides. Listening for a native `close` event will never fire because the component does not dispatch it, and native DOM events from inside the shadow root do not reliably bubble to the light DOM.\n\n```javascript\n// INCORRECT\npanel.addEventListener('close', () => updateUI());\n\n// CORRECT\npanel.addEventListener('mdsPushNotificationHide', () => updateUI());\n```\n\n#### Do Not Use `behavior=\"manual\"` and Then Forget to Call `show()` / `hide()`\n\nWith `behavior=\"manual\"` the container never auto-shows when items are added; you must explicitly call `show()` or set `visible`. Leaving it on `manual` without wiring visibility logic means notifications are silently queued but never displayed.\n\n```html\n<!-- INCORRECT: items never appear because manual mode needs explicit show() -->\n<mds-push-notification behavior=\"manual\" id=\"notif-panel\">\n <mds-push-notification-item\n subject=\"Nuovo messaggio\"\n message=\"Messaggio ricevuto.\"\n ></mds-push-notification-item>\n</mds-push-notification>\n\n<!-- CORRECT: call show() after adding items -->\n<mds-push-notification behavior=\"manual\" id=\"notif-panel\">\n <mds-push-notification-item\n subject=\"Nuovo messaggio\"\n message=\"Messaggio ricevuto.\"\n ></mds-push-notification-item>\n</mds-push-notification>\n\n<script>\n document.querySelector('#notif-panel').show();\n</script>\n```\n\n#### Do Not Pierce Shadow DOM to Style Item Internals\n\nThe only supported customization surface for the container is the public `--mds-push-notification-*` CSS custom properties plus the documented `::part(notifications)` part. Use the public per-item CSS custom properties (prefixed `--mds-push-notification-item-*`) for item-level styling. Do not reach into shadow parts that are not documented.\n\n```css\n/* INCORRECT */\nmds-push-notification >>> .notifications {\n background: white;\n}\nmds-push-notification::part(content) {\n padding: 2rem;\n}\n\n/* CORRECT */\nmds-push-notification {\n --mds-push-notification-background: rgb(var(--magma-surface-overlay) / 0.9);\n --mds-push-notification-gap: calc(var(--spacing) * 300);\n}\nmds-push-notification::part(notifications) {\n /* documented part - safe to target */\n padding-block: calc(var(--spacing) * 200);\n}\n```\n\n#### Do Not Slot Actions in the Wrong Slot\n\nAction buttons belong in the `action` slot of `mds-push-notification-item`, not in the default slot of `mds-push-notification`. Placing a button in the parent's default slot treats it like a notification item, breaks the animation sequence, and the button will be styled and animated as if it were a notification. A clear-all button is not needed either: the container renders its own.\n\n```html\n<!-- INCORRECT: button lands in the parent's default slot -->\n<mds-push-notification>\n <mds-button variant=\"dark\">Cancella tutto</mds-button>\n <mds-push-notification-item subject=\"Avviso\" message=\"Nuovo messaggio.\"></mds-push-notification-item>\n</mds-push-notification>\n\n<!-- CORRECT: action belongs on the item's action slot -->\n<mds-push-notification>\n <mds-push-notification-item subject=\"Avviso\" message=\"Nuovo messaggio.\">\n <mds-button slot=\"action\" variant=\"primary\" tone=\"weak\" size=\"sm\">Apri</mds-button>\n </mds-push-notification-item>\n</mds-push-notification>\n```\n\n#### Do Not Apply an Unsupported `tone` Value to Item\n\n`mds-push-notification-item` accepts `tone=\"strong\"` or `tone=\"weak\"` only (`ToneMinimalVariantType`). Using `tone=\"outline\"` (a tone of `mds-button` and `mds-badge`) silently falls back to the default `weak` look and the intended visual emphasis is lost. `variant` and `tone` paint only the item's icon or avatar, so pair them with `icon`.\n\n```html\n<!-- INCORRECT: outline and text are not supported tones for this component -->\n<mds-push-notification-item\n icon=\"mi/baseline/error\"\n variant=\"error\"\n tone=\"outline\"\n subject=\"Errore\"\n message=\"Operazione fallita.\"\n></mds-push-notification-item>\n\n<!-- CORRECT -->\n<mds-push-notification-item\n icon=\"mi/baseline/error\"\n variant=\"error\"\n tone=\"strong\"\n subject=\"Errore\"\n message=\"Operazione fallita.\"\n></mds-push-notification-item>\n```\n"
32
33
  },
33
34
  "props": [
@@ -312,7 +313,8 @@
312
313
  "mds-icon",
313
314
  "mds-text"
314
315
  ]
315
- }
316
+ },
317
+ "storybook": "ui-push-notification--docs"
316
318
  }
317
319
  ]
318
320
  }
@@ -11,12 +11,12 @@ Correct and idiomatic ways to use the `<mds-push-notification>` component, order
11
11
 
12
12
  #### Minimal Auto-Managed Stack
13
13
 
14
- The default `behavior="auto"` configuration. Drop `mds-push-notification-item` children into the default slot and the container shows itself, animates each item in, and hides itself when all items have been dismissed. Set `deletable` on an item to give it its own close button.
14
+ The default `behavior="auto"` configuration. Drop `mds-push-notification-item` children into the default slot and the container shows itself, animates each item in, and hides itself when all items have been dismissed. Set `dismissible` on an item to give it its own close button.
15
15
 
16
16
  ```html
17
17
  <mds-push-notification>
18
18
  <mds-push-notification-item
19
- deletable
19
+ dismissible
20
20
  subject="Nuovo messaggio"
21
21
  message="Il documento e' pronto per la revisione."
22
22
  ></mds-push-notification-item>
@@ -6,7 +6,7 @@
6
6
 
7
7
  # mds-push-notification-item
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-push-notification-item>` web component is a single notification card rendered inside its parent container [`<mds-push-notification>`](../mds-push-notification/AGENTS.md). It composes an avatar/image, a subject, a relative or formatted timestamp, a message body and an optional dismiss control into one toast-like row.
12
12
 
@@ -22,7 +22,8 @@ The `<mds-push-notification-item>` web component is a single notification card r
22
22
 
23
23
  #### Properties & Visual Configurations
24
24
 
25
- - **`deletable`** (default `false`): Controls whether the dismiss button is shown. Add it to let the user close the notification manually; leave it off for items the user should not close.
25
+ - **`dismissible`**: Controls whether the dismiss button is shown. Add it to let the user close the notification manually; leave it off for items the user should not close.
26
+ - **`deletable`** is the old name of `dismissible`, deprecated: the button dismisses the notification, it deletes nothing. It still works, and goes in the next major.
26
27
  - **`preview`**: Pick `avatar` to show the `src` image (or `initials`/`icon` fallback) as a compact round avatar, or `image` (default) to show `src` as a larger inline picture preview.
27
28
  - **`initials`**: Provided as the avatar fallback when no image is available; it overrides `tone`/`variant` styling so the user stays visually recognizable.
28
29
  - **`dateFormat`**: Use `timeago` for a live relative timestamp, or any date-format token string for a fixed display date.
@@ -33,6 +34,7 @@ For `tone` and `variant`, this component consumes the shared color ladders defin
33
34
 
34
35
  - [`pattern.md`](pattern.md) - correct usage, with examples
35
36
  - [`antipattern.md`](antipattern.md) - mistakes to avoid
37
+ - [Storybook](https://magma-design-system.github.io/magma/storybook/?path=/docs/ui-push-notification-push-notification-item--docs) - the live examples, in the published Storybook of `main`
36
38
  - [`conventions.md`](../../../../agents/conventions.md), [`variants.md`](../../../../agents/variants.md), [`anti-patterns.md`](../../../../agents/anti-patterns.md) - the rules shared by every component
37
39
 
38
40
  ## Props
@@ -41,7 +43,8 @@ For `tone` and `variant`, this component consumes the shared color ladders defin
41
43
  | --- | --- | --- | --- | --- |
42
44
  | `dateFormat` | `date-format` | `string` | `'timeago'` | Specifies how the notification date is written: `timeago` shows the time passed, any other value is the Day.js format of a static date |
43
45
  | `datetime` | `datetime` | `string \| undefined` | - | Specifies the notification date based on [standard ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html). |
44
- | `deletable` | `deletable` | `boolean \| undefined` | `false` | Specifies if the component is dismissable; when set, a dismiss button is shown. |
46
+ | `deletable` | `deletable` | `boolean \| undefined` | `false` | **Deprecated**: Use `dismissible`: the button dismisses the notification, it deletes nothing. Goes in the next major. Shows the dismiss button, as `dismissible` does. |
47
+ | `dismissible` | `dismissible` | `boolean \| undefined` | - | Shows a dismiss button: activating it emits `mdsPushNotificationItemClose`, and a parent `mds-push-notification` takes the item out of the stack |
45
48
  | `icon` | `icon` | `string \| undefined` | - | Specifies the icon to be displayed |
46
49
  | `initials` | `initials` | `string \| undefined` | - | The user's inizials displayed if there's no image available, initials will override tone and variant senttings to keep user recognizable from others |
47
50
  | `message` | `message` | `string` | `'Nessun messaggio disponibile'` | Specifies the message of the component |